@codemcp/workflows 6.7.0 → 6.9.0

package/packages/mcp-server/dist/index.js

@@ -6505,6 +6505,10 @@ var PluginRegistry = class {
   }
 };
 
+// src/plugin-system/beads-plugin.ts
+import { watch } from "fs";
+import { join as join8 } from "path";
+
 // src/components/beads/beads-task-backend-client.ts
 import { execSync as execSync5 } from "child_process";
 var defaultLogger7 = createLogger("BeadsTaskBackendClient");
@@ -6665,6 +6669,116 @@ var BeadsTaskBackendClient = class {
   }
 };
 
+// src/components/beads/beads-plan-syncer.ts
+import { readFile as readFile4, writeFile as writeFile4 } from "fs/promises";
+import { join as join7 } from "path";
+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}`;
+      }
+    );
+  }
+};
+
 // src/plugin-system/beads-plugin.ts
 var BeadsPlugin = class {
   projectPath;
@@ -6673,6 +6787,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;
@@ -6686,6 +6811,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
     });
@@ -6720,6 +6852,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",
       {
@@ -6762,6 +6895,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,
@@ -6997,8 +7131,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");
@@ -7152,6 +7286,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
@@ -7193,10 +7361,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", {
@@ -7229,7 +7397,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", {
@@ -8506,7 +8674,7 @@ Summarize findings and ask user if ready to proceed.`;
 // src/tool-handlers/start-development.ts
 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";
 var StartDevelopmentHandler = class extends BaseToolHandler {
   projectDocsManager = null;
@@ -8626,7 +8794,7 @@ var StartDevelopmentHandler = class extends BaseToolHandler {
     };
     if (context.pluginRegistry) {
       try {
-        const originalContent = await readFile4(
+        const originalContent = await readFile5(
           conversationContext.planFilePath,
           "utf-8"
         );
@@ -8637,7 +8805,7 @@ var StartDevelopmentHandler = class extends BaseToolHandler {
           originalContent
         );
         if (modifiedContent && modifiedContent !== originalContent) {
-          await writeFile4(
+          await writeFile5(
             conversationContext.planFilePath,
             modifiedContent,
             "utf-8"
@@ -9243,7 +9411,7 @@ import { z as z3 } from "zod";
 // src/version-info.ts
 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";
 var logger17 = createLogger("VersionInfo");
 var BUILD_TIME_VERSION = null;
@@ -9251,8 +9419,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 {
@@ -9713,11 +9881,11 @@ function createToolRegistry() {
 }
 
 // src/resource-handlers/development-plan.ts
-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) {
@@ -9741,11 +9909,11 @@ var DevelopmentPlanResourceHandler = class {
 };
 
 // src/resource-handlers/conversation-state.ts
-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) {
@@ -9778,11 +9946,11 @@ var ConversationStateResourceHandler = class {
 import fs5 from "fs";
 import path5 from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
-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) {
@@ -9870,11 +10038,11 @@ var WorkflowResourceHandler = class {
 };
 
 // src/resource-handlers/system-prompt.ts
-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/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemcp/workflows-server",
-  "version": "6.7.0",
+  "version": "6.9.0",
   "description": "MCP server for responsible-vibe development workflows - provides structured workflow guidance",
   "type": "module",
   "main": "dist/index.js",