ur-agent 1.25.1 → 1.25.3

package/docs/AGENT_FEATURES.md

@@ -62,8 +62,32 @@ 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
+ur provider list
+ur provider status
+ur provider doctor
+ur auth chatgpt
+ur auth claude
+ur auth gemini
+ur auth antigravity
+ur config set provider ollama
+ur config set provider openai-compatible
+ur config set model qwen3-coder:480b-cloud
+ur config set base_url http://localhost:11434/v1
+ur config set provider.fallback ollama
+ur upgrade
 ```
 
+## v1.25.x Additions
+
+| Addition | Surface | What it adds |
+| --- | --- | --- |
+| Legal multi-provider connectivity | `ur provider list\|status\|doctor`, `ur auth chatgpt\|claude\|gemini\|antigravity`, `ur config set provider ...` | Official-only access paths for subscription CLIs, explicit API-key providers, and local/OpenAI-compatible runtimes. UR stores only safe non-secret preferences and never scrapes browser sessions, extracts OAuth tokens, reads hidden provider auth files, bypasses provider restrictions, or proxies consumer web sessions as APIs. |
+| Provider-aware status bar | Interactive bottom status bar, `src/components/StatusLine.tsx`, `src/utils/statusBar.ts` | Shows UR-AGENT version, active provider, auth mode, selected model, mode, git branch, task state, checks/build state when known, and update availability. Hidden in CI, dumb terminals, and non-interactive mode; custom status-line hooks still override it. |
+| Clean update checks | `ur upgrade`, `ur update`, `src/cli/update.ts` | Detects development/source checkouts and prints a short pull-or-install message instead of attempting self-mutation. npm-installed builds compare the local version with `ur-agent` on npm and print update, latest, registry failure, and malformed-response states without stale planning text. |
+| Bundled IDE extension install | `extensions/vscode-ur-inline-diffs/`, `src/utils/ide.ts`, `ur ide diff` | Public VS Code install now packages the repo's bundled inline-diffs extension as a local VSIX instead of trying an unpublished marketplace ID. The extension remains local-only and reviews `.ur/ide/diffs` bundles from the current workspace. |
+| Professional clarification dialogs | `AskUserQuestion`, `src/tools/AskUserQuestionTool/AskUserQuestionTool.tsx` | Supports up to eight concrete options, infers labels from description-only option objects, accepts prompt aliases, rejects duplicate inferred labels, and is loaded without ToolSearch preloading so typed schemas are available before use. |
+| Documentation release sync | `README.md`, `docs/`, `documentation/`, `CHANGELOG.md` | Keeps the npm README, static documentation site, provider guide, usage guide, feature ledger, validation runbook, and release notes aligned with current release behavior. |
+
 ## v1.24.0 Additions
 
 | Addition | Surface | What it adds |
@@ -137,7 +161,7 @@ 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` |
+| Rules | `ur context-pack scan`, `ur safety`, `ur guardrails`, `/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` |

package/docs/CODE_FEATURE_INVENTORY.md

@@ -1,7 +1,7 @@
 # UR-AGENT code feature inventory
 
 This file is a code-derived inventory of what this agent can do in the
-`ur-agent` 1.19.0 source tree. It is meant to cover behavior that is easy to
+`ur-agent` 1.25.3 source tree. It is meant to cover behavior that is easy to
 miss in user-facing documentation.
 
 Sources traced include:

package/docs/CONFIGURATION.md

@@ -23,7 +23,9 @@ The default local request endpoint is:
 http://localhost:11434/api
 ```
 
-Any model exposed by that Ollama app can be used, including local models and Ollama Cloud-backed models. UR does not call remote provider APIs directly and does not manage model API keys.
+Any model exposed by that Ollama app can be used, including local models and
+Ollama Cloud-backed models. Explicit API providers may call their configured
+API endpoints, but UR does not store model API keys in settings.
 
 Provider configuration commands:
 
@@ -31,13 +33,27 @@ Provider configuration commands:
 ur provider list
 ur provider doctor
 ur provider status
+ur auth chatgpt
+ur auth claude
+ur auth gemini
+ur auth antigravity
 ur config set provider ollama
+ur config set provider claude
+ur config set provider "Claude Code"
+ur config set provider antigravity
+ur provider doctor agy
 ur config set provider openai-compatible
 ur config set provider.fallback ollama
 ur config set model <model>
 ur config set base_url <url>
 ```
 
