specpro-cli 0.1.0__tar.gz

specpro_cli-0.1.0/.gitignore

@@ -0,0 +1,24 @@
+# --- 独立仓库的工作树（各有自己的 .git，不进主仓库）---
+# 显式声明：这三个目录是刻意的边界，不是遗漏。
+/specs/
+/docs/
+/private/
+
+# --- 自举部署镜像：由部署动作生成，非源 ---
+.claude/
+.specpro/
+
+# --- 元数据与构建产物 ---
+.DS_Store
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+
+# --- 安装 CLI 的构建产物与本地环境 ---
+# 资产快照：构建期从仓库根同步，非手工维护（约束 C4）
+tools/install/assets/
+.venv/
+venv/
+.pytest_cache/

specpro_cli-0.1.0/LICENSE

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

specpro_cli-0.1.0/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.5
+Name: specpro-cli
+Version: 0.1.0
+Summary: Install specpro's distributed assets into a host project, for one of the supported AI coding agents.
+Project-URL: Homepage, https://github.com/wutone55/specpro
+Project-URL: Repository, https://github.com/wutone55/specpro
+Project-URL: Issues, https://github.com/wutone55/specpro/issues
+Author: Wu Wantong
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai-coding,claude,development-workflow,sdd,spec-driven,specification
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.11
+Requires-Dist: click
+Requires-Dist: pathspec
+Requires-Dist: pyyaml
+Requires-Dist: rich
+Requires-Dist: typer
+Description-Content-Type: text/markdown
+
+# Spec Pro
+
+Better Spec-Driven Development Toolkit for AI Coding Agents.
+
+specpro 把一套规范驱动开发（SDD）工作流装进你的项目：16 个斜杠命令（`/specpro-specify`、`/specpro-plan`、`/specpro-tasks`、`/specpro-implement`……）驱动 AI 编程助手按「规格 → 设计 → 任务 → 实现 → 测试」的链条交付功能，并自带核验器保证产物不漂移。
+
+**需要**：一个 git 项目 + 至少一个受支持的 AI 编程助手（Claude Code / Copilot / Cursor / Gemini CLI / OpenCode / Qoder）。
+
+---
+
+## 安装（推荐：uv tool，约 30 秒）
+
+### 第 0 步 · 安装 uv（各平台任选其一）
+
+```bash
+# macOS / Linux（官方脚本）
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# macOS（Homebrew）
+brew install uv
+
+# Windows（PowerShell）
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+
+# Windows（winget）
+winget install astral-sh.uv
+```
+
+> uv 会自动管理 Python 解释器——**你不需要预装 Python**。
+
+### 第 1 步 · 安装 specpro-cli
+
+**从本地 whl（离线包）：**
+
+```bash
+uv tool install ./specpro_cli-*.whl
+```
+
+**从 PyPI（在线）：**
+
+```bash
+uv tool install specpro-cli
+```
+
+### 第 2 步 · 验证
+
+```bash
+specpro --help
+```
+
+看到 SPEC PRO 头图与命令列表即安装成功。
+
+---
+
+## 使用
+
+```bash
+cd 你的项目
+specpro init          # 交互式：确认目录 → 选择 AI 助手 → 装入工作流
+specpro check         # 自检：git 与各助手 CLI 是否就绪、项目内已装了什么
+specpro version       # 版本与系统信息
+```
+
+`init` 完成后，在 AI 编程助手里即可使用 `/specpro-specify` 等斜杠命令。
+
+---
+
+## 升级与卸载
+
+```bash
+uv tool upgrade specpro-cli          # 升级到最新版
+uv tool list                         # 查看已装工具
+uv tool uninstall specpro-cli        # 卸载（只移除 CLI；项目内已装入的文件用 specpro remove 清理）
+```
+
+---
+
+## 备选：手动 venv 安装（不使用 uv 时）
+
+```bash
+python3 -m venv ~/.specpro-venv
+~/.specpro-venv/bin/pip install ./specpro_cli-*.whl
+~/.specpro-venv/bin/specpro init     # 每次调用需带完整路径
+```
+
+---
+
+**License**: MIT · **Repository**: https://github.com/wutone55/specpro

specpro_cli-0.1.0/PUBLISHING.md

