brainfile 0.19.0 → 0.20.0

package/dist/cli.mjs

@@ -8,6 +8,7 @@ const __dirname = __brainfileDirname(__filename);
 import {
   CLIError,
   ExitCode,
+  GLYPHS,
   V1_UNSUPPORTED_MESSAGE,
   assertV2Brainfile,
   authStore,
@@ -40,6 +41,7 @@ import {
   parseError,
   parseFailure,
   probeWorkspaceFormat,
+  renderCliError,
   require_dist,
   require_source,
   resolveCliBrainfilePath,
@@ -52,7 +54,7 @@ import {
   validationError,
   validationError2,
   workspaceRootFromBrainfilePath
-} from "./chunk-YTFLC673.mjs";
+} from "./chunk-UOCQBEEW.mjs";
 import {
   __commonJS,
   __export,
@@ -1223,7 +1225,7 @@ var require_command = __commonJS({
   "../node_modules/commander/lib/command.js"(exports) {
     var EventEmitter = __require("node:events").EventEmitter;
     var childProcess = __require("node:child_process");
-    var path20 = __require("node:path");
+    var path21 = __require("node:path");
     var fs21 = __require("node:fs");
     var process4 = __require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
@@ -2236,9 +2238,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path20.resolve(baseDir, baseName);
+          const localBin = path21.resolve(baseDir, baseName);
           if (fs21.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path20.extname(baseName))) return void 0;
+          if (sourceExt.includes(path21.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
             (ext) => fs21.existsSync(`${localBin}${ext}`)
           );
@@ -2256,17 +2258,17 @@ Expecting one of '${allowedValues.join("', '")}'`);
           } catch {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path20.resolve(
-            path20.dirname(resolvedScriptPath),
+          executableDir = path21.resolve(
+            path21.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path20.basename(
+            const legacyName = path21.basename(
               this._scriptPath,
-              path20.extname(this._scriptPath)
+              path21.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -2277,7 +2279,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path20.extname(executableFile));
+        launchWithNode = sourceExt.includes(path21.extname(executableFile));
         let proc;
         if (process4.platform !== "win32") {
           if (launchWithNode) {
@@ -3192,7 +3194,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path20.basename(filename, path20.extname(filename));
+        this._name = path21.basename(filename, path21.extname(filename));
         return this;
       }
       /**
@@ -3206,9 +3208,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path21) {
-        if (path21 === void 0) return this._executableDir;
-        this._executableDir = path21;
+      executableDir(path22) {
+        if (path22 === void 0) return this._executableDir;
+        this._executableDir = path22;
         return this;
       }
       /**
@@ -3491,7 +3493,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "brainfile",
-      version: "0.19.0",
+      version: "0.20.0",
       description: "Command-line interface for Brainfile task management",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -3528,7 +3530,7 @@ var require_package = __commonJS({
         access: "public"
       },
       dependencies: {
-        "@brainfile/core": "^0.19.0",
+        "@brainfile/core": "^0.20.0",
         chalk: "^4.1.2",
         chokidar: "^4.0.3",
         commander: "^14.0.3",
@@ -3563,7 +3565,7 @@ var require_package = __commonJS({
         "dist"
       ],
       engines: {
-        node: ">=22"
+        node: ">=20"
       }
     };
   }
@@ -3587,8 +3589,8 @@ var {
 } = import_index.default;
 
 // src/cli.ts
-import { readFileSync as readFileSync10, existsSync as existsSync16 } from "fs";
-import { join as join14, sep as sep2 } from "path";
+import { readFileSync as readFileSync9, existsSync as existsSync16 } from "fs";
+import { join as join15, sep as sep2 } from "path";
 
 // src/commands/list.ts
 var import_chalk = __toESM(require_source());
@@ -4648,6 +4650,7 @@ function migrateBrainfileToV2(brainfilePath, options) {
     ...col.completionColumn && { completionColumn: col.completionColumn }
   }));
   delete configBoard.archive;
+  delete configBoard.rules;
   configBoard.schema = "https://brainfile.md/v2/board.json";
   const configContent = import_core10.Brainfile.serialize(configBoard);
   fs5.writeFileSync(brainfilePath, configContent, "utf-8");
@@ -4705,10 +4708,6 @@ function migrateLogsToLedger(options) {
     const taskId = doc.task.id;
     if (existingLedgerIds.has(taskId)) {
       console.log(import_chalk6.default.gray(`  Skip: ${taskId} (already in ledger)`));
-      if (options.force) {
-        fs5.rmSync(doc.filePath, { force: true });
-        console.log(import_chalk6.default.gray(`    Removed stale log file: ${path7.basename(doc.filePath)}`));
-      }
       skippedCount++;
       continue;
     }
@@ -4729,22 +4728,17 @@ function migrateLogsToLedger(options) {
       console.log(import_chalk6.default.yellow(`  Conflict: board/${taskId} \u2192 ${newId} (completed task takes precedence)`));
       conflictCount++;
     }
-    fs5.rmSync(doc.filePath, { force: true });
-    console.log(import_chalk6.default.gray(`  Migrated: ${taskId}`));
+    console.log(import_chalk6.default.gray(`  Backfilled: ${taskId}`));
   }
   console.log("");
-  console.log(import_chalk6.default.green(`Logs-to-ledger migration complete.`));
-  console.log(import_chalk6.default.gray(`  Migrated to ledger:  ${migratedCount}`));
+  console.log(import_chalk6.default.green(`Ledger backfill complete (markdown archives kept).`));
+  console.log(import_chalk6.default.gray(`  Backfilled to ledger: ${migratedCount}`));
   if (skippedCount > 0) {
     console.log(import_chalk6.default.gray(`  Skipped (in ledger): ${skippedCount}`));
   }
   if (conflictCount > 0) {
     console.log(import_chalk6.default.yellow(`  ID conflicts fixed:  ${conflictCount} board task(s) renamed`));
   }
-  if (skippedCount > 0 && !options.force) {
-    console.log("");
-    console.log(import_chalk6.default.gray("Tip: Use --force to also remove stale .md files that are already in the ledger."));
-  }
 }
 function backupAndRemoveLegacyRoot(rootBrainfilePath, dotDir) {
   const backupPath = uniquePath(path7.join(dotDir, "brainfile.root.legacy.bak"));
@@ -4928,7 +4922,6 @@ var import_core14 = __toESM(require_dist());
 var import_chalk9 = __toESM(require_source());
 import * as fs7 from "fs";
 import * as path10 from "path";
-var import_core15 = __toESM(require_dist());
 async function archiveCommand(options) {
   try {
     if (!options.task && !options.all) {
@@ -4946,7 +4939,14 @@ async function archiveCommand(options) {
     }
     const destination = parsedDest.type;
     if (destination === "local") {
-      operationError('Local archive is not supported for v2 boards. Use "brainfile complete" to move tasks to logs/.');
+      if (options.all) {
+        console.log(import_chalk9.default.yellow("Note:") + " --all with local destination has no effect (tasks complete into logs/ via brainfile complete).");
+        return;
+      }
+      if (options.task) {
+        await completeLocalV2(filePath, options.task, options.dryRun);
+      }
+      return;
     }
     if (destination === "github" && !await isGitHubAuthenticated()) {
       console.log(import_chalk9.default.red("\u2717") + " Not authenticated with GitHub.");
@@ -4971,9 +4971,38 @@ async function archiveCommand(options) {
     handleError(error48);
   }
 }
+function completeLocalV2(filePath, taskId, dryRun) {
+  const dirs = (0, import_core.getV2Dirs)(filePath);
+  const onBoard = (0, import_core.findV2Task)(dirs, taskId, false);
+  if (onBoard && !onBoard.isLog) {
+    if (dryRun) {
+      console.log(import_chalk9.default.yellow("DRY RUN") + " - No changes will be made");
+      console.log("");
+      console.log(`Would complete ${import_chalk9.default.cyan(taskId)} (ledger + logs/${taskId}.md)`);
+      return;
+    }
+    const result = (0, import_core14.completeTaskFile)(onBoard.filePath, dirs.logsDir);
+    if (!result.success) {
+      operationError(result.error || `Failed to complete task: ${taskId}`);
+      return;
+    }
+    console.log(import_chalk9.default.green("Task completed!"));
+    console.log("");
+    console.log(import_chalk9.default.gray(`  Task:     ${taskId}`));
+    console.log(import_chalk9.default.gray(`  Moved to: logs/${taskId}.md`));
+    return;
+  }
+  const inLogs = (0, import_core.findV2Task)(dirs, taskId, true);
+  if (inLogs?.isLog) {
+    console.log(import_chalk9.default.yellow("Already completed.") + ` ${taskId} is in logs/.`);
+    console.log("Export it with: " + import_chalk9.default.cyan(`brainfile archive --task ${taskId} --to github|linear`));
+    return;
+  }
+  operationError(`Task not found: ${taskId}`);
+}
 async function archiveSingleFromLogsV2(filePath, board, taskId, destination, dryRun, parsedDest) {
   const dirs = (0, import_core.getV2Dirs)(filePath);
-  const logPath = path10.join(dirs.logsDir, (0, import_core15.taskFileName)(taskId));
+  const logPath = path10.join(dirs.logsDir, (0, import_core14.taskFileName)(taskId));
   if (!fs7.existsSync(logPath)) {
     operationError(`Task not found in logs: ${taskId}`);
     return;
@@ -5004,7 +5033,7 @@ async function archiveAllFromLogsV2(filePath, board, destination, dryRun) {
     return;
   }
   const dirs = (0, import_core.getV2Dirs)(filePath);
-  const logDocs = (0, import_core15.readTasksDir)(dirs.logsDir);
+  const logDocs = (0, import_core14.readTasksDir)(dirs.logsDir);
   if (logDocs.length === 0) {
     console.log("No completed tasks in logs/ to export.");
     return;
@@ -5044,7 +5073,7 @@ async function archiveAllFromLogsV2(filePath, board, destination, dryRun) {
           state: "closed"
         });
         if (result.success) {
-          const logPath = path10.join(dirs.logsDir, (0, import_core15.taskFileName)(task.id));
+          const logPath = path10.join(dirs.logsDir, (0, import_core14.taskFileName)(task.id));
           fs7.unlinkSync(logPath);
           console.log(import_chalk9.default.green("  OK") + ` #${result.issueNumber}`);
           successCount++;
@@ -5073,7 +5102,7 @@ async function archiveAllFromLogsV2(filePath, board, destination, dryRun) {
           stateName: "Done"
         });
         if (result.success) {
-          const logPath = path10.join(dirs.logsDir, (0, import_core15.taskFileName)(task.id));
+          const logPath = path10.join(dirs.logsDir, (0, import_core14.taskFileName)(task.id));
           fs7.unlinkSync(logPath);
           console.log(import_chalk9.default.green("  OK") + ` ${result.issueId}`);
           successCount++;
@@ -5234,13 +5263,13 @@ async function archiveToLinear(board, task, columnTitle, dryRun, parsedDest) {
 }
 
 // src/commands/restore.ts
-var import_core17 = __toESM(require_dist());
+var import_core16 = __toESM(require_dist());
 var import_chalk10 = __toESM(require_source());
 import * as fs9 from "fs";
 import * as path12 from "path";
 
 // src/utils/archive.ts
-var import_core16 = __toESM(require_dist());
+var import_core15 = __toESM(require_dist());
 import * as fs8 from "fs";
 import * as path11 from "path";
 function getArchivePath(filePath) {
@@ -5256,7 +5285,7 @@ function loadArchivedTasks(filePath) {
   }
   try {
     const archiveContent = fs8.readFileSync(archivePath, "utf-8");
-    const parseResult = import_core16.Brainfile.parseWithErrors(archiveContent);
+    const parseResult = import_core15.Brainfile.parseWithErrors(archiveContent);
     if (parseResult.board && Array.isArray(parseResult.board.archive)) {
       return { tasks: parseResult.board.archive, archivePath };
     }
@@ -5277,7 +5306,7 @@ function restoreFromArchive(filePath, taskId, toColumnId) {
   let archiveBoard;
   try {
     const archiveContent = fs8.readFileSync(archivePath, "utf-8");
-    const parseResult = import_core16.Brainfile.parseWithErrors(archiveContent);
+    const parseResult = import_core15.Brainfile.parseWithErrors(archiveContent);
     if (!parseResult.board) {
       return { success: false, error: "Failed to parse archive file" };
     }
@@ -5295,7 +5324,7 @@ function restoreFromArchive(filePath, taskId, toColumnId) {
   let board;
   try {
     const mainContent = fs8.readFileSync(filePath, "utf-8");
-    const parseResult = import_core16.Brainfile.parseWithErrors(mainContent);
+    const parseResult = import_core15.Brainfile.parseWithErrors(mainContent);
     if (!parseResult.board) {
       return { success: false, error: "Failed to parse main brainfile" };
     }
@@ -5313,9 +5342,9 @@ function restoreFromArchive(filePath, taskId, toColumnId) {
   targetColumn.tasks.push(task);
   archiveBoard.archive = archiveBoard.archive.filter((t) => t.id !== taskId);
   try {
-    const mainContent = import_core16.Brainfile.serialize(board);
+    const mainContent = import_core15.Brainfile.serialize(board);
     fs8.writeFileSync(filePath, mainContent, "utf-8");
-    const archiveContent = import_core16.Brainfile.serialize(archiveBoard);
+    const archiveContent = import_core15.Brainfile.serialize(archiveBoard);
     fs8.writeFileSync(archivePath, archiveContent, "utf-8");
   } catch (err) {
     return {
@@ -5340,7 +5369,7 @@ function restoreCommand(options) {
       fileNotFoundError(filePath);
     }
     const content = fs9.readFileSync(filePath, "utf-8");
-    const result = import_core17.Brainfile.parseWithErrors(content);
+    const result = import_core16.Brainfile.parseWithErrors(content);
     if (!result.board) {
       parseError(result.error);
     }
@@ -5362,9 +5391,9 @@ Archived tasks in ${path12.basename(archivePath)}:`));
       });
       process.exit(1);
     }
-    let targetColumn = (0, import_core17.findColumnById)(board, options.column);
+    let targetColumn = (0, import_core16.findColumnById)(board, options.column);
     if (!targetColumn) {
-      targetColumn = (0, import_core17.findColumnByName)(board, options.column);
+      targetColumn = (0, import_core16.findColumnByName)(board, options.column);
     }
     if (!targetColumn) {
       columnNotFoundError(options.column, board);
@@ -5386,7 +5415,7 @@ Archived tasks in ${path12.basename(archivePath)}:`));
 // src/commands/complete.ts
 var import_chalk11 = __toESM(require_source());
 import * as path13 from "path";
-var import_core18 = __toESM(require_dist());
+var import_core17 = __toESM(require_dist());
 function assertSafeTaskId2(taskId) {
   const trimmed = taskId.trim();
   if (!trimmed || trimmed !== taskId) {
@@ -5416,7 +5445,7 @@ function completeV2(filePath, taskId, force, logger) {
   }
   const { doc, filePath: taskPath } = found;
   const task = doc.task;
-  const result = (0, import_core18.completeTaskFile)(taskPath, dirs.logsDir, { legacyMode: true, force });
+  const result = (0, import_core17.completeTaskFile)(taskPath, dirs.logsDir, { force });
   if (!result.success) {
     if (result.incompleteChildren?.length) {
       logger.warn(import_chalk11.default.yellow(`Epic ${taskId} has incomplete child tasks:`));
@@ -5449,7 +5478,8 @@ function completeV2(filePath, taskId, force, logger) {
 // src/commands/log.ts
 var import_chalk12 = __toESM(require_source());
 import * as fs10 from "fs";
-var import_core19 = __toESM(require_dist());
+import * as path14 from "path";
+var import_core18 = __toESM(require_dist());
 function logCommand(options, logger = defaultLogger) {
   const filePath = resolveCliBrainfilePath(options.file);
   if (!fs10.existsSync(filePath)) {
@@ -5495,7 +5525,7 @@ function logNoteCommand(options, logger = defaultLogger) {
   const newLog = existingLog ? `${existingLog}
 ${entry}` : entry;
   const newBody = (0, import_core.composeBody)(existingDesc, newLog);
-  (0, import_core19.writeTaskFile)(taskPath, doc.task, newBody);
+  (0, import_core18.writeTaskFile)(taskPath, doc.task, newBody);
   logger.log(import_chalk12.default.green("Log entry added."));
   logger.log(import_chalk12.default.gray(`  Task: ${options.task}`));
   logger.log(import_chalk12.default.gray(`  ${entry}`));
@@ -5535,13 +5565,13 @@ function viewTaskLog(dirs, taskId, logger) {
   };
 }
 function searchLogs(dirs, query, logger) {
-  const logDocs = (0, import_core19.readTasksDir)(dirs.logsDir);
+  const logDocs = (0, import_core18.readTasksDir)(dirs.logsDir);
   const queryLower = query.toLowerCase();
   const matches = [];
   for (const doc of logDocs) {
     const task = doc.task;
     const logContent = (0, import_core.extractLog)(doc.body);
-    if ((0, import_core19.scoreTaskDocument)(doc, queryLower) > 0) {
+    if ((0, import_core18.scoreTaskDocument)(doc, queryLower) > 0) {
       let matchContext = "";
       if (task.title.toLowerCase().includes(queryLower)) {
         matchContext = `Title: ${task.title}`;
@@ -5581,39 +5611,132 @@ function searchLogs(dirs, query, logger) {
   };
 }
 function listRecentLogs(dirs, logger) {
-  const logDocs = (0, import_core19.readTasksDir)(dirs.logsDir);
-  logDocs.sort((a, b) => {
-    const aDate = a.task.completedAt || "";
-    const bDate = b.task.completedAt || "";
-    return bDate.localeCompare(aDate);
-  });
+  const logDocs = (0, import_core18.readTasksDir)(dirs.logsDir);
+  const seenIds = new Set(logDocs.map((d) => d.task.id));
+  const entries = logDocs.map((d) => ({ id: d.task.id, title: d.task.title, completedAt: d.task.completedAt }));
+  const ledgerPath = path14.join(dirs.logsDir, "ledger.jsonl");
+  if (fs10.existsSync(ledgerPath)) {
+    for (const line of fs10.readFileSync(ledgerPath, "utf-8").split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      try {
+        const record2 = JSON.parse(trimmed);
+        if (record2?.id && !seenIds.has(record2.id)) {
+          seenIds.add(record2.id);
+          entries.push({ id: record2.id, title: record2.title ?? record2.id, completedAt: record2.completedAt, ledgerOnly: true });
+        }
+      } catch {
+      }
+    }
+  }
+  entries.sort((a, b) => (b.completedAt || "").localeCompare(a.completedAt || ""));
   logger.log("");
-  logger.log(import_chalk12.default.bold(`Recently completed tasks (${logDocs.length})`));
+  logger.log(import_chalk12.default.bold(`Recently completed tasks (${entries.length})`));
   logger.log(import_chalk12.default.gray("\u2500".repeat(50)));
-  if (logDocs.length === 0) {
+  if (entries.length === 0) {
     logger.log(import_chalk12.default.gray("  No completed tasks found."));
   } else {
-    for (const doc of logDocs.slice(0, 20)) {
-      const task = doc.task;
-      logger.log(`  ${import_chalk12.default.gray(`[${task.id}]`)} ${import_chalk12.default.white(task.title)}`);
-      if (task.completedAt) {
-        logger.log(`    ${import_chalk12.default.gray("Completed:")} ${task.completedAt}`);
+    for (const entry of entries.slice(0, 20)) {
+      const marker = entry.ledgerOnly ? import_chalk12.default.gray(" (ledger only)") : "";
+      logger.log(`  ${import_chalk12.default.gray(`[${entry.id}]`)} ${import_chalk12.default.white(entry.title)}${marker}`);
+      if (entry.completedAt) {
+        logger.log(`    ${import_chalk12.default.gray("Completed:")} ${entry.completedAt}`);
       }
       logger.log("");
     }
   }
   return {
     success: true,
-    tasks: logDocs.map((doc) => ({
-      id: doc.task.id,
-      title: doc.task.title,
-      completedAt: doc.task.completedAt
-    }))
+    tasks: entries.map(({ id, title, completedAt }) => ({ id, title, completedAt }))
   };
 }
 
-// src/commands/search.ts
+// src/commands/brief.ts
 var import_chalk13 = __toESM(require_source());
+var import_core19 = __toESM(require_dist());
+import * as fs11 from "fs";
+var BRIEF_JSON_VERSION = "0.1";
+function briefCommand(options, logger = defaultLogger) {
+  try {
+    const result = runBrief(options);
+    if (options.json) {
+      logger.log(JSON.stringify(
+        { version: BRIEF_JSON_VERSION, kind: "brief", data: result },
+        null,
+        2
+      ));
+    } else {
+      renderBrief(result, logger);
+    }
+    return result;
+  } catch (error48) {
+    if (options.json && error48 instanceof CLIError) {
+      const payload = {
+        version: BRIEF_JSON_VERSION,
+        kind: "error",
+        error: {
+          code: "VALIDATION_ERROR",
+          message: error48.message,
+          ...error48.details ? { field: error48.details } : {}
+        }
+      };
+      process.stderr.write(`${JSON.stringify(payload, null, 2)}
+`);
+      process.exit(error48.exitCode ?? ExitCode.USER_ERROR);
+    }
+    throw error48;
+  }
+}
+function runBrief(options) {
+  const agent = options.agent?.trim();
+  if (!agent) {
+    throw missingRequired("--agent", "brainfile brief --agent <name>");
+  }
+  const filePath = resolveCliBrainfilePath(options.file);
+  if (!fs11.existsSync(filePath)) {
+    throw fileNotFound(filePath);
+  }
+  if (!(0, import_core.isV2)(filePath)) {
+    throw operationFailed(
+      "Brief requires v2 per-task file architecture. Run: brainfile migrate"
+    );
+  }
+  const dirs = (0, import_core.getV2Dirs)(filePath);
+  const peek = options.peek === true;
+  const state = (0, import_core19.readBriefState)(filePath, agent);
+  const result = (0, import_core19.buildBrief)(dirs, agent, { lastBriefAt: state.lastBriefAt });
+  if (!peek) {
+    (0, import_core19.writeBriefState)(filePath, agent, result.generatedAt);
+  }
+  return { ...result, peek };
+}
+function renderBrief(result, logger) {
+  const modeLabel = result.mode === "full" ? "first brief" : "since last brief";
+  const header = `${import_chalk13.default.bold(result.agent)} ${import_chalk13.default.gray("\xB7")} ${import_chalk13.default.gray(modeLabel)}`;
+  logger.log(header + (result.peek ? import_chalk13.default.gray("  (peek)") : ""));
+  if ((0, import_core19.isEmptyBrief)(result)) {
+    logger.log("");
+    logger.log(import_chalk13.default.gray(`  ${GLYPHS.success} Nothing new since your last brief.`));
+    return;
+  }
+  for (const lane of result.lanes) {
+    if (lane.items.length === 0) continue;
+    logger.log("");
+    logger.log(import_chalk13.default.bold(lane.label));
+    const width = Math.max(...lane.items.map((item) => laneKey(item.taskId).length));
+    for (const item of lane.items) {
+      const key = laneKey(item.taskId).padEnd(width);
+      const prefix = key.trim().length > 0 ? import_chalk13.default.cyan(key) : key;
+      logger.log(`  ${prefix}  ${item.text}  ${import_chalk13.default.gray(`(${item.why})`)}`);
+    }
+  }
+}
+function laneKey(taskId) {
+  return taskId ? `${GLYPHS.pointer} ${taskId}` : "";
+}
+
+// src/commands/search.ts
+var import_chalk14 = __toESM(require_source());
 var import_core20 = __toESM(require_dist());
 function searchCommand(options, logger = defaultLogger) {
   if (!options.query) {
@@ -5650,16 +5773,16 @@ function searchV2(filePath, query, column, logger) {
 }
 function displayResults(results, query, logger) {
   logger.log("");
-  logger.log(import_chalk13.default.bold(`Search: "${query}" (${results.length} results)`));
-  logger.log(import_chalk13.default.gray("\u2500".repeat(50)));
+  logger.log(import_chalk14.default.bold(`Search: "${query}" (${results.length} results)`));
+  logger.log(import_chalk14.default.gray("\u2500".repeat(50)));
   if (results.length === 0) {
-    logger.log(import_chalk13.default.gray("  No matching tasks found."));
+    logger.log(import_chalk14.default.gray("  No matching tasks found."));
   } else {
     for (const result of results) {
-      const location = result.isLog ? import_chalk13.default.yellow("(completed)") : import_chalk13.default.cyan(result.column || "");
-      logger.log(`  ${import_chalk13.default.gray(`[${result.id}]`)} ${import_chalk13.default.white(result.title)} ${location}`);
+      const location = result.isLog ? import_chalk14.default.yellow("(completed)") : import_chalk14.default.cyan(result.column || "");
+      logger.log(`  ${import_chalk14.default.gray(`[${result.id}]`)} ${import_chalk14.default.white(result.title)} ${location}`);
       if (result.completedAt) {
-        logger.log(`    ${import_chalk13.default.gray("Completed:")} ${result.completedAt}`);
+        logger.log(`    ${import_chalk14.default.gray("Completed:")} ${result.completedAt}`);
       }
     }
   }
@@ -5667,7 +5790,7 @@ function displayResults(results, query, logger) {
 }
 
 // src/commands/auth.ts
-var import_chalk14 = __toESM(require_source());
+var import_chalk15 = __toESM(require_source());
 import * as readline from "readline";
 async function promptSetDefaultDestination(destination) {
   const currentConfig = getArchiveConfig();
@@ -5680,14 +5803,14 @@ async function promptSetDefaultDestination(destination) {
   });
   const currentDefault = currentConfig.default || "local";
   console.log("");
-  console.log(`Current default archive destination: ${import_chalk14.default.cyan(currentDefault)}`);
+  console.log(`Current default archive destination: ${import_chalk15.default.cyan(currentDefault)}`);
   const answer = await new Promise((resolve6) => {
     rl.question(`Set ${destination} as default? [y/N]: `, resolve6);
   });
   rl.close();
   if (answer.toLowerCase() === "y" || answer.toLowerCase() === "yes") {
     setArchiveDefault(destination);
-    console.log(import_chalk14.default.green("\u2713") + ` Default archive destination set to ${import_chalk14.default.cyan(destination)}`);
+    console.log(import_chalk15.default.green("\u2713") + ` Default archive destination set to ${import_chalk15.default.cyan(destination)}`);
   }
 }
 async function githubAuthCommand(options) {
@@ -5697,11 +5820,11 @@ async function githubAuthCommand(options) {
       usePAT: !!options.token
     });
     if (!result.success) {
-      console.log(import_chalk14.default.red("\u2717") + ` Authentication failed: ${result.error}`);
+      console.log(import_chalk15.default.red("\u2717") + ` Authentication failed: ${result.error}`);
       process.exit(1);
     }
     console.log("");
-    console.log(import_chalk14.default.green("GitHub authentication complete!"));
+    console.log(import_chalk15.default.green("GitHub authentication complete!"));
   } catch (error48) {
     handleError(error48);
   }
@@ -5712,10 +5835,10 @@ async function linearAuthCommand(options) {
       console.log("");
       console.log("Linear authentication requires an API key.");
       console.log("");
-      console.log(`Get your API key from: ${import_chalk14.default.underline("https://linear.app/settings/api")}`);
+      console.log(`Get your API key from: ${import_chalk15.default.underline("https://linear.app/settings/api")}`);
       console.log("");
       console.log("Then run:");
-      console.log(import_chalk14.default.cyan("  brainfile auth linear --token <your-api-key>"));
+      console.log(import_chalk15.default.cyan("  brainfile auth linear --token <your-api-key>"));
       console.log("");
       return;
     }
@@ -5723,23 +5846,23 @@ async function linearAuthCommand(options) {
       token: options.token
     });
     if (!result.success) {
-      console.log(import_chalk14.default.red("\u2717") + ` Authentication failed: ${result.error}`);
+      console.log(import_chalk15.default.red("\u2717") + ` Authentication failed: ${result.error}`);
       process.exit(1);
     }
     const teams = await getLinearTeams();
     if (teams.length === 0) {
-      console.log(import_chalk14.default.yellow("\u26A0") + " No teams found. You may need to configure a team later.");
+      console.log(import_chalk15.default.yellow("\u26A0") + " No teams found. You may need to configure a team later.");
     } else if (teams.length === 1) {
       const team = teams[0];
       setLinearConfig({ teamId: team.id });
-      console.log(import_chalk14.default.green("\u2713") + ` Default team set to ${import_chalk14.default.cyan(team.name)} (${team.key})`);
+      console.log(import_chalk15.default.green("\u2713") + ` Default team set to ${import_chalk15.default.cyan(team.name)} (${team.key})`);
       await promptSetDefaultDestination("linear");
     } else {
       console.log("");
       console.log("Multiple teams found. Select a default team for archiving:");
       console.log("");
       teams.forEach((team, index) => {
-        console.log(`  ${import_chalk14.default.cyan(index + 1)}) ${team.name} (${team.key})`);
+        console.log(`  ${import_chalk15.default.cyan(index + 1)}) ${team.name} (${team.key})`);
       });
       console.log("");
       const rl = readline.createInterface({
@@ -5755,15 +5878,15 @@ async function linearAuthCommand(options) {
         const team = teams[selection - 1];
         setLinearConfig({ teamId: team.id });
         console.log("");
-        console.log(import_chalk14.default.green("\u2713") + ` Default team set to ${import_chalk14.default.cyan(team.name)} (${team.key})`);
+        console.log(import_chalk15.default.green("\u2713") + ` Default team set to ${import_chalk15.default.cyan(team.name)} (${team.key})`);
         await promptSetDefaultDestination("linear");
       } else {
-        console.log(import_chalk14.default.yellow("\u26A0") + " Invalid selection. You can set a team later with:");
-        console.log(import_chalk14.default.cyan("  brainfile config set archive.linear.teamId <team-id>"));
+        console.log(import_chalk15.default.yellow("\u26A0") + " Invalid selection. You can set a team later with:");
+        console.log(import_chalk15.default.cyan("  brainfile config set archive.linear.teamId <team-id>"));
       }
     }
     console.log("");
-    console.log(import_chalk14.default.green("Linear authentication complete!"));
+    console.log(import_chalk15.default.green("Linear authentication complete!"));
   } catch (error48) {
     handleError(error48);
   }
@@ -5772,25 +5895,25 @@ async function authStatusCommand() {
   try {
     const status = await authStore.getStatus();
     console.log("");
-    console.log(import_chalk14.default.bold("Authentication Status"));
+    console.log(import_chalk15.default.bold("Authentication Status"));
     console.log("");
     if (status.github.authenticated) {
       const source = status.github.source;
-      const username = status.github.username ? ` as ${import_chalk14.default.cyan("@" + status.github.username)}` : "";
+      const username = status.github.username ? ` as ${import_chalk15.default.cyan("@" + status.github.username)}` : "";
       console.log(
-        import_chalk14.default.green("\u2713") + ` GitHub: authenticated${username} ${import_chalk14.default.gray(`(${source})`)}`
+        import_chalk15.default.green("\u2713") + ` GitHub: authenticated${username} ${import_chalk15.default.gray(`(${source})`)}`
       );
     } else {
-      console.log(import_chalk14.default.red("\u2717") + " GitHub: not configured");
+      console.log(import_chalk15.default.red("\u2717") + " GitHub: not configured");
     }
     if (status.linear.authenticated) {
       const source = status.linear.source;
-      const username = status.linear.username ? ` as ${import_chalk14.default.cyan(status.linear.username)}` : "";
+      const username = status.linear.username ? ` as ${import_chalk15.default.cyan(status.linear.username)}` : "";
       console.log(
-        import_chalk14.default.green("\u2713") + ` Linear: authenticated${username} ${import_chalk14.default.gray(`(${source})`)}`
+        import_chalk15.default.green("\u2713") + ` Linear: authenticated${username} ${import_chalk15.default.gray(`(${source})`)}`
       );
     } else {
-      console.log(import_chalk14.default.red("\u2717") + " Linear: not configured");
+      console.log(import_chalk15.default.red("\u2717") + " Linear: not configured");
     }
     console.log("");
   } catch (error48) {
@@ -5802,7 +5925,7 @@ async function authLogoutCommand(provider, options) {
     if (options?.all || provider === "all") {
       await logoutGitHub();
       await logoutLinear();
-      console.log(import_chalk14.default.green("\u2713") + " Logged out from all providers");
+      console.log(import_chalk15.default.green("\u2713") + " Logged out from all providers");
       return;
     }
     if (!provider) {
@@ -5817,14 +5940,14 @@ async function authLogoutCommand(provider, options) {
     switch (provider.toLowerCase()) {
       case "github":
         await logoutGitHub();
-        console.log(import_chalk14.default.green("\u2713") + " Logged out from GitHub");
+        console.log(import_chalk15.default.green("\u2713") + " Logged out from GitHub");
         break;
       case "linear":
         await logoutLinear();
-        console.log(import_chalk14.default.green("\u2713") + " Logged out from Linear");
+        console.log(import_chalk15.default.green("\u2713") + " Logged out from Linear");
         break;
       default:
-        console.log(import_chalk14.default.red("\u2717") + ` Unknown provider: ${provider}`);
+        console.log(import_chalk15.default.red("\u2717") + ` Unknown provider: ${provider}`);
         console.log("Valid providers: github, linear");
         process.exit(1);
     }
@@ -5835,7 +5958,7 @@ async function authLogoutCommand(provider, options) {
 
 // src/commands/subtask.ts
 var import_core21 = __toESM(require_dist());
-var import_chalk15 = __toESM(require_source());
+var import_chalk16 = __toESM(require_source());
 function subtaskCommand(options) {
   try {
     if (!options.task) {
@@ -5859,7 +5982,7 @@ function subtaskCommandV2(options, brainfilePath) {
   const dirs = (0, import_core.getV2Dirs)(brainfilePath);
   const found = (0, import_core.findV2Task)(dirs, options.task, true);
   if (!found) {
-    console.error(import_chalk15.default.red(`Error: Task ${options.task} not found`));
+    console.error(import_chalk16.default.red(`Error: Task ${options.task} not found`));
     process.exit(1);
   }
   const { doc, filePath } = found;
@@ -5870,7 +5993,7 @@ function subtaskCommandV2(options, brainfilePath) {
       validationError(result.error || `Failed to add subtask to ${options.task}`);
     }
     const added = result.affected[0];
-    console.log(import_chalk15.default.green(`Subtask added: ${added.id} - ${added.title}`));
+    console.log(import_chalk16.default.green(`Subtask added: ${added.id} - ${added.title}`));
     return;
   }
   if (!task.subtasks || task.subtasks.length === 0) {
@@ -5882,7 +6005,7 @@ function subtaskCommandV2(options, brainfilePath) {
       subtaskNotFoundError(options.delete, task);
     }
     const deleted = result.affected[0];
-    console.log(import_chalk15.default.green(`Subtask deleted: ${deleted.id} - ${deleted.title}`));
+    console.log(import_chalk16.default.green(`Subtask deleted: ${deleted.id} - ${deleted.title}`));
     return;
   }
   if (options.update) {
@@ -5894,7 +6017,7 @@ function subtaskCommandV2(options, brainfilePath) {
     if (!result.success || !result.affected?.length) {
       subtaskNotFoundError(options.update, task);
     }
-    console.log(import_chalk15.default.green(`Subtask updated: ${options.update}
+    console.log(import_chalk16.default.green(`Subtask updated: ${options.update}
   "${oldTitle}" \u2192 "${options.title}"`));
     return;
   }
@@ -5904,7 +6027,7 @@ function subtaskCommandV2(options, brainfilePath) {
       subtaskNotFoundError(options.toggle, task);
     }
     const newStatus = result.affected[0].completed ? "completed" : "incomplete";
-    console.log(import_chalk15.default.green(`Subtask ${options.toggle} marked as ${newStatus}`));
+    console.log(import_chalk16.default.green(`Subtask ${options.toggle} marked as ${newStatus}`));
     return;
   }
 }
@@ -6733,10 +6856,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema2) {
   return mergeDefs(schema2._zod.def);
 }
-function getElementAtPath(obj, path20) {
-  if (!path20)
+function getElementAtPath(obj, path21) {
+  if (!path21)
     return obj;
-  return path20.reduce((acc, key) => acc?.[key], obj);
+  return path21.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -7119,11 +7242,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path20, issues) {
+function prefixIssues(path21, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path20);
+    iss.path.unshift(path21);
     return iss;
   });
 }
@@ -7306,7 +7429,7 @@ function formatError(error48, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error48, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error49, path20 = []) => {
+  const processError = (error49, path21 = []) => {
     var _a2, _b;
     for (const issue2 of error49.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -7316,7 +7439,7 @@ function treeifyError(error48, mapper = (issue2) => issue2.message) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path20, ...issue2.path];
+        const fullpath = [...path21, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -7348,8 +7471,8 @@ function treeifyError(error48, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path20 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path20) {
+  const path21 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path21) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -19326,13 +19449,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path20 = ref.slice(1).split("/").filter(Boolean);
-  if (path20.length === 0) {
+  const path21 = ref.slice(1).split("/").filter(Boolean);
+  if (path21.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path20[0] === defsKey) {
-    const key = path20[1];
+  if (path21[0] === defsKey) {
+    const key = path21[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -23294,9 +23417,9 @@ var rev2026Codec = {
     });
     const parsed = buildSchemas2026().RequestMetaEnvelopeSchema.safeParse(meta3);
     if (!parsed.success) for (const issue2 of parsed.error.issues) {
-      const path20 = issue2.path.map(String);
-      const key = path20.length > 0 ? path20.join(".") : "_meta";
-      if (path20.length === 1 && issues.some((existing) => existing.key === key && existing.problem === "missing")) continue;
+      const path21 = issue2.path.map(String);
+      const key = path21.length > 0 ? path21.join(".") : "_meta";
+      if (path21.length === 1 && issues.some((existing) => existing.key === key && existing.problem === "missing")) continue;
       issues.push({
         key,
         problem: issue2.message
@@ -23617,29 +23740,29 @@ var PERMITTED_X_MCP_HEADER_TYPES = /* @__PURE__ */ new Set([
 function scanXMcpHeaderDeclarations(inputSchema) {
   const declarations = [];
   const seenLower = /* @__PURE__ */ new Map();
-  const visit = (node, path20, reachable) => {
+  const visit = (node, path21, reachable) => {
     if (node === null || typeof node !== "object") return void 0;
     const schema2 = node;
     if (X_MCP_HEADER_KEY in schema2) {
-      if (!reachable || path20.length === 0) return `${pathName(path20)}: x-mcp-header is only permitted on properties statically reachable via a chain of 'properties' keys (not under items, additionalProperties, oneOf/anyOf/allOf/not, if/then/else, or $ref)`;
+      if (!reachable || path21.length === 0) return `${pathName(path21)}: x-mcp-header is only permitted on properties statically reachable via a chain of 'properties' keys (not under items, additionalProperties, oneOf/anyOf/allOf/not, if/then/else, or $ref)`;
       const raw = schema2[X_MCP_HEADER_KEY];
-      if (typeof raw !== "string" || raw.length === 0) return `${pathName(path20)}: x-mcp-header MUST be a non-empty string`;
-      if (!RFC9110_TOKEN.test(raw)) return `${pathName(path20)}: x-mcp-header '${raw}' is not a valid RFC 9110 token (no spaces, control characters or HTTP delimiters)`;
+      if (typeof raw !== "string" || raw.length === 0) return `${pathName(path21)}: x-mcp-header MUST be a non-empty string`;
+      if (!RFC9110_TOKEN.test(raw)) return `${pathName(path21)}: x-mcp-header '${raw}' is not a valid RFC 9110 token (no spaces, control characters or HTTP delimiters)`;
       const type2 = typeof schema2.type === "string" ? schema2.type : void 0;
-      if (type2 === void 0 || !PERMITTED_X_MCP_HEADER_TYPES.has(type2)) return `${pathName(path20)}: x-mcp-header is only permitted on primitive-typed properties (string, integer, boolean); got ${type2 ?? "<none>"}`;
+      if (type2 === void 0 || !PERMITTED_X_MCP_HEADER_TYPES.has(type2)) return `${pathName(path21)}: x-mcp-header is only permitted on primitive-typed properties (string, integer, boolean); got ${type2 ?? "<none>"}`;
       const lower = raw.toLowerCase();
       const prior = seenLower.get(lower);
       if (prior !== void 0) return `x-mcp-header '${raw}' is not case-insensitively unique (also declared as '${prior}')`;
       seenLower.set(lower, raw);
       declarations.push({
-        path: path20,
+        path: path21,
         headerName: raw,
         type: type2
       });
     }
     const properties = schema2.properties;
     if (properties !== null && typeof properties === "object") for (const [key, child] of Object.entries(properties)) {
-      const fault$1 = visit(child, [...path20, key], reachable);
+      const fault$1 = visit(child, [...path21, key], reachable);
       if (fault$1 !== void 0) return fault$1;
     }
     for (const k of NON_REACHABLE_SUBSCHEMA_KEYWORDS) {
@@ -23647,7 +23770,7 @@ function scanXMcpHeaderDeclarations(inputSchema) {
       if (sub === void 0) continue;
       const branches = Array.isArray(sub) ? sub : sub !== null && typeof sub === "object" && OBJECT_VALUED_SUBSCHEMA_KEYWORDS.has(k) ? Object.values(sub) : [sub];
       for (const branch of branches) {
-        const fault$1 = visit(branch, [...path20, `<${k}>`], false);
+        const fault$1 = visit(branch, [...path21, `<${k}>`], false);
         if (fault$1 !== void 0) return fault$1;
       }
     }
@@ -23687,8 +23810,8 @@ var OBJECT_VALUED_SUBSCHEMA_KEYWORDS = /* @__PURE__ */ new Set([
   "$defs",
   "definitions"
 ]);
-function pathName(path20) {
-  return path20.length === 0 ? "<root>" : path20.join(".");
+function pathName(path21) {
+  return path21.length === 0 ? "<root>" : path21.join(".");
 }
 var HEADER_MISMATCH_ERROR_CODE = -32020;
 var INBOUND_VALIDATION_LADDER = [
@@ -23977,7 +24100,7 @@ var PROPERTY_KEYS_BY_TYPE = {
   array: shapeKeys([UntitledMultiSelectEnumSchemaSchema, TitledMultiSelectEnumSchemaSchema])
 };
 var SUPPORTED_STRING_FORMATS = new Set(StringSchemaSchema.shape.format.unwrap().options);
-function walkProperty(node, path20, vendor, unsupported) {
+function walkProperty(node, path21, vendor, unsupported) {
   if (!isJsonObject(node)) return node;
   const allowedKeys = typeof node.type === "string" && Object.hasOwn(PROPERTY_KEYS_BY_TYPE, node.type) ? PROPERTY_KEYS_BY_TYPE[node.type] : void 0;
   if (allowedKeys === void 0) return node;
@@ -23985,8 +24108,8 @@ function walkProperty(node, path20, vendor, unsupported) {
   for (const [key, value] of Object.entries(node)) if (allowedKeys.has(key) || isAnnotationOnlyJsonSchemaKeyword(key)) pruned[key] = value;
   else if (key === "pattern" && node.type === "string" && typeof node.format === "string") {
     if (!SUPPORTED_STRING_FORMATS.has(node.format)) pruned[key] = value;
-    else if (typeof value !== "string" || !isLibraryFormatPattern(node.format, value, vendor)) unsupported.push(`${path20}.${key}`);
-  } else unsupported.push(`${path20}.${key}`);
+    else if (typeof value !== "string" || !isLibraryFormatPattern(node.format, value, vendor)) unsupported.push(`${path21}.${key}`);
+  } else unsupported.push(`${path21}.${key}`);
   return pruned;
 }
 function walkRequestedSchema(converted, vendor) {
@@ -24003,11 +24126,11 @@ function describeUnsupportedProperties(pruned, fallback) {
   const offenders = Object.entries(pruned.properties).filter(([, node]) => !parseSchema(PrimitiveSchemaDefinitionSchema, node).success).map(([name]) => `properties.${name}`);
   return offenders.length > 0 ? offenders.join(", ") : fallback;
 }
-function findDroppedConstraintPaths(original, parsed, path20 = "") {
-  if (Array.isArray(original) && Array.isArray(parsed)) return original.flatMap((item, index) => findDroppedConstraintPaths(item, parsed[index], `${path20}[${index}]`));
+function findDroppedConstraintPaths(original, parsed, path21 = "") {
+  if (Array.isArray(original) && Array.isArray(parsed)) return original.flatMap((item, index) => findDroppedConstraintPaths(item, parsed[index], `${path21}[${index}]`));
   if (!isJsonObject(original) || !isJsonObject(parsed)) return [];
   return Object.entries(original).flatMap(([key, value]) => {
-    const childPath = path20 ? `${path20}.${key}` : key;
+    const childPath = path21 ? `${path21}.${key}` : key;
     if (!Object.prototype.hasOwnProperty.call(parsed, key)) return isAnnotationOnlyJsonSchemaKeyword(key) ? [] : [childPath];
     return findDroppedConstraintPaths(value, parsed[key], childPath);
   });
@@ -28085,8 +28208,8 @@ var require_utils = /* @__PURE__ */ __commonJSMin(((exports, module) => {
     for (let i = 0; i < str2.length; i++) if (str2[i] === token) ind++;
     return ind;
   }
-  function removeDotSegments(path20) {
-    let input = path20;
+  function removeDotSegments(path21) {
+    let input = path21;
     const output = [];
     let nextSlash = -1;
     let len = 0;
@@ -28239,8 +28362,8 @@ var require_schemes = /* @__PURE__ */ __commonJSMin(((exports, module) => {
       wsComponent.secure = void 0;
     }
     if (wsComponent.resourceName) {
-      const [path20, query] = wsComponent.resourceName.split("?");
-      wsComponent.path = path20 && path20 !== "/" ? path20 : void 0;
+      const [path21, query] = wsComponent.resourceName.split("?");
+      wsComponent.path = path21 && path21 !== "/" ? path21 : void 0;
       wsComponent.query = query;
       wsComponent.resourceName = void 0;
     }
@@ -28889,7 +29012,7 @@ var require_core$3 = /* @__PURE__ */ __commonJSMin(((exports) => {
       } else throw new Error("invalid addKeywords parameters");
       checkKeyword.call(this, keyword, def);
       if (!def) {
-        (0, util_1.eachItem)(keyword, (kwd) => addRule2.call(this, kwd));
+        (0, util_1.eachItem)(keyword, (kwd) => addRule.call(this, kwd));
         return this;
       }
       keywordMetaschema.call(this, def);
@@ -28898,7 +29021,7 @@ var require_core$3 = /* @__PURE__ */ __commonJSMin(((exports) => {
         type: (0, dataType_1.getJSONTypes)(def.type),
         schemaType: (0, dataType_1.getJSONTypes)(def.schemaType)
       };
-      (0, util_1.eachItem)(keyword, definition.type.length === 0 ? (k) => addRule2.call(this, k, definition) : (k) => definition.type.forEach((t) => addRule2.call(this, k, definition, t)));
+      (0, util_1.eachItem)(keyword, definition.type.length === 0 ? (k) => addRule.call(this, k, definition) : (k) => definition.type.forEach((t) => addRule.call(this, k, definition, t)));
       return this;
     }
     getKeyword(keyword) {
@@ -29063,7 +29186,7 @@ var require_core$3 = /* @__PURE__ */ __commonJSMin(((exports) => {
     if (!def) return;
     if (def.$data && !("code" in def || "validate" in def)) throw new Error('$data keyword must have "code" or "validate" function');
   }
-  function addRule2(keyword, definition, dataType) {
+  function addRule(keyword, definition, dataType) {
     var _a2;
     const post = definition === null || definition === void 0 ? void 0 : definition.post;
     if (dataType && post) throw new Error('keyword with "post" flag cannot have "type"');
@@ -34320,18 +34443,18 @@ function toError(value) {
 }
 
 // src/commands/mcp.ts
-var import_core43 = __toESM(require_dist());
+var import_core44 = __toESM(require_dist());
 
 // src/mcp/helpers.ts
 var import_core29 = __toESM(require_dist());
-import * as fs11 from "fs";
-import * as path14 from "path";
+import * as fs12 from "fs";
+import * as path15 from "path";
 function resolveBrainfile(filePath) {
-  return path14.resolve(filePath);
+  return path15.resolve(filePath);
 }
 function requireV2(filePath) {
   const resolvedPath = resolveBrainfile(filePath);
-  if (!fs11.existsSync(resolvedPath)) {
+  if (!fs12.existsSync(resolvedPath)) {
     return { content: [{ type: "text", text: `Error: File not found: ${resolvedPath}` }], isError: true };
   }
   if (!(0, import_core29.isV2)(resolvedPath)) {
@@ -34353,20 +34476,237 @@ function mcpStructuredError(message, field, value) {
   };
 }
 function findGitRoot(startDir) {
-  let currentDir = path14.resolve(startDir);
-  const root = path14.parse(currentDir).root;
+  let currentDir = path15.resolve(startDir);
+  const root = path15.parse(currentDir).root;
   while (currentDir !== root) {
-    const gitPath = path14.join(currentDir, ".git");
-    if (fs11.existsSync(gitPath)) {
+    const gitPath = path15.join(currentDir, ".git");
+    if (fs12.existsSync(gitPath)) {
       return currentDir;
     }
-    const parentDir = path14.dirname(currentDir);
+    const parentDir = path15.dirname(currentDir);
     if (parentDir === currentDir) break;
     currentDir = parentDir;
   }
   return null;
 }
 
+// src/mcp/schemas.ts
+var taskSummaryShape = {
+  id: external_exports.string(),
+  title: external_exports.string(),
+  priority: external_exports.string().optional(),
+  tags: external_exports.array(external_exports.string()).optional(),
+  assignee: external_exports.string().optional()
+};
+var subtaskSchema = external_exports.looseObject({
+  id: external_exports.string(),
+  title: external_exports.string(),
+  completed: external_exports.boolean().optional()
+});
+var listTasksOutputSchema = external_exports.object({
+  tasks: external_exports.array(external_exports.object({ ...taskSummaryShape, column: external_exports.string() })),
+  count: external_exports.number()
+});
+var getTaskOutputSchema = external_exports.looseObject({
+  id: external_exports.string(),
+  title: external_exports.string(),
+  column: external_exports.string(),
+  type: external_exports.string().optional(),
+  description: external_exports.string().optional(),
+  parentId: external_exports.string().optional(),
+  dependsOn: external_exports.array(external_exports.string()).optional(),
+  blockedBy: external_exports.array(external_exports.string()).optional(),
+  relatedFiles: external_exports.array(external_exports.string()).optional(),
+  assignee: external_exports.string().optional(),
+  tags: external_exports.array(external_exports.string()).optional(),
+  priority: external_exports.string().optional(),
+  dueDate: external_exports.string().optional(),
+  subtasks: external_exports.array(subtaskSchema).optional(),
+  contract: external_exports.looseObject({}).optional(),
+  createdAt: external_exports.string().optional(),
+  updatedAt: external_exports.string().optional(),
+  completedAt: external_exports.string().optional(),
+  position: external_exports.number().optional(),
+  archived: external_exports.boolean().optional()
+});
+var searchTaskViewSchema = external_exports.object({
+  id: external_exports.string(),
+  title: external_exports.string(),
+  completedAt: external_exports.string().optional(),
+  isLog: external_exports.boolean(),
+  description: external_exports.string().optional(),
+  log: external_exports.string().optional()
+});
+var searchRecentSchema = external_exports.object({
+  logs: external_exports.array(external_exports.object({
+    id: external_exports.string(),
+    title: external_exports.string(),
+    completedAt: external_exports.string().optional()
+  })),
+  count: external_exports.number()
+});
+var searchResultsSchema = external_exports.object({
+  results: external_exports.array(external_exports.object({
+    ...taskSummaryShape,
+    column: external_exports.string().optional(),
+    score: external_exports.number(),
+    isLog: external_exports.boolean().optional()
+  })),
+  count: external_exports.number()
+});
+var searchOutputSchema = external_exports.union([
+  searchTaskViewSchema,
+  searchRecentSchema,
+  searchResultsSchema
+]);
+var taskAddOutputSchema = external_exports.object({
+  id: external_exports.string(),
+  title: external_exports.string()
+});
+var taskMoveOutputSchema = external_exports.object({
+  success: external_exports.boolean(),
+  successCount: external_exports.number(),
+  failureCount: external_exports.number(),
+  results: external_exports.array(external_exports.object({
+    taskId: external_exports.string(),
+    success: external_exports.boolean(),
+    message: external_exports.string().optional(),
+    warning: external_exports.string().optional(),
+    error: external_exports.string().optional()
+  }))
+});
+var taskPatchOutputSchema = external_exports.object({
+  success: external_exports.boolean(),
+  successCount: external_exports.number(),
+  failureCount: external_exports.number(),
+  results: external_exports.array(external_exports.object({
+    taskId: external_exports.string(),
+    success: external_exports.boolean(),
+    error: external_exports.string().optional()
+  }))
+});
+var taskDeleteOutputSchema = external_exports.object({
+  id: external_exports.string(),
+  deleted: external_exports.literal(true)
+});
+var subtaskOutputSchema = external_exports.discriminatedUnion("action", [
+  external_exports.object({
+    action: external_exports.literal("add"),
+    added: external_exports.array(external_exports.object({ id: external_exports.string(), title: external_exports.string() })),
+    count: external_exports.number()
+  }),
+  external_exports.object({
+    action: external_exports.literal("delete"),
+    deleted: external_exports.array(external_exports.string()),
+    missing: external_exports.array(external_exports.string()),
+    count: external_exports.number()
+  }),
+  external_exports.object({
+    action: external_exports.literal("toggle"),
+    updated: external_exports.array(external_exports.object({ id: external_exports.string(), completed: external_exports.boolean().optional() })),
+    count: external_exports.number()
+  }),
+  external_exports.object({
+    action: external_exports.literal("update"),
+    updated: external_exports.array(external_exports.object({ id: external_exports.string(), title: external_exports.string() })),
+    count: external_exports.number()
+  })
+]);
+var deliverableSchema = external_exports.looseObject({
+  // Hand-edited YAML often omits `type` (path-only deliverables). Required here
+  // would fail output validation on a successful validate after the task was
+  // already completed.
+  type: external_exports.string().optional(),
+  path: external_exports.string(),
+  description: external_exports.string().optional()
+});
+var contractOutputSchema = external_exports.discriminatedUnion("action", [
+  external_exports.object({
+    action: external_exports.literal("attach"),
+    task: external_exports.string(),
+    status: external_exports.string()
+  }),
+  external_exports.object({
+    action: external_exports.literal("pickup"),
+    task: external_exports.string(),
+    markdown: external_exports.string()
+  }),
+  external_exports.object({
+    action: external_exports.literal("deliver"),
+    task: external_exports.string()
+  }),
+  external_exports.object({
+    action: external_exports.literal("validate"),
+    ok: external_exports.boolean(),
+    status: external_exports.string(),
+    deliverables: external_exports.array(external_exports.looseObject({
+      deliverable: deliverableSchema,
+      ok: external_exports.boolean(),
+      resolvedPath: external_exports.string().optional(),
+      error: external_exports.string().optional()
+    })),
+    commands: external_exports.array(external_exports.looseObject({
+      command: external_exports.string(),
+      exitCode: external_exports.number(),
+      stdout: external_exports.string(),
+      stderr: external_exports.string()
+    })),
+    warnings: external_exports.array(external_exports.looseObject({
+      command: external_exports.string(),
+      message: external_exports.string()
+    }))
+  }),
+  external_exports.object({
+    action: external_exports.literal("graph"),
+    attached: external_exports.array(external_exports.string()),
+    count: external_exports.number(),
+    order: external_exports.array(external_exports.string()),
+    graph: external_exports.string()
+  }),
+  external_exports.object({
+    action: external_exports.literal("activate"),
+    activated: external_exports.array(external_exports.string()),
+    count: external_exports.number()
+  })
+]);
+var taskCompleteOutputSchema = external_exports.discriminatedUnion("destination", [
+  external_exports.object({
+    destination: external_exports.literal("local"),
+    taskId: external_exports.string(),
+    completedAt: external_exports.string().optional(),
+    archived: external_exports.boolean()
+  }),
+  external_exports.object({
+    destination: external_exports.literal("github"),
+    taskId: external_exports.string(),
+    issueNumber: external_exports.number().optional(),
+    issueUrl: external_exports.string().optional()
+  }),
+  external_exports.object({
+    destination: external_exports.literal("linear"),
+    taskId: external_exports.string(),
+    issueId: external_exports.string().optional(),
+    issueUrl: external_exports.string().optional()
+  })
+]);
+var briefOutputSchema = external_exports.object({
+  agent: external_exports.string(),
+  mode: external_exports.enum(["full", "delta"]),
+  generatedAt: external_exports.string(),
+  lastBriefAt: external_exports.string().nullable(),
+  peek: external_exports.boolean(),
+  lanes: external_exports.array(external_exports.object({
+    id: external_exports.string(),
+    label: external_exports.string(),
+    items: external_exports.array(external_exports.object({
+      taskId: external_exports.string().optional(),
+      text: external_exports.string(),
+      why: external_exports.string(),
+      at: external_exports.string().optional()
+    }))
+  }))
+});
+
 // src/mcp/tools/list_tasks_tool.ts
 function registerListTasksTool(server, defaultFile) {
   server.registerTool(
@@ -34379,7 +34719,8 @@ function registerListTasksTool(server, defaultFile) {
         column: external_exports.string().optional().describe("Filter by column ID or name"),
         tag: external_exports.string().optional().describe("Filter by tag"),
         type: external_exports.string().optional().describe("Filter by document type (e.g., epic, adr, plan). Only returns tasks matching this type.")
-      })
+      }),
+      outputSchema: listTasksOutputSchema
     },
     async ({ file: file2, column, tag, type: filterType }) => {
       const filePath = file2 || defaultFile;
@@ -34399,10 +34740,14 @@ function registerListTasksTool(server, defaultFile) {
             const taskType = task.type || "task";
             if (taskType !== filterType) continue;
           }
-          tasks.push({ id: task.id, title: task.title, column: col.title, priority: task.priority, tags: task.tags, assignee: task.assignee });
+          tasks.push({ id: task.id, title: task.title, column: col.id, priority: task.priority, tags: task.tags, assignee: task.assignee });
         }
       }
-      return { content: [{ type: "text", text: JSON.stringify({ tasks, count: tasks.length }, null, 2) }] };
+      const output = { tasks, count: tasks.length };
+      return {
+        content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+        structuredContent: output
+      };
     }
   );
 }
@@ -34417,7 +34762,8 @@ function registerGetTaskTool(server, defaultFile) {
       inputSchema: external_exports.object({
         file: external_exports.string().optional().describe("Path to brainfile.md (default: brainfile.md)"),
         task: external_exports.string().describe("Task ID to retrieve")
-      })
+      }),
+      outputSchema: getTaskOutputSchema
     },
     async ({ file: file2, task }) => {
       const filePath = file2 || defaultFile;
@@ -34436,7 +34782,10 @@ function registerGetTaskTool(server, defaultFile) {
         column: isLog ? "Completed" : doc.task.column || "unknown",
         ...isLog && { archived: true }
       };
-      return { content: [{ type: "text", text: JSON.stringify(output, null, 2) }] };
+      return {
+        content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+        structuredContent: output
+      };
     }
   );
 }
@@ -34457,7 +34806,8 @@ function registerSearchTool(server, defaultFile) {
         assignee: external_exports.string().optional().describe("Filter by assignee"),
         recent: external_exports.boolean().optional().describe("List recently completed tasks (v2 only)"),
         task: external_exports.string().optional().describe("View a specific task/log entry (v2 only)")
-      })
+      }),
+      outputSchema: searchOutputSchema
     },
     async ({ file: file2, query, column, priority, assignee, recent, task }) => {
       const filePath = file2 || defaultFile;
@@ -34469,7 +34819,7 @@ function registerSearchTool(server, defaultFile) {
         if (!found) {
           return { content: [{ type: "text", text: `Error: Task not found: ${task}` }], isError: true };
         }
-        const output = {
+        const output2 = {
           id: found.doc.task.id,
           title: found.doc.task.title,
           completedAt: found.doc.task.completedAt,
@@ -34477,7 +34827,10 @@ function registerSearchTool(server, defaultFile) {
           description: (0, import_core.extractDescription)(found.doc.body),
           log: (0, import_core.extractLog)(found.doc.body)
         };
-        return { content: [{ type: "text", text: JSON.stringify(output, null, 2) }] };
+        return {
+          content: [{ type: "text", text: JSON.stringify(output2, null, 2) }],
+          structuredContent: output2
+        };
       }
       if (recent) {
         const dirs2 = (0, import_core.getV2Dirs)(filePath);
@@ -34488,7 +34841,11 @@ function registerSearchTool(server, defaultFile) {
           title: doc.task.title,
           completedAt: doc.task.completedAt
         }));
-        return { content: [{ type: "text", text: JSON.stringify({ logs, count: logs.length }, null, 2) }] };
+        const output2 = { logs, count: logs.length };
+        return {
+          content: [{ type: "text", text: JSON.stringify(output2, null, 2) }],
+          structuredContent: output2
+        };
       }
       if (!query) {
         return { content: [{ type: "text", text: "Error: query is required unless recent or task is provided" }], isError: true };
@@ -34508,7 +34865,11 @@ function registerSearchTool(server, defaultFile) {
         }
       }
       matches.sort((a, b) => b.score - a.score);
-      return { content: [{ type: "text", text: JSON.stringify({ results: matches, count: matches.length }, null, 2) }] };
+      const output = { results: matches, count: matches.length };
+      return {
+        content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+        structuredContent: output
+      };
     }
   );
 }
@@ -34546,7 +34907,8 @@ function registerTaskAddTool(server, defaultFile) {
         // Aliases (some clients prefer camelCase)
         withContract: external_exports.boolean().optional().describe("Alias of with_contract"),
         validationCommands: external_exports.array(external_exports.string()).optional().describe("Alias of validation_commands")
-      })
+      }),
+      outputSchema: taskAddOutputSchema
     },
     async ({
       file: file2,
@@ -34625,7 +34987,10 @@ function registerTaskAddTool(server, defaultFile) {
         if (!result.success || !result.task) {
           return { content: [{ type: "text", text: `Error: ${result.error || "Failed to add task"}` }], isError: true };
         }
-        return { content: [{ type: "text", text: `Task added successfully: ${result.task.id} - ${title}` }] };
+        return {
+          content: [{ type: "text", text: `Task added successfully: ${result.task.id} - ${title}` }],
+          structuredContent: { id: result.task.id, title }
+        };
       } catch (e) {
         return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
       }
@@ -34647,7 +35012,8 @@ function registerTaskMoveTool(server, defaultFile) {
         taskId: external_exports.union([external_exports.string(), external_exports.array(external_exports.string())]).optional().describe("Task ID or array of task IDs to move"),
         task: external_exports.string().optional().describe("Alias of taskId for single task move"),
         column: external_exports.string().describe("Target column ID or name")
-      })
+      }),
+      outputSchema: taskMoveOutputSchema
     },
     async ({ file: file2, taskId, task, column }) => {
       const filePath = file2 || defaultFile;
@@ -34693,22 +35059,27 @@ function registerTaskMoveTool(server, defaultFile) {
         }
         results.push({ taskId: id, success: true, message, warning: warning?.warning });
       }
+      const successCount = results.filter((r) => r.success).length;
+      const failureCount = results.length - successCount;
+      const output = { success: failureCount === 0, successCount, failureCount, results };
       if (!isBatch) {
         const single = results[0];
         if (!single?.success) {
-          return { content: [{ type: "text", text: `Error: ${single?.error || "Move failed"}` }], isError: true };
+          return {
+            content: [{ type: "text", text: `Error: ${single?.error || "Move failed"}` }],
+            structuredContent: output,
+            isError: true
+          };
         }
         let text = single.message || `Task ${taskIds[0]} moved`;
         if (single.warning) text += `
 
 ${single.warning}`;
-        return { content: [{ type: "text", text }] };
+        return { content: [{ type: "text", text }], structuredContent: output };
       }
-      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) }],
+        structuredContent: output,
         isError: failureCount > 0 && successCount === 0
       };
     }
@@ -34717,7 +35088,7 @@ ${single.warning}`;
 
 // src/mcp/tools/task_patch_tool.ts
 var import_core36 = __toESM(require_dist());
-import * as path15 from "path";
+import * as path16 from "path";
 function registerTaskPatchTool(server, defaultFile) {
   server.registerTool(
     "task_patch",
@@ -34736,7 +35107,8 @@ function registerTaskPatchTool(server, defaultFile) {
         dueDate: external_exports.string().nullable().optional().describe("New due date (null to remove)"),
         relatedFiles: external_exports.array(external_exports.string()).nullable().optional().describe("Related file paths (null to remove)"),
         parentId: external_exports.string().nullable().optional().describe("Parent task ID (null to remove)")
-      })
+      }),
+      outputSchema: taskPatchOutputSchema
     },
     async ({ file: file2, taskId, task, title, description, priority, tags, assignee, dueDate, relatedFiles, parentId }) => {
       const filePath = file2 || defaultFile;
@@ -34752,7 +35124,7 @@ function registerTaskPatchTool(server, defaultFile) {
       const dirs = (0, import_core.getV2Dirs)(filePath);
       const results = [];
       for (const id of taskIds) {
-        const taskPath = path15.join(dirs.boardDir, (0, import_core36.taskFileName)(id));
+        const taskPath = path16.join(dirs.boardDir, (0, import_core36.taskFileName)(id));
         const doc = (0, import_core36.readTaskFile)(taskPath);
         if (!doc) {
           results.push({ taskId: id, success: false, error: "Task not found" });
@@ -34775,18 +35147,26 @@ function registerTaskPatchTool(server, defaultFile) {
         }
         results.push({ taskId: id, success: true });
       }
+      const successCount = results.filter((r) => r.success).length;
+      const failureCount = results.length - successCount;
+      const output = { success: failureCount === 0, successCount, failureCount, results };
       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: `Error: ${single?.error || "Task not found"}` }],
+            structuredContent: output,
+            isError: true
+          };
         }
-        return { content: [{ type: "text", text: `Task ${taskIds[0]} updated successfully` }] };
+        return {
+          content: [{ type: "text", text: `Task ${taskIds[0]} updated successfully` }],
+          structuredContent: output
+        };
       }
-      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) }],
+        structuredContent: output,
         isError: failureCount > 0 && successCount === 0
       };
     }
@@ -34794,7 +35174,7 @@ function registerTaskPatchTool(server, defaultFile) {
 }
 
 // src/mcp/tools/task_delete_tool.ts
-import * as fs12 from "fs";
+import * as fs13 from "fs";
 function registerTaskDeleteTool(server, defaultFile) {
   server.registerTool(
     "task_delete",
@@ -34804,7 +35184,8 @@ function registerTaskDeleteTool(server, defaultFile) {
       inputSchema: external_exports.object({
         file: external_exports.string().optional().describe("Path to brainfile.md (default: brainfile.md)"),
         task: external_exports.string().describe("Task ID to delete")
-      })
+      }),
+      outputSchema: taskDeleteOutputSchema
     },
     async ({ file: file2, task }) => {
       const filePath = file2 || defaultFile;
@@ -34816,8 +35197,11 @@ function registerTaskDeleteTool(server, defaultFile) {
         return { content: [{ type: "text", text: `Error: Task not found: ${task}` }], isError: true };
       }
       try {
-        fs12.unlinkSync(found.filePath);
-        return { content: [{ type: "text", text: `Task ${task} deleted successfully` }] };
+        fs13.unlinkSync(found.filePath);
+        return {
+          content: [{ type: "text", text: `Task ${task} deleted successfully` }],
+          structuredContent: { id: task, deleted: true }
+        };
       } catch (e) {
         return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
       }
@@ -34843,7 +35227,8 @@ function registerSubtaskTool(server, defaultFile) {
         titles: external_exports.array(external_exports.string()).optional().describe("Optional titles for batch update action"),
         completed: external_exports.boolean().optional().describe("For toggle action: set explicit completed state (true/false) instead of flipping"),
         all: external_exports.boolean().optional().describe("For toggle/delete action: target all subtasks in the task")
-      })
+      }),
+      outputSchema: subtaskOutputSchema
     },
     async ({ action, file: file2, task, subtask, subtasks, title, titles, completed, all }) => {
       const filePath = file2 || defaultFile;
@@ -34879,10 +35264,17 @@ function registerSubtaskTool(server, defaultFile) {
           return { content: [{ type: "text", text: `Error: ${result.error || "Failed to add subtasks"}` }], isError: true };
         }
         const added = result.affected.map((st) => ({ id: st.id, title: st.title }));
+        const output = { action: "add", added, count: added.length };
         if (added.length === 1) {
-          return { content: [{ type: "text", text: `Subtask added: ${added[0].id} - ${added[0].title}` }] };
+          return {
+            content: [{ type: "text", text: `Subtask added: ${added[0].id} - ${added[0].title}` }],
+            structuredContent: output
+          };
         }
-        return { content: [{ type: "text", text: JSON.stringify({ added, count: added.length }, null, 2) }] };
+        return {
+          content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+          structuredContent: output
+        };
       }
       if (action === "delete") {
         const dirs = (0, import_core.getV2Dirs)(filePath);
@@ -34903,10 +35295,17 @@ function registerSubtaskTool(server, defaultFile) {
         }
         const deleted = result.affected.map((st) => st.id);
         const missing = result.missing ?? [];
+        const output = { action: "delete", deleted, missing, count: deleted.length };
         if (!useAll && deleted.length === 1 && missing.length === 0) {
-          return { content: [{ type: "text", text: `Subtask ${deleted[0]} deleted successfully` }] };
+          return {
+            content: [{ type: "text", text: `Subtask ${deleted[0]} deleted successfully` }],
+            structuredContent: output
+          };
         }
-        return { content: [{ type: "text", text: JSON.stringify({ deleted, missing, count: deleted.length }, null, 2) }] };
+        return {
+          content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+          structuredContent: output
+        };
       }
       if (action === "toggle") {
         const dirs = (0, import_core.getV2Dirs)(filePath);
@@ -34926,11 +35325,18 @@ function registerSubtaskTool(server, defaultFile) {
           return { content: [{ type: "text", text: `Error: ${result.error || "Failed to toggle subtasks"}` }], isError: true };
         }
         const updated = result.affected.map((st) => ({ id: st.id, completed: st.completed }));
+        const output = { action: "toggle", updated, count: updated.length };
         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: `Subtask ${updated[0].id} marked as ${status}` }],
+            structuredContent: output
+          };
         }
-        return { content: [{ type: "text", text: JSON.stringify({ updated, count: updated.length }, null, 2) }] };
+        return {
+          content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+          structuredContent: output
+        };
       }
       if (action === "update") {
         const targetIds = listParam;
@@ -34958,10 +35364,17 @@ function registerSubtaskTool(server, defaultFile) {
           return { content: [{ type: "text", text: `Error: ${result.error || "Failed to update subtasks"}` }], isError: true };
         }
         const updated = result.affected.map((st) => ({ id: st.id, title: st.title }));
+        const output = { action: "update", updated, count: updated.length };
         if (updated.length === 1) {
-          return { content: [{ type: "text", text: `Subtask ${updated[0].id} updated to "${updated[0].title}"` }] };
+          return {
+            content: [{ type: "text", text: `Subtask ${updated[0].id} updated to "${updated[0].title}"` }],
+            structuredContent: output
+          };
         }
-        return { content: [{ type: "text", text: JSON.stringify({ updated, count: updated.length }, null, 2) }] };
+        return {
+          content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+          structuredContent: output
+        };
       }
       return { content: [{ type: "text", text: `Error: Unknown action: ${action}` }], isError: true };
     }
@@ -34973,8 +35386,8 @@ var import_core41 = __toESM(require_dist());
 
 // src/lib/contractRunner.ts
 var import_core38 = __toESM(require_dist());
-import * as fs13 from "fs";
-import * as path16 from "path";
+import * as fs14 from "fs";
+import * as path17 from "path";
 import { spawnSync } from "child_process";
 function detectDirectoryChangeWarning(command) {
   const patterns = [
@@ -34993,7 +35406,7 @@ function detectDirectoryChangeWarning(command) {
   return void 0;
 }
 function requireV2Runner(resolvedFilePath) {
-  if (!fs13.existsSync(resolvedFilePath)) {
+  if (!fs14.existsSync(resolvedFilePath)) {
     return { error: `File not found: ${resolvedFilePath}` };
   }
   if (!(0, import_core.isV2)(resolvedFilePath)) {
@@ -35137,9 +35550,9 @@ function validateContractV2(ctx, resolvedFilePath) {
   if (!taskDoc) return { error: `Failed to read task file: ${taskPath}` };
   if (!taskDoc.task.contract) return { error: `Task ${ctx.taskId} has no contract` };
   const contract = taskDoc.task.contract;
-  const brainfileAbs = path16.resolve(resolvedFilePath);
-  const brainfileDir = path16.dirname(brainfileAbs);
-  const baseDir = path16.basename(brainfileDir) === ".brainfile" ? path16.dirname(brainfileDir) : brainfileDir;
+  const brainfileAbs = path17.resolve(resolvedFilePath);
+  const brainfileDir = path17.dirname(brainfileAbs);
+  const baseDir = path17.basename(brainfileDir) === ".brainfile" ? path17.dirname(brainfileDir) : brainfileDir;
   const deliverables = contract.deliverables ?? [];
   const deliverableChecks = [];
   for (const d of deliverables) {
@@ -35152,8 +35565,8 @@ function validateContractV2(ctx, resolvedFilePath) {
       deliverableChecks.push({ deliverable: d, ok: false, error: normalized.error });
       continue;
     }
-    const resolved = path16.isAbsolute(normalized.value) ? normalized.value : path16.join(baseDir, normalized.value);
-    if (!fs13.existsSync(resolved)) {
+    const resolved = path17.isAbsolute(normalized.value) ? normalized.value : path17.join(baseDir, normalized.value);
+    if (!fs14.existsSync(resolved)) {
       deliverableChecks.push({ deliverable: d, ok: false, resolvedPath: resolved, error: "File not found" });
     } else {
       deliverableChecks.push({ deliverable: d, ok: true, resolvedPath: resolved });
@@ -35621,9 +36034,9 @@ function contractActivateCommand(options, logger = defaultLogger) {
 // src/mcp/tools/contract.ts
 function toDeliverableSpec(deliverable) {
   const type2 = deliverable.type.trim();
-  const path20 = deliverable.path.trim();
+  const path21 = deliverable.path.trim();
   const description = deliverable.description?.trim();
-  return description ? `${type2}:${path20}:${description}` : `${type2}:${path20}`;
+  return description ? `${type2}:${path21}:${description}` : `${type2}:${path21}`;
 }
 function executeContractGraphMcpAction(options) {
   const logger = new MemoryLogger();
@@ -35683,7 +36096,8 @@ function registerContractTool(server, defaultFile) {
           dependsOn: external_exports.array(external_exports.string()).optional()
         })).optional().describe("graph only: array of contract graph task specs"),
         activate: external_exports.boolean().optional().describe("graph only: when true, attached contracts start in ready instead of draft")
-      })
+      }),
+      outputSchema: contractOutputSchema
     },
     async ({ action, file: file2, task, parentId, ready: attachReady, deliverables, validation_commands, constraints, tasks, activate }) => {
       const filePath = file2 || defaultFile;
@@ -35708,7 +36122,11 @@ function registerContractTool(server, defaultFile) {
           if (!result.success || !result.task) {
             return { content: [{ type: "text", text: `Error: ${result.error || "Failed to attach contract"}` }], isError: true };
           }
-          return { content: [{ type: "text", text: `Contract attached (${result.task.contract.status}): ${task}` }] };
+          const status = result.task.contract.status;
+          return {
+            content: [{ type: "text", text: `Contract attached (${status}): ${task}` }],
+            structuredContent: { action: "attach", task, status }
+          };
         } catch (e) {
           return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
         }
@@ -35721,7 +36139,10 @@ function registerContractTool(server, defaultFile) {
         if ("error" in result) {
           return { content: [{ type: "text", text: `Error: ${result.error}` }], isError: true };
         }
-        return { content: [{ type: "text", text: result.markdown }] };
+        return {
+          content: [{ type: "text", text: result.markdown }],
+          structuredContent: { action: "pickup", task, markdown: result.markdown }
+        };
       }
       if (action === "deliver") {
         if (!task) {
@@ -35731,7 +36152,10 @@ function registerContractTool(server, defaultFile) {
         if ("error" in result) {
           return { content: [{ type: "text", text: `Error: ${result.error}` }], isError: true };
         }
-        return { content: [{ type: "text", text: `Contract delivered: ${task}` }] };
+        return {
+          content: [{ type: "text", text: `Contract delivered: ${task}` }],
+          structuredContent: { action: "deliver", task }
+        };
       }
       if (action === "validate") {
         if (!task) {
@@ -35742,6 +36166,7 @@ function registerContractTool(server, defaultFile) {
           return { content: [{ type: "text", text: `Error: ${result.error}` }], isError: true };
         }
         const output = {
+          action: "validate",
           ok: result.ok,
           status: result.ok ? "done" : "failed",
           deliverables: result.deliverableChecks,
@@ -35750,7 +36175,7 @@ function registerContractTool(server, defaultFile) {
         };
         return {
           content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
-          isError: !result.ok
+          structuredContent: output
         };
       }
       if (action === "graph") {
@@ -35763,13 +36188,16 @@ function registerContractTool(server, defaultFile) {
             tasks,
             activate
           });
+          const output = {
+            action: "graph",
+            attached: result.attached,
+            count: result.count,
+            order: result.order,
+            graph: result.graph
+          };
           return {
-            content: [{ type: "text", text: JSON.stringify({
-              attached: result.attached,
-              count: result.count,
-              order: result.order,
-              graph: result.graph
-            }, null, 2) }]
+            content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+            structuredContent: output
           };
         } catch (error48) {
           return {
@@ -35799,8 +36227,11 @@ function registerContractTool(server, defaultFile) {
         } else {
           activated.push(...(0, import_core41.activateTaskContractsByParent)(dirs.boardDir, parentId).activated);
         }
-        const output = { activated, count: activated.length };
-        return { content: [{ type: "text", text: JSON.stringify(output, null, 2) }] };
+        const output = { action: "activate", activated, count: activated.length };
+        return {
+          content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+          structuredContent: output
+        };
       }
       return { content: [{ type: "text", text: `Error: Unknown action: ${action}` }], isError: true };
     }
@@ -35809,7 +36240,7 @@ function registerContractTool(server, defaultFile) {
 
 // src/mcp/tools/task_complete_tool.ts
 var import_core42 = __toESM(require_dist());
-import * as fs14 from "fs";
+import * as fs15 from "fs";
 function registerTaskCompleteTool(server, defaultFile) {
   server.registerTool(
     "task_complete",
@@ -35820,7 +36251,8 @@ function registerTaskCompleteTool(server, defaultFile) {
         file: external_exports.string().optional().describe("Path to brainfile.md (default: brainfile.md)"),
         task: external_exports.string().describe("Task ID to complete"),
         destination: external_exports.enum(["local", "github", "linear"]).optional().describe("Optional archive destination. If omitted, performs normal completion flow.")
-      })
+      }),
+      outputSchema: taskCompleteOutputSchema
     },
     async ({ file: file2, task, destination }) => {
       const filePath = file2 || defaultFile;
@@ -35834,7 +36266,13 @@ function registerTaskCompleteTool(server, defaultFile) {
           }, info: () => {
           } });
           return {
-            content: [{ type: "text", text: `Task ${task} completed at ${result.completedAt}` }]
+            content: [{ type: "text", text: `Task ${task} completed at ${result.completedAt}` }],
+            structuredContent: {
+              destination: "local",
+              taskId: task,
+              completedAt: result.completedAt,
+              archived: false
+            }
           };
         }
         if (destination === "local") {
@@ -35843,7 +36281,7 @@ function registerTaskCompleteTool(server, defaultFile) {
           if (!found2) {
             return { content: [{ type: "text", text: `Error: Task not found: ${task}` }], isError: true };
           }
-          const result = (0, import_core42.completeTaskFile)(found2.filePath, dirs2.logsDir, { legacyMode: true });
+          const result = (0, import_core42.completeTaskFile)(found2.filePath, dirs2.logsDir, {});
           if (!result.success) {
             const detail = result.incompleteChildren?.length ? `
 Incomplete children:
@@ -35853,7 +36291,10 @@ ${result.incompleteChildren.map((c) => `  - ${c.id}: ${c.title}`).join("\n")}` :
               isError: true
             };
           }
-          return { content: [{ type: "text", text: `Task ${task} archived to logs/` }] };
+          return {
+            content: [{ type: "text", text: `Task ${task} archived to logs/` }],
+            structuredContent: { destination: "local", taskId: task, archived: true }
+          };
         }
         const dirs = (0, import_core.getV2Dirs)(filePath);
         const found = (0, import_core.findV2Task)(dirs, task);
@@ -35888,10 +36329,18 @@ ${result.incompleteChildren.map((c) => `  - ${c.id}: ${c.title}`).join("\n")}` :
           if (!ghResult.success) {
             return { content: [{ type: "text", text: `Error creating GitHub issue: ${ghResult.error}` }], isError: true };
           }
-          fs14.unlinkSync(found.filePath);
-          return { content: [{ type: "text", text: `Task ${task} archived to GitHub Issue #${ghResult.issueNumber} (closed)
+          fs15.unlinkSync(found.filePath);
+          return {
+            content: [{ type: "text", text: `Task ${task} archived to GitHub Issue #${ghResult.issueNumber} (closed)
 
-View: ${ghResult.issueUrl}` }] };
+View: ${ghResult.issueUrl}` }],
+            structuredContent: {
+              destination: "github",
+              taskId: task,
+              issueNumber: ghResult.issueNumber,
+              issueUrl: ghResult.issueUrl
+            }
+          };
         }
         if (!await isLinearAuthenticated()) {
           return { content: [{ type: "text", text: "Error: Not authenticated with Linear." }], isError: true };
@@ -35932,10 +36381,18 @@ ${teamList}` }], isError: true };
         if (!linearResult.success) {
           return { content: [{ type: "text", text: `Error creating Linear issue: ${linearResult.error}` }], isError: true };
         }
-        fs14.unlinkSync(found.filePath);
-        return { content: [{ type: "text", text: `Task ${task} archived to Linear Issue ${linearResult.issueId} (Done)
+        fs15.unlinkSync(found.filePath);
+        return {
+          content: [{ type: "text", text: `Task ${task} archived to Linear Issue ${linearResult.issueId} (Done)
 
-View: ${linearResult.issueUrl}` }] };
+View: ${linearResult.issueUrl}` }],
+          structuredContent: {
+            destination: "linear",
+            taskId: task,
+            issueId: linearResult.issueId,
+            issueUrl: linearResult.issueUrl
+          }
+        };
       } catch (e) {
         return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
       }
@@ -35943,8 +36400,69 @@ View: ${linearResult.issueUrl}` }] };
   );
 }
 
+// src/mcp/tools/brief_tool.ts
+var import_core43 = __toESM(require_dist());
+function registerBriefTool(server, defaultFile) {
+  server.registerTool(
+    "brief",
+    {
+      title: "Agent Brief",
+      description: "Get a per-agent brief: what changed on the board since this agent last checked in. First call returns a full orientation; later calls return only what is new.",
+      inputSchema: external_exports.object({
+        file: external_exports.string().optional().describe("Path to brainfile.md (default: brainfile.md)"),
+        agent: external_exports.string().describe("Agent identifier (required \u2014 brief state is per-agent)"),
+        peek: external_exports.boolean().optional().describe("Read the brief without marking it as seen")
+      }),
+      outputSchema: briefOutputSchema
+    },
+    async ({ file: file2, agent, peek }) => {
+      const filePath = file2 || defaultFile;
+      const guard = requireV2(filePath);
+      if (guard) return guard;
+      const agentName = agent?.trim();
+      if (!agentName) {
+        return {
+          content: [{ type: "text", text: "Error: agent is required" }],
+          isError: true
+        };
+      }
+      const resolvedPath = resolveBrainfile(filePath);
+      const dirs = (0, import_core.getV2Dirs)(resolvedPath);
+      const isPeek = peek === true;
+      const state = (0, import_core43.readBriefState)(resolvedPath, agentName);
+      const result = (0, import_core43.buildBrief)(dirs, agentName, { lastBriefAt: state.lastBriefAt });
+      if (!isPeek) {
+        (0, import_core43.writeBriefState)(resolvedPath, agentName, result.generatedAt);
+      }
+      const output = { ...result, peek: isPeek };
+      return {
+        content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+        structuredContent: output
+      };
+    }
+  );
+}
+
 // src/commands/mcp.ts
 var cliVersion = require_package().version;
+function createBrainfileMcpServer(defaultFile) {
+  const server = new McpServer({
+    name: "brainfile",
+    version: cliVersion
+  });
+  registerListTasksTool(server, defaultFile);
+  registerGetTaskTool(server, defaultFile);
+  registerSearchTool(server, defaultFile);
+  registerTaskAddTool(server, defaultFile);
+  registerTaskMoveTool(server, defaultFile);
+  registerTaskPatchTool(server, defaultFile);
+  registerTaskDeleteTool(server, defaultFile);
+  registerSubtaskTool(server, defaultFile);
+  registerContractTool(server, defaultFile);
+  registerTaskCompleteTool(server, defaultFile);
+  registerBriefTool(server, defaultFile);
+  return server;
+}
 async function mcpCommand(options) {
   let defaultFile = options.file;
   if (defaultFile === "brainfile.md") {
@@ -35952,13 +36470,13 @@ async function mcpCommand(options) {
     if (workspacePaths) {
       const paths = workspacePaths.split(":").filter(Boolean);
       for (const wsPath of paths) {
-        const found = (0, import_core43.findBrainfile)(wsPath);
+        const found = (0, import_core44.findBrainfile)(wsPath);
         if (found) {
           defaultFile = found.absolutePath;
           console.error(`[brainfile-mcp] Found in workspace: ${defaultFile}`);
           break;
         }
-        const discovered = (0, import_core43.findNearestBrainfile)(wsPath);
+        const discovered = (0, import_core44.findNearestBrainfile)(wsPath);
         if (discovered) {
           defaultFile = discovered.absolutePath;
           console.error(`[brainfile-mcp] Discovered in workspace: ${defaultFile}`);
@@ -35969,12 +36487,12 @@ async function mcpCommand(options) {
     if (defaultFile === "brainfile.md") {
       const gitRoot = findGitRoot(process.cwd());
       if (gitRoot) {
-        const found = (0, import_core43.findBrainfile)(gitRoot);
+        const found = (0, import_core44.findBrainfile)(gitRoot);
         if (found) {
           defaultFile = found.absolutePath;
           console.error(`[brainfile-mcp] Found from git root: ${defaultFile}`);
         } else {
-          const discovered = (0, import_core43.findNearestBrainfile)(gitRoot);
+          const discovered = (0, import_core44.findNearestBrainfile)(gitRoot);
           if (discovered) {
             defaultFile = discovered.absolutePath;
             console.error(`[brainfile-mcp] Discovered from git root: ${defaultFile}`);
@@ -35983,46 +36501,30 @@ async function mcpCommand(options) {
       }
     }
     if (defaultFile === "brainfile.md") {
-      const found = (0, import_core43.findBrainfile)();
+      const found = (0, import_core44.findBrainfile)();
       if (found) {
         defaultFile = found.absolutePath;
         console.error(`[brainfile-mcp] Auto-discovered: ${defaultFile}`);
       } else {
-        defaultFile = (0, import_core43.resolveBrainfilePath)({ filePath: "brainfile.md", startDir: process.cwd() });
+        defaultFile = (0, import_core44.resolveBrainfilePath)({ filePath: "brainfile.md", startDir: process.cwd() });
         console.error(`[brainfile-mcp] No brainfile found, using: ${defaultFile}`);
       }
     }
   } else {
-    defaultFile = (0, import_core43.resolveBrainfilePath)({ filePath: defaultFile, startDir: process.cwd() });
+    defaultFile = (0, import_core44.resolveBrainfilePath)({ filePath: defaultFile, startDir: process.cwd() });
     console.error(`[brainfile-mcp] Using specified file: ${defaultFile}`);
   }
   assertV2Brainfile(defaultFile);
-  serveStdio(() => {
-    const server = new McpServer({
-      name: "brainfile",
-      version: cliVersion
-    });
-    registerListTasksTool(server, defaultFile);
-    registerGetTaskTool(server, defaultFile);
-    registerSearchTool(server, defaultFile);
-    registerTaskAddTool(server, defaultFile);
-    registerTaskMoveTool(server, defaultFile);
-    registerTaskPatchTool(server, defaultFile);
-    registerTaskDeleteTool(server, defaultFile);
-    registerSubtaskTool(server, defaultFile);
-    registerContractTool(server, defaultFile);
-    registerTaskCompleteTool(server, defaultFile);
-    return server;
-  });
+  serveStdio(() => createBrainfileMcpServer(defaultFile));
 }
 
 // src/commands/hooks.ts
-var import_chalk16 = __toESM(require_source());
+var import_chalk17 = __toESM(require_source());
 import * as readline2 from "readline";
 
 // src/utils/hook-settings.ts
-import * as fs15 from "fs";
-import * as path17 from "path";
+import * as fs16 from "fs";
+import * as path18 from "path";
 import * as os from "os";
 function resolveHomeDir() {
   const home = process.env.HOME?.trim();
@@ -36033,44 +36535,44 @@ function getSettingsPath(tool, scope) {
   if (scope === "user") {
     switch (tool) {
       case "claude-code":
-        return path17.join(homeDir, ".claude", "settings.json");
+        return path18.join(homeDir, ".claude", "settings.json");
       case "cursor":
-        return path17.join(homeDir, ".cursor", "hooks.json");
+        return path18.join(homeDir, ".cursor", "hooks.json");
       case "cline":
-        return path17.join(homeDir, "Documents", "Cline", "Rules", "Hooks");
+        return path18.join(homeDir, "Documents", "Cline", "Rules", "Hooks");
     }
   } else {
     switch (tool) {
       case "claude-code":
-        return path17.join(process.cwd(), ".claude", "settings.json");
+        return path18.join(process.cwd(), ".claude", "settings.json");
       case "cursor":
-        return path17.join(process.cwd(), ".cursor", "hooks.json");
+        return path18.join(process.cwd(), ".cursor", "hooks.json");
       case "cline":
-        return path17.join(process.cwd(), ".clinerules", "hooks");
+        return path18.join(process.cwd(), ".clinerules", "hooks");
     }
   }
 }
 function readToolSettings(tool, scope) {
   const settingsPath = getSettingsPath(tool, scope);
   if (tool === "cline") {
-    if (!fs15.existsSync(settingsPath)) {
+    if (!fs16.existsSync(settingsPath)) {
       return { hooks: {} };
     }
     const hooks = {};
     const hookFiles = ["PostToolUse", "UserPromptSubmit", "TaskStart"];
     for (const hookFile of hookFiles) {
-      const hookPath = path17.join(settingsPath, hookFile);
-      if (fs15.existsSync(hookPath)) {
+      const hookPath = path18.join(settingsPath, hookFile);
+      if (fs16.existsSync(hookPath)) {
         hooks[hookFile] = true;
       }
     }
     return { hooks };
   }
-  if (!fs15.existsSync(settingsPath)) {
+  if (!fs16.existsSync(settingsPath)) {
     return tool === "cursor" ? { version: 1, hooks: {} } : {};
   }
   try {
-    const content = fs15.readFileSync(settingsPath, "utf-8");
+    const content = fs16.readFileSync(settingsPath, "utf-8");
     return JSON.parse(content);
   } catch {
     return tool === "cursor" ? { version: 1, hooks: {} } : {};
@@ -36078,11 +36580,11 @@ function readToolSettings(tool, scope) {
 }
 function writeToolSettings(tool, scope, settings) {
   const settingsPath = getSettingsPath(tool, scope);
-  const settingsDir = path17.dirname(settingsPath);
-  if (!fs15.existsSync(settingsDir)) {
-    fs15.mkdirSync(settingsDir, { recursive: true });
+  const settingsDir = path18.dirname(settingsPath);
+  if (!fs16.existsSync(settingsDir)) {
+    fs16.mkdirSync(settingsDir, { recursive: true });
   }
-  fs15.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), "utf-8");
+  fs16.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), "utf-8");
 }
 function createClineHookScript(hookType) {
   const commandMap = {
@@ -36132,8 +36634,8 @@ function installBrainfileHooks(tool, scope) {
   const settings = readToolSettings(tool, scope);
   if (tool === "cline") {
     const hooksDir = getSettingsPath(tool, scope);
-    if (!fs15.existsSync(hooksDir)) {
-      fs15.mkdirSync(hooksDir, { recursive: true });
+    if (!fs16.existsSync(hooksDir)) {
+      fs16.mkdirSync(hooksDir, { recursive: true });
     }
     const hookTypes = [
       "PostToolUse",
@@ -36141,9 +36643,9 @@ function installBrainfileHooks(tool, scope) {
       "TaskStart"
     ];
     for (const hookType of hookTypes) {
-      const hookPath = path17.join(hooksDir, hookType);
+      const hookPath = path18.join(hooksDir, hookType);
       const scriptContent = createClineHookScript(hookType);
-      fs15.writeFileSync(hookPath, scriptContent, { mode: 493 });
+      fs16.writeFileSync(hookPath, scriptContent, { mode: 493 });
     }
     return;
   }
@@ -36233,16 +36735,16 @@ function installBrainfileHooks(tool, scope) {
 function uninstallBrainfileHooks(tool, scope) {
   if (tool === "cline") {
     const hooksDir = getSettingsPath(tool, scope);
-    if (!fs15.existsSync(hooksDir)) {
+    if (!fs16.existsSync(hooksDir)) {
       return;
     }
     const hookFiles = ["PostToolUse", "UserPromptSubmit", "TaskStart"];
     for (const hookFile of hookFiles) {
-      const hookPath = path17.join(hooksDir, hookFile);
-      if (fs15.existsSync(hookPath)) {
-        const content = fs15.readFileSync(hookPath, "utf-8");
+      const hookPath = path18.join(hooksDir, hookFile);
+      if (fs16.existsSync(hookPath)) {
+        const content = fs16.readFileSync(hookPath, "utf-8");
         if (content.includes("brainfile hooks")) {
-          fs15.unlinkSync(hookPath);
+          fs16.unlinkSync(hookPath);
         }
       }
     }
@@ -36289,15 +36791,15 @@ function uninstallBrainfileHooks(tool, scope) {
 }
 function areBrainfileHooksInstalled(tool, scope) {
   const settingsPath = getSettingsPath(tool, scope);
-  if (!fs15.existsSync(settingsPath)) {
+  if (!fs16.existsSync(settingsPath)) {
     return false;
   }
   if (tool === "cline") {
     const hookFiles = ["PostToolUse", "UserPromptSubmit", "TaskStart"];
     for (const hookFile of hookFiles) {
-      const hookPath = path17.join(settingsPath, hookFile);
-      if (fs15.existsSync(hookPath)) {
-        const content = fs15.readFileSync(hookPath, "utf-8");
+      const hookPath = path18.join(settingsPath, hookFile);
+      if (fs16.existsSync(hookPath)) {
+        const content = fs16.readFileSync(hookPath, "utf-8");
         if (content.includes("brainfile hooks")) {
           return true;
         }
@@ -36336,16 +36838,16 @@ function areBrainfileHooksInstalled(tool, scope) {
 }
 
 // src/utils/brainfile-finder.ts
-var import_core44 = __toESM(require_dist());
-import * as fs16 from "fs";
+var import_core45 = __toESM(require_dist());
+import * as fs17 from "fs";
 function findBrainfile2() {
-  const found = (0, import_core44.findBrainfile)(process.cwd());
+  const found = (0, import_core45.findBrainfile)(process.cwd());
   if (found && found.kind !== "dotdir") return null;
   return found?.absolutePath ?? null;
 }
 function getFileAgeMinutes(filePath) {
   try {
-    const stats = fs16.statSync(filePath);
+    const stats = fs17.statSync(filePath);
     const now = Date.now();
     const modifiedTime = stats.mtimeMs;
     const ageMs = now - modifiedTime;
@@ -36526,8 +37028,8 @@ async function sessionStartCommand(logger = defaultLogger, stdin) {
 function installCommand(options, logger = defaultLogger) {
   const tool = options.tool;
   if (tool !== "claude-code" && tool !== "cursor" && tool !== "cline") {
-    logger.error(import_chalk16.default.red(`Error: Unknown tool '${options.tool}'`));
-    logger.log(import_chalk16.default.gray("Supported tools: claude-code, cursor, cline"));
+    logger.error(import_chalk17.default.red(`Error: Unknown tool '${options.tool}'`));
+    logger.log(import_chalk17.default.gray("Supported tools: claude-code, cursor, cline"));
     throw new CLIError(`Unknown tool '${options.tool}'`, ExitCode.USER_ERROR);
   }
   try {
@@ -36540,35 +37042,35 @@ function installCommand(options, logger = defaultLogger) {
   }
   const settingsPath = getSettingsPath(tool, options.scope);
   const toolName = tool === "claude-code" ? "Claude Code" : tool === "cursor" ? "Cursor" : "Cline";
-  logger.log(import_chalk16.default.green(`\u2705 Brainfile hooks installed for ${toolName}!`));
-  logger.log(import_chalk16.default.gray(`   Settings: ${settingsPath}`));
-  logger.log(import_chalk16.default.gray(`   Scope: ${options.scope}`));
+  logger.log(import_chalk17.default.green(`\u2705 Brainfile hooks installed for ${toolName}!`));
+  logger.log(import_chalk17.default.gray(`   Settings: ${settingsPath}`));
+  logger.log(import_chalk17.default.gray(`   Scope: ${options.scope}`));
   logger.log("");
-  logger.log(import_chalk16.default.white("Hooks configured:"));
+  logger.log(import_chalk17.default.white("Hooks configured:"));
   if (tool === "claude-code") {
-    logger.log(import_chalk16.default.gray("  \u2022 PostToolUse \u2192 brainfile hooks after-edit"));
-    logger.log(import_chalk16.default.gray("  \u2022 UserPromptSubmit \u2192 brainfile hooks before-prompt"));
-    logger.log(import_chalk16.default.gray("  \u2022 SessionStart \u2192 brainfile hooks session-start"));
+    logger.log(import_chalk17.default.gray("  \u2022 PostToolUse \u2192 brainfile hooks after-edit"));
+    logger.log(import_chalk17.default.gray("  \u2022 UserPromptSubmit \u2192 brainfile hooks before-prompt"));
+    logger.log(import_chalk17.default.gray("  \u2022 SessionStart \u2192 brainfile hooks session-start"));
   } else if (tool === "cursor") {
-    logger.log(import_chalk16.default.gray("  \u2022 afterFileEdit \u2192 brainfile hooks after-edit"));
-    logger.log(import_chalk16.default.gray("  \u2022 beforeSubmitPrompt \u2192 brainfile hooks before-prompt"));
-    logger.log(import_chalk16.default.gray("  \u2022 stop \u2192 brainfile hooks session-start"));
+    logger.log(import_chalk17.default.gray("  \u2022 afterFileEdit \u2192 brainfile hooks after-edit"));
+    logger.log(import_chalk17.default.gray("  \u2022 beforeSubmitPrompt \u2192 brainfile hooks before-prompt"));
+    logger.log(import_chalk17.default.gray("  \u2022 stop \u2192 brainfile hooks session-start"));
   } else if (tool === "cline") {
-    logger.log(import_chalk16.default.gray("  \u2022 PostToolUse \u2192 brainfile hooks after-edit"));
-    logger.log(import_chalk16.default.gray("  \u2022 UserPromptSubmit \u2192 brainfile hooks before-prompt"));
-    logger.log(import_chalk16.default.gray("  \u2022 TaskStart \u2192 brainfile hooks session-start"));
+    logger.log(import_chalk17.default.gray("  \u2022 PostToolUse \u2192 brainfile hooks after-edit"));
+    logger.log(import_chalk17.default.gray("  \u2022 UserPromptSubmit \u2192 brainfile hooks before-prompt"));
+    logger.log(import_chalk17.default.gray("  \u2022 TaskStart \u2192 brainfile hooks session-start"));
   }
   logger.log("");
-  logger.log(import_chalk16.default.gray("Next steps:"));
-  logger.log(import_chalk16.default.gray(`  1. Restart ${toolName} to activate hooks`));
-  logger.log(import_chalk16.default.gray("  2. Edit files and watch for brainfile reminders"));
-  logger.log(import_chalk16.default.gray("  3. Run 'brainfile hooks list' to verify installation"));
+  logger.log(import_chalk17.default.gray("Next steps:"));
+  logger.log(import_chalk17.default.gray(`  1. Restart ${toolName} to activate hooks`));
+  logger.log(import_chalk17.default.gray("  2. Edit files and watch for brainfile reminders"));
+  logger.log(import_chalk17.default.gray("  3. Run 'brainfile hooks list' to verify installation"));
 }
 function uninstallCommand(options, logger = defaultLogger) {
   const tool = options.tool;
   if (tool !== "claude-code" && tool !== "cursor" && tool !== "cline") {
-    logger.error(import_chalk16.default.red(`Error: Unknown tool '${options.tool}'`));
-    logger.log(import_chalk16.default.gray("Supported tools: claude-code, cursor, cline"));
+    logger.error(import_chalk17.default.red(`Error: Unknown tool '${options.tool}'`));
+    logger.log(import_chalk17.default.gray("Supported tools: claude-code, cursor, cline"));
     throw new CLIError(`Unknown tool '${options.tool}'`, ExitCode.USER_ERROR);
   }
   const scopes = options.scope === "all" ? ["user", "project"] : [options.scope];
@@ -36579,69 +37081,69 @@ function uninstallCommand(options, logger = defaultLogger) {
         uninstallBrainfileHooks(tool, scope);
         removed = true;
         const settingsPath = getSettingsPath(tool, scope);
-        logger.log(import_chalk16.default.green(`\u2713 Removed brainfile hooks from ${scope} settings`));
-        logger.log(import_chalk16.default.gray(`  ${settingsPath}`));
+        logger.log(import_chalk17.default.green(`\u2713 Removed brainfile hooks from ${scope} settings`));
+        logger.log(import_chalk17.default.gray(`  ${settingsPath}`));
       } catch (error48) {
         logger.warn(`Failed to remove hooks from ${scope}: ${error48 instanceof Error ? error48.message : String(error48)}`);
       }
     }
   }
   if (!removed) {
-    logger.log(import_chalk16.default.yellow("No brainfile hooks found to remove"));
+    logger.log(import_chalk17.default.yellow("No brainfile hooks found to remove"));
   }
 }
 function listCommand2(options, logger = defaultLogger) {
   const tools = options.tool ? [options.tool] : ["claude-code", "cursor", "cline"];
-  logger.log(import_chalk16.default.bold.white("\nBrainfile Hooks Status\n"));
+  logger.log(import_chalk17.default.bold.white("\nBrainfile Hooks Status\n"));
   for (const tool of tools) {
     const toolName = tool === "claude-code" ? "Claude Code" : tool === "cursor" ? "Cursor" : "Cline";
-    logger.log(import_chalk16.default.cyan(toolName + ":"));
+    logger.log(import_chalk17.default.cyan(toolName + ":"));
     try {
       const userInstalled = areBrainfileHooksInstalled(tool, "user");
       const userPath = getSettingsPath(tool, "user");
-      logger.log(import_chalk16.default.white(`  User scope (${userPath}):`));
+      logger.log(import_chalk17.default.white(`  User scope (${userPath}):`));
       if (userInstalled) {
         if (tool === "cline") {
-          logger.log(import_chalk16.default.green("    \u2713 PostToolUse \u2192 brainfile hooks after-edit"));
-          logger.log(import_chalk16.default.green("    \u2713 UserPromptSubmit \u2192 brainfile hooks before-prompt"));
-          logger.log(import_chalk16.default.green("    \u2713 TaskStart \u2192 brainfile hooks session-start"));
+          logger.log(import_chalk17.default.green("    \u2713 PostToolUse \u2192 brainfile hooks after-edit"));
+          logger.log(import_chalk17.default.green("    \u2713 UserPromptSubmit \u2192 brainfile hooks before-prompt"));
+          logger.log(import_chalk17.default.green("    \u2713 TaskStart \u2192 brainfile hooks session-start"));
         } else {
-          logger.log(import_chalk16.default.green("    \u2713 PostToolUse/afterFileEdit \u2192 brainfile hooks after-edit"));
-          logger.log(import_chalk16.default.green("    \u2713 UserPromptSubmit/beforeSubmitPrompt \u2192 brainfile hooks before-prompt"));
-          logger.log(import_chalk16.default.green("    \u2713 SessionStart/stop \u2192 brainfile hooks session-start"));
+          logger.log(import_chalk17.default.green("    \u2713 PostToolUse/afterFileEdit \u2192 brainfile hooks after-edit"));
+          logger.log(import_chalk17.default.green("    \u2713 UserPromptSubmit/beforeSubmitPrompt \u2192 brainfile hooks before-prompt"));
+          logger.log(import_chalk17.default.green("    \u2713 SessionStart/stop \u2192 brainfile hooks session-start"));
         }
       } else {
-        logger.log(import_chalk16.default.gray("    \u2717 Not installed"));
+        logger.log(import_chalk17.default.gray("    \u2717 Not installed"));
       }
     } catch (error48) {
-      logger.log(import_chalk16.default.gray(`    Error checking user scope: ${error48}`));
+      logger.log(import_chalk17.default.gray(`    Error checking user scope: ${error48}`));
     }
     try {
       const projectInstalled = areBrainfileHooksInstalled(tool, "project");
       const projectPath = getSettingsPath(tool, "project");
-      logger.log(import_chalk16.default.white(`  Project scope (${projectPath}):`));
+      logger.log(import_chalk17.default.white(`  Project scope (${projectPath}):`));
       if (projectInstalled) {
         if (tool === "cline") {
-          logger.log(import_chalk16.default.green("    \u2713 PostToolUse \u2192 brainfile hooks after-edit"));
-          logger.log(import_chalk16.default.green("    \u2713 UserPromptSubmit \u2192 brainfile hooks before-prompt"));
-          logger.log(import_chalk16.default.green("    \u2713 TaskStart \u2192 brainfile hooks session-start"));
+          logger.log(import_chalk17.default.green("    \u2713 PostToolUse \u2192 brainfile hooks after-edit"));
+          logger.log(import_chalk17.default.green("    \u2713 UserPromptSubmit \u2192 brainfile hooks before-prompt"));
+          logger.log(import_chalk17.default.green("    \u2713 TaskStart \u2192 brainfile hooks session-start"));
         } else {
-          logger.log(import_chalk16.default.green("    \u2713 PostToolUse/afterFileEdit \u2192 brainfile hooks after-edit"));
-          logger.log(import_chalk16.default.green("    \u2713 UserPromptSubmit/beforeSubmitPrompt \u2192 brainfile hooks before-prompt"));
-          logger.log(import_chalk16.default.green("    \u2713 SessionStart/stop \u2192 brainfile hooks session-start"));
+          logger.log(import_chalk17.default.green("    \u2713 PostToolUse/afterFileEdit \u2192 brainfile hooks after-edit"));
+          logger.log(import_chalk17.default.green("    \u2713 UserPromptSubmit/beforeSubmitPrompt \u2192 brainfile hooks before-prompt"));
+          logger.log(import_chalk17.default.green("    \u2713 SessionStart/stop \u2192 brainfile hooks session-start"));
         }
       } else {
-        logger.log(import_chalk16.default.gray("    \u2717 Not installed"));
+        logger.log(import_chalk17.default.gray("    \u2717 Not installed"));
       }
     } catch (error48) {
-      logger.log(import_chalk16.default.gray(`    Error checking project scope: ${error48}`));
+      logger.log(import_chalk17.default.gray(`    Error checking project scope: ${error48}`));
     }
     logger.log("");
   }
 }
 
 // src/commands/config.ts
-var import_chalk17 = __toESM(require_source());
+var import_chalk18 = __toESM(require_source());
 function configCommand(action, options) {
   switch (action) {
     case "list":
@@ -36649,18 +37151,18 @@ function configCommand(action, options) {
       break;
     case "get":
       if (!options.key) {
-        console.log(import_chalk17.default.red("Error:") + " Missing key. Usage: brainfile config get <key>");
+        console.log(import_chalk18.default.red("Error:") + " Missing key. Usage: brainfile config get <key>");
         process.exit(1);
       }
       getConfigValue(options.key);
       break;
     case "set":
       if (!options.key) {
-        console.log(import_chalk17.default.red("Error:") + " Missing key. Usage: brainfile config set <key> <value>");
+        console.log(import_chalk18.default.red("Error:") + " Missing key. Usage: brainfile config set <key> <value>");
         process.exit(1);
       }
       if (options.value === void 0) {
-        console.log(import_chalk17.default.red("Error:") + " Missing value. Usage: brainfile config set <key> <value>");
+        console.log(import_chalk18.default.red("Error:") + " Missing value. Usage: brainfile config set <key> <value>");
         process.exit(1);
       }
       setConfigValue(options.key, options.value);
@@ -36669,7 +37171,7 @@ function configCommand(action, options) {
       showConfigPath();
       break;
     default:
-      console.log(import_chalk17.default.red("Error:") + ` Unknown action: ${action}`);
+      console.log(import_chalk18.default.red("Error:") + ` Unknown action: ${action}`);
       console.log("");
       console.log("Available actions:");
       console.log("  list              Show all config values");
@@ -36682,29 +37184,29 @@ function configCommand(action, options) {
 function listConfig() {
   const config2 = loadConfig();
   if (Object.keys(config2).length === 0) {
-    console.log(import_chalk17.default.gray("No configuration set."));
+    console.log(import_chalk18.default.gray("No configuration set."));
     console.log("");
-    console.log("Use " + import_chalk17.default.cyan("brainfile config set <key> <value>") + " to set values.");
+    console.log("Use " + import_chalk18.default.cyan("brainfile config set <key> <value>") + " to set values.");
     console.log("");
     showAvailableKeys();
     return;
   }
-  console.log(import_chalk17.default.bold("Brainfile Configuration"));
+  console.log(import_chalk18.default.bold("Brainfile Configuration"));
   console.log("");
   const flattened = flattenConfig(config2);
   const maxKeyLen = Math.max(...Object.keys(flattened).map((k) => k.length));
   for (const [key, value] of Object.entries(flattened)) {
     const displayValue = Array.isArray(value) ? value.join(", ") : String(value);
-    console.log(`  ${import_chalk17.default.cyan(key.padEnd(maxKeyLen))}  ${displayValue}`);
+    console.log(`  ${import_chalk18.default.cyan(key.padEnd(maxKeyLen))}  ${displayValue}`);
   }
   console.log("");
-  console.log(import_chalk17.default.gray(`Config file: ${getConfigPath()}`));
+  console.log(import_chalk18.default.gray(`Config file: ${getConfigPath()}`));
 }
 function getConfigValue(key) {
   const config2 = loadConfig();
   const value = getNestedValue(config2, key);
   if (value === void 0) {
-    console.log(import_chalk17.default.gray("(not set)"));
+    console.log(import_chalk18.default.gray("(not set)"));
     return;
   }
   if (Array.isArray(value)) {
@@ -36718,7 +37220,7 @@ function getConfigValue(key) {
 function setConfigValue(key, value) {
   const config2 = loadConfig();
   if (!isValidKey(key)) {
-    console.log(import_chalk17.default.red("Error:") + ` Invalid key: ${key}`);
+    console.log(import_chalk18.default.red("Error:") + ` Invalid key: ${key}`);
     console.log("");
     showAvailableKeys();
     process.exit(1);
@@ -36726,7 +37228,7 @@ function setConfigValue(key, value) {
   const parsedValue = parseValue(key, value);
   setNestedValue(config2, key, parsedValue);
   saveConfig(config2);
-  console.log(import_chalk17.default.green("") + ` Set ${import_chalk17.default.cyan(key)} = ${formatValue(parsedValue)}`);
+  console.log(import_chalk18.default.green("") + ` Set ${import_chalk18.default.cyan(key)} = ${formatValue(parsedValue)}`);
 }
 function showConfigPath() {
   console.log(getConfigPath());
@@ -36744,12 +37246,12 @@ function isValidKey(key) {
 }
 function showAvailableKeys() {
   console.log("Available keys:");
-  console.log("  " + import_chalk17.default.cyan("archive.default") + "          Default archive destination (local, github, linear)");
-  console.log("  " + import_chalk17.default.cyan("archive.github.owner") + "     GitHub repository owner");
-  console.log("  " + import_chalk17.default.cyan("archive.github.repo") + "      GitHub repository name");
-  console.log("  " + import_chalk17.default.cyan("archive.github.labels") + "    Comma-separated labels for GitHub issues");
-  console.log("  " + import_chalk17.default.cyan("archive.linear.teamId") + "    Linear team ID");
-  console.log("  " + import_chalk17.default.cyan("archive.linear.projectId") + " Linear project ID");
+  console.log("  " + import_chalk18.default.cyan("archive.default") + "          Default archive destination (local, github, linear)");
+  console.log("  " + import_chalk18.default.cyan("archive.github.owner") + "     GitHub repository owner");
+  console.log("  " + import_chalk18.default.cyan("archive.github.repo") + "      GitHub repository name");
+  console.log("  " + import_chalk18.default.cyan("archive.github.labels") + "    Comma-separated labels for GitHub issues");
+  console.log("  " + import_chalk18.default.cyan("archive.linear.teamId") + "    Linear team ID");
+  console.log("  " + import_chalk18.default.cyan("archive.linear.projectId") + " Linear project ID");
 }
 function parseValue(key, value) {
   if (key === "archive.github.labels") {
@@ -36758,7 +37260,7 @@ function parseValue(key, value) {
   if (key === "archive.default") {
     const valid = ["local", "github", "linear"];
     if (!valid.includes(value)) {
-      console.log(import_chalk17.default.red("Error:") + ` Invalid value for archive.default. Must be one of: ${valid.join(", ")}`);
+      console.log(import_chalk18.default.red("Error:") + ` Invalid value for archive.default. Must be one of: ${valid.join(", ")}`);
       process.exit(1);
     }
   }
@@ -36770,8 +37272,8 @@ function formatValue(value) {
   }
   return value;
 }
-function getNestedValue(obj, path20) {
-  const parts = path20.split(".");
+function getNestedValue(obj, path21) {
+  const parts = path21.split(".");
   let current = obj;
   for (const part of parts) {
     if (current === void 0 || current === null) {
@@ -36781,8 +37283,8 @@ function getNestedValue(obj, path20) {
   }
   return current;
 }
-function setNestedValue(obj, path20, value) {
-  const parts = path20.split(".");
+function setNestedValue(obj, path21, value) {
+  const parts = path21.split(".");
   let current = obj;
   for (let i = 0; i < parts.length - 1; i++) {
     const part = parts[i];
@@ -36807,21 +37309,21 @@ function flattenConfig(obj, prefix = "") {
 }
 
 // src/commands/schema.ts
-var import_chalk18 = __toESM(require_source());
-import * as fs17 from "fs";
-import * as path18 from "path";
+var import_chalk19 = __toESM(require_source());
+import * as fs18 from "fs";
+import * as path19 from "path";
 var SCHEMA_BASE_URL = "https://brainfile.md/v1";
 var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
 function getBundledSchemasDir() {
-  const distPath = path18.join(__dirname, "..", "schemas");
-  const srcPath = path18.join(__dirname, "..", "..", "src", "schemas");
-  if (fs17.existsSync(distPath)) {
+  const distPath = path19.join(__dirname, "..", "schemas");
+  const srcPath = path19.join(__dirname, "..", "..", "src", "schemas");
+  if (fs18.existsSync(distPath)) {
     return distPath;
   }
-  if (fs17.existsSync(srcPath)) {
+  if (fs18.existsSync(srcPath)) {
     return srcPath;
   }
-  return path18.join(__dirname, "schemas");
+  return path19.join(__dirname, "schemas");
 }
 var BUNDLED_SCHEMAS = [
   {
@@ -36873,17 +37375,17 @@ function schemaListCommand(options, logger) {
     logger.log(JSON.stringify(output, null, 2));
   } else {
     logger.log("");
-    logger.log(import_chalk18.default.bold("Available schemas:"));
+    logger.log(import_chalk19.default.bold("Available schemas:"));
     logger.log("");
     const maxIdLen = Math.max(...BUNDLED_SCHEMAS.map((s) => s.id.length));
     for (const schema2 of BUNDLED_SCHEMAS) {
       logger.log(
-        `  ${import_chalk18.default.cyan(schema2.id.padEnd(maxIdLen))}  ${import_chalk18.default.gray("-")} ${schema2.description}`
+        `  ${import_chalk19.default.cyan(schema2.id.padEnd(maxIdLen))}  ${import_chalk19.default.gray("-")} ${schema2.description}`
       );
     }
     logger.log("");
-    logger.log(import_chalk18.default.gray("Run: brainfile schema <name> to view schema"));
-    logger.log(import_chalk18.default.gray("Run: brainfile schema update to check for updates"));
+    logger.log(import_chalk19.default.gray("Run: brainfile schema <name> to view schema"));
+    logger.log(import_chalk19.default.gray("Run: brainfile schema update to check for updates"));
   }
   checkAutoUpdate(logger);
   return {
@@ -36903,23 +37405,23 @@ function schemaShowCommand(name, options, logger) {
     );
   }
   const schemasDir = getBundledSchemasDir();
-  const schemaPath = path18.join(schemasDir, schemaInfo.file);
-  if (!fs17.existsSync(schemaPath)) {
+  const schemaPath = path19.join(schemasDir, schemaInfo.file);
+  if (!fs18.existsSync(schemaPath)) {
     throw new CLIError(
       `Schema file not found: ${schemaInfo.file}`,
       ExitCode.USER_ERROR,
       `Expected at: ${schemaPath}`
     );
   }
-  const content = fs17.readFileSync(schemaPath, "utf-8");
+  const content = fs18.readFileSync(schemaPath, "utf-8");
   const schema2 = JSON.parse(content);
   if (options.json) {
     logger.log(JSON.stringify(schema2, null, 2));
   } else {
     logger.log("");
-    logger.log(import_chalk18.default.bold(`Schema: ${name}`));
-    logger.log(import_chalk18.default.gray(`Description: ${schemaInfo.description}`));
-    logger.log(import_chalk18.default.gray(`Source: ${SCHEMA_BASE_URL}/${schemaInfo.file}`));
+    logger.log(import_chalk19.default.bold(`Schema: ${name}`));
+    logger.log(import_chalk19.default.gray(`Description: ${schemaInfo.description}`));
+    logger.log(import_chalk19.default.gray(`Source: ${SCHEMA_BASE_URL}/${schemaInfo.file}`));
     logger.log("");
     logger.log(JSON.stringify(schema2, null, 2));
   }
@@ -36943,7 +37445,7 @@ function schemaUpdateCommand(options, logger = defaultLogger) {
   void schemaUpdateAsync(options, logger).catch((error48) => {
     const message = error48 instanceof Error ? error48.message : String(error48);
     if (!options.json) {
-      logger.log(import_chalk18.default.red(`Schema update failed: ${message}`));
+      logger.log(import_chalk19.default.red(`Schema update failed: ${message}`));
     }
   });
   return {
@@ -36956,14 +37458,14 @@ function schemaUpdateCommand(options, logger = defaultLogger) {
 async function schemaUpdateAsync(options, logger) {
   if (!options.json) {
     logger.log("");
-    logger.log(import_chalk18.default.bold("Checking for schema updates..."));
+    logger.log(import_chalk19.default.bold("Checking for schema updates..."));
     logger.log("");
   }
   const schemasDir = getBundledSchemasDir();
   const results = [];
   for (const schemaInfo of BUNDLED_SCHEMAS) {
     const url2 = `${SCHEMA_BASE_URL}/${schemaInfo.file}`;
-    const localPath = path18.join(schemasDir, schemaInfo.file);
+    const localPath = path19.join(schemasDir, schemaInfo.file);
     try {
       const response = await fetchWithTimeout(url2, 1e4);
       if (!response.ok) {
@@ -36977,14 +37479,14 @@ async function schemaUpdateAsync(options, logger) {
       const remoteContent = await response.text();
       const remoteSchema = JSON.parse(remoteContent);
       let localSchema = null;
-      if (fs17.existsSync(localPath)) {
-        const localContent = fs17.readFileSync(localPath, "utf-8");
+      if (fs18.existsSync(localPath)) {
+        const localContent = fs18.readFileSync(localPath, "utf-8");
         localSchema = JSON.parse(localContent);
       }
       const remoteStr = JSON.stringify(remoteSchema);
       const localStr = localSchema ? JSON.stringify(localSchema) : "";
       if (remoteStr !== localStr) {
-        fs17.writeFileSync(localPath, JSON.stringify(remoteSchema, null, 2));
+        fs18.writeFileSync(localPath, JSON.stringify(remoteSchema, null, 2));
         results.push({ id: schemaInfo.id, status: "updated" });
       } else {
         results.push({ id: schemaInfo.id, status: "current" });
@@ -37000,21 +37502,21 @@ async function schemaUpdateAsync(options, logger) {
   } else {
     for (const result of results) {
       if (result.status === "updated") {
-        logger.log(`  ${import_chalk18.default.green("+")} ${import_chalk18.default.cyan(result.id)} - Updated`);
+        logger.log(`  ${import_chalk19.default.green("+")} ${import_chalk19.default.cyan(result.id)} - Updated`);
       } else if (result.status === "current") {
-        logger.log(`  ${import_chalk18.default.gray("=")} ${import_chalk18.default.cyan(result.id)} - Up to date`);
+        logger.log(`  ${import_chalk19.default.gray("=")} ${import_chalk19.default.cyan(result.id)} - Up to date`);
       } else {
         logger.log(
-          `  ${import_chalk18.default.red("!")} ${import_chalk18.default.cyan(result.id)} - Error: ${result.error}`
+          `  ${import_chalk19.default.red("!")} ${import_chalk19.default.cyan(result.id)} - Error: ${result.error}`
         );
       }
     }
     const updatedCount = results.filter((r) => r.status === "updated").length;
     logger.log("");
     if (updatedCount > 0) {
-      logger.log(import_chalk18.default.green(`Updated ${updatedCount} schema(s)`));
+      logger.log(import_chalk19.default.green(`Updated ${updatedCount} schema(s)`));
     } else {
-      logger.log(import_chalk18.default.gray("All schemas are up to date"));
+      logger.log(import_chalk19.default.gray("All schemas are up to date"));
     }
   }
 }
@@ -37053,7 +37555,7 @@ async function checkForUpdatesAsync(logger) {
   let hasUpdates = false;
   for (const schemaInfo of BUNDLED_SCHEMAS) {
     const url2 = `${SCHEMA_BASE_URL}/${schemaInfo.file}`;
-    const localPath = path18.join(schemasDir, schemaInfo.file);
+    const localPath = path19.join(schemasDir, schemaInfo.file);
     try {
       const response = await fetchWithTimeout(url2, 5e3);
       if (!response.ok) {
@@ -37061,8 +37563,8 @@ async function checkForUpdatesAsync(logger) {
       }
       const remoteContent = await response.text();
       const remoteSchema = JSON.parse(remoteContent);
-      if (fs17.existsSync(localPath)) {
-        const localContent = fs17.readFileSync(localPath, "utf-8");
+      if (fs18.existsSync(localPath)) {
+        const localContent = fs18.readFileSync(localPath, "utf-8");
         const localSchema = JSON.parse(localContent);
         const remoteStr = JSON.stringify(remoteSchema);
         const localStr = JSON.stringify(localSchema);
@@ -37078,295 +37580,20 @@ async function checkForUpdatesAsync(logger) {
   if (hasUpdates) {
     logger.log("");
     logger.log(
-      import_chalk18.default.yellow("Hint: ") + "Schema updates available. Run " + import_chalk18.default.cyan("brainfile schema update") + " to update."
+      import_chalk19.default.yellow("Hint: ") + "Schema updates available. Run " + import_chalk19.default.cyan("brainfile schema update") + " to update."
     );
   }
 }
 
-// src/commands/rules.ts
-var import_chalk19 = __toESM(require_source());
-var import_core45 = __toESM(require_dist());
-import * as fs18 from "fs";
-var VALID_CATEGORIES = ["always", "never", "prefer", "context"];
-var CATEGORY_DESCRIPTIONS = {
-  always: "Rules that must always be followed",
-  never: "Things that should never be done",
-  prefer: "Preferred approaches when applicable",
-  context: "Context-specific guidelines"
-};
-var RULES_COMMAND_HELP = `
-Examples:
-  brainfile rules                     # List all rules
-  brainfile rules list                # List all rules
-  brainfile rules list --category always  # List only 'always' rules
-  brainfile rules add always "Use TypeScript strict mode"
-  brainfile rules add never "Commit .env files"
-  brainfile rules add prefer "Functional over imperative style"
-  brainfile rules add context "For API routes, use Express middleware"
-  brainfile rules delete always 1     # Delete rule with id=1 from 'always'
-  brainfile rules --json              # Output as JSON
-
-Categories:
-  always   - ${CATEGORY_DESCRIPTIONS.always}
-  never    - ${CATEGORY_DESCRIPTIONS.never}
-  prefer   - ${CATEGORY_DESCRIPTIONS.prefer}
-  context  - ${CATEGORY_DESCRIPTIONS.context}
-
-Notes:
-  - Rules are stored in brainfile.md frontmatter under the 'rules' field
-  - Each rule has an auto-generated numeric ID within its category
-  - Rules provide guidance to AI agents working on the project
-`.trimEnd();
-function validateCategory(category) {
-  const lower = category.toLowerCase();
-  if (!VALID_CATEGORIES.includes(lower)) {
-    throw new CLIError(
-      `Invalid category: ${category}`,
-      ExitCode.USER_ERROR,
-      `Valid categories: ${VALID_CATEGORIES.join(", ")}`
-    );
-  }
-  return lower;
-}
-function readBoardFromFile(filePath) {
-  const resolvedPath = resolveCliBrainfilePath(filePath);
-  if (!fs18.existsSync(resolvedPath)) {
-    throw new CLIError(
-      `File not found: ${resolvedPath}`,
-      ExitCode.USER_ERROR
-    );
-  }
-  const content = fs18.readFileSync(resolvedPath, "utf-8");
-  const result = import_core45.Brainfile.parseWithErrors(content);
-  if (!result.board) {
-    throw new CLIError(
-      "Failed to parse brainfile",
-      ExitCode.USER_ERROR,
-      result.error
-    );
-  }
-  return { board: result.board, resolvedPath };
-}
-function writeBoard(filePath, board) {
-  const content = import_core45.Brainfile.serialize(board);
-  fs18.writeFileSync(filePath, content, "utf-8");
-}
-function countRules(rules) {
-  if (!rules) return 0;
-  return (rules.always?.length || 0) + (rules.never?.length || 0) + (rules.prefer?.length || 0) + (rules.context?.length || 0);
-}
-function rulesListCommand(options, logger = defaultLogger) {
-  const { board } = readBoardFromFile(options.file);
-  const rules = board.rules || {};
-  const totalCount = countRules(rules);
-  let displayRules = rules;
-  if (options.category) {
-    const cat = validateCategory(options.category);
-    displayRules = { [cat]: rules[cat] || [] };
-  }
-  if (options.json) {
-    const output = {
-      rules: displayRules,
-      totalCount: options.category ? displayRules[options.category]?.length || 0 : totalCount
-    };
-    logger.log(JSON.stringify(output, null, 2));
-  } else {
-    if (totalCount === 0) {
-      logger.log("");
-      logger.log(import_chalk19.default.gray("No rules defined."));
-      logger.log(import_chalk19.default.gray('Run: brainfile rules add <category> "<rule text>"'));
-    } else {
-      logger.log("");
-      logger.log(import_chalk19.default.bold("Project Rules"));
-      logger.log("");
-      for (const category of VALID_CATEGORIES) {
-        if (options.category && options.category !== category) continue;
-        const categoryRules = displayRules[category];
-        if (!categoryRules || categoryRules.length === 0) continue;
-        const categoryColor = getCategoryColor(category);
-        logger.log(categoryColor(`${category.toUpperCase()}:`));
-        for (const rule of categoryRules) {
-          logger.log(`  ${import_chalk19.default.gray(`[${rule.id}]`)} ${rule.rule}`);
-        }
-        logger.log("");
-      }
-    }
-  }
-  return {
-    success: true,
-    action: "list",
-    rules: displayRules,
-    totalCount
-  };
-}
-function getCategoryColor(category) {
-  switch (category) {
-    case "always":
-      return import_chalk19.default.green;
-    case "never":
-      return import_chalk19.default.red;
-    case "prefer":
-      return import_chalk19.default.blue;
-    case "context":
-      return import_chalk19.default.yellow;
-  }
-}
-function rulesAddCommand(options, logger = defaultLogger) {
-  const category = validateCategory(options.category);
-  const { board, resolvedPath } = readBoardFromFile(options.file);
-  const result = (0, import_core45.addRule)(board, category, options.text);
-  if (!result.success || !result.board) {
-    throw new CLIError(
-      result.error || "Failed to add rule",
-      ExitCode.USER_ERROR
-    );
-  }
-  writeBoard(resolvedPath, result.board);
-  const newRules = result.board.rules?.[category] || [];
-  const newRule = newRules[newRules.length - 1];
-  if (options.json) {
-    const output = {
-      success: true,
-      action: "add",
-      category,
-      rule: newRule
-    };
-    logger.log(JSON.stringify(output, null, 2));
-  } else {
-    const categoryColor = getCategoryColor(category);
-    logger.log("");
-    logger.log(
-      `${import_chalk19.default.green("+")} Added ${categoryColor(category)} rule: ${import_chalk19.default.gray(`[${newRule.id}]`)} ${newRule.rule}`
-    );
-  }
-  return {
-    success: true,
-    action: "add",
-    category,
-    rule: newRule
-  };
-}
-function rulesDeleteCommand(options, logger = defaultLogger) {
-  const category = validateCategory(options.category);
-  const { board, resolvedPath } = readBoardFromFile(options.file);
-  const existingRules = board.rules?.[category] || [];
-  const ruleToDelete = existingRules.find((r) => r.id === options.id);
-  if (!ruleToDelete) {
-    throw new CLIError(
-      `Rule ${options.id} not found in ${category}`,
-      ExitCode.USER_ERROR,
-      existingRules.length > 0 ? `Available IDs in ${category}: ${existingRules.map((r) => r.id).join(", ")}` : `No rules in ${category} category`
-    );
-  }
-  const result = (0, import_core45.deleteRule)(board, category, options.id);
-  if (!result.success || !result.board) {
-    throw new CLIError(
-      result.error || "Failed to delete rule",
-      ExitCode.USER_ERROR
-    );
-  }
-  writeBoard(resolvedPath, result.board);
-  if (options.json) {
-    const output = {
-      success: true,
-      action: "delete",
-      category,
-      id: options.id,
-      deletedRule: ruleToDelete
-    };
-    logger.log(JSON.stringify(output, null, 2));
-  } else {
-    const categoryColor = getCategoryColor(category);
-    logger.log("");
-    logger.log(
-      `${import_chalk19.default.red("-")} Deleted ${categoryColor(category)} rule: ${import_chalk19.default.gray(`[${options.id}]`)} ${ruleToDelete.rule}`
-    );
-  }
-  return {
-    success: true,
-    action: "delete",
-    category,
-    id: options.id
-  };
-}
-function rulesCommand(action, args, options, logger = defaultLogger) {
-  const effectiveAction = action || "list";
-  switch (effectiveAction) {
-    case "list":
-      return rulesListCommand(
-        {
-          file: options.file,
-          json: options.json,
-          category: options.category
-        },
-        logger
-      );
-    case "add": {
-      if (args.length < 2) {
-        throw new CLIError(
-          "Usage: brainfile rules add <category> <text>",
-          ExitCode.USER_ERROR,
-          `Categories: ${VALID_CATEGORIES.join(", ")}`
-        );
-      }
-      const [category, ...textParts] = args;
-      const text = textParts.join(" ");
-      return rulesAddCommand(
-        {
-          file: options.file,
-          category,
-          text,
-          json: options.json
-        },
-        logger
-      );
-    }
-    case "delete": {
-      if (args.length < 2) {
-        throw new CLIError(
-          "Usage: brainfile rules delete <category> <id>",
-          ExitCode.USER_ERROR,
-          `Categories: ${VALID_CATEGORIES.join(", ")}`
-        );
-      }
-      const [category, idStr] = args;
-      const id = parseInt(idStr, 10);
-      if (isNaN(id)) {
-        throw new CLIError(
-          `Invalid rule ID: ${idStr}`,
-          ExitCode.USER_ERROR,
-          "Rule ID must be a number"
-        );
-      }
-      return rulesDeleteCommand(
-        {
-          file: options.file,
-          category,
-          id,
-          json: options.json
-        },
-        logger
-      );
-    }
-    default:
-      throw new CLIError(
-        `Unknown action: ${effectiveAction}`,
-        ExitCode.USER_ERROR,
-        "Valid actions: list, add, delete"
-      );
-  }
-}
-
 // src/commands/adr.ts
 var import_chalk20 = __toESM(require_source());
 var import_core46 = __toESM(require_dist());
 import * as fs19 from "fs";
-import * as path19 from "path";
-var VALID_CATEGORIES2 = ["prefer", "always", "never", "context"];
+import * as path20 from "path";
 var ADR_COMMAND_HELP = `
 Examples:
-  brainfile adr promote -t adr-1 --category prefer
-  brainfile adr promote -t adr-12 --category always -f .brainfile/brainfile.md
+  brainfile adr promote -t adr-1
+  brainfile adr promote -t adr-12 -f .brainfile/brainfile.md
 `.trimEnd();
 function assertSafeTaskId3(taskId) {
   const trimmed = taskId.trim();
@@ -37376,86 +37603,21 @@ function assertSafeTaskId3(taskId) {
   if (taskId === "." || taskId === "..") {
     throw operationFailed(`Invalid task ID: ${taskId}`);
   }
-  if (path19.isAbsolute(taskId) || /[\\/]/.test(taskId)) {
+  if (path20.isAbsolute(taskId) || /[\\/]/.test(taskId)) {
     throw operationFailed(`Invalid task ID: ${taskId}`);
   }
 }
-function validateCategory2(category) {
-  if (!category) {
-    throw missingRequired(
-      "--category",
-      "brainfile adr promote --task <adr-id> --category <prefer|always|never|context> [--file <path>]"
-    );
-  }
-  const normalized = category.trim().toLowerCase();
-  if (!VALID_CATEGORIES2.includes(normalized)) {
-    throw new CLIError(
-      `Invalid category: ${category}`,
-      ExitCode.USER_ERROR,
-      `Valid categories: ${VALID_CATEGORIES2.join(", ")}`
-    );
-  }
-  return normalized;
-}
-function readBoard(filePath) {
-  const resolvedPath = resolveCliBrainfilePath(filePath);
-  if (!fs19.existsSync(resolvedPath)) {
-    throw fileNotFound(resolvedPath);
-  }
-  const content = fs19.readFileSync(resolvedPath, "utf-8");
-  const parsed = import_core46.Brainfile.parseWithErrors(content);
-  if (!parsed.board) {
-    throw operationFailed(parsed.error || "Failed to parse brainfile");
-  }
-  return { board: parsed.board, resolvedPath };
-}
-function writeBoard2(filePath, board) {
-  fs19.writeFileSync(filePath, import_core46.Brainfile.serialize(board), "utf-8");
-}
-function extractRuleText(title) {
-  const trimmed = title.trim();
-  const withoutAdrPrefix = trimmed.replace(/^ADR-\d+\s*:\s*/i, "").trim();
-  return withoutAdrPrefix.length > 0 ? withoutAdrPrefix : trimmed;
-}
-function parseRuleId(id) {
-  if (typeof id === "number" && Number.isFinite(id)) {
-    return id;
-  }
-  if (typeof id === "string") {
-    const prefixed = id.match(/^rule-(\d+)$/i);
-    if (prefixed) {
-      return Number(prefixed[1]);
-    }
-    const numeric = id.match(/^(\d+)$/);
-    if (numeric) {
-      return Number(numeric[1]);
-    }
-  }
-  return null;
-}
-function getNextRuleId(rules) {
-  if (!rules) return 1;
-  let maxId = 0;
-  for (const categoryRules of Object.values(rules)) {
-    if (!Array.isArray(categoryRules)) continue;
-    for (const rule of categoryRules) {
-      const parsedId = parseRuleId(rule?.id);
-      if (parsedId !== null) {
-        maxId = Math.max(maxId, parsedId);
-      }
-    }
-  }
-  return maxId + 1;
-}
 function adrPromoteCommand(options, logger = defaultLogger) {
   if (!options.task) {
     throw missingRequired(
       "--task",
-      "brainfile adr promote --task <adr-id> --category <prefer|always|never|context> [--file <path>]"
+      "brainfile adr promote --task <adr-id> [--file <path>]"
     );
   }
-  const category = validateCategory2(options.category);
-  const { board, resolvedPath } = readBoard(options.file);
+  const resolvedPath = resolveCliBrainfilePath(options.file);
+  if (!fs19.existsSync(resolvedPath)) {
+    throw fileNotFound(resolvedPath);
+  }
   if (!(0, import_core.isV2)(resolvedPath)) {
     throw operationFailed("adr promote requires v2 per-task file architecture. Run: brainfile migrate");
   }
@@ -37472,19 +37634,6 @@ function adrPromoteCommand(options, logger = defaultLogger) {
       `Only ADRs can be promoted. ${task.id} has type "${task.type || "unknown"}".`
     );
   }
-  const ruleText = extractRuleText(task.title);
-  const ruleId = getNextRuleId(board.rules);
-  const promotedRule = {
-    id: ruleId,
-    rule: ruleText,
-    source: task.id
-  };
-  if (!board.rules || typeof board.rules !== "object" || Array.isArray(board.rules)) {
-    board.rules = {};
-  }
-  const categoryRules = Array.isArray(board.rules[category]) ? board.rules[category] : [];
-  board.rules[category] = [...categoryRules, promotedRule];
-  writeBoard2(resolvedPath, board);
   const completedAt = (/* @__PURE__ */ new Date()).toISOString();
   const promotedTask = {
     ...task,
@@ -37494,7 +37643,7 @@ function adrPromoteCommand(options, logger = defaultLogger) {
   delete promotedTask.column;
   delete promotedTask.position;
   fs19.mkdirSync(dirs.logsDir, { recursive: true });
-  const logPath = path19.join(dirs.logsDir, (0, import_core46.taskFileName)(task.id));
+  const logPath = path20.join(dirs.logsDir, (0, import_core46.taskFileName)(task.id));
   if (fs19.existsSync(logPath)) {
     throw operationFailed(`Log already exists for ADR: ${task.id}`);
   }
@@ -37503,15 +37652,12 @@ function adrPromoteCommand(options, logger = defaultLogger) {
   logger.log(import_chalk20.default.green("ADR promoted!"));
   logger.log("");
   logger.log(import_chalk20.default.gray(`  ADR:         ${task.id} - ${task.title}`));
-  logger.log(import_chalk20.default.gray(`  Category:    ${category}`));
-  logger.log(import_chalk20.default.gray(`  Rule:        ${promotedRule.rule}`));
-  logger.log(import_chalk20.default.gray(`  Source:      ${promotedRule.source}`));
+  logger.log(import_chalk20.default.gray(`  Status:      promoted`));
   logger.log(import_chalk20.default.gray(`  Moved to:    logs/${task.id}.md`));
   return {
     success: true,
     taskId: task.id,
-    category,
-    rule: promotedRule,
+    title: task.title,
     completedAt
   };
 }
@@ -40916,13 +41062,13 @@ function typesAddCommand(options, logger = defaultLogger) {
 
 // src/cli.ts
 async function runTui(options) {
-  const { tuiCommand } = await import("./tui-P56H4X7N.mjs");
+  const { tuiCommand } = await import("./tui-H3RI22S4.mjs");
   return tuiCommand(options);
 }
 var packageJson = JSON.parse(
-  readFileSync10(join14(__dirname, "..", "package.json"), "utf8")
+  readFileSync9(join15(__dirname, "..", "package.json"), "utf8")
 );
-var SUBCOMMANDS = ["init", "migrate", "list", "show", "add", "move", "patch", "delete", "archive", "restore", "complete", "log", "note", "search", "subtask", "template", "lint", "tui", "hooks", "mcp", "auth", "config", "contract", "schema", "rules", "adr", "plan", "types", "help"];
+var SUBCOMMANDS = ["init", "migrate", "list", "show", "add", "move", "patch", "delete", "archive", "restore", "complete", "log", "note", "brief", "search", "subtask", "template", "lint", "tui", "hooks", "mcp", "auth", "config", "contract", "schema", "adr", "plan", "types", "help"];
 function shouldLaunchTUI() {
   const args = process.argv.slice(2);
   if (args.length === 0) {
@@ -40983,7 +41129,7 @@ Brainfile file resolution (when you don't pass --file):
   4) .bb.md
 `.trimEnd());
   program2.command("init").description("Initialize a new .brainfile/brainfile.md in the current directory").option("-f, --file <path>", "Path to brainfile file", ".brainfile/brainfile.md").option("--force", "Overwrite existing file").action(initCommand);
-  program2.command("migrate").description("Migrate legacy brainfile layouts to v2 (.brainfile/brainfile.md + board/ + logs/)").option("--dir <path>", "Directory containing legacy brainfile files (default: cwd)").option("--force", "Overwrite existing migration outputs (task files/backups)").option("--v2", "Deprecated alias; migration now targets v2 by default").option("--logs-to-ledger", "Migrate logs/*.md files into ledger.jsonl (resolves ID conflicts with board)").action(migrateCommand);
+  program2.command("migrate").description("Migrate legacy brainfile layouts to v2 (.brainfile/brainfile.md + board/ + logs/)").option("--dir <path>", "Directory containing legacy brainfile files (default: cwd)").option("--force", "Overwrite existing migration outputs (task files/backups)").option("--v2", "Deprecated alias; migration now targets v2 by default").option("--logs-to-ledger", "Backfill logs/*.md into ledger.jsonl, keeping the markdown archives (resolves ID conflicts with board)").action(migrateCommand);
   const listCmd = program2.command("list").description("List tasks").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").option("-c, --column <name>", "Filter by column").option("-t, --tag <name>", "Filter by tag").option("--parent <id>", "Filter by parent task ID (parentId)").option("--contract <status>", "Filter by contract status (ready|in_progress|delivered|done|failed)").action((options) => {
     listCommand(options);
   });
@@ -41019,7 +41165,7 @@ ${LIST_COMMAND_HELP}`);
 ${ADD_COMMAND_HELP}`);
   program2.command("patch").description("Update task fields (partial update)").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").option("-t, --task <id>", "Task ID to update (required)").option("--title <text>", "New task title").option("-d, --description <text>", "New task description").option("-p, --priority <level>", 'Priority (low, medium, high, critical, or "none" to remove)').option("--tags <tags>", "Comma-separated tags (replaces existing)").option("--assignee <name>", "Assignee name").option("--due-date <date>", "Due date (YYYY-MM-DD)").option("--clear-tags", "Remove all tags").option("--clear-assignee", "Remove assignee").option("--clear-due-date", "Remove due date").option("--clear-priority", "Remove priority").action(patchCommand);
   program2.command("delete").description("Delete a task permanently").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").option("-t, --task <id>", "Task ID to delete (required)").option("--force", "Confirm deletion (required)").action(deleteCommand);
-  program2.command("archive").description("Archive a task (locally or to GitHub/Linear)").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").option("-t, --task <id>", "Task ID to archive").option("--to <destination>", "Archive destination: local, github, or linear").option("--all", "Archive all tasks from local archive to external service").option("--dry-run", "Preview what would be created without making changes").action(archiveCommand);
+  program2.command("archive").description("Complete a task locally, or export a completed task to GitHub/Linear").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").option("-t, --task <id>", "Task ID to archive").option("--to <destination>", "Archive destination: local, github, or linear").option("--all", "Archive all tasks from local archive to external service").option("--dry-run", "Preview what would be created without making changes").action(archiveCommand);
   program2.command("restore").description("Restore a task from the archive").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").option("-t, --task <id>", "Task ID to restore (required)").option("-c, --column <name>", "Target column name or ID (required)").action(restoreCommand);
   program2.command("complete").description("Complete a task (moves it to logs/)").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").option("-t, --task <id>", "Task ID to complete (required)").option("--force", "Force epic completion even if child tasks are still active").action((options) => {
     completeCommand(options);
@@ -41030,6 +41176,9 @@ ${ADD_COMMAND_HELP}`);
   program2.command("note").description("Append a timestamped note to a task log").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").option("-t, --task <id>", "Task ID to add note to (required)").option("--agent <name>", "Agent name for attribution").argument("[message]", "Log message to append").action((message, options) => {
     logNoteCommand({ ...options, message });
   });
+  program2.command("brief").description("Per-agent brief: what changed since this agent last checked in").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").option("--agent <name>", "Agent identifier (required \u2014 brief state is per-agent)").option("--peek", "Read the brief without marking it as seen").option("--json", "Output as JSON").action((options) => {
+    briefCommand(options);
+  });
   program2.command("search").description("Search across active tasks and completed logs").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").option("-c, --column <name>", "Filter by column").argument("<query>", "Search query").action((query, options) => {
     searchCommand({ ...options, query });
   });
@@ -41043,7 +41192,7 @@ ${ADD_COMMAND_HELP}`);
   program2.command("lint").description("Validate and auto-fix brainfile.md syntax").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").option("--fix", "Automatically fix issues when possible").option("--check", "Exit with error code if issues found (for CI/CD)").action((options) => {
     lintCommand(options);
   });
-  program2.command("tui").description("Launch interactive Terminal UI for task management").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").action((options) => {
+  program2.command("tui").description("Launch the interactive board").option("-f, --file <path>", "Path to the board file (auto-detected by default)", "brainfile.md").action((options) => {
     void runTui(options).catch((error48) => {
       console.error(error48 instanceof Error ? error48.message : String(error48));
       process.exit(1);
@@ -41144,19 +41293,10 @@ ${PLAN_COMMAND_HELP}`);
   });
   schemaCmd.addHelpText("after", `
 ${SCHEMA_COMMAND_HELP}`);
-  const rulesCmd = program2.command("rules [action]").description("Manage project rules (always, never, prefer, context)").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").option("--json", "Output in JSON format").option("--category <category>", "Filter by category (for list)").argument("[args...]", "Arguments for the action (category, text/id)").action((action, args, options) => {
-    rulesCommand(action, args, {
-      file: options.file,
-      json: options.json,
-      category: options.category
-    });
-  });
-  rulesCmd.addHelpText("after", `
-${RULES_COMMAND_HELP}`);
   const adrCmd = program2.command("adr").description("Manage Architectural Decision Records (ADR) lifecycle");
   adrCmd.addHelpText("after", `
 ${ADR_COMMAND_HELP}`);
-  adrCmd.command("promote").description("Promote an ADR into a project rule and move it to logs/").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").option("-t, --task <id>", "ADR task ID to promote (required)").option("--category <category>", "Rule category (prefer|always|never|context)").action((options) => {
+  adrCmd.command("promote").description("Mark an ADR accepted and move it to logs/").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").option("-t, --task <id>", "ADR task ID to promote (required)").action((options) => {
     adrPromoteCommand(options);
   });
   program2.command("types [action]").description("Inspect and manage board document types").option("-f, --file <path>", "Path to brainfile file (auto-detect by default)", "brainfile.md").option("--json", "Output in JSON format (list action)").option("--id-prefix <prefix>", "ID prefix to use for the type (add action; default: type name)").option("--completable <bool>", "Whether this type can be completed (add action; default: true)").option("--schema <url>", "Optional schema URL/path for this type (add action)").argument("[name]", "Type name (required for add action)").action((action, name, options) => {
@@ -41181,7 +41321,7 @@ ${ADR_COMMAND_HELP}`);
     }
     throw new Error(`Unknown types action: ${action}`);
   });
-  program2.parse();
+  program2.parseAsync().catch(renderCliError);
 }
 /*! Bundled license information: