@w3kits-com/plugin-opendesign 0.1.8 → 0.1.9

package/dist/__w3kits/webcontainer-runtime/apps/daemon/dist/critique/config.js

@@ -0,0 +1,72 @@
+import { defaultCritiqueConfig, FALLBACK_POLICIES } from '@open-design/contracts/critique';
+/**
+ * Load CritiqueConfig from process.env. Keys map 1:1 to OD_CRITIQUE_*.
+ * Missing values fall back to defaultCritiqueConfig(). Invalid values
+ * (non-numeric, negative, out-of-range) throw RangeError so misconfig
+ * surfaces at boot, never silently.
+ *
+ * @see specs/current/critique-theater.md § Configuration (env vars)
+ */
+export function loadCritiqueConfigFromEnv(env = process.env) {
+    const defaults = defaultCritiqueConfig();
+    const enabled = parseEnabled(env['OD_CRITIQUE_ENABLED'], defaults.enabled);
+    const maxRounds = parsePositiveInt('OD_CRITIQUE_MAX_ROUNDS', env['OD_CRITIQUE_MAX_ROUNDS'], defaults.maxRounds);
+    const scoreThreshold = parseNonNegativeFloat('OD_CRITIQUE_SCORE_THRESHOLD', env['OD_CRITIQUE_SCORE_THRESHOLD'], defaults.scoreThreshold);
+    const scoreScale = parsePositiveInt('OD_CRITIQUE_SCORE_SCALE', env['OD_CRITIQUE_SCORE_SCALE'], defaults.scoreScale);
+    const perRoundTimeoutMs = parsePositiveInt('OD_CRITIQUE_PER_ROUND_TIMEOUT_MS', env['OD_CRITIQUE_PER_ROUND_TIMEOUT_MS'], defaults.perRoundTimeoutMs);
+    const totalTimeoutMs = parsePositiveInt('OD_CRITIQUE_TOTAL_TIMEOUT_MS', env['OD_CRITIQUE_TOTAL_TIMEOUT_MS'], defaults.totalTimeoutMs);
+    const parserMaxBlockBytes = parsePositiveInt('OD_CRITIQUE_PARSER_MAX_BLOCK_BYTES', env['OD_CRITIQUE_PARSER_MAX_BLOCK_BYTES'], defaults.parserMaxBlockBytes);
+    const fallbackPolicy = parseFallbackPolicy(env['OD_CRITIQUE_FALLBACK_POLICY'], defaults.fallbackPolicy);
+    // Cross-field validation: threshold cannot exceed scale.
+    if (scoreThreshold > scoreScale + 1e-9) {
+        throw new RangeError(`OD_CRITIQUE_SCORE_THRESHOLD (${scoreThreshold}) must be <= OD_CRITIQUE_SCORE_SCALE (${scoreScale})`);
+    }
+    return {
+        ...defaults,
+        enabled,
+        maxRounds,
+        scoreThreshold,
+        scoreScale,
+        perRoundTimeoutMs,
+        totalTimeoutMs,
+        parserMaxBlockBytes,
+        fallbackPolicy,
+    };
+}
+// ---------------------------------------------------------------------------
+// Parsing helpers
+// ---------------------------------------------------------------------------
+function parseEnabled(raw, fallback) {
+    if (raw === undefined)
+        return fallback;
+    const v = raw.trim().toLowerCase();
+    return v === 'true' || v === '1' || v === 'yes';
+}
+function parsePositiveInt(key, raw, fallback) {
+    if (raw === undefined)
+        return fallback;
+    const n = Number(raw);
+    if (!Number.isFinite(n) || !Number.isInteger(n) || n < 1) {
+        throw new RangeError(`${key} must be a positive integer, got "${raw}"`);
+    }
+    return n;
+}
+function parseNonNegativeFloat(key, raw, fallback) {
+    if (raw === undefined)
+        return fallback;
+    const n = Number(raw);
+    if (!Number.isFinite(n) || n < 0) {
+        throw new RangeError(`${key} must be a non-negative finite number, got "${raw}"`);
+    }
+    return n;
+}
+function parseFallbackPolicy(raw, fallback) {
+    if (raw === undefined)
+        return fallback;
+    const trimmed = raw.trim();
+    if (FALLBACK_POLICIES.includes(trimmed)) {
+        return trimmed;
+    }
+    throw new RangeError(`OD_CRITIQUE_FALLBACK_POLICY must be one of ${FALLBACK_POLICIES.join(', ')}, got "${raw}"`);
+}
+//# sourceMappingURL=config.js.map

package/dist/__w3kits/webcontainer-runtime/apps/daemon/dist/critique/config.js.map

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

package/dist/__w3kits/webcontainer-runtime/apps/daemon/dist/critique/conformance-history.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Conformance history persistence (Phase 16).
+ *
+ * The nightly cron writes one `ConformanceDay` row per adapter per day
+ * via `appendConformanceDay`. The `/api/critique/conformance` route
+ * reads the rolling N-day window via `readConformanceHistory` and
+ * feeds it into the `evaluateRollout` ratchet.
+ *
+ * Storage shape: append-only JSON-lines under
+ * `<dataDir>/conformance/<adapter>/<date>.jsonl`. One file per adapter
+ * per day so a corrupted line in one file cannot poison the read for
+ * another adapter / another day. JSON-lines (rather than a single JSON
+ * blob) so a cron interruption mid-write leaves a recoverable file:
+ * the writer always appends complete lines, and the reader drops any
+ * line that fails to parse rather than throwing.
+ *
+ * The path layout is intentionally directory-per-adapter so a future
+ * operator action like "purge all history for adapter X" is one `rm
+ * -rf`, not a grep + rewrite across a mixed-adapter file.
+ */
+import type { ConformanceDay } from './ratchet.js';
+/**
+ * Where conformance history lives, relative to the daemon's `.od` data
+ * dir. Wrapped in a function so a future override (env var, test seam)
+ * can swap it without rewriting call sites.
+ */
+export declare function conformanceHistoryDir(dataDir: string): string;
+/**
+ * Append one conformance row to the day's file. Idempotent in the
+ * weak sense: calling twice for the same `(adapter, date)` appends two
+ * rows, and the reader keeps the last entry per (adapter, date) so a
+ * retry-after-failure cron produces the right answer. The strong-sense
+ * fix (dedupe before appending) is deliberately not v1 scope; it would
+ * require a read-modify-write cycle whose cost grows with history
+ * size.
+ */
+export declare function appendConformanceDay(dataDir: string, row: ConformanceDay): Promise<void>;
+/**
+ * Read every `ConformanceDay` row in the trailing `windowDays` ending
+ * today (inclusive). Returns rows from every adapter in arbitrary
+ * order; the evaluator aggregates them per day.
+ *
+ * Missing adapter directories, missing day files, and malformed lines
+ * all collapse to "skip this row": a cron that has not run yet for a
+ * day is data missing, not data wrong, and the evaluator handles
+ * missing days by returning `hold` (insufficient data).
+ */
+export declare function readConformanceHistory(dataDir: string, windowDays: number, now?: Date): Promise<ConformanceDay[]>;

package/dist/__w3kits/webcontainer-runtime/apps/daemon/dist/critique/conformance-history.js

