@basou/cli 0.43.0 → 0.45.0

package/dist/index.js

@@ -119,6 +119,7 @@ function printTaskSkip(taskId, reason) {
 
 // src/program.ts
 import { createRequire } from "module";
+import * as basouCore from "@basou/core";
 import { Command } from "commander";
 
 // src/commands/approval.ts
@@ -135,6 +136,7 @@ import {
   enumerateApprovals,
   findErrorCode,
   isLazyExpired,
+  LOCAL_CLI_EVENT_SOURCE,
   linkYamlFile,
   loadApproval,
   prefixedUlid,
@@ -369,7 +371,7 @@ async function doRunApprovalResolve(idInput, options, ctx, decision) {
         id: eventId,
         session_id: approval.session_id,
         occurred_at: occurredAt,
-        source: "local-cli",
+        source: LOCAL_CLI_EVENT_SOURCE,
         type: "approval_approved",
         approval_id: approval.id,
         resolver: "local-cli",
@@ -382,7 +384,7 @@ async function doRunApprovalResolve(idInput, options, ctx, decision) {
         id: eventId,
         session_id: approval.session_id,
         occurred_at: occurredAt,
-        source: "local-cli",
+        source: LOCAL_CLI_EVENT_SOURCE,
         type: "approval_rejected",
         approval_id: approval.id,
         resolver: "local-cli",
@@ -861,12 +863,13 @@ import {
   acquireLock as acquireLock2,
   appendEventToExistingSession,
   assertBasouRootSafe as assertBasouRootSafe2,
-  basouPaths as basouPaths3,
+  basouPaths as basouPaths4,
   classifyFilesBySourceRoot,
   createAdHocSessionWithEvent,
   EVENT_SCHEMA_VERSION as EVENT_SCHEMA_VERSION2,
   findErrorCode as findErrorCode2,
   isValidPrefixedId,
+  LOCAL_CLI_EVENT_SOURCE as LOCAL_CLI_EVENT_SOURCE2,
   loadSessionEntries,
   prefixedUlid as prefixedUlid2,
   readManifest as readManifest2,
@@ -875,7 +878,7 @@ import {
   resolveSessionId,
   sanitizePath
 } from "@basou/core";
-import { InvalidArgumentError } from "commander";
+import { InvalidArgumentError as InvalidArgumentError2 } from "commander";
 
 // src/lib/repo-root.ts
 import { realpath, stat as stat2 } from "fs/promises";
@@ -1035,11 +1038,165 @@ async function realpathOrNull(p) {
   }
 }
 
+// src/commands/decision-gaps.ts
+import {
+  basouPaths as basouPaths3,
+  findDecisionGaps
+} from "@basou/core";
+import { InvalidArgumentError } from "commander";
+var DEFAULT_GAP_LIMIT = 20;
+function parseLimit(value) {
+  const n = /^\d+$/u.test(value.trim()) ? Number(value.trim()) : Number.NaN;
+  if (!Number.isInteger(n) || n < 0) {
+    throw new InvalidArgumentError("--limit must be a non-negative integer.");
+  }
+  return n;
+}
+function parseSince(value, now = /* @__PURE__ */ new Date()) {
+  const duration = /^(\d+)([dhm])$/u.exec(value.trim());
+  if (duration !== null) {
+    const n = Number(duration[1]);
+    const ms = { d: 864e5, h: 36e5, m: 6e4 }[duration[2]];
+    return new Date(now.getTime() - n * ms).toISOString();
+  }
+  if (/^\d+$/u.test(value.trim())) {
+    throw new InvalidArgumentError("--since needs a unit (7d, 36h, 90m) or a full ISO timestamp.");
+  }
+  const parsed = Date.parse(value);
+  if (Number.isNaN(parsed)) {
+    throw new InvalidArgumentError(
+      "--since must be an ISO timestamp or a duration (7d, 36h, 90m)."
+    );
+  }
+  return new Date(parsed).toISOString();
+}
+function registerDecisionGapsCommand(decision) {
+  decision.command("gaps").description("List recorded decisions that no task carries (read-only, advisory)").option(
+    "--since <when>",
+    "Only decisions recorded at or after this ISO instant or duration back (7d, 36h)"
+  ).option(
+    "--limit <n>",
+    `Maximum entries to list; the rest are counted (default ${DEFAULT_GAP_LIMIT}, 0 = no limit)`,
+    parseLimit
+  ).option("--json", "Output the result as JSON").option("-v, --verbose", "Show error causes").action(async (opts) => {
+    await runDecisionGaps(opts);
+  });
+}
+async function runDecisionGaps(options, ctx = {}) {
+  try {
+    await doRunDecisionGaps(options, ctx);
+  } catch (error) {
+    renderCliError(error, { verbose: isVerbose(options) });
+    process.exitCode = 1;
+  }
+}
+async function doRunDecisionGaps(options, ctx) {
+  const cwd = ctx.cwd ?? process.cwd();
+  const repositoryRoot = await resolveBasouRootForCommand(cwd, "decision gaps");
+  const paths = basouPaths3(repositoryRoot);
+  const now = ctx.nowProvider?.() ?? /* @__PURE__ */ new Date();
+  const limit = options.limit ?? DEFAULT_GAP_LIMIT;
+  const summary = await findDecisionGaps({
+    paths,
+    nowIso: now.toISOString(),
+    ...options.since !== void 0 ? { start: parseSince(options.since, now) } : {},
+    ...limit > 0 ? { limit } : {},
+    onWarning: (w, sid) => printReplayWarning(w, sid),
+    onSessionSkip: (sid, reason) => printSessionSkip(sid, reason)
+  });
+  if (options.json === true) {
+    console.log(JSON.stringify(summary));
+  } else {
+    console.log(renderDecisionGaps(summary));
+  }
+  return summary;
+}
+function relAge(iso, now) {
+  const ms = now.getTime() - Date.parse(iso);
+  if (!Number.isFinite(ms)) return "(unknown)";
+  if (ms < 0) return "clock ahead";
+  const days = Math.floor(ms / 864e5);
+  if (days >= 1) return `${days}d ago`;
+  const hours = Math.floor(ms / 36e5);
+  if (hours >= 1) return `${hours}h ago`;
+  return `${Math.max(1, Math.floor(ms / 6e4))}m ago`;
+}
+var GRAPHEMES = new Intl.Segmenter(void 0, { granularity: "grapheme" });
+function oneLine(value, max) {
+  const flat = [...GRAPHEMES.segment(value.replace(/\s+/gu, " ").trim())].map((s) => s.segment);
+  return flat.length > max ? `${flat.slice(0, max - 1).join("")}\u2026` : flat.join("");
+}
+function gapLine(d, now) {
+  return `- ${oneLine(d.title, 100)}
+  ${relAge(d.recordedAt, now)} \xB7 ${d.decisionId}`;
+}
+function incompleteLine(summary) {
+  const { sessions, tasks, unknownReferences } = summary.incomplete;
+  const parts = [];
+  if (sessions > 0) {
+    parts.push(
+      `${sessions} session${sessions === 1 ? "" : "s"} could not be read in full, so a decision recorded there may be missing from these numbers, and a \`decision void\` recorded there may not have been applied`
+    );
+  }
+  if (tasks > 0) {
+    parts.push(
+      `${tasks} task file${tasks === 1 ? "" : "s"} could not be read, so a decision one of them carries is listed above as if nothing did`
+    );
+  }
+  if (unknownReferences > 0) {
+    parts.push(
+      `${unknownReferences} decision id${unknownReferences === 1 ? "" : "s"} named by a task ${unknownReferences === 1 ? "matches" : "match"} no decision in this store, and ${unknownReferences === 1 ? "was" : "were"} not counted as carrying anything`
+    );
+  }
+  return parts.length === 0 ? null : `\u26A0\uFE0F ${parts.join("; ")}.`;
+}
+function renderDecisionGaps(summary) {
+  const now = new Date(summary.generatedAt);
+  const { excluded, scope } = summary;
+  const lines = ["# Decision gaps", ""];
+  if (summary.populationCount === 0) {
+    lines.push(
+      `No decision recorded since ${scope.start} by \`basou decision capture\` or \`basou decision record\` is still open, so there is nothing to check yet. This list fills as decisions are recorded.`
+    );
+  } else if (summary.gaps.length === 0) {
+    lines.push(
+      `\u2705 Within what was checked, each of the ${summary.populationCount} open decision${summary.populationCount === 1 ? "" : "s"} in scope has a task carrying it.`
+    );
+  } else {
+    const total = summary.gaps.length + summary.truncated;
+    lines.push(`\u26A0\uFE0F Open decisions no task carries: ${total} of ${summary.populationCount} in scope`);
+    lines.push("");
+    for (const d of summary.gaps) lines.push(gapLine(d, now));
+    if (summary.truncated > 0) {
+      lines.push(`  ... +${summary.truncated} more (--limit 0 to list them all, or --json)`);
+    }
+  }
+  lines.push("");
+  lines.push("## Scope");
+  lines.push(
+    `- Checked: decisions recorded at or after ${scope.start} with source \`${scope.source}\` (i.e. recorded by running basou, not derived from a transcript by an importer), still open, and not a track.`
+  );
+  lines.push(
+    `- Not checked: ${excluded.byStart} recorded earlier, then ${excluded.bySource} recorded by something other than basou itself, then ${excluded.track} tracks (already shown every session by \`basou orient\` until closed), then ${excluded.voided} closed with \`basou decision void\`.`
+  );
+  lines.push(
+    `- Task files read: ${summary.tasksScanned} (live and archived); ${summary.carried} of the decisions in scope are carried by one.`
+  );
+  const incomplete = incompleteLine(summary);
+  if (incomplete !== null) lines.push(`- ${incomplete}`);
+  lines.push("");
+  lines.push(
+    "Note: read-only advisory. A task carries a decision when it names that decision's full id; an abbreviated id names no one decision, because a captured batch shares a millisecond and its ids differ only at the end. It does not read what a decision means, and it does not enforce."
+  );
+  return lines.join("\n");
+}
+
 // src/commands/decision.ts
 var LABEL_TITLE_MAX = 80;
 var LABEL_TRUNCATE_HEAD = LABEL_TITLE_MAX - 3;
 function registerDecisionCommand(program2) {
   const decision = program2.command("decision").description("Record human-authored decisions as events");
+  registerDecisionGapsCommand(decision);
   decision.command("record").description("Record a decision_recorded event").requiredOption("--title <text>", "Decision title", parseTitle).option("--rationale <text>", "Rationale for the decision", parseRationale).option(
     "--rejected-reason <text>",
     "Reason rejected alternatives were not chosen",
@@ -1161,7 +1318,7 @@ function warnTrackMarkerWithoutKind(decisions, markerWithoutKind) {
 async function doRunDecisionRecord(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForDecision(cwd);
-  const paths = basouPaths3(repositoryRoot);
+  const paths = basouPaths4(repositoryRoot);
   await assertWorkspaceInitialized2(paths.root);
   const now = ctx.nowProvider !== void 0 ? ctx.nowProvider() : /* @__PURE__ */ new Date();
   const occurredAt = now.toISOString();
@@ -1252,7 +1409,7 @@ async function runDecisionCapture(options, ctx = {}) {
 async function doRunDecisionCapture(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "decision capture");
-  const paths = basouPaths3(repositoryRoot);
+  const paths = basouPaths4(repositoryRoot);
   await assertWorkspaceInitialized2(paths.root);
   const raw = await readCaptureInput(options, ctx);
   const { decisions, markerWithoutKind } = parseCaptureInput(raw);
@@ -1334,7 +1491,7 @@ async function doRunDecisionVoid(decisionId, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "decision void");
-  const paths = basouPaths3(repositoryRoot);
+  const paths = basouPaths4(repositoryRoot);
   await assertWorkspaceInitialized2(paths.root);
   if (!await decisionExists(paths, decisionId)) {
     throw new Error(
@@ -1428,7 +1585,7 @@ function buildDecisionVoidedEvent(input) {
     id: input.eventId,
     session_id: input.sessionId,
     occurred_at: input.occurredAt,
-    source: "local-cli",
+    source: LOCAL_CLI_EVENT_SOURCE2,
     type: "decision_voided",
     decision_id: input.decisionId,
     ...input.reason !== void 0 ? { reason: input.reason } : {},
@@ -1460,7 +1617,7 @@ function printVoidResult(options, result) {
 }
 function parseReason(raw) {
   if (raw.trim().length === 0) {
-    throw new InvalidArgumentError("--reason must not be empty");
+    throw new InvalidArgumentError2("--reason must not be empty");
   }
   return raw;
 }
@@ -1694,7 +1851,7 @@ function buildDecisionEvent(input) {
     id: input.eventId,
     session_id: input.sessionId,
     occurred_at: input.occurredAt,
-    source: "local-cli",
+    source: LOCAL_CLI_EVENT_SOURCE2,
     type: "decision_recorded",
     decision_id: input.decisionId,
     title: input.title,
@@ -1712,25 +1869,25 @@ function buildAdHocLabel(title) {
 }
 function parseTitle(raw) {
   if (isBlank(raw)) {
-    throw new InvalidArgumentError("Title must not be empty");
+    throw new InvalidArgumentError2("Title must not be empty");
   }
   return raw;
 }
 function parseRationale(raw) {
   if (isBlank(raw)) {
-    throw new InvalidArgumentError("Rationale must not be empty");
+    throw new InvalidArgumentError2("Rationale must not be empty");
   }
   return raw;
 }
 function parseRejectedReason(raw) {
   if (isBlank(raw)) {
-    throw new InvalidArgumentError("Rejected reason must not be empty");
+    throw new InvalidArgumentError2("Rejected reason must not be empty");
   }
   return raw;
 }
 function collectAlternative(value, prev) {
   if (isBlank(value)) {
-    throw new InvalidArgumentError("Alternative must not be empty");
+    throw new InvalidArgumentError2("Alternative must not be empty");
   }
   return prev.concat(value);
 }
@@ -1739,16 +1896,16 @@ function isValidEventId(value) {
 }
 function collectLinkedEvent(value, prev) {
   if (!isValidEventId(value)) {
-    throw new InvalidArgumentError(`Linked event id must match evt_<ULID>, got '${value}'`);
+    throw new InvalidArgumentError2(`Linked event id must match evt_<ULID>, got '${value}'`);
   }
   return prev.concat(value);
 }
 function collectLinkedFile(value, prev) {
   if (isBlank(value)) {
-    throw new InvalidArgumentError("Linked file path must not be empty");
+    throw new InvalidArgumentError2("Linked file path must not be empty");
   }
   if (value.length > 4096) {
-    throw new InvalidArgumentError("Linked file path exceeds 4096 chars");
+    throw new InvalidArgumentError2("Linked file path exceeds 4096 chars");
   }
   return prev.concat(value);
 }
@@ -1813,7 +1970,7 @@ async function assertWorkspaceInitialized2(basouRoot) {
 // src/commands/decisions.ts
 import {
   assertBasouRootSafe as assertBasouRootSafe3,
-  basouPaths as basouPaths4,
+  basouPaths as basouPaths5,
   findErrorCode as findErrorCode3,
   readMarkdownFile as readMarkdownFile2,
   renderDecisions,
@@ -1839,7 +1996,7 @@ async function doRunDecisionsGenerate(options, ctx) {
   void options;
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForDecisions(cwd);
-  const paths = basouPaths4(repositoryRoot);
+  const paths = basouPaths5(repositoryRoot);
   await assertWorkspaceInitialized3(paths.root);
   const nowIso = (ctx.nowProvider?.() ?? /* @__PURE__ */ new Date()).toISOString();
   const result = await renderDecisions({
@@ -1884,7 +2041,7 @@ import { join as join6 } from "path";
 import {
   acquireLock as acquireLock3,
   assertBasouRootSafe as assertBasouRootSafe4,
-  basouPaths as basouPaths5,
+  basouPaths as basouPaths6,
   ChildProcessRunner,
   appendChainedEvent as coreAppendChainedEvent,
   EVENT_SCHEMA_VERSION as EVENT_SCHEMA_VERSION3,
@@ -1896,6 +2053,7 @@ import {
   readManifest as readManifest3,
   readYamlFile as readYamlFile3,
   resolveRepositoryRoot as resolveRepositoryRoot4,
+  SESSION_SCHEMA_VERSION,
   SessionSchema,
   sanitizeWorkingDirectory,
   writeObservedDuration,
@@ -1918,7 +2076,7 @@ async function runExec(command, args, options, ctx = {}) {
   const cwd = options.cwd ?? process.cwd();
   const timeout_ms = options.timeout !== void 0 ? parseDuration(options.timeout) : void 0;
   const repoRoot = await resolveRepositoryRootForExec(cwd);
-  const paths = basouPaths5(repoRoot);
+  const paths = basouPaths6(repoRoot);
   await assertBasouRootSafe4(paths.root);
   const manifest = await readManifest3(paths);
   const sessionId = prefixedUlid3("ses");
@@ -2131,7 +2289,7 @@ function normalizeGitSnapshotSkipMessage(error) {
 function buildInitialSession(input) {
   const cmdline = [input.command, ...input.args].join(" ");
   return {
-    schema_version: "0.1.0",
+    schema_version: SESSION_SCHEMA_VERSION,
     session: {
       id: input.id,
       label: `basou exec ${cmdline} (${input.startedAt})`,
@@ -2216,12 +2374,11 @@ async function resolveRepositoryRootForExec(cwd) {
 // src/commands/handoff.ts
 import {
   assertBasouRootSafe as assertBasouRootSafe5,
-  basouPaths as basouPaths6,
+  basouPaths as basouPaths7,
   findErrorCode as findErrorCode4,
   readMarkdownFile as readMarkdownFile3,
   renderHandoff,
   renderWithMarkers as renderWithMarkers2,
-  resolveRepositoryRoot as resolveRepositoryRoot5,
   writeMarkdownFile as writeMarkdownFile2
 } from "@basou/core";
 function registerHandoffCommand(program2) {
@@ -2242,7 +2399,7 @@ async function doRunHandoffGenerate(options, ctx) {
   void options;
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForHandoff(cwd);
-  const paths = basouPaths6(repositoryRoot);
+  const paths = basouPaths7(repositoryRoot);
   await assertWorkspaceInitialized4(paths.root);
   const nowIso = (ctx.nowProvider?.() ?? /* @__PURE__ */ new Date()).toISOString();
   const result = await renderHandoff({
@@ -2261,7 +2418,7 @@ async function doRunHandoffGenerate(options, ctx) {
 }
 async function resolveRepositoryRootForHandoff(cwd) {
   try {
-    return await resolveRepositoryRoot5(cwd);
+    return await resolveBasouRootForCommand(cwd, "handoff generate");
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error(
@@ -2284,10 +2441,12 @@ async function assertWorkspaceInitialized4(basouRoot) {
 }
 
 // src/commands/hook.ts
+import { execFile } from "child_process";
 import { open as open2, readFile as readFile3, realpath as realpath3, stat as stat4 } from "fs/promises";
 import { homedir as homedir7 } from "os";
 import { join as join9 } from "path";
 import { fileURLToPath } from "url";
+import { promisify } from "util";
 import {
   buildSessionStartHookCommand,
   buildStopHookCommand,
@@ -2558,7 +2717,7 @@ async function warnIfPositionNamesOtherWorkspaces(args) {
 // src/commands/orient.ts
 import {
   assertBasouRootSafe as assertBasouRootSafe7,
-  basouPaths as basouPaths8,
+  basouPaths as basouPaths9,
   findErrorCode as findErrorCode6,
   renderOrientation as renderOrientation2,
   writeMarkdownFile as writeMarkdownFile4
@@ -2639,7 +2798,7 @@ import { createInterface } from "readline";
 import {
   AGENT_INFRA_DIRS as AGENT_INFRA_DIRS2,
   assertBasouRootSafe as assertBasouRootSafe6,
-  basouPaths as basouPaths7,
+  basouPaths as basouPaths8,
   CLAUDE_IMPORT_SOURCE,
   CODEX_IMPORT_SOURCE,
   classifyFilesBySourceRoot as classifyFilesBySourceRoot2,
@@ -2651,7 +2810,7 @@ import {
   readManifest as readManifest4,
   readSessionYaml as readSessionYaml2,
   reimportPreservingId,
-  resolveRepositoryRoot as resolveRepositoryRoot6,
+  resolveRepositoryRoot as resolveRepositoryRoot5,
   SESSION_IMPORT_SCHEMA_VERSION,
   SessionImportPayloadSchema
 } from "@basou/core";
@@ -2798,7 +2957,7 @@ function assertSelector(options) {
 async function resolveImportTarget(ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForImport(cwd);
-  const paths = basouPaths7(repositoryRoot);
+  const paths = basouPaths8(repositoryRoot);
   await assertWorkspaceInitialized5(paths.root);
   const manifest = await readManifest4(paths);
   return { repositoryRoot, paths, manifest };
@@ -2841,7 +3000,9 @@ async function importDerivedSessions(paths, manifest, options, sourceKind, candi
       throw new Error("Invalid import payload", { cause: parsed.error });
     }
     if (parsed.data.schema_version !== SESSION_IMPORT_SCHEMA_VERSION) {
-      throw new Error(`Unsupported import schema_version: ${parsed.data.schema_version}`);
+      throw new Error(
+        `Unsupported import schema_version: ${parsed.data.schema_version} (expected ${SESSION_IMPORT_SCHEMA_VERSION}). The envelope's shape is published as @basou/core/schemas/session-import.schema.json; this version may move at a minor release, so a producer should read it from the installed @basou/core rather than pinning it.`
+      );
     }
     return parsed.data;
   };
@@ -3234,7 +3395,7 @@ function shortId2(id) {
 }
 async function resolveRepositoryRootForImport(cwd) {
   try {
-    return await resolveRepositoryRoot6(cwd);
+    return await resolveRepositoryRoot5(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error("Not a git repository. Run 'git init' first, then re-run 'basou import'.", {
@@ -3467,7 +3628,7 @@ async function warnIfPositionNamesOtherWorkspaces2(result, ctx) {
   });
   if (report !== null) {
     console.error(
-      positionForeignWorkspaceWarning(report, basouPaths8(result.workspaceRoot).files.orientation)
+      positionForeignWorkspaceWarning(report, basouPaths9(result.workspaceRoot).files.orientation)
     );
   }
 }
@@ -3477,7 +3638,7 @@ async function renderOrientationForCwd(options, ctx) {
   return renderOrientationForRoot(repositoryRoot, options, ctx, { write: true });
 }
 async function renderOrientationForRoot(repositoryRoot, options, ctx, behaviour) {
-  const paths = basouPaths8(repositoryRoot);
+  const paths = basouPaths9(repositoryRoot);
   await assertWorkspaceInitialized6(paths.root);
   const nowIso = (ctx.nowProvider?.() ?? /* @__PURE__ */ new Date()).toISOString();
   const probeCtx = { cwd: repositoryRoot };
@@ -3491,7 +3652,7 @@ async function renderOrientationForRoot(repositoryRoot, options, ctx, behaviour)
   try {
     const hosts = await loadHostsConfig(ctx.hostsConfigPath);
     if (hosts !== null) {
-      federatedRoots = hosts.map((h) => ({ paths: basouPaths8(h.path), host: h.label }));
+      federatedRoots = hosts.map((h) => ({ paths: basouPaths9(h.path), host: h.label }));
     }
   } catch (error) {
     console.error(
@@ -3535,6 +3696,7 @@ async function assertWorkspaceInitialized6(basouRoot) {
 
 // src/commands/hook.ts
 var MAX_TRANSCRIPT_BYTES = 8 * 1024 * 1024;
+var execFileAsync = promisify(execFile);
 function registerHookCommand(program2) {
   const hook = program2.command("hook").description(
     "Hook handlers for AI coding tools (Claude Code, Codex): read a hook payload on stdin, emit the tool's hook output on stdout"
@@ -3984,6 +4146,90 @@ async function doRunHookStatus(options) {
     review: / --require-review\b/.test(command)
   });
   console.log(`basou Stop hook: registered, ${mode}.`);
+  await reportHookEntryBuild(command);
+}
+async function reportHookEntryBuild(command) {
+  console.log(`  this basou is: ${BASOU_VERSION_LINE}`);
+  const entry = extractHookEntryPath(command);
+  if (entry === void 0) {
+    console.log(
+      "  runs: (registered by alias, not by path) \u2014 which build that resolves to depends on the hook's PATH, so this cannot tell you."
+    );
+    return;
+  }
+  try {
+    const { stdout } = await execFileAsync(process.execPath, [entry, "--version"], {
+      timeout: 1e4
+    });
+    const reported = stdout.trim();
+    console.log(`  the hook runs: ${entry}`);
+    console.log(`  that build is: ${reported}`);
+    if (!reported.includes("(build ")) {
+      console.log(
+        "  note: that build predates build stamping, so what it reports is its package.json rather than itself \u2014 it cannot tell you which build it is. Update it (rebuild a source checkout, or reinstall the package) to find out."
+      );
+    }
+  } catch {
+    console.log(`  the hook runs: ${entry}`);
+    console.log(
+      "  that build is: could not be executed \u2014 the hook's wrapper fails open, so it is silently doing nothing."
+    );
+  }
+}
+function tokenizeShellCommand(command) {
+  const tokens = [];
+  let current = "";
+  let started = false;
+  let quote;
+  for (let i = 0; i < command.length; i++) {
+    const ch = command[i];
+    if (quote === "'") {
+      if (ch === "'") quote = void 0;
+      else current += ch;
+      continue;
+    }
+    if (quote === '"') {
+      if (ch === '"') quote = void 0;
+      else if (ch === "\\" && i + 1 < command.length) current += command[++i];
+      else current += ch;
+      continue;
+    }
+    if (ch === "'" || ch === '"') {
+      quote = ch;
+      started = true;
+      continue;
+    }
+    if (ch === "\\" && i + 1 < command.length) {
+      current += command[++i];
+      started = true;
+      continue;
+    }
+    if (/\s/.test(ch)) {
+      if (started) tokens.push(current);
+      current = "";
+      started = false;
+      continue;
+    }
+    current += ch;
+    started = true;
+  }
+  if (quote !== void 0) return void 0;
+  if (started) tokens.push(current);
+  return tokens;
+}
+function extractHookEntryPath(command) {
+  const tokens = tokenizeShellCommand(command);
+  if (tokens === void 0) return void 0;
+  let index = 0;
+  while (index < tokens.length && /^[A-Za-z_][A-Za-z0-9_]*=/.test(tokens[index])) index++;
+  const interpreter = tokens[index];
+  if (interpreter === void 0) return void 0;
+  const base = interpreter.replace(/\\/g, "/").split("/").pop() ?? "";
+  if (base !== "node" && base !== "node.exe") return void 0;
+  index++;
+  while (index < tokens.length && tokens[index].startsWith("-")) index++;
+  const entry = tokens[index];
+  return entry === void 0 || entry === "" ? void 0 : entry;
 }
 function describeHookMode(tiers) {
   const enforcement = tiers.block ? "blocking (opt-in enforcement)" : "advisory (non-blocking)";
@@ -4140,6 +4386,7 @@ async function doRunCodexHookStatus(options) {
   console.log(
     `basou Codex SessionStart hook: registered in ${hooksPath} (matcher: ${matcher}); speaks only for workspaces registered in ~/.basou/portfolio.yaml.`
   );
+  await reportHookEntryBuild(location.command);
   await reportCodexHookState(hooksPath, parsed, options);
 }
 async function codexHookTrustFor(hooksPath, location, configPath) {
@@ -4179,7 +4426,7 @@ import {
   appendBasouGitignore,
   createManifest,
   ensureBasouDirectory,
-  resolveRepositoryRoot as resolveRepositoryRoot7,
+  resolveRepositoryRoot as resolveRepositoryRoot6,
   writeManifest
 } from "@basou/core";
 function collectValue(value, previous) {
@@ -4249,7 +4496,7 @@ function renderGitignoreWarning(error, verbose) {
 }
 async function resolveRepositoryRootForInit(cwd) {
   try {
-    return await resolveRepositoryRoot7(cwd);
+    return await resolveRepositoryRoot6(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error("Not a git repository. Run 'git init' first, then re-run 'basou init'.", {
@@ -4265,14 +4512,15 @@ import {
   acquireLock as acquireLock4,
   appendEventToExistingSession as appendEventToExistingSession2,
   assertBasouRootSafe as assertBasouRootSafe8,
-  basouPaths as basouPaths9,
+  basouPaths as basouPaths10,
   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,
   resolveSessionId as resolveSessionId2
 } from "@basou/core";
-import { InvalidArgumentError as InvalidArgumentError2 } from "commander";
+import { InvalidArgumentError as InvalidArgumentError3 } from "commander";
 var NOTE_SUBCOMMAND_LOOKALIKES = /* @__PURE__ */ new Set([
   "list",
   "ls",
@@ -4319,7 +4567,7 @@ async function doRunNote(body, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "note");
-  const paths = basouPaths9(repositoryRoot);
+  const paths = basouPaths10(repositoryRoot);
   await assertWorkspaceInitialized7(paths.root);
   const now = ctx.nowProvider !== void 0 ? ctx.nowProvider() : /* @__PURE__ */ new Date();
   const occurredAt = now.toISOString();
@@ -4376,7 +4624,7 @@ function buildNoteEvent(input) {
     id: input.eventId,
     session_id: input.sessionId,
     occurred_at: input.occurredAt,
-    source: "local-cli",
+    source: LOCAL_CLI_EVENT_SOURCE3,
     type: "note_added",
     body: input.body,
     // `basou note` is the resume-hint command; mark it so orientation surfaces
@@ -4385,13 +4633,13 @@ function buildNoteEvent(input) {
   };
 }
 function buildAdHocLabel2(body) {
-  const oneLine2 = body.replace(/\s+/g, " ").trim();
-  const truncated = oneLine2.length > LABEL_BODY_MAX ? `${oneLine2.slice(0, LABEL_TRUNCATE_HEAD2)}...` : oneLine2;
+  const oneLine3 = body.replace(/\s+/g, " ").trim();
+  const truncated = oneLine3.length > LABEL_BODY_MAX ? `${oneLine3.slice(0, LABEL_TRUNCATE_HEAD2)}...` : oneLine3;
   return `Ad-hoc note: ${truncated}`;
 }
 function parseBody(raw) {
   if (raw.trim().length === 0) {
-    throw new InvalidArgumentError2("Note body must not be empty");
+    throw new InvalidArgumentError3("Note body must not be empty");
   }
   return raw;
 }
@@ -4542,7 +4790,7 @@ import {
 import { basename as basename6, dirname as dirname4, isAbsolute as isAbsolute3, join as join11, relative as relative2, resolve as resolve7 } from "path";
 import {
   appendBasouGitignore as appendBasouGitignore2,
-  basouPaths as basouPaths10,
+  basouPaths as basouPaths11,
   classifyRetrofit,
   createManifest as createManifest2,
   ensureBasouDirectory as ensureBasouDirectory2,
@@ -4564,7 +4812,7 @@ import {
   renderAnchorStarter,
   renderViewPresetBlock,
   renderWithMarkers as renderWithMarkers4,
-  resolveRepositoryRoot as resolveRepositoryRoot8,
+  resolveRepositoryRoot as resolveRepositoryRoot7,
   safeSimpleGit,
   seedMarkers,
   summarizePresetPlan,
@@ -4705,7 +4953,7 @@ function preservedUnknownLines(fields) {
 async function doRunProjectCheck(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project check");
-  const paths = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   const manifest = await readManifest6(paths);
   const roster = summarizeRosterDrift({
     ...manifest.repos !== void 0 ? { repos: manifest.repos } : {},
@@ -4840,7 +5088,7 @@ 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 = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   const manifest = await readManifest6(paths);
   const hasRoster = manifest.repos !== void 0 && manifest.repos.length > 0;
   const reconcile = reconcileSourceRoots({
@@ -4926,7 +5174,7 @@ function classifySourceRoot(repositoryRoot, declaredPath) {
 async function doRunProjectAdopt(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project adopt");
-  const paths = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   const manifest = await readManifest6(paths);
   const alreadyDeclared = manifest.repos !== void 0 && manifest.repos.length > 0;
   const candidates = effectiveSourceRoots(manifest).map(
@@ -5048,7 +5296,7 @@ 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 = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   const manifest = await readManifest6(paths);
   const roster = manifest.repos ?? [];
   const facts = [];
@@ -5181,7 +5429,7 @@ function applyGitignorePlan(repositoryRoot, plan) {
 async function doRunProjectGitignore(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project gitignore");
-  const paths = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   const manifest = await readManifest6(paths);
   const roster = manifest.repos ?? [];
   const facts = roster.map((entry) => gatherRepoGitignore(repositoryRoot, entry));
@@ -5440,7 +5688,7 @@ function applyViewSymlinks(viewDir, files) {
 async function doRunProjectSymlinks(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project symlinks");
-  const paths = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   const manifest = await readManifest6(paths);
   const roster = manifest.repos ?? [];
   const anchorReal = realpathSync(repositoryRoot);
@@ -5770,7 +6018,7 @@ 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 = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   const manifest = await readManifest6(paths);
   const viewPath = manifest.workspace.view;
   const roster = manifest.repos ?? [];
@@ -6130,7 +6378,7 @@ function presetFailureReason(error) {
 async function doRunProjectPreset(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project preset");
-  const paths = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   const manifest = await readManifest6(paths);
   const roster = manifest.repos ?? [];
   const anchorReal = realpathSync(repositoryRoot);
@@ -6789,7 +7037,7 @@ function renderProjectTeardown(result) {
 async function doRunProjectTeardown(target, options, ctx = {}) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveBasouRootForCommand(cwd, "project teardown");
-  const paths = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   const manifest = await readManifest6(paths);
   const plan = gatherRepoTeardown(repositoryRoot, manifest, target);
   const willApply = options.apply === true && !plan.isAnchor && plan.removableCount > 0;
@@ -6831,7 +7079,7 @@ 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 = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   const manifest = await readManifest6(paths);
   const roster = manifest.repos ?? [];
   let targetIsAnchor = false;
@@ -6988,7 +7236,7 @@ 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 = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   const manifest = await readManifest6(paths);
   const roster = manifest.repos ?? [];
   let oldIsAnchor = false;
@@ -7112,7 +7360,7 @@ async function runProjectNew(repos, options, ctx = {}) {
 }
 async function resolveRepositoryRootForNew(cwd) {
   try {
-    return await resolveRepositoryRoot8(cwd);
+    return await resolveRepositoryRoot7(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error(
@@ -7164,7 +7412,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 = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   const existed = existsSync2(paths.files.manifest);
   const manifest = createManifest2({
     workspaceName,
@@ -7275,7 +7523,7 @@ 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 = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   const manifest = await readManifest6(paths);
   if (manifest.repos === void 0 || manifest.repos.length === 0) {
     console.log(
@@ -7316,7 +7564,7 @@ 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 = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   const manifest = await readManifest6(paths);
   const roster = manifest.repos ?? [];
   console.log("# Anchor instruction-file seed (the planning master's own AGENTS.md)");
@@ -7402,7 +7650,7 @@ function pathPresent(p) {
     return false;
   }
 }
-function gatherRetrofit(repositoryRoot, anchorReal, roster, argPath, argAbs, argReal, viewCanonicalName) {
+function gatherRetrofit(repositoryRoot, anchorReal, roster, argAbs, argReal, viewCanonicalName) {
   const declaredEntry = roster.find((entry) => {
     const entryAbs = resolve7(repositoryRoot, entry.path);
     if (argReal !== void 0) {
@@ -7510,7 +7758,7 @@ 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 = basouPaths10(repositoryRoot);
+  const paths = basouPaths11(repositoryRoot);
   const manifest = await readManifest6(paths);
   const roster = manifest.repos ?? [];
   const anchorReal = realpathSync(repositoryRoot);
@@ -7556,7 +7804,6 @@ async function doRunProjectRetrofit(repo, options, ctx) {
     repositoryRoot,
     anchorReal,
     roster,
-    repo,
     argAbs,
     argReal,
     viewCanonicalName
@@ -7987,11 +8234,11 @@ async function doRunProtocolUnsync(options) {
 // src/commands/refresh.ts
 import {
   assertBasouRootSafe as assertBasouRootSafe9,
-  basouPaths as basouPaths11,
+  basouPaths as basouPaths12,
   findErrorCode as findErrorCode9,
   readManifest as readManifest7
 } from "@basou/core";
-import { InvalidArgumentError as InvalidArgumentError3 } from "commander";
+import { InvalidArgumentError as InvalidArgumentError4 } from "commander";
 
 // src/commands/refresh-watch.ts
 import { readdir as readdir2, stat as stat5 } from "fs/promises";
@@ -8118,7 +8365,7 @@ function collectPath2(value, previous) {
 function parseInterval(value) {
   const seconds = Number(value);
   if (!Number.isInteger(seconds) || seconds < MIN_WATCH_INTERVAL_SEC || seconds > MAX_WATCH_INTERVAL_SEC) {
-    throw new InvalidArgumentError3(
+    throw new InvalidArgumentError4(
       `--interval must be an integer between ${MIN_WATCH_INTERVAL_SEC} and ${MAX_WATCH_INTERVAL_SEC} (seconds).`
     );
   }
@@ -8229,7 +8476,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 = basouPaths11(repositoryRoot);
+  const paths = basouPaths12(repositoryRoot);
   await assertWorkspaceInitialized8(paths.root);
   const intervalMs = (options.interval ?? DEFAULT_WATCH_INTERVAL_SEC) * 1e3;
   const controller = new AbortController();
@@ -8257,7 +8504,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 = basouPaths11(repositoryRoot);
+  const paths = basouPaths12(repositoryRoot);
   await assertWorkspaceInitialized8(paths.root);
   const nowIso = (ctx.nowProvider?.() ?? /* @__PURE__ */ new Date()).toISOString();
   const result = await refreshAll({
@@ -8366,10 +8613,10 @@ async function assertWorkspaceInitialized8(basouRoot) {
 import { isAbsolute as isAbsolute5, resolve as resolve9 } from "path";
 import {
   assertBasouRootSafe as assertBasouRootSafe10,
-  basouPaths as basouPaths12,
+  basouPaths as basouPaths13,
   findErrorCode as findErrorCode10,
   renderReport,
-  resolveRepositoryRoot as resolveRepositoryRoot9,
+  resolveRepositoryRoot as resolveRepositoryRoot8,
   writeMarkdownFile as writeMarkdownFile6
 } from "@basou/core";
 function registerReportCommand(program2) {
@@ -8391,7 +8638,7 @@ async function runReportGenerate(options, ctx = {}) {
 async function doRunReportGenerate(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForReport(cwd);
-  const paths = basouPaths12(repositoryRoot);
+  const paths = basouPaths13(repositoryRoot);
   await assertWorkspaceInitialized9(paths.root);
   const nowIso = (ctx.nowProvider?.() ?? /* @__PURE__ */ new Date()).toISOString();
   const result = await renderReport({
@@ -8418,7 +8665,7 @@ async function doRunReportGenerate(options, ctx) {
 }
 async function resolveRepositoryRootForReport(cwd) {
   try {
-    return await resolveRepositoryRoot9(cwd);
+    return await resolveRepositoryRoot8(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error(
@@ -8446,7 +8693,7 @@ import { homedir as homedir10 } from "os";
 import { resolve as resolve10 } from "path";
 import {
   assertBasouRootSafe as assertBasouRootSafe11,
-  basouPaths as basouPaths13,
+  basouPaths as basouPaths14,
   buildReviewRecordedEvent,
   buildReviewRecordLabel,
   createAdHocSessionWithEvent as createAdHocSessionWithEvent3,
@@ -8528,7 +8775,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 = basouPaths13(repositoryRoot);
+  const paths = basouPaths14(repositoryRoot);
   await assertWorkspaceInitialized10(paths.root);
   const raw = await readReviewInput(options, ctx);
   const review = parseReviewRecordInput(raw);
@@ -8675,17 +8922,17 @@ async function assertWorkspaceInitialized10(basouRoot) {
 
 // src/commands/review-gaps.ts
 import {
-  basouPaths as basouPaths14,
+  basouPaths as basouPaths15,
   findReviewGaps
 } from "@basou/core";
-import { InvalidArgumentError as InvalidArgumentError4 } from "commander";
+import { InvalidArgumentError as InvalidArgumentError5 } from "commander";
 function collectRepo(value, previous) {
   return [...previous, value];
 }
 function parseWindow(value) {
   const hours = Number(value);
   if (!Number.isInteger(hours) || hours <= 0) {
-    throw new InvalidArgumentError4("--window must be a positive integer (hours).");
+    throw new InvalidArgumentError5("--window must be a positive integer (hours).");
   }
   return hours;
 }
@@ -8716,7 +8963,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 = basouPaths14(repositoryRoot);
+  const paths = basouPaths15(repositoryRoot);
   const nowIso = (ctx.nowProvider?.() ?? /* @__PURE__ */ new Date()).toISOString();
   const summary = await findReviewGaps({
     paths,
@@ -8733,7 +8980,7 @@ async function doRunReviewGaps(options, ctx) {
   }
   return summary;
 }
-function relAge(iso, now) {
+function relAge2(iso, now) {
   if (iso === null) return "(unknown)";
   const ms = now.getTime() - Date.parse(iso);
   if (!Number.isFinite(ms) || ms < 0) return "just now";
@@ -8746,11 +8993,11 @@ function relAge(iso, now) {
 function flatten(value) {
   return value.replace(/\s+/gu, " ").trim();
 }
-var GRAPHEMES = new Intl.Segmenter(void 0, { granularity: "grapheme" });
+var GRAPHEMES2 = new Intl.Segmenter(void 0, { granularity: "grapheme" });
 function graphemes(value) {
-  return [...GRAPHEMES.segment(value)].map((s) => s.segment);
+  return [...GRAPHEMES2.segment(value)].map((s) => s.segment);
 }
-function oneLine(value, max) {
+function oneLine2(value, max) {
   const flat = graphemes(flatten(value));
   return flat.length > max ? `${flat.slice(0, max - 1).join("")}\u2026` : flat.join("");
 }
@@ -8763,7 +9010,7 @@ var SELF_REPORTS_SHOWN = 3;
 function selfReportSuffix(u, stillCounted) {
   if (u.selfReports.length === 0) return "";
   const parts = u.selfReports.slice(0, SELF_REPORTS_SHOWN).map(
-    (r) => `${oneLine(r.reviewer, 40)}${claimedCommits(r.commits)}${r.recordedAfterCommit ? " (recorded after the commit)" : ""}`
+    (r) => `${oneLine2(r.reviewer, 40)}${claimedCommits(r.commits)}${r.recordedAfterCommit ? " (recorded after the commit)" : ""}`
   );
   const rest = u.selfReports.length - parts.length;
   if (rest > 0) parts.push(`+${rest} more`);
@@ -8776,7 +9023,7 @@ function unobservedOutcomeSuffix(u) {
   return ` \xB7 ${scope}exited with no recorded status \u2014 landing assumed, not observed`;
 }
 function unitLine(u, now) {
-  const when = relAge(u.lastCommitAt, now);
+  const when = relAge2(u.lastCommitAt, now);
   const head = `- ${u.repo} ${when} (${u.commitCount} commit${u.commitCount === 1 ? "" : "s"})`;
   if (u.verdict === "near_unbound") {
     const ids = u.reviews.map((r) => r.sessionId.slice(0, 14)).join(", ");
@@ -8785,7 +9032,7 @@ function unitLine(u, now) {
   return `${head} \u2014 no bound cross-model review${selfReportSuffix(u, true)}${unobservedOutcomeSuffix(u)}`;
 }
 function candidateLine(u, now) {
-  const when = relAge(u.lastCommitAt, now);
+  const when = relAge2(u.lastCommitAt, now);
   const cite = u.reviews.map((r) => `${r.sessionId.slice(0, 14)}${r.examinedDiff ? "(diff)" : ""}`).join(", ");
   return `- ${u.repo} ${when} (${u.commitCount} commit${u.commitCount === 1 ? "" : "s"}) \u2014 review trace: ${cite}${selfReportSuffix(u, false)}${unobservedOutcomeSuffix(u)}`;
 }
@@ -8821,7 +9068,7 @@ function renderReviewGaps(summary) {
     );
     for (const u of summary.unknowns) {
       lines.push(
-        `- ${relAge(u.lastCommitAt, now)} (${u.commitCount} commit${u.commitCount === 1 ? "" : "s"}) [${u.sessionId}]`
+        `- ${relAge2(u.lastCommitAt, now)} (${u.commitCount} commit${u.commitCount === 1 ? "" : "s"}) [${u.sessionId}]`
       );
     }
     lines.push("");
@@ -8834,7 +9081,7 @@ function renderReviewGaps(summary) {
   }
   lines.push("");
   lines.push(
-    `Note: read-only advisory. Only captured commits are in scope (newest captured commit: ${summary.newestCommitAt === null ? "none" : relAge(summary.newestCommitAt, now)}). It never auto-judges that a review "happened", and temporal proximity alone is not a pass. It does not enforce.`
+    `Note: read-only advisory. Only captured commits are in scope (newest captured commit: ${summary.newestCommitAt === null ? "none" : relAge2(summary.newestCommitAt, now)}). It never auto-judges that a review "happened", and temporal proximity alone is not a pass. It does not enforce.`
   );
   if (summary.gaps.some((u) => u.selfReports.length > 0)) {
     lines.push(
@@ -8884,7 +9131,7 @@ import { join as join14 } from "path";
 import {
   acquireLock as acquireLock5,
   assertBasouRootSafe as assertBasouRootSafe12,
-  basouPaths as basouPaths15,
+  basouPaths as basouPaths16,
   ChildProcessRunner as ChildProcessRunner2,
   claudeCodeAdapterMetadata,
   codexAdapterMetadata,
@@ -8900,7 +9147,8 @@ import {
   readYamlFile as readYamlFile6,
   resolveClaudeCodeCommand,
   resolveCodexCommand,
-  resolveRepositoryRoot as resolveRepositoryRoot10,
+  resolveRepositoryRoot as resolveRepositoryRoot9,
+  SESSION_SCHEMA_VERSION as SESSION_SCHEMA_VERSION2,
   SessionSchema as SessionSchema2,
   sanitizeRelatedFiles,
   sanitizeWorkingDirectory as sanitizeWorkingDirectory2,
@@ -8955,7 +9203,7 @@ 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 = basouPaths15(repoRoot);
+  const paths = basouPaths16(repoRoot);
   await assertBasouRootSafe12(paths.root);
   const manifest = await readManifest9(paths);
   const sessionId = prefixedUlid4("ses");
@@ -9239,7 +9487,7 @@ function normalizeFileChangedSkipMessage(error) {
 function buildInitialSession2(input) {
   const cmdline = [input.command, ...input.args].join(" ");
   return {
-    schema_version: "0.1.0",
+    schema_version: SESSION_SCHEMA_VERSION2,
     session: {
       id: input.id,
       label: `basou run ${cmdline} (${input.startedAt})`,
@@ -9310,7 +9558,7 @@ async function finalizeSessionAsFailed2(paths, sessionDir, sessionId, appendEven
 }
 async function resolveRepositoryRootForRun(cwd) {
   try {
-    return await resolveRepositoryRoot10(cwd);
+    return await resolveRepositoryRoot9(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error("Not a git repository. Run 'git init' first, then re-run 'basou run'.", {
@@ -9344,11 +9592,12 @@ import {
   acquireLock as acquireLock6,
   appendEventToExistingSession as appendEventToExistingSession3,
   assertBasouRootSafe as assertBasouRootSafe13,
-  basouPaths as basouPaths16,
+  basouPaths as basouPaths17,
   EVENT_SCHEMA_VERSION as EVENT_SCHEMA_VERSION6,
   enumerateSessionDirs as enumerateSessionDirs2,
   findErrorCode as findErrorCode12,
   importSessionFromJson as importSessionFromJson2,
+  LOCAL_CLI_EVENT_SOURCE as LOCAL_CLI_EVENT_SOURCE4,
   loadSessionEntries as loadSessionEntries2,
   readAllEvents,
   readManifest as readManifest10,
@@ -9363,7 +9612,7 @@ import {
   SessionStatusSchema,
   sessionWorkStatsFromEvents
 } from "@basou/core";
-import { InvalidArgumentError as InvalidArgumentError5 } from "commander";
+import { InvalidArgumentError as InvalidArgumentError6 } from "commander";
 
 // src/lib/format-duration.ts
 import { formatDurationMs } from "@basou/core";
@@ -9412,7 +9661,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 = basouPaths16(repositoryRoot);
+  const paths = basouPaths17(repositoryRoot);
   await assertWorkspaceInitialized11(paths.root);
   const now = /* @__PURE__ */ new Date();
   const records = (await loadSessionEntries2(paths, {
@@ -9464,7 +9713,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 = basouPaths16(repositoryRoot);
+  const paths = basouPaths17(repositoryRoot);
   await assertWorkspaceInitialized11(paths.root);
   const sessionId = await resolveSessionId3(paths, idInput);
   const sessionDir = join15(paths.sessions, sessionId);
@@ -9776,7 +10025,7 @@ async function runSessionImport(options, ctx = {}) {
 async function doRunSessionImport(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForSession(cwd, "import");
-  const paths = basouPaths16(repositoryRoot);
+  const paths = basouPaths17(repositoryRoot);
   await assertWorkspaceInitialized11(paths.root);
   const manifest = await readManifest10(paths);
   const rawBody = await readInputFile(options.from);
@@ -9786,7 +10035,9 @@ async function doRunSessionImport(options, ctx) {
     throw new Error("Invalid import payload", { cause: parsed.error });
   }
   if (parsed.data.schema_version !== SESSION_IMPORT_SCHEMA_VERSION2) {
-    throw new Error(`Unsupported import schema_version: ${parsed.data.schema_version}`);
+    throw new Error(
+      `Unsupported import schema_version: ${parsed.data.schema_version} (expected ${SESSION_IMPORT_SCHEMA_VERSION2}). The envelope's shape is published as @basou/core/schemas/session-import.schema.json; this version may move at a minor release, so a producer should read it from the installed @basou/core rather than pinning it.`
+    );
   }
   const importOptions2 = { dryRun: options.dryRun === true };
   if (options.label !== void 0) importOptions2.labelOverride = options.label;
@@ -9825,19 +10076,19 @@ function parseJsonStrict(body) {
 }
 function parseImportFormat(raw) {
   if (raw !== "json") {
-    throw new InvalidArgumentError5(`Unsupported format: ${raw}. Valid values: json`);
+    throw new InvalidArgumentError6(`Unsupported format: ${raw}. Valid values: json`);
   }
   return "json";
 }
 function parseLabelOverride(raw) {
   if (raw.length === 0) {
-    throw new InvalidArgumentError5("Label must not be empty");
+    throw new InvalidArgumentError6("Label must not be empty");
   }
   return raw;
 }
 function parseTaskIdOverride(raw) {
   if (raw.length === 0) {
-    throw new InvalidArgumentError5("Task id is empty");
+    throw new InvalidArgumentError6("Task id is empty");
   }
   return raw;
 }
@@ -9890,7 +10141,7 @@ async function doRunSessionNote(sessionIdInput, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForSession(cwd, "note");
-  const paths = basouPaths16(repositoryRoot);
+  const paths = basouPaths17(repositoryRoot);
   await assertWorkspaceInitialized11(paths.root);
   const sessionId = await resolveSessionId3(paths, sessionIdInput);
   const body = hasBody ? options.body : await readNoteFile(options.fromFile);
@@ -9910,7 +10161,7 @@ async function doRunSessionNote(sessionIdInput, options, ctx) {
         id: eventId,
         session_id: sesId,
         occurred_at: occurredAt,
-        source: "local-cli",
+        source: LOCAL_CLI_EVENT_SOURCE4,
         type: "note_added",
         body
       })
@@ -9935,7 +10186,7 @@ async function readNoteFile(path) {
 }
 function parseNoteBodyOption(raw) {
   if (raw.length === 0) {
-    throw new InvalidArgumentError5("--body must not be empty");
+    throw new InvalidArgumentError6("--body must not be empty");
   }
   return raw;
 }
@@ -9972,7 +10223,7 @@ async function doRunSessionRechain(options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForSession(cwd, "rechain");
-  const paths = basouPaths16(repositoryRoot);
+  const paths = basouPaths17(repositoryRoot);
   await assertWorkspaceInitialized11(paths.root);
   const sessionIds = options.session !== void 0 ? [await resolveSessionId3(paths, options.session)] : await enumerateSessionDirs2(paths);
   const dryRun = options.dryRun === true;
@@ -10027,10 +10278,10 @@ function renderRechainRow(row, dryRun) {
 // src/commands/stats.ts
 import {
   assertBasouRootSafe as assertBasouRootSafe14,
-  basouPaths as basouPaths17,
+  basouPaths as basouPaths18,
   computeWorkStats,
   findErrorCode as findErrorCode13,
-  resolveRepositoryRoot as resolveRepositoryRoot11
+  resolveRepositoryRoot as resolveRepositoryRoot10
 } from "@basou/core";
 function registerStatsCommand(program2) {
   program2.command("stats").description("Report how much the AI worked (output volume + time proxies) across sessions").option("--by-source", "Break the totals down by session source kind").option("--by-day", "Break billable time and volume down by calendar day").option("--json", "Output the full stats as JSON").option("-v, --verbose", "Show error causes").action(async (options) => {
@@ -10048,7 +10299,7 @@ async function runStats(options, ctx = {}) {
 async function doRunStats(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForStats(cwd);
-  const paths = basouPaths17(repositoryRoot);
+  const paths = basouPaths18(repositoryRoot);
   await assertWorkspaceInitialized12(paths.root);
   const now = ctx.nowProvider?.() ?? /* @__PURE__ */ new Date();
   const result = await computeWorkStats({
@@ -10137,7 +10388,7 @@ function formatInt(n) {
 }
 async function resolveRepositoryRootForStats(cwd) {
   try {
-    return await resolveRepositoryRoot11(cwd);
+    return await resolveRepositoryRoot10(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error("Not a git repository. Run 'git init' first, then re-run 'basou stats'.", {
@@ -10161,11 +10412,11 @@ async function assertWorkspaceInitialized12(basouRoot) {
 // src/commands/status.ts
 import {
   assertBasouRootSafe as assertBasouRootSafe15,
-  basouPaths as basouPaths18,
+  basouPaths as basouPaths19,
   buildStatusSnapshot,
   findErrorCode as findErrorCode14,
   readManifest as readManifest11,
-  resolveRepositoryRoot as resolveRepositoryRoot12,
+  resolveRepositoryRoot as resolveRepositoryRoot11,
   writeStatus
 } from "@basou/core";
 function registerStatusCommand(program2) {
@@ -10184,7 +10435,7 @@ async function runStatus(options, ctx = {}) {
 async function doRunStatus(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForStatus(cwd);
-  const paths = basouPaths18(repositoryRoot);
+  const paths = basouPaths19(repositoryRoot);
   try {
     await assertBasouRootSafe15(paths.root);
   } catch (error) {
@@ -10223,7 +10474,7 @@ function renderTextStatus(s) {
 }
 async function resolveRepositoryRootForStatus(cwd) {
   try {
-    return await resolveRepositoryRoot12(cwd);
+    return await resolveRepositoryRoot11(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error("Not a git repository. Run 'git init' first, then re-run 'basou status'.", {
@@ -10252,7 +10503,7 @@ import { join as join16 } from "path";
 import {
   archiveTask,
   assertBasouRootSafe as assertBasouRootSafe16,
-  basouPaths as basouPaths19,
+  basouPaths as basouPaths20,
   createTaskWithEvent,
   deleteTask,
   editTask,
@@ -10274,7 +10525,7 @@ import {
   TaskWriteAfterEventError,
   updateTaskStatusWithEvent
 } from "@basou/core";
-import { InvalidArgumentError as InvalidArgumentError6 } from "commander";
+import { InvalidArgumentError as InvalidArgumentError7 } from "commander";
 var STATUS_VALUES3 = TaskStatusSchema.options;
 function registerTaskCommand(program2) {
   const task = program2.command("task").description("Manage Basou tasks (purpose units that span sessions)");
@@ -10353,7 +10604,7 @@ async function doRunTaskNew(options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "new");
-  const paths = basouPaths19(repositoryRoot);
+  const paths = basouPaths20(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();
@@ -10462,7 +10713,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 = basouPaths19(repositoryRoot);
+  const paths = basouPaths20(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
   const entries = await loadTaskEntries(paths, {
     onSkip: (id, reason) => printTaskSkip(id, reason)
@@ -10566,7 +10817,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 = basouPaths19(repositoryRoot);
+  const paths = basouPaths20(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
   const taskId = await resolveTaskId2(paths, idInput, { includeArchived: true });
   const { doc, archived } = await readTaskFileWithArchiveFallback(paths, taskId);
@@ -10710,7 +10961,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 = basouPaths19(repositoryRoot);
+  const paths = basouPaths20(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
   const taskId = await resolveTaskId2(paths, taskIdInput);
   const now = ctx.nowProvider !== void 0 ? ctx.nowProvider() : /* @__PURE__ */ new Date();
@@ -10787,7 +11038,7 @@ async function runTaskReconcile(options, ctx = {}) {
 async function doRunTaskReconcile(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "reconcile");
-  const paths = basouPaths19(repositoryRoot);
+  const paths = basouPaths20(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
   const manifest = await readManifest12(paths);
   const nowProvider = ctx.nowProvider ?? (() => /* @__PURE__ */ new Date());
@@ -10967,7 +11218,7 @@ async function doRunTaskRefreshLinkage(taskIdInput, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "refresh-linkage");
-  const paths = basouPaths19(repositoryRoot);
+  const paths = basouPaths20(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
   const manifest = await readManifest12(paths);
   const taskId = await resolveTaskId2(paths, taskIdInput);
@@ -11047,7 +11298,7 @@ async function doRunTaskEdit(taskIdInput, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "edit");
-  const paths = basouPaths19(repositoryRoot);
+  const paths = basouPaths20(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
   const manifest = await readManifest12(paths);
   const taskId = await resolveTaskId2(paths, taskIdInput);
@@ -11103,7 +11354,7 @@ async function doRunTaskDelete(taskIdInput, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "delete");
-  const paths = basouPaths19(repositoryRoot);
+  const paths = basouPaths20(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
   const manifest = await readManifest12(paths);
   const taskId = await resolveTaskId2(paths, taskIdInput);
@@ -11148,7 +11399,7 @@ async function doRunTaskArchive(taskIdInput, options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForTask(cwd, "archive");
-  const paths = basouPaths19(repositoryRoot);
+  const paths = basouPaths20(repositoryRoot);
   await assertWorkspaceInitialized13(paths.root);
   const manifest = await readManifest12(paths);
   const taskId = await resolveTaskId2(paths, taskIdInput);
@@ -11203,20 +11454,20 @@ async function readSingleLineFromStdin() {
 }
 function parseTitle2(raw) {
   if (raw.length === 0) {
-    throw new InvalidArgumentError6("Title must not be empty");
+    throw new InvalidArgumentError7("Title must not be empty");
   }
   return raw;
 }
 function parseLabel(raw) {
   if (raw.length === 0) {
-    throw new InvalidArgumentError6("Label must not be empty");
+    throw new InvalidArgumentError7("Label must not be empty");
   }
   return raw;
 }
 function parseInitialTaskStatus(raw) {
   const result = TaskStatusSchema.safeParse(raw);
   if (!result.success) {
-    throw new InvalidArgumentError6(
+    throw new InvalidArgumentError7(
       `Initial task status must be one of: ${STATUS_VALUES3.join(", ")}`
     );
   }
@@ -11225,7 +11476,7 @@ function parseInitialTaskStatus(raw) {
 var ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/;
 function parseIsoTimestampOption(raw) {
   if (!ISO_DATE_RE.test(raw) || Number.isNaN(Date.parse(raw))) {
-    throw new InvalidArgumentError6(
+    throw new InvalidArgumentError7(
       "Invalid --completed-at value; expected ISO-8601 timestamp like 2026-05-10T12:34:56+09:00"
     );
   }
@@ -11234,7 +11485,7 @@ function parseIsoTimestampOption(raw) {
 function parseTaskStatusFilter(raw) {
   const result = TaskStatusSchema.safeParse(raw);
   if (!result.success) {
-    throw new InvalidArgumentError6(
+    throw new InvalidArgumentError7(
       `Invalid task status: ${raw}. Valid values: ${STATUS_VALUES3.join(", ")}`
     );
   }
@@ -11249,14 +11500,14 @@ function parseTaskStatusPositional(raw) {
 }
 function parseDescriptionOption(raw) {
   if (raw.length === 0) {
-    throw new InvalidArgumentError6("Description must not be empty");
+    throw new InvalidArgumentError7("Description must not be empty");
   }
   return raw;
 }
 function parsePositiveInt2(raw) {
   const n = Number.parseInt(raw, 10);
   if (!Number.isInteger(n) || n < 1 || raw.trim() !== String(n)) {
-    throw new InvalidArgumentError6(`Invalid number: ${raw}`);
+    throw new InvalidArgumentError7(`Invalid number: ${raw}`);
   }
   return n;
 }
@@ -11369,10 +11620,10 @@ function maxLen3(values, floor) {
 // src/commands/verify.ts
 import {
   assertBasouRootSafe as assertBasouRootSafe17,
-  basouPaths as basouPaths20,
+  basouPaths as basouPaths21,
   enumerateSessionDirs as enumerateSessionDirs3,
   findErrorCode as findErrorCode16,
-  resolveRepositoryRoot as resolveRepositoryRoot13,
+  resolveRepositoryRoot as resolveRepositoryRoot12,
   resolveSessionId as resolveSessionId5,
   verifyEventsChain
 } from "@basou/core";
@@ -11395,7 +11646,7 @@ async function doRunVerify(options, ctx) {
   }
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForVerify(cwd);
-  const paths = basouPaths20(repositoryRoot);
+  const paths = basouPaths21(repositoryRoot);
   await assertWorkspaceInitialized14(paths.root);
   const sessionIds = options.session !== void 0 ? [await resolveSessionId5(paths, options.session)] : await enumerateSessionDirs3(paths);
   const rows = [];
@@ -11443,7 +11694,7 @@ function renderVerdict(row) {
 }
 async function resolveRepositoryRootForVerify(cwd) {
   try {
-    return await resolveRepositoryRoot13(cwd);
+    return await resolveRepositoryRoot12(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error("Not a git repository. Run 'git init' first, then re-run 'basou verify'.", {
@@ -11470,12 +11721,12 @@ import { createHash as createHash2 } from "crypto";
 import { basename as basename10, resolve as resolve13 } from "path";
 import {
   assertBasouRootSafe as assertBasouRootSafe18,
-  basouPaths as basouPaths22,
+  basouPaths as basouPaths23,
   findErrorCode as findErrorCode18,
   readManifest as readManifest16,
-  resolveRepositoryRoot as resolveRepositoryRoot15
+  resolveRepositoryRoot as resolveRepositoryRoot14
 } from "@basou/core";
-import { InvalidArgumentError as InvalidArgumentError7 } from "commander";
+import { InvalidArgumentError as InvalidArgumentError8 } from "commander";
 
 // src/lib/portfolio-coverage.ts
 import { createReadStream as createReadStream2 } from "fs";
@@ -11483,7 +11734,7 @@ import { readdir as readdir3, stat as stat6 } 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 basouPaths21, readManifest as readManifest13, resolveRepositoryRoot as resolveRepositoryRoot14 } from "@basou/core";
+import { basouPaths as basouPaths22, readManifest as readManifest13, resolveRepositoryRoot as resolveRepositoryRoot13 } from "@basou/core";
 function uncapturedTotal(result) {
   return result.groups.reduce((sum, g) => sum + g.logs, 0) + result.unplaceable;
 }
@@ -11519,14 +11770,14 @@ async function collectDeclaredRoots(workspaces) {
   for (const ws of workspaces) {
     let importRoot;
     try {
-      importRoot = await resolveRepositoryRoot14(ws.repoRoot);
+      importRoot = await resolveRepositoryRoot13(ws.repoRoot);
     } catch {
       inertWorkspaces.push({ path: ws.repoRoot, reason: "not_a_git_repo" });
       continue;
     }
     let resolved;
     try {
-      const manifest = await readManifest13(basouPaths21(importRoot));
+      const manifest = await readManifest13(basouPaths22(importRoot));
       resolved = resolveSourceRoots({
         projectFlags: [],
         manifest,
@@ -11793,12 +12044,12 @@ function inertLines(result) {
 }
 
 // src/lib/portfolio-safety.ts
-import { execFile } from "child_process";
+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 } from "util";
+import { promisify as promisify2 } from "util";
 import { readManifest as readManifest14 } from "@basou/core";
-var execFileAsync = promisify(execFile);
+var execFileAsync2 = promisify2(execFile2);
 function errorCode(error) {
   return error instanceof Error ? error.code : void 0;
 }
@@ -11830,7 +12081,7 @@ async function inspectRepo(repoPath) {
     }
   }
   try {
-    const { stdout } = await execFileAsync("git", ["-C", repoPath, "ls-files", "-z"]);
+    const { stdout } = await execFileAsync2("git", ["-C", repoPath, "ls-files", "-z"]);
     const tracked = stdout.split("\0").some((f) => f.length > 0 && isBasouPath(f));
     if (tracked) {
       return {
@@ -13163,7 +13414,7 @@ var DEFAULT_PORT = 4319;
 function parsePort(value) {
   const port = Number.parseInt(value, 10);
   if (!Number.isInteger(port) || port < 1 || port > 65535) {
-    throw new InvalidArgumentError7("Port must be an integer between 1 and 65535.");
+    throw new InvalidArgumentError8("Port must be an integer between 1 and 65535.");
   }
   return port;
 }
@@ -13249,7 +13500,7 @@ async function doRunView(options, ctx) {
 }
 async function buildSingleDeps(ctx, cwd) {
   const repositoryRoot = await resolveRepositoryRootForView(cwd);
-  const paths = basouPaths22(repositoryRoot);
+  const paths = basouPaths23(repositoryRoot);
   await assertWorkspaceInitialized15(paths.root);
   const entry = await buildWorkspaceEntry(repositoryRoot, ctx);
   return {
@@ -13283,7 +13534,7 @@ async function buildPortfolioDeps(workspaceFlags, ctx, cwd) {
   };
 }
 async function buildWorkspaceEntry(repoRoot, ctx, labelOverride) {
-  const paths = basouPaths22(repoRoot);
+  const paths = basouPaths23(repoRoot);
   const importCtx = {
     cwd: repoRoot,
     ...ctx.claudeProjectsDir !== void 0 ? { claudeProjectsDir: ctx.claudeProjectsDir } : {},
@@ -13370,7 +13621,7 @@ function waitForShutdown(signal) {
 }
 async function resolveRepositoryRootForView(cwd) {
   try {
-    return await resolveRepositoryRoot15(cwd);
+    return await resolveRepositoryRoot14(cwd);
   } catch (error) {
     if (error instanceof Error && error.message === "Not a git repository") {
       throw new Error("Not a git repository. Run 'git init' first, then re-run 'basou view'.", {
@@ -13392,12 +13643,30 @@ async function assertWorkspaceInitialized15(basouRoot) {
 }
 
 // src/program.ts
+function readBuildStamp() {
+  if (false) return void 0;
+  try {
+    return JSON.parse('{"version":"0.45.0","commit":"6b04208","committedAt":"2026-09-19T01:07:28+09:00"}');
+  } catch {
+    return void 0;
+  }
+}
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../package.json");
-var BASOU_CLI_VERSION = pkg.version;
+var BASOU_BUILD = readBuildStamp();
+var BASOU_CLI_VERSION = BASOU_BUILD?.version ?? pkg.version;
+var BASOU_VERSION_LINE = buildVersionLine();
+function buildVersionLine() {
+  if (BASOU_BUILD === void 0) return `${pkg.version} (source)`;
+  const coreBuild = basouCore.BASOU_CORE_BUILD;
+  const self = `${BASOU_BUILD.version} (build ${BASOU_BUILD.commit}, ${BASOU_BUILD.committedAt})`;
+  if (coreBuild === void 0) return `${self}; core build unknown (not stamped)`;
+  if (coreBuild.commit === BASOU_BUILD.commit) return self;
+  return `${self}; core build ${coreBuild.commit}, ${coreBuild.committedAt}`;
+}
 function buildProgram() {
   const program2 = new Command();
-  program2.name("basou").description("A harness for steering AI coding agents").version(BASOU_CLI_VERSION).enablePositionalOptions();
+  program2.name("basou").description("A harness for steering AI coding agents").version(BASOU_VERSION_LINE).enablePositionalOptions();
   registerInitCommand(program2);
   registerStatusCommand(program2);
   registerStatsCommand(program2);