@wildorder/nightshift 0.16.0 → 0.18.0

package/dist/provider-telemetry.d.ts

@@ -0,0 +1,106 @@
+import type { Dimensions, Coverage, EvidenceReference, PointObservationInput } from "./run-analytics.js";
+/**
+ * Provider-neutral normalization of a Claude `--output-format stream-json`
+ * transcript into coverage-labelled facts (WS-03, SC-08). Kept apart from
+ * `agent-runner.ts` so the normalizer is unit-testable against fixtures
+ * without spawning anything; `agent-runner.ts`'s demultiplexer feeds this
+ * module's accumulator the same already-parsed events it routes for
+ * commands/denials, so production never parses the stream twice.
+ *
+ * The one rule every field here answers to: absent or unsupported telemetry
+ * is `{ coverage: "unavailable" }` with no `value` — never a measured zero.
+ */
+export declare const PROVIDER_TELEMETRY_KIND: "provider-telemetry";
+/** A numeric fact with its observability label. `value` is absent whenever `coverage` is `"unavailable"`. */
+export interface Measured {
+    coverage: Coverage;
+    value?: number;
+    unit?: string;
+}
+/** A string-valued fact (model identity, provider label) with its observability label. */
+export interface MeasuredString {
+    coverage: Coverage;
+    value?: string;
+}
+/** One `compact_boundary` event, when the stream exposes one. */
+export interface CompactionOccurrence {
+    tokensBefore: Measured;
+    at: Measured;
+}
+/**
+ * The internal, in-memory normalization of one spawn's provider telemetry.
+ * Never persisted as-is — `providerTelemetryPoints` fans it out into one
+ * scalar `PointObservationInput` per measured fact.
+ */
+export interface NormalizedTelemetry {
+    provider: MeasuredString;
+    model: MeasuredString;
+    configuredModel: MeasuredString;
+    inputTokens: Measured;
+    outputTokens: Measured;
+    cacheReadTokens: Measured;
+    cacheCreationTokens: Measured;
+    reasoningTokens: Measured;
+    contextCapacityTokens: Measured;
+    peakContextOccupancyTokens: Measured;
+    compactions: CompactionOccurrence[];
+    compactionCount: Measured;
+    continuationTurns: Measured;
+    toolCalls: Measured;
+    fileActivity: {
+        reads: Measured;
+        writes: Measured;
+        edits: Measured;
+    };
+    commandOutputBytes: Measured;
+    costUsd?: Measured;
+}
+/**
+ * Parses `--model <value>` and `--model=<value>` out of a derived
+ * invocation's argv — free operator-authored args routinely carry an
+ * explicit model override even though `AgentConfig` has no dedicated model
+ * property (SC-05).
+ */
+export declare function parseConfiguredModel(args: readonly string[]): MeasuredString;
+/**
+ * A coarse provider label derived from the configured command when the
+ * stream itself exposes no model — an inference from the invocation, never
+ * a provider-reported fact, hence `"estimated"`.
+ */
+export declare function providerLabelFromCommand(command: string | undefined): MeasuredString;
+interface TelemetryAccumulatorOptions {
+    /** Precomputed from the derived invocation's argv (SC-05). */
+    configuredModel: MeasuredString;
+    /** Precomputed from the derived invocation's command, for the provider fallback. */
+    commandProviderGuess: MeasuredString;
+}
+export interface TelemetryAccumulator {
+    observeEvent(event: unknown): void;
+    finish(flags: {
+        observed: boolean;
+        corrupted: boolean;
+    }): NormalizedTelemetry;
+}
+/**
+ * A pure, non-throwing, stateful accumulator fed one already-parsed
+ * stream-json event at a time. `agent-runner.ts`'s demultiplexer routes each
+ * event to both its own command/denial routing and this accumulator's
+ * `observeEvent`, so the underlying text is parsed exactly once in
+ * production; `normalizeClaudeTelemetry` below wraps the same accumulator
+ * with its own line-splitting for standalone fixture-driven tests.
+ */
+export declare function createTelemetryAccumulator(options: TelemetryAccumulatorOptions): TelemetryAccumulator;
+/**
+ * Demultiplexes a whole captured stream-json string in one call, purely for
+ * fixture-driven tests — production feeds `createTelemetryAccumulator`
+ * directly from `agent-runner.ts`'s single event-parsing pass so the raw
+ * text is never parsed twice.
+ */
+export declare function normalizeClaudeTelemetry(raw: string, options?: {
+    configuredArgs?: readonly string[];
+    command?: string;
+}): NormalizedTelemetry;
+/** One point per SC-08-enumerated metric, scalar and coverage-labelled, never a fabricated zero for a metric the stream did not expose. */
+export declare function providerTelemetryPoints(telemetry: NormalizedTelemetry, dimensions: Partial<Dimensions>, evidence: EvidenceReference[]): PointObservationInput[];
+export {};
+//# sourceMappingURL=provider-telemetry.d.ts.map

package/dist/provider-telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-telemetry.d.ts","sourceRoot":"","sources":["../src/provider-telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEzG;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,uBAAuB,EAAG,oBAA6B,CAAC;AAErE,6GAA6G;AAC7G,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0FAA0F;AAC1F,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,QAAQ,CAAC;IACvB,EAAE,EAAE,QAAQ,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,cAAc,CAAC;IACtB,eAAe,EAAE,cAAc,CAAC;IAChC,WAAW,EAAE,QAAQ,CAAC;IACtB,YAAY,EAAE,QAAQ,CAAC;IACvB,eAAe,EAAE,QAAQ,CAAC;IAC1B,mBAAmB,EAAE,QAAQ,CAAC;IAC9B,eAAe,EAAE,QAAQ,CAAC;IAC1B,qBAAqB,EAAE,QAAQ,CAAC;IAChC,0BAA0B,EAAE,QAAQ,CAAC;IACrC,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,eAAe,EAAE,QAAQ,CAAC;IAC1B,iBAAiB,EAAE,QAAQ,CAAC;IAC5B,SAAS,EAAE,QAAQ,CAAC;IACpB,YAAY,EAAE;QAAE,KAAK,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAA;KAAE,CAAC;IACrE,kBAAkB,EAAE,QAAQ,CAAC;IAC7B,OAAO,CAAC,EAAE,QAAQ,CAAC;CACpB;AAuBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CAa5E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CASpF;AAiBD,UAAU,2BAA2B;IACnC,8DAA8D;IAC9D,eAAe,EAAE,cAAc,CAAC;IAChC,oFAAoF;IACpF,oBAAoB,EAAE,cAAc,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,MAAM,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG,mBAAmB,CAAC;CAC/E;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,GAAG,oBAAoB,CAqOrG;AAMD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACrE,mBAAmB,CA+BrB;AAED,2IAA2I;AAC3I,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,mBAAmB,EAC9B,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,EAC/B,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,qBAAqB,EAAE,CAkEzB"}

package/dist/provider-telemetry.js

