@formigio/fazemos-cli 0.10.23 → 0.10.25

package/dist/runbook/checks.d.ts

@@ -0,0 +1,78 @@
+import type { Finding } from '../yaml/load.js';
+/**
+ * Split a markdown step-doc into its YAML frontmatter block + body, then
+ * js-yaml-parse the block. The CLI already has a regex splitter for the
+ * `name:`-only agent-upload path (index.ts:7335) and vendors js-yaml — but it
+ * has no full-block parse + Runbook-shape awareness. This extends the splitter
+ * pattern (`^---\n…\n---`) and js-yaml-parses the whole block (F39 §9.1).
+ */
+export interface ParsedFrontmatter {
+    ok: boolean;
+    frontmatter?: Record<string, unknown>;
+    findings: Finding[];
+}
+export declare function parseFrontmatter(raw: string, source: string): ParsedFrontmatter;
+/**
+ * Walk up from `startDir` looking for the canonical schema at
+ * `projects/fazemos/runbooks/runbook.schema.json`. Returns the parsed JSON +
+ * its path, or null if not found within the clone (then the vendored copy is
+ * used as the fallback cache — F39 §9.2 lockstep decision).
+ */
+export declare function findCanonicalSchema(startDir: string): {
+    schema: any;
+    path: string;
+} | null;
+export interface FlipStateStep {
+    step_name: string;
+    runbook?: string;
+    step_type?: string;
+}
+export interface FlipStateTemplate {
+    template: string;
+    template_id?: string;
+    flipped: boolean;
+    flipped_at?: string | null;
+    steps?: FlipStateStep[];
+}
+export interface FlipState {
+    ledger_version?: string;
+    templates: FlipStateTemplate[];
+}
+/**
+ * Walk up from `startDir` for `projects/fazemos/runbooks/flip-state.json`.
+ * Returns { ledger } or { error } so the caller can emit
+ * `runbook.flip_state_unreadable` when the ledger can't be parsed (F39 §9.3).
+ */
+export declare function loadFlipState(startDir: string): {
+    ledger?: FlipState;
+    path?: string;
+    error?: string;
+};
+/** Find the flip-state entry whose `steps[].step_name` matches a step (by file basename). */
+export declare function flipStateForStep(ledger: FlipState | undefined, stepName: string): {
+    template: FlipStateTemplate;
+    step: FlipStateStep;
+} | null;
+export interface ValidateOptions {
+    /** Directory to anchor canonical-schema + flip-state lookups. Defaults to dirname(filePath). */
+    startDir?: string;
+    /** Pre-loaded flip-state ledger (so a directory run loads it once). */
+    flipState?: FlipState;
+    /** Whether a ledger was attempted but unreadable (drives flip_state_unreadable). */
+    flipStateError?: string;
+}
+/**
+ * Validate a single Runbook step-doc's frontmatter against the frozen schema +
+ * the per-template flip-state invariant. Pure: returns findings, never throws.
+ */
+export declare function validateRunbookDoc(raw: string, filePath: string, opts?: ValidateOptions): Finding[];
+export interface RunbookValidateResult {
+    source: string;
+    findings: Finding[];
+}
+/**
+ * Validate a single file or a directory of `.md` Runbook docs. Loads the
+ * flip-state ledger once and cross-checks `runbook` id uniqueness across the
+ * validated set (F39 §9.2 #4).
+ */
+export declare function validatePath(target: string): RunbookValidateResult[];

package/dist/runbook/checks.js

