cueline 0.1.6 → 0.2.0

package/dist/src/protocol/lint-command.js

@@ -0,0 +1,210 @@
+import path from "node:path";
+import { CueLineError } from "../core/errors.js";
+import { validateControllerCommand } from "./validate-command.js";
+const CONTROL_ENVELOPE = /<CueLineControl>([\s\S]*?)<\/CueLineControl>/g;
+const BASE_FIELDS = new Set(["protocol", "run_id", "round", "request_id", "action"]);
+const ACTION_FIELDS = new Set([
+    "jobs",
+    "job_ids",
+    "wait_ms",
+    "final_delivery_text",
+    "reason",
+]);
+const ACTION_ALLOWED_FIELDS = {
+    dispatch: new Set(["jobs"]),
+    wait: new Set(["job_ids", "wait_ms"]),
+    inspect: new Set(["job_ids"]),
+    complete: new Set(["final_delivery_text"]),
+    blocked: new Set(["reason", "final_delivery_text"]),
+};
+const JOB_FIELDS = new Set([
+    "job_key",
+    "lane",
+    "mode",
+    "task",
+    "required",
+    "timeout_ms",
+    "runner",
+    "workdir",
+    "background",
+]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parsePayload(text) {
+    let body;
+    for (const match of text.matchAll(CONTROL_ENVELOPE))
+        body = match[1];
+    const format = body === undefined ? "json" : "envelope";
+    const source = body ?? text;
+    try {
+        return { format, value: JSON.parse(source.trim()) };
+    }
+    catch {
+        return {
+            format: body === undefined && text.trim() === "" ? "unknown" : format,
+            issue: {
+                code: "CONTROL_JSON_INVALID",
+                severity: "error",
+                message: "The control input is not valid JSON.",
+                suggestion: "Provide one complete <CueLineControl> JSON envelope or a raw JSON object.",
+            },
+        };
+    }
+}
+function issueFromError(error) {
+    if (error instanceof CueLineError) {
+        return { code: error.code, severity: "error", message: error.message };
+    }
+    return {
+        code: "CONTROL_LINT_FAILED",
+        severity: "error",
+        message: error instanceof Error ? error.message : "Control validation failed.",
+    };
+}
+function staticIssues(value, routing) {
+    const issues = [];
+    const allowedForAction = typeof value.action === "string" ? ACTION_ALLOWED_FIELDS[value.action] : undefined;
+    for (const field of Object.keys(value)) {
+        if (BASE_FIELDS.has(field))
+            continue;
+        if (ACTION_FIELDS.has(field)) {
+            if (allowedForAction === undefined || allowedForAction.has(field))
+                continue;
+            issues.push({
+                code: "CONTROL_FIELD_NOT_ALLOWED_FOR_ACTION",
+                severity: "error",
+                message: `Field '${field}' is not valid for controller action '${String(value.action)}'.`,
+                path: `$.${field}`,
+                suggestion: `Remove '${field}' or use the action that defines it.`,
+            });
+            continue;
+        }
+        issues.push({
+            code: "CONTROL_FIELD_UNKNOWN",
+            severity: "error",
+            message: `Unsupported top-level controller field '${field}'.`,
+            path: `$.${field}`,
+            suggestion: "Remove the field or move the value to the documented action-specific field.",
+        });
+    }
+    if (!Array.isArray(value.jobs))
+        return issues;
+    value.jobs.forEach((candidate, index) => {
+        if (!isRecord(candidate))
+            return;
+        const prefix = `$.jobs[${index}]`;
+        if ("prompt" in candidate) {
+            issues.push({
+                code: "LEGACY_PROMPT_FIELD",
+                severity: "error",
+                message: "Dispatch jobs require 'task'; 'prompt' is not a controller job field.",
+                path: `${prefix}.prompt`,
+                suggestion: "Rename 'prompt' to 'task' without changing its text.",
+            });
+        }
+        if ("runner_id" in candidate) {
+            issues.push({
+                code: "LEGACY_RUNNER_ID_FIELD",
+                severity: "error",
+                message: "Dispatch jobs use optional 'runner'; 'runner_id' is unsupported.",
+                path: `${prefix}.runner_id`,
+                suggestion: "Rename 'runner_id' to 'runner'.",
+            });
+        }
+        const lane = candidate.lane;
+        if (routing !== undefined && typeof lane === "string" && !routing.lanes.includes(lane)) {
+            const runnerLane = Object.hasOwn(routing.runnerLanes, lane)
+                ? routing.runnerLanes[lane]
+                : undefined;
+            if (runnerLane !== undefined) {
+                issues.push({
+                    code: "RUNNER_USED_AS_LANE",
+                    severity: "error",
+                    message: `'${lane}' is a runner ID, not a configured lane.`,
+                    path: `${prefix}.lane`,
+                    suggestion: `Use lane '${runnerLane}' and runner '${lane}'.`,
+                });
+            }
+            else {
+                issues.push({
+                    code: "ROUTE_LANE_UNKNOWN",
+                    severity: "error",
+                    message: `Lane '${lane}' is not present in the active routing configuration.`,
+                    path: `${prefix}.lane`,
+                    suggestion: `Use one of: ${routing.lanes.join(", ") || "<no enabled lanes>"}.`,
+                });
+            }
+        }
+        if (candidate.mode === "work") {
+            if (typeof candidate.workdir !== "string" || candidate.workdir.trim() === "") {
+                issues.push({
+                    code: "WORKDIR_REQUIRED",
+                    severity: "error",
+                    message: "Caller work requires the exact absolute local workdir.",
+                    path: `${prefix}.workdir`,
+                    suggestion: "Add the absolute repository or worktree path known to the local Codex.",
+                });
+            }
+            else if (!path.isAbsolute(candidate.workdir)) {
+                issues.push({
+                    code: "WORKDIR_NOT_ABSOLUTE",
+                    severity: "error",
+                    message: "Caller workdir must be absolute.",
+                    path: `${prefix}.workdir`,
+                    suggestion: "Replace the relative path with the exact absolute local worktree path.",
+                });
+            }
+        }
+        for (const field of Object.keys(candidate)) {
+            if (JOB_FIELDS.has(field) || field === "prompt" || field === "runner_id")
+                continue;
+            issues.push({
+                code: "CONTROL_JOB_FIELD_UNKNOWN",
+                severity: "error",
+                message: `Unsupported dispatch job field '${field}'.`,
+                path: `${prefix}.${field}`,
+                suggestion: "Remove the field and use only documented CueLine job fields.",
+            });
+        }
+    });
+    return issues;
+}
+export function lintControllerCommandText(text, options) {
+    const parsed = parsePayload(text);
+    if (parsed.issue !== undefined) {
+        return { valid: false, format: parsed.format, issues: [parsed.issue] };
+    }
+    if (!isRecord(parsed.value)) {
+        return {
+            valid: false,
+            format: parsed.format,
+            issues: [
+                {
+                    code: "CONTROL_COMMAND_INVALID",
+                    severity: "error",
+                    message: "Controller command must be a JSON object.",
+                },
+            ],
+        };
+    }
+    const issues = staticIssues(parsed.value, options.routing);
+    let command;
+    try {
+        command = validateControllerCommand(parsed.value, options.expected);
+    }
+    catch (error) {
+        const validationIssue = issueFromError(error);
+        if (!issues.some((issue) => issue.code === validationIssue.code)) {
+            issues.push(validationIssue);
+        }
+    }
+    const valid = issues.every((issue) => issue.severity !== "error");
+    return {
+        valid,
+        format: parsed.format,
+        ...(valid && command !== undefined ? { command } : {}),
+        issues,
+    };
+}
+//# sourceMappingURL=lint-command.js.map

package/dist/src/protocol/lint-command.js.map

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

package/dist/src/protocol/parse-command.js

@@ -1,4 +1,5 @@
 import { CueLineError } from "../core/errors.js";
+import { MAX_CONTROLLER_ENVELOPE_CHARS } from "./limits.js";
 import { validateControllerCommand } from "./validate-command.js";
 const CONTROL_ENVELOPE = /<CueLineControl>([\s\S]*?)<\/CueLineControl>/g;
 export function parseControllerCommand(text, expected) {
@@ -9,6 +10,9 @@ export function parseControllerCommand(text, expected) {
     if (body === undefined) {
         throw new CueLineError("CONTROL_ENVELOPE_MISSING", "No complete <CueLineControl> envelope was found.");
     }
+    if (body.length > MAX_CONTROLLER_ENVELOPE_CHARS) {
+        throw new CueLineError("CONTROL_ENVELOPE_TOO_LARGE", `Control envelope exceeds the ${MAX_CONTROLLER_ENVELOPE_CHARS}-character protocol limit.`, { details: { maximum_chars: MAX_CONTROLLER_ENVELOPE_CHARS } });
+    }
     let parsed;
     try {
         parsed = JSON.parse(body.trim());

package/dist/src/protocol/parse-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse-command.js","sourceRoot":"","sources":["../../../src/protocol/parse-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,gBAAgB,GAAG,+CAA+C,CAAC;AAEzE,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,QAAoC;IAEpC,IAAI,IAAwB,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACpD,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CACpB,0BAA0B,EAC1B,kDAAkD,CACnD,CAAC;IACJ,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,sBAAsB,EAAE,yCAAyC,EAAE;YACxF,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IACD,OAAO,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC"}
+{"version":3,"file":"parse-command.js","sourceRoot":"","sources":["../../../src/protocol/parse-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,gBAAgB,GAAG,+CAA+C,CAAC;AAEzE,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,QAAoC;IAEpC,IAAI,IAAwB,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACpD,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CACpB,0BAA0B,EAC1B,kDAAkD,CACnD,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,6BAA6B,EAAE,CAAC;QAChD,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,gCAAgC,6BAA6B,4BAA4B,EACzF,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,6BAA6B,EAAE,EAAE,CAC9D,CAAC;IACJ,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,sBAAsB,EAAE,yCAAyC,EAAE;YACxF,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IACD,OAAO,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC"}

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

@@ -36,6 +36,10 @@ export interface WaitCommand extends ControllerCommandBase {
 export interface InspectCommand extends ControllerCommandBase {
     action: "inspect";
     job_ids?: string[];
+    /** Raw-character offset into one explicitly selected job's preferred evidence field. */
+    evidence_offset?: number;
+    /** SHA-256 identity copied from the selected evidence window. */
+    evidence_hash?: string;
 }
 export interface CompleteCommand extends ControllerCommandBase {
     action: "complete";
@@ -54,6 +58,14 @@ export interface JobObservation {
     status: "pending" | "running" | "succeeded" | "failed" | "timed_out" | "cancelled" | "ambiguous";
     output?: string;
     error?: string;
+    evidence_window?: {
+        field: "output" | "error";
+        offset: number;
+        end: number;
+        total_chars: number;
+        next_offset: number | null;
+        content_hash: string;
+    };
 }
 export interface ControllerObservation {
     protocol: typeof CUELINE_PROTOCOL;

package/dist/src/protocol/validate-command.js

@@ -1,7 +1,21 @@
 import { CueLineError } from "../core/errors.js";
+import { MAX_CONTROLLER_DISPATCH_JOBS, MAX_CONTROLLER_JOB_IDS, } from "./limits.js";
 import { CUELINE_PROTOCOL, } from "./types.js";
 const JOB_KEY_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
 const LANE_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+const JOB_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
+const COMMON_COMMAND_FIELDS = ["protocol", "run_id", "round", "request_id", "action"];
+const ACTION_COMMAND_FIELDS = new Map([
+    ["dispatch", new Set([...COMMON_COMMAND_FIELDS, "jobs"])],
+    ["wait", new Set([...COMMON_COMMAND_FIELDS, "job_ids", "wait_ms"])],
+    [
+        "inspect",
+        new Set([...COMMON_COMMAND_FIELDS, "job_ids", "evidence_offset", "evidence_hash"]),
+    ],
+    ["complete", new Set([...COMMON_COMMAND_FIELDS, "final_delivery_text"])],
+    ["blocked", new Set([...COMMON_COMMAND_FIELDS, "reason", "final_delivery_text"])],
+]);
+const ALL_COMMAND_FIELDS = new Set([...ACTION_COMMAND_FIELDS.values()].flatMap((fields) => [...fields]));
 const JOB_FIELDS = new Set([
     "job_key",
     "lane",
@@ -19,6 +33,20 @@ function isRecord(value) {
 function fail(message, details) {
     throw new CueLineError("CONTROL_COMMAND_INVALID", message, { details });
 }
+function isControllerAction(value) {
+    return ACTION_COMMAND_FIELDS.has(value);
+}
+function assertCommandFields(record, action) {
+    const unknownField = Object.keys(record).find((key) => !ALL_COMMAND_FIELDS.has(key));
+    if (unknownField !== undefined) {
+        throw new CueLineError("CONTROL_COMMAND_FIELD_UNKNOWN", `Unsupported controller command field '${unknownField}'.`, { details: { field: unknownField, action } });
+    }
+    const allowed = ACTION_COMMAND_FIELDS.get(action);
+    const invalidField = Object.keys(record).find((key) => !allowed.has(key));
+    if (invalidField !== undefined) {
+        throw new CueLineError("CONTROL_COMMAND_FIELD_INVALID_FOR_ACTION", `Controller command field '${invalidField}' is not valid for action '${action}'.`, { details: { field: invalidField, action } });
+    }
+}
 function requiredString(record, key) {
     const value = record[key];
     if (typeof value !== "string" || value.trim() === "") {
@@ -56,13 +84,28 @@ function optionalPositiveInteger(record, key, maximum) {
     }
     return value;
 }
+function optionalNonNegativeInteger(record, key, maximum) {
+    const value = record[key];
+    if (value === undefined)
+        return undefined;
+    if (!Number.isSafeInteger(value) || value < 0 || value > maximum) {
+        return fail(`'${key}' must be an integer from 0 to ${maximum}.`, { key });
+    }
+    return value;
+}
 function optionalStringArray(record, key) {
     const value = record[key];
     if (value === undefined) {
         return undefined;
     }
-    if (!Array.isArray(value) || value.some((item) => typeof item !== "string" || item === "")) {
-        return fail(`'${key}' must be an array of non-empty strings.`, { key });
+    if (Array.isArray(value) && value.length > MAX_CONTROLLER_JOB_IDS) {
+        throw new CueLineError("CONTROL_JOB_IDS_LIMIT_EXCEEDED", `'${key}' may contain at most ${MAX_CONTROLLER_JOB_IDS} job IDs.`, { details: { key, maximum_items: MAX_CONTROLLER_JOB_IDS } });
+    }
+    if (!Array.isArray(value) ||
+        value.length === 0 ||
+        value.some((item) => typeof item !== "string" || !JOB_ID_PATTERN.test(item)) ||
+        new Set(value).size !== value.length) {
+        return fail(`'${key}' must be a non-empty array of unique job IDs.`, { key });
     }
     return [...value];
 }
@@ -74,7 +117,9 @@ function validateJob(value) {
     if (unknownField !== undefined) {
         const correction = unknownField === "runner_id"
             ? " Use 'runner'; 'runner_id' is not part of the CueLine controller contract."
-            : "";
+            : unknownField === "prompt"
+                ? " Use 'task'; 'prompt' is not part of a CueLine dispatch job."
+                : "";
         throw new CueLineError("CONTROL_JOB_FIELD_UNKNOWN", `Unsupported dispatch job field '${unknownField}'.${correction}`, { details: { field: unknownField } });
     }
     const jobKey = requiredString(value, "job_key");
@@ -139,6 +184,10 @@ export function validateControllerCommand(value, expected) {
     }
     validateIdentity(value, expected);
     const action = requiredString(value, "action");
+    if (!isControllerAction(action)) {
+        return fail(`Unsupported controller action '${action}'.`, { action });
+    }
+    assertCommandFields(value, action);
     const base = {
         protocol: CUELINE_PROTOCOL,
         run_id: expected.runId,
@@ -149,6 +198,9 @@ export function validateControllerCommand(value, expected) {
         if (!Array.isArray(value.jobs) || value.jobs.length === 0) {
             return fail("A dispatch command requires at least one job.");
         }
+        if (value.jobs.length > MAX_CONTROLLER_DISPATCH_JOBS) {
+            throw new CueLineError("CONTROL_DISPATCH_JOBS_LIMIT_EXCEEDED", `A dispatch command may contain at most ${MAX_CONTROLLER_DISPATCH_JOBS} jobs.`, { details: { maximum_items: MAX_CONTROLLER_DISPATCH_JOBS } });
+        }
         const jobs = value.jobs.map(validateJob);
         const seen = new Set();
         for (const job of jobs) {
@@ -172,8 +224,29 @@ export function validateControllerCommand(value, expected) {
     if (action === "inspect") {
         const command = { ...base, action };
         const jobIds = optionalStringArray(value, "job_ids");
+        const evidenceOffset = optionalNonNegativeInteger(value, "evidence_offset", 1_000_000_000);
+        const evidenceHash = optionalString(value, "evidence_hash");
+        if ((evidenceOffset === undefined) !== (evidenceHash === undefined)) {
+            return fail("'evidence_offset' and 'evidence_hash' must be provided together.", {
+                field: "evidence_offset",
+            });
+        }
+        if (evidenceOffset !== undefined && jobIds?.length !== 1) {
+            return fail("Paginated evidence requires exactly one explicit 'job_ids' entry.", {
+                field: "job_ids",
+            });
+        }
+        if (evidenceHash !== undefined && !/^[0-9a-f]{64}$/.test(evidenceHash)) {
+            return fail("'evidence_hash' must be the exact lowercase SHA-256 from evidence_window.", {
+                field: "evidence_hash",
+            });
+        }
         if (jobIds !== undefined)
             command.job_ids = jobIds;
+        if (evidenceOffset !== undefined)
+            command.evidence_offset = evidenceOffset;
+        if (evidenceHash !== undefined)
+            command.evidence_hash = evidenceHash;
         return command;
     }
     if (action === "complete") {

package/dist/src/protocol/validate-command.js.map

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

package/dist/src/router/config-loader.js

@@ -1,15 +1,29 @@
 import { readFile } from "node:fs/promises";
 import { CueLineError } from "../core/errors.js";
+const CONFIG_FIELDS = new Set(["$schema", "version", "lanes"]);
+const LANE_FIELDS = new Set(["enabled", "candidates"]);
+const CANDIDATE_FIELDS = new Set(["id", "argv", "task_input", "enabled"]);
+const LANE_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function invalid(message, details) {
     return new CueLineError("ROUTING_CONFIG_INVALID", message, { details });
 }
+function assertKnownFields(value, allowed, scope, details = {}) {
+    const field = Object.keys(value).find((candidate) => !allowed.has(candidate));
+    if (field !== undefined) {
+        throw invalid(`${scope} contains unsupported field '${field}'`, {
+            ...details,
+            field,
+        });
+    }
+}
 function parseCandidate(value, lane, index) {
     if (!isRecord(value)) {
         throw invalid("route candidate must be an object", { lane, index });
     }
+    assertKnownFields(value, CANDIDATE_FIELDS, "route candidate", { lane, index });
     const { id, argv, task_input, enabled } = value;
     if (typeof id !== "string" || id.trim().length === 0) {
         throw invalid("route candidate id must be a non-empty string", { lane, index });
@@ -34,6 +48,7 @@ function parseLane(value, lane) {
     if (!isRecord(value)) {
         throw invalid("lane configuration must be an object", { lane });
     }
+    assertKnownFields(value, LANE_FIELDS, "lane configuration", { lane });
     const { enabled, candidates } = value;
     if (typeof enabled !== "boolean") {
         throw invalid("lane enabled must be a boolean", { lane });
@@ -55,6 +70,12 @@ export function parseRoutingConfig(value) {
     if (!isRecord(value)) {
         throw invalid("routing configuration must be an object");
     }
+    assertKnownFields(value, CONFIG_FIELDS, "routing configuration");
+    if (value.$schema !== undefined && typeof value.$schema !== "string") {
+        throw invalid("routing configuration $schema must be a string", {
+            field: "$schema",
+        });
+    }
     if (value.version !== 1) {
         throw invalid("routing configuration version must be 1", { version: value.version });
     }
@@ -63,8 +84,8 @@ export function parseRoutingConfig(value) {
     }
     const lanes = {};
     for (const [lane, laneValue] of Object.entries(value.lanes)) {
-        if (lane.trim().length === 0) {
-            throw invalid("lane name must be non-empty");
+        if (!LANE_PATTERN.test(lane)) {
+            throw invalid("lane name contains unsupported characters", { lane });
         }
         lanes[lane] = parseLane(laneValue, lane);
     }

package/dist/src/router/config-loader.js.map

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

package/dist/src/router/explain.d.ts

@@ -0,0 +1,28 @@
+import type { RouteAvailability, RoutingConfig } from "./types.js";
+export type RoutingCandidateReasonCode = "AVAILABLE_FALLBACK" | "LANE_DISABLED" | "RUNNER_DISABLED" | "RUNNER_UNAVAILABLE" | "SELECTED_FIRST_AVAILABLE";
+export interface RoutingCandidateExplanation {
+    id: string;
+    index: number;
+    enabled: boolean;
+    available: boolean | null;
+    selected: boolean;
+    reasonCode: RoutingCandidateReasonCode;
+}
+export interface RoutingLaneExplanation {
+    name: string;
+    enabled: boolean;
+    status: "available" | "disabled" | "unavailable";
+    selectedRunnerId: string | null;
+    candidates: RoutingCandidateExplanation[];
+    errorCode?: "ROUTE_NO_CANDIDATE";
+}
+export interface RoutingExplanation {
+    requestedLane: string | null;
+    availableLanes: number;
+    lanes: RoutingLaneExplanation[];
+    findings: Array<{
+        code: string;
+        message: string;
+    }>;
+}
+export declare function explainRoutingConfig(config: RoutingConfig, availability: RouteAvailability, requestedLane?: string): RoutingExplanation;

package/dist/src/router/explain.js

@@ -0,0 +1,86 @@
+import { routeCandidateIsAvailable } from "./resolver.js";
+export function explainRoutingConfig(config, availability, requestedLane) {
+    const requestedLaneName = requestedLane ?? null;
+    if (requestedLane !== undefined && !Object.hasOwn(config.lanes, requestedLane)) {
+        return {
+            requestedLane: requestedLaneName,
+            availableLanes: 0,
+            lanes: [],
+            findings: [
+                {
+                    code: "ROUTE_LANE_UNKNOWN",
+                    message: "Requested lane is not configured.",
+                },
+            ],
+        };
+    }
+    const entries = requestedLane === undefined
+        ? Object.entries(config.lanes)
+        : [[requestedLane, config.lanes[requestedLane]]];
+    const lanes = [];
+    for (const [name, lane] of entries) {
+        if (lane === undefined)
+            continue;
+        if (!lane.enabled) {
+            lanes.push({
+                name,
+                enabled: false,
+                status: "disabled",
+                selectedRunnerId: null,
+                candidates: lane.candidates.map((candidate, index) => ({
+                    id: candidate.id,
+                    index,
+                    enabled: candidate.enabled !== false,
+                    available: null,
+                    selected: false,
+                    reasonCode: "LANE_DISABLED",
+                })),
+            });
+            continue;
+        }
+        let selectedRunnerId = null;
+        const candidates = lane.candidates.map((candidate, index) => {
+            if (candidate.enabled === false) {
+                return {
+                    id: candidate.id,
+                    index,
+                    enabled: false,
+                    available: null,
+                    selected: false,
+                    reasonCode: "RUNNER_DISABLED",
+                };
+            }
+            const available = routeCandidateIsAvailable(availability, candidate, name);
+            const selected = available && selectedRunnerId === null;
+            if (selected)
+                selectedRunnerId = candidate.id;
+            return {
+                id: candidate.id,
+                index,
+                enabled: true,
+                available,
+                selected,
+                reasonCode: !available
+                    ? "RUNNER_UNAVAILABLE"
+                    : selected
+                        ? "SELECTED_FIRST_AVAILABLE"
+                        : "AVAILABLE_FALLBACK",
+            };
+        });
+        lanes.push({
+            name,
+            enabled: true,
+            status: selectedRunnerId === null ? "unavailable" : "available",
+            selectedRunnerId,
+            candidates,
+            ...(selectedRunnerId === null ? { errorCode: "ROUTE_NO_CANDIDATE" } : {}),
+        });
+    }
+    return {
+        requestedLane: requestedLaneName,
+        availableLanes: lanes.filter((lane) => lane.status === "available").length,
+        lanes,
+        findings: [],
+    };
+}
+//# sourceMappingURL=explain.js.map