@slowcook-ai/cli 0.19.0-alpha.18 → 0.19.0-alpha.41

package/dist/cost-store.d.ts

@@ -0,0 +1,52 @@
+export interface CostEntry {
+    agent: string;
+    usd: number;
+    model?: string;
+    round?: string;
+    /** ISO-8601. Caller supplies — keeps the module testable. */
+    at: string;
+    /** Where the cost was incurred (PR comment URL, run URL, etc.) */
+    source_url?: string;
+    /** Optional token breakdown for forensic audits. */
+    tokens_in?: number;
+    tokens_out?: number;
+    cache_read?: number;
+    cache_create?: number;
+}
+/** Sidecar path for a story's cost log. */
+export declare function costSidecarPath(repoRoot: string, storyId: string): string;
+/**
+ * Append one cost entry to the sidecar. Creates the file (and any
+ * missing parent dirs) if it doesn't exist. Does NOT touch the spec
+ * yaml — call `applyCostToSpec` separately so the caller controls
+ * when the spec changes (one write at end-of-round vs N writes per
+ * LLM call).
+ */
+export declare function appendCostEntry(repoRoot: string, storyId: string, entry: CostEntry): void;
+/**
+ * Read + sum all entries in a story's sidecar. Tolerant of:
+ *   - missing sidecar (returns zero/empty).
+ *   - blank lines.
+ *   - malformed lines (logged via the optional callback; total uses parseable ones).
+ */
+export declare function readCostTotal(repoRoot: string, storyId: string, onMalformed?: (lineNo: number, raw: string) => void): {
+    totalUsd: number;
+    entries: CostEntry[];
+};
+/**
+ * Recompute spec.cost.total_usd + spec.cost.last_updated from the
+ * sidecar and write it back. Returns true if the spec was actually
+ * modified (caller stages + commits). Safe to call when the spec
+ * doesn't exist yet — returns false.
+ *
+ * Uses a low-fidelity YAML round-trip (parse + stringify) so it
+ * preserves keys but doesn't preserve comments or key ordering. That's
+ * acceptable for refine-emitted specs which don't carry hand-authored
+ * comments. If we later want comment-preserving updates, switch to
+ * yaml's Document API.
+ */
+export declare function applyCostToSpec(repoRoot: string, storyId: string, nowIso?: string): {
+    changed: boolean;
+    totalUsd: number;
+};
+//# sourceMappingURL=cost-store.d.ts.map

package/dist/cost-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-store.d.ts","sourceRoot":"","sources":["../src/cost-store.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,2CAA2C;AAC3C,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzE;AAOD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,GACf,IAAI,CAKN;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,GAClD;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,EAAE,CAAA;CAAE,CAsB5C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAiC,GACxC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAoBxC"}

package/dist/cost-store.js

