@lovek4d/kickflip 0.6.1 → 0.7.1

package/bin/event-lines.mjs

@@ -0,0 +1 @@
+var r=Object.defineProperty;var t=(e,a)=>r(e,"name",{value:a,configurable:!0});import{waitsAgainLine as d}from"../board/domain.mjs";const i=["main-pulled","settings","ask-done","reviewers-removed","reviewers-added","question-reopen","repo-changed","ping","hello","card-hold","card-done","card-unbump","card-unblocked","grill-more","prototype-request","visual-request","usage-resumed"],n=t(e=>{try{return JSON.parse(e).kind}catch{return null}},"kindOf"),h=t(e=>i.includes(n(e)),"recordOnly"),l={ask:t(e=>`new task ${e.id} received: sort it: file it with item add --from-ask, fold it with item relate-ask, or answer it with reply`,"ask"),"owner-answer":t(e=>`answer received to question ${e.data?.id}: act on it on its card`,"owner-answer"),ping:t(e=>`ping ${e.id} from the hub answered`,"ping"),hello:t(e=>`ping ${e.id} from the hub answered`,"hello"),"overnight-triage":t(e=>`Overnight triage ${e.data?.date} asks Claude to reply: ${e.data?.cards?.length} cards wait on open questions; run the triage, then board.mjs reply ${e.id}`,"overnight-triage"),"pr-review":t(e=>`review asked on PR #${e.data?.pr}: the board was idle; read its diff and review post it`,"pr-review"),"orchestrator-waits":t(e=>[e.data?.added?.length&&`waiting on you now: ${e.data.added.join(", ")}`,e.data?.again?.length&&d(e.data.again,Date.parse(e.ts))].filter(Boolean).join(" \xB7 "),"orchestrator-waits"),"check-github":t(e=>e.data?.reason==="morning"?"the daily wake: run one GitHub tick, then walk every lane top-down once: clear each blocked-until condition that holds, and act on any card stuck with no wait; a thread line on each card you act on, nothing else":"GitHub check asked: run one GitHub tick","check-github"),"github-change":t(e=>`${e.data?.prs?.length??0} PRs changed on GitHub: run one GitHub tick`,"github-change"),"review-answer":t(e=>e.data?.answer==="skip"?`skip answered on the review of PR #${e.data?.pr}: record it posted, post nothing`:`post answered on the review of PR #${e.data?.pr}: review post it`,"review-answer"),"plan-waves":t(e=>`Plan waves asked on ${e.data?.keys?.length??0} Todo cards: triage them into waves and ask the owner about them`,"plan-waves"),"arch-review":t(e=>`architecture review asked on ${e.data?.key}: review ${e.data?.repo} on ${e.data?.branch} and file the findings`,"arch-review"),rules:t(e=>`${e.data?.scope==="hub"?"hub":"board"} rules changed: the rule lines below are the new ones; follow them from now`,"rules"),"prototype-overdue":t(e=>`prototype overdue on ${e.data?.key}: dispatch its prototype agent now`,"prototype-overdue")},u={"item-message":t((e,a)=>String(a.data?.key).startsWith("ask:")&&a.data?.intent==="build"?`Implement asked on ${e}: file it with item add --from-ask --phase ready, with its --size and notes`:a.data?.intent==="build"?`Implement asked on ${e}: it is staging, the message in its notes; judge it against the whole board, then item set --phase ready --text "<what you checked>", or --phase grilling or prototyping`:`message received from ${e}'s thread: reply in its thread`,"item-message"),"card-bump":t(e=>`${e} bumped: handle its waits lines first; with none, leave it`,"card-bump"),"ask-bump":t(e=>`${e} bumped: take that ask first`,"ask-bump"),"ask-edited":t(e=>`${e} edited: use the new text, and say what changed if you had started`,"ask-edited"),"ask-done":t(e=>`${e} marked done`,"ask-done"),"ask-withdrawn":t(e=>`${e} deleted: drop it`,"ask-withdrawn"),"card-done":t(e=>`${e} marked done`,"card-done"),"card-hold":t((e,a)=>`${e} ${a.data?.hold?"held":"resumed"}`,"card-hold"),"card-unblocked":t(e=>`${e} unblocked`,"card-unblocked"),"prototype-request":t(e=>`prototype asked on ${e}`,"prototype-request"),"visual-request":t(e=>`visual asked on ${e}: the board launches its visual agent`,"visual-request"),"reask-request":t(e=>`question asked again on ${e}: ask it again with question add reask_of`,"reask-request"),"builder-resume":t((e,a)=>`${e}'s pause cleared (${a.data?.cleared}): tell its builder in your session to carry on where it stopped`,"builder-resume"),"builder-ask":t((e,a)=>`${a.data?.ask} from ${e}'s builder: ${a.data?.text} (builder answer it, or builder defer it)`,"builder-ask"),"owner-check-broken":t((e,a)=>`${e}'s owner-step check can't run: ${a.data?.error}; fix it with item set --check, or drop it`,"owner-check-broken"),"card-added":t(e=>`${e} added by an agent: link it and file it: item notes, then item set --relate and --phase`,"card-added")};export{u as ON_CARD,l as PLAIN,i as RECORD_ONLY,h as recordOnly};

package/bin/kickflip.mjs

@@ -35,7 +35,7 @@
 //               --hub makes this board the hub board, as `set --hub` does; a join without either keeps the flag.
 //               The hub board's session runs in the foreground in tmux (`hub`); every other board's in the background
 //               --template board runs the shared board (../board/server.mjs) from the site dir,
-//               writing its board.json; --items is "waves" (default) or a wave.json-format file, made with no
+//               writing its board.json; --items is "waves" (default) or an item file, made with no
 //               items when missing.
 //               It then runs handshake, unless this session already answered the board's ping, and
 //               asks the hub for one poll (as poll-now --keep-queue), so the board's GitHub link passes
@@ -161,10 +161,10 @@
 //               checked.json, then the queue unless --keep-queue) and prints its result
 // Exit codes: 0 ok, 1 error, 2 bad usage, 3 route owned by another session (join/leave), or its recorded session is
 // live (start/resume/hub). hub passes through claude's exit code.
