brainfile 0.19.0 → 0.21.0

package/dist/utils/board-sync.js

@@ -0,0 +1,469 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) 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 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, 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.BOARD_GITATTRIBUTES = exports.DEFAULT_MERGE_DRIVER_COMMAND = exports.MERGE_DRIVER_NAME = exports.URL_REMOTE_NAME = exports.AUTOSYNC_CONFIG_KEY = exports.REMOTE_BRANCH_CONFIG_KEY = exports.REMOTE_CONFIG_KEY = void 0;
+exports.boardRemote = boardRemote;
+exports.boardRemoteBranch = boardRemoteBranch;
+exports.boardAutosync = boardAutosync;
+exports.setBoardAutosync = setBoardAutosync;
+exports.looksLikeRemoteUrl = looksLikeRemoteUrl;
+exports.setBoardRemote = setBoardRemote;
+exports.registerMergeDriver = registerMergeDriver;
+exports.ensureBoardAttributes = ensureBoardAttributes;
+exports.readSyncState = readSyncState;
+exports.resolveCompleteVersusEdit = resolveCompleteVersusEdit;
+exports.syncBoard = syncBoard;
+exports.secondsSinceSync = secondsSinceSync;
+exports.syncStatusLabel = syncStatusLabel;
+exports.pendingChanges = pendingChanges;
+exports.syncMessage = syncMessage;
+/**
+ * Board sync (spec-9 phase 2): remote configuration and the fetch → merge →
+ * push algorithm for tracked boards. Everything here runs inside the board
+ * directory, so the code tree is never touched, and nothing throws on network
+ * failure — a mutation must never fail because sync failed.
+ *
+ * Config keys live in the board's git config (the shared `.git/config` for a
+ * linked worktree, its own for a standalone repository):
+ *
+ *   brainfile.remote        remote name to sync with (never defaults to origin)
+ *   brainfile.remoteBranch  branch on that remote (see `boardRemoteBranch`)
+ *   brainfile.autosync      off | push | full
+ */
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const board_repo_1 = require("./board-repo");
+const merge_driver_1 = require("../commands/merge-driver");
+exports.REMOTE_CONFIG_KEY = 'brainfile.remote';
+exports.REMOTE_BRANCH_CONFIG_KEY = 'brainfile.remoteBranch';
+exports.AUTOSYNC_CONFIG_KEY = 'brainfile.autosync';
+/** Remote name used when `--set-remote` is given a URL instead of a name. */
+exports.URL_REMOTE_NAME = 'board';
+exports.MERGE_DRIVER_NAME = 'brainfile';
+exports.DEFAULT_MERGE_DRIVER_COMMAND = 'brainfile merge-driver %O %A %B';
+const SYNC_STATE_FILE = path.join('state', 'sync.json');
+exports.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 = (0, board_repo_1.git)(['config', '--get', key], dotDir);
+    return r.ok && r.stdout ? r.stdout : null;
+}
+function configSet(dotDir, key, value) {
+    return (0, board_repo_1.git)(['config', key, value], dotDir).ok;
+}
+function boardRemote(dotDir) {
+    return configGet(dotDir, exports.REMOTE_CONFIG_KEY);
+}
+/**
+ * Branch name on the remote. Defaults keep the "one private boards repo, one
+ * branch per project" pattern from colliding: the board branch name inside a
+ * repo, the parent folder's basename for a standalone board, `home` for the
+ * global board.
+ */
+function boardRemoteBranch(dotDir) {
+    const configured = configGet(dotDir, exports.REMOTE_BRANCH_CONFIG_KEY);
+    if (configured)
+        return configured;
+    if (path.resolve(dotDir) === path.resolve((0, board_repo_1.homeBoardDir)()))
+        return 'home';
+    // A standalone board is named after the folder it sits in; anything else
+    // (a linked board, or a code repo whose board is not checked out yet) uses
+    // the board branch name.
+    if ((0, board_repo_1.boardRepoKind)(dotDir) === 'standalone' && path.basename(path.resolve(dotDir)) === '.brainfile') {
+        return path.basename(path.dirname(path.resolve(dotDir))) || (0, board_repo_1.boardBranch)(dotDir);
+    }
+    return (0, board_repo_1.boardBranch)(dotDir);
+}
+function boardAutosync(dotDir) {
+    const value = configGet(dotDir, exports.AUTOSYNC_CONFIG_KEY);
+    if (value === 'off' || value === 'push' || value === 'full')
+        return value;
+    return boardRemote(dotDir) ? 'push' : 'off';
+}
+function setBoardAutosync(dotDir, mode) {
+    return configSet(dotDir, exports.AUTOSYNC_CONFIG_KEY, mode);
+}
+/** True when `target` names a place rather than an existing git remote. */
+function looksLikeRemoteUrl(target) {
+    if (/^[a-z][a-z0-9+.-]*:\/\//i.test(target))
+        return true; // ssh://, https://, file://
+    if (/^[^/\s]+@[^/\s]+:/.test(target))
+        return true; // git@host:path
+    if (target.startsWith('/') || target.startsWith('.') || target.startsWith('~'))
+        return true;
+    if (target.includes('/') && fs.existsSync(target))
+        return true;
+    return false;
+}
+/**
+ * Point the board at a remote: an existing remote name, or a URL/path that is
+ * registered as the `board` remote. Throws an Error naming an unknown remote.
+ * `cwd` may be the board directory or, when no board exists yet, the code
+ * repository the board will be materialized into.
+ */
+function setBoardRemote(cwd, target, remoteBranch) {
+    const trimmed = target.trim();
+    if (!trimmed)
+        throw new Error('remote is required');
+    let remote;
+    if (looksLikeRemoteUrl(trimmed)) {
+        remote = exports.URL_REMOTE_NAME;
+        const url = trimmed.startsWith('~/') ? path.join(os.homedir(), trimmed.slice(2)) : trimmed;
+        const exists = (0, board_repo_1.git)(['remote', 'get-url', remote], cwd).ok;
+        const r = exists ? (0, board_repo_1.git)(['remote', 'set-url', remote, url], cwd) : (0, board_repo_1.git)(['remote', 'add', remote, url], cwd);
+        if (!r.ok)
+            throw new Error(r.stderr || `could not register remote '${remote}'`);
+    }
+    else {
+        remote = trimmed;
+        if (!(0, board_repo_1.git)(['remote', 'get-url', remote], cwd).ok) {
+            const known = (0, board_repo_1.git)(['remote'], cwd).stdout.split('\n').filter(Boolean);
+            const hint = known.length ? ` Known remotes: ${known.join(', ')}.` : '';
+            throw new Error(`'${remote}' is not a git remote here.${hint} Pass a URL to add one.`);
+        }
+    }
+    configSet(cwd, exports.REMOTE_CONFIG_KEY, remote);
+    if (remoteBranch)
+        configSet(cwd, exports.REMOTE_BRANCH_CONFIG_KEY, remoteBranch);
+    registerMergeDriver(cwd);
+    return {
+        remote,
+        url: (0, board_repo_1.git)(['remote', 'get-url', remote], cwd).stdout || null,
+        remoteBranch: remoteBranch ?? boardRemoteBranch(cwd),
+    };
+}
+/**
+ * Register the field-level merge driver in the board's git config.
+ *
+ * Without an explicit `command` this only fills in a missing driver: a
+ * driver someone configured on purpose (an absolute path to the CLI, or a
+ * test's built bundle) is never overwritten by the next sync.
+ */
+function registerMergeDriver(cwd, command) {
+    const current = configGet(cwd, `merge.${exports.MERGE_DRIVER_NAME}.driver`);
+    if (command === undefined) {
+        if (current)
+            return false;
+        command = exports.DEFAULT_MERGE_DRIVER_COMMAND;
+    }
+    if (current === command)
+        return false;
+    configSet(cwd, `merge.${exports.MERGE_DRIVER_NAME}.name`, 'brainfile board merge (field-level, last writer wins)');
+    return configSet(cwd, `merge.${exports.MERGE_DRIVER_NAME}.driver`, command);
+}
+/**
+ * Make sure `.gitattributes` on the board declares the merge strategies.
+ * Returns true when the file was created or extended (caller commits).
+ */
+function ensureBoardAttributes(dotDir) {
+    const file = path.join(dotDir, '.gitattributes');
+    let existing = '';
+    try {
+        existing = fs.readFileSync(file, 'utf-8');
+    }
+    catch {
+        /* absent */
+    }
+    const lines = existing.split('\n').map((l) => l.trim());
+    const missing = exports.BOARD_GITATTRIBUTES.filter((l) => !lines.includes(l));
+    if (missing.length === 0)
+        return false;
+    const prefix = existing.length > 0 && !existing.endsWith('\n') ? `${existing}\n` : existing;
+    fs.writeFileSync(file, `${prefix}${missing.join('\n')}\n`, 'utf-8');
+    return true;
+}
+function readSyncState(dotDir) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(path.join(dotDir, SYNC_STATE_FILE), 'utf-8'));
+        return typeof parsed?.at === 'string' ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeSyncState(dotDir, state) {
+    try {
+        fs.mkdirSync(path.join(dotDir, 'state'), { recursive: true });
+        fs.writeFileSync(path.join(dotDir, SYNC_STATE_FILE), `${JSON.stringify(state, null, 2)}\n`, 'utf-8');
+    }
+    catch {
+        /* state is a convenience; never fail sync over it */
+    }
+}
+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 = (0, board_repo_1.git)(['rev-list', '--count', range], dotDir);
+    return r.ok ? Number.parseInt(r.stdout, 10) || 0 : 0;
+}
+function identity(dotDir, agent) {
+    const args = ['-c', 'commit.gpgsign=false'];
+    if (!(0, board_repo_1.git)(['config', '--get', 'user.email'], dotDir).ok) {
+        args.push('-c', 'user.name=brainfile', '-c', 'user.email=brainfile@localhost');
+    }
+    const env = {};
+    const name = agent?.replace(/[\r\n<>]/g, '').trim();
+    if (name) {
+        env.GIT_AUTHOR_NAME = name;
+        env.GIT_AUTHOR_EMAIL = `${name}@brainfile.local`;
+    }
+    return { args, env };
+}
+/**
+ * Complete-vs-edit: one side archived a task (deleted `board/<id>.md`, wrote
+ * `logs/<id>.md`) while the other edited it. Completion wins; the edit is
+ * appended to the archived file as a log entry. Returns the paths resolved.
+ */
+function resolveCompleteVersusEdit(dotDir) {
+    const status = (0, board_repo_1.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;
+        // DU: deleted by us, modified by them. UD: the reverse.
+        const editedStage = xy === 'DU' ? 3 : 2;
+        const base = (0, board_repo_1.git)(['show', `:1:${file}`], dotDir);
+        const edited = (0, board_repo_1.git)(['show', `:${editedStage}:${file}`], dotDir);
+        const archived = path.join(dotDir, 'logs', path.basename(file));
+        if (edited.ok && fs.existsSync(archived)) {
+            const summary = (0, merge_driver_1.summarizeFieldChanges)(base.ok ? base.stdout : '', edited.stdout);
+            const entryLine = `- ${new Date().toISOString()}: [sync] edited elsewhere after completion${summary ? ` (${summary})` : ''}`;
+            let content = fs.readFileSync(archived, 'utf-8');
+            if (/^## Log\s*$/m.test(content)) {
+                content = `${content.replace(/\s+$/, '')}\n${entryLine}\n`;
+            }
+            else {
+                content = `${content.replace(/\s+$/, '')}\n\n## Log\n${entryLine}\n`;
+            }
+            fs.writeFileSync(archived, content, 'utf-8');
+            (0, board_repo_1.git)(['add', '--', path.relative(dotDir, archived)], dotDir);
+        }
+        if ((0, board_repo_1.git)(['rm', '--quiet', '--cached', '--', file], dotDir).ok) {
+            try {
+                fs.rmSync(path.join(dotDir, file), { force: true });
+            }
+            catch {
+                /* already gone */
+            }
+            resolved.push(file);
+        }
+    }
+    return resolved;
+}
+/**
+ * fetch → fast-forward or merge → push. Runs entirely inside the board
+ * directory. Never throws; network failures come back as `warning`.
+ */
+function syncBoard(dotDir, options = {}) {
+    const pull = options.pull ?? true;
+    const push = options.push ?? true;
+    const result = { ok: true, pulled: 0, pushed: 0, conflicts: [] };
+    if (!(0, board_repo_1.isTrackedBoard)(dotDir))
+        return { ...result, skipped: 'not-tracked' };
+    const remote = boardRemote(dotDir);
+    if (!remote)
+        return { ...result, skipped: 'no-remote' };
+    const remoteBranch = boardRemoteBranch(dotDir);
+    result.remote = remote;
+    result.remoteBranch = remoteBranch;
+    // Never sync a board that is mid-merge: a human owns it until it is clean.
+    const stuck = (0, board_repo_1.unmergedFiles)(dotDir);
+    if (stuck.length > 0) {
+        return finish(dotDir, { ...result, ok: false, failure: 'conflict', conflicts: stuck, warning: `unresolved conflicts: ${stuck.join(', ')}` });
+    }
+    (0, board_repo_1.commitHandEdits)(dotDir);
+    if (ensureBoardAttributes(dotDir))
+        (0, board_repo_1.commitBoard)(dotDir, { message: 'chore: merge attributes' });
+    registerMergeDriver(dotDir);
+    let fetched = false;
+    if (pull) {
+        const fetch = (0, board_repo_1.git)(['fetch', '--quiet', remote, remoteBranch], dotDir);
+        if (fetch.ok) {
+            fetched = true;
+        }
+        else if (!isMissingRemoteRef(fetch.stderr)) {
+            return finish(dotDir, { ...result, ok: false, failure: 'offline', warning: `fetch from ${remote} failed: ${firstLine(fetch.stderr)}` });
+        }
+        if (fetched && !(0, board_repo_1.git)(['merge-base', '--is-ancestor', 'FETCH_HEAD', 'HEAD'], dotDir).ok) {
+            const before = (0, board_repo_1.git)(['rev-parse', 'HEAD'], dotDir).stdout;
+            const id = identity(dotDir, options.agent);
+            const merge = (0, board_repo_1.git)([...id.args, 'merge', '--quiet', '--no-edit', 'FETCH_HEAD'], dotDir, id.env);
+            if (!merge.ok) {
+                resolveCompleteVersusEdit(dotDir);
+                const remaining = (0, board_repo_1.unmergedFiles)(dotDir);
+                if (remaining.length > 0) {
+                    return finish(dotDir, {
+                        ...result,
+                        ok: false,
+                        failure: 'conflict',
+                        conflicts: remaining,
+                        warning: `merge left conflicts in ${remaining.join(', ')} — resolve them in ${dotDir}, then run sync again`,
+                    });
+                }
+                const commit = (0, board_repo_1.git)([...id.args, 'commit', '--quiet', '--no-edit', '--no-verify'], dotDir, id.env);
+                if (!commit.ok) {
+                    return finish(dotDir, { ...result, ok: false, failure: 'error', warning: `merge commit failed: ${firstLine(commit.stderr)}` });
+                }
+            }
+            // Count what came from the remote rather than our own merge commit.
+            result.pulled = commitCount(dotDir, `${before}..FETCH_HEAD`);
+        }
+    }
+    if (push) {
+        const ahead = fetched ? commitCount(dotDir, 'FETCH_HEAD..HEAD') : pendingChanges(dotDir);
+        if (ahead > 0) {
+            const pushed = (0, board_repo_1.git)(['push', '--quiet', remote, `HEAD:refs/heads/${remoteBranch}`], dotDir);
+            if (!pushed.ok) {
+                const rejected = /rejected|non-fast-forward|fetch first/i.test(pushed.stderr);
+                return finish(dotDir, {
+                    ...result,
+                    ok: false,
+                    failure: rejected ? 'rejected' : 'offline',
+                    warning: rejected
+                        ? `push to ${remote} rejected (the remote moved) — run sync again`
+                        : `push to ${remote} failed: ${firstLine(pushed.stderr)}`,
+                });
+            }
+            result.pushed = ahead;
+        }
+    }
+    return finish(dotDir, result);
+}
+function finish(dotDir, result) {
+    writeSyncState(dotDir, {
+        at: new Date().toISOString(),
+        remote: result.remote ?? '',
+        remoteBranch: result.remoteBranch ?? '',
+        ok: result.ok,
+        ...(result.warning ? { warning: result.warning } : {}),
+    });
+    return result;
+}
+/** Seconds since the last recorded sync attempt, or null when there was none. */
+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) / 1000));
+}
+/**
+ * Short status for a header: `synced 12s ago`, `local only` for a tracked
+ * board nobody else has, `not synced · saved locally` after a failure. Null
+ * for a plain board.
+ */
+function syncStatusLabel(dotDir, now = Date.now()) {
+    if (!(0, board_repo_1.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 · 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`;
+}
+/**
+ * Commits on this machine the remote has not seen yet, judged against the
+ * last-known remote position (no network). Null when the board is not shared.
+ */
+function pendingChanges(dotDir) {
+    const remote = boardRemote(dotDir);
+    if (!remote)
+        return 0;
+    const tracking = `refs/remotes/${remote}/${boardRemoteBranch(dotDir)}`;
+    const known = (0, board_repo_1.git)(['rev-parse', '--verify', '--quiet', tracking], dotDir).ok;
+    return commitCount(dotDir, known ? `${tracking}..HEAD` : 'HEAD');
+}
+const plural = (n, word) => `${n} ${word}${n === 1 ? '' : 's'}`;
+/**
+ * The one sentence a person needs after a sync: what moved, or why nothing
+ * did and that nothing was lost. `detail` is the technical cause, if any.
+ */
+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}.` };
+}
+//# sourceMappingURL=board-sync.js.map

package/dist/utils/board-sync.js.map

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

package/dist/utils/brainfile-path.d.ts

@@ -2,9 +2,19 @@
  * Resolve a brainfile path for CLI commands.
  *
  * Supports three input forms:
- * - Default (omitted): auto-discover from cwd upward
+ * - Default (omitted): auto-discover from cwd upward, stopping at the
+ *   repository root; then, inside a repo, the worktree on the board branch
+ *   (spec-9), creating it when the branch exists but has no checkout.
  * - Directory path (`cli/`, `./projects/foo`): find brainfile inside that directory
  * - File path (`path/to/brainfile.md`): use as-is
+ *
+ * `-g` / `--global` (or `BRAINFILE_GLOBAL=1`) targets the home board at
+ * `~/.brainfile` instead of discovering one.
  */
 export declare function resolveCliBrainfilePath(filePath?: string): string;
+/**
+ * The `.brainfile/` directory a command will operate on, or null when there
+ * is no board (or resolution itself fails). Never throws.
+ */
+export declare function tryResolveBoardDir(filePath?: string): string | null;
 //# sourceMappingURL=brainfile-path.d.ts.map

package/dist/utils/brainfile-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brainfile-path.d.ts","sourceRoot":"","sources":["../../src/utils/brainfile-path.ts"],"names":[],"mappings":"AAyBA;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBjE"}
+{"version":3,"file":"brainfile-path.d.ts","sourceRoot":"","sources":["../../src/utils/brainfile-path.ts"],"names":[],"mappings":"AAmCA;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAkCjE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQnE"}

package/dist/utils/brainfile-path.js

@@ -34,11 +34,13 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveCliBrainfilePath = resolveCliBrainfilePath;
+exports.tryResolveBoardDir = tryResolveBoardDir;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const core_1 = require("@brainfile/core");
 const cli_error_1 = require("./cli-error");
 const v2_only_1 = require("./v2-only");
+const board_repo_1 = require("./board-repo");
 function isMigrationCommand() {
     return process.argv.includes('migrate');
 }
@@ -55,15 +57,26 @@ function rejectLegacyRuntimePath(resolvedPath) {
     }
     return resolvedPath;
 }