@@ -0,0 +1,44 @@
+# Publishing specpro-cli — Maintainer Guide
+
+> Maintainer-facing. The actual `publish` action needs a PyPI account + token — a one-time
+> manual setup that is deliberately NOT part of the tool or the repository.
+
+## One-time setup
+
+1. Create a PyPI account (https://pypi.org/account/register/).
+2. Create an API token (https://pypi.org/manage/account/token/) — scope: entire account or `specpro-cli`.
+3. Keep it in your shell profile (never in the repository):
+
+```bash
+export UV_PUBLISH_TOKEN="pypi-..."
+```
+
+## Release procedure
+
+```bash
+cd tools/install
+
+# 0. Bump the version in pyproject.toml FIRST — PyPI rejects same-version uploads.
+#    Single source: [project] version. Never re-publish the same number.
+
+./release.sh
+```
+
+`release.sh` runs the four steps in order (FR-072):
+
+| Step | What | Failure mode it prevents |
+|------|------|--------------------------|
+| 1 `uv build` | sdist + wheel from the current source | stale artifacts |
+| 2 `uvx twine check dist/*` | metadata validation | gap discovered on PyPI instead of locally |
+| 3 package `specpro-offline/` | whl + README + LICENSE for direct distribution | the offline channel drifting from the online one |
+| 4 `uv publish` | upload to PyPI — **only when `UV_PUBLISH_TOKEN` is set**; without it steps 1–3 still complete | accidental publish |
+
+## Distribution
+
+- **Online**: users install with `uv tool install specpro-cli`, upgrade with `uv tool upgrade`.
+- **Offline**: hand out the `specpro-offline/` directory; users run `uv tool install ./specpro_cli-*.whl`.
+
+## Future enhancement (not in this version)
+
+GitHub Actions Trusted Publishing (OIDC) — push a tag, CI builds and publishes without any
+token. Requires the repository hosted on GitHub and a PyPI Trusted Publisher entry.

specpro_cli-0.1.0/README.md

@@ -0,0 +1,88 @@
+# Spec Pro
+
+Better Spec-Driven Development Toolkit for AI Coding Agents.
+
+specpro 把一套规范驱动开发（SDD）工作流装进你的项目：16 个斜杠命令（`/specpro-specify`、`/specpro-plan`、`/specpro-tasks`、`/specpro-implement`……）驱动 AI 编程助手按「规格 → 设计 → 任务 → 实现 → 测试」的链条交付功能，并自带核验器保证产物不漂移。
+
+**需要**：一个 git 项目 + 至少一个受支持的 AI 编程助手（Claude Code / Copilot / Cursor / Gemini CLI / OpenCode / Qoder）。
+
+---
+
+## 安装（推荐：uv tool，约 30 秒）
+
+### 第 0 步 · 安装 uv（各平台任选其一）
+
+```bash
+# macOS / Linux（官方脚本）
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# macOS（Homebrew）
+brew install uv
+
+# Windows（PowerShell）
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+
+# Windows（winget）
+winget install astral-sh.uv
+```
+
+> uv 会自动管理 Python 解释器——**你不需要预装 Python**。
+
+### 第 1 步 · 安装 specpro-cli
+
+**从本地 whl（离线包）：**
+
+```bash
+uv tool install ./specpro_cli-*.whl
+```
+
+**从 PyPI（在线）：**
+
+```bash
+uv tool install specpro-cli
+```
+
+### 第 2 步 · 验证
+
+```bash
+specpro --help
+```
+
+看到 SPEC PRO 头图与命令列表即安装成功。
+
+---
+
+## 使用
+
+```bash
+cd 你的项目
+specpro init          # 交互式：确认目录 → 选择 AI 助手 → 装入工作流
+specpro check         # 自检：git 与各助手 CLI 是否就绪、项目内已装了什么
+specpro version       # 版本与系统信息
+```
+
+`init` 完成后，在 AI 编程助手里即可使用 `/specpro-specify` 等斜杠命令。
+
+---
+
+## 升级与卸载
+
+```bash
+uv tool upgrade specpro-cli          # 升级到最新版
+uv tool list                         # 查看已装工具
+uv tool uninstall specpro-cli        # 卸载（只移除 CLI；项目内已装入的文件用 specpro remove 清理）
+```
+
+---
+
+## 备选：手动 venv 安装（不使用 uv 时）
+
+```bash
+python3 -m venv ~/.specpro-venv
+~/.specpro-venv/bin/pip install ./specpro_cli-*.whl
+~/.specpro-venv/bin/specpro init     # 每次调用需带完整路径
+```
+
+---
+
+**License**: MIT · **Repository**: https://github.com/wutone55/specpro