@spikedpunch/mast 0.1.0

package/dist/telemetry/lockMetricsSummary.js

@@ -0,0 +1,139 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { computeDurationPercentiles } from './metrics.js';
+import { LOCK_METRICS_FILENAME } from '../store/lockMetrics.js';
+// ---------------------------------------------------------------------------
+// Lock-hold summarizer (D6, IMPLEMENTATION_PLAN.md Stage 4 "D6 RESCOPE"
+// deliverable 2) — `mast metrics --locks`.
+//
+// Generalizes eval/baseline-locks.json's one-off capture-and-hand-compute
+// into a repeatable report over store/lockMetrics.ts's JSONL sink
+// (`<stateDir>/lock-metrics.jsonl`). That module's `LockEvent` union is the
+// source of truth for the shape summarized here: 'acquired' {waitMs},
+// 'released' {holdMs}, 'failed' {waitMs}, each carrying {type, caller,
+// timestamp}. `structure` lock hold-by-caller "SURVIVES, narrowed" per the
+// D6 rescope table — this is that surviving row's standing instrument.
+// ---------------------------------------------------------------------------
+// Validated at the boundary (§3.2): a hand-appended JSONL file on disk is
+// untrusted input, not a value already known to match `LockEvent` — a
+// truncated write (process killed mid-`appendFileSync`) or a future event
+// kind this summarizer doesn't know about must be skipped, not crash the
+// report.
+const LockEventSchema = z.discriminatedUnion('kind', [
+    z.object({
+        kind: z.literal('acquired'),
+        type: z.string(),
+        caller: z.string(),
+        waitMs: z.number(),
+        timestamp: z.number(),
+    }),
+    z.object({
+        kind: z.literal('released'),
+        type: z.string(),
+        caller: z.string(),
+        holdMs: z.number(),
+        timestamp: z.number(),
+    }),
+    z.object({
+        kind: z.literal('failed'),
+        type: z.string(),
+        caller: z.string(),
+        waitMs: z.number(),
+        timestamp: z.number(),
+    }),
+]);
+/**
+ * Summarize raw `lock-metrics.jsonl` content into per-caller count/p50/p95/max
+ * for both hold duration (`released` events) and wait/acquire duration
+ * (`acquired` events), plus a failed-acquisition count (`failed` events).
+ *
+ * Pure — takes the file's text directly rather than a path, so it is
+ * unit-testable against fixture strings without touching the filesystem.
+ * Malformed lines (bad JSON, or JSON that doesn't match a known `LockEvent`
+ * shape) are skipped and counted rather than thrown, matching
+ * store/lockMetrics.ts's own best-effort discipline for this data.
+ */
+export function summarizeLockMetricsJsonl(jsonlContent) {
+    const holdsByCaller = new Map();
+    const waitsByCaller = new Map();
+    const failedCountByCaller = new Map();
+    let malformedLineCount = 0;
+    const lines = jsonlContent.split('\n').filter((line) => line.trim().length > 0);
+    for (const line of lines) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            malformedLineCount++;
+            continue;
+        }
+        const result = LockEventSchema.safeParse(parsed);
+        if (!result.success) {
+            malformedLineCount++;
+            continue;
+        }
+        const event = result.data;
+        switch (event.kind) {
+            case 'released': {
+                const holds = holdsByCaller.get(event.caller) ?? [];
+                holds.push(event.holdMs);
+                holdsByCaller.set(event.caller, holds);
+                break;
+            }
+            case 'acquired': {
+                const waits = waitsByCaller.get(event.caller) ?? [];
+                waits.push(event.waitMs);
+                waitsByCaller.set(event.caller, waits);
+                break;
+            }
+            case 'failed': {
+                failedCountByCaller.set(event.caller, (failedCountByCaller.get(event.caller) ?? 0) + 1);
+                break;
+            }
+        }
+    }
+    const allCallers = new Set([
+        ...holdsByCaller.keys(),
+        ...waitsByCaller.keys(),
+        ...failedCountByCaller.keys(),
+    ]);
+    const callers = [...allCallers].sort().map((caller) => {
+        const holds = holdsByCaller.get(caller) ?? [];
+        const waits = waitsByCaller.get(caller) ?? [];
+        const holdPercentiles = computeDurationPercentiles(holds);
+        const waitPercentiles = computeDurationPercentiles(waits);
+        return {
+            caller,
+            count: holds.length,
+            hold_p50_ms: holdPercentiles.p50,
+            hold_p95_ms: holdPercentiles.p95,
+            hold_max_ms: holds.length > 0 ? Math.max(...holds) : 0,
+            wait_p50_ms: waitPercentiles.p50,
+            wait_p95_ms: waitPercentiles.p95,
+            wait_max_ms: waits.length > 0 ? Math.max(...waits) : 0,
+            failed_count: failedCountByCaller.get(caller) ?? 0,
+        };
+    });
+    return { callers, malformed_line_count: malformedLineCount };
+}
+/**
+ * Read and summarize `<stateDir>/lock-metrics.jsonl`.
+ *
+ * Returns `null` when the file is missing or empty — the "no lock metrics
+ * recorded" case `mast metrics --locks` reports distinctly from a
+ * zero-caller summary, so callers can tell "never ran a coarse write" apart
+ * from "ran, but every event was malformed" (the latter still returns a
+ * summary object, with `malformed_line_count > 0` and `callers: []`).
+ */
+export function readLockMetricsSummary(stateDir) {
+    const path = join(stateDir, LOCK_METRICS_FILENAME);
+    if (!existsSync(path))
+        return null;
+    const content = readFileSync(path, 'utf-8');
+    if (content.trim().length === 0)
+        return null;
+    return summarizeLockMetricsJsonl(content);
+}
+//# sourceMappingURL=lockMetricsSummary.js.map

