brainfile 0.21.2 → 0.22.1

package/dist/mcp/tools/board_tool.js.map

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

package/dist/mcp/tools/brief_tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brief_tool.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/brief_tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAS9D;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAmD9E"}
+{"version":3,"file":"brief_tool.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/brief_tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAU9D;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA0D9E"}

package/dist/mcp/tools/brief_tool.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerBriefTool = registerBriefTool;
 const zod_1 = require("zod");
 const core_1 = require("@brainfile/core");
+const memory_1 = require("@brainfile/core/memory");
 const v2_detect_1 = require("../../utils/v2-detect");
 const helpers_1 = require("../helpers");
 const schemas_1 = require("../schemas");
@@ -55,16 +56,19 @@ const path = __importStar(require("path"));
 function registerBriefTool(server, defaultFile) {
     server.registerTool('brief', {
         title: 'Agent Brief',
-        description: 'Get a per-agent brief: what changed on the board since this agent last checked in. '
-            + 'First call returns a full orientation; later calls return only what is new.',
+        description: 'Get a per-agent brief. text is a budgeted block (maxChars, default 1600) for a session start: '
+            + '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 last checked in, and the docs that bear on them. '
+            + 'sections holds the same lanes as data; lanes holds the checkpoint view (first call: full orientation; later: only what is new).',
         inputSchema: zod_1.z.object({
             file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
             agent: zod_1.z.string().describe('Agent identifier (required — brief state is per-agent)'),
             peek: zod_1.z.boolean().optional().describe('Read the brief without marking it as seen'),
             offline: zod_1.z.boolean().optional().describe('Skip syncing a shared board before the brief'),
+            maxChars: zod_1.z.number().int().min(0).optional().describe('Character budget for text (default 1600; 0 for no limit)'),
         }),
         outputSchema: schemas_1.briefOutputSchema,
-    }, async ({ file, agent, peek, offline }) => {
+    }, async ({ file, agent, peek, offline, maxChars }) => {
         const filePath = file || defaultFile;
         const guard = (0, helpers_1.requireV2)(filePath);
         if (guard)
@@ -82,11 +86,15 @@ function registerBriefTool(server, defaultFile) {
         const dirs = (0, v2_detect_1.getV2Dirs)(resolvedPath);
         const isPeek = peek === true;
         const state = (0, core_1.readBriefState)(resolvedPath, agentName);
-        const result = (0, core_1.buildBrief)(dirs, agentName, { lastBriefAt: state.lastBriefAt });
+        const result = (0, memory_1.composeBrief)(dirs, agentName, {
+            lastBriefAt: state.lastBriefAt,
+            ...(maxChars !== undefined ? { maxChars } : {}),
+        });
         if (!isPeek) {
             (0, core_1.writeBriefState)(resolvedPath, agentName, result.generatedAt);
         }
-        const output = { ...result, peek: isPeek };
+        const { docsMode: _docsMode, ...rest } = result;
+        const output = { ...rest, peek: isPeek };
         return {
             content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
             structuredContent: output,

package/dist/mcp/tools/brief_tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"brief_tool.js","sourceRoot":"","sources":["../../../src/mcp/tools/brief_tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,8CAmDC;AAtED,6BAAwB;AACxB,0CAA8E;AAC9E,qDAAkD;AAClD,wCAAyD;AACzD,wCAA+C;AAC/C,uDAAmD;AACnD,2CAA6B;AAE7B;;;;;;;;;;GAUG;AACH,SAAgB,iBAAiB,CAAC,MAAiB,EAAE,WAAmB;IACtE,MAAM,CAAC,YAAY,CACjB,OAAO,EACP;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,qFAAqF;cACnF,6EAA6E;QACjF,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;YACpF,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;YACpF,IAAI,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YAClF,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;SACzF,CAAC;QACF,YAAY,EAAE,2BAAiB;KAChC,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QACvC,MAAM,QAAQ,GAAG,IAAI,IAAI,WAAW,CAAC;QAErC,MAAM,KAAK,GAAG,IAAA,mBAAS,EAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QAExB,MAAM,SAAS,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;gBACtE,OAAO,EAAE,IAAa;aACvB,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,IAAA,0BAAgB,EAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO;YAAE,IAAA,sBAAS,EAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QAEpD,MAAM,IAAI,GAAG,IAAA,qBAAS,EAAC,YAAY,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;QAE7B,MAAM,KAAK,GAAG,IAAA,qBAAc,EAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,IAAA,iBAAU,EAAC,IAAI,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAE/E,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAA,sBAAe,EAAC,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAE3C,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAC3E,iBAAiB,EAAE,MAAM;SAC1B,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"brief_tool.js","sourceRoot":"","sources":["../../../src/mcp/tools/brief_tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools/check_tool.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+/**
+ * `check`: is a decision still safe to act on? Read-only.
+ */
+export declare function registerCheckTool(server: McpServer, defaultFile: string): void;
+//# sourceMappingURL=check_tool.d.ts.map

package/dist/mcp/tools/check_tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check_tool.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/check_tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAM9D;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA6C9E"}

package/dist/mcp/tools/check_tool.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCheckTool = registerCheckTool;
+const zod_1 = require("zod");
+const memory_1 = require("@brainfile/core/memory");
+const helpers_1 = require("../helpers");
+const schemas_1 = require("../schemas");
+/**
+ * `check`: is a decision still safe to act on? Read-only.
+ */
+function registerCheckTool(server, defaultFile) {
+    server.registerTool('check', {
+        title: 'Check Decision',
+        description: 'Before acting, check whether a decision on the board speaks to it and still holds. Give an action in words, naming the subject right after the verb so a contradiction of the decision\'s stance is caught ("use axios for retries", "drop axios"), a decision ID, a claimKey, or a claimKeyPrefix (every family under it; the verdict is the worst). Verdicts: use (follow the current decision, which is returned), review (ask first: two current decisions, a broken predicate such as validUntil passed or a source file changed or a package version moved, or an action that contradicts the decision\'s stance on its subject), use_replacement (the action matched a superseded decision; use the current one), no_decision (nothing speaks to it). exitCode mirrors the CLI: 0 use/no_decision, 2 review, 3 use_replacement.',
+        inputSchema: zod_1.z.object({
+            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
+            query: zod_1.z.string().optional().describe('The action in words, or a decision ID'),
+            claimKey: zod_1.z.string().optional().describe('Check one claim family exactly'),
+            claimKeyPrefix: zod_1.z.string().optional().describe('Check every claim family under a prefix (not with claimKey)'),
+        }),
+        outputSchema: schemas_1.checkOutputSchema,
+    }, async ({ file, query, claimKey, claimKeyPrefix }) => {
+        const filePath = file || defaultFile;
+        const guard = (0, helpers_1.requireV2)(filePath);
+        if (guard)
+            return guard;
+        const q = query?.trim() ?? '';
+        const key = claimKey?.trim() ?? '';
+        const prefix = claimKeyPrefix?.trim() ?? '';
+        if (key && prefix) {
+            return { content: [{ type: 'text', text: 'Error: choose claimKey or claimKeyPrefix, not both' }], isError: true };
+        }
+        if (!q && !key && !prefix) {
+            return { content: [{ type: 'text', text: 'Error: give a query (an action or a decision ID), claimKey or claimKeyPrefix' }], isError: true };
+        }
+        const resolved = (0, helpers_1.resolveBrainfile)(filePath);
+        if (prefix) {
+            const result = (0, memory_1.checkClaimKeyPrefix)(resolved, prefix, q ? { query: q } : {});
+            const output = { ...result, exitCode: (0, memory_1.checkExitCode)(result.verdict) };
+            return {
+                content: [{ type: 'text', text: `${output.verdict} (${output.familyCount} families under ${output.claimKeyPrefix})\n\n${JSON.stringify(output, null, 2)}` }],
+                structuredContent: output,
+            };
+        }
+        const { matchedBy, result } = (0, memory_1.checkDecision)(resolved, { ...(q ? { query: q } : {}), ...(key ? { claimKey: key } : {}) });
+        const output = { ...result, matchedBy, exitCode: (0, memory_1.checkExitCode)(result.verdict) };
+        const head = `${output.verdict}: ${output.recommendation} (${output.reason})${output.current ? ` · current ${output.current.id}: ${output.current.title}` : ''}`;
+        return {
+            content: [{ type: 'text', text: `${head}\n\n${JSON.stringify(output, null, 2)}` }],
+            structuredContent: output,
+        };
+    });
+}
+//# sourceMappingURL=check_tool.js.map

package/dist/mcp/tools/check_tool.js.map

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

package/dist/mcp/tools/columns_tool.d.ts

@@ -0,0 +1,7 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+/**
+ * `columns`: the board's columns, like `brainfile columns`. The same core
+ * operations write the config; one board commit per change.
+ */
+export declare function registerColumnsTool(server: McpServer, defaultFile: string): void;
+//# sourceMappingURL=columns_tool.d.ts.map

package/dist/mcp/tools/columns_tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns_tool.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/columns_tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AA+B9D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAkEhF"}

package/dist/mcp/tools/columns_tool.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerColumnsTool = registerColumnsTool;
+const zod_1 = require("zod");
+const core_1 = require("@brainfile/core");
+const helpers_1 = require("../helpers");
+const schemas_1 = require("../schemas");
+function headline(action, result) {
+    const column = result.column;
+    switch (action) {
+        case 'add': return `Added column ${column.id} (${column.title})`;
+        case 'rename': return `Renamed column ${column.id} to ${column.title}`;
+        case 'reorder': return 'Columns reordered';
+        case 'remove': {
+            const moved = result.moved && result.moved.length > 0 && result.movedTo
+                ? `; moved ${result.moved.join(', ')} to ${result.movedTo.id}`
+                : '';
+            return `Removed column ${column.id}${moved}`;
+        }
+        default: return 'Columns';
+    }
+}
+/**
+ * `columns`: the board's columns, like `brainfile columns`. The same core
+ * operations write the config; one board commit per change.
+ */
+function registerColumnsTool(server, defaultFile) {
+    server.registerTool('columns', {
+        title: 'Columns',
+        description: 'The board\'s columns. action=list (in order, with task counts), add (title; id defaults from the title; after or before another column; completion for a column whose tasks are done), rename (column, title: the ID stays, so its tasks stay), reorder (order: the columns named come first, the rest after), remove (column; one that holds tasks is refused unless moveTo names the column they go to, where they land uncompleted; the last column is never removed). Columns are named by ID or title.',
+        inputSchema: zod_1.z.object({
+            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
+            action: zod_1.z.enum(['list', 'add', 'rename', 'reorder', 'remove']).optional().describe('Default list'),
+            column: zod_1.z.string().optional().describe('rename, remove: the column (ID or title)'),
+            title: zod_1.z.string().optional().describe('add, rename: the title'),
+            id: zod_1.z.string().optional().describe('add: the column ID (default: from the title, "In Review" → in-review)'),
+            after: zod_1.z.string().optional().describe('add: place it after this column'),
+            before: zod_1.z.string().optional().describe('add: place it before this column'),
+            completion: zod_1.z.boolean().optional().describe('add: tasks moved into it are completed (completionColumn)'),
+            order: zod_1.z.array(zod_1.z.string()).optional().describe('reorder: columns in their new order (the rest follow)'),
+            moveTo: zod_1.z.string().optional().describe('remove: move the column\'s tasks here first'),
+        }),
+        outputSchema: schemas_1.columnsOutputSchema,
+    }, (0, helpers_1.withBoardCommit)('columns', defaultFile, async (input) => {
+        const filePath = input.file || defaultFile;
+        const guard = (0, helpers_1.requireV2)(filePath);
+        if (guard)
+            return guard;
+        const resolved = (0, helpers_1.resolveBrainfile)(filePath);
+        const action = input.action ?? 'list';
+        let result;
+        switch (action) {
+            case 'add':
+                if (!input.title?.trim())
+                    return (0, helpers_1.mcpError)('add needs a title');
+                result = (0, core_1.addColumnFile)(resolved, {
+                    title: input.title,
+                    ...(input.id ? { id: input.id } : {}),
+                    ...(input.after ? { after: input.after } : {}),
+                    ...(input.before ? { before: input.before } : {}),
+                    ...(input.completion ? { completionColumn: true } : {}),
+                });
+                break;
+            case 'rename':
+                if (!input.column?.trim() || !input.title?.trim())
+                    return (0, helpers_1.mcpError)('rename needs a column and a title');
+                result = (0, core_1.renameColumnFile)(resolved, input.column, input.title);
+                break;
+            case 'reorder':
+                if (!input.order || input.order.length === 0)
+                    return (0, helpers_1.mcpError)('reorder needs order: the columns in their new order');
+                result = (0, core_1.reorderColumnsFile)(resolved, input.order);
+                break;
+            case 'remove':
+                if (!input.column?.trim())
+                    return (0, helpers_1.mcpError)('remove needs a column');
+                result = (0, core_1.removeColumnFile)(resolved, input.column, input.moveTo ? { moveTo: input.moveTo } : {});
+                break;
+            default:
+                result = (0, core_1.listColumnsFile)(resolved);
+        }
+        if (!result.success || !result.columns)
+            return (0, helpers_1.mcpError)(result.error ?? 'the columns were not changed');
+        const output = {
+            action,
+            columns: result.columns,
+            ...(result.column ? { column: result.column } : {}),
+            ...(result.moved ? { moved: result.moved } : {}),
+            ...(result.movedTo ? { movedTo: result.movedTo } : {}),
+        };
+        return (0, helpers_1.mcpResult)(`${headline(action, result)}\n\n${JSON.stringify(output, null, 2)}`, output);
+    }));
+}
+//# sourceMappingURL=columns_tool.js.map

package/dist/mcp/tools/columns_tool.js.map

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

package/dist/mcp/tools/decide_tool.d.ts

@@ -0,0 +1,91 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+import { z } from 'zod';
+import { type DecideResult } from '@brainfile/core';
+/** The decide/supersede input fields both tools share. */
+export declare const decisionInputShape: {
+    file: z.ZodOptional<z.ZodString>;
+    text: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        decision: "decision";
+        constraint: "constraint";
+        preference: "preference";
+        rule: "rule";
+    }>>;
+    stance: z.ZodOptional<z.ZodEnum<{
+        prefers: "prefers";
+        rejects: "rejects";
+        requires: "requires";
+        forbids: "forbids";
+    }>>;
+    subject: z.ZodOptional<z.ZodString>;
+    holdsWhile: z.ZodOptional<z.ZodString>;
+    recheck: z.ZodOptional<z.ZodString>;
+    validUntil: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+    package: z.ZodOptional<z.ZodString>;
+    forWork: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+};
+export interface DecisionToolInput {
+    file?: string;
+    text: string;
+    title?: string;
+    kind?: string;
+    stance?: string;
+    subject?: string;
+    holdsWhile?: string;
+    recheck?: string;
+    validUntil?: string;
+    source?: string;
+    package?: string;
+    forWork?: string[];
+    tags?: string[];
+    claimKey?: string;
+}
+/** Tool input → core input. A relative `source` is relative to the project root. */
+export declare function decideInputFrom(input: DecisionToolInput, projectRoot: string): {
+    tags?: string[] | undefined;
+    forWork?: string[] | undefined;
+    packageVersion?: string | undefined;
+    sourcePath?: string | undefined;
+    validUntil?: string | undefined;
+    recheck?: string | undefined;
+    holdsWhile?: string | undefined;
+    subject?: string | undefined;
+    stance?: string | undefined;
+    kind?: string | undefined;
+    title?: string | undefined;
+    claimKey?: string | undefined;
+    text: string;
+};
+/** A core decide result as the tool's text and structured content. */
+export declare function decideToolResult(result: DecideResult, verb: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+    structuredContent?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        decision: import("@brainfile/core").DecisionSummary;
+        duplicate: boolean;
+        superseded: string[];
+        familyWasEmpty: boolean;
+        related: import("@brainfile/core").RelatedClaim[];
+        linked: string[];
+        notFound: string[];
+    };
+    isError?: undefined;
+};
+/**
+ * `decide`: record a decision in its claim family. The family's current
+ * decision is superseded (status, links both ways, moved to logs/).
+ */
+export declare function registerDecideTool(server: McpServer, defaultFile: string): void;
+//# sourceMappingURL=decide_tool.d.ts.map

package/dist/mcp/tools/decide_tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide_tool.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/decide_tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAuE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAMzH,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;CAc9B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM;;;;;;;;;;;;;;EAgB5E;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;EAwBlE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA+B/E"}

package/dist/mcp/tools/decide_tool.js

@@ -0,0 +1,141 @@
+"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.decisionInputShape = void 0;
+exports.decideInputFrom = decideInputFrom;
+exports.decideToolResult = decideToolResult;
+exports.registerDecideTool = registerDecideTool;
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const core_1 = require("@brainfile/core");
+const v2_detect_1 = require("../../utils/v2-detect");
+const actor_1 = require("../../utils/actor");
+const helpers_1 = require("../helpers");
+const schemas_1 = require("../schemas");
+/** The decide/supersede input fields both tools share. */
+exports.decisionInputShape = {
+    file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
+    text: zod_1.z.string().describe('The decision and why. The first line becomes the title unless title is given'),
+    title: zod_1.z.string().optional().describe('Title (default: the first line of text)'),
+    kind: zod_1.z.enum(['decision', 'preference', 'constraint', 'rule']).optional().describe('How firmly it binds (default decision)'),
+    stance: zod_1.z.enum(['prefers', 'rejects', 'requires', 'forbids']).optional().describe('What it says about subject; give both or neither. check reads them'),
+    subject: zod_1.z.string().optional().describe('What the stance is about: a package, a pattern, a tool'),
+    holdsWhile: zod_1.z.string().optional().describe('The condition under which it holds'),
+    recheck: zod_1.z.string().optional().describe('When or why to look at it again'),
+    validUntil: zod_1.z.string().optional().describe('Date after which it needs a look (YYYY-MM-DD)'),
+    source: zod_1.z.string().optional().describe('A file it rests on, relative to the project root; its sha256 is recorded'),
+    package: zod_1.z.string().optional().describe('A package version it rests on: name<op>version, e.g. zod>=4.3 or engines.node>=20'),
+    forWork: zod_1.z.array(zod_1.z.string()).optional().describe('IDs of work that rests on it (each gets it in decisions:)'),
+    tags: zod_1.z.array(zod_1.z.string()).optional().describe('Tags'),
+};
+/** Tool input → core input. A relative `source` is relative to the project root. */
+function decideInputFrom(input, projectRoot) {
+    return {
+        text: input.text,
+        ...(input.claimKey !== undefined ? { claimKey: input.claimKey } : {}),
+        ...(input.title ? { title: input.title } : {}),
+        ...(input.kind ? { kind: input.kind } : {}),
+        ...(input.stance ? { stance: input.stance } : {}),
+        ...(input.subject ? { subject: input.subject } : {}),
+        ...(input.holdsWhile ? { holdsWhile: input.holdsWhile } : {}),
+        ...(input.recheck ? { recheck: input.recheck } : {}),
+        ...(input.validUntil ? { validUntil: input.validUntil } : {}),
+        ...(input.source ? { sourcePath: path.resolve(projectRoot, input.source) } : {}),
+        ...(input.package ? { packageVersion: input.package } : {}),
+        ...(input.forWork ? { forWork: input.forWork } : {}),
+        ...(input.tags ? { tags: input.tags } : {}),
+    };
+}
+/** A core decide result as the tool's text and structured content. */
+function decideToolResult(result, verb) {
+    if (!result.success || !result.decision) {
+        return { content: [{ type: 'text', text: `Error: ${result.error ?? 'the decision was not written'}` }], isError: true };
+    }
+    const output = {
+        decision: (0, core_1.summarizeDecision)(result.decision),
+        duplicate: result.duplicate === true,
+        superseded: result.superseded.map((t) => t.id),
+        familyWasEmpty: result.familyWasEmpty,
+        related: result.related,
+        linked: result.linked,
+        notFound: result.notFound,
+    };
+    const lines = [
+        result.duplicate
+            ? `Already current: ${output.decision.id} (${output.decision.title})`
+            : `${verb} ${output.decision.id}${output.decision.claimKey ? ` [${output.decision.claimKey}]` : ''}: ${output.decision.title}`,
+        ...output.superseded.map((id) => `Superseded ${id} (moved to logs/)`),
+        ...output.related.map((r) => `Related family: ${r.claimKey} (${r.id}) ${r.title}`),
+    ];
+    return {
+        content: [{ type: 'text', text: `${lines.join('\n')}\n\n${JSON.stringify(output, null, 2)}` }],
+        structuredContent: output,
+    };
+}
+/**
+ * `decide`: record a decision in its claim family. The family's current
+ * decision is superseded (status, links both ways, moved to logs/).
+ */
+function registerDecideTool(server, defaultFile) {
+    server.registerTool('decide', {
+        title: 'Decide',
+        description: 'Record a decision (a standing choice) in its claim family. A family has one current decision: when it already has one, that one is superseded (status, supersedes/supersededBy both ways, moved to logs/). Re-deciding the same words changes nothing (duplicate). When the family was empty, related families that may say the same thing are returned. stance+subject let check catch actions that contradict it; validUntil, source and package are predicates check evaluates.',
+        inputSchema: zod_1.z.object({
+            claimKey: zod_1.z.string().describe('Dotted claim family, e.g. dependency.http-client'),
+            ...exports.decisionInputShape,
+            noSupersede: zod_1.z.boolean().optional().describe('Keep the family\'s current decision current too (check will say review)'),
+        }),
+        outputSchema: schemas_1.decideOutputSchema,
+    }, (0, helpers_1.withBoardCommit)('decide', defaultFile, async (input) => {
+        const filePath = input.file || defaultFile;
+        const guard = (0, helpers_1.requireV2)(filePath);
+        if (guard)
+            return guard;
+        const resolved = (0, helpers_1.resolveBrainfile)(filePath);
+        const projectRoot = path.dirname(path.dirname(resolved));
+        const coreInput = decideInputFrom(input, projectRoot);
+        const invalid = (0, core_1.validateDecideInput)(coreInput, { requireClaimKey: true });
+        if (invalid)
+            return { content: [{ type: 'text', text: `Error: ${invalid}` }], isError: true };
+        const agent = (0, actor_1.detectAgent)()?.name;
+        const result = (0, core_1.decideFile)((0, v2_detect_1.ensureV2Dirs)(resolved), coreInput, {
+            types: (0, core_1.readBoardConfig)(resolved)?.config.types,
+            noSupersede: input.noSupersede === true,
+            ...(agent ? { agent } : {}),
+        });
+        return decideToolResult(result, 'Decided');
+    }));
+}
+//# sourceMappingURL=decide_tool.js.map

package/dist/mcp/tools/decide_tool.js.map

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

package/dist/mcp/tools/get_task_tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get_task_tool.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/get_task_tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAM9D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAqChF"}
+{"version":3,"file":"get_task_tool.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/get_task_tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAU9D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA2DhF"}

package/dist/mcp/tools/get_task_tool.js

@@ -1,17 +1,54 @@
 "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.registerGetTaskTool = registerGetTaskTool;
+const path = __importStar(require("path"));
 const zod_1 = require("zod");
+const core_1 = require("@brainfile/core");
+const repo_1 = require("@brainfile/core/repo");
 const v2_detect_1 = require("../../utils/v2-detect");
+const related_1 = require("../../utils/related");
 const helpers_1 = require("../helpers");
 const schemas_1 = require("../schemas");
 function registerGetTaskTool(server, defaultFile) {
     server.registerTool('get_task', {
         title: 'Get Task',
-        description: 'Get detailed information about a specific task by ID',
+        description: 'Get detailed information about a specific task by ID, with its place in the graph (graph: type, parent, children, the decisions it rests on and whether any is superseded; for a decision, the work resting on it). A task on a related board (related: in brainfile.md) is alias:task-id; it is read-only from here.',
         inputSchema: zod_1.z.object({
             file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
-            task: zod_1.z.string().describe('Task ID to retrieve')
+            task: zod_1.z.string().describe('Task ID to retrieve, or alias:task-id for a task on a related board')
         }),
         outputSchema: schemas_1.getTaskOutputSchema
     }, async ({ file, task }) => {
@@ -19,18 +56,39 @@ function registerGetTaskTool(server, defaultFile) {
         const guard = (0, helpers_1.requireV2)(filePath);
         if (guard)
             return guard;
-        const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
-        const found = (0, v2_detect_1.findV2Task)(dirs, task, true);
+        let boardFile = path.resolve(filePath);
+        let taskId = task;
+        let alias;
+        if ((0, core_1.isQualifiedRef)(task)) {
+            const target = (0, related_1.resolveRelatedTask)(boardFile, task);
+            if (!target.ok) {
+                const details = target.details ? `\n${target.details}` : '';
+                return { content: [{ type: 'text', text: `Error: ${target.message}${details}` }], isError: true };
+            }
+            boardFile = target.board.brainfilePath;
+            taskId = target.id;
+            alias = target.board.alias;
+        }
+        const dirs = (0, v2_detect_1.getV2Dirs)(boardFile);
+        const found = (0, v2_detect_1.findV2Task)(dirs, taskId, true);
         if (!found) {
             return { content: [{ type: 'text', text: `Error: Task not found: ${task}` }], isError: true };
         }
         const { doc, isLog } = found;
         const description = (0, v2_detect_1.extractDescription)(doc.body);
+        const hasDeps = Array.isArray(doc.task.dependsOn) && doc.task.dependsOn.length > 0;
+        const rel = hasDeps ? (0, repo_1.relatedBoards)(boardFile) : null;
         const output = {
             ...doc.task,
             ...(description && !doc.task.description && { description }),
             column: isLog ? 'Completed' : (doc.task.column || 'unknown'),
             ...(isLog && { archived: true }),
+            ...(alias && { board: alias, ref: `${alias}:${doc.task.id}` }),
+            ...(rel && {
+                dependencies: rel.dependencies(doc.task).map((d) => ({ ref: d.ref, state: d.state, done: d.done })),
+                blocked: !isLog && rel.blockers(doc.task).length > 0,
+            }),
+            graph: (0, core_1.docPlace)((0, core_1.readBoardGraph)(boardFile).graph, doc.task.id),
         };
         return {
             content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],