workflow-loop 0.3.1__tar.gz → 0.3.3__tar.gz

{workflow_loop-0.3.1/src/workflow_loop.egg-info → workflow_loop-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workflow-loop
-Version: 0.3.1
+Version: 0.3.3
 Summary: 为 AI 驱动的软件开发提供有状态、可验证、可回退的工作流管理。
 Author: yuzyf
 License-Expression: MIT
@@ -90,29 +90,29 @@ flowchart TD
 - 安装时能够访问 GitHub 和 PyPI（Python 公共软件包仓库）。
 - 执行安装命令前，先进入要由 Workflow Loop 管理的项目根目录。
 
-## 安装 0.3.1
+## 安装 0.3.3
 
 安装器先进行只读检查并列出项目侧和电脑侧可能发生的全部持久修改。用户确认一次后，安装器才安装或复用全局 `workflow` 命令，并把智能体契约、产物模板和工作规范写入当前项目；用户取消或安装失败时不会留下只完成一部分的安装。
 
 ### macOS
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.1/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.3/install.sh | bash
 ```
 
 ### Linux
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.1/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.3/install.sh | bash
 ```
 
 ### 原生 Windows
 
 ```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.3.1/install.ps1 | iex"
+powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.3.3/install.ps1 | iex"
 ```
 
-安装命令固定读取 `v0.3.1` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
+安装命令固定读取 `v0.3.3` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
 
 ## 更新与卸载
 
@@ -120,7 +120,7 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/y
 
 ```bash
 workflow update
-workflow update --version 0.3.1
+workflow update --version 0.3.3
 ```
 
 更新按需补齐电脑全局命令和当前项目，只直接覆盖项目根 `AGENTS.md`、`.workflow_loop/Template_Repository/`、`.workflow_loop/Standardized_Repository/`，以及 `.workflow_loop/project.json` 中的安装版本字段。更新不创建备份，不回滚已经完成的步骤；当前轮次状态、历史、回退资料、业务代码和正式产物保持不变。失败后重新执行同一命令即可继续补齐。
@@ -223,10 +223,10 @@ uv run python -m build
 
 ## 发布正式版本
 
-项目维护者确认当前仓库内容可以直接发布后，在仓库根目录执行下面的命令，并把 `0.3.1` 替换成要发布的新版本号：
+项目维护者确认当前仓库内容可以直接发布后，在仓库根目录执行下面的命令，并把 `0.3.3` 替换成要发布的新版本号：
 
 ```bash
-uv run python scripts/release.py 0.3.1
+uv run python scripts/release.py 0.3.3
 ```
 
 运行这条命令本身就表示维护者接受当前仓库状态并承担跳过本地发布检查的风险。脚本不会再次确认，也不会在本地运行测试、构建或远程版本查询。它依次执行：
@@ -258,8 +258,7 @@ workflow_loop/
 ├── update.ps1             Windows 旧版本更新脚本
 ├── uninstall.sh           macOS 和 Linux 旧版本卸载脚本
 ├── uninstall.ps1          Windows 旧版本卸载脚本
-├── CONTEXT.md             产品术语、规则和限制
-└── DESIGN.md              实现设计文档
+└── docs/adr/              已经发生的架构决策及其取代关系
 ```
 
 ## 详细文档
@@ -271,8 +270,8 @@ workflow_loop/
 - [发布正式版本](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.3.1 → workflow_loop-0.3.3}/README.md

@@ -71,29 +71,29 @@ flowchart TD
 - 安装时能够访问 GitHub 和 PyPI（Python 公共软件包仓库）。
 - 执行安装命令前，先进入要由 Workflow Loop 管理的项目根目录。
 
-## 安装 0.3.1
+## 安装 0.3.3
 
 安装器先进行只读检查并列出项目侧和电脑侧可能发生的全部持久修改。用户确认一次后，安装器才安装或复用全局 `workflow` 命令，并把智能体契约、产物模板和工作规范写入当前项目；用户取消或安装失败时不会留下只完成一部分的安装。
 
 ### macOS
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.1/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.3/install.sh | bash
 ```
 
 ### Linux
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.1/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.3/install.sh | bash
 ```
 
 ### 原生 Windows
 
 ```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.3.1/install.ps1 | iex"
+powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.3.3/install.ps1 | iex"
 ```
 
-安装命令固定读取 `v0.3.1` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
+安装命令固定读取 `v0.3.3` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
 
 ## 更新与卸载
 
@@ -101,7 +101,7 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/y
 
 ```bash
 workflow update
-workflow update --version 0.3.1
+workflow update --version 0.3.3
 ```
 
 更新按需补齐电脑全局命令和当前项目，只直接覆盖项目根 `AGENTS.md`、`.workflow_loop/Template_Repository/`、`.workflow_loop/Standardized_Repository/`，以及 `.workflow_loop/project.json` 中的安装版本字段。更新不创建备份，不回滚已经完成的步骤；当前轮次状态、历史、回退资料、业务代码和正式产物保持不变。失败后重新执行同一命令即可继续补齐。
@@ -204,10 +204,10 @@ uv run python -m build
 
 ## 发布正式版本
 
-项目维护者确认当前仓库内容可以直接发布后，在仓库根目录执行下面的命令，并把 `0.3.1` 替换成要发布的新版本号：
+项目维护者确认当前仓库内容可以直接发布后，在仓库根目录执行下面的命令，并把 `0.3.3` 替换成要发布的新版本号：
 
 ```bash
-uv run python scripts/release.py 0.3.1
+uv run python scripts/release.py 0.3.3
 ```
 
 运行这条命令本身就表示维护者接受当前仓库状态并承担跳过本地发布检查的风险。脚本不会再次确认，也不会在本地运行测试、构建或远程版本查询。它依次执行：
@@ -239,8 +239,7 @@ workflow_loop/
 ├── update.ps1             Windows 旧版本更新脚本
 ├── uninstall.sh           macOS 和 Linux 旧版本卸载脚本
 ├── uninstall.ps1          Windows 旧版本卸载脚本
-├── CONTEXT.md             产品术语、规则和限制
-└── DESIGN.md              实现设计文档
+└── docs/adr/              已经发生的架构决策及其取代关系
 ```
 
 ## 详细文档
@@ -252,8 +251,8 @@ workflow_loop/
 - [发布正式版本](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.3.1 → workflow_loop-0.3.3}/pyproject.toml

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

{workflow_loop-0.3.1 → workflow_loop-0.3.3}/src/workflow_loop/__init__.py

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

{workflow_loop-0.3.1 → workflow_loop-0.3.3}/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,10 +85,8 @@ 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)
@@ -106,9 +111,9 @@ 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:

