faf-mcp 1.0.0

package/dist/src/handlers/fileHandler.js

@@ -0,0 +1,246 @@
+"use strict";
+// claude-faf-mcp/src/handlers/fileHandler.ts
+// 🏎️ FAF File Operations - Production Ready Implementation
+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.fileHandlers = exports.fafWriteTool = exports.fafReadTool = exports.PathValidator = void 0;
+exports.handleFafRead = handleFafRead;
+exports.handleFafWrite = handleFafWrite;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/**
+ * Security validator for file paths
+ */
+class PathValidator {
+    static FORBIDDEN_PATHS = ['/etc', '/sys', '/proc', '/private/etc'];
+    static MAX_FILE_SIZE = 50 * 1024 * 1024; // 50MB
+    static validate(filePath) {
+        // Normalize and resolve path
+        const normalized = path.normalize(filePath);
+        const resolved = path.resolve(filePath);
+        // Check for path traversal
+        if (normalized.includes('..')) {
+            return { valid: false, error: 'Path traversal detected' };
+        }
+        // Check forbidden paths
+        for (const forbidden of this.FORBIDDEN_PATHS) {
+            if (resolved.startsWith(forbidden)) {
+                return { valid: false, error: `Access to ${forbidden} is forbidden` };
+            }
+        }
+        return { valid: true };
+    }
+    static async checkFileSize(filePath) {
+        try {
+            const stats = await fs.stat(filePath);
+            if (stats.size > this.MAX_FILE_SIZE) {
+                return {
+                    valid: false,
+                    error: `File too large: ${(stats.size / 1024 / 1024).toFixed(2)}MB (max: 50MB)`
+                };
+            }
+            return { valid: true };
+        }
+        catch (_error) {
+            // File doesn't exist yet (for write operations)
+            return { valid: true };
+        }
+    }
+}
+exports.PathValidator = PathValidator;
+/**
+ * FAF Read Tool Definition
+ */
+exports.fafReadTool = {
+    name: 'faf_read',
+    description: 'Read content from any file on the local filesystem',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Absolute or relative file path to read'
+            }
+        },
+        required: ['path']
+    }
+};
+/**
+ * FAF Write Tool Definition
+ */
+exports.fafWriteTool = {
+    name: 'faf_write',
+    description: 'Write content to any file on the local filesystem',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Absolute or relative file path to write'
+            },
+            content: {
+                type: 'string',
+                description: 'Content to write to the file'
+            }
+        },
+        required: ['path', 'content']
+    }
+};
+/**
+ * Handle faf_read tool execution
+ */
+async function handleFafRead(args) {
+    const startTime = Date.now();
+    try {
+        const { path: filePath } = args;
+        // Validate path
+        const pathValidation = PathValidator.validate(filePath);
+        if (!pathValidation.valid) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `❌ Security error: ${pathValidation.error}`
+                    }],
+                isError: true
+            };
+        }
+        // Check file size
+        const sizeValidation = await PathValidator.checkFileSize(filePath);
+        if (!sizeValidation.valid) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `❌ ${sizeValidation.error}`
+                    }],
+                isError: true
+            };
+        }
+        // Read file with timeout
+        const content = await Promise.race([
+            fs.readFile(filePath, 'utf8'),
+            new Promise((_, reject) => setTimeout(() => reject(new Error('Read timeout (30s)')), 30000))
+        ]);
+        const duration = Date.now() - startTime;
+        const stats = await fs.stat(filePath);
+        return {
+            content: [{
+                    type: 'text',
+                    text: content
+                }],
+            metadata: {
+                duration_ms: duration,
+                file_size: stats.size,
+                file_path: path.resolve(filePath),
+                message: `✅ Read ${stats.size} bytes in ${duration}ms`
+            }
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `❌ Failed to read file: ${error.message}`
+                }],
+            isError: true
+        };
+    }
+}
+/**
+ * Handle faf_write tool execution
+ */
+async function handleFafWrite(args) {
+    const startTime = Date.now();
+    try {
+        const { path: filePath, content } = args;
+        // Validate path
+        const pathValidation = PathValidator.validate(filePath);
+        if (!pathValidation.valid) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `❌ Security error: ${pathValidation.error}`
+                    }],
+                isError: true
+            };
+        }
+        // Check content size
+        const contentSize = Buffer.byteLength(content, 'utf8');
+        if (contentSize > 50 * 1024 * 1024) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `❌ Content too large: ${(contentSize / 1024 / 1024).toFixed(2)}MB (max: 50MB)`
+                    }],
+                isError: true
+            };
+        }
+        // Create directory if needed
+        const dir = path.dirname(filePath);
+        await fs.mkdir(dir, { recursive: true });
+        // Write file with timeout
+        await Promise.race([
+            fs.writeFile(filePath, content, 'utf8'),
+            new Promise((_, reject) => setTimeout(() => reject(new Error('Write timeout (30s)')), 30000))
+        ]);
+        const duration = Date.now() - startTime;
+        return {
+            content: [{
+                    type: 'text',
+                    text: `✅ Successfully wrote ${contentSize} bytes to ${path.resolve(filePath)}`
+                }],
+            metadata: {
+                duration_ms: duration,
+                bytes_written: contentSize,
+                file_path: path.resolve(filePath),
+                message: `✅ Write completed in ${duration}ms`
+            }
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `❌ Failed to write file: ${error.message}`
+                }],
+            isError: true
+        };
+    }
+}
+// Export handlers
+exports.fileHandlers = {
+    faf_read: handleFafRead,
+    faf_write: handleFafWrite
+};
+//# sourceMappingURL=fileHandler.js.map

