aaronrene / overseer-kit public
index.html html
193 lines 11.8 KB
Raw
sha256:8d7f41aafae41deee70035a92f93602ef1722a290153597451e5932af503a42c docs: queue board-identity follow-ups so they survive the session Human 11 hours ago
1 <!DOCTYPE html>
2 <html lang="en">
3 <head>
4 <meta charset="utf-8">
5 <meta name="viewport" content="width=device-width, initial-scale=1">
6 <title>🆗 Overseer Kit — ok app</title>
7 <link rel="stylesheet" href="/assets/app.css">
8 </head>
9 <body>
10 <header class="chrome-header">
11 <h1>🆗 Overseer Kit</h1>
12 <p class="subtitle">Local governance console · loopback only · ok app</p>
13 <p id="bound-repo" class="bound-repo" hidden>Bound repo: <code id="bound-repo-path"></code></p>
14 </header>
15
16 <p id="honesty-strip" class="honesty-strip" role="note">
17 Kit ≠ product runtime — tasks live in consumer products. Local governance console for 🆗 Overseer Kit — not a product task runtime.
18 </p>
19
20 <section id="auth-panel" class="panel">
21 <h2>Session bootstrap</h2>
22 <p>Paste the session credential and CSRF values printed once in the terminal when you started <code>ok app</code>.</p>
23 <label>Session credential <input id="session-input" type="password" autocomplete="off"></label>
24 <label>CSRF token <input id="csrf-input" type="password" autocomplete="off"></label>
25 <button id="auth-save" type="button">Connect</button>
26 <p id="auth-status" class="status"></p>
27 </section>
28
29 <p id="session-collapsed" class="session-collapsed" hidden>
30 Connected · <button type="button" id="auth-reconnect" class="linkish">Reconnect / new session</button>
31 </p>
32
33 <nav class="tabs" id="tabs" hidden>
34 <button type="button" data-tab="overview" id="tab-btn-overview" class="active" title="What this console is; suite doors; how to open it; bound repo">Overview</button>
35 <button type="button" data-tab="status" id="tab-btn-status" title="Health of governance for the bound repo">Status</button>
36 <button type="button" data-tab="roadmap" id="tab-btn-roadmap" title="Living phase board">Roadmap</button>
37 <button type="button" data-tab="handover" id="tab-btn-handover" title="Next-session relay / paste prompt">Handover</button>
38 <button type="button" data-tab="gates" id="tab-btn-gates" title="Pending honesty/governance reminders">Gates</button>
39 <button type="button" data-tab="actions" id="tab-btn-actions" title="Dry-run-first freeze review + governance-sync + honesty-status">Actions</button>
40 <button type="button" data-tab="ledger" id="tab-btn-ledger" title="Append-only honesty ledger view/verify">Ledger</button>
41 <button type="button" data-tab="structure" id="tab-btn-structure" title="Full flowchart gallery">Structure</button>
42 </nav>
43 <p id="tab-explainer" class="tab-explainer" hidden>What this console is; suite doors; how to open it; bound repo</p>
44
45 <main id="content" hidden>
46 <section id="tab-overview" class="tab-panel active">
47 <p class="one-liner">Local governance console for 🆗 Overseer Kit — not a product task runtime.</p>
48 <p>Open-source governance CLI + local console (MIT). Terminal + living docs remain day-to-day authority; this UI is a convenience frontend.</p>
49
50 <h3>Open the local console</h3>
51 <ul class="playbook" id="overview-playbook">
52 <li><strong>Path 1 — Download Mac console</strong> (preferred on Apple Silicon): confirm Python 3.11+; download the signed <code>aarch64</code> <code>.dmg</code> from
53 <a class="suite-cta" href="https://github.com/aaronrene/overseer-kit/releases/tag/v0.1.0" target="_blank" rel="noopener noreferrer">GitHub Releases v0.1.0</a>;
54 set <code>OVERSEER_REPO_ROOT</code> to your governed repo (otherwise the shell binds the bundled kit — no folder picker); launch.</li>
55 <li><strong>Path 2 — Browser</strong>: from a governed repo run <code>ok app --open</code>; paste <code>session_credential</code> + <code>csrf_token</code> from that terminal → Connect.</li>
56 <li><strong>Path 3 — Dev desktop</strong>: kit root <code>./scripts/bundle-desktop-kit.sh</code> then <code>cd desktop && npm install && npm run tauri dev</code> (Python 3.11+ + Rust/Node).</li>
57 </ul>
58 <p class="bound-honesty" id="overview-bound-honesty"><em>This console is bound to one local checkout. Reads and writes (when confirmed) apply only to that tree — not to overseerkit.com and not to arbitrary remote repos. Desktop Path 1/3: set <code>OVERSEER_REPO_ROOT</code> to your governed repo; otherwise the shell binds the bundled kit.</em></p>
59
60 <h3>L0 → L3 (summary)</h3>
61 <ul class="layer-stack">
62 <li><strong>L0 Governance</strong> — Living ROADMAP + HANDOVER, freeze review, governance-sync, tiers — always on</li>
63 <li><strong>L1 Domain checkpoints</strong> — Consumer-owned verify scripts + manifests; kit owns <code>ok verify-step</code> orchestrator</li>
64 <li><strong>L2 Honesty / roles</strong> — Producer ≠ verifier; hash-chained ledger; co-requirement hooks</li>
65 <li><strong>L3 Substrate (optional)</strong> — MuseHub deepens identity/history; never required for L0–L2</li>
66 </ul>
67
68 <h3>Suite doors</h3>
69 <ul class="cta-list" id="overview-ctas">
70 <li><a class="suite-cta" href="https://github.com/aaronrene/overseer-kit" target="_blank" rel="noopener noreferrer">GitHub — overseer-kit</a> — Clone / <code>ok init</code> — not browser signup</li>
71 <li><a class="suite-cta" href="https://musehub.ai" target="_blank" rel="noopener noreferrer">MuseHub</a> — Optional L3; same commands, deeper provenance when ready</li>
72 <li><a class="suite-cta" href="https://github.com/aaronrene/overseer-kit/blob/main/docs/CONSUMER-ADAPTER-PATTERN.md" target="_blank" rel="noopener noreferrer">Consumer pattern</a> — Kit vs consumer boundary; domain packs stay in the consumer repo</li>
73 <li><a class="suite-cta" href="https://github.com/aaronrene/overseer-kit/blob/main/docs/README.md" target="_blank" rel="noopener noreferrer">Public docs index</a> — Quickstarts + product runbooks (phase history under <code>docs/archive/</code>)</li>
74 </ul>
75 <p class="site-note">overseerkit.com explains layers; it does not run tasks and does not mint session credentials.</p>
76 <p><button type="button" id="open-structure" class="linkish">Open Structure diagrams</button></p>
77 </section>
78
79 <section id="tab-status" class="tab-panel">
80 <button id="refresh-status" type="button">Refresh status</button>
81 <div id="status-summary" class="status-summary" aria-live="polite"></div>
82 <details id="status-raw-details">
83 <summary>Show raw JSON</summary>
84 <pre id="status-output"></pre>
85 </details>
86 </section>
87
88 <section id="tab-roadmap" class="tab-panel">
89 <button id="load-roadmap" type="button">Load roadmap</button>
90 <pre id="roadmap-output"></pre>
91 </section>
92
93 <section id="tab-handover" class="tab-panel">
94 <button id="load-handover" type="button">Load handover</button>
95 <pre id="handover-output"></pre>
96 </section>
97
98 <section id="tab-gates" class="tab-panel">
99 <button id="load-gates" type="button">Load gates</button>
100 <pre id="gates-output"></pre>
101 </section>
102
103 <section id="tab-actions" class="tab-panel">
104 <h3>Freeze review</h3>
105 <label>Artifact path <input id="freeze-path" type="text" placeholder="docs/archive/phases/PHASE-....md"></label>
106 <label><input id="freeze-dry-run" type="checkbox" checked> Dry run (default)</label>
107 <button id="run-freeze" type="button">Run freeze review</button>
108 <pre id="freeze-output"></pre>
109
110 <h3>Governance sync</h3>
111 <label><input id="sync-write" type="checkbox"> Write (requires explicit confirm)</label>
112 <button id="run-sync" type="button">Run governance sync</button>
113 <pre id="sync-output"></pre>
114 <p class="hint">Multi-lane governance-sync remains CLI-only.</p>
115
116 <h3>Honesty status</h3>
117 <button id="run-honesty" type="button">Run honesty-status (fixture hook)</button>
118 <pre id="honesty-output"></pre>
119 </section>
120
121 <section id="tab-ledger" class="tab-panel">
122 <button id="ledger-show" type="button">Show ledger</button>
123 <button id="ledger-verify" type="button">Verify ledger</button>
124 <pre id="ledger-output"></pre>
125 </section>
126
127 <section id="tab-structure" class="tab-panel">
128 <h3>Structure diagrams</h3>
129 <p>Offline SVG gallery — diagrams are pre-rendered; no CDN chart runtime.</p>
130
131 <figure class="diagram" id="diagram-lanes">
132 <figcaption>Lanes are few durable ROADMAP/HANDOVER pairs. Rows/manifests are many work units — do not invent a lane per video/ticket.</figcaption>
133 <img src="/assets/diagrams/lanes.svg" alt="Single-lane ROADMAP paired with HANDOVER versus optional docs.lanes multi-lane kit and product paths" width="720" height="280">
134 <ul class="diagram-fallback">
135 <li>Single-lane default: ROADMAP.md ↔ HANDOVER.md</li>
136 <li>Optional multi-lane: lane kit / product each map to roadmap + handover paths</li>
137 </ul>
138 <p class="structure-ctas">
139 <a class="suite-cta" href="https://github.com/aaronrene/overseer-kit" target="_blank" rel="noopener noreferrer">GitHub — overseer-kit</a>
140 ·
141 <a class="suite-cta" href="https://github.com/aaronrene/overseer-kit/blob/main/docs/CONSUMER-ADAPTER-PATTERN.md" target="_blank" rel="noopener noreferrer">Consumer pattern</a>
142 </p>
143 </figure>
144
145 <figure class="diagram" id="diagram-regimes">
146 <figcaption>git-only is a first-class baseline. Muse regimes deepen substrate; they do not unlock exclusive L0–L2 features.</figcaption>
147 <img src="/assets/diagrams/regimes.svg" alt="VCS regimes from git-only to muse-plus-git-mirror to muse-only" width="640" height="320">
148 <ul class="diagram-fallback">
149 <li>git-only — GitHub canonical</li>
150 <li>muse+git-mirror — Muse canonical + GitHub mirror</li>
151 <li>muse-only — Muse canonical; no GitHub mirror</li>
152 </ul>
153 </figure>
154
155 <figure class="diagram" id="diagram-layers">
156 <figcaption>Enable modules when stakes rise. L2 honesty expects L1 evidence (or equivalent). L3 MuseHub remains optional deepen and is not drawn as a required stack tier here.</figcaption>
157 <img src="/assets/diagrams/layers.svg" alt="Layer stack L0 governance to L1 domain checkpoints to L2 honesty ledger" width="420" height="280">
158 <ul class="diagram-fallback">
159 <li>L0 Governance — always on</li>
160 <li>L1 Domain checkpoints — opt-in</li>
161 <li>L2 Honesty ledger — opt-in</li>
162 </ul>
163 </figure>
164
165 <figure class="diagram" id="diagram-kit-consumer">
166 <figcaption>Kit ships sockets. VideoFactory / Scooling (and peers) own domain packs and product runtime UX.</figcaption>
167 <img src="/assets/diagrams/kit-consumer.svg" alt="Overseer Kit clone through ok init to config and living docs, then consumer domain packs for VideoFactory and Scooling" width="760" height="260">
168 <ul class="diagram-fallback">
169 <li>Overseer Kit clone → ok init / migrate → .overseer/config.yaml → Living docs L0</li>
170 <li>Consumer domain pack → VideoFactory verify scripts / Scooling product runtime</li>
171 <li>Scooling uses the kit; does not live in kit core</li>
172 </ul>
173 </figure>
174 </section>
175 </main>
176
177 <footer class="chrome-footer">
178 <p>Open source — MIT</p>
179 <p class="footer-links">
180 <a href="https://github.com/aaronrene/overseer-kit" target="_blank" rel="noopener noreferrer">GitHub — overseer-kit</a>
181 ·
182 <a href="https://musehub.ai" target="_blank" rel="noopener noreferrer">MuseHub</a>
183 ·
184 <a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/README.md" target="_blank" rel="noopener noreferrer">Docs</a>
185 ·
186 <a href="https://github.com/aaronrene/overseer-kit/blob/main/docs/CONSUMER-ADAPTER-PATTERN.md" target="_blank" rel="noopener noreferrer">Consumer pattern</a>
187 </p>
188 <p class="compat-note"><code>overseer</code> remains a compat shim; prefer <code>ok</code>.</p>
189 </footer>
190
191 <script src="/assets/app.js"></script>
192 </body>
193 </html>
File History 1 commit
sha256:8d7f41aafae41deee70035a92f93602ef1722a290153597451e5932af503a42c docs: queue board-identity follow-ups so they survive the session Human 11 hours ago