{workflow_loop-0.3.1 → workflow_loop-0.3.3}/src/workflow_loop/artifact_validation.py

@@ -11,6 +11,7 @@ from . import artifact_paths as artifact_paths_mod
 from . import process_runner as process_runner_mod
 from . import test_runner as test_runner_mod
 from . import state as state_mod
+from . import traceability as traceability_mod
 from .state import load_state
 from .test_mapping import (
     automated_topics,
@@ -18,7 +19,6 @@ from .test_mapping import (
     parse_test_plan_items,
 )
 from .topic import topic_file_key, topic_paths
-from .traceability import validate_structure as validate_traceability_structure
 from .topic_relations import relation_signature, read_topic_index
 from .verification import (
     compute_code_snapshot_hash,
@@ -86,6 +86,33 @@ def _field(content: str, label: str) -> str | None:
     return match.group(1).strip() if match else None
 
 
+def _missing_fixed_field_reason(
+    content: str,
+    label: str,
+    *,
+    next_field_means_misplaced_value: bool = False,
+) -> str:
+    """说明固定字段缺值的真实格式原因，不把换行误说成普通空值。"""
+    field_line = re.search(
+        rf"^-[ \t]*{re.escape(label)}：[ \t]*(?P<value>[^\r\n]*)$",
+        content,
+        re.MULTILINE,
+    )
+    if field_line is None:
+        return "缺少具体内容；原因：缺少标签"
+    if field_line.group("value").strip():
+        return "缺少具体内容"
+
+    following = content[field_line.end() :].splitlines()
+    next_content = next((line.strip() for line in following if line.strip()), "")
+    if next_content and (
+        next_field_means_misplaced_value
+        or not re.match(r"^-[ \t]*[^：]+：", next_content)
+    ):
+        return "值必须写在标签同一行，下一行内容不会被读取"
+    return "标签同一行没有值，缺少具体内容"
+
+
 def _argv_text(argv: list[str]) -> str:
     """把参数数组编码成可读且可精确比对的单行 JSON。"""
     return json.dumps(argv, ensure_ascii=False, separators=(",", ":"))
@@ -1444,7 +1471,15 @@ def validate_reproduce_documents(
             failures.append(f"{filename} 必须写“根因状态：已确认”")
         topic = _field(content, "验收主题")
         if not _is_safe_topic_name(topic):
-            failures.append(f"{filename} 必须写清唯一验收主题")
+            reason = _missing_fixed_field_reason(
+                content,
+                "验收主题",
+                next_field_means_misplaced_value=True,
+            )
+            if topic is None:
+                failures.append(f"{filename}“验收主题”字段：{reason}")
+            else:
+                failures.append(f"{filename} 必须写清唯一验收主题")
         else:
             topics.append(topic or "")
 
@@ -1491,7 +1526,7 @@ def validate_acceptance_plan_documents(
     if not index_ok:
         issues.append(f"{artifact_paths_mod.ACCEPTANCE_INDEX_DOC}：{index_detail}")
 
-    traceability_ok, traceability_detail = validate_traceability_structure(
+    traceability_ok, traceability_detail = traceability_mod.validate_structure(
         project_root,
         workflow_id,
         topics,
@@ -1502,19 +1537,21 @@ def validate_acceptance_plan_documents(
 
     traceability_full_path = os.path.join(project_root, TRACEABILITY_PATH)
     traceability_rows: list[list[str]] = []
+    traceability_headers: list[str] | None = None
     if os.path.isfile(traceability_full_path):
         traceability_content = _read_text(project_root, TRACEABILITY_PATH)
         workflow_content = _workflow_section(traceability_content, workflow_id)
         if workflow_content is None:
             issues.append(f"{TRACEABILITY_PATH}：缺少当前工作流章节 {workflow_id}")
         else:
-            traceability_rows = [
-                row
-                for row in _markdown_table_rows(workflow_content)
-                if len(row) == 9 and row[0] != "需求来源与设计依据"
-            ]
+            for headers, table_rows in _markdown_tables(workflow_content):
+                if headers not in traceability_mod.SUPPORTED_HEADERS:
+                    continue
+                traceability_headers = headers
+                traceability_rows = table_rows
+                break
             if not traceability_rows:
-                issues.append(f"{TRACEABILITY_PATH}：当前工作流章节没有九列交付链路记录")
+                issues.append(f"{TRACEABILITY_PATH}：当前工作流章节没有受支持的交付链路记录")
     elif traceability_ok:
         issues.append(f"{TRACEABILITY_PATH}：文件不存在")
 
@@ -1526,9 +1563,6 @@ def validate_acceptance_plan_documents(
         "通过标准",
         "不通过标准",
         "产品设计依据",
-        # 旧版字段在迁移期继续要求，确保旧校验器和正式文档含义一致。
-        "条件与触发",
-        "预期结果",
     )
     placeholder_values = {
         "待补充", "待确认", "待定", "todo", "tbd", "正常", "符合预期", "正确处理",
@@ -1574,7 +1608,10 @@ def validate_acceptance_plan_documents(
             for label in required_fields:
                 value = _field(criterion_content, label)
                 if value is None or not value.strip():
-                    issues.append(f"{rel_path} {criterion_id}“{label}”字段：缺少具体内容")
+                    issues.append(
+                        f"{rel_path} {criterion_id}“{label}”字段："
+                        f"{_missing_fixed_field_reason(criterion_content, label)}"
+                    )
                     continue
                 normalized = re.sub(r"[\s`*_.。,，:：;；!?！？()（）\[\]{}]", "", value or "").lower()
                 if normalized in placeholder_values or not _has_real_text(value):
@@ -1596,10 +1633,15 @@ def validate_acceptance_plan_documents(
             all_criteria.append(f"{topic}:{criterion_id}")
             if not traceability_rows:
                 continue
+            if traceability_headers is None:
+                continue
+            topic_column = traceability_headers.index("验收主题")
+            criterion_column = traceability_headers.index("验收条件")
             matching_rows = [
                 row
                 for row in traceability_rows
-                if paths["acceptance_plan"] in row[1] and criterion_id in row[2]
+                if paths["acceptance_plan"] in row[topic_column]
+                and criterion_id in row[criterion_column]
             ]
             if len(matching_rows) != 1:
                 issues.append(
@@ -1607,13 +1649,34 @@ def validate_acceptance_plan_documents(
                 )
                 continue
             row = matching_rows[0]
-            expected_statuses = ["待制定", "待制定", "待执行", "待执行", "待执行", "待更新"]
-            if row[3:] != expected_statuses:
+            expected_statuses = {
+                "测试项": "待制定",
+                "实施计划与任务": "待制定",
+                "实施记录与代码": "待执行",
+                "测试结果": "待执行",
+                "验收结果": "待执行",
+                "更新后的代码设计": "待更新",
+            }
+            actual_statuses = {
+                header: row[traceability_headers.index(header)]
+                for header in expected_statuses
+            }
+            if actual_statuses != expected_statuses:
                 issues.append(
-                    f"{TRACEABILITY_PATH} 主题“{topic}”{criterion_id} 后续六列："
-                    f"预期 {expected_statuses}，实际 {row[3:]}"
+                    f"{TRACEABILITY_PATH} 主题“{topic}”{criterion_id} 后续状态列："
+                    f"预期 {expected_statuses}，实际 {actual_statuses}"
                 )
 
+    if traceability_headers is not None and "穿刺结论与可复用内容" in traceability_headers:
+        try:
+            traceability_mod.collect_spike_asset_acceptance_links(
+                project_root,
+                workflow_id,
+                topics,
+            )
+        except ValueError as exc:
+            issues.append(f"{TRACEABILITY_PATH} 穿刺结论与可复用内容：{exc}")
+
     if issues:
         return False, "\n".join(
             f"{index}. {issue}" for index, issue in enumerate(dict.fromkeys(issues), start=1)
@@ -1807,7 +1870,7 @@ def validate_downstream_traceability(
     topics: list[str],
 ) -> tuple[bool, str]:
     """后续阶段共用的追踪表门禁，不要求测试计划正文结构。"""
-    return validate_traceability_structure(project_root, workflow_id, topics)
+    return traceability_mod.validate_structure(project_root, workflow_id, topics)
 
 
 def validate_test_plan_documents(
@@ -2033,7 +2096,7 @@ def _validate_topic_acceptance_result(
         method = _field(criterion_content, "验收方式")
         if method not in valid_methods or method != methods.get(criterion_id):
             failures.append(f"{rel_path} 的 {criterion_id} 验收方式不合法")
-        for label in ("验收条件", "自动化依据", "实际结果", "验收证据", "程序记录"):
+        for label in ("验收条件", "自动化依据", "实际结果", "验收证据", "验收记录编号"):
             if not _has_real_text(_field(criterion_content, label)):
                 failures.append(f"{rel_path} 的 {criterion_id} 缺少具体“{label}”")
         if _field(criterion_content, "判定") != "通过":
@@ -2043,8 +2106,8 @@ def _validate_topic_acceptance_result(
                 failures.append(f"{rel_path} 的 {criterion_id} 实际结果与程序记录不一致")
             if _field(criterion_content, "验收证据") != record.evidence:
                 failures.append(f"{rel_path} 的 {criterion_id} 验收证据与程序记录不一致")
-            if _field(criterion_content, "程序记录") != record.record_id:
-                failures.append(f"{rel_path} 的 {criterion_id} 程序记录编号不一致")
+            if _field(criterion_content, "验收记录编号") != record.record_id:
+                failures.append(f"{rel_path} 的 {criterion_id} 验收记录编号不一致")
         else:
             failures.append(
                 _unchecked(
@@ -2332,9 +2395,10 @@ def validate_test_execution_results(
     state = load_state(project_root)
     if state is None or state.workflow_id != workflow_id:
         return False, "找不到当前工作流的测试执行状态"
-    stage_state = state.stages.get("test_execution")
+    # 新流程把任务和机器记录统一保存在 qa；旧轮次仍读取 test_execution。
+    stage_state = state.stages.get("qa") or state.stages.get("test_execution")
     if stage_state is None:
-        return False, "缺少 test_execution（测试执行阶段）状态，正式结果必须来自真实执行记录"
+        return False, "缺少 qa（测试验证）或旧 test_execution 状态，正式结果必须来自真实执行记录"
     for topic in automated:
         topic_items = [item for item in automated_items if item.topic == topic]
         test_ok, test_detail = _validate_topic_test_execution_result(

{workflow_loop-0.3.1 → workflow_loop-0.3.3}/src/workflow_loop/bug_record.py

@@ -12,8 +12,9 @@ from .topic import topic_paths
 
 BUG_DIR = "bug"
 BUG_INDEX = artifact_paths_mod.BUG_INDEX_DOC
-WORKFLOW_RE = re.compile(r"^-\s*工作流编号：\s*(.+?)\s*$", re.MULTILINE)
-TOPIC_RE = re.compile(r"^-\s*验收主题：\s*(.+?)\s*$", re.MULTILINE)
+# 固定字段的空白只允许在同一行；``\s*`` 会吞掉换行，导致下一字段被误读。
+WORKFLOW_RE = re.compile(r"^-[ \t]*工作流编号：[ \t]*([^\r\n]+?)[ \t]*$", re.MULTILINE)
+TOPIC_RE = re.compile(r"^-[ \t]*验收主题：[ \t]*([^\r\n]+?)[ \t]*$", re.MULTILINE)
 RESULT_SECTION_RE = re.compile(
     r"^##\s+8\.\s*修复与验收结果\s*$\n(.*?)(?=^##\s+|\Z)",
     re.MULTILINE | re.DOTALL,