@williambeto/ai-workflow 2.4.9 → 2.6.3

package/src/core/runtime/opencode-adapter.js

@@ -1,202 +0,0 @@
-import { spawn, spawnSync } from "node:child_process";
-import readline from "node:readline";
-
-/**
- * OpenCodeAdapter - Real runtime integration with the OpenCode CLI.
- */
-export class OpenCodeAdapter {
-  constructor({ cwd = process.cwd() } = {}) {
-    this.cwd = cwd;
-  }
-
-  /**
-   * Inspects the availability and capability of the OpenCode CLI.
-   * @returns {Promise<{available: boolean, supports: {run: boolean, formatJson: boolean, agent: boolean, model: boolean}}>}
-   */
-  async inspect() {
-    try {
-      const cliHelp = spawnSync("opencode", ["--help"], { encoding: "utf8" });
-      const runHelp = spawnSync("opencode", ["run", "--help"], { encoding: "utf8" });
-
-      const available = cliHelp.status === 0 && runHelp.status === 0;
-      if (!available) {
-        return {
-          available: false,
-          supports: { run: false, formatJson: false, agent: false, model: false }
-        };
-      }
-
-      return {
-        available: true,
-        supports: {
-          run: /\brun\b/.test(cliHelp.stdout),
-          formatJson: /--format/.test(runHelp.stdout),
-          agent: /--agent/.test(runHelp.stdout),
-          model: /--model/.test(runHelp.stdout),
-        }
-      };
-    } catch {
-      return {
-        available: false,
-        supports: { run: false, formatJson: false, agent: false, model: false }
-      };
-    }
-  }
-
-  /**
-   * Runs opencode with a prompt and options.
-   * @param {string} message - The message prompt.
-   * @param {Object} options - CLI options (e.g. agent, model, readOnly).
-   * @returns {Promise<{success: boolean, commandsRun: string[], eventCount: number, error?: string}>}
-   */
-  async execute(message, { agent = null, model = null, readOnly = false } = {}) {
-    const inspection = await this.inspect();
-    const isSpecializedAgent = agent && ["Nexus", "Orion", "Astra", "Sage", "Phoenix"].includes(agent);
-
-    if (!inspection.available) {
-      return {
-        success: false,
-        status: isSpecializedAgent ? "BLOCKED" : "FAILED",
-        commandsRun: [],
-        eventCount: 0,
-        error: "OpenCode CLI is not installed or not available in the system PATH.",
-        runtimeAgentRequested: agent || null,
-        runtimeAgentApplied: null,
-        runtimeAgentSupported: false,
-        runtimeAgentSelectionMode: isSpecializedAgent ? "explicit" : "default"
-      };
-    }
-
-    if (isSpecializedAgent && !inspection.supports.agent) {
-      return {
-        success: false,
-        status: "BLOCKED",
-        error: `Requested runtime actor '${agent}' cannot be applied because this OpenCode runtime does not support --agent.`,
-        runtimeAgentRequested: agent,
-        runtimeAgentApplied: null,
-        runtimeAgentSupported: false,
-        runtimeAgentSelectionMode: "unsupported",
-        commandsRun: [],
-        eventCount: 0
-      };
-    }
-
-    const runInWorkspace = async (targetCwd) => {
-      return new Promise((resolve) => {
-        const args = ["run", message];
-        if (inspection.supports.formatJson) {
-          args.push("--format", "json");
-        }
-        if (isSpecializedAgent && inspection.supports.agent) {
-          args.push("--agent", agent);
-        }
-        if (model && inspection.supports.model) {
-          args.push("--model", model);
-        }
-
-        console.log(`[RUNTIME] Delegating to OpenCode: opencode ${args.map(a => a.includes(" ") ? `"${a}"` : a).join(" ")}`);
-
-        const child = spawn("opencode", args, {
-          cwd: targetCwd,
-          stdio: ["ignore", "pipe", "inherit"] // Inherit stderr to show warnings directly
-        });
-
-        const rl = readline.createInterface({
-          input: child.stdout,
-          terminal: false
-        });
-
-        const commandsRun = [];
-        let eventCount = 0;
-
-        rl.on("line", (line) => {
-          const trimmed = line.trim();
-          if (!trimmed) return;
-
-          try {
-            const event = JSON.parse(trimmed);
-            eventCount++;
-
-            // 1. Stream agent output text in real-time to user
-            if (event.type === "text" && event.part?.text) {
-              process.stdout.write(event.part.text);
-            }
-
-            // 2. Capture tool executions/commands
-            if (event.type === "step_start" && event.part?.toolCalls) {
-              for (const call of event.part.toolCalls) {
-                if (call.name === "run_command" && call.args?.CommandLine) {
-                  commandsRun.push(call.args.CommandLine);
-                }
-                if (readOnly) {
-                  const name = call.name || "";
-                  const isWriteTool = name.startsWith("write_") || name.includes("write") || name.includes("replace") || name.includes("edit") || name.includes("delete") || name.includes("remove");
-                  let isDestructiveGit = false;
-                  if (name === "run_command" && call.args?.CommandLine) {
-                    const cmd = call.args.CommandLine;
-                    const destPattern = /\b(git\s+(commit|add|push|merge|reset|rm|branch|checkout|switch|stash|init)|touch|rm|mkdir|cp|mv|chmod|chown|tee|sed|awk)\b|>>|>/;
-                    if (destPattern.test(cmd)) {
-                      isDestructiveGit = true;
-                    }
-                  }
-                  if (isWriteTool || isDestructiveGit) {
-                    console.error(`\n[SECURITY WARNING] Read-only execution blocked attempt to write/modify workspace: tool '${name}' or command detected.`);
-                    child.kill();
-                    resolve({
-                      success: false,
-                      commandsRun,
-                      eventCount,
-                      error: `Read-only confinement violation: tool '${name}' or command attempted write/modify operation during read-only task.`,
-                      runtimeAgentRequested: agent || null,
-                      runtimeAgentApplied: null,
-                      runtimeAgentSupported: inspection.supports.agent,
-                      runtimeAgentSelectionMode: isSpecializedAgent ? "explicit" : "default"
-                    });
-                    return;
-                  }
-                }
-              }
-            }
-          } catch {
-            // If a line is not valid JSON (e.g. starting/finishing logs), print it directly
-            console.log(trimmed);
-          }
-        });
-
-        child.on("close", (code) => {
-          console.log("\n[RUNTIME] OpenCode finished execution.");
-          resolve({
-            success: code === 0,
-            commandsRun,
-            eventCount,
-            runtimeAgentRequested: agent || null,
-            runtimeAgentApplied: isSpecializedAgent ? agent : null,
-            runtimeAgentSupported: inspection.supports.agent,
-            runtimeAgentSelectionMode: isSpecializedAgent ? "explicit" : "default"
-          });
-        });
-
-        child.on("error", (err) => {
-          console.error(`\n[RUNTIME] Failed to launch opencode: ${err.message}`);
-          resolve({
-            success: false,
-            commandsRun,
-            eventCount: 0,
-            error: err.message,
-            runtimeAgentRequested: agent || null,
-            runtimeAgentApplied: null,
-            runtimeAgentSupported: inspection.supports.agent,
-            runtimeAgentSelectionMode: isSpecializedAgent ? "explicit" : "default"
-          });
-        });
-      });
-    };
-
-    if (readOnly) {
-      const { runInReadOnlyWorkspace } = await import("../workspace/read-only-workspace.js");
-      return runInReadOnlyWorkspace(this.cwd, runInWorkspace);
-    } else {
-      return runInWorkspace(this.cwd);
-    }
-  }
-}

