@pieerry/harness-kit 3.1.1 → 3.3.0

package/.claude/scripts/activity.py

@@ -0,0 +1,68 @@
+#!/usr/bin/env python3
+"""Live activity tracker for the status bar.
+
+Writes the current sensor/eval/guide being touched to .claude/.activity so
+status-line.sh can surface it. Auto-expires after 60s to avoid stale state
+if a hook crashes before clearing.
+
+Subcommands:
+  set <kind> <name>   record kind+name (kind: sensor|eval|guide)
+  clear               remove activity file
+  read                print one-line "kind: name" (or empty if stale/absent)
+"""
+
+import json
+import sys
+import time
+from pathlib import Path
+
+ACTIVITY_FILE = Path(".claude/.activity")
+TTL_SECONDS = 60
+
+
+def cmd_set(args):
+    if len(args) < 2:
+        return 1
+    kind, name = args[0], args[1]
+    if kind not in ("sensor", "eval", "guide"):
+        return 1
+    ACTIVITY_FILE.parent.mkdir(parents=True, exist_ok=True)
+    ACTIVITY_FILE.write_text(json.dumps({"kind": kind, "name": name, "ts": time.time()}))
+    return 0
+
+
+def cmd_clear(_args):
+    if ACTIVITY_FILE.exists():
+        ACTIVITY_FILE.unlink()
+    return 0
+
+
+def cmd_read(_args):
+    if not ACTIVITY_FILE.exists():
+        return 0
+    try:
+        d = json.loads(ACTIVITY_FILE.read_text())
+    except (json.JSONDecodeError, OSError):
+        return 0
+    if time.time() - d.get("ts", 0) > TTL_SECONDS:
+        try:
+            ACTIVITY_FILE.unlink()
+        except OSError:
+            pass
+        return 0
+    print(f"{d.get('kind', '?')}: {d.get('name', '?')}")
+    return 0
+
+
+COMMANDS = {"set": cmd_set, "clear": cmd_clear, "read": cmd_read}
+
+
+def main():
+    if len(sys.argv) < 2 or sys.argv[1] not in COMMANDS:
+        print(__doc__, file=sys.stderr)
+        return 2
+    return COMMANDS[sys.argv[1]](sys.argv[2:])
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/.claude/scripts/pipeline.py

@@ -162,6 +162,16 @@ def render_line():
     next_cmd = STAGE_TO_COMMAND.get(current, "?")
 
     shape = "+".join(pipeline)
+
+    # No work started yet: show full menu instead of locking to next stage
+    no_work_started = (
+        not fid
+        and not prev
+        and all(stages.get(s) == "pending" for s in pipeline)
+    )
+    if no_work_started:
+        return f"{name} [{shape}] · /product-manager:run · /sse:run · /pipeline:continue · /pipeline:reset"
+
     if prev:
         return f"{name} [{shape}] · {prev} approved · {current} {cur_state} · next {next_cmd}"
     return f"{name} [{shape}] · {current} {cur_state} · next {next_cmd}"

package/.claude/scripts/pr-monitor.py

