@eir-labs/coltrane 0.4.0

package/dist/src/index.d.ts

@@ -0,0 +1,36 @@
+export * from "./version.js";
+export * from "./core_types.js";
+export * from "./type_versioning.js";
+export * from "./composition.js";
+export * from "./tool_providers.js";
+export * from "./playwright_cage.js";
+export * from "./mcp.js";
+export * from "./pricing.js";
+export * from "./access_grant.js";
+export * from "./agent_profile.js";
+export * from "./output_validation.js";
+export * from "./simulate.js";
+export * from "./coltrane_profile.js";
+export * from "./learner.js";
+export * from "./registry.js";
+export * from "./loader.js";
+export * from "./canonical_core_types.js";
+export * from "./canonical_form.js";
+export * from "./ledger.js";
+export * from "./outputs.js";
+export * from "./charter.js";
+export * from "./server.js";
+export * from "./runtime.js";
+export * from "./claude_invoker.js";
+export * from "./bifrost_invoker.js";
+export * from "./circle_of_fifths.js";
+export * from "./modulation_path.js";
+export * from "./tensor_read.js";
+export * from "./jsong.js";
+export * from "./tones.js";
+export * from "./gig_song.js";
+export * from "./overtones.js";
+export * from "./polyphony.js";
+export * from "./harmonic_validation.js";
+export * from "./acoustics.js";
+export * from "./document_factory.js";

package/dist/src/index.js

@@ -0,0 +1,37 @@
+export * from "./version.js";
+export * from "./core_types.js";
+export * from "./type_versioning.js";
+export * from "./composition.js";
+export * from "./tool_providers.js";
+export * from "./playwright_cage.js";
+export * from "./mcp.js";
+export * from "./pricing.js";
+export * from "./access_grant.js";
+export * from "./agent_profile.js";
+export * from "./output_validation.js";
+export * from "./simulate.js";
+export * from "./coltrane_profile.js";
+export * from "./learner.js";
+export * from "./registry.js";
+export * from "./loader.js";
+export * from "./canonical_core_types.js";
+export * from "./canonical_form.js";
+export * from "./ledger.js";
+export * from "./outputs.js";
+export * from "./charter.js";
+export * from "./server.js";
+export * from "./runtime.js";
+export * from "./claude_invoker.js";
+export * from "./bifrost_invoker.js";
+export * from "./circle_of_fifths.js";
+export * from "./modulation_path.js";
+export * from "./tensor_read.js";
+export * from "./jsong.js";
+export * from "./tones.js";
+export * from "./gig_song.js";
+export * from "./overtones.js";
+export * from "./polyphony.js";
+export * from "./harmonic_validation.js";
+export * from "./acoustics.js";
+export * from "./document_factory.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}

package/dist/src/jsong.d.ts

@@ -0,0 +1,47 @@
+export declare const MAGIC: Uint8Array<ArrayBuffer>;
+export declare const FILE_HEADER_SIZE = 48;
+export declare const TICK_RECORD_SIZE = 280;
+export declare const STATE_DIM = 59;
+export declare const SLUG_SIZE = 20;
+export declare const ROLE_OBSERVATION = 0;
+export declare const ROLE_SPEC = 1;
+export declare const ROLE_VERDICT = 2;
+export declare const FLAG_MUSICAL: number;
+export declare const FLAG_ANOMALY: number;
+export declare const FLAG_BOUNDARY: number;
+export declare const FLAG_CLAIM_NUMERIC: number;
+export declare const FLAG_CLAIM_STRING: number;
+export declare const FLAG_CLAIM_IMPORT_REQUIRED: number;
+export declare const FLAG_CLAIM_IMPORT_FORBIDDEN: number;
+export declare const FLAG_CLAIM_NO_CYCLES: number;
+export declare const FLAG_BAND_PROFILE: number;
+export declare class JsongError extends Error {
+}
+export interface FileHeader {
+    version: number;
+    gig_id: Uint8Array;
+    agent_id: Uint8Array;
+    start_us: bigint;
+}
+export interface TickRecord {
+    tick_idx: number;
+    delta_us: number;
+    role: number;
+    flags: number;
+    state_59: number[];
+    score: number;
+    slug: string;
+}
+export declare function packHeader(h: FileHeader): Uint8Array;
+export declare function unpackHeader(buf: Uint8Array): FileHeader;
+export declare function packTick(rec: TickRecord): Uint8Array;
+export declare function unpackTick(buf: Uint8Array): TickRecord;
+/** Decode a whole JSONG buffer (header + N ticks). Mirrors Python read_all. */
+export declare function readAll(data: Uint8Array): {
+    header: FileHeader;
+    ticks: TickRecord[];
+};
+/** Encode a header + ticks into a single JSONG buffer. */
+export declare function writeAll(header: FileHeader, ticks: readonly TickRecord[]): Uint8Array;
+/** A zero-valued 59-float state vector (Python empty_state). */
+export declare function emptyState(): number[];

