devsquad 3.6.7__tar.gz → 3.9.2__tar.gz

{devsquad-3.6.7 → devsquad-3.9.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devsquad
-Version: 3.6.7
+Version: 3.9.2
 Summary: Production-Ready Multi-Role AI Task Orchestrator
 Author-email: DevSquad Team <devsquad@example.com>
 License: MIT
@@ -83,14 +83,14 @@ Dynamic: license-file
 <p align="center">
   <strong>🎯 把「单个 AI 助手」升级成「7 人 AI 专业团队」</strong>
   <br>
-  <em>One task → Multi-role AI collaboration → One conclusion | V3.6.6 Enterprise Ready</em>
+  <em>One task → Multi-role AI collaboration → One conclusion | V3.9.2 Enterprise Ready</em>
 </p>
 
 <p align="center">
-  <img alt="Python" src="https://img.shields.io/badge/Python-3.9+-blue?logo=python&logoColor=white" />
+  <img alt="Python" src="https://img.shields.io/badge/Python-3.10+-blue?logo=python&logoColor=white" />
   <img alt="License" src="https://img.shields.io/badge/License-MIT-green" />
-  <img alt="Tests" src="https://img.shields.io/badge/Tests-1855%20passing-brightgreen" />
-  <img alt="Version" src="https://img.shields.io/badge/V3.6.7-success" />
+  <img alt="Tests" src="https://img.shields.io/badge/Tests-2857%2B%20passing-brightgreen" />
+  <img alt="Version" src="https://img.shields.io/badge/V3.9.2-success" />
   <img alt="CI" src="https://img.shields.io/badge/CI-GitHub_Actions-blue?logo=githubactions" />
   <img alt="Quality" src="https://img.shields.io/badge/Code%20Quality-4.3%2F5%20%E2%98%85%E2%98%85%E2%98%85%E2%98%85%E2%98%86-blue" />
   <img alt="Security" src="https://img.shields.io/badge/Security-5%2F5%20%E2%98%85%E2%98%85%E2%98%85%E2%98%85%E2%98%85-success" />
@@ -144,22 +144,22 @@ devsquad run "设计一个安全的用户认证系统" --roles architect,securit
 | 复杂系统设计（需要多视角） | **DevSquad 多角色协作** 🎯 |
 | 生产环境自动化流程 | **DevSquad + REST API + Dashboard** 🎯 |
 
-📚 **想深入了解？** → [完整快速入门指南](QUICKSTART.md) | [70+ 模块详细参考](SKILL.md)
+📚 **想深入了解？** → [完整快速入门指南](QUICKSTART.md) | [149+ 模块详细参考](SKILL.md)
 
 ---
 
 <details>
 <summary>🔍 点击展开：完整功能介绍与架构详解</summary>
 
-## 🚀 V3.6.7: Redis Cache + Async Dispatch + Dispatcher Refactor
+## 🚀 V3.9.2: Auto LLM Fallback + Dashboard Split + SQLite Audit Persistence + P3 Cleanup
 
-**DevSquad V3.6.7** adds Redis Cache L2 backend for three-tier caching (memory→disk→Redis), async dispatch with `asyncio.gather` for concurrent LLM calls, dispatcher refactored from 788-line monolith into 18 step methods (extracted `dispatch_models.py` and `dispatch_performance.py`), fixed `DispatchResult.to_dict()`/`to_markdown()` missing 5 fields (data loss bug), cleaned up `except:pass` patterns, removed redundant `to_dict()` wrappers, and restored 183 previously xfailed tests — bringing total to 1855 tests passing with CI re-enabled.
+**DevSquad V3.9.2** introduces automatic LLM backend fallback (auto backend tries real LLM first, falls back to mock), splits dashboard.py from 1087 lines into an 8-module package, makes SQLite-backed dispatch audit persistence default, and performs P3 cleanup (magic number extraction + narrowed exception scopes), with 2857+ tests passing.
 
 ---
 
-## ⚡ Quick Start (4 Ways to Use DevSquad)
+## ⚡ Quick Start (5 Ways to Use DevSquad)
 
-### 方式 1：命令行（推荐新手）
+### Method 1: CLI (Recommended for Beginners)
 
 ```bash
 # Interactive setup wizard (1-2 minutes)
@@ -169,7 +169,7 @@ python scripts/cli.py init
 devsquad dispatch -t "your task description"
 ```
 
-### 方式 2：Web Dashboard（推荐团队）
+### Method 2: Web Dashboard (Recommended for Teams)
 
 ```bash
 # Start Streamlit dashboard with authentication
@@ -177,10 +177,10 @@ streamlit run scripts/dashboard.py
 
 # Open http://localhost:8501
 # Login with default account, then change password immediately.
-# Username: admin   Password: <your-secure-password>
+# Username: admin   Password: admin123   (change in production)
 ```
 
-### 方式 3：REST API（推荐集成）
+### Method 3: REST API (Recommended for Integration)
 
 ```bash
 # Install dependencies
@@ -193,7 +193,7 @@ uvicorn scripts.api_server:app --host 0.0.0.0 --port 8000 --reload
 # Access ReDoc:      http://localhost:8000/redoc
 ```
 
-### 方式 4：Python API（推荐开发者）
+### Method 4: Python API (Recommended for Developers)
 
 ```python
 from scripts.collaboration.dispatcher import MultiAgentDispatcher
@@ -207,6 +207,24 @@ print(result.report)
 print(result.consensus)
 ```
 
+### Method 5: One-Click Startup Script (V3.9.2+)
+
+```bash
+# One-click startup — 4 phases: env check → DB init → frontend build → service start
+./scripts/start.sh
+
+# Launch Streamlit dashboard instead of API server
+./scripts/start.sh --dashboard
+
+# Override API port
+DEVSQUAD_API_PORT=9000 ./scripts/start.sh
+
+# Show help
+./scripts/start.sh --help
+```
+
+`start.sh` is the unified entry point introduced in V3.9.2 (P0-2). It validates the environment, initializes the database, builds the frontend, and starts the service in one command. Use `requirements.lock` alongside it for reproducible builds (`pip install -r requirements.lock`).
+
 ---
 
 ## 👥 7 Core Roles
@@ -227,7 +245,7 @@ print(result.consensus)
 
 ## 🏗️ Five Capability Domains (Architecture Overview)
 
-DevSquad's 70+ modules are organized into **5 capability domains**, each solving a specific problem:
+DevSquad's 149+ modules are organized into **5 capability domains**, each solving a specific problem:
 
 ### 🎯 Domain 1: Task Orchestration Engine (Core)
 
@@ -280,10 +298,11 @@ User Task → [InputValidator] → [RoleMatcher] → [Coordinator Orchestration]
 |--------|---------|------------|
 | **PerformanceMonitor** | P95/P99 response time, CPU/memory tracking, bottleneck detection | Performance tuning |
 | **UsageTracker** | Token/cost usage tracking and reporting | Cost control |
-| **AuditLogger** | SHA256 integrity operation logs with CSV/JSON export | Compliance auditing |
-| **RBAC Engine** | 15+ fine-grained permissions, 5 roles (SUPER_ADMIN/ADMIN/OPERATOR/ANALYST/VIEWER) | Enterprise access control |
+| **AuditLogger** | SHA256 integrity operation logs with CSV/JSON export (Preview) | Compliance auditing |
+| **RBAC Engine** | 15+ fine-grained permissions, 5 roles (SUPER_ADMIN/ADMIN/OPERATOR/ANALYST/VIEWER) (Preview) | Enterprise access control |
+| **Multi-Tenancy Manager** | 3 isolation levels (strict/moderate/shared), tenant-scoped resources (Preview) | Multi-tenant SaaS |
+| **Sensitive Data Masker** | PII detection and masking (email/phone/ID card/credit card), configurable rules (Preview) | Data compliance |
 | **HistoryManager** | SQLite time-series storage: metrics snapshots, alert history, API logs | Retrospective analysis |
-| **AlertManager** | Multi-channel alerting: Console/Slack/Email/Webhook with rate limiting | Production monitoring |
 
 ### 🔌 Domain 5: Integration & Extension
 
@@ -296,7 +315,7 @@ User Task → [InputValidator] → [RoleMatcher] → [Coordinator Orchestration]
 | **Dashboard (Streamlit)** | Interactive web dashboard with authentication | Operations team visualization |
 | **MCP Protocol** | Integration with TRAE/Claude Code/Cursor | AI Agent ecosystem |
 | **Docker Support** | Multi-stage build for production deployment | Containerized environments |
-| **GitHub Actions CI** | Python 3.9-3.12 matrix testing | CI/CD pipelines |
+| **GitHub Actions CI** | Python 3.10-3.11 matrix testing | CI/CD pipelines |
 
 ---
 
@@ -393,10 +412,10 @@ All modules are **optional switches** — DevSquad works perfectly without them.
           ▼               ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                   Business Logic Layer                      │
-│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐           │
-│  │AuthManager  │ │AlertManager │ │HistoryMgr   │           │
-│  │(RBAC Auth)  │ │(Multi-Chnl) │ │(SQLite TSDB)│           │
-│  └─────────────┘ └─────────────┘ └─────────────┘           │
+│  ┌─────────────┐ ┌─────────────┐           │
+│  │AuthManager  │ │HistoryMgr   │           │
+│  │(RBAC Auth)  │ │(SQLite TSDB)│           │
+│  └─────────────┘ └─────────────┘           │
 │  ┌─────────────────────────────────────────────┐            │
 │  │     LifecycleProtocol (11-Phase Engine)       │            │
 │  │     UnifiedGateEngine + CheckpointManager     │            │
@@ -489,7 +508,7 @@ CLI View Layer (6 commands)          Core Engine (11 phases)
 ## 📦 Installation
 
 ### Prerequisites
-- **Python 3.9+** (3.9, 3.10, 3.11, 3.12 supported)
+- **Python 3.10+** (3.10, 3.11 supported, tested in CI)
 - **pip** or **pipenv** for package management
 
 ### Option A: PyPI Install (Recommended)
@@ -504,7 +523,7 @@ pip install "devsquad[all]"    # All optional features
 
 ### Option B: Git Clone + Local Install
 ```bash
-git clone https://github.com/weiransoft/devsquad.git
+git clone https://github.com/lulin70/DevSquad.git
 cd DevSquad
 
 # Install core package (minimal dependencies)
@@ -518,11 +537,11 @@ devsquad dispatch -t "Design user authentication system"
 ```bash
 # Check version
 devsquad --version
-# Expected: devsquad 3.6.6
+# Expected: devsquad 3.9.2
 
 # Run tests
 pytest tests/ -v --tb=short
-# Expected: 1500+ passed
+# Expected: 2857+ passed
 ```
 
 ---
@@ -538,7 +557,7 @@ quality_control:
   min_quality_score: 85
 
 llm:
-  backend: openai
+  backend: auto
   base_url: ""  # Set via DEVSQUAD_OPENAI_BASE_URL env var
   model: ""     # Set via DEVSQUAD_OPENAI_MODEL env var
   timeout: 120
@@ -547,7 +566,8 @@ llm:
 Or use environment variables (higher priority):
 
 ```bash
-export DEVSQUAD_LLM_BACKEND=openai
+# Default: auto tries real backends first, then falls back to mock
+export DEVSQUAD_LLM_BACKEND=auto
 export DEVSQUAD_OPENAI_BASE_URL=https://api.openai.com/v1
 export DEVSQUAD_OPENAI_MODEL=gpt-4
 export DEVSQUAD_OPENAI_API_KEY=sk-...
@@ -557,7 +577,7 @@ export DEVSQUAD_OPENAI_API_KEY=sk-...
 
 | Variable | Purpose | Default |
 |----------|---------|---------|
-| `DEVSQUAD_LLM_BACKEND` | Default backend type (mock\|trae\|openai\|anthropic\|fallback) | `mock` |
+| `DEVSQUAD_LLM_BACKEND` | Default backend type (auto\|mock\|trae\|openai\|anthropic\|fallback) | `auto` |
 | `DEVSQUAD_OPENAI_API_KEY` | OpenAI/MOKA AI API key | None |
 | `DEVSQUAD_OPENAI_BASE_URL` | OpenAI-compatible base URL | None |
 | `DEVSQUAD_OPENAI_MODEL` | OpenAI model name | `gpt-4` |
@@ -572,14 +592,14 @@ export DEVSQUAD_OPENAI_API_KEY=sk-...
 
 ### Quick Smoke Test (< 30 seconds)
 ```bash
-python3 scripts/cli.py --version       # Expected: DevSquad 3.6.6
+python3 scripts/cli.py --version       # Expected: DevSquad 3.9.2
 python3 scripts/cli.py status          # Expected: System ready
 python3 scripts/cli.py roles           # Expected: 7 core roles listed
 ```
 
 ### Full Test Suite
 ```bash
-# Run all tests (1855 tests passing)
+# Run all tests (2857+ tests passing)
 python3 -m pytest tests/ -q --tb=line
 
 # With coverage report
@@ -596,7 +616,7 @@ python3 -m pytest tests/ --cov=scripts --cov-report=term-missing
 | **P2** | Integration & E2E | Full lifecycle dispatch, cross-module integration | ~200 |
 | **P3** | Unit per Module | Core dispatcher, RoleMapping, MCEAdapter, LLM backends | ~400+ |
 
-**Total: 1855 tests**
+**Total: 2857+ tests (2864 collected)**
 
 Run by priority:
 ```bash
@@ -617,13 +637,13 @@ python3 -m pytest tests/ -q --tb=line
 | Document | Description | Language |
 |----------|-------------|----------|
 | [**QUICKSTART.md**](QUICKSTART.md) | **⭐ 30 秒快速入门指南（推荐新用户）** | 中文 |
-| [SKILL.md](SKILL.md) | 完整技能手册 + 70+ 模块参考 | EN/CN/JP |
+| [SKILL.md](SKILL.md) | 完整技能手册 + 149+ 模块参考 | EN/CN/JP |
 | [GUIDE.md](GUIDE.md) | 完全用户指南 | 中文 |
 | [INSTALL.md](INSTALL.md) | 安装指南 (Unix + Windows) | EN/CN |
 | [EXAMPLES.md](EXAMPLES.md) | 实际使用示例 | EN |
 | [CHANGELOG.md](CHANGELOG.md) | 版本历史记录 | EN |
-| [docs/i18n/README_CN.md](docs/i18n/README_CN.md) | 中文说明 | 中文 |
-| [docs/i18n/README_JP.md](docs/i18n/README_JP.md) | 日本語説明 | 日本語 |
+| [README-CN.md](README-CN.md) | 中文说明 | 中文 |
+| [README-JP.md](README-JP.md) | 日本語説明 | 日本語 |
 | [docs/PRD.md](docs/PRD.md) | 产品需求文档 | 中文 |
 | [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | 技术架构文档 | 中文 |
 
@@ -660,6 +680,6 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ---
 
-*Last updated: 2026-06-07 | Version: V3.6.7*
+*Last updated: 2026-06-26 | Version: V3.9.2*
 
 </details>

{devsquad-3.6.7 → devsquad-3.9.2}/README.md

@@ -3,14 +3,14 @@
 <p align="center">
   <strong>🎯 把「单个 AI 助手」升级成「7 人 AI 专业团队」</strong>
   <br>
-  <em>One task → Multi-role AI collaboration → One conclusion | V3.6.6 Enterprise Ready</em>
+  <em>One task → Multi-role AI collaboration → One conclusion | V3.9.2 Enterprise Ready</em>
 </p>
 
 <p align="center">
-  <img alt="Python" src="https://img.shields.io/badge/Python-3.9+-blue?logo=python&logoColor=white" />
+  <img alt="Python" src="https://img.shields.io/badge/Python-3.10+-blue?logo=python&logoColor=white" />
   <img alt="License" src="https://img.shields.io/badge/License-MIT-green" />
-  <img alt="Tests" src="https://img.shields.io/badge/Tests-1855%20passing-brightgreen" />
-  <img alt="Version" src="https://img.shields.io/badge/V3.6.7-success" />
+  <img alt="Tests" src="https://img.shields.io/badge/Tests-2857%2B%20passing-brightgreen" />
+  <img alt="Version" src="https://img.shields.io/badge/V3.9.2-success" />
   <img alt="CI" src="https://img.shields.io/badge/CI-GitHub_Actions-blue?logo=githubactions" />
   <img alt="Quality" src="https://img.shields.io/badge/Code%20Quality-4.3%2F5%20%E2%98%85%E2%98%85%E2%98%85%E2%98%85%E2%98%86-blue" />
   <img alt="Security" src="https://img.shields.io/badge/Security-5%2F5%20%E2%98%85%E2%98%85%E2%98%85%E2%98%85%E2%98%85-success" />
@@ -64,22 +64,22 @@ devsquad run "设计一个安全的用户认证系统" --roles architect,securit
 | 复杂系统设计（需要多视角） | **DevSquad 多角色协作** 🎯 |
 | 生产环境自动化流程 | **DevSquad + REST API + Dashboard** 🎯 |
 
-📚 **想深入了解？** → [完整快速入门指南](QUICKSTART.md) | [70+ 模块详细参考](SKILL.md)
+📚 **想深入了解？** → [完整快速入门指南](QUICKSTART.md) | [149+ 模块详细参考](SKILL.md)
 
 ---
 
 <details>
 <summary>🔍 点击展开：完整功能介绍与架构详解</summary>
 
-## 🚀 V3.6.7: Redis Cache + Async Dispatch + Dispatcher Refactor
+## 🚀 V3.9.2: Auto LLM Fallback + Dashboard Split + SQLite Audit Persistence + P3 Cleanup
 
-**DevSquad V3.6.7** adds Redis Cache L2 backend for three-tier caching (memory→disk→Redis), async dispatch with `asyncio.gather` for concurrent LLM calls, dispatcher refactored from 788-line monolith into 18 step methods (extracted `dispatch_models.py` and `dispatch_performance.py`), fixed `DispatchResult.to_dict()`/`to_markdown()` missing 5 fields (data loss bug), cleaned up `except:pass` patterns, removed redundant `to_dict()` wrappers, and restored 183 previously xfailed tests — bringing total to 1855 tests passing with CI re-enabled.
+**DevSquad V3.9.2** introduces automatic LLM backend fallback (auto backend tries real LLM first, falls back to mock), splits dashboard.py from 1087 lines into an 8-module package, makes SQLite-backed dispatch audit persistence default, and performs P3 cleanup (magic number extraction + narrowed exception scopes), with 2857+ tests passing.
 
 ---
 
-## ⚡ Quick Start (4 Ways to Use DevSquad)
+## ⚡ Quick Start (5 Ways to Use DevSquad)
 
-### 方式 1：命令行（推荐新手）
+### Method 1: CLI (Recommended for Beginners)
 
 ```bash
 # Interactive setup wizard (1-2 minutes)
@@ -89,7 +89,7 @@ python scripts/cli.py init
 devsquad dispatch -t "your task description"
 ```
 
-### 方式 2：Web Dashboard（推荐团队）
+### Method 2: Web Dashboard (Recommended for Teams)
 
 ```bash
 # Start Streamlit dashboard with authentication
@@ -97,10 +97,10 @@ streamlit run scripts/dashboard.py
 
 # Open http://localhost:8501
 # Login with default account, then change password immediately.
-# Username: admin   Password: <your-secure-password>
+# Username: admin   Password: admin123   (change in production)
 ```
 
-### 方式 3：REST API（推荐集成）
+### Method 3: REST API (Recommended for Integration)
 
 ```bash
 # Install dependencies
@@ -113,7 +113,7 @@ uvicorn scripts.api_server:app --host 0.0.0.0 --port 8000 --reload
 # Access ReDoc:      http://localhost:8000/redoc
 ```
 
-### 方式 4：Python API（推荐开发者）
+### Method 4: Python API (Recommended for Developers)
 
 ```python
 from scripts.collaboration.dispatcher import MultiAgentDispatcher
@@ -127,6 +127,24 @@ print(result.report)
 print(result.consensus)
 ```
 
+### Method 5: One-Click Startup Script (V3.9.2+)
+
+```bash
+# One-click startup — 4 phases: env check → DB init → frontend build → service start
+./scripts/start.sh
+
+# Launch Streamlit dashboard instead of API server
+./scripts/start.sh --dashboard
+
+# Override API port
+DEVSQUAD_API_PORT=9000 ./scripts/start.sh
+
+# Show help
+./scripts/start.sh --help
+```
+
+`start.sh` is the unified entry point introduced in V3.9.2 (P0-2). It validates the environment, initializes the database, builds the frontend, and starts the service in one command. Use `requirements.lock` alongside it for reproducible builds (`pip install -r requirements.lock`).
+
 ---
 
 ## 👥 7 Core Roles
@@ -147,7 +165,7 @@ print(result.consensus)
 
 ## 🏗️ Five Capability Domains (Architecture Overview)
 
-DevSquad's 70+ modules are organized into **5 capability domains**, each solving a specific problem:
+DevSquad's 149+ modules are organized into **5 capability domains**, each solving a specific problem:
 
 ### 🎯 Domain 1: Task Orchestration Engine (Core)
 
@@ -200,10 +218,11 @@ User Task → [InputValidator] → [RoleMatcher] → [Coordinator Orchestration]
 |--------|---------|------------|
 | **PerformanceMonitor** | P95/P99 response time, CPU/memory tracking, bottleneck detection | Performance tuning |
 | **UsageTracker** | Token/cost usage tracking and reporting | Cost control |
-| **AuditLogger** | SHA256 integrity operation logs with CSV/JSON export | Compliance auditing |
-| **RBAC Engine** | 15+ fine-grained permissions, 5 roles (SUPER_ADMIN/ADMIN/OPERATOR/ANALYST/VIEWER) | Enterprise access control |
+| **AuditLogger** | SHA256 integrity operation logs with CSV/JSON export (Preview) | Compliance auditing |
+| **RBAC Engine** | 15+ fine-grained permissions, 5 roles (SUPER_ADMIN/ADMIN/OPERATOR/ANALYST/VIEWER) (Preview) | Enterprise access control |
+| **Multi-Tenancy Manager** | 3 isolation levels (strict/moderate/shared), tenant-scoped resources (Preview) | Multi-tenant SaaS |
+| **Sensitive Data Masker** | PII detection and masking (email/phone/ID card/credit card), configurable rules (Preview) | Data compliance |
 | **HistoryManager** | SQLite time-series storage: metrics snapshots, alert history, API logs | Retrospective analysis |
-| **AlertManager** | Multi-channel alerting: Console/Slack/Email/Webhook with rate limiting | Production monitoring |
 
 ### 🔌 Domain 5: Integration & Extension
 
@@ -216,7 +235,7 @@ User Task → [InputValidator] → [RoleMatcher] → [Coordinator Orchestration]
 | **Dashboard (Streamlit)** | Interactive web dashboard with authentication | Operations team visualization |
 | **MCP Protocol** | Integration with TRAE/Claude Code/Cursor | AI Agent ecosystem |
 | **Docker Support** | Multi-stage build for production deployment | Containerized environments |
-| **GitHub Actions CI** | Python 3.9-3.12 matrix testing | CI/CD pipelines |
+| **GitHub Actions CI** | Python 3.10-3.11 matrix testing | CI/CD pipelines |
 
 ---
 
@@ -313,10 +332,10 @@ All modules are **optional switches** — DevSquad works perfectly without them.
           ▼               ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                   Business Logic Layer                      │
-│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐           │
-│  │AuthManager  │ │AlertManager │ │HistoryMgr   │           │
-│  │(RBAC Auth)  │ │(Multi-Chnl) │ │(SQLite TSDB)│           │
-│  └─────────────┘ └─────────────┘ └─────────────┘           │
+│  ┌─────────────┐ ┌─────────────┐           │
+│  │AuthManager  │ │HistoryMgr   │           │
+│  │(RBAC Auth)  │ │(SQLite TSDB)│           │
+│  └─────────────┘ └─────────────┘           │
 │  ┌─────────────────────────────────────────────┐            │
 │  │     LifecycleProtocol (11-Phase Engine)       │            │
 │  │     UnifiedGateEngine + CheckpointManager     │            │
@@ -409,7 +428,7 @@ CLI View Layer (6 commands)          Core Engine (11 phases)
 ## 📦 Installation
 
 ### Prerequisites
-- **Python 3.9+** (3.9, 3.10, 3.11, 3.12 supported)
+- **Python 3.10+** (3.10, 3.11 supported, tested in CI)
 - **pip** or **pipenv** for package management
 
 ### Option A: PyPI Install (Recommended)
@@ -424,7 +443,7 @@ pip install "devsquad[all]"    # All optional features
 
 ### Option B: Git Clone + Local Install
 ```bash
-git clone https://github.com/weiransoft/devsquad.git
+git clone https://github.com/lulin70/DevSquad.git
 cd DevSquad
 
 # Install core package (minimal dependencies)
@@ -438,11 +457,11 @@ devsquad dispatch -t "Design user authentication system"
 ```bash
 # Check version
 devsquad --version
-# Expected: devsquad 3.6.6
+# Expected: devsquad 3.9.2
 
 # Run tests
 pytest tests/ -v --tb=short
-# Expected: 1500+ passed
+# Expected: 2857+ passed
 ```
 
 ---
@@ -458,7 +477,7 @@ quality_control:
   min_quality_score: 85
 
 llm:
-  backend: openai
+  backend: auto
   base_url: ""  # Set via DEVSQUAD_OPENAI_BASE_URL env var
   model: ""     # Set via DEVSQUAD_OPENAI_MODEL env var
   timeout: 120
@@ -467,7 +486,8 @@ llm:
 Or use environment variables (higher priority):
 
 ```bash
-export DEVSQUAD_LLM_BACKEND=openai
+# Default: auto tries real backends first, then falls back to mock
+export DEVSQUAD_LLM_BACKEND=auto
 export DEVSQUAD_OPENAI_BASE_URL=https://api.openai.com/v1
 export DEVSQUAD_OPENAI_MODEL=gpt-4
 export DEVSQUAD_OPENAI_API_KEY=sk-...
@@ -477,7 +497,7 @@ export DEVSQUAD_OPENAI_API_KEY=sk-...
 
 | Variable | Purpose | Default |
 |----------|---------|---------|
-| `DEVSQUAD_LLM_BACKEND` | Default backend type (mock\|trae\|openai\|anthropic\|fallback) | `mock` |
+| `DEVSQUAD_LLM_BACKEND` | Default backend type (auto\|mock\|trae\|openai\|anthropic\|fallback) | `auto` |
 | `DEVSQUAD_OPENAI_API_KEY` | OpenAI/MOKA AI API key | None |
 | `DEVSQUAD_OPENAI_BASE_URL` | OpenAI-compatible base URL | None |
 | `DEVSQUAD_OPENAI_MODEL` | OpenAI model name | `gpt-4` |
@@ -492,14 +512,14 @@ export DEVSQUAD_OPENAI_API_KEY=sk-...
 
 ### Quick Smoke Test (< 30 seconds)
 ```bash
-python3 scripts/cli.py --version       # Expected: DevSquad 3.6.6
+python3 scripts/cli.py --version       # Expected: DevSquad 3.9.2
 python3 scripts/cli.py status          # Expected: System ready
 python3 scripts/cli.py roles           # Expected: 7 core roles listed
 ```
 
 ### Full Test Suite
 ```bash
-# Run all tests (1855 tests passing)
+# Run all tests (2857+ tests passing)
 python3 -m pytest tests/ -q --tb=line
 
 # With coverage report
@@ -516,7 +536,7 @@ python3 -m pytest tests/ --cov=scripts --cov-report=term-missing
 | **P2** | Integration & E2E | Full lifecycle dispatch, cross-module integration | ~200 |
 | **P3** | Unit per Module | Core dispatcher, RoleMapping, MCEAdapter, LLM backends | ~400+ |
 
-**Total: 1855 tests**
+**Total: 2857+ tests (2864 collected)**
 
 Run by priority:
 ```bash
@@ -537,13 +557,13 @@ python3 -m pytest tests/ -q --tb=line
 | Document | Description | Language |
 |----------|-------------|----------|
 | [**QUICKSTART.md**](QUICKSTART.md) | **⭐ 30 秒快速入门指南（推荐新用户）** | 中文 |
-| [SKILL.md](SKILL.md) | 完整技能手册 + 70+ 模块参考 | EN/CN/JP |
+| [SKILL.md](SKILL.md) | 完整技能手册 + 149+ 模块参考 | EN/CN/JP |
 | [GUIDE.md](GUIDE.md) | 完全用户指南 | 中文 |
 | [INSTALL.md](INSTALL.md) | 安装指南 (Unix + Windows) | EN/CN |
 | [EXAMPLES.md](EXAMPLES.md) | 实际使用示例 | EN |
 | [CHANGELOG.md](CHANGELOG.md) | 版本历史记录 | EN |
-| [docs/i18n/README_CN.md](docs/i18n/README_CN.md) | 中文说明 | 中文 |
-| [docs/i18n/README_JP.md](docs/i18n/README_JP.md) | 日本語説明 | 日本語 |
+| [README-CN.md](README-CN.md) | 中文说明 | 中文 |
+| [README-JP.md](README-JP.md) | 日本語説明 | 日本語 |
 | [docs/PRD.md](docs/PRD.md) | 产品需求文档 | 中文 |
 | [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | 技术架构文档 | 中文 |
 
@@ -580,6 +600,6 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ---
 
-*Last updated: 2026-06-07 | Version: V3.6.7*
+*Last updated: 2026-06-26 | Version: V3.9.2*
 
 </details>