bb-cc-lite 0.1.9 → 0.1.10

package/dist/feedback-policy.js

@@ -0,0 +1,245 @@
+const VALIDATION_PURPOSES = new Set(["tests", "lint", "typecheck", "build"]);
+export function decideFeedback(input) {
+    if (input.mode === "observe") {
+        return { kind: "none" };
+    }
+    if (input.hookEventName === "Stop") {
+        return stopFeedback(input);
+    }
+    const coachRetryWarning = coachValidationRetryWarning(input);
+    if (coachRetryWarning) {
+        return coachRetryWarning;
+    }
+    if (input.mode === "guard" && input.hookEventName === "PreToolUse") {
+        const guard = guardFeedback(input);
+        if (guard.kind !== "none") {
+            return guard;
+        }
+        if (!isValidationTool(input.currentTool)) {
+            return { kind: "none" };
+        }
+    }
+    if (input.decision?.state === "Healthy" || hasFreshValidationSuccess(input.summary)) {
+        return { kind: "none" };
+    }
+    const risk = strongestRisk(input);
+    if (!risk) {
+        return { kind: "none" };
+    }
+    const cooldownKey = `coach:${risk.reasonCode}:${risk.safeCategory}`;
+    if (hasRecentCooldown(input.recentFeedback, cooldownKey)) {
+        return { kind: "none" };
+    }
+    return {
+        kind: "coach",
+        delivery: "additional_context",
+        reasonCode: risk.reasonCode,
+        safeCategory: risk.safeCategory,
+        confidence: risk.confidence,
+        messageKey: risk.messageKey,
+        cooldownKey,
+        message: messageFor(risk.messageKey)
+    };
+}
+function guardFeedback(input) {
+    const currentCategory = validationCategory(input.currentTool?.purpose);
+    if (!currentCategory || input.currentTool?.toolName !== "Bash") {
+        return { kind: "none" };
+    }
+    const blindRetry = input.summary.blindRetry;
+    const repeated = strongestRepeatedValidationFailure(input.summary);
+    const isHighConfidenceRetry = !input.summary.hasUnvalidatedEdits &&
+        ((blindRetry?.category === currentCategory && blindRetry.blindRetryFailureCount >= 3) ||
+            (repeated?.safeCategory === currentCategory && repeated.count >= 3));
+    if (!isHighConfidenceRetry) {
+        return { kind: "none" };
+    }
+    const cooldownKey = `guard:guard_validation_retry:${currentCategory}`;
+    return {
+        kind: "guard",
+        reasonCode: "guard_validation_retry",
+        safeCategory: currentCategory,
+        confidence: "high",
+        messageKey: "guard_validation_retry",
+        cooldownKey,
+        message: messageFor("guard_validation_retry")
+    };
+}
+function coachValidationRetryWarning(input) {
+    if (input.mode !== "coach" || input.hookEventName !== "PreToolUse" || !isValidationTool(input.currentTool)) {
+        return undefined;
+    }
+    const category = validationCategory(input.currentTool?.purpose);
+    if (!category || input.summary.hasUnvalidatedEdits) {
+        return undefined;
+    }
+    const blindRetry = input.summary.blindRetry;
+    const repeated = strongestRepeatedValidationFailure(input.summary);
+    const isRetryAfterFailure = (blindRetry?.category === category && blindRetry.blindRetryFailureCount >= 2) ||
+        (repeated?.safeCategory === category && repeated.count >= 2);
+    if (!isRetryAfterFailure) {
+        return undefined;
+    }
+    const priorCoachWasIgnored = input.recentFeedback.some((feedback) => feedback.action === "coach" &&
+        (feedback.cooldownKey === `coach:validation_repeated:${category}` ||
+            feedback.cooldownKey === `coach:blind_retry_loop:${category}` ||
+            feedback.cooldownKey === `coach:coach_validation_retry_after_feedback:${category}`));
+    if (!priorCoachWasIgnored) {
+        return undefined;
+    }
+    return {
+        kind: "coach",
+        delivery: "additional_context",
+        reasonCode: "coach_validation_retry_after_feedback",
+        safeCategory: category,
+        confidence: blindRetry && blindRetry.blindRetryFailureCount >= 3 ? "high" : "medium",
+        messageKey: "coach_validation_retry_after_feedback",
+        cooldownKey: `coach:coach_validation_retry_after_feedback:${category}`,
+        message: messageFor("coach_validation_retry_after_feedback")
+    };
+}
+function stopFeedback(input) {
+    if (input.stopHookActive || input.decision?.state === "Healthy") {
+        return { kind: "none" };
+    }
+    const hasUnresolvedRisk = input.decision?.state === "Stop" ||
+        input.decision?.reasonCode === "blind_retry" ||
+        input.decision?.reasonCode === "tool_failure_repeated" ||
+        input.summary.hasUnvalidatedEdits ||
+        Boolean(input.summary.blindRetry && input.summary.blindRetry.blindRetryFailureCount >= 2) ||
+        Boolean(strongestRepeatedValidationFailure(input.summary));
+    if (!hasUnresolvedRisk) {
+        return { kind: "none" };
+    }
+    const cooldownKey = "coach:finish_with_unresolved_risk:finish";
+    if (hasRecentCooldown(input.recentFeedback, cooldownKey)) {
+        return { kind: "none" };
+    }
+    return {
+        kind: "coach",
+        delivery: "stop_block",
+        reasonCode: "finish_with_unresolved_risk",
+        safeCategory: "finish",
+        confidence: "medium",
+        messageKey: "finish_with_unresolved_risk",
+        cooldownKey,
+        message: messageFor("finish_with_unresolved_risk")
+    };
+}
+function strongestRisk(input) {
+    const blindRetry = input.summary.blindRetry;
+    if (blindRetry && blindRetry.blindRetryFailureCount >= 3) {
+        return {
+            reasonCode: "blind_retry_loop",
+            safeCategory: safeCategoryForFailureCategory(blindRetry.category),
+            confidence: "high",
+            messageKey: "blind_retry_loop"
+        };
+    }
+    if (blindRetry && blindRetry.blindRetryFailureCount >= 2) {
+        return {
+            reasonCode: "validation_repeated",
+            safeCategory: safeCategoryForFailureCategory(blindRetry.category),
+            confidence: "medium",
+            messageKey: "validation_repeated"
+        };
+    }
+    const repeated = strongestRepeatedValidationFailure(input.summary);
+    if (repeated && repeated.count >= 2) {
+        return {
+            reasonCode: "validation_repeated",
+            safeCategory: repeated.safeCategory,
+            confidence: repeated.count >= 3 ? "high" : "medium",
+            messageKey: "validation_repeated"
+        };
+    }
+    if (input.summary.hasUnvalidatedEdits) {
+        return {
+            reasonCode: "edit_without_validation",
+            safeCategory: "edit",
+            confidence: "medium",
+            messageKey: "edit_without_validation"
+        };
+    }
+    if (input.decision?.reasonCode === "budget_busy_no_observed_progress") {
+        return {
+            reasonCode: "budget_busy_no_observed_progress",
+            safeCategory: "budget",
+            confidence: "medium",
+            messageKey: "budget_busy_no_observed_progress"
+        };
+    }
+    if (input.decision?.reasonCode === "cost_budget" || input.decision?.reasonCode === "duration_budget") {
+        return {
+            reasonCode: input.decision.reasonCode,
+            safeCategory: "budget",
+            confidence: "medium",
+            messageKey: "budget_summary"
+        };
+    }
+    if (input.decision?.reasonCode === "busy_no_observed_progress") {
+        return {
+            reasonCode: "busy_no_observed_progress",
+            safeCategory: "activity",
+            confidence: "medium",
+            messageKey: "busy_no_observed_progress"
+        };
+    }
+    return undefined;
+}
+function strongestRepeatedValidationFailure(summary) {
+    return summary.repeatedFailures
+        .flatMap((failure) => {
+        const purpose = validationCategory(failure.purpose);
+        return failure.toolName === "Bash" && purpose ? [{ safeCategory: purpose, count: failure.count }] : [];
+    })
+        .sort((left, right) => right.count - left.count)[0];
+}
+function hasFreshValidationSuccess(summary) {
+    return summary.validationRecovered || (summary.validationSuccesses || 0) > 0;
+}
+function isValidationTool(tool) {
+    return tool?.toolName === "Bash" && validationCategory(tool.purpose) !== undefined;
+}
+function validationCategory(value) {
+    return value && VALIDATION_PURPOSES.has(value)
+        ? value
+        : undefined;
+}
+function safeCategoryForFailureCategory(category) {
+    if (category === "tests" || category === "lint" || category === "typecheck" || category === "build") {
+        return category;
+    }
+    if (category === "mcp") {
+        return "mcp";
+    }
+    return "tool";
+}
+function hasRecentCooldown(recentFeedback, cooldownKey) {
+    return recentFeedback.some((feedback) => feedback.cooldownKey === cooldownKey);
+}
+function messageFor(messageKey) {
+    switch (messageKey) {
+        case "blind_retry_loop":
+            return "bb-cc-lite: the same safe validation category has failed repeatedly without a fix. Inspect the first failure and change approach before retrying.";
+        case "validation_repeated":
+            return "bb-cc-lite: validation has failed repeatedly without a passing check. Inspect the failure pattern, make one targeted fix, then run one focused check.";
+        case "coach_validation_retry_after_feedback":
+            return "bb-cc-lite: do not run the same validation check again yet. First inspect the failure, change the approach, or summarize the blocker; only rerun after a targeted fix.";
+        case "edit_without_validation":
+            return "bb-cc-lite: edits have not been validated yet; run one focused validation check before finishing or making more broad changes.";
+        case "budget_busy_no_observed_progress":
+            return "bb-cc-lite: budget is high and no safe progress signal was observed. Narrow the scope or summarize the blocker before continuing.";
+        case "budget_summary":
+            return "bb-cc-lite: budget is high for this session; summarize progress, name the next smallest check, and avoid broad retries.";
+        case "busy_no_observed_progress":
+            return "bb-cc-lite: many tool calls have run without a safe progress signal. Pause, state what changed, and choose one focused next step.";
+        case "guard_validation_retry":
+            return "bb-cc-lite denied this retry: the same validation category has failed repeatedly without an edit or passing check. Inspect before retrying.";
+        case "finish_with_unresolved_risk":
+            return "bb-cc-lite: unresolved validation risk remains. Run one focused check or summarize the blocker before finishing.";
+        default:
+            return "bb-cc-lite: inspect the latest safe risk signal before continuing.";
+    }
+}
+//# sourceMappingURL=feedback-policy.js.map

