@lovek4d/kickflip 0.1.0 → 0.3.1

package/board/bin/agent.mjs

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import{main as r}from"./board.mjs";import{migrateOnStart as i}from"../../bin/install.mjs";i(),process.exitCode=await r(["builder",...process.argv.slice(2)]);
+import{main as e}from"./board.mjs";process.exitCode=await e(["builder",...process.argv.slice(2)]);

package/board/bin/board.mjs

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-var _=Object.defineProperty;var l=(e,s)=>_(e,"name",{value:s,configurable:!0});import{routeRecord as S}from"../../hub/routes.mjs";import g from"node:fs";import f from"node:path";import{spawnSync as O}from"node:child_process";import{fileURLToPath as C,pathToFileURL as E}from"node:url";import*as n from"../store.mjs";import{makeWorktree as q,land as T,skillRepo as L,worktreesDir as N}from"../worktree.mjs";import{ITEM_STATUSES as F}from"../domain.mjs";import{boardAt as K,readManifest as M}from"../../hub/boards.mjs";import{boardRepo as D}from"../../hub/board-repo.mjs";import{pushKindError as B}from"../../hub/push.mjs";import{migrateOnStart as H}from"../../bin/install.mjs";const U=`usage: node board.mjs <command> [--site <route>] ...
+var P=Object.defineProperty;var n=(e,t)=>P(e,"name",{value:t,configurable:!0});import{readiness as N,reportSlack as E}from"../../hub/readiness.mjs";import{readSlack as L,setSlack as H}from"../../hub/slack.mjs";import{routeRecord as k}from"../../hub/routes.mjs";import w from"node:fs";import m from"node:path";import{pathToFileURL as B}from"node:url";import*as i from"../store.mjs";import{boardWorktree as D,builderRepo as M,holdingLandLock as W,land as z,worktreesDir as G}from"../worktree.mjs";import{fileFindings as J}from"../arch-review.mjs";import{ITEM_STATUSES as F}from"../domain.mjs";import{readManifest as U}from"../../hub/boards.mjs";import"../../hub/board-repo.mjs";import{pushKindError as K}from"../../hub/push.mjs";const Q=`usage: node board.mjs <command> [--site <route>] ...
 
 Writes a kickflip board's data files. --site <route> picks ~/.claude/kickflip/sites/<route>, and its
 board.json says where the board's waves live. Without --site, waves come from ~/.claude/waves.
 Paths resolve under $HOME, so HOME=<dir> points every command at a copy.
 A --file argument of - reads stdin.
-item add and followup add create a ticket in the board\u2019s source unless --ticket <id> links one.
+item add creates a ticket in the board\u2019s source unless --ticket <id> links one.
 Internal defaults to INT; GitHub and Linear create an issue from the title and notes, Linear in the board's team and
 project through Hub's Linear key. A linked ticket must exist in the source; an Internal one no other card holds.
 Asks have no ticket; item set --from-ask creates one when the card has none.
@@ -14,11 +14,12 @@ merged \u2192 Done (a GitHub issue closes), only for a ticket assigned to the ow
 can't move prints one "ticket <id>: \u2026" line; the card's change still stands.
 A Linear board without Hub's key hands Linear to the session: a linked id is checked on its pattern alone, and a card
 needing an issue, or a ticket to move, prints a "ticket" line saying what to do through your Linear MCP, such as
-creating the issue and running item set <wave>/<id> --ticket <id> (followup set for a follow-up).
+creating the issue and running item set <wave>/<id> --ticket <id>.
 
-  reply <eventId> (--html <text> | --file <path>)        data/replies/<eventId>.html
-  working <eventId>                                      marks an ask or thread message started; the page
-                                                         shows "Working on it" until a reply or later thread line
+  reply <eventId> (--html <text> | --file <path>)        data/replies/<eventId>.html. A reply to an ask resolves its
+                                                         answered questions (topic item:ask:<eventId>), and one to
+                                                         wave-triage its wave's, noting "Acted on: replied". A
+                                                         reply to todo-triage ends that triage
   thread <wave>/<id> --text <t> [--link <url>]           one line in the item's thread; ask:<eventId> in place
          [--who claude|love|<name>] [--via github|slack] of <wave>/<id> writes in that ask's thread
          A Claude thread line, or a reply to an ask or item-message, rewrites the body of the thread's
@@ -27,8 +28,9 @@ creating the issue and running item set <wave>/<id> --ticket <id> (followup set
   topic add <id> --title <t> [--summary <s>]             a question topic in data/owner.json
   question add --file <json>                             one question or an array of them:
          {id, topic, question, options: [{id, label, recommended?, detail?, diagram?, practice?}],
-          source?, context?, url?, urgent?}; topic is declared, item:<wave>/<id>, or item:ask:<eventId>
-          for a New card not sorted yet.
+          source?, context?, url?, urgent?, round_of?}; topic is declared, item:<wave>/<id>, item:ask:<eventId>
+          for a New card not sorted yet, lineup:<slug> for a wave's triage, or wave:<slug> for a wave file's triage on
+          a board over ~/.claude/waves. A merged card's topic is refused; a question on a done card reopens it.
          url is http(s), or a site page such as prototype-<topic>.html?q=<id>, stored as given.
          Prototype options keep take order, ids matching take keys; recommended: true tags the recommendation.
          Waiting on you shows fitting takes in a grid, or a chooser above one full-width take for a single take or if any
@@ -37,12 +39,18 @@ creating the issue and running item set <wave>/<id> --ticket <id> (followup set
          danger|success, to the next row's box indexes (default all); practice: ["<line>", \u2026]
          A prototype url's topic must be recorded (prototype add), its option ids a non-empty subset of the
          take keys in take order, without repeats, and every take file written; a hand-written prototype-*.html
-         is refused. On an item: topic, each question answered and still waiting on Claude is resolved,
-         noting "Followed by <new id>", and printed as "resolved: <old id>". Any other unresolved question
-         on the same topic that links the same prototype is resolved, noting "Replaced by <new id>", and
-         printed as "replaced: <old id>". Answering or resolving a question drops its queued push tagged
-         q-<id> on this site.
-  question resolve <id> --note <text>                    sets resolved and resolved_at
+         is refused. On an item: topic, each other question answered and still waiting on Claude is
+         resolved, noting "Followed by <new id>", and printed as "resolved: <old id>". Any other unresolved
+         question on the same topic that links the same prototype is resolved, noting "Replaced by <new id>",
+         and printed as "replaced: <old id>". round_of names the question on the same topic whose
+         prototype-request this answers; the question needs a prototype url, takes the next round
+         number, and resolves that one, noting "Followed by prototype round N".
+         The board server pushes the new open questions itself, under the card's tag (item-<wave>/<id>, or
+         ask-<eventId>) or topic-<topic> off the cards
+  question resolve <id> --note <text>                   sets resolved and resolved_at; refuses a question on a
+         prototype page until an answer settles its round: a pick, with a note or none, or an answer to
+         an "Is this it?" confirm already on the board. A question already resolved, such as one an
+         answer with a note and no option resolved, is left as it is
   prototype add <topic> --title <t> --take <K>:<label>   records a prototype in data/prototypes.json: the board
          [--take <K>:<label> \u2026] [--card <wave>/<id>]     serves prototype-<topic>.html from its one template, with
                                                          the title, a back arrow to --card (else the board), the
@@ -51,21 +59,46 @@ creating the issue and running item set <wave>/<id> --ticket <id> (followup set
                                                          "A. ", since the pill shows it alone. Prints each take
                                                          file to write,
                                                          public/prototypes/<topic>/<K>.js, which exports
-                                                         render(stage, kit) (board/public/prototype-kit.js lists kit)
+                                                         render(stage, kit) (board/public/prototype-kit.js lists kit).
+                                                         --card starts that card: it leaves Todo
   prototype list                                         one line per recorded prototype
   prototype rm <topic>                                   drops the record, keeping its take files; refuses while an
                                                          open question links it
+  pr <wave>/<id>                                         one JSON line: the card's PR state, checks and new events,
+                                                         using the board's repo, github-login and the card's gh_since
   item set <wave>/<id> [--status <s> | --clear-status]   edits the item in its wave file
          [--next <t> | --clear-next] [--pr <n>]          status: ${F.join(", ")}
                                                          an empty --next "" clears it, as --clear-next does
                                                          naming another unfinished card requires it in --deps
-         [--from-ask <eventId>]                          the ask it came from: its New card gives way to this item,
-                                                         whose thread opens with the ask and its thread; it leaves
-                                                         a card it was folded into
-         [--held | --unheld]                             --held sets held: true, for the owner's card-hold;
-                                                         --unheld clears it and a held status
+         [--pushed <branch>]                             on a board whose repo is a plain git remote (no GitHub):
+                                                         the card's branch is pushed there, so it waits In Review
+                                                         on the owner's merge. Push it first (git push origin
+                                                         <branch>). The hub's repo fetch moves it to Done once the
+                                                         branch is merged into the board's branch or gone from the
+                                                         remote. Clears building/fixing as --pr does
+         [--gh-since <ISO time>]                         records the last handled GitHub event, an ISO-8601 UTC
+                                                         time such as 2026-10-23T11:00:00Z, stored as given
+         [--from-ask <eventId> --text <t>]               the ask it came from: its New card gives way to this item,
+                                                         whose thread opens with the ask and its thread, then --text
+                                                         as the item's first line; it leaves a card it was folded into; refuses a card
+                                                         from another ask (use item relate-ask)
+         [--state ready|grilling|prototyping]            what a card from an ask does next; it reads New until set.
+                                                         ready refuses while the card has an open question
+         [--held | --unheld | --pick-up-at <time>]       holds or resumes the card on the owner's words; the board
+                                                         server records the owner's own Hold and Resume taps. A later
+                                                         --held/--unheld overrides a tap; --unheld also clears a held status.
+                                                         --pick-up-at holds it until an ISO time such as
+                                                         2026-11-04T09:00 (the Mac's local time without an
+                                                         offset; a past time is refused), stored as UTC
+                                                         pick_up_at. Within a minute of it the board server
+                                                         resumes the card, adds a thread line, and appends
+                                                         card-unblocked {key, until} unless a dep is unfinished.
+                                                         --held holds it with no time; --pick-up-at "" resumes it
          [--ticket <id>]                                links a ticket in the board\u2019s source
          [--title <t>]                                   renames the card
