@codemcp/workflows 6.8.0 → 6.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemcp/workflows",
-  "version": "6.8.0",
+  "version": "6.10.0",
   "description": "A Model Context Protocol server that acts as an intelligent conversation state manager and development guide for LLMs, featuring comprehensive long-term memory with persistent project artifacts",
   "type": "module",
   "main": "packages/cli/dist/index.js",
@@ -51,7 +51,7 @@
     "typescript": "^5.9.3",
     "vitepress": "^1.6.4",
     "vitest": "4.0.18",
-    "@codemcp/workflows-core": "6.8.0"
+    "@codemcp/workflows-core": "6.10.0"
   },
   "lint-staged": {
     "*.{ts,js,mts,cts,tsx,jsx}": [

package/packages/cli/dist/{dist-QQCAQVXJ.js → dist-WVNXA2PS.js}

@@ -4086,14 +4086,18 @@ import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { SetLevelRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import * as path4 from "path";
 import { homedir } from "os";
+import { watch } from "fs";
+import { join as join8 } from "path";
 import { execSync as execSync5 } from "child_process";
+import { readFile as readFile4, writeFile as writeFile4 } from "fs/promises";
+import { join as join7 } from "path";
 import { basename as basename4 } from "path";
 import { readFileSync, writeFileSync, existsSync as existsSync3, mkdirSync } from "fs";
-import { readFile as readFile4, writeFile as writeFile4 } from "fs/promises";
+import { readFile as readFile5, writeFile as writeFile5 } from "fs/promises";
 import { resolve as resolve3 } from "path";
 import { execSync as execSync6 } from "child_process";
 import { readFileSync as readFileSync2 } from "fs";
-import { join as join8, dirname as dirname6 } from "path";
+import { join as join10, dirname as dirname6 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import fs5 from "fs";
 import path5 from "path";
@@ -10659,6 +10663,112 @@ var BeadsTaskBackendClient = class {
     }
   }
 };
+var defaultLogger8 = createLogger("BeadsPlanSyncer");
+var BeadsPlanSyncer = class {
+  logger;
+  constructor(logger24) {
+    this.logger = logger24 ?? defaultLogger8;
+  }
+  /**
+   * Sync the given plan file with the latest beads tasks.
+   *
+   * No-ops when the plan file doesn't exist yet, when no phase IDs are
+   * resolved, or when .beads/issues.jsonl is absent. Never throws.
+   */
+  async sync(planFilePath, projectPath) {
+    try {
+      const issues = await this.readIssues(projectPath);
+      if (issues === null) {
+        return;
+      }
+      let planContent;
+      try {
+        planContent = await readFile4(planFilePath, "utf-8");
+      } catch (err) {
+        if (err.code === "ENOENT") return;
+        throw err;
+      }
+      const updated = this.updatePlanContent(planContent, issues);
+      if (updated !== planContent) {
+        await writeFile4(planFilePath, updated, "utf-8");
+        this.logger.debug("Plan file synced with beads tasks", {
+          planFilePath
+        });
+      }
+    } catch (error) {
+      this.logger.warn("BeadsPlanSyncer: sync failed", {
+        error: error instanceof Error ? error.message : String(error),
+        planFilePath,
+        projectPath
+      });
+    }
+  }
+  /**
+   * Read and parse .beads/issues.jsonl.
+   * Returns null if the file doesn't exist.
+   */
+  async readIssues(projectPath) {
+    const jsonlPath = join7(projectPath, ".beads", "issues.jsonl");
+    let raw;
+    try {
+      raw = await readFile4(jsonlPath, "utf-8");
+    } catch (err) {
+      if (err.code === "ENOENT") return null;
+      throw err;
+    }
+    const issues = [];
+    for (const line of raw.split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      try {
+        issues.push(JSON.parse(trimmed));
+      } catch {
+      }
+    }
+    return issues;
+  }
+  /**
+   * Find direct children of a given phase task ID.
+   * A child issue has a parent-child dependency pointing to phaseId.
+   */
+  getChildTasks(issues, phaseId) {
+    return issues.filter(
+      (issue) => issue.dependencies?.some(
+        (dep) => dep.depends_on_id === phaseId && dep.type === "parent-child"
+      )
+    );
+  }
+  /**
+   * Rewrite all synced task sections in the plan content.
+   */
+  updatePlanContent(content, issues) {
+    const phaseSectionRe = /(## [^\n]+\n<!-- beads-phase-id: (?!TBD)([^\s>]+) -->)([\s\S]*?)(### Tasks\n)([\s\S]*?)(?=\n## |\n### |$)/g;
+    return content.replace(
+      phaseSectionRe,
+      (_match, phaseHeaderAndId, phaseId, betweenIdAndTasks, tasksHeader, _existingBody) => {
+        const children = this.getChildTasks(issues, phaseId);
+        const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+        const header = `<!-- beads-synced: ${today} -->
+*Auto-synced \u2014 do not edit here, use \`bd\` CLI instead.*
+`;
+        let tasksBody;
+        if (children.length === 0) {
+          tasksBody = `${header}
+`;
+        } else {
+          const taskLines = children.map((task) => {
+            const checkbox = task.status === "closed" ? "[x]" : "[ ]";
+            return `- ${checkbox} \`${task.id}\` ${task.title}`;
+          }).join("\n");
+          tasksBody = `${header}
+${taskLines}
+`;
+        }
+        return `${phaseHeaderAndId}${betweenIdAndTasks}${tasksHeader}${tasksBody}`;
+      }
+    );
+  }
+};
 var BeadsPlugin = class {
   projectPath;
   beadsStateManager;
@@ -10666,6 +10776,17 @@ var BeadsPlugin = class {
   planManager;
   logger;
   loggerFactory;
+  planSyncer;
+  /**
+   * Plan file path captured from the most recent hook context.
+   * Set by afterStartDevelopment and beforePhaseTransition so the watcher
+   * always has the correct path without touching GitManager.
+   */
+  activePlanFilePath = null;
+  /** Debounce timer for the JSONL file watcher */
+  syncDebounceTimer = null;
+  /** Active fs.watch watcher (closed on process exit) */
+  jsonlWatcher = null;
   constructor(options) {
     this.projectPath = options.projectPath;
     this.loggerFactory = options.loggerFactory;
@@ -10679,6 +10800,13 @@ var BeadsPlugin = class {
       options.loggerFactory ? options.loggerFactory("BeadsTaskBackendClient") : void 0
     );
     this.planManager = new PlanManager();
+    this.planSyncer = new BeadsPlanSyncer(
+      options.loggerFactory ? options.loggerFactory("BeadsPlanSyncer") : void 0
+    );
+    process.once("exit", () => {
+      this.jsonlWatcher?.close();
+    });
+    this.startJsonlWatcher();
     this.logger.debug("BeadsPlugin initialized", {
       projectPath: this.projectPath
     });
@@ -10713,6 +10841,7 @@ var BeadsPlugin = class {
    * Replaces validateBeadsTaskCompletion() method from proceed-to-phase.ts
    */
   async handleBeforePhaseTransition(context, currentPhase, targetPhase) {
+    this.activePlanFilePath = context.planFilePath;
     this.logger.info(
       "BeadsPlugin: Validating task completion before phase transition",
       {
@@ -10755,6 +10884,7 @@ var BeadsPlugin = class {
    * Implements graceful degradation: continues app operation even if beads operations fail
    */
   async handleAfterStartDevelopment(context, args, _result) {
+    this.activePlanFilePath = context.planFilePath;
     this.logger.info("BeadsPlugin: Setting up beads integration", {
       conversationId: context.conversationId,
       workflow: args.workflow,
@@ -10990,8 +11120,8 @@ Complete tasks: \`bd close <id>\``;
    */
   async extractPhaseTaskIdFromPlanFile(planFilePath, phase) {
     try {
-      const { readFile: readFile5 } = await import("fs/promises");
-      const content = await readFile5(planFilePath, "utf-8");
+      const { readFile: readFile6 } = await import("fs/promises");
+      const content = await readFile6(planFilePath, "utf-8");
       const phaseName = this.capitalizePhase(phase);
       const phaseHeader = `## ${phaseName}`;
       const lines = content.split("\n");
@@ -11145,6 +11275,40 @@ Complete tasks: \`bd close <id>\``;
       );
     }
   }
+  /**
+   * Start watching the .beads/ directory for changes to issues.jsonl.
+   * Watching the directory (not the file) means the watcher works even when
+   * issues.jsonl doesn't exist yet. On change, debounces 300ms then syncs.
+   */
+  startJsonlWatcher() {
+    const beadsDir = join8(this.projectPath, ".beads");
+    try {
+      this.jsonlWatcher = watch(beadsDir, (_event, filename) => {
+        if (filename !== "issues.jsonl") return;
+        if (this.syncDebounceTimer) {
+          clearTimeout(this.syncDebounceTimer);
+        }
+        this.syncDebounceTimer = setTimeout(() => {
+          this.syncDebounceTimer = null;
+          if (!this.activePlanFilePath) return;
+          this.planSyncer.sync(this.activePlanFilePath, this.projectPath).catch((err) => {
+            this.logger.warn(
+              "BeadsPlugin: Error during watcher-triggered plan sync",
+              {
+                error: err instanceof Error ? err.message : String(err)
+              }
+            );
+          });
+        }, 300);
+      });
+      this.logger.info("BeadsPlugin: Started JSONL file watcher", { beadsDir });
+    } catch (error) {
+      this.logger.warn("BeadsPlugin: Could not start JSONL file watcher", {
+        error: error instanceof Error ? error.message : String(error),
+        beadsDir
+      });
+    }
+  }
   /**
    * Extract Goal section content from plan file
    * Returns the goal content if it exists and is meaningful, otherwise undefined
@@ -11186,10 +11350,10 @@ Complete tasks: \`bd close <id>\``;
    */
   async updatePlanFileWithPhaseTaskIds(planFilePath, phaseTasks) {
     try {
-      const { readFile: readFile5, writeFile: writeFile5 } = await import("fs/promises");
+      const { readFile: readFile6, writeFile: writeFile6 } = await import("fs/promises");
       let content;
       try {
-        content = await readFile5(planFilePath, "utf-8");
+        content = await readFile6(planFilePath, "utf-8");
       } catch (error) {
         const errorMsg = error instanceof Error ? error.message : String(error);
         this.logger.warn("BeadsPlugin: Failed to read plan file for update", {
@@ -11222,7 +11386,7 @@ Complete tasks: \`bd close <id>\``;
         );
       }
       try {
-        await writeFile5(planFilePath, content, "utf-8");
+        await writeFile6(planFilePath, content, "utf-8");
       } catch (error) {
         const errorMsg = error instanceof Error ? error.message : String(error);
         this.logger.warn("BeadsPlugin: Failed to write updated plan file", {
@@ -12601,7 +12765,7 @@ var StartDevelopmentHandler = class extends BaseToolHandler {
     };
     if (context.pluginRegistry) {
       try {
-        const originalContent = await readFile4(
+        const originalContent = await readFile5(
           conversationContext.planFilePath,
           "utf-8"
         );
@@ -12612,7 +12776,7 @@ var StartDevelopmentHandler = class extends BaseToolHandler {
           originalContent
         );
         if (modifiedContent && modifiedContent !== originalContent) {
-          await writeFile4(
+          await writeFile5(
             conversationContext.planFilePath,
             modifiedContent,
             "utf-8"
@@ -13210,8 +13374,8 @@ function getVersionFromPackageJson() {
   try {
     const currentDir = dirname6(fileURLToPath4(import.meta.url));
     const packageJsonPaths = [
-      join8(currentDir, "..", "package.json"),
-      join8(currentDir, "..", "..", "..", "package.json")
+      join10(currentDir, "..", "package.json"),
+      join10(currentDir, "..", "..", "..", "package.json")
     ];
     for (const packageJsonPath of packageJsonPaths) {
       try {
@@ -13661,11 +13825,11 @@ function createToolRegistry() {
   });
   return registry;
 }
-var defaultLogger8 = createLogger("DevelopmentPlanResourceHandler");
+var defaultLogger9 = createLogger("DevelopmentPlanResourceHandler");
 var DevelopmentPlanResourceHandler = class {
   logger;
   constructor(logger24) {
-    this.logger = logger24 ?? defaultLogger8;
+    this.logger = logger24 ?? defaultLogger9;
   }
   async handle(uri, context) {
     if (context.loggerFactory) {
@@ -13687,11 +13851,11 @@ var DevelopmentPlanResourceHandler = class {
     }, "Failed to retrieve development plan resource");
   }
 };
-var defaultLogger9 = createLogger("ConversationStateResourceHandler");
+var defaultLogger10 = createLogger("ConversationStateResourceHandler");
 var ConversationStateResourceHandler = class {
   logger;
   constructor(logger24) {
-    this.logger = logger24 ?? defaultLogger9;
+    this.logger = logger24 ?? defaultLogger10;
   }
   async handle(uri, context) {
     if (context.loggerFactory) {
@@ -13719,11 +13883,11 @@ var ConversationStateResourceHandler = class {
     }, "Failed to retrieve conversation state resource");
   }
 };
-var defaultLogger10 = createLogger("WorkflowResourceHandler");
+var defaultLogger11 = createLogger("WorkflowResourceHandler");
 var WorkflowResourceHandler = class {
   logger;
   constructor(logger24) {
-    this.logger = logger24 ?? defaultLogger10;
+    this.logger = logger24 ?? defaultLogger11;
   }
   async handle(uri, context) {
     if (context.loggerFactory) {
@@ -13809,11 +13973,11 @@ var WorkflowResourceHandler = class {
     }, `Failed to load workflow resource: ${uri.href}`);
   }
 };
-var defaultLogger11 = createLogger("SystemPromptResourceHandler");
+var defaultLogger12 = createLogger("SystemPromptResourceHandler");
 var SystemPromptResourceHandler = class {
   logger;
   constructor(logger24) {
-    this.logger = logger24 ?? defaultLogger11;
+    this.logger = logger24 ?? defaultLogger12;
   }
   async handle(uri, context) {
     if (context.loggerFactory) {

package/packages/cli/dist/index.js

@@ -10,7 +10,7 @@ var args = process.argv.slice(2);
 if (args.length === 0) {
   const isLocal = existsSync(join(__dirname, "../../mcp-server/dist/index.js"));
   if (isLocal) {
-    const { startMcpServer } = await import("./dist-QQCAQVXJ.js");
+    const { startMcpServer } = await import("./dist-WVNXA2PS.js");
     await startMcpServer();
   } else {
     const mcpServerModule = "@codemcp/workflows-server";

package/packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemcp/workflows-cli",
-  "version": "6.8.0",
+  "version": "6.10.0",
   "description": "CLI tools for responsible-vibe development workflows",
   "type": "module",
   "scripts": {

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemcp/workflows-core",
-  "version": "6.8.0",
+  "version": "6.10.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",

package/packages/docs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemcp/workflows-docs",
-  "version": "6.8.0",
+  "version": "6.10.0",
   "description": "Documentation site for Responsible Vibe MCP",
   "type": "module",
   "scripts": {

package/packages/mcp-server/dist/index.d.ts

@@ -956,6 +956,17 @@ declare class BeadsPlugin implements IPlugin {
     private planManager;
     private logger;
     private loggerFactory?;
+    private planSyncer;
+    /**
+     * Plan file path captured from the most recent hook context.
+     * Set by afterStartDevelopment and beforePhaseTransition so the watcher
+     * always has the correct path without touching GitManager.
+     */
+    private activePlanFilePath;
+    /** Debounce timer for the JSONL file watcher */
+    private syncDebounceTimer;
+    /** Active fs.watch watcher (closed on process exit) */
+    private jsonlWatcher;
     constructor(options: {
         projectPath: string;
         loggerFactory?: LoggerFactory;
@@ -1009,6 +1020,12 @@ declare class BeadsPlugin implements IPlugin {
      * Implements graceful error handling: logs errors but continues on non-validation failures
      */
     private validateBeadsTaskCompletion;
+    /**
+     * Start watching the .beads/ directory for changes to issues.jsonl.
+     * Watching the directory (not the file) means the watcher works even when
+     * issues.jsonl doesn't exist yet. On change, debounces 300ms then syncs.
+     */
+    private startJsonlWatcher;
     /**
      * Extract Goal section content from plan file
      * Returns the goal content if it exists and is meaningful, otherwise undefined