@williambeto/ai-workflow 2.4.9 → 2.6.4

package/src/adapters/platforms/claude.js

@@ -1,126 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { COMPLETION_STATUS_TEXT } from "../../core/statuses.js";
-
-/**
- * Claude Adapter - Transforms OpenCode agents and skills into CLAUDE.md and .claude/rules/.
- */
-export class ClaudeAdapter {
-  constructor({ cwd }) {
-    this.cwd = cwd;
-  }
-
-  /**
-   * Transforms an OpenCode agent or skill into a Claude rule with completion contract.
-   */
-  async transformToRule(filePath, type = "agent") {
-    const content = await fs.readFile(filePath, "utf8");
-    const fileName = path.basename(filePath, ".md") === "SKILL" 
-      ? path.basename(path.dirname(filePath)) 
-      : path.basename(filePath, ".md");
-    
-    const ruleName = `${type}-${fileName.toLowerCase()}`;
-    
-    const hardenedContent = `---
-name: ${ruleName}
-description: ${type === "agent" ? "Persona" : "Skill"} rule for ${fileName}
----
-# ${fileName} ${type === "agent" ? "Persona" : "Skill"}
-
-${content}
-
-##  Completion Contract (Mandatory)
-Every task completion MUST provide the following payload:
-1. **Status**: ${COMPLETION_STATUS_TEXT}
-2. **Scope reviewed**: Brief summary of what was analyzed.
-3. **Findings**: Evidence-based discoveries.
-4. **Files affected**: List of all concrete paths modified or created.
-5. **Validation/evidence**: Commands run and their results.
-6. **Risks/notes**: Any caveats or technical debt introduced.
-7. **Required manager action**: Clear next step for the orchestrator.
-8. **Can manager continue**: [yes/no]
-`;
-
-    return {
-      content: hardenedContent,
-      name: ruleName
-    };
-  }
-
-  /**
-   * Deploys agents, skills, and root CLAUDE.md.
-   */
-  async deploy(installRoot = ".ai-workflow") {
-    const rulesDir = path.join(this.cwd, ".claude/rules");
-    await fs.mkdir(rulesDir, { recursive: true });
-
-    const sourceAgentsDir = path.join(this.cwd, installRoot, "opencode/agents");
-    const sourceSkillsDir = path.join(this.cwd, installRoot, "opencode/skills");
-    const sourceCommandsDir = path.join(this.cwd, installRoot, "opencode/commands");
-
-    // 1. Deploy Agents to .claude/rules/agent-*.md
-    const agentFiles = await fs.readdir(sourceAgentsDir).catch(() => []);
-    for (const file of agentFiles) {
-      if (!file.endsWith(".md")) continue;
-      const transformed = await this.transformToRule(path.join(sourceAgentsDir, file), "agent");
-      await fs.writeFile(path.join(rulesDir, `${transformed.name}.md`), transformed.content);
-    }
-
-    // 2. Deploy Skills to .claude/rules/skill-*.md
-    const skillFolders = await fs.readdir(sourceSkillsDir).catch(() => []);
-    for (const folder of skillFolders) {
-      const skillSource = path.join(sourceSkillsDir, folder, "SKILL.md");
-      if (await this.exists(skillSource)) {
-        const transformed = await this.transformToRule(skillSource, "skill");
-        await fs.writeFile(path.join(rulesDir, `${transformed.name}.md`), transformed.content);
-      }
-    }
-
-    // 3. Create root CLAUDE.md
-    await this.deployRootClaudeMd(sourceCommandsDir);
-  }
-
-  async deployRootClaudeMd(sourceCommandsDir) {
-    const targetPath = path.join(this.cwd, "CLAUDE.md");
-    
-    // Collect commands to document them in CLAUDE.md
-    const commandFiles = await fs.readdir(sourceCommandsDir).catch(() => []);
-    let commandsDoc = "";
-    for (const file of commandFiles) {
-      if (!file.endsWith(".md")) continue;
-      const name = path.basename(file, ".md");
-      commandsDoc += `- \`ai-workflow run --spec-path=...\` (Target: ${name})\n`;
-    }
-
-    const instructions = `# CLAUDE.md - AI Workflow Kit Governance
-
-This project uses the **AI Workflow Kit** (OpenCode-first) workflow.
-
-##  Mandate: Atlas Authority Protocol
-All architectural changes must align with the specifications issued by the **Specification Authority** (./specs).
-
-##  Common Commands
-${commandsDoc}
-- \`ai-workflow doctor\`: Verify installation.
-- \`ai-workflow collect-evidence\`: Generate EVIDENCE.json.
-
-##  Rules & Personas
-Adhere to the specific rules and personas defined in \`.claude/rules/\`. 
-- Always follow the **Branch Gate** policy (never work on \`main\`).
-- Always follow the **SDD Workflow** (Spec -> Plan -> PR -> Evidence).
-
-##  Completion Contract
-Every task completion MUST follow the payload format defined in the individual rule files.
-`;
-    await fs.writeFile(targetPath, instructions);
-  }
-
-  async exists(p) {
-    try {
-      await fs.access(p);
-      return true;
-    } catch {
-      return false;
-    }
-  }
-}

