ur-agent 1.22.2 → 1.22.4

package/docs/AGENT_FEATURES.md

@@ -4,6 +4,11 @@ This page tracks the agent-platform additions that were prioritized after
 comparing UR with current Codex, Claude Code, Copilot, and Jules-style agent
 workflows.
 
+UR's intended advantage is not being another generic coding agent. It is a
+reproducible autonomous software engineering agent: every substantial task can
+be driven as `spec -> plan -> patch -> test -> report -> rollback`, with the
+spec as the durable source of truth and command evidence as the success gate.
+
 ## Commands
 
 ```sh
@@ -59,6 +64,13 @@ ur spec run auth-refactor --all
 ur spec verify auth-refactor
 ```
 
+## v1.22.3 Additions
+
+| Addition | Surface | What it adds |
+| --- | --- | --- |
+| Executable skill directories | `ur skill list\|show\|run\|init`, `src/skills/skillSpec.ts` | A `.ur/skills/<name>/` directory with `skill.yaml` compiles into a `WorkflowSpec`. Supports `instructions.md`, `scripts/`, `templates/`, and `checklists/`. Step prompts support `$ARGUMENTS`, `$0..$N`, and `$ARGUMENTS[N]`. |
+| Semantic repo index | `ur code-index repo build\|status\|search\|symbols\|callers\|tests\|docs\|configs`, `src/utils/codeIndex/repoIndex.ts` | Offline, dependency-free indexes under `.ur/code-index/`: `repo.json`, `symbols.json`, `calls.json`, `tests.json`, `docs.json`, `configs.json`. Classifies files, extracts symbols, records intra-file calls, maps tests, and indexes doc refs and config keys. |
+
 ## v1.22.2 Additions
 
 | Addition | Surface | What it adds |
@@ -78,6 +90,13 @@ ur spec verify auth-refactor
 | 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. |
 
+The spec-first path is the default reliability story: `ur spec init` turns a
+request into requirements/design/tasks, `ur spec run --all` applies atomic
+tasks, and `ur spec verify` requires compile proof, test proof, lint proof,
+diff proof, and runtime proof. The AgentKernel keeps planner, executor,
+verifier, critic, memory manager, tool router, and permission guard as separate
+components instead of one giant prompt.
+
 ## v1.21.0 Additions
 
 | Addition | Surface | What it adds |
@@ -100,6 +119,20 @@ ur spec verify auth-refactor
 | Test-runner tool | `TestRunner` | Auto-detect and run project tests. |
 | Database tool | `Database` | SQL queries against SQLite, Postgres, MySQL, and DuckDB. |
 
+## Core Agent Primitives
+
+UR documents the same core primitives that Cursor-style agent products expose,
+while keeping them project-local and manifest-backed:
+
+| Primitive | UR surface | Project-backed source |
+| --- | --- | --- |
+| Agent | `ur`, `ur agents`, `ur crew`, `ur bg`, `ur agent-templates` | `.ur/agents/`, `AGENTS.md`, `UR.md` |
+| Rules | `ur context-pack scan`, `ur safety`, `ur guardrails`, `ur hooks` | `AGENTS.md`, `UR.md`, `.cursor/rules/*.mdc`, `.cursorrules`, `.ur/safety-policy.json`, `.ur/guardrails.json`, `.ur/hooks.json` |
+| MCP | `ur mcp`, built-in MCP server mode, MCP tools/resources | `.mcp.json`, `.ur/mcp/`, plugin manifests |
+| Skills | `/skills`, `/create-skill`, bundled skills, plugin skills | `.ur/skills/`, user skills, plugin skill folders |
+| CLI | `ur --help`, `ur -p`, `ur exec`, `ur acp`, workflow subcommands | `package.json` scripts, `.ur/project-manifest.json`, `.ur/verify.json` |
+| Models | `ur model`, `ur model-doctor`, model router, Ollama discovery | Ollama endpoint, settings, `OLLAMA_MODEL`, model metadata cache |
+
 ## v1.19.0 Additions
 
 | Addition | Surface | What it adds |

package/docs/AGENT_UPGRADE_1.18.0.md

@@ -34,10 +34,12 @@ ur tf-loop detect
 
 ```sh
 bun run typecheck
+bun run lint
 bun test test/testFirstLoop.test.ts
 node ./bin/ur.js test-first --help
 node ./bin/ur.js test-first detect
 ```
 
-If a project has no lint script, `test-first` reports lint as a missing phase
-instead of inventing a command.
+If an external project has no lint script, `test-first` reports lint as a
+missing phase instead of inventing a command. UR itself now exposes
+`bun run lint`, so local quality detection includes compile, test, and lint.

package/docs/CONFIGURATION.md

@@ -178,8 +178,9 @@ ur context-pack compress
 Generated files:
 
 - `.ur/project-manifest.json` — architecture manifest from Project DNA,
-  `package.json`, instruction files, `.ur/verify.json`, `.ur/safety-policy.json`,
-  and other manifests.
+  package scripts, instruction files, Cursor-style rules, `.ur/verify.json`,
+  `.ur/safety-policy.json`, MCP config, editor settings, workflow files, and
+  other manifests.
 - `.ur/context/architecture.md` — human-readable architecture summary.
 - `.ur/context/task-memory.jsonl` — decisions, constraints, commands, diffs,
   and notes.

package/docs/DEVELOPMENT.md

@@ -32,6 +32,7 @@ bun run dev
 
 ```sh
 bun run typecheck
+bun run lint
 bun test
 bun run bundle
 bun run smoke

package/docs/USAGE.md

@@ -162,6 +162,8 @@ UR includes slash commands and CLI subcommands for common workflows:
 - `ur safety ...` to inspect project shell safety policy and preview command risk
 - `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 code-index repo build` to build a richer semantic repo index (files, symbols, calls, tests, docs, configs)
+- `ur skill init ...` and `ur skill run ...` for executable skill workflows
 - `ur memory retention ...` to prune project-local memory by TTL, max entries, and decay
 - `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
@@ -197,6 +199,10 @@ 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
 ur test-first --dry-run
+ur skill init security-review
+ur skill run security-review "src/auth.ts"
+ur code-index repo build
+ur code-index repo search "rate limiter"
 ur test-first install
 ur safety status
 ur safety check --command "rm -rf build"

package/documentation/index.html

@@ -43,7 +43,7 @@
     <main id="content" class="content">
       <header class="topbar">
         <div>
-          <p class="eyebrow">Version 1.22.2</p>
+          <p class="eyebrow">Version 1.22.3</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.2",
+  "version": "1.22.4",
   "publisher": "ur-agent",
   "engines": {
     "vscode": "^1.92.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ur-agent",
-  "version": "1.22.2",
+  "version": "1.22.4",
   "description": "UR terminal coding agent CLI",
   "type": "module",
   "packageManager": "bun@1.3.14",
@@ -41,6 +41,7 @@
     "bundle": "node scripts/bundle.mjs",
     "release:check": "node scripts/release-check.mjs",
     "typecheck": "bun run tsc --noEmit",
+    "lint": "node scripts/lint.mjs",
     "test": "bun test",
     "smoke": "node ./bin/ur.js --version",
     "secrets:scan": "bash scripts/secret-scan.sh",