beth-copilot 1.0.15 → 1.0.16

package/dist/tools/cli/beads.js

@@ -0,0 +1,172 @@
+/**
+ * Beads Tool
+ *
+ * Wraps the `bd` CLI for issue tracking via the beads system.
+ * Supports creating, closing, listing, and inspecting issues
+ * and their dependency trees.
+ *
+ * @see https://github.com/steveyegge/beads
+ */
+import { execFile as nodeExecFile } from 'node:child_process';
+import { ToolError } from '../types.js';
+/** Valid beads commands */
+const BEADS_COMMANDS = ['create', 'close', 'list', 'ready', 'show', 'dep-tree'];
+/** Input schema for the beads tool */
+const inputSchema = {
+    type: 'object',
+    properties: {
+        command: {
+            type: 'string',
+            enum: [...BEADS_COMMANDS],
+            description: 'Beads command to execute',
+        },
+        args: {
+            type: 'object',
+            description: 'Command-specific arguments',
+            properties: {
+                title: { type: 'string', description: 'Issue title (for create)' },
+                description: { type: 'string', description: 'Issue description (for create)' },
+                type: { type: 'string', enum: ['task', 'epic'], description: 'Issue type (for create)' },
+                priority: { type: 'number', description: 'Priority level (for create)' },
+                parent: { type: 'string', description: 'Parent issue ID (for create)' },
+                deps: { type: 'string', description: 'Comma-separated dependency IDs (for create)' },
+                label: { type: 'string', description: 'Label to apply (for create)' },
+                id: { type: 'string', description: 'Issue ID (for close, show, dep-tree)' },
+            },
+        },
+    },
+    required: ['command'],
+};
+/**
+ * Build the `bd` CLI argument array for a given command and args.
+ *
+ * @param command - The beads command to run
+ * @param args - Command-specific arguments
+ * @param toolName - Tool name for error reporting
+ * @returns Array of string arguments to pass to `bd`
+ */
+function buildArgs(command, args, toolName) {
+    switch (command) {
+        case 'create': {
+            const title = args?.title;
+            if (typeof title !== 'string' || title.trim().length === 0) {
+                throw new ToolError('title is required for create command', 'INVALID_INPUT', toolName);
+            }
+            const result = ['create', title];
+            if (typeof args?.description === 'string' && args.description.length > 0) {
+                result.push(`--description=${args.description}`);
+            }
+            if (args?.type === 'epic') {
+                result.push('--type', 'epic');
+            }
+            if (typeof args?.priority === 'number') {
+                result.push('-p', String(args.priority));
+            }
+            if (typeof args?.parent === 'string' && args.parent.length > 0) {
+                result.push('--parent', args.parent);
+            }
+            if (typeof args?.deps === 'string' && args.deps.length > 0) {
+                result.push('--deps', args.deps);
+            }
+            if (typeof args?.label === 'string' && args.label.length > 0) {
+                result.push('-l', args.label);
+            }
+            return result;
+        }
+        case 'close': {
+            const id = args?.id;
+            if (typeof id !== 'string' || id.trim().length === 0) {
+                throw new ToolError('id is required for close command', 'INVALID_INPUT', toolName);
+            }
+            return ['close', id];
+        }
+        case 'list':
+            return ['list'];
+        case 'ready':
+            return ['ready'];
+        case 'show': {
+            const id = args?.id;
+            if (typeof id !== 'string' || id.trim().length === 0) {
+                throw new ToolError('id is required for show command', 'INVALID_INPUT', toolName);
+            }
+            return ['show', id];
+        }
+        case 'dep-tree': {
+            const id = args?.id;
+            if (typeof id !== 'string' || id.trim().length === 0) {
+                throw new ToolError('id is required for dep-tree command', 'INVALID_INPUT', toolName);
+            }
+            return ['dep', 'tree', id];
+        }
+    }
+}
+/**
+ * Create a beads tool instance.
+ *
+ * Accepts an optional `execFn` for dependency injection in tests.
+ * When omitted, uses `node:child_process.execFile`.
+ *
+ * @param execFn - Optional execFile function for testing
+ * @returns A Tool implementation for beads
+ */
+export function createBeadsTool(execFn) {
+    const exec = execFn ?? nodeExecFile;
+    return {
+        name: 'beads',
+        description: 'Manage issues and work tracking via the beads (bd) CLI',
+        inputSchema,
+        async execute(input, context) {
+            // Check permission — beads runs as a CLI command
+            if (!context.permissions.allowTerminal) {
+                throw new ToolError('Terminal permission denied', 'PERMISSION_DENIED', 'beads');
+            }
+            // Validate command
+            const command = input.command;
+            if (typeof command !== 'string' || !BEADS_COMMANDS.includes(command)) {
+                throw new ToolError(`command must be one of: ${BEADS_COMMANDS.join(', ')}`, 'INVALID_INPUT', 'beads');
+            }
+            const args = (input.args ?? undefined);
+            const bdArgs = buildArgs(command, args, 'beads');
+            // Verify bd is available
+            await new Promise((resolve, reject) => {
+                exec('bd', ['--version'], { timeout: 5000 }, (error) => {
+                    if (error) {
+                        reject(new ToolError('beads (bd) CLI not found. Install from https://github.com/steveyegge/beads', 'NOT_FOUND', 'beads', { cause: error }));
+                    }
+                    else {
+                        resolve();
+                    }
+                });
+            });
+            // Execute the bd command
+            return new Promise((resolve, reject) => {
+                exec('bd', bdArgs, { cwd: context.workingDir, timeout: 30_000 }, (error, stdout, stderr) => {
+                    let output = '';
+                    if (stdout)
+                        output += stdout;
+                    if (stderr) {
+                        if (output.length > 0 && !output.endsWith('\n'))
+                            output += '\n';
+                        if (stderr.length > 0)
+                            output += stderr;
+                    }
+                    if (error) {
+                        reject(new ToolError(`bd ${command} failed: ${output || error.message}`, 'EXECUTION_FAILED', 'beads', { cause: error }));
+                        return;
+                    }
+                    resolve({
+                        success: true,
+                        output: output.trim(),
+                        metadata: {
+                            command,
+                            args: bdArgs,
+                        },
+                    });
+                });
+            });
+        },
+    };
+}
+/** Default beads tool instance using real execFile */
+export const beadsTool = createBeadsTool();
+//# sourceMappingURL=beads.js.map