@@ -0,0 +1,113 @@
+#!/usr/bin/env python3
+"""PR-merge monitor state for harness-kit.
+
+Tracks the PR being watched and the polling cadence. Stored at
+.claude/.pr-monitor-state.json relative to repo root.
+
+Polling schedule: 3 -> 6 -> 12 -> 24 -> 30 minutes (cap). Bumps to next rung
+after 5 attempts at the current interval. Stays at 30 once reached.
+
+Subcommands:
+  init <pr_number> <pr_url> <branch>   create state, interval=3min
+  bump                                  +1 attempt, escalate if 5 hit;
+                                        prints next interval in seconds
+  read                                  print state JSON
+  clear                                 remove state file
+"""
+
+import json
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+
+STATE_FILE = Path(".claude/.pr-monitor-state.json")
+START_MIN = 3
+CAP_MIN = 30
+ATTEMPTS_PER_RUNG = 5
+
+
+def now_iso():
+    return datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+
+def load():
+    if not STATE_FILE.exists():
+        return None
+    try:
+        return json.loads(STATE_FILE.read_text())
+    except (json.JSONDecodeError, OSError):
+        return None
+
+
+def save(state):
+    state["updated_at"] = now_iso()
+    STATE_FILE.parent.mkdir(parents=True, exist_ok=True)
+    STATE_FILE.write_text(json.dumps(state, indent=2) + "\n")
+
+
+def cmd_init(args):
+    if len(args) < 3:
+        print("usage: pr-monitor.py init <pr_number> <pr_url> <branch>", file=sys.stderr)
+        return 1
+    state = {
+        "pr_number": int(args[0]),
+        "pr_url": args[1],
+        "branch": args[2],
+        "current_interval_min": START_MIN,
+        "attempts_at_interval": 0,
+        "total_attempts": 0,
+        "started_at": now_iso(),
+        "updated_at": now_iso(),
+    }
+    save(state)
+    print(START_MIN * 60)
+    return 0
+
+
+def cmd_bump(_args):
+    state = load()
+    if not state:
+        print("no state", file=sys.stderr)
+        return 1
+    state["attempts_at_interval"] += 1
+    state["total_attempts"] += 1
+    if (
+        state["attempts_at_interval"] >= ATTEMPTS_PER_RUNG
+        and state["current_interval_min"] < CAP_MIN
+    ):
+        state["current_interval_min"] = min(state["current_interval_min"] * 2, CAP_MIN)
+        state["attempts_at_interval"] = 0
+    save(state)
+    print(state["current_interval_min"] * 60)
+    return 0
+
+
+def cmd_read(_args):
+    state = load()
+    print(json.dumps(state or {}, indent=2))
+    return 0
+
+
+def cmd_clear(_args):
+    if STATE_FILE.exists():
+        STATE_FILE.unlink()
+    return 0
+
+
+COMMANDS = {
+    "init": cmd_init,
+    "bump": cmd_bump,
+    "read": cmd_read,
+    "clear": cmd_clear,
+}
+
+
+def main():
+    if len(sys.argv) < 2 or sys.argv[1] not in COMMANDS:
+        print(__doc__, file=sys.stderr)
+        return 2
+    return COMMANDS[sys.argv[1]](sys.argv[2:])
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/.claude/scripts/stage-card.md

@@ -9,17 +9,20 @@ The card is part of the LLM's output, not a hook. Hooks update the status bar;
 this card explains what the stage is about to do (or just did) in human-readable
 form.
 
+Render the card **outside** a code fence so markdown bold renders. Two visual
+weights: bold labels, plain values. No extra colors.
+
 ## Header card
 
 Printed before drafting begins. Lists what will be loaded and what comes next.
 
-```
+```text
 ━━━ {command} · {feature_id}{area_suffix} ━━━
-guides:   {guide-1.md}, {guide-2.md}, ...
-refs:     {ref-1.md}, {ref-2.md}, ...
-sensors:  {sensor-name}, {sensor-name}, ...
-eval:     {eval-name}
-next:     {/next:command}
+**guides:**  {guide-1.md}, {guide-2.md}, ...
+**refs:**    {ref-1.md}, {ref-2.md}, ...
+**sensors:** {sensor-name}, {sensor-name}, ...
+**eval:**    {eval-name}
+**next:**    {/next:command}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
@@ -28,47 +31,47 @@ empty otherwise.
 
 ## Footer card
 
-Printed after the artifact is saved and gates ran. Shows pass/fail and score.
+Printed after the artifact is saved and gates ran. Shows pass/fail, eval score,
+and token spend for the phase.
 
-```
+```text
 ━━━ done · {command} ━━━
-artifact: {relative/output/path.md}
-sensors:  {pass | failed: name1, name2}
-eval:     {N}/10
-next:     {/next:command | (pipeline complete)}
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+**artifact:** {relative/output/path.md}
+**sensors:**  {pass | failed: name1, name2}
+**eval:**     {N}/10
+**tokens:**   in={N} out={N} cache_r={N}
+**next:**     {/next:command | (pipeline complete)}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
-## Examples
+Pull token totals from `outputs/tokens/{feature_id}.json` (`totals` block).
+Skip the tokens line if the file is absent.
+
+## Examples (rendered output)
 
