@relayflows/sdk 2.0.0

package/dist/unknown-keys.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Produce author-facing diagnostics for keys outside a closed schema. A key
+ * that differs only in casing/separators always matches; otherwise a small
+ * edit distance catches plain misspellings.
+ */
+export declare function unknownKeyErrors(object: Record<string, unknown>, allowed: readonly string[], at: string): string[];
+//# sourceMappingURL=unknown-keys.d.ts.map

package/dist/unknown-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-keys.d.ts","sourceRoot":"","sources":["../src/unknown-keys.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,EAAE,EAAE,MAAM,GACT,MAAM,EAAE,CAYV"}

package/dist/unknown-keys.js

@@ -0,0 +1,47 @@
+/**
+ * Produce author-facing diagnostics for keys outside a closed schema. A key
+ * that differs only in casing/separators always matches; otherwise a small
+ * edit distance catches plain misspellings.
+ */
+export function unknownKeyErrors(object, allowed, at) {
+    const errors = [];
+    for (const key of Object.keys(object)) {
+        if (allowed.includes(key))
+            continue;
+        const suggestion = nearestKey(key, allowed);
+        errors.push(suggestion !== null
+            ? `${at}: unknown key "${key}" — did you mean "${suggestion}"?`
+            : `${at}: unknown key "${key}" (expected one of ${allowed.join(' | ')})`);
+    }
+    return errors;
+}
+function nearestKey(key, allowed) {
+    const normalize = (value) => value.toLowerCase().replace(/[_-]/g, '');
+    let best = null;
+    let bestDistance = Number.POSITIVE_INFINITY;
+    for (const candidate of allowed) {
+        if (normalize(candidate) === normalize(key))
+            return candidate;
+        const distance = levenshtein(key.toLowerCase(), candidate.toLowerCase());
+        if (distance < bestDistance) {
+            bestDistance = distance;
+            best = candidate;
+        }
+    }
+    return best !== null && bestDistance <= 3 && bestDistance < best.length ? best : null;
+}
+function levenshtein(a, b) {
+    let previous = Array.from({ length: b.length + 1 }, (_, i) => i);
+    for (let i = 1; i <= a.length; i++) {
+        const current = [i];
+        for (let j = 1; j <= b.length; j++) {
+            const deletion = (previous[j] ?? 0) + 1;
+            const insertion = (current[j - 1] ?? 0) + 1;
+            const substitution = (previous[j - 1] ?? 0) + (a[i - 1] === b[j - 1] ? 0 : 1);
+            current[j] = Math.min(deletion, insertion, substitution);
+        }
+        previous = current;
+    }
+    return previous[b.length] ?? 0;
+}
+//# sourceMappingURL=unknown-keys.js.map

package/dist/unknown-keys.js.map

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

package/dist/validate.d.ts

@@ -0,0 +1,7 @@
+export interface ValidationResult {
+    ok: boolean;
+    errors: string[];
+}
+/** Validate a parsed spec object. Returns `{ok, errors}`; never throws. */
+export declare function validateSpec(spec: unknown): ValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAgCA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAubD,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAS5D"}

package/dist/validate.js

