@midhunxavier/code-flow 0.1.0-preview.3 → 0.1.0-preview.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (62) hide show
  1. package/README.md +4 -4
  2. package/dist/remote-host.json +1 -1
  3. package/package.json +1 -1
  4. package/public/docs/accessibility.html +1 -1
  5. package/public/docs/acp-agents.html +1 -1
  6. package/public/docs/agent-containers.html +1 -1
  7. package/public/docs/api.html +1 -1
  8. package/public/docs/application-improvements.html +1 -1
  9. package/public/docs/architecture-explorer.html +1 -1
  10. package/public/docs/architecture.html +1 -1
  11. package/public/docs/auto-team.html +1 -1
  12. package/public/docs/automations.html +1 -1
  13. package/public/docs/checkpoint-review.html +1 -1
  14. package/public/docs/code-hosts.html +1 -1
  15. package/public/docs/code-intelligence.html +1 -1
  16. package/public/docs/configuration.html +1 -1
  17. package/public/docs/context-inspection.html +1 -1
  18. package/public/docs/coordinated-changes.html +1 -1
  19. package/public/docs/deferred-runs.html +1 -1
  20. package/public/docs/dependency-discovery.html +1 -1
  21. package/public/docs/documentation.html +1 -1
  22. package/public/docs/dynamic-teams-evaluation.html +1 -1
  23. package/public/docs/dynamic-teams-implementation-plan.html +1 -1
  24. package/public/docs/dynamic-teams-implementation-review-1.html +1 -1
  25. package/public/docs/dynamic-teams-plan-review-0.html +1 -1
  26. package/public/docs/extensions.html +1 -1
  27. package/public/docs/external-sources.html +1 -1
  28. package/public/docs/filesystem-policy.html +1 -1
  29. package/public/docs/filtered-tasks.html +1 -1
  30. package/public/docs/getting-started.html +1 -1
  31. package/public/docs/github-review-threads.html +1 -1
  32. package/public/docs/github.html +1 -1
  33. package/public/docs/help.html +1 -1
  34. package/public/docs/index.html +1 -1
  35. package/public/docs/installation.html +6 -6
  36. package/public/docs/launch-profiles.html +1 -1
  37. package/public/docs/maintenance.html +1 -1
  38. package/public/docs/memory-claims.html +1 -1
  39. package/public/docs/memory-storage.html +1 -1
  40. package/public/docs/notifications.html +1 -1
  41. package/public/docs/patterns.html +1 -1
  42. package/public/docs/performance-results.html +1 -1
  43. package/public/docs/performance.html +1 -1
  44. package/public/docs/project-conventions.html +1 -1
  45. package/public/docs/project-first-navigation-plan.html +1 -1
  46. package/public/docs/project-teams-implementation-plan.html +1 -1
  47. package/public/docs/project-teams.html +1 -1
  48. package/public/docs/provider-compatibility.html +1 -1
  49. package/public/docs/releasing.html +27 -8
  50. package/public/docs/remote-workers.html +1 -1
  51. package/public/docs/review-inbox.html +1 -1
  52. package/public/docs/run-storage.html +1 -1
  53. package/public/docs/runs.html +1 -1
  54. package/public/docs/search.json +1 -1
  55. package/public/docs/security.html +1 -1
  56. package/public/docs/shared-projects.html +1 -1
  57. package/public/docs/ssh-projects.html +1 -1
  58. package/public/docs/task-reruns.html +1 -1
  59. package/public/docs/team-collaboration.html +1 -1
  60. package/public/docs/verification.html +1 -1
  61. package/public/docs/vscode.html +1 -1
  62. package/public/docs/worker-permission-verification.html +1 -1
@@ -19,7 +19,7 @@
19
19
  <p>Tests cover exact CAS/hash/private storage, failures before activation, pinned policy intersection, case/traversal/credential/symlink rejection, actual browser allowed/denied reads and writes, version aliases, global execution denial and cross-repository activation races. Startup regressions ensure saved policies prevent trusted plugin initialization, interpreter probes and public phone history, and remove restricted results from shared feeds.</p>
20
20
  <hr>
21
21
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="help.html">Ask code-flow</a></p>
22
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/filesystem-policy.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="security.html"><small>← Previous</small>Security, subscriptions and caveats</a><a href="agent-containers.html"><small>Next →</small>Agent containers</a></nav></main>
22
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/filesystem-policy.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="security.html"><small>← Previous</small>Security, subscriptions and caveats</a><a href="agent-containers.html"><small>Next →</small>Agent containers</a></nav></main>
23
23
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#set-project-path-rules">Set project path rules</a><a class="depth-2" href="#execution-boundary">Execution boundary</a><a class="depth-2" href="#http-contract">HTTP contract</a></aside>
24
24
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
25
25
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -37,7 +37,7 @@ exec /opt/vendor/bin/codex &quot;$@&quot;
37
37
  <p>Run the regular filtered task, lifecycle, limits and browser suites for CAS/races/restore/UI evidence. Run <code>CODEFLOW_TEST_DOCKER=1 node --import tsx --test test/filtered-tasks-docker.test.ts</code> for real Docker namespace, original Git/denied blob absence, readonly mounts, fresh-home credential seeding, branch import and cancellation removal. The Docker fixture builds/removes its own small image and never contacts a model provider.</p>
