cc-agentic-framework 1.14.1

package/dist/commands/backlog/validate-enhanced.js

@@ -0,0 +1,282 @@
+/**
+ * Enhanced Backlog Validate Command
+ *
+ * CLI command for validating backlog ticket files using the new validation framework.
+ * Uses schema-validator and ticket-rules for comprehensive validation.
+ *
+ * Usage:
+ *   agentic-framework backlog validate [path] [options]
+ *
+ * @module commands/backlog/validate-enhanced
+ */
+import { Command } from 'commander';
+import path from 'path';
+import fs from 'fs-extra';
+import chalk from 'chalk';
+import { glob } from 'glob';
+import { parseFrontmatter } from '../../lib/common/yaml-frontmatter.js';
+import { validateWithSchema } from '../../lib/validation/schema-validator.js';
+import { validateTicketRules, validateTicketReferences } from '../../lib/validation/rules/ticket-rules.js';
+import { createReport, formatReport, mergeReports, } from '../../lib/validation/validation-report.js';
+import { fileURLToPath } from 'url';
+import { CliContext } from '../../lib/cli-context.js';
+import { recordCLICommand } from '../../lib/telemetry/instrumentation/cli-instrumentation.js';
+// Use different variable names to avoid conflict with CommonJS globals in Jest
+const currentFilePath = fileURLToPath(import.meta.url);
+const currentDirPath = path.dirname(currentFilePath);
+/**
+ * Create the enhanced validate command.
+ *
+ * @returns Commander command instance
+ */
+export function createValidateEnhancedCommand() {
+    const command = new Command('validate');
+    command
+        .description('Validate backlog ticket files (enhanced validation)')
+        .argument('[path]', 'Path to backlog directory', './backlog')
+        .option('-v, --verbose', 'Show detailed progress and logging', false)
+        .option('--schema-only', 'Only run JSON Schema validation', false)
+        .option('--rules-only', 'Only run business rules validation', false)
+        .action(async (backlogPath, cmdOptions) => {
+        try {
+            await runValidateEnhancedCommand(backlogPath, cmdOptions);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(chalk.red(`\nError: ${errorMessage}\n`));
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/**
+ * Run the enhanced validate command.
+ *
+ * @param backlogPath - Path to backlog directory
+ * @param cmdOptions - Command options
+ */
+async function runValidateEnhancedCommand(backlogPath, cmdOptions) {
+    const startTime = Date.now();
+    const { verbose, schemaOnly, rulesOnly } = cmdOptions;
+    // Get CLI context for project detection
+    const ctx = await CliContext.require();
+    // Resolve backlog path:
+    // - If explicit path provided (not default), use it as override
+    // - Otherwise, use CliContext path resolution
+    const isDefaultPath = backlogPath === './backlog';
+    const resolvedPath = isDefaultPath
+        ? ctx.paths.resolve('backlog') || path.join(ctx.projectRoot, 'ai/backlog')
+        : path.resolve(backlogPath);
+    // Check if backlog directory exists
+    if (!(await fs.pathExists(resolvedPath))) {
+        throw new Error(`Backlog directory not found: ${resolvedPath}`);
+    }
+    // Print header
+    console.log('');
+    console.log(chalk.bold('='.repeat(80)));
+    console.log(chalk.bold('Enhanced Backlog Validation'));
+    console.log(chalk.bold('='.repeat(80)));
+    console.log('');
+    console.log(chalk.dim('Configuration:'));
+    console.log(chalk.dim(`  Project Root:  ${ctx.projectRoot}`));
+    console.log(chalk.dim(`  Backlog Path:  ${resolvedPath}`));
+    console.log(chalk.dim(`  Verbose:       ${verbose ? 'YES' : 'NO'}`));
+    console.log(chalk.dim(`  Schema Only:   ${schemaOnly ? 'YES' : 'NO'}`));
+    console.log(chalk.dim(`  Rules Only:    ${rulesOnly ? 'YES' : 'NO'}`));
+    console.log('');
+    // Get schema path
+    const schemaPath = resolveSchemaPath();
+    if (verbose) {
+        console.log(chalk.dim(`  Schema Path:   ${schemaPath}`));
+        console.log('');
+    }
+    // Find all ticket files
+    console.log(chalk.cyan('Finding ticket files...'));
+    const ticketFiles = await findTicketFiles(resolvedPath);
+    console.log(chalk.green(`✓ Found ${ticketFiles.length} ticket file(s)`));
+    console.log('');
+    if (ticketFiles.length === 0) {
+        console.log(chalk.yellow('⚠ No ticket files found'));
+        return;
+    }
+    // Validate each ticket
+    console.log(chalk.cyan('Validating tickets...'));
+    console.log('');
+    const reports = [];
+    for (const filePath of ticketFiles) {
+        const relPath = path.relative(resolvedPath, filePath);
+        if (verbose) {
+            console.log(chalk.dim(`  Validating: ${relPath}`));
+        }
+        const report = await validateTicketFile(filePath, schemaPath, {
+            schemaOnly,
+            rulesOnly,
+            verbose,
+        });
+        reports.push(report);
+        // Print issues immediately if verbose
+        if (verbose && report.issues.length > 0) {
+            console.log(chalk.yellow(`    Issues found:`));
+            report.issues.forEach(issue => {
+                const severity = issue.severity === 'error' ? chalk.red('ERROR') :
+                    issue.severity === 'warning' ? chalk.yellow('WARN') :
+                        chalk.blue('INFO');
+                console.log(`      ${severity}: ${issue.message}`);
+            });
+        }
+    }
+    // Merge all reports
+    const finalReport = mergeReports(...reports);
+    // Print final report
+    console.log('');
+    console.log(chalk.bold('='.repeat(80)));
+    console.log(chalk.bold('Validation Summary'));
+    console.log(chalk.bold('='.repeat(80)));
+    console.log('');
+    const durationMs = Date.now() - startTime;
+    recordCLICommand('backlog', 'validate-enhanced', { schema_only: schemaOnly, rules_only: rulesOnly, verbose }, { valid: finalReport.valid, errors: finalReport.summary.errors }, durationMs, finalReport.valid).catch(() => { });
+    if (finalReport.valid) {
+        console.log(chalk.green('✓ All tickets are valid!'));
+        console.log('');
+        console.log(chalk.dim(`  Files validated: ${ticketFiles.length}`));
+        console.log(chalk.dim(`  Errors:          0`));
+        console.log(chalk.dim(`  Warnings:        ${finalReport.summary.warnings}`));
+        console.log(chalk.dim(`  Info:            ${finalReport.summary.info}`));
+        console.log('');
+    }
+    else {
+        console.log(chalk.red('✗ Validation failed'));
+        console.log('');
+        console.log(chalk.dim(`  Files validated: ${ticketFiles.length}`));
+        console.log(chalk.red(`  Errors:          ${finalReport.summary.errors}`));
+        console.log(chalk.yellow(`  Warnings:        ${finalReport.summary.warnings}`));
+        console.log(chalk.blue(`  Info:            ${finalReport.summary.info}`));
+        console.log('');
+        // Print detailed issues
+        if (!verbose) {
+            console.log(formatReport(finalReport));
+            console.log('');
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Validate a single ticket file
+ *
+ * @param filePath - Path to ticket file
+ * @param schemaPath - Path to JSON Schema
+ * @param options - Validation options
+ * @returns Validation report
+ */
+async function validateTicketFile(filePath, schemaPath, options) {
+    try {
+        // Read file
+        const content = await fs.readFile(filePath, 'utf-8');
+        // Check for frontmatter
+        if (!content.startsWith('---')) {
+            return createReport([
+                {
+                    severity: 'error',
+                    code: 'NO_FRONTMATTER',
+                    message: 'File does not start with YAML frontmatter (---)',
+                    location: { file: filePath },
+                    suggestion: 'Add YAML frontmatter at the beginning of the file',
+                },
+            ]);
+        }
+        // Parse frontmatter
+        let data;
+        try {
+            const parsed = parseFrontmatter(content);
+            data = parsed.data;
+        }
+        catch (error) {
+            return createReport([
+                {
+                    severity: 'error',
+                    code: 'FRONTMATTER_PARSE_ERROR',
+                    message: `Failed to parse YAML frontmatter: ${error instanceof Error ? error.message : String(error)}`,
+                    location: { file: filePath },
+                    suggestion: 'Check YAML syntax in frontmatter',
+                },
+            ]);
+        }
+        const allReports = [];
+        // Run schema validation
+        if (!options.rulesOnly) {
+            const schemaReport = await validateWithSchema(data, schemaPath);
+            // Add file location to all issues
+            schemaReport.issues = schemaReport.issues.map(issue => ({
+                ...issue,
+                location: issue.location || { file: filePath },
+            }));
+            allReports.push(schemaReport);
+        }
+        // Run business rules validation
+        if (!options.schemaOnly) {
+            const rulesIssues = validateTicketRules(data, content, filePath);
+            const referencesIssues = validateTicketReferences(data, content, filePath);
+            const rulesReport = createReport([...rulesIssues, ...referencesIssues]);
+            allReports.push(rulesReport);
+        }
+        // Merge reports
+        return mergeReports(...allReports);
+    }
+    catch (error) {
+        return createReport([
+            {
+                severity: 'error',
+                code: 'FILE_READ_ERROR',
+                message: `Failed to read or validate file: ${error instanceof Error ? error.message : String(error)}`,
+                location: { file: filePath },
+            },
+        ]);
+    }
+}
+/**
+ * Find all ticket files in backlog directory
+ *
+ * @param backlogDir - Path to backlog directory
+ * @returns Array of absolute file paths
+ */
+async function findTicketFiles(backlogDir) {
+    const patterns = [
+        path.join(backlogDir, 'tickets', '**', '*.md'),
+        path.join(backlogDir, 'epics', '*.md'),
+        path.join(backlogDir, '_workflow', '**', '*.md'),
+    ];
+    const allFiles = [];
+    for (const pattern of patterns) {
+        const files = await glob(pattern, { absolute: true });
+        allFiles.push(...files);
+    }
+    // Filter out README files
+    return allFiles.filter(f => !f.endsWith('README.md'));
+}
+/**
+ * Resolve the path to the ticket schema
+ *
+ * @returns Absolute path to ticket.schema.json
+ */
+function resolveSchemaPath() {
+    // Try to find the schema file relative to this file
+    // CLI structure: framework/cli/src/commands/backlog/validate-enhanced.ts
+    // Schema location: framework/modules/backlog/schemas/ticket.schema.json
+    const possiblePaths = [
+        // From built CLI (framework/cli/dist/commands/backlog)
+        path.resolve(currentDirPath, '../../../../modules/backlog/schemas/ticket.schema.json'),
+        // From source CLI (framework/cli/src/commands/backlog)
+        path.resolve(currentDirPath, '../../../../modules/backlog/schemas/ticket.schema.json'),
+        // Relative to cwd
+        path.resolve(process.cwd(), 'framework/modules/backlog/schemas/ticket.schema.json'),
+        // If running from within framework directory
+        path.resolve(process.cwd(), 'modules/backlog/schemas/ticket.schema.json'),
+    ];
+    for (const p of possiblePaths) {
+        if (fs.existsSync(p)) {
+            return p;
+        }
+    }
+    throw new Error('Could not locate ticket.schema.json. Please ensure the backlog module is installed.');
+}
+//# sourceMappingURL=validate-enhanced.js.map

package/dist/commands/backlog/validate-enhanced.js.map

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

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

@@ -0,0 +1,19 @@
+/**
+ * Backlog Validate Command
+ *
+ * CLI command for validating backlog ticket files.
+ * Uses enhanced validation framework with schema-validator and ticket-rules.
+ *
+ * Usage:
+ *   agentic-framework backlog validate [path] [options]
+ *
+ * @module commands/backlog/validate
+ */
+import { Command } from 'commander';
+/**
+ * Create the validate command.
+ *
+ * @returns Commander command instance
+ */
+export declare function createValidateCommand(): Command;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkCpC;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAoB/C"}

package/dist/commands/backlog/validate.js

@@ -0,0 +1,283 @@
+/**
+ * Backlog Validate Command
+ *
+ * CLI command for validating backlog ticket files.
+ * Uses enhanced validation framework with schema-validator and ticket-rules.
+ *
+ * Usage:
+ *   agentic-framework backlog validate [path] [options]
+ *
+ * @module commands/backlog/validate
+ */
+import { Command } from 'commander';
+import path from 'path';
+import fs from 'fs-extra';
+import chalk from 'chalk';
+import { glob } from 'glob';
+import { parseFrontmatter } from '../../lib/common/yaml-frontmatter.js';
+import { validateWithSchema } from '../../lib/validation/schema-validator.js';
+import { validateTicketRules, validateTicketReferences } from '../../lib/validation/rules/ticket-rules.js';
+import { createReport, formatReport, mergeReports, } from '../../lib/validation/validation-report.js';
+import { fileURLToPath } from 'url';
+import { CliContext } from '../../lib/cli-context.js';
+import { recordCLICommand } from '../../lib/telemetry/instrumentation/cli-instrumentation.js';
+// Use different variable names to avoid conflict with CommonJS globals in Jest
+const currentFilePath = fileURLToPath(import.meta.url);
+const currentDirPath = path.dirname(currentFilePath);
+/**
+ * Create the validate command.
+ *
+ * @returns Commander command instance
+ */
+export function createValidateCommand() {
+    const command = new Command('validate');
+    command
+        .description('Validate backlog ticket files')
+        .argument('[path]', 'Path to backlog directory', './backlog')
+        .option('-v, --verbose', 'Show detailed progress and logging', false)
+        .option('--schema-only', 'Only run JSON Schema validation', false)
+        .option('--rules-only', 'Only run business rules validation', false)
+        .action(async (backlogPath, cmdOptions) => {
+        try {
+            await runValidateCommand(backlogPath, cmdOptions);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(chalk.red(`\nError: ${errorMessage}\n`));
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/**
+ * Run the validate command.
+ *
+ * @param backlogPath - Path to backlog directory
+ * @param cmdOptions - Command options
+ */
+async function runValidateCommand(backlogPath, cmdOptions) {
+    const startTime = Date.now();
+    const { verbose, schemaOnly, rulesOnly } = cmdOptions;
+    // Get CLI context for project detection
+    const ctx = await CliContext.require();
+    // Resolve backlog path:
+    // - If explicit path provided (not default), use it as override
+    // - Otherwise, try routes.yml resolution first, then fall back to ./backlog
+    //   (matching create-ticket behavior for consistency)
+    const isDefaultPath = backlogPath === './backlog';
+    const resolvedPath = isDefaultPath
+        ? ctx.paths.resolve('backlog') || path.join(ctx.projectRoot, 'backlog')
+        : path.resolve(backlogPath);
+    // Check if backlog directory exists
+    if (!(await fs.pathExists(resolvedPath))) {
+        throw new Error(`Backlog directory not found: ${resolvedPath}`);
+    }
+    // Print header
+    console.log('');
+    console.log(chalk.bold('='.repeat(80)));
+    console.log(chalk.bold('Backlog Validation'));
+    console.log(chalk.bold('='.repeat(80)));
+    console.log('');
+    console.log(chalk.dim('Configuration:'));
+    console.log(chalk.dim(`  Project Root:  ${ctx.projectRoot}`));
+    console.log(chalk.dim(`  Backlog Path:  ${resolvedPath}`));
+    console.log(chalk.dim(`  Verbose:       ${verbose ? 'YES' : 'NO'}`));
+    console.log(chalk.dim(`  Schema Only:   ${schemaOnly ? 'YES' : 'NO'}`));
+    console.log(chalk.dim(`  Rules Only:    ${rulesOnly ? 'YES' : 'NO'}`));
+    console.log('');
+    // Get schema path
+    const schemaPath = resolveSchemaPath();
+    if (verbose) {
+        console.log(chalk.dim(`  Schema Path:   ${schemaPath}`));
+        console.log('');
+    }
+    // Find all ticket files
+    console.log(chalk.cyan('Finding ticket files...'));
+    const ticketFiles = await findTicketFiles(resolvedPath);
+    console.log(chalk.green(`✓ Found ${ticketFiles.length} ticket file(s)`));
+    console.log('');
+    if (ticketFiles.length === 0) {
+        console.log(chalk.yellow('⚠ No ticket files found'));
+        return;
+    }
+    // Validate each ticket
+    console.log(chalk.cyan('Validating tickets...'));
+    console.log('');
+    const reports = [];
+    for (const filePath of ticketFiles) {
+        const relPath = path.relative(resolvedPath, filePath);
+        if (verbose) {
+            console.log(chalk.dim(`  Validating: ${relPath}`));
+        }
+        const report = await validateTicketFile(filePath, schemaPath, {
+            schemaOnly,
+            rulesOnly,
+            verbose,
+        });
+        reports.push(report);
+        // Print issues immediately if verbose
+        if (verbose && report.issues.length > 0) {
+            console.log(chalk.yellow(`    Issues found:`));
+            report.issues.forEach(issue => {
+                const severity = issue.severity === 'error' ? chalk.red('ERROR') :
+                    issue.severity === 'warning' ? chalk.yellow('WARN') :
+                        chalk.blue('INFO');
+                console.log(`      ${severity}: ${issue.message}`);
+            });
+        }
+    }
+    // Merge all reports
+    const finalReport = mergeReports(...reports);
+    // Print final report
+    console.log('');
+    console.log(chalk.bold('='.repeat(80)));
+    console.log(chalk.bold('Validation Summary'));
+    console.log(chalk.bold('='.repeat(80)));
+    console.log('');
+    const durationMs = Date.now() - startTime;
+    recordCLICommand('backlog', 'validate', { schema_only: schemaOnly, rules_only: rulesOnly, verbose }, { valid: finalReport.valid, errors: finalReport.summary.errors }, durationMs, finalReport.valid).catch(() => { });
+    if (finalReport.valid) {
+        console.log(chalk.green('✓ All tickets are valid!'));
+        console.log('');
+        console.log(chalk.dim(`  Files validated: ${ticketFiles.length}`));
+        console.log(chalk.dim(`  Errors:          0`));
+        console.log(chalk.dim(`  Warnings:        ${finalReport.summary.warnings}`));
+        console.log(chalk.dim(`  Info:            ${finalReport.summary.info}`));
+        console.log('');
+    }
+    else {
+        console.log(chalk.red('✗ Validation failed'));
+        console.log('');
+        console.log(chalk.dim(`  Files validated: ${ticketFiles.length}`));
+        console.log(chalk.red(`  Errors:          ${finalReport.summary.errors}`));
+        console.log(chalk.yellow(`  Warnings:        ${finalReport.summary.warnings}`));
+        console.log(chalk.blue(`  Info:            ${finalReport.summary.info}`));
+        console.log('');
+        // Print detailed issues
+        if (!verbose) {
+            console.log(formatReport(finalReport));
+            console.log('');
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Validate a single ticket file
+ *
+ * @param filePath - Path to ticket file
+ * @param schemaPath - Path to JSON Schema
+ * @param options - Validation options
+ * @returns Validation report
+ */
+async function validateTicketFile(filePath, schemaPath, options) {
+    try {
+        // Read file
+        const content = await fs.readFile(filePath, 'utf-8');
+        // Check for frontmatter
+        if (!content.startsWith('---')) {
+            return createReport([
+                {
+                    severity: 'error',
+                    code: 'NO_FRONTMATTER',
+                    message: 'File does not start with YAML frontmatter (---)',
+                    location: { file: filePath },
+                    suggestion: 'Add YAML frontmatter at the beginning of the file',
+                },
+            ]);
+        }
+        // Parse frontmatter
+        let data;
+        try {
+            const parsed = parseFrontmatter(content);
+            data = parsed.data;
+        }
+        catch (error) {
+            return createReport([
+                {
+                    severity: 'error',
+                    code: 'FRONTMATTER_PARSE_ERROR',
+                    message: `Failed to parse YAML frontmatter: ${error instanceof Error ? error.message : String(error)}`,
+                    location: { file: filePath },
+                    suggestion: 'Check YAML syntax in frontmatter',
+                },
+            ]);
+        }
+        const allReports = [];
+        // Run schema validation
+        if (!options.rulesOnly) {
+            const schemaReport = await validateWithSchema(data, schemaPath);
+            // Add file location to all issues
+            schemaReport.issues = schemaReport.issues.map(issue => ({
+                ...issue,
+                location: issue.location || { file: filePath },
+            }));
+            allReports.push(schemaReport);
+        }
+        // Run business rules validation
+        if (!options.schemaOnly) {
+            const rulesIssues = validateTicketRules(data, content, filePath);
+            const referencesIssues = validateTicketReferences(data, content, filePath);
+            const rulesReport = createReport([...rulesIssues, ...referencesIssues]);
+            allReports.push(rulesReport);
+        }
+        // Merge reports
+        return mergeReports(...allReports);
+    }
+    catch (error) {
+        return createReport([
+            {
+                severity: 'error',
+                code: 'FILE_READ_ERROR',
+                message: `Failed to read or validate file: ${error instanceof Error ? error.message : String(error)}`,
+                location: { file: filePath },
+            },
+        ]);
+    }
+}
+/**
+ * Find all ticket files in backlog directory
+ *
+ * @param backlogDir - Path to backlog directory
+ * @returns Array of absolute file paths
+ */
+async function findTicketFiles(backlogDir) {
+    const patterns = [
+        path.join(backlogDir, 'tickets', '**', '*.md'),
+        path.join(backlogDir, 'epics', '*.md'),
+        path.join(backlogDir, '_workflow', '**', '*.md'),
+    ];
+    const allFiles = [];
+    for (const pattern of patterns) {
+        const files = await glob(pattern, { absolute: true });
+        allFiles.push(...files);
+    }
+    // Filter out README files
+    return allFiles.filter(f => !f.endsWith('README.md'));
+}
+/**
+ * Resolve the path to the ticket schema
+ *
+ * @returns Absolute path to ticket.schema.json
+ */
+function resolveSchemaPath() {
+    // Try to find the schema file relative to this file
+    // CLI structure: framework/cli/src/commands/backlog/validate.ts
+    // Schema location: framework/modules/backlog/schemas/ticket.schema.json
+    const possiblePaths = [
+        // From built CLI (framework/cli/dist/commands/backlog)
+        path.resolve(currentDirPath, '../../../../modules/backlog/schemas/ticket.schema.json'),
+        // From source CLI (framework/cli/src/commands/backlog)
+        path.resolve(currentDirPath, '../../../../modules/backlog/schemas/ticket.schema.json'),
+        // Relative to cwd
+        path.resolve(process.cwd(), 'framework/modules/backlog/schemas/ticket.schema.json'),
+        // If running from within framework directory
+        path.resolve(process.cwd(), 'modules/backlog/schemas/ticket.schema.json'),
+    ];
+    for (const p of possiblePaths) {
+        if (fs.existsSync(p)) {
+            return p;
+        }
+    }
+    throw new Error('Could not locate ticket.schema.json. Please ensure the backlog module is installed.');
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/backlog/validate.js.map

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

package/dist/commands/build.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Build Command
+ *
+ * Unified validation command that provides compile-time-like checking for
+ * framework markdown files with YAML frontmatter.
+ *
+ * Consolidates:
+ * - Schema validation (agents, skills)
+ * - Link validation (internal, external)
+ * - Cross-reference validation (capabilities, delegates-to)
+ * - IDE schema generation
+ *
+ * @module commands/build
+ */
+import { Command } from 'commander';
+/**
+ * Create the build command
+ */
+export declare function createBuildCommand(): Command;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAY5C"}