@lovek4d/kickflip 0.6.0 → 0.7.0

package/bin/doctor.mjs

@@ -1,4 +1,5 @@
-var it=Object.defineProperty;var d=(n,u)=>it(n,"name",{value:u,configurable:!0});import k from"node:fs";import q from"node:os";import p from"node:path";import{isTryPort as J}from"../hub/try.mjs";import{githubGitArgv as nt,gitReachFault as rt}from"../hub/repos.mjs";import{buildsLocally as at,isBoardSite as lt}from"../hub/boards.mjs";import{cloneRoot as Q,reposDir as ct}from"../shared/repos.mjs";import{codexStatus as ut}from"../shared/codex.mjs";import{REVIEW_SKILLS as ft,SKILLS_SOURCE as dt,addCommand as ht,skillsState as mt,updateCommand as pt}from"../shared/skills.mjs";import{hubService as gt,runCommand as kt}from"../shared/service.mjs";import{tailscaleBin as bt}from"../shared/tailscale.mjs";import{inspectLinks as $t,ownsStatusLine as yt,hasWatcherStop as wt,hubStatus as xt,tailscaleState as St,runInstall as jt}from"./install.mjs";const h="kickflip doctor --fix",Y={ok:"ok",fixable:"fixable",yours:"yours",optional:"optional",note:"note"},y=d(n=>`'${n.replaceAll("'","'\\''")}'`,"quote"),Ot={darwin:{git:"xcode-select --install",gh:"brew install gh",tmux:"brew install tmux"},other:{git:"sudo apt install git",gh:"sudo apt install gh",tmux:"sudo apt install tmux"}},Ct="cli/cli",Tt=15e3,Z=d(n=>{try{return k.realpathSync(n)}catch{return null}},"realPath"),tt=d(n=>n.length?`${n.map(u=>`/${u}`).join(", ")} ${n.length>1?"use":"uses"} it`:"","usedBy");function et({home:n=q.homedir(),cloneRoot:u=Q()}={}){let a={};try{a=JSON.parse(k.readFileSync(p.join(n,".claude","kickflip","manifest.json"),"utf8"))}catch{}const w=[...Object.entries(a.sites||{}).map(([i,r])=>[i,r?.owner?.repo]),...Object.entries(a.closed||{}).map(([i,r])=>[i,r?.site?.owner?.repo]),...Object.entries(a.starting||{}).map(([i,r])=>[i,r?.repo])].map(([i,r])=>[i,r&&Z(r)]).filter(([,i])=>i),f=`${p.sep}.repos${p.sep}`,C=new Set([Z(p.join(u,".repos")),...w.map(([,i])=>i.includes(f)?i.slice(0,i.indexOf(f)+f.length-1):null)].filter(Boolean)),g=[],x=d(i=>{for(const r of k.readdirSync(i,{withFileTypes:!0})){if(!r.isDirectory())continue;const c=p.join(i,r.name);k.existsSync(p.join(c,".git"))?g.push(c):x(c)}},"walk");for(const i of C)x(i);return g.sort().map(i=>({clone:i,routes:[...new Set(w.filter(([,r])=>r===i||r.startsWith(i+p.sep)).map(([r])=>r))]}))}d(et,"oldBoardClones");async function Nt({home:n=q.homedir(),cloneRoot:u=Q(),port:a=Number(process.env.KICKFLIP_HUB_PORT||4500),uid:w=process.getuid(),env:f=process.env,run:C=kt,platform:g=process.platform,username:x=q.userInfo().username,fetch:i=globalThis.fetch,tailscale:r=bt({env:f,platform:g})}={}){const c=Ot[g==="darwin"?"darwin":"other"],v=[];let m;const s=d((t,e,o,l=null)=>v.push({group:m,item:t,state:e,detail:o,fix:e==="ok"||e==="note"?null:l}),"add"),b=d((t,e,o=null,l=void 0)=>{try{return C(t,e,{env:o?{...f,...o}:f,...l&&{timeout:l}})}catch(j){return{status:1,error:j.message}}},"execute"),M=d((t,e,o,l,j="not on this session\u2019s PATH")=>{const F=b(e,o),K=F.status===0;return s(t,K?"ok":"yours",K?(F.stdout||"installed").trim().split(`
-`)[0]:j,l),K},"installed");m="prereqs";const U=M("git","git",["--version"],c.git);M("node on Claude\u2019s PATH","node",["--version"],`add ${y(p.dirname(process.execPath))} to PATH in your shell profile, then restart Claude Code`,`not on this session\u2019s PATH (${f.PATH||"empty"})`);const V=M("gh","gh",["--version"],c.gh),L=V&&b("gh",["auth","status"]).status===0;if(s("gh signed in",L?"ok":"yours",L?"signed in":V?"not signed in":"needs gh","gh auth login"),U){const t=L?b("gh",["repo","list","--limit","1","--json","nameWithOwner","--jq",".[0].nameWithOwner"]):null,e=t?.status===0&&t.stdout.trim()||Ct,o=b("git",nt(["ls-remote",`https://github.com/${e}.git`,"HEAD"]),{GIT_TERMINAL_PROMPT:"0"});s("GitHub clone",o.status===0?"ok":"yours",o.status===0?`git reaches ${e} over https`:`git can\u2019t reach ${e} over https: ${o.error}`,L?"gh auth refresh -h github.com, then kickflip doctor":"check this machine reaches https://github.com, then kickflip doctor")}else s("GitHub clone","yours","needs git",c.git);const T=await St({run:d((t,e)=>b(t,e),"run"),platform:g,uid:w,username:x,port:a,tailscale:r});for(const t of T.prereqs)s(t.item,t.state,t.detail,t.fix);const B=b("tmux",["-V"]);s("tmux",B.status===0?"ok":"optional",B.status===0?(B.stdout||"installed").trim().split(`
-`)[0]:"not installed; a hub board\u2019s session (kickflip join --hub, kickflip hub) runs in it",c.tmux);const A=ut({home:n,env:f,platform:g});s("Codex",A.usable?"ok":"optional",A.usable?"installed and logged in":`${A.reason}; Codex builds and reviews need it`,A.fix);const S=mt({home:n,run:b,gh:L});S.missing.length?s("mattpocock skills","optional",`${S.missing.join(", ")} not installed; architecture reviews need ${S.missing.length===1?"it":"them"}`,ht(S.missing)):S.stale.length?s("mattpocock skills","optional",`${S.stale.join(", ")} out of date with ${dt}`,pt(S.stale)):s("mattpocock skills","ok",`${ft.join(", ")} installed${S.checked?" and current":""}`),m="setup";const X=["kickflip skill link","kickflip-hooks link","~/.claude/statusline.sh"];for(const[t,e]of $t({home:n,cloneRoot:u}).entries())if(e.refusal){const o=k.lstatSync(e.link);s(X[t],"yours",o.isSymbolicLink()?`links to ${k.readlinkSync(e.link)}, not kickflip`:`a real ${o.isDirectory()?"folder":"file"}, not kickflip\u2019s link`,`${o.isSymbolicLink()?`rm ${y(e.link)}`:`mv ${y(e.link)} ${y(e.link+".backup")}`} && ${h}`)}else s(X[t],e.created||e.replaced?"fixable":"ok",`${e.created?"missing":e.replaced?"needs relinking":"linked"} -> ${e.target}`,h);const E=p.join(n,".claude","settings.json");let $={},O;try{if($=JSON.parse(k.readFileSync(E,"utf8")),!$||typeof $!="object"||Array.isArray($))throw new Error("not a settings object")}catch(t){t.code!=="ENOENT"&&(O=t.message)}const I="settings.json statusLine";O?s(I,"yours",`unreadable: ${O}`,`repair the JSON in ${y(E)}, then ${h}`):Object.hasOwn($,"statusLine")?yt($.statusLine,n)?s(I,"ok","runs ~/.claude/statusline.sh"):s(I,"yours","another tool\u2019s status line is selected",`remove statusLine from ${y(E)}, then ${h}`):s(I,"fixable","missing",h);const W="settings.json watcher Stop hook";O?s(W,"yours",`unreadable: ${O}`,`repair the JSON in ${y(E)}, then ${h}`):wt($)?s(W,"ok","runs hooks-plugin/hooks/watcher-stop.mjs"):s(W,"fixable","missing; a board session can end a turn with no live watcher or a message left Working on it",h);const D="settings.json autoCompactEnabled";O?s(D,"yours",`unreadable: ${O}`,`repair the JSON in ${y(E)}, then ${h}`):$.autoCompactEnabled===!0?s(D,"ok","on"):s(D,"fixable",`${Object.hasOwn($,"autoCompactEnabled")?"off":"not set"}; a board session that fills its context stops answering`,h);const N=gt({platform:g,home:n,uid:w,env:f,run:C}),z=N.status();s(N.item,z.running?"ok":N.manager?"fixable":"yours",z.detail,N.manager?h:`run ${N.restartCommand} under a service manager of your own`);for(const t of N.notes())s(t.item,t.state,t.detail,t.fix);m="hub";const H=await xt({port:a,fetch:i});s("hub",H?"ok":"fixable",`${H?"running":"not running"} on 127.0.0.1:${a}`,h);const{serveConfig:G}=T;s(T.root.item,T.root.state,T.root.detail,T.root.fix);let P=H?.sites;if(!P){const t=p.join(n,".claude","kickflip","manifest.json");try{const e=JSON.parse(k.readFileSync(t,"utf8"));P=Object.entries(e.sites||{}).map(([o,l])=>({...l,route:o,state:"hub not running"}))}catch(e){e.code!=="ENOENT"&&s("site manifest","yours",e.message,`repair the JSON in ${y(t)}`),P=[]}}let _={};try{_=JSON.parse(k.readFileSync(p.join(n,".claude","kickflip","manifest.json"),"utf8"))}catch{}const R=new Map,st=[...Object.entries(_.sites||{}),...Object.entries(_.closed||{}).map(([t,e])=>[t,e.site]),...P.map(t=>[t.route,t])];for(const[t,e]of st){if(!e?.dir)continue;let o;try{o=JSON.parse(k.readFileSync(p.join(e.dir,"data","try.json"),"utf8"))}catch{continue}J(o.main_port)&&R.set(Number(o.main_port),`/${t} main`),J(o.main?.https)&&R.set(Number(o.main.https),`/${t} main`);for(const[l,j]of Object.entries(o.cards||{}))J(j.https)&&R.set(Number(j.https),`/${t} ${l}`)}const ot=Object.keys(G?.TCP||{}).filter(J).sort((t,e)=>t-e);s("try ports","ok",ot.map(t=>{const o=Object.entries(G.Web||{}).find(([l])=>l.endsWith(`:${t}`))?.[1]?.Handlers?.["/"]?.Proxy||G.TCP[t].TCPForward||"HTTPS";return`${t} \u2192 ${o} (${R.get(Number(t))||"unknown"})`}).join("; ")||"none"),P.length||s("sites","ok","none");for(const t of P){const e=t.port?`port ${t.port}`:`files ${t.dir}`,o=`${t.state}  ${e}  owner ${t.owner?.label||t.owner?.session||"-"}  ${t.title||""}`.trimEnd();t.state==="up"?s("/"+t.route,"ok",o):H?t.serves==="port"?s("/"+t.route,"note",`${o}; its session runs this server, not the hub`):t.serves==="files"?s("/"+t.route,"note",`${o}; its folder is missing`):s("/"+t.route,"note",`${o}; the hub restarts it, see kickflip logs ${t.route}`):s("/"+t.route,"fixable",o,h)}if(U)for(const[t,e]of Object.entries(_.sites||{})){const o=e?.owner?.repo;if(!lt(e)||at(e)||!o)continue;const l=b("git",["-C",o,"ls-remote","--exit-code","origin","HEAD"],{GIT_TERMINAL_PROMPT:"0"},Tt),{error:j,hint:F}=rt(l.error,{github:e.github||"",repo:o});s(`/${t} repo`,l.status===0?"ok":"yours",l.status===0?`git reaches ${e.github||"origin"} from ${o}`:`git can\u2019t reach ${e.github||"origin"} from ${o}: ${j}`,F)}for(const{clone:t,routes:e}of et({home:n,cloneRoot:u}))s("old board clone","optional",[`${t} is in an old place`,`board clones now live in ${ct(n)}`,tt(e)].filter(Boolean).join("; "),h);return v}d(Nt,"doctorReport");function Pt(n){const u=Math.max(...Object.values(Y).map(a=>a.length));return n.flatMap(a=>[`${Y[a.state].padEnd(u)} ${a.item}: ${a.detail}`,...a.fix?[`${" ".repeat(u+1)}\u2192 ${a.fix}`]:[]])}d(Pt,"doctorLines");async function Dt({fix:n=!1,dryRun:u=!1,json:a=!1,write:w=console.log,error:f=console.error,install:C=jt,ask:g,...x}={}){let i=!1;if(n){const c=a?f:w;try{await C({...x,dryRun:u,log:c})}catch(m){i=!0,f("kickflip: "+m.message)}const v=et(x);if(u){for(const{clone:m}of v)c(`would ask to remove the old board clone ${m}`);return{items:[],exitCode:i?1:0}}for(const{clone:m,routes:s}of g?v:[]){const b=await g(`Remove the old board clone ${m}? ${s.length?`${tt(s)}. `:""}(y/N) `);/^y(es)?$/i.test(b.trim())&&(k.rmSync(m,{recursive:!0,force:!0}),c(`removed ${m}`))}}const r=await Nt(x);return w(a?JSON.stringify({items:r},null,2):Pt(r).join(`
-`)),{items:r,exitCode:i||r.some(c=>c.state==="fixable"||c.state==="yours")?1:0}}d(Dt,"runDoctor");export{Pt as doctorLines,Nt as doctorReport,et as oldBoardClones,Dt as runDoctor};
+var nt=Object.defineProperty;var p=(i,c)=>nt(i,"name",{value:c,configurable:!0});import g from"node:fs";import q from"node:os";import d from"node:path";import{isTryPort as M}from"../hub/try.mjs";import{githubGitArgv as rt,gitReachFault as at}from"../hub/repos.mjs";import{buildsLocally as lt,isBoardSite as ct}from"../hub/boards.mjs";import{cloneRoot as Y,reposDir as ut}from"../shared/repos.mjs";import{codexStatus as dt}from"../shared/codex.mjs";import{REVIEW_SKILLS as ft,SKILLS_SOURCE as ht,addCommand as pt,skillsState as mt,updateCommand as gt}from"../shared/skills.mjs";import{hubService as kt,runCommand as bt}from"../shared/service.mjs";import{tailscaleBin as $t,tailscaleSkipped as yt}from"../shared/tailscale.mjs";import{inspectLinks as St,ownsStatusLine as wt,hasWatcherStop as jt,hubStatus as xt,tailscaleState as Ot,runInstall as Ct}from"./install.mjs";const f="kickflip doctor --fix",Z={ok:"ok",fixable:"fixable",yours:"yours",optional:"optional",note:"note"},y=p(i=>`'${i.replaceAll("'","'\\''")}'`,"quote"),Pt={darwin:{git:"xcode-select --install",gh:"brew install gh",tmux:"brew install tmux"},other:{git:"sudo apt install git",gh:"sudo apt install gh",tmux:"sudo apt install tmux"}},Tt="cli/cli",vt=15e3,tt=p(i=>{try{return g.realpathSync(i)}catch{return null}},"realPath"),et=p(i=>i.length?`${i.map(c=>`/${c}`).join(", ")} ${i.length>1?"use":"uses"} it`:"","usedBy");function st({home:i=q.homedir(),cloneRoot:c=Y()}={}){let a={};try{a=JSON.parse(g.readFileSync(d.join(i,".claude","kickflip","manifest.json"),"utf8"))}catch{}const S=[...Object.entries(a.sites||{}).map(([n,r])=>[n,r?.owner?.repo]),...Object.entries(a.closed||{}).map(([n,r])=>[n,r?.site?.owner?.repo]),...Object.entries(a.starting||{}).map(([n,r])=>[n,r?.repo])].map(([n,r])=>[n,r&&tt(r)]).filter(([,n])=>n),u=`${d.sep}.repos${d.sep}`,T=new Set([tt(d.join(c,".repos")),...S.map(([,n])=>n.includes(u)?n.slice(0,n.indexOf(u)+u.length-1):null)].filter(Boolean)),h=[],w=p(n=>{for(const r of g.readdirSync(n,{withFileTypes:!0})){if(!r.isDirectory())continue;const m=d.join(n,r.name);g.existsSync(d.join(m,".git"))?h.push(m):w(m)}},"walk");for(const n of T)w(n);return h.sort().map(n=>({clone:n,routes:[...new Set(S.filter(([,r])=>r===n||r.startsWith(n+d.sep)).map(([r])=>r))]}))}p(st,"oldBoardClones");async function Nt({home:i=q.homedir(),cloneRoot:c=Y(),port:a=Number(process.env.KICKFLIP_HUB_PORT||4500),uid:S=process.getuid(),env:u=process.env,run:T=bt,platform:h=process.platform,username:w=q.userInfo().username,fetch:n=globalThis.fetch,tailscale:r=$t({env:u,platform:h}),skipped:m=yt(r,{env:u,platform:h})}={}){const O=Pt[h==="darwin"?"darwin":"other"],k=[];let C;const s=p((t,e,o,l=null)=>k.push({group:C,item:t,state:e,detail:o,fix:e==="ok"||e==="note"?null:l}),"add"),b=p((t,e,o=null,l=void 0)=>{try{return T(t,e,{env:o?{...u,...o}:u,...l&&{timeout:l}})}catch(x){return{status:1,error:x.message}}},"execute"),B=p((t,e,o,l,x="not on this session\u2019s PATH")=>{const J=b(e,o),U=J.status===0;return s(t,U?"ok":"yours",U?(J.stdout||"installed").trim().split(`
+`)[0]:x,l),U},"installed");C="prereqs";const V=B("git","git",["--version"],O.git);B("node on Claude\u2019s PATH","node",["--version"],`add ${y(d.dirname(process.execPath))} to PATH in your shell profile, then restart Claude Code`,`not on this session\u2019s PATH (${u.PATH||"empty"})`);const X=B("gh","gh",["--version"],O.gh),E=X&&b("gh",["auth","status"]).status===0;if(s("gh signed in",E?"ok":"yours",E?"signed in":X?"not signed in":"needs gh","gh auth login"),V){const t=E?b("gh",["repo","list","--limit","1","--json","nameWithOwner","--jq",".[0].nameWithOwner"]):null,e=t?.status===0&&t.stdout.trim()||Tt,o=b("git",rt(["ls-remote",`https://github.com/${e}.git`,"HEAD"]),{GIT_TERMINAL_PROMPT:"0"});s("GitHub clone",o.status===0?"ok":"yours",o.status===0?`git reaches ${e} over https`:`git can\u2019t reach ${e} over https: ${o.error}`,E?"gh auth refresh -h github.com, then kickflip doctor":"check this machine reaches https://github.com, then kickflip doctor")}else s("GitHub clone","yours","needs git",O.git);const v=await Ot({run:p((t,e)=>b(t,e),"run"),platform:h,uid:S,username:w,port:a,tailscale:r,skipped:m});for(const t of v.prereqs)s(t.item,t.state,t.detail,t.fix);const W=b("tmux",["-V"]);s("tmux",W.status===0?"ok":"optional",W.status===0?(W.stdout||"installed").trim().split(`
+`)[0]:"not installed; a hub board\u2019s session (kickflip join --hub, kickflip hub) runs in it",O.tmux);const A=dt({home:i,env:u,platform:h});s("Codex",A.usable?"ok":"optional",A.usable?"installed and logged in":`${A.reason}; Codex builds and reviews need it`,A.fix);const j=mt({home:i,run:b,gh:E});j.missing.length?s("mattpocock skills","optional",`${j.missing.join(", ")} not installed; architecture reviews need ${j.missing.length===1?"it":"them"}`,pt(j.missing)):j.stale.length?s("mattpocock skills","optional",`${j.stale.join(", ")} out of date with ${ht}`,gt(j.stale)):s("mattpocock skills","ok",`${ft.join(", ")} installed${j.checked?" and current":""}`),C="setup";const z=["kickflip skill link","kickflip-hooks link","~/.claude/statusline.sh"];for(const[t,e]of St({home:i,cloneRoot:c}).entries())if(e.refusal){const o=g.lstatSync(e.link);s(z[t],"yours",o.isSymbolicLink()?`links to ${g.readlinkSync(e.link)}, not kickflip`:`a real ${o.isDirectory()?"folder":"file"}, not kickflip\u2019s link`,`${o.isSymbolicLink()?`rm ${y(e.link)}`:`mv ${y(e.link)} ${y(e.link+".backup")}`} && ${f}`)}else s(z[t],e.created||e.replaced?"fixable":"ok",`${e.created?"missing":e.replaced?"needs relinking":"linked"} -> ${e.target}`,f);const I=d.join(i,".claude","settings.json");let $={},P;try{if($=JSON.parse(g.readFileSync(I,"utf8")),!$||typeof $!="object"||Array.isArray($))throw new Error("not a settings object")}catch(t){t.code!=="ENOENT"&&(P=t.message)}const H="settings.json statusLine";P?s(H,"yours",`unreadable: ${P}`,`repair the JSON in ${y(I)}, then ${f}`):Object.hasOwn($,"statusLine")?wt($.statusLine,i)?s(H,"ok","runs ~/.claude/statusline.sh"):s(H,"yours","another tool\u2019s status line is selected",`remove statusLine from ${y(I)}, then ${f}`):s(H,"fixable","missing",f);const D="settings.json watcher Stop hook";P?s(D,"yours",`unreadable: ${P}`,`repair the JSON in ${y(I)}, then ${f}`):jt($)?s(D,"ok","runs hooks-plugin/hooks/watcher-stop.mjs"):s(D,"fixable","missing; a board session can end a turn with no live watcher or a message left Working on it",f);const G="settings.json autoCompactEnabled";P?s(G,"yours",`unreadable: ${P}`,`repair the JSON in ${y(I)}, then ${f}`):$.autoCompactEnabled===!0?s(G,"ok","on"):s(G,"fixable",`${Object.hasOwn($,"autoCompactEnabled")?"off":"not set"}; a board session that fills its context stops answering`,f);const N=kt({platform:h,home:i,uid:S,env:u,run:T}),Q=N.status();s(N.item,Q.running?"ok":N.manager?"fixable":"yours",Q.detail,N.manager?f:`run ${N.restartCommand} under a service manager of your own`);for(const t of N.notes())s(t.item,t.state,t.detail,t.fix);if(h==="darwin"){const t=d.join(i,".claude","kickflip","manifest.json");(b("mdfind",["-onlyin",d.join(i,".claude"),'kMDItemFSName == "manifest.json"']).stdout||"").split(`
+`).includes(t)?s("Spotlight","yours",`indexes ~/.claude/kickflip, so every builder worktree drives its CPU up; ${f} can\u2019t change that`,"System Settings \u203A Spotlight \u203A Search Privacy (or Spotlight \u203A Privacy): add ~/.claude/kickflip"):s("Spotlight","ok","skips ~/.claude/kickflip")}C="hub";const _=await xt({port:a,fetch:n});s("hub",_?"ok":"fixable",`${_?"running":"not running"} on 127.0.0.1:${a}`,f);const{serveConfig:K}=v;s(v.root.item,v.root.state,v.root.detail,v.root.fix);let L=_?.sites;if(!L){const t=d.join(i,".claude","kickflip","manifest.json");try{const e=JSON.parse(g.readFileSync(t,"utf8"));L=Object.entries(e.sites||{}).map(([o,l])=>({...l,route:o,state:"hub not running"}))}catch(e){e.code!=="ENOENT"&&s("site manifest","yours",e.message,`repair the JSON in ${y(t)}`),L=[]}}let F={};try{F=JSON.parse(g.readFileSync(d.join(i,".claude","kickflip","manifest.json"),"utf8"))}catch{}const R=new Map,ot=[...Object.entries(F.sites||{}),...Object.entries(F.closed||{}).map(([t,e])=>[t,e.site]),...L.map(t=>[t.route,t])];for(const[t,e]of ot){if(!e?.dir)continue;let o;try{o=JSON.parse(g.readFileSync(d.join(e.dir,"data","try.json"),"utf8"))}catch{continue}M(o.main_port)&&R.set(Number(o.main_port),`/${t} main`),M(o.main?.https)&&R.set(Number(o.main.https),`/${t} main`);for(const[l,x]of Object.entries(o.cards||{}))M(x.https)&&R.set(Number(x.https),`/${t} ${l}`)}const it=Object.keys(K?.TCP||{}).filter(M).sort((t,e)=>t-e);s("try ports","ok",it.map(t=>{const o=Object.entries(K.Web||{}).find(([l])=>l.endsWith(`:${t}`))?.[1]?.Handlers?.["/"]?.Proxy||K.TCP[t].TCPForward||"HTTPS";return`${t} \u2192 ${o} (${R.get(Number(t))||"unknown"})`}).join("; ")||"none"),L.length||s("sites","ok","none");for(const t of L){const e=t.port?`port ${t.port}`:`files ${t.dir}`,o=`${t.state}  ${e}  owner ${t.owner?.label||t.owner?.session||"-"}  ${t.title||""}`.trimEnd();t.state==="up"?s("/"+t.route,"ok",o):_?t.serves==="port"?s("/"+t.route,"note",`${o}; its session runs this server, not the hub`):t.serves==="files"?s("/"+t.route,"note",`${o}; its folder is missing`):s("/"+t.route,"note",`${o}; the hub restarts it, see kickflip logs ${t.route}`):s("/"+t.route,"fixable",o,f)}if(V)for(const[t,e]of Object.entries(F.sites||{})){const o=e?.owner?.repo;if(!ct(e)||lt(e)||!o)continue;const l=b("git",["-C",o,"ls-remote","--exit-code","origin","HEAD"],{GIT_TERMINAL_PROMPT:"0"},vt),{error:x,hint:J}=at(l.error,{github:e.github||"",repo:o});s(`/${t} repo`,l.status===0?"ok":"yours",l.status===0?`git reaches ${e.github||"origin"} from ${o}`:`git can\u2019t reach ${e.github||"origin"} from ${o}: ${x}`,J)}for(const{clone:t,routes:e}of st({home:i,cloneRoot:c}))s("old board clone","optional",[`${t} is in an old place`,`board clones now live in ${ut(i)}`,et(e)].filter(Boolean).join("; "),f);return k}p(Nt,"doctorReport");function Lt(i){const c=Math.max(...Object.values(Z).map(a=>a.length));return i.flatMap(a=>[`${Z[a.state].padEnd(c)} ${a.item}: ${a.detail}`,...a.fix?[`${" ".repeat(c+1)}\u2192 ${a.fix}`]:[]])}p(Lt,"doctorLines");async function Kt({fix:i=!1,dryRun:c=!1,json:a=!1,write:S=console.log,error:u=console.error,install:T=Ct,ask:h,...w}={}){let n=!1;if(i){const m=a?u:S;try{await T({...w,dryRun:c,log:m})}catch(k){n=!0,u("kickflip: "+k.message)}const O=st(w);if(c){for(const{clone:k}of O)m(`would ask to remove the old board clone ${k}`);return{items:[],exitCode:n?1:0}}for(const{clone:k,routes:C}of h?O:[]){const s=await h(`Remove the old board clone ${k}? ${C.length?`${et(C)}. `:""}(y/N) `);/^y(es)?$/i.test(s.trim())&&(g.rmSync(k,{recursive:!0,force:!0}),m(`removed ${k}`))}}const r=await Nt(w);return S(a?JSON.stringify({items:r},null,2):Lt(r).join(`
+`)),{items:r,exitCode:n||r.some(m=>m.state==="fixable"||m.state==="yours")?1:0}}p(Kt,"runDoctor");export{Lt as doctorLines,Nt as doctorReport,st as oldBoardClones,Kt as runDoctor};

package/bin/event-lines.mjs

@@ -0,0 +1 @@
+var n=Object.defineProperty;var t=(e,a)=>n(e,"name",{value:a,configurable:!0});import{waitsAgainLine as d}from"../board/domain.mjs";const r=["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"],i=t(e=>{try{return JSON.parse(e).kind}catch{return null}},"kindOf"),h=t(e=>r.includes(i(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-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,r as RECORD_ONLY,h as recordOnly};

package/bin/install.mjs

@@ -1,3 +1,3 @@
-var W=Object.defineProperty;var y=(e,s)=>W(e,"name",{value:s,configurable:!0});import o from"node:fs";import E from"node:os";import n from"node:path";import{SKILLS_SOURCE as I,addArgv as D,addCommand as M,missingSkills as P}from"../shared/skills.mjs";import{cloneRoot as N}from"../shared/repos.mjs";import{hubService as q,runCommand as _}from"../shared/service.mjs";import{tailscaleBin as B,tailscaleInstallHint as C}from"../shared/tailscale.mjs";const U=y(()=>o.existsSync("/opt/homebrew/bin/node")?"/opt/homebrew/bin/node":process.execPath,"nodeBin"),at=y((e,s,t=N())=>`${U()} ${n.join(t,"bin","wait-events.mjs")} ${e} ${s}`,"watcherCommand");function z(e,{home:s=E.homedir(),skillsDir:t=n.join(s,".claude","skills"),cloneRoot:i=N()}={}){if(typeof e!="string"||!n.isAbsolute(e))return e;const a=n.relative(i,e);if(a===".."||a.startsWith(`..${n.sep}`)||n.isAbsolute(a))return e;const c=n.resolve(t,"kickflip");let r=!1;try{r=o.realpathSync(c)===o.realpathSync(i)}catch{}return r?n.join(c,a):e}y(z,"storedPath");function G({home:e=E.homedir(),skillsDir:s=n.join(e,".claude","skills"),cloneRoot:t=N()}={}){const i=o.realpathSync(t),a=[["kickflip",i],["kickflip-hooks",n.join(i,"hooks-plugin")]].map(([l,f])=>{if(!o.statSync(f,{throwIfNoEntry:!1})?.isDirectory())throw new Error(`not a directory: ${f}`);const h=l==="kickflip"?f:n.resolve(s,"kickflip","hooks-plugin"),d=n.resolve(s,l),k=o.lstatSync(d,{throwIfNoEntry:!1});let b;if(k){let j;try{j=o.realpathSync(d)}catch(g){if(g.code!=="ENOENT")throw g}k.isSymbolicLink()?j!==o.realpathSync(f)&&(b=`refusing to replace link ${d} -> ${o.readlinkSync(d)}; remove that link explicitly, then rerun kickflip doctor --fix`):(!k.isDirectory()||j!==o.realpathSync(f))&&(b=`refusing to replace real path ${d}; move it aside explicitly, then rerun kickflip doctor --fix`)}return{link:d,target:h,created:!k,...b?{refusal:b}:{}}}),c=n.join(i,"bin","statusline.mjs");if(!o.statSync(c,{throwIfNoEntry:!1})?.isFile())throw new Error(`not a file: ${c}`);const r=n.join(e,".claude","statusline.sh"),S=n.resolve(s,"kickflip","bin","statusline.mjs"),u=o.lstatSync(r,{throwIfNoEntry:!1});let m=!1,w;if(u)if(!u.isSymbolicLink())w=`refusing to replace real path ${r}; move it aside explicitly, then rerun kickflip doctor --fix`;else{let l;try{l=o.realpathSync(r)}catch(k){if(k.code!=="ENOENT")throw k}const f=n.join(e,".claude","kickflip","sites");let h=f;try{h=o.realpathSync(f)}catch{}const d=!!l&&[f,h].some(k=>l.startsWith(k+n.sep));l&&l!==o.realpathSync(c)&&!d&&(w=`refusing to replace link ${r} -> ${o.readlinkSync(r)}; remove that link explicitly, then rerun kickflip doctor --fix`),m=d||n.resolve(n.dirname(r),o.readlinkSync(r))!==S||!l}return a.push({link:r,target:S,created:!u,...m?{replaced:!0}:{},...w?{refusal:w}:{}}),a}y(G,"inspectLinks");function F({home:e=E.homedir(),skillsDir:s=n.join(e,".claude","skills"),cloneRoot:t=N(),dryRun:i=!1}={}){const a=G({home:e,skillsDir:s,cloneRoot:t}),c=a.find(r=>r.refusal);if(c)throw new Error(c.refusal);if(i)return a;o.mkdirSync(s,{recursive:!0}),o.mkdirSync(n.join(e,".claude"),{recursive:!0});for(const{link:r,target:S,created:u,replaced:m}of a)m&&o.unlinkSync(r),(u||m)&&o.symlinkSync(S,r,r===n.join(e,".claude","statusline.sh")?"file":"dir");return a}y(F,"installLinks");function Q(e,s=E.homedir()){const t=n.join(s,".claude","statusline.sh"),i=[t,`"${t}"`,`'${t.replaceAll("'","'\\''")}'`,"~/.claude/statusline.sh","$HOME/.claude/statusline.sh",'"$HOME/.claude/statusline.sh"',"${HOME}/.claude/statusline.sh",'"${HOME}/.claude/statusline.sh"'];return e?.type==="command"&&i.includes(e.command)}y(Q,"ownsStatusLine");const K='node "$HOME/.claude/skills/kickflip/hooks-plugin/hooks/watcher-stop.mjs"',V=y(e=>(Array.isArray(e?.hooks?.Stop)?e.hooks.Stop:[]).some(s=>Array.isArray(s?.hooks)&&s.hooks.some(t=>t?.type==="command"&&/\/hooks-plugin\/hooks\/watcher-stop\.mjs\b/.test(t.command))),"hasWatcherStop");async function X({port:e=Number(process.env.KICKFLIP_HUB_PORT||4500),fetch:s=globalThis.fetch}={}){try{const t=await s(`http://127.0.0.1:${e}/_hub/status.json`,{signal:AbortSignal.timeout(1500)});if(!t.ok)return null;const i=await t.json();return Array.isArray(i?.sites)?i:null}catch{return null}}y(X,"hubStatus");function R(e){const s=Object.entries(e?.Web||{}).filter(([t])=>!/:\d+$/.test(t)||t.endsWith(":443")).flatMap(([,t])=>Object.entries(t.Handlers||{}));return{root:s.find(([t])=>t==="/")?.[1]?.Proxy||null,paths:[...new Set(s.map(([t])=>t))]}}y(R,"tailscaleRoot");function ct(e,{run:s=_,platform:t=process.platform,tailscale:i=B({platform:t})}={}){if(!i)throw new Error(`Tailscale isn't installed on this host; ${C(t)}`);const a=s(i,["status","--json"]);let c=null;try{c=a.status===0?JSON.parse(a.stdout):null}catch{}if(c?.BackendState!=="Running")throw new Error("Tailscale isn't running on this host; start it, or run tailscale up");const r=c.Self?.DNSName?.replace(/\.$/,"")||"";if(!r||!c.CertDomains?.includes(r))throw new Error("HTTPS isn't on for this tailnet; turn on HTTPS Certificates on the DNS page of the Tailscale admin console");return`https://${r}/${e?e+"/":""}`}y(ct,"tailnetUrl");async function lt({run:e=_,platform:s=process.platform,uid:t=process.getuid(),username:i=E.userInfo().username,port:a=Number(process.env.KICKFLIP_HUB_PORT||4500),tailscale:c=B({platform:s})}={}){const r=y(async $=>{try{return await e(c,$)}catch(v){return{status:1,error:v.message}}},"execute"),S=y($=>{try{return $.status===0?JSON.parse($.stdout):null}catch{return null}},"json"),u=c?await r(["version"]):null,m=u?.status===0,w=m?S(await r(["status","--json"])):null,l=w?.BackendState==="Running",f=w?.Self?.DNSName?.replace(/\.$/,"")||"",h=m&&s==="linux"&&t!==0,d=h?S(await r(["debug","prefs"]))?.OperatorUser:null,k=m?S(await r(["serve","status","--json"])):null,b=R(k);let j=!1;try{const $=new URL(b.root);j=$.protocol==="http:"&&["127.0.0.1","localhost","[::1]"].includes($.hostname)&&Number($.port)===a&&$.pathname==="/"&&!$.search&&!$.hash}catch{}const g=y(($,v,p,x,A="yours")=>({item:$,state:v?"ok":A,detail:p,fix:v?null:x}),"entry"),O=[g("Tailscale",m,m?`${(u.stdout||"installed").trim().split(`
-`)[0]} (${c})`:`not on this session\u2019s PATH${s==="darwin"?" or in Applications":""}`,C(s)),g("Tailscale signed in",l,l?`signed in${f?" as "+f:""}`:m?"not connected":"needs Tailscale","tailscale up")];h&&O.push(g("Tailscale operator",d===i,d===i?i:`${d||"none"} (expected ${i})`,"sudo tailscale set --operator=$USER"));const T=b.paths.filter($=>$!=="/"),L=g("tailscale /",j,`${b.root||"nothing"}${j?"":` (expected the hub on ${a})`}${T.length?"; other mounts: "+T.join(", "):""}`,l?"kickflip doctor --fix":m?"tailscale up":C(s),l?"fixable":"yours");return{installed:m,signedIn:l,dns:f,operatorChecked:h,operator:d,username:i,pointsAtHub:j,prereqs:O,root:L,serveConfig:k}}y(lt,"tailscaleState");async function ut({home:e=E.homedir(),cloneRoot:s=N(),port:t=Number(process.env.KICKFLIP_HUB_PORT||4500),uid:i=process.getuid(),env:a=process.env,run:c=_,platform:r=process.platform,tailscale:S=B({env:a,platform:r}),wait:u=y(f=>new Promise(h=>setTimeout(h,f)),"wait"),fetch:m=globalThis.fetch,dryRun:w=!1,log:l=console.log}={}){const f=n.join(e,".claude","kickflip"),h=q({platform:r,home:e,uid:i,env:a,run:c});if(w){try{for(const{link:x,target:A,created:H,replaced:J}of F({home:e,cloneRoot:s,dryRun:w}))l(`would ${H||J?"link":"check"} ${x} -> ${A}`)}catch(x){l(`would refuse: ${x.message}`)}l(`would merge statusLine and the watcher Stop hook, turn on autoCompactEnabled and remove stale hooks in ${n.join(e,".claude","settings.json")}`);const p=P(e);p.length&&l(`would add ${p.join(", ")} from ${I} with ${M(p)}`);for(const x of await h.install(null,{wait:u,dryRun:w}))l(x);l(`would map tailscale / to the hub on ${t} and remove old site mounts`);return}for(const{link:p,target:x,created:A,replaced:H}of F({home:e,cloneRoot:s}))l(`${A||H?"linked":"checked"} ${p} -> ${x}`);for(const p of Y({home:e}))l(p);const d=P(e);if(d.length){const p=c("npx",D(d),{env:a,timeout:3e5});l(p.status===0?`added ${d.join(", ")} from ${I}`:`could not add ${d.join(", ")} from ${I}: ${p.error}; run ${M(d)}`)}const k=U(),b=z(n.join(s,"hub","hub.mjs"),{home:e,cloneRoot:s});o.mkdirSync(f,{recursive:!0});const j=n.join(f,"hub.log"),g=h.definition({node:k,entry:b,state:f,port:t,log:j});for(const p of await h.install(g,{wait:u}))l(p);let O=!1;for(let p=0;p<30&&!O;p++)await u(300),O=!!await X({port:t,fetch:m});if(!O)throw new Error("hub did not start; see "+j);if(!S)return l(`skipped mapping tailscale / to the hub: Tailscale isn't installed on this host; ${C(r)}`);const T=c(S,["serve","--bg",String(t)],{env:a});if(T.status!==0)throw new Error(T.error||"tailscale serve failed");const L=c(S,["serve","status","--json"],{env:a});let $;try{$=JSON.parse(L.stdout)}catch{return}let v={};try{v=JSON.parse(o.readFileSync(n.join(f,"manifest.json"),"utf8")).sites||{}}catch(p){if(p.code!=="ENOENT")throw p}for(const p of R($).paths)p!=="/"&&Object.hasOwn(v,p.replace(/^\//,"").replace(/\/$/,""))&&c(S,["serve","--https=443","--set-path="+p,"off"],{env:a})}y(ut,"runInstall");function Y({home:e=E.homedir()}={}){const s=n.join(e,".claude","settings.json");let t={},i=384;try{t=JSON.parse(o.readFileSync(s,"utf8")),i=o.statSync(s).mode}catch(u){if(u.code!=="ENOENT")throw u}if(!t||typeof t!="object"||Array.isArray(t))throw new Error(`not a settings object: ${s}`);const a=[];let c=!1;const r=n.join(e,".claude","statusline.sh");if(Object.hasOwn(t,"statusLine"))Q(t.statusLine,e)||a.push(`kept existing statusLine in ${s}; it points elsewhere`);else{const u=/^[\w/.-]+$/.test(r)?r:`'${r.replaceAll("'","'\\''")}'`;t.statusLine={type:"command",command:u},c=!0,a.push(`set statusLine in ${s} -> ${u}`)}if(!V(t)){const u=t.hooks&&typeof t.hooks=="object"?t.hooks:{};t.hooks={...u,Stop:[...Array.isArray(u.Stop)?u.Stop:[],{hooks:[{type:"command",command:K}]}]},c=!0,a.push(`added the watcher Stop hook to ${s} -> ${K}`)}t.autoCompactEnabled!==!0&&(t.autoCompactEnabled=!0,c=!0,a.push(`turned on autoCompactEnabled in ${s}`));const S=n.join(e,".claude","hooks","no-paths.py");if(!o.existsSync(S)&&t.hooks&&typeof t.hooks=="object"){const u=y(l=>l.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),"escape"),m=[S,"~/.claude/hooks/no-paths.py","$HOME/.claude/hooks/no-paths.py","${HOME}/.claude/hooks/no-paths.py"].map(u).join("|"),w=new RegExp(`^\\s*(?:exec\\s+)?(?:(?:/usr/bin/env\\s+)?(?:[^\\s]+/)?python(?:\\d+(?:\\.\\d+)*)?(?:\\s+-[^\\s]+)*\\s+)?(?:"(?:${m})"|'(?:${m})'|(?:${m}))(?=$|\\s)`);for(const[l,f]of Object.entries(t.hooks))Array.isArray(f)&&(t.hooks[l]=f.flatMap(h=>{if(!Array.isArray(h?.hooks))return[h];const d=h.hooks.filter(k=>k?.type!=="command"||typeof k.command!="string"||!w.test(k.command)?!0:(a.push(`removed stale hook ${l}: ${k.command}`),c=!0,!1));return d.length===h.hooks.length?[h]:d.length?[{...h,hooks:d}]:[]}))}if(c){o.mkdirSync(n.dirname(s),{recursive:!0});const u=`${s}.${process.pid}.${Date.now()}.tmp`;try{o.writeFileSync(u,JSON.stringify(t,null,2)+`
-`,{mode:i,flag:"wx"}),o.renameSync(u,s)}finally{try{o.unlinkSync(u)}catch{}}}return a}y(Y,"installClaudeSettings");function dt({home:e=E.homedir(),skillsDir:s=n.join(e,".claude","skills"),cloneRoot:t=N()}={}){const i=n.join(e,".claude","statusline.sh");if(!o.lstatSync(i,{throwIfNoEntry:!1})?.isSymbolicLink())return!1;let c=n.resolve(n.dirname(i),o.readlinkSync(i))===n.resolve(s,"kickflip","bin","statusline.mjs");try{c||=o.realpathSync(i)===o.realpathSync(n.join(t,"bin","statusline.mjs"))}catch{}return c?(o.unlinkSync(i),!0):!1}y(dt,"uninstallStatusLine");export{K as WATCHER_STOP,V as hasWatcherStop,X as hubStatus,G as inspectLinks,Y as installClaudeSettings,F as installLinks,U as nodeBin,Q as ownsStatusLine,ut as runInstall,z as storedPath,ct as tailnetUrl,R as tailscaleRoot,lt as tailscaleState,dt as uninstallStatusLine,at as watcherCommand};
+var W=Object.defineProperty;var y=(e,n)=>W(e,"name",{value:n,configurable:!0});import r from"node:fs";import v from"node:os";import s from"node:path";import{SKILLS_SOURCE as I,addArgv as D,addCommand as M,missingSkills as P}from"../shared/skills.mjs";import{cloneRoot as O}from"../shared/repos.mjs";import{hubService as q,runCommand as _}from"../shared/service.mjs";import{tailscaleBin as B,tailscaleInstallHint as H}from"../shared/tailscale.mjs";const U=y(()=>r.existsSync("/opt/homebrew/bin/node")?"/opt/homebrew/bin/node":process.execPath,"nodeBin"),at=y((e,n,t=O())=>`${U()} ${s.join(t,"bin","wait-events.mjs")} ${e} ${n}`,"watcherCommand");function z(e,{home:n=v.homedir(),skillsDir:t=s.join(n,".claude","skills"),cloneRoot:c=O()}={}){if(typeof e!="string"||!s.isAbsolute(e))return e;const o=s.relative(c,e);if(o===".."||o.startsWith(`..${s.sep}`)||s.isAbsolute(o))return e;const a=s.resolve(t,"kickflip");let i=!1;try{i=r.realpathSync(a)===r.realpathSync(c)}catch{}return i?s.join(a,o):e}y(z,"storedPath");function G({home:e=v.homedir(),skillsDir:n=s.join(e,".claude","skills"),cloneRoot:t=O()}={}){const c=r.realpathSync(t),o=[["kickflip",c],["kickflip-hooks",s.join(c,"hooks-plugin")]].map(([u,p])=>{if(!r.statSync(p,{throwIfNoEntry:!1})?.isDirectory())throw new Error(`not a directory: ${p}`);const f=u==="kickflip"?p:s.resolve(n,"kickflip","hooks-plugin"),h=s.resolve(n,u),m=r.lstatSync(h,{throwIfNoEntry:!1});let j;if(m){let g;try{g=r.realpathSync(h)}catch(b){if(b.code!=="ENOENT")throw b}m.isSymbolicLink()?g!==r.realpathSync(p)&&(j=`refusing to replace link ${h} -> ${r.readlinkSync(h)}; remove that link explicitly, then rerun kickflip doctor --fix`):(!m.isDirectory()||g!==r.realpathSync(p))&&(j=`refusing to replace real path ${h}; move it aside explicitly, then rerun kickflip doctor --fix`)}return{link:h,target:f,created:!m,...j?{refusal:j}:{}}}),a=s.join(c,"bin","statusline.mjs");if(!r.statSync(a,{throwIfNoEntry:!1})?.isFile())throw new Error(`not a file: ${a}`);const i=s.join(e,".claude","statusline.sh"),S=s.resolve(n,"kickflip","bin","statusline.mjs"),l=r.lstatSync(i,{throwIfNoEntry:!1});let w=!1,k;if(l)if(!l.isSymbolicLink())k=`refusing to replace real path ${i}; move it aside explicitly, then rerun kickflip doctor --fix`;else{let u;try{u=r.realpathSync(i)}catch(m){if(m.code!=="ENOENT")throw m}const p=s.join(e,".claude","kickflip","sites");let f=p;try{f=r.realpathSync(p)}catch{}const h=!!u&&[p,f].some(m=>u.startsWith(m+s.sep));u&&u!==r.realpathSync(a)&&!h&&(k=`refusing to replace link ${i} -> ${r.readlinkSync(i)}; remove that link explicitly, then rerun kickflip doctor --fix`),w=h||s.resolve(s.dirname(i),r.readlinkSync(i))!==S||!u}return o.push({link:i,target:S,created:!l,...w?{replaced:!0}:{},...k?{refusal:k}:{}}),o}y(G,"inspectLinks");function F({home:e=v.homedir(),skillsDir:n=s.join(e,".claude","skills"),cloneRoot:t=O(),dryRun:c=!1}={}){const o=G({home:e,skillsDir:n,cloneRoot:t}),a=o.find(i=>i.refusal);if(a)throw new Error(a.refusal);if(c)return o;r.mkdirSync(n,{recursive:!0}),r.mkdirSync(s.join(e,".claude"),{recursive:!0});for(const{link:i,target:S,created:l,replaced:w}of o)w&&r.unlinkSync(i),(l||w)&&r.symlinkSync(S,i,i===s.join(e,".claude","statusline.sh")?"file":"dir");return o}y(F,"installLinks");function Q(e,n=v.homedir()){const t=s.join(n,".claude","statusline.sh"),c=[t,`"${t}"`,`'${t.replaceAll("'","'\\''")}'`,"~/.claude/statusline.sh","$HOME/.claude/statusline.sh",'"$HOME/.claude/statusline.sh"',"${HOME}/.claude/statusline.sh",'"${HOME}/.claude/statusline.sh"'];return e?.type==="command"&&c.includes(e.command)}y(Q,"ownsStatusLine");const K='node "$HOME/.claude/skills/kickflip/hooks-plugin/hooks/watcher-stop.mjs"',V=y(e=>(Array.isArray(e?.hooks?.Stop)?e.hooks.Stop:[]).some(n=>Array.isArray(n?.hooks)&&n.hooks.some(t=>t?.type==="command"&&/\/hooks-plugin\/hooks\/watcher-stop\.mjs\b/.test(t.command))),"hasWatcherStop");async function X({port:e=Number(process.env.KICKFLIP_HUB_PORT||4500),fetch:n=globalThis.fetch}={}){try{const t=await n(`http://127.0.0.1:${e}/_hub/status.json`,{signal:AbortSignal.timeout(1500)});if(!t.ok)return null;const c=await t.json();return Array.isArray(c?.sites)?c:null}catch{return null}}y(X,"hubStatus");function R(e){const n=Object.entries(e?.Web||{}).filter(([t])=>!/:\d+$/.test(t)||t.endsWith(":443")).flatMap(([,t])=>Object.entries(t.Handlers||{}));return{root:n.find(([t])=>t==="/")?.[1]?.Proxy||null,paths:[...new Set(n.map(([t])=>t))]}}y(R,"tailscaleRoot");function ct(e,{run:n=_,platform:t=process.platform,tailscale:c=B({platform:t})}={}){if(!c)throw new Error(`Tailscale isn't installed on this host; ${H(t)}`);const o=n(c,["status","--json"]);let a=null;try{a=o.status===0?JSON.parse(o.stdout):null}catch{}if(a?.BackendState!=="Running")throw new Error("Tailscale isn't running on this host; start it, or run tailscale up");const i=a.Self?.DNSName?.replace(/\.$/,"")||"";if(!i||!a.CertDomains?.includes(i))throw new Error("HTTPS isn't on for this tailnet; turn on HTTPS Certificates on the DNS page of the Tailscale admin console");return`https://${i}/${e?e+"/":""}`}y(ct,"tailnetUrl");async function lt({skipped:e=[],run:n=_,platform:t=process.platform,uid:c=process.getuid(),username:o=v.userInfo().username,port:a=Number(process.env.KICKFLIP_HUB_PORT||4500),tailscale:i=B({platform:t})}={}){const S=y(async $=>{try{return await n(i,$)}catch(d){return{status:1,error:d.message}}},"execute"),l=y($=>{try{return $.status===0?JSON.parse($.stdout):null}catch{return null}},"json"),w=i?await S(["version"]):null,k=w?.status===0,u=k?l(await S(["status","--json"])):null,p=u?.BackendState==="Running",f=u?.Self?.DNSName?.replace(/\.$/,"")||"",h=k&&t==="linux"&&c!==0,m=h?l(await S(["debug","prefs"]))?.OperatorUser:null,j=k?l(await S(["serve","status","--json"])):null,g=R(j);let b=!1;try{const $=new URL(g.root);b=$.protocol==="http:"&&["127.0.0.1","localhost","[::1]"].includes($.hostname)&&Number($.port)===a&&$.pathname==="/"&&!$.search&&!$.hash}catch{}const E=y(($,d,x,T,A="yours")=>({item:$,state:d?"ok":A,detail:x,fix:d?null:T}),"entry"),N=[E("Tailscale",k,k?`${(w.stdout||"installed").trim().split(`
+`)[0]} (${i})${e.length?`; skipped ${e.join(", ")}, whose daemon${e.length===1?" isn\u2019t":"s aren\u2019t"} running`:""}`:`not on this session\u2019s PATH${t==="darwin"?" or in Applications":""}`,H(t)),E("Tailscale signed in",p,p?`signed in${f?" as "+f:""}`:k?"not connected":"needs Tailscale","tailscale up")];h&&N.push(E("Tailscale operator",m===o,m===o?o:`${m||"none"} (expected ${o})`,"sudo tailscale set --operator=$USER"));const C=g.paths.filter($=>$!=="/"),L=E("tailscale /",b,`${g.root||"nothing"}${b?"":` (expected the hub on ${a})`}${C.length?"; other mounts: "+C.join(", "):""}`,p?"kickflip doctor --fix":k?"tailscale up":H(t),p?"fixable":"yours");return{installed:k,signedIn:p,dns:f,operatorChecked:h,operator:m,username:o,pointsAtHub:b,prereqs:N,root:L,serveConfig:j}}y(lt,"tailscaleState");async function ut({home:e=v.homedir(),cloneRoot:n=O(),port:t=Number(process.env.KICKFLIP_HUB_PORT||4500),uid:c=process.getuid(),env:o=process.env,run:a=_,platform:i=process.platform,tailscale:S=B({env:o,platform:i}),wait:l=y(p=>new Promise(f=>setTimeout(f,p)),"wait"),fetch:w=globalThis.fetch,dryRun:k=!1,log:u=console.log}={}){const p=s.join(e,".claude","kickflip"),f=q({platform:i,home:e,uid:c,env:o,run:a});if(k){try{for(const{link:x,target:T,created:A,replaced:J}of F({home:e,cloneRoot:n,dryRun:k}))u(`would ${A||J?"link":"check"} ${x} -> ${T}`)}catch(x){u(`would refuse: ${x.message}`)}u(`would merge statusLine and the watcher Stop hook, turn on autoCompactEnabled and remove stale hooks in ${s.join(e,".claude","settings.json")}`);const d=P(e);d.length&&u(`would add ${d.join(", ")} from ${I} with ${M(d)}`);for(const x of await f.install(null,{wait:l,dryRun:k}))u(x);u(`would map tailscale / to the hub on ${t} and remove old site mounts`);return}for(const{link:d,target:x,created:T,replaced:A}of F({home:e,cloneRoot:n}))u(`${T||A?"linked":"checked"} ${d} -> ${x}`);for(const d of Y({home:e}))u(d);const h=P(e);if(h.length){const d=a("npx",D(h),{env:o,timeout:3e5});u(d.status===0?`added ${h.join(", ")} from ${I}`:`could not add ${h.join(", ")} from ${I}: ${d.error}; run ${M(h)}`)}const m=U(),j=z(s.join(n,"hub","hub.mjs"),{home:e,cloneRoot:n});r.mkdirSync(p,{recursive:!0});const g=s.join(p,"hub.log"),b=f.definition({node:m,entry:j,state:p,port:t,log:g});for(const d of await f.install(b,{wait:l}))u(d);let E=!1;for(let d=0;d<30&&!E;d++)await l(300),E=!!await X({port:t,fetch:w});if(!E)throw new Error("hub did not start; see "+g);if(!S)return u(`skipped mapping tailscale / to the hub: Tailscale isn't installed on this host; ${H(i)}`);const N=a(S,["serve","--bg",String(t)],{env:o});if(N.status!==0)throw new Error(N.error||"tailscale serve failed");const C=a(S,["serve","status","--json"],{env:o});let L;try{L=JSON.parse(C.stdout)}catch{return}let $={};try{$=JSON.parse(r.readFileSync(s.join(p,"manifest.json"),"utf8")).sites||{}}catch(d){if(d.code!=="ENOENT")throw d}for(const d of R(L).paths)d!=="/"&&Object.hasOwn($,d.replace(/^\//,"").replace(/\/$/,""))&&a(S,["serve","--https=443","--set-path="+d,"off"],{env:o})}y(ut,"runInstall");function Y({home:e=v.homedir()}={}){const n=s.join(e,".claude","settings.json");let t={},c=384;try{t=JSON.parse(r.readFileSync(n,"utf8")),c=r.statSync(n).mode}catch(l){if(l.code!=="ENOENT")throw l}if(!t||typeof t!="object"||Array.isArray(t))throw new Error(`not a settings object: ${n}`);const o=[];let a=!1;const i=s.join(e,".claude","statusline.sh");if(Object.hasOwn(t,"statusLine"))Q(t.statusLine,e)||o.push(`kept existing statusLine in ${n}; it points elsewhere`);else{const l=/^[\w/.-]+$/.test(i)?i:`'${i.replaceAll("'","'\\''")}'`;t.statusLine={type:"command",command:l},a=!0,o.push(`set statusLine in ${n} -> ${l}`)}if(!V(t)){const l=t.hooks&&typeof t.hooks=="object"?t.hooks:{};t.hooks={...l,Stop:[...Array.isArray(l.Stop)?l.Stop:[],{hooks:[{type:"command",command:K}]}]},a=!0,o.push(`added the watcher Stop hook to ${n} -> ${K}`)}t.autoCompactEnabled!==!0&&(t.autoCompactEnabled=!0,a=!0,o.push(`turned on autoCompactEnabled in ${n}`));const S=s.join(e,".claude","hooks","no-paths.py");if(!r.existsSync(S)&&t.hooks&&typeof t.hooks=="object"){const l=y(u=>u.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),"escape"),w=[S,"~/.claude/hooks/no-paths.py","$HOME/.claude/hooks/no-paths.py","${HOME}/.claude/hooks/no-paths.py"].map(l).join("|"),k=new RegExp(`^\\s*(?:exec\\s+)?(?:(?:/usr/bin/env\\s+)?(?:[^\\s]+/)?python(?:\\d+(?:\\.\\d+)*)?(?:\\s+-[^\\s]+)*\\s+)?(?:"(?:${w})"|'(?:${w})'|(?:${w}))(?=$|\\s)`);for(const[u,p]of Object.entries(t.hooks))Array.isArray(p)&&(t.hooks[u]=p.flatMap(f=>{if(!Array.isArray(f?.hooks))return[f];const h=f.hooks.filter(m=>m?.type!=="command"||typeof m.command!="string"||!k.test(m.command)?!0:(o.push(`removed stale hook ${u}: ${m.command}`),a=!0,!1));return h.length===f.hooks.length?[f]:h.length?[{...f,hooks:h}]:[]}))}if(a){r.mkdirSync(s.dirname(n),{recursive:!0});const l=`${n}.${process.pid}.${Date.now()}.tmp`;try{r.writeFileSync(l,JSON.stringify(t,null,2)+`
+`,{mode:c,flag:"wx"}),r.renameSync(l,n)}finally{try{r.unlinkSync(l)}catch{}}}return o}y(Y,"installClaudeSettings");function dt({home:e=v.homedir(),skillsDir:n=s.join(e,".claude","skills"),cloneRoot:t=O()}={}){const c=s.join(e,".claude","statusline.sh");if(!r.lstatSync(c,{throwIfNoEntry:!1})?.isSymbolicLink())return!1;let a=s.resolve(s.dirname(c),r.readlinkSync(c))===s.resolve(n,"kickflip","bin","statusline.mjs");try{a||=r.realpathSync(c)===r.realpathSync(s.join(t,"bin","statusline.mjs"))}catch{}return a?(r.unlinkSync(c),!0):!1}y(dt,"uninstallStatusLine");export{K as WATCHER_STOP,V as hasWatcherStop,X as hubStatus,G as inspectLinks,Y as installClaudeSettings,F as installLinks,U as nodeBin,Q as ownsStatusLine,ut as runInstall,z as storedPath,ct as tailnetUrl,R as tailscaleRoot,lt as tailscaleState,dt as uninstallStatusLine,at as watcherCommand};

package/bin/kickflip.mjs

@@ -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/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(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/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,[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 g=Object.defineProperty;var t=(e,n)=>g(e,"name",{value:n,configurable:!0});import a from"node:fs";import y from"node:path";import{spawn as v,execFileSync as h}from"node:child_process";import{claudeBin as w,inherited as _}from"../hub/sessions.mjs";function I(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(I,"gitCommonDir");const A={claude:{bin:w,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,I(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")}},O=15e3;function T(e,n,c,u){return new Promise(x=>{let o=!1;const l=t(i=>{o||(o=!0,clearInterval(f),clearTimeout(r),e.off("exit",p),x(i))},"finish"),s=t(()=>{const i=a.readFileSync(n,"utf8").slice(c);for(const m of i.split(`
+`)){const S=u(m);if(S)return l(S)}},"scan"),f=setInterval(s,100),r=setTimeout(()=>l(null),O),p=t(()=>{s(),l(null)},"exited");e.once("exit",p)})}t(T,"sessionOf");function F({kind:e,model:n,cwd:c,site:u,prompt:x,log:o,bin:l}){const s=A[e];if(!s)throw new Error(`no agent of kind ${e}`);const f=l??s.bin();a.mkdirSync(y.dirname(o),{recursive:!0});const r=a.openSync(o,"a"),p=a.fstatSync(r).size,i=Object.fromEntries(Object.entries(process.env).filter(([m])=>!_(m)));return y.isAbsolute(f)&&(i.PATH=`${y.dirname(f)}:${i.PATH||""}`),new Promise((m,S)=>{const d=v(f,s.args({prompt:x,model:n,cwd:c,site:u}),{cwd:c,env:i,detached:!0,stdio:["ignore",r,r]});d.once("spawn",async()=>{a.closeSync(r);const b=await T(d,o,p,s.session);d.unref(),m({pid:d.pid,sessionId:b,log:o})}),d.once("error",b=>{a.closeSync(r),S(b)})})}t(F,"launchAgent");export{F 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)+`
+`),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}`,steps:[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(`
 
 `),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};