38
38
  <hr>
39
39
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="help.html">Ask code-flow</a></p>
40
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/filtered-tasks.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="agent-containers.html"><small>← Previous</small>Agent containers</a><a href="dependency-discovery.html"><small>Next →</small>Dependency discovery</a></nav></main>
40
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/filtered-tasks.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="agent-containers.html"><small>← Previous</small>Agent containers</a><a href="dependency-discovery.html"><small>Next →</small>Dependency discovery</a></nav></main>
41
41
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#run-against-a-bounded-snapshot">Run against a bounded snapshot</a><a class="depth-2" href="#filesystem-and-runtime-boundary">Filesystem and runtime boundary</a><a class="depth-2" href="#preparing-authentication-without-host-caches">Preparing authentication without host caches</a><a class="depth-2" href="#review-import-cancellation-and-cleanup">Review, import, cancellation and cleanup</a><a class="depth-2" href="#api-and-tests">API and tests</a></aside>
42
42
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
43
43
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -136,7 +136,7 @@ git merge codeflow/&lt;run&gt;/build
136
136
  <li><strong>Cleanup:</strong> remove a run's worktrees with <code>git worktree remove .worktrees/&lt;run-id&gt;/&lt;name&gt;</code>, or delete the folder and run <code>git worktree prune</code>. The branches stay until you delete them. <strong>Archive…</strong> on a run, and <strong>Clean up</strong> in <a href="runs.html#insights-comparisons-and-finding-runs">Insights</a>, do this for you.</li>
137
137
  </ul>
138
138
  <p>Next: <a href="patterns.html">Team patterns</a> · <a href="runs.html">Talking to a run</a></p>
139
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/getting-started.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="installation.html"><small>← Previous</small>Install Code Flow preview</a><a href="patterns.html"><small>Next →</small>Team patterns</a></nav></main>
139
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/getting-started.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="installation.html"><small>← Previous</small>Install Code Flow preview</a><a href="patterns.html"><small>Next →</small>Team patterns</a></nav></main>
140
140
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#requirements">Requirements</a><a class="depth-2" href="#install-and-run">Install and run</a><a class="depth-3" href="#try-the-preview">Try the preview</a><a class="depth-3" href="#download-the-macos-app">Download the macOS app</a><a class="depth-3" href="#install-from-source">Install from source</a><a class="depth-3" href="#signing-in">Signing in</a><a class="depth-2" href="#development">Development</a><a class="depth-2" href="#your-first-run">Your first run</a><a class="depth-2" href="#return-to-a-project">Return to a project</a><a class="depth-2" href="#find-help-in-the-app">Find help in the app</a><a class="depth-2" href="#giving-agents-context">Giving agents context</a><a class="depth-2" href="#models-and-effort">Models and effort</a><a class="depth-2" href="#worktrees-and-branches">Worktrees and branches</a></aside>
141
141
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
142
142
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -19,7 +19,7 @@
19
19
  <p>Automated tests use injected GraphQL and a fake <code>gh</code> process only. Browser acceptance covers stale-reply rejection, refresh, resolve and reopen, forged snapshot rejection and separation from local verification. No live GitHub mutations were performed during development.</p>
20
20
  <hr>
21
21
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="help.html">Ask code-flow</a></p>
22
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/github-review-threads.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="github.html"><small>← Previous</small>GitHub, review and shipping</a><a href="task-reruns.html"><small>Next →</small>Selective task reruns</a></nav></main>
22
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/github-review-threads.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="github.html"><small>← Previous</small>GitHub, review and shipping</a><a href="task-reruns.html"><small>Next →</small>Selective task reruns</a></nav></main>
23
23
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#work-through-pr-feedback">Work through PR feedback</a><a class="depth-2" href="#api">API</a></aside>
24
24
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
25
25
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -150,7 +150,7 @@
150
150
  <p>To run these jobs on a schedule or from webhooks, see <a href="automations.html">Automations</a>.</p>
151
151
  <hr>
152
152
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="help.html">Ask code-flow</a></p>
153
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/github.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="verification.html"><small>← Previous</small>Verification and review</a><a href="github-review-threads.html"><small>Next →</small>GitHub review threads</a></nav></main>
153
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/github.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="verification.html"><small>← Previous</small>Verification and review</a><a href="github-review-threads.html"><small>Next →</small>GitHub review threads</a></nav></main>
154
154
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#review-and-ship">Review and ship</a><a class="depth-2" href="#start-from-where-the-work-lives">Start from where the work lives</a><a class="depth-3" href="#templates">Templates</a><a class="depth-3" href="#sweeps-many-at-once">Sweeps: many at once</a><a class="depth-3" href="#issues-and-pull-requests">Issues and pull requests</a><a class="depth-3" href="#review-council">Review council</a><a class="depth-3" href="#follow-through">Follow-through</a><a class="depth-3" href="#untrusted-text">Untrusted text</a></aside>
155
155
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
156
156
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -62,7 +62,7 @@
62
62
  </div><h2 id="hosted-documentation">Hosted documentation</h2>
