feat(board): cross-repo attention board as script + skill (0.9.0)
The mailbox answers "who wrote to me"; it never answered "which repo deserves the next session". board.sh scans every discovered repo and reads three sources each: the STATE.md next-step block with its optional board line, git status, and that repo's pending mailbox count. Read-only by construction, pinned by board-selftest.sh (28 checks). It ships here rather than as a personal script because the mailbox is one of its three inputs and the two carry the same axis distinction: a pending count means others are waiting on that repo, while who a repo waits ON comes only from its board line, since the message format has no reply-to field. Splitting the board from the mailbox would put that distinction in two places. It also lets the skill resolve the engine through CLAUDE_PLUGIN_ROOT like every other script here, instead of depending on a file that exists only in ~/.claude/scripts (a directory with no remote and no backup). The skill is a ranking, not a report: re-runs the board every invocation because counts drift, ranks by what unblocks the most and what is cheapest to move, then names one repo, the rule that fired, and the real next action read from that repo's STATE.md. Never the table. Not wired into session start, which would spend context on repos the session is not in. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MubwdTi88yu4hVLAFG1LbM
This commit is contained in:
parent
ec92c866c1
commit
61e224ccc3
10 changed files with 691 additions and 13 deletions
|
|
@ -1,6 +1,6 @@
|
|||
{
|
||||
"name": "repo-mailbox",
|
||||
"version": "0.8.0",
|
||||
"version": "0.9.0",
|
||||
"description": "Local mailbox for coordination between Claude Code sessions in different repositories. Directed messages and broadcasts as plain Markdown files on your own disk, injected as context at session start. Local, private, no network.",
|
||||
"author": {
|
||||
"name": "Kjell Tore Guttormsen"
|
||||
|
|
|
|||
30
CHANGELOG.md
30
CHANGELOG.md
|
|
@ -5,6 +5,36 @@ All notable changes to this project will be documented in this file.
|
|||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
||||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||||
|
||||
## [0.9.0] - 2026-07-28
|
||||
|
||||
### Added
|
||||
|
||||
- **`board.sh` + the `board` skill — the cross-repo attention board.** The
|
||||
mailbox answers "who wrote to me"; it never answered "which repo deserves the
|
||||
next session". `board.sh` scans every discovered repo and reads three sources
|
||||
per repo: the STATE.md next-step block with its optional board line, `git
|
||||
status`, and that repo's pending mailbox count. Read-only by construction — it
|
||||
writes to no repo, no STATE.md and no mailbox — and pinned by
|
||||
`board-selftest.sh` (28 checks against a throwaway repo tree and a throwaway
|
||||
mailbox).
|
||||
|
||||
**Why it ships here rather than as a personal script.** The mailbox is one of
|
||||
its three inputs, and the two carry the same axis distinction: a repo's pending
|
||||
count means *others are waiting on it* (an obligation owed outward), while who
|
||||
a repo waits *on* is only derivable from its own board line, because the
|
||||
message format has no reply-to or thread field. Splitting the board from the
|
||||
mailbox would put that distinction in two places, and a rule enforced in one of
|
||||
two places is not a rule. It also means the engine resolves through
|
||||
`CLAUDE_PLUGIN_ROOT` like every other script here, instead of existing only on
|
||||
the author's machine.
|
||||
|
||||
The skill is a ranking, not a report: it re-runs the board on every invocation
|
||||
(counts drift between turns), ranks by what unblocks the most and what is
|
||||
cheapest to move, then names one repo, the rule that fired, and the real next
|
||||
action read from that repo's STATE.md — never the table. Deliberately not wired
|
||||
into session start: injecting the whole board into every session spends context
|
||||
on repos the session is not in.
|
||||
|
||||
## [0.8.0] - 2026-07-27
|
||||
|
||||
### Added
|
||||
|
|
|
|||
29
CLAUDE.md
29
CLAUDE.md
|
|
@ -28,8 +28,22 @@ marketplace plugin. Three components, one boundary:
|
|||
wrapper (marketplace convention: hooks are `.mjs`) that calls
|
||||
`coord-inbox.sh` and emits the `hookSpecificOutput.additionalContext`
|
||||
envelope. No mailbox logic lives here. Always exits 0.
|
||||
- **Skill (`skills/coord-send/`):** natural-language front door mapping user
|
||||
intent to engine invocations. No mailbox logic lives here either.
|
||||
- **Board (`scripts/board.sh`):** cross-repo attention board. Reads STATE.md
|
||||
next-step blocks + board lines, `git status`, and mailbox pending counts, and
|
||||
prints one line per repo. Read-only by construction: it writes to no repo, no
|
||||
STATE.md and no mailbox. Pinned by `board-selftest.sh` (28 checks).
|
||||
|
||||
**It lives here because the mailbox is one of its three inputs, and it carries
|
||||
the same axis distinction the mailbox does.** A pending count means *others
|
||||
are waiting on this repo*; who a repo waits *on* comes only from its board
|
||||
line, because the message format has no reply-to field. Enforcing that in one
|
||||
of two repos would not be enforcing it. `~/.claude/scripts/board.sh` is a
|
||||
deployed copy (the operator's `board()` shell function points at it), exactly
|
||||
as with the `coord-*` scripts — this repo is the source of truth.
|
||||
- **Skills (`skills/coord-send/`, `skills/board/`):** natural-language front
|
||||
doors mapping user intent to engine invocations. No mailbox logic lives here
|
||||
either. `board` additionally owns the *ranking* — which repo wins and why —
|
||||
since `board.sh` deliberately prints evidence and takes no position.
|
||||
|
||||
**Boundary rule:** the mailbox is transport, not state. Durable decisions
|
||||
live in the owning repo's docs/git history; messages are notices pointing at
|
||||
|
|
@ -63,21 +77,24 @@ halves together for exactly that reason.
|
|||
- Zero dependencies everywhere: bash + coreutils in the engine, `node:`
|
||||
builtins only in hook and tests.
|
||||
- TDD: no behavior change without a failing selftest check first.
|
||||
`bash scripts/coord-selftest.sh` must exit 0 (136/136).
|
||||
`bash scripts/coord-selftest.sh` must exit 0 (136/136) and
|
||||
`bash scripts/board-selftest.sh` must exit 0 (28/28).
|
||||
- English for all code, docs, and commit messages (public repo). Norwegian
|
||||
trigger aliases in the skill description are deliberate.
|
||||
- Conventional Commits: `type(scope): description`.
|
||||
|
||||
## Commands
|
||||
|
||||
- Test: `bash scripts/coord-selftest.sh` (or `npm test`, the Node wrapper)
|
||||
- Test: `bash scripts/coord-selftest.sh` and `bash scripts/board-selftest.sh`
|
||||
(or `npm test`, the Node wrapper around both)
|
||||
- Hook smoke test: `node hooks/scripts/session-start.mjs` (expects JSON on stdout)
|
||||
- Board smoke test: `bash scripts/board.sh` (read-only, ~3s over the real tree)
|
||||
|
||||
## Release
|
||||
|
||||
Version must agree across: `.claude-plugin/plugin.json`, `package.json`,
|
||||
README version badge, `skills/coord-send/SKILL.md` frontmatter, git tag
|
||||
`vX.Y.Z`, and the catalog `ref` in
|
||||
README version badge, `skills/coord-send/SKILL.md` and `skills/board/SKILL.md`
|
||||
frontmatter, git tag `vX.Y.Z`, and the catalog `ref` in
|
||||
`ktg-plugin-marketplace/catalog/.claude-plugin/marketplace.json`. Release via
|
||||
the catalog's `scripts/release-plugin.mjs repo-mailbox` (tag + ref bump
|
||||
together);
|
||||
|
|
|
|||
14
README.md
14
README.md
|
|
@ -8,10 +8,10 @@
|
|||
|
||||
*AI-generated: all code produced by Claude Code through dialog-driven development.*
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
|
@ -73,7 +73,11 @@ The plugin ships empty: your mailbox is created lazily on first send, on your ma
|
|||
|
||||
Since v0.8.0 it closes with one aggregate line about mail pending in *other* mailboxes, so an empty inbox no longer reads as "all clear" while messages sit unanswered elsewhere. Two integers, never a roster: naming the other mailboxes would put their situation inside your repo's injection, and the line explicitly disclaims the obligation it sits beneath — those counts are not yours to handle, and counting them delivered nothing.
|
||||
|
||||
**CLI.** The engine is four bash scripts in the plugin's `scripts/` directory; resolve them as `"${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}/scripts/coord-<name>.sh"` (from a terminal, use the plugin's install path):
|
||||
**Choosing between repos (the `board` skill).** "What should I work on?", "who is waiting on me?", "what unblocks the most?" — `board.sh` scans every repo it can find and reads three sources per repo: the STATE.md next-step block and its optional board line, `git status`, and the pending count in that repo's mailbox. The skill runs it, ranks by leverage (what unblocks the most, cheapest first) and answers with one repo and the rule that fired, never the table. Read-only: it writes to no repo, no STATE.md, and no mailbox. The board is deliberately *not* wired into session start — it runs when asked.
|
||||
|
||||
The mailbox is one of its three inputs, which is why the board lives here. Note the axis: a repo's pending count means *others are waiting on it*, an obligation it owes outward. Who a repo waits *on* comes only from its own board line, because the message format has no reply-to field.
|
||||
|
||||
**CLI.** The engine is six bash scripts in the plugin's `scripts/` directory; resolve them as `"${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}/scripts/coord-<name>.sh"` (from a terminal, use the plugin's install path):
|
||||
|
||||
coord-send.sh --to <repo> --subject "<subject>" [--message "<text>"] # or body on stdin
|
||||
coord-send.sh --broadcast --subject "<subject>" <<'BODY' ... BODY
|
||||
|
|
@ -82,6 +86,7 @@ Since v0.8.0 it closes with one aggregate line about mail pending in *other* mai
|
|||
coord-inbox.sh [--repo <name>] # print pending (what the hook injects)
|
||||
coord-done.sh <filename>... | --all # archive without replying
|
||||
coord-count.sh [--exclude <mailbox>] # count pending per mailbox, delivering nothing
|
||||
board.sh [--roots <dir>[,<dir>...]] # cross-repo attention board (read-only)
|
||||
|
||||
The reply/resolve hints the hook injects (`-> reply: coord-send --reply-to … | done without reply: coord-done …`) refer to these scripts.
|
||||
|
||||
|
|
@ -119,7 +124,8 @@ Note that raising the inbox's priority (Rule 7) deliberately does **not** widen
|
|||
## Development
|
||||
|
||||
bash scripts/coord-selftest.sh # 136 checks against a throwaway mailbox
|
||||
npm test # same selftest via node --test
|
||||
bash scripts/board-selftest.sh # 28 checks against a throwaway repo tree
|
||||
npm test # both selftests via node --test
|
||||
|
||||
TDD is the house rule: every behavior change lands with a failing selftest check first.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
{
|
||||
"name": "repo-mailbox",
|
||||
"version": "0.8.0",
|
||||
"version": "0.9.0",
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"engines": {
|
||||
|
|
|
|||
219
scripts/board-selftest.sh
Executable file
219
scripts/board-selftest.sh
Executable file
|
|
@ -0,0 +1,219 @@
|
|||
#!/bin/bash
|
||||
# board-selftest.sh - prove board.sh end-to-end against a throwaway repo tree
|
||||
# and a throwaway mailbox (never touches ~/repos or ~/.claude/coord). Re-run
|
||||
# after any edit to board.sh. ASCII only, bash 3.2 safe.
|
||||
#
|
||||
# Multibyte STATE.md content (em-dash, the NESTE pointing-hand) is generated
|
||||
# with printf octal escapes so this script's own source stays pure ASCII - a
|
||||
# literal em-dash in shell source has crashed bash 3.2 under `set -u` before.
|
||||
set -u
|
||||
export LC_ALL=C
|
||||
|
||||
DIR="$(cd "$(dirname "$0")" && pwd)"
|
||||
BOARD="$DIR/board.sh"
|
||||
|
||||
ROOT="$(mktemp -d)"
|
||||
CLAUDE_COORD_DIR="$(mktemp -d)"
|
||||
export CLAUDE_COORD_DIR
|
||||
cleanup() { /bin/rm -rf "$ROOT" "$CLAUDE_COORD_DIR" 2>/dev/null; }
|
||||
trap cleanup EXIT
|
||||
|
||||
PASS=0; FAIL=0
|
||||
check() { if [ "$2" -eq 0 ]; then PASS=$((PASS+1)); echo " ok - $1"; else FAIL=$((FAIL+1)); echo " FAIL - $1"; fi; }
|
||||
|
||||
# Multibyte building blocks (octal escapes keep this source ASCII).
|
||||
EMDASH="$(printf '\342\200\224')"
|
||||
HAND="$(printf '\360\237\221\211')"
|
||||
OSLASH="$(printf '\303\270')"
|
||||
|
||||
mkrepo() { mkdir -p "$1" && git -C "$1" init -q 2>/dev/null; }
|
||||
|
||||
echo "board-selftest (root: $ROOT, mailbox: $CLAUDE_COORD_DIR)"
|
||||
|
||||
# --- 0. Empty root: no repos, still exits cleanly. ---
|
||||
out0="$("$BOARD" --roots "$ROOT" 2>/dev/null)"; rc=$?
|
||||
[ "$rc" -eq 0 ]; check "empty root exits 0" $?
|
||||
|
||||
# --- Fixture tree ---------------------------------------------------------
|
||||
|
||||
# repo-a: full board line, in-progress, cheap next step, unhandled inbox.
|
||||
mkrepo "$ROOT/repo-a"
|
||||
{
|
||||
echo "# STATE - repo-a"
|
||||
echo ""
|
||||
printf '## %s NESTE %s START HER\n' "$HAND" "$EMDASH"
|
||||
echo "<!-- board: status=in-progress; blocked-on=-; next-cost=sonnet/xhigh -->"
|
||||
printf '**Lukk to MAJOR fra reviewen** %s deretter S3.3 concurrent fan-out.\n' "$EMDASH"
|
||||
} > "$ROOT/repo-a/STATE.md"
|
||||
|
||||
# repo-b: STATE + NESTE prose but NO board line (the un-backfilled majority).
|
||||
mkrepo "$ROOT/repo-b"
|
||||
{
|
||||
echo "# STATE - repo-b"
|
||||
echo ""
|
||||
printf '## %s NESTE %s START HER\n' "$HAND" "$EMDASH"
|
||||
echo ""
|
||||
printf '> Kj%sr forskningstema 1 headless %s hard gate for motorens arkitektur.\n' "$OSLASH" "$EMDASH"
|
||||
} > "$ROOT/repo-b/STATE.md"
|
||||
|
||||
# repo-c: no STATE.md at all (dormant class).
|
||||
mkrepo "$ROOT/repo-c"
|
||||
|
||||
# repo-d: dirty working tree.
|
||||
mkrepo "$ROOT/repo-d"
|
||||
{
|
||||
echo "# STATE - repo-d"
|
||||
printf '## %s NESTE %s START HER\n' "$HAND" "$EMDASH"
|
||||
echo "<!-- board: status=deferred; blocked-on=-; next-cost=sonnet/high -->"
|
||||
echo "Parkert med vilje."
|
||||
} > "$ROOT/repo-d/STATE.md"
|
||||
# Commit STATE.md first, so the dirty count proves board counts UNCOMMITTED
|
||||
# files only (2 junk files) rather than every file in a fresh tree.
|
||||
git -C "$ROOT/repo-d" add STATE.md >/dev/null 2>&1
|
||||
git -C "$ROOT/repo-d" -c user.email=t@t -c user.name=t commit -qm init >/dev/null 2>&1
|
||||
: > "$ROOT/repo-d/junk1.txt"
|
||||
: > "$ROOT/repo-d/junk2.txt"
|
||||
|
||||
# repo-e: malformed status token (must be flagged, never silently accepted).
|
||||
mkrepo "$ROOT/repo-e"
|
||||
{
|
||||
echo "# STATE - repo-e"
|
||||
printf '## %s NESTE %s START HER\n' "$HAND" "$EMDASH"
|
||||
echo "<!-- board: status=aktiv; blocked-on=-; next-cost=opus/high -->"
|
||||
echo "Ugyldig token."
|
||||
} > "$ROOT/repo-e/STATE.md"
|
||||
|
||||
# repo-g: prose containing a 'board:'-lookalike ABOVE the real board line.
|
||||
# An unanchored substring grep would match 'dashboard:' first and mis-parse the
|
||||
# whole repo; the board line is defined as living under the NESTE heading.
|
||||
mkrepo "$ROOT/repo-g"
|
||||
{
|
||||
echo "# STATE - repo-g"
|
||||
echo "Vi bygde et dashboard: status=done ble diskutert i forrige runde."
|
||||
printf '## %s NESTE %s START HER\n' "$HAND" "$EMDASH"
|
||||
echo "<!-- board: status=planned; blocked-on=-; next-cost=opus/xhigh -->"
|
||||
echo "Ekte neste steg her."
|
||||
} > "$ROOT/repo-g/STATE.md"
|
||||
|
||||
# repo-h: next-cost written the way the model rubric actually names the models,
|
||||
# with a space and capitals ("Sonnet 5/xhigh"). This is spec-conformant
|
||||
# (<modell>/<effort>) and must parse - a lowercase-only pattern silently drops
|
||||
# it to "?" and hides the cost column exactly where it is needed.
|
||||
mkrepo "$ROOT/repo-h"
|
||||
{
|
||||
echo "# STATE - repo-h"
|
||||
printf '## %s NESTE %s START HER\n' "$HAND" "$EMDASH"
|
||||
echo "<!-- board: status=in-progress; blocked-on=-; next-cost=Sonnet 5/xhigh -->"
|
||||
echo "Neste steg her."
|
||||
} > "$ROOT/repo-h/STATE.md"
|
||||
|
||||
# polyrepo/: NOT a git repo itself, but holds git repos one level down.
|
||||
mkdir -p "$ROOT/polyrepo"
|
||||
mkrepo "$ROOT/polyrepo/plug-x"
|
||||
{
|
||||
echo "# STATE - plug-x"
|
||||
printf '## %s NESTE %s START HER\n' "$HAND" "$EMDASH"
|
||||
echo "<!-- board: status=blocked; blocked-on=repo-a; next-cost=opus/high -->"
|
||||
printf 'Venter p%s amendment-pakken.\n' "$EMDASH"
|
||||
} > "$ROOT/polyrepo/plug-x/STATE.md"
|
||||
|
||||
# repo-wt + wt-feature: a git WORKTREE (and a submodule) has .git as a FILE,
|
||||
# not a directory. Measured 2026-07-26: STATE.md is TRACKED in 7 of 25 real
|
||||
# repos, so `git worktree add ~/repos/feature-x` yields a sibling directory
|
||||
# that CARRIES a STATE.md. Testing discovery for a .git DIRECTORY only drops
|
||||
# it silently - the same silent-loss class as the V6 marker fix.
|
||||
mkrepo "$ROOT/repo-wt"
|
||||
{
|
||||
echo "# STATE - repo-wt"
|
||||
printf '## %s NESTE %s START HER\n' "$HAND" "$EMDASH"
|
||||
echo "<!-- board: status=done; blocked-on=-; next-cost=sonnet/high -->"
|
||||
printf 'Hovedtreet %s ferdig.\n' "$EMDASH"
|
||||
} > "$ROOT/repo-wt/STATE.md"
|
||||
git -C "$ROOT/repo-wt" add STATE.md >/dev/null 2>&1
|
||||
git -C "$ROOT/repo-wt" -c user.email=t@t -c user.name=t commit -qm init >/dev/null 2>&1
|
||||
git -C "$ROOT/repo-wt" -c user.email=t@t -c user.name=t \
|
||||
worktree add -q -b feature-x "$ROOT/wt-feature" >/dev/null 2>&1
|
||||
# Distinct board line, so the check proves board read the STATE INSIDE the
|
||||
# worktree rather than matching the source repo's row by accident.
|
||||
{
|
||||
echo "# STATE - wt-feature"
|
||||
printf '## %s NESTE %s START HER\n' "$HAND" "$EMDASH"
|
||||
echo "<!-- board: status=in-progress; blocked-on=-; next-cost=fable/xhigh -->"
|
||||
printf 'Arbeid i worktree %s eget neste steg.\n' "$EMDASH"
|
||||
} > "$ROOT/wt-feature/STATE.md"
|
||||
|
||||
# plain-dir/: no git repo anywhere under it - must be ignored entirely.
|
||||
mkdir -p "$ROOT/plain-dir/sub"
|
||||
echo "hei" > "$ROOT/plain-dir/sub/file.txt"
|
||||
|
||||
# Coord fixture: 3 unhandled for repo-a, 1 archived (must not be counted).
|
||||
mkdir -p "$CLAUDE_COORD_DIR/repo-a/inbox" "$CLAUDE_COORD_DIR/repo-a/archive"
|
||||
for n in 1 2 3; do echo "msg" > "$CLAUDE_COORD_DIR/repo-a/inbox/2026-msg$n-from-x.md"; done
|
||||
echo "old" > "$CLAUDE_COORD_DIR/repo-a/archive/2026-old-from-x.md"
|
||||
|
||||
OUT="$("$BOARD" --roots "$ROOT" 2>/dev/null)"
|
||||
|
||||
# --- 1. Discovery ---------------------------------------------------------
|
||||
printf '%s' "$OUT" | grep -q 'repo-a'; check "discovers top-level git repo" $?
|
||||
printf '%s' "$OUT" | grep -q 'plug-x'; check "discovers nested polyrepo git repo (depth 2)" $?
|
||||
printf '%s' "$OUT" | grep -q 'repo-c'; check "lists git repo without STATE.md" $?
|
||||
printf '%s' "$OUT" | grep -q 'plain-dir'; [ $? -ne 0 ]; check "ignores non-git directory tree" $?
|
||||
printf '%s' "$OUT" | grep -q 'polyrepo'; [ $? -ne 0 ]; check "polyrepo container itself is not listed as a repo" $?
|
||||
# Guard the fixture itself: if git ever stops writing a .git FILE for
|
||||
# worktrees, the next two checks would pass for the wrong reason.
|
||||
[ -f "$ROOT/wt-feature/.git" ]; check "fixture: worktree .git is a FILE, not a dir" $?
|
||||
printf '%s' "$OUT" | grep -q 'wt-feature'; check "discovers git worktree (.git is a file)" $?
|
||||
printf '%s' "$OUT" | grep -qE 'wt-feature.*fable/xhigh'
|
||||
check "reads STATE.md from inside the worktree, not the source repo" $?
|
||||
|
||||
# --- 2. Board line parsing (the B field) ----------------------------------
|
||||
printf '%s' "$OUT" | grep -q 'in-progress'; check "parses status token from board line" $?
|
||||
printf '%s' "$OUT" | grep -q 'sonnet/xhigh'; check "parses next-cost from board line" $?
|
||||
printf '%s' "$OUT" | grep -qE 'repo-h.*Sonnet 5/xhigh'
|
||||
check "next-cost accepts spaces and capitals (rubric model names)" $?
|
||||
printf '%s' "$OUT" | grep -qE 'plug-x.*repo-a'
|
||||
check "blocked repo names its blocker on its own row" $?
|
||||
printf '%s' "$OUT" | grep -q 'deferred'; check "distinguishes deferred from blocked" $?
|
||||
|
||||
# --- 3. Malformed input is flagged, not swallowed -------------------------
|
||||
printf '%s' "$OUT" | grep -qi 'malformed\|ugyldig\|invalid'; check "malformed status token is flagged" $?
|
||||
|
||||
# A 'dashboard:' lookalike earlier in the file must not win over the real line.
|
||||
printf '%s' "$OUT" | grep -qE 'repo-g.*planned.*opus/xhigh'
|
||||
check "board-line parse ignores 'board:' lookalikes in prose" $?
|
||||
|
||||
# --- 4. Heuristic fallback when board line is absent -----------------------
|
||||
printf '%s' "$OUT" | grep -q 'repo-b'; check "repo without board line still listed" $?
|
||||
printf '%s' "$OUT" | grep -qi 'forskningstema\|headless'; check "shows NESTE excerpt when board line absent" $?
|
||||
# Markdown noise must be stripped: a blockquoted NESTE line renders as prose.
|
||||
printf '%s' "$OUT" | grep -qE 'repo-b.*[[:space:]]>'; [ $? -ne 0 ]
|
||||
check "blockquote marker stripped from NESTE excerpt" $?
|
||||
|
||||
# --- 5. Git + coord signals ------------------------------------------------
|
||||
printf '%s' "$OUT" | grep -qE 'repo-d.*[^0-9]2([^0-9]|$)'; check "reports dirty file count" $?
|
||||
printf '%s' "$OUT" | grep -qE 'repo-a.*[^0-9]3([^0-9]|$)'; check "reports unhandled coord inbox count (archive excluded)" $?
|
||||
|
||||
# --- 6. Bucketing ----------------------------------------------------------
|
||||
printf '%s' "$OUT" | grep -qi 'blocked'; check "blocked repo surfaced" $?
|
||||
printf '%s' "$OUT" | grep -qiE 'dormant|sovende|uten STATE'; check "STATE-less repos bucketed separately" $?
|
||||
|
||||
# --- 7. Robustness ---------------------------------------------------------
|
||||
# Multibyte prose must not crash the reader nor emit split-character garbage.
|
||||
[ -n "$OUT" ]; check "produces output over multibyte STATE prose" $?
|
||||
printf '%s' "$OUT" | iconv -f UTF-8 -t UTF-8 >/dev/null 2>&1
|
||||
check "output is valid UTF-8 (no split multibyte truncation)" $?
|
||||
|
||||
# A STATE.md with a NESTE heading and nothing after it must not hang or crash.
|
||||
mkrepo "$ROOT/repo-f"
|
||||
{ echo "# STATE - repo-f"; printf '## %s NESTE %s START HER\n' "$HAND" "$EMDASH"; } > "$ROOT/repo-f/STATE.md"
|
||||
"$BOARD" --roots "$ROOT" >/dev/null 2>&1; check "empty NESTE block does not crash" $?
|
||||
|
||||
"$BOARD" --help >/dev/null 2>&1; check "--help exits 0" $?
|
||||
|
||||
# Unreadable root is a no-op, not a crash.
|
||||
"$BOARD" --roots "$ROOT/does-not-exist" >/dev/null 2>&1; check "missing root is a clean no-op" $?
|
||||
|
||||
echo ""
|
||||
echo "board-selftest: $PASS passed, $FAIL failed"
|
||||
[ "$FAIL" -eq 0 ] || exit 1
|
||||
exit 0
|
||||
222
scripts/board.sh
Executable file
222
scripts/board.sh
Executable file
|
|
@ -0,0 +1,222 @@
|
|||
#!/bin/bash
|
||||
# board.sh - cross-repo attention board. Answers the one question no single
|
||||
# repo's STATE.md can: across ALL repos, which have a live next step, which are
|
||||
# blocked and on whom, which owe someone a reply, and what each costs to
|
||||
# advance. Read-only: never writes to a repo, a STATE.md, or the mailbox.
|
||||
#
|
||||
# Sources (all pre-existing, nothing invented):
|
||||
# STATE.md "NESTE" block - the next step, per repo (canonical)
|
||||
# STATE.md board line - optional machine-readable field (see below)
|
||||
# git status --porcelain - uncommitted risk
|
||||
# ~/.claude/coord/<repo>/inbox - UNHANDLED INBOUND: others addressed this
|
||||
# repo and it has not processed them. This is an
|
||||
# obligation the repo owes outward - NOT evidence
|
||||
# that the repo is waiting on anyone. The mailbox
|
||||
# format has no reply-to/thread field, so
|
||||
# outbound waiting is not derivable from it at
|
||||
# all; that is exactly what blocked-on carries.
|
||||
#
|
||||
# Board line (optional, one per STATE.md, directly under the NESTE heading):
|
||||
#
|
||||
# <!-- board: status=in-progress; blocked-on=-; next-cost=sonnet/xhigh -->
|
||||
#
|
||||
# status planned | in-progress | blocked | deferred | done
|
||||
# blocked-on <repo-name> or - (only meaningful with status=blocked)
|
||||
# next-cost <model>/<effort> from the global model rubric, e.g. opus/xhigh
|
||||
#
|
||||
# ATTENTION AXIS, NOT THE REGISTER AXIS. This status vocabulary is deliberately
|
||||
# NOT the 7-token vocabulary in ~/.claude/coord/register.md. That one describes
|
||||
# a TOPIC's status inside a repo (has this repo adopted OKF?); this one
|
||||
# describes a REPO's own next step (does this need me?). `not-applicable` is
|
||||
# meaningless here and `partial` carries register Regel 1 (eier + neste-steg),
|
||||
# which does not transfer. Conflating the two axes is the AS#5 defect class
|
||||
# register.md was written to close - keep them separate.
|
||||
#
|
||||
# Usage: board.sh [--roots <dir>[,<dir>...]] [--plain]
|
||||
# Env: CLAUDE_COORD_DIR overrides the mailbox root.
|
||||
# BOARD_ROOTS overrides the default scan roots.
|
||||
# ASCII only, bash 3.2 safe.
|
||||
set -u
|
||||
export LC_ALL=C
|
||||
|
||||
COORD="${CLAUDE_COORD_DIR:-$HOME/.claude/coord}"
|
||||
ROOTS="${BOARD_ROOTS:-$HOME/repos}"
|
||||
NESTE_WIDTH=38
|
||||
|
||||
while [ $# -gt 0 ]; do
|
||||
case "$1" in
|
||||
# bash 3.2: `shift 2` past the end of $# is a no-op -> would loop forever.
|
||||
--roots) [ $# -ge 2 ] || { echo "board: --roots requires a value" >&2; exit 2; }
|
||||
ROOTS="$2"; shift 2 ;;
|
||||
--plain) shift ;;
|
||||
-h|--help) grep '^#' "$0" | sed 's/^# \{0,1\}//'; exit 0 ;;
|
||||
*) echo "board: unknown argument: $1 (ignored)" >&2; shift ;;
|
||||
esac
|
||||
done
|
||||
|
||||
NOW="$(date +%s)"
|
||||
|
||||
# Truncate to N CHARACTERS (not bytes). A byte cut splits multibyte prose and
|
||||
# emits mojibake; macOS `cut -c` is character-aware under a UTF-8 locale.
|
||||
trunc() { printf '%s' "$1" | LC_ALL=en_US.UTF-8 cut -c1-"$2"; }
|
||||
|
||||
# --- Discovery: git repos at depth 1, plus depth 2 under polyrepo dirs ------
|
||||
# A directory that is itself a git repo is one repo; a directory that is not
|
||||
# but contains git repos is a polyrepo container (the plugin marketplace) and
|
||||
# contributes its children, never itself.
|
||||
#
|
||||
# "Is a repo" tests .git with -e, not -d: a worktree or submodule has .git as a
|
||||
# FILE. Measured 2026-07-26: STATE.md is tracked in 7 of 25 repos, so a plain
|
||||
# `git worktree add ~/repos/feature-x` lands a depth-1 sibling that CARRIES a
|
||||
# STATE.md - a -d test drops it silently. Kept identical in the rollup builder
|
||||
# (catalog) on purpose: two readers, one name.
|
||||
REPOS=""
|
||||
# Split on comma via IFS + `set --` rather than an unquoted $(...) expansion:
|
||||
# unquoted word-splitting would also split roots containing spaces. Arg parsing
|
||||
# is finished above, so clobbering the positional parameters is safe here.
|
||||
OLD_IFS="$IFS"; IFS=','
|
||||
set -- $ROOTS
|
||||
IFS="$OLD_IFS"
|
||||
for root in "$@"; do
|
||||
[ -d "$root" ] || continue
|
||||
for entry in "$root"/*; do
|
||||
[ -d "$entry" ] || continue
|
||||
if [ -e "$entry/.git" ]; then
|
||||
REPOS="$REPOS
|
||||
$entry"
|
||||
else
|
||||
for child in "$entry"/*; do
|
||||
[ -e "$child/.git" ] || continue
|
||||
REPOS="$REPOS
|
||||
$child"
|
||||
done
|
||||
fi
|
||||
done
|
||||
done
|
||||
|
||||
[ -n "$(printf '%s' "$REPOS" | tr -d '[:space:]')" ] || exit 0
|
||||
|
||||
# --- Collect one record per repo -------------------------------------------
|
||||
# Record: bucket|sortkey|name|status|cost|inbox|dirty|age|neste
|
||||
RECORDS=""
|
||||
MALFORMED=""
|
||||
|
||||
printf '%s\n' "$REPOS" | while IFS= read -r d; do
|
||||
[ -n "$d" ] || continue
|
||||
name="$(basename "$d")"
|
||||
state="$d/STATE.md"
|
||||
|
||||
dirty="$(git -C "$d" status --porcelain 2>/dev/null | wc -l | tr -d ' ')"
|
||||
[ -n "$dirty" ] || dirty=0
|
||||
|
||||
inbox=0
|
||||
if [ -d "$COORD/$name/inbox" ]; then
|
||||
inbox="$(ls "$COORD/$name/inbox"/*.md 2>/dev/null | wc -l | tr -d ' ')"
|
||||
[ -n "$inbox" ] || inbox=0
|
||||
fi
|
||||
|
||||
if [ ! -f "$state" ]; then
|
||||
last="$(git -C "$d" log -1 --format=%ct 2>/dev/null)"
|
||||
if [ -n "$last" ]; then age=$(( (NOW - last) / 86400 )); else age=-1; fi
|
||||
printf '5|%06d|%s|-|-|%s|%s|%sd|(ingen STATE.md)\n' \
|
||||
"$age" "$name" "$inbox" "$dirty" "$age"
|
||||
continue
|
||||
fi
|
||||
|
||||
mtime="$(stat -f %m "$state" 2>/dev/null)"
|
||||
if [ -n "$mtime" ]; then age=$(( (NOW - mtime) / 86400 )); else age=0; fi
|
||||
|
||||
# Anchored to the exact comment form, NOT a substring search: unanchored
|
||||
# 'board:' also matches prose like "dashboard: ..." and -m1 would let a
|
||||
# lookalike higher up the file win over the real line.
|
||||
line="$(grep -m1 '^<!-- board:' "$state" 2>/dev/null)"
|
||||
status=""; blockedon=""; cost=""
|
||||
if [ -n "$line" ]; then
|
||||
status="$(printf '%s' "$line" | sed -n 's/.*status=\([a-z-]*\).*/\1/p')"
|
||||
blockedon="$(printf '%s' "$line" | sed -n 's/.*blocked-on=\([A-Za-z0-9._-]*\).*/\1/p')"
|
||||
# Value runs to the next ';' or the closing '-->', NOT to the first
|
||||
# non-lowercase byte: the rubric names models "Sonnet 5 / xhigh", so a
|
||||
# lowercase-only class silently drops spec-conformant values to "?".
|
||||
cost="$(printf '%s' "$line" | sed -n 's/.*next-cost=\([^;>]*\).*/\1/p' \
|
||||
| sed -e 's/--$//' -e 's/[[:space:]]*$//' -e 's/^[[:space:]]*//')"
|
||||
fi
|
||||
|
||||
case "$status" in
|
||||
planned|in-progress|blocked|deferred|done) ;;
|
||||
"") status="?" ;;
|
||||
*) status="MALFORMED:$status" ;;
|
||||
esac
|
||||
[ -n "$cost" ] || cost="?"
|
||||
|
||||
# First content line under the NESTE heading: skip blanks, HTML comments and
|
||||
# the heading itself; strip markdown bold/bullet noise.
|
||||
neste="$(awk '
|
||||
/NESTE/ { flag=1; next }
|
||||
flag {
|
||||
if ($0 ~ /^[[:space:]]*$/) next
|
||||
if ($0 ~ /^[[:space:]]*<!--/) next
|
||||
if ($0 ~ /^#/) next
|
||||
print; exit
|
||||
}' "$state" 2>/dev/null \
|
||||
| sed -e 's/^[[:space:]]*>[[:space:]]*//' -e 's/\*\*//g' \
|
||||
-e 's/^[[:space:]]*[-*][[:space:]]*//' -e 's/^[[:space:]]*//' -e 's/`//g')"
|
||||
[ -n "$neste" ] || neste="(tom NESTE-blokk)"
|
||||
neste="$(trunc "$neste" "$NESTE_WIDTH")"
|
||||
|
||||
disp="$status"
|
||||
if [ "$status" = "blocked" ] && [ -n "$blockedon" ] && [ "$blockedon" != "-" ]; then
|
||||
disp="blocked>$blockedon"
|
||||
fi
|
||||
|
||||
case "$status" in
|
||||
blocked) bucket=1 ;;
|
||||
MALFORMED:*) bucket=2 ;;
|
||||
in-progress|planned|"?") bucket=2 ;;
|
||||
deferred) bucket=3 ;;
|
||||
done) bucket=4 ;;
|
||||
*) bucket=2 ;;
|
||||
esac
|
||||
|
||||
printf '%s|%06d|%s|%s|%s|%s|%s|%sd|%s\n' \
|
||||
"$bucket" "$age" "$name" "$disp" "$cost" "$inbox" "$dirty" "$age" "$neste"
|
||||
done > "${TMPDIR:-/tmp}/board.$$"
|
||||
|
||||
RECORDS="${TMPDIR:-/tmp}/board.$$"
|
||||
trap '/bin/rm -f "$RECORDS" 2>/dev/null' EXIT
|
||||
|
||||
hdr() {
|
||||
printf '\n%s\n' "$1"
|
||||
printf '%-32s %-34s %-14s %4s %4s %6s %s\n' \
|
||||
"REPO" "STATUS" "KOST" "INN" "DRT" "ALDER" "NESTE"
|
||||
}
|
||||
|
||||
rows() {
|
||||
awk -F'|' -v b="$1" '$1==b' "$RECORDS" | sort -t'|' -k2,2n | \
|
||||
while IFS='|' read -r bucket sortkey name status cost inbox dirty age neste; do
|
||||
printf '%-32s %-34s %-14s %4s %4s %6s %s\n' \
|
||||
"$name" "$status" "$cost" "$inbox" "$dirty" "$age" "$neste"
|
||||
done
|
||||
}
|
||||
|
||||
count() { awk -F'|' -v b="$1" '$1==b' "$RECORDS" | wc -l | tr -d ' '; }
|
||||
|
||||
echo "BOARD - tverr-repo oppmerksomhetstavle ($(awk 'END{print NR}' "$RECORDS") repo)"
|
||||
echo "INN = uhaandtert innboks (andre venter paa DEG). DRT = ukommiterte filer."
|
||||
|
||||
[ "$(count 1)" -gt 0 ] && { hdr "BLOKKERT (venter paa ekstern avhengighet)"; rows 1; }
|
||||
[ "$(count 2)" -gt 0 ] && { hdr "AKTIV (reelt neste steg)"; rows 2; }
|
||||
[ "$(count 3)" -gt 0 ] && { hdr "UTSATT (deferred - bevisst valg, ikke venting)"; rows 3; }
|
||||
[ "$(count 4)" -gt 0 ] && { hdr "FERDIG"; rows 4; }
|
||||
[ "$(count 5)" -gt 0 ] && { hdr "UTEN STATE.md (sovende / ubestemt tilstand)"; rows 5; }
|
||||
|
||||
# Obligations and risk read across buckets, so they get their own roll-up.
|
||||
tot_in="$(awk -F'|' '{s+=$6} END{print s+0}' "$RECORDS")"
|
||||
tot_dirty="$(awk -F'|' '{s+=$7} END{print s+0}' "$RECORDS")"
|
||||
n_mal="$(grep -c 'MALFORMED' "$RECORDS" 2>/dev/null | tr -d ' ')"
|
||||
n_nofield="$(awk -F'|' '$4=="?"' "$RECORDS" | wc -l | tr -d ' ')"
|
||||
|
||||
printf '\nSUM: %s uhaandterte innboks-meldinger, %s ukommiterte filer.\n' "$tot_in" "$tot_dirty"
|
||||
[ "${n_mal:-0}" -gt 0 ] && printf 'ADVARSEL: %s repo har MALFORMED status-token (utenfor det lukkede settet).\n' "$n_mal"
|
||||
[ "${n_nofield:-0}" -gt 0 ] && printf 'MERK: %s repo mangler board-linje - status/kost er ukjent (?), NESTE-utdrag brukes.\n' "$n_nofield"
|
||||
|
||||
exit 0
|
||||
175
skills/board/SKILL.md
Normal file
175
skills/board/SKILL.md
Normal file
|
|
@ -0,0 +1,175 @@
|
|||
---
|
||||
name: board
|
||||
description: >-
|
||||
Answer "which repository deserves the next session" across every repo at once,
|
||||
using the local cross-repo attention board (`board.sh`) as the evidence. Use
|
||||
whenever the user asks what to work on next, who is waiting on them, what
|
||||
unblocks the most other work, what is cheapest to move under quota pressure, or
|
||||
for a cross-repo status read: "what should I work on", "who is waiting on me",
|
||||
"what unblocks the most", "show the board", "what is cheapest to move",
|
||||
"cross-repo status", "where is the leverage", "which repo is blocked". Also
|
||||
triggers on Norwegian phrasings: "hva skal jeg jobbe med", "hvem venter på meg",
|
||||
"hva løsner mest", "vis tavlen", "hva er billigst å flytte", "hvor bør jeg
|
||||
begynne", "status på tvers av repo", "hva er blokkert". Trigger even when the
|
||||
user names no repo and no tool — choosing *between* repos is this skill. Not for
|
||||
"where were we" inside the current repo: that is this repo's own STATE.md,
|
||||
already injected at session start.
|
||||
version: "0.9.0"
|
||||
---
|
||||
|
||||
# board — which repo deserves the next session
|
||||
|
||||
This skill turns "what should I work on" into a decision backed by measurement.
|
||||
`board.sh` is the engine; this skill is the ranking and the answer. The script is
|
||||
read-only by construction — it never writes to a repo, a STATE.md, or the mailbox
|
||||
— so running it is always safe and needs no confirmation.
|
||||
|
||||
The failure mode this skill exists to prevent is dumping the table. The board
|
||||
prints one line per repo across every repo on the machine; pasting that back is
|
||||
not an answer, it is the question again in table form. Run it, read it, name one
|
||||
repo.
|
||||
|
||||
## The engine
|
||||
|
||||
Resolve the script path portably — this expression is correct both when the skill
|
||||
runs bundled inside the plugin and when the scripts are installed as personal
|
||||
scripts under `~/.claude/scripts/`:
|
||||
|
||||
BOARD="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}/scripts/board.sh"
|
||||
|
||||
"$BOARD" # every repo under the default roots
|
||||
"$BOARD" --roots <dir>[,<dir>...] # scan somewhere else
|
||||
|
||||
`BOARD_ROOTS` overrides the default scan roots and `CLAUDE_COORD_DIR` the mailbox
|
||||
root. Exit 0 is normal (0 discovered repos also exits 0, silently); exit 2 means a
|
||||
malformed argument — read stderr and fix it rather than retrying.
|
||||
|
||||
**Re-run it every single invocation.** Never answer from a board you ran earlier
|
||||
in the session, from a number quoted in a document, or from memory. Inbox counts,
|
||||
uncommitted files and board lines all change between turns, and a recommendation
|
||||
built on a stale count is the exact defect the operator's premise-verification
|
||||
rule exists to stop. The run costs about three seconds.
|
||||
|
||||
## What the columns mean
|
||||
|
||||
| Column | Meaning |
|
||||
|---|---|
|
||||
| `STATUS` | `planned` / `in-progress` / `blocked` / `deferred` / `done`, or `blocked>X` naming the repo it waits on. `?` means the STATE.md has no board line. |
|
||||
| `KOST` | Model/effort for the next step, from the global rubric. |
|
||||
| `INN` | Unhandled inbox: **other repos are waiting on THIS one**. An obligation it owes outward. |
|
||||
| `DRT` | Uncommitted files. |
|
||||
| `ALDER` | Days since STATE.md last changed. |
|
||||
| `NESTE` | First line of the STATE.md next-step block, truncated. |
|
||||
|
||||
**`INN` never means "this repo is waiting on someone."** It means the opposite:
|
||||
messages arrived and were not handled. The mailbox format carries no reply-to or
|
||||
thread field, so outbound waiting is not derivable from it at all — `blocked>X` is
|
||||
the only source for who a repo waits *on*. Conflating the two axes is a known
|
||||
defect class here; keep them apart in every sentence you write.
|
||||
|
||||
## How to rank
|
||||
|
||||
Apply in order and stop at the first that discriminates. Always say which rule
|
||||
fired — the rule is the justification, and it is what lets the operator disagree.
|
||||
|
||||
1. **Unblocks the most.** A repo that others are `blocked>` on. Moving it converts
|
||||
several blocked repos to active: the highest leverage per token spent. Follow
|
||||
the chain — if A is blocked on B and B is blocked on C, the answer is C.
|
||||
2. **Cheap and blocking.** Among unblockers, prefer the lowest `KOST`. This is the
|
||||
standing rule under quota pressure: take the cheap blocking one first.
|
||||
3. **Owes the most outward.** High `INN` means other sessions are stalled waiting
|
||||
for a reply. Answering is procedurally mandatory anyway, so this work is owed
|
||||
regardless of what else is on the board.
|
||||
4. **Uncommitted risk.** High `DRT` is not urgent work, but it is exposure worth
|
||||
naming: the config backup mirrors commits, not working trees, so uncommitted
|
||||
files exist in exactly one place.
|
||||
|
||||
**`ALDER` is never a ranking input.** An old STATE.md often means a finished repo,
|
||||
not a neglected one. Report it only if the user asks about staleness directly.
|
||||
|
||||
`deferred` is a deliberate choice, not neglect — do not surface a deferred repo as
|
||||
a candidate unless nothing else qualifies, and say that it was deferred if you do.
|
||||
|
||||
## Read the winner's STATE.md before answering
|
||||
|
||||
The `NESTE` column is truncated to fit the table, so it is a pointer, not the
|
||||
action. Once ranking picks a repo, open that repo's `STATE.md` and read the actual
|
||||
next-step block. Report the real first action from that block. A truncated
|
||||
fragment quoted as if it were the next step is a wrong answer that looks right.
|
||||
|
||||
## The answer
|
||||
|
||||
Short prose, roughly five to ten lines. No table, no per-repo rundown, no top-five
|
||||
list — "top five with their columns" is still a dump.
|
||||
|
||||
- **The repo**, named once.
|
||||
- **Why it won**, as the rule that fired.
|
||||
- **The concrete first action**, from that repo's STATE.md next-step block.
|
||||
- **What it costs** — the `KOST` value, so the operator can set model and effort
|
||||
before starting.
|
||||
- **Runner-up in one clause**, only if it is genuinely close.
|
||||
|
||||
If the user asked a narrower question ("who is waiting on me", "what is cheapest"),
|
||||
answer that question directly from the same run instead of forcing the full
|
||||
ranking onto them.
|
||||
|
||||
## Coverage gaps you must name
|
||||
|
||||
A ranking is only as honest as its inputs, and two gaps are invisible in the answer
|
||||
unless you state them:
|
||||
|
||||
- **Repos with no board line** render `?` in status and cost, so they drop out of
|
||||
exactly the sort the board exists for. The script counts them in its closing
|
||||
note. Pass that count through as one clause ("N repos have no board line and are
|
||||
outside this ranking"), and never let it grow into a side quest — adding board
|
||||
lines to other repos is that repo's work, not this session's.
|
||||
- **`MALFORMED` status tokens** mean a board line outside the closed vocabulary.
|
||||
The script warns; repeat the warning and name the repo, because a malformed line
|
||||
silently misplaces a repo in the wrong bucket.
|
||||
|
||||
Repos with no STATE.md at all appear in their own group. They are not candidates —
|
||||
there is no next step to read — but a large uncommitted count in one is worth a
|
||||
sentence under rule 4.
|
||||
|
||||
## Boundaries
|
||||
|
||||
- **Read-only, both ways.** The script writes nothing, and neither should the
|
||||
skill. Do not fix a missing board line, edit another repo's STATE.md, or send a
|
||||
coord message as a side effect of ranking. Recommend; the operator decides.
|
||||
- **Not a session-start hook.** Injecting the board into every session costs real
|
||||
context about repos the session is not in. It runs when asked, never on a timer.
|
||||
- **Coordination metadata is private.** Repo names, blocking chains and inbox
|
||||
counts are local operational data and never belong on a public surface.
|
||||
|
||||
## Examples
|
||||
|
||||
Placeholder names throughout — resolve real ones from the run, never from a
|
||||
document.
|
||||
|
||||
**Example 1 — the ordinary ask**
|
||||
Input: "hva skal jeg jobbe med nå?"
|
||||
Action: run the board. `repo-a` is `blocked>repo-b`, and `repo-b` is active at a
|
||||
low cost. Answer: `repo-b`, rule 1 + 2 (cheap and unblocks `repo-a`), the first
|
||||
action read from `repo-b/STATE.md`, and its `KOST`.
|
||||
|
||||
**Example 2 — quota pressure**
|
||||
Input: "jeg har lite kvote igjen, hva er billigst å flytte?"
|
||||
Action: run the board, restrict to candidates whose `KOST` is at the low end of the
|
||||
rubric, and prefer one that also unblocks something. Name the cost explicitly.
|
||||
|
||||
**Example 3 — the obligation question**
|
||||
Input: "hvem venter på meg?"
|
||||
Action: read `INN` only. List the repos with unhandled mail and say that this is
|
||||
mail owed outward, not repos this one is waiting on. Do not rank; the question was
|
||||
narrower than the ranking.
|
||||
|
||||
**Example 4 — chain following**
|
||||
Input: "what unblocks the most?"
|
||||
Action: build the `blocked>` chain from the run, and name the repo at its root,
|
||||
plus how many repos come free when it moves.
|
||||
|
||||
**Example 5 — nothing qualifies**
|
||||
Input: "vis tavlen"
|
||||
Action: if every repo is `done` or `deferred`, say so plainly and name the largest
|
||||
uncommitted exposure instead of inventing a candidate. An empty board is a real
|
||||
answer.
|
||||
|
|
@ -15,7 +15,7 @@ description: >-
|
|||
covers retiring a broadcast that has become wrong or obsolete: "retract that
|
||||
broadcast", "that announcement is outdated, pull it", "trekk tilbake kringkastingen",
|
||||
"den broadcasten er utdatert".
|
||||
version: "0.8.0"
|
||||
version: "0.9.0"
|
||||
---
|
||||
|
||||
# coord-send — natural-language front door for inter-repo messages
|
||||
|
|
|
|||
|
|
@ -16,6 +16,15 @@ test('coord bash selftest passes', () => {
|
|||
execFileSync('bash', [join(root, 'scripts', 'coord-selftest.sh')], { encoding: 'utf8' });
|
||||
});
|
||||
|
||||
// board.sh reads this plugin's mailbox for its INN column, so the board ships
|
||||
// here rather than only as a personal script. Pinning the selftest from the
|
||||
// plugin root is what makes that ownership real: the skill resolves the engine
|
||||
// through CLAUDE_PLUGIN_ROOT, so a board.sh that exists only in
|
||||
// ~/.claude/scripts/ would be missing on exactly the path production uses.
|
||||
test('board bash selftest passes', () => {
|
||||
execFileSync('bash', [join(root, 'scripts', 'board-selftest.sh')], { encoding: 'utf8' });
|
||||
});
|
||||
|
||||
// The engine refuses to invent an identity from the cwd, but the hook is the
|
||||
// FOURTH place repo identity is derived, and a rule enforced in three of four
|
||||
// places is not a rule: as long as the hook resolved the name itself and passed
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue