@bradheitmann/odin-sentinel 0.4.13 → 0.5.0

package/dist/src/odin-watch/backends/tmux.js

@@ -0,0 +1,40 @@
+import { createHash } from "node:crypto";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { execFileNoThrow } from "../../utils/execFileNoThrow.js";
+export class TmuxBackend {
+    archiveDir;
+    constructor(archiveDir) {
+        this.archiveDir = archiveDir;
+    }
+    async capture(pane_id) {
+        const result = await execFileNoThrow("tmux", [
+            "capture-pane",
+            "-p",
+            "-t",
+            pane_id,
+        ]);
+        const text = result.status === 0 ? result.stdout : "";
+        const ts = Date.now();
+        const hash = createHash("sha256").update(text).digest("hex");
+        // Archive raw screen text
+        try {
+            mkdirSync(this.archiveDir, { recursive: true });
+            const filename = `${pane_id.replace(/[^a-zA-Z0-9_-]/g, "_")}_${ts}.txt`;
+            writeFileSync(join(this.archiveDir, filename), text, {
+                encoding: "utf8",
+            });
+        }
+        catch {
+            // Archive failure is non-fatal; snapshot still returned
+        }
+        return {
+            pane_id,
+            substrate: "tmux",
+            text,
+            hash,
+            ts,
+        };
+    }
+}
+//# sourceMappingURL=tmux.js.map

package/dist/src/odin-watch/backends/tmux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.js","sourceRoot":"","sources":["../../../../src/odin-watch/backends/tmux.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,MAAM,OAAO,WAAW;IACL,UAAU,CAAS;IAEpC,YAAY,UAAkB;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAe;QAC3B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE;YAC3C,cAAc;YACd,IAAI;YACJ,IAAI;YACJ,OAAO;SACR,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE7D,0BAA0B;QAC1B,IAAI,CAAC;YACH,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC;YACxE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE;gBACnD,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;QAC1D,CAAC;QAED,OAAO;YACL,OAAO;YACP,SAAS,EAAE,MAAM;YACjB,IAAI;YACJ,IAAI;YACJ,EAAE;SACH,CAAC;IACJ,CAAC;CACF"}

package/dist/src/odin-watch/classifier.d.ts

@@ -0,0 +1,27 @@
+import type { WakeVerdict, PromptBudgetClass } from "../protocol/schemas.js";
+export interface ClassifierInput {
+    text: string;
+    hash: string;
+    prev_hash: string | null;
+    elapsed_ms: number;
+    now_ms: number;
+    mandatory_audit_interval_ms: number;
+    stale_threshold_ms: number;
+    write_scope: string[];
+    dirty_paths: string[];
+    last_verdict: WakeVerdict | null;
+    last_mandatory_audit_ts: number | null;
+}
+export interface ClassifierResult {
+    verdict: WakeVerdict;
+    wake: 0 | 1;
+    reason_codes: string[];
+    prompt_budget_class: PromptBudgetClass;
+    dirty_out_of_scope: string[];
+    last_marker: string | undefined;
+}
+/**
+ * Classify a screen snapshot using 8 ordered rules (first-match wins).
+ * Pure function — no I/O.
+ */
+export declare function classify(input: ClassifierInput): ClassifierResult;

package/dist/src/odin-watch/classifier.js

@@ -0,0 +1,182 @@
+// Approval markers: exact strings and regex for numbered interactive options
+const APPROVAL_STRINGS = [
+    "Proceed with the proposal",
+    "Proceed with comment",
+    "No and explain why",
+    "Enter Select",
+];
+const NUMBERED_OPTION_RE = /^\d+\.\s/m;
+// Crash markers
+const CRASH_STRINGS = [
+    "panic",
+    "stack trace",
+    "program experienced a panic",
+    "TUI run error",
+    "fatal error",
+];
+// Completion markers (order matters: QA_COMPLETE check before DEV_COMPLETE)
+const QA_COMPLETE_STRINGS = ["QA COMPLETE", "QA_COMPLETE"];
+const DEV_COMPLETE_STRINGS = [
+    "DEV_COMPLETE_QA_PENDING",
+    "implementation complete",
+    "ready for QA",
+];
+// Blocker markers
+const BLOCKER_STRINGS = [
+    "BLOCKED",
+    "cannot proceed",
+    "missing",
+    "permission denied",
+    "need approval",
+    "SPEC-AMENDMENT",
+    "non-fast-forward",
+];
+// Working state positive evidence: active spinner chars or streaming progress patterns
+const WORKING_RE = /[⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏]|(?:\.\.\.|Running|Generating|Compiling|Building|Installing|Fetching|Downloading|Uploading|Processing|Streaming|Writing|Thinking)/;
+function containsAny(text, markers) {
+    for (const marker of markers) {
+        if (text.includes(marker))
+            return marker;
+    }
+    return null;
+}
+/**
+ * Classify a screen snapshot using 8 ordered rules (first-match wins).
+ * Pure function — no I/O.
+ */
+export function classify(input) {
+    const { text, hash, prev_hash, elapsed_ms, now_ms, mandatory_audit_interval_ms, stale_threshold_ms, write_scope, dirty_paths, last_verdict, last_mandatory_audit_ts, } = input;
+    const dirty_out_of_scope = [];
+    // Compute out-of-scope dirty paths (used in rule 6)
+    if (write_scope.length > 0) {
+        for (const path of dirty_paths) {
+            const inScope = write_scope.some((scope) => path === scope || path.startsWith(scope + "/") || path.startsWith(scope));
+            if (!inScope) {
+                dirty_out_of_scope.push(path);
+            }
+        }
+    }
+    // Rule 1: Mandatory audit due
+    // elapsed since last mandatory audit >= interval → wake, preserve current verdict, budget=compact
+    const auditElapsed = last_mandatory_audit_ts !== null
+        ? now_ms - last_mandatory_audit_ts
+        : elapsed_ms;
+    if (auditElapsed >= mandatory_audit_interval_ms) {
+        const preservedVerdict = last_verdict ?? "UNKNOWN_NEEDS_READ";
+        return {
+            verdict: preservedVerdict,
+            wake: 1,
+            reason_codes: ["MANDATORY_AUDIT interval elapsed"],
+            prompt_budget_class: "compact",
+            dirty_out_of_scope,
+            last_marker: undefined,
+        };
+    }
+    // Rule 2: Approval markers
+    const approvalMarker = containsAny(text, APPROVAL_STRINGS);
+    if (approvalMarker !== null || NUMBERED_OPTION_RE.test(text)) {
+        const marker = approvalMarker ?? "numbered interactive option";
+        return {
+            verdict: "WAITING_APPROVAL",
+            wake: 1,
+            reason_codes: ["APPROVAL_MARKER"],
+            prompt_budget_class: "diagnostic",
+            dirty_out_of_scope,
+            last_marker: marker,
+        };
+    }
+    // Rule 3: Crash markers
+    const crashMarker = containsAny(text, CRASH_STRINGS);
+    if (crashMarker !== null) {
+        return {
+            verdict: "CRASHED",
+            wake: 1,
+            reason_codes: ["CRASH_MARKER"],
+            prompt_budget_class: "forensic",
+            dirty_out_of_scope,
+            last_marker: crashMarker,
+        };
+    }
+    // Rule 4: Completion markers (QA_COMPLETE checked before DEV_COMPLETE)
+    const qaMarker = containsAny(text, QA_COMPLETE_STRINGS);
+    if (qaMarker !== null) {
+        return {
+            verdict: "QA_COMPLETE",
+            wake: 1,
+            reason_codes: ["COMPLETION_MARKER"],
+            prompt_budget_class: "compact",
+            dirty_out_of_scope,
+            last_marker: qaMarker,
+        };
+    }
+    const devMarker = containsAny(text, DEV_COMPLETE_STRINGS);
+    if (devMarker !== null) {
+        return {
+            verdict: "DEV_COMPLETE_QA_PENDING",
+            wake: 1,
+            reason_codes: ["COMPLETION_MARKER"],
+            prompt_budget_class: "compact",
+            dirty_out_of_scope,
+            last_marker: devMarker,
+        };
+    }
+    // Rule 5: Blocker markers
+    const blockerMarker = containsAny(text, BLOCKER_STRINGS);
+    if (blockerMarker !== null) {
+        return {
+            verdict: "BLOCKED",
+            wake: 1,
+            reason_codes: ["BLOCKER_MARKER"],
+            prompt_budget_class: "diagnostic",
+            dirty_out_of_scope,
+            last_marker: blockerMarker,
+        };
+    }
+    // Rule 6: Scope violation (dirty paths outside write_scope)
+    if (dirty_out_of_scope.length > 0) {
+        return {
+            verdict: "BLOCKED",
+            wake: 1,
+            reason_codes: dirty_out_of_scope.map((p) => `DIRTY_OUT_OF_SCOPE ${p}`),
+            prompt_budget_class: "diagnostic",
+            dirty_out_of_scope,
+            last_marker: undefined,
+        };
+    }
+    // Rule 7: Stale hash (unchanged content beyond stale threshold)
+    if (prev_hash !== null &&
+        prev_hash === hash &&
+        elapsed_ms > stale_threshold_ms) {
+        return {
+            verdict: "IDLE",
+            wake: 1,
+            reason_codes: ["STALE_HASH"],
+            prompt_budget_class: "compact",
+            dirty_out_of_scope,
+            last_marker: undefined,
+        };
+    }
+    // Rule 8: All clear — WORKING requires positive evidence
+    // Positive evidence: text contains active working indicators
+    if (WORKING_RE.test(text)) {
+        return {
+            verdict: "WORKING",
+            wake: 0,
+            reason_codes: ["ALL_CLEAR"],
+            prompt_budget_class: "silent",
+            dirty_out_of_scope,
+            last_marker: undefined,
+        };
+    }
+    // Conservative bias: ambiguous (empty text with no stale trigger, or non-empty
+    // without positive WORKING evidence) → UNKNOWN_NEEDS_READ, wake=1
+    return {
+        verdict: "UNKNOWN_NEEDS_READ",
+        wake: 1,
+        reason_codes: ["AMBIGUOUS_STATE"],
+        prompt_budget_class: "compact",
+        dirty_out_of_scope,
+        last_marker: undefined,
+    };
+}
+//# sourceMappingURL=classifier.js.map

package/dist/src/odin-watch/classifier.js.map

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

package/dist/src/odin-watch/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/odin-watch/index.js

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { CmuxBackend } from "./backends/cmux.js";
+import { TmuxBackend } from "./backends/tmux.js";
+import { classify } from "./classifier.js";
+import { writeWakeFiles } from "./writers.js";
+import { execFileNoThrow } from "../utils/execFileNoThrow.js";
+const VALID_SUBSTRATES = [
+    "cmux",
+    "tmux",
+    "minimux",
+    "herdr",
+    "plain",
+];
+function isValidSubstrate(s) {
+    return VALID_SUBSTRATES.includes(s);
+}
+function parseCliArgs() {
+    const { values } = parseArgs({
+        options: {
+            surface: { type: "string" },
+            substrate: { type: "string" },
+            "write-scope": { type: "string", multiple: true },
+            interval: { type: "string", default: "120" },
+            "mandatory-audit": { type: "string", default: "600" },
+            "flag-dir": {
+                type: "string",
+                default: ".odin/monitor/wake/",
+            },
+            "archive-dir": {
+                type: "string",
+                default: ".odin/monitor/cmux/",
+            },
+            label: { type: "string" },
+        },
+        strict: true,
+    });
+    const surface = values["surface"];
+    const substrate = values["substrate"];
+    const label = values["label"];
+    if (!surface) {
+        console.error("Error: --surface <id> is required");
+        process.exit(1);
+    }
+    if (!substrate) {
+        console.error("Error: --substrate <type> is required");
+        process.exit(1);
+    }
+    if (!isValidSubstrate(substrate)) {
+        console.error(`Error: --substrate must be one of: ${VALID_SUBSTRATES.join(", ")}`);
+        process.exit(1);
+    }
+    if (!label) {
+        console.error("Error: --label <name> is required");
+        process.exit(1);
+    }
+    const intervalSeconds = parseInt(values["interval"] ?? "120", 10);
+    const mandatoryAuditSeconds = parseInt(values["mandatory-audit"] ?? "600", 10);
+    if (isNaN(intervalSeconds) || intervalSeconds <= 0) {
+        console.error("Error: --interval must be a positive integer");
+        process.exit(1);
+    }
+    if (isNaN(mandatoryAuditSeconds) || mandatoryAuditSeconds <= 0) {
+        console.error("Error: --mandatory-audit must be a positive integer");
+        process.exit(1);
+    }
+    return {
+        surface,
+        substrate,
+        writeScope: values["write-scope"] ?? [],
+        intervalSeconds,
+        mandatoryAuditSeconds,
+        flagDir: values["flag-dir"] ?? ".odin/monitor/wake/",
+        archiveDir: values["archive-dir"] ?? ".odin/monitor/cmux/",
+        label,
+    };
+}
+async function getDirtyPaths() {
+    const result = await execFileNoThrow("git", [
+        "diff",
+        "--name-only",
+        "--diff-filter=ACDMRT",
+    ]);
+    if (result.status !== 0)
+        return [];
+    return result.stdout
+        .split("\n")
+        .map((l) => l.trim())
+        .filter(Boolean);
+}
+async function getCurrentBranch() {
+    const result = await execFileNoThrow("git", [
+        "rev-parse",
+        "--abbrev-ref",
+        "HEAD",
+    ]);
+    return result.status === 0 ? result.stdout.trim() : undefined;
+}
+async function getCurrentHead() {
+    const result = await execFileNoThrow("git", ["rev-parse", "--short", "HEAD"]);
+    return result.status === 0 ? result.stdout.trim() : undefined;
+}
+async function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function main() {
+    const { surface, substrate, writeScope, intervalSeconds, mandatoryAuditSeconds, flagDir, archiveDir, label, } = parseCliArgs();
+    const intervalMs = intervalSeconds * 1000;
+    const mandatoryAuditIntervalMs = mandatoryAuditSeconds * 1000;
+    // Select backend based on substrate
+    let snapshotter;
+    switch (substrate) {
+        case "cmux":
+            snapshotter = new CmuxBackend(archiveDir);
+            break;
+        case "tmux":
+            snapshotter = new TmuxBackend(archiveDir);
+            break;
+        default:
+            throw new Error(`Substrate '${substrate}' is not yet supported by odin-watch. Supported: cmux, tmux`);
+    }
+    let prevHash = null;
+    let lastVerdictState = null;
+    let lastMandatoryAuditTs = null;
+    const startTs = Date.now();
+    console.error(`odin-watch starting: surface=${surface} substrate=${substrate} label=${label} interval=${intervalSeconds}s`);
+    while (true) {
+        const loopStart = Date.now();
+        const elapsed = loopStart - startTs;
+        try {
+            // Capture
+            const snapshot = await snapshotter.capture(surface);
+            // Gather dirty paths and git metadata
+            const [dirtyPaths, branch, head] = await Promise.all([
+                getDirtyPaths(),
+                getCurrentBranch(),
+                getCurrentHead(),
+            ]);
+            // Classify
+            const result = classify({
+                text: snapshot.text,
+                hash: snapshot.hash,
+                prev_hash: prevHash,
+                elapsed_ms: elapsed,
+                now_ms: Date.now(),
+                mandatory_audit_interval_ms: mandatoryAuditIntervalMs,
+                stale_threshold_ms: intervalMs * 3, // stale after 3 missed polls
+                write_scope: writeScope,
+                dirty_paths: dirtyPaths,
+                last_verdict: lastVerdictState,
+                last_mandatory_audit_ts: lastMandatoryAuditTs,
+            });
+            // If mandatory audit triggered, reset the audit clock
+            if (result.reason_codes.includes("MANDATORY_AUDIT interval elapsed")) {
+                lastMandatoryAuditTs = loopStart;
+            }
+            // Build WakeState
+            const wakeState = {
+                schema_version: "1.0",
+                ts: new Date(loopStart).toISOString(),
+                surface,
+                pane_id: surface,
+                substrate: substrate,
+                state: result.verdict,
+                wake: result.wake,
+                reason_codes: result.reason_codes,
+                dirty_paths: dirtyPaths,
+                dirty_out_of_scope: result.dirty_out_of_scope,
+                screen_hash: snapshot.hash,
+                screen_changed: prevHash !== null && prevHash !== snapshot.hash,
+                last_marker: result.last_marker,
+                prompt_budget_class: result.prompt_budget_class,
+                next_mandatory_audit_due: new Date(loopStart + mandatoryAuditIntervalMs).toISOString(),
+                head,
+                branch,
+            };
+            // Write output files
+            writeWakeFiles(flagDir, label, wakeState);
+            prevHash = snapshot.hash;
+            lastVerdictState = result.verdict;
+            console.error(`[${wakeState.ts}] verdict=${result.verdict} wake=${result.wake} hash=${snapshot.hash.slice(0, 8)}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`odin-watch poll error: ${msg}`);
+        }
+        // Sleep until next interval
+        const elapsed2 = Date.now() - loopStart;
+        const remaining = intervalMs - elapsed2;
+        if (remaining > 0) {
+            await sleep(remaining);
+        }
+    }
+}
+main().catch((err) => {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`odin-watch fatal: ${msg}`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/src/odin-watch/index.js.map

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

package/dist/src/odin-watch/snapshotter.d.ts

@@ -0,0 +1,11 @@
+import type { SubstrateType } from "../protocol/schemas.js";
+export interface Snapshot {
+    pane_id: string;
+    substrate: SubstrateType;
+    text: string;
+    hash: string;
+    ts: number;
+}
+export interface Snapshotter {
+    capture(pane_id: string): Promise<Snapshot>;
+}

package/dist/src/odin-watch/snapshotter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=snapshotter.js.map

package/dist/src/odin-watch/snapshotter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotter.js","sourceRoot":"","sources":["../../../src/odin-watch/snapshotter.ts"],"names":[],"mappings":""}

package/dist/src/odin-watch/writers.d.ts

@@ -0,0 +1,8 @@
+import type { WakeState } from "../protocol/schemas.js";
+/**
+ * Write the three output files for a single poll result:
+ *   {flagDir}/{label}.flag       — exactly one byte: "0" or "1", no newline
+ *   {flagDir}/{label}.reason     — text reason codes, one per line
+ *   {flagDir}/{label}.state.json — WakeState JSON object
+ */
+export declare function writeWakeFiles(flagDir: string, label: string, state: WakeState): void;

package/dist/src/odin-watch/writers.js

@@ -0,0 +1,27 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Write the three output files for a single poll result:
+ *   {flagDir}/{label}.flag       — exactly one byte: "0" or "1", no newline
+ *   {flagDir}/{label}.reason     — text reason codes, one per line
+ *   {flagDir}/{label}.state.json — WakeState JSON object
+ */
+export function writeWakeFiles(flagDir, label, state) {
+    mkdirSync(flagDir, { recursive: true });
+    // Flag file: exactly one byte ASCII character "0" or "1", no newline
+    const flagPath = join(flagDir, `${label}.flag`);
+    writeFileSync(flagPath, String(state.wake), {
+        encoding: "utf8",
+    });
+    // Reason file: one reason code per line
+    const reasonPath = join(flagDir, `${label}.reason`);
+    writeFileSync(reasonPath, state.reason_codes.join("\n"), {
+        encoding: "utf8",
+    });
+    // State JSON file
+    const statePath = join(flagDir, `${label}.state.json`);
+    writeFileSync(statePath, JSON.stringify(state, null, 2), {
+        encoding: "utf8",
+    });
+}
+//# sourceMappingURL=writers.js.map

package/dist/src/odin-watch/writers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writers.js","sourceRoot":"","sources":["../../../src/odin-watch/writers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,KAAa,EACb,KAAgB;IAEhB,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExC,qEAAqE;IACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;IAChD,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAc,EAAE;QACvD,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAC;IAEH,wCAAwC;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC;IACpD,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACvD,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAC;IAEH,kBAAkB;IAClB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,aAAa,CAAC,CAAC;IACvD,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QACvD,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/protocol/index.d.ts

@@ -1,4 +1,6 @@
 export { GOVERNED_CONTEXT_PROOF_SCHEMA, VERSION, classifyGovernedReadiness, createProtocolService, exportProtocolSnapshot, getActivationGates, getCloseoutChecklist, getDelegationPacket, getOnboardingPlan, getRoleProfile, getRuntimeNotice, getStartupPacket, harnessCategory, validateBootReceipt, validateCmuxDeliveryProof, validateDelegationPacket, validateGovernedContextProof, validateInstructionReadProof, validateTeamManifest } from "./service.js";
 export type { AssuranceLevel, CloseoutMode, DelegationPacketInput, GovernedReadinessInput, GovernedReadinessResult, GovernedReadinessState, HarnessCategory, ProtocolData, RuntimeNotice, StartupPacket, StartupPacketInput, ValidationResult } from "./service.js";
-export { computeSurfaceLayout, computeSurfaceLayoutGate, renderSurfaceLayoutAscii } from "./surface-layout.js";
+export { computeSurfaceLayout, computeSurfaceLayoutGate, getSubstrateCapability, renderSurfaceLayoutAscii } from "./surface-layout.js";
 export type { SurfaceLayout, SurfaceLayoutColumn, SurfaceLayoutSurface, SurfaceLayoutGate } from "./surface-layout.js";
+export { CapabilityFlag } from "./schemas.js";
+export type { BootReceipt, DeliveryReceiptPacingExtension, HarnessPacingEvent, PacingEventType, PromptBudgetClass, ReceiptType, SubstrateCapability, SubstrateType, WakeState, WakeVerdict } from "./schemas.js";

package/dist/src/protocol/index.js

@@ -1,3 +1,6 @@
 export { GOVERNED_CONTEXT_PROOF_SCHEMA, VERSION, classifyGovernedReadiness, createProtocolService, exportProtocolSnapshot, getActivationGates, getCloseoutChecklist, getDelegationPacket, getOnboardingPlan, getRoleProfile, getRuntimeNotice, getStartupPacket, harnessCategory, validateBootReceipt, validateCmuxDeliveryProof, validateDelegationPacket, validateGovernedContextProof, validateInstructionReadProof, validateTeamManifest } from "./service.js";
-export { computeSurfaceLayout, computeSurfaceLayoutGate, renderSurfaceLayoutAscii } from "./surface-layout.js";
+export { computeSurfaceLayout, computeSurfaceLayoutGate, getSubstrateCapability, renderSurfaceLayoutAscii } from "./surface-layout.js";
+// New types for SCP performance/portability program (E1-E5 unblocking)
+// CapabilityFlag is exported as a value (runtime const) and as a type via the same export.
+export { CapabilityFlag } from "./schemas.js";
 //# sourceMappingURL=index.js.map

package/dist/src/protocol/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,OAAO,EACP,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAiBtB,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,OAAO,EACP,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAiBtB,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAS7B,uEAAuE;AACvE,2FAA2F;AAC3F,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/src/protocol/repository.d.ts

@@ -15,6 +15,20 @@ export type ProtocolData = {
         harnessSkillTargets: string;
         teamBootstrapRunbook: string;
     };
+    roleCards: {
+        execPm: string;
+        teamPm: string;
+        devWorker: string;
+        qaWorker: string;
+        execAsst: string;
+    };
+    missionFrontrun: {
+        orchestratorContract: string;
+        workerContract: string;
+        scrutinyValidatorContract: string;
+        scrutinyFeatureReviewerContract: string;
+        droidsScrutinyFeatureReviewer: string;
+    };
 };
 export type ProtocolRepository = {
     load(): ProtocolData;

package/dist/src/protocol/repository.js

@@ -17,7 +17,17 @@ export const REQUIRED_PROTOCOL_FILES = [
     "protocol/skill-references/boot-receipt-examples.md",
     "protocol/skill-references/canonical-introduction-prompt.md",
     "protocol/skill-references/harness-skill-targets.md",
-    "protocol/skill-references/team-bootstrap-runbook.md"
+    "protocol/skill-references/team-bootstrap-runbook.md",
+    "protocol/role-cards/exec-pm.md",
+    "protocol/role-cards/team-pm.md",
+    "protocol/role-cards/dev-worker.md",
+    "protocol/role-cards/qa-worker.md",
+    "protocol/role-cards/exec-asst.md",
+    "protocol/mission-frontrun/orchestrator-contract.md",
+    "protocol/mission-frontrun/worker-contract.md",
+    "protocol/mission-frontrun/scrutiny-validator-contract.md",
+    "protocol/mission-frontrun/scrutiny-feature-reviewer-contract.md",
+    "protocol/mission-frontrun/droids-scrutiny-feature-reviewer.md"
 ];
 function missingProtocolFiles(root) {
     return REQUIRED_PROTOCOL_FILES.filter((file) => !existsSync(join(root, file)));
@@ -105,6 +115,20 @@ export function createFileProtocolRepository(rootDir = findRootDir()) {
                     canonicalIntroductionPrompt: readFileSync(protocolPath("skill-references", "canonical-introduction-prompt.md"), "utf8"),
                     harnessSkillTargets: readFileSync(protocolPath("skill-references", "harness-skill-targets.md"), "utf8"),
                     teamBootstrapRunbook: readFileSync(protocolPath("skill-references", "team-bootstrap-runbook.md"), "utf8")
+                },
+                roleCards: {
+                    execPm: readFileSync(protocolPath("role-cards", "exec-pm.md"), "utf8"),
+                    teamPm: readFileSync(protocolPath("role-cards", "team-pm.md"), "utf8"),
+                    devWorker: readFileSync(protocolPath("role-cards", "dev-worker.md"), "utf8"),
+                    qaWorker: readFileSync(protocolPath("role-cards", "qa-worker.md"), "utf8"),
+                    execAsst: readFileSync(protocolPath("role-cards", "exec-asst.md"), "utf8")
+                },
+                missionFrontrun: {
+                    orchestratorContract: readFileSync(protocolPath("mission-frontrun", "orchestrator-contract.md"), "utf8"),
+                    workerContract: readFileSync(protocolPath("mission-frontrun", "worker-contract.md"), "utf8"),
+                    scrutinyValidatorContract: readFileSync(protocolPath("mission-frontrun", "scrutiny-validator-contract.md"), "utf8"),
+                    scrutinyFeatureReviewerContract: readFileSync(protocolPath("mission-frontrun", "scrutiny-feature-reviewer-contract.md"), "utf8"),
+                    droidsScrutinyFeatureReviewer: readFileSync(protocolPath("mission-frontrun", "droids-scrutiny-feature-reviewer.md"), "utf8")
                 }
             });
             cache = { fingerprint, data };