@@ -0,0 +1,404 @@
+import { readFileSync, existsSync, statSync, readdirSync } from 'fs';
+import { dirname, join, basename, resolve as resolvePath } from 'path';
+import yaml from 'js-yaml';
+import * as AjvNs from 'ajv';
+import { runbookSchema, RUNBOOK_SCHEMA_VERSIONS } from './schema.js';
+// ajv 8.x ships as CJS; in ESM contexts the constructor lands on the namespace's
+// `.default` property. Resolve at runtime so `new Ajv(...)` works under Node ESM.
+const Ajv = AjvNs.default ?? AjvNs;
+export function parseFrontmatter(raw, source) {
+    const findings = [];
+    const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!match) {
+        findings.push({
+            severity: 'error',
+            rule: 'runbook.no_frontmatter',
+            message: 'No YAML frontmatter block found (expected a leading `---` … `---` fence).',
+            path: source,
+        });
+        return { ok: false, findings };
+    }
+    let parsed;
+    try {
+        parsed = yaml.load(match[1], { filename: source });
+    }
+    catch (err) {
+        const finding = {
+            severity: 'error',
+            rule: 'runbook.frontmatter_parse_error',
+            message: err?.reason || err?.message || String(err),
+            path: source,
+        };
+        if (err?.mark && typeof err.mark === 'object') {
+            finding.line = (err.mark.line ?? 0) + 1;
+            finding.column = (err.mark.column ?? 0) + 1;
+        }
+        findings.push(finding);
+        return { ok: false, findings };
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        findings.push({
+            severity: 'error',
+            rule: 'runbook.shape',
+            message: 'Runbook frontmatter must be a YAML mapping (object).',
+            path: source,
+        });
+        return { ok: false, findings };
+    }
+    return { ok: true, frontmatter: parsed, findings };
+}
+// ──────────────────────────────────────────────────────────────────────
+// Canonical schema resolution (canonical wins; vendored is the fallback cache)
+// ──────────────────────────────────────────────────────────────────────
+/**
+ * Walk up from `startDir` looking for the canonical schema at
+ * `projects/fazemos/runbooks/runbook.schema.json`. Returns the parsed JSON +
+ * its path, or null if not found within the clone (then the vendored copy is
+ * used as the fallback cache — F39 §9.2 lockstep decision).
+ */
+export function findCanonicalSchema(startDir) {
+    let dir = resolvePath(startDir);
+    // Cap the walk to avoid an unbounded climb on odd filesystems.
+    for (let i = 0; i < 40; i++) {
+        const candidate = join(dir, 'projects', 'fazemos', 'runbooks', 'runbook.schema.json');
+        if (existsSync(candidate) && statSync(candidate).isFile()) {
+            try {
+                return { schema: JSON.parse(readFileSync(candidate, 'utf-8')), path: candidate };
+            }
+            catch {
+                return null; // malformed canonical file → fall back to vendored
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+/**
+ * Walk up from `startDir` for `projects/fazemos/runbooks/flip-state.json`.
+ * Returns { ledger } or { error } so the caller can emit
+ * `runbook.flip_state_unreadable` when the ledger can't be parsed (F39 §9.3).
+ */
+export function loadFlipState(startDir) {
+    let dir = resolvePath(startDir);
+    for (let i = 0; i < 40; i++) {
+        const candidate = join(dir, 'projects', 'fazemos', 'runbooks', 'flip-state.json');
+        if (existsSync(candidate) && statSync(candidate).isFile()) {
+            try {
+                const parsed = JSON.parse(readFileSync(candidate, 'utf-8'));
+                if (!parsed || typeof parsed !== 'object' || !Array.isArray(parsed.templates)) {
+                    return { path: candidate, error: 'flip-state.json is missing a `templates` array.' };
+                }
+                return { ledger: parsed, path: candidate };
+            }
+            catch (err) {
+                return { path: candidate, error: err?.message ?? String(err) };
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return {}; // not found — no ledger context available
+}
+/** Find the flip-state entry whose `steps[].step_name` matches a step (by file basename). */
+export function flipStateForStep(ledger, stepName) {
+    if (!ledger)
+        return null;
+    for (const tmpl of ledger.templates) {
+        for (const step of tmpl.steps ?? []) {
+            if (step.step_name === stepName)
+                return { template: tmpl, step };
+        }
+    }
+    return null;
+}
+// ──────────────────────────────────────────────────────────────────────
+// The binding/DAG fields that must NEVER leak into a Runbook doc (F39 §5.5, AC#9)
+// ──────────────────────────────────────────────────────────────────────
+const BINDING_LEAK_FIELDS = [
+    'depends_on',
+    'upstream_step_ids',
+    'source_step_id',
+    'source_output_name',
+    'parallel_group',
+    'sort_order',
+    'step_type',
+    'template',
+    'cadence',
+    'triggered_by',
+    'absorbed_by',
+];
+// `reviewer`/`eval_max_turns` are legal ONLY inside `defaults`; a top-level
+// occurrence is a binding-override leak.
+const BINDING_LEAK_TOPLEVEL_ONLY = ['reviewer', 'eval_max_turns'];
+const KEBAB_RE = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+/**
+ * Validate a single Runbook step-doc's frontmatter against the frozen schema +
+ * the per-template flip-state invariant. Pure: returns findings, never throws.
+ */
+export function validateRunbookDoc(raw, filePath, opts = {}) {
+    const findings = [];
+    const startDir = opts.startDir ?? dirname(resolvePath(filePath));
+    const stepName = basename(filePath, '.md');
+    // 1. Parse frontmatter ---------------------------------------------------
+    const parsed = parseFrontmatter(raw, filePath);
+    findings.push(...parsed.findings);
+    if (!parsed.ok || !parsed.frontmatter)
+        return findings;
+    const fm = parsed.frontmatter;
+    // 2. Schema validation (canonical wins; vendored fallback) ---------------
+    const canonical = findCanonicalSchema(startDir);
+    const schema = canonical?.schema ?? runbookSchema;
+    const ajv = new Ajv({ allErrors: true, strict: false });
+    const validate = ajv.compile(schema);
+    if (!validate(fm)) {
+        for (const err of validate.errors ?? []) {
+            findings.push(schemaErrorToFinding(err));
+        }
+    }
+    // 3. runbook_schema_version present + known ------------------------------
+    if (fm.runbook_schema_version === undefined) {
+        findings.push({
+            severity: 'error',
+            rule: 'runbook.version_missing',
+            message: 'runbook_schema_version is required. The Runbook contract is load-bearing for F40 — a missing version is a hard error. ' +
+                `Add \`runbook_schema_version: "${RUNBOOK_SCHEMA_VERSIONS[RUNBOOK_SCHEMA_VERSIONS.length - 1]}"\` at the top.`,
+            path: '(root)',
+        });
+    }
+    else if (typeof fm.runbook_schema_version === 'string' &&
+        !RUNBOOK_SCHEMA_VERSIONS.includes(fm.runbook_schema_version)) {
+        findings.push({
+            severity: 'warning',
+            rule: 'runbook.version_unknown',
+            message: `runbook_schema_version "${fm.runbook_schema_version}" is not in known set [${RUNBOOK_SCHEMA_VERSIONS.join(', ')}]. Validation continued.`,
+            path: 'runbook_schema_version',
+        });
+    }
+    // 4. description re-applies the F18 validateDescription contract ----------
+    checkDescription(fm, findings);
+    // 5. runbook id shape ----------------------------------------------------
+    if (typeof fm.runbook === 'string' && !KEBAB_RE.test(fm.runbook)) {
+        findings.push({
+            severity: 'error',
+            rule: 'runbook.id_shape',
+            message: `runbook id "${fm.runbook}" must be kebab-case (lowercase alphanumerics separated by single hyphens).`,
+            path: 'runbook',
+        });
+    }
+    // 6. No binding/DAG leak -------------------------------------------------
+    checkBindingLeak(fm, findings);
+    // 7. Flip-state invariant ------------------------------------------------
+    checkFlipStateInvariant(fm, stepName, opts, findings);
+    return findings;
+}
+function schemaErrorToFinding(err) {
+    const instancePath = err.instancePath || '(root)';
+    let msg = err.message ?? 'schema violation';
+    let rule = `schema.${err.keyword}`;
+    if (err.keyword === 'required') {
+        const missing = err.params?.missingProperty;
+        msg = missing ? `missing required property: ${missing}` : msg;
+        rule = 'schema.required';
+    }
+    else if (err.keyword === 'additionalProperties') {
+        msg = `unexpected property: ${err.params?.additionalProperty}`;
+    }
+    else if (err.keyword === 'enum') {
+        // Map to the more specific runbook.shape/schema.enum slug
+        msg = `${msg}: ${JSON.stringify(err.params?.allowedValues)}`;
+        rule = 'schema.enum';
+    }
+    else if (err.keyword === 'pattern') {
+        rule = 'schema.pattern';
+    }
+    else if (err.keyword === 'type') {
+        rule = 'schema.type';
+    }
+    return { severity: 'error', rule, message: msg, path: instancePath };
+}
+// Mirrors the F18 validateDescription codes: MISSING / EMPTY / MULTILINE.
+function checkDescription(fm, findings) {
+    const value = fm.description;
+    if (value === undefined || value === null) {
+        findings.push({
+            severity: 'error',
+            rule: 'runbook.description_invalid',
+            message: 'description is MISSING. Step doc frontmatter requires a non-empty `description`.',
+            path: 'description',
+        });
+        return;
+    }
+    if (typeof value !== 'string') {
+        findings.push({
+            severity: 'error',
+            rule: 'runbook.description_invalid',
+            message: 'description is MISSING: must be a string (single paragraph of prose).',
+            path: 'description',
+        });
+        return;
+    }
+    if (value.trim() === '') {
+        findings.push({
+            severity: 'error',
+            rule: 'runbook.description_invalid',
+            message: 'description is EMPTY: cannot be empty or whitespace-only.',
+            path: 'description',
+        });
+        return;
+    }
+    if (/\r|\n/.test(value)) {
+        findings.push({
+            severity: 'error',
+            rule: 'runbook.description_invalid',
+            message: 'description is MULTILINE: must be a single line with no line breaks.',
+            path: 'description',
+        });
+    }
+}
+function checkBindingLeak(fm, findings) {
+    for (const field of BINDING_LEAK_FIELDS) {
+        if (field in fm) {
+            findings.push({
+                severity: 'error',
+                rule: 'runbook.binding_leak',
+                message: `Binding/DAG field "${field}" must not appear in a Runbook doc — composition/wiring lives in the binding, not the Runbook (F39 §5.5).`,
+                path: field,
+            });
+        }
+    }
+    for (const field of BINDING_LEAK_TOPLEVEL_ONLY) {
+        if (field in fm) {
+            findings.push({
+                severity: 'error',
+                rule: 'runbook.binding_leak',
+                message: `"${field}" is a binding override and is legal only inside \`defaults\` — a top-level \`${field}\` is a binding leak (F39 §5.5).`,
+                path: field,
+            });
+        }
+    }
+}
+/**
+ * The dual-shape / flip-state invariant (F39 §9.3 — the load-bearing piece).
+ *
+ * - Flipped template (flipped:true): the doc is authoritative. Valid Runbook
+ *   frontmatter is REQUIRED; empty inline `sections` are correct, so the
+ *   validator must NEVER false-alarm an EMPTY_STEP_BODY-class defect here.
+ * - Un-flipped template (flipped:false or absent): inline `sections` are
+ *   authoritative. Runbook frontmatter is ACCEPTED if present (transitional)
+ *   but the file is not required to be the source — no "doc must be
+ *   authoritative" alarm.
+ */
+function checkFlipStateInvariant(fm, stepName, opts, findings) {
+    // If a ledger was attempted but unreadable, that is a hard error — the
+    // validator can't know which invariant to apply.
+    if (opts.flipStateError) {
+        findings.push({
+            severity: 'error',
+            rule: 'runbook.flip_state_unreadable',
+            message: `flip-state ledger is unreadable (${opts.flipStateError}). Cannot determine the per-template flip invariant.`,
+            path: '(flip-state)',
+        });
+        return;
+    }
+    const entry = flipStateForStep(opts.flipState, stepName);
+    if (!entry) {
+        // Step not in any ledger entry → treat as un-flipped (inline authoritative).
+        // No alarm: Runbook frontmatter on an un-ledgered step is transitional and fine.
+        return;
+    }
+    const { template, step } = entry;
+    // Cross-check: a doc's runbook id should match the ledger's recorded id for
+    // this step. A mismatch implies the doc and the ledger disagree about state.
+    if (typeof fm.runbook === 'string' &&
+        step.runbook &&
+        fm.runbook !== step.runbook) {
+        findings.push({
+            severity: 'error',
+            rule: 'runbook.flip_state_mismatch',
+            message: `Doc declares runbook "${fm.runbook}" but flip-state ledger records "${step.runbook}" for step "${stepName}" in template "${template.template}".`,
+            path: 'runbook',
+        });
+    }
+    // Flipped template: the doc MUST carry valid Runbook frontmatter (the schema
+    // checks above already enforce shape). We assert the required keys are present
+    // so a flipped step can never resolve to STEP_UNRESOLVED/EMPTY_STEP_BODY for a
+    // missing contract. We deliberately do NOT inspect inline `sections` — empty
+    // sections are correct on a flipped template, never a false EMPTY_STEP_BODY alarm.
+    if (template.flipped) {
+        if (typeof fm.runbook !== 'string' || !fm.contract) {
+            findings.push({
+                severity: 'error',
+                rule: 'runbook.flip_state_mismatch',
+                message: `Template "${template.template}" is flipped (doc-authoritative) but step "${stepName}" lacks required Runbook frontmatter (runbook + contract). A flipped step's doc is the sole source of its body.`,
+                path: '(root)',
+            });
+        }
+    }
+    // Un-flipped: nothing required; frontmatter present is fine (transitional).
+}
+/**
+ * Validate a single file or a directory of `.md` Runbook docs. Loads the
+ * flip-state ledger once and cross-checks `runbook` id uniqueness across the
+ * validated set (F39 §9.2 #4).
+ */
+export function validatePath(target) {
+    const abs = resolvePath(target);
+    if (!existsSync(abs)) {
+        return [{ source: target, findings: [{ severity: 'error', rule: 'read.not_found', message: `Path not found: ${target}`, path: target }] }];
+    }
+    const isDir = statSync(abs).isDirectory();
+    const files = isDir
+        ? readdirSync(abs).filter((f) => f.endsWith('.md')).map((f) => join(abs, f)).sort()
+        : [abs];
+    if (isDir && files.length === 0) {
+        return [{ source: target, findings: [{ severity: 'warning', rule: 'runbook.empty_dir', message: `No .md files found in directory: ${target}`, path: target }] }];
+    }
+    const startDir = isDir ? abs : dirname(abs);
+    const flip = loadFlipState(startDir);
+    const results = [];
+    const idLocations = new Map();
+    for (const file of files) {
+        let raw;
+        try {
+            raw = readFileSync(file, 'utf-8');
+        }
+        catch (err) {
+            results.push({ source: file, findings: [{ severity: 'error', rule: 'read.io_error', message: `Failed to read: ${err?.message ?? String(err)}`, path: file }] });
+            continue;
+        }
+        const findings = validateRunbookDoc(raw, file, {
+            startDir,
+            flipState: flip.ledger,
+            flipStateError: flip.error,
+        });
+        results.push({ source: file, findings });
+        // Collect runbook ids for the cross-file uniqueness check.
+        const fm = parseFrontmatter(raw, file).frontmatter;
+        if (fm && typeof fm.runbook === 'string') {
+            const list = idLocations.get(fm.runbook) ?? [];
+            list.push(file);
+            idLocations.set(fm.runbook, list);
+        }
+    }
+    // Duplicate runbook ids across the validated set → error on each offender.
+    for (const [id, locs] of idLocations) {
+        if (locs.length > 1) {
+            for (const loc of locs) {
+                const r = results.find((res) => res.source === loc);
+                r?.findings.push({
+                    severity: 'error',
+                    rule: 'runbook.id_duplicate',
+                    message: `runbook id "${id}" is not unique within the validated set: ${locs.map((l) => basename(l)).join(', ')}.`,
+                    path: 'runbook',
+                });
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=checks.js.map

package/dist/runbook/checks.js.map

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

package/dist/runbook/schema.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Vendored copy of the FROZEN Runbook frontmatter / I/O-contract schema (F39).
+ *
+ * SOURCE OF TRUTH: the canonical artifact lives in the workspace at
+ *   projects/fazemos/runbooks/runbook.schema.json
+ * (F39 tech spec §5.6, OQ-6). This vendored copy is a **cache** used only as
+ * the absent-canonical fallback: `loadRunbookSchema()` (checks.ts) loads the
+ * canonical file when run inside a workspace clone — the normal case, since the
+ * tool is validating files in that clone — and falls back to this copy only
+ * when the canonical file cannot be found.
+ *
+ * LOCKSTEP (F39 §9.2, AC#10): the vendored copy must be byte-identical to, or a
+ * strict superset of, the canonical schema. A unit test diffs the two and FAILS
+ * at ERROR severity on any drift (it may never define an enum value the
+ * canonical schema lacks, nor omit one it has). Because the canonical file is
+ * the source of truth and this is a cache, silent divergence would let the CLI
+ * accept/reject Runbooks differently from the contract F40 reads — so it is a
+ * hard CI failure, not a soft warning.
+ *
+ * Enum evolution is append-only within a major version (§5.2): new values may be
+ * ADDED via a minor bump (e.g. "1.0" -> "1.1"); any value REMOVAL is a breaking
+ * change requiring a major bump (e.g. "1.x" -> "2.0"). Bumped together with the
+ * CLI version; mirrors the established KNOWN_MANIFEST_VERSIONS pattern.
+ */
+export declare const RUNBOOK_SCHEMA_VERSIONS: readonly ["1.0"];
+export declare const RUNBOOK_TYPE_ENUM: readonly ["text", "number", "boolean", "url", "filepath", "json"];
+export declare const RUNBOOK_FORMAT_ENUM: readonly ["text", "filepath", "url", "commit_sha", "integer", "markdown", "json"];
+export declare const RUNBOOK_SOURCE_HINT_ENUM: readonly ["upstream", "pipeline_param", "dispatch_param", "workspace_path"];
+/**
+ * The vendored JSON-Schema (draft-07). Kept structurally identical to the
+ * canonical runbook.schema.json. The schema-drift unit test (§9.2, AC#10)
+ * compares the canonical file against this object and fails on any divergence.
+ */
+export declare const runbookSchema: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly $id: "https://fazemos/schemas/runbook.json";
+    readonly title: "Runbook frontmatter / I/O-contract schema";
+    readonly description: "Frozen schema for the Runbook primitive's step-doc frontmatter (F39). The single source of truth that F39's CLI validator (`fazemos runbook validate`) AND F40's dispatch param-validation both read. Frozen at runbook_schema_version 1.0. Enum evolution is append-only within a major version (a minor bump, e.g. 1.0 -> 1.1); any enum value removal requires a major bump (e.g. 1.x -> 2.0). See specs/tech/platform/F39-runbook-substrate-authority-flip-tech-spec.md sections 5.1-5.3 + 5.6.";
+    readonly type: "object";
+    readonly required: readonly ["runbook_schema_version", "runbook", "title", "description", "role", "contract"];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly runbook_schema_version: {
+            readonly type: "string";
+            readonly description: "The contract version. Required (F39 section 5.3): the Runbook contract is load-bearing for F40, so a missing version is a hard error. Frozen set for F39 is [\"1.0\"].";
+        };
+        readonly runbook: {
+            readonly type: "string";
+            readonly pattern: "^[a-z0-9]+(-[a-z0-9]+)*$";
+            readonly description: "Stable kebab-case id; the callable \"function name\" that F40's runbook_ref resolves. Library-unique. Replaces the legacy step:/playbook: keys. Independent of the resolver-mandated physical filename (which must equal the step name).";
+        };
+        readonly title: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Human label.";
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Single-line, non-empty description. The F18 validateDescription contract enforces non-empty + no newline at render; the CLI re-applies it as runbook.description_invalid before a render.";
+        };
+        readonly role: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Capability HINT (role-slug, post-F25). Overridable at dispatch. NEVER a hard filler pin (F39 section 6.4). A Runbook is what to do, never who.";
+        };
+        readonly contract: {
+            readonly type: "object";
+            readonly required: readonly ["inputs", "outputs"];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly inputs: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly required: readonly ["name", "type", "required", "source_hint"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly name: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: "The name the PROCEDURE BODY uses. The binding maps the actual wire (section 5.5); the renamed wire name never leaks into the Runbook.";
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly enum: readonly ["text", "number", "boolean", "url", "filepath", "json"];
+                                readonly description: "FROZEN closed enum (F39 section 5.2). Closed at 6.";
+                            };
+                            readonly required: {
+                                readonly type: "boolean";
+                            };
+                            readonly source_hint: {
+                                readonly type: "string";
+                                readonly enum: readonly ["upstream", "pipeline_param", "dispatch_param", "workspace_path"];
+                                readonly description: "FROZEN closed enum (F39 section 5.2). The shape of how this input is typically satisfied, NEVER the wire. Closed at 4.";
+                            };
+                            readonly description: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                };
+                readonly outputs: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly required: readonly ["name", "type", "required", "success_criteria"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly name: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly enum: readonly ["text", "number", "boolean", "url", "filepath", "json"];
+                                readonly description: "FROZEN closed enum (F39 section 5.2). Closed at 6.";
+                            };
+                            readonly required: {
+                                readonly type: "boolean";
+                            };
+                            readonly format: {
+                                readonly type: "string";
+                                readonly enum: readonly ["text", "filepath", "url", "commit_sha", "integer", "markdown", "json"];
+                                readonly description: "FROZEN closed enum (F39 section 5.2). Optional; refines type. Absent => unconstrained beyond type. Closed at 7.";
+                            };
+                            readonly success_criteria: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly description: "What turns the contract into a real function signature (Ollie section 1: the single highest-value piece). What a pipeline evaluator, chat dispatcher, and inbox auto-wake all agree on for \"did this Runbook return what it promised.\"";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly defaults: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly description: "SUGGESTED defaults only; the binding override wins when present (section 5.5). Honors BUG36 (eval budget keys off step shape).";
+            readonly properties: {
+                readonly reviewer: {
+                    readonly type: readonly ["string", "null"];
+                    readonly description: "role-slug or null.";
+                };
+                readonly eval_max_turns: {
+                    readonly type: readonly ["integer", "null"];
+                    readonly description: "null => engine default.";
+                };
+            };
+        };
+    };
+};