@plot-pm/board 0.3.0 → 0.3.1-rc.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plot-pm/board",
-  "version": "0.3.0",
+  "version": "0.3.1-rc.0",
   "description": "Local Kanban board for Plot — a glanceable view of plan phases from docs/plans, with sprint and story filters",
   "type": "module",
   "license": "MIT",

package/plot-plan-meta.sh

@@ -62,6 +62,10 @@
 #                  front matter `assignee:`; "" if absent
 #   branches       branch names from the `## Branches` section (backtick-
 #                  quoted, matching the known prefixes; sorted, unique)
+#                  NOTE: per-branch annotations (`<!-- deferred: ... -->`,
+#                  `<!-- claimed: ... -->`) bind to the LINE carrying the
+#                  backticked branch name. An annotation on a wrapped
+#                  continuation line is not seen — keep it on the branch line.
 #   prs            PR numbers from `→ #NNN` links in the `## Branches`
 #                  section (sorted, unique)
 #   review_raw     the plan's review-channel answer as written (`## Status`
@@ -72,6 +76,10 @@
 #   impl           normalized: own-branches|same-branch|other-repo|none|
 #                  UNKNOWN|NONE ("nowhere" is accepted for none; free-text
 #                  like "here, own branches" normalizes by token)
+#   released_raw   the release transition record as written (`## Status`
+#                  `Released:` or front matter `released:` — date and version).
+#                  Empty until /plot-release records it; the tag stays the git
+#                  truth and this merely reflects it.
 #   approved_raw   the approval transition record as written (`## Status`
 #                  `Approved:` or front matter `approved:` — who/when/channel,
 #                  e.g. "2026-07-30, alice, in-session"); "" if absent
