brainfile 0.21.2 → 0.22.1

package/dist/mcp/tools/task_patch_tool.js

@@ -44,7 +44,7 @@ const schemas_1 = require("../schemas");
 function registerTaskPatchTool(server, defaultFile) {
     server.registerTool('task_patch', {
         title: 'Patch Task',
-        description: 'Update specific fields of a task. Set fields to null to remove them. Set parentId to a plan ID to link a task to the plan it implements.',
+        description: 'Update specific fields of a task. Set fields to null to remove them. parentId moves a document under its parent (a task under a plan, a spec under an epic); an off-pattern parent is a warning, refused on a strict board, and a loop is always refused. dependsOn replaces the list of tasks that come first; decisions replaces the list of decisions the work rests on.',
         inputSchema: zod_1.z.object({
             file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
             taskId: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional().describe('Task ID or array of task IDs to update'),
@@ -56,10 +56,12 @@ function registerTaskPatchTool(server, defaultFile) {
             assignee: zod_1.z.string().nullable().optional().describe('New assignee (null to remove)'),
             dueDate: zod_1.z.string().nullable().optional().describe('New due date (null to remove)'),
             relatedFiles: zod_1.z.array(zod_1.z.string()).nullable().optional().describe('Related file paths (null to remove)'),
-            parentId: zod_1.z.string().nullable().optional().describe('Parent task ID (null to remove)')
+            parentId: zod_1.z.string().nullable().optional().describe('Parent task ID (null to remove)'),
+            dependsOn: zod_1.z.array(zod_1.z.string()).nullable().optional().describe('Task IDs this task depends on, replacing the list; alias:task-id names a task on a related board (null or [] to remove)'),
+            decisions: zod_1.z.array(zod_1.z.string()).nullable().optional().describe('IDs of the decisions this work rests on, replacing the list (null or [] to remove)'),
         }),
         outputSchema: schemas_1.taskPatchOutputSchema
-    }, (0, helpers_1.withBoardCommit)('task_patch', defaultFile, async ({ file, taskId, task, title, description, priority, tags, assignee, dueDate, relatedFiles, parentId }) => {
+    }, (0, helpers_1.withBoardCommit)('task_patch', defaultFile, async ({ file, taskId, task, title, description, priority, tags, assignee, dueDate, relatedFiles, parentId, dependsOn, decisions }) => {
         const filePath = file || defaultFile;
         const rawTaskIds = taskId ?? task;
         if (!rawTaskIds) {
@@ -73,6 +75,10 @@ function registerTaskPatchTool(server, defaultFile) {
             return guard;
         const dirs = (0, v2_detect_1.getV2Dirs)(filePath);
         const results = [];
+        const linksChange = (typeof parentId === 'string' && !isNull(parentId))
+            || (Array.isArray(dependsOn) && dependsOn.length > 0)
+            || (Array.isArray(decisions) && decisions.length > 0);
+        const board = linksChange ? (0, core_1.readBoardGraph)(filePath) : null;
         for (const id of taskIds) {
             const taskPath = path.join(dirs.boardDir, (0, core_1.taskFileName)(id));
             const doc = (0, core_1.readTaskFile)(taskPath);
@@ -81,6 +87,22 @@ function registerTaskPatchTool(server, defaultFile) {
                 continue;
             }
             const nullable = (v) => v === undefined ? undefined : (isNull(v) ? null : v);
+            // Links are checked against the board (spec-12): self links and loops are
+            // refused; an off-pattern link warns, and a strict board refuses it.
+            let warnings = [];
+            if (board) {
+                const check = (0, core_1.checkDocumentLinks)(board.graph, {
+                    id,
+                    ...(typeof parentId === 'string' && !isNull(parentId) && { parentId }),
+                    ...(Array.isArray(dependsOn) && { dependsOn }),
+                    ...(Array.isArray(decisions) && { decisions }),
+                }, { strict: board.config?.strict === true });
+                if (check.errors.length > 0) {
+                    results.push({ taskId: id, success: false, error: check.errors.join('; ') });
+                    continue;
+                }
+                warnings = check.warnings;
+            }
             const result = (0, core_1.patchTaskFile)(taskPath, {
                 title,
                 description: nullable(description),
@@ -90,12 +112,14 @@ function registerTaskPatchTool(server, defaultFile) {
                 dueDate: nullable(dueDate),
                 relatedFiles: nullable(relatedFiles),
                 parentId: nullable(parentId),
+                dependsOn: nullable(dependsOn),
+                decisions: nullable(decisions),
             });
             if (!result.success) {
                 results.push({ taskId: id, success: false, error: result.error || 'Task not found' });
                 continue;
             }
-            results.push({ taskId: id, success: true });
+            results.push({ taskId: id, success: true, ...(warnings.length > 0 && { warnings }) });
         }
         const successCount = results.filter(r => r.success).length;
         const failureCount = results.length - successCount;
@@ -111,8 +135,9 @@ function registerTaskPatchTool(server, defaultFile) {
                     isError: true,
                 };
             }
+            const warned = single.warnings?.length ? `\nWarning: ${single.warnings.join('\nWarning: ')}` : '';
             return {
-                content: [{ type: 'text', text: `Task ${taskIds[0]} updated successfully` }],
+                content: [{ type: 'text', text: `Task ${taskIds[0]} updated successfully${warned}` }],
                 structuredContent: output,
             };
         }

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

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

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

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+/** `template`: list the task templates, or add a task from one, like `brainfile template`. */
+export declare function registerTemplateTool(server: McpServer, defaultFile: string): void;
+//# sourceMappingURL=template_tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template_tool.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/template_tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAoB9D,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA+CjF"}

package/dist/mcp/tools/template_tool.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTemplateTool = registerTemplateTool;
+const zod_1 = require("zod");
+const core_1 = require("@brainfile/core");
+const template_1 = require("../../commands/template");
+const logger_1 = require("../../utils/logger");
+const helpers_1 = require("../helpers");
+const schemas_1 = require("../schemas");
+/** The templates as plain data. */
+function listTemplates() {
+    return core_1.BUILT_IN_TEMPLATES.map((t) => ({
+        id: t.id,
+        name: t.name,
+        description: t.description,
+        ...(t.template.priority ? { priority: String(t.template.priority) } : {}),
+        ...(t.template.tags && t.template.tags.length > 0 ? { tags: [...t.template.tags] } : {}),
+        subtasks: (t.template.subtasks ?? []).map((s) => s.title),
+    }));
+}
+/** `template`: list the task templates, or add a task from one, like `brainfile template`. */
+function registerTemplateTool(server, defaultFile) {
+    server.registerTool('template', {
+        title: 'Task Templates',
+        description: 'Task templates (bug-report, feature-request, refactor), each with a priority, tags, a description outline and a subtask checklist. action=list shows them; action=use adds a task from one (template, title, optional description and column, default todo).',
+        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', 'use']).optional().describe('Default list'),
+            template: zod_1.z.string().optional().describe('use: the template ID, e.g. bug-report'),
+            title: zod_1.z.string().optional().describe('use: the task title'),
+            description: zod_1.z.string().optional().describe('use: fills the template\'s description'),
+            column: zod_1.z.string().optional().describe('use: column ID or name (default todo)'),
+        }),
+        outputSchema: schemas_1.templateOutputSchema,
+    }, (0, helpers_1.withBoardCommit)('template', defaultFile, async (input) => {
+        const action = input.action ?? 'list';
+        if (action === 'list') {
+            const output = { action, templates: listTemplates() };
+            return (0, helpers_1.mcpResult)(JSON.stringify(output, null, 2), output);
+        }
+        const filePath = input.file || defaultFile;
+        const guard = (0, helpers_1.requireV2)(filePath);
+        if (guard)
+            return guard;
+        if (!input.template?.trim())
+            return (0, helpers_1.mcpError)(`use needs a template: ${core_1.BUILT_IN_TEMPLATES.map((t) => t.id).join(', ')}`);
+        if (!input.title?.trim())
+            return (0, helpers_1.mcpError)('use needs a title');
+        try {
+            const result = (0, template_1.templateCommand)({
+                file: (0, helpers_1.resolveBrainfile)(filePath),
+                use: input.template.trim(),
+                title: input.title.trim(),
+                ...(input.description ? { description: input.description } : {}),
+                column: input.column?.trim() || 'todo',
+            }, new logger_1.MemoryLogger());
+            if (!result.success || !result.taskId)
+                return (0, helpers_1.mcpError)('the task was not created');
+            const output = {
+                action,
+                task: { id: result.taskId, title: input.title.trim(), template: input.template.trim(), column: result.columnId ?? 'todo' },
+            };
+            return (0, helpers_1.mcpResult)(`Task added from ${output.task.template}: ${output.task.id} - ${output.task.title}`, output);
+        }
+        catch (error) {
+            return (0, helpers_1.mcpErrorFrom)(error);
+        }
+    }));
+}
+//# sourceMappingURL=template_tool.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+/** `types`: every type and its place in the graph; add one, like `brainfile types add`. */
+export declare function registerTypesTool(server: McpServer, defaultFile: string): void;
+//# sourceMappingURL=types_tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types_tool.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/types_tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAO9D,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAoD9E"}

package/dist/mcp/tools/types_tool.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTypesTool = registerTypesTool;
+const zod_1 = require("zod");
+const types_1 = require("../../commands/types");
+const logger_1 = require("../../utils/logger");
+const helpers_1 = require("../helpers");
+const schemas_1 = require("../schemas");
+/** `types`: every type and its place in the graph; add one, like `brainfile types add`. */
+function registerTypesTool(server, defaultFile) {
+    server.registerTool('types', {
+        title: 'Document Types',
+        description: 'Every document type the board has, with its place in the graph: role, ID prefix, what it goes under (parents) and holds (children), whether it completes; the five built-ins (epic, spec, plan, task, decision) and the board\'s own. action=add saves a type under types: (name; like takes a built-in\'s place, e.g. bug like task; idPrefix; completable; schema). An alias name (adr, issue) cannot be added.',
+        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']).optional().describe('Default list'),
+            name: zod_1.z.string().optional().describe('add: the type name'),
+            like: zod_1.z.string().optional().describe('add: the type whose place it takes: epic, spec, plan, task, decision, or one on the board'),
+            idPrefix: zod_1.z.string().optional().describe('add: ID prefix (default: the name)'),
+            completable: zod_1.z.boolean().optional().describe('add: whether it can be completed (default true, or its like: type\'s rule)'),
+            schema: zod_1.z.string().optional().describe('add: a schema URL or path for the type'),
+        }),
+        outputSchema: schemas_1.typesOutputSchema,
+    }, (0, helpers_1.withBoardCommit)('types', 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';
+        try {
+            let added;
+            if (action === 'add') {
+                const saved = (0, types_1.typesAddCommand)({
+                    file: resolved,
+                    name: input.name,
+                    ...(input.idPrefix !== undefined ? { idPrefix: input.idPrefix } : {}),
+                    ...(input.completable !== undefined ? { completable: input.completable } : {}),
+                    ...(input.schema !== undefined ? { schema: input.schema } : {}),
+                    ...(input.like !== undefined ? { like: input.like } : {}),
+                }, new logger_1.MemoryLogger());
+                added = { name: saved.typeName, entry: { ...saved.entry } };
+            }
+            const listed = (0, types_1.typesListCommand)({ file: resolved }, new logger_1.MemoryLogger());
+            const output = {
+                action,
+                strict: listed.strict,
+                types: listed.types,
+                graph: listed.graph,
+                aliasEntries: listed.aliasEntries,
+                ...(added ? { added } : {}),
+            };
+            const head = added ? `Saved type '${added.name}'` : `${listed.graph.length} types`;
+            return (0, helpers_1.mcpResult)(`${head}\n\n${JSON.stringify(output, null, 2)}`, output);
+        }
+        catch (error) {
+            return (0, helpers_1.mcpErrorFrom)(error);
+        }
+    }));
+}
+//# sourceMappingURL=types_tool.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+/** `where`: where the board lives, how fresh it is, and any other copy of it, like `brainfile where`. Offline unless `fetch`. */
+export declare function registerWhereTool(server: McpServer, defaultFile: string): void;
+//# sourceMappingURL=where_tool.d.ts.map

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

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

package/dist/mcp/tools/where_tool.js

@@ -0,0 +1,73 @@
+"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.registerWhereTool = registerWhereTool;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const where_1 = require("../../commands/where");
+const board_sync_1 = require("../../utils/board-sync");
+const helpers_1 = require("../helpers");
+const schemas_1 = require("../schemas");
+/** `where`: where the board lives, how fresh it is, and any other copy of it, like `brainfile where`. Offline unless `fetch`. */
+function registerWhereTool(server, defaultFile) {
+    server.registerTool('where', {
+        title: 'Where Is The Board',
+        description: 'Where the board lives (path), how it is stored (plain files, a branch of this repository, or its own repository), the remote it is shared through, when it last synced and whether that worked, and how many changes wait to be sent; every other copy of the board in the repository (boards), and conflict when one disagrees with this one, in which case every write is refused until conflict.resolve is run. Read-only; offline unless fetch.',
+        inputSchema: zod_1.z.object({
+            file: zod_1.z.string().optional().describe('Path to brainfile.md (default: brainfile.md)'),
+            fetch: zod_1.z.boolean().optional().describe('Ask the remote for its copy of the board first'),
+        }),
+        outputSchema: schemas_1.whereOutputSchema,
+    }, async ({ file, fetch }) => {
+        const resolved = (0, helpers_1.resolveBrainfile)(file || defaultFile);
+        if (!fs.existsSync(resolved))
+            return (0, helpers_1.mcpError)(`File not found: ${resolved}`);
+        const report = (0, where_1.whereReport)(path.dirname(resolved), { fetch: fetch === true });
+        const stored = report.storage === 'plain'
+            ? 'plain files, not tracked by git'
+            : report.storage === 'branch'
+                ? `commits on the '${report.branch}' branch`
+                : 'commits in its own repository';
+        const shared = report.remote
+            ? `shared through ${report.remote}${report.lastSyncSecondsAgo !== null ? `, last synced ${(0, where_1.ago)(report.lastSyncSecondsAgo)}${report.lastSyncOk === false ? ' (failed)' : ''}` : ''}, ${report.pendingChanges} change${report.pendingChanges === 1 ? '' : 's'} waiting`
+            : 'not shared';
+        const conflict = report.conflict
+            ? `\n${report.conflict.message} ${(0, board_sync_1.boardConflictRelation)(report.conflict)} Writes are refused until: ${report.conflict.resolve}`
+            : '';
+        return (0, helpers_1.mcpResult)(`${report.path}: ${stored}; ${shared}${conflict}\n\n${JSON.stringify(report, null, 2)}`, { ...report });
+    });
+}
+//# sourceMappingURL=where_tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"where_tool.js","sourceRoot":"","sources":["../../../src/mcp/tools/where_tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,8CA8BC;AAvCD,uCAAyB;AACzB,2CAA6B;AAC7B,6BAAwB;AACxB,gDAAwD;AACxD,uDAA+D;AAC/D,wCAAmE;AACnE,wCAA+C;AAE/C,iIAAiI;AACjI,SAAgB,iBAAiB,CAAC,MAAiB,EAAE,WAAmB;IACtE,MAAM,CAAC,YAAY,CACjB,OAAO,EACP;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,qbAAqb;QAClc,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,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;SACzF,CAAC;QACF,YAAY,EAAE,2BAAiB;KAChC,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QACxB,MAAM,QAAQ,GAAG,IAAA,0BAAgB,EAAC,IAAI,IAAI,WAAW,CAAC,CAAC;QACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAA,kBAAQ,EAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,IAAA,mBAAW,EAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,KAAK,OAAO;YACvC,CAAC,CAAC,iCAAiC;YACnC,CAAC,CAAC,MAAM,CAAC,OAAO,KAAK,QAAQ;gBAC3B,CAAC,CAAC,mBAAmB,MAAM,CAAC,MAAM,UAAU;gBAC5C,CAAC,CAAC,+BAA+B,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM;YAC1B,CAAC,CAAC,kBAAkB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,kBAAkB,KAAK,IAAI,CAAC,CAAC,CAAC,iBAAiB,IAAA,WAAG,EAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG,MAAM,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,cAAc,UAAU,MAAM,CAAC,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU;YACpQ,CAAC,CAAC,YAAY,CAAC;QACjB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ;YAC9B,CAAC,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,IAAA,kCAAqB,EAAC,MAAM,CAAC,QAAQ,CAAC,8BAA8B,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE;YAC/H,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,IAAA,mBAAS,EAAC,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,KAAK,MAAM,GAAG,QAAQ,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAC3H,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/schemas/board.json

@@ -30,7 +30,7 @@
         },
         "types": {
           "type": "object",
-          "description": "Optional map of document type definitions. Keys are type identifiers (e.g., 'epic', 'adr') that match the type field in task.json. In strict mode, this map is the allowlist for non-task types; the built-in task type is always implicitly valid. When omitted, all items are standard tasks.",
+          "description": "Additions to and overrides of the document types. epic, spec, plan, task and decision are built in and need no entry; an entry under one of their names overrides it, and any other name adds a type, optionally taking a built-in's place with like. Entries under the aliases issue and adr do not configure task or decision. In strict mode a document's type must be built in or listed here.",
           "additionalProperties": {
             "$ref": "#/definitions/typeEntry"
           },
@@ -49,9 +49,25 @@
             }
           ]
         },
