This repository has been archived on 2026-10-29. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
Epiphany/notes/repo-frontier-planning-authority-map.md
2026-07-15 03:05:11 +01:00

77 lines
4.3 KiB
Markdown

# Repo Frontier Planning Authority Map
## Current authority
- Self selects one dependency-ready, unchallenged, active Imagination frontier
from the uniquely admitted current RepoModel. It writes one immutable
`RepoFrontierPlanningRequest` binding the model revision/hash, admission,
frontier bytes, source scope, runtime, and thread.
- Coordinator commit replays that request, injects the exact typed Imagination
projection, and atomically writes a request-keyed launch binding whose hash
covers the stored worker launch document.
- Imagination writes one immutable runtime result with an exclusive planning
request echo and one embedded canonical `RepoFrontierPlanCandidate`. It does
not route Hands or mutate RepoModel.
- The runtime derives one `RepoFrontierPlanMindRequest` from the immutable
Imagination result and candidate hash. Its insert is CAS-bound to the exact
current model envelope.
- Coordinator commit launches one bounded, non-embodied admission-review
procedure serving Mind. It injects the exact request/planning/candidate
projection and atomically writes the request-keyed launch binding. This
procedure is not an embodied Mind lane; Mind remains persistent state and
admission authority.
- The admission reviewer writes one immutable typed Adopt, Refuse, or Hold
judgment. Result persistence replays the request, both worker results, both
launch bindings, stored launch bytes, runtime/thread, candidate identity, and
current model/frontier while rejecting foreign organ cargo.
- `commit_repo_frontier_plan_decision` consumes only that immutable review
result. Refuse and Hold write one inert terminal receipt. Adopt atomically
writes the next canonical RepoModel, its specialized Mind review/admission,
and the terminal decision receipt.
- The dedicated Adopt transition installs the exact candidate cargo and
provenance on `RepoFrontierItem.adopted_plan` and alone changes
Imagination to Hands. Generic frontier writers cannot author or rewrite it.
- Self derives the Hands route from the admitted model. The route copies the
exact plan and safe paths; Hands intent binds route, candidate hash, and plan
action; verification requires the exact admitted command and shows Soul the
checks, stop conditions, rollback steps, and commit message.
- Modeling may incorporate Soul's verdict by changing lifecycle/gap/evidence
fields while preserving the adopted execution anatomy byte-for-byte.
## Derived state
- Planning readiness is current admitted Imagination frontier plus absence of a
terminal decision receipt.
- Candidate visibility is a projection of the immutable Imagination result.
- Hands readiness and execution cargo derive only from the post-Adopt canonical
model, never from a candidate or decision shadow store.
- Completion remains Soul verdict followed by Modeling verdict incorporation;
adoption is not completion.
## Forbidden writers and substitutions
- No standalone candidate or adoption store exists in the production path.
- No caller supplies Mind's decision, rationale, or timestamp.
- No prompted admission reviewer may emit state, Self, RepoModel, Verification,
Modeling, or implementation authority cargo.
- Prompt prose, namespaces, metadata, evidence coincidence, or “the current
request” cannot substitute for exact typed echoes and launch bindings.
- Generic Upsert/Revise cannot create an adopted plan or perform
Imagination-to-Hands. Verdict incorporation cannot rewrite execution anatomy.
- Same-path Hands work cannot substitute a different action, candidate, or
command while retaining route authority.
- Mind is not a chatty embodied lane. The bounded admission-review procedure
serves Mind and has no heartbeat, lane memory, `roleAccept`, or `selfPatch`.
## Verification layer
- Hostile proofs cover stale/swapped model, frontier, request, result, job,
launch binding, projection, candidate hash, escaped paths, failed worker
output, foreign cargo, duplicate/racing launches, competing terminal writes,
generic adoption bypass, post-adoption anatomy mutation, and same-path command
substitution.
- Exact retry authenticates immutable terminal decision plus its historical
review/admission chain without requiring later canonical model revisions to
remain frozen.
- The next organ is the production semantic index over typed graph claims so
Modeling can maintain a live persistent searchable Body map.