@@ -0,0 +1,458 @@
+// Spec validation — fail-closed (AGENTS.md rule 4). The compiler runs every
+// spec through this before emitting JSON; a malformed spec is rejected with a
+// concrete error, never silently coerced. Zero-agent flows are legal: there is
+// no requirement that any step be `llm` or `agent`.
+import { SPEC_SCHEMA_VERSION } from './spec.js';
+import { validateOutputDeclaration } from './output-schema.js';
+import { modelNameError } from './model-name.js';
+import { unknownKeyErrors } from './unknown-keys.js';
+import { stepDependencyErrors } from './step-dependencies.js';
+import { AGENT_DECLARATION_FIELDS, FLOW_FIELDS, STEP_COMMON_FIELDS, STEP_FIELDS_BY_TYPE, } from './step-fields.js';
+import { jsonSchemaError, snapshotJsonSchema } from './json-schema.js';
+import { snapshotJsonValue } from './json-value.js';
+const STEP_TYPES = new Set([
+    'deterministic',
+    'llm',
+    'agent',
+]);
+const RECOVERY_MODES = new Set([
+    'reset',
+    'inspect',
+    'manual',
+]);
+const DECIMAL_RE = /^\d+(\.\d+)?$/;
+function isCanonicalPathSurface(value) {
+    if (!isNonEmptyString(value) || value.trim() !== value)
+        return false;
+    let tail = value;
+    if (tail.startsWith('/'))
+        tail = tail.slice(1);
+    else {
+        const scheme = tail.indexOf('://');
+        if (scheme >= 0) {
+            if (scheme === 0 || tail.slice(0, scheme).includes('/'))
+                return false;
+            tail = tail.slice(scheme + 3);
+        }
+    }
+    if (tail === '')
+        return true;
+    return tail.split('/').every((part) => part !== '' && part !== '.' && part !== '..');
+}
+// Allowed keys per authoring object level. Validation is fail-closed on
+// unknown keys (AGENTS.md rule 4; RFC covenant 2): a typo'd key like
+// `depends_on` must be an error naming the nearest valid key, never a
+// silently discarded field — silently dropping `dependsOn` loses ordering.
+const BUDGET_KEYS = ['maxTokensIn', 'maxTokensOut', 'maxDollars'];
+const VERIFICATION_KEYS = {
+    exit_code: ['type', 'expect'],
+    output_contains: ['type', 'value'],
+    json_schema: ['type', 'schema'],
+};
+const SURFACES_KEYS = ['workspace', 'streams', 'external'];
+const WORKSPACE_SURFACE_KEYS = ['surface'];
+const STREAM_SURFACE_KEYS = ['stream'];
+const PERMISSIONS_KEYS = ['fileGlobs', 'networkAllowlist', 'accessPreset'];
+// A trigger may also declare an event subscription. Without these keys the
+// compiler rejects the very fixture the kernel advertises
+// (testdata/event-triggered-flow.yaml), so the feature is unauthorable through
+// the supported SDK path even though the kernel accepts it.
+const TRIGGER_KEYS = [
+    'id',
+    'executor',
+    'eventType',
+    'pattern',
+    'dedupeKeyTemplate',
+    'staleAfterMs',
+];
+/**
+ * The kernel stores a silence budget as SQLite `INTEGER` and compares it in
+ * `i64` (`TriggerSpec::effective_stale_after_ms`), refusing anything wider.
+ * Mirror the bound here so an unrepresentable budget is a compile error rather
+ * than an engine error at submit time — a budget the sweep cannot represent
+ * fails OPEN, which is the silent death this field exists to prevent.
+ *
+ * The bound is `Number.MAX_SAFE_INTEGER`, NOT `i64::MAX`. Writing the i64
+ * bound as a JS literal does not express it: `9_223_372_036_854_775_807`
+ * rounds UP to 2^63 in a double, so `value > MAX` then ADMITTED exactly the
+ * one value the kernel refuses — the SDK/kernel-agreement failure this whole
+ * file exists to prevent, in miniature. Above 2^53 a JS number cannot name a
+ * specific integer at all, so any larger budget could not be transmitted
+ * faithfully even if the kernel would take it. 2^53 ms is ~285,000 years;
+ * nothing real is lost by refusing beyond it.
+ */
+const MAX_STALE_AFTER_MS = Number.MAX_SAFE_INTEGER;
+class Validator {
+    errors = [];
+    ids = new Set();
+    agentNames = new Set();
+    fail(msg) {
+        this.errors.push(msg);
+    }
+    /**
+     * Reject unknown keys at an authoring object level, suggesting the nearest
+     * valid key. Errors speak the author's vocabulary (RFC covenant 1):
+     * `unknown key "depends_on" — did you mean "dependsOn"?`.
+     */
+    checkKeys(obj, allowed, at) {
+        for (const error of unknownKeyErrors(obj, allowed, at))
+            this.fail(error);
+    }
+    result() {
+        return { ok: this.errors.length === 0, errors: this.errors };
+    }
+    run(spec) {
+        if (!isObject(spec)) {
+            this.fail('spec: expected an object');
+            return this.result();
+        }
+        const s = spec;
+        this.checkKeys(s, FLOW_FIELDS, 'spec');
+        if (!isNonEmptyString(s['version'])) {
+            this.fail(`spec.version: expected supported version "${SPEC_SCHEMA_VERSION}"`);
+        }
+        else if (s['version'] !== SPEC_SCHEMA_VERSION) {
+            this.fail(`spec.version: unsupported version "${s['version']}" (expected "${SPEC_SCHEMA_VERSION}")`);
+        }
+        if (s['name'] !== undefined && !isNonEmptyString(s['name'])) {
+            this.fail('spec.name: expected a non-empty string');
+        }
+        if (s['description'] !== undefined && typeof s['description'] !== 'string') {
+            this.fail('spec.description: expected a string');
+        }
+        if (s['cli'] !== undefined && !isNonEmptyString(s['cli'])) {
+            this.fail('spec.cli: expected a non-empty string');
+        }
+        if (s['agents'] !== undefined)
+            this.validateAgents(s['agents']);
+        if (s['triggers'] !== undefined)
+            this.validateTriggers(s['triggers']);
+        if (s['budget'] !== undefined)
+            this.validateBudget(s['budget']);
+        if (!Array.isArray(s['steps']) || s['steps'].length === 0) {
+            this.fail('spec.steps: expected a non-empty array');
+            return this.result();
+        }
+        const steps = s['steps'];
+        for (let i = 0; i < steps.length; i++) {
+            this.validateStep(steps[i], i);
+        }
+        // Dependents must reference real step ids and form a DAG (no cycles).
+        for (const error of stepDependencyErrors(steps, this.ids))
+            this.fail(error);
+        return this.result();
+    }
+    validateAgents(value) {
+        if (!isObject(value)) {
+            this.fail('spec.agents: expected a map of named { cli, model } declarations');
+            return;
+        }
+        for (const [name, raw] of Object.entries(value)) {
+            const at = `spec.agents.${name}`;
+            if (!isNonEmptyString(name) || name !== name.trim()) {
+                this.fail('spec.agents: agent names must be non-empty trimmed strings');
+                continue;
+            }
+            this.agentNames.add(name);
+            if (!isObject(raw)) {
+                this.fail(`${at}: expected an object with cli and model`);
+                continue;
+            }
+            this.checkKeys(raw, AGENT_DECLARATION_FIELDS, at);
+            const declaration = raw;
+            if (!isNonEmptyString(declaration.cli) || declaration.cli !== declaration.cli.trim()) {
+                this.fail(`${at}.cli: expected a non-empty trimmed string`);
+            }
+            this.validateModel(declaration.model, at, true);
+        }
+    }
+    validateBudget(b) {
+        if (!isObject(b)) {
+            this.fail('spec.budget: expected an object');
+            return;
+        }
+        this.checkKeys(b, BUDGET_KEYS, 'spec.budget');
+        const budget = b;
+        if (budget.maxTokensIn !== undefined &&
+            !isNonNegInt(budget.maxTokensIn)) {
+            this.fail('spec.budget.maxTokensIn: expected a non-negative integer');
+        }
+        if (budget.maxTokensOut !== undefined &&
+            !isNonNegInt(budget.maxTokensOut)) {
+            this.fail('spec.budget.maxTokensOut: expected a non-negative integer');
+        }
+        if (budget.maxDollars !== undefined) {
+            if (typeof budget.maxDollars !== 'string' || !DECIMAL_RE.test(budget.maxDollars)) {
+                this.fail('spec.budget.maxDollars: expected a decimal string, e.g. "1.50"');
+            }
+        }
+    }
+    validateTriggers(value) {
+        if (!Array.isArray(value)) {
+            this.fail('spec.triggers: expected an array');
+            return;
+        }
+        const ids = new Set();
+        for (const [index, trigger] of value.entries()) {
+            const at = `spec.triggers[${index}]`;
+            if (!isObject(trigger)) {
+                this.fail(`${at}: expected an object`);
+                continue;
+            }
+            this.checkKeys(trigger, TRIGGER_KEYS, at);
+            const candidate = trigger;
+            if (!isNonEmptyString(candidate.id)) {
+                this.fail(`${at}.id: expected a non-empty string`);
+            }
+            else if (ids.has(candidate.id)) {
+                this.fail(`${at}.id: duplicate trigger id "${candidate.id}"`);
+            }
+            else {
+                ids.add(candidate.id);
+            }
+            if (!isNonEmptyString(candidate.executor)) {
+                this.fail(`${at}.executor: expected a non-empty string`);
+            }
+            this.validateStaleAfterMs(candidate.staleAfterMs, `${at}.staleAfterMs`);
+        }
+    }
+    /**
+     * A silence budget must be a positive, i64-representable whole number of
+     * milliseconds. Zero is refused rather than treated as "no budget": a
+     * zero-length budget marks the subscription stale on the very next sweep,
+     * which reads as a permanently-broken schedule and trains an operator to
+     * ignore the alert.
+     */
+    validateStaleAfterMs(value, at) {
+        if (value === undefined)
+            return;
+        if (typeof value !== 'number' || !Number.isInteger(value)) {
+            this.fail(`${at}: expected an integer number of milliseconds`);
+            return;
+        }
+        if (value <= 0) {
+            this.fail(`${at}: expected a positive number of milliseconds, got ${value}`);
+            return;
+        }
+        if (value > MAX_STALE_AFTER_MS) {
+            this.fail(`${at}: ${value} exceeds ${MAX_STALE_AFTER_MS}, the largest budget that survives the `
+                + `SDK -> kernel boundary exactly (the sweep stores it as i64)`);
+        }
+    }
+    validateStep(step, index) {
+        const at = `spec.steps[${index}]`;
+        if (!isObject(step)) {
+            this.fail(`${at}: expected an object`);
+            return;
+        }
+        const st = step;
+        if (!isNonEmptyString(st['id'])) {
+            this.fail(`${at}.id: expected a non-empty string`);
+        }
+        else if (this.ids.has(st['id'])) {
+            this.fail(`${at}.id: duplicate step id "${st['id']}"`);
+        }
+        else {
+            this.ids.add(st['id']);
+        }
+        if (!isNonEmptyString(st['type']) || !STEP_TYPES.has(st['type'])) {
+            this.fail(`${at}.type: expected one of deterministic | llm | agent`);
+            return;
+        }
+        const type = st['type'];
+        this.checkKeys(st, [...STEP_COMMON_FIELDS, ...STEP_FIELDS_BY_TYPE[type]], at);
+        if (st['dependsOn'] !== undefined) {
+            if (!Array.isArray(st['dependsOn']) || !st['dependsOn'].every(isNonEmptyString)) {
+                this.fail(`${at}.dependsOn: expected an array of step ids`);
+            }
+        }
+        if (st['verification'] !== undefined) {
+            this.validateVerification(st['verification'], `${at}.verification`, type);
+        }
+        if (st['maxIterations'] !== undefined && !isPosInt(st['maxIterations'])) {
+            this.fail(`${at}.maxIterations: expected a positive integer`);
+        }
+        if (type === 'deterministic') {
+            this.validateDeterministic(st, at);
+        }
+        else if (type === 'llm') {
+            this.validateLlm(st, at);
+            for (const error of validateOutputDeclaration(st, at))
+                this.fail(error);
+        }
+        else {
+            this.validateAgent(st, at);
+            for (const error of validateOutputDeclaration(st, at))
+                this.fail(error);
+        }
+    }
+    validateVerification(v, at, stepType) {
+        if (!isObject(v)) {
+            this.fail(`${at}: expected an object`);
+            return;
+        }
+        const gate = v;
+        const gateKeys = typeof gate.type === 'string' ? VERIFICATION_KEYS[gate.type] : undefined;
+        if (gateKeys !== undefined) {
+            this.checkKeys(v, gateKeys, at);
+        }
+        if (gate.type === 'exit_code') {
+            if (stepType !== 'deterministic') {
+                this.fail(`${at}: exit_code is supported only on deterministic steps`);
+            }
+            // v0 judges exit_code == 0 exactly (kernel DESIGN.md §4). Fail closed
+            // rather than compile a spec whose gate the kernel cannot enforce.
+            if (gate.expect !== undefined && gate.expect !== 0) {
+                this.fail(`${at}.expect: v0 exit_code gate judges exit_code == 0; a custom expect is not supported`);
+            }
+        }
+        else if (gate.type === 'output_contains') {
+            if (typeof gate.value !== 'string' || gate.value.length === 0) {
+                this.fail(`${at}.value: expected a non-empty string`);
+            }
+        }
+        else if (gate.type === 'json_schema') {
+            try {
+                const schema = snapshotJsonSchema(gate.schema, `${at}.schema`);
+                const error = jsonSchemaError(schema);
+                if (error !== undefined) {
+                    this.fail(`${at}.schema: invalid JSON Schema: ${error}`);
+                }
+            }
+            catch (error) {
+                this.fail(error instanceof Error ? error.message : `${at}.schema: expected JSON-compatible data`);
+            }
+        }
+        else {
+            this.fail(`${at}.type: expected exit_code | output_contains | json_schema`);
+        }
+    }
+    validateDeterministic(st, at) {
+        if (!isNonEmptyString(st.command)) {
+            this.fail(`${at}.command: expected a non-empty string`);
+        }
+        if (st.timeoutMs !== undefined && !isPosInt(st.timeoutMs)) {
+            this.fail(`${at}.timeoutMs: expected a positive integer`);
+        }
+    }
+    validateLlm(st, at) {
+        if (!isNonEmptyString(st.prompt)) {
+            this.fail(`${at}.prompt: expected a non-empty string`);
+        }
+        this.validateModel(st.model, at);
+        this.validateCli(st.cli, at);
+    }
+    validateAgent(st, at) {
+        if (!isNonEmptyString(st.instruction)) {
+            this.fail(`${at}.instruction: expected a non-empty string`);
+        }
+        if (st.agent !== undefined) {
+            if (!isNonEmptyString(st.agent)) {
+                this.fail(`${at}.agent: expected a non-empty named agent`);
+            }
+            else if (!this.agentNames.has(st.agent)) {
+                this.fail(`${at}.agent: unknown named agent "${st.agent}"`);
+            }
+        }
+        if (st.recoveryMode !== undefined && !RECOVERY_MODES.has(st.recoveryMode)) {
+            this.fail(`${at}.recoveryMode: expected reset | inspect | manual`);
+        }
+        this.validateCli(st.cli, at);
+        this.validateModel(st.model, at);
+        if (st.surfaces !== undefined)
+            this.validateSurfaces(st.surfaces, `${at}.surfaces`);
+        if (st.permissions !== undefined)
+            this.validatePermissions(st.permissions, `${at}.permissions`);
+    }
+    validateCli(cli, at) {
+        if (cli !== undefined && !isNonEmptyString(cli)) {
+            this.fail(`${at}.cli: expected a non-empty string`);
+        }
+    }
+    validateModel(model, at, required = false) {
+        // Rejecting the empty string matters: it would reach the CLI as
+        // RELAYFLOW_MODEL='', which reads as "declared, and declared as
+        // nothing" — the CLI cannot tell it from a real value and would
+        // pass an empty --model. Absent and empty must not look alike.
+        if (model === undefined && !required)
+            return;
+        const problem = modelNameError(model);
+        if (problem !== undefined)
+            this.fail(`${at}.model: ${problem}`);
+    }
+    validateSurfaces(surfaces, at) {
+        if (!isObject(surfaces)) {
+            this.fail(`${at}: expected an object`);
+            return;
+        }
+        const s = surfaces;
+        this.checkKeys(s, SURFACES_KEYS, at);
+        if (s['workspace'] !== undefined) {
+            if (!Array.isArray(s['workspace']) || !s['workspace'].every((w) => isObject(w) && isCanonicalPathSurface(w['surface']))) {
+                this.fail(`${at}.workspace: expected canonical {surface: string} entries without empty, . or .. path components`);
+            }
+            else {
+                for (const [i, w] of s['workspace'].entries()) {
+                    this.checkKeys(w, WORKSPACE_SURFACE_KEYS, `${at}.workspace[${i}]`);
+                }
+            }
+        }
+        if (s['streams'] !== undefined) {
+            if (!Array.isArray(s['streams']) || !s['streams'].every((w) => isObject(w) && isNonEmptyString(w['stream']))) {
+                this.fail(`${at}.streams: expected an array of {stream: string}`);
+            }
+            else {
+                for (const [i, w] of s['streams'].entries()) {
+                    this.checkKeys(w, STREAM_SURFACE_KEYS, `${at}.streams[${i}]`);
+                }
+            }
+        }
+        if (s['external'] !== undefined) {
+            if (!Array.isArray(s['external']) || !s['external'].every(isCanonicalPathSurface)) {
+                this.fail(`${at}.external: expected canonical path strings without empty, . or .. components`);
+            }
+        }
+    }
+    validatePermissions(p, at) {
+        if (!isObject(p)) {
+            this.fail(`${at}: expected an object`);
+            return;
+        }
+        this.checkKeys(p, PERMISSIONS_KEYS, at);
+        if (p.accessPreset !== undefined && p.accessPreset !== 'readonly' && p.accessPreset !== 'readwrite') {
+            this.fail(`${at}.accessPreset: expected readonly | readwrite`);
+        }
+        if (p.fileGlobs !== undefined && !(Array.isArray(p.fileGlobs) && p.fileGlobs.every(isNonEmptyString))) {
+            this.fail(`${at}.fileGlobs: expected an array of strings`);
+        }
+        if (p.networkAllowlist !== undefined && !(Array.isArray(p.networkAllowlist) && p.networkAllowlist.every(isNonEmptyString))) {
+            this.fail(`${at}.networkAllowlist: expected an array of strings`);
+        }
+    }
+}
+/** Validate a parsed spec object. Returns `{ok, errors}`; never throws. */
+export function validateSpec(spec) {
+    try {
+        return new Validator().run(snapshotJsonValue(spec, 'spec'));
+    }
+    catch (error) {
+        return {
+            ok: false,
+            errors: [error instanceof Error ? error.message : 'spec: expected JSON-compatible data'],
+        };
+    }
+}
+// --- predicates -------------------------------------------------------------
+function isObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+function isNonEmptyString(v) {
+    return typeof v === 'string' && v.length > 0;
+}
+function isNonNegInt(v) {
+    return typeof v === 'number' && Number.isInteger(v) && v >= 0;
+}
+function isPosInt(v) {
+    return typeof v === 'number' && Number.isInteger(v) && v > 0;
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/dist/work-package-consumer.d.ts

@@ -0,0 +1,33 @@
+/** The work-package shape emitted at the SDK boundary. */
+export interface EmittedWorkPackage {
+    title: string;
+    files_in_scope: string[];
+    definition_of_done: string[];
+    description?: string;
+    gate?: number | null;
+}
+export type WorkPackageRefusalReason = 'missing_title' | 'missing_scope' | 'missing_definition_of_done' | 'nonexistent_files';
+export type WorkPackageConsumption = {
+    accepted: true;
+    work: EmittedWorkPackage;
+} | {
+    accepted: false;
+    reason: WorkPackageRefusalReason;
+};
+/** Resolve a scoped path; used to check that scoped files are really there. */
+export type PathExists = (path: string) => boolean;
+/**
+ * Validate an emitted package before admitting it as runnable work.
+ * Refusals are data so callers must handle an unverifiable package explicitly.
+ *
+ * The existence check is ON by default — review rejected making it opt-in
+ * (PR #28, P1): a caller using the one-argument API would silently skip it, so
+ * the guard would not guard. `pathExists` defaults to the real filesystem and
+ * is injectable purely so the behaviour can be tested without one. A package
+ * scoping files that are not there is refused: the picker derives files_in_scope from prose
+ * in ops/BACKLOG.md, so a stale or mistyped entry produces a package that reads
+ * as actionable and sends whoever picks it up looking for something that does
+ * not exist. Checking is cheap; a wrong scope is not.
+ */
+export declare function consumeWorkPackage(input: unknown, pathExists?: PathExists): WorkPackageConsumption;
+//# sourceMappingURL=work-package-consumer.d.ts.map

package/dist/work-package-consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-package-consumer.d.ts","sourceRoot":"","sources":["../src/work-package-consumer.ts"],"names":[],"mappings":"AAEA,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,MAAM,wBAAwB,GAChC,eAAe,GACf,eAAe,GACf,4BAA4B,GAC5B,mBAAmB,CAAC;AAExB,MAAM,MAAM,sBAAsB,GAC9B;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,GAC5C;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,wBAAwB,CAAA;CAAE,CAAC;AAE1D,+EAA+E;AAC/E,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;AAKnD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,UAAU,GAAE,UAA8B,GACzC,sBAAsB,CAiBxB"}

package/dist/work-package-consumer.js

@@ -0,0 +1,44 @@
+import { existsSync } from 'node:fs';
+/** Default: ask the filesystem. Injectable so the check is testable. */
+const defaultPathExists = (path) => existsSync(path);
+/**
+ * Validate an emitted package before admitting it as runnable work.
+ * Refusals are data so callers must handle an unverifiable package explicitly.
+ *
+ * The existence check is ON by default — review rejected making it opt-in
+ * (PR #28, P1): a caller using the one-argument API would silently skip it, so
+ * the guard would not guard. `pathExists` defaults to the real filesystem and
+ * is injectable purely so the behaviour can be tested without one. A package
+ * scoping files that are not there is refused: the picker derives files_in_scope from prose
+ * in ops/BACKLOG.md, so a stale or mistyped entry produces a package that reads
+ * as actionable and sends whoever picks it up looking for something that does
+ * not exist. Checking is cheap; a wrong scope is not.
+ */
+export function consumeWorkPackage(input, pathExists = defaultPathExists) {
+    if (!isRecord(input) || !isNonEmptyString(input['title'])) {
+        return { accepted: false, reason: 'missing_title' };
+    }
+    if (!isNonEmptyStringArray(input['files_in_scope'])) {
+        return { accepted: false, reason: 'missing_scope' };
+    }
+    if (isNonEmptyStringArray(input['files_in_scope'])) {
+        const missing = input['files_in_scope'].filter((p) => !pathExists(p));
+        if (missing.length > 0) {
+            return { accepted: false, reason: 'nonexistent_files' };
+        }
+    }
+    if (!isNonEmptyStringArray(input['definition_of_done'])) {
+        return { accepted: false, reason: 'missing_definition_of_done' };
+    }
+    return { accepted: true, work: input };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function isNonEmptyStringArray(value) {
+    return Array.isArray(value) && value.length > 0 && value.every(isNonEmptyString);
+}
+//# sourceMappingURL=work-package-consumer.js.map

package/dist/work-package-consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-package-consumer.js","sourceRoot":"","sources":["../src/work-package-consumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAwBrC,wEAAwE;AACxE,MAAM,iBAAiB,GAAe,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAEjE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAc,EACd,aAAyB,iBAAiB;IAE1C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC1D,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACtD,CAAC;IACD,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACtD,CAAC;IACD,IAAI,qBAAqB,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC;QACnD,MAAM,OAAO,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC;QACxD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACnE,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,KAAsC,EAAE,CAAC;AAC1E,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AACnF,CAAC"}