@sudocode-ai/integration-beads 0.1.13

package/dist/jsonl-utils.js

@@ -0,0 +1,192 @@
+/**
+ * JSONL utilities for Beads plugin
+ *
+ * Provides atomic read/write operations for .beads/issues.jsonl files.
+ * Used as fallback when Beads CLI is not available.
+ */
+import { existsSync, readFileSync, writeFileSync, renameSync } from "fs";
+import * as path from "path";
+import { randomBytes } from "crypto";
+/**
+ * Read all issues from a beads JSONL file
+ *
+ * @param filePath - Path to issues.jsonl
+ * @param options - Read options
+ * @returns Array of parsed issues
+ */
+export function readBeadsJSONL(filePath, options = {}) {
+    if (!existsSync(filePath)) {
+        return [];
+    }
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        const lines = content.split("\n").filter((line) => line.trim());
+        const issues = [];
+        for (const line of lines) {
+            try {
+                const issue = JSON.parse(line);
+                issues.push(issue);
+            }
+            catch (parseError) {
+                if (!options.skipErrors) {
+                    throw parseError;
+                }
+                // Skip malformed lines when skipErrors is true
+            }
+        }
+        return issues;
+    }
+    catch (error) {
+        if (options.skipErrors) {
+            return [];
+        }
+        throw error;
+    }
+}
+/**
+ * Write issues to a beads JSONL file atomically
+ *
+ * Features:
+ * - Atomic write (temp file + rename)
+ * - Sorted by created_at to minimize git merge conflicts
+ * - Skips write if content unchanged (prevents watcher loops)
+ *
+ * @param filePath - Path to issues.jsonl
+ * @param issues - Array of issues to write
+ */
+export function writeBeadsJSONL(filePath, issues) {
+    console.log(`[beads-jsonl] writeBeadsJSONL called with ${issues.length} issue(s)`);
+    // Sort by created_at for consistent ordering (minimizes merge conflicts)
+    const sortedIssues = [...issues].sort((a, b) => {
+        const aDate = a.created_at || "";
+        const bDate = b.created_at || "";
+        if (aDate < bDate)
+            return -1;
+        if (aDate > bDate)
+            return 1;
+        // Fallback to ID comparison
+        return (a.id || "").localeCompare(b.id || "");
+    });
+    // Build content
+    const content = sortedIssues.map((issue) => JSON.stringify(issue)).join("\n");
+    // Skip write if content unchanged (prevents watcher loops)
+    if (existsSync(filePath)) {
+        const existingContent = readFileSync(filePath, "utf-8");
+        if (existingContent.trim() === content.trim()) {
+            console.log(`[beads-jsonl] Content unchanged, skipping write`);
+            return; // No changes
+        }
+        console.log(`[beads-jsonl] Content changed, proceeding with write`);
+    }
+    else {
+        console.log(`[beads-jsonl] File doesn't exist, creating new file`);
+    }
+    // Atomic write: write to temp file, then rename
+    const tempPath = `${filePath}.tmp`;
+    writeFileSync(tempPath, content + "\n", "utf-8");
+    renameSync(tempPath, filePath);
+    console.log(`[beads-jsonl] Successfully wrote to ${filePath}`);
+}
+/**
+ * Generate a beads-style ID
+ *
+ * Beads uses IDs like "beads-a1b2c3d4"
+ *
+ * @param prefix - ID prefix (default: "beads")
+ * @returns Generated ID
+ */
+export function generateBeadsId(prefix = "beads") {
+    const random = randomBytes(4).toString("hex");
+    return `${prefix}-${random}`;
+}
+/**
+ * Create a new issue in the JSONL file
+ *
+ * @param beadsDir - Path to .beads directory
+ * @param issue - Issue data to create
+ * @param idPrefix - Prefix for generated ID
+ * @returns The created issue with generated ID
+ */
+export function createIssueViaJSONL(beadsDir, issue, idPrefix = "beads") {
+    const issuesPath = path.join(beadsDir, "issues.jsonl");
+    const issues = readBeadsJSONL(issuesPath, { skipErrors: true });
+    const now = new Date().toISOString();
+    const newIssue = {
+        id: generateBeadsId(idPrefix),
+        title: issue.title || "Untitled",
+        description: issue.description || "",
+        status: issue.status || "open",
+        priority: issue.priority ?? 2,
+        created_at: issue.created_at || now,
+        updated_at: issue.updated_at || now,
+        ...issue, // Allow additional fields to pass through
+    };
+    // Ensure ID is from our generator, not passed in
+    newIssue.id = generateBeadsId(idPrefix);
+    issues.push(newIssue);
+    writeBeadsJSONL(issuesPath, issues);
+    return newIssue;
+}
+/**
+ * Update an existing issue in the JSONL file
+ *
+ * @param beadsDir - Path to .beads directory
+ * @param issueId - ID of issue to update
+ * @param updates - Fields to update
+ * @returns The updated issue
+ * @throws Error if issue not found
+ */
+export function updateIssueViaJSONL(beadsDir, issueId, updates) {
+    console.log(`[beads-jsonl] updateIssueViaJSONL called for ${issueId} with updates:`, JSON.stringify(updates));
+    const issuesPath = path.join(beadsDir, "issues.jsonl");
+    const issues = readBeadsJSONL(issuesPath, { skipErrors: true });
+    const index = issues.findIndex((i) => i.id === issueId);
+    if (index === -1) {
+        console.error(`[beads-jsonl] Issue not found: ${issueId}`);
+        throw new Error(`Beads issue not found: ${issueId}`);
+    }
+    console.log(`[beads-jsonl] Found issue at index ${index}, current status: ${issues[index].status}`);
+    // Merge updates, preserving beads-specific fields
+    const updatedIssue = {
+        ...issues[index],
+        ...updates,
+        id: issueId, // Preserve original ID
+        updated_at: new Date().toISOString(),
+    };
+    console.log(`[beads-jsonl] Merged issue, new status: ${updatedIssue.status}`);
+    issues[index] = updatedIssue;
+    writeBeadsJSONL(issuesPath, issues);
+    console.log(`[beads-jsonl] Wrote issues back to ${issuesPath}`);
+    return updatedIssue;
+}
+/**
+ * Delete an issue from the JSONL file
+ *
+ * @param beadsDir - Path to .beads directory
+ * @param issueId - ID of issue to delete
+ * @returns True if deleted, false if not found
+ */
+export function deleteIssueViaJSONL(beadsDir, issueId) {
+    const issuesPath = path.join(beadsDir, "issues.jsonl");
+    const issues = readBeadsJSONL(issuesPath, { skipErrors: true });
+    const originalLength = issues.length;
+    const filtered = issues.filter((i) => i.id !== issueId);
+    if (filtered.length === originalLength) {
+        return false; // Not found
+    }
+    writeBeadsJSONL(issuesPath, filtered);
+    return true;
+}
+/**
+ * Get a single issue by ID
+ *
+ * @param beadsDir - Path to .beads directory
+ * @param issueId - ID of issue to find
+ * @returns The issue or null if not found
+ */
+export function getIssueById(beadsDir, issueId) {
+    const issuesPath = path.join(beadsDir, "issues.jsonl");
+    const issues = readBeadsJSONL(issuesPath, { skipErrors: true });
+    return issues.find((i) => i.id === issueId) || null;
+}
+//# sourceMappingURL=jsonl-utils.js.map