package/dist/tools/cli/beads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beads.js","sourceRoot":"","sources":["../../../src/tools/cli/beads.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,2BAA2B;AAC3B,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAU,CAAC;AAMzF,sCAAsC;AACtC,MAAM,WAAW,GAAoB;IACnC,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,GAAG,cAAc,CAAC;YACzB,WAAW,EAAE,0BAA0B;SACxC;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,4BAA4B;YACzC,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;gBAClE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;gBAC9E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE;gBACxF,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;gBACxE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;gBACvE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE;gBACpF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;gBACrE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;aAC5E;SACF;KACF;IACD,QAAQ,EAAE,CAAC,SAAS,CAAC;CACtB,CAAC;AAEF;;;;;;;GAOG;AACH,SAAS,SAAS,CAChB,OAAqB,EACrB,IAAyC,EACzC,QAAgB;IAEhB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC;YAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,SAAS,CAAC,sCAAsC,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC;YACzF,CAAC;YACD,MAAM,MAAM,GAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC3C,IAAI,OAAO,IAAI,EAAE,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzE,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,IAAI,IAAI,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAChC,CAAC;YACD,IAAI,OAAO,IAAI,EAAE,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACvC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC3C,CAAC;YACD,IAAI,OAAO,IAAI,EAAE,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/D,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACvC,CAAC;YACD,IAAI,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3D,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;YACD,IAAI,OAAO,IAAI,EAAE,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7D,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC;YACpB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrD,MAAM,IAAI,SAAS,CAAC,kCAAkC,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC;YACrF,CAAC;YACD,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACvB,CAAC;QAED,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,CAAC,CAAC;QAElB,KAAK,OAAO;YACV,OAAO,CAAC,OAAO,CAAC,CAAC;QAEnB,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC;YACpB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrD,MAAM,IAAI,SAAS,CAAC,iCAAiC,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC;YACpF,CAAC;YACD,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACtB,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC;YACpB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrD,MAAM,IAAI,SAAS,CAAC,qCAAqC,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC;YACxF,CAAC;YACD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,MAAM,IAAI,GAAG,MAAM,IAAI,YAAY,CAAC;IAEpC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,wDAAwD;QACrE,WAAW;QAEX,KAAK,CAAC,OAAO,CAAC,KAA8B,EAAE,OAAoB;YAChE,iDAAiD;YACjD,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;gBACvC,MAAM,IAAI,SAAS,CAAC,4BAA4B,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;YAClF,CAAC;YAED,mBAAmB;YACnB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAC9B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAuB,CAAC,EAAE,CAAC;gBACrF,MAAM,IAAI,SAAS,CACjB,2BAA2B,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACtD,eAAe,EACf,OAAO,CACR,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,SAAS,CAAwC,CAAC;YAC9E,MAAM,MAAM,GAAG,SAAS,CAAC,OAAuB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAEjE,yBAAyB;YACzB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE;oBACrD,IAAI,KAAK,EAAE,CAAC;wBACV,MAAM,CAAC,IAAI,SAAS,CAClB,4EAA4E,EAC5E,WAAW,EACX,OAAO,EACP,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC,CAAC;oBACL,CAAC;yBAAM,CAAC;wBACN,OAAO,EAAE,CAAC;oBACZ,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,yBAAyB;YACzB,OAAO,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACjD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;oBACzF,IAAI,MAAM,GAAG,EAAE,CAAC;oBAChB,IAAI,MAAM;wBAAE,MAAM,IAAI,MAAM,CAAC;oBAC7B,IAAI,MAAM,EAAE,CAAC;wBACX,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;4BAAE,MAAM,IAAI,IAAI,CAAC;wBAChE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;4BAAE,MAAM,IAAI,MAAM,CAAC;oBAC1C,CAAC;oBAED,IAAI,KAAK,EAAE,CAAC;wBACV,MAAM,CAAC,IAAI,SAAS,CAClB,MAAM,OAAO,YAAY,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,EAClD,kBAAkB,EAClB,OAAO,EACP,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC,CAAC;wBACH,OAAO;oBACT,CAAC;oBAED,OAAO,CAAC;wBACN,OAAO,EAAE,IAAI;wBACb,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;wBACrB,QAAQ,EAAE;4BACR,OAAO;4BACP,IAAI,EAAE,MAAM;yBACb;qBACF,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,sDAAsD;AACtD,MAAM,CAAC,MAAM,SAAS,GAAS,eAAe,EAAE,CAAC"}

