@seanmars/tospec 0.4.2

package/dist/commands/show.js

@@ -0,0 +1,164 @@
+import { isInteractive } from '../utils/interactive.js';
+import { getActiveChangeIds, getSpecIds } from '../utils/item-discovery.js';
+import { resolveRootForCommand, toRootOutput, } from '../core/root-selection.js';
+import { ChangePresenter } from '../core/change-presenter.js';
+import { SpecPresenter } from '../core/spec-presenter.js';
+import { nearestMatches } from '../utils/match.js';
+const CHANGE_FLAG_KEYS = new Set(['deltasOnly', 'requirementsOnly']);
+const SPEC_FLAG_KEYS = new Set(['requirements', 'scenarios', 'requirement']);
+export class ShowCommand {
+    async execute(itemName, options = {}) {
+        const root = await resolveRootForCommand(options, { json: options.json });
+        if (!root) {
+            return;
+        }
+        const interactive = isInteractive(options);
+        const typeOverride = this.normalizeType(options.type);
+        if (!itemName) {
+            if (interactive) {
+                const { select } = await import('@inquirer/prompts');
+                const type = await select({
+                    message: 'What would you like to show?',
+                    choices: [
+                        { name: 'Change', value: 'change' },
+                        { name: 'Spec', value: 'spec' },
+                    ],
+                });
+                await this.runInteractiveByType(type, options, root);
+                return;
+            }
+            this.printNonInteractiveHint(root);
+            process.exitCode = 1;
+            return;
+        }
+        await this.showDirect(itemName, { typeOverride, options, root });
+    }
+    normalizeType(value) {
+        if (!value)
+            return undefined;
+        const v = value.toLowerCase();
+        if (v === 'change' || v === 'spec')
+            return v;
+        return undefined;
+    }
+    delegateOptions(root, options) {
+        return {
+            ...options,
+            ...(options.json ? { rootOutput: toRootOutput(root) } : {}),
+        };
+    }
+    async runInteractiveByType(type, options, root) {
+        const { select } = await import('@inquirer/prompts');
+        if (type === 'change') {
+            const changes = await getActiveChangeIds(root.path);
+            if (changes.length === 0) {
+                console.error('No changes found.');
+                process.exitCode = 1;
+                return;
+            }
+            const picked = await select({ message: 'Pick a change', choices: changes.map(id => ({ name: id, value: id })) });
+            const cmd = new ChangePresenter(root.path);
+            await cmd.show(picked, this.delegateOptions(root, options));
+            return;
+        }
+        const specs = await getSpecIds(root.path);
+        if (specs.length === 0) {
+            console.error('No specs found.');
+            process.exitCode = 1;
+            return;
+        }
+        const picked = await select({ message: 'Pick a spec', choices: specs.map(id => ({ name: id, value: id })) });
+        const cmd = new SpecPresenter(root.path);
+        await cmd.show(picked, this.delegateOptions(root, options));
+    }
+    async showDirect(itemName, params) {
+        const root = params.root;
+        // Optimize lookups when type is pre-specified
+        let isChange = false;
+        let isSpec = false;
+        let changes = [];
+        let specs = [];
+        if (params.typeOverride === 'change') {
+            changes = await getActiveChangeIds(root.path);
+            isChange = changes.includes(itemName);
+        }
+        else if (params.typeOverride === 'spec') {
+            specs = await getSpecIds(root.path);
+            isSpec = specs.includes(itemName);
+        }
+        else {
+            [changes, specs] = await Promise.all([getActiveChangeIds(root.path), getSpecIds(root.path)]);
+            isChange = changes.includes(itemName);
+            isSpec = specs.includes(itemName);
+        }
+        const resolvedType = params.typeOverride ?? (isChange ? 'change' : isSpec ? 'spec' : undefined);
+        if (!resolvedType) {
+            const suggestions = nearestMatches(itemName, [...changes, ...specs]);
+            const message = suggestions.length
+                ? `Unknown item '${itemName}'. Did you mean: ${suggestions.join(', ')}?`
+                : `Unknown item '${itemName}'.`;
+            if (params.options.json) {
+                console.log(JSON.stringify({ status: [{ severity: 'error', code: 'unknown_item', message }] }, null, 2));
+            }
+            else {
+                console.error(message);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        if (!params.typeOverride && isChange && isSpec) {
+            if (params.options.json) {
+                console.log(JSON.stringify({
+                    status: [
+                        {
+                            severity: 'error',
+                            code: 'ambiguous_item',
+                            message: `Ambiguous item '${itemName}' matches both a change and a spec.`,
+                            fix: 'Pass --type change|spec.',
+                        },
+                    ],
+                }, null, 2));
+                process.exitCode = 1;
+                return;
+            }
+            console.error(`Ambiguous item '${itemName}' matches both a change and a spec.`);
+            console.error('Pass --type change|spec, or use: tospec show <item> --type change / --type spec');
+            process.exitCode = 1;
+            return;
+        }
+        this.warnIrrelevantFlags(resolvedType, params.options);
+        if (resolvedType === 'change') {
+            const cmd = new ChangePresenter(root.path);
+            await cmd.show(itemName, this.delegateOptions(root, params.options));
+            return;
+        }
+        const cmd = new SpecPresenter(root.path);
+        await cmd.show(itemName, this.delegateOptions(root, params.options));
+    }
+    printNonInteractiveHint(root) {
+        console.error('Nothing to show. Try one of:');
+        console.error('  tospec show <item>');
+        console.error('  tospec show <item> --type change');
+        console.error('  tospec show <item> --type spec');
+        console.error('Or run in an interactive terminal.');
+    }
+    warnIrrelevantFlags(type, options) {
+        const irrelevant = [];
+        if (type === 'change') {
+            for (const k of SPEC_FLAG_KEYS)
+                if (k in options)
+                    irrelevant.push(k);
+        }
+        else {
+            for (const k of CHANGE_FLAG_KEYS)
+                if (k in options)
+                    irrelevant.push(k);
+        }
+        if (irrelevant.length > 0) {
+            console.error(`Warning: Ignoring flags not applicable to ${type}: ${irrelevant.join(', ')}`);
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/show.js.map

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

package/dist/commands/validate.d.ts

@@ -0,0 +1,51 @@
+import type { ValidationIssue, ValidationReport } from '../core/validation/types.js';
+interface ExecuteOptions {
+    all?: boolean;
+    changes?: boolean;
+    specs?: boolean;
+    type?: string;
+    strict?: boolean;
+    json?: boolean;
+    noInteractive?: boolean;
+    interactive?: boolean;
+    concurrency?: string;
+}
+export declare class ValidateCommand {
+    execute(itemName: string | undefined, options?: ExecuteOptions): Promise<void>;
+    private normalizeType;
+    /**
+     * Resolve change IDs by directory existence within the resolved root — the
+     * same rule `tospec status`/`instructions` use (`getAvailableChanges`) —
+     * rather than requiring `proposal.md`. This lets `validate` resolve a
+     * scaffolded or still-authoring change that the sibling commands already
+     * resolve (#1182). Sorted to preserve the prior `getActiveChangeIds` ordering.
+     */
+    private listChangeIds;
+    private runInteractiveSelector;
+    private printNonInteractiveHint;
+    private validateDirectItem;
+    private validateByType;
+    private printReport;
+    private printNextSteps;
+    private runBulkValidation;
+}
+/**
+ * Validates schema-declared `requiredSections` for ticket/design/task-style
+ * artifacts that have no Requirement grammar of their own. Only artifacts
+ * that (a) declare a `validation` block and (b) already have an output file
+ * on disk are checked — artifacts not yet produced are `status`'s concern,
+ * not validate's.
+ */
+export declare function validateArtifactSections(projectRoot: string, changeDir: string): Promise<ValidationIssue[]>;
+/**
+ * Whether a change's schema requires at least one delta spec. False only
+ * when the schema declares `specs` as `optional` and this change produced
+ * none — a pure fix with no behavioral change (e.g. an issue schema change)
+ * is a legitimate, complete change, not a validation failure. Falls back to
+ * requiring deltas (the stricter, pre-existing behavior) when the schema
+ * can't be resolved.
+ */
+export declare function deltaSpecsRequired(projectRoot: string, changeDir: string): Promise<boolean>;
+export declare function mergeSectionIssues(report: ValidationReport, extra: ValidationIssue[], strict: boolean): ValidationReport;
+export {};
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAkBrF,UAAU,cAAc;IACtB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAUD,qBAAa,eAAe;IACpB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCxF,OAAO,CAAC,aAAa;IAOrB;;;;;;OAMG;YACW,aAAa;YAKb,sBAAsB;IA8BpC,OAAO,CAAC,uBAAuB;YASjB,kBAAkB;YAyDlB,cAAc;IAyB5B,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,cAAc;YAeR,iBAAiB;CA0HhC;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA6BjH;AAID;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcjG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAQxH"}

package/dist/commands/validate.js

@@ -0,0 +1,416 @@
+import path from 'path';
+import { promises as fs } from 'fs';
+import { Validator } from '../core/validation/validator.js';
+import { validateSections } from '../core/validation/section-validator.js';
+import { resolveSchema, getSchemaDir } from '../core/artifact-graph/resolver.js';
+import { resolveArtifactOutputs } from '../core/artifact-graph/outputs.js';
+import { resolveSchemaForChange } from '../utils/change-metadata.js';
+import { FileSystemUtils } from '../utils/file-system.js';
+import { resolveRootForCommand, toRootOutput, } from '../core/root-selection.js';
+import { isInteractive, resolveNoInteractive } from '../utils/interactive.js';
+import { getSpecIds } from '../utils/item-discovery.js';
+import { getAvailableChanges } from './workflow/shared.js';
+import { nearestMatches } from '../utils/match.js';
+export class ValidateCommand {
+    async execute(itemName, options = {}) {
+        const root = await resolveRootForCommand(options, { json: options.json });
+        if (!root) {
+            return;
+        }
+        const interactive = isInteractive(options);
+        // Handle bulk flags first
+        if (options.all || options.changes || options.specs) {
+            await this.runBulkValidation(root, {
+                changes: !!options.all || !!options.changes,
+                specs: !!options.all || !!options.specs,
+            }, { strict: !!options.strict, json: !!options.json, concurrency: options.concurrency, noInteractive: resolveNoInteractive(options) });
+            return;
+        }
+        // No item and no flags
+        if (!itemName) {
+            if (interactive) {
+                await this.runInteractiveSelector(root, { strict: !!options.strict, json: !!options.json, concurrency: options.concurrency });
+                return;
+            }
+            this.printNonInteractiveHint(root);
+            process.exitCode = 1;
+            return;
+        }
+        // Direct item validation with type detection or override
+        const typeOverride = this.normalizeType(options.type);
+        await this.validateDirectItem(root, itemName, { typeOverride, strict: !!options.strict, json: !!options.json });
+    }
+    normalizeType(value) {
+        if (!value)
+            return undefined;
+        const v = value.toLowerCase();
+        if (v === 'change' || v === 'spec')
+            return v;
+        return undefined;
+    }
+    /**
+     * Resolve change IDs by directory existence within the resolved root — the
+     * same rule `tospec status`/`instructions` use (`getAvailableChanges`) —
+     * rather than requiring `proposal.md`. This lets `validate` resolve a
+     * scaffolded or still-authoring change that the sibling commands already
+     * resolve (#1182). Sorted to preserve the prior `getActiveChangeIds` ordering.
+     */
+    async listChangeIds(root) {
+        const ids = await getAvailableChanges(root.path, root.changesDir);
+        return ids.sort();
+    }
+    async runInteractiveSelector(root, opts) {
+        const { select } = await import('@inquirer/prompts');
+        const choice = await select({
+            message: 'What would you like to validate?',
+            choices: [
+                { name: 'All (changes + specs)', value: 'all' },
+                { name: 'All changes', value: 'changes' },
+                { name: 'All specs', value: 'specs' },
+                { name: 'Pick a specific change or spec', value: 'one' },
+            ],
+        });
+        if (choice === 'all')
+            return this.runBulkValidation(root, { changes: true, specs: true }, opts);
+        if (choice === 'changes')
+            return this.runBulkValidation(root, { changes: true, specs: false }, opts);
+        if (choice === 'specs')
+            return this.runBulkValidation(root, { changes: false, specs: true }, opts);
+        // one
+        const [changes, specs] = await Promise.all([this.listChangeIds(root), getSpecIds(root.path)]);
+        const items = [];
+        items.push(...changes.map(id => ({ name: `change/${id}`, value: { type: 'change', id } })));
+        items.push(...specs.map(id => ({ name: `spec/${id}`, value: { type: 'spec', id } })));
+        if (items.length === 0) {
+            console.error('No items found to validate.');
+            process.exitCode = 1;
+            return;
+        }
+        const picked = await select({ message: 'Pick an item', choices: items });
+        await this.validateByType(root, picked.type, picked.id, opts);
+    }
+    printNonInteractiveHint(root) {
+        console.error('Nothing to validate. Try one of:');
+        console.error(`  ${'tospec validate --all'}`);
+        console.error(`  ${'tospec validate --changes'}`);
+        console.error(`  ${'tospec validate --specs'}`);
+        console.error(`  ${'tospec validate <item-name>'}`);
+        console.error('Or run in an interactive terminal.');
+    }
+    async validateDirectItem(root, itemName, opts) {
+        const [changes, specs] = await Promise.all([this.listChangeIds(root), getSpecIds(root.path)]);
+        const isChange = changes.includes(itemName);
+        const isSpec = specs.includes(itemName);
+        const type = opts.typeOverride ?? (isChange ? 'change' : isSpec ? 'spec' : undefined);
+        if (!type) {
+            const suggestions = nearestMatches(itemName, [...changes, ...specs]);
+            const message = suggestions.length
+                ? `Unknown item '${itemName}'. Did you mean: ${suggestions.join(', ')}?`
+                : `Unknown item '${itemName}'.`;
+            if (opts.json) {
+                console.log(JSON.stringify({ status: [{ severity: 'error', code: 'unknown_item', message }] }, null, 2));
+            }
+            else {
+                console.error(message);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        if (!opts.typeOverride && isChange && isSpec) {
+            if (opts.json) {
+                console.log(JSON.stringify({
+                    status: [
+                        {
+                            severity: 'error',
+                            code: 'ambiguous_item',
+                            message: `Ambiguous item '${itemName}' matches both a change and a spec.`,
+                            fix: 'Pass --type change|spec.',
+                        },
+                    ],
+                }, null, 2));
+                process.exitCode = 1;
+                return;
+            }
+            console.error(`Ambiguous item '${itemName}' matches both a change and a spec.`);
+            console.error('Pass --type change|spec, or use: tospec validate --changes / tospec validate --specs');
+            process.exitCode = 1;
+            return;
+        }
+        await this.validateByType(root, type, itemName, opts);
+    }
+    async validateByType(root, type, id, opts) {
+        const validator = new Validator(opts.strict);
+        if (type === 'change') {
+            const changeDir = path.join(root.changesDir, id);
+            const start = Date.now();
+            const requireDeltas = await deltaSpecsRequired(root.path, changeDir);
+            const [deltaReport, sectionIssues] = await Promise.all([
+                requireDeltas ? validator.validateChangeDeltaSpecs(changeDir) : Promise.resolve(EMPTY_REPORT),
+                validateArtifactSections(root.path, changeDir),
+            ]);
+            const report = mergeSectionIssues(deltaReport, sectionIssues, opts.strict);
+            const durationMs = Date.now() - start;
+            this.printReport('change', id, report, durationMs, opts.json, root);
+            // Non-zero exit if invalid (keeps enriched output test semantics)
+            process.exitCode = report.valid ? 0 : 1;
+            return;
+        }
+        const file = path.join(root.specsDir, id, 'spec.md');
+        const start = Date.now();
+        const report = await validator.validateSpec(file);
+        const durationMs = Date.now() - start;
+        this.printReport('spec', id, report, durationMs, opts.json, root);
+        process.exitCode = report.valid ? 0 : 1;
+    }
+    printReport(type, id, report, durationMs, json, root) {
+        if (json) {
+            const out = { items: [{ id, type, valid: report.valid, issues: report.issues, durationMs }], summary: { totals: { items: 1, passed: report.valid ? 1 : 0, failed: report.valid ? 0 : 1 }, byType: { [type]: { items: 1, passed: report.valid ? 1 : 0, failed: report.valid ? 0 : 1 } } }, version: '1.0', root: toRootOutput(root) };
+            console.log(JSON.stringify(out, null, 2));
+            return;
+        }
+        if (report.valid) {
+            console.log(`${type === 'change' ? 'Change' : 'Specification'} '${id}' is valid`);
+        }
+        else {
+            console.error(`${type === 'change' ? 'Change' : 'Specification'} '${id}' has issues`);
+            for (const issue of report.issues) {
+                const label = issue.level === 'ERROR' ? 'ERROR' : issue.level;
+                const prefix = issue.level === 'ERROR' ? '✗' : issue.level === 'WARNING' ? '⚠' : 'ℹ';
+                console.error(`${prefix} [${label}] ${issue.path}: ${issue.message}`);
+            }
+            this.printNextSteps(type, id, root);
+        }
+    }
+    printNextSteps(type, id, root) {
+        const bullets = [];
+        if (type === 'change') {
+            bullets.push('- Ensure change has deltas in specs/: use headers ## ADDED/MODIFIED/REMOVED/RENAMED Requirements');
+            bullets.push('- Each requirement MUST include at least one #### Scenario: block');
+            bullets.push(`- Debug parsed deltas: ${`tospec show ${id} --json --deltas-only`}`);
+        }
+        else {
+            bullets.push('- Ensure spec includes ## Purpose and ## Requirements sections');
+            bullets.push('- Each requirement MUST include at least one #### Scenario: block');
+            bullets.push('- Re-run with --json to see structured report');
+        }
+        console.error('Next steps:');
+        bullets.forEach(b => console.error(`  ${b}`));
+    }
+    async runBulkValidation(root, scope, opts) {
+        const showProgress = !opts.json && !opts.noInteractive;
+        const [changeIds, specIds] = await Promise.all([
+            scope.changes ? this.listChangeIds(root) : Promise.resolve([]),
+            scope.specs ? getSpecIds(root.path) : Promise.resolve([]),
+        ]);
+        const DEFAULT_CONCURRENCY = 6;
+        const maxSuggestions = 5; // used by nearestMatches
+        const concurrency = normalizeConcurrency(opts.concurrency) ?? normalizeConcurrency(process.env.TOSPEC_CONCURRENCY) ?? DEFAULT_CONCURRENCY;
+        const validator = new Validator(opts.strict);
+        const queue = [];
+        for (const id of changeIds) {
+            queue.push(async () => {
+                const start = Date.now();
+                const changeDir = path.join(root.changesDir, id);
+                const requireDeltas = await deltaSpecsRequired(root.path, changeDir);
+                const [deltaReport, sectionIssues] = await Promise.all([
+                    requireDeltas ? validator.validateChangeDeltaSpecs(changeDir) : Promise.resolve(EMPTY_REPORT),
+                    validateArtifactSections(root.path, changeDir),
+                ]);
+                const report = mergeSectionIssues(deltaReport, sectionIssues, opts.strict);
+                const durationMs = Date.now() - start;
+                return { id, type: 'change', valid: report.valid, issues: report.issues, durationMs };
+            });
+        }
+        for (const id of specIds) {
+            queue.push(async () => {
+                const start = Date.now();
+                const file = path.join(root.specsDir, id, 'spec.md');
+                const report = await validator.validateSpec(file);
+                const durationMs = Date.now() - start;
+                return { id, type: 'spec', valid: report.valid, issues: report.issues, durationMs };
+            });
+        }
+        if (queue.length === 0) {
+            const summary = {
+                totals: { items: 0, passed: 0, failed: 0 },
+                byType: {
+                    ...(scope.changes ? { change: { items: 0, passed: 0, failed: 0 } } : {}),
+                    ...(scope.specs ? { spec: { items: 0, passed: 0, failed: 0 } } : {}),
+                },
+            };
+            if (opts.json) {
+                const out = { items: [], summary, version: '1.0', root: toRootOutput(root) };
+                console.log(JSON.stringify(out, null, 2));
+            }
+            else {
+                console.log('No items found to validate.');
+            }
+            process.exitCode = 0;
+            return;
+        }
+        if (showProgress) {
+            console.log(`Validating ${queue.length} item(s)...`);
+        }
+        const results = [];
+        let index = 0;
+        let running = 0;
+        let passed = 0;
+        let failed = 0;
+        await new Promise((resolve) => {
+            const next = () => {
+                while (running < concurrency && index < queue.length) {
+                    const currentIndex = index++;
+                    const task = queue[currentIndex];
+                    running++;
+                    task()
+                        .then(res => {
+                        results.push(res);
+                        if (res.valid)
+                            passed++;
+                        else
+                            failed++;
+                    })
+                        .catch((error) => {
+                        const message = error?.message || 'Unknown error';
+                        const res = { id: getPlannedId(currentIndex, changeIds, specIds) ?? 'unknown', type: getPlannedType(currentIndex, changeIds, specIds) ?? 'change', valid: false, issues: [{ level: 'ERROR', path: 'file', message }], durationMs: 0 };
+                        results.push(res);
+                        failed++;
+                    })
+                        .finally(() => {
+                        running--;
+                        if (index >= queue.length && running === 0)
+                            resolve();
+                        else
+                            next();
+                    });
+                }
+            };
+            next();
+        });
+        results.sort((a, b) => a.id.localeCompare(b.id));
+        const summary = {
+            totals: { items: results.length, passed, failed },
+            byType: {
+                ...(scope.changes ? { change: summarizeType(results, 'change') } : {}),
+                ...(scope.specs ? { spec: summarizeType(results, 'spec') } : {}),
+            },
+        };
+        if (opts.json) {
+            const out = { items: results, summary, version: '1.0', root: toRootOutput(root) };
+            console.log(JSON.stringify(out, null, 2));
+        }
+        else {
+            for (const res of results) {
+                if (res.valid)
+                    console.log(`✓ ${res.type}/${res.id}`);
+                else
+                    console.error(`✗ ${res.type}/${res.id}`);
+            }
+            console.log(`Totals: ${summary.totals.passed} passed, ${summary.totals.failed} failed (${summary.totals.items} items)`);
+            const firstFailure = results.find((res) => !res.valid);
+            if (firstFailure) {
+                console.log(`Details: tospec validate ${firstFailure.id} --type ${firstFailure.type}`);
+            }
+        }
+        process.exitCode = failed > 0 ? 1 : 0;
+    }
+}
+/**
+ * Validates schema-declared `requiredSections` for ticket/design/task-style
+ * artifacts that have no Requirement grammar of their own. Only artifacts
+ * that (a) declare a `validation` block and (b) already have an output file
+ * on disk are checked — artifacts not yet produced are `status`'s concern,
+ * not validate's.
+ */
+export async function validateArtifactSections(projectRoot, changeDir) {
+    const issues = [];
+    let schemaName;
+    let schema;
+    try {
+        schemaName = resolveSchemaForChange(changeDir, undefined, projectRoot);
+        schema = resolveSchema(schemaName, projectRoot);
+    }
+    catch {
+        return issues;
+    }
+    const schemaDir = getSchemaDir(schemaName, projectRoot);
+    for (const artifact of schema.artifacts) {
+        if (!artifact.validation)
+            continue;
+        for (const file of resolveArtifactOutputs(changeDir, artifact.generates)) {
+            const content = await fs.readFile(file, 'utf-8');
+            const relPath = FileSystemUtils.toPosixPath(path.relative(changeDir, file));
+            const templateRef = schemaDir
+                ? FileSystemUtils.toPosixPath(path.join(path.relative(projectRoot, schemaDir), 'templates', artifact.template))
+                : undefined;
+            issues.push(...validateSections(content, artifact.validation, { path: relPath, templateRef }));
+        }
+    }
+    return issues;
+}
+const EMPTY_REPORT = { valid: true, issues: [], summary: { errors: 0, warnings: 0, info: 0 } };
+/**
+ * Whether a change's schema requires at least one delta spec. False only
+ * when the schema declares `specs` as `optional` and this change produced
+ * none — a pure fix with no behavioral change (e.g. an issue schema change)
+ * is a legitimate, complete change, not a validation failure. Falls back to
+ * requiring deltas (the stricter, pre-existing behavior) when the schema
+ * can't be resolved.
+ */
+export async function deltaSpecsRequired(projectRoot, changeDir) {
+    let schemaName;
+    let schema;
+    try {
+        schemaName = resolveSchemaForChange(changeDir, undefined, projectRoot);
+        schema = resolveSchema(schemaName, projectRoot);
+    }
+    catch {
+        return true;
+    }
+    const specsArtifact = schema.artifacts.find((a) => a.id === 'specs');
+    if (!specsArtifact?.optional)
+        return true;
+    return resolveArtifactOutputs(changeDir, specsArtifact.generates).length > 0;
+}
+export function mergeSectionIssues(report, extra, strict) {
+    if (extra.length === 0)
+        return report;
+    const issues = [...report.issues, ...extra];
+    const errors = issues.filter(i => i.level === 'ERROR').length;
+    const warnings = issues.filter(i => i.level === 'WARNING').length;
+    const info = issues.filter(i => i.level === 'INFO').length;
+    const valid = strict ? errors === 0 && warnings === 0 : errors === 0;
+    return { valid, issues, summary: { errors, warnings, info } };
+}
+function summarizeType(results, type) {
+    const filtered = results.filter(r => r.type === type);
+    const items = filtered.length;
+    const passed = filtered.filter(r => r.valid).length;
+    const failed = items - passed;
+    return { items, passed, failed };
+}
+function normalizeConcurrency(value) {
+    if (!value)
+        return undefined;
+    const n = parseInt(value, 10);
+    if (Number.isNaN(n) || n <= 0)
+        return undefined;
+    return n;
+}
+function getPlannedId(index, changeIds, specIds) {
+    const totalChanges = changeIds.length;
+    if (index < totalChanges)
+        return changeIds[index];
+    const specIndex = index - totalChanges;
+    return specIds[specIndex];
+}
+function getPlannedType(index, changeIds, specIds) {
+    const totalChanges = changeIds.length;
+    if (index < totalChanges)
+        return 'change';
+    const specIndex = index - totalChanges;
+    if (specIndex >= 0 && specIndex < specIds.length)
+        return 'spec';
+    return undefined;
+}
+//# sourceMappingURL=validate.js.map