bb-cc-lite 0.1.10 → 0.1.12

package/dist/why.d.ts

@@ -1,7 +1,20 @@
-import type { Decision, StoredDecision } from "./types.js";
+import type { Decision, StoredDecision, StoredFeedbackOutcome } from "./types.js";
 interface WhyOptions {
     sessionId?: string;
 }
+interface FormatWhyOptions {
+    feedbackOutcomes?: StoredFeedbackOutcome[];
+    color?: boolean;
+}
+export interface WhyContext {
+    decision?: StoredDecision;
+    feedbackOutcomes: StoredFeedbackOutcome[];
+}
 export declare function getWhyDecision(options?: WhyOptions): Promise<StoredDecision | undefined>;
-export declare function formatWhy(decision: Decision): string;
+export declare function getWhyContext(options?: WhyOptions): Promise<WhyContext>;
+export declare function formatWhy(decision: Decision, options?: FormatWhyOptions): string;
+export declare function formatWhyJson(decision: StoredDecision | Decision, feedbackOutcomes?: StoredFeedbackOutcome[]): Decision & {
+    feedbackOutcomes: StoredFeedbackOutcome[];
+};
+export declare function shouldColorWhy(env?: NodeJS.ProcessEnv, isTty?: boolean): boolean;
 export {};

package/dist/why.js

@@ -1,22 +1,53 @@
 import { latestDecisionForSession } from "./session.js";
-import { latestDecision } from "./store.js";
+import { latestDecision, recentFeedbackOutcomes } from "./store.js";
+const RESET = "\u001b[0m";
+const BOLD = "\u001b[1m";
+const DIM = "\u001b[2m";
+const STATE_COLORS = {
+    Healthy: "\u001b[32m",
+    Careful: "\u001b[33m",
+    Stop: "\u001b[1;31m"
+};
+const OUTCOME_COLORS = {
+    pending: DIM,
+    followed: "\u001b[36m",
+    ignored: "\u001b[33m",
+    resolved: "\u001b[32m",
+    superseded: DIM
+};
 export async function getWhyDecision(options = {}) {
     return options.sessionId ? latestDecisionForSession(options.sessionId) : latestDecision();
 }