package/dist/telemetry/lockMetricsSummary.js.map

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

package/dist/telemetry/metrics.d.ts

@@ -0,0 +1,140 @@
+import type { Db } from '../graph/db.js';
+import type { ToolStats } from '../ast/types.js';
+import type { DeclexTelemetry } from '../search/fused.js';
+export interface RecordToolCallOptions {
+    readonly toolName: string;
+    readonly tokensReturned: number;
+    readonly tokensFullFileBound: number;
+    readonly durationMs: number;
+    readonly sessionId: string;
+    readonly status: 'ok' | 'stale_returned' | 'error';
+    /** Pre-serialised via {@link buildArgsJson}. Omitted for tools that don't yet record argument identity. */
+    readonly argsJson?: string;
+    /** Pre-serialised via {@link buildResultsJson}. Omitted for tools that don't yet record result identity. */
+    readonly resultsJson?: string;
+    /** Pre-serialised via {@link buildDeclexJson}. Omitted when ranker D did not fire or the flag was off. */
+    readonly declexJson?: string;
+}
+/**
+ * Persist a single tool-call record to `metrics` and upsert the
+ * `metrics_daily` roll-up row for today.
+ *
+ * The write is fire-and-forget from the caller's perspective; any DB error
+ * is swallowed so a metrics failure never breaks a tool response.
+ */
+export declare function recordToolCall(db: Db, options: RecordToolCallOptions): Promise<void>;
+export interface MetricsSummary {
+    readonly tool_name: string;
+    readonly calls: number;
+    readonly tokens_returned_total: number;
+    readonly tokens_full_file_total: number;
+    readonly avg_duration_ms: number;
+    readonly efficiency_ratio: number;
+}
+/**
+ * Aggregate `metrics` rows within the given time window.
+ *
+ * @param db - open database
+ * @param sinceMs - unix epoch milliseconds; rows older than this are excluded
+ * @param toolName - when provided, restrict to one tool
+ */
+export declare function queryMetricsSummary(db: Db, sinceMs: number, toolName?: string): Promise<MetricsSummary[]>;
+/** A tool's p50/p95 call duration, in milliseconds. */
+export interface DurationPercentiles {
+    readonly p50: number;
+    readonly p95: number;
+}
+/**
+ * Nearest-rank percentile (no interpolation): sort ascending, then for
+ * percentile P take the value at rank `ceil(P/100 * N)` (1-indexed).
+ *
+ * Chosen over interpolated definitions (linear/R-7 etc.) because §14.9
+ * explicitly declines to assert an SLA on this data — the interpolation
+ * precision those methods buy is not needed for a human-readable CLI table,
+ * and nearest-rank is the simplest definition that avoids an
+ * interpolation-method debate. Returns `{p50: 0, p95: 0}` for an empty input
+ * rather than throwing — matches this module's fire-and-forget discipline
+ * (a metrics computation must never crash a caller).
+ */
+export declare function computeDurationPercentiles(durationsMs: readonly number[]): DurationPercentiles;
+export interface MetricsSummaryWithPercentiles extends MetricsSummary {
+    readonly p50_duration_ms: number;
+    readonly p95_duration_ms: number;
+}
+/**
+ * Same aggregation as {@link queryMetricsSummary}, plus per-tool p50/p95
+ * duration percentiles.
+ *
+ * better-sqlite3's default build has no SQL percentile aggregate, so this
+ * fetches the window's raw `duration_ms` values (one extra query) and
+ * computes percentiles in JS per tool group via
+ * {@link computeDurationPercentiles}. Safe at the row counts this table
+ * actually holds: §14.4's rotation policy bounds the raw `metrics` table to
+ * roughly 1,500 rows/day pre-rollup, i.e. thousands of rows at most for any
+ * realistic `--since` window — well within "fetch and sort in JS" territory.
+ */
+export declare function queryMetricsSummaryWithPercentiles(db: Db, sinceMs: number, toolName?: string): Promise<readonly MetricsSummaryWithPercentiles[]>;
+/**
+ * Aggregate `metrics` rows for a single session.
+ */
+export declare function querySessionSummary(db: Db, sessionId: string): Promise<MetricsSummary[]>;
+/**
+ * Collapse raw `metrics` rows older than `keepDays` into `metrics_daily`
+ * (the roll-up already exists) and delete the raw rows.
+ *
+ * Safe to call repeatedly — idempotent.
+ */
+export declare function rollupMetrics(db: Db, keepDays?: number): Promise<number>;
+/**
+ * Delete `metrics_daily` rows older than `keepDays` days.
+ */
+export declare function vacuumMetrics(db: Db, keepDays?: number): Promise<number>;
+/**
+ * Build a `ToolStats` block from raw measurements.
+ *
+ * Attached to every read-tool response so consumers can track token savings.
+ */
+export declare function buildToolStats(toolName: string, tokensReturned: number, tokensFullFileBound: number, filesReferenced: readonly string[], durationMs: number): ToolStats;
+/** A single `{file_path, symbol_name}` identity pair returned by a read tool, in rank order. */
+export interface ResultIdentity {
+    readonly file_path: string;
+    readonly symbol_name: string | null;
+}
+/**
+ * Serialise the salient tool arguments for `metrics.args_json`, capped at
+ * {@link ARGS_JSON_CHAR_CAP} characters.
+ *
+ * `JSON.stringify` already drops `undefined`-valued properties, so passing
+ * the tool's raw zod-parsed input captures "query + filters" (or
+ * "symbol/file_path") without extra bookkeeping at each call site.
+ *
+ * When the serialised form exceeds the cap, the truncation is stated
+ * honestly in the payload itself (`_truncated`, `original_length`) rather
+ * than silently cutting the string — an un-labelled truncated JSON string
+ * would also risk being invalid JSON.
+ */
+export declare function buildArgsJson(args: Record<string, unknown>, capChars?: number): string;
+/**
+ * Serialise result identity pairs for `metrics.results_json`, capped at
+ * {@link RESULTS_JSON_ENTRY_CAP} entries.
+ *
+ * Rank order is preserved. When the list exceeds the cap, a final
+ * `{"_truncated": N}` element (N = the number of dropped entries) is
+ * appended rather than silently dropping them — mirrors {@link buildArgsJson}'s
+ * honesty rule.
+ */
+export declare function buildResultsJson(identities: readonly ResultIdentity[], cap?: number): string;
+/**
+ * Serialise ranker D's fire telemetry for `metrics.declex_json`, capping
+ * `window_effects` at {@link DECLEX_JSON_ENTRY_CAP} entries.
+ *
+ * Truncation shape: a top-level `_truncated: <dropped count>` field is set
+ * (nothing appended to `window_effects` itself) — {@link buildArgsJson}'s
+ * convention of a top-level marker rather than {@link buildResultsJson}'s
+ * appended-sentinel-element, because `window_effects` here is one field of a
+ * larger diagnostics object (fired/top_match_channel/candidate_count sit
+ * alongside it), not a bare list — a marker mixed into the array would be
+ * indistinguishable from a real (malformed) effect on parse.
+ */
+export declare function buildDeclexJson(telemetry: DeclexTelemetry, capEntries?: number): string;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/telemetry/metrics.d.ts.map

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

