vscode-autotest 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wenytang-ms
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,276 @@
+# VSCode AutoTest
+
+AI 驱动的 VSCode 扩展 E2E 测试框架。
+
+用户提供 YAML 格式的 Test Plan → 框架自动启动 VSCode → 执行操作 → 验证结果。
+
+> **目标**：让 Copilot CLI 直接读取 wiki 中的 Test Plan，自动完成 VSCode 扩展的端到端测试。
+
+---
+
+## 快速开始
+
+```bash
+# 安装依赖
+npm install
+
+# 编译
+npm run build
+
+# 验证 test plan 格式
+npx autotest validate test-plans/java-maven.yaml
+
+# 执行测试（含截图 + JSON 报告）
+npx autotest run test-plans/java-maven.yaml --output results.json
+
+# 自定义截图输出目录
+npx autotest run test-plans/java-maven.yaml --output results.json --screenshots ./my-shots
+```
+
+### 前置条件
+
+- Node.js ≥ 18
+- JDK 已安装（测试 Java 扩展时需要）
+- vscode-java 仓库已 clone 到本地（test plan 中引用了其测试项目）
+
+---
+
+## 核心架构
+
+```
+┌─────────────────────────────────────────────────────┐
+│             Test Plan (YAML / Markdown)              │
+│  描述测试步骤 + 预期结果，不包含硬编码 locator        │
+└──────────────────┬──────────────────────────────────┘
+                   │  planParser.ts
+                   ▼
+┌─────────────────────────────────────────────────────┐
+│              TestRunner (编排层)                      │
+│  启动 VSCode → 逐步执行 → 截图 → 报告               │
+│                                                     │
+│  ┌──────────────────┐  ┌─────────────────────────┐  │
+│  │  ActionResolver   │  │     StepVerifier        │  │
+│  │  自然语言 → Driver │  │  确定性验证 + LLM 验证  │  │
+│  │  (16 种 regex)    │  │  (6 种策略)             │  │
+│  └────────┬─────────┘  └──────────┬──────────────┘  │
+│           │                       │                  │
+│           │              ┌────────┴────────┐         │
+│           │              │    LLMClient    │         │
+│           │              │  Azure OpenAI   │         │
+│           │              │  screenshot →   │         │
+│           │              │  pass/fail      │         │
+│           │              └─────────────────┘         │
+└───────────┼──────────────────────────────────────────┘
+            ▼
+┌─────────────────────────────────────────────────────┐
+│           VscodeDriver (操作原语 SDK)                 │
+│  基于 Playwright Electron + @vscode/test-electron    │
+│  工作区隔离 · 事件驱动等待 · 进程生命周期管理          │
+└──────────────────┬──────────────────────────────────┘
+                   │
+                   ▼
+┌─────────────────────────────────────────────────────┐
+│           Playwright Electron Runtime                │
+│  启动 VSCode 进程，提供 Page 对象                    │
+└─────────────────────────────────────────────────────┘
+```
+
+---
+
+## 编写 Test Plan
+
+### 基本结构
+
+```yaml
+name: "我的测试"
+setup:
+  extension: "my-extension"
+  extensionPath: "./path/to/extension"
+  vscodeVersion: "stable"
+  workspace: "./test-workspace"   # 相对于 test plan 文件的路径
+  timeout: 60
+  settings:                       # 可选：注入 VSCode settings
+    editor.fontSize: 14
+
+steps:
+  - id: "step-1"
+    action: "执行命令 My Extension: Hello"
+    verifyNotification: "Hello World!"
+```
+
+> **路径解析**：`workspace` 和 `extensionPath` 相对于 test plan 文件所在目录解析，不依赖 CWD。
+
+### 支持的 Action（自然语言 → Driver 映射）
+
+| Action 写法 | 映射操作 | 示例 |
+|-------------|---------|------|
+| `执行命令 XXX` / `run command XXX` | Command Palette 执行 | `执行命令 Java: Force Java Compilation` |
+| `打开文件 XXX` / `open file XXX` | Quick Open 打开文件（含重试） | `打开文件 Foo.java` |
+| `点击侧边栏 XXX tab` | 切换侧边栏 Tab | `点击侧边栏 Explorer tab` |
+| `展开/点击 XXX 节点` | TreeView 操作 | `展开 APIs 节点` |
+| `选择 XXX 选项` | Palette 选项选择 | `选择 Full 选项` |
+| `等待 N 秒` / `wait N seconds` | 等待指定时间 | `等待 5 秒` |
+| `saveFile` / `保存文件` | Ctrl+S 保存 | `saveFile` |
+| `goToLine N` / `跳转到行 N` | Ctrl+G 跳转行 | `goToLine 15` |
+| `goToEndOfLine` / `跳转到行尾` | End 键 | `goToEndOfLine` |
+| `waitForLanguageServer` | 等待 LS 就绪 | `waitForLanguageServer` |
+| `typeInEditor XXX` | 在编辑器输入文本 | `typeInEditor System.out.println()` |
+| `typeAndTriggerSnippet XXX` | 输入并触发代码片段 | `typeAndTriggerSnippet class` |
+| `navigateToError N` | 跳转到第 N 个错误 | `navigateToError 1` |
+| `applyCodeAction XXX` | 执行 Code Action | `applyCodeAction Import 'ArrayList'` |
+| `triggerCompletion` | 触发代码补全 | `triggerCompletion` |
+| `insertLineInFile <path> <line> <text>` | 磁盘修改文件 + 编辑器重载 | `insertLineInFile src/Foo.java 2 import java.util.*;` |
+
+### 支持的验证方式
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `verify` | string | 自然语言描述预期结果（LLM 截图验证，需配置 Azure OpenAI） |
+| `verifyFile` | object | 文件存在性 / 内容匹配 |
+| `verifyNotification` | string | 通知消息匹配 |
+| `verifyEditor` | object | 编辑器内容（检查 Monaco model + 可见 DOM） |
+| `verifyProblems` | object | Problems 面板错误/警告计数（支持 `atLeast` 模式 + 轮询等待） |
+| `verifyCompletion` | object | 代码补全列表验证 |
+
+---
+
+## 测试隔离与截图
+
+### 工作区隔离
+
+每次运行自动将 `workspace` 复制到固定临时目录 (`autotest-workspace/`)，测试结束后清理。原始工作区**永远不会被修改**。
+
+### 截图策略
+
+每个步骤自动截图，保存到 `./screenshots/`（可通过 `--screenshots` 自定义）：
+
+| 步骤状态 | 截图文件 |
+|---------|---------|
+| ✅ pass | `{stepId}_after.png` |
+| ❌ fail / error | `{stepId}_before.png` + `{stepId}_after.png` 或 `{stepId}_error.png` |
+
+### 进程管理
+
+- 每次启动前自动清空 VSCode user-data 目录，防止旧窗口恢复
+- Ctrl+C 中断时自动关闭 VSCode 进程
+- `close()` 带重试机制处理 Windows 文件锁
+
+---
+
+## LLM 验证（可选）
+
+`verify` 字段支持自然语言描述，框架会将截图发送给 Azure OpenAI GPT-4o 进行视觉判断：
+
+```yaml
+- id: "check-ls"
+  action: "waitForLanguageServer"
+  verify: "状态栏显示 Java 语言服务器已就绪（👍 图标）"   # ← LLM 看截图判断
+  verifyProblems:                                        # ← 确定性验证照常执行
+    errors: 0
+```
+
+配置环境变量启用：
+
+```bash
+export AZURE_OPENAI_ENDPOINT=https://<resource>.openai.azure.com/
+export AZURE_OPENAI_API_KEY=<key>
+export AZURE_OPENAI_DEPLOYMENT=gpt-4o        # 可选，默认 gpt-4o
+```
+
+- 未配置时 `verify` 字段自动跳过，确定性验证不受影响
+- `--no-llm` 强制跳过 LLM 验证
+
+---
+
+## Copilot CLI 集成
+
+本项目提供 `AGENTS.md`，Copilot CLI 在此目录下可直接运行测试：
+
+```
+> 运行 java-maven 测试
+```
+
+Copilot CLI 会自动执行 `npx autotest run`，读取结果和截图，分析失败原因。
+
+详见 [AGENTS.md](AGENTS.md)。
+
+---
+
+## 现有 Test Plan
+
+| 文件 | 步数 | 来源 | 场景 | 状态 |
+|------|------|------|------|------|
+| `java-maven.yaml` | 8 | wiki Maven | LS → 补全 → 导航 → 编辑 → 诊断 | ✅ 8/8 |
+| `java-maven-multimodule.yaml` | 5 | wiki Maven Multimodule | LS → 两模块补全 | ✅ 5/5 |
+| `java-maven-java25.yaml` | 6 | wiki Maven Java 25 | JDK 25 → LS → 补全 → 编辑 | ✅ 6/6 |
+| `java-gradle.yaml` | 7 | wiki Gradle | LS → 补全 → 导航 → 编辑 | ✅ 7/7 |
+| `java-gradle-java25.yaml` | 6 | wiki Gradle Java 25 | JDK 25 → LS → 补全 → 编辑 | ✅ 6/6 |
+| `java-basic-editing.yaml` | 8 | wiki Basic #1-5 | LS → class 骨架 → call() 方法 → 编译 | ✅ 8/8 |
+| `java-basic-extended.yaml` | 8 | wiki Basic #6-8 | 补全 → Import → Rename | ✅ 8/8 |
+| `java-new-file-snippet.yaml` | 4 | wiki Basic #9 | 创建新 Java 文件 → class 骨架 | ✅ 4/4 |
+| `java-single-file.yaml` | 6 | wiki Single file | LS → 补全 → 编辑 | ✅ 6/6 |
+| `java-debugger.yaml` | 6 | wiki Debugger | 断点 → 启动调试 → 停止 | ✅ 6/6 |
+| `java-test-runner.yaml` | 6 | wiki Test Runner | 测试面板 → 运行全部 → CodeLens | ✅ 6/6 |
+| `java-maven-resolve-type.yaml` | 10 | wiki Maven for Java | 未知类型 → Hover → Code Action | ✅ 10/10 |
+| `java-dependency-viewer.yaml` | 4 | wiki Dependency Viewer | 依赖视图 → 节点展开 | ✅ 4/4 |
+| `java-extension-pack.yaml` | 3 | wiki Extension Pack | Configure Classpath 命令 | ✅ 3/3 |
+| `java-fresh-import.yaml` | 3 | wiki Fresh Import | Spring Petclinic → LS → 补全 | 🔲 需要 clone 项目 |
+
+### Wiki 场景覆盖情况
+
+| Wiki 场景 | 状态 | 阻碍 |
+|-----------|------|------|
+| Basic #1-5 | ✅ 已有 test plan | — |
+| Basic #6-8 (补全/Import/Rename) | ✅ 已有 test plan | — |
+| Basic #9 (New Java File snippet) | ✅ 已有 test plan | — |
+| Maven | ✅ 已有 test plan | — |
+| Maven Multimodule | ✅ 已有 test plan | — |
+| Gradle | ✅ 已有 test plan | — |
+| Maven Java 25 | ✅ 已有 test plan | — |
+| Gradle Java 25 | ✅ 已有 test plan | — |
+| Single file | ✅ 已有 test plan | — |
+| Single file without workspace | ❌ 未覆盖 | 需要拖拽文件（无 Driver 支持） |
+| Fresh import (spring-petclinic) | ✅ 已有 test plan | 需要提前 clone 项目 |
+| Debugger for Java | ✅ 已有 test plan | — |
+| Java Test Runner | ✅ 已有 test plan | — |
+| Maven for Java | ✅ 已有 test plan | — |
+| Java Dependency Viewer | ✅ 已有 test plan | — |
+| Java Extension Pack | ✅ 已有 test plan | webview 内部交互有限 |
+
+---
+
+## 项目结构
+
+```
+autotest/
+├── src/
+│   ├── drivers/
+│   │   └── vscodeDriver.ts    # Playwright VSCode 操作原语 (35+ 方法)
+│   ├── operators/
+│   │   ├── actionResolver.ts   # 自然语言 Action → Driver 调用 (16 种 regex)
+│   │   ├── stepVerifier.ts     # 确定性验证 + LLM 验证 (6 种策略)
+│   │   ├── llmClient.ts        # Azure OpenAI 客户端 (截图 → pass/fail)
+│   │   ├── planParser.ts       # YAML Test Plan 解析器（路径相对于 plan 文件）
+│   │   └── testRunner.ts       # 编排引擎（启动 → 执行 → 截图 → 报告）
+│   ├── cli/
+│   │   └── index.ts            # CLI 入口 (run / validate / --no-llm)
+│   ├── types.ts                # 核心类型定义
+│   └── index.ts                # SDK 导出
+├── test-plans/                  # YAML 测试计划
+├── test-results/                # 测试输出（每个 plan 一个子目录）
+│   └── <plan-name>/
+│       ├── results.json
+│       └── screenshots/
+├── AGENTS.md                    # Copilot CLI 集成指南
+├── docs/
+│   ├── architecture.md          # 架构文档
+│   ├── implementation-plan.md   # 实现计划
+│   └── ROADMAP.md               # 路线图
+└── package.json
+```
+
+## 相关文档
+
+- [架构设计](docs/architecture.md)
+- [实现计划](docs/implementation-plan.md)
+- [路线图](docs/ROADMAP.md)

