Schema · Knowledge

Entities

Named things mentioned by the source. Entities form the nodes of the knowledge graph; concepts and rules reference them by id.

Fields

Field	Type	Required	Description
id	string	yes	Stable slug, prefixed `ent_`.
name	string	yes	Canonical display name.
type	string	yes	Free-form classification.
description	string	yes	One-sentence definition.
aliases	string[]	no	Synonyms and alternate spellings.
attributes	string[]	no	Tags describing salient properties.
related_entities	object[]	no	Typed edges to other entities, with confidence.
source_basis	enum	yes	How the entity was derived from the source.

Definition

interface Entity {
  id: string;                    // ent_*
  name: string;
  type: string;                  // person | org | product | artifact | concept-instance | ...
  description: string;
  aliases: string[];
  attributes: string[];
  related_entities: {
    entity_id: string;
    relation_type: string;       // depends_on | part_of | competes_with | ...
    confidence: number;
  }[];
  source_basis: "explicit" | "inferred" | "synthesized" | "author_opinion" | "uncertain";
}

Validation rules

id must be unique within the package and match /^ent_[a-z0-9_]+$/.
Every related_entities[].entity_id must resolve to another entity in the same package.
confidence is a float in [0, 1] with two decimal places.