faf-mcp 2.3.1 → 3.0.1

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

@@ -14,8 +14,9 @@
  *      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()`.
+ *      `require()` of ESM (`ERR_REQUIRE_ESM`); Node 22 only allows it by
+ *      default from 22.12. faf-mcp's floor is Node 22.0 (`engines.node
+ *      >=22.0.0`), so the CJS build keeps dynamic `import()`.
  *
  * How this bridge works:
  *   At runtime, walk upward from `__dirname` (which is `src/utils/` when
@@ -23,7 +24,7 @@
  *   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
+ *     - handles ESM-from-CJS correctly on Node 22+ AND in bun
  *     - resolves the same module regardless of source-vs-compiled __dirname
  *
  *   The type info comes via `import type` — purely compile-time, esbuild
@@ -34,11 +35,14 @@
  *   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.
+ *   This began as a TEMPORARY workaround for faf-cli's bun exports bug.
+ *   faf-cli dropped the `bun` condition in 6.8.0 (7.12.0 exports only
+ *   `types`/`default`), so problem 1 is gone. The file stays: faf-cli is
+ *   ESM and faf-mcp compiles to CJS, so a bare `export * from 'faf-cli'`
+ *   needs sync require(esm), which Node only enables by default from
+ *   22.12 (engines floor is 22.0.0). It is also the single loud load point
+ *   and hosts bundledFafCliVersion()'s path-walk. tests/wjttc-bun.test.ts
+ *   carries the matching note.
  *
  *   Doctrine: silent-drift = fail = forbidden. The bridge is loud and
  *   localized — one file, fully commented — not scattered ts-ignores or
@@ -79,6 +83,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fafCli = void 0;
+exports.bundledFafCliVersion = bundledFafCliVersion;
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const url_1 = require("url");
@@ -93,9 +98,24 @@ function findFafCliDist(startDir) {
     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.`);
 }
