diagrams/request-pipeline.mmd

		, persisted in
		in ; consumed by
		, persisted in

RESILIENCE_GUIDE.md and the dedicated section in CLAUDE.md.

---

(Zod-validated at load).
1. if custom logic is required (extend ).
2. if it does not speak OpenAI format.
3. and .
4. (or the format-specific registry under ).
5. .

.
2. .
3. (denylist for the public API surface).
4. .
5. and .

and import from .
2. , numbered sequentially, idempotent, transactional.
3. (re-export only — no logic).
4. .

(or extend ).
1. .
2. .
3. .
4. MCP-SERVER.md.

A2A-SERVER.md § Adding a New Skill. Skills live in and are registered through the A2A task manager.

---

Code style: 2-space indent, double quotes, 100 char width, semicolons, trailing commas — enforced by Prettier via .
• Imports: external → internal (, ) → relative.
• Naming: files or , components , constants .
• ESLint: , , = everywhere; = in and , error elsewhere.
• TypeScript: (legacy posture). Prefer explicit types over inference for cross-module boundaries.
• Database: never write raw SQL in routes or handlers — always go through modules. Never add logic to .
• Errors: try/catch with specific error types, log with pino context. Never silently swallow errors in SSE streams; use abort signals for cleanup.
• Security: never use / / implied eval. Validate all inputs with Zod. Encrypt credentials at rest (AES-256-GCM). Keep denylist aligned with the sanitize/validation layer.
• Commits: Conventional Commits — . Allowed scopes: , , , , , , , , , , , .
• Branches: prefixes , , , , , . Never commit directly to .
• Husky: pre-commit runs + + ; pre-push runs .

---

1. .
2. / / implied eval.
3. .
4. modules.

---

ARCHITECTURE.md — high-level architecture and module responsibilities.
• API_REFERENCE.md — public + management API reference.
• FEATURES.md — feature matrix and version highlights.
• RESILIENCE_GUIDE.md — circuit breaker, cooldown, lockout deep dive.
• AUTO-COMBO.md — Auto Combo scoring and strategies.
• MCP-SERVER.md — full MCP tool catalog + transports.
• A2A-SERVER.md — A2A protocol skills and discovery.
• COMPRESSION_GUIDE.md — RTK + Caveman compression.
• CLI-TOOLS.md — CLI integrations.
• ELECTRON_GUIDE.md (if present), DOCKER_GUIDE.md, FLY_IO_DEPLOYMENT_GUIDE.md, VM_DEPLOYMENT_GUIDE.md, TERMUX_GUIDE.md, PWA_GUIDE.md — deployment targets.
• TROUBLESHOOTING.md — common operational issues.
• CONTRIBUTING.md — contributor workflow.
• CLAUDE.md — repo rules for Claude Code (the source of truth for many of the conventions above).
• AGENTS.md — deeper architecture reference used by agents.