package/dist/telemetry/metrics.js

@@ -0,0 +1,312 @@
+import { sql } from 'kysely';
+/**
+ * Persist a single tool-call record to `metrics` and upsert the
+ * `metrics_daily` roll-up row for today.
+ *
+ * The write is fire-and-forget from the caller's perspective; any DB error
+ * is swallowed so a metrics failure never breaks a tool response.
+ */
+export async function recordToolCall(db, options) {
+    const now = Date.now() / 1000; // unix epoch seconds
+    const day = new Date().toISOString().slice(0, 10); // 'YYYY-MM-DD'
+    await db
+        .insertInto('metrics')
+        .values({
+        tool_name: options.toolName,
+        call_timestamp: now,
+        tokens_returned: options.tokensReturned,
+        tokens_full_file_upper_bound: options.tokensFullFileBound,
+        duration_ms: options.durationMs,
+        // Stage 7.2 (IMPLEMENTATION_PLAN.md "Stage 7: Vector-store deletion"):
+        // no code produces a search mode any more (the vector leg it used to
+        // distinguish from lexical is gone), so every new row writes NULL. The
+        // COLUMN stays — pre-Stage-7 rows carry 'hybrid'/'lexical' and remain
+        // readable for historical queries.
+        mode: null,
+        session_id: options.sessionId,
+        status: options.status,
+        args_json: options.argsJson ?? null,
+        results_json: options.resultsJson ?? null,
+        declex_json: options.declexJson ?? null,
+    })
+        .execute();
+    // Upsert today's roll-up row.
+    await db
+        .insertInto('metrics_daily')
+        .values({
+        day,
+        tool_name: options.toolName,
+        calls: 1,
+        tokens_returned_total: options.tokensReturned,
+        tokens_full_file_total: options.tokensFullFileBound,
+        avg_duration_ms: options.durationMs,
+    })
+        .onConflict((oc) => oc.columns(['day', 'tool_name']).doUpdateSet((eb) => ({
+        calls: sql `${eb.ref('excluded.calls')} + metrics_daily.calls`,
+        tokens_returned_total: sql `${eb.ref('excluded.tokens_returned_total')} + metrics_daily.tokens_returned_total`,
+        tokens_full_file_total: sql `${eb.ref('excluded.tokens_full_file_total')} + metrics_daily.tokens_full_file_total`,
+        // Incremental running average: (old_avg * old_n + new_val) / (old_n + 1)
+        avg_duration_ms: sql `(metrics_daily.avg_duration_ms * metrics_daily.calls + ${eb.ref('excluded.avg_duration_ms')}) / (metrics_daily.calls + 1)`,
+    })))
+        .execute();
+}
+/**
+ * Aggregate `metrics` rows within the given time window.
+ *
+ * @param db - open database
+ * @param sinceMs - unix epoch milliseconds; rows older than this are excluded
+ * @param toolName - when provided, restrict to one tool
+ */
+export async function queryMetricsSummary(db, sinceMs, toolName) {
+    const sinceEpochSec = sinceMs / 1000;
+    let q = db
+        .selectFrom('metrics')
+        .select((eb) => [
+        'tool_name',
+        eb.fn.count('id').as('calls'),
+        eb.fn.sum('tokens_returned').as('tokens_returned_total'),
+        eb.fn.sum('tokens_full_file_upper_bound').as('tokens_full_file_total'),
+        eb.fn.avg('duration_ms').as('avg_duration_ms'),
+    ])
+        .where('call_timestamp', '>=', sinceEpochSec)
+        .groupBy('tool_name')
+        .orderBy('tool_name', 'asc');
+    if (toolName !== undefined) {
+        q = q.where('tool_name', '=', toolName);
+    }
+    const rows = await q.execute();
+    return rows.map((r) => ({
+        tool_name: r.tool_name,
+        calls: Number(r.calls),
+        tokens_returned_total: Number(r.tokens_returned_total),
+        tokens_full_file_total: Number(r.tokens_full_file_total),
+        avg_duration_ms: Number(r.avg_duration_ms),
+        efficiency_ratio: Number(r.tokens_full_file_total) > 0
+            ? 1 - Number(r.tokens_returned_total) / Number(r.tokens_full_file_total)
+            : 0,
+    }));
+}
+/**
+ * Nearest-rank percentile (no interpolation): sort ascending, then for
+ * percentile P take the value at rank `ceil(P/100 * N)` (1-indexed).
+ *
+ * Chosen over interpolated definitions (linear/R-7 etc.) because §14.9
+ * explicitly declines to assert an SLA on this data — the interpolation
+ * precision those methods buy is not needed for a human-readable CLI table,
+ * and nearest-rank is the simplest definition that avoids an
+ * interpolation-method debate. Returns `{p50: 0, p95: 0}` for an empty input
+ * rather than throwing — matches this module's fire-and-forget discipline
+ * (a metrics computation must never crash a caller).
+ */
+export function computeDurationPercentiles(durationsMs) {
+    if (durationsMs.length === 0)
+        return { p50: 0, p95: 0 };
+    const sorted = [...durationsMs].sort((a, b) => a - b);
+    const rankValue = (percentile) => {
+        const rank = Math.ceil((percentile / 100) * sorted.length);
+        const index = Math.min(Math.max(rank - 1, 0), sorted.length - 1);
+        return sorted[index];
+    };
+    return { p50: rankValue(50), p95: rankValue(95) };
+}
+/**
+ * Same aggregation as {@link queryMetricsSummary}, plus per-tool p50/p95
+ * duration percentiles.
+ *
+ * better-sqlite3's default build has no SQL percentile aggregate, so this
+ * fetches the window's raw `duration_ms` values (one extra query) and
+ * computes percentiles in JS per tool group via
+ * {@link computeDurationPercentiles}. Safe at the row counts this table
+ * actually holds: §14.4's rotation policy bounds the raw `metrics` table to
+ * roughly 1,500 rows/day pre-rollup, i.e. thousands of rows at most for any
+ * realistic `--since` window — well within "fetch and sort in JS" territory.
+ */
+export async function queryMetricsSummaryWithPercentiles(db, sinceMs, toolName) {
+    const base = await queryMetricsSummary(db, sinceMs, toolName);
+    if (base.length === 0)
+        return [];
+    const sinceEpochSec = sinceMs / 1000;
+    let durationQuery = db
+        .selectFrom('metrics')
+        .select(['tool_name', 'duration_ms'])
+        .where('call_timestamp', '>=', sinceEpochSec);
+    if (toolName !== undefined) {
+        durationQuery = durationQuery.where('tool_name', '=', toolName);
+    }
+    const durationRows = await durationQuery.execute();
+    const durationsByTool = new Map();
+    for (const row of durationRows) {
+        const existing = durationsByTool.get(row.tool_name);
+        if (existing !== undefined)
+            existing.push(row.duration_ms);
+        else
+            durationsByTool.set(row.tool_name, [row.duration_ms]);
+    }
+    return base.map((summary) => {
+        const { p50, p95 } = computeDurationPercentiles(durationsByTool.get(summary.tool_name) ?? []);
+        return { ...summary, p50_duration_ms: p50, p95_duration_ms: p95 };
+    });
+}
+/**
+ * Aggregate `metrics` rows for a single session.
+ */
+export async function querySessionSummary(db, sessionId) {
+    const rows = await db
+        .selectFrom('metrics')
+        .select((eb) => [
+        'tool_name',
+        eb.fn.count('id').as('calls'),
+        eb.fn.sum('tokens_returned').as('tokens_returned_total'),
+        eb.fn.sum('tokens_full_file_upper_bound').as('tokens_full_file_total'),
+        eb.fn.avg('duration_ms').as('avg_duration_ms'),
+    ])
+        .where('session_id', '=', sessionId)
+        .groupBy('tool_name')
+        .orderBy('tool_name', 'asc')
+        .execute();
+    return rows.map((r) => ({
+        tool_name: r.tool_name,
+        calls: Number(r.calls),
+        tokens_returned_total: Number(r.tokens_returned_total),
+        tokens_full_file_total: Number(r.tokens_full_file_total),
+        avg_duration_ms: Number(r.avg_duration_ms),
+        efficiency_ratio: Number(r.tokens_full_file_total) > 0
+            ? 1 - Number(r.tokens_returned_total) / Number(r.tokens_full_file_total)
+            : 0,
+    }));
+}
+// ---------------------------------------------------------------------------
+// Rotation helpers
+// ---------------------------------------------------------------------------
+/**
+ * Collapse raw `metrics` rows older than `keepDays` into `metrics_daily`
+ * (the roll-up already exists) and delete the raw rows.
+ *
+ * Safe to call repeatedly — idempotent.
+ */
+export async function rollupMetrics(db, keepDays = 7) {
+    const cutoffSec = (Date.now() - keepDays * 86_400_000) / 1000;
+    const result = await db
+        .deleteFrom('metrics')
+        .where('call_timestamp', '<', cutoffSec)
+        .executeTakeFirst();
+    return Number(result.numDeletedRows);
+}
+/**
+ * Delete `metrics_daily` rows older than `keepDays` days.
+ */
+export async function vacuumMetrics(db, keepDays = 90) {
+    const cutoff = new Date(Date.now() - keepDays * 86_400_000)
+        .toISOString()
+        .slice(0, 10);
+    const result = await db
+        .deleteFrom('metrics_daily')
+        .where('day', '<', cutoff)
+        .executeTakeFirst();
+    return Number(result.numDeletedRows);
+}
+// ---------------------------------------------------------------------------
+// ToolStats builder
+// ---------------------------------------------------------------------------
+/**
+ * Build a `ToolStats` block from raw measurements.
+ *
+ * Attached to every read-tool response so consumers can track token savings.
+ */
+export function buildToolStats(toolName, tokensReturned, tokensFullFileBound, filesReferenced, durationMs) {
+    const efficiency = tokensFullFileBound > 0
+        ? 1 - tokensReturned / tokensFullFileBound
+        : 0;
+    return {
+        tool: toolName,
+        tokens_returned: tokensReturned,
+        tokens_full_file_upper_bound: tokensFullFileBound,
+        files_referenced: filesReferenced,
+        efficiency_ratio: efficiency,
+        duration_ms: durationMs,
+    };
+}
+const ARGS_JSON_CHAR_CAP = 1_000;
+const RESULTS_JSON_ENTRY_CAP = 20;
+/**
+ * Serialise the salient tool arguments for `metrics.args_json`, capped at
+ * {@link ARGS_JSON_CHAR_CAP} characters.
+ *
+ * `JSON.stringify` already drops `undefined`-valued properties, so passing
+ * the tool's raw zod-parsed input captures "query + filters" (or
+ * "symbol/file_path") without extra bookkeeping at each call site.
+ *
+ * When the serialised form exceeds the cap, the truncation is stated
+ * honestly in the payload itself (`_truncated`, `original_length`) rather
+ * than silently cutting the string — an un-labelled truncated JSON string
+ * would also risk being invalid JSON.
+ */
+export function buildArgsJson(args, capChars = ARGS_JSON_CHAR_CAP) {
+    const full = JSON.stringify(args);
+    if (full.length <= capChars)
+        return full;
+    const wrap = (previewLen) => JSON.stringify({
+        _truncated: true,
+        original_length: full.length,
+        preview: full.slice(0, previewLen),
+    });
+    // `preview` is a slice of an already-JSON-encoded string, so it can contain
+    // quote/backslash characters that need escaping once re-embedded as a JSON
+    // string value — a fixed-length guess can overshoot the cap. Shrink
+    // iteratively by the observed overflow instead; the max() clamp guarantees
+    // termination even if a shrink step's escaping happens to net zero.
+    let previewLen = Math.max(0, capChars - wrap(0).length);
+    let wrapped = wrap(previewLen);
+    while (wrapped.length > capChars && previewLen > 0) {
+        previewLen = Math.max(0, previewLen - (wrapped.length - capChars));
+        wrapped = wrap(previewLen);
+    }
+    return wrapped;
+}
+/**
+ * Serialise result identity pairs for `metrics.results_json`, capped at
+ * {@link RESULTS_JSON_ENTRY_CAP} entries.
+ *
+ * Rank order is preserved. When the list exceeds the cap, a final
+ * `{"_truncated": N}` element (N = the number of dropped entries) is
+ * appended rather than silently dropping them — mirrors {@link buildArgsJson}'s
+ * honesty rule.
+ */
+export function buildResultsJson(identities, cap = RESULTS_JSON_ENTRY_CAP) {
+    if (identities.length <= cap)
+        return JSON.stringify(identities);
+    const kept = identities.slice(0, cap);
+    const droppedCount = identities.length - cap;
+    return JSON.stringify([...kept, { _truncated: droppedCount }]);
+}
+// ---------------------------------------------------------------------------
+// D-fire telemetry — `metrics.declex_json` (Stage 6.3, M2 decision memo
+// condition 3: the input signal for the F18 kill-switch and re-entry
+// criteria).
+// ---------------------------------------------------------------------------
+const DECLEX_JSON_ENTRY_CAP = 10;
+/**
+ * Serialise ranker D's fire telemetry for `metrics.declex_json`, capping
+ * `window_effects` at {@link DECLEX_JSON_ENTRY_CAP} entries.
+ *
+ * Truncation shape: a top-level `_truncated: <dropped count>` field is set
+ * (nothing appended to `window_effects` itself) — {@link buildArgsJson}'s
+ * convention of a top-level marker rather than {@link buildResultsJson}'s
+ * appended-sentinel-element, because `window_effects` here is one field of a
+ * larger diagnostics object (fired/top_match_channel/candidate_count sit
+ * alongside it), not a bare list — a marker mixed into the array would be
+ * indistinguishable from a real (malformed) effect on parse.
+ */
+export function buildDeclexJson(telemetry, capEntries = DECLEX_JSON_ENTRY_CAP) {
+    const { window_effects, ...rest } = telemetry;
+    if (window_effects.length <= capEntries) {
+        return JSON.stringify({ ...rest, window_effects });
+    }
+    const droppedCount = window_effects.length - capEntries;
+    return JSON.stringify({
+        ...rest,
+        window_effects: window_effects.slice(0, capEntries),
+        _truncated: droppedCount,
+    });
+}
+//# sourceMappingURL=metrics.js.map