-```
 ━━━ /product-manager:prd · 2026-05-13-billing-multi-currency ━━━
-guides:   prd-guidelines.md, writing-style.md
-refs:     business-info.md, squads/billing/context.md
-sensors:  prd-structure, prd-acceptance-criteria
-eval:     prd-quality
-next:     /product-manager:prp
+**guides:**  prd-guidelines.md, writing-style.md
+**refs:**    business-info.md, squads/billing/context.md
+**sensors:** prd-structure, prd-acceptance-criteria
+**eval:**    prd-quality
+**next:**    /product-manager:prp
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-```
 
-```
 ━━━ done · /product-manager:prd ━━━
-artifact: outputs/prd/2026-05-13-billing-multi-currency.md
-sensors:  pass
-eval:     8.6/10
-next:     /product-manager:prp
+**artifact:** outputs/prd/2026-05-13-billing-multi-currency.md
+**sensors:**  pass
+**eval:**     8.6/10
+**tokens:**   in=12.4k out=3.1k cache_r=42.0k
+**next:**     /product-manager:prp
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-```
 
-```
 ━━━ /sse:plan · 2026-05-13-billing-multi-currency · backend ━━━
-guides:   pipeline.md, coding-style.md, skills/backend/SKILL.md
-refs:     prp/2026-05-13-billing-multi-currency.md, conventions/backend.md
-sensors:  plan-structure
-eval:     plan-quality
-next:     /sse:dev
+**guides:**  pipeline.md, coding-style.md, skills/backend/SKILL.md
+**refs:**    prp/2026-05-13-billing-multi-currency.md, conventions/backend.md
+**sensors:** plan-structure
+**eval:**    plan-quality
+**next:**    /sse:dev
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-```
 
 Keep the card terse. List filenames only (no full paths). Skip a line that has
 no entries.

package/.claude/settings.json

@@ -0,0 +1,74 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git:*)",
+      "Bash(./gradlew:*)",
+      "Bash(./mvnw:*)",
+      "Bash(npm:*)",
+      "Bash(gh:*)",
+      "Bash(jq:*)",
+      "Read(outputs/**)",
+      "Write(outputs/**)"
+    ],
+    "deny": [
+      "Bash(rm -rf:*)",
+      "Bash(git push --force:*)",
+      "Bash(git push -f:*)",
+      "Bash(git reset --hard:*)"
+    ]
+  },
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          { "type": "command", "command": "[ -x .claude/hooks/pipeline-session-start.sh ] && bash .claude/hooks/pipeline-session-start.sh; exit 0" }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          { "type": "command", "command": "[ -x .claude/hooks/pipeline-prompt.sh ] && bash .claude/hooks/pipeline-prompt.sh; exit 0" }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Write",
+        "hooks": [
+          { "type": "command", "command": "[ -x .claude/plugins/product-manager/hooks/pre-prp-check.sh ] && bash .claude/plugins/product-manager/hooks/pre-prp-check.sh; exit 0" }
+        ]
+      },
+      {
+        "matcher": "Read",
+        "hooks": [
+          { "type": "command", "command": "[ -x .claude/hooks/activity-pre-read.sh ] && bash .claude/hooks/activity-pre-read.sh; exit 0" }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write",
+        "hooks": [
+          { "type": "command", "command": "[ -x .claude/plugins/product-manager/hooks/post-write-prd.sh ] && bash .claude/plugins/product-manager/hooks/post-write-prd.sh; exit 0" },
+          { "type": "command", "command": "[ -x .claude/plugins/product-manager/hooks/post-write-prp.sh ] && bash .claude/plugins/product-manager/hooks/post-write-prp.sh; exit 0" },
+          { "type": "command", "command": "[ -x .claude/plugins/staff-software-engineer/hooks/post-write-sse.sh ] && bash .claude/plugins/staff-software-engineer/hooks/post-write-sse.sh; exit 0" },
+          { "type": "command", "command": "[ -x .claude/hooks/pipeline-postwrite.sh ] && bash .claude/hooks/pipeline-postwrite.sh; exit 0" }
+        ]
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          { "type": "command", "command": "[ -x .claude/plugins/product-manager/hooks/post-eval-prd.sh ] && bash .claude/plugins/product-manager/hooks/post-eval-prd.sh; exit 0" },
+          { "type": "command", "command": "[ -x .claude/plugins/product-manager/hooks/post-eval-prp.sh ] && bash .claude/plugins/product-manager/hooks/post-eval-prp.sh; exit 0" },
+          { "type": "command", "command": "[ -x .claude/plugins/staff-software-engineer/hooks/post-eval-sse.sh ] && bash .claude/plugins/staff-software-engineer/hooks/post-eval-sse.sh; exit 0" },
+          { "type": "command", "command": "[ -x .claude/hooks/pipeline-postedit.sh ] && bash .claude/hooks/pipeline-postedit.sh; exit 0" }
+        ]
+      }
+    ]
+  },
+  "statusLine": {
+    "type": "command",
+    "command": "[ -x .claude/hooks/status-line.sh ] && bash .claude/hooks/status-line.sh || printf 'harness-kit not installed'"
+  }
+}

