@sentropic/track 0.85.14 → 0.85.15

package/dist/mcp/cli.js

@@ -1,7 +1,5 @@
 #!/usr/bin/env node
-// `track-mcp` bin — a stdio read-only MCP server over the nearest-ancestor `.track/events.jsonl`.
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { createTrackMcpServer } from './server.js';
+import { serveTrackMcpStdio } from './serve.js';
 // Launch/serve alignment: like h2a `mcp-serve`, `track-mcp` BOOTS UNCONDITIONALLY and advertises its
 // read tools without requiring pre-existing project state. The store is resolved LAZILY per read call
 // (`--track-dir`→`TRACK_DIR`→nearest-ancestor `.track`), so a `.track` created AFTER boot is picked up
@@ -15,9 +13,9 @@ const resolveOpts = {
     ...(flag !== undefined ? { flag } : {}),
     ...(env !== undefined ? { env } : {}),
 };
-const server = createTrackMcpServer(resolveOpts);
 // Keep the transport fatal: a real connect/transport failure must stay loud (rc=1 + stderr).
-server.connect(new StdioServerTransport()).catch((error) => {
+// The bin passes NO abort signal — it serves for the process lifetime (stdin EOF resolves it).
+serveTrackMcpStdio(resolveOpts).catch((error) => {
     process.stderr.write(`track-mcp failed: ${error instanceof Error ? error.message : String(error)}\n`);
     process.exit(1);
 });

package/dist/mcp/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/mcp/cli.ts"],"names":[],"mappings":";AACA,kGAAkG;AAClG,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAGhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,qGAAqG;AACrG,sGAAsG;AACtG,uGAAuG;AACvG,uGAAuG;AACvG,yGAAyG;AACzG,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;AACnD,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACnE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;AACpC,MAAM,WAAW,GAAmB;IAClC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAClB,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CACtC,CAAA;AAED,MAAM,MAAM,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAA;AAEhD,6FAA6F;AAC7F,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAClE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACrG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/mcp/cli.ts"],"names":[],"mappings":";AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE/C,qGAAqG;AACrG,sGAAsG;AACtG,uGAAuG;AACvG,uGAAuG;AACvG,yGAAyG;AACzG,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;AACnD,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACnE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;AACpC,MAAM,WAAW,GAAmB;IAClC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAClB,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CACtC,CAAA;AAED,6FAA6F;AAC7F,+FAA+F;AAC/F,kBAAkB,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACrG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/mcp/serve.d.ts

@@ -0,0 +1,27 @@
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { ResolveOptions } from '../cli/resolve.js';
+export { createTrackMcpServer } from './server.js';
+export interface ServeTrackMcpStdioOptions {
+    /**
+     * Abort to stop serving: the server + its transport are closed and the promise
+     * resolves. This is the graceful-shutdown hook an embedding host wires to its
+     * SIGTERM/SIGINT/SIGHUP handler (e.g. h2a's `track-mcp` bin.ts branch).
+     */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Await a CONNECTED MCP `server` until it closes — either the peer closed the
+ * transport (stdin EOF) or `opts.signal` aborted (we close it). Resolves exactly
+ * once; rejects only if a requested close throws. Transport-agnostic, so it is
+ * unit-testable over an in-memory pair with no stdio coupling — which is where
+ * the graceful-shutdown contract for the in-process host is actually verified.
+ */
+export declare function runServerUntilClosed(server: Server, opts?: ServeTrackMcpStdioOptions): Promise<void>;
+/**
+ * Serve the read-only track MCP over stdio. Resolves when the transport closes or
+ * `opts.signal` aborts; rejects only on a real connect/transport failure (the bin
+ * turns that into rc=1 + stderr). The store is resolved LAZILY per read call by
+ * the factory, so a `.track` created after boot is picked up without a restart.
+ */
+export declare function serveTrackMcpStdio(source: string | ResolveOptions, opts?: ServeTrackMcpStdioOptions): Promise<void>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/mcp/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/mcp/serve.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAKvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,GAAG,cAAc,EAC/B,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/mcp/serve.js

@@ -0,0 +1,58 @@
+// track-mcp — the SHARED stdio serve path, used by BOTH the `track-mcp` bin
+// (./cli.ts) and any in-process host (e.g. h2a's native `track-mcp` verb via the
+// `@sentropic/track/mcp` export). Keeping ONE serve path means the bin and the
+// embedded host can never drift. Exposed additively via package `exports["./mcp"]`.
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createTrackMcpServer } from './server.js';
+// Re-export the factory so `@sentropic/track/mcp` is the single surface an
+// embedding host imports (server + serve helpers together).
+export { createTrackMcpServer } from './server.js';
+/**
+ * Await a CONNECTED MCP `server` until it closes — either the peer closed the
+ * transport (stdin EOF) or `opts.signal` aborted (we close it). Resolves exactly
+ * once; rejects only if a requested close throws. Transport-agnostic, so it is
+ * unit-testable over an in-memory pair with no stdio coupling — which is where
+ * the graceful-shutdown contract for the in-process host is actually verified.
+ */
+export async function runServerUntilClosed(server, opts = {}) {
+    const { signal } = opts;
+    if (signal?.aborted) {
+        await server.close();
+        return;
+    }
+    return await new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (err) => {
+            if (settled)
+                return;
+            settled = true;
+            signal?.removeEventListener('abort', onAbort);
+            server.onclose = () => { }; // detach (the `settled` guard already dedups re-entry)
+            if (err !== undefined)
+                reject(err);
+            else
+                resolve();
+        };
+        const onAbort = () => {
+            // close() also fires onclose → finish(); the `settled` guard dedups.
+            server.close().then(() => finish(), (err) => finish(err));
+        };
+        // Peer-initiated close (stdin EOF) AND our own close() both fire onclose.
+        server.onclose = () => finish();
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/**
+ * Serve the read-only track MCP over stdio. Resolves when the transport closes or
+ * `opts.signal` aborts; rejects only on a real connect/transport failure (the bin
+ * turns that into rc=1 + stderr). The store is resolved LAZILY per read call by
+ * the factory, so a `.track` created after boot is picked up without a restart.
+ */
+export async function serveTrackMcpStdio(source, opts = {}) {
+    if (opts.signal?.aborted)
+        return;
+    const server = createTrackMcpServer(source);
+    await server.connect(new StdioServerTransport());
+    return await runServerUntilClosed(server, opts);
+}
+//# sourceMappingURL=serve.js.map

package/dist/mcp/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/mcp/serve.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,iFAAiF;AACjF,+EAA+E;AAC/E,oFAAoF;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAIhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,2EAA2E;AAC3E,4DAA4D;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAWlD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAc,EACd,OAAkC,EAAE;IAEpC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACvB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;QACpB,OAAM;IACR,CAAC;IACD,OAAO,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACjD,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,MAAM,MAAM,GAAG,CAAC,GAAa,EAAQ,EAAE;YACrC,IAAI,OAAO;gBAAE,OAAM;YACnB,OAAO,GAAG,IAAI,CAAA;YACd,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC7C,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE,GAAE,CAAC,CAAA,CAAC,uDAAuD;YACjF,IAAI,GAAG,KAAK,SAAS;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAA;;gBAC7B,OAAO,EAAE,CAAA;QAChB,CAAC,CAAA;QACD,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,qEAAqE;YACrE,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAY,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;QACpE,CAAC,CAAA;QACD,0EAA0E;QAC1E,MAAM,CAAC,OAAO,GAAG,GAAS,EAAE,CAAC,MAAM,EAAE,CAAA;QACrC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAA+B,EAC/B,OAAkC,EAAE;IAEpC,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO;QAAE,OAAM;IAChC,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAA;IAC3C,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAA;IAChD,OAAO,MAAM,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;AACjD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentropic/track",
-  "version": "0.85.14",
+  "version": "0.85.15",
   "description": "Typed product-backlog and spec/plan/UAT system of record for the sentropic ecosystem (record-only MVP).",
   "license": "MIT",
   "author": "Fabien Antoine",
@@ -41,6 +41,10 @@
     "./report/friendly": {
       "types": "./dist/report/friendly.d.ts",
       "import": "./dist/report/friendly.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp/serve.d.ts",
+      "import": "./dist/mcp/serve.js"
     }
   },
   "files": [