patchwork-os 1.2.0-beta.2.canary.764 → 1.2.0-beta.2.canary.765

package/dist/maintenance/prOutcomeLedger.d.ts

@@ -36,7 +36,6 @@
  * Rows carry `rv: 1` so a later schema change is distinguishable from an old
  * row, for the same reason the gate ledger does.
  */
-/** Schema version. A reader must be able to tell an old row from a new one. */
 export declare const PR_OBSERVATION_RV = 1;
 export type PrState = "OPEN" | "MERGED" | "CLOSED";
 /** One pull request as the API described it at one moment. */
@@ -161,3 +160,15 @@ export declare function resolveRepoSlug(run: () => {
     ok: false;
     stderr: string;
 }): RepoResolution;
+/**
+ * Read the observation ledger. Missing file ⇒ empty, which is a true state on
+ * day one and not an error.
+ *
+ * Extracted from the `pr-outcomes show` handler so `patchwork sweep` reads the
+ * ledger through the same parser the verb uses — a second reader would drift,
+ * and a drifting row count is indistinguishable from a quiet week.
+ *
+ * A corrupt line is skipped, never repaired: rewriting an append-only evidence
+ * file to make it parse is how evidence quietly becomes fiction.
+ */
+export declare function readObservations(file: string): PrObservation[];

package/dist/maintenance/prOutcomeLedger.js

@@ -37,6 +37,7 @@
  * row, for the same reason the gate ledger does.
  */
 /** Schema version. A reader must be able to tell an old row from a new one. */
+import * as nodeFs from "node:fs";
 export const PR_OBSERVATION_RV = 1;
 function num(v) {
     return typeof v === "number" && Number.isFinite(v) ? v : null;
@@ -218,4 +219,31 @@ export function resolveRepoSlug(run) {
     }
     return { repo: slug };
 }
+/**
+ * Read the observation ledger. Missing file ⇒ empty, which is a true state on
+ * day one and not an error.
+ *
+ * Extracted from the `pr-outcomes show` handler so `patchwork sweep` reads the
+ * ledger through the same parser the verb uses — a second reader would drift,
+ * and a drifting row count is indistinguishable from a quiet week.
+ *
+ * A corrupt line is skipped, never repaired: rewriting an append-only evidence
+ * file to make it parse is how evidence quietly becomes fiction.
+ */
+export function readObservations(file) {
+    if (!nodeFs.existsSync(file))
+        return [];
+    const out = [];
+    for (const line of nodeFs.readFileSync(file, "utf-8").split("\n")) {
+        if (line.trim() === "")
+            continue;
+        try {
+            out.push(JSON.parse(line));
+        }
+        catch {
+            // skipped, never repaired
+        }
+    }
+    return out;
+}
 //# sourceMappingURL=prOutcomeLedger.js.map

package/dist/maintenance/prOutcomeLedger.js.map

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

package/dist/maintenance/sweep.d.ts

