ur-agent 1.22.0 → 1.22.2

package/CHANGELOG.md

@@ -1,5 +1,63 @@
 # Changelog
 
+## 1.22.2
+
+### Added
+- **Lifecycle hooks.** Added six new hook events in `src/entrypoints/sdk/coreTypes.ts`
+  and `src/entrypoints/sdk/coreSchemas.ts`: `BeforeEdit`, `AfterEdit`,
+  `BeforeCommand`, `AfterCommand`, `BeforeCommit`, and `OnFailure`. Dispatchers
+  in `src/utils/hooks.ts` run them around file edits, shell commands, git commits,
+  and failure paths. Call sites are wired in `FileEditTool`, `BashTool`,
+  `PowerShellTool`, `toolExecution.ts`, and `query.ts`. Hooks are advisory by
+  default and can block actions or append project memory.
+- **Persistent project memory.** Extended `TaskMemoryKind` in
+  `src/services/context/projectContextManifest.ts` with `architecture`,
+  `preference`, `attempt`, `accepted`, and `rejected`. Entries now support
+  `status`, `rationale`, `alternativeTo`, `supersedesId`, `scope`, and `source`
+  metadata. `ur context-pack remember` accepts the new kinds and metadata flags.
+
+### Changed
+- **Compressed context** now includes sections for all memory kinds, including the
+  new project-memory categories.
+
+### Verified
+- Added `test/lifecycleHooks.test.ts` covering the new `HOOK_EVENTS` literals and
+  Zod schema validation.
+- Added `test/projectMemory.test.ts` covering append/read/compress/summarize for
+  the new memory categories and metadata.
+
+## 1.22.1
+
+### Added
+- **Rich task decomposition.** `src/services/agents/decomposer.ts` splits large
+  goals into atomic subtasks with `goal`, `filesTouched`, `risk` (low/medium/high),
+  `testsRequired`, and `rollbackPoint`. `ur crew create|run|plan ... --decompose`
+  uses it; a deterministic fallback keeps the command offline and fast, while a
+  headless subagent path produces structured JSON.
+- **Parallel specialized subagents.** New `parallel` multi-agent pattern in
+  `src/services/agents/patterns.ts`: bug finder, patch writer, test writer,
+  security auditor, and style reviewer run concurrently, then a synthesizer
+  merges their outputs. Run it with
+  `ur pattern parallel "<task>" --execute [--dry-run]`.
+- **AgentKernel abstraction.** `src/services/agents/kernel.ts` is a pure
+  orchestrator with seven roles: planner, executor, verifier, critic, memory,
+  router, and guard. `ur spec run|verify <name> --kernel` routes through kernel
+  stages while the legacy path stays the default.
+- **Spec verification / verifier kernel role.** `ur spec verify <name>` runs
+  deterministic `.ur/verify.json` project gates, then a read-only deep
+  verification subagent that must prove compile/test/lint/diff/runtime before
+  `VERDICT: PASS`. Persists `.ur/specs/<name>/verification.md` and records the
+  result in `spec.json`.
+
+### Changed
+- **Version bump.** Updated from 1.22.0 to 1.22.1 across `package.json`,
+  `bunfig.toml`, the VS Code extension manifest, and the bundled CLI.
+
+### Verified
+- Added `test/decomposition.test.ts`, `test/parallelPattern.test.ts`, and
+  `test/kernel.test.ts` covering decomposition metadata, parallel pattern
+  workflow execution, and all seven kernel roles.
+
 ## 1.22.0
 
 ### Added
@@ -19,6 +77,28 @@
 - **Benchmark-style reporting.** `formatEvalReport` prints aggregate cost,
   tokens, files changed, command failures, human edits, duration, and test pass
   rate alongside the pass-rate summary.
