devsquad 3.6.7__tar.gz → 4.0.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devsquad
-Version: 3.6.7
+Version: 4.0.0
 Summary: Production-Ready Multi-Role AI Task Orchestrator
 Author-email: DevSquad Team <devsquad@example.com>
 License: MIT
@@ -48,6 +48,8 @@ Requires-Dist: streamlit>=1.28.0; extra == "visualization"
 Requires-Dist: jupyter>=1.0; extra == "visualization"
 Provides-Extra: alerts
 Requires-Dist: slack-sdk>=3.21.0; extra == "alerts"
+Provides-Extra: qa
+Requires-Dist: Pillow>=10.0.0; extra == "qa"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
@@ -56,6 +58,7 @@ Requires-Dist: ruff>=0.4.0; extra == "dev"
 Requires-Dist: mypy>=1.0; extra == "dev"
 Requires-Dist: black>=23.0; extra == "dev"
 Requires-Dist: flake8>=6.0; extra == "dev"
+Requires-Dist: httpx2>=2.5.0; extra == "dev"
 Provides-Extra: all
 Requires-Dist: openai>=1.0; extra == "all"
 Requires-Dist: anthropic>=0.18; extra == "all"
@@ -69,6 +72,7 @@ Requires-Dist: pydantic>=2.0; extra == "all"
 Requires-Dist: streamlit>=1.28.0; extra == "all"
 Requires-Dist: jupyter>=1.0; extra == "all"
 Requires-Dist: slack-sdk>=3.21.0; extra == "all"
+Requires-Dist: Pillow>=10.0.0; extra == "all"
 Requires-Dist: pytest>=7.0; extra == "all"
 Requires-Dist: pytest-asyncio>=0.21; extra == "all"
 Requires-Dist: pytest-cov>=4.1; extra == "all"
@@ -76,6 +80,7 @@ Requires-Dist: ruff>=0.4.0; extra == "all"
 Requires-Dist: mypy>=1.0; extra == "all"
 Requires-Dist: black>=23.0; extra == "all"
 Requires-Dist: flake8>=6.0; extra == "all"
+Requires-Dist: httpx2>=2.5.0; extra == "all"
 Dynamic: license-file
 
 # DevSquad — Multi-Role AI Task Orchestrator
@@ -83,14 +88,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 | V4.0.0 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-3400%2B%20passing-brightgreen" />
+  <img alt="Version" src="https://img.shields.io/badge/V4.0.0-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 +149,30 @@ 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
+## 🚀 V4.0.0: Loop Engineering + UI/UX 巡检 + Adversarial 验证 + DAG 可视化 + Autonomous + 插件热加载
 
-**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 V4.0.0** 借鉴上游 TraeMultiAgentSkill v2.7 理念，新增 6 个特性（P1-P3），全面接入 dispatch pipeline，无幽灵功能：
+- **P1-1 Loop Engineering**: Discovery → Handoff → Verification → Persistence → Scheduling 五步闭环
+- **P1-2 UI/UX 巡检**: 4 维度审计（a11y/interaction/layout/ux）+ PIL 像素 diff 视觉回归
+- **P2-1 Adversarial 验证**: 红队攻击 + 蓝队防御 + 裁判仲裁三阶段对抗验证
+- **P2-2 DAG 可视化**: Mermaid / JSON / DOT 三种格式依赖图可视化
+- **P3-1 Autonomous**: plan → dev → verify → fix 4 阶段自主迭代，复用 LoopKernel，不绕过共识门
+- **P3-2 插件热加载**: 三种加载路径 + 路径穿越三层防护 + reload 回滚 + 审计日志
+
+3400+ 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 +182,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 +190,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 +206,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 +220,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`). V4.0.0 adds Loop Engineering, UI/UX 巡检, Adversarial 验证, DAG 可视化, Autonomous, and 插件热加载.
+
 ---
 
 ## 👥 7 Core Roles
@@ -227,7 +258,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 +311,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 +328,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 +425,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 +521,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 +536,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 +550,11 @@ devsquad dispatch -t "Design user authentication system"
 ```bash
 # Check version
 devsquad --version
-# Expected: devsquad 3.6.6
+# Expected: devsquad 4.0.0
 
 # Run tests
 pytest tests/ -v --tb=short
-# Expected: 1500+ passed
+# Expected: 2857+ passed
 ```
 
 ---
@@ -538,7 +570,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 +579,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 +590,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 +605,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 4.0.0
 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 +629,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 +650,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 +693,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-07-07 | Version: V4.0.0*
 
 </details>

{devsquad-3.6.7 → devsquad-4.0.0}/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 | V4.0.0 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-3400%2B%20passing-brightgreen" />
+  <img alt="Version" src="https://img.shields.io/badge/V4.0.0-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,30 @@ 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
+## 🚀 V4.0.0: Loop Engineering + UI/UX 巡检 + Adversarial 验证 + DAG 可视化 + Autonomous + 插件热加载
 
-**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 V4.0.0** 借鉴上游 TraeMultiAgentSkill v2.7 理念，新增 6 个特性（P1-P3），全面接入 dispatch pipeline，无幽灵功能：
+- **P1-1 Loop Engineering**: Discovery → Handoff → Verification → Persistence → Scheduling 五步闭环
+- **P1-2 UI/UX 巡检**: 4 维度审计（a11y/interaction/layout/ux）+ PIL 像素 diff 视觉回归
+- **P2-1 Adversarial 验证**: 红队攻击 + 蓝队防御 + 裁判仲裁三阶段对抗验证
+- **P2-2 DAG 可视化**: Mermaid / JSON / DOT 三种格式依赖图可视化
+- **P3-1 Autonomous**: plan → dev → verify → fix 4 阶段自主迭代，复用 LoopKernel，不绕过共识门
+- **P3-2 插件热加载**: 三种加载路径 + 路径穿越三层防护 + reload 回滚 + 审计日志
+
+3400+ 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 +97,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 +105,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 +121,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 +135,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`). V4.0.0 adds Loop Engineering, UI/UX 巡检, Adversarial 验证, DAG 可视化, Autonomous, and 插件热加载.
+
 ---
 
 ## 👥 7 Core Roles
@@ -147,7 +173,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 +226,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 +243,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 +340,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 +436,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 +451,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 +465,11 @@ devsquad dispatch -t "Design user authentication system"
 ```bash
 # Check version
 devsquad --version
-# Expected: devsquad 3.6.6
+# Expected: devsquad 4.0.0
 
 # Run tests
 pytest tests/ -v --tb=short
-# Expected: 1500+ passed
+# Expected: 2857+ passed
 ```
 
 ---
@@ -458,7 +485,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 +494,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 +505,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 +520,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 4.0.0
 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 +544,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 +565,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 +608,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-07-07 | Version: V4.0.0*
 
 </details>