@@ -0,0 +1,423 @@
+/**
+ * Provider-neutral normalization of a Claude `--output-format stream-json`
+ * transcript into coverage-labelled facts (WS-03, SC-08). Kept apart from
+ * `agent-runner.ts` so the normalizer is unit-testable against fixtures
+ * without spawning anything; `agent-runner.ts`'s demultiplexer feeds this
+ * module's accumulator the same already-parsed events it routes for
+ * commands/denials, so production never parses the stream twice.
+ *
+ * The one rule every field here answers to: absent or unsupported telemetry
+ * is `{ coverage: "unavailable" }` with no `value` — never a measured zero.
+ */
+export const PROVIDER_TELEMETRY_KIND = "provider-telemetry";
+const UNAVAILABLE = { coverage: "unavailable" };
+const UNAVAILABLE_STRING = { coverage: "unavailable" };
+function observedNumber(value, unit) {
+    return { coverage: "observed", value, unit };
+}
+function estimatedNumber(value, unit) {
+    return { coverage: "estimated", value, unit };
+}
+function incompleteNumber(value, unit) {
+    return { coverage: "incomplete", value, unit };
+}
+/** Downgrades an observed/estimated tally to `incomplete` when the stream lost a mid-stream line; leaves anything already unavailable alone. */
+function maybeIncomplete(measured, corrupted) {
+    if (!corrupted || measured.coverage === "unavailable")
+        return measured;
+    return { ...measured, coverage: "incomplete" };
+}
+/**
+ * Parses `--model <value>` and `--model=<value>` out of a derived
+ * invocation's argv — free operator-authored args routinely carry an
+ * explicit model override even though `AgentConfig` has no dedicated model
+ * property (SC-05).
+ */
+export function parseConfiguredModel(args) {
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === undefined)
+            continue;
+        const next = args[i + 1];
+        if (arg === "--model" && typeof next === "string") {
+            return { coverage: "observed", value: next };
+        }
+        if (arg.startsWith("--model=")) {
+            return { coverage: "observed", value: arg.slice("--model=".length) };
+        }
+    }
+    return UNAVAILABLE_STRING;
+}
+/**
+ * A coarse provider label derived from the configured command when the
+ * stream itself exposes no model — an inference from the invocation, never
+ * a provider-reported fact, hence `"estimated"`.
+ */
+export function providerLabelFromCommand(command) {
+    if (command === undefined || command.trim() === "")
+        return UNAVAILABLE_STRING;
+    const base = command
+        .replaceAll("\\", "/")
+        .split("/")
+        .pop()
+        ?.replace(/\.(cmd|exe|bat|sh)$/iu, "");
+    if (base === undefined || base.trim() === "")
+        return UNAVAILABLE_STRING;
+    return { coverage: "estimated", value: base };
+}
+/** The text of a `tool_result` block, whether the CLI sent it as a string or as content blocks. */
+function toolResultBytes(block) {
+    if (typeof block.content === "string")
+        return Buffer.byteLength(block.content, "utf8");
+    if (Array.isArray(block.content)) {
+        const texts = block.content
+            .filter((part) => part?.type === "text" && typeof part.text === "string")
+            .map((part) => part.text);
+        if (texts.length === 0)
+            return undefined;
+        return Buffer.byteLength(texts.join("\n"), "utf8");
+    }
+    return undefined;
+}
+const FILE_TOOL_KEYS = { Read: "reads", Write: "writes", Edit: "edits" };
+/**
+ * A pure, non-throwing, stateful accumulator fed one already-parsed
+ * stream-json event at a time. `agent-runner.ts`'s demultiplexer routes each
+ * event to both its own command/denial routing and this accumulator's
+ * `observeEvent`, so the underlying text is parsed exactly once in
+ * production; `normalizeClaudeTelemetry` below wraps the same accumulator
+ * with its own line-splitting for standalone fixture-driven tests.
+ */
+export function createTelemetryAccumulator(options) {
+    let streamModel;
+    let toolCallCount = 0;
+    let reads = 0;
+    let writes = 0;
+    let edits = 0;
+    let commandOutputBytes = 0;
+    let hadOrphanToolResult = false;
+    const toolNameById = new Map();
+    let reasoningTokens;
+    const compactions = [];
+    // Final `result`-event figures, captured once.
+    let sawResultEvent = false;
+    let inputTokens;
+    let outputTokens;
+    let cacheReadTokens;
+    let cacheCreationTokens;
+    let numTurns;
+    let costUsd;
+    let contextCapacityTokens;
+    let peakContextOccupancy;
+    function observeEvent(event) {
+        try {
+            if (event === null || typeof event !== "object")
+                return;
+            const record = event;
+            if (record.type === "system" && record.subtype === "init") {
+                if (typeof record.model === "string")
+                    streamModel = record.model;
+                return;
+            }
+            if (record.type === "system" && record.subtype === "thinking_tokens") {
+                if (typeof record.estimated_tokens === "number")
+                    reasoningTokens = record.estimated_tokens;
+                return;
+            }
+            if (record.type === "system" && record.subtype === "compact_boundary") {
+                const preTokens = typeof record.pre_tokens === "number" ? observedNumber(record.pre_tokens, "tokens") : UNAVAILABLE;
+                let at = UNAVAILABLE;
+                if (typeof record.timestamp === "string") {
+                    const parsed = Date.parse(record.timestamp);
+                    if (!Number.isNaN(parsed))
+                        at = observedNumber(parsed, "ms-since-epoch");
+                }
+                else if (typeof record.turn === "number") {
+                    at = observedNumber(record.turn, "turn");
+                }
+                compactions.push({ tokensBefore: preTokens, at });
+                return;
+            }
+            if (record.type === "assistant") {
+                const content = record.message?.content;
+                if (Array.isArray(content)) {
+                    for (const block of content) {
+                        if (block?.type !== "tool_use")
+                            continue;
+                        toolCallCount += 1;
+                        const name = typeof block.name === "string" ? block.name : undefined;
+                        const id = typeof block.id === "string" ? block.id : undefined;
+                        if (name !== undefined && id !== undefined)
+                            toolNameById.set(id, name);
+                        if (name !== undefined && name in FILE_TOOL_KEYS) {
+                            const key = FILE_TOOL_KEYS[name];
+                            if (key === "reads")
+                                reads += 1;
+                            else if (key === "writes")
+                                writes += 1;
+                            else
+                                edits += 1;
+                        }
+                    }
+                }
+                return;
+            }
+            if (record.type === "user") {
+                const content = record.message?.content;
+                if (Array.isArray(content)) {
+                    for (const block of content) {
+                        if (block?.type !== "tool_result")
+                            continue;
+                        const toolUseId = typeof block.tool_use_id === "string" ? block.tool_use_id : undefined;
+                        const toolName = toolUseId === undefined ? undefined : toolNameById.get(toolUseId);
+                        if (toolName === undefined) {
+                            hadOrphanToolResult = true;
+                            continue;
+                        }
+                        if (toolName !== "Bash")
+                            continue;
+                        const bytes = toolResultBytes(block);
+                        if (bytes !== undefined)
+                            commandOutputBytes += bytes;
+                    }
+                }
+                return;
+            }
+            if (record.type === "result") {
+                sawResultEvent = true;
+                if (typeof record.num_turns === "number")
+                    numTurns = record.num_turns;
+                if (typeof record.total_cost_usd === "number")
+                    costUsd = record.total_cost_usd;
+                const usage = record.usage;
+                if (usage) {
+                    if (typeof usage.input_tokens === "number")
+                        inputTokens = usage.input_tokens;
+                    if (typeof usage.output_tokens === "number")
+                        outputTokens = usage.output_tokens;
+                    if (typeof usage.cache_read_input_tokens === "number")
+                        cacheReadTokens = usage.cache_read_input_tokens;
+                    if (typeof usage.cache_creation_input_tokens === "number") {
+                        cacheCreationTokens = usage.cache_creation_input_tokens;
+                    }
+                    const iterations = usage.iterations;
+                    if (Array.isArray(iterations)) {
+                        let peak;
+                        let anyIterationPartial = false;
+                        for (const iteration of iterations) {
+                            const fields = [
+                                iteration.input_tokens,
+                                iteration.output_tokens,
+                                iteration.cache_read_input_tokens,
+                                iteration.cache_creation_input_tokens,
+                            ];
+                            // An iteration exposing none of the four occupancy fields (e.g.
+                            // `{}`) contributes no usable measurement at all — folding it
+                            // in via numberOr0 would invent a fabricated 0 that could win
+                            // the max, misreporting "the provider observed zero occupancy"
+                            // for an iteration the provider told us nothing about. Skip it
+                            // rather than let it participate in the max.
+                            if (!fields.some((field) => typeof field === "number")) {
+                                anyIterationPartial = true;
+                                continue;
+                            }
+                            // An iteration with only *some* of the four fields present is
+                            // still counted (using 0 for the fields it does lack), but the
+                            // result can undercount that iteration's true occupancy, so the
+                            // overall peak is downgraded to "incomplete" rather than
+                            // "observed" below.
+                            if (!fields.every((field) => typeof field === "number"))
+                                anyIterationPartial = true;
+                            const occupancy = fields.reduce((sum, field) => sum + numberOr0(field), 0);
+                            if (peak === undefined || occupancy > peak)
+                                peak = occupancy;
+                        }
+                        if (peak !== undefined)
+                            peakContextOccupancy = { value: peak, incomplete: anyIterationPartial };
+                    }
+                }
+                const modelUsage = record.modelUsage;
+                if (modelUsage) {
+                    const key = streamModel !== undefined && modelUsage[streamModel] ? streamModel : Object.keys(modelUsage)[0];
+                    const entry = key === undefined ? undefined : modelUsage[key];
+                    if (entry && typeof entry.contextWindow === "number")
+                        contextCapacityTokens = entry.contextWindow;
+                    if (costUsd === undefined && entry && typeof entry.costUSD === "number")
+                        costUsd = entry.costUSD;
+                }
+            }
+        }
+        catch {
+            // The accumulator is total and non-throwing (SC-13): one malformed
+            // event never poisons every fact collected so far.
+        }
+    }
+    function finish(flags) {
+        // Model/provider precedence (SC-05) does not gate on whether the stream
+        // itself parsed: `streamModel` is only ever set from an observed stream,
+        // so this is a no-op widening for the observed branch and, for a
+        // non-NDJSON or crashed spawn, still honors an explicit `--model` in the
+        // invocation args and a command-derived provider guess rather than
+        // discarding facts the invocation itself already gave us.
+        const model = streamModel !== undefined
+            ? { coverage: "observed", value: streamModel }
+            : options.configuredModel.value !== undefined
+                ? { coverage: "observed", value: options.configuredModel.value }
+                : UNAVAILABLE_STRING;
+        const provider = streamModel !== undefined ? { coverage: "observed", value: "claude" } : options.commandProviderGuess;
+        if (!flags.observed) {
+            return {
+                provider,
+                model,
+                configuredModel: options.configuredModel,
+                inputTokens: UNAVAILABLE,
+                outputTokens: UNAVAILABLE,
+                cacheReadTokens: UNAVAILABLE,
+                cacheCreationTokens: UNAVAILABLE,
+                reasoningTokens: UNAVAILABLE,
+                contextCapacityTokens: UNAVAILABLE,
+                peakContextOccupancyTokens: UNAVAILABLE,
+                compactions: [],
+                compactionCount: UNAVAILABLE,
+                continuationTurns: UNAVAILABLE,
+                toolCalls: UNAVAILABLE,
+                fileActivity: { reads: UNAVAILABLE, writes: UNAVAILABLE, edits: UNAVAILABLE },
+                commandOutputBytes: UNAVAILABLE,
+            };
+        }
+        const commandOutputIncomplete = flags.corrupted && hadOrphanToolResult;
+        return {
+            provider,
+            model,
+            configuredModel: options.configuredModel,
+            inputTokens: sawResultEvent && inputTokens !== undefined ? observedNumber(inputTokens, "tokens") : UNAVAILABLE,
+            outputTokens: sawResultEvent && outputTokens !== undefined ? observedNumber(outputTokens, "tokens") : UNAVAILABLE,
+            cacheReadTokens: sawResultEvent && cacheReadTokens !== undefined ? observedNumber(cacheReadTokens, "tokens") : UNAVAILABLE,
+            cacheCreationTokens: sawResultEvent && cacheCreationTokens !== undefined
+                ? observedNumber(cacheCreationTokens, "tokens")
+                : UNAVAILABLE,
+            reasoningTokens: reasoningTokens !== undefined ? estimatedNumber(reasoningTokens, "tokens") : UNAVAILABLE,
+            contextCapacityTokens: contextCapacityTokens !== undefined ? observedNumber(contextCapacityTokens, "tokens") : UNAVAILABLE,
+            peakContextOccupancyTokens: peakContextOccupancy === undefined
+                ? UNAVAILABLE
+                : peakContextOccupancy.incomplete
+                    ? incompleteNumber(peakContextOccupancy.value, "tokens")
+                    : observedNumber(peakContextOccupancy.value, "tokens"),
+            compactions,
+            compactionCount: compactions.length > 0 ? observedNumber(compactions.length, "count") : UNAVAILABLE,
+            continuationTurns: sawResultEvent && numTurns !== undefined ? observedNumber(numTurns, "count") : UNAVAILABLE,
+            toolCalls: maybeIncomplete(observedNumber(toolCallCount, "count"), flags.corrupted),
+            fileActivity: {
+                reads: maybeIncomplete(observedNumber(reads, "count"), flags.corrupted),
+                writes: maybeIncomplete(observedNumber(writes, "count"), flags.corrupted),
+                edits: maybeIncomplete(observedNumber(edits, "count"), flags.corrupted),
+            },
+            commandOutputBytes: commandOutputIncomplete
+                ? incompleteNumber(commandOutputBytes, "bytes")
+                : observedNumber(commandOutputBytes, "bytes"),
+            ...(costUsd !== undefined ? { costUsd: observedNumber(costUsd, "usd") } : {}),
+        };
+    }
+    return { observeEvent, finish };
+}
+function numberOr0(value) {
+    return typeof value === "number" ? value : 0;
+}
+/**
+ * Demultiplexes a whole captured stream-json string in one call, purely for
+ * fixture-driven tests — production feeds `createTelemetryAccumulator`
+ * directly from `agent-runner.ts`'s single event-parsing pass so the raw
+ * text is never parsed twice.
+ */
+export function normalizeClaudeTelemetry(raw, options = {}) {
+    const accumulator = createTelemetryAccumulator({
+        configuredModel: parseConfiguredModel(options.configuredArgs ?? []),
+        commandProviderGuess: providerLabelFromCommand(options.command),
+    });
+    let firstLineSeen = false;
+    let isNdjson = true;
+    let corrupted = false;
+    for (const rawLine of raw.split("\n")) {
+        const line = rawLine.trim();
+        if (line === "")
+            continue;
+        if (!firstLineSeen) {
+            firstLineSeen = true;
+            try {
+                accumulator.observeEvent(JSON.parse(line));
+            }
+            catch {
+                isNdjson = false;
+            }
+            continue;
+        }
+        if (!isNdjson)
+            break;
+        try {
+            accumulator.observeEvent(JSON.parse(line));
+        }
+        catch {
+            corrupted = true;
+        }
+    }
+    return accumulator.finish({ observed: firstLineSeen && isNdjson, corrupted });
+}
+/** One point per SC-08-enumerated metric, scalar and coverage-labelled, never a fabricated zero for a metric the stream did not expose. */
+export function providerTelemetryPoints(telemetry, dimensions, evidence) {
+    const points = [];
+    const stringPoint = (label, fact, detailOverride) => {
+        points.push({
+            kind: PROVIDER_TELEMETRY_KIND,
+            label,
+            coverage: fact.coverage,
+            ...(detailOverride !== undefined
+                ? { detail: detailOverride }
+                : fact.value !== undefined
+                    ? { detail: fact.value }
+                    : {}),
+            dimensions,
+            evidence,
+        });
+    };
+    const numberPoint = (label, fact) => {
+        points.push({
+            kind: PROVIDER_TELEMETRY_KIND,
+            label,
+            coverage: fact.coverage,
+            ...(fact.value === undefined ? {} : { value: fact.value }),
+            ...(fact.unit === undefined ? {} : { unit: fact.unit }),
+            dimensions,
+            evidence,
+        });
+    };
+    stringPoint("provider", telemetry.provider);
+    const modelMismatch = telemetry.model.value !== undefined &&
+        telemetry.configuredModel.value !== undefined &&
+        telemetry.model.value !== telemetry.configuredModel.value;
+    stringPoint("model", telemetry.model, modelMismatch
+        ? `${telemetry.model.value} (configured invocation specified ${telemetry.configuredModel.value})`
+        : undefined);
+    stringPoint("configured-model", telemetry.configuredModel);
+    numberPoint("input-tokens", telemetry.inputTokens);
+    numberPoint("output-tokens", telemetry.outputTokens);
+    numberPoint("cache-read-tokens", telemetry.cacheReadTokens);
+    numberPoint("cache-creation-tokens", telemetry.cacheCreationTokens);
+    numberPoint("reasoning-tokens", telemetry.reasoningTokens);
+    numberPoint("context-capacity-tokens", telemetry.contextCapacityTokens);
+    numberPoint("peak-context-occupancy-tokens", telemetry.peakContextOccupancyTokens);
+    numberPoint("continuation-turns", telemetry.continuationTurns);
+    numberPoint("tool-calls", telemetry.toolCalls);
+    numberPoint("file-activity-reads", telemetry.fileActivity.reads);
+    numberPoint("file-activity-writes", telemetry.fileActivity.writes);
+    numberPoint("file-activity-edits", telemetry.fileActivity.edits);
+    numberPoint("command-output-bytes", telemetry.commandOutputBytes);
+    numberPoint("compaction-count", telemetry.compactionCount);
+    if (telemetry.costUsd !== undefined)
+        numberPoint("cost-usd", telemetry.costUsd);
+    for (const occurrence of telemetry.compactions) {
+        numberPoint("compaction-tokens-before", occurrence.tokensBefore);
+        numberPoint("compaction-at", occurrence.at);
+    }
+    return points;
+}
+//# sourceMappingURL=provider-telemetry.js.map

