agentorch 2.0.0__tar.gz → 2.0.2__tar.gz

{agentorch-2.0.0 → agentorch-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentorch
-Version: 2.0.0
+Version: 2.0.2
 Summary: DevTorch — AI reasoning capture, audit trail, and governance for agent-assisted development
 Author-email: Hemant Joshi <hemant@flotorch.ai>
 License: Apache-2.0
@@ -52,8 +52,10 @@ Requires-Dist: agentorch[cloud,mcp,proxy,wrapper]; extra == "all"
 
 **Local-first AI agent governance.** DevTorch gives multi-agent systems a shared on-disk audit trail, coordination vector, privacy controls, and LLM integration layer — all without a remote service.
 
+> **Latest release:** `agentorch 2.0.2` — MCP bridge with automatic local fallback, plus upgrade/reinstall docs for all IDE integrations. Install or upgrade with `pip install -U agentorch`.
+
 ```bash
-pip install agentorch
+pip install -U agentorch>=2.0.2
 devtorch init
 devtorch setup          # connects to Claude Code, Cursor, or Antigravity
 devtorch debug timeline
@@ -76,13 +78,13 @@ devtorch debug timeline
 
 ### Reasoning Plus
 
-Reasoning Plus is DevTorch’s default augmentation mode: before every LLM call, it gathers smart context from your workspace and asks the model to produce inline `<thinking>` reasoning before the final answer. The reasoning is captured to `.GCC/` automatically and stripped from the response your tool sees.
+Reasoning Plus is DevTorch’s default augmentation mode: before every LLM call, it gathers smart context from your workspace, asks the model to produce inline `<thinking>` reasoning, and learns from previous calls by re-injecting relevant reasoning into subsequent prompts. The reasoning is captured to `.GCC/` automatically and stripped from the response your tool sees.
 
 ```bash
 devtorch reasoning-plus status          # show current settings
 devtorch reasoning-plus enable          # turn on per project
 devtorch reasoning-plus disable         # turn off per project
-devtorch reasoning-plus config --smart-top-n 3 --smart-max-lines 150
+devtorch reasoning-plus config --smart-top-n 3 --smart-max-lines 150 --learning-top-n 3
 ```
 
 Set `DEVTORCH_REASONING_PLUS=0` to disable it for a single session. See [REASONING_PLUS.md](REASONING_PLUS.md) for details.
@@ -111,6 +113,35 @@ pip install agentorch[all]       # everything
 
 ---
 
+## Upgrade from an older version
+
+DevTorch preserves your `.GCC/` store across upgrades. Newer releases add IDE configs, hooks, or governance instructions, so you should re-run `devtorch setup` after upgrading.
+
+**Upgrade any time:**
+
+```bash
+pip install -U agentorch>=2.0.2
+cd /path/to/your/project
+devtorch setup              # or: devtorch setup --target <ide>
+devtorch doctor
+```
+
+`devtorch setup` is idempotent:
+- It rewrites `CLAUDE.md` / `AGENTS.md` with the latest governance instructions.
+- It regenerates IDE-specific config files (`.claude/settings.json`, `.cursor/mcp.json`, `opencode.json`, etc.).
+- It leaves existing `.GCC/` data untouched.
+
+**If you use the cloud MCP server**, re-run the client config installer after upgrade to get the latest bridge and fallback settings:
+
+```bash
+export DEVTORCH_MCP_DOMAIN=devtorch-mcp.your-domain.com
+devtorch cloud client-config <ide> --org <org> --repo <repo> --api-key <api-key>
+```
+
+Supported `<ide>` values: `opencode`, `claude`, `cursor`, `vscode`, `stdio`.
+
+---
+
 ## Getting Started
 
 DevTorch takes **5 minutes to set up**. Pick your AI coding tool below.
@@ -153,6 +184,8 @@ Open Claude Code in your project. On the first task Claude will call `devtorch_c
 
 **What you get:** Full RACP integration — reasoning commits, sensitivity events, coordination vector Θ, divergence detection, HITL conflict resolution.
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2 && devtorch setup` will rewrite `.claude/hooks.json`, `.claude/settings.json`, and `CLAUDE.md` with the latest versions.
+
 ---
 
 ### Cursor
@@ -195,6 +228,8 @@ devtorch doctor
 
 **What you get:** MCP tools, VS Code sidebar, optional HTTP proxy for passive capture of all LLM calls (`devtorch proxy start`).
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2 && devtorch setup --target cursor` will regenerate `.cursor/mcp.json` and update `CLAUDE.md`.
+
 ---
 
 ### Google Antigravity
@@ -225,6 +260,46 @@ devtorch doctor
 
 **What you get:** Full RACP integration. The multi-agent nature of Antigravity makes Θ accumulation especially valuable — multiple agents share the same reasoning state through `devtorch_context`.
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2 && devtorch setup --target antigravity` will regenerate the MCP config and update `AGENTS.md`.
+
+---
+
+### OpenCode
+
+OpenCode connects to DevTorch through the local stdio ↔ SSE bridge. The bridge talks to the cloud MCP server first, and if the cloud is unreachable or slow it automatically falls back to the local `devtorch` CLI so your `.GCC/` audit trail is never lost.
+
+**Step 1 — Install DevTorch**
+```bash
+pip install agentorch
+```
+
+**Step 2 — Create an API key and install the client config**
+
+Run from the project you want to govern:
+
+```bash
+devtorch cloud key create --org myorg --repo myrepo
+# Copy the printed API key — it will not be shown again.
+
+export DEVTORCH_MCP_DOMAIN=devtorch-mcp.your-domain.com
+devtorch cloud client-config opencode --org myorg --repo myrepo --api-key <api-key>
+```
+
+This creates:
+- `opencode.json` — the OpenCode MCP server config (uses the local bridge)
+- `AGENTS.md` — DevTorch governance instructions for the model
+
+**Step 3 — Verify**
+```bash
+devtorch doctor
+```
+
+Open the project in OpenCode. The DevTorch MCP tools will be listed, and the model will be instructed to call `devtorch_context` at the start of each task and `devtorch_commit` before every file edit.
+
+**What you get:** Cloud-hosted MCP server integration with automatic local fallback, automatic reasoning commits via `AGENTS.md` instructions, and a shared Θ state across sessions.
+
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2 && devtorch cloud client-config opencode --org <org> --repo <repo> --api-key <api-key>` will regenerate `opencode.json` with the latest bridge and fallback settings. **Restart OpenCode** after updating the config.
+
 ---
 
 ### VS Code (with GitHub Copilot)
@@ -255,6 +330,8 @@ devtorch sensitivity add --source you --concept auth --confidence 0.9 --disclosu
 
 **What you get:** Sidebar panel (read-only), git-commit-level event capture, manual reasoning commits. Full capture requires switching to Claude Code, Cursor, Kiro, or Antigravity.
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2 && devtorch setup` will reinstall the git hook and update the governance instructions.
+
 ---
 
 ### AWS Kiro
@@ -318,6 +395,8 @@ devtorch doctor
 
 **What you get:** Full RACP integration equivalent to Claude Code — MCP tools, steering-document governance, agent action hooks.
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2`, then re-run the manual steps above and refresh your steering document with the latest `AGENTS.md` text.
+
 ---
 
 ### AWS Bedrock (Python SDK)
@@ -349,6 +428,8 @@ All `invoke_model()` and `converse()` calls are identical. DevTorch injects the
 devtorch doctor
 ```
 
+> **Updating from an older version:** `pip install -U agentorch[wrapper]>=2.0.2`.
+
 ---
 
 ### Azure AI Foundry (Python SDK)
@@ -381,6 +462,8 @@ client = AzureOpenAI(
 devtorch doctor
 ```
 
+> **Updating from an older version:** `pip install -U agentorch[wrapper]>=2.0.2`.
+
 ---
 
 ### OpenAI Codex CLI
@@ -405,6 +488,8 @@ codex "Add error handling to the payment service"
 
 All Codex calls are intercepted by the proxy, which injects the RACP prefix and captures responses into `.GCC/`.
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2`.
+
 ---
 
 ### Ollama (local models)
@@ -437,6 +522,8 @@ devtorch doctor
 
 No API key required. Fully local — RACP context and captures stay on-device.
 
+> **Updating from an older version:** `pip install -U agentorch[wrapper]>=2.0.2`.
+
 ---
 
 ### Cloud MCP server (team-wide shared governance)
@@ -478,6 +565,14 @@ Supported `<ide>` values: `opencode`, `claude`, `cursor`, `vscode`, `stdio`.
 
 **Full walkthrough:** `IDE_SETUP.md` has step-by-step setup for OpenCode, Claude Code, Cursor, VS Code, Kiro, Antigravity, JetBrains, and generic MCP clients.
 
+> **Updating from an older version:** You do **not** need to redeploy the Cloudflare Worker for client-side changes. Just regenerate the IDE config on each machine after upgrading `agentorch`:
+> ```bash
+> pip install -U agentorch>=2.0.2
+> export DEVTORCH_MCP_DOMAIN=devtorch-mcp.YOUR_ACCOUNT.workers.dev
+> /path/to/DevTorch/Implementation/deploy/cloudflare-worker/install-client-config.sh \
+>   <ide> <org> <repo> <api-key>
+> ```
+
 ---
 
 ### Platform comparison

{agentorch-2.0.0 → agentorch-2.0.2}/README.md

@@ -2,8 +2,10 @@
 
 **Local-first AI agent governance.** DevTorch gives multi-agent systems a shared on-disk audit trail, coordination vector, privacy controls, and LLM integration layer — all without a remote service.
 
+> **Latest release:** `agentorch 2.0.2` — MCP bridge with automatic local fallback, plus upgrade/reinstall docs for all IDE integrations. Install or upgrade with `pip install -U agentorch`.
+
 ```bash
-pip install agentorch
+pip install -U agentorch>=2.0.2
 devtorch init
 devtorch setup          # connects to Claude Code, Cursor, or Antigravity
 devtorch debug timeline
@@ -26,13 +28,13 @@ devtorch debug timeline
 
 ### Reasoning Plus
 
-Reasoning Plus is DevTorch’s default augmentation mode: before every LLM call, it gathers smart context from your workspace and asks the model to produce inline `<thinking>` reasoning before the final answer. The reasoning is captured to `.GCC/` automatically and stripped from the response your tool sees.
+Reasoning Plus is DevTorch’s default augmentation mode: before every LLM call, it gathers smart context from your workspace, asks the model to produce inline `<thinking>` reasoning, and learns from previous calls by re-injecting relevant reasoning into subsequent prompts. The reasoning is captured to `.GCC/` automatically and stripped from the response your tool sees.
 
 ```bash
 devtorch reasoning-plus status          # show current settings
 devtorch reasoning-plus enable          # turn on per project
 devtorch reasoning-plus disable         # turn off per project
-devtorch reasoning-plus config --smart-top-n 3 --smart-max-lines 150
+devtorch reasoning-plus config --smart-top-n 3 --smart-max-lines 150 --learning-top-n 3
 ```
 
 Set `DEVTORCH_REASONING_PLUS=0` to disable it for a single session. See [REASONING_PLUS.md](REASONING_PLUS.md) for details.
@@ -61,6 +63,35 @@ pip install agentorch[all]       # everything
 
 ---
 
+## Upgrade from an older version
+
+DevTorch preserves your `.GCC/` store across upgrades. Newer releases add IDE configs, hooks, or governance instructions, so you should re-run `devtorch setup` after upgrading.
+
+**Upgrade any time:**
+
+```bash
+pip install -U agentorch>=2.0.2
+cd /path/to/your/project
+devtorch setup              # or: devtorch setup --target <ide>
+devtorch doctor
+```
+
+`devtorch setup` is idempotent:
+- It rewrites `CLAUDE.md` / `AGENTS.md` with the latest governance instructions.
+- It regenerates IDE-specific config files (`.claude/settings.json`, `.cursor/mcp.json`, `opencode.json`, etc.).
+- It leaves existing `.GCC/` data untouched.
+
+**If you use the cloud MCP server**, re-run the client config installer after upgrade to get the latest bridge and fallback settings:
+
+```bash
+export DEVTORCH_MCP_DOMAIN=devtorch-mcp.your-domain.com
+devtorch cloud client-config <ide> --org <org> --repo <repo> --api-key <api-key>
+```
+
+Supported `<ide>` values: `opencode`, `claude`, `cursor`, `vscode`, `stdio`.
+
+---
+
 ## Getting Started
 
 DevTorch takes **5 minutes to set up**. Pick your AI coding tool below.
@@ -103,6 +134,8 @@ Open Claude Code in your project. On the first task Claude will call `devtorch_c
 
 **What you get:** Full RACP integration — reasoning commits, sensitivity events, coordination vector Θ, divergence detection, HITL conflict resolution.
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2 && devtorch setup` will rewrite `.claude/hooks.json`, `.claude/settings.json`, and `CLAUDE.md` with the latest versions.
+
 ---
 
 ### Cursor
@@ -145,6 +178,8 @@ devtorch doctor
 
 **What you get:** MCP tools, VS Code sidebar, optional HTTP proxy for passive capture of all LLM calls (`devtorch proxy start`).
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2 && devtorch setup --target cursor` will regenerate `.cursor/mcp.json` and update `CLAUDE.md`.
+
 ---
 
 ### Google Antigravity
@@ -175,6 +210,46 @@ devtorch doctor
 
 **What you get:** Full RACP integration. The multi-agent nature of Antigravity makes Θ accumulation especially valuable — multiple agents share the same reasoning state through `devtorch_context`.
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2 && devtorch setup --target antigravity` will regenerate the MCP config and update `AGENTS.md`.
+
+---
+
+### OpenCode
+
+OpenCode connects to DevTorch through the local stdio ↔ SSE bridge. The bridge talks to the cloud MCP server first, and if the cloud is unreachable or slow it automatically falls back to the local `devtorch` CLI so your `.GCC/` audit trail is never lost.
+
+**Step 1 — Install DevTorch**
+```bash
+pip install agentorch
+```
+
+**Step 2 — Create an API key and install the client config**
+
+Run from the project you want to govern:
+
+```bash
+devtorch cloud key create --org myorg --repo myrepo
+# Copy the printed API key — it will not be shown again.
+
+export DEVTORCH_MCP_DOMAIN=devtorch-mcp.your-domain.com
+devtorch cloud client-config opencode --org myorg --repo myrepo --api-key <api-key>
+```
+
+This creates:
+- `opencode.json` — the OpenCode MCP server config (uses the local bridge)
+- `AGENTS.md` — DevTorch governance instructions for the model
+
+**Step 3 — Verify**
+```bash
+devtorch doctor
+```
+
+Open the project in OpenCode. The DevTorch MCP tools will be listed, and the model will be instructed to call `devtorch_context` at the start of each task and `devtorch_commit` before every file edit.
+
+**What you get:** Cloud-hosted MCP server integration with automatic local fallback, automatic reasoning commits via `AGENTS.md` instructions, and a shared Θ state across sessions.
+
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2 && devtorch cloud client-config opencode --org <org> --repo <repo> --api-key <api-key>` will regenerate `opencode.json` with the latest bridge and fallback settings. **Restart OpenCode** after updating the config.
+
 ---
 
 ### VS Code (with GitHub Copilot)
@@ -205,6 +280,8 @@ devtorch sensitivity add --source you --concept auth --confidence 0.9 --disclosu
 
 **What you get:** Sidebar panel (read-only), git-commit-level event capture, manual reasoning commits. Full capture requires switching to Claude Code, Cursor, Kiro, or Antigravity.
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2 && devtorch setup` will reinstall the git hook and update the governance instructions.
+
 ---
 
 ### AWS Kiro
@@ -268,6 +345,8 @@ devtorch doctor
 
 **What you get:** Full RACP integration equivalent to Claude Code — MCP tools, steering-document governance, agent action hooks.
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2`, then re-run the manual steps above and refresh your steering document with the latest `AGENTS.md` text.
+
 ---
 
 ### AWS Bedrock (Python SDK)
@@ -299,6 +378,8 @@ All `invoke_model()` and `converse()` calls are identical. DevTorch injects the
 devtorch doctor
 ```
 
+> **Updating from an older version:** `pip install -U agentorch[wrapper]>=2.0.2`.
+
 ---
 
 ### Azure AI Foundry (Python SDK)
@@ -331,6 +412,8 @@ client = AzureOpenAI(
 devtorch doctor
 ```
 
+> **Updating from an older version:** `pip install -U agentorch[wrapper]>=2.0.2`.
+
 ---
 
 ### OpenAI Codex CLI
@@ -355,6 +438,8 @@ codex "Add error handling to the payment service"
 
 All Codex calls are intercepted by the proxy, which injects the RACP prefix and captures responses into `.GCC/`.
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2`.
+
 ---
 
 ### Ollama (local models)
@@ -387,6 +472,8 @@ devtorch doctor
 
 No API key required. Fully local — RACP context and captures stay on-device.
 
+> **Updating from an older version:** `pip install -U agentorch[wrapper]>=2.0.2`.
+
 ---
 
 ### Cloud MCP server (team-wide shared governance)
@@ -428,6 +515,14 @@ Supported `<ide>` values: `opencode`, `claude`, `cursor`, `vscode`, `stdio`.
 
 **Full walkthrough:** `IDE_SETUP.md` has step-by-step setup for OpenCode, Claude Code, Cursor, VS Code, Kiro, Antigravity, JetBrains, and generic MCP clients.
 
+> **Updating from an older version:** You do **not** need to redeploy the Cloudflare Worker for client-side changes. Just regenerate the IDE config on each machine after upgrading `agentorch`:
+> ```bash
+> pip install -U agentorch>=2.0.2
+> export DEVTORCH_MCP_DOMAIN=devtorch-mcp.YOUR_ACCOUNT.workers.dev
+> /path/to/DevTorch/Implementation/deploy/cloudflare-worker/install-client-config.sh \
+>   <ide> <org> <repo> <api-key>
+> ```
+
 ---
 
 ### Platform comparison

{agentorch-2.0.0 → agentorch-2.0.2}/agentorch.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentorch
-Version: 2.0.0
+Version: 2.0.2
 Summary: DevTorch — AI reasoning capture, audit trail, and governance for agent-assisted development
 Author-email: Hemant Joshi <hemant@flotorch.ai>
 License: Apache-2.0
@@ -52,8 +52,10 @@ Requires-Dist: agentorch[cloud,mcp,proxy,wrapper]; extra == "all"
 
 **Local-first AI agent governance.** DevTorch gives multi-agent systems a shared on-disk audit trail, coordination vector, privacy controls, and LLM integration layer — all without a remote service.
 
+> **Latest release:** `agentorch 2.0.2` — MCP bridge with automatic local fallback, plus upgrade/reinstall docs for all IDE integrations. Install or upgrade with `pip install -U agentorch`.
+
 ```bash
-pip install agentorch
+pip install -U agentorch>=2.0.2
 devtorch init
 devtorch setup          # connects to Claude Code, Cursor, or Antigravity
 devtorch debug timeline
@@ -76,13 +78,13 @@ devtorch debug timeline
 
 ### Reasoning Plus
 
-Reasoning Plus is DevTorch’s default augmentation mode: before every LLM call, it gathers smart context from your workspace and asks the model to produce inline `<thinking>` reasoning before the final answer. The reasoning is captured to `.GCC/` automatically and stripped from the response your tool sees.
+Reasoning Plus is DevTorch’s default augmentation mode: before every LLM call, it gathers smart context from your workspace, asks the model to produce inline `<thinking>` reasoning, and learns from previous calls by re-injecting relevant reasoning into subsequent prompts. The reasoning is captured to `.GCC/` automatically and stripped from the response your tool sees.
 
 ```bash
 devtorch reasoning-plus status          # show current settings
 devtorch reasoning-plus enable          # turn on per project
 devtorch reasoning-plus disable         # turn off per project
-devtorch reasoning-plus config --smart-top-n 3 --smart-max-lines 150
+devtorch reasoning-plus config --smart-top-n 3 --smart-max-lines 150 --learning-top-n 3
 ```
 
 Set `DEVTORCH_REASONING_PLUS=0` to disable it for a single session. See [REASONING_PLUS.md](REASONING_PLUS.md) for details.
@@ -111,6 +113,35 @@ pip install agentorch[all]       # everything
 
 ---
 
+## Upgrade from an older version
+
+DevTorch preserves your `.GCC/` store across upgrades. Newer releases add IDE configs, hooks, or governance instructions, so you should re-run `devtorch setup` after upgrading.
+
+**Upgrade any time:**
+
+```bash
+pip install -U agentorch>=2.0.2
+cd /path/to/your/project
+devtorch setup              # or: devtorch setup --target <ide>
+devtorch doctor
+```
+
+`devtorch setup` is idempotent:
+- It rewrites `CLAUDE.md` / `AGENTS.md` with the latest governance instructions.
+- It regenerates IDE-specific config files (`.claude/settings.json`, `.cursor/mcp.json`, `opencode.json`, etc.).
+- It leaves existing `.GCC/` data untouched.
+
+**If you use the cloud MCP server**, re-run the client config installer after upgrade to get the latest bridge and fallback settings:
+
+```bash
+export DEVTORCH_MCP_DOMAIN=devtorch-mcp.your-domain.com
+devtorch cloud client-config <ide> --org <org> --repo <repo> --api-key <api-key>
+```
+
+Supported `<ide>` values: `opencode`, `claude`, `cursor`, `vscode`, `stdio`.
+
+---
+
 ## Getting Started
 
 DevTorch takes **5 minutes to set up**. Pick your AI coding tool below.
@@ -153,6 +184,8 @@ Open Claude Code in your project. On the first task Claude will call `devtorch_c
 
 **What you get:** Full RACP integration — reasoning commits, sensitivity events, coordination vector Θ, divergence detection, HITL conflict resolution.
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2 && devtorch setup` will rewrite `.claude/hooks.json`, `.claude/settings.json`, and `CLAUDE.md` with the latest versions.
+
 ---
 
 ### Cursor
@@ -195,6 +228,8 @@ devtorch doctor
 
 **What you get:** MCP tools, VS Code sidebar, optional HTTP proxy for passive capture of all LLM calls (`devtorch proxy start`).
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2 && devtorch setup --target cursor` will regenerate `.cursor/mcp.json` and update `CLAUDE.md`.
+
 ---
 
 ### Google Antigravity
@@ -225,6 +260,46 @@ devtorch doctor
 
 **What you get:** Full RACP integration. The multi-agent nature of Antigravity makes Θ accumulation especially valuable — multiple agents share the same reasoning state through `devtorch_context`.
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2 && devtorch setup --target antigravity` will regenerate the MCP config and update `AGENTS.md`.
+
+---
+
+### OpenCode
+
+OpenCode connects to DevTorch through the local stdio ↔ SSE bridge. The bridge talks to the cloud MCP server first, and if the cloud is unreachable or slow it automatically falls back to the local `devtorch` CLI so your `.GCC/` audit trail is never lost.
+
+**Step 1 — Install DevTorch**
+```bash
+pip install agentorch
+```
+
+**Step 2 — Create an API key and install the client config**
+
+Run from the project you want to govern:
+
+```bash
+devtorch cloud key create --org myorg --repo myrepo
+# Copy the printed API key — it will not be shown again.
+
+export DEVTORCH_MCP_DOMAIN=devtorch-mcp.your-domain.com
+devtorch cloud client-config opencode --org myorg --repo myrepo --api-key <api-key>
+```
+
+This creates:
+- `opencode.json` — the OpenCode MCP server config (uses the local bridge)
+- `AGENTS.md` — DevTorch governance instructions for the model
+
+**Step 3 — Verify**
+```bash
+devtorch doctor
+```
+
+Open the project in OpenCode. The DevTorch MCP tools will be listed, and the model will be instructed to call `devtorch_context` at the start of each task and `devtorch_commit` before every file edit.
+
+**What you get:** Cloud-hosted MCP server integration with automatic local fallback, automatic reasoning commits via `AGENTS.md` instructions, and a shared Θ state across sessions.
+
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2 && devtorch cloud client-config opencode --org <org> --repo <repo> --api-key <api-key>` will regenerate `opencode.json` with the latest bridge and fallback settings. **Restart OpenCode** after updating the config.
+
 ---
 
 ### VS Code (with GitHub Copilot)
@@ -255,6 +330,8 @@ devtorch sensitivity add --source you --concept auth --confidence 0.9 --disclosu
 
 **What you get:** Sidebar panel (read-only), git-commit-level event capture, manual reasoning commits. Full capture requires switching to Claude Code, Cursor, Kiro, or Antigravity.
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2 && devtorch setup` will reinstall the git hook and update the governance instructions.
+
 ---
 
 ### AWS Kiro
@@ -318,6 +395,8 @@ devtorch doctor
 
 **What you get:** Full RACP integration equivalent to Claude Code — MCP tools, steering-document governance, agent action hooks.
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2`, then re-run the manual steps above and refresh your steering document with the latest `AGENTS.md` text.
+
 ---
 
 ### AWS Bedrock (Python SDK)
@@ -349,6 +428,8 @@ All `invoke_model()` and `converse()` calls are identical. DevTorch injects the
 devtorch doctor
 ```
 
+> **Updating from an older version:** `pip install -U agentorch[wrapper]>=2.0.2`.
+
 ---
 
 ### Azure AI Foundry (Python SDK)
@@ -381,6 +462,8 @@ client = AzureOpenAI(
 devtorch doctor
 ```
 
+> **Updating from an older version:** `pip install -U agentorch[wrapper]>=2.0.2`.
+
 ---
 
 ### OpenAI Codex CLI
@@ -405,6 +488,8 @@ codex "Add error handling to the payment service"
 
 All Codex calls are intercepted by the proxy, which injects the RACP prefix and captures responses into `.GCC/`.
 
+> **Updating from an older version:** `pip install -U agentorch>=2.0.2`.
+
 ---
 
 ### Ollama (local models)
@@ -437,6 +522,8 @@ devtorch doctor
 
 No API key required. Fully local — RACP context and captures stay on-device.
 
+> **Updating from an older version:** `pip install -U agentorch[wrapper]>=2.0.2`.
+
 ---
 
 ### Cloud MCP server (team-wide shared governance)
@@ -478,6 +565,14 @@ Supported `<ide>` values: `opencode`, `claude`, `cursor`, `vscode`, `stdio`.
 
 **Full walkthrough:** `IDE_SETUP.md` has step-by-step setup for OpenCode, Claude Code, Cursor, VS Code, Kiro, Antigravity, JetBrains, and generic MCP clients.
 
+> **Updating from an older version:** You do **not** need to redeploy the Cloudflare Worker for client-side changes. Just regenerate the IDE config on each machine after upgrading `agentorch`:
+> ```bash
+> pip install -U agentorch>=2.0.2
+> export DEVTORCH_MCP_DOMAIN=devtorch-mcp.YOUR_ACCOUNT.workers.dev
+> /path/to/DevTorch/Implementation/deploy/cloudflare-worker/install-client-config.sh \
+>   <ide> <org> <repo> <api-key>
+> ```
+
 ---
 
 ### Platform comparison

{agentorch-2.0.0 → agentorch-2.0.2}/agentorch.egg-info/SOURCES.txt

@@ -18,6 +18,7 @@ benchmarks/swe_bench/run_baseline.py
 benchmarks/swe_bench/run_devtorch.py
 benchmarks/swe_bench/seed_gcc.py
 devtorch_cli/__init__.py
+devtorch_cli/__main__.py
 devtorch_cli/main.py
 devtorch_core/__init__.py
 devtorch_core/aggphi_textual.py
@@ -50,6 +51,15 @@ devtorch_core/alerts/teams.py
 devtorch_core/broadcast/__init__.py
 devtorch_core/broadcast/broadcaster.py
 devtorch_core/broadcast/watcher.py
+devtorch_core/cloud/__init__.py
+devtorch_core/cloud/client_config.py
+devtorch_core/cloud/devtorch-mcp-bridge.js
+devtorch_core/cloud/client_configs/.claude-opencode-fallback.json
+devtorch_core/cloud/client_configs/.claude-stdio.json
+devtorch_core/cloud/client_configs/.cursor-mcp.json
+devtorch_core/cloud/client_configs/.opencode-bridge.json
+devtorch_core/cloud/client_configs/.opencode.json
+devtorch_core/cloud/client_configs/.vscode-mcp.json
 devtorch_core/codex/__init__.py
 devtorch_core/codex/__main__.py
 devtorch_core/codex/capture.py
@@ -60,6 +70,7 @@ devtorch_core/consolidation/workflow.py
 devtorch_core/divergence/__init__.py
 devtorch_core/divergence/detector.py
 devtorch_core/gateway/__init__.py
+devtorch_core/gateway/key_manager.py
 devtorch_core/gateway/metrics_webhook.py
 devtorch_core/gateway/policy.py
 devtorch_core/gateway/server.py
@@ -96,8 +107,11 @@ devtorch_core/metrics/session_writer.py
 devtorch_core/metrics/shadow_ai.py
 devtorch_core/metrics/sprint_writer.py
 devtorch_core/observability/__init__.py
+devtorch_core/observability/datadog.py
 devtorch_core/observability/formatter.py
 devtorch_core/observability/report.py
+devtorch_core/observability/servicenow.py
+devtorch_core/observability/splunk.py
 devtorch_core/observability/webhook.py
 devtorch_core/parser/__init__.py
 devtorch_core/parser/blocks.py
@@ -118,6 +132,15 @@ devtorch_core/reasoning_plus/capture.py
 devtorch_core/reasoning_plus/config.py
 devtorch_core/reasoning_plus/context.py
 devtorch_core/reasoning_plus/prompt.py
+devtorch_core/reasoning_plus/learning/__init__.py
+devtorch_core/reasoning_plus/learning/api.py
+devtorch_core/reasoning_plus/learning/composer.py
+devtorch_core/reasoning_plus/learning/extractor.py
+devtorch_core/reasoning_plus/learning/models.py
+devtorch_core/reasoning_plus/learning/recorder.py
+devtorch_core/reasoning_plus/learning/relevance.py
+devtorch_core/reasoning_plus/learning/state.py
+devtorch_core/reasoning_plus/learning/store.py
 devtorch_core/rep_network/__init__.py
 devtorch_core/rep_network/merge.py
 devtorch_core/rep_network/node.py
@@ -140,6 +163,7 @@ tests/conftest.py
 tests/test_backend_factory.py
 tests/test_broadcast.py
 tests/test_cloud_auth.py
+tests/test_cloud_bridge.py
 tests/test_cloud_integration.py
 tests/test_cloud_sse.py
 tests/test_cloud_storage.py
@@ -164,6 +188,7 @@ tests/test_s15_rep_network.py
 tests/test_s16_alerts.py
 tests/test_s17a_metrics.py
 tests/test_s17b_observability.py
+tests/test_s17b_sso.py
 tests/test_s18_credibility.py
 tests/test_s18_identity.py
 tests/test_s19_projects.py
@@ -176,6 +201,7 @@ tests/test_s21_hitl.py
 tests/test_s22_swe_bench.py
 tests/test_s22_swe_bench_dry_run.py
 tests/test_s23_reasoning_plus.py
+tests/test_s24_reasoning_plus_learning.py
 tests/test_s2_context.py
 tests/test_s3_sensitivity.py
 tests/test_s4_invariants.py
@@ -189,6 +215,7 @@ tests/test_s7_parser.py
 tests/test_s7_proxy.py
 tests/test_s7_wrappers.py
 tests/test_s7ent_gateway.py
+tests/test_s7ent_helm.py
 tests/test_s8_aggphi.py
 tests/test_s8_theta_synthesis.py
 tests/test_s9_gaps.py