otacon 0.1.1 → 0.1.3

package/dist/cli/commands/install.js

@@ -1,38 +1,44 @@
 // otacon install --agent claude|codex|opencode [--agent …] | --all [--hooks] —
 // write the protocol wrapper into each agent's skill location (DESIGN.md §16).
 // Pure file writes — no daemon needed. Wrappers are managed files: reinstall
-// overwrites them (Codex: only the marked block inside its shared AGENTS.md).
-// --hooks additionally registers the Claude Code Stop hook in
-// ~/.claude/settings.json — merged additively and idempotently, with a backup
-// before the first change, never clobbering what cannot be parsed.
+// overwrites them wholesale. --hooks additionally registers the Claude Code Stop
+// hook in ~/.claude/settings.json — merged additively and idempotently, with a
+// backup before the first change, never clobbering what cannot be parsed.
 import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
 import { parseArgs } from "node:util";
-import { CODEX_BEGIN, CODEX_END, codexBlock, skillMd, STOP_HOOK_SCRIPT } from "../install/assets.js";
-import { claudeHookScriptPath, claudeSettingsPath, claudeSkillPath, codexAgentsPath, mergeStopHook, opencodeSkillPath, settingsRegisterStopHook, upsertMarkedBlock, } from "../install/locations.js";
+import { skillMd, STOP_HOOK_SCRIPT } from "../install/assets.js";
+import { claudeHookScriptPath, claudeSettingsPath, claudeSkillPath, codexSkillPath, mergeStopHook, opencodeSkillPath, settingsRegisterStopHook, } from "../install/locations.js";
 import { fail, notice, printJson, usageError } from "../output.js";
+import { findRepoRoot } from "../session.js";
 const AGENTS = ["claude", "codex", "opencode"];
 function writeManaged(path, content) {
     mkdirSync(dirname(path), { recursive: true });
     writeFileSync(path, content);
 }
-function installAgent(agent) {
+function installAgent(agent, scope) {
     switch (agent) {
         case "claude": {
-            writeManaged(claudeSkillPath(), skillMd());
-            writeManaged(claudeHookScriptPath(), STOP_HOOK_SCRIPT);
-            chmodSync(claudeHookScriptPath(), 0o755);
-            return { agent, files: [claudeSkillPath(), claudeHookScriptPath()] };
+            const skill = claudeSkillPath(scope);
+            writeManaged(skill, skillMd());
+            // The Stop hook script lives in the user home only — it is never written at
+            // project scope (DECISIONS.md "Stop hook deferred at project scope"), so a
+            // committed `.claude/` ships an inert skill wrapper, never a hook pointing at
+            // a script teammates may not have. `--hooks --project` is rejected upstream.
+            if (scope.kind === "user") {
+                writeManaged(claudeHookScriptPath(), STOP_HOOK_SCRIPT);
+                chmodSync(claudeHookScriptPath(), 0o755);
+                return { agent, files: [skill, claudeHookScriptPath()] };
+            }
+            return { agent, files: [skill] };
         }
         case "codex": {
-            const path = codexAgentsPath();
-            const existing = existsSync(path) ? readFileSync(path, "utf8") : "";
-            writeManaged(path, upsertMarkedBlock(existing, codexBlock(), CODEX_BEGIN, CODEX_END));
-            return { agent, files: [path] };
+            writeManaged(codexSkillPath(scope), skillMd());
+            return { agent, files: [codexSkillPath(scope)] };
         }
         case "opencode": {
-            writeManaged(opencodeSkillPath(), skillMd());
-            return { agent, files: [opencodeSkillPath()] };
+            writeManaged(opencodeSkillPath(scope), skillMd());
+            return { agent, files: [opencodeSkillPath(scope)] };
         }
     }
 }
@@ -65,19 +71,14 @@ function applyStopHook() {
     notice(`registered the otacon Stop hook in ${path}`);
     return { registered: true, command, settings: path, ...(backup ? { backup } : {}) };
 }
-/** Without --hooks: report the current state and offer the flag (DESIGN.md §16). */
+// Without --hooks: report registration state without nagging (DESIGN.md §16). The
+// Stop hook is optional, so its absence is neither warned about nor "offered" — the
+// JSON still factually carries `registered` for anyone who wants to wire it up.
 function offerStopHook() {
-    const path = claudeSettingsPath();
-    const registered = settingsRegisterStopHook();
-    if (!registered) {
-        notice("Stop hook not registered — run `otacon install --agent claude --hooks` to add it to " +
-            `${path} (merged additively, existing settings preserved, backup written first)`);
-    }
     return {
-        registered,
+        registered: settingsRegisterStopHook(),
         command: claudeHookScriptPath(),
-        settings: path,
-        ...(registered ? {} : { hint: "re-run with --hooks to register the Stop hook" }),
+        settings: claudeSettingsPath(),
     };
 }
 export async function installCommand(argv) {
@@ -87,6 +88,7 @@ export async function installCommand(argv) {
             agent: { type: "string", multiple: true },
             all: { type: "boolean", default: false },
             hooks: { type: "boolean", default: false },
+            project: { type: "boolean", default: false },
         },
     });
     const picked = values.all ? [...AGENTS] : (values.agent ?? []);
