DeepDebug Local Agent

AI-powered on-prem ingestion arm of the VisionHammer / DeepDebug pipeline. The local agent watches application logs, surfaces incidents, and forwards them to the gateway for downstream analysis.

• Runtime: Node.js 18+ (pure ESM, "type": "module")
• Test runner: node:test (Node built-in)
• Distribution: npm install for development; pkg-bundled binaries for production install (npm run build:all)
• Package: [email protected]

Quick start

npm install
npm test           # runs node --test (52 tests across adapters + registry)
npm start          # boots the agent (default port 5055; MCP bridge on 5056)

Configuration lives in ~/.deepdebug/config.json and via env vars (PORT, MCP_PORT, GATEWAY_URL, DEEPDEBUG_API_KEY, TENANT_ID, DISABLE_WS_TUNNEL, LEGACY_STACKS).

Companion docs:

• QUICKSTART.md — end-user install + first-run
• ENTERPRISE_DEPLOYMENT_GUIDE.md
• SECURITY_WHITEPAPER.md
• docs/legacy-connectors.md — Phase 2 legacy stack ingestion reference

Features

• Real-time application log ingestion via processManager.on('log', ...)
• AI-driven patch generation (AIVibeCodingEngine) wired to the gateway
• Workspace-scoped operations via the workspace manager
• Backup / restore with disk-indexed history
• WebSocket reverse tunnel to the gateway (startWebSocketTunnel)
• MCP HTTP bridge (startMCPHttpServer on port 5056)
• Legacy connectors — five EventEmitter adapters for legacy on-prem stacks (see below)

Legacy connectors

DeepDebug Local Agent ships five EventEmitter adapters for legacy on-prem stacks, behind a single LEGACY_STACKS env var:

• SAP (src/adapters/sap/) — watches SAP NetWeaver dev_w* work-process traces + SLOG* system logs
• IBM MQ (src/adapters/ibmmq/) — watches AMQERR0[1-3].LOG files
• AS/400 (src/adapters/as400/) — polls DSPLOG via SSH with auto-reconnect
• Oracle Forms (src/adapters/oracle-forms/) — watches *.trc trace files (Latin-1 tolerant)
• COBOL/Mainframe (src/adapters/cobol/) — watches JES2 spool exports (CRLF + 80-col tolerant)

Each adapter emits error events with a frozen 6-key shape: {adapter, errorCode, file, message, source, timestamp}.

To enable: set LEGACY_STACKS=sap,cobol (comma-separated subset of sap,ibmmq,as400,oracle-forms,cobol) in the agent's environment. When unset, the adapters are not loaded and the local-agent boot path is byte-for-byte unchanged.

Full configuration + troubleshooting reference: docs/legacy-connectors.md.

Development

npm test                 # full suite (52 tests)
npm run sync-fixtures    # refresh test/fixtures/<stack>/ from example repos
                         # (requires ~/.config/visionhammer/github-pat)
npm run lint             # eslint src/
npm run dev              # NODE_ENV=development node src/server.js

License

Proprietary — InspTech AI.