package/dist/src/handlers/fileHandler.js.map

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

package/dist/src/handlers/resources.d.ts

@@ -0,0 +1,18 @@
+import { Resource } from '@modelcontextprotocol/sdk/types.js';
+import { FafEngineAdapter } from './engine-adapter';
+export declare class FafResourceHandler {
+    private engineAdapter;
+    constructor(engineAdapter: FafEngineAdapter);
+    listResources(): Promise<{
+        resources: Resource[];
+    }>;
+    readResource(uri: string): Promise<{
+        contents: {
+            uri: string;
+            mimeType: string;
+            text: any;
+        }[];
+    }>;
+    private getFafContext;
+    private getFafStatus;
+}

package/dist/src/handlers/resources.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FafResourceHandler = void 0;
+class FafResourceHandler {
+    engineAdapter;
+    constructor(engineAdapter) {
+        this.engineAdapter = engineAdapter;
+    }
+    async listResources() {
+        // Get the working directory for file system resources
+        const workingDir = process.env.FAF_WORKING_DIR ?? process.cwd();
+        return {
+            resources: [
+                {
+                    uri: 'claude-faf://context',
+                    name: 'Current FAF Context',
+                    description: 'Current project FAF context and metadata',
+                    mimeType: 'application/json'
+                },
+                {
+                    uri: 'claude-faf://status',
+                    name: 'FAF Status Summary',
+                    description: 'Project health and AI readiness status',
+                    mimeType: 'text/plain'
+                },
+                // Declare file system access for the working directory
+                {
+                    uri: `file://${workingDir}`,
+                    name: 'FAF Working Directory',
+                    description: 'File system access for FAF operations',
+                    mimeType: 'text/directory'
+                }
+            ]
+        };
+    }
+    async readResource(uri) {
+        // Handle file:// URIs for file system access
+        if (uri.startsWith('file://')) {
+            return {
+                contents: [{
+                        uri: uri,
+                        mimeType: 'text/directory',
+                        text: `File system resource: ${uri.replace('file://', '')}`
+                    }]
+            };
+        }
+        switch (uri) {
+            case 'claude-faf://context':
+                return await this.getFafContext();
+            case 'claude-faf://status':
+                return await this.getFafStatus();
+            default:
+                throw new Error(`Unknown resource: ${uri}`);
+        }
+    }
+    async getFafContext() {
+        const result = await this.engineAdapter.callEngine('status', ['--json']);
+        return {
+            contents: [{
+                    uri: 'claude-faf://context',
+                    mimeType: 'application/json',
+                    text: JSON.stringify(result.success ? result.data : { error: result.error }, null, 2)
+                }]
+        };
+    }
+    async getFafStatus() {
+        const result = await this.engineAdapter.callEngine('status');
+        return {
+            contents: [{
+                    uri: 'claude-faf://status',
+                    mimeType: 'text/plain',
+                    text: result.success ? (result.data?.output ?? String(result.data)) : `Error: ${result.error ?? 'Unknown error'}`
+                }]
+        };
+    }
+}
+exports.FafResourceHandler = FafResourceHandler;
+//# sourceMappingURL=resources.js.map

