feat(workflow): unify IDE Agent panel launch (verify/archive + fallbacks)

.github/workflows/ci.yml

@@ -35,6 +35,11 @@ jobs:
 
       - name: Test
         run: pnpm test
+        env:
+          NODE_OPTIONS: --max-old-space-size=8192
+
+      - name: Typecheck
+        run: ./scripts/check-typecheck-baseline.sh
 
       - name: Lint
         run: npx eslint src/

CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+
+- Workflow actions (Apply, Verify, Archive, Continue, etc.) now launch through a unified IDE Agent panel path on Cursor and VS Code instead of opening an editor-area `agent` terminal by default.
+- Cursor hosts use runtime command detection with layered fallback: `composer.createNew` → `workbench.action.chat.open` + `composerMode.agent` → deeplink → clipboard.
+- Added `openspec.agentAutoSubmit` (`never` / `readOnly` / `always`, default `readOnly`). Auto-send applies only when `composer.createNew` succeeds.
+- Legacy `openspec.cursorLaunchMode` values `deeplink` and `chatCommand` migrate to `agentPanel`. Dashboard Ready to Verify CTA label is now **Run Verify** (action matches label).
+
 ## [0.2.3] - 2026-09-22
 
 ### Added

README.md

@@ -14,7 +14,7 @@ OpenSpec brings change planning and execution into the editor. Review what needs
 - **Stores and Worksets**: Use registered Stores as planning roots, then browse, inspect, create, and open trusted multi-folder Worksets without leaving the sidebar.
 - **Recommended actions**: A compact, resolver-backed action rail surfaces up to three next steps by priority: Needs Attention, Ready to Verify, then Recommended.
 - **Change detail**: Proposal, Specs, Design, Tasks, and Verify & Archive tabs with markdown rendering, task progress, and workflow controls.
-- **Safe workflow routing**: Review and verify actions open the appropriate detail or interactive terminal flow; high-impact archive actions stay confirmation-protected.
+- **Safe workflow routing**: Workflow buttons open the IDE Agent panel with `/opsx-*` commands; high-impact archive actions stay confirmation-protected.
 - **CLI integration**: OpenSpec CLI list, status, new, archive, Store, and Workset flows with retry, timeout, and `openspec.cliPath` fallback.
 - **Editor-native**: Uses VS Code theme tokens, Codicons, keyboard-accessible controls, and narrow-sidebar-friendly layouts.
 
@@ -105,7 +105,8 @@ Open Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`):
 | `openspec.taskExecutionMode` | `fillChat` | When clicking task execute: `auto` = run via adapter; `fillChat` = fill chat or copy to clipboard |
 | `openspec.workflowLaunchMode` | `clipboard` (VS Code) / smart launch in Cursor | **Launch with adapter (recommended)** or **Copy command only (safe)**. In Cursor with unset settings, defaults to launch mode. |
 | `openspec.preferredAgentAdapter` | `clipboard` (VS Code) / `cursor` in Cursor launch mode | Preferred agent executor when launch mode is adapter: `clipboard`, `cursor`, `vscode-copilot`, `claude-code`, or `opencode` |
-| `openspec.cursorLaunchMode` | `clipboard` (stored default) / `deeplink` in Cursor launch mode | Cursor launch behavior: `deeplink`, `chatCommand`, `clipboard`, or explicit `agentCli` (**may modify workspace files**; never auto-selected) |
+| `openspec.agentAutoSubmit` | `readOnly` | Auto-send in Cursor Agent panel: `never`, `readOnly` (explore/verify only), or `always` (composer layer only) |
+| `openspec.cursorLaunchMode` | `clipboard` (stored default) / `agentPanel` in Cursor launch mode | `agentPanel` (IDE Agent with fallback), `clipboard`, or explicit `agentCli` (**may modify workspace files**) |
 | `openspec.taskDependencyPolicy` | `block` | When preceding tasks are incomplete: `block` = prevent execution; `warn` = show warning and allow proceed |
 | `openspec.cursorAgentModel` | `auto` | Cursor Agent CLI model for explicit Agent CLI execution. Use `auto` or a specific model name |
 | `openspec.agentModel` | `auto` | Legacy Cursor Agent CLI model setting; prefer `openspec.cursorAgentModel` |
@@ -114,11 +115,10 @@ Open Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`):
 **Task execution & Adapters**
 
 - **Clipboard** (`clipboard`): Always available. Select **Copy command only (safe)** when you only want `/opsx:*` commands copied.
