@rasensio/aidlc 1.2.0 → 1.3.0

package/dist/cost/hooks/kiro.js

@@ -0,0 +1,66 @@
+/**
+ * kiro hook installer: own-file v1 hooks in .kiro/hooks/aidlc-cost.json.
+ *
+ * Kiro v1 hooks (IDE 1.0 / CLI 3.0+) are standalone JSON files, so install
+ * is a file write and remove is a delete — no merge risk. `Stop` fires per
+ * response (no session-end event exists); the recorder's cursor + lock make
+ * repeated firings cheap no-ops (design §4.2, D2).
+ *
+ * Kiro CLI 2.x uses a different hook format and is out of scope for v1.
+ */
+import { readFileSync, writeFileSync, existsSync, unlinkSync, mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { HOOK_MARKER } from './claude-code.js';
+function hookFilePath(projectRoot) {
+    return join(projectRoot, '.kiro', 'hooks', 'aidlc-cost.json');
+}
+function quote(p) {
+    return `"${p.replace(/"/g, '\\"')}"`;
+}
+export function installKiroHooks(projectRoot, nodePath, cliPath) {
+    const base = `${quote(nodePath)} ${quote(cliPath)}`;
+    const file = {
+        version: 'v1',
+        hooks: [
+            {
+                name: 'aidlc-cost-record',
+                trigger: 'Stop',
+                action: {
+                    type: 'command',
+                    command: `${base} cost record --provider kiro --detach ${HOOK_MARKER}`,
+                },
+            },
+            {
+                name: 'aidlc-cost-session-start',
+                trigger: 'SessionStart',
+                action: {
+                    type: 'command',
+                    command: `${base} cost session-start --provider kiro ${HOOK_MARKER}`,
+                },
+            },
+        ],
+    };
+    const path = hookFilePath(projectRoot);
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(file, null, 2) + '\n');
+}
+export function removeKiroHooks(projectRoot) {
+    const path = hookFilePath(projectRoot);
+    if (existsSync(path))
+        unlinkSync(path);
+}
+export function kiroHookStatus(projectRoot) {
+    const path = hookFilePath(projectRoot);
+    if (!existsSync(path))
+        return { installed: false, commandResolvable: false };
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        const cmd = parsed.hooks?.find((h) => h.action?.command?.includes(HOOK_MARKER))?.action?.command;
+        const quoted = cmd?.match(/"([^"]+)"\s+"([^"]+)"/);
+        return { installed: true, commandResolvable: quoted ? existsSync(quoted[2]) : false };
+    }
+    catch {
+        return { installed: false, commandResolvable: false };
+    }
+}
+//# sourceMappingURL=kiro.js.map

package/dist/cost/hooks/kiro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kiro.js","sourceRoot":"","sources":["../../../src/cost/hooks/kiro.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,SAAS,YAAY,CAAC,WAAmB;IACvC,OAAO,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,KAAK,CAAC,CAAS;IACtB,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,QAAgB,EAAE,OAAe;IACrF,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IACpD,MAAM,IAAI,GAAG;QACX,OAAO,EAAE,IAAI;QACb,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,MAAM;gBACf,MAAM,EAAE;oBACN,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,GAAG,IAAI,yCAAyC,WAAW,EAAE;iBACvE;aACF;YACD;gBACE,IAAI,EAAE,0BAA0B;gBAChC,OAAO,EAAE,cAAc;gBACvB,MAAM,EAAE;oBACN,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,GAAG,IAAI,uCAAuC,WAAW,EAAE;iBACrE;aACF;SACF;KACF,CAAC;IACF,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACvC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACvC,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,UAAU,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;IAC7E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAEnD,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC;QACjG,MAAM,MAAM,GAAG,GAAG,EAAE,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACnD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;IACxD,CAAC;AACH,CAAC"}

