@basou/core 0.18.0 → 0.20.0

package/dist/index.js

@@ -21,6 +21,73 @@ function summarizeAdapterOutput(_stream, _raw) {
   throw new Error("adapter_output summary is not implemented in this release");
 }
 
+// src/adapters/claude-code/stop-hook.ts
+var DEFAULT_STOP_HOOK_MIN_ACTIONS = 5;
+var CAPTURE_COMMAND_PATTERN = /(?:^|[\n;&|(])\s*basou\s+(?:decision\s+(?:capture|record)|note)\b/;
+var FILE_EDIT_TOOLS = /* @__PURE__ */ new Set(["Edit", "Write", "NotebookEdit"]);
+function evaluateStopHook(input) {
+  const minActions = input.minActions ?? DEFAULT_STOP_HOOK_MIN_ACTIONS;
+  if (input.stopHookActive) {
+    return { kind: "silent", reason: "stop_hook_active", commandCount: 0, fileCount: 0 };
+  }
+  let commandCount = 0;
+  let fileCount = 0;
+  let captured = false;
+  for (const record of input.records) {
+    if (readString(record.type) !== "assistant") continue;
+    for (const tool of toolUsesOf(record)) {
+      const name = readString(tool.name);
+      if (name === void 0) continue;
+      if (name === "Bash") {
+        commandCount += 1;
+        const input2 = isObject(tool.input) ? tool.input : void 0;
+        const command = input2 !== void 0 ? readString(input2.command) : void 0;
+        if (command !== void 0 && CAPTURE_COMMAND_PATTERN.test(command)) captured = true;
+      } else if (FILE_EDIT_TOOLS.has(name)) {
+        fileCount += 1;
+      }
+    }
+  }
+  if (captured) {
+    return { kind: "silent", reason: "already_captured", commandCount, fileCount };
+  }
+  if (commandCount + fileCount < minActions) {
+    return { kind: "silent", reason: "not_substantive", commandCount, fileCount };
+  }
+  return {
+    kind: "nudge",
+    additionalContext: renderNudge(commandCount, fileCount),
+    commandCount,
+    fileCount
+  };
+}
+function renderNudge(commandCount, fileCount) {
+  const ran = `${commandCount} ${commandCount === 1 ? "command" : "commands"}`;
+  const edited = `${fileCount} ${fileCount === 1 ? "file" : "files"}`;
+  return [
+    `This session ran ${ran} and edited ${edited} but recorded no decisions or next step.`,
+    "If meaningful decisions were made (the chosen approach, rejected alternatives, and why) or there is a clear next step, capture them now so the next session can resume correctly:",
+    '  - Decisions: run `basou decision capture` and pipe a JSON array (one object per decision; "title" required, plus optional rationale/alternatives/rejected_reason/linked_files; set "kind":"track" for an unfinished strategic direction).',
+    '  - Next step: run `basou note "<what you would do next>"`.',
+    "If nothing is worth capturing, just stop \u2014 do not invent decisions."
+  ].join("\n");
+}
+function readString(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function toolUsesOf(record) {
+  const message = isObject(record.message) ? record.message : void 0;
+  const content = message !== void 0 && Array.isArray(message.content) ? message.content : [];
+  const result = [];
+  for (const item of content) {
+    if (isObject(item) && readString(item.type) === "tool_use") result.push(item);
+  }
+  return result;
+}
+
 // src/ids/ulid.ts
 import { isValid as isValidUlid, monotonicFactory } from "ulid";
 var ID_PREFIXES = Object.freeze(["ws", "task", "ses", "evt", "appr", "decision"]);
@@ -128,21 +195,21 @@ function claudeTranscriptToImportPayload(records, options) {
   const engagementTsMs = [];
   const seenEngagementMessageIds = /* @__PURE__ */ new Set();
   for (const record of records) {
-    const ts = readString(record.timestamp);
+    const ts = readString2(record.timestamp);
     if (ts === void 0) continue;
     if (minTs === void 0 || Date.parse(ts) < Date.parse(minTs)) minTs = ts;
     if (maxTs === void 0 || Date.parse(ts) > Date.parse(maxTs)) maxTs = ts;
-    if (workingDir === void 0) workingDir = readString(record.cwd);
-    if (claudeSessionId === void 0) claudeSessionId = readString(record.sessionId);
+    if (workingDir === void 0) workingDir = readString2(record.cwd);
+    if (claudeSessionId === void 0) claudeSessionId = readString2(record.sessionId);
     if (record.isSidechain !== true) {
       const tsMs = Date.parse(ts);
       if (Number.isFinite(tsMs)) {
-        const recType = readString(record.type);
+        const recType = readString2(record.type);
         if (recType === "user") {
           if (isHumanUserMessage(record)) engagementTsMs.push(tsMs);
         } else if (recType === "assistant") {
-          const msg = isObject(record.message) ? record.message : void 0;
-          const mid = msg !== void 0 ? readString(msg.id) : void 0;
+          const msg = isObject2(record.message) ? record.message : void 0;
+          const mid = msg !== void 0 ? readString2(msg.id) : void 0;
           if (mid === void 0 || !seenEngagementMessageIds.has(mid)) {
             if (mid !== void 0) seenEngagementMessageIds.add(mid);
             engagementTsMs.push(tsMs);
@@ -150,11 +217,11 @@ function claudeTranscriptToImportPayload(records, options) {
         }
       }
     }
-    if (readString(record.type) !== "assistant") continue;
-    const message = isObject(record.message) ? record.message : void 0;
-    const usage = message !== void 0 && isObject(message.usage) ? message.usage : void 0;
+    if (readString2(record.type) !== "assistant") continue;
+    const message = isObject2(record.message) ? record.message : void 0;
+    const usage = message !== void 0 && isObject2(message.usage) ? message.usage : void 0;
     if (usage !== void 0) {
-      const messageId = message !== void 0 ? readString(message.id) : void 0;
+      const messageId = message !== void 0 ? readString2(message.id) : void 0;
       const alreadyCounted = messageId !== void 0 && seenMessageIds.has(messageId);
       if (!alreadyCounted) {
         if (messageId !== void 0) seenMessageIds.add(messageId);
@@ -163,20 +230,20 @@ function claudeTranscriptToImportPayload(records, options) {
         cachedInputTokens += readNonNegInt(usage.cache_read_input_tokens);
       }
     }
-    const cwd = readString(record.cwd) ?? workingDir ?? ".";
+    const cwd = readString2(record.cwd) ?? workingDir ?? ".";
     for (const item of toolUses(record)) {
-      const name = readString(item.name);
-      const input = isObject(item.input) ? item.input : void 0;
+      const name = readString2(item.name);
+      const input = isObject2(item.input) ? item.input : void 0;
       if (input === void 0) continue;
       if (name === "Bash") {
-        const command = readString(input.command);
+        const command = readString2(input.command);
         if (command !== void 0) {
           derived.push(commandExecutedEvent(ts, placeholderSessionId, command, cwd));
         }
         continue;
       }
       if (name === "AskUserQuestion") {
-        const useId = readString(item.id);
+        const useId = readString2(item.id);
         const answers = useId !== void 0 ? askAnswers.get(useId) : void 0;
         if (answers !== void 0) {
           for (const [question, answer] of Object.entries(answers)) {
@@ -189,7 +256,7 @@ function claudeTranscriptToImportPayload(records, options) {
         continue;
       }
       if (name === "Edit" || name === "Write" || name === "NotebookEdit") {
-        const path2 = readString(input.file_path) ?? readString(input.notebook_path);
+        const path2 = readString2(input.file_path) ?? readString2(input.notebook_path);
         if (path2 !== void 0) {
           const changeType = name === "Write" ? "added" : "modified";
           relatedFiles.add(path2);
@@ -291,35 +358,35 @@ function decisionRecordedEvent(occurredAt, sessionId, title) {
     title
   };
 }
-function readString(value) {
+function readString2(value) {
   return typeof value === "string" && value.length > 0 ? value : void 0;
 }
 function readNonNegInt(value) {
   return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : 0;
 }
-function isObject(value) {
+function isObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isHumanUserMessage(record) {
-  const message = isObject(record.message) ? record.message : void 0;
+  const message = isObject2(record.message) ? record.message : void 0;
   if (message === void 0) return false;
   const content = message.content;
   if (typeof content === "string") return content.length > 0;
   if (Array.isArray(content)) {
     return content.some((block) => {
-      if (!isObject(block)) return false;
-      const type = readString(block.type);
+      if (!isObject2(block)) return false;
+      const type = readString2(block.type);
       return type !== void 0 && type !== "tool_result";
     });
   }
   return false;
 }
 function toolUses(record) {
-  const message = isObject(record.message) ? record.message : void 0;
+  const message = isObject2(record.message) ? record.message : void 0;
   const content = message !== void 0 && Array.isArray(message.content) ? message.content : [];
   const result = [];
   for (const item of content) {
-    if (isObject(item) && readString(item.type) === "tool_use") {
+    if (isObject2(item) && readString2(item.type) === "tool_use") {
       result.push(item);
     }
   }
@@ -329,14 +396,14 @@ function indexAskAnswers(records) {
   const byId = /* @__PURE__ */ new Map();
   for (const record of records) {
     const result = record.toolUseResult;
-    if (!isObject(result)) continue;
+    if (!isObject2(result)) continue;
     const answers = result.answers;
-    if (!isObject(answers)) continue;
-    const message = isObject(record.message) ? record.message : void 0;
+    if (!isObject2(answers)) continue;
+    const message = isObject2(record.message) ? record.message : void 0;
     const content = message !== void 0 && Array.isArray(message.content) ? message.content : [];
     for (const item of content) {
-      if (isObject(item) && readString(item.type) === "tool_result") {
-        const id = readString(item.tool_use_id);
+      if (isObject2(item) && readString2(item.type) === "tool_result") {
+        const id = readString2(item.tool_use_id);
         if (id !== void 0) byId.set(id, answers);
       }
     }
@@ -360,31 +427,31 @@ function codexRolloutToImportPayload(records, options) {
   const completions = [];
   const completedTurnIds = /* @__PURE__ */ new Set();
   for (const record of records) {
-    const ts = readString2(record.timestamp);
+    const ts = readString3(record.timestamp);
     if (ts === void 0) continue;
     if (minTs === void 0 || Date.parse(ts) < Date.parse(minTs)) minTs = ts;
     if (maxTs === void 0 || Date.parse(ts) > Date.parse(maxTs)) maxTs = ts;
-    const payload2 = isObject2(record.payload) ? record.payload : void 0;
+    const payload2 = isObject3(record.payload) ? record.payload : void 0;
     if (payload2 === void 0) continue;
-    if (readString2(record.type) === "session_meta") {
-      if (workingDir === void 0) workingDir = readString2(payload2.cwd);
-      if (codexSessionId === void 0) codexSessionId = readString2(payload2.id);
+    if (readString3(record.type) === "session_meta") {
+      if (workingDir === void 0) workingDir = readString3(payload2.cwd);
+      if (codexSessionId === void 0) codexSessionId = readString3(payload2.id);
       continue;
     }
-    if (readString2(record.type) === "event_msg" && readString2(payload2.type) === "token_count") {
-      const info = isObject2(payload2.info) ? payload2.info : void 0;
-      const totals = info !== void 0 && isObject2(info.total_token_usage) ? info.total_token_usage : void 0;
+    if (readString3(record.type) === "event_msg" && readString3(payload2.type) === "token_count") {
+      const info = isObject3(payload2.info) ? payload2.info : void 0;
+      const totals = info !== void 0 && isObject3(info.total_token_usage) ? info.total_token_usage : void 0;
       if (totals !== void 0) lastTokenTotals = totals;
       continue;
     }
-    if (readString2(record.type) === "event_msg") {
-      const pt = readString2(payload2.type);
+    if (readString3(record.type) === "event_msg") {
+      const pt = readString3(payload2.type);
       if (pt === "user_message" || pt === "agent_message" || pt === "task_started" || pt === "task_complete") {
         const tsMs = Date.parse(ts);
         if (Number.isFinite(tsMs)) engagementTsMs.push(tsMs);
       }
       if (pt === "task_complete") {
-        const turnId = readString2(payload2.turn_id);
+        const turnId = readString3(payload2.turn_id);
         if (turnId === void 0 || !completedTurnIds.has(turnId)) {
           if (turnId !== void 0) completedTurnIds.add(turnId);
           completions.push({
@@ -395,9 +462,9 @@ function codexRolloutToImportPayload(records, options) {
       }
       continue;
     }
-    if (readString2(record.type) !== "response_item") continue;
-    if (readString2(payload2.type) !== "function_call") continue;
-    if (readString2(payload2.name) !== "exec_command") continue;
+    if (readString3(record.type) !== "response_item") continue;
+    if (readString3(payload2.type) !== "function_call") continue;
+    if (readString3(payload2.name) !== "exec_command") continue;
     const command = readExecCommand(payload2.arguments);
     if (command === void 0) continue;
     const cwd = command.workdir ?? workingDir ?? ".";
@@ -508,17 +575,17 @@ function commandExecutedEvent2(occurredAt, sessionId, command, cwd, outcome) {
     duration_ms: outcome.durationMs
   };
 }
-function readString2(value) {
+function readString3(value) {
   return typeof value === "string" && value.length > 0 ? value : void 0;
 }
 function readNonNegInt2(value) {
   return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : 0;
 }
-function isObject2(value) {
+function isObject3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readExecCommand(value) {
-  const raw = readString2(value);
+  const raw = readString3(value);
   if (raw === void 0) return void 0;
   let parsed;
   try {
@@ -526,19 +593,19 @@ function readExecCommand(value) {
   } catch {
     return void 0;
   }
-  if (!isObject2(parsed)) return void 0;
-  const cmd = readString2(parsed.cmd);
+  if (!isObject3(parsed)) return void 0;
+  const cmd = readString3(parsed.cmd);
   if (cmd === void 0) return void 0;
-  return { cmd, workdir: readString2(parsed.workdir) };
+  return { cmd, workdir: readString3(parsed.workdir) };
 }
 function readCallId(value, outputs) {
-  const callId = readString2(value);
+  const callId = readString3(value);
   return callId !== void 0 ? outputs.get(callId) : void 0;
 }
 function turnIntervalFromComplete(endTs, payload, startMsByTurnId) {
   const endMs = Date.parse(endTs);
   if (!Number.isFinite(endMs)) return void 0;
-  const turnId = readString2(payload.turn_id);
+  const turnId = readString3(payload.turn_id);
   const indexedStart = turnId !== void 0 ? startMsByTurnId.get(turnId) : void 0;
   const durationMs = readNonNegInt2(payload.duration_ms);
   const startMs = indexedStart !== void 0 ? indexedStart : durationMs > 0 ? endMs - durationMs : void 0;
@@ -548,11 +615,11 @@ function turnIntervalFromComplete(endTs, payload, startMsByTurnId) {
 function indexTaskStarts(records) {
   const byTurnId = /* @__PURE__ */ new Map();
   for (const record of records) {
-    if (readString2(record.type) !== "event_msg") continue;
-    const payload = isObject2(record.payload) ? record.payload : void 0;
-    if (payload === void 0 || readString2(payload.type) !== "task_started") continue;
-    const turnId = readString2(payload.turn_id);
-    const startMs = Date.parse(readString2(record.timestamp) ?? "");
+    if (readString3(record.type) !== "event_msg") continue;
+    const payload = isObject3(record.payload) ? record.payload : void 0;
+    if (payload === void 0 || readString3(payload.type) !== "task_started") continue;
+    const turnId = readString3(payload.turn_id);
+    const startMs = Date.parse(readString3(record.timestamp) ?? "");
     if (turnId !== void 0 && Number.isFinite(startMs) && !byTurnId.has(turnId)) {
       byTurnId.set(turnId, startMs);
     }
@@ -574,12 +641,12 @@ function parseWallTimeMs(output) {
 function indexOutputs(records) {
   const byId = /* @__PURE__ */ new Map();
   for (const record of records) {
-    if (readString2(record.type) !== "response_item") continue;
-    const payload = isObject2(record.payload) ? record.payload : void 0;
+    if (readString3(record.type) !== "response_item") continue;
+    const payload = isObject3(record.payload) ? record.payload : void 0;
     if (payload === void 0) continue;
-    if (readString2(payload.type) !== "function_call_output") continue;
-    const callId = readString2(payload.call_id);
-    const output = readString2(payload.output);
+    if (readString3(payload.type) !== "function_call_output") continue;
+    const callId = readString3(payload.call_id);
+    const output = readString3(payload.output);
     if (callId !== void 0 && output !== void 0) byId.set(callId, output);
   }
   return byId;
@@ -872,7 +939,17 @@ var DecisionRecordedEventSchema = BaseEventSchema.extend({
   alternatives: z3.array(z3.string().min(1)).optional(),
   rejected_reason: z3.string().nullable().optional(),
   linked_events: z3.array(EventIdSchema).optional(),
-  linked_files: z3.array(z3.string().min(1).max(4096)).optional()
+  linked_files: z3.array(z3.string().min(1).max(4096)).optional(),
+  // `track` promotes a decision to a strategic, unfinished DIRECTION ("the next
+  // essential thing to build, and why") that orientation/handoff resurface every
+  // time until it is explicitly closed with `decision void` / supersede — as
+  // opposed to a point-in-time `decision`, which is only ever surfaced as the
+  // single latest one. This is the intent-continuity layer: a direction agreed
+  // in conversation otherwise sinks into the flat decision list and never carries
+  // to the next session. Absent (the default) is a plain `decision`, so all
+  // pre-existing decision_recorded events round-trip unchanged (additive optional
+  // => no schema_version bump; mirrors `note_added.kind`).
+  kind: z3.enum(["decision", "track"]).optional()
 });
 var DecisionVoidedEventSchema = BaseEventSchema.extend({
   type: z3.literal("decision_voided"),
@@ -1487,6 +1564,7 @@ async function renderDecisions(input) {
             rejectedReason: ev.rejected_reason,
             linkedEvents: ev.linked_events,
             linkedFiles: ev.linked_files,
+            kind: ev.kind,
             voided: void 0
           });
         } else if (ev.type === "decision_voided") {
@@ -1542,18 +1620,22 @@ async function formatDecisionsBody(args) {
     return lines.join("\n");
   }
   for (const d of args.decisions) {
+    const trackMark = d.kind === "track" ? " [TRACK]" : "";
     if (d.voided !== void 0) {
-      lines.push(`## ~~${d.decisionId}: ${d.title}~~ [VOIDED]`);
+      lines.push(`## ~~${d.decisionId}: ${d.title}~~ [VOIDED]${trackMark}`);
       lines.push("");
       const supersededBy = d.voided.supersededBy !== void 0 ? `, superseded by ${d.voided.supersededBy}` : "";
       const reason = typeof d.voided.reason === "string" && d.voided.reason.length > 0 ? `: ${d.voided.reason}` : "";
       lines.push(`- \u26A0 VOIDED${reason}${supersededBy}`);
     } else {
-      lines.push(`## ${d.decisionId}: ${d.title}`);
+      lines.push(`## ${d.decisionId}: ${d.title}${trackMark}`);
       lines.push("");
     }
     const occurredDate = d.occurredAt.slice(0, 10);
     lines.push(`- \u6C7A\u5B9A\u65E5: ${occurredDate}`);
+    if (d.kind === "track" && d.voided === void 0) {
+      lines.push("- \u7A2E\u5225: track (close \u307E\u3067 orient/handoff \u306B\u7D99\u7D9A\u8868\u793A)");
+    }
     lines.push(`- session: ${shortDecisionSessionId(d.sessionId)}`);
     lines.push(`- \u5224\u65AD: ${d.title}`);
     if (typeof d.rationale === "string" && d.rationale.length > 0) {
@@ -3876,6 +3958,7 @@ async function renderHandoff(input) {
   if (input.onWarning !== void 0) loadOpts.onWarning = input.onWarning;
   const entries = await loadSessionEntries(input.paths, loadOpts);
   const decisions = [];
+  const tracks = [];
   const voidedDecisionIds = /* @__PURE__ */ new Set();
   const tasksCreated = [];
   const tasksStatusChanged = [];
@@ -3901,6 +3984,15 @@ async function renderHandoff(input) {
             occurredAt: ev.occurred_at,
             sessionId: entry.sessionId
           });
+          if (ev.kind === "track") {
+            tracks.push({
+              decisionId: ev.decision_id,
+              title: ev.title,
+              rationale: ev.rationale ?? null,
+              occurredAt: ev.occurred_at,
+              sessionId: entry.sessionId
+            });
+          }
         } else if (ev.type === "decision_voided") {
           voidedDecisionIds.add(ev.decision_id);
         } else if (ev.type === "task_created") {
@@ -3936,6 +4028,10 @@ async function renderHandoff(input) {
       break;
     }
   }
+  const openTracks = tracks.filter((t) => !voidedDecisionIds.has(t.decisionId)).sort((a, b) => {
+    const c = Date.parse(b.occurredAt) - Date.parse(a.occurredAt);
+    return c !== 0 ? c : b.decisionId.localeCompare(a.decisionId);
+  });
   tasksCreated.sort((a, b) => {
     const c = Date.parse(a.occurredAt) - Date.parse(b.occurredAt);
     return c !== 0 ? c : a.taskId.localeCompare(b.taskId);
@@ -3980,6 +4076,7 @@ async function renderHandoff(input) {
     latestActivityAt,
     decisions,
     latestDecision,
+    openTracks,
     pendingApprovalsCount,
     suspectCount,
     displayedFiles,
@@ -4065,6 +4162,23 @@ function formatHandoffBody(args) {
     lines.push(`(${args.decisions.length} decisions total \u2014 see decisions.md)`);
   }
   lines.push("");
+  if (args.openTracks.length > 0) {
+    const TRACK_DISPLAY_LIMIT = 10;
+    const shown = args.openTracks.slice(0, TRACK_DISPLAY_LIMIT);
+    const overflow = args.openTracks.length - shown.length;
+    lines.push("## \u672A\u5B8C\u30C8\u30E9\u30C3\u30AF (close \u307E\u3067\u7D99\u7D9A\u8868\u793A)");
+    lines.push("");
+    for (const t of shown) {
+      lines.push(`- ${t.title} [${shortIdWithPrefix(t.decisionId)}]`);
+      if (t.rationale !== null && t.rationale.trim() !== "") {
+        lines.push(`  - \u7406\u7531: ${handoffRationale(t.rationale)}`);
+      }
+    }
+    if (overflow > 0) lines.push(`- ... +${overflow} more (see decisions.md)`);
+    lines.push("");
+    lines.push("\u5B8C\u4E86\u3057\u305F\u3089 `basou decision void <decision_id>` \u3067\u9589\u3058\u3066\u304F\u3060\u3055\u3044\u3002");
+    lines.push("");
+  }
   lines.push("## \u672A\u6C7A\u4E8B\u9805");
   lines.push("");
   if (args.pendingApprovalsCount > 0) {
@@ -4149,6 +4263,11 @@ function formatHandoffBody(args) {
   lines.push(sessionsLine);
   return lines.join("\n");
 }
+var HANDOFF_TRACK_RATIONALE_MAX = 240;
+function handoffRationale(rationale) {
+  const oneLine = rationale.replace(/\s+/g, " ").trim();
+  return oneLine.length > HANDOFF_TRACK_RATIONALE_MAX ? `${oneLine.slice(0, HANDOFF_TRACK_RATIONALE_MAX - 1)}\u2026` : oneLine;
+}
 function suspectLabel(reason) {
   if (reason === "events_say_ended_but_yaml_running") return " \u26A0 ended (yaml stale)";
   if (reason === "running_no_end_event") return " \u26A0 no end event";
@@ -4502,6 +4621,7 @@ async function summarizeOrientation(input) {
     }
   ) : await loadSessionEntries(input.paths, loadOpts);
   const decisions = [];
+  const tracks = [];
   const voidedDecisionIds = /* @__PURE__ */ new Set();
   let latestActivityAt = null;
   let latestNote = null;
@@ -4526,6 +4646,16 @@ async function summarizeOrientation(input) {
             sessionId: entry.sessionId,
             host: entry.host
           });
+          if (ev.kind === "track") {
+            tracks.push({
+              decisionId: ev.decision_id,
+              title: ev.title,
+              rationale: ev.rationale ?? null,
+              occurredAt: ev.occurred_at,
+              sessionId: entry.sessionId,
+              host: entry.host
+            });
+          }
         } else if (ev.type === "decision_voided") {
           voidedDecisionIds.add(ev.decision_id);
         }
@@ -4557,6 +4687,10 @@ async function summarizeOrientation(input) {
       break;
     }
   }
+  const openTracks = tracks.filter((t) => !voidedDecisionIds.has(t.decisionId)).sort((a, b) => {
+    const c = Date.parse(b.occurredAt) - Date.parse(a.occurredAt);
+    return c !== 0 ? c : b.decisionId.localeCompare(a.decisionId);
+  });
   const taskLoadOpts = {};
   if (input.onTaskSkip !== void 0) taskLoadOpts.onSkip = input.onTaskSkip;
   const taskEntries = await loadTaskEntries(input.paths, taskLoadOpts);
@@ -4645,6 +4779,7 @@ async function summarizeOrientation(input) {
     latestSession,
     latestDecision: latestDecision ?? null,
     decisionCount: decisions.length,
+    openTracks,
     latestNote,
     relatedFiles: { displayed, overflow, outOfRoot },
     inFlightTasks,
@@ -4672,7 +4807,8 @@ async function renderOrientation(input) {
     pendingApprovalsCount: summary.pendingApprovals.length,
     suspectCount: summary.suspects.length,
     inFlightTaskCount: summary.inFlightTasks.length,
-    decisionCount: summary.decisionCount
+    decisionCount: summary.decisionCount,
+    openTrackCount: summary.openTracks.length
   };
 }
 function formatOrientationBody(summary, opts) {
@@ -4779,6 +4915,26 @@ function formatOrientationBody(summary, opts) {
   lines.push("");
   lines.push("## \u3069\u3053\u3078\u5411\u304B\u3046");
   lines.push("");
+  if (summary.openTracks.length > 0) {
+    const TRACK_DISPLAY_LIMIT = 10;
+    const shownTracks = summary.openTracks.slice(0, TRACK_DISPLAY_LIMIT);
+    const trackOverflow = summary.openTracks.length - shownTracks.length;
+    lines.push(`### \u672A\u5B8C\u30C8\u30E9\u30C3\u30AF (close \u307E\u3067\u7D99\u7D9A\u8868\u793A) (${summary.openTracks.length})`);
+    for (const t of shownTracks) {
+      const trackAge = relativeAgeJa(t.occurredAt, now);
+      lines.push(`- ${t.title} [${shortId(t.decisionId)}] (${trackAge})${hostSuffix(t.host)}`);
+      if (t.rationale !== null && t.rationale.trim() !== "") {
+        lines.push(`  - \u7406\u7531: ${trackRationale(t.rationale)}`);
+      }
+    }
+    if (trackOverflow > 0) {
+      lines.push(`- ... +${trackOverflow} more (see decisions.md)`);
+    }
+    lines.push(
+      "\u5B8C\u4E86\u3057\u305F\u3089 `basou decision void <decision_id>` \u3067\u9589\u3058\u3066\u304F\u3060\u3055\u3044\u3002\u9589\u3058\u308B\u307E\u3067\u6BCE\u56DE\u3053\u3053\u306B\u8868\u793A\u3055\u308C\u307E\u3059\u3002"
+    );
+    lines.push("");
+  }
   if (summary.latestNote !== null) {
     const noteAge = relativeAgeJa(summary.latestNote.occurredAt, now);
     lines.push(
@@ -4794,7 +4950,7 @@ function formatOrientationBody(summary, opts) {
   for (const t of summary.plannedTasks) {
     lines.push(`- ${t.title} [${shortId(t.id)}]`);
   }
-  if (summary.latestNote === null && summary.plannedTasks.length === 0) {
+  if (summary.openTracks.length === 0 && summary.latestNote === null && summary.plannedTasks.length === 0) {
     const dec = summary.latestDecision;
     if (dec === null) {
       lines.push("- (no planned tasks or recorded next step yet)");
@@ -4807,6 +4963,11 @@ function formatOrientationBody(summary, opts) {
       lines.push("- (no planned tasks \u2014 direction is inferred from recent decisions)");
       lines.push(`  - \u76F4\u8FD1\u306E\u5224\u65AD: ${dec.title}`);
     }
+    if (dec !== null) {
+      lines.push(
+        '  - \u6B21\u306B\u4F5C\u308B\u3079\u304D\u672C\u8CEA\u7684\u306A\u65B9\u5411\u6027\u304C\u5B9A\u307E\u3063\u305F\u3089 `basou decision capture` (`"kind":"track"`) / `basou decision record --track` \u3067 track \u5316\u3059\u308B\u3068\u3001close \u307E\u3067\u6BCE session \u3053\u3053\u306B\u7D99\u7D9A\u8868\u793A\u3055\u308C\u307E\u3059\u3002'
+      );
+    }
   }
   lines.push("");
   lines.push("## \u3053\u308C\u306F\u6700\u65B0\u304B");
@@ -4932,6 +5093,11 @@ function noteSummary(body) {
   const oneLine = body.replace(/\s+/g, " ").trim();
   return oneLine.length > NOTE_SUMMARY_MAX ? `${oneLine.slice(0, NOTE_SUMMARY_MAX - 1)}\u2026` : oneLine;
 }
+var TRACK_RATIONALE_MAX = 240;
+function trackRationale(rationale) {
+  const oneLine = rationale.replace(/\s+/g, " ").trim();
+  return oneLine.length > TRACK_RATIONALE_MAX ? `${oneLine.slice(0, TRACK_RATIONALE_MAX - 1)}\u2026` : oneLine;
+}
 function suspectText(reason) {
   if (reason === "events_say_ended_but_yaml_running") return "ended (yaml stale)";
   if (reason === "running_no_end_event") return "no end event";
@@ -5847,7 +6013,12 @@ async function renderReport(input) {
         onWarning: (w) => input.onWarning?.(w, entry.sessionId)
       })) {
         if (ev.type === "decision_recorded") {
-          decisions.push({ id: ev.decision_id, title: ev.title, occurredAt: ev.occurred_at });
+          decisions.push({
+            id: ev.decision_id,
+            title: ev.title,
+            occurredAt: ev.occurred_at,
+            ...ev.kind === "track" ? { track: true } : {}
+          });
         } else if (ev.type === "decision_voided") {
           voidedDecisionIds.add(ev.decision_id);
         }
@@ -6033,8 +6204,9 @@ function formatReportBody(data) {
       lines.push("");
     }
     for (const d of shown) {
+      const trackTag = d.track === true ? " [track]" : "";
       const voidedTag = d.voided === true ? " (voided)" : "";
-      lines.push(`- ${d.occurredAt.slice(0, 10)} \xB7 ${d.title}${voidedTag}`);
+      lines.push(`- ${d.occurredAt.slice(0, 10)} \xB7 ${d.title}${trackTag}${voidedTag}`);
     }
   }
   lines.push("");
@@ -7244,6 +7416,7 @@ export {
   CLAUDE_IMPORT_SOURCE,
   CODEX_IMPORT_SOURCE,
   ChildProcessRunner,
+  DEFAULT_STOP_HOOK_MIN_ACTIONS,
   DecisionIdSchema,
   EventIdSchema,
   EventSchema,
@@ -7303,6 +7476,7 @@ export {
   enumerateArchivedTaskIds,
   enumerateSessionDirs,
   enumerateTaskIds,
+  evaluateStopHook,
   finalizeSessionYaml,
   findErrorCode,
   findReviewGaps,