@wildorder/nightshift 0.16.0 → 0.17.0

package/dist/run-analytics.d.ts.map

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

package/dist/run-analytics.js

@@ -0,0 +1,545 @@
+import { randomBytes } from "node:crypto";
+import { appendFile, mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { z } from "zod";
+/**
+ * The versioned, provider-neutral run-observation contract (WS-01). This
+ * module defines the schema, the stage-to-bucket mapping, the injectable
+ * clock, the recorder, and the atomic persistence boundary — it emits no
+ * per-stage spans of its own beyond a handful of reference spans proving the
+ * API end-to-end (see the WS-01/WS-02 emission-boundary decision). WS-02
+ * instruments the full run lifecycle against this contract; WS-03 attaches
+ * provider/prompt facts; WS-04 aggregates; WS-05 interprets.
+ */
+/** Bumped only when the shape of the finalized artifact changes incompatibly. */
+export const RUN_ANALYTICS_SCHEMA_VERSION = 1;
+/** The closed top-level attribution taxonomy — a new bucket is a plan change. */
+export const BUCKETS = [
+    "preflight",
+    "authoring",
+    "implementation",
+    "verification",
+    "review-and-decisions",
+    "recovery-and-fixes",
+    "git-and-persistence",
+    "whole-program-review",
+    "reporting",
+    "unattributed",
+];
+export const bucketSchema = z.enum(BUCKETS);
+/**
+ * The closed set of concrete operations, each mapping to exactly one bucket.
+ * WS-02 emits stages; WS-04 reads buckets; both import this exact table so
+ * they cannot drift ("same stage, different bucket" is closed by
+ * construction). Bar one exception, there is no `unattributed` stage:
+ * `unattributed` is normally a residual WS-04 computes as elapsed time minus
+ * the union of known top-level spans, never emitted by an instrumentation
+ * site. The exception is `"run"` itself (below) — a single, WS-01-owned span
+ * opened once per run, never an ad hoc WS-02 filler, whose entire purpose is
+ * to prove full temporal coverage from run start onward by parenting every
+ * other span; once WS-04 subtracts the union of its children, what remains
+ * of its own duration is, by construction, exactly the residual its bucket
+ * already names.
+ */
+export const STAGE_BUCKET = {
+    run: "unattributed",
+    "prerequisite-check": "preflight",
+    "baseline-verification": "preflight",
+    author: "authoring",
+    "re-author": "authoring",
+    "spec-critique": "authoring",
+    implementer: "implementation",
+    recovery: "implementation",
+    "informed-retry": "implementation",
+    "verification-command": "verification",
+    "test-critique": "review-and-decisions",
+    "decision-review": "review-and-decisions",
+    "finding-triage": "review-and-decisions",
+    "causal-analysis": "review-and-decisions",
+    "failure-diagnosis": "recovery-and-fixes",
+    "fix-now": "recovery-and-fixes",
+    "test-critique-fix": "recovery-and-fixes",
+    "manifest-persist": "git-and-persistence",
+    "ledger-persist": "git-and-persistence",
+    "analytics-persist": "git-and-persistence",
+    "git-diff": "git-and-persistence",
+    "git-commit": "git-and-persistence",
+    "whole-program-review": "whole-program-review",
+    "as-built-snapshot": "whole-program-review",
+    "report-assembly": "reporting",
+    "report-commit": "reporting",
+};
+const STAGES = Object.keys(STAGE_BUCKET);
+export const stageSchema = z.enum(STAGES);
+/** The observability label every measurement carries; absent telemetry is `unavailable`, never a measured zero. */
+export const COVERAGE_VALUES = ["observed", "estimated", "unavailable", "incomplete"];
+export const coverageSchema = z.enum(COVERAGE_VALUES);
+/**
+ * Documented, non-exhaustive outcome vocabulary (SC-04): `outcome` is an open
+ * `z.string()` so a future outcome (e.g. a timeout) can be added without a
+ * schema version bump. This is documentation and a lint target, never a gate
+ * — an unknown outcome string still validates and round-trips.
+ */
+export const KNOWN_OUTCOMES = [
+    "success",
+    "failed",
+    "discarded",
+    "no-op",
+    "skipped",
+    "interrupted",
+];
+/** The only evidence locality WS-01 defines: a build-logs reference resolves only on the machine that ran. */
+export const evidenceReferenceSchema = z.object({
+    kind: z.enum(["transcript", "ledger-event", "commit", "diagnosis"]),
+    locality: z.literal("local"),
+    ref: z.string(),
+    note: z.string().optional(),
+});
+const agentRoleSchema = z.enum([
+    "agent",
+    "recoveryAgent",
+    "authorAgent",
+    "deciderAgent",
+    "reviewerAgent",
+]);
+/** The stable facts attached to an interval or point. Provider/model identity is deliberately absent — WS-03's sole home. */
+export const dimensionsSchema = z.object({
+    stage: stageSchema,
+    workstream: z.string().optional(),
+    role: agentRoleSchema.optional(),
+    attemptSeat: z.string().optional(),
+    attemptIndex: z.number().optional(),
+    attemptReason: z.string().optional(),
+    verifyCommand: z.string().optional(),
+    outcome: z.string().optional(),
+    evidence: z.array(evidenceReferenceSchema).optional(),
+});
+const partialDimensionsSchema = dimensionsSchema.partial();
+/**
+ * An interval observation — the unit that carries wall-clock time. The
+ * schema permits overlapping spans (a parent and its children overlap by
+ * construction); WS-01 validates only the local invariants (bucket matches
+ * stage, end >= start when present, parentId resolves within the artifact).
+ * WS-04 owns interval-union conservation and rejecting double-counted
+ * overlaps at the top level.
+ */
+export const spanSchema = z
+    .object({
+    id: z.string(),
+    parentId: z.string().optional(),
+    stage: stageSchema,
+    bucket: bucketSchema,
+    startOffsetMs: z.number(),
+    /**
+     * Absent means this span's true end was not observed by finalize time.
+     * Usually that is a crashed/interrupted span, but the runner's own
+     * top-level `run` span and its `report-commit` child are open by design
+     * on every run, crashed or not: both close only after `finalize()` has
+     * already persisted this very artifact, so their real end can never be
+     * captured inside the file they are committed in.
+     */
+    endOffsetMs: z.number().optional(),
+    dimensions: dimensionsSchema,
+})
+    .refine((span) => STAGE_BUCKET[span.stage] === span.bucket, {
+    message: "bucket must equal STAGE_BUCKET[stage]",
+    path: ["bucket"],
+})
+    .refine((span) => span.endOffsetMs === undefined || span.endOffsetMs >= span.startOffsetMs, { message: "endOffsetMs must be >= startOffsetMs", path: ["endOffsetMs"] });
+/**
+ * A fact measured at an instant, not an interval. `kind` is an open string
+ * for the same forward-compatibility reason as `outcome`.
+ *
+ * `label` and `detail` are WS-03's sole, additive amendment to this schema
+ * (see the `scalar-points-plus-additive-fields` decision): `label` names the
+ * specific metric or prompt component a point measures (e.g.
+ * `"input-tokens"`, `"model"`, `"roster"`), and `detail` carries a
+ * string-valued fact — an exact model identity, a provider label, a
+ * comma-joined demoted-dependency id list — when the measurement is not
+ * numeric. Both are optional and unconstrained by an enum, so every existing
+ * point (and every WS-01 fixture) round-trips unchanged.
+ */
+export const pointObservationSchema = z.object({
+    id: z.string(),
+    atOffsetMs: z.number(),
+    kind: z.string(),
+    coverage: coverageSchema,
+    value: z.number().optional(),
+    unit: z.string().optional(),
+    label: z.string().optional(),
+    detail: z.string().optional(),
+    dimensions: partialDimensionsSchema.optional(),
+    evidence: z.array(evidenceReferenceSchema).optional(),
+});
+/**
+ * States the window the reconciled numbers cover: run start through the
+ * pre-render analytics snapshot taken just before `finalize()` persists this
+ * artifact and the report is written and committed (SC-03, SC-14). The
+ * report-write/commit tail is unobservable from inside the artifact — the
+ * `run` and `report-commit` spans stay open and the tail lands as a sidecar
+ * point — and publish runs after the CLI's run call returns. Adopted by
+ * human ruling (decisions 062f9cc308fe22fa, 987817d69c457259).
+ */
+export const AGGREGATION_BOUNDARY = "run-start-to-pre-render-snapshot";
+export const runAnalyticsSchema = z
+    .object({
+    // A literal, not z.number(): SC-01 promises one validated versioned
+    // contract, so an artifact stamped with any other schemaVersion — an
+    // unsupported future format, a corrupted file, a stale format after a
+    // real bump — fails validation outright rather than silently parsing as
+    // if it were this version. readPriorRunId relies on exactly this to
+    // never adopt lineage from a schema it does not understand.
+    schemaVersion: z.literal(RUN_ANALYTICS_SCHEMA_VERSION),
+    identity: z.object({
+        runId: z.string(),
+        parentRunId: z.string().optional(),
+        programId: z.string(),
+    }),
+    anchors: z.object({
+        startedAt: z.string(),
+        monotonicAnchorMs: z.number(),
+        finalizedAt: z.string().optional(),
+        finalizedOffsetMs: z.number().optional(),
+    }),
+    aggregationBoundary: z.literal(AGGREGATION_BOUNDARY),
+    spans: z.array(spanSchema),
+    points: z.array(pointObservationSchema),
+})
+    .superRefine((artifact, ctx) => {
+    const ids = new Set(artifact.spans.map((span) => span.id));
+    artifact.spans.forEach((span, index) => {
+        if (span.parentId !== undefined && !ids.has(span.parentId)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `parentId "${span.parentId}" does not resolve to another span in this artifact`,
+                path: ["spans", index, "parentId"],
+            });
+        }
+    });
+});
+/** Mirrors `runReportPath` — the one canonical location for a program's analytics artifact. */
+export function runAnalyticsPath(root, programId) {
+    return join(resolve(root), "docs", "programs", `${programId}-run-analytics.json`);
+}
+/** The gitignored crash-durability sidecar (see the incremental-durability decision); never read back by this module. */
+function runAnalyticsSidecarPath(root, programId) {
+    return join(resolve(root), "build-logs", programId, "run-analytics.jsonl");
+}
+function randomId() {
+    return randomBytes(8).toString("hex");
+}
+/**
+ * Write-temp-then-rename in the same directory as the target. Same-directory
+ * rename is atomic on POSIX and, via libuv's `MOVEFILE_REPLACE_EXISTING`,
+ * replaces atomically on Windows too — a crash mid-write can never leave a
+ * half-written artifact; a reader sees either the old file or the new one.
+ */
+async function atomicWriteFile(path, contents) {
+    await mkdir(dirname(path), { recursive: true });
+    const tmp = join(dirname(path), `.${randomId()}.tmp-${randomId()}`);
+    await writeFile(tmp, contents, "utf8");
+    try {
+        await rename(tmp, path);
+    }
+    catch (error) {
+        // A failed rename must never leave an orphaned temp file behind for a
+        // later `docs/programs` commit to sweep up as an untracked artifact.
+        await rm(tmp, { force: true }).catch(() => undefined);
+        throw error;
+    }
+}
+/**
+ * Reads any prior finalized artifact for `programId` purely to source
+ * `parentRunId` — a plain read with no durable effect, safe before the
+ * could-not-start gate. Absent, unreadable, or invalid prior artifacts all
+ * resolve to `undefined` (fail open): a missing lineage is not a reason to
+ * fail a run.
+ */
+export async function readPriorRunId(root, programId) {
+    try {
+        const raw = await readFile(runAnalyticsPath(root, programId), "utf8");
+        const parsed = runAnalyticsSchema.safeParse(JSON.parse(raw));
+        return parsed.success ? parsed.data.identity.runId : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Records a run's spans and point observations and persists them
+ * fail-open. Created at run start so pre-gate stages (preflight, baseline
+ * verification) can be buffered in memory; stays disarmed — writing nothing
+ * durable — until `arm()` is called immediately after the could-not-start
+ * gate. Every method is non-throwing: a malformed observation is diagnosed
+ * and dropped, a persistence failure is diagnosed and swallowed, and nothing
+ * here can change a run's outcome, exit code, status, or report.
+ */
+export class RunRecorder {
+    runId;
+    clock;
+    root;
+    programId;
+    parentRunIdValue;
+    log;
+    monotonicAnchorMs;
+    startedAt;
+    permanentlyDisarmed;
+    armed = false;
+    finalized = false;
+    spans = [];
+    points = [];
+    openStack = [];
+    sidecarQueue = Promise.resolve();
+    constructor(opts) {
+        this.clock = opts.clock;
+        this.root = opts.root;
+        this.programId = opts.programId;
+        this.parentRunIdValue = opts.parentRunId;
+        this.log = opts.log;
+        this.permanentlyDisarmed = opts.permanentlyDisarmed ?? false;
+        this.startedAt = opts.clock.now().toISOString();
+        this.runId = this.startedAt;
+        this.monotonicAnchorMs = opts.clock.monotonic();
+    }
+    static create(opts) {
+        return new RunRecorder(opts);
+    }
+    /**
+     * Enables durable writes. Idempotent; intended to be called once,
+     * immediately after the could-not-start gate. A no-op on a
+     * permanently-disarmed instance ({@link NOOP_RUN_RECORDER}) — WS-02's
+     * `RunProgramOptions.recorder` test seam lets a caller inject that shared
+     * singleton straight into a real run, and `runProgramWith` calls `arm()`
+     * unconditionally on whatever recorder it holds, so this guard is what
+     * keeps that injection from durably arming — and thereby writing through
+     * — the one instance every other no-recorder caller also depends on
+     * staying inert.
+     */
+    arm() {
+        if (this.permanentlyDisarmed)
+            return;
+        this.armed = true;
+    }
+    /** Opens a span; the currently open span (if any) becomes its parent automatically. */
+    span(dims) {
+        return this.openSpan(dims, this.openStack[this.openStack.length - 1]?.id);
+    }
+    point(obs) {
+        try {
+            const point = {
+                id: randomId(),
+                atOffsetMs: this.elapsedMs(),
+                kind: obs.kind,
+                coverage: obs.coverage,
+                ...(obs.value === undefined ? {} : { value: obs.value }),
+                ...(obs.unit === undefined ? {} : { unit: obs.unit }),
+                ...(obs.label === undefined ? {} : { label: obs.label }),
+                ...(obs.detail === undefined ? {} : { detail: obs.detail }),
+                ...(obs.dimensions === undefined ? {} : { dimensions: obs.dimensions }),
+                ...(obs.evidence === undefined ? {} : { evidence: obs.evidence }),
+            };
+            const parsed = pointObservationSchema.safeParse(point);
+            if (!parsed.success) {
+                this.diagnose(`dropped malformed point observation: ${parsed.error.message}`);
+                return;
+            }
+            this.points.push(parsed.data);
+            this.appendSidecar({ kind: "point", point: parsed.data });
+        }
+        catch (error) {
+            this.diagnose(`point record failed: ${error.message}`);
+        }
+    }
+    /**
+     * Builds the in-memory buffer (including any span still open — a
+     * crashed/interrupted span composes with no `endOffsetMs`) into a
+     * `RunAnalytics` shape at the given wall/monotonic instant. Shared by
+     * `finalize()` (which persists the result) and `snapshot()` (which does
+     * not), so the two can never independently drift on what "the observed
+     * artifact so far" means.
+     */
+    compose(finalizedAt, finalizedOffsetMs) {
+        return {
+            schemaVersion: RUN_ANALYTICS_SCHEMA_VERSION,
+            identity: {
+                runId: this.runId,
+                ...(this.parentRunIdValue === undefined ? {} : { parentRunId: this.parentRunIdValue }),
+                programId: this.programId,
+            },
+            anchors: {
+                startedAt: this.startedAt,
+                monotonicAnchorMs: this.monotonicAnchorMs,
+                finalizedAt,
+                finalizedOffsetMs,
+            },
+            aggregationBoundary: AGGREGATION_BOUNDARY,
+            spans: [...this.spans, ...this.openSpanSnapshots()],
+            points: this.points,
+        };
+    }
+    /**
+     * Composes the in-memory buffer into a `RunAnalytics` object, validates
+     * it, and atomically persists it. Fail-open: never throws. A no-op when
+     * not armed, or when already finalized once.
+     */
+    async finalize() {
+        if (!this.armed || this.finalized)
+            return;
+        this.finalized = true;
+        try {
+            await this.sidecarQueue.catch(() => undefined);
+            const artifact = this.compose(this.clock.now().toISOString(), this.elapsedMs());
+            const parsed = runAnalyticsSchema.safeParse(artifact);
+            if (!parsed.success) {
+                this.diagnose(`analytics artifact failed validation and was not written: ${parsed.error.message}`);
+                return;
+            }
+            await atomicWriteFile(runAnalyticsPath(this.root, this.programId), `${JSON.stringify(parsed.data, null, 2)}\n`);
+        }
+        catch (error) {
+            this.diagnose(`analytics finalize failed: ${error.message}`);
+        }
+    }
+    /**
+     * A validated in-memory view of everything observed so far, for the run
+     * report's "Where the time went" section (WS-04) — which renders before
+     * `finalize()` runs, so it cannot read the file `finalize()` writes.
+     * Read-only: composes and validates exactly as `finalize()` does but
+     * writes nothing, to the canonical artifact or the sidecar, and is safe to
+     * call before `arm()`, after `finalize()`, or any number of times.
+     * Non-throwing; returns `undefined` on any failure (fail open).
+     */
+    snapshot() {
+        try {
+            const artifact = this.compose(this.clock.now().toISOString(), this.elapsedMs());
+            const parsed = runAnalyticsSchema.safeParse(artifact);
+            return parsed.success ? parsed.data : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    elapsedMs() {
+        return this.clock.monotonic() - this.monotonicAnchorMs;
+    }
+    openSpan(dims, parentId) {
+        try {
+            const open = {
+                id: randomId(),
+                ...(parentId === undefined ? {} : { parentId }),
+                stage: dims.stage,
+                bucket: STAGE_BUCKET[dims.stage],
+                startOffsetMs: this.elapsedMs(),
+                dimensions: dims,
+            };
+            this.openStack.push(open);
+            let closed = false;
+            return {
+                close: (result) => {
+                    if (closed)
+                        return;
+                    closed = true;
+                    this.closeSpan(open, result);
+                },
+                child: (childDims) => this.openSpan(childDims, open.id),
+            };
+        }
+        catch (error) {
+            this.diagnose(`span open failed: ${error.message}`);
+            return this.inertHandle();
+        }
+    }
+    inertHandle() {
+        return { close: () => undefined, child: () => this.inertHandle() };
+    }
+    closeSpan(open, result) {
+        try {
+            const dimensions = {
+                ...open.dimensions,
+                ...(result?.outcome === undefined ? {} : { outcome: result.outcome }),
+                ...(result?.evidence === undefined ? {} : { evidence: result.evidence }),
+            };
+            const span = {
+                id: open.id,
+                ...(open.parentId === undefined ? {} : { parentId: open.parentId }),
+                stage: open.stage,
+                bucket: open.bucket,
+                startOffsetMs: open.startOffsetMs,
+                endOffsetMs: this.elapsedMs(),
+                dimensions,
+            };
+            const parsed = spanSchema.safeParse(span);
+            if (!parsed.success) {
+                this.diagnose(`dropped malformed span: ${parsed.error.message}`);
+            }
+            else {
+                this.spans.push(parsed.data);
+                this.appendSidecar({ kind: "span", span: parsed.data });
+            }
+        }
+        catch (error) {
+            this.diagnose(`span close failed: ${error.message}`);
+        }
+        finally {
+            const index = this.openStack.indexOf(open);
+            if (index >= 0)
+                this.openStack.splice(index, 1);
+        }
+    }
+    openSpanSnapshots() {
+        return this.openStack.map((open) => ({
+            id: open.id,
+            ...(open.parentId === undefined ? {} : { parentId: open.parentId }),
+            stage: open.stage,
+            bucket: open.bucket,
+            startOffsetMs: open.startOffsetMs,
+            dimensions: open.dimensions,
+        }));
+    }
+    /**
+     * Appends one JSON line to the gitignored `build-logs/` sidecar — the
+     * crash-durability layer for a hard kill that never reaches the flush
+     * seam. Queued so concurrent closes/points never interleave partial
+     * writes; a failing append is diagnosed and never breaks the queue for
+     * subsequent appends.
+     */
+    appendSidecar(entry) {
+        if (!this.armed)
+            return;
+        const path = runAnalyticsSidecarPath(this.root, this.programId);
+        const line = `${JSON.stringify(entry)}\n`;
+        this.sidecarQueue = this.sidecarQueue.then(async () => {
+            await mkdir(dirname(path), { recursive: true });
+            await appendFile(path, line, "utf8");
+        });
+        this.sidecarQueue = this.sidecarQueue.catch((error) => {
+            this.diagnose(`sidecar append failed: ${error.message}`);
+        });
+    }
+    diagnose(message) {
+        try {
+            this.log(`run-analytics: ${message}`);
+        }
+        catch {
+            // Logging must never be the reason an analytics failure escapes fail-open.
+        }
+    }
+}
+/**
+ * A shared, permanently disarmed recorder — the default for callers that
+ * have no run-scoped recorder to hand (a standalone test, the doctor probe,
+ * a fix/critique path WS-02 has not yet wired), and a valid injection
+ * straight into `RunProgramOptions.recorder` (WS-02, SC-13) for a test that
+ * wants to prove fail-open by equivalence. Buffers harmlessly in memory and
+ * never performs I/O: `permanentlyDisarmed` makes `arm()` a no-op even when
+ * a real run calls it unconditionally, so this one shared instance can never
+ * be armed by any caller, ever.
+ */
+export const NOOP_RUN_RECORDER = RunRecorder.create({
+    clock: { now: () => new Date(0), monotonic: () => 0 },
+    root: "",
+    programId: "",
+    log: () => undefined,
+    permanentlyDisarmed: true,
+});
+//# sourceMappingURL=run-analytics.js.map

package/dist/run-analytics.js.map

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