@@ -101,13 +103,34 @@ export async function installCommand(argv) {
     if (values.hooks && !agents.includes("claude")) {
         usageError("--hooks registers the Claude Code Stop hook; include --agent claude (or --all)");
     }
-    const installed = agents.map(installAgent);
-    const hooks = agents.includes("claude")
+    // The Stop hook is a user-level Claude Code registration; it is never installed at
+    // project scope (DECISIONS.md "Stop hook deferred at project scope"), so the two
+    // flags are mutually exclusive rather than silently picking one.
+    if (values.hooks && values.project) {
+        usageError("--hooks installs a user-level Stop hook and cannot be combined with --project; run --hooks without --project");
+    }
+    // --project resolves the install base to the current git repo root so the
+    // wrappers can be committed and shared; outside any repo it is a hard error
+    // (DECISIONS.md "`--project` resolves to the git repo root").
+    let scope = { kind: "user" };
+    if (values.project) {
+        const cwd = process.cwd();
+        const root = findRepoRoot(cwd);
+        if (root === undefined) {
+            usageError(`otacon install --project must run inside a git repo; none found at ${cwd}`);
+        }
+        scope = { kind: "project", root };
+    }
+    const installed = agents.map((agent) => installAgent(agent, scope));
+    // The Stop hook report is user-only: at project scope --hooks is rejected, and
+    // offerStopHook() would read the user ~/.claude/settings.json — misleading for a
+    // project install — so the entire hooks branch is gated on user scope.
+    const hooks = scope.kind === "user" && agents.includes("claude")
         ? values.hooks
             ? applyStopHook()
             : offerStopHook()
         : undefined;
-    printJson({ ok: true, installed, ...(hooks ? { hooks } : {}) });
+    printJson({ ok: true, scope: scope.kind, installed, ...(hooks ? { hooks } : {}) });
     return 0;
 }
 //# sourceMappingURL=install.js.map

package/dist/cli/commands/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,+EAA+E;AAC/E,6EAA6E;AAC7E,iFAAiF;AACjF,+EAA+E;AAC/E,0EAA0E;AAE1E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtG,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,cAAc,EAEd,aAAa,EACb,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;AAGxD,SAAS,YAAY,CAAC,IAAY,EAAE,OAAe;IACjD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,YAAY,CAAC,KAAY,EAAE,KAAmB;IACrD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACrC,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/B,4EAA4E;YAC5E,2EAA2E;YAC3E,8EAA8E;YAC9E,6EAA6E;YAC7E,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC1B,YAAY,CAAC,oBAAoB,EAAE,EAAE,gBAAgB,CAAC,CAAC;gBACvD,SAAS,CAAC,oBAAoB,EAAE,EAAE,KAAK,CAAC,CAAC;gBACzC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,oBAAoB,EAAE,CAAC,EAAE,CAAC;YAC3D,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACnD,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,YAAY,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAClD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACtD,CAAC;IACH,CAAC;AACH,CAAC;AASD,2FAA2F;AAC3F,SAAS,aAAa;IACpB,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,oBAAoB,EAAE,CAAC;IACvC,IAAI,GAAG,GAAY,EAAE,CAAC;IACtB,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CACF,uBAAuB,EACvB,GAAG,IAAI,uFAAuF,CAC/F,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,CACF,kBAAkB,EAClB,GAAG,IAAI,+FAA+F,OAAO,GAAG,CACjH,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1E,IAAI,MAA0B,CAAC;IAC/B,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,IAAI,kBAAkB,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC/C,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3B,MAAM,CAAC,aAAa,IAAI,OAAO,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,YAAY,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,CAAC,sCAAsC,IAAI,EAAE,CAAC,CAAC;IACrD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACtF,CAAC;AAED,kFAAkF;AAClF,oFAAoF;AACpF,gFAAgF;AAChF,SAAS,aAAa;IACpB,OAAO;QACL,UAAU,EAAE,wBAAwB,EAAE;QACtC,OAAO,EAAE,oBAAoB,EAAE;QAC/B,QAAQ,EAAE,kBAAkB,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc;IACjD,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC3B,IAAI,EAAE,IAAI;QACV,OAAO,EAAE;YACP,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;YACzC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YACxC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YAC1C,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;SAC7C;KACF,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAc,CAAC;IAC7E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,UAAU,CAAC,6EAA6E,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAE,MAA4B,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,UAAU,CAAC,kBAAkB,OAAO,yCAAyC,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAY,CAAC;IAC/C,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/C,UAAU,CAAC,gFAAgF,CAAC,CAAC;IAC/F,CAAC;IACD,mFAAmF;IACnF,iFAAiF;IACjF,iEAAiE;IACjE,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnC,UAAU,CACR,8GAA8G,CAC/G,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,4EAA4E;IAC5E,8DAA8D;IAC9D,IAAI,KAAK,GAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC3C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,UAAU,CAAC,sEAAsE,GAAG,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,KAAK,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACpC,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IACpE,+EAA+E;IAC/E,iFAAiF;IACjF,uEAAuE;IACvE,MAAM,KAAK,GACT,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAChD,CAAC,CAAC,MAAM,CAAC,KAAK;YACZ,CAAC,CAAC,aAAa,EAAE;YACjB,CAAC,CAAC,aAAa,EAAE;QACnB,CAAC,CAAC,SAAS,CAAC;IAChB,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACnF,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/commands/open.js