package/dist/cli/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * AutoTest CLI — AI-driven VSCode extension E2E testing tool.
+ *
+ * Usage:
+ *   autotest run <test-plan.yaml>        Execute a test plan
+ *   autotest validate <test-plan.yaml>   Validate test plan format
+ */
+export {};

package/dist/cli/index.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+/**
+ * AutoTest CLI — AI-driven VSCode extension E2E testing tool.
+ *
+ * Usage:
+ *   autotest run <test-plan.yaml>        Execute a test plan
+ *   autotest validate <test-plan.yaml>   Validate test plan format
+ */
+import { Command } from "commander";
+import * as path from "node:path";
+import { loadTestPlan, validateTestPlanFile } from "../operators/planParser.js";
+import { TestRunner } from "../operators/testRunner.js";
+const program = new Command();
+program
+    .name("autotest")
+    .description("AI-driven VSCode extension E2E testing framework")
+    .version("0.1.0");
+program
+    .command("run <plan>")
+    .description("Execute a test plan against VSCode")
+    .option("--attach <port>", "Connect to an existing VSCode via CDP port")
+    .option("--interactive", "Step-by-step execution with manual confirmation")
+    .option("--output <dir>", "Output directory (default: ./test-results/<plan-name>)")
+    .option("--no-llm", "Skip LLM verification (auto-pass all verify fields)")
+    .action(async (planPath, opts) => {
+    try {
+        const plan = loadTestPlan(planPath);
+        console.log(`📋 Test Plan: ${plan.name}`);
+        console.log(`   Extension: ${plan.setup.extension}`);
+        console.log(`   Steps: ${plan.steps.length}`);
+        // Derive output dir from plan file name: test-results/<plan-name>/
+        const planName = path.basename(planPath, path.extname(planPath));
+        const outputDir = opts.output
+            ? path.resolve(opts.output)
+            : path.resolve("test-results", planName);
+        const runner = new TestRunner(plan, { outputDir, noLLM: opts.llm === false });
+        // Ensure VSCode is closed even if the process is interrupted (Ctrl+C)
+        const cleanup = async () => {
+            console.log("\n🛑 Interrupted — closing VSCode...");
+            await runner.cleanup();
+            process.exit(130);
+        };
+        process.on("SIGINT", cleanup);
+        process.on("SIGTERM", cleanup);
+        const report = await runner.run();
+        // Exit code based on results
+        process.exit(report.summary.failed + report.summary.errors > 0 ? 1 : 0);
+    }
+    catch (e) {
+        console.error(`❌ Error: ${e.message}`);
+        process.exit(1);
+    }
+});
+program
+    .command("validate <plan>")
+    .description("Validate a test plan YAML file")
+    .action((planPath) => {
+    const result = validateTestPlanFile(planPath);
+    if (result.valid) {
+        console.log(`✅ Test plan is valid: ${planPath}`);
+    }
+    else {
+        console.error(`❌ Invalid test plan: ${planPath}`);
+        result.errors.forEach((e) => console.error(`   - ${e}`));
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/drivers/vscodeDriver.d.ts

@@ -0,0 +1,179 @@
+/**
+ * VscodeDriver — Core driver for launching and controlling VSCode via Playwright.
+ *
+ * Provides stable operation primitives categorized by reliability:
+ * - Level 1 (🟢): Command-based — uses VSCode command system, extremely stable
+ * - Level 2 (🟡): Role-based — uses Accessibility roles, stable across versions
+ * - Level 3 (🟠): Snapshot-based — AI reads A11y tree to decide, fully dynamic
+ */
+import { type Page } from "@playwright/test";
+import type { A11yNode, Diagnostic, VscodeDriverOptions } from "../types.js";
+export declare class VscodeDriver {
+    private app;
+    private page;
+    private options;
+    /** Temp copy of workspace — cleaned up on close() */
+    private tempWorkspaceDir;
+    constructor(options?: VscodeDriverOptions);
+    launch(): Promise<void>;
+    /** Close all visible notification toasts */
+    dismissAllNotifications(): Promise<void>;
+    close(): Promise<void>;
+    getPage(): Page;
+    /** Execute a VSCode command via Command Palette (F1 → type → Enter) */
+    runCommandFromPalette(label: string): Promise<void>;
+    /** Open a file via Quick Open (Ctrl+P). Retries if the file indexer isn't ready. */
+    openFile(filePath: string): Promise<void>;
+    /** Get the content of the active editor */
+    getEditorContent(): Promise<string>;
+    /** Check if the active editor contains the specified text (checks model + visible DOM) */
+    editorContains(text: string): Promise<boolean>;
+    /** Save the active file (Ctrl+S) */
+    saveFile(): Promise<void>;
+    /** Go to a specific line number (Ctrl+G) */
+    goToLine(line: number): Promise<void>;
+    /** Move cursor to end of current line */
+    goToEndOfLine(): Promise<void>;
+    /** Execute a keyboard shortcut */
+    pressKeys(keys: string): Promise<void>;
+    /** Run a command in the integrated terminal */
+    runInTerminal(command: string): Promise<void>;
+    /** Activate a side tab by name (e.g., "Explorer", "Extensions", "API Center") */
+    activeSideTab(tabName: string): Promise<void>;
+    /** Check if a side tab is visible */
+    isSideTabVisible(tabName: string): Promise<boolean>;
+    /** Click a tree item by its display name */
+    clickTreeItem(name: string): Promise<void>;
+    /** Check if a tree item is visible */
+    isTreeItemVisible(name: string): Promise<boolean>;
+    /** Select an option by name in the Command Palette dropdown */
+    selectPaletteOption(optionText: string): Promise<void>;
+    /** Select an option by index in the Command Palette dropdown */
+    selectPaletteOptionByIndex(index: number): Promise<void>;
+    /** Get all current notification messages */
+    getNotifications(): Promise<string[]>;
+    /** Get status bar text */
+    getStatusBarText(): Promise<string>;
+    /** Get the Accessibility tree snapshot of the current window */
+    snapshot(): Promise<A11yNode>;
+    /** Get a DOM HTML snapshot */
+    domSnapshot(): Promise<string>;
+    /** Take a screenshot and return as buffer */
+    screenshot(outputPath?: string): Promise<Buffer>;
+    /** Click any element by role and name (generic) */
+    clickByRole(role: string, name: string): Promise<void>;
+    /** Click any element containing specific text */
+    clickByText(text: string): Promise<void>;
+    /** Type text into the active editor at the cursor position */
+    typeInEditor(text: string): Promise<void>;
+    /** Select all text in the active editor */
+    selectAllInEditor(): Promise<void>;
+    /** Replace entire editor content with new text */
+    setEditorContent(content: string): Promise<void>;
+    /**
+     * Type a snippet trigger word and select the snippet from completion list.
+     */
+    typeAndTriggerSnippet(triggerWord: string): Promise<void>;
+    /**
+     * Wait for the Java Language Server to become ready.
+     * Polls the status bar for the LS ready indicator.
+     */
+    waitForLanguageServer(timeoutMs?: number): Promise<boolean>;
+    /**
+     * Get the count of errors and warnings in the Problems panel.
+     */
+    getProblemsCount(): Promise<{
+        errors: number;
+        warnings: number;
+    }>;
+    /** Navigate to the next problem (error/warning) in the editor */
+    navigateToNextError(): Promise<void>;
+    /** Navigate to a specific error by index (1-based) */
+    navigateToError(index: number): Promise<void>;
+    /**
+     * Trigger Code Action menu at current cursor and select an action by label.
+     */
+    applyCodeAction(label: string): Promise<void>;
+    /**
+     * Trigger code completion (IntelliSense) at the current cursor position.
+     * Returns the visible completion items as an array of label strings.
+     */
+    triggerCompletion(): Promise<string[]>;
+    /** Dismiss the current completion widget */
+    dismissCompletion(): Promise<void>;
+    /** Check if an element with given role and name is visible */
+    isElementVisible(role: string, name: string): Promise<boolean>;
+    /** Get text content of an element by role and name */
+    getElementText(role: string, name: string): Promise<string>;
+    /** Get Problems panel diagnostics */
+    getProblems(): Promise<Diagnostic[]>;
+    /** Check if a file exists in the workspace */
+    fileExists(filePath: string): Promise<boolean>;
+    /** Check if a file contains specific text */
+    fileContains(filePath: string, text: string): Promise<boolean>;
+    /** Read file content */
+    readFile(filePath: string): Promise<string>;
+    /** Get the workspace root path (temp copy) */
+    getWorkspacePath(): string | null;
+    /**
+     * Insert a line into a file on disk at the specified line number (1-based).
+     * The file must already be open in the editor. After modifying on disk,
+     * reverts the editor to pick up changes — the LS stays active and re-analyzes quickly.
+     */
+    insertLineInFile(relativePath: string, lineNumber: number, text: string): Promise<void>;
+    /** Revert the current file to its on-disk state */
+    revertFile(): Promise<void>;
+    /** Start a debug session (F5 or via command) */
+    startDebugSession(): Promise<void>;
+    /** Stop the current debug session (Shift+F5) */
+    stopDebugSession(): Promise<void>;
+    /** Set a breakpoint at a specific line in the current file */
+    setBreakpoint(line: number): Promise<void>;
+    /** Wait for the debugger to hit a breakpoint */
+    waitForBreakpointHit(timeoutMs?: number): Promise<boolean>;
+    /** Debug step over (F10) */
+    debugStepOver(): Promise<void>;
+    /** Debug step into (F11) */
+    debugStepInto(): Promise<void>;
+    /** Debug step out (Shift+F11) */
+    debugStepOut(): Promise<void>;
+    /** Get variable values from the Variables panel */
+    getDebugVariables(): Promise<Array<{
+        name: string;
+        value: string;
+    }>>;
+    /** Get Debug Console output text */
+    getDebugConsoleOutput(): Promise<string>;
+    /** Open the Test Explorer view */
+    openTestExplorer(): Promise<void>;
+    /** Run all tests via command */
+    runAllTests(): Promise<void>;
+    /** Wait for test execution to complete by polling the test status bar */
+    waitForTestComplete(timeoutMs?: number): Promise<boolean>;
+    /** Get test results summary from the Test Explorer */
+    getTestResults(): Promise<{
+        passed: number;
+        failed: number;
+        total: number;
+    }>;
+    /** Click a CodeLens link by its text */
+    clickCodeLens(label: string): Promise<void>;
+    /** Hover on a symbol in the editor to trigger hover provider */
+    hoverOnText(text: string): Promise<void>;
+    /** Get the content of the hover popup */
+    getHoverContent(): Promise<string>;
+    /** Click an action link inside the hover popup */
+    clickHoverAction(label: string): Promise<void>;
+    /** Dismiss the hover popup */
+    dismissHover(): Promise<void>;
+    /** Right-click a tree item and select a context menu option */
+    contextMenuOnTreeItem(itemName: string, menuLabel: string): Promise<void>;
+    /** Create a new file via Explorer right-click menu */
+    createNewFileViaExplorer(parentFolder: string, fileName: string): Promise<void>;
+    /** Open the Java Dependencies view */
+    openDependencyExplorer(): Promise<void>;
+    /** Expand a chain of tree nodes (e.g., ["Sources", "src", "main"]) */
+    expandTreePath(names: string[]): Promise<void>;
+    /** Wait for a specified duration (seconds) */
+    wait(seconds: number): Promise<void>;
+}