@vibe-agent-toolkit/cli 0.2.0-rc.10 → 0.2.0-rc.12

package/dist/commands/corpus/scan-schema.d.ts

@@ -0,0 +1,127 @@
+/**
+ * The document `vat corpus scan` publishes, apart from the command.
+ *
+ * A sibling module because the published-shape registry imports it and the
+ * command imports the writer that imports the registry (the cycle
+ * `report-schemas.ts` describes).
+ *
+ * `examined` counts the seed entries the scan ran over. The per-plugin audit
+ * documents and the run index are file artifacts beside it (`corpus-audit`,
+ * `corpus-summary`); this document is the run's own outcome, one row per entry.
+ */
+import { z } from 'zod';
+import type { ExaminedDeclaration } from '../../utils/run-integrity.js';
+/** What `examined` counts for `vat corpus scan`, and the remedy when it is zero. */
+export declare const CORPUS_SCAN_EXAMINED: ExaminedDeclaration;
+declare const CorpusScanDataSchema: z.ZodObject<{
+    outDir: z.ZodString;
+    entries: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        audit: z.ZodEnum<["ok", "findings", "unloadable"]>;
+        review: z.ZodEnum<["ok", "skipped", "error"]>;
+        outputPath: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        outputPath: string | null;
+        audit: "ok" | "findings" | "unloadable";
+        review: "error" | "ok" | "skipped";
+    }, {
+        name: string;
+        outputPath: string | null;
+        audit: "ok" | "findings" | "unloadable";
+        review: "error" | "ok" | "skipped";
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    entries: {
+        name: string;
+        outputPath: string | null;
+        audit: "ok" | "findings" | "unloadable";
+        review: "error" | "ok" | "skipped";
+    }[];
+    outDir: string;
+}, {
+    entries: {
+        name: string;
+        outputPath: string | null;
+        audit: "ok" | "findings" | "unloadable";
+        review: "error" | "ok" | "skipped";
+    }[];
+    outDir: string;
+}>;
+export type CorpusScanData = z.infer<typeof CorpusScanDataSchema>;
+/** The document this command publishes. */
+export declare const CORPUS_SCAN_REPORT_SCHEMA: import("@vibe-agent-toolkit/schema").ReportZodSchema<z.ZodObject<{
+    outDir: z.ZodString;
+    entries: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        audit: z.ZodEnum<["ok", "findings", "unloadable"]>;
+        review: z.ZodEnum<["ok", "skipped", "error"]>;
+        outputPath: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        outputPath: string | null;
+        audit: "ok" | "findings" | "unloadable";
+        review: "error" | "ok" | "skipped";
+    }, {
+        name: string;
+        outputPath: string | null;
+        audit: "ok" | "findings" | "unloadable";
+        review: "error" | "ok" | "skipped";
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    entries: {
+        name: string;
+        outputPath: string | null;
+        audit: "ok" | "findings" | "unloadable";
+        review: "error" | "ok" | "skipped";
+    }[];
+    outDir: string;
+}, {
+    entries: {
+        name: string;
+        outputPath: string | null;
+        audit: "ok" | "findings" | "unloadable";
+        review: "error" | "ok" | "skipped";
+    }[];
+    outDir: string;
+}>, z.ZodObject<Omit<{
+    code: z.ZodString;
+    severity: z.ZodEnum<["error", "warning", "info", "ignore"]>;
+    message: z.ZodString;
+    location: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    line: z.ZodOptional<z.ZodNumber>;
+    field: z.ZodOptional<z.ZodString>;
+    link: z.ZodOptional<z.ZodString>;
+    fix: z.ZodOptional<z.ZodString>;
+    reference: z.ZodOptional<z.ZodString>;
+    suggestion: z.ZodOptional<z.ZodString>;
+}, "severity"> & {
+    severity: z.ZodEnum<["error", "warning", "info"]>;
+    column: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    fix?: string | undefined;
+    reference?: string | undefined;
+    location?: string | undefined;
+    line?: number | undefined;
+    field?: string | undefined;
+    link?: string | undefined;
+    suggestion?: string | undefined;
+    column?: number | undefined;
+}, {
+    code: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    fix?: string | undefined;
+    reference?: string | undefined;
+    location?: string | undefined;
+    line?: number | undefined;
+    field?: string | undefined;
+    link?: string | undefined;
+    suggestion?: string | undefined;
+    column?: number | undefined;
+}>>;
+export {};
+//# sourceMappingURL=scan-schema.d.ts.map

