@basou/core 0.19.0 → 0.21.0

package/dist/index.d.ts

@@ -570,10 +570,14 @@ type ClaudeTranscriptToPayloadOptions = {
  * - `command_executed` from each `Bash` tool use, recorded as `bash -c "<cmd>"`
  *   (the transcript carries the shell line, not a parsed argv).
  * - `file_changed` from each `Edit` / `Write` / `NotebookEdit` tool use.
- * - `decision_recorded` from each `AskUserQuestion` tool use: one decision per
- *   question, titled `<question> -> <chosen answer>`. The chosen answer is read
- *   from the paired result record's structured `toolUseResult.answers` map; a
- *   question with no recorded string answer is skipped.
+ * - `decision_recorded` from each `AskUserQuestion` tool use, but ONLY when the
+ *   recorded answer is a confirmed SELECTION — it exactly matches an option the
+ *   question offered (`input.questions[].options[].label`). One decision per
+ *   such question, titled `<question> -> <chosen answer>`. The answer is read
+ *   from the paired result record's `toolUseResult.answers` map; a question with
+ *   no recorded answer, or a free-text "Other" reply that matches no offered
+ *   label, is skipped (it is not a decision, and would otherwise pollute
+ *   decisions.md / orientation's latest-decision surface).
  *
  * Exit codes and per-command durations are not present in the transcript, so
  * `command_executed.exit_code` is `null` and `duration_ms` is `0`.
@@ -588,6 +592,62 @@ type ClaudeTranscriptToPayloadOptions = {
  */
 declare function claudeTranscriptToImportPayload(records: ReadonlyArray<ClaudeTranscriptRecord>, options: ClaudeTranscriptToPayloadOptions): SessionImportPayload | null;
 
+/**
+ * Default minimum number of "action" tool uses (Bash commands + file edits) a
+ * session must contain before the Stop-hook nudge treats it as substantive
+ * enough to be worth a session-end capture. Below this the session reads as a
+ * trivial check / quick question and the hook stays silent rather than nagging.
+ */
+declare const DEFAULT_STOP_HOOK_MIN_ACTIONS = 5;
+type StopHookEvaluationInput = {
+    /**
+     * Parsed transcript records, one per JSONL line of the current session's
+     * transcript. The caller drops malformed lines; this function reads every
+     * field defensively, like the importer, since the format is undocumented.
+     */
+    records: ReadonlyArray<ClaudeTranscriptRecord>;
+    /**
+     * The Stop hook's `stop_hook_active` stdin flag: true when Claude is already
+     * continuing because of a previous Stop-hook response. When true the nudge
+     * stays silent so it can never form a continuation loop.
+     */
+    stopHookActive: boolean;
+    /** Override the substantive-work threshold (defaults to {@link DEFAULT_STOP_HOOK_MIN_ACTIONS}). */
+    minActions?: number;
+};
+/** Why the hook stayed silent (useful for tests and `--json` introspection). */
+type StopHookSilentReason = "stop_hook_active" | "not_substantive" | "already_captured";
+type StopHookEvaluation = {
+    kind: "silent";
+    reason: StopHookSilentReason;
+    commandCount: number;
+    fileCount: number;
+} | {
+    kind: "nudge";
+    additionalContext: string;
+    commandCount: number;
+    fileCount: number;
+};
+/**
+ * Decide whether a finished turn warrants a non-blocking capture nudge.
+ *
+ * Pure: no disk or environment access. The CLI handler reads the Stop hook's
+ * stdin payload and the transcript file, parses the JSONL into `records`, and
+ * passes them here. A `nudge` result is rendered as
+ * `hookSpecificOutput.additionalContext` (non-blocking — Claude may act on it
+ * or stop); a `silent` result emits nothing.
+ *
+ * The nudge fires only when ALL hold:
+ *  - not already continuing from a prior nudge (`stopHookActive` is false), so
+ *    the hook never loops;
+ *  - the session did substantive work (>= `minActions` Bash commands + edits),
+ *    so trivial check sessions are left alone;
+ *  - no capture verb (`basou decision capture` / `decision record` / `note`)
+ *    was run this session, so a session that already recorded its intent is
+ *    left alone.
+ */
+declare function evaluateStopHook(input: StopHookEvaluationInput): StopHookEvaluation;
+
 /**
  * The `source` string stamped on every event derived from an OpenAI Codex
  * native rollout log, and the matching session `source.kind`.
@@ -5519,4 +5579,4 @@ declare function overwriteYamlFile(filePath: string, value: unknown): Promise<vo
  */
 declare const BASOU_CORE_VERSION = "0.1.0";
 
-export { ACTIVE_GAP_CAP_MS, AGENT_INFRA_DIRS, type ActiveTimeBasis, type AdapterOutputEvent, type AdoptCandidate, type AdoptCandidateKind, type AppendBasouGitignoreOptions, type AppendBasouGitignoreResult, type AppendEventToExistingInput, type AppendEventToExistingResult, type Approval, type ApprovalApprovedEvent, type ApprovalExpiredEvent, ApprovalIdSchema, type ApprovalLocation, type ApprovalRejectedEvent, type ApprovalRequestedEvent, ApprovalSchema, type ApprovalStatus, ApprovalStatusSchema, type ArchivePlan, type ArchiveTaskInput, type ArchiveTaskResult, type AttachTaskInput, type AttachUpdateTaskStatusInput, type AttachableStatus, BASOU_CORE_VERSION, type BasouPaths, type BulkChainResult, CLAUDE_IMPORT_SOURCE, CODEX_IMPORT_SOURCE, type CaptureMode, type ChainBreakReason, type ChainTailState, type ChainVerdict, type ChainVerdictStatus, type ChainedEvents, ChildProcessRunner, type CitedReview, type ClaudeTranscriptRecord, type ClaudeTranscriptToPayloadOptions, type CodexRolloutRecord, type CodexRolloutToPayloadOptions, type CommandExecutedEvent, type CommandLookup, type CreateAdHocSessionInput, type CreateAdHocSessionResult, type CreateAdHocTaskInput, type CreateManifestInput, type CreateTaskInput, type CreateTaskResult, type DayWorkStats, DecisionIdSchema, type DecisionRecordedEvent, type DecisionsRendererInput, type DecisionsRendererResult, type DeleteTaskInput, type DeleteTaskResult, type DiffResult, type EditTaskInput, type EditTaskResult, type Event, EventIdSchema, EventSchema, EventSourceSchema, type ExistingViewLink, FailedToFinalizeError, type FederatedRoot, type FileChange, type FileChangeStatus, type FileChangedEvent, GENERATED_END, GENERATED_START, type GitSnapshot, type GitSnapshotEvent, type GitignorePlanSummary, type HandoffRendererInput, type HandoffRendererResult, ID_PREFIXES, type IdPrefix, type ImportSessionOptions, type ImportSessionResult, type InstructionFileFact, type InstructionSymlinkFact, type InstructionSymlinkState, IsoTimestampSchema, JSON_SCHEMA_VERSION, type JsonSchemaArtifact, type LoadFederatedOptions, type LoadSessionEntriesOptions, type LoadTaskEntriesOptions, type LoadedApproval, type LockHandle, type LockScope, type Manifest, ManifestSchema, type MarkerSection, type Markers, type MeasureAvailability, type NoteAddedEvent, type OrientationRendererInput, type OrientationRendererResult, type OrientationSummary, PROTOCOL_END, PROTOCOL_START, type PrefixedId, type PresetAction, type PresetCollision, type PresetMarkerConflict, type PresetMarkerKind, type PresetPlanSummary, type PresetRepo, type ProcessRunner, type PublishKind, type PublishTarget, type RechainOptions, type RechainResult, type ReconcileAllResult, type ReconcileAllTasksInput, type ReconcileAllTasksOptions, type ReconcileFailure, type ReconcileResult, type ReconcileTaskInput, type RefreshLinkageInput, type RefreshLinkageResult, type ReimportOptions, type ReimportResult, type RenamePlan, type ReplayOptions, type ReplayWarning, type RepoEntry, type RepoGitignoreFacts, type RepoGitignorePlan, type RepoLanguage, type RepoPresetFacts, type RepoPresetPlan, type RepoSymlinkFacts, type RepoSymlinkPlan, type RepoVisibility, type RepoWiringFacts, type ReportApprovalItem, type ReportData, type ReportDecisionItem, type ReportRendererInput, type ReportRendererResult, type ReportSessionItem, type ReportTaskItem, type ReviewGapRepoSummary, type ReviewGapUnit, type ReviewGapVerdict, type ReviewGapsInput, type ReviewGapsSummary, type RiskLevel, RiskLevelSchema, type RosterAdoptionPlan, type RosterDriftSummary, type RunOptions, type RunResult, STUCK_THRESHOLD_MS, type SanitizePathOptions, type SanitizeRelatedFilesResult, SchemaVersionSchema, type Session, type SessionEndedEvent, type SessionEntry, SessionIdSchema, type SessionImportPayload, SessionImportPayloadSchema, type SessionInnerImportInput, SessionInnerImportSchema, type SessionIntegrity, SessionIntegritySchema, type SessionMetrics, SessionMetricsSchema, SessionSchema, type SessionSkipReason, type SessionSourceKind, SessionSourceKindSchema, type SessionStartedEvent, type SessionStatus, type SessionStatusChangedEvent, SessionStatusSchema, type SessionWorkStats, type SourceRootScope, type SourceRootsReconcile, type SourceWorkStats, type StatusCount, StatusSchema, type StatusSnapshot, type SuspectReason, type SymlinkCollision, type SymlinkConflict, type SymlinkPlanSummary, type Task, type TaskArchivedEvent, type TaskCreatedEvent, type TaskDeletedEvent, type TaskDocument, TaskIdSchema, type TaskLinkageRefreshedEvent, type TaskReconciledEvent, TaskSchema, type TaskSkipReason, type TaskStatus, type TaskStatusChangedEvent, type TaskStatusCount, TaskStatusSchema, TaskWriteAfterEventError, type TaskWriteAfterEventPhase, type TokenTotals, type UpdateAdHocTaskStatusInput, type UpdateTaskStatusInput, type UpdateTaskStatusResult, type ViewCollision, type ViewConflict, type ViewLinkState, type ViewRepoFact, type ViewStrayUnknown, type WiringRisk, type WiringSummary, type WorkStatsInput, type WorkStatsResult, type WorkStatsTotals, WorkspaceIdSchema, type WorkspaceViewPlan, type WriteEventsBulkOptions, type WriteTaskFileMode, acquireLock, appendBasouGitignore, appendChainedEvent, appendChainedEventLocked, appendEvent, appendEventToExistingSession, archiveTask, assertBasouRootSafe, basouPaths, buildJsonSchemas, buildStatusSnapshot, chainEvents, chainRawJsonLines, classifyFilesBySourceRoot, classifySuspect, claudeCodeAdapterMetadata, claudeTranscriptToImportPayload, codexRolloutToImportPayload, computeWorkStats, createAdHocSessionWithEvent, createManifest, createTaskWithEvent, deleteTask, editTask, ensureBasouDirectory, enumerateApprovals, enumerateArchivedTaskIds, enumerateSessionDirs, enumerateTaskIds, finalizeSessionYaml, findErrorCode, findReviewGaps, formatDurationMs, genesisHash, getDiff, getSnapshot, importSessionFromJson, inspectChainTail, isGitNotFound, isImportDerivedSource, isLazyExpired, isRenderable, isValidPrefixedId, lineHash, linkYamlFile, loadApproval, loadFederatedSessionEntries, loadSessionEntries, loadTaskEntries, normalizeRepoKey, normalizeRepoPath, overwriteYamlFile, parseDuration, parseMarkers, pathBasename, planArchive, planGitignore, planRename, planRosterAdoption, planWorkspaceView, prefixedUlid, readAllEvents, readManifest, readMarkdownFile, readSessionYaml, readStatus, readTaskFile, readTaskFileWithArchiveFallback, readYamlFile, rechainSessionInPlace, reconcileAllTasks, reconcileSourceRoots, reconcileTask, refreshTaskLinkedSessions, reimportPreservingId, removeMarkerSection, renderDecisions, renderHandoff, renderOrientation, renderPresetBlock, renderReport, renderWithMarkers, replayEvents, resolveBasouRepositoryRoot, resolveClaudeCodeCommand, resolveRepositoryRoot, resolveSessionId, resolveTaskId, safeSimpleGit, sanitizePath, sanitizeRelatedFiles, sanitizeWorkingDirectory, serializeEventLine, serializeJsonSchema, sessionWorkStatsFromEvents, summarizeAdapterOutput, summarizeOrientation, summarizePresetPlan, summarizeRosterDrift, summarizeSymlinkPlan, summarizeWiring, tryRemoteUrl, ulid, unknownManifestKeys, updateTaskStatusWithEvent, verifyEventsChain, writeEventsBulk, writeManifest, writeMarkdownFile, writeStatus, writeTaskFile, writeYamlFile };
+export { ACTIVE_GAP_CAP_MS, AGENT_INFRA_DIRS, type ActiveTimeBasis, type AdapterOutputEvent, type AdoptCandidate, type AdoptCandidateKind, type AppendBasouGitignoreOptions, type AppendBasouGitignoreResult, type AppendEventToExistingInput, type AppendEventToExistingResult, type Approval, type ApprovalApprovedEvent, type ApprovalExpiredEvent, ApprovalIdSchema, type ApprovalLocation, type ApprovalRejectedEvent, type ApprovalRequestedEvent, ApprovalSchema, type ApprovalStatus, ApprovalStatusSchema, type ArchivePlan, type ArchiveTaskInput, type ArchiveTaskResult, type AttachTaskInput, type AttachUpdateTaskStatusInput, type AttachableStatus, BASOU_CORE_VERSION, type BasouPaths, type BulkChainResult, CLAUDE_IMPORT_SOURCE, CODEX_IMPORT_SOURCE, type CaptureMode, type ChainBreakReason, type ChainTailState, type ChainVerdict, type ChainVerdictStatus, type ChainedEvents, ChildProcessRunner, type CitedReview, type ClaudeTranscriptRecord, type ClaudeTranscriptToPayloadOptions, type CodexRolloutRecord, type CodexRolloutToPayloadOptions, type CommandExecutedEvent, type CommandLookup, type CreateAdHocSessionInput, type CreateAdHocSessionResult, type CreateAdHocTaskInput, type CreateManifestInput, type CreateTaskInput, type CreateTaskResult, DEFAULT_STOP_HOOK_MIN_ACTIONS, type DayWorkStats, DecisionIdSchema, type DecisionRecordedEvent, type DecisionsRendererInput, type DecisionsRendererResult, type DeleteTaskInput, type DeleteTaskResult, type DiffResult, type EditTaskInput, type EditTaskResult, type Event, EventIdSchema, EventSchema, EventSourceSchema, type ExistingViewLink, FailedToFinalizeError, type FederatedRoot, type FileChange, type FileChangeStatus, type FileChangedEvent, GENERATED_END, GENERATED_START, type GitSnapshot, type GitSnapshotEvent, type GitignorePlanSummary, type HandoffRendererInput, type HandoffRendererResult, ID_PREFIXES, type IdPrefix, type ImportSessionOptions, type ImportSessionResult, type InstructionFileFact, type InstructionSymlinkFact, type InstructionSymlinkState, IsoTimestampSchema, JSON_SCHEMA_VERSION, type JsonSchemaArtifact, type LoadFederatedOptions, type LoadSessionEntriesOptions, type LoadTaskEntriesOptions, type LoadedApproval, type LockHandle, type LockScope, type Manifest, ManifestSchema, type MarkerSection, type Markers, type MeasureAvailability, type NoteAddedEvent, type OrientationRendererInput, type OrientationRendererResult, type OrientationSummary, PROTOCOL_END, PROTOCOL_START, type PrefixedId, type PresetAction, type PresetCollision, type PresetMarkerConflict, type PresetMarkerKind, type PresetPlanSummary, type PresetRepo, type ProcessRunner, type PublishKind, type PublishTarget, type RechainOptions, type RechainResult, type ReconcileAllResult, type ReconcileAllTasksInput, type ReconcileAllTasksOptions, type ReconcileFailure, type ReconcileResult, type ReconcileTaskInput, type RefreshLinkageInput, type RefreshLinkageResult, type ReimportOptions, type ReimportResult, type RenamePlan, type ReplayOptions, type ReplayWarning, type RepoEntry, type RepoGitignoreFacts, type RepoGitignorePlan, type RepoLanguage, type RepoPresetFacts, type RepoPresetPlan, type RepoSymlinkFacts, type RepoSymlinkPlan, type RepoVisibility, type RepoWiringFacts, type ReportApprovalItem, type ReportData, type ReportDecisionItem, type ReportRendererInput, type ReportRendererResult, type ReportSessionItem, type ReportTaskItem, type ReviewGapRepoSummary, type ReviewGapUnit, type ReviewGapVerdict, type ReviewGapsInput, type ReviewGapsSummary, type RiskLevel, RiskLevelSchema, type RosterAdoptionPlan, type RosterDriftSummary, type RunOptions, type RunResult, STUCK_THRESHOLD_MS, type SanitizePathOptions, type SanitizeRelatedFilesResult, SchemaVersionSchema, type Session, type SessionEndedEvent, type SessionEntry, SessionIdSchema, type SessionImportPayload, SessionImportPayloadSchema, type SessionInnerImportInput, SessionInnerImportSchema, type SessionIntegrity, SessionIntegritySchema, type SessionMetrics, SessionMetricsSchema, SessionSchema, type SessionSkipReason, type SessionSourceKind, SessionSourceKindSchema, type SessionStartedEvent, type SessionStatus, type SessionStatusChangedEvent, SessionStatusSchema, type SessionWorkStats, type SourceRootScope, type SourceRootsReconcile, type SourceWorkStats, type StatusCount, StatusSchema, type StatusSnapshot, type StopHookEvaluation, type StopHookEvaluationInput, type StopHookSilentReason, type SuspectReason, type SymlinkCollision, type SymlinkConflict, type SymlinkPlanSummary, type Task, type TaskArchivedEvent, type TaskCreatedEvent, type TaskDeletedEvent, type TaskDocument, TaskIdSchema, type TaskLinkageRefreshedEvent, type TaskReconciledEvent, TaskSchema, type TaskSkipReason, type TaskStatus, type TaskStatusChangedEvent, type TaskStatusCount, TaskStatusSchema, TaskWriteAfterEventError, type TaskWriteAfterEventPhase, type TokenTotals, type UpdateAdHocTaskStatusInput, type UpdateTaskStatusInput, type UpdateTaskStatusResult, type ViewCollision, type ViewConflict, type ViewLinkState, type ViewRepoFact, type ViewStrayUnknown, type WiringRisk, type WiringSummary, type WorkStatsInput, type WorkStatsResult, type WorkStatsTotals, WorkspaceIdSchema, type WorkspaceViewPlan, type WriteEventsBulkOptions, type WriteTaskFileMode, acquireLock, appendBasouGitignore, appendChainedEvent, appendChainedEventLocked, appendEvent, appendEventToExistingSession, archiveTask, assertBasouRootSafe, basouPaths, buildJsonSchemas, buildStatusSnapshot, chainEvents, chainRawJsonLines, classifyFilesBySourceRoot, classifySuspect, claudeCodeAdapterMetadata, claudeTranscriptToImportPayload, codexRolloutToImportPayload, computeWorkStats, createAdHocSessionWithEvent, createManifest, createTaskWithEvent, deleteTask, editTask, ensureBasouDirectory, enumerateApprovals, enumerateArchivedTaskIds, enumerateSessionDirs, enumerateTaskIds, evaluateStopHook, finalizeSessionYaml, findErrorCode, findReviewGaps, formatDurationMs, genesisHash, getDiff, getSnapshot, importSessionFromJson, inspectChainTail, isGitNotFound, isImportDerivedSource, isLazyExpired, isRenderable, isValidPrefixedId, lineHash, linkYamlFile, loadApproval, loadFederatedSessionEntries, loadSessionEntries, loadTaskEntries, normalizeRepoKey, normalizeRepoPath, overwriteYamlFile, parseDuration, parseMarkers, pathBasename, planArchive, planGitignore, planRename, planRosterAdoption, planWorkspaceView, prefixedUlid, readAllEvents, readManifest, readMarkdownFile, readSessionYaml, readStatus, readTaskFile, readTaskFileWithArchiveFallback, readYamlFile, rechainSessionInPlace, reconcileAllTasks, reconcileSourceRoots, reconcileTask, refreshTaskLinkedSessions, reimportPreservingId, removeMarkerSection, renderDecisions, renderHandoff, renderOrientation, renderPresetBlock, renderReport, renderWithMarkers, replayEvents, resolveBasouRepositoryRoot, resolveClaudeCodeCommand, resolveRepositoryRoot, resolveSessionId, resolveTaskId, safeSimpleGit, sanitizePath, sanitizeRelatedFiles, sanitizeWorkingDirectory, serializeEventLine, serializeJsonSchema, sessionWorkStatsFromEvents, summarizeAdapterOutput, summarizeOrientation, summarizePresetPlan, summarizeRosterDrift, summarizeSymlinkPlan, summarizeWiring, tryRemoteUrl, ulid, unknownManifestKeys, updateTaskStatusWithEvent, verifyEventsChain, writeEventsBulk, writeManifest, writeMarkdownFile, writeStatus, writeTaskFile, writeYamlFile };

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,33 +230,38 @@ 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) {
+          const offeredByQuestion = readOfferedOptions(input);
           for (const [question, answer] of Object.entries(answers)) {
             if (question.length === 0) continue;
             const answerStr = typeof answer === "string" && answer.length > 0 ? answer : void 0;
-            const title = answerStr !== void 0 ? `${question} -> ${answerStr}` : question;
-            derived.push(decisionRecordedEvent(ts, placeholderSessionId, title));
+            if (answerStr === void 0) continue;
+            const offered = offeredByQuestion.get(question);
+            if (offered === void 0 || !offered.has(answerStr.trim())) continue;
+            derived.push(
+              decisionRecordedEvent(ts, placeholderSessionId, `${question} -> ${answerStr}`)
+            );
           }
         }
         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 +363,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,20 +401,38 @@ 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);
       }
     }
   }
   return byId;
 }