package/dist/src/handlers/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../src/handlers/resources.ts"],"names":[],"mappings":";;;AAGA,MAAa,kBAAkB;IACT;IAApB,YAAoB,aAA+B;QAA/B,kBAAa,GAAb,aAAa,CAAkB;IAAG,CAAC;IAEvD,KAAK,CAAC,aAAa;QACjB,sDAAsD;QACtD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAEhE,OAAO;YACL,SAAS,EAAE;gBACT;oBACE,GAAG,EAAE,sBAAsB;oBAC3B,IAAI,EAAE,qBAAqB;oBAC3B,WAAW,EAAE,0CAA0C;oBACvD,QAAQ,EAAE,kBAAkB;iBAC7B;gBACD;oBACE,GAAG,EAAE,qBAAqB;oBAC1B,IAAI,EAAE,oBAAoB;oBAC1B,WAAW,EAAE,wCAAwC;oBACrD,QAAQ,EAAE,YAAY;iBACvB;gBACD,uDAAuD;gBACvD;oBACE,GAAG,EAAE,UAAU,UAAU,EAAE;oBAC3B,IAAI,EAAE,uBAAuB;oBAC7B,WAAW,EAAE,uCAAuC;oBACpD,QAAQ,EAAE,gBAAgB;iBAC3B;aACY;SAChB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAW;QAC5B,6CAA6C;QAC7C,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,QAAQ,EAAE,CAAC;wBACT,GAAG,EAAE,GAAG;wBACR,QAAQ,EAAE,gBAAgB;wBAC1B,IAAI,EAAE,yBAAyB,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE;qBAC5D,CAAC;aACH,CAAC;QACJ,CAAC;QAED,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,sBAAsB;gBACzB,OAAO,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YACpC,KAAK,qBAAqB;gBACxB,OAAO,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YACnC;gBACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEzE,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,sBAAsB;oBAC3B,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtF,CAAC;SACH,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAE7D,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,qBAAqB;oBAC1B,QAAQ,EAAE,YAAY;oBACtB,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE;iBAClH,CAAC;SACH,CAAC;IACJ,CAAC;CACF;AA7ED,gDA6EC"}

package/dist/src/handlers/tool-registry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 🏎️ FAF MCP Tool Registry with Visibility Support - v2.8.0
+ * Central registry for all MCP tools with metadata
+ * Championship-grade organization
+ */
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { FafMcpTool } from '../types/mcp-tools.js';
+/**
+ * Check if a tool should be visible based on configuration
+ */
+export declare function shouldShowTool(toolName: string, showAdvanced: boolean): boolean;
+/**
+ * Add metadata to a tool definition
+ */
+export declare function enrichToolWithMetadata(tool: Tool): FafMcpTool;
+/**
+ * Filter tools based on visibility configuration
+ */
+export declare function filterTools(tools: Tool[], showAdvanced: boolean): FafMcpTool[];
+/**
+ * Get tool count summary
+ */
+export declare function getToolCountSummary(showAdvanced: boolean): string;

