ur-agent 1.19.0 → 1.21.0

package/CHANGELOG.md

@@ -1,5 +1,69 @@
 # Changelog
 
+## 1.21.0
+
+### Added
+- **Agent skill runner (`agentSkillRunner.ts`).** Reusable helper that wraps
+  `startBackgroundTask({ worktree: true, pr: true })`, polls the background
+  manifest to completion, and returns a PR-style summary with branch, commits,
+  PR URL, and diff summary.
+- **New slash skills for agent worktrees.** Added `/debug-v2`, `/refactor`,
+  `/paper-implementation`, `/benchmark`, `/security-review`, `/dockerize`, and
+  `/latex-paper` bundled slash skills. Each expands into a prompt that instructs
+  the model to work in an isolated git worktree and produce a clean branch,
+  commits, and PR.
+- **Matching agent templates.** Added `debug-v2`, `refactor`, `paper-implementation`,
+  `benchmark`, `security-review`, `dockerize`, and `latex-paper` templates to
+  `AGENT_TEMPLATES`; install them with `ur agent-templates install`.
+- **`ur worktree` command.** Added `ur worktree list|status|clean` to inspect
+  and clean up UR agent worktrees created by background runs.
+
+### Changed
+- **Background runner exports.** Exported `commitIfNeeded` and `createPullRequest`
+  from `backgroundRunner.ts` so the agent skill runner can inspect and finalize
+  PR state.
+- **Version bump.** Updated from 1.20.0 to 1.21.0 across `package.json`,
+  `bunfig.toml`, the VS Code extension manifest, and the bundled CLI.
+
+### Verified
+- Added tests for the agent skill runner, each new bundled skill, and the new
+  `ur worktree` command.
+
+## 1.20.0
+
+### Added
+- **ACP server (`ur acp`).** Added an HTTP+JSON-RPC Agent Communication
+  Protocol server for IDE extensions. Supports `initialize`, `tools/list`,
+  `tools/call`, `tasks/send`, `tasks/get`, `tasks/cancel`, and `shutdown`.
+  Runs on `127.0.0.1:8123` by default with optional bearer-token auth.
+- **`ur exec` pool execution.** Added a non-interactive pool command that runs
+  one or more prompts with optional concurrency, worktrees, output capture,
+  and dry-run mode.
+- **GitHub tool.** Added `GitHubTool` for PR/issue/repo operations via the
+  `gh` CLI.
+- **API tool.** Added `ApiTool` for REST HTTP calls with JSON/text output.
+- **Browser tool.** Added `BrowserTool` for headless browser automation
+  (fetch/goto/click/type/evaluate/screenshot). Disabled by default; enable
+  with `UR_BROWSER_TOOL=1`.
+- **Docker tool.** Added `DockerTool` wrapping the `docker` CLI for container
+  and compose operations.
+- **Test-runner tool.** Added `TestRunnerTool` that auto-detects the project
+  test command from `package.json` scripts, `Makefile`, `Cargo.toml`,
+  `pyproject.toml`, or `go.mod`.
+- **Database tool.** Added `DatabaseTool` for SQL queries against SQLite,
+  Postgres, MySQL, and DuckDB.
+
+### Changed
+- **Tool surface.** File-system and terminal tools (`FileRead`, `FileEdit`,
+  `FileWrite`, `Glob`, `Grep`, `Bash`, `PowerShell`) are now automatically
+  exposed through the existing MCP server and the new ACP server.
+- **Version bump.** Updated from 1.19.0 to 1.20.0 across `package.json`,
+  `bunfig.toml`, the VS Code extension manifest, and the bundled CLI.
+
+### Verified
+- Added focused tests for the ACP server/client, `ur exec`, GitHub tool,
+  API tool, browser tool, Docker tool, test-runner tool, and database tool.
+
 ## 1.19.0
 
 ### Added

package/README.md

@@ -132,6 +132,7 @@ as first-class subcommands in the shipped CLI.
 | `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 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. |
@@ -149,11 +150,19 @@ as first-class subcommands in the shipped CLI.
 | `ur mcp` | Configure and manage Model Context Protocol servers. |
 | `ur plugin` | Install, update, enable, disable, and validate UR plugins. |
 | `ur role-mode` | Install built-in Architect, Code, Debug, and Ask role modes. |
+| `ur acp` | Start/stop/status the Agent Communication Protocol server for IDE extensions. |
+| `ur exec` | Run one or more prompts in non-interactive mode with optional concurrency. |
 | `ur ide diff` | Capture editor-readable inline diff bundles. |
 | `ur a2a card` | Print UR Agent Card metadata for agent interoperability. |
 | `ur a2a serve` | Start an opt-in local A2A task server with bearer or delegation auth. |
 | `ur sdk` | Show programmatic headless usage and scaffold SDK examples. |
 
+New slash skills run agentic work in isolated git worktrees with clean commits and PR output:
+`/debug-v2`, `/refactor`, `/paper-implementation`, `/benchmark`, `/security-review`, `/dockerize`, `/latex-paper`.
+Install matching agent templates with `ur agent-templates install`.
+
+New built-in tools (exposed through MCP and the ACP server): GitHub, API, Browser, Docker, TestRunner, Database. File-system and terminal tools are already built in (FileRead, FileEdit, FileWrite, Glob, Grep, Bash, PowerShell).
+
 Examples:
 
 ```sh
@@ -176,6 +185,8 @@ ur repo-edit apply rename oldName --to newName --check "bun test"
 ur code-index search "where is the rate limiter configured"
 ur artifacts capture-tests --command "bun test"
 ur agent-task pr --create --dry-run
+ur acp serve --port 8123
+ur exec "add tests for the parser" --concurrency 4 --json
 ```
 
 ## Project Context
@@ -285,6 +296,7 @@ CLI. Rebuild it after source, version, or macro changes.
 - [Configuration](docs/CONFIGURATION.md)
 - [Agent Feature Expansion](docs/AGENT_FEATURES.md)
 - [Agent Trend Coverage](docs/AGENT_TRENDS.md)
+- [1.20.0 Upgrade Notes](docs/AGENT_UPGRADE_1.20.0.md)
 - [1.19.0 Upgrade Notes](docs/AGENT_UPGRADE_1.19.0.md)
 - [1.18.0 Upgrade Notes](docs/AGENT_UPGRADE_1.18.0.md)
 - [1.17.0 Upgrade Notes](docs/AGENT_UPGRADE_1.17.0.md)