@williambeto/ai-workflow 2.4.9 → 2.6.3

package/src/core/validation/delivery-decision-engine.js

@@ -1,344 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { StackDetector } from "./stack-detector.js";
-
-function parseRequest(request = "") {
-  const req = request.toLowerCase();
-  
-  let targetStack = null;
-  if (/\b(vue|nuxt|quasar)\b/.test(req)) targetStack = "vue";
-  else if (/\b(react|next)\b/.test(req)) targetStack = "react";
-  else if (/\b(angular|svelte)\b/.test(req)) targetStack = "svelte-or-angular";
-  else if (/\b(laravel|django|rails|express|nest|fastify)\b/.test(req)) {
-    if (/\blaravel\b/.test(req)) targetStack = "laravel";
-    else targetStack = "backend";
-  }
-  else if (/\b(wordpress|wp)\b/.test(req)) targetStack = "wordpress";
-  else if (/\b(cli|command|bin)\b/.test(req)) targetStack = "cli";
-
-  let intent = "implementation";
-  if (/\b(document|doc|readme)\b/.test(req)) intent = "docs";
-  else if (/\b(audit|security|inspect|dependencies)\b/.test(req)) intent = "audit";
-  else if (/\b(release|publish|deploy)\b/.test(req)) intent = "release";
-  else if (/\b(prototype|standalone html)\b/.test(req)) intent = "prototype";
-
-  return { targetStack, intent };
-}
-
-export class DeliveryDecisionEngine {
-  constructor({ cwd = process.cwd() } = {}) {
-    this.cwd = cwd;
-    this.stackDetector = new StackDetector({ cwd });
-  }
-
-  async determineClass(changedFiles = []) {
-    if (changedFiles.length === 0) {
-      return "empty";
-    }
-
-    const isDocs = changedFiles.every(file => 
-      file.endsWith(".md") || file.endsWith(".txt") || file.startsWith("docs/")
-    );
-    if (isDocs) {
-      return "docs-only";
-    }
-
-    const stacks = await this.stackDetector.detect();
-    
-    let usesJsFramework = false;
-    try {
-      const pkgPath = path.join(this.cwd, "package.json");
-      const pkgContent = await fs.readFile(pkgPath, "utf8");
-      const pkg = JSON.parse(pkgContent);
-      const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
-      
-      const frameworks = ["react", "next", "vue", "nuxt", "svelte", "solid-js", "preact", "quasar", "@angular/core"];
-      usesJsFramework = frameworks.some(fw => deps[fw] !== undefined);
-    } catch {
-      // ignore
-    }
-
-    const isWordPress = await checkWordPressDirectRoot(this.cwd);
-
-    const hasFrontendFiles = changedFiles.some(file => 
-      /\.(html?|css|scss|sass|less|jsx|tsx|vue|svelte)$/i.test(file) ||
-      (/\.js$/i.test(file) && !file.includes("config") && !file.includes("test"))
-    );
-
-    if (isWordPress) {
-      return "wordpress-php";
-    }
-
-    if (usesJsFramework && hasFrontendFiles) {
-      return "framework-native-frontend";
-    }
-
-    if (hasFrontendFiles) {
-      return "standalone-web";
-    }
-
-    if (stacks.includes("python") || stacks.includes("php") || (stacks.includes("node") && !usesJsFramework)) {
-      return "backend-service";
-    }
-
-    return "generic-code";
-  }
-
-  async detectContext() {
-    const stacks = await this.stackDetector.detect();
-    
-    let usesJsFramework = null;
-    let hasPackageJson = false;
-    let isCli = false;
-    try {
-      const pkgPath = path.join(this.cwd, "package.json");
-      const pkgContent = await fs.readFile(pkgPath, "utf8");
-      hasPackageJson = true;
-      const pkg = JSON.parse(pkgContent);
-      const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
-      if (pkg.bin || pkg.name === "@williambeto/ai-workflow") {
-        isCli = true;
-      }
-      
-      const frameworks = ["react", "next", "vue", "nuxt", "svelte", "solid-js", "preact", "quasar", "@angular/core"];
-      for (const fw of frameworks) {
-        if (deps[fw] !== undefined) {
-          usesJsFramework = fw;
-          break;
-        }
-      }
-    } catch {}
-
-    let isLaravel = false;
-    let hasComposerJson = false;
-    try {
-      const composerPath = path.join(this.cwd, "composer.json");
-      const composerContent = await fs.readFile(composerPath, "utf8");
-      hasComposerJson = true;
-      const composer = JSON.parse(composerContent);
-      const reqs = { ...(composer.require || {}), ...(composer.requireDev || {}) };
-      if (reqs["laravel/framework"]) {
-        isLaravel = true;
-      }
-    } catch {}
-
-    const isWordPress = await checkWordPressDirectRoot(this.cwd);
-
-    let isEmpty = true;
-    try {
-      const entries = await fs.readdir(this.cwd);
-      const meaningful = entries.filter(e => !e.startsWith(".") && !["node_modules", "EVIDENCE.json"].includes(e));
-      if (meaningful.length > 0) {
-        if (meaningful.length === 1 && meaningful[0] === "package.json") {
-          try {
-            const content = await fs.readFile(path.join(this.cwd, "package.json"), "utf8");
-            const pkg = JSON.parse(content);
-            if (!pkg.dependencies && !pkg.devDependencies) {
-              isEmpty = true;
-            } else {
-              isEmpty = false;
-            }
-          } catch {
-            isEmpty = true;
-          }
-        } else {
-          isEmpty = false;
-        }
-      }
-    } catch {
-      isEmpty = true;
-    }
-
-    let projectState = isEmpty ? "empty" : "active";
-    let detectedStackType = "unknown";
-    let detectedStacks = [];
-
-    if (isWordPress) {
-      detectedStackType = "WordPress context";
-      detectedStacks.push("wordpress");
-    } else if (isLaravel) {
-      detectedStackType = "backend context";
-      detectedStacks.push("laravel");
-    } else if (usesJsFramework) {
-      detectedStackType = "existing matching stack";
-      detectedStacks.push(usesJsFramework);
-    } else if (isCli) {
-      detectedStackType = "CLI package context";
-      detectedStacks.push("node");
-    } else if (stacks.includes("node")) {
-      detectedStackType = "existing matching stack";
-      detectedStacks.push("node");
-    } else if (stacks.includes("python") || stacks.includes("php")) {
-      detectedStackType = "backend context";
-      detectedStacks.push(...stacks);
-    } else if (projectState === "empty") {
-      detectedStackType = "empty project";
-    }
-
-    return {
-      projectState,
-      detectedStackType,
-      detectedStacks,
-      isWordPress,
-      isLaravel,
-      usesJsFramework,
-      isCli
-    };
-  }
-
-  async determineDecision(input = {}) {
-    const userRequest = input.userRequest || "";
-    const explicitApprovals = input.explicitApprovals || [];
-    
-    const ctx = input.projectContext || await this.detectContext();
-    const projectState = ctx.projectState || "active";
-    const detectedStacks = ctx.detectedStacks || [];
-    const isWordPress = ctx.isWordPress || false;
-    const isLaravel = ctx.isLaravel || false;
-    const isCli = ctx.isCli || false;
-    const usesJsFramework = ctx.usesJsFramework || null;
-
-    const parsed = parseRequest(userRequest);
-    const targetStack = parsed.targetStack;
-    const intent = parsed.intent;
-
-    let decision = "IMPLEMENT_IN_EXISTING_CONTEXT";
-    let allowedArtifactShape = "generic-code";
-    let forbiddenSubstitutes = ["success-without-validation"];
-    let validationRequired = ["build-or-equivalent"];
-    let approvalRequired = false;
-
-    if (intent === "audit") {
-      decision = "READ_ONLY_AUDIT";
-      allowedArtifactShape = "audit-report";
-      forbiddenSubstitutes.push("any-code-mutation");
-      validationRequired = [];
-    }
-    else if (intent === "docs") {
-      decision = "DOCS_ONLY";
-      allowedArtifactShape = "markdown";
-      forbiddenSubstitutes.push("unjustified-code-mutation");
-      validationRequired = [];
-    }
-    else if (intent === "release") {
-      decision = "RELEASE_OR_DEPLOY_REQUIRES_APPROVAL";
-      allowedArtifactShape = "package-tarball";
-      forbiddenSubstitutes.push("publish-without-approval");
-      validationRequired = ["release-readiness-or-equivalent"];
-      
-      const hasApproval = explicitApprovals.includes("npm-publish") || explicitApprovals.includes("deploy-production");
-      if (hasApproval) {
-        decision = "RELEASE_OR_DEPLOY_APPROVED";
-        approvalRequired = true;
-      }
-    }
-    else if (intent === "prototype") {
-      decision = "CREATE_STANDALONE_PROTOTYPE";
-      allowedArtifactShape = "standalone-html";
-      validationRequired = [];
-    }
-    else if (projectState === "empty") {
-      decision = "SCAFFOLD_AND_IMPLEMENT";
-      if (targetStack === "vue" || targetStack === "react") {
-        allowedArtifactShape = "runnable-framework-app";
-        forbiddenSubstitutes.push("standalone-html-as-framework-delivery", "loose-framework-files-without-runtime");
-        validationRequired.push("dependency-install-or-verification", "runtime-smoke-or-equivalent");
-      }
-    } else {
-      const hasConflict = (targetStack === "vue" && detectedStacks.includes("react")) ||
-                          (targetStack === "react" && detectedStacks.includes("vue")) ||
-                          (targetStack === "laravel" && !detectedStacks.includes("laravel") && detectedStacks.length > 0) ||
-                          (targetStack === "wordpress" && !detectedStacks.includes("wordpress") && detectedStacks.length > 0);
-      
-      if (hasConflict) {
-        decision = "BLOCK_STACK_CONFLICT";
-      } else if (targetStack === "laravel" && !detectedStacks.includes("laravel")) {
-        decision = "BLOCK_UNSUPPORTED_CONTEXT";
-      } else if (targetStack === "wordpress" && !detectedStacks.includes("wordpress")) {
-        decision = "BLOCK_UNSUPPORTED_CONTEXT";
-      } else {
-        if (targetStack === "vue" || targetStack === "react") {
-          decision = "IMPLEMENT_IN_EXISTING_CONTEXT";
-          allowedArtifactShape = "runnable-framework-app";
-          forbiddenSubstitutes.push("standalone-html-as-framework-delivery", "loose-framework-files-without-runtime");
-          validationRequired.push("dependency-install-or-verification", "runtime-smoke-or-equivalent");
-        } else if (targetStack === "cli" || isCli) {
-          decision = "CLI_COMMAND_INTEGRATION";
-          allowedArtifactShape = "bin-entry";
-        }
-      }
-    }
-
-    if (userRequest && userRequest.trim().length < 3) {
-      decision = "BLOCK_UNCLEAR_SCOPE";
-    }
-
-    return {
-      intent: intent === "implementation" ? "implementation" : intent,
-      requestedOutcome: targetStack === "vue" || targetStack === "react" ? "page" : (targetStack === "wordpress" ? "plugin-or-theme" : null),
-      requestedStack: targetStack,
-      requestedPlatform: targetStack === "wordpress" ? "wordpress" : null,
-      projectState,
-      detectedStacks,
-      decision,
-      allowedArtifactShape,
-      forbiddenSubstitutes,
-      validationRequired,
-      approvalRequired: explicitApprovals.length > 0
-    };
-  }
-}
-
-async function checkWordPressDirectRoot(cwd) {
-  // Check standard paths
-  const hasWpConfig = await fs.access(path.join(cwd, "wp-config.php")).then(() => true).catch(() => false);
-  const hasWpContent = await fs.access(path.join(cwd, "wp-content")).then(() => true).catch(() => false);
-  if (hasWpConfig || hasWpContent) {
-    return true;
-  }
-
-  // Check direct Theme root
-  const hasStyleCss = await fs.access(path.join(cwd, "style.css")).then(() => true).catch(() => false);
-  if (hasStyleCss) {
-    try {
-      const content = await fs.readFile(path.join(cwd, "style.css"), "utf8");
-      if (/\bTheme Name\s*:/i.test(content) || /\bTheme URI\s*:/i.test(content)) {
-        const otherIndicators = [
-          "functions.php",
-          "theme.json",
-          "index.php",
-          "front-page.php",
-          "single.php",
-          "page.php",
-          "archive.php",
-          "template-parts"
-        ];
-        for (const ind of otherIndicators) {
-          const exists = await fs.access(path.join(cwd, ind)).then(() => true).catch(() => false);
-          if (exists) {
-            return true;
-          }
-        }
-      }
-    } catch {
-      // ignore
-    }
-  }
-
-  // Check direct Plugin root
-  try {
-    const files = await fs.readdir(cwd);
-    for (const file of files) {
-      if (file.endsWith(".php")) {
-        const content = await fs.readFile(path.join(cwd, file), "utf8");
-        if (/\bPlugin Name\s*:/i.test(content)) {
-          return true;
-        }
-      }
-    }
-  } catch {
-    // ignore
-  }
-
-  return false;
-}