package/dist/jsonl-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-utils.js","sourceRoot":"","sources":["../src/jsonl-utils.ts"],"names":[],"mappings":"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"}

package/dist/watcher.d.ts

@@ -0,0 +1,81 @@
+/**
+ * File watcher for Beads integration
+ *
+ * Watches the .beads/issues.jsonl file for changes and detects
+ * which entities were created, updated, or deleted.
+ */
+import type { ExternalChange } from "@sudocode-ai/types";
+import { type BeadsIssue } from "./jsonl-utils.js";
+/**
+ * Callback type for change notifications
+ */
+export type ChangeCallback = (changes: ExternalChange[]) => void;
+/**
+ * BeadsWatcher monitors .beads/issues.jsonl for changes
+ *
+ * Uses content hashing to detect actual changes vs just file touches.
+ * This prevents false positives from atomic writes and other file operations.
+ */
+export declare class BeadsWatcher {
+    private watcher;
+    private entityHashes;
+    private beadsDir;
+    private callback;
+    private isProcessing;
+    constructor(beadsDir: string);
+    /**
+     * Update the cached hash for a specific entity after we wrote to it.
+     * This prevents the watcher from detecting our own writes as changes.
+     */
+    updateEntityHash(entityId: string, entity: BeadsIssue): void;
+    /**
+     * Remove an entity from the hash cache (after deletion)
+     */
+    removeEntityHash(entityId: string): void;
+    /**
+     * Start watching for changes
+     *
+     * @param callback - Function to call when changes are detected
+     */
+    start(callback: ChangeCallback): void;
+    /**
+     * Stop watching for changes
+     */
+    stop(): void;
+    /**
+     * Check if watcher is active
+     */
+    isWatching(): boolean;
+    /**
+     * Capture current state (entity hashes) for comparison
+     */
+    private captureState;
+    /**
+     * Handle file change event
+     */
+    private handleFileChange;
+    /**
+     * Handle file deleted event
+     */
+    private handleFileDeleted;
+    /**
+     * Detect changes by comparing current state to cached state
+     *
+     * @returns Array of detected changes
+     */
+    private detectChanges;
+    /**
+     * Convert BeadsIssue to ExternalEntity format
+     * Note: Beads uses 'description', which maps to ExternalEntity.description
+     */
+    private issueToExternalEntity;
+    /**
+     * Get current cached hashes (for testing/debugging)
+     */
+    getEntityHashes(): Map<string, string>;
+    /**
+     * Force refresh of cached state (useful after external sync)
+     */
+    refreshState(): void;
+}
+//# sourceMappingURL=watcher.d.ts.map