+        "related": {
+          "type": "object",
+          "description": "Sister boards in other repositories, by short name. Each value is the repository folder, relative to this repository's root (the project root, not .brainfile/). A task refers to a task on one as alias:task-id, in dependsOn or anywhere a task ID is taken. A folder that is not on this machine is still valid.",
+          "propertyNames": {
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$"
+          },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          },
+          "examples": [
+            {
+              "mobile": "../hotline-mobile"
+            }
+          ]
+        },
         "strict": {
           "type": "boolean",
-          "description": "Enables strict validation for CLI operations. When true, add rejects unknown task types and move rejects unknown columns. When false (default), unknown types and columns are allowed for backward compatibility. The task type is always implicitly valid even if not listed in types.",
+          "description": "Enables strict validation for CLI operations. When true, add rejects unknown document types, move rejects unknown columns, and add, patch and lint refuse an off-pattern parent. When false (default), unknown types and columns are allowed and an off-pattern parent is a warning. The built-in types (epic, spec, plan, task, decision) are always valid even if not listed in types.",
           "default": false
         },
         "statsConfig": {
@@ -83,20 +99,25 @@
   "definitions": {
     "typeEntry": {
       "type": "object",
-      "description": "Configuration for a custom document type. Defines how items of this type behave within the board.",
-      "required": [
-        "idPrefix"
-      ],
+      "description": "Configuration for a document type: a type of your own, or an override of a built-in. Defines how items of this type behave within the board.",
       "properties": {
+        "like": {
+          "type": "string",
+          "description": "The built-in type whose place this one takes: its parents, children, completion rule and glyph. One of epic, spec, plan, task, decision (or the aliases issue, adr), or another type on the board. Without like, a type behaves as a task.",
+          "examples": [
+            "task",
+            "spec"
+          ]
+        },
         "idPrefix": {
           "type": "string",
-          "description": "Prefix for auto-generated IDs of this type (e.g., 'epic' produces 'epic-1', 'epic-2'). Must be unique across all type entries.",
+          "description": "Prefix for auto-generated IDs of this type (e.g., 'epic' produces 'epic-1', 'epic-2'). Defaults to the type name.",
           "pattern": "^[a-z]+(-[a-z]+)*$",
           "minLength": 1
         },
         "completable": {
           "type": "boolean",
-          "description": "Whether items of this type can be completed (moved to completion columns and logs/). Defaults to true. Set to false for reference documents like ADRs or epics that are not completable tasks.",
+          "description": "Whether items of this type complete when moved to a completion column. Defaults to true, or to the like type's rule. A task is always completable; a decision never is.",
           "default": true
         },
         "schema": {