workflow-loop 0.2.0__tar.gz → 0.3.2__tar.gz

{workflow_loop-0.2.0/src/workflow_loop.egg-info → workflow_loop-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workflow-loop
-Version: 0.2.0
+Version: 0.3.2
 Summary: 为 AI 驱动的软件开发提供有状态、可验证、可回退的工作流管理。
 Author: yuzyf
 License-Expression: MIT
@@ -9,6 +9,7 @@ Project-URL: Repository, https://github.com/yuzyf/workflow_loop
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: markdown-it-py>=4.0
 Requires-Dist: packaging>=24.0
 Provides-Extra: dev
 Requires-Dist: build>=1.2; extra == "dev"
@@ -89,29 +90,29 @@ flowchart TD
 - 安装时能够访问 GitHub 和 PyPI（Python 公共软件包仓库）。
 - 执行安装命令前，先进入要由 Workflow Loop 管理的项目根目录。
 
-## 安装 0.2.0
+## 安装 0.3.2
 
 安装器先进行只读检查并列出项目侧和电脑侧可能发生的全部持久修改。用户确认一次后，安装器才安装或复用全局 `workflow` 命令，并把智能体契约、产物模板和工作规范写入当前项目；用户取消或安装失败时不会留下只完成一部分的安装。
 
 ### macOS
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.2.0/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.2/install.sh | bash
 ```
 
 ### Linux
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.2.0/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.2/install.sh | bash
 ```
 
 ### 原生 Windows
 
 ```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.2.0/install.ps1 | iex"
+powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.3.2/install.ps1 | iex"
 ```
 
-安装命令固定读取 `v0.2.0` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
+安装命令固定读取 `v0.3.2` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
 
 ## 更新与卸载
 
@@ -119,7 +120,7 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/y
 
 ```bash
 workflow update
-workflow update --version 0.2.0
+workflow update --version 0.3.2
 ```
 
 更新按需补齐电脑全局命令和当前项目，只直接覆盖项目根 `AGENTS.md`、`.workflow_loop/Template_Repository/`、`.workflow_loop/Standardized_Repository/`，以及 `.workflow_loop/project.json` 中的安装版本字段。更新不创建备份，不回滚已经完成的步骤；当前轮次状态、历史、回退资料、业务代码和正式产物保持不变。失败后重新执行同一命令即可继续补齐。
@@ -220,12 +221,32 @@ uv run python -m build
 
 `dev`（开发附加依赖）包含 `pytest`（Python 测试工具）、PyYAML（YAML 配置解析库）和 `build`（Python 分发包构建工具）。
 
+## 发布正式版本
+
+项目维护者确认当前仓库内容可以直接发布后，在仓库根目录执行下面的命令，并把 `0.3.2` 替换成要发布的新版本号：
+
+```bash
+uv run python scripts/release.py 0.3.2
+```
+
+运行这条命令本身就表示维护者接受当前仓库状态并承担跳过本地发布检查的风险。脚本不会再次确认，也不会在本地运行测试、构建或远程版本查询。它依次执行：
+
+1. 更新源码、README、维护脚本和自动发布配置中的当前版本身份，并运行 `uv lock` 更新依赖锁定结果。
+2. 运行 `git add -A`，把当前全部未忽略的新增、修改和删除纳入发布提交。
+3. 创建说明为 `release: prepare workflow-loop <新版本号>` 的发布提交。
+4. 把当前提交推送到远程 `main`（默认分支）。
+5. 创建带说明的 `v<新版本号>` 标签。
+6. 推送该标签，触发现有 GitHub Actions（GitHub 自动任务）完成测试、构建和公开发布。
+
+任一步失败时，脚本会显示失败步骤和退出码并立即停止。它不会强推、自动重试或回滚已经完成的文件修改、提交、分支推送和标签操作。标签推送成功只表示远程发布流程已经触发；是否最终发布成功，以 GitHub Actions 的运行结果为准。
+
 ## 仓库结构
 
 ```text
 workflow_loop/
 ├── src/workflow_loop/     Python 产品代码和随包分发的模板、规范
 ├── tests/                 自动化测试
+├── scripts/release.py     维护者直接发布当前仓库的脚本
 ├── .workflow_loop/        本仓库自己的工作流状态、模板和规范
 ├── spec/                  产品设计和代码架构设计
 ├── acceptance/            验收计划与验收结果
@@ -237,8 +258,7 @@ workflow_loop/
 ├── update.ps1             Windows 旧版本更新脚本
 ├── uninstall.sh           macOS 和 Linux 旧版本卸载脚本
 ├── uninstall.ps1          Windows 旧版本卸载脚本
-├── CONTEXT.md             产品术语、规则和限制
-└── DESIGN.md              实现设计文档
+└── docs/adr/              已经发生的架构决策及其取代关系
 ```
 
 ## 详细文档
@@ -247,10 +267,11 @@ workflow_loop/
 - [安装到项目](spec/功能_安装到项目.md)：支持环境、安装行为、异常处理和公开发布要求。
 - [更新已安装项目](spec/功能_更新已安装项目.md)：目标版本、覆盖范围、保留范围和失败重试规则。
 - [卸载 Workflow Loop](spec/功能_卸载_Workflow_Loop.md)：项目强制卸载和电脑全局卸载的独立边界。
+- [发布正式版本](spec/功能_发布正式版本.md)：人工发布命令、版本更新范围、执行顺序和失败边界。
 - [处理无需开发任务](spec/功能_处理无需开发任务.md)：简单流程适用边界、逐项确认、完成和异常处理规则。
 - [代码架构设计](spec/代码架构设计.md)：功能到代码模块、状态和外部依赖的对应关系。
-- [实现设计文档](DESIGN.md)：命令、数据模型、工作意图、阶段路径和门禁的实现形态。
-- [产品事实与约束](CONTEXT.md)：当前有效的术语、约束和设计决策。
+- [原生 Windows PowerShell 决策](docs/adr/0001-support-native-windows-powershell.md)：为什么正式支持原生 Windows PowerShell。
+- [首版版本策略决策](docs/adr/0002-fix-product-version-at-0-1-0.md)：首版版本号决定及其被后续功能取代的状态。
 - [需求交付追踪表](需求交付追踪表.md)：每轮需求从设计到验收的完整追踪入口。
 
 ## 许可证

{workflow_loop-0.2.0 → workflow_loop-0.3.2}/README.md

@@ -71,29 +71,29 @@ flowchart TD
 - 安装时能够访问 GitHub 和 PyPI（Python 公共软件包仓库）。
 - 执行安装命令前，先进入要由 Workflow Loop 管理的项目根目录。
 
-## 安装 0.2.0
+## 安装 0.3.2
 
 安装器先进行只读检查并列出项目侧和电脑侧可能发生的全部持久修改。用户确认一次后，安装器才安装或复用全局 `workflow` 命令，并把智能体契约、产物模板和工作规范写入当前项目；用户取消或安装失败时不会留下只完成一部分的安装。
 
 ### macOS
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.2.0/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.2/install.sh | bash
 ```
 
 ### Linux
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.2.0/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.2/install.sh | bash
 ```
 
 ### 原生 Windows
 
 ```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.2.0/install.ps1 | iex"
+powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.3.2/install.ps1 | iex"
 ```
 
-安装命令固定读取 `v0.2.0` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
+安装命令固定读取 `v0.3.2` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
 
 ## 更新与卸载
 
@@ -101,7 +101,7 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/y
 
 ```bash
 workflow update
-workflow update --version 0.2.0
+workflow update --version 0.3.2
 ```
 
 更新按需补齐电脑全局命令和当前项目，只直接覆盖项目根 `AGENTS.md`、`.workflow_loop/Template_Repository/`、`.workflow_loop/Standardized_Repository/`，以及 `.workflow_loop/project.json` 中的安装版本字段。更新不创建备份，不回滚已经完成的步骤；当前轮次状态、历史、回退资料、业务代码和正式产物保持不变。失败后重新执行同一命令即可继续补齐。
@@ -202,12 +202,32 @@ uv run python -m build
 
 `dev`（开发附加依赖）包含 `pytest`（Python 测试工具）、PyYAML（YAML 配置解析库）和 `build`（Python 分发包构建工具）。
 
+## 发布正式版本
+
+项目维护者确认当前仓库内容可以直接发布后，在仓库根目录执行下面的命令，并把 `0.3.2` 替换成要发布的新版本号：
+
+```bash
+uv run python scripts/release.py 0.3.2
+```
+
+运行这条命令本身就表示维护者接受当前仓库状态并承担跳过本地发布检查的风险。脚本不会再次确认，也不会在本地运行测试、构建或远程版本查询。它依次执行：
+
+1. 更新源码、README、维护脚本和自动发布配置中的当前版本身份，并运行 `uv lock` 更新依赖锁定结果。
+2. 运行 `git add -A`，把当前全部未忽略的新增、修改和删除纳入发布提交。
+3. 创建说明为 `release: prepare workflow-loop <新版本号>` 的发布提交。
+4. 把当前提交推送到远程 `main`（默认分支）。
+5. 创建带说明的 `v<新版本号>` 标签。
+6. 推送该标签，触发现有 GitHub Actions（GitHub 自动任务）完成测试、构建和公开发布。
+
+任一步失败时，脚本会显示失败步骤和退出码并立即停止。它不会强推、自动重试或回滚已经完成的文件修改、提交、分支推送和标签操作。标签推送成功只表示远程发布流程已经触发；是否最终发布成功，以 GitHub Actions 的运行结果为准。
+
 ## 仓库结构
 
 ```text
 workflow_loop/
 ├── src/workflow_loop/     Python 产品代码和随包分发的模板、规范
 ├── tests/                 自动化测试
+├── scripts/release.py     维护者直接发布当前仓库的脚本
 ├── .workflow_loop/        本仓库自己的工作流状态、模板和规范
 ├── spec/                  产品设计和代码架构设计
 ├── acceptance/            验收计划与验收结果
@@ -219,8 +239,7 @@ workflow_loop/
 ├── update.ps1             Windows 旧版本更新脚本
 ├── uninstall.sh           macOS 和 Linux 旧版本卸载脚本
 ├── uninstall.ps1          Windows 旧版本卸载脚本
-├── CONTEXT.md             产品术语、规则和限制
-└── DESIGN.md              实现设计文档
+└── docs/adr/              已经发生的架构决策及其取代关系
 ```
 
 ## 详细文档
@@ -229,10 +248,11 @@ workflow_loop/
 - [安装到项目](spec/功能_安装到项目.md)：支持环境、安装行为、异常处理和公开发布要求。
 - [更新已安装项目](spec/功能_更新已安装项目.md)：目标版本、覆盖范围、保留范围和失败重试规则。
 - [卸载 Workflow Loop](spec/功能_卸载_Workflow_Loop.md)：项目强制卸载和电脑全局卸载的独立边界。
+- [发布正式版本](spec/功能_发布正式版本.md)：人工发布命令、版本更新范围、执行顺序和失败边界。
 - [处理无需开发任务](spec/功能_处理无需开发任务.md)：简单流程适用边界、逐项确认、完成和异常处理规则。
 - [代码架构设计](spec/代码架构设计.md)：功能到代码模块、状态和外部依赖的对应关系。
-- [实现设计文档](DESIGN.md)：命令、数据模型、工作意图、阶段路径和门禁的实现形态。
-- [产品事实与约束](CONTEXT.md)：当前有效的术语、约束和设计决策。
+- [原生 Windows PowerShell 决策](docs/adr/0001-support-native-windows-powershell.md)：为什么正式支持原生 Windows PowerShell。
+- [首版版本策略决策](docs/adr/0002-fix-product-version-at-0-1-0.md)：首版版本号决定及其被后续功能取代的状态。
 - [需求交付追踪表](需求交付追踪表.md)：每轮需求从设计到验收的完整追踪入口。
 
 ## 许可证

{workflow_loop-0.2.0 → workflow_loop-0.3.2}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "workflow-loop"
-version = "0.2.0"
+version = "0.3.2"
 description = "为 AI 驱动的软件开发提供有状态、可验证、可回退的工作流管理。"
 readme = "README.md"
 requires-python = ">=3.11"
 license = "MIT"
 license-files = ["LICENSE"]
 authors = [{ name = "yuzyf" }]
-dependencies = ["packaging>=24.0"]
+dependencies = ["markdown-it-py>=4.0", "packaging>=24.0"]
 
 [project.scripts]
 workflow = "workflow_loop.cli:main"

{workflow_loop-0.2.0 → workflow_loop-0.3.2}/src/workflow_loop/__init__.py

@@ -1,6 +1,6 @@
 # 包版本号，用于 pip/uv 安装时版本匹配
-__version__ = "0.2.0"
+__version__ = "0.3.2"
 # 产品身份标识：workflow --version 输出、安装脚本身份核对和安装事务校验共用同一组常量
-# 本次发布版本为 0.2.0；后续发布使用尚未被 PyPI 占用的新版本号
+# 本次发布版本为 0.3.2；后续发布使用尚未被 PyPI 占用的新版本号
 PRODUCT_NAME = "workflow-loop"
 PRODUCT_IDENTITY = f"{PRODUCT_NAME} {__version__}"

{workflow_loop-0.2.0 → workflow_loop-0.3.2}/src/workflow_loop/acceptance_records.py

@@ -62,6 +62,13 @@ def automated_test_ids(project_root: str, topic: str, criterion_id: str) -> list
     ]
 
 
