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

package/public/docs/releasing.html

@@ -18,15 +18,34 @@ npm run test:package
 <pre><code class="language-sh">npm pack ./dist/npm --dry-run
 node dist/npm/bin/codeflow.mjs --help
 </code></pre>
-<p>The <strong>Preview release</strong> GitHub workflow builds and tests the tarball on macOS and Linux, builds both macOS architectures, and creates a <strong>draft prerelease</strong> with the exact artifacts. It accepts an existing Git ref and checks that its version matches the requested tag. It does not publish npm or create a Homebrew tap. Run it against a committed, reviewed release ref.</p>
-<h2 id="npm-preview-channel">npm preview channel</h2>
+<p>The <strong>Preview release</strong> GitHub workflow builds and tests the tarball on macOS and Linux, builds both macOS architectures, and creates a <strong>draft prerelease</strong> with the exact artifacts. It accepts an existing Git ref and checks that its version matches the requested tag. Run it against a committed, reviewed release ref. Publishing that draft starts the separate <strong>Publish npm release</strong> workflow. Creating a draft alone does not publish npm or create a Homebrew tap.</p>
+<h2 id="automatic-npm-publishing">Automatic npm publishing</h2>
 <p>The published package is scoped as <code>@midhunxavier/code-flow</code> because npm rejected the unscoped name as too similar to the existing <code>codeflow</code> package. The installed commands remain <code>codeflow</code> and <code>code-flow</code>.</p>
-<p>Authenticate to the npm account that owns <code>@midhunxavier/code-flow</code>. On first publication, confirm the package name is available and that you are publishing from the intended account. Then publish the tested tarball:</p>
+<p>When a GitHub app release is published, <code>.github/workflows/npm-publish.yml</code> downloads its npm tarball and checksum, checks the package name and version against the release tag, and publishes those exact bytes. It updates <strong>both <code>latest</code> and <code>preview</code></strong> to the new version, so the unqualified npm install command also follows the current preview. It never rebuilds the package during publication.</p>
+<p>The publisher uses npm&#39;s <a href="https://docs.npmjs.com/trusted-publishers/">trusted publishing</a> with GitHub Actions OIDC. Configure this once in the npm package&#39;s <strong>Settings → Trusted Publisher</strong>:</p>
+<ul>
+<li>Provider: GitHub Actions</li>
+<li>Organization or user: <code>midhunxavier</code></li>
+<li>Repository: <code>code-flow</code></li>
+<li>Workflow filename: <code>npm-publish.yml</code></li>
+<li>Environment name: <code>npm</code></li>
+<li>Allowed actions: <strong>npm publish</strong> and <strong>npm dist-tag</strong></li>
+</ul>
+<p>The matching GitHub environment is <code>npm</code>. The workflow grants <code>id-token: write</code> only to the publishing job and pins npm 11.21.1, which supports OIDC for both publication and tag updates. No <code>NPM_TOKEN</code> secret or interactive login is needed for each release. Do not remove existing trusted publishers or weaken account 2FA when configuring this workflow.</p>
+<p>npm scans new uploads before they become installable. The job waits up to 20 minutes for the version, five more for the tarball, and five for tag visibility. It verifies the downloaded npm tarball against the GitHub artifact, then a separate job without publisher permissions checks fresh installs through both tags. Inspect both jobs before calling the npm release complete. The publisher disables build provenance generation because it uploads an existing artifact rather than building it.</p>
+<p>If a run fails or needs to be retried, run <strong>Publish npm release</strong> manually with the existing published tag:</p>
+<pre><code class="language-sh">gh workflow run npm-publish.yml -f tag=v0.1.0-preview.4
+</code></pre>
+<p>A retry checks an existing npm version&#39;s integrity before repairing its tags. It refuses different bytes for the same version and skips channel changes for older releases. Runs are serialized to prevent two releases racing to update tags. If npm is still scanning an accepted upload, wait and rerun; do not increment the version or replace the release tarball merely to retry.</p>
+<p>The automatic trigger requires a GitHub <code>release.published</code> event. Publishing the draft in GitHub&#39;s UI or with an authenticated maintainer&#39;s <code>gh release edit --draft=false</code> produces that event. If another Actions workflow publishes the draft using its <code>GITHUB_TOKEN</code>, GitHub suppresses follow-on release workflows; that workflow must explicitly dispatch <strong>Publish npm release</strong> instead.</p>
+<p>For an exceptional manual publication, authenticate as the package owner and publish the tested tarball, then update both channels:</p>
 <pre><code class="language-sh">npm whoami