+function isPlaceholder(filePath) {
+    return filePath === undefined || filePath === core_1.BRAINFILE_BASENAME || filePath === `./${core_1.BRAINFILE_BASENAME}`;
+}
 /**
  * Resolve a brainfile path for CLI commands.
  *
  * Supports three input forms:
- * - Default (omitted): auto-discover from cwd upward
+ * - Default (omitted): auto-discover from cwd upward, stopping at the
+ *   repository root; then, inside a repo, the worktree on the board branch
+ *   (spec-9), creating it when the branch exists but has no checkout.
  * - Directory path (`cli/`, `./projects/foo`): find brainfile inside that directory
  * - File path (`path/to/brainfile.md`): use as-is
+ *
+ * `-g` / `--global` (or `BRAINFILE_GLOBAL=1`) targets the home board at
+ * `~/.brainfile` instead of discovering one.
  */
 function resolveCliBrainfilePath(filePath) {
+    if (isPlaceholder(filePath) && (0, board_repo_1.isGlobalBoardRequested)()) {
+        return rejectLegacyRuntimePath(path.join((0, board_repo_1.homeBoardDir)(), core_1.BRAINFILE_BASENAME));
+    }
     // If a path was given and it's a directory, look for a brainfile inside it
     if (filePath) {
         const resolved = path.resolve(process.cwd(), filePath);
@@ -83,6 +96,30 @@ function resolveCliBrainfilePath(filePath) {
             // Not a directory, fall through to normal resolution
         }
     }
-    return rejectLegacyRuntimePath((0, core_1.resolveBrainfilePath)({ filePath, startDir: process.cwd() }));
+    const cwd = process.cwd();
+    if (isPlaceholder(filePath)) {
+        const found = (0, core_1.findBrainfile)(cwd, { stopAtGitRoot: true });
+        if (found)
+            return rejectLegacyRuntimePath(found.absolutePath);
+        const tracked = (0, board_repo_1.findTrackedBoardDir)(cwd) ?? (0, board_repo_1.materializeBoardWorktree)(cwd);
+        if (tracked)
+            return rejectLegacyRuntimePath(path.join(tracked, core_1.BRAINFILE_BASENAME));
+    }
+    return rejectLegacyRuntimePath((0, core_1.resolveBrainfilePath)({ filePath, startDir: cwd, stopAtGitRoot: true }));
+}
+/**
+ * The `.brainfile/` directory a command will operate on, or null when there
+ * is no board (or resolution itself fails). Never throws.
+ */
+function tryResolveBoardDir(filePath) {
+    try {
+        const resolved = resolveCliBrainfilePath(filePath);
+        if (!fs.existsSync(resolved))
+            return null;
+        return path.dirname(resolved);
+    }
+    catch {
+        return null;
+    }
 }
 //# sourceMappingURL=brainfile-path.js.map