+/** Version of the faf-cli this package bundles (node_modules/faf-cli/package.json). */
+function bundledFafCliVersion() {
+    try {
+        const pkg = path.join(path.dirname(path.dirname(findFafCliDist(__dirname))), 'package.json');
+        const parsed = JSON.parse(fs.readFileSync(pkg, 'utf-8'));
+        return parsed.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
 // Cached promise — module evaluation happens once.
 exports.fafCli = (async () => {
     const distPath = findFafCliDist(__dirname);
     return (await import((0, url_1.pathToFileURL)(distPath).href));
 })();
+// If faf-cli is missing the rejection must reach the tool call that awaits
+// it (a clear per-call error), not crash the server at startup as an
+// unhandled rejection before the host has even sent `initialize`.
+exports.fafCli.catch(() => { });
 //# sourceMappingURL=faf-cli-bridge.js.map

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

@@ -1 +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"}
+{"version":3,"file":"faf-cli-bridge.js","sourceRoot":"","sources":["../../../src/utils/faf-cli-bridge.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBH,oDAQC;AA3BD,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,uFAAuF;AACvF,SAAgB,oBAAoB;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;QAC7F,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAyB,CAAC;QACjF,OAAO,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,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;AACL,2EAA2E;AAC3E,qEAAqE;AACrE,kEAAkE;AAClE,cAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAA0C,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "faf-mcp",
-  "version": "2.3.1",
+  "version": "3.0.1",
   "mcpName": "one.faf/faf-mcp",
-  "description": "Persistent Project Context for Cursor, IDEs and VS Code. IANA-registered .faf format. Curated core tools by default, full set via FAF_TOOLS=all.",
+  "description": ".FAF Context — persistent project context for Cursor, VS Code and every MCP-compatible IDE. IANA-registered .faf format. Curated core tools by default, full set via FAF_TOOLS=all.",
   "icon": "./assets/icons/faf-icon-256.png",
   "logo": "./assets/icons/faf-icon-256.png",
   "displayName": ".faf 🐘",
@@ -11,11 +11,10 @@
     "faf-mcp": "dist/src/index.js"
   },
   "scripts": {
+    "prebuild": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
     "build": "tsc",
-    "start": "node start-http.js",
-    "dev": "ts-node src/server.ts",
+    "dev": "ts-node src/cli.ts",
     "dev:stdio": "ts-node src/cli.ts --transport stdio",
-    "dev:http": "ts-node src/cli.ts --transport http-sse --port 3001",
     "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",
@@ -23,13 +22,11 @@
     "lint:fix": "eslint src/**/*.ts --fix",
     "type-check": "tsc --noEmit",
     "check:stylesheet": "node scripts/check-stylesheet-drift.mjs",
-    "format:check": "prettier --check \"src/**/*.ts\"",
-    "format": "prettier --write \"src/**/*.ts\"",
+    "check:engines": "node scripts/check-engines.mjs",
     "prepare": "npm run build",
     "sync-version": "node scripts/sync-version.js",
-    "version": "npm run sync-version && git add project.faf",
-    "prepublishOnly": "npm run build",
-    "postinstall": "node scripts/postinstall.js",
+    "version": "npm run sync-version && git add project.faf server.json CHANGELOG.md docs/index.html AGENTS.md",
+    "prepublishOnly": "npm run build && npm run check:engines",
     "debug": "node --inspect-brk=0.0.0.0:9229 -r ts-node/register src/cli.ts"
   },
   "keywords": [
@@ -82,16 +79,15 @@
   },
   "homepage": "https://faf.one",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.0.0"
   },
   "files": [
     "dist/**/*",
     "assets/**/*",
     "scripts/**/*",
-    "skill/SKILL.md",
+    "skills/**",
     "README.md",
     "CLAUDE.md",
-    ".faf",
     "project.faf",
     "LICENSE",
     "CHANGELOG.md",
@@ -101,8 +97,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "faf-cli": "^6.10.1",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "faf-cli": "^7.12.0",
     "faf-scoring-kernel": "^2.0.3",
     "yaml": "^2.4.1"
   },
@@ -114,5 +110,12 @@
     "eslint": "^8.56.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
+  },
+  "overrides": {
+    "hono": ">=4.13.5",
+    "fast-uri": ">=4.1.2",
+    "ip-address": ">=10.3.1",
+    "brace-expansion@1": "1.1.18",
+    "brace-expansion@2": "2.1.4"
   }
 }

package/project.faf

@@ -1,6 +1,8 @@
 faf_version: "3.0"
 project:
   name: faf-mcp
+  title: .FAF Context
+  version: 3.0.1
   goal: The Interop MCP for Context — the Cursor / IDE Edition. Persistent context for Cursor, VS Code, and every MCP-compatible IDE. IANA-registered application/vnd.faf+yaml. Start with "Use FAF".
   main_language: TypeScript
   type: mcp
@@ -12,11 +14,11 @@ stack:
   ui_library: slotignored
   state_management: slotignored
   backend: MCP SDK (TS)
-  api_type: MCP (stdio + Streamable HTTP)
-  runtime: Node.js >=18
+  api_type: MCP (stdio)
+  runtime: Node.js >=22
   database: slotignored
   connection: slotignored
-  hosting: npm + Cloudflare edge
+  hosting: npm
   build: TypeScript (tsc)
   cicd: GitHub Actions
   monorepo_tool: slotignored
@@ -30,8 +32,8 @@ human_context:
   who: Developers using Claude, Cursor, Windsurf, VS Code, Cline, and any MCP-compatible IDE
   what: The Cursor / IDE Edition — persistent context for Cursor, VS Code, and every MCP-compatible IDE — 29 MCP tools (15 essential shown by default), interop with AGENTS.md, .cursorrules, GEMINI.md
   why: Eliminate the 20-minute AI context tax — give AI instant project understanding in 30 seconds
-  where: npm · MCP Registry · Cloudflare edge (ide.faf.one/mcp/v1) · any MCP-compatible IDE — people get it how they wish
-  when: Production/Stable — v2.3.0 The Curated Edition, WJTTC certified
+  where: npm · MCP Registry · any MCP-compatible IDE — people get it how they wish
+  when: Production/Stable — v3.0.1 The Compose Edition, WJTTC certified
   how: npx faf-mcp or npm install -g faf-mcp, then add to your MCP config
 monorepo:
   packages_count: slotignored
