Documentation

Schema · Knowledge

Concepts

Abstract ideas extracted from the source. Concepts form a typed graph of dependency, contradiction, support and risk relations.

Fields

FieldTypeRequiredDescription
idstringyesStable slug, prefixed `con_`.
labelstringyesShort human label.
definitionstringyesStandalone definition that does not require the source to be readable.
domainDomainyesTop-level domain enum.
depends_onstring[]noConcept ids that must be understood first.
contradictsstring[]noConcept ids this one negates or clashes with.
supportsstring[]noConcept ids this one strengthens.
enablesstring[]noConcept ids this one makes possible.
risksstring[]noConcept ids that threaten this one.
confidencenumberyes0.00–1.00.
source_basisenumyesDerivation type.

Definition

ts
interface Concept {
  id: string;                    // con_*
  label: string;
  definition: string;
  domain: Domain;
  depends_on: string[];          // concept ids
  contradicts: string[];
  supports: string[];
  enables: string[];
  risks: string[];
  confidence: number;
  source_basis: SourceBasis;
}