akm-cli 0.9.0-rc.0 → 0.9.0-rc.13

package/dist/commands/health/task-runs.js

@@ -2,57 +2,8 @@
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
 import { queryImproveRuns } from "../../storage/repositories/improve-runs-repository.js";
-import { queryCompletedTaskIntervals, queryTaskHistory } from "../../storage/repositories/task-history-repository.js";
+import { queryTaskHistory } from "../../storage/repositories/task-history-repository.js";
 import { projectImproveRunSummary } from "./improve-metrics.js";
-/**
- * Load task_history intervals for `task_id='akm-improve'` in the window.
- * Returned sorted by startMs ascending so containment lookups can use a
- * linear scan (typical N is ~24/day; not worth a tree).
- *
- * The window filter is widened by 5 minutes on each side because the cron
- * task wraps `akm improve` — the task `started_at` fires at e.g. :07:01
- * while `recordImproveRun` writes the matching `improve_runs.started_at`
- * later (after config load, planning, etc.), so the improve_runs row can
- * be inside the window even when its enclosing task_history row started
- * just before the window opened.
- */
-function loadTaskIntervals(db, since, until) {
-    const sinceMs = new Date(since).getTime();
-    const untilMs = until ? new Date(until).getTime() : Number.POSITIVE_INFINITY;
-    const widenedSince = new Date(sinceMs - 5 * 60 * 1000).toISOString();
-    const widenedUntil = Number.isFinite(untilMs) ? new Date(untilMs + 5 * 60 * 1000).toISOString() : undefined;
-    const rows = queryCompletedTaskIntervals(db, widenedSince, widenedUntil);
-    const intervals = [];
-    for (const row of rows) {
-        const startMs = new Date(row.started_at).getTime();
-        const endMs = new Date(row.completed_at).getTime();
-        if (!Number.isFinite(startMs) || !Number.isFinite(endMs) || endMs < startMs)
-            continue;
-        intervals.push({ startMs, endMs, durationMs: endMs - startMs });
-    }
-    return intervals;
-}
-/**
- * Find the task_history interval that contains the given timestamp. The
- * task wraps `akm improve`, so `improve_runs.started_at` (when
- * `recordImproveRun` writes) always falls inside the enclosing task's
- * [started_at, completed_at]. Returns undefined when no interval
- * contains the timestamp (which happens for manually-invoked improve
- * runs not driven by the `akm-improve` task).
- *
- * Linear scan because N is small. We tolerate a 1s slop on the upper
- * bound to handle clock skew between the wrapper's `completed_at` write
- * and recordImproveRun's `started_at` write.
- */
-function findContainingTaskInterval(timestampMs, intervals) {
-    const SLOP_MS = 1000;
-    for (const interval of intervals) {
-        if (timestampMs >= interval.startMs && timestampMs <= interval.endMs + SLOP_MS) {
-            return interval;
-        }
-    }
-    return undefined;
-}
 /**
  * Load `task_history` rows whose `task_id` begins `akm-improve` (the scheduled
  * improve tasks: `akm-improve-frequent`, `akm-improve-proactive-weekly`, …) in
@@ -88,7 +39,7 @@ export function matchImproveTaskId(startedAt, completedAt, taskRuns) {
     const startMs = new Date(startedAt).getTime();
     if (!Number.isFinite(startMs))
         return "manual";
-    const endMs = completedAt ? new Date(completedAt).getTime() : Number.NaN;
+    const endMs = new Date(completedAt).getTime();
     let best;
     let bestScore = Number.POSITIVE_INFINITY;
     for (const task of taskRuns) {
@@ -107,27 +58,12 @@ export function matchImproveTaskId(startedAt, completedAt, taskRuns) {
 }
 export function buildPerRunSummaries(db, since, until) {
     const rows = queryImproveRuns(db, since, until);
-    const taskIntervals = loadTaskIntervals(db, since, until);
     const improveTaskRuns = loadImproveTaskRuns(db, since, until);
     const summaries = [];
     for (const row of rows) {
         const startMs = new Date(row.started_at).getTime();
         const endMs = new Date(row.completed_at).getTime();
-        // Prefer the improve_runs row's own (completed_at - started_at) delta:
-        // recordImproveRun now persists distinct start/end timestamps, so the
-        // row's own delta is the authoritative per-run wall time even for
-        // manually-invoked `akm improve` runs with no enclosing task_history.
-        // Only fall back to the task_history containing-interval join for legacy/
-        // backfill rows where started_at == completed_at (row delta is 0).
-        const hasRowDelta = Number.isFinite(startMs) && Number.isFinite(endMs) && endMs > startMs;
-        let wallTimeMs;
-        if (hasRowDelta) {
-            wallTimeMs = endMs - startMs;
-        }
-        else {
-            const interval = Number.isFinite(startMs) ? findContainingTaskInterval(startMs, taskIntervals) : undefined;
-            wallTimeMs = interval?.durationMs ?? 0;
-        }
+        const wallTimeMs = Number.isFinite(startMs) && Number.isFinite(endMs) && endMs >= startMs ? endMs - startMs : 0;
         const taskId = matchImproveTaskId(row.started_at, row.completed_at, improveTaskRuns);
         summaries.push(projectImproveRunSummary(row, wallTimeMs, taskId));
     }

package/dist/{migrate-storage-node.mjs → commands/health/types-checks.js}

@@ -1,8 +1,4 @@
-#!/usr/bin/env node
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
-
-const { main } = await import("./scripts/migrate-storage.js");
-
-await main();
+export {};

package/dist/commands/health/types-improve.js

@@ -0,0 +1,29 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+/**
+ * Lanes ratified as ENRICHMENT-ONLY: they may propose edits to existing
+ * assets (metadata, relations, content refresh) but must not mint new ones.
+ * New-asset generation belongs to the signal-gated minting lanes
+ * (extract/distill/memory-inference).
+ */
+export const ENRICHMENT_LANES = ["proactive", "high-salience", "signal-delta"];
+/** Minted share of enrichment-lane accepts that triggers a WARN advisory. */
+export const ENRICHMENT_MINTED_WARN_SHARE = 0.05;
+/** Minted share of enrichment-lane accepts that triggers a FAIL advisory. */
+export const ENRICHMENT_MINTED_FAIL_SHARE = 0.15;
+/**
+ * Cron task failure rate at or above which the `task-fail-rate` health advisory
+ * warns. 0.05 (5%) is the SAME threshold the HTML report already applies as its
+ * fail-rate pass/warn cutoff (`failOk = taskFailRate < 0.05` in
+ * src/commands/health/html-report.ts) — this constant makes it the single
+ * source so the advisory and the rendered badge cannot drift.
+ */
+export const TASK_FAIL_RATE_WARN = 0.05;
+/**
+ * Minimum task_history rows a single task_id needs in the window before its
+ * per-task fail rate feeds the `task-fail-rate` advisory's "worst single
+ * task" signal. Guards against a rarely-run task (e.g. 1 failure out of 1
+ * run) reading as a 100% fail rate off a single noisy sample.
+ */
+export const MIN_ROWS_FOR_WORST_TASK_FAIL_RATE = 5;

