AAegis

Kernel Protocol · object specification

Recommendation

A single proposed action with a stated thesis and trade-off. It advises; it never acts.

All objects

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

Versioned

A recommendation is revised as evidence moves, but each version must remain readable so the accepted version can be identified later.

§2 Allowed operations

  • CreateEmitted by exactly one investigation.
  • AcceptRecorded as taken. Creates the expectation of an outcome.
  • RejectRecorded as declined, with a reason.
  • ModifyProduces a new version; prior versions stay readable.
  • ExpireLapses when its evidence window closes without a decision.

§3 Forbidden operations

  • Auto-executeThe kernel never takes an action on the business.
  • Delete after acceptanceAn accepted recommendation is part of the causal chain.
  • Silent re-scopeChanging the thesis requires a new version.

§4 Relationship types

  • 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.

§5 Lifecycle events

  1. Drafted

    Thesis and trade-off written.

  2. Active

    Awaiting an accept or reject decision.

  3. Accepted

    Outcome expected.

  4. Rejected

    Closed with recorded reason.

  5. Expired

    Evidence window closed without decision.

  6. Superseded

    A newer version is current.

§6 State machine

initial: Drafted · terminal: Accepted, Rejected, Expired, Superseded

FromToTrigger
Drafted→ Activeemitted by its investigation
Active→ Acceptedfounder decision recorded
Active→ Rejecteddeclined with reason
Active→ Expiredevidence window closed
Active→ Supersedednew version issued

Forbidden transitions

  • Accepted ⇸ ActiveAcceptance is irreversible; a reversal is a new recommendation.
  • Rejected ⇸ AcceptedA refusal is part of the causal chain.
  • Expired ⇸ ActiveEvidence has aged out; re-issue instead.

§7 Lineage

Ancestry — what must exist before this object

transitive: Investigation ← Constitution ← Snapshot ← Candidate Principle ← Pattern ← Reflection ← Outcome

Descendants — what this object can produce

  • Recommendation resolves to →Outcome

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

§8 Invariants

  • Exactly one version of a recommendation is Active at a time.
  • Acceptance is irreversible; a reversal is a new recommendation.

Global constraints binding this object

  • GI-01∀ r ∈ Recommendation : accepted(r) ⇒ |outcomes(r)| = 1

    Every accepted recommendation resolves to exactly one outcome.

  • GI-09∀ r ∈ Recommendation : |{v ∈ versions(r) : state(v) = Active}| ≤ 1

    At most one version of a recommendation is active at any time.

  • GI-10∀ x ∈ Kernel : ¬act(x)

    No kernel object executes an action on the business. The kernel advises only.