package/dist/provider-telemetry.js.map

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

package/dist/review-pass.d.ts

@@ -49,8 +49,30 @@ export type FindingDestination = "decision-oneway" | "decision" | "report";
  * advisory -> "report"
  */
 export declare function findingDestination(severity: Severity): FindingDestination;
-export declare const REVIEW_ROUND_CAP = 2;
-export type StopReason = "converged" | "cap-reached" | "reviewer-error" | "no-reviewer";
+/** Test critique gets one reviewer-then-fix cycle at every size (SC-16). */
+export declare const TEST_CRITIQUE_CYCLES = 1;
+export type WorkstreamSize = "S" | "M" | "L";
+/**
+ * Total, never-throwing normalization of the manifest's optional free-string
+ * `size` (`manifest.ts`). Accepts the `plan-program` skill's `S`/`M`/`L` in
+ * any case with surrounding whitespace, and the long forms a human might
+ * type by hand. Anything else — absent, empty, "XL", a sentence — is M, the
+ * middle, because an unknown size must not silently buy or lose a cycle.
+ */
+export declare function normalizeWorkstreamSize(size: string | undefined): WorkstreamSize;
+/**
+ * The spec-critique cycle budget and the sentence the run report prints to
+ * disclose it (SC-16). Constants, never config keys.
+ *   S, M -> 1  "size S — one reviewer-then-fix cycle (S and M get one, L gets two)"
+ *   L    -> 2  "size L — two reviewer-then-fix cycles"
+ */
+export declare function specCritiqueBudget(size: string | undefined): {
+    cycles: number;
+    note: string;
+};
+/** Test critique's cycle budget note — the constant string every size shares (SC-16). */
+export declare const TEST_CRITIQUE_CYCLE_NOTE = "one cycle for every size";
+export type StopReason = "converged" | "cycles-spent" | "reviewer-error" | "no-reviewer";
 export interface ReviewRoundResult {
     findings: Finding[];
     errors: string[];
@@ -65,13 +87,29 @@ export interface ReviewPassOutcome {
     errors: string[];
     writerNotes: string[];
     severityCounts: Record<Severity, number>;
+    /** Fix passes actually spawned — 0 on a converged or errored pass. */
+    fixesRun: number;
+    /** The cycle budget this pass was given (SC-16). */
+    cyclesAllotted: number;
+    /** Why that budget, in human words: "size M", "one cycle for every size". */
+    cycleNote: string;
+    /**
+     * True when the findings in `open` were read by a reviewer *after* the
+     * last fix — i.e. `open` is a residue rather than a raised set. Under this
+     * workstream's loop that holds only when the pass converged or errored
+     * without fixing.
+     */
+    openReReadAfterFix: boolean;
 }
 export interface RunReviewPassOptions {
-    cap?: number;
-    /** Invoke the reviewer for round `n`; parse and return its findings. Stage-owned. */
-    review: (round: number, priorOpen: Finding[]) => Promise<ReviewRoundResult>;
-    /** Re-brief the writer with this round's findings; return its prose reply. Stage-owned. */
-    respond: (round: number, findings: Finding[]) => Promise<{
+    /** How many reviewer-then-fix cycles this pass is allotted (§3.7). */
+    cycles: number;
+    /** Why that number, in human words, for the report — e.g. "size M". */
+    cycleNote: string;
+    /** Invoke the reviewer for cycle `n`; parse and return its findings. Stage-owned. */
+    review: (cycle: number, priorOpen: Finding[]) => Promise<ReviewRoundResult>;
+    /** Triage-and-fix. Stage-owned. */
+    respond: (cycle: number, findings: Finding[]) => Promise<{
         note?: string;
     }>;
 }
@@ -89,8 +127,12 @@ export declare function findingsToLedgerEvents(options: FindingsToLedgerOptions)
 /**
  * A human-facing summary of one completed (or absent) pass, for the run
  * report. `label` is the pass name the stage supplies ("Spec critique",
- * "Test critique"). Returns markdown lines; the caller splices them under
- * its own section heading.
+ * "Test critique"). `verifyStepLabel` names what ends each cycle — "runner
+ * verify" (the configured verify suite, the build side) or "runner spec
+ * check" (the runner's own deterministic artifact/scope/change gate, the
+ * authoring side, §3.7.3) — defaulting to the build side's phrase since that
+ * is the more common caller. Returns markdown lines; the caller splices them
+ * under its own section heading.
  */
-export declare function renderPassReport(label: string, outcome: ReviewPassOutcome): string[];
+export declare function renderPassReport(label: string, outcome: ReviewPassOutcome, verifyStepLabel?: string): string[];
 //# sourceMappingURL=review-pass.d.ts.map