+function readOfferedOptions(input) {
+  const byQuestion = /* @__PURE__ */ new Map();
+  const questions = Array.isArray(input.questions) ? input.questions : [];
+  for (const q of questions) {
+    if (!isObject2(q)) continue;
+    const text = readString2(q.question);
+    if (text === void 0) continue;
+    const labels = /* @__PURE__ */ new Set();
+    const options = Array.isArray(q.options) ? q.options : [];
+    for (const o of options) {
+      if (!isObject2(o)) continue;
+      const label = readString2(o.label);
+      if (label !== void 0) labels.add(label.trim());
+    }
+    byQuestion.set(text, labels);
+  }
+  return byQuestion;
+}
 
 // src/adapters/codex/rollout-importer.ts
 var CODEX_IMPORT_SOURCE = "codex-import";
@@ -360,31 +450,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 +485,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 +598,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 +616,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 +638,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 +664,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;
@@ -4758,6 +4848,11 @@ function formatOrientationBody(summary, opts) {
     lines.push(`> hosts: local, ${summary.hosts.join(", ")}`);
   }
   lines.push("");
+  const banner = stalenessBanner(opts.staleness);
+  if (banner.length > 0) {
+    for (const line of banner) lines.push(line);
+    lines.push("");
+  }
   lines.push("## \u4ECA\u3069\u3053\u306B\u3044\u308B");
   lines.push("");
   if (summary.latestSession !== null) {
@@ -4957,6 +5052,23 @@ function toolDisplayName(kind) {
       return kind ?? "\u4E0D\u660E";
   }
 }
