faf-mcp 2.3.1 → 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faf-mcp",
-  "version": "2.3.1",
+  "version": "3.0.0",
   "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.",
   "icon": "./assets/icons/faf-icon-256.png",
@@ -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: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.0
   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.0 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
@@ -46,7 +48,10 @@ surfaces:
     - { 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 }

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_bi_sync` | 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>;

package/dist/src/faf-core/commands/audit.js

@@ -1,83 +0,0 @@
-"use strict";
-/**
- * 🔍 faf audit - Comprehensive Quality Audit (Mk3 Bundled)
- * Audit project.faf quality and completeness
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.auditFafFile = auditFafFile;
-const fs_1 = require("fs");
-const yaml_1 = require("../fix-once/yaml");
-const file_utils_1 = require("../utils/file-utils");
-const faf_compiler_1 = require("../compiler/faf-compiler");
-async function auditFafFile(projectPath, options = {}) {
-    try {
-        const fafPath = projectPath ? `${projectPath}/project.faf` : await (0, file_utils_1.findFafFile)();
-        if (!fafPath || !await (0, file_utils_1.fileExists)(fafPath)) {
-            return {
-                success: false,
-                score: 0,
-                grade: 'F',
-                issues: [{ severity: 'high', message: 'No project.faf file found', fix: 'Run faf init' }],
-                strengths: [],
-                message: 'No project.faf file found'
-            };
-        }
-        // Read and parse
-        const content = await fs_1.promises.readFile(fafPath, 'utf-8');
-        const fafData = (0, yaml_1.parse)(content);
-        // Run compiler scoring
-        const compiler = new faf_compiler_1.FafCompiler();
-        const scoreResult = await compiler.compile(fafPath);
-        const issues = [];
-        const strengths = [];
-        // Audit checks
-        if (!fafData.project?.name) {
-            issues.push({ severity: 'high', message: 'Missing project name', fix: 'Add project.name field' });
-        }
-        else {
-            strengths.push('Project name defined');
-        }
-        if (!fafData.project?.goal) {
-            issues.push({ severity: 'medium', message: 'Missing project goal', fix: 'Add project.goal field' });
-        }
-        else {
-            strengths.push('Project goal defined');
-        }
-        if (!fafData.stack?.frontend && !fafData.stack?.backend) {
-            issues.push({ severity: 'medium', message: 'Stack information incomplete', fix: 'Add stack details' });
-        }
-        else {
-            strengths.push('Stack information present');
-        }
-        if (!fafData.instant_context?.what_building) {
-            issues.push({ severity: 'low', message: 'Missing instant context', fix: 'Add what_building description' });
-        }
-        else {
-            strengths.push('Instant context defined');
-        }
-        // Determine grade
-        const grade = scoreResult.score >= 90 ? 'A' :
-            scoreResult.score >= 80 ? 'B' :
-                scoreResult.score >= 70 ? 'C' :
-                    scoreResult.score >= 60 ? 'D' : 'F';
-        return {
-            success: true,
-            score: scoreResult.score,
-            grade,
-            issues,
-            strengths,
-            message: `Audit complete - Score: ${scoreResult.score}% (Grade: ${grade})`
-        };
-    }
-    catch (error) {
-        return {
-            success: false,
-            score: 0,
-            grade: 'F',
-            issues: [{ severity: 'high', message: error instanceof Error ? error.message : 'Audit failed' }],
-            strengths: [],
-            message: 'Audit failed'
-        };
-    }
-}
-//# sourceMappingURL=audit.js.map

package/dist/src/faf-core/commands/audit.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../../../src/faf-core/commands/audit.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAyBH,oCA4EC;AAnGD,2BAAoC;AACpC,2CAAsD;AACtD,oDAA8D;AAC9D,2DAAuD;AAoBhD,KAAK,UAAU,YAAY,CAAC,WAAoB,EAAE,UAAwB,EAAE;IACjF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,cAAc,CAAC,CAAC,CAAC,MAAM,IAAA,wBAAW,GAAE,CAAC;QAEjF,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,IAAA,uBAAU,EAAC,OAAO,CAAC,EAAE,CAAC;YAC3C,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,GAAG;gBACV,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,2BAA2B,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC;gBACzF,SAAS,EAAE,EAAE;gBACb,OAAO,EAAE,2BAA2B;aACrC,CAAC;QACJ,CAAC;QAED,iBAAiB;QACjB,MAAM,OAAO,GAAG,MAAM,aAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,IAAA,YAAS,EAAC,OAAO,CAAC,CAAC;QAEnC,uBAAuB;QACvB,MAAM,QAAQ,GAAG,IAAI,0BAAW,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEpD,MAAM,MAAM,GAA0B,EAAE,CAAC;QACzC,MAAM,SAAS,GAAa,EAAE,CAAC;QAE/B,eAAe;QACf,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,EAAE,GAAG,EAAE,wBAAwB,EAAE,CAAC,CAAC;QACpG,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,sBAAsB,EAAE,GAAG,EAAE,wBAAwB,EAAE,CAAC,CAAC;QACtG,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;YACxD,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,8BAA8B,EAAE,GAAG,EAAE,mBAAmB,EAAE,CAAC,CAAC;QACzG,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,aAAa,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,yBAAyB,EAAE,GAAG,EAAE,+BAA+B,EAAE,CAAC,CAAC;QAC7G,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAC5C,CAAC;QAED,kBAAkB;QAClB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAC/B,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBAC/B,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;oBAC/B,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAElD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,KAAK;YACL,MAAM;YACN,SAAS;YACT,OAAO,EAAE,2BAA2B,WAAW,CAAC,KAAK,aAAa,KAAK,GAAG;SAC3E,CAAC;IAEJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC;YAChG,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,cAAc;SACxB,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -1,25 +0,0 @@
-/**
- * faf auto - Programmatic API (MCP-ready)
- * Simplified version without interactive prompts
- * No console output, returns structured data
- */
-import { type InitResult } from './init.js';
-import { type ScoreResult } from './score.js';
-export interface AutoOptions {
-    force?: boolean;
-    skipAI?: boolean;
-}
-export interface AutoResult {
-    success: boolean;
-    phase: 'init' | 'score' | 'complete';
-    initResult?: InitResult;
-    scoreResult?: ScoreResult;
-    duration?: number;
-    error?: string;
-}
-/**
- * Auto command - programmatic API
- * Initializes if needed, then scores the file
- * Returns structured data, no console output
- */
-export declare function autoCommand(directory?: string, options?: AutoOptions): Promise<AutoResult>;