@williambeto/ai-workflow 2.4.9 → 2.6.3

package/src/core/delegation-controller.js

@@ -1,193 +0,0 @@
-import { OpenCodeAdapter } from "./runtime/opencode-adapter.js";
-
-/**
- * DelegationController - Manages and logs coordination between Atlas, Astra, Sage, and Phoenix.
- */
-export class DelegationController {
-  constructor({ cwd = process.cwd(), ledger, adapter } = {}) {
-    this.cwd = cwd;
-    this.ledger = ledger;
-    this.adapter = adapter || new OpenCodeAdapter({ cwd });
-  }
-
-  /**
-   * Logs routing decision by Atlas.
-   */
-  async route(naturalRequest, classification) {
-    const decision = classification.routingDecision || {};
-    this.lastRoutingDecision = decision;
-
-    if (this.ledger) {
-      this.ledger.logEvent({
-        actor: "Atlas",
-        actorType: "control-plane",
-        observed: true,
-        eventType: "routing",
-        provenance: "request-classifier",
-        data: {
-          request: naturalRequest,
-          requestedActor: decision.requestedActor || null,
-          selectedActor: decision.selectedActor || null,
-          operationType: decision.operationType || null,
-          mutationIntent: decision.mutationIntent || null,
-          permissionDecision: decision.permissionDecision || null,
-          reason: decision.reason || null,
-          workflowPath: decision.workflowPath || [],
-          classification,
-          event: "routing.completed",
-          runtimeAgentRequested: null,
-          runtimeAgentApplied: null,
-          runtimeAgentSupported: false,
-          status: decision.permissionDecision === "blocked" ? "BLOCKED" : "COMPLETED"
-        }
-      });
-    }
-  }
-
-  /**
-   * Logs and executes the implementation process by Astra.
-   */
-  async implement(promptMsg, owner, options = {}) {
-    const decision = this.lastRoutingDecision || {};
-    const inspection = await this.adapter.inspect();
-    const isSpecialized = ["Nexus", "Orion", "Astra", "Sage", "Phoenix"].includes(owner);
-    const supportsAgent = inspection.supports?.agent;
-    const canApply = !isSpecialized || supportsAgent;
-
-    if (this.ledger) {
-      this.ledger.logEvent({
-        actor: canApply ? owner : "Atlas",
-        actorType: canApply ? "runtime-agent" : "control-plane",
-        observed: true,
-        runtime: "opencode",
-        eventType: "implementation_start",
-        provenance: "opencode-adapter",
-        data: {
-          agent: owner,
-          prompt: promptMsg,
-          event: "implementation.started",
-          requestedActor: decision.requestedActor || null,
-          selectedActor: decision.selectedActor || null,
-          runtimeAgentRequested: owner,
-          runtimeAgentApplied: null,
-          runtimeAgentSupported: supportsAgent || false,
-          permissionDecision: decision.permissionDecision || null,
-          reason: decision.reason || null,
-          status: "started"
-        }
-      });
-    }
-
-    const runResult = await this.adapter.execute(promptMsg, { agent: owner, ...options });
-
-    if (this.ledger) {
-      const isApplied = runResult.runtimeAgentApplied === owner;
-      this.ledger.logEvent({
-        actor: isApplied ? owner : "Atlas",
-        actorType: isApplied ? "runtime-agent" : "control-plane",
-        observed: true,
-        runtime: "opencode",
-        eventType: "implementation_complete",
-        provenance: "opencode-adapter",
-        data: {
-          success: runResult.success,
-          commandsRun: runResult.commandsRun || [],
-          eventCount: runResult.eventCount || 0,
-          error: runResult.error,
-          event: "implementation.completed",
-          requestedActor: decision.requestedActor || null,
-          selectedActor: decision.selectedActor || null,
-          runtimeAgentRequested: runResult.runtimeAgentRequested || owner || null,
-          runtimeAgentApplied: runResult.runtimeAgentApplied || null,
-          runtimeAgentSupported: runResult.runtimeAgentSupported !== undefined ? runResult.runtimeAgentSupported : (supportsAgent || false),
-          permissionDecision: decision.permissionDecision || null,
-          reason: runResult.error || decision.reason || null,
-          status: runResult.status || (runResult.success ? "COMPLETED" : "FAILED")
-        }
-      });
-    }
-
-    return runResult;
-  }
-
-  /**
-   * Runs validation locally without logging Sage since no validation agent runtime was executed.
-   */
-  async validate(taskSlug, mode, profile, verifyFn) {
-    const result = await verifyFn();
-
-    if (mode === "full") {
-      const decision = this.lastRoutingDecision || {};
-      const inspection = await this.adapter.inspect();
-      const supportsAgent = inspection.supports?.agent;
-      const canApply = supportsAgent;
-
-      if (this.ledger) {
-        this.ledger.logEvent({
-          actor: canApply ? "Sage" : "Atlas",
-          actorType: canApply ? "auditor" : "control-plane",
-          observed: true,
-          runtime: "opencode",
-          eventType: "validation_start",
-          provenance: "opencode-adapter",
-          data: {
-            agent: "Sage",
-            event: "validation.started",
-            requestedActor: decision.requestedActor || null,
-            selectedActor: decision.selectedActor || null,
-            runtimeAgentRequested: "Sage",
-            runtimeAgentApplied: null,
-            runtimeAgentSupported: supportsAgent || false,
-            permissionDecision: decision.permissionDecision || null,
-            reason: decision.reason || null,
-            status: "started"
-          }
-        });
-      }
-
-      let gitDiff = "";
-      try {
-        const { execSync } = await import("node:child_process");
-        gitDiff = execSync("git diff HEAD", { cwd: this.cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
-      } catch {
-        // ignore
-      }
-
-      const prompt = `Please validate the implementation. Diff:\n${gitDiff}\nLocal Evidence:\n${JSON.stringify(result, null, 2)}`;
-      const runResult = await this.adapter.execute(prompt, { agent: "Sage" });
-
-      if (this.ledger) {
-        const isApplied = runResult.runtimeAgentApplied === "Sage";
-        this.ledger.logEvent({
-          actor: isApplied ? "Sage" : "Atlas",
-          actorType: isApplied ? "auditor" : "control-plane",
-          observed: true,
-          runtime: "opencode",
-          eventType: "validation_complete",
-          provenance: "opencode-adapter",
-          data: {
-            success: runResult.success,
-            commandsRun: runResult.commandsRun || [],
-            eventCount: runResult.eventCount || 0,
-            error: runResult.error,
-            event: "validation.completed",
-            requestedActor: decision.requestedActor || null,
-            selectedActor: decision.selectedActor || null,
-            runtimeAgentRequested: runResult.runtimeAgentRequested || "Sage",
-            runtimeAgentApplied: runResult.runtimeAgentApplied || null,
-            runtimeAgentSupported: runResult.runtimeAgentSupported !== undefined ? runResult.runtimeAgentSupported : (supportsAgent || false),
-            permissionDecision: decision.permissionDecision || null,
-            reason: runResult.error || decision.reason || null,
-            status: runResult.status || (runResult.success ? "COMPLETED" : "FAILED")
-          }
-        });
-      }
-
-      if (!runResult.success) {
-        result.overallStatus = "FAIL_QUALITY_GATE";
-      }
-    }
-
-    return result;
-  }
-}

package/src/core/evidence/evidence-ledger.js

@@ -1,98 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-
-/**
- * EvidenceLedger - Traces structural workflow events to make delegation observable.
- */
-export class EvidenceLedger {
-  constructor({ cwd = process.cwd(), workflowId = "unknown" } = {}) {
-    this.cwd = cwd;
-    this.workflowId = workflowId;
-    this.events = [];
-  }
-
-  /**
-   * Logs a workflow event to the ledger.
-   * @param {Object} eventParam
-   * @param {string} eventParam.actor - The agent name (Atlas, Astra, Sage, Phoenix).
-   * @param {string} eventParam.eventType - Type of event.
-   * @param {string} eventParam.provenance - Originating component.
-   * @param {Object} [eventParam.data] - Additional metadata.
-   * @returns {Object} The logged event.
-   */
-  logEvent({ actor, eventType, provenance, data = {}, actorType, observed, runtime }) {
-    const event = {
-      workflowId: this.workflowId,
-      timestamp: new Date().toISOString(),
-      actor,
-      actorType: actorType !== undefined ? actorType : undefined,
-      observed: observed !== undefined ? observed : undefined,
-      runtime: runtime !== undefined ? runtime : undefined,
-      eventType,
-      provenance,
-      data
-    };
-    this.events.push(event);
-    console.log(`[LEDGER] [${actor}] ${eventType}: ${JSON.stringify(data)}`);
-    return event;
-  }
-
-  getEvents() {
-    return this.events;
-  }
-
-  /**
-   * Saves the ledger events to a JSON file.
-   * @param {string} filePath - Absolute or relative path.
-   */
-  async save(filePath) {
-    const targetPath = path.isAbsolute(filePath) ? filePath : path.join(this.cwd, filePath);
-    await fs.mkdir(path.dirname(targetPath), { recursive: true });
-    await fs.writeFile(targetPath, JSON.stringify(this.events, null, 2), "utf8");
-  }
-
-  async verifyRoleConfinement() {
-    const violations = [];
-    const events = this.events;
-    
-    const atlasImplements = events.some(e => e.actor === "Atlas" && (e.eventType === "implementation_start" || e.eventType === "implementation_complete"));
-    if (atlasImplements) {
-      violations.push("Atlas cannot implement directly");
-    }
-
-    const nexusMutates = events.some(e => e.actor === "Nexus" && e.eventType === "file_mutate");
-    if (nexusMutates) {
-      violations.push("Nexus cannot mutate files during discovery");
-    }
-
-    const sageValidates = events.some(e => e.actor === "Sage" && (e.eventType === "validation_start" || e.eventType === "validation_complete"));
-    const hasFidelity = events.some(e => e.eventType === "fidelity_check" || e.eventType === "fidelity_verification");
-    if (sageValidates && !hasFidelity) {
-      violations.push("Sage cannot validate without fidelity evidence");
-    }
-
-    const phoenixRemediates = events.find(e => e.actor === "Phoenix" && e.eventType === "remediation_start");
-    if (phoenixRemediates) {
-      const findings = phoenixRemediates.data?.findings;
-      if (!findings || findings.length === 0) {
-        violations.push("Phoenix cannot perform remediation without findings");
-      }
-    }
-
-    const orionReleases = events.find(e => e.actor === "Orion" && e.eventType === "release_start");
-    if (orionReleases) {
-      const approvals = orionReleases.data?.approvals;
-      if (!approvals || approvals.length === 0) {
-        violations.push("Orion cannot release without explicit approval");
-      }
-    }
-
-    const passed = violations.length === 0;
-    return {
-      passed,
-      status: passed ? "PASS" : "BLOCKED",
-      reason: violations.length > 0 ? `Role violations: ${violations.join("; ")}` : "Verification passed",
-      violations
-    };
-  }
-}

package/src/core/execution-planner.js

@@ -1,62 +0,0 @@
-import path from "node:path";
-
-/**
- * ExecutionPlanner - Formulates a minimum operational plan based on classification.
- */
-export class ExecutionPlanner {
-  constructor({ cwd = process.cwd() } = {}) {
-    this.cwd = cwd;
-  }
-
-  /**
-   * Generates an execution plan.
-   * @param {Object} classification - The output of RequestClassifier.
-   * @param {string} taskSlug - Descriptive slug for the task.
-   * @returns {Object} Operational plan contract.
-   */
-  plan(classification, taskSlug = "task") {
-    const remediationLimit = classification.mode === "full" ? 3 : classification.mode === "quick" ? 1 : 2;
-    const branchNeeded = classification.intent === "write";
-    const specPath = classification.specNeeded
-      ? path.join("docs/workflows", taskSlug, "spec.md")
-      : null;
-
-    const owner = classification.routingDecision?.selectedActor ||
-      (classification.intent === "write" ? "Astra" : classification.owner);
-
-    // Build default expected validations based on the resolved profile
-    const validationsExpected = [];
-    if (classification.validationNeeded) {
-      validationsExpected.push("test");
-      if (classification.profile.startsWith("frontend")) {
-        validationsExpected.push("lint", "build");
-      } else if (classification.profile === "backend-api") {
-        validationsExpected.push("lint");
-      }
-    }
-
-    const restrictions = [
-      "Never commit or push directly to main/master.",
-      "Always execute behavior tests for new or modified behavior."
-    ];
-
-    if (classification.risk === "high") {
-      restrictions.push("Require independent validation review.");
-    }
-
-    return {
-      objective: classification.request,
-      scope: classification.intent === "read-only" ? "Analysis and verification" : "Implementation of requested behavior",
-      restrictions,
-      owner,
-      skills: [...classification.skills],
-      branchNeeded,
-      branchName: branchNeeded ? `feat/${taskSlug}` : null,
-      validationsExpected,
-      remediationLimit,
-      specPath,
-      mode: classification.mode,
-      profile: classification.profile
-    };
-  }
-}

package/src/core/filesystem.js

@@ -1,141 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-
-export async function exists(filePath) {
-  try {
-    await fs.access(filePath);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-export async function writeFileSafe(filePath, content) {
-  await fs.mkdir(path.dirname(filePath), { recursive: true });
-  await fs.writeFile(filePath, content, "utf8");
-}
-
-export async function readJson(filePath) {
-  const content = await fs.readFile(filePath, "utf8");
-  return JSON.parse(content);
-}
-
-function stripJsonComments(content) {
-  let output = "";
-  let inString = false;
-  let quote = "";
-  let escaped = false;
-  let inLineComment = false;
-  let inBlockComment = false;
-
-  for (let index = 0; index < content.length; index += 1) {
-    const char = content[index];
-    const next = content[index + 1];
-
-    if (inLineComment) {
-      if (char === "\n" || char === "\r") {
-        inLineComment = false;
-        output += char;
-      }
-      continue;
-    }
-
-    if (inBlockComment) {
-      if (char === "*" && next === "/") {
-        inBlockComment = false;
-        index += 1;
-        continue;
-      }
-      if (char === "\n" || char === "\r") {
-        output += char;
-      }
-      continue;
-    }
-
-    if (inString) {
-      output += char;
-      if (escaped) {
-        escaped = false;
-      } else if (char === "\\") {
-        escaped = true;
-      } else if (char === quote) {
-        inString = false;
-        quote = "";
-      }
-      continue;
-    }
-
-    if (char === '"' || char === "'") {
-      inString = true;
-      quote = char;
-      output += char;
-      continue;
-    }
-
-    if (char === "/" && next === "/") {
-      inLineComment = true;
-      index += 1;
-      continue;
-    }
-
-    if (char === "/" && next === "*") {
-      inBlockComment = true;
-      index += 1;
-      continue;
-    }
-
-    output += char;
-  }
-
-  return output;
-}
-
-function stripTrailingCommas(content) {
-  let output = "";
-  let inString = false;
-  let quote = "";
-  let escaped = false;
-
-  for (let index = 0; index < content.length; index += 1) {
-    const char = content[index];
-
-    if (inString) {
-      output += char;
-      if (escaped) {
-        escaped = false;
-      } else if (char === "\\") {
-        escaped = true;
-      } else if (char === quote) {
-        inString = false;
-        quote = "";
-      }
-      continue;
-    }
-
-    if (char === '"' || char === "'") {
-      inString = true;
-      quote = char;
-      output += char;
-      continue;
-    }
-
-    if (char === ",") {
-      let nextIndex = index + 1;
-      while (/\s/.test(content[nextIndex] ?? "")) {
-        nextIndex += 1;
-      }
-      if (content[nextIndex] === "}" || content[nextIndex] === "]") {
-        continue;
-      }
-    }
-
-    output += char;
-  }
-
-  return output;
-}
-
-export async function readJsonc(filePath) {
-  const content = await fs.readFile(filePath, "utf8");
-  return JSON.parse(stripTrailingCommas(stripJsonComments(content)));
-}

package/src/core/finalization/finalizer.js

@@ -1,165 +0,0 @@
-import { WorkspaceSnapshot } from "./workspace-snapshot.js";
-import { DeliveryDecisionEngine } from "../validation/delivery-decision-engine.js";
-import { ArtifactFidelityGate } from "../validation/artifact-fidelity-gate.js";
-import { execSync } from "node:child_process";
-
-export class Finalizer {
-  constructor({ cwd = process.cwd() } = {}) {
-    this.cwd = cwd;
-    this.snapshotManager = new WorkspaceSnapshot({ cwd });
-  }
-
-  getChangedFilesFromGit() {
-    try {
-      const files = new Set();
-      // Unstaged changes
-      const diff = execSync("git diff --name-only HEAD", { cwd: this.cwd, encoding: "utf8" });
-      diff.split("\n").map(f => f.trim()).filter(Boolean).forEach(f => files.add(f));
-      
-      // Untracked/staged status
-      const status = execSync("git status --short --untracked-files=all", { cwd: this.cwd, encoding: "utf8" });
-      status.split("\n").forEach(line => {
-        const match = line.match(/^(?:[ MADRCU?!]{2}\s+|[MADRCU?!]\s+)(.+)$/);
-        if (match) {
-          const candidate = match[1].trim();
-          const renamed = candidate.includes(" -> ") ? candidate.split(" -> ").at(-1) : candidate;
-          if (renamed) files.add(renamed);
-        }
-      });
-      return [...files].sort();
-    } catch {
-      return [];
-    }
-  }
-
-  async verifyFidelity(arg) {
-    let userRequest = null;
-    let projectContext = null;
-    let deliveryDecision = null;
-    let changedFiles = null;
-    let evidence = null;
-    let explicitApprovals = [];
-
-    if (Array.isArray(arg)) {
-      changedFiles = arg;
-    } else if (arg && typeof arg === "object") {
-      userRequest = arg.userRequest;
-      projectContext = arg.projectContext;
-      deliveryDecision = arg.deliveryDecision;
-      changedFiles = arg.changedFiles;
-      evidence = arg.evidence;
-      explicitApprovals = arg.explicitApprovals || [];
-    }
-
-    const filesToCheck = changedFiles || this.getChangedFilesFromGit();
-    const decisionEngine = new DeliveryDecisionEngine({ cwd: this.cwd });
-    const actualProjectContext = projectContext || await decisionEngine.detectContext();
-    const actualUserRequest = userRequest || "";
-
-    const actualDeliveryDecision = deliveryDecision || await decisionEngine.determineDecision({
-      userRequest: actualUserRequest,
-      projectContext: actualProjectContext,
-      explicitApprovals
-    });
-
-    const actualDeliveryClass = await decisionEngine.determineClass(filesToCheck);
-
-    const fidelityGate = new ArtifactFidelityGate({
-      cwd: this.cwd,
-      deliveryClass: actualDeliveryClass,
-      userRequest: actualUserRequest,
-      explicitApprovals
-    });
-
-    const requestFidelity = await fidelityGate.verifyRequestFidelity({
-      userRequest: actualUserRequest,
-      deliveryDecision: actualDeliveryDecision,
-      projectContext: actualProjectContext,
-      changedFiles: filesToCheck,
-      evidence,
-      explicitApprovals
-    });
-
-    const verifyResult = await fidelityGate.verify(filesToCheck);
-
-    const passed = requestFidelity.passed && verifyResult.passed;
-    const reason = !requestFidelity.passed ? requestFidelity.reason : verifyResult.reason;
-
-    return {
-      passed,
-      status: requestFidelity.status || (passed ? "PASS" : "BLOCKED"),
-      reason,
-      deliveryClass: actualDeliveryClass,
-      requestFidelity
-    };
-  }
-
-  /**
-   * Compares the current workspace state with a previously captured snapshot.
-   * @param {Object} previousSnapshot - The snapshot object captured earlier.
-   * @returns {Object} { valid: boolean, changes: { added: string[], modified: string[], deleted: string[] } }
-   */
-  async verifyIntegrity(previousSnapshot) {
-    const currentSnapshot = await this.snapshotManager.capture();
-    const added = [];
-    const modified = [];
-    const deleted = [];
-
-    let valid = true;
-
-    // Compare metadata and git trees
-    if (previousSnapshot.branch !== currentSnapshot.branch) {
-      modified.push(`branch:${previousSnapshot.branch}->${currentSnapshot.branch}`);
-      valid = false;
-    }
-    if (previousSnapshot.head !== currentSnapshot.head) {
-      modified.push(`head:${previousSnapshot.head}->${currentSnapshot.head}`);
-      valid = false;
-    }
-    if (previousSnapshot.indexTree !== currentSnapshot.indexTree) {
-      modified.push(`indexTree:${previousSnapshot.indexTree}->${currentSnapshot.indexTree}`);
-      valid = false;
-    }
-    if (previousSnapshot.stagedDiffHash !== currentSnapshot.stagedDiffHash) {
-      modified.push("stagedDiff");
-      valid = false;
-    }
-    if (previousSnapshot.unstagedDiffHash !== currentSnapshot.unstagedDiffHash) {
-      modified.push("unstagedDiff");
-      valid = false;
-    }
-    if (previousSnapshot.untrackedFilesHash !== currentSnapshot.untrackedFilesHash) {
-      modified.push("untrackedFiles");
-      valid = false;
-    }
-
-    // Check for additions and modifications in files
-    const prevFiles = previousSnapshot.files || {};
-    const currFiles = currentSnapshot.files || {};
-
-    for (const [file, info] of Object.entries(currFiles)) {
-      const prevInfo = prevFiles[file];
-      if (!prevInfo) {
-        added.push(file);
-      } else if (prevInfo.sha256 !== info.sha256 || prevInfo.mode !== info.mode) {
-        modified.push(file);
-      }
-    }
-
-    // Check for deletions in files
-    for (const file of Object.keys(prevFiles)) {
-      if (!currFiles[file]) {
-        deleted.push(file);
-      }
-    }
-
-    if (added.length > 0 || modified.length > 0 || deleted.length > 0) {
-      valid = false;
-    }
-
-    return {
-      valid,
-      changes: { added, modified, deleted }
-    };
-  }
-}