@tianhai/pi-workflow-kit 2.6.0 → 2.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tianhai/pi-workflow-kit",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "Enforce structured design→execute→finalize workflow with TDD discipline in AI coding agents",
   "keywords": [
     "pi-package",

package/skills/pwk-executing-tasks/SKILL.md

@@ -179,8 +179,11 @@ key files capped `at 5`.
 
 ```markdown
 # Progress: <topic>
+
 Design: docs/plans/<date>-<topic>/<leaf>-design.md
+
 Feature phase: e2e-written
+
 ## Requirements
 | # | Done | Requirement | Per-req ceremony | Commit |
 ## Execution summary

package/skills/pwk-executing-tasks/references/progress-format.md

@@ -2,16 +2,21 @@
 
 Read before creating or changing progress rows, or writing/re-presenting the code digest. This reference owns the unchanged progress artifact schema.
 
-2. **Create the progress file** `docs/plans/<date>-<topic>/<leaf>-progress.md`, beside the design doc it belongs to (`<leaf>` is `<topic>` for a single-part topic; an umbrella part uses its roster slug), so `pwk-finalizing` finds it inside the topic folder:
+2. **Create the progress file** `docs/plans/<date>-<topic>/<leaf>-progress.md`, beside the design doc it belongs to (`<leaf>` is `<topic>` for a single-part topic; an umbrella part uses its roster slug), so `pwk-finalizing` finds it inside the topic folder. Keep the blank lines between the header fields: the blank lines are load-bearing, because CommonMark merges consecutive plain lines into one paragraph, so without them every preview renders the whole header as a single run-on line.
 
    ```markdown
    # Progress: <topic>
 
    Design: docs/plans/<date>-<topic>/<leaf>-design.md
+
    Branch: <branch>
+
    Setup: n/a
+
    Started: <ISO timestamp>
+
    Last updated: <ISO timestamp>
+
    Feature phase: e2e-written
 
    <!-- a trivial design doc (no `## Feature acceptance`) starts at `implementing (0/N)` instead — there is no E2E to write -->

package/skills/pwk-executing-tasks/scripts/build-review-packet.py

@@ -266,7 +266,9 @@ def build(args):
         ('Diff', git(project, 'diff', '--no-ext-diff', '--no-textconv', '--no-color', span, *pathspec)),
     ]
     label = 'feature review' if args.scope == 'feature' else f'requirement R{args.requirement} review'
-    packet = f'# Review packet: {design_path.parent.name} — {label}\n\nBase: {base}\nHead: {head}\n\n'
+    # The blank line between Base and Head is load-bearing: CommonMark merges
+    # consecutive plain lines into one paragraph in every preview.
+    packet = f'# Review packet: {design_path.parent.name} — {label}\n\nBase: {base}\n\nHead: {head}\n\n'
     for title, content in sections:
         packet += f'## {title}\n\n{content}\n'
     # All parsing and Git reads finish before a temporary file exists. A failure in