package/dist/telemetry/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/telemetry/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAwB7B;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAM,EACN,OAA8B;IAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,qBAAqB;IACpD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe;IAElE,MAAM,EAAE;SACL,UAAU,CAAC,SAAS,CAAC;SACrB,MAAM,CAAC;QACN,SAAS,EAAqB,OAAO,CAAC,QAAQ;QAC9C,cAAc,EAAgB,GAAG;QACjC,eAAe,EAAe,OAAO,CAAC,cAAc;QACpD,4BAA4B,EAAE,OAAO,CAAC,mBAAmB;QACzD,WAAW,EAAmB,OAAO,CAAC,UAAU;QAChD,uEAAuE;QACvE,qEAAqE;QACrE,uEAAuE;QACvE,sEAAsE;QACtE,mCAAmC;QACnC,IAAI,EAA0B,IAAI;QAClC,UAAU,EAAoB,OAAO,CAAC,SAAS;QAC/C,MAAM,EAAwB,OAAO,CAAC,MAAM;QAC5C,SAAS,EAAqB,OAAO,CAAC,QAAQ,IAAI,IAAI;QACtD,YAAY,EAAkB,OAAO,CAAC,WAAW,IAAI,IAAI;QACzD,WAAW,EAAmB,OAAO,CAAC,UAAU,IAAI,IAAI;KACzD,CAAC;SACD,OAAO,EAAE,CAAC;IAEb,8BAA8B;IAC9B,MAAM,EAAE;SACL,UAAU,CAAC,eAAe,CAAC;SAC3B,MAAM,CAAC;QACN,GAAG;QACH,SAAS,EAAc,OAAO,CAAC,QAAQ;QACvC,KAAK,EAAkB,CAAC;QACxB,qBAAqB,EAAE,OAAO,CAAC,cAAc;QAC7C,sBAAsB,EAAE,OAAO,CAAC,mBAAmB;QACnD,eAAe,EAAQ,OAAO,CAAC,UAAU;KAC1C,CAAC;SACD,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CACjB,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACpD,KAAK,EAAkB,GAAG,CAAA,GAAG,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,wBAAwB;QAC7E,qBAAqB,EAAE,GAAG,CAAA,GAAG,EAAE,CAAC,GAAG,CAAC,gCAAgC,CAAC,wCAAwC;QAC7G,sBAAsB,EAAE,GAAG,CAAA,GAAG,EAAE,CAAC,GAAG,CAAC,iCAAiC,CAAC,yCAAyC;QAChH,yEAAyE;QACzE,eAAe,EAAE,GAAG,CAAA,0DAA0D,EAAE,CAAC,GAAG,CAAC,0BAA0B,CAAC,+BAA+B;KAChJ,CAAC,CAAC,CACJ;SACA,OAAO,EAAE,CAAC;AACf,CAAC;AAeD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,EAAM,EACN,OAAe,EACf,QAAiB;IAEjB,MAAM,aAAa,GAAG,OAAO,GAAG,IAAI,CAAC;IAErC,IAAI,CAAC,GAAG,EAAE;SACP,UAAU,CAAC,SAAS,CAAC;SACrB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;QACd,WAAW;QACX,EAAE,CAAC,EAAE,CAAC,KAAK,CAAS,IAAI,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC;QACrC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAS,iBAAiB,CAAC,CAAC,EAAE,CAAC,uBAAuB,CAAC;QAChE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAS,8BAA8B,CAAC,CAAC,EAAE,CAAC,wBAAwB,CAAC;QAC9E,EAAE,CAAC,EAAE,CAAC,GAAG,CAAS,aAAa,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC;KACvD,CAAC;SACD,KAAK,CAAC,gBAAgB,EAAE,IAAI,EAAE,aAAa,CAAC;SAC5C,OAAO,CAAC,WAAW,CAAC;SACpB,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAE/B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;IAE/B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,SAAS,EAAc,CAAC,CAAC,SAAS;QAClC,KAAK,EAAkB,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;QACtC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC;QACtD,sBAAsB,EAAE,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC;QACxD,eAAe,EAAQ,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC;QAChD,gBAAgB,EACd,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC;YAClC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC;YACxE,CAAC,CAAC,CAAC;KACR,CAAC,CAAC,CAAC;AACN,CAAC;AAeD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B,CAAC,WAA8B;IACvE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IAExD,MAAM,MAAM,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,CAAC,UAAkB,EAAU,EAAE;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACjE,OAAO,MAAM,CAAC,KAAK,CAAE,CAAC;IACxB,CAAC,CAAC;IAEF,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;AACpD,CAAC;AAOD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,EAAM,EACN,OAAe,EACf,QAAiB;IAEjB,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,aAAa,GAAG,OAAO,GAAG,IAAI,CAAC;IACrC,IAAI,aAAa,GAAG,EAAE;SACnB,UAAU,CAAC,SAAS,CAAC;SACrB,MAAM,CAAC,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;SACpC,KAAK,CAAC,gBAAgB,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;IAChD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC;IAEnD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAoB,CAAC;IACpD,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,QAAQ,KAAK,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;;YACtD,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC1B,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,0BAA0B,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9F,OAAO,EAAE,GAAG,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,EAAM,EACN,SAAiB;IAEjB,MAAM,IAAI,GAAG,MAAM,EAAE;SAClB,UAAU,CAAC,SAAS,CAAC;SACrB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;QACd,WAAW;QACX,EAAE,CAAC,EAAE,CAAC,KAAK,CAAS,IAAI,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC;QACrC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAS,iBAAiB,CAAC,CAAC,EAAE,CAAC,uBAAuB,CAAC;QAChE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAS,8BAA8B,CAAC,CAAC,EAAE,CAAC,wBAAwB,CAAC;QAC9E,EAAE,CAAC,EAAE,CAAC,GAAG,CAAS,aAAa,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC;KACvD,CAAC;SACD,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,SAAS,CAAC;SACnC,OAAO,CAAC,WAAW,CAAC;SACpB,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC;SAC3B,OAAO,EAAE,CAAC;IAEb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,SAAS,EAAc,CAAC,CAAC,SAAS;QAClC,KAAK,EAAkB,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;QACtC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC;QACtD,sBAAsB,EAAE,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC;QACxD,eAAe,EAAQ,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC;QAChD,gBAAgB,EACd,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC;YAClC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC;YACxE,CAAC,CAAC,CAAC;KACR,CAAC,CAAC,CAAC;AACN,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAM,EAAE,QAAQ,GAAG,CAAC;IACtD,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC;IAC9D,MAAM,MAAM,GAAG,MAAM,EAAE;SACpB,UAAU,CAAC,SAAS,CAAC;SACrB,KAAK,CAAC,gBAAgB,EAAE,GAAG,EAAE,SAAS,CAAC;SACvC,gBAAgB,EAAE,CAAC;IACtB,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAM,EAAE,QAAQ,GAAG,EAAE;IACvD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,GAAG,UAAU,CAAC;SACxD,WAAW,EAAE;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,MAAM,MAAM,GAAG,MAAM,EAAE;SACpB,UAAU,CAAC,eAAe,CAAC;SAC3B,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC;SACzB,gBAAgB,EAAE,CAAC;IACtB,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;AACvC,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,cAAsB,EACtB,mBAA2B,EAC3B,eAAkC,EAClC,UAAkB;IAElB,MAAM,UAAU,GACd,mBAAmB,GAAG,CAAC;QACrB,CAAC,CAAC,CAAC,GAAG,cAAc,GAAG,mBAAmB;QAC1C,CAAC,CAAC,CAAC,CAAC;IAER,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,eAAe,EAAE,cAAc;QAC/B,4BAA4B,EAAE,mBAAmB;QACjD,gBAAgB,EAAE,eAAe;QACjC,gBAAgB,EAAE,UAAU;QAC5B,WAAW,EAAE,UAAU;KACxB,CAAC;AACJ,CAAC;AAiBD,MAAM,kBAAkB,GAAG,KAAK,CAAC;AACjC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAElC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,IAA6B,EAAE,QAAQ,GAAG,kBAAkB;IACxF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,IAAI,GAAG,CAAC,UAAkB,EAAU,EAAE,CAC1C,IAAI,CAAC,SAAS,CAAC;QACb,UAAU,EAAE,IAAI;QAChB,eAAe,EAAE,IAAI,CAAC,MAAM;QAC5B,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;KACnC,CAAC,CAAC;IAEL,4EAA4E;IAC5E,2EAA2E;IAC3E,oEAAoE;IACpE,2EAA2E;IAC3E,oEAAoE;IACpE,IAAI,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/B,OAAO,OAAO,CAAC,MAAM,GAAG,QAAQ,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnD,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;QACnE,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAqC,EACrC,GAAG,GAAG,sBAAsB;IAE5B,IAAI,UAAU,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAEhE,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC;IAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,8EAA8E;AAC9E,wEAAwE;AACxE,qEAAqE;AACrE,aAAa;AACb,8EAA8E;AAE9E,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,SAA0B,EAAE,UAAU,GAAG,qBAAqB;IAC5F,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC;IAC9C,IAAI,cAAc,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,GAAG,UAAU,CAAC;IACxD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,GAAG,IAAI;QACP,cAAc,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;QACnD,UAAU,EAAE,YAAY;KACzB,CAAC,CAAC;AACL,CAAC"}