63
63
  <p>GitHub Pages serves the same searchable guides. It cannot launch your local CLIs. The deployed site omits the companion panel and its controls. It does not connect to localhost or request credentials. To chat, open <strong>Help &amp; documentation</strong> from your running local app.</p>
64
64
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="security.html">Security</a></p>
65
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/help.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="acp-agents.html"><small>← Previous</small>ACP coding agents</a><a href="runs.html"><small>Next →</small>Runs and workspace</a></nav></main>
65
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/help.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="acp-agents.html"><small>← Previous</small>ACP coding agents</a><a href="runs.html"><small>Next →</small>Runs and workspace</a></nav></main>
66
66
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#open-the-assistant">Open the assistant</a><a class="depth-2" href="#what-it-receives">What it receives</a><a class="depth-2" href="#execution-boundaries">Execution boundaries</a><a class="depth-2" href="#troubleshooting">Troubleshooting</a><a class="depth-2" href="#hosted-documentation">Hosted documentation</a></aside>
67
67
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
68
68
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -81,7 +81,7 @@
81
81
  </ul>
82
82
  <p><a href="index.html">Project README</a> · <a href="getting-started.html">Getting started</a></p>
83
83
  <p>Project collaboration lives in <strong>More → Board</strong> and <strong>More → People</strong>. Scheduled tasks, backlogs and missions live in <strong>More → Automation</strong>; configured Board and Automation tabs stay visible. Global Inbox and Scheduling cover the current computer.</p>
84
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/README.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><span></span><a href="installation.html"><small>Next →</small>Install Code Flow preview</a></nav></main>
84
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/README.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><span></span><a href="installation.html"><small>Next →</small>Install Code Flow preview</a></nav></main>
85
85
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#try-the-preview">Try the preview</a><a class="depth-2" href="#from-task-to-reviewed-result">From task to reviewed result</a><a class="depth-2" href="#work-with-agents">Work with agents</a><a class="depth-2" href="#make-the-workspace-yours">Make the workspace yours</a><a class="depth-2" href="#connect-and-collaborate">Connect and collaborate</a><a class="depth-2" href="#operate-safely">Operate safely</a><a class="depth-2" href="#build-and-extend">Build and extend</a><a class="depth-2" href="#engineering-records">Engineering records</a></aside>
86
86
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
87
87
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -5,7 +5,7 @@
5
5
  <div class="layout"><nav class="sidebar" id="sidebar" aria-label="Documentation"><section><h2>Get started</h2><a href="index.html" >Overview</a><a href="installation.html" aria-current="page">Install Code Flow preview</a><a href="getting-started.html" >Getting started</a><a href="patterns.html" >Team patterns</a><a href="acp-agents.html" >ACP coding agents</a><a href="help.html" >Ask code-flow</a></section><section><h2>Work with agents</h2><a href="runs.html" >Runs and workspace</a><a href="auto-team.html" >Team</a><a href="project-teams.html" >Project missions (preview)</a><a href="review-inbox.html" >Review inbox</a><a href="verification.html" >Verification and review</a><a href="github.html" >GitHub, review and shipping</a><a href="github-review-threads.html" >GitHub review threads</a><a href="task-reruns.html" >Selective task reruns</a><a href="deferred-runs.html" >Deferred runs</a></section><section><h2>Your workspace</h2><a href="configuration.html" >Configuration</a><a href="context-inspection.html" >Context and budgets</a><a href="project-conventions.html" >Versioned project conventions</a><a href="checkpoint-review.html" >Checkpoints and reversions</a><a href="launch-profiles.html" >Service launch profiles</a><a href="code-intelligence.html" >Code intelligence</a><a href="architecture-explorer.html" >Architecture explorer</a><a href="memory-storage.html" >Project memory</a><a href="memory-claims.html" >Semantic claim review</a><a href="coordinated-changes.html" >Coordinated changes</a></section><section><h2>Connect and collaborate</h2><a href="team-collaboration.html" >Team collaboration</a><a href="shared-projects.html" >Shared project accounts</a><a href="ssh-projects.html" >SSH projects</a><a href="remote-workers.html" >Remote agent workers</a><a href="code-hosts.html" >GitLab and Bitbucket code workflows</a><a href="external-sources.html" >Read-only external sources</a><a href="automations.html" >Automations and away mode</a><a href="notifications.html" >Outbound notifications</a></section><section><h2>Operate safely</h2><a href="security.html" >Security, subscriptions and caveats</a><a href="filesystem-policy.html" >Project filesystem policy</a><a href="agent-containers.html" >Agent containers</a><a href="filtered-tasks.html" >Filtered Docker tasks</a><a href="dependency-discovery.html" >Dependency discovery</a><a href="maintenance.html" >Backup and maintenance</a></section><section><h2>Build and extend</h2><a href="architecture.html" >Architecture and development</a><a href="api.html" >Local API and command-line client</a><a href="extensions.html" >Provider and workflow extensions</a><a href="provider-compatibility.html" >Provider compatibility</a><a href="accessibility.html" >Accessibility acceptance</a><a href="performance.html" >Performance</a><a href="run-storage.html" >Run storage</a><a href="documentation.html" >Documentation and GitHub Pages</a><a href="releasing.html" >Preparing a preview release</a><a href="vscode.html" >Code Flow for VS Code</a></section><section><h2>Engineering records</h2><a href="application-improvements.html" >Application improvement program</a><a href="project-first-navigation-plan.html" >Project navigation review and implementation plan</a><a href="dynamic-teams-evaluation.html" >Dynamic teams: implementation evidence and rollout decision</a><a href="dynamic-teams-implementation-plan.html" >Dynamic teams, workflows, messaging, and memory</a><a href="dynamic-teams-implementation-review-1.html" >Review 1: the dynamic teams implementation</a><a href="worker-permission-verification.html" >Live worker permission verification</a><a href="dynamic-teams-plan-review-0.html" >Review 0: Dynamic teams implementation plan</a><a href="project-teams-implementation-plan.html" >Standing project teams implementation plan</a><a href="performance-results.html" >Measured performance: 19 October 2026</a></section><a class="app-link" id="back-app" hidden href="/">← Back to app</a></nav>
