@nac3/forge-cli 0.2.0-alpha.9 → 1.0.0

package/dist/tasks/supervisor.js

@@ -0,0 +1,308 @@
+/**
+ * Task Supervisor (PND-007) -- the persistent owner of long-running
+ * background work for a Forge chat session.
+ *
+ * The problem it solves: the per-turn brain (`claude -p` subprocess) is
+ * ephemeral; anything it spawns as a CHILD dies when the turn ends. The
+ * `yf chat` panel SERVER, by contrast, persists for the whole session.
+ * So survivable work (installers, dev servers, builds, long loops) is
+ * owned HERE, by the server, not by the turn's brain.
+ *
+ * Durability:
+ *   - tasks are spawned detached + unref'd, with stdio redirected to a
+ *     log file -> they survive both the turn AND a server restart.
+ *   - every task has a disk record (~/.yujin-forge/tasks/<slug>/<id>.json)
+ *     so state is the source of truth across restarts.
+ *   - on boot, reconcile() checks PID liveness and marks dead 'running'
+ *     tasks as 'exited'.
+ *   - while the server is alive (the common case) child.on('exit')
+ *     captures the exit code + fires onComplete (the Fase 2 report hook).
+ *
+ * Deps (spawn / clock / liveness / dir) are injected so the whole thing
+ * is unit-tested without real processes.
+ *
+ * ASCII-only.
+ */
+import { promises as fsp } from 'node:fs';
+import * as fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { spawn as nodeSpawn } from 'node:child_process';
+import { classifyTaskType } from './task_type.js';
+const MAX_LABEL = 80;
+function defaultIsAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export class TaskSupervisor {
+    records = new Map();
+    seq = 0;
+    dir;
+    spawn;
+    now;
+    isAlive;
+    onComplete;
+    openLog;
+    constructor(deps) {
+        this.dir = deps.tasksDir;
+        /* Tests inject their own spawn; the default is the real Node spawn. */
+        this.spawn = deps.spawn ?? nodeSpawn;
+        this.now = deps.now ?? Date.now;
+        this.isAlive = deps.isAlive ?? defaultIsAlive;
+        this.onComplete = deps.onComplete;
+        this.openLog = deps.openLog ?? ((p) => {
+            try {
+                return fs.openSync(p, 'a');
+            }
+            catch {
+                return 'ignore';
+            }
+        });
+    }
+    /** Load persisted records + reconcile dead 'running' tasks. */
+    async init() {
+        try {
+            await fsp.mkdir(this.dir, { recursive: true });
+            const files = await fsp.readdir(this.dir);
+            for (const f of files) {
+                if (!f.endsWith('.json'))
+                    continue;
+                try {
+                    const raw = await fsp.readFile(path.join(this.dir, f), 'utf-8');
+                    const rec = JSON.parse(raw);
+                    if (rec && typeof rec.id === 'string')
+                        this.records.set(rec.id, rec);
+                }
+                catch { /* skip a corrupt record */ }
+            }
+        }
+        catch { /* no dir yet */ }
+        this.reconcile();
+    }
+    /** Mark any 'running' task whose process is gone as 'exited'. A task
+     *  with NO pid (a spawn that never started) is also dead -- without
+     *  this it stays 'running' forever across boots (Pablo 2026-06-15). */
+    reconcile() {
+        for (const rec of this.records.values()) {
+            if (rec.status === 'running' && (!rec.pid || !this.isAlive(rec.pid))) {
+                rec.status = 'exited';
+                rec.ended_at = new Date(this.now()).toISOString();
+                void this.persist(rec);
+            }
+        }
+    }
+    /** Launch a survivable background task. */
+    async run(spec) {
+        this.seq += 1;
+        const id = 'task-' + this.now().toString(36) + '-' + this.seq;
+        const logPath = path.join(this.dir, id + '.log');
+        await fsp.mkdir(this.dir, { recursive: true }).catch(() => undefined);
+        const cwd = spec.cwd || process.cwd();
+        const args = Array.isArray(spec.args) ? spec.args : [];
+        const label = (spec.label || spec.cmd).slice(0, MAX_LABEL);
+        const rec = {
+            id, label, type: classifyTaskType(spec.cmd, args, label),
+            cmd: spec.cmd, args, cwd,
+            pid: null, status: 'running',
+            started_at: new Date(this.now()).toISOString(),
+            log_path: logPath,
+        };
+        const fd = this.openLog(logPath);
+        let child;
+        try {
+            child = this.spawn(spec.cmd, args, {
+                cwd, detached: true,
+                stdio: ['ignore', fd, fd],
+                /* Windows: pnpm/npm/npx/yarn are .cmd scripts; Node 22 refuses to
+                 * spawn them WITHOUT a shell (CVE-2024-27980). Run through the
+                 * shell on win32 so the user's build commands actually launch.
+                 * (Pablo 2026-06-15 -- task quedaba sin arrancar.) */
+                ...(process.platform === 'win32' ? { shell: true } : {}),
+            });
+        }
+        catch (e) {
+            rec.status = 'failed';
+            rec.ended_at = new Date(this.now()).toISOString();
+            rec.exit_code = null;
+            rec.error = e instanceof Error ? e.message : String(e);
+            this.records.set(id, rec);
+            await this.persist(rec);
+            return rec;
+        }
+        rec.pid = child.pid ?? null;
+        try {
+            child.unref();
+        }
+        catch { /* noop */ }
+        this.records.set(id, rec);
+        /* No PID -> the command never started (not found / not executable).
+         * Mark failed NOW instead of hanging forever in 'running' waiting for
+         * an exit/error event that may never fire. (Pablo 2026-06-15 -- la
+         * tarea quedaba "running" para siempre con pid:null.) */
+        if (rec.pid === null) {
+            rec.status = 'failed';
+            rec.ended_at = new Date(this.now()).toISOString();
+            rec.exit_code = null;
+            rec.error = 'no se pudo iniciar el comando (no encontrado o no ejecutable)';
+            await this.persist(rec);
+            try {
+                this.onComplete?.(rec);
+            }
+            catch { /* report best-effort */ }
+            return rec;
+        }
+        await this.persist(rec);
+        child.on('exit', (code) => {
+            const r = this.records.get(id);
+            if (!r || r.status !== 'running')
+                return;
+            r.exit_code = code;
+            r.status = code === 0 ? 'done' : 'failed';
+            r.ended_at = new Date(this.now()).toISOString();
+            void this.persist(r);
+            try {
+                this.onComplete?.(r);
+            }
+            catch { /* report best-effort */ }
+        });
+        child.on('error', () => {
+            const r = this.records.get(id);
+            if (!r || r.status !== 'running')
+                return;
+            r.status = 'failed';
+            r.ended_at = new Date(this.now()).toISOString();
+            void this.persist(r);
+            try {
+                this.onComplete?.(r);
+            }
+            catch { /* noop */ }
+        });
+        return rec;
+    }
+    list() {
+        return [...this.records.values()].sort((a, b) => (a.started_at < b.started_at ? 1 : -1));
+    }
+    get(id) {
+        return this.records.get(id) ?? null;
+    }
+    /** Tail the last `lines` of a task's log. */
+    async tailLog(id, lines = 40) {
+        const rec = this.records.get(id);
+        if (!rec)
+            return '';
+        try {
+            const raw = await fsp.readFile(rec.log_path, 'utf-8');
+            const arr = raw.split('\n');
+            return arr.slice(Math.max(0, arr.length - lines)).join('\n');
+        }
+        catch {
+            return '';
+        }
+    }
+    /** Kill a running task (and its process group). */
+    /** Send the kill signal to a running task's process group. No state
+     *  mutation / persistence -- callers own that. */
+    sendKill(rec) {
+        if (rec.status !== 'running' || !rec.pid)
+            return false;
+        let ok = false;
+        try {
+            process.kill(-rec.pid);
+            ok = true;
+        }
+        catch { /* not a group / already dead */ }
+        if (!ok) {
+            try {
+                process.kill(rec.pid);
+                ok = true;
+            }
+            catch { /* already dead */ }
+        }
+        return ok;
+    }
+    kill(id) {
+        const rec = this.records.get(id);
+        if (!rec || rec.status !== 'running' || !rec.pid)
+            return false;
+        const ok = this.sendKill(rec);
+        rec.status = 'killed';
+        rec.ended_at = new Date(this.now()).toISOString();
+        void this.persist(rec);
+        return ok;
+    }
+    /** Remove a task from the list entirely (panel delete button). Kills
+     *  it first if still running, then drops the record + its persisted
+     *  file. Returns false when the id is unknown. */
+    async remove(id) {
+        const rec = this.records.get(id);
+        if (!rec)
+            return false;
+        /* Kill the process WITHOUT persisting (kill() schedules an async
+         * write that would race + re-create the file we are deleting). */
+        if (rec.status === 'running')
+            this.sendKill(rec);
+        this.records.delete(id);
+        try {
+            await fsp.unlink(path.join(this.dir, rec.id + '.json'));
+        }
+        catch { /* already gone */ }
+        return true;
+    }
+    async persist(rec) {
+        try {
+            await fsp.mkdir(this.dir, { recursive: true });
+            const p = path.join(this.dir, rec.id + '.json');
+            await fsp.writeFile(p, JSON.stringify(rec, null, 2), 'utf-8');
+        }
+        catch { /* best-effort */ }
+    }
+}
+/* ---- Per-session singleton + reporter hook --------------------------
+ * The server boots one supervisor per project; the verb dispatcher
+ * (tools.ts) reuses the same instance. A module-level reporter lets the
+ * server wire the Fase 2 completion report (panel SSE + relay) without
+ * a creation-order dependency. */
+let _reporter = null;
+let _supervisor = null;
+let _supervisorKey = '';
+/** Server sets this once at boot to receive task-completion reports. */
+export function setTaskReporter(fn) {
+    _reporter = fn;
+}
+function safeSlug(s) {
+    return (s || 'default').replace(/[^a-zA-Z0-9_.-]/g, '_').slice(0, 80) || 'default';
+}
+function tasksDirFor(slug) {
+    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+    const base = process.env.YF_CONFIG_DIR || path.join(home, '.yujin-forge');
+    return path.join(base, 'tasks', safeSlug(slug));
+}
+/** Get (or lazily create + init) the supervisor for a project. The first
+ *  call kicks off reconcile() in the background. */
+export function getTaskSupervisor(slug) {
+    const key = safeSlug(slug || 'default');
+    if (_supervisor && _supervisorKey === key)
+        return _supervisor;
+    _supervisor = new TaskSupervisor({
+        tasksDir: tasksDirFor(key),
+        onComplete: (rec) => { try {
+            _reporter?.(rec);
+        }
+        catch { /* noop */ } },
+    });
+    _supervisorKey = key;
+    void _supervisor.init();
+    return _supervisor;
+}
+/** Test hook: drop the cached singleton + reporter. */
+export function _resetTaskSupervisor() {
+    _supervisor = null;
+    _supervisorKey = '';
+    _reporter = null;
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/tasks/supervisor.js.map

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

package/dist/tasks/task_type.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Classify a background task by its command so the UI can show a
+ * per-type icon. Pure + heuristic; defaults to 'other'.
+ *
+ * ASCII-only.
+ */
+export type TaskType = 'install' | 'deploy' | 'test' | 'build' | 'server' | 'git' | 'script' | 'other';
+/** Best-effort type from the command + args + label. Order matters:
+ *  more specific intents win over generic runtimes. */
+export declare function classifyTaskType(cmd: string, args?: string[], label?: string): TaskType;
+//# sourceMappingURL=task_type.d.ts.map

package/dist/tasks/task_type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task_type.d.ts","sourceRoot":"","sources":["../../src/tasks/task_type.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAChB,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpF;uDACuD;AACvD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,EAAE,KAAK,SAAK,GAAG,QAAQ,CAWvF"}

package/dist/tasks/task_type.js

@@ -0,0 +1,21 @@
+/** Best-effort type from the command + args + label. Order matters:
+ *  more specific intents win over generic runtimes. */
+export function classifyTaskType(cmd, args = [], label = '') {
+    const hay = (String(cmd) + ' ' + (args || []).join(' ') + ' ' + String(label)).toLowerCase();
+    if (/\b(eas build|eas submit|wrangler|vercel|netlify|gh-pages|deploy|publish)\b/.test(hay))
+        return 'deploy';
+    if (/\b(install|ci|add)\b/.test(hay) && /\b(npm|pnpm|yarn|bun|pip|pip3|poetry|gem|cargo)\b/.test(hay))
+        return 'install';
+    if (/\b(test|vitest|jest|pytest|mocha|playwright|cypress|ava)\b/.test(hay))
+        return 'test';
+    if (/\b(build|compile|tsc|webpack|rollup|esbuild|bundle|export:embed)\b/.test(hay))
+        return 'build';
+    if (/\b(dev|serve|start|watch|nodemon|vite|expo start|next dev|http-server)\b/.test(hay))
+        return 'server';
+    if (/(^|\s)git(\s|$)/.test(hay))
+        return 'git';
+    if (/\b(node|python|python3|deno|bun|bash|sh|zsh|ruby|go run)\b/.test(hay))
+        return 'script';
+    return 'other';
+}
+//# sourceMappingURL=task_type.js.map

package/dist/tasks/task_type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task_type.js","sourceRoot":"","sources":["../../src/tasks/task_type.ts"],"names":[],"mappings":"AASA;uDACuD;AACvD,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,OAAiB,EAAE,EAAE,KAAK,GAAG,EAAE;IAC3E,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAE7F,IAAI,4EAA4E,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC5G,IAAI,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,mDAAmD,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACxH,IAAI,4DAA4D,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IAC1F,IAAI,oEAAoE,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IACnG,IAAI,0EAA0E,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1G,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,4DAA4D,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC5F,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/telemetry/usage.d.ts

@@ -0,0 +1,67 @@
+export type UsageKind = 'claude.chat' | 'claude.spec' | 'claude.clarify' | 'claude.triage' | 'voice.tts' | 'voice.stt' | 'misc';
+export interface UsageEvent {
+    ts: string;
+    kind: UsageKind;
+    model?: string;
+    tokens_in?: number;
+    tokens_out?: number;
+    units?: number;
+    label?: string;
+    project_root?: string;
+}
+export interface PricingTable {
+    models?: Record<string, {
+        in_per_mtok: number;
+        out_per_mtok: number;
+    }>;
+    voice?: {
+        tts_per_million_chars?: number;
+        stt_per_minute?: number;
+    };
+}
+export declare const DEFAULT_PRICING: PricingTable;
+/**
+ * Append a usage event. Never throws -- failures swallowed.
+ */
+export declare function recordUsage(ev: Omit<UsageEvent, 'ts'> & {
+    ts?: string;
+}): Promise<void>;
+/**
+ * Load pricing table (defaults overlaid with user overrides).
+ */
+export declare function loadPricing(): Promise<PricingTable>;
+/**
+ * Read all usage events. Tolerates malformed lines.
+ */
+export declare function readUsage(): Promise<UsageEvent[]>;
+export interface CostBreakdown {
+    total_usd: number;
+    by_kind: Record<string, {
+        count: number;
+        usd: number;
+    }>;
+    by_model: Record<string, {
+        count: number;
+        tokens_in: number;
+        tokens_out: number;
+        usd: number;
+    }>;
+    by_day: Record<string, {
+        count: number;
+        usd: number;
+    }>;
+    events_total: number;
+    events_window: number;
+    window_label: string;
+}
+/**
+ * Compute cost breakdown over a time window. `sinceDays` defaults
+ * to 30. Pass 0 to mean "all-time".
+ */
+export declare function computeCosts(sinceDays?: number): Promise<CostBreakdown>;
+/**
+ * Pretty-format a CostBreakdown for terminal output. Returns
+ * lines; caller does the printing.
+ */
+export declare function formatCosts(b: CostBreakdown): string[];
+//# sourceMappingURL=usage.d.ts.map

package/dist/telemetry/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/telemetry/usage.ts"],"names":[],"mappings":"AAiCA,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,WAAW,GACX,WAAW,GACX,MAAM,CAAC;AAEX,MAAM,WAAW,UAAU;IACzB,EAAE,EAAY,MAAM,CAAC;IACrB,IAAI,EAAU,SAAS,CAAC;IACxB,KAAK,CAAC,EAAQ,MAAM,CAAC;IACrB,SAAS,CAAC,EAAI,MAAM,CAAC;IACrB,UAAU,CAAC,EAAG,MAAM,CAAC;IACrB,KAAK,CAAC,EAAQ,MAAM,CAAC;IACrB,KAAK,CAAC,EAAQ,MAAM,CAAC;IACrB,YAAY,CAAC,EAAC,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,KAAK,CAAC,EAAG;QACP,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,cAAc,CAAC,EAAS,MAAM,CAAC;KAChC,CAAC;CACH;AAID,eAAO,MAAM,eAAe,EAAE,YAe7B,CAAC;AAaF;;GAEG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7F;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,CAWzD;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAYvD;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAO,MAAM,CAAC;IACvB,OAAO,EAAS,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,QAAQ,EAAQ,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtG,MAAM,EAAU,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,YAAY,EAAI,MAAM,CAAC;IACvB,aAAa,EAAG,MAAM,CAAC;IACvB,YAAY,EAAI,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,SAAS,SAAK,GAAG,OAAO,CAAC,aAAa,CAAC,CAsDzE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,EAAE,CAiCtD"}

package/dist/telemetry/usage.js

@@ -0,0 +1,208 @@
+/**
+ * Yujin Forge -- usage + cost telemetry.
+ *
+ * Append-only event log at ~/.yujin-forge/usage.jsonl. Every
+ * Claude API call (or other priced operation) records one JSONL
+ * line with { ts, kind, model?, tokens_in?, tokens_out?, units?,
+ * label?, project_root? }.
+ *
+ * The reader (`yf operate costs`) aggregates by day + by kind +
+ * by model and applies a pricing table to produce a cost report.
+ *
+ * Append is best-effort: telemetry failures NEVER throw to the
+ * caller -- a broken usage file should not break user work.
+ *
+ * Pricing is hard-coded for the 2026 model lineup. Users can
+ * override via ~/.yujin-forge/pricing.json:
+ *   {
+ *     "models": {
+ *        "claude-opus-4-7":  { "in_per_mtok": 15, "out_per_mtok": 75 },
+ *        "claude-sonnet-4-6": { "in_per_mtok":  3, "out_per_mtok": 15 }
+ *     },
+ *     "voice": {
+ *        "tts_per_million_chars": 16,
+ *        "stt_per_minute":        0.006
+ *     }
+ *   }
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { configDir } from '../license/index.js';
+/* Defaults reflect early-2026 Anthropic + Google Cloud pricing.
+ * Users can override via ~/.yujin-forge/pricing.json. */
+export const DEFAULT_PRICING = {
+    models: {
+        'claude-opus-4-7': { in_per_mtok: 15, out_per_mtok: 75 },
+        'claude-opus-4': { in_per_mtok: 15, out_per_mtok: 75 },
+        'claude-sonnet-4-6': { in_per_mtok: 3, out_per_mtok: 15 },
+        'claude-sonnet-4': { in_per_mtok: 3, out_per_mtok: 15 },
+        'claude-haiku-4-5': { in_per_mtok: 1, out_per_mtok: 5 },
+        /* Older lineup kept for back-compat. */
+        'claude-3-5-sonnet': { in_per_mtok: 3, out_per_mtok: 15 },
+        'claude-3-5-haiku': { in_per_mtok: 0.8, out_per_mtok: 4 },
+    },
+    voice: {
+        tts_per_million_chars: 16, /* Google Cloud TTS Neural2 */
+        stt_per_minute: 0.006, /* Google Cloud STT enhanced */
+    },
+};
+function usageFile() {
+    return path.join(configDir(), 'usage.jsonl');
+}
+function pricingFile() {
+    return path.join(configDir(), 'pricing.json');
+}
+async function ensureDir() {
+    try {
+        await fs.mkdir(configDir(), { recursive: true });
+    }
+    catch { /* best effort */ }
+}
+/**
+ * Append a usage event. Never throws -- failures swallowed.
+ */
+export async function recordUsage(ev) {
+    try {
+        await ensureDir();
+        const line = { ts: ev.ts ?? new Date().toISOString(), ...ev };
+        await fs.appendFile(usageFile(), JSON.stringify(line) + '\n', 'utf-8');
+    }
+    catch {
+        /* swallow -- telemetry must never break user flow */
+    }
+}
+/**
+ * Load pricing table (defaults overlaid with user overrides).
+ */
+export async function loadPricing() {
+    try {
+        const raw = await fs.readFile(pricingFile(), 'utf-8');
+        const override = JSON.parse(raw);
+        return {
+            models: { ...(DEFAULT_PRICING.models ?? {}), ...(override.models ?? {}) },
+            voice: { ...(DEFAULT_PRICING.voice ?? {}), ...(override.voice ?? {}) },
+        };
+    }
+    catch {
+        return DEFAULT_PRICING;
+    }
+}
+/**
+ * Read all usage events. Tolerates malformed lines.
+ */
+export async function readUsage() {
+    try {
+        const raw = await fs.readFile(usageFile(), 'utf-8');
+        return raw.split('\n')
+            .filter((l) => l.trim().length > 0)
+            .map((l) => {
+            try {
+                return JSON.parse(l);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((x) => x !== null);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Compute cost breakdown over a time window. `sinceDays` defaults
+ * to 30. Pass 0 to mean "all-time".
+ */
+export async function computeCosts(sinceDays = 30) {
+    const events = await readUsage();
+    const pricing = await loadPricing();
+    const now = Date.now();
+    const cutoffMs = sinceDays > 0 ? now - sinceDays * 24 * 60 * 60 * 1000 : 0;
+    const inWindow = events.filter((e) => Date.parse(e.ts) >= cutoffMs);
+    const breakdown = {
+        total_usd: 0,
+        by_kind: {},
+        by_model: {},
+        by_day: {},
+        events_total: events.length,
+        events_window: inWindow.length,
+        window_label: sinceDays === 0 ? 'all-time' : 'last ' + sinceDays + ' days',
+    };
+    for (const ev of inWindow) {
+        let usd = 0;
+        if (ev.kind.startsWith('claude.')) {
+            const m = ev.model ?? 'unknown';
+            const p = pricing.models?.[m];
+            if (p) {
+                usd = ((ev.tokens_in ?? 0) / 1_000_000) * p.in_per_mtok
+                    + ((ev.tokens_out ?? 0) / 1_000_000) * p.out_per_mtok;
+            }
+            if (!breakdown.by_model[m]) {
+                breakdown.by_model[m] = { count: 0, tokens_in: 0, tokens_out: 0, usd: 0 };
+            }
+            const slot = breakdown.by_model[m];
+            slot.count++;
+            slot.tokens_in += ev.tokens_in ?? 0;
+            slot.tokens_out += ev.tokens_out ?? 0;
+            slot.usd += usd;
+        }
+        else if (ev.kind === 'voice.tts') {
+            usd = ((ev.units ?? 0) / 1_000_000) * (pricing.voice?.tts_per_million_chars ?? 0);
+        }
+        else if (ev.kind === 'voice.stt') {
+            usd = (ev.units ?? 0) * (pricing.voice?.stt_per_minute ?? 0);
+        }
+        breakdown.total_usd += usd;
+        if (!breakdown.by_kind[ev.kind])
+            breakdown.by_kind[ev.kind] = { count: 0, usd: 0 };
+        breakdown.by_kind[ev.kind].count++;
+        breakdown.by_kind[ev.kind].usd += usd;
+        const day = ev.ts.slice(0, 10);
+        if (!breakdown.by_day[day])
+            breakdown.by_day[day] = { count: 0, usd: 0 };
+        breakdown.by_day[day].count++;
+        breakdown.by_day[day].usd += usd;
+    }
+    return breakdown;
+}
+/**
+ * Pretty-format a CostBreakdown for terminal output. Returns
+ * lines; caller does the printing.
+ */
+export function formatCosts(b) {
+    const lines = [];
+    lines.push('Window:          ' + b.window_label);
+    lines.push('Events total:    ' + b.events_total);
+    lines.push('Events in window:' + b.events_window);
+    lines.push('Total USD:       $' + b.total_usd.toFixed(4));
+    lines.push('');
+    lines.push('By kind:');
+    const kinds = Object.entries(b.by_kind).sort((a, c) => c[1].usd - a[1].usd);
+    for (const [k, v] of kinds) {
+        lines.push('  ' + k.padEnd(18) + 'count=' + String(v.count).padStart(5) + '  usd=$' + v.usd.toFixed(4));
+    }
+    if (Object.keys(b.by_model).length > 0) {
+        lines.push('');
+        lines.push('By model:');
+        const models = Object.entries(b.by_model).sort((a, c) => c[1].usd - a[1].usd);
+        for (const [m, v] of models) {
+            lines.push('  ' + m.padEnd(24)
+                + 'count=' + String(v.count).padStart(5)
+                + '  in=' + String(v.tokens_in).padStart(8)
+                + '  out=' + String(v.tokens_out).padStart(7)
+                + '  usd=$' + v.usd.toFixed(4));
+        }
+    }
+    if (Object.keys(b.by_day).length > 0) {
+        lines.push('');
+        lines.push('By day:');
+        const days = Object.entries(b.by_day).sort((a, c) => (a[0] < c[0] ? 1 : -1)).slice(0, 14);
+        for (const [d, v] of days) {
+            lines.push('  ' + d + '  count=' + String(v.count).padStart(5) + '  usd=$' + v.usd.toFixed(4));
+        }
+    }
+    return lines;
+}
+//# sourceMappingURL=usage.js.map

package/dist/telemetry/usage.js.map

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