-var Ne=Object.defineProperty;var h=(e,t)=>Ne(e,"name",{value:t,configurable:!0});import w from"node:fs";import d from"node:path";import D from"node:os";import re from"node:net";import Te from"node:readline/promises";import{execFileSync as ae,spawnSync as K}from"node:child_process";import{fileURLToPath as Ie}from"node:url";import{ICON_KEYS as ce}from"../hub/icons.mjs";import{liveSessions as G}from"../hub/live.mjs";import{isBoardSite as L,writeManifest as v}from"../hub/boards.mjs";import{joinName as Fe,routeFromName as F,routeRecord as g,validRoute as C}from"../hub/routes.mjs";import{defaultBranch as Ce,githubFromOrigin as Ee}from"../hub/repos.mjs";import{hasBuildScript as Re,onboardingItems as Be}from"../board/onboarding.mjs";import{uninstallStatusLine as Ae,storedPath as De,nodeBin as U,watcherCommand as Le,tailnetUrl as Pe}from"./install.mjs";import{hubService as de}from"../shared/service.mjs";import{tailscaleBin as ue}from"../shared/tailscale.mjs";import{runDoctor as He}from"./doctor.mjs";import{cloneRoot as Je}from"../shared/repos.mjs";const j=Je(),N=d.join(D.homedir(),".claude","kickflip"),ze=d.join(N,"manifest.json"),le=d.join(N,"logs"),T=Number(process.env.KICKFLIP_HUB_PORT||4500),W=4600,qe=/^#([0-9a-f]{3}|[0-9a-f]{6})$/i,[Y,...S]=process.argv.slice(2),s=Object.assign(Object.create(null),{_:[]});for(let e=0;e<S.length;e++){const t=S[e];if(t.startsWith("--")){const n=t.slice(2);n==="fix"||n==="force"||n==="json"||n==="urgent"||n==="now"||n==="keep-queue"||n==="hub"||n==="no-hub"||n==="dry-run"||n==="no-restart"||n==="watch"&&(e+1>=S.length||S[e+1].startsWith("--"))?s[n]=!0:s[n]=S[++e]}else s._.push(t)}const f=h(e=>console.log(typeof e=="string"?e:JSON.stringify(e,null,2)),"out");class I extends Error{static{h(this,"Exit")}constructor(t,n){super(t),this.code=n}}const i=h((e,t=1)=>{throw new I(e,t)},"fail");function Q(){s.icon&&!ce.includes(s.icon)&&i(`--icon takes one of: ${ce.join(", ")}`,2),s.color&&!qe.test(s.color)&&i("--color takes a CSS hex color, such as #3b82f6",2)}h(Q,"checkLook");function X(e){for(const t of["icon","color"])s[t]===""?delete e[t]:s[t]!==void 0&&(e[t]=s[t])}h(X,"applyLook");const fe=h(()=>s.hub&&s["no-hub"]&&i("pass --hub or --no-hub, not both",2),"checkHub"),he=h(e=>i(`/${e} is not a board; only a board can be the hub board`,2),"notBoard");function Z(e,t,n){if(s["no-hub"]&&delete n.hub,!!s.hub){L(n)||he(t);for(const[o,p]of Object.entries(e.sites))o!==t&&p?.hub&&delete p.hub;n.hub=!0}}h(Z,"applyHub");function y(){try{const e=JSON.parse(w.readFileSync(ze,"utf8"));return e.sites||={},e}catch(e){if(e.code==="ENOENT")return{version:1,sites:{}};i("manifest unreadable: "+e.message)}}h(y,"readManifest");const pe=h(e=>{try{return JSON.parse(w.readFileSync(e,"utf8"))}catch{return null}},"readJSON"),E=h(()=>import(d.join(j,"hub","sessions.mjs")),"sessionsModule");async function P(e){const{SessionError:t}=await E();try{return await e()}catch(n){throw n instanceof t&&i(n.message,n.reason==="live"?3:n.reason==="hub"?2:1),n}}h(P,"sessionCall");async function me(e){const{handshake:t}=await import(d.join(j,"hub","boards.mjs"));try{return await t(e,y())}catch(n){return i(n.message,2)}}h(me,"runHandshake");async function Me(e){for(let t=0;t<2;t++){let n;try{n=await fetch(`http://127.0.0.1:${T}/_hub/poll`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({flush:!1}),signal:AbortSignal.timeout(5*6e4)})}catch(p){return`not run (${p.message})`}if(!n.ok)return`not run (the hub answered ${n.status})`;const o=await n.json();if(o.checked?.includes(e))return"reached this board";if(o.failed?.length)return`missed this board: ${o.failed[0]}`}return"missed this board"}h(Me,"pollFor");async function O(e){const{withManifestLock:t}=await import(d.join(j,"hub","boards.mjs"));try{return await t(e)}catch(n){throw n.code==="ELOCKED"&&i(n.message),n}}h(O,"withLock");function we(e){return new Promise(t=>{const n=re.connect({port:e,host:"127.0.0.1"}),o=h(p=>{n.destroy(),t(p)},"done");n.setTimeout(500,()=>o(!1)),n.on("connect",()=>o(!0)),n.on("error",()=>o(!1))})}h(we,"connects");function Ke(e){return new Promise(t=>{const n=re.createServer();n.once("error",()=>t(!1)),n.listen(e,"0.0.0.0",()=>n.close(()=>t(!0)))})}h(Ke,"bindable");async function H(e){const t=new Set([...Object.values(e.sites),...Object.values(e.closed||{}).map(n=>n.site)].map(n=>n?.port));for(let n=W;n<W+400;n++)if(!t.has(n)&&!await we(n)&&await Ke(n))return n;i("no free port found from "+W)}h(H,"freePort");function Ge(){const e=ue();if(!e)return"";try{return(JSON.parse(ae(e,["status","--json"],{encoding:"utf8",stdio:["ignore","pipe","ignore"]})).Self?.DNSName||"").replace(/\.$/,"")}catch{return""}}h(Ge,"tailnetHost");const V=h(e=>{const t=Ge();return t?`https://${t}/${e}/`:`http://127.0.0.1:${T}/${e}/`},"siteUrl");async function J(){try{return await(await fetch(`http://127.0.0.1:${T}/_hub/status.json`,{signal:AbortSignal.timeout(1500)})).json()}catch{return null}}h(J,"hubStatus");const ge=h(e=>{try{return w.statSync(e).isDirectory()}catch{return!1}},"isFolder"),Ue=h(e=>{try{return w.realpathSync(e)}catch{return null}},"realPath");function be(e=t=>{}){(typeof s.name!="string"||!s.name.trim())&&i('join needs --name "<name>": the board or page name, which gives its route',2);const t=s.name.trim().replace(/\s+/g," "),n=F(t);return C(n)||i(`--name "${t}" needs a letter or digit for its route`,2),{route:n,title:t===n&&e(n)?.title||t}}h(be,"named");function ye(e,{title:t,items:n,tickets:o,repo:p,ref:l}){w.mkdirSync(d.join(e,"data"),{recursive:!0});const r=d.join(e,"board.json"),u=w.existsSync(r)?JSON.parse(w.readFileSync(r,"utf8")):{};u.title=t,u.items=De(n||u.items||"waves"),o&&(u.tickets=o),w.writeFileSync(r,JSON.stringify(u,null,2)+`
-`);const c=u.items==="waves"?null:d.resolve(e,u.items);if(c&&!w.existsSync(c)){w.mkdirSync(d.dirname(c),{recursive:!0});const a=u.tickets?.source==="internal"?u.tickets.prefix:void 0,b=Be(c,{prefix:a,hasBuild:Re(p,l)});w.writeFileSync(c,JSON.stringify({title:u.title,items:b},null,2)+`
-`)}return[U(),d.join(j,"board","server.mjs"),e]}h(ye,"boardFiles");async function ee(e,t){const{startSession:n,withSessionLock:o}=await E();return o(e,async()=>{const p=await P(()=>n(e,{manifest:y(),...t}));return await O(async()=>{const l=y(),r={session:p.session,label:p.name,since:new Date().toISOString(),repo:p.repo,...p.model?{model:p.model}:{}};g(l.sites,e)?(l.sites[e].owner=r,l.sites[e].updated=r.since):l.starting={...l.starting,[e]:{...g(l.starting,e),...r}},await v(l)}),p})}h(ee,"startRecorded");async function z(e){const{hubSession:t}=await E(),n=await P(()=>t({manifest:y(),repo:e}));process.exitCode=n.status}h(z,"openHub");const ke=h((e,...t)=>{const n=K("git",["-C",e,...t],{encoding:"utf8"});return n.status===0?n.stdout.trim():null},"git"),te=h(()=>!!(process.stdin.isTTY&&process.stdout.isTTY),"canAsk");async function ne(e,t="stopped at the prompt; nothing changed"){const n=Te.createInterface({input:process.stdin,output:process.stdout});try{return(await n.question(e)).trim()}catch(o){throw o.code==="ABORT_ERR"&&i(t),o}finally{n.close()}}h(ne,"ask");const Se=h((e,t)=>!!(g(e.sites,t)||g(e.starting,t)||g(e.closed,t)),"taken");function We(e){return!/^[A-Za-z0-9 ]+$/.test(e)||!C(F(e))?"A board name takes letters, digits and spaces, up to 41 characters of route.":Se(y(),F(e))?`/${F(e)} is taken; pick another name.`:null}h(We,"nameProblem");const je="--template board --items data/wave.json";async function Ye(){const e=ke(process.cwd(),"rev-parse","--show-toplevel");e||i(`${process.cwd()} is not in a git repo; run kickflip join in the folder of the repo to add as a board`,2);const t=w.realpathSync(e);await J()||i("the hub is not running; run kickflip init to set it up, then kickflip join here again");const n=Object.entries(y().sites).find(([,m])=>L(m)&&m.owner?.repo&&Ue(m.owner.repo)===t),o=await Ce(t);if(n)return Qe(...n,o);const p=d.basename(t).replace(/[^A-Za-z0-9]+/g," ").trim();let l=s.name?.trim();for(l===void 0&&!te()&&i('join needs --name "<Board name>" when it has no terminal to ask in',2);;){l===void 0&&(l=await ne(`Board name${p?` (${p})`:""}: `)||p);const m=We(l);if(!m)break;s.name!==void 0&&i(m,2),f(m),l=void 0}const r=l.replace(/\s+/g," "),u=F(r),c=ke(t,"remote","get-url","origin"),a=c?Ee(c):null,{trustFolder:b}=await import("../hub/trust.mjs");try{b(t)}catch(m){i(`Couldn't trust this folder for Claude Code: ${m.message}`)}if(await O(async()=>{const m=y();Se(m,u)&&i(`/${u} is taken; pick another name`,2);const k=d.join(N,"sites",u),$=new Date().toISOString(),x={dir:k,port:await H(m),cmd:ye(k,{title:r,items:"data/wave.json",repo:t,ref:o||"HEAD"}),watch:["data/events.jsonl"],title:r,local:!0,...a?{github:a}:{},...o?{branch:o}:{},owner:{repo:t},created:$,updated:$};m.sites={...m.sites,[u]:x},Z(m,u,x),await v(m)}),f(`Made ${r} at ${V(u)}, working in ${t}${a?` (${a})`:""}.`),s.hub)return f("It is the hub board, so its session runs in tmux, attached here."),z(t);try{await ee(u,{repo:t,prompt:je})}catch(m){throw m instanceof I&&i(`${m.message}
-The board is made; run kickflip join here again to start its session.`,m.code),m}f("Its session is starting in the background, and joins the board shortly.")}h(Ye,"joinFolder");function $e(e){const t=de(),n=t.restart();n&&i(`${e}: ${n}; run ${t.restartCommand}`),f("restarted the hub")}h($e,"restartHub");async function Qe(e,t,n){const o=t.title||e;f(`This folder already has a board: ${o} (/${e}).`),n&&n!==t.branch&&(await O(async()=>{const u=y();Object.assign(g(u.sites,e),{branch:n,updated:new Date().toISOString()}),await v(u)}),f(`Its branch is now ${n}${t.branch?` (it was ${t.branch})`:""}.`)),te()||i(t.hub===!0?"Open its session with kickflip hub.":"Run kickflip join in a terminal to restart its session, or tap Restart on its row of the Hub page.");const p=(await ne("Restart its session? (Y/n) ")).toLowerCase();if(p&&!"yes".startsWith(p))return;if(!t.owner.session)return t.hub===!0?z(t.owner.repo):(await ee(e,{repo:t.owner.repo,prompt:je}),f("Its session is starting in the background."));const l=await fetch(`http://127.0.0.1:${T}/_hub/restart-board`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({route:e}),signal:AbortSignal.timeout(5*6e4)}),r=await l.json();if(l.ok||i(r.error),f(`Restarted ${o}'s session.`),t.hub===!0)return z(t.owner.repo)}h(Qe,"restartFolderBoard");const se=["title","description","icon","color","created","watch","filter","hub","github","remote","branch","local"],ve=["notifications","quiet","codexShare"],R="kickflip-board",Xe=/^(\.watch-cursor-.*\.json|watcher\.json)$/,B=h((e,t)=>Object.fromEntries(t.filter(n=>e[n]!==void 0).map(n=>[n,e[n]])),"pick"),q=h(e=>/^[\w@%+=:,./-]+$/.test(e)?e:`'${String(e).replace(/'/g,"'\\''")}'`,"shellQuote");function Oe(e){const t=K("tar",e[0]==="-czf"?["--no-xattrs",...e]:e,{encoding:"utf8",env:{...process.env,COPYFILE_DISABLE:"1"}});t.status!==0&&i(`tar ${e[0]} failed: ${(t.stderr||t.error?.message||"").trim()}`)}h(Oe,"tar");function Ze(e,t){const n=e.entry.title||e.route,o=Object.keys(e.settings).map(p=>({notifications:"Notifications",quiet:"Quiet hours",codexShare:"Codex share"})[p]);return`# Moving ${n} (/${e.route}) to another machine
+var Ne=Object.defineProperty;var p=(e,t)=>Ne(e,"name",{value:t,configurable:!0});import w from"node:fs";import u from"node:path";import D from"node:os";import re from"node:net";import Te from"node:readline/promises";import{execFileSync as ae,spawnSync as K}from"node:child_process";import{fileURLToPath as Ie}from"node:url";import{ICON_KEYS as ce}from"../hub/icons.mjs";import{liveSessions as G}from"../hub/live.mjs";import{isBoardSite as L,writeManifest as v}from"../hub/boards.mjs";import{joinName as Fe,routeFromName as F,routeRecord as g,validRoute as C}from"../hub/routes.mjs";import{defaultBranch as Ce,githubFromOrigin as Ee}from"../hub/repos.mjs";import{hasBuildScript as Re,onboardingItems as Be}from"../board/onboarding.mjs";import{uninstallStatusLine as Ae,storedPath as De,nodeBin as U,watcherCommand as Le,tailnetUrl as Pe}from"./install.mjs";import{hubService as de}from"../shared/service.mjs";import{tailscaleBin as ue}from"../shared/tailscale.mjs";import{runDoctor as He}from"./doctor.mjs";import{cloneRoot as Je}from"../shared/repos.mjs";const y=Je(),N=u.join(D.homedir(),".claude","kickflip"),ze=u.join(N,"manifest.json"),le=u.join(N,"logs"),T=Number(process.env.KICKFLIP_HUB_PORT||4500),W=4600,qe=/^#([0-9a-f]{3}|[0-9a-f]{6})$/i,[Y,...j]=process.argv.slice(2),s=Object.assign(Object.create(null),{_:[]});for(let e=0;e<j.length;e++){const t=j[e];if(t.startsWith("--")){const n=t.slice(2);n==="fix"||n==="force"||n==="json"||n==="urgent"||n==="now"||n==="keep-queue"||n==="hub"||n==="no-hub"||n==="dry-run"||n==="no-restart"||n==="watch"&&(e+1>=j.length||j[e+1].startsWith("--"))?s[n]=!0:s[n]=j[++e]}else s._.push(t)}const f=p(e=>console.log(typeof e=="string"?e:JSON.stringify(e,null,2)),"out");class I extends Error{static{p(this,"Exit")}constructor(t,n){super(t),this.code=n}}const i=p((e,t=1)=>{throw new I(e,t)},"fail");function Q(){s.icon&&!ce.includes(s.icon)&&i(`--icon takes one of: ${ce.join(", ")}`,2),s.color&&!qe.test(s.color)&&i("--color takes a CSS hex color, such as #3b82f6",2)}p(Q,"checkLook");function X(e){for(const t of["icon","color"])s[t]===""?delete e[t]:s[t]!==void 0&&(e[t]=s[t])}p(X,"applyLook");const fe=p(()=>s.hub&&s["no-hub"]&&i("pass --hub or --no-hub, not both",2),"checkHub"),he=p(e=>i(`/${e} is not a board; only a board can be the hub board`,2),"notBoard");function Z(e,t,n){if(s["no-hub"]&&delete n.hub,!!s.hub){L(n)||he(t);for(const[o,h]of Object.entries(e.sites))o!==t&&h?.hub&&delete h.hub;n.hub=!0}}p(Z,"applyHub");function k(){try{const e=JSON.parse(w.readFileSync(ze,"utf8"));return e.sites||={},e}catch(e){if(e.code==="ENOENT")return{version:1,sites:{}};i("manifest unreadable: "+e.message)}}p(k,"readManifest");const pe=p(e=>{try{return JSON.parse(w.readFileSync(e,"utf8"))}catch{return null}},"readJSON"),E=p(()=>import(u.join(y,"hub","sessions.mjs")),"sessionsModule");async function P(e){const{SessionError:t}=await E();try{return await e()}catch(n){throw n instanceof t&&i(n.message,n.reason==="live"?3:n.reason==="hub"?2:1),n}}p(P,"sessionCall");async function me(e){const{handshake:t}=await import(u.join(y,"hub","boards.mjs"));try{return await t(e,k())}catch(n){return i(n.message,2)}}p(me,"runHandshake");async function Me(e){for(let t=0;t<2;t++){let n;try{n=await fetch(`http://127.0.0.1:${T}/_hub/poll`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({flush:!1}),signal:AbortSignal.timeout(5*6e4)})}catch(h){return`not run (${h.message})`}if(!n.ok)return`not run (the hub answered ${n.status})`;const o=await n.json();if(o.checked?.includes(e))return"reached this board";if(o.failed?.length)return`missed this board: ${o.failed[0]}`}return"missed this board"}p(Me,"pollFor");async function O(e){const{withManifestLock:t}=await import(u.join(y,"hub","boards.mjs"));try{return await t(e)}catch(n){throw n.code==="ELOCKED"&&i(n.message),n}}p(O,"withLock");function we(e){return new Promise(t=>{const n=re.connect({port:e,host:"127.0.0.1"}),o=p(h=>{n.destroy(),t(h)},"done");n.setTimeout(500,()=>o(!1)),n.on("connect",()=>o(!0)),n.on("error",()=>o(!1))})}p(we,"connects");function Ke(e){return new Promise(t=>{const n=re.createServer();n.once("error",()=>t(!1)),n.listen(e,"0.0.0.0",()=>n.close(()=>t(!0)))})}p(Ke,"bindable");async function H(e){const t=new Set([...Object.values(e.sites),...Object.values(e.closed||{}).map(n=>n.site)].map(n=>n?.port));for(let n=W;n<W+400;n++)if(!t.has(n)&&!await we(n)&&await Ke(n))return n;i("no free port found from "+W)}p(H,"freePort");function Ge(){const e=ue();if(!e)return"";try{return(JSON.parse(ae(e,["status","--json"],{encoding:"utf8",stdio:["ignore","pipe","ignore"]})).Self?.DNSName||"").replace(/\.$/,"")}catch{return""}}p(Ge,"tailnetHost");const V=p(e=>{const t=Ge();return t?`https://${t}/${e}/`:`http://127.0.0.1:${T}/${e}/`},"siteUrl");async function J(){try{return await(await fetch(`http://127.0.0.1:${T}/_hub/status.json`,{signal:AbortSignal.timeout(1500)})).json()}catch{return null}}p(J,"hubStatus");const ge=p(e=>{try{return w.statSync(e).isDirectory()}catch{return!1}},"isFolder"),Ue=p(e=>{try{return w.realpathSync(e)}catch{return null}},"realPath");function be(e=t=>{}){(typeof s.name!="string"||!s.name.trim())&&i('join needs --name "<name>": the board or page name, which gives its route',2);const t=s.name.trim().replace(/\s+/g," "),n=F(t);return C(n)||i(`--name "${t}" needs a letter or digit for its route`,2),{route:n,title:t===n&&e(n)?.title||t}}p(be,"named");function ye(e,{title:t,items:n,tickets:o,repo:h,ref:d}){w.mkdirSync(u.join(e,"data"),{recursive:!0});const r=u.join(e,"board.json"),l=w.existsSync(r)?JSON.parse(w.readFileSync(r,"utf8")):{};l.title=t,l.items=De(n||l.items||"waves"),o&&(l.tickets=o),w.writeFileSync(r,JSON.stringify(l,null,2)+`
+`);const c=l.items==="waves"?null:u.resolve(e,l.items);if(c&&!w.existsSync(c)){w.mkdirSync(u.dirname(c),{recursive:!0});const a=l.tickets?.source==="internal"?l.tickets.prefix:void 0,b=Be(c,{prefix:a,hasBuild:Re(h,d)});w.writeFileSync(c,JSON.stringify({title:l.title,items:b},null,2)+`
+`)}return[U(),u.join(y,"board","server.mjs"),e]}p(ye,"boardFiles");async function ee(e,t){const{startSession:n,withSessionLock:o}=await E();return o(e,async()=>{const h=await P(()=>n(e,{manifest:k(),...t}));return await O(async()=>{const d=k(),r={session:h.session,label:h.name,since:new Date().toISOString(),repo:h.repo,...h.model?{model:h.model}:{}};g(d.sites,e)?(d.sites[e].owner=r,d.sites[e].updated=r.since):d.starting={...d.starting,[e]:{...g(d.starting,e),...r}},await v(d)}),h})}p(ee,"startRecorded");async function z(e){const{hubSession:t}=await E(),n=await P(()=>t({manifest:k(),repo:e}));process.exitCode=n.status}p(z,"openHub");const ke=p((e,...t)=>{const n=K("git",["-C",e,...t],{encoding:"utf8"});return n.status===0?n.stdout.trim():null},"git"),te=p(()=>!!(process.stdin.isTTY&&process.stdout.isTTY),"canAsk");async function ne(e,t="stopped at the prompt; nothing changed"){const n=Te.createInterface({input:process.stdin,output:process.stdout});try{return(await n.question(e)).trim()}catch(o){throw o.code==="ABORT_ERR"&&i(t),o}finally{n.close()}}p(ne,"ask");const Se=p((e,t)=>!!(g(e.sites,t)||g(e.starting,t)||g(e.closed,t)),"taken");function We(e){return!/^[A-Za-z0-9 ]+$/.test(e)||!C(F(e))?"A board name takes letters, digits and spaces, up to 41 characters of route.":Se(k(),F(e))?`/${F(e)} is taken; pick another name.`:null}p(We,"nameProblem");const je="--template board --items data/items.json";async function Ye(){const e=ke(process.cwd(),"rev-parse","--show-toplevel");e||i(`${process.cwd()} is not in a git repo; run kickflip join in the folder of the repo to add as a board`,2);const t=w.realpathSync(e);await J()||i("the hub is not running; run kickflip init to set it up, then kickflip join here again");const n=Object.entries(k().sites).find(([,m])=>L(m)&&m.owner?.repo&&Ue(m.owner.repo)===t),o=await Ce(t);if(n)return Qe(...n,o);const h=u.basename(t).replace(/[^A-Za-z0-9]+/g," ").trim();let d=s.name?.trim();for(d===void 0&&!te()&&i('join needs --name "<Board name>" when it has no terminal to ask in',2);;){d===void 0&&(d=await ne(`Board name${h?` (${h})`:""}: `)||h);const m=We(d);if(!m)break;s.name!==void 0&&i(m,2),f(m),d=void 0}const r=d.replace(/\s+/g," "),l=F(r),c=ke(t,"remote","get-url","origin"),a=c?Ee(c):null,{trustFolder:b}=await import("../hub/trust.mjs");try{b(t)}catch(m){i(`Couldn't trust this folder for Claude Code: ${m.message}`)}if(await O(async()=>{const m=k();Se(m,l)&&i(`/${l} is taken; pick another name`,2);const S=u.join(N,"sites",l),$=new Date().toISOString(),x={dir:S,port:await H(m),cmd:ye(S,{title:r,items:"data/items.json",repo:t,ref:o||"HEAD"}),watch:["data/events.jsonl"],title:r,local:!0,...a?{github:a}:{},...o?{branch:o}:{},owner:{repo:t},created:$,updated:$};m.sites={...m.sites,[l]:x},Z(m,l,x),await v(m)}),f(`Made ${r} at ${V(l)}, working in ${t}${a?` (${a})`:""}.`),s.hub)return f("It is the hub board, so its session runs in tmux, attached here."),z(t);try{await ee(l,{repo:t,prompt:je})}catch(m){throw m instanceof I&&i(`${m.message}
+The board is made; run kickflip join here again to start its session.`,m.code),m}f("Its session is starting in the background, and joins the board shortly.")}p(Ye,"joinFolder");function $e(e){const t=de(),n=t.restart();n&&i(`${e}: ${n}; run ${t.restartCommand}`),f("restarted the hub")}p($e,"restartHub");async function Qe(e,t,n){const o=t.title||e;f(`This folder already has a board: ${o} (/${e}).`),n&&n!==t.branch&&(await O(async()=>{const l=k();Object.assign(g(l.sites,e),{branch:n,updated:new Date().toISOString()}),await v(l)}),f(`Its branch is now ${n}${t.branch?` (it was ${t.branch})`:""}.`)),te()||i(t.hub===!0?"Open its session with kickflip hub.":"Run kickflip join in a terminal to restart its session, or tap Restart on its row of the Hub page.");const h=(await ne("Restart its session? (Y/n) ")).toLowerCase();if(h&&!"yes".startsWith(h))return;if(!t.owner.session)return t.hub===!0?z(t.owner.repo):(await ee(e,{repo:t.owner.repo,prompt:je}),f("Its session is starting in the background."));const d=await fetch(`http://127.0.0.1:${T}/_hub/restart-board`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({route:e}),signal:AbortSignal.timeout(5*6e4)}),r=await d.json();if(d.ok||i(r.error),f(`Restarted ${o}'s session.`),t.hub===!0)return z(t.owner.repo)}p(Qe,"restartFolderBoard");const se=["title","description","icon","color","created","watch","filter","hub","github","remote","branch","local"],ve=["notifications","quiet","codexShare"],R="kickflip-board",Xe=/^(\.watch-cursor-.*\.json|watcher\.json)$/,B=p((e,t)=>Object.fromEntries(t.filter(n=>e[n]!==void 0).map(n=>[n,e[n]])),"pick"),q=p(e=>/^[\w@%+=:,./-]+$/.test(e)?e:`'${String(e).replace(/'/g,"'\\''")}'`,"shellQuote");function Oe(e){const t=K("tar",e[0]==="-czf"?["--no-xattrs",...e]:e,{encoding:"utf8",env:{...process.env,COPYFILE_DISABLE:"1"}});t.status!==0&&i(`tar ${e[0]} failed: ${(t.stderr||t.error?.message||"").trim()}`)}p(Oe,"tar");function Ze(e,t){const n=e.entry.title||e.route,o=Object.keys(e.settings).map(h=>({notifications:"Notifications",quiet:"Quiet hours",codexShare:"Codex share"})[h]);return`# Moving ${n} (/${e.route}) to another machine
 
 Exported from ${e.from} at ${e.exported_at}. This bundle holds the board's folder and manifest entry${o.length?`, and the hub's ${o.length>1?`${o.slice(0,-1).join(", ")} and ${o.at(-1)}`:o[0]} settings, which import writes over the new machine's`:""}.
 