package/dist/src/handlers/tool-registry.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * 🏎️ FAF MCP Tool Registry with Visibility Support - v2.8.0
+ * Central registry for all MCP tools with metadata
+ * Championship-grade organization
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldShowTool = shouldShowTool;
+exports.enrichToolWithMetadata = enrichToolWithMetadata;
+exports.filterTools = filterTools;
+exports.getToolCountSummary = getToolCountSummary;
+const tool_visibility_js_1 = require("../types/tool-visibility.js");
+/**
+ * Check if a tool should be visible based on configuration
+ */
+function shouldShowTool(toolName, showAdvanced) {
+    const metadata = (0, tool_visibility_js_1.getToolMetadata)(toolName);
+    // If no metadata found, show by default for backward compatibility
+    if (!metadata) {
+        return true;
+    }
+    // If showAdvanced is true, show all tools
+    if (showAdvanced) {
+        return true;
+    }
+    // Otherwise, only show core tools
+    return metadata.visibility === 'core';
+}
+/**
+ * Add metadata to a tool definition
+ */
+function enrichToolWithMetadata(tool) {
+    const metadata = (0, tool_visibility_js_1.getToolMetadata)(tool.name);
+    if (!metadata) {
+        // Return tool as-is if no metadata found
+        return tool;
+    }
+    return {
+        ...tool,
+        metadata: {
+            visibility: metadata.visibility,
+            category: metadata.category,
+            priority: metadata.priority,
+        },
+    };
+}
+/**
+ * Filter tools based on visibility configuration
+ */
+function filterTools(tools, showAdvanced) {
+    return tools
+        .filter((tool) => shouldShowTool(tool.name, showAdvanced))
+        .map((tool) => enrichToolWithMetadata(tool));
+}
+/**
+ * Get tool count summary
+ */
+function getToolCountSummary(showAdvanced) {
+    const coreCount = Object.values(tool_visibility_js_1.TOOL_REGISTRY).filter((t) => t.visibility === 'core').length;
+    const totalCount = Object.values(tool_visibility_js_1.TOOL_REGISTRY).length;
+    if (showAdvanced) {
+        return `${totalCount} tools (${coreCount} core + ${totalCount - coreCount} advanced)`;
+    }
+    else {
+        return `${coreCount} core tools`;
+    }
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/src/handlers/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../../src/handlers/tool-registry.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AASH,wCAeC;AAKD,wDAgBC;AAKD,kCAIC;AAKD,kDASC;AAjED,oEAA6E;AAG7E;;GAEG;AACH,SAAgB,cAAc,CAAC,QAAgB,EAAE,YAAqB;IACpE,MAAM,QAAQ,GAAG,IAAA,oCAAe,EAAC,QAAQ,CAAC,CAAC;IAE3C,mEAAmE;IACnE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0CAA0C;IAC1C,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kCAAkC;IAClC,OAAO,QAAQ,CAAC,UAAU,KAAK,MAAM,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,IAAU;IAC/C,MAAM,QAAQ,GAAG,IAAA,oCAAe,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,yCAAyC;QACzC,OAAO,IAAkB,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,GAAG,IAAI;QACP,QAAQ,EAAE;YACR,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,KAAa,EAAE,YAAqB;IAC9D,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;SACzD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,YAAqB;IACvD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,kCAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IAC7F,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,kCAAa,CAAC,CAAC,MAAM,CAAC;IAEvD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,GAAG,UAAU,WAAW,SAAS,WAAW,UAAU,GAAG,SAAS,YAAY,CAAC;IACxF,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,SAAS,aAAa,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/src/handlers/tool-types.d.ts

@@ -0,0 +1,167 @@
+/**
+ * 🏎️ MCP Tool Argument Types - Championship Type Safety
+ * Generated from tool schemas for compile-time safety
+ */
+export interface FafToolArgs {
+    directory?: string;
+}
+export interface FafDisplayArgs {
+    directory?: string;
+    output?: string;
+}
+export interface FafAutoArgs {
+    directory?: string;
+    force?: boolean;
+}
+export interface FafChooseArgs {
+    scan_dir?: string;
+    auto_open?: boolean;
+}
+export interface FafInitArgs {
+    directory?: string;
+    force?: boolean;
+    template?: string;
+    project_type?: string;
+}
+export interface FafShowArgs {
+    command?: 'score' | 'status' | 'auto';
+    directory?: string;
+}
+export interface FafScoreArgs {
+    directory?: string;
+    save?: boolean;
+    format?: 'markdown' | 'html' | 'json' | 'ascii';
+    full?: boolean;
+}
+export interface FafSyncArgs {
+    direction?: string;
+}
+export interface FafBiSyncArgs {
+    watch?: boolean;
+    force?: boolean;
+}
+export interface FafTrustArgs {
+    mode?: 'confidence' | 'garage' | 'panic' | 'validated';
+}
+export interface FafCreditArgs {
+    award?: boolean;
+}
+export interface FafTodoArgs {
+    add?: string;
+    complete?: number;
+}
+export interface FafChatArgs {
+    prompt?: string;
+}
+export interface FafShareArgs {
+    sanitize?: boolean;
+}
+export interface FafEnhanceArgs {
+    model?: string;
+    focus?: string;
+}
+export interface FafAnalyzeArgs {
+    model?: string;
+    depth?: string;
+    models?: string[];
+}
+export interface FafVerifyArgs {
+    checksum?: string;
+    models?: string[];
+}
+export interface FafSearchArgs {
+    query?: string;
+    type?: 'content' | 'filename' | 'both';
+    directory?: string;
+}
+export interface FafFaqArgs {
+    topic?: string;
+}
+export interface FafStatusArgs {
+    detailed?: boolean;
+    json?: boolean;
+    directory?: string;
+}
+export interface FafClearArgs {
+    cache?: boolean;
+    force?: boolean;
+    all?: boolean;
+}
+export interface FafEditArgs {
+    field?: string;
+    value?: string;
+    path?: string;
+}
+export interface FafListArgs {
+    pattern?: string;
+    path?: string;
+    recursive?: boolean;
+}
+export interface FafExistsArgs {
+    path?: string;
+}
+export interface FafDeleteArgs {
+    path?: string;
+    force?: boolean;
+    recursive?: boolean;
+}
+export interface FafMoveArgs {
+    source?: string;
+    destination?: string;
+    from?: string;
+    to?: string;
+}
+export interface FafCopyArgs {
+    source?: string;
+    destination?: string;
+    from?: string;
+    to?: string;
+}
+export interface FafMkdirArgs {
+    path?: string;
+    recursive?: boolean;
+}
+export interface FafReadArgs {
+    path: string;
+}
+export interface FafWriteArgs {
+    path: string;
+    content: string;
+}
+export interface FafFormatsArgs {
+    directory?: string;
+}
+export interface FafValidateArgs {
+    file?: string;
+}
+export interface FafDoctorArgs {
+    directory?: string;
+}
+export interface FafDnaArgs {
+    file?: string;
+}
+export interface FafLogArgs {
+    file?: string;
+    limit?: number;
+}
+export interface FafUpdateArgs {
+    file?: string;
+    force?: boolean;
+}
+export interface FafRecoverArgs {
+    file?: string;
+    timestamp?: string;
+}
+export interface FafAuthArgs {
+    action?: 'login' | 'logout' | 'status';
+}
+export interface FafAuditArgs {
+    file?: string;
+    detailed?: boolean;
+}
+export interface FafMigrateArgs {
+    directory?: string;
+    backup?: boolean;
+}
+export interface EmptyArgs {
+}

package/dist/src/handlers/tool-types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * 🏎️ MCP Tool Argument Types - Championship Type Safety
+ * Generated from tool schemas for compile-time safety
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tool-types.js.map

package/dist/src/handlers/tool-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-types.js","sourceRoot":"","sources":["../../../src/handlers/tool-types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/src/handlers/tools.d.ts

@@ -0,0 +1,25 @@
+import { CallToolResult, Tool } from '@modelcontextprotocol/sdk/types.js';
+import { FafEngineAdapter } from './engine-adapter';
+export declare class FafToolHandler {
+    private engineAdapter;
+    constructor(engineAdapter: FafEngineAdapter);
+    listTools(): Promise<{
+        tools: Tool[];
+    }>;
+    callTool(name: string, args: any): Promise<CallToolResult>;
+    private handleFafStatus;
+    private handleFafScore;
+    private handleFafInit;
+    private handleFafTrust;
+    private handleFafSync;
+    private handleFafEnhance;
+    private handleFafBiSync;
+    private handleFafClear;
+    private handleFafAbout;
+    private handleFafWhat;
+    private handleFafDebug;
+    private handleFafChat;
+    private handleFafFriday;
+    private handleFafGuide;
+    private handleFafList;
+}