Reframe roadmap around the gate-first focus loop

Make the OS-level "gate → plan → work → reflect → gate" loop the explicit
destination. Promote the deferred AI reviewer into the loop as M7 (Reflection),
and reframe enforcement as M8 (Enforcement & gate) building toward the Guard
checking for a declared intention before the machine is usable — kept as the
last, heaviest milestone.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-05-31 13:22:03 -04:00
parent 1d281ad528
commit cd5d69dec5
@@ -51,9 +51,10 @@ valuable.
**Deferred for v1:** **Deferred for v1:**
- The AI **reviewer** role (session-end reflection). The three live roles ship - The AI **reviewer** role (session-end reflection). The three live roles ship
first. first; the reviewer returns as **M7 — Reflection**, which closes the loop.
- Privileged enforcement (guardian, IPC, nftables, delayed admin) — same Stage 2 - Privileged enforcement (guardian, IPC, nftables, delayed admin) — same Stage 2
boundary as the original spec. boundary as the original spec. This is the path toward the **entry gate**
(see "Destination" in the Roadmap) and is deliberately the last milestone.
## Process Model ## Process Model
@@ -129,7 +130,7 @@ Each port is a small Go interface with one real adapter (and a fake for tests).
| Advisor | `ai.Assistant` (`Coach`/`JudgeDrift`/`Nudge`) | What's the smart call here? | `claude`/`codex` CLI | M2M3 | | Advisor | `ai.Assistant` (`Coach`/`JudgeDrift`/`Nudge`) | What's the smart call here? | `claude`/`codex` CLI | M2M3 |
| Tasks | `tasks.Provider` | What *should* I be doing? | Amazing Marvin (existing `ampy` + marvin MCP) | deferred (M5) | | Tasks | `tasks.Provider` | What *should* I be doing? | Amazing Marvin (existing `ampy` + marvin MCP) | deferred (M5) |
| Knowledge | `knowledge.Source` | Who am I; what are my priorities? | PKM / files | deferred (M6) | | Knowledge | `knowledge.Source` | Who am I; what are my priorities? | PKM / files | deferred (M6) |
| Enforcement | `enforce.Guard` | Make drift cost something | window-minimize now (legacy `minimize_other`); nftables/guardian later | deferred (M7) | | Enforcement / Gate | `enforce.Guard` | Make drift cost something — ultimately, gate the machine on a declared intention | window-minimize (legacy `minimize_other`) nftables/guardian → entry gate | deferred (M8) |
| UI | `web` | Show me; take my input | Gin + browser over SSE | M0, ongoing | | UI | `web` | Show me; take my input | Gin + browser over SSE | M0, ongoing |
Persistence (`store`) is infrastructure shared by the orchestrator, not a port. Persistence (`store`) is infrastructure shared by the orchestrator, not a port.
@@ -196,8 +197,19 @@ machine exposes, but never owns a transition.
Each milestone is independently shippable and gets its own spec → plan → build Each milestone is independently shippable and gets its own spec → plan → build
cycle. M0M4 build the core plus the first two ports (activity, advisor) and the cycle. M0M4 build the core plus the first two ports (activity, advisor) and the
UI; M5M7 add the remaining ports, each a small interface + adapter following UI; M5M8 add the remaining ports and close the loop, each a small interface +
the pattern M1 establishes. adapter following the pattern M1 establishes.
**Destination — the gate-first loop.** The end state is an OS-level focus loop:
the **Guard** checks for a declared intention *before* the machine is usable,
the user commits, works under monitoring, and every cycle ends in
**reflection** before returning to the gate (gate → plan → work → reflect →
gate). The earlier milestones build "track and advise"; the later ones turn
that into "you don't drift in the first place." We get there incrementally — the
Guard's privileged entry-gate behavior is deliberately the last and heaviest
step (M8), and everything before it is valuable standalone. The runtime state
machine already mirrors this loop: `locked` is the gate, `planning`/`active` are
declare-and-work, `review` is reflection.
- **M0 — Walking skeleton.** Daemon + Gin + minimal browser UI; port `domain` + - **M0 — Walking skeleton.** Daemon + Gin + minimal browser UI; port `domain` +
`statemachine`; snapshot persistence; manual commitment → timebox → end. `statemachine`; snapshot persistence; manual commitment → timebox → end.
@@ -214,9 +226,16 @@ the pattern M1 establishes.
adapter. Pull the day's commitments from real tasks. adapter. Pull the day's commitments from real tasks.
- **M6 — Knowledge port.** `knowledge.Source` over personal priorities and - **M6 — Knowledge port.** `knowledge.Source` over personal priorities and
about-me context, feeding the advisor richer grounding. about-me context, feeding the advisor richer grounding.
- **M7 — Enforcement port.** `enforce.Guard`: make drift cost something, starting - **M7 — Reflection.** The deferred AI **reviewer** role, promoted into the main
with window-minimize (porting legacy `minimize_other`) and later the loop: a session-end reflection that reads the audit trail and per-window stats
privileged guardian / nftables path. (built in M1) to summarize what happened and feed the next planning cycle.
Closes the "Focus OS Reflection" step and makes the loop self-reinforcing.
- **M8 — Enforcement & gate.** `enforce.Guard`: make drift cost something,
starting with window-minimize (porting legacy `minimize_other`) and the
nftables/DNS path, building toward the **entry gate** — the Guard checking for
a declared intention before the machine is usable. The privileged guardian
process, root-owned IPC, and break-glass keep the original Stage 2 threat
boundary and are the final, heaviest step.
The first sub-project to brainstorm and spec in detail is **M0**. The first sub-project to brainstorm and spec in detail is **M0**.
@@ -233,12 +252,12 @@ ports + UI). The items below are deferred past it; some are now named ports with
their own later milestones (see Roadmap), others remain fully out of scope. their own later milestones (see Roadmap), others remain fully out of scope.
- **Tasks, knowledge, and enforcement ports** — named in the architecture and - **Tasks, knowledge, and enforcement ports** — named in the architecture and
slotted as M5M7, but not built in v1. The `enforce.Guard` port starts with slotted as M5M8, but not built in v1. The `enforce.Guard` port starts with
window-minimize; its **privileged** adapters (guardian process, root-owned window-minimize and builds toward the entry gate; its **privileged** adapters
Unix socket IPC, nftables/DNS domain blocking, delayed admin, break-glass) (guardian process, root-owned Unix socket IPC, nftables/DNS domain blocking,
remain out of scope until that milestone and keep the original Stage 2 threat delayed admin, break-glass) remain out of scope until M8 and keep the original
boundary. Stage 2 threat boundary.
- AI reviewer / session-end reflection. - AI reviewer / session-end reflection — now scheduled as **M7 — Reflection**.
- Wayland compositor adapters beyond the existing degraded reporting. - Wayland compositor adapters beyond the existing degraded reporting.
- Planner/project model and outcome writeback (beyond the M5 tasks port). - Planner/project model and outcome writeback (beyond the M5 tasks port).
- Presence sensing. - Presence sensing.