mspec-cli 4.0.0__tar.gz

mspec_cli-4.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mspec Team
+
+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.

mspec_cli-4.0.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include pyproject.toml
+recursive-include src/mspec/templates *.yaml *.md

mspec_cli-4.0.0/PKG-INFO

@@ -0,0 +1,281 @@
+Metadata-Version: 2.4
+Name: mspec-cli
+Version: 4.0.0
+Summary: m-spec - 成员规范驱动开发工作流 CLI 工具
+Author-email: shirayner <team@mspec.io>
+License: MIT
+Project-URL: Homepage, https://github.com/mspec-dev/mspec
+Project-URL: Documentation, https://github.com/mspec-dev/mspec#readme
+Project-URL: Repository, https://github.com/mspec-dev/mspec.git
+Project-URL: Issues, https://github.com/mspec-dev/mspec/issues
+Keywords: spec,workflow,cli,development,m-spec
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: semver>=3.0.0
+Requires-Dist: questionary>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Dynamic: license-file
+
+# mspec
+
+[![PyPI version](https://badge.fury.io/py/mspec.svg)](https://badge.fury.io/py/mspec)
+[![Python version](https://img.shields.io/pypi/pyversions/mspec.svg)](https://pypi.org/project/mspec/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+**mspec** - 成员规范驱动开发工作流 CLI 工具
+
+通过交互式命令行澄清机制，实现结构化问题发现与澄清，提升需求明确度和开发效率。
+
+## 特性
+
+- 🚀 **一键安装** - `pip install mspec` 即可使用
+- 🔄 **交互式澄清** - 一问一答的引导式交互界面
+- 💾 **断点续传** - 支持随时中断，下次自动恢复
+- 📚 **结构化问题分类** - 6个需求维度 + 7个设计维度
+- 🎨 **美观界面** - 使用 Rich 库提供彩色终端输出
+
+## 文档
+
+- [EVOLUTION.md](docs/EVOLUTION.md) - mspec 演进历程 (v1 → v4)
+- [SPEC-ARCHIVE.md](docs/SPEC-ARCHIVE.md) - 完整技术规范参考
+
+## 快速开始
+
+### 安装
+
+```bash
+pip install mspec
+```
+
+### 初始化项目
+
+```bash
+# 进入项目目录
+cd my-project
+
+# 初始化 mspec 配置
+mspec init
+```
+
+### 检查环境
+
+```bash
+mspec doctor
+```
+
+### 更新模板
+
+```bash
+mspec update
+```
+
+## 命令说明
+
+### `mspec init [path]`
+
+初始化 mspec 项目配置
+
+**选项：**
+- `--template, -t <url>` - 使用自定义模板仓库
+- `--force, -f` - 强制覆盖已有配置
+- `--dry-run` - 模拟运行，不实际创建文件
+- `--yes, -y` - 跳过确认，使用默认配置
+
+**示例：**
+```bash
+mspec init                          # 初始化当前目录
+mspec init ./my-project             # 初始化指定目录
+mspec init --force                  # 强制覆盖已有配置
+mspec init --template https://github.com/your-org/mspec-template
+```
+
+### `mspec update`
+
+更新模板到最新版本
+
+**选项：**
+- `--check` - 仅检查更新，不执行更新
+
+**示例：**
+```bash
+mspec update          # 更新到最新版本
+mspec update --check  # 仅检查是否有更新
+```
+
+### `mspec doctor`
+
+诊断环境配置
+
+**示例：**
+```bash
+mspec doctor
+```
+
+## 工作流
+
+```
+需求输入
+    │
+    ▼
+┌─────────────────────────────────────┐
+│  阶段 1: 需求澄清 (交互式)           │
+│  - 生成 requirement-issues.md        │
+│  - 交互式澄清 High/Medium 问题       │
+└─────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────┐
+│  阶段 2: 提案创建                    │
+│  - 创建 proposal.md                  │
+└─────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────┐
+│  阶段 3: 规格定义                    │
+│  - 创建 specs/*.md                   │
+└─────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────┐
+│  阶段 4: 技术方案                    │
+│  - 创建 design.md                    │
+└─────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────┐
+│  阶段 5: 设计澄清 (交互式)           │
+│  - 生成 design-issues.md             │
+│  - 交互式澄清 High/Medium 问题       │
+└─────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────┐
+│  阶段 6: 任务创建                    │
+│  - 创建 tasks.md                     │
+└─────────────────────────────────────┘
+    │
+    ▼
+实施 (apply)
+```
+
+## 问题分类学
+
+### 需求问题 (6个维度)
+
+1. **功能完整性** - 功能边界、流程、依赖
+2. **数据相关** - 数据定义、量级、一致性
+3. **用户体验** - 用户场景、交互、性能
+4. **边界与异常** - 边界条件、异常场景、权限
+5. **集成与依赖** - 外部系统、内部模块、环境
+6. **优先级与范围** - 必需vs可选、时间、资源
+
+### 设计问题 (7个维度)
+
+1. **架构决策** - 架构方案、服务边界、扩展性
+2. **技术选型** - 框架、数据库、中间件
+3. **接口设计** - API契约、数据流、异步处理
+4. **数据与状态** - 数据模型、状态机、迁移
+5. **安全与合规** - 认证授权、数据安全、审计
+6. **性能与可靠性** - 性能瓶颈、缓存、降级熔断
+7. **部署与运维** - 部署方案、监控告警、配置管理
+
+## 交互式澄清
+
+```
+=================================================================
+📋 问题 [3/8] - 功能点: 用户管理
+=================================================================
+
+❓ 问题：用户资料需要包含哪些字段？
+
+💡 说明：
+   当前需求中"用户资料"范围不明确，需要明确包含哪些
+   必填字段和选填字段，这将影响数据库设计和前端表单开发。
+
+🔘 备选选项：
+
+   A) 基础版：用户名、邮箱、手机号
+   B) 标准版：用户名、邮箱、手机号、头像、昵称
+   C) 完整版：用户名、邮箱、手机号、头像、昵称、
+              部门、职位、入职日期
+   D) 自定义...
+
+✏️ 你的选择:
+=================================================================
+```
+
+**操作指令：**
+- `A`, `B`, `C`, `D`... - 选择对应选项
+- `E` 或最后一个选项 - 选择自定义输入模式
+- `q` - 退出保存，下次自动恢复
+- `s` - 跳过当前问题（仅 Low 优先级）
+
+## 配置
+
+mspec 配置文件位于 `openspec/config.yaml`，包含：
+
+- 问题分类学引用
+- 交互式澄清配置
+- 各阶段规则定义
+
+## 开发
+
+```bash
+# 克隆仓库
+git clone https://github.com/mspec-dev/mspec.git
+cd mspec
+
+# 创建虚拟环境
+python -m venv venv
+source venv/bin/activate  # Linux/Mac
+# 或
+venv\Scripts\activate  # Windows
+
+# 安装依赖
+pip install -e ".[dev]"
+
+# 运行测试
+pytest
+
+# 格式化代码
+black src/
+isort src/
+
+# 类型检查
+mypy src/
+```
+
+## 许可证
+
+[MIT](LICENSE)
+
+## 贡献
+
+欢迎提交 Issue 和 PR！
+
+## 相关链接
+
+- [GitHub](https://github.com/mspec-dev/mspec)
+- [PyPI](https://pypi.org/project/mspec/)
+- [文档](https://docs.mspec.io)

mspec_cli-4.0.0/README.md

@@ -0,0 +1,242 @@
+# mspec
+
+[![PyPI version](https://badge.fury.io/py/mspec.svg)](https://badge.fury.io/py/mspec)
+[![Python version](https://img.shields.io/pypi/pyversions/mspec.svg)](https://pypi.org/project/mspec/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+**mspec** - 成员规范驱动开发工作流 CLI 工具
+
+通过交互式命令行澄清机制，实现结构化问题发现与澄清，提升需求明确度和开发效率。
+
+## 特性
+
+- 🚀 **一键安装** - `pip install mspec` 即可使用
+- 🔄 **交互式澄清** - 一问一答的引导式交互界面
+- 💾 **断点续传** - 支持随时中断，下次自动恢复
+- 📚 **结构化问题分类** - 6个需求维度 + 7个设计维度
+- 🎨 **美观界面** - 使用 Rich 库提供彩色终端输出
+
+## 文档
+
+- [EVOLUTION.md](docs/EVOLUTION.md) - mspec 演进历程 (v1 → v4)
+- [SPEC-ARCHIVE.md](docs/SPEC-ARCHIVE.md) - 完整技术规范参考
+
+## 快速开始
+
+### 安装
+
+```bash
+pip install mspec
+```
+
+### 初始化项目
+
+```bash
+# 进入项目目录
+cd my-project
+
+# 初始化 mspec 配置
+mspec init
+```
+
+### 检查环境
+
+```bash
+mspec doctor
+```
+
+### 更新模板
+
+```bash
+mspec update
+```
+
+## 命令说明
+
+### `mspec init [path]`
+
+初始化 mspec 项目配置
+
+**选项：**
+- `--template, -t <url>` - 使用自定义模板仓库
+- `--force, -f` - 强制覆盖已有配置
+- `--dry-run` - 模拟运行，不实际创建文件
+- `--yes, -y` - 跳过确认，使用默认配置
+
+**示例：**
+```bash
+mspec init                          # 初始化当前目录
+mspec init ./my-project             # 初始化指定目录
+mspec init --force                  # 强制覆盖已有配置
+mspec init --template https://github.com/your-org/mspec-template
+```
+
+### `mspec update`
+
+更新模板到最新版本
+
+**选项：**
+- `--check` - 仅检查更新，不执行更新
+
+**示例：**
+```bash
+mspec update          # 更新到最新版本
+mspec update --check  # 仅检查是否有更新
+```
+
+### `mspec doctor`
+
+诊断环境配置
+
+**示例：**
+```bash
+mspec doctor
+```
+
+## 工作流
+
+```
+需求输入
+    │
+    ▼
+┌─────────────────────────────────────┐
+│  阶段 1: 需求澄清 (交互式)           │
+│  - 生成 requirement-issues.md        │
+│  - 交互式澄清 High/Medium 问题       │
+└─────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────┐
+│  阶段 2: 提案创建                    │
+│  - 创建 proposal.md                  │
+└─────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────┐
+│  阶段 3: 规格定义                    │
+│  - 创建 specs/*.md                   │
+└─────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────┐
+│  阶段 4: 技术方案                    │
+│  - 创建 design.md                    │
+└─────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────┐
+│  阶段 5: 设计澄清 (交互式)           │
+│  - 生成 design-issues.md             │
+│  - 交互式澄清 High/Medium 问题       │
+└─────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────┐
+│  阶段 6: 任务创建                    │
+│  - 创建 tasks.md                     │
+└─────────────────────────────────────┘
+    │
+    ▼
+实施 (apply)
+```
+
+## 问题分类学
+
+### 需求问题 (6个维度)
+
+1. **功能完整性** - 功能边界、流程、依赖
+2. **数据相关** - 数据定义、量级、一致性
+3. **用户体验** - 用户场景、交互、性能
+4. **边界与异常** - 边界条件、异常场景、权限
+5. **集成与依赖** - 外部系统、内部模块、环境
+6. **优先级与范围** - 必需vs可选、时间、资源
+
+### 设计问题 (7个维度)
+
+1. **架构决策** - 架构方案、服务边界、扩展性
+2. **技术选型** - 框架、数据库、中间件
+3. **接口设计** - API契约、数据流、异步处理
+4. **数据与状态** - 数据模型、状态机、迁移
+5. **安全与合规** - 认证授权、数据安全、审计
+6. **性能与可靠性** - 性能瓶颈、缓存、降级熔断
+7. **部署与运维** - 部署方案、监控告警、配置管理
+
+## 交互式澄清
+
+```
+=================================================================
+📋 问题 [3/8] - 功能点: 用户管理
+=================================================================
+
+❓ 问题：用户资料需要包含哪些字段？
+
+💡 说明：
+   当前需求中"用户资料"范围不明确，需要明确包含哪些
+   必填字段和选填字段，这将影响数据库设计和前端表单开发。
+
+🔘 备选选项：
+
+   A) 基础版：用户名、邮箱、手机号
+   B) 标准版：用户名、邮箱、手机号、头像、昵称
+   C) 完整版：用户名、邮箱、手机号、头像、昵称、
+              部门、职位、入职日期
+   D) 自定义...
+
+✏️ 你的选择:
+=================================================================
+```
+
+**操作指令：**
+- `A`, `B`, `C`, `D`... - 选择对应选项
+- `E` 或最后一个选项 - 选择自定义输入模式
+- `q` - 退出保存，下次自动恢复
+- `s` - 跳过当前问题（仅 Low 优先级）
+
+## 配置
+
+mspec 配置文件位于 `openspec/config.yaml`，包含：
+
+- 问题分类学引用
+- 交互式澄清配置
+- 各阶段规则定义
+
+## 开发
+
+```bash
+# 克隆仓库
+git clone https://github.com/mspec-dev/mspec.git
+cd mspec
+
+# 创建虚拟环境
+python -m venv venv
+source venv/bin/activate  # Linux/Mac
+# 或
+venv\Scripts\activate  # Windows
+
+# 安装依赖
+pip install -e ".[dev]"
+
+# 运行测试
+pytest
+
+# 格式化代码
+black src/
+isort src/
+
+# 类型检查
+mypy src/
+```
+
+## 许可证
+
+[MIT](LICENSE)
+
+## 贡献
+
+欢迎提交 Issue 和 PR！
+
+## 相关链接
+
+- [GitHub](https://github.com/mspec-dev/mspec)
+- [PyPI](https://pypi.org/project/mspec/)
+- [文档](https://docs.mspec.io)

mspec_cli-4.0.0/pyproject.toml

@@ -0,0 +1,68 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mspec-cli"
+version = "4.0.0"
+description = "m-spec - 成员规范驱动开发工作流 CLI 工具"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "shirayner", email = "team@mspec.io"}
+]
+keywords = ["spec", "workflow", "cli", "development", "m-spec"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+requires-python = ">=3.8"
+dependencies = [
+    "click>=8.0.0",
+    "rich>=13.0.0",
+    "requests>=2.28.0",
+    "pydantic>=2.0.0",
+    "pyyaml>=6.0",
+    "semver>=3.0.0",
+    "questionary>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "black>=23.0.0",
+    "isort>=5.12.0",
+    "mypy>=1.0.0",
+    "flake8>=6.0.0",
+]
+
+[project.scripts]
+mspec = "mspec.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/mspec-dev/mspec"
+Documentation = "https://github.com/mspec-dev/mspec#readme"
+Repository = "https://github.com/mspec-dev/mspec.git"
+Issues = "https://github.com/mspec-dev/mspec/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+mspec = ["templates/*"]
+
+[tool.black]
+line-length = 100
+target-version = ['py38']
+
+[tool.isort]
+profile = "black"
+line_length = 100

mspec_cli-4.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mspec_cli-4.0.0/src/mspec/__init__.py

@@ -0,0 +1,5 @@
+"""mspec - 成员规范驱动开发工作流 CLI 工具"""
+
+__version__ = "4.0.0"
+__author__ = "mspec Team"
+__email__ = "team@mspec.io"

mspec_cli-4.0.0/src/mspec/__main__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/env python3
+"""mspec CLI 入口点"""
+
+from mspec.cli import main
+
+if __name__ == "__main__":
+    main()

mspec_cli-4.0.0/src/mspec/cli.py

@@ -0,0 +1,44 @@
+#!/usr/bin/env python3
+"""mspec CLI 入口"""
+
+import click
+from rich.console import Console
+
+from mspec.commands import doctor, init, update
+from mspec.utils.console import print_banner
+
+console = Console()
+
+
+@click.group()
+@click.version_option(version="4.0.0", prog_name="mspec")
+@click.option("--verbose", "-v", is_flag=True, help="显示详细日志")
+@click.pass_context
+def cli(ctx: click.Context, verbose: bool) -> None:
+    """mspec - 成员规范驱动开发工作流 CLI 工具
+
+    快速开始:
+        mspec init           初始化项目配置
+        mspec doctor         检查环境配置
+        mspec update         更新模板到最新版本
+
+    更多信息: https://github.com/mspec-dev/mspec
+    """
+    ctx.ensure_object(dict)
+    ctx.obj["verbose"] = verbose
+
+
+# 注册命令
+cli.add_command(init.init_cmd)
+cli.add_command(update.update_cmd)
+cli.add_command(doctor.doctor_cmd)
+
+
+def main() -> None:
+    """主入口函数"""
+    print_banner()
+    cli()
+
+
+if __name__ == "__main__":
+    main()

mspec_cli-4.0.0/src/mspec/commands/__init__.py

@@ -0,0 +1,7 @@
+"""mspec 命令模块"""
+
+from mspec.commands.doctor import doctor_cmd
+from mspec.commands.init import init_cmd
+from mspec.commands.update import update_cmd
+
+__all__ = ["init_cmd", "update_cmd", "doctor_cmd"]