workflow-agent-cli 2.1.0 → 2.2.1

package/dist/cli/index.js

@@ -3,7 +3,7 @@ import {
   validateBranchName,
   validateCommitMessage,
   validatePRTitle
-} from "../chunk-X2NQJ2ZY.js";
+} from "../chunk-NMHWD2GA.js";
 import {
   DEFAULT_RESERVED_SCOPE_NAMES,
   hasConfig,
@@ -11,7 +11,7 @@ import {
   validateConfig,
   validateScopeDefinitions,
   validateScopeName
-} from "../chunk-B27W7GWP.js";
+} from "../chunk-JCDT4363.js";
 
 // src/cli/index.ts
 import { Command as Command2 } from "commander";
@@ -79,7 +79,7 @@ var adapters = {
       config: "src"
     }
   },
-  "remix": {
+  remix: {
     name: "Remix",
     description: "Remix full-stack framework",
     detect: async () => {
@@ -94,7 +94,7 @@ var adapters = {
       config: "app/root.tsx"
     }
   },
-  "astro": {
+  astro: {
     name: "Astro",
     description: "Astro static site framework",
     detect: async () => {
@@ -109,7 +109,7 @@ var adapters = {
       config: "src/pages"
     }
   },
-  "sveltekit": {
+  sveltekit: {
     name: "SvelteKit",
     description: "SvelteKit full-stack framework",
     detect: async () => {
@@ -124,7 +124,7 @@ var adapters = {
       config: "src/routes"
     }
   },
-  "generic": {
+  generic: {
     name: "Generic Project",
     description: "Standard project structure",
     detect: async () => true,
@@ -210,7 +210,9 @@ async function validateTemplateDirectory(templateDir) {
     const files = await fs.readdir(templateDir);
     const templateFiles = files.filter((f) => f.match(/\.(md|ts|json)$/));
     if (templateFiles.length === 0) {
-      throw new Error(`No template files found in template directory: ${templateDir}`);
+      throw new Error(
+        `No template files found in template directory: ${templateDir}`
+      );
     }
   } catch (error) {
     if (error.code === "ENOENT") {
@@ -470,12 +472,14 @@ async function installSingleHook(hookType, config, projectPath = process.cwd())
 }
 async function installHooks(config, projectPath = process.cwd()) {
   if (!hasGitRepo(projectPath)) {
-    return [{
-      success: false,
-      hookType: "pre-commit",
-      wrappedExisting: false,
-      error: "No git repository found. Run git init first."
-    }];
+    return [
+      {
+        success: false,
+        hookType: "pre-commit",
+        wrappedExisting: false,
+        error: "No git repository found. Run git init first."
+      }
+    ];
   }
   const results = await Promise.all([
     installSingleHook("pre-commit", config, projectPath),
@@ -535,7 +539,9 @@ async function isGitRepo(projectPath = process.cwd()) {
 }
 async function getGitRemoteUrl(projectPath = process.cwd()) {
   try {
-    const { stdout } = await execa("git", ["remote", "get-url", "origin"], { cwd: projectPath });
+    const { stdout } = await execa("git", ["remote", "get-url", "origin"], {
+      cwd: projectPath
+    });
     return stdout.trim() || null;
   } catch {
     return null;
@@ -558,15 +564,23 @@ function parseGitHubUrl(remoteUrl) {
 }
 async function getDefaultBranch(projectPath = process.cwd()) {
   try {
-    const { stdout } = await execa("git", ["symbolic-ref", "refs/remotes/origin/HEAD"], {
-      cwd: projectPath
-    });
+    const { stdout } = await execa(
+      "git",
+      ["symbolic-ref", "refs/remotes/origin/HEAD"],
+      {
+        cwd: projectPath
+      }
+    );
     return stdout.trim().replace("refs/remotes/origin/", "") || "main";
   } catch {
     try {
-      const { stdout } = await execa("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
-        cwd: projectPath
-      });
+      const { stdout } = await execa(
+        "git",
+        ["rev-parse", "--abbrev-ref", "HEAD"],
+        {
+          cwd: projectPath
+        }
+      );
       return stdout.trim() || "main";
     } catch {
       return "main";
@@ -758,7 +772,11 @@ function generateCIWorkflowContent(options) {
   }
   if (checks.includes("typecheck")) {
     if (hasTypecheckScript) {
-      const typecheckCmd = getRunCommand(packageManager, "typecheck", isMonorepo2);
+      const typecheckCmd = getRunCommand(
+        packageManager,
+        "typecheck",
+        isMonorepo2
+      );
       steps.push(`
       - name: Type check
         run: ${typecheckCmd}`);
@@ -770,7 +788,11 @@ function generateCIWorkflowContent(options) {
   }
   if (checks.includes("format")) {
     if (hasFormatScript) {
-      const formatCmd = getRunCommand(packageManager, "format:check", isMonorepo2);
+      const formatCmd = getRunCommand(
+        packageManager,
+        "format:check",
+        isMonorepo2
+      );
       steps.push(`
       - name: Format check
         run: ${formatCmd} || npx prettier --check "**/*.{ts,tsx,js,jsx,json,md}"`);
@@ -844,7 +866,13 @@ async function createCIWorkflow(options = {}) {
     const projectInfo = await getProjectInfo(projectPath);
     const packageManager = options.packageManager || projectInfo.packageManager;
     const isMonorepo2 = options.isMonorepo ?? projectInfo.isMonorepo;
-    const checks = options.ciConfig?.checks || ["lint", "typecheck", "format", "build", "test"];
+    const checks = options.ciConfig?.checks || [
+      "lint",
+      "typecheck",
+      "format",
+      "build",
+      "test"
+    ];
     const nodeVersions = options.nodeVersions || ["20"];
     const defaultBranch = options.defaultBranch || "main";
     if (!existsSync3(workflowsDir)) {
@@ -904,12 +932,30 @@ async function initCommand(options) {
   const preset = isNonInteractive ? options.preset : await p.select({
     message: "Choose a scope preset for your project:",
     options: [
-      { value: "saas", label: "\u{1F4E6} SaaS Application - 17 scopes (auth, tasks, boards, sprints, etc.)" },
-      { value: "library", label: "\u{1F4DA} Library/Package - 10 scopes (types, build, docs, examples, etc.)" },
-      { value: "api", label: "\u{1F50C} API/Backend - 13 scopes (auth, endpoints, models, services, etc.)" },
-      { value: "ecommerce", label: "\u{1F6D2} E-commerce - 12 scopes (cart, products, payments, orders, etc.)" },
-      { value: "cms", label: "\u{1F4DD} CMS - 13 scopes (content, pages, media, editor, etc.)" },
-      { value: "custom", label: "\u2728 Custom (define your own scopes manually)" }
+      {
+        value: "saas",
+        label: "\u{1F4E6} SaaS Application - 17 scopes (auth, tasks, boards, sprints, etc.)"
+      },
+      {
+        value: "library",
+        label: "\u{1F4DA} Library/Package - 10 scopes (types, build, docs, examples, etc.)"
+      },
+      {
+        value: "api",
+        label: "\u{1F50C} API/Backend - 13 scopes (auth, endpoints, models, services, etc.)"
+      },
+      {
+        value: "ecommerce",
+        label: "\u{1F6D2} E-commerce - 12 scopes (cart, products, payments, orders, etc.)"
+      },
+      {
+        value: "cms",
+        label: "\u{1F4DD} CMS - 13 scopes (content, pages, media, editor, etc.)"
+      },
+      {
+        value: "custom",
+        label: "\u2728 Custom (define your own scopes manually)"
+      }
     ]
   });
   if (!isNonInteractive && p.isCancel(preset)) {
@@ -926,27 +972,62 @@ async function initCommand(options) {
       await new Promise((resolve) => setTimeout(resolve, 500));
       spinner5.stop(`\u2713 Loaded ${scopes.length} scopes from preset`);
     } catch (error) {
-      console.log(chalk.yellow(`
-\u26A0\uFE0F  Could not load preset package. Using basic scopes.`));
+      console.log(
+        chalk.yellow(
+          `
+\u26A0\uFE0F  Could not load preset package. Using basic scopes.`
+        )
+      );
       scopes = [
-        { name: "feat", description: "New features and enhancements", emoji: "\u2728" },
+        {
+          name: "feat",
+          description: "New features and enhancements",
+          emoji: "\u2728"
+        },
         { name: "fix", description: "Bug fixes and patches", emoji: "\u{1F41B}" },
-        { name: "documentation", description: "Documentation updates and improvements", emoji: "\u{1F4DA}" }
+        {
+          name: "documentation",
+          description: "Documentation updates and improvements",
+          emoji: "\u{1F4DA}"
+        }
       ];
     }
   } else {
     scopes = [
-      { name: "feat", description: "New features and enhancements", emoji: "\u2728" },
+      {
+        name: "feat",
+        description: "New features and enhancements",
+        emoji: "\u2728"
+      },
       { name: "fix", description: "Bug fixes and patches", emoji: "\u{1F41B}" },
-      { name: "documentation", description: "Documentation updates and improvements", emoji: "\u{1F4DA}" }
+      {
+        name: "documentation",
+        description: "Documentation updates and improvements",
+        emoji: "\u{1F4DA}"
+      }
     ];
-    console.log(chalk.dim("\n\u{1F4A1} Tip: Edit workflow.config.json to add your custom scopes"));
+    console.log(
+      chalk.dim(
+        "\n\u{1F4A1} Tip: Edit workflow.config.json to add your custom scopes"
+      )
+    );
   }
   const config = {
     projectName,
     scopes,
     enforcement: "strict",
-    language: "en"
+    language: "en",
+    hooks: {
+      enabled: true,
+      preCommit: ["validate-branch", "check-guidelines"],
+      commitMsg: ["validate-commit"]
+    },
+    ci: {
+      enabled: true,
+      provider: "github",
+      checks: ["lint", "typecheck", "format", "build", "test"]
+    },
+    reservedScopeNames: DEFAULT_RESERVED_SCOPE_NAMES
   };
   const configPath = join4(cwd, "workflow.config.json");
   await writeFile3(configPath, JSON.stringify(config, null, 2));
@@ -958,8 +1039,12 @@ async function initCommand(options) {
   const projectInfo = await getProjectInfo(cwd);
   const mandatoryTemplates = getMandatoryTemplates();
   const optionalTemplates = getOptionalTemplates();
-  console.log(chalk.dim(`
-\u{1F4CB} Generating ${mandatoryTemplates.length} mandatory guidelines...`));
+  console.log(
+    chalk.dim(
+      `
+\u{1F4CB} Generating ${mandatoryTemplates.length} mandatory guidelines...`
+    )
+  );
   const guidelinesDir = join4(cwd, "guidelines");
   const templatesDir = join4(__dirname, "../../templates");
   let mandatoryGenerated = 0;
@@ -972,13 +1057,20 @@ async function initCommand(options) {
       try {
         const templatePath = join4(templatesDir, template.filename);
         const outputPath = join4(guidelinesDir, template.filename);
-        await renderTemplateFile(templatePath, outputPath, context);
+        await renderTemplateFile(templatePath, outputPath, {
+          ...context,
+          reservedScopeNames: (config.reservedScopeNames || []).join(", ")
+        });
         mandatoryGenerated++;
       } catch (error) {
-        console.log(chalk.yellow(`  \u26A0\uFE0F  Could not generate ${template.filename}`));
+        console.log(
+          chalk.yellow(`  \u26A0\uFE0F  Could not generate ${template.filename}`)
+        );
       }
     }
-    console.log(chalk.green(`\u2713 Generated ${mandatoryGenerated} mandatory guidelines`));
+    console.log(
+      chalk.green(`\u2713 Generated ${mandatoryGenerated} mandatory guidelines`)
+    );
     let shouldGenerateOptional = isNonInteractive;
     if (!isNonInteractive) {
       const response = await p.confirm({
@@ -997,11 +1089,17 @@ async function initCommand(options) {
         } catch {
         }
       }
-      console.log(chalk.green(`\u2713 Generated ${optionalGenerated} optional guidelines`));
+      console.log(
+        chalk.green(`\u2713 Generated ${optionalGenerated} optional guidelines`)
+      );
     }
   } catch (error) {
-    console.log(chalk.yellow(`
-\u26A0\uFE0F  Could not generate guidelines: ${error instanceof Error ? error.message : String(error)}`));
+    console.log(
+      chalk.yellow(
+        `
+\u26A0\uFE0F  Could not generate guidelines: ${error instanceof Error ? error.message : String(error)}`
+      )
+    );
     console.log(chalk.dim("You can manually copy guidelines later if needed."));
   }
   if (hasGitRepo(cwd)) {
@@ -1016,7 +1114,14 @@ async function initCommand(options) {
     if (shouldInstallHooks) {
       const hookSpinner = p.spinner();
       hookSpinner.start("Installing git hooks...");
-      const hookResults = await installHooks(config.hooks, cwd);
+      const hookResults = await installHooks(
+        config.hooks || {
+          enabled: true,
+          preCommit: ["validate-branch", "check-guidelines"],
+          commitMsg: ["validate-commit"]
+        },
+        cwd
+      );
       const allSuccess = hookResults.every((r) => r.success);
       if (allSuccess) {
         hookSpinner.stop("\u2713 Installed git hooks");
@@ -1028,19 +1133,29 @@ async function initCommand(options) {
   if (repoInfo.isGitHub) {
     const existingCI = hasCIWorkflow(cwd);
     if (!existingCI) {
-      console.log(chalk.dim("\n\u{1F527} Setting up GitHub Actions CI (mandatory for GitHub repos)..."));
+      console.log(
+        chalk.dim(
+          "\n\u{1F527} Setting up GitHub Actions CI (mandatory for GitHub repos)..."
+        )
+      );
       const ciResult = await createCIWorkflow({
         projectPath: cwd,
         packageManager: projectInfo.packageManager,
         isMonorepo: projectInfo.isMonorepo,
-        ciConfig: config.ci,
+        ciConfig: config.ci || {
+          enabled: true,
+          provider: "github",
+          checks: ["lint", "typecheck", "format", "build", "test"]
+        },
         defaultBranch: repoInfo.defaultBranch || "main"
       });
       if (ciResult.success) {
         console.log(chalk.green("\u2713 Created GitHub Actions CI workflow"));
         console.log(chalk.dim(`  File: .github/workflows/ci.yml`));
       } else {
-        console.log(chalk.yellow(`\u26A0\uFE0F  Could not create CI workflow: ${ciResult.error}`));
+        console.log(
+          chalk.yellow(`\u26A0\uFE0F  Could not create CI workflow: ${ciResult.error}`)
+        );
       }
     } else {
       console.log(chalk.dim("\n\u2713 GitHub Actions CI workflow already exists"));
@@ -1068,13 +1183,21 @@ async function initCommand(options) {
   }
   p.outro(chalk.green("\u2713 Workflow Agent initialized successfully!"));
   console.log(chalk.dim("\nNext steps:"));
-  console.log(chalk.dim("  1. Review your configuration in workflow.config.json"));
-  console.log(chalk.dim("  2. Review generated guidelines in guidelines/ directory"));
+  console.log(
+    chalk.dim("  1. Review your configuration in workflow.config.json")
+  );
+  console.log(
+    chalk.dim("  2. Review generated guidelines in guidelines/ directory")
+  );
   console.log(chalk.dim("  3. Run: workflow validate branch"));
   console.log(chalk.dim("  4. Run: workflow doctor (for health check)\n"));
   if (repoInfo.isGitHub) {
-    console.log(chalk.cyan("\u{1F4A1} Recommended: Enable branch protection on GitHub"));
-    console.log(chalk.dim("   Settings \u2192 Branches \u2192 Add rule \u2192 Require status checks\n"));
+    console.log(
+      chalk.cyan("\u{1F4A1} Recommended: Enable branch protection on GitHub")
+    );
+    console.log(
+      chalk.dim("   Settings \u2192 Branches \u2192 Add rule \u2192 Require status checks\n")
+    );
   }
 }
 
@@ -1084,7 +1207,9 @@ import { execa as execa2 } from "execa";
 async function validateCommand(type, value, _options = {}) {
   const config = await loadConfig();
   if (!config) {
-    console.error(chalk2.red("\u2717 No workflow configuration found. Run: workflow init"));
+    console.error(
+      chalk2.red("\u2717 No workflow configuration found. Run: workflow init")
+    );
     process.exit(1);
   }
   let targetValue = value;
@@ -1134,8 +1259,12 @@ async function validateCommand(type, value, _options = {}) {
       if (enforcementLevel === "strict") {
         process.exit(1);
       } else {
-        console.log(chalk2.yellow(`
-\u26A0\uFE0F  Advisory mode: validation failed but not blocking`));
+        console.log(
+          chalk2.yellow(
+            `
+\u26A0\uFE0F  Advisory mode: validation failed but not blocking`
+          )
+        );
         process.exit(0);
       }
     }
@@ -1153,37 +1282,45 @@ import prompts from "prompts";
 import chalk3 from "chalk";
 function createConfigCommand() {
   const command = new Command("config").description("Manage workflow configuration").option("-f, --force", "Skip validation checks").option("--cwd <path>", "Working directory", process.cwd());
-  command.command("validate").description("Validate workflow configuration").action(async (options) => {
+  command.command("validate").description("Validate workflow configuration").action(async () => {
     const opts = command.opts();
     await validateConfigAction(opts);
   });
-  command.command("add").description("Add configuration items").argument("<type>", "Type to add (scope)").action(async (type, options) => {
+  command.command("add").description("Add configuration items").argument("<type>", "Type to add (scope)").action(async (type) => {
     const opts = command.opts();
     if (type === "scope") {
       await addScopeAction(opts);
     } else {
-      console.error(chalk3.red(`Unknown type: ${type}. Currently only "scope" is supported.`));
+      console.error(
+        chalk3.red(
+          `Unknown type: ${type}. Currently only "scope" is supported.`
+        )
+      );
       process.exit(1);
     }
   });
-  command.command("remove").description("Remove configuration items").argument("<type>", "Type to remove (scope)").argument("<name>", "Name of the item to remove").action(async (type, name, options) => {
+  command.command("remove").description("Remove configuration items").argument("<type>", "Type to remove (scope)").argument("<name>", "Name of the item to remove").action(async (type, name) => {
     const opts = command.opts();
     if (type === "scope") {
       await removeScopeAction(name, opts);
     } else {
-      console.error(chalk3.red(`Unknown type: ${type}. Currently only "scope" is supported.`));
+      console.error(
+        chalk3.red(
+          `Unknown type: ${type}. Currently only "scope" is supported.`
+        )
+      );
       process.exit(1);
     }
   });
-  command.command("list").description("List configuration items").argument("[type]", "Type to list (scopes, reserved, all)", "all").action(async (type, options) => {
+  command.command("list").description("List configuration items").argument("[type]", "Type to list (scopes, reserved, all)", "all").action(async (type) => {
     const opts = command.opts();
     await listConfigAction(type, opts);
   });
-  command.command("get").description("Get a configuration value").argument("<path>", "Configuration path (e.g., scopes[0].name)").action(async (path2, options) => {
+  command.command("get").description("Get a configuration value").argument("<path>", "Configuration path (e.g., scopes[0].name)").action(async (path2) => {
     const opts = command.opts();
     await getConfigValue(path2, opts);
   });
-  command.command("set").description("Set a configuration value").argument("<path>", "Configuration path (e.g., reservedScopeNames)").argument("<value>", "Value to set").action(async (path2, value, options) => {
+  command.command("set").description("Set a configuration value").argument("<path>", "Configuration path (e.g., reservedScopeNames)").argument("<value>", "Value to set").action(async (path2, value) => {
     const opts = command.opts();
     await setConfigValue(path2, value, opts);
   });
@@ -1214,7 +1351,9 @@ async function addScopeAction(opts) {
   const cwd = opts.cwd || process.cwd();
   const configPath = join5(cwd, "workflow.config.json");
   if (!existsSync5(configPath)) {
-    console.error(chalk3.red("No workflow.config.json found. Run: workflow init"));
+    console.error(
+      chalk3.red("No workflow.config.json found. Run: workflow init")
+    );
     process.exit(1);
   }
   const config = await loadConfig(cwd);
@@ -1231,7 +1370,8 @@ async function addScopeAction(opts) {
       message: "Scope name:",
       validate: (value) => {
         if (!value) return "Name is required";
-        if (existingNames.includes(value)) return `Scope "${value}" already exists`;
+        if (existingNames.includes(value))
+          return `Scope "${value}" already exists`;
         const validation = validateScopeName(value, reservedNames);
         if (!validation.valid) {
           return validation.error + (validation.suggestion ? ` Try: ${validation.suggestion}` : "");
@@ -1306,7 +1446,9 @@ async function addScopeAction(opts) {
   console.log(chalk3.gray(`  Description: ${response.description}`));
   console.log(chalk3.gray(`  Types: ${response.allowedTypes.join(", ")}`));
   if (newScope.mandatoryGuidelines) {
-    console.log(chalk3.gray(`  Guidelines: ${newScope.mandatoryGuidelines.join(", ")}`));
+    console.log(
+      chalk3.gray(`  Guidelines: ${newScope.mandatoryGuidelines.join(", ")}`)
+    );
   }
 }
 async function removeScopeAction(name, opts) {
@@ -1357,9 +1499,15 @@ async function listConfigAction(type, opts) {
         console.log(chalk3.green(`
   ${index + 1}. ${scope.name}`));
         console.log(chalk3.gray(`     ${scope.description}`));
-        console.log(chalk3.gray(`     Types: ${scope.allowedTypes.join(", ")}`));
+        console.log(
+          chalk3.gray(`     Types: ${scope.allowedTypes?.join(", ") || "all"}`)
+        );
         if (scope.mandatoryGuidelines && scope.mandatoryGuidelines.length > 0) {
-          console.log(chalk3.gray(`     Guidelines: ${scope.mandatoryGuidelines.join(", ")}`));
+          console.log(
+            chalk3.gray(
+              `     Guidelines: ${scope.mandatoryGuidelines.join(", ")}`
+            )
+          );
         }
       });
     }
@@ -1368,7 +1516,11 @@ async function listConfigAction(type, opts) {
     const reserved = config.reservedScopeNames || DEFAULT_RESERVED_SCOPE_NAMES;
     console.log(chalk3.blue("\n\u{1F6AB} Reserved Scope Names:"));
     console.log(chalk3.gray(`  ${reserved.join(", ")}`));
-    console.log(chalk3.gray('\n  \u{1F4A1} Configure in workflow.config.json: "reservedScopeNames"'));
+    console.log(
+      chalk3.gray(
+        '\n  \u{1F4A1} Configure in workflow.config.json: "reservedScopeNames"'
+      )
+    );
   }
 }
 async function getConfigValue(path2, opts) {
@@ -1408,7 +1560,9 @@ async function setConfigValue(path2, value, opts) {
     const validation = await validateConfig(cwd);
     if (!validation.valid) {
       console.error(chalk3.red("\u2717 Invalid configuration after change:"));
-      validation.errors.forEach((err) => console.error(chalk3.red(`  \u2022 ${err}`)));
+      validation.errors.forEach(
+        (err) => console.error(chalk3.red(`  \u2022 ${err}`))
+      );
       console.log(chalk3.gray("\nUse --force to skip validation"));
       process.exit(1);
     }
@@ -1479,7 +1633,9 @@ async function suggestCommand(feedback, options = {}) {
   console.log(chalk4.dim("\nYour suggestion will be:"));
   console.log(chalk4.dim("  1. Reviewed by the community"));
   console.log(chalk4.dim("  2. Prioritized based on impact"));
-  console.log(chalk4.dim("  3. Incorporated into future releases if approved\n"));
+  console.log(
+    chalk4.dim("  3. Incorporated into future releases if approved\n")
+  );
 }
 
 // src/cli/commands/doctor.ts
@@ -1503,7 +1659,9 @@ function getEffectiveMandatoryTemplates(guidelinesConfig) {
     }
   }
   if (guidelinesConfig.optionalOverrides) {
-    mandatory = mandatory.filter((t) => !guidelinesConfig.optionalOverrides.includes(t));
+    mandatory = mandatory.filter(
+      (t) => !guidelinesConfig.optionalOverrides.includes(t)
+    );
   }
   return mandatory;
 }
@@ -1520,7 +1678,9 @@ async function validateGuidelinesExist(projectPath = process.cwd(), config) {
     const mandatory2 = getEffectiveMandatoryTemplates(config?.guidelines);
     result.valid = false;
     result.missingMandatory = mandatory2;
-    result.errors.push("Guidelines directory does not exist. Run: workflow init");
+    result.errors.push(
+      "Guidelines directory does not exist. Run: workflow init"
+    );
     return result;
   }
   let existingFiles = [];
@@ -1528,7 +1688,9 @@ async function validateGuidelinesExist(projectPath = process.cwd(), config) {
     existingFiles = await readdir(guidelinesDir);
   } catch (error) {
     result.valid = false;
-    result.errors.push(`Cannot read guidelines directory: ${error instanceof Error ? error.message : String(error)}`);
+    result.errors.push(
+      `Cannot read guidelines directory: ${error instanceof Error ? error.message : String(error)}`
+    );
     return result;
   }
   const mandatory = getEffectiveMandatoryTemplates(config?.guidelines);
@@ -1568,7 +1730,9 @@ async function validateGitHubActionsSetup(projectPath = process.cwd()) {
   };
   if (!existsSync6(workflowsDir)) {
     result.valid = false;
-    result.errors.push("GitHub Actions workflows directory does not exist. Run: workflow github:setup");
+    result.errors.push(
+      "GitHub Actions workflows directory does not exist. Run: workflow github:setup"
+    );
     return result;
   }
   let workflowFiles = [];
@@ -1576,11 +1740,24 @@ async function validateGitHubActionsSetup(projectPath = process.cwd()) {
     workflowFiles = await readdir(workflowsDir);
   } catch (error) {
     result.valid = false;
-    result.errors.push(`Cannot read workflows directory: ${error instanceof Error ? error.message : String(error)}`);
+    result.errors.push(
+      `Cannot read workflows directory: ${error instanceof Error ? error.message : String(error)}`
+    );
     return result;
   }
-  const ciWorkflowNames = ["ci.yml", "ci.yaml", "main.yml", "main.yaml", "build.yml", "build.yaml", "test.yml", "test.yaml"];
-  const ciWorkflows = workflowFiles.filter((f) => ciWorkflowNames.includes(f.toLowerCase()));
+  const ciWorkflowNames = [
+    "ci.yml",
+    "ci.yaml",
+    "main.yml",
+    "main.yaml",
+    "build.yml",
+    "build.yaml",
+    "test.yml",
+    "test.yaml"
+  ];
+  const ciWorkflows = workflowFiles.filter(
+    (f) => ciWorkflowNames.includes(f.toLowerCase())
+  );
   if (ciWorkflows.length === 0) {
     result.valid = false;
     result.errors.push("No CI workflow file found. Run: workflow github:setup");
@@ -1592,7 +1769,9 @@ async function validateGitHubActionsSetup(projectPath = process.cwd()) {
   try {
     workflowContent = await readFile3(workflowPath, "utf-8");
   } catch (error) {
-    result.warnings.push(`Cannot read workflow file: ${error instanceof Error ? error.message : String(error)}`);
+    result.warnings.push(
+      `Cannot read workflow file: ${error instanceof Error ? error.message : String(error)}`
+    );
     return result;
   }
   const contentLower = workflowContent.toLowerCase();
@@ -1621,10 +1800,16 @@ async function validateGitHubActionsSetup(projectPath = process.cwd()) {
   } else {
     result.warnings.push("CI workflow may be missing test step");
   }
-  const mandatoryChecks = [result.hasLintCheck, result.hasTypecheckCheck, result.hasFormatCheck];
+  const mandatoryChecks = [
+    result.hasLintCheck,
+    result.hasTypecheckCheck,
+    result.hasFormatCheck
+  ];
   if (!mandatoryChecks.every(Boolean)) {
     result.valid = false;
-    result.errors.push("CI workflow is missing mandatory checks (lint, typecheck, format)");
+    result.errors.push(
+      "CI workflow is missing mandatory checks (lint, typecheck, format)"
+    );
   }
   return result;
 }
@@ -1661,13 +1846,25 @@ async function doctorCommand(options = {}) {
   console.log(chalk5.bold("\n\u{1F4DA} Guidelines"));
   const guidelinesResult = await validateGuidelinesExist(cwd, config);
   if (guidelinesResult.valid) {
-    console.log(chalk5.green(`  \u2713 All ${guidelinesResult.presentMandatory.length} mandatory guidelines present`));
+    console.log(
+      chalk5.green(
+        `  \u2713 All ${guidelinesResult.presentMandatory.length} mandatory guidelines present`
+      )
+    );
     if (guidelinesResult.presentOptional.length > 0) {
-      console.log(chalk5.dim(`    + ${guidelinesResult.presentOptional.length} optional guidelines`));
+      console.log(
+        chalk5.dim(
+          `    + ${guidelinesResult.presentOptional.length} optional guidelines`
+        )
+      );
     }
   } else {
     hasErrors = true;
-    console.log(chalk5.red(`  \u2717 Missing ${guidelinesResult.missingMandatory.length} mandatory guidelines:`));
+    console.log(
+      chalk5.red(
+        `  \u2717 Missing ${guidelinesResult.missingMandatory.length} mandatory guidelines:`
+      )
+    );
     for (const missing of guidelinesResult.missingMandatory) {
       console.log(chalk5.red(`    \u2022 ${missing}`));
     }
@@ -1681,14 +1878,20 @@ async function doctorCommand(options = {}) {
     const hookStatuses = await getAllHooksStatus(cwd);
     const installedHooks = hookStatuses.filter((h) => h.installed);
     if (installedHooks.length === hookStatuses.length) {
-      console.log(chalk5.green(`  \u2713 All ${installedHooks.length} hooks installed`));
+      console.log(
+        chalk5.green(`  \u2713 All ${installedHooks.length} hooks installed`)
+      );
       for (const hook of hookStatuses) {
         const extra = hook.wrappedOriginal ? " (wrapping original)" : "";
         console.log(chalk5.dim(`    \u2022 ${hook.hookType}${extra}`));
       }
     } else if (installedHooks.length > 0) {
       hasWarnings = true;
-      console.log(chalk5.yellow(`  \u26A0 ${installedHooks.length}/${hookStatuses.length} hooks installed`));
+      console.log(
+        chalk5.yellow(
+          `  \u26A0 ${installedHooks.length}/${hookStatuses.length} hooks installed`
+        )
+      );
       for (const hook of hookStatuses) {
         if (hook.installed) {
           console.log(chalk5.green(`    \u2713 ${hook.hookType}`));
@@ -1711,7 +1914,11 @@ async function doctorCommand(options = {}) {
     console.log(chalk5.dim("  \u25CB Not a GitHub repository (CI check skipped)"));
     console.log(chalk5.dim(`    Remote: ${repoInfo.remoteUrl || "none"}`));
   } else {
-    console.log(chalk5.dim(`    Repository: ${repoInfo.github?.owner}/${repoInfo.github?.repo}`));
+    console.log(
+      chalk5.dim(
+        `    Repository: ${repoInfo.github?.owner}/${repoInfo.github?.repo}`
+      )
+    );
     const ciResult = await validateGitHubActionsSetup(cwd);
     if (ciResult.valid) {
       console.log(chalk5.green("  \u2713 GitHub Actions CI configured correctly"));
@@ -1740,15 +1947,21 @@ async function doctorCommand(options = {}) {
   if (repoInfo.isGitHub && hasCIWorkflow(cwd)) {
     console.log(chalk5.cyan("  \u2192 Enable branch protection on GitHub"));
     console.log(chalk5.dim("    Settings \u2192 Branches \u2192 Add rule"));
-    console.log(chalk5.dim("    \u2611 Require status checks to pass before merging"));
-    console.log(chalk5.dim("    \u2611 Require branches to be up to date before merging"));
+    console.log(
+      chalk5.dim("    \u2611 Require status checks to pass before merging")
+    );
+    console.log(
+      chalk5.dim("    \u2611 Require branches to be up to date before merging")
+    );
   }
   if (config.enforcement !== "strict") {
     console.log(chalk5.cyan(`  \u2192 Consider switching to 'strict' enforcement`));
     console.log(chalk5.dim(`    Current: ${config.enforcement}`));
   }
   if (config.scopes.length < 5) {
-    console.log(chalk5.cyan("  \u2192 Consider adding more scopes for better organization"));
+    console.log(
+      chalk5.cyan("  \u2192 Consider adding more scopes for better organization")
+    );
     console.log(chalk5.dim("    Run: workflow config add scope <name>"));
   }
   console.log(chalk5.bold("\n\u{1F4CA} Summary"));
@@ -1766,7 +1979,7 @@ async function doctorCommand(options = {}) {
 // src/cli/commands/setup.ts
 import * as p3 from "@clack/prompts";
 import chalk6 from "chalk";
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync7 } from "fs";
+import { readFileSync, writeFileSync as writeFileSync2, existsSync as existsSync7 } from "fs";
 import { join as join7 } from "path";
 var WORKFLOW_SCRIPTS = {
   "workflow:init": "workflow-agent init",
@@ -1782,7 +1995,7 @@ async function setupCommand() {
     p3.cancel("No package.json found in current directory");
     process.exit(1);
   }
-  const packageJsonContent = readFileSync2(packageJsonPath, "utf-8");
+  const packageJsonContent = readFileSync(packageJsonPath, "utf-8");
   const packageJson = JSON.parse(packageJsonContent);
   if (!packageJson.scripts) {
     packageJson.scripts = {};
@@ -1826,7 +2039,11 @@ async function setupCommand() {
     JSON.stringify(packageJson, null, 2) + "\n",
     "utf-8"
   );
-  p3.outro(chalk6.green(`\u2713 Added ${Object.keys(scriptsToAdd).length} workflow scripts to package.json!`));
+  p3.outro(
+    chalk6.green(
+      `\u2713 Added ${Object.keys(scriptsToAdd).length} workflow scripts to package.json!`
+    )
+  );
   console.log(chalk6.dim("\nRun them with:"));
   console.log(chalk6.dim("  pnpm run workflow:init"));
   console.log(chalk6.dim("  npm run workflow:init\n"));
@@ -1851,8 +2068,10 @@ async function scopeCreateCommand(options) {
     placeholder: "my-custom-scope",
     validate: (value) => {
       if (!value || value.length === 0) return "Package name is required";
-      if (!/^[a-z0-9-]+$/.test(value)) return "Package name must be lowercase alphanumeric with hyphens";
-      if (value.length > 32) return "Package name must be 32 characters or less";
+      if (!/^[a-z0-9-]+$/.test(value))
+        return "Package name must be lowercase alphanumeric with hyphens";
+      if (value.length > 32)
+        return "Package name must be 32 characters or less";
       return void 0;
     }
   });
@@ -1887,7 +2106,9 @@ async function scopeCreateCommand(options) {
       });
     }
   } else {
-    console.log(chalk7.dim("\nAdd scopes to your preset (aim for 8-15 scopes):\n"));
+    console.log(
+      chalk7.dim("\nAdd scopes to your preset (aim for 8-15 scopes):\n")
+    );
     let addMore = true;
     while (addMore) {
       const scopeName = await p4.text({
@@ -1895,9 +2116,11 @@ async function scopeCreateCommand(options) {
         placeholder: "auth",
         validate: (value) => {
           if (!value || value.length === 0) return "Scope name is required";
-          if (!/^[a-z0-9-]+$/.test(value)) return "Must be lowercase alphanumeric with hyphens";
+          if (!/^[a-z0-9-]+$/.test(value))
+            return "Must be lowercase alphanumeric with hyphens";
           if (value.length > 32) return "Must be 32 characters or less";
-          if (scopes.some((s) => s.name === value)) return "Scope name already exists";
+          if (scopes.some((s) => s.name === value))
+            return "Scope name already exists";
           return void 0;
         }
       });
@@ -1908,7 +2131,8 @@ async function scopeCreateCommand(options) {
         message: "Description:",
         placeholder: "Authentication and authorization",
         validate: (value) => {
-          if (!value || value.length < 10) return "Description must be at least 10 characters";
+          if (!value || value.length < 10)
+            return "Description must be at least 10 characters";
           return void 0;
         }
       });
@@ -1966,13 +2190,17 @@ async function scopeCreateCommand(options) {
   const validation = validateScopeDefinitions(scopes);
   if (!validation.valid) {
     console.log(chalk7.red("\n\u2717 Scope validation failed:\n"));
-    validation.errors.forEach((error) => console.log(chalk7.red(`  \u2022 ${error}`)));
+    validation.errors.forEach(
+      (error) => console.log(chalk7.red(`  \u2022 ${error}`))
+    );
     p4.cancel("Operation cancelled");
     process.exit(1);
   }
-  console.log(chalk7.green(`
+  console.log(
+    chalk7.green(`
 \u2713 ${scopes.length} scopes validated successfully
-`));
+`)
+  );
   let outputDir;
   if (options.outputDir) {
     outputDir = options.outputDir;
@@ -2126,7 +2354,11 @@ describe('${presetName} Scope Preset', () => {
   });
 });
 `;
-      await writeFile4(join8(outputDir, "src", "index.test.ts"), testFile, "utf-8");
+      await writeFile4(
+        join8(outputDir, "src", "index.test.ts"),
+        testFile,
+        "utf-8"
+      );
     }
     spinner5.stop("\u2713 Package structure created");
     if (isMonorepo2) {
@@ -2134,13 +2366,17 @@ describe('${presetName} Scope Preset', () => {
       const workspaceContent = await readFile4(workspaceFile, "utf-8");
       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:"));
+        console.log(
+          chalk7.yellow("\n\u26A0\uFE0F  Add the following to pnpm-workspace.yaml:")
+        );
         console.log(chalk7.dim(`  - '${packagePath}'`));
       } else {
         console.log(chalk7.green("\n\u2713 Package will be included in workspace"));
       }
     }
-    console.log(chalk7.green.bold("\n\u2728 Custom scope package created successfully!\n"));
+    console.log(
+      chalk7.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}`));
@@ -2153,17 +2389,27 @@ describe('${presetName} Scope Preset', () => {
     if (!options.noTest) {
       console.log(chalk7.dim(`  4. pnpm test`));
     }
-    console.log(chalk7.dim(`  ${!options.noTest ? "5" : "4"}. Update repository URL in package.json`));
+    console.log(
+      chalk7.dim(
+        `  ${!options.noTest ? "5" : "4"}. Update repository URL in package.json`
+      )
+    );
     const shouldPublish = isNonInteractive ? false : await p4.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"));
-      console.log(chalk7.dim("  1. npm login (or configure .npmrc with your registry)"));
+      console.log(
+        chalk7.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(chalk7.dim("  4. Use in other projects: pnpm add @workflow/scopes-" + packageName + "\n"));
+      console.log(
+        chalk7.dim(
+          "  4. Use in other projects: pnpm add @workflow/scopes-" + packageName + "\n"
+        )
+      );
     }
   } catch (error) {
     spinner5.stop("\u2717 Failed to create package");
@@ -2200,11 +2446,17 @@ async function scopeMigrateCommand(options) {
     p5.cancel("No scopes found in workflow.config.json");
     process.exit(1);
   }
-  console.log(chalk8.dim(`Found ${config.scopes.length} scopes in workflow.config.json
-`));
+  console.log(
+    chalk8.dim(`Found ${config.scopes.length} scopes in workflow.config.json
+`)
+  );
   console.log(chalk8.bold("Current scopes:"));
   config.scopes.forEach((scope, i) => {
-    console.log(chalk8.dim(`  ${i + 1}. ${scope.emoji || "\u2022"} ${scope.name} - ${scope.description}`));
+    console.log(
+      chalk8.dim(
+        `  ${i + 1}. ${scope.emoji || "\u2022"} ${scope.name} - ${scope.description}`
+      )
+    );
   });
   console.log();
   const shouldContinue = await p5.confirm({
@@ -2224,8 +2476,10 @@ async function scopeMigrateCommand(options) {
     placeholder: config.projectName.toLowerCase().replace(/[^a-z0-9-]/g, "-"),
     validate: (value) => {
       if (!value || value.length === 0) return "Package name is required";
-      if (!/^[a-z0-9-]+$/.test(value)) return "Package name must be lowercase alphanumeric with hyphens";
-      if (value.length > 32) return "Package name must be 32 characters or less";
+      if (!/^[a-z0-9-]+$/.test(value))
+        return "Package name must be lowercase alphanumeric with hyphens";
+      if (value.length > 32)
+        return "Package name must be 32 characters or less";
       return void 0;
     }
   });
@@ -2247,7 +2501,9 @@ async function scopeMigrateCommand(options) {
   const validation = validateScopeDefinitions(config.scopes);
   if (!validation.valid) {
     console.log(chalk8.yellow("\n\u26A0\uFE0F  Scope validation warnings:\n"));
-    validation.errors.forEach((error) => console.log(chalk8.yellow(`  \u2022 ${error}`)));
+    validation.errors.forEach(
+      (error) => console.log(chalk8.yellow(`  \u2022 ${error}`))
+    );
     const shouldFix = await p5.confirm({
       message: "Some scopes have validation issues. Continue anyway?",
       initialValue: false
@@ -2419,7 +2675,9 @@ describe('${presetName} Scope Preset (Migrated)', () => {
       const workspaceContent = await readFile5(workspaceFile, "utf-8");
       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:"));
+        console.log(
+          chalk8.yellow("\n\u26A0\uFE0F  Add the following to pnpm-workspace.yaml:")
+        );
         console.log(chalk8.dim(`  - '${packagePath}'`));
       } else {
         console.log(chalk8.green("\n\u2713 Package will be included in workspace"));
@@ -2438,11 +2696,17 @@ describe('${presetName} Scope Preset (Migrated)', () => {
         preset: `scopes-${packageName}`
         // Reference the new package
       };
-      await writeFile5(configPath, JSON.stringify(updatedConfig, null, 2), "utf-8");
+      await writeFile5(
+        configPath,
+        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(chalk8.dim(`  \u2022 Added preset reference: scopes-${packageName}
-`));
+      console.log(
+        chalk8.dim(`  \u2022 Added preset reference: scopes-${packageName}
+`)
+      );
     }
     console.log(chalk8.green.bold("\n\u2728 Migration completed successfully!\n"));
     console.log(chalk8.bold("Package details:"));
@@ -2459,11 +2723,23 @@ describe('${presetName} Scope Preset (Migrated)', () => {
 `));
     if (!keepConfig) {
       console.log(chalk8.bold("To use the migrated scopes:\n"));
-      console.log(chalk8.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"));
+      console.log(
+        chalk8.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) {
     spinner5.stop("\u2717 Migration failed");
     console.error(chalk8.red("\nError:"), error);
@@ -2505,12 +2781,18 @@ async function installHooksAction(cwd) {
   for (const result of results) {
     if (result.success) {
       if (result.wrappedExisting) {
-        console.log(chalk9.green(`\u2713 Installed ${result.hookType} hook (wrapped existing hook)`));
+        console.log(
+          chalk9.green(
+            `\u2713 Installed ${result.hookType} hook (wrapped existing hook)`
+          )
+        );
       } else {
         console.log(chalk9.green(`\u2713 Installed ${result.hookType} hook`));
       }
     } else {
-      console.error(chalk9.red(`\u2717 Failed to install ${result.hookType}: ${result.error}`));
+      console.error(
+        chalk9.red(`\u2717 Failed to install ${result.hookType}: ${result.error}`)
+      );
       hasErrors = true;
     }
   }
@@ -2533,12 +2815,16 @@ async function uninstallHooksAction(cwd) {
   for (const result of results) {
     if (result.success) {
       if (result.wrappedExisting) {
-        console.log(chalk9.green(`\u2713 Removed ${result.hookType} hook (restored original)`));
+        console.log(
+          chalk9.green(`\u2713 Removed ${result.hookType} hook (restored original)`)
+        );
       } else {
         console.log(chalk9.green(`\u2713 Removed ${result.hookType} hook`));
       }
     } else if (result.error) {
-      console.error(chalk9.red(`\u2717 Failed to remove ${result.hookType}: ${result.error}`));
+      console.error(
+        chalk9.red(`\u2717 Failed to remove ${result.hookType}: ${result.error}`)
+      );
       hasErrors = true;
     }
   }
@@ -2614,7 +2900,11 @@ async function setupAction(cwd) {
       process.exit(0);
     }
   } else {
-    console.log(chalk10.dim(`Repository: ${repoInfo.github?.owner}/${repoInfo.github?.repo}`));
+    console.log(
+      chalk10.dim(
+        `Repository: ${repoInfo.github?.owner}/${repoInfo.github?.repo}`
+      )
+    );
   }
   if (hasCIWorkflow(cwd)) {
     const shouldOverwrite = await p6.confirm({
@@ -2648,7 +2938,13 @@ async function setupAction(cwd) {
     console.log(chalk10.dim("  \u2022 Push to main/develop branches"));
     console.log(chalk10.dim("  \u2022 Pull requests to main/develop branches"));
     console.log(chalk10.dim("\nChecks included:"));
-    const checks = ciConfig?.checks || ["lint", "typecheck", "format", "build", "test"];
+    const checks = ciConfig?.checks || [
+      "lint",
+      "typecheck",
+      "format",
+      "build",
+      "test"
+    ];
     for (const check of checks) {
       const hasScript = check === "lint" ? projectInfo.hasLintScript : check === "typecheck" ? projectInfo.hasTypecheckScript : check === "format" ? projectInfo.hasFormatScript : check === "test" ? projectInfo.hasTestScript : check === "build" ? projectInfo.hasBuildScript : false;
       const status = hasScript ? chalk10.green("\u2713") : chalk10.yellow("\u26A0");
@@ -2657,7 +2953,9 @@ async function setupAction(cwd) {
     }
     console.log(chalk10.cyan("\n\u{1F4A1} Recommended: Enable branch protection"));
     console.log(chalk10.dim("  Go to GitHub \u2192 Settings \u2192 Branches \u2192 Add rule"));
-    console.log(chalk10.dim('  Enable "Require status checks to pass before merging"'));
+    console.log(
+      chalk10.dim('  Enable "Require status checks to pass before merging"')
+    );
     console.log(chalk10.dim('  Select the "ci" status check'));
   } else {
     spinner5.stop(chalk10.red("\u2717 Failed to create CI workflow"));
@@ -2708,18 +3006,496 @@ async function checkAction(cwd) {
   }
 }
 
+// src/cli/commands/fix.ts
+import { existsSync as existsSync10, readFileSync as readFileSync2, writeFileSync as writeFileSync3, mkdirSync } from "fs";
+import { dirname as dirname2, join as join10, relative } from "path";
+import { execa as execa3 } from "execa";
+import * as p7 from "@clack/prompts";
+import pc from "picocolors";
+function extractFilePaths(errorMessage, cwd) {
+  const paths = /* @__PURE__ */ new Set();
+  const patterns = [
+    /(?:at\s+)?([\/\w\.\-]+\.(?:ts|js|tsx|jsx|mjs|cjs|vue|svelte))(?::\d+(?::\d+)?)?/g,
+    /(?:Error in |from )\.?([\/\w\.\-]+\.(?:ts|js|tsx|jsx|mjs|cjs|vue|svelte))/g,
+    /['"]([\/\w\.\-]+\.(?:ts|js|tsx|jsx|mjs|cjs|vue|svelte))['"]/g
+  ];
+  for (const pattern of patterns) {
+    let match;
+    while ((match = pattern.exec(errorMessage)) !== null) {
+      let filePath = match[1];
+      if (!filePath.startsWith("/")) {
+        filePath = join10(cwd, filePath);
+      }
+      if (existsSync10(filePath)) {
+        paths.add(filePath);
+      }
+    }
+  }
+  return Array.from(paths);
+}
+function readFileContents(paths) {
+  const contents = {};
+  for (const filePath of paths) {
+    try {
+      if (existsSync10(filePath)) {
+        contents[filePath] = readFileSync2(filePath, "utf-8");
+      }
+    } catch {
+    }
+  }
+  return contents;
+}
+async function generateFixWithLLM(errorMessage, _fileContents, _context) {
+  console.log(pc.dim("  Analyzing error with LLM..."));
+  return {
+    analysis: `Error analysis for: ${errorMessage.slice(0, 100)}...`,
+    rootCause: "Unable to determine root cause without LLM API access",
+    suggestedFix: {
+      description: "Manual intervention required - LLM API not configured",
+      files: []
+    },
+    confidence: 0
+  };
+}
+async function applyChanges(changes, dryRun) {
+  for (const change of changes) {
+    const actionColor = change.action === "create" ? pc.green : change.action === "delete" ? pc.red : pc.yellow;
+    console.log(`  ${actionColor(change.action.toUpperCase())} ${change.path}`);
+    if (dryRun) {
+      console.log(pc.dim("    (dry run - no changes made)"));
+      continue;
+    }
+    switch (change.action) {
+      case "create":
+      case "modify":
+        if (change.content) {
+          const dir = dirname2(change.path);
+          if (!existsSync10(dir)) {
+            mkdirSync(dir, { recursive: true });
+          }
+          writeFileSync3(change.path, change.content);
+        }
+        break;
+      case "delete":
+        console.log(pc.dim("    (delete skipped for safety)"));
+        break;
+    }
+  }
+}
+async function commitAndPush(message, cwd) {
+  try {
+    await execa3("git", ["add", "-A"], { cwd });
+    const { stdout: status } = await execa3(
+      "git",
+      ["status", "--porcelain"],
+      { cwd }
+    );
+    if (!status.trim()) {
+      return { success: true };
+    }
+    await execa3("git", ["commit", "-m", message], { cwd });
+    await execa3("git", ["push"], { cwd });
+    return { success: true };
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+async function fixCommand(options) {
+  const cwd = process.cwd();
+  console.log(pc.cyan("\n\u{1F527} Auto-Heal: Fixing Pipeline Error\n"));
+  if (!options.error) {
+    console.error(pc.red("Error: --error flag is required"));
+    process.exit(1);
+  }
+  console.log(pc.bold("Error Message:"));
+  console.log(pc.dim(options.error.slice(0, 500)));
+  if (options.error.length > 500) {
+    console.log(pc.dim(`... (${options.error.length - 500} more characters)`));
+  }
+  console.log("");
+  let filePaths = options.files || [];
+  if (filePaths.length === 0) {
+    console.log(pc.dim("Extracting file paths from error..."));
+    filePaths = extractFilePaths(options.error, cwd);
+  }
+  if (filePaths.length > 0) {
+    console.log(pc.bold("\nRelevant Files:"));
+    for (const path2 of filePaths) {
+      console.log(`  \u{1F4C4} ${relative(cwd, path2)}`);
+    }
+    console.log("");
+  }
+  const fileContents = readFileContents(filePaths);
+  let context;
+  if (options.context) {
+    try {
+      context = JSON.parse(options.context);
+    } catch {
+      context = options.context;
+    }
+  }
+  console.log(pc.bold("Generating Fix...\n"));
+  const fix = await generateFixWithLLM(options.error, fileContents, context);
+  console.log(pc.bold("Analysis:"));
+  console.log(`  ${fix.analysis}`);
+  console.log("");
+  console.log(pc.bold("Root Cause:"));
+  console.log(`  ${fix.rootCause}`);
+  console.log("");
+  console.log(pc.bold("Suggested Fix:"));
+  console.log(`  ${fix.suggestedFix.description}`);
+  console.log(`  Confidence: ${Math.round(fix.confidence * 100)}%`);
+  console.log("");
+  if (fix.suggestedFix.files.length === 0) {
+    console.log(
+      pc.yellow("\u26A0\uFE0F  No automatic fix available. Manual intervention required.")
+    );
+    process.exit(1);
+  }
+  if (fix.confidence < 0.5) {
+    console.log(
+      pc.yellow(
+        `\u26A0\uFE0F  Low confidence (${Math.round(fix.confidence * 100)}%). Skipping automatic fix.`
+      )
+    );
+    process.exit(1);
+  }
+  if (!options.auto) {
+    const shouldApply = await p7.confirm({
+      message: "Apply suggested changes?",
+      initialValue: false
+    });
+    if (p7.isCancel(shouldApply) || !shouldApply) {
+      console.log(pc.dim("Fix cancelled."));
+      process.exit(0);
+    }
+  }
+  console.log(pc.bold("\nApplying Changes...\n"));
+  await applyChanges(fix.suggestedFix.files, options.dryRun || false);
+  if (options.dryRun) {
+    console.log(pc.yellow("\n\u26A0\uFE0F  Dry run complete. No changes were made."));
+    process.exit(0);
+  }
+  if (options.auto) {
+    console.log(pc.bold("\nCommitting and Pushing...\n"));
+    const scope = filePaths.length > 0 ? dirname2(relative(cwd, filePaths[0])).split("/")[0] || "core" : "core";
+    const commitMessage = `fix(${scope}): auto-heal pipeline failure
+
+${fix.rootCause}
+
+Auto-generated fix with ${Math.round(fix.confidence * 100)}% confidence.
+`;
+    const result = await commitAndPush(commitMessage, cwd);
+    if (result.success) {
+      console.log(pc.green("\u2705 Fix applied, committed, and pushed!"));
+    } else {
+      console.log(pc.red(`\u274C Failed to commit/push: ${result.error}`));
+      process.exit(1);
+    }
+  } else {
+    console.log(pc.green("\n\u2705 Fix applied! Don't forget to commit and push."));
+  }
+}
+
+// src/cli/commands/visual.ts
+import { existsSync as existsSync11, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync4 } from "fs";
+import { dirname as dirname3, join as join11 } from "path";
+import * as p8 from "@clack/prompts";
+import pc2 from "picocolors";
+function getBaselinesDir() {
+  const cwd = process.cwd();
+  return join11(cwd, ".visual-baselines");
+}
+function getMetadataPath() {
+  return join11(getBaselinesDir(), "baselines.json");
+}
+function loadMetadata() {
+  const metadataPath = getMetadataPath();
+  if (!existsSync11(metadataPath)) {
+    return {};
+  }
+  try {
+    return JSON.parse(readFileSync3(metadataPath, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function saveMetadata(metadata) {
+  const dir = getBaselinesDir();
+  if (!existsSync11(dir)) {
+    mkdirSync2(dir, { recursive: true });
+  }
+  writeFileSync4(getMetadataPath(), JSON.stringify(metadata, null, 2));
+}
+async function checkPlaywright() {
+  try {
+    await import("playwright");
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function visualCaptureCommand(name, url, options) {
+  console.log(pc2.cyan("\n\u{1F4F8} Capturing Visual Baseline\n"));
+  const hasPlaywright = await checkPlaywright();
+  if (!hasPlaywright) {
+    console.log(pc2.yellow("\u26A0\uFE0F  Playwright is not installed."));
+    console.log(pc2.dim("Install it with: npm install playwright"));
+    console.log(
+      pc2.dim("Then install browsers: npx playwright install chromium")
+    );
+    process.exit(1);
+  }
+  const width = parseInt(options.width || "1280");
+  const height = parseInt(options.height || "720");
+  const delay = parseInt(options.delay || "0");
+  console.log(`  Name: ${pc2.bold(name)}`);
+  console.log(`  URL: ${url}`);
+  console.log(`  Viewport: ${width}x${height}`);
+  console.log("");
+  try {
+    const { chromium } = await import("playwright");
+    const browser = await chromium.launch({ headless: true });
+    const context = await browser.newContext({
+      viewport: { width, height }
+    });
+    const page = await context.newPage();
+    console.log(pc2.dim("  Loading page..."));
+    await page.goto(url, { waitUntil: "networkidle" });
+    if (options.waitFor) {
+      console.log(pc2.dim(`  Waiting for selector: ${options.waitFor}`));
+      await page.waitForSelector(options.waitFor, { timeout: 1e4 });
+    }
+    if (delay > 0) {
+      console.log(pc2.dim(`  Waiting ${delay}ms...`));
+      await page.waitForTimeout(delay);
+    }
+    const baselinesDir = getBaselinesDir();
+    const outputPath = options.output || join11(baselinesDir, "screenshots", `${name}.png`);
+    const outputDir = dirname3(outputPath);
+    if (!existsSync11(outputDir)) {
+      mkdirSync2(outputDir, { recursive: true });
+    }
+    console.log(pc2.dim("  Capturing screenshot..."));
+    await page.screenshot({
+      path: outputPath,
+      fullPage: options.fullPage
+    });
+    await browser.close();
+    const metadata = loadMetadata();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    metadata[name] = {
+      name,
+      url,
+      path: outputPath,
+      width,
+      height,
+      createdAt: metadata[name]?.createdAt || now,
+      updatedAt: now
+    };
+    saveMetadata(metadata);
+    console.log(pc2.green(`
+\u2705 Baseline "${name}" saved to ${outputPath}`));
+  } catch (error) {
+    console.error(pc2.red("\n\u274C Failed to capture screenshot:"), error);
+    process.exit(1);
+  }
+}
+async function visualCompareCommand(url, options) {
+  console.log(pc2.cyan("\n\u{1F50D} Comparing Against Baseline\n"));
+  const metadata = loadMetadata();
+  const baseline = metadata[options.baseline];
+  if (!baseline) {
+    console.log(pc2.red(`\u274C Baseline "${options.baseline}" not found`));
+    console.log(pc2.dim("Available baselines:"));
+    Object.keys(metadata).forEach((name) => {
+      console.log(pc2.dim(`  - ${name}`));
+    });
+    process.exit(1);
+  }
+  if (!existsSync11(baseline.path)) {
+    console.log(pc2.red(`\u274C Baseline screenshot not found: ${baseline.path}`));
+    process.exit(1);
+  }
+  console.log(`  Baseline: ${pc2.bold(options.baseline)}`);
+  console.log(`  URL: ${url}`);
+  console.log(`  Viewport: ${baseline.width}x${baseline.height}`);
+  console.log("");
+  const hasPlaywright = await checkPlaywright();
+  if (!hasPlaywright) {
+    console.log(pc2.yellow("\u26A0\uFE0F  Playwright is not installed."));
+    process.exit(1);
+  }
+  try {
+    const { chromium } = await import("playwright");
+    const browser = await chromium.launch({ headless: true });
+    const context = await browser.newContext({
+      viewport: { width: baseline.width, height: baseline.height }
+    });
+    const page = await context.newPage();
+    console.log(pc2.dim("  Loading page..."));
+    await page.goto(url, { waitUntil: "networkidle" });
+    const baselinesDir = getBaselinesDir();
+    const comparePath = options.output || join11(
+      baselinesDir,
+      "comparisons",
+      `${options.baseline}-${Date.now()}.png`
+    );
+    const compareDir = dirname3(comparePath);
+    if (!existsSync11(compareDir)) {
+      mkdirSync2(compareDir, { recursive: true });
+    }
+    console.log(pc2.dim("  Capturing screenshot..."));
+    await page.screenshot({ path: comparePath });
+    await browser.close();
+    const baselineBuffer = readFileSync3(baseline.path);
+    const compareBuffer = readFileSync3(comparePath);
+    const areSameSize = baselineBuffer.length === compareBuffer.length;
+    const areIdentical = areSameSize && baselineBuffer.equals(compareBuffer);
+    console.log("");
+    if (areIdentical) {
+      console.log(pc2.green("\u2705 Screenshots are identical"));
+    } else {
+      console.log(pc2.yellow("\u26A0\uFE0F  Screenshots differ"));
+      console.log(pc2.dim(`  Baseline size: ${baselineBuffer.length} bytes`));
+      console.log(pc2.dim(`  Current size: ${compareBuffer.length} bytes`));
+      console.log("");
+      console.log(
+        pc2.dim(
+          "For detailed LLM-based comparison, use the GitHub App's visual testing."
+        )
+      );
+      console.log(pc2.dim(`Comparison saved to: ${comparePath}`));
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error(pc2.red("\n\u274C Failed to compare:"), error);
+    process.exit(1);
+  }
+}
+async function visualListCommand(options) {
+  const metadata = loadMetadata();
+  const baselines = Object.values(metadata);
+  if (options.json) {
+    console.log(JSON.stringify(baselines, null, 2));
+    return;
+  }
+  if (baselines.length === 0) {
+    console.log(pc2.dim("No baselines found."));
+    console.log(pc2.dim("Create one with: workflow visual capture <name> <url>"));
+    return;
+  }
+  console.log(pc2.cyan("\n\u{1F4F8} Visual Baselines\n"));
+  for (const baseline of baselines) {
+    console.log(`  ${pc2.bold(baseline.name)}`);
+    console.log(`    URL: ${baseline.url}`);
+    console.log(`    Viewport: ${baseline.width}x${baseline.height}`);
+    console.log(`    Path: ${baseline.path}`);
+    console.log(`    Updated: ${baseline.updatedAt}`);
+    console.log("");
+  }
+}
+async function visualUpdateCommand(name, options) {
+  const metadata = loadMetadata();
+  const baseline = metadata[name];
+  if (!baseline) {
+    console.log(pc2.red(`\u274C Baseline "${name}" not found`));
+    process.exit(1);
+  }
+  console.log(pc2.cyan(`
+\u{1F504} Updating baseline "${name}"...
+`));
+  await visualCaptureCommand(name, baseline.url, {
+    width: options.width || String(baseline.width),
+    height: options.height || String(baseline.height),
+    fullPage: options.fullPage,
+    output: baseline.path
+  });
+}
+async function visualApproveCommand(name) {
+  const metadata = loadMetadata();
+  const baseline = metadata[name];
+  if (!baseline) {
+    console.log(pc2.red(`\u274C Baseline "${name}" not found`));
+    process.exit(1);
+  }
+  const confirm8 = await p8.confirm({
+    message: `Update baseline "${name}" with the latest comparison?`,
+    initialValue: false
+  });
+  if (p8.isCancel(confirm8) || !confirm8) {
+    console.log(pc2.dim("Cancelled."));
+    return;
+  }
+  const baselinesDir = getBaselinesDir();
+  const comparisonsDir = join11(baselinesDir, "comparisons");
+  if (!existsSync11(comparisonsDir)) {
+    console.log(pc2.yellow("No comparisons found to approve."));
+    return;
+  }
+  console.log(
+    pc2.yellow(
+      "To approve, re-capture the baseline with: workflow visual update " + name
+    )
+  );
+}
+
 // src/cli/index.ts
 var program = new Command2();
-program.name("workflow").description("A self-evolving workflow management system for AI agent development").version("1.0.0");
-program.command("init").description("Initialize workflow in current project").option("--migrate", "Auto-detect existing patterns and migrate").option("--workspace", "Initialize for multiple repositories").option("--preset <preset>", "Preset to use (saas, library, api, ecommerce, cms, custom)").option("--name <name>", "Project name").option("-y, --yes", "Skip confirmation prompts").action(initCommand);
-program.command("validate <type>").description("Validate branch name, commit message, or PR title").argument("<type>", "What to validate: branch, commit, or pr").argument("[value]", "Value to validate (defaults to current branch/HEAD commit)").option("--suggest-on-error", "Offer improvement suggestions on validation errors").action(validateCommand);
+program.name("workflow").description(
+  "A self-evolving workflow management system for AI agent development"
+).version("1.0.0");
+program.command("init").description("Initialize workflow in current project").option("--migrate", "Auto-detect existing patterns and migrate").option("--workspace", "Initialize for multiple repositories").option(
+  "--preset <preset>",
+  "Preset to use (saas, library, api, ecommerce, cms, custom)"
+).option("--name <name>", "Project name").option("-y, --yes", "Skip confirmation prompts").action(initCommand);
+program.command("validate <type>").description("Validate branch name, commit message, or PR title").argument("<type>", "What to validate: branch, commit, or pr").argument(
+  "[value]",
+  "Value to validate (defaults to current branch/HEAD commit)"
+).option(
+  "--suggest-on-error",
+  "Offer improvement suggestions on validation errors"
+).action(validateCommand);
 program.addCommand(createConfigCommand());
-program.command("suggest").description("Submit an improvement suggestion").argument("<feedback>", "Your improvement suggestion").option("--author <author>", "Your name or username").option("--category <category>", "Category: feature, bug, documentation, performance, other").action(suggestCommand);
+program.command("suggest").description("Submit an improvement suggestion").argument("<feedback>", "Your improvement suggestion").option("--author <author>", "Your name or username").option(
+  "--category <category>",
+  "Category: feature, bug, documentation, performance, other"
+).action(suggestCommand);
 program.command("setup").description("Add workflow scripts to package.json").action(setupCommand);
-program.command("doctor").description("Run health check and get optimization suggestions").option("--check-guidelines-only", "Only check mandatory guidelines exist (exits 0 or 1)").action(doctorCommand);
+program.command("doctor").description("Run health check and get optimization suggestions").option(
+  "--check-guidelines-only",
+  "Only check mandatory guidelines exist (exits 0 or 1)"
+).action(doctorCommand);
 program.command("hooks").description("Manage git hooks (install, uninstall, status)").argument("<action>", "Action: install, uninstall, status").action(hooksCommand);
 program.command("github").description("Manage GitHub Actions CI (setup, check)").argument("<action>", "Action: setup, check").action(githubCommand);
-program.command("scope: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)").option("--preset-name <preset>", "Preset display name").option("--output-dir <dir>", "Output directory").option("--no-test", "Skip test file generation").action(scopeCreateCommand);
+program.command("scope: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)"
+).option("--preset-name <preset>", "Preset display name").option("--output-dir <dir>", "Output directory").option("--no-test", "Skip test file generation").action(scopeCreateCommand);
 program.command("scope:migrate").description("Migrate inline scopes to a custom package").option("--name <name>", "Package name for the preset").option("--output-dir <dir>", "Output directory").option("--keep-config", "Keep inline scopes in config after migration").action(scopeMigrateCommand);
+program.command("fix").description("Auto-heal pipeline failures using LLM").option("--error <error>", "Error message to fix (required)").option("--context <context>", "Additional context JSON").option("--files <files>", "Comma-separated file paths to analyze").option("--auto", "Apply fix automatically without confirmation").option("--dry-run", "Show what would be changed without applying").action((options) => {
+  fixCommand({
+    error: options.error,
+    context: options.context,
+    files: options.files?.split(","),
+    auto: options.auto,
+    dryRun: options.dryRun
+  });
+});
+var visual = program.command("visual").description("Visual testing commands");
+visual.command("capture").description("Capture a new baseline screenshot").argument("<name>", "Name for the baseline").argument("<url>", "URL to capture").option("-w, --width <width>", "Viewport width", "1280").option("-h, --height <height>", "Viewport height", "720").option("--full-page", "Capture full page").option("-o, --output <path>", "Output path").option("--wait-for <selector>", "Wait for selector before capture").option("--delay <ms>", "Additional delay in ms").action(visualCaptureCommand);
+visual.command("compare").description("Compare a URL against a baseline").argument("<url>", "URL to compare").option("-b, --baseline <name>", "Baseline name to compare against (required)").option("-o, --output <path>", "Output path for comparison screenshot").option("-t, --threshold <percent>", "Difference threshold percentage").action((url, options) => {
+  if (!options.baseline) {
+    console.error("Error: --baseline is required");
+    process.exit(1);
+  }
+  visualCompareCommand(url, options);
+});
+visual.command("list").description("List all baselines").option("--json", "Output as JSON").action(visualListCommand);
+visual.command("update").description("Update an existing baseline").argument("<name>", "Baseline name to update").option("-w, --width <width>", "Override viewport width").option("-h, --height <height>", "Override viewport height").option("--full-page", "Capture full page").action(visualUpdateCommand);
+visual.command("approve").description("Approve a comparison as the new baseline").argument("<name>", "Baseline name to approve").action(visualApproveCommand);
 program.parse();
 //# sourceMappingURL=index.js.map