@@ -0,0 +1,98 @@
+/**
+ * `patchwork sweep` — what CHANGED since the last sweep?
+ *
+ * Five read-only verbs already answer "what is true now": `doctor`,
+ * `workers validate`, `evidence`, `privacy undeclared`, `pr-outcomes show`.
+ * Running them by hand answers each question in isolation and answers none of
+ * the question an operator actually has on a Monday, which is *what moved*.
+ * A denominator that has not shifted in three weeks and a gate that flipped
+ * yesterday look identical when every verb is read fresh.
+ *
+ * ## It is a REPORT with two gates, not five
+ *
+ * Only two readings here are gates: is the running code the installed code, and
+ * does every worker manifest actually govern something. Those are binary, they
+ * are currently green, and a flip is unambiguously a regression — so a flip
+ * exits 1.
+ *
+ * Everything else is DRIFT and never fails the command. The evidence-spine
+ * ratios fall by construction as ledgers accrue rows faster than runs earn
+ * correlation ids; an undeclared agent step is the documented fail-soft default
+ * of ADR-0021, not a fault. Wiring those to an exit code would make `sweep`
+ * permanently red, and a permanently-red gate is exactly how a real warning
+ * gets ignored — the failure this repo has now recorded several times.
+ *
+ * ## A first run is a BASELINE, never "no changes"
+ *
+ * With no prior snapshot there is nothing to diff, and saying "nothing changed"
+ * would be a claim about a week nobody observed. That state is named
+ * `baseline`, printed as such, and carried in the JSON, for the same reason
+ * `evidence` reports an absent ledger as ABSENT rather than as zero rows.
+ *
+ * ## The snapshot holds COUNTS ONLY
+ *
+ * This is a constraint, not a formality. Two of the five inputs return operator
+ * data — `privacy undeclared` names real installed recipes, `doctor` carries
+ * workspace paths — and a snapshot that accumulated them would be a brand-new
+ * operator-data ledger created by a diagnostic, growing weekly, unnoticed
+ * because nobody thinks of a health check as a place secrets collect. So the
+ * reading is reduced to integers and booleans at the boundary, and a test
+ * asserts the serialised snapshot contains no path- or name-shaped string.
+ *
+ * `rv` marks the snapshot schema. A later reading with a new counter must stay
+ * distinguishable from an old reading that never had one — absence is a fact
+ * here as it is in the gate decision log, and is never backfilled.
+ */
+/** Snapshot schema version. Bump when a counter's MEANING changes. */
+export declare const SWEEP_RV = 1;
+/** File the snapshots are appended to, relative to `$PATCHWORK_HOME`. */
+export declare const SWEEP_LEDGER = "sweep_snapshots.jsonl";
+/**
+ * One sweep reading, reduced to scalars.
+ *
+ * `gates` are the only fields that can produce a regression verdict. `counts` is
+ * a flat integer bag deliberately: adding a metric must not be a schema change
+ * that strands every prior snapshot, and a reader that finds a key missing
+ * learns "this sweep predates that counter" rather than "it was zero".
+ */
+export interface SweepReading {
+    rv: number;
+    takenAt: number;
+    gates: Record<string, boolean>;
+    counts: Record<string, number>;
+}
+export interface GateDelta {
+    key: string;
+    before: boolean;
+    after: boolean;
+    /** true only for a true -> false flip. A false -> true flip is a recovery. */
+    regression: boolean;
+}
+export interface CountDelta {
+    key: string;
+    /** undefined when the prior snapshot predates this counter. */
+    before?: number;
+    after: number;
+    change: number;
+}
+export interface SweepDelta {
+    /** No prior snapshot existed. Never rendered as "nothing changed". */
+    baseline: boolean;
+    previousAt?: number;
+    gates: GateDelta[];
+    counts: CountDelta[];
+    /** Counters present in the prior reading and absent from this one. */
+    disappeared: string[];
+    /** True when any gate flipped true -> false. Drives the exit code. */
+    regressed: boolean;
+}
+/**
+ * Diff two readings. Pure — no clock, no filesystem, so a test can drive it.
+ */
+export declare function diffReadings(previous: SweepReading | undefined, current: SweepReading): SweepDelta;
+/** Last snapshot in the ledger, or undefined when there is none. */
+export declare function readLastSnapshot(dir: string): SweepReading | undefined;
+export declare function appendSnapshot(dir: string, reading: SweepReading): void;
+export declare function formatSweep(reading: SweepReading, delta: SweepDelta, opts: {
+    wrote: boolean;
+}): string;

package/dist/maintenance/sweep.js