package/src/adapters/platforms/codex.js

@@ -1,113 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { COMPLETION_STATUS_TEXT } from "../../core/statuses.js";
-
-/**
- * Codex Adapter - Transforms OpenCode agents, skills, and commands into Codex-native formats.
- */
-export class CodexAdapter {
-  constructor({ cwd }) {
-    this.cwd = cwd;
-  }
-
-  /**
-   * Transforms an OpenCode agent into a Codex prompt with completion contract.
-   */
-  async transformAgent(filePath) {
-    const content = await fs.readFile(filePath, "utf8");
-    const fileName = path.basename(filePath, ".md");
-    
-    const hardenedContent = `${content}
-
-##  Completion Contract (Mandatory)
-Every task completion MUST provide the following payload:
-1. **Status**: ${COMPLETION_STATUS_TEXT}
-2. **Scope reviewed**: Brief summary of what was analyzed.
-3. **Findings**: Evidence-based discoveries.
-4. **Files affected**: List of all concrete paths modified or created.
-5. **Validation/evidence**: Commands run and their results.
-6. **Risks/notes**: Any caveats or technical debt introduced.
-7. **Required manager action**: Clear next step for the orchestrator.
-8. **Can manager continue**: [yes/no]
-`;
-
-    return {
-      content: hardenedContent,
-      name: fileName
-    };
-  }
-
-  /**
-   * Deploys agents, skills, and commands to Codex-native directories.
-   * Mapping:
-   * - Agents -> .github/agents/
-   * - Skills -> .agents/skills/
-   * - Commands -> .codex/prompts/
-   */
-  async deploy(installRoot = ".ai-workflow") {
-    const sourceAgentsDir = path.join(this.cwd, installRoot, "opencode/agents");
-    const sourceSkillsDir = path.join(this.cwd, installRoot, "opencode/skills");
-    const sourceCommandsDir = path.join(this.cwd, installRoot, "opencode/commands");
-
-    // 1. Deploy Agents to .github/agents/
-    const codexAgentsDir = path.join(this.cwd, ".github/agents");
-    await fs.mkdir(codexAgentsDir, { recursive: true });
-    
-    const agentFiles = await fs.readdir(sourceAgentsDir).catch(() => []);
-    for (const file of agentFiles) {
-      if (!file.endsWith(".md")) continue;
-      const transformed = await this.transformAgent(path.join(sourceAgentsDir, file));
-      await fs.writeFile(path.join(codexAgentsDir, `${transformed.name}.md`), transformed.content);
-    }
-
-    // 2. Deploy Skills to .agents/skills/
-    const codexSkillsDir = path.join(this.cwd, ".agents/skills");
-    await fs.mkdir(codexSkillsDir, { recursive: true });
-
-    const skillFolders = await fs.readdir(sourceSkillsDir).catch(() => []);
-    for (const folder of skillFolders) {
-      const skillSource = path.join(sourceSkillsDir, folder, "SKILL.md");
-      if (await this.exists(skillSource)) {
-        const targetDir = path.join(codexSkillsDir, folder);
-        await fs.mkdir(targetDir, { recursive: true });
-        const content = await fs.readFile(skillSource, "utf8");
-        await fs.writeFile(path.join(targetDir, "SKILL.md"), content);
-      }
-    }
-
-    // 3. Deploy Commands to .codex/prompts/
-    const codexPromptsDir = path.join(this.cwd, ".codex/prompts");
-    await fs.mkdir(codexPromptsDir, { recursive: true });
-
-    const commandFiles = await fs.readdir(sourceCommandsDir).catch(() => []);
-    for (const file of commandFiles) {
-      if (!file.endsWith(".md") && !file.endsWith(".toml")) continue;
-      // Codex prompts work best as .md
-      const targetFileName = file.endsWith(".toml") ? `${path.basename(file, ".toml")}.md` : file;
-      const content = await fs.readFile(path.join(sourceCommandsDir, file), "utf8");
-      await fs.writeFile(path.join(codexPromptsDir, targetFileName), content);
-    }
-
-    // 4. Copy governance policy into .agents/docs/policies/ so the relative
-    //    link ../../docs/policies/SKILLS_COMMON_GOVERNANCE.md in each
-    //    .agents/skills/{skill}/SKILL.md resolves correctly.
-    const codexPoliciesDir = path.join(this.cwd, ".agents", "docs", "policies");
-    await fs.mkdir(codexPoliciesDir, { recursive: true });
-    const sourcePoliciesDir = path.join(this.cwd, installRoot, "opencode", "docs", "policies");
-    const policyFiles = await fs.readdir(sourcePoliciesDir).catch(() => []);
-    for (const file of policyFiles) {
-      if (!file.endsWith(".md")) continue;
-      const policyContent = await fs.readFile(path.join(sourcePoliciesDir, file), "utf8");
-      await fs.writeFile(path.join(codexPoliciesDir, file), policyContent);
-    }
-  }
-
-  async exists(p) {
-    try {
-      await fs.access(p);
-      return true;
-    } catch {
-      return false;
-    }
-  }
-}