-npm publish output/releases/midhunxavier-code-flow-0.1.0-preview.3.tgz --tag preview --access public
+npm publish output/releases/midhunxavier-code-flow-0.1.0-preview.4.tgz --tag preview --access public
+npm dist-tag add @midhunxavier/code-flow@0.1.0-preview.4 latest
+npm view @midhunxavier/code-flow@latest version
 npm view @midhunxavier/code-flow@preview version
 </code></pre>
-<p>Use the actual version&#39;s filename when publishing subsequent previews. Never publish this preview with the <code>latest</code> tag. The staged package also sets <code>publishConfig.tag</code> to <code>preview</code>. Test <code>npx @midhunxavier/code-flow@preview</code> from a clean directory after registry publication.</p>
+<p>Use the actual version and filename for subsequent releases. The packaged manifest defaults to <code>preview</code>; the release workflow explicitly moves both channels. Verify <code>npx @midhunxavier/code-flow@latest --version</code> and <code>npx @midhunxavier/code-flow@preview --version</code> from a clean directory after registry publication.</p>
 <h2 id="macos-dmg">macOS DMG</h2>
 <p>Build on macOS with Xcode Command Line Tools installed:</p>
 <pre><code class="language-sh">npm run package:macos -- arm64
@@ -55,11 +74,11 @@ codeflow --version
 </code></pre>
 <p>The tap must exist and contain the generated formula before advertising the Homebrew command as available. Regenerate the formula whenever the tarball changes; it references the GitHub release asset, so npm registry availability is independent.</p>
 <h2 id="publish-the-github-prerelease">Publish the GitHub prerelease</h2>
-<p>Review the draft notes and attached checksums. Verify each DMG&#39;s signing status and label it accurately. Publish the draft as a <strong>prerelease</strong>, leaving the stable latest release unchanged. The draft notes include an exact GitHub tarball command so the preview can be tried even before the npm channel is available.</p>
+<p>Review the draft notes and attached checksums. Verify each DMG&#39;s signing status and label it accurately. Publish the draft as a <strong>prerelease</strong>, leaving GitHub&#39;s stable latest release unchanged. This starts automatic npm publication and advances both npm tags after verification. The draft notes include an exact GitHub tarball command so the preview can be tried while npm processes the upload.</p>
 <p>Keep platform claims precise: macOS and Linux are supported; Windows users use WSL2. Native Windows execution is not supported. On a real Windows machine, confirm WSL networking and the Windows browser opener before claiming end-to-end Windows validation.</p>
 <p><a href="index.html">Documentation library</a> · <a href="installation.html">Installation</a></p>
-</article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/releasing.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="documentation.html"><small>← Previous</small>Documentation and GitHub Pages</a><a href="application-improvements.html"><small>Next →</small>Application improvement program</a></nav></main>
-<aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#build-and-validate">Build and validate</a><a class="depth-2" href="#npm-preview-channel">npm preview channel</a><a class="depth-2" href="#macos-dmg">macOS DMG</a><a class="depth-3" href="#desktop-updates">Desktop updates</a><a class="depth-2" href="#homebrew">Homebrew</a><a class="depth-2" href="#publish-the-github-prerelease">Publish the GitHub prerelease</a></aside>
+</article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/releasing.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="documentation.html"><small>← Previous</small>Documentation and GitHub Pages</a><a href="application-improvements.html"><small>Next →</small>Application improvement program</a></nav></main>
+<aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#build-and-validate">Build and validate</a><a class="depth-2" href="#automatic-npm-publishing">Automatic npm publishing</a><a class="depth-2" href="#macos-dmg">macOS DMG</a><a class="depth-3" href="#desktop-updates">Desktop updates</a><a class="depth-2" href="#homebrew">Homebrew</a><a class="depth-2" href="#publish-the-github-prerelease">Publish the GitHub prerelease</a></aside>
 <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>
 <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>
 </body></html>

package/public/docs/remote-workers.html