package/dist/src/jsong.js

@@ -0,0 +1,130 @@
+// JSONG — the substrate's binary tick-log, ported pure-TS + zero-dep from the
+// Python reference (sim-in-a-box/sib/jsong.py). Telemetry, NOT genome: a JSONG file
+// is referenced by the ledger via its sha256, never imported into the canonical_form
+// contract. Fixed little-endian layout: 48-byte file header + N × 280-byte records.
+//
+// Python struct formats (the source of truth this port reproduces byte-for-byte):
+//   header: "<4sHH16s16sQ"   magic, version, reserved, gig_id, agent_id, start_us
+//   tick:   "<II HH I 59f d 20s"  tick_idx, delta_us, role, reserved, flags, state_59, score, slug
+export const MAGIC = new Uint8Array([0x6a, 0x53, 0x4e, 0x47]); // b"jSNG"
+export const FILE_HEADER_SIZE = 48;
+export const TICK_RECORD_SIZE = 280;
+export const STATE_DIM = 59;
+export const SLUG_SIZE = 20;
+export const ROLE_OBSERVATION = 0;
+export const ROLE_SPEC = 1;
+export const ROLE_VERDICT = 2;
+export const FLAG_MUSICAL = 1 << 0;
+export const FLAG_ANOMALY = 1 << 1;
+export const FLAG_BOUNDARY = 1 << 2;
+export const FLAG_CLAIM_NUMERIC = 1 << 3;
+export const FLAG_CLAIM_STRING = 1 << 4;
+export const FLAG_CLAIM_IMPORT_REQUIRED = 1 << 5;
+export const FLAG_CLAIM_IMPORT_FORBIDDEN = 1 << 6;
+export const FLAG_CLAIM_NO_CYCLES = 1 << 7;
+export const FLAG_BAND_PROFILE = 1 << 8;
+export class JsongError extends Error {
+}
+function fitBytes(src, n) {
+    // left-justified, null-padded/truncated to exactly n bytes (Python "<16s"/"<20s")
+    const out = new Uint8Array(n);
+    out.set(src.subarray(0, n));
+    return out;
+}
+const enc = new TextEncoder();
+const dec = new TextDecoder();
+export function packHeader(h) {
+    const buf = new Uint8Array(FILE_HEADER_SIZE);
+    const dv = new DataView(buf.buffer);
+    buf.set(MAGIC, 0);
+    dv.setUint16(4, h.version, true);
+    dv.setUint16(6, 0, true); // reserved
+    buf.set(fitBytes(h.gig_id, 16), 8);
+    buf.set(fitBytes(h.agent_id, 16), 24);
+    dv.setBigUint64(40, h.start_us, true);
+    return buf;
+}
+export function unpackHeader(buf) {
+    if (buf.length < FILE_HEADER_SIZE)
+        throw new JsongError(`header truncated: ${buf.length} < ${FILE_HEADER_SIZE}`);
+    for (let i = 0; i < 4; i++) {
+        if (buf[i] !== MAGIC[i])
+            throw new JsongError("bad magic (expected jSNG)");
+    }
+    const dv = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    return {
+        version: dv.getUint16(4, true),
+        gig_id: buf.slice(8, 24),
+        agent_id: buf.slice(24, 40),
+        start_us: dv.getBigUint64(40, true),
+    };
+}
+export function packTick(rec) {
+    if (rec.state_59.length !== STATE_DIM)
+        throw new JsongError(`state_59 must be ${STATE_DIM} floats, got ${rec.state_59.length}`);
+    if (rec.role !== ROLE_OBSERVATION && rec.role !== ROLE_SPEC && rec.role !== ROLE_VERDICT) {
+        throw new JsongError(`invalid role ${rec.role}`);
+    }
+    const buf = new Uint8Array(TICK_RECORD_SIZE);
+    const dv = new DataView(buf.buffer);
+    dv.setUint32(0, rec.tick_idx, true);
+    dv.setUint32(4, rec.delta_us, true);
+    dv.setUint16(8, rec.role, true);
+    dv.setUint16(10, 0, true); // reserved
+    dv.setUint32(12, rec.flags, true);
+    for (let i = 0; i < STATE_DIM; i++)
+        dv.setFloat32(16 + i * 4, rec.state_59[i], true);
+    dv.setFloat64(252, rec.score, true);
+    buf.set(fitBytes(enc.encode(rec.slug), SLUG_SIZE), 260);
+    return buf;
+}
+export function unpackTick(buf) {
+    if (buf.length < TICK_RECORD_SIZE)
+        throw new JsongError(`tick truncated: ${buf.length} < ${TICK_RECORD_SIZE}`);
+    const dv = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    const role = dv.getUint16(8, true);
+    if (role !== ROLE_OBSERVATION && role !== ROLE_SPEC && role !== ROLE_VERDICT)
+        throw new JsongError(`invalid role ${role}`);
+    const state_59 = new Array(STATE_DIM);
+    for (let i = 0; i < STATE_DIM; i++)
+        state_59[i] = dv.getFloat32(16 + i * 4, true);
+    const slugBytes = buf.slice(260, 280);
+    let end = slugBytes.length;
+    while (end > 0 && slugBytes[end - 1] === 0)
+        end--; // strip null padding
+    return {
+        tick_idx: dv.getUint32(0, true),
+        delta_us: dv.getUint32(4, true),
+        role,
+        flags: dv.getUint32(12, true),
+        state_59,
+        score: dv.getFloat64(252, true),
+        slug: dec.decode(slugBytes.subarray(0, end)),
+    };
+}
+/** Decode a whole JSONG buffer (header + N ticks). Mirrors Python read_all. */
+export function readAll(data) {
+    if (data.length < FILE_HEADER_SIZE)
+        throw new JsongError(`file truncated: ${data.length} < ${FILE_HEADER_SIZE}`);
+    const header = unpackHeader(data.subarray(0, FILE_HEADER_SIZE));
+    const body = data.subarray(FILE_HEADER_SIZE);
+    if (body.length % TICK_RECORD_SIZE !== 0)
+        throw new JsongError(`body size ${body.length} not a multiple of ${TICK_RECORD_SIZE}`);
+    const ticks = [];
+    for (let off = 0; off < body.length; off += TICK_RECORD_SIZE) {
+        ticks.push(unpackTick(body.subarray(off, off + TICK_RECORD_SIZE)));
+    }
+    return { header, ticks };
+}
+/** Encode a header + ticks into a single JSONG buffer. */
+export function writeAll(header, ticks) {
+    const out = new Uint8Array(FILE_HEADER_SIZE + ticks.length * TICK_RECORD_SIZE);
+    out.set(packHeader(header), 0);
+    ticks.forEach((t, i) => out.set(packTick(t), FILE_HEADER_SIZE + i * TICK_RECORD_SIZE));
+    return out;
+}
+/** A zero-valued 59-float state vector (Python empty_state). */
+export function emptyState() {
+    return new Array(STATE_DIM).fill(0);
+}
+//# sourceMappingURL=jsong.js.map

