@brainfile/cli 0.17.0 → 0.17.1

package/dist/commands/mcp.js

@@ -39,7 +39,6 @@ const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const zod_1 = require("zod");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const child_process_1 = require("child_process");
 const core_1 = require("@brainfile/core");
 const errorHandler_1 = require("../utils/errorHandler");
 const contractSpec_1 = require("../utils/contractSpec");
@@ -49,9 +48,9 @@ const github_auth_1 = require("../utils/github-auth");
 const linear_auth_1 = require("../utils/linear-auth");
 const core_2 = require("@brainfile/core");
 const contractRunner_1 = require("../lib/contractRunner");
+const contract_1 = require("../mcp/tools/contract");
 const archive_1 = require("../utils/archive");
 const core_3 = require("@brainfile/core");
-const dist_1 = require("../../../core/dist");
 const v2_detect_1 = require("../utils/v2-detect");
 function sanitizeTypesConfig(raw) {
     if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
@@ -131,80 +130,6 @@ function findGitRoot(startDir) {
     }
     return null;
 }
-const LEDGER_CONTRACT_STATUSES = [
-    'ready',
-    'in_progress',
-    'delivered',
-    'done',
-    'failed',
-    'blocked',
-];
-function resolveLedgerLogsDir(filePath) {
-    if ((0, v2_detect_1.isV2)(filePath)) {
-        return (0, v2_detect_1.getV2Dirs)(filePath).logsDir;
-    }
-    const absolutePath = path.resolve(filePath);
-    const parentDir = path.dirname(absolutePath);
-    const stateDir = path.basename(parentDir) === '.brainfile'
-        ? parentDir
-        : path.join(parentDir, '.brainfile');
-    return path.join(stateDir, 'logs');
-}
-function normalizePositiveInt(value, fallback) {
-    if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
-        return fallback;
-    }
-    return Math.floor(value);
-}
-function normalizeNonNegativeInt(value, fallback) {
-    if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {
-        return fallback;
-    }
-    return Math.floor(value);
-}
-function toIsoDaysAgo(days) {
-    const now = Date.now();
-    const msPerDay = 24 * 60 * 60 * 1000;
-    return new Date(now - (days * msPerDay)).toISOString();
-}
-function inferFilesChangedFromGit(filePath) {
-    const repoRoot = findGitRoot(path.dirname(path.resolve(filePath)));
-    if (!repoRoot) {
-        return [];
-    }
-    const inferred = new Set();
-    const commands = ['git diff --name-only -- .', 'git diff --name-only --cached -- .'];
-    for (const command of commands) {
-        try {
-            const stdout = (0, child_process_1.execSync)(command, {
-                cwd: repoRoot,
-                encoding: 'utf-8',
-                stdio: ['ignore', 'pipe', 'ignore'],
-            });
-            for (const line of stdout.split('\n')) {
-                const trimmed = line.trim();
-                if (trimmed) {
-                    inferred.add(trimmed.replace(/\\/g, '/'));
-                }
-            }
-        }
-        catch {
-            // Ignore git inference errors and fall back to core defaults.
-        }
-    }
-    return Array.from(inferred);
-}
-function median(values) {
-    if (values.length === 0) {
-        return 0;
-    }
-    const sorted = [...values].sort((a, b) => a - b);
-    const mid = Math.floor(sorted.length / 2);
-    const rawMedian = sorted.length % 2 === 0
-        ? (sorted[mid - 1] + sorted[mid]) / 2
-        : sorted[mid];
-    return Number(rawMedian.toFixed(3));
-}
 async function mcpCommand(options) {
     // Auto-discover brainfile if not specified
     let defaultFile = options.file;
@@ -392,72 +317,107 @@ async function mcpCommand(options) {
             content: [{ type: 'text', text: JSON.stringify(output, null, 2) }]
         };
     });
