@rasensio/aidlc 1.2.1 → 1.4.0

package/dist/cost/config.js

@@ -0,0 +1,37 @@
+/**
+ * Cost config loader: tolerant reader for the optional `cost:` section of
+ * .aidlc/config.yaml (mirrors the loadOrchestratorConfig pattern).
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+const DEFAULT_CLAIM_TIMEOUT_MINUTES = 60;
+export function loadCostConfig(projectRoot) {
+    const configPath = join(projectRoot, '.aidlc', 'config.yaml');
+    try {
+        if (!existsSync(configPath))
+            return null;
+        const config = parseYaml(readFileSync(configPath, 'utf8'));
+        const cost = config?.cost;
+        if (typeof cost !== 'object' || cost === null)
+            return null;
+        return cost;
+    }
+    catch {
+        return null;
+    }
+}
+export function loadClaimTimeoutMinutes(projectRoot) {
+    const configPath = join(projectRoot, '.aidlc', 'config.yaml');
+    try {
+        if (!existsSync(configPath))
+            return DEFAULT_CLAIM_TIMEOUT_MINUTES;
+        const config = parseYaml(readFileSync(configPath, 'utf8'));
+        const v = config?.claim_timeout_minutes;
+        return typeof v === 'number' && v > 0 ? v : DEFAULT_CLAIM_TIMEOUT_MINUTES;
+    }
+    catch {
+        return DEFAULT_CLAIM_TIMEOUT_MINUTES;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/cost/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cost/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAG1C,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAEzC,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAmC,CAAC;QAC7F,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,CAAC;QAC1B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC3D,OAAO,IAAkB,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,6BAA6B,CAAC;QAClE,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAmC,CAAC;QAC7F,MAAM,CAAC,GAAG,MAAM,EAAE,qBAAqB,CAAC;QACxC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,6BAA6B,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,6BAA6B,CAAC;IACvC,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * claude-code hook installer: SessionEnd (capture) + SessionStart (stash).
+ *
+ * Edits .claude/settings.json parse-preservingly: only the two hook arrays
+ * are touched; every other key is carried through untouched (FR3.4).
+ * Identity rule: our hook commands end with the `#aidlc-cost-hook` marker —
+ * install/remove/status match on the marker alone, so command bodies can
+ * change between versions without orphaning old hooks (design §5).
+ *
+ * Hook merge semantics are additive across settings files by platform
+ * design, so user hooks are safe by construction.
+ */
+export declare const HOOK_MARKER = "#aidlc-cost-hook";
+/** The hook commands, with absolute paths resolved at install time (FR3.10). */
+export declare function hookCommands(nodePath: string, cliPath: string): {
+    sessionEnd: string;
+    sessionStart: string;
+};
+/** Install (idempotently) the cost hooks into project settings. */
+export declare function installClaudeCodeHooks(projectRoot: string, nodePath: string, cliPath: string): void;
+/** Remove our hooks; leaves everything else untouched. */
+export declare function removeClaudeCodeHooks(projectRoot: string): void;
+export interface HookStatus {
+    installed: boolean;
+    /** The recorded CLI path still resolves. */
+    commandResolvable: boolean;
+}
+export declare function claudeCodeHookStatus(projectRoot: string): HookStatus;
+//# sourceMappingURL=claude-code.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/cost/hooks/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,eAAO,MAAM,WAAW,qBAAqB,CAAC;AA2B9C,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAM5G;AAwBD,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAenG;AAED,0DAA0D;AAC1D,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAW/D;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAiBpE"}

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

