cc-agentic-framework 1.14.1

package/dist/commands/backlog/migrate-milestones.js

@@ -0,0 +1,155 @@
+/**
+ * Backlog Migrate Milestones Command
+ *
+ * CLI command for migrating milestone files from old naming convention
+ * to new Jira-based sanitized naming.
+ *
+ * Migrates: Jan2026.md → apm-r-app-january-2026-w51-w1-w3.md
+ *
+ * Usage:
+ *   agentic-framework backlog:migrate-milestones [path] [options]
+ *
+ * @module commands/backlog/migrate-milestones
+ */
+import { Command } from "commander";
+import path from "path";
+import fs from "fs-extra";
+import { getMigrationPlan, applyMigration, validateMilestoneArchitecture, printMigrationPlan, printValidationResults, } from "../../lib/backlog/milestone-migrator.js";
+import { recordCLICommand } from "../../lib/telemetry/instrumentation/cli-instrumentation.js";
+/**
+ * Create the migrate-milestones command.
+ *
+ * @returns Commander command instance
+ */
+export function createMigrateMilestonesCommand() {
+    const command = new Command("migrate-milestones");
+    command
+        .description("Migrate milestone files to Jira-based sanitized naming")
+        .argument("[path]", "Path to backlog directory", "./backlog")
+        .option("--dry-run", "Preview changes without applying them", false)
+        .option("--validate", "Validate milestone architecture after migration", false)
+        .option("-v, --verbose", "Show detailed progress and logging", false)
+        .action(async (backlogPath, cmdOptions) => {
+        try {
+            await runMigrateCommand(backlogPath, cmdOptions);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`\nError: ${errorMessage}\n`);
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/**
+ * Run the migrate command.
+ *
+ * @param backlogPath - Path to backlog directory
+ * @param cmdOptions - Command options
+ */
+async function runMigrateCommand(backlogPath, cmdOptions) {
+    const startTime = Date.now();
+    const { dryRun, validate, verbose } = cmdOptions;
+    // Resolve backlog path
+    const backlogDir = path.resolve(backlogPath);
+    // Validate backlog directory exists
+    if (!(await fs.pathExists(backlogDir))) {
+        throw new Error(`Backlog directory not found: ${backlogDir}`);
+    }
+    const milestonesDir = path.join(backlogDir, "milestones");
+    if (!(await fs.pathExists(milestonesDir))) {
+        throw new Error(`Milestones directory not found: ${milestonesDir}`);
+    }
+    // Print header
+    console.log("");
+    console.log("=".repeat(80));
+    console.log("Milestone Migration");
+    console.log("=".repeat(80));
+    console.log("");
+    console.log("Configuration:");
+    console.log(`  Backlog Path:   ${backlogDir}`);
+    console.log(`  Milestones Dir: ${milestonesDir}`);
+    console.log(`  Dry Run:        ${dryRun ? "YES" : "NO"}`);
+    console.log(`  Validate:       ${validate ? "YES" : "NO"}`);
+    console.log(`  Verbose:        ${verbose ? "YES" : "NO"}`);
+    console.log("");
+    // Build migration plan
+    if (verbose) {
+        console.log("Scanning milestones directory...");
+    }
+    const plan = await getMigrationPlan(milestonesDir);
+    // Print migration plan
+    printMigrationPlan(plan);
+    // Check if there's anything to migrate
+    const planEntries = Object.entries(plan);
+    if (planEntries.length === 0) {
+        console.log("✓ No migration needed");
+        console.log("");
+        const durationMs = Date.now() - startTime;
+        recordCLICommand("backlog", "migrate-milestones", { dry_run: dryRun, validate }, { migrated: 0 }, durationMs, true).catch(() => { });
+        // Run validation if requested
+        if (validate) {
+            console.log("Running validation...");
+            console.log("");
+            const validationResult = await validateMilestoneArchitecture(backlogDir, verbose);
+            printValidationResults(validationResult);
+            if (!validationResult.valid) {
+                process.exit(1);
+            }
+        }
+        return;
+    }
+    // Apply migration
+    console.log(dryRun ? "[DRY RUN] Previewing changes..." : "Applying migration...");
+    console.log("");
+    const tracker = await applyMigration(backlogDir, plan, dryRun);
+    // Print results
+    let migratedCount;
+    if (dryRun) {
+        console.log("[DRY RUN] No changes applied");
+        console.log("");
+        console.log(`Would migrate ${planEntries.length} milestone(s):`);
+        planEntries.forEach(([oldName, entry]) => {
+            console.log(`  ${oldName} → ${entry.newFilename}`);
+        });
+        console.log("");
+        console.log("Run without --dry-run to apply these changes");
+        migratedCount = planEntries.length;
+    }
+    else {
+        migratedCount = Object.keys(tracker.changes.milestoneRenames).length;
+        if (migratedCount > 0) {
+            // Save tracker for rollback capability
+            await tracker.save();
+            console.log(`✓ Successfully migrated ${migratedCount} milestone(s)`);
+            console.log("");
+            console.log("Migrated files:");
+            Object.entries(tracker.changes.milestoneRenames).forEach(([oldName, newName]) => {
+                console.log(`  ✓ ${oldName} → ${newName}`);
+            });
+            console.log("");
+            console.log(`Migration tracker saved to: ${path.join(backlogDir, ".migration-tracker.json")}`);
+        }
+        else {
+            console.log("⚠ No milestones were migrated");
+            console.log("");
+        }
+    }
+    const durationMs = Date.now() - startTime;
+    recordCLICommand("backlog", "migrate-milestones", { dry_run: dryRun, validate }, { migrated: migratedCount }, durationMs, true).catch(() => { });
+    // Run validation if requested
+    if (validate && !dryRun) {
+        console.log("");
+        console.log("Running validation...");
+        console.log("");
+        const validationResult = await validateMilestoneArchitecture(backlogDir, verbose);
+        printValidationResults(validationResult);
+        if (!validationResult.valid) {
+            console.log("");
+            console.log("⚠ Validation found issues. Please review and fix.");
+            process.exit(1);
+        }
+    }
+    console.log("");
+}
+//# sourceMappingURL=migrate-milestones.js.map

package/dist/commands/backlog/migrate-milestones.js.map

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

package/dist/commands/backlog/update-fields.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Backlog Update Fields Command
+ *
+ * CLI command for bulk updating frontmatter fields in markdown files.
+ * Supports removing, adding, and updating fields with dry-run mode.
+ *
+ * Usage:
+ *   agentic-framework backlog update-fields [options]
+ *
+ * Examples:
+ *   # Remove milestone field from all tickets (dry run)
+ *   agentic-framework backlog update-fields --remove milestone --pattern "backlog/tickets/**\/*.md" --dry-run
+ *
+ *   # Remove milestone field and apply changes
+ *   agentic-framework backlog update-fields --remove milestone --pattern "backlog/tickets/**\/*.md"
+ *
+ *   # Add status field to all tickets
+ *   agentic-framework backlog update-fields --add status=active --pattern "backlog/tickets/**\/*.md"
+ *
+ *   # Multiple operations
+ *   agentic-framework backlog update-fields \
+ *     --remove milestone \
+ *     --add status=active \
+ *     --update version=2.0 \
+ *     --pattern "backlog/**\/*.md"
+ *
+ * @module commands/backlog/update-fields
+ */
+import { Command } from 'commander';
+/**
+ * Create the update-fields command.
+ *
+ * @returns Commander command instance
+ */
+export declare function createUpdateFieldsCommand(): Command;
+//# sourceMappingURL=update-fields.d.ts.map

package/dist/commands/backlog/update-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-fields.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/update-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAuBnD"}

package/dist/commands/backlog/update-fields.js

@@ -0,0 +1,251 @@
+/**
+ * Backlog Update Fields Command
+ *
+ * CLI command for bulk updating frontmatter fields in markdown files.
+ * Supports removing, adding, and updating fields with dry-run mode.
+ *
+ * Usage:
+ *   agentic-framework backlog update-fields [options]
+ *
+ * Examples:
+ *   # Remove milestone field from all tickets (dry run)
+ *   agentic-framework backlog update-fields --remove milestone --pattern "backlog/tickets/**\/*.md" --dry-run
+ *
+ *   # Remove milestone field and apply changes
+ *   agentic-framework backlog update-fields --remove milestone --pattern "backlog/tickets/**\/*.md"
+ *
+ *   # Add status field to all tickets
+ *   agentic-framework backlog update-fields --add status=active --pattern "backlog/tickets/**\/*.md"
+ *
+ *   # Multiple operations
+ *   agentic-framework backlog update-fields \
+ *     --remove milestone \
+ *     --add status=active \
+ *     --update version=2.0 \
+ *     --pattern "backlog/**\/*.md"
+ *
+ * @module commands/backlog/update-fields
+ */
+import { Command } from 'commander';
+import path from 'path';
+import fs from 'fs-extra';
+import { bulkUpdateFiles, findFiles, } from '../../lib/backlog/field-updater.js';
+import { recordCLICommand } from '../../lib/telemetry/instrumentation/cli-instrumentation.js';
+/**
+ * Create the update-fields command.
+ *
+ * @returns Commander command instance
+ */
+export function createUpdateFieldsCommand() {
+    const command = new Command('update-fields');
+    command
+        .description('Bulk update frontmatter fields in markdown files')
+        .option('-r, --remove <fields>', 'Comma-separated list of fields to remove', parseCommaSeparated)
+        .option('-a, --add <field=value>', 'Add field with value (format: field=value)', collect, [])
+        .option('-u, --update <field=value>', 'Update field with value (format: field=value)', collect, [])
+        .option('-p, --pattern <pattern>', 'Glob pattern for files to update', 'backlog/**/*.md')
+        .option('--dry-run', 'Preview changes without modifying files', false)
+        .option('-v, --verbose', 'Show detailed progress', false)
+        .option('--cwd <path>', 'Working directory', process.cwd())
+        .action(async (cmdOptions) => {
+        try {
+            await runUpdateFieldsCommand(cmdOptions);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`\nError: ${errorMessage}\n`);
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/**
+ * Parse comma-separated string into array
+ *
+ * @param value - Comma-separated string
+ * @returns Array of strings
+ */
+function parseCommaSeparated(value) {
+    return value.split(',').map((s) => s.trim()).filter(Boolean);
+}
+/**
+ * Collect multiple values into array
+ *
+ * @param value - Value to add
+ * @param previous - Previous values
+ * @returns Updated array
+ */
+function collect(value, previous) {
+    return previous.concat([value]);
+}
+/**
+ * Parse field=value pairs into object
+ *
+ * @param pairs - Array of "field=value" strings
+ * @returns Object with field-value mappings
+ */
+function parseFieldValuePairs(pairs) {
+    const result = {};
+    for (const pair of pairs) {
+        const [field, ...valueParts] = pair.split('=');
+        if (!field || valueParts.length === 0) {
+            throw new Error(`Invalid field=value format: ${pair}`);
+        }
+        const valueStr = valueParts.join('='); // Handle values with = in them
+        // Try to parse as JSON for complex values
+        let value = valueStr;
+        try {
+            value = JSON.parse(valueStr);
+        }
+        catch {
+            // If not valid JSON, use as string
+            // Special handling for null/undefined
+            if (valueStr === 'null')
+                value = null;
+            else if (valueStr === 'undefined')
+                value = undefined;
+        }
+        result[field] = value;
+    }
+    return result;
+}
+/**
+ * Run the update-fields command.
+ *
+ * @param cmdOptions - Command options
+ */
+async function runUpdateFieldsCommand(cmdOptions) {
+    const startTime = Date.now();
+    const { remove, add, update, pattern, dryRun, verbose, cwd, } = cmdOptions;
+    // Validate that at least one operation is specified
+    if (!remove && add.length === 0 && update.length === 0) {
+        throw new Error('At least one operation (--remove, --add, or --update) must be specified');
+    }
+    // Resolve working directory
+    const resolvedCwd = path.resolve(cwd);
+    if (!(await fs.pathExists(resolvedCwd))) {
+        throw new Error(`Working directory does not exist: ${cwd}`);
+    }
+    // Build field operations
+    const operations = {};
+    if (remove) {
+        operations.remove = remove;
+    }
+    if (add.length > 0) {
+        operations.add = parseFieldValuePairs(add);
+    }
+    if (update.length > 0) {
+        operations.update = parseFieldValuePairs(update);
+    }
+    // Print header
+    console.log('');
+    console.log('='.repeat(80));
+    console.log('Bulk Field Update');
+    console.log('='.repeat(80));
+    console.log('');
+    console.log('Configuration:');
+    console.log(`  Working Directory: ${resolvedCwd}`);
+    console.log(`  File Pattern:      ${pattern}`);
+    console.log(`  Dry Run:           ${dryRun ? 'YES' : 'NO'}`);
+    console.log(`  Verbose:           ${verbose ? 'YES' : 'NO'}`);
+    console.log('');
+    console.log('Operations:');
+    if (operations.remove) {
+        console.log(`  Remove fields:     ${operations.remove.join(', ')}`);
+    }
+    if (operations.add) {
+        console.log(`  Add fields:        ${Object.keys(operations.add).join(', ')}`);
+    }
+    if (operations.update) {
+        console.log(`  Update fields:     ${Object.keys(operations.update).join(', ')}`);
+    }
+    console.log('');
+    // Find files
+    if (verbose) {
+        console.log(`Searching for files matching: ${pattern}`);
+    }
+    const files = await findFiles(pattern, resolvedCwd);
+    if (files.length === 0) {
+        console.log('No files found matching pattern.\n');
+        return;
+    }
+    console.log(`Found ${files.length} file(s) to process.\n`);
+    // Process files
+    console.log('Processing files...\n');
+    const results = await bulkUpdateFiles(files, operations, {
+        dryRun,
+        verbose,
+    });
+    // Print results
+    printResults(results, resolvedCwd, dryRun, verbose);
+    const durationMs = Date.now() - startTime;
+    recordCLICommand('backlog', 'update-fields', { pattern, dry_run: dryRun }, { tickets_updated: results.modifiedFiles }, durationMs, results.errors.length === 0).catch(() => { });
+    // Exit with error code if there were errors
+    if (results.errors.length > 0) {
+        process.exit(1);
+    }
+}
+/**
+ * Print results summary
+ *
+ * @param results - Bulk update results
+ * @param basePath - Base path for relative file paths
+ * @param dryRun - Whether this was a dry run
+ * @param verbose - Whether to show detailed output
+ */
+function printResults(results, basePath, dryRun, verbose) {
+    // Print detailed changes if verbose
+    if (verbose) {
+        console.log('Changes:');
+        console.log('');
+        for (const change of results.changes) {
+            const relPath = path.relative(basePath, change.file);
+            const status = change.error
+                ? '❌ ERROR'
+                : change.modified
+                    ? dryRun
+                        ? '[DRY RUN]'
+                        : '✅'
+                    : '⏭️  SKIP';
+            console.log(`${status} ${relPath}`);
+            if (change.modified && change.operations.length > 0) {
+                for (const op of change.operations) {
+                    console.log(`    - ${op}`);
+                }
+            }
+            if (change.error) {
+                console.log(`    Error: ${change.error}`);
+            }
+        }
+        console.log('');
+    }
+    // Print summary
+    console.log('='.repeat(80));
+    console.log('Summary');
+    console.log('='.repeat(80));
+    console.log('');
+    console.log(`  Total files:     ${results.totalFiles}`);
+    console.log(`  Modified:        ${results.modifiedFiles}`);
+    console.log(`  Skipped:         ${results.skippedFiles}`);
+    console.log(`  Errors:          ${results.errors.length}`);
+    console.log('');
+    if (dryRun && results.modifiedFiles > 0) {
+        console.log('[DRY RUN] No files were modified.');
+        console.log('Remove --dry-run flag to apply changes.\n');
+    }
+    else if (results.modifiedFiles > 0) {
+        console.log(`✅ Successfully updated ${results.modifiedFiles} file(s).\n`);
+    }
+    else if (results.errors.length === 0) {
+        console.log('✅ No changes needed.\n');
+    }
+    // Print errors
+    if (results.errors.length > 0) {
+        console.log('Errors encountered:');
+        for (const error of results.errors) {
+            console.log(`  ❌ ${error}`);
+        }
+        console.log('');
+    }
+}
+//# sourceMappingURL=update-fields.js.map

package/dist/commands/backlog/update-fields.js.map

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

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

@@ -0,0 +1,19 @@
+/**
+ * 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';
+/**
+ * Create the enhanced validate command.
+ *
+ * @returns Commander command instance
+ */
+export declare function createValidateEnhancedCommand(): Command;
+//# sourceMappingURL=validate-enhanced.d.ts.map

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

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