vibe64 0.1.32 → 0.1.34

package/dist/index.html

@@ -21,69 +21,72 @@
       }, true);
     </script>
     <style>#startup-shell{color:#25232a;background:#faf9fc;grid-template-rows:56px 1fr;font:15px system-ui,sans-serif;display:grid;position:fixed;inset:0}#startup-shell header{border-bottom:1px solid #dedce3;align-items:center;padding:0 24px;font-weight:600;display:flex}#startup-shell main{grid-template-columns:240px 1fr;min-height:0;display:grid}#startup-shell aside{border-right:1px solid #dedce3;padding:24px}#startup-shell .startup-placeholder{background:#e5e2eb;border-radius:4px;height:16px;margin-bottom:20px}#startup-shell section{padding:32px}#startup-shell a{min-height:48px;color:inherit;align-items:center;display:inline-flex}@media (width<=600px){#startup-shell main{grid-template-columns:1fr}#startup-shell aside{display:none}}@media (prefers-color-scheme:dark){#startup-shell{color:#eeeaf3;background:#19181d}#startup-shell header,#startup-shell aside{border-color:#3c3942}#startup-shell .startup-placeholder{background:#35323d}}</style>
-    <script type="module" crossorigin src="/assets/index-5sKwLHOH.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/runtime-core.esm-bundler-DMrccYS5.js">
-    <link rel="modulepreload" crossorigin href="/assets/VAvatar-CAFvgSUo.js">
+    <script type="module" crossorigin src="/assets/index-BUq-MczL.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/runtime-core.esm-bundler-DGXg_mpN.js">
+    <link rel="modulepreload" crossorigin href="/assets/ripple-BVltMmyV.js">
     <link rel="modulepreload" crossorigin href="/assets/normalize-CO2KHj_d.js">
-    <link rel="modulepreload" crossorigin href="/assets/error-DE4zo8Lk.js">
+    <link rel="modulepreload" crossorigin href="/assets/error-Dug56can.js">
     <link rel="modulepreload" crossorigin href="/assets/deepFreeze-BgoYkoTa.js">
-    <link rel="modulepreload" crossorigin href="/assets/httpClient-BaaZuFvF.js">
-    <link rel="modulepreload" crossorigin href="/assets/useEndpointResource-C2KD4Ub_.js">
-    <link rel="modulepreload" crossorigin href="/assets/useApi-BPuI6ZR9-Dr8wK_Co.js">
+    <link rel="modulepreload" crossorigin href="/assets/vibe64ProjectScope.local-DqT6e5un.js">
+    <link rel="modulepreload" crossorigin href="/assets/useEndpointResource-MWVNfmMa.js">
+    <link rel="modulepreload" crossorigin href="/assets/useApi-BPuI6ZR9-CFWU1m37.js">
     <link rel="modulepreload" crossorigin href="/assets/surface-DY1u73tB.js">
-    <link rel="modulepreload" crossorigin href="/assets/placement-JxzrmUR3.js">
+    <link rel="modulepreload" crossorigin href="/assets/placement-CwTqWLQH.js">
     <link rel="modulepreload" crossorigin href="/assets/preload-helper-BvdcsxN9.js">