@@ -0,0 +1,101 @@
+/**
+ * claude-code hook installer: SessionEnd (capture) + SessionStart (stash).
+ *
+ * Edits .claude/settings.json parse-preservingly: only the two hook arrays
+ * are touched; every other key is carried through untouched (FR3.4).
+ * Identity rule: our hook commands end with the `#aidlc-cost-hook` marker —
+ * install/remove/status match on the marker alone, so command bodies can
+ * change between versions without orphaning old hooks (design §5).
+ *
+ * Hook merge semantics are additive across settings files by platform
+ * design, so user hooks are safe by construction.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+export const HOOK_MARKER = '#aidlc-cost-hook';
+function settingsPath(projectRoot) {
+    return join(projectRoot, '.claude', 'settings.json');
+}
+function quote(p) {
+    return `"${p.replace(/"/g, '\\"')}"`;
+}
+/** The hook commands, with absolute paths resolved at install time (FR3.10). */
+export function hookCommands(nodePath, cliPath) {
+    const base = `${quote(nodePath)} ${quote(cliPath)}`;
+    return {
+        sessionEnd: `${base} cost record --provider claude-code --detach ${HOOK_MARKER}`,
+        sessionStart: `${base} cost session-start --provider claude-code ${HOOK_MARKER}`,
+    };
+}
+function loadSettings(projectRoot) {
+    const path = settingsPath(projectRoot);
+    if (!existsSync(path))
+        return {};
+    return JSON.parse(readFileSync(path, 'utf8'));
+}
+function saveSettings(projectRoot, settings) {
+    const path = settingsPath(projectRoot);
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(settings, null, 2) + '\n');
+}
+function hasMarkedHook(groups) {
+    return (groups ?? []).some((g) => g.hooks.some((h) => h.command.endsWith(HOOK_MARKER)));
+}
+function withoutMarkedHooks(groups) {
+    return (groups ?? [])
+        .map((g) => ({ ...g, hooks: g.hooks.filter((h) => !h.command.endsWith(HOOK_MARKER)) }))
+        .filter((g) => g.hooks.length > 0);
+}
+/** Install (idempotently) the cost hooks into project settings. */
+export function installClaudeCodeHooks(projectRoot, nodePath, cliPath) {
+    const settings = loadSettings(projectRoot);
+    const hooks = settings.hooks ?? {};
+    const cmds = hookCommands(nodePath, cliPath);
+    const ensure = (event, command) => {
+        const cleaned = withoutMarkedHooks(hooks[event]);
+        cleaned.push({ hooks: [{ type: 'command', command, timeout: 30 }] });
+        hooks[event] = cleaned;
+    };
+    ensure('SessionEnd', cmds.sessionEnd);
+    ensure('SessionStart', cmds.sessionStart);
+    settings.hooks = hooks;
+    saveSettings(projectRoot, settings);
+}
+/** Remove our hooks; leaves everything else untouched. */
+export function removeClaudeCodeHooks(projectRoot) {
+    if (!existsSync(settingsPath(projectRoot)))
+        return;
+    const settings = loadSettings(projectRoot);
+    if (!settings.hooks)
+        return;
+    for (const event of Object.keys(settings.hooks)) {
+        const cleaned = withoutMarkedHooks(settings.hooks[event]);
+        if (cleaned.length > 0)
+            settings.hooks[event] = cleaned;
+        else
+            delete settings.hooks[event];
+    }
+    if (Object.keys(settings.hooks).length === 0)
+        delete settings.hooks;
+    saveSettings(projectRoot, settings);
+}
+export function claudeCodeHookStatus(projectRoot) {
+    let settings;
+    try {
+        settings = loadSettings(projectRoot);
+    }
+    catch {
+        return { installed: false, commandResolvable: false };
+    }
+    const installed = hasMarkedHook(settings.hooks?.SessionEnd) && hasMarkedHook(settings.hooks?.SessionStart);
+    if (!installed)
+        return { installed: false, commandResolvable: false };
+    // Extract the quoted CLI path (second quoted token) and check it exists.
+    const cmd = (settings.hooks?.SessionEnd ?? [])
+        .flatMap((g) => g.hooks)
+        .find((h) => h.command.endsWith(HOOK_MARKER))?.command;
+    const quoted = cmd?.match(/"([^"]+)"\s+"([^"]+)"/);
+    const resolvable = quoted ? existsSync(quoted[2]) : false;
+    return { installed, commandResolvable: resolvable };
+}
+//# sourceMappingURL=claude-code.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * 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.
+ */
+export declare function installKiroHooks(projectRoot: string, nodePath: string, cliPath: string): void;
+export declare function removeKiroHooks(projectRoot: string): void;
+export declare function kiroHookStatus(projectRoot: string): {
+    installed: boolean;
+    commandResolvable: boolean;
+};
+//# sourceMappingURL=kiro.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kiro.d.ts","sourceRoot":"","sources":["../../../src/cost/hooks/kiro.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA0B7F;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAGzD;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAA;CAAE,CAatG"}

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