desk-1328-QA

.cursor/mcp http.json

@@ -0,0 +1,8 @@
+{
+    "mcpServers": {
+      "anaconda-mcp": {
+        "url": "http://localhost:8888/mcp",
+        "transport": "streamable-http"
+      }
+    }
+  }

.cursor/mcp stdio.json

@@ -0,0 +1,18 @@
+{
+  "mcpServers": {
+    "anaconda-mcp": {
+      "command": "/opt/miniconda3/envs/anaconda-mcp-rc-py312/bin/python",
+      "args": [
+        "-m",
+        "anaconda_mcp",
+        "serve",
+        "--delay",
+        "5"
+      ],
+      "env": {
+        "ANACONDA_MCP_PYTHON_EXECUTABLE": "/opt/miniconda3/envs/anaconda-mcp-rc-py312/bin/python",
+        "MCP_COMPOSE_CONFIG_DIR": "/opt/miniconda3/envs/anaconda-mcp-rc-py312/lib/python3.12/site-packages/anaconda_mcp"
+      }
+    }
+  }
+}

.gitignore

@@ -50,6 +50,8 @@ coverage.xml
 .hypothesis/
 .pytest_cache/
 cover/
+# test report
+report.html
 
 # Translations
 *.mo
@@ -182,9 +184,9 @@ cython_debug/
 .abstra/
 
 # Visual Studio Code
-#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
 #  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
-#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  and can be added to the global gitignore or merged into this file. However, if you prefer,
 #  you could uncomment the following to ignore the entire vscode folder
 # .vscode/
 
@@ -207,4 +209,7 @@ marimo/_lsp/
 __marimo__/
 
 **/*.mcpb
-.DS_Store
+.DS_Store
+.cursor/mcp.json
+
+!tests/qa/_ai_docs/**/*.log

environment-dev.yml

@@ -5,7 +5,7 @@ dependencies:
   - anaconda-auth >=0.13.0,<0.15.0
   - environments-mcp-server
   - anaconda-opentelemetry
-  - mcp-compose
+  - mcp-compose>=0.1.11,<2.0.0
   # Dev Deps
   - pytest>=7.0
   - pytest-asyncio>=0.21

environment.yml

@@ -5,4 +5,4 @@ dependencies:
   - anaconda-auth >=0.13.0,<0.15.0
   - environments-mcp-server
   - anaconda-opentelemetry
-  - mcp-compose
+  - mcp-compose>=0.1.11,<2.0.0

src/anaconda_mcp/mcp_compose.toml

@@ -1,9 +1,9 @@
 # MCP Compose Configuration
-# 
+#
 # ⚠️  WARNING: This file is a FALLBACK ONLY!
 # ⚠️  If mcp_compose.toml.template exists, it will be used instead.
 # ⚠️  To customize the configuration, edit mcp_compose.toml.template
-# 
+#
 # This file demonstrates all available configuration options
 
 # ============================================================================
@@ -39,20 +39,13 @@ domain = "anaconda.com"
 # ============================================================================
 
 # ============================================================================
-# Proxied Streamable HTTP MCP Servers
+# Proxied STDIO MCP Servers
 # ============================================================================
-[[servers.proxied.streamable-http]]
+[[servers.proxied.stdio]]
 name = "conda"
-url = "http://localhost:4041/mcp"
-timeout = 30
-keep_alive = true
-reconnect_on_failure = true
-max_reconnect_attempts = 10
-health_check_enabled = false
-mode = "proxy"
-auto_start = true
-command = ["python", "-m", "environments_mcp_server", "start", "--transport", "streamable-http", "--port", "4041"]
-startup_delay = 3
+command = ["python", "-m", "environments_mcp_server", "start", "--transport", "stdio"]
+restart_policy = "on-failure"
+max_restarts = 3
 
 
 # ============================================================================
@@ -83,4 +76,4 @@ cors_origins = ["http://localhost:3000"]
 cors_methods = ["GET", "POST", "PUT", "DELETE"]
 docs_enabled = true
 docs_path = "/docs"
-openapi_path = "/openapi.json"
+openapi_path = "/openapi.json"

src/anaconda_mcp/mcp_compose.toml.template

@@ -1,13 +1,13 @@
 # MCP Compose Configuration Template
-# 
+#
 # ✅ This is the PRIMARY configuration file
-# ✅ Edit this file to customize your configuration  
+# ✅ Edit this file to customize your configuration
 # ✅ Use {{PYTHON_EXECUTABLE}} for dynamic Python path injection
-# 
+#
 # The {{PYTHON_EXECUTABLE}} placeholder will be replaced at runtime with:
 # 1. ANACONDA_MCP_PYTHON_EXECUTABLE environment variable (if set), or
 # 2. sys.executable (the Python interpreter running anaconda-mcp)
-# 
+#
 # This file demonstrates all available configuration options
 
 # ============================================================================