@@ -188,10 +188,10 @@ The bundle carries no secret and nothing tied to the old machine. Set these up o
 - Other hub settings, such as the pause line and Rules for every board, stay on the old machine.
 
 Manifest fields left out, which the new machine sets itself: ${e.dropped.length?e.dropped.join(", "):"none"}.
-`}h(Ze,"exportReadme");async function Ve(){Q();const e=s.port===void 0?void 0:Number(s.port);e!==void 0&&!(Number.isInteger(e)&&e>0&&e<65536)&&i("--port takes a port number",2),e===T&&i(`--port ${e} is the hub's own port`,2);let t;if(s.cmd!==void 0){try{t=JSON.parse(s.cmd)}catch{t=null}(!Array.isArray(t)||!t.length||!t.every(c=>typeof c=="string"))&&i(`--cmd takes a JSON array of strings, such as '["/abs/node","/abs/server.mjs"]'`,2)}const n=s.dir===void 0?void 0:d.resolve(s.dir);n!==void 0&&!t&&e===void 0&&!ge(n)&&i(`--dir ${n} is not a folder`,2);const{route:o,title:p}=be(c=>g(y().sites,c)),l=await O(async()=>{const c=y();g(c.closed,o)&&i("That board is closed; use kickflip reopen "+o,2),g(c.starting,o)&&i(`/${o} is a board that is starting; pick another route`,2);const a=g(c.sites,o);if(a?.owner?.session)throw f({error:"owned",route:o,owner:a.owner,hint:"a session owns this route: pick another route, or that session leaves it first"}),new I("",3);const b=new Date().toISOString(),m=a?{...a}:{created:b};delete m.watch,delete m.filter;{const k=t?{cmd:t,dir:n||a?.dir||process.cwd(),port:e??(a?.cmd?a.port:void 0)??await H(c)}:e!==void 0?{port:e,...n?{dir:n}:{}}:{dir:n};for(const $ of["cmd","dir","port","cwd","env"])delete m[$];Object.assign(m,k)}return m.title=p,s.description&&(m.description=s.description),X(m),m.updated=b,c.sites={...c.sites,[o]:m},await v(c),m}),r=l.cmd?"cmd":l.port?"port":"files",u=await J();f({route:o,url:V(o),serves:r,...l.port?{port:l.port}:{},...l.dir?{dir:l.dir}:{},...r==="port"?{answering:await we(l.port)}:{},hub:u?"running":"NOT running: run `kickflip doctor --fix`"})}h(Ve,"joinPage");const oe={async doctor(){s["dry-run"]&&!s.fix&&i("--dry-run needs --fix",2);const e=te()&&!s.json?n=>ne(n,"stopped at the prompt; the clones not yet answered are kept"):void 0,{exitCode:t}=await He({fix:!!s.fix,dryRun:!!s["dry-run"],json:!!s.json,ask:e});process.exitCode=t},async join(){if(s._.length&&i(`join takes no route: --name "<name>" gives the title and the route, as in kickflip join --name ${q(s._[0])}`,2),s.title!==void 0&&i('join takes no --title: --name "<name>" gives the title and the route',2),!s.session){const r=["port","dir","cmd"].some(c=>s[c]!==void 0),u=["watch","template","filter","label","model","repo","force","items",...r?["hub"]:[]].find(c=>s[c]!==void 0);return u&&i(`--${u} needs --session <id> (this session's id)`,2),r?Ve():Ye()}const{route:e,title:t}=be(r=>g(y().sites,r));s.template&&s.template!=="board"&&i('--template takes "board"',2),Q(),fe();const n=await O(async()=>{const r=y();g(r.closed,e)&&i("That board is closed; use kickflip reopen "+e,2);const u=new Date().toISOString(),c=g(r.sites,e);if(c?.owner?.session&&c.owner.session!==s.session&&!s.force)throw f({error:"owned",route:e,owner:c.owner,hint:"ask the user, then rerun with --force to take it over"}),new I("",3);s.hub&&s.template!=="board"&&!L({dir:"",cmd:s.cmd?JSON.parse(s.cmd):c?.cmd})&&he(e);const a=c?{...c}:{};let b=!1;if(c||(a.dir=d.resolve(s.dir||d.join(N,"sites",e)),(!w.existsSync(a.dir)||w.readdirSync(a.dir).length===0)&&!s.cmd&&!s.template&&(w.cpSync(d.join(j,"starter"),a.dir,{recursive:!0}),b=!0),a.port=s.port?Number(s.port):await H(r),a.cmd=s.cmd?JSON.parse(s.cmd):[U(),d.join(a.dir,"server.mjs")],a.watch=["data/events.jsonl"],a.created=u),s.dir&&c&&(a.dir=d.resolve(s.dir)),s.port&&c&&(a.port=Number(s.port)),s.cmd&&c&&(a.cmd=JSON.parse(s.cmd)),s.template==="board"){const _=g(r.starting,e),xe=!c&&_?.tickets&&(!_.session||_.session===s.session)?_.tickets:void 0,_e=s.repo?d.resolve(s.repo):G()?.get(s.session)?.cwd||process.cwd();a.cmd=ye(a.dir,{title:t,items:s.items,tickets:xe,repo:_e,ref:_?.branch||"HEAD"}),b=!c}a.title=t,s.description&&(a.description=s.description),typeof s.watch=="string"&&(a.watch=s.watch.split(",").map(_=>_.trim()).filter(Boolean)),s.filter!==void 0&&(a.filter=s.filter||void 0),X(a),Z(r,e,a);const m=c?.owner&&c.owner.session!==s.session?c.owner:null,k=g(r.starting,e)?.session===s.session?g(r.starting,e):null,$=g(r.starting,e);!c&&($?.github||$?.remote)&&(!$.session||$.session===s.session)&&($.github?a.github=$.github:a.remote=$.remote,a.branch=$.branch);const x=c?.owner?.session===s.session?c.owner:null,A=x||k||m;a.owner={...x||{session:s.session,since:u},label:s.label||A?.label||"",repo:s.repo?d.resolve(s.repo):(a.github||a.remote)&&A?.repo||G()?.get(s.session)?.cwd||A?.repo||process.cwd()};const ie=s.model||A?.model;ie&&(a.owner.model=ie);const M=g(r.starting,e);return M&&(r.starting[e]={...M,joined_at:M.joined_at||u}),a.updated=u,r.sites={...r.sites,[e]:a},await v(r),{route:e,created:b,previousOwner:m,site:a}}),o=await J();let p,l;if(s.template==="board"){const r=pe(d.join(n.site.dir,"data","handshake.json"));p=r?.ack&&(r.ping||r.hello)?.session===s.session?"answered before":await me(e),l=o?await Me(e):"not run (the hub is not running)"}f({route:e,url:V(e),dir:n.site.dir,port:n.site.port,owner:n.site.owner,createdFromStarter:n.created,previousOwner:n.previousOwner,log:d.join(le,e+".log"),watcher:Le(e,s.session,j),hub:o?"running":"NOT running: run `kickflip doctor --fix`",...p?{handshake:p}:{},...l?{poll:l}:{}})},async handshake(){const e=s._[0];e||i("handshake needs a route",2),f(await me(e))},async leave(){const e=s._[0];e||i("leave needs a route",2),await O(async()=>{const t=y(),n=g(t.sites,e);if(n||i("no site at /"+e),n.owner?.session&&!s.session&&!s.force&&i("a session owns /"+e+"; leave needs --session <id>, or --force",2),n.owner?.session&&n.owner.session!==s.session&&!s.force)throw f({error:"owned",route:e,owner:n.owner}),new I("",3);delete t.sites[e],await v(t),f({left:e,filesKept:n.dir})})},async start(){const e=s._[0];C(e)||i("start needs a route: lowercase letters, digits and dashes",2);const t=await ee(e,{repo:s.repo,model:s.model,prompt:s.prompt});f({route:t.route,session:t.session,confirmed:t.confirmed,repo:t.repo,argv:t.argv,output:t.output})},async resume(){const e=s._[0];e||i("resume needs a route",2);const{resumeSession:t}=await E();f(await P(()=>t(e,{manifest:y()})))},async close(){const{closeBoard:e}=await import("../hub/close-board.mjs");try{f(await e(s._[0],s.name))}catch(t){i(t.message,t.status?2:1)}},async reopen(){const{reopenBoard:e}=await import("../hub/close-board.mjs");try{f(await P(()=>e(s._[0])))}catch(t){throw t.status&&i(t.message,2),t}},async export(){const e=s._[0];C(e)||i("export needs a route: lowercase letters, digits and dashes",2);const t=d.resolve(s.out||`kickflip-${e}.tgz`);w.existsSync(t)&&i(`${t} already exists; pass another --out`,2);const n=g(y().sites,e)||i("no site at /"+e);L(n)||i(`/${e} is not a board; export moves a board`,2);const o=w.realpathSync(n.dir),{itemSources:p,openBoardBuilders:l}=await import("../board/store.mjs"),r=(await p(o)).find(k=>d.relative(o,k.file).startsWith(".."));r&&i(`/${e}'s cards live outside its folder (${r.file}); export moves only a board whose board.json items is a file in its folder`);const u=await l(o);u.length&&i(`a builder is open on /${e}: ${u.map(k=>`${k.key} (${k.label})`).join(", ")}; export once it is done`);const{readSettingsFile:c}=await import("../hub/push.mjs"),a=B(n,se),b={kickflip_export:1,route:e,exported_at:new Date().toISOString(),from:D.hostname(),entry:a,owner:B(n.owner||{},["label","model"]),settings:B(c(),ve),dropped:Object.keys(n).filter(k=>!se.includes(k))},m=w.mkdtempSync(d.join(D.tmpdir(),"kickflip-export-"));try{const k=d.join(m,R),$=d.join(o,"data");w.cpSync(o,d.join(k,"site"),{recursive:!0,filter:h(x=>!(d.dirname(x)===$&&Xe.test(d.basename(x))),"filter")}),w.writeFileSync(d.join(k,"export.json"),JSON.stringify(b,null,2)+`
-`),w.writeFileSync(d.join(k,"README.md"),Ze(b,d.basename(t))),Oe(["-czf",t,"-C",m,R])}finally{w.rmSync(m,{recursive:!0,force:!0})}f({route:e,file:t,entry:Object.keys(a),dropped:b.dropped,settings:Object.keys(b.settings)})},async import(){s._[0]||i("import needs the file kickflip export wrote",2);const e=d.resolve(s._[0]);w.existsSync(e)||i(`no file at ${e}`,2),w.mkdirSync(N,{recursive:!0});const t=w.mkdtempSync(d.join(N,".import-"));try{Oe(["-xzf",e,"-C",t]);const n=pe(d.join(t,R,"export.json"));(n?.kickflip_export!==1||!C(n.route)||!ge(d.join(t,R,"site")))&&i(`${e} is not a kickflip export`,2);const{route:o}=n,p=d.join(N,"sites",o),l=await O(async()=>{const a=y();(g(a.sites,o)||g(a.closed,o)||g(a.starting,o))&&i(`/${o} already exists on this host; import never replaces a board`),w.existsSync(p)&&i(`${p} already exists; import never replaces a board's folder`);const b=B(n.entry||{},se);b.hub&&Object.values(a.sites).some(k=>k?.hub)&&delete b.hub;const m={...b,dir:p,port:await H(a),cmd:[U(),d.join(j,"board","server.mjs"),p],updated:new Date().toISOString()};return w.mkdirSync(d.dirname(p),{recursive:!0}),w.renameSync(d.join(t,R,"site"),p),a.sites={...a.sites,[o]:m},await v(a),m}),r=B(n.settings||{},ve);if(Object.keys(r).length){const{readSettingsFile:a,writeSettingsFile:b}=await import("../hub/push.mjs");b({...a(),...r})}const{label:u,model:c}=n.owner||{};f({route:o,dir:p,port:l.port,settings:Object.keys(r),hub:l.hub===!0,join:`kickflip join --name ${q(Fe(o,l.title))} --session <this session's id> --watch --template board${u?` --label ${q(u)}`:""}${c?` --model ${q(c)}`:""} --force`})}finally{w.rmSync(t,{recursive:!0,force:!0})}},async sessions(){const{sessionOf:e}=await E(),{listBoards:t}=await import(d.join(j,"hub","boards.mjs")),n=y(),o=G(),l=[...t(n).map(r=>r.route),...Object.keys(n.starting||{}).filter(r=>!g(n.sites,r))].map(r=>{const u=e(n,r),c=u&&o?.get(u.session),a=u?o?c?c.kind==="bg"?"background":"terminal":null:"unknown":null;return{route:r,session:u?.session||null,live:a,repo:u?.repo||null,starting:!g(n.sites,r)}});if(s.json)return f(l);if(!l.length)return f("no boards");for(const r of l)f(`/${r.route}  ${r.session||"no session"}  ${r.live==="unknown"?"live unknown (ps gave no answer)":r.live?`live (${r.live})`:"not live"}  ${r.repo||"no folder"}${r.starting?"  (starting: not joined yet)":""}`)},async hub(){await z(s.repo)},async set(){const e=s._[0];e||i("set needs a route",2),s.icon===void 0&&s.color===void 0&&!s.hub&&!s["no-hub"]&&i("set needs --icon, --color, --hub or --no-hub",2),Q(),fe(),await O(async()=>{const t=y(),n=g(t.sites,e)||i("no site at /"+e);X(n),Z(t,e,n),n.updated=new Date().toISOString(),await v(t),f({route:e,icon:n.icon??null,color:n.color??null,hub:n.hub===!0})})},async restart(){const e=s._[0];if(!e)return $e("the hub did not restart");await O(async()=>{const t=y();g(t.sites,e)||i("no site at /"+e),t.sites[e].restart_at=Date.now(),await v(t)}),f(`restarting /${e}; the hub picks it up within 2 seconds`)},async url(){const e=s._[0];e&&!g(y().sites,e)&&i("no site at /"+e,2);try{f(Pe(e))}catch(t){i(t.message)}},async logs(){const e=s._[0],t=d.join(le,e+".log");w.existsSync(t)||i("no log yet for /"+e);const n=Number(s.lines||40);f(w.readFileSync(t,"utf8").split(`
+`}p(Ze,"exportReadme");async function Ve(){Q();const e=s.port===void 0?void 0:Number(s.port);e!==void 0&&!(Number.isInteger(e)&&e>0&&e<65536)&&i("--port takes a port number",2),e===T&&i(`--port ${e} is the hub's own port`,2);let t;if(s.cmd!==void 0){try{t=JSON.parse(s.cmd)}catch{t=null}(!Array.isArray(t)||!t.length||!t.every(c=>typeof c=="string"))&&i(`--cmd takes a JSON array of strings, such as '["/abs/node","/abs/server.mjs"]'`,2)}const n=s.dir===void 0?void 0:u.resolve(s.dir);n!==void 0&&!t&&e===void 0&&!ge(n)&&i(`--dir ${n} is not a folder`,2);const{route:o,title:h}=be(c=>g(k().sites,c)),d=await O(async()=>{const c=k();g(c.closed,o)&&i("That board is closed; use kickflip reopen "+o,2),g(c.starting,o)&&i(`/${o} is a board that is starting; pick another route`,2);const a=g(c.sites,o);if(a?.owner?.session)throw f({error:"owned",route:o,owner:a.owner,hint:"a session owns this route: pick another route, or that session leaves it first"}),new I("",3);const b=new Date().toISOString(),m=a?{...a}:{created:b};delete m.watch,delete m.filter;{const S=t?{cmd:t,dir:n||a?.dir||process.cwd(),port:e??(a?.cmd?a.port:void 0)??await H(c)}:e!==void 0?{port:e,...n?{dir:n}:{}}:{dir:n};for(const $ of["cmd","dir","port","cwd","env"])delete m[$];Object.assign(m,S)}return m.title=h,s.description&&(m.description=s.description),X(m),m.updated=b,c.sites={...c.sites,[o]:m},await v(c),m}),r=d.cmd?"cmd":d.port?"port":"files",l=await J();f({route:o,url:V(o),serves:r,...d.port?{port:d.port}:{},...d.dir?{dir:d.dir}:{},...r==="port"?{answering:await we(d.port)}:{},hub:l?"running":"NOT running: run `kickflip doctor --fix`"})}p(Ve,"joinPage");const oe={async doctor(){s["dry-run"]&&!s.fix&&i("--dry-run needs --fix",2);const e=te()&&!s.json?n=>ne(n,"stopped at the prompt; the clones not yet answered are kept"):void 0,{exitCode:t}=await He({fix:!!s.fix,dryRun:!!s["dry-run"],json:!!s.json,ask:e});process.exitCode=t},async join(){if(s._.length&&i(`join takes no route: --name "<name>" gives the title and the route, as in kickflip join --name ${q(s._[0])}`,2),s.title!==void 0&&i('join takes no --title: --name "<name>" gives the title and the route',2),!s.session){const r=["port","dir","cmd"].some(c=>s[c]!==void 0),l=["watch","template","filter","label","model","repo","force","items",...r?["hub"]:[]].find(c=>s[c]!==void 0);return l&&i(`--${l} needs --session <id> (this session's id)`,2),r?Ve():Ye()}const{route:e,title:t}=be(r=>g(k().sites,r));s.template&&s.template!=="board"&&i('--template takes "board"',2),Q(),fe();const n=await O(async()=>{const r=k();g(r.closed,e)&&i("That board is closed; use kickflip reopen "+e,2);const l=new Date().toISOString(),c=g(r.sites,e);if(c?.owner?.session&&c.owner.session!==s.session&&!s.force)throw f({error:"owned",route:e,owner:c.owner,hint:"ask the user, then rerun with --force to take it over"}),new I("",3);s.hub&&s.template!=="board"&&!L({dir:"",cmd:s.cmd?JSON.parse(s.cmd):c?.cmd})&&he(e);const a=c?{...c}:{};let b=!1;if(c||(a.dir=u.resolve(s.dir||u.join(N,"sites",e)),(!w.existsSync(a.dir)||w.readdirSync(a.dir).length===0)&&!s.cmd&&!s.template&&(w.cpSync(u.join(y,"starter"),a.dir,{recursive:!0}),b=!0),a.port=s.port?Number(s.port):await H(r),a.cmd=s.cmd?JSON.parse(s.cmd):[U(),u.join(a.dir,"server.mjs")],a.watch=["data/events.jsonl"],a.created=l),s.dir&&c&&(a.dir=u.resolve(s.dir)),s.port&&c&&(a.port=Number(s.port)),s.cmd&&c&&(a.cmd=JSON.parse(s.cmd)),s.template==="board"){const _=g(r.starting,e),xe=!c&&_?.tickets&&(!_.session||_.session===s.session)?_.tickets:void 0,_e=s.repo?u.resolve(s.repo):G()?.get(s.session)?.cwd||process.cwd();a.cmd=ye(a.dir,{title:t,items:s.items,tickets:xe,repo:_e,ref:_?.branch||"HEAD"}),b=!c}a.title=t,s.description&&(a.description=s.description),typeof s.watch=="string"&&(a.watch=s.watch.split(",").map(_=>_.trim()).filter(Boolean)),s.filter!==void 0&&(a.filter=s.filter||void 0),X(a),Z(r,e,a);const m=c?.owner&&c.owner.session!==s.session?c.owner:null,S=g(r.starting,e)?.session===s.session?g(r.starting,e):null,$=g(r.starting,e);!c&&($?.github||$?.remote)&&(!$.session||$.session===s.session)&&($.github?a.github=$.github:a.remote=$.remote,a.branch=$.branch);const x=c?.owner?.session===s.session?c.owner:null,A=x||S||m;a.owner={...x||{session:s.session,since:l},label:s.label||A?.label||"",repo:s.repo?u.resolve(s.repo):(a.github||a.remote)&&A?.repo||G()?.get(s.session)?.cwd||A?.repo||process.cwd()};const ie=s.model||A?.model;ie&&(a.owner.model=ie);const M=g(r.starting,e);return M&&(r.starting[e]={...M,joined_at:M.joined_at||l}),a.updated=l,r.sites={...r.sites,[e]:a},await v(r),{route:e,created:b,previousOwner:m,site:a}}),o=await J();let h,d;if(s.template==="board"){const r=pe(u.join(n.site.dir,"data","handshake.json"));h=r?.ack&&(r.ping||r.hello)?.session===s.session?"answered before":await me(e),d=o?await Me(e):"not run (the hub is not running)"}f({route:e,url:V(e),dir:n.site.dir,port:n.site.port,owner:n.site.owner,createdFromStarter:n.created,previousOwner:n.previousOwner,log:u.join(le,e+".log"),watcher:Le(e,s.session,y),hub:o?"running":"NOT running: run `kickflip doctor --fix`",...h?{handshake:h}:{},...d?{poll:d}:{}})},async handshake(){const e=s._[0];e||i("handshake needs a route",2),f(await me(e))},async leave(){const e=s._[0];e||i("leave needs a route",2),await O(async()=>{const t=k(),n=g(t.sites,e);if(n||i("no site at /"+e),n.owner?.session&&!s.session&&!s.force&&i("a session owns /"+e+"; leave needs --session <id>, or --force",2),n.owner?.session&&n.owner.session!==s.session&&!s.force)throw f({error:"owned",route:e,owner:n.owner}),new I("",3);delete t.sites[e],await v(t),f({left:e,filesKept:n.dir})})},async start(){const e=s._[0];C(e)||i("start needs a route: lowercase letters, digits and dashes",2);const t=await ee(e,{repo:s.repo,model:s.model,prompt:s.prompt});f({route:t.route,session:t.session,confirmed:t.confirmed,repo:t.repo,argv:t.argv,output:t.output})},async resume(){const e=s._[0];e||i("resume needs a route",2);const{resumeSession:t}=await E();f(await P(()=>t(e,{manifest:k()})))},async close(){const{closeBoard:e}=await import("../hub/close-board.mjs");try{f(await e(s._[0],s.name))}catch(t){i(t.message,t.status?2:1)}},async reopen(){const{reopenBoard:e}=await import("../hub/close-board.mjs");try{f(await P(()=>e(s._[0])))}catch(t){throw t.status&&i(t.message,2),t}},async export(){const e=s._[0];C(e)||i("export needs a route: lowercase letters, digits and dashes",2);const t=u.resolve(s.out||`kickflip-${e}.tgz`);w.existsSync(t)&&i(`${t} already exists; pass another --out`,2);const n=g(k().sites,e)||i("no site at /"+e);L(n)||i(`/${e} is not a board; export moves a board`,2);const o=w.realpathSync(n.dir),{itemSources:h,openBoardBuilders:d}=await import("../board/store.mjs"),r=(await h(o)).find(S=>u.relative(o,S.file).startsWith(".."));r&&i(`/${e}'s cards live outside its folder (${r.file}); export moves only a board whose board.json items is a file in its folder`);const l=await d(o);l.length&&i(`a builder is open on /${e}: ${l.map(S=>`${S.key} (${S.label})`).join(", ")}; export once it is done`);const{readSettingsFile:c}=await import("../hub/push.mjs"),a=B(n,se),b={kickflip_export:1,route:e,exported_at:new Date().toISOString(),from:D.hostname(),entry:a,owner:B(n.owner||{},["label","model"]),settings:B(c(),ve),dropped:Object.keys(n).filter(S=>!se.includes(S))},m=w.mkdtempSync(u.join(D.tmpdir(),"kickflip-export-"));try{const S=u.join(m,R),$=u.join(o,"data");w.cpSync(o,u.join(S,"site"),{recursive:!0,filter:p(x=>!(u.dirname(x)===$&&Xe.test(u.basename(x))),"filter")}),w.writeFileSync(u.join(S,"export.json"),JSON.stringify(b,null,2)+`
+`),w.writeFileSync(u.join(S,"README.md"),Ze(b,u.basename(t))),Oe(["-czf",t,"-C",m,R])}finally{w.rmSync(m,{recursive:!0,force:!0})}f({route:e,file:t,entry:Object.keys(a),dropped:b.dropped,settings:Object.keys(b.settings)})},async import(){s._[0]||i("import needs the file kickflip export wrote",2);const e=u.resolve(s._[0]);w.existsSync(e)||i(`no file at ${e}`,2),w.mkdirSync(N,{recursive:!0});const t=w.mkdtempSync(u.join(N,".import-"));try{Oe(["-xzf",e,"-C",t]);const n=pe(u.join(t,R,"export.json"));(n?.kickflip_export!==1||!C(n.route)||!ge(u.join(t,R,"site")))&&i(`${e} is not a kickflip export`,2);const{route:o}=n,h=u.join(N,"sites",o),d=await O(async()=>{const a=k();(g(a.sites,o)||g(a.closed,o)||g(a.starting,o))&&i(`/${o} already exists on this host; import never replaces a board`),w.existsSync(h)&&i(`${h} already exists; import never replaces a board's folder`);const b=B(n.entry||{},se);b.hub&&Object.values(a.sites).some(S=>S?.hub)&&delete b.hub;const m={...b,dir:h,port:await H(a),cmd:[U(),u.join(y,"board","server.mjs"),h],updated:new Date().toISOString()};return w.mkdirSync(u.dirname(h),{recursive:!0}),w.renameSync(u.join(t,R,"site"),h),a.sites={...a.sites,[o]:m},await v(a),m}),r=B(n.settings||{},ve);if(Object.keys(r).length){const{readSettingsFile:a,writeSettingsFile:b}=await import("../hub/push.mjs");b({...a(),...r})}const{label:l,model:c}=n.owner||{};f({route:o,dir:h,port:d.port,settings:Object.keys(r),hub:d.hub===!0,join:`kickflip join --name ${q(Fe(o,d.title))} --session <this session's id> --watch --template board${l?` --label ${q(l)}`:""}${c?` --model ${q(c)}`:""} --force`})}finally{w.rmSync(t,{recursive:!0,force:!0})}},async sessions(){const{sessionOf:e}=await E(),{listBoards:t}=await import(u.join(y,"hub","boards.mjs")),n=k(),o=G(),d=[...t(n).map(r=>r.route),...Object.keys(n.starting||{}).filter(r=>!g(n.sites,r))].map(r=>{const l=e(n,r),c=l&&o?.get(l.session),a=l?o?c?c.kind==="bg"?"background":"terminal":null:"unknown":null;return{route:r,session:l?.session||null,live:a,repo:l?.repo||null,starting:!g(n.sites,r)}});if(s.json)return f(d);if(!d.length)return f("no boards");for(const r of d)f(`/${r.route}  ${r.session||"no session"}  ${r.live==="unknown"?"live unknown (ps gave no answer)":r.live?`live (${r.live})`:"not live"}  ${r.repo||"no folder"}${r.starting?"  (starting: not joined yet)":""}`)},async hub(){await z(s.repo)},async set(){const e=s._[0];e||i("set needs a route",2),s.icon===void 0&&s.color===void 0&&!s.hub&&!s["no-hub"]&&i("set needs --icon, --color, --hub or --no-hub",2),Q(),fe(),await O(async()=>{const t=k(),n=g(t.sites,e)||i("no site at /"+e);X(n),Z(t,e,n),n.updated=new Date().toISOString(),await v(t),f({route:e,icon:n.icon??null,color:n.color??null,hub:n.hub===!0})})},async restart(){const e=s._[0];if(!e)return $e("the hub did not restart");await O(async()=>{const t=k();g(t.sites,e)||i("no site at /"+e),t.sites[e].restart_at=Date.now(),await v(t)}),f(`restarting /${e}; the hub picks it up within 2 seconds`)},async url(){const e=s._[0];e&&!g(k().sites,e)&&i("no site at /"+e,2);try{f(Pe(e))}catch(t){i(t.message)}},async logs(){const e=s._[0],t=u.join(le,e+".log");w.existsSync(t)||i("no log yet for /"+e);const n=Number(s.lines||40);f(w.readFileSync(t,"utf8").split(`
 `).slice(-n-1).join(`
