faf-mcp 2.1.0 → 2.1.2

package/dist/src/utils/faf-cli-bridge.d.ts

@@ -0,0 +1,47 @@
+/**
+ * faf-cli bridge — single re-export point for faf-cli's typed public API.
+ *
+ * Why this file exists (three coupled problems):
+ *   1. faf-cli 6.7.1's `exports` map sets a `bun` condition pointing at a
+ *      non-shipped `src/index.ts`. Bun's resolver always picks the `bun`
+ *      condition first (verified: `--conditions=node` ADDS to the set,
+ *      doesn't replace), so `from 'faf-cli'` blows up at module-load in
+ *      bun-test. Subpath imports (`faf-cli/dist/index.js`) are ALSO blocked
+ *      because faf-cli's exports map only exports `.`.
+ *   2. Static relative paths don't survive tsc compilation: a literal
+ *      `../../node_modules/...` written in `src/utils/` resolves to the
+ *      wrong place when the compiled file lands at `dist/src/utils/` (one
+ *      level deeper, so the relative escape comes up short).
+ *   3. faf-cli's dist is ESM (`"type": "module"`). Node 18 rejects sync
+ *      `require()` of ESM (`ERR_REQUIRE_ESM`); Node 20 allows it. faf-mcp
+ *      supports Node 18+ per `engines`, so we must use dynamic `import()`.
+ *
+ * How this bridge works:
+ *   At runtime, walk upward from `__dirname` (which is `src/utils/` when
+ *   bun loads TS source and `dist/src/utils/` when Node loads compiled
+ *   CJS) until we find `node_modules/faf-cli/dist/index.js`. Then load it
+ *   via dynamic `import()` of an absolute `file://` URL — which:
+ *     - bypasses the exports map (no package specifier, no condition picked)
+ *     - handles ESM-from-CJS correctly on Node 18+ AND in bun
+ *     - resolves the same module regardless of source-vs-compiled __dirname
+ *
+ *   The type info comes via `import type` — purely compile-time, esbuild
+ *   strips it at load time, so the `bun` condition never fires for types.
+ *
+ *   Export shape: `fafCli` is a Promise<typeof FafCli>. Consumers
+ *   destructure with `const { ... } = await fafCli` inside async handlers.
+ *   Module evaluation is one-shot — the Promise is created at module load
+ *   and cached forever.
+ *
+ *   This is intentionally a TEMPORARY workaround tied to faf-cli's bun
+ *   exports bug. Once faf-cli ships `src/` OR drops the `bun` condition,
+ *   this whole file becomes `export * from 'faf-cli'` and consumers go
+ *   back to bare specifiers. Tracked alongside the AERO test's matching
+ *   workaround comment in tests/wjttc-bun.test.ts.
+ *
+ *   Doctrine: silent-drift = fail = forbidden. The bridge is loud and
+ *   localized — one file, fully commented — not scattered ts-ignores or
+ *   silent type-casts.
+ */
+import type * as FafCli from 'faf-cli';
+export declare const fafCli: Promise<typeof FafCli>;