@@ -1,11 +1,14 @@
-// otacon open [--session id] — print the review URL (DESIGN.md §6, human
-// convenience). Print, never launch: agents also run this, and stdout is the
-// contract (DECISIONS.md "open prints, never launches a browser"). With no
-// resolvable session the index URL is the answer, not an error — reading is
-// never the wrong screen; the never-guess rule guards writes, not looks.
+// otacon open [--session id]: launch the review URL in the browser (DESIGN.md
+// §6, human convenience). It runs on the human's machine and the verb means "show
+// me the page", so it spawns the browser; OTACON_NO_BROWSER prints the URL as JSON
+// instead, for headless hosts and URL-parsing agents (DECISIONS.md "open and
+// config launch the browser"). With no resolvable session the index URL is the
+// answer, not an error; reading is never the wrong screen, and the never-guess
+// rule guards writes, not looks.
 import { parseArgs } from "node:util";
+import { openOrPrint } from "../browser.js";
 import { baseUrl, ensureDaemon } from "../client.js";
-import { CliError, notice, printJson } from "../output.js";
+import { CliError, notice } from "../output.js";
 import { listSessions, realpathOr, resolveSession } from "../session.js";
 export async function openCommand(argv) {
     const { values } = parseArgs({
@@ -16,12 +19,8 @@ export async function openCommand(argv) {
     const sessions = await listSessions();
     try {
         const session = resolveSession(sessions, values.session, realpathOr(process.cwd()));
-        printJson({
-            ok: true,
-            session: session.id,
-            title: session.title,
-            url: `${baseUrl()}/s/${session.id}`,
-        });
+        const url = `${baseUrl()}/s/${session.id}`;
+        openOrPrint(url, { ok: true, session: session.id, title: session.title, url });
     }
     catch (error) {
         // An explicit --session that fails to resolve is a real refusal; implicit
@@ -29,8 +28,9 @@ export async function openCommand(argv) {
         // the index, which lists everything.
         if (!(error instanceof CliError) || values.session !== undefined)
             throw error;
-        notice(`${error.message} — printing the index URL`);
-        printJson({ ok: true, url: `${baseUrl()}/` });
+        notice(`${error.message}; using the index`);
+        const url = `${baseUrl()}/`;
+        openOrPrint(url, { ok: true, url });
     }
     return 0;
 }

package/dist/cli/commands/open.js.map

@@ -1 +1 @@
-{"version":3,"file":"open.js","sourceRoot":"","sources":["../../../src/cli/commands/open.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,6EAA6E;AAC7E,2EAA2E;AAC3E,4EAA4E;AAC5E,yEAAyE;AAEzE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEzE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC3B,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;KACzC,CAAC,CAAC;IACH,MAAM,YAAY,EAAE,CAAC;IACrB,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACpF,SAAS,CAAC;YACR,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,OAAO,CAAC,EAAE;YACnB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,GAAG,EAAE,GAAG,OAAO,EAAE,MAAM,OAAO,CAAC,EAAE,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,0EAA0E;QAC1E,wEAAwE;QACxE,qCAAqC;QACrC,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;YAAE,MAAM,KAAK,CAAC;QAC9E,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;QACpD,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../../src/cli/commands/open.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,kFAAkF;AAClF,mFAAmF;AACnF,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAC/E,iCAAiC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEzE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC3B,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;KACzC,CAAC,CAAC;IACH,MAAM,YAAY,EAAE,CAAC;IACrB,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACpF,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,MAAM,OAAO,CAAC,EAAE,EAAE,CAAC;QAC3C,WAAW,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IACjF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,0EAA0E;QAC1E,wEAAwE;QACxE,qCAAqC;QACrC,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;YAAE,MAAM,KAAK,CAAC;QAC9E,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,GAAG,CAAC;QAC5B,WAAW,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/commands/start.js

@@ -1,14 +1,18 @@
 // otacon start --title <t> [--quick] — mint and register a session (DESIGN.md
-// §6, §16): POST /api/sessions, append .otacon/ to the repo's .gitignore if
-// missing (with a notice), print the session id and review URL. No local
+// §6, §16): POST /api/sessions, print the session id and review URL. No local
 // session pointer — the daemon registry is the single source of truth (§7).
-import { appendFileSync, existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
 import { parseArgs } from "node:util";
 import { api, baseUrl, ensureDaemon } from "../client.js";
 import { fail, notice, printJson, usageError } from "../output.js";
 import { currentBranch, findRepoRoot, realpathOr } from "../session.js";
+import { maybeAutoUpdate } from "../update.js";
 export async function startCommand(argv) {
+    // Pre-session auto-update gate (DESIGN.md §16): on a newer published version
+    // this self-updates and re-execs `start` with the original argv, so the flags
+    // below are reconstructed exactly; in every other case it returns and we
+    // proceed on the installed version. Must run before ensureDaemon so the
+    // re-exec's version handshake restarts the stale daemon.
+    await maybeAutoUpdate(argv);
     const { values } = parseArgs({
         args: argv,
         options: { title: { type: "string" }, quick: { type: "boolean", default: false } },
@@ -34,8 +38,6 @@ export async function startCommand(argv) {
         fail("E_INTERNAL", `session create failed: ${JSON.stringify(created.body)}`, undefined, 2);
     }
     const session = created.body;
-    if (gitRoot !== undefined)
-        ensureGitignore(gitRoot);
     printJson({
         ok: true,
         session: session.id,
@@ -47,20 +49,4 @@ export async function startCommand(argv) {
     });
     return 0;
 }
-/** First start in a repo appends .otacon/ to .gitignore, with a notice (DESIGN.md §16). */
-export function ensureGitignore(repo) {
-    const path = join(repo, ".gitignore");
-    const existing = existsSync(path) ? readFileSync(path, "utf8") : "";
-    const covered = existing
-        .split("\n")
-        .some((line) => /^\/?\.otacon\/?$/.test(line.trim()));
-    if (covered)
-        return;
-    // Match the file's own line endings — appending LF to a CRLF file would
-    // leave it with mixed endings.
-    const eol = existing.includes("\r\n") ? "\r\n" : "\n";
-    const separator = existing === "" || existing.endsWith("\n") ? "" : eol;
-    appendFileSync(path, `${separator}.otacon/${eol}`);
-    notice(`appended .otacon/ to ${path} (working state stays out of git, DESIGN.md §12)`);
-}
 //# sourceMappingURL=start.js.map

package/dist/cli/commands/start.js.map

@@ -1 +1 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,4EAA4E;AAE5E,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAc;IAC/C,6EAA6E;IAC7E,8EAA8E;IAC9E,yEAAyE;IACzE,wEAAwE;IACxE,yDAAyD;IACzD,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAE5B,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC3B,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;KACnF,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7D,UAAU,CAAC,mCAAmC,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,0EAA0E;QAC1E,MAAM,CAAC,GAAG,GAAG,4DAA4D,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,IAAI,GAAG,CAAC;IAE5B,MAAM,YAAY,EAAE,CAAC;IACrB,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE;QACjD,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI;QACJ,MAAM,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC;QACvD,KAAK,EAAE,MAAM,CAAC,KAAK,KAAK,IAAI;KAC7B,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,YAAY,EAAE,0BAA0B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAkC,CAAC;IAE3D,SAAS,CAAC;QACR,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,OAAO,CAAC,EAAE;QACnB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI;QACJ,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,EAAE,GAAG,OAAO,EAAE,MAAM,OAAO,CAAC,EAAE,EAAE;KACpC,CAAC,CAAC;IACH,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/commands/update.js

@@ -0,0 +1,76 @@
+// otacon update [--check] — the manual/forced upgrade command (DESIGN.md §6,
+// §16). It deliberately bypasses the auto-update gate's two suppressors: it
+// ignores the 1h throttle (the user asked NOW) and `update.auto:false` (an
+// explicit command overrides a config that only governs the implicit start-time
+// check). It still fails open on a registry blip and never escalates to sudo —
+// it shares `runNpmUpdate` with the start-time gate, so the install behavior is
+// identical (D12, plan docs/plans/2026-06-19-auto-update-outdated-version.md).
+//
+//   --check  report current/latest/outdated and exit; never installs (a dry run
+//            for "am I behind?", and the only safe mode in CI / pinned shops).
+//
+// stdout is the usual single JSON line; npm's own progress and our notices go to
+// stderr. Exit 0 on every reported outcome except an attempted-but-failed
+// install, which is the one expected exit-1 failure (the manual command to run
+// is on stderr).
+import { parseArgs } from "node:util";
+import { VERSION } from "../../shared/version.js";
+import { isSourceRun } from "../client.js";
+import { notice, printJson } from "../output.js";
+import { fetchLatest, isNewer, runNpmUpdate } from "../update.js";
+const REAL_DEPS = {
+    fetch: fetchLatest,
+    runNpmUpdate,
+    sourceRun: isSourceRun,
+};
+export async function updateCommand(argv, deps = REAL_DEPS) {
+    const { values } = parseArgs({
+        args: argv,
+        options: { check: { type: "boolean", default: false } },
+    });
+    // Dev-run refusal (D6): a source checkout has no global package to update.
+    if (deps.sourceRun()) {
+        notice("running otacon from a source checkout; nothing to update");
+        printJson({ ok: true, source: true, version: VERSION });
+        return 0;
+    }
+    // Fail-open (D5): a transient registry blip is not a hard error — report that
+    // we couldn't check and exit 0, exactly as the start-time gate proceeds.
+    const latest = await deps.fetch();
+    if (latest === undefined) {
+        notice("could not reach the npm registry to check for updates; try again later");
+        printJson({ ok: true, current: VERSION, latest: null, outdated: false });
+        return 0;
+    }
+    const outdated = isNewer(latest, VERSION);
+    // --check never installs: it's the dry run.
+    if (values.check === true) {
+        printJson({ ok: true, current: VERSION, latest, outdated });
+        return 0;
+    }
+    // Already current: nothing to do.
+    if (!outdated) {
+        printJson({ ok: true, current: VERSION, latest, outdated: false, updated: false });
+        return 0;
+    }
+    // Outdated: install. On failure this is the one expected exit-1 path.
+    if (!deps.runNpmUpdate(latest).ok) {
+        notice("auto-update failed; run: npm install -g otacon@latest");
+        printJson({
+            ok: false,
+            error: { code: "E_UPDATE_FAILED", message: "npm install -g otacon@latest failed" },
+        });
+        return 1;
+    }
+    // Success. This process is STILL the old code (the binary was swapped under
+    // it), so we do NOT restart the daemon here: ensureDaemon from this old CLI
+    // would see daemon.version === this process's (old) VERSION and find no
+    // mismatch, so it could not pull the new version anyway. The new daemon (and
+    // the open tabs' self-heal) come up on the NEXT `otacon` invocation, which
+    // runs the freshly-installed binary and trips the version handshake. We report
+    // that accurately rather than claim a restart that didn't happen (D12).
+    notice(`updated otacon ${VERSION} → ${latest}; the daemon and any open tabs update on your next otacon command`);
+    printJson({ ok: true, updated: true, from: VERSION, to: latest });
+    return 0;
+}
+//# sourceMappingURL=update.js.map

package/dist/cli/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,4EAA4E;AAC5E,2EAA2E;AAC3E,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,EAAE;AACF,iFAAiF;AACjF,0EAA0E;AAC1E,+EAA+E;AAC/E,iBAAiB;AAEjB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAalE,MAAM,SAAS,GAAsB;IACnC,KAAK,EAAE,WAAW;IAClB,YAAY;IACZ,SAAS,EAAE,WAAW;CACvB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAc,EACd,OAA0B,SAAS;IAEnC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC3B,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;KACxD,CAAC,CAAC;IAEH,2EAA2E;IAC3E,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QACrB,MAAM,CAAC,0DAA0D,CAAC,CAAC;QACnE,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,8EAA8E;IAC9E,yEAAyE;IACzE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IAClC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,CAAC,wEAAwE,CAAC,CAAC;QACjF,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QACzE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE1C,4CAA4C;IAC5C,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1B,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,kCAAkC;IAClC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACnF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,sEAAsE;IACtE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,uDAAuD,CAAC,CAAC;QAChE,SAAS,CAAC;YACR,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,qCAAqC,EAAE;SACnF,CAAC,CAAC;QACH,OAAO,CAAC,CAAC;IACX,CAAC;IAED,4EAA4E;IAC5E,4EAA4E;IAC5E,wEAAwE;IACxE,6EAA6E;IAC7E,2EAA2E;IAC3E,+EAA+E;IAC/E,wEAAwE;IACxE,MAAM,CACJ,kBAAkB,OAAO,MAAM,MAAM,mEAAmE,CACzG,CAAC;IACF,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/install/assets.js

@@ -1,14 +1,12 @@
 // The wrapper content `otacon install` writes (DESIGN.md §16) — this is the
 // product-critical text that teaches an agent the whole protocol: the §6 full
 // loop, §8 grill discipline, and §13 "never end your turn". One protocol card,
-// three destinations: Claude Code and OpenCode get it as a SKILL.md; Codex gets
-// it as a marker-delimited block inside its shared ~/.codex/AGENTS.md. Plus the
-// Stop hook shell script (§13). Wrappers are managed files: reinstall
-// overwrites them wholesale (DECISIONS.md "Wrappers are managed files").
+// three destinations — Claude Code, Codex, and OpenCode each get it as a
+// SKILL.md in their own skills dir. Plus the Stop hook shell script (§13).
+// Wrappers are managed files: reinstall overwrites them wholesale (DECISIONS.md
+// "Wrappers are managed files").
 /** Present in every wrapper this tool owns; doctor greps for it. */
 export const MANAGED_MARKER = 'managed by `otacon install`';
-export const CODEX_BEGIN = '<!-- BEGIN OTACON — managed by `otacon install`; content inside these markers is overwritten on reinstall -->';
-export const CODEX_END = '<!-- END OTACON -->';
 /**
  * The protocol card — §6 full loop (start-first) + §8 grill discipline + §13
  * failure habits — parametrized by the command prefix so one source feeds both
@@ -27,7 +25,7 @@ machine-readable error you can fix (read the JSON); exit 2 = you invoked it wron
 
 1. \`${cmd} start --title <kebab-title>\` **first, before you research** — it mints
    the session and prints the review URL. Tell the user to open it (\`${cmd} open\`
-   prints it again) so they can watch the whole thing from the first second.
+   launches it in their browser) so they can watch the whole thing from the first second.
    \`--quick\` skips the interview — only when the user explicitly asks.
 2. **Research the codebase**, narrating as you go with
    \`${cmd} progress "<what you're doing>"\` — call it whenever you start a chunk of
@@ -59,18 +57,23 @@ machine-readable error you can fix (read the JSON); exit 2 = you invoked it wron
    - \`comments\` → revise plan.md; write \`resolutions.json\` as
      \`{"changelog":"what changed","threads":{"t1":"how you resolved it"}}\` with
      one reply per comment thread; \`${cmd} submit --resolutions resolutions.json\`
-     (loop on lint errors); park again.
+     (loop on lint errors); park again. A \`comments\` batch with \`"final":true\` is
+     the reviewer's **comment & approve**: resolve every thread the usual way, but
+     your next clean submit **finalizes** — you'll get \`approved\` (which may carry
+     \`implement:true\`), not another review round. So fold them all in, submit, then
+     park and handle the \`approved\` that follows (do NOT expect more comments).
    - \`question\` → \`${cmd} answer <q-id> --body "..."\` (or \`--file\`); park again. A
      \`question\` may carry \`replyTo\` (a follow-up on an earlier question) — skim that
      thread's prior turns for context, but still answer the new \`q<n>\`.
    - \`answer\` → use it and continue; park again whenever you are waiting.
    - \`timeout\` → park again immediately. A timeout is NEVER completion.
-   - \`approved\` → \`git add\` + commit the plan file at the printed \`path\`. Plain
-     \`approved\` (no \`implement\`) → print a one-line summary and STOP. \`approved\`
-     **with \`implement:true\`** → after committing, enter the **Implement loop**
-     (below) — do NOT stop; the session is now \`implementing\`.
+   - \`approved\` → the plan is saved at \`path\`. Plain \`approved\` (Save, no
+     \`implement\`) → print a one-line summary naming where it was saved (\`path\`),
+     then STOP. \`approved\` **with \`implement:true\`** → read the plan at \`path\` to
+     guide the build and enter the **Implement loop** (below) — do NOT stop; the
+     session is now \`implementing\`.
    - \`deleted\` → the user deleted this session in the review UI. It is over:
-     STOP. There is no approved plan and nothing to commit.
+     STOP. There is no approved plan.
 6. **Never end your turn while the session is open.** Nothing to do = park in
    \`${cmd} wait\` again. Confused, crashed, or compacted? \`${cmd} status\` returns
    the open session, revision, and pending events — resume the loop from it.
@@ -80,7 +83,7 @@ machine-readable error you can fix (read the JSON); exit 2 = you invoked it wron
 - \`${cmd} start --title <t> [--quick]\` · \`${cmd} progress "<note>"\` ·
   \`${cmd} ask ...\` · \`${cmd} wait --timeout 540\` · \`${cmd} submit [--resolutions f]\` ·
   \`${cmd} answer <q> --body "..."\` · \`${cmd} implement-done [--pr <url>] [--failed]\` ·
-  \`${cmd} status\` · \`${cmd} open\`
+  \`${cmd} status\` · \`${cmd} open\` · \`${cmd} config [get <key>]\`
 
 ## Implement loop (on \`approved\` with \`implement:true\`)
 
@@ -88,10 +91,14 @@ You are the **orchestrator**: you only coordinate and narrate
 (\`${cmd} progress\` at each checkpoint) — every phase's real work runs in a fresh
 native subagent (Task tool) so your own context stays lean.
 
-1. **Setup.** Commit the plan file at the event \`path\` (exactly as plain Approve),
-   then \`git worktree add .otacon/worktrees/<slug> -b otacon/impl-<slug>\` off that
-   commit (\`.otacon/\` is gitignored). \`${cmd} progress\` each checkpoint throughout.
-2. **Per phase, in order** (read the phases from the committed plan):
+1. **Setup.** On Implement the plan lives only in the home archive at the event
+   \`path\` (read the phases from there). Branch off the repo's current default branch
+   HEAD: create the
+   worktree under the configured \`worktree.dir\`
+   (\`${cmd} config get worktree.dir\` — default \`~/.otacon/worktrees\`, outside the repo):
+   \`git worktree add <worktree.dir>/<slug> -b otacon/impl-<slug>\` (off the default
+   branch). \`${cmd} progress\` each checkpoint throughout.
+2. **Per phase, in order** (read the phases from the home plan at the event \`path\`):
    - \`${cmd} progress "phase N — implementing"\`; spawn an **implement+test**
      subagent (Task tool) scoped to that phase's Goal/Files/Verification — it
      implements and runs the phase Verification plus the repo gates.
@@ -102,14 +109,10 @@ native subagent (Task tool) so your own context stays lean.
      review still flags, or a subagent is stuck) → on the FIRST blocker,
      \`${cmd} ask\` with options \`retry|skip|abort|guidance\`, park in \`${cmd} wait\`,
      and act on the answer. No auto-retry.
-3. **Finish.** On success, \`git mv\` the committed plan (the \`approved\` event's
-   \`path\`) into \`docs/plans/archive/\` and commit it on the impl branch, so the
-   archived plan rides along in the PR (it only takes effect on the default branch
-   when the PR merges). Then \`gh pr create\` against the default branch (PR body =
-   the plan summary + the per-phase log; fall back to the local branch + path when
-   there is no remote), then \`${cmd} implement-done --pr <url>\`. On abort, skip the
-   archive move (leave the plan in \`docs/plans/\` so it stays active) and run
-   \`${cmd} implement-done --failed\`.
+3. **Finish.** On success, open a PR against the default branch with \`gh pr create\`
+   (PR body = the plan summary + the per-phase log; fall back to the local branch +
+   path when there is no remote), then \`${cmd} implement-done --pr <url>\`. On abort,
+   run \`${cmd} implement-done --failed\`.
 
 While \`implementing\` the Stop hook still keeps you on the line — never end the turn
 until \`implement-done\`.
@@ -184,11 +187,11 @@ than a sentence — never as decoration.
   while the session runs.
 `;
 }
-/** ~/.claude/skills/otacon/SKILL.md and the OpenCode equivalent (same format). */
+/** The SKILL.md every agent's skills dir gets (Claude, Codex, OpenCode — same format). */
 export function skillMd() {
     return `---
 name: otacon
-description: Plan a feature through an otacon review session — grill interview, schema'd plan, phone review with anchored comments, approved committed artifact. Use when the user asks to plan something with otacon, types /otacon, or wants a reviewed implementation plan before coding. Replaces native plan mode.
+description: Plan a feature through an otacon review session — grill interview, schema'd plan, phone review with anchored comments, approved plan saved to a home archive (and your project on Save). Use when the user asks to plan something with otacon, types /otacon, or wants a reviewed implementation plan before coding. Replaces native plan mode.
 ---
 
 <!-- ${MANAGED_MARKER} — reinstall overwrites this file; the spec lives in otacon's DESIGN.md -->
@@ -197,18 +200,6 @@ description: Plan a feature through an otacon review session — grill interview
 
 ${protocolCard('otacon')}`;
 }
-/** The marker-delimited block upserted into ~/.codex/AGENTS.md. */
-export function codexBlock() {
-    return `${CODEX_BEGIN}
-
-# Otacon plan sessions
-
-When the user asks you to plan a feature "with otacon" (or to run a plan
-review), follow this protocol exactly.
-
-${protocolCard('otacon')}
-${CODEX_END}`;
-}
 /**
  * THIS repo's dogfood wrapper — the committed \`.claude/skills/otacon/SKILL.md\`
  * (DESIGN.md §16). It is the same protocol card as \`skillMd()\`, but with the
@@ -221,7 +212,7 @@ ${CODEX_END}`;
 export function dogfoodSkillMd() {
     return `---
 name: otacon
-description: Plan a feature for THIS repo through an otacon review session — grill interview, schema'd plan, browser/phone review with anchored comments, approved committed artifact. Use when the user asks to plan something with otacon, types /otacon, or wants a reviewed implementation plan before coding. Replaces native plan mode. Dogfoods otacon on its own development.
+description: Plan a feature for THIS repo through an otacon review session — grill interview, schema'd plan, browser/phone review with anchored comments, approved plan saved to a home archive (and your project on Save). Use when the user asks to plan something with otacon, types /otacon, or wants a reviewed implementation plan before coding. Replaces native plan mode. Dogfoods otacon on its own development.
 ---
 
 <!-- Generated from src/cli/install/assets.ts (dogfoodSkillMd) — do NOT hand-edit;
@@ -234,8 +225,9 @@ This repo **is** otacon. You plan features for it by running otacon's own CLI fr
 source via the \`./bin/otacon\` shim, so every command below exercises the code in
 this checkout. That shim runs the CLI from \`src/\` via bun — no build needed; it
 always reflects current source. The daemon auto-spawns from source on the first
-command. Working state lives in the gitignored \`.otacon/\`; the approved plan is
-committed to \`docs/plans/\`.
+command. Working state lives in \`.otacon/\`; the approved plan is archived in the
+home store (\`~/.otacon/sessions/<id>/\`) and, on Save, copied into the repo under
+\`plans.dir\` (default \`.otacon/plans\`).
 
 After editing **daemon** source (\`src/daemon/**\`) mid-session, restart the running
 daemon so your change loads: \`./bin/otacon restart\` (the next command respawns it

package/dist/cli/install/assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../src/cli/install/assets.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8EAA8E;AAC9E,+EAA+E;AAC/E,gFAAgF;AAChF,gFAAgF;AAChF,sEAAsE;AACtE,yEAAyE;AAEzE,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAE5D,MAAM,CAAC,MAAM,WAAW,GACtB,+GAA+G,CAAC;AAClH,MAAM,CAAC,MAAM,SAAS,GAAG,qBAAqB,CAAC;AAE/C;;;;;;;GAOG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO;qCAC4B,GAAG;;;;;;OAMjC,GAAG;wEAC8D,GAAG;;;;OAIpE,GAAG;;;;;;;;;;SAUD,GAAG;;;;;eAKG,GAAG;;;;8BAIY,GAAG;;;OAG1B,GAAG;;iCAEuB,GAAG;;;;uCAIG,GAAG;;wBAElB,GAAG;;;;;;;;;;;;OAYpB,GAAG,qDAAqD,GAAG;;;;;MAK5D,GAAG,sCAAsC,GAAG;MAC5C,GAAG,kBAAkB,GAAG,6BAA6B,GAAG;MACxD,GAAG,kCAAkC,GAAG;MACxC,GAAG,iBAAiB,GAAG;;;;;KAKxB,GAAG;;;;;4CAKoC,GAAG;;SAEtC,GAAG;;;;;;;;SAQH,GAAG,gEAAgE,GAAG;;;;;;;iCAO9C,GAAG;;OAE7B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wDAsE8C,GAAG;;;CAG1D,CAAC;AACF,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,OAAO;IACrB,OAAO;;;;;OAKF,cAAc;;;;EAInB,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC3B,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,UAAU;IACxB,OAAO,GAAG,WAAW;;;;;;;EAOrB,YAAY,CAAC,QAAQ,CAAC;EACtB,SAAS,EAAE,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6BP,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;uBACT,cAAc;;;;;;;;;;;;;;;;;;;;;CAqBpC,CAAC"}
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../src/cli/install/assets.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8EAA8E;AAC9E,+EAA+E;AAC/E,yEAAyE;AACzE,2EAA2E;AAC3E,gFAAgF;AAChF,iCAAiC;AAEjC,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAE5D;;;;;;;GAOG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO;qCAC4B,GAAG;;;;;;OAMjC,GAAG;wEAC8D,GAAG;;;;OAIpE,GAAG;;;;;;;;;;SAUD,GAAG;;;;;eAKG,GAAG;;;;8BAIY,GAAG;;;OAG1B,GAAG;;iCAEuB,GAAG;;;;uCAIG,GAAG;;;;;;wBAMlB,GAAG;;;;;;;;;;;;;OAapB,GAAG,qDAAqD,GAAG;;;;;MAK5D,GAAG,sCAAsC,GAAG;MAC5C,GAAG,kBAAkB,GAAG,6BAA6B,GAAG;MACxD,GAAG,kCAAkC,GAAG;MACxC,GAAG,iBAAiB,GAAG,eAAe,GAAG;;;;;KAK1C,GAAG;;;;;;;QAOA,GAAG;;gBAEK,GAAG;;SAEV,GAAG;;;;;;;;SAQH,GAAG,gEAAgE,GAAG;;;;2CAIpC,GAAG;WACnC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wDAsE0C,GAAG;;;CAG1D,CAAC;AACF,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,OAAO;IACrB,OAAO;;;;;OAKF,cAAc;;;;EAInB,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BP,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;uBACT,cAAc;;;;;;;;;;;;;;;;;;;;;CAqBpC,CAAC"}

package/dist/cli/install/locations.js

@@ -5,8 +5,9 @@
 import { readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
-export function claudeSkillPath() {
-    return join(homedir(), ".claude", "skills", "otacon", "SKILL.md");
+export function claudeSkillPath(scope = { kind: "user" }) {
+    const base = scope.kind === "project" ? scope.root : homedir();
+    return join(base, ".claude", "skills", "otacon", "SKILL.md");
 }
 /** The Stop hook script install writes; settings.json references it by this path. */
 export function claudeHookScriptPath() {
@@ -15,30 +16,19 @@ export function claudeHookScriptPath() {
 export function claudeSettingsPath() {
     return join(homedir(), ".claude", "settings.json");
 }
-/** Codex's global instructions file ($CODEX_HOME, default ~/.codex). */
-export function codexAgentsPath() {
-    return join(process.env.CODEX_HOME ?? join(homedir(), ".codex"), "AGENTS.md");
+/** Codex's skills dir — user: $CODEX_HOME (default ~/.codex); project: <root>/.codex. */
+export function codexSkillPath(scope = { kind: "user" }) {
+    const base = scope.kind === "project"
+        ? join(scope.root, ".codex")
+        : (process.env.CODEX_HOME ?? join(homedir(), ".codex"));
+    return join(base, "skills", "otacon", "SKILL.md");
 }
-/** OpenCode's global skills dir ($XDG_CONFIG_HOME, default ~/.config). */
-export function opencodeSkillPath() {
-    return join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "opencode", "skills", "otacon", "SKILL.md");
-}
-/**
- * Replace the marker-delimited block in `existing` with `block` (which carries
- * its own begin/end lines), or append it when no markers are present. User
- * content outside the markers survives byte-for-byte; re-running with the same
- * block is a fixpoint (the idempotent-reinstall contract).
- */
-export function upsertMarkedBlock(existing, block, begin, end) {
-    const from = existing.indexOf(begin);
-    const to = existing.indexOf(end);
-    if (from !== -1 && to !== -1 && to > from) {
-        return existing.slice(0, from) + block + existing.slice(to + end.length);
-    }
-    if (existing.trim() === "")
-        return `${block}\n`;
-    const separator = existing.endsWith("\n") ? "\n" : "\n\n";
-    return `${existing}${separator}${block}\n`;
+/** OpenCode's skills dir — user: $XDG_CONFIG_HOME/opencode (default ~/.config); project: <root>/.opencode. */
+export function opencodeSkillPath(scope = { kind: "user" }) {
+    const base = scope.kind === "project"
+        ? join(scope.root, ".opencode")
+        : join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "opencode");
+    return join(base, "skills", "otacon", "SKILL.md");
 }
 /**
  * Whether ~/.claude/settings.json currently registers the otacon Stop hook