package/dist/tools/cli/beads.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Beads Tool Tests
+ *
+ * Tests for the beads tool implementation.
+ * Uses dependency injection (createBeadsTool) to mock execFile.
+ */
+export {};
+//# sourceMappingURL=beads.test.d.ts.map

package/dist/tools/cli/beads.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beads.test.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/beads.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/tools/cli/beads.test.js

@@ -0,0 +1,264 @@
+/**
+ * Beads Tool Tests
+ *
+ * Tests for the beads tool implementation.
+ * Uses dependency injection (createBeadsTool) to mock execFile.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { createBeadsTool } from './beads.js';
+import { ToolError } from '../types.js';
+/** Create a ToolContext with sensible defaults */
+function createContext(overrides) {
+    return {
+        workingDir: '/tmp/test',
+        permissions: overrides?.permissions ?? {
+            allowFileRead: false,
+            allowFileWrite: false,
+            allowTerminal: true,
+            allowNetwork: false,
+        },
+        signal: overrides?.signal,
+    };
+}
+/**
+ * Create a mock execFile function that records calls and returns configured output.
+ *
+ * @param responses - Map of first-arg command to { stdout, stderr, error }
+ * @returns [mockFn, calls] — the mock function and an array of recorded call args
+ */
+function createMockExec(responses) {
+    const calls = [];
+    const mockFn = (file, args, _options, callback) => {
+        calls.push({ file, args: [...args] });
+        // First call is --version check, subsequent calls are the actual command
+        const isVersionCheck = args.includes('--version');
+        const response = isVersionCheck
+            ? (responses?.version ?? { stdout: 'beads 1.0.0', stderr: '', error: null })
+            : (responses?.command ?? { stdout: 'ok', stderr: '', error: null });
+        // Use setImmediate to keep callback async like real execFile
+        setImmediate(() => {
+            callback(response.error ?? null, response.stdout ?? '', response.stderr ?? '');
+        });
+        // Return a minimal ChildProcess-like object
+        return { kill: () => { } };
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return [mockFn, calls];
+}
+describe('beads tool', () => {
+    describe('metadata', () => {
+        it('should have name "beads"', () => {
+            const [mockFn] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            assert.strictEqual(tool.name, 'beads');
+        });
+        it('should have a description', () => {
+            const [mockFn] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            assert.ok(tool.description.length > 0);
+        });
+        it('should have an inputSchema with command required', () => {
+            const [mockFn] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            assert.strictEqual(tool.inputSchema.type, 'object');
+            assert.ok(Array.isArray(tool.inputSchema.required));
+            assert.ok(tool.inputSchema.required.includes('command'));
+        });
+    });
+    describe('command building — create', () => {
+        it('should build args for create with title only', async () => {
+            const [mockFn, calls] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            await tool.execute({ command: 'create', args: { title: 'Fix bug' } }, createContext());
+            // Second call is the actual command (first is --version)
+            assert.deepStrictEqual(calls[1].args, ['create', 'Fix bug']);
+        });
+        it('should build args for create with all optional args', async () => {
+            const [mockFn, calls] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            await tool.execute({
+                command: 'create',
+                args: {
+                    title: 'Feature X',
+                    description: 'Build feature X',
+                    type: 'epic',
+                    priority: 1,
+                    parent: 'abc-123',
+                    deps: 'dep-1,dep-2',
+                    label: 'in_progress',
+                },
+            }, createContext());
+            const cmdArgs = calls[1].args;
+            assert.strictEqual(cmdArgs[0], 'create');
+            assert.strictEqual(cmdArgs[1], 'Feature X');
+            assert.ok(cmdArgs.includes('--description=Build feature X'));
+            assert.ok(cmdArgs.includes('--type'));
+            assert.ok(cmdArgs.includes('epic'));
+            assert.ok(cmdArgs.includes('-p'));
+            assert.ok(cmdArgs.includes('1'));
+            assert.ok(cmdArgs.includes('--parent'));
+            assert.ok(cmdArgs.includes('abc-123'));
+            assert.ok(cmdArgs.includes('--deps'));
+            assert.ok(cmdArgs.includes('dep-1,dep-2'));
+            assert.ok(cmdArgs.includes('-l'));
+            assert.ok(cmdArgs.includes('in_progress'));
+        });
+        it('should reject create without title', async () => {
+            const [mockFn] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            await assert.rejects(() => tool.execute({ command: 'create', args: {} }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'INVALID_INPUT');
+                assert.ok(err.message.includes('title'));
+                return true;
+            });
+        });
+    });
+    describe('command building — close', () => {
+        it('should build args for close', async () => {
+            const [mockFn, calls] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            await tool.execute({ command: 'close', args: { id: 'issue-1' } }, createContext());
+            assert.deepStrictEqual(calls[1].args, ['close', 'issue-1']);
+        });
+        it('should reject close without id', async () => {
+            const [mockFn] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            await assert.rejects(() => tool.execute({ command: 'close', args: {} }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'INVALID_INPUT');
+                assert.ok(err.message.includes('id'));
+                return true;
+            });
+        });
+    });
+    describe('command building — list', () => {
+        it('should build args for list', async () => {
+            const [mockFn, calls] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            await tool.execute({ command: 'list' }, createContext());
+            assert.deepStrictEqual(calls[1].args, ['list']);
+        });
+    });
+    describe('command building — ready', () => {
+        it('should build args for ready', async () => {
+            const [mockFn, calls] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            await tool.execute({ command: 'ready' }, createContext());
+            assert.deepStrictEqual(calls[1].args, ['ready']);
+        });
+    });
+    describe('command building — show', () => {
+        it('should build args for show', async () => {
+            const [mockFn, calls] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            await tool.execute({ command: 'show', args: { id: 'issue-2' } }, createContext());
+            assert.deepStrictEqual(calls[1].args, ['show', 'issue-2']);
+        });
+        it('should reject show without id', async () => {
+            const [mockFn] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            await assert.rejects(() => tool.execute({ command: 'show', args: {} }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'INVALID_INPUT');
+                assert.ok(err.message.includes('id'));
+                return true;
+            });
+        });
+    });
+    describe('command building — dep-tree', () => {
+        it('should build args for dep-tree', async () => {
+            const [mockFn, calls] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            await tool.execute({ command: 'dep-tree', args: { id: 'issue-3' } }, createContext());
+            assert.deepStrictEqual(calls[1].args, ['dep', 'tree', 'issue-3']);
+        });
+        it('should reject dep-tree without id', async () => {
+            const [mockFn] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            await assert.rejects(() => tool.execute({ command: 'dep-tree', args: {} }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'INVALID_INPUT');
+                assert.ok(err.message.includes('id'));
+                return true;
+            });
+        });
+    });
+    describe('permissions', () => {
+        it('should throw PERMISSION_DENIED when allowTerminal is false', async () => {
+            const [mockFn] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            const ctx = createContext({
+                permissions: {
+                    allowFileRead: false,
+                    allowFileWrite: false,
+                    allowTerminal: false,
+                    allowNetwork: false,
+                },
+            });
+            await assert.rejects(() => tool.execute({ command: 'list' }, ctx), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'PERMISSION_DENIED');
+                return true;
+            });
+        });
+    });
+    describe('bd not installed', () => {
+        it('should throw NOT_FOUND when bd --version fails', async () => {
+            const [mockFn] = createMockExec({
+                version: { error: new Error('command not found: bd'), stdout: '', stderr: '' },
+            });
+            const tool = createBeadsTool(mockFn);
+            await assert.rejects(() => tool.execute({ command: 'list' }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'NOT_FOUND');
+                assert.ok(err.message.includes('bd'));
+                return true;
+            });
+        });
+    });
+    describe('command execution failure', () => {
+        it('should throw EXECUTION_FAILED on bd errors', async () => {
+            const [mockFn] = createMockExec({
+                command: { error: new Error('bd close failed'), stdout: '', stderr: 'no such issue' },
+            });
+            const tool = createBeadsTool(mockFn);
+            await assert.rejects(() => tool.execute({ command: 'close', args: { id: 'bad-id' } }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'EXECUTION_FAILED');
+                return true;
+            });
+        });
+    });
+    describe('invalid command', () => {
+        it('should throw INVALID_INPUT for unknown command', async () => {
+            const [mockFn] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            await assert.rejects(() => tool.execute({ command: 'purge' }, createContext()), (err) => {
+                assert.ok(err instanceof ToolError);
+                assert.strictEqual(err.code, 'INVALID_INPUT');
+                return true;
+            });
+        });
+    });
+    describe('successful output', () => {
+        it('should return success with trimmed output', async () => {
+            const [mockFn] = createMockExec({
+                command: { stdout: '  issue-1: Fix bug\n', stderr: '', error: null },
+            });
+            const tool = createBeadsTool(mockFn);
+            const result = await tool.execute({ command: 'list' }, createContext());
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.output, 'issue-1: Fix bug');
+        });
+        it('should include command and args in metadata', async () => {
+            const [mockFn] = createMockExec();
+            const tool = createBeadsTool(mockFn);
+            const result = await tool.execute({ command: 'ready' }, createContext());
+            assert.strictEqual(result.metadata?.command, 'ready');
+            assert.deepStrictEqual(result.metadata?.args, ['ready']);
+        });
+    });
+});
+//# sourceMappingURL=beads.test.js.map