package/src/adapters/platforms/gemini.js

@@ -1,245 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { COMPLETION_STATUS_TEXT } from "../../core/statuses.js";
-
-/**
- * Maps OpenCode agent names to primary agent roles.
- * @type {Record<string, string>}
- */
-const PERSONA_MAPPING = {
-  "atlas": "Atlas",
-  "orion": "Orion",
-  "sage": "Sage",
-  "nexus": "Nexus",
-  "astra": "Astra",
-  "sage-validation": "Sage",
-  "orion-release": "Orion",
-  "orion-deploy": "Orion",
-  "nexus-discovery": "Nexus",
-  "phoenix": "Phoenix"
-};
-
-/**
- * Gemini Adapter - Transforms OpenCode .md to Gemini Skill format and manages .gemini/ integration.
- */
-export class GeminiAdapter {
-  constructor({ cwd }) {
-    this.cwd = cwd;
-  }
-
-  /**
-   * Transforms an OpenCode agent or specialized skill file to a Gemini Skill.
-   * @param {string} filePath - Path to the source .md file.
-   * @returns {Promise<{content: string, name: string}>}
-   */
-  async transform(filePath) {
-    const content = await fs.readFile(filePath, "utf8");
-    const fileName = path.basename(filePath, ".md") === "SKILL" 
-      ? path.basename(path.dirname(filePath)) 
-      : path.basename(filePath, ".md");
-      
-    const persona = PERSONA_MAPPING[fileName.toLowerCase()] || "Astra";
-    
-    // Check if already has frontmatter
-    if (content.trim().startsWith("---")) {
-      return { content, name: fileName };
-    }
-
-    // Extract description from the first paragraph after the title
-    const descriptionMatch = content.match(/^# .*\n\n(.*)/m);
-    const description = descriptionMatch ? descriptionMatch[1].trim() : `Specialized agent for ${fileName}.`;
-
-    const skillContent = `---
-name: ${fileName}
-description: ${description}
----
-# ${persona} Persona
-
-${content}
-
-##  Completion Contract (Mandatory)
-Every task completion MUST provide the following payload:
-1. **Status**: ${COMPLETION_STATUS_TEXT}
-2. **Scope reviewed**: Brief summary of what was analyzed.
-3. **Findings**: Evidence-based discoveries.
-4. **Files affected**: List of all concrete paths modified or created.
-5. **Validation/evidence**: Commands run and their results.
-6. **Risks/notes**: Any caveats or technical debt introduced.
-7. **Required manager action**: Clear next step for the orchestrator.
-8. **Can manager continue**: [yes/no]
-`;
-
-    return {
-      content: skillContent,
-      name: fileName
-    };
-  }
-
-  /**
-   * Deploys transformed skills and agents to their respective directories.
-   * Also orchestrates the .gemini/ native integration.
-   */
-  async deploy(transformedItems, installRoot = ".ai-workflow") {
-    const agentsDir = path.join(this.cwd, installRoot, "opencode/agents");
-    const skillsDir = path.join(this.cwd, installRoot, "opencode/skills");
-    const geminiDir = path.join(this.cwd, ".gemini");
-    
-    await fs.mkdir(agentsDir, { recursive: true });
-    await fs.mkdir(skillsDir, { recursive: true });
-
-    for (const item of transformedItems) {
-      const isAgent = PERSONA_MAPPING[item.name.toLowerCase()];
-      const targetDir = isAgent ? agentsDir : path.join(skillsDir, item.name);
-      const fileName = isAgent ? `${item.name}.md` : "SKILL.md";
-      
-      const absoluteTargetDir = isAgent ? agentsDir : targetDir;
-      await fs.mkdir(absoluteTargetDir, { recursive: true });
-      await fs.writeFile(path.join(absoluteTargetDir, fileName), item.content);
-    }
-    
-    // Deploy native Gemini CLI extensions (.gemini/)
-    await this.deployNativeExtensions(installRoot);
-
-    // Also deploy root GEMINI.md if it doesn't exist
-    await this.deployInstructions();
-  }
-
-  /**
-   * Orchestrates the .gemini/ directory with copies of .ai-workflow/ assets.
-   * Using hard copies instead of symlinks ensures native discovery across all platforms.
-   */
-  async deployNativeExtensions(installRoot = ".ai-workflow") {
-    const geminiDir = path.join(this.cwd, ".gemini");
-    const geminiAgents = path.join(geminiDir, "agents");
-    const geminiSkills = path.join(geminiDir, "skills");
-    const geminiCommands = path.join(geminiDir, "commands");
-
-    await fs.mkdir(geminiAgents, { recursive: true });
-    await fs.mkdir(geminiSkills, { recursive: true });
-    await fs.mkdir(geminiCommands, { recursive: true });
-
-    // 1. Copy Agents
-    const sourceAgentsDir = path.join(this.cwd, installRoot, "opencode/agents");
-    const agentFiles = await fs.readdir(sourceAgentsDir).catch(() => []);
-    for (const file of agentFiles) {
-      if (!file.endsWith(".md")) continue;
-      const content = await fs.readFile(path.join(sourceAgentsDir, file), "utf8");
-      await fs.writeFile(path.join(geminiAgents, file), content);
-    }
-
-    // 2. Copy Skills
-    const sourceSkillsDir = path.join(this.cwd, installRoot, "opencode/skills");
-    const skillFolders = await fs.readdir(sourceSkillsDir).catch(() => []);
-    for (const folder of skillFolders) {
-      const skillSource = path.join(sourceSkillsDir, folder, "SKILL.md");
-      if (await this.exists(skillSource)) {
-        await fs.mkdir(path.join(geminiSkills, folder), { recursive: true });
-        const content = await fs.readFile(skillSource, "utf8");
-        await fs.writeFile(path.join(geminiSkills, folder, "SKILL.md"), content);
-      }
-    }
-
-    // 3. Copy Commands (from dist-assets/commands)
-    const sourceCommandsDir = path.join(this.cwd, installRoot, "opencode/commands");
-    if (await this.exists(sourceCommandsDir)) {
-      const commandFiles = await fs.readdir(sourceCommandsDir).catch(() => []);
-      for (const file of commandFiles) {
-        if (!file.endsWith(".md") && !file.endsWith(".toml")) continue;
-        const content = await fs.readFile(path.join(sourceCommandsDir, file), "utf8");
-        await fs.writeFile(path.join(geminiCommands, file), content);
-      }
-    }
-
-    // 4. Copy governance policy into .gemini/docs/policies/ so the relative
-    //    link ../../docs/policies/SKILLS_COMMON_GOVERNANCE.md in each
-    //    .gemini/skills/{skill}/SKILL.md resolves correctly.
-    const geminiPoliciesDir = path.join(geminiDir, "docs", "policies");
-    await fs.mkdir(geminiPoliciesDir, { recursive: true });
-    const sourcePoliciesDir = path.join(this.cwd, installRoot, "opencode", "docs", "policies");
-    const policyFiles = await fs.readdir(sourcePoliciesDir).catch(() => []);
-    for (const file of policyFiles) {
-      if (!file.endsWith(".md")) continue;
-      const content = await fs.readFile(path.join(sourcePoliciesDir, file), "utf8");
-      await fs.writeFile(path.join(geminiPoliciesDir, file), content);
-    }
-
-    // 5. Inject project settings.json
-    const settingsPath = path.join(geminiDir, "settings.json");
-    if (!(await this.exists(settingsPath))) {
-      const settings = {
-        model: { name: "auto" },
-        ui: { theme: "Ayu" }
-      };
-      await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2));
-    }
-  }
-
-  async exists(p) {
-    try {
-      await fs.access(p);
-      return true;
-    } catch {
-      return false;
-    }
-  }
-
-  /**
-   * Deploys the main GEMINI.md and .geminiignore instructions to the project root.
-   */
-  async deployInstructions() {
-    const targetPath = path.join(this.cwd, "GEMINI.md");
-    const ignorePath = path.join(this.cwd, ".geminiignore");
-    
-    // Deploy GEMINI.md if it doesn't exist
-    try {
-      await fs.access(targetPath);
-    } catch {
-      const instructions = `# AI Workflow Kit - Engineering Governance
-
-## Mandate: Atlas Authority Protocol
-All architectural changes must align with the specifications issued by the **Specification Authority** (./specs).
-
-## Ternary Architecture
-- **Root:** Orchestration and config.
-- **.ai-workflow/:** Implementation (The Muscle).
-- **./specs:** Specifications (The Brain).
-
-## Branch Gates
-- **main Branch:** READ-ONLY.
-- **Validation:** Merges require successful observed validation; full/release workflows may persist EVIDENCE.json.
-
-## Primary Agents
-- **Atlas (Orchestrator)**
-- **Orion (Strategist)**
-- **Sage (Auditor)**
-- **Nexus (Spec Architect)**
-- **Astra (Developer)**
-- **Phoenix (Healer)**
-
-## Operational Preferences
-- Use \`token-economy\` and \`minimal-context\` skills.
-- **Native Discovery**: This project uses workspace-specific extensions in \`.gemini/\`.
-- **Workflow Entry**: Use \`/atlas\` to begin any task.
-`;
-      await fs.writeFile(targetPath, instructions);
-    }
-
-    // Deploy .geminiignore if it doesn't exist
-    try {
-      await fs.access(ignorePath);
-    } catch {
-      const ignoreContent = `.ai-workflow/
-.ai-workflow-backups/
-node_modules/
-.git/
-EVIDENCE.json
-*.tgz
-*.zip
-*.tar
-.gemini/tmp/
-.gemini/history/
-`;
-      await fs.writeFile(ignorePath, ignoreContent);
-    }
-  }
-}