-    // Search tasks tool
-    server.registerTool('search_tasks', {
-        title: 'Search Tasks',
-        description: 'Search tasks by title, description, or other fields',
+    // Search tool (tasks + logs)
+    server.registerTool('search', {
+        title: 'Search',
+        description: 'Search tasks and logs by query, list recent logs, or view one task/log entry',
         inputSchema: {
             file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            query: zod_1.z.string().describe('Search query (matches title, description, tags)'),
+            query: zod_1.z.string().optional().describe('Search query (matches title, description, tags, and log text in v2)'),
             column: zod_1.z.string().optional().describe('Filter by column ID or name'),
             priority: zod_1.z.enum(['low', 'medium', 'high', 'critical']).optional().describe('Filter by priority'),
-            assignee: zod_1.z.string().optional().describe('Filter by assignee')
+            assignee: zod_1.z.string().optional().describe('Filter by assignee'),
+            recent: zod_1.z.boolean().optional().describe('List recently completed tasks (v2 only)'),
+            task: zod_1.z.string().optional().describe('View a specific task/log entry (v2 only)'),
         }
-    }, async ({ file, query, column, priority, assignee }) => {
+    }, async ({ file, query, column, priority, assignee, recent, task }) => {
         const filePath = file || defaultFile;
+        if (task) {
+            if (!(0, v2_detect_1.isV2)(filePath)) {
+                return { content: [{ type: 'text', text: 'Error: task lookup in search requires v2 per-task file architecture.' }], isError: true };
+            }
+            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
+            const found = (0, v2_detect_1.findV2Task)(dirs, task, true);
+            if (!found) {
+                return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+            }
+            const output = {
+                id: found.doc.task.id,
+                title: found.doc.task.title,
+                completedAt: found.doc.task.completedAt,
+                isLog: found.isLog,
+                description: (0, v2_detect_1.extractDescription)(found.doc.body),
+                log: (0, v2_detect_1.extractLog)(found.doc.body),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
+        }
+        if (recent) {
+            if (!(0, v2_detect_1.isV2)(filePath)) {
+                return { content: [{ type: 'text', text: 'Error: recent log listing requires v2 per-task file architecture.' }], isError: true };
+            }
+            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
+            const logDocs = (0, core_3.readTasksDir)(dirs.logsDir);
+            logDocs.sort((a, b) => (b.task.completedAt || '').localeCompare(a.task.completedAt || ''));
+            const logs = logDocs.slice(0, 20).map(doc => ({
+                id: doc.task.id,
+                title: doc.task.title,
+                completedAt: doc.task.completedAt,
+            }));
+            return { content: [{ type: 'text', text: JSON.stringify({ logs, count: logs.length }, null, 2) }] };
+        }
+        if (!query) {
+            return { content: [{ type: 'text', text: 'Error: query is required unless recent or task is provided' }], isError: true };
+        }
+        const queryLower = query.toLowerCase();
         // V2: search per-task files
         if ((0, v2_detect_1.isV2)(filePath)) {
             const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const queryLower = query.toLowerCase();
-            let matches = [];
-            const taskDocs = (0, core_3.readTasksDir)(dirs.boardDir);
-            for (const doc of taskDocs) {
-                const task = doc.task;
-                if (column && task.column !== column)
-                    continue;
-                if (priority && task.priority !== priority)
-                    continue;
-                if (assignee && task.assignee !== assignee)
-                    continue;
+            const matches = [];
+            const scoreDoc = (doc, includeLogText) => {
+                const t = doc.task;
                 let score = 0;
-                if (task.title.toLowerCase().includes(queryLower)) {
+                if (t.title.toLowerCase().includes(queryLower)) {
                     score += 10;
-                    if (task.title.toLowerCase().startsWith(queryLower))
+                    if (t.title.toLowerCase().startsWith(queryLower))
                         score += 5;
                 }
-                if (task.description?.toLowerCase().includes(queryLower))
+                if (t.description?.toLowerCase().includes(queryLower))
+                    score += 5;
+                if ((0, v2_detect_1.extractDescription)(doc.body)?.toLowerCase().includes(queryLower))
                     score += 5;
-                if (task.tags?.some(t => t.toLowerCase().includes(queryLower)))
+                if (t.tags?.some(tag => tag.toLowerCase().includes(queryLower)))
                     score += 3;
-                if (task.id.toLowerCase() === queryLower)
+                if (includeLogText && (0, v2_detect_1.extractLog)(doc.body)?.toLowerCase().includes(queryLower))
+                    score += 2;
+                if (t.id.toLowerCase() === queryLower)
                     score += 20;
+                return score;
+            };
+            const taskDocs = (0, core_3.readTasksDir)(dirs.boardDir);
+            for (const doc of taskDocs) {
+                const t = doc.task;
+                if (column && t.column !== column)
+                    continue;
+                if (priority && t.priority !== priority)
+                    continue;
+                if (assignee && t.assignee !== assignee)
+                    continue;
+                const score = scoreDoc(doc, false);
                 if (score > 0) {
-                    matches.push({ id: task.id, title: task.title, column: task.column, priority: task.priority, tags: task.tags, assignee: task.assignee, score });
+                    matches.push({ id: t.id, title: t.title, column: t.column, priority: t.priority, tags: t.tags, assignee: t.assignee, score });
                 }
             }
-            // Also search logs
             if (!column) {
                 const logDocs = (0, core_3.readTasksDir)(dirs.logsDir);
                 for (const doc of logDocs) {
-                    const task = doc.task;
-                    if (priority && task.priority !== priority)
+                    const t = doc.task;
+                    if (priority && t.priority !== priority)
                         continue;
-                    if (assignee && task.assignee !== assignee)
+                    if (assignee && t.assignee !== assignee)
                         continue;
-                    let score = 0;
-                    if (task.title.toLowerCase().includes(queryLower)) {
-                        score += 10;
-                        if (task.title.toLowerCase().startsWith(queryLower))
-                            score += 5;
-                    }
-                    if (task.description?.toLowerCase().includes(queryLower))
-                        score += 5;
-                    if (task.tags?.some(t => t.toLowerCase().includes(queryLower)))
-                        score += 3;
-                    if (task.id.toLowerCase() === queryLower)
-                        score += 20;
+                    const score = scoreDoc(doc, true);
                     if (score > 0) {
-                        matches.push({ id: task.id, title: task.title, column: 'Completed', priority: task.priority, tags: task.tags, assignee: task.assignee, score, isLog: true });
+                        matches.push({ id: t.id, title: t.title, column: 'Completed', priority: t.priority, tags: t.tags, assignee: t.assignee, score, isLog: true });
                     }
                 }
             }
@@ -470,8 +430,7 @@ async function mcpCommand(options) {
             return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
         }
         const { board } = result;
-        const queryLower = query.toLowerCase();
-        let matches = [];
+        const matches = [];
         for (const col of board.columns) {
             if (column) {
                 const matchesId = col.id === column;
@@ -479,34 +438,33 @@ async function mcpCommand(options) {
                 if (!matchesId && !matchesName)
                     continue;
             }
-            for (const task of col.tasks) {
-                if (priority && task.priority !== priority)
+            for (const t of col.tasks) {
+                if (priority && t.priority !== priority)
                     continue;
-                if (assignee && task.assignee !== assignee)
+                if (assignee && t.assignee !== assignee)
                     continue;
                 let score = 0;
-                if (task.title.toLowerCase().includes(queryLower)) {
+                if (t.title.toLowerCase().includes(queryLower)) {
                     score += 10;
-                    if (task.title.toLowerCase().startsWith(queryLower))
+                    if (t.title.toLowerCase().startsWith(queryLower))
                         score += 5;
                 }
-                if (task.description?.toLowerCase().includes(queryLower))
+                if (t.description?.toLowerCase().includes(queryLower))
                     score += 5;
-                if (task.tags?.some(t => t.toLowerCase().includes(queryLower)))
+                if (t.tags?.some(tag => tag.toLowerCase().includes(queryLower)))
                     score += 3;
-                if (task.id.toLowerCase() === queryLower)
+                if (t.id.toLowerCase() === queryLower)
                     score += 20;
                 if (score > 0) {
-                    matches.push({ id: task.id, title: task.title, column: col.title, priority: task.priority, tags: task.tags, assignee: task.assignee, score });
+                    matches.push({ id: t.id, title: t.title, column: col.title, priority: t.priority, tags: t.tags, assignee: t.assignee, score });
                 }
             }
         }
         matches.sort((a, b) => b.score - a.score);
-        const output = { results: matches, count: matches.length };
-        return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
+        return { content: [{ type: 'text', text: JSON.stringify({ results: matches, count: matches.length }, null, 2) }] };
     });
     // Add task tool
-    server.registerTool('add_task', {
+    server.registerTool('task_add', {
         title: 'Add Task',
         description: 'Add a new task to a column in the brainfile',
         inputSchema: {
@@ -522,7 +480,8 @@ async function mcpCommand(options) {
             relatedFiles: zod_1.z.array(zod_1.z.string()).optional().describe('Related file paths'),
             type: zod_1.z.string().optional().describe('Document type (e.g., epic, adr). Determines ID prefix. Default: task'),
             // Contract creation (optional)
-            with_contract: zod_1.z.boolean().optional().describe('Attach a contract to the new task (status=ready)'),
+            with_contract: zod_1.z.boolean().optional().describe('Attach a contract to the new task (default status=draft; use ready:true to make immediately dispatchable)'),
+            ready: zod_1.z.boolean().optional().describe('When true, contract status is set to ready instead of draft'),
             deliverables: zod_1.z.array(zod_1.z.string()).optional().describe('Contract deliverables: type:path:description'),
             validation_commands: zod_1.z.array(zod_1.z.string()).optional().describe('Contract validation commands'),
             constraints: zod_1.z.array(zod_1.z.string()).optional().describe('Contract constraints'),
@@ -530,7 +489,7 @@ async function mcpCommand(options) {
             withContract: zod_1.z.boolean().optional().describe('Alias of with_contract'),
             validationCommands: zod_1.z.array(zod_1.z.string()).optional().describe('Alias of validation_commands'),
         }
-    }, async ({ file, column, title, description, priority, tags, assignee, dueDate, subtasks, relatedFiles, type: docType, with_contract, deliverables, validation_commands, constraints, withContract, validationCommands, }) => {
+    }, async ({ file, column, title, description, priority, tags, assignee, dueDate, subtasks, relatedFiles, type: docType, with_contract, ready: contractReady, deliverables, validation_commands, constraints, withContract, validationCommands, }) => {
         const filePath = file || defaultFile;
         // V2: add task as individual file
         if ((0, v2_detect_1.isV2)(filePath)) {
@@ -570,7 +529,7 @@ async function mcpCommand(options) {
                     ...(builtSubtasks && { subtasks: builtSubtasks }),
                     createdAt: new Date().toISOString(),
                 };
-                // Optionally attach contract
+                // Optionally attach contract (default status=draft; ready:true → status=ready)
                 const wantsContract = Boolean(with_contract ?? withContract) ||
                     Boolean(deliverables && deliverables.length > 0) ||
                     Boolean(validation_commands && validation_commands.length > 0) ||
@@ -581,6 +540,7 @@ async function mcpCommand(options) {
                         deliverableSpecs: deliverables,
                         validationCommands: validation_commands ?? validationCommands,
                         constraints,
+                        status: contractReady ? 'ready' : 'draft',
                     });
                     task.contract = contract;
                 }
@@ -636,6 +596,7 @@ async function mcpCommand(options) {
                     deliverableSpecs: deliverables,
                     validationCommands: validation_commands ?? validationCommands,
                     constraints,
+                    status: contractReady ? 'ready' : 'draft',
                 });
                 const contractResult = (0, core_1.setTaskContract)(nextBoard, newTask.id, contract);
                 if (!contractResult.success || !contractResult.board) {
@@ -652,93 +613,27 @@ async function mcpCommand(options) {
             content: [{ type: 'text', text: `Task added successfully: ${newTask.id} - ${newTask.title}` }]
         };
     });
-    // Attach contract tool
-    server.registerTool('attach_contract', {
-        title: 'Attach Contract',
-        description: 'Attach a new contract to an existing task (status=ready)',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().optional().describe('Task ID to attach contract to'),
-            task_id: zod_1.z.string().optional().describe('Alias of task'),
-            deliverables: zod_1.z.array(zod_1.z.string()).optional().describe('Contract deliverables: type:path:description'),
-            validation_commands: zod_1.z.array(zod_1.z.string()).optional().describe('Contract validation commands'),
-            constraints: zod_1.z.array(zod_1.z.string()).optional().describe('Contract constraints'),
-            validationCommands: zod_1.z.array(zod_1.z.string()).optional().describe('Alias of validation_commands'),
-        }
-    }, async ({ file, task, task_id, deliverables, validation_commands, constraints, validationCommands }) => {
-        const filePath = file || defaultFile;
-        const resolvedTaskId = task || task_id;
-        if (!resolvedTaskId) {
-            return { content: [{ type: 'text', text: 'Error: task is required' }], isError: true };
-        }
-        // V2: update task file directly
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const found = (0, v2_detect_1.findV2Task)(dirs, resolvedTaskId);
-            if (!found) {
-                return { content: [{ type: 'text', text: `Error: Task not found: ${resolvedTaskId}` }], isError: true };
-            }
-            try {
-                const contract = (0, contractSpec_1.buildContract)({
-                    deliverableSpecs: deliverables,
-                    validationCommands: validation_commands ?? validationCommands,
-                    constraints,
-                });
-                found.doc.task.contract = contract;
-                found.doc.task.updatedAt = new Date().toISOString();
-                (0, core_3.writeTaskFile)(found.filePath, found.doc.task, found.doc.body);
-                return { content: [{ type: 'text', text: `Contract attached: ${resolvedTaskId}` }] };
-            }
-            catch (e) {
-                return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
-            }
-        }
-        // V1: use board
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        let { board } = result;
-        const taskInfo = (0, core_1.findTaskById)(board, resolvedTaskId);
-        if (!taskInfo) {
-            return { content: [{ type: 'text', text: `Error: Task not found: ${resolvedTaskId}` }], isError: true };
-        }
-        try {
-            const contract = (0, contractSpec_1.buildContract)({
-                deliverableSpecs: deliverables,
-                validationCommands: validation_commands ?? validationCommands,
-                constraints,
-            });
-            const contractResult = (0, core_1.setTaskContract)(board, resolvedTaskId, contract);
-            if (!contractResult.success || !contractResult.board) {
-                return { content: [{ type: 'text', text: `Error: ${contractResult.error || 'Failed to attach contract'}` }], isError: true };
-            }
-            writeBoard(filePath, contractResult.board);
-            return { content: [{ type: 'text', text: `Contract attached: ${resolvedTaskId}` }] };
-        }
-        catch (e) {
-            return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
-        }
-    });
     // Move task tool
-    server.registerTool('move_task', {
+    server.registerTool('task_move', {
         title: 'Move Task',
         description: 'Move a task to a different column',
         inputSchema: {
             file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Task ID to move'),
+            taskId: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional().describe('Task ID or array of task IDs to move'),
+            task: zod_1.z.string().optional().describe('Alias of taskId for single task move'),
             column: zod_1.z.string().describe('Target column ID or name')
         }
-    }, async ({ file, task, column }) => {
+    }, async ({ file, taskId, task, column }) => {
         const filePath = file || defaultFile;
+        const rawTaskIds = taskId ?? task;
+        if (!rawTaskIds) {
+            return { content: [{ type: 'text', text: 'Error: taskId is required' }], isError: true };
+        }
+        const taskIds = Array.isArray(rawTaskIds) ? rawTaskIds : [rawTaskIds];
+        const isBatch = taskIds.length > 1;
         // V2: update task file
         if ((0, v2_detect_1.isV2)(filePath)) {
             const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const taskPath = path.join(dirs.boardDir, (0, core_3.taskFileName)(task));
-            const doc = (0, core_3.readTaskFile)(taskPath);
-            if (!doc) {
-                return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
-            }
             const board = (0, v2_detect_1.readV2BoardConfig)(filePath);
             let targetColumn = board.columns.find(c => c.id === column);
             if (!targetColumn)
@@ -749,38 +644,60 @@ async function mcpCommand(options) {
                 return mcpStructuredError(columnValidation.error || `Invalid column: ${targetColumnId}`, 'column', targetColumnId);
             }
             const resolvedTargetColumn = targetColumn || { id: column, title: column, tasks: [] };
-            const sourceColumn = doc.task.column || '';
-            const targetTasks = (0, core_3.readTasksDir)(dirs.boardDir).filter(t => t.task.column === resolvedTargetColumn.id);
-            doc.task.column = resolvedTargetColumn.id;
-            doc.task.position = targetTasks.length;
-            doc.task.updatedAt = new Date().toISOString();
-            (0, core_3.writeTaskFile)(taskPath, doc.task, doc.body);
-            const shouldAutoComplete = resolvedTargetColumn.completionColumn === true && isTaskCompletable(doc.task.type, board.types);
-            if (shouldAutoComplete) {
-                const completeResult = (0, dist_1.completeTaskFile)(taskPath, dirs.logsDir);
-                if (!completeResult.success) {
-                    return { content: [{ type: 'text', text: `Error: ${completeResult.error || `Failed to complete task: ${task}`}` }], isError: true };
-                }
-            }
-            const warning = (0, errorHandler_1.mcpCheckIncompleteSubtasks)(doc.task, resolvedTargetColumn);
-            let message = `Task ${task} moved from "${sourceColumn}" to "${resolvedTargetColumn.title}"`;
-            if (shouldAutoComplete) {
-                message += '\nTask auto-completed and moved to logs/.';
+            let nextPosition = (0, core_3.readTasksDir)(dirs.boardDir).filter(t => t.task.column === resolvedTargetColumn.id).length;
+            const results = [];
+            for (const id of taskIds) {
+                const taskPath = path.join(dirs.boardDir, (0, core_3.taskFileName)(id));
+                const doc = (0, core_3.readTaskFile)(taskPath);
+                if (!doc) {
+                    results.push({ taskId: id, success: false, error: `Task not found: ${id}` });
+                    continue;
+                }
+                const sourceColumn = doc.task.column || '';
+                doc.task.column = resolvedTargetColumn.id;
+                doc.task.position = nextPosition++;
+                doc.task.updatedAt = new Date().toISOString();
+                (0, core_3.writeTaskFile)(taskPath, doc.task, doc.body);
+                const shouldAutoComplete = resolvedTargetColumn.completionColumn === true &&
+                    isTaskCompletable(doc.task.type, board.types);
+                if (shouldAutoComplete) {
+                    const completeResult = (0, core_3.completeTaskFile)(taskPath, dirs.logsDir);
+                    if (!completeResult.success) {
+                        results.push({ taskId: id, success: false, error: completeResult.error || `Failed to complete task: ${id}` });
+                        continue;
+                    }
+                }
+                const warning = (0, errorHandler_1.mcpCheckIncompleteSubtasks)(doc.task, resolvedTargetColumn);
+                let message = `Task ${id} moved from "${sourceColumn}" to "${resolvedTargetColumn.title}"`;
+                if (shouldAutoComplete) {
+                    message += '\nTask auto-completed and moved to logs/.';
+                }
+                results.push({ taskId: id, success: true, message, warning: warning?.warning });
             }
-            if (warning)
-                message += `\n\n${warning.warning}`;
-            return { content: [{ type: 'text', text: message }] };
+            if (!isBatch) {
+                const single = results[0];
+                if (!single?.success) {
+                    return { content: [{ type: 'text', text: `Error: ${single?.error || 'Move failed'}` }], isError: true };
+                }
+                let text = single.message || `Task ${taskIds[0]} moved`;
+                if (single.warning)
+                    text += `\n\n${single.warning}`;
+                return { content: [{ type: 'text', text }] };
+            }
+            const successCount = results.filter(r => r.success).length;
+            const failureCount = results.length - successCount;
+            const output = { success: failureCount === 0, successCount, failureCount, results };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+                isError: failureCount > 0 && successCount === 0,
+            };
         }
         // V1: use board
         const result = readBoard(filePath);
         if ('error' in result) {
             return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
         }
-        let { board } = result;
-        const taskInfo = (0, core_1.findTaskById)(board, task);
-        if (!taskInfo) {
-            return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
-        }
+        const { board } = result;
         let targetColumn = (0, core_1.findColumnById)(board, column);
         if (!targetColumn) {
             targetColumn = (0, core_1.findColumnByName)(board, column);
@@ -788,27 +705,64 @@ async function mcpCommand(options) {
         if (!targetColumn) {
             return { content: [{ type: 'text', text: `Error: Column not found: ${column}` }], isError: true };
         }
-        const moveResult = (0, core_1.moveTask)(board, task, taskInfo.column.id, targetColumn.id, targetColumn.tasks.length);
-        if (!moveResult.success) {
-            return { content: [{ type: 'text', text: `Error: ${moveResult.error}` }], isError: true };
+        if (!isBatch) {
+            const id = taskIds[0];
+            const taskInfo = (0, core_1.findTaskById)(board, id);
+            if (!taskInfo) {
+                return { content: [{ type: 'text', text: `Error: Task not found: ${id}` }], isError: true };
+            }
+            const moveResult = (0, core_1.moveTask)(board, id, taskInfo.column.id, targetColumn.id, targetColumn.tasks.length);
+            if (!moveResult.success) {
+                return { content: [{ type: 'text', text: `Error: ${moveResult.error}` }], isError: true };
+            }
+            writeBoard(filePath, moveResult.board);
+            const warning = (0, errorHandler_1.mcpCheckIncompleteSubtasks)(taskInfo.task, targetColumn);
+            let message = `Task ${id} moved from "${taskInfo.column.title}" to "${targetColumn.title}"`;
+            if (warning)
+                message += `\n\n${warning.warning}`;
+            return { content: [{ type: 'text', text: message }] };
+        }
+        const tasksWithIncomplete = [];
+        for (const id of taskIds) {
+            const taskInfo = (0, core_1.findTaskById)(board, id);
+            if (taskInfo) {
+                const warning = (0, errorHandler_1.mcpCheckIncompleteSubtasks)(taskInfo.task, targetColumn);
+                if (warning?.incompleteSubtasks) {
+                    tasksWithIncomplete.push({
+                        id,
+                        incomplete: warning.incompleteSubtasks.incomplete.length,
+                        total: warning.incompleteSubtasks.total,
+                    });
+                }
+            }
+        }
+        const bulkResult = (0, core_1.moveTasks)(board, taskIds, targetColumn.id);
+        if (bulkResult.board) {
+            writeBoard(filePath, bulkResult.board);
         }
-        writeBoard(filePath, moveResult.board);
-        const warning = (0, errorHandler_1.mcpCheckIncompleteSubtasks)(taskInfo.task, targetColumn);
-        let message = `Task ${task} moved from "${taskInfo.column.title}" to "${targetColumn.title}"`;
-        if (warning) {
-            message += `\n\n${warning.warning}`;
+        const output = {
+            success: bulkResult.success,
+            successCount: bulkResult.successCount,
+            failureCount: bulkResult.failureCount,
+            results: bulkResult.results,
+        };
+        if (tasksWithIncomplete.length > 0) {
+            output.warning = `${tasksWithIncomplete.length} task(s) moved to "${targetColumn.title}" have incomplete subtasks`;
+            output.tasksWithIncompleteSubtasks = tasksWithIncomplete;
         }
         return {
-            content: [{ type: 'text', text: message }]
+            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+            isError: !bulkResult.success,
         };
     });
     // Patch task tool
-    server.registerTool('patch_task', {
+    server.registerTool('task_patch', {
         title: 'Patch Task',
         description: 'Update specific fields of a task. Set fields to null to remove them.',
         inputSchema: {
             file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Task ID to update'),
+            taskId: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional().describe('Task ID or array of task IDs to update'),
+            task: zod_1.z.string().optional().describe('Alias of taskId for single task update'),
             title: zod_1.z.string().optional().describe('New task title'),
             description: zod_1.z.string().nullable().optional().describe('New description (null to remove)'),
             priority: zod_1.z.enum(['low', 'medium', 'high', 'critical']).nullable().optional().describe('New priority (null to remove)'),
@@ -817,59 +771,83 @@ async function mcpCommand(options) {
             dueDate: zod_1.z.string().nullable().optional().describe('New due date (null to remove)'),
             relatedFiles: zod_1.z.array(zod_1.z.string()).nullable().optional().describe('Related file paths (null to remove)')
         }
-    }, async ({ file, task, title, description, priority, tags, assignee, dueDate, relatedFiles }) => {
+    }, async ({ file, taskId, task, title, description, priority, tags, assignee, dueDate, relatedFiles }) => {
         const filePath = file || defaultFile;
+        const rawTaskIds = taskId ?? task;
+        if (!rawTaskIds) {
+            return { content: [{ type: 'text', text: 'Error: taskId is required' }], isError: true };
+        }
+        const taskIds = Array.isArray(rawTaskIds) ? rawTaskIds : [rawTaskIds];
+        const isBatch = taskIds.length > 1;
         const isNull = (v) => v === null || v === 'null';
         // V2: update task file directly
         if ((0, v2_detect_1.isV2)(filePath)) {
             const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const taskPath = path.join(dirs.boardDir, (0, core_3.taskFileName)(task));
-            const doc = (0, core_3.readTaskFile)(taskPath);
-            if (!doc) {
-                return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+            const results = [];
+            for (const id of taskIds) {
+                const taskPath = path.join(dirs.boardDir, (0, core_3.taskFileName)(id));
+                const doc = (0, core_3.readTaskFile)(taskPath);
+                if (!doc) {
+                    results.push({ taskId: id, success: false, error: 'Task not found' });
+                    continue;
+                }
+                const t = doc.task;
+                if (title !== undefined)
+                    t.title = title;
+                if (description !== undefined) {
+                    if (isNull(description))
+                        delete t.description;
+                    else
+                        t.description = description;
+                }
+                if (priority !== undefined) {
+                    if (isNull(priority))
+                        delete t.priority;
+                    else
+                        t.priority = priority;
+                }
+                if (tags !== undefined) {
+                    if (isNull(tags))
+                        delete t.tags;
+                    else
+                        t.tags = tags;
+                }
+                if (assignee !== undefined) {
+                    if (isNull(assignee))
+                        delete t.assignee;
+                    else
+                        t.assignee = assignee;
+                }
+                if (dueDate !== undefined) {
+                    if (isNull(dueDate))
+                        delete t.dueDate;
+                    else
+                        t.dueDate = dueDate;
+                }
+                if (relatedFiles !== undefined) {
+                    if (isNull(relatedFiles))
+                        delete t.relatedFiles;
+                    else
+                        t.relatedFiles = relatedFiles;
+                }
+                t.updatedAt = new Date().toISOString();
+                (0, core_3.writeTaskFile)(taskPath, t, doc.body);
+                results.push({ taskId: id, success: true });
             }
-            const t = doc.task;
-            if (title !== undefined)
-                t.title = title;
-            if (description !== undefined) {
-                if (isNull(description))
-                    delete t.description;
-                else
-                    t.description = description;
-            }
-            if (priority !== undefined) {
-                if (isNull(priority))
-                    delete t.priority;
-                else
-                    t.priority = priority;
-            }
-            if (tags !== undefined) {
-                if (isNull(tags))
-                    delete t.tags;
-                else
-                    t.tags = tags;
-            }
-            if (assignee !== undefined) {
-                if (isNull(assignee))
-                    delete t.assignee;
-                else
-                    t.assignee = assignee;
-            }
-            if (dueDate !== undefined) {
-                if (isNull(dueDate))
-                    delete t.dueDate;
-                else
-                    t.dueDate = dueDate;
-            }
-            if (relatedFiles !== undefined) {
-                if (isNull(relatedFiles))
-                    delete t.relatedFiles;
-                else
-                    t.relatedFiles = relatedFiles;
-            }
-            t.updatedAt = new Date().toISOString();
-            (0, core_3.writeTaskFile)(taskPath, t, doc.body);
-            return { content: [{ type: 'text', text: `Task ${task} updated successfully` }] };
+            if (!isBatch) {
+                const single = results[0];
+                if (!single?.success) {
+                    return { content: [{ type: 'text', text: `Error: ${single?.error || 'Task not found'}` }], isError: true };
+                }
+                return { content: [{ type: 'text', text: `Task ${taskIds[0]} updated successfully` }] };
+            }
+            const successCount = results.filter(r => r.success).length;
+            const failureCount = results.length - successCount;
+            const output = { success: failureCount === 0, successCount, failureCount, results };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+                isError: failureCount > 0 && successCount === 0,
+            };
         }
         // V1: use board
         const result = readBoard(filePath);
@@ -892,17 +870,32 @@ async function mcpCommand(options) {
             patch.dueDate = isNull(dueDate) ? undefined : dueDate;
         if (relatedFiles !== undefined)
             patch.relatedFiles = isNull(relatedFiles) ? undefined : relatedFiles;
-        const patchResult = (0, core_1.patchTask)(board, task, patch);
-        if (!patchResult.success) {
-            return { content: [{ type: 'text', text: `Error: ${patchResult.error}` }], isError: true };
+        if (!isBatch) {
+            const id = taskIds[0];
+            const patchResult = (0, core_1.patchTask)(board, id, patch);
+            if (!patchResult.success) {
+                return { content: [{ type: 'text', text: `Error: ${patchResult.error}` }], isError: true };
+            }
+            writeBoard(filePath, patchResult.board);
+            return { content: [{ type: 'text', text: `Task ${id} updated successfully` }] };
+        }
+        const bulkResult = (0, core_1.patchTasks)(board, taskIds, patch);
+        if (bulkResult.board) {
+            writeBoard(filePath, bulkResult.board);
         }
-        writeBoard(filePath, patchResult.board);
+        const output = {
+            success: bulkResult.success,
+            successCount: bulkResult.successCount,
+            failureCount: bulkResult.failureCount,
+            results: bulkResult.results,
+        };
         return {
-            content: [{ type: 'text', text: `Task ${task} updated successfully` }]
+            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+            isError: !bulkResult.success,
         };
     });
     // Delete task tool
-    server.registerTool('delete_task', {
+    server.registerTool('task_delete', {
         title: 'Delete Task',
         description: 'Permanently delete a task from the brainfile',
         inputSchema: {
@@ -946,212 +939,790 @@ async function mcpCommand(options) {
             content: [{ type: 'text', text: `Task ${task} deleted successfully` }]
         };
     });
-    // Archive task tool
-    server.registerTool('archive_task', {
-        title: 'Archive Task',
-        description: 'Archive a task locally or to an external service (GitHub Issues, Linear). If no destination is specified, uses the project default from brainfile.md, then user default from ~/.config/brainfile/config.json, then falls back to local.',
+    // Unified subtask tool (action-based)
+    server.registerTool('subtask', {
+        title: 'Subtask',
+        description: 'Unified subtask tool for add/toggle/delete/update with single, array, or all targeting',
         inputSchema: {
+            action: zod_1.z.enum(['add', 'toggle', 'delete', 'update']).describe('Subtask action'),
             file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Task ID to archive'),
-            destination: zod_1.z.enum(['local', 'github', 'linear']).optional().describe('Archive destination: local (default), github (creates closed issue), or linear (creates completed issue)')
-        }
-    }, async ({ file, task, destination }) => {
+            task: zod_1.z.string().describe('Parent task ID'),
+            subtask: zod_1.z.string().optional().describe('Single subtask title/id depending on action'),
+            subtasks: zod_1.z.array(zod_1.z.string()).optional().describe('Subtask titles/ids depending on action'),
+            title: zod_1.z.string().optional().describe('New title for update action'),
+            titles: zod_1.z.array(zod_1.z.string()).optional().describe('Optional titles for batch update action'),
+            completed: zod_1.z.boolean().optional().describe('For toggle action: set explicit completed state (true/false) instead of flipping'),
+            all: zod_1.z.boolean().optional().describe('For toggle/delete action: target all subtasks in the task'),
+        }
+    }, async ({ action, file, task, subtask, subtasks, title, titles, completed, all }) => {
         const filePath = file || defaultFile;
-        // V2: archive means move task from board/ to logs/
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const found = (0, v2_detect_1.findV2Task)(dirs, task);
-            if (!found) {
-                return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+        const listParam = subtasks ?? (subtask ? [subtask] : []);
+        const useAll = all === true;
+        const resolveUpdateTitles = (ids) => {
+            if (titles && titles.length > 0) {
+                if (titles.length !== ids.length && titles.length !== 1) {
+                    return { ok: false, error: 'titles length must match subtasks length (or provide a single title to apply to all)' };
+                }
+                const values = titles.length === 1 ? ids.map(() => titles[0]) : titles;
+                return { ok: true, values };
             }
-            // Determine effective destination
-            const board = (0, v2_detect_1.readV2BoardConfig)(filePath);
-            const brainfileDestination = board.archive?.destination;
-            const effectiveDestination = destination || (0, config_1.getEffectiveArchiveDestination)(brainfileDestination);
-            // For GitHub/Linear, format and send before removing
-            if (effectiveDestination === 'github') {
-                if (!(await (0, github_auth_1.isGitHubAuthenticated)())) {
-                    return { content: [{ type: 'text', text: `Error: Not authenticated with GitHub.\n\nTo authenticate, run:\n  npx @brainfile/cli auth github\n\nOr fall back to local archive:\n  Use destination: "local"` }], isError: true };
+            if (title !== undefined) {
+                return { ok: true, values: ids.map(() => title) };
+            }
+            return { ok: false, error: 'title or titles is required for action=update' };
+        };
+        // ── add ────────────────────────────────────────────────────────────────
+        if (action === 'add') {
+            const titlesToAdd = listParam.map(value => value.trim()).filter(Boolean);
+            if (titlesToAdd.length === 0) {
+                return { content: [{ type: 'text', text: 'Error: subtask or subtasks is required for action=add' }], isError: true };
+            }
+            if ((0, v2_detect_1.isV2)(filePath)) {
+                const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
+                const found = (0, v2_detect_1.findV2Task)(dirs, task);
+                if (!found) {
+                    return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
                 }
-                const config = (0, config_1.getArchiveConfig)();
-                if (!config.github?.owner || !config.github?.repo) {
-                    return { content: [{ type: 'text', text: `Error: GitHub repository not configured.\n\nTo configure, run:\n  npx @brainfile/cli config set archive.github.owner <owner>\n  npx @brainfile/cli config set archive.github.repo <repo>` }], isError: true };
+                const t = found.doc.task;
+                if (!t.subtasks)
+                    t.subtasks = [];
+                let nextIndex = t.subtasks.length > 0
+                    ? Math.max(...t.subtasks.map(st => parseInt(st.id.split('-').pop() || '0', 10))) + 1
+                    : 1;
+                const added = [];
+                for (const value of titlesToAdd) {
+                    const id = `${task}-${nextIndex++}`;
+                    const newSubtask = { id, title: value, completed: false };
+                    t.subtasks.push(newSubtask);
+                    added.push({ id: newSubtask.id, title: newSubtask.title });
                 }
-                const payload = (0, core_2.formatTaskForGitHub)(found.doc.task, {
-                    includeMeta: true, includeSubtasks: true, includeRelatedFiles: true,
-                    boardTitle: board.title, fromColumn: found.doc.task.column || 'unknown',
-                    extraLabels: config.github.labels,
-                });
-                const ghResult = await (0, github_auth_1.createGitHubIssue)({ owner: config.github.owner, repo: config.github.repo, title: payload.title, body: payload.body, labels: payload.labels, state: 'closed' });
-                if (!ghResult.success) {
-                    return { content: [{ type: 'text', text: `Error creating GitHub issue: ${ghResult.error}` }], isError: true };
+                t.updatedAt = new Date().toISOString();
+                (0, core_3.writeTaskFile)(found.filePath, t, found.doc.body);
+                if (added.length === 1) {
+                    return { content: [{ type: 'text', text: `Subtask added: ${added[0].id} - ${added[0].title}` }] };
                 }
-                fs.unlinkSync(found.filePath);
-                return { content: [{ type: 'text', text: `Task ${task} archived to GitHub Issue #${ghResult.issueNumber} (closed)\n\nView: ${ghResult.issueUrl}` }] };
-            }
-            if (effectiveDestination === 'linear') {
-                if (!(await (0, linear_auth_1.isLinearAuthenticated)())) {
-                    return { content: [{ type: 'text', text: `Error: Not authenticated with Linear.\n\nTo authenticate, run:\n  npx @brainfile/cli auth linear --token <api-key>` }], isError: true };
+                return { content: [{ type: 'text', text: JSON.stringify({ added, count: added.length }, null, 2) }] };
+            }
+            const result = readBoard(filePath);
+            if ('error' in result) {
+                return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
+            }
+            let board = result.board;
+            const added = [];
+            for (const value of titlesToAdd) {
+                const addResult = (0, core_1.addSubtask)(board, task, value);
+                if (!addResult.success || !addResult.board) {
+                    return { content: [{ type: 'text', text: `Error: ${addResult.error}` }], isError: true };
                 }
-                const config = (0, config_1.getArchiveConfig)();
-                let teamId = config.linear?.teamId;
-                if (!teamId) {
-                    const teams = await (0, linear_auth_1.getLinearTeams)();
-                    if (teams.length === 0) {
-                        return { content: [{ type: 'text', text: `Error: No Linear teams found.` }], isError: true };
-                    }
-                    if (teams.length === 1) {
-                        teamId = teams[0].id;
-                    }
-                    else {
-                        const teamList = teams.map(t => `  ${t.key}: ${t.name} (${t.id})`).join('\n');
-                        return { content: [{ type: 'text', text: `Error: Multiple Linear teams found. Please configure a default.\n\nAvailable teams:\n${teamList}` }], isError: true };
-                    }
+                board = addResult.board;
+                const updatedTask = (0, core_1.findTaskById)(board, task)?.task;
+                const created = updatedTask?.subtasks?.slice(-1)[0];
+                if (created)
+                    added.push({ id: created.id, title: created.title });
+            }
+            writeBoard(filePath, board);
+            if (added.length === 1) {
+                return { content: [{ type: 'text', text: `Subtask added: ${added[0].id} - ${added[0].title}` }] };
+            }
+            return { content: [{ type: 'text', text: JSON.stringify({ added, count: added.length }, null, 2) }] };
+        }
+        // ── delete ─────────────────────────────────────────────────────────────
+        if (action === 'delete') {
+            if ((0, v2_detect_1.isV2)(filePath)) {
+                const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
+                const found = (0, v2_detect_1.findV2Task)(dirs, task);
+                if (!found) {
+                    return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
                 }
-                const payload = (0, core_2.formatTaskForLinear)(found.doc.task, {
-                    includeMeta: true, includeSubtasks: true, includeRelatedFiles: true,
-                    boardTitle: board.title, fromColumn: found.doc.task.column || 'unknown', stateName: 'Done',
-                });
-                const linearResult = await (0, linear_auth_1.createLinearIssue)({ teamId, title: payload.title, description: payload.description, priority: payload.priority, labelNames: payload.labelNames, stateName: 'Done' });
-                if (!linearResult.success) {
-                    return { content: [{ type: 'text', text: `Error creating Linear issue: ${linearResult.error}` }], isError: true };
+                const t = found.doc.task;
+                if (!t.subtasks || t.subtasks.length === 0) {
+                    return { content: [{ type: 'text', text: `Error: Task has no subtasks` }], isError: true };
                 }
-                fs.unlinkSync(found.filePath);
-                return { content: [{ type: 'text', text: `Task ${task} archived to Linear Issue ${linearResult.issueId} (Done)\n\nView: ${linearResult.issueUrl}` }] };
+                const targetIds = useAll ? t.subtasks.map(st => st.id) : listParam;
+                if (targetIds.length === 0) {
+                    return { content: [{ type: 'text', text: 'Error: subtask or subtasks is required for action=delete (unless all=true)' }], isError: true };
+                }
+                const existing = new Set(t.subtasks.map(st => st.id));
+                const deleted = targetIds.filter(id => existing.has(id));
+                const missing = targetIds.filter(id => !existing.has(id));
+                if (deleted.length === 0) {
+                    return { content: [{ type: 'text', text: `Error: Subtask not found: ${targetIds.join(', ')}` }], isError: true };
+                }
+                const deleteSet = new Set(deleted);
+                t.subtasks = t.subtasks.filter(st => !deleteSet.has(st.id));
+                t.updatedAt = new Date().toISOString();
+                (0, core_3.writeTaskFile)(found.filePath, t, found.doc.body);
+                if (!useAll && deleted.length === 1 && missing.length === 0) {
+                    return { content: [{ type: 'text', text: `Subtask ${deleted[0]} deleted successfully` }] };
+                }
+                return { content: [{ type: 'text', text: JSON.stringify({ deleted, missing, count: deleted.length }, null, 2) }] };
             }
-            // Local archive: move from board/ to logs/
-            const logPath = path.join(dirs.logsDir, (0, core_3.taskFileName)(task));
-            found.doc.task.completedAt = found.doc.task.completedAt || new Date().toISOString();
-            delete found.doc.task.column;
-            delete found.doc.task.position;
-            (0, core_3.writeTaskFile)(logPath, found.doc.task, found.doc.body);
-            fs.unlinkSync(found.filePath);
-            return { content: [{ type: 'text', text: `Task ${task} archived to logs/` }] };
-        }
-        // V1: use board
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
+            const result = readBoard(filePath);
+            if ('error' in result) {
+                return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
+            }
+            let board = result.board;
+            const taskInfo = (0, core_1.findTaskById)(board, task);
+            if (!taskInfo) {
+                return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+            }
+            const targetIds = useAll ? (taskInfo.task.subtasks || []).map(st => st.id) : listParam;
+            if (targetIds.length === 0) {
+                return { content: [{ type: 'text', text: 'Error: subtask or subtasks is required for action=delete (unless all=true)' }], isError: true };
+            }
+            const deleted = [];
+            const missing = [];
+            for (const id of targetIds) {
+                const deleteResult = (0, core_1.deleteSubtask)(board, task, id);
+                if (!deleteResult.success || !deleteResult.board) {
+                    missing.push(id);
+                    continue;
+                }
+                board = deleteResult.board;
+                deleted.push(id);
+            }
+            if (deleted.length === 0) {
+                return { content: [{ type: 'text', text: `Error: Subtask not found: ${targetIds.join(', ')}` }], isError: true };
+            }
+            writeBoard(filePath, board);
+            if (!useAll && deleted.length === 1 && missing.length === 0) {
+                return { content: [{ type: 'text', text: `Subtask ${deleted[0]} deleted successfully` }] };
+            }
+            return { content: [{ type: 'text', text: JSON.stringify({ deleted, missing, count: deleted.length }, null, 2) }] };
         }
-        let { board } = result;
-        // Find the task to get its column
-        const taskInfo = (0, core_1.findTaskById)(board, task);
-        if (!taskInfo) {
-            return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+        // ── toggle ─────────────────────────────────────────────────────────────
+        if (action === 'toggle') {
+            if ((0, v2_detect_1.isV2)(filePath)) {
+                const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
+                const found = (0, v2_detect_1.findV2Task)(dirs, task);
+                if (!found) {
+                    return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+                }
+                const t = found.doc.task;
+                if (!t.subtasks || t.subtasks.length === 0) {
+                    return { content: [{ type: 'text', text: `Error: Task has no subtasks` }], isError: true };
+                }
+                const targetIds = useAll ? t.subtasks.map(st => st.id) : listParam;
+                if (targetIds.length === 0) {
+                    return { content: [{ type: 'text', text: 'Error: subtask or subtasks is required for action=toggle (unless all=true)' }], isError: true };
+                }
+                const targetSet = new Set(targetIds);
+                const updated = [];
+                for (const st of t.subtasks) {
+                    if (!targetSet.has(st.id))
+                        continue;
+                    st.completed = completed !== undefined ? completed : !st.completed;
+                    updated.push({ id: st.id, completed: st.completed });
+                }
+                if (updated.length === 0) {
+                    return { content: [{ type: 'text', text: `Error: Subtask not found: ${targetIds.join(', ')}` }], isError: true };
+                }
+                t.updatedAt = new Date().toISOString();
+                (0, core_3.writeTaskFile)(found.filePath, t, found.doc.body);
+                if (!useAll && updated.length === 1) {
+                    const status = updated[0].completed ? 'completed' : 'incomplete';
+                    return { content: [{ type: 'text', text: `Subtask ${updated[0].id} marked as ${status}` }] };
+                }
+                return { content: [{ type: 'text', text: JSON.stringify({ updated, count: updated.length }, null, 2) }] };
+            }
+            const result = readBoard(filePath);
+            if ('error' in result) {
+                return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
+            }
+            let board = result.board;
+            const taskInfo = (0, core_1.findTaskById)(board, task);
+            if (!taskInfo) {
+                return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+            }
+            const targetIds = useAll ? (taskInfo.task.subtasks || []).map(st => st.id) : listParam;
+            if (targetIds.length === 0) {
+                return { content: [{ type: 'text', text: 'Error: subtask or subtasks is required for action=toggle (unless all=true)' }], isError: true };
+            }
+            const updated = [];
+            if (useAll && completed !== undefined) {
+                const setResult = (0, core_1.setAllSubtasksCompleted)(board, task, completed);
+                if (!setResult.success || !setResult.board) {
+                    return { content: [{ type: 'text', text: `Error: ${setResult.error}` }], isError: true };
+                }
+                board = setResult.board;
+                const updatedTask = (0, core_1.findTaskById)(board, task)?.task;
+                for (const st of updatedTask?.subtasks || []) {
+                    updated.push({ id: st.id, completed: st.completed });
+                }
+            }
+            else if (completed !== undefined && targetIds.length > 0) {
+                const setResult = (0, core_1.setSubtasksCompleted)(board, task, targetIds, completed);
+                if (!setResult.success || !setResult.board) {
+                    return { content: [{ type: 'text', text: `Error: ${setResult.error}` }], isError: true };
+                }
+                board = setResult.board;
+                const updatedTask = (0, core_1.findTaskById)(board, task)?.task;
+                const targetSet = new Set(targetIds);
+                for (const st of updatedTask?.subtasks || []) {
+                    if (targetSet.has(st.id))
+                        updated.push({ id: st.id, completed: st.completed });
+                }
+            }
+            else {
+                for (const id of targetIds) {
+                    const toggleResult = (0, core_1.toggleSubtask)(board, task, id);
+                    if (!toggleResult.success || !toggleResult.board) {
+                        continue;
+                    }
+                    board = toggleResult.board;
+                    const st = (0, core_1.findTaskById)(board, task)?.task.subtasks?.find(entry => entry.id === id);
+                    if (st)
+                        updated.push({ id: st.id, completed: st.completed });
+                }
+            }
+            if (updated.length === 0) {
+                return { content: [{ type: 'text', text: `Error: Subtask not found: ${targetIds.join(', ')}` }], isError: true };
+            }
+            writeBoard(filePath, board);
+            if (!useAll && updated.length === 1) {
+                const status = updated[0].completed ? 'completed' : 'incomplete';
+                return { content: [{ type: 'text', text: `Subtask ${updated[0].id} marked as ${status}` }] };
+            }
+            return { content: [{ type: 'text', text: JSON.stringify({ updated, count: updated.length }, null, 2) }] };
+        }
+        // ── update ─────────────────────────────────────────────────────────────
+        if (action === 'update') {
+            const targetIds = listParam;
+            if (targetIds.length === 0) {
+                return { content: [{ type: 'text', text: 'Error: subtask or subtasks is required for action=update' }], isError: true };
+            }
+            const resolvedTitles = resolveUpdateTitles(targetIds);
+            if (!resolvedTitles.ok) {
+                return { content: [{ type: 'text', text: `Error: ${resolvedTitles.error}` }], isError: true };
+            }
+            if ((0, v2_detect_1.isV2)(filePath)) {
+                const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
+                const found = (0, v2_detect_1.findV2Task)(dirs, task);
+                if (!found) {
+                    return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+                }
+                const t = found.doc.task;
+                if (!t.subtasks || t.subtasks.length === 0) {
+                    return { content: [{ type: 'text', text: `Error: Task has no subtasks` }], isError: true };
+                }
+                const updates = new Map();
+                targetIds.forEach((id, i) => updates.set(id, resolvedTitles.values[i]));
+                const updated = [];
+                for (const st of t.subtasks) {
+                    const nextTitle = updates.get(st.id);
+                    if (nextTitle === undefined)
+                        continue;
+                    st.title = nextTitle;
+                    updated.push({ id: st.id, title: st.title });
+                }
+                if (updated.length === 0) {
+                    return { content: [{ type: 'text', text: `Error: Subtask not found: ${targetIds.join(', ')}` }], isError: true };
+                }
+                t.updatedAt = new Date().toISOString();
+                (0, core_3.writeTaskFile)(found.filePath, t, found.doc.body);
+                if (updated.length === 1) {
+                    return { content: [{ type: 'text', text: `Subtask ${updated[0].id} updated to "${updated[0].title}"` }] };
+                }
+                return { content: [{ type: 'text', text: JSON.stringify({ updated, count: updated.length }, null, 2) }] };
+            }
+            const result = readBoard(filePath);
+            if ('error' in result) {
+                return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
+            }
+            let board = result.board;
+            const updated = [];
+            targetIds.forEach((id, idx) => {
+                const updateResult = (0, core_1.updateSubtask)(board, task, id, resolvedTitles.values[idx]);
+                if (!updateResult.success || !updateResult.board)
+                    return;
+                board = updateResult.board;
+                const st = (0, core_1.findTaskById)(board, task)?.task.subtasks?.find(entry => entry.id === id);
+                if (st)
+                    updated.push({ id: st.id, title: st.title });
+            });
+            if (updated.length === 0) {
+                return { content: [{ type: 'text', text: `Error: Subtask not found: ${targetIds.join(', ')}` }], isError: true };
+            }
+            writeBoard(filePath, board);
+            if (updated.length === 1) {
+                return { content: [{ type: 'text', text: `Subtask ${updated[0].id} updated to "${updated[0].title}"` }] };
+            }
+            return { content: [{ type: 'text', text: JSON.stringify({ updated, count: updated.length }, null, 2) }] };
+        }
+        return { content: [{ type: 'text', text: `Error: Unknown action: ${action}` }], isError: true };
+    });
+    // Unified contract tool (action-based)
+    server.registerTool('contract', {
+        title: 'Contract',
+        description: [
+            'Unified action-based contract tool.',
+            'action=attach   — Attach a new contract to a task (default status=draft; pass ready:true for immediate dispatch)',
+            'action=pickup   — Claim a contract (status → in_progress), returns agent context markdown',
+            'action=deliver  — Mark contract as delivered (status → delivered)',
+            'action=validate — Validate deliverables + commands (status → done/failed)',
+            'action=graph    — Attach contracts to multiple tasks atomically with dependsOn DAG edges (tasks array only)',
+            'action=activate — Flip draft → ready for one task (task param) or all children of a parent (parentId param)',
+        ].join('\n'),
+        inputSchema: {
+            action: zod_1.z.enum(['attach', 'pickup', 'deliver', 'validate', 'graph', 'activate']).describe('Contract action'),
+            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
+            task: zod_1.z.string().optional().describe('Task ID (required for attach, pickup, deliver, validate, and single-task activate)'),
+            parentId: zod_1.z.string().optional().describe('For activate: activate all draft contracts whose parentId matches this value'),
+            // attach fields
+            ready: zod_1.z.boolean().optional().describe('attach only: when true, status=ready instead of draft'),
+            deliverables: zod_1.z.array(zod_1.z.string()).optional().describe('attach only: type:path:description'),
+            validation_commands: zod_1.z.array(zod_1.z.string()).optional().describe('attach only: validation shell commands'),
+            constraints: zod_1.z.array(zod_1.z.string()).optional().describe('attach only: constraint strings'),
+            tasks: zod_1.z.array(zod_1.z.object({
+                task: zod_1.z.string(),
+                deliverables: zod_1.z.array(zod_1.z.object({
+                    type: zod_1.z.enum(['file', 'test', 'docs', 'design', 'research']),
+                    path: zod_1.z.string(),
+                    description: zod_1.z.string().optional(),
+                })).optional(),
+                validation_commands: zod_1.z.array(zod_1.z.string()).optional(),
+                constraints: zod_1.z.array(zod_1.z.string()).optional(),
+                dependsOn: zod_1.z.array(zod_1.z.string()).optional(),
+            })).optional().describe('graph only: array of contract graph task specs'),
+            activate: zod_1.z.boolean().optional().describe('graph only: when true, attached contracts start in ready instead of draft'),
+        }
+    }, async ({ action, file, task, parentId, ready: attachReady, deliverables, validation_commands, constraints, tasks, activate }) => {
+        const filePath = file || defaultFile;
+        // ── attach ─────────────────────────────────────────────────────────────
+        if (action === 'attach') {
+            if (!task) {
+                return { content: [{ type: 'text', text: 'Error: task is required for action=attach' }], isError: true };
+            }
+            if ((0, v2_detect_1.isV2)(filePath)) {
+                const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
+                const found = (0, v2_detect_1.findV2Task)(dirs, task);
+                if (!found) {
+                    return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+                }
+                try {
+                    const contract = (0, contractSpec_1.buildContract)({
+                        deliverableSpecs: deliverables,
+                        validationCommands: validation_commands,
+                        constraints,
+                        status: attachReady ? 'ready' : 'draft',
+                    });
+                    found.doc.task.contract = contract;
+                    found.doc.task.updatedAt = new Date().toISOString();
+                    (0, core_3.writeTaskFile)(found.filePath, found.doc.task, found.doc.body);
+                    return { content: [{ type: 'text', text: `Contract attached (${contract.status}): ${task}` }] };
+                }
+                catch (e) {
+                    return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
+                }
+            }
+            const readResult = readBoard(filePath);
+            if ('error' in readResult) {
+                return { content: [{ type: 'text', text: `Error: ${readResult.error}` }], isError: true };
+            }
+            const taskInfo = (0, core_1.findTaskById)(readResult.board, task);
+            if (!taskInfo) {
+                return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+            }
+            try {
+                const contract = (0, contractSpec_1.buildContract)({
+                    deliverableSpecs: deliverables,
+                    validationCommands: validation_commands,
+                    constraints,
+                    status: attachReady ? 'ready' : 'draft',
+                });
+                const contractResult = (0, core_1.setTaskContract)(readResult.board, task, contract);
+                if (!contractResult.success || !contractResult.board) {
+                    return { content: [{ type: 'text', text: `Error: ${contractResult.error || 'Failed to attach contract'}` }], isError: true };
+                }
+                writeBoard(filePath, contractResult.board);
+                return { content: [{ type: 'text', text: `Contract attached (${contract.status}): ${task}` }] };
+            }
+            catch (e) {
+                return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
+            }
+        }
+        // ── pickup ─────────────────────────────────────────────────────────────
+        if (action === 'pickup') {
+            if (!task) {
+                return { content: [{ type: 'text', text: 'Error: task is required for action=pickup' }], isError: true };
+            }
+            const result = (0, contractRunner_1.pickupContract)({ filePath, taskId: task });
+            if ('error' in result) {
+                return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
+            }
+            return { content: [{ type: 'text', text: result.markdown }] };
+        }
+        // ── deliver ────────────────────────────────────────────────────────────
+        if (action === 'deliver') {
+            if (!task) {
+                return { content: [{ type: 'text', text: 'Error: task is required for action=deliver' }], isError: true };
+            }
+            const result = (0, contractRunner_1.deliverContract)({ filePath, taskId: task });
+            if ('error' in result) {
+                return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
+            }
+            return { content: [{ type: 'text', text: `Contract delivered: ${task}` }] };
         }
-        // Determine effective destination
-        const brainfileDestination = board.archive?.destination;
-        const effectiveDestination = destination || (0, config_1.getEffectiveArchiveDestination)(brainfileDestination);
-        // Handle local archive (to separate brainfile-archive.md file)
-        if (effectiveDestination === 'local') {
-            const archiveResult = (0, archive_1.archiveTaskToFile)(filePath, board, taskInfo.column.id, task);
-            if (!archiveResult.success) {
-                return { content: [{ type: 'text', text: `Error: ${archiveResult.error}` }], isError: true };
-            }
-            const archivePath = (0, archive_1.getArchivePath)(filePath);
+        // ── validate ───────────────────────────────────────────────────────────
+        if (action === 'validate') {
+            if (!task) {
+                return { content: [{ type: 'text', text: 'Error: task is required for action=validate' }], isError: true };
+            }
+            const result = (0, contractRunner_1.validateContract)({ filePath, taskId: task });
+            if ('error' in result) {
+                return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
+            }
+            const output = {
+                ok: result.ok,
+                status: result.ok ? 'done' : 'failed',
+                deliverables: result.deliverableChecks,
+                commands: result.commandResults,
+                warnings: result.warnings,
+            };
             return {
-                content: [{ type: 'text', text: `Task ${task} archived to ${path.basename(archivePath)}` }]
+                content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+                isError: !result.ok,
             };
         }
-        // Handle GitHub archive
-        if (effectiveDestination === 'github') {
-            // Check authentication
-            if (!(await (0, github_auth_1.isGitHubAuthenticated)())) {
+        // ── graph ──────────────────────────────────────────────────────────────
+        if (action === 'graph') {
+            if (!tasks || tasks.length === 0) {
+                return { content: [{ type: 'text', text: 'Error: tasks is required for action=graph and must be a non-empty array' }], isError: true };
+            }
+            try {
+                const result = (0, contract_1.executeContractGraphMcpAction)({
+                    file: filePath,
+                    tasks,
+                    activate,
+                });
                 return {
-                    content: [{
-                            type: 'text',
-                            text: `Error: Not authenticated with GitHub.\n\nTo authenticate, run:\n  npx @brainfile/cli auth github\n\nOr fall back to local archive:\n  Use destination: "local"`
-                        }],
-                    isError: true
+                    content: [{ type: 'text', text: JSON.stringify({
+                                attached: result.attached,
+                                count: result.count,
+                                order: result.order,
+                                graph: result.graph,
+                            }, null, 2) }],
                 };
             }
-            // Check configuration
-            const config = (0, config_1.getArchiveConfig)();
-            if (!config.github?.owner || !config.github?.repo) {
+            catch (error) {
                 return {
-                    content: [{
-                            type: 'text',
-                            text: `Error: GitHub repository not configured.\n\nTo configure, run:\n  npx @brainfile/cli config set archive.github.owner <owner>\n  npx @brainfile/cli config set archive.github.repo <repo>\n\nOr fall back to local archive:\n  Use destination: "local"`
-                        }],
-                    isError: true
+                    content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                    isError: true,
                 };
             }
-            // Format and create GitHub issue
-            const payload = (0, core_2.formatTaskForGitHub)(taskInfo.task, {
-                includeMeta: true,
-                includeSubtasks: true,
-                includeRelatedFiles: true,
-                boardTitle: board.title,
-                fromColumn: taskInfo.column.title,
-                extraLabels: config.github.labels,
-            });
-            const ghResult = await (0, github_auth_1.createGitHubIssue)({
-                owner: config.github.owner,
-                repo: config.github.repo,
-                title: payload.title,
-                body: payload.body,
-                labels: payload.labels,
-                state: 'closed',
-            });
-            if (!ghResult.success) {
-                return {
-                    content: [{ type: 'text', text: `Error creating GitHub issue: ${ghResult.error}` }],
-                    isError: true
+        }
+        // ── activate ───────────────────────────────────────────────────────────
+        if (action === 'activate') {
+            if (!task && !parentId) {
+                return { content: [{ type: 'text', text: 'Error: task or parentId is required for action=activate' }], isError: true };
+            }
+            const activated = [];
+            if ((0, v2_detect_1.isV2)(filePath)) {
+                const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
+                if (task) {
+                    const found = (0, v2_detect_1.findV2Task)(dirs, task, false);
+                    if (!found || found.isLog) {
+                        return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+                    }
+                    if (!found.doc.task.contract) {
+                        return { content: [{ type: 'text', text: `Error: Task ${task} has no contract` }], isError: true };
+                    }
+                    if (found.doc.task.contract.status !== 'draft') {
+                        return { content: [{ type: 'text', text: `Error: Contract is not in draft status (current: ${found.doc.task.contract.status})` }], isError: true };
+                    }
+                    const readyAt = new Date().toISOString();
+                    found.doc.task.contract = {
+                        ...found.doc.task.contract,
+                        status: 'ready',
+                        metrics: {
+                            ...(found.doc.task.contract.metrics ?? {}),
+                            readyAt,
+                        },
+                    };
+                    found.doc.task.updatedAt = readyAt;
+                    (0, core_3.writeTaskFile)(found.filePath, found.doc.task, found.doc.body);
+                    activated.push(task);
+                }
+                else {
+                    // Bulk by parentId
+                    const allTasks = (0, core_3.readTasksDir)(dirs.boardDir);
+                    for (const doc of allTasks) {
+                        const t = doc.task;
+                        if (t.parentId !== parentId)
+                            continue;
+                        if (!t.contract || t.contract.status !== 'draft')
+                            continue;
+                        const readyAt = new Date().toISOString();
+                        t.contract = {
+                            ...t.contract,
+                            status: 'ready',
+                            metrics: {
+                                ...(t.contract.metrics ?? {}),
+                                readyAt,
+                            },
+                        };
+                        t.updatedAt = readyAt;
+                        (0, core_3.writeTaskFile)(path.join(dirs.boardDir, (0, core_3.taskFileName)(t.id)), t, doc.body);
+                        activated.push(t.id);
+                    }
+                }
+                const output = { activated, count: activated.length };
+                return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
+            }
+            // V1
+            const readResult = readBoard(filePath);
+            if ('error' in readResult) {
+                return { content: [{ type: 'text', text: `Error: ${readResult.error}` }], isError: true };
+            }
+            let board = readResult.board;
+            if (task) {
+                const taskInfo = (0, core_1.findTaskById)(board, task);
+                if (!taskInfo) {
+                    return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+                }
+                if (!taskInfo.task.contract) {
+                    return { content: [{ type: 'text', text: `Error: Task ${task} has no contract` }], isError: true };
+                }
+                if (taskInfo.task.contract.status !== 'draft') {
+                    return { content: [{ type: 'text', text: `Error: Contract is not in draft status (current: ${taskInfo.task.contract.status})` }], isError: true };
+                }
+                const readyAt = new Date().toISOString();
+                const updatedContract = {
+                    ...taskInfo.task.contract,
+                    status: 'ready',
+                    metrics: {
+                        ...(taskInfo.task.contract.metrics ?? {}),
+                        readyAt,
+                    },
                 };
+                const contractResult = (0, core_1.setTaskContract)(board, task, updatedContract);
+                if (!contractResult.success || !contractResult.board) {
+                    return { content: [{ type: 'text', text: `Error: ${contractResult.error || 'Failed to activate contract'}` }], isError: true };
+                }
+                board = contractResult.board;
+                activated.push(task);
             }
-            // Remove task from board
-            const deleteResult = (0, core_1.deleteTask)(board, taskInfo.column.id, task);
-            if (deleteResult.success) {
-                writeBoard(filePath, deleteResult.board);
+            else {
+                // Bulk by parentId
+                for (const col of board.columns) {
+                    for (const t of col.tasks) {
+                        const taskAny = t;
+                        if (taskAny.parentId !== parentId)
+                            continue;
+                        if (!t.contract || t.contract.status !== 'draft')
+                            continue;
+                        const readyAt = new Date().toISOString();
+                        const updatedContract = {
+                            ...t.contract,
+                            status: 'ready',
+                            metrics: {
+                                ...(t.contract.metrics ?? {}),
+                                readyAt,
+                            },
+                        };
+                        const contractResult = (0, core_1.setTaskContract)(board, t.id, updatedContract);
+                        if (contractResult.success && contractResult.board) {
+                            board = contractResult.board;
+                            activated.push(t.id);
+                        }
+                    }
+                }
             }
-            return {
-                content: [{
-                        type: 'text',
-                        text: `Task ${task} archived to GitHub Issue #${ghResult.issueNumber} (closed)\n\nView: ${ghResult.issueUrl}`
-                    }]
-            };
+            writeBoard(filePath, board);
+            const output = { activated, count: activated.length };
+            return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
         }
-        // Handle Linear archive
-        if (effectiveDestination === 'linear') {
-            // Check authentication
-            if (!(await (0, linear_auth_1.isLinearAuthenticated)())) {
+        return { content: [{ type: 'text', text: `Error: Unknown action: ${action}` }], isError: true };
+    });
+    // Task complete tool (also supports archive destinations)
+    server.registerTool('task_complete', {
+        title: 'Complete Task',
+        description: 'Complete a task or archive it to local/GitHub/Linear destination',
+        inputSchema: {
+            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
+            task: zod_1.z.string().describe('Task ID to complete'),
+            destination: zod_1.z.enum(['local', 'github', 'linear']).optional().describe('Optional archive destination. If omitted, performs normal completion flow.'),
+        }
+    }, async ({ file, task, destination }) => {
+        const filePath = file || defaultFile;
+        try {
+            // Default behavior: normal complete flow (v2 -> logs, v1 -> done column)
+            if (!destination) {
+                const { completeCommand } = await Promise.resolve().then(() => __importStar(require('./complete')));
+                const result = completeCommand({ file: filePath, task }, { log: () => { }, warn: () => { }, error: () => { }, info: () => { } });
+                return {
+                    content: [{ type: 'text', text: `Task ${task} completed at ${result.completedAt}` }]
+                };
+            }
+            // Local archive keeps legacy archive_task behavior for v1
+            if (destination === 'local') {
+                if ((0, v2_detect_1.isV2)(filePath)) {
+                    const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
+                    const found = (0, v2_detect_1.findV2Task)(dirs, task);
+                    if (!found) {
+                        return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+                    }
+                    const logPath = path.join(dirs.logsDir, (0, core_3.taskFileName)(task));
+                    found.doc.task.completedAt = found.doc.task.completedAt || new Date().toISOString();
+                    delete found.doc.task.column;
+                    delete found.doc.task.position;
+                    (0, core_3.writeTaskFile)(logPath, found.doc.task, found.doc.body);
+                    fs.unlinkSync(found.filePath);
+                    return { content: [{ type: 'text', text: `Task ${task} archived to logs/` }] };
+                }
+                const readResult = readBoard(filePath);
+                if ('error' in readResult) {
+                    return { content: [{ type: 'text', text: `Error: ${readResult.error}` }], isError: true };
+                }
+                const taskInfo = (0, core_1.findTaskById)(readResult.board, task);
+                if (!taskInfo) {
+                    return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+                }
+                const archiveResult = (0, archive_1.archiveTaskToFile)(filePath, readResult.board, taskInfo.column.id, task);
+                if (!archiveResult.success) {
+                    return { content: [{ type: 'text', text: `Error: ${archiveResult.error}` }], isError: true };
+                }
                 return {
-                    content: [{
-                            type: 'text',
-                            text: `Error: Not authenticated with Linear.\n\nTo authenticate, run:\n  npx @brainfile/cli auth linear --token <api-key>\n\nGet your API key from: https://linear.app/settings/api\n\nOr fall back to local archive:\n  Use destination: "local"`
-                        }],
-                    isError: true
+                    content: [{ type: 'text', text: `Task ${task} archived to ${path.basename((0, archive_1.getArchivePath)(filePath))}` }]
                 };
             }
-            // Check/get team configuration
+            // External archive destinations: legacy archive behavior
+            if ((0, v2_detect_1.isV2)(filePath)) {
+                const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
+                const found = (0, v2_detect_1.findV2Task)(dirs, task);
+                if (!found) {
+                    return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+                }
+                const board = (0, v2_detect_1.readV2BoardConfig)(filePath);
+                if (destination === 'github') {
+                    if (!(await (0, github_auth_1.isGitHubAuthenticated)())) {
+                        return { content: [{ type: 'text', text: 'Error: Not authenticated with GitHub.' }], isError: true };
+                    }
+                    const config = (0, config_1.getArchiveConfig)();
+                    if (!config.github?.owner || !config.github?.repo) {
+                        return { content: [{ type: 'text', text: 'Error: GitHub repository not configured.' }], isError: true };
+                    }
+                    const payload = (0, core_2.formatTaskForGitHub)(found.doc.task, {
+                        includeMeta: true,
+                        includeSubtasks: true,
+                        includeRelatedFiles: true,
+                        boardTitle: board.title,
+                        fromColumn: found.doc.task.column || 'unknown',
+                        extraLabels: config.github.labels,
+                    });
+                    const ghResult = await (0, github_auth_1.createGitHubIssue)({
+                        owner: config.github.owner,
+                        repo: config.github.repo,
+                        title: payload.title,
+                        body: payload.body,
+                        labels: payload.labels,
+                        state: 'closed',
+                    });
+                    if (!ghResult.success) {
+                        return { content: [{ type: 'text', text: `Error creating GitHub issue: ${ghResult.error}` }], isError: true };
+                    }
+                    fs.unlinkSync(found.filePath);
+                    return { content: [{ type: 'text', text: `Task ${task} archived to GitHub Issue #${ghResult.issueNumber} (closed)\n\nView: ${ghResult.issueUrl}` }] };
+                }
+                if (!(await (0, linear_auth_1.isLinearAuthenticated)())) {
+                    return { content: [{ type: 'text', text: 'Error: Not authenticated with Linear.' }], isError: true };
+                }
+                const config = (0, config_1.getArchiveConfig)();
+                let teamId = config.linear?.teamId;
+                if (!teamId) {
+                    const teams = await (0, linear_auth_1.getLinearTeams)();
+                    if (teams.length === 0) {
+                        return { content: [{ type: 'text', text: 'Error: No Linear teams found.' }], isError: true };
+                    }
+                    if (teams.length === 1) {
+                        teamId = teams[0].id;
+                    }
+                    else {
+                        const teamList = teams.map(t => `  ${t.key}: ${t.name} (${t.id})`).join('\n');
+                        return { content: [{ type: 'text', text: `Error: Multiple Linear teams found. Please configure a default.\n\nAvailable teams:\n${teamList}` }], isError: true };
+                    }
+                }
+                const payload = (0, core_2.formatTaskForLinear)(found.doc.task, {
+                    includeMeta: true,
+                    includeSubtasks: true,
+                    includeRelatedFiles: true,
+                    boardTitle: board.title,
+                    fromColumn: found.doc.task.column || 'unknown',
+                    stateName: 'Done',
+                });
+                const linearResult = await (0, linear_auth_1.createLinearIssue)({
+                    teamId,
+                    title: payload.title,
+                    description: payload.description,
+                    priority: payload.priority,
+                    labelNames: payload.labelNames,
+                    stateName: 'Done',
+                });
+                if (!linearResult.success) {
+                    return { content: [{ type: 'text', text: `Error creating Linear issue: ${linearResult.error}` }], isError: true };
+                }
+                fs.unlinkSync(found.filePath);
+                return { content: [{ type: 'text', text: `Task ${task} archived to Linear Issue ${linearResult.issueId} (Done)\n\nView: ${linearResult.issueUrl}` }] };
+            }
+            const readResult = readBoard(filePath);
+            if ('error' in readResult) {
+                return { content: [{ type: 'text', text: `Error: ${readResult.error}` }], isError: true };
+            }
+            const { board } = readResult;
+            const taskInfo = (0, core_1.findTaskById)(board, task);
+            if (!taskInfo) {
+                return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
+            }
+            if (destination === 'github') {
+                if (!(await (0, github_auth_1.isGitHubAuthenticated)())) {
+                    return { content: [{ type: 'text', text: 'Error: Not authenticated with GitHub.' }], isError: true };
+                }
+                const config = (0, config_1.getArchiveConfig)();
+                if (!config.github?.owner || !config.github?.repo) {
+                    return { content: [{ type: 'text', text: 'Error: GitHub repository not configured.' }], isError: true };
+                }
+                const payload = (0, core_2.formatTaskForGitHub)(taskInfo.task, {
+                    includeMeta: true,
+                    includeSubtasks: true,
+                    includeRelatedFiles: true,
+                    boardTitle: board.title,
+                    fromColumn: taskInfo.column.title,
+                    extraLabels: config.github.labels,
+                });
+                const ghResult = await (0, github_auth_1.createGitHubIssue)({
+                    owner: config.github.owner,
+                    repo: config.github.repo,
+                    title: payload.title,
+                    body: payload.body,
+                    labels: payload.labels,
+                    state: 'closed',
+                });
+                if (!ghResult.success) {
+                    return { content: [{ type: 'text', text: `Error creating GitHub issue: ${ghResult.error}` }], isError: true };
+                }
+                const deleteResult = (0, core_1.deleteTask)(board, taskInfo.column.id, task);
+                if (deleteResult.success)
+                    writeBoard(filePath, deleteResult.board);
+                return { content: [{ type: 'text', text: `Task ${task} archived to GitHub Issue #${ghResult.issueNumber} (closed)\n\nView: ${ghResult.issueUrl}` }] };
+            }
+            if (!(await (0, linear_auth_1.isLinearAuthenticated)())) {
+                return { content: [{ type: 'text', text: 'Error: Not authenticated with Linear.' }], isError: true };
+            }
             const config = (0, config_1.getArchiveConfig)();
             let teamId = config.linear?.teamId;
             if (!teamId) {
                 const teams = await (0, linear_auth_1.getLinearTeams)();
                 if (teams.length === 0) {
-                    return {
-                        content: [{
-                                type: 'text',
-                                text: `Error: No Linear teams found.\n\nVerify your authentication:\n  npx @brainfile/cli auth status`
-                            }],
-                        isError: true
-                    };
+                    return { content: [{ type: 'text', text: 'Error: No Linear teams found.' }], isError: true };
                 }
                 if (teams.length === 1) {
                     teamId = teams[0].id;
                 }
                 else {
                     const teamList = teams.map(t => `  ${t.key}: ${t.name} (${t.id})`).join('\n');
-                    return {
-                        content: [{
-                                type: 'text',
-                                text: `Error: Multiple Linear teams found. Please configure a default.\n\nAvailable teams:\n${teamList}\n\nTo configure, run:\n  npx @brainfile/cli config set archive.linear.teamId <team-id>\n\nOr fall back to local archive:\n  Use destination: "local"`
-                            }],
-                        isError: true
-                    };
+                    return { content: [{ type: 'text', text: `Error: Multiple Linear teams found. Please configure a default.\n\nAvailable teams:\n${teamList}` }], isError: true };
                 }
             }
-            // Format and create Linear issue
             const payload = (0, core_2.formatTaskForLinear)(taskInfo.task, {
                 includeMeta: true,
                 includeSubtasks: true,
@@ -1169,1314 +1740,17 @@ async function mcpCommand(options) {
                 stateName: 'Done',
             });
             if (!linearResult.success) {
-                return {
-                    content: [{ type: 'text', text: `Error creating Linear issue: ${linearResult.error}` }],
-                    isError: true
-                };
+                return { content: [{ type: 'text', text: `Error creating Linear issue: ${linearResult.error}` }], isError: true };
             }
-            // Remove task from board
             const deleteResult = (0, core_1.deleteTask)(board, taskInfo.column.id, task);
-            if (deleteResult.success) {
+            if (deleteResult.success)
                 writeBoard(filePath, deleteResult.board);
-            }
-            return {
-                content: [{
-                        type: 'text',
-                        text: `Task ${task} archived to Linear Issue ${linearResult.issueId} (Done)\n\nView: ${linearResult.issueUrl}`
-                    }]
-            };
-        }
-        return {
-            content: [{ type: 'text', text: `Error: Unknown destination: ${effectiveDestination}` }],
-            isError: true
-        };
-    });
-    // Restore task tool
-    server.registerTool('restore_task', {
-        title: 'Restore Task',
-        description: 'Restore a task from the archive to a column',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Task ID to restore'),
-            column: zod_1.z.string().describe('Target column ID or name')
-        }
-    }, async ({ file, task, column }) => {
-        const filePath = file || defaultFile;
-        // V2: restore means move from logs/ to board/
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const board = (0, v2_detect_1.readV2BoardConfig)(filePath);
-            let targetColumn = board.columns.find(c => c.id === column);
-            if (!targetColumn)
-                targetColumn = board.columns.find(c => c.title.toLowerCase() === column.toLowerCase());
-            if (!targetColumn) {
-                return { content: [{ type: 'text', text: `Error: Column not found: ${column}` }], isError: true };
-            }
-            // Look in logs
-            const logPath = path.join(dirs.logsDir, (0, core_3.taskFileName)(task));
-            const doc = (0, core_3.readTaskFile)(logPath);
-            if (!doc) {
-                return { content: [{ type: 'text', text: `Error: Task not found in logs: ${task}` }], isError: true };
-            }
-            // Move to board/ with column info
-            const targetTasks = (0, core_3.readTasksDir)(dirs.boardDir).filter(t => t.task.column === targetColumn.id);
-            doc.task.column = targetColumn.id;
-            doc.task.position = targetTasks.length;
-            delete doc.task.completedAt;
-            doc.task.updatedAt = new Date().toISOString();
-            const taskPath = path.join(dirs.boardDir, (0, core_3.taskFileName)(task));
-            (0, core_3.writeTaskFile)(taskPath, doc.task, doc.body);
-            fs.unlinkSync(logPath);
-            return { content: [{ type: 'text', text: `Task ${task} restored to "${targetColumn.title}"` }] };
-        }
-        // V1: use board
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        let { board } = result;
-        // Find target column
-        let targetColumn = (0, core_1.findColumnById)(board, column);
-        if (!targetColumn) {
-            targetColumn = (0, core_1.findColumnByName)(board, column);
-        }
-        if (!targetColumn) {
-            return { content: [{ type: 'text', text: `Error: Column not found: ${column}` }], isError: true };
-        }
-        // Restore from separate archive file
-        const restoreResult = (0, archive_1.restoreFromArchive)(filePath, task, targetColumn.id);
-        if (!restoreResult.success) {
-            // Provide helpful error if archive is empty
-            const { tasks } = (0, archive_1.loadArchivedTasks)(filePath);
-            if (tasks.length === 0) {
-                return {
-                    content: [{ type: 'text', text: `Error: Archive is empty (${path.basename((0, archive_1.getArchivePath)(filePath))})` }],
-                    isError: true
-                };
-            }
-            return { content: [{ type: 'text', text: `Error: ${restoreResult.error}` }], isError: true };
-        }
-        return {
-            content: [{ type: 'text', text: `Task ${task} restored to "${targetColumn.title}"` }]
-        };
-    });
-    // Add subtask tool
-    server.registerTool('add_subtask', {
-        title: 'Add Subtask',
-        description: 'Add a subtask to a task',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Parent task ID'),
-            title: zod_1.z.string().describe('Subtask title')
-        }
-    }, async ({ file, task, title }) => {
-        const filePath = file || defaultFile;
-        // V2: update task file directly
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const found = (0, v2_detect_1.findV2Task)(dirs, task);
-            if (!found) {
-                return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
-            }
-            const t = found.doc.task;
-            if (!t.subtasks)
-                t.subtasks = [];
-            const nextId = t.subtasks.length > 0
-                ? `${task}-${Math.max(...t.subtasks.map(s => parseInt(s.id.split('-').pop() || '0', 10))) + 1}`
-                : `${task}-1`;
-            const newSubtask = { id: nextId, title, completed: false };
-            t.subtasks.push(newSubtask);
-            t.updatedAt = new Date().toISOString();
-            (0, core_3.writeTaskFile)(found.filePath, t, found.doc.body);
-            return { content: [{ type: 'text', text: `Subtask added: ${newSubtask.id} - ${newSubtask.title}` }] };
-        }
-        // V1: use board
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        let { board } = result;
-        const addResult = (0, core_1.addSubtask)(board, task, title);
-        if (!addResult.success) {
-            return { content: [{ type: 'text', text: `Error: ${addResult.error}` }], isError: true };
-        }
-        writeBoard(filePath, addResult.board);
-        // Get the new subtask ID
-        const updatedTask = (0, core_1.findTaskById)(addResult.board, task).task;
-        const newSubtask = updatedTask.subtasks.slice(-1)[0];
-        return {
-            content: [{ type: 'text', text: `Subtask added: ${newSubtask.id} - ${newSubtask.title}` }]
-        };
-    });
-    // Delete subtask tool
-    server.registerTool('delete_subtask', {
-        title: 'Delete Subtask',
-        description: 'Delete a subtask from a task',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Parent task ID'),
-            subtask: zod_1.z.string().describe('Subtask ID to delete')
-        }
-    }, async ({ file, task, subtask }) => {
-        const filePath = file || defaultFile;
-        // V2: update task file directly
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const found = (0, v2_detect_1.findV2Task)(dirs, task);
-            if (!found) {
-                return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
-            }
-            const t = found.doc.task;
-            if (!t.subtasks || !t.subtasks.some(s => s.id === subtask)) {
-                return { content: [{ type: 'text', text: `Error: Subtask not found: ${subtask}` }], isError: true };
-            }
-            t.subtasks = t.subtasks.filter(s => s.id !== subtask);
-            t.updatedAt = new Date().toISOString();
-            (0, core_3.writeTaskFile)(found.filePath, t, found.doc.body);
-            return { content: [{ type: 'text', text: `Subtask ${subtask} deleted successfully` }] };
-        }
-        // V1: use board
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        let { board } = result;
-        const deleteResult = (0, core_1.deleteSubtask)(board, task, subtask);
-        if (!deleteResult.success) {
-            return { content: [{ type: 'text', text: `Error: ${deleteResult.error}` }], isError: true };
-        }
-        writeBoard(filePath, deleteResult.board);
-        return {
-            content: [{ type: 'text', text: `Subtask ${subtask} deleted successfully` }]
-        };
-    });
-    // Toggle subtask tool
-    server.registerTool('toggle_subtask', {
-        title: 'Toggle Subtask',
-        description: 'Toggle a subtask completion status',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Parent task ID'),
-            subtask: zod_1.z.string().describe('Subtask ID to toggle')
-        }
-    }, async ({ file, task, subtask }) => {
-        const filePath = file || defaultFile;
-        // V2: update task file directly
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const found = (0, v2_detect_1.findV2Task)(dirs, task);
-            if (!found) {
-                return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
-            }
-            const t = found.doc.task;
-            const st = t.subtasks?.find(s => s.id === subtask);
-            if (!st) {
-                return { content: [{ type: 'text', text: `Error: Subtask not found: ${subtask}` }], isError: true };
-            }
-            const wasCompleted = st.completed;
-            st.completed = !st.completed;
-            t.updatedAt = new Date().toISOString();
-            (0, core_3.writeTaskFile)(found.filePath, t, found.doc.body);
-            const newStatus = wasCompleted ? 'incomplete' : 'completed';
-            return { content: [{ type: 'text', text: `Subtask ${subtask} marked as ${newStatus}` }] };
-        }
-        // V1: use board
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        let { board } = result;
-        // Get current status
-        const taskInfo = (0, core_1.findTaskById)(board, task);
-        const currentSubtask = taskInfo?.task.subtasks?.find(st => st.id === subtask);
-        const wasCompleted = currentSubtask?.completed || false;
-        const toggleResult = (0, core_1.toggleSubtask)(board, task, subtask);
-        if (!toggleResult.success) {
-            return { content: [{ type: 'text', text: `Error: ${toggleResult.error}` }], isError: true };
-        }
-        writeBoard(filePath, toggleResult.board);
-        const newStatus = wasCompleted ? 'incomplete' : 'completed';
-        return {
-            content: [{ type: 'text', text: `Subtask ${subtask} marked as ${newStatus}` }]
-        };
-    });
-    // Update subtask tool
-    server.registerTool('update_subtask', {
-        title: 'Update Subtask',
-        description: 'Update a subtask title',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Parent task ID'),
-            subtask: zod_1.z.string().describe('Subtask ID to update'),
-            title: zod_1.z.string().describe('New subtask title')
-        }
-    }, async ({ file, task, subtask, title }) => {
-        const filePath = file || defaultFile;
-        // V2: update task file directly
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const found = (0, v2_detect_1.findV2Task)(dirs, task);
-            if (!found) {
-                return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
-            }
-            const t = found.doc.task;
-            const st = t.subtasks?.find(s => s.id === subtask);
-            if (!st) {
-                return { content: [{ type: 'text', text: `Error: Subtask not found: ${subtask}` }], isError: true };
-            }
-            st.title = title;
-            t.updatedAt = new Date().toISOString();
-            (0, core_3.writeTaskFile)(found.filePath, t, found.doc.body);
-            return { content: [{ type: 'text', text: `Subtask ${subtask} updated to "${title}"` }] };
-        }
-        // V1: use board
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        let { board } = result;
-        const updateResult = (0, core_1.updateSubtask)(board, task, subtask, title);
-        if (!updateResult.success) {
-            return { content: [{ type: 'text', text: `Error: ${updateResult.error}` }], isError: true };
-        }
-        writeBoard(filePath, updateResult.board);
-        return {
-            content: [{ type: 'text', text: `Subtask ${subtask} updated to "${title}"` }]
-        };
-    });
-    // Bulk set subtasks completed tool
-    server.registerTool('bulk_set_subtasks', {
-        title: 'Bulk Set Subtasks',
-        description: 'Set multiple subtasks to completed or incomplete in a single atomic operation',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Parent task ID'),
-            subtasks: zod_1.z.array(zod_1.z.string()).describe('Array of subtask IDs to update'),
-            completed: zod_1.z.boolean().describe('Whether to mark as completed (true) or incomplete (false)')
-        }
-    }, async ({ file, task, subtasks, completed }) => {
-        const filePath = file || defaultFile;
-        // V2: update task file directly
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const found = (0, v2_detect_1.findV2Task)(dirs, task);
-            if (!found) {
-                return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
-            }
-            const t = found.doc.task;
-            if (!t.subtasks) {
-                return { content: [{ type: 'text', text: `Error: Task has no subtasks` }], isError: true };
-            }
-            const subtaskSet = new Set(subtasks);
-            for (const st of t.subtasks) {
-                if (subtaskSet.has(st.id)) {
-                    st.completed = completed;
-                }
-            }
-            t.updatedAt = new Date().toISOString();
-            (0, core_3.writeTaskFile)(found.filePath, t, found.doc.body);
-            const status = completed ? 'completed' : 'incomplete';
-            return { content: [{ type: 'text', text: `${subtasks.length} subtasks marked as ${status}` }] };
-        }
-        // V1: use board
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        let { board } = result;
-        const bulkResult = (0, core_1.setSubtasksCompleted)(board, task, subtasks, completed);
-        if (!bulkResult.success) {
-            return { content: [{ type: 'text', text: `Error: ${bulkResult.error}` }], isError: true };
-        }
-        writeBoard(filePath, bulkResult.board);
-        const status = completed ? 'completed' : 'incomplete';
-        return {
-            content: [{ type: 'text', text: `${subtasks.length} subtasks marked as ${status}` }]
-        };
-    });
-    // Complete all subtasks tool
-    server.registerTool('complete_all_subtasks', {
-        title: 'Complete All Subtasks',
-        description: 'Mark all subtasks in a task as completed or incomplete',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Parent task ID'),
-            completed: zod_1.z.boolean().optional().default(true).describe('Whether to mark as completed (default: true) or incomplete (false)')
-        }
-    }, async ({ file, task, completed }) => {
-        const filePath = file || defaultFile;
-        const markCompleted = completed ?? true;
-        // V2: update task file directly
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const found = (0, v2_detect_1.findV2Task)(dirs, task);
-            if (!found) {
-                return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
-            }
-            const t = found.doc.task;
-            const count = t.subtasks?.length || 0;
-            if (t.subtasks) {
-                for (const st of t.subtasks) {
-                    st.completed = markCompleted;
-                }
-            }
-            t.updatedAt = new Date().toISOString();
-            (0, core_3.writeTaskFile)(found.filePath, t, found.doc.body);
-            const status = markCompleted ? 'completed' : 'incomplete';
-            return { content: [{ type: 'text', text: `All ${count} subtasks in ${task} marked as ${status}` }] };
-        }
-        // V1: use board
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        let { board } = result;
-        const bulkResult = (0, core_1.setAllSubtasksCompleted)(board, task, markCompleted);
-        if (!bulkResult.success) {
-            return { content: [{ type: 'text', text: `Error: ${bulkResult.error}` }], isError: true };
-        }
-        writeBoard(filePath, bulkResult.board);
-        // Count subtasks for the message
-        const taskInfo = (0, core_1.findTaskById)(bulkResult.board, task);
-        const count = taskInfo?.task.subtasks?.length || 0;
-        const status = markCompleted ? 'completed' : 'incomplete';
-        return {
-            content: [{ type: 'text', text: `All ${count} subtasks in ${task} marked as ${status}` }]
-        };
-    });
-    // ==========================================================================
-    // BULK OPERATIONS
-    // ==========================================================================
-    // Bulk move tasks tool
-    server.registerTool('bulk_move_tasks', {
-        title: 'Bulk Move Tasks',
-        description: 'Move multiple tasks to a target column in a single operation',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            tasks: zod_1.z.array(zod_1.z.string()).describe('Array of task IDs to move'),
-            column: zod_1.z.string().describe('Target column ID or name')
-        }
-    }, async ({ file, tasks, column }) => {
-        const filePath = file || defaultFile;
-        // V2: update each task file
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const board = (0, v2_detect_1.readV2BoardConfig)(filePath);
-            let targetColumn = board.columns.find(c => c.id === column);
-            if (!targetColumn)
-                targetColumn = board.columns.find(c => c.title.toLowerCase() === column.toLowerCase());
-            if (!targetColumn) {
-                return { content: [{ type: 'text', text: `Error: Column not found: ${column}` }], isError: true };
-            }
-            const results = [];
-            let successCount = 0;
-            let failureCount = 0;
-            for (const taskId of tasks) {
-                const taskPath = path.join(dirs.boardDir, (0, core_3.taskFileName)(taskId));
-                const doc = (0, core_3.readTaskFile)(taskPath);
-                if (!doc) {
-                    results.push({ taskId, success: false, error: 'Task not found' });
-                    failureCount++;
-                    continue;
-                }
-                doc.task.column = targetColumn.id;
-                doc.task.updatedAt = new Date().toISOString();
-                (0, core_3.writeTaskFile)(taskPath, doc.task, doc.body);
-                results.push({ taskId, success: true });
-                successCount++;
-            }
-            const output = { success: failureCount === 0, successCount, failureCount, results };
-            return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }], isError: failureCount > 0 && successCount === 0 };
-        }
-        // V1: use board
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        let { board } = result;
-        // Find target column
-        let targetColumn = (0, core_1.findColumnById)(board, column);
-        if (!targetColumn) {
-            targetColumn = (0, core_1.findColumnByName)(board, column);
-        }
-        if (!targetColumn) {
-            return { content: [{ type: 'text', text: `Error: Column not found: ${column}` }], isError: true };
-        }
-        // Check for incomplete subtasks before move (for warning)
-        const tasksWithIncomplete = [];
-        for (const taskId of tasks) {
-            const taskInfo = (0, core_1.findTaskById)(board, taskId);
-            if (taskInfo) {
-                const warning = (0, errorHandler_1.mcpCheckIncompleteSubtasks)(taskInfo.task, targetColumn);
-                if (warning?.incompleteSubtasks) {
-                    tasksWithIncomplete.push({
-                        id: taskId,
-                        incomplete: warning.incompleteSubtasks.incomplete.length,
-                        total: warning.incompleteSubtasks.total
-                    });
-                }
-            }
-        }
-        const bulkResult = (0, core_1.moveTasks)(board, tasks, targetColumn.id);
-        if (bulkResult.board) {
-            writeBoard(filePath, bulkResult.board);
-        }
-        const output = {
-            success: bulkResult.success,
-            successCount: bulkResult.successCount,
-            failureCount: bulkResult.failureCount,
-            results: bulkResult.results
-        };
-        // Add warning about incomplete subtasks if any
-        if (tasksWithIncomplete.length > 0) {
-            output.warning = `${tasksWithIncomplete.length} task(s) moved to "${targetColumn.title}" have incomplete subtasks`;
-            output.tasksWithIncompleteSubtasks = tasksWithIncomplete;
-        }
-        return {
-            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
-            isError: !bulkResult.success
-        };
-    });
-    // Bulk patch tasks tool
-    server.registerTool('bulk_patch_tasks', {
-        title: 'Bulk Patch Tasks',
-        description: 'Apply the same patch to multiple tasks in a single operation',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            tasks: zod_1.z.array(zod_1.z.string()).describe('Array of task IDs to patch'),
-            priority: zod_1.z.enum(['low', 'medium', 'high', 'critical']).nullable().optional().describe('New priority (null to remove)'),
-            tags: zod_1.z.array(zod_1.z.string()).nullable().optional().describe('New tags (null to remove)'),
-            assignee: zod_1.z.string().nullable().optional().describe('New assignee (null to remove)')
-        }
-    }, async ({ file, tasks, priority, tags, assignee }) => {
-        const filePath = file || defaultFile;
-        const isNull = (v) => v === null || v === 'null';
-        // V2: update each task file
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const results = [];
-            let successCount = 0;
-            let failureCount = 0;
-            for (const taskId of tasks) {
-                const taskPath = path.join(dirs.boardDir, (0, core_3.taskFileName)(taskId));
-                const doc = (0, core_3.readTaskFile)(taskPath);
-                if (!doc) {
-                    results.push({ taskId, success: false, error: 'Task not found' });
-                    failureCount++;
-                    continue;
-                }
-                const t = doc.task;
-                if (priority !== undefined) {
-                    if (isNull(priority))
-                        delete t.priority;
-                    else
-                        t.priority = priority;
-                }
-                if (tags !== undefined) {
-                    if (isNull(tags))
-                        delete t.tags;
-                    else
-                        t.tags = tags;
-                }
-                if (assignee !== undefined) {
-                    if (isNull(assignee))
-                        delete t.assignee;
-                    else
-                        t.assignee = assignee;
-                }
-                t.updatedAt = new Date().toISOString();
-                (0, core_3.writeTaskFile)(taskPath, t, doc.body);
-                results.push({ taskId, success: true });
-                successCount++;
-            }
-            const output = { success: failureCount === 0, successCount, failureCount, results };
-            return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }], isError: failureCount > 0 && successCount === 0 };
-        }
-        // V1: use board
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        let { board } = result;
-        const patch = {};
-        if (priority !== undefined)
-            patch.priority = isNull(priority) ? undefined : priority;
-        if (tags !== undefined)
-            patch.tags = isNull(tags) ? undefined : tags;
-        if (assignee !== undefined)
-            patch.assignee = isNull(assignee) ? undefined : assignee;
-        const bulkResult = (0, core_1.patchTasks)(board, tasks, patch);
-        if (bulkResult.board) {
-            writeBoard(filePath, bulkResult.board);
-        }
-        const output = {
-            success: bulkResult.success,
-            successCount: bulkResult.successCount,
-            failureCount: bulkResult.failureCount,
-            results: bulkResult.results
-        };
-        return {
-            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
-            isError: !bulkResult.success
-        };
-    });
-    // Bulk delete tasks tool
-    server.registerTool('bulk_delete_tasks', {
-        title: 'Bulk Delete Tasks',
-        description: 'Permanently delete multiple tasks in a single operation',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            tasks: zod_1.z.array(zod_1.z.string()).describe('Array of task IDs to delete')
-        }
-    }, async ({ file, tasks }) => {
-        const filePath = file || defaultFile;
-        // V2: delete task files
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const results = [];
-            let successCount = 0;
-            let failureCount = 0;
-            for (const taskId of tasks) {
-                const found = (0, v2_detect_1.findV2Task)(dirs, taskId, true);
-                if (!found) {
-                    results.push({ taskId, success: false, error: 'Task not found' });
-                    failureCount++;
-                    continue;
-                }
-                try {
-                    fs.unlinkSync(found.filePath);
-                    results.push({ taskId, success: true });
-                    successCount++;
-                }
-                catch (e) {
-                    results.push({ taskId, success: false, error: e.message });
-                    failureCount++;
-                }
-            }
-            const output = { success: failureCount === 0, successCount, failureCount, results };
-            return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }], isError: failureCount > 0 && successCount === 0 };
-        }
-        // V1: use board
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        let { board } = result;
-        const bulkResult = (0, core_1.deleteTasks)(board, tasks);
-        if (bulkResult.board) {
-            writeBoard(filePath, bulkResult.board);
-        }
-        const output = {
-            success: bulkResult.success,
-            successCount: bulkResult.successCount,
-            failureCount: bulkResult.failureCount,
-            results: bulkResult.results
-        };
-        return {
-            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
-            isError: !bulkResult.success
-        };
-    });
-    // Bulk archive tasks tool
-    server.registerTool('bulk_archive_tasks', {
-        title: 'Bulk Archive Tasks',
-        description: 'Archive multiple tasks to the separate archive file',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            tasks: zod_1.z.array(zod_1.z.string()).describe('Array of task IDs to archive')
-        }
-    }, async ({ file, tasks }) => {
-        const filePath = file || defaultFile;
-        // V2: move task files from board/ to logs/
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const results = [];
-            let successCount = 0;
-            let failureCount = 0;
-            for (const taskId of tasks) {
-                const taskPath = path.join(dirs.boardDir, (0, core_3.taskFileName)(taskId));
-                const doc = (0, core_3.readTaskFile)(taskPath);
-                if (!doc) {
-                    results.push({ taskId, success: false, error: 'Task not found' });
-                    failureCount++;
-                    continue;
-                }
-                try {
-                    const logPath = path.join(dirs.logsDir, (0, core_3.taskFileName)(taskId));
-                    doc.task.completedAt = doc.task.completedAt || new Date().toISOString();
-                    delete doc.task.column;
-                    delete doc.task.position;
-                    (0, core_3.writeTaskFile)(logPath, doc.task, doc.body);
-                    fs.unlinkSync(taskPath);
-                    results.push({ taskId, success: true });
-                    successCount++;
-                }
-                catch (e) {
-                    results.push({ taskId, success: false, error: e.message });
-                    failureCount++;
-                }
-            }
-            const output = { success: failureCount === 0, successCount, failureCount, results };
-            return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }], isError: failureCount > 0 && successCount === 0 };
-        }
-        // V1: use board
-        const results = [];
-        let successCount = 0;
-        let failureCount = 0;
-        // Archive each task individually (need to re-read board after each archive)
-        for (const taskId of tasks) {
-            const boardResult = readBoard(filePath);
-            if ('error' in boardResult) {
-                results.push({ taskId, success: false, error: boardResult.error });
-                failureCount++;
-                continue;
-            }
-            const { board } = boardResult;
-            const taskInfo = (0, core_1.findTaskById)(board, taskId);
-            if (!taskInfo) {
-                results.push({ taskId, success: false, error: 'Task not found' });
-                failureCount++;
-                continue;
-            }
-            const archiveResult = (0, archive_1.archiveTaskToFile)(filePath, board, taskInfo.column.id, taskId);
-            if (archiveResult.success) {
-                results.push({ taskId, success: true });
-                successCount++;
-            }
-            else {
-                results.push({ taskId, success: false, error: archiveResult.error });
-                failureCount++;
-            }
-        }
-        const output = {
-            success: failureCount === 0,
-            successCount,
-            failureCount,
-            results,
-            archiveFile: path.basename((0, archive_1.getArchivePath)(filePath))
-        };
-        return {
-            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
-            isError: failureCount > 0 && successCount === 0
-        };
-    });
-    // ==========================================================================
-    // CONTRACTS
-    // ==========================================================================
-    server.registerTool('contract_pickup', {
-        title: 'Contract Pickup',
-        description: 'Claim a task contract (sets status to in_progress) and return agent context as markdown',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Task ID to pick up'),
-        }
-    }, async ({ file, task }) => {
-        const filePath = file || defaultFile;
-        const result = (0, contractRunner_1.pickupContract)({ filePath, taskId: task });
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        return { content: [{ type: 'text', text: result.markdown }] };
-    });
-    server.registerTool('contract_deliver', {
-        title: 'Contract Deliver',
-        description: 'Mark a task contract as delivered (sets status to delivered)',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Task ID to deliver'),
-        }
-    }, async ({ file, task }) => {
-        const filePath = file || defaultFile;
-        const result = (0, contractRunner_1.deliverContract)({ filePath, taskId: task });
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Contract delivered: ${task}\nReminder: prepare summary and filesChanged for the upcoming complete_task call.`
-                }]
-        };
-    });
-    server.registerTool('contract_validate', {
-        title: 'Contract Validate',
-        description: 'Validate contract deliverables + commands; sets status to done/failed',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Task ID to validate'),
-        }
-    }, async ({ file, task }) => {
-        const filePath = file || defaultFile;
-        const result = (0, contractRunner_1.validateContract)({ filePath, taskId: task });
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        const output = {
-            ok: result.ok,
-            status: result.ok ? 'done' : 'failed',
-            deliverables: result.deliverableChecks,
-            commands: result.commandResults,
-            warnings: result.warnings,
-        };
-        return {
-            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
-            isError: !result.ok
-        };
-    });
-    // ==========================================================================
-    // TYPES
-    // ==========================================================================
-    server.registerTool('list_types', {
-        title: 'List Types',
-        description: 'List board strict mode and custom type configuration',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-        }
-    }, async ({ file }) => {
-        const filePath = file || defaultFile;
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            try {
-                const board = (0, v2_detect_1.readV2BoardConfig)(filePath);
-                const boardConfig = board;
-                const output = {
-                    strict: boardConfig.strict === true,
-                    types: sanitizeTypesConfig(boardConfig.types),
-                };
-                return {
-                    content: [{ type: 'text', text: JSON.stringify(output, null, 2) }]
-                };
-            }
-            catch (e) {
-                return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
-            }
-        }
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        const boardConfig = result.board;
-        const strict = boardConfig.strict === true;
-        const types = sanitizeTypesConfig(boardConfig.types);
-        return {
-            content: [{
-                    type: 'text',
-                    text: JSON.stringify({ strict, types }, null, 2)
-                }]
-        };
-    });
-    // ==========================================================================
-    // RULES
-    // ==========================================================================
-    // List rules tool
-    server.registerTool('list_rules', {
-        title: 'List Rules',
-        description: 'List all project rules (always, never, prefer, context) from the brainfile',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            category: zod_1.z.enum(['always', 'never', 'prefer', 'context']).optional().describe('Filter by rule category')
-        }
-    }, async ({ file, category }) => {
-        const filePath = file || defaultFile;
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        const { board } = result;
-        const rules = board.rules || {};
-        // Filter by category if specified
-        let outputRules = rules;
-        if (category) {
-            outputRules = { [category]: rules[category] || [] };
-        }
-        // Count total rules
-        const countRules = (r) => (r.always?.length || 0) +
-            (r.never?.length || 0) +
-            (r.prefer?.length || 0) +
-            (r.context?.length || 0);
-        const output = {
-            rules: outputRules,
-            totalCount: category
-                ? (outputRules[category]?.length || 0)
-                : countRules(rules),
-        };
-        return {
-            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }]
-        };
-    });
-    // Add rule tool
-    server.registerTool('add_rule', {
-        title: 'Add Rule',
-        description: 'Add a new project rule to the brainfile',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            category: zod_1.z.enum(['always', 'never', 'prefer', 'context']).describe('Rule category'),
-            text: zod_1.z.string().describe('Rule text/description')
-        }
-    }, async ({ file, category, text }) => {
-        const filePath = file || defaultFile;
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        let { board } = result;
-        const addResult = (0, core_1.addRule)(board, category, text);
-        if (!addResult.success || !addResult.board) {
-            return { content: [{ type: 'text', text: `Error: ${addResult.error}` }], isError: true };
-        }
-        writeBoard(filePath, addResult.board);
-        // Find the newly added rule (last one in the category)
-        const newRules = addResult.board.rules?.[category] || [];
-        const newRule = newRules[newRules.length - 1];
-        const output = {
-            success: true,
-            category,
-            rule: newRule,
-        };
-        return {
-            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }]
-        };
-    });
-    // Delete rule tool
-    server.registerTool('delete_rule', {
-        title: 'Delete Rule',
-        description: 'Delete a project rule from the brainfile by category and ID',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            category: zod_1.z.enum(['always', 'never', 'prefer', 'context']).describe('Rule category'),
-            id: zod_1.z.number().describe('Rule ID to delete')
-        }
-    }, async ({ file, category, id }) => {
-        const filePath = file || defaultFile;
-        const result = readBoard(filePath);
-        if ('error' in result) {
-            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
-        }
-        let { board } = result;
-        // Find the rule being deleted for the response
-        const existingRules = board.rules?.[category] || [];
-        const ruleToDelete = existingRules.find((r) => r.id === id);
-        if (!ruleToDelete) {
-            const availableIds = existingRules.map((r) => r.id).join(', ');
-            return {
-                content: [{
-                        type: 'text',
-                        text: `Error: Rule ${id} not found in ${category}. ${availableIds ? `Available IDs: ${availableIds}` : `No rules in ${category} category`}`
-                    }],
-                isError: true
-            };
-        }
-        const deleteResult = (0, core_1.deleteRule)(board, category, id);
-        if (!deleteResult.success || !deleteResult.board) {
-            return { content: [{ type: 'text', text: `Error: ${deleteResult.error}` }], isError: true };
-        }
-        writeBoard(filePath, deleteResult.board);
-        const output = {
-            success: true,
-            category,
-            deletedRule: ruleToDelete,
-        };
-        return {
-            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }]
-        };
-    });
-    // ==========================================================================
-    // LEDGER
-    // ==========================================================================
-    server.registerTool('get_task_context', {
-        title: 'Get Task Context',
-        description: 'Get scoped recent ledger history for a task based on relatedFiles and contract deliverables',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            taskId: zod_1.z.string().optional().describe('Task ID to scope context for'),
-            maxEntries: zod_1.z.number().optional().describe('Maximum matching entries to return (default: 5)'),
-            maxAgeDays: zod_1.z.number().optional().describe('Maximum age window in days (default: 90)'),
-            task_id: zod_1.z.string().optional().describe('Alias of taskId'),
-            max_entries: zod_1.z.number().optional().describe('Alias of maxEntries'),
-            max_age_days: zod_1.z.number().optional().describe('Alias of maxAgeDays'),
-        }
-    }, async ({ file, taskId, maxEntries, maxAgeDays, task_id, max_entries, max_age_days }) => {
-        const filePath = file || defaultFile;
-        const resolvedTaskId = taskId || task_id;
-        if (!resolvedTaskId) {
-            return { content: [{ type: 'text', text: 'Error: taskId is required' }], isError: true };
-        }
-        let relatedFiles = [];
-        let deliverables;
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const found = (0, v2_detect_1.findV2Task)(dirs, resolvedTaskId, true);
-            if (!found) {
-                return { content: [{ type: 'text', text: `Error: Task not found: ${resolvedTaskId}` }], isError: true };
-            }
-            relatedFiles = found.doc.task.relatedFiles || [];
-            deliverables = found.doc.task.contract?.deliverables;
-        }
-        else {
-            const boardResult = readBoard(filePath);
-            if ('error' in boardResult) {
-                return { content: [{ type: 'text', text: `Error: ${boardResult.error}` }], isError: true };
-            }
-            const taskInfo = (0, core_1.findTaskById)(boardResult.board, resolvedTaskId);
-            if (!taskInfo) {
-                return { content: [{ type: 'text', text: `Error: Task not found: ${resolvedTaskId}` }], isError: true };
-            }
-            relatedFiles = taskInfo.task.relatedFiles || [];
-            deliverables = taskInfo.task.contract?.deliverables;
-        }
-        const limit = normalizePositiveInt(maxEntries ?? max_entries, 5);
-        const ageDays = normalizeNonNegativeInt(maxAgeDays ?? max_age_days, 90);
-        const since = toIsoDaysAgo(ageDays);
-        const logsDir = resolveLedgerLogsDir(filePath);
-        const entries = (0, dist_1.getTaskContext)(logsDir, relatedFiles, deliverables, {
-            limit,
-            dateRange: { from: since },
-        });
-        const scopeFiles = new Set();
-        for (const value of relatedFiles) {
-            const trimmed = value.trim();
-            if (trimmed) {
-                scopeFiles.add(trimmed);
-            }
-        }
-        for (const deliverable of deliverables || []) {
-            const rawPath = typeof deliverable === 'string' ? deliverable : deliverable.path;
-            const trimmed = rawPath.trim();
-            if (trimmed) {
-                scopeFiles.add(trimmed);
-            }
-        }
-        const output = {
-            taskId: resolvedTaskId,
-            count: entries.length,
-            maxEntries: limit,
-            maxAgeDays: ageDays,
-            since,
-            scopeFiles: Array.from(scopeFiles),
-            entries,
-        };
-        return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
-    });
-    server.registerTool('query_ledger', {
-        title: 'Query Ledger',
-        description: 'Query ledger records by assignee, tags, date range, files, and contract status',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            assignee: zod_1.z.string().optional().describe('Filter by assignee'),
-            tags: zod_1.z.array(zod_1.z.string()).optional().describe('Filter by tags (OR match)'),
-            since: zod_1.z.string().optional().describe('Filter completions since this ISO date/time'),
-            until: zod_1.z.string().optional().describe('Filter completions until this ISO date/time'),
-            files: zod_1.z.array(zod_1.z.string()).optional().describe('Filter by file paths touched'),
-            contractStatus: zod_1.z.union([
-                zod_1.z.enum(LEDGER_CONTRACT_STATUSES),
-                zod_1.z.array(zod_1.z.enum(LEDGER_CONTRACT_STATUSES)),
-            ]).optional().describe('Filter by contract status'),
-            contract_status: zod_1.z.union([
-                zod_1.z.enum(LEDGER_CONTRACT_STATUSES),
-                zod_1.z.array(zod_1.z.enum(LEDGER_CONTRACT_STATUSES)),
-            ]).optional().describe('Alias of contractStatus'),
-        }
-    }, async ({ file, assignee, tags, since, until, files, contractStatus, contract_status }) => {
-        const filePath = file || defaultFile;
-        const logsDir = resolveLedgerLogsDir(filePath);
-        const contractFilter = contractStatus ?? contract_status;
-        const dateRange = (since || until) ? { from: since, to: until } : undefined;
-        const records = (0, dist_1.queryLedger)(logsDir, {
-            assignee,
-            tags,
-            dateRange,
-            files,
-            contractStatus: contractFilter,
-        });
-        const output = {
-            count: records.length,
-            filters: {
-                assignee,
-                tags,
-                since,
-                until,
-                files,
-                contractStatus: contractFilter,
-            },
-            records,
-        };
-        return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
-    });
-    server.registerTool('get_stats', {
-        title: 'Get Stats',
-        description: 'Get aggregate completion analytics from the ledger with optional filters',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            assignee: zod_1.z.string().optional().describe('Filter analytics by assignee'),
-            since: zod_1.z.string().optional().describe('Only include completions since this ISO date/time'),
-            tag: zod_1.z.string().optional().describe('Filter analytics by a single tag'),
-        }
-    }, async ({ file, assignee, since, tag }) => {
-        const filePath = file || defaultFile;
-        const logsDir = resolveLedgerLogsDir(filePath);
-        const records = (0, dist_1.queryLedger)(logsDir, {
-            assignee,
-            tags: tag ? [tag] : undefined,
-            dateRange: since ? { from: since } : undefined,
-        });
-        const cycleTimes = records
-            .map((record) => record.cycleTimeHours)
-            .filter((hours) => typeof hours === 'number' && Number.isFinite(hours) && hours >= 0);
-        const cycleTimeTotal = Number(cycleTimes.reduce((sum, value) => sum + value, 0).toFixed(3));
-        const cycleTimeAverage = cycleTimes.length > 0
-            ? Number((cycleTimeTotal / cycleTimes.length).toFixed(3))
-            : 0;
-        const cycleTimeMin = cycleTimes.length > 0 ? Number(Math.min(...cycleTimes).toFixed(3)) : 0;
-        const cycleTimeMax = cycleTimes.length > 0 ? Number(Math.max(...cycleTimes).toFixed(3)) : 0;
-        const byType = {};
-        const byContractStatus = {};
-        const byAssignee = {};
-        const byTag = {};
-        const fileCounts = new Map();
-        let firstCompletionAt = null;
-        let lastCompletionAt = null;
-        let firstCompletionMs = null;
-        let lastCompletionMs = null;
-        for (const record of records) {
-            byType[record.type] = (byType[record.type] || 0) + 1;
-            if (record.contractStatus) {
-                byContractStatus[record.contractStatus] = (byContractStatus[record.contractStatus] || 0) + 1;
-            }
-            if (record.assignee) {
-                byAssignee[record.assignee] = (byAssignee[record.assignee] || 0) + 1;
-            }
-            for (const recordTag of record.tags || []) {
-                byTag[recordTag] = (byTag[recordTag] || 0) + 1;
-            }
-            for (const changedFile of record.filesChanged || []) {
-                fileCounts.set(changedFile, (fileCounts.get(changedFile) || 0) + 1);
-            }
-            const completedMs = Date.parse(record.completedAt);
-            if (Number.isFinite(completedMs)) {
-                if (firstCompletionMs === null || completedMs < firstCompletionMs) {
-                    firstCompletionMs = completedMs;
-                    firstCompletionAt = record.completedAt;
-                }
-                if (lastCompletionMs === null || completedMs > lastCompletionMs) {
-                    lastCompletionMs = completedMs;
-                    lastCompletionAt = record.completedAt;
-                }
-            }
-        }
-        const topFiles = Array.from(fileCounts.entries())
-            .sort((a, b) => b[1] - a[1])
-            .slice(0, 10)
-            .map(([filePath, count]) => ({ filePath, count }));
-        const output = {
-            filters: { assignee, since, tag },
-            totals: {
-                completed: records.length,
-                uniqueFilesTouched: fileCounts.size,
-            },
-            cycleTimeHours: {
-                total: cycleTimeTotal,
-                average: cycleTimeAverage,
-                median: median(cycleTimes),
-                min: cycleTimeMin,
-                max: cycleTimeMax,
-            },
-            breakdown: {
-                byType,
-                byContractStatus,
-                byAssignee,
-                byTag,
-            },
-            topFiles,
-            window: {
-                firstCompletionAt,
-                lastCompletionAt,
-            },
-        };
-        return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
-    });
-    server.registerTool('get_file_history', {
-        title: 'Get File History',
-        description: 'Get recent completed records that touched a specific file path',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            filePath: zod_1.z.string().optional().describe('File path to query'),
-            last: zod_1.z.number().optional().describe('Maximum records to return (default: 10)'),
-            since: zod_1.z.string().optional().describe('Only include completions since this ISO date/time'),
-            file_path: zod_1.z.string().optional().describe('Alias of filePath'),
-        }
-    }, async ({ file, filePath: targetFilePath, last, since, file_path }) => {
-        const filePath = file || defaultFile;
-        const resolvedFilePath = targetFilePath || file_path;
-        if (!resolvedFilePath) {
-            return { content: [{ type: 'text', text: 'Error: filePath is required' }], isError: true };
-        }
-        const logsDir = resolveLedgerLogsDir(filePath);
-        const limit = normalizePositiveInt(last, 10);
-        const records = (0, dist_1.getFileHistory)(logsDir, resolvedFilePath, {
-            limit,
-            dateRange: since ? { from: since } : undefined,
-        });
-        const output = {
-            filePath: resolvedFilePath,
-            count: records.length,
-            last: limit,
-            since,
-            records,
-        };
-        return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
-    });
-    // ==========================================================================
-    // V2 NEW TOOLS: complete_task, search_logs, append_log
-    // ==========================================================================
-    // Complete task tool
-    server.registerTool('complete_task', {
-        title: 'Complete Task',
-        description: 'Complete a task - in v2, moves task file from board/ to logs/ with completedAt timestamp. In v1, moves to done column.',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Task ID to complete'),
-            summary: zod_1.z.string().optional().describe('Completion summary (default: Completed: {title})'),
-            filesChanged: zod_1.z.array(zod_1.z.string()).optional().describe('Files changed during implementation (optional; inferred from git diff if omitted)'),
-            files_changed: zod_1.z.array(zod_1.z.string()).optional().describe('Alias of filesChanged'),
-        }
-    }, async ({ file, task, summary, filesChanged, files_changed }) => {
-        const filePath = file || defaultFile;
-        if ((0, v2_detect_1.isV2)(filePath)) {
-            const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-            const taskPath = path.join(dirs.boardDir, (0, core_3.taskFileName)(task));
-            const doc = (0, core_3.readTaskFile)(taskPath);
-            if (!doc) {
-                return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
-            }
-            const resolvedSummary = summary?.trim() || `Completed: ${doc.task.title}`;
-            const rawFiles = filesChanged ?? files_changed ?? [];
-            const providedFiles = rawFiles
-                .map((entry) => entry.trim())
-                .filter((entry) => entry.length > 0);
-            const inferredFiles = providedFiles.length > 0 ? providedFiles : inferFilesChangedFromGit(filePath);
-            const filesSource = providedFiles.length > 0
-                ? 'input'
-                : inferredFiles.length > 0
-                    ? 'git_diff'
-                    : 'core_default';
-            const completeResult = (0, dist_1.completeTaskFile)(taskPath, dirs.logsDir, {
-                summary: resolvedSummary,
-                filesChanged: inferredFiles.length > 0 ? inferredFiles : undefined,
-            });
-            if (!completeResult.success || !completeResult.task) {
-                return { content: [{ type: 'text', text: `Error: ${completeResult.error || `Failed to complete task: ${task}`}` }], isError: true };
-            }
-            const output = {
-                task,
-                completedAt: completeResult.task.completedAt,
-                summary: resolvedSummary,
-                filesChanged: inferredFiles,
-                filesSource,
-            };
-            return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
-        }
-        try {
-            const { completeCommand } = await Promise.resolve().then(() => __importStar(require('./complete')));
-            const result = completeCommand({ file: filePath, task }, { log: () => { }, warn: () => { }, error: () => { }, info: () => { } });
-            const hasLedgerOnlyParams = Boolean(summary) || ((filesChanged ?? files_changed)?.length || 0) > 0;
-            return {
-                content: [{
-                        type: 'text',
-                        text: `Task ${task} completed at ${result.completedAt}${hasLedgerOnlyParams ? `\nNote: summary/filesChanged are only applied in v2 ledger mode.` : ''}`
-                    }]
-            };
+            return { content: [{ type: 'text', text: `Task ${task} archived to Linear Issue ${linearResult.issueId} (Done)\n\nView: ${linearResult.issueUrl}` }] };
         }
         catch (e) {
             return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
         }
     });
-    // Search logs tool
-    server.registerTool('search_logs', {
-        title: 'Search Logs',
-        description: 'Search across completed task logs. Requires v2 per-task file architecture.',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            query: zod_1.z.string().optional().describe('Search query to match against log content'),
-            recent: zod_1.z.boolean().optional().describe('List recently completed tasks'),
-            task: zod_1.z.string().optional().describe('View a specific task log'),
-        }
-    }, async ({ file, query, recent, task: taskId }) => {
-        const filePath = file || defaultFile;
-        if (!(0, v2_detect_1.isV2)(filePath)) {
-            return { content: [{ type: 'text', text: 'Error: search_logs requires v2 per-task file architecture. Run: brainfile migrate' }], isError: true };
-        }
-        const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-        // View specific task log
-        if (taskId) {
-            const found = (0, v2_detect_1.findV2Task)(dirs, taskId, true);
-            if (!found) {
-                return { content: [{ type: 'text', text: `Error: Task not found: ${taskId}` }], isError: true };
-            }
-            const output = {
-                id: found.doc.task.id,
-                title: found.doc.task.title,
-                completedAt: found.doc.task.completedAt,
-                description: (0, v2_detect_1.extractDescription)(found.doc.body),
-                log: (0, v2_detect_1.extractLog)(found.doc.body),
-            };
-            return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
-        }
-        // Search logs
-        if (query) {
-            const logDocs = (0, core_3.readTasksDir)(dirs.logsDir);
-            const queryLower = query.toLowerCase();
-            const matches = [];
-            for (const doc of logDocs) {
-                const task = doc.task;
-                const desc = (0, v2_detect_1.extractDescription)(doc.body) || '';
-                const log = (0, v2_detect_1.extractLog)(doc.body) || '';
-                const fullText = [task.title, task.description || '', desc, log].join(' ').toLowerCase();
-                if (fullText.includes(queryLower)) {
-                    matches.push({ id: task.id, title: task.title, completedAt: task.completedAt });
-                }
-            }
-            return { content: [{ type: 'text', text: JSON.stringify({ results: matches, count: matches.length }, null, 2) }] };
-        }
-        // Recent logs (default)
-        const logDocs = (0, core_3.readTasksDir)(dirs.logsDir);
-        logDocs.sort((a, b) => (b.task.completedAt || '').localeCompare(a.task.completedAt || ''));
-        const recent20 = logDocs.slice(0, 20).map(doc => ({
-            id: doc.task.id,
-            title: doc.task.title,
-            completedAt: doc.task.completedAt,
-        }));
-        return { content: [{ type: 'text', text: JSON.stringify({ logs: recent20, count: recent20.length }, null, 2) }] };
-    });
-    // Append log tool
-    server.registerTool('append_log', {
-        title: 'Append Log',
-        description: 'Append a timestamped entry to a task log section. Works on both active tasks and completed logs. Requires v2 per-task file architecture.',
-        inputSchema: {
-            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Task ID to append log to'),
-            message: zod_1.z.string().describe('Log message to append'),
-            agent: zod_1.z.string().optional().describe('Agent name for attribution'),
-        }
-    }, async ({ file, task: taskId, message, agent }) => {
-        const filePath = file || defaultFile;
-        if (!(0, v2_detect_1.isV2)(filePath)) {
-            return { content: [{ type: 'text', text: 'Error: append_log requires v2 per-task file architecture. Run: brainfile migrate' }], isError: true };
-        }
-        const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-        const found = (0, v2_detect_1.findV2Task)(dirs, taskId, true);
-        if (!found) {
-            return { content: [{ type: 'text', text: `Error: Task not found: ${taskId}` }], isError: true };
-        }
-        const { doc, filePath: taskFilePath } = found;
-        const timestamp = new Date().toISOString();
-        const agentPrefix = agent ? `[${agent}] ` : '';
-        const entry = `- ${timestamp}: ${agentPrefix}${message}`;
-        const existingDescription = (0, v2_detect_1.extractDescription)(doc.body);
-        const existingLog = (0, v2_detect_1.extractLog)(doc.body) || '';
-        const newLog = existingLog ? `${existingLog}\n${entry}` : entry;
-        const newBody = (0, v2_detect_1.composeBody)(existingDescription, newLog);
-        (0, core_3.writeTaskFile)(taskFilePath, doc.task, newBody);
-        return { content: [{ type: 'text', text: `Log entry added to ${taskId}: ${entry}` }] };
-    });
     // Connect via stdio
     const transport = new stdio_js_1.StdioServerTransport();
     await server.connect(transport);