brainfile 0.21.1 → 0.22.0

package/dist/commands/brief.js

@@ -1,17 +1,21 @@
 "use strict";
 /**
- * Brief command — per-agent "what changed that I should care about?".
+ * Brief command: the session-start block (spec-11, recoil's `wake`).
  *
- *   brainfile brief --agent codex           Delta since this agent's last brief
- *   brainfile brief --agent codex --peek    Same, without advancing the checkpoint
- *   brainfile brief --agent codex --json    Machine-readable envelope
+ *   brainfile brief --agent codex                  Budgeted block (~1,600 chars)
+ *   brainfile brief --agent codex --max-chars 0    Everything
+ *   brainfile brief --agent codex --peek           Same, without advancing the checkpoint
+ *   brainfile brief --agent codex --json           Machine-readable envelope
  *
- * The first brief for an agent is a full orientation (board rules, assigned
- * tasks, latest notes, recent completions). Every later brief is a delta.
+ * The block has lanes: heads up (work resting on a superseded decision,
+ * decisions whose predicates broke), current decisions, your tasks (or the
+ * work in flight), what changed since this agent's checkpoint, and the docs
+ * that bear on the tasks (from the local index, when there is one). The
+ * SessionStart hook injects the same block.
  *
- * Rendering is plain chalk, matching the rest of the non-TUI command surface.
- * It borrows only the dependency-free glyph vocabulary from the TUI theme so
- * the v3 design language stays consistent; no TUI file is modified.
+ * `--json` keeps the checkpoint lanes (`lanes`: a first brief's orientation,
+ * later the delta) and adds the block's `sections`, `text`, `maxChars` and
+ * `truncated`.
  *
  * @packageDocumentation
  */
@@ -57,8 +61,8 @@ exports.briefCommand = briefCommand;
 const fs = __importStar(require("fs"));
 const chalk_1 = __importDefault(require("chalk"));
 const core_1 = require("@brainfile/core");
+const memory_1 = require("@brainfile/core/memory");
 const v2_detect_1 = require("../utils/v2-detect");
-const theme_1 = require("../tui/theme");
 const logger_1 = require("../utils/logger");
 const cli_error_1 = require("../utils/cli-error");
 const brainfile_path_1 = require("../utils/brainfile-path");
