workflow-agent-cli 2.22.11 → 2.23.1

package/dist/cli/index.js

@@ -1,23 +1,16 @@
 #!/usr/bin/env node
-import {
-  analyzeProject,
-  detectPackageManager,
-  generateAuditReport,
-  isMonorepo,
-  runAllSetups
-} from "../chunk-XGS2VFBP.js";
 import {
   applyReferenceFix,
   validateBranchName,
   validateCommitMessage,
   validateDocumentReferences,
   validatePRTitle
-} from "../chunk-ZLDJ2OGO.js";
+} from "../chunk-WK7D2AVV.js";
 import {
   hasConfig,
   loadConfig,
   loadConfigSafe
-} from "../chunk-UWJ2ZGEI.js";
+} from "../chunk-OH6TK27N.js";
 import {
   DEPRECATED_SCRIPTS,
   WORKFLOW_SCRIPTS,
@@ -29,25 +22,31 @@ import {
   templateMetadata,
   updateTemplates,
   validateAllScripts
-} from "../chunk-IWFUJ2DS.js";
+} from "../chunk-DWHIY7R4.js";
 import {
   autoFixConfigFile,
   validateScopeDefinitions
-} from "../chunk-YELUGXOM.js";
+} from "../chunk-NPJJZHJG.js";
 import {
   verifyCommand
-} from "../chunk-D36IFZUZ.js";
-import "../chunk-3ADL5QDN.js";
+} from "../chunk-PLVOGB6Y.js";
+import {
+  analyzeProject,
+  detectPackageManager,
+  generateAuditReport,
+  isMonorepo,
+  runAllSetups
+} from "../chunk-KJFRMHQU.js";
 import {
   syncCommand
-} from "../chunk-MMPXQG3O.js";
+} from "../chunk-K42R54II.js";
 
 // src/cli/index.ts
 import { Command as Command7 } from "commander";
-import chalk23 from "chalk";
+import chalk24 from "chalk";
 import { readFileSync as readFileSync3 } from "fs";
 import { fileURLToPath as fileURLToPath4 } from "url";
-import { dirname as dirname5, join as join12 } from "path";
+import { dirname as dirname5, join as join13 } from "path";
 
 // src/cli/commands/init.ts
 import * as p from "@clack/prompts";
