Knowledge Artifact v1

Source schema: doc/schemas/knowledge-artifact.v1.schema.json

Machine-readable schema for local or portable knowledge artifacts promoted from learning outcomes.

Governing Basis

• doc/project/30-stories/story-002.md
• doc/project/50-requirements/requirements-002.md
• doc/project/40-proposals/012-learning-outcomes-and-archival-contracts.md

Project Lineage

Requirements

• doc/project/50-requirements/requirements-002.md
• doc/project/50-requirements/requirements-003.md
• doc/project/50-requirements/requirements-004.md
• doc/project/50-requirements/requirements-005.md

Stories

• doc/project/30-stories/story-001.md
• doc/project/30-stories/story-002.md
• doc/project/30-stories/story-003.md
• doc/project/30-stories/story-004.md

Fields

Field	Required	Shape	Description
schema/v	yes	const: 1	Schema version.
knowledge-artifact/id	yes	string	Stable identifier of the promoted artifact.
question/id	yes	string	Question lifecycle identifier from which the artifact ultimately derives.
source/learning-outcome-id	yes	string	LearningOutcome identifier that justified the promotion.
artifact/class	yes	enum: trusted-local-retrieval, review-only, corpus-candidate, training-candidate	Semantic class of the promoted artifact.
target/kind	yes	enum: vector-memory, indexed-file, corpus-entry, training-queue	Primary downstream target represented by the artifact.
created-at	yes	string	Timestamp of promotion into the target layer.
content/ref	yes	string	Stable content or storage reference used by the target layer.
provenance/refs	yes	array	References that link the artifact back to room outputs, summaries, or other source material.
trust/status	yes	enum: confirmed, corrected, unresolved	Inherited trust class from the source learning outcome.
training/eligible	no	boolean	Whether this artifact is currently eligible for later training jobs.
human-linked/input	no	boolean	Whether the artifact preserves accepted human-linked influence in its provenance.
domain/tags	no	array	Optional local or federation domain tags assigned during promotion.
policy_annotations	no	object	Optional policy metadata that does not change the core promotion semantics.

Conditional Rules

Rule 1

When:

{
  "properties": {
    "trust/status": {
      "const": "unresolved"
    }
  },
  "required": [
    "trust/status"
  ]
}

Then:

{
  "properties": {
    "artifact/class": {
      "const": "review-only"
    }
  }
}

Rule 2

When:

{
  "properties": {
    "artifact/class": {
      "const": "training-candidate"
    }
  },
  "required": [
    "artifact/class"
  ]
}

Then:

{
  "properties": {
    "target/kind": {
      "const": "training-queue"
    },
    "training/eligible": {
      "const": true
    }
  },
  "required": [
    "training/eligible"
  ]
}

Rule 3

When:

{
  "properties": {
    "artifact/class": {
      "const": "trusted-local-retrieval"
    }
  },
  "required": [
    "artifact/class"
  ]
}

Then:

{
  "properties": {
    "target/kind": {
      "enum": [
        "vector-memory",
        "indexed-file"
      ]
    },
    "trust/status": {
      "enum": [
        "confirmed",
        "corrected"
      ]
    }
  }
}

Field Semantics

schema/v

• Required: yes
• Shape: const: 1

Schema version.

knowledge-artifact/id

• Required: yes
• Shape: string

Stable identifier of the promoted artifact.

question/id

• Required: yes
• Shape: string

Question lifecycle identifier from which the artifact ultimately derives.

source/learning-outcome-id

• Required: yes
• Shape: string

LearningOutcome identifier that justified the promotion.

artifact/class

• Required: yes
• Shape: enum: trusted-local-retrieval, review-only, corpus-candidate, training-candidate

Semantic class of the promoted artifact.

target/kind

• Required: yes
• Shape: enum: vector-memory, indexed-file, corpus-entry, training-queue

Primary downstream target represented by the artifact.

created-at

• Required: yes
• Shape: string

Timestamp of promotion into the target layer.

content/ref

• Required: yes
• Shape: string

Stable content or storage reference used by the target layer.

provenance/refs

• Required: yes
• Shape: array

References that link the artifact back to room outputs, summaries, or other source material.

trust/status

• Required: yes
• Shape: enum: confirmed, corrected, unresolved

Inherited trust class from the source learning outcome.

training/eligible

• Required: no
• Shape: boolean

Whether this artifact is currently eligible for later training jobs.

human-linked/input

• Required: no
• Shape: boolean

Whether the artifact preserves accepted human-linked influence in its provenance.

domain/tags

• Required: no
• Shape: array

Optional local or federation domain tags assigned during promotion.

policy_annotations

• Required: no
• Shape: object

Optional policy metadata that does not change the core promotion semantics.