Context
We recently unified the configuration logic to use applyEnvBindings declarative schemas. This highlighted duplicated boilerplate (construct, load, proxy wrappers) across all four MCP server config.template.mjs files.
The Problem
The repetition of config.template.mjs loading logic and fallback deprecation handling violates DRY and creates architectural drift risk, making it harder to reliably change the base mechanics of the MCP servers.
The Architectural Reality
The singletons across Neo.ai.mcp.server.*.Config implement an identical load cycle: load file -> merge -> execute applyEnv().
The Fix
Extract a generic Neo.ai.mcp.server.shared.BaseConfig located at ai/mcp/server/shared/BaseConfig.mjs. Update all four servers (memory-core, knowledge-base, neural-link, github-workflow) to extend it and delegate standard file-loading and proxy wrapper generation.
Acceptance Criteria
Out of Scope
Adding new environment variables or features.
Origin Session ID
Origin Session ID: 88a6ed3a-b1b9-461a-aaf3-7c9984bd12e7
Context
We recently unified the configuration logic to use
applyEnvBindingsdeclarative schemas. This highlighted duplicated boilerplate (construct,load, proxy wrappers) across all four MCP serverconfig.template.mjsfiles.The Problem
The repetition of
config.template.mjsloading logic and fallback deprecation handling violates DRY and creates architectural drift risk, making it harder to reliably change the base mechanics of the MCP servers.The Architectural Reality
The singletons across
Neo.ai.mcp.server.*.Configimplement an identical load cycle: load file -> merge -> executeapplyEnv().The Fix
Extract a generic
Neo.ai.mcp.server.shared.BaseConfiglocated atai/mcp/server/shared/BaseConfig.mjs. Update all four servers (memory-core,knowledge-base,neural-link,github-workflow) to extend it and delegate standard file-loading and proxy wrapper generation.Acceptance Criteria
BaseConfig.mjsexists and handles deep merge + env re-apply natively.memory-coreextends it.knowledge-baseextends it.neural-linkextends it.github-workflowextends it.Out of Scope
Adding new environment variables or features.
Origin Session ID
Origin Session ID: 88a6ed3a-b1b9-461a-aaf3-7c9984bd12e7