@basou/cli 0.13.0 → 0.14.0

package/dist/program.js

@@ -633,6 +633,9 @@ function printNoApprovals(options) {
 }
 
 // src/commands/decision.ts
+import { readFile } from "fs/promises";
+import { homedir } from "os";
+import { resolve } from "path";
 import {
   acquireLock as acquireLock2,
   appendEventToExistingSession,
@@ -640,12 +643,34 @@ import {
   basouPaths as basouPaths2,
   createAdHocSessionWithEvent,
   findErrorCode as findErrorCode2,
+  isValidPrefixedId,
   prefixedUlid as prefixedUlid2,
   readManifest,
   resolveRepositoryRoot as resolveRepositoryRoot2,
-  resolveSessionId
+  resolveSessionId,
+  sanitizePath
 } from "@basou/core";
 import { InvalidArgumentError } from "commander";
+
+// src/lib/repo-root.ts
+import { resolveBasouRepositoryRoot } from "@basou/core";
+async function resolveBasouRootForCommand(cwd, commandName) {
+  try {
+    return await resolveBasouRepositoryRoot(cwd, {
+      onRedirect: ({ via, root }) => console.error(`Resolved workspace view to ${root} (via ${via}).`)
+    });
+  } 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 ${commandName}'.`,
+        { cause: error }
+      );
+    }
+    throw error;
+  }
+}
+
+// src/commands/decision.ts
 var LABEL_TITLE_MAX = 80;
 var LABEL_TRUNCATE_HEAD = LABEL_TITLE_MAX - 3;
 function registerDecisionCommand(program) {
@@ -675,7 +700,34 @@ function registerDecisionCommand(program) {
   ).option("--json", "Output the result as JSON").option("-v, --verbose", "Show error causes").action(async (options) => {
     await runDecisionRecord(options);
   });
+  decision.command("capture").description(
+    "Capture a batch of decisions from a JSON array (stdin or --file). The in-loop agent extracts a session's conversational decisions -- with rationale, alternatives, and rejected reasons -- and pipes them in; basou writes them deterministically into one ad-hoc session."
+  ).option("--file <path>", "Read the JSON array from a file instead of stdin").option("--dry-run", "Validate and preview the decisions without writing them").option("--json", "Output the result as JSON").option("-v, --verbose", "Show error causes").addHelpText("after", CAPTURE_HELP).action(async (options) => {
+    await runDecisionCapture(options);
+  });
 }
+var CAPTURE_HELP = `
+Input format (a JSON array; one object per decision):
+  [
+    {
+      "title": "Adopt pnpm for the monorepo",
+      "rationale": "Workspace protocol and a content-addressed store fit our layout.",
+      "alternatives": ["npm workspaces", "yarn"],
+      "rejected_reason": "npm hoisting caused phantom-dependency bugs",
+      "linked_files": ["pnpm-workspace.yaml"]
+    }
+  ]
+
+Only "title" is required; every other field is optional. All decisions are
+written into one ad-hoc session timestamped now, so orientation surfaces them
+as the latest decisions. Run from a workspace-view directory and it resolves to
+the planning repo, like 'basou orient' / 'basou refresh' / 'basou note'.
+
+Example (heredoc on stdin):
+  basou decision capture <<'JSON'
+  [{ "title": "Ship the capture command", "rationale": "Close the why-capture gap" }]
+  JSON
+`;
 async function runDecisionRecord(options, ctx = {}) {
   try {
     await doRunDecisionRecord(options, ctx);
@@ -761,6 +813,259 @@ async function doRunDecisionRecord(options, ctx) {
     rich
   });
 }