@@ -121,7 +125,7 @@ function runBrief(options) {
     const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
     const peek = options.peek === true;
     const state = (0, core_1.readBriefState)(filePath, agent);
-    const result = (0, core_1.buildBrief)(dirs, agent, { lastBriefAt: state.lastBriefAt });
+    const result = (0, memory_1.composeBrief)(dirs, agent, { lastBriefAt: state.lastBriefAt, maxChars: parseMaxChars(options.maxChars) });
     // Peek is a caller-side no-op on the write step only — the brief itself is
     // identical either way, and no state file is created on a first-ever peek.
     if (!peek) {
@@ -129,33 +133,32 @@ function runBrief(options) {
     }
     return { ...result, peek };
 }
+function parseMaxChars(value) {
+    if (value === undefined)
+        return memory_1.DEFAULT_BRIEF_MAX_CHARS;
+    const n = typeof value === 'number' ? value : Number.parseInt(String(value), 10);
+    if (!Number.isFinite(n) || n < 0) {
+        throw new cli_error_1.CLIError(`--max-chars must be a number of characters, 0 for no limit (got '${value}')`);
+    }
+    return n;
+}
 // ============================================================================
 // Rendering
 // ============================================================================
+/** The block as plain text, lightly styled on a terminal (chalk is a no-op when piped). */
 function renderBrief(result, logger) {
-    const modeLabel = result.mode === 'full' ? 'first brief' : 'since last brief';
-    const header = `${chalk_1.default.bold(result.agent)} ${chalk_1.default.gray('·')} ${chalk_1.default.gray(modeLabel)}`;
-    logger.log(header + (result.peek ? chalk_1.default.gray('  (peek)') : ''));
-    if ((0, core_1.isEmptyBrief)(result)) {
-        logger.log('');
-        logger.log(chalk_1.default.gray(`  ${theme_1.GLYPHS.success} Nothing new since your last brief.`));
-        return;
-    }
-    for (const lane of result.lanes) {
-        if (lane.items.length === 0)
-            continue;
-        logger.log('');
-        logger.log(chalk_1.default.bold(lane.label));
-        // Align the why-column so the eye can scan reasons independently of text.
-        const width = Math.max(...lane.items.map((item) => laneKey(item.taskId).length));
-        for (const item of lane.items) {
-            const key = laneKey(item.taskId).padEnd(width);
-            const prefix = key.trim().length > 0 ? chalk_1.default.cyan(key) : key;
-            logger.log(`  ${prefix}  ${item.text}  ${chalk_1.default.gray(`(${item.why})`)}`);
-        }
-    }
-}
-function laneKey(taskId) {
-    return taskId ? `${theme_1.GLYPHS.pointer} ${taskId}` : '';
+    const lines = result.text.split('\n');
+    lines.forEach((line, index) => {
+        if (index === 0)
+            logger.log(chalk_1.default.bold(line) + (result.peek ? chalk_1.default.gray('  (peek)') : ''));
+        else if (line.startsWith('## '))
+            logger.log(chalk_1.default.bold(line.slice(3)));
+        else if (line.startsWith('! '))
+            logger.log(chalk_1.default.yellow(line));
+        else if (line.startsWith('(+'))
+            logger.log(chalk_1.default.gray(line));
+        else
+            logger.log(line);
+    });
 }
 //# sourceMappingURL=brief.js.map

package/dist/commands/brief.js.map

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

package/dist/commands/check.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `brainfile check`: is a decision on the board still safe to act on? (spec-11)
+ *
+ *   brainfile check "use axios for the retry client"
+ *   brainfile check decision-3
+ *   brainfile check --claim-key dependency.http-client
+ *   brainfile check --claim-key-prefix dependency "add axios"
+ *
+ * Finds the claim family the action touches (a decision ID, a claim key, or
+ * its words: the local index when there is one, a scan of the decisions
+ * when there is not) and answers in recoil's verdict order:
+ *
+ *   use              act on the current decision
+ *   review           ask first: two current decisions, a broken predicate
+ *                    (validUntil passed, the source file changed, the package
+ *                    moved), a contradiction of the decision's stance, or no
+ *                    current decision left
+ *   use_replacement  the action matched a superseded decision; use the
+ *                    current one instead
+ *   no_decision      nothing on the board speaks to it
+ *
+ * Exit codes, for scripts: 0 use or no_decision, 2 review, 3 use_replacement,
+ * 1 an error (no board, bad arguments).
+ *
+ * @packageDocumentation
+ */
+import { type CheckPrefixResult } from '@brainfile/core/memory';
+import type { CheckResult } from '@brainfile/core';
+import { type Logger } from '../utils/logger';
+export declare const CHECK_COMMAND_HELP: string;
+export interface CheckCommandOptions {
+    file?: string;
+    claimKey?: string;
+    claimKeyPrefix?: string;
+    json?: boolean;
+    /** The action, joined, or a decision ID. */
+    query?: string;
+}
+export type CheckCommandResult = (CheckResult & {
+    matchedBy: string;
+    exitCode: number;
+}) | (CheckPrefixResult & {
+    exitCode: number;
+});
+/** Run a check and print it. Sets `process.exitCode` from the verdict unless `setExitCode` is false. */
+export declare function checkCommand(options: CheckCommandOptions, logger?: Logger, setExitCode?: boolean): CheckCommandResult;
+//# sourceMappingURL=check.d.ts.map

package/dist/commands/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAK7D,eAAO,MAAM,kBAAkB,QAYmD,CAAC;AAEnF,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,kBAAkB,GAC1B,CAAC,WAAW,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GACvD,CAAC,iBAAiB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE/C,wGAAwG;AACxG,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,EAAE,MAAM,GAAE,MAAsB,EAAE,WAAW,UAAO,GAAG,kBAAkB,CA2BjI"}

package/dist/commands/check.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * `brainfile check`: is a decision on the board still safe to act on? (spec-11)
+ *
+ *   brainfile check "use axios for the retry client"
+ *   brainfile check decision-3
+ *   brainfile check --claim-key dependency.http-client
+ *   brainfile check --claim-key-prefix dependency "add axios"
+ *
+ * Finds the claim family the action touches (a decision ID, a claim key, or
+ * its words: the local index when there is one, a scan of the decisions
+ * when there is not) and answers in recoil's verdict order:
+ *
+ *   use              act on the current decision
+ *   review           ask first: two current decisions, a broken predicate
+ *                    (validUntil passed, the source file changed, the package
+ *                    moved), a contradiction of the decision's stance, or no
+ *                    current decision left
+ *   use_replacement  the action matched a superseded decision; use the
+ *                    current one instead
+ *   no_decision      nothing on the board speaks to it
+ *
+ * Exit codes, for scripts: 0 use or no_decision, 2 review, 3 use_replacement,
+ * 1 an error (no board, bad arguments).
+ *
+ * @packageDocumentation
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHECK_COMMAND_HELP = void 0;
+exports.checkCommand = checkCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const memory_1 = require("@brainfile/core/memory");
+const logger_1 = require("../utils/logger");
+const cli_error_1 = require("../utils/cli-error");
+const brainfile_path_1 = require("../utils/brainfile-path");
+const v2_only_1 = require("../utils/v2-only");
+exports.CHECK_COMMAND_HELP = `
+Examples:
+  brainfile check "use axios for the retry client"
+  brainfile check decision-3
+  brainfile check --claim-key dependency.http-client
+  brainfile check --claim-key-prefix dependency "add axios"
+  brainfile check "add axios" --json
+
+Verdicts: use (follow the current decision) · review (ask first) ·
+use_replacement (the decision you named was replaced) · no_decision.
+Name the subject next to the verb ("use axios", "drop axios") so the stance
+rule can catch a contradiction.
+Exit codes: 0 use or no_decision, 2 review, 3 use_replacement, 1 error.`.trimEnd();
+/** Run a check and print it. Sets `process.exitCode` from the verdict unless `setExitCode` is false. */
+function checkCommand(options, logger = logger_1.defaultLogger, setExitCode = true) {
+    const query = options.query?.trim() ?? '';
+    const claimKey = options.claimKey?.trim() ?? '';
+    const prefix = options.claimKeyPrefix?.trim() ?? '';
+    if (claimKey && prefix)
+        throw new cli_error_1.CLIError('choose --claim-key or --claim-key-prefix, not both');
+    if (!query && !claimKey && !prefix) {
+        throw new cli_error_1.CLIError('check needs an action, a decision ID, --claim-key or --claim-key-prefix', undefined, 'Usage: brainfile check "<action>" | <decision-id> | --claim-key <key> | --claim-key-prefix <prefix>');
+    }
+    const filePath = (0, brainfile_path_1.resolveCliBrainfilePath)(options.file);
+    (0, v2_only_1.assertV2Brainfile)(filePath);
+    let result;
+    if (prefix) {
+        const prefixResult = (0, memory_1.checkClaimKeyPrefix)(filePath, prefix, query ? { query } : {});
+        result = { ...prefixResult, exitCode: (0, memory_1.checkExitCode)(prefixResult.verdict) };
+    }
+    else {
+        const { matchedBy, result: single } = (0, memory_1.checkDecision)(filePath, { ...(query ? { query } : {}), ...(claimKey ? { claimKey } : {}) });
+        result = { ...single, matchedBy, exitCode: (0, memory_1.checkExitCode)(single.verdict) };
+    }
+    if (options.json)
+        logger.log(JSON.stringify(result, null, 2));
+    else if ('claimKeyPrefix' in result)
+        renderPrefix(result, logger);
+    else
+        renderSingle(result, logger);
+    if (setExitCode)
+        process.exitCode = result.exitCode;
+    return result;
+}
+const VERDICT_COLOR = {
+    use: chalk_1.default.green,
+    review: chalk_1.default.yellow,
+    use_replacement: chalk_1.default.cyan,
+    no_decision: chalk_1.default.gray,
+};
+function decisionLine(label, d) {
+    const facts = [d.status, d.stance && d.subject ? `${d.stance} ${d.subject}` : ''].filter(Boolean).join(' · ');
+    return `${chalk_1.default.bold(`${label}:`)} ${chalk_1.default.cyan(d.id)} ${d.title} ${chalk_1.default.gray(`(${facts})`)}`;
+}
+function renderSingle(result, logger) {
+    const color = VERDICT_COLOR[result.verdict] ?? ((s) => s);
+    logger.log(`${chalk_1.default.bold('Verdict:')} ${color(result.verdict)} ${chalk_1.default.gray(`· ${result.recommendation.replace(/_/g, ' ')} · ${result.reason.replace(/_/g, ' ')}`)}`);
+    if (result.verdict === 'no_decision' && !result.claimKey) {
+        logger.log(chalk_1.default.gray('No decision on the board speaks to this.'));
+        return;
+    }
+    if (result.claimKey)
+        logger.log(`${chalk_1.default.bold('Family:')} ${result.claimKey} ${chalk_1.default.gray(`(matched by ${result.matchedBy.replace('_', ' ')})`)}`);
+    if (result.current)
+        logger.log(decisionLine('Current', result.current));
+    if (result.matched && result.matched.id !== result.current?.id)
+        logger.log(decisionLine('Matched', result.matched));
+    if (result.replacement)
+        logger.log(decisionLine('Use instead', result.replacement));
+    if (result.requestedAction && result.requestedAction !== 'unknown') {
+        logger.log(`${chalk_1.default.bold('Your action:')} ${result.requestedAction.replace(/_/g, ' ')} ${chalk_1.default.gray(`(decision ${result.stance} ${result.subject})`)}`);
+    }
+    for (const p of result.predicates) {
+        const pc = p.status === 'broken' ? chalk_1.default.yellow : p.status === 'holds' ? chalk_1.default.green : chalk_1.default.gray;
+        const detail = [p.expected ? `wants ${p.expected}` : '', p.actual ? `found ${p.actual}` : ''].filter(Boolean).join(', ');
+        logger.log(`${chalk_1.default.bold(`${p.kind.replace(/_/g, ' ')}:`)} ${pc(p.status)} ${chalk_1.default.gray(`(${p.reason.replace(/_/g, ' ')}${detail ? `; ${detail}` : ''})`)}`);
+    }
+    if (result.advisory)
+        logger.log(`${chalk_1.default.bold('Holds while:')} ${result.advisory}`);
+    if (result.recheck)
+        logger.log(`${chalk_1.default.bold('Recheck:')} ${result.recheck}`);
+    const history = result.family.filter((d) => d.id !== result.current?.id && d.id !== result.matched?.id);
+    if (history.length > 0) {
+        logger.log(chalk_1.default.gray(`History: ${history.map((d) => `${d.id} (${d.status}${d.supersededBy ? ` by ${d.supersededBy}` : ''})`).join(', ')}`));
+    }
+}
+function renderPrefix(result, logger) {
+    const color = VERDICT_COLOR[result.verdict] ?? ((s) => s);
+    logger.log(`${chalk_1.default.bold('Verdict:')} ${color(result.verdict)} ${chalk_1.default.gray(`· ${result.familyCount} famil${result.familyCount === 1 ? 'y' : 'ies'} under ${result.claimKeyPrefix}${result.decidingClaimKey ? ` · decided by ${result.decidingClaimKey}` : ''}`)}`);
+    for (const family of result.families) {
+        const c = VERDICT_COLOR[family.verdict] ?? ((s) => s);
+        logger.log(`  ${c(family.verdict.padEnd(15))} ${family.claimKey} ${chalk_1.default.gray(`${family.current ? family.current.id : 'no current decision'} · ${family.reason.replace(/_/g, ' ')}`)}`);
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

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

package/dist/commands/columns.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `brainfile columns` (spec-13): the board's columns.
+ *
+ *   brainfile columns                              list them, with task counts
+ *   brainfile columns add "In Review" --after in-progress
+ *   brainfile columns rename in-review "Review"
+ *   brainfile columns reorder backlog todo in-progress review done
+ *   brainfile columns remove review --move-to in-progress
+ *
+ * The edits are core's (`addColumnFile` and friends), written through the
+ * board config writer; the MCP `columns` tool calls the same functions.
+ *
+ * @packageDocumentation
+ */
+import { type ColumnConfig, type ColumnSummary } from '@brainfile/core';
+import { type Logger } from '../utils/logger';
+export declare const COLUMNS_COMMAND_HELP: string;
+export interface ColumnsBaseOptions {
+    file?: string;
+    json?: boolean;
+}
+export interface ColumnsAddOptions extends ColumnsBaseOptions {
+    id?: string;
+    after?: string;
+    before?: string;
+    completion?: boolean;
+}
+export interface ColumnsRemoveOptions extends ColumnsBaseOptions {
+    moveTo?: string;
+}
+export interface ColumnsCommandResult {
+    success: true;
+    columns: ColumnSummary[];
+    column?: ColumnConfig;
+    moved?: string[];
+    movedTo?: ColumnConfig;
+}
+/** `columns` / `columns list`: every column, in order, with its task count. */
+export declare function columnsListCommand(options: ColumnsBaseOptions, logger?: Logger): ColumnsCommandResult;
+/** `columns add <title>`: a new column, last unless --after or --before. */
+export declare function columnsAddCommand(title: string | undefined, options: ColumnsAddOptions, logger?: Logger): ColumnsCommandResult;
+/** `columns rename <column> <title>`: a new title; the ID, and the tasks, stay. */
+export declare function columnsRenameCommand(column: string | undefined, title: string | undefined, options: ColumnsBaseOptions, logger?: Logger): ColumnsCommandResult;
+/** `columns reorder <column...>`: the ones named first, the rest after in their order. */
+export declare function columnsReorderCommand(order: string[] | undefined, options: ColumnsBaseOptions, logger?: Logger): ColumnsCommandResult;
+/** `columns remove <column> [--move-to <column>]`. */
+export declare function columnsRemoveCommand(column: string | undefined, options: ColumnsRemoveOptions, logger?: Logger): ColumnsCommandResult;
+//# sourceMappingURL=columns.d.ts.map

package/dist/commands/columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.d.ts","sourceRoot":"","sources":["../../src/commands/columns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAML,KAAK,YAAY,EACjB,KAAK,aAAa,EAEnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAM7D,eAAO,MAAM,oBAAoB,QAWsB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AA8CD,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,GAAE,MAAsB,GAAG,oBAAoB,CAGpH;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,GAAE,MAAsB,GAAG,oBAAoB,CAW7I;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,GAAE,MAAsB,GAAG,oBAAoB,CAK7K;AAED,0FAA0F;AAC1F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,GAAE,MAAsB,GAAG,oBAAoB,CAIpJ;AAED,sDAAsD;AACtD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,GAAE,MAAsB,GAAG,oBAAoB,CAUpJ"}

package/dist/commands/columns.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * `brainfile columns` (spec-13): the board's columns.
+ *
+ *   brainfile columns                              list them, with task counts
+ *   brainfile columns add "In Review" --after in-progress
+ *   brainfile columns rename in-review "Review"
+ *   brainfile columns reorder backlog todo in-progress review done
+ *   brainfile columns remove review --move-to in-progress
+ *
+ * The edits are core's (`addColumnFile` and friends), written through the
+ * board config writer; the MCP `columns` tool calls the same functions.
+ *
+ * @packageDocumentation
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COLUMNS_COMMAND_HELP = void 0;
+exports.columnsListCommand = columnsListCommand;
+exports.columnsAddCommand = columnsAddCommand;
+exports.columnsRenameCommand = columnsRenameCommand;
+exports.columnsReorderCommand = columnsReorderCommand;
+exports.columnsRemoveCommand = columnsRemoveCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const core_1 = require("@brainfile/core");
+const logger_1 = require("../utils/logger");
+const cli_error_1 = require("../utils/cli-error");
+const errorHandler_1 = require("../utils/errorHandler");
+const brainfile_path_1 = require("../utils/brainfile-path");
+const v2_only_1 = require("../utils/v2-only");
+exports.COLUMNS_COMMAND_HELP = `
+Examples:
+  brainfile columns                                   List them, with task counts
+  brainfile columns add "In Review" --after in-progress
+  brainfile columns add Shipped --completion          Tasks moved there are completed
+  brainfile columns rename in-review Review           The ID stays, so its tasks stay
+  brainfile columns reorder backlog todo in-progress  The ones named first, the rest after
+  brainfile columns remove review --move-to in-progress
+
+Columns are named by ID or title. remove refuses a column that still holds
+tasks unless --move-to says where they go; they move there without being
+completed. The last column is never removed.`.trimEnd();
+function boardPath(file) {
+    const filePath = (0, brainfile_path_1.resolveCliBrainfilePath)(file);
+    (0, v2_only_1.assertV2Brainfile)(filePath);
+    return filePath;
+}
+function unwrap(result, hint) {
+    if (!result.success || !result.columns) {
+        throw new cli_error_1.CLIError(result.error ?? 'The columns were not changed', errorHandler_1.ExitCode.USER_ERROR, hint);
+    }
+    return {
+        success: true,
+        columns: result.columns,
+        ...(result.column ? { column: result.column } : {}),
+        ...(result.moved ? { moved: result.moved } : {}),
+        ...(result.movedTo ? { movedTo: result.movedTo } : {}),
+    };
+}
+function printColumns(columns, logger) {
+    const idWidth = Math.max('ID'.length, ...columns.map((c) => c.id.length));
+    const titleWidth = Math.max('TITLE'.length, ...columns.map((c) => c.title.length));
+    logger.log(chalk_1.default.gray(`  ${'ID'.padEnd(idWidth)}  ${'TITLE'.padEnd(titleWidth)}  TASKS`));
+    for (const column of columns) {
+        const count = String(column.taskCount).padEnd(5);
+        const note = column.completionColumn ? chalk_1.default.gray('  completion column') : '';
+        logger.log(`  ${column.id.padEnd(idWidth)}  ${column.title.padEnd(titleWidth)}  ${count}${note}`.trimEnd());
+    }
+}
+function report(result, options, headline, logger) {
+    if (options.json) {
+        const { success: _success, ...payload } = result;
+        logger.log(JSON.stringify(payload, null, 2));
+        return result;
+    }
+    if (headline) {
+        logger.log(chalk_1.default.green(headline));
+        logger.log('');
+    }
+    printColumns(result.columns, logger);
+    return result;
+}
+/** `columns` / `columns list`: every column, in order, with its task count. */
+function columnsListCommand(options, logger = logger_1.defaultLogger) {
+    const result = unwrap((0, core_1.listColumnsFile)(boardPath(options.file)));
+    return report(result, options, null, logger);
+}
+/** `columns add <title>`: a new column, last unless --after or --before. */
+function columnsAddCommand(title, options, logger = logger_1.defaultLogger) {
+    if (!title?.trim())
+        throw (0, cli_error_1.missingRequired)('<title>', 'brainfile columns add <title> [--id <id>] [--after <column> | --before <column>] [--completion]');
+    const result = unwrap((0, core_1.addColumnFile)(boardPath(options.file), {
+        title,
+        ...(options.id ? { id: options.id } : {}),
+        ...(options.after ? { after: options.after } : {}),
+        ...(options.before ? { before: options.before } : {}),
+        ...(options.completion ? { completionColumn: true } : {}),
+    }));
+    const column = result.column;
+    return report(result, options, `Added column ${column.id} (${column.title}).`, logger);
+}
+/** `columns rename <column> <title>`: a new title; the ID, and the tasks, stay. */
+function columnsRenameCommand(column, title, options, logger = logger_1.defaultLogger) {
+    if (!column?.trim() || !title?.trim())
+        throw (0, cli_error_1.missingRequired)('<column> and <title>', 'brainfile columns rename <column> <title>');
+    const result = unwrap((0, core_1.renameColumnFile)(boardPath(options.file), column, title));
+    const renamed = result.column;
+    return report(result, options, `Renamed column ${renamed.id} to ${renamed.title}.`, logger);
+}
+/** `columns reorder <column...>`: the ones named first, the rest after in their order. */
+function columnsReorderCommand(order, options, logger = logger_1.defaultLogger) {
+    if (!order || order.length === 0)
+        throw (0, cli_error_1.missingRequired)('<columns...>', 'brainfile columns reorder <column> [column...]');
+    const result = unwrap((0, core_1.reorderColumnsFile)(boardPath(options.file), order));
+    return report(result, options, 'Columns reordered.', logger);
+}
+/** `columns remove <column> [--move-to <column>]`. */
+function columnsRemoveCommand(column, options, logger = logger_1.defaultLogger) {
+    if (!column?.trim())
+        throw (0, cli_error_1.missingRequired)('<column>', 'brainfile columns remove <column> [--move-to <column>]');
+    const raw = (0, core_1.removeColumnFile)(boardPath(options.file), column, options.moveTo ? { moveTo: options.moveTo } : {});
+    const holdsTasks = !raw.success && !options.moveTo && /holds \d+ task/.test(raw.error ?? '');
+    const result = unwrap(raw, holdsTasks ? `To move them first: brainfile columns remove ${column} --move-to <column>` : undefined);
+    const removed = result.column;
+    const moved = result.moved && result.moved.length > 0 && result.movedTo
+        ? `; moved ${result.moved.join(', ')} to ${result.movedTo.id}`
+        : '';
+    return report(result, options, `Removed column ${removed.id}${moved}.`, logger);
+}
+//# sourceMappingURL=columns.js.map

package/dist/commands/columns.js.map

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

package/dist/commands/complete.js

@@ -87,20 +87,25 @@ function completeV2(filePath, taskId, force, logger) {
     }
     const { doc, filePath: taskPath } = found;
     const task = doc.task;
-    const result = (0, core_1.completeTaskFile)(taskPath, dirs.logsDir, { force });
+    const types = (0, core_1.readBoardConfig)(filePath)?.config.types;
+    const typeName = (0, core_1.resolveDocType)(task.type, types).name;
+    const label = typeName.charAt(0).toUpperCase() + typeName.slice(1);
+    // Any parent with open children refuses, not only an epic (spec-12);
+    // a decision is never completed.
+    const result = (0, core_1.completeTaskFile)(taskPath, dirs.logsDir, { force, types });
     if (!result.success) {
         if (result.incompleteChildren?.length) {
-            logger.warn(chalk_1.default.yellow(`Epic ${taskId} has incomplete child tasks:`));
+            logger.warn(chalk_1.default.yellow(`${label} ${taskId} has incomplete child tasks:`));
             for (const child of result.incompleteChildren) {
                 logger.warn(chalk_1.default.yellow(`  - ${child.id}: ${child.title}`));
             }
             logger.warn(chalk_1.default.yellow('Aborting completion. Re-run with --force to override.'));
-            throw (0, cli_error_1.operationFailed)(`Epic ${taskId} has ${result.incompleteChildren.length} incomplete child task(s). Use --force to override.`);
+            throw (0, cli_error_1.operationFailed)(`${label} ${taskId} has ${result.incompleteChildren.length} incomplete child task(s). Use --force to override.`);
         }
         throw (0, cli_error_1.operationFailed)(result.error || `Failed to complete task: ${taskId}`);
     }
     if (result.incompleteChildren?.length) {
-        logger.warn(chalk_1.default.yellow(`Completing epic ${taskId} with --force despite ${result.incompleteChildren.length} incomplete child task(s).`));
+        logger.warn(chalk_1.default.yellow(`Completing ${typeName} ${taskId} with --force despite ${result.incompleteChildren.length} incomplete child task(s).`));
     }
     const completedAt = result.task?.completedAt ?? new Date().toISOString();
     logger.log(chalk_1.default.green('Task completed!'));

package/dist/commands/complete.js.map

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