Summary
This ticket formalizes critical infrastructure stability patches discovered during a localized breakdown of the Memory Core and Neural Link MCP servers. The standard JSON-RPC stdio transport was corrupting due to raw console output, and missing class methods were causing hard crashes during tool dispatch.
Architectural Changes
1. The Infrastructure Triage Mandate (AGENTS_STARTUP.md)
Previously, agents were instructed to ignore healthcheck failures and proceed on a degraded Golden Path. This has been explicitly reversed. If core ecosystem servers fail, agents are now strictly mandated to immediately pivot into diagnostic and self-healing workflows. Executing roadmap tasks with a sick framework ecosystem is now forbidden.
2. Eliminating stdout JSON-RPC Corruption
The MCP standard transport relies on pure JSON over stdout. Services logging raw text via console directly break the client parsers:
Memory Core / SessionService: Replaced console.log with logger.info inside the asynchronous Map-Reduce summarization pipeline.
Neural Link / RecorderService: Imported the centralized logger.mjs and refactored all console.error and console.warn statements to route through the standard logger.
3. Neural Link Runtime Crash Recovery
ConnectionService.mjs: Implemented the missing getDefaultSessionId() method. The toolService.mjs dispatch layer implicitly expected this method to exist to support auto-targeting. Its absence caused ConnectionService.getDefaultSessionId is not a function during any Neural Link tool execution where sessionId was omitted.
Acceptance Criteria
Summary
This ticket formalizes critical infrastructure stability patches discovered during a localized breakdown of the Memory Core and Neural Link MCP servers. The standard JSON-RPC
stdiotransport was corrupting due to raw console output, and missing class methods were causing hard crashes during tool dispatch.Architectural Changes
1. The Infrastructure Triage Mandate (
AGENTS_STARTUP.md)Previously, agents were instructed to ignore
healthcheckfailures and proceed on a degraded Golden Path. This has been explicitly reversed. If core ecosystem servers fail, agents are now strictly mandated to immediately pivot into diagnostic and self-healing workflows. Executing roadmap tasks with a sick framework ecosystem is now forbidden.2. Eliminating
stdoutJSON-RPC CorruptionThe MCP standard transport relies on pure JSON over
stdout. Services logging raw text viaconsoledirectly break the client parsers:Memory Core / SessionService: Replacedconsole.logwithlogger.infoinside the asynchronous Map-Reduce summarization pipeline.Neural Link / RecorderService: Imported the centralizedlogger.mjsand refactored allconsole.errorandconsole.warnstatements to route through the standard logger.3. Neural Link Runtime Crash Recovery
ConnectionService.mjs: Implemented the missinggetDefaultSessionId()method. ThetoolService.mjsdispatch layer implicitly expected this method to exist to support auto-targeting. Its absence causedConnectionService.getDefaultSessionId is not a functionduring any Neural Link tool execution wheresessionIdwas omitted.Acceptance Criteria
healthyvia thehealthchecktool.invalid character 'R' looking for beginning of valueJSON parse errors in MCP client logs.loggertrace outputs instead of raw stdout.