@williambeto/ai-workflow 2.4.8 → 2.6.3

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}`);
-}

package/src/commands/clean.js

@@ -1,106 +0,0 @@
-import { existsSync, rmSync, lstatSync, unlinkSync } from "node:fs";
-import { join } from "node:path";
-import readline from "node:readline";
-
-function askConfirmation(question) {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => {
-      rl.close();
-      resolve(answer.trim().toLowerCase());
-    });
-  });
-}
-
-function isSymlink(filePath) {
-  try {
-    return lstatSync(filePath).isSymbolicLink();
-  } catch (_) {
-    return false;
-  }
-}
-
-export async function runClean({ cwd, yes = false, dryRun = false, purgeAgents = false }) {
-  const targets = [
-    ".ai-workflow",
-    "opencode.jsonc",
-    ".workflow-state.json",
-    "opencode"
-  ];
-
-  const hasAgents = existsSync(join(cwd, ".agents"));
-
-  // Check what actually exists
-  const existingTargets = targets
-    .map(name => join(cwd, name))
-    .filter(path => existsSync(path) || isSymlink(path));
-
-  if (existingTargets.length === 0 && (!hasAgents || !purgeAgents)) {
-    console.log("No AI Workflow configuration or files found in the current project.");
-    return;
-  }
-
-  console.log("\n[AI WORKFLOW] De-initialization");
-  console.log("===============================");
-
-  if (dryRun) {
-    console.log("[DRY RUN] The following items would be deleted:");
-    existingTargets.forEach(path => console.log(`  - ${path}`));
-    if (hasAgents && purgeAgents) {
-      console.log(`  - ${join(cwd, ".agents")} (customizations folder)`);
-    } else if (hasAgents) {
-      console.log(`  - NOTE: ${join(cwd, ".agents")} exists but will NOT be deleted (run with --purge-agents to delete)`);
-    }
-    return;
-  }
-
-  // Interactive prompts if --yes / -y is not passed
-  if (!yes) {
-    if (!process.stdin.isTTY) {
-      console.log("Error: Non-interactive terminal detected. Run with --yes to bypass confirmation.");
-      if (process.env.NODE_ENV === "test") {
-        // Allow tests to bypass TTY block if they mock/stub process.stdin
-      } else {
-        process.exit(1);
-      }
-    }
-
-    const confirmDeinit = await askConfirmation("Are you sure you want to de-initialize AI Workflow from the project? [y/N] ");
-    if (confirmDeinit !== "y" && confirmDeinit !== "yes") {
-      console.log("Aborted.");
-      return;
-    }
-
-    if (hasAgents && !purgeAgents) {
-      const confirmPurge = await askConfirmation("A custom '.agents' folder was detected. Do you want to purge it (this deletes custom prompts/rules/skills)? [y/N] ");
-      if (confirmPurge === "y" || confirmPurge === "yes") {
-        purgeAgents = true;
-      }
-    }
-  }
-
-  // Add .agents if requested and exists
-  if (purgeAgents && hasAgents) {
-    existingTargets.push(join(cwd, ".agents"));
-  }
-
-  console.log("\nRemoving files...");
-  for (const target of existingTargets) {
-    try {
-      if (isSymlink(target)) {
-        unlinkSync(target);
-        console.log(`Deleted symlink: ${target}`);
-      } else {
-        rmSync(target, { recursive: true, force: true });
-        console.log(`Deleted directory/file: ${target}`);
-      }
-    } catch (error) {
-      console.error(`Failed to delete ${target}: ${error.message}`);
-    }
-  }
-
-  console.log("\nAI Workflow has been successfully removed from this project.");
-}

package/src/commands/collect-evidence.js

@@ -1,25 +0,0 @@
-import { EvidenceCollector } from "../core/validation/evidence-collector.js";
-import { QualityGuard } from "../core/validation/quality-guard.js";
-import { ValidationPlanner } from "../core/validation/validation-planner.js";
-import { buildDeliverySummary, formatDeliverySummary } from "../core/validation/canonical-finalization.js";
-import fs from "node:fs/promises";
-import path from "node:path";
-
-export async function runCollectEvidence({ cwd, exitOnError = true, taskSlug = null, mode = null, dryRun = false, profile = "generic", branchRecovery = "NOT_RECORDED", userRequest = null, explicitApprovals = [], visualDist = null, port = null }) {
-  const qualityGuard = new QualityGuard({ cwd, taskSlug, mode });
-  const planner = new ValidationPlanner({ cwd, qualityGuard });
-  const tasks = await planner.plan(profile);
-
-  const persist = !dryRun && mode === "full";
-  const collector = new EvidenceCollector({ cwd, timeout: 60000, taskSlug, mode, profile, branchRecovery, userRequest, explicitApprovals, visualDist, port });
-  const evidence = await collector.collect(tasks, { writeArtifact: persist });
-  const summary = buildDeliverySummary({ evidence });
-
-  console.log("\n--- Delivery Summary ---");
-  console.log(formatDeliverySummary(summary));
-  console.log(persist ? "\nArtifact: EVIDENCE.json" : "\nArtifact: NOT_REQUIRED for quick/standard mode");
-  console.log(`Commands processed: ${evidence.commands.length}\n`);
-
-  if (evidence.status === "BLOCKED" && exitOnError) process.exit(1);
-  return evidence;
-}