@lumenflow/cli 3.1.3 → 3.2.1

package/dist/validate-agent-sync.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file validate-agent-sync.ts
+ * @description Validates agent sync state (WU-1111)
+ *
+ * Validates that agent configuration files exist and are properly structured.
+ * Checks .claude/agents/ for valid agent definitions.
+ *
+ * Usage:
+ *   validate-agent-sync                # Validate agent configuration
+ *
+ * Exit codes:
+ *   0 - Agent configuration valid
+ *   1 - Validation errors found
+ *
+ * @see {@link .claude/agents/} - Agent definitions
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+import { FILE_SYSTEM, EMOJI } from '@lumenflow/core/wu-constants';
+import { runCLI } from './cli-entry-point.js';
+import { MIN_AGENT_CONTENT_LENGTH } from './constants.js';
+const LOG_PREFIX = '[validate-agent-sync]';
+/**
+ * Validate agent sync state
+ *
+ * @param options - Validation options
+ * @param options.cwd - Working directory (default: process.cwd())
+ * @returns Validation result
+ */
+export async function validateAgentSync(options = {}) {
+    const { cwd = process.cwd() } = options;
+    const errors = [];
+    const warnings = [];
+    const agents = [];
+    const agentDir = path.join(cwd, '.claude', 'agents');
+    // Check if agents directory exists
+    if (!existsSync(agentDir)) {
+        errors.push(`Agents directory not found: ${agentDir}`);
+        return { valid: false, errors, warnings, agents };
+    }
+    // Read agent definitions
+    const files = readdirSync(agentDir).filter((f) => f.endsWith('.json') || f.endsWith('.md'));
+    if (files.length === 0) {
+        warnings.push('No agent definitions found in .claude/agents/');
+        return { valid: true, errors, warnings, agents };
+    }
+    for (const file of files) {
+        const filePath = path.join(agentDir, file);
+        const agentName = path.basename(file, path.extname(file));
+        agents.push(agentName);
+        if (file.endsWith('.json')) {
+            // Validate JSON agent definition
+            try {
+                const content = readFileSync(filePath, { encoding: FILE_SYSTEM.UTF8 });
+                const agentDef = JSON.parse(content);
+                // Check required fields
+                if (!agentDef.name) {
+                    warnings.push(`${agentName}: Missing "name" field`);
+                }
+                if (!agentDef.description) {
+                    warnings.push(`${agentName}: Missing "description" field`);
+                }
+            }
+            catch (e) {
+                errors.push(`${agentName}: Failed to parse JSON: ${e.message}`);
+            }
+        }
+        else if (file.endsWith('.md')) {
+            // Validate markdown agent definition
+            try {
+                const content = readFileSync(filePath, { encoding: FILE_SYSTEM.UTF8 });
+                // Check for title
+                if (!content.includes('# ')) {
+                    warnings.push(`${agentName}: Missing title heading`);
+                }
+                // Check for minimum content
+                if (content.length < MIN_AGENT_CONTENT_LENGTH) {
+                    warnings.push(`${agentName}: Agent definition is very short`);
+                }
+            }
+            catch (e) {
+                errors.push(`${agentName}: Failed to read file: ${e.message}`);
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        agents,
+    };
+}
+/**
+ * Main CLI entry point
+ */
+export async function main() {
+    const args = process.argv.slice(2);
+    // Parse arguments
+    let cwd = process.cwd();
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--cwd' || arg === '-C') {
+            cwd = args[++i];
+        }
+        else if (arg === '--help' || arg === '-h') {
+            console.log(`Usage: validate-agent-sync [options]
+
+Validate agent configuration and sync state.
+
+Options:
+  --cwd, -C DIR  Working directory (default: current directory)
+  -h, --help     Show this help message
+
+Examples:
+  validate-agent-sync
+  validate-agent-sync --cwd /path/to/project
+`);
+            process.exit(0);
+        }
+    }
+    console.log(`${LOG_PREFIX} Validating agent sync...`);
+    const result = await validateAgentSync({ cwd });
+    if (result.errors.length > 0) {
+        console.log(`${EMOJI.FAILURE} Validation errors:`);
+        result.errors.forEach((e) => console.log(`  ${e}`));
+    }
+    if (result.warnings.length > 0) {
+        console.log(`${EMOJI.WARNING} Warnings:`);
+        result.warnings.forEach((w) => console.log(`  ${w}`));
+    }
+    if (result.agents.length > 0) {
+        console.log(`${LOG_PREFIX} Found ${result.agents.length} agent(s):`);
+        result.agents.forEach((a) => console.log(`  - ${a}`));
+    }
+    if (result.valid) {
+        console.log(`${EMOJI.SUCCESS} Agent sync validation passed`);
+    }
+    else {
+        process.exit(1);
+    }
+}
+// WU-1181: Use import.meta.main instead of process.argv[1] comparison
+// The old pattern fails with pnpm symlinks because process.argv[1] is the symlink
+// path but import.meta.url resolves to the real path - they never match
+// WU-1537: Use import.meta.main + runCLI for consistent EPIPE and error handling
+if (import.meta.main) {
+    void runCLI(main);
+}
+//# sourceMappingURL=validate-agent-sync.js.map

