workflow-agent-cli 2.8.0 → 2.9.0

package/dist/cli/index.js

@@ -10,10 +10,12 @@ import {
   stageAllChanges
 } from "../chunk-6NWQLGHI.js";
 import {
+  applyReferenceFix,
   validateBranchName,
   validateCommitMessage,
+  validateDocumentReferences,
   validatePRTitle
-} from "../chunk-NMHWD2GA.js";
+} from "../chunk-ZLDJ2OGO.js";
 import {
   hasConfig,
   loadConfig,
@@ -29,7 +31,7 @@ import {
   installMandatoryTemplates,
   templateMetadata,
   updateTemplates
-} from "../chunk-2WUPMAH3.js";
+} from "../chunk-Y5N3JJTU.js";
 
 // src/cli/index.ts
 import { Command } from "commander";
@@ -316,10 +318,10 @@ async function initCommand(options) {
     try {
       const presetModule = await import(`@workflow/scopes-${preset}`);
       scopes = presetModule.scopes || presetModule.default.scopes;
-      const spinner9 = p.spinner();
-      spinner9.start(`Loading ${presetModule.default?.name || preset} preset`);
+      const spinner10 = p.spinner();
+      spinner10.start(`Loading ${presetModule.default?.name || preset} preset`);
       await new Promise((resolve2) => setTimeout(resolve2, 500));
-      spinner9.stop(`\u2713 Loaded ${scopes.length} scopes from preset`);
+      spinner10.stop(`\u2713 Loaded ${scopes.length} scopes from preset`);
     } catch (error) {
       console.log(
         chalk.yellow(
@@ -366,8 +368,8 @@ async function initCommand(options) {
     process.exit(0);
   }
   if (shouldGenerateGuidelines) {
-    const spinner9 = p.spinner();
-    spinner9.start("Generating guidelines...");
+    const spinner10 = p.spinner();
+    spinner10.start("Generating guidelines...");
     try {
       const templatesDir = join(__dirname, "../../templates");
       await validateTemplateDirectory(templatesDir);
@@ -379,7 +381,7 @@ async function initCommand(options) {
         guidelinesDir,
         context
       );
-      spinner9.stop(`\u2713 Generated ${renderedFiles.length} guideline documents`);
+      spinner10.stop(`\u2713 Generated ${renderedFiles.length} guideline documents`);
       const instructionsSpinner = p.spinner();
       instructionsSpinner.start("Generating AI agent instructions...");
       const result = generateCopilotInstructions(cwd, { silent: true });
@@ -389,7 +391,7 @@ async function initCommand(options) {
         instructionsSpinner.stop("\u26A0\uFE0F  Could not generate copilot instructions");
       }
     } catch (error) {
-      spinner9.stop("\u26A0\uFE0F  Could not generate guidelines");
+      spinner10.stop("\u26A0\uFE0F  Could not generate guidelines");
       console.log(
         chalk.yellow(
           `
@@ -898,8 +900,8 @@ async function scopeCreateCommand(options) {
       process.exit(0);
     }
   }
-  const spinner9 = p4.spinner();
-  spinner9.start("Creating package structure...");
+  const spinner10 = p4.spinner();
+  spinner10.start("Creating package structure...");
   try {
     await mkdir2(join3(outputDir, "src"), { recursive: true });
     const packageJson = {
@@ -1030,7 +1032,7 @@ describe('${presetName} Scope Preset', () => {
         "utf-8"
       );
     }
-    spinner9.stop("\u2713 Package structure created");
+    spinner10.stop("\u2713 Package structure created");
     if (isMonorepo2) {
       const workspaceFile = join3(cwd, "pnpm-workspace.yaml");
       const workspaceContent = await readFile(workspaceFile, "utf-8");
@@ -1082,7 +1084,7 @@ describe('${presetName} Scope Preset', () => {
       );
     }
   } catch (error) {
-    spinner9.stop("\u2717 Failed to create package");
+    spinner10.stop("\u2717 Failed to create package");
     console.error(chalk7.red("\nError:"), error);
     process.exit(1);
   }
@@ -1210,8 +1212,8 @@ async function scopeMigrateCommand(options) {
       process.exit(0);
     }
   }
-  const spinner9 = p5.spinner();
-  spinner9.start("Migrating scopes to package...");
+  const spinner10 = p5.spinner();
+  spinner10.start("Migrating scopes to package...");
   try {
     await mkdir3(join4(outputDir, "src"), { recursive: true });
     const packageJson = {
@@ -1339,7 +1341,7 @@ describe('${presetName} Scope Preset (Migrated)', () => {
 });
 `;
     await writeFile3(join4(outputDir, "src", "index.test.ts"), testFile, "utf-8");
-    spinner9.stop("\u2713 Package created from migrated scopes");
+    spinner10.stop("\u2713 Package created from migrated scopes");
     if (isMonorepo2) {
       const workspaceFile = join4(cwd, "pnpm-workspace.yaml");
       const workspaceContent = await readFile2(workspaceFile, "utf-8");
@@ -1411,7 +1413,7 @@ describe('${presetName} Scope Preset (Migrated)', () => {
       )
     );
   } catch (error) {
-    spinner9.stop("\u2717 Migration failed");
+    spinner10.stop("\u2717 Migration failed");
     console.error(chalk8.red("\nError:"), error);
     process.exit(1);
   }
@@ -1651,14 +1653,14 @@ import chalk10 from "chalk";
 async function autoSetupCommand(options) {
   console.log(chalk10.bold.cyan("\n\u{1F527} Workflow Agent Auto-Setup\n"));
   const cwd = process.cwd();
-  const spinner9 = p6.spinner();
-  spinner9.start("Analyzing project...");
+  const spinner10 = p6.spinner();
+  spinner10.start("Analyzing project...");
   let report;
   try {
     report = await generateAuditReport(cwd);
-    spinner9.stop("\u2713 Project analysis complete");
+    spinner10.stop("\u2713 Project analysis complete");
   } catch (error) {
-    spinner9.stop("\u2717 Failed to analyze project");
+    spinner10.stop("\u2717 Failed to analyze project");
     console.error(
       chalk10.red(
         `Error: ${error instanceof Error ? error.message : String(error)}`
@@ -2834,7 +2836,7 @@ var QuestionGenerator = class {
         category: "Platform Strategy",
         question: `Are our platform choices (${technology.platforms.join(", ")}) aligned with target market and growth plans?`,
         context: `Currently deployed on ${technology.platforms.join(" + ")}`,
-        findings: technology.platforms.map((p12) => `Supports ${p12} platform`),
+        findings: technology.platforms.map((p13) => `Supports ${p13} platform`),
         recommendations: [
           "Validate platform coverage matches user demographics",
           "Assess cross-platform development efficiency",
@@ -2896,7 +2898,7 @@ var QuestionGenerator = class {
         category: "Business Alignment",
         question: `How is our authentication solution (${authCat.packages.join(", ")}) supporting user onboarding and security requirements?`,
         context: `Using ${authCat.packages.join(" + ")} for authentication`,
-        findings: authCat.packages.map((p12) => `Auth provider: ${p12}`),
+        findings: authCat.packages.map((p13) => `Auth provider: ${p13}`),
         recommendations: [
           "Measure authentication success rates and friction points",
           "Ensure compliance with security standards (SOC2, GDPR, etc.)",
@@ -2948,12 +2950,12 @@ var QuestionGenerator = class {
       });
     }
     if (packages.outdated && packages.outdated.length > 10) {
-      const breakingCount = packages.outdated.filter((p12) => p12.breaking).length;
+      const breakingCount = packages.outdated.filter((p13) => p13.breaking).length;
       questions.push({
         category: "Technical Debt",
         question: `How should we prioritize updating ${packages.outdated.length} outdated packages${breakingCount > 0 ? ` (${breakingCount} with breaking changes)` : ""}?`,
         context: "Dependency audit found outdated packages",
-        findings: packages.outdated.slice(0, 5).map((p12) => `${p12.name}: ${p12.current} \u2192 ${p12.latest}`),
+        findings: packages.outdated.slice(0, 5).map((p13) => `${p13.name}: ${p13.current} \u2192 ${p13.latest}`),
         recommendations: [
           "Create update roadmap starting with non-breaking changes",
           "Test breaking changes in feature branches",
@@ -3263,10 +3265,10 @@ var ReportComparator = class {
    */
   comparePackages() {
     const baselineProduction = new Map(
-      this.baseline.packages.production.map((p12) => [p12.name, p12])
+      this.baseline.packages.production.map((p13) => [p13.name, p13])
     );
     const currentProduction = new Map(
-      this.current.packages.production.map((p12) => [p12.name, p12])
+      this.current.packages.production.map((p13) => [p13.name, p13])
     );
     const added = [];
     const removed = [];
@@ -3298,10 +3300,10 @@ var ReportComparator = class {
       }
     }
     const baselineDev = new Map(
-      this.baseline.packages.development.map((p12) => [p12.name, p12])
+      this.baseline.packages.development.map((p13) => [p13.name, p13])
     );
     const currentDev = new Map(
-      this.current.packages.development.map((p12) => [p12.name, p12])
+      this.current.packages.development.map((p13) => [p13.name, p13])
     );
     for (const [name, pkg] of currentDev) {
       if (!baselineDev.has(name)) {
@@ -3589,20 +3591,20 @@ async function advisoryCommand(options) {
     includeHealth,
     excludePatterns: advisoryConfig?.excludePatterns
   });
-  const spinner9 = p7.spinner();
+  const spinner10 = p7.spinner();
   const depthLabels = {
     executive: "executive summary",
     quick: "quick scan",
     standard: "standard analysis",
     comprehensive: "comprehensive analysis"
   };
-  spinner9.start(`Running ${depthLabels[depth]}...`);
+  spinner10.start(`Running ${depthLabels[depth]}...`);
   let analysis;
   try {
     analysis = await analyzer.analyze();
-    spinner9.stop(`\u2713 Analysis complete`);
+    spinner10.stop(`\u2713 Analysis complete`);
   } catch (error) {
-    spinner9.stop("\u2717 Analysis failed");
+    spinner10.stop("\u2717 Analysis failed");
     console.error(
       chalk11.red(
         `Error: ${error instanceof Error ? error.message : String(error)}`
@@ -3619,17 +3621,17 @@ async function advisoryCommand(options) {
   if (options.compare) {
     const comparisonPath = options.compare.endsWith(".json") ? join6(cwd, options.compare) : join6(cwd, options.compare, "analysis.json");
     if (existsSync6(comparisonPath)) {
-      spinner9.start("Comparing with previous report...");
+      spinner10.start("Comparing with previous report...");
       try {
         const previousContent = await readFile4(comparisonPath, "utf-8");
         const previousAnalysis = JSON.parse(previousContent);
         comparator = new ReportComparator(previousAnalysis, analysis);
         comparisonReport = comparator.compare();
-        spinner9.stop("\u2713 Comparison complete");
+        spinner10.stop("\u2713 Comparison complete");
         console.log("");
         displayComparisonSummary(comparisonReport);
       } catch (error) {
-        spinner9.stop("\u26A0 Comparison failed");
+        spinner10.stop("\u26A0 Comparison failed");
         console.warn(chalk11.yellow(`Could not compare reports: ${error}`));
       }
     } else {
@@ -3648,7 +3650,7 @@ async function advisoryCommand(options) {
   }
   const fullOutputDir = join6(cwd, outputDir);
   await mkdir4(fullOutputDir, { recursive: true });
-  spinner9.start("Generating reports...");
+  spinner10.start("Generating reports...");
   try {
     const timestamp = options.timestamp ? (/* @__PURE__ */ new Date()).toISOString().split("T")[0] : "";
     if (options.format === "json") {
@@ -3662,9 +3664,9 @@ async function advisoryCommand(options) {
         timestamp
       );
     }
-    spinner9.stop("\u2713 Reports generated");
+    spinner10.stop("\u2713 Reports generated");
   } catch (error) {
-    spinner9.stop("\u2717 Failed to write reports");
+    spinner10.stop("\u2717 Failed to write reports");
     console.error(chalk11.red(`Error: ${error}`));
     process.exit(1);
   }
@@ -4462,8 +4464,8 @@ async function generateInstructionsCommand(options) {
       process.exit(0);
     }
   }
-  const spinner9 = p8.spinner();
-  spinner9.start("Generating AI agent instructions from guidelines...");
+  const spinner10 = p8.spinner();
+  spinner10.start("Generating AI agent instructions from guidelines...");
   try {
     const result = generateCopilotInstructions(cwd, {
       force: true,
@@ -4471,7 +4473,7 @@ async function generateInstructionsCommand(options) {
     });
     if (result.success) {
       const status = result.isNew ? "Generated" : "Regenerated";
-      spinner9.stop(
+      spinner10.stop(
         chalk12.green(
           `\u2713 ${status} .github/copilot-instructions.md from ${result.guidelinesCount} guidelines`
         )
@@ -4487,12 +4489,12 @@ async function generateInstructionsCommand(options) {
         )
       );
     } else {
-      spinner9.stop(chalk12.red("\u2717 Failed to generate instructions"));
+      spinner10.stop(chalk12.red("\u2717 Failed to generate instructions"));
       console.log(chalk12.yellow(`
 Reason: ${result.error}`));
     }
   } catch (error) {
-    spinner9.stop(chalk12.red("\u2717 Error generating instructions"));
+    spinner10.stop(chalk12.red("\u2717 Error generating instructions"));
     console.log(
       chalk12.yellow(
         `
@@ -4575,8 +4577,8 @@ async function updateTemplatesCommand(options) {
       process.exit(0);
     }
   }
-  const spinner9 = p9.spinner();
-  spinner9.start("Updating templates...");
+  const spinner10 = p9.spinner();
+  spinner10.start("Updating templates...");
   let result;
   try {
     result = updateTemplates(cwd, templatesDir, {
@@ -4584,7 +4586,7 @@ async function updateTemplatesCommand(options) {
       silent: true
     });
   } catch (error) {
-    spinner9.stop("\u274C Failed to update templates");
+    spinner10.stop("\u274C Failed to update templates");
     console.log(
       chalk13.red(
         `
@@ -4595,7 +4597,7 @@ Error: ${error instanceof Error ? error.message : String(error)}`
   }
   const totalChanges = result.installed.length + result.updated.length;
   if (totalChanges === 0 && result.skipped.length > 0) {
-    spinner9.stop("No changes needed");
+    spinner10.stop("No changes needed");
     console.log(
       chalk13.dim(
         `
@@ -4603,7 +4605,7 @@ Error: ${error instanceof Error ? error.message : String(error)}`
       )
     );
   } else {
-    spinner9.stop(`\u2713 Template update complete`);
+    spinner10.stop(`\u2713 Template update complete`);
     if (result.installed.length > 0) {
       console.log(chalk13.green(`
   New templates installed:`));
@@ -4649,9 +4651,176 @@ Error: ${error instanceof Error ? error.message : String(error)}`
   p9.outro(chalk13.green("Done!"));
 }
 
-// src/cli/commands/learn.ts
-import chalk14 from "chalk";
+// src/cli/commands/docs-validate.ts
 import * as p10 from "@clack/prompts";
+import chalk14 from "chalk";
+import { relative } from "path";
+async function docsValidateCommand(options) {
+  const { fix = false, patterns, ignore } = options;
+  p10.intro(chalk14.bgBlue(" workflow-agent docs:validate "));
+  const cwd = process.cwd();
+  const spinner10 = p10.spinner();
+  spinner10.start("Scanning markdown files for broken references...");
+  try {
+    const result = await validateDocumentReferences(cwd, {
+      patterns,
+      ignore
+    });
+    spinner10.stop("Scan complete");
+    console.log("");
+    console.log(
+      chalk14.cyan(
+        `\u{1F4C4} Scanned ${result.scannedFiles} file(s), found ${result.totalReferences} reference(s)`
+      )
+    );
+    if (result.errors.length > 0) {
+      console.log("");
+      console.log(chalk14.red("\u274C Errors during validation:"));
+      for (const error of result.errors) {
+        console.log(chalk14.red(`   ${error}`));
+      }
+      p10.outro(chalk14.red("Validation failed"));
+      process.exit(1);
+    }
+    if (result.valid) {
+      console.log("");
+      console.log(chalk14.green("\u2705 All document references are valid!"));
+      p10.outro(chalk14.green("No broken links found"));
+      return;
+    }
+    console.log("");
+    console.log(
+      chalk14.yellow(
+        `\u26A0\uFE0F  Found ${result.brokenReferences.length} broken reference(s):`
+      )
+    );
+    console.log("");
+    for (const broken of result.brokenReferences) {
+      const relativePath = relative(cwd, broken.file);
+      console.log(
+        chalk14.red(
+          `  ${relativePath}:${broken.line}:${broken.column} - ${broken.type}`
+        )
+      );
+      console.log(chalk14.dim(`    ${broken.rawLink}`));
+      console.log(chalk14.dim(`    Target: ${broken.targetPath}`));
+      if (broken.suggestions.length > 0) {
+        console.log(chalk14.dim(`    Suggestions: ${broken.suggestions.slice(0, 3).join(", ")}`));
+      }
+      console.log("");
+    }
+    if (!fix) {
+      console.log(
+        chalk14.yellow("\u{1F4A1} Run with --fix flag to interactively fix broken references")
+      );
+      p10.outro(chalk14.red("Validation failed"));
+      process.exit(1);
+    }
+    console.log(chalk14.cyan("\u{1F527} Interactive fix mode\n"));
+    let fixedCount = 0;
+    let skippedCount = 0;
+    for (const broken of result.brokenReferences) {
+      const relativePath = relative(cwd, broken.file);
+      console.log(chalk14.bold(`
+${relativePath}:${broken.line}`));
+      console.log(chalk14.dim(`  ${broken.rawLink}`));
+      console.log(chalk14.yellow(`  \u274C Broken: ${broken.targetPath}
+`));
+      const options2 = [];
+      if (broken.suggestions.length > 0) {
+        options2.push(
+          ...broken.suggestions.slice(0, 8).map((suggestion) => ({
+            value: suggestion,
+            label: `\u{1F4C4} ${suggestion}`
+          }))
+        );
+      }
+      options2.push({
+        value: "__custom__",
+        label: "\u270F\uFE0F  Enter custom path"
+      });
+      options2.push({
+        value: "__skip__",
+        label: "\u23ED\uFE0F  Skip this reference"
+      });
+      const choice = await p10.select({
+        message: "Choose correct path:",
+        options: options2
+      });
+      if (p10.isCancel(choice)) {
+        console.log("");
+        p10.cancel("Fix operation cancelled");
+        console.log(
+          chalk14.dim(`
+Fixed: ${fixedCount}, Skipped: ${skippedCount}`)
+        );
+        process.exit(0);
+      }
+      if (choice === "__skip__") {
+        skippedCount++;
+        continue;
+      }
+      let newPath;
+      if (choice === "__custom__") {
+        const customPath = await p10.text({
+          message: "Enter the correct path:",
+          placeholder: broken.targetPath,
+          validate: (value) => {
+            if (!value || value.trim().length === 0) {
+              return "Path cannot be empty";
+            }
+          }
+        });
+        if (p10.isCancel(customPath)) {
+          console.log("");
+          p10.cancel("Fix operation cancelled");
+          console.log(
+            chalk14.dim(`
+Fixed: ${fixedCount}, Skipped: ${skippedCount}`)
+          );
+          process.exit(0);
+        }
+        newPath = customPath;
+      } else {
+        newPath = choice;
+      }
+      try {
+        await applyReferenceFix(broken.file, broken.rawLink, newPath);
+        console.log(chalk14.green(`  \u2705 Fixed: ${broken.targetPath} \u2192 ${newPath}`));
+        fixedCount++;
+      } catch (error) {
+        console.log(
+          chalk14.red(
+            `  \u274C Failed to fix: ${error instanceof Error ? error.message : "Unknown error"}`
+          )
+        );
+        skippedCount++;
+      }
+    }
+    console.log("");
+    console.log(chalk14.cyan(`\u{1F4CA} Summary:`));
+    console.log(chalk14.green(`   Fixed: ${fixedCount}`));
+    if (skippedCount > 0) {
+      console.log(chalk14.yellow(`   Skipped: ${skippedCount}`));
+    }
+    if (fixedCount > 0) {
+      p10.outro(chalk14.green("Document references fixed!"));
+    } else {
+      p10.outro(chalk14.yellow("No references were fixed"));
+    }
+  } catch (error) {
+    spinner10.stop("Scan failed");
+    console.log("");
+    p10.cancel(
+      `Validation error: ${error instanceof Error ? error.message : "Unknown error"}`
+    );
+    process.exit(1);
+  }
+}
+
+// src/cli/commands/learn.ts
+import chalk15 from "chalk";
+import * as p11 from "@clack/prompts";
 import {
   PatternStore as PatternStore2,
   ContributorManager as ContributorManager2,
@@ -4674,10 +4843,10 @@ function formatTags(tags) {
 async function learnRecordCommand(options) {
   const cwd = getWorkspacePath();
   const store = new PatternStore2(cwd);
-  console.log(chalk14.cyan("\n\u{1F4DA} Record a Learning Pattern\n"));
+  console.log(chalk15.cyan("\n\u{1F4DA} Record a Learning Pattern\n"));
   let patternType = options.type;
   if (!patternType) {
-    const typeChoice = await p10.select({
+    const typeChoice = await p11.select({
       message: "What type of pattern are you recording?",
       options: [
         {
@@ -4690,15 +4859,15 @@ async function learnRecordCommand(options) {
         }
       ]
     });
-    if (p10.isCancel(typeChoice)) {
-      p10.cancel("Recording cancelled");
+    if (p11.isCancel(typeChoice)) {
+      p11.cancel("Recording cancelled");
       process.exit(0);
     }
     patternType = typeChoice;
   }
   let name = options.name;
   if (!name) {
-    const nameInput = await p10.text({
+    const nameInput = await p11.text({
       message: "Pattern name:",
       placeholder: "e.g., Next.js App Router Migration",
       validate: (value) => {
@@ -4708,15 +4877,15 @@ async function learnRecordCommand(options) {
         return void 0;
       }
     });
-    if (p10.isCancel(nameInput)) {
-      p10.cancel("Recording cancelled");
+    if (p11.isCancel(nameInput)) {
+      p11.cancel("Recording cancelled");
       process.exit(0);
     }
     name = nameInput;
   }
   let description = options.description;
   if (!description) {
-    const descInput = await p10.text({
+    const descInput = await p11.text({
       message: "Description:",
       placeholder: "What does this pattern solve?",
       validate: (value) => {
@@ -4727,40 +4896,40 @@ async function learnRecordCommand(options) {
         return void 0;
       }
     });
-    if (p10.isCancel(descInput)) {
-      p10.cancel("Recording cancelled");
+    if (p11.isCancel(descInput)) {
+      p11.cancel("Recording cancelled");
       process.exit(0);
     }
     description = descInput;
   }
   let framework = options.framework;
   if (!framework) {
-    const fwInput = await p10.text({
+    const fwInput = await p11.text({
       message: "Framework:",
       placeholder: "e.g., next, react, vue, express"
     });
-    if (p10.isCancel(fwInput)) {
-      p10.cancel("Recording cancelled");
+    if (p11.isCancel(fwInput)) {
+      p11.cancel("Recording cancelled");
       process.exit(0);
     }
     framework = fwInput;
   }
   let version = options.version;
   if (!version) {
-    const versionInput = await p10.text({
+    const versionInput = await p11.text({
       message: "Framework version (semver range):",
       placeholder: "e.g., >=14.0.0, ^18.0.0",
       initialValue: ">=1.0.0"
     });
-    if (p10.isCancel(versionInput)) {
-      p10.cancel("Recording cancelled");
+    if (p11.isCancel(versionInput)) {
+      p11.cancel("Recording cancelled");
       process.exit(0);
     }
     version = versionInput;
   }
   let category = options.category;
   if (patternType === "fix" && !category) {
-    const catChoice = await p10.select({
+    const catChoice = await p11.select({
       message: "Category:",
       options: [
         { value: "migration", label: "\u{1F504} Migration" },
@@ -4775,8 +4944,8 @@ async function learnRecordCommand(options) {
         { value: "other", label: "\u{1F4E6} Other" }
       ]
     });
-    if (p10.isCancel(catChoice)) {
-      p10.cancel("Recording cancelled");
+    if (p11.isCancel(catChoice)) {
+      p11.cancel("Recording cancelled");
       process.exit(0);
     }
     category = catChoice;
@@ -4839,14 +5008,14 @@ async function learnRecordCommand(options) {
     };
     const result = await store.saveFixPattern(fixPattern);
     if (result.success) {
-      console.log(chalk14.green("\n\u2705 Fix pattern recorded successfully!\n"));
-      console.log(chalk14.dim(`  ID: ${fixPattern.id}`));
-      console.log(chalk14.dim(`  Name: ${name}`));
-      console.log(chalk14.dim(`  Category: ${category}`));
-      console.log(chalk14.dim(`  Framework: ${framework} ${version}`));
+      console.log(chalk15.green("\n\u2705 Fix pattern recorded successfully!\n"));
+      console.log(chalk15.dim(`  ID: ${fixPattern.id}`));
+      console.log(chalk15.dim(`  Name: ${name}`));
+      console.log(chalk15.dim(`  Category: ${category}`));
+      console.log(chalk15.dim(`  Framework: ${framework} ${version}`));
     } else {
-      console.log(chalk14.red("\n\u274C Failed to record pattern"));
-      console.log(chalk14.dim(`  Error: ${result.error}`));
+      console.log(chalk15.red("\n\u274C Failed to record pattern"));
+      console.log(chalk15.dim(`  Error: ${result.error}`));
       process.exit(1);
     }
   } else {
@@ -4893,13 +5062,13 @@ async function learnRecordCommand(options) {
     };
     const result = await store.saveBlueprint(blueprint);
     if (result.success) {
-      console.log(chalk14.green("\n\u2705 Blueprint recorded successfully!\n"));
-      console.log(chalk14.dim(`  ID: ${blueprint.id}`));
-      console.log(chalk14.dim(`  Name: ${name}`));
-      console.log(chalk14.dim(`  Framework: ${framework} ${version}`));
+      console.log(chalk15.green("\n\u2705 Blueprint recorded successfully!\n"));
+      console.log(chalk15.dim(`  ID: ${blueprint.id}`));
+      console.log(chalk15.dim(`  Name: ${name}`));
+      console.log(chalk15.dim(`  Framework: ${framework} ${version}`));
     } else {
-      console.log(chalk14.red("\n\u274C Failed to record blueprint"));
-      console.log(chalk14.dim(`  Error: ${result.error}`));
+      console.log(chalk15.red("\n\u274C Failed to record blueprint"));
+      console.log(chalk15.dim(`  Error: ${result.error}`));
       process.exit(1);
     }
   }
@@ -4909,7 +5078,7 @@ async function learnListCommand(options) {
   const store = new PatternStore2(cwd);
   const patternType = options.type ?? "all";
   const showDeprecated = options.deprecated ?? false;
-  console.log(chalk14.cyan("\n\u{1F4DA} Recorded Learning Patterns\n"));
+  console.log(chalk15.cyan("\n\u{1F4DA} Recorded Learning Patterns\n"));
   if (patternType === "all" || patternType === "fix") {
     const fixResult = await store.listFixPatterns({
       tags: options.tag ? [{ category: "framework", name: options.tag }] : void 0,
@@ -4917,29 +5086,29 @@ async function learnListCommand(options) {
       includeDeprecated: showDeprecated
     });
     if (fixResult.success && fixResult.data && fixResult.data.length > 0) {
-      console.log(chalk14.bold.yellow("\u{1F527} Fix Patterns:\n"));
+      console.log(chalk15.bold.yellow("\u{1F527} Fix Patterns:\n"));
       for (const pattern of fixResult.data) {
         const isDeprecated = pattern.deprecatedAt !== void 0;
         const statusIcon = isDeprecated ? "\u26A0\uFE0F" : "\u2713";
-        const nameColor = isDeprecated ? chalk14.dim : chalk14.white;
+        const nameColor = isDeprecated ? chalk15.dim : chalk15.white;
         console.log(`  ${statusIcon} ${nameColor(pattern.name)}`);
-        console.log(chalk14.dim(`     ID: ${pattern.id}`));
-        console.log(chalk14.dim(`     Category: ${pattern.category}`));
+        console.log(chalk15.dim(`     ID: ${pattern.id}`));
+        console.log(chalk15.dim(`     Category: ${pattern.category}`));
         console.log(
-          chalk14.dim(`     Created: ${formatDate(pattern.createdAt)}`)
+          chalk15.dim(`     Created: ${formatDate(pattern.createdAt)}`)
         );
         console.log(
-          chalk14.dim(
+          chalk15.dim(
             `     Success Rate: ${(pattern.metrics.successRate * 100).toFixed(0)}% (${pattern.metrics.successes}/${pattern.metrics.applications})`
           )
         );
         if (pattern.tags.length > 0) {
-          console.log(chalk14.dim(`     Tags: ${formatTags(pattern.tags)}`));
+          console.log(chalk15.dim(`     Tags: ${formatTags(pattern.tags)}`));
         }
         console.log("");
       }
     } else if (patternType === "fix") {
-      console.log(chalk14.dim("  No fix patterns found.\n"));
+      console.log(chalk15.dim("  No fix patterns found.\n"));
     }
   }
   if (patternType === "all" || patternType === "blueprint") {
@@ -4949,46 +5118,46 @@ async function learnListCommand(options) {
       includeDeprecated: showDeprecated
     });
     if (bpResult.success && bpResult.data && bpResult.data.length > 0) {
-      console.log(chalk14.bold.blue("\u{1F4D0} Blueprints:\n"));
+      console.log(chalk15.bold.blue("\u{1F4D0} Blueprints:\n"));
       for (const blueprint of bpResult.data) {
         const isDeprecated = blueprint.deprecatedAt !== void 0;
         const statusIcon = isDeprecated ? "\u26A0\uFE0F" : "\u2713";
-        const nameColor = isDeprecated ? chalk14.dim : chalk14.white;
+        const nameColor = isDeprecated ? chalk15.dim : chalk15.white;
         console.log(`  ${statusIcon} ${nameColor(blueprint.name)}`);
-        console.log(chalk14.dim(`     ID: ${blueprint.id}`));
-        console.log(chalk14.dim(`     Language: ${blueprint.stack.language}`));
+        console.log(chalk15.dim(`     ID: ${blueprint.id}`));
+        console.log(chalk15.dim(`     Language: ${blueprint.stack.language}`));
         console.log(
-          chalk14.dim(`     Created: ${formatDate(blueprint.createdAt)}`)
+          chalk15.dim(`     Created: ${formatDate(blueprint.createdAt)}`)
         );
         console.log(
-          chalk14.dim(
+          chalk15.dim(
             `     Success Rate: ${(blueprint.metrics.successRate * 100).toFixed(0)}% (${blueprint.metrics.successes}/${blueprint.metrics.applications})`
           )
         );
         if (blueprint.tags.length > 0) {
-          console.log(chalk14.dim(`     Tags: ${formatTags(blueprint.tags)}`));
+          console.log(chalk15.dim(`     Tags: ${formatTags(blueprint.tags)}`));
         }
         console.log("");
       }
     } else if (patternType === "blueprint") {
-      console.log(chalk14.dim("  No blueprints found.\n"));
+      console.log(chalk15.dim("  No blueprints found.\n"));
     }
   }
   const stats = await store.getStats();
   const totalPatterns = stats.totalFixes + stats.totalBlueprints;
   const totalDeprecated = stats.deprecatedFixes + stats.deprecatedBlueprints;
-  console.log(chalk14.dim("\u2501".repeat(40)));
-  console.log(chalk14.dim(`Total: ${totalPatterns} patterns`));
-  console.log(chalk14.dim(`  Fix Patterns: ${stats.totalFixes}`));
-  console.log(chalk14.dim(`  Blueprints: ${stats.totalBlueprints}`));
-  console.log(chalk14.dim(`  Deprecated: ${totalDeprecated}`));
+  console.log(chalk15.dim("\u2501".repeat(40)));
+  console.log(chalk15.dim(`Total: ${totalPatterns} patterns`));
+  console.log(chalk15.dim(`  Fix Patterns: ${stats.totalFixes}`));
+  console.log(chalk15.dim(`  Blueprints: ${stats.totalBlueprints}`));
+  console.log(chalk15.dim(`  Deprecated: ${totalDeprecated}`));
   console.log("");
 }
 async function learnApplyCommand(patternId, options) {
   const cwd = getWorkspacePath();
   const store = new PatternStore2(cwd);
   const telemetry = new TelemetryCollector2(cwd);
-  console.log(chalk14.cyan("\n\u{1F527} Apply Learning Pattern\n"));
+  console.log(chalk15.cyan("\n\u{1F527} Apply Learning Pattern\n"));
   let pattern = await store.getFixPattern(patternId);
   let patternType = "fix";
   if (!pattern.success || !pattern.data) {
@@ -4997,21 +5166,21 @@ async function learnApplyCommand(patternId, options) {
       pattern = bpResult;
       patternType = "blueprint";
     } else {
-      console.log(chalk14.red(`
+      console.log(chalk15.red(`
 \u274C Pattern not found: ${patternId}`));
       console.log(
-        chalk14.dim("  Use 'workflow learn:list' to see available patterns")
+        chalk15.dim("  Use 'workflow learn:list' to see available patterns")
       );
       process.exit(1);
     }
   }
   const patternData = pattern.data;
-  console.log(chalk14.white(`  Pattern: ${patternData.name}`));
-  console.log(chalk14.dim(`  Type: ${patternType}`));
-  console.log(chalk14.dim(`  Description: ${patternData.description}`));
+  console.log(chalk15.white(`  Pattern: ${patternData.name}`));
+  console.log(chalk15.dim(`  Type: ${patternType}`));
+  console.log(chalk15.dim(`  Description: ${patternData.description}`));
   if (options.dryRun) {
     console.log(
-      chalk14.yellow("\n\u{1F4CB} DRY-RUN MODE: No changes will be applied\n")
+      chalk15.yellow("\n\u{1F4CB} DRY-RUN MODE: No changes will be applied\n")
     );
   }
   const framework = options.framework ?? patternData.compatibility.frameworks[0]?.name ?? "unknown";
@@ -5019,44 +5188,44 @@ async function learnApplyCommand(patternId, options) {
   await telemetry.recordApplication(patternId, patternType, framework, version);
   if (patternType === "fix") {
     const fixPattern = patternData;
-    console.log(chalk14.cyan("\n\u{1F4CB} Solution Steps:\n"));
+    console.log(chalk15.cyan("\n\u{1F4CB} Solution Steps:\n"));
     if (fixPattern.solution.steps) {
       for (let i = 0; i < fixPattern.solution.steps.length; i++) {
         const step = fixPattern.solution.steps[i];
         console.log(
-          chalk14.white(`  ${i + 1}. [${step.action}] ${step.description}`)
+          chalk15.white(`  ${i + 1}. [${step.action}] ${step.description}`)
         );
         if (step.file) {
-          console.log(chalk14.dim(`     File: ${step.file}`));
+          console.log(chalk15.dim(`     File: ${step.file}`));
         }
       }
     }
   } else {
     const blueprint = patternData;
-    console.log(chalk14.cyan("\n\u{1F4CB} Setup Steps:\n"));
+    console.log(chalk15.cyan("\n\u{1F4CB} Setup Steps:\n"));
     if (blueprint.setup.steps) {
       for (let i = 0; i < blueprint.setup.steps.length; i++) {
         const step = blueprint.setup.steps[i];
-        console.log(chalk14.white(`  ${i + 1}. ${step.description}`));
+        console.log(chalk15.white(`  ${i + 1}. ${step.description}`));
         if (step.command) {
-          console.log(chalk14.dim(`     Command: ${step.command}`));
+          console.log(chalk15.dim(`     Command: ${step.command}`));
         }
       }
     }
   }
   if (!options.dryRun) {
-    const confirmed = await p10.confirm({
+    const confirmed = await p11.confirm({
       message: "Mark this pattern as successfully applied?",
       initialValue: true
     });
-    if (p10.isCancel(confirmed)) {
-      p10.cancel("Application cancelled");
+    if (p11.isCancel(confirmed)) {
+      p11.cancel("Application cancelled");
       process.exit(0);
     }
     if (confirmed) {
       await store.updatePatternMetrics(patternId, patternType, true);
       await telemetry.recordSuccess(patternId, patternType, framework, version);
-      console.log(chalk14.green("\n\u2705 Pattern marked as successfully applied!"));
+      console.log(chalk15.green("\n\u2705 Pattern marked as successfully applied!"));
     } else {
       await store.updatePatternMetrics(patternId, patternType, false);
       await telemetry.recordFailure(
@@ -5067,7 +5236,7 @@ async function learnApplyCommand(patternId, options) {
         "unknown"
       );
       console.log(
-        chalk14.yellow("\n\u26A0\uFE0F Pattern application marked as unsuccessful.")
+        chalk15.yellow("\n\u26A0\uFE0F Pattern application marked as unsuccessful.")
       );
     }
   }
@@ -5075,32 +5244,32 @@ async function learnApplyCommand(patternId, options) {
 async function learnSyncCommand(options) {
   const cwd = getWorkspacePath();
   const contributorManager = new ContributorManager2(cwd);
-  console.log(chalk14.cyan("\n\u{1F504} Sync Learning Patterns\n"));
+  console.log(chalk15.cyan("\n\u{1F504} Sync Learning Patterns\n"));
   const config = await contributorManager.getConfig();
   if (!config.success || !config.data?.syncOptIn) {
-    console.log(chalk14.yellow("\u26A0\uFE0F Sync is not enabled.\n"));
-    console.log(chalk14.dim("  To enable sync, run:"));
-    console.log(chalk14.dim("    workflow learn:config --enable-sync\n"));
+    console.log(chalk15.yellow("\u26A0\uFE0F Sync is not enabled.\n"));
+    console.log(chalk15.dim("  To enable sync, run:"));
+    console.log(chalk15.dim("    workflow learn:config --enable-sync\n"));
     console.log(
-      chalk14.dim(
+      chalk15.dim(
         "  This allows you to share anonymized patterns with the community."
       )
     );
     process.exit(0);
   }
   if (options.dryRun) {
-    console.log(chalk14.yellow("\u{1F4CB} DRY-RUN MODE: No changes will be synced\n"));
+    console.log(chalk15.yellow("\u{1F4CB} DRY-RUN MODE: No changes will be synced\n"));
   }
   const store = new PatternStore2(cwd);
   const anonymizer = new PatternAnonymizer();
   const { fixes, blueprints } = await store.getPatternsForSync();
   console.log(
-    chalk14.dim(
+    chalk15.dim(
       `  Patterns ready to sync: ${fixes.length} fixes, ${blueprints.length} blueprints`
     )
   );
   if (options.push) {
-    console.log(chalk14.cyan("\n\u{1F4E4} Pushing patterns...\n"));
+    console.log(chalk15.cyan("\n\u{1F4E4} Pushing patterns...\n"));
     let anonymizedFixes = 0;
     let anonymizedBlueprints = 0;
     for (const fix of fixes) {
@@ -5108,7 +5277,7 @@ async function learnSyncCommand(options) {
       if (result.success) {
         anonymizedFixes++;
         if (!options.dryRun) {
-          console.log(chalk14.dim(`  \u2713 Anonymized: ${fix.name}`));
+          console.log(chalk15.dim(`  \u2713 Anonymized: ${fix.name}`));
         }
       }
     }
@@ -5117,117 +5286,117 @@ async function learnSyncCommand(options) {
       if (result.success) {
         anonymizedBlueprints++;
         if (!options.dryRun) {
-          console.log(chalk14.dim(`  \u2713 Anonymized: ${bp.name}`));
+          console.log(chalk15.dim(`  \u2713 Anonymized: ${bp.name}`));
         }
       }
     }
     console.log(
-      chalk14.green(
+      chalk15.green(
         `
 \u2705 Ready to push ${anonymizedFixes} fixes and ${anonymizedBlueprints} blueprints`
       )
     );
-    console.log(chalk14.dim("  (Registry push not yet implemented)"));
+    console.log(chalk15.dim("  (Registry push not yet implemented)"));
   }
   if (options.pull) {
-    console.log(chalk14.cyan("\n\u{1F4E5} Pulling patterns from registry...\n"));
-    console.log(chalk14.dim("  (Registry pull not yet implemented)"));
+    console.log(chalk15.cyan("\n\u{1F4E5} Pulling patterns from registry...\n"));
+    console.log(chalk15.dim("  (Registry pull not yet implemented)"));
   }
   if (!options.push && !options.pull) {
     console.log(
-      chalk14.dim("  Specify --push to upload or --pull to download patterns.\n")
+      chalk15.dim("  Specify --push to upload or --pull to download patterns.\n")
     );
   }
 }
 async function learnConfigCommand(options) {
   const cwd = getWorkspacePath();
   const contributorManager = new ContributorManager2(cwd);
-  console.log(chalk14.cyan("\n\u2699\uFE0F Learning Configuration\n"));
+  console.log(chalk15.cyan("\n\u2699\uFE0F Learning Configuration\n"));
   if (options.enableSync) {
     const result = await contributorManager.enableSync();
     if (result.success) {
-      console.log(chalk14.green("\u2705 Sync enabled"));
+      console.log(chalk15.green("\u2705 Sync enabled"));
       console.log(
-        chalk14.dim("  Your patterns will be anonymized before sharing.")
+        chalk15.dim("  Your patterns will be anonymized before sharing.")
       );
     } else {
-      console.log(chalk14.red(`\u274C Failed: ${result.error}`));
+      console.log(chalk15.red(`\u274C Failed: ${result.error}`));
     }
     return;
   }
   if (options.disableSync) {
     const result = await contributorManager.disableSync();
     if (result.success) {
-      console.log(chalk14.green("\u2705 Sync disabled"));
+      console.log(chalk15.green("\u2705 Sync disabled"));
     } else {
-      console.log(chalk14.red(`\u274C Failed: ${result.error}`));
+      console.log(chalk15.red(`\u274C Failed: ${result.error}`));
     }
     return;
   }
   if (options.enableTelemetry) {
     const result = await contributorManager.enableTelemetry();
     if (result.success) {
-      console.log(chalk14.green("\u2705 Telemetry enabled"));
+      console.log(chalk15.green("\u2705 Telemetry enabled"));
       console.log(
-        chalk14.dim(
+        chalk15.dim(
           "  Anonymous usage data helps improve pattern recommendations."
         )
       );
     } else {
-      console.log(chalk14.red(`\u274C Failed: ${result.error}`));
+      console.log(chalk15.red(`\u274C Failed: ${result.error}`));
     }
     return;
   }
   if (options.disableTelemetry) {
     const result = await contributorManager.disableTelemetry();
     if (result.success) {
-      console.log(chalk14.green("\u2705 Telemetry disabled"));
+      console.log(chalk15.green("\u2705 Telemetry disabled"));
     } else {
-      console.log(chalk14.red(`\u274C Failed: ${result.error}`));
+      console.log(chalk15.red(`\u274C Failed: ${result.error}`));
     }
     return;
   }
   if (options.resetId) {
-    const confirmed = await p10.confirm({
+    const confirmed = await p11.confirm({
       message: "Are you sure you want to reset your contributor ID? This cannot be undone.",
       initialValue: false
     });
-    if (p10.isCancel(confirmed) || !confirmed) {
-      p10.cancel("Reset cancelled");
+    if (p11.isCancel(confirmed) || !confirmed) {
+      p11.cancel("Reset cancelled");
       return;
     }
     const result = await contributorManager.resetId();
     if (result.success) {
-      console.log(chalk14.green("\u2705 Contributor ID reset"));
-      console.log(chalk14.dim(`  New ID: ${result.data?.id}`));
+      console.log(chalk15.green("\u2705 Contributor ID reset"));
+      console.log(chalk15.dim(`  New ID: ${result.data?.id}`));
     } else {
-      console.log(chalk14.red(`\u274C Failed: ${result.error}`));
+      console.log(chalk15.red(`\u274C Failed: ${result.error}`));
     }
     return;
   }
   const config = await contributorManager.getConfig();
   if (config.success && config.data) {
-    console.log(chalk14.white("  Current Settings:\n"));
-    console.log(chalk14.dim(`  Contributor ID: ${config.data.id}`));
-    console.log(chalk14.dim(`  Created: ${formatDate(config.data.createdAt)}`));
+    console.log(chalk15.white("  Current Settings:\n"));
+    console.log(chalk15.dim(`  Contributor ID: ${config.data.id}`));
+    console.log(chalk15.dim(`  Created: ${formatDate(config.data.createdAt)}`));
     console.log(
-      chalk14.dim(`  Sync Enabled: ${config.data.syncOptIn ? "Yes" : "No"}`)
+      chalk15.dim(`  Sync Enabled: ${config.data.syncOptIn ? "Yes" : "No"}`)
     );
     console.log(
-      chalk14.dim(
+      chalk15.dim(
         `  Telemetry Enabled: ${config.data.telemetryEnabled ? "Yes" : "No"}`
       )
     );
     if (config.data.syncEnabledAt) {
       console.log(
-        chalk14.dim(
+        chalk15.dim(
           `  Sync Enabled At: ${formatDate(config.data.syncEnabledAt)}`
         )
       );
     }
   } else {
     console.log(
-      chalk14.dim(
+      chalk15.dim(
         "  No configuration found. Settings will be created on first use.\n"
       )
     );
@@ -5236,7 +5405,7 @@ async function learnConfigCommand(options) {
 async function learnDeprecateCommand(patternId, reason) {
   const cwd = getWorkspacePath();
   const store = new PatternStore2(cwd);
-  console.log(chalk14.cyan("\n\u26A0\uFE0F Deprecate Pattern\n"));
+  console.log(chalk15.cyan("\n\u26A0\uFE0F Deprecate Pattern\n"));
   let patternType = "fix";
   let pattern = await store.getFixPattern(patternId);
   if (!pattern.success || !pattern.data) {
@@ -5245,26 +5414,26 @@ async function learnDeprecateCommand(patternId, reason) {
       pattern = bpResult;
       patternType = "blueprint";
     } else {
-      console.log(chalk14.red(`
+      console.log(chalk15.red(`
 \u274C Pattern not found: ${patternId}`));
       process.exit(1);
     }
   }
-  console.log(chalk14.white(`  Pattern: ${pattern.data.name}`));
-  console.log(chalk14.dim(`  Reason: ${reason}`));
-  const confirmed = await p10.confirm({
+  console.log(chalk15.white(`  Pattern: ${pattern.data.name}`));
+  console.log(chalk15.dim(`  Reason: ${reason}`));
+  const confirmed = await p11.confirm({
     message: "Are you sure you want to deprecate this pattern?",
     initialValue: false
   });
-  if (p10.isCancel(confirmed) || !confirmed) {
-    p10.cancel("Deprecation cancelled");
+  if (p11.isCancel(confirmed) || !confirmed) {
+    p11.cancel("Deprecation cancelled");
     return;
   }
   const result = await store.deprecatePattern(patternId, patternType, reason);
   if (result.success) {
-    console.log(chalk14.green("\n\u2705 Pattern deprecated successfully"));
+    console.log(chalk15.green("\n\u2705 Pattern deprecated successfully"));
   } else {
-    console.log(chalk14.red(`
+    console.log(chalk15.red(`
 \u274C Failed: ${result.error}`));
     process.exit(1);
   }
@@ -5273,32 +5442,32 @@ async function learnStatsCommand() {
   const cwd = getWorkspacePath();
   const store = new PatternStore2(cwd);
   const telemetry = new TelemetryCollector2(cwd);
-  console.log(chalk14.cyan("\n\u{1F4CA} Learning Statistics\n"));
+  console.log(chalk15.cyan("\n\u{1F4CA} Learning Statistics\n"));
   const storeStats = await store.getStats();
   const totalPatterns = storeStats.totalFixes + storeStats.totalBlueprints;
   const totalDeprecated = storeStats.deprecatedFixes + storeStats.deprecatedBlueprints;
-  console.log(chalk14.bold.white("  Patterns:\n"));
-  console.log(chalk14.dim(`    Total: ${totalPatterns}`));
-  console.log(chalk14.dim(`    Fix Patterns: ${storeStats.totalFixes}`));
-  console.log(chalk14.dim(`    Blueprints: ${storeStats.totalBlueprints}`));
-  console.log(chalk14.dim(`    Deprecated: ${totalDeprecated}`));
+  console.log(chalk15.bold.white("  Patterns:\n"));
+  console.log(chalk15.dim(`    Total: ${totalPatterns}`));
+  console.log(chalk15.dim(`    Fix Patterns: ${storeStats.totalFixes}`));
+  console.log(chalk15.dim(`    Blueprints: ${storeStats.totalBlueprints}`));
+  console.log(chalk15.dim(`    Deprecated: ${totalDeprecated}`));
   const telemetryStats = await telemetry.getStats();
-  console.log(chalk14.bold.white("\n  Telemetry:\n"));
-  console.log(chalk14.dim(`    Pending Events: ${telemetryStats.pendingEvents}`));
+  console.log(chalk15.bold.white("\n  Telemetry:\n"));
+  console.log(chalk15.dim(`    Pending Events: ${telemetryStats.pendingEvents}`));
   console.log(
-    chalk14.dim(`    Total Events Sent: ${telemetryStats.totalEventsSent}`)
+    chalk15.dim(`    Total Events Sent: ${telemetryStats.totalEventsSent}`)
   );
   if (telemetryStats.lastFlushAt) {
     console.log(
-      chalk14.dim(`    Last Flush: ${formatDate(telemetryStats.lastFlushAt)}`)
+      chalk15.dim(`    Last Flush: ${formatDate(telemetryStats.lastFlushAt)}`)
     );
   }
   console.log("");
 }
 
 // src/cli/commands/solution.ts
-import chalk15 from "chalk";
-import * as p11 from "@clack/prompts";
+import chalk16 from "chalk";
+import * as p12 from "@clack/prompts";
 import * as path2 from "path";
 import {
   PatternStore as PatternStore3,
@@ -5340,10 +5509,10 @@ function truncate(str, maxLen) {
 async function solutionCaptureCommand(options) {
   const cwd = getWorkspacePath2();
   const store = new PatternStore3(cwd);
-  console.log(chalk15.cyan("\n\u{1F4E6} Capture Solution Pattern\n"));
+  console.log(chalk16.cyan("\n\u{1F4E6} Capture Solution Pattern\n"));
   let targetPath = options.path;
   if (!targetPath) {
-    const pathInput = await p11.text({
+    const pathInput = await p12.text({
       message: "Path to the solution directory:",
       placeholder: "./src/auth",
       validate: (val) => {
@@ -5351,8 +5520,8 @@ async function solutionCaptureCommand(options) {
         return void 0;
       }
     });
-    if (p11.isCancel(pathInput)) {
-      p11.cancel("Operation cancelled");
+    if (p12.isCancel(pathInput)) {
+      p12.cancel("Operation cancelled");
       process.exit(0);
     }
     targetPath = pathInput;
@@ -5360,7 +5529,7 @@ async function solutionCaptureCommand(options) {
   const absolutePath = path2.isAbsolute(targetPath) ? targetPath : path2.resolve(cwd, targetPath);
   let name = options.name;
   if (!name) {
-    const nameInput = await p11.text({
+    const nameInput = await p12.text({
       message: "Solution name:",
       placeholder: "JWT Authentication",
       validate: (val) => {
@@ -5368,15 +5537,15 @@ async function solutionCaptureCommand(options) {
         return void 0;
       }
     });
-    if (p11.isCancel(nameInput)) {
-      p11.cancel("Operation cancelled");
+    if (p12.isCancel(nameInput)) {
+      p12.cancel("Operation cancelled");
       process.exit(0);
     }
     name = nameInput;
   }
   let description = options.description;
   if (!description) {
-    const descInput = await p11.text({
+    const descInput = await p12.text({
       message: "Solution description:",
       placeholder: "Complete JWT-based authentication with refresh tokens",
       validate: (val) => {
@@ -5385,15 +5554,15 @@ async function solutionCaptureCommand(options) {
         return void 0;
       }
     });
-    if (p11.isCancel(descInput)) {
-      p11.cancel("Operation cancelled");
+    if (p12.isCancel(descInput)) {
+      p12.cancel("Operation cancelled");
       process.exit(0);
     }
     description = descInput;
   }
   let category = options.category;
   if (!category) {
-    const categoryChoice = await p11.select({
+    const categoryChoice = await p12.select({
       message: "Solution category:",
       options: [
         { value: "auth", label: "\u{1F510} Authentication" },
@@ -5412,8 +5581,8 @@ async function solutionCaptureCommand(options) {
         { value: "other", label: "\u{1F4E6} Other" }
       ]
     });
-    if (p11.isCancel(categoryChoice)) {
-      p11.cancel("Operation cancelled");
+    if (p12.isCancel(categoryChoice)) {
+      p12.cancel("Operation cancelled");
       process.exit(0);
     }
     category = categoryChoice;
@@ -5422,20 +5591,20 @@ async function solutionCaptureCommand(options) {
   if (options.keywords) {
     keywords = options.keywords.split(",").map((k) => k.trim());
   } else {
-    const keywordsInput = await p11.text({
+    const keywordsInput = await p12.text({
       message: "Keywords (comma-separated):",
       placeholder: "jwt, authentication, login, refresh-token"
     });
-    if (p11.isCancel(keywordsInput)) {
-      p11.cancel("Operation cancelled");
+    if (p12.isCancel(keywordsInput)) {
+      p12.cancel("Operation cancelled");
       process.exit(0);
     }
     if (keywordsInput) {
       keywords = keywordsInput.split(",").map((k) => k.trim());
     }
   }
-  const spinner9 = p11.spinner();
-  spinner9.start("Analyzing solution...");
+  const spinner10 = p12.spinner();
+  spinner10.start("Analyzing solution...");
   const analyzer = new CodeAnalyzer({
     anonymize: options.anonymize ?? false
   });
@@ -5447,38 +5616,38 @@ async function solutionCaptureCommand(options) {
       category,
       keywords
     );
-    spinner9.stop("Solution analyzed");
-    console.log(chalk15.green("\n\u2713 Solution captured successfully!\n"));
-    console.log(chalk15.dim("\u2500".repeat(50)));
-    console.log(`${chalk15.bold("Name:")} ${pattern.name}`);
+    spinner10.stop("Solution analyzed");
+    console.log(chalk16.green("\n\u2713 Solution captured successfully!\n"));
+    console.log(chalk16.dim("\u2500".repeat(50)));
+    console.log(`${chalk16.bold("Name:")} ${pattern.name}`);
     console.log(
-      `${chalk15.bold("Category:")} ${formatCategory(pattern.category)}`
+      `${chalk16.bold("Category:")} ${formatCategory(pattern.category)}`
     );
     console.log(
-      `${chalk15.bold("Files:")} ${pattern.implementation.files.length}`
+      `${chalk16.bold("Files:")} ${pattern.implementation.files.length}`
     );
     console.log(
-      `${chalk15.bold("Dependencies:")} ${pattern.implementation.dependencies.length}`
+      `${chalk16.bold("Dependencies:")} ${pattern.implementation.dependencies.length}`
     );
     console.log(
-      `${chalk15.bold("Framework:")} ${pattern.compatibility.framework || "generic"}`
+      `${chalk16.bold("Framework:")} ${pattern.compatibility.framework || "generic"}`
     );
-    console.log(chalk15.dim("\u2500".repeat(50)));
-    const confirm10 = await p11.confirm({
+    console.log(chalk16.dim("\u2500".repeat(50)));
+    const confirm10 = await p12.confirm({
       message: "Save this solution pattern?",
       initialValue: true
     });
-    if (p11.isCancel(confirm10) || !confirm10) {
-      p11.cancel("Solution not saved");
+    if (p12.isCancel(confirm10) || !confirm10) {
+      p12.cancel("Solution not saved");
       process.exit(0);
     }
     await store.saveSolution(pattern);
-    console.log(chalk15.green(`
+    console.log(chalk16.green(`
 \u2713 Solution saved with ID: ${pattern.id}
 `));
   } catch (error) {
-    spinner9.stop("Analysis failed");
-    console.error(chalk15.red(`
+    spinner10.stop("Analysis failed");
+    console.error(chalk16.red(`
 \u2717 Error: ${error.message}
 `));
     process.exit(1);
@@ -5487,7 +5656,7 @@ async function solutionCaptureCommand(options) {
 async function solutionSearchCommand(query, options) {
   const cwd = getWorkspacePath2();
   const store = new PatternStore3(cwd);
-  console.log(chalk15.cyan("\n\u{1F50D} Search Solution Patterns\n"));
+  console.log(chalk16.cyan("\n\u{1F50D} Search Solution Patterns\n"));
   const keywords = query.split(/\s+/).filter((k) => k.length > 0);
   const result = await store.searchSolutions(keywords, {
     category: options.category,
@@ -5495,39 +5664,39 @@ async function solutionSearchCommand(query, options) {
     limit: options.limit ?? 10
   });
   if (!result.success || !result.data) {
-    console.error(chalk15.red(`
+    console.error(chalk16.red(`
 \u2717 Search failed: ${result.error}
 `));
     return;
   }
   const solutions = result.data;
   if (solutions.length === 0) {
-    console.log(chalk15.yellow("No solutions found matching your query.\n"));
-    console.log(chalk15.dim("Try different keywords or fewer filters."));
+    console.log(chalk16.yellow("No solutions found matching your query.\n"));
+    console.log(chalk16.dim("Try different keywords or fewer filters."));
     return;
   }
-  console.log(chalk15.green(`Found ${solutions.length} solution(s):
+  console.log(chalk16.green(`Found ${solutions.length} solution(s):
 `));
-  console.log(chalk15.dim("\u2500".repeat(70)));
+  console.log(chalk16.dim("\u2500".repeat(70)));
   for (const solution of solutions) {
     console.log(
-      `${chalk15.bold(solution.name)} ${chalk15.dim(`(${solution.id.slice(0, 8)})`)}`
+      `${chalk16.bold(solution.name)} ${chalk16.dim(`(${solution.id.slice(0, 8)})`)}`
     );
     console.log(`  ${formatCategory(solution.category)}`);
-    console.log(`  ${chalk15.dim(truncate(solution.description, 60))}`);
+    console.log(`  ${chalk16.dim(truncate(solution.description, 60))}`);
     console.log(
       `  Files: ${solution.implementation.files.length} | Framework: ${solution.compatibility.framework || "generic"} | Uses: ${solution.metrics.applications}`
     );
-    console.log(chalk15.dim("\u2500".repeat(70)));
+    console.log(chalk16.dim("\u2500".repeat(70)));
   }
   console.log(
-    chalk15.dim("\nUse 'workflow solution:apply <id>' to apply a solution.")
+    chalk16.dim("\nUse 'workflow solution:apply <id>' to apply a solution.")
   );
 }
 async function solutionListCommand(options) {
   const cwd = getWorkspacePath2();
   const store = new PatternStore3(cwd);
-  console.log(chalk15.cyan("\n\u{1F4CB} Solution Patterns\n"));
+  console.log(chalk16.cyan("\n\u{1F4CB} Solution Patterns\n"));
   const result = await store.listSolutions({
     category: options.category,
     framework: options.framework,
@@ -5535,20 +5704,20 @@ async function solutionListCommand(options) {
     limit: options.limit ?? 20
   });
   if (!result.success || !result.data) {
-    console.error(chalk15.red(`
+    console.error(chalk16.red(`
 \u2717 List failed: ${result.error}
 `));
     return;
   }
   const solutions = result.data;
   if (solutions.length === 0) {
-    console.log(chalk15.yellow("No solutions found.\n"));
+    console.log(chalk16.yellow("No solutions found.\n"));
     console.log(
-      chalk15.dim("Use 'workflow solution:capture' to capture a solution.")
+      chalk16.dim("Use 'workflow solution:capture' to capture a solution.")
     );
     return;
   }
-  console.log(chalk15.green(`${solutions.length} solution(s):
+  console.log(chalk16.green(`${solutions.length} solution(s):
 `));
   const byCategory = /* @__PURE__ */ new Map();
   for (const solution of solutions) {
@@ -5557,24 +5726,24 @@ async function solutionListCommand(options) {
     byCategory.set(solution.category, list);
   }
   for (const [category, items] of byCategory) {
-    console.log(chalk15.bold(`
+    console.log(chalk16.bold(`
 ${formatCategory(category)}`));
-    console.log(chalk15.dim("\u2500".repeat(50)));
+    console.log(chalk16.dim("\u2500".repeat(50)));
     for (const solution of items) {
-      const deprecated = solution.deprecatedAt ? chalk15.red(" [DEPRECATED]") : "";
+      const deprecated = solution.deprecatedAt ? chalk16.red(" [DEPRECATED]") : "";
       console.log(
-        `  ${chalk15.cyan(solution.id.slice(0, 8))} ${solution.name}${deprecated}`
+        `  ${chalk16.cyan(solution.id.slice(0, 8))} ${solution.name}${deprecated}`
       );
-      console.log(`    ${chalk15.dim(truncate(solution.description, 50))}`);
+      console.log(`    ${chalk16.dim(truncate(solution.description, 50))}`);
       console.log(
-        chalk15.dim(
+        chalk16.dim(
           `    Created: ${formatDate2(solution.createdAt)} | Files: ${solution.implementation.files.length}`
         )
       );
     }
   }
   console.log(
-    chalk15.dim(
+    chalk16.dim(
       "\nUse 'workflow solution:search <query>' to find specific solutions."
     )
   );
@@ -5582,10 +5751,10 @@ ${formatCategory(category)}`));
 async function solutionApplyCommand(solutionId, options) {
   const cwd = getWorkspacePath2();
   const store = new PatternStore3(cwd);
-  console.log(chalk15.cyan("\n\u{1F680} Apply Solution Pattern\n"));
+  console.log(chalk16.cyan("\n\u{1F680} Apply Solution Pattern\n"));
   const result = await store.getSolution(solutionId);
   if (!result.success || !result.data) {
-    console.error(chalk15.red(`
+    console.error(chalk16.red(`
 \u2717 Solution not found: ${solutionId}
 `));
     process.exit(1);
@@ -5593,60 +5762,60 @@ async function solutionApplyCommand(solutionId, options) {
   const solution = result.data;
   if (solution.deprecatedAt) {
     console.log(
-      chalk15.yellow(
+      chalk16.yellow(
         `\u26A0\uFE0F  This solution is deprecated: ${solution.deprecationReason || "No reason provided"}
 `
       )
     );
-    const proceed = await p11.confirm({
+    const proceed = await p12.confirm({
       message: "Do you want to continue?",
       initialValue: false
     });
-    if (p11.isCancel(proceed) || !proceed) {
-      p11.cancel("Operation cancelled");
+    if (p12.isCancel(proceed) || !proceed) {
+      p12.cancel("Operation cancelled");
       process.exit(0);
     }
   }
-  console.log(chalk15.bold(`Solution: ${solution.name}`));
-  console.log(chalk15.dim(solution.description));
+  console.log(chalk16.bold(`Solution: ${solution.name}`));
+  console.log(chalk16.dim(solution.description));
   console.log();
-  console.log(chalk15.bold("Files to create:"));
+  console.log(chalk16.bold("Files to create:"));
   const filesToApply = options.includeTests ? solution.implementation.files : solution.implementation.files.filter(
     (f) => f.role !== "test"
   );
   for (const file of filesToApply) {
-    console.log(chalk15.dim(`  \u2022 ${file.path} (${file.role})`));
+    console.log(chalk16.dim(`  \u2022 ${file.path} (${file.role})`));
   }
   console.log();
   if (solution.implementation.dependencies.length > 0) {
-    console.log(chalk15.bold("Dependencies to install:"));
+    console.log(chalk16.bold("Dependencies to install:"));
     for (const dep of solution.implementation.dependencies) {
-      console.log(chalk15.dim(`  \u2022 ${dep.name}@${dep.version}`));
+      console.log(chalk16.dim(`  \u2022 ${dep.name}@${dep.version}`));
     }
     console.log();
   }
   if (solution.implementation.envVars.length > 0) {
-    console.log(chalk15.bold("Environment variables needed:"));
+    console.log(chalk16.bold("Environment variables needed:"));
     for (const env of solution.implementation.envVars) {
-      const required = env.required ? chalk15.red("*") : "";
-      console.log(chalk15.dim(`  \u2022 ${env.name}${required}`));
+      const required = env.required ? chalk16.red("*") : "";
+      console.log(chalk16.dim(`  \u2022 ${env.name}${required}`));
     }
     console.log();
   }
   if (options.dryRun) {
-    console.log(chalk15.yellow("Dry run mode - no files were created.\n"));
+    console.log(chalk16.yellow("Dry run mode - no files were created.\n"));
     return;
   }
-  const confirm10 = await p11.confirm({
+  const confirm10 = await p12.confirm({
     message: "Apply this solution?",
     initialValue: true
   });
-  if (p11.isCancel(confirm10) || !confirm10) {
-    p11.cancel("Operation cancelled");
+  if (p12.isCancel(confirm10) || !confirm10) {
+    p12.cancel("Operation cancelled");
     process.exit(0);
   }
-  const spinner9 = p11.spinner();
-  spinner9.start("Applying solution...");
+  const spinner10 = p12.spinner();
+  spinner10.start("Applying solution...");
   try {
     const outputDir = options.output || cwd;
     const fs2 = await import("fs");
@@ -5658,20 +5827,20 @@ async function solutionApplyCommand(solutionId, options) {
       await fs2.promises.writeFile(filePath, file.content);
     }
     await store.updateSolutionMetrics(solution.id, true);
-    spinner9.stop("Solution applied");
-    console.log(chalk15.green(`
+    spinner10.stop("Solution applied");
+    console.log(chalk16.green(`
 \u2713 Solution applied successfully!
 `));
-    console.log(chalk15.dim(`Created ${filesToApply.length} file(s).`));
+    console.log(chalk16.dim(`Created ${filesToApply.length} file(s).`));
     if (solution.implementation.dependencies.length > 0) {
-      console.log(chalk15.cyan("\nNext step: Install dependencies with:"));
+      console.log(chalk16.cyan("\nNext step: Install dependencies with:"));
       const deps = solution.implementation.dependencies.map((d) => `${d.name}@${d.version}`).join(" ");
-      console.log(chalk15.dim(`  npm install ${deps}`));
+      console.log(chalk16.dim(`  npm install ${deps}`));
     }
   } catch (error) {
-    spinner9.stop("Application failed");
+    spinner10.stop("Application failed");
     await store.updateSolutionMetrics(solution.id, false);
-    console.error(chalk15.red(`
+    console.error(chalk16.red(`
 \u2717 Error: ${error.message}
 `));
     process.exit(1);
@@ -5680,48 +5849,48 @@ async function solutionApplyCommand(solutionId, options) {
 async function solutionDeprecateCommand(solutionId, reason) {
   const cwd = getWorkspacePath2();
   const store = new PatternStore3(cwd);
-  console.log(chalk15.cyan("\n\u26A0\uFE0F  Deprecate Solution Pattern\n"));
+  console.log(chalk16.cyan("\n\u26A0\uFE0F  Deprecate Solution Pattern\n"));
   const result = await store.getSolution(solutionId);
   if (!result.success || !result.data) {
-    console.error(chalk15.red(`
+    console.error(chalk16.red(`
 \u2717 Solution not found: ${solutionId}
 `));
     process.exit(1);
   }
   const solution = result.data;
-  console.log(`Solution: ${chalk15.bold(solution.name)}`);
+  console.log(`Solution: ${chalk16.bold(solution.name)}`);
   console.log(`Reason: ${reason}
 `);
-  const confirm10 = await p11.confirm({
+  const confirm10 = await p12.confirm({
     message: "Deprecate this solution?",
     initialValue: false
   });
-  if (p11.isCancel(confirm10) || !confirm10) {
-    p11.cancel("Operation cancelled");
+  if (p12.isCancel(confirm10) || !confirm10) {
+    p12.cancel("Operation cancelled");
     process.exit(0);
   }
   await store.deprecateSolution(solutionId, reason);
-  console.log(chalk15.green(`
+  console.log(chalk16.green(`
 \u2713 Solution deprecated.
 `));
 }
 async function solutionStatsCommand() {
   const cwd = getWorkspacePath2();
   const store = new PatternStore3(cwd);
-  console.log(chalk15.cyan("\n\u{1F4CA} Solution Pattern Statistics\n"));
+  console.log(chalk16.cyan("\n\u{1F4CA} Solution Pattern Statistics\n"));
   const stats = await store.getStats();
-  console.log(chalk15.dim("\u2500".repeat(40)));
-  console.log(`${chalk15.bold("Solutions:")} ${stats.totalSolutions}`);
+  console.log(chalk16.dim("\u2500".repeat(40)));
+  console.log(`${chalk16.bold("Solutions:")} ${stats.totalSolutions}`);
   console.log(`  Active: ${stats.totalSolutions - stats.deprecatedSolutions}`);
   console.log(`  Deprecated: ${stats.deprecatedSolutions}`);
   console.log(`  Private: ${stats.privateSolutions}`);
   console.log(`  Synced: ${stats.syncedSolutions}`);
-  console.log(chalk15.dim("\u2500".repeat(40)));
-  console.log(`${chalk15.bold("Fixes:")} ${stats.totalFixes}`);
-  console.log(`${chalk15.bold("Blueprints:")} ${stats.totalBlueprints}`);
-  console.log(chalk15.dim("\u2500".repeat(40)));
+  console.log(chalk16.dim("\u2500".repeat(40)));
+  console.log(`${chalk16.bold("Fixes:")} ${stats.totalFixes}`);
+  console.log(`${chalk16.bold("Blueprints:")} ${stats.totalBlueprints}`);
+  console.log(chalk16.dim("\u2500".repeat(40)));
   console.log(`
-${chalk15.bold("By Category:")}`);
+${chalk16.bold("By Category:")}`);
   const listResult = await store.listSolutions({ limit: 1e3 });
   if (listResult.success && listResult.data) {
     const categories = /* @__PURE__ */ new Map();
@@ -5774,6 +5943,15 @@ program.command("advisory").description("Generate advisory board analysis and do
 ).option("--timestamp", "Append timestamp to filenames").option("--include-health", "Include code health metrics from verify/doctor").option("--ci", "CI mode with exit codes on high-risk findings").option("--compare <path>", "Compare with previous report").action(advisoryCommand);
 program.command("generate-instructions").description("Generate .github/copilot-instructions.md from guidelines").option("--force", "Regenerate without confirmation").action(generateInstructionsCommand);
 program.command("update-templates").description("Update guideline templates from the latest package version").option("--force", "Overwrite existing template files").option("--skip", "Skip the update (useful in CI)").action(updateTemplatesCommand);
+program.command("docs:validate").description("Validate document references in markdown files").option("--fix", "Interactively fix broken references").option("--patterns <patterns>", "Glob patterns to scan (comma-separated, default: **/*.md)").option("--ignore <patterns>", "Glob patterns to ignore (comma-separated)").action((options) => {
+  const patterns = options.patterns ? options.patterns.split(",").map((p13) => p13.trim()) : void 0;
+  const ignore = options.ignore ? options.ignore.split(",").map((p13) => p13.trim()) : void 0;
+  return docsValidateCommand({
+    fix: options.fix,
+    patterns,
+    ignore
+  });
+});
 program.command("learn:record").description("Record a new pattern from a successful implementation").option("--name <name>", "Pattern name").option("--description <desc>", "Pattern description").option(
   "--category <cat>",
   "Category (migration, security, performance, etc.)"