@@ -41,14 +43,17 @@ monorepo:
   remote_cache: slotignored
 surfaces:
   # Distribution map — the machine-checkable form of human_context.where. Score-neutral.
-  auto:                      # derived from manifests; regenerate with `faf surface --sync`
+  auto:                      # derived from manifests; refresh via /surface (future: `faf surface --sync`)
     - { type: npm,          id: faf-mcp,           source: "package.json#name" }
     - { type: github,       id: Wolfe-Jam/faf-mcp, source: "package.json#repository" }
     - { type: mcp-registry, id: one.faf/faf-mcp,   state: active, source: "server.json#name" }
   declared:                  # hand-authored: surfaces the manifests don't carry + targets
-    - { type: mcpaas,       id: faf, url: "https://ide.faf.one/mcp/v1", transport: streamable-http, status: live }
+    # v3.0: removed a false hosted-endpoint `mcpaas` entry here. The URL it
+    # pointed at serves MCPaaS (mcpaas-cf) — a different product with a
+    # different tool surface — not this package's tools. faf-mcp runs
+    # locally over stdio; no hosted deployment of it exists today.
     - { type: homebrew,     id: faf-mcp, status: live }
     - { type: mcp-registry, id: io.github.Wolfe-Jam/faf-mcp, state: deprecated, superseded_by: one.faf/faf-mcp }
-    - { type: pulsemcp,            id: faf-mcp, status: pending }
-    - { type: glama,               id: faf-mcp, status: pending }
+    - { type: pulsemcp,            id: faf-mcp, status: live }
+    - { type: glama,               id: faf-mcp, status: live }
     - { type: awesome-mcp-servers, id: faf-mcp, status: pending }