@@ -0,0 +1,119 @@
+/**
+ * Conformance history persistence (Phase 16).
+ *
+ * The nightly cron writes one `ConformanceDay` row per adapter per day
+ * via `appendConformanceDay`. The `/api/critique/conformance` route
+ * reads the rolling N-day window via `readConformanceHistory` and
+ * feeds it into the `evaluateRollout` ratchet.
+ *
+ * Storage shape: append-only JSON-lines under
+ * `<dataDir>/conformance/<adapter>/<date>.jsonl`. One file per adapter
+ * per day so a corrupted line in one file cannot poison the read for
+ * another adapter / another day. JSON-lines (rather than a single JSON
+ * blob) so a cron interruption mid-write leaves a recoverable file:
+ * the writer always appends complete lines, and the reader drops any
+ * line that fails to parse rather than throwing.
+ *
+ * The path layout is intentionally directory-per-adapter so a future
+ * operator action like "purge all history for adapter X" is one `rm
+ * -rf`, not a grep + rewrite across a mixed-adapter file.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+/**
+ * Where conformance history lives, relative to the daemon's `.od` data
+ * dir. Wrapped in a function so a future override (env var, test seam)
+ * can swap it without rewriting call sites.
+ */
+export function conformanceHistoryDir(dataDir) {
+    return path.join(dataDir, 'conformance');
+}
+function isoDay(d) {
+    return d.toISOString().slice(0, 10);
+}
+function adapterDir(dataDir, adapter) {
+    return path.join(conformanceHistoryDir(dataDir), adapter);
+}
+function dayFile(dataDir, adapter, date) {
+    return path.join(adapterDir(dataDir, adapter), `${date}.jsonl`);
+}
+/**
+ * Append one conformance row to the day's file. Idempotent in the
+ * weak sense: calling twice for the same `(adapter, date)` appends two
+ * rows, and the reader keeps the last entry per (adapter, date) so a
+ * retry-after-failure cron produces the right answer. The strong-sense
+ * fix (dedupe before appending) is deliberately not v1 scope; it would
+ * require a read-modify-write cycle whose cost grows with history
+ * size.
+ */
+export async function appendConformanceDay(dataDir, row) {
+    const dir = adapterDir(dataDir, row.adapter);
+    await fs.mkdir(dir, { recursive: true });
+    const file = dayFile(dataDir, row.adapter, row.date);
+    const line = JSON.stringify(row) + '\n';
+    await fs.appendFile(file, line, 'utf8');
+}
+/**
+ * Read every `ConformanceDay` row in the trailing `windowDays` ending
+ * today (inclusive). Returns rows from every adapter in arbitrary
+ * order; the evaluator aggregates them per day.
+ *
+ * Missing adapter directories, missing day files, and malformed lines
+ * all collapse to "skip this row": a cron that has not run yet for a
+ * day is data missing, not data wrong, and the evaluator handles
+ * missing days by returning `hold` (insufficient data).
+ */
+export async function readConformanceHistory(dataDir, windowDays, now = new Date()) {
+    const root = conformanceHistoryDir(dataDir);
+    let adapters;
+    try {
+        adapters = await fs.readdir(root);
+    }
+    catch {
+        return [];
+    }
+    const dates = [];
+    for (let i = 0; i < windowDays; i++) {
+        const d = new Date(now.getTime() - i * 24 * 60 * 60 * 1000);
+        dates.push(isoDay(d));
+    }
+    const out = [];
+    for (const adapter of adapters) {
+        for (const date of dates) {
+            let body;
+            try {
+                body = await fs.readFile(dayFile(dataDir, adapter, date), 'utf8');
+            }
+            catch {
+                continue;
+            }
+            // Keep the last entry per (adapter, date) so a retry-after-failure
+            // cron produces the right answer without a dedupe pass at write
+            // time. JSON-lines are read top-down; we overwrite as we go.
+            let lastForToday = null;
+            for (const line of body.split('\n')) {
+                if (line.length === 0)
+                    continue;
+                try {
+                    const candidate = JSON.parse(line);
+                    if (candidate
+                        && typeof candidate === 'object'
+                        && typeof candidate.date === 'string'
+                        && typeof candidate.adapter === 'string'
+                        && Number.isFinite(candidate.shippedRate)
+                        && Number.isFinite(candidate.cleanParseRate)
+                        && Number.isFinite(candidate.totalRuns)) {
+                        lastForToday = candidate;
+                    }
+                }
+                catch {
+                    /* drop malformed lines */
+                }
+            }
+            if (lastForToday !== null)
+                out.push(lastForToday);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=conformance-history.js.map

package/dist/__w3kits/webcontainer-runtime/apps/daemon/dist/critique/conformance-history.js.map

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

package/dist/__w3kits/webcontainer-runtime/apps/daemon/dist/critique/conformance.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Adapter conformance harness (Phase 10).
+ *
+ * The plan asks the nightly cycle to feed every production adapter the
+ * same 10 brief templates and classify each run as `shipped`, `degraded`,
+ * or `failed`. The harness sits one level below that schedule: it knows
+ * how to take an `AsyncIterable<string>` (everything a real adapter
+ * exposes is some flavour of that, whether it's a child process's stdout
+ * or an in-process stub) plus the parser config and produce a
+ * `ConformanceOutcome`. The synthetic fixtures from
+ * `__fixtures__/adapters/` are the deterministic inputs the test
+ * harness uses; production code in `runOrchestrator` already covers
+ * the live path, so this helper exists to give CI a way to validate
+ * end-to-end shape without depending on a network model.
+ *
+ * The plan's retry budget (one retry per degraded template, two
+ * consecutive degraded counts as one failure, ≥ 90% shipped + ≥ 95%
+ * clean-parse thresholds) is intentionally NOT implemented here.
+ * Those policies live in the scheduler that calls this helper N times
+ * across the adapter × template matrix; keeping the harness scoped to
+ * a single run makes it testable in isolation.
+ *
+ * Classification rules (each row that matches wins, top to bottom):
+ *
+ *   1. The parser threw a MalformedBlockError / OversizeBlockError /
+ *      MissingArtifactError → degraded with that reason.
+ *   2. The adapter source threw any other error → failed
+ *      (`unexpected_error`).
+ *   3. The parser yielded a `parser_warning` event anywhere in the
+ *      stream (before OR after `ship`) → degraded (`parser_warning`).
+ *      The parser tolerated a soft violation (weak debate, unknown
+ *      role, clamped score, composite mismatch, duplicate ship) but
+ *      the conformance gate treats any of those as a "this adapter
+ *      is not protocol-clean" signal (lefarcen P2 on PR #1316,
+ *      tightened to post-ship warnings in lefarcen P2 on PR #1316
+ *      follow-up: the parser emits `duplicate_ship` AFTER the first
+ *      ship event yields, so the harness must drain the rest of the
+ *      stream before classifying instead of returning at first ship).
+ *   4. The parser yielded a `ship` event but the cast declared by
+ *      `run_started` did not all emit `panelist_close` IN THE
+ *      SHIPPING ROUND → degraded (`incomplete_panel`). The parser
+ *      only enforces the round-1 designer-artifact invariant; the
+ *      harness is what catches a ship that skipped panelists or
+ *      reused earlier-round closes to fake a complete cast (codex
+ *      P2 on PR #1316; per-round bucketing added in lefarcen P2 on
+ *      PR #1316 follow-up).
+ *   5. The parser yielded a `ship` event with a complete panel and no
+ *      parser warnings → shipped.
+ *   6. The stream ended without a `ship` event → failed (`no_ship`).
+ */
+import type { PanelEvent } from '@open-design/contracts/critique';
+import { type ShipArtifactPayload } from './parser.js';
+/**
+ * Local degraded reasons. `'parser_warning'` and `'incomplete_panel'`
+ * are conformance-harness-only: they describe a stream the contracts
+ * `DegradedReason` does not currently model as a discrete value. The
+ * adapter-degraded registry stores the closest contracts reason via
+ * `toContractReason` below, so a downstream listing of degraded
+ * adapters still uses the wire-shape enum.
+ */
+export type ConformanceDegradedReason = 'malformed_block' | 'oversize_block' | 'missing_artifact' | 'parser_warning' | 'incomplete_panel' | 'protocol_version_mismatch';
+export type ConformanceOutcome = {
+    kind: 'shipped';
+    round: number;
+    composite: number;
+    events: PanelEvent[];
+    /**
+     * Artifact bytes the parser handed back via the `onArtifact`
+     * callback for the SHIP event. Callers that want to pin
+     * MIME / byte-length / hash on the nightly cycle read this
+     * directly. Always set on `shipped` because the parser rejects
+     * a missing-artifact SHIP with `MissingArtifactError` upstream
+     * (lefarcen P2 on PR #1317: previously captured-but-never-
+     * returned, masked by a `void shipPayload` lint trick).
+     */
+    artifact: ShipArtifactPayload | null;
+} | {
+    kind: 'degraded';
+    reason: ConformanceDegradedReason;
+    events: PanelEvent[];
+} | {
+    kind: 'failed';
+    cause: 'no_ship' | 'unexpected_error';
+    events: PanelEvent[];
+    error?: string;
+};
+export interface RunConformanceParams {
+    adapterId: string;
+    runId: string;
+    source: AsyncIterable<string>;
+    parserMaxBlockBytes?: number;
+    projectId?: string;
+    artifactId?: string;
+}
+/**
+ * Run a synthetic (or recorded) adapter source through the parser and
+ * classify the outcome. Side-effect: when the outcome is `degraded`,
+ * the adapter is marked degraded for the default 24h TTL via
+ * `markDegraded`. The caller can flip the policy by calling
+ * `clearDegraded(adapterId)` afterwards if it wants to gate the mark
+ * on a "two consecutive failures" rule.
+ */
+export declare function runAdapterConformance(params: RunConformanceParams): Promise<ConformanceOutcome>;

package/dist/__w3kits/webcontainer-runtime/apps/daemon/dist/critique/conformance.js

@@ -0,0 +1,190 @@
+/**
+ * Adapter conformance harness (Phase 10).
+ *
+ * The plan asks the nightly cycle to feed every production adapter the
+ * same 10 brief templates and classify each run as `shipped`, `degraded`,
+ * or `failed`. The harness sits one level below that schedule: it knows
+ * how to take an `AsyncIterable<string>` (everything a real adapter
+ * exposes is some flavour of that, whether it's a child process's stdout
+ * or an in-process stub) plus the parser config and produce a
+ * `ConformanceOutcome`. The synthetic fixtures from
+ * `__fixtures__/adapters/` are the deterministic inputs the test
+ * harness uses; production code in `runOrchestrator` already covers
+ * the live path, so this helper exists to give CI a way to validate
+ * end-to-end shape without depending on a network model.
+ *
+ * The plan's retry budget (one retry per degraded template, two
+ * consecutive degraded counts as one failure, ≥ 90% shipped + ≥ 95%
+ * clean-parse thresholds) is intentionally NOT implemented here.
+ * Those policies live in the scheduler that calls this helper N times
+ * across the adapter × template matrix; keeping the harness scoped to
+ * a single run makes it testable in isolation.
+ *
+ * Classification rules (each row that matches wins, top to bottom):
+ *
+ *   1. The parser threw a MalformedBlockError / OversizeBlockError /
+ *      MissingArtifactError → degraded with that reason.
+ *   2. The adapter source threw any other error → failed
+ *      (`unexpected_error`).
+ *   3. The parser yielded a `parser_warning` event anywhere in the
+ *      stream (before OR after `ship`) → degraded (`parser_warning`).
+ *      The parser tolerated a soft violation (weak debate, unknown
+ *      role, clamped score, composite mismatch, duplicate ship) but
+ *      the conformance gate treats any of those as a "this adapter
+ *      is not protocol-clean" signal (lefarcen P2 on PR #1316,
+ *      tightened to post-ship warnings in lefarcen P2 on PR #1316
+ *      follow-up: the parser emits `duplicate_ship` AFTER the first
+ *      ship event yields, so the harness must drain the rest of the
+ *      stream before classifying instead of returning at first ship).
+ *   4. The parser yielded a `ship` event but the cast declared by
+ *      `run_started` did not all emit `panelist_close` IN THE
+ *      SHIPPING ROUND → degraded (`incomplete_panel`). The parser
+ *      only enforces the round-1 designer-artifact invariant; the
+ *      harness is what catches a ship that skipped panelists or
+ *      reused earlier-round closes to fake a complete cast (codex
+ *      P2 on PR #1316; per-round bucketing added in lefarcen P2 on
+ *      PR #1316 follow-up).
+ *   5. The parser yielded a `ship` event with a complete panel and no
+ *      parser warnings → shipped.
+ *   6. The stream ended without a `ship` event → failed (`no_ship`).
+ */
+import { CRITIQUE_PROTOCOL_VERSION } from '@open-design/contracts/critique';
+import { parseCritiqueStream } from './parser.js';
+import { MalformedBlockError, MissingArtifactError, OversizeBlockError, } from './errors.js';
+import { ADAPTER_DEGRADED_DEFAULT_TTL_MS, markDegraded, } from './adapter-degraded.js';
+/**
+ * Map a local conformance reason back to a contracts `DegradedReason`
+ * so the adapter-degraded registry stays consistent with the wire
+ * enum. Parser warnings collapse to `malformed_block` (the closest
+ * "the stream is not well-formed" reason) and an incomplete panel
+ * collapses to `missing_artifact` (the closest "required pieces
+ * absent" reason).
+ */
+function toContractReason(r) {
+    switch (r) {
+        case 'parser_warning': return 'malformed_block';
+        case 'incomplete_panel': return 'missing_artifact';
+        default: return r;
+    }
+}
+/**
+ * Run a synthetic (or recorded) adapter source through the parser and
+ * classify the outcome. Side-effect: when the outcome is `degraded`,
+ * the adapter is marked degraded for the default 24h TTL via
+ * `markDegraded`. The caller can flip the policy by calling
+ * `clearDegraded(adapterId)` afterwards if it wants to gate the mark
+ * on a "two consecutive failures" rule.
+ */
+export async function runAdapterConformance(params) {
+    const events = [];
+    let shipPayload = null;
+    let parserWarningSeen = false;
+    let castRoles = null;
+    // Per-round closed-roles map keyed by `round`. Built incrementally
+    // as panelist_close events arrive and consulted at SHIP time so the
+    // shipping round must independently satisfy the full cast. A round
+    // that closes only some panelists cannot piggy-back on an earlier
+    // round's closes (lefarcen P2 on PR #1316 follow-up).
+    const closedRolesByRound = new Map();
+    // Captured SHIP event details. Set on the first SHIP the parser
+    // yields. The loop continues draining the stream so any
+    // `parser_warning` that arrives AFTER the ship (notably the
+    // `duplicate_ship` kind, which the parser emits when it sees a
+    // second `<SHIP>` block) still flips the run to degraded
+    // (lefarcen P2 on PR #1316 follow-up).
+    let shipEvent = null;
+    try {
+        for await (const event of parseCritiqueStream(params.source, {
+            runId: params.runId,
+            adapter: params.adapterId,
+            parserMaxBlockBytes: params.parserMaxBlockBytes ?? 262_144,
+            projectId: params.projectId ?? 'conformance',
+            artifactId: params.artifactId ?? `conformance-${params.runId}`,
+            onArtifact: (payload) => {
+                shipPayload = payload;
+            },
+        })) {
+            events.push(event);
+            if (event.type === 'run_started') {
+                // Codex P2 on PR #1485: a `run_started` carrying a non-current
+                // protocol version cannot be routed safely. The parser does not
+                // know which fields a future protocol revision adds or drops, so
+                // even a valid-looking SHIP would be misinterpreted. Reject the
+                // adapter as degraded with `protocol_version_mismatch` the
+                // moment we see the mismatch; this is the same reason value
+                // the contracts package already lists in DEGRADED_REASONS.
+                if (event.protocolVersion !== CRITIQUE_PROTOCOL_VERSION) {
+                    markDegraded(params.adapterId, 'protocol_version_mismatch', ADAPTER_DEGRADED_DEFAULT_TTL_MS, 'conformance');
+                    return { kind: 'degraded', reason: 'protocol_version_mismatch', events };
+                }
+                castRoles = event.cast;
+            }
+            else if (event.type === 'panelist_close') {
+                let bucket = closedRolesByRound.get(event.round);
+                if (!bucket) {
+                    bucket = new Set();
+                    closedRolesByRound.set(event.round, bucket);
+                }
+                bucket.add(event.role);
+            }
+            else if (event.type === 'parser_warning') {
+                parserWarningSeen = true;
+            }
+            else if (event.type === 'ship' && shipEvent === null) {
+                // Capture the first ship but keep iterating so a later
+                // `parser_warning` (e.g. duplicate_ship) still tightens the
+                // classification to degraded.
+                shipEvent = event;
+            }
+        }
+    }
+    catch (err) {
+        const reason = err instanceof MalformedBlockError ? 'malformed_block'
+            : err instanceof OversizeBlockError ? 'oversize_block'
+                : err instanceof MissingArtifactError ? 'missing_artifact'
+                    : null;
+        if (reason) {
+            return mark(params.adapterId, reason, events);
+        }
+        return {
+            kind: 'failed',
+            cause: 'unexpected_error',
+            events,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    // Rule 3 (parser_warning anywhere → degraded) is checked BEFORE rule
+    // 6 (no_ship → failed) to preserve the docstring's top-to-bottom
+    // priority: a stream that emits a `parser_warning` and then dies
+    // without a `SHIP` (adapter crash, EOF, run-out-of-rounds) is
+    // protocol-degraded, not protocol-clean-but-incomplete. Without this
+    // ordering, an adapter emitting a clean degraded signal stays
+    // UNMARKED in the registry while one with a clean SHIP after a late
+    // warning gets the 24h mark, exactly opposite of what the docstring
+    // promises and what the rollout gate consumes downstream (PerishCode
+    // P3 on PR #1317).
+    if (parserWarningSeen) {
+        return mark(params.adapterId, 'parser_warning', events);
+    }
+    if (shipEvent === null) {
+        return { kind: 'failed', cause: 'no_ship', events };
+    }
+    const expected = castRoles ?? ['designer', 'critic', 'brand', 'a11y', 'copy'];
+    const shippingRoundClosed = closedRolesByRound.get(shipEvent.round) ?? new Set();
+    const missing = expected.filter((r) => !shippingRoundClosed.has(r));
+    if (missing.length > 0) {
+        return mark(params.adapterId, 'incomplete_panel', events);
+    }
+    return {
+        kind: 'shipped',
+        round: shipEvent.round,
+        composite: shipEvent.composite,
+        events,
+        artifact: shipPayload,
+    };
+}
+function mark(adapterId, reason, events) {
+    markDegraded(adapterId, toContractReason(reason), ADAPTER_DEGRADED_DEFAULT_TTL_MS, 'conformance');
+    return { kind: 'degraded', reason, events };
+}
+//# sourceMappingURL=conformance.js.map

package/dist/__w3kits/webcontainer-runtime/apps/daemon/dist/critique/conformance.js.map

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

package/dist/__w3kits/webcontainer-runtime/apps/daemon/dist/critique/errors.d.ts

@@ -0,0 +1,11 @@
+export declare class MalformedBlockError extends Error {
+    readonly position: number;
+    constructor(message: string, position: number);
+}
+export declare class OversizeBlockError extends Error {
+    readonly position: number;
+    constructor(message: string, position: number);
+}
+export declare class MissingArtifactError extends Error {
+    constructor(message: string);
+}

package/dist/__w3kits/webcontainer-runtime/apps/daemon/dist/critique/errors.js

@@ -0,0 +1,23 @@
+export class MalformedBlockError extends Error {
+    position;
+    constructor(message, position) {
+        super(message);
+        this.position = position;
+        this.name = 'MalformedBlockError';
+    }
+}
+export class OversizeBlockError extends Error {
+    position;
+    constructor(message, position) {
+        super(message);
+        this.position = position;
+        this.name = 'OversizeBlockError';
+    }
+}
+export class MissingArtifactError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'MissingArtifactError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/__w3kits/webcontainer-runtime/apps/daemon/dist/critique/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/critique/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACC;IAA7C,YAAY,OAAe,EAAkB,QAAgB;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,aAAQ,GAAR,QAAQ,CAAQ;QAE3D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACE;IAA7C,YAAY,OAAe,EAAkB,QAAgB;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,aAAQ,GAAR,QAAQ,CAAQ;QAE3D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/__w3kits/webcontainer-runtime/apps/daemon/dist/critique/interrupt-handler.d.ts

@@ -0,0 +1,20 @@
+import type { Request, Response } from 'express';
+import type Database from 'better-sqlite3';
+import type { RunRegistry } from './run-registry.js';
+/**
+ * POST /api/projects/:projectId/critique/:runId/interrupt
+ *
+ * Validates the run exists and belongs to the URL project, then signals the
+ * registered AbortController so the orchestrator can flush best-so-far state
+ * and emit critique.interrupted.
+ *
+ * Idempotency: if the row is already 'interrupted', the endpoint returns 202
+ * with prevStatus='interrupted' rather than 409, so a client that lost the
+ * first response and retries does not see the run flip from 202 to a hard
+ * conflict. Other terminal statuses (shipped, failed, timed_out, degraded,
+ * below_threshold, legacy) still return 409 because the run reached its real
+ * terminal state on its own and an interrupt is no longer meaningful.
+ *
+ * @see specs/current/critique-theater.md § interrupt endpoint (Task 6.1)
+ */
+export declare function handleCritiqueInterrupt(db: Database.Database, registry: RunRegistry): (req: Request, res: Response) => void;