@@ -0,0 +1,108 @@
+/**
+ * 0.19.0-α.34 (sc#67) — canonical cost storage.
+ *
+ * Today each agent emits an HTML cost marker into its own PR comment.
+ * Aggregating a story's total cost means walking every comment across
+ * issue + spec PR + mockup PR + tests PR + brew PR. Fragile and slow.
+ *
+ * This module provides:
+ *   - `appendCostEntry(repoRoot, storyId, entry)` — append-only sidecar
+ *     `specs/story-<id>.cost.jsonl`, one JSON line per LLM call.
+ *   - `readCostTotal(repoRoot, storyId)` — sum + entries, for the fuel-
+ *     gauge command (sc#66) and any reflection tooling.
+ *   - `applyCostToSpec(repoRoot, storyId)` — recomputes spec.cost.total_usd
+ *     and spec.cost.last_updated from the sidecar; callers stage + commit.
+ *
+ * The HTML cost markers + visible cost footer stay for now — they're
+ * how the PR-reader sees cost at a glance. Sidecar is for aggregation.
+ * Migration of all agents to call appendCostEntry is incremental: refine
+ * is wired in α.34; vibe / brew / chef are follow-ups.
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import YAML from "yaml";
+const SPECS_DIR = "specs";
+/** Sidecar path for a story's cost log. */
+export function costSidecarPath(repoRoot, storyId) {
+    return join(repoRoot, SPECS_DIR, `story-${storyId}.cost.jsonl`);
+}
+/** Spec yaml path (mirrors spec-yaml.ts; duplicated to avoid cycle). */
+function specYamlPath(repoRoot, storyId) {
+    return join(repoRoot, SPECS_DIR, `story-${storyId}.yaml`);
+}
+/**
+ * Append one cost entry to the sidecar. Creates the file (and any
+ * missing parent dirs) if it doesn't exist. Does NOT touch the spec
+ * yaml — call `applyCostToSpec` separately so the caller controls
+ * when the spec changes (one write at end-of-round vs N writes per
+ * LLM call).
+ */
+export function appendCostEntry(repoRoot, storyId, entry) {
+    const p = costSidecarPath(repoRoot, storyId);
+    mkdirSync(dirname(p), { recursive: true });
+    // Trailing newline → safe append on partial-write recovery.
+    appendFileSync(p, JSON.stringify(entry) + "\n", "utf8");
+}
+/**
+ * Read + sum all entries in a story's sidecar. Tolerant of:
+ *   - missing sidecar (returns zero/empty).
+ *   - blank lines.
+ *   - malformed lines (logged via the optional callback; total uses parseable ones).
+ */
+export function readCostTotal(repoRoot, storyId, onMalformed) {
+    const p = costSidecarPath(repoRoot, storyId);
+    if (!existsSync(p))
+        return { totalUsd: 0, entries: [] };
+    const lines = readFileSync(p, "utf8").split("\n");
+    const entries = [];
+    let total = 0;
+    lines.forEach((raw, i) => {
+        const line = raw.trim();
+        if (!line)
+            return;
+        try {
+            const parsed = JSON.parse(line);
+            if (typeof parsed.usd !== "number" || typeof parsed.agent !== "string") {
+                onMalformed?.(i + 1, raw);
+                return;
+            }
+            entries.push(parsed);
+            total += parsed.usd;
+        }
+        catch {
+            onMalformed?.(i + 1, raw);
+        }
+    });
+    return { totalUsd: total, entries };
+}
+/**
+ * Recompute spec.cost.total_usd + spec.cost.last_updated from the
+ * sidecar and write it back. Returns true if the spec was actually
+ * modified (caller stages + commits). Safe to call when the spec
+ * doesn't exist yet — returns false.
+ *
+ * Uses a low-fidelity YAML round-trip (parse + stringify) so it
+ * preserves keys but doesn't preserve comments or key ordering. That's
+ * acceptable for refine-emitted specs which don't carry hand-authored
+ * comments. If we later want comment-preserving updates, switch to
+ * yaml's Document API.
+ */
+export function applyCostToSpec(repoRoot, storyId, nowIso = new Date().toISOString()) {
+    const specPath = specYamlPath(repoRoot, storyId);
+    if (!existsSync(specPath))
+        return { changed: false, totalUsd: 0 };
+    const { totalUsd } = readCostTotal(repoRoot, storyId);
+    const raw = readFileSync(specPath, "utf8");
+    const parsed = (YAML.parse(raw) ?? {});
+    const existing = parsed.cost ?? {};
+    // Round to 4 dp so we don't churn the spec on sub-tenth-of-a-cent diffs.
+    const rounded = Math.round(totalUsd * 10000) / 10000;
+    if (existing.total_usd === rounded &&
+        typeof existing.last_updated === "string") {
+        return { changed: false, totalUsd: rounded };
+    }
+    parsed.cost = { total_usd: rounded, last_updated: nowIso };
+    writeFileSync(specPath, YAML.stringify(parsed, { lineWidth: 0 }), "utf8");
+    return { changed: true, totalUsd: rounded };
+}
+//# sourceMappingURL=cost-store.js.map

package/dist/cost-store.js.map

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

package/dist/lib/budget.d.ts