package/dist/commands/corpus/scan-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-schema.d.ts","sourceRoot":"","sources":["../../../src/commands/corpus/scan-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,EAAE,mBAGlC,CAAC;AAEF,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASf,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,2CAA2C;AAC3C,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAoD,CAAC"}

package/dist/commands/corpus/scan-schema.js

@@ -0,0 +1,31 @@
+/**
+ * The document `vat corpus scan` publishes, apart from the command.
+ *
+ * A sibling module because the published-shape registry imports it and the
+ * command imports the writer that imports the registry (the cycle
+ * `report-schemas.ts` describes).
+ *
+ * `examined` counts the seed entries the scan ran over. The per-plugin audit
+ * documents and the run index are file artifacts beside it (`corpus-audit`,
+ * `corpus-summary`); this document is the run's own outcome, one row per entry.
+ */
+import { FindingSchema, reportSchema } from '@vibe-agent-toolkit/schema';
+import { z } from 'zod';
+/** What `examined` counts for `vat corpus scan`, and the remedy when it is zero. */
+export const CORPUS_SCAN_EXAMINED = {
+    unit: 'seed entries',
+    whenZero: 'The seed lists no plugins — add at least one entry under plugins: in the seed file.',
+};
+const CorpusScanDataSchema = z.object({
+    outDir: z.string(),
+    entries: z.array(z.object({
+        name: z.string(),
+        audit: z.enum(['ok', 'findings', 'unloadable']),
+        review: z.enum(['ok', 'skipped', 'error']),
+        // The entry's `<name>-audit.yaml`, relative to `outDir` (`<run dir>/<name>-audit.yaml`); `null` when unloadable.
+        outputPath: z.string().nullable(),
+    }).strict()),
+}).strict();
+/** The document this command publishes. */
+export const CORPUS_SCAN_REPORT_SCHEMA = reportSchema(CorpusScanDataSchema, FindingSchema);
+//# sourceMappingURL=scan-schema.js.map

package/dist/commands/corpus/scan-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-schema.js","sourceRoot":"","sources":["../../../src/commands/corpus/scan-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,oFAAoF;AACpF,MAAM,CAAC,MAAM,oBAAoB,GAAwB;IACvD,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,qFAAqF;CAChG,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;QAC/C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC1C,iHAAiH;QACjH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC,CAAC,MAAM,EAAE,CAAC;CACb,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,2CAA2C;AAC3C,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC"}

package/dist/commands/corpus/scan.d.ts

@@ -5,11 +5,42 @@
  * writes summary.yaml and per-plugin sibling files into a date-sha
  * subdirectory of `--out`. Sequential by design — concurrency is a
  * follow-up once the seed grows past ~50.
+ *
+ * Its stdout is the run's own report (`CORPUS_SCAN_REPORT_SCHEMA`): one row
+ * per seed entry, and one `CORPUS_ENTRY_INCOMPLETE` warning per entry it could
+ * not finish — so the exit derives 0 whatever the plugins held, and a scan
+ * that could not do an entry never publishes `ok`. The files under `--out` are
+ * artifacts through the same writer (`corpus-audit`, `corpus-summary`).
  */
+import { type FinishedWork } from '../../utils/document-writer.js';
+import { type PluginRow } from './report.js';
+import type { CorpusScanData } from './scan-schema.js';
 export interface CorpusScanOptions {
     out?: string;
     withReview?: boolean;
     debug?: boolean;
 }
+/** Where one run's files go: the resolved `--out`, and the run directory under it. */
+interface RunLocation {
+    readonly outDir: string;
+    readonly runDirName: string;
+}
+/**
+ * The work a scan has finished: one row per entry done, `outputPath` relative
+ * to `outDir`. Also what a refusal part-way publishes, so the entries that
+ * finished are not lost with the one that stopped the run.
+ *
+ * @param rows - The rows finished so far
+ * @param run - Where the run's files went
+ * @param leftovers - Temp directories the OS would not remove once their entry was done
+ */
+declare function finishedScan(rows: readonly PluginRow[], run: RunLocation, leftovers: readonly unknown[]): FinishedWork & {
+    data: CorpusScanData;
+};
+/** Test seam: the pure fold a refusal part-way publishes. */
+export declare const __internal: {
+    finishedScan: typeof finishedScan;
+};
 export declare function corpusScanCommand(seedFileArg: string | undefined, options: CorpusScanOptions): Promise<void>;