6
6
  <main id="content" tabindex="-1"><div class="breadcrumb">Documentation <span>/</span> Get started</div><article><h1 id="install-code-flow-preview">Install Code Flow preview</h1>
7
7
  <p>Open the macOS desktop app, or start the local browser app with one command. You do not need to clone Code Flow or add it to your project. The preview uses your installed coding CLIs and their existing logins.</p>
8
- <p><strong>Desktop preview 0.1.0-preview.3.</strong> Download the macOS app or use the exact release package below. The npm <code>preview</code> channel is published separately and may be older. See the <a href="https://github.com/midhunxavier/code-flow/releases/tag/v0.1.0-preview.3">preview release notes and checksums</a>.</p>
8
+ <p><strong>Desktop preview 0.1.0-preview.4.</strong> Download the macOS app or use the exact release package below. Each published app release automatically updates the npm <code>latest</code> and <code>preview</code> channels after npm processing completes. See the <a href="https://github.com/midhunxavier/code-flow/releases/tag/v0.1.0-preview.4">preview release notes and checksums</a>.</p>
9
9
  <h2 id="choose-an-installation-method">Choose an installation method</h2>
10
10
  <div class="install-picker" data-install-picker>
11
11
  <div class="install-tabs" role="tablist" aria-label="Installation method">
@@ -17,7 +17,7 @@
17
17
  <section id="install-unix" role="tabpanel" aria-labelledby="install-tab-unix" tabindex="0">
18
18
  <h3>Try it with one command</h3>
19
19
  <p>Install Node.js 22.13+ and Git 2.38+, then run:</p>
20
- <pre><code class="language-sh">npx --yes --package=https://github.com/midhunxavier/code-flow/releases/download/v0.1.0-preview.3/midhunxavier-code-flow-0.1.0-preview.3.tgz codeflow</code></pre>
20
+ <pre><code class="language-sh">npx --yes --package=https://github.com/midhunxavier/code-flow/releases/download/v0.1.0-preview.4/midhunxavier-code-flow-0.1.0-preview.4.tgz codeflow</code></pre>
21
21
  <p>Code Flow starts locally and opens its sign-in link in your default browser. Keep the terminal open while you work. Press <strong>Ctrl+C</strong> to stop the server.</p>
22
22
  </section>
23
23
  <section id="install-windows" role="tabpanel" aria-labelledby="install-tab-windows" tabindex="0">
@@ -42,10 +42,10 @@ codeflow</code></pre>
42
42
  <p>Homebrew installs Node and Git as dependencies. Update with <code>brew update &amp;&amp; brew upgrade code-flow</code>. If the tap is unavailable, use npm.</p>
43
43
  </section>
44
44
  </div><h2 id="macos-app-download">macOS app download</h2>
45
- <p>Prefer an app you can open from Applications? Download <strong>0.1.0-preview.3</strong> for your Mac:</p>
45
+ <p>Prefer an app you can open from Applications? Download <strong>0.1.0-preview.4</strong> for your Mac:</p>
46
46
  <ul>
47
- <li><a href="https://github.com/midhunxavier/code-flow/releases/download/v0.1.0-preview.3/code-flow-0.1.0-preview.3-macos-arm64-unnotarized.dmg">Download Apple Silicon DMG (M1 or later)</a></li>
48
- <li><a href="https://github.com/midhunxavier/code-flow/releases/download/v0.1.0-preview.3/code-flow-0.1.0-preview.3-macos-x64-unnotarized.dmg">Download Intel DMG</a></li>
47
+ <li><a href="https://github.com/midhunxavier/code-flow/releases/download/v0.1.0-preview.4/code-flow-0.1.0-preview.4-macos-arm64-unnotarized.dmg">Download Apple Silicon DMG (M1 or later)</a></li>
48
+ <li><a href="https://github.com/midhunxavier/code-flow/releases/download/v0.1.0-preview.4/code-flow-0.1.0-preview.4-macos-x64-unnotarized.dmg">Download Intel DMG</a></li>
49
49
  </ul>
