Get the factory back
Last updated: Saturday 2026-11-21, 17:02 PST
Rebuilt 2026-11-21 17:02 PST from the live machine.
This page is stale: it was not updated in the last 90 minutes, so the timer has stopped or the Mac was off. Treat the inventory below as old.
The steps
Written restart steps (from the restart document, as written)
# Bringing the krum.build team back after a crash
Snapshot of what was running on 2026-11-13 at 8:00 pm PST. Use it when the Mac restarted or Herdr stopped. You do not need to remember anything: do the steps in order and paste the commands.
**First, check which kind of crash it was.** Open a terminal and run `hc ls`.
- If it lists the agents (kram-plt-PM, krum-plt-qa and the rest), only the Herdr window closed. The agents kept running. Open Herdr again and stop here.
- If it prints an error or an empty list, the Mac restarted or the Herdr engine died. Do all the steps below.
## After a crash: do these in order
1. **Open Herdr.** Open `Herdr` from Spotlight (it lives in `/Users/pshah/Applications/Herdr.app`). In any Herdr terminal, check that the engine is up:
```
hc server status
```
If that fails, run `hc server start`.
The three background jobs come back by themselves when you log in. They keep the defect list and feature board up to date and run the housekeeping checks. To check them:
```
launchctl list | grep krum
```
You should see `build.krum.defect-sync`, `dev.krum.feature-board`, and `build.krum.housekeeping` (K-751).
Optional, for long runs: keep the Mac awake for 24 hours.
```
nohup caffeinate -dimsu -t 86400 >/dev/null 2>&1 &
```
2. **Live game (only if you want it up now).** This starts the game players use on ports 8788 to 8791.
- Open Docker Desktop and wait about a minute. The database comes back by itself. To check it:
```
docker ps --format '{{.Names}}' | grep supabase_db_krum-build
```
If nothing prints, start the database:
```
cd /Users/pshah/DevOps/krum-dev && supabase start -x gotrue,realtime,storage-api,imgproxy,kong,mailpit,postgrest,edge-runtime,logflare,vector,supavisor
```
- Start the live game on Ling, the model you chose:
```
/Users/pshah/DevOps/factory/krum.dev/PM/live-model.sh ling
```
It takes up to 2 minutes and prints a health line at the end. Open http://127.0.0.1:8788 to check. Use `luna` instead of `ling` for the OpenAI model.
Running this command when the live game is already up restarts it and drops any message a player is sending at that moment.
3. **Agent Board** (the page showing who is working on what):
```
hc run --bg --name agent-board-server -- /Users/pshah/DevOps/factory/agent-board/start.sh
```
Open http://127.0.0.1:8990. You can skip this step: the PM starts the board itself in step 4.
4. **The agent tabs.** Start the PM first, so the other agents have someone to report to.
- **If Herdr already shows the `Kram` space with its tabs** (empty shells, names intact): click each tab and paste its **Launch command** from the table below. When the agent opens, paste its **First message**.
- **If the tabs are gone:** paste the commands below into any terminal, one at a time. Each one makes the tab with the exact name, starts the agent and sends its first message. Paste the first line first: it makes the `Kram` space with the PM tab. Every line after it adds a tab to the space that is open on screen, so keep `Kram` open while you paste.
```
herdr-app do space.new --name Kram --tab kram-plt-PM --folder /Users/pshah/DevOps/factory --argv '["claude","--resume","b808b52b-9bcf-4441-b0c1-7ad291dc7b6e","--model","opus","--allow-dangerously-skip-permissions","--permission-mode","bypassPermissions"]' --task "The system restarted. Read krum.dev/PM/CLAUDE.md (section 'If the system restarted') and krum.dev/RESTART.md, run krum.dev/PM/respawn.sh, then tell me who is back."
herdr-app do tab.new --name plt-claude-coder --folder /Users/pshah/DevOps/factory --argv '["claude","--resume","1ebfc82c-f0ea-48a0-86d1-66a666585d13","--model","sonnet","--allow-dangerously-skip-permissions","--permission-mode","bypassPermissions"]' --task "The system restarted and pane numbers changed (find people with hc ls; the PM is the tab kram-plt-PM). Re-read krum.dev/Coder/CLAUDE.md and Coder/HANDOFF-plt-claude-coder.md, then continue."
herdr-app do tab.new --name copilot-1 --folder /Users/pshah/DevOps/factory --argv '["copilot","--yolo","--disable-mcp-server","github-mcp-server","--resume=edbe51b1-5d72-4888-b80d-4456a9f6e2bf"]' --task "The system restarted and pane numbers changed (find people with hc ls; the PM is the tab kram-plt-PM). Re-read krum.dev/Copilot1/AGENTS.md and Copilot1/notes/memory.md, then continue."
herdr-app do tab.new --name copilot-2 --folder /Users/pshah/DevOps/factory --argv '["copilot","--yolo","--disable-mcp-server","github-mcp-server","--resume=917edbc1-faf9-4246-a0c3-f08f95a39da0"]' --task "The system restarted and pane numbers changed (find people with hc ls; the PM is the tab kram-plt-PM). Re-read krum.dev/Copilot2/AGENTS.md and Copilot2/notes/memory.md, then continue."
herdr-app do tab.new --name kram-plt-claude-qa --folder /Users/pshah/DevOps/factory --argv '["claude","--resume","69264116-87cd-404c-8253-fee0636dae23","--model","sonnet","--dangerously-skip-permissions"]' --task "The system restarted and pane numbers changed (find people with hc ls; the PM is the tab kram-plt-PM). Re-read krum.dev/QA/CLAUDE.md and QA/notes/memory.md, then continue."
herdr-app do tab.new --name Kram-plt-security --folder /Users/pshah/DevOps/factory --argv '["codex","--yolo"]' --task "You are the spare Codex lane for krum.build (tab Kram-plt-security). Read krum.dev/PM/LANES.md and krum.dev/Security/AGENTS.md. Pane numbers changed after a restart: the PM is the tab kram-plt-PM in hc ls. Tell the PM you are back and wait for a task."
herdr-app do tab.new --name kram-eng-bord --folder /Users/pshah/DevOps/factory --argv '["codex","resume","--yolo","01a1ba25-28fe-70b1-aa29-88a806d44a5a"]' --task "The system restarted and pane numbers changed (find people with hc ls; the PM is the tab kram-plt-PM). Re-read krum.dev/EngBoard/AGENTS.md and EngBoard/notes/memory.md, then continue."
herdr-app do tab.new --name krum-plt-qa --folder /Users/pshah/DevOps/factory --argv '["codex","resume","--yolo","-m","gpt-6.1-sol","01a1ba25-af53-7260-919f-bcf1b132bcef"]' --task "The system restarted and pane numbers changed (find people with hc ls; the PM is the tab kram-plt-PM). Re-read krum.dev/QA/AGENTS.md and QA/notes/memory.md, then continue."
herdr-app do tab.new --name kram-plt-builder --folder /Users/pshah/DevOps/factory --argv '["codex","resume","--yolo","01a1ba26-9f96-70b3-b7c2-3b92c58525d6"]' --task "The system restarted and pane numbers changed (find people with hc ls; the PM is the tab kram-plt-PM). Re-read krum.dev/Builder/AGENTS.md and Builder/notes/memory.md, then continue."
herdr-app do tab.new --name "Krum Game-Engine" --folder /Users/pshah/DevOps/factory --argv '["codex","resume","--yolo","-m","gpt-6.1-sol","01a1ba29-9c99-75b3-9557-867ec7a3865f"]' --task "The system restarted and pane numbers changed (find people with hc ls; the PM is the tab kram-plt-PM). Re-read krum.dev/Engine/AGENTS.md and Engine/notes/memory.md, then continue."
herdr-app do tab.new --name kram-plt-designer-3 --folder /Users/pshah/DevOps/factory --argv '["claude","--resume","d3090173-ea63-4531-95ab-dfb39da7b58a","--model","opus","--dangerously-skip-permissions"]' --task "The system restarted and pane numbers changed (find people with hc ls; the PM is the tab kram-plt-PM). Re-read krum.dev/Designer3/CLAUDE.md and Designer3/notes/memory.md, then continue."
herdr-app do tab.new --name kram-plt-doc --folder /Users/pshah/DevOps/factory --argv '["claude","--resume","4bf5d007-4a94-412f-8554-1a7d84b3a140","--model","sonnet","--dangerously-skip-permissions"]' --task "The system restarted and pane numbers changed (find people with hc ls; the PM is the tab kram-plt-PM). Re-read krum.dev/Doc/CLAUDE.md and Doc/notes/HANDOFF-kram-doc-2026-11-11.md, then continue."
herdr-app do tab.new --name kram-plt-pm-assist --folder /Users/pshah/DevOps/factory --argv '["claude","--resume","881c0395-0de7-46d1-9ddb-504465798936","--model","sonnet","--dangerously-skip-permissions"]' --task "The system restarted and pane numbers changed (the PM is the tab kram-plt-PM in hc ls). Re-read krum.dev/PM/ASSISTANT-BRIEF.md, then wait for Pranay."
```
5. **The Air** (the MacBook Air at home). Do this only if the Air itself restarted. If only the Mac restarted, the Air's agents are still running and come back on their own. Check the link with `hc machine ls`: it should say `air ... connected`. If it asks for a login, run `hc machine login air`. If the Air's agents are gone:
```
herdr-app do space.new --machine air --name Air --tab kram-air-one --folder /Users/pranay --argv '["claude","--resume","f91d7a56-e416-4a2c-be4a-74ef4560b07e","--model","fable","--allow-dangerously-skip-permissions","--permission-mode","bypassPermissions"]' --task "The system restarted and pane numbers changed (the PM is the tab kram-plt-PM on the Mac, see hc ls). Re-read ~/air-handoff.md, then continue."
herdr-app do tab.new --name krum-plot-air-ad-hock --folder /Users/pranay/DevOps/factory --argv '["claude","--resume","619677a0-46c2-479d-b7d1-3872f56a18b1","--model","sonnet","--allow-dangerously-skip-permissions","--permission-mode","bypassPermissions"]' --task "The system restarted and pane numbers changed (the PM is the tab kram-plt-PM on the Mac, see hc ls). Re-read krum.dev/UX/CLAUDE.md and krum.dev/Air2/Air2-notes.md, then continue."
```
6. **Check.** Run `hc ls`. Every tab name from the table should be there. The PM reports who is back.
## The team, one row per agent
Tab names matter. Herdr names each tab, and the hooks, the Agent Board and the other agents find each other by that name, not by pane number. Pane numbers (t16, t9n and so on) change after a restart. Type each name exactly, with the same capitals and spaces.
All Mac agents start in `/Users/pshah/DevOps/factory`, not in their own folder. Their saved conversations and the PM's hooks belong to that folder. Briefs are under `/Users/pshah/DevOps/factory/krum.dev/`. The first message for each agent is the `--task` text on its line in step 4.
| Tab name (type exactly) | Role in plain words | Tool and model | Start in | Brief it reads | Launch command (paste inside the tab) |
|---|---|---|---|---|---|
| `kram-plt-PM` | Product manager: plans, hands out work, merges, runs the live game | Claude, Opus 5.5 | `/Users/pshah/DevOps/factory` | `PM/CLAUDE.md` (plus its own memory, loaded by itself) | Signed (as of 2026-11-21): `/Users/pshah/DevOps/factory/agent-board-wt-pm-sign-stage1/pm-sign/start-pm --resume b808b52b-9bcf-4441-b0c1-7ad291dc7b6e --model opus` (adds skip-permissions itself; you type the signing password once). Plain (signing off): `claude --resume b808b52b-9bcf-4441-b0c1-7ad291dc7b6e --model opus --allow-dangerously-skip-permissions --permission-mode bypassPermissions`. See "Added 2026-11-21" for what signed mode costs. |
| `agy` | Coder: Google Antigravity (Gemini 4 Neon); acts only on PM messages that pass `krum-sign verify` | Antigravity | `/Users/pshah/DevOps/factory` | its card `agy` (AG-0050) and the signed brief it is sent | Started by Pranay with skip-permissions so it can read `~/.krum-sign`; no saved session number. After a restart the PM sends its task again, signed. |
| `plt-claude-coder` | Coder (agent and scripts work when Claude is the lane) | Claude, Sonnet 5.5 | same | `Coder/CLAUDE.md`, `Coder/HANDOFF-plt-claude-coder.md` | `claude --resume 1ebfc82c-f0ea-48a0-86d1-66a666585d13 --model sonnet --allow-dangerously-skip-permissions --permission-mode bypassPermissions` |
| `copilot-1` | "Argus": reads code and finds bugs, never edits | Copilot CLI, Sonnet 5.5 | same | `Copilot1/AGENTS.md`, `Copilot1/notes/memory.md` | `copilot --yolo --disable-mcp-server github-mcp-server --resume=edbe51b1-5d72-4888-b80d-4456a9f6e2bf` |
| `copilot-2` | "Forge": coder for small screen fixes, also merges when Claude is the lane | Copilot CLI, Sonnet 5.5 | same | `Copilot2/AGENTS.md`, `Copilot2/notes/memory.md` | `copilot --yolo --disable-mcp-server github-mcp-server --resume=917edbc1-faf9-4246-a0c3-f08f95a39da0` |
| `kram-plt-claude-qa` | Tester with a real browser and the real AI | Claude, Sonnet 5.5 | same | `QA/CLAUDE.md`, `QA/notes/memory.md` | `claude --resume 69264116-87cd-404c-8253-fee0636dae23 --model sonnet --dangerously-skip-permissions` |
| `Kram-plt-security` | Spare Codex helper: testing, merges, code review (was the security reviewer) | Codex | same | `PM/LANES.md`, `Security/AGENTS.md` | `codex --yolo` (no agent was running here at 8:00 pm PST on 2026-11-13, so start it fresh) |
| `kram-eng-bord` | Owner of the feature board; also screen code | Codex, GPT-6-Luna | same | `EngBoard/AGENTS.md`, `EngBoard/notes/memory.md` | `codex resume --yolo 01a1ba25-28fe-70b1-aa29-88a806d44a5a` |
| `krum-plt-qa` | Head of testing | Codex, GPT-6.1-Sol | same | `QA/AGENTS.md`, `QA/notes/memory.md` | `codex resume --yolo -m gpt-6.1-sol 01a1ba25-af53-7260-919f-bcf1b132bcef` |
| `kram-plt-builder` | Builder: the chat, the AI helper, cards and settings | Codex, GPT-6-Luna | same | `Builder/AGENTS.md`, `Builder/notes/memory.md` | `codex resume --yolo 01a1ba26-9f96-70b3-b7c2-3b92c58525d6` |
| `Krum Game-Engine` | Game rules and the game server | Codex, GPT-6.1-Sol | same | `Engine/AGENTS.md`, `Engine/notes/memory.md` | `codex resume --yolo -m gpt-6.1-sol 01a1ba29-9c99-75b3-9557-867ec7a3865f` |
| `kram-plt-designer-3` | Designer who also codes hard screen work | Claude, Opus 5.5 | same | `Designer3/CLAUDE.md`, `Designer3/notes/memory.md` | `claude --resume d3090173-ea63-4531-95ab-dfb39da7b58a --model opus --dangerously-skip-permissions` |
| `kram-plt-doc` | Writes the help pages and guides | Claude, Sonnet 5.5 | same | `Doc/CLAUDE.md`, `Doc/notes/HANDOFF-kram-doc-2026-11-11.md` | `claude --resume 4bf5d007-4a94-412f-8554-1a7d84b3a140 --model sonnet --dangerously-skip-permissions` |
| `kram-plt-pm-assist` | PM's assistant: answers your questions, read-only | Claude, Sonnet 5.5 | same | `PM/ASSISTANT-BRIEF.md` | `claude --resume 881c0395-0de7-46d1-9ddb-504465798936 --model sonnet --dangerously-skip-permissions` |
| `kram-air-one` (space `Air`, on the Air) | Phone and visual checks on the Air; QA lane (AG-0052, tester) | Claude, Sonnet 5.5 (as running 2026-11-21; was Fable 5.2) | `/Users/pranay` (Air) | `~/air-handoff.md` (Air) | `claude --resume f91d7a56-e416-4a2c-be4a-74ef4560b07e --model fable --allow-dangerously-skip-permissions --permission-mode bypassPermissions` |
| `krum-plot-air-ad-hock` (space `Air`, on the Air) | Second Air agent: coder lane (AG-0051) and one-off jobs | Claude, Opus 5.5 (as running 2026-11-21) | `/Users/pranay/DevOps/factory` (Air) | `krum.dev/UX/CLAUDE.md`, `krum.dev/Air2/Air2-notes.md` (Air) | `claude --resume 619677a0-46c2-479d-b7d1-3872f56a18b1 --model sonnet --allow-dangerously-skip-permissions --permission-mode bypassPermissions` |
**If a resume fails** (a session number is gone or the agent opens blank): start the tool without a number and pick the conversation from its list. Use `claude --resume`, `codex resume --yolo` or `copilot --resume`. If nothing fits, start it fresh with `claude`, `codex --yolo` or `copilot --yolo --disable-mcp-server github-mcp-server`. The agent then reads its brief and notes from the first message, so nothing is lost. Codex agents all share one folder, so do not use `codex resume --last` for them: it picks whichever was busy last.
Other spaces in Herdr (GeetKram, scrapling) are not part of krum.build and are not covered here.
## What the PM brings back by itself
Once the PM is running, it runs `/Users/pshah/DevOps/factory/krum.dev/PM/respawn.sh`. That script starts:
- the **Agent Board** server (`agent-board-server`, http://127.0.0.1:8990), unless one is already running;
- the **ticket keeper** `kram-tickets` (Claude Haiku 5.5, folder `krum.dev/Tickets`, brief `Tickets/CLAUDE.md`), which opens and keeps the GitHub issues;
- with `respawn.sh --coders`: the Mac design helper `kram-ux-mac` (Claude Sonnet 5.5, folder `krum.dev/UX`) and older coder panes, but only if their work is unfinished.
The PM also brings back these by hand. `respawn.sh` does not cover them yet:
- `argus-2`, the second code reviewer (Copilot CLI, folder `krum.dev/Copilot3`, brief `Copilot3/AGENTS.md`):
`cd /Users/pshah/DevOps/factory/krum.dev/Copilot3 && copilot --allow-all --disable-mcp-server github-mcp-server --resume=1e4d0198-241b-454c-aff9-0a6705a58d93`
- one-off Codex coders, each in its own copy of the code (`k631-chat-layout`, `k640-restore-flag`, `k644-walkthrough`, `k647-design-gate`, `k651-empty-state`, `k648-eval-scorer`). The PM restarts only the ones whose ticket is still open, from that coder's folder:
`cd <its folder> && codex resume --yolo --last`
- the **live game** (`krum-live-stable-stack`), and only after you say so: `PM/live-model.sh ling`.
**What you start yourself:** Herdr, Docker (if you want the live game), the PM tab, and every other tab in the table. Those tabs are yours, and the PM cannot open Herdr tabs for you.
## Things that only work if the name is right
- **`kram-plt-PM`**: the Sprint panel check runs only in the tab with exactly this name, started by you and not by another agent. At the end of each PM turn it compares the Sprint panel with what is really merged. The PM must also start in `/Users/pshah/DevOps/factory`, because that folder holds its hooks and its memory.
- **`kram-plt-PM`** (also): the pane watch and inbox hook (`~/.claude/hooks/pm-watch-hook.py`) runs only in this tab. Each PM turn it lists team panes waiting on a question or sitting idle, logs every message to the PM in `~/.herdr-news/pm-inbox.tsv`, and stops the PM from finishing while a pane has waited 2 min or a message 10 min (`PM/tools/pm_watch.py`, `PM/tools/pm_inbox.py`). It finds the PM's children by the PM's own pane, so it needs no pane-number update.
- **Every tab name**: the Agent Board and the PM's work lanes (`PM/LANES.md`) show and assign agents by tab name.
- **`krum-live-stable-stack`**: `live-model.sh` finds the running live game by this name and replaces it. A live game started under another name does not get stopped, and it then fights over ports 8788 to 8791.
- **`agent-board-server`, `kram-tickets`, `kram-ux-mac`**: `respawn.sh` skips anything already running under these names.
**Things tied to the old pane numbers (the PM fixes these after a restart).** These look for a pane number, not a name, so they go quiet until the PM updates them:
- the merge reminders and the end-of-turn board check in `/Users/pshah/DevOps/factory/.claude/helpers/` (`board-news-reminder.sh`, `board-stale-check.sh`) only work in `t16`;
- the GitHub-issue guard in `~/.claude/hooks/require-gh-issue.py` lets the PM message the ticket keeper only at `t221`;
- every brief says "message the PM with `hc send t16`".
After a restart, ask the PM: "Update the hooks and briefs to the new pane numbers, or better, make them find agents by tab name."
## Background timers on this Mac (and how to remove them)
macOS lists these under System Settings > General > Login Items > "Allow in the Background".
| Shown as | File | What it does |
|---|---|---|
| bash (now the heartbeat, HB-1) | ~/Library/LaunchAgents/build.krum.defect-sync.plist | Every 10 minutes and at login: runs the HEARTBEAT (`PM/tools/heartbeat.py run`), which runs the job list `~/.herdr-news/heartbeat/jobs.tsv` one job at a time: defect-sync, sprint-sync, pm-watch-scan, pm-inbox-prune, usage-watch, restart-rows, restart-artifact. Status: `python3 PM/tools/heartbeat.py status` (needs `HEARTBEAT_HOME=~/.herdr-news/heartbeat`). The old `panel_sync.sh` is no longer called. |
| (feature board) | ~/Library/LaunchAgents/dev.krum.feature-board.plist | The feature board job. |
| Python (K-751 housekeeping) | ~/Library/LaunchAgents/build.krum.housekeeping.plist | Every 10 minutes, also at login: PM/tools/housekeeping.py --once; exact-PID editor/board fixes, report-only stacks/listeners older than 90 min, panes/disk/CPU; PM/logs/housekeeping.log (1 MB, 3 archives). |
To stop one for good (example for the panel timer):
```
launchctl bootout gui/$(id -u)/build.krum.defect-sync
mv ~/Library/LaunchAgents/build.krum.defect-sync.plist ~/Desktop/
```
Turning its switch off in Login Items also stops it. If the factory folder is deleted, the timer only fails quietly every 10 minutes; remove it as above.
## Safeguards added 2026-11-13 (all survive a restart; nothing to start by hand)
| Safeguard | Where it lives | Survives restart because |
|---|---|---|
| Proof-pack close guard (issue reopens if closed without Before/After/Design + Verified by QA + Checked by) | GitHub Actions `.github/workflows/issue-close-guard.yml` in the krum-dev repo | Runs on GitHub, not on this Mac (active once main is pushed) |
| Merge gate for design proof | `scripts/check_change.py` + `scripts/design_gate.py` in the repo | Part of the code every merge runs |
| Sprint panel sync + "panel disagrees with main" stop check | `~/.claude/hooks/sprint-sync-hook.py`, `PM/tools/sprint_sync.py`, registered in `factory/.claude/settings.local.json` | Claude Code loads it at start; needs the PM tab named `kram-plt-PM` |
| Pane watcher + PM inbox (blocked/idle panes, unhandled messages) | `~/.claude/hooks/pm-watch-hook.py`, `PM/tools/pm_watch.py`, `PM/tools/pm_inbox.py` | Same as above |
| Recover messages missed while no PM session was running (2026-11-21) | After the PM starts in its tab, run `python3 PM/tools/pm_inbox.py recover --dry-run`, then `recover` (add `--mark-done` to file the rows as handled, not unread), then `list`. It reads the history of the tab named `kram-plt-PM` (about 3,400 lines, roughly 16 hours), adds what the inbox does not have marked "(recovered)", prints a digest and keeps the newest 200. Tests: `PM/tools/test_pm_inbox.py`. | Plain script. The inbox hook now also accepts the PM tab when Herdr lists it as zsh (signing launcher): `find_pm` in `PM/tools/pm_watch.py`, backups `*.before-zsh-fix.bak`. Works only while that tab is open (a closed tab takes its history with it). Messages sent to a closed tab are not stored anywhere. |
| Panels refresh every 10 min (defects, Sprint, board) | launchd `build.krum.defect-sync` -> `PM/tools/panel_sync.sh` | macOS starts it at login |
| Housekeeping timer + non-interactive coder git editors (K-751, #244) | `PM/tools/housekeeping.py`, `PM/tools/test_housekeeping.py`; launchd `build.krum.housekeeping`; state `~/.herdr-news/housekeeping.json`; coder launchers set `GIT_EDITOR=true GIT_SEQUENCE_EDITOR=true` | launchd starts at login independently of Herdr/PM, then every 600s; one short inbox summary only when new findings/actions occur (60 min dedup); full table `~/.herdr-news/housekeeping-latest.md`. Only PM-owned pane trees qualify; independent panes and Codex/ChatGPT idle helpers are excluded. Protected ports 8788–8791/9300–9302 and live are excluded; no file deletion. Dry-run: `python3 PM/tools/housekeeping.py --dry-run --once`. Unload only this timer with `launchctl bootout gui/$(id -u)/build.krum.housekeeping` (keeps all files). |
| PM-blocked clock for the floor banner (relay of Herdr's own blocked time) | `agent-board/scripts/blocked_since.py`, called by the housekeeping timer step `blocked_since_relay` in `PM/tools/housekeeping.py`; writes `~/.herdr-news/blocked-since.json` | Runs from the same launchd housekeeping timer (every 600 s); the file is rebuilt each run, so nothing to restart. If the file is older than 20 min the floor shows the banner without a number. |
| No agent types into the PM or PM-assistant window (rule 49) | Claude: `~/.claude/helpers/floor-guard.sh` refuses `hc keys`, `hc interrupt`, `hc send --force` aimed at a pm/pm-assistant session; Codex: `~/.codex/rules/karkhana-guards.rules` forbids those verbs for every target; Copilot: deny flags in `spawn/start-agent.sh` | Plain files, read at each tool call (Claude) or at session start (Codex, Copilot: restart a pane to pick it up). Undo: `bash ~/DevOps/karkhana/tools/install-guards/install_guards.sh --uninstall` (add `--dry-run` to preview) restores the backups `<file>.before-raw-input-guard.bak`. |
| The Herdr floor, its strip and its layout (hide/show floor, side panel) | Installed by `bash ~/DevOps/factory/agent-board/herdr-mod/install.sh` (run from the main checkout, not a worktree): mods `kram-floor` and `kram-floor-handle` and layout `kram-floor-live` in `~/.config/herdr-app`; check with `--check` | Plain files Herdr reads at start; re-run the installer after any floor change. Needs the layout `kram-floor-live` selected (View > Layout). |
| Old Herdr layouts moved out of the way (2026-11-21) | `~/DevOps/factory/layout-backups-2026-11-21/` (kram-floor, kram-floor-try, main-news, main-news.bak and their saved sizes) | Plain copies; to restore one, copy it back into `~/.config/herdr-app/layouts/`. Only `kram-floor-live` and Herdr's own `main`, `terminals`, `win98` are kept. |
| Panel "updated" time + GitHub links | herdr mods in `~/.config/herdr-app/mods/{news,status,sprint}` | herdr loads mods at start |
| No work without a GitHub issue | `~/.claude/hooks/require-gh-issue.py` | Claude Code loads it at start |
| Ticket status "merged"/"live" needs the QA-approved commit on main/live; duplicates name the ticket carrying the fix (warn-only until 2026-11-25, then enforce) | `~/.local/bin/sprint` calls `PM/tools/ticket-guard/ticket_guard.py`; mode in `~/.herdr-news/ticket-guard-mode`; warnings in `~/.herdr-news/ticket-guard.log` | Survives restart (plain files); backup of the old command in PM/tools/ticket-guard/sprint-before-guard.bak |
| No new agent without its job definition pushed to the karkhana repo (launch needs FACTORY_ROLE=<role>; roles/<role>.md committed and on origin/main in ~/DevOps/karkhana) | `~/.claude/hooks/require-role-definition.py` | Claude Code loads it at start; needs the agent-factory clone |
| QA closes each GitHub issue with its proof pack at the moment it says PASS | QA brief `krum.dev/QA/AGENTS.md` ("Close with proof at sign-off") + DECISIONS.md 2026-11-13 | QA reads its brief at every start; GitHub's close guard reopens any issue closed without proof |
| Design type check: no text ships without a design type role (K-699, PB3.305) | Source lint `npm run lint:design --prefix apps/web` (every text tag, error) + rendered gate `node scripts/qa/type_gate.mjs --url http://127.0.0.1:<own-web-port> --out <new-dir>` on an owned fake-model stack (MODEL_PROVIDER=fake, PAID_CALLS_ENABLED=false) at every release freeze; allowlists can only shrink; see `docs/qa/type-gate.md` in krum-dev | Part of the repo; QA runs it at each freeze per QA/AGENTS.md |
| Release wrap-up after every live release (closure audit, Sprint panel roll, disk cleanup, docs, news) | Skill `factory/.claude/skills/release-wrapup/SKILL.md`; script `PM/tools/release_cleanup.py` (+ `test_release_cleanup.py`); reminder hook `~/.claude/hooks/release-wrapup-hook.py` registered under PostToolUse "Bash" in `factory/.claude/settings.local.json` | Plain files; Claude Code loads the skill and hook at start (PM tab `kram-plt-PM`). The script deletes only with `--apply` and only QA picture folders of live+closed tickets and clean worktrees. To remove: delete the `release-wrapup-hook.py` entry from `settings.local.json`, then delete the three files and the skill folder |
## Record each agent's job (added 2026-11-19)
When you start or restart any agent tab and tell it its job, record the job in the same step so the Herdr floor seats it right:
`python3 /Users/pshah/DevOps/factory/agent-board-wt-handoff/scripts/identify.py set <tab name or tN> --role <pm|pm-assistant|coder|integrator|reviewer|tester|designer|security|ticket-keeper|tooling-owner|caretaker|on-call/NAME>`
(Run it from the agent-board-wt-handoff worktree, which is on main.) `identify.py show` lists who has none. Labels survive until the tab closes; a new tab needs it again.
## Guards that must be on after any restart (checked 2026-11-20)
Pranay chose to keep these. They are plain files, so they survive a Mac or Herdr restart by themselves. Check them once after a restart.
- **The delete guards:** no remove with variables, and no stopping programs by name.
- **No agent types into the PM's or the PM assistant's window** (floor rule 49). It refuses `hc keys`, `hc interrupt` and `hc send --force` aimed at them. Normal messages are still allowed.
- **Where they live:** Claude in `~/.claude/helpers/floor-guard.sh` (hooked in `~/.claude/settings.json`), Codex in `~/.codex/rules/karkhana-guards.rules`, and Copilot as deny flags in `karkhana/spawn/start-agent.sh`.
- **Quick check:** `codex execpolicy check --rules ~/.codex/rules/karkhana-guards.rules -- hc keys t16 x` must say `forbidden`. With `-- hc send t16 hi` it must match no rule.
- **Restarting Codex:** Codex and Copilot read their rules only when they start. After a guard file changes, restart each Codex tab: type `/quit`, then run its `codex resume` line from the table above. Its memory and job label are kept.
- **What it cannot stop:** scripts, `bash -c`, or someone driving Herdr directly. The full fix is the PM signing work, which is still test-only (`PM/notes/pm-session-message-signing-plan-2026-11-20.md`).
- **Undo (only if Pranay asks):** `bash ~/DevOps/karkhana/tools/install-guards/install_guards.sh --uninstall`. Add `--dry-run` to preview.
## Added 2026-11-21 (things a restart needs to know)
| What | What to do or know |
|---|---|
| Signed PM mode (start-pm) | Under the signing launcher Herdr lists the PM tab as plain zsh. Effects: empty PM seat on the floor, `hc send` to the PM answers `started:false` (the message still arrives; agents are told not to resend), no PM-blocked timer. The inbox hook was fixed to cope (row above). To drop all of this, start the PM with the plain command in the table. |
| Codex tabs report the wrong sender | Codex tabs (builder, QA, engine) may send as `t14k` because their shared Codex process kept an old tab id (same bug as Herdr issue #335). `t14k` is a plain shell: anything sent there is typed in and run as a command. Rule sent to every agent: never `hc send t14k`; address by real tab. Restarting a Codex tab alone does NOT fix it: a brand-new Codex tab (board-truth, t2j3, 2026-11-21 13:20) also sent as t14k, so the wrong id lives in the shared Codex background process; it needs that process restarted (all Codex tabs at once), which only Pranay does. |
| Moving code to and from the Air | The Air has no GitHub login. Mac to Air: `git bundle create <file> <base>..main`, split into 7 MB parts (`hc put` takes at most 8 MB), `hc put air/t1 <part>`; on the Air: `cat` the parts together, `git bundle verify`, `git fetch <bundle> main:refs/remotes/mac/main`. Air to Mac: the Air coder makes `~/<ticket>.bundle`; on the Mac `hc exec --on air -- cat <ticket>.bundle > <file>` then `git -C ~/DevOps/krum-dev fetch <file> +<branch>:air/<branch>`. Pictures: `hc exec --on air -- tar -C <dir> -cf - . \| tar -xf -` (hc exec output stops at 8 MB, so copy big folders in parts or file by file with `hc exec --on air -- cat <file> > <file>`). |
| Air agents' cards and limits | Cards: `krum-plot-air-ad-hock` AG-0051 (coder), `kram-air-one` AG-0052 (tester). Each has a 5-hour usage allowance; when it runs out the agent stops until the reset time shown on its screen. air/t8 was marked unavailable at 12:05; after its reset run `python3 ~/DevOps/factory/agent-board/scripts/identify.py available air/t8`. Backup for Air QA: `kram-plt-claude-qa` (t1s7); for the Air coder: engine or builder Codex. |
| Ticket guard false warnings fixed (TG-1) | `PM/tools/ticket-guard/ticket_guard.py` edited in place (not in git); tests `test_ticket_guard.py`. Same fix in karkhana commit ee3fb77, not pushed (waits for Pranay). Still warn mode. |
| Closed tab `pm-sign-pilot` | Closed 2026-11-21 (idle 18 h). Work on local branch `feat/pm-sign-stage1` in `agent-board-wt-pm-sign-stage1`. Resume if ever needed: `codex resume 01a1e063-8c07-71e0-8f5f-696cc65f6a00` from that folder. Card retired. |
| Herdr true-sender work (parked) | Local only, not pushed: `~/DevOps/herdr-core-sender` branches `feat/true-sender` and `wip/limit-typing` (about 3.1 GB with its toolchain). The live Herdr was never changed. Issue draft: `PM/notes/herdr-issue-draft-true-sender-2026-11-20.md`, not posted. |
## Heartbeat and its jobs (added 2026-11-21, HB-1)
| Piece | Where it lives | Survives a restart because / how to check |
|---|---|---|
| Heartbeat runner | `PM/tools/heartbeat.py` (+ `test_heartbeat.py`); blueprint copy `karkhana/tools/heartbeat/`; job list, status and per-job logs in `~/.herdr-news/heartbeat/` | launchd `build.krum.defect-sync` starts it at login and every 600 s. Check: `HEARTBEAT_HOME=~/.herdr-news/heartbeat python3 PM/tools/heartbeat.py status` (a job that failed 3 times in a row is RED, one line goes to the PM inbox, and the restart page shows it red). Old plist backed up in `~/.herdr-news/heartbeat/backup/`. |
| usage-watch job | `PM/tools/usage_watch.py` | Heartbeat job. Reads each agent tab's status line (`hc read <tab> --lines 8`); at 85% or a reached limit, one inbox line per agent per hour. |
| restart-rows job | `PM/tools/restart_rows.py`; state `~/.herdr-news/heartbeat/restart-rows.json` | Heartbeat job. Any new tool, hook, helper or timer file that this document does not name gets one inbox line. Add its row here in the same change. |
| restart-artifact job | `PM/tools/restart_artifact.py`; state `~/.herdr-news/heartbeat/restart-artifact.json` | Heartbeat job, notify mode: Claude 2.1.330 has no Artifact tool in headless runs, so it publishes nothing itself. When the page content changed, or the last publish is over 60 minutes old, it adds one inbox line (at most hourly) with the file, the link and the "Last updated" description; the PM publishes the file by hand, then runs `python3 PM/tools/restart_artifact.py mark-published`. `RESTART_ARTIFACT_MODE=headless` switches the publish back on if a Claude version gains the tool. |
| Restart page | `PM/tools/restart_page.py` (+ test); output `~/.herdr-news/restart.html`; also rebuilt by the K-751 housekeeping timer | Plain file; bookmark `file:///Users/pshah/.herdr-news/restart.html`. Shows a red banner if not updated for 90 minutes. |
| Panel sync step script | `PM/tools/defect_sync.py` | Called by the heartbeat job `defect-sync` (was `panel_sync.sh`). |
| Defect-sync hook | `~/.claude/hooks/defect-sync-hook.py` | PostToolUse hook: when the PM edits the defect log, sprint panel or GitHub map it refreshes `~/.herdr-news/defects.json`. Registered in the PM's Claude settings. |
| Graft code-index helpers | `~/.claude/helpers/graft-hooks.cjs`, `~/.claude/helpers/graft-statusline.cjs` | Called from `~/.claude/settings.json` hooks and status line. Needs `graft` on PATH (it was missing on 2026-11-21: the graft server failed to connect). |
| Inbox `add` command | `PM/tools/pm_inbox.py add --from NAME TEXT...` | Used by the heartbeat for alerts; same file as the hook. |
## Ticket truth (TRUTH-1)
| Piece | Survives restart because | Check |
|---|---|---|
| agent-board/scripts/truth.py | committed shared sprint lock and atomic event engine; no daemon | `python3 -m unittest tests.test_truth_assign tests.test_truth_admin tests.test_truth_server` from agent-board |
| agent-board/scripts/assign.py and scripts/dispatch.sh | committed hand-over commands; sprint is authoritative and labels are delivery mirrors | `python3 scripts/assign.py --help`; give/transfer use real comma-separated ticket IDs |
| ~/.local/bin/sprint and PM/tools/ticket-guard/ticket_guard.py | backed-up installation by deployment/install_truth.py; final commit proof checks retained | `sprint show`; `sprint set` refuses holder/stage contradictions |
| agent-board/scripts/truth_admin.py | committed migration and orphan checker; migration makes a dated backup | `python3 scripts/truth_admin.py migrate --output /tmp/sprint-truth-review.json` previews live labels without changing sprint |
| board-truth heartbeat job | line in ~/.herdr-news/heartbeat/jobs.tsv, run by the existing heartbeat timer | `python3 scripts/truth_admin.py check`; ~/.herdr-news/board-truth-status.json must show `ok` or list red orphan IDs; PM inbox receives one alert per changed orphan set |
| agent-board board server | reads sprint changes on the next GET; existing start.sh restarts it | open http://127.0.0.1:8990 and compare ticket stage/holder with `sprint show` |
| herdr-mod/kram-floor | installed only from merged main; watches sprint file changes immediately | `herdr-mod/install.sh --check`; queues at desks, typed waits and release groups must match sprint |
| deployment/install_truth.py | committed backed-up installer; records an undo manifest before migration | preview with no flags; --enable-heartbeat refuses until preflight is clean; restore reverts sprint writes made since the install, so preserve/reconcile later work first |
| deployment/restore_floor.py | committed floor restore; current copies move aside instead of deletion | preview with the dated backup directory; full undo commands are in scripts/BOARD-TRUTH.md |
After PM merge, from agent-board main: run `python3 deployment/install_truth.py`
to preview, then `python3 deployment/install_truth.py --apply` to install with
backups and an undo manifest. This leaves the new heartbeat job unregistered. Pause work dispatch while migrating; make and review a candidate with
`python3 scripts/truth_admin.py migrate --output /tmp/sprint-truth-review.json`,
then run `python3 scripts/truth_admin.py migrate --apply`. Existing owner waits
retain their original fields. Run `python3 scripts/truth_admin.py preflight` and
resolve every orphan/conflicting label using a real hand-over or genuine typed
wait, including the nine listed in scripts/BOARD-TRUTH.md and any additional
reported rows. When preflight exits 0, register the job with
`python3 deployment/install_truth.py --enable-heartbeat --apply`. Only use `--owner-go` on a later hand-over after
Pranay explicitly approves moving that ticket. Install the floor from main and
run `herdr-mod/install.sh --check`. This change adds no timer and restarts no app.
| Board truth: `assign.py --enqueue` (TRUTH-2, installed 2026-11-21: agent-board main 5ca3f3a) | `agent-board/scripts/assign.py` and `scripts/truth.py` (karkhana `tools/board-truth`, branch `feat/board-truth-enqueue`) | Part of the agent-board code the PM installs; nothing separate to start. Use: `assign.py transfer <sender> <receiver> <ID> --enqueue -- <message>` adds the ticket to the END of a busy receiver's queue in one event. Check: `python3 -m unittest tests.test_truth_assign` in agent-board. |
| Board truth: `assign.py fail --enqueue`, `close`, `backlog` (TRUTH-3, installed 2026-11-21: agent-board main 60247c6, karkhana b3fb962) | `agent-board/scripts/assign.py` and `scripts/truth.py` (karkhana `tools/board-truth`) | Part of the agent-board code the PM installs; nothing separate to start. `close <IDs> --reason "..."` finishes no-code tickets and clears holder, queue slot, wait and labels; `backlog <IDs>` releases held or waiting tickets and removes their active rows (record in `backlogged`); `fail ... --enqueue` sends a failed ticket behind a busy coder's queue. Check: `python3 -m unittest tests.test_truth_assign` in agent-board. |
Open tabs and their jobs
| Tab | Job | Name | Program | Folder |
|---|---|---|---|---|
| t2 | - | tahuko | zsh | /Users/pshah/DevOps/scrapling |
| t3 | - | kavya | zsh | /Users/pshah/DevOps/scrapling |
| t4 | - | kavya-smart | zsh | /Users/pshah/DevOps/scrapling |
| t5 | - | Learning | zsh | /Users/pshah/DevOps/scrapling |
| t6 | - | GeetKram | zsh | /Users/pshah/DevOps/scrapling |
| t7 | - | AWS | zsh | /Users/pshah/DevOps/scrapling |
| t10 | - | GeetKram-pm | claude-code | /Users/pshah/DevOps/factory |
| t11 | - | Codex | zsh | /Users/pshah/DevOps/factory |
| t12 | - | Claude Code | zsh | /Users/pshah/DevOps/factory |
| t13 | - | 4 | claude-code | /Users/pshah/DevOps/factory |
| t16 | pm | kram-plt-PM | zsh | /Users/pshah/DevOps/factory |
| t75 | on-call/doc-writer | kram-plt-doc | claude-code | /Users/pshah/DevOps/factory |
| t8n | designer | kram-plt-designer-3 | claude-code | /Users/pshah/DevOps/factory |
| t9j | coder | Krum Game-Engine | codex | /Users/pshah/DevOps/factory |
| t9k | coder | kram-plt-builder | codex | /Users/pshah/DevOps/factory |
| t9n | tester | krum-plt-qa | codex | /Users/pshah/DevOps/factory |
| t10j | tooling-owner | kram-eng-bord | codex | /Users/pshah/DevOps/factory |
| t14k | - | Kram-plt-security | zsh | /Users/pshah/DevOps/factory |
| t1rc | reviewer | copilot-1 | copilot | /Users/pshah/DevOps/factory |
| t1rs | coder | copilot-2 | copilot | /Users/pshah/DevOps/factory |
| t1s7 | tester | kram-plt-claude-qa | claude-code | /Users/pshah/DevOps/factory |
| t1zh | coder | plt-claude-coder | claude-code | /Users/pshah/DevOps/factory |
| t21m | pm-assistant | kram-plt-pm-assist | claude-code | /Users/pshah/DevOps/factory |
| t221 | ticket-keeper | kram-tickets | claude-code | /Users/pshah/DevOps/factory/krum.dev/Tickets |
| t2f4 | outside | langfuse | zsh | /Users/pshah/DevOps/factory |
| t2f7 | - | karkhana-docs-preview | karkhana-docs-serve.sh | /Users/pshah/DevOps/karkhana-site |
| t2f9 | - | 15 | zsh | /Users/pshah/DevOps/factory |
| t2fq | coder | agy | antigravity | /Users/pshah/DevOps/factory |
| t2gb | - | krum-live-stable-stack | sh | /Users/pshah/DevOps/krum-dev-live |
| t2jc | - | agent-board-server | start.sh | /Users/pshah/DevOps/factory/krum.dev/PM/specs |
| t2jd | coder | board-sync | codex | /Users/pshah/DevOps/factory |
| air/t1 | tester | kram-air-one | claude-code | /Users/pranay |
| air/t8 | coder | krum-plot-air-ad-hock | claude-code | /Users/pranay/DevOps/factory |
| air/t28 | - | air2-render | sh | /private/tmp/claude-501/-Users-pranay-DevOps-factory/619677a0-46c2-479d-b7d1-3872f56a18b1/scratchpad/design-render |
Sessions that could be resumed
Tool and session id only. Match each to a tab by its folder and name, then resume it in a tab you open.
| Tool | Session id (to resume) |
|---|---|
| claude | b808b52b-9bcf-4441-b0c1-7ad291dc7b6e |
| claude | 4bf5d007-4a94-412f-8554-1a7d84b3a140 |
| claude | d3090173-ea63-4531-95ab-dfb39da7b58a |
| codex | 01a1ba29-9c99-75b3-9557-867ec7a3865f |
| codex | 01a1ba26-9f96-70b3-b7c2-3b92c58525d6 |
| codex | 01a1ba25-af53-7260-919f-bcf1b132bcef |
| codex | 01a1ba25-28fe-70b1-aa29-88a806d44a5a |
| copilot | edbe51b1-5d72-4888-b80d-4456a9f6e2bf |
| copilot | 917edbc1-faf9-4246-a0c3-f08f95a39da0 |
| claude | 69264116-87cd-404c-8253-fee0636dae23 |
| claude | 1ebfc82c-f0ea-48a0-86d1-66a666585d13 |
Open tickets and who holds them
"Held by" is a tab number. Tab numbers change after a restart, so re-match them.
| Ticket | Stage | Held by (tab) | Title |
|---|---|---|---|
| K-805 | building | t9k | Filler like 'Okay, ten more in one go' is treated as a missing memory |
| PM-SIGN-1 | yourgo | Pranay | PM message signing, real pilot (simple, no hooks) |
| HC-SENDER-1 | yourgo | Pranay | Herdr tells the true sender (prototype on a local copy) |
| K-770 | qa | agy | Housekeeping-only MCP tools get their own key; no one sees other owners' games |
| K-807 | building | t9k | A plain year fix asks Which card? although only one card fits |
| K-779 | building | t9n | Game settings show the cards really dealt per team |
| K-773 | building | t9n | Game settings Look tab is cut off; team colours unreachable |
| K-668 | building | t9n | Builder menu Rename game opens the Rename dialog, not a chat line |
| K-822 | building | t1s7 | Chat says each change twice (receipt + builder line) |
| REL-12.5 | yourgo | Pranay | Release 12.5: K-779 + K-773 + K-668 combined and tested |
| K-824 | building | t9n | Remove this card? names the card |
| K-840 | building | t1s7 | Table look ignores saved team colours; hand cut at 1440x900 |
| K-838 | building | t9n | Solo lost game never says it was lost |
| K-839 | building | t9n | Solo spoken line says You gets a penalty card |
| K-834 | building | t1s7 | Hints used up: button greys with no reason |
| K-819 | building | t1s7 | 'Not now' on the year question is a dead end |
| TRUTH-1 | building | t1rc | The board always tells the truth (one hand-over command, waits-for, queues, ready to ship) |
| K-835 | building | t9n | After a hint the clue is clipped and the 2nd hint hidden |
| K-820 | building | t1s7 | Import lines disagree on how many cards need a year |
| TRUTH-2 | building | t1rc | Hand a ticket into a busy agent's queue in one step |
| K-856 | building | t1s7 | Table look, phone sideways: the clue box shrinks to an empty white square |
| K-851 | building | t1s7 | Connection panel shows engineer words (Agent URL, Developer token) to everyone |
| K-850 | building | t1s7 | Delete this game? and Clear all cards? do not say what they remove |
| K-859 | building | t1s7 | Append import says 2 cards, 3 need a year (reads as 3 of 2) |
| K-860 | qa | t1s7 | A full game id works as a read key for strangers (security) |
| K-826 | building | t1s7 | Phone Cards tab: unlabeled pencil; settings called Customize there |
| K-814 | building | t1s7 | One action has four names (Play game / Play updated game / Play it myself first / Start game) |
| K-857 | building | t1s7 | Review year looks like a plain heading, not a button |
| K-849 | building | t1s7 | Dark mode: disabled filled buttons look clickable; low contrast |
| K-862 | building | t1s7 | Switching the look replaces the saved team colours |
| K-863 | building | t1rc | A web test overwrites and deletes the real dev agent token |
| K-867 | building | t9j | Warm/River phone sideways: clue overlaps team panel, 2nd hint hidden |
| K-865 | qa | t1s7 | Settings accept 1 card per hand, then Play refuses |
| K-866 | building | air/t8 | Phone: finished game says Play game, desktop says Play again |
| TRUTH-3 | building | t1rc | Board: three missing hand-over steps (fail to busy coder, back to backlog, close without code) |
| K-868 | building | t1rc | Change-gate notices to the PM retried forever |
| K-864 | qa | t1s7 | Timeout box shows raw 'signal is aborted without reason'; icon clipped |
| K-869 | building | t1s7 | Desktop Table/Warm untouched game: both teams' years in one colour |
| K-827 | qa | t1s7 | Phone: Show more on a long first message hides the end; Show less covers words |
| K-823 | building | air/t8 | Table with chat below at 1440 shows only 4 of 14 rows |
| K-825 | qa | t1s7 | Undo note covers the last Table row |
| K-821 | qa | t1s7 | History missing from the game menu when the chat is beside |
| K-831 | qa | t1s7 | Look tab colour presets are pill chips (no-pill rule) |
| K-837 | qa | t1s7 | Warm and River on phone: active team panel clipped at the left edge |
| K-861 | building | t9j | Table look: + drop circles ~24px and covered by neighbour cards |
| K-829 | building | t9n | Browser spec builder-t1: 14 tests fail on main (stale tests or real bugs?) |
| K-842 | building | t9k | Keyboard focus drops to the page after almost every action |
| TRUTH-4 | building | t2jd | Board and GitHub never silently disagree; finished tickets fold into one Done icon |
Heartbeat jobs (every 10 minutes)
Last round: 2026-11-21 17:00:32 PST. Red = failed 3 times in a row.
| Job | State | Last OK | Last error |
|---|---|---|---|
| defect-sync | ok | 2026-11-21 17:00:28 PST | |
| sprint-sync | ok | 2026-11-21 17:00:28 PST | |
| pm-watch-scan | ok | 2026-11-21 17:00:29 PST | |
| pm-inbox-prune | ok | 2026-11-21 17:00:29 PST | |
| usage-watch | ok | 2026-11-21 17:00:31 PST | |
| restart-rows | ok | 2026-11-21 17:00:31 PST | |
| restart-artifact | ok | 2026-11-21 17:00:32 PST | |
| board-truth | ok | 2026-11-21 17:00:32 PST |
Timers
| Timer | State |
|---|---|
| build.krum.housekeeping | loaded |
| build.krum.defect-sync | loaded |
Guards
| Guard | File | State |
|---|---|---|
| floor guard (delete and typing guard) | ~/.claude/helpers/floor-guard.sh | in place |
| Codex guard rules | ~/.codex/rules/karkhana-guards.rules | in place |
| PM inbox hook | ~/.claude/hooks/pm-watch-hook.py | in place |