@ai-dossier/cli 0.49.2 → 0.53.0

package/dist/usage/ledger.js

@@ -0,0 +1,268 @@
+"use strict";
+/**
+ * Ledger assembly + aggregation for `ai-dossier usage` (#769).
+ *
+ * `collectLedger` runs every collector for a time range and joins the
+ * attribution sources; the pure functions below turn rows into the views'
+ * numbers (so they are unit-testable without any store on disk).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIMIT_REPEAT_GAP_MS = void 0;
+exports.defaultLedgerPaths = defaultLedgerPaths;
+exports.collectLedger = collectLedger;
+exports.rowTotal = rowTotal;
+exports.totalsOf = totalsOf;
+exports.groupRows = groupRows;
+exports.modelCoverage = modelCoverage;
+exports.summarizeSessions = summarizeSessions;
+exports.hourlyBurn = hourlyBurn;
+exports.collapseLimitEvents = collapseLimitEvents;
+exports.limitContexts = limitContexts;
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const core_1 = require("@ai-dossier/core");
+const collect_claude_1 = require("./collect-claude");
+const collect_dispatch_1 = require("./collect-dispatch");
+const collect_opencode_1 = require("./collect-opencode");
+function defaultLedgerPaths(env = process.env) {
+    return {
+        claudeProjectsDir: (0, collect_claude_1.defaultClaudeProjectsDir)(env),
+        opencodeDb: (0, collect_opencode_1.defaultOpenCodeDbPath)(env),
+        schedRoot: path.join(os.homedir(), '.dossier', 'sched'),
+        runsLog: (0, core_1.runsLogPath)(),
+    };
+}
+/** Run every collector for `[sinceMs, untilMs)` and join attribution. Read-only; never throws for a missing store. */
+function collectLedger(opts) {
+    const host = opts.host ?? os.hostname();
+    const collectors = [];
+    const rows = [];
+    const limits = [];
+    const claude = (0, collect_claude_1.collectClaude)({
+        projectsDir: opts.paths.claudeProjectsDir,
+        sinceMs: opts.sinceMs,
+        untilMs: opts.untilMs,
+        host,
+    });
+    rows.push(...claude.rows);
+    limits.push(...claude.limits);
+    collectors.push({
+        source: 'claude-code',
+        status: 'ok',
+        rows: claude.rows.length,
+        detail: `${claude.files} transcript(s) under ${opts.paths.claudeProjectsDir}`,
+    });
+    const opened = (opts.openOpenCode ?? collect_opencode_1.openOpenCodeDb)(opts.paths.opencodeDb);
+    if (opened.status === 'ok') {
+        try {
+            const oc = (0, collect_opencode_1.collectOpenCode)({
+                reader: opened.reader,
+                sinceMs: opts.sinceMs,
+                untilMs: opts.untilMs,
+                host,
+            });
+            rows.push(...oc);
+            collectors.push({ source: 'opencode', status: 'ok', rows: oc.length });
+        }
+        catch (err) {
+            collectors.push({
+                source: 'opencode',
+                status: 'error',
+                rows: 0,
+                detail: err.message,
+            });
+        }
+        finally {
+            opened.reader.close();
+        }
+    }
+    else {
+        collectors.push({ source: 'opencode', status: opened.status, rows: 0, detail: opened.detail });
+    }
+    const index = (0, collect_dispatch_1.indexDispatchLogs)(opts.paths.schedRoot, opts.sinceMs);
+    (0, collect_dispatch_1.applyDispatchIndex)(rows, index);
+    collectors.push({ source: 'sched-dispatch-logs', status: 'ok', rows: index.size });
+    limits.push(...(0, collect_dispatch_1.collectSchedLimitEvents)(opts.paths.schedRoot, opts.sinceMs, opts.untilMs, host));
+    limits.sort((a, b) => a.ts.localeCompare(b.ts));
+    const dossierRuns = (0, collect_dispatch_1.countDossierRuns)(opts.paths.runsLog, opts.sinceMs, opts.untilMs);
+    collectors.push({ source: 'dossier-runs', status: 'ok', rows: dossierRuns.size });
+    rows.sort((a, b) => a.ts.localeCompare(b.ts));
+    return { rows, limits, collectors, dossierRuns };
+}
+function rowTotal(row) {
+    return row.input + row.output + row.reasoning + row.cache_read + row.cache_write;
+}
+function totalsOf(rows) {
+    const t = {
+        input: 0,
+        output: 0,
+        reasoning: 0,
+        cache_read: 0,
+        cache_write: 0,
+        total: 0,
+        cost_usd: null,
+        messages: rows.length,
+    };
+    for (const row of rows) {
+        t.input += row.input;
+        t.output += row.output;
+        t.reasoning += row.reasoning;
+        t.cache_read += row.cache_read;
+        t.cache_write += row.cache_write;
+        t.total += rowTotal(row);
+        if (row.cost_usd !== null)
+            t.cost_usd = (t.cost_usd ?? 0) + row.cost_usd;
+    }
+    return t;
+}
+/** Group rows by `keyOf`, largest total first. */
+function groupRows(rows, keyOf) {
+    const groups = new Map();
+    for (const row of rows) {
+        const key = keyOf(row);
+        const list = groups.get(key);
+        if (list)
+            list.push(row);
+        else
+            groups.set(key, [row]);
+    }
+    return [...groups.entries()]
+        .map(([key, list]) => ({ key, ...totalsOf(list) }))
+        .sort((a, b) => b.total - a.total || a.key.localeCompare(b.key));
+}
+/** Share of tokens (0..1) attributed to a concrete model id; 1 for an empty set. */
+function modelCoverage(rows) {
+    let all = 0;
+    let known = 0;
+    for (const row of rows) {
+        const n = rowTotal(row);
+        all += n;
+        if (row.model)
+            known += n;
+    }
+    return all === 0 ? 1 : known / all;
+}
+/** Per-session totals, largest first. */
+function summarizeSessions(rows) {
+    const bySession = new Map();
+    for (const row of rows) {
+        const list = bySession.get(row.session_id);
+        if (list)
+            list.push(row);
+        else
+            bySession.set(row.session_id, [row]);
+    }
+    const out = [];
+    for (const [session_id, list] of bySession) {
+        const first = list[0];
+        const models = [...new Set(list.map((r) => r.model).filter((m) => !!m))].sort();
+        const withIssue = list.find((r) => r.issue !== null);
+        out.push({
+            session_id,
+            parent_session_id: first.parent_session_id,
+            source: first.source,
+            models,
+            project: first.project,
+            issue: withIssue?.issue ?? null,
+            batch: list.find((r) => r.batch)?.batch ?? null,
+            unit: list.find((r) => r.unit)?.unit ?? null,
+            title: first.title,
+            first_ts: list.reduce((m, r) => (r.ts < m ? r.ts : m), first.ts),
+            last_ts: list.reduce((m, r) => (r.ts > m ? r.ts : m), first.ts),
+            ...totalsOf(list),
+        });
+    }
+    return out.sort((a, b) => b.total - a.total || a.session_id.localeCompare(b.session_id));
+}
+/** Tokens per clock hour across `[sinceMs, untilMs)`, oldest first — the burn-rate series. */
+function hourlyBurn(rows, sinceMs, untilMs) {
+    const HOUR = 3_600_000;
+    const start = Math.floor(sinceMs / HOUR) * HOUR;
+    const buckets = new Map();
+    for (let h = start; h < untilMs; h += HOUR)
+        buckets.set(h, { total: 0, messages: 0 });
+    for (const row of rows) {
+        const h = Math.floor(Date.parse(row.ts) / HOUR) * HOUR;
+        const bucket = buckets.get(h);
+        if (!bucket)
+            continue;
+        bucket.total += rowTotal(row);
+        bucket.messages += 1;
+    }
+    return [...buckets.entries()].map(([h, b]) => ({ hour: new Date(h).toISOString(), ...b }));
+}
+/** Repeats closer than this fold into one limit event (agents/cron retry a wall every few minutes). */
+exports.LIMIT_REPEAT_GAP_MS = 60 * 60 * 1000;
+/**
+ * Fold repeats of the same wall (same source, unit and message) into their
+ * first occurrence — `count`/`last_ts` record what was folded. A wall hit by a
+ * cron every 15 minutes is one event, not twenty; its onset is what needs
+ * explaining. Input must be sorted by `ts`.
+ */
+function collapseLimitEvents(events, gapMs = exports.LIMIT_REPEAT_GAP_MS) {
+    const open = new Map();
+    const out = [];
+    for (const event of events) {
+        const key = `${event.source}\u0000${event.unit ?? ''}\u0000${event.detail}`;
+        const current = open.get(key);
+        const lastMs = current ? Date.parse(current.last_ts ?? current.ts) : Number.NaN;
+        if (current && Date.parse(event.ts) - lastMs <= gapMs) {
+            current.count = (current.count ?? 1) + 1;
+            current.last_ts = event.ts;
+            continue;
+        }
+        const fresh = { ...event, count: 1, last_ts: event.ts };
+        open.set(key, fresh);
+        out.push(fresh);
+    }
+    return out;
+}
+/** For each limit event, the top `n` sessions by tokens in the `windowMs` before it. */
+function limitContexts(limits, rows, windowMs, n = 3) {
+    return limits.map((event) => {
+        const end = Date.parse(event.ts);
+        const start = end - windowMs;
+        const inWindow = rows.filter((r) => {
+            const t = Date.parse(r.ts);
+            if (t < start || t > end)
+                return false;
+            // Claude limit events can only be explained by Anthropic spend.
+            return event.provider === null || r.provider === event.provider;
+        });
+        return { event, top: summarizeSessions(inWindow).slice(0, n), window_ms: windowMs };
+    });
+}
+//# sourceMappingURL=ledger.js.map

package/dist/usage/ledger.js.map

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

package/dist/usage/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Row shapes for the cross-provider token ledger (`ai-dossier usage`, #769).
+ *
+ * Every collector normalizes its source store into {@link UsageRow} — one row
+ * per assistant message (the finest grain every store shares), so a view can
+ * group by model × source × project × issue × session without caring which
+ * tool produced the tokens.
+ */
+/** Which store a row was read from. */
+export type UsageSource = 'claude-code' | 'opencode';
+/** How a row's `issue` was attributed — a sched dispatch log is authoritative; a branch/dir name is a heuristic. */
+export type IssueSource = 'dispatch' | 'branch';
+export interface UsageRow {
+    /** ISO-8601 time the message completed (or was created, when no completion time is recorded). */
+    ts: string;
+    /** Host that produced the row (`os.hostname()` of the collecting machine). */
+    host: string;
+    /** Provider that served the tokens — `anthropic` for Claude Code, opencode's own `providerID` otherwise. */
+    provider: string;
+    /** Concrete model id as the provider reported it, or null when the store recorded none. */
+    model: string | null;
+    input: number;
+    output: number;
+    /** Reasoning tokens reported separately (opencode); Claude folds thinking into `output`. */
+    reasoning: number;
+    cache_read: number;
+    cache_write: number;
+    /** Cost the source recorded, or null when it records none (Claude Code transcripts carry no cost). */
+    cost_usd: number | null;
+    source: UsageSource;
+    /** Session the message belongs to — a Claude Code subagent is `<parent>/<agentId>`. */
+    session_id: string;
+    /** Parent session for subagents (Claude Code sidechains, opencode child sessions); null for a top-level session. */
+    parent_session_id: string | null;
+    /** Human label for the session when the store has one (opencode title, Claude subagent description). */
+    title: string | null;
+    cwd: string | null;
+    project: string | null;
+    branch: string | null;
+    issue: number | null;
+    issue_source: IssueSource | null;
+    batch: string | null;
+    /** Scheduler unit (`issue:<n>`, `batch:<id>`) when the session was sched-dispatched. */
+    unit: string | null;
+}
+/** A provider limit / rate-limit wall observed in a source store. */
+export interface LimitEvent {
+    ts: string;
+    host: string;
+    /** Where the event was recorded. */
+    source: 'claude-code' | 'sched';
+    /** Provider hint — `anthropic` for Claude Code rows; sched events name none (null). */
+    provider: string | null;
+    session_id: string | null;
+    unit: string | null;
+    /** HTTP status when the store recorded one (e.g. 429). */
+    status: number | null;
+    /** The provider's own message, truncated. */
+    detail: string;
+    /** How many identical events this one stands for after {@link collapseLimitEvents}-style grouping (1 = itself). */
+    count?: number;
+    /** Timestamp of the last event folded into this one. */
+    last_ts?: string;
+}
+/** Whether a collector ran, so a view can say "opencode: unavailable" instead of silently reporting zero. */
+export interface CollectorStatus {
+    source: string;
+    status: 'ok' | 'unavailable' | 'error';
+    rows: number;
+    detail?: string;
+}
+/** Everything one collection pass produced. */
+export interface Ledger {
+    rows: UsageRow[];
+    limits: LimitEvent[];
+    collectors: CollectorStatus[];
+    /** `session_id` → number of `ai-dossier run` invocations recorded from that session (runs.jsonl). */
+    dossierRuns: Map<string, number>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/usage/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,UAAU,CAAC;AAErD,oHAAoH;AACpH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEhD,MAAM,WAAW,QAAQ;IACvB,iGAAiG;IACjG,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,4GAA4G;IAC5G,QAAQ,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,sGAAsG;IACtG,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,uFAAuF;IACvF,UAAU,EAAE,MAAM,CAAC;IACnB,oHAAoH;IACpH,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,wGAAwG;IACxG,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wFAAwF;IACxF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC;IAChC,uFAAuF;IACvF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,mHAAmH;IACnH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,6GAA6G;AAC7G,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,GAAG,aAAa,GAAG,OAAO,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+CAA+C;AAC/C,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,qGAAqG;IACrG,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC"}

package/dist/usage/types.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Row shapes for the cross-provider token ledger (`ai-dossier usage`, #769).
+ *
+ * Every collector normalizes its source store into {@link UsageRow} — one row
+ * per assistant message (the finest grain every store shares), so a view can
+ * group by model × source × project × issue × session without caring which
+ * tool produced the tokens.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/usage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/usage/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/dist/usage/util.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Small shared helpers for the usage collectors (#769).
+ */
+import * as fs from 'node:fs';
+/**
+ * Call `onLine` for every line of `file`, reading it in fixed-size chunks so a
+ * multi-hundred-MB transcript never has to fit in memory as one string.
+ * Never throws: an unreadable file yields no lines and returns false.
+ */
+export declare function forEachLine(file: string, onLine: (line: string) => void): boolean;
+/** Directory entries of `dir`, or `[]` when it does not exist / cannot be read. */
+export declare function safeReaddir(dir: string): fs.Dirent[];
+/** File mtime in ms, or null when the file cannot be stat'ed. */
+export declare function mtimeMs(file: string): number | null;
+/**
+ * A short project name for a working directory: the directory that holds a
+ * `worktrees/` checkout (`…/ai-dossier/worktrees/feat-x` → `ai-dossier`), the
+ * parent of a `main/` worktree (`…/ai-dossier/main` → `ai-dossier`), else the
+ * directory's own basename.
+ */
+export declare function projectOf(cwd: string | null | undefined): string | null;
+/**
+ * The issue number a branch or worktree name refers to — `feat/769-usage`,
+ * `fix-4360-x`, `issue-12` — or null. Heuristic by nature (callers label it
+ * `issue_source: 'branch'`): it takes the first 2–6 digit number without a
+ * leading zero that stands alone between separators, which skips date-like
+ * batch ids (`b-20260920-01`) and pool worktree timestamps.
+ */
+export declare function issueFromRef(ref: string | null | undefined): number | null;
+/** Non-negative finite number, else 0 — source stores are untrusted JSON. */
+export declare function count(value: unknown): number;
+/** Trim a free-text field from an untrusted store to one short line. */
+export declare function oneLine(text: unknown, max?: number): string;
+/** Matches provider limit / rate-limit wording in error text. */
+export declare const LIMIT_TEXT_RE: RegExp;
+//# sourceMappingURL=util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/usage/util.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAM9B;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAmCjF;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,MAAM,EAAE,CAMpD;AAED,iEAAiE;AACjE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMnD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAQvE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAI1E;AAED,6EAA6E;AAC7E,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE5C;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,SAAM,GAAG,MAAM,CAIxD;AAED,iEAAiE;AACjE,eAAO,MAAM,aAAa,QACqH,CAAC"}

package/dist/usage/util.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * Small shared helpers for the usage collectors (#769).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIMIT_TEXT_RE = void 0;
+exports.forEachLine = forEachLine;
+exports.safeReaddir = safeReaddir;
+exports.mtimeMs = mtimeMs;
+exports.projectOf = projectOf;
+exports.issueFromRef = issueFromRef;
+exports.count = count;
+exports.oneLine = oneLine;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/** Bytes read per chunk by {@link forEachLine} — bounded memory regardless of file size. */
+const LINE_CHUNK_BYTES = 1024 * 1024;
+/**
+ * Call `onLine` for every line of `file`, reading it in fixed-size chunks so a
+ * multi-hundred-MB transcript never has to fit in memory as one string.
+ * Never throws: an unreadable file yields no lines and returns false.
+ */
+function forEachLine(file, onLine) {
+    let fd = null;
+    try {
+        fd = fs.openSync(file, 'r');
+        const buffer = Buffer.allocUnsafe(LINE_CHUNK_BYTES);
+        let carry = Buffer.alloc(0);
+        let read = 0;
+        do {
+            read = fs.readSync(fd, buffer, 0, LINE_CHUNK_BYTES, null);
+            let chunk = read > 0 ? Buffer.concat([carry, buffer.subarray(0, read)]) : carry;
+            let start = 0;
+            for (let nl = chunk.indexOf(10, start); nl !== -1; nl = chunk.indexOf(10, start)) {
+                const line = chunk.subarray(start, nl).toString('utf-8');
+                if (line)
+                    onLine(line);
+                start = nl + 1;
+            }
+            chunk = chunk.subarray(start);
+            if (read === 0) {
+                if (chunk.length > 0)
+                    onLine(chunk.toString('utf-8'));
+                break;
+            }
+            carry = Buffer.from(chunk);
+        } while (read > 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        if (fd !== null) {
+            try {
+                fs.closeSync(fd);
+            }
+            catch {
+                // already closed
+            }
+        }
+    }
+}
+/** Directory entries of `dir`, or `[]` when it does not exist / cannot be read. */
+function safeReaddir(dir) {
+    try {
+        return fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+}
+/** File mtime in ms, or null when the file cannot be stat'ed. */
+function mtimeMs(file) {
+    try {
+        return fs.statSync(file).mtimeMs;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * A short project name for a working directory: the directory that holds a
+ * `worktrees/` checkout (`…/ai-dossier/worktrees/feat-x` → `ai-dossier`), the
+ * parent of a `main/` worktree (`…/ai-dossier/main` → `ai-dossier`), else the
+ * directory's own basename.
+ */
+function projectOf(cwd) {
+    if (!cwd)
+        return null;
+    const parts = path.resolve(cwd).split(path.sep).filter(Boolean);
+    const wt = parts.lastIndexOf('worktrees');
+    if (wt > 0)
+        return parts[wt - 1];
+    const last = parts[parts.length - 1];
+    if (last === 'main' && parts.length > 1)
+        return parts[parts.length - 2];
+    return last ?? null;
+}
+/**
+ * The issue number a branch or worktree name refers to — `feat/769-usage`,
+ * `fix-4360-x`, `issue-12` — or null. Heuristic by nature (callers label it
+ * `issue_source: 'branch'`): it takes the first 2–6 digit number without a
+ * leading zero that stands alone between separators, which skips date-like
+ * batch ids (`b-20260920-01`) and pool worktree timestamps.
+ */
+function issueFromRef(ref) {
+    if (!ref)
+        return null;
+    const match = ref.match(/(?:^|[/_-])(?:issue-?|gh-?)?([1-9]\d{1,5})(?=$|[/_-])/i);
+    return match ? Number.parseInt(match[1], 10) : null;
+}
+/** Non-negative finite number, else 0 — source stores are untrusted JSON. */
+function count(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : 0;
+}
+/** Trim a free-text field from an untrusted store to one short line. */
+function oneLine(text, max = 200) {
+    const s = typeof text === 'string' ? text : '';
+    const flat = s.replace(/\s+/g, ' ').trim();
+    return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
+}
+/** Matches provider limit / rate-limit wording in error text. */
+exports.LIMIT_TEXT_RE = /usage limit|rate[ -]?limit|spend limit|hit your (?:\w+ )?limit|limit reached|limit will reset|limit resets|quota|too many requests|\b429\b/i;
+//# sourceMappingURL=util.js.map

package/dist/usage/util.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-dossier/cli",
-  "version": "0.49.2",
+  "version": "0.53.0",
   "description": "Create, verify, sign, publish, and run dossiers — portable, signed, versioned skills for any LLM tool. The dossier ⇄ Claude Code skill bridge (install-skill / skill-export).",
   "main": "dist/cli.js",
   "bin": {
@@ -54,7 +54,7 @@
   },
   "dependencies": {
     "@ai-dossier/core": "^1.9.0",
-    "@ai-dossier/sched": "^0.42.0",
+    "@ai-dossier/sched": "^0.45.0",
     "@ai-dossier/worktree-pool": "^0.7.0",
     "commander": "^12.1.0",
     "yaml": "^2.8.3"