-    <link rel="modulepreload" crossorigin href="/assets/display-BLmcO-5p.js">
-    <link rel="modulepreload" crossorigin href="/assets/lazy-CvQfXeLg.js">
-    <link rel="modulepreload" crossorigin href="/assets/VOverlay-BvFVZKNS.js">
-    <link rel="modulepreload" crossorigin href="/assets/createSimpleFunctional-DPIT6zsT.js">
-    <link rel="modulepreload" crossorigin href="/assets/VChip-Dfs5jX0f.js">
-    <link rel="modulepreload" crossorigin href="/assets/VTextField-CA_p3N4d.js">
-    <link rel="modulepreload" crossorigin href="/assets/VDivider-DFsS0OTx.js">
-    <link rel="modulepreload" crossorigin href="/assets/VMenu-BLxobsuU.js">
-    <link rel="modulepreload" crossorigin href="/assets/VSheet-BA95RNmA.js">
-    <link rel="modulepreload" crossorigin href="/assets/VSelect-DY-ZuBJJ.js">
-    <link rel="modulepreload" crossorigin href="/assets/layout-YCn17mK1.js">
-    <link rel="modulepreload" crossorigin href="/assets/vibe64AssistantHost-Dgyz4TrT.js">
-    <link rel="modulepreload" crossorigin href="/assets/vibe64ProjectScope.local-GOSMVDRi.js">
-    <link rel="modulepreload" crossorigin href="/assets/mdi-C31_SZp-.js">
-    <link rel="modulepreload" crossorigin href="/assets/VBtn-Kl_qcBsy.js">
-    <link rel="modulepreload" crossorigin href="/assets/VAlert-B7ciJKQL.js">
-    <link rel="modulepreload" crossorigin href="/assets/VAutocomplete-QjMk5d_j.js">
-    <link rel="modulepreload" crossorigin href="/assets/VCheckbox-DTRAWOIf.js">
-    <link rel="modulepreload" crossorigin href="/assets/VDialog-Dt1VjJg1.js">
-    <link rel="modulepreload" crossorigin href="/assets/VCard-nrJPeo91.js">
-    <link rel="modulepreload" crossorigin href="/assets/VRow-BR2RMCM1.js">
-    <link rel="modulepreload" crossorigin href="/assets/VSpacer-B1l1hVvU.js">
-    <link rel="modulepreload" crossorigin href="/assets/VExpansionPanels-CYKU0cAr.js">
-    <link rel="modulepreload" crossorigin href="/assets/VSkeletonLoader-hpJqr0HL.js">
-    <link rel="modulepreload" crossorigin href="/assets/VSwitch-Bm1bwl2V.js">
+    <link rel="modulepreload" crossorigin href="/assets/VAvatar-DPzqDH4r.js">
+    <link rel="modulepreload" crossorigin href="/assets/lazy-NHSwD9FS.js">
+    <link rel="modulepreload" crossorigin href="/assets/VOverlay-CeMZurIN.js">
+    <link rel="modulepreload" crossorigin href="/assets/createSimpleFunctional-CZTGuNuR.js">
+    <link rel="modulepreload" crossorigin href="/assets/ssrBoot-Rlh6kLbD.js">
+    <link rel="modulepreload" crossorigin href="/assets/VDivider-BMEqUoAB.js">
+    <link rel="modulepreload" crossorigin href="/assets/VMenu-C_x18lwb.js">
+    <link rel="modulepreload" crossorigin href="/assets/VChip-CcI-Oo2J.js">
+    <link rel="modulepreload" crossorigin href="/assets/VTextField-BR2eZeFT.js">
+    <link rel="modulepreload" crossorigin href="/assets/VSheet-DZWsu0kL.js">
+    <link rel="modulepreload" crossorigin href="/assets/VSelect-DL3HaA5m.js">
+    <link rel="modulepreload" crossorigin href="/assets/layout-BkWVNT37.js">
+    <link rel="modulepreload" crossorigin href="/assets/vibe64AssistantHost-DdE_-lZF.js">
+    <link rel="modulepreload" crossorigin href="/assets/mdi-C54lQ0i_.js">
+    <link rel="modulepreload" crossorigin href="/assets/VBtn-B2MBK2DL.js">
+    <link rel="modulepreload" crossorigin href="/assets/VAlert-P256xaE0.js">
+    <link rel="modulepreload" crossorigin href="/assets/VAutocomplete-BDb95qJX.js">
+    <link rel="modulepreload" crossorigin href="/assets/VCheckbox-C7A1ZW4D.js">
+    <link rel="modulepreload" crossorigin href="/assets/VDialog-Bu3EfKb1.js">
+    <link rel="modulepreload" crossorigin href="/assets/VCard-mXy0k4aS.js">
+    <link rel="modulepreload" crossorigin href="/assets/VRow-Cpw7OHQV.js">
+    <link rel="modulepreload" crossorigin href="/assets/VSpacer-Dhmsvk4t.js">
+    <link rel="modulepreload" crossorigin href="/assets/VExpansionPanels-Dgjrop0V.js">
+    <link rel="modulepreload" crossorigin href="/assets/VSkeletonLoader-CttxM1tw.js">
+    <link rel="modulepreload" crossorigin href="/assets/VSwitch-BRHeDJkH.js">
     <link rel="modulepreload" crossorigin href="/assets/_plugin-vue_export-helper-DNW4j-dv.js">
-    <link rel="modulepreload" crossorigin href="/assets/StudioErrorNotice-Ccjvcn9C.js">
+    <link rel="modulepreload" crossorigin href="/assets/StudioErrorNotice-sQfmeR-z.js">
     <link rel="modulepreload" crossorigin href="/assets/browserLocalStorage-B4C7rHrs.js">
     <link rel="modulepreload" crossorigin href="/assets/clipboard-CZs9aH3L.js">
