workflow-loop 0.3.5__tar.gz → 0.3.7__tar.gz

{workflow_loop-0.3.5/src/workflow_loop.egg-info → workflow_loop-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workflow-loop
-Version: 0.3.5
+Version: 0.3.7
 Summary: 为 AI 驱动的软件开发提供有状态、可验证、可回退的工作流管理。
 Author: yuzyf
 License-Expression: MIT
@@ -34,6 +34,7 @@ Workflow Loop 把一次软件修改拆成有顺序的工作环节，并用程序
 
 - **保存进度**：在项目的 `.workflow_loop/` 目录保存当前工作环节、确认状态和机器执行记录，下一次对话可以从真实状态继续。
 - **控制推进**：完整研发任务的每个环节依次经过讨论完成、程序检查和用户确认三道门；无需开发任务走独立的讨论、执行、结果确认简单流程。
+- **工作记录表**：程序在环节开始时生成机器可校验的填空表并预填固定事实，AI 只填空位；正式文档由程序按表生成，门禁检查表并检测文档被直接修改，消除格式反复。
 - **一次说明门禁问题**：完整研发门禁失败时，一次列出当前能够独立确认的全部问题；每项写明位置、预期、实际、证据、影响和下一动作，无法可靠判断的项目标为“未检查”并说明依赖。同一状态重复检查时，问题清单和顺序保持一致，要求先修改后再检查。
 - **给出唯一下一步**：每条命令结束时只给出一条完整有效的下一命令，并说明执行者、是否会自动执行测试或其它实际动作、以及成功条件。AI 必须原样执行，不能追加管道、截断、重定向或命令串联。
 - **连接交付证据**：把产品设计、验收条件、测试项、实施记录和最终结果放进同一条可追踪链路。
@@ -94,29 +95,29 @@ flowchart TD
 - 安装时能够访问 GitHub 和 PyPI（Python 公共软件包仓库）。
 - 执行安装命令前，先进入要由 Workflow Loop 管理的项目根目录。
 
-## 安装 0.3.5
+## 安装 0.3.7
 
 安装器先进行只读检查并列出项目侧和电脑侧可能发生的全部持久修改。用户确认一次后，安装器才安装或复用全局 `workflow` 命令，并把智能体契约、产物模板和工作规范写入当前项目；用户取消或安装失败时不会留下只完成一部分的安装。
 
 ### macOS
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.5/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.7/install.sh | bash
 ```
 
 ### Linux
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.5/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.7/install.sh | bash
 ```
 
 ### 原生 Windows
 
 ```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.3.5/install.ps1 | iex"
+powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.3.7/install.ps1 | iex"
 ```
 
-安装命令固定读取 `v0.3.5` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
+安装命令固定读取 `v0.3.7` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
 
 ## 更新与卸载
 
@@ -124,7 +125,7 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/y
 
 ```bash
 workflow update
-workflow update --version 0.3.5
+workflow update --version 0.3.7
 ```
 
 更新按需补齐电脑全局命令和当前项目，只直接覆盖项目根 `AGENTS.md`、`.workflow_loop/Template_Repository/`、`.workflow_loop/Standardized_Repository/`，以及 `.workflow_loop/project.json` 中的安装版本字段。更新不创建备份，不回滚已经完成的步骤；当前轮次状态、历史、回退资料、业务代码和正式产物保持不变。失败后重新执行同一命令即可继续补齐。
@@ -197,6 +198,7 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/y
 | `workflow discuss` | 加载当前环节必须遵守的模板、规范和项目材料 |
 | `workflow gate <stage> --discuss-done` | 通过当前环节的讨论完成门；`<stage>` 表示当前环节标识 |
 | `workflow gate <stage>` | 让程序检查当前环节的文件、结构和可验证事实 |
+| `workflow scaffold` | 为当前环节生成或补齐工作记录表；已填内容不覆盖 |
 | `workflow gate <stage> --confirmed` | 记录用户对当前环节的最终确认并进入下一环节 |
 | `workflow status` | 显示当前轮次、环节、门禁状态和下一步 |
 | `workflow test ...` | 登记统一测试入口、准备测试项或执行受控测试 |
@@ -227,10 +229,10 @@ uv run python -m build
 
 ## 发布正式版本
 
-项目维护者确认当前仓库内容可以直接发布后，在仓库根目录执行下面的命令，并把 `0.3.5` 替换成要发布的新版本号：
+项目维护者确认当前仓库内容可以直接发布后，在仓库根目录执行下面的命令，并把 `0.3.7` 替换成要发布的新版本号：
 
 ```bash
-uv run python scripts/release.py 0.3.5
+uv run python scripts/release.py 0.3.7
 ```
 
 运行这条命令本身就表示维护者接受当前仓库状态并承担跳过本地发布检查的风险。脚本不会再次确认，也不会在本地运行测试、构建或远程版本查询。它依次执行：

{workflow_loop-0.3.5 → workflow_loop-0.3.7}/README.md

@@ -15,6 +15,7 @@ Workflow Loop 把一次软件修改拆成有顺序的工作环节，并用程序
 
 - **保存进度**：在项目的 `.workflow_loop/` 目录保存当前工作环节、确认状态和机器执行记录，下一次对话可以从真实状态继续。
 - **控制推进**：完整研发任务的每个环节依次经过讨论完成、程序检查和用户确认三道门；无需开发任务走独立的讨论、执行、结果确认简单流程。
+- **工作记录表**：程序在环节开始时生成机器可校验的填空表并预填固定事实，AI 只填空位；正式文档由程序按表生成，门禁检查表并检测文档被直接修改，消除格式反复。
 - **一次说明门禁问题**：完整研发门禁失败时，一次列出当前能够独立确认的全部问题；每项写明位置、预期、实际、证据、影响和下一动作，无法可靠判断的项目标为“未检查”并说明依赖。同一状态重复检查时，问题清单和顺序保持一致，要求先修改后再检查。
 - **给出唯一下一步**：每条命令结束时只给出一条完整有效的下一命令，并说明执行者、是否会自动执行测试或其它实际动作、以及成功条件。AI 必须原样执行，不能追加管道、截断、重定向或命令串联。
 - **连接交付证据**：把产品设计、验收条件、测试项、实施记录和最终结果放进同一条可追踪链路。
@@ -75,29 +76,29 @@ flowchart TD
 - 安装时能够访问 GitHub 和 PyPI（Python 公共软件包仓库）。
 - 执行安装命令前，先进入要由 Workflow Loop 管理的项目根目录。
 
-## 安装 0.3.5
+## 安装 0.3.7
 
 安装器先进行只读检查并列出项目侧和电脑侧可能发生的全部持久修改。用户确认一次后，安装器才安装或复用全局 `workflow` 命令，并把智能体契约、产物模板和工作规范写入当前项目；用户取消或安装失败时不会留下只完成一部分的安装。
 
 ### macOS
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.5/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.7/install.sh | bash
 ```
 
 ### Linux
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.5/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.7/install.sh | bash
 ```
 
 ### 原生 Windows
 
 ```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.3.5/install.ps1 | iex"
+powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.3.7/install.ps1 | iex"
 ```
 
-安装命令固定读取 `v0.3.5` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
+安装命令固定读取 `v0.3.7` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
 
 ## 更新与卸载
 
@@ -105,7 +106,7 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/y
 
 ```bash
 workflow update
-workflow update --version 0.3.5
+workflow update --version 0.3.7
 ```
 
 更新按需补齐电脑全局命令和当前项目，只直接覆盖项目根 `AGENTS.md`、`.workflow_loop/Template_Repository/`、`.workflow_loop/Standardized_Repository/`，以及 `.workflow_loop/project.json` 中的安装版本字段。更新不创建备份，不回滚已经完成的步骤；当前轮次状态、历史、回退资料、业务代码和正式产物保持不变。失败后重新执行同一命令即可继续补齐。
@@ -178,6 +179,7 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/y
 | `workflow discuss` | 加载当前环节必须遵守的模板、规范和项目材料 |
 | `workflow gate <stage> --discuss-done` | 通过当前环节的讨论完成门；`<stage>` 表示当前环节标识 |
 | `workflow gate <stage>` | 让程序检查当前环节的文件、结构和可验证事实 |
+| `workflow scaffold` | 为当前环节生成或补齐工作记录表；已填内容不覆盖 |
 | `workflow gate <stage> --confirmed` | 记录用户对当前环节的最终确认并进入下一环节 |
 | `workflow status` | 显示当前轮次、环节、门禁状态和下一步 |
 | `workflow test ...` | 登记统一测试入口、准备测试项或执行受控测试 |
@@ -208,10 +210,10 @@ uv run python -m build
 
 ## 发布正式版本
 
-项目维护者确认当前仓库内容可以直接发布后，在仓库根目录执行下面的命令，并把 `0.3.5` 替换成要发布的新版本号：
+项目维护者确认当前仓库内容可以直接发布后，在仓库根目录执行下面的命令，并把 `0.3.7` 替换成要发布的新版本号：
 
 ```bash
-uv run python scripts/release.py 0.3.5
+uv run python scripts/release.py 0.3.7
 ```
 
 运行这条命令本身就表示维护者接受当前仓库状态并承担跳过本地发布检查的风险。脚本不会再次确认，也不会在本地运行测试、构建或远程版本查询。它依次执行：

{workflow_loop-0.3.5 → workflow_loop-0.3.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "workflow-loop"
-version = "0.3.5"
+version = "0.3.7"
 description = "为 AI 驱动的软件开发提供有状态、可验证、可回退的工作流管理。"
 readme = "README.md"
 requires-python = ">=3.11"

{workflow_loop-0.3.5 → workflow_loop-0.3.7}/src/workflow_loop/__init__.py

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

{workflow_loop-0.3.5 → workflow_loop-0.3.7}/src/workflow_loop/artifact_validation.py

@@ -1873,12 +1873,83 @@ def validate_downstream_traceability(
     return traceability_mod.validate_structure(project_root, workflow_id, topics)
 
 
+def _table_mode_qa(project_root: str, workflow_id: str, topics: list[str]) -> bool:
+    """全部主题都有已填测试工作记录表时，qa 的文档校验走表核对。"""
+    from . import records as records_mod
+
+    if not topics:
+        return False
+    for topic in topics:
+        relative = records_mod.table_relative_path(
+            project_root, workflow_id, "test_plan", topic
+        )
+        if not records_mod.table_exists(project_root, relative):
+            return False
+        try:
+            table = records_mod.load_table(os.path.join(project_root, relative))
+        except records_mod.RecordsError:
+            return False
+        if not (table.get("测试项") or table.get("测试范围说明")):
+            return False
+    return True
+
+
+def _validate_test_plan_from_tables(
+    project_root: str,
+    workflow_id: str,
+    topics: list[str],
+) -> tuple[bool, str]:
+    """表模式：核对每条验收条件在测试计划表中有测试项覆盖。"""
+    import re as _re
+
+    from . import records as records_mod
+    from .topic import topic_paths
+
+    failures: list[str] = []
+    for topic in topics:
+        relative = records_mod.table_relative_path(
+            project_root, workflow_id, "test_plan", topic
+        )
+        table = records_mod.load_table(os.path.join(project_root, relative))
+        rows = table.get("测试项", [])
+        if not rows:
+            # 纯人工主题：自动化验证由最终全量回归承担，验收条件在主题验收人工核对
+            continue
+        coverage: dict[str, int] = {}
+        for row in rows:
+            if not isinstance(row, dict):
+                continue
+            for criterion_id in _re.findall(r"AC-\d+", str(row.get("对应验收条件", ""))):
+                coverage[criterion_id] = coverage.get(criterion_id, 0) + 1
+        acceptance_rel = topic_paths(project_root, topic)["acceptance_plan"]
+        acceptance_full = os.path.join(project_root, acceptance_rel)
+        if not os.path.isfile(acceptance_full):
+            failures.append(f"{topic}：上游验收计划 {acceptance_rel} 不存在")
+            continue
+        criterion_ids = ACCEPTANCE_CRITERION_RE.findall(
+            _read_text(project_root, acceptance_rel)
+        )
+        for criterion_id in criterion_ids:
+            if coverage.get(criterion_id, 0) == 0:
+                failures.append(
+                    f"{topic} 的测试工作记录表没有覆盖 {criterion_id}"
+                )
+    if failures:
+        return False, _format_validation_failures(failures)
+    return True, f"{len(topics)} 个主题的测试计划表覆盖全部验收条件"
+
+
 def validate_test_plan_documents(
     project_root: str,
     workflow_id: str,
     topics: list[str],
 ) -> tuple[bool, str]:
-    """校验测试计划结构，以及每条 AC 到 TC 的覆盖关系。"""
+    """校验测试计划结构，以及每条 AC 到 TC 的覆盖关系。
+
+    全部主题都已填写测试工作记录表时，表是真本，按表核对覆盖关系。
+    """
+    if _table_mode_qa(project_root, workflow_id, topics):
+        return _validate_test_plan_from_tables(project_root, workflow_id, topics)
     qa_index = artifact_paths_mod.QA_INDEX_DOC
     index_path = os.path.join(project_root, qa_index)
     failures: list[str] = []
@@ -2022,7 +2093,49 @@ def _validate_topic_acceptance_result(
     workflow_id: str,
     topic: str,
 ) -> tuple[bool, str]:
-    """校验正式主题验收结果只包含全部通过的当前验收条件。"""
+    """校验正式主题验收结果只包含全部通过的当前验收条件。
+
+    验收结果工作记录表启用时，表是真本：按表核对结论，不读旧文档/状态记录。
+    """
+    from . import records as records_mod
+
+    table_relative = records_mod.table_relative_path(
+        project_root, workflow_id, "acceptance_result", topic
+    )
+    if records_mod.table_exists(project_root, table_relative):
+        table = records_mod.load_table(os.path.join(project_root, table_relative))
+        failures: list[str] = []
+        plan_relative = topic_paths(project_root, topic)["acceptance_plan"]
+        plan_ids = [
+            match.group(1)
+            for match in ACCEPTANCE_CRITERION_RE.finditer(
+                _read_text(project_root, plan_relative)
+                if os.path.isfile(os.path.join(project_root, plan_relative))
+                else ""
+            )
+        ]
+        result_ids = [
+            str(row.get("验收条件编号", "")).strip()
+            for row in table.get("验收结果", [])
+            if isinstance(row, dict) and str(row.get("验收条件编号", "")).strip()
+        ]
+        if plan_ids and result_ids != plan_ids:
+            failures.append(
+                f"{topic} 的验收条件必须与验收计划一致: 计划={plan_ids}, 结果={result_ids}"
+            )
+        for row in table.get("验收结果", []):
+            if not isinstance(row, dict):
+                continue
+            ac = str(row.get("验收条件编号", "")).strip()
+            if str(row.get("验收结论", "")).strip() != "passed":
+                failures.append(f"{topic} / {ac} 验收结论不是 passed")
+            elif not _has_real_text(str(row.get("实际观察结果", ""))):
+                failures.append(f"{topic} / {ac} 缺少实际观察结果")
+            elif not _has_real_text(str(row.get("证据", ""))):
+                failures.append(f"{topic} / {ac} 缺少证据")
+        if failures:
+            return False, _format_validation_failures(failures)
+        return True, f"{topic} 的验收结果表全部通过"
     paths = topic_paths(project_root, topic)
     rel_path = paths["acceptance_result"]
     failures: list[str] = []