multi-agents-cli 1.1.90 → 1.1.92

package/core/templates/CLAUDE.md

@@ -146,15 +146,14 @@ the agent must:
    # then take the parent directory of that path - this is PROJECT_ROOT
    ```
    Store this as PROJECT_ROOT. All subsequent paths (`.scaffold/`, `BUILD_STATE.md`, `CONTRACTS.md`, etc.) resolve from PROJECT_ROOT, never from the worktree directory.
-2. Read `output_mode` from `.claude-scope` in the current worktree directory:
-   - `full` — default, no restrictions on output
-   - `insights` — three permitted outputs only:
-     1. Colored bold `▶` opener before each phase — color is defined per agent file
-     2. Colored bold `✔` after each phase — outcome in 10 words or fewer, stated as fact, no first-person narration
-     3. Colored bold `⚠` when action is blocked or a decision is required
-     No other text. No transitions. No reasoning. No read/write acknowledgements.
-   - `silent` — show `✢ working...` between phases; emit only `✔` git operations, errors, and verification results; no other output
-   Store this as OUTPUT_MODE. Apply it consistently for the entire session.
+2. Read `output_mode` from `.claude-scope` in the current worktree directory. Do this silently — before emitting any output whatsoever, including narration of this session start sequence. Store as OUTPUT_MODE and enforce immediately:
+   - `full` — no restrictions on output
+   - `insights` — hard contract for the entire session. Emit exactly: `Output mode: insights` then proceed. Only three output types are permitted — any other text is a violation:
+     1. Before each phase, output this exact string (replace placeholders): `\033[1;36m▶\033[0m [phase] — [what and why, one line]` (color per agent scope: cyan client, yellow backend `\033[1;33m`, red shared `\033[1;31m`)
+     2. After each phase, output this exact string (replace placeholder): `\033[1;32m✔\033[0m [result — outcome in 10 words or fewer, stated as fact, no first-person narration]`
+     3. When blocked or a decision is required, output this exact string: `\033[38;5;208m\033[1m⚠\033[0m [blocker or decision]`
+   - `silent` — emit exactly: `Output mode: silent` then proceed. Show `✢ working...` between phases; emit only `\033[1;32m✔\033[0m` git operations, errors, and verification results; no other output
+   All remaining session start steps execute silently under insights and silent modes.
 3. Read `BUILD_STATE.md` at PROJECT_ROOT - understand what has been built
 3. Check if `TASK.md` exists in the current directory
 4. If yes - read it and verify dependencies are met against BUILD_STATE.md
@@ -575,4 +574,27 @@ Log completion in TASK.md checklist.
 Confirm: "Remote configured — proceeding with task."
 
 **Never begin task implementation until this flag is cleared.
-Never delete the flag on failure.**
+Never delete the flag on failure.**
+## Completed Task Protocol
+
+If `TASK.md` status is `COMPLETED` at session start, a previous task finished in this worktree.
+
+**Do not re-run completed work. Treat any new user input as a follow-on task.**
+
+### On session start with COMPLETED TASK.md
+
+1. Read `TASK.md` silently - note what was completed
+2. Read `.claude-scope` for output mode (already set - no action needed)
+3. Emit session confirmation per Output Mode Contract
+4. Output (insights/full modes): `✔ Previous task complete. Ready for follow-on work.`
+5. Wait for user input
+
+### On receiving follow-on task
+
+1. Treat it as a new task within the same scope and worktree
+2. Execute it fully per your agent mission and scope rules
+3. Append a new entry to TASK.md under a `## Follow-on Task` heading with status IN PROGRESS
+4. When complete, update status to COMPLETED and run `npm run complete`
+
+**Never begin implementation before confirming scope.
+Never touch files outside your assigned scope.**

package/core/workflow/agent.js

@@ -1064,6 +1064,51 @@ const main = async () => {
     if (activeChoice === 4) { continue agentLoop; }
   }
 
+  // COMPLETED gate
+  const completedSlot = tracking?.[project]?.[agent];
+  if (completedSlot?.status === 'COMPLETED') {
+    const sanitizedForWorktree = config.projectName.toLowerCase().replace(/\s+/g, '-');
+    const completedTimestamp   = completedSlot.branch ? completedSlot.branch.split('/')[3] : null;
+    const completedWorktreeName = completedTimestamp
+      ? `${project}-${sanitizedForWorktree}-${agent.toLowerCase()}-${completedTimestamp}`
+      : null;
+    const completedWorktreePath = completedWorktreeName
+      ? path.join(ROOT, 'worktrees', completedWorktreeName)
+      : null;
+    const worktreeExists = completedWorktreePath && fs.existsSync(completedWorktreePath);
+
+    separator();
+    console.log(`\n  ${bold(green('\u2713'))} ${bold(agent)} previously completed${completedSlot.completedAt ? ' on ' + new Date(completedSlot.completedAt).toLocaleDateString() : ''}.`);
+    if (worktreeExists) {
+      console.log(`  ${dim('Worktree')} : ${dim(completedWorktreePath)}\n`);
+    }
+
+    const completedOptions = worktreeExists
+      ? ['Continue in existing worktree', 'Start a new task', 'Pick a different agent']
+      : ['Start a new task', 'Pick a different agent'];
+
+    const completedChoice = await arrowSelect('What would you like to do?', completedOptions, rl);
+
+    if (worktreeExists) {
+      if (completedChoice === 0) {
+        openIDE(completedWorktreePath);
+        rl.close();
+        return;
+      }
+      if (completedChoice === 1) {
+        guards.clearTrackingSlot(tracking, project, agent, ROOT);
+        // fall through to fresh launch
+      }
+      if (completedChoice === 2) { continue agentLoop; }
+    } else {
+      if (completedChoice === 0) {
+        guards.clearTrackingSlot(tracking, project, agent, ROOT);
+        // fall through to fresh launch
+      }
+      if (completedChoice === 1) { continue agentLoop; }
+    }
+  }
+
   // MISSING gate
   const trackingSlot = tracking?.[project]?.[agent];
   if (trackingSlot?.status === 'MISSING') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multi-agents-cli",
-  "version": "1.1.90",
+  "version": "1.1.92",
   "description": "Multi-agent workflow orchestration for Claude Code — isolated git worktrees, structured state tracking, autonomous task chaining",
   "keywords": [
     "claude-code",