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- 01Snapshot
- 02Investigation
- 03Recommendation
- 04Outcome
- 05Reflection
- 06Pattern
- 07Candidate Principle
- 08Constitution
- 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
Opened
Scope and snapshots fixed.
Reasoned
Conclusion and evidence attached.
Published
Citable; immutable from here on.
Superseded
A newer investigation holds the current reading.
Archived
No successor; retained for audit.
§6 State machine
initial: Opened · terminal: Archived
| From | To | Trigger |
|---|---|---|
| Opened | → Reasoned | conclusion and evidence attached |
| Reasoned | → Published | citations frozen |
| Published | → Superseded | successor investigation published |
| Published | → Archived | closed without successor |
| Superseded | → Archived | retained for audit |
Forbidden transitions
- Published ⇸ ReasonedA published conclusion is part of the record.
- Superseded ⇸ PublishedCurrency moves forward only.
§7 Lineage
Descendants — what this object can produce
- Investigation produces →Recommendation
- Investigation supplies occurrence to →Pattern
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))| ≥ 2Every 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.