50
50
  <ol>
51
51
  <li>Choose <strong>arm64</strong> for Apple Silicon, or <strong>x64</strong> for an Intel Mac. macOS 13 or later is required.</li>
@@ -73,7 +73,7 @@ codeflow client --help # authenticated API client
73
73
  <p>Settings and history live in <code>~/.codeflow</code>, outside the installation. Reinstalling, upgrading or removing the launcher preserves that folder. Set <code>CODEFLOW_HOME</code> to an absolute path to use a separate data directory. Avoid switching an existing data directory back to an older preview; back it up before trying new versions.</p>
74
74
  <p>The preview does not install or sign in to agent CLIs for you. Provider access and usage limits depend on your account. See <a href="security.html">security</a>, <a href="configuration.html">configuration</a> and <a href="releasing.html">preview release preparation</a>.</p>
75
75
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a></p>
76
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/installation.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="index.html"><small>← Previous</small>Your agents. A clear path forward.</a><a href="getting-started.html"><small>Next →</small>Getting started</a></nav></main>
76
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/installation.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="index.html"><small>← Previous</small>Your agents. A clear path forward.</a><a href="getting-started.html"><small>Next →</small>Getting started</a></nav></main>
77
77
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#choose-an-installation-method">Choose an installation method</a><a class="depth-2" href="#macos-app-download">macOS app download</a><a class="depth-2" href="#connect-an-agent-and-start">Connect an agent and start</a><a class="depth-2" href="#startup-options">Startup options</a><a class="depth-2" href="#settings-updates-and-removal">Settings, updates and removal</a></aside>
78
78
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
79
79
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -41,7 +41,7 @@
41
41
  <p>The API uses <code>GET /api/runs/:id/launch-profiles?worktree=NAME</code> for <code>{profiles,found,error?,session}</code>, <code>POST</code> with <code>{worktree,profile,allowUntrusted?}</code> to explicitly start, and <code>DELETE</code> with the worktree query to stop. The backend resolves run-owned worktrees; callers cannot supply an arbitrary filesystem root. A start returns a <code>LaunchSession</code> after readiness succeeds. Errors retain session logs, retrievable through <code>GET</code>.</p>
42
42
  <hr>
43
43
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="help.html">Ask code-flow</a></p>
44
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/launch-profiles.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="checkpoint-review.html"><small>← Previous</small>Checkpoints and reversions</a><a href="code-intelligence.html"><small>Next →</small>Code intelligence</a></nav></main>
44
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/launch-profiles.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="checkpoint-review.html"><small>← Previous</small>Checkpoints and reversions</a><a href="code-intelligence.html"><small>Next →</small>Code intelligence</a></nav></main>
45
45
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#start-the-services-you-need">Start the services you need</a></aside>
46
46
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
47
47
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -53,7 +53,7 @@ npx tsx scripts/maintenance.ts compact --id RUN_ID --apply
53
53
  <p>Checkpoints speed up startup but are optional projections. JSONL logs and recovery journals remain the source of truth and are preserved until an explicit retention or compaction operation.</p>
54
54
  <hr>
55
55
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="help.html">Ask code-flow</a></p>
56
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/maintenance.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="dependency-discovery.html"><small>← Previous</small>Dependency discovery</a><a href="architecture.html"><small>Next →</small>Architecture and development</a></nav></main>
56
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/maintenance.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="dependency-discovery.html"><small>← Previous</small>Dependency discovery</a><a href="architecture.html"><small>Next →</small>Architecture and development</a></nav></main>
57
57
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#protect-your-local-history">Protect your local history</a><a class="depth-2" href="#encrypted-backup-and-restore">Encrypted backup and restore</a><a class="depth-2" href="#saved-per-type-retention">Saved per-type retention</a><a class="depth-2" href="#log-compaction">Log compaction</a><a class="depth-2" href="#startup-checkpoints">Startup checkpoints</a></aside>
58
58
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
59
59
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -24,7 +24,7 @@
24
24
  <p>Limits: 500 entries; 20,000 source characters per body; 12 claims per entry; 1,000 claims total; 50,000 candidate comparisons; 100 findings; 512-character evidence snippets; 8 KiB-character structured blocks. Offsets refer to UTF-16 positions in the source body, as used by the browser editor. Every truncation and unsupported fact is reported. The feature runs locally without provider quota, network downloads, shell execution or automatic memory mutation.</p>
25
25
  <hr>
26
26
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="help.html">Ask code-flow</a></p>
27
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/memory-claims.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="memory-storage.html"><small>← Previous</small>Project memory</a><a href="coordinated-changes.html"><small>Next →</small>Coordinated changes</a></nav></main>
27
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/memory-claims.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="memory-storage.html"><small>← Previous</small>Project memory</a><a href="coordinated-changes.html"><small>Next →</small>Coordinated changes</a></nav></main>
28
28
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#review-conflicting-guidance">Review conflicting guidance</a></aside>
29
29
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
30
30
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -51,7 +51,7 @@
51
51
  <p>Run journals, settings and the older recurring-review lessons under <code>learnings/</code> retain their existing formats. SQLite is used for the structured agent-memory system; this is not a migration of all application state.</p>
