Initial commit: SIC harness (backend, web, pi-adapter, configs, docs)
- pnpm monorepo: apps/api (Fastify + SQLite + SSE), apps/web (React+Vite), packages/shared, packages/pi-adapter - Local auth (admin/webhook-runner roles) + Keycloak JWT ready - Multi-session chat with reliable history (user persisted before LLM, assistant persisted after stream) - Markdown knowledge base with /api/docs/search + /api/docs/:id - YAML webhook catalog with backend-only execution, retry/backoff, audit (webhook_runs), and per-user rate limit - Skills config (sre-on-call, blameless-postmortem, security-incident) injected into LLM system prompt - LLM provider failover chain (config/models.yml fallback + LLM_FALLBACK_CHAIN override) - Context-aware webhooks panel + backend id-mention safety net - Per-message stats (time/duration/tokens/model), Markdown+GFM render, code & table copy/download buttons - Vitest suite, end-to-end smoke test (scripts/smoke.mjs), per-session system prompt override - /metrics Prometheus endpoint + /api/metrics JSON, request-id correlation - dotenv with explicit repo-root path; envString/envNumber helpers (handles empty-string env) - Runbooks + SOPs under knowledge/ in English; README, docs, and INDEX.md in English
This commit is contained in:
17
docs/agents/api-agent.md
Normal file
17
docs/agents/api-agent.md
Normal file
@@ -0,0 +1,17 @@
|
||||
# API Agent
|
||||
|
||||
Owns the Fastify backend.
|
||||
|
||||
## Focus
|
||||
|
||||
- Design HTTP/SSE contracts first.
|
||||
- Persist every critical state in SQLite.
|
||||
- Validate ownership with `session_id + user_id`.
|
||||
- Emit JSON logs.
|
||||
- Keep `/healthz` and `/readyz` simple.
|
||||
|
||||
## Do not
|
||||
|
||||
- Do not keep sessions in memory.
|
||||
- Do not expose real webhook URLs to clients.
|
||||
- Do not execute webhooks without explicit confirmation.
|
||||
Reference in New Issue
Block a user