-    <link rel="modulepreload" crossorigin href="/assets/useVibe64Terminal-C2XJ9Y1K.js">
+    <link rel="modulepreload" crossorigin href="/assets/useVibe64Terminal-BPnN25WH.js">
     <link rel="modulepreload" crossorigin href="/assets/shared-YZb7ocaK.js">
-    <link rel="modulepreload" crossorigin href="/assets/assistantRouting-TDtryU6o.js">
+    <link rel="modulepreload" crossorigin href="/assets/assistantRouting-CwbwfkwB.js">
     <link rel="modulepreload" crossorigin href="/assets/pathname-Bb895US8.js">
-    <link rel="modulepreload" crossorigin href="/assets/usePaths-DVTieF_G.js">
-    <link rel="modulepreload" crossorigin href="/assets/useUiFeedback-Tzi-PRlX.js">
-    <link rel="modulepreload" crossorigin href="/assets/useCommand-BzThFLYP.js">
-    <link rel="modulepreload" crossorigin href="/assets/studioUrls-CIab-Axb.js">
+    <link rel="modulepreload" crossorigin href="/assets/usePaths-Db88-HOm.js">
+    <link rel="modulepreload" crossorigin href="/assets/useUiFeedback-0FqKuZRP.js">
+    <link rel="modulepreload" crossorigin href="/assets/useCommand-DWuxfAV0.js">
+    <link rel="modulepreload" crossorigin href="/assets/studioUrls-Dj8rXeXO.js">
     <link rel="modulepreload" crossorigin href="/assets/shared-BEwrtWSp.js">
     <link rel="modulepreload" crossorigin href="/assets/vibe64ApiResponses-DNLY1Kel.js">
-    <link rel="modulepreload" crossorigin href="/assets/client-C-tpoG6F.js">
-    <link rel="modulepreload" crossorigin href="/assets/VTextarea-NyCqY4h5.js">
+    <link rel="modulepreload" crossorigin href="/assets/client-BrV4QPwG.js">
+    <link rel="modulepreload" crossorigin href="/assets/VTextarea-DbqamXJd.js">
     <link rel="modulepreload" crossorigin href="/assets/thinkingText-DewCOEcu.js">
+    <link rel="modulepreload" crossorigin href="/assets/useVibe64ProjectScope-DOEVkBqX.js">
     <link rel="modulepreload" crossorigin href="/assets/vibe64BrowserTabOrigin-SF9E31vi.js">
-    <link rel="modulepreload" crossorigin href="/assets/useVibe64DatabaseTools-DBcKhm6B.js">
-    <link rel="modulepreload" crossorigin href="/assets/useVibe64SystemGraph-DeTPBn0e.js">
-    <link rel="stylesheet" crossorigin href="/assets/VAvatar-nHaK192T.css">
+    <link rel="modulepreload" crossorigin href="/assets/useVibe64DatabaseTools-BcRG1s3i.js">
+    <link rel="modulepreload" crossorigin href="/assets/vibe64LessonDashboard-DlKYjisq.js">
+    <link rel="modulepreload" crossorigin href="/assets/useVibe64SystemGraph-tNkIwSBQ.js">
+    <link rel="stylesheet" crossorigin href="/assets/ripple-DqhAt1Ze.css">
+    <link rel="stylesheet" crossorigin href="/assets/VAvatar-9ilDR2r2.css">
     <link rel="stylesheet" crossorigin href="/assets/VOverlay-DG-PukqI.css">
-    <link rel="stylesheet" crossorigin href="/assets/VChip-PprDbmQn.css">
-    <link rel="stylesheet" crossorigin href="/assets/VTextField-BiatYyd3.css">
     <link rel="stylesheet" crossorigin href="/assets/VDivider-DvkP_iX7.css">
     <link rel="stylesheet" crossorigin href="/assets/VMenu-D_W8zRGm.css">
+    <link rel="stylesheet" crossorigin href="/assets/VChip-PprDbmQn.css">
+    <link rel="stylesheet" crossorigin href="/assets/VTextField-BiatYyd3.css">
     <link rel="stylesheet" crossorigin href="/assets/VSheet-BbLSwuzR.css">
     <link rel="stylesheet" crossorigin href="/assets/VSelect-y7fezdfU.css">
     <link rel="stylesheet" crossorigin href="/assets/VBtn-uSpaN2Ha.css">
@@ -101,7 +104,7 @@
     <link rel="stylesheet" crossorigin href="/assets/useVibe64Terminal-Bk2QOSDO.css">
     <link rel="stylesheet" crossorigin href="/assets/client-C1bwIlu6.css">
     <link rel="stylesheet" crossorigin href="/assets/VTextarea-DDl63AeD.css">