@@ -43,20 +43,13 @@ domain = "anaconda.com"
 # ============================================================================
 
 # ============================================================================
-# Proxied Streamable HTTP MCP Servers
+# Proxied STDIO MCP Servers
 # ============================================================================
-[[servers.proxied.streamable-http]]
+[[servers.proxied.stdio]]
 name = "conda"
-url = "http://localhost:4041/mcp"
-timeout = 30
-keep_alive = true
-reconnect_on_failure = true
-max_reconnect_attempts = 10
-health_check_enabled = false
-mode = "proxy"
-auto_start = true
-command = ["{{PYTHON_EXECUTABLE}}", "-m", "environments_mcp_server", "start", "--transport", "streamable-http", "--port", "4041"]
-startup_delay = 3
+command = ["{{PYTHON_EXECUTABLE}}", "-m", "environments_mcp_server", "start", "--transport", "stdio"]
+restart_policy = "on-failure"
+max_restarts = 3
 
 
 # ============================================================================

tests/qa/_ai_docs/INDEX.md

@@ -0,0 +1,62 @@
+# QA Documentation Index
+
+## Quick Links
+
+| Priority | Document | Purpose |
+|----------|----------|---------|
+| 1 | [QA_WALKTHROUGH.md](./QA_WALKTHROUGH.md) | Step-by-step guide for running E2E tests |
+| 2 | [TEST_PROGRESS.md](./_tracking/TEST_PROGRESS.md) | Current testing status and bug tracking |
+| 3 | [TEST_MATRIX_rc2.md](./_planning/TEST_MATRIX_rc2.md) | RC2 test assignments and configurations |
+
+---
+
+## Structure Overview
+
+```
+_ai_docs/
+├── INDEX.md                    ← You are here
+├── QA_WALKTHROUGH.md           ← Start here for testing
+│
+├── _product/                   # What we're testing
+│   ├── PRODUCT_OVERVIEW.md     # Architecture, features, constraints
+│   ├── FEATURE_TREE.md         # Feature catalog with release scope
+│   └── COVERAGE_MAP.md         # Feature → test mapping
+│
+├── _planning/                  # How we planned testing
+│   ├── TEST_MATRIX_rc2.md      # Current release assignments
+│   ├── TEST_MATRIX.md          # RC1 assignments (historical)
+│   ├── TEST_DESIGN.md          # Test strategy rationale
+│   ├── TEST_COVERAGE_ANALYSIS.md
+│   └── TESTING_WORKFLOW.md
+│
+├── _tracking/                  # Progress and issues
+│   ├── TEST_PROGRESS.md        # Results and bug summary
+│   ├── KNOWN_ISSUES.md         # Bugs, workarounds, investigations
+│   └── OPEN_QUESTIONS.md       # Decisions log
+│
+├── tech_details/               # Technical references
+│   ├── CONFIGURATION.md        # Config options
+│   ├── INSTALL_OPTIONS.md      # Installation methods
+│   ├── LOCAL-DEV-SETUP.md      # Dev environment setup
+│   └── CONDA_SETUP.md          # Miniconda vs Anaconda
+│
+├── tests/
+│   ├── e2e/                    # E2E test definitions
+│   │   ├── setup/              # Prerequisites (auth, Windows, etc.)
+│   │   └── *.md                # Individual test flows
+│   └── automation/             # Automatable tests (CLI, Config, API)
+│
+└── bug_details/                # Investigation artifacts
+```
+
+---
+
+## By Role
+
+**QA Tester**: Start with [QA_WALKTHROUGH.md](./QA_WALKTHROUGH.md)
+
+**New to project**: Read [PRODUCT_OVERVIEW.md](./_product/PRODUCT_OVERVIEW.md) then [TEST_MATRIX_rc2.md](./_planning/TEST_MATRIX_rc2.md)
+
+**Checking status**: See [TEST_PROGRESS.md](./_tracking/TEST_PROGRESS.md)
+
+**Hit a bug**: Check [KNOWN_ISSUES.md](./_tracking/KNOWN_ISSUES.md)

tests/qa/_ai_docs/QA_WALKTHROUGH.md