package/dist/validate-agent-sync.js.map

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

package/dist/validate-backlog-sync.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file validate-backlog-sync.ts
+ * @description Validates backlog.md is in sync with WU YAML files (WU-1111)
+ *
+ * Checks that all WU YAML files are referenced in backlog.md and vice versa.
+ * This is the TypeScript replacement for tools/validate-backlog-sync.js.
+ *
+ * Usage:
+ *   validate-backlog-sync              # Validate sync
+ *
+ * Exit codes:
+ *   0 - Backlog is in sync
+ *   1 - Sync issues found
+ *
+ * @see {@link docs/04-operations/tasks/backlog.md} - Backlog file
+ */
+import { validateBacklogSync, } from '@lumenflow/core/validators/backlog-sync';
+import { EMOJI } from '@lumenflow/core/wu-constants';
+import { runCLI } from './cli-entry-point.js';
+const LOG_PREFIX = '[validate-backlog-sync]';
+export { validateBacklogSync };
+/**
+ * Main CLI entry point
+ */
+export async function main() {
+    const args = process.argv.slice(2);
+    // Parse arguments
+    let cwd = process.cwd();
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--cwd' || arg === '-C') {
+            cwd = args[++i];
+        }
+        else if (arg === '--help' || arg === '-h') {
+            console.log(`Usage: validate-backlog-sync [options]
+
+Validate that backlog.md is in sync with WU YAML files.
+
+Options:
+  --cwd, -C DIR  Working directory (default: current directory)
+  -h, --help     Show this help message
+
+Examples:
+  validate-backlog-sync
+`);
+            process.exit(0);
+        }
+    }
+    console.log(`${LOG_PREFIX} Validating backlog sync...`);
+    const result = await validateBacklogSync({ cwd });
+    if (result.errors.length > 0) {
+        console.log(`${EMOJI.FAILURE} Sync errors:`);
+        result.errors.forEach((e) => console.log(`  ${e}`));
+    }
+    if (result.warnings.length > 0) {
+        console.log(`${EMOJI.WARNING} Warnings:`);
+        result.warnings.forEach((w) => console.log(`  ${w}`));
+    }
+    console.log(`${LOG_PREFIX} WU files: ${result.wuCount}, Backlog references: ${result.backlogCount}`);
+    if (result.valid) {
+        console.log(`${EMOJI.SUCCESS} Backlog is in sync`);
+    }
+    else {
+        process.exit(1);
+    }
+}
+// WU-1181: Use import.meta.main instead of process.argv[1] comparison
+// The old pattern fails with pnpm symlinks because process.argv[1] is the symlink
+// path but import.meta.url resolves to the real path - they never match
+// WU-1537: Use import.meta.main + runCLI for consistent EPIPE and error handling
+if (import.meta.main) {
+    void runCLI(main);
+}
+//# sourceMappingURL=validate-backlog-sync.js.map

package/dist/validate-backlog-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-backlog-sync.js","sourceRoot":"","sources":["../src/validate-backlog-sync.ts"],"names":[],"mappings":";AACA,iCAAiC;AACjC,yCAAyC;AACzC;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,mBAAmB,GAEpB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAG7C,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,kBAAkB;IAClB,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACpC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;CAUjB,CAAC,CAAC;YACG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,6BAA6B,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAElD,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;QAC1C,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,CAAC,GAAG,CACT,GAAG,UAAU,cAAc,MAAM,CAAC,OAAO,yBAAyB,MAAM,CAAC,YAAY,EAAE,CACxF,CAAC;IAEF,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,kFAAkF;AAClF,wEAAwE;AACxE,iFAAiF;AACjF,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC"}