-    <link rel="stylesheet" crossorigin href="/assets/index-D4MsP3dq.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-DtmBqE3h.css">
   </head>
   <body>
     <div id="app">

package/docs/colleague-usage/account-profile-and-appearance.md

@@ -0,0 +1,29 @@
+# Your name and the light or dark appearance
+
+Open **Account settings** with the person-and-gear button at the right of the
+app header, then choose the **You** tab. The dialog is the same in Working and
+Learning.
+
+## Your name
+
+Under **Your profile** (You — all projects), type a name in **What should
+Vibe64 call you?** and choose **Save name**, or press Enter. Vibe64 uses it in
+welcomes and collaboration cues across this installation. Leave the field
+blank and save to use your computer account name instead. A name is at most 80
+characters; a longer one shows "Name cannot exceed 80 characters." and **Save
+name** stays disabled.
+
+## Appearance
+
+Under **Appearance** (This browser), choose **Light**, **Dark** or **System**.
+The whole app switches immediately, including Learning's warm header and the
+teacher's tutor cards. **System** follows your device's light or dark setting
+and changes when the device does. Light is the default.
+
+The choice is saved in this browser only. Another browser, another device or a
+private window starts in Light until you choose again; clearing site data also
+resets it. It does not change the appearance of the app shown inside
+**Preview**, which belongs to the project.
+
+Colleague can explain these steps but cannot change your name or appearance for
+you: they are your own choices in the dialog.

package/docs/colleague-usage/ai-accounts-and-routing.md

@@ -20,8 +20,8 @@ unverified; an invitation to try the app does not replace verification.
 Auto shows Working, Waiting or Complete with a separate Planning, Implementation
 or Review stage. Senior continues unfinished review or saves necessary in-scope
 rework for Junior, then reviews again. Deslop controls cleanup, not whether review
-runs. Waiting retains the stage: use **Resume workflow** when the blocker is
-resolved, or **Check delivery** for an uncertain message. Stop remains respected.
+runs. Waiting retains the stage: use its stage-specific **Continue** action when the blocker is
+resolved, or **Retry** for an uncertain message. Stop remains respected.
 See [plans and workflow recovery](plans.md) for the full steps.
 
 Open **AI Accounts** in Management. No project or coding session is required.
@@ -62,6 +62,14 @@ OpenCode may require you to close its native terminals, other-provider chats and
 Colleague conversations before changing a key. If it refuses, the saved key stays
 unchanged and those conversations keep running; close the named users and retry. Saved routing can still name a disconnected
 provider; reconnect the exact row or deliberately choose a different route.
+**Start an AI session** lists only orchestrators you can use: one whose account
+was removed disappears until you connect it again, while its saved routing is
+kept. A connected orchestrator with a routing problem stays visible but greyed
+out with its reason; fix it with **Configure model routing**. An existing chat
+whose orchestrator is no longer connected shows **Open AI Accounts** and, when
+another orchestrator is available, **Switch to** that orchestrator (for example
+**Switch to Claude Code**). Switching keeps the chat's Senior, Junior or Auto
+mode (Custom becomes Senior), turns automatic review off, and keeps your draft.
 The controls and results are the same on desktop and mobile. Colleague can
 inspect redacted readiness and explain these steps; secret entry and connection
 consent remain your interaction in **AI Accounts**.
@@ -73,8 +81,12 @@ If Claude reports that another process is refreshing its OAuth token, wait a
 minute before retrying. If the error persists, ask the workspace operator to
 check the managed Claude version and refresh-lock recovery. This error alone
 does not prove that you signed out or need to replace your credentials.
-If an existing Claude conversation reports that its account changed, reconnect
-the original Claude account or start a new session. Replacing a saved, authorized
+Changing the workspace's Claude account stops its existing Claude processes.
+Main chats keep their history and resume with the newly connected account; they
+do not require access to the previous account. Model selection in **Chat mode**
+also uses the current workspace connection. If the old process cannot be stopped,
+resolve the reported stop failure before retrying; a replacement cannot start
+until shutdown is confirmed. Replacing a saved, authorized
 external-provider API key does not require a new Claude conversation. Its next
 message uses the updated connection; you do not need to close and reopen the chat.
 If a background Codex task reports that its selected account changed, its answer
@@ -111,6 +123,13 @@ The displayed routing form can also offer **Review recommendations**,
 required review, then Save routing. On mobile, scroll the same dialog to its controls.
 Disabled models are unavailable or incompatible; they must not be invented.
 
