@matt82198/aesop 0.2.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/CHANGELOG.md +28 -0
  2. package/README.md +50 -260
  3. package/bin/cli.js +7 -3
  4. package/docs/HOOK-INSTALL.md +15 -56
  5. package/docs/INSTALL.md +4 -3
  6. package/docs/PORTING.md +166 -0
  7. package/docs/TEAM-STATE.md +16 -184
  8. package/docs/reproduce.md +33 -3
  9. package/driver/CLAUDE.md +50 -48
  10. package/driver/codex_driver.py +59 -12
  11. package/driver/openai_transport.py +33 -0
  12. package/driver/wave_bridge.py +9 -1
  13. package/driver/wave_loop.py +437 -70
  14. package/driver/wave_scheduler.py +890 -0
  15. package/hooks/pre-push-policy.sh +22 -5
  16. package/monitor/collect-signals.mjs +69 -0
  17. package/package.json +4 -4
  18. package/state_store/__init__.py +2 -1
  19. package/state_store/projections.py +63 -0
  20. package/state_store/read_api.py +156 -0
  21. package/state_store/write_api.py +462 -0
  22. package/tools/cost_ceiling.py +106 -15
  23. package/tools/cost_projection.py +559 -0
  24. package/tools/crossos_drift.py +394 -0
  25. package/tools/eod_sweep.py +137 -33
  26. package/tools/mutation_test.py +130 -8
  27. package/tools/proposals.mjs +47 -2
  28. package/tools/reproduce.js +405 -0
  29. package/tools/secret_scan.py +73 -18
  30. package/tools/stall_check.py +247 -16
  31. package/tools/stateapi_lint.py +325 -0
  32. package/tools/test_battery.py +173 -0
  33. package/tools/verify_cost_panel.py +345 -0
  34. package/tools/wave_preflight.py +296 -29
  35. package/tools/wave_templates.py +170 -45
  36. package/ui/collectors.py +81 -0
  37. package/ui/handler.py +230 -85
  38. package/ui/sse.py +3 -3
  39. package/ui/wave_telemetry.py +24 -18
  40. package/ui/web/dist/assets/{index-DqZLgwNg.css → index-CNQxaiOW.css} +1 -1
  41. package/ui/web/dist/assets/index-CP68RIh3.js +9 -0
  42. package/ui/web/dist/index.html +2 -2
  43. package/docs/QUICKSTART.md +0 -80
  44. package/ui/web/dist/assets/index-BGbgw2Nh.js +0 -9
package/ui/web/dist/index.html CHANGED
@@ -5,8 +5,8 @@
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
6
  <title>Aesop Fleet Dashboard</title>
7
7
  <script>window.__AESOP_CSRF_TOKEN__ = __AESOP_CSRF_SENTINEL__;</script>
8
- <script type="module" crossorigin src="/assets/index-BGbgw2Nh.js"></script>
9
- <link rel="stylesheet" crossorigin href="/assets/index-DqZLgwNg.css">
8
+ <script type="module" crossorigin src="/assets/index-CP68RIh3.js"></script>
9
+ <link rel="stylesheet" crossorigin href="/assets/index-CNQxaiOW.css">
10
10
  </head>
11
11
  <body>
12
12
  <div id="root"></div>
package/docs/QUICKSTART.md DELETED
@@ -1,80 +0,0 @@
1
- # Quickstart: 5 Minutes to Your First Wave
2
-
3
- Get from `npx @matt82198/aesop` to a working wave cycle: scaffold, verify, run the orchestrator skills, and watch it work.
4
-
5
- ---
6
-
7
- ## Step 1: Scaffold
8
-
9
- ```bash
10
- cd ~/my-repo
11
- npx @matt82198/aesop .
12
- ```
13
-
14
- Or if your repo is new:
15
- ```bash
16
- npx @matt82198/aesop my-fleet && cd my-fleet
17
- ```
18
-
19
- This installs daemons, skills, config, and a pre-push hook. Edit `aesop.config.json` to add repos.
20
-
21
- ---
22
-
23
- ## Step 2: Verify & Test
24
-
25
- ```bash
26
- npx @matt82198/aesop doctor # Preflight: Git, Node, Python, CLI, skills
27
- bash daemons/run-watchdog.sh --once # Test the watchdog daemon
28
- ```
29
-
30
- Expected: all green. See [INSTALL.md](INSTALL.md) if not.
31
-
32
- ---
33
-
34
- ## Step 3: Launch Dashboard (Optional)
35
-
36
- ```bash
37
- npx @matt82198/aesop dash # Opens http://localhost:8770
38
- ```
39
-
40
- Monitor waves in real-time. View logs, agents, heartbeats, backlog.
41
-
42
- ---
43
-
44
- ## Step 4: Run Your First Wave (in Claude Code)
45
-
46
- ### Priming
47
- ```
48
- /power
49
- ```
50
- Loads orchestrator brain, verifies system health, outputs next steps.
51
-
52
- ### Orchestrating
53
- ```
54
- /buildsystem
55
- ```
56
- Runs one complete iteration: ranks backlog → dispatches Haiku agents → verifies merges → checkpoints state → audits fleet. Typically 30 min–2 hours.
57
-
58
- ---
59
-
60
- ## Key Concepts
61
-
62
- **Local + Claude Code**: Orchestrator runs in Claude Code; subagents are Haiku dispatched via `/buildsystem`. Daemons run locally (watchdog, dashboard).
63
-
64
- **State survives wipes**: `STATE.md` and `BUILDLOG.md` are committed to git. Resume anytime.
65
-
66
- **Cost**: ~$0.03–$0.05 per wave (1 Opus + 5–8 Haikus).
67
-
68
- **No modification of your repos**: Each agent works in a sibling worktree. Primary tree stays clean.
69
-
70
- ---
71
-
72
- ## Next Steps
73
-
74
- - [CONFIGURE.md](CONFIGURE.md) — Customize repos and ports
75
- - [CONCEPTS.md](CONCEPTS.md) — Dispatch model and architecture
76
- - [FIRST-WAVE.md](FIRST-WAVE.md) — Detailed expectations and monitoring
77
- - [ANY-REPO.md](ANY-REPO.md) — Adapt to any codebase (no stack lock-in)
78
- - [HOW-THE-LOOP-WORKS.md](HOW-THE-LOOP-WORKS.md) — Concrete walkthrough
79
-
80
- **Troubleshooting**: [INSTALL.md#troubleshooting](INSTALL.md)