feat: self-improvement system — logging, perf monitoring, retrospectives

[AgentWrapper]

Summary

Full self-improvement system for ao: structured logging, API performance monitoring, session retrospectives, dashboard management, and comprehensive tests.

Core Infrastructure

• JSONL log writer (log-writer.ts): size-based rotation, crash-safe appendFileSync, configurable backups
• Log reader (log-reader.ts): query/filter by time, level, source, session, pattern; reads across rotated files; tail support
• Session report cards (session-report-card.ts): per-session metrics (CI attempts, review rounds, outcome, duration)
• Retrospectives (retrospective.ts): post-session analysis with timeline, metrics, and heuristic lessons
• Dashboard manager (dashboard-manager.ts): programmatic restartDashboard() for orchestrator agent to kill/clean/restart Next.js without CLI
• Path utilities: getLogsDir(), getRetrospectivesDir()

CLI Commands

• ao logs dashboard|events|session — query structured logs
• ao perf routes|slow|cache|enrichment — API performance analysis
• ao retro list|show|generate — session retrospective management
• ao dashboard restart|status|logs — dashboard process management with PID tracking

Dashboard (Web)

• /logs page with LogViewer component (filterable by source, level, time, session)
• /perf page with PerfDashboard component (route stats, slow requests, cache hit rates)
• POST /api/client-logs — browser-side error/perf ingestion
• GET /api/logs, GET /api/perf — log and performance query APIs
• ClientLogger component: captures window.onerror, PerformanceObserver, fetch timing
• Cache hit/miss tracking in TTLCache.getStats()
• API request timing in /api/sessions route
• PR enrichment timing in serialize.ts

Event Persistence & Lifecycle

• Lifecycle manager writes events to events.jsonl with full state transition data
• Auto-generates retrospectives on session merge/kill
• Session manager passes AO_PROJECT_ID and AO_LOG_DIR env vars to spawned sessions

Tests (101 new)

• log-writer.test.ts (13): append, rotation, close, auto-create dirs, write failure
• log-reader.test.ts (42): all filters, corrupted lines, readLogsFromDir, tailLogs
• session-report-card.test.ts (24): transitions, CI/review counting, outcomes, duration
• retrospective.test.ts (15): save/load, filters, corrupted JSON, round-trip
• cache.test.ts (7 new): getStats hit/miss tracking, hit rate, size

Bugbot Fixes

• Background mode log capture uses file descriptors instead of pipes (survives parent exit)
• Fixed visibilitychange listener leak in client-logger
• Removed dead code (with-timing.ts, unused getRequestStats)
• Fixed port conflict detection logic in dashboard status
• Implemented --since option in dashboard logs subcommand

Test plan

• pnpm test — all 927 tests pass
• pnpm typecheck — 0 errors
• pnpm lint — 0 errors
• ao start — dashboard logs captured to JSONL
• ao logs dashboard --tail 20 — shows recent output
• ao dashboard restart --clean --wait — kills, cleans .next, restarts
• ao perf routes — per-route p50/p95/p99
• ao retro list — shows retrospectives
• Dashboard /logs and /perf pages render

🤖 Generated with Claude Code

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}