+Provider values accept canonical IDs and common aliases. Examples:
+`codex-cli`, `chatgpt`, `codex`, `claude-code-cli`, `claude`,
+`Claude Code`, `gemini-cli`, `gemini`, `antigravity-cli`, `antigravity`,
+`agy`, `ollama`, `lmstudio`, `LM Studio`, `llama.cpp`, and `vllm`.
+Values with spaces should be quoted in shell commands.
+
 API keys are not written to UR settings. Set them in the environment when you
 explicitly choose API mode:
 

package/docs/USAGE.md

@@ -20,6 +20,10 @@ ur --continue
 ur --resume
 ```
 
+When UR needs a focused clarification, it uses the `AskUserQuestion` dialog.
+Professional clarification prompts can provide up to eight concrete options;
+UR also accepts custom "Other" answers when the dialog includes one.
+
 ## Print Mode
 
 Print mode is useful for scripts and shell pipelines:
@@ -96,17 +100,27 @@ ur auth claude
 ur auth gemini
 ur auth antigravity
 ur config set provider ollama
+ur config set provider claude
+ur config set provider "Claude Code"
+ur config set provider antigravity
+ur provider doctor agy
 ur config set provider openai-compatible
 ur config set model <model>
 ur config set base_url <url>
 ur config set provider.fallback ollama
 ```
 
+Provider values accept canonical IDs and common aliases. For example,
+`claude`, `Claude Code`, and `claude-code-cli` all select
+`claude-code-cli`; `antigravity`, `agy`, and `antigravity-cli` all select
+`antigravity-cli`.
+
 API modes are explicit and read keys only from environment variables:
 `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GEMINI_API_KEY`, and
 `OPENROUTER_API_KEY`. Subscription modes call official CLIs such as Codex,
 Claude Code, Gemini CLI, or Antigravity where supported. UR-AGENT never scrapes
 browser sessions, extracts OAuth tokens, or bypasses provider restrictions.
+OpenAI-compatible local or cloud endpoints use `base_url` plus `model`.
 
 ## Project Instructions
 
@@ -221,12 +235,27 @@ Interactive sessions include a compact bottom status bar when stdout is a real
 terminal:
 
 ```text
-UR-AGENT v1.25.1 | Provider: Ollama | Auth: local | model: qwen3-coder:480b-cloud | mode: ask | branch: main | tasks: idle | Update: 1.25.0 -> 1.25.1 available
+UR-AGENT v1.25.3 | Provider: Ollama | Auth: local | model: qwen3-coder:480b-cloud | mode: ask | branch: main | tasks: idle | Update: 1.25.2 -> 1.25.3 available
 ```
 
 The bar is not rendered in non-interactive mode, CI, dumb terminals, or
 assistant viewer mode. Custom status-line hooks override the built-in bar.
 
+## IDE Integration
+
+UR can write editor-readable inline diff bundles for review:
+
+```sh
+ur ide diff capture --title "Parser fix"
+ur ide diff list
+ur ide diff show <id>
+```
+
+The bundled VS Code extension is packaged locally from
+`extensions/vscode-ur-inline-diffs/` when UR installs it. It does not rely on
+the stale marketplace extension ID, and it only reads or writes
+`.ur/ide/diffs` files in the current workspace.
+
 Run each command with `--help` for exact flags.
 
 Agent platform examples:

package/docs/VALIDATION.md

@@ -18,7 +18,7 @@ You need:
 
 ```sh
 ur --version
-# expected: 1.25.1 (UR-AGENT)
+# expected: 1.25.3 (UR-AGENT)
 ```
 
 ## 0.1 Permission safety and context pack (1.19.0)

package/docs/providers.md

@@ -48,6 +48,10 @@ ur auth claude
 ur auth gemini
 ur auth antigravity
 ur config set provider codex-cli
+ur config set provider claude
+ur config set provider "Claude Code"
+ur config set provider antigravity
+ur provider doctor agy
 ur config set provider ollama
 ur config set provider openai-compatible
 ur config set model <model>