-- **Cursor** (`cursor`): In Cursor, defaults to opening the prompt deeplink (`deeplink`) or Chat (`chatCommand`). `agentCli` is available only when explicitly selected and may modify workspace files.
+- **Cursor** (`cursor`): In Cursor, defaults to the Agent panel (`agentPanel`) with runtime fallback (composer → chat → deeplink → clipboard). `agentCli` is opt-in and may modify workspace files.
 - **OpenCode** (`opencode`): Uses `/opsx-<action>` command format when routed through the adapter.
 - In Cursor, unset workflow settings smart-default to launch mode with the Cursor adapter. Choose **Copy command only (safe)** in settings to restore copy-only behavior. If launch fails, the extension falls back to clipboard with a visible notice.
-- Verify and Archive are intentionally different: they open the dedicated `Verify & Archive` tab and run inside a real VS Code terminal editor instead of the headless `agentCli` path.
-- Within that tab, `Review & Archive` keeps Agent review interactive, while `Archive Now` is the explicit direct-archive escape path and is disabled until the bound workflow is complete.
+- Verify and Archive use the same Agent panel launch path as Apply and Continue. The **Verify & Archive** tab also offers **Archive Now** (direct filesystem archive) when the workflow is complete.
 
 ### Dashboard
 

package.json

@@ -2,7 +2,7 @@
   "name": "openspec-workflow",
   "displayName": "OpenSpec Workflow",
   "description": "Project-first OpenSpec dashboard for changes, specs, stores, worksets, and safe workflow actions",
-  "version": "0.2.3",
+  "version": "0.2.4-agent-panel.18",
   "publisher": "randysss",
   "license": "MIT",
   "engines": {
@@ -101,23 +101,40 @@
           "default": "clipboard",
           "description": "Preferred Agent executor adapter used when workflowLaunchMode is adapter."
         },
