@basou/cli 0.48.1 → 0.50.0

package/dist/index.js

@@ -2467,26 +2467,36 @@ import { join as join10 } from "path";
 import { fileURLToPath } from "url";
 import { promisify } from "util";
 import {
+  basouPaths as basouPaths10,
   buildSessionStartHookCommand,
   buildStopHookCommand,
   DEFAULT_STOP_HOOK_MIN_EDITS,
   evaluateStopHook,
   findBasouSessionStartHook,
   findBasouStopHookCommand,
+  findClaudeSessionStartHooks,
+  findUnrecognizedSessionStart,
+  isClaudeSessionStartMalformed,
   isProtocolUpdateDue,
   ORIENTATION_END as ORIENTATION_END2,
   ORIENTATION_START as ORIENTATION_START2,
+  observedRepoRoots,
+  observeSessionChanges,
   PROTOCOL_END,
   PROTOCOL_START,
   parseMarkers as parseMarkers2,
   parseProtocolStamp,
   protocolSectionsFrom,
   protocolUpdateToken,
+  readManifest as readManifest5,
   readMarkdownFile as readMarkdownFile6,
+  recordSessionBaseline,
+  removeClaudeSessionStartHook,
   removeSessionStartHook,
   removeStopHook,
   renderProtocolUpdate,
   transcriptStartedAt,
+  upsertClaudeSessionStartHook,
   upsertSessionStartHook,
   upsertStopHook
 } from "@basou/core";
@@ -2911,7 +2921,9 @@ import {
   enumerateSessionDirs,
   findErrorCode as findErrorCode5,
   importSessionFromJson,
+  observedFilesOf,
   readManifest as readManifest4,
+  readSessionObservation,
   readSessionYaml as readSessionYaml2,
   reimportPreservingId,
   resolveRepositoryRoot as resolveRepositoryRoot5,
@@ -2996,10 +3008,13 @@ async function doRunImportClaudeCode(options, ctx) {
         const { records, sizeBytes } = await readJsonlRecords(file);
         const cwd = firstTranscriptCwd(records);
         if (cwd === void 0 || !projectSet.has(cwd)) return null;
+        const observation = await readSessionObservation(paths.observations, externalId);
+        const observedFiles = observation === null ? [] : observedFilesOf(observation);
         return claudeTranscriptToImportPayload(records, {
           workspaceId: manifest.workspace.id,
           externalId,
-          sourceSizeBytes: sizeBytes
+          sourceSizeBytes: sizeBytes,
+          ...observedFiles.length > 0 ? { observedFiles } : {}
         });
       }
     };
