brainfile 0.18.0 → 0.19.0

package/README.md

@@ -1,11 +1,11 @@
-# @brainfile/cli
+# brainfile
 
-CLI for the [Brainfile](https://brainfile.md) task coordination protocol. Manage tasks, contracts, and ADRs from your terminal. Includes a TUI board view and an MCP server for AI agent integration.
+Markdown task boards for you and your AI agents. Manage tasks, epics, contracts, and ADRs from your terminal — with a TUI board view and an MCP server so your coding agents work the same board. Everything is plain Markdown in your repo.
 
 ## Install
 
 ```bash
-npm i -g @brainfile/cli
+npm i -g brainfile
 ```
 
 ## Quick Start
@@ -213,7 +213,7 @@ Add to your `claude_desktop_config.json`:
   "mcpServers": {
     "brainfile": {
       "command": "npx",
-      "args": ["@brainfile/cli", "mcp"]
+      "args": ["brainfile", "mcp"]
     }
   }
 }

package/dist/__tests__/helpers/mcp.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Minimal MCP server stub for exercising tool handlers directly in tests.
+ *
+ * Tool modules call `server.registerTool(name, definition, handler)`; this
+ * captures the handler so tests can invoke it with a plain args object,
+ * bypassing transport and zod parsing.
+ */
+export type McpToolHandler = (args: any) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare class FakeMcpServer {
+    readonly handlers: Map<string, McpToolHandler>;
+    registerTool(name: string, _definition: unknown, handler: McpToolHandler): void;
+    handler(name: string): McpToolHandler;
+}
+/** Extract the plain text payload from an MCP tool result. */
+export declare function mcpText(result: {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}): string;
+/** Parse an MCP tool result whose text payload is JSON. */
+export declare function mcpJson<T = any>(result: {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}): T;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/__tests__/helpers/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC;IAClD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAAC;AAEH,qBAAa,aAAa;IACxB,QAAQ,CAAC,QAAQ,8BAAqC;IAEtD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAI/E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;CAOtC;AAED,8DAA8D;AAC9D,wBAAgB,OAAO,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,MAAM,CAE1F;AAED,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,CAAC,CAE9F"}

package/dist/__tests__/helpers/mcp.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Minimal MCP server stub for exercising tool handlers directly in tests.
+ *
+ * Tool modules call `server.registerTool(name, definition, handler)`; this
+ * captures the handler so tests can invoke it with a plain args object,
+ * bypassing transport and zod parsing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FakeMcpServer = void 0;
+exports.mcpText = mcpText;
+exports.mcpJson = mcpJson;
+class FakeMcpServer {
+    constructor() {
+        this.handlers = new Map();
+    }
+    registerTool(name, _definition, handler) {
+        this.handlers.set(name, handler);
+    }
+    handler(name) {
+        const found = this.handlers.get(name);
+        if (!found) {
+            throw new Error(`Tool not registered: ${name}`);
+        }
+        return found;
+    }
+}
+exports.FakeMcpServer = FakeMcpServer;
+/** Extract the plain text payload from an MCP tool result. */
+function mcpText(result) {
+    return result.content.map((c) => c.text).join('\n');
+}
+/** Parse an MCP tool result whose text payload is JSON. */
+function mcpJson(result) {
+    return JSON.parse(mcpText(result));
+}
+//# sourceMappingURL=mcp.js.map

package/dist/__tests__/helpers/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/__tests__/helpers/mcp.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAwBH,0BAEC;AAGD,0BAEC;AAxBD,MAAa,aAAa;IAA1B;QACW,aAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAaxD,CAAC;IAXC,YAAY,CAAC,IAAY,EAAE,WAAoB,EAAE,OAAuB;QACtE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAdD,sCAcC;AAED,8DAA8D;AAC9D,SAAgB,OAAO,CAAC,MAA0D;IAChF,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,2DAA2D;AAC3D,SAAgB,OAAO,CAAU,MAA0D;IACzF,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AACrC,CAAC"}

package/dist/chunk-I5SJHUZK.mjs

@@ -0,0 +1,52 @@
+import { createRequire as __brainfileCreateRequire } from 'node:module';
+import { fileURLToPath as __brainfileFileURLToPath } from 'node:url';
+import { dirname as __brainfileDirname } from 'node:path';
+const require = __brainfileCreateRequire(import.meta.url);
+const __filename = __brainfileFileURLToPath(import.meta.url);
+const __dirname = __brainfileDirname(__filename);
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __commonJS = (cb, mod) => function __require2() {
+  try {
+    return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  } catch (e) {
+    throw mod = 0, e;
+  }
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+export {
+  __require,
+  __commonJS,
+  __export,
+  __toESM
+};