+The workflow picker checks access to your saved Senior, Junior and shared backup
+choices. It offers recommendations for roles that have not been configured;
+opening the picker does not replace saved choices or deliberately empty roles.
+First-time setup loads models for the chosen workflow and any other orchestrator
+already assigned to one of its roles. Choosing Codex or Claude Code does not
+require OpenCode model discovery unless one of those saved roles uses OpenCode.
+
 Recommendations prefer **Claude → Codex/OpenAI → DeepSeek → GLM** among models
 connected and permitted for each role. Within the chosen provider, Senior uses
 Opus/Astra, Junior uses Sonnet/Sol, and Helper/Router use Haiku/Luna when offered.

package/docs/colleague-usage/ai-balance-and-allowance.md

@@ -34,6 +34,10 @@ cost of the current turn or a separate per-key budget. Other usage and delayed
 provider accounting can make the snapshot differ from the provider's current
 value.
 
+Reset and checked times use your browser's locale and local time zone, including
+Claude and Codex allowances. Dates include a month name, for example
+**16 Oct 2026, 6:40 am** in Australian English, to avoid ambiguous numeric dates.
+
 If no value appears, a reading may not be available yet, the provider may have
 failed to answer, or the connection may not support balance checks. This does
 not mean the balance is zero. Continue using the chat normally; the next turn

package/docs/colleague-usage/architecture-explanations.md

@@ -0,0 +1,99 @@
+# Where Architecture explanations come from
+
+Architecture displays project documentation, analysed source facts and optional
+Helper interpretations. They have different owners and update rules.
+
+| What you read | Who creates it | Owner and storage | How it changes |
+| --- | --- | --- | --- |
+| Subsystem explanation | A coding agent following Genesis guidance, with human review | Genesis project documentation: the responsibility prose in `genesis/subsystems.md` | An explicit documentation/adoption task reconciles it with the source and current directory boundaries. |
+| Program explanation | A coding agent following Genesis guidance, with human review | Genesis project documentation under `genesis/program/`; the subsystem map assigns each Program exactly once | An explicit Program task updates the purpose, contract, main source and supporting sources together. |
+| File Explanation | The configured Helper, when the person requests it | Vibe64 source-editor informational cache in private runtime state | **Generate explanation** creates it; **Update explanation** refreshes it. |
+| Function Pseudocode | The configured Helper, when the person requests it | The same Vibe64 cache, tied to the exact indexed declaration | **Generate pseudocode** or **Update pseudocode** reads the saved declaration and fills the field. |
+| Signatures, imports and ownership links | Genesis's source index and selected language/framework/package analysers | Derived index facts, including the replaceable `.genesis/` snapshots | **Architecture options → Re-scan project** recomputes facts. It does not ask an AI to write explanations. |
+
+Interface group definitions are shared UI guidance, not generated explanations
+or findings about a particular subsystem. **Declared API** means explicit package
+or module exports, including declarations with no observed consumers. **Imported
+by other subsystems** identifies the particular declarations evidenced across a
+directory boundary. **Exports from externally used files** have file-level boundary evidence
+without proven imports of those individual exports. **Other available exports**
+follow the language's visibility rules without deciding intended API membership.
+Expand an import count beneath a signature to see the importing source paths;
+select a path to read it and use Back to return. File-level candidates label their
+evidence **Source file imported by** to avoid claiming a particular export is used.
+Hover the group title for its definition; the Partial badge and File exports heading
+carry their coverage explanation on hover. **Analysis details** shows actual
+diagnostics and coverage limits; unknown return information is omitted.
+
+## Subsystems and Programs
+
+A subsystem owns one project-relative directory. A more specific nested owner
+owns its files. Its responsibility is a substantive explanation of purpose,
+scope, important parts and cooperation with other owners. The circle uses a
+shortened display; the square shows the authored text. Shortening a display does
+not replace the stored explanation.
+
+Choosing the subsystems is a design judgment by the person and coding agent,
+guided by source evidence and Genesis's authoring instructions. They explicitly
+record each id, name, responsibility and directory in the canonical map. Stack
+directory-parent rules are adoption hints, not an alternative catalogue.
+
+File membership is then computed by Genesis's index: the most specific declared
+directory containing the file is its owner. The parent owns the remaining files.
+Every indexed source must be covered, including unsupported languages and support
+files; a project-root owner can cover the remainder. Vibe64 does not infer ownership
+from imports, file names, UI participation or the layout of circles.
+
+A Program explains a meaningful capability. It has one subsystem owner and one
+explicitly designated main source in that owner's directory. Supporting files
+can include another subsystem's libraries and can participate in several Programs.
+Program document folders and source-list order never decide ownership or the main
+file. Sources are a useful implementation map rather than every incidental helper.
+
+Select a Program in the subsystem to read its dedicated Architecture view.
+Its opening preview stays short; **Read full explanation** opens the complete
+authored text in a separate scrollable dialog, full-screen on phones. **×** or Esc
+closes that dialog without going back or changing the source list.
+**Main source file** opens the anchor through the shared Files viewer/editor.
+**Supporting files** reaches the associated source icons. **← Back**, **×** and
+Esc return through Program and source navigation. File membership links return
+to the Program view. These controls never open raw Genesis documentation files.
+
+Genesis supplies the grammar, prompts, validation and common facts. It does not
+run an AI to author these explanations. The coding agent performs that work in
+the project's ordinary source changes; the person can review and correct them
+before saving. A regenerated map must reconcile responsibilities, memberships
+and required main sources against the new directory owners. Architecture reads
+the resulting canonical list without another catalogue or hardcoded owner names.
+
+Documentation is fallible. A valid source citation or main anchor proves that the
+declared location exists and has the required owner; it does not prove the prose
+is up to date. Source changes do not silently rewrite authored responsibilities
+or Program contracts. Request a focused reconciliation when behavior or boundaries
+change, then re-scan to load the updated facts.
+
+## File and function interpretations
+
+Opening a file, signature, subsystem or Program starts no explanation query.
+The source-editor service admits an explicit request using current project/session
+access, saved source and the configured Helper. A file request asks for scope,
+responsibilities and behavior. An indexed callable request asks for practical
+inputs, returned data or operations, and ordered pseudocode. It does not impose
+function input/output sections on a file overview.
+
+Saved interpretations are isolated by project/source, session and account scope.
+Generation reuse checks source identity, range/declaration, presentation, guidance
+revision and Helper execution profile. The fields compare saved source and guidance
+with their records and mark changed results **Out of date**. Old text stays readable;
+an explicit Update regenerates it. Merely reading a cached field makes no request.
+Progress, Stop and failures belong to that one requested field.
+
+These results are informational. They do not modify Genesis documents, declare an
+intended API or enter the coding agent's context. Files and Architecture share the
+same viewer, editor, save/conflict coordination and explanation service. Architecture
+hides the file browser while reading a selected source; Files keeps full browsing.
+
+Colleague can explain these controls and offer to delegate a documentation task
+through its supported assignment actions. It does not acquire source-code access
+from this guide. A coding agent needs the actual source and project guidance;
+the person's accepted delegation remains required.

