bb-cc-lite 0.1.9 → 0.1.11

package/dist/memory-lessons.js

@@ -0,0 +1,211 @@
+import { chmod, mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { appHome } from "./paths.js";
+export const LESSON_MEMORY_DIR_NAME = "project-lessons";
+export const LESSON_MEMORY_SCHEMA = "bb-cc-lite.lesson-memory.v1";
+export const LESSON_CARD_SCHEMA = "bb-cc-lite.lesson-card.v1";
+export const LESSON_MEMORY_VERSION = 1;
+const LESSON_MEMORY_MAX_BYTES = 64 * 1024;
+const LESSON_DECAY_MS = 30 * 24 * 60 * 60 * 1000;
+export function lessonMemoryPath(options) {
+    assertProjectKey(options.projectKey);
+    return join(options.appHomePath ?? appHome(options.homeDir), LESSON_MEMORY_DIR_NAME, `${options.projectKey}.json`);
+}
+export async function recordLessonFromSummary(options) {
+    const candidate = lessonCandidate(options.projectKey, options.summary, options.now ?? new Date());
+    if (!candidate) {
+        return undefined;
+    }
+    const memoryPath = lessonMemoryPath(options);
+    const existing = await readLessonMemory({ ...options, projectKey: options.projectKey });
+    const lessons = existing?.lessons.filter((lesson) => lesson.lessonId !== candidate.lessonId) ?? [];
+    const previous = existing?.lessons.find((lesson) => lesson.lessonId === candidate.lessonId);
+    const next = {
+        ...candidate,
+        createdAt: previous?.createdAt || candidate.createdAt,
+        evidenceCounts: {
+            failures: Math.max(previous?.evidenceCounts.failures || 0, candidate.evidenceCounts.failures),
+            sessions: Math.max(previous?.evidenceCounts.sessions || 0, candidate.evidenceCounts.sessions)
+        }
+    };
+    const memory = {
+        schema: LESSON_MEMORY_SCHEMA,
+        version: LESSON_MEMORY_VERSION,
+        projectKey: options.projectKey,
+        updatedAt: next.updatedAt,
+        lessons: [...lessons, next].sort((left, right) => left.lessonId.localeCompare(right.lessonId))
+    };
+    await writeLessonMemory(memory, memoryPath);
+    return next;
+}
+export async function lessonContextForProject(options) {
+    const now = options.now ?? new Date();
+    const memory = await readLessonMemory(options);
+    if (!memory) {
+        return undefined;
+    }
+    const active = memory.lessons.filter((lesson) => !isExpired(lesson, now));
+    if (active.length !== memory.lessons.length) {
+        await writeLessonMemory({ ...memory, updatedAt: now.toISOString(), lessons: active }, lessonMemoryPath(options));
+    }
+    const selected = active
+        .filter((lesson) => lesson.confidence !== "low" && lesson.evidenceCounts.failures >= 3)
+        .sort((left, right) => right.evidenceCounts.failures - left.evidenceCounts.failures)[0];
+    if (!selected) {
+        return undefined;
+    }
+    return lessonMessage(selected.wordingKey);
+}
+export async function clearLessonMemory(options = {}) {
+    await rm(join(options.appHomePath ?? appHome(options.homeDir), LESSON_MEMORY_DIR_NAME), { recursive: true, force: true });
+}
+async function readLessonMemory(options) {
+    try {
+        const path = lessonMemoryPath(options);
+        const fileStat = await stat(path);
+        if (!fileStat.isFile() || fileStat.size > LESSON_MEMORY_MAX_BYTES) {
+            return undefined;
+        }
+        const parsed = JSON.parse(await readFile(path, "utf8"));
+        return isProjectLessonMemory(parsed, options.projectKey) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeLessonMemory(memory, path) {
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    const tempPath = `${path}.${process.pid}.${Date.now()}.tmp`;
+    await writeFile(tempPath, `${JSON.stringify(memory, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
+    await chmod(tempPath, 0o600);
+    await rename(tempPath, path);
+}
+function lessonCandidate(projectKey, summary, now) {
+    assertProjectKey(projectKey);
+    const strongest = strongestValidationFailure(summary);
+    if (!strongest || strongest.failures < 2) {
+        return undefined;
+    }
+    const timestamp = now.toISOString();
+    const confidence = strongest.failures >= 3 ? "high" : "low";
+    return {
+        schema: LESSON_CARD_SCHEMA,
+        lessonId: `validation_repeated:${strongest.safeCategory}`,
+        projectKey,
+        reasonCode: "validation_repeated",
+        safeCategory: strongest.safeCategory,
+        confidence,
+        evidenceCounts: {
+            failures: strongest.failures,
+            sessions: 1
+        },
+        createdAt: timestamp,
+        updatedAt: timestamp,
+        decayAt: new Date(now.getTime() + LESSON_DECAY_MS).toISOString(),
+        wordingKey: `validation_repeated:${strongest.safeCategory}`
+    };
+}
+function strongestValidationFailure(summary) {
+    const blindRetry = summary.blindRetry;
+    const blindRetryCategory = lessonCategory(blindRetry?.category);
+    const blindRetryCandidate = blindRetry && blindRetryCategory
+        ? {
+            safeCategory: blindRetryCategory,
+            failures: blindRetry.blindRetryFailureCount
+        }
+        : undefined;
+    const repeatedCandidate = summary.repeatedFailures
+        .flatMap((failure) => {
+        const category = failure.toolName === "Bash" ? lessonCategory(failure.purpose) : undefined;
+        return category ? [{ safeCategory: category, failures: failure.count }] : [];
+    })
+        .sort((left, right) => right.failures - left.failures)[0];
+    if (blindRetryCandidate && repeatedCandidate) {
+        return blindRetryCandidate.failures >= repeatedCandidate.failures ? blindRetryCandidate : repeatedCandidate;
+    }
+    return blindRetryCandidate || repeatedCandidate;
+}
+function lessonCategory(value) {
+    return value === "tests" || value === "lint" || value === "typecheck" || value === "build" ? value : undefined;
+}
+function isExpired(lesson, now) {
+    const decayAtMs = Date.parse(lesson.decayAt);
+    return !Number.isFinite(decayAtMs) || decayAtMs <= now.getTime();
+}
+function lessonMessage(wordingKey) {
+    if (wordingKey.startsWith("validation_repeated:")) {
+        return "bb-cc-lite lesson: similar validation retries in this project rarely recovered after repeated failures. Inspect the first failure, make one targeted fix, then run one focused check.";
+    }
+    return undefined;
+}
+function isProjectLessonMemory(value, projectKey) {
+    const root = asRecord(value);
+    if (!root ||
+        !hasOnlyKeys(root, MEMORY_KEYS) ||
+        root.schema !== LESSON_MEMORY_SCHEMA ||
+        root.version !== LESSON_MEMORY_VERSION ||
+        root.projectKey !== projectKey ||
+        !isIsoTimestamp(root.updatedAt) ||
+        !Array.isArray(root.lessons)) {
+        return false;
+    }
+    return root.lessons.every((lesson) => isLessonCard(lesson, projectKey));
+}
+function isLessonCard(value, projectKey) {
+    const root = asRecord(value);
+    if (!root ||
+        !hasOnlyKeys(root, CARD_KEYS) ||
+        root.schema !== LESSON_CARD_SCHEMA ||
+        root.projectKey !== projectKey ||
+        typeof root.lessonId !== "string" ||
+        typeof root.reasonCode !== "string" ||
+        !lessonCategory(String(root.safeCategory)) ||
+        !isConfidence(root.confidence) ||
+        typeof root.wordingKey !== "string" ||
+        !isIsoTimestamp(root.createdAt) ||
+        !isIsoTimestamp(root.updatedAt) ||
+        !isIsoTimestamp(root.decayAt)) {
+        return false;
+    }
+    const counts = asRecord(root.evidenceCounts);
+    return Boolean(counts &&
+        hasOnlyKeys(counts, EVIDENCE_KEYS) &&
+        isNonNegativeInteger(counts.failures) &&
+        isNonNegativeInteger(counts.sessions));
+}
+function asRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
+}
+function hasOnlyKeys(value, allowed) {
+    return Object.keys(value).every((key) => allowed.has(key));
+}
+function isIsoTimestamp(value) {
+    return typeof value === "string" && Number.isFinite(Date.parse(value));
+}
+function isConfidence(value) {
+    return value === "low" || value === "medium" || value === "high";
+}
+function isNonNegativeInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function assertProjectKey(projectKey) {
+    if (!/^[a-f0-9]{64}$/u.test(projectKey)) {
+        throw new Error("invalid project key");
+    }
+}
+const MEMORY_KEYS = new Set(["schema", "version", "projectKey", "updatedAt", "lessons"]);
+const CARD_KEYS = new Set([
+    "schema",
+    "lessonId",
+    "projectKey",
+    "reasonCode",
+    "safeCategory",
+    "confidence",
+    "evidenceCounts",
+    "createdAt",
+    "updatedAt",
+    "decayAt",
+    "wordingKey"
+]);
+const EVIDENCE_KEYS = new Set(["failures", "sessions"]);
+//# sourceMappingURL=memory-lessons.js.map

package/dist/memory-lessons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-lessons.js","sourceRoot":"","sources":["../src/memory-lessons.ts"],"names":[],"mappings":"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"}

package/dist/project-config.d.ts

@@ -0,0 +1,6 @@
+export type ValidationCommandCategory = "tests" | "lint" | "typecheck" | "build";
+export interface ProjectConfig {
+    validationCommands: Partial<Record<ValidationCommandCategory, string[]>>;
+}
+export declare function loadProjectConfig(cwd: string | undefined): Promise<ProjectConfig>;
+export declare function classifyConfiguredValidationCommand(command: string | undefined, config: ProjectConfig | undefined): ValidationCommandCategory | undefined;

package/dist/project-config.js

@@ -0,0 +1,93 @@
+import { readFile, stat } from "node:fs/promises";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+const CONFIG_FILE = ".bb-cc-lite.json";
+const MAX_SEARCH_DEPTH = 20;
+const MAX_CONFIG_BYTES = 16 * 1024;
+const MAX_COMMANDS_PER_CATEGORY = 20;
+const MAX_COMMAND_LENGTH = 200;
+const VALIDATION_CATEGORIES = ["tests", "lint", "typecheck", "build"];
+const EMPTY_CONFIG = { validationCommands: {} };
+export async function loadProjectConfig(cwd) {
+    const configPath = await findProjectConfig(cwd);
+    if (!configPath) {
+        return EMPTY_CONFIG;
+    }
+    try {
+        const fileStat = await stat(configPath);
+        if (!fileStat.isFile() || fileStat.size > MAX_CONFIG_BYTES) {
+            return EMPTY_CONFIG;
+        }
+        return sanitizeConfig(JSON.parse(await readFile(configPath, "utf8")));
+    }
+    catch {
+        return EMPTY_CONFIG;
+    }
+}
+export function classifyConfiguredValidationCommand(command, config) {
+    const normalizedCommand = normalizeCommand(command);
+    if (!normalizedCommand || !config) {
+        return undefined;
+    }
+    for (const category of VALIDATION_CATEGORIES) {
+        for (const configured of config.validationCommands[category] || []) {
+            const normalizedConfigured = normalizeCommand(configured);
+            if (normalizedConfigured &&
+                (normalizedCommand === normalizedConfigured || normalizedCommand.startsWith(`${normalizedConfigured} `))) {
+                return category;
+            }
+        }
+    }
+    return undefined;
+}
+async function findProjectConfig(cwd) {
+    if (!cwd) {
+        return undefined;
+    }
+    let current = isAbsolute(cwd) ? cwd : resolve(cwd);
+    for (let depth = 0; depth < MAX_SEARCH_DEPTH; depth += 1) {
+        const candidate = join(current, CONFIG_FILE);
+        try {
+            const fileStat = await stat(candidate);
+            if (fileStat.isFile()) {
+                return candidate;
+            }
+        }
+        catch {
+            // Keep walking upward; invalid/missing config must not break statusline.
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return undefined;
+        }
+        current = parent;
+    }
+    return undefined;
+}
+function sanitizeConfig(value) {
+    if (!isRecord(value) || !isRecord(value.validationCommands)) {
+        return EMPTY_CONFIG;
+    }
+    const validationCommands = {};
+    for (const category of VALIDATION_CATEGORIES) {
+        const commands = value.validationCommands[category];
+        if (!Array.isArray(commands)) {
+            continue;
+        }
+        const safeCommands = commands
+            .flatMap((command) => (typeof command === "string" ? [normalizeCommand(command)] : []))
+            .filter((command) => typeof command === "string" && command.length > 0 && command.length <= MAX_COMMAND_LENGTH)
+            .slice(0, MAX_COMMANDS_PER_CATEGORY);
+        if (safeCommands.length > 0) {
+            validationCommands[category] = safeCommands;
+        }
+    }
+    return { validationCommands };
+}
+function normalizeCommand(value) {
+    const normalized = value?.trim().replace(/\s+/gu, " ");
+    return normalized || undefined;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=project-config.js.map

package/dist/project-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.js","sourceRoot":"","sources":["../src/project-config.ts"],"names":[],"mappings":"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"}

package/dist/renderer.js

@@ -19,23 +19,25 @@ function defaultCandidates(decision) {
     const evidence = decision.evidence.map((item) => item.label);
     const headline = decision.diagnosis || decision.primaryEvidence;
     const badge = decision.baselineNote || "";
+    const feedbackNote = decision.feedbackNote || "";
     if (decision.diagnosis) {
         return [
-            [`bb: ${decision.state}`, headline, badge, decision.action],
-            [`bb: ${decision.state}`, headline, decision.action],
+            [`bb: ${decision.state}`, headline, badge, feedbackNote, decision.action],
+            [`bb: ${decision.state}`, headline, feedbackNote, decision.action],
             [`bb: ${decision.state}`, headline]
         ];
     }
     return [
-        [`bb: ${decision.state}`, headline, badge, ...evidence.filter((item) => item !== headline), decision.action],
-        [`bb: ${decision.state}`, headline, decision.action],
+        [`bb: ${decision.state}`, headline, badge, feedbackNote, ...evidence.filter((item) => item !== headline), decision.action],
+        [`bb: ${decision.state}`, headline, feedbackNote, decision.action],
         [`bb: ${decision.state}`, headline]
     ];
 }
 function stopCandidates(decision) {
     const costEvidence = decision.evidence.filter((item) => item.detail).map((item) => item.label);
     const headline = decision.diagnosis || decision.primaryEvidence;
-    const fullWhy = decision.impact && decision.impact !== headline ? `why: ${headline}; ${decision.impact}` : `why: ${headline}`;
+    const feedbackNote = decision.feedbackNote ? `; ${decision.feedbackNote}` : "";
+    const fullWhy = decision.impact && decision.impact !== headline ? `why: ${headline}; ${decision.impact}${feedbackNote}` : `why: ${headline}${feedbackNote}`;
     const shortWhy = `why: ${headline}`;
     const action = `do: ${decision.action}`;
     return [

package/dist/renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"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"}

package/dist/settings.d.ts

@@ -1,4 +1,5 @@
 export type SettingsScope = "local" | "project" | "user";
+export type InstallMode = "observe" | "coach" | "guard";
 export interface SettingsTarget {
     scope: SettingsScope;
     settingsPath: string;
@@ -12,6 +13,8 @@ export interface InstallOptions {
     replace?: boolean;
     cliFilePath?: string;
     hooks?: boolean;
+    mode?: InstallMode;
+    learn?: boolean;
 }
 export interface UninstallOptions {
     scope?: SettingsScope;

package/dist/settings.js

@@ -34,6 +34,8 @@ export async function installStatusLine(options = {}) {
     const targetRead = await readSettings(target.settingsPath);
     const existing = targetRead.settings.statusLine;
     const existingHooks = targetRead.settings.hooks;
+    const mode = options.mode || "coach";
+    const learn = options.learn !== false;
     if (existing && !isBbStatusLine(existing) && !options.replace) {
         return {
             status: "refused",
@@ -41,14 +43,14 @@ export async function installStatusLine(options = {}) {
             message: `Existing Claude statusLine found in ${describeSettingsTarget(target)}; pass --replace to replace it with bb-cc-lite.`
         };
     }
-    const launchers = await ensureRuntimeLaunchers(options.cliFilePath || cliPath(), target.homeDir);
+    const launchers = await ensureRuntimeLaunchers(options.cliFilePath || cliPath(), target.homeDir, { learn });
     const statusLine = {
         type: "command",
         command: quoteShell(launchers.statusline),
         padding: 0
     };
     if (existing && isBbStatusLine(existing)) {
-        const afterHooks = options.hooks ? mergeBbHooks(existingHooks, launchers.hook) : existingHooks;
+        const afterHooks = options.hooks ? mergeBbHooks(existingHooks, launchers.hook, mode, learn) : existingHooks;
         const shouldWriteStatusLine = JSON.stringify(existing) !== JSON.stringify(statusLine);
         const shouldWriteHooks = options.hooks && JSON.stringify(existingHooks) !== JSON.stringify(afterHooks);
         if (shouldWriteStatusLine || shouldWriteHooks) {
@@ -68,7 +70,7 @@ export async function installStatusLine(options = {}) {
                 target,
                 command: statusLine.command,
                 backupId: installId,
-                message: `bb-cc-lite statusLine is already installed in ${describeSettingsTarget(target)}; ${options.hooks ? "repaired optional hooks and " : ""}refreshed runtime launcher.`
+                message: `bb-cc-lite statusLine is already installed in ${describeSettingsTarget(target)}; ${options.hooks ? `repaired ${hooksLabel(mode)} and ` : ""}refreshed runtime launcher.`
             };
         }
         return {
@@ -83,7 +85,7 @@ export async function installStatusLine(options = {}) {
     const afterSettings = {
         ...beforeSettings,
         statusLine,
-        ...(options.hooks ? { hooks: mergeBbHooks(beforeSettings.hooks, launchers.hook) } : {})
+        ...(options.hooks ? { hooks: mergeBbHooks(beforeSettings.hooks, launchers.hook, mode, learn) } : {})
     };
     const afterRaw = `${JSON.stringify(afterSettings, null, 2)}\n`;
     const installId = randomUUID();
@@ -95,8 +97,8 @@ export async function installStatusLine(options = {}) {
         command: statusLine.command,
         backupId: installId,
         message: existing
-            ? `Replaced existing Claude statusLine with bb-cc-lite${options.hooks ? " and optional hooks" : ""} in ${describeSettingsTarget(target)}. Previous settings were backed up.`
-            : `Installed bb-cc-lite statusLine${options.hooks ? " and optional hooks" : ""} in ${describeSettingsTarget(target)}.`
+            ? `Replaced existing Claude statusLine with bb-cc-lite${options.hooks ? ` and ${hooksLabel(mode)}` : ""} in ${describeSettingsTarget(target)}. Previous settings were backed up.`
+            : `Installed bb-cc-lite statusLine${options.hooks ? ` and ${hooksLabel(mode)}` : ""} in ${describeSettingsTarget(target)}.`
     };
 }
 export async function uninstallStatusLine(options = {}) {
@@ -201,18 +203,19 @@ export function isBbStatusLine(value) {
     const normalizedCommand = command.replaceAll("'", "");
     return commandReferencesBbCcLite(command) || normalizedCommand.includes(join(appHome(), "bin", "statusline"));
 }
-async function ensureRuntimeLaunchers(cliFilePath, homeDir) {
+async function ensureRuntimeLaunchers(cliFilePath, homeDir, options = {}) {
     const home = appHome(homeDir);
     const binDir = join(home, "bin");
     const statuslinePath = join(binDir, "statusline");
     const hookPath = join(binDir, "hook");
     const stableCliPath = await copyRuntime(cliFilePath, home);
+    const learningExports = options.learn === false ? "export BB_CC_LITE_AUTO_LEARN=0\nexport BB_CC_LITE_LESSON_MEMORY=0\n" : "";
     await mkdir(binDir, { recursive: true, mode: 0o700 });
-    await writeFile(statuslinePath, `#!/bin/sh\nexport BB_CC_LITE_HOME=${quoteShell(home)}\nexec ${quoteShell(process.execPath)} ${quoteShell(stableCliPath)} statusline "$@"\n`, {
+    await writeFile(statuslinePath, `#!/bin/sh\nexport BB_CC_LITE_HOME=${quoteShell(home)}\n${learningExports}exec ${quoteShell(process.execPath)} ${quoteShell(stableCliPath)} statusline "$@"\n`, {
         encoding: "utf8",
         mode: 0o700
     });
-    await writeFile(hookPath, `#!/bin/sh\nexport BB_CC_LITE_HOME=${quoteShell(home)}\nexec ${quoteShell(process.execPath)} ${quoteShell(stableCliPath)} hook "$@"\n`, {
+    await writeFile(hookPath, `#!/bin/sh\nexport BB_CC_LITE_HOME=${quoteShell(home)}\n${learningExports}exec ${quoteShell(process.execPath)} ${quoteShell(stableCliPath)} hook "$@"\n`, {
         encoding: "utf8",
         mode: 0o700
     });
@@ -220,19 +223,27 @@ async function ensureRuntimeLaunchers(cliFilePath, homeDir) {
     await chmod(hookPath, 0o700);
     return { statusline: statuslinePath, hook: hookPath };
 }
-function mergeBbHooks(existingHooks, hookPath) {
+function mergeBbHooks(existingHooks, hookPath, mode, learn) {
     const result = removeBbHooks(existingHooks, undefined) ?? {};
-    for (const eventName of SAFE_HOOK_EVENTS) {
+    for (const spec of hookSpecsForMode(mode)) {
+        const eventName = spec.eventName;
         const entries = Array.isArray(result[eventName]) ? [...result[eventName]] : [];
         entries.push({
-            matcher: "*",
+            matcher: spec.matcher,
             hooks: [
                 {
                     type: "command",
                     command: hookPath,
-                    args: ["--bb-cc-lite-hook", eventName],
-                    async: true,
-                    timeout: 1
+                    args: [
+                        "--bb-cc-lite-hook",
+                        eventName,
+                        "--bb-cc-lite-mode",
+                        mode,
+                        "--bb-cc-lite-learn",
+                        learn ? "1" : "0"
+                    ],
+                    ...(spec.async ? { async: true } : {}),
+                    timeout: spec.timeout
                 }
             ]
         });
@@ -240,6 +251,36 @@ function mergeBbHooks(existingHooks, hookPath) {
     }
     return result;
 }
+function hookSpecsForMode(mode) {
+    if (mode === "observe") {
+        return SAFE_HOOK_EVENTS.map((eventName) => ({
+            eventName,
+            matcher: "*",
+            async: true,
+            timeout: 1
+        }));
+    }
+    return [
+        { eventName: "SessionStart", matcher: "*", async: false, timeout: 2 },
+        { eventName: "PreToolUse", matcher: "Bash", async: false, timeout: 2 },
+        { eventName: "PostToolUse", matcher: "*", async: false, timeout: 2 },
+        { eventName: "PostToolUseFailure", matcher: "*", async: false, timeout: 2 },
+        { eventName: "PostToolBatch", matcher: "*", async: false, timeout: 2 },
+        { eventName: "PreCompact", matcher: "*", async: true, timeout: 1 },
+        { eventName: "PostCompact", matcher: "*", async: true, timeout: 1 },
+        { eventName: "Stop", matcher: "*", async: false, timeout: 2 },
+        { eventName: "SessionEnd", matcher: "*", async: false, timeout: 2 }
+    ];
+}
+function hooksLabel(mode) {
+    if (mode === "observe") {
+        return "observe-only telemetry hooks";
+    }
+    if (mode === "guard") {
+        return "guard hooks";
+    }
+    return "coach hooks";
+}
 function removeBbHooks(existingHooks, homeDir) {
     const hooks = cloneRecord(existingHooks);
     for (const [eventName, entries] of Object.entries(hooks)) {