+- **Spec verification / verifier kernel role.** `ur spec verify <name>` runs
+  deterministic project gates from `.ur/verify.json`, then invokes a read-only
+  deep verification subagent that must demonstrate compile/test/lint/diff/runtime
+  proof before emitting `VERDICT: PASS`. Results are persisted to
+  `.ur/specs/<name>/verification.md` and recorded in `spec.json` so `ur spec status`
+  shows the latest verdict.
+- **AgentKernel abstraction.** Added `src/services/agents/kernel.ts`, a pure
+  orchestrator with seven roles: planner, executor, verifier, critic, memory,
+  router, and guard. `ur spec run <name> --kernel` and
+  `ur spec verify <name> --kernel` route through kernel stages while the legacy
+  loop remains the default. `src/services/agents/kernelSpec.ts` provides
+  spec-to-stage adapters.
+- **Rich task decomposition.** Added `src/services/agents/decomposer.ts`. `ur crew
+  create|run|plan ... --decompose` splits a goal into atomic subtasks with
+  `goal`, `filesTouched`, `risk` (low/medium/high), `testsRequired`, and
+  `rollbackPoint` metadata. A deterministic fallback keeps it offline and fast;
+  the model path asks a headless subagent for structured JSON.
+- **Parallel specialized subagents.** Added `parallel` multi-agent pattern in
+  `src/services/agents/patterns.ts`. Bug finder, patch writer, test writer,
+  security auditor, and style reviewer run in parallel, then a synthesizer merges
+  the results. `ur pattern parallel "<task>" --execute` runs it via the workflow
+  executor with concurrency matching the number of parallel agents.
 
 ### Changed
 - **`makeCliEvalRunner` resets cost state per case**, reads child metrics,
@@ -32,6 +112,14 @@
 - Added `test/evalMetrics.test.ts` and `test/evalDashboard.test.ts` covering
   child metrics serialization, report aggregation, dashboard HTML rendering,
   HTML escaping, and run-metrics persistence.
+- Added `test/specVerify.test.ts` covering dry-run verification, gate fast-fail,
+  verification record persistence, and verifier prompt construction.
+- Added `test/kernel.test.ts` covering all seven kernel roles and the spec
+  run/verify kernel adapters.
+- Added `test/decomposition.test.ts` covering deterministic decomposition, risk
+  heuristics, LLM-driven dry-run decomposition, and crew metadata persistence.
+- Added `test/parallelPattern.test.ts` covering the `parallel` pattern stages,
+  workflow compilation, and dry-run execution through the workflow executor.
 
 ## 1.21.0
 

package/README.md

@@ -38,7 +38,13 @@ handing work off to other tools or agents when needed.
   AST-aware rename plans, patch previews, and rollback-safe multi-file apply.
 - **Permission and context control.** Use `ur safety` and `ur context-pack` to
   inspect command risk, initialize project safety policy, summarize repository
-  architecture, and preserve task decisions, constraints, commands, and diffs.
+  architecture, and preserve task decisions, constraints, commands, diffs,
+  architecture decisions, preferred commands, failed attempts, accepted patterns,
+  and rejected approaches.
+- **Lifecycle hooks.** Configure `BeforeEdit`, `AfterEdit`, `BeforeCommand`,
+  `AfterCommand`, `BeforeCommit`, and `OnFailure` hooks in `.ur/hooks.json` or
+  `UR.md` to run custom commands when the agent edits files, runs shell commands,
+  commits, or hits a failure.
 - **Verification and provenance.** Use `ur test-first`, the built-in verifier,
   `/verify`, `.ur/verify.json`, `ur artifacts`, `ur claim-ledger`, and `/trace`
   to make results easier to inspect.
@@ -124,18 +130,20 @@ as first-class subcommands in the shipped CLI.
 | --- | --- |
 | `ur` | Start an interactive terminal agent session in the current workspace. |
 | `ur -p` | Run a non-interactive prompt with text, JSON, or stream-JSON output. |
-| `ur spec` | Create requirements, design, and task documents under `.ur/specs/`, then run the task list. |
+| `ur spec` | Create requirements, design, and task documents under `.ur/specs/`, run the task list, and verify with strict proof gates. |
 | `ur escalate` | Plan or run work with fast and oracle model tiers selected from local model capabilities. |
 | `ur arena` | Run multiple agents on the same task in isolated worktrees and surface the winning diff. |
 | `ur ci-loop` | Run a build or test command, hand failures to a fix agent, and retry with a bounded budget. |
 | `ur test-first` | Detect the project stack, run compile/test/lint commands, store failure traces, and install edit-time verify gates. |
 | `ur safety` | Inspect or initialize project shell safety policy and evaluate command risk before execution. |
-| `ur context-pack` | Write project architecture context, task memory, and compressed context under `.ur/`. |
+| `ur context-pack` | Write project architecture context, task memory, and compressed context under `.ur/`. Supports memory kinds `decision`, `constraint`, `command`, `diff`, `note`, `architecture`, `preference`, `attempt`, `accepted`, and `rejected`. |
+| `ur hooks` | Configure lifecycle hooks (`BeforeEdit`, `AfterEdit`, `BeforeCommand`, `AfterCommand`, `BeforeCommit`, `OnFailure`) via settings files. |
 | `ur bg` | Run and manage detached local background agents with optional worktrees and PR creation. |
 | `ur worktree` | List, inspect, and clean up UR agent worktrees. |
 | `ur automation` | Store and run project-local scheduled automation specs under `.ur/automations/`. |
 | `ur workflow` | Define, validate, graph, run, and resume declarative agent workflows. |
-| `ur crew` | Run a lead and worker subagent crew over a shared task board. |
+| `ur crew` | Run a lead and worker subagent crew over a shared task board; `--decompose` auto-splits tasks with risk/tests/rollback metadata. |
+| `ur pattern` | Run multi-agent collaboration patterns (PEER, DOE, concurrent, handoff, debate, parallel); `--execute` runs them as a workflow. |
 | `ur goal` | Track long-horizon objectives that persist across sessions. |
 | `ur repo-edit` | Build a repo edit index, plan AST-aware renames, preview patches, and apply with rollback. |
 | `ur code-index` | Build, query, or watch a local semantic code index using Ollama embeddings. |
@@ -171,6 +179,12 @@ Examples:
 ```sh
 ur spec init checkout --goal "1. add cart 2. add payment 3. add receipt"
 ur spec run checkout --all --dry-run
+ur spec run checkout --all --kernel
+ur spec verify checkout --kernel
+ur crew create parser-crew --goal "fix the flaky parser test" --decompose --dry-run
+ur crew plan parser-crew --goal "fix the flaky parser test" --decompose
+ur crew run parser-crew --workers 3 --decompose --dry-run
+ur pattern parallel "refactor login without changing behavior" --execute --dry-run
 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
@@ -179,6 +193,11 @@ ur test-first install
 ur safety check --command "rm -rf build"
 ur context-pack scan
 ur context-pack remember --decision "Use package scripts before ad hoc commands"
+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
 ur ci-loop --command "bun test" --max-attempts 3 --dry-run
 ur bg run "fix the flaky parser test" --worktree --dry-run
@@ -207,7 +226,9 @@ UR reads repository instructions and local runtime state from project files:
 - `.ur/safety-policy.json` configures project shell safety rules for read,
   write, execute, and network command classes.
 - `.ur/project-manifest.json` and `.ur/context/` hold architecture summaries,
-  task memory, compressed context, and command/constraint decisions.
+  task memory, compressed context, and project memory including architecture
+  decisions, preferred commands, failed attempts, accepted patterns, and rejected
+  approaches.
 - `.ur/specs/`, `.ur/artifacts/`, `.ur/automations/`, `.ur/test-first/`,
   `.ur/memory/`, and `.ur/index/` hold workflow state, review artifacts,
   scheduled jobs, failure traces, memory, and indexes.