+def _execution_stage(
+    wf_state: state_mod.WorkflowState,
+) -> state_mod.StageState | None:
+    """读取当前测试验证任务，并兼容尚未迁移的旧测试执行状态。"""
+    return wf_state.stages.get("qa") or wf_state.stages.get("test_execution")
+
+
 def record_is_current(
     record: state_mod.AcceptanceCriterionRecord,
     wf_state: state_mod.WorkflowState,
@@ -78,17 +85,15 @@ def record_is_current(
     if record.result != "passed" or record.record_id != compute_record_id(record):
         return False
     if record.method in ("自动化测试", "自动化测试 + 人工验收") and record.test_ids:
-        tasks = wf_state.stages.get(
-            "test_execution",
-            state_mod.StageState(),
-        ).test_tasks.get(record.topic, {})
+        execution_stage = _execution_stage(wf_state) or state_mod.StageState()
+        tasks = execution_stage.test_tasks.get(record.topic, {})
         current_ids: list[str] = []
         for test_id in record.test_ids:
             task = tasks.get(test_id)
             if (
                 task is None
-                or task.current_record is None
-                or task.current_record.status != "passed"
+                or not state_mod.execution_task_has_current_success(task)
+                or not task.current_record
                 or not task.current_record.record_id
             ):
                 return False
@@ -106,18 +111,17 @@ def _automated_items_are_current(
     test_ids: list[str],
 ) -> tuple[bool, str, list[str]]:
     """核对每个测试项当前机器记录有效，并返回精确记录编号列表。"""
-    stage_state = wf_state.stages.get("test_execution")
+    stage_state = _execution_stage(wf_state)
     if stage_state is None:
-        return False, "缺少 test_execution（测试执行阶段）状态", []
+        return False, "缺少 qa（测试验证）或 test_execution（旧测试执行阶段）状态", []
     tasks = stage_state.test_tasks.get(topic, {})
     record_ids: list[str] = []
     for test_id in test_ids:
         task = tasks.get(test_id)
-        if task is None or task.status != "passed" or task.current_record is None:
+        if task is None or not state_mod.execution_task_has_current_success(task):
             return False, f"{topic} / {test_id} 没有当前有效的通过记录", []
         record = task.current_record
-        if record.status != "passed" or record.exit_code != 0:
-            return False, f"{topic} / {test_id} 当前测试记录不是通过状态", []
+        assert record is not None
         if not record.record_id:
             return False, f"{topic} / {test_id} 的执行记录缺少机器记录编号，必须重新执行", []
         record_ids.append(record.record_id)