@@ -57,7 +57,7 @@
 <p>An additional opt-in acceptance test passed over real encrypted loopback OpenSSH: a temporary unprivileged daemon bound to 127.0.0.1, temporary host/client keys and isolated ssh -F configuration, the bundled worker process, a fake CLI, exact source transfer, result import and receipt recovery. Run it with <code>CODEFLOW_TEST_LOOPBACK_SSH=1 npx tsx --test test/remote-workers-ssh.test.ts</code>. It never modifies user SSH configuration or system settings, and reports a skip if unprivileged sshd is unavailable. No external SSH host or live provider login was tested. Validate those on an explicitly configured host before relying on unattended work. Container inventory uses an injected Docker fixture; an actual Docker worker image was not exercised in this acceptance run.</p>
 <hr>
 <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>
-</article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/remote-workers.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="ssh-projects.html"><small>← Previous</small>SSH projects</a><a href="code-hosts.html"><small>Next →</small>GitLab and Bitbucket code workflows</a></nav></main>
+</article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/remote-workers.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="ssh-projects.html"><small>← Previous</small>SSH projects</a><a href="code-hosts.html"><small>Next →</small>GitLab and Bitbucket code workflows</a></nav></main>
 <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#choose-an-execution-target">Choose an execution target</a><a class="depth-2" href="#provision-a-worker">Provision a worker</a><a class="depth-2" href="#exact-source-and-returned-changes">Exact source and returned changes</a><a class="depth-2" href="#receipts-cancellation-and-ambiguous-outcomes">Receipts, cancellation and ambiguous outcomes</a><a class="depth-2" href="#worker-local-containers-and-boundaries">Worker-local containers and boundaries</a><a class="depth-2" href="#validation-status">Validation status</a></aside>
 <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>
 <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>

package/public/docs/review-inbox.html

@@ -19,7 +19,7 @@ by sorting, filtering or opening this page. Grouping is a presentation choice an
 does not change dispatch order; the explicit run priority controls dispatch too.</p>
 <hr>
 <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>
-</article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/review-inbox.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.html"><small>← Previous</small>Project missions (preview)</a><a href="verification.html"><small>Next →</small>Verification and review</a></nav></main>
+</article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/review-inbox.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.html"><small>← Previous</small>Project missions (preview)</a><a href="verification.html"><small>Next →</small>Verification and review</a></nav></main>
 <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#work-through-attention-items">Work through attention items</a></aside>
 <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>
 <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>

package/public/docs/run-storage.html

@@ -16,7 +16,7 @@
 <p>This bounds retained full archived metadata and recovery batches. The compact index still grows with the number of recorded runs, and active/resumable runs remain in memory deliberately. The current UI reads bounded transcript pages directly by byte offset. Legacy stream clients and full exports can still request complete event history. Search uses an in-memory index, not a database. See <a href="performance.html">Performance and resource boundaries</a> for limits, diagnostics and benchmarks.</p>
 <hr>
 <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>
-</article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/run-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="performance.html"><small>← Previous</small>Performance</a><a href="documentation.html"><small>Next →</small>Documentation and GitHub Pages</a></nav></main>
+</article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/run-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="performance.html"><small>← Previous</small>Performance</a><a href="documentation.html"><small>Next →</small>Documentation and GitHub Pages</a></nav></main>
 <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#understand-archived-history">Understand archived history</a></aside>
 <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>
 <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>

package/public/docs/runs.html

@@ -134,7 +134,7 @@
 </ul>
 <hr>
 <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>
-</article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/runs.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="help.html"><small>← Previous</small>Ask code-flow</a><a href="auto-team.html"><small>Next →</small>Team</a></nav></main>
+</article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/runs.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="help.html"><small>← Previous</small>Ask code-flow</a><a href="auto-team.html"><small>Next →</small>Team</a></nav></main>
 <aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#the-run-view">The run view</a><a class="depth-2" href="#recovering-work">Recovering work</a><a class="depth-2" href="#talking-to-a-run">Talking to a run</a><a class="depth-3" href="#a-single-agent">A single agent</a><a class="depth-2" href="#projects">Projects</a><a class="depth-2" href="#the-side-panel">The side panel</a><a class="depth-2" href="#runs-survive-restarts">Runs survive restarts</a><a class="depth-2" href="#insights-comparisons-and-finding-runs">Insights, comparisons and finding runs</a></aside>
 <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>
 <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>