package/dist/src/utils/faf-cli-bridge.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * faf-cli bridge — single re-export point for faf-cli's typed public API.
+ *
+ * Why this file exists (three coupled problems):
+ *   1. faf-cli 6.7.1's `exports` map sets a `bun` condition pointing at a
+ *      non-shipped `src/index.ts`. Bun's resolver always picks the `bun`
+ *      condition first (verified: `--conditions=node` ADDS to the set,
+ *      doesn't replace), so `from 'faf-cli'` blows up at module-load in
+ *      bun-test. Subpath imports (`faf-cli/dist/index.js`) are ALSO blocked
+ *      because faf-cli's exports map only exports `.`.
+ *   2. Static relative paths don't survive tsc compilation: a literal
+ *      `../../node_modules/...` written in `src/utils/` resolves to the
+ *      wrong place when the compiled file lands at `dist/src/utils/` (one
+ *      level deeper, so the relative escape comes up short).
+ *   3. faf-cli's dist is ESM (`"type": "module"`). Node 18 rejects sync
+ *      `require()` of ESM (`ERR_REQUIRE_ESM`); Node 20 allows it. faf-mcp
+ *      supports Node 18+ per `engines`, so we must use dynamic `import()`.
+ *
+ * How this bridge works:
+ *   At runtime, walk upward from `__dirname` (which is `src/utils/` when
+ *   bun loads TS source and `dist/src/utils/` when Node loads compiled
+ *   CJS) until we find `node_modules/faf-cli/dist/index.js`. Then load it
+ *   via dynamic `import()` of an absolute `file://` URL — which:
+ *     - bypasses the exports map (no package specifier, no condition picked)
+ *     - handles ESM-from-CJS correctly on Node 18+ AND in bun
+ *     - resolves the same module regardless of source-vs-compiled __dirname
+ *
+ *   The type info comes via `import type` — purely compile-time, esbuild
+ *   strips it at load time, so the `bun` condition never fires for types.
+ *
+ *   Export shape: `fafCli` is a Promise<typeof FafCli>. Consumers
+ *   destructure with `const { ... } = await fafCli` inside async handlers.
+ *   Module evaluation is one-shot — the Promise is created at module load
+ *   and cached forever.
+ *
+ *   This is intentionally a TEMPORARY workaround tied to faf-cli's bun
+ *   exports bug. Once faf-cli ships `src/` OR drops the `bun` condition,
+ *   this whole file becomes `export * from 'faf-cli'` and consumers go
+ *   back to bare specifiers. Tracked alongside the AERO test's matching
+ *   workaround comment in tests/wjttc-bun.test.ts.
+ *
+ *   Doctrine: silent-drift = fail = forbidden. The bridge is loud and
+ *   localized — one file, fully commented — not scattered ts-ignores or
+ *   silent type-casts.
+ */
+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.fafCli = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const url_1 = require("url");
+function findFafCliDist(startDir) {
+    let dir = startDir;
+    while (dir !== path.dirname(dir)) {
+        const candidate = path.join(dir, 'node_modules', 'faf-cli', 'dist', 'index.js');
+        if (fs.existsSync(candidate))
+            return candidate;
+        dir = path.dirname(dir);
+    }
+    throw new Error(`faf-cli/dist/index.js not found in any ancestor node_modules of ${startDir}. ` +
+        `faf-mcp requires faf-cli as a direct dependency — check installation.`);
+}
+// Cached promise — module evaluation happens once.
+exports.fafCli = (async () => {
+    const distPath = findFafCliDist(__dirname);
+    return (await import((0, url_1.pathToFileURL)(distPath).href));
+})();
+//# sourceMappingURL=faf-cli-bridge.js.map

package/dist/src/utils/faf-cli-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faf-cli-bridge.js","sourceRoot":"","sources":["../../../src/utils/faf-cli-bridge.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,2CAA6B;AAC7B,uCAAyB;AACzB,6BAAoC;AAGpC,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,OAAO,GAAG,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QAChF,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,MAAM,IAAI,KAAK,CACb,mEAAmE,QAAQ,IAAI;QAC7E,uEAAuE,CAC1E,CAAC;AACJ,CAAC;AAED,mDAAmD;AACtC,QAAA,MAAM,GAA2B,CAAC,KAAK,IAAI,EAAE;IACxD,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC3C,OAAO,CAAC,MAAM,MAAM,CAAC,IAAA,mBAAa,EAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAkB,CAAC;AACvE,CAAC,CAAC,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faf-mcp",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "mcpName": "io.github.Wolfe-Jam/faf-mcp",
   "description": "Persistent Project Context for Cursor, IDEs and VS Code. IANA-registered .faf format, 25 MCP tools, 309 tests.",
   "icon": "./assets/icons/faf-icon-256.png",
@@ -16,8 +16,8 @@
     "dev": "ts-node src/server.ts",
     "dev:stdio": "ts-node src/cli.ts --transport stdio",
     "dev:http": "ts-node src/cli.ts --transport http-sse --port 3001",
-    "test": "jest",
-    "test:performance": "jest tests/performance.test.ts",
+    "test": "bun test --isolate --timeout=120000 --path-ignore-patterns=\"**/performance.test.ts\"",
+    "test:performance": "bun test tests/performance.test.ts",
     "test:mcp": "mcp-inspector stdio ts-node src/cli.ts",
     "lint": "eslint src/**/*.ts",
     "lint:fix": "eslint src/**/*.ts --fix",
@@ -105,20 +105,17 @@
     "cors": "^2.8.5",
     "express": "^4.21.0",
     "faf-cli": "^6.7.1",
+    "faf-scoring-kernel": "^2.0.3",
     "yaml": "^2.4.1"
   },
   "devDependencies": {
-    "@jest/globals": "^30.1.2",
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.3",
-    "@types/jest": "^30.0.0",
     "@types/jsonwebtoken": "^9.0.5",
     "@types/node": "^20.11.0",
     "@typescript-eslint/eslint-plugin": "^7.0.0",
     "@typescript-eslint/parser": "^7.0.0",
     "eslint": "^8.56.0",
-    "jest": "^30.2.0",
-    "ts-jest": "^29.1.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
   }