Add an experimental OpenCode V2 sidebar and isolate validation

.github/workflows/ci.yml

@@ -79,6 +79,35 @@ jobs:
           printf '%s\n' '# disposable snapshot fixture' > scripts/.install-test-ci-untracked.py
           make install-test-full PYTHON=python
 
+  sidebar-v2:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: "22"
+
+      - name: Set up Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: "1.3.14"
+
+      - name: Install pinned V2 runtime and terminal tools
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y tmux
+          npm install --global @opencode/cli@2.2.6 --no-audit --no-fund
+          npm ci --prefix plugin/gateway-sidebar-v2 --ignore-scripts --no-audit --no-fund
+
+      - name: Validate V2 sidebar and live terminal behavior
+        run: |
+          npm --prefix plugin/gateway-sidebar-v2 run typecheck
+          npm --prefix plugin/gateway-sidebar-v2 test
+          npm --prefix plugin/gateway-sidebar-v2 run test:live -- --opencode-bin "$(command -v opencode)"
+
   windows-bounded-subprocess:
     runs-on: windows-latest
     steps:

.gitignore

@@ -8,6 +8,8 @@ plugin/gateway-core/*.tgz
 plugin/gateway-core@latest
 plugin/gateway-sidebar/node_modules/
 plugin/gateway-sidebar/*.tgz
+plugin/gateway-sidebar-v2/node_modules/
+plugin/gateway-sidebar-v2/*.tgz
 runtime/
 bg/
 .codememory/*.sqlite3

Makefile

@@ -22,7 +22,7 @@ python-check: ## Verify Python $(PYTHON_MIN_VERSION)+ runtime
 
 validate: ## Validate scripts and JSON config
 	$(PYTHON) -m py_compile scripts/*.py
-	$(PYTHON) -m unittest discover -s tests -p 'test_*.py'
+	$(PYTHON) scripts/isolated_unittest.py discover -s tests -p 'test_*.py'
 	$(PYTHON) -m json.tool opencode.json >/dev/null
 	$(PYTHON) -m json.tool tui.json >/dev/null
 	$(PYTHON) scripts/hygiene_drift_check.py

docs/plan/doing/opencode-v2-migration.md

@@ -35,6 +35,20 @@ It neither ports the backend guard nor grants parent-session authority.
 
 ## Progress
 
+The experimental V2 execution sidebar is a separate, unconfigured TUI plugin
+under `plugin/gateway-sidebar-v2`. It reads the existing private, bounded status
+format for the displayed session's location. Its unit tests and isolated tmux
+smoke cover status updates and plugin unload/reload on OpenCode 2.2.6. It does
+not provide a V2 status writer or establish gateway security parity; leave it
+unconfigured until the V2 gateway and its activation gates are complete.
+
+```sh
+npm ci --prefix plugin/gateway-sidebar-v2 --ignore-scripts
+npm --prefix plugin/gateway-sidebar-v2 run typecheck
+npm --prefix plugin/gateway-sidebar-v2 test
+npm --prefix plugin/gateway-sidebar-v2 run test:live -- --opencode-bin /path/to/opencode-2.2.6
+```
+
 The separate [native dependency-boundary probe](../../specs/opencode-v2-dependency-boundary-contract.md)
 measures the installed 2.2.5 built-in shell with synthetic fixtures only. It does
 not enable the gateway or qualify dependency installation authority; terminal