-`))},async init(){s.fix=!0,await oe.doctor()},async update(){w.existsSync(d.join(j,".git"))&&i(`${j} is a clone; update it with git pull`,2);const e=h(()=>JSON.parse(w.readFileSync(d.join(j,"package.json"),"utf8")).version,"installedVersion"),t=e(),n=K("npm",["i","-g","@lovek4d/kickflip@latest"],{stdio:"inherit"});n.status!==0&&i(`npm update failed${n.error?": "+n.error.message:""}`);const o=e();if(o===t)return f("no new version available");f(`${t} > ${o}`),!s["no-restart"]&&$e("update finished but the hub did not restart")},async uninstall(){Ae()&&f(`removed ${d.join(D.homedir(),".claude","statusline.sh")}`);const e=de();e.remove();const t=ue();if(t)try{ae(t,["serve","--https=443","--set-path=/","off"],{stdio:"ignore"})}catch{}f(`hub stopped and removed from ${e.manager??"the host"}${t?"; tailscale / unmapped":""}. The manifest and sites are kept in ${N}`)},async push(){const{deliver:e,pushKindError:t}=await import(d.join(j,"hub","push.mjs")),n=t(s.kind);n&&i(n,2),s.title||i("push needs --title",2),s.url&&!s.url.startsWith("/")&&i("--url is a path on the hub, such as /<route>/page.html",2);const{sendWords:o,holdLine:p}=await import(d.join(j,"hub","schedule.mjs"));s.now&&s.urgent&&i("pass --now or --urgent, not both",2);const l=await e({title:s.title,body:s.body||"",url:s.url||"/",tag:s.tag},{kind:s.kind,urgent:!!s.urgent,immediate:!!s.now});if(l.noDevice&&i("no device has turned on notifications; open Hub \u2192 Notifications (/_hub/#notifications) in the Home Screen app and tap Turn on",3),l.dropped)return f("dropped (notifications are off on the Hub page)");if(l.queued){const{count:r,replaced:u,nextFlushAt:c,hold:a,sendFailed:b}=l.queued,m=s.now?a?`${p(a)}; `:b?"no device took it now; ":"":"";f(`queued (${m}${r} in queue${u?"; replaced the queued push with this tag":""}); next send ${o(c)}${c instanceof Date?` (${c.toISOString()})`:""}`),await J()||f("warning: the hub is not running, so the queue goes out only once it runs");return}f(l.sent),l.sent.some(r=>r.status>=200&&r.status<300)||i("every push was refused",1),f(s.urgent?"sent (urgent)":"sent")},async quiet(){const{readSettings:e}=await import(d.join(j,"hub","push.mjs")),{hold:t}=await import(d.join(j,"hub","schedule.mjs")),n=e(),o=t(new Date,n);f({quiet:n.quiet,held:o!==null,held_until:o?o.until instanceof Date?o.until.toISOString():o.until:null,held_why:o?.why??null,notifications:n.notifications})},async notifications(){const{setNotifications:e,readSettings:t}=await import(d.join(j,"hub","push.mjs")),[n,o]=s._,l=n===void 0?null:n==="on"||n==="off"?{on:n==="on"}:n==="weekends"?{weekends_off:h((u,c)=>u==="on"?!0:u==="off"?!1:i(`${c} takes on or off`,2),"onOff")(o,"weekends")}:n==="snooze"?{snooze:o||i("snooze takes a length: <n>m, <n>h, <n>d, <n>w, tonight, morning, monday, forever or a date and time",2)}:n==="unsnooze"?{snooze:"off"}:i("notifications takes on, off, snooze <length>, unsnooze, or weekends on|off",2);if(!l)return f(t().notifications);let r;try{r=await e(l)}catch(u){throw u.status===400&&i(u.message,2),u}f(r.dropped?{...r.notifications,dropped:r.dropped}:r.notifications)},async"codex-share"(){(S.length>1||S.length&&s._.length!==1)&&i("codex-share takes auto, always, or off",2);const{readCodexShare:t,setCodexShare:n}=await import(d.join(j,"hub","push.mjs"));if(!S.length)return f(t());try{f(n(S[0]))}catch(o){throw o.status===400&&i(o.message,2),o.status===409&&i(o.message),o}},async"usage-gate"(){const{readUsageGate:e,setPauseAt:t,setKeepGoing:n}=await import("../shared/usage-gate.mjs");try{S.length&&(S[0]==="pause-at"&&S.length===2?t(S[1]):S[0]==="keep-going"&&S.length===1?n("on"):S[0]==="stop"&&S.length===1?n("off"):i("usage-gate takes pause-at <50..100>, keep-going, or stop",2)),f(e())}catch(o){throw o.status&&i(o.message,o.status===400?2:1),o}},async audit(){S.length&&i("audit takes no arguments",2);const{readAudit:e,auditLines:t,hubAudit:n}=await import("../shared/audit.mjs");f(t(e(n())).join(`
+`))},async init(){s.fix=!0,await oe.doctor()},async update(){w.existsSync(u.join(y,".git"))&&i(`${y} is a clone; update it with git pull`,2);const e=p(()=>JSON.parse(w.readFileSync(u.join(y,"package.json"),"utf8")).version,"installedVersion"),t=e(),n=["lib","node_modules","@lovek4d","kickflip"],o=y.split(u.sep);n.some((l,c)=>o.at(c-n.length)!==l)&&i(`${y} is not under <prefix>/${n.join("/")}, so the npm prefix that owns it is unknown`);const h=u.resolve(y,...n.map(()=>"..")),d=K("npm",["i","-g","--prefix",h,"@lovek4d/kickflip@latest"],{stdio:"inherit"});d.status!==0&&i(`npm update failed${d.error?": "+d.error.message:""}`);const r=e();if(r===t)return f("no new version available");f(`${t} > ${r}`),!s["no-restart"]&&$e("update finished but the hub did not restart")},async uninstall(){Ae()&&f(`removed ${u.join(D.homedir(),".claude","statusline.sh")}`);const e=de();e.remove();const t=ue();if(t)try{ae(t,["serve","--https=443","--set-path=/","off"],{stdio:"ignore"})}catch{}f(`hub stopped and removed from ${e.manager??"the host"}${t?"; tailscale / unmapped":""}. The manifest and sites are kept in ${N}`)},async push(){const{deliver:e,pushKindError:t}=await import(u.join(y,"hub","push.mjs")),n=t(s.kind);n&&i(n,2),s.title||i("push needs --title",2),s.url&&!s.url.startsWith("/")&&i("--url is a path on the hub, such as /<route>/page.html",2);const{sendWords:o,holdLine:h}=await import(u.join(y,"hub","schedule.mjs"));s.now&&s.urgent&&i("pass --now or --urgent, not both",2);const d=await e({title:s.title,body:s.body||"",url:s.url||"/",tag:s.tag},{kind:s.kind,urgent:!!s.urgent,immediate:!!s.now});if(d.noDevice&&i("no device has turned on notifications; open Hub \u2192 Notifications (/_hub/#notifications) in the Home Screen app and tap Turn on",3),d.dropped)return f("dropped (notifications are off on the Hub page)");if(d.queued){const{count:r,replaced:l,nextFlushAt:c,hold:a,sendFailed:b}=d.queued,m=s.now?a?`${h(a)}; `:b?"no device took it now; ":"":"";f(`queued (${m}${r} in queue${l?"; replaced the queued push with this tag":""}); next send ${o(c)}${c instanceof Date?` (${c.toISOString()})`:""}`),await J()||f("warning: the hub is not running, so the queue goes out only once it runs");return}f(d.sent),d.sent.some(r=>r.status>=200&&r.status<300)||i("every push was refused",1),f(s.urgent?"sent (urgent)":"sent")},async quiet(){const{readSettings:e}=await import(u.join(y,"hub","push.mjs")),{hold:t}=await import(u.join(y,"hub","schedule.mjs")),n=e(),o=t(new Date,n);f({quiet:n.quiet,held:o!==null,held_until:o?o.until instanceof Date?o.until.toISOString():o.until:null,held_why:o?.why??null,notifications:n.notifications})},async notifications(){const{setNotifications:e,readSettings:t}=await import(u.join(y,"hub","push.mjs")),[n,o]=s._,d=n===void 0?null:n==="on"||n==="off"?{on:n==="on"}:n==="weekends"?{weekends_off:p((l,c)=>l==="on"?!0:l==="off"?!1:i(`${c} takes on or off`,2),"onOff")(o,"weekends")}:n==="snooze"?{snooze:o||i("snooze takes a length: <n>m, <n>h, <n>d, <n>w, tonight, morning, monday, forever or a date and time",2)}:n==="unsnooze"?{snooze:"off"}:i("notifications takes on, off, snooze <length>, unsnooze, or weekends on|off",2);if(!d)return f(t().notifications);let r;try{r=await e(d)}catch(l){throw l.status===400&&i(l.message,2),l}f(r.dropped?{...r.notifications,dropped:r.dropped}:r.notifications)},async"codex-share"(){(j.length>1||j.length&&s._.length!==1)&&i("codex-share takes auto, always, or off",2);const{readCodexShare:t,setCodexShare:n}=await import(u.join(y,"hub","push.mjs"));if(!j.length)return f(t());try{f(n(j[0]))}catch(o){throw o.status===400&&i(o.message,2),o.status===409&&i(o.message),o}},async"usage-gate"(){const{readUsageGate:e,setPauseAt:t,setKeepGoing:n}=await import("../shared/usage-gate.mjs");try{j.length&&(j[0]==="pause-at"&&j.length===2?t(j[1]):j[0]==="keep-going"&&j.length===1?n("on"):j[0]==="stop"&&j.length===1?n("off"):i("usage-gate takes pause-at <50..100>, keep-going, or stop",2)),f(e())}catch(o){throw o.status&&i(o.message,o.status===400?2:1),o}},async audit(){j.length&&i("audit takes no arguments",2);const{readAudit:e,auditLines:t,hubAudit:n}=await import("../shared/audit.mjs");f(t(e(n())).join(`
 `))},async"poll-now"(){let e;try{e=await fetch(`http://127.0.0.1:${T}/_hub/poll`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({flush:!s["keep-queue"]}),signal:AbortSignal.timeout(10*6e4)})}catch(t){i("the hub is not running: "+t.message)}e.ok||i(`the hub answered ${e.status}: ${(await e.text()).slice(0,200)}`),f(await e.json())}};if(!oe[Y]){const e=w.readFileSync(Ie(import.meta.url),"utf8").split(`
 `).slice(1);f(e.slice(0,e.findIndex(t=>!t.startsWith("//"))).map(t=>t.replace(/^\/\/ ?/,"")).join(`
 `)),process.exit(Y?2:0)}try{await oe[Y]()}catch(e){if(!(e instanceof I))throw e;e.message&&console.error("kickflip: "+e.message),process.exit(e.code)}

package/bin/wait-events.mjs

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-var _=Object.defineProperty;var t=(e,i)=>_(e,"name",{value:i,configurable:!0});import u from"node:fs";import h from"node:path";import K from"node:os";import{routeRecord as g}from"../hub/routes.mjs";import{readHubRules as C,rulesOf as Q,ruleLines as M}from"../hub/rules.mjs";import{boardAt as Y,linksOf as z,hubLink as V,stopPreviousWatcher as X}from"../hub/boards.mjs";import{parentOf as R,sessionGone as Z}from"../hub/live.mjs";import{ackPing as ee,cardName as te,markWorking as ne,settingsLines as se,settingsOf as ie,WORKING_KINDS as re}from"../board/store.mjs";import{readUsageGate as A,heldUsageEvent as oe,pausedLine as ae}from"../shared/usage-gate.mjs";import{intakeKeyOf as de,waitsAgainLine as ce}from"../board/domain.mjs";const[j,$]=process.argv.slice(2);(!j||!$)&&(console.error("usage: wait-events.mjs <route> <session-id>"),process.exit(2));const le=h.join(K.homedir(),".claude","kickflip","manifest.json");function I(){try{return g(JSON.parse(u.readFileSync(le,"utf8")).sites,j)||null}catch{return}}t(I,"site");function S(e){const i=e.filter?new RegExp(e.filter):null,n=Object.create(null);for(const c of e.watch||["data/events.jsonl"]){let l=[];try{l=u.readFileSync(h.resolve(e.dir,c),"utf8").split(`
-`).filter(Boolean)}catch{}n[c]=i?l.filter(b=>i.test(b)):l}return n}t(S,"matching");const ue=`quiet The owner doesn't read this session's terminal. Answer a prompt typed in it in full. A wake, a task notification or a builder's result is not one: write no text of your own, since board.mjs and this watcher print one line for each thing done. Talk and questions go on the board, never AskUserQuestion; only a failure the board can't show, such as the hub being down, gets one line here. Each message to the owner stands alone in its card's thread: name cards by label (#96), and a pointer such as "above" or "here" must make sense in that thread, never point into this session.`,fe=["main-pulled","settings","ask-done","reviewers-removed","reviewers-added","question-reopen","repo-changed","ping","hello","card-hold","card-done","card-unbump","card-unblocked","grill-more","prototype-request","visual-request"],P=t(e=>{try{return JSON.parse(e)}catch{return null}},"parsed"),pe=t((e,i)=>{const n=P(e);return fe.includes(n?.kind)||!!i&&n!==null&&(n.kind==="intake-handoff"||de(n)!==null)},"recordOnly");function N(e){try{return JSON.parse(u.readFileSync(h.resolve(e.dir,"board.json"),"utf8"))}catch(i){return i.code==="ENOENT"?null:{}}}t(N,"boardOf");async function T(e,i){for(const n of i){let c;try{c=JSON.parse(n)}catch{continue}(c.kind==="ping"||c.kind==="hello")&&typeof c.id=="string"&&await ee(e,c.id).catch(l=>console.log(`ping ${c.id} not answered (${l.message})`))}}t(T,"ackPings");const D={ask:t(e=>`new task ${e.id} received: intake triage sorts it`,"ask"),"owner-answer":t(e=>`answer received to question ${e.data?.id}`,"owner-answer"),ping:t(e=>`ping ${e.id} from the hub answered`,"ping"),hello:t(e=>`ping ${e.id} from the hub answered`,"hello"),"overnight-triage":t(e=>`Overnight triage ${e.data?.date} asked: ${e.data?.cards?.length} cards wait on your answers`,"overnight-triage"),"pr-review":t(e=>`review asked on PR #${e.data?.pr}: the board was idle`,"pr-review"),"orchestrator-waits":t(e=>[e.data?.added?.length&&`waiting on you now: ${e.data.added.join(", ")}`,e.data?.again?.length&&ce(e.data.again,Date.parse(e.ts))].filter(Boolean).join(" \xB7 "),"orchestrator-waits"),"review-answer":t(e=>`${e.data?.answer==="skip"?"skip":"post"} answered on the review of PR #${e.data?.pr}`,"review-answer")},W={"item-message":t((e,i)=>String(i.data?.key).startsWith("ask:")?`message received from ${e}'s thread: intake triage answers it`:i.data?.intent==="build"?`Implement asked on ${e}: it is staging, the message in its notes; judge it, then item set --state ready, or --state grilling or prototyping`:`message received from ${e}'s thread`,"item-message"),"card-merge":t(e=>`merge asked on ${e}`,"card-merge"),"card-done":t(e=>`${e} marked done`,"card-done"),"card-bump":t(e=>`${e} bumped`,"card-bump"),"ask-bump":t(e=>`${e} bumped`,"ask-bump"),"ask-edited":t(e=>`${e} edited`,"ask-edited"),"ask-done":t(e=>`${e} marked done`,"ask-done"),"ask-withdrawn":t(e=>`${e} deleted`,"ask-withdrawn"),"card-hold":t((e,i)=>`${e} ${i.data?.hold?"held":"resumed"}`,"card-hold"),"card-unblocked":t(e=>`${e} unblocked`,"card-unblocked"),"prototype-request":t(e=>`prototype asked on ${e}`,"prototype-request"),"visual-request":t(e=>`visual asked on ${e}: the board launches its visual agent`,"visual-request"),"reask-request":t(e=>`question asked again on ${e}`,"reask-request"),"builder-ask":t((e,i)=>`${i.data?.ask} from ${e}'s builder: ${i.data?.text}`,"builder-ask"),"owner-check-broken":t((e,i)=>`${e}'s owner-step check can't run: ${i.data?.error}`,"owner-check-broken"),"card-added":t(e=>`${e} added by an agent: intake triage links and files it`,"card-added"),"intake-handoff":t((e,i)=>`intake triage handed ${e} to you: ${i.data?.text}`,"intake-handoff")};async function ge(e,i){let n;try{n=JSON.parse(i)}catch{return null}if(typeof n?.kind!="string")return null;const c=typeof n.data?.key=="string"?n.data.key:n.kind.startsWith("ask-")&&typeof n.data?.id=="string"?`ask:${n.data.id}`:null,l=c&&await te(e,c).catch(()=>c);return g(D,n.kind)?D[n.kind](n):l&&g(W,n.kind)?W[n.kind](l,n):l?`${n.kind} on ${l}`:`${n.kind} received`}t(ge,"plainLine");function he(e){let i=[];try{i=JSON.parse(u.readFileSync(h.resolve(e,"data","orchestrator-waits.json"),"utf8")).waits||[]}catch{}return i.map(n=>`waits ${n.kind} ${n.ref} ${n.key} since ${n.since}${n.picked?`, picked up ${n.picked}`:""}: ${n.next}`)}t(he,"waitLines");const y=I();y||(console.log("site-removed"),process.exit(0));const m=h.resolve(y.dir,"data",`.watch-cursor-${$}.json`),q=h.resolve(y.dir,"data","watcher.json"),E=[process.ppid,R(process.ppid)],B=t(()=>{E[1]??=R(E[0]),Z($,E)&&process.exit(0)},"orphaned");X(y.dir,j,$);try{u.mkdirSync(h.dirname(m),{recursive:!0}),u.writeFileSync(q,JSON.stringify({pid:process.pid,since:new Date().toISOString()}))}catch{}process.on("exit",()=>{try{const e=JSON.parse(u.readFileSync(q,"utf8"));e.pid===process.pid&&u.writeFileSync(q,JSON.stringify({...e,exited_at:new Date().toISOString()}))}catch{}});let d;try{d=JSON.parse(u.readFileSync(m,"utf8"))}catch{}for(d||(d=Object.fromEntries(Object.entries(S(y)).map(([e,i])=>[e,i.length])),u.mkdirSync(h.dirname(m),{recursive:!0}),u.writeFileSync(m,JSON.stringify(d)));;){await new Promise(s=>setTimeout(s,2e3));const e=I();if(e===void 0)continue;e===null&&(console.log("site-removed"),process.exit(0)),e.owner?.session&&e.owner.session!==$&&(console.log("handed-over "+JSON.stringify(e.owner)),process.exit(0)),B();const i=t(s=>Object.fromEntries(Object.entries(s).map(([o,r])=>[o,[...g(d.$quietHeld,o)||[],...g(d.$usageHeld,o)||[],...r.slice(g(d,o)||0)]])),"pending"),n=t((s,o)=>o.state!=="paused"||!oe(s),"eligible"),c=N(e)!==null,l=t(s=>pe(s,c),"quiet"),b=t((s,o)=>Object.values(s).some(r=>r.some(a=>n(a,o)&&!l(a))),"wakes"),G=A({dir:e.dir}),k=S(e);if(!b(i(k),G)){const s=Object.fromEntries(Object.entries(k).map(([r,a])=>[r,a.slice(g(d,r)||0).filter(l)])),o=Object.fromEntries(Object.entries(k).map(([r,a])=>[r,a.slice(g(d,r)||0).filter(f=>!l(f))]));if(Object.values(s).some(r=>r.length)){N(e)&&await T(e.dir,Object.values(s).flat());const r=t((a,f)=>Object.fromEntries(Object.keys(k).map(v=>[v,[...g(a,v)||[],...f[v]]])),"append");d={...Object.fromEntries(Object.entries(k).map(([a,f])=>[a,f.length])),$quietHeld:r(d.$quietHeld,s),$usageHeld:r(d.$usageHeld,o)},Object.values(d.$usageHeld).some(a=>a.length)||delete d.$usageHeld,u.writeFileSync(m,JSON.stringify(d))}continue}await new Promise(s=>setTimeout(s,2e3)),B();const x=S(e),w=A({dir:e.dir}),F=i(x);if(!b(F,w))continue;const O=Object.create(null),J=[],U=new Set(Object.values(d.$quietHeld||{}).flat()),H=[];for(const[s,o]of Object.entries(F)){O[s]=o.filter(r=>!n(r,w));for(const r of o.filter(a=>n(a,w))){U.has(r)||H.push(r),console.log(`event ${s} ${r}`);const a=await ge(e.dir,r);a&&console.log(a);const f=P(r);f&&re.includes(f.kind)&&typeof f.id=="string"&&!l(r)&&J.push(f.id)}}const p=N(e);if(p&&await ne(e.dir,J).catch(s=>console.log(`working marks not written (${s.message})`)),p&&await T(e.dir,H),p)for(const s of he(e.dir))console.log(s);if(p)for(const s of M(C(),Q(p)))console.log(`rule ${s}`);if(p)for(const s of se(ie(p)))console.log(s);p&&console.log(ue),w.state==="paused"&&console.log(ae(w));try{const s=p&&Y(e.dir);if(s)for(const o of[...z(s,{listen:"listening"}),V()])o.ok||console.log(`link ${o.link} ${o.detail}`)}catch(s){console.log(`link registry could not check the links (${s.message})`)}const L=Object.fromEntries(Object.entries(x).map(([s,o])=>[s,o.length]));Object.values(O).some(s=>s.length)&&(L.$usageHeld=O),u.writeFileSync(m,JSON.stringify(L)),process.exit(0)}
+var W=Object.defineProperty;var l=(e,r)=>W(e,"name",{value:r,configurable:!0});import d from"node:fs";import g from"node:path";import _ from"node:os";import{routeRecord as m}from"../hub/routes.mjs";import{readHubRules as K,rulesOf as Q,ruleLines as B}from"../hub/rules.mjs";import{boardAt as C,linksOf as M,hubLink as z,stopPreviousWatcher as V}from"../hub/boards.mjs";import{parentOf as I,sessionGone as X}from"../hub/live.mjs";import{ackPing as Y,cardName as Z,markWorking as ee,settingsLines as te,settingsOf as ne,WORKING_KINDS as ie}from"../board/store.mjs";import{readUsageGate as L,heldUsageEvent as se,pausedLine as re}from"../shared/usage-gate.mjs";import{recordOnly as j,PLAIN as T,ON_CARD as q}from"./event-lines.mjs";const[$,k]=process.argv.slice(2);(!$||!k)&&(console.error("usage: wait-events.mjs <route> <session-id>"),process.exit(2));const oe=g.join(_.homedir(),".claude","kickflip","manifest.json");function P(){try{return m(JSON.parse(d.readFileSync(oe,"utf8")).sites,$)||null}catch{return}}l(P,"site");function v(e){const r=e.filter?new RegExp(e.filter):null,t=Object.create(null);for(const c of e.watch||["data/events.jsonl"]){let f=[];try{f=d.readFileSync(g.resolve(e.dir,c),"utf8").split(`
+`).filter(Boolean)}catch{}t[c]=r?f.filter(h=>r.test(h)):f}return t}l(v,"matching");const ce=`quiet The owner doesn't read this session's terminal. Answer a prompt typed in it in full. A wake, a task notification or a builder's result is not one: write no text of your own, since board.mjs and this watcher print one line for each thing done. Talk and questions go on the board, never AskUserQuestion; only a failure the board can't show, such as the hub being down, gets one line here. Each message to the owner stands alone in its card's thread: name cards by label (#96), and a pointer such as "above" or "here" must make sense in that thread, never point into this session.`,ae=l(e=>{try{return JSON.parse(e)}catch{return null}},"parsed");function R(e){try{return JSON.parse(d.readFileSync(g.resolve(e.dir,"board.json"),"utf8"))}catch(r){return r.code==="ENOENT"?null:{}}}l(R,"boardOf");async function D(e,r){for(const t of r){let c;try{c=JSON.parse(t)}catch{continue}(c.kind==="ping"||c.kind==="hello")&&typeof c.id=="string"&&await Y(e,c.id).catch(f=>console.log(`ping ${c.id} not answered (${f.message})`))}}l(D,"ackPings");async function le(e,r){let t;try{t=JSON.parse(r)}catch{return null}if(typeof t?.kind!="string")return null;const c=typeof t.data?.key=="string"?t.data.key:t.kind.startsWith("ask-")&&typeof t.data?.id=="string"?`ask:${t.data.id}`:null,f=c&&await Z(e,c).catch(()=>c);return m(T,t.kind)?T[t.kind](t):f&&m(q,t.kind)?q[t.kind](f,t):f?`${t.kind} on ${f}`:`${t.kind} received`}l(le,"plainLine");function de(e){let r=[];try{r=JSON.parse(d.readFileSync(g.resolve(e,"data","orchestrator-waits.json"),"utf8")).waits||[]}catch{}return r.map(t=>`waits ${t.kind} ${t.ref} ${t.key}${t.bumpedAt?" bumped":""} since ${t.since}${t.picked?`, picked up ${t.picked}`:""}: ${t.next}`)}l(de,"waitLines");const b=P();b||(console.log("site-removed"),process.exit(0));const y=g.resolve(b.dir,"data",`.watch-cursor-${k}.json`),N=g.resolve(b.dir,"data","watcher.json"),E=[process.ppid,I(process.ppid)],G=l(()=>{E[1]??=I(E[0]),X(k,E)&&process.exit(0)},"orphaned");V(b.dir,$,k);try{d.mkdirSync(g.dirname(y),{recursive:!0}),d.writeFileSync(N,JSON.stringify({pid:process.pid,since:new Date().toISOString()}))}catch{}process.on("exit",()=>{try{const e=JSON.parse(d.readFileSync(N,"utf8"));e.pid===process.pid&&d.writeFileSync(N,JSON.stringify({...e,exited_at:new Date().toISOString()}))}catch{}});let a;try{a=JSON.parse(d.readFileSync(y,"utf8"))}catch{}for(a||(a=Object.fromEntries(Object.entries(v(b)).map(([e,r])=>[e,r.length])),d.mkdirSync(g.dirname(y),{recursive:!0}),d.writeFileSync(y,JSON.stringify(a)));;){await new Promise(n=>setTimeout(n,2e3));const e=P();if(e===void 0)continue;e===null&&(console.log("site-removed"),process.exit(0)),e.owner?.session&&e.owner.session!==k&&(console.log("handed-over "+JSON.stringify(e.owner)),process.exit(0)),G();const r=l(n=>Object.fromEntries(Object.entries(n).map(([s,i])=>[s,[...m(a.$quietHeld,s)||[],...m(a.$usageHeld,s)||[],...i.slice(m(a,s)||0)]])),"pending"),t=l((n,s)=>s.state!=="paused"||!se(n),"eligible"),c=l((n,s)=>Object.values(n).some(i=>i.some(o=>t(o,s)&&!j(o))),"wakes"),f=L({dir:e.dir}),h=v(e);if(!c(r(h),f)){const n=Object.fromEntries(Object.entries(h).map(([i,o])=>[i,o.slice(m(a,i)||0).filter(j)])),s=Object.fromEntries(Object.entries(h).map(([i,o])=>[i,o.slice(m(a,i)||0).filter(u=>!j(u))]));if(Object.values(n).some(i=>i.length)){R(e)&&await D(e.dir,Object.values(n).flat());const i=l((o,u)=>Object.fromEntries(Object.keys(h).map(S=>[S,[...m(o,S)||[],...u[S]]])),"append");a={...Object.fromEntries(Object.entries(h).map(([o,u])=>[o,u.length])),$quietHeld:i(a.$quietHeld,n),$usageHeld:i(a.$usageHeld,s)},Object.values(a.$usageHeld).some(o=>o.length)||delete a.$usageHeld,d.writeFileSync(y,JSON.stringify(a))}continue}await new Promise(n=>setTimeout(n,2e3)),G();const F=v(e),O=L({dir:e.dir}),J=r(F);if(!c(J,O))continue;const w=Object.create(null),x=[],U=new Set(Object.values(a.$quietHeld||{}).flat()),H=[];for(const[n,s]of Object.entries(J)){w[n]=s.filter(i=>!t(i,O));for(const i of s.filter(o=>t(o,O))){U.has(i)||H.push(i),console.log(`event ${n} ${i}`);const o=await le(e.dir,i);o&&console.log(o);const u=ae(i);u&&ie.includes(u.kind)&&typeof u.id=="string"&&x.push(u.id)}}const p=R(e);if(p&&await ee(e.dir,x).catch(n=>console.log(`working marks not written (${n.message})`)),p&&await D(e.dir,H),p)for(const n of de(e.dir))console.log(n);if(p)for(const n of B(K(),Q(p)))console.log(`rule ${n}`);if(p)for(const n of te(ne(p)))console.log(n);p&&console.log(ce),O.state==="paused"&&console.log(re(O));try{const n=p&&C(e.dir);if(n)for(const s of[...M(n,{listen:"listening"}),z()])s.ok||console.log(`link ${s.link} ${s.detail}`)}catch(n){console.log(`link registry could not check the links (${n.message})`)}const A=Object.fromEntries(Object.entries(F).map(([n,s])=>[n,s.length]));Object.values(w).some(n=>n.length)&&(A.$usageHeld=w),d.writeFileSync(y,JSON.stringify(A)),process.exit(0)}