package/src/cli.js

@@ -1,155 +0,0 @@
-import { getPackageVersion } from "./core/package-assets.js";
-import { runInit } from "./commands/init.js";
-import { runDoctor } from "./commands/doctor.js";
-import { runCollectEvidence } from "./commands/collect-evidence.js";
-import { runMasterOrchestrator } from "./commands/run.js";
-import { runExecute } from "./commands/execute.js";
-import { runClean } from "./commands/clean.js";
-
-function printHelp() {
-  console.log(`ai-workflow
-
-Usage:
-  ai-workflow execute "<request>" [--task=<slug>] [--request="<request>"]
-  ai-workflow run --spec-path=<path>
-  ai-workflow init [--yes] [--force] [--dry-run] [--no-install] [--no-overwrite] [--gemini] [--claude] [--codex] [--antigravity] [--profile=<profile>]
-  ai-workflow validate [--a11y] [--visual-dist=<path>] [--port=<port>]
-  ai-workflow collect-evidence [--task=<slug>] [--mode=<quick|standard|full>] [--dry-run] [--visual-dist=<path>] [--port=<port>]
-  ai-workflow doctor
-  ai-workflow clean [--yes] [--dry-run] [--purge-agents]
-
-Commands:
-  execute           Orchestrate execution of a natural request through the state machine
-  run               Proportionate orchestrator with branch safety, validation, and bounded remediation
-  init              Install AI workflow defaults (OpenCode). --profile=standard (default) or --profile=full (adds examples)
-  collect-evidence  Run observed project validation; persists EVIDENCE.json only for full mode
-  doctor            Verify local ai-workflow installation
-  clean             De-initialize and remove AI Workflow files and symlinks from the project
-`);
-}
-
-function parseFlags(args) {
-  const specPathArg = args.find((arg) => arg.startsWith("--spec-path="));
-  const profileEqArg = args.find((arg) => arg.startsWith("--profile="));
-  const taskArg = args.find((arg) => arg.startsWith("--task="));
-  const modeArg = args.find((arg) => arg.startsWith("--mode="));
-  const requestArg = args.find((arg) => arg.startsWith("--request="));
-  const visualDistArg = args.find((arg) => arg.startsWith("--visual-dist="));
-  const portArg = args.find((arg) => arg.startsWith("--port="));
-  const profileIdx = args.indexOf("--profile");
-  const profileVal = profileEqArg
-    ? profileEqArg.replace("--profile=", "")
-    : profileIdx >= 0 && profileIdx + 1 < args.length && !args[profileIdx + 1].startsWith("--")
-      ? args[profileIdx + 1]
-      : undefined;
-
-  return {
-    yes: args.includes("--yes"),
-    force: args.includes("--force"),
-    dryRun: args.includes("--dry-run"),
-    noInstall: args.includes("--no-install"),
-    noOverwrite: args.includes("--no-overwrite"),
-    gemini: args.includes("--gemini"),
-    claude: args.includes("--claude"),
-    codex: args.includes("--codex"),
-    antigravity: args.includes("--antigravity"),
-    "dev-mode": args.includes("--dev-mode"),
-    specPath: specPathArg ? specPathArg.replace("--spec-path=", "") : undefined,
-    profile: profileVal || undefined,
-    taskSlug: taskArg ? taskArg.replace("--task=", "") : undefined,
-    mode: modeArg ? modeArg.replace("--mode=", "") : undefined,
-    request: requestArg ? requestArg.replace("--request=", "") : undefined,
-    visualDist: visualDistArg ? visualDistArg.replace("--visual-dist=", "") : undefined,
-    port: portArg ? portArg.replace("--port=", "") : undefined,
-    a11y: args.includes("--a11y"),
-    purgeAgents: args.includes("--purge-agents") || args.includes("--purge")
-  };
-}
-
-
-export async function runCli(args) {
-  const [command] = args;
-
-  if (command === "--version" || command === "-v") {
-    console.log(getPackageVersion() || "unknown");
-    return;
-  }
-
-  if (!command || command === "--help" || command === "-h") {
-    printHelp();
-    return;
-  }
-
-  if (command === "execute") {
-    const flags = parseFlags(args.slice(1));
-    const positionals = args.slice(1).filter((arg) => !arg.startsWith("-"));
-    const request = flags.request || positionals.join(" ");
-    const result = await runExecute({
-      cwd: process.cwd(),
-      naturalRequest: request,
-      taskSlug: flags.taskSlug
-    });
-    if (result && (result.overallStatus === "FAIL_QUALITY_GATE" || result.overallStatus === "BLOCKED" || result.overallStatus === "FAIL")) {
-      process.exit(1);
-    }
-    return;
-  }
-
-  if (command === "run") {
-    await runMasterOrchestrator({
-      cwd: process.cwd(),
-      ...parseFlags(args.slice(1))
-    });
-    return;
-  }
-
-  if (command === "init") {
-    await runInit({
-      cwd: process.cwd(),
-      ...parseFlags(args.slice(1))
-    });
-    return;
-  }
-
-  if (command === "collect-evidence") {
-    const flags = parseFlags(args.slice(1));
-    if (flags.mode && !["quick", "standard", "full"].includes(flags.mode)) throw new Error("--mode must be quick, standard, or full");
-    await runCollectEvidence({ 
-      cwd: process.cwd(), 
-      taskSlug: flags.taskSlug, 
-      mode: flags.mode, 
-      dryRun: flags.dryRun,
-      visualDist: flags.visualDist,
-      port: flags.port
-    });
-    return;
-  }
-
-  if (command === "validate") {
-    const flags = parseFlags(args.slice(1));
-    const { runValidate } = await import("./commands/validate.js");
-    await runValidate({
-      cwd: process.cwd(),
-      taskSlug: flags.taskSlug,
-      a11y: flags.a11y,
-      visualDist: flags.visualDist,
-      port: flags.port
-    });
-    return;
-  }
-
-  if (command === "doctor") {
-    await runDoctor({ cwd: process.cwd() });
-    return;
-  }
-
-  if (command === "clean") {
-    await runClean({
-      cwd: process.cwd(),
-      ...parseFlags(args.slice(1))
-    });
-    return;
-  }
-
-  throw new Error(`unknown command: ${command}`);
-}