+        "openspec.agentAutoSubmit": {
+          "type": "string",
+          "enum": [
+            "never",
+            "readOnly",
+            "always"
+          ],
+          "default": "readOnly",
+          "description": "When launching in the Cursor Agent panel via composer.createNew, auto-send the workflow command. readOnly auto-sends explore and verify only; other layers always prefill.",
+          "enumDescriptions": [
+            "Never auto-send; always prefill and wait for Enter.",
+            "Auto-send read-only workflow commands (explore, verify).",
+            "Auto-send every workflow command (including apply and archive)."
+          ]
+        },
         "openspec.cursorLaunchMode": {
           "type": "string",
           "enum": [
             "clipboard",
+            "agentPanel",
             "deeplink",
             "chatCommand",
             "agentCli"
           ],
           "default": "clipboard",
-          "description": "Cursor adapter launch behavior for non-interactive workflow actions. Verify and Archive use the dedicated Verify & Archive tab; `agentCli` here means headless Agent CLI.",
+          "description": "Cursor launch behavior. agentPanel opens the IDE Agent panel with runtime fallback (composer → chat → deeplink → clipboard). agentCli runs headless Agent CLI and may modify files.",
           "enumDescriptions": [
-            "Only copy the generated command to the clipboard. Does not open Cursor or start Agent CLI.",
-            "Open Cursor through the prompt deeplink with the generated command prefilled. The command is also copied as fallback.",
-            "Open Cursor Chat through the VS Code/Cursor chat command query. The command is also copied as fallback.",
-            "Run the generated command through Cursor Agent CLI in headless mode. May modify workspace files. Requires explicit selection."
+            "Only copy the generated command to the clipboard.",
+            "Open the Cursor Agent panel with `/opsx-*` prefilled (recommended).",
+            "Legacy alias for agentPanel.",
+            "Legacy alias for agentPanel.",
+            "Headless Cursor Agent CLI in the Output panel. May modify workspace files."
           ],
-          "markdownDescription": "Cursor adapter launch behavior for workflow actions.\\n\\n- `clipboard`: only copy the generated `/opsx:*` command.\\n- `deeplink`: open Cursor prompt deeplink with `/opsx-*` prefilled, while keeping clipboard fallback.\\n- `chatCommand`: try Cursor Chat query prefill, while keeping clipboard fallback.\\n- `agentCli`: **May modify workspace files.** Run Cursor Agent CLI directly in headless mode; never used unless you explicitly select it."
+          "markdownDescription": "Cursor workflow launch behavior.\\n\\n- `agentPanel` (default on Cursor): IDE Agent panel with layered fallback.\\n- `clipboard`: copy only.\\n- `agentCli`: **May modify workspace files.** Headless CLI opt-in.\\n- `deeplink` / `chatCommand`: migrated to `agentPanel`."
         },
         "openspec.taskDependencyPolicy": {
           "type": "string",
@@ -245,7 +262,7 @@
     "build:webview": "vite build",
     "dev:webview": "vite",
     "postinstall": "node scripts/link-vitest-pnpm.js",
-    "test": "vitest run",
+    "test": "NODE_OPTIONS=--max-old-space-size=8192 vitest run",
     "test:watch": "vitest",
     "package": "node scripts/package-with-marketplace-readme.js",
     "verify:vsix-webview": "node scripts/verify-vsix-webview.js",

scripts/check-typecheck-baseline.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+BASELINE="${TSC_BASELINE_ERROR_COUNT:-13}"
+LOG="$(mktemp)"
+trap 'rm -f "$LOG"' EXIT
+
+# Must match local: npx tsc --noEmit -p tsconfig.typecheck.json
+npx tsc --noEmit -p tsconfig.typecheck.json >"$LOG" 2>&1 || true
+COUNT="$(rg -c 'error TS' "$LOG" || true)"
+COUNT="${COUNT:-0}"
+
+if [ "$COUNT" -gt "$BASELINE" ]; then
+  echo "TypeScript error count $COUNT exceeds baseline $BASELINE"
+  cat "$LOG"
+  exit 1
+fi
+
+echo "TypeScript check OK ($COUNT errors, baseline $BASELINE)"

scripts/verify-vsix-webview.js

@@ -8,7 +8,9 @@ const path = require('path');
 const { execSync } = require('child_process');
 
 const rootDir = path.resolve(__dirname, '..');
-const inputPath = path.resolve(rootDir, process.argv[2] ?? 'openspec-workflow-0.2.2.vsix');
+const pkg = JSON.parse(fs.readFileSync(path.join(rootDir, 'package.json'), 'utf8'));
+const defaultVsixName = `${pkg.name}-${pkg.version}.vsix`;
+const inputPath = path.resolve(rootDir, process.argv[2] ?? defaultVsixName);
 
 const REQUIRED_MARKERS = [
   'openspec-webview-executor-ui-v1',

src/extension/adapters/adapterRegistry.ts

@@ -1,4 +1,4 @@
 import * as vscode from 'vscode';
 import type { AgentAdapterOption } from '../../shared/executorLaunchPresentation';
 import { clipboardAdapter } from './clipboard-adapter';
 import { claudeCodeAdapter } from './claude-code-adapter';
@@ -7,6 +7,7 @@
 import { vscodeChatAdapter } from './vscode-chat-adapter';
 import { vscodeCopilotAdapter } from './vscode-copilot-adapter';
 import type { IAgentExecutorAdapter } from '../services/agentExecutor.types';
+import { isCursorHost } from '../utils/isCursorHost';
 
 const registeredAdapters: IAgentExecutorAdapter[] = [
   vscodeCopilotAdapter,
@@ -17,10 +18,6 @@
   clipboardAdapter,
 ];
 
-function isCursorHost(): boolean {
-  return (vscode.env.appName ?? '').toLowerCase().includes('cursor');
-}
-
 /** Runtime launch adapters (must pass isAvailable). */
 export async function getAvailableAdapters(): Promise<IAgentExecutorAdapter[]> {
   const results = await Promise.all(

src/extension/adapters/cursor-adapter.ts

@@ -8,11 +8,12 @@ import type {
 import { logger } from '../utils/logger';
 import { t } from '../../i18n';
 import { buildWorkflowCommand } from '../../shared/workflowCommand';
-import { buildCursorPromptDeeplink } from '../services/cursorDeeplink';
 import { getCursorAgentModel, getWorkflowLaunchConfig } from '../services/workflowLaunchConfig';
+import { launchAgentPanelPrompt } from '../services/agentPanelLauncher';
+import { notifyWorkflowCommandCopied } from '../services/workflowClipboardNotify';
 
 const ADAPTER_ID = 'cursor';
-const DISPLAY_NAME = 'Cursor (agent CLI)';
+const DISPLAY_NAME = 'Cursor (Agent)';
 const OUTPUT_CHANNEL_NAME = 'OpenSpec (Agent)';
 const NO_OUTPUT_NOTICE_MS = 10000;
 const STILL_RUNNING_NOTICE_MS = 30000;
@@ -160,31 +161,27 @@ export const cursorAdapter: IAgentExecutorAdapter = {
     }
 
     if (cursorLaunchMode === 'clipboard') {
-      vscode.window.showInformationMessage(t('workflow.copiedCommand', { command: text }));
+      notifyWorkflowCommandCopied(text);
       return { success: true, adapterId: ADAPTER_ID, message: 'Copied to clipboard' };
     }
 
-    if (cursorLaunchMode === 'chatCommand') {
-      try {
-        await vscode.commands.executeCommand('workbench.action.chat.open', {
-          query: text,
-          isPartialQuery: true,
-        });
-        vscode.window.showInformationMessage(t('cursor.chatOpenedCopied', { command: text }));
-        return { success: true, adapterId: ADAPTER_ID, message: 'Chat opened with prompt' };
-      } catch {
-        vscode.window.showInformationMessage(t('cursor.chatOpenFailedCopied', { command: text }));
-        return { success: true, adapterId: ADAPTER_ID, message: 'Copied to clipboard' };
-      }
-    }
-
-    try {
-      await vscode.env.openExternal(vscode.Uri.parse(buildCursorPromptDeeplink(text)));
-      vscode.window.showInformationMessage(t('cursor.promptOpenedCopied', { command: text }));
-      return { success: true, adapterId: ADAPTER_ID, message: 'Cursor prompt opened' };
-    } catch {
-      vscode.window.showInformationMessage(t('cursor.openFailedCopied', { command: text }));
-      return { success: true, adapterId: ADAPTER_ID, message: 'Copied to clipboard' };
+    const panelResult = await launchAgentPanelPrompt({
+      text,
+      autoSubmit: false,
+    });
+    if (panelResult.outcome === 'copied') {
+      vscode.window.showInformationMessage(t('agentLaunch.copied', { command: text }));
+    } else if (panelResult.outcome === 'started') {
+      vscode.window.showInformationMessage(t('agentLaunch.started', { command: text }));
+    } else if (panelResult.layer === 'deeplink') {
+      vscode.window.showInformationMessage(t('agentLaunch.deeplinkPrefilled', { command: text }));
+    } else {
+      vscode.window.showInformationMessage(t('agentLaunch.openedPanel', { command: text }));
     }
+    return {
+      success: panelResult.success,
+      adapterId: ADAPTER_ID,
+      message: panelResult.layer,
+    };
   },
 };

src/extension/adapters/vscode-chat-adapter.ts

@@ -1,6 +1,7 @@
 import * as vscode from 'vscode';
 import type { IAgentExecutorAdapter, TaskExecuteRequest, TaskExecuteResult } from '../services/agentExecutor.types';
 import { t } from '../../i18n';
+import { launchAgentPanelPrompt } from '../services/agentPanelLauncher';
 
 const ADAPTER_ID = 'vscode-chat';
 const DISPLAY_NAME = 'VS Code Chat';
@@ -23,16 +24,17 @@ export const vscodeChatAdapter: IAgentExecutorAdapter = {
 
   async fillChat(request: TaskExecuteRequest): Promise<TaskExecuteResult> {
     const prompt = request.promptOverride ?? `/opsx:apply ${request.changeName}`;
-    try {
-      await vscode.commands.executeCommand('workbench.action.chat.open', {
-        query: prompt,
-        isPartialQuery: true,
-      });
-      return { success: true, adapterId: ADAPTER_ID, message: 'Chat opened with prompt' };
-    } catch {
-      await vscode.env.clipboard.writeText(prompt);
-      vscode.window.showInformationMessage(t('clipboard.copiedChat'));
-      return { success: true, adapterId: ADAPTER_ID, message: 'Copied to clipboard (fallback)' };
+    await vscode.env.clipboard.writeText(prompt);
+    const panelResult = await launchAgentPanelPrompt({ text: prompt, autoSubmit: false });
+    if (panelResult.outcome === 'copied') {
+      vscode.window.showInformationMessage(t('agentLaunch.copied', { command: prompt }));
+    } else {
+      vscode.window.showInformationMessage(t('agentLaunch.prefilledChat', { command: prompt }));
     }
+    return {
+      success: panelResult.success,
+      adapterId: ADAPTER_ID,
+      message: panelResult.layer,
+    };
   },
 };

src/extension/adapters/vscode-copilot-adapter.ts

@@ -1,6 +1,7 @@
 import * as vscode from 'vscode';
 import type { IAgentExecutorAdapter, TaskExecuteRequest, TaskExecuteResult } from '../services/agentExecutor.types';
 import { t } from '../../i18n';
+import { launchAgentPanelPrompt } from '../services/agentPanelLauncher';
 
 const ADAPTER_ID = 'vscode-copilot';
 const DISPLAY_NAME = 'VS Code Copilot Chat';
@@ -20,16 +21,17 @@ export const vscodeCopilotAdapter: IAgentExecutorAdapter = {
 
   async fillChat(request: TaskExecuteRequest): Promise<TaskExecuteResult> {
     const prompt = request.promptOverride ?? `/opsx:apply ${request.changeName}`;
-    try {
-      await vscode.commands.executeCommand('workbench.action.chat.open', {
-        query: prompt,
-        isPartialQuery: true,
-      });
-      return { success: true, adapterId: ADAPTER_ID, message: 'Chat opened with prompt' };
-    } catch {
-      await vscode.env.clipboard.writeText(prompt);
-      vscode.window.showInformationMessage(t('clipboard.copiedChat'));
-      return { success: true, adapterId: ADAPTER_ID, message: 'Copied to clipboard (fallback)' };
+    await vscode.env.clipboard.writeText(prompt);
+    const panelResult = await launchAgentPanelPrompt({ text: prompt, autoSubmit: false });
+    if (panelResult.outcome === 'copied') {
+      vscode.window.showInformationMessage(t('agentLaunch.copied', { command: prompt }));
+    } else {
+      vscode.window.showInformationMessage(t('agentLaunch.prefilled', { command: prompt }));
     }
+    return {
+      success: panelResult.success,
+      adapterId: ADAPTER_ID,
+      message: panelResult.layer,
+    };
   },
 };

src/extension/extension.ts

@@ -153,6 +153,7 @@ export async function activate(context: vscode.ExtensionContext) {
     context.subscriptions.push(
       vscode.workspace.onDidChangeWorkspaceFolders(() => {
         void dashboardViewProvider.syncOpenSpecRootAvailability();
+        void dashboardViewProvider.syncProjectContextAfterWorkspaceChange();
       }),
     );
 
@@ -162,7 +163,9 @@ export async function activate(context: vscode.ExtensionContext) {
 
     logger.info('OpenSpec extension activated successfully');
     console.log('OpenSpec extension is now active!');
-    await promptReloadAfterInstallOrUpdate(context);
+    setTimeout(() => {
+      void promptReloadAfterInstallOrUpdate(context);
+    }, 4000);
   } catch (error) {
     logger.error('Failed to activate OpenSpec extension', error as Error);
     vscode.window.showErrorMessage(
@@ -181,13 +184,14 @@ async function promptReloadAfterInstallOrUpdate(context: vscode.ExtensionContext
   await context.globalState.update(key, marker);
   logger.info(`OpenSpec installation marker changed: previous=${previous ?? 'none'}, current=${marker}`);
   const reload = t('extension.reloadWindow');
-  const selected = await vscode.window.showInformationMessage(
+  void vscode.window.showInformationMessage(
     t('extension.reloadRecommended'),
-    reload
-  );
-  if (selected === reload) {
-    await vscode.commands.executeCommand('workbench.action.reloadWindow');
-  }
+    reload,
+  ).then((selected) => {
+    if (selected === reload) {
+      void vscode.commands.executeCommand('workbench.action.reloadWindow');
+    }
+  });
 }
 
 export function deactivate() {