package/dist/src/jsong.js.map

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

package/dist/src/judges/user_flow_judge.d.ts

@@ -0,0 +1,89 @@
+import { extractJson } from "../claude_invoker.js";
+/**
+ * #226 — this module used to carry its OWN string-aware extractor, whose docstring named
+ * the shared one as broken. That fix was never back-ported, and the copy was itself only a
+ * half-fix: it enumerated candidate END positions from a FIXED start, so it still threw on
+ * `The set {a,b} matters.\n{"ok":true}` and still silently returned the illustrative
+ * preamble object for `For example {"foo":"bar"} … {"title":"REAL"}`. Its step-3 fallback
+ * then re-invoked the broken shared extractor.
+ *
+ * There is now ONE implementation (claude_invoker.ts), consumed by all four production
+ * call sites. Re-exported so existing importers of the judge's `extractJson` keep working
+ * — they now get the shared, fully-fixed function.
+ */
+export { extractJson };
+/** One turn of a user-flow transcript — the raw signal the SENSE phase parses. */
+export interface UserFlowTurn {
+    /** What the user (Eugene's intent surrogate) actually asked for in this turn. */
+    user_intent: string;
+    /** Claude's natural-language response (no parsing — verbatim text). */
+    claude_response: string;
+    /** The coltrane MCP tools claude invoked during this turn. May be empty. */
+    tool_calls: Array<{
+        tool_name: string;
+        args?: Record<string, unknown> | null;
+    }>;
+    /** Snapshot of the genome state AFTER this turn — null for read-only turns. */
+    post_turn_genome_state?: Record<string, unknown> | null;
+    /** Marker: the user_intent was deliberately malformed (typo/garbage/contradiction). */
+    malformed_input?: boolean;
+}
+/** A full user-flow transcript — sequence of turns scored as one flow. */
+export type UserFlowTranscript = UserFlowTurn[];
+/** The five criteria the standard defines. Adding one here requires updating the standard. */
+export declare const USER_FLOW_CRITERIA: readonly ["tool_pick_appropriate", "response_faithful", "genome_state_valid", "typed_error_on_malformed", "multi_turn_continuity"];
+export type UserFlowCriterion = (typeof USER_FLOW_CRITERIA)[number];
+export interface CriterionScore {
+    score: number | null;
+    rationale: string;
+}
+export interface JudgeVerdict {
+    criteria: Record<UserFlowCriterion, CriterionScore>;
+    /** Sum of non-null scores, range [0.0, 5.0], or null if all null. */
+    overall_score: number | null;
+    /** True iff overall_score >= pass_threshold_sum (from the standard's scoring block). */
+    overall_pass: boolean;
+    /** The single most load-bearing observation, grounded in a specific turn. */
+    top_finding: string;
+    /** Raw outputs of each phase — kept for debug + REPRO comparison. */
+    raw: {
+        sense: Record<string, unknown> | null;
+        interpret: Record<string, unknown> | null;
+    };
+}
+/** Minimal shape of the standard JSON we read (we don't pin every key). */
+export interface SoftJudgeStandard {
+    slug: string;
+    prompt_templates: {
+        sense: string;
+        interpret: string;
+    };
+    scoring?: {
+        pass_threshold_per_criterion?: number;
+        overall_pass_threshold_sum?: number;
+        overall_pass_threshold_max?: number;
+        noise_band_repro?: number;
+    };
+}
+/** Options for the LLM-subprocess invocation. */
+export interface ScoreUserFlowOptions {
+    /** Claude CLI binary. Default "claude". */
+    bin?: string;
+    /** Per-phase timeout in ms. Default 240_000 (4 min — judges can take time). */
+    timeoutMs?: number;
+    /** Inject a custom run() to test the prompt-building path without the subprocess. */
+    run?: (bin: string, args: string[]) => string;
+}
+/** Load a soft-judge standard from disk. Thin convenience over readFileSync+JSON.parse. */
+export declare function loadStandard(path: string): SoftJudgeStandard;
+export declare function lastRawStdout(): {
+    sense: string;
+    interpret: string;
+};
+/**
+ * Score a user-flow transcript against a soft-judge standard. Runs SENSE + INTERPRET
+ * phases via real `claude -p` subprocesses, returns a structured verdict.
+ *
+ * NOT mocked. Each call spawns claude twice (one per phase). Allow ~30-90s wall time.
+ */
+export declare function scoreUserFlow(transcript: UserFlowTranscript, standard: SoftJudgeStandard, opts?: ScoreUserFlowOptions): Promise<JudgeVerdict>;

