agent-valley 3.0.5 → 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 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 | 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 |
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 # Default actor: claude / codex / antigravity / cursor / grok / kimi / opencode
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 # Max concurrent actor runs (default: hardware-detected recommendation)
148
+ max_parallel: 3 # Max concurrent actor runs (default: hardware-detected recommendation)
149
149
 
150
150
  logging:
151
- level: info # debug / info / warn / error
152
- format: json # json / text
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 # linear | github
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 # merge (auto merge+push) or pr (create draft PR)
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 ." # overrides verify.command below for this route
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: { min: 1, max: 3, actor: antigravity }
231
+ easy: { min: 1, max: 3, actor: antigravity }
232
232
  medium: { min: 4, max: 7, actor: codex }
233
- hard: { min: 8, max: 10, actor: claude }
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 | 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` |
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
- | # | 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` |
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 | 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` |
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 | 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 |
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 | Trigger | Purpose |
457
- |---|---|---|
458
- | `ci.yml` | Push/PR to main | `validate.sh` + tests |
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
- | # | 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 |
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 | 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) |
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
 
@@ -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": "3.0.5",
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"
@@ -1,4 +1,5 @@
1
1
  ---
2
+
2
3
  name: av
3
4
  description: Delegate a repository goal or continuous improvement charter to Agent Valley's Chief Director and inspect, resume or stop its verified work. Use when the user asks AV to supervise Actors through execution, review and verification.
4
5
  ---