How reseaxch/podo works
Podo detects software incidents from telemetry and CI evidence, builds causal context, supports read-only investigation, then gates tested remediation and delivery on explicit approvals. Operators use the dashboard or terminal clients against the shared Core API. The graph emphasizes the documented vertical workflow and major integrations; several runtime modules are represented by their exact tree paths because their source was not sampled.
Main entry points: app.ts Core API · incident-monitor.ts Incident monitor · index.ts Typed client · incident-remediation.ts Remediation workflow
Components 23
Operator clients
- Dashboard
apps/dashboard/app/components/production-incident-workspace.tsx - CLI
apps/cli/src/index.ts - Terminal UI
apps/tui/src/app.tsx - Typed client
packages/client/src/index.ts
Core workflows
- Core API
apps/core/src/app.ts - Incident monitor
apps/core/src/modules/incidents/incident-monitor.ts - Telemetry intake
apps/core/src/modules/telemetry/index.ts - Incident registry
apps/core/src/modules/incidents/build-incident-registry.ts - System graph
apps/core/src/modules/graph/in-memory-graph.ts - Causal analysis
apps/core/src/modules/graph/incident-causal-path.ts - Investigation
apps/core/src/modules/investigation/incident-investigation.ts - Evidence diagnosis
packages/domain/src/diagnosis.ts - Audit trail
apps/core/src/modules/audit/incident-audit.ts
Execution and delivery
- Remediation workflow
apps/core/src/modules/remediation/incident-remediation.ts - Worktree executor
apps/core/src/modules/remediation/local-worktree-remediation-executor.ts - Codex runtime
apps/core/src/runtime/production-codex-runtime.ts - PR delivery
apps/core/src/modules/remediation/incident-delivery.ts
Evidence integrations
- GitHub adapters
plugins/github/src/index.ts - OTel replay
plugins/otel-replay/src/index.ts - Graphify adapter
plugins/graphify/src/index.ts - GitHub Actions
apps/core/src/runtime/production-github-actions.ts
Other components
- Operator
- Telemetry signals
Connections 24
- Operator → Dashboard: operates
- Operator → CLI: runs commands
- Operator → Terminal UI: operates
- Dashboard → Typed client: uses
- CLI → Typed client: uses
- Terminal UI → Typed client: uses
- Typed client → Core API: calls API
- Telemetry signals → OTel replay: provide telemetry
- OTel replay → Telemetry intake: replays events
- Telemetry intake → Incident monitor: feeds detection
- Incident monitor → System graph: reads context
- Incident monitor → Causal analysis: builds causal path
- GitHub Actions → Incident registry: registers failures
- GitHub adapters → GitHub Actions: supplies run evidence
- Graphify adapter → System graph: populates graph
- Core API → Incident monitor: routes incidents
- Core API → Investigation: starts investigation
- Investigation → Evidence diagnosis: grounds diagnosis
- Core API → Remediation workflow: starts remediation
- Remediation workflow → Codex runtime: requests patch
- Remediation workflow → Worktree executor: tests patch
- Core API → PR delivery: starts delivery
- PR delivery → GitHub adapters: publishes PR
- Core API → Audit trail: reads audit