package/dist/{output/text/save.js → commands/health/types-metrics.js}

@@ -1,5 +1,4 @@
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
-import { formatSavePlain } from "./helpers.js";
-export const saveFormatters = [{ command: "save", handler: (r) => formatSavePlain(r) }];
+export {};

package/dist/commands/health/types-result.js

@@ -0,0 +1,7 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+/** Event type recorded on each completed improve run. */
+export const IMPROVE_COMPLETED_EVENT = "improve_completed";
+/** An active task older than this (ms) is treated as stuck. */
+export const ACTIVE_RUN_WARN_MS = 15 * 60 * 1000;

package/dist/commands/health/types-runs.js

@@ -0,0 +1,4 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+export {};

package/dist/commands/health/types-session-log.js

@@ -0,0 +1,4 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+export {};

package/dist/commands/health/types-windows.js

@@ -0,0 +1,4 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+export {};

package/dist/commands/health/types.js

@@ -2,25 +2,30 @@
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
 /**
- * Lanes ratified as ENRICHMENT-ONLY: they may propose edits to existing
- * assets (metadata, relations, content refresh) but must not mint new ones.
- * New-asset generation belongs to the signal-gated minting lanes
- * (extract/distill/memory-inference/recombine).
+ * Shared type surface + constants for the `akm health` command modules.
+ * These interfaces are consumed across health/{improve-metrics,task-runs,
+ * windows,llm-usage,metrics,advisories}.ts, the report renderers, and the
+ * check registry.
+ *
+ * Chunk-9 WI-9.5d: this used to be one 690-line type dump. It is now a
+ * re-export barrel over cohesive per-domain modules (pure type move — zero
+ * runtime change, every existing `from "./types.js"` / `from "../health/types.js"`
+ * import site keeps working unchanged):
+ *   - `./types-checks` — {@link HealthCheckResult}.
+ *   - `./types-metrics` — {@link HealthMetrics} + the LLM usage aggregates.
+ *   - `./types-improve` — the {@link ImproveHealthMetrics} accumulator and its
+ *     WS-5 sub-rollups (coverage, perf telemetry, degradation, enrichment
+ *     minting).
+ *   - `./types-session-log` — {@link SessionLogAdvisory}.
+ *   - `./types-runs` — {@link ImproveRunSummary} (`--group-by run`).
+ *   - `./types-windows` — {@link WindowSpec}/{@link WindowResult}/{@link DeltaEntry}
+ *     (`--window-compare`/`--windows`).
+ *   - `./types-result` — {@link AkmHealthResult}, the `akmHealth()` return type.
  */
