Kernel Protocol · object specification

Investigation

One bounded act of reasoning over a timeline. It states what was examined, what was concluded, and on what evidence.

Judgment protocol · lifecycle

kernel/v1.2
  1. 01Snapshot
  2. 02Investigation
  3. 03Recommendation
  4. 04Outcome
  5. 05Reflection
  6. 06Pattern
  7. 07Candidate Principle
  8. 08Constitution
  9. loopFuture Recommendation

↺ Constitution constrains every future recommendation. The pipeline is a closed loop, not a line.

§1 Versioning

Supersedable

Reasoning improves. A better investigation replaces an earlier one by superseding it, leaving the earlier chain readable.

§2 Allowed operations

  • CreateOpened against a defined set of snapshots.
  • LinkBind to the snapshots and patterns it relies on.
  • ReferenceBe cited by patterns, reflections and principles.
  • SupersedeDeclare a newer investigation as the current reading.
  • ArchiveClose without a successor.

§3 Forbidden operations

  • OverwriteA conclusion, once published, is part of the record.
  • DeleteDeletion would break every citation pointing at it.
  • Retroactive evidenceEvidence added after conclusion requires a successor.

§4 Relationship types

  • Investigation reads Snapshot

    Consumes readings as its only factual input.

  • Investigation supports Pattern

    Contributes one occurrence toward a recurring behaviour.

  • Investigation produces Recommendation

    May emit at most one active recommendation.

  • Investigation supersedes Investigation

    Replaces an earlier reading of the same question.

§5 Lifecycle events

  1. Opened

    Scope and snapshots fixed.

  2. Reasoned

    Conclusion and evidence attached.

  3. Published

    Citable; immutable from here on.

  4. Superseded

    A newer investigation holds the current reading.

  5. Archived

    No successor; retained for audit.

§6 State machine

initial: Opened · terminal: Archived

FromToTrigger
OpenedReasonedconclusion and evidence attached
ReasonedPublishedcitations frozen
PublishedSupersededsuccessor investigation published
PublishedArchivedclosed without successor
SupersededArchivedretained for audit

Forbidden transitions

  • Published ReasonedA published conclusion is part of the record.
  • Superseded PublishedCurrency moves forward only.

§7 Lineage

Ancestry — what must exist before this object

transitive: Snapshot

Descendants — what this object can produce

transitive: Recommendation → Pattern → Outcome → Candidate Principle → Reflection → Constitution

§8 Invariants

  • Every conclusion cites at least two metrics.
  • A published investigation names the snapshots it read.

Global constraints binding this object

  • GI-03∀ i ∈ Investigation : |metrics(conclusion(i))| ≥ 2

    Every published conclusion connects at least two metrics.

  • GI-08∀ x ∈ Kernel : cites(x) ⊆ published(before(x))

    No object may cite evidence created after its own publication.