+function stalenessBanner(staleness) {
+  if (staleness === null) return [];
+  if ((staleness.unverifiableSessions ?? 0) > 0) {
+    return [
+      `> \u26A0\uFE0F **\u6700\u65B0\u3067\u306F\u306A\u3044\u53EF\u80FD\u6027** \u2014 \u5909\u5316\u3057\u305F\u304C\u5B89\u5168\u306B\u53D6\u308A\u8FBC\u3081\u306A\u3044\u30BB\u30C3\u30B7\u30E7\u30F3\u304C ${staleness.unverifiableSessions} \u4EF6\u3042\u308A\u307E\u3059\u3002\u7740\u624B\u524D\u306B \`basou verify\` / \`basou refresh --force\`(\u8A73\u7D30\u306F\u672B\u5C3E\u300C\u3053\u308C\u306F\u6700\u65B0\u304B\u300D)\u3002`
+    ];
+  }
+  if (staleness.newSessions > 0 || staleness.updatedSessions > 0) {
+    const parts = [];
+    if (staleness.newSessions > 0) parts.push(`\u65B0\u898F ${staleness.newSessions} \u4EF6`);
+    if (staleness.updatedSessions > 0) parts.push(`\u66F4\u65B0 ${staleness.updatedSessions} \u4EF6`);
+    return [
+      `> \u26A0\uFE0F **\u53E4\u3044\u304B\u3082\u3057\u308C\u307E\u305B\u3093** \u2014 \u672A\u53D6\u308A\u8FBC\u307F\u306E\u4F5C\u696D\u304C\u3042\u308A\u307E\u3059(${parts.join("\u30FB")})\u3002\u7740\u624B\u524D\u306B \`basou refresh\` \u3067\u66F4\u65B0\u3057\u3066\u304F\u3060\u3055\u3044(\u8A73\u7D30\u306F\u672B\u5C3E\u300C\u3053\u308C\u306F\u6700\u65B0\u304B\u300D)\u3002`
+    ];
+  }
+  return [];
+}
 function freshnessVerdict(summary, staleness, now) {
   if (staleness !== null && (staleness.unverifiableSessions ?? 0) > 0) {
     return [
@@ -7349,6 +7461,7 @@ export {
   CLAUDE_IMPORT_SOURCE,
   CODEX_IMPORT_SOURCE,
   ChildProcessRunner,
+  DEFAULT_STOP_HOOK_MIN_ACTIONS,
   DecisionIdSchema,
   EventIdSchema,
   EventSchema,
@@ -7408,6 +7521,7 @@ export {
   enumerateArchivedTaskIds,
   enumerateSessionDirs,
   enumerateTaskIds,
+  evaluateStopHook,
   finalizeSessionYaml,
   findErrorCode,
   findReviewGaps,