@@ -0,0 +1,123 @@
+import { z } from "zod";
+declare const BudgetConfigSchema: z.ZodEffects<z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    monthly_budget_usd: z.ZodOptional<z.ZodNumber>;
+    /** 1-31. The day of the calendar month the budget resets. */
+    monthly_start_day: z.ZodDefault<z.ZodNumber>;
+    /** Optional per-story ceiling (informational). */
+    story_budget_usd: z.ZodOptional<z.ZodNumber>;
+    /**
+     * 0.19.0-α.35 — anthropic credit deposit tracking. Unlike
+     * `monthly_budget_usd` (which resets each period), this models a
+     * non-recurring credit deposit (e.g. you topped up $25). The gauge
+     * subtracts ALL-TIME spend from this number, so once the sidecar
+     * shows $24 of usage you're down to $1 remaining.
+     *
+     * Set via: slowcook budget set --credit 25
+     *
+     * Re-set whenever you top up: slowcook budget set --credit 50
+     * (the all-time spend baseline is captured at the time of set, so
+     * re-setting resets the gauge to "full" for the new deposit).
+     */
+    credit_balance_usd: z.ZodOptional<z.ZodNumber>;
+    /**
+     * ISO timestamp captured when `credit_balance_usd` was set / last
+     * topped up. The gauge sums sidecar entries with `at >=` this value;
+     * spend before this is presumed already paid for by an earlier
+     * deposit. Written by `slowcook budget set --credit`; consumers
+     * shouldn't author this by hand.
+     */
+    credit_baseline_at: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    schema_version: 1;
+    monthly_start_day: number;
+    monthly_budget_usd?: number | undefined;
+    story_budget_usd?: number | undefined;
+    credit_balance_usd?: number | undefined;
+    credit_baseline_at?: string | undefined;
+}, {
+    schema_version: 1;
+    monthly_budget_usd?: number | undefined;
+    monthly_start_day?: number | undefined;
+    story_budget_usd?: number | undefined;
+    credit_balance_usd?: number | undefined;
+    credit_baseline_at?: string | undefined;
+}>, {
+    schema_version: 1;
+    monthly_start_day: number;
+    monthly_budget_usd?: number | undefined;
+    story_budget_usd?: number | undefined;
+    credit_balance_usd?: number | undefined;
+    credit_baseline_at?: string | undefined;
+}, {
+    schema_version: 1;
+    monthly_budget_usd?: number | undefined;
+    monthly_start_day?: number | undefined;
+    story_budget_usd?: number | undefined;
+    credit_balance_usd?: number | undefined;
+    credit_baseline_at?: string | undefined;
+}>;
+export type BudgetConfig = z.infer<typeof BudgetConfigSchema>;
+/**
+ * Load `.brewing/budget.yaml`. Returns null when the file is absent —
+ * gauge is opt-in. Throws on malformed YAML / schema violation so a
+ * mis-authored config surfaces loudly instead of silently disabling.
+ */
+export declare function loadBudgetConfig(repoRoot: string): BudgetConfig | null;
+/** ISO-8601 date of the current monthly budget period start, given config. */
+export declare function currentPeriodStart(config: Pick<BudgetConfig, "monthly_start_day">, now?: Date): Date;
+/**
+ * Sum cost entries across ALL story sidecars in `specs/` whose entry
+ * `at` is >= `since`. Story IDs are derived from filenames
+ * (`story-<id>.cost.jsonl`). Used by both:
+ *   - monthly_budget_usd gauge (since = period start)
+ *   - credit_balance_usd gauge (since = credit_baseline_at)
+ */
+export declare function aggregateSpendSince(repoRoot: string, since: Date): {
+    usd: number;
+    entryCount: number;
+    storyCount: number;
+};
+/**
+ * Back-compat wrapper for the period-based aggregation.
+ */
+export declare function aggregateMonthSpend(repoRoot: string, config: BudgetConfig, now?: Date): {
+    usd: number;
+    entryCount: number;
+    storyCount: number;
+};
+export interface FuelGaugeArgs {
+    currentUsd: number;
+    budgetUsd: number;
+    /** GIF rendered when status === "warn" or "halt". Defaults to fuel-empty. */
+    gifUrl?: string;
+}
+export type BudgetStatus = "ok" | "warn" | "halt";
+export declare function classifyBudgetStatus(currentUsd: number, budgetUsd: number): BudgetStatus;
+/**
+ * Render the fuel-gauge markdown block. Empty string when budget <= 0
+ * (defensive — the config schema rejects this). Always returns a
+ * trailing newline so callers can concatenate without thinking.
+ */
+export declare function formatFuelGauge(args: FuelGaugeArgs): string;
+/**
+ * Render the credit-balance gauge (sc#66 0.19.0-α.35). Reports remaining
+ * USD on a one-shot Anthropic deposit (no auto-recharge). Spends counted
+ * since `baselineAt`; remaining = `deposit - spent`.
+ */
+export declare function formatCreditGauge(args: {
+    depositUsd: number;
+    spentUsd: number;
+    baselineAt: string;
+    gifUrl?: string;
+}): string;
+/**
+ * Convenience: read config + aggregate spend + format gauge(s) in one
+ * call. Returns empty string when no budget.yaml exists (gauge disabled).
+ * Renders BOTH gauges when both fields are set in the config.
+ * Best-effort: a parse failure or aggregation error logs to console.warn
+ * and returns "" rather than blocking the agent's comment.
+ */
+export declare function fuelGaugeFromRepo(repoRoot: string, now?: Date): string;
+export {};
+//# sourceMappingURL=budget.d.ts.map

