Knowledge Unit

Verified knowledge artifact produced through multi-model deliberation (IETF Internet-Draft: draft-farley-acta-knowledge-units)

Type object
File match ku-*.json knowledge-unit.json **/ku/*.json
Schema URL https://catalog.lintel.tools/schemas/schemastore/knowledge-unit/latest.json
Source https://raw.githubusercontent.com/SchemaStore/schemastore/master/src/schemas/json/knowledge-unit.json

Validate with Lintel

npx @lintel/lintel check
Type: object

A verified knowledge artifact produced through structured multi-model deliberation, as defined in draft-farley-acta-knowledge-units-00 (IETF Internet-Draft).

Properties

id string required

Unique identifier. Format: ku- followed by 12 alphanumeric characters.

pattern=^ku-[a-z0-9]{12}$
version integer required

Schema version number. Current version is 1.

Constant: 1
canonical_question string required

The definitive question this KU answers.

minLength=1
consensus_level string required

Structural classification of agreement among participating models.

Values: "unanimous" "strong" "split" "divergent"
agreed string | object[] required

Points where all participating models converge.

models_used string[] required

Model identifiers (provider/model format).

minItems=2
process_template string required

Deliberation process template used.

Default: "3-round"
status string required

Current lifecycle state.

Values: "active" "stale" "superseded"
fresh_until string required

ISO 8601 datetime after which this KU should be considered potentially stale.

format=date-time
receipt_sig string required

Aggregate Ed25519 signature over the receipt chain hash.

pattern=^[a-f0-9]{128}$
receipt_kid string required

Key identifier for the signing key.

receipt_hash string required

SHA-256 hash of the chained per-round receipt hashes.

pattern=^[a-f0-9]{64}$
domain string

Topic classification.

Values: "technology" "science" "health" "policy" "economics" "agent_security" "agent_governance" "research" "engineering"
tags string[]

Additional classification labels for cross-domain discovery.

disputed object[]

Points where models diverge, with per-model positions.

uncertain string | object[]

Points that no model could resolve with confidence.

synthesis string

Editorial summary. NOT canonical - the agreed/disputed/uncertain arrays are authoritative.

roster_version string

ISO 8601 date of the model roster snapshot.

format=date
roster_hash string

SHA-256 hash of the sorted models_used array.

pattern=^[a-f0-9]{64}$
total_tokens integer

Total tokens consumed across all rounds and models.

min=0
total_cost_cents number

Total API cost in US cents.

min=0
sources object[]

Source documents with content hashes for freshness validation.

source_url string

Primary source URL (backwards compatibility).

format=uri
source_title string

Primary source title (backwards compatibility).

volatility string

Expected rate of change for this knowledge domain.

Default: "evolving"
Values: "stable" "evolving" "volatile"
supersedes string | null

ID of the KU this KU replaces.

pattern=^ku-[a-z0-9]{12}$
parent_ku_id string | null

ID of a parent KU from which this question was derived.

pattern=^ku-[a-z0-9]{12}$
published_at string

ISO 8601 datetime of publication.

format=date-time
relations object[]

Typed relations to other Knowledge Units.