@open-tomato/rafa 0.21.0 → 0.22.0

package/dist/index.js

@@ -20,7 +20,7 @@ import {
   start,
   usage,
   validateManifest
-} from "./index-pzpk59ma.js";
+} from "./index-e30zazs6.js";
 import {
   PLAN_BLOCK_KINDS,
   PLAN_HEADER_FIELDS,
@@ -43,7 +43,7 @@ import {
   openNdjsonStore,
   openSqliteStore,
   selectEffortStore
-} from "./index-am92b8qp.js";
+} from "./index-ae290g0m.js";
 import {
   CONFIG_DEFAULTS,
   CONFIG_FILE,

package/dist/plan-prompt.md

@@ -43,6 +43,12 @@ on the `open-tomato/rafa` board.
   plan guess?
 * Inspect the headers the spec names: are they the ones the dev-planner
   format requires, and does each hold actual content or only placeholders?
+* Inspect whether the spec adds a user-facing command or config key: when it
+  does and carries no `## For the documentation writer` section, report a
+  gap under that heading naming the command or key, always `blocking: false`,
+  with the assumption that the documentation tasks draw their examples from
+  the Design section alone. The section is optional in every other spec, and
+  its absence there is no gap.
 * If any inspection finds a gap, write its heading as it appears in the spec,
   the `what` explaining the gap clearly, `blocking:` for whether it must be
   answered before anything is planned, the `assumption:` you would plan under
@@ -75,7 +81,7 @@ criteria — **do not execute the plan**.
 
 {ROUTING}
 
-{SKILL_INDEX}
+{SKILL_INDEX}{EPIC_CONTEXT}
 
 ## Spec
 

package/dist/templates/epic-guard.yml

@@ -0,0 +1,50 @@
+# The rafa epic guard: an issue belongs to one epic at most.
+#
+# Installed by `rafa init --board --epic-guard`, or by a yes to its own
+# question. When an issue gains an `epic:<slug>` label while it already
+# carries another, this removes the label just added and comments why.
+#
+# The label an issue keeps is the one whose latest add is the oldest,
+# read from the issue's events, so two labels added in one edit leave the
+# same one whichever run reads first. Each run removes only the label its
+# own event added, so no two runs remove the same label or comment twice.
+#
+# rafa never reads this file. `rafa doctor` lists an issue carrying two
+# `epic:` labels whether or not the guard is installed.
+name: Epic guard
+
+on:
+  issues:
+    types: [labeled]
+
+permissions:
+  issues: write
+
+jobs:
+  one-epic:
+    if: startsWith(github.event.label.name, 'epic:')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Keep one epic label
+        shell: bash
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+          ISSUE: ${{ github.event.issue.number }}
+          ADDED: ${{ github.event.label.name }}
+        run: |
+          set -euo pipefail
+          held=$(gh issue view "$ISSUE" --json labels --jq '[.labels[].name | select(startswith("epic:"))]')
+          if [ "$(jq 'length' <<<"$held")" -lt 2 ]; then exit 0; fi
+          if ! jq -e --arg added "$ADDED" 'any(.[]; . == $added)' <<<"$held" >/dev/null; then exit 0; fi
+          kept=$(gh api --paginate "repos/$GH_REPO/issues/$ISSUE/events" \
+              --jq '.[] | select(.event == "labeled") | .label.name' \
+            | jq -R -s -r --argjson held "$held" '
+                split("\n") | map(select(. != "")) | to_entries
+                | map(select(.value as $name | $held | any(.[]; . == $name)))
+                | group_by(.value) | map(max_by(.key)) | min_by(.key)
+                | .value // $held[0]')
+          if [ "$kept" = "$ADDED" ]; then exit 0; fi
+          gh issue edit "$ISSUE" --remove-label "$ADDED"
+          body=$(printf 'This issue already belongs to the epic labelled `%s`, so `%s` was removed: an issue is a member of one epic at most. To move it, remove `%s` first, then add `%s`.' "$kept" "$ADDED" "$kept" "$ADDED")
+          gh issue comment "$ISSUE" --body "$body"

package/dist/templates/spec.md

@@ -35,3 +35,7 @@ assignees: ''
 <!-- One list item per thing that can be shown by a command. "Works well" is not an item; "bun test is green with the new cases" is. -->
 
 -
+
+## For the documentation writer
+
+<!-- Optional: a spec without it is still complete, so delete this heading and comment when you skip it. The examples from the design session, kept for whoever writes the docs later: use cases grouped by situation, from a solo project up to many teams, lightest first; edge cases worth an example; config examples in the same order, from the empty config up; the analogies used; the alternatives rejected, each with its reason. Never tasks: the plan reads this only for its documentation tasks. -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-tomato/rafa",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Alpha. Runs a plan through the ralph loop: one Claude Code session per task, one commit per task, then a pull request and a CI wait.",
   "private": false,
   "publishConfig": {
@@ -48,7 +48,7 @@
     "bun": ">=1.3.14"
   },
   "scripts": {
-    "build": "rm -rf dist && bun build src/rafa.ts --target=bun --outfile=dist/cli.js && bun build src/index.ts src/plan/index.ts src/effort/store/index.ts src/ports/index.ts src/learning/index.ts --target=bun --splitting --root=src --outdir=dist && cp src/PROMPT.md src/plan-prompt.md dist/ && cp -R src/bundled dist/bundled && bun build src/tools/ts-symbols/cli.ts --target=bun --outfile=dist/bundled/bin/ts-symbols && for tree in pr/plans:plans board/templates:templates; do src=src/${tree%:*}; out=dist/${tree#*:}; [ -d \"$src\" ] || continue; mkdir -p \"$out\" && cp \"$src\"/*.md \"$out\"/ || exit 1; done",
+    "build": "rm -rf dist && bun build src/rafa.ts --target=bun --outfile=dist/cli.js && bun build src/index.ts src/plan/index.ts src/effort/store/index.ts src/ports/index.ts src/learning/index.ts --target=bun --splitting --root=src --outdir=dist && cp src/PROMPT.md src/plan-prompt.md dist/ && cp -R src/bundled dist/bundled && bun build src/tools/ts-symbols/cli.ts --target=bun --outfile=dist/bundled/bin/ts-symbols && for tree in pr/plans:plans board/templates:templates; do src=src/${tree%:*}; out=dist/${tree#*:}; [ -d \"$src\" ] || continue; mkdir -p \"$out\" && cp \"$src\"/*.md \"$out\"/ || exit 1; for yml in \"$src\"/*.yml; do [ -e \"$yml\" ] || continue; cp \"$yml\" \"$out\"/ || exit 1; done; done",
     "prepack": "bun run build",
     "test": "bun test",
     "lint": "eslint .",