package/dist/lib/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/lib/budget.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,QAAA,MAAM,kBAAkB;;;IAGtB,6DAA6D;;IAE7D,kDAAkD;;IAElD;;;;;;;;;;;;OAYG;;IAEH;;;;;;OAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKJ,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAWtE;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC,EAC/C,GAAG,GAAE,IAAiB,GACrB,IAAI,CAUN;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,IAAI,GACV;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAuBzD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,EACpB,GAAG,GAAE,IAAiB,GACrB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAGzD;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAKlD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAMxF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAqB3D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAyBT;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CA6BlF"}

package/dist/lib/budget.js

@@ -0,0 +1,225 @@
+/**
+ * 0.19.0-α.34 (sc#66) — project-level fuel gauge.
+ *
+ * Consumer authors `.brewing/budget.yaml`:
+ *
+ *   schema_version: 1
+ *   monthly_budget_usd: 50
+ *   monthly_start_day: 1
+ *
+ * Aggregates spend by reading `specs/story-*.cost.jsonl` sidecars (sc#67)
+ * — much cheaper than walking GH comments. Returns a markdown gauge line
+ * that agents append to their existing cost footer:
+ *
+ *   ⛽ **Project this month:** $42.18 of $50.00 (84%)
+ *   ⚠️ approaching budget — top up at https://console.anthropic.com/...
+ *
+ * Future work (NOT in MVP): halt-before-LLM-call at 95%, override label,
+ * weekly slices, per-scope budgets. Today the gauge is informational.
+ */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import YAML from "yaml";
+import { z } from "zod";
+import { readCostTotal } from "../cost-store.js";
+const BudgetConfigSchema = z.object({
+    schema_version: z.literal(1),
+    monthly_budget_usd: z.number().positive().optional(),
+    /** 1-31. The day of the calendar month the budget resets. */
+    monthly_start_day: z.number().int().min(1).max(31).default(1),
+    /** Optional per-story ceiling (informational). */
+    story_budget_usd: z.number().positive().optional(),
+    /**
+     * 0.19.0-α.35 — anthropic credit deposit tracking. Unlike
+     * `monthly_budget_usd` (which resets each period), this models a
+     * non-recurring credit deposit (e.g. you topped up $25). The gauge
+     * subtracts ALL-TIME spend from this number, so once the sidecar
+     * shows $24 of usage you're down to $1 remaining.
+     *
+     * Set via: slowcook budget set --credit 25
+     *
+     * Re-set whenever you top up: slowcook budget set --credit 50
+     * (the all-time spend baseline is captured at the time of set, so
+     * re-setting resets the gauge to "full" for the new deposit).
+     */
+    credit_balance_usd: z.number().positive().optional(),
+    /**
+     * ISO timestamp captured when `credit_balance_usd` was set / last
+     * topped up. The gauge sums sidecar entries with `at >=` this value;
+     * spend before this is presumed already paid for by an earlier
+     * deposit. Written by `slowcook budget set --credit`; consumers
+     * shouldn't author this by hand.
+     */
+    credit_baseline_at: z.string().optional(),
+}).refine((data) => data.monthly_budget_usd !== undefined || data.credit_balance_usd !== undefined, { message: "must set monthly_budget_usd or credit_balance_usd (or both)" });
+/**
+ * Load `.brewing/budget.yaml`. Returns null when the file is absent —
+ * gauge is opt-in. Throws on malformed YAML / schema violation so a
+ * mis-authored config surfaces loudly instead of silently disabling.
+ */
+export function loadBudgetConfig(repoRoot) {
+    const path = join(repoRoot, ".brewing", "budget.yaml");
+    if (!existsSync(path))
+        return null;
+    const raw = YAML.parse(readFileSync(path, "utf8"));
+    const parsed = BudgetConfigSchema.safeParse(raw);
+    if (!parsed.success) {
+        throw new Error(`Invalid .brewing/budget.yaml: ${parsed.error.issues.map((i) => i.message).join("; ")}`);
+    }
+    return parsed.data;
+}
+/** ISO-8601 date of the current monthly budget period start, given config. */
+export function currentPeriodStart(config, now = new Date()) {
+    const day = config.monthly_start_day;
+    const y = now.getUTCFullYear();
+    const m = now.getUTCMonth();
+    const candidate = new Date(Date.UTC(y, m, day));
+    // If today is before this month's reset day, the period started LAST month.
+    if (now.getTime() < candidate.getTime()) {
+        return new Date(Date.UTC(y, m - 1, day));
+    }
+    return candidate;
+}
+/**
+ * Sum cost entries across ALL story sidecars in `specs/` whose entry
+ * `at` is >= `since`. Story IDs are derived from filenames
+ * (`story-<id>.cost.jsonl`). Used by both:
+ *   - monthly_budget_usd gauge (since = period start)
+ *   - credit_balance_usd gauge (since = credit_baseline_at)
+ */
+export function aggregateSpendSince(repoRoot, since) {
+    const specsDir = join(repoRoot, "specs");
+    if (!existsSync(specsDir))
+        return { usd: 0, entryCount: 0, storyCount: 0 };
+    let usd = 0;
+    let entryCount = 0;
+    let storyCount = 0;
+    for (const f of readdirSync(specsDir)) {
+        const m = /^story-(.+)\.cost\.jsonl$/.exec(f);
+        if (!m || !m[1])
+            continue;
+        const storyId = m[1];
+        const { entries } = readCostTotal(repoRoot, storyId);
+        let storyTouched = false;
+        for (const e of entries) {
+            const at = Date.parse(e.at);
+            if (Number.isFinite(at) && at >= since.getTime()) {
+                usd += e.usd;
+                entryCount++;
+                storyTouched = true;
+            }
+        }
+        if (storyTouched)
+            storyCount++;
+    }
+    return { usd, entryCount, storyCount };
+}
+/**
+ * Back-compat wrapper for the period-based aggregation.
+ */
+export function aggregateMonthSpend(repoRoot, config, now = new Date()) {
+    const periodStart = currentPeriodStart(config, now);
+    return aggregateSpendSince(repoRoot, periodStart);
+}
+const FUEL_GIF = "https://media0.giphy.com/media/v1.Y2lkPTc5MGI3NjExMTVveDJ4bmNuY3dsa2hrNnVweTd6MWhpbXIxc3pvajhsN3Q5b21vdyZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/8CMmJ6F8hTxqX7Ts5k/giphy.gif";
+export function classifyBudgetStatus(currentUsd, budgetUsd) {
+    if (budgetUsd <= 0)
+        return "ok";
+    const ratio = currentUsd / budgetUsd;
+    if (ratio >= 0.95)
+        return "halt";
+    if (ratio >= 0.8)
+        return "warn";
+    return "ok";
+}
+/**
+ * Render the fuel-gauge markdown block. Empty string when budget <= 0
+ * (defensive — the config schema rejects this). Always returns a
+ * trailing newline so callers can concatenate without thinking.
+ */
+export function formatFuelGauge(args) {
+    const { currentUsd, budgetUsd } = args;
+    if (budgetUsd <= 0)
+        return "";
+    const pct = Math.round((currentUsd / budgetUsd) * 100);
+    const status = classifyBudgetStatus(currentUsd, budgetUsd);
+    const lines = [];
+    lines.push(`\n\n⛽ **Project this month:** $${currentUsd.toFixed(2)} of $${budgetUsd.toFixed(2)} (${pct}%)`);
+    if (status === "warn") {
+        lines.push(`⚠️ approaching monthly budget — consider topping up at https://console.anthropic.com/settings/billing`);
+        lines.push(`![fuel low](${args.gifUrl ?? FUEL_GIF})`);
+    }
+    else if (status === "halt") {
+        lines.push(`🛑 monthly budget exceeded — add the \`override-budget\` label to allow agents to continue, or top up at https://console.anthropic.com/settings/billing`);
+        lines.push(`![fuel empty](${args.gifUrl ?? FUEL_GIF})`);
+    }
+    return lines.join("\n") + "\n";
+}
+/**
+ * Render the credit-balance gauge (sc#66 0.19.0-α.35). Reports remaining
+ * USD on a one-shot Anthropic deposit (no auto-recharge). Spends counted
+ * since `baselineAt`; remaining = `deposit - spent`.
+ */
+export function formatCreditGauge(args) {
+    const remaining = Math.max(0, args.depositUsd - args.spentUsd);
+    const ratio = args.depositUsd <= 0 ? 0 : args.spentUsd / args.depositUsd;
+    const pctSpent = Math.round(ratio * 100);
+    const pctLeft = Math.max(0, 100 - pctSpent);
+    let status = "ok";
+    if (ratio >= 0.95)
+        status = "halt";
+    else if (ratio >= 0.8)
+        status = "warn";
+    const lines = [];
+    lines.push(`\n\n🪙 **Anthropic credit:** $${remaining.toFixed(2)} of $${args.depositUsd.toFixed(2)} remaining (${pctLeft}%) — spent $${args.spentUsd.toFixed(2)} since ${args.baselineAt.slice(0, 10)}`);
+    if (status === "warn") {
+        lines.push(`⚠️ approaching empty — top up at https://console.anthropic.com/settings/billing before pipeline runs halt with 402.`);
+        lines.push(`![fuel low](${args.gifUrl ?? FUEL_GIF})`);
+    }
+    else if (status === "halt") {
+        lines.push(`🛑 credit nearly exhausted — pipeline will halt on 402 imminently. Top up at https://console.anthropic.com/settings/billing.`);
+        lines.push(`![fuel empty](${args.gifUrl ?? FUEL_GIF})`);
+    }
+    return lines.join("\n") + "\n";
+}
+/**
+ * Convenience: read config + aggregate spend + format gauge(s) in one
+ * call. Returns empty string when no budget.yaml exists (gauge disabled).
+ * Renders BOTH gauges when both fields are set in the config.
+ * Best-effort: a parse failure or aggregation error logs to console.warn
+ * and returns "" rather than blocking the agent's comment.
+ */
+export function fuelGaugeFromRepo(repoRoot, now = new Date()) {
+    let config;
+    try {
+        config = loadBudgetConfig(repoRoot);
+    }
+    catch (e) {
+        console.warn(`[fuel-gauge] config load failed: ${e.message}`);
+        return "";
+    }
+    if (!config)
+        return "";
+    let out = "";
+    try {
+        if (config.monthly_budget_usd !== undefined) {
+            const { usd } = aggregateMonthSpend(repoRoot, config, now);
+            out += formatFuelGauge({ currentUsd: usd, budgetUsd: config.monthly_budget_usd });
+        }
+        if (config.credit_balance_usd !== undefined && config.credit_baseline_at) {
+            const baseline = new Date(config.credit_baseline_at);
+            const { usd } = aggregateSpendSince(repoRoot, baseline);
+            out += formatCreditGauge({
+                depositUsd: config.credit_balance_usd,
+                spentUsd: usd,
+                baselineAt: config.credit_baseline_at,
+            });
+        }
+    }
+    catch (e) {
+        console.warn(`[fuel-gauge] aggregation failed: ${e.message}`);
+        return "";
+    }
+    return out;
+}
+//# sourceMappingURL=budget.js.map

