brainfile 0.20.0 → 0.21.1

package/dist/{chunk-UOCQBEEW.mjs → chunk-MUV7XTFA.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) {
@@ -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;
         }
@@ -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;
@@ -5570,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) {
@@ -5630,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);
           });
         }
@@ -5658,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(", ")}`
             });
           }
@@ -5683,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);
             });
           }
@@ -5712,20 +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" });
+          errors.push({ path: `${path11}.completed`, message: "Subtask completed must be a boolean" });
         }
         return errors;
       }
@@ -5788,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;
       }
@@ -5822,104 +5920,6 @@ var require_validator = __commonJS({
   }
 });
 
-// ../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 = 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;
-      }
-      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 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");
-        }
-      }
-      return parts.join("");
-    }
-  }
-});
-
 // ../core/dist/linter.js
 var require_linter = __commonJS({
   "../core/dist/linter.js"(exports) {
@@ -7443,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 = [
@@ -7480,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;
       }
@@ -7490,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);
@@ -7514,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 {
@@ -7551,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;
@@ -7586,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;
         }
@@ -7604,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;
@@ -7622,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) {
@@ -7640,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;
         }
@@ -7660,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,
@@ -7693,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);
@@ -7815,8 +7815,8 @@ var require_files = __commonJS({
     exports.ensureDotBrainfileDir = ensureDotBrainfileDir;
     exports.ensureDotBrainfileGitignore = ensureDotBrainfileGitignore;
     exports.atomicWriteFileSync = atomicWriteFileSync;
-    var fs7 = __importStar(__require("fs"));
-    var path7 = __importStar(__require("path"));
+    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";
@@ -7824,38 +7824,43 @@ var require_files = __commonJS({
     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;
@@ -7863,60 +7868,60 @@ 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 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();
-      fs7.writeFileSync(gitignorePath, filtered.length > 0 ? `${filtered}
+      fs11.writeFileSync(gitignorePath, filtered.length > 0 ? `${filtered}
 ` : "", "utf-8");
     }
     function atomicWriteFileSync(filePath, content) {
       const abs = toAbsolute(filePath);
-      const dir = path7.dirname(abs);
-      fs7.mkdirSync(dir, { recursive: true });
-      const tmp = path7.join(dir, `.${path7.basename(abs)}.tmp-${process.pid}-${Date.now()}`);
+      const dir = path11.dirname(abs);
+      fs11.mkdirSync(dir, { recursive: true });
+      const tmp = path11.join(dir, `.${path11.basename(abs)}.tmp-${process.pid}-${Date.now()}`);
       try {
-        fs7.writeFileSync(tmp, content, "utf-8");
-        fs7.renameSync(tmp, abs);
+        fs11.writeFileSync(tmp, content, "utf-8");
+        fs11.renameSync(tmp, abs);
       } catch (err) {
         try {
-          if (fs7.existsSync(tmp))
-            fs7.unlinkSync(tmp);
+          if (fs11.existsSync(tmp))
+            fs11.unlinkSync(tmp);
         } catch {
         }
         throw err;
@@ -8000,8 +8005,8 @@ var require_taskFile = __commonJS({
     exports.writeTaskFile = writeTaskFile;
     exports.readTasksDir = readTasksDir;
     exports.taskFileName = taskFileName;
-    var fs7 = __importStar(__require("fs"));
-    var path7 = __importStar(__require("path"));
+    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() {
@@ -8018,15 +8023,15 @@ var require_taskFile = __commonJS({
       if (trimmed.includes("/") || trimmed.includes("\\") || trimmed.includes("..")) {
         return true;
       }
-      if (path7.isAbsolute(trimmed)) {
+      if (path11.isAbsolute(trimmed)) {
         return true;
       }
-      return path7.basename(trimmed) !== trimmed;
+      return path11.basename(trimmed) !== trimmed;
     }
     function readTaskFile(filePath) {
       let content;
       try {
-        content = fs7.readFileSync(filePath, "utf-8");
+        content = fs11.readFileSync(filePath, "utf-8");
       } catch {
         return null;
       }
@@ -8037,19 +8042,19 @@ var require_taskFile = __commonJS({
       return {
         task: parsed.task,
         body: parsed.body,
-        filePath: path7.resolve(filePath)
+        filePath: path11.resolve(filePath)
       };
     }
     function writeTaskFile(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, taskContent_1.serializeTaskContent)(task, body);
-      fs7.writeFileSync(filePath, content, "utf-8");
+      fs11.writeFileSync(filePath, content, "utf-8");
     }
     function readTasksDir(dirPath) {
       let entries;
       try {
-        entries = fs7.readdirSync(dirPath, { withFileTypes: true });
+        entries = fs11.readdirSync(dirPath, { withFileTypes: true });
       } catch {
         return [];
       }
@@ -8058,7 +8063,7 @@ var require_taskFile = __commonJS({
         if (!entry.isFile() || !entry.name.endsWith(".md")) {
           continue;
         }
-        const filePath = path7.join(dirPath, entry.name);
+        const filePath = path11.join(dirPath, entry.name);
         const doc = readTaskFile(filePath);
         if (doc) {
           docs.push(doc);
@@ -8125,14 +8130,14 @@ var require_ledger2 = __commonJS({
     exports.queryLedger = queryLedger;
     exports.getFileHistory = getFileHistory;
     exports.getTaskContext = getTaskContext;
-    var fs7 = __importStar(__require("fs"));
-    var path7 = __importStar(__require("path"));
+    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 path7.join(logsDir, LEDGER_FILE_NAME);
+      return path11.join(logsDir, LEDGER_FILE_NAME);
     }
     function normalizePathValue(value) {
       return value.replace(/\\/g, "/").replace(/^\.\//, "").trim();
@@ -8350,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;
       }
@@ -8436,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++) {
@@ -8576,35 +8581,35 @@ var require_workspace = __commonJS({
     exports.composeBody = composeBody2;
     exports.readV2BoardConfig = readV2BoardConfig2;
     exports.buildBoardFromV2 = buildBoardFromV22;
-    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 taskFile_1 = require_taskFile();
     function getV2Dirs2(brainfilePath) {
-      const resolvedPath = path7.resolve(brainfilePath);
-      const dotDir = path7.dirname(resolvedPath);
+      const resolvedPath = path11.resolve(brainfilePath);
+      const dotDir = path11.dirname(resolvedPath);
       return {
         dotDir,
-        boardDir: path7.join(dotDir, "board"),
-        logsDir: path7.join(dotDir, "logs"),
+        boardDir: path11.join(dotDir, "board"),
+        logsDir: path11.join(dotDir, "logs"),
         brainfilePath: resolvedPath
       };
     }
     function isV25(brainfilePath) {
       const { boardDir } = getV2Dirs2(brainfilePath);
-      return fs7.existsSync(boardDir);
+      return fs11.existsSync(boardDir);
     }
     function ensureV2Dirs2(brainfilePath) {
       const dirs = getV2Dirs2(brainfilePath);
-      fs7.mkdirSync(dirs.boardDir, { recursive: true });
-      fs7.mkdirSync(dirs.logsDir, { recursive: true });
+      fs11.mkdirSync(dirs.boardDir, { recursive: true });
+      fs11.mkdirSync(dirs.logsDir, { recursive: true });
       return dirs;
     }
     function getTaskFilePath2(boardDir, taskId) {
-      return path7.join(boardDir, (0, taskFile_1.taskFileName)(taskId));
+      return path11.join(boardDir, (0, taskFile_1.taskFileName)(taskId));
     }
     function getLogFilePath2(logsDir, taskId) {
-      return path7.join(logsDir, (0, taskFile_1.taskFileName)(taskId));
+      return path11.join(logsDir, (0, taskFile_1.taskFileName)(taskId));
     }
     function findV2Task2(dirs, taskId, searchLogs = false) {
       const taskPath = getTaskFilePath2(dirs.boardDir, taskId);
@@ -8665,7 +8670,7 @@ ${log.trim()}`);
 `;
     }
     function readV2BoardConfig2(brainfilePath) {
-      const content = fs7.readFileSync(brainfilePath, "utf-8");
+      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}`);
@@ -8760,7 +8765,7 @@ var require_brief = __commonJS({
     exports.relativeTime = relativeTime;
     exports.buildBrief = buildBrief;
     exports.isEmptyBrief = isEmptyBrief;
-    var fs7 = __importStar(__require("fs"));
+    var fs11 = __importStar(__require("fs"));
     var taskFile_1 = require_taskFile();
     var ledger_1 = require_ledger2();
     var workspace_1 = require_workspace();
@@ -8864,7 +8869,7 @@ var require_brief = __commonJS({
     }
     function boardMtimeMs(brainfilePath) {
       try {
-        return fs7.statSync(brainfilePath).mtimeMs;
+        return fs11.statSync(brainfilePath).mtimeMs;
       } catch {
         return null;
       }
@@ -9011,13 +9016,13 @@ var require_brief = __commonJS({
         const isUpdated = updatedMs !== null && updatedMs > lastBriefAtMs;
         if (!isNew && !isUpdated)
           continue;
-        const stamp = isNew ? doc.task.createdAt : doc.task.updatedAt;
+        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(stamp, generatedAt)} \xB7 ${taskStateWhy(doc.task)}`,
-          ...stamp ? { at: stamp } : {}
+          why: `${verb} ${agoPhrase(stamp2, generatedAt)} \xB7 ${taskStateWhy(doc.task)}`,
+          ...stamp2 ? { at: stamp2 } : {}
         });
       }
       const completionItems = completionsFor(dirs, agentName, lastBriefAtMs).map((record) => ({
@@ -9097,8 +9102,8 @@ var require_briefState = __commonJS({
     exports.getBriefStatePath = getBriefStatePath;
     exports.readBriefState = readBriefState;
     exports.writeBriefState = writeBriefState;
-    var fs7 = __importStar(__require("fs"));
-    var path7 = __importStar(__require("path"));
+    var fs11 = __importStar(__require("fs"));
+    var path11 = __importStar(__require("path"));
     var files_1 = require_files();
     exports.BRIEF_STATE_VERSION = 1;
     function sanitizeAgentFilename(agentName) {
@@ -9116,18 +9121,18 @@ var require_briefState = __commonJS({
       return cleaned;
     }
     function getBriefStateDir(brainfilePath) {
-      return path7.join((0, files_1.getBrainfileStateDir)(brainfilePath), files_1.DOT_BRAINFILE_STATE_DIRNAME);
+      return path11.join((0, files_1.getBrainfileStateDir)(brainfilePath), files_1.DOT_BRAINFILE_STATE_DIRNAME);
     }
     function getBriefStatePath(brainfilePath, agentName) {
-      return path7.join(getBriefStateDir(brainfilePath), `${sanitizeAgentFilename(agentName)}.json`);
+      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 (!fs7.existsSync(statePath))
+      if (!fs11.existsSync(statePath))
         return fallback;
       try {
-        const parsed = JSON.parse(fs7.readFileSync(statePath, "utf-8"));
+        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,
@@ -9361,8 +9366,8 @@ var require_boardFile = __commonJS({
     exports.serializeBoardConfig = exports.parseBoardConfig = void 0;
     exports.readBoardConfig = readBoardConfig;
     exports.writeBoardConfig = writeBoardConfig;
-    var fs7 = __importStar(__require("fs"));
-    var path7 = __importStar(__require("path"));
+    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() {
@@ -9374,7 +9379,7 @@ var require_boardFile = __commonJS({
     function readBoardConfig(filePath) {
       let content;
       try {
-        content = fs7.readFileSync(filePath, "utf-8");
+        content = fs11.readFileSync(filePath, "utf-8");
       } catch {
         return null;
       }
@@ -9385,14 +9390,14 @@ var require_boardFile = __commonJS({
       return {
         config: parsed.config,
         body: parsed.body,
-        filePath: path7.resolve(filePath)
+        filePath: path11.resolve(filePath)
       };
     }
     function writeBoardConfig(filePath, config, body = "") {
-      const dir = path7.dirname(filePath);
-      fs7.mkdirSync(dir, { recursive: true });
+      const dir = path11.dirname(filePath);
+      fs11.mkdirSync(dir, { recursive: true });
       const content = (0, boardContent_1.serializeBoardConfig)(config, body);
-      fs7.writeFileSync(filePath, content, "utf-8");
+      fs11.writeFileSync(filePath, content, "utf-8");
     }
   }
 });
@@ -9464,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();
@@ -9567,21 +9572,21 @@ ${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 {
       }
@@ -9663,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 };
         }
@@ -9717,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 };
       }
@@ -9933,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) {
@@ -9954,8 +9959,8 @@ ${section}
         completedAt: now,
         updatedAt: now
       };
-      const destPath = path7.join(logsDir, path7.basename(taskPath));
-      if (fs7.existsSync(destPath)) {
+      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 completedBody = archivedBody(doc, childStates);
@@ -9972,14 +9977,14 @@ ${section}
         return { success: false, error: `Failed to append ledger record: ${err}` };
       }
       try {
-        fs7.mkdirSync(logsDir, { recursive: true });
+        fs11.mkdirSync(logsDir, { recursive: true });
         writeTaskFileExclusive(destPath, completedTask, completedBody);
       } catch (err) {
         rollbackLedgerAppend(logsDir, record);
         return { success: false, error: `Failed to complete task: ${err}` };
       }
       try {
-        fs7.unlinkSync(taskPath);
+        fs11.unlinkSync(taskPath);
         return {
           success: true,
           task: completedTask,
@@ -9988,7 +9993,7 @@ ${section}
         };
       } catch (err) {
         try {
-          fs7.unlinkSync(destPath);
+          fs11.unlinkSync(destPath);
         } catch {
         }
         rollbackLedgerAppend(logsDir, record);
@@ -10001,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}` };
@@ -10076,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;
@@ -10309,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);
       }
@@ -10669,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.DOT_BRAINFILE_GITIGNORE_BASENAME = exports.BRAINFILE_STATE_BASENAME = 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 = void 0;
-    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.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 = 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 = 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();
@@ -10741,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;
@@ -11508,8 +11520,8 @@ function renderCliError(error) {
 
 // src/utils/brainfile-path.ts
 var import_core3 = __toESM(require_dist());
-import * as fs2 from "fs";
-import * as path2 from "path";
+import * as fs3 from "fs";
+import * as path3 from "path";
 
 // src/utils/v2-only.ts
 var import_core2 = __toESM(require_dist());
@@ -11530,78 +11542,473 @@ 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 BOARD_REF_NAMESPACE = "refs/brainfile";
+var BOARD_NAME_CONFIG_KEY = "brainfile.boardName";
+var LEGACY_REMOTE_BRANCH_CONFIG_KEY = "brainfile.remoteBranch";
+var DEFAULT_BOARD_NAME = "board";
+function remoteBoardRef(name) {
+  return `${BOARD_REF_NAMESPACE}/${name}`;
+}
+function boardTrackingRef(remote, name) {
+  return `${BOARD_REF_NAMESPACE}/remotes/${remote}/${name}`;
+}
+var NETWORK_TIMEOUT_MS = 8e3;
+var NO_PROMPT_ENV = { GIT_TERMINAL_PROMPT: "0", GIT_ASKPASS: "echo", SSH_ASKPASS: "echo" };
+function gitNetwork(args, cwd) {
+  return git(args, cwd, NO_PROMPT_ENV, NETWORK_TIMEOUT_MS);
+}
+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, timeoutMs) {
+  const result = spawnSync("git", args, {
+    cwd,
+    encoding: "utf-8",
+    env: env ? { ...process.env, ...env } : process.env,
+    stdio: ["ignore", "pipe", "pipe"],
+    ...timeoutMs ? { timeout: timeoutMs, killSignal: "SIGKILL" } : {}
+  });
+  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;
+}
+var PROBE_MISS_TTL_MS = 10 * 6e4;
+function probeMissFile(cwd) {
+  const common = gitCommonDir(cwd);
+  return common ? path2.join(common, "brainfile-probe.json") : null;
+}
+function recentProbeMiss(cwd, remote) {
+  const file = probeMissFile(cwd);
+  if (!file) return false;
+  try {
+    const miss = JSON.parse(fs2.readFileSync(file, "utf-8"));
+    return miss.remote === remote && typeof miss.at === "number" && Date.now() - miss.at < PROBE_MISS_TTL_MS;
+  } catch {
+    return false;
+  }
+}
+function recordProbeMiss(cwd, remote) {
+  const file = probeMissFile(cwd);
+  if (!file) return;
+  try {
+    fs2.writeFileSync(file, JSON.stringify({ remote, at: Date.now() }), "utf-8");
+  } catch {
+  }
+}
+function clearProbeMiss(cwd) {
+  const file = probeMissFile(cwd);
+  if (file) fs2.rmSync(file, { force: true });
+}
+function listRemoteBoards(cwd, remote) {
+  const r = gitNetwork(["ls-remote", "--quiet", remote, `${BOARD_REF_NAMESPACE}/*`], cwd);
+  if (!r.ok) return null;
+  const names = [];
+  for (const line of r.stdout.split("\n")) {
+    const ref = line.split("	")[1] ?? "";
+    const name = ref.slice(BOARD_REF_NAMESPACE.length + 1);
+    if (ref.startsWith(`${BOARD_REF_NAMESPACE}/`) && name && !name.includes("/")) names.push(name);
+  }
+  return names;
+}
+function findBoardStart(cwd, branch, options) {
+  if (git(["rev-parse", "--verify", "--quiet", `refs/heads/${branch}`], cwd).ok) return { ref: branch, remote: null };
+  const configuredRemote = git(["config", "--get", "brainfile.remote"], cwd).stdout || null;
+  const remote = configuredRemote ?? (git(["remote", "get-url", "origin"], cwd).ok ? "origin" : null);
+  if (!remote) return null;
+  const configuredName = git(["config", "--get", BOARD_NAME_CONFIG_KEY], cwd).stdout || git(["config", "--get", LEGACY_REMOTE_BRANCH_CONFIG_KEY], cwd).stdout || null;
+  const knownName = configuredName ?? DEFAULT_BOARD_NAME;
+  const known = boardTrackingRef(remote, knownName);
+  if (git(["rev-parse", "--verify", "--quiet", known], cwd).ok) return { ref: known, remote, name: knownName };
+  if (options.fresh || !recentProbeMiss(cwd, remote)) {
+    const names = listRemoteBoards(cwd, remote);
+    const name = names === null ? null : configuredName ? names.includes(configuredName) ? configuredName : null : names.includes(DEFAULT_BOARD_NAME) ? DEFAULT_BOARD_NAME : names.length === 1 ? names[0] : null;
+    if (name) {
+      const tracking = boardTrackingRef(remote, name);
+      if (gitNetwork(["fetch", "--quiet", "--no-tags", remote, `+${remoteBoardRef(name)}:${tracking}`], cwd).ok) {
+        clearProbeMiss(cwd);
+        return { ref: tracking, remote, name };
+      }
+    }
+  }
+  const legacyBranch = configuredName ?? branch;
+  const legacy = `refs/remotes/${remote}/${legacyBranch}`;
+  if (!git(["rev-parse", "--verify", "--quiet", legacy], cwd).ok && configuredRemote && (options.fresh || !recentProbeMiss(cwd, remote))) {
+    gitNetwork(["fetch", "--quiet", "--no-tags", remote, `+refs/heads/${legacyBranch}:${legacy}`], cwd);
+  }
+  if (git(["rev-parse", "--verify", "--quiet", legacy], cwd).ok) return { ref: legacy, remote };
+  recordProbeMiss(cwd, remote);
+  return null;
+}
+function materializeBoardWorktree(cwd, options = {}) {
+  const branch = boardBranch(cwd);
+  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 start = findBoardStart(cwd, branch, options);
+  if (!start) return null;
+  const r = start.remote ? git(["worktree", "add", "--quiet", "--no-track", "-b", branch, target, start.ref], cwd) : git(["worktree", "add", "--quiet", target, branch], cwd);
+  if (!r.ok) return null;
+  ensureExcludeEntry(cwd);
+  for (const sub of BOARD_SUBDIRS) fs2.mkdirSync(path2.join(target, sub), { recursive: true });
+  if (start.remote) {
+    if (!git(["config", "--get", "brainfile.remote"], cwd).stdout) git(["config", "brainfile.remote", start.remote], cwd);
+    if (start.name && start.name !== DEFAULT_BOARD_NAME && !git(["config", "--get", BOARD_NAME_CONFIG_KEY], cwd).stdout) {
+      git(["config", BOARD_NAME_CONFIG_KEY, start.name], cwd);
+    }
+  }
+  const relative3 = path2.relative(process.cwd(), target) || ".";
+  process.stderr.write(
+    start.remote ? `Checked out the shared board from ${start.remote} 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;
+}
+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 agent = options.agent?.replace(/[[\]<>\r\n]/g, "").trim();
+  const suffix = agent ? ` [${agent}]` : "";
+  const message = oneLine(options.message, suffix);
+  const r = git(
+    [...identityArgs(dotDir), "-c", "commit.gpgsign=false", "commit", "--quiet", "--no-verify", "-m", message],
+    dotDir
+  );
+  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 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, suffix = "") {
+  const flat = message.replace(/\s+/g, " ").trim();
+  const room = Math.max(1, MAX_MESSAGE_LENGTH - suffix.length);
+  return `${flat.length > room ? `${flat.slice(0, room - 1)}\u2026` : flat}${suffix}`;
+}
+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: [] };
+  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 });
+  }
+  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),
@@ -11635,15 +12042,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 {
@@ -11652,42 +12059,625 @@ 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 LEGACY_CHECKED_CONFIG_KEY = "brainfile.legacyBranchChecked";
+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 boardRemoteName(dotDir) {
+  const configured = configGet(dotDir, BOARD_NAME_CONFIG_KEY) ?? configGet(dotDir, LEGACY_REMOTE_BRANCH_CONFIG_KEY);
+  if (configured) return configured;
+  return defaultName(dotDir, DEFAULT_BOARD_NAME);
+}
+function defaultName(dotDir, inRepo) {
+  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))) || inRepo;
+  }
+  return inRepo;
+}
+function boardRemoteRef(dotDir) {
+  return remoteBoardRef(boardRemoteName(dotDir));
+}
+function legacyRemoteBranch(dotDir) {
+  return configGet(dotDir, LEGACY_REMOTE_BRANCH_CONFIG_KEY) ?? defaultName(dotDir, 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, boardName) {
+  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.`);
+    }
+  }
+  if (boardName !== void 0 && !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(boardName)) {
+    throw new Error(`'${boardName}' is not a usable board name: use letters, digits, '.', '_' or '-'.`);
+  }
+  configSet(cwd, REMOTE_CONFIG_KEY, remote);
+  if (boardName) configSet(cwd, BOARD_NAME_CONFIG_KEY, boardName);
+  registerMergeDriver(cwd);
+  return {
+    remote,
+    url: git(["remote", "get-url", remote], cwd).stdout || null,
+    remoteRef: boardRemoteRef(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 identityArgs2(dotDir) {
+  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");
+  }
+  return args;
+}
+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 mergeIncoming(dotDir, incoming, result) {
+  if (git(["merge-base", "--is-ancestor", incoming, "HEAD"], dotDir).ok) return { ok: true, pulled: 0 };
+  const before = git(["rev-parse", "HEAD"], dotDir).stdout;
+  const id = identityArgs2(dotDir);
+  const merge = git([...id, "merge", "--quiet", "--no-edit", incoming], dotDir);
+  if (!merge.ok) {
+    resolveCompleteVersusEdit(dotDir);
+    const remaining = unmergedFiles(dotDir);
+    if (remaining.length > 0) {
+      return {
+        ok: false,
+        result: {
+          ...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, "commit", "--quiet", "--no-edit", "--no-verify"], dotDir);
+    if (!commit.ok) {
+      return { ok: false, result: { ...result, ok: false, failure: "error", warning: `merge commit failed: ${firstLine(commit.stderr)}` } };
+    }
+  }
+  return { ok: true, pulled: commitCount(dotDir, `${before}..${incoming}`) };
+}
+function legacyChecked(dotDir, remote) {
+  return configGet(dotDir, LEGACY_CHECKED_CONFIG_KEY) === remote;
+}
+function syncBoard(dotDir, options = {}) {
+  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 name = boardRemoteName(dotDir);
+  const remoteRef = remoteBoardRef(name);
+  const tracking = boardTrackingRef(remote, name);
+  result.remote = remote;
+  result.remoteRef = remoteRef;
+  const checkLegacy = !legacyChecked(dotDir, remote);
+  const pull = (options.pull ?? true) || checkLegacy;
+  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;
+  let legacy = null;
+  let legacyAbsent = false;
+  if (pull) {
+    const fetch2 = git(["fetch", "--quiet", "--no-tags", remote, `+${remoteRef}:${tracking}`], 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)}` });
+    } else {
+      git(["update-ref", "-d", tracking], dotDir);
+    }
+    if (checkLegacy) {
+      const branch = legacyRemoteBranch(dotDir);
+      const old = git(["fetch", "--quiet", "--no-tags", remote, `refs/heads/${branch}`], dotDir);
+      if (old.ok) {
+        legacy = { branch, sha: git(["rev-parse", "FETCH_HEAD"], dotDir).stdout };
+      } else if (isMissingRemoteRef(old.stderr)) {
+        legacyAbsent = true;
+      }
+    }
+    for (const incoming of [fetched ? tracking : null, legacy?.sha ?? null]) {
+      if (!incoming) continue;
+      const merged = mergeIncoming(dotDir, incoming, result);
+      if (!merged.ok) return finish(dotDir, merged.result);
+      result.pulled += merged.pulled;
+    }
+  }
+  if (push) {
+    const known = git(["rev-parse", "--verify", "--quiet", tracking], dotDir).ok;
+    const ahead = commitCount(dotDir, known ? `${tracking}..HEAD` : "HEAD");
+    if (ahead > 0) {
+      const pushed = git(["push", "--quiet", remote, `HEAD:${remoteRef}`], 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)}`
+        });
+      }
+      git(["update-ref", tracking, "HEAD"], dotDir);
+      result.pushed = ahead;
+    }
+    if (legacy && git(["merge-base", "--is-ancestor", legacy.sha, tracking], dotDir).ok) {
+      const removed = git(
+        ["push", "--quiet", `--force-with-lease=refs/heads/${legacy.branch}:${legacy.sha}`, remote, `:refs/heads/${legacy.branch}`],
+        dotDir
+      );
+      if (removed.ok) {
+        git(["update-ref", "-d", `refs/remotes/${remote}/${legacy.branch}`], dotDir);
+        result.movedFromBranch = legacy.branch;
+        configSet(dotDir, LEGACY_CHECKED_CONFIG_KEY, remote);
+      }
+    }
+  }
+  if (legacyAbsent) {
+    git(["update-ref", "-d", `refs/remotes/${remote}/${legacyRemoteBranch(dotDir)}`], dotDir);
+    configSet(dotDir, LEGACY_CHECKED_CONFIG_KEY, remote);
+  }
+  return finish(dotDir, result);
+}
+function finish(dotDir, result) {
+  writeSyncState(dotDir, {
+    at: (/* @__PURE__ */ new Date()).toISOString(),
+    remote: result.remote ?? "",
+    remoteRef: result.remoteRef ?? "",
+    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 = boardTrackingRef(remote, boardRemoteName(dotDir));
+  const known = git(["rev-parse", "--verify", "--quiet", tracking], dotDir).ok;
+  return commitCount(dotDir, known ? `${tracking}..HEAD` : "HEAD");
+}
+function boardWebUrl(remoteUrl, remoteRef) {
+  if (!remoteUrl) return null;
+  const m = /^(?:https:\/\/(?:[^@/]+@)?github\.com\/|git@github\.com:|ssh:\/\/git@github\.com\/)([^/]+)\/([^/]+?)(?:\.git)?\/?$/.exec(remoteUrl);
+  return m ? `https://github.com/${m[1]}/${m[2]}/commits/${remoteRef}` : null;
+}
+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) {
@@ -11698,7 +12688,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
@@ -11773,11 +12763,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"]
@@ -11947,8 +12937,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 {
@@ -11957,7 +12947,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
@@ -12205,7 +13195,7 @@ 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
@@ -12552,12 +13542,51 @@ export {
   renderCliError,
   V1_UNSUPPORTED_MESSAGE,
   assertV2Brainfile,
+  git,
+  gitToplevel,
+  listWorktrees,
+  boardBranch,
+  boardRepoKind,
+  isTrackedBoard,
+  findTrackedBoardDir,
+  materializeBoardWorktree,
+  ensureExcludeEntry,
+  removeExcludeEntry,
+  createOrphanBoardWorktree,
+  initStandaloneBoardRepo,
+  boardIsDirty,
+  commitBoard,
+  commitHandEdits,
+  homeBoardDir,
+  isGlobalBoardRequested,
+  describeCommandForCommit,
+  scheduleBoardCommit,
   resolveCliBrainfilePath,
+  tryResolveBoardDir,
   workspaceRootFromBrainfilePath,
   probeWorkspaceFormat,
   shouldSuggestV2Migration,
   markV2MigrationHintShown,
   import_core5 as import_core,
+  mergeDriverCommand,
+  boardRemote,
+  boardRemoteRef,
+  boardAutosync,
+  setBoardAutosync,
+  setBoardRemote,
+  registerMergeDriver,
+  ensureBoardAttributes,
+  readSyncState,
+  syncBoard,
+  secondsSinceSync,
+  syncStatusLabel,
+  pendingChanges,
+  boardWebUrl,
+  syncMessage,
+  effectiveAutosync,
+  clearPushLock,
+  fetchBeforeRead,
+  installAutosync,
   getConfigPath,
   loadConfig,
   saveConfig,