agent-valley 3.0.4 → 4.0.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.
- package/README.md +69 -69
- package/dist/assets/plugin.json +1 -1
- package/dist/assets/skills/av/SKILL.md +1 -0
- package/dist/index.js +1385 -453
- package/dist/supervisor.js +65 -30
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -126,10 +126,10 @@ bun av issue "refactor auth" --breakdown # Auto-decompose into sub-tas
|
|
|
126
126
|
|
|
127
127
|
Two YAML config files, merged at startup (project wins over global):
|
|
128
128
|
|
|
129
|
-
| File
|
|
130
|
-
|
|
131
|
-
| `~/.config/agent-valley/settings.yaml` | Global (user) | API key, actor defaults, team dashboard
|
|
132
|
-
| `av.yaml`
|
|
129
|
+
| File | Scope | Description |
|
|
130
|
+
| -------------------------------------- | ------------- | ----------------------------------------------------- |
|
|
131
|
+
| `~/.config/agent-valley/settings.yaml` | Global (user) | API key, actor defaults, team dashboard |
|
|
132
|
+
| `av.yaml` | Project | Team config, workspace root, prompt template, routing |
|
|
133
133
|
|
|
134
134
|
Run `av setup` to create both files interactively, or follow [agent-led setup](./AGENT_SETUP.md) for an unattended installation using the initiating agent as Chief Director. See `av.example.yaml` for format reference.
|
|
135
135
|
|
|
@@ -142,14 +142,14 @@ linear:
|
|
|
142
142
|
api_key: lin_api_xxx
|
|
143
143
|
|
|
144
144
|
actor:
|
|
145
|
-
type: claude
|
|
145
|
+
type: claude # Default actor: claude / codex / antigravity / cursor / grok / kimi / opencode
|
|
146
146
|
timeout: 3600
|
|
147
147
|
max_retries: 3
|
|
148
|
-
max_parallel: 3
|
|
148
|
+
max_parallel: 3 # Max concurrent actor runs (default: hardware-detected recommendation)
|
|
149
149
|
|
|
150
150
|
logging:
|
|
151
|
-
level: info
|
|
152
|
-
format: json
|
|
151
|
+
level: info # debug / info / warn / error
|
|
152
|
+
format: json # json / text
|
|
153
153
|
|
|
154
154
|
server:
|
|
155
155
|
port: 9741
|
|
@@ -171,7 +171,7 @@ explicit administration machine. See [team ledger setup and migration](./docs/gu
|
|
|
171
171
|
```yaml
|
|
172
172
|
# Tracker selector (v0.2+). Defaults to `linear` when omitted.
|
|
173
173
|
tracker:
|
|
174
|
-
kind: linear
|
|
174
|
+
kind: linear # linear | github
|
|
175
175
|
|
|
176
176
|
linear:
|
|
177
177
|
team_id: ACR
|
|
@@ -199,7 +199,7 @@ workspace:
|
|
|
199
199
|
root: /absolute/path/to/target-repo
|
|
200
200
|
|
|
201
201
|
delivery:
|
|
202
|
-
mode: merge
|
|
202
|
+
mode: merge # merge (auto merge+push) or pr (create draft PR)
|
|
203
203
|
|
|
204
204
|
prompt: |
|
|
205
205
|
You are working on {{issue.identifier}}: {{issue.title}}.
|
|
@@ -215,7 +215,7 @@ routing:
|
|
|
215
215
|
workspace_root: /path/to/frontend
|
|
216
216
|
actor_type: codex
|
|
217
217
|
delivery_mode: pr
|
|
218
|
-
verify_command: "pytest && mypy ."
|
|
218
|
+
verify_command: "pytest && mypy ." # overrides verify.command below for this route
|
|
219
219
|
|
|
220
220
|
# Verification Gate (required for code tasks). Runs before delivery and before the
|
|
221
221
|
# issue transitions to Done; on failure the actor retries with the captured
|
|
@@ -228,9 +228,9 @@ verify:
|
|
|
228
228
|
scoring:
|
|
229
229
|
model: haiku
|
|
230
230
|
routes:
|
|
231
|
-
easy:
|
|
231
|
+
easy: { min: 1, max: 3, actor: antigravity }
|
|
232
232
|
medium: { min: 4, max: 7, actor: codex }
|
|
233
|
-
hard:
|
|
233
|
+
hard: { min: 8, max: 10, actor: claude }
|
|
234
234
|
|
|
235
235
|
# Actor Budget Caps (optional, v0.2+). Omit to disable (default).
|
|
236
236
|
# budget:
|
|
@@ -320,37 +320,37 @@ Dependency arrows point **downward only**. See `docs/architecture/LAYERS.md`.
|
|
|
320
320
|
Since v0.2 the Application layer talks to the outside world through four
|
|
321
321
|
domain ports so adapters can be swapped without touching the orchestrator:
|
|
322
322
|
|
|
323
|
-
| Port
|
|
324
|
-
|
|
325
|
-
| `IssueTracker`
|
|
326
|
-
| `WebhookReceiver<TEvent>` | Verify signature + parse to `ParsedWebhookEvent`
|
|
327
|
-
| `WorkspaceGateway`
|
|
328
|
-
| `AgentRunnerPort`
|
|
323
|
+
| Port | Purpose | Current adapters |
|
|
324
|
+
| ------------------------- | --------------------------------------------------- | ------------------------------------------------ |
|
|
325
|
+
| `IssueTracker` | Fetch / update issues, post comments, attach labels | `LinearTrackerAdapter`, `GitHubTrackerAdapter` |
|
|
326
|
+
| `WebhookReceiver<TEvent>` | Verify signature + parse to `ParsedWebhookEvent` | `LinearWebhookReceiver`, `GitHubWebhookReceiver` |
|
|
327
|
+
| `WorkspaceGateway` | Per-issue worktree lifecycle + delivery | `FileSystemWorkspaceGateway` |
|
|
328
|
+
| `AgentRunnerPort` | Spawn actors + expose `RunHandle` for interventions | `SpawnAgentRunnerAdapter` |
|
|
329
329
|
|
|
330
330
|
### The 7 Symphony Components
|
|
331
331
|
|
|
332
|
-
| #
|
|
333
|
-
|
|
334
|
-
| 1
|
|
335
|
-
| 2
|
|
336
|
-
| 3
|
|
337
|
-
| 4
|
|
338
|
-
| 5
|
|
339
|
-
| 6
|
|
340
|
-
| 7
|
|
332
|
+
| # | Component | Responsibility | Spec |
|
|
333
|
+
| --- | --------------------- | ----------------------------------------------------------------------------- | --------------------------------- |
|
|
334
|
+
| 1 | **Workflow Loader** | Prompt template rendering + input sanitization | `docs/specs/workflow-loader.md` |
|
|
335
|
+
| 2 | **Config Layer** | YAML config loader (settings.yaml + av.yaml) + Zod validation | `docs/specs/config-layer.md` |
|
|
336
|
+
| 3 | **Tracker Client** | Linear GraphQL — fetch issues, state transitions, comments, HMAC verification | `docs/specs/tracker-client.md` |
|
|
337
|
+
| 4 | **Orchestrator** | Webhook event handler, state machine, retry queue, DAG scheduler | `docs/specs/orchestrator.md` |
|
|
338
|
+
| 5 | **Workspace Manager** | Per-issue git worktree creation, merge/PR, cleanup | `docs/specs/workspace-manager.md` |
|
|
339
|
+
| 6 | **Actor Runner** | AgentSession abstraction, timeout enforcement, parallel execution | `docs/specs/agent-runner.md` |
|
|
340
|
+
| 7 | **Observability** | Structured JSON logs, system metrics, SSE status surface | `docs/specs/observability.md` |
|
|
341
341
|
|
|
342
342
|
### Actor Session Plugins
|
|
343
343
|
|
|
344
|
-
| Actor
|
|
345
|
-
|
|
346
|
-
| Claude Code | `claude`
|
|
347
|
-
| Codex
|
|
348
|
-
| Qwen Code
|
|
349
|
-
| Antigravity | `antigravity` | `agy`
|
|
350
|
-
| Cursor
|
|
351
|
-
| Grok
|
|
352
|
-
| Kimi
|
|
353
|
-
| OpenCode
|
|
344
|
+
| Actor | Config value | Executable |
|
|
345
|
+
| ----------- | ------------- | -------------- |
|
|
346
|
+
| Claude Code | `claude` | `claude` |
|
|
347
|
+
| Codex | `codex` | `codex` |
|
|
348
|
+
| Qwen Code | `qwen` | `qwen` |
|
|
349
|
+
| Antigravity | `antigravity` | `agy` |
|
|
350
|
+
| Cursor | `cursor` | `cursor-agent` |
|
|
351
|
+
| Grok | `grok` | `grok` |
|
|
352
|
+
| Kimi | `kimi` | `kimi` |
|
|
353
|
+
| OpenCode | `opencode` | `opencode` |
|
|
354
354
|
|
|
355
355
|
Extensible via `registerSession()` — implement the `AgentSession` interface to add custom actors.
|
|
356
356
|
|
|
@@ -369,19 +369,19 @@ PixiJS-rendered office scene showing real-time actor status:
|
|
|
369
369
|
|
|
370
370
|
### API Endpoints
|
|
371
371
|
|
|
372
|
-
| Endpoint
|
|
373
|
-
|
|
374
|
-
| `/api/webhook`
|
|
375
|
-
| `/api/webhook/github` | POST
|
|
376
|
-
| `/api/events`
|
|
377
|
-
| `/api/status`
|
|
378
|
-
| `/api/health`
|
|
379
|
-
| `/api/intervention`
|
|
380
|
-
| `/api/metrics`
|
|
381
|
-
| `/api/team/ledger`
|
|
382
|
-
| `/api/team/session`
|
|
383
|
-
| `/api/team/relay`
|
|
384
|
-
| `/api/team/relay`
|
|
372
|
+
| Endpoint | Method | Description |
|
|
373
|
+
| --------------------- | ------ | ---------------------------------------------------------------------------------- |
|
|
374
|
+
| `/api/webhook` | POST | Linear webhook receiver (HMAC-SHA256 verified) |
|
|
375
|
+
| `/api/webhook/github` | POST | GitHub webhook receiver (HMAC-SHA256 verified) |
|
|
376
|
+
| `/api/events` | GET | SSE stream for real-time dashboard updates |
|
|
377
|
+
| `/api/status` | GET | JSON orchestrator status snapshot |
|
|
378
|
+
| `/api/health` | GET | Health check (503 if the orchestrator is unavailable or stopped) |
|
|
379
|
+
| `/api/intervention` | POST | Live actor intervention; local by default, token-authenticated when configured |
|
|
380
|
+
| `/api/metrics` | GET | Prometheus-format metrics (enabled via `observability.prometheus.enabled`) |
|
|
381
|
+
| `/api/team/ledger` | GET | Replayed team state for the local browser; dashboard status authentication applies |
|
|
382
|
+
| `/api/team/session` | GET | Validate an AV team bearer token for `team_id` |
|
|
383
|
+
| `/api/team/relay` | GET | Read team events after a sequence cursor using an AV team bearer token |
|
|
384
|
+
| `/api/team/relay` | POST | Publish a validated event using an AV team bearer token; enforces node ownership |
|
|
385
385
|
|
|
386
386
|
---
|
|
387
387
|
|
|
@@ -453,9 +453,9 @@ curl -fsSL https://raw.githubusercontent.com/first-fluke/agent-valley/main/scrip
|
|
|
453
453
|
|
|
454
454
|
### CI/CD
|
|
455
455
|
|
|
456
|
-
| Workflow
|
|
457
|
-
|
|
458
|
-
| `ci.yml`
|
|
456
|
+
| Workflow | Trigger | Purpose |
|
|
457
|
+
| ---------------- | ------------------------- | ---------------------- |
|
|
458
|
+
| `ci.yml` | Push/PR to main | `validate.sh` + tests |
|
|
459
459
|
| `harness-gc.yml` | Weekly (Sunday 00:00 UTC) | Stale worktree cleanup |
|
|
460
460
|
|
|
461
461
|
---
|
|
@@ -477,15 +477,15 @@ Full documentation: `docs/harness/SAFETY.md`
|
|
|
477
477
|
|
|
478
478
|
## Architecture Constraints
|
|
479
479
|
|
|
480
|
-
| #
|
|
481
|
-
|
|
482
|
-
| 1
|
|
483
|
-
| 2
|
|
484
|
-
| 3
|
|
485
|
-
| 4
|
|
486
|
-
| 5
|
|
487
|
-
| 6
|
|
488
|
-
| 7
|
|
480
|
+
| # | Rule | Rationale |
|
|
481
|
+
| --- | -------------------------------------------- | ------------------------------------- |
|
|
482
|
+
| 1 | No framework imports in Domain layer | Domain stays pure and testable |
|
|
483
|
+
| 2 | No business logic in routers | Presentation delegates to Application |
|
|
484
|
+
| 3 | No hardcoded secrets | Config YAML only (gitignored) |
|
|
485
|
+
| 4 | Issue body is untrusted | Sanitize at boundary |
|
|
486
|
+
| 5 | Max 500 lines per file | Readability |
|
|
487
|
+
| 6 | No shared mutable state outside Orchestrator | Single state authority |
|
|
488
|
+
| 7 | Error messages must include fix instructions | Agents self-correct from errors |
|
|
489
489
|
|
|
490
490
|
Full list with examples: `docs/architecture/CONSTRAINTS.md`
|
|
491
491
|
|
|
@@ -504,12 +504,12 @@ Claude Code sub-agents are available in `.claude/agents/`:
|
|
|
504
504
|
|
|
505
505
|
## Metrics
|
|
506
506
|
|
|
507
|
-
| Metric
|
|
508
|
-
|
|
509
|
-
| **Time to PR**
|
|
510
|
-
| **CI pass rate**
|
|
511
|
-
| **Review time per PR** | Average human reviewer time per PR
|
|
512
|
-
| **Doc freshness**
|
|
507
|
+
| Metric | Description |
|
|
508
|
+
| ---------------------- | ------------------------------------------------------- |
|
|
509
|
+
| **Time to PR** | Issue assigned → PR created |
|
|
510
|
+
| **CI pass rate** | PRs that pass CI on the first run |
|
|
511
|
+
| **Review time per PR** | Average human reviewer time per PR |
|
|
512
|
+
| **Doc freshness** | Days since `AGENTS.md` last updated (flag if > 30 days) |
|
|
513
513
|
|
|
514
514
|
---
|
|
515
515
|
|
package/dist/assets/plugin.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
|
|
3
3
|
"name": "av",
|
|
4
|
-
"version": "
|
|
4
|
+
"version": "4.0.1",
|
|
5
5
|
"description": "Delegate repository goals to Agent Valley and inspect mission progress and verification evidence.",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "Agent Valley"
|