+export {};
 //# sourceMappingURL=scan.d.ts.map

package/dist/commands/corpus/scan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/commands/corpus/scan.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAiCD,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CA8Df"}
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/commands/corpus/scan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH,OAAO,EAAoE,KAAK,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAIrI,OAAO,EAAkC,KAAK,SAAS,EAAkB,MAAM,aAAa,CAAC;AAE7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAkDD,sFAAsF;AACtF,UAAU,WAAW;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAUD;;;;;;;;GAQG;AACH,iBAAS,YAAY,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,OAAO,EAAE,GAAG,YAAY,GAAG;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,CAiB1I;AAED,6DAA6D;AAC7D,eAAO,MAAM,UAAU;;CAAmB,CAAC;AA2E3C,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/commands/corpus/scan.js

@@ -5,16 +5,24 @@
  * writes summary.yaml and per-plugin sibling files into a date-sha
  * subdirectory of `--out`. Sequential by design — concurrency is a
  * follow-up once the seed grows past ~50.
+ *
+ * Its stdout is the run's own report (`CORPUS_SCAN_REPORT_SCHEMA`): one row
+ * per seed entry, and one `CORPUS_ENTRY_INCOMPLETE` warning per entry it could
+ * not finish — so the exit derives 0 whatever the plugins held, and a scan
+ * that could not do an entry never publishes `ok`. The files under `--out` are
+ * artifacts through the same writer (`corpus-audit`, `corpus-summary`).
  */
 import { mkdirSync, readFileSync } from 'node:fs';
 import { dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { safePath } from '@vibe-agent-toolkit/utils';
+import { buildReport, toFindings } from '@vibe-agent-toolkit/schema';
+import { forEachInOrder, safePath, toForwardSlash } from '@vibe-agent-toolkit/utils';
 import { runGit } from '@vibe-agent-toolkit/utils/git';
-import { handleCommandError } from '../../utils/command-error.js';
+import { CommandRefusalError, refusalCodeOf } from '../../utils/command-refusal.js';
+import { endWithRefusal, endWithReport, leftoverIssueOf, NOTHING_FINISHED } from '../../utils/document-writer.js';
 import { createLogger } from '../../utils/logger.js';
 import { projectRootOrNull } from '../../utils/project-root-policy.js';
-import { writeRunReport } from './report.js';
+import { writeRunOutput, writeRunReport } from './report.js';
 import { auditOnePlugin } from './runner.js';
 import { loadSeedFile } from './seed.js';
 const DEFAULT_SEED_PATH = 'corpus/seed.yaml';
@@ -44,59 +52,125 @@ function readVatCommit() {
     });
     return result.ok ? result.stdout : 'unknown';
 }
+/** `vat corpus scan` has no `--strict`: an incomplete entry warns, and a warning never fails the run. */
+const GATE = { strict: false };
+/** Why a row is unfinished — its audit could not run, or its requested review did not finish — or `undefined`. */
+function unfinishedReason(row) {
+    if (row.audit.status === 'unloadable')
+        return `audit could not run: ${row.audit.error ?? 'no reason recorded'}`;
+    if (row.review.status === 'error')
+        return `review did not finish: ${row.review.error ?? 'no reason recorded'}`;
+    return undefined;
+}
+/** One seed entry the scan could not finish, as a finding naming it by its seed index. */
+function incompleteEntryIssue(row, index) {
+    const why = unfinishedReason(row);
+    if (why === undefined)
+        return undefined;
+    return { code: 'CORPUS_ENTRY_INCOMPLETE', severity: 'warning', message: `${row.name}: ${why}`, field: `plugins[${index}]` };
+}
+/**
+ * The work a scan has finished: one row per entry done, `outputPath` relative
+ * to `outDir`. Also what a refusal part-way publishes, so the entries that
+ * finished are not lost with the one that stopped the run.
+ *
+ * @param rows - The rows finished so far
+ * @param run - Where the run's files went
+ * @param leftovers - Temp directories the OS would not remove once their entry was done
+ */
+function finishedScan(rows, run, leftovers) {
+    return {
+        examined: rows.length,
+        findings: toFindings([
+            ...rows.flatMap((row, index) => incompleteEntryIssue(row, index) ?? []),
+            ...leftovers.map((leftover) => leftoverIssueOf(leftover)),
+        ]),
+        data: {
+            outDir: run.outDir,
+            entries: rows.map((row) => ({
+                name: row.name,
+                audit: row.audit.status,
+                review: row.review.status,
+                outputPath: row.audit.output_path === undefined ? null : toForwardSlash(safePath.join(run.runDirName, row.audit.output_path)),
+            })),
+        },
+    };
+}
+/** Test seam: the pure fold a refusal part-way publishes. */
+export const __internal = { finishedScan };
+/**
+ * Audit every seed entry and write the run's files, recording each finished
+ * row in `progress` as it lands.
+ *
+ * @returns Where the run's files went
+ * @throws {CommandRefusalError} For a missing `--out`, a seed that cannot be
+ *   loaded, or a write under `--out` the OS refused
+ */
+async function scanSeed(seedFileArg, options, logger, progress) {
+    // Spec §7: `vat corpus *` uses `tolerate null` — scans operate against
+    // arbitrary external plugins without requiring a governing VAT project.
+    projectRootOrNull(process.cwd());
+    if (!options.out) {
+        throw new CommandRefusalError('USAGE_INVALID', 'specify an output directory: --out <path>');
+    }
+    const outDir = safePath.resolve(options.out);
+    const seedPath = seedFileArg ?? DEFAULT_SEED_PATH;
+    const seed = loadSeedFile(seedPath);
+    // eslint-disable-next-line local/no-fs-mkdirSync -- caller-supplied output dir; recursive create is correct here
+    writeRunOutput(outDir, () => mkdirSync(outDir, { recursive: true }));
+    // We need the run directory to write per-plugin files into during the
+    // loop. Build the report skeleton, derive the run dir name, create it,
+    // then run the loop.
+    const generatedAt = new Date().toISOString().replace(/\.\d+Z$/, 'Z');
+    const vatVersion = readVatVersion();
+    const vatCommit = readVatCommit();
+    const runDirName = `${generatedAt.slice(0, 10)}-${vatCommit}`;
+    const runDir = safePath.join(outDir, runDirName);
+    // eslint-disable-next-line local/no-fs-mkdirSync -- composed under user-supplied --out
+    writeRunOutput(runDir, () => mkdirSync(runDir, { recursive: true }));
+    progress.run = { outDir, runDirName };
+    // One plugin at a time: each spawns a heavy audit and appends to the progress file.
+    await forEachInOrder(seed.plugins, async (entry) => {
+        logger.info(`[${entry.name}] auditing ${entry.source}`);
+        const row = await auditOnePlugin(entry, {
+            runDir,
+            withReview: options.withReview === true,
+            debug: options.debug === true,
+            leftovers: progress.leftovers,
+        });
+        progress.rows.push(row);
+        logger.info(`[${entry.name}] audit=${row.audit.status} review=${row.review.status}`);
+    });
+    const report = {
+        generated_at: generatedAt,
+        vat_version: vatVersion,
+        vat_commit: vatCommit,
+        seed_file: seedPath,
+        flags: {
+            with_review: options.withReview === true,
+            debug: options.debug === true,
+        },
+        plugins: progress.rows,
+    };
+    writeRunReport(report, outDir);
+    logger.info(`Wrote run report to ${runDir}/summary.yaml`);
+    logger.info(`  ${progress.rows.length} plugins; durations recorded in summary.yaml`);
+    return progress.run;
+}
 export async function corpusScanCommand(seedFileArg, options) {
     const logger = createLogger(options.debug ? { debug: true } : {});
     const startTime = Date.now();
+    const progress = { rows: [], leftovers: [], run: undefined };
+    let run;
     try {
-        // Spec §7: `vat corpus *` uses `tolerate null` — scans operate against
-        // arbitrary external plugins without requiring a governing VAT project.
-        projectRootOrNull(process.cwd());
-        if (!options.out) {
-            throw new Error('specify an output directory: --out <path>');
-        }
-        const seedPath = seedFileArg ?? DEFAULT_SEED_PATH;
-        const seed = loadSeedFile(seedPath);
-        // eslint-disable-next-line local/no-fs-mkdirSync -- caller-supplied output dir; recursive create is correct here
-        mkdirSync(options.out, { recursive: true });
-        // We need the run directory to write per-plugin files into during the
-        // loop. Build the report skeleton, derive the run dir name, create it,
-        // then run the loop.
-        const generatedAt = new Date().toISOString().replace(/\.\d+Z$/, 'Z');
-        const vatVersion = readVatVersion();
-        const vatCommit = readVatCommit();
-        const runDirName = `${generatedAt.slice(0, 10)}-${vatCommit}`;
-        const runDir = safePath.join(options.out, runDirName);
-        // eslint-disable-next-line local/no-fs-mkdirSync -- composed under user-supplied --out
-        mkdirSync(runDir, { recursive: true });
-        const rows = [];
-        for (const entry of seed.plugins) {
-            logger.info(`[${entry.name}] auditing ${entry.source}`);
-            const row = await auditOnePlugin(entry, {
-                runDir,
-                withReview: options.withReview === true,
-                debug: options.debug === true,
-            });
-            rows.push(row);
-            logger.info(`[${entry.name}] audit=${row.audit.status} review=${row.review.status}`);
-        }
-        const report = {
-            generated_at: generatedAt,
-            vat_version: vatVersion,
-            vat_commit: vatCommit,
-            seed_file: seedPath,
-            flags: {
-                with_review: options.withReview === true,
-                debug: options.debug === true,
-            },
-            plugins: rows,
-        };
-        await writeRunReport(report, options.out);
-        logger.info(`Wrote run report to ${runDir}/summary.yaml`);
-        logger.info(`  ${rows.length} plugins; durations recorded in summary.yaml`);
-        logger.debug(`Total scan duration: ${Date.now() - startTime}ms`);
+        run = await scanSeed(seedFileArg, options, logger, progress);
     }
     catch (err) {
-        handleCommandError(err, logger, startTime, 'CorpusScan');
+        // A refusal after the run directory existed publishes the entries that finished.
+        const finished = progress.run === undefined ? NOTHING_FINISHED : finishedScan(progress.rows, progress.run, progress.leftovers);
+        endWithRefusal('corpus scan', refusalCodeOf(err), err, 'yaml', GATE, finished);
     }
+    const { examined, findings, data } = finishedScan(progress.rows, run, progress.leftovers);
+    endWithReport('corpus scan', buildReport({ examined, findings, data, gate: GATE, durationMs: Date.now() - startTime }), 'yaml');
 }
 //# sourceMappingURL=scan.js.map