@@ -0,0 +1,197 @@
+/**
+ * `patchwork sweep` — what CHANGED since the last sweep?
+ *
+ * Five read-only verbs already answer "what is true now": `doctor`,
+ * `workers validate`, `evidence`, `privacy undeclared`, `pr-outcomes show`.
+ * Running them by hand answers each question in isolation and answers none of
+ * the question an operator actually has on a Monday, which is *what moved*.
+ * A denominator that has not shifted in three weeks and a gate that flipped
+ * yesterday look identical when every verb is read fresh.
+ *
+ * ## It is a REPORT with two gates, not five
+ *
+ * Only two readings here are gates: is the running code the installed code, and
+ * does every worker manifest actually govern something. Those are binary, they
+ * are currently green, and a flip is unambiguously a regression — so a flip
+ * exits 1.
+ *
+ * Everything else is DRIFT and never fails the command. The evidence-spine
+ * ratios fall by construction as ledgers accrue rows faster than runs earn
+ * correlation ids; an undeclared agent step is the documented fail-soft default
+ * of ADR-0021, not a fault. Wiring those to an exit code would make `sweep`
+ * permanently red, and a permanently-red gate is exactly how a real warning
+ * gets ignored — the failure this repo has now recorded several times.
+ *
+ * ## A first run is a BASELINE, never "no changes"
+ *
+ * With no prior snapshot there is nothing to diff, and saying "nothing changed"
+ * would be a claim about a week nobody observed. That state is named
+ * `baseline`, printed as such, and carried in the JSON, for the same reason
+ * `evidence` reports an absent ledger as ABSENT rather than as zero rows.
+ *
+ * ## The snapshot holds COUNTS ONLY
+ *
+ * This is a constraint, not a formality. Two of the five inputs return operator
+ * data — `privacy undeclared` names real installed recipes, `doctor` carries
+ * workspace paths — and a snapshot that accumulated them would be a brand-new
+ * operator-data ledger created by a diagnostic, growing weekly, unnoticed
+ * because nobody thinks of a health check as a place secrets collect. So the
+ * reading is reduced to integers and booleans at the boundary, and a test
+ * asserts the serialised snapshot contains no path- or name-shaped string.
+ *
+ * `rv` marks the snapshot schema. A later reading with a new counter must stay
+ * distinguishable from an old reading that never had one — absence is a fact
+ * here as it is in the gate decision log, and is never backfilled.
+ */
+import { appendFileSync, existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+/** Snapshot schema version. Bump when a counter's MEANING changes. */
+export const SWEEP_RV = 1;
+/** File the snapshots are appended to, relative to `$PATCHWORK_HOME`. */
+export const SWEEP_LEDGER = "sweep_snapshots.jsonl";
+/**
+ * Diff two readings. Pure — no clock, no filesystem, so a test can drive it.
+ */
+export function diffReadings(previous, current) {
+    if (!previous) {
+        return {
+            baseline: true,
+            gates: [],
+            counts: [],
+            disappeared: [],
+            regressed: false,
+        };
+    }
+    const gates = [];
+    for (const [key, after] of Object.entries(current.gates)) {
+        const before = previous.gates[key];
+        // A gate the previous reading did not carry is not a flip. Treating a
+        // missing key as `false` would report every newly-added gate as a
+        // regression on its first sweep.
+        if (typeof before !== "boolean" || before === after)
+            continue;
+        gates.push({ key, before, after, regression: before && !after });
+    }
+    const counts = [];
+    for (const [key, after] of Object.entries(current.counts)) {
+        const before = previous.counts[key];
+        if (typeof before !== "number") {
+            counts.push({ key, after, change: after });
+            continue;
+        }
+        if (before === after)
+            continue;
+        counts.push({ key, before, after, change: after - before });
+    }
+    const disappeared = Object.keys(previous.counts).filter((k) => !(k in current.counts));
+    return {
+        baseline: false,
+        previousAt: previous.takenAt,
+        gates,
+        counts,
+        disappeared,
+        regressed: gates.some((g) => g.regression),
+    };
+}
+/** Last snapshot in the ledger, or undefined when there is none. */
+export function readLastSnapshot(dir) {
+    const file = path.join(dir, SWEEP_LEDGER);
+    if (!existsSync(file))
+        return undefined;
+    let last;
+    for (const line of readFileSync(file, "utf-8").split("\n")) {
+        if (!line.trim())
+            continue;
+        try {
+            const row = JSON.parse(line);
+            // A row from a future schema is skipped rather than diffed against: its
+            // counters may share a name with a different meaning, and a delta built
+            // across that boundary would be a confident lie.
+            if (typeof row?.takenAt !== "number" || row.rv !== SWEEP_RV)
+                continue;
+            last = row;
+        }
+        catch {
+            // A corrupt line is skipped, never repaired. Rewriting an append-only
+            // evidence file to make it parse is how evidence stops being evidence.
+        }
+    }
+    return last;
+}
+export function appendSnapshot(dir, reading) {
+    appendFileSync(path.join(dir, SWEEP_LEDGER), `${JSON.stringify(reading)}\n`, {
+        mode: 0o600,
+    });
+}
+const CHECK = "✓";
+export function formatSweep(reading, delta, opts) {
+    const L = [];
+    L.push("[sweep] what moved since the last sweep?");
+    L.push("");
+    L.push("  gates");
+    for (const [key, ok] of Object.entries(reading.gates)) {
+        L.push(`    ${ok ? `${CHECK} ` : "FAIL"}  ${key}`);
+    }
+    L.push("");
+    if (delta.baseline) {
+        // Never "no changes". Nothing was observed to change; there was nothing to
+        // compare against, and those are different facts.
+        L.push("  BASELINE — no prior snapshot, so nothing is compared here.");
+        L.push("  Run it again later and this section becomes the deltas.");
+        L.push("");
+        L.push(`  ${Object.keys(reading.counts).length} counter(s) recorded:`);
+        for (const [key, v] of Object.entries(reading.counts)) {
+            L.push(`    ${String(v).padStart(7)}  ${key}`);
+        }
+        L.push("");
+        L.push(opts.wrote
+            ? `  Snapshot appended to ${SWEEP_LEDGER}.`
+            : "  Not written (--no-write): the next sweep will still see no baseline.");
+        L.push("");
+        return `${L.join("\n")}\n`;
+    }
+    const since = delta.previousAt
+        ? new Date(delta.previousAt).toISOString()
+        : "unknown";
+    L.push(`  since ${since}`);
+    L.push("");
+    if (delta.gates.length === 0) {
+        L.push("  No gate changed state.");
+    }
+    else {
+        for (const g of delta.gates) {
+            L.push(`  ${g.regression ? "REGRESSED" : "recovered "}  ${g.key}: ${g.before} -> ${g.after}`);
+        }
+    }
+    L.push("");
+    if (delta.counts.length === 0) {
+        L.push("  No counter moved.");
+    }
+    else {
+        L.push("  drift (reported, never fatal)");
+        for (const c of delta.counts) {
+            const before = c.before === undefined ? "new" : String(c.before);
+            const sign = c.change > 0 ? "+" : "";
+            L.push(`    ${before.padStart(7)} -> ${String(c.after).padEnd(7)} ${sign}${c.change}  ${c.key}`);
+        }
+    }
+    if (delta.disappeared.length > 0) {
+        L.push("");
+        L.push(`  ${delta.disappeared.length} counter(s) the previous sweep had are absent now:`);
+        for (const k of delta.disappeared)
+            L.push(`    ${k}`);
+        L.push("  A counter that stops being reported is not a counter that hit 0.");
+    }
+    L.push("");
+    if (delta.regressed) {
+        L.push("  A gate flipped from healthy to unhealthy. Exiting 1.");
+    }
+    else {
+        L.push("  No gate regressed. Drift above is information, not a failure.");
+    }
+    if (opts.wrote)
+        L.push(`  Snapshot appended to ${SWEEP_LEDGER}.`);
+    L.push("");
+    return `${L.join("\n")}\n`;
+}
+//# sourceMappingURL=sweep.js.map

package/dist/maintenance/sweep.js.map

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

package/dist/maintenance/sweepCollect.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Collect one `SweepReading` from the five read-only verbs.
+ *
+ * Kept apart from `sweep.ts` so the diff stays a pure function a test can drive.
+ * This half touches the filesystem and every subsystem; that half decides what a
+ * regression is.
+ *
+ * ## The reduction to scalars happens HERE, on purpose
+ *
+ * Two of these five inputs return operator data: `scanRecipeDir` names real
+ * installed recipes, and a bridge lock carries a workspace path. Reducing at the
+ * boundary — rather than storing the reports and projecting later — means there
+ * is no version of the snapshot that ever held them. A privacy rule enforced by
+ * a downstream formatter is one refactor away from being lost.
+ */
+import { type SweepReading } from "./sweep.js";
+export interface CollectOptions {
+    /** Ledger directory. Defaults to `$PATCHWORK_HOME`. */
+    dir?: string;
+    /** How many live bridges ought to be up. Absent ⇒ no expectation. */
+    expectRunning?: number;
+    /** ms epoch for the reading. Injected so a test is not at the mercy of a clock. */
+    now?: number;
+}
+/**
+ * Readings that could not be taken are OMITTED, never recorded as zero.
+ *
+ * A recipes directory that cannot be read and a recipes directory holding zero
+ * agent steps are different facts, and the diff already distinguishes an absent
+ * counter ("this sweep predates it, or could not take it") from a moved one.
+ * Writing a 0 would turn an unavailable reading into a dramatic-looking drop.
+ */
+export declare function collectSweep(opts?: CollectOptions): SweepReading;

package/dist/maintenance/sweepCollect.js

@@ -0,0 +1,109 @@
+/**
+ * Collect one `SweepReading` from the five read-only verbs.
+ *
+ * Kept apart from `sweep.ts` so the diff stays a pure function a test can drive.
+ * This half touches the filesystem and every subsystem; that half decides what a
+ * regression is.
+ *
+ * ## The reduction to scalars happens HERE, on purpose
+ *
+ * Two of these five inputs return operator data: `scanRecipeDir` names real
+ * installed recipes, and a bridge lock carries a workspace path. Reducing at the
+ * boundary — rather than storing the reports and projecting later — means there
+ * is no version of the snapshot that ever held them. A privacy rule enforced by
+ * a downstream formatter is one refactor away from being lost.
+ */
+import path from "node:path";
+import { assessDeploymentFreshness, discoverLocks, installedBuildTimeMs, } from "../deploymentFreshness.js";
+import { evidenceCoverage } from "../evidenceCoverage.js";
+import { patchworkHome } from "../patchworkHome.js";
+import { scanRecipeDir } from "../privacy/undeclaredSteps.js";
+import { defaultRecipesDir, defaultWorkersDir, validateWorkers, } from "../workers/workersCli.js";
+import { readObservations, summarise } from "./prOutcomeLedger.js";
+import { SWEEP_RV } from "./sweep.js";
+/**
+ * Readings that could not be taken are OMITTED, never recorded as zero.
+ *
+ * A recipes directory that cannot be read and a recipes directory holding zero
+ * agent steps are different facts, and the diff already distinguishes an absent
+ * counter ("this sweep predates it, or could not take it") from a moved one.
+ * Writing a 0 would turn an unavailable reading into a dramatic-looking drop.
+ */
+export function collectSweep(opts = {}) {
+    const dir = opts.dir ?? patchworkHome();
+    const counts = {};
+    const gates = {};
+    // --- gate 1: is the running code the installed code? ---
+    const buildTimeMs = installedBuildTimeMs();
+    if (buildTimeMs !== undefined) {
+        const fresh = assessDeploymentFreshness({
+            locks: discoverLocks(),
+            buildTimeMs,
+            isAlive: (pid) => {
+                try {
+                    process.kill(pid, 0);
+                    return true;
+                }
+                catch {
+                    return false;
+                }
+            },
+            ...(opts.expectRunning !== undefined
+                ? { expectRunning: opts.expectRunning }
+                : {}),
+        });
+        gates["deployment"] = !fresh.unhealthy;
+        counts["bridges.running"] = fresh.running;
+        counts["bridges.findings"] = fresh.findings.length;
+    }
+    // --- gate 2: does every worker manifest actually govern something? ---
+    try {
+        const v = validateWorkers({
+            workersDir: defaultWorkersDir(),
+            recipesDir: defaultRecipesDir(),
+        });
+        gates["workers"] = v.healthy;
+        counts["workers.loaded"] = v.counts.loaded;
+        counts["workers.broken"] = v.counts.broken;
+        counts["workers.findings"] = v.findings.length;
+    }
+    catch {
+        // No workers directory is a legitimate install. Omit rather than zero.
+    }
+    // --- drift: evidence spine ---
+    const ev = evidenceCoverage(dir);
+    for (const l of ev.ledgers) {
+        // An absent ledger contributes NO counters. `evidence` reports absence as
+        // ABSENT rather than as `0 rows` for a reason — permission_exercises is
+        // absent because no standing permission has ever been granted, and that is
+        // correct, not a gap. A zero here would invite someone to go and fix it.
+        if (l.absent)
+            continue;
+        counts[`evidence.${l.file}.rows`] = l.rows;
+        counts[`evidence.${l.file}.joinable`] = l.joinable;
+    }
+    counts["evidence.runsInMoreThanOneLedger"] = ev.runsInMoreThanOneLedger;
+    // --- drift: undeclared agent steps (ADR-0021 fail-soft, never a gate) ---
+    try {
+        const u = scanRecipeDir(path.join(dir, "recipes"));
+        counts["privacy.agentSteps"] = u.agentSteps;
+        counts["privacy.declared"] = u.declared;
+        counts["privacy.undeclared"] = u.undeclared.length;
+        counts["privacy.unreadableRecipes"] = u.unreadable.length;
+    }
+    catch {
+        // Unreadable recipes directory: omit, do not zero.
+    }
+    // --- drift: pull-request outcome ledger ---
+    const pr = summarise(readObservations(path.join(dir, "pr_outcomes.jsonl")));
+    counts["prOutcomes.rows"] = pr.rows;
+    counts["prOutcomes.distinctPrs"] = pr.distinctPrs;
+    counts["prOutcomes.withHistory"] = pr.prsWithHistory;
+    return {
+        rv: SWEEP_RV,
+        takenAt: opts.now ?? Date.now(),
+        gates,
+        counts,
+    };
+}
+//# sourceMappingURL=sweepCollect.js.map

package/dist/maintenance/sweepCollect.js.map

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

package/dist/privacy/undeclaredSteps.d.ts

@@ -74,3 +74,17 @@ export declare function undeclaredInRecipe(recipeName: string, parsed: unknown):
     steps: UndeclaredStep[];
 };
 export declare function formatUndeclared(r: UndeclaredReport): string;