package/scripts/check-engines.mjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+// check-engines.mjs — the Node engine floor must match what CI actually runs.
+//
+// House rule (memory: feedback-node-engine-floor-and-terminal-release-test):
+// `engines.node` == the LOWEST Node in the CI matrix, never aspirational. You
+// can't raise the floor without dropping that Node from CI (a visible,
+// deliberate act), and you can't claim support for a Node the gate never runs.
+// faf-mcp receipt: the floor said >=18 while six production transitives
+// required >=20 — every Node-18 install printed EBADENGINE six times.
+//
+// Runs in CI (Code Quality) and in prepublishOnly.
+
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..');
+const read = (p) => readFileSync(join(root, p), 'utf8');
+
+const enginesRaw = JSON.parse(read('package.json')).engines?.node ?? '';
+const floorMatch = enginesRaw.match(/(\d+)/);
+if (!floorMatch) {
+  console.error(`✗ package.json engines.node missing or unparseable: ${JSON.stringify(enginesRaw)}`);
+  process.exit(1);
+}
+const floor = Number(floorMatch[1]);
+
+// CI node matrix — this repo writes it as `node: [22.x, 24.x]`.
+const ci = read('.github/workflows/ci.yml');
+const matrixMatch = ci.match(/node:\s*\[([^\]]+)\]/);
+if (!matrixMatch) {
+  console.error('✗ .github/workflows/ci.yml — could not find `node: [ ... ]` matrix');
+  process.exit(1);
+}
+const matrix = matrixMatch[1]
+  .split(',')
+  .map((s) => Number(s.replace(/['"\s]/g, '').replace(/\.x$/, '')))
+  .filter((n) => Number.isFinite(n))
+  .sort((a, b) => a - b);
+if (matrix.length === 0) {
+  console.error('✗ CI node matrix parsed empty');
+  process.exit(1);
+}
+const ciMin = matrix[0];
+
+if (floor !== ciMin) {
+  console.error(
+    `✗ engine floor drift — package.json engines.node = ">=${floor}", CI node matrix low = ${ciMin} (matrix: ${matrix.join(', ')}).\n` +
+      `  Make them equal: lower the floor to ${ciMin}, or drop Node ${ciMin} from ci.yml on purpose.`,
+  );
+  process.exit(1);
+}
+console.log(`✓ engine floor ${floor} == CI matrix low ${ciMin} (matrix: ${matrix.join(', ')})`);

package/scripts/sync-version.js

@@ -1,34 +1,48 @@
 #!/usr/bin/env node
 /**
- * Sync version from package.json to project.faf
- * Run: npm run sync-version
- * Auto-runs on: npm version (via "version" lifecycle hook)
+ * Sync the package.json version to every other stamp that carries it.
+ * Run: npm run sync-version   (auto on `npm version` via the "version" hook)
+ *
+ *   project.faf       project.version
+ *   server.json       top-level version + packages[].version
+ *   CHANGELOG.md      <!-- faf: doc=changelog | latest=vX.Y.Z ... --> meta-stamp
+ *   docs/index.html   the version badge (guarded by wjttc-p0-no-false-hosted-claim)
+ *   AGENTS.md         the "· vX.Y.Z" stamp on the facts line
+ *
+ * Doc Gate 101 (/pubpro) refuses on any drift between these; this is what
+ * keeps them from drifting in the first place.
  */
 
 const fs = require('fs');
 const path = require('path');
 
-const packageJsonPath = path.join(__dirname, '..', 'package.json');
-const projectFafPath = path.join(__dirname, '..', 'project.faf');
+const root = path.join(__dirname, '..');
+const read = (f) => fs.readFileSync(path.join(root, f), 'utf-8');
+const write = (f, s) => fs.writeFileSync(path.join(root, f), s);
+const version = JSON.parse(read('package.json')).version;
+const changed = [];
 
-try {
-  // Read version from package.json
-  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-  const version = packageJson.version;
+function sub(file, pattern, replacement, label) {
+  const before = read(file);
+  const after = before.replace(pattern, replacement);
+  if (after !== before) { write(file, after); changed.push(`${file} (${label})`); }
+  else if (!pattern.test(before)) console.warn(`⚠️  ${file}: no ${label} stamp found — nothing synced`);
+}
 
-  // Read project.faf
-  let projectFaf = fs.readFileSync(projectFafPath, 'utf-8');
+try {
+  sub('project.faf', /^(\s*version:\s*).+$/m, `$1${version}`, 'project.version');
 
-  // Update version field in state section
-  projectFaf = projectFaf.replace(
-    /^(\s*version:\s*).+$/m,
-    `$1${version}`
-  );
+  const serverJson = JSON.parse(read('server.json'));
+  let touched = false;
+  if (serverJson.version !== version) { serverJson.version = version; touched = true; }
+  for (const p of serverJson.packages ?? []) if (p.version !== version) { p.version = version; touched = true; }
+  if (touched) { write('server.json', JSON.stringify(serverJson, null, 2) + '\n'); changed.push('server.json (version, packages[].version)'); }
 
-  // Write back
-  fs.writeFileSync(projectFafPath, projectFaf);
+  sub('CHANGELOG.md', /(<!-- faf: doc=changelog \| latest=v)\d+\.\d+\.\d+/, `$1${version}`, 'latest= meta-stamp');
+  sub('docs/index.html', /(id="versionBadge"[^>]*>[^<]*v)\d+\.\d+\.\d+/, `$1${version}`, 'version badge');
+  sub('AGENTS.md', /(·\s*v)\d+\.\d+\.\d+(?=\s*$)/m, `$1${version}`, 'facts-line stamp');
 
-  console.log(`Synced project.faf version to ${version}`);
+  console.log(changed.length ? `Synced v${version} → ${changed.join(', ')}` : `All stamps already at v${version}`);
 } catch (error) {
   console.error('Failed to sync version:', error.message);
   process.exit(1);

package/skills/faf-ide/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: faf-ide
+description: Use FAF context and IDE interop tools on this server — score, sync, platform formats; claim equals wire.
+---
+
+# faf-ide
+
+Product playbook for **faf-mcp** (`one.faf/faf-mcp`) — IANA `.faf` project context over MCP for Cursor, VS Code, Windsurf, Cline-class hosts.
+
+**Transport:** local stdio (`npx` / `bunx faf-mcp`). Skills guide; tools act.
+
+## Tools (call these)
+
+| Tool | When |
+|------|------|
+| `faf_auto` | Zero → context in one shot (init, detect, sync, score) |
+| `faf_init` | Create or enhance `project.faf` |
+| `faf_score` | AI-readiness 0–100% + gaps |
+| `faf_context` | Current project context snapshot |
+| `faf_sync` | Reconcile `project.faf` with package.json / git (dry-run; `apply:true` writes) |
+| `faf_claude` | Write CLAUDE.md + IDE format files from `project.faf` |
+| `faf_cursor` | Cursor / `.cursorrules` interop |
+| `faf_agents` | `AGENTS.md` interop |
+| `faf_gemini` | Gemini context interop |
+| `faf_about` | What `.faf` is (format overview) |
+
+Default `tools/list` is a curated Core set; more tools may exist when `FAF_TOOLS=all`. Only call tools this server lists.
+
+## Rules
+
+1. Prefer **structured `.faf`** over free-form chat memory for project facts.
+2. **Claim equals wire** — only tools advertised by this server.
+3. **No secrets** in skill text or tool args you do not own.
+4. **Origin** — served by faf-mcp (`skills/*` + `resources/read`); not a remote install authority.
+
+## Flow
+
+```text
+initialize → skills/list → resources/read(skill://faf-ide/SKILL.md) → tools/call
+```

package/dist/src/config/visibility.d.ts

@@ -1,41 +0,0 @@
-/**
- * 🏎️ FAF Tool Visibility Configuration - v2.8.0
- * Controls which tools are visible (core vs all)
- * Championship-grade configuration management
- */
-export interface VisibilityConfig {
-    showAdvanced: boolean;
-    source: 'env' | 'flag' | 'config' | 'default';
-}
-export interface FafConfig {
-    showAdvanced?: boolean;
-    [key: string]: unknown;
-}
-/**
- * Get visibility configuration from multiple sources
- * Priority: ENV var > config file > default
- */
-export declare function getVisibilityConfig(): VisibilityConfig;
-/**
- * Read configuration from .fafrc file
- * Checks multiple locations:
- * 1. ~/.fafrc (home directory)
- * 2. ./.fafrc (current working directory)
- */
-export declare function readConfigFile(): FafConfig | null;
-/**
- * Write configuration to ~/.fafrc file
- */
-export declare function writeConfigFile(config: FafConfig): boolean;
-/**
- * Enable advanced tools
- */
-export declare function enableAdvancedTools(): boolean;
-/**
- * Disable advanced tools (show core only)
- */
-export declare function disableAdvancedTools(): boolean;
-/**
- * Get current tool visibility status (for logging)
- */
-export declare function getVisibilityStatus(): string;

package/dist/src/config/visibility.js

@@ -1,158 +0,0 @@
-"use strict";
-/**
- * 🏎️ FAF Tool Visibility Configuration - v2.8.0
- * Controls which tools are visible (core vs all)
- * Championship-grade configuration management
- */
-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.getVisibilityConfig = getVisibilityConfig;
-exports.readConfigFile = readConfigFile;
-exports.writeConfigFile = writeConfigFile;
-exports.enableAdvancedTools = enableAdvancedTools;
-exports.disableAdvancedTools = disableAdvancedTools;
-exports.getVisibilityStatus = getVisibilityStatus;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const os = __importStar(require("os"));
-/**
- * Get visibility configuration from multiple sources
- * Priority: ENV var > config file > default
- */
-function getVisibilityConfig() {
-    // 1. Check ENV: FAF_MCP_SHOW_ADVANCED=true
-    if (process.env.FAF_MCP_SHOW_ADVANCED === 'true') {
-        return { showAdvanced: true, source: 'env' };
-    }
-    // 2. Check config file: ~/.fafrc or .fafrc
-    const configFile = readConfigFile();
-    if (configFile?.showAdvanced === true) {
-        return { showAdvanced: true, source: 'config' };
-    }
-    // 3. Default: core only (changed from "show all" to align with spec)
-    // NOTE: For backward compatibility during transition, you may want to
-    // temporarily set default to `true` and notify users to update config
-    return { showAdvanced: false, source: 'default' };
-}
-/**
- * Read configuration from .fafrc file
- * Checks multiple locations:
- * 1. ~/.fafrc (home directory)
- * 2. ./.fafrc (current working directory)
- */
-function readConfigFile() {
-    const configPaths = [
-        path.join(os.homedir(), '.fafrc'),
-        path.join(process.cwd(), '.fafrc'),
-    ];
-    for (const configPath of configPaths) {
-        try {
-            if (fs.existsSync(configPath)) {
-                const content = fs.readFileSync(configPath, 'utf-8');
-                // Support both JSON and simple key=value format
-                if (content.trim().startsWith('{')) {
-                    // JSON format
-                    return JSON.parse(content);
-                }
-                else {
-                    // Simple key=value format
-                    const config = {};
-                    const lines = content.split('\n');
-                    for (const line of lines) {
-                        const trimmed = line.trim();
-                        if (!trimmed || trimmed.startsWith('#'))
-                            continue;
-                        const [key, value] = trimmed.split('=').map((s) => s.trim());
-                        if (key === 'showAdvanced' || key === 'FAF_SHOW_ADVANCED') {
-                            config.showAdvanced = value === 'true';
-                        }
-                    }
-                    return config;
-                }
-            }
-        }
-        catch (error) {
-            // Silently ignore config file errors - graceful degradation
-            // Config file is optional, errors are non-critical
-        }
-    }
-    return null;
-}
-/**
- * Write configuration to ~/.fafrc file
- */
-function writeConfigFile(config) {
-    const configPath = path.join(os.homedir(), '.fafrc');
-    try {
-        const content = JSON.stringify(config, null, 2);
-        fs.writeFileSync(configPath, content, 'utf-8');
-        return true;
-    }
-    catch (error) {
-        // Silent failure - config file write is optional
-        return false;
-    }
-}
-/**
- * Enable advanced tools
- */
-function enableAdvancedTools() {
-    const config = readConfigFile() || {};
-    config.showAdvanced = true;
-    return writeConfigFile(config);
-}
-/**
- * Disable advanced tools (show core only)
- */
-function disableAdvancedTools() {
-    const config = readConfigFile() || {};
-    config.showAdvanced = false;
-    return writeConfigFile(config);
-}
-/**
- * Get current tool visibility status (for logging)
- */
-function getVisibilityStatus() {
-    const config = getVisibilityConfig();
-    const toolCount = config.showAdvanced ? '51 (ALL)' : '20 (CORE)';
-    const sourceEmoji = {
-        env: '🌍',
-        flag: '🚩',
-        config: '⚙️',
-        default: '🏁',
-    };
-    return `${sourceEmoji[config.source]} ${toolCount} tools via ${config.source.toUpperCase()}`;
-}
-//# sourceMappingURL=visibility.js.map

package/dist/src/config/visibility.js.map

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

package/dist/src/faf-core/commands/audit.d.ts

@@ -1,21 +0,0 @@
-/**
- * 🔍 faf audit - Comprehensive Quality Audit (Mk3 Bundled)
- * Audit project.faf quality and completeness
- */
-export interface AuditOptions {
-    json?: boolean;
-    verbose?: boolean;
-}
-export interface AuditResult {
-    success: boolean;
-    score: number;
-    grade: string;
-    issues: Array<{
-        severity: 'high' | 'medium' | 'low';
-        message: string;
-        fix?: string;
-    }>;
-    strengths: string[];
-    message: string;
-}
-export declare function auditFafFile(projectPath?: string, options?: AuditOptions): Promise<AuditResult>;