workflow-agent-cli 2.20.1 → 2.21.2

package/dist/cli/index.js

@@ -3,12 +3,9 @@ import {
   analyzeProject,
   detectPackageManager,
   generateAuditReport,
-  hasUncommittedChanges,
   isMonorepo,
-  runAllChecks,
-  runAllSetups,
-  stageAllChanges
-} from "../chunk-6NWQLGHI.js";
+  runAllSetups
+} from "../chunk-XGS2VFBP.js";
 import {
   applyReferenceFix,
   validateBranchName,
@@ -33,17 +30,21 @@ import {
   installMandatoryTemplates,
   templateMetadata,
   updateTemplates
-} from "../chunk-CIGGRLZU.js";
+} from "../chunk-YR2X64TH.js";
 import {
   autoFixConfigFile,
   validateScopeDefinitions
 } from "../chunk-YELUGXOM.js";
+import {
+  verifyCommand
+} from "../chunk-OMHCXETM.js";
+import "../chunk-KVM6A42U.js";
 import {
   syncCommand
 } from "../chunk-WXHRDBAB.js";
 
 // src/cli/index.ts
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 import chalk23 from "chalk";
 
 // src/cli/commands/init.ts
@@ -904,6 +905,9 @@ async function doctorCommand(options) {
   }
 }
 
+// src/cli/commands/setup/index.ts
+import { Command } from "commander";
+
 // src/cli/commands/setup.ts
 import * as p3 from "@clack/prompts";
 import chalk6 from "chalk";
@@ -1041,21 +1045,176 @@ async function setupCommand() {
   }
 }
 
-// src/cli/commands/scope-create.ts
+// src/cli/commands/auto-setup-command.ts
 import * as p4 from "@clack/prompts";
 import chalk7 from "chalk";