package/dist/utils/brainfile-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"brainfile-path.js","sourceRoot":"","sources":["../../src/utils/brainfile-path.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,0DAqBC;AAtDD,uCAAyB;AACzB,2CAA6B;AAC7B,0CAA4E;AAC5E,2CAAuC;AACvC,uCAAmD;AAEnD,SAAS,kBAAkB;IACzB,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,oBAAoB,CAAC,aAAqB;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,YAAY;QAChE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,OAAO,gCAAgC,GAAG,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,uBAAuB,CAAC,YAAoB;IACnD,IAAI,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,IAAA,WAAI,EAAC,YAAY,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,oBAAQ,CAAC,gCAAsB,EAAE,SAAS,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CAAC,QAAiB;IACvD,2EAA2E;IAC3E,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;QACvD,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxC,oEAAoE;gBACpE,MAAM,KAAK,GAAG,IAAA,oBAAa,EAAC,QAAQ,CAAC,CAAC;gBACtC,IAAI,KAAK,IAAI,KAAK,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;oBAC5C,OAAO,uBAAuB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;gBACrD,CAAC;gBACD,mDAAmD;gBACnD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;gBACjE,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qDAAqD;QACvD,CAAC;IACH,CAAC;IAED,OAAO,uBAAuB,CAAC,IAAA,2BAAoB,EAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;AAC9F,CAAC"}
+{"version":3,"file":"brainfile-path.js","sourceRoot":"","sources":["../../src/utils/brainfile-path.ts"],"names":[],"mappings":"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"}

