@basou/cli 0.23.0 → 0.25.0

package/dist/program.js

@@ -2036,7 +2036,7 @@ async function assertWorkspaceInitialized4(basouRoot) {
 // src/commands/hook.ts
 import { open, readFile as readFile2, stat as stat2 } from "fs/promises";
 import {
-  DEFAULT_STOP_HOOK_MIN_ACTIONS,
+  DEFAULT_STOP_HOOK_MIN_EDITS,
   evaluateStopHook
 } from "@basou/core";
 var MAX_TRANSCRIPT_BYTES = 8 * 1024 * 1024;
@@ -2047,11 +2047,11 @@ function registerHookCommand(program) {
   hook.command("stop").description(
     "Stop-hook: when a substantive session recorded no decisions or next step, emit a non-blocking nudge to capture them. Reads the Stop hook JSON payload on stdin; never blocks and never fails the session."
   ).option(
-    "--min-actions <n>",
-    `Minimum commands+edits before nudging (default ${DEFAULT_STOP_HOOK_MIN_ACTIONS})`
+    "--min-edits <n>",
+    `Minimum file edits before nudging on edits alone (default ${DEFAULT_STOP_HOOK_MIN_EDITS})`
   ).addHelpText("after", HOOK_STOP_HELP).action(async (options) => {
-    const minActions = parseMinActions(options.minActions);
-    await runHookStop(minActions !== void 0 ? { minActions } : {});
+    const minEdits = parseMinEdits(options.minEdits);
+    await runHookStop(minEdits !== void 0 ? { minEdits } : {});
   });
 }
 var HOOK_STOP_HELP = `
@@ -2065,11 +2065,13 @@ Install as a Claude Code Stop hook in ~/.claude/settings.json:
   }
 
 On every turn end basou inspects the session transcript. If the session did
-substantive work (>= ${DEFAULT_STOP_HOOK_MIN_ACTIONS} commands + file edits by default) but ran no capture
-verb ('basou decision capture' / 'decision record' / 'note'), it emits a
-non-blocking reminder so the agent can record the why / next step. The reminder
-continues the conversation (Claude may act on it or stop); it never forces.
-The 'stop_hook_active' flag is honored so the nudge cannot loop.
+content-substantive work but ran no capture verb ('basou decision capture' /
+'decision record' / 'note'), it emits a non-blocking reminder so the agent can
+record the why / next step. Substantive = EITHER >= ${DEFAULT_STOP_HOOK_MIN_EDITS} file edits (default)
+OR a free-form AskUserQuestion answer (an uncaptured conversational decision).
+Read-only Bash (ls / grep / git status) does NOT count. The reminder is
+non-blocking: Claude sees it and may act on it or stop; it never forces the turn
+to continue. The 'stop_hook_active' flag is honored so the nudge cannot loop.
 `;
 async function runHookStop(options, ctx = {}) {
   try {
@@ -2105,7 +2107,7 @@ async function doRunHookStop(options, ctx) {
     records,
     // stop_hook_active was already handled by the early return above.
     stopHookActive: false,
-    ...options.minActions !== void 0 ? { minActions: options.minActions } : {}
+    ...options.minEdits !== void 0 ? { minEdits: options.minEdits } : {}
   });
   if (evaluation.kind !== "nudge") return;
   write(
@@ -2154,7 +2156,7 @@ async function readTranscriptBounded(path, maxBytes = MAX_TRANSCRIPT_BYTES) {
     await handle.close();
   }
 }
-function parseMinActions(raw) {
+function parseMinEdits(raw) {
   if (raw === void 0 || !/^\d+$/.test(raw)) return void 0;
   return Number(raw);
 }
@@ -9846,7 +9848,7 @@ var pkg = require2("../package.json");
 var BASOU_CLI_VERSION = pkg.version;
 function buildProgram() {
   const program = new Command();
-  program.name("basou").description("Provenance layer for AI development").version(BASOU_CLI_VERSION).enablePositionalOptions();
+  program.name("basou").description("A harness for steering AI coding agents").version(BASOU_CLI_VERSION).enablePositionalOptions();
   registerInitCommand(program);
   registerStatusCommand(program);
   registerStatsCommand(program);