+async function autoSetupCommand(options) {
+  console.log(chalk7.bold.cyan("\n\u{1F527} Workflow Agent Auto-Setup\n"));
+  const cwd = process.cwd();
+  const spinner10 = p4.spinner();
+  spinner10.start("Analyzing project...");
+  let report;
+  try {
+    report = await generateAuditReport(cwd);
+    spinner10.stop("\u2713 Project analysis complete");
+  } catch (error) {
+    spinner10.stop("\u2717 Failed to analyze project");
+    console.error(
+      chalk7.red(
+        `Error: ${error instanceof Error ? error.message : String(error)}`
+      )
+    );
+    process.exit(1);
+  }
+  console.log("\n" + formatAuditReportColored(report));
+  if (options.audit) {
+    console.log(chalk7.dim("\n--audit mode: No changes applied.\n"));
+    return;
+  }
+  if (report.totalChanges === 0 && report.allDevDependencies.length === 0) {
+    p4.outro(chalk7.green("\u2713 Project is already fully configured!"));
+    return;
+  }
+  if (!options.yes) {
+    const shouldProceed = await p4.confirm({
+      message: `Apply ${report.totalChanges} changes and install ${report.allDevDependencies.length} packages?`,
+      initialValue: true
+    });
+    if (p4.isCancel(shouldProceed) || !shouldProceed) {
+      p4.cancel("Setup cancelled");
+      process.exit(0);
+    }
+  } else {
+    console.log(chalk7.dim("\n--yes mode: Auto-approving all changes.\n"));
+  }
+  console.log("");
+  const setupSpinner = p4.spinner();
+  const stepMessages = [];
+  const results = await runAllSetups(cwd, (step, status) => {
+    if (status === "start") {
+      setupSpinner.start(step);
+    } else if (status === "done") {
+      setupSpinner.stop(`\u2713 ${step}`);
+      stepMessages.push(`\u2713 ${step}`);
+    } else {
+      setupSpinner.stop(`\u2717 ${step}`);
+      stepMessages.push(`\u2717 ${step}`);
+    }
+  });
+  const successCount = results.filter((r) => r.success).length;
+  const failCount = results.filter((r) => !r.success).length;
+  console.log("");
+  if (failCount === 0) {
+    p4.outro(
+      chalk7.green(
+        `\u2713 Auto-setup complete! (${successCount} configurations applied)`
+      )
+    );
+  } else {
+    p4.outro(
+      chalk7.yellow(
+        `\u26A0 Setup completed with issues: ${successCount} succeeded, ${failCount} failed`
+      )
+    );
+  }
+  console.log(chalk7.dim("\nNext steps:"));
+  console.log(chalk7.dim("  1. Review the generated configuration files"));
+  console.log(chalk7.dim("  2. Run: pnpm verify (or npm/yarn)"));
+  console.log(chalk7.dim("  3. Commit your changes\n"));
+}
+function formatAuditReportColored(report) {
+  const lines = [];
+  lines.push(chalk7.bold("\u{1F4CB} Audit Report\n"));
+  lines.push(chalk7.dim(`Framework: ${report.analysis.framework}`));
+  lines.push(chalk7.dim(`Package Manager: ${report.analysis.packageManager}`));
+  lines.push(
+    chalk7.dim(`TypeScript: ${report.analysis.isTypeScript ? "Yes" : "No"}`)
+  );
+  lines.push(
+    chalk7.dim(`Monorepo: ${report.analysis.isMonorepo ? "Yes" : "No"}`)
+  );
+  lines.push("");
+  for (const plan of report.plans) {
+    const hasChanges = plan.changes.some((c) => c.type !== "unchanged");
+    const icon = hasChanges ? "\u{1F527}" : "\u2713";
+    const titleColor = hasChanges ? chalk7.yellow : chalk7.green;
+    lines.push(
+      titleColor(
+        `${icon} ${plan.name.charAt(0).toUpperCase() + plan.name.slice(1)} - ${plan.description}`
+      )
+    );
+    for (const change of plan.changes) {
+      let symbol;
+      let line;
+      switch (change.type) {
+        case "add":
+          symbol = chalk7.green("+");
+          line = chalk7.green(change.description);
+          break;
+        case "modify":
+          symbol = chalk7.yellow("~");
+          line = chalk7.yellow(change.description);
+          if (change.key && change.oldValue !== void 0 && change.newValue !== void 0) {
+            line += chalk7.dim(
+              ` (${String(change.oldValue)} \u2192 ${String(change.newValue)})`
+            );
+          }
+          break;
+        case "unchanged":
+        default:
+          symbol = chalk7.dim("=");
+          line = chalk7.dim(change.description);
+      }
+      lines.push(`  ${symbol} ${line}`);
+    }
+    if (plan.devDependencies.length > 0) {
+      lines.push(
+        chalk7.blue(`  \u{1F4E6} Install: ${plan.devDependencies.join(", ")}`)
+      );
+    }
+    lines.push("");
+  }
+  if (report.allDevDependencies.length > 0) {
+    lines.push(chalk7.bold("Dependencies to install (batched):"));
+    const pm = report.analysis.packageManager;
+    const cmd = pm === "npm" ? "npm install" : pm === "yarn" ? "yarn add" : `${pm} add`;
+    lines.push(
+      chalk7.cyan(`  ${cmd} -D ${report.allDevDependencies.join(" ")}`)
+    );
+    lines.push("");
+  }
+  lines.push(
+    chalk7.bold(
+      `Total: ${report.totalChanges} changes, ${report.allDevDependencies.length} packages`
+    )
+  );
+  return lines.join("\n");
+}
+
+// src/cli/commands/setup/index.ts
+function createSetupCommand() {
+  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);
+  return setupCmd;
+}
+
+// src/cli/commands/scope-create.ts
+import * as p5 from "@clack/prompts";
+import chalk8 from "chalk";
 import { existsSync as existsSync5 } from "fs";
 import { writeFile as writeFile3, mkdir as mkdir3, readFile as readFile2 } from "fs/promises";
 import { join as join5 } from "path";
 async function scopeCreateCommand(options) {
-  console.log(chalk7.bold.cyan("\n\u{1F3A8} Create Custom Scope Package\n"));
+  console.log(chalk8.bold.cyan("\n\u{1F3A8} Create Custom Scope Package\n"));
   const cwd = process.cwd();
   const isNonInteractive = !!(options.name && options.scopes && options.presetName);
   const isMonorepo2 = existsSync5(join5(cwd, "pnpm-workspace.yaml"));
   if (isMonorepo2) {
-    console.log(chalk7.dim("\u2713 Detected monorepo workspace\n"));
+    console.log(chalk8.dim("\u2713 Detected monorepo workspace\n"));
   }
-  const packageNameInput = isNonInteractive ? options.name : await p4.text({
+  const packageNameInput = isNonInteractive ? options.name : await p5.text({
     message: 'What is the package name? (e.g., "fintech", "gaming", "healthcare")',
     placeholder: "my-custom-scope",
     validate: (value) => {
@@ -1067,12 +1226,12 @@ async function scopeCreateCommand(options) {
       return void 0;
     }
   });
-  if (!isNonInteractive && p4.isCancel(packageNameInput)) {
-    p4.cancel("Operation cancelled");
+  if (!isNonInteractive && p5.isCancel(packageNameInput)) {
+    p5.cancel("Operation cancelled");
     process.exit(0);
   }
   const packageName = packageNameInput;
-  const presetNameInput = isNonInteractive ? options.presetName : await p4.text({
+  const presetNameInput = isNonInteractive ? options.presetName : await p5.text({
     message: 'What is the preset display name? (e.g., "FinTech Application", "Gaming Platform")',
     placeholder: "My Custom Preset",
     validate: (value) => {
@@ -1080,8 +1239,8 @@ async function scopeCreateCommand(options) {
       return void 0;
     }
   });
-  if (!isNonInteractive && p4.isCancel(presetNameInput)) {
-    p4.cancel("Operation cancelled");
+  if (!isNonInteractive && p5.isCancel(presetNameInput)) {
+    p5.cancel("Operation cancelled");
     process.exit(0);
   }
   const presetName = presetNameInput;
@@ -1099,11 +1258,11 @@ async function scopeCreateCommand(options) {
     }
   } else {
     console.log(
-      chalk7.dim("\nAdd scopes to your preset (aim for 8-15 scopes):\n")
+      chalk8.dim("\nAdd scopes to your preset (aim for 8-15 scopes):\n")
     );
     let addMore = true;
     while (addMore) {
-      const scopeName = await p4.text({
+      const scopeName = await p5.text({
         message: `Scope #${scopes.length + 1} - Name:`,
         placeholder: "auth",
         validate: (value) => {
@@ -1116,10 +1275,10 @@ async function scopeCreateCommand(options) {
           return void 0;
         }
       });
-      if (p4.isCancel(scopeName)) {
+      if (p5.isCancel(scopeName)) {
         break;
       }
-      const scopeDescription = await p4.text({
+      const scopeDescription = await p5.text({
         message: "Description:",
         placeholder: "Authentication and authorization",
         validate: (value) => {
@@ -1128,17 +1287,17 @@ async function scopeCreateCommand(options) {
           return void 0;
         }
       });
-      if (p4.isCancel(scopeDescription)) {
+      if (p5.isCancel(scopeDescription)) {
         break;
       }
-      const scopeEmoji = await p4.text({
+      const scopeEmoji = await p5.text({
         message: "Emoji (optional):",
         placeholder: "\u{1F510}"
       });
-      if (p4.isCancel(scopeEmoji)) {
+      if (p5.isCancel(scopeEmoji)) {
         break;
       }
-      const scopeCategory = await p4.select({
+      const scopeCategory = await p5.select({
         message: "Category (optional):",
         options: [
           { value: "auth", label: "Authentication & Authorization" },
@@ -1151,7 +1310,7 @@ async function scopeCreateCommand(options) {
           { value: "", label: "None" }
         ]
       });
-      if (p4.isCancel(scopeCategory)) {
+      if (p5.isCancel(scopeCategory)) {
         break;
       }
       scopes.push({
@@ -1160,15 +1319,15 @@ async function scopeCreateCommand(options) {
         emoji: scopeEmoji ? scopeEmoji : void 0,
         category: scopeCategory ? scopeCategory : void 0
       });
-      console.log(chalk7.green(`
+      console.log(chalk8.green(`
 \u2713 Added scope: ${scopeName}
 `));
       if (scopes.length >= 3) {
-        addMore = await p4.confirm({
+        addMore = await p5.confirm({
           message: `You have ${scopes.length} scopes. Add another?`,
           initialValue: scopes.length < 10
         });
-        if (p4.isCancel(addMore)) {
+        if (p5.isCancel(addMore)) {
           break;
         }
         if (!addMore) break;
@@ -1176,20 +1335,20 @@ async function scopeCreateCommand(options) {
     }
   }
   if (scopes.length === 0) {
-    p4.cancel("No scopes defined. Operation cancelled.");
+    p5.cancel("No scopes defined. Operation cancelled.");
     process.exit(1);
   }
   const validation = validateScopeDefinitions(scopes);
   if (!validation.valid) {
-    console.log(chalk7.red("\n\u2717 Scope validation failed:\n"));
+    console.log(chalk8.red("\n\u2717 Scope validation failed:\n"));
     validation.errors.forEach(
-      (error) => console.log(chalk7.red(`  \u2022 ${error}`))
+      (error) => console.log(chalk8.red(`  \u2022 ${error}`))
     );
-    p4.cancel("Operation cancelled");
+    p5.cancel("Operation cancelled");
     process.exit(1);
   }
   console.log(
-    chalk7.green(`
+    chalk8.green(`
 \u2713 ${scopes.length} scopes validated successfully
 `)
   );
@@ -1199,28 +1358,28 @@ async function scopeCreateCommand(options) {
   } else if (isMonorepo2) {
     outputDir = join5(cwd, "packages", `scopes-${packageName}`);
   } else {
-    const customDir = await p4.text({
+    const customDir = await p5.text({
       message: "Output directory:",
       placeholder: `./scopes-${packageName}`,
       defaultValue: `./scopes-${packageName}`
     });
-    if (p4.isCancel(customDir)) {
-      p4.cancel("Operation cancelled");
+    if (p5.isCancel(customDir)) {
+      p5.cancel("Operation cancelled");
       process.exit(0);
     }
     outputDir = join5(cwd, customDir);
   }
   if (existsSync5(outputDir)) {
-    const shouldOverwrite = await p4.confirm({
+    const shouldOverwrite = await p5.confirm({
       message: `Directory ${outputDir} already exists. Overwrite?`,
       initialValue: false
     });
-    if (p4.isCancel(shouldOverwrite) || !shouldOverwrite) {
-      p4.cancel("Operation cancelled");
+    if (p5.isCancel(shouldOverwrite) || !shouldOverwrite) {
+      p5.cancel("Operation cancelled");
       process.exit(0);
     }
   }
-  const spinner10 = p4.spinner();
+  const spinner10 = p5.spinner();
   spinner10.start("Creating package structure...");
   try {
     await mkdir3(join5(outputDir, "src"), { recursive: true });
@@ -1359,111 +1518,111 @@ describe('${presetName} Scope Preset', () => {
       const packagePath = `packages/scopes-${packageName}`;
       if (!workspaceContent.includes(packagePath) && !workspaceContent.includes("packages/*")) {
         console.log(
-          chalk7.yellow("\n\u26A0\uFE0F  Add the following to pnpm-workspace.yaml:")
+          chalk8.yellow("\n\u26A0\uFE0F  Add the following to pnpm-workspace.yaml:")
         );
-        console.log(chalk7.dim(`  - '${packagePath}'`));
+        console.log(chalk8.dim(`  - '${packagePath}'`));
       } else {
-        console.log(chalk7.green("\n\u2713 Package will be included in workspace"));
+        console.log(chalk8.green("\n\u2713 Package will be included in workspace"));
       }
     }
     console.log(
-      chalk7.green.bold("\n\u2728 Custom scope package created successfully!\n")
+      chalk8.green.bold("\n\u2728 Custom scope package created successfully!\n")
     );
-    console.log(chalk7.bold("Package details:"));
-    console.log(chalk7.dim(`  Location: ${outputDir}`));
-    console.log(chalk7.dim(`  Package: @workflow/scopes-${packageName}`));
-    console.log(chalk7.dim(`  Scopes: ${scopes.length} defined
+    console.log(chalk8.bold("Package details:"));
+    console.log(chalk8.dim(`  Location: ${outputDir}`));
+    console.log(chalk8.dim(`  Package: @workflow/scopes-${packageName}`));
+    console.log(chalk8.dim(`  Scopes: ${scopes.length} defined
 `));
-    console.log(chalk7.bold("Next steps:\n"));
-    console.log(chalk7.dim(`  1. cd ${outputDir}`));
-    console.log(chalk7.dim(`  2. pnpm install`));
-    console.log(chalk7.dim(`  3. pnpm build`));
+    console.log(chalk8.bold("Next steps:\n"));
+    console.log(chalk8.dim(`  1. cd ${outputDir}`));
+    console.log(chalk8.dim(`  2. pnpm install`));
+    console.log(chalk8.dim(`  3. pnpm build`));
     if (!options.noTest) {
-      console.log(chalk7.dim(`  4. pnpm test`));
+      console.log(chalk8.dim(`  4. pnpm test`));
     }
     console.log(
-      chalk7.dim(
+      chalk8.dim(
         `  ${!options.noTest ? "5" : "4"}. Update repository URL in package.json`
       )
     );
-    const shouldPublish = isNonInteractive ? false : await p4.confirm({
+    const shouldPublish = isNonInteractive ? false : await p5.confirm({
       message: "\nWould you like instructions for publishing to npm?",
       initialValue: false
     });
-    if (shouldPublish && !p4.isCancel(shouldPublish)) {
-      console.log(chalk7.bold("\n\u{1F4E6} Publishing instructions:\n"));
+    if (shouldPublish && !p5.isCancel(shouldPublish)) {
+      console.log(chalk8.bold("\n\u{1F4E6} Publishing instructions:\n"));
       console.log(
-        chalk7.dim("  1. npm login (or configure .npmrc with your registry)")
+        chalk8.dim("  1. npm login (or configure .npmrc with your registry)")
       );
-      console.log(chalk7.dim("  2. Update version in package.json as needed"));
-      console.log(chalk7.dim("  3. pnpm publish --access public"));
+      console.log(chalk8.dim("  2. Update version in package.json as needed"));
+      console.log(chalk8.dim("  3. pnpm publish --access public"));
       console.log(
-        chalk7.dim(
+        chalk8.dim(
           "  4. Use in other projects: pnpm add @workflow/scopes-" + packageName + "\n"
         )
       );
     }
   } catch (error) {
     spinner10.stop("\u2717 Failed to create package");
-    console.error(chalk7.red("\nError:"), error);
+    console.error(chalk8.red("\nError:"), error);
     process.exit(1);
   }
 }
 
 // src/cli/commands/scope-migrate.ts
-import * as p5 from "@clack/prompts";
-import chalk8 from "chalk";
+import * as p6 from "@clack/prompts";
+import chalk9 from "chalk";
 import { existsSync as existsSync6 } from "fs";
 import { writeFile as writeFile4, mkdir as mkdir4, readFile as readFile3 } from "fs/promises";
 import { join as join6 } from "path";
 async function scopeMigrateCommand(options) {
-  console.log(chalk8.bold.cyan("\n\u{1F504} Migrate Scopes to Custom Package\n"));
+  console.log(chalk9.bold.cyan("\n\u{1F504} Migrate Scopes to Custom Package\n"));
   const cwd = process.cwd();
   if (!hasConfig(cwd)) {
-    p5.cancel("No workflow.config.json found in current directory");
+    p6.cancel("No workflow.config.json found in current directory");
     process.exit(1);
   }
   let config = null;
   try {
     config = await loadConfig(cwd);
   } catch (error) {
-    console.error(chalk8.red("Failed to load config:"), error);
+    console.error(chalk9.red("Failed to load config:"), error);
     process.exit(1);
   }
   if (!config) {
-    p5.cancel("Failed to load configuration");
+    p6.cancel("Failed to load configuration");
     process.exit(1);
   }
   if (!config.scopes || config.scopes.length === 0) {
-    p5.cancel("No scopes found in workflow.config.json");
+    p6.cancel("No scopes found in workflow.config.json");
     process.exit(1);
   }
   console.log(
-    chalk8.dim(`Found ${config.scopes.length} scopes in workflow.config.json
+    chalk9.dim(`Found ${config.scopes.length} scopes in workflow.config.json
 `)
   );
-  console.log(chalk8.bold("Current scopes:"));
+  console.log(chalk9.bold("Current scopes:"));
   config.scopes.forEach((scope, i) => {
     console.log(
-      chalk8.dim(
+      chalk9.dim(
         `  ${i + 1}. ${scope.emoji || "\u2022"} ${scope.name} - ${scope.description}`
       )
     );
   });
   console.log();
-  const shouldContinue = await p5.confirm({
+  const shouldContinue = await p6.confirm({
     message: "Migrate these scopes to a custom package?",
     initialValue: true
   });
-  if (p5.isCancel(shouldContinue) || !shouldContinue) {
-    p5.cancel("Migration cancelled");
+  if (p6.isCancel(shouldContinue) || !shouldContinue) {
+    p6.cancel("Migration cancelled");
     process.exit(0);
   }
   const isMonorepo2 = existsSync6(join6(cwd, "pnpm-workspace.yaml"));
   if (isMonorepo2) {
-    console.log(chalk8.dim("\n\u2713 Detected monorepo workspace\n"));
+    console.log(chalk9.dim("\n\u2713 Detected monorepo workspace\n"));
   }
-  const packageNameInput = options.name || await p5.text({
+  const packageNameInput = options.name || await p6.text({
     message: "Package name for the scope preset:",
     placeholder: config.projectName.toLowerCase().replace(/[^a-z0-9-]/g, "-"),
     validate: (value) => {
@@ -1475,33 +1634,33 @@ async function scopeMigrateCommand(options) {
       return void 0;
     }
   });
-  if (p5.isCancel(packageNameInput)) {
-    p5.cancel("Migration cancelled");
+  if (p6.isCancel(packageNameInput)) {
+    p6.cancel("Migration cancelled");
     process.exit(0);
   }
   const packageName = packageNameInput;
-  const presetNameInput = await p5.text({
+  const presetNameInput = await p6.text({
     message: "Preset display name:",
     placeholder: config.projectName,
     defaultValue: config.projectName
   });
-  if (p5.isCancel(presetNameInput)) {
-    p5.cancel("Migration cancelled");
+  if (p6.isCancel(presetNameInput)) {
+    p6.cancel("Migration cancelled");
     process.exit(0);
   }
   const presetName = presetNameInput;
   const validation = validateScopeDefinitions(config.scopes);
   if (!validation.valid) {
-    console.log(chalk8.yellow("\n\u26A0\uFE0F  Scope validation warnings:\n"));
+    console.log(chalk9.yellow("\n\u26A0\uFE0F  Scope validation warnings:\n"));
     validation.errors.forEach(
-      (error) => console.log(chalk8.yellow(`  \u2022 ${error}`))
+      (error) => console.log(chalk9.yellow(`  \u2022 ${error}`))
     );
-    const shouldFix = await p5.confirm({
+    const shouldFix = await p6.confirm({
       message: "Some scopes have validation issues. Continue anyway?",
       initialValue: false
     });
-    if (p5.isCancel(shouldFix) || !shouldFix) {
-      p5.cancel("Migration cancelled. Please fix validation errors first.");
+    if (p6.isCancel(shouldFix) || !shouldFix) {
+      p6.cancel("Migration cancelled. Please fix validation errors first.");
       process.exit(1);
     }
   }
@@ -1511,28 +1670,28 @@ async function scopeMigrateCommand(options) {
   } else if (isMonorepo2) {
     outputDir = join6(cwd, "packages", `scopes-${packageName}`);
   } else {
-    const customDir = await p5.text({
+    const customDir = await p6.text({
       message: "Output directory:",
       placeholder: `./scopes-${packageName}`,
       defaultValue: `./scopes-${packageName}`
     });
-    if (p5.isCancel(customDir)) {
-      p5.cancel("Migration cancelled");
+    if (p6.isCancel(customDir)) {
+      p6.cancel("Migration cancelled");
       process.exit(0);
     }
     outputDir = join6(cwd, customDir);
   }
   if (existsSync6(outputDir)) {
-    const shouldOverwrite = await p5.confirm({
+    const shouldOverwrite = await p6.confirm({
       message: `Directory ${outputDir} already exists. Overwrite?`,
       initialValue: false
     });
-    if (p5.isCancel(shouldOverwrite) || !shouldOverwrite) {
-      p5.cancel("Migration cancelled");
+    if (p6.isCancel(shouldOverwrite) || !shouldOverwrite) {
+      p6.cancel("Migration cancelled");
       process.exit(0);
     }
   }
-  const spinner10 = p5.spinner();
+  const spinner10 = p6.spinner();
   spinner10.start("Migrating scopes to package...");
   try {
     await mkdir4(join6(outputDir, "src"), { recursive: true });
@@ -1668,18 +1827,18 @@ describe('${presetName} Scope Preset (Migrated)', () => {
       const packagePath = `packages/scopes-${packageName}`;
       if (!workspaceContent.includes(packagePath) && !workspaceContent.includes("packages/*")) {
         console.log(
-          chalk8.yellow("\n\u26A0\uFE0F  Add the following to pnpm-workspace.yaml:")
+          chalk9.yellow("\n\u26A0\uFE0F  Add the following to pnpm-workspace.yaml:")
         );
-        console.log(chalk8.dim(`  - '${packagePath}'`));
+        console.log(chalk9.dim(`  - '${packagePath}'`));
       } else {
-        console.log(chalk8.green("\n\u2713 Package will be included in workspace"));
+        console.log(chalk9.green("\n\u2713 Package will be included in workspace"));
       }
     }
-    const keepConfig = options.keepConfig ?? await p5.confirm({
+    const keepConfig = options.keepConfig ?? await p6.confirm({
       message: "Remove migrated scopes from workflow.config.json?",
       initialValue: false
     });
-    if (!p5.isCancel(keepConfig) && !keepConfig) {
+    if (!p6.isCancel(keepConfig) && !keepConfig) {
       const configPath = join6(cwd, "workflow.config.json");
       const updatedConfig = {
         ...config,
@@ -1693,428 +1852,78 @@ describe('${presetName} Scope Preset (Migrated)', () => {
         JSON.stringify(updatedConfig, null, 2),
         "utf-8"
       );
-      console.log(chalk8.green("\u2713 Updated workflow.config.json"));
-      console.log(chalk8.dim("  \u2022 Cleared inline scopes"));
+      console.log(chalk9.green("\u2713 Updated workflow.config.json"));
+      console.log(chalk9.dim("  \u2022 Cleared inline scopes"));
       console.log(
-        chalk8.dim(`  \u2022 Added preset reference: scopes-${packageName}
+        chalk9.dim(`  \u2022 Added preset reference: scopes-${packageName}
 `)
       );
     }
-    console.log(chalk8.green.bold("\n\u2728 Migration completed successfully!\n"));
-    console.log(chalk8.bold("Package details:"));
-    console.log(chalk8.dim(`  Location: ${outputDir}`));
-    console.log(chalk8.dim(`  Package: @workflow/scopes-${packageName}`));
-    console.log(chalk8.dim(`  Scopes: ${config.scopes.length} migrated
+    console.log(chalk9.green.bold("\n\u2728 Migration completed successfully!\n"));
+    console.log(chalk9.bold("Package details:"));
+    console.log(chalk9.dim(`  Location: ${outputDir}`));
+    console.log(chalk9.dim(`  Package: @workflow/scopes-${packageName}`));
+    console.log(chalk9.dim(`  Scopes: ${config.scopes.length} migrated
 `));
-    console.log(chalk8.bold("Next steps:\n"));
-    console.log(chalk8.dim(`  1. cd ${outputDir}`));
-    console.log(chalk8.dim(`  2. pnpm install`));
-    console.log(chalk8.dim(`  3. pnpm build`));
-    console.log(chalk8.dim(`  4. pnpm test`));
-    console.log(chalk8.dim(`  5. Update repository URL in package.json
+    console.log(chalk9.bold("Next steps:\n"));
+    console.log(chalk9.dim(`  1. cd ${outputDir}`));
+    console.log(chalk9.dim(`  2. pnpm install`));
+    console.log(chalk9.dim(`  3. pnpm build`));
+    console.log(chalk9.dim(`  4. pnpm test`));
+    console.log(chalk9.dim(`  5. Update repository URL in package.json
 `));
     if (!keepConfig) {
-      console.log(chalk8.bold("To use the migrated scopes:\n"));
+      console.log(chalk9.bold("To use the migrated scopes:\n"));
       console.log(
-        chalk8.dim(
+        chalk9.dim(
           `  1. Install the package: pnpm add -w @workflow/scopes-${packageName}`
         )
       );
-      console.log(
-        chalk8.dim(
-          `  2. The preset is already referenced in workflow.config.json
-`
-        )
-      );
-    }
-    console.log(
-      chalk8.dim(
-        "\u{1F4A1} Tip: You can now reuse this scope package across multiple projects!\n"
-      )
-    );
-  } catch (error) {
-    spinner10.stop("\u2717 Migration failed");
-    console.error(chalk8.red("\nError:"), error);
-    process.exit(1);
-  }
-}
-
-// src/cli/commands/verify.ts
-import chalk9 from "chalk";
-import { execa as execa2 } from "execa";
-import {
-  PatternStore,
-  TelemetryCollector,
-  ContributorManager
-} from "@hawkinside_out/workflow-improvement-tracker";
-async function verifyCommand(options) {
-  const cwd = process.cwd();
-  const maxRetries = options.maxRetries ? parseInt(options.maxRetries, 10) : 10;
-  const autoFix = options.fix ?? false;
-  const shouldCommit = options.commit ?? false;
-  const dryRun = options.dryRun ?? false;
-  const learnFromFixes = options.learn ?? false;
-  console.log(chalk9.bold.cyan("\n\u{1F50D} Workflow Agent Quality Verification\n"));
-  if (dryRun) {
-    console.log(chalk9.yellow("\u{1F4CB} DRY-RUN MODE: No changes will be applied\n"));
-  }
-  console.log(chalk9.dim(`  Auto-fix: ${autoFix ? "enabled" : "disabled"}`));
-  console.log(chalk9.dim(`  Max retries: ${maxRetries}`));
-  console.log(chalk9.dim(`  Commit on success: ${shouldCommit ? "yes" : "no"}`));
-  console.log(chalk9.dim(`  Dry-run: ${dryRun ? "yes" : "no"}`));
-  console.log(
-    chalk9.dim(`  Learn from fixes: ${learnFromFixes ? "yes" : "no"}`)
-  );
-  const startTime = Date.now();
-  const result = await runAllChecks(cwd, {
-    maxRetries,
-    autoFix,
-    dryRun
-  });
-  const totalTime = ((Date.now() - startTime) / 1e3).toFixed(2);
-  console.log(`
-${"\u2501".repeat(50)}`);
-  if (result.success) {
-    console.log(chalk9.bold.green("\n\u2705 ALL QUALITY CHECKS PASSED!\n"));
-    console.log(chalk9.dim(`  Total time: ${totalTime}s`));
-    console.log(chalk9.dim(`  Validation cycles: ${result.totalAttempts}`));
-    console.log(chalk9.dim(`  Fixes applied: ${result.fixesApplied}`));
-    if (learnFromFixes && result.fixesApplied > 0 && !dryRun) {
-      await recordSuccessfulFixes(cwd, result);
-    }
-    if (shouldCommit) {
-      const hasChanges = await hasUncommittedChanges(cwd);
-      if (hasChanges) {
-        console.log(chalk9.cyan("\n\u{1F4E6} Staging and committing changes...\n"));
-        const staged = await stageAllChanges(cwd);
-        if (!staged) {
-          console.log(chalk9.red("\u274C Failed to stage changes"));
-          process.exit(1);
-        }
-        try {
-          await execa2(
-            "git",
-            ["commit", "-m", "chore: auto-fix quality issues"],
-            { cwd }
-          );
-          console.log(chalk9.green("\u2705 Changes committed successfully"));
-        } catch (error) {
-          console.log(chalk9.red("\u274C Failed to commit changes"));
-          console.log(chalk9.dim(error.message));
-          process.exit(1);
-        }
-      } else {
-        console.log(chalk9.dim("\n  No changes to commit."));
-      }
-    }
-    console.log(chalk9.cyan("\n\u{1F4A1} Next steps:\n"));
-    console.log(chalk9.dim("  1. git add ."));
-    console.log(
-      chalk9.dim('  2. git commit -m "<type>(<scope>): <description>"')
-    );
-    console.log(chalk9.dim("  3. git push origin <branch-name>"));
-    console.log("");
-    process.exit(0);
-  } else {
-    console.log(chalk9.bold.red("\n\u274C QUALITY CHECKS FAILED\n"));
-    console.log(chalk9.dim(`  Total time: ${totalTime}s`));
-    console.log(chalk9.dim(`  Validation cycles: ${result.totalAttempts}`));
-    console.log(chalk9.dim(`  Fixes applied: ${result.fixesApplied}`));
-    if (result.pendingFixes && result.pendingFixes.length > 0) {
-      console.log(chalk9.yellow("\n\u{1F4CB} Pending fixes (dry-run):"));
-      for (const fix of result.pendingFixes) {
-        console.log(chalk9.dim(`  \u2022 ${fix.check.displayName}: ${fix.command}`));
-      }
-    }
-    console.log(
-      chalk9.yellow("\n\u26A0\uFE0F  Please fix the errors above and run again.")
-    );
-    console.log(
-      chalk9.dim("  Run with --fix to auto-fix lint and format issues.")
-    );
-    console.log("");
-    process.exit(1);
-  }
-}
-async function recordSuccessfulFixes(cwd, result) {
-  try {
-    const contributorManager = new ContributorManager(cwd);
-    const telemetryEnabled = await contributorManager.isTelemetryEnabled();
-    if (!telemetryEnabled) {
-      return;
-    }
-    const store = new PatternStore(cwd);
-    const telemetry = new TelemetryCollector(cwd);
-    let framework = "unknown";
-    let frameworkVersion = "0.0.0";
-    try {
-      const fs3 = await import("fs");
-      const path4 = await import("path");
-      const packageJsonPath = path4.join(cwd, "package.json");
-      const packageJson = JSON.parse(
-        await fs3.promises.readFile(packageJsonPath, "utf-8")
-      );
-      const deps = {
-        ...packageJson.dependencies,
-        ...packageJson.devDependencies
-      };
-      if (deps["next"]) {
-        framework = "next";
-        frameworkVersion = deps["next"].replace(/[\^~]/, "");
-      } else if (deps["react"]) {
-        framework = "react";
-        frameworkVersion = deps["react"].replace(/[\^~]/, "");
-      } else if (deps["vue"]) {
-        framework = "vue";
-        frameworkVersion = deps["vue"].replace(/[\^~]/, "");
-      } else if (deps["express"]) {
-        framework = "express";
-        frameworkVersion = deps["express"].replace(/[\^~]/, "");
-      }
-    } catch {
-    }
-    if (result.appliedFixes && result.appliedFixes.length > 0) {
-      console.log(
-        chalk9.cyan("\n\u{1F4DA} Recording successful fixes for learning...\n")
-      );
-      for (const fix of result.appliedFixes) {
-        const patternName = `Auto-fix: ${fix.displayName}`;
-        const patternId = crypto.randomUUID();
-        const existingPatterns = await store.listFixPatterns({
-          tags: [{ category: "tool", name: fix.checkName }]
-        });
-        if (existingPatterns.success && existingPatterns.data && existingPatterns.data.length > 0) {
-          const existingPattern = existingPatterns.data[0];
-          await store.updateFixMetrics(existingPattern.id, true);
-          await telemetry.recordSuccess(
-            existingPattern.id,
-            "fix",
-            framework,
-            frameworkVersion
-          );
-          console.log(chalk9.dim(`  \u2713 Updated: ${existingPattern.name}`));
-        } else {
-          const now = (/* @__PURE__ */ new Date()).toISOString();
-          const newPattern = {
-            id: patternId,
-            name: patternName,
-            description: `Auto-fix pattern for ${fix.displayName} using command: ${fix.command}`,
-            category: "config",
-            tags: [
-              { category: "tool", name: fix.checkName },
-              { category: "framework", name: framework }
-            ],
-            trigger: {
-              errorPattern: fix.checkName,
-              errorMessage: `${fix.checkName} check failed`,
-              filePattern: "**/*"
-            },
-            solution: {
-              type: "command",
-              steps: [
-                {
-                  order: 1,
-                  action: "run",
-                  target: fix.command,
-                  description: `Run ${fix.command}`
-                }
-              ]
-            },
-            compatibility: {
-              framework,
-              frameworkVersion: `>=${frameworkVersion}`,
-              runtime: "node",
-              runtimeVersion: ">=18.0.0",
-              dependencies: []
-            },
-            metrics: {
-              applications: 1,
-              successes: 1,
-              failures: 0,
-              successRate: 100,
-              lastUsed: now,
-              lastSuccessful: now
-            },
-            source: "verify-fix",
-            isPrivate: true,
-            createdAt: now,
-            updatedAt: now
-          };
-          const saveResult = await store.saveFixPattern(newPattern);
-          if (saveResult.success) {
-            await telemetry.recordSuccess(
-              patternId,
-              "fix",
-              framework,
-              frameworkVersion
-            );
-            console.log(chalk9.dim(`  \u2713 Recorded: ${patternName}`));
-          }
-        }
-      }
-      console.log(
-        chalk9.dim(`
-  Use 'workflow learn:list' to see recorded patterns.`)
-      );
-    }
-  } catch (error) {
-    console.log(
-      chalk9.dim(
-        `
-  Note: Could not record learning patterns: ${error.message}`
-      )
-    );
-  }
-}
-
-// src/cli/commands/auto-setup-command.ts
-import * as p6 from "@clack/prompts";
-import chalk10 from "chalk";
-async function autoSetupCommand(options) {
-  console.log(chalk10.bold.cyan("\n\u{1F527} Workflow Agent Auto-Setup\n"));
-  const cwd = process.cwd();
-  const spinner10 = p6.spinner();
-  spinner10.start("Analyzing project...");
-  let report;
-  try {
-    report = await generateAuditReport(cwd);
-    spinner10.stop("\u2713 Project analysis complete");
-  } catch (error) {
-    spinner10.stop("\u2717 Failed to analyze project");
-    console.error(
-      chalk10.red(
-        `Error: ${error instanceof Error ? error.message : String(error)}`
-      )
-    );
-    process.exit(1);
-  }
-  console.log("\n" + formatAuditReportColored(report));
-  if (options.audit) {
-    console.log(chalk10.dim("\n--audit mode: No changes applied.\n"));
-    return;
-  }
-  if (report.totalChanges === 0 && report.allDevDependencies.length === 0) {
-    p6.outro(chalk10.green("\u2713 Project is already fully configured!"));
-    return;
-  }
-  if (!options.yes) {
-    const shouldProceed = await p6.confirm({
-      message: `Apply ${report.totalChanges} changes and install ${report.allDevDependencies.length} packages?`,
-      initialValue: true
-    });
-    if (p6.isCancel(shouldProceed) || !shouldProceed) {
-      p6.cancel("Setup cancelled");
-      process.exit(0);
-    }
-  } else {
-    console.log(chalk10.dim("\n--yes mode: Auto-approving all changes.\n"));
-  }
-  console.log("");
-  const setupSpinner = p6.spinner();
-  const stepMessages = [];
-  const results = await runAllSetups(cwd, (step, status) => {
-    if (status === "start") {
-      setupSpinner.start(step);
-    } else if (status === "done") {
-      setupSpinner.stop(`\u2713 ${step}`);
-      stepMessages.push(`\u2713 ${step}`);
-    } else {
-      setupSpinner.stop(`\u2717 ${step}`);
-      stepMessages.push(`\u2717 ${step}`);
-    }
-  });
-  const successCount = results.filter((r) => r.success).length;
-  const failCount = results.filter((r) => !r.success).length;
-  console.log("");
-  if (failCount === 0) {
-    p6.outro(
-      chalk10.green(
-        `\u2713 Auto-setup complete! (${successCount} configurations applied)`
-      )
-    );
-  } else {
-    p6.outro(
-      chalk10.yellow(
-        `\u26A0 Setup completed with issues: ${successCount} succeeded, ${failCount} failed`
-      )
-    );
-  }
-  console.log(chalk10.dim("\nNext steps:"));
-  console.log(chalk10.dim("  1. Review the generated configuration files"));
-  console.log(chalk10.dim("  2. Run: pnpm verify (or npm/yarn)"));
-  console.log(chalk10.dim("  3. Commit your changes\n"));
-}
-function formatAuditReportColored(report) {
-  const lines = [];
-  lines.push(chalk10.bold("\u{1F4CB} Audit Report\n"));
-  lines.push(chalk10.dim(`Framework: ${report.analysis.framework}`));
-  lines.push(chalk10.dim(`Package Manager: ${report.analysis.packageManager}`));
-  lines.push(
-    chalk10.dim(`TypeScript: ${report.analysis.isTypeScript ? "Yes" : "No"}`)
-  );
-  lines.push(
-    chalk10.dim(`Monorepo: ${report.analysis.isMonorepo ? "Yes" : "No"}`)
-  );
-  lines.push("");
-  for (const plan of report.plans) {
-    const hasChanges = plan.changes.some((c) => c.type !== "unchanged");
-    const icon = hasChanges ? "\u{1F527}" : "\u2713";
-    const titleColor = hasChanges ? chalk10.yellow : chalk10.green;
-    lines.push(
-      titleColor(
-        `${icon} ${plan.name.charAt(0).toUpperCase() + plan.name.slice(1)} - ${plan.description}`
-      )
-    );
-    for (const change of plan.changes) {
-      let symbol;
-      let line;
-      switch (change.type) {
-        case "add":
-          symbol = chalk10.green("+");
-          line = chalk10.green(change.description);
-          break;
-        case "modify":
-          symbol = chalk10.yellow("~");
-          line = chalk10.yellow(change.description);
-          if (change.key && change.oldValue !== void 0 && change.newValue !== void 0) {
-            line += chalk10.dim(
-              ` (${String(change.oldValue)} \u2192 ${String(change.newValue)})`
-            );
-          }
-          break;
-        case "unchanged":
-        default:
-          symbol = chalk10.dim("=");
-          line = chalk10.dim(change.description);
-      }
-      lines.push(`  ${symbol} ${line}`);
-    }
-    if (plan.devDependencies.length > 0) {
-      lines.push(
-        chalk10.blue(`  \u{1F4E6} Install: ${plan.devDependencies.join(", ")}`)
-      );
+      console.log(
+        chalk9.dim(
+          `  2. The preset is already referenced in workflow.config.json
+`
+        )
+      );
     }
-    lines.push("");
-  }
-  if (report.allDevDependencies.length > 0) {
-    lines.push(chalk10.bold("Dependencies to install (batched):"));
-    const pm = report.analysis.packageManager;
-    const cmd = pm === "npm" ? "npm install" : pm === "yarn" ? "yarn add" : `${pm} add`;
-    lines.push(
-      chalk10.cyan(`  ${cmd} -D ${report.allDevDependencies.join(" ")}`)
+    console.log(
+      chalk9.dim(
+        "\u{1F4A1} Tip: You can now reuse this scope package across multiple projects!\n"
+      )
     );
-    lines.push("");
+  } catch (error) {
+    spinner10.stop("\u2717 Migration failed");
+    console.error(chalk9.red("\nError:"), error);
+    process.exit(1);
   }
-  lines.push(
-    chalk10.bold(
-      `Total: ${report.totalChanges} changes, ${report.allDevDependencies.length} packages`
-    )
-  );
-  return lines.join("\n");
+}
+
+// src/cli/commands/pre-commit.ts
+import chalk10 from "chalk";
+async function preCommitCommand(options) {
+  const stagedOnly = options.stagedOnly ?? true;
+  const dryRun = options.dryRun ?? false;
+  const maxRetries = options.maxRetries ?? "5";
+  console.log(chalk10.bold.cyan("\n\u{1F512} Pre-Commit Quality Check\n"));
+  if (dryRun) {
+    console.log(chalk10.yellow("\u{1F4CB} DRY-RUN MODE: No changes will be applied\n"));
+  }
+  if (stagedOnly) {
+    console.log(chalk10.dim("  Checking staged files only...\n"));
+  }
+  await verifyCommand({
+    fix: true,
+    maxRetries,
+    commit: false,
+    // Never auto-commit in pre-commit
+    dryRun,
+    learn: false
+    // Skip learning in pre-commit for speed
+  });
 }
 
 // src/cli/commands/docs/index.ts
-import { Command } from "commander";
+import { Command as Command2 } from "commander";
 import chalk15 from "chalk";
 
 // src/cli/commands/docs-validate.ts
@@ -5145,7 +4954,7 @@ function checkCIThresholds(analysis, config) {
 
 // src/cli/commands/docs/index.ts
 function createDocsCommand() {
-  const docsCmd = new Command("docs").description("Manage documentation and guidelines").addHelpText(
+  const docsCmd = new Command2("docs").description("Manage documentation and guidelines").addHelpText(
     "after",
     `
 ${chalk15.bold("Examples:")}
@@ -5218,7 +5027,7 @@ ${chalk15.bold("Examples:")}
 }
 
 // src/cli/commands/hooks/index.ts
-import { Command as Command2 } from "commander";
+import { Command as Command3 } from "commander";
 import chalk17 from "chalk";
 
 // src/cli/commands/hooks.ts
@@ -5337,62 +5146,8 @@ async function statusHooksAction(cwd) {
   }
 }
 
-// src/cli/commands/hooks/index.ts
-async function installAction() {
-  return hooksCommand("install");
-}
-async function uninstallAction() {
-  return hooksCommand("uninstall");
-}
-async function statusAction() {
-  return hooksCommand("status");
-}
-function createHooksCommand() {
-  const hooksCmd = new Command2("hooks").description("Manage git hooks for the project").addHelpText(
-    "after",
-    `
-${chalk17.bold("Examples:")}
-  $ workflow hooks install                ${chalk17.dim("# Install git hooks")}
-  $ workflow hooks uninstall              ${chalk17.dim("# Remove git hooks")}
-  $ workflow hooks status                 ${chalk17.dim("# Check hooks status")}
-`
-  ).action(() => {
-    hooksCmd.help();
-  });
-  hooksCmd.command("install").description("Install git hooks for the project").addHelpText(
-    "after",
-    `
-${chalk17.bold("Details:")}
-  Installs pre-commit and commit-msg hooks that:
-  - Validate branch names
-  - Validate commit message format
-  - Run quality checks before commit
-
-  If existing hooks are found, they will be wrapped
-  so both the original and workflow hooks run.
-`
-  ).action(installAction);
-  hooksCmd.command("uninstall").description("Remove installed git hooks").addHelpText(
-    "after",
-    `
-${chalk17.bold("Details:")}
-  Removes workflow agent hooks from the project.
-  If original hooks were wrapped, they will be restored.
-`
-  ).action(uninstallAction);
-  hooksCmd.command("status").description("Show current hooks installation status").addHelpText(
-    "after",
-    `
-${chalk17.bold("Details:")}
-  Shows which git hooks are installed and whether
-  they are managed by workflow agent.
-`
-  ).action(statusAction);
-  return hooksCmd;
-}
-
 // src/cli/commands/solution/index.ts
-import { Command as Command3 } from "commander";
+import { Command as Command4 } from "commander";
 import chalk19 from "chalk";
 
 // src/cli/commands/solution.ts
@@ -5400,7 +5155,7 @@ import chalk18 from "chalk";
 import * as p11 from "@clack/prompts";
 import * as path2 from "path";
 import {
-  PatternStore as PatternStore2,
+  PatternStore,
   CodeAnalyzer
 } from "@hawkinside_out/workflow-improvement-tracker";
 function getWorkspacePath() {
@@ -5438,7 +5193,8 @@ function truncate(str, maxLen) {
 }
 async function solutionCaptureCommand(options) {
   const cwd = getWorkspacePath();
-  const store = new PatternStore2(cwd);
+  const store = new PatternStore(cwd);
+  await store.initialize();
   console.log(chalk18.cyan("\n\u{1F4E6} Capture Solution Pattern\n"));
   let targetPath = options.path;
   if (!targetPath) {
@@ -5586,7 +5342,8 @@ async function solutionCaptureCommand(options) {
 }
 async function solutionSearchCommand(query, options) {
   const cwd = getWorkspacePath();
-  const store = new PatternStore2(cwd);
+  const store = new PatternStore(cwd);
+  await store.initialize();
   console.log(chalk18.cyan("\n\u{1F50D} Search Solution Patterns\n"));
   const keywords = query.split(/\s+/).filter((k) => k.length > 0);
   const result = await store.searchSolutions(keywords, {
@@ -5626,7 +5383,8 @@ async function solutionSearchCommand(query, options) {
 }
 async function solutionListCommand(options) {
   const cwd = getWorkspacePath();
-  const store = new PatternStore2(cwd);
+  const store = new PatternStore(cwd);
+  await store.initialize();
   console.log(chalk18.cyan("\n\u{1F4CB} Solution Patterns\n"));
   const result = await store.listSolutions({
     category: options.category,
@@ -5681,7 +5439,8 @@ ${formatCategory(category)}`));
 }
 async function solutionApplyCommand(solutionId, options) {
   const cwd = getWorkspacePath();
-  const store = new PatternStore2(cwd);
+  const store = new PatternStore(cwd);
+  await store.initialize();
   console.log(chalk18.cyan("\n\u{1F680} Apply Solution Pattern\n"));
   const result = await store.getSolution(solutionId);
   if (!result.success || !result.data) {
@@ -5779,7 +5538,8 @@ async function solutionApplyCommand(solutionId, options) {
 }
 async function solutionDeprecateCommand(solutionId, reason) {
   const cwd = getWorkspacePath();
-  const store = new PatternStore2(cwd);
+  const store = new PatternStore(cwd);
+  await store.initialize();
   console.log(chalk18.cyan("\n\u26A0\uFE0F  Deprecate Solution Pattern\n"));
   const result = await store.getSolution(solutionId);
   if (!result.success || !result.data) {
@@ -5807,7 +5567,8 @@ async function solutionDeprecateCommand(solutionId, reason) {
 }
 async function solutionStatsCommand() {
   const cwd = getWorkspacePath();
-  const store = new PatternStore2(cwd);
+  const store = new PatternStore(cwd);
+  await store.initialize();
   console.log(chalk18.cyan("\n\u{1F4CA} Solution Pattern Statistics\n"));
   const stats = await store.getStats();
   console.log(chalk18.dim("\u2500".repeat(40)));
@@ -5834,20 +5595,363 @@ ${chalk18.bold("By Category:")}`);
   }
   console.log();
 }
+async function solutionCreateCommand(options) {
+  const cwd = getWorkspacePath();
+  const store = new PatternStore(cwd);
+  await store.initialize();
+  console.log(chalk18.cyan("\n\u2728 Create Solution Pattern\n"));
+  let name = options.name;
+  if (!name) {
+    const nameInput = await p11.text({
+      message: "Solution name:",
+      placeholder: "My Custom Solution",
+      validate: (val) => {
+        if (!val || val.length < 3) return "Name must be at least 3 characters";
+        return void 0;
+      }
+    });
+    if (p11.isCancel(nameInput)) {
+      p11.cancel("Operation cancelled");
+      process.exit(0);
+    }
+    name = nameInput;
+  }
+  let description = options.description;
+  if (!description) {
+    const descInput = await p11.text({
+      message: "Solution description:",
+      placeholder: "A description of what this solution does",
+      validate: (val) => {
+        if (!val || val.length < 10)
+          return "Description must be at least 10 characters";
+        return void 0;
+      }
+    });
+    if (p11.isCancel(descInput)) {
+      p11.cancel("Operation cancelled");
+      process.exit(0);
+    }
+    description = descInput;
+  }
+  let category = options.category;
+  if (!category) {
+    const categoryChoice = await p11.select({
+      message: "Solution category:",
+      options: [
+        { value: "auth", label: "\u{1F510} Authentication" },
+        { value: "api", label: "\u{1F310} API" },
+        { value: "database", label: "\u{1F4BE} Database" },
+        { value: "ui", label: "\u{1F3A8} UI/Components" },
+        { value: "testing", label: "\u{1F9EA} Testing" },
+        { value: "deployment", label: "\u{1F680} Deployment" },
+        { value: "integrations", label: "\u{1F517} Integrations" },
+        { value: "performance", label: "\u26A1 Performance" },
+        { value: "security", label: "\u{1F6E1}\uFE0F Security" },
+        { value: "other", label: "\u{1F4E6} Other" }
+      ]
+    });
+    if (p11.isCancel(categoryChoice)) {
+      p11.cancel("Operation cancelled");
+      process.exit(0);
+    }
+    category = categoryChoice;
+  }
+  let keywords = [];
+  if (options.keywords) {
+    keywords = options.keywords.split(",").map((k) => k.trim());
+  } else {
+    const keywordsInput = await p11.text({
+      message: "Keywords (comma-separated):",
+      placeholder: "auth, jwt, login"
+    });
+    if (p11.isCancel(keywordsInput)) {
+      p11.cancel("Operation cancelled");
+      process.exit(0);
+    }
+    if (keywordsInput) {
+      keywords = keywordsInput.split(",").map((k) => k.trim());
+    }
+  }
+  const framework = options.framework || "generic";
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const solution = {
+    id: crypto.randomUUID(),
+    name,
+    description,
+    category,
+    keywords,
+    implementation: {
+      files: [],
+      dependencies: [],
+      devDependencies: [],
+      envVars: []
+    },
+    compatibility: {
+      framework,
+      frameworkVersion: ">=1.0.0",
+      runtime: "node",
+      runtimeVersion: ">=18.0.0",
+      dependencies: []
+    },
+    metrics: {
+      applications: 0,
+      successes: 0,
+      failures: 0,
+      successRate: 0
+    },
+    isPrivate: true,
+    createdAt: now,
+    updatedAt: now
+  };
+  await store.saveSolution(solution);
+  console.log(chalk18.green("\n\u2713 Solution pattern created!\n"));
+  console.log(chalk18.dim(`  ID: ${solution.id}`));
+  console.log(chalk18.dim(`  Name: ${name}`));
+  console.log(chalk18.dim(`  Category: ${category}`));
+  console.log(chalk18.dim(`
+Add files using 'workflow solution capture --path <dir>'`));
+}
+async function solutionShowCommand(solutionId) {
+  const cwd = getWorkspacePath();
+  const store = new PatternStore(cwd);
+  await store.initialize();
+  console.log(chalk18.cyan("\n\u{1F4CB} Solution Details\n"));
+  const result = await store.getSolution(solutionId);
+  if (!result.success || !result.data) {
+    console.error(chalk18.red(`
+\u2717 Solution not found: ${solutionId}
+`));
+    process.exit(1);
+  }
+  const solution = result.data;
+  console.log(chalk18.dim("\u2500".repeat(60)));
+  console.log(chalk18.bold(`Name: ${solution.name}`));
+  console.log(`ID: ${chalk18.dim(solution.id)}`);
+  console.log(`Category: ${formatCategory(solution.category)}`);
+  console.log(`Description: ${solution.description}`);
+  console.log(chalk18.dim("\u2500".repeat(60)));
+  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(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}`);
+    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}`);
+    for (const env of solution.implementation.envVars) {
+      const required = env.required ? chalk18.red("*") : "";
+      console.log(chalk18.dim(`    \u2022 ${env.name}${required}`));
+    }
+  }
+  console.log(chalk18.bold("\nMetrics:"));
+  console.log(`  Applications: ${solution.metrics.applications}`);
+  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();
+}
+async function solutionExportCommand(options) {
+  const cwd = getWorkspacePath();
+  const store = new PatternStore(cwd);
+  await store.initialize();
+  const format = options.format ?? "json";
+  const outputPath = options.output ?? `solutions-export.${format}`;
+  console.log(chalk18.cyan("\n\u{1F4E4} Exporting Solution Patterns\n"));
+  const result = await store.listSolutions({
+    solutionCategory: options.category,
+    limit: 1e3
+  });
+  if (!result.success || !result.data) {
+    console.error(chalk18.red(`
+\u2717 Export failed: ${result.error}
+`));
+    process.exit(1);
+  }
+  const solutions = result.data;
+  if (solutions.length === 0) {
+    console.log(chalk18.yellow("  No solutions to export"));
+    return;
+  }
+  const fs3 = await import("fs");
+  const pathModule = await import("path");
+  let output;
+  if (format === "yaml") {
+    output = `# Workflow Agent Solutions Export
+# Exported: ${(/* @__PURE__ */ new Date()).toISOString()}
+
+solutions:
+`;
+    for (const solution of solutions) {
+      output += `  - id: ${solution.id}
+`;
+      output += `    name: "${solution.name}"
+`;
+      output += `    category: ${solution.category}
+`;
+      output += `    description: "${solution.description}"
+
+`;
+    }
+  } else {
+    output = JSON.stringify(
+      {
+        version: "1.0",
+        exportedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        solutions
+      },
+      null,
+      2
+    );
+  }
+  const fullOutputPath = pathModule.default.isAbsolute(outputPath) ? outputPath : pathModule.default.join(cwd, outputPath);
+  await fs3.promises.writeFile(fullOutputPath, output, "utf-8");
+  console.log(chalk18.green(`  \u2713 Exported ${solutions.length} solutions
+`));
+  console.log(chalk18.dim(`    Output: ${fullOutputPath}`));
+  console.log(chalk18.dim(`    Format: ${format.toUpperCase()}`));
+}
+async function solutionImportCommand(file, options) {
+  const cwd = getWorkspacePath();
+  const store = new PatternStore(cwd);
+  await store.initialize();
+  const dryRun = options.dryRun ?? false;
+  const merge = options.merge ?? true;
+  console.log(chalk18.cyan("\n\u{1F4E5} Importing Solution Patterns\n"));
+  const fs3 = await import("fs");
+  const pathModule = await import("path");
+  const filePath = pathModule.default.isAbsolute(file) ? file : pathModule.default.join(cwd, file);
+  if (!fs3.existsSync(filePath)) {
+    console.log(chalk18.red(`  \u2717 File not found: ${filePath}`));
+    process.exit(1);
+  }
+  const content = await fs3.promises.readFile(filePath, "utf-8");
+  let importData;
+  try {
+    if (file.endsWith(".yaml") || file.endsWith(".yml")) {
+      console.log(chalk18.yellow("  YAML import not fully supported, treating as JSON"));
+    }
+    importData = JSON.parse(content);
+  } catch {
+    console.log(chalk18.red("  \u2717 Failed to parse import file"));
+    process.exit(1);
+  }
+  const solutions = importData.solutions || [];
+  if (solutions.length === 0) {
+    console.log(chalk18.yellow("  No solutions found in import file"));
+    return;
+  }
+  console.log(chalk18.dim(`  Found ${solutions.length} solutions
+`));
+  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})`));
+    }
+    return;
+  }
+  let imported = 0;
+  let skipped = 0;
+  for (const solution of solutions) {
+    const existing = await store.getSolution(solution.id);
+    if (existing.success && existing.data && !merge) {
+      console.log(chalk18.yellow(`    Skipped (exists): ${solution.name}`));
+      skipped++;
+      continue;
+    }
+    await store.saveSolution(solution);
+    console.log(chalk18.green(`    \u2713 Imported: ${solution.name}`));
+    imported++;
+  }
+  console.log(chalk18.green(`
+  \u2713 Import complete`));
+  console.log(chalk18.dim(`    Imported: ${imported}`));
+  console.log(chalk18.dim(`    Skipped: ${skipped}`));
+}
+async function solutionAnalyzeCommand() {
+  const cwd = getWorkspacePath();
+  const store = new PatternStore(cwd);
+  await store.initialize();
+  const fs3 = await import("fs");
+  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 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" }
+  ];
+  for (const pattern of patterns) {
+    const fullPath = pathModule.default.join(cwd, pattern.path);
+    if (fs3.existsSync(fullPath) && !existingNames.includes(pattern.name.toLowerCase())) {
+      opportunities.push({
+        name: pattern.name,
+        category: pattern.category,
+        description: pattern.desc,
+        path: pattern.path
+      });
+    }
+  }
+  if (opportunities.length === 0) {
+    console.log(chalk18.green("  \u2713 No new solution opportunities found"));
+    console.log(chalk18.dim("\n  Your solutions seem well-captured!"));
+    return;
+  }
+  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}`));
+    console.log(chalk18.dim(`    ${opp.description}`));
+    console.log(chalk18.dim(`    Path: ${opp.path}
+`));
+  }
+  console.log(chalk18.dim("  To capture a solution:"));
+  console.log(chalk18.cyan("    workflow solution capture --path <path> --name <name>"));
+}
 
 // src/cli/commands/solution/index.ts
 function createSolutionCommand() {
-  const solutionCmd = new Command3("solution").description("Manage solution patterns for code reuse").addHelpText(
+  const solutionCmd = new Command4("solution").description("Manage solution patterns for code reuse").addHelpText(
     "after",
     `
 ${chalk19.bold("Examples:")}
-  $ workflow solution capture                    ${chalk19.dim("# Interactive solution capture")}
-  $ workflow solution capture --path ./src/auth  ${chalk19.dim("# Capture from specific path")}
+  $ workflow solution capture --path ./src/auth  ${chalk19.dim("# Capture from path")}
+  $ workflow solution create --name "My Auth"    ${chalk19.dim("# Create manually")}
+  $ workflow solution show abc123                ${chalk19.dim("# Show solution details")}
   $ workflow solution search "jwt auth"          ${chalk19.dim("# Search solutions")}
   $ workflow solution list                       ${chalk19.dim("# List all solutions")}
   $ workflow solution list --category auth       ${chalk19.dim("# List by category")}
   $ workflow solution apply abc123               ${chalk19.dim("# Apply a solution")}
   $ workflow solution apply abc123 --dry-run     ${chalk19.dim("# Preview application")}
+  $ workflow solution export --format json       ${chalk19.dim("# Export solutions")}
+  $ workflow solution import solutions.json      ${chalk19.dim("# Import solutions")}
+  $ workflow solution analyze                    ${chalk19.dim("# Find opportunities")}
   $ workflow solution stats                      ${chalk19.dim("# Show statistics")}
 `
   ).action(() => {
@@ -5867,7 +5971,22 @@ ${chalk19.bold("Examples:")}
   $ workflow solution capture --anonymize               ${chalk19.dim("# Anonymize secrets")}
   $ workflow solution capture --private                 ${chalk19.dim("# Keep private")}
 `
-  ).action(solutionCaptureCommand);
+  ).action(solutionCaptureCommand);
+  solutionCmd.command("create").description("Create a new solution pattern manually").option("--name <name>", "Solution name").option("--description <desc>", "Solution description").option("--category <cat>", "Category").option("--keywords <kw>", "Comma-separated keywords").option("--framework <fw>", "Target framework").addHelpText(
+    "after",
+    `
+${chalk19.bold("Examples:")}
+  $ workflow solution create                            ${chalk19.dim("# Interactive mode")}
+  $ workflow solution create --name "Custom Auth"       ${chalk19.dim("# With name")}
+`
+  ).action(solutionCreateCommand);
+  solutionCmd.command("show <solutionId>").description("Display details of a specific solution pattern").addHelpText(
+    "after",
+    `
+${chalk19.bold("Examples:")}
+  $ workflow solution show abc123                       ${chalk19.dim("# Show by ID")}
+`
+  ).action(solutionShowCommand);
   solutionCmd.command("search <query>").description("Search for solution patterns").option("--category <cat>", "Filter by category").option("--framework <fw>", "Filter by framework").option("--limit <n>", "Maximum results", "10").addHelpText(
     "after",
     `
@@ -5898,6 +6017,36 @@ ${chalk19.bold("Examples:")}
   $ workflow solution apply abc123 --include-tests      ${chalk19.dim("# Include test files")}
 `
   ).action(solutionApplyCommand);
+  solutionCmd.command("export").description("Export solution patterns to a file").option("-o, --output <path>", "Output file path", "solutions-export.json").option("-f, --format <format>", "Output format (json, yaml)", "json").option("--category <cat>", "Filter by category").addHelpText(
+    "after",
+    `
+${chalk19.bold("Examples:")}
+  $ workflow solution export                            ${chalk19.dim("# Export all as JSON")}
+  $ workflow solution export --format yaml              ${chalk19.dim("# Export as YAML")}
+  $ workflow solution export --category auth            ${chalk19.dim("# Export auth only")}
+  $ workflow solution export -o backup.json             ${chalk19.dim("# Custom output path")}
+`
+  ).action(solutionExportCommand);
+  solutionCmd.command("import <file>").description("Import solution patterns from a file").option("-f, --format <format>", "Input format (json, yaml)", "json").option("--dry-run", "Preview import without making changes").option("--no-merge", "Skip existing solutions instead of merging").addHelpText(
+    "after",
+    `
+${chalk19.bold("Examples:")}
+  $ workflow solution import solutions.json             ${chalk19.dim("# Import from JSON")}
+  $ workflow solution import backup.json --dry-run      ${chalk19.dim("# Preview import")}
+`
+  ).action(solutionImportCommand);
+  solutionCmd.command("analyze").description("Analyze codebase for potential solution patterns").addHelpText(
+    "after",
+    `
+${chalk19.bold("Details:")}
+  Scans your codebase for common patterns that could be
+  captured as reusable solutions, such as:
+  - Authentication modules
+  - API layers
+  - Database utilities
+  - UI component libraries
+`
+  ).action(solutionAnalyzeCommand);
   solutionCmd.command("deprecate <solutionId> <reason>").description("Deprecate a solution pattern").addHelpText(
     "after",
     `
@@ -5917,7 +6066,7 @@ ${chalk19.bold("Examples:")}
 }
 
 // src/cli/commands/learn/index.ts
-import { Command as Command4 } from "commander";
+import { Command as Command5 } from "commander";
 import chalk21 from "chalk";
 
 // src/cli/commands/learn.ts
@@ -5926,10 +6075,10 @@ import * as p12 from "@clack/prompts";
 import * as fs2 from "fs";
 import * as path3 from "path";
 import {
-  PatternStore as PatternStore3,
-  ContributorManager as ContributorManager2,
+  PatternStore as PatternStore2,
+  ContributorManager,
   PatternAnonymizer,
-  TelemetryCollector as TelemetryCollector2,
+  TelemetryCollector,
   FixPatternSchema,
   BlueprintSchema,
   SolutionPatternSchema
@@ -5949,7 +6098,8 @@ function formatTags(tags) {
 }
 async function learnRecordCommand(options) {
   const cwd = getWorkspacePath2();
-  const store = new PatternStore3(cwd);
+  const store = new PatternStore2(cwd);
+  await store.initialize();
   console.log(chalk20.cyan("\n\u{1F4DA} Record a Learning Pattern\n"));
   let patternType = options.type;
   if (!patternType) {
@@ -6182,7 +6332,8 @@ async function learnRecordCommand(options) {
 }
 async function learnListCommand(options) {
   const cwd = getWorkspacePath2();
-  const store = new PatternStore3(cwd);
+  const store = new PatternStore2(cwd);
+  await store.initialize();
   const patternType = options.type ?? "all";
   const showDeprecated = options.deprecated ?? false;
   console.log(chalk20.cyan("\n\u{1F4DA} Recorded Learning Patterns\n"));
@@ -6314,8 +6465,9 @@ async function learnListCommand(options) {
 }
 async function learnApplyCommand(patternId, options) {
   const cwd = getWorkspacePath2();
-  const store = new PatternStore3(cwd);
-  const telemetry = new TelemetryCollector2(cwd);
+  const store = new PatternStore2(cwd);
+  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 patternType = "fix";
@@ -6402,7 +6554,7 @@ async function learnApplyCommand(patternId, options) {
 }
 async function learnConfigCommand(options) {
   const cwd = getWorkspacePath2();
-  const contributorManager = new ContributorManager2(cwd);
+  const contributorManager = new ContributorManager(cwd);
   console.log(chalk20.cyan("\n\u2699\uFE0F Learning Configuration\n"));
   if (options.enableSync) {
     const result = await contributorManager.enableSync();
@@ -6496,7 +6648,8 @@ async function learnConfigCommand(options) {
 }
 async function learnPublishCommand(patternId, options) {
   const cwd = getWorkspacePath2();
-  const store = new PatternStore3(cwd);
+  const store = new PatternStore2(cwd);
+  await store.initialize();
   const makePrivate = options.private ?? false;
   const actionWord = makePrivate ? "private" : "public";
   const emoji = makePrivate ? "\u{1F512}" : "\u{1F310}";
@@ -6645,7 +6798,8 @@ ${emoji} Mark Pattern(s) ${actionWord}
 }
 async function learnDeprecateCommand(patternId, reason) {
   const cwd = getWorkspacePath2();
-  const store = new PatternStore3(cwd);
+  const store = new PatternStore2(cwd);
+  await store.initialize();
   console.log(chalk20.cyan("\n\u26A0\uFE0F Deprecate Pattern\n"));
   let patternType = "fix";
   let pattern = await store.getFixPattern(patternId);
@@ -6681,8 +6835,9 @@ async function learnDeprecateCommand(patternId, reason) {
 }
 async function learnStatsCommand() {
   const cwd = getWorkspacePath2();
-  const store = new PatternStore3(cwd);
-  const telemetry = new TelemetryCollector2(cwd);
+  const store = new PatternStore2(cwd);
+  await store.initialize();
+  const telemetry = new TelemetryCollector(cwd);
   console.log(chalk20.cyan("\n\u{1F4CA} Learning Statistics\n"));
   const storeStats = await store.getStats();
   const totalPatterns = storeStats.totalFixes + storeStats.totalBlueprints;
@@ -7195,7 +7350,8 @@ function inferTagsFromContent(filePaths) {
 }
 async function learnCaptureCommand(paths, options) {
   const cwd = getWorkspacePath2();
-  const store = new PatternStore3(cwd);
+  const store = new PatternStore2(cwd);
+  await store.initialize();
   console.log(chalk20.cyan("\n\u{1F4F8} Capture Files as Blueprint\n"));
   const resolvedPaths = [];
   const relativePaths = [];
@@ -7345,7 +7501,7 @@ async function learnCaptureCommand(paths, options) {
   }
   const primaryLanguage = Object.entries(languageCounts).sort((a, b) => b[1] - a[1])[0]?.[0] || "typescript";
   const now = (/* @__PURE__ */ new Date()).toISOString();
-  const contributorManager = new ContributorManager2(cwd);
+  const contributorManager = new ContributorManager(cwd);
   const contributorResult = await contributorManager.getOrCreateId();
   const contributorId = contributorResult.success && contributorResult.data ? contributorResult.data : void 0;
   const keyFiles = files.map((f) => ({
@@ -7439,10 +7595,340 @@ function getAllFilesInDir(dirPath) {
   }
   return files;
 }
+async function learnAnalyzeCommand(options) {
+  const cwd = getWorkspacePath2();
+  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"));
+  const fixResult = await store.listFixPatterns({});
+  const bpResult = await store.listBlueprints({});
+  const existingPatterns = [
+    ...(fixResult.data || []).map((p13) => p13.name.toLowerCase()),
+    ...(bpResult.data || []).map((p13) => p13.name.toLowerCase())
+  ];
+  const opportunities = [];
+  const authPaths = ["src/auth", "src/lib/auth", "lib/auth", "app/api/auth"];
+  for (const authPath of authPaths) {
+    if (fs2.existsSync(path3.join(cwd, authPath))) {
+      if (!existingPatterns.some((p13) => p13.includes("auth"))) {
+        opportunities.push({
+          type: "blueprint",
+          name: "Authentication Module",
+          description: "Capture your authentication implementation as a reusable pattern",
+          path: authPath
+        });
+      }
+    }
+  }
+  const apiPaths = ["src/api", "app/api", "pages/api", "src/routes"];
+  for (const apiPath of apiPaths) {
+    if (fs2.existsSync(path3.join(cwd, apiPath))) {
+      if (!existingPatterns.some((p13) => p13.includes("api"))) {
+        opportunities.push({
+          type: "blueprint",
+          name: "API Structure",
+          description: "Capture your API routing structure as a blueprint",
+          path: apiPath
+        });
+      }
+    }
+  }
+  const componentPaths = ["src/components", "components", "src/ui"];
+  for (const compPath of componentPaths) {
+    if (fs2.existsSync(path3.join(cwd, compPath))) {
+      if (!existingPatterns.some((p13) => p13.includes("component"))) {
+        opportunities.push({
+          type: "blueprint",
+          name: "Component Library",
+          description: "Capture your component structure as a reusable pattern",
+          path: compPath
+        });
+      }
+    }
+  }
+  const testPaths = ["__tests__", "test", "tests", "src/__tests__"];
+  for (const testPath of testPaths) {
+    if (fs2.existsSync(path3.join(cwd, testPath))) {
+      if (!existingPatterns.some((p13) => p13.includes("test"))) {
+        opportunities.push({
+          type: "blueprint",
+          name: "Testing Structure",
+          description: "Capture your testing setup as a blueprint",
+          path: testPath
+        });
+      }
+    }
+  }
+  if (opportunities.length === 0) {
+    console.log(chalk20.green("  \u2713 No new learning opportunities identified"));
+    console.log(chalk20.dim("\n  Your patterns seem well-captured!"));
+    return;
+  }
+  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)}`);
+    console.log(chalk20.dim(`     ${opp.description}`));
+    if (opp.path && verbose) {
+      console.log(chalk20.dim(`     Path: ${opp.path}`));
+    }
+    console.log("");
+  }
+  console.log(chalk20.dim("  To capture a pattern:"));
+  console.log(chalk20.cyan("    workflow learn capture <path> --name <name>"));
+}
+async function learnExportCommand(options) {
+  const cwd = getWorkspacePath2();
+  const store = new PatternStore2(cwd);
+  await store.initialize();
+  const format = options.format ?? "json";
+  const patternType = options.type ?? "all";
+  const outputPath = options.output ?? `patterns-export.${format}`;
+  console.log(chalk20.cyan("\n\u{1F4E4} Exporting Learning Patterns\n"));
+  const exportData = {
+    fixes: [],
+    blueprints: []
+  };
+  if (patternType === "all" || patternType === "fix") {
+    const fixResult = await store.listFixPatterns({});
+    if (fixResult.success && fixResult.data) {
+      exportData.fixes = fixResult.data;
+    }
+  }
+  if (patternType === "all" || patternType === "blueprint") {
+    const bpResult = await store.listBlueprints({});
+    if (bpResult.success && bpResult.data) {
+      exportData.blueprints = bpResult.data;
+    }
+  }
+  const totalCount = exportData.fixes.length + exportData.blueprints.length;
+  if (totalCount === 0) {
+    console.log(chalk20.yellow("  No patterns to export"));
+    return;
+  }
+  let output;
+  if (format === "yaml") {
+    output = `# Workflow Agent Patterns Export
+# Exported: ${(/* @__PURE__ */ new Date()).toISOString()}
+
+`;
+    output += `fixes:
+`;
+    for (const fix of exportData.fixes) {
+      output += `  - id: ${fix.id}
+`;
+      output += `    name: "${fix.name}"
+`;
+      output += `    category: ${fix.category}
+`;
+      output += `    description: "${fix.description}"
+
+`;
+    }
+    output += `blueprints:
+`;
+    for (const bp of exportData.blueprints) {
+      output += `  - id: ${bp.id}
+`;
+      output += `    name: "${bp.name}"
+`;
+      output += `    description: "${bp.description}"
+
+`;
+    }
+  } else {
+    output = JSON.stringify(
+      {
+        version: "1.0",
+        exportedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        ...exportData
+      },
+      null,
+      2
+    );
+  }
+  const fullOutputPath = path3.isAbsolute(outputPath) ? outputPath : path3.join(cwd, outputPath);
+  await fs2.promises.writeFile(fullOutputPath, output, "utf-8");
+  console.log(chalk20.green(`  \u2713 Exported ${totalCount} patterns
+`));
+  console.log(chalk20.dim(`    Fix patterns: ${exportData.fixes.length}`));
+  console.log(chalk20.dim(`    Blueprints: ${exportData.blueprints.length}`));
+  console.log(chalk20.dim(`    Output: ${fullOutputPath}`));
+  console.log(chalk20.dim(`    Format: ${format.toUpperCase()}`));
+}
+async function learnImportCommand(file, options) {
+  const cwd = getWorkspacePath2();
+  const store = new PatternStore2(cwd);
+  await store.initialize();
+  const dryRun = options.dryRun ?? false;
+  const merge = options.merge ?? true;
+  console.log(chalk20.cyan("\n\u{1F4E5} Importing Learning Patterns\n"));
+  const filePath = path3.isAbsolute(file) ? file : path3.join(cwd, file);
+  if (!fs2.existsSync(filePath)) {
+    console.log(chalk20.red(`  \u2717 File not found: ${filePath}`));
+    process.exit(1);
+  }
+  const content = await fs2.promises.readFile(filePath, "utf-8");
+  let importData;
+  try {
+    if (file.endsWith(".yaml") || file.endsWith(".yml")) {
+      console.log(chalk20.yellow("  YAML import not fully supported, treating as JSON"));
+    }
+    importData = JSON.parse(content);
+  } catch {
+    console.log(chalk20.red("  \u2717 Failed to parse import file"));
+    process.exit(1);
+  }
+  const fixes = importData.fixes || [];
+  const blueprints = importData.blueprints || [];
+  const totalCount = fixes.length + blueprints.length;
+  if (totalCount === 0) {
+    console.log(chalk20.yellow("  No patterns found in import file"));
+    return;
+  }
+  console.log(chalk20.dim(`  Found ${fixes.length} fix patterns`));
+  console.log(chalk20.dim(`  Found ${blueprints.length} blueprints
+`));
+  if (dryRun) {
+    console.log(chalk20.yellow("  \u{1F50D} Dry run - no changes will be made\n"));
+    for (const fix of fixes) {
+      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})`));
+    }
+    return;
+  }
+  let imported = 0;
+  let skipped = 0;
+  for (const fix of fixes) {
+    const existing = await store.getFixPattern(fix.id);
+    if (existing.success && existing.data && !merge) {
+      console.log(chalk20.yellow(`    Skipped (exists): ${fix.name}`));
+      skipped++;
+      continue;
+    }
+    const result = await store.saveFixPattern(fix);
+    if (result.success) {
+      console.log(chalk20.green(`    \u2713 Imported: ${fix.name}`));
+      imported++;
+    } else {
+      console.log(chalk20.red(`    \u2717 Failed: ${fix.name}`));
+    }
+  }
+  for (const bp of blueprints) {
+    const existing = await store.getBlueprint(bp.id);
+    if (existing.success && existing.data && !merge) {
+      console.log(chalk20.yellow(`    Skipped (exists): ${bp.name}`));
+      skipped++;
+      continue;
+    }
+    const result = await store.saveBlueprint(bp);
+    if (result.success) {
+      console.log(chalk20.green(`    \u2713 Imported: ${bp.name}`));
+      imported++;
+    } else {
+      console.log(chalk20.red(`    \u2717 Failed: ${bp.name}`));
+    }
+  }
+  console.log(chalk20.green(`
+  \u2713 Import complete`));
+  console.log(chalk20.dim(`    Imported: ${imported}`));
+  console.log(chalk20.dim(`    Skipped: ${skipped}`));
+}
+async function learnCleanCommand(options) {
+  const cwd = getWorkspacePath2();
+  const store = new PatternStore2(cwd);
+  await store.initialize();
+  const dryRun = options.dryRun ?? false;
+  const cleanDeprecated = options.deprecated ?? false;
+  const cleanStale = options.stale ?? false;
+  const cleanAll = options.all ?? false;
+  console.log(chalk20.cyan("\n\u{1F9F9} Cleaning Learning Patterns\n"));
+  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!)"));
+    return;
+  }
+  const toRemove = [];
+  const fixResult = await store.listFixPatterns({ includeDeprecated: true });
+  const bpResult = await store.listBlueprints({ includeDeprecated: true });
+  const fixes = fixResult.data || [];
+  const blueprints = bpResult.data || [];
+  const now = Date.now();
+  const staleDays = 90;
+  const staleThreshold = now - staleDays * 24 * 60 * 60 * 1e3;
+  for (const fix of fixes) {
+    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" });
+    } 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" });
+      }
+    }
+  }
+  for (const bp of blueprints) {
+    if (cleanAll) {
+      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" });
+    } 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" });
+      }
+    }
+  }
+  if (toRemove.length === 0) {
+    console.log(chalk20.green("  \u2713 Nothing to clean"));
+    return;
+  }
+  console.log(chalk20.bold(`  Found ${toRemove.length} patterns to remove:
+`));
+  for (const item of toRemove) {
+    const icon = item.type === "fix" ? "\u{1F527}" : "\u{1F4D0}";
+    console.log(`    ${icon} ${item.name} (${item.reason})`);
+  }
+  if (dryRun) {
+    console.log(chalk20.yellow("\n  \u{1F50D} Dry run - no changes made"));
+    return;
+  }
+  const confirmed = await p12.confirm({
+    message: `Remove ${toRemove.length} patterns? This cannot be undone.`,
+    initialValue: false
+  });
+  if (p12.isCancel(confirmed) || !confirmed) {
+    p12.cancel("Clean cancelled");
+    return;
+  }
+  let removed = 0;
+  const patternsPath = path3.join(cwd, ".workflow", "patterns");
+  for (const item of toRemove) {
+    const dir = item.type === "fix" ? "fixes" : "blueprints";
+    const filePath = path3.join(patternsPath, dir, `${item.id}.json`);
+    try {
+      if (fs2.existsSync(filePath)) {
+        await fs2.promises.unlink(filePath);
+        removed++;
+      }
+    } catch {
+      console.log(chalk20.red(`    \u2717 Failed to remove: ${item.name}`));
+    }
+  }
+  console.log(chalk20.green(`
+  \u2713 Removed ${removed} patterns`));
+}
 
 // src/cli/commands/learn/index.ts
 function createLearnCommand() {
-  const learnCmd = new Command4("learn").description("Manage learning patterns for AI-assisted development").addHelpText(
+  const learnCmd = new Command5("learn").description("Manage learning patterns for AI-assisted development").addHelpText(
     "after",
     `
 ${chalk21.bold("Examples:")}
@@ -7450,9 +7936,13 @@ ${chalk21.bold("Examples:")}
   $ workflow learn list --type blueprint            ${chalk21.dim("# List blueprints only")}
   $ workflow learn apply abc123 --dry-run           ${chalk21.dim("# Preview pattern application")}
   $ workflow learn capture ./src/auth --name auth   ${chalk21.dim("# Capture as blueprint")}
+  $ workflow learn analyze                          ${chalk21.dim("# Find learning opportunities")}
+  $ workflow learn export --format json             ${chalk21.dim("# Export patterns")}
+  $ workflow learn import patterns.json             ${chalk21.dim("# Import patterns")}
   $ workflow learn sync --push                      ${chalk21.dim("# Push patterns to registry")}
   $ workflow learn config --show                    ${chalk21.dim("# Show current configuration")}
   $ workflow learn stats                            ${chalk21.dim("# Show learning statistics")}
+  $ workflow learn clean --deprecated               ${chalk21.dim("# Clean deprecated patterns")}
   $ workflow learn validate --fix                   ${chalk21.dim("# Auto-fix pattern issues")}
 `
   ).action(() => {
@@ -7550,6 +8040,42 @@ ${chalk21.bold("Examples:")}
   $ workflow learn stats                               ${chalk21.dim("# Show all statistics")}
 `
   ).action(learnStatsCommand);
+  learnCmd.command("analyze").description("Analyze codebase for learning opportunities").option("-v, --verbose", "Show detailed output including paths").addHelpText(
+    "after",
+    `
+${chalk21.bold("Examples:")}
+  $ workflow learn analyze                             ${chalk21.dim("# Find learning opportunities")}
+  $ 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(
+    "after",
+    `
+${chalk21.bold("Examples:")}
+  $ workflow learn export                              ${chalk21.dim("# Export all as JSON")}
+  $ workflow learn export --format yaml                ${chalk21.dim("# Export as YAML")}
+  $ workflow learn export --type fix                   ${chalk21.dim("# Export only fixes")}
+  $ workflow learn export -o backup.json               ${chalk21.dim("# Custom output path")}
+`
+  ).action(learnExportCommand);
+  learnCmd.command("import <file>").description("Import learning patterns from a file").option("-f, --format <format>", "Input format (json, yaml)", "json").option("--dry-run", "Preview import without making changes").option("--no-merge", "Skip existing patterns instead of merging").addHelpText(
+    "after",
+    `
+${chalk21.bold("Examples:")}
+  $ workflow learn import patterns.json                ${chalk21.dim("# Import from JSON")}
+  $ workflow learn import backup.json --dry-run        ${chalk21.dim("# Preview import")}
+  $ workflow learn import patterns.yaml --format yaml  ${chalk21.dim("# Import from YAML")}
+`
+  ).action(learnImportCommand);
+  learnCmd.command("clean").description("Clean old or stale learning patterns").option("--deprecated", "Remove deprecated patterns").option("--stale", "Remove patterns not used in 90+ days").option("--all", "Remove all patterns (use with caution!)").option("--dry-run", "Preview what would be removed").addHelpText(
+    "after",
+    `
+${chalk21.bold("Examples:")}
+  $ workflow learn clean --deprecated                  ${chalk21.dim("# Remove deprecated")}
+  $ workflow learn clean --stale                       ${chalk21.dim("# Remove stale patterns")}
+  $ 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(
     "after",
     `
@@ -7565,19 +8091,250 @@ ${chalk21.bold("Examples:")}
 }
 
 // src/cli/commands/scope/index.ts
-import { Command as Command5 } from "commander";
+import { Command as Command6 } from "commander";
 import chalk22 from "chalk";
+async function scopeListCommand() {
+  console.log(chalk22.bold.cyan("\n\u{1F4CB} Available Scopes\n"));
+  const config = await loadConfig();
+  const scopes = config?.scopes || [];
+  if (scopes.length === 0) {
+    console.log(chalk22.yellow("  No scopes configured."));
+    console.log(chalk22.dim("\n  Add scopes with: workflow scope add <name>"));
+    console.log(chalk22.dim("  Or create a custom scope: workflow scope create"));
+    return;
+  }
+  const byCategory = {};
+  for (const scope of scopes) {
+    const cat = scope.category || "other";
+    if (!byCategory[cat]) byCategory[cat] = [];
+    byCategory[cat].push(scope);
+  }
+  for (const [category, categoryScopes] of Object.entries(byCategory)) {
+    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("");
+  }
+  console.log(chalk22.dim(`  Total: ${scopes.length} scopes`));
+}
+async function scopeAddCommand(name, options) {
+  console.log(chalk22.bold.cyan(`
+\u2795 Adding Scope: ${name}
+`));
+  const fs3 = await import("fs");
+  const path4 = await import("path");
+  const cwd = process.cwd();
+  const configFiles = ["workflow.config.json", "workflow.config.js", ".workflowrc.json"];
+  let configPath = null;
+  for (const file of configFiles) {
+    const fullPath = path4.join(cwd, file);
+    if (fs3.existsSync(fullPath)) {
+      configPath = fullPath;
+      break;
+    }
+  }
+  if (!configPath) {
+    console.log(chalk22.red("\u2717 No workflow configuration file found"));
+    console.log(chalk22.yellow("  Run: workflow init"));
+    process.exit(1);
+  }
+  const configContent = fs3.readFileSync(configPath, "utf-8");
+  const config = JSON.parse(configContent);
+  if (!config.scopes) {
+    config.scopes = [];
+  }
+  const existing = config.scopes.find((s) => s.name === name);
+  if (existing) {
+    console.log(chalk22.yellow(`  Scope "${name}" already exists`));
+    process.exit(1);
+  }
+  const newScope = {
+    name,
+    description: options.description || `${name} related changes`,
+    emoji: options.emoji || "\u{1F4E6}",
+    category: options.category || "feature"
+  };
+  config.scopes.push(newScope);
+  fs3.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+  console.log(chalk22.green(`\u2713 Added scope: ${newScope.emoji} ${name}`));
+  console.log(chalk22.dim(`  Description: ${newScope.description}`));
+  console.log(chalk22.dim(`  Category: ${newScope.category}`));
+}
+async function scopeRemoveCommand(name) {
+  console.log(chalk22.bold.cyan(`
+\u2796 Removing Scope: ${name}
+`));
+  const fs3 = await import("fs");
+  const path4 = await import("path");
+  const cwd = process.cwd();
+  const configFiles = ["workflow.config.json", "workflow.config.js", ".workflowrc.json"];
+  let configPath = null;
+  for (const file of configFiles) {
+    const fullPath = path4.join(cwd, file);
+    if (fs3.existsSync(fullPath)) {
+      configPath = fullPath;
+      break;
+    }
+  }
+  if (!configPath) {
+    console.log(chalk22.red("\u2717 No workflow configuration file found"));
+    process.exit(1);
+  }
+  const configContent = fs3.readFileSync(configPath, "utf-8");
+  const config = JSON.parse(configContent);
+  if (!config.scopes || config.scopes.length === 0) {
+    console.log(chalk22.yellow("  No scopes configured"));
+    process.exit(1);
+  }
+  const index = config.scopes.findIndex((s) => s.name === name);
+  if (index === -1) {
+    console.log(chalk22.yellow(`  Scope "${name}" not found`));
+    process.exit(1);
+  }
+  const removed = config.scopes.splice(index, 1)[0];
+  fs3.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+  console.log(chalk22.green(`\u2713 Removed scope: ${removed.emoji || "\u{1F4E6}"} ${name}`));
+}
+async function scopeSyncCommand(options) {
+  console.log(chalk22.bold.cyan("\n\u{1F504} Syncing Scopes\n"));
+  const { syncCommand: syncCommand2 } = await import("../sync-MNHQ6AIQ.js");
+  await syncCommand2({
+    ...options,
+    scopes: true,
+    learn: false,
+    solutions: false
+  });
+}
+async function scopeAnalyzeCommand() {
+  console.log(chalk22.bold.cyan("\n\u{1F50D} Analyzing Scope Usage\n"));
+  const { execa: execa2 } = await import("execa");
+  const cwd = process.cwd();
+  try {
+    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 || [];
+    const scopeNames = scopes.map((s) => s.name);
+    const usage = {};
+    let unscoped = 0;
+    let invalidScopes = [];
+    for (const commit of commits) {
+      const match = commit.match(/^\w+\(([^)]+)\):/);
+      if (match) {
+        const scope = match[1];
+        if (scopeNames.includes(scope)) {
+          usage[scope] = (usage[scope] || 0) + 1;
+        } else {
+          if (!invalidScopes.includes(scope)) {
+            invalidScopes.push(scope);
+          }
+        }
+      } else if (commit.match(/^\w+:/)) {
+        unscoped++;
+      }
+    }
+    console.log(chalk22.bold("  Scope Usage (last 50 commits):"));
+    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 emoji = scopeConfig?.emoji || "\u{1F4E6}";
+      const bar = "\u2588".repeat(Math.min(count, 20));
+      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}`);
+    }
+    const unusedScopes = scopeNames.filter((name) => !usage[name]);
+    if (unusedScopes.length > 0) {
+      console.log(chalk22.yellow("\n  Unused scopes (consider removing):"));
+      for (const name of unusedScopes) {
+        console.log(chalk22.dim(`    \u2022 ${name}`));
+      }
+    }
+    if (invalidScopes.length > 0) {
+      console.log(chalk22.yellow("\n  Unknown scopes (consider adding):"));
+      for (const name of invalidScopes) {
+        console.log(chalk22.dim(`    \u2022 ${name}`));
+      }
+    }
+    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"));
+  }
+}
+async function hooksTestCommand(options) {
+  console.log(chalk22.bold.cyan("\n\u{1F9EA} Testing Git Hooks\n"));
+  const fs3 = await import("fs");
+  const path4 = await import("path");
+  const cwd = process.cwd();
+  const gitDir = path4.join(cwd, ".git");
+  const hooksDir = path4.join(gitDir, "hooks");
+  if (!fs3.existsSync(gitDir)) {
+    console.log(chalk22.red("\u2717 Not a git repository"));
+    process.exit(1);
+  }
+  if (!fs3.existsSync(hooksDir)) {
+    console.log(chalk22.yellow("  No hooks directory found"));
+    console.log(chalk22.dim("  Run: workflow scope hooks install"));
+    process.exit(1);
+  }
+  const hookTypes = ["pre-commit", "commit-msg"];
+  let allInstalled = true;
+  for (const hookType of hookTypes) {
+    const hookPath = path4.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").includes("workflow-agent");
+    if (exists && isExecutable && isWorkflowHook2) {
+      console.log(chalk22.green(`  \u2713 ${hookType} - installed and executable`));
+    } else if (exists && !isWorkflowHook2) {
+      console.log(chalk22.yellow(`  \u26A0 ${hookType} - exists but not managed by workflow-agent`));
+      allInstalled = false;
+    } else if (exists && !isExecutable) {
+      console.log(chalk22.red(`  \u2717 ${hookType} - exists but not executable`));
+      allInstalled = false;
+    } else {
+      console.log(chalk22.red(`  \u2717 ${hookType} - not installed`));
+      allInstalled = false;
+    }
+  }
+  if (options.dryRun) {
+    console.log(chalk22.bold.cyan("\n  Dry-run hook simulation:\n"));
+    console.log(chalk22.dim("  Simulating pre-commit hook..."));
+    const { verifyCommand: verifyCommand2 } = await import("../verify-2PDVNYWV.js");
+    try {
+      await verifyCommand2({ fix: false, dryRun: true, maxRetries: "1" });
+    } catch {
+    }
+  }
+  if (!allInstalled) {
+    console.log(chalk22.yellow("\n  Some hooks are not properly installed"));
+    console.log(chalk22.dim("  Run: workflow scope hooks install"));
+    process.exit(1);
+  }
+  console.log(chalk22.green("\n\u2713 All hooks are properly installed"));
+}
 function createScopeCommand() {
-  const scopeCmd = new Command5("scope").description("Manage custom scope packages").addHelpText(
+  const scopeCmd = new Command6("scope").description("Manage custom scope packages and git hooks").addHelpText(
     "after",
     `
 ${chalk22.bold("Examples:")}
-  $ workflow scope create --name fintech                ${chalk22.dim("# Create fintech scope package")}
-  $ workflow scope migrate --name my-scopes             ${chalk22.dim("# Migrate inline to package")}
+  $ workflow scope list                           ${chalk22.dim("# List available scopes")}
+  $ workflow scope create --name fintech          ${chalk22.dim("# Create fintech scope package")}
+  $ workflow scope migrate --name my-scopes       ${chalk22.dim("# Migrate inline to package")}
+  $ workflow scope add auth                       ${chalk22.dim("# Add auth scope")}
+  $ workflow scope remove legacy                  ${chalk22.dim("# Remove legacy scope")}
+  $ workflow scope analyze                        ${chalk22.dim("# Analyze scope usage")}
+  $ workflow scope hooks install                  ${chalk22.dim("# Install git hooks")}
 `
   ).action(() => {
-    scopeCmd.help();
+    scopeListCommand();
   });
+  scopeCmd.command("list").description("List available scopes").action(scopeListCommand);
   scopeCmd.command("create").description("Create a custom scope package").option("--name <name>", 'Package name (e.g., "fintech", "gaming")').option(
     "--scopes <scopes>",
     "Comma-separated scopes (format: name:description:emoji:category)"
@@ -7601,6 +8358,57 @@ ${chalk22.bold("Examples:")}
   $ workflow scope migrate --keep-config              ${chalk22.dim("# Keep inline copy")}
 `
   ).action(scopeMigrateCommand);
+  scopeCmd.command("add <name>").description("Add a scope to the project configuration").option("--description <desc>", "Scope description").option("--emoji <emoji>", "Scope emoji").option("--category <cat>", "Scope category (feature, fix, core, etc.)").addHelpText(
+    "after",
+    `
+${chalk22.bold("Examples:")}
+  $ workflow scope add auth                           ${chalk22.dim("# Add auth scope")}
+  $ workflow scope add payments --emoji \u{1F4B3}            ${chalk22.dim("# With emoji")}
+  $ workflow scope add api --category core            ${chalk22.dim("# With category")}
+`
+  ).action(scopeAddCommand);
+  scopeCmd.command("remove <name>").description("Remove a scope from the project configuration").addHelpText(
+    "after",
+    `
+${chalk22.bold("Examples:")}
+  $ workflow scope remove legacy                      ${chalk22.dim("# Remove scope")}
+`
+  ).action(scopeRemoveCommand);
+  scopeCmd.command("sync").description("Sync scopes with the community registry").option("--push", "Push local scopes to registry").option("--pull", "Pull scopes from registry").option("--dry-run", "Preview without syncing").addHelpText(
+    "after",
+    `
+${chalk22.bold("Examples:")}
+  $ workflow scope sync --push                        ${chalk22.dim("# Push to registry")}
+  $ workflow scope sync --pull                        ${chalk22.dim("# Pull from registry")}
+  $ workflow scope sync --dry-run                     ${chalk22.dim("# Preview changes")}
+`
+  ).action(scopeSyncCommand);
+  scopeCmd.command("analyze").description("Analyze scope usage in the project").addHelpText(
+    "after",
+    `
+${chalk22.bold("Details:")}
+  Analyzes recent git commits to show:
+  - Which scopes are used most frequently
+  - Unused scopes that could be removed
+  - Unknown scopes that could be added
+`
+  ).action(scopeAnalyzeCommand);
+  const hooksCmd = scopeCmd.command("hooks").description("Manage git hooks for the project").addHelpText(
+    "after",
+    `
+${chalk22.bold("Examples:")}
+  $ workflow scope hooks install                      ${chalk22.dim("# Install git hooks")}
+  $ workflow scope hooks uninstall                    ${chalk22.dim("# Remove git hooks")}
+  $ workflow scope hooks test                         ${chalk22.dim("# Verify installation")}
+  $ workflow scope hooks test --dry-run               ${chalk22.dim("# Test with simulation")}
+`
+  ).action(() => {
+    hooksCommand("status");
+  });
+  hooksCmd.command("install").description("Install git hooks for the project").action(() => hooksCommand("install"));
+  hooksCmd.command("uninstall").description("Remove installed git hooks").action(() => hooksCommand("uninstall"));
+  hooksCmd.command("status").description("Show current hooks installation status").action(() => hooksCommand("status"));
+  hooksCmd.command("test").description("Test that hooks are properly installed").option("--dry-run", "Simulate hook execution without making changes").action(hooksTestCommand);
   return scopeCmd;
 }
 
@@ -7610,7 +8418,7 @@ function deprecationWarning(oldCmd, newCmd) {
   console.warn(chalk23.yellow(`   Use: ${newCmd}
 `));
 }
-var program = new Command6();
+var program = new Command7();
 program.name("workflow").description(
   "A self-evolving workflow management system for AI agent development"
 ).version("1.0.0");
@@ -7618,7 +8426,6 @@ program.addCommand(createDocsCommand());
 program.addCommand(createSolutionCommand());
 program.addCommand(createLearnCommand());
 program.addCommand(createScopeCommand());
-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").addHelpText(
   "after",
   `
@@ -7679,18 +8486,18 @@ program.command("suggest").description("Submit an improvement suggestion").argum
   "--category <category>",
   "Category: feature, bug, documentation, performance, other"
 ).action(suggestCommand);
-program.command("setup").description("Add workflow scripts to package.json").action(setupCommand);
+program.addCommand(createSetupCommand());
 program.command("doctor").description("Run health check and get optimization suggestions").option("--check-guidelines-only", "Only check guidelines presence").option("--fix", "Automatically fix validation issues in configuration").action(doctorCommand);
-program.command("hooks:install", { hidden: true }).description("[DEPRECATED] Use: workflow hooks install").action(async () => {
-  deprecationWarning("workflow hooks:install", "workflow hooks install");
+program.command("hooks:install", { hidden: true }).description("[DEPRECATED] Use: workflow scope hooks install").action(async () => {
+  deprecationWarning("workflow hooks:install", "workflow scope hooks install");
   return hooksCommand("install");
 });
-program.command("hooks:uninstall", { hidden: true }).description("[DEPRECATED] Use: workflow hooks uninstall").action(async () => {
-  deprecationWarning("workflow hooks:uninstall", "workflow hooks uninstall");
+program.command("hooks:uninstall", { hidden: true }).description("[DEPRECATED] Use: workflow scope hooks uninstall").action(async () => {
+  deprecationWarning("workflow hooks:uninstall", "workflow scope hooks uninstall");
   return hooksCommand("uninstall");
 });
-program.command("hooks:status", { hidden: true }).description("[DEPRECATED] Use: workflow hooks status").action(async () => {
-  deprecationWarning("workflow hooks:status", "workflow hooks status");
+program.command("hooks:status", { hidden: true }).description("[DEPRECATED] Use: workflow scope hooks status").action(async () => {
+  deprecationWarning("workflow hooks:status", "workflow scope hooks status");
   return hooksCommand("status");
 });
 program.command("scope:create", { hidden: true }).description("[DEPRECATED] Use: workflow scope create").option("--name <name>", 'Package name (e.g., "fintech", "gaming")').option(
@@ -7705,7 +8512,11 @@ program.command("scope:migrate", { hidden: true }).description("[DEPRECATED] Use
   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("auto-setup").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);
+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");
+  return autoSetupCommand(options);
+});
 program.command("advisory", { hidden: true }).description("[DEPRECATED] Use: workflow docs advisory").option("--depth <level>", "Analysis depth").option("--output <path>", "Output directory").option("--interactive", "Enable interactive mode").option("--dry-run", "Preview analysis without writing files").option("--format <type>", "Output format").option("--timestamp", "Append timestamp to filenames").option("--include-health", "Include code health metrics").option("--ci", "CI mode with exit codes").option("--compare <path>", "Compare with previous report").action(async (options) => {
   deprecationWarning("workflow advisory", "workflow docs advisory");
   return advisoryCommand(options);