ur-agent 1.22.0 → 1.22.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/CHANGELOG.md +62 -0
- package/README.md +9 -2
- package/dist/cli.js +1558 -604
- package/docs/AGENT_FEATURES.md +7 -0
- package/docs/USAGE.md +8 -1
- package/documentation/index.html +1 -1
- package/extensions/vscode-ur-inline-diffs/package.json +1 -1
- package/package.json +1 -1
package/docs/AGENT_FEATURES.md
CHANGED
|
@@ -54,6 +54,9 @@ ur worktree clean --dry-run
|
|
|
54
54
|
ur eval run starter --metrics --json
|
|
55
55
|
ur eval report starter --dashboard
|
|
56
56
|
ur eval dashboard
|
|
57
|
+
ur spec init auth-refactor --goal "refactor login without changing behavior"
|
|
58
|
+
ur spec run auth-refactor --all
|
|
59
|
+
ur spec verify auth-refactor
|
|
57
60
|
```
|
|
58
61
|
|
|
59
62
|
## v1.22.0 Additions
|
|
@@ -63,6 +66,10 @@ ur eval dashboard
|
|
|
63
66
|
| Eval execution metrics | `ur eval run <suite> --metrics`, `UR_EVAL_METRICS_FILE` | Child-serialized cost, tokens, model, duration, files changed, insertions/deletions, command failures, human-edit heuristics, and per-case `testCommand` pass/fail. Safe for parallel runs because each child writes its own metrics file. |
|
|
64
67
|
| Richer eval dashboard | `ur eval dashboard`, `ur eval report <suite> --dashboard` | Local-first HTML dashboard with summary cards and a per-case timeline showing model, time, cost, tokens, diffs, test result, command failures, and human edits. |
|
|
65
68
|
| Per-case run metrics persistence | `.ur/evals/.runs/<suite>/<case>.json` | `ur eval run <suite> --metrics` writes each case's metrics to a JSON file for downstream analysis. |
|
|
69
|
+
| Spec verification / verifier kernel role | `ur spec verify <name>`, `src/services/agents/specVerifier.ts` | Deterministic project gates first, then a read-only deep verification subagent that must prove compile/test/lint/diff/runtime before PASS. Writes `.ur/specs/<name>/verification.md` and a `verification` record in `spec.json`. First concrete kernel role: verifier is stricter than the generator. |
|
|
70
|
+
| AgentKernel abstraction | `ur spec run|verify <name> --kernel`, `src/services/agents/kernel.ts` | Pure orchestrator separating planner, executor, verifier, critic, memory, router, and guard. Routes spec run/verify through kernel stages while keeping the legacy loop as default. Foundation for applying the same orchestration to workflows, crew, and CI loop. |
|
|
71
|
+
| Rich task decomposition | `ur crew create|run|plan ... --decompose`, `src/services/agents/decomposer.ts` | Splits large goals into atomic subtasks with goal, files touched, risk level (low/medium/high), tests required, and rollback point. Deterministic fallback + optional LLM-driven JSON decomposition. |
|
|
72
|
+
| Parallel specialized subagents | `ur pattern parallel "<task>" --execute`, `src/services/agents/patterns.ts` | Bug finder, patch writer, test writer, security auditor, and style reviewer run in parallel via the workflow executor, then a synthesizer merges results into one plan. |
|
|
66
73
|
|
|
67
74
|
## v1.21.0 Additions
|
|
68
75
|
|
package/docs/USAGE.md
CHANGED
|
@@ -116,7 +116,7 @@ UR includes slash commands and CLI subcommands for common workflows:
|
|
|
116
116
|
- `ur context-pack ...` to summarize architecture and persist task decisions, constraints, commands, and diffs
|
|
117
117
|
- `ur code-index watch` to keep the local semantic code index fresh
|
|
118
118
|
- `ur memory retention ...` to prune project-local memory by TTL, max entries, and decay
|
|
119
|
-
- `ur spec ...` to scaffold requirements, design, and tasks,
|
|
119
|
+
- `ur spec ...` to scaffold requirements, design, and tasks, run a spec task list, and verify with strict proof gates
|
|
120
120
|
- `ur escalate ...` to plan, run, or ask an oracle model for hard tasks
|
|
121
121
|
- `ur arena ...` to run multiple agents on the same task and select a winner
|
|
122
122
|
- `ur test-first ...` to detect compile/test/lint commands, store failure traces, and install after-edit gates
|
|
@@ -129,6 +129,8 @@ UR includes slash commands and CLI subcommands for common workflows:
|
|
|
129
129
|
- `ur eval report ...` to show a saved report or write a single-suite dashboard
|
|
130
130
|
- `ur eval dashboard` to generate the local HTML dashboard across all reports
|
|
131
131
|
- `ur eval bench ...` to import local SWE-bench, Terminal-Bench, or Aider Polyglot exports
|
|
132
|
+
- `ur crew ...` to run lead+worker agent crews with optional automatic task decomposition
|
|
133
|
+
- `ur pattern ...` to run multi-agent collaboration patterns (PEER, DOE, concurrent, handoff, debate, parallel)
|
|
132
134
|
- `ur doctor` to inspect CLI health
|
|
133
135
|
- `ur update` or `ur upgrade` to check for updates
|
|
134
136
|
|
|
@@ -142,6 +144,8 @@ Agent platform examples:
|
|
|
142
144
|
```sh
|
|
143
145
|
ur spec init demo --goal "1. add a utils.add function 2. add a test"
|
|
144
146
|
ur spec run demo --all --dry-run
|
|
147
|
+
ur spec run demo --all --kernel
|
|
148
|
+
ur spec verify demo --kernel
|
|
145
149
|
ur arena "implement a debounce helper" --agents 2 --dry-run
|
|
146
150
|
ur escalate run "refactor the cache layer" --force-oracle --dry-run
|
|
147
151
|
ur test-first detect
|
|
@@ -169,6 +173,9 @@ ur eval run starter --dry-run --json
|
|
|
169
173
|
ur eval run starter --metrics --json
|
|
170
174
|
ur eval report starter --dashboard
|
|
171
175
|
ur eval dashboard
|
|
176
|
+
ur crew create parser-crew --goal "fix the flaky parser test" --decompose --dry-run
|
|
177
|
+
ur crew run parser-crew --workers 3 --decompose --dry-run
|
|
178
|
+
ur pattern parallel "refactor login without changing behavior" --execute --dry-run
|
|
172
179
|
```
|
|
173
180
|
|
|
174
181
|
## Permissions
|
package/documentation/index.html
CHANGED
|
@@ -43,7 +43,7 @@
|
|
|
43
43
|
<main id="content" class="content">
|
|
44
44
|
<header class="topbar">
|
|
45
45
|
<div>
|
|
46
|
-
<p class="eyebrow">Version 1.22.
|
|
46
|
+
<p class="eyebrow">Version 1.22.1</p>
|
|
47
47
|
<h1>UR Agent Documentation</h1>
|
|
48
48
|
<p class="lead">A practical, tutorial-style reference for installing, configuring, automating, extending, and operating UR Agent.</p>
|
|
49
49
|
</div>
|