package/src/core/sdd/validator.js

@@ -1,67 +0,0 @@
-import fs from "node:fs/promises";
-
-/**
- * SpecValidator - Enforces "No Spec, No Code" rule.
- * Validates existence, structure, and approval status of specifications.
- */
-export class SpecValidator {
-  /**
-   * Validates a specification file.
-   * @param {string} filePath - Path to the .md specification file.
-   * @returns {Promise<{valid: boolean, reason?: string, tier?: string}>}
-   */
-  async validate(filePath) {
-    try {
-      const content = await fs.readFile(filePath, "utf8");
-
-      // Check for tiered tier identification
-      let tier = "unknown";
-      if (content.includes("[DEEP]")) tier = "deep";
-      else if (content.includes("[STANDARD]")) tier = "standard";
-      else if (content.includes("[TINY]")) tier = "tiny";
-
-      if (tier === "unknown") {
-        return { valid: false, reason: "Specification tier [DEEP|STANDARD|TINY] not identified in title." };
-      }
-
-      // Check for Metadata section
-      if (!content.includes("## Metadata")) {
-        return { valid: false, reason: "Missing '## Metadata' section.", tier };
-      }
-
-      // Check for Acceptance Criteria section
-      if (!content.includes("## Acceptance Criteria")) {
-        return { valid: false, reason: "Missing '## Acceptance Criteria' section.", tier };
-      }
-
-      // Check for Approved status
-      const lines = content.split("\n");
-      const statusLine = lines.find(l => l.includes("Status:"));
-      
-      if (!statusLine) {
-        return { valid: false, reason: "Missing Status field in Metadata section.", tier };
-      }
-
-      const statusPart = statusLine.split(":")[1]
-        .replace(/[\*_]/g, "") // Remove bold/italic markers
-        .trim()
-        .toUpperCase();
-      
-      // If it contains multiple options separated by |, it's not approved yet
-      if (statusPart.includes("|")) {
-        return { valid: false, reason: "Specification status is a template list. Must be explicitly set to 'APPROVED'.", tier };
-      }
-
-      if (statusPart !== "APPROVED") {
-        return { valid: false, reason: `Specification status is '${statusPart}', but must be 'APPROVED' to proceed.`, tier };
-      }
-
-      return { valid: true, tier };
-    } catch (error) {
-      if (error.code === "ENOENT") {
-        return { valid: false, reason: `Specification file not found: ${filePath}` };
-      }
-      return { valid: false, reason: `Error reading specification: ${error.message}` };
-    }
-  }
-}