@@ -813,11 +812,19 @@ async function doctorCommand(options) {
     for (const issue of result.issues) {
       console.log(chalk5.red(`  \u2717 ${issue.path}: ${issue.message}`));
       if (issue.currentValue !== void 0) {
-        console.log(chalk5.dim(`    Current value: ${JSON.stringify(issue.currentValue)}`));
+        console.log(
+          chalk5.dim(`    Current value: ${JSON.stringify(issue.currentValue)}`)
+        );
       }
       if (issue.suggestedFix) {
-        console.log(chalk5.green(`    Suggested fix: ${issue.suggestedFix.description}`));
-        console.log(chalk5.dim(`    New value: ${JSON.stringify(issue.suggestedFix.newValue)}`));
+        console.log(
+          chalk5.green(`    Suggested fix: ${issue.suggestedFix.description}`)
+        );
+        console.log(
+          chalk5.dim(
+            `    New value: ${JSON.stringify(issue.suggestedFix.newValue)}`
+          )
+        );
       }
     }
     const hasAutoFixes = result.issues.some((i) => i.suggestedFix);
@@ -830,7 +837,9 @@ async function doctorCommand(options) {
           for (const change of fixResult.changes) {
             console.log(chalk5.dim(`  \u2022 ${change}`));
           }
-          console.log(chalk5.cyan("\n  Run 'workflow doctor' again to verify.\n"));
+          console.log(
+            chalk5.cyan("\n  Run 'workflow doctor' again to verify.\n")
+          );
           process.exit(0);
         } else {
           console.log(chalk5.red(`\u2717 Auto-fix failed: ${fixResult.error}`));
@@ -865,15 +874,15 @@ async function doctorCommand(options) {
   }
   if (missingFiles.length === 0) {
     console.log(
-      chalk5.green(`
-\u2713 All ${mandatoryFiles.length} mandatory guidelines present`)
+      chalk5.green(
+        `
+\u2713 All ${mandatoryFiles.length} mandatory guidelines present`
+      )
     );
   } else {
     console.log(
-      chalk5.red(
-        `
-\u2717 Missing ${missingFiles.length} mandatory guideline(s)`
-      )
+      chalk5.red(`
+\u2717 Missing ${missingFiles.length} mandatory guideline(s)`)
     );
   }
   if (options?.checkGuidelinesOnly) {
@@ -899,7 +908,11 @@ async function doctorCommand(options) {
       }
     } catch (error) {
       console.log(chalk5.yellow("\u26A0 Could not check hooks status"));
-      console.log(chalk5.dim(`  ${error instanceof Error ? error.message : "Unknown error"}`));
+      console.log(
+        chalk5.dim(
+          `  ${error instanceof Error ? error.message : "Unknown error"}`
+        )
+      );
     }
   }
   if (missingFiles.length > 0) {
@@ -960,9 +973,7 @@ async function setupCommand() {
   }
   const hasChanges = scriptAdded || scriptUpdated || removedScripts.length > 0;
   if (!hasChanges) {
-    p3.outro(
-      chalk6.green(`\u2713 Workflow script is already configured!`)
-    );
+    p3.outro(chalk6.green(`\u2713 Workflow script is already configured!`));
     return;
   }
   writeFileSync(
@@ -983,8 +994,10 @@ async function setupCommand() {
   }
   if (removedScripts.length > 0) {
     console.log(
-      chalk6.yellow(`
-  \u26A0\uFE0F  Removed ${removedScripts.length} deprecated scripts`)
+      chalk6.yellow(
+        `
+  \u26A0\uFE0F  Removed ${removedScripts.length} deprecated scripts`
+      )
     );
     console.log(
       chalk6.dim(
@@ -1186,7 +1199,9 @@ function formatAuditReportColored(report) {
 
 // src/cli/commands/setup/index.ts
 function createSetupCommand() {
-  const setupCmd = new Command("setup").description("Setup and configuration commands");
+  const setupCmd = new Command("setup").description(
+    "Setup and configuration commands"
+  );
   setupCmd.action(setupCommand);
   setupCmd.command("scripts").description("Add workflow scripts to package.json").action(setupCommand);
   setupCmd.command("auto").description("Automatically configure linting, formatting, testing, and CI").option("-y, --yes", "Auto-approve all prompts").option("--audit", "Show audit report without applying changes").action(autoSetupCommand);
@@ -1973,13 +1988,19 @@ async function docsValidateCommand(options) {
       console.log(chalk11.dim(`    ${broken.rawLink}`));
       console.log(chalk11.dim(`    Target: ${broken.targetPath}`));
       if (broken.suggestions.length > 0) {
-        console.log(chalk11.dim(`    Suggestions: ${broken.suggestions.slice(0, 3).join(", ")}`));
+        console.log(
+          chalk11.dim(
+            `    Suggestions: ${broken.suggestions.slice(0, 3).join(", ")}`
+          )
+        );
       }
       console.log("");
     }
     if (!fix) {
       console.log(
-        chalk11.yellow("\u{1F4A1} Run with --fix flag to interactively fix broken references")
+        chalk11.yellow(
+          "\u{1F4A1} Run with --fix flag to interactively fix broken references"
+        )
       );
       p7.outro(chalk11.red("Validation failed"));
       process.exit(1);
@@ -2055,7 +2076,9 @@ Fixed: ${fixedCount}, Skipped: ${skippedCount}`)
       }
       try {
         await applyReferenceFix(broken.file, broken.rawLink, newPath);
-        console.log(chalk11.green(`  \u2705 Fixed: ${broken.targetPath} \u2192 ${newPath}`));
+        console.log(
+          chalk11.green(`  \u2705 Fixed: ${broken.targetPath} \u2192 ${newPath}`)
+        );
         fixedCount++;
       } catch (error) {
         console.log(
@@ -2128,7 +2151,9 @@ async function docsGenerateCommand(options) {
         )
       );
       if (result.preservedCustomContent) {
-        console.log(chalk12.dim("  Custom content between markers was preserved."));
+        console.log(
+          chalk12.dim("  Custom content between markers was preserved.")
+        );
       }
       console.log(chalk12.dim(`
   Output: ${result.filePath}`));
@@ -2155,9 +2180,13 @@ Reason: ${error instanceof Error ? error.message : String(error)}`
   p8.outro(chalk12.green("\u2713 AI agent instructions ready!"));
   console.log(chalk12.dim("\nThe .github/copilot-instructions.md file:"));
   console.log(chalk12.dim("  - Is read by GitHub Copilot and other AI agents"));
-  console.log(chalk12.dim("  - Summarizes all guidelines with links to full docs"));
+  console.log(
+    chalk12.dim("  - Summarizes all guidelines with links to full docs")
+  );
   console.log(chalk12.dim("  - Includes your project scopes and conventions"));
-  console.log(chalk12.dim("  - Preserves custom instructions you add between markers\n"));
+  console.log(
+    chalk12.dim("  - Preserves custom instructions you add between markers\n")
+  );
 }
 
 // src/cli/commands/docs/update.ts
@@ -2198,9 +2227,7 @@ async function docsUpdateCommand(options) {
       console.log(chalk13.dim(`      ${meta.description}`));
     }
   }
-  const optionalFiles = allTemplates.filter(
-    (f) => !mandatoryFiles.includes(f)
-  );
+  const optionalFiles = allTemplates.filter((f) => !mandatoryFiles.includes(f));
   if (optionalFiles.length > 0) {
     console.log(chalk13.bold("\n  Optional templates:"));
     for (const file of optionalFiles) {
@@ -4094,7 +4121,7 @@ async function advisoryCommand(options) {
   const analyzer = new AdvisoryAnalyzer({
     depth,
     cwd,
-    config,
+    config: config ?? void 0,
     includeHealth,
     excludePatterns: advisoryConfig?.excludePatterns
   });
@@ -5004,7 +5031,13 @@ ${chalk15.bold("Examples:")}
   docsCmd.command("advisory").description("Generate advisory board analysis and documentation").option(
     "--depth <level>",
     "Analysis depth: executive, quick, standard, comprehensive"
-  ).option("--output <path>", "Output directory (default: docs/advisory)").option("--interactive", "Enable interactive mode").option("--dry-run", "Preview analysis without writing files").option("--format <type>", "Output format: markdown, json (default: markdown)").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").addHelpText(
+  ).option("--output <path>", "Output directory (default: docs/advisory)").option("--interactive", "Enable interactive mode").option("--dry-run", "Preview analysis without writing files").option(
+    "--format <type>",
+    "Output format: markdown, json (default: markdown)"
+  ).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").addHelpText(
     "after",
     `
 ${chalk15.bold("Examples:")}
@@ -5152,10 +5185,10 @@ async function statusAction() {
 async function testAction(options) {
   console.log(chalk17.bold.cyan("\n\u{1F9EA} Testing Git Hooks\n"));
   const fs3 = await import("fs");
-  const path4 = await import("path");
+  const path5 = await import("path");
   const cwd = process.cwd();
-  const gitDir = path4.join(cwd, ".git");
-  const hooksDir = path4.join(gitDir, "hooks");
+  const gitDir = path5.join(cwd, ".git");
+  const hooksDir = path5.join(gitDir, "hooks");
   if (!fs3.existsSync(gitDir)) {
     console.log(chalk17.red("\u2717 Not a git repository"));
     process.exit(1);
@@ -5168,14 +5201,18 @@ async function testAction(options) {
   const hookTypes = ["pre-commit", "commit-msg"];
   let allInstalled = true;
   for (const hookType of hookTypes) {
-    const hookPath = path4.join(hooksDir, hookType);
+    const hookPath = path5.join(hooksDir, hookType);
     const exists = fs3.existsSync(hookPath);
     const isExecutable = exists && (fs3.statSync(hookPath).mode & 73) !== 0;
     const isWorkflowHook2 = exists && fs3.readFileSync(hookPath, "utf-8").toLowerCase().includes("workflow");
     if (exists && isExecutable && isWorkflowHook2) {
       console.log(chalk17.green(`  \u2713 ${hookType} - installed and executable`));
     } else if (exists && !isWorkflowHook2) {
-      console.log(chalk17.yellow(`  \u26A0 ${hookType} - exists but not managed by workflow-agent`));
+      console.log(
+        chalk17.yellow(
+          `  \u26A0 ${hookType} - exists but not managed by workflow-agent`
+        )
+      );
       allInstalled = false;
     } else if (exists && !isExecutable) {
       console.log(chalk17.red(`  \u2717 ${hookType} - exists but not executable`));
@@ -5188,7 +5225,7 @@ async function testAction(options) {
   if (options.dryRun) {
     console.log(chalk17.bold.cyan("\n  Dry-run hook simulation:\n"));
     console.log(chalk17.dim("  Simulating pre-commit hook..."));
-    const { verifyCommand: verifyCommand2 } = await import("../verify-TX6LFMI6.js");
+    const { verifyCommand: verifyCommand2 } = await import("../verify-OIHY7SGG.js");
     try {
       await verifyCommand2({ fix: false, dryRun: true, maxRetries: "1" });
     } catch {
@@ -5446,14 +5483,20 @@ async function solutionCaptureCommand(options) {
     }
     const saveResult = await store.saveSolution(pattern);
     if (!saveResult.success) {
-      console.error(chalk18.red(`
+      console.error(
+        chalk18.red(`
 \u2717 Failed to save solution: ${saveResult.error}
-`));
+`)
+      );
       process.exit(1);
     }
-    console.log(chalk18.green(`
+    console.log(
+      chalk18.green(
+        `
 \u2713 Solution saved: .workflow/patterns/solutions/${pattern.id}.json
-`));
+`
+      )
+    );
   } catch (error) {
     spinner10.stop("Analysis failed");
     console.error(chalk18.red(`
@@ -5801,12 +5844,13 @@ async function solutionCreateCommand(options) {
     name,
     description,
     category,
-    tags: keywords.map((k) => ({ name: k, category })),
+    tags: keywords.map((k) => ({
+      name: k,
+      category: "custom"
+    })),
     problem: {
       description,
       keywords,
-      symptoms: [],
-      impact: "To be documented",
       errorPatterns: []
     },
     implementation: {
@@ -5851,17 +5895,23 @@ async function solutionCreateCommand(options) {
   };
   const saveResult = await store.saveSolution(solution);
   if (!saveResult.success) {
-    console.error(chalk18.red(`
+    console.error(
+      chalk18.red(`
 \u2717 Failed to save solution: ${saveResult.error}
-`));
+`)
+    );
     process.exit(1);
   }
   console.log(chalk18.green("\n\u2713 Solution pattern created!\n"));
-  console.log(chalk18.dim(`  Path: .workflow/patterns/solutions/${solution.id}.json`));
+  console.log(
+    chalk18.dim(`  Path: .workflow/patterns/solutions/${solution.id}.json`)
+  );
   console.log(chalk18.dim(`  Name: ${name}`));
   console.log(chalk18.dim(`  Category: ${category}`));
-  console.log(chalk18.dim(`
-Add files using 'workflow solution capture --path <dir>'`));
+  console.log(
+    chalk18.dim(`
+Add files using 'workflow solution capture --path <dir>'`)
+  );
 }
 async function solutionShowCommand(solutionId) {
   const cwd = getWorkspacePath();
@@ -5885,20 +5935,26 @@ async function solutionShowCommand(solutionId) {
   console.log(chalk18.bold("\nCompatibility:"));
   console.log(`  Framework: ${solution.compatibility.framework || "generic"}`);
   console.log(`  Version: ${solution.compatibility.frameworkVersion}`);
-  console.log(`  Runtime: ${solution.compatibility.runtime} ${solution.compatibility.runtimeVersion}`);
+  console.log(
+    `  Runtime: ${solution.compatibility.runtime} ${solution.compatibility.runtimeVersion}`
+  );
   console.log(chalk18.bold("\nImplementation:"));
   console.log(`  Files: ${solution.implementation.files.length}`);
   for (const file of solution.implementation.files) {
     console.log(chalk18.dim(`    \u2022 ${file.path} (${file.role})`));
   }
   if (solution.implementation.dependencies.length > 0) {
-    console.log(`  Dependencies: ${solution.implementation.dependencies.length}`);
+    console.log(
+      `  Dependencies: ${solution.implementation.dependencies.length}`
+    );
     for (const dep of solution.implementation.dependencies) {
       console.log(chalk18.dim(`    \u2022 ${dep.name}@${dep.version}`));
     }
   }
   if (solution.implementation.envVars.length > 0) {
-    console.log(`  Environment Variables: ${solution.implementation.envVars.length}`);
+    console.log(
+      `  Environment Variables: ${solution.implementation.envVars.length}`
+    );
     for (const env of solution.implementation.envVars) {
       const required = env.required ? chalk18.red("*") : "";
       console.log(chalk18.dim(`    \u2022 ${env.name}${required}`));
@@ -5906,14 +5962,22 @@ async function solutionShowCommand(solutionId) {
   }
   console.log(chalk18.bold("\nMetrics:"));
   console.log(`  Applications: ${solution.metrics.applications}`);
-  console.log(`  Success Rate: ${(solution.metrics.successRate * 100).toFixed(1)}%`);
+  console.log(
+    `  Success Rate: ${(solution.metrics.successRate * 100).toFixed(1)}%`
+  );
   console.log(chalk18.bold("\nMetadata:"));
   console.log(`  Created: ${formatDate(solution.createdAt)}`);
   console.log(`  Updated: ${formatDate(solution.updatedAt)}`);
   console.log(`  Private: ${solution.isPrivate ? "Yes" : "No"}`);
   if (solution.deprecatedAt) {
-    console.log(chalk18.red(`  Deprecated: ${formatDate(solution.deprecatedAt)}`));
-    console.log(chalk18.dim(`    Reason: ${solution.deprecationReason || "No reason provided"}`));
+    console.log(
+      chalk18.red(`  Deprecated: ${formatDate(solution.deprecatedAt)}`)
+    );
+    console.log(
+      chalk18.dim(
+        `    Reason: ${solution.deprecationReason || "No reason provided"}`
+      )
+    );
   }
   console.log();
 }
@@ -5995,7 +6059,9 @@ async function solutionImportCommand(file, options) {
   let importData;
   try {
     if (file.endsWith(".yaml") || file.endsWith(".yml")) {
-      console.log(chalk18.yellow("  YAML import not fully supported, treating as JSON"));
+      console.log(
+        chalk18.yellow("  YAML import not fully supported, treating as JSON")
+      );
     }
     importData = JSON.parse(content);
   } catch {
@@ -6012,7 +6078,9 @@ async function solutionImportCommand(file, options) {
   if (dryRun) {
     console.log(chalk18.yellow("  \u{1F50D} Dry run - no changes will be made\n"));
     for (const solution of solutions) {
-      console.log(chalk18.dim(`    Would import: ${solution.name} (${solution.id})`));
+      console.log(
+        chalk18.dim(`    Would import: ${solution.name} (${solution.id})`)
+      );
     }
     return;
   }
@@ -6027,7 +6095,11 @@ async function solutionImportCommand(file, options) {
     }
     const saveResult = await store.saveSolution(solution);
     if (!saveResult.success) {
-      console.log(chalk18.red(`    \u2717 Failed to import: ${solution.name} - ${saveResult.error}`));
+      console.log(
+        chalk18.red(
+          `    \u2717 Failed to import: ${solution.name} - ${saveResult.error}`
+        )
+      );
       continue;
     }
     console.log(chalk18.green(`    \u2713 Imported: ${solution.name}`));
@@ -6046,21 +6118,83 @@ async function solutionAnalyzeCommand() {
   const pathModule = await import("path");
   console.log(chalk18.cyan("\n\u{1F50D} Analyzing Codebase for Solution Patterns\n"));
   const existingResult = await store.listSolutions({ limit: 1e3 });
-  const existingNames = (existingResult.data || []).map((s) => s.name.toLowerCase());
+  const existingNames = (existingResult.data || []).map(
+    (s) => s.name.toLowerCase()
+  );
   const opportunities = [];
   const patterns = [
-    { path: "src/auth", name: "Authentication Module", category: "auth", desc: "Authentication implementation" },
-    { path: "src/lib/auth", name: "Auth Library", category: "auth", desc: "Authentication utilities" },
-    { path: "src/api", name: "API Layer", category: "api", desc: "API routing structure" },
-    { path: "app/api", name: "Next.js API Routes", category: "api", desc: "Next.js API implementation" },
-    { path: "src/db", name: "Database Layer", category: "database", desc: "Database connection and queries" },
-    { path: "src/lib/db", name: "Database Utilities", category: "database", desc: "Database helper functions" },
-    { path: "src/components/ui", name: "UI Components", category: "ui", desc: "Reusable UI components" },
-    { path: "src/hooks", name: "Custom Hooks", category: "ui", desc: "React custom hooks" },
-    { path: "__tests__", name: "Testing Setup", category: "testing", desc: "Test configuration and utilities" },
-    { path: ".github/workflows", name: "CI/CD Pipeline", category: "deployment", desc: "GitHub Actions workflows" },
-    { path: "src/integrations", name: "Integrations", category: "integrations", desc: "Third-party integrations" },
-    { path: "src/middleware", name: "Middleware", category: "security", desc: "Request middleware and guards" }
+    {
+      path: "src/auth",
+      name: "Authentication Module",
+      category: "auth",
+      desc: "Authentication implementation"
+    },
+    {
+      path: "src/lib/auth",
+      name: "Auth Library",
+      category: "auth",
+      desc: "Authentication utilities"
+    },
+    {
+      path: "src/api",
+      name: "API Layer",
+      category: "api",
+      desc: "API routing structure"
+    },
+    {
+      path: "app/api",
+      name: "Next.js API Routes",
+      category: "api",
+      desc: "Next.js API implementation"
+    },
+    {
+      path: "src/db",
+      name: "Database Layer",
+      category: "database",
+      desc: "Database connection and queries"
+    },
+    {
+      path: "src/lib/db",
+      name: "Database Utilities",
+      category: "database",
+      desc: "Database helper functions"
+    },
+    {
+      path: "src/components/ui",
+      name: "UI Components",
+      category: "ui",
+      desc: "Reusable UI components"
+    },
+    {
+      path: "src/hooks",
+      name: "Custom Hooks",
+      category: "ui",
+      desc: "React custom hooks"
+    },
+    {
+      path: "__tests__",
+      name: "Testing Setup",
+      category: "testing",
+      desc: "Test configuration and utilities"
+    },
+    {
+      path: ".github/workflows",
+      name: "CI/CD Pipeline",
+      category: "deployment",
+      desc: "GitHub Actions workflows"
+    },
+    {
+      path: "src/integrations",
+      name: "Integrations",
+      category: "integrations",
+      desc: "Third-party integrations"
+    },
+    {
+      path: "src/middleware",
+      name: "Middleware",
+      category: "security",
+      desc: "Request middleware and guards"
+    }
   ];
   for (const pattern of patterns) {
     const fullPath = pathModule.default.join(cwd, pattern.path);
@@ -6078,8 +6212,10 @@ async function solutionAnalyzeCommand() {
     console.log(chalk18.dim("\n  Your solutions seem well-captured!"));
     return;
   }
-  console.log(chalk18.bold(`  Found ${opportunities.length} potential solutions:
-`));
+  console.log(
+    chalk18.bold(`  Found ${opportunities.length} potential solutions:
+`)
+  );
   for (const opp of opportunities) {
     console.log(`  ${formatCategory(opp.category)}`);
     console.log(chalk18.bold(`    ${opp.name}`));
@@ -6088,7 +6224,9 @@ async function solutionAnalyzeCommand() {
 `));
   }
   console.log(chalk18.dim("  To capture a solution:"));
-  console.log(chalk18.cyan("    workflow solution capture --path <path> --name <name>"));
+  console.log(
+    chalk18.cyan("    workflow solution capture --path <path> --name <name>")
+  );
 }
 async function solutionMigrateCommand(options) {
   const cwd = getWorkspacePath();
@@ -6098,8 +6236,16 @@ async function solutionMigrateCommand(options) {
   if (!options.public && !options.private) {
     console.log(chalk18.yellow("  Please specify --public or --private"));
     console.log(chalk18.dim("\n  Examples:"));
-    console.log(chalk18.dim("    workflow solution migrate --public     # Make all solutions public"));
-    console.log(chalk18.dim("    workflow solution migrate --private    # Make all solutions private"));
+    console.log(
+      chalk18.dim(
+        "    workflow solution migrate --public     # Make all solutions public"
+      )
+    );
+    console.log(
+      chalk18.dim(
+        "    workflow solution migrate --private    # Make all solutions private"
+      )
+    );
     return;
   }
   const targetPrivate = options.private ?? false;
@@ -6112,17 +6258,31 @@ async function solutionMigrateCommand(options) {
   const solutions = result.data;
   const toMigrate = solutions.filter((s) => s.isPrivate !== targetPrivate);
   if (toMigrate.length === 0) {
-    console.log(chalk18.green(`  \u2713 All ${solutions.length} solutions are already ${targetLabel}`));
+    console.log(
+      chalk18.green(
+        `  \u2713 All ${solutions.length} solutions are already ${targetLabel}`
+      )
+    );
     return;
   }
-  console.log(chalk18.dim(`  Found ${toMigrate.length} solutions to make ${targetLabel}:
-`));
+  console.log(
+    chalk18.dim(
+      `  Found ${toMigrate.length} solutions to make ${targetLabel}:
+`
+    )
+  );
   for (const solution of toMigrate) {
-    console.log(chalk18.dim(`    \u2022 ${solution.name} (${solution.id.slice(0, 8)})`));
+    console.log(
+      chalk18.dim(`    \u2022 ${solution.name} (${solution.id.slice(0, 8)})`)
+    );
   }
   if (options.dryRun) {
-    console.log(chalk18.yellow(`
-  [DRY-RUN] Would migrate ${toMigrate.length} solutions to ${targetLabel}`));
+    console.log(
+      chalk18.yellow(
+        `
+  [DRY-RUN] Would migrate ${toMigrate.length} solutions to ${targetLabel}`
+      )
+    );
     return;
   }
   const confirm10 = await p11.confirm({
@@ -6145,10 +6305,16 @@ async function solutionMigrateCommand(options) {
       migrated++;
     }
   }
-  console.log(chalk18.green(`
-  \u2713 Migrated ${migrated} solutions to ${targetLabel}`));
+  console.log(
+    chalk18.green(`
+  \u2713 Migrated ${migrated} solutions to ${targetLabel}`)
+  );
   if (!targetPrivate) {
-    console.log(chalk18.dim("    These solutions can now be synced with 'workflow sync --solutions --push'"));
+    console.log(
+      chalk18.dim(
+        "    These solutions can now be synced with 'workflow sync --solutions --push'"
+      )
+    );
   }
 }
 async function solutionEditCommand(solutionId, options) {
@@ -6195,7 +6361,9 @@ async function solutionEditCommand(solutionId, options) {
     console.log(chalk18.dim("    --private            Make private"));
     return;
   }
-  console.log(chalk18.dim(`  Solution: ${solution.name} (${solution.id.slice(0, 8)})`));
+  console.log(
+    chalk18.dim(`  Solution: ${solution.name} (${solution.id.slice(0, 8)})`)
+  );
   console.log(chalk18.dim("  Changes:"));
   for (const change of changes) {
     console.log(chalk18.dim(`    \u2022 ${change}`));
@@ -6205,7 +6373,11 @@ async function solutionEditCommand(solutionId, options) {
   if (saveResult.success) {
     console.log(chalk18.green("\n  \u2713 Solution updated"));
     if (options.public) {
-      console.log(chalk18.dim("    This solution can now be synced with 'workflow sync --solutions --push'"));
+      console.log(
+        chalk18.dim(
+          "    This solution can now be synced with 'workflow sync --solutions --push'"
+        )
+      );
     }
   } else {
     console.log(chalk18.red(`
@@ -6377,7 +6549,8 @@ import {
   TelemetryCollector,
   FixPatternSchema,
   BlueprintSchema,
-  SolutionPatternSchema
+  SolutionPatternSchema,
+  createDefaultMetrics
 } from "@hawkinside_out/workflow-improvement-tracker";
 function getWorkspacePath2() {
   return process.cwd();
@@ -6485,16 +6658,18 @@ async function learnRecordCommand(options) {
     const catChoice = await p12.select({
       message: "Category:",
       options: [
-        { value: "migration", label: "\u{1F504} Migration" },
+        { value: "lint", label: "\u{1F527} Lint Error" },
+        { value: "type-error", label: "\u{1F537} Type Error" },
+        { value: "dependency", label: "\u{1F4E6} Dependency" },
+        { value: "config", label: "\u2699\uFE0F Configuration" },
+        { value: "runtime", label: "\u{1F3C3} Runtime" },
+        { value: "build", label: "\u{1F3D7}\uFE0F Build" },
+        { value: "test", label: "\u{1F9EA} Test" },
         { value: "security", label: "\u{1F512} Security" },
-        { value: "performance", label: "\u26A1 Performance" },
-        { value: "compatibility", label: "\u{1F517} Compatibility" },
+        { value: "migration", label: "\u{1F504} Migration" },
         { value: "deprecation", label: "\u26A0\uFE0F Deprecation" },
-        { value: "configuration", label: "\u2699\uFE0F Configuration" },
-        { value: "best-practice", label: "\u2728 Best Practice" },
-        { value: "error-handling", label: "\u{1F6A8} Error Handling" },
-        { value: "testing", label: "\u{1F9EA} Testing" },
-        { value: "other", label: "\u{1F4E6} Other" }
+        { value: "performance", label: "\u26A1 Performance" },
+        { value: "compatibility", label: "\u{1F517} Compatibility" }
       ]
     });
     if (p12.isCancel(catChoice)) {
@@ -6619,7 +6794,9 @@ async function learnRecordCommand(options) {
       console.log(chalk20.dim(`  ID: ${blueprint.id}`));
       console.log(chalk20.dim(`  Name: ${name}`));
       console.log(chalk20.dim(`  Framework: ${framework} ${version}`));
-      console.log(chalk20.dim(`  Path: .workflow/patterns/blueprints/${blueprint.id}.json`));
+      console.log(
+        chalk20.dim(`  Path: .workflow/patterns/blueprints/${blueprint.id}.json`)
+      );
     } else {
       console.log(chalk20.red("\n\u274C Failed to record blueprint"));
       console.log(chalk20.dim(`  Error: ${result.error}`));
@@ -6714,15 +6891,11 @@ async function learnListCommand(options) {
 \u26A0\uFE0F  ${totalInvalid} pattern(s) failed schema validation and were skipped:`
       )
     );
-    console.log(
-      chalk20.dim(`     Fix patterns: ${stats.invalidFixes} invalid`)
-    );
+    console.log(chalk20.dim(`     Fix patterns: ${stats.invalidFixes} invalid`));
     console.log(
       chalk20.dim(`     Blueprints: ${stats.invalidBlueprints} invalid`)
     );
-    console.log(
-      chalk20.dim(`     Solutions: ${stats.invalidSolutions} invalid`)
-    );
+    console.log(chalk20.dim(`     Solutions: ${stats.invalidSolutions} invalid`));
     const validationErrors = store.getValidationErrors();
     if (validationErrors.length > 0) {
       console.log(chalk20.yellow("\n   Validation errors:"));
@@ -6741,9 +6914,7 @@ async function learnListCommand(options) {
       }
       if (validationErrors.length > 5) {
         console.log(
-          chalk20.dim(
-            `     ... and ${validationErrors.length - 5} more errors`
-          )
+          chalk20.dim(`     ... and ${validationErrors.length - 5} more errors`)
         );
       }
     }
@@ -6766,12 +6937,17 @@ async function learnApplyCommand(patternId, options) {
   await store.initialize();
   const telemetry = new TelemetryCollector(cwd);
   console.log(chalk20.cyan("\n\u{1F527} Apply Learning Pattern\n"));
-  let pattern = await store.getFixPattern(patternId);
+  let fixPattern;
+  let blueprintPattern;
   let patternType = "fix";
-  if (!pattern.success || !pattern.data) {
+  const fixResult = await store.getFixPattern(patternId);
+  if (fixResult.success && fixResult.data) {
+    fixPattern = fixResult.data;
+    patternType = "fix";
+  } else {
     const bpResult = await store.getBlueprint(patternId);
     if (bpResult.success && bpResult.data) {
-      pattern = bpResult;
+      blueprintPattern = bpResult.data;
       patternType = "blueprint";
     } else {
       console.log(chalk20.red(`
@@ -6782,7 +6958,7 @@ async function learnApplyCommand(patternId, options) {
       process.exit(1);
     }
   }
-  const patternData = pattern.data;
+  const patternData = fixPattern ?? blueprintPattern;
   console.log(chalk20.white(`  Pattern: ${patternData.name}`));
   console.log(chalk20.dim(`  Type: ${patternType}`));
   console.log(chalk20.dim(`  Description: ${patternData.description}`));
@@ -6791,11 +6967,10 @@ async function learnApplyCommand(patternId, options) {
       chalk20.yellow("\n\u{1F4CB} DRY-RUN MODE: No changes will be applied\n")
     );
   }
-  const framework = options.framework ?? patternData.compatibility?.frameworks?.[0]?.name ?? "unknown";
-  const version = options.version ?? patternData.compatibility?.frameworks?.[0]?.version ?? "0.0.0";
+  const framework = options.framework ?? patternData.compatibility?.framework ?? "unknown";
+  const version = options.version ?? patternData.compatibility?.frameworkVersion ?? "0.0.0";
   await telemetry.recordApplication(patternId, patternType, framework, version);
-  if (patternType === "fix") {
-    const fixPattern = patternData;
+  if (patternType === "fix" && fixPattern) {
     console.log(chalk20.cyan("\n\u{1F4CB} Solution Steps:\n"));
     if (fixPattern.solution.steps) {
       for (let i = 0; i < fixPattern.solution.steps.length; i++) {
@@ -6803,17 +6978,16 @@ async function learnApplyCommand(patternId, options) {
         console.log(
           chalk20.white(`  ${i + 1}. [${step.action}] ${step.description}`)
         );
-        if (step.file) {
-          console.log(chalk20.dim(`     File: ${step.file}`));
+        if (step.target) {
+          console.log(chalk20.dim(`     Target: ${step.target}`));
         }
       }
     }
-  } else {
-    const blueprint = patternData;
+  } else if (blueprintPattern) {
     console.log(chalk20.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];
+    if (blueprintPattern.setup.steps) {
+      for (let i = 0; i < blueprintPattern.setup.steps.length; i++) {
+        const step = blueprintPattern.setup.steps[i];
         console.log(chalk20.white(`  ${i + 1}. ${step.description}`));
         if (step.command) {
           console.log(chalk20.dim(`     Command: ${step.command}`));
@@ -6965,7 +7139,9 @@ ${emoji} Mark Pattern(s) ${actionWord}
     const totalToUpdate = fixesToUpdate.length + blueprintsToUpdate.length;
     if (totalToUpdate === 0) {
       console.log(
-        chalk20.yellow(`  All patterns are already ${actionWord}. Nothing to do.`)
+        chalk20.yellow(
+          `  All patterns are already ${actionWord}. Nothing to do.`
+        )
       );
       return;
     }
@@ -6988,9 +7164,9 @@ ${emoji} Mark Pattern(s) ${actionWord}
     }
     let successCount = 0;
     let failCount = 0;
-    for (const pattern2 of fixesToUpdate) {
+    for (const pattern of fixesToUpdate) {
       const result2 = await store.saveFixPattern({
-        ...pattern2,
+        ...pattern,
         isPrivate: makePrivate,
         updatedAt: (/* @__PURE__ */ new Date()).toISOString()
       });
@@ -7026,17 +7202,20 @@ ${emoji} Mark Pattern(s) ${actionWord}
     console.log(
       chalk20.dim("  Usage: workflow learn:publish <patternId> [--private]")
     );
-    console.log(
-      chalk20.dim("         workflow learn:publish --all [--private]")
-    );
+    console.log(chalk20.dim("         workflow learn:publish --all [--private]"));
     process.exit(1);
   }
   let patternType = "fix";
-  let pattern = await store.getFixPattern(patternId);
-  if (!pattern.success || !pattern.data) {
+  let fixPatternData;
+  let blueprintData;
+  const fixResult = await store.getFixPattern(patternId);
+  if (fixResult.success && fixResult.data) {
+    fixPatternData = fixResult.data;
+    patternType = "fix";
+  } else {
     const bpResult = await store.getBlueprint(patternId);
     if (bpResult.success && bpResult.data) {
-      pattern = bpResult;
+      blueprintData = bpResult.data;
       patternType = "blueprint";
     } else {
       console.log(chalk20.red(`
@@ -7047,15 +7226,16 @@ ${emoji} Mark Pattern(s) ${actionWord}
       process.exit(1);
     }
   }
-  const currentStatus = pattern.data.isPrivate ? "private" : "public";
-  if (pattern.data.isPrivate === makePrivate) {
+  const patternInfo = fixPatternData ?? blueprintData;
+  const currentStatus = patternInfo.isPrivate ? "private" : "public";
+  if (patternInfo.isPrivate === makePrivate) {
     console.log(
       chalk20.yellow(`  Pattern is already ${actionWord}. Nothing to do.`)
     );
-    console.log(chalk20.dim(`  Name: ${pattern.data.name}`));
+    console.log(chalk20.dim(`  Name: ${patternInfo.name}`));
     return;
   }
-  console.log(chalk20.white(`  Pattern: ${pattern.data.name}`));
+  console.log(chalk20.white(`  Pattern: ${patternInfo.name}`));
   console.log(chalk20.dim(`  Type: ${patternType}`));
   console.log(chalk20.dim(`  Current: ${currentStatus} \u2192 ${actionWord}`));
   if (!options.yes) {
@@ -7068,16 +7248,24 @@ ${emoji} Mark Pattern(s) ${actionWord}
       return;
     }
   }
-  const updatedPattern = {
-    ...pattern.data,
-    isPrivate: makePrivate,
-    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-  };
   let result;
-  if (patternType === "fix") {
-    result = await store.saveFixPattern(updatedPattern);
+  if (patternType === "fix" && fixPatternData) {
+    const updatedFix = {
+      ...fixPatternData,
+      isPrivate: makePrivate,
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    result = await store.saveFixPattern(updatedFix);
+  } else if (blueprintData) {
+    const updatedBlueprint = {
+      ...blueprintData,
+      isPrivate: makePrivate,
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    result = await store.saveBlueprint(updatedBlueprint);
   } else {
-    result = await store.saveBlueprint(updatedPattern);
+    console.log(chalk20.red("\n\u274C Unexpected error: pattern data not found"));
+    process.exit(1);
   }
   if (result.success) {
     console.log(chalk20.green(`
@@ -7099,19 +7287,23 @@ async function learnDeprecateCommand(patternId, reason) {
   await store.initialize();
   console.log(chalk20.cyan("\n\u26A0\uFE0F Deprecate Pattern\n"));
   let patternType = "fix";
-  let pattern = await store.getFixPattern(patternId);
-  if (!pattern.success || !pattern.data) {
+  let patternName;
+  const fixResult = await store.getFixPattern(patternId);
+  if (fixResult.success && fixResult.data) {
+    patternType = "fix";
+    patternName = fixResult.data.name;
+  } else {
     const bpResult = await store.getBlueprint(patternId);
     if (bpResult.success && bpResult.data) {
-      pattern = bpResult;
       patternType = "blueprint";
+      patternName = bpResult.data.name;
     } else {
       console.log(chalk20.red(`
 \u274C Pattern not found: ${patternId}`));
       process.exit(1);
     }
   }
-  console.log(chalk20.white(`  Pattern: ${pattern.data.name}`));
+  console.log(chalk20.white(`  Pattern: ${patternName}`));
   console.log(chalk20.dim(`  Reason: ${reason}`));
   const confirmed = await p12.confirm({
     message: "Are you sure you want to deprecate this pattern?",
@@ -7286,7 +7478,13 @@ async function validatePatternDirectory(dirPath, type, schema, verbose) {
     for (const file of files) {
       if (!file.endsWith(".json")) continue;
       const filePath = path3.join(dirPath, file);
-      const result = await validatePatternFile(filePath, file, type, schema, verbose);
+      const result = await validatePatternFile(
+        filePath,
+        file,
+        type,
+        schema,
+        verbose
+      );
       results.push(result);
       if (verbose) {
         if (result.valid) {
@@ -7342,7 +7540,7 @@ async function validateSingleFile(filePath, verbose) {
   }
   return validatePatternFile(filePath, fileName, type, schema, verbose);
 }
-async function validatePatternFile(filePath, fileName, type, schema, verbose) {
+async function validatePatternFile(filePath, fileName, type, schema, _verbose) {
   try {
     const content = await fs2.promises.readFile(filePath, "utf-8");
     const data = JSON.parse(content);
@@ -7359,7 +7557,11 @@ async function validatePatternFile(filePath, fileName, type, schema, verbose) {
     const errors = validation.error.issues.map(
       (i) => `${i.path.join(".")}: ${i.message}`
     );
-    const { fixable, fixedData } = tryAutoFix(data, type, validation.error.issues);
+    const { fixable, fixedData } = tryAutoFix(
+      data,
+      type,
+      validation.error.issues
+    );
     return {
       file: fileName,
       type,
@@ -7373,9 +7575,7 @@ async function validatePatternFile(filePath, fileName, type, schema, verbose) {
       file: fileName,
       type,
       valid: false,
-      errors: [
-        error instanceof Error ? error.message : "Failed to parse JSON"
-      ],
+      errors: [error instanceof Error ? error.message : "Failed to parse JSON"],
       fixable: false
     };
   }
@@ -7442,103 +7642,223 @@ function tryAutoFix(data, type, issues) {
 }
 var LIBRARY_TAG_MAP = {
   // Frontend Frameworks
-  "react": [{ category: "framework", name: "react" }],
+  react: [{ category: "framework", name: "react" }],
   "react-dom": [{ category: "framework", name: "react" }],
-  "next": [{ category: "framework", name: "next" }],
-  "vue": [{ category: "framework", name: "vue" }],
-  "nuxt": [{ category: "framework", name: "nuxt" }],
-  "svelte": [{ category: "framework", name: "svelte" }],
+  next: [{ category: "framework", name: "next" }],
+  vue: [{ category: "framework", name: "vue" }],
+  nuxt: [{ category: "framework", name: "nuxt" }],
+  svelte: [{ category: "framework", name: "svelte" }],
   "@sveltejs/kit": [{ category: "framework", name: "sveltekit" }],
   "solid-js": [{ category: "framework", name: "solid" }],
   "@angular/core": [{ category: "framework", name: "angular" }],
-  "astro": [{ category: "framework", name: "astro" }],
-  "remix": [{ category: "framework", name: "remix" }],
+  astro: [{ category: "framework", name: "astro" }],
+  remix: [{ category: "framework", name: "remix" }],
   // Backend Frameworks
-  "express": [{ category: "framework", name: "express" }],
-  "fastify": [{ category: "framework", name: "fastify" }],
-  "hono": [{ category: "framework", name: "hono" }],
-  "koa": [{ category: "framework", name: "koa" }],
+  express: [{ category: "framework", name: "express" }],
+  fastify: [{ category: "framework", name: "fastify" }],
+  hono: [{ category: "framework", name: "hono" }],
+  koa: [{ category: "framework", name: "koa" }],
   "@nestjs/core": [{ category: "framework", name: "nestjs" }],
-  "hapi": [{ category: "framework", name: "hapi" }],
+  hapi: [{ category: "framework", name: "hapi" }],
   // Testing
-  "vitest": [{ category: "tooling", name: "vitest" }, { category: "category", name: "testing" }],
-  "jest": [{ category: "tooling", name: "jest" }, { category: "category", name: "testing" }],
-  "@testing-library/react": [{ category: "tooling", name: "testing-library" }],
-  "playwright": [{ category: "tooling", name: "playwright" }, { category: "category", name: "e2e" }],
-  "cypress": [{ category: "tooling", name: "cypress" }, { category: "category", name: "e2e" }],
+  vitest: [
+    { category: "tool", name: "vitest" },
+    { category: "testing", name: "testing" }
+  ],
+  jest: [
+    { category: "tool", name: "jest" },
+    { category: "testing", name: "testing" }
+  ],
+  "@testing-library/react": [{ category: "tool", name: "testing-library" }],
+  playwright: [
+    { category: "tool", name: "playwright" },
+    { category: "testing", name: "e2e" }
+  ],
+  cypress: [
+    { category: "tool", name: "cypress" },
+    { category: "testing", name: "e2e" }
+  ],
   // State Management
-  "zustand": [{ category: "tooling", name: "zustand" }, { category: "category", name: "state" }],
-  "redux": [{ category: "tooling", name: "redux" }, { category: "category", name: "state" }],
-  "@reduxjs/toolkit": [{ category: "tooling", name: "redux-toolkit" }, { category: "category", name: "state" }],
-  "jotai": [{ category: "tooling", name: "jotai" }, { category: "category", name: "state" }],
-  "recoil": [{ category: "tooling", name: "recoil" }, { category: "category", name: "state" }],
-  "mobx": [{ category: "tooling", name: "mobx" }, { category: "category", name: "state" }],
-  "pinia": [{ category: "tooling", name: "pinia" }, { category: "category", name: "state" }],
-  "xstate": [{ category: "tooling", name: "xstate" }, { category: "category", name: "state-machine" }],
+  zustand: [
+    { category: "tool", name: "zustand" },
+    { category: "state", name: "state" }
+  ],
+  redux: [
+    { category: "tool", name: "redux" },
+    { category: "state", name: "state" }
+  ],
+  "@reduxjs/toolkit": [
+    { category: "tool", name: "redux-toolkit" },
+    { category: "state", name: "state" }
+  ],
+  jotai: [
+    { category: "tool", name: "jotai" },
+    { category: "state", name: "state" }
+  ],
+  recoil: [
+    { category: "tool", name: "recoil" },
+    { category: "state", name: "state" }
+  ],
+  mobx: [
+    { category: "tool", name: "mobx" },
+    { category: "state", name: "state" }
+  ],
+  pinia: [
+    { category: "tool", name: "pinia" },
+    { category: "state", name: "state" }
+  ],
+  xstate: [
+    { category: "tool", name: "xstate" },
+    { category: "state", name: "state-machine" }
+  ],
   // Database & ORM
-  "prisma": [{ category: "tooling", name: "prisma" }, { category: "category", name: "database" }],
-  "@prisma/client": [{ category: "tooling", name: "prisma" }, { category: "category", name: "database" }],
-  "drizzle-orm": [{ category: "tooling", name: "drizzle" }, { category: "category", name: "database" }],
-  "typeorm": [{ category: "tooling", name: "typeorm" }, { category: "category", name: "database" }],
-  "mongoose": [{ category: "tooling", name: "mongoose" }, { category: "category", name: "mongodb" }],
-  "knex": [{ category: "tooling", name: "knex" }, { category: "category", name: "database" }],
-  "sequelize": [{ category: "tooling", name: "sequelize" }, { category: "category", name: "database" }],
+  prisma: [
+    { category: "tool", name: "prisma" },
+    { category: "database", name: "database" }
+  ],
+  "@prisma/client": [
+    { category: "tool", name: "prisma" },
+    { category: "database", name: "database" }
+  ],
+  "drizzle-orm": [
+    { category: "tool", name: "drizzle" },
+    { category: "database", name: "database" }
+  ],
+  typeorm: [
+    { category: "tool", name: "typeorm" },
+    { category: "database", name: "database" }
+  ],
+  mongoose: [
+    { category: "tool", name: "mongoose" },
+    { category: "database", name: "mongodb" }
+  ],
+  knex: [
+    { category: "tool", name: "knex" },
+    { category: "database", name: "database" }
+  ],
+  sequelize: [
+    { category: "tool", name: "sequelize" },
+    { category: "database", name: "database" }
+  ],
   // Authentication
-  "next-auth": [{ category: "tooling", name: "next-auth" }, { category: "category", name: "auth" }],
-  "@auth/core": [{ category: "tooling", name: "authjs" }, { category: "category", name: "auth" }],
-  "passport": [{ category: "tooling", name: "passport" }, { category: "category", name: "auth" }],
-  "lucia": [{ category: "tooling", name: "lucia" }, { category: "category", name: "auth" }],
-  "@clerk/nextjs": [{ category: "tooling", name: "clerk" }, { category: "category", name: "auth" }],
+  "next-auth": [
+    { category: "tool", name: "next-auth" },
+    { category: "auth", name: "auth" }
+  ],
+  "@auth/core": [
+    { category: "tool", name: "authjs" },
+    { category: "auth", name: "auth" }
+  ],
+  passport: [
+    { category: "tool", name: "passport" },
+    { category: "auth", name: "auth" }
+  ],
+  lucia: [
+    { category: "tool", name: "lucia" },
+    { category: "auth", name: "auth" }
+  ],
+  "@clerk/nextjs": [
+    { category: "tool", name: "clerk" },
+    { category: "auth", name: "auth" }
+  ],
   // UI Libraries
-  "@radix-ui/react-dialog": [{ category: "tooling", name: "radix-ui" }],
-  "@radix-ui/react-dropdown-menu": [{ category: "tooling", name: "radix-ui" }],
-  "@shadcn/ui": [{ category: "tooling", name: "shadcn" }],
-  "@chakra-ui/react": [{ category: "tooling", name: "chakra-ui" }],
-  "@mantine/core": [{ category: "tooling", name: "mantine" }],
-  "@headlessui/react": [{ category: "tooling", name: "headlessui" }],
-  "antd": [{ category: "tooling", name: "antd" }],
-  "@mui/material": [{ category: "tooling", name: "material-ui" }],
+  "@radix-ui/react-dialog": [{ category: "tool", name: "radix-ui" }],
+  "@radix-ui/react-dropdown-menu": [{ category: "tool", name: "radix-ui" }],
+  "@shadcn/ui": [{ category: "tool", name: "shadcn" }],
+  "@chakra-ui/react": [{ category: "tool", name: "chakra-ui" }],
+  "@mantine/core": [{ category: "tool", name: "mantine" }],
+  "@headlessui/react": [{ category: "tool", name: "headlessui" }],
+  antd: [{ category: "tool", name: "antd" }],
+  "@mui/material": [{ category: "tool", name: "material-ui" }],
   // Styling
-  "tailwindcss": [{ category: "tooling", name: "tailwind" }],
-  "styled-components": [{ category: "tooling", name: "styled-components" }],
-  "@emotion/react": [{ category: "tooling", name: "emotion" }],
-  "sass": [{ category: "tooling", name: "sass" }],
+  tailwindcss: [{ category: "tool", name: "tailwind" }],
+  "styled-components": [{ category: "tool", name: "styled-components" }],
+  "@emotion/react": [{ category: "tool", name: "emotion" }],
+  sass: [{ category: "tool", name: "sass" }],
   // API & Data Fetching
-  "@tanstack/react-query": [{ category: "tooling", name: "tanstack-query" }, { category: "category", name: "data-fetching" }],
-  "swr": [{ category: "tooling", name: "swr" }, { category: "category", name: "data-fetching" }],
-  "@trpc/server": [{ category: "tooling", name: "trpc" }, { category: "category", name: "api" }],
-  "@trpc/client": [{ category: "tooling", name: "trpc" }, { category: "category", name: "api" }],
-  "graphql": [{ category: "tooling", name: "graphql" }, { category: "category", name: "api" }],
-  "@apollo/client": [{ category: "tooling", name: "apollo" }, { category: "category", name: "graphql" }],
-  "axios": [{ category: "tooling", name: "axios" }],
+  "@tanstack/react-query": [
+    { category: "tool", name: "tanstack-query" },
+    { category: "api", name: "data-fetching" }
+  ],
+  swr: [
+    { category: "tool", name: "swr" },
+    { category: "api", name: "data-fetching" }
+  ],
+  "@trpc/server": [
+    { category: "tool", name: "trpc" },
+    { category: "api", name: "api" }
+  ],
+  "@trpc/client": [
+    { category: "tool", name: "trpc" },
+    { category: "api", name: "api" }
+  ],
+  graphql: [
+    { category: "tool", name: "graphql" },
+    { category: "api", name: "api" }
+  ],
+  "@apollo/client": [
+    { category: "tool", name: "apollo" },
+    { category: "api", name: "graphql" }
+  ],
+  axios: [{ category: "tool", name: "axios" }],
   // Form Libraries
-  "react-hook-form": [{ category: "tooling", name: "react-hook-form" }, { category: "category", name: "forms" }],
-  "formik": [{ category: "tooling", name: "formik" }, { category: "category", name: "forms" }],
-  "@tanstack/react-form": [{ category: "tooling", name: "tanstack-form" }, { category: "category", name: "forms" }],
+  "react-hook-form": [
+    { category: "tool", name: "react-hook-form" },
+    { category: "feature", name: "forms" }
+  ],
+  formik: [
+    { category: "tool", name: "formik" },
+    { category: "feature", name: "forms" }
+  ],
+  "@tanstack/react-form": [
+    { category: "tool", name: "tanstack-form" },
+    { category: "feature", name: "forms" }
+  ],
   // Validation
-  "zod": [{ category: "tooling", name: "zod" }, { category: "category", name: "validation" }],
-  "yup": [{ category: "tooling", name: "yup" }, { category: "category", name: "validation" }],
-  "valibot": [{ category: "tooling", name: "valibot" }, { category: "category", name: "validation" }],
+  zod: [
+    { category: "tool", name: "zod" },
+    { category: "feature", name: "validation" }
+  ],
+  yup: [
+    { category: "tool", name: "yup" },
+    { category: "feature", name: "validation" }
+  ],
+  valibot: [
+    { category: "tool", name: "valibot" },
+    { category: "feature", name: "validation" }
+  ],
   // Build Tools
-  "vite": [{ category: "tooling", name: "vite" }],
-  "esbuild": [{ category: "tooling", name: "esbuild" }],
-  "tsup": [{ category: "tooling", name: "tsup" }],
-  "webpack": [{ category: "tooling", name: "webpack" }],
-  "turbo": [{ category: "tooling", name: "turborepo" }],
+  vite: [{ category: "tool", name: "vite" }],
+  esbuild: [{ category: "tool", name: "esbuild" }],
+  tsup: [{ category: "tool", name: "tsup" }],
+  webpack: [{ category: "tool", name: "webpack" }],
+  turbo: [{ category: "tool", name: "turborepo" }],
   // Utilities
-  "lodash": [{ category: "tooling", name: "lodash" }],
-  "date-fns": [{ category: "tooling", name: "date-fns" }],
-  "dayjs": [{ category: "tooling", name: "dayjs" }],
-  "uuid": [{ category: "tooling", name: "uuid" }],
-  "nanoid": [{ category: "tooling", name: "nanoid" }],
+  lodash: [{ category: "tool", name: "lodash" }],
+  "date-fns": [{ category: "tool", name: "date-fns" }],
+  dayjs: [{ category: "tool", name: "dayjs" }],
+  uuid: [{ category: "tool", name: "uuid" }],
+  nanoid: [{ category: "tool", name: "nanoid" }],
   // CLI & Developer Tools
-  "commander": [{ category: "tooling", name: "commander" }, { category: "category", name: "cli" }],
-  "yargs": [{ category: "tooling", name: "yargs" }, { category: "category", name: "cli" }],
-  "@clack/prompts": [{ category: "tooling", name: "clack" }, { category: "category", name: "cli" }],
-  "inquirer": [{ category: "tooling", name: "inquirer" }, { category: "category", name: "cli" }],
-  "chalk": [{ category: "tooling", name: "chalk" }],
+  commander: [
+    { category: "tool", name: "commander" },
+    { category: "feature", name: "cli" }
+  ],
+  yargs: [
+    { category: "tool", name: "yargs" },
+    { category: "feature", name: "cli" }
+  ],
+  "@clack/prompts": [
+    { category: "tool", name: "clack" },
+    { category: "feature", name: "cli" }
+  ],
+  inquirer: [
+    { category: "tool", name: "inquirer" },
+    { category: "feature", name: "cli" }
+  ],
+  chalk: [{ category: "tool", name: "chalk" }],
   // Runtime & Languages
-  "typescript": [{ category: "language", name: "typescript" }]
+  typescript: [{ category: "language", name: "typescript" }]
 };
 function inferPatternName(filePaths) {
   if (filePaths.length === 1) {
@@ -7552,7 +7872,9 @@ function inferPatternName(filePaths) {
     const dirName = path3.basename(uniqueDirs[0]);
     return dirName.replace(/[-_]/g, " ").replace(/([A-Z])/g, " $1").trim().split(/\s+/).map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join(" ") + " Pattern";
   }
-  const fileNames = filePaths.map((p13) => path3.basename(p13).replace(/\.[^.]+$/, ""));
+  const fileNames = filePaths.map(
+    (p13) => path3.basename(p13).replace(/\.[^.]+$/, "")
+  );
   if (fileNames.length > 0) {
     let commonPrefix = fileNames[0];
     for (const name of fileNames.slice(1)) {
@@ -7619,28 +7941,28 @@ function inferTagsFromContent(filePaths) {
     } else if (ext === ".rs") {
       addTag("language", "rust");
     } else if (ext === ".css" || ext === ".scss" || ext === ".sass") {
-      addTag("tooling", "css");
+      addTag("file-type", "css");
     }
     if (ext === ".tsx" || ext === ".jsx") {
       addTag("framework", "react");
     }
     if (fileName.includes(".test.") || fileName.includes(".spec.") || fileName.startsWith("test_")) {
-      addTag("category", "testing");
+      addTag("testing", "testing");
     }
     if (fileName.includes("config") || fileName.startsWith(".")) {
-      addTag("category", "configuration");
+      addTag("file-type", "configuration");
     }
     if (filePath.includes("/components/") || filePath.includes("\\components\\")) {
-      addTag("category", "component");
+      addTag("ui", "component");
     }
     if (filePath.includes("/hooks/") || filePath.includes("\\hooks\\") || fileName.startsWith("use")) {
-      addTag("category", "hooks");
+      addTag("pattern", "hooks");
     }
     if (filePath.includes("/api/") || filePath.includes("\\api\\") || filePath.includes("/routes/")) {
-      addTag("category", "api");
+      addTag("api", "api");
     }
     if (filePath.includes("/utils/") || filePath.includes("\\utils\\") || filePath.includes("/lib/")) {
-      addTag("category", "utilities");
+      addTag("library", "utilities");
     }
   }
   return tags;
@@ -7720,7 +8042,8 @@ async function learnCaptureCommand(paths, options) {
       placeholder: inferredName,
       initialValue: inferredName,
       validate: (value) => {
-        if (!value || value.length < 3) return "Name must be at least 3 characters";
+        if (!value || value.length < 3)
+          return "Name must be at least 3 characters";
         if (value.length > 100) return "Name must be less than 100 characters";
         return void 0;
       }
@@ -7737,8 +8060,10 @@ async function learnCaptureCommand(paths, options) {
       message: "Description:",
       placeholder: "What does this pattern provide?",
       validate: (value) => {
-        if (!value || value.length < 10) return "Description must be at least 10 characters";
-        if (value.length > 500) return "Description must be less than 500 characters";
+        if (!value || value.length < 10)
+          return "Description must be at least 10 characters";
+        if (value.length > 500)
+          return "Description must be less than 500 characters";
         return void 0;
       }
     });
@@ -7796,7 +8121,18 @@ async function learnCaptureCommand(paths, options) {
   for (const file of files) {
     languageCounts[file.language] = (languageCounts[file.language] || 0) + 1;
   }
-  const primaryLanguage = Object.entries(languageCounts).sort((a, b) => b[1] - a[1])[0]?.[0] || "typescript";
+  const detectedLanguage = Object.entries(languageCounts).sort((a, b) => b[1] - a[1])[0]?.[0] || "typescript";
+  const validLanguages = [
+    "typescript",
+    "javascript",
+    "python",
+    "go",
+    "rust",
+    "other"
+  ];
+  const primaryLanguage = validLanguages.includes(
+    detectedLanguage
+  ) ? detectedLanguage : "other";
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const contributorManager = new ContributorManager2(cwd);
   const contributorResult = await contributorManager.getOrCreateId();
@@ -7806,6 +8142,13 @@ async function learnCaptureCommand(paths, options) {
     purpose: `${f.language} file`,
     content: f.content
   }));
+  const uniqueDirs = [
+    ...new Set(files.map((f) => path3.dirname(f.path)).filter((d) => d !== "."))
+  ];
+  const directories = uniqueDirs.map((dir) => ({
+    path: dir,
+    purpose: `Directory for ${path3.basename(dir)} files`
+  }));
   const blueprint = {
     id: crypto.randomUUID(),
     name,
@@ -7820,7 +8163,7 @@ async function learnCaptureCommand(paths, options) {
       devDependencies: []
     },
     structure: {
-      directories: [...new Set(files.map((f) => path3.dirname(f.path)).filter((d) => d !== "."))],
+      directories,
       keyFiles
     },
     setup: {
@@ -7869,7 +8212,9 @@ async function learnCaptureCommand(paths, options) {
   console.log(chalk20.dim(`Name: ${name}`));
   console.log(chalk20.dim(`Files: ${files.length}`));
   console.log(chalk20.dim(`Tags: ${formatTags(uniqueTags)}`));
-  console.log(chalk20.dim(`Path: .workflow/patterns/blueprints/${blueprint.id}.json`));
+  console.log(
+    chalk20.dim(`Path: .workflow/patterns/blueprints/${blueprint.id}.json`)
+  );
   console.log(chalk20.dim(`
 To apply this pattern:`));
   console.log(chalk20.cyan(`  pnpm workflow:learn:apply ${blueprint.id}`));
@@ -7898,7 +8243,9 @@ async function learnAnalyzeCommand(options) {
   const store = new PatternStore2(cwd);
   await store.initialize();
   const verbose = options.verbose ?? false;
-  console.log(chalk20.cyan("\n\u{1F50D} Analyzing Codebase for Learning Opportunities\n"));
+  console.log(
+    chalk20.cyan("\n\u{1F50D} Analyzing Codebase for Learning Opportunities\n")
+  );
   const fixResult = await store.listFixPatterns({});
   const bpResult = await store.listBlueprints({});
   const existingPatterns = [
@@ -7963,8 +8310,12 @@ async function learnAnalyzeCommand(options) {
     console.log(chalk20.dim("\n  Your patterns seem well-captured!"));
     return;
   }
-  console.log(chalk20.bold(`  Found ${opportunities.length} potential learning opportunities:
-`));
+  console.log(
+    chalk20.bold(
+      `  Found ${opportunities.length} potential learning opportunities:
+`
+    )
+  );
   for (const opp of opportunities) {
     const icon = opp.type === "blueprint" ? "\u{1F4D0}" : "\u{1F527}";
     console.log(`  ${icon} ${chalk20.green(opp.name)}`);
@@ -8072,7 +8423,9 @@ async function learnImportCommand(file, options) {
   let importData;
   try {
     if (file.endsWith(".yaml") || file.endsWith(".yml")) {
-      console.log(chalk20.yellow("  YAML import not fully supported, treating as JSON"));
+      console.log(
+        chalk20.yellow("  YAML import not fully supported, treating as JSON")
+      );
     }
     importData = JSON.parse(content);
   } catch {
@@ -8095,7 +8448,9 @@ async function learnImportCommand(file, options) {
       console.log(chalk20.dim(`    Would import fix: ${fix.name} (${fix.id})`));
     }
     for (const bp of blueprints) {
-      console.log(chalk20.dim(`    Would import blueprint: ${bp.name} (${bp.id})`));
+      console.log(
+        chalk20.dim(`    Would import blueprint: ${bp.name} (${bp.id})`)
+      );
     }
     return;
   }
@@ -8148,8 +8503,12 @@ async function learnCleanCommand(options) {
   if (!cleanDeprecated && !cleanStale && !cleanAll) {
     console.log(chalk20.yellow("  Specify what to clean:"));
     console.log(chalk20.dim("    --deprecated  Remove deprecated patterns"));
-    console.log(chalk20.dim("    --stale       Remove patterns not used in 90+ days"));
-    console.log(chalk20.dim("    --all         Remove all patterns (use with caution!)"));
+    console.log(
+      chalk20.dim("    --stale       Remove patterns not used in 90+ days")
+    );
+    console.log(
+      chalk20.dim("    --all         Remove all patterns (use with caution!)")
+    );
     return;
   }
   const toRemove = [];
@@ -8164,23 +8523,48 @@ async function learnCleanCommand(options) {
     if (cleanAll) {
       toRemove.push({ id: fix.id, name: fix.name, type: "fix", reason: "all" });
     } else if (cleanDeprecated && fix.deprecatedAt) {
-      toRemove.push({ id: fix.id, name: fix.name, type: "fix", reason: "deprecated" });
+      toRemove.push({
+        id: fix.id,
+        name: fix.name,
+        type: "fix",
+        reason: "deprecated"
+      });
     } else if (cleanStale) {
       const lastUsed = new Date(fix.updatedAt).getTime();
       if (lastUsed < staleThreshold) {
-        toRemove.push({ id: fix.id, name: fix.name, type: "fix", reason: "stale" });
+        toRemove.push({
+          id: fix.id,
+          name: fix.name,
+          type: "fix",
+          reason: "stale"
+        });
       }
     }
   }
   for (const bp of blueprints) {
     if (cleanAll) {
-      toRemove.push({ id: bp.id, name: bp.name, type: "blueprint", reason: "all" });
+      toRemove.push({
+        id: bp.id,
+        name: bp.name,
+        type: "blueprint",
+        reason: "all"
+      });
     } else if (cleanDeprecated && bp.deprecatedAt) {
-      toRemove.push({ id: bp.id, name: bp.name, type: "blueprint", reason: "deprecated" });
+      toRemove.push({
+        id: bp.id,
+        name: bp.name,
+        type: "blueprint",
+        reason: "deprecated"
+      });
     } else if (cleanStale) {
       const lastUsed = new Date(bp.updatedAt).getTime();
       if (lastUsed < staleThreshold) {
-        toRemove.push({ id: bp.id, name: bp.name, type: "blueprint", reason: "stale" });
+        toRemove.push({
+          id: bp.id,
+          name: bp.name,
+          type: "blueprint",
+          reason: "stale"
+        });
       }
     }
   }
@@ -8246,7 +8630,10 @@ ${chalk21.bold("Examples:")}
   ).action(() => {
     learnCmd.help();
   });
-  learnCmd.command("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.)").option("--framework <fw>", "Framework (next, react, vue, etc.)").option("--version <ver>", "Framework version range").option("--tags <tags>", "Comma-separated tags (category:value)").option("--type <type>", "Pattern type (fix, blueprint)").addHelpText(
+  learnCmd.command("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.)"
+  ).option("--framework <fw>", "Framework (next, react, vue, etc.)").option("--version <ver>", "Framework version range").option("--tags <tags>", "Comma-separated tags (category:value)").option("--type <type>", "Pattern type (fix, blueprint)").addHelpText(
     "after",
     `
 ${chalk21.bold("Examples:")}
@@ -8276,7 +8663,9 @@ ${chalk21.bold("Examples:")}
   $ workflow learn apply abc123 --framework react      ${chalk21.dim("# Override framework")}
 `
   ).action(learnApplyCommand);
-  learnCmd.command("capture <paths...>").description("Capture files as a blueprint pattern with auto-inferred metadata").option("--name <name>", "Pattern name (inferred from paths if omitted)").option("--description <desc>", "Pattern description").option("--framework <fw>", "Override inferred framework").option("--tags <tags>", "Additional tags (comma-separated)").option("--dry-run", "Preview what would be captured without saving").addHelpText(
+  learnCmd.command("capture <paths...>").description(
+    "Capture files as a blueprint pattern with auto-inferred metadata"
+  ).option("--name <name>", "Pattern name (inferred from paths if omitted)").option("--description <desc>", "Pattern description").option("--framework <fw>", "Override inferred framework").option("--tags <tags>", "Additional tags (comma-separated)").option("--dry-run", "Preview what would be captured without saving").addHelpText(
     "after",
     `
 ${chalk21.bold("Examples:")}
@@ -8286,7 +8675,9 @@ ${chalk21.bold("Examples:")}
   $ workflow learn capture ./hooks --tags "react,hooks" ${chalk21.dim("# With tags")}
 `
   ).action(learnCaptureCommand);
-  learnCmd.command("sync").description("Sync patterns with remote registry (alias for: workflow sync --learn)").option("--push", "Push local patterns to registry").option("--pull", "Pull patterns from registry").option("--dry-run", "Preview without syncing").addHelpText(
+  learnCmd.command("sync").description(
+    "Sync patterns with remote registry (alias for: workflow sync --learn)"
+  ).option("--push", "Push local patterns to registry").option("--pull", "Pull patterns from registry").option("--dry-run", "Preview without syncing").addHelpText(
     "after",
     `
 ${chalk21.bold("Examples:")}
@@ -8300,7 +8691,7 @@ ${chalk21.bold("Pro Tip:")}
   $ workflow sync --all                                ${chalk21.dim("# Sync everything")}
 `
   ).action(async (options) => {
-    const { syncCommand: syncCommand2 } = await import("../sync-ON7M53OC.js");
+    const { syncCommand: syncCommand2 } = await import("../sync-HHQM3GKR.js");
     return syncCommand2({ ...options, learn: true });
   });
   learnCmd.command("config").description("Configure learning settings").option("--enable-sync", "Enable pattern sync").option("--disable-sync", "Disable pattern sync").option("--enable-telemetry", "Enable anonymous telemetry").option("--disable-telemetry", "Disable telemetry").option("--reset-id", "Reset contributor ID").option("--show", "Show current configuration").addHelpText(
@@ -8346,7 +8737,11 @@ ${chalk21.bold("Examples:")}
   $ workflow learn analyze --verbose                   ${chalk21.dim("# Show paths and details")}
 `
   ).action(learnAnalyzeCommand);
-  learnCmd.command("export").description("Export learning patterns to a file").option("-o, --output <path>", "Output file path", "patterns-export.json").option("-f, --format <format>", "Output format (json, yaml)", "json").option("-t, --type <type>", "Pattern type to export (fix, blueprint, all)", "all").addHelpText(
+  learnCmd.command("export").description("Export learning patterns to a file").option("-o, --output <path>", "Output file path", "patterns-export.json").option("-f, --format <format>", "Output format (json, yaml)", "json").option(
+    "-t, --type <type>",
+    "Pattern type to export (fix, blueprint, all)",
+    "all"
+  ).addHelpText(
     "after",
     `
 ${chalk21.bold("Examples:")}
@@ -8374,7 +8769,11 @@ ${chalk21.bold("Examples:")}
   $ workflow learn clean --all --dry-run               ${chalk21.dim("# Preview full clean")}
 `
   ).action(learnCleanCommand);
-  learnCmd.command("validate").description("Validate pattern files and optionally auto-fix common issues").option("-t, --type <type>", "Pattern type to validate (fix, blueprint, solution, all)", "all").option("-f, --file <path>", "Validate a specific file by path").option("--fix", "Automatically fix common issues").option("-v, --verbose", "Show detailed validation output").addHelpText(
+  learnCmd.command("validate").description("Validate pattern files and optionally auto-fix common issues").option(
+    "-t, --type <type>",
+    "Pattern type to validate (fix, blueprint, solution, all)",
+    "all"
+  ).option("-f, --file <path>", "Validate a specific file by path").option("--fix", "Automatically fix common issues").option("-v, --verbose", "Show detailed validation output").addHelpText(
     "after",
     `
 ${chalk21.bold("Examples:")}
@@ -8408,10 +8807,14 @@ async function scopeListCommand() {
     byCategory[cat].push(scope);
   }
   for (const [category, categoryScopes] of Object.entries(byCategory)) {
-    console.log(chalk22.bold(`  ${category.charAt(0).toUpperCase() + category.slice(1)}:`));
+    console.log(
+      chalk22.bold(`  ${category.charAt(0).toUpperCase() + category.slice(1)}:`)
+    );
     for (const scope of categoryScopes) {
       const emoji = scope.emoji || "\u{1F4E6}";
-      console.log(`    ${emoji} ${chalk22.green(scope.name)} - ${scope.description || "No description"}`);
+      console.log(
+        `    ${emoji} ${chalk22.green(scope.name)} - ${scope.description || "No description"}`
+      );
     }
     console.log("");
   }
@@ -8422,12 +8825,16 @@ async function scopeAddCommand(name, options) {
 \u2795 Adding Scope: ${name}
 `));
   const fs3 = await import("fs");
-  const path4 = await import("path");
+  const path5 = await import("path");
   const cwd = process.cwd();
-  const configFiles = ["workflow.config.json", "workflow.config.js", ".workflowrc.json"];
+  const configFiles = [
+    "workflow.config.json",
+    "workflow.config.js",
+    ".workflowrc.json"
+  ];
   let configPath = null;
   for (const file of configFiles) {
-    const fullPath = path4.join(cwd, file);
+    const fullPath = path5.join(cwd, file);
     if (fs3.existsSync(fullPath)) {
       configPath = fullPath;
       break;
@@ -8465,12 +8872,16 @@ async function scopeRemoveCommand(name) {
 \u2796 Removing Scope: ${name}
 `));
   const fs3 = await import("fs");
-  const path4 = await import("path");
+  const path5 = await import("path");
   const cwd = process.cwd();
-  const configFiles = ["workflow.config.json", "workflow.config.js", ".workflowrc.json"];
+  const configFiles = [
+    "workflow.config.json",
+    "workflow.config.js",
+    ".workflowrc.json"
+  ];
   let configPath = null;
   for (const file of configFiles) {
-    const fullPath = path4.join(cwd, file);
+    const fullPath = path5.join(cwd, file);
     if (fs3.existsSync(fullPath)) {
       configPath = fullPath;
       break;
@@ -8486,7 +8897,9 @@ async function scopeRemoveCommand(name) {
     console.log(chalk22.yellow("  No scopes configured"));
     process.exit(1);
   }
-  const index = config.scopes.findIndex((s) => s.name === name);
+  const index = config.scopes.findIndex(
+    (s) => s.name === name
+  );
   if (index === -1) {
     console.log(chalk22.yellow(`  Scope "${name}" not found`));
     process.exit(1);
@@ -8497,7 +8910,7 @@ async function scopeRemoveCommand(name) {
 }
 async function scopeSyncCommand(options) {
   console.log(chalk22.bold.cyan("\n\u{1F504} Syncing Scopes\n"));
-  const { syncCommand: syncCommand2 } = await import("../sync-ON7M53OC.js");
+  const { syncCommand: syncCommand2 } = await import("../sync-HHQM3GKR.js");
   await syncCommand2({
     ...options,
     scopes: true,
@@ -8510,7 +8923,11 @@ async function scopeAnalyzeCommand() {
   const { execa: execa2 } = await import("execa");
   const cwd = process.cwd();
   try {
-    const { stdout } = await execa2("git", ["log", "--oneline", "-50", "--format=%s"], { cwd });
+    const { stdout } = await execa2(
+      "git",
+      ["log", "--oneline", "-50", "--format=%s"],
+      { cwd }
+    );
     const commits = stdout.split("\n").filter(Boolean);
     const config = await loadConfig();
     const scopes = config?.scopes || [];
@@ -8537,13 +8954,19 @@ async function scopeAnalyzeCommand() {
     console.log("");
     const sortedUsage = Object.entries(usage).sort((a, b) => b[1] - a[1]);
     for (const [scope, count] of sortedUsage) {
-      const scopeConfig = scopes.find((s) => s.name === scope);
+      const scopeConfig = scopes.find(
+        (s) => s.name === scope
+      );
       const emoji = scopeConfig?.emoji || "\u{1F4E6}";
       const bar = "\u2588".repeat(Math.min(count, 20));
-      console.log(`    ${emoji} ${chalk22.green(scope.padEnd(15))} ${bar} ${count}`);
+      console.log(
+        `    ${emoji} ${chalk22.green(scope.padEnd(15))} ${bar} ${count}`
+      );
     }
     if (unscoped > 0) {
-      console.log(`    ${chalk22.yellow("(unscoped)".padEnd(17))} ${"\u2591".repeat(Math.min(unscoped, 20))} ${unscoped}`);
+      console.log(
+        `    ${chalk22.yellow("(unscoped)".padEnd(17))} ${"\u2591".repeat(Math.min(unscoped, 20))} ${unscoped}`
+      );
     }
     const unusedScopes = scopeNames.filter((name) => !usage[name]);
     if (unusedScopes.length > 0) {
@@ -8561,7 +8984,9 @@ async function scopeAnalyzeCommand() {
     console.log("");
   } catch {
     console.log(chalk22.yellow("  Unable to analyze git history"));
-    console.log(chalk22.dim("  Make sure you're in a git repository with commit history"));
+    console.log(
+      chalk22.dim("  Make sure you're in a git repository with commit history")
+    );
   }
 }
 function createScopeCommand() {
@@ -8641,15 +9066,261 @@ ${chalk22.bold("Details:")}
   return scopeCmd;
 }
 
+// src/cli/commands/migrate.ts
+import chalk23 from "chalk";
+import * as path4 from "path";
+import {
+  PatternStore as PatternStore3,
+  PATTERNS_DIR
+} from "@hawkinside_out/workflow-improvement-tracker";
+async function migrateCommand(subcommand, options) {
+  if (subcommand === "filenames") {
+    await migrateFilenames(options);
+  } else {
+    console.error(chalk23.red(`Unknown migrate subcommand: ${subcommand}`));
+    console.log(chalk23.dim("\nAvailable subcommands:"));
+    console.log(
+      chalk23.dim("  filenames  Migrate pattern files to slugified names")
+    );
+    process.exit(1);
+  }
+}
+async function migrateFilenames(options) {
+  const isDryRun = options.dryRun || false;
+  const targetType = options.type || "all";
+  console.log(chalk23.bold.cyan("\n\u{1F4E6} Migrate Pattern Filenames\n"));
+  if (isDryRun) {
+    console.log(chalk23.yellow("\u{1F50D} DRY RUN MODE - No files will be modified\n"));
+  }
+  const cwd = process.cwd();
+  const store = new PatternStore3(cwd);
+  await store.initialize();
+  const fixesPath = path4.join(cwd, PATTERNS_DIR, "fixes");
+  const blueprintsPath = path4.join(cwd, PATTERNS_DIR, "blueprints");
+  const solutionsPath = path4.join(cwd, PATTERNS_DIR, "solutions");
+  function slugify(text8) {
+    const slug = text8.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/[\s_]+/g, "-").replace(/-+/g, "-").replace(/^-+|-+$/g, "");
+    return slug.substring(0, 50);
+  }
+  function getFilePath(basePath, id, name) {
+    if (name) {
+      const slug = slugify(name);
+      return path4.join(basePath, `${slug}-${id}.json`);
+    }
+    return path4.join(basePath, `${id}.json`);
+  }
+  let totalProcessed = 0;
+  let totalMigrated = 0;
+  let totalFailed = 0;
+  let totalSkipped = 0;
+  const results = [];
+  if (targetType === "fix" || targetType === "all") {
+    console.log(chalk23.bold("Fixes:"));
+    const fixesResult = await store.listFixPatterns({
+      includeDeprecated: true
+    });
+    if (fixesResult.success && fixesResult.data) {
+      for (const fix of fixesResult.data) {
+        totalProcessed++;
+        try {
+          const oldPath = getFilePath(fixesPath, fix.id);
+          const newPath = getFilePath(fixesPath, fix.id, fix.name);
+          if (oldPath === newPath) {
+            console.log(chalk23.dim(`  \u2298 ${fix.name} - already migrated`));
+            results.push({
+              type: "fix",
+              name: fix.name,
+              oldPath,
+              newPath,
+              status: "skipped"
+            });
+            totalSkipped++;
+            continue;
+          }
+          if (!isDryRun) {
+            await store.saveFixPattern(fix);
+          }
+          console.log(chalk23.green(`  \u2713 ${fix.name}`));
+          console.log(chalk23.dim(`    ${oldPath} \u2192 ${newPath}`));
+          results.push({
+            type: "fix",
+            name: fix.name,
+            oldPath,
+            newPath,
+            status: "success"
+          });
+          totalMigrated++;
+        } catch (error) {
+          console.log(chalk23.red(`  \u2717 ${fix.name} - ${error}`));
+          results.push({
+            type: "fix",
+            name: fix.name,
+            oldPath: "",
+            newPath: "",
+            status: "failed",
+            error: String(error)
+          });
+          totalFailed++;
+        }
+      }
+    }
+    console.log();
+  }
+  if (targetType === "blueprint" || targetType === "all") {
+    console.log(chalk23.bold("Blueprints:"));
+    const blueprintsResult = await store.listBlueprints({
+      includeDeprecated: true
+    });
+    if (blueprintsResult.success && blueprintsResult.data) {
+      for (const blueprint of blueprintsResult.data) {
+        totalProcessed++;
+        try {
+          const oldPath = getFilePath(blueprintsPath, blueprint.id);
+          const newPath = getFilePath(
+            blueprintsPath,
+            blueprint.id,
+            blueprint.name
+          );
+          if (oldPath === newPath) {
+            console.log(chalk23.dim(`  \u2298 ${blueprint.name} - already migrated`));
+            results.push({
+              type: "blueprint",
+              name: blueprint.name,
+              oldPath,
+              newPath,
+              status: "skipped"
+            });
+            totalSkipped++;
+            continue;
+          }
+          if (!isDryRun) {
+            await store.saveBlueprint(blueprint);
+          }
+          console.log(chalk23.green(`  \u2713 ${blueprint.name}`));
+          console.log(chalk23.dim(`    ${oldPath} \u2192 ${newPath}`));
+          results.push({
+            type: "blueprint",
+            name: blueprint.name,
+            oldPath,
+            newPath,
+            status: "success"
+          });
+          totalMigrated++;
+        } catch (error) {
+          console.log(chalk23.red(`  \u2717 ${blueprint.name} - ${error}`));
+          results.push({
+            type: "blueprint",
+            name: blueprint.name,
+            oldPath: "",
+            newPath: "",
+            status: "failed",
+            error: String(error)
+          });
+          totalFailed++;
+        }
+      }
+    }
+    console.log();
+  }
+  if (targetType === "solution" || targetType === "all") {
+    console.log(chalk23.bold("Solutions:"));
+    const solutionsResult = await store.listSolutions({
+      includeDeprecated: true
+    });
+    if (solutionsResult.success && solutionsResult.data) {
+      for (const solution of solutionsResult.data) {
+        totalProcessed++;
+        try {
+          const oldPath = getFilePath(solutionsPath, solution.id);
+          const newPath = getFilePath(
+            solutionsPath,
+            solution.id,
+            solution.name
+          );
+          if (oldPath === newPath) {
+            console.log(chalk23.dim(`  \u2298 ${solution.name} - already migrated`));
+            results.push({
+              type: "solution",
+              name: solution.name,
+              oldPath,
+              newPath,
+              status: "skipped"
+            });
+            totalSkipped++;
+            continue;
+          }
+          if (!isDryRun) {
+            await store.saveSolution(solution);
+          }
+          console.log(chalk23.green(`  \u2713 ${solution.name}`));
+          console.log(chalk23.dim(`    ${oldPath} \u2192 ${newPath}`));
+          results.push({
+            type: "solution",
+            name: solution.name,
+            oldPath,
+            newPath,
+            status: "success"
+          });
+          totalMigrated++;
+        } catch (error) {
+          console.log(chalk23.red(`  \u2717 ${solution.name} - ${error}`));
+          results.push({
+            type: "solution",
+            name: solution.name,
+            oldPath: "",
+            newPath: "",
+            status: "failed",
+            error: String(error)
+          });
+          totalFailed++;
+        }
+      }
+    }
+    console.log();
+  }
+  console.log(chalk23.bold("Summary:"));
+  console.log(chalk23.dim(`  Total patterns: ${totalProcessed}`));
+  if (totalMigrated > 0) {
+    console.log(chalk23.green(`  \u2713 Migrated: ${totalMigrated}`));
+  }
+  if (totalSkipped > 0) {
+    console.log(chalk23.dim(`  \u2298 Already migrated: ${totalSkipped}`));
+  }
+  if (totalFailed > 0) {
+    console.log(chalk23.red(`  \u2717 Failed: ${totalFailed}`));
+  }
+  if (isDryRun && totalMigrated > 0) {
+    console.log(
+      chalk23.yellow(
+        "\n\u26A0\uFE0F  This was a dry run. Run without --dry-run to apply changes."
+      )
+    );
+  } else if (!isDryRun && totalMigrated > 0) {
+    console.log(chalk23.green("\n\u2713 Migration complete!"));
+  } else if (totalSkipped === totalProcessed) {
+    console.log(chalk23.dim("\n\u2713 All patterns already use slugified filenames."));
+  }
+  if (totalFailed > 0) {
+    console.log(
+      chalk23.red(
+        "\n\u26A0\uFE0F  Some patterns failed to migrate. Check the errors above."
+      )
+    );
+    process.exit(1);
+  }
+}
+
 // src/cli/index.ts
 var __filename4 = fileURLToPath4(import.meta.url);
 var __dirname4 = dirname5(__filename4);
 var packageJson = JSON.parse(
-  readFileSync3(join12(__dirname4, "../../package.json"), "utf-8")
+  readFileSync3(join13(__dirname4, "../../package.json"), "utf-8")
 );
 function deprecationWarning(oldCmd, newCmd) {
-  console.warn(chalk23.yellow(`\u26A0\uFE0F  "${oldCmd}" is deprecated and will be removed in v2.0.`));
-  console.warn(chalk23.yellow(`   Use: ${newCmd}
+  console.warn(
+    chalk24.yellow(`\u26A0\uFE0F  "${oldCmd}" is deprecated and will be removed in v2.0.`)
+  );
+  console.warn(chalk24.yellow(`   Use: ${newCmd}
 `));
 }
 var program = new Command7();
@@ -8660,33 +9331,49 @@ program.addCommand(createDocsCommand());
 program.addCommand(createSolutionCommand());
 program.addCommand(createLearnCommand());
 program.addCommand(createScopeCommand());
+program.command("migrate <subcommand>").description("Migrate patterns and configurations").option("--dry-run", "Preview without making changes").option(
+  "--type <type>",
+  "Pattern type to migrate (fix, blueprint, solution, or all)",
+  "all"
+).addHelpText(
+  "after",
+  `
+${chalk24.bold("Subcommands:")}
+  filenames                                           ${chalk24.dim("# Migrate to slugified filenames")}
+
+${chalk24.bold("Examples:")}
+  $ workflow migrate filenames --dry-run              ${chalk24.dim("# Preview migration")}
+  $ workflow migrate filenames                        ${chalk24.dim("# Migrate all patterns")}
+  $ workflow migrate filenames --type fix             ${chalk24.dim("# Migrate only fixes")}
+`
+).action(migrateCommand);
 program.addCommand(createHooksCommand());
 program.command("sync").description("Sync patterns and solutions with the community registry").option("--push", "Push local patterns to registry").option("--pull", "Pull patterns from registry").option("--solutions", "Include solution patterns").option("--learn", "Include learning patterns (default)").option("--scopes", "Sync custom scope packages").option("--all", "Sync everything").option("--dry-run", "Preview without syncing").option("--enable-sync", "Enable pattern sync").option("--disable-sync", "Disable pattern sync").option("--include-private", "Include private patterns in push").addHelpText(
   "after",
   `
-${chalk23.bold("Examples:")}
-  ${chalk23.dim("# Enable sync")}
+${chalk24.bold("Examples:")}
+  ${chalk24.dim("# Enable sync")}
   $ workflow sync --enable-sync
 
-  ${chalk23.dim("# Disable sync")}
+  ${chalk24.dim("# Disable sync")}
   $ workflow sync --disable-sync
 
-  ${chalk23.dim("# Interactive sync (prompts for direction)")}
+  ${chalk24.dim("# Interactive sync (prompts for direction)")}
   $ workflow sync
 
-  ${chalk23.dim("# Push local patterns to registry")}
+  ${chalk24.dim("# Push local patterns to registry")}
   $ workflow sync --push
 
-  ${chalk23.dim("# Pull patterns from registry")}
+  ${chalk24.dim("# Pull patterns from registry")}
   $ workflow sync --pull
 
-  ${chalk23.dim("# Sync solutions only")}
+  ${chalk24.dim("# Sync solutions only")}
   $ workflow sync --solutions --push
 
-  ${chalk23.dim("# Include private patterns in push")}
+  ${chalk24.dim("# Include private patterns in push")}
   $ workflow sync --solutions --push --include-private
 
-  ${chalk23.dim("# Preview what would be synced")}
+  ${chalk24.dim("# Preview what would be synced")}
   $ workflow sync --all --dry-run
 `
 ).action(syncCommand);
@@ -8700,28 +9387,30 @@ program.command("validate <type> [value]").description("Validate branch name, co
 ).action(validateCommand);
 program.command("config <action> [key] [value]").description("Manage workflow configuration").action(configCommand);
 program.command("config:fix").description("Automatically fix common configuration validation issues").action(async () => {
-  const chalk24 = (await import("chalk")).default;
+  const chalk25 = (await import("chalk")).default;
   const { autoFixConfigFile: autoFixConfigFile2 } = await import("../config/index.js");
-  console.log(chalk24.bold.cyan("\n\u{1F527} Workflow Configuration Auto-Fix\n"));
+  console.log(chalk25.bold.cyan("\n\u{1F527} Workflow Configuration Auto-Fix\n"));
   const result = await autoFixConfigFile2();
   if (result.success) {
     if (result.changes.length === 0) {
-      console.log(chalk24.green("\u2713 Configuration is already valid!"));
+      console.log(chalk25.green("\u2713 Configuration is already valid!"));
     } else {
-      console.log(chalk24.green("\u2713 Configuration fixed successfully!\n"));
-      console.log(chalk24.dim("Changes made:"));
+      console.log(chalk25.green("\u2713 Configuration fixed successfully!\n"));
+      console.log(chalk25.dim("Changes made:"));
       for (const change of result.changes) {
-        console.log(chalk24.dim(`  \u2022 ${change}`));
+        console.log(chalk25.dim(`  \u2022 ${change}`));
       }
       console.log();
     }
     process.exit(0);
   } else {
     if (result.configPath) {
-      console.log(chalk24.red(`\u2717 Failed to fix configuration: ${result.error}`));
+      console.log(
+        chalk25.red(`\u2717 Failed to fix configuration: ${result.error}`)
+      );
     } else {
-      console.log(chalk24.red("\u2717 No workflow configuration file found"));
-      console.log(chalk24.yellow("  Run: workflow init"));
+      console.log(chalk25.red("\u2717 No workflow configuration file found"));
+      console.log(chalk25.yellow("  Run: workflow init"));
     }
     process.exit(1);
   }
@@ -8755,7 +9444,10 @@ program.command("scope:migrate", { hidden: true }).description("[DEPRECATED] Use
   deprecationWarning("workflow scope:migrate", "workflow scope migrate");
   return scopeMigrateCommand(options);
 });
-program.command("verify").description("Run all quality checks with fix-and-revalidate pattern").option("--fix", "Enable auto-fix for lint and format issues").option("--max-retries <n>", "Maximum retry cycles (default: 10)", "10").option("--commit", "Commit changes if all checks pass").option("--dry-run", "Preview fixes without applying them").option("--learn", "Record successful fixes as learning patterns").action(verifyCommand);
+program.command("verify").description("Run all quality checks with fix-and-revalidate pattern").option("--fix", "Enable auto-fix for lint and format issues").option("--max-retries <n>", "Maximum retry cycles (default: 10)", "10").option("--commit", "Commit changes if all checks pass").option("--dry-run", "Preview fixes without applying them").option("--learn", "Record successful fixes as learning patterns").option(
+  "--no-platform-checks",
+  "Skip platform-specific checks (Shopify, WordPress, etc.)"
+).action(verifyCommand);
 program.command("pre-commit").description("Run pre-commit checks (alias for verify --fix --staged)").option("--dry-run", "Preview fixes without applying them").action(preCommitCommand);
 program.command("auto-setup", { hidden: true }).description("[DEPRECATED] Use: workflow setup auto").option("-y, --yes", "Auto-approve all prompts").option("--audit", "Show audit report without applying changes").action(async (options) => {
   deprecationWarning("workflow auto-setup", "workflow setup auto");
@@ -8766,7 +9458,10 @@ program.command("advisory", { hidden: true }).description("[DEPRECATED] Use: wor
   return advisoryCommand(options);
 });
 program.command("generate-instructions", { hidden: true }).description("[DEPRECATED] Use: workflow docs generate").option("--force", "Regenerate without confirmation").action(async (options) => {
-  deprecationWarning("workflow generate-instructions", "workflow docs generate");
+  deprecationWarning(
+    "workflow generate-instructions",
+    "workflow docs generate"
+  );
   return docsGenerateCommand(options);
 });
 program.command("update-templates", { hidden: true }).description("[DEPRECATED] Use: workflow docs update").option("--force", "Overwrite existing template files").option("--skip", "Skip the update").action(async (options) => {
@@ -8824,7 +9519,10 @@ program.command("learn:validate", { hidden: true }).description("[DEPRECATED] Us
   return learnValidateCommand(options);
 });
 program.command("solution:capture", { hidden: true }).description("[DEPRECATED] Use: workflow solution capture").option("--name <name>", "Solution name").option("--description <desc>", "Solution description").option("--category <cat>", "Category").option("--keywords <kw>", "Comma-separated keywords").option("--path <path>", "Path to the solution directory").option("--anonymize", "Anonymize sensitive data").option("--private", "Keep solution private").action(async (options) => {
-  deprecationWarning("workflow solution:capture", "workflow solution capture");
+  deprecationWarning(
+    "workflow solution:capture",
+    "workflow solution capture"
+  );
   return solutionCaptureCommand(options);
 });
 program.command("solution:search <query>", { hidden: true }).description("[DEPRECATED] Use: workflow solution search").option("--category <cat>", "Filter by category").option("--framework <fw>", "Filter by framework").option("--limit <n>", "Maximum results", "10").action(async (query, options) => {
@@ -8840,7 +9538,10 @@ program.command("solution:apply <solutionId>", { hidden: true }).description("[D
   return solutionApplyCommand(solutionId, options);
 });
 program.command("solution:deprecate <solutionId> <reason>", { hidden: true }).description("[DEPRECATED] Use: workflow solution deprecate").action(async (solutionId, reason) => {
-  deprecationWarning("workflow solution:deprecate", "workflow solution deprecate");
+  deprecationWarning(
+    "workflow solution:deprecate",
+    "workflow solution deprecate"
+  );
   return solutionDeprecateCommand(solutionId, reason);
 });
 program.command("solution:stats", { hidden: true }).description("[DEPRECATED] Use: workflow solution stats").action(async () => {