grok-faf-mcp

Instructions

Implementation Reference

• src/handlers/tools.ts:306-330 (handler)

  The actual handler implementation for 'faf_status'. It checks for a FAF file in the current working directory and returns its status or preview content.

  private async handleFafStatus(_args: any): Promise<CallToolResult> {  // ✅ FIXED: Prefixed unused args
    // Native implementation - no CLI needed!
    const cwd = this.engineAdapter.getWorkingDirectory();
  
    try {
      const fafResult = await findFafFile(cwd);
  
      if (!fafResult) {
        return {
          content: [{
            type: 'text',
            text: `🤖 Claude FAF Project Status:\n\n❌ No FAF file found in ${cwd}\n💡 Run faf_init to create project.faf`
          }]
        };
      }
  
      const fafContent = fs.readFileSync(fafResult.path, 'utf-8');
      const lines = fafContent.split('\n').slice(0, 20);
  
      return {
        content: [{
          type: 'text',
          text: `🤖 Claude FAF Project Status:\n\n✅ ${fafResult.filename} found in ${cwd}\n\nContent preview:\n${lines.join('\n')}`
        }]
      };

• src/handlers/tools.ts:260-261 (registration)

  Registration point within the tools handler switch statement.

  case 'faf_status':
    return await this.handleFafStatus(args);