Internal · protocol specification
Kernel Protocol
The rules every kernel object obeys. This workspace documents the protocol; it does not execute it. Every future feature must conform to what is written here.
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.
Executable protocol
Run one business scenario through all eight objects and watch each gate discharge.
§1 Objects
8 definitions- 01SnapshotImmutableHolds one immutable reading of the business at one point in time. It records what was true, never what it means.5 allowed · 3 forbidden · 5 states
- 02InvestigationSupersedableOne bounded act of reasoning over a timeline. It states what was examined, what was concluded, and on what evidence.5 allowed · 3 forbidden · 5 states
- 03RecommendationVersionedA single proposed action with a stated thesis and trade-off. It advises; it never acts.5 allowed · 3 forbidden · 6 states
- 04OutcomeAppend-onlyThe observed consequence of an accepted recommendation. It is the kernel's only source of ground truth.4 allowed · 3 forbidden · 4 states
- 05ReflectionSupersedableThe kernel's reading of its own judgment: where the reasoning held, where it drifted, and why.3 allowed · 3 forbidden · 5 states
- 06PatternVersionedA recurring reasoning behaviour observed across independent investigations. It accumulates evidence; it does not decide.6 allowed · 3 forbidden · 5 states
- 07Candidate PrincipleVersionedA proposed permanent reasoning rule, held under review until engineering accepts or refuses it.6 allowed · 3 forbidden · 7 states
- 08ConstitutionHistoricalThe ratified set of reasoning rules that govern every recommendation Aegis is permitted to make.4 allowed · 3 forbidden · 6 states
§2 Relationship graph
| From | Verb | To | Meaning |
|---|---|---|---|
| Snapshot | precedes → | Snapshot | Establishes the chronology reasoning walks. |
| Snapshot | grounds → | Investigation | Supplies every number an investigation may cite. |
| Snapshot | evidences → | Pattern | A pattern may cite the readings it was observed in. |
| 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. |
| Recommendation | derives from → | Investigation | Inherits the evidence and confidence of its source. |
| Recommendation | influenced by → | Constitution | Must be consistent with ratified principles. |
| Recommendation | produces → | Outcome | An accepted recommendation must eventually resolve. |
| Outcome | resolves → | Recommendation | Closes the loop opened by acceptance. |
| Outcome | cites → | Snapshot | Grounds the observation in recorded readings. |
| Outcome | creates → | Reflection | Every closed outcome obliges a reflection. |
| Reflection | interprets → | Outcome | Explains why the result diverged or matched. |
| Reflection | strengthens → | Pattern | Adds one classified occurrence. |
| Reflection | challenges → | Candidate Principle | Attaches contradicting evidence to a proposal. |
| Pattern | observed in → | Investigation | Each occurrence points at one investigation. |
| Pattern | born from → | Reflection | Classification originates in a reflection. |
| Pattern | proposes → | Candidate Principle | Crossing the evidence threshold opens a proposal. |
| Pattern | related to → | Pattern | Shares a mechanism without being the same behaviour. |
| Candidate Principle | proposed by → | Pattern | Inherits the pattern's occurrence evidence. |
| Candidate Principle | challenged by → | Reflection | Contradicting evidence is attached, not discarded. |
| Candidate Principle | becomes → | Constitution | Approval ratifies it as a constitutional article. |
| Constitution | ratifies → | Candidate Principle | Converts an approved proposal into governing text. |
| Constitution | influences → | Recommendation | Constrains what may be recommended and how. |
| Constitution | supersedes → | Constitution | A later article replaces an earlier one. |
§3 Global invariants
10 constraints- GI-01
∀ r ∈ Recommendation : accepted(r) ⇒ |outcomes(r)| = 1hardEvery accepted recommendation resolves to exactly one outcome.
violation · Open loop: the calibration record silently loses a decision.
scope: Recommendation · Outcome
- GI-02
∀ o ∈ Outcome : closed(o) ⇒ |reflections(o)| ≥ 1hardEvery closed outcome generates at least one reflection.
violation · Ground truth is recorded but never interpreted; no learning occurs.
scope: Outcome · Reflection
- GI-03
∀ i ∈ Investigation : |metrics(conclusion(i))| ≥ 2hardEvery published conclusion connects at least two metrics.
violation · Single-metric reasoning: description masquerading as diagnosis.
scope: Investigation
- GI-04
∀ p ∈ Pattern : state(p) = Candidate ⇒ |occurrences(p)| ≥ THRESHOLDgateA pattern may not propose a principle before crossing the evidence threshold.
violation · One failure becomes a permanent rule. Overfitting to a single scenario.
scope: Pattern · Candidate Principle
- GI-05
∀ c ∈ CandidatePrinciple : approve(c) ⇒ decidedBy(c) ∈ Humans ∧ openChallenges(c) = ∅gateNo candidate enters the constitution without a named human decision and zero open challenges.
violation · Self-ratification: the engine rewrites its own governing rules.
scope: Candidate Principle · Constitution
- GI-06
∀ a ∈ Constitution : ¬delete(a) ∧ version(a) ≠ ∅hardConstitutional articles are never deleted and always carry the version in which they entered force.
violation · Past recommendations become unexplainable against the rules that produced them.
scope: Constitution
- GI-07
∀ s ∈ Snapshot : ∀ t > ingestedAt(s) : values(s, t) = values(s, ingestedAt(s))hardSnapshot values are byte-stable after ingestion.
violation · Every downstream citation becomes unverifiable.
scope: Snapshot
- GI-08
∀ x ∈ Kernel : cites(x) ⊆ published(before(x))auditNo object may cite evidence created after its own publication.
violation · Retroactive justification. The chain reads as sound but is not.
scope: Investigation · Reflection · Pattern · Candidate Principle
- GI-09
∀ r ∈ Recommendation : |{v ∈ versions(r) : state(v) = Active}| ≤ 1hardAt most one version of a recommendation is active at any time.
violation · Ambiguous advice: two theses compete for one decision.
scope: Recommendation
- GI-10
∀ x ∈ Kernel : ¬act(x)hardNo kernel object executes an action on the business. The kernel advises only.
violation · Autonomy breach. The founder is no longer the decision-maker.
scope: Recommendation · Constitution
This workspace changes no behaviour. Historical records remain immutable: outcomes are never edited, investigations are never overwritten, and the constitution is never deleted or silently modified.