+/**
+ * Scan a directory of recipe YAML and aggregate `undeclaredInRecipe` across it.
+ *
+ * Extracted from the `privacy undeclared` handler so `patchwork sweep` reads the
+ * same number the verb prints. Two implementations of "how many agent steps
+ * declare a data_policy" would drift, and the drift is silent: the sweep would
+ * report a delta of zero while the verb reported a regression, or vice versa,
+ * and neither would look wrong.
+ *
+ * Throws only when the directory cannot be read. A recipe that will not parse is
+ * REPORTED in `unreadable`, never skipped silently — a file present and ignored
+ * is the failure mode this whole family of verbs exists to surface.
+ */
+export declare function scanRecipeDir(dir: string): UndeclaredReport;

package/dist/privacy/undeclaredSteps.js

@@ -34,6 +34,9 @@
  * Read-only. Output is OPERATOR DATA — it names real installed recipes — so it
  * is quoted as a measurement and never pasted into an issue or a fixture.
  */
+import { readdirSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
 function isRecord(v) {
     return typeof v === "object" && v !== null && !Array.isArray(v);
 }
@@ -163,4 +166,45 @@ export function formatUndeclared(r) {
     L.push("");
     return `${L.join("\n")}\n`;
 }
+/**
+ * Scan a directory of recipe YAML and aggregate `undeclaredInRecipe` across it.
+ *
+ * Extracted from the `privacy undeclared` handler so `patchwork sweep` reads the
+ * same number the verb prints. Two implementations of "how many agent steps
+ * declare a data_policy" would drift, and the drift is silent: the sweep would
+ * report a delta of zero while the verb reported a regression, or vice versa,
+ * and neither would look wrong.
+ *
+ * Throws only when the directory cannot be read. A recipe that will not parse is
+ * REPORTED in `unreadable`, never skipped silently — a file present and ignored
+ * is the failure mode this whole family of verbs exists to surface.
+ */
+export function scanRecipeDir(dir) {
+    const entries = readdirSync(dir).sort();
+    let recipesScanned = 0;
+    let agentSteps = 0;
+    let declared = 0;
+    const undeclared = [];
+    const unreadable = [];
+    for (const f of entries) {
+        if (!/\.ya?ml$/i.test(f))
+            continue;
+        recipesScanned++;
+        let parsed;
+        try {
+            parsed = parseYaml(readFileSync(path.join(dir, f), "utf-8"));
+        }
+        catch {
+            unreadable.push(f);
+            continue;
+        }
+        const declaredName = parsed?.name;
+        const name = typeof declaredName === "string" ? declaredName : f;
+        const r = undeclaredInRecipe(name, parsed);
+        agentSteps += r.agentSteps;
+        declared += r.declared;
+        undeclared.push(...r.steps);
+    }
+    return { recipesScanned, agentSteps, declared, undeclared, unreadable };
+}
 //# sourceMappingURL=undeclaredSteps.js.map