package/dist/validate-skills-spec.js

@@ -0,0 +1,211 @@
+#!/usr/bin/env node
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file validate-skills-spec.ts
+ * @description Validates skills spec format (WU-1111)
+ *
+ * Validates that skill specification files follow the required format
+ * with proper sections and structure.
+ *
+ * Usage:
+ *   validate-skills-spec SKILL.md          # Validate specific file
+ *   validate-skills-spec --dir ./skills    # Validate all in directory
+ *
+ * Exit codes:
+ *   0 - Validation passed
+ *   1 - Validation errors found
+ *
+ * @see {@link .claude/skills/} - Skill definitions
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { FILE_SYSTEM, EMOJI } from '@lumenflow/core/wu-constants';
+import { runCLI } from './cli-entry-point.js';
+const LOG_PREFIX = '[validate-skills-spec]';
+/**
+ * Required sections for a valid skill spec
+ */
+const REQUIRED_SECTIONS = ['When to Use'];
+/**
+ * Recommended sections (produce warnings if missing)
+ */
+const RECOMMENDED_SECTIONS = ['Examples'];
+/**
+ * Validate a skill specification file
+ *
+ * @param skillPath - Path to skill spec file
+ * @returns Validation result
+ */
+export function validateSkillsSpec(skillPath) {
+    const errors = [];
+    const warnings = [];
+    if (!existsSync(skillPath)) {
+        errors.push(`Skill file not found: ${skillPath}`);
+        return { valid: false, errors, warnings };
+    }
+    const content = readFileSync(skillPath, { encoding: FILE_SYSTEM.UTF8 });
+    const lines = content.split('\n');
+    // Check for title heading (# Title)
+    const hasTitle = lines.some((line) => /^#\s+\S/.test(line));
+    if (!hasTitle) {
+        errors.push('Missing title heading (# Skill Name)');
+    }
+    // Check for required sections
+    for (const section of REQUIRED_SECTIONS) {
+        // eslint-disable-next-line security/detect-non-literal-regexp -- section name from internal constant array, not user input
+        const sectionPattern = new RegExp(`^##\\s+${section}`, 'im');
+        if (!sectionPattern.test(content)) {
+            errors.push(`Missing required section: "## ${section}"`);
+        }
+    }
+    // Check for recommended sections
+    for (const section of RECOMMENDED_SECTIONS) {
+        // eslint-disable-next-line security/detect-non-literal-regexp -- section name from internal constant array, not user input
+        const sectionPattern = new RegExp(`^##\\s+${section}`, 'im');
+        if (!sectionPattern.test(content)) {
+            warnings.push(`Missing recommended section: "## ${section}"`);
+        }
+    }
+    // Check "When to Use" section has content
+    const whenToUseMatch = content.match(/##\s+When to Use\s*\n([\s\S]*?)(?=\n##|$)/i);
+    if (whenToUseMatch) {
+        const sectionContent = whenToUseMatch[1].trim();
+        if (sectionContent.length < 20) {
+            warnings.push('"When to Use" section has minimal content');
+        }
+    }
+    // Check for minimum overall content
+    if (content.length < 100) {
+        warnings.push('Skill spec is very short (< 100 characters)');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validate all skill specs in a directory
+ *
+ * @param dir - Directory to scan
+ * @returns Map of file path to validation result
+ */
+export function validateSkillsSpecDir(dir) {
+    const results = new Map();
+    if (!existsSync(dir)) {
+        results.set(dir, {
+            valid: false,
+            errors: [`Directory not found: ${dir}`],
+            warnings: [],
+        });
+        return results;
+    }
+    const entries = readdirSync(dir);
+    for (const entry of entries) {
+        const entryPath = path.join(dir, entry);
+        const stat = statSync(entryPath);
+        if (stat.isDirectory()) {
+            // Check for SKILL.md in subdirectory
+            const skillFile = path.join(entryPath, 'SKILL.md');
+            if (existsSync(skillFile)) {
+                results.set(entry, validateSkillsSpec(skillFile));
+            }
+        }
+        else if (entry.endsWith('.md')) {
+            results.set(entry, validateSkillsSpec(entryPath));
+        }
+    }
+    return results;
+}
+/**
+ * Main CLI entry point
+ */
+export async function main() {
+    const args = process.argv.slice(2);
+    // Parse arguments
+    let skillPath;
+    let dir;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--dir' || arg === '-d') {
+            dir = args[++i];
+        }
+        else if (arg === '--help' || arg === '-h') {
+            console.log(`Usage: validate-skills-spec [file.md] [options]
+
+Validate skill specification format.
+
+Options:
+  --dir, -d DIR  Validate all specs in directory
+  -h, --help     Show this help message
+
+Examples:
+  validate-skills-spec SKILL.md
+  validate-skills-spec --dir .claude/skills
+`);
+            process.exit(0);
+        }
+        else if (!skillPath) {
+            skillPath = arg;
+        }
+    }
+    if (!skillPath && !dir) {
+        console.error(`${LOG_PREFIX} Error: Provide a skill file or --dir option`);
+        process.exit(1);
+    }
+    if (skillPath) {
+        // Validate single file
+        console.log(`${LOG_PREFIX} Validating ${skillPath}...`);
+        const result = validateSkillsSpec(skillPath);
+        if (result.errors.length > 0) {
+            console.log(`${EMOJI.FAILURE} Validation failed:`);
+            result.errors.forEach((e) => console.log(`  ${e}`));
+        }
+        if (result.warnings.length > 0) {
+            console.log(`${EMOJI.WARNING} Warnings:`);
+            result.warnings.forEach((w) => console.log(`  ${w}`));
+        }
+        if (result.valid) {
+            console.log(`${EMOJI.SUCCESS} Skill spec is valid`);
+        }
+        else {
+            process.exit(1);
+        }
+    }
+    else if (dir) {
+        // Validate directory
+        console.log(`${LOG_PREFIX} Validating skills in ${dir}...`);
+        const results = validateSkillsSpecDir(dir);
+        let totalValid = 0;
+        let totalInvalid = 0;
+        for (const [name, result] of results) {
+            if (result.errors.length > 0) {
+                console.log(`${EMOJI.FAILURE} ${name}:`);
+                result.errors.forEach((e) => console.log(`    ${e}`));
+                totalInvalid++;
+            }
+            else {
+                totalValid++;
+            }
+            if (result.warnings.length > 0) {
+                console.log(`${EMOJI.WARNING} ${name}: ${result.warnings.length} warning(s)`);
+            }
+        }
+        console.log('');
+        console.log(`${LOG_PREFIX} Summary:`);
+        console.log(`  ${EMOJI.SUCCESS} Valid: ${totalValid}`);
+        console.log(`  ${EMOJI.FAILURE} Invalid: ${totalInvalid}`);
+        if (totalInvalid > 0) {
+            process.exit(1);
+        }
+    }
+}
+// WU-1181: Use import.meta.main instead of process.argv[1] comparison
+// The old pattern fails with pnpm symlinks because process.argv[1] is the symlink
+// path but import.meta.url resolves to the real path - they never match
+// WU-1537: Use import.meta.main + runCLI for consistent EPIPE and error handling
+if (import.meta.main) {
+    void runCLI(main);
+}
+//# sourceMappingURL=validate-skills-spec.js.map

package/dist/validate-skills-spec.js.map

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

package/dist/validate.js.map

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

package/dist/validator-defaults.js

@@ -0,0 +1,107 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Register preflight validators into the registry.
+ *
+ * Preflight validators run before gates to catch issues early
+ * (e.g., missing code paths, type mismatches, spec completeness).
+ *
+ * @param registry - Validator registry to populate
+ */
+export function registerPreflightValidators(registry) {
+    // WU-1805: Preflight code_paths validation before gates
+    registry.register({
+        name: 'code-path-preflight',
+        phase: 'preflight',
+        validate: () => ({ valid: true, errors: [] }),
+        blocking: true,
+    });
+    // WU-2310: Type vs code_paths preflight validation
+    registry.register({
+        name: 'type-vs-code-paths',
+        phase: 'preflight',
+        validate: () => ({ valid: true, errors: [] }),
+        blocking: true,
+    });
+    // Spec completeness validation
+    registry.register({
+        name: 'spec-completeness',
+        phase: 'preflight',
+        validate: () => ({ valid: true, errors: [] }),
+        blocking: true,
+    });
+    // WU consistency check
+    registry.register({
+        name: 'wu-consistency',
+        phase: 'preflight',
+        validate: () => ({ valid: true, errors: [] }),
+        blocking: true,
+    });
+    // WU-1503: Dirty-main pre-merge guard
+    registry.register({
+        name: 'dirty-main-guard',
+        phase: 'preflight',
+        validate: () => ({ valid: true, errors: [] }),
+        blocking: true,
+    });
+    // Preflight tasks validation
+    registry.register({
+        name: 'preflight-tasks',
+        phase: 'preflight',
+        validate: () => ({ valid: true, errors: [] }),
+        blocking: true,
+    });
+}
+/**
+ * Register completion validators into the registry.
+ *
+ * Completion validators run after gates pass, before the final
+ * merge/stamp/cleanup sequence.
+ *
+ * @param registry - Validator registry to populate
+ */
+export function registerCompletionValidators(registry) {
+    // Code paths existence validation
+    registry.register({
+        name: 'code-paths-exist',
+        phase: 'completion',
+        validate: () => ({ valid: true, errors: [] }),
+        blocking: true,
+    });
+    // WU-1542: Mandatory agents compliance
+    registry.register({
+        name: 'mandatory-agents-compliance',
+        phase: 'completion',
+        validate: () => ({ valid: true, errors: [] }),
+        blocking: true,
+    });
+    // WU-1012: Docs-only flag validation
+    registry.register({
+        name: 'docs-only-flag',
+        phase: 'completion',
+        validate: () => ({ valid: true, errors: [] }),
+        blocking: true,
+    });
+    // WU-1999: Exposure validation (non-blocking warnings)
+    registry.register({
+        name: 'exposure-warnings',
+        phase: 'completion',
+        validate: () => ({ valid: true, warnings: [] }),
+        blocking: false,
+    });
+    // WU-2022: Feature accessibility validation
+    registry.register({
+        name: 'feature-accessibility',
+        phase: 'completion',
+        validate: () => ({ valid: true, errors: [] }),
+        blocking: true,
+    });
+    // Backlog sync validation
+    registry.register({
+        name: 'backlog-sync',
+        phase: 'completion',
+        validate: () => ({ valid: true, errors: [] }),
+        blocking: true,
+    });
+}
+//# sourceMappingURL=validator-defaults.js.map

package/dist/validator-defaults.js.map

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

package/dist/validator-registry.js

@@ -0,0 +1,71 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Registry for wu-done validators.
+ *
+ * Validators are registered with a phase (preflight or completion) and
+ * executed in insertion order within each phase.
+ */
+export class ValidatorRegistry {
+    validators = [];
+    nameIndex = new Map();
+    /**
+     * Register a single validator definition.
+     *
+     * @param validator - Validator definition to register
+     * @throws Error if a validator with the same name is already registered
+     */
+    register(validator) {
+        if (this.nameIndex.has(validator.name)) {
+            throw new Error(`Validator "${validator.name}" is already registered`);
+        }
+        this.nameIndex.set(validator.name, this.validators.length);
+        this.validators.push(validator);
+    }
+    /**
+     * Get validators for a specific phase, in insertion order.
+     *
+     * @param phase - Phase to filter by
+     * @returns Copy of the validators for the given phase
+     */
+    getByPhase(phase) {
+        return this.validators.filter((v) => v.phase === phase).map((v) => ({ ...v }));
+    }
+    /**
+     * Get all registered validators across all phases.
+     *
+     * @returns Copy of all validators
+     */
+    getAll() {
+        return [...this.validators];
+    }
+    /**
+     * Check if a validator with the given name is registered.
+     *
+     * @param name - Validator name to check
+     * @returns true if the validator exists
+     */
+    has(name) {
+        return this.nameIndex.has(name);
+    }
+    /**
+     * Get all phases that have at least one registered validator.
+     *
+     * @returns Array of phase names
+     */
+    getPhases() {
+        const phases = new Set();
+        for (const v of this.validators) {
+            phases.add(v.phase);
+        }
+        return [...phases];
+    }
+    /**
+     * Remove all registered validators.
+     */
+    clear() {
+        this.validators.length = 0;
+        this.nameIndex.clear();
+    }
+}
+//# sourceMappingURL=validator-registry.js.map

package/dist/validator-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator-registry.js","sourceRoot":"","sources":["../src/validator-registry.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAwCzC;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACX,UAAU,GAA0B,EAAE,CAAC;IACvC,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEvD;;;;;OAKG;IACH,QAAQ,CAAC,SAA8B;QACrC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,cAAc,SAAS,CAAC,IAAI,yBAAyB,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC3D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,KAAqB;QAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACjF,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}