@@ -107,7 +115,7 @@ if [ ${#files[@]} -eq 0 ] && [ ${#missing[@]} -eq 0 ]; then
 fi
 
 for f in ${missing[@]+"${missing[@]}"}; do
-  printf '{"file":"%s","format":"none","error":"file not found","phase_raw":"","phase":"NONE","phase_alt_raw":"","phase_alt":"NONE","type":"","title":"","sprint":"","story":"","assignee":"","branches":[],"prs":[],"review_raw":"","review":"NONE","impl_raw":"","impl":"NONE","approved_raw":"","started_raw":[]}\n' \
+  printf '{"file":"%s","format":"none","error":"file not found","phase_raw":"","phase":"NONE","phase_alt_raw":"","phase_alt":"NONE","type":"","title":"","sprint":"","story":"","assignee":"","branches":[],"prs":[],"review_raw":"","review":"NONE","impl_raw":"","impl":"NONE","approved_raw":"","released_raw":"","started_raw":[]}\n' \
     "$(printf '%s' "$f" | sed 's/\\/\\\\/g; s/"/\\"/g')"
 done
 
@@ -179,14 +187,16 @@ function norm_impl(raw,   s) {
 function reset_state() {
   fm_status = ""; fm_phase = ""; fm_type = ""
   fm_title = ""; fm_sprint = ""; fm_story = ""; fm_assignee = ""
-  fm_review = ""; fm_impl = ""; fm_approved = ""; fm_started = ""
+  fm_review = ""; fm_impl = ""; fm_approved = ""; fm_started = ""; fm_released = ""
   canon_phase = ""; canon_type = ""
   canon_sprint = ""; canon_story = ""; canon_assignee = ""
-  canon_review = ""; canon_impl = ""; canon_approved = ""
+  canon_review = ""; canon_impl = ""; canon_approved = ""; canon_released = ""
   h1_title = ""
-  in_fm = 0; section = ""; in_comment = 0
+  in_fm = 0; section = ""; in_comment = 0; branches_seen = 0
   delete branches; n_branches = 0
   delete prs; n_prs = 0
+  delete wave_names; delete wave_of; delete wave_seq; delete wave_count
+  delete deferred_of; delete claimed_of; delete ordered_b; n_waves = 0
   delete started; n_started = 0
 }
 function emit_record(   fmt, praw, palt_raw, traw, title, sprint, story, assignee, review, impl, approved, i, j, out, sorted_b, sorted_p, nb, np) {
@@ -209,6 +219,7 @@ function emit_record(   fmt, praw, palt_raw, traw, title, sprint, story, assigne
   review   = strip_placeholder((fm_review   != "") ? fm_review   : canon_review)
   impl     = strip_placeholder((fm_impl     != "") ? fm_impl     : canon_impl)
   approved = strip_placeholder((fm_approved != "") ? fm_approved : canon_approved)
+  released = strip_placeholder((fm_released != "") ? fm_released : canon_released)
   if (fm_started != "" && strip_placeholder(fm_started) != "") started[++n_started] = fm_started
   # Insertion sort + dedupe (portable: no gawk asort).
   nb = 0
@@ -236,9 +247,25 @@ function emit_record(   fmt, praw, palt_raw, traw, title, sprint, story, assigne
   out = out "],\"prs\":["
   for (i = 1; i <= np; i++) out = out (i > 1 ? "," : "") sorted_p[i]
   out = out "]"
+  # waves[]: branches grouped by `### ` subheading, in document order. A plan
+  # with no subheadings yields one wave with an empty name.
+  out = out ",\"waves\":["
+  for (w = 1; w <= n_waves; w++) {
+    out = out (w > 1 ? "," : "") "{\"name\":\"" jesc(wave_names[w]) "\",\"branches\":["
+    first = 1
+    for (i = 1; i <= n_branches; i++) {
+      if (wave_of[i] != w) continue
+      out = out (first ? "" : ",") "{\"branch\":\"" jesc(ordered_b[i]) "\",\"deferred\":" deferred_of[i] \
+            ",\"claimed\":\"" jesc(claimed_of[i]) "\"}"
+      first = 0
+    }
+    out = out "]}"
+  }
+  out = out "]"
   out = out ",\"review_raw\":\"" jesc(review) "\",\"review\":\"" norm_review(review) "\""
   out = out ",\"impl_raw\":\"" jesc(impl) "\",\"impl\":\"" norm_impl(impl) "\""
   out = out ",\"approved_raw\":\"" jesc(approved) "\""
+  out = out ",\"released_raw\":\"" jesc(released) "\""
   out = out ",\"started_raw\":["
   for (i = 1; i <= n_started; i++) out = out (i > 1 ? "," : "") "\"" jesc(started[i]) "\""
   out = out "]}"
@@ -264,6 +291,7 @@ in_fm {
   else if (lower ~ /^review:/ && fm_review == "") fm_review = val_after_colon($0)
   else if (lower ~ /^impl:/ && fm_impl == "") fm_impl = val_after_colon($0)
   else if (lower ~ /^approved:/ && fm_approved == "") fm_approved = val_after_colon($0)
+  else if (lower ~ /^released:/ && fm_released == "") fm_released = val_after_colon($0)
   else if (lower ~ /^started:/ && fm_started == "") fm_started = val_after_colon($0)
   next
 }
@@ -275,7 +303,9 @@ in_comment { if ($0 ~ /-->/) in_comment = 0; next }
 /^#[ \t]/ && h1_title == "" { h1_title = trim(substr($0, 2)) }
 /^## / {
   if ($0 ~ /^## Status/) section = "status"
-  else if ($0 ~ /^## Branches/) section = "branches"
+  # First `## Branches` wins: a plan documenting the plan format quotes the
+  # section in prose, and those later headings are illustration, not contract.
+  else if ($0 ~ /^## Branches/) { section = branches_seen ? "" : "branches"; branches_seen = 1 }
   else if ($0 ~ /^## Approval/) section = "approval"
   else section = ""
   next
@@ -289,6 +319,7 @@ section == "status" {
   else if (lower ~ /^[ \t]*[-*]?[ \t]*\**review[:*]/ && canon_review == "") canon_review = val_after_colon($0)
   else if (lower ~ /^[ \t]*[-*]?[ \t]*\**impl[:*]/ && canon_impl == "") canon_impl = val_after_colon($0)
   else if (lower ~ /^[ \t]*[-*]?[ \t]*\**approved[:*]/ && canon_approved == "") canon_approved = val_after_colon($0)
+  else if (lower ~ /^[ \t]*[-*]?[ \t]*\**released[:*]/ && canon_released == "") canon_released = val_after_colon($0)
   else if (lower ~ /^[ \t]*[-*]?[ \t]*\**started[:*]/) {
     _s = strip_placeholder(val_after_colon($0))
     if (_s != "") started[++n_started] = _s
@@ -301,10 +332,35 @@ section == "approval" {
   next
 }
 section == "branches" {
+  # `### <name>` opens a wave. Branches before any subheading belong to an
+  # unnamed wave, so a pre-wave plan parses as exactly one wave.
+  if ($0 ~ /^###[ \t]/) {
+    wave_names[++n_waves] = trim(substr($0, 4))
+    next
+  }
+  # Claim reflection, written by the worker after its ref push succeeds. This is
+  # a reflection, not the claim: git refs remain authoritative. Computed before
+  # the branch loop below — match() clobbers RSTART/RLENGTH, which that loop
+  # needs to advance.
+  claim_note = ""
+  if (index($0, "claimed:") > 0) {
+    _c = $0
+    sub(/^.*<!--[ \t]*claimed:[ \t]*/, "", _c)
+    sub(/[ \t]*-->.*$/, "", _c)
+    claim_note = trim(_c)
+  }
   line = $0
   while (match(line, branch_re)) {
     b = substr(line, RSTART + 1, RLENGTH - 2)
     branches[++n_branches] = b
+    if (n_waves == 0) { wave_names[++n_waves] = "" }
+    wave_of[n_branches] = n_waves
+    wave_seq[n_branches] = ++wave_count[n_waves]
+    deferred_of[n_branches] = ($0 ~ /<!--[ \t]*deferred:/) ? "true" : "false"
+    # Claim reflection, written by the worker after its ref push succeeds. This
+    # is a reflection, not the claim: git refs remain authoritative.
+    claimed_of[n_branches] = claim_note
+    ordered_b[n_branches] = b
     line = substr(line, RSTART + RLENGTH)
   }
   line = $0