-export const ENRICHMENT_LANES = ["proactive", "high-salience", "high-retrieval", "signal-delta"];
-/** Minted share of enrichment-lane accepts that triggers a WARN advisory. */
-export const ENRICHMENT_MINTED_WARN_SHARE = 0.05;
-/** Minted share of enrichment-lane accepts that triggers a FAIL advisory. */
-export const ENRICHMENT_MINTED_FAIL_SHARE = 0.15;
-/**
- * Cron task failure rate at or above which the `task-fail-rate` health advisory
- * warns. 0.05 (5%) is the SAME threshold the HTML report already applies as its
- * fail-rate pass/warn cutoff (`failOk = taskFailRate < 0.05` in
- * src/commands/health/html-report.ts) — this constant makes it the single
- * source so the advisory and the rendered badge cannot drift.
- */
-export const TASK_FAIL_RATE_WARN = 0.05;
-/** Event type recorded on each completed improve run. */
-export const IMPROVE_COMPLETED_EVENT = "improve_completed";
-/** An active task older than this (ms) is treated as stuck. */
-export const ACTIVE_RUN_WARN_MS = 15 * 60 * 1000;
+export * from "./types-checks.js";
+export * from "./types-improve.js";
+export * from "./types-metrics.js";
+export * from "./types-result.js";
+export * from "./types-runs.js";
+export * from "./types-session-log.js";
+export * from "./types-windows.js";

package/dist/commands/health/windows.js

@@ -13,7 +13,7 @@ import { DURATION_UNITS, parseDuration } from "../../core/time.js";
 import { queryTaskHistory } from "../../storage/repositories/task-history-repository.js";
 import { buildImproveSkipSummary, computeWallTimeStats, parseTaskMetadata, roundRate, summarizeImproveCompleted, summarizeImproveRuns, } from "./improve-metrics.js";
 import { readLlmUsageAggregate } from "./llm-usage.js";
-import { computeDegradationMetrics, computeDenominatorFixedCoverage, readCalibration } from "./metrics.js";
+import { computeDegradationMetrics, computeDenominatorFixedCoverage } from "./metrics.js";
 import { buildPerRunSummaries } from "./task-runs.js";
 import { ACTIVE_RUN_WARN_MS, IMPROVE_COMPLETED_EVENT, } from "./types.js";
 /**
@@ -146,7 +146,7 @@ export function buildWindowMetrics(db, stateDbPath, since, until, now = () => Da
     });
     const { withLogs: taskRowsWithLogs, backed: existingLogRows } = partitionLogBackedRows(taskRows, logsDb);
     const failedTaskRows = taskRows.filter((row) => row.status === "failed");
-    const activeRows = taskRows.filter((row) => row.status === "active");
+    const activeRows = taskRows.filter((row) => row.status === "active" && row.completed_at === null);
     const stuckActiveRuns = activeRows.filter((row) => now() - new Date(row.started_at).getTime() > ACTIVE_RUN_WARN_MS).length;
     const promptRows = taskRows.filter((row) => row.target_kind === "prompt");
     const promptFailures = promptRows.filter((row) => {
@@ -172,7 +172,6 @@ export function buildWindowMetrics(db, stateDbPath, since, until, now = () => Da
     const perRunSummaries = buildPerRunSummaries(db, since, until);
     const wallTimes = perRunSummaries.map((run) => run.wallTimeMs).filter((ms) => Number.isFinite(ms) && ms > 0);
     improveSummary.wallTime = computeWallTimeStats(wallTimes, improveSummary.wallTime.byPhase);
-    improveSummary.calibration = readCalibration(db, since, until);
     // WS-5: Compute denominator-fixed coverage from the most recent run's
     // memorySummary (totalAssets = eligible + derived — the fixed denominator).
     const totalAssets = improveSummary.memorySummary.eligible + improveSummary.memorySummary.derived;