Skip to main content

SemanticGraph

The semantic view of a concept, produced by POST /compile/semantic.

semantic_hash is stable for semantically equivalent concepts: the same underlying computation always produces the same hash regardless of the authoring structure (canonical reduction is applied before hashing).

Two concepts with the same semantic_hash are semantically equivalent — they compute the same function, even if their DAG structures differ.

Used for:

  • Deduplication in the feature registry
  • Equivalence detection before promotion
  • Detecting breaking vs non-breaking version changes
concept_idConcept Id (string)required
versionVersion (string)required
semantic_hashSemantic Hash (string)required
featuresstring[]required
input_primitivesstring[]required
equivalencesstring[]
SemanticGraph
{
  "concept_id": "string",
  "version": "string",
  "semantic_hash": "string",
  "features": [
    "string"
  ],
  "input_primitives": [
    "string"
  ],
  "equivalences": [
    "string"
  ]
}