@@ -55,6 +59,24 @@ ur config set base_url <url>
 ur config set provider.fallback ollama
 ```
 
+Provider config and doctor commands accept canonical IDs and common aliases:
+
+| Canonical ID | Accepted examples |
+| --- | --- |
+| `codex-cli` | `chatgpt`, `codex`, `openai codex` |
+| `claude-code-cli` | `claude`, `Claude Code`, `anthropic claude` |
+| `gemini-cli` | `gemini`, `gemini cli`, `gemini code assist` |
+| `antigravity-cli` | `antigravity`, `agy`, `ag`, `google antigravity` |
+| `openai-api` | `openai`, `openai api` |
+| `anthropic-api` | `anthropic`, `claude api` |
+| `gemini-api` | `gemini api`, `google gemini api` |
+| `openrouter` | `openrouter api` |
+| `openai-compatible` | `compatible`, `openai compatible` |
+| `ollama` | `ollama local` |
+| `lmstudio` | `LM Studio`, `lm-studio` |
+| `llama.cpp` | `llama cpp`, `llamacpp`, `llama-cpp` |
+| `vllm` | `vllm server` |
+
 `ur provider doctor` checks the selected provider. It reports installed/missing
 CLIs, official login status where available, API key presence for API providers,
 local endpoint reachability, detectable model availability, unsupported account
@@ -73,7 +95,9 @@ fallback option.
   doctor warns that API-key mode may override subscription auth.
 - `gemini-cli`: launches only the official Gemini CLI flow. If the detected
   path is an unsupported personal-account path, UR-AGENT prints a clear error.
-- `antigravity-cli`: launches only an installed official CLI command where
+- `antigravity-cli`: detects official CLI commands including `agy --version`,
+  `antigravity --version`, `google-antigravity --version`, or `ag --version`
+  where installed. It launches only an installed official CLI command where
   supported; UR-AGENT does not invent flags.
 
 ## API and local providers
@@ -101,4 +125,3 @@ Local providers use their normal servers:
 - LM Studio: `http://localhost:1234/v1`
 - llama.cpp server mode: `http://localhost:8080/v1`
 - vLLM server mode: `http://localhost:8000/v1`
-

package/documentation/README.md

@@ -21,6 +21,10 @@ When a command writes project state, also update `projectFiles` in `app.js`.
 For safety or context features, include the relevant `.ur/` paths and validation
 commands so the static docs match the implementation.
 
+When provider, auth, update, status-bar, IDE integration, or plugin behavior
+changes, update `index.html`, `app.js`, and the matching markdown guide under
+`docs/` in the same patch.
+
 For public feature patches, also check the project-wide docs set:
 
 - root `README.md`

package/documentation/app.js

