@rasensio/aidlc 1.2.0 → 1.3.0

package/dist/cost/recorder.js

@@ -0,0 +1,339 @@
+/**
+ * Cost recorder: orchestrates capture from provider extraction to ledger
+ * appends. Owns all attribution — providers stay platform-pure (DD3).
+ *
+ * Flow (design §4.1): validate input → acquire per-session lock → read
+ * newest cursor (instance ledgers + unattributed) → provider.extract →
+ * split segments by claim intervals × phase transitions → merge per
+ * (instance, phase, model) → validate + append. The ledger append is the
+ * atomic commit point (DD1); re-runs after a crash re-extract from the
+ * last committed cursor.
+ *
+ * Failures append structured lines to .aidlc/cost/capture.log — never raw
+ * transcript or ledger content (SR1).
+ */
+import { readdirSync, existsSync, openSync, writeSync, closeSync, unlinkSync, readFileSync, statSync, renameSync, constants, mkdirSync, } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { appendEntry, ledgerPath, unattributedPath, newestCursor } from './ledger.js';
+import { sessionsPath, readSessionEvents, resolveIntervals, appendSessionEvent } from './sessions.js';
+import { readTransitions } from '../state/transition-log.js';
+import { getProvider } from './providers/provider.js';
+const LOCK_STALE_MS = 10 * 60 * 1000;
+const CAPTURE_LOG_MAX_BYTES = 256 * 1024;
+// ---------------------------------------------------------------------------
+// Capture log (FR3.10 / SR1: structured lines only)
+// ---------------------------------------------------------------------------
+export function captureLogPath(projectRoot) {
+    return join(projectRoot, '.aidlc', 'cost', 'capture.log');
+}
+export function logCapture(projectRoot, stage, errorCode, counts = {}) {
+    const path = captureLogPath(projectRoot);
+    mkdirSync(dirname(path), { recursive: true });
+    const line = JSON.stringify({
+        timestamp: new Date().toISOString(),
+        stage,
+        error_code: errorCode,
+        counts,
+    }) + '\n';
+    try {
+        if (existsSync(path) && statSync(path).size + line.length > CAPTURE_LOG_MAX_BYTES) {
+            // Keep the newest half on rotation.
+            const kept = readFileSync(path, 'utf8').split('\n');
+            const tmp = path + '.tmp';
+            const fd = openSync(tmp, 'w');
+            try {
+                writeSync(fd, kept.slice(Math.floor(kept.length / 2)).join('\n'));
+            }
+            finally {
+                closeSync(fd);
+            }
+            renameSync(tmp, path);
+        }
+        const fd = openSync(path, constants.O_WRONLY | constants.O_APPEND | constants.O_CREAT);
+        try {
+            writeSync(fd, line);
+        }
+        finally {
+            closeSync(fd);
+        }
+    }
+    catch {
+        // Diagnostics must never crash capture.
+    }
+}
+/** Most recent capture-log line, for surfacing in `aidlc cost` (FR3.10). */
+export function lastCaptureError(projectRoot) {
+    const path = captureLogPath(projectRoot);
+    if (!existsSync(path))
+        return null;
+    const lines = readFileSync(path, 'utf8').trim().split('\n');
+    for (let i = lines.length - 1; i >= 0; i--) {
+        try {
+            const parsed = JSON.parse(lines[i]);
+            if (parsed.error_code && parsed.error_code !== 'ok')
+                return parsed;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Lock (design §4.1 step 3)
+// ---------------------------------------------------------------------------
+function lockPath(projectRoot, sessionId) {
+    return join(projectRoot, '.aidlc', 'cost', 'locks', `${sessionId}.lock`);
+}
+/** Try to take the per-session lock. Returns a release fn, or null if held. */
+export function acquireLock(projectRoot, sessionId) {
+    const path = lockPath(projectRoot, sessionId);
+    mkdirSync(dirname(path), { recursive: true });
+    const tryOnce = () => {
+        try {
+            const fd = openSync(path, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL);
+            writeSync(fd, JSON.stringify({ pid: process.pid, at: new Date().toISOString() }));
+            closeSync(fd);
+            return () => {
+                try {
+                    unlinkSync(path);
+                }
+                catch {
+                    // Already gone — fine.
+                }
+            };
+        }
+        catch {
+            return null;
+        }
+    };
+    const release = tryOnce();
+    if (release)
+        return release;
+    // Steal stale locks (>10min old).
+    try {
+        const held = JSON.parse(readFileSync(path, 'utf8'));
+        if (Date.now() - Date.parse(held.at) > LOCK_STALE_MS) {
+            unlinkSync(path);
+            return tryOnce();
+        }
+    }
+    catch {
+        try {
+            unlinkSync(path);
+        }
+        catch {
+            // Lost the race; treat as held.
+        }
+        return tryOnce();
+    }
+    return null;
+}
+/** Build phase windows for an instance from its transitions.log. */
+export function phaseWindows(projectRoot, instance, initialPhase) {
+    const logFile = join(projectRoot, '.aidlc', 'state', instance, 'transitions.log');
+    const transitions = readTransitions(logFile);
+    const windows = [];
+    let phase = initialPhase;
+    let from = 0;
+    for (const t of transitions) {
+        const rec = t;
+        if (!rec.timestamp || !rec.to)
+            continue;
+        const at = Date.parse(rec.timestamp);
+        if (Number.isNaN(at))
+            continue;
+        windows.push({ phase: rec.from ?? phase, from, to: at });
+        phase = rec.to;
+        from = at;
+    }
+    windows.push({ phase, from, to: Infinity });
+    return windows;
+}
+function phaseAt(windows, at) {
+    for (const w of windows) {
+        if (at >= w.from && at < w.to)
+            return w.phase;
+    }
+    return windows[windows.length - 1].phase;
+}
+/** All instances that have session events mentioning this session. */
+export function instancesForSession(projectRoot, sessionId) {
+    const stateDir = join(projectRoot, '.aidlc', 'state');
+    if (!existsSync(stateDir))
+        return [];
+    const out = [];
+    for (const name of readdirSync(stateDir)) {
+        const events = readSessionEvents(sessionsPath(projectRoot, name));
+        if (events.some((e) => e.session_id === sessionId))
+            out.push(name);
+    }
+    return out;
+}
+/**
+ * Run one capture pass for a session. Returns counts, or null when the
+ * lock is held elsewhere (the holder re-checks before releasing, so a
+ * firing lost to the lock is still captured — design §4.2).
+ */
+export async function recordUsage(opts) {
+    const { projectRoot, input } = opts;
+    const env = opts.env ?? { projectRoot };
+    const now = opts.now ?? new Date();
+    const provider = getProvider(opts.provider);
+    if (!provider) {
+        logCapture(projectRoot, 'resolve-provider', 'unknown-provider');
+        return { appended: 0, unattributed: 0, instances: [] };
+    }
+    const source = provider.resolveSource(input, env);
+    if (!source) {
+        logCapture(projectRoot, 'resolve-source', 'invalid-input');
+        return { appended: 0, unattributed: 0, instances: [] };
+    }
+    const release = acquireLock(projectRoot, input.session_id);
+    if (!release)
+        return null;
+    try {
+        let result = await capturePass(opts, source.path, env, now);
+        // Re-check once before releasing: a firing that lost the lock while we
+        // ran may have carried new usage (design §4.2).
+        const second = await capturePass(opts, source.path, env, now);
+        result = {
+            appended: result.appended + second.appended,
+            unattributed: result.unattributed + second.unattributed,
+            instances: [...new Set([...result.instances, ...second.instances])],
+        };
+        return result;
+    }
+    finally {
+        release();
+    }
+}
+async function capturePass(opts, sourcePath, env, now) {
+    const { projectRoot, input } = opts;
+    const provider = getProvider(opts.provider);
+    const instances = instancesForSession(projectRoot, input.session_id);
+    const ledgers = instances.map((i) => ledgerPath(projectRoot, i));
+    ledgers.push(unattributedPath(projectRoot));
+    const cursor = newestCursor(input.session_id, ledgers);
+    let segments;
+    try {
+        segments = await provider.extract({ provider: opts.provider, path: sourcePath }, cursor, env);
+    }
+    catch {
+        logCapture(projectRoot, 'extract', 'extract-failed');
+        return { appended: 0, unattributed: 0, instances: [] };
+    }
+    if (segments.length === 0)
+        return { appended: 0, unattributed: 0, instances: [] };
+    // Resolve claim intervals per instance, and renew open claims (design §2.2).
+    const intervalsByInstance = new Map();
+    for (const instance of instances) {
+        const events = readSessionEvents(sessionsPath(projectRoot, instance));
+        const intervals = resolveIntervals(events, opts.claimTimeoutMinutes, now).filter((iv) => iv.session_id === input.session_id);
+        intervalsByInstance.set(instance, intervals);
+        const hasOpen = intervals.some((iv) => iv.open);
+        if (hasOpen) {
+            let claimEvent;
+            for (const e of events) {
+                if (e.session_id === input.session_id && e.event === 'claim')
+                    claimEvent = e;
+            }
+            if (claimEvent) {
+                appendSessionEvent(sessionsPath(projectRoot, instance), {
+                    event: 'renew',
+                    session_id: input.session_id,
+                    id_source: claimEvent.id_source,
+                    agent: claimEvent.agent,
+                    timestamp: now.toISOString(),
+                });
+            }
+        }
+    }
+    const buckets = new Map();
+    const windowsCache = new Map();
+    for (const seg of segments) {
+        const at = Date.parse(seg.at);
+        let instance = null;
+        for (const [name, intervals] of intervalsByInstance) {
+            if (intervals.some((iv) => at >= Date.parse(iv.from) && at <= Date.parse(iv.to))) {
+                instance = name;
+                break;
+            }
+        }
+        let phase = null;
+        if (instance !== null) {
+            let windows = windowsCache.get(instance);
+            if (!windows) {
+                windows = phaseWindows(projectRoot, instance, 'implementation');
+                windowsCache.set(instance, windows);
+            }
+            phase = phaseAt(windows, at);
+        }
+        const modelKey = seg.units.kind === 'tokens' ? seg.units.model : `credits:${seg.units.model ?? ''}`;
+        const key = `${instance ?? '∅'}|${phase ?? '∅'}|${modelKey}`;
+        const existing = buckets.get(key);
+        if (existing) {
+            mergeUnits(existing.units, seg.units);
+            existing.from = Math.min(existing.from, at);
+            existing.to = Math.max(existing.to, at);
+            existing.cursor = seg.cursor;
+        }
+        else {
+            buckets.set(key, {
+                instance,
+                phase,
+                units: structuredClone(seg.units),
+                from: at,
+                to: at,
+                cursor: seg.cursor,
+            });
+        }
+    }
+    // Append entries; the final segment's cursor rides on every bucket from
+    // the same pass so any single entry can resume the stream.
+    const finalCursor = segments[segments.length - 1].cursor;
+    let appended = 0;
+    let unattributed = 0;
+    const touched = new Set();
+    for (const b of buckets.values()) {
+        const entry = {
+            timestamp: now.toISOString(),
+            session_id: input.session_id,
+            phase: b.phase,
+            provider: opts.provider,
+            fidelity: 'metered',
+            coverage: { from: new Date(b.from).toISOString(), to: new Date(b.to).toISOString() },
+            cursor: finalCursor,
+            units: b.units,
+        };
+        const target = b.instance !== null
+            ? ledgerPath(projectRoot, b.instance)
+            : unattributedPath(projectRoot);
+        try {
+            appendEntry(target, entry);
+            if (b.instance !== null) {
+                appended++;
+                touched.add(b.instance);
+            }
+            else {
+                unattributed++;
+            }
+        }
+        catch {
+            logCapture(projectRoot, 'append', 'validation-rejected');
+        }
+    }
+    return { appended, unattributed, instances: [...touched] };
+}
+function mergeUnits(target, add) {
+    if (target.kind === 'tokens' && add.kind === 'tokens') {
+        target.input_tokens += add.input_tokens;
+        target.output_tokens += add.output_tokens;
+        target.cache_read_tokens += add.cache_read_tokens;
+        target.cache_write_tokens += add.cache_write_tokens;
+    }
+    else if (target.kind === 'credits' && add.kind === 'credits') {
+        target.credits += add.credits;
+    }
+}
+//# sourceMappingURL=recorder.js.map

package/dist/cost/recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../src/cost/recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,WAAW,EACX,UAAU,EACV,QAAQ,EACR,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,SAAS,EACT,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACtG,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAoB,MAAM,yBAAyB,CAAC;AAGxE,MAAM,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACrC,MAAM,qBAAqB,GAAG,GAAG,GAAG,IAAI,CAAC;AAEzC,8EAA8E;AAC9E,oDAAoD;AACpD,8EAA8E;AAE9E,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,OAAO,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,WAAmB,EACnB,KAAa,EACb,SAAiB,EACjB,SAAiC,EAAE;IAEnC,MAAM,IAAI,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IACzC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,KAAK;QACL,UAAU,EAAE,SAAS;QACrB,MAAM;KACP,CAAC,GAAG,IAAI,CAAC;IACV,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,qBAAqB,EAAE,CAAC;YAClF,oCAAoC;YACpC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpD,MAAM,GAAG,GAAG,IAAI,GAAG,MAAM,CAAC;YAC1B,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC9B,IAAI,CAAC;gBACH,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACpE,CAAC;oBAAS,CAAC;gBACT,SAAS,CAAC,EAAE,CAAC,CAAC;YAChB,CAAC;YACD,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACvF,IAAI,CAAC;YACH,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,SAAS,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;IAC1C,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,MAAM,IAAI,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5D,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAA6D,CAAC;YAChG,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;gBAAE,OAAO,MAAM,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,SAAS,QAAQ,CAAC,WAAmB,EAAE,SAAiB;IACtD,OAAO,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,OAAO,CAAC,CAAC;AAC3E,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,SAAiB;IAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC9C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,GAAwB,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YACrF,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;YAClF,SAAS,CAAC,EAAE,CAAC,CAAC;YACd,OAAO,GAAG,EAAE;gBACV,IAAI,CAAC;oBACH,UAAU,CAAC,IAAI,CAAC,CAAC;gBACnB,CAAC;gBAAC,MAAM,CAAC;oBACP,uBAAuB;gBACzB,CAAC;YACH,CAAC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;IAC1B,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,kCAAkC;IAClC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAmB,CAAC;QACtE,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC;YACrD,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,OAAO,OAAO,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAaD,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,WAAmB,EAAE,QAAgB,EAAE,YAAoB;IACtF,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAClF,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,IAAI,KAAK,GAAG,YAAY,CAAC;IACzB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,CAA+D,CAAC;QAC5E,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,SAAS;QACxC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,SAAS;QAC/B,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACzD,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC;QACf,IAAI,GAAG,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,OAAO,CAAC,OAAsB,EAAE,EAAU;IACjD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE;YAAE,OAAO,CAAC,CAAC,KAAK,CAAC;IAChD,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AAC3C,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,SAAiB;IACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,iBAAiB,CAAC,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAiBD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAmB;IACnD,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACpC,MAAM,GAAG,GAAgB,IAAI,CAAC,GAAG,IAAI,EAAE,WAAW,EAAE,CAAC;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IAEnC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,UAAU,CAAC,WAAW,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;QAChE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,UAAU,CAAC,WAAW,EAAE,gBAAgB,EAAE,eAAe,CAAC,CAAC;QAC3D,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,IAAI,CAAC;QACH,IAAI,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC5D,uEAAuE;QACvE,gDAAgD;QAChD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC9D,MAAM,GAAG;YACP,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ;YAC3C,YAAY,EAAE,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY;YACvD,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;SACpE,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,IAAmB,EACnB,UAAkB,EAClB,GAAgB,EAChB,GAAS;IAET,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACpC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAE,CAAC;IAE7C,MAAM,SAAS,GAAG,mBAAmB,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAEvD,IAAI,QAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAChG,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,CAAC,WAAW,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;QACrD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAElF,6EAA6E;IAC7E,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC/D,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,iBAAiB,CAAC,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;QACtE,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,MAAM,CAC9E,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,CAC3C,CAAC;QACF,mBAAmB,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,UAAoC,CAAC;YACzC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,IAAI,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO;oBAAE,UAAU,GAAG,CAAC,CAAC;YAC/E,CAAC;YACD,IAAI,UAAU,EAAE,CAAC;gBACf,kBAAkB,CAAC,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE;oBACtD,KAAK,EAAE,OAAO;oBACd,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,SAAS,EAAE,UAAU,CAAC,SAAS;oBAC/B,KAAK,EAAE,UAAU,CAAC,KAAK;oBACvB,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;iBAC7B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAWD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEtD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,mBAAmB,EAAE,CAAC;YACpD,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACjF,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,KAAK,GAAkB,IAAI,CAAC;QAChC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;gBAChE,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;YACD,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/B,CAAC;QAED,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACpG,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,QAAQ,EAAE,CAAC;YACb,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;YACtC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC5C,QAAQ,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACxC,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;gBACf,QAAQ;gBACR,KAAK;gBACL,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC;gBACjC,IAAI,EAAE,EAAE;gBACR,EAAE,EAAE,EAAE;gBACN,MAAM,EAAE,GAAG,CAAC,MAAM;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,2DAA2D;IAC3D,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IACzD,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACjC,MAAM,KAAK,GAAc;YACvB,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;YAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE;YACpF,MAAM,EAAE,WAAW;YACnB,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC;QACF,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,KAAK,IAAI;YAChC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC;YACrC,CAAC,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAClC,IAAI,CAAC;YACH,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC3B,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACxB,QAAQ,EAAE,CAAC;gBACX,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,YAAY,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED,SAAS,UAAU,CAAC,MAAiB,EAAE,GAAc;IACnD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtD,MAAM,CAAC,YAAY,IAAI,GAAG,CAAC,YAAY,CAAC;QACxC,MAAM,CAAC,aAAa,IAAI,GAAG,CAAC,aAAa,CAAC;QAC1C,MAAM,CAAC,iBAAiB,IAAI,GAAG,CAAC,iBAAiB,CAAC;QAClD,MAAM,CAAC,kBAAkB,IAAI,GAAG,CAAC,kBAAkB,CAAC;IACtD,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/D,MAAM,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/cost/report.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Cost reports: per-instance, all-instances, by-template, unattributed.
+ *
+ * Reads ledgers only — never re-parses platform records (FR7.4). Applies
+ * read-time fidelity precedence, then prices weighted usage against the
+ * effective rate table. Every dollar-bearing report names its snapshot.
+ *
+ * Design: design.md §4.5
+ */
+import type { CostConfig, CostFidelity, CostEntry } from './types.js';
+export interface PhaseCost {
+    phase: string;
+    microUsd: number | null;
+    unpricedModels: string[];
+    tokens: number;
+    credits: number;
+    elapsedSeconds: number;
+}
+export interface InstanceCost {
+    instance: string;
+    template: string | null;
+    microUsd: number | null;
+    unpricedModels: string[];
+    tokens: number;
+    credits: number;
+    elapsedSeconds: number;
+    fidelityMix: Record<CostFidelity, number>;
+    phases: PhaseCost[];
+    snapshot: string;
+}
+/** Compute the full cost view of one instance. */
+export declare function instanceCost(projectRoot: string, instance: string, config: CostConfig | null): InstanceCost;
+/** All instances with state directories. */
+export declare function listInstances(projectRoot: string): string[];
+export interface TemplateRollup {
+    template: string;
+    count: number;
+    avgMicroUsd: number;
+    avgElapsedSeconds: number;
+}
+export declare function byTemplate(projectRoot: string, config: CostConfig | null): TemplateRollup[];
+/** Unattributed ledger entries (FR7.2 --unattributed). */
+export declare function unattributedEntries(projectRoot: string): CostEntry[];
+//# sourceMappingURL=report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/cost/report.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEtE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA6DD,kDAAkD;AAClD,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,GAAG,IAAI,GACxB,YAAY,CA8Dd;AAED,4CAA4C;AAC5C,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAO3D;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,cAAc,EAAE,CAoB3F;AAED,0DAA0D;AAC1D,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,CAEpE"}

package/dist/cost/report.js

@@ -0,0 +1,164 @@
+/**
+ * Cost reports: per-instance, all-instances, by-template, unattributed.
+ *
+ * Reads ledgers only — never re-parses platform records (FR7.4). Applies
+ * read-time fidelity precedence, then prices weighted usage against the
+ * effective rate table. Every dollar-bearing report names its snapshot.
+ *
+ * Design: design.md §4.5
+ */
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadYaml } from '../state/yaml-helpers.js';
+import { readEntries, applyPrecedence, ledgerPath, unattributedPath } from './ledger.js';
+import { priceUnits, effectiveRates } from './rates.js';
+function sumWeighted(weighted, rates) {
+    let micro = 0;
+    let anyPriced = false;
+    const unpriced = new Set();
+    let tokens = 0;
+    let credits = 0;
+    for (const { entry, weight } of weighted) {
+        if (weight === 0 || entry.units === null)
+            continue;
+        const price = priceUnits(entry.units, rates);
+        if (price === null) {
+            unpriced.add(entry.units.kind === 'tokens' ? entry.units.model : 'kiro-credit');
+        }
+        else {
+            micro += price * weight;
+            anyPriced = true;
+        }
+        if (entry.units.kind === 'tokens') {
+            tokens += (entry.units.input_tokens + entry.units.output_tokens) * weight;
+        }
+        else {
+            credits += entry.units.credits * weight;
+        }
+    }
+    return { microUsd: anyPriced || unpriced.size === 0 ? Math.round(micro) : null, unpriced, tokens, credits };
+}
+function phaseElapsed(projectRoot, instance) {
+    const dir = join(projectRoot, '.aidlc', 'state', instance);
+    const out = new Map();
+    if (!existsSync(dir))
+        return out;
+    for (const f of readdirSync(dir)) {
+        if (!f.startsWith('phase-') || !f.endsWith('.yaml'))
+            continue;
+        try {
+            const state = loadYaml(join(dir, f));
+            out.set(state.phase, state.metrics?.elapsed_seconds ?? 0);
+        }
+        catch {
+            continue;
+        }
+    }
+    return out;
+}
+function instanceTemplate(projectRoot, instance) {
+    try {
+        const meta = loadYaml(join(projectRoot, '.aidlc', 'state', instance, 'instance.yaml'));
+        return meta.template ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Compute the full cost view of one instance. */
+export function instanceCost(projectRoot, instance, config) {
+    const rates = effectiveRates(projectRoot, config);
+    const entries = readEntries(ledgerPath(projectRoot, instance));
+    const weighted = applyPrecedence(entries);
+    const elapsed = phaseElapsed(projectRoot, instance);
+    const byPhase = new Map();
+    for (const w of weighted) {
+        const phase = w.entry.phase ?? 'unknown';
+        const list = byPhase.get(phase) ?? [];
+        list.push(w);
+        byPhase.set(phase, list);
+    }
+    const phases = [];
+    for (const [phase, list] of byPhase) {
+        const s = sumWeighted(list, rates);
+        phases.push({
+            phase,
+            microUsd: s.microUsd,
+            unpricedModels: [...s.unpriced],
+            tokens: Math.round(s.tokens),
+            credits: s.credits,
+            elapsedSeconds: elapsed.get(phase) ?? 0,
+        });
+    }
+    // Phases with time but no cost still appear.
+    for (const [phase, secs] of elapsed) {
+        if (secs > 0 && !byPhase.has(phase)) {
+            phases.push({ phase, microUsd: 0, unpricedModels: [], tokens: 0, credits: 0, elapsedSeconds: secs });
+        }
+    }
+    const total = sumWeighted(weighted, rates);
+    const fidelityMix = { metered: 0, reconciled: 0, estimated: 0, unknown: 0 };
+    let mixTotal = 0;
+    for (const { entry, weight } of weighted) {
+        if (entry.units === null)
+            continue;
+        fidelityMix[entry.fidelity] += weight;
+        mixTotal += weight;
+    }
+    if (mixTotal > 0) {
+        for (const k of Object.keys(fidelityMix)) {
+            fidelityMix[k] = fidelityMix[k] / mixTotal;
+        }
+    }
+    let totalElapsed = 0;
+    for (const secs of elapsed.values())
+        totalElapsed += secs;
+    return {
+        instance,
+        template: instanceTemplate(projectRoot, instance),
+        microUsd: total.microUsd,
+        unpricedModels: [...total.unpriced],
+        tokens: Math.round(total.tokens),
+        credits: total.credits,
+        elapsedSeconds: totalElapsed,
+        fidelityMix,
+        phases,
+        snapshot: rates.snapshot,
+    };
+}
+/** All instances with state directories. */
+export function listInstances(projectRoot) {
+    const dir = join(projectRoot, '.aidlc', 'state');
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .map((d) => d.name)
+        .sort();
+}
+export function byTemplate(projectRoot, config) {
+    const groups = new Map();
+    for (const name of listInstances(projectRoot)) {
+        const cost = instanceCost(projectRoot, name, config);
+        const template = cost.template ?? '(unknown)';
+        const g = groups.get(template) ?? { micro: [], secs: [] };
+        g.micro.push(cost.microUsd ?? 0);
+        g.secs.push(cost.elapsedSeconds);
+        groups.set(template, g);
+    }
+    const out = [];
+    for (const [template, g] of groups) {
+        out.push({
+            template,
+            count: g.micro.length,
+            avgMicroUsd: Math.round(g.micro.reduce((a, b) => a + b, 0) / g.micro.length),
+            avgElapsedSeconds: Math.round(g.secs.reduce((a, b) => a + b, 0) / g.secs.length),
+        });
+    }
+    return out.sort((a, b) => a.template.localeCompare(b.template));
+}
+/** Unattributed ledger entries (FR7.2 --unattributed). */
+export function unattributedEntries(projectRoot) {
+    return readEntries(unattributedPath(projectRoot));
+}
+//# sourceMappingURL=report.js.map

package/dist/cost/report.js.map

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

package/dist/cost/sessions.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Session ledger: durable session↔instance mapping (FR1).
+ *
+ * sessions.ndjson is append-only; the instance.yaml claim field remains
+ * concurrency control only. Attribution intervals are derived here.
+ *
+ * The active-session stash (design §2.3) joins platform session ids to
+ * claims: SessionStart hooks write stash entries; `aidlc claim` resolves
+ * the current session with a strict single-candidate rule.
+ *
+ * Design: design.md §2.2, §2.3, §4.3
+ */
+import type { SessionEvent, ClaimInterval, ActiveSession } from './types.js';
+export declare function sessionsPath(projectRoot: string, instance: string): string;
+export declare function stashDir(projectRoot: string): string;
+/** Append a session event (O_APPEND whole-line write). */
+export declare function appendSessionEvent(path: string, event: SessionEvent): void;
+/** Read valid session events; missing file → empty; bad lines skipped. */
+export declare function readSessionEvents(path: string): SessionEvent[];
+/**
+ * Resolve attribution intervals from session events (FR1.3).
+ *
+ * claim → release pairs per session; an unreleased claim is bounded by
+ * min(now, lastEventForSession + claimTimeoutMinutes) and marked open.
+ * Renew events extend the liveness bound of an open claim.
+ */
+export declare function resolveIntervals(events: SessionEvent[], claimTimeoutMinutes: number, now?: Date): ClaimInterval[];
+/** Write a stash entry for a just-started platform session. */
+export declare function stashSession(projectRoot: string, session: ActiveSession): void;
+/** Remove stash entries older than the TTL. Called opportunistically. */
+export declare function pruneStash(projectRoot: string, now?: Date): void;
+/** Resolve a directory to its repo identity (git common dir), or null. */
+export declare function repoIdentity(cwd: string): string | null;
+/**
+ * Find the current platform session with the strict single-candidate rule:
+ * exactly one live stash entry whose repo identity matches → that session;
+ * zero or multiple → null (caller degrades to id_source: agent).
+ */
+export declare function resolveCurrentSession(projectRoot: string, now?: Date): ActiveSession | null;
+//# sourceMappingURL=sessions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/cost/sessions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgBH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAM7E,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpD;AAgBD,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAS1E;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAuB9D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EAAE,EACtB,mBAAmB,EAAE,MAAM,EAC3B,GAAG,GAAE,IAAiB,GACrB,aAAa,EAAE,CA6BjB;AAiBD,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAK9E;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,CAc5E;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWvD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,IAAiB,GACrB,aAAa,GAAG,IAAI,CAqBtB"}