package/dist/lib/budget.js.map

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

package/dist/lib/mock-shape.d.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+declare const MockShapeConfigSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    shape: z.ZodEnum<["vite", "nextjs"]>;
+    mock_root: z.ZodDefault<z.ZodString>;
+    screens_root: z.ZodDefault<z.ZodString>;
+    design_system_dir: z.ZodDefault<z.ZodString>;
+    router_file: z.ZodOptional<z.ZodString>;
+    scenarios_dir: z.ZodDefault<z.ZodString>;
+    scenario_registry_file: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    schema_version: 1;
+    shape: "vite" | "nextjs";
+    mock_root: string;
+    screens_root: string;
+    design_system_dir: string;
+    scenarios_dir: string;
+    scenario_registry_file: string;
+    router_file?: string | undefined;
+}, {
+    schema_version: 1;
+    shape: "vite" | "nextjs";
+    mock_root?: string | undefined;
+    screens_root?: string | undefined;
+    design_system_dir?: string | undefined;
+    router_file?: string | undefined;
+    scenarios_dir?: string | undefined;
+    scenario_registry_file?: string | undefined;
+}>;
+export type MockShapeConfig = z.infer<typeof MockShapeConfigSchema>;
+/**
+ * Load `.brewing/mock.yaml`. Returns a default config when the file is
+ * absent (preserves backwards-compat with pre-sc#82 consumers). Throws
+ * on parse error / schema violation so a mis-authored config surfaces
+ * loudly rather than silently disabling features.
+ */
+export declare function loadMockShapeConfig(repoRoot: string): MockShapeConfig;
+/**
+ * Returns true when the consumer is on the Vite mock shape. Most
+ * agents only need this binary; full config is for path lookups.
+ */
+export declare function isViteMock(repoRoot: string): boolean;
+export {};
+//# sourceMappingURL=mock-shape.d.ts.map