+async function runDecisionCapture(options, ctx = {}) {
+  try {
+    await doRunDecisionCapture(options, ctx);
+  } catch (error) {
+    renderCliError(error, {
+      verbose: isVerbose(options),
+      classifiers: [failedToFinalizeClassifier]
+    });
+    process.exitCode = 1;
+  }
+}
+async function doRunDecisionCapture(options, ctx) {
+  const cwd = ctx.cwd ?? process.cwd();
+  const repositoryRoot = await resolveBasouRootForCommand(cwd, "decision capture");
+  const paths = basouPaths2(repositoryRoot);
+  await assertWorkspaceInitialized2(paths.root);
+  const raw = await readCaptureInput(options, ctx);
+  const decisions = parseCaptureInput(raw);
+  if (options.dryRun === true) {
+    printCapturePreview(options, decisions);
+    return;
+  }
+  const now = ctx.nowProvider !== void 0 ? ctx.nowProvider() : /* @__PURE__ */ new Date();
+  const occurredAt = now.toISOString();
+  const decisionIds = decisions.map(() => prefixedUlid2("decision"));
+  const manifest = await readManifest(paths);
+  const invocationArgs = options.file !== void 0 ? [
+    "--file",
+    sanitizePath(resolve(cwd, options.file), {
+      workingDirectory: repositoryRoot,
+      homedir: homedir()
+    })
+  ] : [];
+  const adHoc = await createAdHocSessionWithEvent({
+    paths,
+    manifest,
+    label: buildCaptureLabel(decisions.length),
+    occurredAt,
+    sessionSource: "human",
+    workingDirectory: repositoryRoot,
+    invocation: {
+      command: "basou decision capture",
+      args: invocationArgs
+    },
+    targetEventBuilders: decisions.map(
+      (decision, index) => (sessionId, eventId) => buildDecisionEvent({
+        eventId,
+        sessionId,
+        decisionId: decisionIds[index],
+        title: decision.title,
+        occurredAt,
+        rich: toRichFields(decision)
+      })
+    )
+  });
+  printCaptureResult(options, {
+    sessionId: adHoc.sessionId,
+    items: decisions.map((decision, index) => ({
+      decisionId: decisionIds[index],
+      eventId: adHoc.targetEventIds[index],
+      input: decision
+    }))
+  });
+}
+async function readCaptureInput(options, ctx) {
+  if (options.file !== void 0) {
+    try {
+      return await readFile(options.file, "utf8");
+    } catch (error) {
+      if (findErrorCode2(error, "ENOENT")) {
+        throw new Error(`Input file not found: ${options.file}`);
+      }
+      throw error;
+    }
+  }
+  if (ctx.readInput !== void 0) {
+    return await ctx.readInput();
+  }
+  if (process.stdin.isTTY === true) {
+    throw new Error(NO_INPUT_HINT);
+  }
+  return await readStdinToEnd();
+}
+async function readStdinToEnd() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+var NO_INPUT_HINT = "No input: pipe a JSON array of decisions to stdin or pass --file <path>.";
+var CAPTURE_ALLOWED_KEYS = /* @__PURE__ */ new Set([
+  "title",
+  "rationale",
+  "rejected_reason",
+  "alternatives",
+  "linked_events",
+  "linked_files"
+]);
+function parseCaptureInput(raw) {
+  if (raw.trim().length === 0) {
+    throw new Error(NO_INPUT_HINT);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new Error(`Input is not valid JSON: ${detail}`);
+  }
+  if (!Array.isArray(parsed)) {
+    throw new Error("Input must be a JSON array of decision objects.");
+  }
+  if (parsed.length === 0) {
+    throw new Error("Input array must contain at least one decision.");
+  }
+  return parsed.map((item, index) => validateCaptureItem(item, index));
+}
+function validateCaptureItem(item, index) {
+  if (typeof item !== "object" || item === null || Array.isArray(item)) {
+    throw new Error(`decision[${index}] must be a JSON object.`);
+  }
+  const obj = item;
+  for (const key of Object.keys(obj)) {
+    if (!CAPTURE_ALLOWED_KEYS.has(key)) {
+      throw new Error(
+        `decision[${index}]: unknown field '${key}'. Allowed: title, rationale, rejected_reason, alternatives, linked_events, linked_files.`
+      );
+    }
+  }
+  if (typeof obj.title !== "string" || isBlank(obj.title)) {
+    throw new Error(`decision[${index}].title must be a non-empty string.`);
+  }
+  const out = { title: obj.title };
+  if (obj.rationale !== void 0) {
+    out.rationale = requireNonEmptyString(obj.rationale, index, "rationale");
+  }
+  if (obj.rejected_reason !== void 0) {
+    out.rejected_reason = requireNonEmptyString(obj.rejected_reason, index, "rejected_reason");
+  }
+  if (obj.alternatives !== void 0) {
+    out.alternatives = validateStringArray(obj.alternatives, index, "alternatives", (value, i) => {
+      if (isBlank(value)) {
+        throw new Error(`decision[${index}].alternatives[${i}] must not be empty.`);
+      }
+    });
+  }
+  if (obj.linked_events !== void 0) {
+    out.linked_events = validateStringArray(
+      obj.linked_events,
+      index,
+      "linked_events",
+      (value, i) => {
+        if (!isValidEventId(value)) {
+          throw new Error(
+            `decision[${index}].linked_events[${i}] must match evt_<ULID>, got '${value}'.`
+          );
+        }
+      }
+    );
+  }
+  if (obj.linked_files !== void 0) {
+    out.linked_files = validateStringArray(obj.linked_files, index, "linked_files", (value, i) => {
+      if (isBlank(value)) {
+        throw new Error(`decision[${index}].linked_files[${i}] must not be empty.`);
+      }
+      if (value.length > 4096) {
+        throw new Error(`decision[${index}].linked_files[${i}] exceeds 4096 chars.`);
+      }
+    });
+  }
+  return out;
+}
+function requireNonEmptyString(value, index, field) {
+  if (typeof value !== "string" || isBlank(value)) {
+    throw new Error(`decision[${index}].${field} must be a non-empty string.`);
+  }
+  return value;
+}
+function isBlank(value) {
+  return value.trim().length === 0;
+}
+function validateStringArray(value, index, field, checkEach) {
+  if (!Array.isArray(value)) {
+    throw new Error(`decision[${index}].${field} must be an array of strings.`);
+  }
+  return value.map((entry, i) => {
+    if (typeof entry !== "string") {
+      throw new Error(`decision[${index}].${field}[${i}] must be a string.`);
+    }
+    checkEach(entry, i);
+    return entry;
+  });
+}
+function toRichFields(decision) {
+  const out = {};
+  if (decision.rationale !== void 0) out.rationale = decision.rationale;
+  if (decision.rejected_reason !== void 0) out.rejected_reason = decision.rejected_reason;
+  if (decision.alternatives !== void 0) out.alternatives = [...decision.alternatives];
+  if (decision.linked_events !== void 0) out.linked_events = [...decision.linked_events];
+  if (decision.linked_files !== void 0) out.linked_files = [...decision.linked_files];
+  return out;
+}
+function buildCaptureLabel(count) {
+  return `Ad-hoc capture: ${count} decision${count === 1 ? "" : "s"}`;
+}
+function captureItemToPayload(item) {
+  const payload = {
+    decision_id: item.decisionId,
+    event_id: item.eventId,
+    title: item.input.title
+  };
+  if (item.input.rationale !== void 0) payload.rationale = item.input.rationale;
+  if (item.input.alternatives !== void 0) payload.alternatives = item.input.alternatives;
+  if (item.input.rejected_reason !== void 0)
+    payload.rejected_reason = item.input.rejected_reason;
+  if (item.input.linked_events !== void 0) payload.linked_events = item.input.linked_events;
+  if (item.input.linked_files !== void 0) payload.linked_files = item.input.linked_files;
+  return payload;
+}
+function printCapturePreview(options, decisions) {
+  if (options.json === true) {
+    console.log(JSON.stringify({ dry_run: true, count: decisions.length, decisions }));
+    return;
+  }
+  console.log(
+    `Would capture ${decisions.length} decision${decisions.length === 1 ? "" : "s"} (dry run; nothing written):`
+  );
+  for (const decision of decisions) {
+    console.log(`- ${decision.title}`);
+  }
+}
+function printCaptureResult(options, result) {
+  const sid = shortSessionId(result.sessionId);
+  if (options.json === true) {
+    console.log(
+      JSON.stringify({
+        mode: "ad-hoc",
+        session_id: result.sessionId,
+        session_status: "completed",
+        count: result.items.length,
+        decisions: result.items.map(captureItemToPayload)
+      })
+    );
+    return;
+  }
+  console.log(
+    `Captured ${result.items.length} decision${result.items.length === 1 ? "" : "s"} in ad-hoc session ${sid}:`
+  );
+  for (const item of result.items) {
+    console.log(`- ${item.decisionId}: ${item.input.title}`);
+  }
+}
 function pickRichFields(options) {
   const out = {};
   if (options.rationale !== void 0) out.rationale = options.rationale;
@@ -798,38 +1103,40 @@ function buildAdHocLabel(title) {
   return `Ad-hoc decision: ${truncated}`;
 }
 function parseTitle(raw) {
-  if (raw.length === 0) {
+  if (isBlank(raw)) {
     throw new InvalidArgumentError("Title must not be empty");
   }
   return raw;
 }
 function parseRationale(raw) {
-  if (raw.length === 0) {
+  if (isBlank(raw)) {
     throw new InvalidArgumentError("Rationale must not be empty");
   }
   return raw;
 }
 function parseRejectedReason(raw) {
-  if (raw.length === 0) {
+  if (isBlank(raw)) {
     throw new InvalidArgumentError("Rejected reason must not be empty");
   }
   return raw;
 }
 function collectAlternative(value, prev) {
-  if (value.length === 0) {
+  if (isBlank(value)) {
     throw new InvalidArgumentError("Alternative must not be empty");
   }
   return prev.concat(value);
 }
-var EVENT_ID_RE = /^evt_[A-Z0-9]+$/;
+function isValidEventId(value) {
+  return isValidPrefixedId(value) && value.startsWith("evt_");
+}
 function collectLinkedEvent(value, prev) {
-  if (!EVENT_ID_RE.test(value)) {
+  if (!isValidEventId(value)) {
     throw new InvalidArgumentError(`Linked event id must match evt_<ULID>, got '${value}'`);
   }
   return prev.concat(value);
 }
 function collectLinkedFile(value, prev) {
-  if (value.length === 0) {
+  if (isBlank(value)) {
     throw new InvalidArgumentError("Linked file path must not be empty");
   }
   if (value.length > 4096) {
@@ -960,7 +1267,7 @@ async function assertWorkspaceInitialized3(basouRoot) {
 
 // src/commands/exec.ts
 import { mkdir } from "fs/promises";
-import { homedir } from "os";
+import { homedir as homedir2 } from "os";
 import { join as join2 } from "path";
 import {
   acquireLock as acquireLock3,
@@ -1212,7 +1519,7 @@ function buildInitialSession(input) {
       source: { kind: "terminal", version: "0.1.0" },
       started_at: input.startedAt,
       status: "initialized",
-      working_directory: sanitizeWorkingDirectory(input.cwd, { homedir: homedir() }),
+      working_directory: sanitizeWorkingDirectory(input.cwd, { homedir: homedir2() }),
       invocation: {
         command: input.command,
         args: [...input.args],
@@ -1355,9 +1662,9 @@ async function assertWorkspaceInitialized4(basouRoot) {
 
 // src/commands/import.ts
 import { createReadStream } from "fs";
-import { readdir, readFile, rm, stat } from "fs/promises";
-import { homedir as homedir2 } from "os";
-import { basename, join as join3, resolve } from "path";
+import { readdir, readFile as readFile2, rm, stat } from "fs/promises";
+import { homedir as homedir3 } from "os";
+import { basename, join as join3, resolve as resolve2 } from "path";
 import { createInterface } from "readline";
 import {
   assertBasouRootSafe as assertBasouRootSafe6,
@@ -1425,10 +1732,10 @@ function resolveSourceRoots(args) {
   const { projectFlags, manifest, repoRoot, cwd } = args;
   let resolved;
   if (projectFlags.length > 0) {
-    resolved = projectFlags.map((p) => resolve(cwd, p));
+    resolved = projectFlags.map((p) => resolve2(cwd, p));
   } else {
     const roots = manifest.import?.source_roots;
-    resolved = roots !== void 0 && roots.length > 0 ? roots.map((r) => resolve(repoRoot, r)) : [repoRoot];
+    resolved = roots !== void 0 && roots.length > 0 ? roots.map((r) => resolve2(repoRoot, r)) : [repoRoot];
   }
   return [...new Set(resolved)];
 }
@@ -1441,8 +1748,9 @@ async function doRunImportClaudeCode(options, ctx) {
     repoRoot: repositoryRoot,
     cwd: ctx.cwd ?? process.cwd()
   });
-  const projectsRoot = ctx.claudeProjectsDir ?? join3(homedir2(), ".claude", "projects");
+  const projectsRoot = ctx.claudeProjectsDir ?? join3(homedir3(), ".claude", "projects");
   const files = await selectTranscriptFiles(projectsRoot, projectPaths, options);
+  const projectSet = new Set(projectPaths);
   const candidates = files.map((file) => {
     const externalId = basename(file, ".jsonl");
     return {
@@ -1450,6 +1758,8 @@ async function doRunImportClaudeCode(options, ctx) {
       sourcePath: file,
       toPayload: async () => {
         const { records, sizeBytes } = await readJsonlRecords(file);
+        const cwd = firstTranscriptCwd(records);
+        if (cwd === void 0 || !projectSet.has(cwd)) return null;
         return claudeTranscriptToImportPayload(records, {
           workspaceId: manifest.workspace.id,
           externalId,
@@ -1469,7 +1779,7 @@ async function doRunImportCodex(options, ctx) {
     repoRoot: repositoryRoot,
     cwd: ctx.cwd ?? process.cwd()
   });
-  const sessionsRoot = ctx.codexSessionsDir ?? join3(homedir2(), ".codex", "sessions");
+  const sessionsRoot = ctx.codexSessionsDir ?? join3(homedir3(), ".codex", "sessions");
   const rollouts = await discoverCodexRollouts(sessionsRoot, projectPaths, options);
   const candidates = rollouts.map(({ file, externalId }) => ({
     externalId,
@@ -1623,7 +1933,14 @@ async function classifyReimport(priors, sourcePath, externalId, counts) {
   return prior;
 }
 function encodeProjectDir(projectPath) {
-  return projectPath.replaceAll("/", "-");
+  return projectPath.replace(/[^a-zA-Z0-9]/g, "-");
+}
+function firstTranscriptCwd(records) {
+  for (const record of records) {
+    const cwd = record.cwd;
+    if (typeof cwd === "string" && cwd.length > 0) return cwd;
+  }
+  return void 0;
 }
 async function loadExistingByExternalId(paths, sourceKind) {
   const byExternalId = /* @__PURE__ */ new Map();
@@ -1789,7 +2106,7 @@ async function readFirstLine(file) {
 async function readJsonlRecords(file) {
   let buffer;
   try {
-    buffer = await readFile(file);
+    buffer = await readFile2(file);
   } catch (error) {
     if (findErrorCode5(error, "ENOENT")) {
       throw new Error("Source log not found", { cause: error });
@@ -1919,7 +2236,7 @@ async function assertWorkspaceInitialized5(basouRoot) {
 }
 
 // src/commands/init.ts
-import { basename as basename2, relative, resolve as resolve2 } from "path";
+import { basename as basename2, relative, resolve as resolve3 } from "path";
 import {
   appendBasouGitignore,
   createManifest,
@@ -1966,7 +2283,7 @@ async function doRunInit(options, ctx) {
     repositoryUrl = await tryRemoteUrl(repositoryRoot);
   }
   const sourceRoots = (options.sourceRoot ?? []).map((p) => {
-    const rel = relative(repositoryRoot, resolve2(cwd, p));
+    const rel = relative(repositoryRoot, resolve3(cwd, p));
     return rel === "" ? "." : rel;
   });
   const paths = await ensureBasouDirectory(repositoryRoot);
@@ -2020,26 +2337,6 @@ import {
   resolveSessionId as resolveSessionId2
 } from "@basou/core";
 import { InvalidArgumentError as InvalidArgumentError2 } from "commander";
-
-// src/lib/repo-root.ts
-import { resolveBasouRepositoryRoot } from "@basou/core";
-async function resolveBasouRootForCommand(cwd, commandName) {
-  try {
-    return await resolveBasouRepositoryRoot(cwd, {
-      onRedirect: ({ via, root }) => console.error(`Resolved workspace view to ${root} (via ${via}).`)
-    });
-  } 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 ${commandName}'.`,
-        { cause: error }
-      );
-    }
-    throw error;
-  }
-}
-
-// src/commands/note.ts
 var LABEL_BODY_MAX = 80;
 var LABEL_TRUNCATE_HEAD2 = LABEL_BODY_MAX - 3;
 function registerNoteCommand(program) {
@@ -2433,7 +2730,7 @@ import {
   unlinkSync,
   writeFileSync
 } from "fs";
-import { basename as basename3, dirname, isAbsolute, join as join4, relative as relative2, resolve as resolve3 } from "path";
+import { basename as basename3, dirname, isAbsolute, join as join4, relative as relative2, resolve as resolve4 } from "path";
 import {
   basouPaths as basouPaths9,
   GENERATED_END,
@@ -2685,7 +2982,7 @@ async function runProjectAdopt(options, ctx = {}) {
   }
 }
 function classifySourceRoot(repositoryRoot, declaredPath) {
-  const absolute = resolve3(repositoryRoot, declaredPath);
+  const absolute = resolve4(repositoryRoot, declaredPath);
   let real;
   try {
     real = realpathSync(absolute);
@@ -2787,7 +3084,7 @@ async function gatherRepoWiring(repositoryRoot, entry) {
   };
   let real;
   try {
-    real = realpathSync(resolve3(repositoryRoot, entry.path));
+    real = realpathSync(resolve4(repositoryRoot, entry.path));
   } catch {
     return { ...base, reachable: false, instructionFiles: [] };
   }
@@ -2892,7 +3189,7 @@ function gatherRepoGitignore(repositoryRoot, entry) {
   };
   let real;
   try {
-    real = realpathSync(resolve3(repositoryRoot, entry.path));
+    real = realpathSync(resolve4(repositoryRoot, entry.path));
   } catch {
     return { ...base, reachable: false, currentLines: [] };
   }
@@ -2913,7 +3210,7 @@ function readGitignoreLines(file) {
   }
 }
 function applyGitignorePlan(repositoryRoot, plan) {
-  const file = join4(realpathSync(resolve3(repositoryRoot, plan.path)), ".gitignore");
+  const file = join4(realpathSync(resolve4(repositoryRoot, plan.path)), ".gitignore");
   let existing = "";
   try {
     existing = readFileSync(file, "utf8");
@@ -3025,7 +3322,7 @@ function gatherRepoSymlinks(repositoryRoot, anchorReal, entry) {
   const base = { path: entry.path };
   let real;
   try {
-    real = realpathSync(resolve3(repositoryRoot, entry.path));
+    real = realpathSync(resolve4(repositoryRoot, entry.path));
   } catch {
     return { ...base, isAnchor: false, reachable: false, canonicalPresent: false, files: [] };
   }
@@ -3062,7 +3359,7 @@ function gatherRepoSymlinks(repositoryRoot, anchorReal, entry) {
 function applySymlinkPlan(repositoryRoot, plan) {
   let real;
   try {
-    real = realpathSync(resolve3(repositoryRoot, plan.path));
+    real = realpathSync(resolve4(repositoryRoot, plan.path));
   } catch (error) {
     const message = failureReason(error);
     return { created: [], failed: plan.toCreate.map((c) => ({ file: c.name, message })) };
@@ -3207,7 +3504,7 @@ async function runProjectWorkspace(options, ctx = {}) {
   }
 }
 function resolveViewDir(repositoryRoot, viewPath) {
-  const abs = resolve3(repositoryRoot, viewPath);
+  const abs = resolve4(repositoryRoot, viewPath);
   try {
     return realpathSync(abs);
   } catch {
@@ -3221,7 +3518,7 @@ function resolveViewDir(repositoryRoot, viewPath) {
 function gatherViewRepo(repositoryRoot, viewDir, entry) {
   let repoReal;
   try {
-    repoReal = realpathSync(resolve3(repositoryRoot, entry.path));
+    repoReal = realpathSync(resolve4(repositoryRoot, entry.path));
   } catch {
     return { path: entry.path, reachable: false };
   }
@@ -3273,7 +3570,7 @@ function classifyViewLink(viewDir, name, rosterRealpaths) {
   } catch {
     return null;
   }
-  const resolved = isAbsolute(target) ? target : resolve3(viewDir, target);
+  const resolved = isAbsolute(target) ? target : resolve4(viewDir, target);
   try {
     if (rosterRealpaths.has(realpathSync(resolved))) return null;
   } catch {
@@ -3359,11 +3656,11 @@ async function doRunProjectWorkspace(options, ctx) {
   } else {
     const viewDir = resolveViewDir(repositoryRoot, viewPath);
     const facts = roster.map((entry) => gatherViewRepo(repositoryRoot, viewDir, entry));
-    const rosterNames = roster.map((entry) => basename3(resolve3(repositoryRoot, entry.path)));
+    const rosterNames = roster.map((entry) => basename3(resolve4(repositoryRoot, entry.path)));
     const rosterRealpaths = /* @__PURE__ */ new Set();
     for (const entry of roster) {
       try {
-        rosterRealpaths.add(realpathSync(resolve3(repositoryRoot, entry.path)));
+        rosterRealpaths.add(realpathSync(resolve4(repositoryRoot, entry.path)));
       } catch {
       }
     }
@@ -3538,7 +3835,7 @@ async function gatherRepoPreset(repositoryRoot, anchorReal, entry) {
   };
   let real;
   try {
-    real = realpathSync(resolve3(repositoryRoot, entry.path));
+    real = realpathSync(resolve4(repositoryRoot, entry.path));
   } catch {
     return { ...declared, isAnchor: false, reachable: false, canonicalPresent: false };
   }
@@ -3767,7 +4064,7 @@ function gatherArchiveTeardown(repositoryRoot, manifest, target) {
   };
   let real;
   try {
-    real = realpathSync(resolve3(repositoryRoot, target));
+    real = realpathSync(resolve4(repositoryRoot, target));
   } catch {
     return empty;
   }
@@ -3835,7 +4132,7 @@ async function doRunProjectArchive(target, options, ctx) {
   const roster = manifest.repos ?? [];
   let targetIsAnchor = false;
   try {
-    targetIsAnchor = realpathSync(resolve3(repositoryRoot, target)) === realpathSync(repositoryRoot);
+    targetIsAnchor = realpathSync(resolve4(repositoryRoot, target)) === realpathSync(repositoryRoot);
   } catch {
     targetIsAnchor = false;
   }
@@ -3986,7 +4283,7 @@ async function doRunProjectRename(oldPath, newPath, options, ctx) {
   const roster = manifest.repos ?? [];
   let oldIsAnchor = false;
   try {
-    oldIsAnchor = realpathSync(resolve3(repositoryRoot, oldPath)) === realpathSync(repositoryRoot);
+    oldIsAnchor = realpathSync(resolve4(repositoryRoot, oldPath)) === realpathSync(repositoryRoot);
   } catch {
     oldIsAnchor = false;
   }
@@ -4101,13 +4398,13 @@ import { assertBasouRootSafe as assertBasouRootSafe9, basouPaths as basouPaths10
 import { InvalidArgumentError as InvalidArgumentError3 } from "commander";
 
 // src/lib/portfolio-config.ts
-import { homedir as homedir3 } from "os";
-import { isAbsolute as isAbsolute2, join as join5, resolve as resolve4 } from "path";
+import { homedir as homedir4 } from "os";
+import { isAbsolute as isAbsolute2, join as join5, resolve as resolve5 } from "path";
 import { readYamlFile as readYamlFile3 } from "@basou/core";
-var DEFAULT_PORTFOLIO_CONFIG_PATH = join5(homedir3(), ".basou", "portfolio.yaml");
+var DEFAULT_PORTFOLIO_CONFIG_PATH = join5(homedir4(), ".basou", "portfolio.yaml");
 function expandTilde(p) {
-  if (p === "~") return homedir3();
-  if (p.startsWith("~/")) return join5(homedir3(), p.slice(2));
+  if (p === "~") return homedir4();
+  if (p.startsWith("~/")) return join5(homedir4(), p.slice(2));
   return p;
 }
 function isRecord(value) {
@@ -4146,7 +4443,7 @@ async function loadPortfolioConfig(configPath = DEFAULT_PORTFOLIO_CONFIG_PATH) {
         "Portfolio workspace paths must be absolute (or start with '~'); use --workspace for relative ad-hoc paths."
       );
     }
-    const abs = resolve4(expanded);
+    const abs = resolve5(expanded);
     if (seen.has(abs)) continue;
     seen.add(abs);
     result.push(entry.label !== void 0 ? { path: abs, label: entry.label } : { path: abs });
@@ -4159,7 +4456,7 @@ async function loadPortfolioConfig(configPath = DEFAULT_PORTFOLIO_CONFIG_PATH) {
 
 // src/commands/refresh-watch.ts
 import { readdir as readdir2, stat as stat2 } from "fs/promises";
-import { homedir as homedir4 } from "os";
+import { homedir as homedir5 } from "os";
 import { join as join6 } from "path";
 import { findErrorCode as findErrorCode8 } from "@basou/core";
 var DEFAULT_WATCH_INTERVAL_SEC = 30;
@@ -4167,8 +4464,8 @@ var MIN_WATCH_INTERVAL_SEC = 5;
 var MAX_WATCH_INTERVAL_SEC = 86400;
 function watchedRoots(ctx) {
   return [
-    ctx.codexSessionsDir ?? join6(homedir4(), ".codex", "sessions"),
-    ctx.claudeProjectsDir ?? join6(homedir4(), ".claude", "projects")
+    ctx.codexSessionsDir ?? join6(homedir5(), ".codex", "sessions"),
+    ctx.claudeProjectsDir ?? join6(homedir5(), ".claude", "projects")
   ];
 }
 async function scanSourceLogs(roots) {
@@ -4289,19 +4586,19 @@ function parseInterval(value) {
   return seconds;
 }
 function abortableSleep(ms, signal) {
-  return new Promise((resolve8) => {
+  return new Promise((resolve9) => {
     if (signal.aborted) {
-      resolve8();
+      resolve9();
       return;
     }
     let timer;
     const onAbort = () => {
       clearTimeout(timer);
-      resolve8();
+      resolve9();
     };
     timer = setTimeout(() => {
       signal.removeEventListener("abort", onAbort);
-      resolve8();
+      resolve9();
     }, ms);
     signal.addEventListener("abort", onAbort, { once: true });
   });
@@ -4472,7 +4769,7 @@ function printRefreshSummary(result) {
     if (result.decisions.decisionCount === 0) {
       const hasSessions = result.handoff.status === "generated" && result.handoff.sessionCount > 0;
       console.log(
-        hasSessions ? "decisions: 0 (none auto-recorded from these sessions; record any made with 'basou decision record')" : "decisions: 0"
+        hasSessions ? "decisions: 0 (none auto-recorded from these sessions; capture any made with 'basou decision capture')" : "decisions: 0"
       );
     } else {
       console.log(`decisions: regenerated (${result.decisions.decisionCount})`);
@@ -4500,7 +4797,7 @@ async function assertWorkspaceInitialized8(basouRoot) {
 }
 
 // src/commands/report.ts
-import { isAbsolute as isAbsolute3, resolve as resolve5 } from "path";
+import { isAbsolute as isAbsolute3, resolve as resolve6 } from "path";
 import {
   assertBasouRootSafe as assertBasouRootSafe10,
   basouPaths as basouPaths11,
@@ -4540,7 +4837,7 @@ async function doRunReportGenerate(options, ctx) {
     onTaskSkip: (taskId, reason) => printTaskSkip(taskId, reason)
   });
   if (options.out !== void 0) {
-    const outPath = isAbsolute3(options.out) ? options.out : resolve5(cwd, options.out);
+    const outPath = isAbsolute3(options.out) ? options.out : resolve6(cwd, options.out);
     await writeMarkdownFile6(outPath, result.body);
     const { sessions, decisions, tasks } = result.data;
     console.error(
@@ -4703,7 +5000,7 @@ function renderReviewGaps(summary) {
 
 // src/commands/run.ts
 import { mkdir as mkdir2 } from "fs/promises";
-import { homedir as homedir5 } from "os";
+import { homedir as homedir6 } from "os";
 import { join as join7 } from "path";
 import {
   acquireLock as acquireLock5,
@@ -4889,7 +5186,7 @@ async function runClaudeCode(args, options, ctx = {}) {
   const rawRelated = computeRelatedFiles(preSnapshot, postSnapshot, diff);
   const relatedFiles = sanitizeRelatedFiles(rawRelated, {
     workingDirectory: repoRoot,
-    homedir: homedir5()
+    homedir: homedir6()
   }).sanitized;
   const finalStatus = decideFinalStatus2(result, signalReceived);
   await appendEvent(sessionDir, {
@@ -5033,7 +5330,7 @@ function buildInitialSession2(input) {
       source: { ...claudeCodeAdapterMetadata },
       started_at: input.startedAt,
       status: "initialized",
-      working_directory: sanitizeWorkingDirectory2(input.cwd, { homedir: homedir5() }),
+      working_directory: sanitizeWorkingDirectory2(input.cwd, { homedir: homedir6() }),
       invocation: {
         command: input.command,
         args: [...input.args],
@@ -5105,7 +5402,7 @@ async function resolveRepositoryRootForRun(cwd) {
 }
 
 // src/commands/session.ts
-import { readFile as readFile2 } from "fs/promises";
+import { readFile as readFile3 } from "fs/promises";
 import { basename as basename4, isAbsolute as isAbsolute4, join as join8, relative as relative3 } from "path";
 import {
   acquireLock as acquireLock6,
@@ -5545,7 +5842,7 @@ async function doRunSessionImport(options, ctx) {
 }
 async function readInputFile(path) {
   try {
-    return await readFile2(path, "utf8");
+    return await readFile3(path, "utf8");
   } catch (error) {
     if (findErrorCode11(error, "ENOENT")) {
       throw new Error("Import source not found", { cause: error });
@@ -5662,7 +5959,7 @@ async function doRunSessionNote(sessionIdInput, options, ctx) {
 }
 async function readNoteFile(path) {
   try {
-    return await readFile2(path, "utf8");
+    return await readFile3(path, "utf8");
   } catch (error) {
     if (findErrorCode11(error, "ENOENT")) {
       throw new Error("Note source not found", { cause: error });
@@ -5969,7 +6266,7 @@ async function resolveRepositoryRootForStatus(cwd) {
 }
 
 // src/commands/task.ts
-import { readFile as readFile3 } from "fs/promises";
+import { readFile as readFile4 } from "fs/promises";
 import { join as join9 } from "path";
 import {
   archiveTask,
@@ -6985,7 +7282,7 @@ function parsePositiveInt2(raw) {
 }
 async function readDescriptionFile(path) {
   try {
-    return await readFile3(path, "utf8");
+    return await readFile4(path, "utf8");
   } catch (error) {
     if (findErrorCode14(error, "ENOENT")) {
       throw new Error("Description source not found", { cause: error });
@@ -7200,7 +7497,7 @@ async function assertWorkspaceInitialized13(basouRoot) {
 // src/commands/view.ts
 import { spawn } from "child_process";
 import { createHash } from "crypto";
-import { basename as basename5, resolve as resolve7 } from "path";
+import { basename as basename5, resolve as resolve8 } from "path";
 import {
   assertBasouRootSafe as assertBasouRootSafe17,
   basouPaths as basouPaths19,
@@ -7213,7 +7510,7 @@ import { InvalidArgumentError as InvalidArgumentError7 } from "commander";
 // src/lib/portfolio-safety.ts
 import { execFile } from "child_process";
 import { lstat, realpath } from "fs/promises";
-import { isAbsolute as isAbsolute5, join as join10, relative as relative4, resolve as resolve6 } from "path";
+import { isAbsolute as isAbsolute5, join as join10, relative as relative4, resolve as resolve7 } from "path";
 import { promisify } from "util";
 import { readManifest as readManifest10 } from "@basou/core";
 var execFileAsync = promisify(execFile);
@@ -7224,7 +7521,7 @@ async function canonical(p) {
   try {
     return await realpath(p);
   } catch {
-    return resolve6(p);
+    return resolve7(p);
   }
 }
 function isInside(child, parent) {
@@ -7286,7 +7583,7 @@ async function checkPortfolioSafety(workspaces) {
     }
     const monitored = /* @__PURE__ */ new Map();
     for (const root of sourceRoots) {
-      const display = resolve6(ws.repoRoot, root);
+      const display = resolve7(ws.repoRoot, root);
       const real = await canonical(display);
       if (real !== wsReal) monitored.set(real, display);
     }
@@ -7995,7 +8292,7 @@ function startViewServer(opts) {
   };
   let boundPort = port;
   const getPort = () => boundPort;
-  return new Promise((resolve8, reject) => {
+  return new Promise((resolve9, reject) => {
     const server = createServer((req, res) => {
       handleRequest(req, res, deps, getPort, runExclusive).catch((error) => {
         sendError(res, error instanceof HttpError ? error.status : 500, pathlessMessage(error));
@@ -8006,7 +8303,7 @@ function startViewServer(opts) {
       const address = server.address();
       boundPort = isAddressInfo(address) ? address.port : port;
       server.off("error", reject);
-      resolve8({
+      resolve9({
         url: `http://${host}:${boundPort}`,
         port: boundPort,
         close: () => closeServer(server)
@@ -8018,8 +8315,8 @@ function isAddressInfo(value) {
   return value !== null && typeof value === "object";
 }
 function closeServer(server) {
-  return new Promise((resolve8) => {
-    server.close(() => resolve8());
+  return new Promise((resolve9) => {
+    server.close(() => resolve9());
     server.closeAllConnections();
   });
 }
@@ -8513,12 +8810,12 @@ async function buildSingleDeps(ctx, cwd) {
   return { workspaces: [entry], mode: "single", nowProvider: nowProviderOf(ctx) };
 }
 async function buildPortfolioDeps(workspaceFlags, ctx, cwd) {
-  const specs = workspaceFlags.length > 0 ? workspaceFlags.map((p) => ({ path: resolve7(cwd, p) })) : await loadPortfolioConfig(ctx.portfolioConfigPath);
+  const specs = workspaceFlags.length > 0 ? workspaceFlags.map((p) => ({ path: resolve8(cwd, p) })) : await loadPortfolioConfig(ctx.portfolioConfigPath);
   const entries = [];
   const seenPath = /* @__PURE__ */ new Set();
   const seenKey = /* @__PURE__ */ new Set();
   for (const spec of specs) {
-    const repoRoot = resolve7(spec.path);
+    const repoRoot = resolve8(spec.path);
     if (seenPath.has(repoRoot)) continue;
     seenPath.add(repoRoot);
     const entry = await buildWorkspaceEntry(repoRoot, ctx, spec.label);
@@ -8590,7 +8887,7 @@ function openInBrowser(url, override) {
   }
 }
 function waitForShutdown(signal) {
-  return new Promise((resolve8) => {
+  return new Promise((resolve9) => {
     const cleanup = () => {
       process.off("SIGINT", onSignal);
       process.off("SIGTERM", onSignal);
@@ -8598,18 +8895,18 @@ function waitForShutdown(signal) {
     };
     const onSignal = () => {
       cleanup();
-      resolve8();
+      resolve9();
     };
     const onAbort = () => {
       cleanup();
-      resolve8();
+      resolve9();
     };
     process.on("SIGINT", onSignal);
     process.on("SIGTERM", onSignal);
     if (signal !== void 0) {
       if (signal.aborted) {
         cleanup();
-        resolve8();
+        resolve9();
         return;
       }
       signal.addEventListener("abort", onAbort);