ur-agent 1.22.0 → 1.22.2

package/docs/AGENT_FEATURES.md

@@ -54,8 +54,18 @@ ur worktree clean --dry-run
 ur eval run starter --metrics --json
 ur eval report starter --dashboard
 ur eval dashboard
+ur spec init auth-refactor --goal "refactor login without changing behavior"
+ur spec run auth-refactor --all
+ur spec verify auth-refactor
 ```
 
+## v1.22.2 Additions
+
+| Addition | Surface | What it adds |
+| --- | --- | --- |
+| Lifecycle hooks | `.ur/hooks.json`, `UR.md` frontmatter, `src/utils/hooks.ts` | New hook events `BeforeEdit`, `AfterEdit`, `BeforeCommand`, `AfterCommand`, `BeforeCommit`, and `OnFailure`. Fire around file edits, shell commands, git commits, and failures. Advisory by default; can block actions or write project memory. |
+| Persistent project memory | `ur context-pack remember`, `src/services/context/projectContextManifest.ts` | New memory kinds `architecture`, `preference`, `attempt`, `accepted`, and `rejected` with status, rationale, scope, and source metadata. Stored in `.ur/context/task-memory.jsonl` and surfaced in the compressed context summary. |
+
 ## v1.22.0 Additions
 
 | Addition | Surface | What it adds |
@@ -63,6 +73,10 @@ ur eval dashboard
 | 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. |
 | 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. |
 | 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. |
+| 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. |
+| 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. |
+| 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. |
+| 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. |
 
 ## v1.21.0 Additions
 

package/docs/USAGE.md

@@ -100,6 +100,53 @@ ur context-pack remember --decision "Use package scripts before ad hoc commands"
 ur context-pack compress
 ```
 
+## Project memory
+
+`ur context-pack remember` stores durable project memory in `.ur/context/task-memory.jsonl`. Use it to record decisions, constraints, preferred commands, failed attempts, accepted patterns, rejected approaches, and architecture notes. The compressed summary in `.ur/context/compressed.md` is included in agent context.
+
+Memory kinds:
+
+- `decision`, `constraint`, `command`, `diff`, `note` — original task memory categories.
+- `architecture` — architecture decisions and design rationale.
+- `preference` — preferred commands, tools, or workflows.
+- `attempt` — things you tried that did not work out (often written by `OnFailure` hooks).
+- `accepted` — patterns or approaches that worked and should be reused.
+- `rejected` — approaches that should not be repeated, optionally with an `alternative-to`.
+
+```sh
+ur context-pack remember --architecture "Repository pattern for data access" --status accepted --rationale "Testability"
+ur context-pack remember --preference "Use bun test over jest"
+ur context-pack remember --accepted "Use p-map for bounded concurrency" --scope project
+ur context-pack remember --rejected "Switch to esbuild" --alternative-to "Keep bun bundle"
+ur context-pack remember --attempt "Tried Deno runtime" --status superseded
+ur context-pack compress
+```
+
+## Lifecycle hooks
+
+UR supports lifecycle hook events that fire around agent actions. Hooks are configured in `.ur/hooks.json` or `UR.md` frontmatter and receive JSON payloads.
+
+| Event | Fires | Payload |
+| --- | --- | --- |
+| `BeforeEdit` | Before `FileEditTool` writes a file. | `file_path`, `old_string`, `new_string`, `replace_all`, `tool_use_id` |
+| `AfterEdit` | After a file edit succeeds. | Same as `BeforeEdit` plus `success: true`. Can write project memory. |
+| `BeforeCommand` | Before a Bash/PowerShell command runs. | `command`, `shell_type`, `cwd`, `timeout_ms`, `sandbox`, `tool_use_id` |
+| `AfterCommand` | After a command finishes. | `command`, `exit_code`, `stdout`, `stderr`, `tool_use_id` |
+| `BeforeCommit` | After a successful `git commit` command. | `command`, `message`, `files`, `tool_use_id` |
+| `OnFailure` | When a tool, turn, or API call fails. | `error`, `stage`, `tool_name`, `tool_use_id` |
+
+Example `UR.md` frontmatter hook:
+
+```yaml
+---
+hooks:
+  - event: BeforeCommit
+    command: 'echo "Commit detected: $UR_CODE_HOOK_INPUT" >> /tmp/ur-commits.log'
+---
+```
+
+Hooks are advisory by default. A `BeforeEdit`/`BeforeCommand`/`BeforeCommit` hook can block the action by returning `{"decision":"block","reason":"..."}` or exit code 2. `AfterEdit` and `OnFailure` hooks can return `{"hookSpecificOutput":{"hookEventName":"...","memory":{"kind":"accepted","text":"..."}}}` to append project memory automatically.
+
 ## Commands
 
 UR includes slash commands and CLI subcommands for common workflows:
@@ -113,10 +160,10 @@ UR includes slash commands and CLI subcommands for common workflows:
 - `ur bg ...` to run detached local background agents with optional worktrees and PRs
 - `ur repo-edit ...` to index the repo, plan AST-aware renames, preview patches, and apply with rollback
 - `ur safety ...` to inspect project shell safety policy and preview command risk
-- `ur context-pack ...` to summarize architecture and persist task decisions, constraints, commands, and diffs
+- `ur context-pack ...` to summarize architecture and persist project memory (decisions, constraints, commands, diffs, architecture, preferences, attempts, accepted, rejected)
 - `ur code-index watch` to keep the local semantic code index fresh
 - `ur memory retention ...` to prune project-local memory by TTL, max entries, and decay
-- `ur spec ...` to scaffold requirements, design, and tasks, then run a spec task list
+- `ur spec ...` to scaffold requirements, design, and tasks, run a spec task list, and verify with strict proof gates
 - `ur escalate ...` to plan, run, or ask an oracle model for hard tasks
 - `ur arena ...` to run multiple agents on the same task and select a winner
 - `ur test-first ...` to detect compile/test/lint commands, store failure traces, and install after-edit gates
@@ -129,6 +176,8 @@ UR includes slash commands and CLI subcommands for common workflows:
 - `ur eval report ...` to show a saved report or write a single-suite dashboard
 - `ur eval dashboard` to generate the local HTML dashboard across all reports
 - `ur eval bench ...` to import local SWE-bench, Terminal-Bench, or Aider Polyglot exports
+- `ur crew ...` to run lead+worker agent crews with optional automatic task decomposition
+- `ur pattern ...` to run multi-agent collaboration patterns (PEER, DOE, concurrent, handoff, debate, parallel)
 - `ur doctor` to inspect CLI health
 - `ur update` or `ur upgrade` to check for updates
 
@@ -142,6 +191,8 @@ Agent platform examples:
 ```sh
 ur spec init demo --goal "1. add a utils.add function 2. add a test"
 ur spec run demo --all --dry-run
+ur spec run demo --all --kernel
+ur spec verify demo --kernel
 ur arena "implement a debounce helper" --agents 2 --dry-run
 ur escalate run "refactor the cache layer" --force-oracle --dry-run
 ur test-first detect
@@ -151,6 +202,7 @@ ur safety status
 ur safety check --command "rm -rf build"
 ur context-pack scan
 ur context-pack remember --constraint "Run command evidence before claiming success"
+ur context-pack remember --accepted "Use p-map for concurrency" --scope project
 ur context-pack compress
 ur acp serve --port 8123
 ur exec "add tests for the parser" --concurrency 4 --json
@@ -169,6 +221,9 @@ ur eval run starter --dry-run --json
 ur eval run starter --metrics --json
 ur eval report starter --dashboard
 ur eval dashboard
+ur crew create parser-crew --goal "fix the flaky parser test" --decompose --dry-run
+ur crew run parser-crew --workers 3 --decompose --dry-run
+ur pattern parallel "refactor login without changing behavior" --execute --dry-run
 ```
 
 ## Permissions

package/documentation/index.html

@@ -43,7 +43,7 @@
     <main id="content" class="content">
       <header class="topbar">
         <div>
-          <p class="eyebrow">Version 1.22.0</p>
+          <p class="eyebrow">Version 1.22.2</p>
           <h1>UR Agent Documentation</h1>
           <p class="lead">A practical, tutorial-style reference for installing, configuring, automating, extending, and operating UR Agent.</p>
         </div>

package/extensions/vscode-ur-inline-diffs/package.json

@@ -2,7 +2,7 @@
   "name": "ur-inline-diffs",
   "displayName": "UR Inline Diffs",
   "description": "Review UR inline diff bundles from .ur/ide/diffs inside VS Code.",
-  "version": "1.22.0",
+  "version": "1.22.2",
   "publisher": "ur-agent",
   "engines": {
     "vscode": "^1.92.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ur-agent",
-  "version": "1.22.0",
+  "version": "1.22.2",
   "description": "UR terminal coding agent CLI",
   "type": "module",
   "packageManager": "bun@1.3.14",