package/dist/tools/cli/beads.test.js.map

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

package/dist/tools/cli/editFile.d.ts

@@ -0,0 +1,17 @@
+/**
+ * EditFile Tool
+ *
+ * Replaces an exact string occurrence in a file.
+ * Uses atomic write (write to temp file, then rename) to prevent
+ * data loss on failure. Validates paths against traversal and
+ * injection attacks using the shared path validation utilities.
+ */
+import type { Tool } from '../interface.js';
+/**
+ * EditFile tool implementation.
+ *
+ * Reads a file, replaces exactly one occurrence of oldString with newString,
+ * and writes the result back atomically (write temp + rename).
+ */
+export declare const editFileTool: Tool;
+//# sourceMappingURL=editFile.d.ts.map

package/dist/tools/cli/editFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editFile.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/editFile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAwB5C;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,IA8G1B,CAAC"}

package/dist/tools/cli/editFile.js

@@ -0,0 +1,125 @@
+/**
+ * EditFile Tool
+ *
+ * Replaces an exact string occurrence in a file.
+ * Uses atomic write (write to temp file, then rename) to prevent
+ * data loss on failure. Validates paths against traversal and
+ * injection attacks using the shared path validation utilities.
+ */
+import { readFile, writeFile, rename } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { randomBytes } from 'node:crypto';
+import { validateFilePath } from './readFile.js';
+import { ToolError } from '../types.js';
+/** Input schema for the editFile tool */
+const inputSchema = {
+    type: 'object',
+    properties: {
+        filePath: {
+            type: 'string',
+            description: 'Absolute path to the file to edit',
+        },
+        oldString: {
+            type: 'string',
+            description: 'Exact string to find and replace (must match exactly once)',
+        },
+        newString: {
+            type: 'string',
+            description: 'Replacement string',
+        },
+    },
+    required: ['filePath', 'oldString', 'newString'],
+};
+/**
+ * EditFile tool implementation.
+ *
+ * Reads a file, replaces exactly one occurrence of oldString with newString,
+ * and writes the result back atomically (write temp + rename).
+ */
+export const editFileTool = {
+    name: 'editFile',
+    description: 'Replace an exact string in a file. The oldString must match exactly once.',
+    inputSchema,
+    async execute(input, context) {
+        // Check permission
+        if (!context.permissions.allowFileWrite) {
+            throw new ToolError('File write permission denied', 'PERMISSION_DENIED', 'editFile');
+        }
+        // Validate path
+        const resolvedPath = validateFilePath(input.filePath, 'editFile');
+        // Validate oldString / newString
+        const oldString = input.oldString;
+        const newString = input.newString;
+        if (typeof oldString !== 'string') {
+            throw new ToolError('oldString is required and must be a string', 'INVALID_INPUT', 'editFile');
+        }
+        if (typeof newString !== 'string') {
+            throw new ToolError('newString is required and must be a string', 'INVALID_INPUT', 'editFile');
+        }
+        if (oldString.length === 0) {
+            throw new ToolError('oldString cannot be empty', 'INVALID_INPUT', 'editFile');
+        }
+        // Read file
+        let contents;
+        try {
+            contents = await readFile(resolvedPath, 'utf-8');
+        }
+        catch (err) {
+            const nodeErr = err;
+            if (nodeErr.code === 'ENOENT') {
+                throw new ToolError(`File not found: ${resolvedPath}`, 'NOT_FOUND', 'editFile', { cause: nodeErr });
+            }
+            if (nodeErr.code === 'EACCES') {
+                throw new ToolError(`Permission denied: ${resolvedPath}`, 'PERMISSION_DENIED', 'editFile', { cause: nodeErr });
+            }
+            throw new ToolError(`Failed to read file: ${nodeErr.message}`, 'EXECUTION_FAILED', 'editFile', { cause: nodeErr });
+        }
+        // Count occurrences of oldString
+        let count = 0;
+        let searchStart = 0;
+        while (true) {
+            const idx = contents.indexOf(oldString, searchStart);
+            if (idx === -1)
+                break;
+            count++;
+            searchStart = idx + oldString.length;
+        }
+        if (count === 0) {
+            throw new ToolError('oldString not found in file. Ensure the string matches exactly, including whitespace and indentation.', 'EXECUTION_FAILED', 'editFile');
+        }
+        if (count > 1) {
+            throw new ToolError(`oldString found ${count} times — ambiguous match, include more context to match exactly once`, 'EXECUTION_FAILED', 'editFile');
+        }
+        // Replace (exactly one occurrence)
+        const updated = contents.replace(oldString, newString);
+        // Atomic write: write to temp file, then rename
+        const dir = dirname(resolvedPath);
+        const tempSuffix = randomBytes(8).toString('hex');
+        const tempPath = join(dir, `.beth-edit-${tempSuffix}.tmp`);
+        try {
+            await writeFile(tempPath, updated, 'utf-8');
+            await rename(tempPath, resolvedPath);
+        }
+        catch (err) {
+            // Best-effort cleanup of temp file on failure
+            try {
+                const { unlink } = await import('node:fs/promises');
+                await unlink(tempPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            const nodeErr = err;
+            throw new ToolError(`Failed to write file: ${nodeErr.message}`, 'EXECUTION_FAILED', 'editFile', { cause: nodeErr });
+        }
+        return {
+            success: true,
+            output: `Successfully replaced string in ${resolvedPath}`,
+            metadata: {
+                filePath: resolvedPath,
+                replacements: 1,
+            },
+        };
+    },
+};
+//# sourceMappingURL=editFile.js.map

package/dist/tools/cli/editFile.js.map

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

package/dist/tools/cli/editFile.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * EditFile Tool Tests
+ *
+ * Tests for the editFile tool implementation.
+ * Uses node:test and node:assert with real file I/O via tmpdir.
+ */
+export {};
+//# sourceMappingURL=editFile.test.d.ts.map

package/dist/tools/cli/editFile.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editFile.test.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/editFile.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}