@@ -0,0 +1,95 @@
+# QA Testing Guide
+
+## Quick Navigation
+
+```mermaid
+flowchart TD
+    Start["I need to test"] --> Platform{Platform?}
+
+    Platform -->|macOS| QS[QUICK_START.md]
+    Platform -->|Windows| Win[WINDOWS_SETUP.md]
+
+    QS --> Auth{Need auth?}
+    Win --> WinQS[QUICK_START.md]
+    WinQS --> Auth
+
+    Auth -->|Yes| AuthSetup[AUTH_SETUP.md]
+    Auth -->|No| Tests
+
+    AuthSetup --> Tests[Test Catalog]
+```
+
+## 1. Setup
+
+| Platform | Guide |
+|----------|-------|
+| macOS | [QUICK_START.md](./tests/e2e/setup/QUICK_START.md) |
+| Windows | [WINDOWS_SETUP.md](./tests/e2e/setup/WINDOWS_SETUP.md) → [QUICK_START.md](./tests/e2e/setup/QUICK_START.md) |
+| Windows + Claude Desktop | [WINDOWS_CLAUDE_DESKTOP.md](./tests/e2e/setup/WINDOWS_CLAUDE_DESKTOP.md) |
+
+## 2. Prerequisites (if test requires auth)
+
+| State | Guide | Used by |
+|-------|-------|---------|
+| Backup .condarc | [AUTH_SETUP.md#backup](./tests/e2e/setup/AUTH_SETUP.md#before-you-begin--backup-recommended) | All auth tests |
+| Logged In | [AUTH_SETUP.md#logged-in](./tests/e2e/setup/AUTH_SETUP.md#prerequisites-logged-in-core-001-auth-002) | CORE-001, AUTH-002 |
+| Logged Out + Public | [AUTH_SETUP.md#logged-out-public](./tests/e2e/setup/AUTH_SETUP.md#prerequisites-logged-out--public-channels-core-001a) | CORE-001a |
+| Logged Out + Private | [AUTH_SETUP.md#logged-out-private](./tests/e2e/setup/AUTH_SETUP.md#prerequisites-logged-out--private-channels-auth-001a) | AUTH-001a |
+| Cleanup (Interactive) | [AUTH_SETUP.md#cleanup](./tests/e2e/setup/AUTH_SETUP.md#cleanup-interactive-login) | After CORE-001, AUTH-002, AUTH-001a |
+
+## 3. Test Catalog
+
+| Test | Description | RC1 | RC2 |
+|------|-------------|:---:|:---:|
+| [SETUP-001](./tests/e2e/SETUP-001.md) | Installation disclaimer verification | | + |
+| [CORE-001](./tests/e2e/CORE-001.md) | Full tools flow — logged in | + | + |
+| [CORE-001a](./tests/e2e/CORE-001a.md) | Full tools flow — logged out (public channels) | + | + |
+| [AUTH-001](./tests/e2e/AUTH-001.md) | Anonymous mode (public channels) | + | + |
+| [AUTH-001a](./tests/e2e/AUTH-001a.md) | Anonymous + private channels → 403 | | + |
+| [AUTH-002](./tests/e2e/AUTH-002.md) | Authenticated mode | + | + |
+| [GUARD-001](./tests/e2e/GUARD-001.md) | Guardrails (no pip fallback, deletion confirm) | + | + |
+| [CHAN-001](./tests/e2e/CHAN-001.md) | Override channels behavior | | + |
+| [REGRESS-001](./tests/e2e/REGRESS-001.md) | Known issues regression (KI-001, KI-002, KI-003) | + | + |
+| [REGRESS-002](./tests/e2e/REGRESS-002.md) | Remove environment by name (DESK-1342) | + | + |
+
+**Legend**: `+` = in scope for release
+
+## 4. Tracking & Reference
+
+| Document | Purpose |
+|----------|---------|
+| [TEST_PROGRESS.md](./_tracking/TEST_PROGRESS.md) | Testing overview — all stages, matrices, progress, active bugs |
+| [KNOWN_ISSUES.md](./_tracking/KNOWN_ISSUES.md) | Bugs and workarounds |
+
+## 5. Workflow
+
+1. **Setup**: Follow platform guide to install and configure
+2. **Backup**: Run backup command from AUTH_SETUP.md (once, before any auth tests)
+3. **Prerequisites**: Set auth state per test requirements
+4. **Execute**: Run test steps, record results
+5. **Cleanup**: Restore original state after auth tests
+6. **Report**: Update TEST_PROGRESS.md with results
+
+---
+
+## Additional Documentation
+
+### Product Documentation
+| Document | Description |
+|----------|-------------|
+| [PRODUCT_OVERVIEW.md](./_product/PRODUCT_OVERVIEW.md) | Product features, architecture, constraints |
+| [FEATURE_TREE.md](./_product/FEATURE_TREE.md) | 3-level feature tree with diagrams |
+| [CONFIGURATION.md](./tech_details/CONFIGURATION.md) | Configuration options reference |
+
+### Automation Test Docs
+| Document | Description |
+|----------|-------------|
+| [TESTS_CLI.md](./tests/automation/TESTS_CLI.md) | CLI-only flows (automatable) |
+| [TESTS_CONFIG.md](./tests/automation/TESTS_CONFIG.md) | Configuration tests (automatable) |
+| [TESTS_API_TOOLS.md](./tests/automation/TESTS_API_TOOLS.md) | Direct API tool tests (automatable) |
+
+### Test Projects (automation)
+| Folder | Purpose |
+|--------|---------|
+| [`tests/qa/http_tools/`](../http_tools/README.md) | HTTP API regression suite |
+| [`tests/qa/stdio_tools/`](../stdio_tools/README.md) | STDIO regression suite |