52
52
  <hr>
53
53
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="help.html">Ask code-flow</a></p>
54
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/memory-storage.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="architecture-explorer.html"><small>← Previous</small>Architecture explorer</a><a href="memory-claims.html"><small>Next →</small>Semantic claim review</a></nav></main>
54
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/memory-storage.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="architecture-explorer.html"><small>← Previous</small>Architecture explorer</a><a href="memory-claims.html"><small>Next →</small>Semantic claim review</a></nav></main>
55
55
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#explore-project-knowledge">Explore project knowledge</a><a class="depth-2" href="#storage-and-migration">Storage and migration</a><a class="depth-2" href="#search-and-graph">Search and graph</a></aside>
56
56
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
57
57
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -32,7 +32,7 @@
32
32
  <p>Changing the configured URL or protocol requires renewed opt-in. Disabling a destination or narrowing its scope cancels pending automatic deliveries, but cannot retract a request already in flight. Restoring an encrypted backup disables saved notification opt-ins and cancels pending or sending deliveries. Corrupt saved state leaves notifications unavailable and preserves the file for repair. Delivery state belongs to one server process; do not share its storage across multiple running servers.</p>
33
33
  <hr>
34
34
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="help.html">Ask code-flow</a></p>
35
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/notifications.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="automations.html"><small>← Previous</small>Automations and away mode</a><a href="security.html"><small>Next →</small>Security, subscriptions and caveats</a></nav></main>
35
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/notifications.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="automations.html"><small>← Previous</small>Automations and away mode</a><a href="security.html"><small>Next →</small>Security, subscriptions and caveats</a></nav></main>
36
36
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#choose-where-alerts-go">Choose where alerts go</a></aside>
37
37
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
38
38
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -188,7 +188,7 @@
188
188
  <p>Adding your own pattern: see <a href="architecture.html#adding-a-pattern">Architecture</a>.</p>
189
189
  <hr>
190
190
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="help.html">Ask code-flow</a></p>
191
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/patterns.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="getting-started.html"><small>← Previous</small>Getting started</a><a href="acp-agents.html"><small>Next →</small>ACP coding agents</a></nav></main>
191
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/patterns.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="getting-started.html"><small>← Previous</small>Getting started</a><a href="acp-agents.html"><small>Next →</small>ACP coding agents</a></nav></main>
192
192
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#team-patterns-1">Team patterns</a><a class="depth-2" href="#checks-loops-and-limits">Checks, loops and limits</a></aside>
193
193
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
194
194
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -203,7 +203,7 @@ npm run test:rust
203
203
  <a href="performance.html">resource limits and architecture</a>, and the
204
204
  <a href="https://github.com/midhunxavier/code-flow/blob/main/experiments/rust-transcript/README.md">Rust experiment</a>.</p>
205
205
  <p><a href="index.html">Documentation library</a> · <a href="architecture.html">Development guide</a></p>
206
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/performance-results.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="project-teams-implementation-plan.html"><small>← Previous</small>Standing project teams implementation plan</a><a href="vscode.html"><small>Next →</small>Code Flow for VS Code</a></nav></main>
206
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/performance-results.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="project-teams-implementation-plan.html"><small>← Previous</small>Standing project teams implementation plan</a><a href="vscode.html"><small>Next →</small>Code Flow for VS Code</a></nav></main>
207
207
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#comparison">Comparison</a><a class="depth-2" href="#resource-tradeoffs-and-variance">Resource tradeoffs and variance</a><a class="depth-2" href="#rust-decision">Rust decision</a><a class="depth-2" href="#reproduction-and-scope">Reproduction and scope</a></aside>
208
208
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
209
209
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -159,7 +159,7 @@ Agent execution and provider inference are excluded. See the Rust experiment&#39
159
159
  <a href="https://github.com/midhunxavier/code-flow/blob/main/experiments/rust-transcript/README.md">README</a> for its scope and parity test.</p>
160
160
  <hr>
161
161
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="help.html">Ask code-flow</a></p>
162
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/performance.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="accessibility.html"><small>← Previous</small>Accessibility acceptance</a><a href="run-storage.html"><small>Next →</small>Run storage</a></nav></main>
162
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/performance.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="accessibility.html"><small>← Previous</small>Accessibility acceptance</a><a href="run-storage.html"><small>Next →</small>Run storage</a></nav></main>
163
163
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#measure-the-workload-first">Measure the workload first</a><a class="depth-2" href="#history-and-transcripts">History and transcripts</a><a class="depth-2" href="#streaming-and-storage">Streaming and storage</a><a class="depth-2" href="#ui-and-analysis">UI and analysis</a><a class="depth-2" href="#measurement-and-verification">Measurement and verification</a><a class="depth-2" href="#beforeafter-and-native-comparison">Before/after and native comparison</a></aside>
164
164
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
165
165
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -15,7 +15,7 @@
15
15
  <p>API contracts: <code>GET /api/projects/:id/conventions</code>, <code>PUT</code> with <code>{revision,text,note?}</code>, <code>POST /restore-preview</code> with <code>{version}</code>, and <code>POST /restore</code> with <code>{revision,version,hash}</code>. <code>GET /publication?repo=PATH</code> returns the observed <code>{sourceHash,head,clean,text,...}</code>. Explicit <code>POST /publish</code> requires <code>{repo,revision,sourceHash,head}</code>. Publication authorization is checked against the project&#39;s repository membership and current activity on the server; private drafts are not automatic execution instructions.</p>