package/dist/commands/corpus/scan.js.map

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

package/dist/commands/corpus/seed.d.ts

@@ -72,8 +72,8 @@ declare const PluginEntrySchema: z.ZodObject<{
         }[] | undefined;
     }>>;
 }, "strict", z.ZodTypeAny, {
-    name: string;
     source: string;
+    name: string;
     bucket: "official" | "community";
     confidence: "first-party" | "curated" | "listed";
     maturity: "production" | "experimental" | "example";
@@ -85,8 +85,8 @@ declare const PluginEntrySchema: z.ZodObject<{
         }[] | undefined;
     } | undefined;
 }, {
-    name: string;
     source: string;
+    name: string;
     bucket: "official" | "community";
     confidence: "first-party" | "curated" | "listed";
     maturity: "production" | "experimental" | "example";
@@ -131,8 +131,8 @@ declare const SeedSchema: z.ZodObject<{
             }[] | undefined;
         }>>;
     }, "strict", z.ZodTypeAny, {
-        name: string;
         source: string;
+        name: string;
         bucket: "official" | "community";
         confidence: "first-party" | "curated" | "listed";
         maturity: "production" | "experimental" | "example";
@@ -144,8 +144,8 @@ declare const SeedSchema: z.ZodObject<{
             }[] | undefined;
         } | undefined;
     }, {
-        name: string;
         source: string;
+        name: string;
         bucket: "official" | "community";
         confidence: "first-party" | "curated" | "listed";
         maturity: "production" | "experimental" | "example";
@@ -159,8 +159,8 @@ declare const SeedSchema: z.ZodObject<{
     }>, "many">;
 }, "strict", z.ZodTypeAny, {
     plugins: {
-        name: string;
         source: string;
+        name: string;
         bucket: "official" | "community";
         confidence: "first-party" | "curated" | "listed";
         maturity: "production" | "experimental" | "example";
@@ -174,8 +174,8 @@ declare const SeedSchema: z.ZodObject<{
     }[];
 }, {
     plugins: {
-        name: string;
         source: string;
+        name: string;
         bucket: "official" | "community";
         confidence: "first-party" | "curated" | "listed";
         maturity: "production" | "experimental" | "example";
@@ -194,8 +194,11 @@ export type PluginEntry = z.infer<typeof PluginEntrySchema>;
 export type Seed = z.infer<typeof SeedSchema>;
 /**
  * Load and validate `corpus/seed.yaml` (or another seed-shaped YAML file).
- * Throws on missing file, malformed YAML, schema violations, duplicate
- * `source` keys, or duplicate `name` labels.
+ *
+ * @throws {CommandRefusalError} `USAGE_INVALID` when the file is not there (the
+ *   argument names nothing); `INPUT_UNREADABLE` when the OS refuses it;
+ *   `CONFIG_INVALID` for malformed YAML, a schema violation, or a duplicate
+ *   `source` or `name`
  */
 export declare function loadSeedFile(path: string): Seed;
 export {};

package/dist/commands/corpus/seed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../../src/commands/corpus/seed.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,0BAA0B;;;;;;;;;EAGrB,CAAC;AAEZ,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EAKhB,CAAC;AAIZ,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYZ,CAAC;AAEZ,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIL,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAuB/C"}
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../../src/commands/corpus/seed.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,QAAA,MAAM,0BAA0B;;;;;;;;;EAGrB,CAAC;AAEZ,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EAKhB,CAAC;AAIZ,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYZ,CAAC;AAEZ,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIL,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAoB9C;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkB/C"}

package/dist/commands/corpus/seed.js

@@ -4,9 +4,10 @@
  * mirrors the `skills.defaults.validation` block of the project config
  * schema (severity overrides + allow entries).
  */
-import { existsSync, readFileSync } from 'node:fs';
 import * as yaml from 'yaml';
 import { z } from 'zod';
+import { CommandRefusalError, errorMessageOf } from '../../utils/command-refusal.js';
+import { readInputFile } from '../../utils/project-root-policy.js';
 const ValidationAllowEntrySchema = z.object({
     code: z.string().min(1),
     reason: z.string().min(1),
@@ -37,26 +38,43 @@ const SeedSchema = z
     plugins: z.array(PluginEntrySchema).min(1),
 })
     .strict();
+/** The seed's own mistake: it is the operator's config for the scan. */
+function seedInvalid(path, why, cause) {
+    return new CommandRefusalError('CONFIG_INVALID', `Seed file ${path} is invalid: ${why}`, cause === undefined ? undefined : { cause });
+}
+/** Parse the seed's text as YAML and against {@link SeedSchema}, refusing either as the seed's mistake. */
+function parseSeed(path, raw) {
+    let parsed;
+    try {
+        parsed = yaml.parse(raw);
+    }
+    catch (error) {
+        throw seedInvalid(path, errorMessageOf(error), error);
+    }
+    const result = SeedSchema.safeParse(parsed);
+    if (!result.success)
+        throw seedInvalid(path, result.error.message, result.error);
+    return result.data;
+}
 /**
  * Load and validate `corpus/seed.yaml` (or another seed-shaped YAML file).
- * Throws on missing file, malformed YAML, schema violations, duplicate
- * `source` keys, or duplicate `name` labels.
+ *
+ * @throws {CommandRefusalError} `USAGE_INVALID` when the file is not there (the
+ *   argument names nothing); `INPUT_UNREADABLE` when the OS refuses it;
+ *   `CONFIG_INVALID` for malformed YAML, a schema violation, or a duplicate
+ *   `source` or `name`
  */
 export function loadSeedFile(path) {
-    if (!existsSync(path)) {
-        throw new Error(`Seed file not found: ${path}`);
-    }
-    const raw = readFileSync(path, 'utf-8');
-    const parsed = yaml.parse(raw);
-    const seed = SeedSchema.parse(parsed);
+    const raw = readInputFile(path, { origin: 'argument', message: `Seed file not found: ${path}` });
+    const seed = parseSeed(path, raw);
     const sources = new Set();
     const names = new Set();
     for (const entry of seed.plugins) {
         if (sources.has(entry.source)) {
-            throw new Error(`Seed has duplicate source: ${entry.source}`);
+            throw seedInvalid(path, `duplicate source: ${entry.source}`);
         }
         if (names.has(entry.name)) {
-            throw new Error(`Seed has duplicate name: ${entry.name}`);
+            throw seedInvalid(path, `duplicate name: ${entry.name}`);
         }
         sources.add(entry.source);
         names.add(entry.name);

package/dist/commands/corpus/seed.js.map

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