package/docs/colleague-usage/auto-workflow.md

@@ -37,8 +37,8 @@ The working agent reports one of four outcomes:
 The agent's concrete explanation appears as an ordinary **Status** message in
 chat. It is evidence of the reported work, not independent verification.
 Auto waits after two consecutive turns without reported progress or eight
-automatic steps. Inspect the reason and select **Resume workflow** to continue
-with a fresh allowance. This does not grant permission to change the product scope.
+automatic steps. Inspect the reason and select **Continue planning**, **Continue implementation**, or **Continue review**,
+matching the waiting stage, to continue with a fresh allowance. This does not grant permission to change the product scope.
 
 If implementation is blocked on a requirement you want to defer, say so explicitly
 in **Auto**: for example, “Exclude actual email delivery from this implementation.
@@ -65,15 +65,15 @@ the existing chat action; an explanation or offer alone does not authorise it.
 
 The composer's **Stop** pauses the current workflow and interrupts active work
 or request preparation. Auto retains the stage, plan and completed changes.
-A late successful result cannot undo Stop. Select **Resume workflow** when ready;
-this starts a fresh turn at the retained stage. A failed or interrupted turn, or
+A late successful result cannot undo Stop. Select the stage-specific **Continue** action when ready;
+this starts a fresh turn at that stage. A failed or interrupted turn, or
 one ending without a confirmed outcome, leaves **Waiting** with a concrete reason.
 
-After a server restart, unfinished scheduling requires explicit **Resume workflow**;
-opening a session never sends another turn. **Check delivery** checks the original
+After a server restart, unfinished scheduling requires an explicit stage-specific **Continue** action;
+opening a session never sends another turn. **Retry** checks the original
 receipt of an uncertain message without sending a second copy. If the plan or
 conversation changed before an unsent handoff, stop it and send a fresh request.