package/dist/utils/cli-error.d.ts

@@ -41,4 +41,24 @@ export declare function subtaskNotFound(subtaskId: string, availableSubtasks?: s
  * Create a CLIError for validation errors.
  */
 export declare function validationError(message: string): CLIError;
+/**
+ * Renders a failure that escaped a command and exits.
+ *
+ * This is the CLI's outermost error boundary, wired to `program.parseAsync()`
+ * in cli.ts. Commands throw `CLIError` rather than exiting themselves, and
+ * nothing used to catch those throws — so a missing `--task` surfaced as
+ * Node's raw uncaught-exception stack trace instead of the message and usage
+ * hint the error already carried.
+ *
+ * Two branches, deliberately:
+ *
+ * - `CLIError` is an expected, user-facing failure: print the message and its
+ *   usage `details`, exit with the code the error carries, and show no stack
+ *   (a stack tells the user nothing about a missing flag).
+ * - Anything else is a genuine bug: print the real stack, unmodified, and
+ *   exit 1. This is what Node already printed, just under our control so the
+ *   exit code is deterministic rather than depending on Node's
+ *   version-specific unhandled-rejection default.
+ */
+export declare function renderCliError(error: unknown): never;
 //# sourceMappingURL=cli-error.d.ts.map

package/dist/utils/cli-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-error.d.ts","sourceRoot":"","sources":["../../src/utils/cli-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAC/B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,YAAkC,EAAE,OAAO,CAAC,EAAE,MAAM;CAM9F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAMvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAOrD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAMvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAEvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,QAAQ,CAOrF;AACD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,GAAE,MAAM,EAAO,GAAG,QAAQ,CAMpF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,iBAAiB,GAAE,MAAM,EAAO,GAAG,QAAQ,CAM7F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAEzD"}
+{"version":3,"file":"cli-error.d.ts","sourceRoot":"","sources":["../../src/utils/cli-error.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAC/B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,YAAkC,EAAE,OAAO,CAAC,EAAE,MAAM;CAM9F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAMvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAOrD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAMvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAEvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,QAAQ,CAOrF;AACD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,GAAE,MAAM,EAAO,GAAG,QAAQ,CAMpF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,iBAAiB,GAAE,MAAM,EAAO,GAAG,QAAQ,CAM7F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAEzD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAYpD"}