16
16
  <hr>
17
17
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="help.html">Ask code-flow</a></p>
18
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/project-conventions.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="context-inspection.html"><small>← Previous</small>Context and budgets</a><a href="checkpoint-review.html"><small>Next →</small>Checkpoints and reversions</a></nav></main>
18
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/project-conventions.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="context-inspection.html"><small>← Previous</small>Context and budgets</a><a href="checkpoint-review.html"><small>Next →</small>Checkpoints and reversions</a></nav></main>
19
19
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#keep-project-guidance-current">Keep project guidance current</a></aside>
20
20
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
21
21
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -580,7 +580,7 @@ More
580
580
  </tr>
581
581
  </tbody></table>
582
582
  </div><p>The recommended first implementation is the explicit context and owner project flow: one clear project destination, one composer path, predictable repository selection and visible computer scope. That creates the foundation the remaining simplification depends on.</p>
583
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/project-first-navigation-plan.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="application-improvements.html"><small>← Previous</small>Application improvement program</a><a href="dynamic-teams-evaluation.html"><small>Next →</small>Dynamic teams: implementation evidence and rollout decision</a></nav></main>
583
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/project-first-navigation-plan.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="application-improvements.html"><small>← Previous</small>Application improvement program</a><a href="dynamic-teams-evaluation.html"><small>Next →</small>Dynamic teams: implementation evidence and rollout decision</a></nav></main>
584
584
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#implemented-navigation-contract">Implemented navigation contract</a><a class="depth-2" href="#phases-46-implementation-and-validation">Phases 4–6 implementation and validation</a><a class="depth-2" href="#review-of-the-idea">Review of the idea</a><a class="depth-2" href="#terminology-contract">Terminology contract</a><a class="depth-2" href="#proposed-navigation">Proposed navigation</a><a class="depth-2" href="#user-flows">User flows</a><a class="depth-3" href="#first-project-and-first-run">First project and first run</a><a class="depth-3" href="#returning-to-a-project">Returning to a project</a><a class="depth-3" href="#working-with-multiple-repositories">Working with multiple repositories</a><a class="depth-3" href="#working-on-another-computer">Working on another computer</a><a class="depth-3" href="#collaborating-with-people">Collaborating with people</a><a class="depth-3" href="#scheduling-and-ongoing-missions">Scheduling and ongoing missions</a><a class="depth-2" href="#context-and-routing-design">Context and routing design</a><a class="depth-3" href="#resolve-context-explicitly">Resolve context explicitly</a><a class="depth-3" href="#add-project-destinations-without-breaking-links">Add project destinations without breaking links</a><a class="depth-3" href="#reuse-existing-screens">Reuse existing screens</a><a class="depth-2" href="#implementation-sequence">Implementation sequence</a><a class="depth-3" href="#phase-1-establish-the-design-contract">Phase 1 Establish the design contract</a><a class="depth-3" href="#phase-2-implement-explicit-context-and-route-compatibility">Phase 2 Implement explicit context and route compatibility</a><a class="depth-3" href="#phase-3-deliver-the-owner-project-experience">Phase 3 Deliver the owner project experience</a><a class="depth-3" href="#phase-4-integrate-collaboration-with-correct-source-identity">Phase 4 Integrate collaboration with correct source identity</a><a class="depth-3" href="#phase-5-complete-project-automation-and-discoverability">Phase 5 Complete project automation and discoverability</a><a class="depth-3" href="#phase-6-validate-and-roll-out">Phase 6 Validate and roll out</a><a class="depth-2" href="#migration-and-compatibility">Migration and compatibility</a><a class="depth-2" href="#validation-plan">Validation plan</a><a class="depth-2" href="#principal-risks-and-controls">Principal risks and controls</a></aside>
585
585
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
586
586
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -765,7 +765,7 @@
765
765
  <li>Real CLI/provider quality, real product usefulness and owner acceptance have not been measured. These remain explicit rollout gates, rather than inferred from synthetic output.</li>
766
766
  </ul>
767
767
  <p><a href="index.html">Documentation library</a> · <a href="architecture.html">Development guide</a></p>
768
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/project-teams-implementation-plan.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="dynamic-teams-plan-review-0.html"><small>← Previous</small>Review 0: Dynamic teams implementation plan</a><a href="performance-results.html"><small>Next →</small>Measured performance: 19 October 2026</a></nav></main>
768
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/project-teams-implementation-plan.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="dynamic-teams-plan-review-0.html"><small>← Previous</small>Review 0: Dynamic teams implementation plan</a><a href="performance-results.html"><small>Next →</small>Measured performance: 19 October 2026</a></nav></main>
769
769
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#implementation-record">Implementation record</a><a class="depth-2" href="#1-product-behavior">1 Product behavior</a><a class="depth-3" href="#initial-defaults">Initial defaults</a><a class="depth-3" href="#first-release-boundary">First release boundary</a><a class="depth-2" href="#2-existing-foundations-and-required-extensions">2 Existing foundations and required extensions</a><a class="depth-3" href="#behaviors-that-cannot-be-reused-unchanged">Behaviors that cannot be reused unchanged</a><a class="depth-3" href="#provider-eligibility-on-the-current-baseline">Provider eligibility on the current baseline</a><a class="depth-2" href="#3-architecture-and-execution-ownership">3 Architecture and execution ownership</a><a class="depth-2" href="#4-data-model-and-persistence">4 Data model and persistence</a><a class="depth-3" href="#store-design">Store design</a><a class="depth-2" href="#5-scheduling-and-launch-recovery">5 Scheduling and launch recovery</a><a class="depth-3" href="#managed-trigger-contract">Managed trigger contract</a><a class="depth-3" href="#admission-and-advancement">Admission and advancement</a><a class="depth-3" href="#lifecycle-rules">Lifecycle rules</a><a class="depth-2" href="#6-discovery-and-opportunity-selection">6 Discovery and opportunity selection</a><a class="depth-3" href="#evidence-collection">Evidence collection</a><a class="depth-3" href="#auto-team-discovery-contract">Auto team discovery contract</a><a class="depth-3" href="#deduplication-and-ranking">Deduplication and ranking</a><a class="depth-2" href="#7-implementation-and-review">7 Implementation and review</a><a class="depth-3" href="#readiness-conditions">Readiness conditions</a><a class="depth-3" href="#owner-decisions-and-shipping">Owner decisions and shipping</a><a class="depth-2" href="#8-budgets-and-attention-limits">8 Budgets and attention limits</a><a class="depth-2" href="#9-memory-and-feedback">9 Memory and feedback</a><a class="depth-2" href="#10-api-and-user-interface">10 API and user interface</a><a class="depth-3" href="#notifications">Notifications</a><a class="depth-2" href="#11-delivery-phases">11 Delivery phases</a><a class="depth-3" href="#concrete-implementation-order">Concrete implementation order</a><a class="depth-2" href="#12-verification-strategy">12 Verification strategy</a><a class="depth-2" href="#13-pilot-and-rollout">13 Pilot and rollout</a><a class="depth-2" href="#14-acceptance-example">14 Acceptance example</a><a class="depth-2" href="#implementation-validation-record-19-october-2026">Implementation validation record (19 October 2026)</a></aside>
770
770
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
771
771
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -122,7 +122,7 @@
122
122
  <p>The initial synthetic ten-cycle pilot produced two ready drafts and eight no-ops across two fixture repositories. It establishes mechanics only. Real-provider quality, novelty, usefulness and owner acceptance have not been measured; keep the flag opt-in until that separate pilot is assessed.</p>
123
123
  <hr>
124
124
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="help.html">Ask code-flow</a></p>
125
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/project-teams.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="auto-team.html"><small>← Previous</small>Team</a><a href="review-inbox.html"><small>Next →</small>Review inbox</a></nav></main>
125
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/project-teams.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="auto-team.html"><small>← Previous</small>Team</a><a href="review-inbox.html"><small>Next →</small>Review inbox</a></nav></main>
126
126
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#start-with-a-bounded-preview">Start with a bounded preview</a><a class="depth-2" href="#reusable-agent-teams-and-project-assignments">Reusable agent teams and project assignments</a><a class="depth-2" href="#give-an-assigned-team-a-task">Give an assigned team a task</a><a class="depth-2" href="#create-a-mission">Create a mission</a><a class="depth-2" href="#what-a-cycle-does">What a cycle does</a><a class="depth-2" href="#review-and-feedback">Review and feedback</a><a class="depth-2" href="#recovery-and-storage">Recovery and storage</a><a class="depth-2" href="#api">API</a><a class="depth-2" href="#validation-and-rollout">Validation and rollout</a></aside>
127
127
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
128
128
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
@@ -13,7 +13,7 @@
13
13
  <p>Local acceptance on October 18, 2026 passed official Claude Code 2.1.300/2.1.302 and Codex 0.162.0/0.162.1 probes on macOS arm64, plus the official current Antigravity 1.4.2 binary in an isolated Linux arm64 musl Docker container. Exact receipts are in <a href="https://github.com/midhunxavier/code-flow/blob/main/docs/provider-compatibility-evidence.json">provider-compatibility-evidence.json</a>. Linux x64 CI execution remains a separate platform check.</p>
14
14
  <hr>
15
15
  <p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="help.html">Ask code-flow</a></p>
16
- </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/provider-compatibility.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="extensions.html"><small>← Previous</small>Provider and workflow extensions</a><a href="accessibility.html"><small>Next →</small>Accessibility acceptance</a></nav></main>
16
+ </article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/provider-compatibility.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.4 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="extensions.html"><small>← Previous</small>Provider and workflow extensions</a><a href="accessibility.html"><small>Next →</small>Accessibility acceptance</a></nav></main>
17
17
  <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#check-the-installed-cli">Check the installed CLI</a></aside>
18
18
  <aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
19
19
  <dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>