-An unsent handoff shows **Stop** beside **Resume workflow**. Stopping it preserves
+An unsent handoff shows **Stop** beside its stage-specific **Continue** action. Stopping it preserves
 history and file changes, and lets you send a new request. A delivery check remains
 necessary for an uncertain attempt; stopping does not prove it was never delivered.
 
@@ -89,19 +89,57 @@ behavior-preserving cleanup to Senior review; turning it off does not disable
 review. Unfinished checks continue in Senior review; substantial necessary rework
 returns to Junior and comes back for another review. A changed product requirement
 needs your decision. Planning-only work waits for your request to implement it.
+
+Waiting workflow controls show only the available actions above the composer.
+In chat history, select **Workflow details** to expand a saved outcome and its
+reason; select it again to collapse it. Restored outcomes are also collapsed.
+A separate delivery or cleanup error retains its own **Details** and recovery
+actions until resolved. Clicking a workflow action immediately shows **Starting…**,
+**Continuing…**, or **Checking…** on that button while it is submitted. Other
+workflow submissions are disabled until it settles. **Continue planning**,
+**Continue implementation**, and **Continue review** act on the saved workflow
+without resending its original chat message. **Check delivery** inspects the saved
+attempt without starting another copy. If a control cannot start or the saved
+plan has changed, its error appears beside the controls; inspect the current
+state before trying again. **Implement plan** still sends a new request, and
+shows a refusal beside the controls if that request cannot start.
+
+When Auto is waiting at Planning with an active saved plan, the notice offers
+**Implement plan**, **View plan** and **Stop**. These are
+specific alternatives, not a generic “resume” command. **View plan** opens the
+existing Current plan dialog without sending anything. To revise the saved plan,
+send the requested changes through the composer. **Implement plan** sends
+a new human request authorizing implementation within the saved plan's scope;
+it starts Junior implementation, followed by the normal Senior review. Your
+composer draft and attachments remain untouched. The button cannot reinterpret
+the original planning request or become another automatic planning continuation.
+
+Planning, implementation, review and delivery-recovery notices use a compact
+layout. The summary and actions share a row when space permits and wrap on narrow
+screens. **Details** expands the full explanation; touch controls remain easy to tap.
+
+Without an active saved plan, paused Planning offers **Continue planning**.
+Only the relevant stage's continuation appears: paused Implementation offers
+**Continue implementation** and paused Review offers **Continue review**. An
+uncertain delivery offers **Check delivery** instead; it does not offer implementation.
+If the selected plan changed or is no longer active, implementation is refused:
+open **View plan**, inspect the current document, and send your intended request
+in chat. No plan is silently reopened. These controls behave the same on desktop
+and mobile. Colleague can explain them or offer to send your explicit request
+through its existing chat action; an explanation alone starts no work.
 Direct Senior, Junior and Custom keep their direct behavior without automatic
 continuation or review. Junior cannot mark a plan completed.
 
 Executing the current plan requires it to be Active. A missing or Completed plan
 is explained without reviving an old task. Independent work does not need a plan.
-Junior can update Progress; only Senior can manage its lifecycle and
+Junior updates Progress and existing checklist ticks as work is verified; only Senior can manage the plan’s lifecycle and
 explicitly mark it Completed after verifying the evidence.
 
 If an automatic handoff failed before its message was sent, you can type a new
 request and use the ordinary **Send** button (or speak a new request). Sending
 replaces that failed, unsent handoff; it does not mark its review completed.
-The previous coding history, plan and file changes remain. **Resume workflow** still
-resumes the retained stage, and **Stop** cancels it without sending new work.
-A handoff with unconfirmed delivery still requires **Check delivery** first.
+The previous coding history, plan and file changes remain. The stage-specific **Continue** action still
+continues the retained stage, and **Stop** cancels it without sending new work.
+A handoff with unconfirmed delivery still requires **Retry** first.
 Colleague can explain these choices and offer to help you continue; sending new
 work requires your direct request or accepted offer.

package/docs/colleague-usage/coding-agent-failures.md