@@ -3832,11 +3847,14 @@ function registerHookCommand(program2) {
     });
   });
   hook.command("install [target]").description(
-    "Register a basou hook (reproducible, idempotent). Target `claude` (default): the Stop hook in ~/.claude/settings.json \u2014 advisory capture-only by default; --block opts into in-turn enforcement, --require-review into the review gate. Target `codex`: the SessionStart hook in ~/.codex/hooks.json, which hands each Codex session the position of the workspace it was opened in. Codex asks you to review and trust a new hook once before it runs."
+    "Register a basou hook (reproducible, idempotent). Target `claude` (default): the Stop hook and the SessionStart hook in ~/.claude/settings.json. The Stop hook is advisory capture-only by default; --block opts into in-turn enforcement, --require-review into the review gate. The SessionStart hook hands each session the workspace's position and records the git baseline the Stop hook measures the session's file changes against; --no-session-start leaves it out. Target `codex`: the SessionStart hook in ~/.codex/hooks.json, which hands each Codex session the position of the workspace it was opened in. Codex asks you to review and trust a new hook once before it runs."
   ).option(
     "--block",
     "claude: register the blocking (opt-in enforcement) form instead of advisory"
-  ).option("--require-review", "claude: register with the opt-in review gate enabled").option("--min-edits <n>", "claude: pass a custom file-edit threshold to the registered hook").option("--settings <path>", "claude: override the settings.json path (intended for tests)").option("--hooks <path>", "codex: override the hooks.json path (intended for tests)").option(
+  ).option("--require-review", "claude: register with the opt-in review gate enabled").option("--min-edits <n>", "claude: pass a custom file-edit threshold to the registered hook").option(
+    "--no-session-start",
+    "claude: register the Stop hook only, and leave any SessionStart hook as it is"
+  ).option("--settings <path>", "claude: override the settings.json path (intended for tests)").option("--hooks <path>", "codex: override the hooks.json path (intended for tests)").option(
     "--codex-config <path>",
     "codex: override the Codex config.toml path (intended for tests)"
   ).option(
@@ -3845,11 +3863,23 @@ function registerHookCommand(program2) {
   ).option("--dry-run", "Print what would change without writing").option("-v, --verbose", "Show error causes").action(async (target, opts) => {
     await dispatchHookTarget(target, opts, {
       claude: () => runHookInstall(opts),
-      codex: () => runCodexHookInstall(opts)
+      codex: async () => {
+        if (opts.sessionStart === false) {
+          renderCliError(
+            new Error(
+              "--no-session-start applies to target claude only; the Codex hook is itself a SessionStart hook."
+            ),
+            { verbose: isVerbose(opts) }
+          );
+          process.exitCode = 1;
+          return;
+        }
+        await runCodexHookInstall(opts);
+      }
     });
   });
   hook.command("uninstall [target]").description(
-    "Remove a basou hook, leaving other hooks intact. Target `claude` (default): the Stop hook in ~/.claude/settings.json. Target `codex`: the SessionStart hook in ~/.codex/hooks.json."
+    "Remove a basou hook, leaving other hooks intact. Target `claude` (default): the Stop hook and the SessionStart hook in ~/.claude/settings.json. Target `codex`: the SessionStart hook in ~/.codex/hooks.json."
   ).option("--settings <path>", "claude: override the settings.json path (intended for tests)").option("--hooks <path>", "codex: override the hooks.json path (intended for tests)").option("--dry-run", "Print what would change without writing").option("-v, --verbose", "Show error causes").action(async (target, opts) => {
     await dispatchHookTarget(target, opts, {
       claude: () => runHookUninstall(opts),
@@ -3857,7 +3887,7 @@ function registerHookCommand(program2) {
     });
   });
   hook.command("status [target]").description(
-    "Report whether a basou hook is registered. Target `claude` (default): the Stop hook and its mode. Target `codex`: the SessionStart hook, and whether Codex has trusted it yet."
+    "Report whether a basou hook is registered. Target `claude` (default): the Stop hook and its mode, and the SessionStart hook. Target `codex`: the SessionStart hook, and whether Codex has trusted it yet."
   ).option("--settings <path>", "claude: override the settings.json path (intended for tests)").option("--hooks <path>", "codex: override the hooks.json path (intended for tests)").option(
     "--codex-config <path>",
     "codex: override the Codex config.toml path (intended for tests)"
@@ -3905,9 +3935,11 @@ becomes the session's trusted context, so it withholds the position instead.
 Run 'basou refresh' to see which lines are responsible.
 
 Claude Code's SessionStart hook sends the same kind of payload (a JSON object
-with 'cwd') and adds stdout to context the same way, so a Claude Code user may
-register this command in ~/.claude/settings.json in place of 'basou orient' to
-get both gates. basou does not install that one.
+with 'cwd') and adds stdout to context the same way. 'basou hook install'
+registers this command there too, in ~/.claude/settings.json, and replaces a
+hand-registered 'basou orient' SessionStart hook with it. In Claude Code it also
+records where each declared repository stood when the session started, which is
+what the Stop hook measures the session's file changes against.
 
 Codex trusts hooks by hash. A newly installed or changed hook is skipped until
 you review it: the interactive CLI asks at startup ("Hooks need review"), the
@@ -3972,6 +4004,8 @@ async function doRunHookStop(options, ctx) {
   }
   if (typeof payload !== "object" || payload === null) return;
   const fields = payload;
+  const observe = ctx.observe ?? observeSessionFromPayload;
+  await observe(fields, "changes", ctx.portfolioConfigPath).catch(() => void 0);
   if (fields.stop_hook_active === true) return;
   const transcriptPath = typeof fields.transcript_path === "string" ? fields.transcript_path : "";
   if (transcriptPath.length === 0) return;
@@ -4110,8 +4144,11 @@ async function doRunHookSessionStart(ctx) {
     return;
   }
   if (typeof payload !== "object" || payload === null) return;
-  const cwd = payload.cwd;
+  const fields = payload;
+  const cwd = fields.cwd;
   if (typeof cwd !== "string" || cwd.length === 0) return;
+  const observe = ctx.observe ?? observeSessionFromPayload;
+  await observe(fields, "baseline", ctx.portfolioConfigPath).catch(() => void 0);
   let body;
   try {
     body = (await render(cwd)).body;
@@ -4122,6 +4159,38 @@ async function doRunHookSessionStart(ctx) {
   write(`${body.replace(/\s+$/, "")}
 `);
 }
+async function observeSessionFromPayload(fields, pass, portfolioConfigPath) {
+  const externalId = typeof fields.session_id === "string" ? fields.session_id : "";
+  const cwd = typeof fields.cwd === "string" ? fields.cwd : "";
+  if (externalId.length === 0 || cwd.length === 0) return;
+  const configPath = portfolioConfigPath ?? DEFAULT_PORTFOLIO_CONFIG_PATH;
+  let root;
+  try {
+    root = await resolveBasouRootForCommand(cwd, "hook observe", {
+      portfolioConfigPath: configPath
+    });
+  } catch {
+    return;
+  }
+  if (!await isRegisteredWorkspace(root, configPath)) return;
+  const paths = basouPaths10(root);
+  const nowIso = (/* @__PURE__ */ new Date()).toISOString();
+  if (pass === "changes") {
+    await observeSessionChanges({
+      observationsDir: paths.observations,
+      externalId,
+      nowIso
+    });
+    return;
+  }
+  const manifest = await readManifest5(paths);
+  await recordSessionBaseline({
+    observationsDir: paths.observations,
+    repoRoots: observedRepoRoots(root, manifest),
+    externalId,
+    nowIso
+  });
+}
 function parseTranscript(transcript) {
   const records = [];
   for (const line of transcript.split(/\r?\n/)) {
@@ -4184,6 +4253,7 @@ function normalizeInstallOptions(raw) {
   const out = {};
   if (raw.block === true) out.block = true;
   if (raw.requireReview === true) out.requireReview = true;
+  if (raw.sessionStart === false) out.noSessionStart = true;
   if (raw.settings !== void 0) out.settings = raw.settings;
   if (raw.hooks !== void 0) out.hooks = raw.hooks;
   if (raw.codexConfig !== void 0) out.codexConfig = raw.codexConfig;
@@ -4255,15 +4325,32 @@ async function doRunHookInstall(options, ctx = {}) {
   });
   await assertNotSymlink(settingsPath);
   const { raw, parsed } = await readSettings(settingsPath);
-  const { settings, action } = upsertStopHook(parsed, command);
-  const newBody = `${JSON.stringify(settings, null, 2)}
-`;
-  if (raw !== null && newBody === raw) {
-    console.log(`The basou Stop hook is already registered (${mode}); no change.`);
-    return;
+  const stop = upsertStopHook(parsed, command);
+  let sessionStart;
+  if (options.noSessionStart === true) {
+    sessionStart = { kind: "skipped" };
+  } else {
+    try {
+      const upsert = upsertClaudeSessionStartHook(
+        stop.settings,
+        buildSessionStartHookCommand({ cliEntry })
+      );
+      sessionStart = { kind: "done", action: upsert.action, settings: upsert.settings };
+    } catch (error) {
+      if (!isClaudeSessionStartMalformed(stop.settings)) throw error;
+      sessionStart = { kind: "malformed" };
+    }
   }
-  if (options.dryRun === true) {
-    console.log(`[dry-run] Would ${action} the basou Stop hook (${mode}).`);
+  const settings = sessionStart.kind === "done" ? sessionStart.settings : stop.settings;
+  const changed = stop.action !== "unchanged" || sessionStart.kind === "done" && sessionStart.action !== "unchanged";
+  const dryRun = options.dryRun === true;
+  const lines = [
+    describeStopInstall(stop.action, mode, dryRun),
+    describeSessionStartInstall(sessionStart, dryRun),
+    ...describeSessionStartLeftovers(settings)
+  ];
+  if (!changed || dryRun) {
+    for (const line of lines) console.log(line);
     return;
   }
   const recheck = await readSettings(settingsPath);
@@ -4273,8 +4360,55 @@ async function doRunHookInstall(options, ctx = {}) {
     );
   }
   await backupSettingsOnce(settingsPath, raw);
-  await writeFileDurable(settingsPath, newBody);
-  console.log(`${action === "installed" ? "Installed" : "Updated"} the basou Stop hook (${mode}).`);
+  await writeFileDurable(settingsPath, `${JSON.stringify(settings, null, 2)}
+`);
+  for (const line of lines) console.log(line);
+}
+function describeStopInstall(action, mode, dryRun) {
+  if (action === "unchanged") {
+    return `The basou Stop hook is already registered (${mode}); no change.`;
+  }
+  if (dryRun) {
+    return `[dry-run] Would ${action === "installed" ? "install" : "update"} the basou Stop hook (${mode}).`;
+  }
+  return `${action === "installed" ? "Installed" : "Updated"} the basou Stop hook (${mode}).`;
+}
+function describeSessionStartInstall(outcome, dryRun) {
+  if (outcome.kind === "skipped") {
+    return "The SessionStart hook was left as it is (--no-session-start).";
+  }
+  if (outcome.kind === "malformed") {
+    return "The basou SessionStart hook was NOT installed: 'hooks.SessionStart' in settings.json is not a list of hook groups. Fix it and re-run 'basou hook install'.";
+  }
+  const action = outcome.action;
+  if (action === "unchanged") {
+    return "The basou SessionStart hook is already registered; no change.";
+  }
+  const prefix = dryRun ? "[dry-run] Would " : "";
+  if (action === "replaced") {
+    return `${prefix}${dryRun ? "replace" : "Replaced"} the hand-registered 'basou orient' SessionStart hook with 'basou hook session-start': the same position, plus the baseline the Stop hook measures the session's file changes against. It differs in three ways: it speaks only for a workspace registered in ~/.basou/portfolio.yaml, it does not rewrite .basou/orientation.md at session start, and it stays silent when the position names another registered workspace.`;
+  }
+  if (action === "updated") {
+    return `${prefix}${dryRun ? "update" : "Updated"} the basou SessionStart hook.`;
+  }
+  return `${prefix}${dryRun ? "install" : "Installed"} the basou SessionStart hook: each session gets the workspace's position, and the Stop hook can see the files the session changes through the shell.`;
+}
+function describeSessionStartLeftovers(settings) {
+  const own = findClaudeSessionStartHooks(settings);
+  if (own.length === 0) return [];
+  const lines = [];
+  for (const other of findUnrecognizedSessionStart(settings)) {
+    lines.push(
+      `note: this SessionStart hook runs basou '${other.runs === "orient" ? "orient" : "hook session-start"}' inside a longer command, so it was left as written, and a session may receive the position twice: ${other.command}`
+    );
+  }
+  if (own.length > 1) {
+    const matchers = own.map((o) => o.matcher ?? "(every source)").join(", ");
+    lines.push(
+      `note: ${own.length} basou SessionStart hooks remain, under different matchers (${matchers}). They were kept so that no session source stops firing; a source that more than one matches receives the position twice. Remove the one you do not want by hand.`
+    );
+  }
+  return lines;
 }
 async function runHookUninstall(options) {
   try {
@@ -4292,15 +4426,22 @@ async function doRunHookUninstall(options) {
     console.log("No settings.json; nothing to remove.");
     return;
   }
-  const { settings, action } = removeStopHook(parsed);
-  if (action === "absent") {
-    console.log("No basou Stop hook found; nothing removed.");
+  const stop = removeStopHook(parsed);
+  const sessionStart = removeClaudeSessionStartHook(stop.settings);
+  if (stop.action === "absent" && sessionStart.action === "absent") {
+    console.log("No basou Stop hook or SessionStart hook found; nothing removed.");
     return;
   }
-  const newBody = `${JSON.stringify(settings, null, 2)}
+  const newBody = `${JSON.stringify(sessionStart.settings, null, 2)}
 `;
+  const removedNames = [
+    ...stop.action === "removed" ? ["Stop hook"] : [],
+    ...sessionStart.action === "removed" ? ["SessionStart hook"] : []
+  ];
   if (options.dryRun === true) {
-    console.log("[dry-run] Would remove the basou Stop hook from settings.json.");
+    for (const name of removedNames) {
+      console.log(`[dry-run] Would remove the basou ${name} from settings.json.`);
+    }
     return;
   }
   const recheck = await readSettings(settingsPath);
@@ -4311,7 +4452,9 @@ async function doRunHookUninstall(options) {
   }
   await backupSettingsOnce(settingsPath, raw);
   await writeFileDurable(settingsPath, newBody);
-  console.log("Removed the basou Stop hook from settings.json.");
+  for (const name of removedNames) {
+    console.log(`Removed the basou ${name} from settings.json.`);
+  }
 }
 async function runHookStatus(options) {
   try {
@@ -4327,14 +4470,49 @@ async function doRunHookStatus(options) {
   const command = findBasouStopHookCommand(parsed);
   if (command === null) {
     console.log("basou Stop hook: not registered. Run 'basou hook install' to register it.");
+  } else {
+    const mode = describeHookMode({
+      block: / --block\b/.test(command),
+      review: / --require-review\b/.test(command)
+    });
+    console.log(`basou Stop hook: registered, ${mode}.`);
+    await reportHookEntryBuild(command);
+  }
+  reportSessionStartStatus(parsed);
+}
+function reportSessionStartStatus(parsed) {
+  if (isClaudeSessionStartMalformed(parsed)) {
+    console.log(
+      "basou SessionStart hook: cannot tell -- 'hooks.SessionStart' in settings.json is not a list of hook groups."
+    );
     return;
   }
-  const mode = describeHookMode({
-    block: / --block\b/.test(command),
-    review: / --require-review\b/.test(command)
-  });
-  console.log(`basou Stop hook: registered, ${mode}.`);
-  await reportHookEntryBuild(command);
+  const own = findClaudeSessionStartHooks(parsed);
+  const others = findUnrecognizedSessionStart(parsed);
+  for (const hook of own.filter((o) => o.kind === "session-start")) {
+    console.log(`basou SessionStart hook: registered, fires ${describeFiring(hook.matcher)}.`);
+  }
+  for (const hook of own.filter((o) => o.kind === "orient")) {
+    console.log(
+      `basou SessionStart hook: 'basou orient' registered by hand, fires ${describeFiring(hook.matcher)}. It delivers the position but records no git baseline, so the files a session changes through the shell are not observed; 'basou hook install' replaces it with 'basou hook session-start'.`
+    );
+  }
+  if (own.length === 0) {
+    if (others.length === 0) {
+      console.log(
+        "basou SessionStart hook: not registered. Sessions get no position at start, and the files a session changes through the shell are not observed. Run 'basou hook install' to register it."
+      );
+    }
+    for (const other of others) {
+      console.log(
+        other.runs === "orient" ? `basou SessionStart hook: not registered by basou. A SessionStart hook runs 'basou orient' inside a longer command, so sessions may get the position, but no git baseline is recorded: ${other.command}` : `basou SessionStart hook: not registered by basou. A SessionStart hook runs 'basou hook session-start' inside a longer command, which basou leaves as written: ${other.command}`
+      );
+    }
+  }
+  for (const line of describeSessionStartLeftovers(parsed)) console.log(line);
+}
+function describeFiring(matcher) {
+  return matcher === void 0 || matcher === "" || matcher === "*" ? "on every session source" : `on ${matcher}`;
 }
 async function reportHookEntryBuild(command) {
   console.log(`  this basou is: ${BASOU_VERSION_LINE}`);
@@ -4700,12 +4878,12 @@ import {
   acquireLock as acquireLock4,
   appendEventToExistingSession as appendEventToExistingSession2,
   assertBasouRootSafe as assertBasouRootSafe8,
-  basouPaths as basouPaths10,
+  basouPaths as basouPaths11,
   createAdHocSessionWithEvent as createAdHocSessionWithEvent2,
   EVENT_SCHEMA_VERSION as EVENT_SCHEMA_VERSION4,
   findErrorCode as findErrorCode7,
   LOCAL_CLI_EVENT_SOURCE as LOCAL_CLI_EVENT_SOURCE3,
-  readManifest as readManifest5,
+  readManifest as readManifest6,
   resolveSessionId as resolveSessionId2
 } from "@basou/core";
 import { InvalidArgumentError as InvalidArgumentError3 } from "commander";
@@ -4755,7 +4933,7 @@ async function doRunNote(body, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "note");
-  const paths = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   await assertWorkspaceInitialized7(paths.root);
   const now = ctx.nowProvider !== void 0 ? ctx.nowProvider() : /* @__PURE__ */ new Date();
   const occurredAt = now.toISOString();
@@ -4782,7 +4960,7 @@ async function doRunNote(body, options, ctx) {
     });
     return;
   }
-  const manifest = await readManifest5(paths);
+  const manifest = await readManifest6(paths);
   const adHoc = await createAdHocSessionWithEvent2({
     paths,
     manifest,
@@ -4978,7 +5156,7 @@ import {
 import { basename as basename6, dirname as dirname4, isAbsolute as isAbsolute4, join as join12, relative as relative2, resolve as resolve8 } from "path";
 import {
   appendBasouGitignore as appendBasouGitignore2,
-  basouPaths as basouPaths11,
+  basouPaths as basouPaths12,
   classifyRetrofit,
   createManifest as createManifest2,
   ensureBasouDirectory as ensureBasouDirectory2,
@@ -4993,7 +5171,7 @@ import {
   planRename,
   planRosterAdoption,
   planWorkspaceView,
-  readManifest as readManifest6,
+  readManifest as readManifest7,
   readMarkdownFile as readMarkdownFile7,
   reconcileSourceRoots,
   removeMarkerSection as removeMarkerSection2,
@@ -5141,8 +5319,8 @@ function preservedUnknownLines(fields) {
 async function doRunProjectCheck(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project check");
-  const paths = basouPaths11(repositoryRoot);
-  const manifest = await readManifest6(paths);
+  const paths = basouPaths12(repositoryRoot);
+  const manifest = await readManifest7(paths);
   const roster = summarizeRosterDrift({
     ...manifest.repos !== void 0 ? { repos: manifest.repos } : {},
     sourceRoots: effectiveSourceRoots(manifest)
@@ -5276,8 +5454,8 @@ async function runProjectSync(options, ctx = {}) {
 async function doRunProjectSync(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project sync");
-  const paths = basouPaths11(repositoryRoot);
-  const manifest = await readManifest6(paths);
+  const paths = basouPaths12(repositoryRoot);
+  const manifest = await readManifest7(paths);
   const hasRoster = manifest.repos !== void 0 && manifest.repos.length > 0;
   const reconcile = reconcileSourceRoots({
     ...manifest.repos !== void 0 ? { repos: manifest.repos } : {},
@@ -5362,8 +5540,8 @@ function classifySourceRoot(repositoryRoot, declaredPath) {
 async function doRunProjectAdopt(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project adopt");
-  const paths = basouPaths11(repositoryRoot);
-  const manifest = await readManifest6(paths);
+  const paths = basouPaths12(repositoryRoot);
+  const manifest = await readManifest7(paths);
   const alreadyDeclared = manifest.repos !== void 0 && manifest.repos.length > 0;
   const candidates = effectiveSourceRoots(manifest).map(
     (r) => classifySourceRoot(repositoryRoot, r)
@@ -5484,8 +5662,8 @@ async function gatherRepoWiring(repositoryRoot, entry) {
 async function doRunProjectWiring(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project wiring");
-  const paths = basouPaths11(repositoryRoot);
-  const manifest = await readManifest6(paths);
+  const paths = basouPaths12(repositoryRoot);
+  const manifest = await readManifest7(paths);
   const roster = manifest.repos ?? [];
   const facts = [];
   for (const entry of roster) facts.push(await gatherRepoWiring(repositoryRoot, entry));
@@ -5617,8 +5795,8 @@ function applyGitignorePlan(repositoryRoot, plan) {
 async function doRunProjectGitignore(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project gitignore");
-  const paths = basouPaths11(repositoryRoot);
-  const manifest = await readManifest6(paths);
+  const paths = basouPaths12(repositoryRoot);
+  const manifest = await readManifest7(paths);
   const roster = manifest.repos ?? [];
   const facts = roster.map((entry) => gatherRepoGitignore(repositoryRoot, entry));
   const summary = planGitignore({ repos: facts, required: [...INSTRUCTION_FILES] });
@@ -5876,8 +6054,8 @@ function applyViewSymlinks(viewDir, files) {
 async function doRunProjectSymlinks(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project symlinks");
-  const paths = basouPaths11(repositoryRoot);
-  const manifest = await readManifest6(paths);
+  const paths = basouPaths12(repositoryRoot);
+  const manifest = await readManifest7(paths);
   const roster = manifest.repos ?? [];
   const anchorReal = realpathSync(repositoryRoot);
   const facts = roster.map((entry) => gatherRepoSymlinks(repositoryRoot, anchorReal, entry));
@@ -6206,8 +6384,8 @@ function pruneViewLinks(viewDir, toPrune, rosterRealpaths) {
 async function doRunProjectWorkspace(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project workspace");
-  const paths = basouPaths11(repositoryRoot);
-  const manifest = await readManifest6(paths);
+  const paths = basouPaths12(repositoryRoot);
+  const manifest = await readManifest7(paths);
   const viewPath = manifest.workspace.view;
   const roster = manifest.repos ?? [];
   let result;
@@ -6566,8 +6744,8 @@ function presetFailureReason(error) {
 async function doRunProjectPreset(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project preset");
-  const paths = basouPaths11(repositoryRoot);
-  const manifest = await readManifest6(paths);
+  const paths = basouPaths12(repositoryRoot);
+  const manifest = await readManifest7(paths);
   const roster = manifest.repos ?? [];
   const anchorReal = realpathSync(repositoryRoot);
   const facts = [];
@@ -7225,8 +7403,8 @@ function renderProjectTeardown(result) {
 async function doRunProjectTeardown(target, options, ctx = {}) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project teardown");
-  const paths = basouPaths11(repositoryRoot);
-  const manifest = await readManifest6(paths);
+  const paths = basouPaths12(repositoryRoot);
+  const manifest = await readManifest7(paths);
   const plan = gatherRepoTeardown(repositoryRoot, manifest, target);
   const willApply = options.apply === true && !plan.isAnchor && plan.removableCount > 0;
   const { removed, failed } = willApply ? applyRepoTeardown(repositoryRoot, manifest, plan) : { removed: [], failed: [] };
@@ -7267,8 +7445,8 @@ function buildArchivedManifest(manifest, plan, updatedAt) {
 async function doRunProjectArchive(target, options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project archive");
-  const paths = basouPaths11(repositoryRoot);
-  const manifest = await readManifest6(paths);
+  const paths = basouPaths12(repositoryRoot);
+  const manifest = await readManifest7(paths);
   const roster = manifest.repos ?? [];
   let targetIsAnchor = false;
   try {
@@ -7424,8 +7602,8 @@ function buildRenamedManifest(manifest, plan, updatedAt) {
 async function doRunProjectRename(oldPath, newPath, options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project rename");
-  const paths = basouPaths11(repositoryRoot);
-  const manifest = await readManifest6(paths);
+  const paths = basouPaths12(repositoryRoot);
+  const manifest = await readManifest7(paths);
   const roster = manifest.repos ?? [];
   let oldIsAnchor = false;
   try {
@@ -7600,7 +7778,7 @@ async function doRunProjectNew(repos, options, ctx) {
   const roster = rosterPaths.map((path) => ({ path }));
   const viewPath = options.view === false ? null : options.view ?? `../${viewStem}-workspace`;
   const sourceRoots = [...rosterPaths, ...viewPath !== null ? [viewPath] : []];
-  const paths = basouPaths11(repositoryRoot);
+  const paths = basouPaths12(repositoryRoot);
   const existed = existsSync2(paths.files.manifest);
   const manifest = createManifest2({
     workspaceName,
@@ -7711,8 +7889,8 @@ async function runProjectDerive(options, ctx = {}) {
 async function doRunProjectDerive(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project derive");
-  const paths = basouPaths11(repositoryRoot);
-  const manifest = await readManifest6(paths);
+  const paths = basouPaths12(repositoryRoot);
+  const manifest = await readManifest7(paths);
   if (manifest.repos === void 0 || manifest.repos.length === 0) {
     console.log(
       "# Generate project wiring in one pass (declaration \u2192 wiring)\n\n\u2139\uFE0F No repo roster declared (manifest `repos`). Declare one first with `basou project new` (new project) or `basou project adopt` (bootstrap from existing source_roots)."
@@ -7752,8 +7930,8 @@ async function doRunProjectDerive(options, ctx) {
 async function doRunProjectSeedAnchor(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project derive");
-  const paths = basouPaths11(repositoryRoot);
-  const manifest = await readManifest6(paths);
+  const paths = basouPaths12(repositoryRoot);
+  const manifest = await readManifest7(paths);
   const roster = manifest.repos ?? [];
   console.log("# Anchor instruction-file seed (the planning master's own AGENTS.md)");
   console.log("");
@@ -7946,8 +8124,8 @@ async function applyViewRetrofit(anchorReal, outcome) {
 async function doRunProjectRetrofit(repo, options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project retrofit");
-  const paths = basouPaths11(repositoryRoot);
-  const manifest = await readManifest6(paths);
+  const paths = basouPaths12(repositoryRoot);
+  const manifest = await readManifest7(paths);
   const roster = manifest.repos ?? [];
   const anchorReal = realpathSync(repositoryRoot);
   const viewPath = manifest.workspace.view;
@@ -8383,9 +8561,9 @@ async function doRunProtocolUnsync(options) {
 // src/commands/refresh.ts
 import {
   assertBasouRootSafe as assertBasouRootSafe9,
-  basouPaths as basouPaths12,
+  basouPaths as basouPaths13,
   findErrorCode as findErrorCode9,
-  readManifest as readManifest7
+  readManifest as readManifest8
 } from "@basou/core";
 import { InvalidArgumentError as InvalidArgumentError4 } from "commander";
 
@@ -8625,7 +8803,7 @@ async function doRunRefreshWatch(options, ctx) {
   if (options.force === true) throw new Error("--watch cannot be combined with --force.");
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "refresh");
-  const paths = basouPaths12(repositoryRoot);
+  const paths = basouPaths13(repositoryRoot);
   await assertWorkspaceInitialized8(paths.root);
   const intervalMs = (options.interval ?? DEFAULT_WATCH_INTERVAL_SEC) * 1e3;
   const controller = new AbortController();
@@ -8653,7 +8831,7 @@ async function doRunRefreshWatch(options, ctx) {
 async function computeRefresh(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "refresh");
-  const paths = basouPaths12(repositoryRoot);
+  const paths = basouPaths13(repositoryRoot);
   await assertWorkspaceInitialized8(paths.root);
   const nowIso = (ctx.nowProvider?.() ?? /* @__PURE__ */ new Date()).toISOString();
   const result = await refreshAll({
@@ -8692,7 +8870,7 @@ async function warnPosition(paths, result, ctx) {
 }
 async function retiredChannelNotice(paths) {
   try {
-    const manifest = await readManifest7(paths);
+    const manifest = await readManifest8(paths);
     if (manifest.channels?.codex !== true) return null;
     return "codex channel: retired \u2014 the manifest's channels.codex is ignored; a Codex session now receives this workspace's position from the SessionStart hook (see `basou hook status codex`), and nothing is written to the user-global ~/.codex/AGENTS.md";
   } catch {
@@ -8762,7 +8940,7 @@ async function assertWorkspaceInitialized8(basouRoot) {
 import { isAbsolute as isAbsolute5, resolve as resolve9 } from "path";
 import {
   assertBasouRootSafe as assertBasouRootSafe10,
-  basouPaths as basouPaths13,
+  basouPaths as basouPaths14,
   findErrorCode as findErrorCode10,
   renderReport,
   resolveRepositoryRoot as resolveRepositoryRoot8,
@@ -8787,7 +8965,7 @@ async function runReportGenerate(options, ctx = {}) {
 async function doRunReportGenerate(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForReport(cwd);
-  const paths = basouPaths13(repositoryRoot);
+  const paths = basouPaths14(repositoryRoot);
   await assertWorkspaceInitialized9(paths.root);
   const nowIso = (ctx.nowProvider?.() ?? /* @__PURE__ */ new Date()).toISOString();
   const result = await renderReport({
@@ -8842,14 +9020,14 @@ import { homedir as homedir10 } from "os";
 import { resolve as resolve10 } from "path";
 import {
   assertBasouRootSafe as assertBasouRootSafe11,
-  basouPaths as basouPaths14,
+  basouPaths as basouPaths15,
   buildReviewRecordedEvent,
   buildReviewRecordLabel,
   createAdHocSessionWithEvent as createAdHocSessionWithEvent3,
   findErrorCode as findErrorCode11,
   findUnbindableRepos,
   parseReviewRecordInput,
-  readManifest as readManifest8,
+  readManifest as readManifest9,
   resolveRepoRoot,
   sanitizePath as sanitizePath2
 } from "@basou/core";
@@ -8924,7 +9102,7 @@ async function runReviewRecord(options, ctx = {}) {
 async function doRunReviewRecord(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "review record");
-  const paths = basouPaths14(repositoryRoot);
+  const paths = basouPaths15(repositoryRoot);
   await assertWorkspaceInitialized10(paths.root);
   const raw = await readReviewInput(options, ctx);
   const review = parseReviewRecordInput(raw);
@@ -8936,7 +9114,7 @@ async function doRunReviewRecord(options, ctx) {
   }
   const now = ctx.nowProvider !== void 0 ? ctx.nowProvider() : /* @__PURE__ */ new Date();
   const occurredAt = now.toISOString();
-  const manifest = await readManifest8(paths);
+  const manifest = await readManifest9(paths);
   const invocationArgs = options.file !== void 0 ? [
     "--file",
     sanitizePath2(resolve10(cwd, options.file), {
@@ -9071,7 +9249,7 @@ async function assertWorkspaceInitialized10(basouRoot) {
 
 // src/commands/review-gaps.ts
 import {
-  basouPaths as basouPaths15,
+  basouPaths as basouPaths16,
   findReviewGaps
 } from "@basou/core";
 import { InvalidArgumentError as InvalidArgumentError5 } from "commander";
@@ -9112,7 +9290,7 @@ async function runReviewGaps(options, ctx = {}) {
 async function doRunReviewGaps(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "review-gaps");
-  const paths = basouPaths15(repositoryRoot);
+  const paths = basouPaths16(repositoryRoot);
   const nowIso = (ctx.nowProvider?.() ?? /* @__PURE__ */ new Date()).toISOString();
   const summary = await findReviewGaps({
     paths,
@@ -9280,7 +9458,7 @@ import { join as join14 } from "path";
 import {
   acquireLock as acquireLock5,
   assertBasouRootSafe as assertBasouRootSafe12,
-  basouPaths as basouPaths16,
+  basouPaths as basouPaths17,
   ChildProcessRunner as ChildProcessRunner2,
   claudeCodeAdapterMetadata,
   codexAdapterMetadata,
@@ -9292,7 +9470,7 @@ import {
   getSnapshot as getSnapshot2,
   overwriteYamlFile as overwriteYamlFile2,
   prefixedUlid as prefixedUlid4,
-  readManifest as readManifest9,
+  readManifest as readManifest10,
   readYamlFile as readYamlFile6,
   resolveClaudeCodeCommand,
   resolveCodexCommand,
@@ -9352,9 +9530,9 @@ async function runTrackedTool(args, options, ctx, adapter) {
   const childArgs = adapter.transformArgs ? adapter.transformArgs(args) : args;
   const cwd = options.cwd ?? process.cwd();
   const repoRoot = await resolveRepositoryRootForRun(cwd);
-  const paths = basouPaths16(repoRoot);
+  const paths = basouPaths17(repoRoot);
   await assertBasouRootSafe12(paths.root);
-  const manifest = await readManifest9(paths);
+  const manifest = await readManifest10(paths);
   const sessionId = prefixedUlid4("ses");
   const sessionDir = join14(paths.sessions, sessionId);
   await mkdir2(sessionDir, { recursive: true });
@@ -9741,7 +9919,7 @@ import {
   acquireLock as acquireLock6,
   appendEventToExistingSession as appendEventToExistingSession3,
   assertBasouRootSafe as assertBasouRootSafe13,
-  basouPaths as basouPaths17,
+  basouPaths as basouPaths18,
   EVENT_SCHEMA_VERSION as EVENT_SCHEMA_VERSION6,
   enumerateSessionDirs as enumerateSessionDirs2,
   findErrorCode as findErrorCode12,
@@ -9749,7 +9927,7 @@ import {
   LOCAL_CLI_EVENT_SOURCE as LOCAL_CLI_EVENT_SOURCE4,
   loadSessionEntries as loadSessionEntries2,
   readAllEvents,
-  readManifest as readManifest10,
+  readManifest as readManifest11,
   readObservedDuration,
   readYamlFile as readYamlFile7,
   rechainSessionInPlace,
@@ -9810,7 +9988,7 @@ async function runSessionList(options, ctx = {}) {
 async function doRunSessionList(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForSession(cwd, "list");
-  const paths = basouPaths17(repositoryRoot);
+  const paths = basouPaths18(repositoryRoot);
   await assertWorkspaceInitialized11(paths.root);
   const now = /* @__PURE__ */ new Date();
   const records = (await loadSessionEntries2(paths, {
@@ -9862,7 +10040,7 @@ async function runSessionShow(idInput, options, ctx = {}) {
 async function doRunSessionShow(idInput, options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForSession(cwd, "show");
-  const paths = basouPaths17(repositoryRoot);
+  const paths = basouPaths18(repositoryRoot);
   await assertWorkspaceInitialized11(paths.root);
   const sessionId = await resolveSessionId3(paths, idInput);
   const sessionDir = join15(paths.sessions, sessionId);
@@ -10174,9 +10352,9 @@ async function runSessionImport(options, ctx = {}) {
 async function doRunSessionImport(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForSession(cwd, "import");
-  const paths = basouPaths17(repositoryRoot);
+  const paths = basouPaths18(repositoryRoot);
   await assertWorkspaceInitialized11(paths.root);
-  const manifest = await readManifest10(paths);
+  const manifest = await readManifest11(paths);
   const rawBody = await readInputFile(options.from);
   const json = parseJsonStrict(rawBody);
   const parsed = SessionImportPayloadSchema2.safeParse(json);
@@ -10290,7 +10468,7 @@ async function doRunSessionNote(sessionIdInput, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForSession(cwd, "note");
-  const paths = basouPaths17(repositoryRoot);
+  const paths = basouPaths18(repositoryRoot);
   await assertWorkspaceInitialized11(paths.root);
   const sessionId = await resolveSessionId3(paths, sessionIdInput);
   const body = hasBody ? options.body : await readNoteFile(options.fromFile);
@@ -10372,7 +10550,7 @@ async function doRunSessionRechain(options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForSession(cwd, "rechain");
-  const paths = basouPaths17(repositoryRoot);
+  const paths = basouPaths18(repositoryRoot);
   await assertWorkspaceInitialized11(paths.root);
   const sessionIds = options.session !== void 0 ? [await resolveSessionId3(paths, options.session)] : await enumerateSessionDirs2(paths);
   const dryRun = options.dryRun === true;
@@ -10427,7 +10605,7 @@ function renderRechainRow(row, dryRun) {
 // src/commands/stats.ts
 import {
   assertBasouRootSafe as assertBasouRootSafe14,
-  basouPaths as basouPaths18,
+  basouPaths as basouPaths19,
   computeWorkStats,
   findErrorCode as findErrorCode13,
   resolveRepositoryRoot as resolveRepositoryRoot10
@@ -10448,7 +10626,7 @@ async function runStats(options, ctx = {}) {
 async function doRunStats(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForStats(cwd);
-  const paths = basouPaths18(repositoryRoot);
+  const paths = basouPaths19(repositoryRoot);
   await assertWorkspaceInitialized12(paths.root);
   const now = ctx.nowProvider?.() ?? /* @__PURE__ */ new Date();
   const result = await computeWorkStats({
@@ -10561,10 +10739,10 @@ async function assertWorkspaceInitialized12(basouRoot) {
 // src/commands/status.ts
 import {
   assertBasouRootSafe as assertBasouRootSafe15,
-  basouPaths as basouPaths19,
+  basouPaths as basouPaths20,
   buildStatusSnapshot,
   findErrorCode as findErrorCode14,
-  readManifest as readManifest11,
+  readManifest as readManifest12,
   resolveRepositoryRoot as resolveRepositoryRoot11,
   writeStatus
 } from "@basou/core";
@@ -10584,7 +10762,7 @@ async function runStatus(options, ctx = {}) {
 async function doRunStatus(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForStatus(cwd);
-  const paths = basouPaths19(repositoryRoot);
+  const paths = basouPaths20(repositoryRoot);
   try {
     await assertBasouRootSafe15(paths.root);
   } catch (error) {
@@ -10595,7 +10773,7 @@ async function doRunStatus(options, ctx) {
   }
   let manifest;
   try {
-    manifest = await readManifest11(paths);
+    manifest = await readManifest12(paths);
   } catch (error) {
     if (findErrorCode14(error, "ENOENT")) {
       throw new Error("Workspace not initialized. Run 'basou init' first.");
@@ -10652,7 +10830,7 @@ import { join as join16 } from "path";
 import {
   archiveTask,
   assertBasouRootSafe as assertBasouRootSafe16,
-  basouPaths as basouPaths20,
+  basouPaths as basouPaths21,
   createTaskWithEvent,
   deleteTask,
   editTask,
@@ -10661,7 +10839,7 @@ import {
   loadSessionEntries as loadSessionEntries3,
   loadTaskEntries,
   prefixedUlid as prefixedUlid5,
-  readManifest as readManifest12,
+  readManifest as readManifest13,
   readTaskFile,
   readTaskFileWithArchiveFallback,
   reconcileAllTasks,
@@ -10753,7 +10931,7 @@ async function doRunTaskNew(options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "new");
-  const paths = basouPaths20(repositoryRoot);
+  const paths = basouPaths21(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
   const description = options.description !== void 0 ? options.description : options.fromFile !== void 0 ? await readDescriptionFile(options.fromFile) : "";
   const now = ctx.nowProvider !== void 0 ? ctx.nowProvider() : /* @__PURE__ */ new Date();
@@ -10788,7 +10966,7 @@ async function doRunTaskNew(options, ctx) {
     });
     return;
   }
-  const manifest = await readManifest12(paths);
+  const manifest = await readManifest13(paths);
   const result = await createTaskWithEvent({
     mode: "ad-hoc",
     paths,
@@ -10862,7 +11040,7 @@ async function runTaskList(options, ctx = {}) {
 async function doRunTaskList(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "list");
-  const paths = basouPaths20(repositoryRoot);
+  const paths = basouPaths21(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
   const entries = await loadTaskEntries(paths, {
     onSkip: (id, reason) => printTaskSkip(id, reason)
@@ -10966,7 +11144,7 @@ async function runTaskShow(idInput, options, ctx = {}) {
 async function doRunTaskShow(idInput, options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "show");
-  const paths = basouPaths20(repositoryRoot);
+  const paths = basouPaths21(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
   const taskId = await resolveTaskId2(paths, idInput, { includeArchived: true });
   const { doc, archived } = await readTaskFileWithArchiveFallback(paths, taskId);
@@ -11110,7 +11288,7 @@ async function doRunTaskStatus(taskIdInput, newStatusInput, options, ctx) {
   const newStatus = parseTaskStatusPositional(newStatusInput);
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "status");
-  const paths = basouPaths20(repositoryRoot);
+  const paths = basouPaths21(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
   const taskId = await resolveTaskId2(paths, taskIdInput);
   const now = ctx.nowProvider !== void 0 ? ctx.nowProvider() : /* @__PURE__ */ new Date();
@@ -11136,7 +11314,7 @@ async function doRunTaskStatus(taskIdInput, newStatusInput, options, ctx) {
     });
     return;
   }
-  const manifest = await readManifest12(paths);
+  const manifest = await readManifest13(paths);
   const result = await updateTaskStatusWithEvent({
     mode: "ad-hoc",
     paths,
@@ -11187,9 +11365,9 @@ async function runTaskReconcile(options, ctx = {}) {
 async function doRunTaskReconcile(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "reconcile");
-  const paths = basouPaths20(repositoryRoot);
+  const paths = basouPaths21(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
-  const manifest = await readManifest12(paths);
+  const manifest = await readManifest13(paths);
   const nowProvider = ctx.nowProvider ?? (() => /* @__PURE__ */ new Date());
   const write = options.write === true;
   const verbose = isVerbose(options);
@@ -11367,9 +11545,9 @@ async function doRunTaskRefreshLinkage(taskIdInput, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "refresh-linkage");
-  const paths = basouPaths20(repositoryRoot);
+  const paths = basouPaths21(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
-  const manifest = await readManifest12(paths);
+  const manifest = await readManifest13(paths);
   const taskId = await resolveTaskId2(paths, taskIdInput);
   const nowProvider = ctx.nowProvider ?? (() => /* @__PURE__ */ new Date());
   const write = options.write === true;
@@ -11447,9 +11625,9 @@ async function doRunTaskEdit(taskIdInput, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "edit");
-  const paths = basouPaths20(repositoryRoot);
+  const paths = basouPaths21(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
-  const manifest = await readManifest12(paths);
+  const manifest = await readManifest13(paths);
   const taskId = await resolveTaskId2(paths, taskIdInput);
   const now = ctx.nowProvider !== void 0 ? ctx.nowProvider() : /* @__PURE__ */ new Date();
   const occurredAt = now.toISOString();
@@ -11503,9 +11681,9 @@ async function doRunTaskDelete(taskIdInput, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "delete");
-  const paths = basouPaths20(repositoryRoot);
+  const paths = basouPaths21(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
-  const manifest = await readManifest12(paths);
+  const manifest = await readManifest13(paths);
   const taskId = await resolveTaskId2(paths, taskIdInput);
   if (options.yes !== true) {
     await confirmDestructiveAction("delete", taskId);
@@ -11548,9 +11726,9 @@ async function doRunTaskArchive(taskIdInput, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "archive");
-  const paths = basouPaths20(repositoryRoot);
+  const paths = basouPaths21(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
-  const manifest = await readManifest12(paths);
+  const manifest = await readManifest13(paths);
   const taskId = await resolveTaskId2(paths, taskIdInput);
   if (options.yes !== true) {
     await confirmDestructiveAction("archive", taskId);
@@ -11769,7 +11947,7 @@ function maxLen3(values, floor) {
 // src/commands/verify.ts
 import {
   assertBasouRootSafe as assertBasouRootSafe17,
-  basouPaths as basouPaths21,
+  basouPaths as basouPaths22,
   enumerateSessionDirs as enumerateSessionDirs3,
   findErrorCode as findErrorCode16,
   resolveRepositoryRoot as resolveRepositoryRoot12,
@@ -11795,7 +11973,7 @@ async function doRunVerify(options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForVerify(cwd);
-  const paths = basouPaths21(repositoryRoot);
+  const paths = basouPaths22(repositoryRoot);
   await assertWorkspaceInitialized14(paths.root);
   const sessionIds = options.session !== void 0 ? [await resolveSessionId5(paths, options.session)] : await enumerateSessionDirs3(paths);
   const rows = [];
@@ -11870,9 +12048,9 @@ import { createHash as createHash2 } from "crypto";
 import { basename as basename10, resolve as resolve13 } from "path";
 import {
   assertBasouRootSafe as assertBasouRootSafe18,
-  basouPaths as basouPaths23,
+  basouPaths as basouPaths24,
   findErrorCode as findErrorCode18,
-  readManifest as readManifest16,
+  readManifest as readManifest17,
   resolveRepositoryRoot as resolveRepositoryRoot14
 } from "@basou/core";
 import { InvalidArgumentError as InvalidArgumentError8 } from "commander";
@@ -11883,7 +12061,7 @@ import { readdir as readdir3, stat as stat7 } from "fs/promises";
 import { homedir as homedir12 } from "os";
 import { basename as basename8, dirname as dirname5, join as join17 } from "path";
 import { createInterface as createInterface2 } from "readline";
-import { basouPaths as basouPaths22, readManifest as readManifest13, resolveRepositoryRoot as resolveRepositoryRoot13 } from "@basou/core";
+import { basouPaths as basouPaths23, readManifest as readManifest14, resolveRepositoryRoot as resolveRepositoryRoot13 } from "@basou/core";
 function uncapturedTotal(result) {
   return result.groups.reduce((sum, g) => sum + g.logs, 0) + result.unplaceable;
 }
@@ -11926,7 +12104,7 @@ async function collectDeclaredRoots(workspaces) {
     }
     let resolved;
     try {
-      const manifest = await readManifest13(basouPaths22(importRoot));
+      const manifest = await readManifest14(basouPaths23(importRoot));
       resolved = resolveSourceRoots({
         projectFlags: [],
         manifest,
@@ -12197,7 +12375,7 @@ import { execFile as execFile2 } from "child_process";
 import { lstat as lstat2, realpath as realpath4 } from "fs/promises";
 import { isAbsolute as isAbsolute7, join as join18, relative as relative4, resolve as resolve11 } from "path";
 import { promisify as promisify2 } from "util";
-import { readManifest as readManifest14 } from "@basou/core";
+import { readManifest as readManifest15 } from "@basou/core";
 var execFileAsync2 = promisify2(execFile2);
 function errorCode(error) {
   return error instanceof Error ? error.code : void 0;
@@ -12253,7 +12431,7 @@ async function checkPortfolioSafety(workspaces) {
     let viewPath;
     let isMaster = false;
     try {
-      const manifest = await readManifest14(ws.paths);
+      const manifest = await readManifest15(ws.paths);
       sourceRoots = manifest.import?.source_roots ?? [];
       viewPath = manifest.workspace.view;
       isMaster = true;
@@ -12383,7 +12561,7 @@ import {
   loadSessionEntries as loadSessionEntries4,
   loadTaskEntries as loadTaskEntries2,
   readAllEvents as readAllEvents2,
-  readManifest as readManifest15,
+  readManifest as readManifest16,
   readMarkdownFile as readMarkdownFile9,
   readSessionYaml as readSessionYaml3,
   readTaskFile as readTaskFile2,
@@ -13368,7 +13546,7 @@ async function captureStaleness(ws, nowIso) {
 async function overview(ws, nowProvider, resolveRemoteUrl) {
   let manifest;
   try {
-    manifest = await readManifest15(ws.paths);
+    manifest = await readManifest16(ws.paths);
   } catch (error) {
     if (findErrorCode17(error, "ENOENT")) {
       return { initialized: false, repoRoot: ws.repoRoot };
@@ -13669,7 +13847,7 @@ async function doRunView(options, ctx) {
 }
 async function buildSingleDeps(ctx, cwd) {
   const repositoryRoot = await resolveRepositoryRootForView(cwd);
-  const paths = basouPaths23(repositoryRoot);
+  const paths = basouPaths24(repositoryRoot);
   await assertWorkspaceInitialized15(paths.root);
   const entry = await buildWorkspaceEntry(repositoryRoot, ctx);
   return {
@@ -13703,14 +13881,14 @@ async function buildPortfolioDeps(workspaceFlags, ctx, cwd) {
   };
 }
 async function buildWorkspaceEntry(repoRoot, ctx, labelOverride) {
-  const paths = basouPaths23(repoRoot);
+  const paths = basouPaths24(repoRoot);
   const importCtx = {
     cwd: repoRoot,
     ...ctx.claudeProjectsDir !== void 0 ? { claudeProjectsDir: ctx.claudeProjectsDir } : {},
     ...ctx.codexSessionsDir !== void 0 ? { codexSessionsDir: ctx.codexSessionsDir } : {}
   };
   try {
-    const manifest = await readManifest16(paths);
+    const manifest = await readManifest17(paths);
     return {
       key: manifest.workspace.id,
       label: labelOverride ?? manifest.workspace.name,
@@ -13815,7 +13993,7 @@ async function assertWorkspaceInitialized15(basouRoot) {
 function readBuildStamp() {
   if (false) return void 0;
   try {
-    return JSON.parse('{"version":"0.48.1","commit":"bb3398c","committedAt":"2026-09-21T21:38:14+09:00"}');
+    return JSON.parse('{"version":"0.50.0","commit":"5b4c5dc","committedAt":"2026-09-23T19:12:06+09:00"}');
   } catch {
     return void 0;
   }