package/dist/lib/mock-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-shape.d.ts","sourceRoot":"","sources":["../../src/lib/mock-shape.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASzB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAuBpE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAkBrE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/lib/mock-shape.js

@@ -0,0 +1,77 @@
+/**
+ * 0.19.0+ (sc#82) — mock-shape detection.
+ *
+ * Reads `.brewing/mock.yaml` to tell downstream agents (vibe, plate,
+ * recon, port, run-mock) which mock shape the consumer is on. Defaults
+ * to `nextjs` when the file is absent — preserves backwards-compat with
+ * pre-sc#82 consumers whose mock predates the config.
+ *
+ * Single source of truth so every agent reads + writes consistent
+ * conventions: paths to screens, design-system dir, router file,
+ * scenario registry. Nothing else should hard-code these locations.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import YAML from "yaml";
+import { z } from "zod";
+const MockShapeConfigSchema = z.object({
+    schema_version: z.literal(1),
+    shape: z.enum(["vite", "nextjs"]),
+    mock_root: z.string().default("mock"),
+    screens_root: z.string().default("mock/src/apps"),
+    design_system_dir: z.string().default("mock/src/design-system"),
+    router_file: z.string().optional(),
+    scenarios_dir: z.string().default("mock/scenarios"),
+    scenario_registry_file: z.string().default("mock/src/lib/scenario-registry.ts"),
+});
+const NEXTJS_DEFAULT = {
+    schema_version: 1,
+    shape: "nextjs",
+    mock_root: "mock",
+    screens_root: "mock/src/app",
+    design_system_dir: "mock/src/design-system",
+    scenarios_dir: "mock/scenarios",
+    scenario_registry_file: "mock/src/lib/scenario-registry.ts",
+};
+const VITE_DEFAULT = {
+    schema_version: 1,
+    shape: "vite",
+    mock_root: "mock",
+    screens_root: "mock/src/apps",
+    design_system_dir: "mock/src/design-system",
+    router_file: "mock/src/App.tsx",
+    scenarios_dir: "mock/scenarios",
+    scenario_registry_file: "mock/src/lib/scenario-registry.ts",
+};
+/**
+ * Load `.brewing/mock.yaml`. Returns a default config when the file is
+ * absent (preserves backwards-compat with pre-sc#82 consumers). Throws
+ * on parse error / schema violation so a mis-authored config surfaces
+ * loudly rather than silently disabling features.
+ */
+export function loadMockShapeConfig(repoRoot) {
+    const p = join(repoRoot, ".brewing", "mock.yaml");
+    if (!existsSync(p)) {
+        // Heuristic fallback: if mock/src/app/ exists (Next.js convention),
+        // treat as nextjs. If mock/src/App.tsx exists (Vite convention),
+        // treat as vite. Otherwise nextjs for legacy safety.
+        const viteAppFile = join(repoRoot, "mock", "src", "App.tsx");
+        if (existsSync(viteAppFile))
+            return VITE_DEFAULT;
+        return NEXTJS_DEFAULT;
+    }
+    const raw = YAML.parse(readFileSync(p, "utf8"));
+    const parsed = MockShapeConfigSchema.safeParse(raw);
+    if (!parsed.success) {
+        throw new Error(`Invalid .brewing/mock.yaml: ${parsed.error.issues.map((i) => i.message).join("; ")}`);
+    }
+    return parsed.data;
+}
+/**
+ * Returns true when the consumer is on the Vite mock shape. Most
+ * agents only need this binary; full config is for path lookups.
+ */
+export function isViteMock(repoRoot) {
+    return loadMockShapeConfig(repoRoot).shape === "vite";
+}
+//# sourceMappingURL=mock-shape.js.map