package/src/core/validation/evidence-collector.js

@@ -1,245 +0,0 @@
-import { spawnSync } from "node:child_process";
-import fs from "node:fs/promises";
-import path from "node:path";
-import { QualityGuard } from "./quality-guard.js";
-import { DeliveryDecisionEngine } from "./delivery-decision-engine.js";
-import { ArtifactFidelityGate } from "./artifact-fidelity-gate.js";
-import { VisualVerifier } from "./visual-verifier.js";
-
-const VALIDATION_KINDS = new Set(["test", "build", "typecheck", "lint", "security", "smoke", "validate", "other"]);
-
-function publicStatus(status) {
-  if (status === "PASS") return "COMPLETED";
-  if (status === "PASS_WITH_NOTES") return "COMPLETED_WITH_NOTES";
-  return "BLOCKED";
-}
-
-function inferTaskKind(task = {}) {
-  const explicit = String(task.kind || "").trim().toLowerCase();
-  if (VALIDATION_KINDS.has(explicit)) return explicit;
-
-  const value = `${task.name || ""} ${task.command || ""}`.toLowerCase();
-  if (/\b(test|tests|vitest|jest|mocha|ava|tap|pytest|phpunit|rspec|cypress|playwright)\b/.test(value)) return "test";
-  if (/\b(typecheck|tsc\b|mypy|pyright)\b/.test(value)) return "typecheck";
-  if (/\b(lint|eslint|stylelint|ruff|flake8|pylint)\b/.test(value)) return "lint";
-  if (/\b(build|bundle|compile)\b/.test(value)) return "build";
-  if (/\b(audit|security|sast|scan)\b/.test(value)) return "security";
-  if (/\b(smoke|curl|preview|serve)\b/.test(value)) return "smoke";
-  if (/\bvalidate\b/.test(value)) return "validate";
-  return "other";
-}
-
-export class EvidenceCollector {
-  constructor({ cwd, maxLogLength = 2000, timeout = 60000, taskSlug = null, mode = null, profile = "generic", branchRecovery = "NOT_RECORDED", userRequest = null, explicitApprovals = [], visualDist = null, port = 8080 } = {}) {
-    this.cwd = cwd;
-    this.maxLogLength = maxLogLength;
-    this.timeout = timeout;
-    this.taskSlug = taskSlug;
-    this.mode = mode;
-    this.profile = profile;
-    this.branchRecovery = branchRecovery;
-    this.userRequest = userRequest;
-    this.explicitApprovals = explicitApprovals;
-    this.visualDist = visualDist;
-    this.port = Number(port || 8080);
-  }
-
-  async findUserRequest() {
-    if (this.userRequest) return this.userRequest;
-
-    if (this.taskSlug) {
-      const ledgerPath = path.join(this.cwd, `.ai-workflow/history/${this.taskSlug}-ledger.json`);
-      try {
-        const content = await fs.readFile(ledgerPath, "utf8");
-        const events = JSON.parse(content);
-        const routeEvent = events.find(e => e.eventType === "routing");
-        if (routeEvent && routeEvent.data?.request) {
-          return routeEvent.data.request;
-        }
-        const startEvent = events.find(e => e.eventType === "implementation_start");
-        if (startEvent && startEvent.data?.prompt) {
-          return startEvent.data.prompt;
-        }
-      } catch {}
-    }
-
-    try {
-      const dir = path.join(this.cwd, ".ai-workflow/history");
-      const files = await fs.readdir(dir);
-      for (const file of files) {
-        if (file.endsWith("-ledger.json")) {
-          const content = await fs.readFile(path.join(dir, file), "utf8");
-          const events = JSON.parse(content);
-          const routeEvent = events.find(e => e.eventType === "routing");
-          if (routeEvent && routeEvent.data?.request) {
-            return routeEvent.data.request;
-          }
-        }
-      }
-    } catch {}
-
-    try {
-      const { execSync } = await import("node:child_process");
-      const branch = execSync("git branch --show-current", { cwd: this.cwd, encoding: "utf8" }).trim();
-      if (branch && branch !== "main" && branch !== "master" && branch.startsWith("feat/")) {
-        return branch.replace("feat/", "").replaceAll("-", " ");
-      }
-    } catch {}
-
-    return "";
-  }
-
-  runTask(task) {
-    const kind = inferTaskKind(task);
-    if (task.presetStatus) {
-      return { name: task.name, command: task.command, kind, status: task.presetStatus, exitCode: null, summary: task.summary, output: "" };
-    }
-
-    let cmd = task.command;
-    let args = [];
-    if (Array.isArray(cmd)) {
-      const [c, ...a] = cmd;
-      cmd = c;
-      args = a;
-    } else if (typeof cmd === "string") {
-      const parts = cmd.split(/\s+/);
-      cmd = parts[0];
-      args = parts.slice(1);
-    }
-
-    const isWin32 = process.platform === "win32";
-    const isUncPath = typeof this.cwd === "string" && (this.cwd.startsWith("\\\\") || this.cwd.startsWith("//"));
-    const shellOption = isWin32 && isUncPath ? "powershell.exe" : (isWin32 ? true : false);
-
-    const result = spawnSync(cmd, args, {
-      cwd: this.cwd,
-      shell: shellOption,
-      encoding: "utf8",
-      timeout: this.timeout
-    });
-
-    let status = result.status === 0 ? "PASS" : "FAIL";
-    if (result.error) {
-      status = "FAIL";
-      if (result.error.code === "ETIMEDOUT") {
-        status = "BLOCKED";
-      }
-    }
-
-    let summary = status === "PASS" ? "Command completed successfully." : "Command failed.";
-    if (result.error?.code === "ETIMEDOUT") {
-      summary = `Command timed out after ${this.timeout / 1000}s.`;
-    } else if (result.error) {
-      summary = `Command execution error: ${result.error.message}`;
-    }
-
-    const rawOutput = `${result.stdout || ""}${result.stderr || ""}`.trim();
-    const output = rawOutput.length > this.maxLogLength ? `${rawOutput.slice(0, this.maxLogLength)}\n... [TRUNCATED]` : rawOutput;
-    return { name: task.name, command: task.command, kind, status, exitCode: result.status, signal: result.signal, summary, output };
-  }
-
-  async collect(tasks, { writeArtifact = false } = {}) {
-    const qualityGuard = new QualityGuard({ cwd: this.cwd, taskSlug: this.taskSlug, mode: this.mode, evidenceWillBePersisted: writeArtifact });
-    const implementation = qualityGuard.isImplementationTask();
-    const executableBehavior = await qualityGuard.hasExecutableBehaviorChanges();
-    const results = tasks.map((task) => this.runTask(task));
-    const policyValidation = await qualityGuard.verify();
-    const behaviorTests = results.filter((result) => result.kind === "test");
-    const passingBehaviorTest = behaviorTests.some((result) => result.status === "PASS");
-
-    const userRequest = await this.findUserRequest();
-    const engine = new DeliveryDecisionEngine({ cwd: this.cwd });
-    const projectContext = await engine.detectContext();
-    const deliveryDecision = await engine.determineDecision({
-      userRequest,
-      projectContext,
-      explicitApprovals: this.explicitApprovals || []
-    });
-
-    const fidelityGate = new ArtifactFidelityGate({
-      cwd: this.cwd,
-      deliveryClass: deliveryDecision.allowedArtifactShape === "runnable-framework-app" ? "framework-native-frontend" : (deliveryDecision.allowedArtifactShape === "wordpress" ? "wordpress-php" : "generic-code"),
-      userRequest,
-      explicitApprovals: this.explicitApprovals || []
-    });
-
-    const changedFiles = policyValidation.git?.changedFiles || [];
-    const artifactFidelityCheck = await fidelityGate.verifyRequestFidelity({
-      userRequest,
-      deliveryDecision,
-      projectContext,
-      changedFiles
-    });
-
-    let overallStatus = "PASS";
-    if (implementation && executableBehavior && tasks.length === 0) overallStatus = "BLOCKED";
-    else if (results.some((result) => ["FAIL", "BLOCKED", "FAIL_QUALITY_GATE"].includes(result.status))) overallStatus = "FAIL_QUALITY_GATE";
-    else if (executableBehavior && !passingBehaviorTest) overallStatus = "BLOCKED";
-    else if (["FAIL", "BLOCKED", "FAIL_QUALITY_GATE"].includes(policyValidation.overallStatus)) overallStatus = "FAIL_QUALITY_GATE";
-    else if (results.some((result) => result.status === "PASS_WITH_NOTES") || policyValidation.overallStatus === "PASS_WITH_NOTES") overallStatus = "PASS_WITH_NOTES";
-
-    if (!artifactFidelityCheck || !artifactFidelityCheck.passed) {
-      overallStatus = "BLOCKED";
-    } else if (implementation) {
-      if (!deliveryDecision || !deliveryDecision.decision || deliveryDecision.decision.startsWith("BLOCK") || deliveryDecision.decision.includes("BLOCKED") || deliveryDecision.decision === "REQUIRE_EXPLICIT_AUTHORIZATION" || deliveryDecision.decision === "RELEASE_OR_DEPLOY_REQUIRES_APPROVAL") {
-        overallStatus = "BLOCKED";
-      } else if (results.length === 0 && executableBehavior && deliveryDecision.decision !== "DOCUMENTATION_ONLY" && deliveryDecision.decision !== "DOCS_ONLY" && deliveryDecision.decision !== "READ_ONLY_AUDIT") {
-        overallStatus = "BLOCKED";
-      }
-    }
-
-    const limitations = [];
-    if (implementation && executableBehavior && tasks.length === 0) limitations.push("No meaningful validation command was available for executable implementation work.");
-    if (executableBehavior && behaviorTests.length === 0) {
-      limitations.push("Executable behavior changed without a proportional automated behavior test. Build, lint, typecheck, smoke, screenshots, and manual review do not replace behavior tests.");
-    }
-    for (const [name, check] of Object.entries(policyValidation.checks || {})) {
-      if (check.status === "PASS_WITH_NOTES" && check.reason) limitations.push(`${name}: ${check.reason}`);
-    }
-
-    let visualEvidence = null;
-    if (this.visualDist) {
-      console.log(`\n--- Capturing Visual Evidence ---`);
-      console.log(`Serving ${this.visualDist} on port ${this.port}...`);
-      try {
-        const verifier = new VisualVerifier({ cwd: this.cwd, visualDist: this.visualDist, port: this.port });
-        const screenshots = await verifier.captureScreenshots();
-        visualEvidence = {
-          desktop: path.relative(this.cwd, screenshots[0]),
-          mobile: path.relative(this.cwd, screenshots[1])
-        };
-        console.log(`Visual evidence captured successfully:`);
-        console.log(`- Desktop: ${visualEvidence.desktop}`);
-        console.log(`- Mobile: ${visualEvidence.mobile}`);
-      } catch (err) {
-        console.error(`Error capturing visual evidence: ${err.message}`);
-        throw err;
-      }
-    }
-
-    const evidence = {
-      timestamp: new Date().toISOString(),
-      taskSlug: this.taskSlug,
-      executionMode: this.mode,
-      workflowProfile: this.profile,
-      branchRecovery: this.branchRecovery,
-      branch: policyValidation.git?.branch || "unknown",
-      changedFiles,
-      status: publicStatus(overallStatus),
-      internalStatus: overallStatus,
-      commands: results,
-      checks: policyValidation.checks,
-      limitations,
-      deliveryDecision,
-      artifactFidelityCheck,
-      visualEvidence
-    };
-
-    if (writeArtifact) {
-      await fs.writeFile(path.join(this.cwd, "EVIDENCE.json"), JSON.stringify(evidence, null, 2));
-    }
-    return evidence;
-  }
-}
-
-export { inferTaskKind };