Fix documentation consistency: Add missing toolNormalization to CONFIGURATION.md and resolve cross-reference issues

[Copilot]

Problem

The enableOpenAINormalization configuration option was only documented in OPENAI_TOOL_NORMALIZATION.md but completely missing from the main CONFIGURATION.md guide. This created a poor user experience where users couldn't find this important OpenAI compatibility feature in the primary configuration documentation.

Additionally, the documentation had several consistency issues:

• References to non-existent gabpMode configuration field
• Missing cross-references between related guides
• Outdated GABP architecture descriptions
• Incomplete command line flag documentation

Solution

Added toolNormalization to Main Configuration Guide

The CONFIGURATION.md now includes a complete toolNormalization section with all options:

{
  "version": "1.0",
  "toolNormalization": {
    "enableOpenAINormalization": false,
    "maxToolNameLength": 64,
    "preserveOriginalName": true
  },
  "games": {
    // ... game configurations
  }
}

Fixed Code-Documentation Inconsistencies

• Removed gabpMode references: This field doesn't exist in the actual GameConfig struct but was shown in documentation examples
• Updated GABP architecture: Documentation now correctly reflects the local-only communication model currently implemented
• Fixed bridge configuration: Accurate representation of the actual BridgeJSON structure

Added Comprehensive Cross-Reference System

Every documentation file now includes clear cross-references:

• README.md provides a complete navigation index
• Each guide links to related documentation
• Users can easily navigate between configuration, integration, and advanced topics

Completed Command Line Documentation

Added missing CLI flags and corrected environment variables:

• --log-level, --grace flags now documented
• Fixed environment variable names (GABS_CONFIG_DIR vs outdated GAB_CONFIG_DIR)
• Added complete mod environment variables (GABP_SERVER_PORT, GABP_TOKEN, etc.)

Impact

Users can now:

1. Find enableOpenAINormalization easily in the main configuration guide
2. Navigate seamlessly between related documentation topics
3. Trust the examples - all configuration examples match the actual code implementation
4. Reference complete CLI options - no more guessing about available flags

The documentation is now fully consistent with the codebase and provides a cohesive user experience.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.