package/dist/cost/ledger.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Cost ledger: append-only NDJSON with closed-schema validation.
+ *
+ * Write semantics mirror transition-log.ts: O_APPEND single-line writes,
+ * whole-line atomicity under concurrent writers. Readers skip torn or
+ * malformed lines with a stderr warning.
+ *
+ * Privacy (SR1/FR2.4): validateEntry enforces a closed key set with
+ * numeric/enum/identifier values only — free-form text cannot enter the
+ * ledger regardless of origin (provider, sync, or --manual).
+ *
+ * Design: design.md §2.1, §4.5
+ */
+import type { CostEntry, CostFidelity } from './types.js';
+/**
+ * Validate a candidate ledger entry against the closed schema.
+ *
+ * @returns null when valid, otherwise a reason string (safe to log).
+ */
+export declare function validateEntry(entry: unknown): string | null;
+/**
+ * Append one validated entry to a ledger file. Throws on invalid entries —
+ * callers decide whether that is a logged rejection (hook path) or an error
+ * surfaced to the user (manual path).
+ */
+export declare function appendEntry(ledgerPath: string, entry: CostEntry): void;
+/**
+ * Read all valid entries from a ledger file. Missing file → empty array.
+ * Malformed or schema-invalid lines are skipped with a stderr warning
+ * (line number only — never line content, per SR1).
+ */
+export declare function readEntries(ledgerPath: string): CostEntry[];
+/** Ledger path for an instance. */
+export declare function ledgerPath(projectRoot: string, instance: string): string;
+/** Path of the unattributed ledger. */
+export declare function unattributedPath(projectRoot: string): string;
+/**
+ * Newest cursor recorded for a session across the given ledger files
+ * (instance ledgers plus unattributed — design §2.4). "Newest" is by entry
+ * timestamp; ties resolved by later coverage.to.
+ */
+export declare function newestCursor(session_id: string, ledgerPaths: string[]): string | null;
+/** A cost entry with its counted weight after precedence reduction. */
+export interface WeightedEntry {
+    entry: CostEntry;
+    /** 0..1 — fraction of this entry's units that count toward totals. */
+    weight: number;
+}
+/**
+ * Apply read-time fidelity precedence: each entry's weight is the fraction
+ * of its coverage window not overlapped by higher-fidelity coverage for the
+ * same session. `session_id: null` entries always count in full. `unknown`
+ * entries carry no units and get weight 0.
+ *
+ * Linear sweep over per-session sorted window lists — O(n log n).
+ */
+export declare function applyPrecedence(entries: CostEntry[]): WeightedEntry[];
+/** Sum weighted units per model (tokens) and total credits. */
+export interface UsageTotals {
+    tokens: Map<string, {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    }>;
+    credits: number;
+    fidelityWeights: Record<CostFidelity, number>;
+}
+export declare function totalUsage(weighted: WeightedEntry[]): UsageTotals;
+//# sourceMappingURL=ledger.d.ts.map

package/dist/cost/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../src/cost/ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAa,MAAM,YAAY,CAAC;AAmDrE;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAmC3D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAUtE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,CA6B3D;AAED,mCAAmC;AACnC,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,uCAAuC;AACvC,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAerF;AAiDD,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,CAAC;IACjB,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,aAAa,EAAE,CA8CrE;AAED,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9F,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;CAC/C;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,WAAW,CAsBjE"}

package/dist/cost/ledger.js