package/src/core/statuses.js

@@ -1,29 +0,0 @@
-export const COMPLETION_STATUSES = Object.freeze([
-  "PASS",
-  "PASS_WITH_NOTES",
-  "FAIL_DELEGATION_GATE",
-  "FAIL_QUALITY_GATE",
-  "FAIL",
-  "BLOCKED",
-  "NOT_RUN"
-]);
-
-export const RECOVERABLE_GATE_STATUSES = Object.freeze([
-  "FAIL_DELEGATION_GATE",
-  "FAIL_QUALITY_GATE"
-]);
-
-export const TERMINAL_FAILURE_STATUSES = Object.freeze([
-  "FAIL",
-  "BLOCKED"
-]);
-
-export function isRecoverableGateFailure(status) {
-  return RECOVERABLE_GATE_STATUSES.includes(status);
-}
-
-export function isTerminalFailure(status) {
-  return TERMINAL_FAILURE_STATUSES.includes(status);
-}
-
-export const COMPLETION_STATUS_TEXT = COMPLETION_STATUSES.join(" | ");

package/src/core/symlink-layout.js

@@ -1,93 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-
-function normalize(p) {
-  return p.split(path.sep).join("/");
-}
-
-/**
- * For v3.0.0 "Elite Governance", we want an ULTRA-CLEAN root.
- * Only "opencode" is symlinked to the root (required for OpenCode discovery).
- * All other assets stay inside .ai-workflow/.
- */
-const LINKABLE_ROOTS = new Set([
-  "opencode",
-  ".agents"
-]);
-
-const LINKABLE_FILES = new Set([]);
-
-export function buildSymlinkEntries({ templateFiles, installRoot = ".ai-workflow" }) {
-  const entries = new Map();
-
-  for (const relativePath of Object.keys(templateFiles)) {
-    if (relativePath === "opencode.jsonc") continue;
-
-    const normalized = normalize(relativePath);
-
-    if (LINKABLE_FILES.has(normalized)) {
-      entries.set(normalized, `${installRoot}/${normalized}`);
-      continue;
-    }
-
-    // Match composite paths in LINKABLE_ROOTS (e.g., "docs/policies")
-    for (const rootPath of LINKABLE_ROOTS) {
-      if (normalized === rootPath || normalized.startsWith(`${rootPath}/`)) {
-        entries.set(rootPath, `${installRoot}/${rootPath}`);
-        break;
-      }
-    }
-  }
-
-  return Array.from(entries.entries()).map(([linkPath, targetPath]) => ({ linkPath, targetPath }));
-}
-
-export async function isSymlinkTo(absoluteLinkPath, absoluteTargetPath) {
-  try {
-    const stat = await fs.lstat(absoluteLinkPath);
-    if (!stat.isSymbolicLink()) return false;
-    const currentTarget = await fs.readlink(absoluteLinkPath);
-    const resolved = path.resolve(path.dirname(absoluteLinkPath), currentTarget);
-    return resolved === absoluteTargetPath;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Internal symlink to satisfy opencode.jsonc paths without polluting the root.
- * Creates .ai-workflow/opencode/skills -> ../.agents/skills
- */
-export async function setupInternalSymlinks(cwd, installRoot = ".ai-workflow") {
-  const skillsLink = path.join(cwd, installRoot, "opencode/skills");
-  const skillsTarget = path.join(cwd, installRoot, ".agents/skills");
-
-  if (!(await exists(skillsTarget))) return;
-
-  try {
-    const stat = await fs.lstat(skillsLink).catch(() => null);
-    if (stat) {
-      if (stat.isSymbolicLink()) {
-        const current = await fs.readlink(skillsLink);
-        if (current === "../.agents/skills") return;
-        await fs.unlink(skillsLink);
-      } else {
-        return; // File exists, skip
-      }
-    }
-
-    const type = process.platform === "win32" ? "junction" : "dir";
-    await fs.symlink("../.agents/skills", skillsLink, type);
-  } catch {
-    // Silent fail for internal symlink
-  }
-}
-
-async function exists(p) {
-  try {
-    await fs.access(p);
-    return true;
-  } catch {
-    return false;
-  }
-}

package/src/core/templates.js

@@ -1,229 +0,0 @@
-import { getFullAgentContent, getFullSkillFiles, discoverPackageFiles, readPackageFile, getPackageVersion } from "./package-assets.js";
-import { getCanonicalAgentName } from "./identity.js";
-
-const COMMON_FILES = {
-  "opencode/README.md": `# OpenCode Setup\n\nThis directory is managed by \`ai-workflow\` init.\nAdd agent and command files required by your project workflow.\n`
-};
-
-const FULL_PRIMARY_AGENTS = [
-  "atlas",
-  "nexus",
-  "orion",
-  "astra",
-  "sage",
-  "phoenix"
-];
-
-const FULL_SKILLS = [
-  "project-memory",
-  "optimize-tokens",
-  "documentation",
-  "architecture",
-  "technical-leadership",
-  "product-discovery",
-  "product-planning",
-  "spec-driven-development",
-  "pr-workflow",
-  "qa-workflow",
-  "release-workflow",
-  "deployment",
-  "ui-ux-design",
-  "design-principles",
-  "frontend-development",
-  "backend-development",
-  "full-stack-development",
-  "refactoring",
-  "prompt-engineer"
-];
-
-const KIT_VERSION = getPackageVersion() ?? "unknown";
-
-function buildRuntimeFiles({ includeFormalEvidence = false } = {}) {
-  const files = {};
-
-  for (const agent of FULL_PRIMARY_AGENTS) {
-    const content = getFullAgentContent(agent);
-    if (content === null) {
-      throw new Error(`CRITICAL FAILURE: Missing required agent asset: dist-assets/agents/${agent}.md`);
-    }
-    files[`opencode/agents/${agent}.md`] = content;
-  }
-
-  for (const skill of FULL_SKILLS) {
-    const skillFiles = getFullSkillFiles(skill);
-    if (Object.keys(skillFiles).length === 0) {
-      continue;
-    }
-    for (const [relPath, content] of Object.entries(skillFiles)) {
-      const targetPath = relPath.replace(/^dist-assets\//, "opencode/");
-      if (!files[targetPath]) {
-        files[targetPath] = content;
-      }
-    }
-  }
-
-  // Copy governance policy into opencode/docs/policies/ so the relative link
-  // ../../docs/policies/SKILLS_COMMON_GOVERNANCE.md resolves correctly from
-  // opencode/skills/{skill}/SKILL.md for OpenCode and all platform adapters.
-  const opencodeGovernancePolicy = readPackageFile("dist-assets/docs/policies/SKILLS_COMMON_GOVERNANCE.md");
-  if (opencodeGovernancePolicy !== null) {
-    files["opencode/docs/policies/SKILLS_COMMON_GOVERNANCE.md"] = opencodeGovernancePolicy;
-  }
-
-  const commandFiles = discoverPackageFiles("dist-assets/commands");
-  for (const [relPath, content] of Object.entries(commandFiles)) {
-    const targetPath = relPath.replace(/^dist-assets\//, "opencode/");
-    if (!files[targetPath]) {
-      files[targetPath] = content;
-    }
-  }
-
-  const opencodeSkillFiles = discoverPackageFiles("dist-assets/skills");
-  for (const [relPath, content] of Object.entries(opencodeSkillFiles)) {
-    const targetPath = relPath.replace(/^dist-assets\//, "opencode/");
-    if (!files[targetPath]) {
-      files[targetPath] = content;
-    }
-  }
-
-  const harnessWorkflowFiles = discoverPackageFiles("dist-assets/harness/workflows");
-  for (const [relPath, content] of Object.entries(harnessWorkflowFiles)) {
-    const targetPath = relPath.replace(/^dist-assets\//, "");
-    files[targetPath] = content;
-  }
-
-  const harnessHandoffFiles = discoverPackageFiles("dist-assets/harness/handoffs");
-  for (const [relPath, content] of Object.entries(harnessHandoffFiles)) {
-    const targetPath = relPath.replace(/^dist-assets\//, "");
-    files[targetPath] = content;
-  }
-
-  const agentsContent = readPackageFile("dist-assets/AGENTS.md");
-  if (agentsContent !== null) files["AGENTS.md"] = agentsContent;
-
-  const consumerQuickstart = readPackageFile("dist-assets/docs/QUICKSTART.md");
-  if (consumerQuickstart !== null) files["QUICKSTART.md"] = consumerQuickstart;
-
-  const policyContent = readPackageFile("dist-assets/docs/architecture-policy.md");
-  if (policyContent !== null) files["opencode/docs/architecture-policy.md"] = policyContent;
-
-  const dpContent = readPackageFile("dist-assets/docs/design-patterns-policy.md");
-  if (dpContent !== null) files["opencode/docs/design-patterns-policy.md"] = dpContent;
-
-  const visualValidationGuide = readPackageFile("dist-assets/docs/visual-validation-guide.md");
-  if (visualValidationGuide !== null) files["opencode/docs/visual-validation-guide.md"] = visualValidationGuide;
-
-  const governancePolicies = discoverPackageFiles("dist-assets/docs/policies");
-  for (const [relPath, content] of Object.entries(governancePolicies)) {
-    const targetPath = relPath.replace(/^dist-assets\//, "opencode/");
-    files[targetPath] = content;
-  }
-
-  const compatibilityDocs = discoverPackageFiles("dist-assets/docs/compatibility");
-  for (const [relPath, content] of Object.entries(compatibilityDocs)) {
-    const targetPath = relPath.replace(/^dist-assets\//, "opencode/");
-    files[targetPath] = content;
-  }
-
-  const qualityReferenceFiles = discoverPackageFiles("dist-assets/docs/references");
-  for (const [relPath, content] of Object.entries(qualityReferenceFiles)) {
-    const targetPath = relPath.replace(/^dist-assets\//, "opencode/");
-    files[targetPath] = content;
-  }
-
-  const workflowProfileFiles = discoverPackageFiles("dist-assets/docs/profiles");
-  for (const [relPath, content] of Object.entries(workflowProfileFiles)) {
-    const targetPath = relPath.replace(/^dist-assets\//, "opencode/");
-    files[targetPath] = content;
-  }
-
-  const templateFiles = discoverPackageFiles("dist-assets/templates");
-  for (const [relPath, content] of Object.entries(templateFiles)) {
-    if (!includeFormalEvidence && relPath.includes("/owner-evidence/")) continue;
-    const targetPath = relPath.replace(/^dist-assets\//, "");
-    files[targetPath] = content;
-  }
-
-  const schemaFiles = discoverPackageFiles("dist-assets/schemas");
-  for (const [relPath, content] of Object.entries(schemaFiles)) {
-    const targetPath = relPath.replace(/^dist-assets\//, "");
-    files[targetPath] = content;
-  }
-
-  return files;
-}
-
-function buildExtraFiles() {
-  const files = {};
-  const exampleFiles = discoverPackageFiles("dist-assets/examples");
-  for (const [relPath, content] of Object.entries(exampleFiles)) {
-    const targetPath = relPath.replace(/^dist-assets\//, "");
-    files[targetPath] = content;
-  }
-  return files;
-}
-
-const STANDARD_FILES = buildRuntimeFiles();
-const FULL_FILES = { ...buildRuntimeFiles({ includeFormalEvidence: true }), ...buildExtraFiles() };
-
-export const PROFILE_FILES = {
-  standard: {
-    ...COMMON_FILES,
-    ...STANDARD_FILES
-  },
-  full: {
-    ...COMMON_FILES,
-    ...FULL_FILES
-  }
-};
-
-export function isValidProfile(profile) {
-  return profile === "standard" || profile === "full";
-}
-
-export function getTemplateFiles(profile = "standard") {
-  return PROFILE_FILES[profile] ?? PROFILE_FILES.standard;
-}
-
-export function getManagedBlocks() {
-  return [
-    ...FULL_PRIMARY_AGENTS.map((agent) => `opencode.jsonc:agent.${getCanonicalAgentName(agent)}`),
-    ...FULL_SKILLS.map((skill) => `opencode.jsonc:agent.${getCanonicalAgentName(skill)}`),
-    "opencode.jsonc:command.atlas",
-    "opencode.jsonc:command.run",
-    "opencode.jsonc:command.discover",
-    "opencode.jsonc:command.spec-create",
-    "opencode.jsonc:command.spec-review",
-    "opencode.jsonc:command.spec-implement",
-    "opencode.jsonc:command.plan",
-    "opencode.jsonc:command.implement",
-    "opencode.jsonc:command.validate",
-    "opencode.jsonc:command.audit",
-    "opencode.jsonc:command.optimize-tokens",
-    "opencode.jsonc:command.update-memory",
-    "opencode.jsonc:command.release",
-    "opencode.jsonc:command.deploy"
-  ];
-}
-
-export function buildAiWorkflowConfig({ profile, managedFiles, managedLinks = [] }) {
-  const version = getPackageVersion();
-  const now = new Date().toISOString();
-
-  return {
-    package: "@williambeto/ai-workflow",
-    version,
-    runtime: "opencode",
-    profile,
-    installMode: "project-local",
-    generatedAt: now,
-    paths: {
-      agents: ".ai-workflow/opencode/agents",
-      commands: ".ai-workflow/opencode/commands",
-      skills: ".ai-workflow/opencode/skills",
-      policies: ".ai-workflow/opencode/docs/policies",
-      harness: ".ai-workflow/harness",
-      schemas: ".ai-workflow/schemas"
-    }
-  };
-}