@basou/core 0.28.0 → 0.29.0

package/dist/index.d.ts

@@ -45,6 +45,65 @@ declare function resolveClaudeCodeCommand(lookup?: CommandLookup): Promise<{
  */
 declare function summarizeAdapterOutput(_stream: "stdout" | "stderr", _raw: string): string;
 
+/**
+ * Pure transforms for registering / removing basou's Stop hook inside a parsed
+ * Claude Code settings.json object. No disk or environment access: the CLI reads
+ * and writes the file, parses the JSON, and passes the object here so the
+ * merge/removal logic stays deterministic and unit-testable.
+ *
+ * settings.json holds many unrelated keys (permissions, model, other hooks);
+ * these functions clone the input and touch ONLY the `hooks.Stop` entry that
+ * basou owns, preserving everything else byte-for-byte through the round-trip.
+ */
+/** Seconds before Claude Code kills the hook process. Matches the documented orient (SessionStart) hook. */
+declare const STOP_HOOK_TIMEOUT_SECONDS = 20;
+declare function isBasouStopHookCommand(command: string): boolean;
+type BuildStopHookCommandOptions = {
+    /** Absolute path to the CLI entry to invoke (the running dist/index.js). */
+    cliEntry: string;
+    /** Register the blocking (opt-in enforcement) form. */
+    block?: boolean;
+    /** Override the file-edit threshold passed to `hook stop`. */
+    minEdits?: number;
+};
+/**
+ * Build the shell command basou registers as a Stop hook. Uses the node path
+ * (not the `basou` alias, which is often absent from a non-interactive hook's
+ * PATH) and a `2>/dev/null || true` wrapper so a stale/incorrect dist path or
+ * any crash fails open — no per-turn error noise. The wrapper is safe for the
+ * blocking form because that emits `decision:"block"` on stdout with exit 0;
+ * `|| true` would defeat an exit-2 block but leaves the JSON form intact.
+ *
+ * The entry path is shell-quoted so a home/project directory containing spaces
+ * or shell metacharacters still invokes correctly (an unquoted path with a
+ * space would split into the wrong argv and the hook would silently no-op).
+ */
+declare function buildStopHookCommand(options: BuildStopHookCommandOptions): string;
+type ClaudeSettings = Record<string, unknown>;
+type StopHookUpsert = {
+    settings: ClaudeSettings;
+    /** `installed` = a new entry was appended; `updated` = an existing basou entry was rewritten; `unchanged` = already canonical. */
+    action: "installed" | "updated" | "unchanged";
+};
+type StopHookRemoval = {
+    settings: ClaudeSettings;
+    action: "removed" | "absent";
+};
+/**
+ * Register (or upgrade in place) basou's Stop hook. Idempotent: an existing
+ * basou Stop hook is rewritten to the canonical command + timeout; a foreign
+ * Stop hook or any other settings key is left untouched.
+ */
+declare function upsertStopHook(settings: unknown, command: string): StopHookUpsert;
+/**
+ * Remove every basou-owned Stop hook. A group emptied by the removal is dropped;
+ * a now-empty `hooks.Stop` / `hooks` container is deleted so the file does not
+ * accumulate empty scaffolding. Foreign hooks and other keys are preserved.
+ */
+declare function removeStopHook(settings: unknown): StopHookRemoval;
+/** Return the installed basou Stop hook command, or null if none is registered. */
+declare function findBasouStopHookCommand(settings: unknown): string | null;
+
 /**
  * Schema for `.basou/manifest.yaml`. The minimal manifest carries
  * schema_version, basou_version, workspace metadata, project info, enabled
@@ -5827,4 +5886,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, DEFAULT_STOP_HOOK_MIN_EDITS, 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 RepoInstructions, 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 RetrofitAction, type RetrofitAgentsState, type RetrofitFacts, type RetrofitPlan, type RetrofitReason, 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, classifyRetrofit, 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, instructionMode, 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 BuildStopHookCommandOptions, type BulkChainResult, CLAUDE_IMPORT_SOURCE, CODEX_IMPORT_SOURCE, type CaptureMode, type ChainBreakReason, type ChainTailState, type ChainVerdict, type ChainVerdictStatus, type ChainedEvents, ChildProcessRunner, type CitedReview, type ClaudeSettings, 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_EDITS, 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 RepoInstructions, 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 RetrofitAction, type RetrofitAgentsState, type RetrofitFacts, type RetrofitPlan, type RetrofitReason, type ReviewGapRepoSummary, type ReviewGapUnit, type ReviewGapVerdict, type ReviewGapsInput, type ReviewGapsSummary, type RiskLevel, RiskLevelSchema, type RosterAdoptionPlan, type RosterDriftSummary, type RunOptions, type RunResult, STOP_HOOK_TIMEOUT_SECONDS, 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 StopHookRemoval, type StopHookSilentReason, type StopHookUpsert, 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, buildStopHookCommand, chainEvents, chainRawJsonLines, classifyFilesBySourceRoot, classifyRetrofit, classifySuspect, claudeCodeAdapterMetadata, claudeTranscriptToImportPayload, codexRolloutToImportPayload, computeWorkStats, createAdHocSessionWithEvent, createManifest, createTaskWithEvent, deleteTask, editTask, ensureBasouDirectory, enumerateApprovals, enumerateArchivedTaskIds, enumerateSessionDirs, enumerateTaskIds, evaluateStopHook, finalizeSessionYaml, findBasouStopHookCommand, findErrorCode, findReviewGaps, formatDurationMs, genesisHash, getDiff, getSnapshot, importSessionFromJson, inspectChainTail, instructionMode, isBasouStopHookCommand, 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, removeStopHook, 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, upsertStopHook, verifyEventsChain, writeEventsBulk, writeManifest, writeMarkdownFile, writeStatus, writeTaskFile, writeYamlFile };

package/dist/index.js

@@ -21,6 +21,118 @@ function summarizeAdapterOutput(_stream, _raw) {
   throw new Error("adapter_output summary is not implemented in this release");
 }
 
+// src/adapters/claude-code/settings-hook.ts
+var STOP_HOOK_TIMEOUT_SECONDS = 20;
+var BASOU_STOP_HOOK = /(?:\bbasou|(?:@basou|packages)\/cli\/dist\/index\.js['"]?)\s+hook\s+stop\b/;
+function isBasouStopHookCommand(command) {
+  return BASOU_STOP_HOOK.test(command);
+}
+function shellQuote(value) {
+  return `'${value.replace(/'/g, "'\\''")}'`;
+}
+function buildStopHookCommand(options) {
+  const flags = [];
+  if (options.block === true) flags.push("--block");
+  if (options.minEdits !== void 0) flags.push(`--min-edits ${options.minEdits}`);
+  const suffix = flags.length > 0 ? ` ${flags.join(" ")}` : "";
+  return `node ${shellQuote(options.cliEntry)} hook stop${suffix} 2>/dev/null || true`;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function cloneSettings(settings) {
+  if (settings === void 0 || settings === null) return {};
+  if (!isRecord(settings)) {
+    throw new Error("Claude settings is not a JSON object.");
+  }
+  return structuredClone(settings);
+}
+function upsertStopHook(settings, command) {
+  const root = cloneSettings(settings);
+  if (root.hooks === void 0) {
+    root.hooks = {};
+  } else if (!isRecord(root.hooks)) {
+    throw new Error("The 'hooks' key in Claude settings is not an object.");
+  }
+  const hooks = root.hooks;
+  if (hooks.Stop === void 0) {
+    hooks.Stop = [];
+  } else if (!Array.isArray(hooks.Stop)) {
+    throw new Error("The 'hooks.Stop' key in Claude settings is not an array.");
+  }
+  const stop = hooks.Stop;
+  for (const group of stop) {
+    if (!isRecord(group) || !Array.isArray(group.hooks)) continue;
+    for (const entry of group.hooks) {
+      if (!isRecord(entry)) continue;
+      if (typeof entry.command === "string" && isBasouStopHookCommand(entry.command)) {
+        const unchanged = entry.type === "command" && entry.command === command && entry.timeout === STOP_HOOK_TIMEOUT_SECONDS;
+        entry.type = "command";
+        entry.command = command;
+        entry.timeout = STOP_HOOK_TIMEOUT_SECONDS;
+        return { settings: root, action: unchanged ? "unchanged" : "updated" };
+      }
+    }
+  }
+  stop.push({ hooks: [{ type: "command", command, timeout: STOP_HOOK_TIMEOUT_SECONDS }] });
+  return { settings: root, action: "installed" };
+}
+function removeStopHook(settings) {
+  const root = cloneSettings(settings);
+  if (!isRecord(root.hooks) || !Array.isArray(root.hooks.Stop)) {
+    return { settings: root, action: "absent" };
+  }
+  const hooks = root.hooks;
+  const stop = hooks.Stop;
+  let removed = false;
+  const newStop = [];
+  for (const group of stop) {
+    if (!isRecord(group) || !Array.isArray(group.hooks)) {
+      newStop.push(group);
+      continue;
+    }
+    const keptHooks = group.hooks.filter((entry) => {
+      if (isRecord(entry) && typeof entry.command === "string" && isBasouStopHookCommand(entry.command)) {
+        removed = true;
+        return false;
+      }
+      return true;
+    });
+    if (keptHooks.length === group.hooks.length) {
+      newStop.push(group);
+    } else if (keptHooks.length > 0) {
+      group.hooks = keptHooks;
+      newStop.push(group);
+    }
+  }
+  if (!removed) {
+    return { settings: root, action: "absent" };
+  }
+  if (newStop.length === 0) {
+    delete hooks.Stop;
+  } else {
+    hooks.Stop = newStop;
+  }
+  if (Object.keys(hooks).length === 0) {
+    delete root.hooks;
+  }
+  return { settings: root, action: "removed" };
+}
+function findBasouStopHookCommand(settings) {
+  if (!isRecord(settings) || !isRecord(settings.hooks) || !Array.isArray(settings.hooks.Stop)) {
+    return null;
+  }
+  for (const group of settings.hooks.Stop) {
+    if (!isRecord(group) || !Array.isArray(group.hooks)) continue;
+    for (const entry of group.hooks) {
+      if (isRecord(entry) && typeof entry.command === "string" && isBasouStopHookCommand(entry.command)) {
+        return entry.command;
+      }
+    }
+  }
+  return null;
+}
+
 // src/adapters/claude-code/ask-user-question.ts
 function readString(value) {
   return typeof value === "string" && value.length > 0 ? value : void 0;
@@ -7664,6 +7776,7 @@ export {
   PROTOCOL_END,
   PROTOCOL_START,
   RiskLevelSchema,
+  STOP_HOOK_TIMEOUT_SECONDS,
   STUCK_THRESHOLD_MS,
   SchemaVersionSchema,
   SessionIdSchema,
@@ -7691,6 +7804,7 @@ export {
   basouPaths,
   buildJsonSchemas,
   buildStatusSnapshot,
+  buildStopHookCommand,
   chainEvents,
   chainRawJsonLines,
   classifyFilesBySourceRoot,
@@ -7712,6 +7826,7 @@ export {
   enumerateTaskIds,
   evaluateStopHook,
   finalizeSessionYaml,
+  findBasouStopHookCommand,
   findErrorCode,
   findReviewGaps,
   formatDurationMs,
@@ -7721,6 +7836,7 @@ export {
   importSessionFromJson,
   inspectChainTail,
   instructionMode,
+  isBasouStopHookCommand,
   isGitNotFound,
   isImportDerivedSource,
   isLazyExpired,
@@ -7759,6 +7875,7 @@ export {
   refreshTaskLinkedSessions,
   reimportPreservingId,
   removeMarkerSection,
+  removeStopHook,
   renderDecisions,
   renderHandoff,
   renderOrientation,
@@ -7788,6 +7905,7 @@ export {
   ulid,
   unknownManifestKeys,
   updateTaskStatusWithEvent,
+  upsertStopHook,
   verifyEventsChain,
   writeEventsBulk,
   writeManifest,