+         [--size small|large] [--model opus|sonnet]      what builder pick reads while the hub's Claude model is
+                                                         Auto: a small card gets Claude Sonnet, any other Opus, and
+                                                         --model wins over --size; "" clears either
          [--notes-file <file>]                           the item's notes: a .md file inside its wave's folder,
                                                          named relative to it, holding the session's understanding
                                                          of the task so far. The open card's Notes link opens it,
@@ -74,31 +107,46 @@ creating the issue and running item set <wave>/<id> --ticket <id> (followup set
                                                          Claude, noting "Recorded in the card's notes", and
                                                          prints "resolved: <id>" for each
          [--deps <id>,<wave>/<id>]                       replaces its blocked-by list; --deps "" clears it
+         [--parent <wave>/<id>]                          sets its Parent, refusing itself or a card below it;
+                                                         --parent "" clears it
+         [--related <id>,<wave>/<id>]                    replaces the cards it is Related to, which both cards
+                                                         show; --related "" clears it, on both
          [--install <url> [--install-sha <sha>]          a device build the owner installs from the card's Install
           [--install-label <text>] | --clear-install]    button, stamped built_at now: itms-services://?action=
                                                          download-manifest&url=https://\u2026/manifest.plist for iOS,
                                                          an https:// .apk URL for Android. --install-sha is the
                                                          head it was built from: the badge reads "Install (stale)"
                                                          once the branch moves past it. Hidden once the card is Done
+         [--text <t>]                                    with --status done or dropped, required on a site: the
+                                                         card's closing line, written last in its thread. merged
+                                                         writes "Merged PR #n." unless --text says otherwise
+         builder start for a build sets building itself. --status building resolves the card's answered
+         questions, noting "Acted on: build started".
          --status building refuses while the item is held or a dep isn't done, merged or dropped,
-         and while the newest owner answer to its questions that link a prototype-*.html page has a
-         note: post the final version with prototype add and question add first.
-         [--confirmed "<owner's words>"] passes when that note itself says go: the words must quote
-         it, and they go in a thread line on the card;
+         and while the newest owner answer to its questions that link a prototype-*.html page picks
+         no take; a pick's note is the build's guidance;
          done, merged and dropped print "unblocked: <wave>/<id>" and append card-unblocked {key}
          once per unblocking, including held cards: start each unheld card next.
          building and fixing count as working only while a builder record on the card is open.
          --pr clears building/fixing and closes ordinary builders; install builders keep running.
-         checking is a builder's hand-back: In Progress, reading "Orchestrator review",
-         until the owning session verifies it and sets done; it unblocks nothing.
-         Every --status or --clear-status records status_at, which ends the Done button's "Closing\u2026"
-         for the owner's card-done; apply a card-done with --status done.
+         checking is a builder's hand-back of work it couldn't land: In Progress, reading "Orchestrator
+         review", until the owning session takes it on; it unblocks nothing.
+         The board server records the owner's card-done in the wave file itself.
+         Every --status or --clear-status records status_at; a later status change overrides the tap.
          --status done, merged or dropped closes the card: it resolves each of its questions (topic
          item:<wave>/<id>) that has an answer, noting "Closed with the card", and prints "resolved: <id>"
          for each. It refuses while one has no answer yet; [--force] closes it and resolves that one too
-  item add <wave>/<id> --title <t> [--notes <t>]          a new card, planned (waiting when it has --deps); never
+  item add <wave>[/<id>] --title <t> [--notes <t>]       a new card, planned (waiting when it has --deps); never
          [--ticket <id>] [--deps <id>,<wave>/<id>]       hand-edit wave.json to add one. Refuses an id the wave has.
          [--notes-file <file>]                           --plan is an alias of --notes-file
+         [--pick-up-at <time>]                           holds it until then, as item set's --pick-up-at
+         [--size small|large] [--model opus|sonnet]      as item set's
+         [--parent <wave>/<id>]                          the card it was spun out of, such as one filed from
+                                                         another card's thread, grill or answer: it reads as a
+                                                         follow-up, and its Parent lists it in Children. A card
+                                                         from the + or New task has none
+         Without /<id>, the card takes its ticket's id (GH-<n> for issue #n); pass an id only to import a
+         card. Prints "<label> added as <key>": use the key in later commands
   item relate-ask <eventId> <wave>/<id> --summary <t>   folds an ask about an existing item into it: the ask's
                                                          card goes, its message and thread show in the item's
                                                          thread marked Moved, then the summary line. Again with
@@ -116,18 +164,33 @@ creating the issue and running item set <wave>/<id> --ticket <id> (followup set
                                                          A card the ask became is dropped, unless it has started.
                                                          Refuses a route that isn't another board, and an ask
                                                          that isn't New
-  hello-ack <eventId>                                    answers the hub's hello: data/handshake.json records that the
-                                                         session hears the board, which clears the setup checklist's
-                                                         Events step. Refuses an older hello than the newest
   checked [--every <minutes> | --idle]                   data/checked.json: GitHub was just checked, next in
-                                                         <minutes> (default 30); run it at the end of each monitor tick.
-                                                         --idle: the board shows no open PR, so never late.
+                                                         <minutes> (default the polling window's, as kickflip
+                                                         polling prints); run it at the end of each GitHub tick.
+                                                         --idle: the board shows no open PR, so never late; with
+                                                         neither flag it is idle while no card has an open PR.
                                                          Then sends the queued pushes, each on its own, unless
                                                          pushes are held (overnight, snoozed, the weekend or off)
-  followup add <wave> --id <id> --title <t> [--from <item id>] [--ticket <id>]
-  followup done <wave> <id> [--force]                    closes the follow-up's card as item set --status done does
-  followup set <wave> <id> --ticket <id>                links the follow-up's ticket in the board's source
-  tickets backfill [--dry-run]                           gives every open card and follow-up without a ticket one: the first
+  lineup create <slug> --title <t> --goal <t>            a wave, in the owner's words: a named set of cards in
+         --cards <wave>/<id>,\u2026 (--note <t> | --file <f>)  build order, all from one wave file. Each card is then
+                                                         blocked by the one before it (its other deps stay), and
+                                                         the note goes to lineup-<slug>.md beside the wave file.
+                                                         The board's Waves section shows it with its goal and
+                                                         order, its cards carry its chip, and Notes opens the
+                                                         goal, the order and the note. Refuses a card already in
+                                                         another open wave. Prints the order by card label
+  lineup add <slug> <wave>/<id> [--after <wave>/<id>]    puts a card in the wave, last unless --after, and chains
+                                                         the order again
+  lineup remove <slug> <wave>/<id>                       takes a card out: it loses its links to the wave's cards,
+                                                         and the card after it is blocked by the one before
+  lineup set <slug> [--title <t>] [--goal <t>]           renames the wave, sets its goal or rewrites its note
+         [--note <t> | --file <f>]
+  lineup finish <slug>                                   the wave leaves the Waves section; its cards keep their
+                                                         links. A wave whose cards are all Done leaves it too
+         The Waves section's Triage sends wave-triage {lineup}, or {wave} for a wave file's row; the row reads
+         Triaging\u2026 until you reply to that event, then "Triage: N open questions" while questions on topic
+         lineup:<slug> or wave:<slug> are open or answered
+  tickets backfill [--dry-run]                           gives every open card without a ticket one: the first
                                                          id in its title (or legacy linear list) from the board's
                                                          source is linked, else a new ticket is made. Done cards are
                                                          left alone. Prints each card's result; --dry-run changes and
@@ -137,6 +200,26 @@ creating the issue and running item set <wave>/<id> --ticket <id> (followup set
                                                          The settings page lists them; new waves copy them
   reviewers add --file <json>                            one reviewer or an array; replaces the same name
   reviewers remove <name>...                             refuses a name the board doesn't have
+  slack                                                 Slack identity as JSON; imports slack-bridge config once
+  slack set [--self-dm D..] [--user U..]                 sets hub Slack identity in ~/.claude/kickflip/slack.json
+            [--domain x] [--timezone Area/City]
+  review sent <wave>/<id> <reviewer> --ts <ts>           records the PR link's message in the item
+              --channel <dm>
+  review react <wave>/<id> <reviewer> <emoji>            records a reaction once on that reviewer's link
+  integrations                                          readiness rows as one JSON line
+  integrations report --slack yes|no                    with --site: reports whether this session has Claude's
+                                                         Slack connector, in ~/.claude/kickflip/integrations.json
+  review due                                            one JSON line of the Slack sends owed, from local state:
+                                                         {dms: [{key, reviewer, channel, text, record}], reactions:
+                                                         [{key, reviewer, channel, ts, emoji, record}], digest:
+                                                         review digest's answer while due (with record), else null}.
+                                                         dms: a PR link to each reviewer of an open, non-draft PR with
+                                                         no link recorded; reactions: git_merged on each recorded link
+                                                         of a merged card. record is the command to run once sent.
+                                                         While Slack isn't ready: {waiting} and nothing owed
+  review digest                                         pending reviews as JSON; due weekday mornings from 09:00
+  review digest sent <reviewer> --ts <ts>               records a digest in data/review-digests.json;
+              --channel <dm> --items <key,key>           marks today sent in the Slack identity timezone
   rules list                                             the hub rules, then with --site the board's, one
                                                          "<hub|board> <id> <owner|claude> <text>" line each
   rules add --text <t> [--hub] [--by claude]             a rule in board.json, or with --hub in the hub's
@@ -144,37 +227,110 @@ creating the issue and running item set <wave>/<id> --ticket <id> (followup set
                                                          --by claude when you codify one on the owner's word
   rules edit <id> --text <t> [--hub]                     rewords a rule, keeping who added it
   rules remove <id> [--hub]                              refuses an id the list doesn't have
-  settings                                               the board's settings as JSON, each false when board.json
-                                                         leaves it out: {"auto_merge": false, "auto_build": false}
-  settings set auto-merge on|off                         on: monitor merges an approved PR once CI is green and
+  settings                                               the board's settings as JSON; flags default off, optional
+                                                         settings appear when set: {"auto_merge": false,
+                                                         "auto_build": false, "auto_pull": false,
+                                                         "auto_triage": false, "github_login": "owner"}
+  settings set auto-merge on|off                         on: the session merges an approved PR once CI is green and
                                                          the merge state is CLEAN. off (the default): the card
-                                                         shows the owner a Merge button, and monitor merges on its
+                                                         shows the owner a Merge button, and the session merges on its
                                                          card-merge event. Board Settings' toggle writes it too
   build <wave>/<id> --site <route>                       asks the hub to run this card's .kickflip/build; prints
-                                                         started and exits. install is an alias. The hub records
-                                                         data/try/<id>.log and writes failures to the thread
+         --asked "<owner's words>"                       started and exits. install is an alias. Only the owner's
+                                                         Serve / Build and Auto-build start a card run, so --asked
+                                                         must quote the owner's ask, card message or answer note on
+                                                         this board that asked for it; the words go in a thread
+                                                         line on the card. The hub records data/try/<id>.log and
+                                                         writes failures to the thread. Web Visit opens
+                                                         https://<host>:<try port>/ at its root
   main set --install <url> [--install-sha <sha>]          publishes main's app install to data/main.json
+  settings set github-login <login>                      the GitHub account Claude posts as on this board. Its
+                                                         comments carrying <!-- claude-bridge --> are Claude\u2019s own
+                                                         and dropped; its other comments are the owner\u2019s. Unset,
+                                                         the hub asks gh api user. Pass "" to clear it
   settings set auto-build on|off                         on: each push builds its card. Off by default.
                                                          Main builds after every merge either way
-  builder start <wave>/<id> [--agent <name>] [--kind <opus|codex|sonnet|install|\u2026>] [--label <who>]
-         [--progress <text>] [--eta <ISO time>]          one record per agent on the item; --agent defaults to main.
+  settings set auto-pull on|off                          on: while no builder runs and nothing waits in Orchestrator
+                                                         review, the board server sends card-pull {key} for the top
+                                                         Todo card nothing blocks, holds or asks about, ready cards
+                                                         first; with none, card-plan {key} for the top unready
+                                                         card to grill or prototype. Off by default.
+                                                         Only on the owner's word
+  settings set auto-triage on|off                        on: while the board is idle and Todo changed since the last
+                                                         triage, at most once a day and before any pull, the board
+                                                         server declares topic todo-triage-<date> ("Todo triage
+                                                         <date>") and sends todo-triage {date, topic}; the pull
+                                                         waits until you reply to it. Off by default. Only on the
+                                                         owner's word
+  settings set tickets <json>                            the board's ticket source, as Board Settings' Tickets row
+                                                         saves it: {"source":"internal","prefix":"OPS"},
+                                                         {"source":"github","account":"<gh login>"} or
+                                                         {"source":"linear","workspace","team","project"}. A
+                                                         GitHub account runs the board's issue calls as that gh
+                                                         login; without one they run as gh's active account
+  builder start <wave>/<id> [--agent <name>] [--kind <claude|codex|prototype|grill|install|\u2026>] [--label <who>]
+         [--model <opus|sonnet>]                         the Claude model running the builder, recorded and printed as
+                                                         "model: Claude Sonnet" (kind claude takes builder pick's model;
+                                                         codex prints "model: Codex"). The thread's agent line reads it: "Claude
+                                                         Sonnet builder started"; the label carries no model word. A
+                                                         build refuses the model the hub's Claude model rules out.
+                                                         A prototype defaults to sonnet and a grill to opus:
+                                                         "Claude Sonnet prototype started"
+         [--phase <phase> --progress <detail>]           one record per agent on the item; --agent defaults to main.
+         [--eta <ISO time>]                              --phase and --progress take what builder progress takes.
                                                          --kind install: a build of the card's install, whose
-                                                         Install badge reads Building\u2026 meanwhile
+                                                         Install badge reads Building\u2026 meanwhile. --kind claude or
+                                                         codex refuses the one builder pick rules out; --kind build
+                                                         records the pick's kind and prints "kind: <kind>. <reason>";
+                                                         on the open record a Build tap started or --dispatch
+                                                         opened, it keeps that record's kind and worktree.
+         [--dispatch]                                    --dispatch: the session runs this right before it launches
+                                                         an agent of any kind (build, prototype, grill) so the record
+                                                         is open at launch and the card reads Starting; the agent's
+                                                         own builder start takes it up.
+                                                         A build (--kind build, claude or codex) on an open card sets
+                                                         --status building first, refusing what that refuses;
+                                                         Prints "ref: <ref>", the card's label, which commit subjects start with.
+                                                         Resolves the card's answered questions, noting "Acted on:
+                                                         builder started"
          [--worktree [--repo <dir>]]                     --worktree: a git worktree for the builder at
                                                          ~/.claude/kickflip/worktrees/<id> on a new branch <id> from
                                                          the board's branch of its clone (--repo overrides the clone), kept on
                                                          the record and printed as "worktree: <path>". Refuses when
                                                          that path or branch exists
-  builder progress <wave>/<id> (<text> | --text <t>)     one short present-tense line
-         [--agent <name>]
+  builder progress <wave>/<id> --phase <phase>           one status line: a phase, reading, building, testing,
+         (<detail> | --text <d>) [--agent <name>]        checking or landing, and a present-tense detail of at most
+                                                         80 characters in plain words, which the owner reads at a
+                                                         glance; a longer detail is refused with its length. Hashes,
+                                                         test counts and file names go in the hand-back. The thread
+                                                         line reads "Testing: <detail>", "Codex testing: <detail>"
+                                                         for another agent, and the card "Testing \xB7 <detail>"
          [--eta <ISO time> | --clear-eta]                an ETA shows as a line under the card's status
          A progress line, --progress included, needs --site: it is a status line in the item's thread, and
          the card's status shows the newest one from an agent still working
   builder done <wave>/<id> [--agent <name>]              marks that agent's record done; the item's thread
-                                                         shows when it started and finished; clears building/fixing
-                                                         when the card has no open builder records left
+         [--next <t>]                                    shows when it started and finished; clears building/fixing
+                                                         when the card has no open builder records left. Closing the
+                                                         last one of a card left In Progress with no Next is refused
+                                                         without --next, which sets it; item set --status checking
+                                                         and land close the records themselves
          builder takes --dir <dir> for a wave file in <dir>; its records go in <dir>/agents
-  land <wave>/<id> [--repo <dir>] [--dir <dir>]          brings the worktree its builder record keeps (else
+  builder pick <wave>/<id>                               who builds the card, from the hub's Codex share and the pause
+                                                         line, and for claude which model, from the hub's Claude model
+                                                         and the card's --size and --model: "codex: <reason>" or
+                                                         "claude sonnet: <reason>". Pass that kind to builder start
+                                                         --kind, and launch that model
+  builder call <wave>/<id> <judgment call>             appends one line to the agent's open builder record: a
+         [--agent <name>]                                judgment call as the builder makes it, or a "Question: \u2026"
+                                                         for the session; refused with no open record. A builder start
+                                                         on a record with unverified calls resumes that build, keeping
+                                                         its calls and worktree. The thread shows them, collapsed
+  builder calls <wave>/<id> [--agent <name>]             prints the record's calls, numbered, then "verified <time>"
+                                                         or "not verified yet"
+  builder verified <wave>/<id> [--agent <name>]          the session's mark that it checked the record's calls; land
+         [--note <t>]                                    refuses while any record on the card has a call after it
+  land <wave>/<id> --text <t> [--repo <dir>]             brings the worktree its builder record keeps (else
+         [--dir <dir>]
                                                          ~/.claude/kickflip/worktrees/<id> of --repo) into main, one line
                                                          per step: refuses while it has uncommitted changes or adds no
                                                          commit; rebases onto main when main moved, refusing on a
@@ -184,24 +340,40 @@ creating the issue and running item set <wave>/<id> --ticket <id> (followup set
                                                          fast-forwards main in the repo;
                                                          restarts the hub when its code changed, else each board
                                                          server when board/ changed; removes the worktree and its
-                                                         branch. Never pushes. KICKFLIP_RESTART_CMD='["<cmd>"]' replaces
+                                                         branch. Never pushes. One land runs at a time on the host: a
+                                                         second refuses, naming the card landing. With --site, --text <what was checked>
+                                                         is required, and once it lands the card closes as item set
+                                                         --status done --text does; it refuses first what that close
+                                                         would. KICKFLIP_RESTART_CMD='["<cmd>"]' replaces
                                                          the restarts, called with hub or board <route>
+  merge <wave>/<id> [--after-approval "<why trivial>"]   merges the card's PR (gh pr merge --squash) and records it merged,
+         [--confirmed "<owner's words>"]                 once GitHub reads it approved, its checks green with none
+                                                         pending and its merge state CLEAN, the test the Merge button
+                                                         uses. Refuses, naming each reason ("pending: 2 checks"),
+                                                         commits after the newest approval unless --after-approval
+                                                         says why they're trivial (its closing line says so), and a
+                                                         card with manual steps unless --confirmed quotes the owner.
+                                                         A refusal also goes in the thread while the owner's Merge waits
+  arch file <wave>/<id>                                  turns the architecture review audit card's answered findings
+                                                         into cards in the review's wave: titled with the picked
+                                                         option's label, its detail, practice and the owner's note as
+                                                         notes, each after the wave's last card, its question resolved
+                                                         "Filed as <ref>."; a Skip pick resolves its question alone.
+                                                         Prints "filed: <ref> from <id>", "skipped: <id>", and
+                                                         "waiting: <ids>" while any are unanswered; once none is, it
+                                                         closes the audit card as done
   push --kind action|prompt|fault --title <t>            runs kickflip push with these flags, adding
        [--body <b>] [--url </route/path>]                "\xB7 and N replies" to the body for the replies
        [--tag <tag>] [--now | --urgent]                  written since the site's last push through this
-                                                         command (none before its first). For an item, tag it
-                                                         ask-<eventId> or item-<wave>/<id>; a card whose action
-                                                         changes pushes again under its tag. It records the
-                                                         push in data/push-state.json only when kickflip push
-                                                         succeeds, and exits with kickflip push's code.
-                                                         --kind: action when a card's Action needed appears or
-                                                         changes, fault for what only the owner can fix. Refused
-                                                         without one: news stays on the board.
-                                                         Without --now it queues until the tick ends (checked) or
-                                                         the hub's next check: drafts on Ready, Merge. --now sends
-                                                         at once unless pushes are held (overnight, snoozed or the
-                                                         weekend): questions, steps only the owner can run,
-                                                         prototypes asked for. --urgent: a production fault only;
-                                                         it beats those holds. While notifications are off every
-                                                         push is dropped, urgent too
-         KICKFLIP_PUSH_CMD='["<cmd>","<arg>"]' replaces \`node ../../bin/kickflip.mjs push\`; the flags follow it`;class r extends Error{static{l(this,"UsageError")}}const W=new Set(["clear-status","clear-next","urgent","now","clear-eta","held","unheld","idle","hub","clear-install","force","worktree","dry-run"]),J=new Set(["take"]),G=f.join(f.dirname(C(import.meta.url)),"..","..","bin","kickflip.mjs");function z(){if(!process.env.KICKFLIP_PUSH_CMD)return[process.execPath,G,"push"];try{const e=JSON.parse(process.env.KICKFLIP_PUSH_CMD);if(Array.isArray(e)&&e.length&&e.every(s=>typeof s=="string"))return e}catch{}throw new n.BoardError("KICKFLIP_PUSH_CMD must be a JSON array of strings")}l(z,"pushCommand");async function Q(e,s){const t=B(s.kind);if(t)throw new r(t);if(s.title===void 0)throw new r("push needs --title");const a=new Date,i=await n.repliesSincePush(e,a),o=n.withReplies(s.body,i),d={kind:s.kind,title:s.title,body:o||void 0,url:n.pushUrl(s.url),tag:s.tag},[c,...p]=z(),u=[...p,...Object.entries(d).flatMap(([v,m])=>m===void 0?[]:[`--${v}`,m]),...s.urgent?["--urgent"]:[],...s.now?["--now"]:[]],h=O(c,u,{stdio:"inherit"});if(h.status!==0)throw Object.assign(new n.BoardError(`kickflip push failed (${h.error?.message||`exit ${h.status??h.signal}`}); the push was not recorded`),{exitCode:h.status||1});return n.recordPush(e,a)}l(Q,"push");function X(e){const s=Object.create(null),t=[];for(let a=0;a<e.length;a++){const i=e[a];if(!i.startsWith("--")){t.push(i);continue}const o=i.slice(2);if(J.has(o)){if(a+1>=e.length)throw new r(`--${o} needs a value`);(s[o]||=[]).push(e[++a]);continue}if(Object.hasOwn(s,o))throw new r(`--${o} is given twice`);if(W.has(o))s[o]=!0;else if(a+1<e.length)s[o]=e[++a];else throw new r(`--${o} needs a value`)}return{flags:s,rest:t}}l(X,"parse");const V=["html","text","note","notes","summary","title","body","next","progress","install-label","confirmed"],Y=/^(?:\/|~\/|\.{1,2}\/)\S*\.(?:html?|md|json|txt)$/;function Z(e){const s=e.trim();if(!s||/\s/.test(s))return!1;if(Y.test(s))return!0;try{return g.statSync(s).isFile()}catch{return!1}}l(Z,"looksLikePath");function ee(e,s){for(const t of V){if(typeof s[t]!="string"||!Z(s[t]))continue;const a=e.includes("file")?`; for a file use --file ${s[t].trim()}`:"";throw new r(`--${t} takes text, not a file path (${s[t].trim()})${a}`)}if(typeof s.file=="string"&&s.file!=="-"&&!g.existsSync(s.file))throw new r(`--file ${s.file}: no such file`)}l(ee,"checkInputs");const A=l(e=>g.readFileSync(e==="-"?0:e,"utf8"),"readInput");function x(e){if(!e)throw new r("--file <path> is required");try{return JSON.parse(A(e))}catch(s){throw new n.BoardError(`${e}: ${s.message}`)}}l(x,"readJSONInput");function P(e){if(e.plan!==void 0&&e["notes-file"]!==void 0)throw new r("pass --notes-file or --plan, not both");return e["notes-file"]??e.plan}l(P,"notesFileOf");const b={reply:[["eventId"],["html","file"],(e,[s],t)=>{if(t.html===void 0==(t.file===void 0))throw new r("reply takes --html or --file");return n.writeReply(e,s,t.html??A(t.file))}],thread:[["wave/id"],["text","link","who","via"],(e,[s],t)=>n.appendThread(e,s,t)],"topic add":[["id"],["title","summary"],(e,[s],t)=>n.addTopic(e,{id:s,...t})],"question add":[[],["file"],(e,s,t)=>n.addQuestions(e,x(t.file))],"question resolve":[["id"],["note"],(e,[s],t)=>n.resolveQuestion(e,s,t.note)],"prototype add":[["topic"],["title","take","card"],(e,[s],t)=>n.addPrototype(e,{topic:s,title:t.title,card:t.card,takes:t.take})],"prototype list":[[],[],e=>n.listPrototypes(e)],"prototype rm":[["topic"],[],(e,[s])=>n.removePrototype(e,s)],"item set":[["wave/id"],["status","clear-status","next","clear-next","pr","from-ask","held","unheld","notes-file","plan","deps","install","install-sha","install-label","clear-install","title","force","ticket","confirmed"],(e,[s],t,a)=>n.setItem(e,s,{status:t.status,clearStatus:t["clear-status"],next:t.next,clearNext:t["clear-next"],pr:t.pr,fromAsk:t["from-ask"],held:t.held,unheld:t.unheld,notesFile:P(t),deps:t.deps,install:t.install,installSha:t["install-sha"],installLabel:t["install-label"],clearInstall:t["clear-install"],title:t.title,force:t.force,ticket:t.ticket,confirmed:t.confirmed},a)],"item add":[["wave/id"],["title","notes","deps","notes-file","plan","ticket"],(e,[s],t,a)=>n.addItem(e,s,{title:t.title,notes:t.notes,deps:t.deps,notesFile:P(t),ticket:t.ticket},a)],"item relate-ask":[["eventId","wave/id"],["summary"],(e,[s,t],a)=>n.relateAsk(e,s,t,a.summary)],"ask progress":[["eventId"],["next"],(e,[s],t)=>n.markAsk(e,s,"progress",t.next)],"ask done":[["eventId"],[],(e,[s])=>n.markAsk(e,s,"done")],"ask unfold":[["eventId"],[],(e,[s])=>n.unfoldAsk(e,s)],"ask move":[["eventId"],["to"],(e,[s],t)=>n.moveAsk(e,s,t.to)],"followup add":[["wave"],["id","title","from","ticket"],(e,[s],t,a)=>n.addFollowup(e,s,t,a)],"tickets backfill":[[],["dry-run"],(e,s,t,a)=>n.backfillTickets(e,{dryRun:t["dry-run"]},a)],"followup done":[["wave","id"],["force"],(e,[s,t],a)=>n.finishFollowup(e,s,t,{force:a.force})],"followup set":[["wave","id"],["ticket"],(e,[s,t],a)=>n.setFollowupTicket(e,s,t,a.ticket)],"reviewers set":[[],["file"],(e,s,t)=>n.setReviewers(e,x(t.file))],"reviewers add":[[],["file"],(e,s,t)=>n.addReviewers(e,x(t.file))],"reviewers remove":[["...name"],[],(e,s)=>n.removeReviewers(e,s)],"rules list":[[],[],e=>n.listRules(e)],"rules add":[[],["text","hub","by"],(e,s,t)=>n.addRuleTo(e,t)],"rules edit":[["id"],["text","hub"],(e,[s],t)=>n.editRuleIn(e,s,t)],"rules remove":[["id"],["hub"],(e,[s],t)=>n.removeRuleFrom(e,s,t)],settings:[[],[],async e=>({lines:[JSON.stringify(await n.readBoardSettings(e))]})],build:[["wave/id"],[],async(e,[s])=>{if(!e)throw new n.BoardError("build needs --site <route>");n.parseKey(s);try{const t=await fetch(`http://127.0.0.1:${process.env.KICKFLIP_HUB_PORT||4500}/_hub/build`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({route:f.basename(e),key:s}),signal:AbortSignal.timeout(1e4)}),a=await t.json();if(!t.ok)throw new n.BoardError(a.error||"The hub refused the build.");return{lines:["started"]}}catch(t){throw t instanceof n.BoardError?t:new n.BoardError(`Could not start the build: ${t.message}`)}}],"main set":[[],["install","install-sha"],(e,s,t)=>n.setMainInstall(e,{install:t.install,installSha:t["install-sha"]})],"settings set":[["name","on|off"],[],(e,[s,t])=>n.setBoardSetting(e,s,t)],"builder start":[["wave/id"],["label","progress","dir","agent","kind","eta","worktree","repo"],(e,[s],{worktree:t,repo:a,...i})=>{if(a!==void 0&&!t)throw new r("--repo goes with --worktree");const o=M(),d=e?K(e,o):null,c=d?D(d.route,o):{},p=!!c.github,u=a??(p&&c.repo||void 0),h=p&&c.branch||"main";return n.startBuilder(e,s,{...i,worktree:t&&(()=>q(s.split("/")[1],{repo:u,base:h,remote:p}))})}],"builder progress":[["wave/id","...text?"],["text","dir","agent","eta","clear-eta"],(e,[s,...t],a)=>{if(t.length&&a.text!==void 0)throw new r("builder progress takes its text once: as words or as --text");if(!t.length&&a.text===void 0)throw new r("builder progress needs its text, as words or as --text");return n.builderProgress(e,s,a.text??t.join(" "),{...a,clearEta:a["clear-eta"]})}],"builder done":[["wave/id"],["dir","agent"],(e,[s],t)=>n.stopBuilder(e,s,t)],land:[["wave/id"],["repo","dir"],async(e,[s],t)=>{const a=s.split("/")[1],i=await n.recordedWorktree(e,s,{dir:t.dir}),o=f.resolve(t.repo??i?.repo??L());return T({path:i?.path??f.join(N(),a),branch:i?.branch??a,repo:o}),{lines:[]}}],working:[["eventId"],[],(e,[s])=>n.setWorking(e,s)],"hello-ack":[["eventId"],[],(e,[s])=>n.ackHello(e,s)],checked:[[],["every","idle"],(e,s,t)=>n.writeChecked(e,t.every,{idle:t.idle})],push:[[],["kind","title","body","url","tag","urgent","now"],(e,s,t)=>Q(e,t)]};b.install=b.build;async function te(e,s={}){try{const{flags:t,rest:a}=X(e),i=S(b,`${a[0]} ${a[1]}`)?`${a[0]} ${a[1]}`:a[0],o=S(b,i);if(!o)throw new r(a.length?`unknown command "${a.slice(0,2).join(" ")}"`:"no command given");const[d,c,p]=o,u=a.slice(i.split(" ").length),h=d.at(-1)?.startsWith("..."),v=d.at(-1)?.endsWith("?")?d.length-1:d.length;if(h?u.length<v:u.length!==d.length)throw new r(`${i} takes ${d.map(w=>`<${w.replace(/^\.\.\.|\?$/g,"")}>`).join(" ")||"no arguments"}`);const{site:m,...y}=t,I=Object.keys(y).filter(w=>!c.includes(w));if(I.length)throw new r(`${i} does not take ${I.map(w=>"--"+w).join(", ")}`);ee(c,y);const $=m===void 0?null:await n.siteDir(m),k=await p($,u,y,s),{file:j,lines:R=[]}=typeof k=="object"&&k?k:{file:k};i.startsWith("builder ")?console.log(`${i.slice(8)} ${u[0]}`):j!==void 0&&console.log(`${i} \u2192 ${j}`);for(const w of R)console.log(w);return 0}catch(t){if(t instanceof r)return console.error(`${t.message} (node board.mjs --help lists the commands)`),2;if(t instanceof n.BoardError)return console.error(t.message),t.exitCode??1;throw t}}if(l(te,"main"),process.argv[1]&&import.meta.url===E(g.realpathSync(process.argv[1])).href){H();const e=process.argv.slice(2);!e.length||e.includes("--help")||e[0]==="help"?console.log(U):process.exitCode=await te(e)}export{U as USAGE,te as main};
+                                                         command (none before its first). The board server pushes
+                                                         each card's Action needed itself, so this is for a fault,
+                                                         what only the owner can fix. It records the push in
+                                                         data/push-state.json only when kickflip push succeeds,
+                                                         and exits with kickflip push's code. Refused without an
+                                                         allowed --kind: news stays on the board. Without --now
+                                                         it queues until the tick ends (checked) or the hub's
+                                                         next check; --now sends at once unless pushes are held
+                                                         (overnight, snoozed or the weekend). --urgent: a
+                                                         production fault only; it beats those holds. While
+                                                         notifications are off every push is dropped, urgent too
+         KICKFLIP_PUSH_CMD='["<cmd>","<arg>"]' replaces \`node ../../bin/kickflip.mjs push\`; the flags follow it`;class o extends Error{static{n(this,"UsageError")}}const V=new Set(["clear-status","clear-next","urgent","now","clear-eta","held","unheld","idle","hub","clear-install","force","worktree","dry-run","dispatch"]),X=new Set(["take"]);function Z(e){const t=Object.create(null),s=[];for(let a=0;a<e.length;a++){const r=e[a];if(!r.startsWith("--")){s.push(r);continue}const d=r.slice(2);if(X.has(d)){if(a+1>=e.length)throw new o(`--${d} needs a value`);(t[d]||=[]).push(e[++a]);continue}if(Object.hasOwn(t,d))throw new o(`--${d} is given twice`);if(V.has(d))t[d]=!0;else if(a+1<e.length)t[d]=e[++a];else throw new o(`--${d} needs a value`)}return{flags:t,rest:s}}n(Z,"parse");const Y=["html","text","note","notes","summary","title","body","next","progress","install-label","confirmed","asked"],ee=/^(?:\/|~\/|\.{1,2}\/)\S*\.(?:html?|md|json|txt)$/;function te(e){const t=e.trim();if(!t||/\s/.test(t))return!1;if(ee.test(t))return!0;try{return w.statSync(t).isFile()}catch{return!1}}n(te,"looksLikePath");function se(e,t){for(const s of Y){if(typeof t[s]!="string"||!te(t[s]))continue;const a=e.includes("file")?`; for a file use --file ${t[s].trim()}`:"";throw new o(`--${s} takes text, not a file path (${t[s].trim()})${a}`)}if(typeof t.file=="string"&&t.file!=="-"&&!w.existsSync(t.file))throw new o(`--file ${t.file}: no such file`)}n(se,"checkInputs");const b=n(e=>w.readFileSync(e==="-"?0:e,"utf8"),"readInput");function v(e){if(!e)throw new o("--file <path> is required");try{return JSON.parse(b(e))}catch(t){throw new i.BoardError(`${e}: ${t.message}`)}}n(v,"readJSONInput");function y(e){if(e.plan!==void 0&&e["notes-file"]!==void 0)throw new o("pass --notes-file or --plan, not both");return e["notes-file"]??e.plan}n(y,"notesFileOf");function O(e){if(e.note!==void 0&&e.file!==void 0)throw new o("pass --note or --file, not both");return e.file===void 0?e.note:b(e.file)}n(O,"noteOf");const g={pr:[["wave/id"],[],async(e,[t])=>({lines:[JSON.stringify(await i.prReport(e,t))]})],reply:[["eventId"],["html","file"],(e,[t],s)=>{if(s.html===void 0==(s.file===void 0))throw new o("reply takes --html or --file");return i.writeReply(e,t,s.html??b(s.file))}],thread:[["wave/id"],["text","link","who","via"],(e,[t],s)=>i.appendThread(e,t,s)],"topic add":[["id"],["title","summary"],(e,[t],s)=>i.addTopic(e,{id:t,...s})],"question add":[[],["file"],async(e,t,s)=>{const a=v(s.file);return{...await i.addQuestions(e,a),asked:[a].flat()}}],"question resolve":[["id"],["note"],(e,[t],s)=>i.resolveQuestion(e,t,s.note)],"prototype add":[["topic"],["title","take","card"],(e,[t],s)=>i.addPrototype(e,{topic:t,title:s.title,card:s.card,takes:s.take})],"prototype list":[[],[],e=>i.listPrototypes(e)],"prototype rm":[["topic"],[],(e,[t])=>i.removePrototype(e,t)],"item set":[["wave/id"],["status","clear-status","next","clear-next","pr","pushed","gh-since","from-ask","state","held","unheld","pick-up-at","notes-file","plan","deps","parent","related","install","install-sha","install-label","clear-install","title","size","model","force","ticket","text"],(e,[t],s,a)=>i.setItem(e,t,{status:s.status,clearStatus:s["clear-status"],next:s.next,clearNext:s["clear-next"],pr:s.pr,pushed:s.pushed,ghSince:s["gh-since"],fromAsk:s["from-ask"],state:s.state,held:s.held,unheld:s.unheld,pickUpAt:s["pick-up-at"],notesFile:y(s),deps:s.deps,parent:s.parent,related:s.related,install:s.install,installSha:s["install-sha"],installLabel:s["install-label"],clearInstall:s["clear-install"],title:s.title,size:s.size,model:s.model,force:s.force,ticket:s.ticket,text:s.text},a)],"item add":[["wave[/id]"],["title","notes","deps","notes-file","plan","ticket","pick-up-at","parent","size","model"],(e,[t],s,a)=>i.addItem(e,t,{title:s.title,notes:s.notes,deps:s.deps,notesFile:y(s),ticket:s.ticket,pickUpAt:s["pick-up-at"],parent:s.parent,size:s.size,model:s.model},a)],"item relate-ask":[["eventId","wave/id"],["summary"],(e,[t,s],a)=>i.relateAsk(e,t,s,a.summary)],"ask progress":[["eventId"],["next"],(e,[t],s)=>i.markAsk(e,t,"progress",s.next)],"ask done":[["eventId"],[],(e,[t])=>i.markAsk(e,t,"done")],"ask unfold":[["eventId"],[],(e,[t])=>i.unfoldAsk(e,t)],"ask move":[["eventId"],["to"],(e,[t],s)=>i.moveAsk(e,t,s.to)],"tickets backfill":[[],["dry-run"],(e,t,s,a)=>i.backfillTickets(e,{dryRun:s["dry-run"]},a)],"lineup create":[["slug"],["title","goal","cards","note","file"],(e,[t],s)=>i.createLineup(e,t,{title:s.title,goal:s.goal,cards:s.cards,note:O(s)})],"lineup add":[["slug","wave/id"],["after"],(e,[t,s],a)=>i.changeLineup(e,t,{add:s,after:a.after})],"lineup remove":[["slug","wave/id"],[],(e,[t,s])=>i.changeLineup(e,t,{remove:s})],"lineup set":[["slug"],["title","goal","note","file"],(e,[t],s)=>i.changeLineup(e,t,{title:s.title,goal:s.goal,note:O(s)})],"lineup finish":[["slug"],[],(e,[t])=>i.finishLineup(e,t)],slack:[[],[],()=>({lines:[JSON.stringify(L())]})],"slack set":[[],["self-dm","user","domain","timezone"],async(e,t,s)=>{const a={"self-dm":"self_dm",user:"owner_slack_user",domain:"slack_domain",timezone:"timezone"};try{return{lines:[JSON.stringify(await H(Object.fromEntries(Object.entries(s).map(([r,d])=>[a[r],d]))))]}}catch(r){throw new i.BoardError(r.message)}}],integrations:[[],[],async()=>({lines:[JSON.stringify(await N.rows())]})],"integrations report":[[],["slack"],async(e,t,s)=>{if(!["yes","no"].includes(s.slack))throw new o("integrations report takes --slack yes|no");if(!e)throw new i.BoardError("integrations report needs --site <route>");const a=m.basename(e);return E(s.slack==="yes",{route:a,title:U().sites?.[a]?.title||(await i.boardConfig(e)).title}),{lines:[`Slack connector reported: ${s.slack}.`]}}],"review sent":[["wave/id","reviewer"],["ts","channel"],(e,[t,s],a)=>i.reviewSent(e,t,s,a)],"review react":[["wave/id","reviewer","emoji"],[],(e,[t,s,a])=>i.reviewReact(e,t,s,a)],"review digest":[[],[],async(e,t,s,a)=>({lines:[JSON.stringify(await i.reviewDigest(e,a))]})],"review due":[[],[],async(e,t,s,a)=>({lines:[JSON.stringify(await i.reviewDue(e,a))]})],"review digest sent":[["reviewer"],["ts","channel","items"],(e,[t],s,a)=>i.reviewDigestSent(e,t,s,a)],"reviewers set":[[],["file"],(e,t,s)=>i.setReviewers(e,v(s.file))],"reviewers add":[[],["file"],(e,t,s)=>i.addReviewers(e,v(s.file))],"reviewers remove":[["...name"],[],(e,t)=>i.removeReviewers(e,t)],"rules list":[[],[],e=>i.listRules(e)],"rules add":[[],["text","hub","by"],(e,t,s)=>i.addRuleTo(e,s)],"rules edit":[["id"],["text","hub"],(e,[t],s)=>i.editRuleIn(e,t,s)],"rules remove":[["id"],["hub"],(e,[t],s)=>i.removeRuleFrom(e,t,s)],settings:[[],[],async e=>({lines:[JSON.stringify(await i.readBoardSettings(e))]})],build:[["wave/id"],["asked"],async(e,[t],s)=>{if(!e)throw new i.BoardError("build needs --site <route>");i.parseKey(t);const a=await i.askedGate(e,t,s.asked);try{const r=await fetch(`http://127.0.0.1:${process.env.KICKFLIP_HUB_PORT||4500}/_hub/build`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({route:m.basename(e),key:t}),signal:AbortSignal.timeout(1e4)}),d=await r.json();if(!r.ok)throw new i.BoardError(d.error||"The hub refused the build.");return{lines:["started",...(await i.appendThread(e,t,{text:a})).lines]}}catch(r){throw r instanceof i.BoardError?r:new i.BoardError(`Could not start the build: ${r.message}`)}}],"main set":[[],["install","install-sha"],(e,t,s)=>i.setMainInstall(e,{install:s.install,installSha:s["install-sha"]})],"settings set":[["name","value"],[],(e,[t,s])=>i.setBoardSetting(e,t,s)],"builder start":[["wave/id"],["label","phase","progress","dir","agent","kind","model","eta","worktree","repo","dispatch"],(e,[t],{worktree:s,repo:a,...r})=>{if(a!==void 0&&!s)throw new o("--repo goes with --worktree");return i.startBuilder(e,t,{...r,worktree:s&&(()=>D(e,t.split("/")[1],{repo:a}))})}],"builder progress":[["wave/id","...text?"],["phase","text","dir","agent","eta","clear-eta"],(e,[t,...s],a)=>{if(s.length&&a.text!==void 0)throw new o("builder progress takes its text once: as words or as --text");if(!s.length&&a.text===void 0)throw new o("builder progress needs its text, as words or as --text");return i.builderProgress(e,t,a.text??s.join(" "),{...a,clearEta:a["clear-eta"]})}],"builder done":[["wave/id"],["dir","agent","next"],(e,[t],s)=>i.stopBuilder(e,t,{...s,requireNext:!0})],"builder pick":[["wave/id"],[],(e,[t])=>i.pickBuilder(e,t)],"builder call":[["wave/id","...text"],["dir","agent"],(e,[t,...s],a)=>i.recordCall(e,t,s.join(" "),a)],"builder calls":[["wave/id"],["dir","agent"],(e,[t],s)=>i.listCalls(e,t,s)],"builder verified":[["wave/id"],["dir","agent","note"],(e,[t],s)=>i.verifyCalls(e,t,s)],land:[["wave/id"],["repo","dir","text"],async(e,[t],s)=>{const a=t.split("/")[1];if(e&&s.text===void 0)throw new o(`land needs --text "<what was checked>", which closes ${t} as done once it lands`);if(!e&&s.text!==void 0)throw new o("--text closes the card, which needs --site");return W(e?await i.cardName(e,t):t,async()=>{e&&await i.checkClose(e,t,s.text),await i.checkCallsVerified(e,t,{dir:s.dir});const r=await i.recordedWorktree(e,t,{dir:s.dir}),d=m.resolve(s.repo??r?.repo??M(e).repo);return z({path:r?.path??m.join(G(),a),branch:r?.branch??a,repo:d}),e?i.setItem(e,t,{status:"done",text:s.text}):{lines:[]}})}],merge:[["wave/id"],["after-approval","confirmed"],(e,[t],s)=>i.mergeCard(e,t,{afterApproval:s["after-approval"],confirmed:s.confirmed})],"arch file":[["wave/id"],[],(e,[t])=>e?J(e,t):Promise.reject(new i.BoardError("arch file needs --site <route>"))],checked:[[],["every","idle"],(e,t,s)=>i.writeChecked(e,s.every,{idle:s.idle})],push:[[],["kind","title","body","url","tag","urgent","now"],(e,t,s)=>{const a=K(s.kind);if(a)throw new o(a);if(s.title===void 0)throw new o("push needs --title");return i.sendPush(e,s)}]};g.install=g.build;const l=n((e,t)=>i.cardName(e,t),"card"),C=n((e,t)=>`${t}${e.length===1?"":"s"} ${e.join(", ")}`,"plural"),T=n(e=>e.agent===void 0||e.agent==="main"?"builder":`builder ${e.agent}`,"builderOf");function ae(e){const t=e["pick-up-at"];return[e.status,e["clear-status"]&&"status cleared",e.next!==void 0&&(e.next.trim()?"next line set":"next line cleared"),e["clear-next"]&&"next line cleared",e.pr!==void 0&&`PR #${e.pr}`,e.pushed!==void 0&&`pushed ${e.pushed}`,e["gh-since"]&&`GitHub read to ${e["gh-since"]}`,e["from-ask"]&&`from task ${e["from-ask"]}`,e.state,e.held&&"held",e.unheld&&"resumed",t!==void 0&&(t?`held until ${t}`:"resumed"),y(e)!==void 0&&"notes recorded",e.deps!==void 0&&(e.deps?`blocked by ${e.deps}`:"deps cleared"),e.parent!==void 0&&(e.parent?`parent ${e.parent}`:"parent cleared"),e.related!==void 0&&(e.related?`related to ${e.related.split(",").join(", ")}`:"related cleared"),e.install!==void 0&&"install published",e["clear-install"]&&"install cleared",e.title!==void 0&&"renamed",e.ticket!==void 0&&`ticket ${e.ticket}`].filter(Boolean).join(", ")}n(ae,"itemChanges");const ie={reply:n(async(e,[t])=>`reply written to ${await i.eventCard(e,t)}`,"reply"),thread:n(async(e,[t])=>`thread line on ${await l(e,t)}`,"thread"),"topic add":n((e,[t])=>`topic ${t} added`,"topic add"),"question add":n(async(e,t,s,{asked:a})=>{const r=[...new Set(a.map(c=>c.topic))],d=r.length!==1?"":r[0].startsWith("item:")?` on ${await l(e,r[0].slice(5))}`:` on topic ${r[0]}`;return`${C(a.map(c=>c.id),"question")} added${d}`},"question add"),"question resolve":n((e,[t])=>`question ${t} resolved`,"question resolve"),"prototype add":n(async(e,[t],s)=>`prototype ${t} recorded${s.card?` for ${await l(e,s.card)}`:""}`,"prototype add"),"prototype rm":n((e,[t])=>`prototype ${t} removed`,"prototype rm"),"item set":n(async(e,[t],s)=>`${await l(e,t)}: ${ae(s)}`,"item set"),"item add":n(async(e,t,s,{key:a})=>`${await l(e,a)} added as ${a}`,"item add"),"item relate-ask":n(async(e,[t,s])=>`task ${t} folded into ${await l(e,s)}`,"item relate-ask"),"ask progress":n(async(e,[t])=>`${await l(e,`ask:${t}`)}: in progress`,"ask progress"),"ask done":n(async(e,[t])=>`${await l(e,`ask:${t}`)}: done`,"ask done"),"ask unfold":n((e,[t])=>`task ${t} back on a card of its own`,"ask unfold"),"ask move":n((e,[t],s)=>`task ${t} moved to /${s.to}`,"ask move"),checked:n((e,t,s,{every:a})=>a===null?"GitHub checked; no open PR":`GitHub checked; next in ${a} min`,"checked"),"lineup create":n((e,[t])=>`lineup ${t} created`,"lineup create"),"lineup add":n(async(e,[t,s])=>`${await l(e,s)} added to lineup ${t}`,"lineup add"),"lineup remove":n(async(e,[t,s])=>`${await l(e,s)} taken out of lineup ${t}`,"lineup remove"),"lineup set":n((e,[t])=>`lineup ${t} updated`,"lineup set"),"lineup finish":n((e,[t])=>`lineup ${t} finished`,"lineup finish"),"review sent":n(async(e,[t,s])=>`review link to ${s} recorded on ${await l(e,t)}`,"review sent"),"review react":n(async(e,[t,s,a])=>`${a} on ${s}'s review link recorded on ${await l(e,t)}`,"review react"),"review digest sent":n((e,[t])=>`digest to ${t} recorded`,"review digest sent"),"reviewers set":n(()=>"reviewers replaced","reviewers set"),"reviewers add":n(()=>"reviewers added","reviewers add"),"reviewers remove":n((e,t)=>`${C(t,"reviewer")} removed`,"reviewers remove"),"rules add":n((e,t,s)=>`${s.hub?"hub":"board"} rule added`,"rules add"),"rules edit":n((e,[t],s)=>`${s.hub?"hub":"board"} rule ${t} reworded`,"rules edit"),"rules remove":n((e,[t],s)=>`${s.hub?"hub":"board"} rule ${t} removed`,"rules remove"),"builder start":n(async(e,[t],s)=>`${await l(e,t)}: ${T(s)} started`,"builder start"),"builder progress":n(async(e,[t])=>`progress line on ${await l(e,t)}`,"builder progress"),"builder done":n(async(e,[t],s)=>`${await l(e,t)}: ${T(s)} done`,"builder done"),"builder call":n(async(e,[t])=>`judgment call recorded on ${await l(e,t)}`,"builder call"),"builder verified":n(async(e,[t])=>`${await l(e,t)}: judgment calls verified`,"builder verified"),land:n(async(e,[t])=>e?`${await l(e,t)}: landed and done`:null,"land"),merge:n(async(e,[t])=>`${await l(e,t)}: merged`,"merge"),"arch file":n(async(e,[t])=>`findings of ${await l(e,t)} filed`,"arch file")};async function ne(e,t={}){try{const{flags:s,rest:a}=Z(e),r=[3,2,1].map(h=>a.slice(0,h).join(" ")).find(h=>k(g,h)),d=k(g,r);if(!d)throw new o(a.length?`unknown command "${a.slice(0,2).join(" ")}"`:"no command given");const[c,x,R]=d,u=a.slice(r.split(" ").length),_=c.at(-1)?.startsWith("..."),q=c.at(-1)?.endsWith("?")?c.length-1:c.length;if(_?u.length<q:u.length!==c.length)throw new o(`${r} takes ${c.map(h=>`<${h.replace(/^\.\.\.|\?$/g,"")}>`).join(" ")||"no arguments"}`);const{site:$,...p}=s,S=Object.keys(p).filter(h=>!x.includes(h));if(S.length)throw new o(`${r} does not take ${S.map(h=>"--"+h).join(", ")}`);se(x,p);const I=$===void 0?null:await i.siteDir($),f=await R(I,u,p,t),A=k(ie,r),j=A&&await A(I,u,p,f);j&&console.log(j);for(const h of typeof f=="object"&&f?.lines||[])console.log(h);return 0}catch(s){if(s instanceof o)return console.error(`${s.message} (node board.mjs --help lists the commands)`),2;if(s instanceof i.BoardError)return console.error(s.message),s.exitCode??1;throw s}}if(n(ne,"main"),process.argv[1]&&import.meta.url===B(w.realpathSync(process.argv[1])).href){const e=process.argv.slice(2);!e.length||e.includes("--help")||e[0]==="help"?console.log(Q):process.exitCode=await ne(e)}export{Q as USAGE,ne as main};

package/board/bin/builder-stop-hook.mjs

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
-var y=Object.defineProperty;var c=(s,r)=>y(s,"name",{value:r,configurable:!0});import m from"node:fs";import g from"node:os";const h=120*1e3,w=5*1e3,$=/(?:\bbuilder|\bagent\.mjs)\s+start\s+["']?([^\s"';|&]+)/g,f=c((s,r)=>{const n=new RegExp(`--${r}(?:=|\\s+)(?:"([^"]*)"|'([^']*)'|([^\\s"';|&)]+))`,"g");let e;for(const t of s.matchAll(n))e=t[1]??t[2]??t[3];return e},"flagIn");function _(s){const r=[];for(const n of s.matchAll($)){const e=s.slice(n.index),t=e.slice(0,e.search(/\n|;|&&|\|\||\|(?!\|)|$/));r.push({key:n[1],site:f(t,"site")??f(s.slice(0,n.index),"site")??null,agent:f(t,"agent")??"main",dir:f(t,"dir")})}return r}c(_,"startsIn");const S=c(s=>s.replace(/^~(?=\/|$)/,g.homedir()).replace(/^\$(?:HOME|\{HOME\})(?=\/|$)/,g.homedir()),"expandHome");function b(s){const r=[],n=new Map;for(const e of s.split(`
-`)){const t=e.includes('"assistant"')&&/ start/.test(e)&&/builder|agent\.mjs/.test(e),l=n.size&&e.includes("tool_result")&&[...n.keys()].some(o=>e.includes(o));if(!t&&!l)continue;let i;try{i=JSON.parse(e)}catch{continue}const u=Date.parse(i.timestamp),p=Array.isArray(i.message?.content)?i.message.content:[];if(i.type==="assistant"&&!Number.isNaN(u))for(const o of p){if(o?.type!=="tool_use"||typeof o.input?.command!="string")continue;const a=_(o.input.command).map(d=>({...d,from:u-w,to:u+h}));r.push(...a),o.id&&a.length&&n.set(o.id,a)}else if(i.type==="user"&&!Number.isNaN(u))for(const o of p){const a=o?.type==="tool_result"&&n.get(o.tool_use_id);if(a){for(const d of a)d.to=Math.max(d.to,u+h);n.delete(o.tool_use_id)}}}return r}c(b,"startsInTranscript");async function N(){const r=JSON.parse(m.readFileSync(0,"utf8"))?.agent_transcript_path;if(typeof r!="string"||!r)throw new Error("no agent_transcript_path on stdin");const n=b(m.readFileSync(r,"utf8"));if(!n.length)return;(await import("../../bin/install.mjs")).migrateOnStart();const e=await import("../store.mjs");for(const t of n)try{if(t.site!==null&&!/^[\w-]+$/.test(t.site))throw new Error(`--site ${t.site} is not a route`);if(t.dir?.includes("$"))throw new Error(`--dir ${t.dir} names a shell variable`);if(t.key.includes("$")||t.agent.includes("$"))throw new Error("the key or --agent names a shell variable");const l=t.site===null?null:await e.siteDir(t.site),i=t.dir===void 0?void 0:S(t.dir);await e.stopBuilder(l,t.key,{dir:i,agent:t.agent,startedBetween:[t.from,t.to]})}catch(l){process.stderr.write(`builder-stop-hook: ${t.key}${t.agent==="main"?"":` --agent ${t.agent}`}: ${l.message}
-`)}}c(N,"main");try{await N()}catch(s){process.stderr.write(`builder-stop-hook: ${s.message}
+var y=Object.defineProperty;var c=(s,o)=>y(s,"name",{value:o,configurable:!0});import g from"node:fs";import m from"node:os";const h=120*1e3,w=5*1e3,_=/(?:\bbuilder|\bagent\.mjs)\s+start\s+["']?([^\s"';|&]+)/g,p=c((s,o)=>{const n=new RegExp(`--${o}(?:=|\\s+)(?:"([^"]*)"|'([^']*)'|([^\\s"';|&)]+))`,"g");let e;for(const r of s.matchAll(n))e=r[1]??r[2]??r[3];return e},"flagIn");function k(s){const o=[];for(const n of s.matchAll(_)){const e=s.slice(n.index),r=e.slice(0,e.search(/\n|;|&&|\|\||\|(?!\|)|$/));o.push({key:n[1],site:p(r,"site")??p(s.slice(0,n.index),"site")??null,agent:p(r,"agent")??"main",dir:p(r,"dir")})}return o}c(k,"startsIn");const $=c(s=>s.replace(/^~(?=\/|$)/,m.homedir()).replace(/^\$(?:HOME|\{HOME\})(?=\/|$)/,m.homedir()),"expandHome");function b(s){const o=[],n=new Map;for(const e of s.split(`
+`)){const r=e.includes('"assistant"')&&/ start/.test(e)&&/builder|agent\.mjs/.test(e),l=n.size&&e.includes("tool_result")&&[...n.keys()].some(i=>e.includes(i));if(!r&&!l)continue;let t;try{t=JSON.parse(e)}catch{continue}const a=Date.parse(t.timestamp),u=Array.isArray(t.message?.content)?t.message.content:[];if(t.type==="assistant"&&!Number.isNaN(a))for(const i of u){if(i?.type!=="tool_use"||typeof i.input?.command!="string")continue;const d=k(i.input.command).map(f=>({...f,from:a-w,to:a+h}));o.push(...d),i.id&&d.length&&n.set(i.id,d)}else if(t.type==="user"&&!Number.isNaN(a))for(const i of u){const d=i?.type==="tool_result"&&n.get(i.tool_use_id);if(d){for(const f of d)f.to=Math.max(f.to,a+h);n.delete(i.tool_use_id)}}}return o}c(b,"startsInTranscript");function S(s){const o=new Set;for(const n of s.split(`
+`)){if(!n.includes('"toolUseResult"')||!/"backgroundTaskId"|"taskId"|"async_launched"/.test(n))continue;let e;try{e=JSON.parse(n).toolUseResult}catch{continue}const r=e?.backgroundTaskId??e?.taskId??(e?.status==="async_launched"?e.agentId:void 0);typeof r=="string"&&o.add(r)}return o}c(S,"backgroundIdsIn");async function I(){const s=JSON.parse(g.readFileSync(0,"utf8")),o=s?.agent_transcript_path;if(typeof o!="string"||!o)throw new Error("no agent_transcript_path on stdin");const n=g.readFileSync(o,"utf8"),e=b(n);if(!e.length)return;const r=S(n);if((s.background_tasks??[]).some(t=>r.has(t.id)))return;const l=await import("../store.mjs");for(const t of e)try{if(t.site!==null&&!/^[\w-]+$/.test(t.site))throw new Error(`--site ${t.site} is not a route`);if(t.dir?.includes("$"))throw new Error(`--dir ${t.dir} names a shell variable`);if(t.key.includes("$")||t.agent.includes("$"))throw new Error("the key or --agent names a shell variable");const a=t.site===null?null:await l.siteDir(t.site),u=t.dir===void 0?void 0:$(t.dir);await l.stopBuilder(a,t.key,{dir:u,agent:t.agent,startedBetween:[t.from,t.to]})}catch(a){process.stderr.write(`builder-stop-hook: ${t.key}${t.agent==="main"?"":` --agent ${t.agent}`}: ${a.message}
+`)}}c(I,"main");try{await I()}catch(s){process.stderr.write(`builder-stop-hook: ${s.message}
 `)}process.exitCode=0;