package/.claude/settings.local.json

@@ -71,7 +71,20 @@
       "Bash(git -C /Users/pierryborges/Development/harness-kit diff --stat)",
       "Bash(rm -rf /tmp/hk-fresh /tmp/hk-existing)",
       "Bash(npm whoami *)",
-      "Bash(npm publish *)"
+      "Bash(npm publish *)",
+      "Bash(git tag *)",
+      "Bash(sh -n /Users/pierryborges/Development/harness-kit/.claude/hooks/pipeline-session-start.sh)",
+      "Bash(sh -n .claude/plugins/staff-software-engineer/hooks/post-write-sse.sh)",
+      "Bash(sh -n .claude/plugins/staff-software-engineer/hooks/post-eval-sse.sh)",
+      "Bash(sh -n .claude/hooks/activity-pre-read.sh)",
+      "Bash(sh -n .claude/hooks/status-line.sh)",
+      "Read(//private/tmp/act-test/**)",
+      "Bash(cp /Users/pierryborges/Development/harness-kit/.claude/hooks/status-line.sh .claude/hooks/status-line.sh)",
+      "Bash(mkdir -p .claude/hooks)",
+      "Bash(cp /Users/pierryborges/Development/harness-kit/.claude/hooks/status-line.sh .claude/hooks/)",
+      "Bash(cp /Users/pierryborges/Development/harness-kit/.claude/scripts/pipeline.py .claude/scripts/)",
+      "Bash(npx --yes tsc --noEmit -p tsconfig.json)",
+      "Bash(ffmpeg -y -i out/demo.mp4 -vf 'fps=10,scale=720:-1:flags=lanczos,split[s0][s1];[s0]palettegen=max_colors=96[p];[s1][p]paletteuse=dither=bayer:bayer_scale=5' -loop 0 preview.gif)"
     ]
   }
 }

package/CLAUDE.md

@@ -10,6 +10,12 @@ Read by Claude Code on every session. Defines how to work in this harness-kit wo
 - **Destructive/irreversible ops:** full clarity warning.
 - No emojis in output unless user explicitly asks.
 
+### Caveman-full convention (internal docs)
+
+Internal docs (sensors, evals, guides, skills, sub-agent prompts, slash commands) are written in **caveman-full** style to save input tokens: drop articles, drop filler, fragments OK, short synonyms. Technical terms exact, code blocks unchanged, file paths verbatim. Chat reply templates inside slash commands follow the same style.
+
+**Exception — artifacts stay natural English.** PRDs, PRPs, plans, dev/test/pr reports get read by external stakeholders. Generated artifact content must be readable prose, not caveman. Reference templates and good-* examples under `guides/templates/` and `guides/examples/` stay natural for the same reason — they teach Claude what good artifact prose looks like.
+
 ## Role
 
 AI copilot for product + engineering delivery. Thinking partner and execution assistant. Help PMs, EMs, devs to: