@ai-dossier/cli 0.21.0 → 0.23.0

package/dist/sched-run-stats.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Per-issue token/cost aggregation over `runs.jsonl` (#524).
+ *
+ * `packages/sched` now writes one `runs.jsonl` entry per dispatch (`unit`
+ * set to `issue:<n>`) — this module is the read side: it groups those
+ * entries by issue and sums tokens/cost/duration, the number both the pilot
+ * and parity gate reports needed and had to approximate from agents'
+ * self-reported numbers instead. Pure and dependency-free — no filesystem,
+ * no `gh` — so the arithmetic is unit-testable against fixture entries; the
+ * command layer (`cli/src/commands/sched.ts`) only reads `runs.jsonl` and
+ * renders what this returns.
+ */
+import type { RunLogEntry } from '@ai-dossier/core';
+import { issueOfUnit } from '@ai-dossier/sched';
+/**
+ * `issue:<n>` → `<n>`; null for anything else (a batch unit, or no unit at
+ * all). Re-exported from `@ai-dossier/sched` — that package is both the
+ * writer of the `unit` correlation key and the pre-existing owner of this
+ * exact parse (`packages/sched/src/journal.ts`); a second, independently
+ * maintained regex here was the same class of drift #524 exists to close.
+ */
+export { issueOfUnit };
+/** One issue's aggregated dispatch cost. */
+export interface IssueCost {
+    issue: number;
+    /** Number of runs.jsonl entries (dispatches) attributed to this issue. */
+    runs: number;
+    /** Null when NO entry for this issue reported the field — never a fabricated 0. */
+    input_tokens: number | null;
+    output_tokens: number | null;
+    cache_creation_tokens: number | null;
+    cache_read_tokens: number | null;
+    total_cost_usd: number | null;
+    duration_ms: number | null;
+}
+/** The whole cohort: per-issue rows plus a totals row. */
+export interface SchedCostReport {
+    issues: IssueCost[];
+    totals: Omit<IssueCost, 'issue'>;
+}
+/**
+ * Build the per-issue cost report from already-read `runs.jsonl` entries.
+ *
+ * Only entries with an `issue:<n>` `unit` are considered — ordinary
+ * `ai-dossier run` entries (no `unit`) and batch entries (`batch:<id>`, not
+ * yet dispatched by the engine — see `packages/sched/README.md`'s
+ * dispatch-engine section, "Only `issue:<n>` units are dispatched today") are
+ * excluded. `issues`, when given, restricts the report to that set (and
+ * includes a zero-run row for any issue with no matching entries, so an
+ * operator can tell "no cost recorded" from "not asked about"); duplicates in
+ * it are collapsed, so an issue cannot be counted twice into `totals`.
+ */
+export declare function buildSchedCostReport(entries: RunLogEntry[], issues?: readonly number[]): SchedCostReport;
+//# sourceMappingURL=sched-run-stats.d.ts.map

package/dist/sched-run-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sched-run-stats.d.ts","sourceRoot":"","sources":["../src/sched-run-stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;GAMG;AACH,OAAO,EAAE,WAAW,EAAE,CAAC;AAsBvB,4CAA4C;AAC5C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;CAClC;AAuBD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,WAAW,EAAE,EACtB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GACzB,eAAe,CAejB"}

package/dist/sched-run-stats.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * Per-issue token/cost aggregation over `runs.jsonl` (#524).
+ *
+ * `packages/sched` now writes one `runs.jsonl` entry per dispatch (`unit`
+ * set to `issue:<n>`) — this module is the read side: it groups those
+ * entries by issue and sums tokens/cost/duration, the number both the pilot
+ * and parity gate reports needed and had to approximate from agents'
+ * self-reported numbers instead. Pure and dependency-free — no filesystem,
+ * no `gh` — so the arithmetic is unit-testable against fixture entries; the
+ * command layer (`cli/src/commands/sched.ts`) only reads `runs.jsonl` and
+ * renders what this returns.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.issueOfUnit = void 0;
+exports.buildSchedCostReport = buildSchedCostReport;
+const sched_1 = require("@ai-dossier/sched");
+Object.defineProperty(exports, "issueOfUnit", { enumerable: true, get: function () { return sched_1.issueOfUnit; } });
+/** Sum a nullable numeric field across entries, tracking whether any entry actually reported it. */
+function sumField(entries, field) {
+    let total = 0;
+    let samples = 0;
+    for (const entry of entries) {
+        const value = entry[field];
+        // A non-finite RUNNING TOTAL would render as `-` and blank the whole
+        // column — including the TOTAL row — hiding every legitimate run beside
+        // it. Skip the addition rather than poisoning the cohort (#524 review).
+        if (typeof value === 'number' && Number.isFinite(value) && Number.isFinite(total + value)) {
+            total += value;
+            samples += 1;
+        }
+    }
+    return { total, samples };
+}
+/** The summable `IssueCost` fields, in table-column order. */
+const SUM_FIELDS = [
+    'input_tokens',
+    'output_tokens',
+    'cache_creation_tokens',
+    'cache_read_tokens',
+    'total_cost_usd',
+    'duration_ms',
+];
+/** Sum every `SUM_FIELDS` entry across `entries` — the issue-less half of one row. */
+function aggregate(entries) {
+    const runs = entries.length;
+    const totals = {};
+    for (const field of SUM_FIELDS) {
+        const { total, samples } = sumField(entries, field);
+        totals[field] = samples > 0 ? total : null;
+    }
+    return { runs, ...totals };
+}
+/**
+ * Build the per-issue cost report from already-read `runs.jsonl` entries.
+ *
+ * Only entries with an `issue:<n>` `unit` are considered — ordinary
+ * `ai-dossier run` entries (no `unit`) and batch entries (`batch:<id>`, not
+ * yet dispatched by the engine — see `packages/sched/README.md`'s
+ * dispatch-engine section, "Only `issue:<n>` units are dispatched today") are
+ * excluded. `issues`, when given, restricts the report to that set (and
+ * includes a zero-run row for any issue with no matching entries, so an
+ * operator can tell "no cost recorded" from "not asked about"); duplicates in
+ * it are collapsed, so an issue cannot be counted twice into `totals`.
+ */
+function buildSchedCostReport(entries, issues) {
+    const byIssue = new Map();
+    for (const entry of entries) {
+        const issue = (0, sched_1.issueOfUnit)(entry.unit);
+        if (issue === null)
+            continue;
+        const list = byIssue.get(issue);
+        if (list)
+            list.push(entry);
+        else
+            byIssue.set(issue, [entry]);
+    }
+    const selected = issues ? [...new Set(issues)] : [...byIssue.keys()].sort((a, b) => a - b);
+    const rows = selected.map((issue) => ({ issue, ...aggregate(byIssue.get(issue) ?? []) }));
+    const totals = aggregate(selected.flatMap((issue) => byIssue.get(issue) ?? []));
+    return { issues: rows, totals };
+}
+//# sourceMappingURL=sched-run-stats.js.map

package/dist/sched-run-stats.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-dossier/cli",
-  "version": "0.21.0",
+  "version": "0.23.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": {
@@ -53,8 +53,8 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@ai-dossier/core": "^1.4.1",
-    "@ai-dossier/sched": "^0.8.0",
+    "@ai-dossier/core": "^1.5.0",
+    "@ai-dossier/sched": "^0.11.0",
     "commander": "^12.1.0",
     "yaml": "^2.8.3"
   },