package/dist/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;AAEjE;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,YAAY,CAAS;gBAEjB,QAAQ,EAAE,MAAM;IAI5B;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAM5D;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKxC;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAgCrC;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkCxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAwDrB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAItC;;OAEG;IACH,YAAY,IAAI,IAAI;CAGrB"}

package/dist/watcher.js

@@ -0,0 +1,252 @@
+/**
+ * File watcher for Beads integration
+ *
+ * Watches the .beads/issues.jsonl file for changes and detects
+ * which entities were created, updated, or deleted.
+ */
+import chokidar from "chokidar";
+import * as path from "path";
+import { computeCanonicalHash } from "./hash-utils.js";
+import { readBeadsJSONL } from "./jsonl-utils.js";
+/**
+ * BeadsWatcher monitors .beads/issues.jsonl for changes
+ *
+ * Uses content hashing to detect actual changes vs just file touches.
+ * This prevents false positives from atomic writes and other file operations.
+ */
+export class BeadsWatcher {
+    watcher = null;
+    entityHashes = new Map();
+    beadsDir;
+    callback = null;
+    isProcessing = false;
+    constructor(beadsDir) {
+        this.beadsDir = beadsDir;
+    }
+    /**
+     * Update the cached hash for a specific entity after we wrote to it.
+     * This prevents the watcher from detecting our own writes as changes.
+     */
+    updateEntityHash(entityId, entity) {
+        const hash = computeCanonicalHash(entity);
+        console.log(`[beads-watcher] Updated hash for ${entityId} after outbound write`);
+        this.entityHashes.set(entityId, hash);
+    }
+    /**
+     * Remove an entity from the hash cache (after deletion)
+     */
+    removeEntityHash(entityId) {
+        console.log(`[beads-watcher] Removed hash for ${entityId} after outbound delete`);
+        this.entityHashes.delete(entityId);
+    }
+    /**
+     * Start watching for changes
+     *
+     * @param callback - Function to call when changes are detected
+     */
+    start(callback) {
+        if (this.watcher) {
+            console.warn("[beads-watcher] Already watching");
+            return;
+        }
+        this.callback = callback;
+        const issuesPath = path.join(this.beadsDir, "issues.jsonl");
+        // Capture initial state
+        this.captureState();
+        this.watcher = chokidar.watch(issuesPath, {
+            persistent: true,
+            ignoreInitial: true,
+            awaitWriteFinish: {
+                stabilityThreshold: 100, // Wait 100ms for writes to settle
+                pollInterval: 50,
+            },
+        });
+        this.watcher.on("change", () => this.handleFileChange());
+        this.watcher.on("add", () => this.handleFileChange());
+        this.watcher.on("unlink", () => this.handleFileDeleted());
+        this.watcher.on("error", (error) => {
+            console.error("[beads-watcher] Error:", error);
+        });
+        console.log(`[beads-watcher] Started watching ${issuesPath}`);
+    }
+    /**
+     * Stop watching for changes
+     */
+    stop() {
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+            this.callback = null;
+            console.log("[beads-watcher] Stopped");
+        }
+    }
+    /**
+     * Check if watcher is active
+     */
+    isWatching() {
+        return this.watcher !== null;
+    }
+    /**
+     * Capture current state (entity hashes) for comparison
+     */
+    captureState() {
+        const issues = readBeadsJSONL(path.join(this.beadsDir, "issues.jsonl"), { skipErrors: true });
+        this.entityHashes.clear();
+        for (const issue of issues) {
+            const hash = computeCanonicalHash(issue);
+            this.entityHashes.set(issue.id, hash);
+        }
+    }
+    /**
+     * Handle file change event
+     */
+    handleFileChange() {
+        console.log("[beads-watcher] File change detected");
+        // Prevent concurrent processing
+        if (this.isProcessing) {
+            console.log("[beads-watcher] Already processing, skipping");
+            return;
+        }
+        this.isProcessing = true;
+        try {
+            const changes = this.detectChanges();
+            console.log(`[beads-watcher] Detected ${changes.length} change(s) (content-based comparison)`);
+            if (changes.length > 0) {
+                for (const change of changes) {
+                    console.log(`[beads-watcher]   - ${change.change_type}: ${change.entity_id}`);
+                }
+                if (this.callback) {
+                    console.log("[beads-watcher] Invoking callback");
+                    this.callback(changes);
+                }
+                else {
+                    console.log("[beads-watcher] No callback registered!");
+                }
+            }
+            else {
+                console.log("[beads-watcher] No actual content changes (hashes match)");
+            }
+        }
+        catch (error) {
+            console.error("[beads-watcher] Error processing changes:", error);
+        }
+        finally {
+            this.isProcessing = false;
+        }
+    }
+    /**
+     * Handle file deleted event
+     */
+    handleFileDeleted() {
+        if (this.isProcessing) {
+            return;
+        }
+        this.isProcessing = true;
+        try {
+            // All entities are deleted
+            const changes = [];
+            const now = new Date().toISOString();
+            for (const [id] of this.entityHashes) {
+                changes.push({
+                    entity_id: id,
+                    entity_type: "issue",
+                    change_type: "deleted",
+                    timestamp: now,
+                });
+            }
+            this.entityHashes.clear();
+            if (changes.length > 0 && this.callback) {
+                this.callback(changes);
+            }
+        }
+        catch (error) {
+            console.error("[beads-watcher] Error processing deletion:", error);
+        }
+        finally {
+            this.isProcessing = false;
+        }
+    }
+    /**
+     * Detect changes by comparing current state to cached state
+     *
+     * @returns Array of detected changes
+     */
+    detectChanges() {
+        const issues = readBeadsJSONL(path.join(this.beadsDir, "issues.jsonl"), { skipErrors: true });
+        const changes = [];
+        const now = new Date().toISOString();
+        const currentIds = new Set();
+        // Check for created and updated entities
+        for (const issue of issues) {
+            currentIds.add(issue.id);
+            const newHash = computeCanonicalHash(issue);
+            const cachedHash = this.entityHashes.get(issue.id);
+            if (!cachedHash) {
+                // New entity
+                changes.push({
+                    entity_id: issue.id,
+                    entity_type: "issue",
+                    change_type: "created",
+                    timestamp: issue.created_at || now,
+                    data: this.issueToExternalEntity(issue),
+                });
+                this.entityHashes.set(issue.id, newHash);
+            }
+            else if (newHash !== cachedHash) {
+                // Updated entity
+                changes.push({
+                    entity_id: issue.id,
+                    entity_type: "issue",
+                    change_type: "updated",
+                    timestamp: issue.updated_at || now,
+                    data: this.issueToExternalEntity(issue),
+                });
+                this.entityHashes.set(issue.id, newHash);
+            }
+            // If hashes match, no change
+        }
+        // Check for deleted entities
+        for (const [id] of this.entityHashes) {
+            if (!currentIds.has(id)) {
+                changes.push({
+                    entity_id: id,
+                    entity_type: "issue",
+                    change_type: "deleted",
+                    timestamp: now,
+                });
+                this.entityHashes.delete(id);
+            }
+        }
+        return changes;
+    }
+    /**
+     * Convert BeadsIssue to ExternalEntity format
+     * Note: Beads uses 'description', which maps to ExternalEntity.description
+     */
+    issueToExternalEntity(issue) {
+        return {
+            id: issue.id,
+            type: "issue",
+            title: issue.title || "",
+            description: issue.description || "", // Beads uses 'description'
+            status: issue.status,
+            priority: issue.priority,
+            created_at: issue.created_at,
+            updated_at: issue.updated_at,
+            raw: issue,
+        };
+    }
+    /**
+     * Get current cached hashes (for testing/debugging)
+     */
+    getEntityHashes() {
+        return new Map(this.entityHashes);
+    }
+    /**
+     * Force refresh of cached state (useful after external sync)
+     */
+    refreshState() {
+        this.captureState();
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@sudocode-ai/integration-beads",
+  "version": "0.1.13",
+  "description": "Beads integration plugin for sudocode",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest --run",
+    "test:cli": "RUN_CLI_TESTS=true vitest --run",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "sudocode",
+    "integration",
+    "beads",
+    "plugin"
+  ],
+  "author": "sudocode-ai",
+  "license": "MIT",
+  "dependencies": {
+    "chokidar": "^4.0.3"
+  },
+  "peerDependencies": {
+    "@sudocode-ai/types": "^0.1.13"
+  },
+  "devDependencies": {
+    "@beads/bd": "^0.29.0",
+    "@sudocode-ai/types": "^0.1.13",
+    "@types/node": "^22.10.2",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  }
+}