@@ -0,0 +1,94 @@
+# When a coding agent fails or stops
+
+For sending, steering and stopping, see [Direct coding agents and follow assignments](coding-agents.md). This topic covers what to do when an assistant cannot start, stops on its own or reports a failure.
+
+If Claude cannot initialize, inspect the failed request before selecting **Retry**.
+An initialization failure occurs before that request reaches Claude; it does not
+complete the requested work. Vibe64 keeps a bounded, credential-redacted startup
+diagnostic in its private operational log before confirmed process cleanup. The
+request stays in chat for review; use **Retry** to recover its delivery.
+Colleague cannot read that log.
+
+If an assistant stops because its credits or quota are exhausted, open **Chat
+mode** and choose another connected **Orchestrator**, or choose **Custom** and a
+permitted model. A pending automatic continuation or review does not prevent
+this change: Vibe64 cancels its old scheduling and waits for routing-helper
+cleanup before switching. During an active turn, the new settings are saved for
+the next turn. An unfinished goal keeps its orchestrator; another orchestrator
+is saved for after that goal finishes. A reported cleanup failure keeps
+the previous selection; retry after restoring the execution service.
+The session's files and saved conversation remain. Switching does not resend
+the session's already-delivered opening briefing through project setup. A first
+switch to Claude carries the bounded conversation history directly, including
+transfers larger than the project-prompt request limit.
+Switching does not resend
+the old request or confirm uncertain delivery. Use **Retry** for that
+original request before deciding to repeat it; send a new instruction when you
+want the new assistant to continue the work. After the switch, **Send** becomes
+available automatically; reloading or **Retry** is not required to
+start a new request. **Previous assistant delivery unconfirmed** describes the
+old attempt and explains how to continue with your selected assistant. Its
+**Retry** control only checks that previous attempt.
+These steps apply on desktop and
+mobile. Colleague can explain the notice and change a supported selection when
+you ask it to; provider credit top-ups require your interaction.
+
+If failure, Stop or reconnection observes different outcomes for one assistant
+turn, Vibe64 reuses that turn's first recovery checkpoint and its recorded
+outcome. A failed turn can therefore have a valid checkpoint.
+
+**Recovery snapshot not saved** means Vibe64 could not confirm the automatic
+recovery copy for an assistant turn. It does not mean your working files were
+deleted or prevent you from chatting. An interrupted snapshot command is named
+as such; expand **Technical details** for the original error and recovery steps.
+Vibe64 attempts another snapshot when the next assistant turn finishes, including
+failed or stopped turns—not immediately when you send a message. A successful
+snapshot clears the warning automatically.
+
+Select **Dismiss** to hide this particular failure. This takes effect immediately
+and is remembered for this project/session in the same browser across reloads.
+It does not delete diagnostic records or create a snapshot. A later failure shows
+a new warning, even if its error text is the same. The same controls work on desktop
+and mobile; no SSH or administrator access is required. Colleague can explain the
+notice and its recovery steps; use the visible Dismiss button yourself. Repeated
+identity, permission or storage failures still need operator investigation.
+
+An unsupported OpenCode version needs operator runtime repair before retrying;
+repeating a message cannot fix it. Colleague can explain this startup error on
+desktop or mobile but cannot repair the host installation.
+
+If OpenCode produces reasoning without a final answer, it makes one automatic
+attempt to obtain that answer. You can still send a new instruction; it waits for
+that recovery message to be confirmed before delivery. **Stop** remains available
+while it waits. If delivery or the final answer cannot be confirmed, inspect the
+existing messages and work before retrying; do not send the same request again.
+The original request and its reasoning remain in the chat. These controls work
+on desktop and phone; Colleague can explain the status and offer a supported
+check, but does not silently repeat your message.
+Progress summaries describe the work in progress; they do not mean the final
+answer is ready. They remain attached to the same conversation after reconnecting.
+
+For goal controls and changing models while a goal is running or paused, read
+[Goals and model changes](coding-agent-goals.md).
+
+If a Learning practice conversation's source clone was removed, Codex shows the
+same clone-recovery notice as a Working conversation. Keep the saved lesson and
+request while resolving the missing clone before retrying.
+
+If Codex cannot load its model catalogue, ask the operator to check its
+installation/connection and restart the assistant service. Colleague can explain
+this desktop/mobile recovery but cannot perform the host operation.
+
+If Codex stops while the editor restores its managed controls, its notice identifies
+that interruption. An interruption with no known cause is not reported as a
+provider failure. **Stop**, service restart, missing final-response delivery and a
+confirmed provider failure retain their distinct notices. Your saved file changes
+remain; inspect the result and send a new message when ready to continue.
+
+If Codex reaches its total usage allowance, the chat shows the provider's limit
+message and any retry time it supplies, even if Codex already wrote progress or
+an answer during that turn. Saved replies and file changes remain. Use **View
+Codex usage & billing** to inspect the allowance, wait for availability, or choose
+another available AI through **Chat mode**. Restarting the conversation does not
+reset the allowance. Colleague can explain these options; it cannot increase
+your provider allowance.