Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
210 commits
Select commit Hold shift + click to select a range
0b856fa
added qa docs for testing purposes
Mar 4, 2026
311d4de
added qa docs for testing purposes
Mar 4, 2026
aeebd60
docs adjustments
Mar 4, 2026
d01b9a0
docs adjustments
Mar 4, 2026
b058aa7
docs adjustments
Mar 4, 2026
e5420d0
docs adjustments
Mar 4, 2026
e5b35ac
docs adjustments
Mar 4, 2026
1354cbb
docs adjustments
Mar 4, 2026
961e4eb
adjusted docs
Mar 4, 2026
e57693a
adjusted docs
Mar 4, 2026
f31b23f
adjusted docs
Mar 4, 2026
bcf69e9
adjusted docs
Mar 4, 2026
40a3225
adjusted docs
Mar 4, 2026
7532914
adjusted docs
Mar 4, 2026
199c62d
adjusted docs
Mar 4, 2026
a35e341
adjusted docs
Mar 4, 2026
b29efc4
adjusted docs
Mar 4, 2026
83c2baf
adjusted docs
Mar 4, 2026
a016928
adjusted docs
Mar 4, 2026
a5c74eb
adjusted docs
Mar 4, 2026
129529c
adjusted docs
Mar 4, 2026
d73cbf0
adjusted docs
Mar 4, 2026
809f663
adjusted docs
Mar 4, 2026
ad3c961
adjusted docs
Mar 4, 2026
5da92a8
adjusted docs
Mar 4, 2026
755e6b9
adjusted docs
Mar 4, 2026
80436f4
adjusted docs
Mar 4, 2026
13ea986
adjusted docs
Mar 4, 2026
201c27b
adjusted docs
Mar 4, 2026
9f6c25c
adjusted docs
Mar 4, 2026
c5b013c
adjusted docs
Mar 5, 2026
0c85271
adjusted docs
Mar 5, 2026
5176512
adjusted docs
Mar 5, 2026
ac3ccbc
adjusted docs
Mar 5, 2026
66b97a7
adjusted docs
Mar 5, 2026
4c08460
adjusted docs
Mar 5, 2026
8c1a077
adjusted docs
Mar 5, 2026
035461f
adjusted
Mar 5, 2026
07bbfae
adjusted
Mar 5, 2026
117d2c1
adjusted test matrix and quick start
Mar 5, 2026
a3c92ea
adjusted test matrix and quick start
Mar 5, 2026
c82b770
adjusted test matrix and quick start
Mar 5, 2026
d750bfa
adjusted test matrix and quick start
Mar 5, 2026
faa6657
adjusted test matrix and quick start
Mar 5, 2026
765b7a3
add initial version or api_tools tests
Mar 5, 2026
d436961
adjusted initial solution
Mar 5, 2026
165b05b
added rules
Mar 5, 2026
5f01e3a
restructured tests
Mar 5, 2026
6ed037a
restructured tests
Mar 5, 2026
3eaa0c9
restructured tests
Mar 5, 2026
584d5d8
restructured tests
Mar 5, 2026
626ca87
adjusted docs
Mar 5, 2026
55224ab
cleanup after troubleshooting
Mar 5, 2026
4632367
added one more TC and e2e
Mar 5, 2026
6e39cbb
adjusted docs
Mar 5, 2026
58e7d7d
adjusted docs
Mar 5, 2026
6125bed
adjusted docs
Mar 5, 2026
b98900d
adjusted docs
Mar 6, 2026
cf77e4a
adjusted docs
Mar 6, 2026
f9854da
adjusted docs
Mar 6, 2026
9d4b406
adjusted docs
Mar 6, 2026
ec51075
adjusted docs
Mar 6, 2026
203548c
adjusted docs
Mar 6, 2026
040a9d2
adjusted docs
Mar 6, 2026
06c9bfc
adjusted docs
Mar 6, 2026
781370d
adjusted docs
Mar 6, 2026
212c867
adjusted docs
Mar 6, 2026
d213555
adjusted docs
Mar 6, 2026
b55cc82
adjusted docs
Mar 6, 2026
f8cb6b4
adjusted docs
Mar 6, 2026
b0e7fb8
hanging illustrations,initial solution
Mar 6, 2026
ec91884
hanging illustrations,cleanup
Mar 6, 2026
84db995
hanging illustrations,cleanup
Mar 6, 2026
b6b205f
reviewed api_tools tests
Mar 6, 2026
ff3d072
reviewed api_tools tests
Mar 6, 2026
d54adc1
reviewed sdtio_tools tests
Mar 6, 2026
4e427b5
reviewed sdtio_tools tests
Mar 6, 2026
202b8a3
reviewed http_tools tests
Mar 6, 2026
e9b3f76
adjusted docs
Mar 6, 2026
067dfc2
adjusted code
Mar 6, 2026
a22d7f3
test matrix adjustments
Mar 6, 2026
bb0dd05
test matrix adjustments
Mar 6, 2026
165a8f8
adjusted docs
Mar 6, 2026
cfe4cd7
adjusted auth nonauth flows
Mar 6, 2026
55a727d
adjusted auth nonauth flows
Mar 7, 2026
05077e5
adjusted auth nonauth flows
Mar 7, 2026
9d0e0dd
adjusted auth nonauth flows
Mar 7, 2026
c51bcc8
adjusted auth nonauth flows
Mar 7, 2026
f954780
adjusted auth nonauth flows
Mar 7, 2026
ee920e2
adjusted docs
Mar 7, 2026
984a777
adjust information about hanging bug
Mar 7, 2026
ab2005a
adjust information about hanging bug
Mar 7, 2026
a4f56b1
adjust information about hanging bug
Mar 7, 2026
1251351
adjusted docs
Mar 7, 2026
d8cfce6
adjusted docs
Mar 7, 2026
bb0d700
adjusted docs
Mar 7, 2026
cb7c909
adjusted docs
Mar 7, 2026
968b7f9
Merge branch 'main' into desk-1328
Mar 9, 2026
cb22096
adjusted quick start for Windows
Mar 9, 2026
4ea4803
simplified quick setup, separated windows, conda vs anaconda topics
Mar 9, 2026
de37aa1
described p003
Mar 9, 2026
4843aaf
added scripts for windows
Mar 9, 2026
ecdf43d
adjust tests for windows
Mar 10, 2026
ee9e18b
mcp-compose fixes to port
Mar 10, 2026
661d320
added logging
Mar 10, 2026
159dff8
adjusted docs
Mar 10, 2026
edb71e4
stored intermediate k011 013 results
Mar 10, 2026
1739faf
added analysis results
Mar 10, 2026
1567a7f
adjusted docs
Mar 10, 2026
4d4b085
adjustments for docs and http tests
Mar 10, 2026
a7297cb
added timeout for hanging tests
Mar 10, 2026
3eb3a0b
adjusted docs
Mar 10, 2026
7b97be3
adjusted docs
Mar 10, 2026
bee59f7
adjusted docs
Mar 10, 2026
4be6e9c
updated test progress
Mar 10, 2026
78dcca8
updated test progress
Mar 11, 2026
fd576bf
updated test matrix
Mar 11, 2026
a8695ea
updated next text matrix
Mar 11, 2026
c1c5f2c
updated next text matrix
Mar 11, 2026
aaf974f
added test design docs
Mar 11, 2026
35b139b
extended known issues list
Mar 11, 2026
42b53f6
added create env tests
Mar 11, 2026
329e5f9
adjusted test and docs
Mar 11, 2026
0ffbc17
adjusted tests
Mar 11, 2026
4baf525
added docs
Mar 11, 2026
5d96fd5
adjusted docs
Mar 11, 2026
2f7c44f
updated docs
Mar 12, 2026
963190e
Merge branch 'main' into desk-1328
Mar 12, 2026
299ede3
updated auth scenarios
Mar 12, 2026
6ecfe1b
updated progress
Mar 13, 2026
8053a4a
adjusted rc2 test matrix and e2e flows
Mar 13, 2026
9035da1
adjusted e2e for rc2
Mar 13, 2026
0503b4a
adjusted rc2 test matrix
Mar 13, 2026
f728af7
adjusted rc2 test matrix
Mar 13, 2026
0ba2e82
adjusted rc2 test matrix
Mar 13, 2026
f76fac5
adjusted rc2 test matrix
Mar 13, 2026
5b9c409
adjusted rc2 test matrix
Mar 13, 2026
74333b9
asjusted docs
Mar 13, 2026
bf90b21
asjusted docs
Mar 13, 2026
c8fb51e
asjusted docs
Mar 13, 2026
51355fa
adjusted docs
Mar 13, 2026
ba29185
adjusted docs
Mar 13, 2026
8d38a4d
restructured tests
Mar 13, 2026
3de9522
restructured tests
Mar 13, 2026
6ba878c
restructured tests
Mar 14, 2026
d730287
restructured tests
Mar 14, 2026
867d85f
restructured tests
Mar 14, 2026
7f4a6d8
restructured tests
Mar 14, 2026
d7b1e80
restructured tests
Mar 14, 2026
06f75d2
restructured tests
Mar 14, 2026
afb8a97
adjusted docs
Mar 14, 2026
596d391
adjisted docs
Mar 14, 2026
de76304
adjisted docs
Mar 14, 2026
968c21e
adjisted docs
Mar 14, 2026
d6c76a8
adjisted docs
Mar 14, 2026
550a58f
adjisted docs
Mar 14, 2026
bc38d40
adjisted docs
Mar 14, 2026
d43750d
adjisted docs
Mar 14, 2026
160b064
adjisted docs
Mar 14, 2026
c27285a
adjisted docs
Mar 14, 2026
4427853
restructured
Mar 14, 2026
5f311f6
restructured
Mar 14, 2026
e187fed
added test for package installing
Mar 16, 2026
fe7f023
added one more test for hanging failures
Mar 17, 2026
9dcbd13
added one more diagnostic script
Mar 17, 2026
6ebda02
added scropts, detalized known issues
Mar 17, 2026
5c0e3c9
adjusted test progress and known issues
Mar 17, 2026
0943634
adjusted quick start
Mar 17, 2026
3193a85
added test matrix for next iteration
Mar 17, 2026
0953ae8
adjusted test progress docs
Mar 17, 2026
94a6ed1
added mcp compose hang description
Mar 17, 2026
9f4cdf5
added hanging examples
Mar 17, 2026
eb31bab
adjusted expectations for core tests
Mar 17, 2026
178d819
added hang bug details
Mar 17, 2026
9151d96
added hang bug details
Mar 17, 2026
516bf28
finalized hang issue reporting
Mar 17, 2026
b44e20f
extended bug information
Mar 17, 2026
0b39d7a
adjusted tests, extended known issues
Mar 17, 2026
be73365
added tc for auth via token
Mar 17, 2026
d20f9f0
added one more flow for authenticated user
Mar 17, 2026
07e4f27
added knwon issue for auth via token
Mar 18, 2026
d6e0066
added knwon issue for auth via token
Mar 18, 2026
5df811c
updated test progress
Mar 18, 2026
9b7c5bc
added logs to docs
Mar 18, 2026
4c855a7
removed CORE-001b
Mar 18, 2026
2df917f
adjusted auth
Mar 18, 2026
c3e2e22
adjusted test auth-001a
Mar 18, 2026
9668527
adjusted test auth-001a
Mar 18, 2026
d905391
added more data to hanfing issue
Mar 18, 2026
39d40ba
added more explanations for auth flows
Mar 18, 2026
0d9b40f
updated progress
Mar 19, 2026
b7bd619
updated progress
Mar 19, 2026
6b40d06
updated quick start
Mar 19, 2026
b9f2a4c
updated quick start
Mar 19, 2026
b2bf2c4
corrections - desk-1408 is resolved
Mar 19, 2026
24b1119
adjusted test progress
Mar 19, 2026
27df103
updated progress
Mar 19, 2026
4385a38
updated progress
Mar 20, 2026
ddf7e75
Merge branch 'main' into desk-1328
Mar 20, 2026
4f5225a
updated test progress
Mar 20, 2026
5dcf4be
updated test progress
Mar 20, 2026
a03225c
added logs for desk1409
Mar 20, 2026
eecf072
added logs for desk1409
Mar 20, 2026
82dd91c
added 1409 investigations
Mar 20, 2026
e5e6916
added issue description
Mar 21, 2026
17bb5ef
switch to strio between anaconda mcp and env mcp
Mar 21, 2026
8cae64a
docs related to 1409
Mar 21, 2026
7a40260
stdio tests related to 1409
Mar 21, 2026
0067e43
adjusted readme
Mar 23, 2026
b0b11fe
adjusted readme
Mar 23, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions .cursor/mcp http.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"mcpServers": {
"anaconda-mcp": {
"url": "http://localhost:8888/mcp",
"transport": "streamable-http"
}
}
}
18 changes: 18 additions & 0 deletions .cursor/mcp stdio.json
Original file line number Diff line number Diff line change
@@ -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"
}
}
}
}
11 changes: 8 additions & 3 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,8 @@ coverage.xml
.hypothesis/
.pytest_cache/
cover/
# test report
report.html

# Translations
*.mo
Expand Down Expand Up @@ -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/

Expand All @@ -207,4 +209,7 @@ marimo/_lsp/
__marimo__/

**/*.mcpb
.DS_Store
.DS_Store
.cursor/mcp.json

!tests/qa/_ai_docs/**/*.log
2 changes: 1 addition & 1 deletion environment-dev.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion environment.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
23 changes: 8 additions & 15 deletions src/anaconda_mcp/mcp_compose.toml
Original file line number Diff line number Diff line change
@@ -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

# ============================================================================
Expand Down Expand Up @@ -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


# ============================================================================
Expand Down Expand Up @@ -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"
25 changes: 9 additions & 16 deletions src/anaconda_mcp/mcp_compose.toml.template
Original file line number Diff line number Diff line change
@@ -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

# ============================================================================
Expand Down Expand Up @@ -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


# ============================================================================
Expand Down
62 changes: 62 additions & 0 deletions tests/qa/_ai_docs/INDEX.md
Original file line number Diff line number Diff line change
@@ -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)
95 changes: 95 additions & 0 deletions tests/qa/_ai_docs/QA_WALKTHROUGH.md
Original file line number Diff line number Diff line change
@@ -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 |
Loading