@@ -2,8 +2,8 @@ const featureGroups = [
   {
     title: 'Core agent runtime',
     tags: ['interactive', 'headless', 'models'],
-    text: 'Interactive terminal sessions, one-shot print mode, JSON and stream-json output, resumable conversations, custom agents, model routing, and local Ollama execution.',
-    commands: ['ur', 'ur -p', 'ur --resume', 'ur --continue', 'ur --model <model>'],
+    text: 'Interactive terminal sessions, one-shot print mode, JSON and stream-json output, resumable conversations, custom agents, model routing, local runtimes, and legal provider adapters.',
+    commands: ['ur', 'ur -p', 'ur --resume', 'ur --continue', 'ur --model <model>', 'ur provider'],
   },
   {
     title: 'Project context',
@@ -53,6 +53,12 @@ const featureGroups = [
     text: 'MCP servers, plugin marketplaces for skills, templates, validators, language adapters, A2A Agent Card and task server, delegation tokens, and a TypeScript SDK wrapper around headless UR.',
     commands: ['ur mcp', 'ur plugin', 'ur a2a', 'ur sdk'],
   },
+  {
+    title: 'Providers and auth',
+    tags: ['subscription', 'API', 'local', 'status bar'],
+    text: 'Official subscription CLI login, explicit API-key providers, local/OpenAI-compatible runtimes, provider doctor checks, non-secret config, fallback hints, and provider-aware status-bar output.',
+    commands: ['ur provider list', 'ur provider status', 'ur provider doctor agy', 'ur auth chatgpt', 'ur config set provider "Claude Code"'],
+  },
   {
     title: 'Security and operations',
     tags: ['sandbox', 'scope', 'diagnostics', 'policy'],
@@ -164,8 +170,8 @@ const commands = [
     name: 'auth',
     category: 'Ops',
     aliases: [],
-    summary: 'Manage authentication surfaces that are enabled in this build.',
-    examples: ['ur auth', 'ur setup-token'],
+    summary: 'Launch official subscription CLI login flows for ChatGPT/Codex, Claude Code, Gemini CLI, and Antigravity where supported.',
+    examples: ['ur auth chatgpt', 'ur auth claude', 'ur auth gemini', 'ur auth antigravity'],
   },
   {
     name: 'automation',
@@ -195,6 +201,13 @@ const commands = [
     summary: 'Summarize repository architecture from manifests and instructions, record task memory, and compress old context under `.ur/context`.',
     examples: ['ur context-pack scan', 'ur context-pack remember --decision "Use package scripts first"', 'ur context-pack remember --command "bun run typecheck"', 'ur context-pack compress'],
   },
+  {
+    name: 'config',
+    category: 'Ops',
+    aliases: ['settings'],
+    summary: 'Open the config panel or persist safe non-secret provider settings.',
+    examples: ['ur config', 'ur config set provider ollama', 'ur config set provider claude', 'ur config set provider "Claude Code"', 'ur config set model qwen3-coder:480b-cloud', 'ur config set base_url http://localhost:11434/v1', 'ur config set provider.fallback ollama'],
+  },
   {
     name: 'test-first',
     category: 'Verification',
@@ -297,9 +310,16 @@ const commands = [
     name: 'plugin',
     category: 'Interop',
     aliases: ['plugins'],
-    summary: 'Manage UR plugins and marketplaces for MCP tools, skills, templates, validators, and language adapters.',
+    summary: 'Manage UR plugins and marketplaces for MCP tools, skills, templates, validators, language adapters, LSP servers, agents, hooks, output styles, and commands.',
     examples: ['ur plugin list', 'ur plugin install hello@ur-plugins-official', 'ur plugin install engineering-discipline@ur-plugins-official', 'ur plugin update <plugin>', 'ur plugin disable <plugin>'],
   },
+  {
+    name: 'provider',
+    category: 'Models',
+    aliases: ['providers'],
+    summary: 'List, inspect, and diagnose legal model provider adapters without reading hidden credential files.',
+    examples: ['ur provider list', 'ur provider status', 'ur provider doctor', 'ur provider doctor codex-cli', 'ur provider doctor ollama --json'],
+  },
   {
     name: 'repo-edit',
     category: 'Delivery',
@@ -500,6 +520,21 @@ const projectFiles = [
     text: 'Reviewable plans, diffs, test runs, screenshots, notes, approvals, rejections, and feedback.',
     example: 'ur artifacts capture-diff',
   },
+  {
+    title: '.ur/runs/',
+    text: 'Research-grade run traces with plan, actions, diff, tests, and report files for auditable agent runs.',
+    example: '/trace',
+  },
+  {
+    title: '.ur/hooks.json',
+    text: 'Project lifecycle hooks for BeforeEdit, AfterEdit, BeforeCommand, AfterCommand, BeforeCommit, and OnFailure.',
+    example: '/hooks',
+  },
+  {
+    title: '.ur/ide/diffs/',
+    text: 'Editor-readable inline diff bundles consumed by the bundled VS Code review extension.',
+    example: 'ur ide diff capture --title "Parser fix"',
+  },
   {
     title: '.ur/safety-policy.json',
     text: 'Project shell safety policy for read/write/execute/network classes, destructive-command approval, sandbox posture, and secret exfiltration denial.',
@@ -520,6 +555,11 @@ const projectFiles = [
     text: 'Reliable repo-edit index data with file metadata, tokens, and JavaScript/TypeScript symbols.',
     example: 'ur repo-edit index',
   },
+  {
+    title: '.ur/code-index/',
+    text: 'Semantic repo index files for files, symbols, imports, callers, tests, docs, and configs.',
+    example: 'ur code-index repo build',
+  },
   {
     title: '.ur/test-first/',
     text: 'Failure traces from stack-aware compile/test/lint loops.',
@@ -548,6 +588,11 @@ const examples = [
     text: 'Let UR recommend a model before a difficult run.',
     code: 'ur model-route "Implement a browser screenshot comparison test"\nur --model qwen3-coder:480b-cloud',
   },
+  {
+    title: 'Provider setup',
+    text: 'Inspect legal provider paths, choose a local provider, and keep fallback explicit.',
+    code: 'ur provider list\nur provider doctor agy\nur config set provider "Claude Code"\nur config set provider ollama\nur config set model qwen3-coder:480b-cloud\nur config set provider.fallback ollama',
+  },
   {
     title: 'PR handoff with self-review',
     text: 'Dry-run first, then create the PR after the deterministic gate passes.',

package/documentation/index.html

@@ -21,12 +21,13 @@
 
       <label class="search-box">
         <span>Search docs</span>
-        <input id="globalSearch" type="search" placeholder="Try workflow, model, PR, A2A">
+        <input id="globalSearch" type="search" placeholder="Try provider, workflow, model, PR, A2A">
       </label>
 
       <nav class="nav-list" id="sectionNav">
         <a href="#overview">Overview</a>
         <a href="#quickstart">Quickstart</a>
+        <a href="#providers">Providers</a>
         <a href="#architecture">Architecture</a>
         <a href="#mental-model">Mental Model</a>
         <a href="#features">Feature Map</a>
@@ -43,7 +44,7 @@
     <main id="content" class="content">
       <header class="topbar">
         <div>
-          <p class="eyebrow">Version 1.24.0</p>
+          <p class="eyebrow">Version 1.25.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>
@@ -62,7 +63,7 @@
         <div class="stat-grid">
           <article>
             <strong>Local-first runtime</strong>
-            <span>Model traffic goes through the local Ollama endpoint. Local and Ollama Cloud-backed models exposed by the app are valid.</span>
+            <span>Use local Ollama/OpenAI-compatible runtimes for private and offline work, or explicitly select official subscription/API provider paths.</span>
           </article>
           <article>
             <strong>Interactive and headless</strong>
@@ -76,6 +77,10 @@
             <strong>Plugin marketplace</strong>
             <span>Plugins can add MCP tools, skills, templates, validators, language adapters, LSP servers, agents, hooks, and output styles.</span>
           </article>
+          <article>
+            <strong>Legal provider routing</strong>
+            <span><code>ur provider</code>, <code>ur auth</code>, and safe <code>ur config set</code> commands select official subscription, API, and local providers without storing secrets.</span>
+          </article>
           <article>
             <strong>Reliable repo editing</strong>
             <span><code>ur repo-edit</code> indexes files and symbols, plans AST-aware renames, previews patches, and rolls back failed multi-file applies.</span>
@@ -123,7 +128,40 @@ ur -p --output-format json "Review the current diff"</code></pre>
         </div>
         <div class="callout">
           <strong>Runtime requirement</strong>
-          <p>UR expects Bun and a local Ollama app/server at <code>http://localhost:11434/api</code>. Set <code>OLLAMA_MODEL</code> or <code>UR_MODEL</code> to force a model; otherwise UR routes from the models exposed by Ollama.</p>
+          <p>UR expects Bun. For local-first work, run a local Ollama app/server at <code>http://localhost:11434/api</code>. Set <code>OLLAMA_MODEL</code> or <code>UR_MODEL</code> to force a model, or use <code>ur provider</code> and <code>ur config set</code> to select official subscription, API, or OpenAI-compatible providers.</p>
+        </div>
+      </section>
+
+      <section id="providers" class="section">
+        <div class="section-heading">
+          <p class="eyebrow">Legal Access Paths</p>
+          <h2>Providers and authentication</h2>
+          <p>UR-AGENT integrates official access paths only. It never scrapes browser sessions, extracts OAuth tokens, reads hidden provider auth files, bypasses provider restrictions, or proxies consumer web sessions as APIs.</p>
+        </div>
+        <div class="reference-grid">
+          <article>
+            <h3>Subscription CLI login</h3>
+            <pre><code>ur auth chatgpt
+ur auth claude
+ur auth gemini
+ur auth antigravity
+ur provider doctor agy</code></pre>
+            <p>Subscription modes call official CLIs such as Codex CLI, Claude Code CLI, Gemini CLI, and Antigravity where supported. UR checks CLI presence and official login status without reading hidden credential files. Provider config accepts canonical IDs plus aliases such as <code>claude</code>, <code>Claude Code</code>, <code>antigravity</code>, and <code>agy</code>.</p>
+          </article>
+          <article>
+            <h3>API and local providers</h3>
+            <pre><code>ur config set provider openai-compatible
+ur config set provider "Claude Code"
+ur config set base_url http://localhost:11434/v1
+ur config set model qwen3-coder:480b-cloud
+ur config set provider.fallback ollama</code></pre>
+            <p>API providers require explicit selection and read keys only from environment variables. Local providers include Ollama, LM Studio, llama.cpp server mode, and vLLM OpenAI-compatible server mode.</p>
+          </article>
+          <article>
+            <h3>Status bar and updates</h3>
+            <pre><code>UR-AGENT v1.25.3 | Provider: Ollama | Auth: local | model: qwen3-coder:480b-cloud | mode: ask | branch: main | tasks: idle | Update: 1.25.2 -&gt; 1.25.3 available</code></pre>
+            <p>The interactive status bar shows provider, auth mode, model, branch, task state, checks status when known, and update availability. It is hidden in CI, dumb terminals, and non-interactive mode.</p>
+          </article>
         </div>
       </section>
 
@@ -131,7 +169,7 @@ ur -p --output-format json "Review the current diff"</code></pre>
         <div class="section-heading">
           <p class="eyebrow">Runtime</p>
           <h2>Architecture</h2>
-          <p>The CLI is the control plane. Project context and <code>.ur</code> assets feed agent orchestration, which uses local Ollama models and approved tools to produce code, docs, PRs, reports, and automation outputs.</p>
+          <p>The CLI is the control plane. Project context and <code>.ur</code> assets feed agent orchestration, which uses approved provider adapters, local-first model runtimes, and approved tools to produce code, docs, PRs, reports, and automation outputs.</p>
         </div>
         <figure class="diagram">
           <img src="assets/ur-architecture.svg" alt="UR-AGENT runtime architecture diagram">
@@ -448,6 +486,13 @@ ur plugin list
 ur plugin install &lt;plugin&gt;</code></pre>
             <p>MCP servers and marketplace plugins expand tools, executable skills, templates, validators, language adapters, and review workflows. Treat them as trusted code.</p>
           </article>
+          <article>
+            <h3>IDE inline diffs</h3>
+            <pre><code>ur ide diff capture --title "Parser fix"
+ur ide diff list
+ur ide diff show &lt;id&gt;</code></pre>
+            <p>UR packages its bundled VS Code inline-diffs extension as a local VSIX. The public install path does not depend on the stale marketplace extension ID.</p>
+          </article>
         </div>
       </section>
 
@@ -482,6 +527,12 @@ hash -r
 which -a ur
 ur --version</code></pre>
           </article>
+          <article>
+            <h3>Source checkout update message</h3>
+            <pre><code>ur upgrade
+# Development build detected. To update, pull latest source or install from npm.</code></pre>
+            <p>Source checkouts do not self-mutate. npm-installed builds compare against the latest <code>ur-agent</code> version and print the exact install command when an update is available.</p>
+          </article>
           <article>
             <h3>Ollama model not found</h3>
             <pre><code>ollama list

package/extensions/vscode-ur-inline-diffs/README.md

@@ -2,6 +2,10 @@
 
 Native VS Code surface for UR inline diff bundles.
 
+UR-AGENT packages this extension from the repository as a local VSIX when the
+CLI installs the public IDE integration. It does not depend on an unpublished
+marketplace extension ID.
+
 ## Workflow
 
 Create a bundle from the UR CLI:

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.25.1",
+  "version": "1.25.3",
   "publisher": "ur-agent",
   "engines": {
     "vscode": "^1.92.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ur-agent",
-  "version": "1.25.1",
+  "version": "1.25.3",
   "description": "UR-AGENT — autonomous engineering workflow engine (plan, execute, test, verify, document, benchmark, reproduce)",
   "type": "module",
   "packageManager": "bun@1.3.14",