package/dist/feedback-policy.js.map

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

package/dist/hook-control.d.ts

@@ -0,0 +1,11 @@
+import { type FeedbackMode } from "./feedback-policy.js";
+import { type HookResponse } from "./hook-response.js";
+export interface HandleHookOptions {
+    fallbackEventName?: string;
+    mode?: FeedbackMode;
+    learn?: boolean;
+    storePath?: string;
+    homeDir?: string;
+    appHomePath?: string;
+}
+export declare function handleHook(raw: string, options?: HandleHookOptions): Promise<HookResponse | undefined>;

package/dist/hook-control.js

@@ -0,0 +1,122 @@
+import { decideFeedback } from "./feedback-policy.js";
+import { responseForFeedback } from "./hook-response.js";
+import { parseHookPayload } from "./hook-payload.js";
+import { lessonContextForProject, recordLessonFromSummary } from "./memory-lessons.js";
+import { hashValue, projectKeyFromPath } from "./paths.js";
+import { asRecord, stringField } from "./status-input.js";
+import { classifyToolIdentity } from "./tool-metadata.js";
+import { hookSummary, latestDecision, recentFeedbackEvents, recordFeedbackEvent, recordHookEvent } from "./store.js";
+const EMPTY_TRANSCRIPT = {
+    pathReadable: true,
+    bytesRead: 0,
+    linesRead: 0,
+    malformedLines: 0,
+    toolCalls: 0,
+    readToolCalls: 0,
+    successfulEditResults: 0,
+    validationChecks: 0,
+    validationSuccesses: 0,
+    toolRecoveryEvents: 0,
+    failedToolResults: 0,
+    repeatedFailures: [],
+    editTestLoopFailures: 0,
+    hasUnvalidatedEdits: false,
+    validationRecovered: false,
+    observedProgress: false,
+    compactionEvents: 0,
+    postCompactionActivity: 0,
+    usage: {}
+};
+export async function handleHook(raw, options = {}) {
+    const root = parseRoot(raw);
+    if (!root) {
+        return undefined;
+    }
+    const hookEventName = stringField(root.hook_event_name) || stringField(root.event) || options.fallbackEventName || "unknown";
+    const sessionKey = hashValue(stringField(root.session_id) || stringField(root.sessionId));
+    const mode = options.mode || "coach";
+    const learn = options.learn !== false && process.env.BB_CC_LITE_LESSON_MEMORY !== "0";
+    const event = parseHookPayload(raw, hookEventName);
+    if (event && hookEventName !== "PreToolUse" && hookEventName !== "SessionStart") {
+        await recordHookEvent(event, options.storePath);
+    }
+    const summary = sessionKey ? await summaryForSession(sessionKey, options.storePath) : EMPTY_TRANSCRIPT;
+    if (hookEventName === "SessionEnd") {
+        if (learn) {
+            const projectKey = projectKeyFromHook(root);
+            if (projectKey) {
+                await recordLessonFromSummary({
+                    projectKey,
+                    summary,
+                    homeDir: options.homeDir,
+                    appHomePath: options.appHomePath
+                });
+            }
+        }
+        return undefined;
+    }
+    if (hookEventName === "SessionStart") {
+        if (mode === "observe" || !learn) {
+            return undefined;
+        }
+        const projectKey = projectKeyFromHook(root);
+        const lessonContext = projectKey
+            ? await lessonContextForProject({ projectKey, homeDir: options.homeDir, appHomePath: options.appHomePath })
+            : undefined;
+        return lessonContext
+            ? {
+                hookSpecificOutput: {
+                    hookEventName,
+                    additionalContext: lessonContext
+                }
+            }
+            : undefined;
+    }
+    const decision = sessionKey ? await latestDecision(sessionKey, options.storePath) : undefined;
+    const recentFeedback = await recentFeedbackEvents(sessionKey, options.storePath);
+    const feedback = decideFeedback({
+        mode,
+        hookEventName,
+        decision,
+        summary,
+        currentTool: currentTool(root),
+        recentFeedback,
+        stopHookActive: root.stop_hook_active === true || root.stopHookActive === true
+    });
+    if (feedback.kind !== "none") {
+        await recordFeedbackEvent({
+            sessionKey,
+            hookEventName,
+            feedbackAction: feedback.kind,
+            cooldownKey: feedback.cooldownKey
+        }, options.storePath);
+    }
+    return responseForFeedback(hookEventName, feedback);
+}
+async function summaryForSession(sessionKey, storePath) {
+    const summary = await hookSummary(sessionKey, storePath);
+    return {
+        ...EMPTY_TRANSCRIPT,
+        ...summary
+    };
+}
+function currentTool(root) {
+    const identity = classifyToolIdentity(stringField(root.tool_name) || stringField(root.toolName), root.tool_input ?? root.toolInput);
+    return {
+        toolName: identity.displayName,
+        purpose: identity.purpose
+    };
+}
+function parseRoot(raw) {
+    try {
+        return asRecord(JSON.parse(raw.trim() || "{}"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function projectKeyFromHook(root) {
+    const cwd = stringField(root.cwd) || stringField(asRecord(root.workspace)?.current_dir) || stringField(asRecord(root.workspace)?.project_dir);
+    return cwd ? projectKeyFromPath(cwd) : undefined;
+}
+//# sourceMappingURL=hook-control.js.map

package/dist/hook-control.js.map

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

package/dist/hook-response.d.ts

@@ -0,0 +1,3 @@
+import type { FeedbackDecision } from "./feedback-policy.js";
+export type HookResponse = Record<string, unknown>;
+export declare function responseForFeedback(hookEventName: string, feedback: FeedbackDecision): HookResponse | undefined;

package/dist/hook-response.js

@@ -0,0 +1,27 @@
+export function responseForFeedback(hookEventName, feedback) {
+    if (feedback.kind === "none") {
+        return undefined;
+    }
+    if (feedback.kind === "guard") {
+        return {
+            hookSpecificOutput: {
+                hookEventName,
+                permissionDecision: "deny",
+                permissionDecisionReason: feedback.message
+            }
+        };
+    }
+    if (feedback.delivery === "stop_block") {
+        return {
+            decision: "block",
+            reason: feedback.message
+        };
+    }
+    return {
+        hookSpecificOutput: {
+            hookEventName,
+            additionalContext: feedback.message
+        }
+    };
+}
+//# sourceMappingURL=hook-response.js.map

package/dist/hook-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-response.js","sourceRoot":"","sources":["../src/hook-response.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,mBAAmB,CAAC,aAAqB,EAAE,QAA0B;IACnF,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO;YACL,kBAAkB,EAAE;gBAClB,aAAa;gBACb,kBAAkB,EAAE,MAAM;gBAC1B,wBAAwB,EAAE,QAAQ,CAAC,OAAO;aAC3C;SACF,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QACvC,OAAO;YACL,QAAQ,EAAE,OAAO;YACjB,MAAM,EAAE,QAAQ,CAAC,OAAO;SACzB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,kBAAkB,EAAE;YAClB,aAAa;YACb,iBAAiB,EAAE,QAAQ,CAAC,OAAO;SACpC;KACF,CAAC;AACJ,CAAC"}

package/dist/hook-summary.d.ts

@@ -2,6 +2,13 @@ import type { TranscriptSummary } from "./types.js";
 export declare function mergeHookSummary(transcript: TranscriptSummary, hookData: {
     failedToolResults: number;
     toolCalls: number;
+    readToolCalls?: number;
+    successfulEditResults?: number;
+    validationChecks?: number;
+    validationSuccesses?: number;
+    validationRecovered?: boolean;
+    hasUnvalidatedEdits?: boolean;
+    unvalidatedEditToolSteps?: number;
     compactionEvents: number;
     postCompactionActivity: number;
     repeatedFailures: TranscriptSummary["repeatedFailures"];

package/dist/hook-summary.js

@@ -10,9 +10,16 @@ export function mergeHookSummary(transcript, hookData) {
     return {
         ...transcript,
         toolCalls: Math.max(transcript.toolCalls, hookData.toolCalls),
+        readToolCalls: Math.max(transcript.readToolCalls, hookData.readToolCalls || 0),
+        successfulEditResults: Math.max(transcript.successfulEditResults || 0, hookData.successfulEditResults || 0),
+        validationChecks: Math.max(transcript.validationChecks || 0, hookData.validationChecks || 0),
+        validationSuccesses: Math.max(transcript.validationSuccesses || 0, hookData.validationSuccesses || 0),
         failedToolResults: Math.max(transcript.failedToolResults, hookData.failedToolResults),
         repeatedFailures: [...repeatedFailures.values()].filter((failure) => failure.count >= 2),
         blindRetry: strongestBlindRetry(transcript.blindRetry, hookData.blindRetry),
+        hasUnvalidatedEdits: transcript.hasUnvalidatedEdits || Boolean(hookData.hasUnvalidatedEdits),
+        unvalidatedEditToolSteps: Math.max(transcript.unvalidatedEditToolSteps || 0, hookData.unvalidatedEditToolSteps || 0) || undefined,
+        validationRecovered: transcript.validationRecovered || Boolean(hookData.validationRecovered),
         compactionEvents: Math.max(transcript.compactionEvents, hookData.compactionEvents),
         postCompactionActivity: mergedPostCompactionActivity(transcript, hookData, latestTimestamp, latestCompactionTimestamp),
         latestTimestamp,

package/dist/hook-summary.js.map

@@ -1 +1 @@
-{"version":3,"file":"hook-summary.js","sourceRoot":"","sources":["../src/hook-summary.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAC9B,UAA6B,EAC7B,QASC;IAED,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAyD,CAAC;IAC1F,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,UAAU,CAAC,gBAAgB,EAAE,GAAG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACrF,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC;IAED,MAAM,eAAe,GAAG,kBAAkB,CAAC,UAAU,CAAC,eAAe,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IACjG,MAAM,yBAAyB,GAAG,kBAAkB,CAAC,UAAU,CAAC,yBAAyB,EAAE,QAAQ,CAAC,yBAAyB,CAAC,CAAC;IAE/H,OAAO;QACL,GAAG,UAAU;QACb,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;QAC7D,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,CAAC;QACrF,gBAAgB,EAAE,CAAC,GAAG,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QACxF,UAAU,EAAE,mBAAmB,CAAC,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC;QAC3E,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,CAAC;QAClF,sBAAsB,EAAE,4BAA4B,CAAC,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,yBAAyB,CAAC;QACtH,eAAe;QACf,yBAAyB;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAsC,EACtC,MAAuC;IAEvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC,sBAAsB,GAAG,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;AACvF,CAAC;AAED,SAAS,UAAU,CAAC,OAAsD;IACxE,OAAO,OAAO,CAAC,QAAQ,KAAK,KAAK,IAAI,OAAO,CAAC,YAAY;QACvD,CAAC,CAAC,OAAO,OAAO,CAAC,YAAY,EAAE;QAC/B,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAyB,EAAE,MAA0B;IAC/E,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;QACpB,OAAO,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACzC,CAAC;IACD,OAAO,KAAK,IAAI,MAAM,CAAC;AACzB,CAAC;AAED,SAAS,4BAA4B,CACnC,UAA+G,EAC/G,QAIC,EACD,eAAmC,EACnC,yBAA6C;IAE7C,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,sBAAsB,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,kBAAkB,GACtB,UAAU,CAAC,yBAAyB,KAAK,yBAAyB,CAAC,CAAC,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7G,MAAM,YAAY,GAAG,QAAQ,CAAC,yBAAyB,KAAK,yBAAyB,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5H,MAAM,iBAAiB,GAAG,eAAe,KAAK,SAAS,IAAI,eAAe,GAAG,yBAAyB,CAAC;IACvG,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC"}
+{"version":3,"file":"hook-summary.js","sourceRoot":"","sources":["../src/hook-summary.ts"],"names":[],"mappings":"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"}

package/dist/memory-lessons.d.ts

@@ -0,0 +1,54 @@
+import type { DecisionConfidence, TranscriptSummary } from "./types.js";
+export declare const LESSON_MEMORY_DIR_NAME = "project-lessons";
+export declare const LESSON_MEMORY_SCHEMA = "bb-cc-lite.lesson-memory.v1";
+export declare const LESSON_CARD_SCHEMA = "bb-cc-lite.lesson-card.v1";
+export declare const LESSON_MEMORY_VERSION = 1;
+type LessonSafeCategory = "tests" | "lint" | "typecheck" | "build";
+export interface LessonEvidenceCounts {
+    failures: number;
+    sessions: number;
+}
+export interface LessonCard {
+    schema: typeof LESSON_CARD_SCHEMA;
+    lessonId: string;
+    projectKey: string;
+    reasonCode: string;
+    safeCategory: LessonSafeCategory;
+    confidence: DecisionConfidence;
+    evidenceCounts: LessonEvidenceCounts;
+    createdAt: string;
+    updatedAt: string;
+    decayAt: string;
+    wordingKey: string;
+}
+export interface ProjectLessonMemory {
+    schema: typeof LESSON_MEMORY_SCHEMA;
+    version: typeof LESSON_MEMORY_VERSION;
+    projectKey: string;
+    updatedAt: string;
+    lessons: LessonCard[];
+}
+export interface LessonMemoryPathOptions {
+    projectKey: string;
+    homeDir?: string;
+    appHomePath?: string;
+}
+export declare function lessonMemoryPath(options: LessonMemoryPathOptions): string;
+export declare function recordLessonFromSummary(options: {
+    projectKey: string;
+    summary: TranscriptSummary;
+    homeDir?: string;
+    appHomePath?: string;
+    now?: Date;
+}): Promise<LessonCard | undefined>;
+export declare function lessonContextForProject(options: {
+    projectKey: string;
+    homeDir?: string;
+    appHomePath?: string;
+    now?: Date;
+}): Promise<string | undefined>;
+export declare function clearLessonMemory(options?: {
+    homeDir?: string;
+    appHomePath?: string;
+}): Promise<void>;
+export {};