brainfile 0.19.0 → 0.21.0

package/dist/{chunk-YTFLC673.mjs → chunk-FOLBAGJS.mjs}

@@ -880,15 +880,15 @@ var require_route = __commonJS({
       };
     }
     function wrapConversion(toModel, graph) {
-      const path7 = [graph[toModel].parent, toModel];
+      const path11 = [graph[toModel].parent, toModel];
       let fn = conversions[graph[toModel].parent][toModel];
       let cur = graph[toModel].parent;
       while (graph[cur].parent) {
-        path7.unshift(graph[cur].parent);
+        path11.unshift(graph[cur].parent);
         fn = link(conversions[graph[cur].parent][cur], fn);
         cur = graph[cur].parent;
       }
-      fn.conversion = path7;
+      fn.conversion = path11;
       return fn;
     }
     module.exports = function(fromModel) {
@@ -1003,7 +1003,7 @@ var require_ansi_styles = __commonJS({
       });
     };
     var colorConvert;
-    var makeDynamicStyles = (wrap, targetSpace, identity, isBackground) => {
+    var makeDynamicStyles = (wrap, targetSpace, identity2, isBackground) => {
       if (colorConvert === void 0) {
         colorConvert = require_color_convert();
       }
@@ -1012,7 +1012,7 @@ var require_ansi_styles = __commonJS({
       for (const [sourceSpace, suite] of Object.entries(colorConvert)) {
         const name = sourceSpace === "ansi16" ? "ansi" : sourceSpace;
         if (sourceSpace === targetSpace) {
-          styles[name] = wrap(identity, offset);
+          styles[name] = wrap(identity2, offset);
         } else if (typeof suite === "object") {
           styles[name] = wrap(suite[targetSpace], offset);
         }
@@ -1128,7 +1128,7 @@ var require_has_flag = __commonJS({
 var require_supports_color = __commonJS({
   "../node_modules/supports-color/index.js"(exports, module) {
     "use strict";
-    var os2 = __require("os");
+    var os5 = __require("os");
     var tty = __require("tty");
     var hasFlag = require_has_flag();
     var { env } = process;
@@ -1176,7 +1176,7 @@ var require_supports_color = __commonJS({
         return min;
       }
       if (process.platform === "win32") {
-        const osRelease = os2.release().split(".");
+        const osRelease = os5.release().split(".");
         if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
           return Number(osRelease[2]) >= 14931 ? 3 : 2;
         }
@@ -1327,14 +1327,14 @@ var require_templates = __commonJS({
       }
       return results;
     }
-    function buildStyle(chalk4, styles) {
+    function buildStyle(chalk5, styles) {
       const enabled = {};
       for (const layer of styles) {
         for (const style of layer.styles) {
           enabled[style[0]] = layer.inverse ? null : style.slice(1);
         }
       }
-      let current = chalk4;
+      let current = chalk5;
       for (const [styleName, styles2] of Object.entries(enabled)) {
         if (!Array.isArray(styles2)) {
           continue;
@@ -1346,7 +1346,7 @@ var require_templates = __commonJS({
       }
       return current;
     }
-    module.exports = (chalk4, temporary) => {
+    module.exports = (chalk5, temporary) => {
       const styles = [];
       const chunks = [];
       let chunk = [];
@@ -1356,13 +1356,13 @@ var require_templates = __commonJS({
         } else if (style) {
           const string = chunk.join("");
           chunk = [];
-          chunks.push(styles.length === 0 ? string : buildStyle(chalk4, styles)(string));
+          chunks.push(styles.length === 0 ? string : buildStyle(chalk5, styles)(string));
           styles.push({ inverse, styles: parseStyle(style) });
         } else if (close) {
           if (styles.length === 0) {
             throw new Error("Found extraneous } in Chalk template literal");
           }
-          chunks.push(buildStyle(chalk4, styles)(chunk.join("")));
+          chunks.push(buildStyle(chalk5, styles)(chunk.join("")));
           chunk = [];
           styles.pop();
         } else {
@@ -1410,16 +1410,16 @@ var require_source = __commonJS({
       }
     };
     var chalkFactory = (options) => {
-      const chalk5 = {};
-      applyOptions(chalk5, options);
-      chalk5.template = (...arguments_) => chalkTag(chalk5.template, ...arguments_);
-      Object.setPrototypeOf(chalk5, Chalk.prototype);
-      Object.setPrototypeOf(chalk5.template, chalk5);
-      chalk5.template.constructor = () => {
+      const chalk6 = {};
+      applyOptions(chalk6, options);
+      chalk6.template = (...arguments_) => chalkTag(chalk6.template, ...arguments_);
+      Object.setPrototypeOf(chalk6, Chalk.prototype);
+      Object.setPrototypeOf(chalk6.template, chalk6);
+      chalk6.template.constructor = () => {
         throw new Error("`chalk.constructor()` is deprecated. Use `new chalk.Instance()` instead.");
       };
-      chalk5.template.Instance = ChalkClass;
-      return chalk5.template;
+      chalk6.template.Instance = ChalkClass;
+      return chalk6.template;
     };
     function Chalk(options) {
       return chalkFactory(options);
@@ -1530,7 +1530,7 @@ var require_source = __commonJS({
       return openAll + string + closeAll;
     };
     var template;
-    var chalkTag = (chalk5, ...strings) => {
+    var chalkTag = (chalk6, ...strings) => {
       const [firstString] = strings;
       if (!isArray(firstString) || !isArray(firstString.raw)) {
         return strings.join(" ");
@@ -1546,14 +1546,14 @@ var require_source = __commonJS({
       if (template === void 0) {
         template = require_templates();
       }
-      return template(chalk5, parts.join(""));
+      return template(chalk6, parts.join(""));
     };
     Object.defineProperties(Chalk.prototype, styles);
-    var chalk4 = Chalk();
-    chalk4.supportsColor = stdoutColor;
-    chalk4.stderr = Chalk({ level: stderrColor ? stderrColor.level : 0 });
-    chalk4.stderr.supportsColor = stderrColor;
-    module.exports = chalk4;
+    var chalk5 = Chalk();
+    chalk5.supportsColor = stdoutColor;
+    chalk5.stderr = Chalk({ level: stderrColor ? stderrColor.level : 0 });
+    chalk5.stderr.supportsColor = stderrColor;
+    module.exports = chalk5;
   }
 });
 
@@ -2086,12 +2086,12 @@ var require_contractSpec = __commonJS({
       const type = raw.slice(0, firstColon).trim();
       const rest = raw.slice(firstColon + 1);
       const secondColon = rest.indexOf(":");
-      const path7 = (secondColon === -1 ? rest : rest.slice(0, secondColon)).trim();
+      const path11 = (secondColon === -1 ? rest : rest.slice(0, secondColon)).trim();
       const description = (secondColon === -1 ? "" : rest.slice(secondColon + 1)).trim();
       if (!type) {
         throw new Error(`Invalid deliverable format: "${spec}". Expected "type:path:description" with non-empty type.`);
       }
-      if (!path7) {
+      if (!path11) {
         throw new Error(`Invalid deliverable format: "${spec}". Expected "type:path:description" with non-empty path.`);
       }
       const typeLower = type.toLowerCase();
@@ -2100,7 +2100,7 @@ var require_contractSpec = __commonJS({
       }
       const deliverable = {
         type: typeLower,
-        path: path7,
+        path: path11,
         ...description ? { description } : {}
       };
       return deliverable;
@@ -5421,61 +5421,6 @@ var require_parser = __commonJS({
         }
         return null;
       }
-      /**
-       * Find the line number of a rule in the YAML frontmatter
-       * @param content - The markdown content
-       * @param ruleId - The rule ID to find
-       * @param ruleType - The type of rule (always, never, prefer, context)
-       * @returns Line and column location or null if not found
-       */
-      static findRuleLocation(content, ruleId, ruleType) {
-        const lines = content.split("\n");
-        let inFrontmatter = false;
-        let inRulesSection = false;
-        let inRuleTypeSection = false;
-        for (let i = 0; i < lines.length; i++) {
-          const line = lines[i];
-          const trimmedLine = line.trim();
-          if (trimmedLine === "---") {
-            if (!inFrontmatter) {
-              inFrontmatter = true;
-              continue;
-            } else {
-              break;
-            }
-          }
-          if (!inFrontmatter)
-            continue;
-          if (trimmedLine === "rules:") {
-            inRulesSection = true;
-            continue;
-          }
-          if (inRulesSection && trimmedLine === `${ruleType}:`) {
-            inRuleTypeSection = true;
-            continue;
-          }
-          if (inRulesSection && line.match(/^[a-z]+:/) && !line.match(/^\s/)) {
-            inRulesSection = false;
-            inRuleTypeSection = false;
-          }
-          if (inRuleTypeSection) {
-            if (line.match(/^\s{2}[a-z]+:/) && !line.includes(`${ruleType}:`)) {
-              inRuleTypeSection = false;
-              continue;
-            }
-            if (line.includes(`id: ${ruleId}`)) {
-              if (line.match(/^\s*-\s+id:\s+/)) {
-                return { line: i + 1, column: 0 };
-              }
-              if (i > 0 && lines[i - 1].match(/^\s*-\s*$/)) {
-                return { line: i, column: 0 };
-              }
-              return { line: i + 1, column: 0 };
-            }
-          }
-        }
-        return null;
-      }
     };
     exports.BrainfileParser = BrainfileParser;
   }
@@ -5625,6 +5570,104 @@ ${yamlContent}---
   }
 });
 
+// ../core/dist/frontmatter.js
+var require_frontmatter = __commonJS({
+  "../core/dist/frontmatter.js"(exports) {
+    "use strict";
+    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    }) : (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    }));
+    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? (function(o, v) {
+      Object.defineProperty(o, "default", { enumerable: true, value: v });
+    }) : function(o, v) {
+      o["default"] = v;
+    });
+    var __importStar = exports && exports.__importStar || /* @__PURE__ */ (function() {
+      var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function(o2) {
+          var ar = [];
+          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
+          return ar;
+        };
+        return ownKeys(o);
+      };
+      return function(mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) {
+          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        }
+        __setModuleDefault(result, mod);
+        return result;
+      };
+    })();
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.parseFrontmatter = parseFrontmatter2;
+    exports.serializeFrontmatter = serializeFrontmatter2;
+    var yaml = __importStar(require_js_yaml());
+    function parseFrontmatter2(content) {
+      const lines = content.split("\n");
+      if (!lines[0] || lines[0].trim() !== "---") {
+        return null;
+      }
+      let endIndex = -1;
+      for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === "---") {
+          endIndex = i;
+          break;
+        }
+      }
+      if (endIndex === -1) {
+        return null;
+      }
+      const yamlContent = lines.slice(1, endIndex).join("\n");
+      const bodyContent = lines.slice(endIndex + 1).join("\n");
+      let parsed;
+      try {
+        parsed = yaml.load(yamlContent);
+      } catch {
+        return null;
+      }
+      if (!parsed || typeof parsed !== "object") {
+        return null;
+      }
+      return {
+        data: parsed,
+        body: bodyContent.replace(/^\n/, "")
+      };
+    }
+    function serializeFrontmatter2(data, body = "") {
+      const yamlContent = yaml.dump(data, {
+        indent: 2,
+        lineWidth: -1,
+        noRefs: true,
+        sortKeys: false,
+        quotingType: '"',
+        forceQuotes: false
+      });
+      const parts = ["---\n", yamlContent, "---\n"];
+      if (body.length > 0) {
+        parts.push("\n");
+        parts.push(body);
+        if (!body.endsWith("\n")) {
+          parts.push("\n");
+        }
+      }
+      return parts.join("");
+    }
+  }
+});
+
 // ../core/dist/validator.js
 var require_validator = __commonJS({
   "../core/dist/validator.js"(exports) {
@@ -5656,10 +5699,6 @@ var require_validator = __commonJS({
             errors.push(...columnErrors);
           });
         }
-        if (board.rules !== void 0) {
-          const rulesErrors = this.validateRules(board.rules, "rules");
-          errors.push(...rulesErrors);
-        }
         if (board.archive !== void 0) {
           if (!Array.isArray(board.archive)) {
             errors.push({ path: "archive", message: "Archive must be an array" });
@@ -5689,23 +5728,23 @@ var require_validator = __commonJS({
        * @param path - The path for error reporting
        * @returns Array of validation errors
        */
-      static validateColumn(column, path7) {
+      static validateColumn(column, path11) {
         const errors = [];
         if (!column) {
-          errors.push({ path: path7, message: "Column is null or undefined" });
+          errors.push({ path: path11, message: "Column is null or undefined" });
           return errors;
         }
         if (typeof column.id !== "string" || column.id.trim() === "") {
-          errors.push({ path: `${path7}.id`, message: "Column id must be a non-empty string" });
+          errors.push({ path: `${path11}.id`, message: "Column id must be a non-empty string" });
         }
         if (typeof column.title !== "string" || column.title.trim() === "") {
-          errors.push({ path: `${path7}.title`, message: "Column title must be a non-empty string" });
+          errors.push({ path: `${path11}.title`, message: "Column title must be a non-empty string" });
         }
         if (column.tasks !== void 0 && !Array.isArray(column.tasks)) {
-          errors.push({ path: `${path7}.tasks`, message: "Column tasks must be an array" });
+          errors.push({ path: `${path11}.tasks`, message: "Column tasks must be an array" });
         } else if (Array.isArray(column.tasks)) {
           column.tasks.forEach((task, index) => {
-            const taskErrors = this.validateTask(task, `${path7}.tasks[${index}]`);
+            const taskErrors = this.validateTask(task, `${path11}.tasks[${index}]`);
             errors.push(...taskErrors);
           });
         }
@@ -5717,23 +5756,23 @@ var require_validator = __commonJS({
        * @param path - The path for error reporting
        * @returns Array of validation errors
        */
-      static validateTask(task, path7) {
+      static validateTask(task, path11) {
         const errors = [];
         if (!task) {
-          errors.push({ path: path7, message: "Task is null or undefined" });
+          errors.push({ path: path11, message: "Task is null or undefined" });
           return errors;
         }
         if (typeof task.id !== "string" || task.id.trim() === "") {
-          errors.push({ path: `${path7}.id`, message: "Task id must be a non-empty string" });
+          errors.push({ path: `${path11}.id`, message: "Task id must be a non-empty string" });
         }
         if (typeof task.title !== "string" || task.title.trim() === "") {
-          errors.push({ path: `${path7}.title`, message: "Task title must be a non-empty string" });
+          errors.push({ path: `${path11}.title`, message: "Task title must be a non-empty string" });
         }
         if (task.priority !== void 0) {
           const validPriorities = ["low", "medium", "high", "critical"];
           if (!validPriorities.includes(task.priority)) {
             errors.push({
-              path: `${path7}.priority`,
+              path: `${path11}.priority`,
               message: `Task priority must be one of: ${validPriorities.join(", ")}`
             });
           }
@@ -5742,23 +5781,23 @@ var require_validator = __commonJS({
           const validTemplates = ["bug", "feature", "refactor"];
           if (!validTemplates.includes(task.template)) {
             errors.push({
-              path: `${path7}.template`,
+              path: `${path11}.template`,
               message: `Task template must be one of: ${validTemplates.join(", ")}`
             });
           }
         }
         if (task.tags !== void 0 && !Array.isArray(task.tags)) {
-          errors.push({ path: `${path7}.tags`, message: "Task tags must be an array" });
+          errors.push({ path: `${path11}.tags`, message: "Task tags must be an array" });
         }
         if (task.relatedFiles !== void 0 && !Array.isArray(task.relatedFiles)) {
-          errors.push({ path: `${path7}.relatedFiles`, message: "Task relatedFiles must be an array" });
+          errors.push({ path: `${path11}.relatedFiles`, message: "Task relatedFiles must be an array" });
         }
         if (task.subtasks !== void 0) {
           if (!Array.isArray(task.subtasks)) {
-            errors.push({ path: `${path7}.subtasks`, message: "Task subtasks must be an array" });
+            errors.push({ path: `${path11}.subtasks`, message: "Task subtasks must be an array" });
           } else {
             task.subtasks.forEach((subtask, index) => {
-              const subtaskErrors = this.validateSubtask(subtask, `${path7}.subtasks[${index}]`);
+              const subtaskErrors = this.validateSubtask(subtask, `${path11}.subtasks[${index}]`);
               errors.push(...subtaskErrors);
             });
           }
@@ -5771,67 +5810,20 @@ var require_validator = __commonJS({
        * @param path - The path for error reporting
        * @returns Array of validation errors
        */
-      static validateSubtask(subtask, path7) {
+      static validateSubtask(subtask, path11) {
         const errors = [];
         if (!subtask) {
-          errors.push({ path: path7, message: "Subtask is null or undefined" });
+          errors.push({ path: path11, message: "Subtask is null or undefined" });
           return errors;
         }
         if (typeof subtask.id !== "string" || subtask.id.trim() === "") {
-          errors.push({ path: `${path7}.id`, message: "Subtask id must be a non-empty string" });
+          errors.push({ path: `${path11}.id`, message: "Subtask id must be a non-empty string" });
         }
         if (typeof subtask.title !== "string" || subtask.title.trim() === "") {
-          errors.push({ path: `${path7}.title`, message: "Subtask title must be a non-empty string" });
+          errors.push({ path: `${path11}.title`, message: "Subtask title must be a non-empty string" });
         }
         if (typeof subtask.completed !== "boolean") {
-          errors.push({ path: `${path7}.completed`, message: "Subtask completed must be a boolean" });
-        }
-        return errors;
-      }
-      /**
-       * Validate Rules object
-       * @param rules - The rules to validate
-       * @param path - The path for error reporting
-       * @returns Array of validation errors
-       */
-      static validateRules(rules, path7) {
-        const errors = [];
-        if (!rules) {
-          errors.push({ path: path7, message: "Rules is null or undefined" });
-          return errors;
-        }
-        const ruleTypes = ["always", "never", "prefer", "context"];
-        ruleTypes.forEach((ruleType) => {
-          if (rules[ruleType] !== void 0) {
-            if (!Array.isArray(rules[ruleType])) {
-              errors.push({ path: `${path7}.${ruleType}`, message: `Rules ${ruleType} must be an array` });
-            } else {
-              rules[ruleType].forEach((rule, index) => {
-                const ruleErrors = this.validateRule(rule, `${path7}.${ruleType}[${index}]`);
-                errors.push(...ruleErrors);
-              });
-            }
-          }
-        });
-        return errors;
-      }
-      /**
-       * Validate a Rule object
-       * @param rule - The rule to validate
-       * @param path - The path for error reporting
-       * @returns Array of validation errors
-       */
-      static validateRule(rule, path7) {
-        const errors = [];
-        if (!rule) {
-          errors.push({ path: path7, message: "Rule is null or undefined" });
-          return errors;
-        }
-        if (typeof rule.id !== "number") {
-          errors.push({ path: `${path7}.id`, message: "Rule id must be a number" });
-        }
-        if (typeof rule.rule !== "string" || rule.rule.trim() === "") {
-          errors.push({ path: `${path7}.rule`, message: "Rule rule must be a non-empty string" });
+          errors.push({ path: `${path11}.completed`, message: "Subtask completed must be a boolean" });
         }
         return errors;
       }
@@ -5886,10 +5878,6 @@ var require_validator = __commonJS({
             errors.push(...entryErrors);
           });
         }
-        if (journal.rules !== void 0) {
-          const rulesErrors = this.validateRules(journal.rules, "rules");
-          errors.push(...rulesErrors);
-        }
         return { valid: errors.length === 0, errors };
       }
       /**
@@ -5898,32 +5886,32 @@ var require_validator = __commonJS({
        * @param path - The path for error reporting
        * @returns Array of validation errors
        */
-      static validateJournalEntry(entry, path7) {
+      static validateJournalEntry(entry, path11) {
         const errors = [];
         if (!entry) {
-          errors.push({ path: path7, message: "Entry is null or undefined" });
+          errors.push({ path: path11, message: "Entry is null or undefined" });
           return errors;
         }
         if (typeof entry.id !== "string" || entry.id.trim() === "") {
-          errors.push({ path: `${path7}.id`, message: "Entry id must be a non-empty string" });
+          errors.push({ path: `${path11}.id`, message: "Entry id must be a non-empty string" });
         }
         if (typeof entry.title !== "string" || entry.title.trim() === "") {
-          errors.push({ path: `${path7}.title`, message: "Entry title must be a non-empty string" });
+          errors.push({ path: `${path11}.title`, message: "Entry title must be a non-empty string" });
         }
         if (typeof entry.createdAt !== "string" || entry.createdAt.trim() === "") {
-          errors.push({ path: `${path7}.createdAt`, message: "Entry createdAt must be an ISO 8601 timestamp string" });
+          errors.push({ path: `${path11}.createdAt`, message: "Entry createdAt must be an ISO 8601 timestamp string" });
         }
         if (entry.content !== void 0 && typeof entry.content !== "string") {
-          errors.push({ path: `${path7}.content`, message: "Entry content must be a string" });
+          errors.push({ path: `${path11}.content`, message: "Entry content must be a string" });
         }
         if (entry.summary !== void 0 && typeof entry.summary !== "string") {
-          errors.push({ path: `${path7}.summary`, message: "Entry summary must be a string" });
+          errors.push({ path: `${path11}.summary`, message: "Entry summary must be a string" });
         }
         if (entry.mood !== void 0 && typeof entry.mood !== "string") {
-          errors.push({ path: `${path7}.mood`, message: "Entry mood must be a string" });
+          errors.push({ path: `${path11}.mood`, message: "Entry mood must be a string" });
         }
         if (entry.tags !== void 0 && !Array.isArray(entry.tags)) {
-          errors.push({ path: `${path7}.tags`, message: "Entry tags must be an array" });
+          errors.push({ path: `${path11}.tags`, message: "Entry tags must be an array" });
         }
         return errors;
       }
@@ -5974,10 +5962,13 @@ var require_linter = __commonJS({
       };
     })();
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.BrainfileLinter = void 0;
+    exports.BrainfileLinter = exports.LEGACY_RULES_MESSAGE = void 0;
     var yaml = __importStar(require_js_yaml());
     var parser_1 = require_parser();
     var validator_1 = require_validator();
+    var frontmatter_1 = require_frontmatter();
+    exports.LEGACY_RULES_MESSAGE = "rules is removed (adr-2); fold into agent.instructions";
+    var RULE_CATEGORY_ORDER = ["always", "never", "prefer", "context"];
     var BrainfileLinter = class {
       /**
        * Lint a brainfile.md content string
@@ -6004,6 +5995,21 @@ var require_linter = __commonJS({
             fixedContent = this.fixUnquotedStrings(content, quotableStrings);
           }
         }
+        const legacyRules = this.findLegacyRules(fixedContent);
+        if (legacyRules) {
+          issues.push({
+            type: "warning",
+            message: exports.LEGACY_RULES_MESSAGE,
+            line: legacyRules.line,
+            fixable: true,
+            code: "LEGACY_RULES"
+          });
+          if (options.autoFix) {
+            const folded = this.foldLegacyRules(fixedContent);
+            if (folded !== null)
+              fixedContent = folded;
+          }
+        }
         const contentToValidate = options.autoFix && fixedContent !== content ? fixedContent : content;
         const yamlIssues = this.checkYAMLSyntax(contentToValidate);
         if (options.autoFix && fixedContent !== content) {
@@ -6064,6 +6070,62 @@ var require_linter = __commonJS({
           board: board || void 0
         };
       }
+      /**
+       * Locate a legacy top-level `rules:` block in the frontmatter.
+       *
+       * Deliberately textual rather than YAML-object based: this must report a
+       * usable line number, and it must still fire on a file whose frontmatter
+       * fails to `yaml.load` for some unrelated reason.
+       */
+      static findLegacyRules(content) {
+        const lines = content.split("\n");
+        if (!lines[0] || lines[0].trim() !== "---")
+          return null;
+        for (let i = 1; i < lines.length; i++) {
+          if (lines[i].trim() === "---")
+            return null;
+          if (/^rules:\s*$/.test(lines[i]) || /^rules:\s+\S/.test(lines[i])) {
+            return { line: i + 1 };
+          }
+        }
+        return null;
+      }
+      /**
+       * Fold a legacy `rules:` block into `agent.instructions` and remove it.
+       *
+       * Each rule becomes `"<category>: <text>"` (adr-2's stated shape), appended
+       * in category order after any instructions already present. Returns null if
+       * the frontmatter cannot be round-tripped, in which case the caller keeps
+       * the original content and the warning stands unfixed.
+       */
+      static foldLegacyRules(content) {
+        const doc = (0, frontmatter_1.parseFrontmatter)(content);
+        if (!doc)
+          return null;
+        const data = doc.data;
+        const rules = data.rules;
+        if (!rules || typeof rules !== "object" || Array.isArray(rules))
+          return null;
+        const folded = [];
+        for (const category of RULE_CATEGORY_ORDER) {
+          const entries = rules[category];
+          if (!Array.isArray(entries))
+            continue;
+          for (const entry of entries) {
+            const text = typeof entry === "string" ? entry : typeof entry?.rule === "string" ? entry.rule : null;
+            if (text && text.trim())
+              folded.push(`${category}: ${text.trim()}`);
+          }
+        }
+        delete data.rules;
+        if (folded.length > 0) {
+          const agent = data.agent && typeof data.agent === "object" && !Array.isArray(data.agent) ? data.agent : {};
+          const existing = Array.isArray(agent.instructions) ? agent.instructions.filter((i) => typeof i === "string") : [];
+          agent.instructions = [...existing, ...folded];
+          data.agent = agent;
+        }
+        return (0, frontmatter_1.serializeFrontmatter)(data, doc.body);
+      }
       /**
        * Check YAML syntax by attempting to parse
        */
@@ -6212,14 +6274,12 @@ var require_realtimeDiff = __commonJS({
         protocolVersion: previous.protocolVersion,
         schema: previous.schema,
         agent: previous.agent,
-        rules: previous.rules,
         statsConfig: previous.statsConfig
       }, {
         title: next.title,
         protocolVersion: next.protocolVersion,
         schema: next.schema,
         agent: next.agent,
-        rules: next.rules,
         statsConfig: next.statsConfig
       });
       const columnIdToPrev = indexColumns(previous.columns);
@@ -6678,8 +6738,6 @@ var require_operations = __commonJS({
     exports.updateSubtask = updateSubtask;
     exports.setSubtasksCompleted = setSubtasksCompleted;
     exports.setAllSubtasksCompleted = setAllSubtasksCompleted;
-    exports.addRule = addRule;
-    exports.deleteRule = deleteRule;
     exports.moveTasks = moveTasks;
     exports.patchTasks = patchTasks;
     exports.deleteTasks = deleteTasks;
@@ -7162,55 +7220,6 @@ var require_operations = __commonJS({
       };
       return { success: true, board: newBoard };
     }
-    function addRule(board, ruleType, ruleText) {
-      if (!ruleText || ruleText.trim() === "") {
-        return { success: false, error: "Rule text is required" };
-      }
-      const trimmedRule = ruleText.trim();
-      const existingRules = board.rules?.[ruleType] ?? [];
-      const nextId = existingRules.reduce((maxId, rule) => Math.max(maxId, rule.id), 0) + 1;
-      const newRule = {
-        id: nextId,
-        rule: trimmedRule
-      };
-      const updatedRulesForType = [...existingRules, newRule];
-      const updatedRules = {
-        ...board.rules ?? {},
-        [ruleType]: updatedRulesForType
-      };
-      return {
-        success: true,
-        board: {
-          ...board,
-          rules: updatedRules
-        }
-      };
-    }
-    function deleteRule(board, ruleType, ruleId) {
-      const rulesForType = board.rules?.[ruleType];
-      if (!rulesForType || rulesForType.length === 0) {
-        return { success: false, error: `Rule type ${ruleType} has no entries` };
-      }
-      const exists = rulesForType.some((rule) => rule.id === ruleId);
-      if (!exists) {
-        return { success: false, error: `Rule ${ruleId} not found in ${ruleType}` };
-      }
-      const updatedRulesForType = rulesForType.filter((rule) => rule.id !== ruleId);
-      const updatedRules = { ...board.rules ?? {} };
-      if (updatedRulesForType.length > 0) {
-        updatedRules[ruleType] = updatedRulesForType;
-      } else {
-        delete updatedRules[ruleType];
-      }
-      const hasAnyRules = Object.values(updatedRules).some((collection) => collection !== void 0 && collection.length > 0);
-      return {
-        success: true,
-        board: {
-          ...board,
-          rules: hasAnyRules ? updatedRules : void 0
-        }
-      };
-    }
     function moveTasks(board, taskIds, toColumnId) {
       const results = [];
       let currentBoard = board;
@@ -7434,8 +7443,8 @@ var require_discovery = __commonJS({
     exports.findPrimaryBrainfile = findPrimaryBrainfile;
     exports.findNearestBrainfile = findNearestBrainfile;
     exports.watchBrainfiles = watchBrainfiles;
-    var fs7 = __importStar(__require("fs"));
-    var path7 = __importStar(__require("path"));
+    var fs11 = __importStar(__require("fs"));
+    var path11 = __importStar(__require("path"));
     var parser_1 = require_parser();
     var query_1 = require_query();
     exports.BRAINFILE_PATTERNS = [
@@ -7471,7 +7480,7 @@ var require_discovery = __commonJS({
       "vendor"
     ];
     function isBrainfileName(filename) {
-      const name = path7.basename(filename).toLowerCase();
+      const name = path11.basename(filename).toLowerCase();
       if (name === "brainfile.md" || name === ".brainfile.md" || name === ".bb.md") {
         return true;
       }
@@ -7481,11 +7490,11 @@ var require_discovery = __commonJS({
       return false;
     }
     function shouldExclude(filePath, excludeDirs) {
-      const parts = filePath.split(path7.sep);
+      const parts = filePath.split(path11.sep);
       return parts.some((part) => excludeDirs.includes(part));
     }
     function extractBrainfileSuffix(filename) {
-      const name = path7.basename(filename).toLowerCase();
+      const name = path11.basename(filename).toLowerCase();
       if (name.startsWith("brainfile.") && name.endsWith(".md") && name !== "brainfile.md") {
         const withoutPrefix = name.slice("brainfile.".length);
         const suffix = withoutPrefix.slice(0, -".md".length);
@@ -7505,10 +7514,10 @@ var require_discovery = __commonJS({
     }
     function parseFileMetadata(absolutePath, relativePath) {
       try {
-        const content = fs7.readFileSync(absolutePath, "utf-8");
+        const content = fs11.readFileSync(absolutePath, "utf-8");
         const board = parser_1.BrainfileParser.parse(content);
-        const stats = fs7.statSync(absolutePath);
-        const filename = path7.basename(absolutePath);
+        const stats = fs11.statSync(absolutePath);
+        const filename = path11.basename(absolutePath);
         const isHidden = filename.startsWith(".");
         if (board) {
           return {
@@ -7542,10 +7551,10 @@ var require_discovery = __commonJS({
         return results;
       }
       try {
-        const entries = fs7.readdirSync(dir, { withFileTypes: true });
+        const entries = fs11.readdirSync(dir, { withFileTypes: true });
         for (const entry of entries) {
-          const fullPath = path7.join(dir, entry.name);
-          const relativePath = path7.relative(rootDir, fullPath);
+          const fullPath = path11.join(dir, entry.name);
+          const relativePath = path11.relative(rootDir, fullPath);
           if (entry.isDirectory()) {
             if (shouldExclude(entry.name, options.excludeDirs)) {
               continue;
@@ -7577,11 +7586,11 @@ var require_discovery = __commonJS({
         maxDepth: options.maxDepth ?? 10,
         excludeDirs: options.excludeDirs ?? [...exports.EXCLUDE_DIRS]
       };
-      const absoluteRoot = path7.resolve(rootDir);
+      const absoluteRoot = path11.resolve(rootDir);
       const files = findBrainfilesRecursive(absoluteRoot, absoluteRoot, opts);
       files.sort((a, b) => {
-        const aDepth = a.relativePath.split(path7.sep).length;
-        const bDepth = b.relativePath.split(path7.sep).length;
+        const aDepth = a.relativePath.split(path11.sep).length;
+        const bDepth = b.relativePath.split(path11.sep).length;
         if (aDepth !== bDepth) {
           return aDepth - bDepth;
         }
@@ -7595,17 +7604,17 @@ var require_discovery = __commonJS({
       };
     }
     function findPrimaryBrainfile(rootDir) {
-      const absoluteRoot = path7.resolve(rootDir);
-      const preferred = path7.join(absoluteRoot, ".brainfile", "brainfile.md");
-      if (fs7.existsSync(preferred)) {
-        const metadata = parseFileMetadata(preferred, path7.join(".brainfile", "brainfile.md"));
+      const absoluteRoot = path11.resolve(rootDir);
+      const preferred = path11.join(absoluteRoot, ".brainfile", "brainfile.md");
+      if (fs11.existsSync(preferred)) {
+        const metadata = parseFileMetadata(preferred, path11.join(".brainfile", "brainfile.md"));
         if (metadata)
           return metadata;
       }
       const priorityNames = ["brainfile.md", ".brainfile.md", ".bb.md"];
       for (const name of priorityNames) {
-        const fullPath = path7.join(absoluteRoot, name);
-        if (fs7.existsSync(fullPath)) {
+        const fullPath = path11.join(absoluteRoot, name);
+        if (fs11.existsSync(fullPath)) {
           const metadata = parseFileMetadata(fullPath, name);
           if (metadata) {
             return metadata;
@@ -7613,11 +7622,11 @@ var require_discovery = __commonJS({
         }
       }
       try {
-        const entries = fs7.readdirSync(absoluteRoot);
+        const entries = fs11.readdirSync(absoluteRoot);
         for (const entry of entries) {
           if (isBrainfileName(entry) && !priorityNames.includes(entry.toLowerCase())) {
-            const fullPath = path7.join(absoluteRoot, entry);
-            const stats = fs7.statSync(fullPath);
+            const fullPath = path11.join(absoluteRoot, entry);
+            const stats = fs11.statSync(fullPath);
             if (stats.isFile()) {
               const metadata = parseFileMetadata(fullPath, entry);
               if (metadata) {
@@ -7631,14 +7640,14 @@ var require_discovery = __commonJS({
       return null;
     }
     function findNearestBrainfile(startDir) {
-      let currentDir = path7.resolve(startDir || process.cwd());
-      const root = path7.parse(currentDir).root;
+      let currentDir = path11.resolve(startDir || process.cwd());
+      const root = path11.parse(currentDir).root;
       while (currentDir !== root) {
         const found = findPrimaryBrainfile(currentDir);
         if (found) {
           return found;
         }
-        const parentDir = path7.dirname(currentDir);
+        const parentDir = path11.dirname(currentDir);
         if (parentDir === currentDir) {
           break;
         }
@@ -7651,11 +7660,11 @@ var require_discovery = __commonJS({
       return null;
     }
     function watchBrainfiles(rootDir, callback, onError) {
-      const absoluteRoot = path7.resolve(rootDir);
+      const absoluteRoot = path11.resolve(rootDir);
       let watcher = null;
       let active = false;
       try {
-        const stats = fs7.statSync(absoluteRoot);
+        const stats = fs11.statSync(absoluteRoot);
         if (!stats.isDirectory()) {
           return {
             success: false,
@@ -7684,13 +7693,13 @@ var require_discovery = __commonJS({
         };
       }
       try {
-        watcher = fs7.watch(absoluteRoot, (eventType, filename) => {
+        watcher = fs11.watch(absoluteRoot, (eventType, filename) => {
           if (!active || !filename || !isBrainfileName(filename))
             return;
-          const fullPath = path7.join(absoluteRoot, filename);
+          const fullPath = path11.join(absoluteRoot, filename);
           try {
             if (eventType === "rename") {
-              if (fs7.existsSync(fullPath)) {
+              if (fs11.existsSync(fullPath)) {
                 const metadata = parseFileMetadata(fullPath, filename);
                 if (metadata) {
                   callback("add", metadata);
@@ -7797,7 +7806,7 @@ var require_files = __commonJS({
       };
     })();
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.DOT_BRAINFILE_GITIGNORE_BASENAME = exports.BRAINFILE_STATE_BASENAME = exports.BRAINFILE_BASENAME = exports.DOT_BRAINFILE_DIRNAME = void 0;
+    exports.DOT_BRAINFILE_STATE_IGNORE_ENTRY = exports.DOT_BRAINFILE_STATE_DIRNAME = exports.DOT_BRAINFILE_GITIGNORE_BASENAME = exports.BRAINFILE_STATE_BASENAME = exports.BRAINFILE_BASENAME = exports.DOT_BRAINFILE_DIRNAME = void 0;
     exports.findBrainfile = findBrainfile2;
     exports.resolveBrainfilePath = resolveBrainfilePath2;
     exports.getBrainfileStateDir = getBrainfileStateDir;
@@ -7805,45 +7814,53 @@ var require_files = __commonJS({
     exports.getDotBrainfileGitignorePath = getDotBrainfileGitignorePath;
     exports.ensureDotBrainfileDir = ensureDotBrainfileDir;
     exports.ensureDotBrainfileGitignore = ensureDotBrainfileGitignore;
-    var fs7 = __importStar(__require("fs"));
-    var path7 = __importStar(__require("path"));
+    exports.atomicWriteFileSync = atomicWriteFileSync;
+    var fs11 = __importStar(__require("fs"));
+    var path11 = __importStar(__require("path"));
     exports.DOT_BRAINFILE_DIRNAME = ".brainfile";
     exports.BRAINFILE_BASENAME = "brainfile.md";
     exports.BRAINFILE_STATE_BASENAME = "state.json";
     exports.DOT_BRAINFILE_GITIGNORE_BASENAME = ".gitignore";
+    exports.DOT_BRAINFILE_STATE_DIRNAME = "state";
+    exports.DOT_BRAINFILE_STATE_IGNORE_ENTRY = "state/";
     function toAbsolute(p) {
-      return path7.isAbsolute(p) ? p : path7.resolve(p);
+      return path11.isAbsolute(p) ? p : path11.resolve(p);
     }
     function existsFile2(p) {
       try {
-        return fs7.statSync(p).isFile();
+        return fs11.statSync(p).isFile();
       } catch {
         return false;
       }
     }
-    function findBrainfile2(startDir = process.cwd()) {
-      let currentDir = path7.resolve(startDir);
-      const root = path7.parse(currentDir).root;
+    function isGitBoundary(dir) {
+      return fs11.existsSync(path11.join(dir, ".git"));
+    }
+    function findBrainfile2(startDir = process.cwd(), options = {}) {
+      let currentDir = path11.resolve(startDir);
+      const root = path11.parse(currentDir).root;
       while (true) {
-        const preferred = path7.join(currentDir, exports.DOT_BRAINFILE_DIRNAME, exports.BRAINFILE_BASENAME);
+        const preferred = path11.join(currentDir, exports.DOT_BRAINFILE_DIRNAME, exports.BRAINFILE_BASENAME);
         if (existsFile2(preferred)) {
           return { absolutePath: preferred, projectRoot: currentDir, kind: "dotdir" };
         }
-        const legacy = path7.join(currentDir, exports.BRAINFILE_BASENAME);
+        const legacy = path11.join(currentDir, exports.BRAINFILE_BASENAME);
         if (existsFile2(legacy)) {
           return { absolutePath: legacy, projectRoot: currentDir, kind: "root" };
         }
-        const hiddenLegacy = path7.join(currentDir, ".brainfile.md");
+        const hiddenLegacy = path11.join(currentDir, ".brainfile.md");
         if (existsFile2(hiddenLegacy)) {
           return { absolutePath: hiddenLegacy, projectRoot: currentDir, kind: "hidden" };
         }
-        const bbLegacy = path7.join(currentDir, ".bb.md");
+        const bbLegacy = path11.join(currentDir, ".bb.md");
         if (existsFile2(bbLegacy)) {
           return { absolutePath: bbLegacy, projectRoot: currentDir, kind: "bb" };
         }
+        if (options.stopAtGitRoot && isGitBoundary(currentDir))
+          break;
         if (currentDir === root)
           break;
-        const parent = path7.dirname(currentDir);
+        const parent = path11.dirname(currentDir);
         if (parent === currentDir)
           break;
         currentDir = parent;
@@ -7851,192 +7868,99 @@ var require_files = __commonJS({
       return null;
     }
     function resolveBrainfilePath2(options = {}) {
-      const startDir = options.startDir ? path7.resolve(options.startDir) : process.cwd();
+      const startDir = options.startDir ? path11.resolve(options.startDir) : process.cwd();
       const filePath = options.filePath;
       const isDefaultPlaceholder = filePath === void 0 || filePath === exports.BRAINFILE_BASENAME || filePath === `./${exports.BRAINFILE_BASENAME}`;
       if (isDefaultPlaceholder) {
-        const found = findBrainfile2(startDir);
+        const found = findBrainfile2(startDir, { stopAtGitRoot: options.stopAtGitRoot });
         if (found)
           return found.absolutePath;
         return toAbsolute(filePath ?? exports.BRAINFILE_BASENAME);
       }
-      return toAbsolute(path7.isAbsolute(filePath) ? filePath : path7.resolve(startDir, filePath));
+      return toAbsolute(path11.isAbsolute(filePath) ? filePath : path11.resolve(startDir, filePath));
     }
     function getBrainfileStateDir(brainfilePath) {
       const abs = toAbsolute(brainfilePath);
-      const dir = path7.dirname(abs);
-      if (path7.basename(dir) === exports.DOT_BRAINFILE_DIRNAME)
+      const dir = path11.dirname(abs);
+      if (path11.basename(dir) === exports.DOT_BRAINFILE_DIRNAME)
         return dir;
-      return path7.join(dir, exports.DOT_BRAINFILE_DIRNAME);
+      return path11.join(dir, exports.DOT_BRAINFILE_DIRNAME);
     }
     function getBrainfileStatePath(brainfilePath) {
-      return path7.join(getBrainfileStateDir(brainfilePath), exports.BRAINFILE_STATE_BASENAME);
+      return path11.join(getBrainfileStateDir(brainfilePath), exports.BRAINFILE_STATE_BASENAME);
     }
     function getDotBrainfileGitignorePath(brainfilePath) {
-      return path7.join(getBrainfileStateDir(brainfilePath), exports.DOT_BRAINFILE_GITIGNORE_BASENAME);
+      return path11.join(getBrainfileStateDir(brainfilePath), exports.DOT_BRAINFILE_GITIGNORE_BASENAME);
     }
     function ensureDotBrainfileDir(brainfilePath) {
       const dir = getBrainfileStateDir(brainfilePath);
-      fs7.mkdirSync(dir, { recursive: true });
+      fs11.mkdirSync(dir, { recursive: true });
       return dir;
     }
     function ensureDotBrainfileGitignore(brainfilePath) {
       ensureDotBrainfileDir(brainfilePath);
       const gitignorePath = getDotBrainfileGitignorePath(brainfilePath);
-      const existing = fs7.existsSync(gitignorePath) ? fs7.readFileSync(gitignorePath, "utf-8") : "";
-      const filtered = existing.split(/\r?\n/).filter((line) => line.trim() !== exports.BRAINFILE_STATE_BASENAME).join("\n").trimEnd();
-      fs7.writeFileSync(gitignorePath, filtered.length > 0 ? `${filtered}
+      const existing = fs11.existsSync(gitignorePath) ? fs11.readFileSync(gitignorePath, "utf-8") : "";
+      const lines = existing.split(/\r?\n/).filter((line) => line.trim() !== exports.BRAINFILE_STATE_BASENAME);
+      const hasStateDir = lines.some((line) => line.trim() === exports.DOT_BRAINFILE_STATE_IGNORE_ENTRY);
+      if (!hasStateDir) {
+        lines.push(exports.DOT_BRAINFILE_STATE_IGNORE_ENTRY);
+      }
+      const filtered = lines.join("\n").trim();
+      fs11.writeFileSync(gitignorePath, filtered.length > 0 ? `${filtered}
 ` : "", "utf-8");
     }
+    function atomicWriteFileSync(filePath, content) {
+      const abs = toAbsolute(filePath);
+      const dir = path11.dirname(abs);
+      fs11.mkdirSync(dir, { recursive: true });
+      const tmp = path11.join(dir, `.${path11.basename(abs)}.tmp-${process.pid}-${Date.now()}`);
+      try {
+        fs11.writeFileSync(tmp, content, "utf-8");
+        fs11.renameSync(tmp, abs);
+      } catch (err) {
+        try {
+          if (fs11.existsSync(tmp))
+            fs11.unlinkSync(tmp);
+        } catch {
+        }
+        throw err;
+      }
+    }
   }
 });
 
-// ../core/dist/formatters.js
-var require_formatters = __commonJS({
-  "../core/dist/formatters.js"(exports) {
+// ../core/dist/taskContent.js
+var require_taskContent = __commonJS({
+  "../core/dist/taskContent.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.formatTaskForGitHub = formatTaskForGitHub;
-    exports.formatTaskForLinear = formatTaskForLinear;
-    function formatTaskForGitHub(task, options = {}) {
-      const { includeMeta = true, includeSubtasks = true, includeRelatedFiles = true, resolvedBy, resolvedByPR, fromColumn, boardTitle, extraLabels = [], includeTaskId = true } = options;
-      const title = includeTaskId ? `[${task.id}] ${task.title}` : task.title;
-      const sections = [];
-      if (task.description) {
-        sections.push(task.description);
-      }
-      if (includeSubtasks && task.subtasks && task.subtasks.length > 0) {
-        sections.push(formatSubtasksMarkdown(task.subtasks));
-      }
-      if (includeMeta) {
-        const meta = formatMetadataSection(task, { fromColumn, boardTitle });
-        if (meta) {
-          sections.push(meta);
-        }
-      }
-      if (includeRelatedFiles && task.relatedFiles && task.relatedFiles.length > 0) {
-        sections.push(formatRelatedFilesSection(task.relatedFiles));
-      }
-      if (resolvedBy || resolvedByPR) {
-        sections.push(formatResolutionSection(resolvedBy, resolvedByPR));
-      }
-      sections.push("---\n*Archived from brainfile.md*");
-      const labels = [...task.tags || [], ...extraLabels];
-      if (task.priority) {
-        labels.push(`priority:${task.priority}`);
+    exports.parseTaskContent = parseTaskContent;
+    exports.serializeTaskContent = serializeTaskContent;
+    var frontmatter_1 = require_frontmatter();
+    function parseTaskContent(content) {
+      const parsed = (0, frontmatter_1.parseFrontmatter)(content);
+      if (!parsed) {
+        return null;
       }
-      if (task.template) {
-        labels.push(task.template);
+      const task = parsed.data;
+      if (!task.id || !task.title) {
+        return null;
       }
       return {
-        title,
-        body: sections.join("\n\n"),
-        labels: labels.length > 0 ? labels : void 0,
-        state: "closed"
+        task,
+        body: parsed.body
       };
     }
-    function mapPriorityToLinear(priority) {
-      switch (priority) {
-        case "critical":
-          return 1;
-        case "high":
-          return 2;
-        case "medium":
-          return 3;
-        case "low":
-          return 4;
-        default:
-          return void 0;
-      }
-    }
-    function formatTaskForLinear(task, options = {}) {
-      const { includeMeta = true, includeSubtasks = true, includeRelatedFiles = true, resolvedBy, resolvedByPR, fromColumn, boardTitle, stateName = "Done", includeTaskId = false } = options;
-      const title = includeTaskId ? `[${task.id}] ${task.title}` : task.title;
-      const sections = [];
-      if (task.description) {
-        sections.push(task.description);
-      }
-      if (includeSubtasks && task.subtasks && task.subtasks.length > 0) {
-        sections.push(formatSubtasksMarkdown(task.subtasks));
-      }
-      if (includeMeta) {
-        const meta = formatMetadataSection(task, { fromColumn, boardTitle });
-        if (meta) {
-          sections.push(meta);
-        }
-      }
-      if (includeRelatedFiles && task.relatedFiles && task.relatedFiles.length > 0) {
-        sections.push(formatRelatedFilesSection(task.relatedFiles));
-      }
-      if (resolvedBy || resolvedByPR) {
-        sections.push(formatResolutionSection(resolvedBy, resolvedByPR));
-      }
-      sections.push("---\n*Archived from brainfile.md*");
-      return {
-        title,
-        description: sections.join("\n\n"),
-        priority: mapPriorityToLinear(task.priority),
-        labelNames: task.tags && task.tags.length > 0 ? task.tags : void 0,
-        stateName
-      };
-    }
-    function formatSubtasksMarkdown(subtasks) {
-      const items = subtasks.map((st) => `- [${st.completed ? "x" : " "}] ${st.title}`);
-      return `## Subtasks
-
-${items.join("\n")}`;
-    }
-    function formatMetadataSection(task, context) {
-      const lines = [];
-      if (context.boardTitle) {
-        lines.push(`**Board:** ${context.boardTitle}`);
-      }
-      if (context.fromColumn) {
-        lines.push(`**Column:** ${context.fromColumn}`);
-      }
-      if (task.priority) {
-        lines.push(`**Priority:** ${task.priority}`);
-      }
-      if (task.assignee) {
-        lines.push(`**Assignee:** ${task.assignee}`);
-      }
-      if (task.dueDate) {
-        lines.push(`**Due Date:** ${task.dueDate}`);
-      }
-      if (task.createdAt) {
-        lines.push(`**Created:** ${task.createdAt}`);
-      }
-      if (lines.length === 0) {
-        return null;
-      }
-      return `## Details
-
-${lines.join("\n")}`;
-    }
-    function formatRelatedFilesSection(files) {
-      const items = files.map((f) => `- \`${f}\``);
-      return `## Related Files
-
-${items.join("\n")}`;
-    }
-    function formatResolutionSection(resolvedBy, resolvedByPR) {
-      const lines = ["## Resolution"];
-      if (resolvedByPR) {
-        lines.push(`
-**Pull Request:** ${resolvedByPR}`);
-      }
-      if (resolvedBy) {
-        lines.push(`
-**Commit:** ${resolvedBy}`);
-      }
-      return lines.join("");
+    function serializeTaskContent(task, body = "") {
+      return (0, frontmatter_1.serializeFrontmatter)(task, body);
     }
   }
 });
 
-// ../core/dist/frontmatter.js
-var require_frontmatter = __commonJS({
-  "../core/dist/frontmatter.js"(exports) {
+// ../core/dist/taskFile.js
+var require_taskFile = __commonJS({
+  "../core/dist/taskFile.js"(exports) {
     "use strict";
     var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
       if (k2 === void 0) k2 = k;
@@ -8076,89 +8000,89 @@ var require_frontmatter = __commonJS({
       };
     })();
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.parseFrontmatter = parseFrontmatter;
-    exports.serializeFrontmatter = serializeFrontmatter;
-    var yaml = __importStar(require_js_yaml());
-    function parseFrontmatter(content) {
-      const lines = content.split("\n");
-      if (!lines[0] || lines[0].trim() !== "---") {
-        return null;
+    exports.serializeTaskContent = exports.parseTaskContent = void 0;
+    exports.readTaskFile = readTaskFile;
+    exports.writeTaskFile = writeTaskFile;
+    exports.readTasksDir = readTasksDir;
+    exports.taskFileName = taskFileName;
+    var fs11 = __importStar(__require("fs"));
+    var path11 = __importStar(__require("path"));
+    var taskContent_1 = require_taskContent();
+    var taskContent_2 = require_taskContent();
+    Object.defineProperty(exports, "parseTaskContent", { enumerable: true, get: function() {
+      return taskContent_2.parseTaskContent;
+    } });
+    Object.defineProperty(exports, "serializeTaskContent", { enumerable: true, get: function() {
+      return taskContent_2.serializeTaskContent;
+    } });
+    function isUnsafeTaskId(taskId) {
+      if (!taskId || taskId.trim() === "") {
+        return true;
       }
-      let endIndex = -1;
-      for (let i = 1; i < lines.length; i++) {
-        if (lines[i].trim() === "---") {
-          endIndex = i;
-          break;
-        }
+      const trimmed = taskId.trim();
+      if (trimmed.includes("/") || trimmed.includes("\\") || trimmed.includes("..")) {
+        return true;
       }
-      if (endIndex === -1) {
-        return null;
+      if (path11.isAbsolute(trimmed)) {
+        return true;
       }
-      const yamlContent = lines.slice(1, endIndex).join("\n");
-      const bodyContent = lines.slice(endIndex + 1).join("\n");
-      let parsed;
+      return path11.basename(trimmed) !== trimmed;
+    }
+    function readTaskFile(filePath) {
+      let content;
       try {
-        parsed = yaml.load(yamlContent);
+        content = fs11.readFileSync(filePath, "utf-8");
       } catch {
         return null;
       }
-      if (!parsed || typeof parsed !== "object") {
+      const parsed = (0, taskContent_1.parseTaskContent)(content);
+      if (!parsed) {
         return null;
       }
       return {
-        data: parsed,
-        body: bodyContent.replace(/^\n/, "")
+        task: parsed.task,
+        body: parsed.body,
+        filePath: path11.resolve(filePath)
       };
     }
-    function serializeFrontmatter(data, body = "") {
-      const yamlContent = yaml.dump(data, {
-        indent: 2,
-        lineWidth: -1,
-        noRefs: true,
-        sortKeys: false,
-        quotingType: '"',
-        forceQuotes: false
-      });
-      const parts = ["---\n", yamlContent, "---\n"];
-      if (body.length > 0) {
-        parts.push("\n");
-        parts.push(body);
-        if (!body.endsWith("\n")) {
-          parts.push("\n");
+    function writeTaskFile(filePath, task, body = "") {
+      const dir = path11.dirname(filePath);
+      fs11.mkdirSync(dir, { recursive: true });
+      const content = (0, taskContent_1.serializeTaskContent)(task, body);
+      fs11.writeFileSync(filePath, content, "utf-8");
+    }
+    function readTasksDir(dirPath) {
+      let entries;
+      try {
+        entries = fs11.readdirSync(dirPath, { withFileTypes: true });
+      } catch {
+        return [];
+      }
+      const docs = [];
+      for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith(".md")) {
+          continue;
+        }
+        const filePath = path11.join(dirPath, entry.name);
+        const doc = readTaskFile(filePath);
+        if (doc) {
+          docs.push(doc);
         }
       }
-      return parts.join("");
+      return docs;
     }
-  }
-});
-
-// ../core/dist/boardContent.js
-var require_boardContent = __commonJS({
-  "../core/dist/boardContent.js"(exports) {
-    "use strict";
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.parseBoardConfig = parseBoardConfig;
-    exports.serializeBoardConfig = serializeBoardConfig;
-    var frontmatter_1 = require_frontmatter();
-    function parseBoardConfig(content) {
-      const parsed = (0, frontmatter_1.parseFrontmatter)(content);
-      if (!parsed) {
-        return null;
+    function taskFileName(taskId) {
+      if (isUnsafeTaskId(taskId)) {
+        throw new Error(`Invalid task ID: ${taskId}`);
       }
-      return {
-        config: parsed.data,
-        body: parsed.body
-      };
-    }
-    function serializeBoardConfig(config, body = "") {
-      return (0, frontmatter_1.serializeFrontmatter)(config, body);
+      return `${taskId.trim()}.md`;
     }
   }
 });
 
-// ../core/dist/boardFile.js
-var require_boardFile = __commonJS({
-  "../core/dist/boardFile.js"(exports) {
+// ../core/dist/ledger.js
+var require_ledger2 = __commonJS({
+  "../core/dist/ledger.js"(exports) {
     "use strict";
     var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
       if (k2 === void 0) k2 = k;
@@ -8198,256 +8122,25 @@ var require_boardFile = __commonJS({
       };
     })();
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.serializeBoardConfig = exports.parseBoardConfig = void 0;
-    exports.readBoardConfig = readBoardConfig;
-    exports.writeBoardConfig = writeBoardConfig;
-    var fs7 = __importStar(__require("fs"));
-    var path7 = __importStar(__require("path"));
-    var boardContent_1 = require_boardContent();
-    var boardContent_2 = require_boardContent();
-    Object.defineProperty(exports, "parseBoardConfig", { enumerable: true, get: function() {
-      return boardContent_2.parseBoardConfig;
-    } });
-    Object.defineProperty(exports, "serializeBoardConfig", { enumerable: true, get: function() {
-      return boardContent_2.serializeBoardConfig;
-    } });
-    function readBoardConfig(filePath) {
-      let content;
-      try {
-        content = fs7.readFileSync(filePath, "utf-8");
-      } catch {
-        return null;
-      }
-      const parsed = (0, boardContent_1.parseBoardConfig)(content);
-      if (!parsed) {
-        return null;
-      }
-      return {
-        config: parsed.config,
-        body: parsed.body,
-        filePath: path7.resolve(filePath)
-      };
+    exports.normalizePathValue = normalizePathValue;
+    exports.isLedgerContractStatus = isLedgerContractStatus;
+    exports.buildLedgerRecord = buildLedgerRecord;
+    exports.appendLedgerRecord = appendLedgerRecord;
+    exports.readLedger = readLedger;
+    exports.queryLedger = queryLedger;
+    exports.getFileHistory = getFileHistory;
+    exports.getTaskContext = getTaskContext;
+    var fs11 = __importStar(__require("fs"));
+    var path11 = __importStar(__require("path"));
+    var taskFile_1 = require_taskFile();
+    var ledger_1 = require_ledger();
+    var LEDGER_FILE_NAME = "ledger.jsonl";
+    var LEGACY_WARNING_TRACKER = /* @__PURE__ */ new Set();
+    function getLedgerPath(logsDir) {
+      return path11.join(logsDir, LEDGER_FILE_NAME);
     }
-    function writeBoardConfig(filePath, config, body = "") {
-      const dir = path7.dirname(filePath);
-      fs7.mkdirSync(dir, { recursive: true });
-      const content = (0, boardContent_1.serializeBoardConfig)(config, body);
-      fs7.writeFileSync(filePath, content, "utf-8");
-    }
-  }
-});
-
-// ../core/dist/taskContent.js
-var require_taskContent = __commonJS({
-  "../core/dist/taskContent.js"(exports) {
-    "use strict";
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.parseTaskContent = parseTaskContent;
-    exports.serializeTaskContent = serializeTaskContent;
-    var frontmatter_1 = require_frontmatter();
-    function parseTaskContent(content) {
-      const parsed = (0, frontmatter_1.parseFrontmatter)(content);
-      if (!parsed) {
-        return null;
-      }
-      const task = parsed.data;
-      if (!task.id || !task.title) {
-        return null;
-      }
-      return {
-        task,
-        body: parsed.body
-      };
-    }
-    function serializeTaskContent(task, body = "") {
-      return (0, frontmatter_1.serializeFrontmatter)(task, body);
-    }
-  }
-});
-
-// ../core/dist/taskFile.js
-var require_taskFile = __commonJS({
-  "../core/dist/taskFile.js"(exports) {
-    "use strict";
-    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      var desc = Object.getOwnPropertyDescriptor(m, k);
-      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-        desc = { enumerable: true, get: function() {
-          return m[k];
-        } };
-      }
-      Object.defineProperty(o, k2, desc);
-    }) : (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      o[k2] = m[k];
-    }));
-    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? (function(o, v) {
-      Object.defineProperty(o, "default", { enumerable: true, value: v });
-    }) : function(o, v) {
-      o["default"] = v;
-    });
-    var __importStar = exports && exports.__importStar || /* @__PURE__ */ (function() {
-      var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function(o2) {
-          var ar = [];
-          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
-          return ar;
-        };
-        return ownKeys(o);
-      };
-      return function(mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) {
-          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        }
-        __setModuleDefault(result, mod);
-        return result;
-      };
-    })();
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.serializeTaskContent = exports.parseTaskContent = void 0;
-    exports.readTaskFile = readTaskFile;
-    exports.writeTaskFile = writeTaskFile;
-    exports.readTasksDir = readTasksDir;
-    exports.taskFileName = taskFileName;
-    var fs7 = __importStar(__require("fs"));
-    var path7 = __importStar(__require("path"));
-    var taskContent_1 = require_taskContent();
-    var taskContent_2 = require_taskContent();
-    Object.defineProperty(exports, "parseTaskContent", { enumerable: true, get: function() {
-      return taskContent_2.parseTaskContent;
-    } });
-    Object.defineProperty(exports, "serializeTaskContent", { enumerable: true, get: function() {
-      return taskContent_2.serializeTaskContent;
-    } });
-    function isUnsafeTaskId(taskId) {
-      if (!taskId || taskId.trim() === "") {
-        return true;
-      }
-      const trimmed = taskId.trim();
-      if (trimmed.includes("/") || trimmed.includes("\\") || trimmed.includes("..")) {
-        return true;
-      }
-      if (path7.isAbsolute(trimmed)) {
-        return true;
-      }
-      return path7.basename(trimmed) !== trimmed;
-    }
-    function readTaskFile(filePath) {
-      let content;
-      try {
-        content = fs7.readFileSync(filePath, "utf-8");
-      } catch {
-        return null;
-      }
-      const parsed = (0, taskContent_1.parseTaskContent)(content);
-      if (!parsed) {
-        return null;
-      }
-      return {
-        task: parsed.task,
-        body: parsed.body,
-        filePath: path7.resolve(filePath)
-      };
-    }
-    function writeTaskFile(filePath, task, body = "") {
-      const dir = path7.dirname(filePath);
-      fs7.mkdirSync(dir, { recursive: true });
-      const content = (0, taskContent_1.serializeTaskContent)(task, body);
-      fs7.writeFileSync(filePath, content, "utf-8");
-    }
-    function readTasksDir(dirPath) {
-      let entries;
-      try {
-        entries = fs7.readdirSync(dirPath, { withFileTypes: true });
-      } catch {
-        return [];
-      }
-      const docs = [];
-      for (const entry of entries) {
-        if (!entry.isFile() || !entry.name.endsWith(".md")) {
-          continue;
-        }
-        const filePath = path7.join(dirPath, entry.name);
-        const doc = readTaskFile(filePath);
-        if (doc) {
-          docs.push(doc);
-        }
-      }
-      return docs;
-    }
-    function taskFileName(taskId) {
-      if (isUnsafeTaskId(taskId)) {
-        throw new Error(`Invalid task ID: ${taskId}`);
-      }
-      return `${taskId.trim()}.md`;
-    }
-  }
-});
-
-// ../core/dist/ledger.js
-var require_ledger2 = __commonJS({
-  "../core/dist/ledger.js"(exports) {
-    "use strict";
-    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      var desc = Object.getOwnPropertyDescriptor(m, k);
-      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-        desc = { enumerable: true, get: function() {
-          return m[k];
-        } };
-      }
-      Object.defineProperty(o, k2, desc);
-    }) : (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      o[k2] = m[k];
-    }));
-    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? (function(o, v) {
-      Object.defineProperty(o, "default", { enumerable: true, value: v });
-    }) : function(o, v) {
-      o["default"] = v;
-    });
-    var __importStar = exports && exports.__importStar || /* @__PURE__ */ (function() {
-      var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function(o2) {
-          var ar = [];
-          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
-          return ar;
-        };
-        return ownKeys(o);
-      };
-      return function(mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) {
-          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        }
-        __setModuleDefault(result, mod);
-        return result;
-      };
-    })();
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.normalizePathValue = normalizePathValue;
-    exports.isLedgerContractStatus = isLedgerContractStatus;
-    exports.buildLedgerRecord = buildLedgerRecord;
-    exports.appendLedgerRecord = appendLedgerRecord;
-    exports.readLedger = readLedger;
-    exports.queryLedger = queryLedger;
-    exports.getFileHistory = getFileHistory;
-    exports.getTaskContext = getTaskContext;
-    var fs7 = __importStar(__require("fs"));
-    var path7 = __importStar(__require("path"));
-    var taskFile_1 = require_taskFile();
-    var ledger_1 = require_ledger();
-    var LEDGER_FILE_NAME = "ledger.jsonl";
-    var LEGACY_WARNING_TRACKER = /* @__PURE__ */ new Set();
-    function getLedgerPath(logsDir) {
-      return path7.join(logsDir, LEDGER_FILE_NAME);
-    }
-    function normalizePathValue(value) {
-      return value.replace(/\\/g, "/").replace(/^\.\//, "").trim();
+    function normalizePathValue(value) {
+      return value.replace(/\\/g, "/").replace(/^\.\//, "").trim();
     }
     function toUniqueStrings(values) {
       if (!values) {
@@ -8662,7 +8355,7 @@ var require_ledger2 = __commonJS({
       return parsed;
     }
     function shouldWarnLegacyFallback(logsDir) {
-      const key = path7.resolve(logsDir);
+      const key = path11.resolve(logsDir);
       if (LEGACY_WARNING_TRACKER.has(key)) {
         return false;
       }
@@ -8748,18 +8441,18 @@ var require_ledger2 = __commonJS({
       return record;
     }
     function appendLedgerRecord(logsDir, record) {
-      fs7.mkdirSync(logsDir, { recursive: true });
+      fs11.mkdirSync(logsDir, { recursive: true });
       const ledgerPath = getLedgerPath(logsDir);
-      fs7.appendFileSync(ledgerPath, `${JSON.stringify(record)}
+      fs11.appendFileSync(ledgerPath, `${JSON.stringify(record)}
 `, "utf-8");
       return ledgerPath;
     }
     function readLedger(logsDir) {
       const ledgerPath = getLedgerPath(logsDir);
-      if (!fs7.existsSync(ledgerPath)) {
+      if (!fs11.existsSync(ledgerPath)) {
         return readLegacyMarkdownLedger(logsDir);
       }
-      const content = fs7.readFileSync(ledgerPath, "utf-8");
+      const content = fs11.readFileSync(ledgerPath, "utf-8");
       const lines = content.split("\n");
       const records = [];
       for (let index = 0; index < lines.length; index++) {
@@ -8808,29 +8501,903 @@ var require_ledger2 = __commonJS({
       if (options.dateRange) {
         records = records.filter((record) => matchesDateRange(record.completedAt, options.dateRange));
       }
-      records.sort((a, b) => timestampOr(b.completedAt, 0) - timestampOr(a.completedAt, 0));
-      if (options.limit !== void 0 && options.limit > 0) {
-        return records.slice(0, options.limit);
+      records.sort((a, b) => timestampOr(b.completedAt, 0) - timestampOr(a.completedAt, 0));
+      if (options.limit !== void 0 && options.limit > 0) {
+        return records.slice(0, options.limit);
+      }
+      return records;
+    }
+    function getTaskContext(logsDir, relatedFiles, deliverables, options = {}) {
+      const scopeFiles = toUniquePaths([
+        ...relatedFiles,
+        ...collectDeliverableInputPaths(deliverables)
+      ]);
+      if (scopeFiles.length === 0) {
+        return [];
+      }
+      let entries = readLedger(logsDir).filter((record) => matchesDateRange(record.completedAt, options.dateRange)).map((record) => {
+        const matchedFiles = matchedFilesForScope(scopeFiles, collectRecordFiles(record));
+        return { record, matchedFiles };
+      }).filter((entry) => entry.matchedFiles.length > 0);
+      entries.sort((a, b) => timestampOr(b.record.completedAt, 0) - timestampOr(a.record.completedAt, 0));
+      if (options.limit !== void 0 && options.limit > 0) {
+        entries = entries.slice(0, options.limit);
+      }
+      return entries;
+    }
+  }
+});
+
+// ../core/dist/workspace.js
+var require_workspace = __commonJS({
+  "../core/dist/workspace.js"(exports) {
+    "use strict";
+    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    }) : (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    }));
+    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? (function(o, v) {
+      Object.defineProperty(o, "default", { enumerable: true, value: v });
+    }) : function(o, v) {
+      o["default"] = v;
+    });
+    var __importStar = exports && exports.__importStar || /* @__PURE__ */ (function() {
+      var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function(o2) {
+          var ar = [];
+          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
+          return ar;
+        };
+        return ownKeys(o);
+      };
+      return function(mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) {
+          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        }
+        __setModuleDefault(result, mod);
+        return result;
+      };
+    })();
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.getV2Dirs = getV2Dirs2;
+    exports.isV2 = isV25;
+    exports.ensureV2Dirs = ensureV2Dirs2;
+    exports.getTaskFilePath = getTaskFilePath2;
+    exports.getLogFilePath = getLogFilePath2;
+    exports.findV2Task = findV2Task2;
+    exports.extractDescription = extractDescription2;
+    exports.extractLog = extractLog2;
+    exports.composeBody = composeBody2;
+    exports.readV2BoardConfig = readV2BoardConfig2;
+    exports.buildBoardFromV2 = buildBoardFromV22;
+    var fs11 = __importStar(__require("fs"));
+    var path11 = __importStar(__require("path"));
+    var parser_1 = require_parser();
+    var taskFile_1 = require_taskFile();
+    function getV2Dirs2(brainfilePath) {
+      const resolvedPath = path11.resolve(brainfilePath);
+      const dotDir = path11.dirname(resolvedPath);
+      return {
+        dotDir,
+        boardDir: path11.join(dotDir, "board"),
+        logsDir: path11.join(dotDir, "logs"),
+        brainfilePath: resolvedPath
+      };
+    }
+    function isV25(brainfilePath) {
+      const { boardDir } = getV2Dirs2(brainfilePath);
+      return fs11.existsSync(boardDir);
+    }
+    function ensureV2Dirs2(brainfilePath) {
+      const dirs = getV2Dirs2(brainfilePath);
+      fs11.mkdirSync(dirs.boardDir, { recursive: true });
+      fs11.mkdirSync(dirs.logsDir, { recursive: true });
+      return dirs;
+    }
+    function getTaskFilePath2(boardDir, taskId) {
+      return path11.join(boardDir, (0, taskFile_1.taskFileName)(taskId));
+    }
+    function getLogFilePath2(logsDir, taskId) {
+      return path11.join(logsDir, (0, taskFile_1.taskFileName)(taskId));
+    }
+    function findV2Task2(dirs, taskId, searchLogs = false) {
+      const taskPath = getTaskFilePath2(dirs.boardDir, taskId);
+      const taskDoc = (0, taskFile_1.readTaskFile)(taskPath);
+      if (taskDoc && taskDoc.task.id === taskId) {
+        return { doc: taskDoc, filePath: taskPath, isLog: false };
+      }
+      if (searchLogs) {
+        const logPath = getLogFilePath2(dirs.logsDir, taskId);
+        const logDoc = (0, taskFile_1.readTaskFile)(logPath);
+        if (logDoc && logDoc.task.id === taskId) {
+          return { doc: logDoc, filePath: logPath, isLog: true };
+        }
+      }
+      const boardDocs = (0, taskFile_1.readTasksDir)(dirs.boardDir);
+      const boardMatch = boardDocs.find((d) => d.task.id === taskId);
+      if (boardMatch) {
+        return {
+          doc: boardMatch,
+          filePath: boardMatch.filePath || taskPath,
+          isLog: false
+        };
+      }
+      if (searchLogs) {
+        const logDocs = (0, taskFile_1.readTasksDir)(dirs.logsDir);
+        const logMatch = logDocs.find((d) => d.task.id === taskId);
+        if (logMatch) {
+          return {
+            doc: logMatch,
+            filePath: logMatch.filePath || getLogFilePath2(dirs.logsDir, taskId),
+            isLog: true
+          };
+        }
+      }
+      return null;
+    }
+    function extractDescription2(body) {
+      const match = body.match(/## Description\n([\s\S]*?)(?=\n## |\n*$)/);
+      return match ? match[1].trim() || void 0 : void 0;
+    }
+    function extractLog2(body) {
+      const match = body.match(/## Log\n([\s\S]*?)(?=\n## |\n*$)/);
+      return match ? match[1].trim() || void 0 : void 0;
+    }
+    function composeBody2(description, log) {
+      const sections = [];
+      if (description && description.trim()) {
+        sections.push(`## Description
+${description.trim()}`);
+      }
+      if (log && log.trim()) {
+        sections.push(`## Log
+${log.trim()}`);
+      }
+      if (sections.length === 0)
+        return "";
+      return `${sections.join("\n\n")}
+`;
+    }
+    function readV2BoardConfig2(brainfilePath) {
+      const content = fs11.readFileSync(brainfilePath, "utf-8");
+      const result = parser_1.BrainfileParser.parseWithErrors(content);
+      if (!result.board) {
+        throw new Error(`Failed to parse brainfile: ${result.error}`);
+      }
+      const board = result.board;
+      for (const col of board.columns) {
+        if (!col.tasks)
+          col.tasks = [];
+      }
+      return board;
+    }
+    function buildBoardFromV22(brainfilePath) {
+      const dirs = getV2Dirs2(brainfilePath);
+      const board = readV2BoardConfig2(brainfilePath);
+      const taskDocs = (0, taskFile_1.readTasksDir)(dirs.boardDir);
+      const tasksByColumn = /* @__PURE__ */ new Map();
+      for (const doc of taskDocs) {
+        const colId = doc.task.column || "todo";
+        if (!tasksByColumn.has(colId)) {
+          tasksByColumn.set(colId, []);
+        }
+        tasksByColumn.get(colId).push(doc);
+      }
+      for (const col of board.columns) {
+        const colTasks = tasksByColumn.get(col.id) || [];
+        colTasks.sort((a, b) => {
+          const posA = a.task.position ?? Number.MAX_SAFE_INTEGER;
+          const posB = b.task.position ?? Number.MAX_SAFE_INTEGER;
+          if (posA !== posB)
+            return posA - posB;
+          return a.task.id.localeCompare(b.task.id);
+        });
+        col.tasks = colTasks.map((doc) => {
+          const task = { ...doc.task };
+          if (!task.description) {
+            const description = extractDescription2(doc.body);
+            if (description)
+              task.description = description;
+          }
+          return task;
+        });
+      }
+      return board;
+    }
+  }
+});
+
+// ../core/dist/brief.js
+var require_brief = __commonJS({
+  "../core/dist/brief.js"(exports) {
+    "use strict";
+    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    }) : (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    }));
+    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? (function(o, v) {
+      Object.defineProperty(o, "default", { enumerable: true, value: v });
+    }) : function(o, v) {
+      o["default"] = v;
+    });
+    var __importStar = exports && exports.__importStar || /* @__PURE__ */ (function() {
+      var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function(o2) {
+          var ar = [];
+          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
+          return ar;
+        };
+        return ownKeys(o);
+      };
+      return function(mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) {
+          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        }
+        __setModuleDefault(result, mod);
+        return result;
+      };
+    })();
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.parseNoteLine = parseNoteLine;
+    exports.parseNotes = parseNotes;
+    exports.relativeTime = relativeTime;
+    exports.buildBrief = buildBrief;
+    exports.isEmptyBrief = isEmptyBrief;
+    var fs11 = __importStar(__require("fs"));
+    var taskFile_1 = require_taskFile();
+    var ledger_1 = require_ledger2();
+    var workspace_1 = require_workspace();
+    var FULL_MODE_COMPLETION_LIMIT = 10;
+    var ISO_TIMESTAMP_SHAPE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/;
+    function parseNoteLine(line) {
+      const match = /^-\s+(\S+)/.exec(line);
+      if (!match)
+        return null;
+      let token = match[1];
+      if (token.endsWith(":"))
+        token = token.slice(0, -1);
+      if (!ISO_TIMESTAMP_SHAPE.test(token))
+        return null;
+      const parsed = Date.parse(token);
+      if (Number.isNaN(parsed))
+        return null;
+      let rest = line.slice(match[0].length);
+      let agent;
+      const takeBracket = () => {
+        const bracket = /^\s*\[([^\]]+)\]/.exec(rest);
+        if (bracket) {
+          agent = bracket[1].trim() || void 0;
+          rest = rest.slice(bracket[0].length);
+        }
+      };
+      takeBracket();
+      rest = rest.replace(/^\s*:/, "");
+      if (!agent)
+        takeBracket();
+      return {
+        at: new Date(parsed).toISOString(),
+        text: rest.trim(),
+        agent
+      };
+    }
+    function parseNotes(body) {
+      const log = (0, workspace_1.extractLog)(body);
+      if (!log)
+        return [];
+      const notes = [];
+      for (const line of log.split("\n")) {
+        const parsed = parseNoteLine(line);
+        if (parsed)
+          notes.push(parsed);
+      }
+      return notes.sort((a, b) => Date.parse(b.at) - Date.parse(a.at));
+    }
+    function lastRawLogLine(body) {
+      const log = (0, workspace_1.extractLog)(body);
+      if (!log)
+        return null;
+      const lines = log.split("\n").map((l) => l.trim()).filter((l) => l.length > 0);
+      if (lines.length === 0)
+        return null;
+      return lines[lines.length - 1].replace(/^-\s+/, "");
+    }
+    function parseMs(value) {
+      if (!value)
+        return null;
+      const ms = Date.parse(value);
+      return Number.isNaN(ms) ? null : ms;
+    }
+    function isAssignedTo(assignee, agentName) {
+      if (!assignee)
+        return false;
+      return assignee.trim().toLowerCase() === agentName.trim().toLowerCase();
+    }
+    function relativeTime(from, to) {
+      const fromMs = parseMs(from);
+      const toMs = parseMs(to);
+      if (fromMs === null || toMs === null)
+        return "unknown";
+      const deltaSec = Math.max(0, Math.round((toMs - fromMs) / 1e3));
+      if (deltaSec < 60)
+        return "just now";
+      const min = Math.floor(deltaSec / 60);
+      if (min < 60)
+        return `${min}m`;
+      const hours = Math.floor(min / 60);
+      if (hours < 24)
+        return `${hours}h`;
+      const days = Math.floor(hours / 24);
+      return `${days}d`;
+    }
+    function agoPhrase(from, to) {
+      const rel = relativeTime(from, to);
+      return rel === "just now" || rel === "unknown" ? rel : `${rel} ago`;
+    }
+    function taskStateWhy(task) {
+      const parts = [task.column || "unknown"];
+      if (task.priority)
+        parts.push(task.priority);
+      if (task.contract?.status)
+        parts.push(`contract:${task.contract.status}`);
+      return parts.join(" \xB7 ");
+    }
+    function completionWhy(record) {
+      const cycle = typeof record.cycleTimeHours === "number" ? `${record.cycleTimeHours}h cycle` : "cycle unknown";
+      return `completed \xB7 ${cycle}`;
+    }
+    function boardMtimeMs(brainfilePath) {
+      try {
+        return fs11.statSync(brainfilePath).mtimeMs;
+      } catch {
+        return null;
+      }
+    }
+    function completionsFor(dirs, agentName, lastBriefAtMs) {
+      let records;
+      try {
+        records = (0, ledger_1.queryLedger)(dirs.logsDir, {});
+      } catch {
+        return [];
+      }
+      const matching = records.filter((record) => {
+        if (!isAssignedTo(record.assignee, agentName))
+          return false;
+        if (lastBriefAtMs === null)
+          return true;
+        const completedMs = parseMs(record.completedAt);
+        return completedMs !== null && completedMs > lastBriefAtMs;
+      });
+      return matching.sort((a, b) => (parseMs(b.completedAt) ?? 0) - (parseMs(a.completedAt) ?? 0));
+    }
+    function readBoardConfig(brainfilePath) {
+      try {
+        return (0, workspace_1.readV2BoardConfig)(brainfilePath);
+      } catch {
+        return null;
+      }
+    }
+    function buildBrief(dirs, agentName, opts) {
+      const generatedAt = opts.now ?? (/* @__PURE__ */ new Date()).toISOString();
+      const lastBriefAt = opts.lastBriefAt;
+      const lastBriefAtMs = parseMs(lastBriefAt);
+      const mode = lastBriefAtMs === null ? "full" : "delta";
+      const assigned = (0, taskFile_1.readTasksDir)(dirs.boardDir).filter((doc) => isAssignedTo(doc.task.assignee, agentName));
+      const lanes = mode === "full" ? fullLanes(dirs, agentName, assigned, generatedAt) : deltaLanes(dirs, agentName, assigned, generatedAt, lastBriefAtMs);
+      return {
+        agent: agentName,
+        mode,
+        generatedAt,
+        // Normalize away an unparseable stored checkpoint rather than echoing it.
+        lastBriefAt: lastBriefAtMs === null ? null : lastBriefAt,
+        lanes
+      };
+    }
+    function sortAssigned(docs) {
+      return [...docs].sort((a, b) => {
+        const aMs = parseMs(a.task.updatedAt) ?? parseMs(a.task.createdAt) ?? 0;
+        const bMs = parseMs(b.task.updatedAt) ?? parseMs(b.task.createdAt) ?? 0;
+        return bMs - aMs;
+      });
+    }
+    function acceptedAdrs(dirs) {
+      const ACCEPTED = /* @__PURE__ */ new Set(["accepted", "promoted"]);
+      const docs = [];
+      for (const dir of [dirs.boardDir, dirs.logsDir]) {
+        let entries;
+        try {
+          entries = (0, taskFile_1.readTasksDir)(dir);
+        } catch {
+          continue;
+        }
+        for (const doc of entries) {
+          const task = doc.task;
+          if ((task.type || "").toLowerCase() !== "adr")
+            continue;
+          if (!ACCEPTED.has((task.status || "").toLowerCase()))
+            continue;
+          docs.push(doc);
+        }
+      }
+      return docs.sort((a, b) => a.task.id.localeCompare(b.task.id, void 0, { numeric: true }));
+    }
+    function fullLanes(dirs, agentName, assigned, generatedAt) {
+      const orientation = [];
+      const board = readBoardConfig(dirs.brainfilePath);
+      if (board?.title) {
+        orientation.push({ text: board.title, why: "board" });
+      }
+      for (const instruction of board?.agent?.instructions ?? []) {
+        orientation.push({ text: instruction, why: "agent instructions" });
+      }
+      for (const doc of acceptedAdrs(dirs)) {
+        orientation.push({ taskId: doc.task.id, text: doc.task.title, why: "accepted adr" });
+      }
+      const assignedItems = sortAssigned(assigned).map((doc) => ({
+        taskId: doc.task.id,
+        text: doc.task.title,
+        why: taskStateWhy(doc.task),
+        ...doc.task.updatedAt ? { at: doc.task.updatedAt } : {}
+      }));
+      const noteItems = [];
+      for (const doc of assigned) {
+        const notes = parseNotes(doc.body);
+        if (notes.length > 0) {
+          const latest = notes[0];
+          noteItems.push({
+            taskId: doc.task.id,
+            text: latest.text,
+            why: `logged ${agoPhrase(latest.at, generatedAt)}`,
+            at: latest.at
+          });
+          continue;
+        }
+        const raw = lastRawLogLine(doc.body);
+        if (raw) {
+          noteItems.push({ taskId: doc.task.id, text: raw, why: "unstamped entry" });
+        }
+      }
+      noteItems.sort((a, b) => (parseMs(b.at) ?? 0) - (parseMs(a.at) ?? 0));
+      const completionItems = completionsFor(dirs, agentName, null).slice(0, FULL_MODE_COMPLETION_LIMIT).map((record) => ({
+        taskId: record.id,
+        text: record.title,
+        why: completionWhy(record),
+        at: record.completedAt
+      }));
+      return [
+        { id: "orientation", label: "Board & Decisions", items: orientation },
+        { id: "assigned", label: "Your Tasks", items: assignedItems },
+        { id: "notes", label: "Latest Notes", items: noteItems },
+        { id: "completions", label: "Recently Completed (yours)", items: completionItems }
+      ];
+    }
+    function deltaLanes(dirs, agentName, assigned, generatedAt, lastBriefAtMs) {
+      const noteItems = [];
+      for (const doc of assigned) {
+        for (const note of parseNotes(doc.body)) {
+          const noteMs = parseMs(note.at);
+          if (noteMs === null || noteMs <= lastBriefAtMs)
+            continue;
+          noteItems.push({
+            taskId: doc.task.id,
+            text: note.agent ? `[${note.agent}] ${note.text}` : note.text,
+            why: agoPhrase(note.at, generatedAt),
+            at: note.at
+          });
+        }
+      }
+      noteItems.sort((a, b) => (parseMs(b.at) ?? 0) - (parseMs(a.at) ?? 0));
+      const changeItems = [];
+      for (const doc of sortAssigned(assigned)) {
+        const createdMs = parseMs(doc.task.createdAt);
+        const updatedMs = parseMs(doc.task.updatedAt);
+        const isNew = createdMs !== null && createdMs > lastBriefAtMs;
+        const isUpdated = updatedMs !== null && updatedMs > lastBriefAtMs;
+        if (!isNew && !isUpdated)
+          continue;
+        const stamp2 = isNew ? doc.task.createdAt : doc.task.updatedAt;
+        const verb = isNew ? "created" : "updated";
+        changeItems.push({
+          taskId: doc.task.id,
+          text: doc.task.title,
+          why: `${verb} ${agoPhrase(stamp2, generatedAt)} \xB7 ${taskStateWhy(doc.task)}`,
+          ...stamp2 ? { at: stamp2 } : {}
+        });
+      }
+      const completionItems = completionsFor(dirs, agentName, lastBriefAtMs).map((record) => ({
+        taskId: record.id,
+        text: record.title,
+        why: completionWhy(record),
+        at: record.completedAt
+      }));
+      const configItems = [];
+      const mtime = boardMtimeMs(dirs.brainfilePath);
+      if (mtime !== null && mtime > lastBriefAtMs) {
+        const at = new Date(mtime).toISOString();
+        configItems.push({
+          text: "Board config changed",
+          why: "brainfile.md changed since last brief",
+          at
+        });
+      }
+      return [
+        { id: "notes", label: "New Notes", items: noteItems },
+        { id: "changes", label: "Task Changes", items: changeItems },
+        { id: "completions", label: "Completed Since Last Brief", items: completionItems },
+        { id: "config", label: "Board Config", items: configItems }
+      ];
+    }
+    function isEmptyBrief(result) {
+      return result.lanes.every((lane) => lane.items.length === 0);
+    }
+  }
+});
+
+// ../core/dist/briefState.js
+var require_briefState = __commonJS({
+  "../core/dist/briefState.js"(exports) {
+    "use strict";
+    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    }) : (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    }));
+    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? (function(o, v) {
+      Object.defineProperty(o, "default", { enumerable: true, value: v });
+    }) : function(o, v) {
+      o["default"] = v;
+    });
+    var __importStar = exports && exports.__importStar || /* @__PURE__ */ (function() {
+      var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function(o2) {
+          var ar = [];
+          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
+          return ar;
+        };
+        return ownKeys(o);
+      };
+      return function(mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) {
+          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        }
+        __setModuleDefault(result, mod);
+        return result;
+      };
+    })();
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.BRIEF_STATE_VERSION = void 0;
+    exports.sanitizeAgentFilename = sanitizeAgentFilename;
+    exports.getBriefStateDir = getBriefStateDir;
+    exports.getBriefStatePath = getBriefStatePath;
+    exports.readBriefState = readBriefState;
+    exports.writeBriefState = writeBriefState;
+    var fs11 = __importStar(__require("fs"));
+    var path11 = __importStar(__require("path"));
+    var files_1 = require_files();
+    exports.BRIEF_STATE_VERSION = 1;
+    function sanitizeAgentFilename(agentName) {
+      const trimmed = agentName.trim().toLowerCase();
+      let cleaned = "";
+      for (const ch of trimmed) {
+        if (/[a-z0-9._-]/.test(ch)) {
+          cleaned += ch;
+        } else {
+          cleaned += `_${ch.charCodeAt(0).toString(16).padStart(2, "0")}`;
+        }
+      }
+      if (cleaned.length === 0 || cleaned === "." || cleaned === "..")
+        return "_";
+      return cleaned;
+    }
+    function getBriefStateDir(brainfilePath) {
+      return path11.join((0, files_1.getBrainfileStateDir)(brainfilePath), files_1.DOT_BRAINFILE_STATE_DIRNAME);
+    }
+    function getBriefStatePath(brainfilePath, agentName) {
+      return path11.join(getBriefStateDir(brainfilePath), `${sanitizeAgentFilename(agentName)}.json`);
+    }
+    function readBriefState(brainfilePath, agentName) {
+      const statePath = getBriefStatePath(brainfilePath, agentName);
+      const fallback = { version: exports.BRIEF_STATE_VERSION, agent: agentName, lastBriefAt: null };
+      if (!fs11.existsSync(statePath))
+        return fallback;
+      try {
+        const parsed = JSON.parse(fs11.readFileSync(statePath, "utf-8"));
+        const lastBriefAt = typeof parsed.lastBriefAt === "string" ? parsed.lastBriefAt : null;
+        return {
+          version: typeof parsed.version === "number" ? parsed.version : exports.BRIEF_STATE_VERSION,
+          agent: typeof parsed.agent === "string" ? parsed.agent : agentName,
+          lastBriefAt
+        };
+      } catch {
+        console.warn(`Warning: unreadable brief state at ${statePath}; treating as first brief`);
+        return fallback;
+      }
+    }
+    function writeBriefState(brainfilePath, agentName, lastBriefAt) {
+      (0, files_1.ensureDotBrainfileGitignore)(brainfilePath);
+      const state = { version: exports.BRIEF_STATE_VERSION, agent: agentName, lastBriefAt };
+      (0, files_1.atomicWriteFileSync)(getBriefStatePath(brainfilePath, agentName), `${JSON.stringify(state, null, 2)}
+`);
+      return state;
+    }
+  }
+});
+
+// ../core/dist/formatters.js
+var require_formatters = __commonJS({
+  "../core/dist/formatters.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.formatTaskForGitHub = formatTaskForGitHub;
+    exports.formatTaskForLinear = formatTaskForLinear;
+    function formatTaskForGitHub(task, options = {}) {
+      const { includeMeta = true, includeSubtasks = true, includeRelatedFiles = true, resolvedBy, resolvedByPR, fromColumn, boardTitle, extraLabels = [], includeTaskId = true } = options;
+      const title = includeTaskId ? `[${task.id}] ${task.title}` : task.title;
+      const sections = [];
+      if (task.description) {
+        sections.push(task.description);
+      }
+      if (includeSubtasks && task.subtasks && task.subtasks.length > 0) {
+        sections.push(formatSubtasksMarkdown(task.subtasks));
+      }
+      if (includeMeta) {
+        const meta = formatMetadataSection(task, { fromColumn, boardTitle });
+        if (meta) {
+          sections.push(meta);
+        }
+      }
+      if (includeRelatedFiles && task.relatedFiles && task.relatedFiles.length > 0) {
+        sections.push(formatRelatedFilesSection(task.relatedFiles));
+      }
+      if (resolvedBy || resolvedByPR) {
+        sections.push(formatResolutionSection(resolvedBy, resolvedByPR));
+      }
+      sections.push("---\n*Archived from brainfile.md*");
+      const labels = [...task.tags || [], ...extraLabels];
+      if (task.priority) {
+        labels.push(`priority:${task.priority}`);
+      }
+      if (task.template) {
+        labels.push(task.template);
+      }
+      return {
+        title,
+        body: sections.join("\n\n"),
+        labels: labels.length > 0 ? labels : void 0,
+        state: "closed"
+      };
+    }
+    function mapPriorityToLinear(priority) {
+      switch (priority) {
+        case "critical":
+          return 1;
+        case "high":
+          return 2;
+        case "medium":
+          return 3;
+        case "low":
+          return 4;
+        default:
+          return void 0;
+      }
+    }
+    function formatTaskForLinear(task, options = {}) {
+      const { includeMeta = true, includeSubtasks = true, includeRelatedFiles = true, resolvedBy, resolvedByPR, fromColumn, boardTitle, stateName = "Done", includeTaskId = false } = options;
+      const title = includeTaskId ? `[${task.id}] ${task.title}` : task.title;
+      const sections = [];
+      if (task.description) {
+        sections.push(task.description);
+      }
+      if (includeSubtasks && task.subtasks && task.subtasks.length > 0) {
+        sections.push(formatSubtasksMarkdown(task.subtasks));
+      }
+      if (includeMeta) {
+        const meta = formatMetadataSection(task, { fromColumn, boardTitle });
+        if (meta) {
+          sections.push(meta);
+        }
+      }
+      if (includeRelatedFiles && task.relatedFiles && task.relatedFiles.length > 0) {
+        sections.push(formatRelatedFilesSection(task.relatedFiles));
+      }
+      if (resolvedBy || resolvedByPR) {
+        sections.push(formatResolutionSection(resolvedBy, resolvedByPR));
+      }
+      sections.push("---\n*Archived from brainfile.md*");
+      return {
+        title,
+        description: sections.join("\n\n"),
+        priority: mapPriorityToLinear(task.priority),
+        labelNames: task.tags && task.tags.length > 0 ? task.tags : void 0,
+        stateName
+      };
+    }
+    function formatSubtasksMarkdown(subtasks) {
+      const items = subtasks.map((st) => `- [${st.completed ? "x" : " "}] ${st.title}`);
+      return `## Subtasks
+
+${items.join("\n")}`;
+    }
+    function formatMetadataSection(task, context) {
+      const lines = [];
+      if (context.boardTitle) {
+        lines.push(`**Board:** ${context.boardTitle}`);
+      }
+      if (context.fromColumn) {
+        lines.push(`**Column:** ${context.fromColumn}`);
+      }
+      if (task.priority) {
+        lines.push(`**Priority:** ${task.priority}`);
+      }
+      if (task.assignee) {
+        lines.push(`**Assignee:** ${task.assignee}`);
+      }
+      if (task.dueDate) {
+        lines.push(`**Due Date:** ${task.dueDate}`);
+      }
+      if (task.createdAt) {
+        lines.push(`**Created:** ${task.createdAt}`);
+      }
+      if (lines.length === 0) {
+        return null;
+      }
+      return `## Details
+
+${lines.join("\n")}`;
+    }
+    function formatRelatedFilesSection(files) {
+      const items = files.map((f) => `- \`${f}\``);
+      return `## Related Files
+
+${items.join("\n")}`;
+    }
+    function formatResolutionSection(resolvedBy, resolvedByPR) {
+      const lines = ["## Resolution"];
+      if (resolvedByPR) {
+        lines.push(`
+**Pull Request:** ${resolvedByPR}`);
+      }
+      if (resolvedBy) {
+        lines.push(`
+**Commit:** ${resolvedBy}`);
+      }
+      return lines.join("");
+    }
+  }
+});
+
+// ../core/dist/boardContent.js
+var require_boardContent = __commonJS({
+  "../core/dist/boardContent.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.parseBoardConfig = parseBoardConfig;
+    exports.serializeBoardConfig = serializeBoardConfig;
+    var frontmatter_1 = require_frontmatter();
+    function parseBoardConfig(content) {
+      const parsed = (0, frontmatter_1.parseFrontmatter)(content);
+      if (!parsed) {
+        return null;
+      }
+      return {
+        config: parsed.data,
+        body: parsed.body
+      };
+    }
+    function serializeBoardConfig(config, body = "") {
+      return (0, frontmatter_1.serializeFrontmatter)(config, body);
+    }
+  }
+});
+
+// ../core/dist/boardFile.js
+var require_boardFile = __commonJS({
+  "../core/dist/boardFile.js"(exports) {
+    "use strict";
+    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    }) : (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    }));
+    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? (function(o, v) {
+      Object.defineProperty(o, "default", { enumerable: true, value: v });
+    }) : function(o, v) {
+      o["default"] = v;
+    });
+    var __importStar = exports && exports.__importStar || /* @__PURE__ */ (function() {
+      var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function(o2) {
+          var ar = [];
+          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
+          return ar;
+        };
+        return ownKeys(o);
+      };
+      return function(mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) {
+          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        }
+        __setModuleDefault(result, mod);
+        return result;
+      };
+    })();
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.serializeBoardConfig = exports.parseBoardConfig = void 0;
+    exports.readBoardConfig = readBoardConfig;
+    exports.writeBoardConfig = writeBoardConfig;
+    var fs11 = __importStar(__require("fs"));
+    var path11 = __importStar(__require("path"));
+    var boardContent_1 = require_boardContent();
+    var boardContent_2 = require_boardContent();
+    Object.defineProperty(exports, "parseBoardConfig", { enumerable: true, get: function() {
+      return boardContent_2.parseBoardConfig;
+    } });
+    Object.defineProperty(exports, "serializeBoardConfig", { enumerable: true, get: function() {
+      return boardContent_2.serializeBoardConfig;
+    } });
+    function readBoardConfig(filePath) {
+      let content;
+      try {
+        content = fs11.readFileSync(filePath, "utf-8");
+      } catch {
+        return null;
+      }
+      const parsed = (0, boardContent_1.parseBoardConfig)(content);
+      if (!parsed) {
+        return null;
       }
-      return records;
+      return {
+        config: parsed.config,
+        body: parsed.body,
+        filePath: path11.resolve(filePath)
+      };
     }
-    function getTaskContext(logsDir, relatedFiles, deliverables, options = {}) {
-      const scopeFiles = toUniquePaths([
-        ...relatedFiles,
-        ...collectDeliverableInputPaths(deliverables)
-      ]);
-      if (scopeFiles.length === 0) {
-        return [];
-      }
-      let entries = readLedger(logsDir).filter((record) => matchesDateRange(record.completedAt, options.dateRange)).map((record) => {
-        const matchedFiles = matchedFilesForScope(scopeFiles, collectRecordFiles(record));
-        return { record, matchedFiles };
-      }).filter((entry) => entry.matchedFiles.length > 0);
-      entries.sort((a, b) => timestampOr(b.record.completedAt, 0) - timestampOr(a.record.completedAt, 0));
-      if (options.limit !== void 0 && options.limit > 0) {
-        entries = entries.slice(0, options.limit);
-      }
-      return entries;
+    function writeBoardConfig(filePath, config, body = "") {
+      const dir = path11.dirname(filePath);
+      fs11.mkdirSync(dir, { recursive: true });
+      const content = (0, boardContent_1.serializeBoardConfig)(config, body);
+      fs11.writeFileSync(filePath, content, "utf-8");
     }
   }
 });
@@ -8902,8 +9469,8 @@ var require_taskOperations = __commonJS({
     exports.activateTaskContract = activateTaskContract;
     exports.activateTaskContractsByParent = activateTaskContractsByParent;
     exports.getEffectiveState = getEffectiveState;
-    var fs7 = __importStar(__require("fs"));
-    var path7 = __importStar(__require("path"));
+    var fs11 = __importStar(__require("fs"));
+    var path11 = __importStar(__require("path"));
     var boardValidation_1 = require_boardValidation();
     var contractSpec_1 = require_contractSpec();
     var idGen_1 = require_idGen();
@@ -9005,52 +9572,29 @@ ${section}
       return lines.join("\n");
     }
     function writeTaskFileExclusive(filePath, task, body) {
-      const dir = path7.dirname(filePath);
-      fs7.mkdirSync(dir, { recursive: true });
+      const dir = path11.dirname(filePath);
+      fs11.mkdirSync(dir, { recursive: true });
       const content = (0, taskFile_1.serializeTaskContent)(task, body);
-      fs7.writeFileSync(filePath, content, { encoding: "utf-8", flag: "wx" });
+      fs11.writeFileSync(filePath, content, { encoding: "utf-8", flag: "wx" });
     }
     function rollbackLedgerAppend(logsDir, appendedRecord) {
-      const ledgerPath = path7.join(logsDir, "ledger.jsonl");
+      const ledgerPath = path11.join(logsDir, "ledger.jsonl");
       const appendedLine = `${JSON.stringify(appendedRecord)}
 `;
       const appendedBytes = Buffer.byteLength(appendedLine, "utf-8");
       try {
-        const stat = fs7.statSync(ledgerPath);
+        const stat = fs11.statSync(ledgerPath);
         const newSize = stat.size - appendedBytes;
         if (newSize >= 0) {
-          fs7.truncateSync(ledgerPath, newSize);
+          fs11.truncateSync(ledgerPath, newSize);
         }
       } catch {
       }
     }
-    function completeTaskFileLegacy(taskPath, logsDir, doc, completedTask, childStates) {
-      const baseName = path7.basename(taskPath);
-      const destPath = path7.join(logsDir, baseName);
-      let completedBody = doc.body;
-      if (doc.task.type === "epic") {
-        const childTasksSection = buildChildTasksSection(childStates ?? []);
-        completedBody = appendBodySection(doc.body, childTasksSection);
-      }
-      if (fs7.existsSync(destPath)) {
-        return { success: false, error: `Task already exists in logs: ${doc.task.id}` };
-      }
-      try {
-        fs7.mkdirSync(logsDir, { recursive: true });
-        writeTaskFileExclusive(destPath, completedTask, completedBody);
-      } catch (err) {
-        return { success: false, error: `Failed to complete task: ${err}` };
-      }
-      try {
-        fs7.unlinkSync(taskPath);
-        return { success: true, task: completedTask, filePath: destPath };
-      } catch (err) {
-        try {
-          fs7.unlinkSync(destPath);
-        } catch {
-        }
-        return { success: false, error: `Failed to finalize completion: ${err}` };
-      }
+    function archivedBody(doc, childStates) {
+      if (doc.task.type !== "epic")
+        return doc.body;
+      return appendBodySection(doc.body, buildChildTasksSection(childStates ?? []));
     }
     function generateNextFileTaskId(boardDir, logsDir, typePrefix = "task") {
       let maxNum = 0;
@@ -9124,7 +9668,7 @@ ${section}
         };
         let filePath;
         try {
-          filePath = path7.join(boardDir, (0, taskFile_1.taskFileName)(taskId));
+          filePath = path11.join(boardDir, (0, taskFile_1.taskFileName)(taskId));
         } catch (err) {
           return { success: false, error: err.message };
         }
@@ -9178,7 +9722,7 @@ ${section}
       if (!doc) {
         return { success: false, error: `Task not found: ${taskId}` };
       }
-      let filePath = doc.filePath ?? path7.join(dirs.boardDir, (0, taskFile_1.taskFileName)(taskId));
+      let filePath = doc.filePath ?? path11.join(dirs.boardDir, (0, taskFile_1.taskFileName)(taskId));
       if (doc.task.column === resolvedColumn.id) {
         return { success: true, task: doc.task, filePath, column: resolvedColumn, noop: true };
       }
@@ -9198,7 +9742,7 @@ ${section}
       if (!shouldAutoComplete) {
         return { success: true, task, filePath, column: resolvedColumn };
       }
-      const completeResult = completeTaskFile(filePath, dirs.logsDir, { legacyMode: true });
+      const completeResult = completeTaskFile(filePath, dirs.logsDir);
       if (!completeResult.success || !completeResult.task) {
         return {
           success: false,
@@ -9394,7 +9938,7 @@ ${section}
       let childStates;
       let incompleteChildren;
       if (doc.task.type === "epic") {
-        const boardDir = path7.dirname(taskPath);
+        const boardDir = path11.dirname(taskPath);
         childStates = resolveEpicChildStates(doc.task, boardDir, logsDir);
         const incomplete = childStates.filter((child) => child.status === "active").map((child) => ({ id: child.id, title: child.title }));
         if (incomplete.length > 0) {
@@ -9415,32 +9959,43 @@ ${section}
         completedAt: now,
         updatedAt: now
       };
-      if (options.legacyMode) {
-        const legacyResult = completeTaskFileLegacy(taskPath, logsDir, doc, completedTask, childStates);
-        return incompleteChildren && legacyResult.success ? { ...legacyResult, incompleteChildren } : legacyResult;
+      const destPath = path11.join(logsDir, path11.basename(taskPath));
+      if (fs11.existsSync(destPath)) {
+        return { success: false, error: `Task already exists in logs: ${doc.task.id}` };
       }
-      const record = (0, ledger_2.buildLedgerRecord)(completedTask, doc.body, {
+      const completedBody = archivedBody(doc, childStates);
+      const record = (0, ledger_2.buildLedgerRecord)(completedTask, completedBody, {
         summary: options.summary,
         filesChanged: options.filesChanged,
         completedAt: now,
         columnHistory: options.columnHistory,
         validationAttempts: options.validationAttempts
       });
-      let ledgerPath;
       try {
-        ledgerPath = (0, ledger_2.appendLedgerRecord)(logsDir, record);
+        (0, ledger_2.appendLedgerRecord)(logsDir, record);
       } catch (err) {
         return { success: false, error: `Failed to append ledger record: ${err}` };
       }
       try {
-        fs7.unlinkSync(taskPath);
+        fs11.mkdirSync(logsDir, { recursive: true });
+        writeTaskFileExclusive(destPath, completedTask, completedBody);
+      } catch (err) {
+        rollbackLedgerAppend(logsDir, record);
+        return { success: false, error: `Failed to complete task: ${err}` };
+      }
+      try {
+        fs11.unlinkSync(taskPath);
         return {
           success: true,
           task: completedTask,
-          filePath: ledgerPath,
+          filePath: destPath,
           ...incompleteChildren && { incompleteChildren }
         };
       } catch (err) {
+        try {
+          fs11.unlinkSync(destPath);
+        } catch {
+        }
         rollbackLedgerAppend(logsDir, record);
         return { success: false, error: `Failed to finalize completion: ${err}` };
       }
@@ -9451,7 +10006,7 @@ ${section}
         return { success: false, error: `Failed to read task file: ${taskPath}` };
       }
       try {
-        fs7.unlinkSync(taskPath);
+        fs11.unlinkSync(taskPath);
         return { success: true, task: doc.task };
       } catch (err) {
         return { success: false, error: `Failed to delete task file: ${err}` };
@@ -9526,7 +10081,7 @@ ${section}
     }
     function findTask(boardDir, taskId) {
       try {
-        const directPath = path7.join(boardDir, (0, taskFile_1.taskFileName)(taskId));
+        const directPath = path11.join(boardDir, (0, taskFile_1.taskFileName)(taskId));
         const directDoc = (0, taskFile_1.readTaskFile)(directPath);
         if (directDoc && directDoc.task.id === taskId) {
           return directDoc;
@@ -9759,7 +10314,7 @@ ${section}
         if (doc.task.contract?.status !== "draft")
           continue;
         const task = applyContractActivation(doc.task, (/* @__PURE__ */ new Date()).toISOString());
-        const taskPath = doc.filePath ?? path7.join(boardDir, (0, taskFile_1.taskFileName)(task.id));
+        const taskPath = doc.filePath ?? path11.join(boardDir, (0, taskFile_1.taskFileName)(task.id));
         (0, taskFile_1.writeTaskFile)(taskPath, task, doc.body);
         activated.push(task.id);
       }
@@ -9775,196 +10330,6 @@ ${section}
   }
 });
 
-// ../core/dist/workspace.js
-var require_workspace = __commonJS({
-  "../core/dist/workspace.js"(exports) {
-    "use strict";
-    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      var desc = Object.getOwnPropertyDescriptor(m, k);
-      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-        desc = { enumerable: true, get: function() {
-          return m[k];
-        } };
-      }
-      Object.defineProperty(o, k2, desc);
-    }) : (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      o[k2] = m[k];
-    }));
-    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? (function(o, v) {
-      Object.defineProperty(o, "default", { enumerable: true, value: v });
-    }) : function(o, v) {
-      o["default"] = v;
-    });
-    var __importStar = exports && exports.__importStar || /* @__PURE__ */ (function() {
-      var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function(o2) {
-          var ar = [];
-          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
-          return ar;
-        };
-        return ownKeys(o);
-      };
-      return function(mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) {
-          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        }
-        __setModuleDefault(result, mod);
-        return result;
-      };
-    })();
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.getV2Dirs = getV2Dirs2;
-    exports.isV2 = isV25;
-    exports.ensureV2Dirs = ensureV2Dirs2;
-    exports.getTaskFilePath = getTaskFilePath2;
-    exports.getLogFilePath = getLogFilePath2;
-    exports.findV2Task = findV2Task2;
-    exports.extractDescription = extractDescription2;
-    exports.extractLog = extractLog2;
-    exports.composeBody = composeBody2;
-    exports.readV2BoardConfig = readV2BoardConfig2;
-    exports.buildBoardFromV2 = buildBoardFromV22;
-    var fs7 = __importStar(__require("fs"));
-    var path7 = __importStar(__require("path"));
-    var parser_1 = require_parser();
-    var taskFile_1 = require_taskFile();
-    function getV2Dirs2(brainfilePath) {
-      const resolvedPath = path7.resolve(brainfilePath);
-      const dotDir = path7.dirname(resolvedPath);
-      return {
-        dotDir,
-        boardDir: path7.join(dotDir, "board"),
-        logsDir: path7.join(dotDir, "logs"),
-        brainfilePath: resolvedPath
-      };
-    }
-    function isV25(brainfilePath) {
-      const { boardDir } = getV2Dirs2(brainfilePath);
-      return fs7.existsSync(boardDir);
-    }
-    function ensureV2Dirs2(brainfilePath) {
-      const dirs = getV2Dirs2(brainfilePath);
-      fs7.mkdirSync(dirs.boardDir, { recursive: true });
-      fs7.mkdirSync(dirs.logsDir, { recursive: true });
-      return dirs;
-    }
-    function getTaskFilePath2(boardDir, taskId) {
-      return path7.join(boardDir, (0, taskFile_1.taskFileName)(taskId));
-    }
-    function getLogFilePath2(logsDir, taskId) {
-      return path7.join(logsDir, (0, taskFile_1.taskFileName)(taskId));
-    }
-    function findV2Task2(dirs, taskId, searchLogs = false) {
-      const taskPath = getTaskFilePath2(dirs.boardDir, taskId);
-      const taskDoc = (0, taskFile_1.readTaskFile)(taskPath);
-      if (taskDoc && taskDoc.task.id === taskId) {
-        return { doc: taskDoc, filePath: taskPath, isLog: false };
-      }
-      if (searchLogs) {
-        const logPath = getLogFilePath2(dirs.logsDir, taskId);
-        const logDoc = (0, taskFile_1.readTaskFile)(logPath);
-        if (logDoc && logDoc.task.id === taskId) {
-          return { doc: logDoc, filePath: logPath, isLog: true };
-        }
-      }
-      const boardDocs = (0, taskFile_1.readTasksDir)(dirs.boardDir);
-      const boardMatch = boardDocs.find((d) => d.task.id === taskId);
-      if (boardMatch) {
-        return {
-          doc: boardMatch,
-          filePath: boardMatch.filePath || taskPath,
-          isLog: false
-        };
-      }
-      if (searchLogs) {
-        const logDocs = (0, taskFile_1.readTasksDir)(dirs.logsDir);
-        const logMatch = logDocs.find((d) => d.task.id === taskId);
-        if (logMatch) {
-          return {
-            doc: logMatch,
-            filePath: logMatch.filePath || getLogFilePath2(dirs.logsDir, taskId),
-            isLog: true
-          };
-        }
-      }
-      return null;
-    }
-    function extractDescription2(body) {
-      const match = body.match(/## Description\n([\s\S]*?)(?=\n## |\n*$)/);
-      return match ? match[1].trim() || void 0 : void 0;
-    }
-    function extractLog2(body) {
-      const match = body.match(/## Log\n([\s\S]*?)(?=\n## |\n*$)/);
-      return match ? match[1].trim() || void 0 : void 0;
-    }
-    function composeBody2(description, log) {
-      const sections = [];
-      if (description && description.trim()) {
-        sections.push(`## Description
-${description.trim()}`);
-      }
-      if (log && log.trim()) {
-        sections.push(`## Log
-${log.trim()}`);
-      }
-      if (sections.length === 0)
-        return "";
-      return `${sections.join("\n\n")}
-`;
-    }
-    function readV2BoardConfig2(brainfilePath) {
-      const content = fs7.readFileSync(brainfilePath, "utf-8");
-      const result = parser_1.BrainfileParser.parseWithErrors(content);
-      if (!result.board) {
-        throw new Error(`Failed to parse brainfile: ${result.error}`);
-      }
-      const board = result.board;
-      for (const col of board.columns) {
-        if (!col.tasks)
-          col.tasks = [];
-      }
-      return board;
-    }
-    function buildBoardFromV22(brainfilePath) {
-      const dirs = getV2Dirs2(brainfilePath);
-      const board = readV2BoardConfig2(brainfilePath);
-      const taskDocs = (0, taskFile_1.readTasksDir)(dirs.boardDir);
-      const tasksByColumn = /* @__PURE__ */ new Map();
-      for (const doc of taskDocs) {
-        const colId = doc.task.column || "todo";
-        if (!tasksByColumn.has(colId)) {
-          tasksByColumn.set(colId, []);
-        }
-        tasksByColumn.get(colId).push(doc);
-      }
-      for (const col of board.columns) {
-        const colTasks = tasksByColumn.get(col.id) || [];
-        colTasks.sort((a, b) => {
-          const posA = a.task.position ?? Number.MAX_SAFE_INTEGER;
-          const posB = b.task.position ?? Number.MAX_SAFE_INTEGER;
-          if (posA !== posB)
-            return posA - posB;
-          return a.task.id.localeCompare(b.task.id);
-        });
-        col.tasks = colTasks.map((doc) => {
-          const task = { ...doc.task };
-          if (!task.description) {
-            const description = extractDescription2(doc.body);
-            if (description)
-              task.description = description;
-          }
-          return task;
-        });
-      }
-      return board;
-    }
-  }
-});
-
 // ../core/dist/search.js
 var require_search = __commonJS({
   "../core/dist/search.js"(exports) {
@@ -10309,10 +10674,10 @@ var require_dist = __commonJS({
       for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports2, p)) __createBinding(exports2, m, p);
     };
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.archiveTasks = exports.deleteTasks = exports.patchTasks = exports.moveTasks = exports.setAllSubtasksCompleted = exports.setSubtasksCompleted = exports.updateSubtask = exports.deleteSubtask = exports.addSubtask = exports.patchTask = exports.restoreTask = exports.archiveTask = exports.updateStatsConfig = exports.updateBoardTitle = exports.toggleSubtask = exports.deleteTask = exports.updateTask = exports.addTask = exports.moveTask = exports.getAllTemplateIds = exports.getTemplateById = exports.processTemplate = exports.generateSubtaskId = exports.generateTaskId = exports.BUILT_IN_TEMPLATES = exports.hashBoardContent = exports.hashBoard = exports.diffBoards = exports.BrainfileLinter = exports.BrainfileValidator = exports.BrainfileSerializer = exports.loadSchemaHints = exports.parseSchemaHints = exports.inferRenderer = exports.inferType = exports.BrainfileParser = exports.buildContract = exports.parseDeliverableSpec = exports.normalizeToArray = exports.ALLOWED_DELIVERABLE_TYPES = exports.removeTaskContractConstraint = exports.addTaskContractConstraint = exports.removeTaskContractValidationCommand = exports.addTaskContractValidationCommand = exports.removeTaskContractDeliverable = exports.addTaskContractDeliverable = exports.patchTaskContract = exports.setTaskContractStatus = exports.clearTaskContract = exports.setTaskContract = void 0;
-    exports.BRAINFILE_STATE_BASENAME = exports.BRAINFILE_BASENAME = exports.DOT_BRAINFILE_DIRNAME = exports.ensureDotBrainfileGitignore = exports.ensureDotBrainfileDir = exports.getDotBrainfileGitignorePath = exports.getBrainfileStatePath = exports.getBrainfileStateDir = exports.resolveBrainfilePath = exports.findBrainfile = exports.EXCLUDE_DIRS = exports.BRAINFILE_GLOBS = exports.BRAINFILE_PATTERNS = exports.extractBrainfileSuffix = exports.isBrainfileName = exports.watchBrainfiles = exports.findNearestBrainfile = exports.findPrimaryBrainfile = exports.discover = exports.getParentTaskId = exports.isValidSubtaskId = exports.isValidTaskId = exports.generateNextSubtaskId = exports.generateSubtaskIdFromIndex = exports.generateNextTaskId = exports.getMaxTaskIdNumber = exports.extractTaskIdNumber = exports.getOverdueTasks = exports.getIncompleteSubtasksSummary = exports.getTasksWithIncompleteSubtasks = exports.isCompletionColumn = exports.findCompletionColumn = exports.columnExists = exports.getTotalTaskCount = exports.getColumnTaskCount = exports.searchTasks = exports.getTasksByAssignee = exports.getTasksByPriority = exports.getTasksByTag = exports.getAllTasks = exports.taskIdExists = exports.findTaskById = exports.findColumnByName = exports.findColumnById = exports.validateColumn = exports.validateType = exports.isTypeCompletable = exports.getBoardTypes = exports.deleteRule = exports.addRule = void 0;
-    exports.isLedgerContractStatus = exports.normalizePathValue = exports.getTaskContext = exports.getFileHistory = exports.queryLedger = exports.readLedger = exports.appendLedgerRecord = exports.buildLedgerRecord = exports.searchTasksRanked = exports.scoreTaskDocument = exports.taskMatchesFilters = exports.parseSearchQuery = exports.getEffectiveState = exports.activateTaskContractsByParent = exports.activateTaskContract = exports.attachTaskContract = exports.failTaskContract = exports.completeTaskContract = exports.deliverTaskContract = exports.pickupTaskContract = exports.updateSubtasksInFile = exports.toggleSubtasksInFile = exports.deleteSubtasksFromFile = exports.addSubtasksToFile = exports.searchLogs = exports.searchTaskFiles = exports.findTask = exports.listTasks = exports.appendLog = exports.deleteTaskFile = exports.completeTaskFile = exports.patchTaskFile = exports.moveTaskFileToColumn = exports.moveTaskFile = exports.addTaskFile = exports.generateNextFileTaskId = exports.DEFAULT_CONTRACT_COLUMN_MAP = exports.taskFileName = exports.readTasksDir = exports.writeTaskFile = exports.readTaskFile = exports.serializeTaskContent = exports.parseTaskContent = exports.writeBoardConfig = exports.readBoardConfig = exports.serializeBoardConfig = exports.parseBoardConfig = exports.formatTaskForLinear = exports.formatTaskForGitHub = exports.DOT_BRAINFILE_GITIGNORE_BASENAME = void 0;
-    exports.Brainfile = exports.buildBoardFromV2 = exports.readV2BoardConfig = exports.composeBody = exports.extractLog = exports.extractDescription = exports.findV2Task = exports.getLogFilePath = exports.getTaskFilePath = exports.ensureV2Dirs = exports.isV2 = exports.getV2Dirs = exports.topologicalSort = exports.DependencyCycleError = exports.MissingDependencyError = exports.ledgerRecordToCompletedRef = exports.taskToCompletedRef = void 0;
+    exports.patchTasks = exports.moveTasks = exports.setAllSubtasksCompleted = exports.setSubtasksCompleted = exports.updateSubtask = exports.deleteSubtask = exports.addSubtask = exports.patchTask = exports.restoreTask = exports.archiveTask = exports.updateStatsConfig = exports.updateBoardTitle = exports.toggleSubtask = exports.deleteTask = exports.updateTask = exports.addTask = exports.moveTask = exports.getAllTemplateIds = exports.getTemplateById = exports.processTemplate = exports.generateSubtaskId = exports.generateTaskId = exports.BUILT_IN_TEMPLATES = exports.hashBoardContent = exports.hashBoard = exports.diffBoards = exports.BrainfileLinter = exports.BrainfileValidator = exports.serializeFrontmatter = exports.parseFrontmatter = exports.BrainfileSerializer = exports.loadSchemaHints = exports.parseSchemaHints = exports.inferRenderer = exports.inferType = exports.BrainfileParser = exports.buildContract = exports.parseDeliverableSpec = exports.normalizeToArray = exports.ALLOWED_DELIVERABLE_TYPES = exports.removeTaskContractConstraint = exports.addTaskContractConstraint = exports.removeTaskContractValidationCommand = exports.addTaskContractValidationCommand = exports.removeTaskContractDeliverable = exports.addTaskContractDeliverable = exports.patchTaskContract = exports.setTaskContractStatus = exports.clearTaskContract = exports.setTaskContract = void 0;
+    exports.BRAINFILE_BASENAME = exports.DOT_BRAINFILE_DIRNAME = exports.atomicWriteFileSync = exports.ensureDotBrainfileGitignore = exports.ensureDotBrainfileDir = exports.getDotBrainfileGitignorePath = exports.getBrainfileStatePath = exports.getBrainfileStateDir = exports.resolveBrainfilePath = exports.findBrainfile = exports.EXCLUDE_DIRS = exports.BRAINFILE_GLOBS = exports.BRAINFILE_PATTERNS = exports.extractBrainfileSuffix = exports.isBrainfileName = exports.watchBrainfiles = exports.findNearestBrainfile = exports.findPrimaryBrainfile = exports.discover = exports.getParentTaskId = exports.isValidSubtaskId = exports.isValidTaskId = exports.generateNextSubtaskId = exports.generateSubtaskIdFromIndex = exports.generateNextTaskId = exports.getMaxTaskIdNumber = exports.extractTaskIdNumber = exports.getOverdueTasks = exports.getIncompleteSubtasksSummary = exports.getTasksWithIncompleteSubtasks = exports.isCompletionColumn = exports.findCompletionColumn = exports.columnExists = exports.getTotalTaskCount = exports.getColumnTaskCount = exports.searchTasks = exports.getTasksByAssignee = exports.getTasksByPriority = exports.getTasksByTag = exports.getAllTasks = exports.taskIdExists = exports.findTaskById = exports.findColumnByName = exports.findColumnById = exports.validateColumn = exports.validateType = exports.isTypeCompletable = exports.getBoardTypes = exports.archiveTasks = exports.deleteTasks = void 0;
+    exports.activateTaskContract = exports.attachTaskContract = exports.failTaskContract = exports.completeTaskContract = exports.deliverTaskContract = exports.pickupTaskContract = exports.updateSubtasksInFile = exports.toggleSubtasksInFile = exports.deleteSubtasksFromFile = exports.addSubtasksToFile = exports.searchLogs = exports.searchTaskFiles = exports.findTask = exports.listTasks = exports.appendLog = exports.deleteTaskFile = exports.completeTaskFile = exports.patchTaskFile = exports.moveTaskFileToColumn = exports.moveTaskFile = exports.addTaskFile = exports.generateNextFileTaskId = exports.DEFAULT_CONTRACT_COLUMN_MAP = exports.taskFileName = exports.readTasksDir = exports.writeTaskFile = exports.readTaskFile = exports.serializeTaskContent = exports.parseTaskContent = exports.writeBoardConfig = exports.readBoardConfig = exports.serializeBoardConfig = exports.parseBoardConfig = exports.formatTaskForLinear = exports.formatTaskForGitHub = exports.BRIEF_STATE_VERSION = exports.sanitizeAgentFilename = exports.getBriefStatePath = exports.getBriefStateDir = exports.writeBriefState = exports.readBriefState = exports.relativeTime = exports.parseNotes = exports.parseNoteLine = exports.isEmptyBrief = exports.buildBrief = exports.DOT_BRAINFILE_STATE_IGNORE_ENTRY = exports.DOT_BRAINFILE_STATE_DIRNAME = exports.DOT_BRAINFILE_GITIGNORE_BASENAME = exports.BRAINFILE_STATE_BASENAME = void 0;
+    exports.Brainfile = exports.buildBoardFromV2 = exports.readV2BoardConfig = exports.composeBody = exports.extractLog = exports.extractDescription = exports.findV2Task = exports.getLogFilePath = exports.getTaskFilePath = exports.ensureV2Dirs = exports.isV2 = exports.getV2Dirs = exports.topologicalSort = exports.DependencyCycleError = exports.MissingDependencyError = exports.ledgerRecordToCompletedRef = exports.taskToCompletedRef = exports.isLedgerContractStatus = exports.normalizePathValue = exports.getTaskContext = exports.getFileHistory = exports.queryLedger = exports.readLedger = exports.appendLedgerRecord = exports.buildLedgerRecord = exports.searchTasksRanked = exports.scoreTaskDocument = exports.taskMatchesFilters = exports.parseSearchQuery = exports.getEffectiveState = exports.activateTaskContractsByParent = void 0;
     __exportStar(require_types2(), exports);
     __exportStar(require_contract(), exports);
     var contract_1 = require_contract2();
@@ -10381,6 +10746,13 @@ var require_dist = __commonJS({
     Object.defineProperty(exports, "BrainfileSerializer", { enumerable: true, get: function() {
       return serializer_1.BrainfileSerializer;
     } });
+    var frontmatter_1 = require_frontmatter();
+    Object.defineProperty(exports, "parseFrontmatter", { enumerable: true, get: function() {
+      return frontmatter_1.parseFrontmatter;
+    } });
+    Object.defineProperty(exports, "serializeFrontmatter", { enumerable: true, get: function() {
+      return frontmatter_1.serializeFrontmatter;
+    } });
     var validator_1 = require_validator();
     Object.defineProperty(exports, "BrainfileValidator", { enumerable: true, get: function() {
       return validator_1.BrainfileValidator;
@@ -10476,12 +10848,6 @@ var require_dist = __commonJS({
     Object.defineProperty(exports, "archiveTasks", { enumerable: true, get: function() {
       return operations_1.archiveTasks;
     } });
-    Object.defineProperty(exports, "addRule", { enumerable: true, get: function() {
-      return operations_1.addRule;
-    } });
-    Object.defineProperty(exports, "deleteRule", { enumerable: true, get: function() {
-      return operations_1.deleteRule;
-    } });
     var boardValidation_1 = require_boardValidation();
     Object.defineProperty(exports, "getBoardTypes", { enumerable: true, get: function() {
       return boardValidation_1.getBoardTypes;
@@ -10622,6 +10988,9 @@ var require_dist = __commonJS({
     Object.defineProperty(exports, "ensureDotBrainfileGitignore", { enumerable: true, get: function() {
       return files_1.ensureDotBrainfileGitignore;
     } });
+    Object.defineProperty(exports, "atomicWriteFileSync", { enumerable: true, get: function() {
+      return files_1.atomicWriteFileSync;
+    } });
     Object.defineProperty(exports, "DOT_BRAINFILE_DIRNAME", { enumerable: true, get: function() {
       return files_1.DOT_BRAINFILE_DIRNAME;
     } });
@@ -10634,6 +11003,47 @@ var require_dist = __commonJS({
     Object.defineProperty(exports, "DOT_BRAINFILE_GITIGNORE_BASENAME", { enumerable: true, get: function() {
       return files_1.DOT_BRAINFILE_GITIGNORE_BASENAME;
     } });
+    Object.defineProperty(exports, "DOT_BRAINFILE_STATE_DIRNAME", { enumerable: true, get: function() {
+      return files_1.DOT_BRAINFILE_STATE_DIRNAME;
+    } });
+    Object.defineProperty(exports, "DOT_BRAINFILE_STATE_IGNORE_ENTRY", { enumerable: true, get: function() {
+      return files_1.DOT_BRAINFILE_STATE_IGNORE_ENTRY;
+    } });
+    var brief_1 = require_brief();
+    Object.defineProperty(exports, "buildBrief", { enumerable: true, get: function() {
+      return brief_1.buildBrief;
+    } });
+    Object.defineProperty(exports, "isEmptyBrief", { enumerable: true, get: function() {
+      return brief_1.isEmptyBrief;
+    } });
+    Object.defineProperty(exports, "parseNoteLine", { enumerable: true, get: function() {
+      return brief_1.parseNoteLine;
+    } });
+    Object.defineProperty(exports, "parseNotes", { enumerable: true, get: function() {
+      return brief_1.parseNotes;
+    } });
+    Object.defineProperty(exports, "relativeTime", { enumerable: true, get: function() {
+      return brief_1.relativeTime;
+    } });
+    var briefState_1 = require_briefState();
+    Object.defineProperty(exports, "readBriefState", { enumerable: true, get: function() {
+      return briefState_1.readBriefState;
+    } });
+    Object.defineProperty(exports, "writeBriefState", { enumerable: true, get: function() {
+      return briefState_1.writeBriefState;
+    } });
+    Object.defineProperty(exports, "getBriefStateDir", { enumerable: true, get: function() {
+      return briefState_1.getBriefStateDir;
+    } });
+    Object.defineProperty(exports, "getBriefStatePath", { enumerable: true, get: function() {
+      return briefState_1.getBriefStatePath;
+    } });
+    Object.defineProperty(exports, "sanitizeAgentFilename", { enumerable: true, get: function() {
+      return briefState_1.sanitizeAgentFilename;
+    } });
+    Object.defineProperty(exports, "BRIEF_STATE_VERSION", { enumerable: true, get: function() {
+      return briefState_1.BRIEF_STATE_VERSION;
+    } });
     var formatters_1 = require_formatters();
     Object.defineProperty(exports, "formatTaskForGitHub", { enumerable: true, get: function() {
       return formatters_1.formatTaskForGitHub;
@@ -10918,16 +11328,6 @@ var require_dist = __commonJS({
       static findTaskLocation(content, taskId) {
         return parser_2.BrainfileParser.findTaskLocation(content, taskId);
       }
-      /**
-       * Find the location of a rule in the file content
-       * @param content - The markdown content
-       * @param ruleId - The rule ID to find
-       * @param ruleType - The type of rule
-       * @returns Line and column location or null if not found
-       */
-      static findRuleLocation(content, ruleId, ruleType) {
-        return parser_2.BrainfileParser.findRuleLocation(content, ruleId, ruleType);
-      }
     };
     exports.Brainfile = Brainfile2;
     var parser_2 = require_parser();
@@ -10938,10 +11338,8 @@ var require_dist = __commonJS({
   }
 });
 
-// src/utils/brainfile-path.ts
-var import_core3 = __toESM(require_dist());
-import * as fs2 from "fs";
-import * as path2 from "path";
+// src/utils/cli-error.ts
+var import_chalk2 = __toESM(require_source());
 
 // src/utils/errorHandler.ts
 var import_chalk = __toESM(require_source());
@@ -11107,6 +11505,23 @@ ${availableTasks.map((t) => `  - ${t}`).join("\n")}`;
 function validationError2(message) {
   return new CLIError(`Validation error: ${message}`, ExitCode.USER_ERROR);
 }
+function renderCliError(error) {
+  if (error instanceof CLIError) {
+    console.error(import_chalk2.default.red(`Error: ${error.message}`));
+    if (error.details) {
+      console.error("");
+      console.error(import_chalk2.default.gray(error.details));
+    }
+    process.exit(error.exitCode);
+  }
+  console.error(error instanceof Error ? error.stack : String(error));
+  process.exit(ExitCode.USER_ERROR);
+}
+
+// src/utils/brainfile-path.ts
+var import_core3 = __toESM(require_dist());
+import * as fs3 from "fs";
+import * as path3 from "path";
 
 // src/utils/v2-only.ts
 var import_core2 = __toESM(require_dist());
@@ -11127,78 +11542,415 @@ function assertV2Brainfile(brainfilePath) {
   }
 }
 
+// src/utils/board-repo.ts
+import * as fs2 from "fs";
+import * as os from "os";
+import * as path2 from "path";
+import { spawnSync } from "child_process";
+var DEFAULT_BOARD_BRANCH = "brainfile";
+var BOARD_BRANCH_CONFIG_KEY = "brainfile.branch";
+var EXCLUDE_ENTRY = ".brainfile/";
+var EXCLUDE_MARKER = "# brainfile: board worktree (managed by `brainfile`)";
+var FALLBACK_IDENTITY_NAME = "brainfile";
+var FALLBACK_IDENTITY_EMAIL = "brainfile@localhost";
+var MAX_MESSAGE_LENGTH = 72;
+var BOARD_SUBDIRS = ["board", "logs"];
+function git(args, cwd, env) {
+  const result = spawnSync("git", args, {
+    cwd,
+    encoding: "utf-8",
+    env: env ? { ...process.env, ...env } : process.env,
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  return {
+    ok: result.status === 0,
+    status: result.status,
+    stdout: (result.stdout ?? "").toString().trim(),
+    stderr: (result.stderr ?? "").toString().trim()
+  };
+}
+function gitToplevel(cwd) {
+  const r = git(["rev-parse", "--show-toplevel"], cwd);
+  return r.ok && r.stdout ? path2.resolve(r.stdout) : null;
+}
+function gitCommonDir(cwd) {
+  const r = git(["rev-parse", "--git-common-dir"], cwd);
+  if (!r.ok || !r.stdout) return null;
+  return path2.resolve(cwd, r.stdout);
+}
+function listWorktrees(cwd) {
+  const r = git(["worktree", "list", "--porcelain"], cwd);
+  if (!r.ok) return [];
+  const entries = [];
+  let current = null;
+  for (const line of r.stdout.split("\n")) {
+    if (line.startsWith("worktree ")) {
+      current = { path: path2.resolve(line.slice("worktree ".length)), bare: false, detached: false };
+      entries.push(current);
+    } else if (!current) {
+      continue;
+    } else if (line.startsWith("HEAD ")) {
+      current.head = line.slice(5);
+    } else if (line.startsWith("branch ")) {
+      current.branch = line.slice(7);
+    } else if (line === "bare") {
+      current.bare = true;
+    } else if (line === "detached") {
+      current.detached = true;
+    }
+  }
+  return entries;
+}
+function boardBranch(cwd) {
+  const r = git(["config", "--get", BOARD_BRANCH_CONFIG_KEY], cwd);
+  return r.ok && r.stdout ? r.stdout : DEFAULT_BOARD_BRANCH;
+}
+function boardRepoKind(dotDir) {
+  try {
+    const st = fs2.statSync(path2.join(dotDir, ".git"));
+    if (st.isFile()) return "linked";
+    if (st.isDirectory()) return "standalone";
+  } catch {
+  }
+  return null;
+}
+function isTrackedBoard(dotDir) {
+  return boardRepoKind(dotDir) !== null;
+}
+function findTrackedBoardDir(cwd) {
+  const worktrees = listWorktrees(cwd);
+  if (worktrees.length === 0) return null;
+  const wanted = `refs/heads/${boardBranch(cwd)}`;
+  const hit = worktrees.find((w) => w.branch === wanted);
+  if (!hit) return null;
+  return fs2.existsSync(path2.join(hit.path, "brainfile.md")) ? hit.path : null;
+}
+function materializeBoardWorktree(cwd) {
+  const branch = boardBranch(cwd);
+  const hasLocal = git(["rev-parse", "--verify", "--quiet", `refs/heads/${branch}`], cwd).ok;
+  const configuredRemote = git(["config", "--get", "brainfile.remote"], cwd).stdout || null;
+  const configuredBranch = git(["config", "--get", "brainfile.remoteBranch"], cwd).stdout || branch;
+  let upstream = null;
+  if (!hasLocal) {
+    if (configuredRemote) {
+      const ref = `${configuredRemote}/${configuredBranch}`;
+      if (!git(["rev-parse", "--verify", "--quiet", `refs/remotes/${ref}`], cwd).ok) {
+        git(["fetch", "--quiet", configuredRemote, configuredBranch], cwd);
+      }
+      if (git(["rev-parse", "--verify", "--quiet", `refs/remotes/${ref}`], cwd).ok) upstream = ref;
+    }
+    if (!upstream && git(["rev-parse", "--verify", "--quiet", `refs/remotes/origin/${branch}`], cwd).ok) {
+      upstream = `origin/${branch}`;
+    }
+  }
+  if (!hasLocal && !upstream) return null;
+  const worktrees = listWorktrees(cwd);
+  if (worktrees.length === 0) return null;
+  if (worktrees.some((w) => w.branch === `refs/heads/${branch}`)) return null;
+  const main = worktrees[0];
+  let target;
+  if (main.bare) {
+    const common = gitCommonDir(cwd);
+    if (!common) return null;
+    target = path2.join(common, "brainfile");
+  } else {
+    target = path2.join(main.path, ".brainfile");
+  }
+  if (fs2.existsSync(target)) return null;
+  const r = hasLocal ? git(["worktree", "add", "--quiet", target, branch], cwd) : git(["worktree", "add", "--quiet", "--track", "-b", branch, target, upstream], cwd);
+  if (!r.ok) return null;
+  ensureExcludeEntry(cwd);
+  for (const sub of BOARD_SUBDIRS) fs2.mkdirSync(path2.join(target, sub), { recursive: true });
+  const cameFrom = upstream ? upstream.slice(0, upstream.indexOf("/")) : null;
+  if (cameFrom && !configuredRemote) git(["config", "brainfile.remote", cameFrom], cwd);
+  const relative3 = path2.relative(process.cwd(), target) || ".";
+  process.stderr.write(
+    cameFrom ? `Checked out the shared board from ${cameFrom} into ${relative3}/
+` : `Checked out the board from the '${branch}' branch into ${relative3}/
+`
+  );
+  return target;
+}
+function ensureExcludeEntry(cwd) {
+  const common = gitCommonDir(cwd);
+  if (!common) return false;
+  const file = path2.join(common, "info", "exclude");
+  const existing = fs2.existsSync(file) ? fs2.readFileSync(file, "utf-8") : "";
+  const present = existing.split(/\r?\n/).some((line) => line.trim() === EXCLUDE_ENTRY || line.trim() === ".brainfile");
+  if (present) return false;
+  fs2.mkdirSync(path2.dirname(file), { recursive: true });
+  const separator = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+  fs2.appendFileSync(file, `${separator}${EXCLUDE_MARKER}
+${EXCLUDE_ENTRY}
+`, "utf-8");
+  return true;
+}
+function removeExcludeEntry(cwd) {
+  const common = gitCommonDir(cwd);
+  if (!common) return false;
+  const file = path2.join(common, "info", "exclude");
+  if (!fs2.existsSync(file)) return false;
+  const lines = fs2.readFileSync(file, "utf-8").split(/\r?\n/);
+  const at = lines.indexOf(EXCLUDE_MARKER);
+  if (at < 0) return false;
+  const removeCount = lines[at + 1]?.trim() === EXCLUDE_ENTRY ? 2 : 1;
+  lines.splice(at, removeCount);
+  fs2.writeFileSync(file, lines.join("\n"), "utf-8");
+  return true;
+}
+function createOrphanBoardWorktree(repoCwd, dotDir, branch) {
+  const r = git(["worktree", "add", "--quiet", "--orphan", "-b", branch, dotDir], repoCwd);
+  if (!r.ok) {
+    throw new Error(
+      `Could not create the board worktree on branch '${branch}' (git >= 2.42 is required for --orphan): ${r.stderr}`
+    );
+  }
+}
+function initStandaloneBoardRepo(dotDir) {
+  const parent = path2.dirname(dotDir);
+  let r = git(["init", "--quiet", "-b", "main", dotDir], parent);
+  if (!r.ok) r = git(["init", "--quiet", dotDir], parent);
+  if (!r.ok) throw new Error(`Could not initialize a git repository in ${dotDir}: ${r.stderr}`);
+}
+function boardIsDirty(dotDir) {
+  const r = git(["status", "--porcelain"], dotDir);
+  return r.ok && r.stdout.length > 0;
+}
+function unmergedFiles(dotDir) {
+  const r = git(["diff", "--name-only", "--diff-filter=U"], dotDir);
+  return r.ok ? r.stdout.split("\n").map((l) => l.trim()).filter(Boolean) : [];
+}
+function boardDirtyFiles(dotDir) {
+  const r = git(["status", "--porcelain"], dotDir);
+  if (!r.ok || !r.stdout) return [];
+  return r.stdout.split("\n").map((line) => line.replace(/^[ MADRCU?!]{1,2}\s+/, "").replace(/^.* -> /, "").trim()).filter(Boolean);
+}
+function identityArgs(dotDir) {
+  const args = [];
+  if (!git(["config", "--get", "user.name"], dotDir).stdout) args.push("-c", `user.name=${FALLBACK_IDENTITY_NAME}`);
+  if (!git(["config", "--get", "user.email"], dotDir).stdout) args.push("-c", `user.email=${FALLBACK_IDENTITY_EMAIL}`);
+  return args;
+}
+function sanitizeAgent(agent) {
+  return agent.replace(/[<>\r\n]/g, "").trim();
+}
+var commitListeners = [];
+function onBoardCommitted(listener) {
+  if (!commitListeners.includes(listener)) commitListeners.push(listener);
+}
+function notifyCommitted(dotDir) {
+  for (const listener of commitListeners) {
+    try {
+      listener(dotDir);
+    } catch {
+    }
+  }
+}
+function ensureBoardDirs(dotDir) {
+  let created = false;
+  for (const sub of BOARD_SUBDIRS) {
+    const dir = path2.join(dotDir, sub);
+    try {
+      fs2.mkdirSync(dir, { recursive: true });
+      const keep = path2.join(dir, ".gitkeep");
+      if (!fs2.existsSync(keep)) {
+        fs2.writeFileSync(keep, "", "utf-8");
+        created = true;
+      }
+    } catch {
+    }
+  }
+  return created;
+}
+function commitBoard(dotDir, options) {
+  if (!isTrackedBoard(dotDir)) return false;
+  ensureBoardDirs(dotDir);
+  if (unmergedFiles(dotDir).length > 0) return false;
+  if (!git(["add", "-A"], dotDir).ok) return false;
+  if (!boardIsDirty(dotDir)) return false;
+  const env = {};
+  const agent = options.agent ? sanitizeAgent(options.agent) : "";
+  if (agent) {
+    env.GIT_AUTHOR_NAME = agent;
+    env.GIT_AUTHOR_EMAIL = `${agent}@brainfile.local`;
+  }
+  const message = oneLine(options.message);
+  const r = git(
+    [...identityArgs(dotDir), "-c", "commit.gpgsign=false", "commit", "--quiet", "--no-verify", "-m", message],
+    dotDir,
+    env
+  );
+  if (r.ok) notifyCommitted(dotDir);
+  return r.ok;
+}
+function commitHandEdits(dotDir) {
+  if (!isTrackedBoard(dotDir)) return false;
+  const keepOnly = (f) => f.endsWith(".gitkeep") || BOARD_SUBDIRS.some((sub) => f === `${sub}/`);
+  if (ensureBoardDirs(dotDir) && boardDirtyFiles(dotDir).every(keepOnly)) {
+    commitBoard(dotDir, { message: "chore: keep board/ and logs/ in git" });
+  }
+  const files = boardDirtyFiles(dotDir);
+  if (files.length === 0) return false;
+  const summary = files.length <= 3 ? files.join(", ") : `${files.length} files`;
+  return commitBoard(dotDir, { message: `edit: ${summary}` });
+}
+function resolveAgentName(argv = process.argv) {
+  if (process.env.BRAINFILE_AGENT) return process.env.BRAINFILE_AGENT;
+  const flag = argv.indexOf("--agent");
+  if (flag >= 0 && argv[flag + 1] && !argv[flag + 1].startsWith("-")) return argv[flag + 1];
+  const inline = argv.find((a) => a.startsWith("--agent="));
+  return inline ? inline.slice("--agent=".length) : null;
+}
+function homeBoardDir() {
+  return path2.join(os.homedir(), ".brainfile");
+}
+function isGlobalBoardRequested(argv = process.argv) {
+  if (process.env.BRAINFILE_GLOBAL === "1") return true;
+  return argv.includes("-g") || argv.includes("--global");
+}
+function oneLine(message) {
+  const flat = message.replace(/\s+/g, " ").trim();
+  return flat.length > MAX_MESSAGE_LENGTH ? `${flat.slice(0, MAX_MESSAGE_LENGTH - 1)}\u2026` : flat;
+}
+function describeCommandForCommit(command) {
+  const names = [];
+  let cursor = command;
+  while (cursor && cursor.parent) {
+    names.unshift(cursor.name());
+    cursor = cursor.parent;
+  }
+  const opts = command.opts();
+  const idValue = opts.task ?? opts.taskId;
+  const id = Array.isArray(idValue) ? idValue.join(",") : typeof idValue === "string" ? idValue : "";
+  const positional = command.args.filter((a) => typeof a === "string" && a.length > 0);
+  const detail = [opts.title, opts.column, positional.join(" ")].find((v) => typeof v === "string" && v.length > 0) ?? "";
+  const head = `${names.join(" ")}${id ? ` ${id}` : ""}`;
+  return oneLine(detail ? `${head}: ${detail}` : head);
+}
+var pendingCommits = /* @__PURE__ */ new Map();
+var flushTimer = null;
+var exitHookInstalled = false;
+function scheduleBoardCommit(brainfilePath, message, delayMs = 2e3) {
+  const dotDir = path2.dirname(path2.resolve(brainfilePath));
+  if (!isTrackedBoard(dotDir)) return;
+  const entry = pendingCommits.get(dotDir) ?? { messages: [], agent: resolveAgentName() };
+  entry.messages.push(message);
+  pendingCommits.set(dotDir, entry);
+  if (flushTimer) clearTimeout(flushTimer);
+  flushTimer = setTimeout(flushBoardCommits, delayMs);
+  flushTimer.unref?.();
+  if (!exitHookInstalled) {
+    exitHookInstalled = true;
+    process.once("exit", flushBoardCommits);
+  }
+}
+function flushBoardCommits() {
+  if (flushTimer) {
+    clearTimeout(flushTimer);
+    flushTimer = null;
+  }
+  for (const [dotDir, entry] of pendingCommits) {
+    const [first, ...rest] = entry.messages;
+    const message = rest.length === 0 ? first : `${first} (+${rest.length} more)`;
+    commitBoard(dotDir, { message, agent: entry.agent });
+  }
+  pendingCommits.clear();
+}
+
 // src/utils/brainfile-path.ts
 function isMigrationCommand() {
   return process.argv.includes("migrate");
 }
 function migrationHintForPath2(brainfilePath) {
-  const absolute = path2.resolve(brainfilePath);
-  const dir = path2.basename(path2.dirname(absolute)) === ".brainfile" ? path2.dirname(path2.dirname(absolute)) : path2.dirname(absolute);
+  const absolute = path3.resolve(brainfilePath);
+  const dir = path3.basename(path3.dirname(absolute)) === ".brainfile" ? path3.dirname(path3.dirname(absolute)) : path3.dirname(absolute);
   return `Run: brainfile migrate --dir ${dir}`;
 }
 function rejectLegacyRuntimePath(resolvedPath) {
-  if (!isMigrationCommand() && fs2.existsSync(resolvedPath) && !(0, import_core3.isV2)(resolvedPath)) {
+  if (!isMigrationCommand() && fs3.existsSync(resolvedPath) && !(0, import_core3.isV2)(resolvedPath)) {
     throw new CLIError(V1_UNSUPPORTED_MESSAGE, void 0, migrationHintForPath2(resolvedPath));
   }
   return resolvedPath;
 }
+function isPlaceholder(filePath) {
+  return filePath === void 0 || filePath === import_core3.BRAINFILE_BASENAME || filePath === `./${import_core3.BRAINFILE_BASENAME}`;
+}
 function resolveCliBrainfilePath(filePath) {
+  if (isPlaceholder(filePath) && isGlobalBoardRequested()) {
+    return rejectLegacyRuntimePath(path3.join(homeBoardDir(), import_core3.BRAINFILE_BASENAME));
+  }
   if (filePath) {
-    const resolved = path2.resolve(process.cwd(), filePath);
+    const resolved = path3.resolve(process.cwd(), filePath);
     try {
-      if (fs2.statSync(resolved).isDirectory()) {
+      if (fs3.statSync(resolved).isDirectory()) {
         const found = (0, import_core3.findBrainfile)(resolved);
         if (found && found.projectRoot === resolved) {
           return rejectLegacyRuntimePath(found.absolutePath);
         }
-        const dotDir = path2.join(resolved, ".brainfile", "brainfile.md");
+        const dotDir = path3.join(resolved, ".brainfile", "brainfile.md");
         return rejectLegacyRuntimePath(dotDir);
       }
     } catch {
     }
   }
-  return rejectLegacyRuntimePath((0, import_core3.resolveBrainfilePath)({ filePath, startDir: process.cwd() }));
+  const cwd = process.cwd();
+  if (isPlaceholder(filePath)) {
+    const found = (0, import_core3.findBrainfile)(cwd, { stopAtGitRoot: true });
+    if (found) return rejectLegacyRuntimePath(found.absolutePath);
+    const tracked = findTrackedBoardDir(cwd) ?? materializeBoardWorktree(cwd);
+    if (tracked) return rejectLegacyRuntimePath(path3.join(tracked, import_core3.BRAINFILE_BASENAME));
+  }
+  return rejectLegacyRuntimePath((0, import_core3.resolveBrainfilePath)({ filePath, startDir: cwd, stopAtGitRoot: true }));
+}
+function tryResolveBoardDir(filePath) {
+  try {
+    const resolved = resolveCliBrainfilePath(filePath);
+    if (!fs3.existsSync(resolved)) return null;
+    return path3.dirname(resolved);
+  } catch {
+    return null;
+  }
 }
 
 // src/utils/v2-detect.ts
 var import_core4 = __toESM(require_dist());
 var import_core5 = __toESM(require_dist());
 var import_core6 = __toESM(require_dist());
-import * as fs4 from "fs";
-import * as path4 from "path";
+import * as fs5 from "fs";
+import * as path5 from "path";
 
 // src/utils/workspace-format.ts
-import * as fs3 from "fs";
-import * as path3 from "path";
+import * as fs4 from "fs";
+import * as path4 from "path";
 function existsFile(filePath) {
   try {
-    return fs3.statSync(filePath).isFile();
+    return fs4.statSync(filePath).isFile();
   } catch {
     return false;
   }
 }
 function existsDir(dirPath) {
   try {
-    return fs3.statSync(dirPath).isDirectory();
+    return fs4.statSync(dirPath).isDirectory();
   } catch {
     return false;
   }
 }
 function workspaceRootFromBrainfilePath(brainfilePath) {
-  const absolute = path3.resolve(brainfilePath);
-  const dir = path3.dirname(absolute);
-  return path3.basename(dir) === ".brainfile" ? path3.dirname(dir) : dir;
+  const absolute = path4.resolve(brainfilePath);
+  const dir = path4.dirname(absolute);
+  return path4.basename(dir) === ".brainfile" ? path4.dirname(dir) : dir;
 }
 function probeWorkspaceFormat(rootDir = process.cwd()) {
-  const resolvedRoot = path3.resolve(rootDir);
-  const dotDir = path3.join(resolvedRoot, ".brainfile");
+  const resolvedRoot = path4.resolve(rootDir);
+  const dotDir = path4.join(resolvedRoot, ".brainfile");
   const paths = {
     rootDir: resolvedRoot,
-    rootBrainfilePath: path3.join(resolvedRoot, "brainfile.md"),
+    rootBrainfilePath: path4.join(resolvedRoot, "brainfile.md"),
     dotDir,
-    dotBrainfilePath: path3.join(dotDir, "brainfile.md"),
-    boardDir: path3.join(dotDir, "board"),
-    logsDir: path3.join(dotDir, "logs")
+    dotBrainfilePath: path4.join(dotDir, "brainfile.md"),
+    boardDir: path4.join(dotDir, "board"),
+    logsDir: path4.join(dotDir, "logs")
   };
   const presence = {
     rootBrainfile: existsFile(paths.rootBrainfilePath),
@@ -11232,15 +11984,15 @@ function shouldSuggestMigration(probe) {
 // src/utils/v2-detect.ts
 var v2MigrationHintShown = /* @__PURE__ */ new Set();
 function shouldSuggestV2Migration(brainfilePath) {
-  const resolved = path4.resolve(brainfilePath);
+  const resolved = path5.resolve(brainfilePath);
   if (v2MigrationHintShown.has(resolved)) return false;
   const probe = probeWorkspaceForBrainfile(resolved);
   if (shouldSuggestMigration(probe)) {
     return true;
   }
-  if (!(0, import_core6.isV2)(resolved) && fs4.existsSync(resolved)) {
+  if (!(0, import_core6.isV2)(resolved) && fs5.existsSync(resolved)) {
     try {
-      const content = fs4.readFileSync(resolved, "utf-8");
+      const content = fs5.readFileSync(resolved, "utf-8");
       const parsed = import_core4.Brainfile.parseWithErrors(content);
       if (parsed.board) return true;
     } catch {
@@ -11249,42 +12001,568 @@ function shouldSuggestV2Migration(brainfilePath) {
   return false;
 }
 function markV2MigrationHintShown(brainfilePath) {
-  v2MigrationHintShown.add(path4.resolve(brainfilePath));
+  v2MigrationHintShown.add(path5.resolve(brainfilePath));
+}
+
+// src/commands/merge-driver.ts
+var import_core7 = __toESM(require_dist());
+import * as fs6 from "fs";
+import * as os2 from "os";
+import * as path6 from "path";
+import { spawnSync as spawnSync2 } from "child_process";
+function parseDoc(content) {
+  const parsed = (0, import_core7.parseFrontmatter)(content);
+  if (!parsed) return null;
+  return { data: parsed.data, body: parsed.body };
+}
+function same(a, b) {
+  return JSON.stringify(a ?? null) === JSON.stringify(b ?? null);
+}
+function stamp(data) {
+  const value = data.updatedAt;
+  return typeof value === "string" ? value : "";
+}
+function mergeFields(base, ours, theirs) {
+  const keys = [];
+  for (const key of [...Object.keys(ours), ...Object.keys(theirs), ...Object.keys(base)]) {
+    if (!keys.includes(key)) keys.push(key);
+  }
+  const oursWins = stamp(ours) > stamp(theirs);
+  const out = {};
+  for (const key of keys) {
+    const b = base[key];
+    const o = ours[key];
+    const t = theirs[key];
+    let pick;
+    if (same(o, t)) pick = o;
+    else if (same(b, o)) pick = t;
+    else if (same(b, t)) pick = o;
+    else if (key === "updatedAt") pick = String(o ?? "") > String(t ?? "") ? o : t;
+    else pick = oursWins ? o : t;
+    if (pick !== void 0) out[key] = pick;
+  }
+  return out;
+}
+var CONFLICT = /^<{7}[^\n]*\n([\s\S]*?)^={7}\n([\s\S]*?)^>{7}[^\n]*\n?/gm;
+var LIST_ITEM = /^\s*[-*]\s+/;
+var LEADING_STAMP = /^\s*[-*]\s+(\d{4}-\d{2}-\d{2}T[0-9:.]+Z?)\b/;
+function unionLists(ours, theirs) {
+  const a = ours.split("\n").filter((l) => l.trim().length > 0);
+  const b = theirs.split("\n").filter((l) => l.trim().length > 0);
+  if (![...a, ...b].every((l) => LIST_ITEM.test(l))) return null;
+  const merged = [...a];
+  for (const line of b) if (!merged.includes(line)) merged.push(line);
+  if (merged.every((l) => LEADING_STAMP.test(l))) {
+    merged.sort((x, y) => {
+      const sx = LEADING_STAMP.exec(x)?.[1] ?? "";
+      const sy = LEADING_STAMP.exec(y)?.[1] ?? "";
+      return sx < sy ? -1 : sx > sy ? 1 : 0;
+    });
+  }
+  return `${merged.join("\n")}
+`;
+}
+function mergeBodies(base, ours, theirs) {
+  if (ours === theirs) return { content: ours, clean: true };
+  if (base === ours) return { content: theirs, clean: true };
+  if (base === theirs) return { content: ours, clean: true };
+  const dir = fs6.mkdtempSync(path6.join(os2.tmpdir(), "brainfile-merge-"));
+  try {
+    const files = { base: path6.join(dir, "base"), ours: path6.join(dir, "ours"), theirs: path6.join(dir, "theirs") };
+    fs6.writeFileSync(files.base, base);
+    fs6.writeFileSync(files.ours, ours);
+    fs6.writeFileSync(files.theirs, theirs);
+    const r = spawnSync2("git", ["merge-file", "-p", "-L", "ours", "-L", "base", "-L", "theirs", files.ours, files.base, files.theirs], {
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    if (r.status === null || r.status < 0) {
+      return { content: `<<<<<<< ours
+${ours}=======
+${theirs}>>>>>>> theirs
+`, clean: false };
+    }
+    if (r.status === 0) return { content: r.stdout, clean: true };
+    let clean = true;
+    const content = r.stdout.replace(CONFLICT, (whole, oursHunk, theirsHunk) => {
+      const union = unionLists(oursHunk, theirsHunk);
+      if (union === null) {
+        clean = false;
+        return whole;
+      }
+      return union;
+    });
+    return { content, clean };
+  } finally {
+    fs6.rmSync(dir, { recursive: true, force: true });
+  }
+}
+function mergeBoardDocuments(base, ours, theirs) {
+  const b = parseDoc(base);
+  const o = parseDoc(ours);
+  const t = parseDoc(theirs);
+  if (!o || !t) return mergeBodies(base, ours, theirs);
+  const data = mergeFields(b?.data ?? {}, o.data, t.data);
+  const body = mergeBodies(b?.body ?? "", o.body, t.body);
+  return { content: (0, import_core7.serializeFrontmatter)(data, body.content), clean: body.clean };
+}
+function summarizeFieldChanges(before, after) {
+  const b = parseDoc(before)?.data ?? {};
+  const a = parseDoc(after)?.data ?? {};
+  const parts = [];
+  for (const key of Object.keys(a)) {
+    if (key === "updatedAt" || same(b[key], a[key])) continue;
+    const render = (v) => typeof v === "string" ? v : JSON.stringify(v);
+    parts.push(`${key}: ${b[key] === void 0 ? "\u2205" : render(b[key])} \u2192 ${render(a[key])}`);
+  }
+  return parts.join("; ");
+}
+function mergeDriverCommand(options) {
+  const read = (p) => fs6.existsSync(p) ? fs6.readFileSync(p, "utf-8") : "";
+  if (!options.ours || !options.theirs) return 2;
+  const outcome = mergeBoardDocuments(read(options.base), read(options.ours), read(options.theirs));
+  fs6.writeFileSync(options.ours, outcome.content, "utf-8");
+  return outcome.clean ? 0 : 1;
+}
+
+// src/utils/board-sync.ts
+import * as fs7 from "fs";
+import * as os3 from "os";
+import * as path7 from "path";
+var REMOTE_CONFIG_KEY = "brainfile.remote";
+var REMOTE_BRANCH_CONFIG_KEY = "brainfile.remoteBranch";
+var AUTOSYNC_CONFIG_KEY = "brainfile.autosync";
+var URL_REMOTE_NAME = "board";
+var MERGE_DRIVER_NAME = "brainfile";
+var DEFAULT_MERGE_DRIVER_COMMAND = "brainfile merge-driver %O %A %B";
+var SYNC_STATE_FILE = path7.join("state", "sync.json");
+var BOARD_GITATTRIBUTES = [
+  "logs/ledger.jsonl merge=union",
+  "board/*.md merge=brainfile",
+  "logs/*.md merge=brainfile",
+  "brainfile.md merge=brainfile"
+];
+function configGet(dotDir, key) {
+  const r = git(["config", "--get", key], dotDir);
+  return r.ok && r.stdout ? r.stdout : null;
+}
+function configSet(dotDir, key, value) {
+  return git(["config", key, value], dotDir).ok;
+}
+function boardRemote(dotDir) {
+  return configGet(dotDir, REMOTE_CONFIG_KEY);
+}
+function boardRemoteBranch(dotDir) {
+  const configured = configGet(dotDir, REMOTE_BRANCH_CONFIG_KEY);
+  if (configured) return configured;
+  if (path7.resolve(dotDir) === path7.resolve(homeBoardDir())) return "home";
+  if (boardRepoKind(dotDir) === "standalone" && path7.basename(path7.resolve(dotDir)) === ".brainfile") {
+    return path7.basename(path7.dirname(path7.resolve(dotDir))) || boardBranch(dotDir);
+  }
+  return boardBranch(dotDir);
+}
+function boardAutosync(dotDir) {
+  const value = configGet(dotDir, AUTOSYNC_CONFIG_KEY);
+  if (value === "off" || value === "push" || value === "full") return value;
+  return boardRemote(dotDir) ? "push" : "off";
+}
+function setBoardAutosync(dotDir, mode) {
+  return configSet(dotDir, AUTOSYNC_CONFIG_KEY, mode);
+}
+function looksLikeRemoteUrl(target) {
+  if (/^[a-z][a-z0-9+.-]*:\/\//i.test(target)) return true;
+  if (/^[^/\s]+@[^/\s]+:/.test(target)) return true;
+  if (target.startsWith("/") || target.startsWith(".") || target.startsWith("~")) return true;
+  if (target.includes("/") && fs7.existsSync(target)) return true;
+  return false;
+}
+function setBoardRemote(cwd, target, remoteBranch) {
+  const trimmed = target.trim();
+  if (!trimmed) throw new Error("remote is required");
+  let remote;
+  if (looksLikeRemoteUrl(trimmed)) {
+    remote = URL_REMOTE_NAME;
+    const url = trimmed.startsWith("~/") ? path7.join(os3.homedir(), trimmed.slice(2)) : trimmed;
+    const exists = git(["remote", "get-url", remote], cwd).ok;
+    const r = exists ? git(["remote", "set-url", remote, url], cwd) : git(["remote", "add", remote, url], cwd);
+    if (!r.ok) throw new Error(r.stderr || `could not register remote '${remote}'`);
+  } else {
+    remote = trimmed;
+    if (!git(["remote", "get-url", remote], cwd).ok) {
+      const known = git(["remote"], cwd).stdout.split("\n").filter(Boolean);
+      const hint = known.length ? ` Known remotes: ${known.join(", ")}.` : "";
+      throw new Error(`'${remote}' is not a git remote here.${hint} Pass a URL to add one.`);
+    }
+  }
+  configSet(cwd, REMOTE_CONFIG_KEY, remote);
+  if (remoteBranch) configSet(cwd, REMOTE_BRANCH_CONFIG_KEY, remoteBranch);
+  registerMergeDriver(cwd);
+  return {
+    remote,
+    url: git(["remote", "get-url", remote], cwd).stdout || null,
+    remoteBranch: remoteBranch ?? boardRemoteBranch(cwd)
+  };
+}
+function registerMergeDriver(cwd, command) {
+  const current = configGet(cwd, `merge.${MERGE_DRIVER_NAME}.driver`);
+  if (command === void 0) {
+    if (current) return false;
+    command = DEFAULT_MERGE_DRIVER_COMMAND;
+  }
+  if (current === command) return false;
+  configSet(cwd, `merge.${MERGE_DRIVER_NAME}.name`, "brainfile board merge (field-level, last writer wins)");
+  return configSet(cwd, `merge.${MERGE_DRIVER_NAME}.driver`, command);
+}
+function ensureBoardAttributes(dotDir) {
+  const file = path7.join(dotDir, ".gitattributes");
+  let existing = "";
+  try {
+    existing = fs7.readFileSync(file, "utf-8");
+  } catch {
+  }
+  const lines = existing.split("\n").map((l) => l.trim());
+  const missing = BOARD_GITATTRIBUTES.filter((l) => !lines.includes(l));
+  if (missing.length === 0) return false;
+  const prefix = existing.length > 0 && !existing.endsWith("\n") ? `${existing}
+` : existing;
+  fs7.writeFileSync(file, `${prefix}${missing.join("\n")}
+`, "utf-8");
+  return true;
+}
+function readSyncState(dotDir) {
+  try {
+    const parsed = JSON.parse(fs7.readFileSync(path7.join(dotDir, SYNC_STATE_FILE), "utf-8"));
+    return typeof parsed?.at === "string" ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function writeSyncState(dotDir, state) {
+  try {
+    fs7.mkdirSync(path7.join(dotDir, "state"), { recursive: true });
+    fs7.writeFileSync(path7.join(dotDir, SYNC_STATE_FILE), `${JSON.stringify(state, null, 2)}
+`, "utf-8");
+  } catch {
+  }
+}
+function firstLine(text) {
+  return text.split("\n").map((l) => l.trim()).find(Boolean) ?? "";
+}
+function isMissingRemoteRef(stderr) {
+  return /couldn't find remote ref|Remote branch .* not found|invalid refspec|no such ref/i.test(stderr);
+}
+function commitCount(dotDir, range) {
+  const r = git(["rev-list", "--count", range], dotDir);
+  return r.ok ? Number.parseInt(r.stdout, 10) || 0 : 0;
+}
+function identity(dotDir, agent) {
+  const args = ["-c", "commit.gpgsign=false"];
+  if (!git(["config", "--get", "user.email"], dotDir).ok) {
+    args.push("-c", "user.name=brainfile", "-c", "user.email=brainfile@localhost");
+  }
+  const env = {};
+  const name = agent?.replace(/[\r\n<>]/g, "").trim();
+  if (name) {
+    env.GIT_AUTHOR_NAME = name;
+    env.GIT_AUTHOR_EMAIL = `${name}@brainfile.local`;
+  }
+  return { args, env };
+}
+function resolveCompleteVersusEdit(dotDir) {
+  const status = git(["status", "--porcelain", "-z"], dotDir);
+  if (!status.ok) return [];
+  const resolved = [];
+  for (const entry of status.stdout.split("\0")) {
+    if (entry.length < 4) continue;
+    const xy = entry.slice(0, 2);
+    const file = entry.slice(3);
+    if (xy !== "DU" && xy !== "UD") continue;
+    if (!file.startsWith("board/")) continue;
+    const editedStage = xy === "DU" ? 3 : 2;
+    const base = git(["show", `:1:${file}`], dotDir);
+    const edited = git(["show", `:${editedStage}:${file}`], dotDir);
+    const archived = path7.join(dotDir, "logs", path7.basename(file));
+    if (edited.ok && fs7.existsSync(archived)) {
+      const summary = summarizeFieldChanges(base.ok ? base.stdout : "", edited.stdout);
+      const entryLine = `- ${(/* @__PURE__ */ new Date()).toISOString()}: [sync] edited elsewhere after completion${summary ? ` (${summary})` : ""}`;
+      let content = fs7.readFileSync(archived, "utf-8");
+      if (/^## Log\s*$/m.test(content)) {
+        content = `${content.replace(/\s+$/, "")}
+${entryLine}
+`;
+      } else {
+        content = `${content.replace(/\s+$/, "")}
+
+## Log
+${entryLine}
+`;
+      }
+      fs7.writeFileSync(archived, content, "utf-8");
+      git(["add", "--", path7.relative(dotDir, archived)], dotDir);
+    }
+    if (git(["rm", "--quiet", "--cached", "--", file], dotDir).ok) {
+      try {
+        fs7.rmSync(path7.join(dotDir, file), { force: true });
+      } catch {
+      }
+      resolved.push(file);
+    }
+  }
+  return resolved;
+}
+function syncBoard(dotDir, options = {}) {
+  const pull = options.pull ?? true;
+  const push = options.push ?? true;
+  const result = { ok: true, pulled: 0, pushed: 0, conflicts: [] };
+  if (!isTrackedBoard(dotDir)) return { ...result, skipped: "not-tracked" };
+  const remote = boardRemote(dotDir);
+  if (!remote) return { ...result, skipped: "no-remote" };
+  const remoteBranch = boardRemoteBranch(dotDir);
+  result.remote = remote;
+  result.remoteBranch = remoteBranch;
+  const stuck = unmergedFiles(dotDir);
+  if (stuck.length > 0) {
+    return finish(dotDir, { ...result, ok: false, failure: "conflict", conflicts: stuck, warning: `unresolved conflicts: ${stuck.join(", ")}` });
+  }
+  commitHandEdits(dotDir);
+  if (ensureBoardAttributes(dotDir)) commitBoard(dotDir, { message: "chore: merge attributes" });
+  registerMergeDriver(dotDir);
+  let fetched = false;
+  if (pull) {
+    const fetch2 = git(["fetch", "--quiet", remote, remoteBranch], dotDir);
+    if (fetch2.ok) {
+      fetched = true;
+    } else if (!isMissingRemoteRef(fetch2.stderr)) {
+      return finish(dotDir, { ...result, ok: false, failure: "offline", warning: `fetch from ${remote} failed: ${firstLine(fetch2.stderr)}` });
+    }
+    if (fetched && !git(["merge-base", "--is-ancestor", "FETCH_HEAD", "HEAD"], dotDir).ok) {
+      const before = git(["rev-parse", "HEAD"], dotDir).stdout;
+      const id = identity(dotDir, options.agent);
+      const merge = git([...id.args, "merge", "--quiet", "--no-edit", "FETCH_HEAD"], dotDir, id.env);
+      if (!merge.ok) {
+        resolveCompleteVersusEdit(dotDir);
+        const remaining = unmergedFiles(dotDir);
+        if (remaining.length > 0) {
+          return finish(dotDir, {
+            ...result,
+            ok: false,
+            failure: "conflict",
+            conflicts: remaining,
+            warning: `merge left conflicts in ${remaining.join(", ")} \u2014 resolve them in ${dotDir}, then run sync again`
+          });
+        }
+        const commit = git([...id.args, "commit", "--quiet", "--no-edit", "--no-verify"], dotDir, id.env);
+        if (!commit.ok) {
+          return finish(dotDir, { ...result, ok: false, failure: "error", warning: `merge commit failed: ${firstLine(commit.stderr)}` });
+        }
+      }
+      result.pulled = commitCount(dotDir, `${before}..FETCH_HEAD`);
+    }
+  }
+  if (push) {
+    const ahead = fetched ? commitCount(dotDir, "FETCH_HEAD..HEAD") : pendingChanges(dotDir);
+    if (ahead > 0) {
+      const pushed = git(["push", "--quiet", remote, `HEAD:refs/heads/${remoteBranch}`], dotDir);
+      if (!pushed.ok) {
+        const rejected = /rejected|non-fast-forward|fetch first/i.test(pushed.stderr);
+        return finish(dotDir, {
+          ...result,
+          ok: false,
+          failure: rejected ? "rejected" : "offline",
+          warning: rejected ? `push to ${remote} rejected (the remote moved) \u2014 run sync again` : `push to ${remote} failed: ${firstLine(pushed.stderr)}`
+        });
+      }
+      result.pushed = ahead;
+    }
+  }
+  return finish(dotDir, result);
+}
+function finish(dotDir, result) {
+  writeSyncState(dotDir, {
+    at: (/* @__PURE__ */ new Date()).toISOString(),
+    remote: result.remote ?? "",
+    remoteBranch: result.remoteBranch ?? "",
+    ok: result.ok,
+    ...result.warning ? { warning: result.warning } : {}
+  });
+  return result;
+}
+function secondsSinceSync(dotDir, now = Date.now()) {
+  const state = readSyncState(dotDir);
+  if (!state) return null;
+  const at = Date.parse(state.at);
+  return Number.isNaN(at) ? null : Math.max(0, Math.round((now - at) / 1e3));
+}
+function syncStatusLabel(dotDir, now = Date.now()) {
+  if (!isTrackedBoard(dotDir)) return null;
+  if (!boardRemote(dotDir)) return "local only";
+  const state = readSyncState(dotDir);
+  if (!state) return "not synced yet";
+  if (!state.ok) return "not synced \xB7 saved locally";
+  const seconds = secondsSinceSync(dotDir, now) ?? 0;
+  const age = seconds < 60 ? `${seconds}s` : seconds < 3600 ? `${Math.round(seconds / 60)}m` : `${Math.round(seconds / 3600)}h`;
+  return `synced ${age} ago`;
+}
+function pendingChanges(dotDir) {
+  const remote = boardRemote(dotDir);
+  if (!remote) return 0;
+  const tracking = `refs/remotes/${remote}/${boardRemoteBranch(dotDir)}`;
+  const known = git(["rev-parse", "--verify", "--quiet", tracking], dotDir).ok;
+  return commitCount(dotDir, known ? `${tracking}..HEAD` : "HEAD");
+}
+var plural = (n, word) => `${n} ${word}${n === 1 ? "" : "s"}`;
+function syncMessage(result) {
+  if (result.skipped === "not-tracked") {
+    return { tone: "warn", text: "This board is plain files on this machine and is not shared. To share it: brainfile migrate --to-branch" };
+  }
+  if (result.skipped === "no-remote") {
+    return { tone: "warn", text: "This board is only on this machine. To share it: brainfile sync --set-remote origin" };
+  }
+  const remote = result.remote ?? "the remote";
+  if (!result.ok) {
+    switch (result.failure) {
+      case "conflict":
+        return {
+          tone: "warn",
+          text: `Two edits collided in ${result.conflicts.join(", ")}. Open the file in .brainfile/, keep the right version, then run brainfile sync. Nothing else is shared until then.`
+        };
+      case "rejected":
+        return { tone: "warn", text: `Someone shared changes through ${remote} at the same moment. Run brainfile sync again to combine them. Nothing was lost.` };
+      case "offline":
+        return {
+          tone: "warn",
+          text: `Couldn't reach ${remote}. Nothing was lost: your changes are saved on this machine and will be sent on the next sync.`,
+          detail: result.warning
+        };
+      default:
+        return { tone: "warn", text: `Sync with ${remote} stopped. Your changes are saved on this machine.`, detail: result.warning };
+    }
+  }
+  const parts = [];
+  if (result.pulled > 0) parts.push(`received ${plural(result.pulled, "change")}`);
+  if (result.pushed > 0) parts.push(`sent ${plural(result.pushed, "change")}`);
+  return { tone: "ok", text: parts.length ? `Shared through ${remote}: ${parts.join(", ")}.` : `Up to date with ${remote}.` };
+}
+
+// src/utils/board-autosync.ts
+import * as fs8 from "fs";
+import * as path8 from "path";
+import { spawn } from "child_process";
+var AUTOSYNC_DELAY_MS = 5e3;
+var FETCH_MAX_AGE_SECONDS = 60;
+var LOCK_FILE = path8.join("state", "autosync.lock");
+var LOCK_STALE_MS = 6e4;
+function effectiveAutosync(dotDir) {
+  const override = process.env.BRAINFILE_AUTOSYNC;
+  if (override === "off" || override === "push" || override === "full") return override;
+  return boardAutosync(dotDir);
+}
+function autosyncCliPath() {
+  const candidates = [
+    path8.join(__dirname, "cli.js"),
+    path8.join(__dirname, "..", "cli.js"),
+    path8.join(__dirname, "..", "..", "dist", "cli.js")
+  ];
+  return candidates.find((p) => fs8.existsSync(p)) ?? null;
+}
+function pidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function pushPending(dotDir) {
+  const lock = path8.join(dotDir, LOCK_FILE);
+  try {
+    const st = fs8.statSync(lock);
+    if (Date.now() - st.mtimeMs > LOCK_STALE_MS) return false;
+    const pid = Number.parseInt(fs8.readFileSync(lock, "utf-8"), 10);
+    return Number.isFinite(pid) && pidAlive(pid);
+  } catch {
+    return false;
+  }
+}
+function clearPushLock(dotDir) {
+  try {
+    fs8.rmSync(path8.join(dotDir, LOCK_FILE), { force: true });
+  } catch {
+  }
+}
+function schedulePush(dotDir, delayMs = AUTOSYNC_DELAY_MS) {
+  if (!isTrackedBoard(dotDir)) return false;
+  const mode = effectiveAutosync(dotDir);
+  if (mode === "off" || !boardRemote(dotDir)) return false;
+  if (pushPending(dotDir)) return false;
+  const cli = autosyncCliPath();
+  if (!cli) return false;
+  const delay = process.env.BRAINFILE_AUTOSYNC_DELAY_MS ? Number(process.env.BRAINFILE_AUTOSYNC_DELAY_MS) : delayMs;
+  try {
+    const child = spawn(
+      process.execPath,
+      [cli, "sync", "--push", "--file", path8.join(dotDir, "brainfile.md"), "--wait", String(delay)],
+      { cwd: dotDir, detached: true, stdio: "ignore", env: { ...process.env, BRAINFILE_AUTOSYNC: "off" } }
+    );
+    child.unref();
+    if (child.pid) {
+      fs8.mkdirSync(path8.join(dotDir, "state"), { recursive: true });
+      fs8.writeFileSync(path8.join(dotDir, LOCK_FILE), String(child.pid), "utf-8");
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+function fetchBeforeRead(dotDir, maxAgeSeconds = FETCH_MAX_AGE_SECONDS) {
+  if (!isTrackedBoard(dotDir)) return null;
+  if (effectiveAutosync(dotDir) !== "full") return null;
+  const age = secondsSinceSync(dotDir);
+  if (age !== null && age < maxAgeSeconds) return null;
+  return syncBoard(dotDir, { pull: true, push: false });
+}
+var installed = false;
+function installAutosync() {
+  if (installed) return;
+  installed = true;
+  onBoardCommitted((dotDir) => {
+    schedulePush(dotDir);
+  });
 }
 
 // src/utils/config.ts
-import * as fs5 from "fs";
-import * as path5 from "path";
-import * as os from "os";
+import * as fs9 from "fs";
+import * as path9 from "path";
+import * as os4 from "os";
 function resolveHomeDir() {
   const envHome = process.env.XDG_CONFIG_HOME?.trim();
   if (envHome) {
     return envHome;
   }
   const home = process.env.HOME?.trim();
-  return home || os.homedir();
+  return home || os4.homedir();
 }
 function getConfigDir() {
   const xdgConfigHome = process.env.XDG_CONFIG_HOME?.trim();
   if (xdgConfigHome) {
-    return path5.join(xdgConfigHome, "brainfile");
+    return path9.join(xdgConfigHome, "brainfile");
   }
-  return path5.join(resolveHomeDir(), ".config", "brainfile");
+  return path9.join(resolveHomeDir(), ".config", "brainfile");
 }
 function getConfigPath() {
-  return path5.join(getConfigDir(), "config.json");
+  return path9.join(getConfigDir(), "config.json");
 }
 function ensureConfigDir() {
   const configDir = getConfigDir();
-  if (!fs5.existsSync(configDir)) {
-    fs5.mkdirSync(configDir, { recursive: true, mode: 448 });
+  if (!fs9.existsSync(configDir)) {
+    fs9.mkdirSync(configDir, { recursive: true, mode: 448 });
   }
 }
 function loadConfig() {
   const configFile = getConfigPath();
   try {
-    if (fs5.existsSync(configFile)) {
-      const content = fs5.readFileSync(configFile, "utf-8");
+    if (fs9.existsSync(configFile)) {
+      const content = fs9.readFileSync(configFile, "utf-8");
       return JSON.parse(content);
     }
   } catch (error) {
@@ -11295,7 +12573,7 @@ function loadConfig() {
 function saveConfig(config) {
   const configFile = getConfigPath();
   ensureConfigDir();
-  fs5.writeFileSync(configFile, JSON.stringify(config, null, 2), {
+  fs9.writeFileSync(configFile, JSON.stringify(config, null, 2), {
     encoding: "utf-8",
     mode: 384
     // Owner read/write only
@@ -11370,11 +12648,11 @@ function isValidDestination(dest) {
 }
 
 // src/utils/auth-store.ts
-import * as fs6 from "fs";
-import * as path6 from "path";
+import * as fs10 from "fs";
+import * as path10 from "path";
 import { execSync } from "child_process";
 var SERVICE_NAME = "brainfile";
-var AUTH_FILE = path6.join(getConfigDir(), "auth.json");
+var AUTH_FILE = path10.join(getConfigDir(), "auth.json");
 var ENV_VAR_MAP = {
   github: ["GITHUB_TOKEN", "GH_TOKEN"],
   linear: ["LINEAR_API_KEY", "LINEAR_TOKEN"]
@@ -11544,8 +12822,8 @@ var AuthStore = class {
   }
   loadAuthFile() {
     try {
-      if (fs6.existsSync(AUTH_FILE)) {
-        const content = fs6.readFileSync(AUTH_FILE, "utf-8");
+      if (fs10.existsSync(AUTH_FILE)) {
+        const content = fs10.readFileSync(AUTH_FILE, "utf-8");
         return JSON.parse(content);
       }
     } catch {
@@ -11554,7 +12832,7 @@ var AuthStore = class {
   }
   saveAuthFile(data) {
     ensureConfigDir();
-    fs6.writeFileSync(AUTH_FILE, JSON.stringify(data, null, 2), {
+    fs10.writeFileSync(AUTH_FILE, JSON.stringify(data, null, 2), {
       encoding: "utf-8",
       mode: 384
       // Owner read/write only
@@ -11578,7 +12856,7 @@ var AuthStore = class {
 var authStore = new AuthStore();
 
 // src/utils/github-auth.ts
-var import_chalk2 = __toESM(require_source());
+var import_chalk3 = __toESM(require_source());
 var GITHUB_CLIENT_ID = process.env.BRAINFILE_GITHUB_CLIENT_ID || "Ov23liYourClientId";
 var GITHUB_DEVICE_CODE_URL = "https://github.com/login/device/code";
 var GITHUB_TOKEN_URL = "https://github.com/login/oauth/access_token";
@@ -11601,13 +12879,13 @@ async function authenticateGitHub(options) {
     const ghToken = getGitHubCLIToken();
     if (ghToken) {
       if (!silent) {
-        console.log(import_chalk2.default.green("\u2713") + " Found existing GitHub CLI authentication");
+        console.log(import_chalk3.default.green("\u2713") + " Found existing GitHub CLI authentication");
       }
       const user = await getGitHubUser(ghToken);
       if (user) {
         await authStore.set("github", ghToken, { username: user.login });
         if (!silent) {
-          console.log(import_chalk2.default.green("\u2713") + ` Authenticated as ${import_chalk2.default.cyan("@" + user.login)}`);
+          console.log(import_chalk3.default.green("\u2713") + ` Authenticated as ${import_chalk3.default.cyan("@" + user.login)}`);
         }
         return { success: true, username: user.login };
       }
@@ -11622,8 +12900,8 @@ async function verifyAndStoreToken(token, silent) {
   }
   await authStore.set("github", token, { username: user.login });
   if (!silent) {
-    console.log(import_chalk2.default.green("\u2713") + " Token verified");
-    console.log(import_chalk2.default.green("\u2713") + ` Authenticated as ${import_chalk2.default.cyan("@" + user.login)}`);
+    console.log(import_chalk3.default.green("\u2713") + " Token verified");
+    console.log(import_chalk3.default.green("\u2713") + ` Authenticated as ${import_chalk3.default.cyan("@" + user.login)}`);
   }
   return { success: true, username: user.login };
 }
@@ -11636,16 +12914,16 @@ async function deviceFlowAuth(silent) {
   try {
     const deviceCode = await requestDeviceCode();
     if (!silent) {
-      console.log(import_chalk2.default.yellow("!") + ` First, copy your one-time code: ${import_chalk2.default.bold.cyan(deviceCode.user_code)}`);
+      console.log(import_chalk3.default.yellow("!") + ` First, copy your one-time code: ${import_chalk3.default.bold.cyan(deviceCode.user_code)}`);
       console.log("");
-      console.log(`Then visit: ${import_chalk2.default.underline(deviceCode.verification_uri)}`);
+      console.log(`Then visit: ${import_chalk3.default.underline(deviceCode.verification_uri)}`);
       console.log("");
     }
     try {
       const open = await import("./open-ZGSQIGEH.mjs");
       await open.default(deviceCode.verification_uri);
       if (!silent) {
-        console.log(import_chalk2.default.gray("(Opening browser...)"));
+        console.log(import_chalk3.default.gray("(Opening browser...)"));
       }
     } catch {
     }
@@ -11802,11 +13080,11 @@ async function logoutGitHub() {
   await authStore.clear("github");
 }
 function sleep(ms) {
-  return new Promise((resolve5) => setTimeout(resolve5, ms));
+  return new Promise((resolve7) => setTimeout(resolve7, ms));
 }
 
 // src/utils/linear-auth.ts
-var import_chalk3 = __toESM(require_source());
+var import_chalk4 = __toESM(require_source());
 var LINEAR_API_URL = "https://api.linear.app/graphql";
 async function isLinearAuthenticated() {
   return await authStore.isAuthenticated("linear");
@@ -11821,7 +13099,7 @@ async function authenticateLinear(options) {
       console.log("");
       console.log("To authenticate with Linear, you need an API key.");
       console.log("");
-      console.log(`Get your API key from: ${import_chalk3.default.underline("https://linear.app/settings/api")}`);
+      console.log(`Get your API key from: ${import_chalk4.default.underline("https://linear.app/settings/api")}`);
       console.log("");
     }
     return { success: false, error: "Linear API key required. Use --token flag." };
@@ -11837,8 +13115,8 @@ async function authenticateLinear(options) {
     workspace
   });
   if (!silent) {
-    console.log(import_chalk3.default.green("\u2713") + " API key verified");
-    console.log(import_chalk3.default.green("\u2713") + ` Authenticated as ${import_chalk3.default.cyan(viewer.name)} in ${import_chalk3.default.cyan(workspace)}`);
+    console.log(import_chalk4.default.green("\u2713") + " API key verified");
+    console.log(import_chalk4.default.green("\u2713") + ` Authenticated as ${import_chalk4.default.cyan(viewer.name)} in ${import_chalk4.default.cyan(workspace)}`);
   }
   return { success: true, workspace };
 }
@@ -12039,6 +13317,91 @@ async function logoutLinear() {
   await authStore.clear("linear");
 }
 
+// src/tui/theme.ts
+var RAW_PALETTE = {
+  // Text hierarchy
+  text: "#ffffff",
+  textSecondary: "#a0a0a0",
+  textMuted: "#606060",
+  textDim: "#404040",
+  // Priority signal
+  critical: "#ef4444",
+  high: "#f59e0b",
+  medium: "#3b82f6",
+  low: "#6b7280",
+  // Contract-state signal (design §3: draft dim · ready cyan · in_progress
+  // yellow · delivered magenta · done green · failed/blocked red)
+  contractDraft: "#606060",
+  contractReady: "#06b6d4",
+  contractInProgress: "#eab308",
+  contractDelivered: "#c026d3",
+  contractDone: "#22c55e",
+  contractFailed: "#ef4444",
+  // Feedback
+  success: "#22c55e",
+  warning: "#eab308",
+  error: "#ef4444",
+  info: "#3b82f6",
+  accent: "#7c3aed"
+};
+function isNoColor(env = process.env) {
+  return Boolean(env.NO_COLOR);
+}
+function makePalette(noColor) {
+  if (!noColor) return RAW_PALETTE;
+  return new Proxy(RAW_PALETTE, { get: () => void 0 });
+}
+var NO_COLOR = isNoColor();
+var PALETTE = makePalette(NO_COLOR);
+var RULE = "\u2500";
+var TYPE_GLYPHS = {
+  epic: "\u25B8",
+  spec: "\u25C6",
+  adr: "\u25CF",
+  plan: "\u2398",
+  task: ""
+};
+function getTypeGlyph(type) {
+  if (!type) return "";
+  return TYPE_GLYPHS[type.toLowerCase()] ?? "";
+}
+var GLYPHS = {
+  pointer: "\u25B8",
+  cursor: "\u258C",
+  collapsed: "\u25B6",
+  success: "\u2713",
+  error: "\u2717",
+  warning: "\u26A0",
+  live: "\u25CF",
+  subtaskOpen: "\u25FB",
+  subtaskDone: "\u2611",
+  orphanParent: "\u2190",
+  /** Board-list row glyph for a parent-with-children that is expanded (§A1). */
+  parentExpanded: "\u25BE",
+  /** Board-list row glyph for a parent-with-children that is collapsed (§A1). */
+  parentCollapsed: "\u25B8",
+  /** Detail body scroll indicator (§B2), e.g. `↕ 2/9`. */
+  scroll: "\u2195"
+};
+function getContractStateColor(state) {
+  switch (state?.toLowerCase()) {
+    case "ready":
+      return PALETTE.contractReady;
+    case "in_progress":
+      return PALETTE.contractInProgress;
+    case "delivered":
+      return PALETTE.contractDelivered;
+    case "done":
+      return PALETTE.contractDone;
+    case "failed":
+    case "blocked":
+      return PALETTE.contractFailed;
+    case "draft":
+    default:
+      return PALETTE.contractDraft;
+  }
+}
+
 export {
   require_source,
   require_dist,
@@ -12061,14 +13424,54 @@ export {
   columnNotFound,
   taskNotFound,
   validationError2,
+  renderCliError,
   V1_UNSUPPORTED_MESSAGE,
   assertV2Brainfile,
+  git,
+  gitToplevel,
+  listWorktrees,
+  boardBranch,
+  boardRepoKind,
+  isTrackedBoard,
+  findTrackedBoardDir,
+  materializeBoardWorktree,
+  ensureExcludeEntry,
+  removeExcludeEntry,
+  createOrphanBoardWorktree,
+  initStandaloneBoardRepo,
+  boardIsDirty,
+  commitBoard,
+  commitHandEdits,
+  resolveAgentName,
+  homeBoardDir,
+  isGlobalBoardRequested,
+  describeCommandForCommit,
+  scheduleBoardCommit,
   resolveCliBrainfilePath,
+  tryResolveBoardDir,
   workspaceRootFromBrainfilePath,
   probeWorkspaceFormat,
   shouldSuggestV2Migration,
   markV2MigrationHintShown,
   import_core5 as import_core,
+  mergeDriverCommand,
+  boardRemote,
+  boardRemoteBranch,
+  boardAutosync,
+  setBoardAutosync,
+  setBoardRemote,
+  registerMergeDriver,
+  ensureBoardAttributes,
+  readSyncState,
+  syncBoard,
+  secondsSinceSync,
+  syncStatusLabel,
+  pendingChanges,
+  syncMessage,
+  effectiveAutosync,
+  clearPushLock,
+  fetchBeforeRead,
+  installAutosync,
   getConfigPath,
   loadConfig,
   saveConfig,
@@ -12085,5 +13488,10 @@ export {
   authenticateLinear,
   getLinearTeams,
   createLinearIssue,
-  logoutLinear
+  logoutLinear,
+  PALETTE,
+  RULE,
+  getTypeGlyph,
+  GLYPHS,
+  getContractStateColor
 };