package/board/agents.mjs

@@ -1,2 +1,2 @@
-var v=Object.defineProperty;var t=(e,n)=>v(e,"name",{value:n,configurable:!0});import u from"node:fs";import y from"node:path";import{spawn as w,execFileSync as h}from"node:child_process";import{claudeBin as _,inherited as I}from"../hub/sessions.mjs";function A(e){try{return y.resolve(e,h("git",["-C",e,"rev-parse","--git-common-dir"],{encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim())}catch{return null}}t(A,"gitCommonDir");const O={claude:{bin:_,args:t(({prompt:e,model:n="opus"})=>["-p",e,"--permission-mode","auto","--model",n,"--output-format","stream-json","--verbose"],"args"),session:t(e=>{try{const n=JSON.parse(e);return n.type==="system"&&n.subtype==="init"?n.session_id??null:null}catch{return null}},"session")},codex:{bin:t(()=>process.env.KICKFLIP_CODEX||"codex","bin"),args:t(({prompt:e,cwd:n,site:c})=>["exec","--color","never","--cd",n,"--sandbox","workspace-write",...[c,A(n)].filter(Boolean).flatMap(l=>["--add-dir",l]),"-c","sandbox_workspace_write.network_access=true",e],"args"),session:t(e=>e.match(/^session id: (\S+)/)?.[1]??null,"session")}},P=15e3;function T(e,n,c,l){return new Promise(b=>{let o=!1;const f=t(i=>{o||(o=!0,clearInterval(m),clearTimeout(r),e.off("exit",S),b(i))},"finish"),s=t(()=>{const i=u.readFileSync(n,"utf8").slice(c);for(const d of i.split(`
-`)){const x=l(d);if(x)return f(x)}},"scan"),m=setInterval(s,100),r=setTimeout(()=>f(null),P),S=t(()=>{s(),f(null)},"exited");e.once("exit",S)})}t(T,"sessionOf");function N({kind:e,model:n,cwd:c,site:l,prompt:b,log:o,bin:f}){const s=O[e];if(!s)throw new Error(`no agent of kind ${e}`);const m=f??s.bin();u.mkdirSync(y.dirname(o),{recursive:!0});const r=u.openSync(o,"a"),S=u.fstatSync(r).size,i=Object.fromEntries(Object.entries(process.env).filter(([d])=>!I(d)));return y.isAbsolute(m)&&(i.PATH=`${y.dirname(m)}:${i.PATH||""}`),new Promise((d,x)=>{const a=w(m,s.args({prompt:b,model:n,cwd:c,site:l}),{cwd:c,env:i,detached:!0,stdio:["ignore",r,r]}),g=new Promise(p=>a.once("exit",()=>p()));a.once("spawn",async()=>{u.closeSync(r);const p=await T(a,o,S,s.session);a.unref(),d({pid:a.pid,sessionId:p,log:o,exited:g})}),a.once("error",p=>{u.closeSync(r),x(p)})})}t(N,"launchAgent");export{N as launchAgent};
+var v=Object.defineProperty;var t=(e,n)=>v(e,"name",{value:n,configurable:!0});import a from"node:fs";import y from"node:path";import{spawn as h,execFileSync as w}from"node:child_process";import{claudeBin as _,inherited as I}from"../hub/sessions.mjs";function A(e){try{return y.resolve(e,w("git",["-C",e,"rev-parse","--git-common-dir"],{encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim())}catch{return null}}t(A,"gitCommonDir");const O={claude:{bin:_,args:t(({prompt:e,model:n="opus",resume:o})=>[...o?["--resume",o]:[],"-p",e,"--permission-mode","auto","--model",n,"--output-format","stream-json","--verbose"],"args"),session:t(e=>{try{const n=JSON.parse(e);return n.type==="system"&&n.subtype==="init"?n.session_id??null:null}catch{return null}},"session")},codex:{bin:t(()=>process.env.KICKFLIP_CODEX||"codex","bin"),args:t(({prompt:e,cwd:n,site:o})=>["exec","--color","never","--cd",n,"--sandbox","workspace-write",...[o,A(n)].filter(Boolean).flatMap(u=>["--add-dir",u]),"-c","sandbox_workspace_write.network_access=true",e],"args"),session:t(e=>e.match(/^session id: (\S+)/)?.[1]??null,"session")}},T=15e3;function E(e,n,o,u){return new Promise(x=>{let r=!1;const l=t(m=>{r||(r=!0,clearInterval(i),clearTimeout(f),e.off("exit",s),x(m))},"finish"),S=t(()=>{const m=a.readFileSync(n,"utf8").slice(o);for(const d of m.split(`
+`)){const c=u(d);if(c)return l(c)}},"scan"),i=setInterval(S,100),f=setTimeout(()=>l(null),T),s=t(()=>{S(),l(null)},"exited");e.once("exit",s)})}t(E,"sessionOf");function N({kind:e,model:n,cwd:o,site:u,prompt:x,log:r,bin:l,resume:S}){const i=O[e];if(!i)throw new Error(`no agent of kind ${e}`);const f=l??i.bin();a.mkdirSync(y.dirname(r),{recursive:!0});const s=a.openSync(r,"a"),m=a.fstatSync(s).size,d=Object.fromEntries(Object.entries(process.env).filter(([c])=>!I(c)));return y.isAbsolute(f)&&(d.PATH=`${y.dirname(f)}:${d.PATH||""}`),new Promise((c,g)=>{const p=h(f,i.args({prompt:x,model:n,cwd:o,site:u,resume:S}),{cwd:o,env:d,detached:!0,stdio:["ignore",s,s]});p.once("spawn",async()=>{a.closeSync(s);const b=await E(p,r,m,i.session);p.unref(),c({pid:p.pid,sessionId:b,log:r})}),p.once("error",b=>{a.closeSync(s),g(b)})})}t(N,"launchAgent");export{N as launchAgent};

package/board/arch-review.mjs

@@ -1,5 +1,5 @@
-var I=Object.defineProperty;var r=(e,n)=>I(e,"name",{value:n,configurable:!0});import v from"node:fs/promises";import L from"node:os";import g from"node:path";import{boardRepo as W}from"../hub/board-repo.mjs";import{samePath as q}from"../hub/boards.mjs";import{cloneRoot as J}from"../shared/repos.mjs";import{readUsageGate as P,pauseReason as T,holdsWork as U}from"../shared/usage-gate.mjs";import{reviewWaits as _}from"../shared/skills.mjs";import{unlanded as K}from"./domain.mjs";import{BoardError as O,addItem as x,appendThread as Q,boardConfig as G,cardName as N,changeLineup as H,createLineup as M,itemSources as F,parseKey as X,readJSON as A,resolveQuestion as E,setItem as z,startBuilder as V,topicQuestions as B,wavesDir as R}from"./store.mjs";const $=r(e=>g.join(e,"data","arch-reviews.json"),"recordsFile"),C=r(async e=>(await A($(e),{reviews:[]})).reviews||[],"readReviews"),Y={paths:["hub/","board/","shared/","CONTEXT.md","docs/adr/"],data:["~/.claude/kickflip/manifest.json","~/.claude/kickflip/sites/*/data/wave.json","~/.claude/kickflip/sites/*/data/owner.json","~/.claude/kickflip/sites/*/data/events.jsonl"]},Z=r(({github:e,repo:n})=>(e?e.split("/").pop():g.basename(n||""))||"this repo","repoName");function me(e,n,s,{repo:d,waits:h}){const p=new Map(n.map(a=>[a.key,a])),o=r(a=>{const u=p.get(a.key);if(!u)return null;const t=r(i=>i.key!==a.key&&(a.lineup?i.lineup?.slug===a.wave:i.wave===a.wave),"inWave"),c=u.lane!=="done";return{key:a.key,ref:u.ref,wave:a.title,at:a.at,open:c,running:c&&!u.questions,findings:s.filter(i=>i.topic===`item:${a.key}`&&!i.round_of&&!i.confirm_of).length,built:n.filter(i=>t(i)&&i.lane==="done"&&!K(i)).length}},"view");return{repo:d,waits:h,last:[...e].reverse().map(o).find(Boolean)||null}}r(me,"archOf");const ee=r(e=>e.toLocaleDateString("en-CA").replaceAll("-",""),"stampOf"),te=r(e=>e.toLocaleDateString("en-US",{month:"short",day:"numeric"}),"dayOf");async function D(e,n){let s=e;for(let d=2;await n(s);d++)s=`${e}-${d}`;return s}r(D,"freeSlug");const ae=r(e=>{throw new O(e)},"fail"),ie=r(e=>v.stat(e).then(()=>!0,()=>!1),"exists");async function he(e,n,{now:s=new Date,home:d=L.homedir()}={}){const h=_(d);if(h)throw Object.assign(new O(h),{status:409});const p=P({home:d,dir:e});if(U(p))throw Object.assign(new O(T(p)),{status:409});const o=W(n.route),a=Z(o),u=`Architecture ${te(s)}`,t=`arch-${ee(s)}`,c=await F(e),i=(await G(e)).items==="waves";let f,w=null,l;if(i){f=await D(t,S=>ie(g.join(R(),S)));const y=g.join(R(),f,"wave.json");await v.mkdir(g.dirname(y),{recursive:!0}),await v.writeFile(y,JSON.stringify({title:u,...o.github?{repo:o.github}:{},items:[]},null,2)+`
-`),l=(await x(e,`${f}/audit`,{title:`Architecture review of ${a}`})).key}else{const[y]=c,S=(await Promise.all(c.map(async b=>(await A(b.file,{}))?.lineups||[]))).flat();w=await D(t,b=>c.some(j=>j.slug===b)||S.some(j=>j.slug===b)),f=y.slug,l=(await x(e,f,{title:`Architecture review of ${a}`})).key}w&&await M(e,w,{title:u,goal:`Act on the architecture review of ${a}`,phases:[l],note:`${await N(e,l)} is the audit of ${a}: its Notes are the report, and it asks one question per finding. Each finding you don't skip becomes a card after it, built from the option you pick.`}),await V(e,l,{label:"Architecture review"}),await Q(e,l,{text:`Started an architecture review of ${a}. Its report becomes this card's Notes, with one question per finding.`});const k=await C(e);k.push({key:l,wave:w||f,lineup:!!w,title:u,repo:o.repo,at:s.toISOString()}),await v.mkdir(g.dirname($(e)),{recursive:!0}),await v.writeFile($(e)+".tmp",JSON.stringify({reviews:k},null,2)+`
-`),await v.rename($(e)+".tmp",$(e));const m={key:l,repo:o.repo,github:o.github||null,branch:o.branch||null,wave:w||f,lineup:!!w,...o.repo&&q(o.repo,J())?{scope:Y}:{}};return{key:l,data:m}}r(he,"startReview");async function ve(e,n){const s=(await C(e)).find(t=>t.key===n)||ae(`${n} is not an architecture review's audit card`),{wave:d}=X(n),{asked:h}=await B(e,`item:${n}`),p=[];for(const t of h.filter(c=>c.state==="answered")){const c=t.answers.at(-1),i=t.options.find(m=>m.id===c.choice);if(!i)continue;if(i.id==="skip"||i.label==="Skip"){await E(e,t.id,"Skipped."),p.push(`skipped: ${t.id}`);continue}const f=[i.detail,...(i.practice||[]).map(m=>`- ${m}`),c.note.trim()&&`Owner's note: ${c.note.trim()}`,`From the finding: ${t.question}`].filter(Boolean).join(`
+var D=Object.defineProperty;var r=(e,a)=>D(e,"name",{value:a,configurable:!0});import g from"node:fs/promises";import E from"node:os";import k from"node:path";import{boardRepo as I}from"../hub/board-repo.mjs";import{samePath as J}from"../hub/boards.mjs";import{cloneRoot as P}from"../shared/repos.mjs";import{readUsageGate as U,pauseReason as _,holdsWork as q}from"../shared/usage-gate.mjs";import{reviewWaits as K}from"../shared/skills.mjs";import{unlanded as L}from"./domain.mjs";import{BoardError as j,addItem as O,appendStatus as Q,boardConfig as T,cardName as x,changeWave as G,createWave as H,itemSources as N,parseKey as M,readJSON as A,resolveQuestion as W,setItem as X,startBuilder as z,topicQuestions as F,wavesDir as B}from"./store.mjs";const $=r(e=>k.join(e,"data","arch-reviews.json"),"recordsFile"),R=r(async e=>(await A($(e),{reviews:[]})).reviews||[],"readReviews"),V={paths:["hub/","board/","shared/","CONTEXT.md","docs/adr/"],data:["~/.claude/kickflip/manifest.json","~/.claude/kickflip/sites/*/data/items.json","~/.claude/kickflip/sites/*/data/owner.json","~/.claude/kickflip/sites/*/data/events.jsonl"]},Y=r(({github:e,repo:a})=>(e?e.split("/").pop():k.basename(a||""))||"this repo","repoName");function pe(e,a,s,{repo:f,waits:m}){const u=new Map(a.map(i=>[i.key,i])),n=r(i=>{const w=u.get(i.key);if(!w)return null;const t=r(o=>o.key!==i.key&&(i.wave?o.wave?.slug===i.wave:o.file===i.file),"inWave"),c=w.lane!=="done";return{key:i.key,ref:w.ref,wave:i.title,at:i.at,open:c,running:c&&!w.questions,findings:s.filter(o=>o.topic===`item:${i.key}`&&!o.round_of&&!o.confirm_of).length,built:a.filter(o=>t(o)&&o.lane==="done"&&!L(o)).length}},"view");return{repo:f,waits:m,last:[...e].reverse().map(n).find(Boolean)||null}}r(pe,"archOf");const Z=r(e=>e.toLocaleDateString("en-CA").replaceAll("-",""),"stampOf"),ee=r(e=>e.toLocaleDateString("en-US",{month:"short",day:"numeric"}),"dayOf");async function C(e,a){let s=e;for(let f=2;await a(s);f++)s=`${e}-${f}`;return s}r(C,"freeSlug");const te=r(e=>{throw new j(e)},"fail"),ae=r(e=>g.stat(e).then(()=>!0,()=>!1),"exists");async function me(e,a,{now:s=new Date,home:f=E.homedir()}={}){const m=K(f);if(m)throw Object.assign(new j(m),{status:409});const u=U({home:f,dir:e});if(q(u))throw Object.assign(new j(_(u)),{status:409});const n=I(a.route),i=Y(n),w=`Architecture ${ee(s)}`,t=`arch-${Z(s)}`,c=await N(e),o=(await T(e)).items==="waves";let p,l;if(o){const d=await C(t,v=>ae(k.join(B(),v))),y=k.join(B(),d,"wave.json");await g.mkdir(k.dirname(y),{recursive:!0}),await g.writeFile(y,JSON.stringify({title:w,...n.github?{repo:n.github}:{},items:[]},null,2)+`
+`),l=(await O(e,`${d}/audit`,{title:`Architecture review of ${i}`})).key,p={file:d}}else{const[d]=c,y=(await Promise.all(c.map(async v=>(await A(v.file,{}))?.waves||[]))).flat();p={wave:await C(t,v=>c.some(S=>S.slug===v)||y.some(S=>S.slug===v))},l=(await O(e,d.slug,{title:`Architecture review of ${i}`})).key}p.wave&&await H(e,p.wave,{title:w,goal:`Act on the architecture review of ${i}`,cards:[l],note:`${await x(e,l)} is the audit of ${i}: its Notes are the report, and it asks one question per finding. Each finding you don't skip becomes a card after it, built from the option you pick.`}),await z(e,l,{label:"Architecture review"}),await Q(e,l,"arch-review",{card:i});const h=await R(e);h.push({key:l,...p,title:w,repo:n.repo,at:s.toISOString()}),await g.mkdir(k.dirname($(e)),{recursive:!0}),await g.writeFile($(e)+".tmp",JSON.stringify({reviews:h},null,2)+`
+`),await g.rename($(e)+".tmp",$(e));const b={key:l,repo:n.repo,github:n.github||null,branch:n.branch||null,...p,...n.repo&&J(n.repo,P())?{scope:V}:{}};return{key:l,data:b}}r(me,"startReview");async function he(e,a){const s=(await R(e)).find(t=>t.key===a)||te(`${a} is not an architecture review's audit card`),{file:f}=M(a),{asked:m}=await F(e,`item:${a}`),u=[];for(const t of m.filter(c=>c.state==="answered")){const c=t.answers.at(-1),o=t.options.find(d=>d.id===c.choice);if(!o)continue;if(o.id==="skip"||o.label==="Skip"){await W(e,t.id,"Skipped."),u.push(`skipped: ${t.id}`);continue}const p=[o.detail,...(o.practice||[]).map(d=>`- ${d}`),c.note.trim()&&`Owner's note: ${c.note.trim()}`,`From the finding: ${t.question}`].filter(Boolean).join(`
 
-`),w=(await A((await F(e)).find(m=>m.slug===d).file,{items:[]})).items.at(-1)?.id,l=await x(e,d,{title:i.label,notes:f,...s.lineup?{}:{deps:w}});s.lineup&&await H(e,s.wave,{add:l.key});const k=await N(e,l.key);await E(e,t.id,`Filed as ${k}.`),p.push(`filed: ${k} from ${t.id}`,...l.lines||[])}const o=(await B(e,`item:${n}`)).asked.filter(t=>t.state!=="resolved");if(o.length)return{lines:[...p,`waiting: ${o.map(t=>t.id).join(", ")}`]};const a=(await B(e,`item:${n}`)).asked.filter(t=>/^Filed as /.test(t.resolved||"")).map(t=>t.resolved.slice(9,-1)),u=await z(e,n,{done:!0,text:a.length?`Every finding is settled: filed ${a.join(", ")}.`:"Every finding is settled: none filed."});return{lines:[...p,...u.lines,`closed: ${await N(e,n)}`]}}r(ve,"fileFindings");export{Y as HUB_SCOPE,me as archOf,ve as fileFindings,C as readReviews,Z as repoName,he as startReview};
+`),l=(await A((await N(e)).find(d=>d.slug===f).file,{items:[]})).items.at(-1)?.id,h=await O(e,f,{title:o.label,notes:p,...s.wave?{}:{deps:l}});s.wave&&await G(e,s.wave,{add:h.key,after:a});const b=await x(e,h.key);await W(e,t.id,`Filed as ${b}.`),u.push(`filed: ${b} from ${t.id}`,...h.lines||[])}const n=(await F(e,`item:${a}`)).asked.filter(t=>t.state!=="resolved");if(n.length)return{lines:[...u,`waiting: ${n.map(t=>t.id).join(", ")}`]};const i=(await F(e,`item:${a}`)).asked.filter(t=>/^Filed as /.test(t.resolved||"")).map(t=>t.resolved.slice(9,-1)),w=await X(e,a,{done:!0,closing:["findings-settled",{filed:i.join(", ")}]});return{lines:[...u,...w.lines,`closed: ${await x(e,a)}`]}}r(he,"fileFindings");export{V as HUB_SCOPE,pe as archOf,he as fileFindings,R as readReviews,Y as repoName,me as startReview};