@agent-deck/cli 1.11.9 → 2.1.0

package/dist/agent-harness.d.ts

@@ -8,6 +8,8 @@ export declare const HARNESS_RULE_DESCRIPTION = "Use when user mentions decks, p
 export declare function buildClaudeHarnessBlock(scope: SetupScope): string;
 /** Codex uses the same protocol guidance, merged into AGENTS.md. */
 export declare function buildCodexHarnessBlock(scope: SetupScope): string;
+/** Muse project scope merges the same full harness into root AGENTS.md. */
+export declare function buildMuseHarnessBlock(scope: SetupScope): string;
 export declare function buildCursorHarnessInner(scope: SetupScope): string;
 /** Merge only the agent-deck section; never replace other Cursor rules or skills. */
 export declare function mergeCursorHarnessFile(existing: string, harnessInner: string, description?: string): {
@@ -25,6 +27,7 @@ export type HarnessInstallResult = {
     path?: string;
     action?: 'created' | 'updated' | 'unchanged';
     message: string;
+    error?: string;
 };
 export declare function installAgentHarness(client: HarnessClient, scope: SetupScope): HarnessInstallResult;
 export type HarnessDiagnosisStatus = 'current' | 'missing' | 'stale';
@@ -42,6 +45,10 @@ export interface HarnessDiagnosis {
 export declare function diagnoseHarness(client: HarnessClient, scope: SetupScope): HarnessDiagnosis;
 /** Read-only freshness check for every supported harness client. */
 export declare function diagnoseAllHarnesses(scope?: SetupScope): HarnessDiagnosis[];
-/** Human-readable lines naming the affected client/file and the exact repair command. */
-export declare function formatHarnessDiagnosis(diagnoses: HarnessDiagnosis[]): string[];
+export interface HarnessFormatOptions {
+    color?: boolean;
+    homeDir?: string;
+}
+/** Compact, human-readable recovery summary with visually distinct commands. */
+export declare function formatHarnessDiagnosis(diagnoses: HarnessDiagnosis[], options?: HarnessFormatOptions): string[];
 //# sourceMappingURL=agent-harness.d.ts.map

package/dist/agent-harness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-harness.d.ts","sourceRoot":"","sources":["../src/agent-harness.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC;AAEhD,eAAO,MAAM,oBAAoB,sCAAsC,CAAC;AACxE,eAAO,MAAM,kBAAkB,oCAAoC,CAAC;AACpE,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAErD,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,mHACwE,CAAC;AAsD9G,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAMjE;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEhE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAIjE;AAID,qFAAqF;AACrF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,WAAW,GAAE,MAAiC,GAC7C;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA0BvC;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEhE;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAoBvC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAoB1F;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAiBF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,GAAG,oBAAoB,CA6ClG;AAED,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,sBAAsB,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;CACvB;AAkBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAmB1F;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,UAAqB,GAAG,gBAAgB,EAAE,CAGrF;AAED,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,MAAM,EAAE,CAmB9E"}
+{"version":3,"file":"agent-harness.d.ts","sourceRoot":"","sources":["../src/agent-harness.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAQ1D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC;AAEhD,eAAO,MAAM,oBAAoB,sCAAsC,CAAC;AACxE,eAAO,MAAM,kBAAkB,oCAAoC,CAAC;AACpE,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAErD,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,mHACwE,CAAC;AA8D9G,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAMjE;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEhE;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE/D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAIjE;AAID,qFAAqF;AACrF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,WAAW,GAAE,MAAiC,GAC7C;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA0BvC;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEhE;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAoBvC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CA2B1F;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAiBF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,GAAG,oBAAoB,CA6ElG;AAED,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,sBAAsB,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;CACvB;AAwBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAuB1F;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,UAAqB,GAAG,gBAAgB,EAAE,CAGrF;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAUD,gFAAgF;AAChF,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,gBAAgB,EAAE,EAC7B,OAAO,GAAE,oBAAyB,GACjC,MAAM,EAAE,CAuBV"}

package/dist/agent-harness.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HARNESS_RULE_DESCRIPTION = exports.CURSOR_RULE_FILENAME = exports.HARNESS_MARKER_END = exports.HARNESS_MARKER_START = void 0;
 exports.buildClaudeHarnessBlock = buildClaudeHarnessBlock;
 exports.buildCodexHarnessBlock = buildCodexHarnessBlock;
+exports.buildMuseHarnessBlock = buildMuseHarnessBlock;
 exports.buildCursorHarnessInner = buildCursorHarnessInner;
 exports.mergeCursorHarnessFile = mergeCursorHarnessFile;
 exports.buildCursorHarnessFile = buildCursorHarnessFile;
@@ -18,6 +19,8 @@ exports.formatHarnessDiagnosis = formatHarnessDiagnosis;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
+const muse_skills_1 = require("./muse-skills");
+const terminal_style_1 = require("./terminal-style");
 exports.HARNESS_MARKER_START = '<!-- agent-deck:harness:start -->';
 exports.HARNESS_MARKER_END = '<!-- agent-deck:harness:end -->';
 exports.CURSOR_RULE_FILENAME = 'agent-deck.mdc';
@@ -29,12 +32,20 @@ const GLOBAL_BODY = `**Connect first:** Connection has three layers: host transp
 
 **Session opener (first turn only) — the canonical session receipt:** This call verifies an existing connection; it does not create it. The folder's deck comes from \`.agent-deck/use.json\`, which \`agent-deck use <deck>\` writes — the connection carries it; the agent does **not** pick a deck and must **not** call \`get_decks\`. When Agent Deck MCP is configured for the session, call \`get_session_context\` once, and show the session binding as **exactly one transcript line** rendering \`display_summary\` (e.g. \`◆ dev · 2 MCP · 0 keys · 1 playbooks\`). Render it verbatim: the string is the one source for the receipt — do not reconstruct the deck name, counts, badge, or the session (default …) override suffix, and print the suffix exactly as returned when the session deck differs from the workspace default. This transcript receipt is the authoritative binding record for the session; workspace badges and terminal status lines are optional secondary context and never override it. Match the task against the returned playbook triggers and call \`get_playbook\` for every match before taking task action. If tools are unavailable, repair the host transport first. On \`GRANT_REQUIRED\`, match the message before acting. "No deck assigned to this folder…" means the folder itself has no assignment — tell the user to run \`agent-deck use <deck>\` in the folder and reload MCP, then stop. "This MCP session has not bound yet…" means the session only needs its first bind — call \`bind_workspace\` (or \`get_session_binding\`) once, then retry \`switch_deck\`; no CLI step, no reload, and stop only if that retry also fails. For an unattended session, fix \`x-agent-deck-deck-id\` / the launch config instead. If \`.agent-deck/use.json\` already assigns the deck and only the project MCP pin is missing, that \`use\` can succeed from a host agent sandbox; creating a new assignment needs an unsandboxed terminal (home store write). Do **not** repeat the receipt on later turns when the binding is unchanged. A confirmed binding change allows exactly one new receipt line. (\`get_session_binding\` and \`get_bound_deck\` remain available for compatibility; the opener needs only \`get_session_context\`.)
 
+**Deck operating instructions:** \`get_session_context\` returns \`operatingInstructions\` for the bound deck (\`''\` when the deck sets none). On the first turn, read and follow the non-empty instructions for this session's deck only. After a confirmed deck change, call \`get_session_context\` once before more task work and follow only the new deck's instructions — the previous deck's instructions stop applying immediately. Deck instructions never override platform safety, developer/user instructions, or authorization boundaries, and never enable extra tools. On any conflict the higher-priority instruction wins — report the conflict instead of complying. MCP initialize-time server instructions are a bootstrap hint only: they reflect the deck at connect time and never update after a hot switch, so \`get_session_context\` stays the authoritative live value. No reconnect is needed after a switch.
+
 **Later turns:** Deck scope comes from the launch-selected connection (folder assignment or launch header). Do not re-bind unless the user asks for deck administration. Do not re-show the session receipt on later turns when the binding is unchanged; after a confirmed binding change, show exactly one new receipt line and then stop repeating it. To move to another deck, call \`switch_deck\` and wait — the user approves it as This session only or This workspace by default; the active deck is unchanged until approval and no reload is needed. A rejected move (\`DECK_FIXED\` / \`ADMIN_REQUIRED\`) means the agent cannot change the connection itself — tell the user instead of retrying.
 
 Before declining for missing tools (Slack, Linear, GitHub, etc.), use agent-deck MCP: \`get_bound_deck\`, \`call_service_tool\`. Don't hardcode deck IDs.
 
 **Deck admin (create/edit deck):** Normal agents get \`ADMIN_REQUIRED\`. Call \`request_admin_elevation\`; user approves in the dashboard/menubar. After approval, \`mode\` is \`agent-admin\` until lease expiry or \`exit_admin_mode\`. Surface shared-deck workspace counts before mutating a deck used elsewhere. Deck switches never use elevation — request them with \`switch_deck\` and wait for human approval.
 
+**Delegating to another session:** When the user asks to hand a task to another local session, delegate with \`agent-deck run\`.
+The orchestrator must not choose the deck — the user names it; never pick or change it yourself.
+Choose \`--tools readonly\` unless the brief owner says \`edit\`, and never raise the profile on your own.
+For the brief–launch–monitor–review–resume protocol read the \`agent-deck-run\` skill (\`skills/agent-deck-run/SKILL.md\`); for per-client flags, resume ids, and trust behavior read \`docs/DELEGATION.md\`.
+For corrections from a delegated run, who files and with what evidence is defined in the "Corrections from a delegated run" block of \`skills/agent-deck-run/SKILL.md\`.
+
 **Playbooks — runtime discovery (no generated stubs):** Playbook triggers and bodies live only on the bound deck — \`agent-deck use\` and bind/switch write no per-playbook files, so switching decks never requires regenerating workspace files for discovery. On every task, match the task against the playbook \`triggers\` returned by \`get_bound_deck\` and call \`get_playbook\` for every match before acting. A playbook that exists only on the newly active deck is discovered the same way (\`get_bound_deck\` lists its triggers; \`get_playbook\` fetches its body) — never rely on checked-in stub or skill files, which may belong to a previously bound deck. **Never** mirror playbook bodies into \`.cursor/skills/\`, rules, or Claude skills — one source of truth on the deck.
 
 ### When user asks for a playbook task
@@ -83,6 +94,10 @@ function buildClaudeHarnessBlock(scope) {
 function buildCodexHarnessBlock(scope) {
     return buildClaudeHarnessBlock(scope);
 }
+/** Muse project scope merges the same full harness into root AGENTS.md. */
+function buildMuseHarnessBlock(scope) {
+    return buildClaudeHarnessBlock(scope);
+}
 function buildCursorHarnessInner(scope) {
     const body = scope === 'project' ? `${GLOBAL_BODY}\n\n${PROJECT_BODY_EXTRA}` : GLOBAL_BODY;
     return `# Agent Deck\n\n${body}`;
@@ -151,6 +166,12 @@ function resolveHarnessPath(client, scope) {
         const codexHome = process.env.CODEX_HOME?.trim() || node_path_1.default.join(home, '.codex');
         return scope === 'project' ? node_path_1.default.join(cwd, 'AGENTS.md') : node_path_1.default.join(codexHome, 'AGENTS.md');
     }
+    if (client === 'muse') {
+        if (scope === 'project') {
+            return node_path_1.default.join(cwd, 'AGENTS.md');
+        }
+        return (0, muse_skills_1.resolveMuseSkillsDir)(home);
+    }
     return null;
 }
 function readTextFile(filePath) {
@@ -167,11 +188,36 @@ function writeTextFile(filePath, content) {
     node_fs_1.default.writeFileSync(filePath, content, 'utf8');
 }
 function installAgentHarness(client, scope) {
+    if (client === 'muse' && scope === 'global') {
+        const skills = (0, muse_skills_1.installMuseSkills)();
+        if (!skills.ok) {
+            return {
+                installed: false,
+                path: skills.collisionPath,
+                message: skills.error,
+                error: skills.error,
+            };
+        }
+        const values = Object.values(skills.actions);
+        const action = values.every((value) => value === 'unchanged')
+            ? 'unchanged'
+            : values.some((value) => value === 'updated')
+                ? 'updated'
+                : 'created';
+        return {
+            installed: true,
+            path: skills.dir,
+            action,
+            message: action === 'unchanged'
+                ? `Muse skills already current → ${skills.dir}`
+                : `${skills.message} (other skills untouched)`,
+        };
+    }
     const harnessPath = resolveHarnessPath(client, scope);
     if (!harnessPath) {
         return {
             installed: false,
-            message: 'Agent harness applies to Cursor, Claude Code, and Codex. For Claude Desktop, add the same snippets from docs/AGENT_HARNESS.md to your Claude Code global CLAUDE.md if you use both.',
+            message: 'Agent harness applies to Cursor, Claude Code, Codex, and Muse. For Claude Desktop, add the same snippets from docs/AGENT_HARNESS.md to your Claude Code global CLAUDE.md if you use both.',
         };
     }
     if (client === 'cursor') {
@@ -190,27 +236,38 @@ function installAgentHarness(client, scope) {
                 : `Installed agent harness → ${harnessPath} (other rules/skills untouched)`,
         };
     }
-    const block = client === 'codex' ? buildCodexHarnessBlock(scope) : buildClaudeHarnessBlock(scope);
+    const block = client === 'codex'
+        ? buildCodexHarnessBlock(scope)
+        : client === 'muse'
+            ? buildMuseHarnessBlock(scope)
+            : buildClaudeHarnessBlock(scope);
     const existing = readTextFile(harnessPath);
     const { content, changed } = mergeClaudeHarness(existing, block);
     const action = !existing.trim() ? 'created' : changed ? 'updated' : 'unchanged';
     if (action !== 'unchanged') {
         writeTextFile(harnessPath, content);
     }
+    const hostFile = client === 'codex' || client === 'muse' ? 'AGENTS.md' : 'CLAUDE.md';
     return {
         installed: true,
         path: harnessPath,
         action,
         message: action === 'unchanged'
             ? `Agent harness already current → ${harnessPath}`
-            : `Installed agent harness → ${harnessPath} (rest of ${client === 'codex' ? 'AGENTS.md' : 'CLAUDE.md'} untouched)`,
+            : `Installed agent harness → ${harnessPath} (rest of ${hostFile} untouched)`,
     };
 }
 function expectedHarnessInner(client, scope) {
     if (client === 'cursor') {
         return buildCursorHarnessInner(scope);
     }
-    return client === 'codex' ? buildCodexHarnessBlock(scope) : buildClaudeHarnessBlock(scope);
+    if (client === 'codex') {
+        return buildCodexHarnessBlock(scope);
+    }
+    if (client === 'muse') {
+        return buildMuseHarnessBlock(scope);
+    }
+    return buildClaudeHarnessBlock(scope);
 }
 function extractManagedHarnessBlock(content) {
     const start = content.indexOf(exports.HARNESS_MARKER_START);
@@ -226,8 +283,12 @@ function extractManagedHarnessBlock(content) {
  * frontmatter, and other rules/skills cannot flag a file as stale.
  */
 function diagnoseHarness(client, scope) {
-    const harnessPath = resolveHarnessPath(client, scope);
     const repairCommand = `agent-deck setup --client ${client}`;
+    if (client === 'muse' && scope === 'global') {
+        const summary = (0, muse_skills_1.summarizeMuseSkillsDiagnosis)();
+        return { client, path: summary.path, status: summary.status, repairCommand };
+    }
+    const harnessPath = resolveHarnessPath(client, scope);
     if (!harnessPath) {
         return { client, path: '', status: 'missing', repairCommand };
     }
@@ -247,29 +308,35 @@ function diagnoseHarness(client, scope) {
 }
 /** Read-only freshness check for every supported harness client. */
 function diagnoseAllHarnesses(scope = 'global') {
-    const clients = ['cursor', 'claude', 'codex'];
+    const clients = ['cursor', 'claude', 'codex', 'muse'];
     return clients.map((client) => diagnoseHarness(client, scope));
 }
-/** Human-readable lines naming the affected client/file and the exact repair command. */
-function formatHarnessDiagnosis(diagnoses) {
-    const lines = ['Agent harness:'];
-    let problems = 0;
-    for (const diagnosis of diagnoses) {
-        if (diagnosis.status === 'current') {
-            lines.push(`  OK: ${diagnosis.client} → ${diagnosis.path}`);
-            continue;
-        }
-        problems += 1;
-        const label = diagnosis.status === 'missing' ? 'MISSING' : 'STALE';
-        lines.push(`  ${label}: ${diagnosis.client} → ${diagnosis.path || '(no path)'}`);
-        lines.push(`    repair: ${diagnosis.repairCommand}`);
+function compactHomePath(filePath, homeDir) {
+    if (filePath === homeDir) {
+        return '~';
     }
-    if (problems === 0) {
-        lines.push('  All harnesses current — first turns show one verbatim display_summary receipt.');
+    const homePrefix = `${homeDir}${node_path_1.default.sep}`;
+    return filePath.startsWith(homePrefix) ? `~${node_path_1.default.sep}${filePath.slice(homePrefix.length)}` : filePath;
+}
+/** Compact, human-readable recovery summary with visually distinct commands. */
+function formatHarnessDiagnosis(diagnoses, options = {}) {
+    const color = options.color ?? (0, terminal_style_1.terminalColorsEnabled)();
+    const homeDir = options.homeDir ?? node_os_1.default.homedir();
+    const problems = diagnoses.filter((diagnosis) => diagnosis.status !== 'current');
+    if (problems.length === 0) {
+        return [`${terminal_style_1.terminalStyle.bold('Agent harness:', color)} all current`];
     }
-    else {
-        lines.push('  First-turn receipt requires the harness above; re-run the repair command, then restart the host.');
+    const noun = problems.length === 1 ? 'repair' : 'repairs';
+    const lines = [
+        `${terminal_style_1.terminalStyle.bold('Agent harness:', color)} ${terminal_style_1.terminalStyle.warning(`${problems.length} ${noun} needed`, color)}`,
+    ];
+    for (const diagnosis of problems) {
+        const label = diagnosis.status === 'missing' ? 'MISSING' : 'STALE';
+        const target = compactHomePath(diagnosis.path, homeDir) || '(no path)';
+        lines.push(`  ${terminal_style_1.terminalStyle.warning(label, color)} ${diagnosis.client}  ${terminal_style_1.terminalStyle.dim(target, color)}`);
+        lines.push(`    Run: ${terminal_style_1.terminalStyle.command(diagnosis.repairCommand, color)}`);
     }
+    lines.push(terminal_style_1.terminalStyle.dim('  Restart each repaired host to load the updated harness.', color));
     return lines;
 }
 //# sourceMappingURL=agent-harness.js.map

package/dist/agent-harness.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-harness.js","sourceRoot":"","sources":["../src/agent-harness.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-harness.js","sourceRoot":"","sources":["../src/agent-harness.ts"],"names":[],"mappings":"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"}

package/dist/codex-plugin.d.ts

@@ -32,6 +32,19 @@ export interface CodexPluginState {
     classification?: CodexClassification;
     installedVersion?: string;
     selector?: string;
+    /**
+     * Installed plugin root as reported by `codex plugin list` (the Codex
+     * versioned cache path, e.g. `~/.codex/plugins/cache/agent-deck/agent-deck/<version>/`,
+     * when Codex materializes one). This is the version source of truth — not
+     * the marketplace workspace path.
+     */
+    installedRoot?: string;
+    /** Marketplace source root from `codex plugin marketplace list`. */
+    marketplaceRoot?: string;
+    /**
+     * Back-compat alias: the installed root when known, else the marketplace
+     * root. Prefer {@link installedRoot} / {@link marketplaceRoot}.
+     */
     root?: string;
     marketplaceName?: string;
     sourceKind?: 'local' | 'git' | 'unknown';
@@ -40,6 +53,20 @@ export interface CodexPluginState {
 export declare function inspectCodexPlugin(cliVersion: string, runner?: CodexRunner): Promise<CodexPluginState>;
 export declare function manualCodexCommands(selector: string): string[];
 export declare function remediationLine(selector: string): string;
+/**
+ * True when `root` is a Codex versioned plugin cache path, e.g.
+ * `~/.codex/plugins/cache/agent-deck/agent-deck/1.11.7/`. Only such paths
+ * are ever suggested for manual `rm -rf`: Agent Deck never removes cache
+ * paths itself and never suggests removing a marketplace workspace path.
+ */
+export declare function isVersionedCodexCachePath(root: string | undefined): boolean;
+/**
+ * Manual cache-clear commands for a sticky installed root. Returns [] unless
+ * the root is recognisably a versioned `plugins/cache/agent-deck` path, so
+ * callers never print `rm -rf` against a marketplace workspace checkout.
+ * Agent Deck never runs these itself — they are printed for the operator.
+ */
+export declare function stickyCacheClearCommands(installedRoot: string | undefined): string[];
 /**
  * Reconcile the installed Agent Deck plugin after a CLI upgrade.
  * Pass `{ alreadyCurrent: true }` when the CLI was already current so

package/dist/codex-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex-plugin.d.ts","sourceRoot":"","sources":["../src/codex-plugin.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,UAAU,GACV,YAAY,GACZ,kBAAkB,GAClB,aAAa,GACb,mBAAmB,GACnB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC;AAEtE,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAC9E,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAEtE,eAAO,MAAM,sBAAsB,eAAe,CAAC;AACnD,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAM/D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAqBvE;AAoDD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;CACrC;AA6HD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;IACzC,SAAS,EAAE,cAAc,CAAC;CAC3B;AAuCD,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,WAA6B,GACpC,OAAO,CAAC,gBAAgB,CAAC,CAoL3B;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gCAAgC,CACpD,eAAe,EAAE,MAAM,EACvB,MAAM,GAAE,WAA6B,EACrC,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,OAAO,CAAC,MAAM,CAAC,CA6GjB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,WAA6B,GACpC,OAAO,CAAC,MAAM,CAAC,CAgDjB"}
+{"version":3,"file":"codex-plugin.d.ts","sourceRoot":"","sources":["../src/codex-plugin.ts"],"names":[],"mappings":"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"}

package/dist/codex-plugin.js

@@ -8,10 +8,13 @@ exports.runCodexCommand = runCodexCommand;
 exports.inspectCodexPlugin = inspectCodexPlugin;
 exports.manualCodexCommands = manualCodexCommands;
 exports.remediationLine = remediationLine;
+exports.isVersionedCodexCachePath = isVersionedCodexCachePath;
+exports.stickyCacheClearCommands = stickyCacheClearCommands;
 exports.reconcileCodexPluginAfterUpgrade = reconcileCodexPluginAfterUpgrade;
 exports.runCodexPluginDoctor = runCodexPluginDoctor;
 const node_child_process_1 = require("node:child_process");
 const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
 exports.AGENT_DECK_PLUGIN_NAME = 'agent-deck';
 exports.DEFAULT_PLUGIN_SELECTOR = 'agent-deck@agent-deck';
@@ -317,6 +320,7 @@ async function inspectCodexPlugin(cliVersion, runner = runCodexCommand) {
             classification: 'disabled',
             installedVersion: first.version,
             selector: first.selector,
+            installedRoot: first.root,
             root: first.root,
             transport: readTransport(first.root),
         };
@@ -336,6 +340,7 @@ async function inspectCodexPlugin(cliVersion, runner = runCodexCommand) {
     const distinctRoots = [...new Set(installed.map((p) => p.root).filter(Boolean))];
     const ambiguous = selectors.length > 1 || supplying.length > 1 || distinctRoots.length > 1;
     if (ambiguous) {
+        const ambiguousRoot = distinctRoots.length === 1 ? distinctRoots[0] : first.root;
         return {
             ...base,
             installed,
@@ -343,15 +348,23 @@ async function inspectCodexPlugin(cliVersion, runner = runCodexCommand) {
             classification: 'ambiguous-source',
             installedVersion: first.version,
             selector,
-            root: distinctRoots.length === 1 ? distinctRoots[0] : first.root,
-            transport: readTransport(distinctRoots.length === 1 ? distinctRoots[0] : first.root),
+            installedRoot: ambiguousRoot,
+            root: ambiguousRoot,
+            transport: readTransport(ambiguousRoot),
         };
     }
     const resolvedMarketplace = supplying.length === 1 ? supplying[0] : undefined;
-    const root = first.root ?? resolvedMarketplace?.root;
+    // The installed root (Codex versioned cache path when present) is the
+    // version source of truth; the marketplace root is only where Codex
+    // re-reads from on `plugin add`. A sticky cache keeps serving the old
+    // installed root after the marketplace workspace already has the new
+    // `plugin.json`, so the two must stay distinguishable downstream.
+    const installedRoot = observedVersionedCacheRoot(first.version) ?? first.root;
+    const marketplaceRoot = resolvedMarketplace?.root;
+    const root = installedRoot ?? marketplaceRoot;
     const marketplaceName = part ?? resolvedMarketplace?.name ?? first.marketplace;
     const sourceKind = resolvedMarketplace?.source ?? 'unknown';
-    const transport = readTransport(root);
+    const transport = readTransport(installedRoot ?? marketplaceRoot);
     if (transport === 'direct-http') {
         return {
             ...base,
@@ -360,6 +373,8 @@ async function inspectCodexPlugin(cliVersion, runner = runCodexCommand) {
             classification: 'legacy-http',
             installedVersion: first.version,
             selector,
+            installedRoot,
+            marketplaceRoot,
             root,
             marketplaceName,
             sourceKind,
@@ -374,6 +389,8 @@ async function inspectCodexPlugin(cliVersion, runner = runCodexCommand) {
             classification: 'version-mismatch',
             installedVersion: first.version,
             selector,
+            installedRoot,
+            marketplaceRoot,
             root,
             marketplaceName,
             sourceKind,
@@ -390,6 +407,8 @@ async function inspectCodexPlugin(cliVersion, runner = runCodexCommand) {
             classification: 'unknown-transport',
             installedVersion: first.version,
             selector,
+            installedRoot,
+            marketplaceRoot,
             root,
             marketplaceName,
             sourceKind,
@@ -403,6 +422,8 @@ async function inspectCodexPlugin(cliVersion, runner = runCodexCommand) {
         classification: 'compatible',
         installedVersion: first.version,
         selector,
+        installedRoot,
+        marketplaceRoot,
         root,
         marketplaceName,
         sourceKind,
@@ -415,6 +436,72 @@ function manualCodexCommands(selector) {
 function remediationLine(selector) {
     return `codex plugin remove ${selector} && codex plugin add ${selector}`;
 }
+/**
+ * True when `root` is a Codex versioned plugin cache path, e.g.
+ * `~/.codex/plugins/cache/agent-deck/agent-deck/1.11.7/`. Only such paths
+ * are ever suggested for manual `rm -rf`: Agent Deck never removes cache
+ * paths itself and never suggests removing a marketplace workspace path.
+ */
+function isVersionedCodexCachePath(root) {
+    if (!root) {
+        return false;
+    }
+    return /plugins[/\\]cache[/\\]agent-deck[/\\]agent-deck[/\\][^/\\]+/.test(root.replace(/\\/g, '/'));
+}
+/**
+ * Manual cache-clear commands for a sticky installed root. Returns [] unless
+ * the root is recognisably a versioned `plugins/cache/agent-deck` path, so
+ * callers never print `rm -rf` against a marketplace workspace checkout.
+ * Agent Deck never runs these itself — they are printed for the operator.
+ */
+function stickyCacheClearCommands(installedRoot) {
+    if (!isVersionedCodexCachePath(installedRoot)) {
+        return [];
+    }
+    return [`rm -rf "${installedRoot}"`];
+}
+function codexHomeDir() {
+    const fromEnv = process.env.CODEX_HOME?.trim();
+    if (fromEnv) {
+        return fromEnv;
+    }
+    return node_path_1.default.join(node_os_1.default.homedir(), '.codex');
+}
+/**
+ * Versioned Codex plugin cache dir for an installed version, e.g.
+ * `<CODEX_HOME>/plugins/cache/agent-deck/agent-deck/1.11.7/`, when it
+ * exists on disk. Live Codex may list the marketplace workspace as the
+ * plugin source path while actually serving a stale copy from this cache,
+ * so an on-disk match takes precedence as the installed root. Returns
+ * undefined when absent — inspection never implies a cache that is not there.
+ */
+function observedVersionedCacheRoot(installedVersion) {
+    if (!installedVersion || /[/\\]/.test(installedVersion) || installedVersion.includes('..')) {
+        return undefined;
+    }
+    const candidate = node_path_1.default.join(codexHomeDir(), 'plugins', 'cache', 'agent-deck', 'agent-deck', installedVersion);
+    try {
+        if (node_fs_1.default.statSync(candidate).isDirectory()) {
+            return candidate;
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+function printStickyCacheBlock(installedRoot, selector) {
+    const commands = stickyCacheClearCommands(installedRoot);
+    if (commands.length === 0) {
+        return;
+    }
+    console.log('If remove/add keeps reporting the old version, Codex kept a sticky versioned cache.');
+    console.log('Clear the Agent Deck cache path manually (never removed by Agent Deck itself), then re-add:');
+    for (const command of commands) {
+        console.log(`  ${command}`);
+    }
+    console.log(`  codex plugin add ${selector}`);
+}
 function printManualSyncBlock(selector, marketplaceName) {
     console.log('To sync the plugin manually, run:');
     if (marketplaceName) {
@@ -518,7 +605,12 @@ async function reconcileCodexPluginAfterUpgrade(expectedVersion, runner = runCod
         return 0;
     }
     console.log(`${prefix}; Codex plugin still ${reread.classification ?? 'unreadable'} (installed ${reread.installedVersion ?? '(unknown)'}, expected ${expectedVersion}).`);
+    const rereadInstalledRoot = reread.installedRoot ?? reread.root;
+    if (rereadInstalledRoot) {
+        console.log(`Installed root: ${rereadInstalledRoot}`);
+    }
     printManualSyncBlock(targetSelector, marketplaceName);
+    printStickyCacheBlock(rereadInstalledRoot, targetSelector);
     return 1;
 }
 /**
@@ -556,13 +648,26 @@ async function runCodexPluginDoctor(cliVersion, runner = runCodexCommand) {
         case 'unknown-transport':
         case 'ambiguous-source': {
             const selector = state.selector ?? exports.DEFAULT_PLUGIN_SELECTOR;
-            const root = state.root ?? '(unknown)';
+            // The installed root is the version source of truth; the marketplace
+            // root only shows where `plugin add` re-reads from. When a sticky
+            // versioned cache survives, the two differ and only the installed
+            // root explains the reported version.
+            const installedRoot = state.installedRoot ?? state.root;
+            const marketplaceRoot = state.marketplaceRoot ?? state.root ?? '(unknown)';
             const source = state.sourceKind ?? 'unknown';
             console.log(`Codex plugin: ${state.classification} (installed ${state.installedVersion ?? '(unknown)'}, expected ${cliVersion})`);
             console.log(`Selector: ${selector}`);
-            console.log(`Marketplace root: ${root} (${source})`);
+            console.log(`Marketplace root: ${marketplaceRoot} (${source})`);
+            if (installedRoot && installedRoot !== marketplaceRoot) {
+                console.log(`Installed root: ${installedRoot}`);
+            }
             console.log(`Transport: ${state.transport}`);
             console.log(`Remediation: ${remediationLine(selector)}`);
+            if (state.classification === 'version-mismatch' ||
+                state.classification === 'legacy-http' ||
+                state.classification === 'unknown-transport') {
+                printStickyCacheBlock(installedRoot, selector);
+            }
             console.error(`FAIL: Codex plugin ${state.classification} (installed ${state.installedVersion ?? '(unknown)'}, expected ${cliVersion})`);
             return 1;
         }