-export function formatWhy(decision) {
+export async function getWhyContext(options = {}) {
+    const decision = await getWhyDecision(options);
+    return {
+        decision,
+        feedbackOutcomes: decision?.sessionKey ? await recentFeedbackOutcomes(decision.sessionKey) : []
+    };
+}
+export function formatWhy(decision, options = {}) {
+    const color = options.color === true;
     const cost = decision.costUsd === undefined
         ? ""
         : `\nCost evidence: ${decision.costSource === "estimated" ? "estimated " : ""}$${decision.costUsd.toFixed(4)}.`;
     const baseline = baselineWhyLine(decision);
+    const feedbackLedger = formatFeedbackLedger(options.feedbackOutcomes || [], color);
     return [
-        `Last decision: ${decision.state}.`,
-        `Reason: ${decision.primaryEvidence}. ${decision.impact}.`,
+        `Last decision: ${colorState(decision.state, color)}.`,
+        `${colorLabel("Reason", color)}: ${decision.primaryEvidence}. ${decision.impact}.`,
         baseline,
-        `Next action: ${decision.action}.${cost}`
+        feedbackLedger,
+        `${colorLabel("Next action", color)}: ${decision.action}.${cost}`
     ]
         .filter(Boolean)
         .join("\n");
 }
+export function formatWhyJson(decision, feedbackOutcomes = []) {
+    return {
+        ...decision,
+        feedbackOutcomes
+    };
+}
 function baselineWhyLine(decision) {
     if (!decision.baselineNote) {
         return undefined;
@@ -26,4 +57,98 @@ function baselineWhyLine(decision) {
     }
     return `Baseline: ${decision.baselineNote}.`;
 }
+export function shouldColorWhy(env = process.env, isTty = Boolean(process.stdout.isTTY)) {
+    return isTty && !env.NO_COLOR && env.BB_CC_LITE_COLOR !== "0";
+}
+function formatFeedbackLedger(outcomes, color) {
+    const outcome = outcomes.filter((candidate) => candidate.kind === "feedback_outcome").at(-1);
+    if (!outcome) {
+        return undefined;
+    }
+    const steps = feedbackLedgerSteps(outcome, color);
+    if (steps.length === 0) {
+        return undefined;
+    }
+    return [`${colorLabel("Recent bb loop", color)}:`, ...steps.map((step, index) => `${index + 1}. ${step}`)].join("\n");
+}
+function feedbackLedgerSteps(outcome, color) {
+    const action = outcome.feedbackAction === "guard" ? "Guard" : "Coach";
+    const category = categoryLabel(outcome.safeCategory);
+    const steps = [feedbackStep(action, outcome, category)];
+    if (outcome.outcome === "resolved") {
+        if (isValidationCategory(outcome.safeCategory)) {
+            steps.push(`Claude ran ${category}.`);
+            steps.push(`${sentenceCategory(outcome.safeCategory)} passed.`);
+        }
+        else {
+            steps.push("State improved after feedback.");
+        }
+    }
+    else if (outcome.outcome === "followed") {
+        if (outcome.expectedAction === "run_validation" && isValidationCategory(outcome.safeCategory)) {
+            steps.push(`Claude ran ${category}.`);
+        }
+        else {
+            steps.push("Claude changed approach before retrying.");
+        }
+    }
+    else if (outcome.outcome === "ignored") {
+        if (isValidationCategory(outcome.safeCategory)) {
+            steps.push(`Claude retried ${category} without an intervention.`);
+        }
+        else {
+            steps.push("Claude continued the risky flow without the expected intervention.");
+        }
+    }
+    steps.push(`Outcome: ${colorOutcome(outcome.outcome, color)}.`);
+    return steps;
+}
+function feedbackStep(action, outcome, category) {
+    switch (outcome.reasonCode) {
+        case "edit_without_validation":
+            return `${action} feedback: edits needed validation.`;
+        case "validation_repeated":
+        case "blind_retry_loop":
+        case "coach_validation_retry_after_feedback":
+            return `${action} feedback: inspect before retrying ${category}.`;
+        case "finish_with_unresolved_risk":
+            return `${action} feedback: resolve or summarize risk before finishing.`;
+        default:
+            return `${action} feedback: ${expectedActionLabel(outcome.expectedAction)}.`;
+    }
+}
+function expectedActionLabel(expectedAction) {
+    switch (expectedAction) {
+        case "intervene_before_retry":
+            return "change approach before retrying";
+        case "summarize_or_narrow":
+            return "summarize progress or narrow scope";
+        case "validate_or_summarize":
+            return "validate or summarize the blocker";
+        case "run_validation":
+            return "run focused validation";
+    }
+}
+function categoryLabel(category) {
+    if (category === "tests") {
+        return "tests";
+    }
+    return category || "the check";
+}
+function sentenceCategory(category) {
+    const label = categoryLabel(category);
+    return `${label.slice(0, 1).toUpperCase()}${label.slice(1)}`;
+}
+function isValidationCategory(category) {
+    return category === "tests" || category === "lint" || category === "typecheck" || category === "build";
+}
+function colorState(state, enabled) {
+    return enabled ? `${STATE_COLORS[state]}${state}${RESET}` : state;
+}
+function colorOutcome(outcome, enabled) {
+    return enabled ? `${OUTCOME_COLORS[outcome]}${outcome}${RESET}` : outcome;
+}
+function colorLabel(label, enabled) {
+    return enabled ? `${BOLD}${label}${RESET}` : label;
+}
 //# sourceMappingURL=why.js.map

package/dist/why.js.map

@@ -1 +1 @@
-{"version":3,"file":"why.js","sourceRoot":"","sources":["../src/why.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAO5C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAsB,EAAE;IAC3D,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,wBAAwB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAkB;IAC1C,MAAM,IAAI,GACR,QAAQ,CAAC,OAAO,KAAK,SAAS;QAC5B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,oBAAoB,QAAQ,CAAC,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,IAAI,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACpH,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO;QACL,kBAAkB,QAAQ,CAAC,KAAK,GAAG;QACnC,WAAW,QAAQ,CAAC,eAAe,KAAK,QAAQ,CAAC,MAAM,GAAG;QAC1D,QAAQ;QACR,gBAAgB,QAAQ,CAAC,MAAM,IAAI,IAAI,EAAE;KAC1C;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,QAAkB;IACzC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,QAAQ,CAAC,aAAa,KAAK,sBAAsB,EAAE,CAAC;QACtD,OAAO,6DAA6D,CAAC;IACvE,CAAC;IACD,OAAO,aAAa,QAAQ,CAAC,YAAY,GAAG,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"why.js","sourceRoot":"","sources":["../src/why.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bb-cc-lite",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Black Box Claude Code Lite: a small Claude Code status line that says when to continue, slow down, or stop.",
   "type": "module",
   "author": "Softcane",