package/dist/src/judges/user_flow_judge.js

@@ -0,0 +1,200 @@
+// user_flow_judge — LLM-judge module for user-flow behavioral correctness.
+//
+// Extends groove/phase16's soft-judge pattern (sub_thread_invocation) to score
+// USER-FLOW behavioral correctness rather than sub-thread invocation. Gap-1 in the
+// phase-15 ecosystem: every deterministic spec asserts hard outcomes; zero tests
+// score whether claude PICKED the right coltrane tool for a fuzzy user intent.
+//
+// API:
+//   scoreUserFlow(transcript, standard) -> JudgeVerdict
+//
+// The judge invokes a real `claude -p` subprocess (no mocks). It reads the
+// standard's prompt_templates and feeds them — SENSE first to normalize the
+// transcript, INTERPRET second to score the criteria. Returns a structured
+// verdict with per-criterion score + rationale + overall pass/fail at the
+// configured threshold.
+import { execFileSync } from "node:child_process";
+import { writeFileSync, unlinkSync, readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+import { extractJson } from "../claude_invoker.js";
+/**
+ * #226 — this module used to carry its OWN string-aware extractor, whose docstring named
+ * the shared one as broken. That fix was never back-ported, and the copy was itself only a
+ * half-fix: it enumerated candidate END positions from a FIXED start, so it still threw on
+ * `The set {a,b} matters.\n{"ok":true}` and still silently returned the illustrative
+ * preamble object for `For example {"foo":"bar"} … {"title":"REAL"}`. Its step-3 fallback
+ * then re-invoked the broken shared extractor.
+ *
+ * There is now ONE implementation (claude_invoker.ts), consumed by all four production
+ * call sites. Re-exported so existing importers of the judge's `extractJson` keep working
+ * — they now get the shared, fully-fixed function.
+ */
+export { extractJson };
+/** The five criteria the standard defines. Adding one here requires updating the standard. */
+export const USER_FLOW_CRITERIA = [
+    "tool_pick_appropriate",
+    "response_faithful",
+    "genome_state_valid",
+    "typed_error_on_malformed",
+    "multi_turn_continuity",
+];
+// ──────────────────────────── helpers ────────────────────────────
+/** Load a soft-judge standard from disk. Thin convenience over readFileSync+JSON.parse. */
+export function loadStandard(path) {
+    const raw = JSON.parse(readFileSync(path, "utf-8"));
+    if (!raw.prompt_templates || typeof raw.prompt_templates.sense !== "string" || typeof raw.prompt_templates.interpret !== "string") {
+        throw new Error(`standard at ${path} missing prompt_templates.sense/interpret`);
+    }
+    return raw;
+}
+function buildSensePrompt(template, transcript) {
+    return [
+        `# Standard: user_flow_correctness`,
+        `# Phase: sense`,
+        ``,
+        `## Phase prompt_template`,
+        template,
+        ``,
+        `## Gig input`,
+        JSON.stringify({ transcript_json: JSON.stringify(transcript) }, null, 2),
+        ``,
+        `## Raw transcript (already JSON; included for direct reference)`,
+        "```json",
+        JSON.stringify(transcript, null, 2),
+        "```",
+        ``,
+        `Respond with ONLY a single JSON object — no prose, no code fence, no markdown.`,
+    ].join("\n");
+}
+function buildInterpretPrompt(template, senseOutput) {
+    return [
+        `# Standard: user_flow_correctness`,
+        `# Phase: interpret`,
+        ``,
+        `## Phase prompt_template`,
+        template,
+        ``,
+        `## Gig input`,
+        JSON.stringify({ trace: senseOutput }, null, 2),
+        ``,
+        `## Upstream output (user-flow-transcript from SENSE)`,
+        "```json",
+        JSON.stringify(senseOutput, null, 2),
+        "```",
+        ``,
+        `Respond with ONLY a single JSON object — no prose, no code fence, no markdown.`,
+    ].join("\n");
+}
+/** Invoke claude CLI once with a prompt, return raw stdout. */
+function invokeClaude(prompt, opts) {
+    const cfgPath = join(tmpdir(), `coltrane-uf-judge-mcp-${randomUUID()}.json`);
+    writeFileSync(cfgPath, JSON.stringify({ mcpServers: {} }));
+    try {
+        const args = ["-p", prompt, "--mcp-config", cfgPath, "--strict-mcp-config"];
+        if (opts.run)
+            return opts.run(opts.bin, args);
+        return execFileSync(opts.bin, args, {
+            encoding: "utf-8",
+            maxBuffer: 64 * 1024 * 1024,
+            timeout: opts.timeoutMs,
+        });
+    }
+    finally {
+        try {
+            unlinkSync(cfgPath);
+        }
+        catch { /* best-effort */ }
+    }
+}
+/** Stash the most-recent raw stdout for each phase, for debug + REPRO inspection. */
+const RAW_STDOUT_LOG = { sense: "", interpret: "" };
+export function lastRawStdout() {
+    return { ...RAW_STDOUT_LOG };
+}
+/** Build an empty criteria block (used when SENSE produces no turns). */
+function unjudgeableCriteria(reason) {
+    const out = {};
+    for (const c of USER_FLOW_CRITERIA) {
+        out[c] = { score: null, rationale: reason };
+    }
+    return out;
+}
+/** Normalize whatever the LLM returned into a JudgeVerdict, defensively. */
+function normalizeInterpretOutput(raw, sense, passThresholdSum) {
+    const rawCriteria = (raw["criteria"] ?? {});
+    const criteria = {};
+    let sum = 0;
+    let anyNonNull = false;
+    for (const c of USER_FLOW_CRITERIA) {
+        const entry = rawCriteria[c] ?? {};
+        const score = typeof entry.score === "number" ? entry.score : null;
+        const rationale = typeof entry.rationale === "string" ? entry.rationale : "(no rationale returned)";
+        criteria[c] = { score, rationale };
+        if (score !== null) {
+            sum += score;
+            anyNonNull = true;
+        }
+    }
+    const overall_score = anyNonNull ? sum : null;
+    const overall_pass = overall_score !== null && overall_score >= passThresholdSum;
+    const top_finding = typeof raw["top_finding"] === "string" ? raw["top_finding"] : "(no top finding returned)";
+    return {
+        criteria,
+        overall_score,
+        overall_pass,
+        top_finding,
+        raw: { sense, interpret: raw },
+    };
+}
+// ───────────────────────────── public API ─────────────────────────────
+/**
+ * Score a user-flow transcript against a soft-judge standard. Runs SENSE + INTERPRET
+ * phases via real `claude -p` subprocesses, returns a structured verdict.
+ *
+ * NOT mocked. Each call spawns claude twice (one per phase). Allow ~30-90s wall time.
+ */
+export async function scoreUserFlow(transcript, standard, opts = {}) {
+    const bin = opts.bin ?? "claude";
+    const timeoutMs = opts.timeoutMs ?? 240_000;
+    const passThresholdSum = standard.scoring?.overall_pass_threshold_sum ?? 3.0;
+    // SENSE
+    const sensePrompt = buildSensePrompt(standard.prompt_templates.sense, transcript);
+    let senseOut = null;
+    try {
+        const stdout = invokeClaude(sensePrompt, { bin, timeoutMs, ...(opts.run ? { run: opts.run } : {}) });
+        RAW_STDOUT_LOG.sense = stdout;
+        senseOut = extractJson(stdout);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return {
+            criteria: unjudgeableCriteria(`SENSE invocation failed: ${msg.slice(0, 200)}`),
+            overall_score: null,
+            overall_pass: false,
+            top_finding: `SENSE phase failed: ${msg.slice(0, 200)}`,
+            raw: { sense: null, interpret: null },
+        };
+    }
+    // INTERPRET
+    const interpretPrompt = buildInterpretPrompt(standard.prompt_templates.interpret, senseOut);
+    let interpretOut;
+    try {
+        const stdout = invokeClaude(interpretPrompt, { bin, timeoutMs, ...(opts.run ? { run: opts.run } : {}) });
+        RAW_STDOUT_LOG.interpret = stdout;
+        interpretOut = extractJson(stdout);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return {
+            criteria: unjudgeableCriteria(`INTERPRET invocation failed: ${msg.slice(0, 200)}`),
+            overall_score: null,
+            overall_pass: false,
+            top_finding: `INTERPRET phase failed: ${msg.slice(0, 200)}`,
+            raw: { sense: senseOut, interpret: null },
+        };
+    }
+    return normalizeInterpretOutput(interpretOut, senseOut, passThresholdSum);
+}
+//# sourceMappingURL=user_flow_judge.js.map

package/dist/src/judges/user_flow_judge.js.map

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

package/dist/src/learner.d.ts

@@ -0,0 +1,37 @@
+import type { ModelTier } from "./pricing.js";
+export interface GigObservation {
+    gig_id: string;
+    agent_slug: string;
+    primitive: string;
+    model_tier_used: ModelTier;
+    success: boolean;
+    cost: number;
+    duration_ms: number;
+}
+export interface LearnerProposeDowngradeInput {
+    agent_slug: string;
+    from_tier: ModelTier;
+    to_tier: ModelTier;
+    observations: GigObservation[];
+    auto_approve_as?: string;
+}
+export interface DowngradeProposal {
+    agent_slug: string;
+    from_tier: ModelTier;
+    to_tier: ModelTier;
+    data_points: number;
+    evidence_summary: {
+        success_rate: number;
+        avg_cost: number;
+        avg_duration_ms: number;
+    };
+    requires_human_approval: boolean;
+    auto_approved: boolean;
+}
+export interface LearnerProposeDowngradeResult {
+    ok: boolean;
+    violation?: "insufficient_evidence";
+    proposal?: DowngradeProposal;
+}
+export declare function learnerProposeDowngrade(input: LearnerProposeDowngradeInput): LearnerProposeDowngradeResult;
+export declare const learnerProposeDowngradeResult: typeof learnerProposeDowngrade;

package/dist/src/learner.js

@@ -0,0 +1,30 @@
+// E5 impl — learner downgrade proposal with 50-gig floor (§8 constraint 10 applied).
+const MIN_DATA_POINTS = 50;
+export function learnerProposeDowngrade(input) {
+    const n = input.observations.length;
+    if (n < MIN_DATA_POINTS) {
+        return { ok: false, violation: "insufficient_evidence" };
+    }
+    const successCount = input.observations.filter((o) => o.success).length;
+    const totalCost = input.observations.reduce((a, o) => a + o.cost, 0);
+    const totalDuration = input.observations.reduce((a, o) => a + o.duration_ms, 0);
+    // §8 constraint 11: coltrane cannot self-approve
+    const approverIsColtrane = !!input.auto_approve_as &&
+        (input.auto_approve_as === "coltrane" || input.auto_approve_as.startsWith("coltrane:"));
+    const proposal = {
+        agent_slug: input.agent_slug,
+        from_tier: input.from_tier,
+        to_tier: input.to_tier,
+        data_points: n,
+        evidence_summary: {
+            success_rate: successCount / n,
+            avg_cost: totalCost / n,
+            avg_duration_ms: totalDuration / n,
+        },
+        requires_human_approval: true,
+        auto_approved: !approverIsColtrane && !!input.auto_approve_as,
+    };
+    return { ok: true, proposal };
+}
+export const learnerProposeDowngradeResult = learnerProposeDowngrade;
+//# sourceMappingURL=learner.js.map

package/dist/src/learner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learner.js","sourceRoot":"","sources":["../../src/learner.ts"],"names":[],"mappings":"AAAA,qFAAqF;AA0CrF,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B,MAAM,UAAU,uBAAuB,CACrC,KAAmC;IAEnC,MAAM,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC;IACpC,IAAI,CAAC,GAAG,eAAe,EAAE,CAAC;QACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,uBAAuB,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACxE,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACrE,MAAM,aAAa,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAEhF,iDAAiD;IACjD,MAAM,kBAAkB,GACtB,CAAC,CAAC,KAAK,CAAC,eAAe;QACvB,CAAC,KAAK,CAAC,eAAe,KAAK,UAAU,IAAI,KAAK,CAAC,eAAe,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IAE1F,MAAM,QAAQ,GAAsB;QAClC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE,CAAC;QACd,gBAAgB,EAAE;YAChB,YAAY,EAAE,YAAY,GAAG,CAAC;YAC9B,QAAQ,EAAE,SAAS,GAAG,CAAC;YACvB,eAAe,EAAE,aAAa,GAAG,CAAC;SACnC;QACD,uBAAuB,EAAE,IAAI;QAC7B,aAAa,EAAE,CAAC,kBAAkB,IAAI,CAAC,CAAC,KAAK,CAAC,eAAe;KAC9D,CAAC;IAEF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,MAAM,6BAA6B,GAAG,uBAAuB,CAAC"}