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

{workflow_loop-0.3.2/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.2
+Version: 0.3.3
 Summary: 为 AI 驱动的软件开发提供有状态、可验证、可回退的工作流管理。
 Author: yuzyf
 License-Expression: MIT
@@ -90,29 +90,29 @@ flowchart TD
 - 安装时能够访问 GitHub 和 PyPI（Python 公共软件包仓库）。
 - 执行安装命令前，先进入要由 Workflow Loop 管理的项目根目录。
 
-## 安装 0.3.2
+## 安装 0.3.3
 
 安装器先进行只读检查并列出项目侧和电脑侧可能发生的全部持久修改。用户确认一次后，安装器才安装或复用全局 `workflow` 命令，并把智能体契约、产物模板和工作规范写入当前项目；用户取消或安装失败时不会留下只完成一部分的安装。
 
 ### macOS
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.2/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.2/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.2/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.2` 正式发布中的脚本；不会跟随内容可能变化的 `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.2
+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.2` 替换成要发布的新版本号：
+项目维护者确认当前仓库内容可以直接发布后，在仓库根目录执行下面的命令，并把 `0.3.3` 替换成要发布的新版本号：
 
 ```bash
-uv run python scripts/release.py 0.3.2
+uv run python scripts/release.py 0.3.3
 ```
 
 运行这条命令本身就表示维护者接受当前仓库状态并承担跳过本地发布检查的风险。脚本不会再次确认，也不会在本地运行测试、构建或远程版本查询。它依次执行：

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

@@ -71,29 +71,29 @@ flowchart TD
 - 安装时能够访问 GitHub 和 PyPI（Python 公共软件包仓库）。
 - 执行安装命令前，先进入要由 Workflow Loop 管理的项目根目录。
 
-## 安装 0.3.2
+## 安装 0.3.3
 
 安装器先进行只读检查并列出项目侧和电脑侧可能发生的全部持久修改。用户确认一次后，安装器才安装或复用全局 `workflow` 命令，并把智能体契约、产物模板和工作规范写入当前项目；用户取消或安装失败时不会留下只完成一部分的安装。
 
 ### macOS
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.3.2/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.2/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.2/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.2` 正式发布中的脚本；不会跟随内容可能变化的 `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.2
+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.2` 替换成要发布的新版本号：
+项目维护者确认当前仓库内容可以直接发布后，在仓库根目录执行下面的命令，并把 `0.3.3` 替换成要发布的新版本号：
 
 ```bash
-uv run python scripts/release.py 0.3.2
+uv run python scripts/release.py 0.3.3
 ```
 
 运行这条命令本身就表示维护者接受当前仓库状态并承担跳过本地发布检查的风险。脚本不会再次确认，也不会在本地运行测试、构建或远程版本查询。它依次执行：

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

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

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

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

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

@@ -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 "")
 
@@ -1573,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):

{workflow_loop-0.3.2 → 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,