@brainforge/core 3.1.13 → 3.1.14

package/dist/index.d.ts

@@ -152,10 +152,7 @@ declare class StateManager {
     private statePath;
     private state;
     constructor(workingDir: string);
-    getPhaseDir(phaseId: string): string;
-    ensurePhaseDir(phaseId: string): Promise<void>;
-    writePhaseFile(phaseId: string, filename: string, content: string): Promise<void>;
-    readPhaseFile(phaseId: string, filename: string): Promise<string>;
+    updatePhaseStatus(phaseId: string, newStatus: PhaseStatus, force?: boolean): Promise<void>;
     load(): Promise<BrainforgeState>;
     save(newState?: BrainforgeState): Promise<void>;
     init(project: ProjectConfig): Promise<BrainforgeState>;
@@ -752,8 +749,8 @@ interface BugEntry {
 }
 interface CommandResult {
     command: string;
-    status: 'passed' | 'failed';
-    exitCode: number;
+    status: 'passed' | 'failed' | 'timeout';
+    exitCode: number | null;
     stdout: string;
     stderr: string;
     duration: number;
@@ -769,6 +766,7 @@ interface VerifyResult {
     commandResults?: CommandResult[];
 }
 declare class VerificationEngine {
+    private timeoutMs;
     detectAvailableCommands(cwd: string): Promise<string[]>;
     runCommands(commands: string[], cwd: string): Promise<CommandResult[]>;
     buildVerifyPrompt(phase: Phase, stack?: StackInfo, detectedCommands?: string[]): string;

package/dist/index.js

@@ -166,7 +166,25 @@ async function fileExists(p) {
 // src/state/manager.ts
 var STATE_DIR = ".brainforge";
 var STATE_FILE = "core.json";
-var PHASES_DIR = "phases";
+var VALID_TRANSITIONS = {
+  pending: ["active", "draft"],
+  draft: ["discussed", "active"],
+  discussed: ["planned", "active"],
+  active: ["discussed", "planned", "blocked", "executing"],
+  planned: ["executing", "checked", "active"],
+  checked: ["executing", "active"],
+  executing: ["executed", "failed", "blocked"],
+  executed: ["verified", "failed", "needs-manual-verification"],
+  "needs-manual-verification": ["verified", "failed"],
+  verified: ["shipped", "failed"],
+  failed: ["fixed", "active", "planned"],
+  fixed: ["verified", "executing"],
+  shipped: [],
+  // Terminal state
+  completed: [],
+  // Terminal state
+  blocked: ["active", "failed"]
+};
 var StateManager = class {
   constructor(workingDir) {
     this.workingDir = workingDir;
@@ -175,20 +193,23 @@ var StateManager = class {
   workingDir;
   statePath;
   state = null;
-  getPhaseDir(phaseId) {
-    return path3.join(this.workingDir, STATE_DIR, PHASES_DIR, phaseId);
-  }
-  async ensurePhaseDir(phaseId) {
-    const dir = this.getPhaseDir(phaseId);
-    await fs3.mkdir(dir, { recursive: true });
-  }
-  async writePhaseFile(phaseId, filename, content) {
-    await this.ensurePhaseDir(phaseId);
-    await fs3.writeFile(path3.join(this.getPhaseDir(phaseId), filename), content, "utf-8");
-  }
-  async readPhaseFile(phaseId, filename) {
-    return fs3.readFile(path3.join(this.getPhaseDir(phaseId), filename), "utf-8");
+  // ... (getPhaseDir, ensurePhaseDir, writePhaseFile, readPhaseFile unchanged)
+  async updatePhaseStatus(phaseId, newStatus, force = false) {
+    const phase = this.get().phases.find((p) => p.id === phaseId);
+    if (!phase) throw new Error(`Phase "${phaseId}" not found.`);
+    if (!force) {
+      const allowed = VALID_TRANSITIONS[phase.status] || [];
+      if (!allowed.includes(newStatus) && phase.status !== newStatus) {
+        throw new Error(`Invalid transition: cannot move phase from "${phase.status}" to "${newStatus}".`);
+      }
+    }
+    phase.status = newStatus;
+    if (newStatus === "shipped" || newStatus === "completed") {
+      phase.completedAt = (/* @__PURE__ */ new Date()).toISOString();
+    }
+    await this.save();
   }
+  // ... (rest of the methods)
   async load() {
     const raw = await fs3.readFile(this.statePath, "utf-8");
     this.state = JSON.parse(raw);
@@ -7370,6 +7391,8 @@ import { exec as exec2 } from "child_process";
 import { promisify as promisify2 } from "util";
 var execAsync2 = promisify2(exec2);
 var VerificationEngine = class {
+  timeoutMs = 5 * 60 * 1e3;
+  // 5 minutes default
   async detectAvailableCommands(cwd) {
     const commands = [];
     try {
@@ -7425,7 +7448,7 @@ var VerificationEngine = class {
     for (const command of commands) {
       const start = Date.now();
       try {
-        const { stdout, stderr } = await execAsync2(command, { cwd });
+        const { stdout, stderr } = await execAsync2(command, { cwd, timeout: this.timeoutMs });
         results.push({
           command,
           status: "passed",
@@ -7435,10 +7458,11 @@ var VerificationEngine = class {
           duration: Date.now() - start
         });
       } catch (err) {
+        const isTimeout = err.signal === "SIGTERM" || err.killed;
         results.push({
           command,
-          status: "failed",
-          exitCode: err.code || 1,
+          status: isTimeout ? "timeout" : "failed",
+          exitCode: err.code ?? null,
           stdout: err.stdout || "",
           stderr: err.stderr || err.message,
           duration: Date.now() - start
@@ -7501,7 +7525,7 @@ ${cmd}
     let status = "passed";
     if (commandResults.length === 0) {
       status = "manual-required";
-    } else if (commandResults.some((r) => r.status === "failed") || bugs.some((b) => b.severity === "critical")) {
+    } else if (commandResults.some((r) => r.status !== "passed") || bugs.some((b) => b.severity === "critical")) {
       status = "failed";
     }
     const passedCount = commandResults.filter((r) => r.status === "passed").length;
@@ -7522,11 +7546,12 @@ ${cmd}
       ""
     ];
     for (const r of commandResults) {
+      const statusIcon = r.status === "passed" ? "\u{1F7E2} PASSED" : r.status === "timeout" ? "\u23F3 TIMEOUT" : "\u{1F534} FAILED";
       lines.push(
         `### \`${r.command}\``,
         "",
-        `- **Status:** ${r.status === "passed" ? "\u{1F7E2} PASSED" : "\u{1F534} FAILED"}`,
-        `- **Exit code:** ${r.exitCode}`,
+        `- **Status:** ${statusIcon}`,
+        `- **Exit code:** ${r.exitCode ?? "N/A"}`,
         `- **Duration:** ${(r.duration / 1e3).toFixed(2)}s`,
         "",
         "#### stdout",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainforge/core",
-  "version": "3.1.13",
+  "version": "3.1.14",
   "description": "Core engine for BrainForge AI — state management, AST mapper, skills, and AI adapters",
   "type": "module",
   "license": "MIT",