@@ -0,0 +1,314 @@
+/**
+ * Cost ledger: append-only NDJSON with closed-schema validation.
+ *
+ * Write semantics mirror transition-log.ts: O_APPEND single-line writes,
+ * whole-line atomicity under concurrent writers. Readers skip torn or
+ * malformed lines with a stderr warning.
+ *
+ * Privacy (SR1/FR2.4): validateEntry enforces a closed key set with
+ * numeric/enum/identifier values only — free-form text cannot enter the
+ * ledger regardless of origin (provider, sync, or --manual).
+ *
+ * Design: design.md §2.1, §4.5
+ */
+import { readFileSync, openSync, writeSync, closeSync, constants, mkdirSync, } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { SESSION_ID_RE, MODEL_ID_RE } from './types.js';
+const FIDELITIES = ['metered', 'reconciled', 'estimated', 'unknown'];
+const PROVIDER_RE = /^[a-z][a-z0-9-]{0,31}$/;
+const PHASE_RE = /^[a-z][a-z0-9-]{0,31}$/;
+const CURSOR_RE = /^[A-Za-z0-9_.:/@-]{1,256}$/;
+const ENTRY_KEYS = new Set([
+    'timestamp', 'session_id', 'phase', 'provider', 'fidelity', 'coverage', 'cursor', 'units',
+]);
+const TOKEN_KEYS = new Set([
+    'kind', 'model', 'input_tokens', 'output_tokens', 'cache_read_tokens', 'cache_write_tokens',
+]);
+const CREDIT_KEYS = new Set(['kind', 'credits', 'model']);
+function isIso8601(v) {
+    return typeof v === 'string' && !Number.isNaN(Date.parse(v)) && /^\d{4}-\d{2}-\d{2}T/.test(v);
+}
+function isCount(v) {
+    return typeof v === 'number' && Number.isFinite(v) && v >= 0;
+}
+function keysWithin(obj, allowed) {
+    return Object.keys(obj).every((k) => allowed.has(k));
+}
+function validateUnits(units) {
+    if (units === null)
+        return null;
+    if (typeof units !== 'object' || Array.isArray(units))
+        return 'units must be an object or null';
+    const u = units;
+    if (u.kind === 'tokens') {
+        if (!keysWithin(u, TOKEN_KEYS))
+            return 'unknown key in token units';
+        if (typeof u.model !== 'string' || !MODEL_ID_RE.test(u.model))
+            return 'invalid model id';
+        for (const k of ['input_tokens', 'output_tokens', 'cache_read_tokens', 'cache_write_tokens']) {
+            if (!isCount(u[k]))
+                return `invalid ${k}`;
+        }
+        return null;
+    }
+    if (u.kind === 'credits') {
+        if (!keysWithin(u, CREDIT_KEYS))
+            return 'unknown key in credit units';
+        if (!isCount(u.credits))
+            return 'invalid credits';
+        if (u.model !== null && (typeof u.model !== 'string' || !MODEL_ID_RE.test(u.model))) {
+            return 'invalid model id';
+        }
+        return null;
+    }
+    return 'units.kind must be tokens or credits';
+}
+/**
+ * Validate a candidate ledger entry against the closed schema.
+ *
+ * @returns null when valid, otherwise a reason string (safe to log).
+ */
+export function validateEntry(entry) {
+    if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) {
+        return 'entry must be an object';
+    }
+    const e = entry;
+    if (!keysWithin(e, ENTRY_KEYS))
+        return 'unknown key in entry';
+    for (const k of ENTRY_KEYS) {
+        if (!(k in e))
+            return `missing key ${k}`;
+    }
+    if (!isIso8601(e.timestamp))
+        return 'invalid timestamp';
+    if (e.session_id !== null && (typeof e.session_id !== 'string' || !SESSION_ID_RE.test(e.session_id))) {
+        return 'invalid session_id';
+    }
+    if (e.phase !== null && (typeof e.phase !== 'string' || !PHASE_RE.test(e.phase))) {
+        return 'invalid phase';
+    }
+    if (typeof e.provider !== 'string' || !PROVIDER_RE.test(e.provider))
+        return 'invalid provider';
+    if (!FIDELITIES.includes(e.fidelity))
+        return 'invalid fidelity';
+    const cov = e.coverage;
+    if (typeof cov !== 'object' || cov === null || !keysWithin(cov, new Set(['from', 'to']))) {
+        return 'invalid coverage';
+    }
+    if (!isIso8601(cov.from) || !isIso8601(cov.to))
+        return 'invalid coverage timestamps';
+    if (Date.parse(cov.from) > Date.parse(cov.to)) {
+        return 'coverage.from after coverage.to';
+    }
+    if (e.cursor !== null && (typeof e.cursor !== 'string' || !CURSOR_RE.test(e.cursor))) {
+        return 'invalid cursor';
+    }
+    const unitsErr = validateUnits(e.units);
+    if (unitsErr)
+        return unitsErr;
+    if ((e.units === null) !== (e.fidelity === 'unknown')) {
+        return 'units null iff fidelity unknown';
+    }
+    return null;
+}
+/**
+ * Append one validated entry to a ledger file. Throws on invalid entries —
+ * callers decide whether that is a logged rejection (hook path) or an error
+ * surfaced to the user (manual path).
+ */
+export function appendEntry(ledgerPath, entry) {
+    const err = validateEntry(entry);
+    if (err)
+        throw new Error(`invalid cost entry: ${err}`);
+    mkdirSync(dirname(ledgerPath), { recursive: true });
+    const fd = openSync(ledgerPath, constants.O_WRONLY | constants.O_APPEND | constants.O_CREAT);
+    try {
+        writeSync(fd, JSON.stringify(entry) + '\n');
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/**
+ * Read all valid entries from a ledger file. Missing file → empty array.
+ * Malformed or schema-invalid lines are skipped with a stderr warning
+ * (line number only — never line content, per SR1).
+ */
+export function readEntries(ledgerPath) {
+    let raw;
+    try {
+        raw = readFileSync(ledgerPath, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return [];
+        throw err;
+    }
+    const entries = [];
+    const lines = raw.split('\n');
+    let skipped = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (line === '')
+            continue;
+        try {
+            const parsed = JSON.parse(line);
+            if (validateEntry(parsed) === null) {
+                entries.push(parsed);
+            }
+            else {
+                skipped++;
+            }
+        }
+        catch {
+            skipped++;
+        }
+    }
+    if (skipped > 0) {
+        process.stderr.write(`${ledgerPath}: skipped ${skipped} invalid line(s)\n`);
+    }
+    return entries;
+}
+/** Ledger path for an instance. */
+export function ledgerPath(projectRoot, instance) {
+    return join(projectRoot, '.aidlc', 'state', instance, 'costs.ndjson');
+}
+/** Path of the unattributed ledger. */
+export function unattributedPath(projectRoot) {
+    return join(projectRoot, '.aidlc', 'cost', 'unattributed.ndjson');
+}
+/**
+ * Newest cursor recorded for a session across the given ledger files
+ * (instance ledgers plus unattributed — design §2.4). "Newest" is by entry
+ * timestamp; ties resolved by later coverage.to.
+ */
+export function newestCursor(session_id, ledgerPaths) {
+    let best = null;
+    for (const p of ledgerPaths) {
+        for (const e of readEntries(p)) {
+            if (e.session_id !== session_id || e.cursor === null)
+                continue;
+            if (best === null ||
+                Date.parse(e.timestamp) > Date.parse(best.timestamp) ||
+                (e.timestamp === best.timestamp && Date.parse(e.coverage.to) > Date.parse(best.coverage.to))) {
+                best = e;
+            }
+        }
+    }
+    return best?.cursor ?? null;
+}
+// ---------------------------------------------------------------------------
+// Read-time fidelity precedence (design §4.5)
+// ---------------------------------------------------------------------------
+const FIDELITY_RANK = {
+    metered: 3,
+    reconciled: 2,
+    estimated: 1,
+    unknown: 0,
+};
+/** Merge windows into a sorted, non-overlapping list. */
+function mergeWindows(windows) {
+    const sorted = [...windows].sort((a, b) => a.from - b.from);
+    const out = [];
+    for (const w of sorted) {
+        const last = out[out.length - 1];
+        if (last && w.from <= last.to) {
+            last.to = Math.max(last.to, w.to);
+        }
+        else {
+            out.push({ ...w });
+        }
+    }
+    return out;
+}
+/** Fraction of [from, to] NOT overlapped by any window in `covered`. */
+function uncoveredFraction(from, to, covered) {
+    const span = to - from;
+    if (span <= 0) {
+        // Zero-length coverage: counted fully unless a window contains the point.
+        return covered.some((w) => w.from <= from && from <= w.to) ? 0 : 1;
+    }
+    let overlapped = 0;
+    for (const w of covered) {
+        const lo = Math.max(from, w.from);
+        const hi = Math.min(to, w.to);
+        if (hi > lo)
+            overlapped += hi - lo;
+    }
+    return Math.max(0, (span - overlapped) / span);
+}
+/**
+ * Apply read-time fidelity precedence: each entry's weight is the fraction
+ * of its coverage window not overlapped by higher-fidelity coverage for the
+ * same session. `session_id: null` entries always count in full. `unknown`
+ * entries carry no units and get weight 0.
+ *
+ * Linear sweep over per-session sorted window lists — O(n log n).
+ */
+export function applyPrecedence(entries) {
+    const bySession = new Map();
+    const out = [];
+    for (const e of entries) {
+        if (e.units === null) {
+            out.push({ entry: e, weight: 0 });
+            continue;
+        }
+        if (e.session_id === null) {
+            out.push({ entry: e, weight: 1 });
+            continue;
+        }
+        const list = bySession.get(e.session_id) ?? [];
+        list.push(e);
+        bySession.set(e.session_id, list);
+    }
+    for (const list of bySession.values()) {
+        // Pre-merge windows per fidelity rank for this session.
+        const windowsByRank = new Map();
+        for (const e of list) {
+            const rank = FIDELITY_RANK[e.fidelity];
+            const w = windowsByRank.get(rank) ?? [];
+            w.push({ from: Date.parse(e.coverage.from), to: Date.parse(e.coverage.to) });
+            windowsByRank.set(rank, w);
+        }
+        const mergedByRank = new Map();
+        for (const [rank, ws] of windowsByRank)
+            mergedByRank.set(rank, mergeWindows(ws));
+        for (const e of list) {
+            const rank = FIDELITY_RANK[e.fidelity];
+            const higher = [];
+            for (const [r, ws] of mergedByRank) {
+                if (r > rank)
+                    higher.push(...ws);
+            }
+            const weight = uncoveredFraction(Date.parse(e.coverage.from), Date.parse(e.coverage.to), mergeWindows(higher));
+            out.push({ entry: e, weight });
+        }
+    }
+    return out;
+}
+export function totalUsage(weighted) {
+    const totals = {
+        tokens: new Map(),
+        credits: 0,
+        fidelityWeights: { metered: 0, reconciled: 0, estimated: 0, unknown: 0 },
+    };
+    for (const { entry, weight } of weighted) {
+        if (weight === 0 || entry.units === null)
+            continue;
+        totals.fidelityWeights[entry.fidelity] += weight;
+        const u = entry.units;
+        if (u.kind === 'tokens') {
+            const t = totals.tokens.get(u.model) ?? { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
+            t.input += u.input_tokens * weight;
+            t.output += u.output_tokens * weight;
+            t.cacheRead += u.cache_read_tokens * weight;
+            t.cacheWrite += u.cache_write_tokens * weight;
+            totals.tokens.set(u.model, t);
+        }
+        else {
+            totals.credits += u.credits * weight;
+        }
+    }
+    return totals;
+}
+//# sourceMappingURL=ledger.js.map

package/dist/cost/ledger.js.map

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

package/dist/cost/providers/claude-code.d.ts

@@ -0,0 +1,20 @@
+/**
+ * claude-code cost provider: transcript JSONL parsing since a cursor.
+ *
+ * Transcripts live at ~/.claude/projects/<project-slug>/<session-id>.jsonl
+ * (CLAUDE_CONFIG_DIR respected). The entry format is internal to Claude Code
+ * and may change between versions — extraction is fail-soft: anything that
+ * doesn't match the expected shape is skipped and counted, never fatal (D1).
+ *
+ * Cursor: last processed entry uuid. Resume/compaction append to the same
+ * file, so uuid-based resumption is safe; if the cursor uuid is absent
+ * (e.g. /branch copied the file), extraction falls back to the beginning
+ * and the recorder's coverage dedup prevents double counting.
+ *
+ * Design: design.md §3
+ */
+import type { CostProvider, ProviderEnv } from './provider.js';
+/** Root directory that transcripts must live under (FR3.9). */
+export declare function transcriptRoot(env: ProviderEnv): string;
+export declare const claudeCodeProvider: CostProvider;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/cost/providers/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/cost/providers/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE/D,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAIvD;AAMD,eAAO,MAAM,kBAAkB,EAAE,YAmFhC,CAAC"}

package/dist/cost/providers/claude-code.js

@@ -0,0 +1,116 @@
+/**
+ * claude-code cost provider: transcript JSONL parsing since a cursor.
+ *
+ * Transcripts live at ~/.claude/projects/<project-slug>/<session-id>.jsonl
+ * (CLAUDE_CONFIG_DIR respected). The entry format is internal to Claude Code
+ * and may change between versions — extraction is fail-soft: anything that
+ * doesn't match the expected shape is skipped and counted, never fatal (D1).
+ *
+ * Cursor: last processed entry uuid. Resume/compaction append to the same
+ * file, so uuid-based resumption is safe; if the cursor uuid is absent
+ * (e.g. /branch copied the file), extraction falls back to the beginning
+ * and the recorder's coverage dedup prevents double counting.
+ *
+ * Design: design.md §3
+ */
+import { createReadStream, existsSync, realpathSync } from 'node:fs';
+import { createInterface } from 'node:readline';
+import { homedir } from 'node:os';
+import { join, resolve, sep } from 'node:path';
+import { SESSION_ID_RE, MODEL_ID_RE } from '../types.js';
+/** Root directory that transcripts must live under (FR3.9). */
+export function transcriptRoot(env) {
+    const configDir = process.env.CLAUDE_CONFIG_DIR;
+    const base = configDir && configDir.trim() !== '' ? configDir : join(env.home ?? homedir(), '.claude');
+    return join(base, 'projects');
+}
+function isCount(v) {
+    return typeof v === 'number' && Number.isFinite(v) && v >= 0;
+}
+export const claudeCodeProvider = {
+    name: 'claude-code',
+    detect(env) {
+        return existsSync(transcriptRoot(env));
+    },
+    resolveSource(input, env) {
+        if (!SESSION_ID_RE.test(input.session_id))
+            return null;
+        if (!input.transcript_path)
+            return null;
+        let real;
+        try {
+            real = realpathSync(resolve(input.transcript_path));
+        }
+        catch {
+            return null;
+        }
+        let root;
+        try {
+            root = realpathSync(transcriptRoot(env));
+        }
+        catch {
+            return null;
+        }
+        if (real !== root && !real.startsWith(root + sep))
+            return null;
+        if (!real.endsWith('.jsonl'))
+            return null;
+        return { provider: 'claude-code', path: real };
+    },
+    async extract(source, since) {
+        const segments = [];
+        const rl = createInterface({
+            input: createReadStream(source.path, { encoding: 'utf8' }),
+            crlfDelay: Infinity,
+        });
+        // When a cursor is set, skip lines until we pass the entry carrying it.
+        // Cursor uuid absent from the file → seenCursor stays false and we emit
+        // everything; the recorder's coverage dedup handles the overlap.
+        let skipping = since !== null;
+        const all = [];
+        for await (const line of rl) {
+            const t = line.trim();
+            if (t === '')
+                continue;
+            let entry;
+            try {
+                entry = JSON.parse(t);
+            }
+            catch {
+                continue;
+            }
+            const uuid = typeof entry.uuid === 'string' ? entry.uuid : null;
+            const message = entry.message;
+            const usage = message?.usage;
+            const model = typeof message?.model === 'string' ? message.model : null;
+            const at = typeof entry.timestamp === 'string' && !Number.isNaN(Date.parse(entry.timestamp))
+                ? entry.timestamp
+                : null;
+            if (usage && model && MODEL_ID_RE.test(model) && at && uuid) {
+                const units = {
+                    kind: 'tokens',
+                    model,
+                    input_tokens: isCount(usage.input_tokens) ? usage.input_tokens : 0,
+                    output_tokens: isCount(usage.output_tokens) ? usage.output_tokens : 0,
+                    cache_read_tokens: isCount(usage.cache_read_input_tokens) ? usage.cache_read_input_tokens : 0,
+                    cache_write_tokens: isCount(usage.cache_creation_input_tokens) ? usage.cache_creation_input_tokens : 0,
+                };
+                const seg = { at, units, cursor: uuid };
+                if (skipping)
+                    all.push(seg);
+                else
+                    segments.push(seg);
+            }
+            if (skipping && uuid === since) {
+                // Found the cursor: everything collected so far precedes it — drop it.
+                skipping = false;
+                all.length = 0;
+            }
+        }
+        // Cursor never found: fall back to emitting everything (recorder dedups).
+        if (skipping)
+            return all;
+        return segments;
+    },
+};
+//# sourceMappingURL=claude-code.js.map

package/dist/cost/providers/claude-code.js.map

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

package/dist/cost/providers/kiro.d.ts

@@ -0,0 +1,19 @@
+/**
+ * kiro cost provider: per-turn credit usage from local session files.
+ *
+ * Two on-disk shapes (both undocumented — fail-soft everywhere, D2):
+ * - IDE: ~/.kiro/sessions/<workspace-hash>/sess_<uuid>/messages.jsonl with
+ *   usage_summary events: promptTurnSummaries[].usage (credits, fractional).
+ *   session.json alongside carries workspacePaths for project matching.
+ * - CLI: ~/.kiro/sessions/cli/<uuid>.json with
+ *   session_state.conversation_metadata.user_turn_metadatas[].metering_usage.
+ *
+ * Cursor: "<n>" — count of usage events already consumed from the file
+ * (files are append-only per session).
+ *
+ * Design: design.md §3, D2
+ */
+import type { CostProvider, ProviderEnv } from './provider.js';
+export declare function kiroSessionsRoot(env: ProviderEnv): string;
+export declare const kiroProvider: CostProvider;
+//# sourceMappingURL=kiro.d.ts.map

package/dist/cost/providers/kiro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kiro.d.ts","sourceRoot":"","sources":["../../../src/cost/providers/kiro.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE/D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAEzD;AA4ED,eAAO,MAAM,YAAY,EAAE,YAoD1B,CAAC"}