@lovek4d/kickflip 0.1.0 → 0.3.1

package/bin/doctor.mjs

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

package/bin/install.mjs

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

package/bin/kickflip.mjs

@@ -3,25 +3,37 @@
 //   kickflip doctor [--fix [--dry-run]] [--json]
 //               one line per prereq, installed piece, the hub, Tailscale / and each site (./doctor.mjs): ok,
 //               fixable (by --fix), yours (with the command to run), optional or note. Changes nothing.
-//               --fix runs install's steps, then reports again. --json prints {items:[{group,item,state,detail,fix}]}.
+//               --fix runs init's steps, then reports again. --json prints {items:[{group,item,state,detail,fix}]}.
 //               Exit 1 when anything is fixable or yours
-//   kickflip join <route> (--port <n> | --dir <folder> [--cmd '<json array>' [--port <n>]])
-//               [--title <t>] [--description <d>] [--icon <key>] [--color <css hex>]
+//   kickflip join [--name <board name>] [--hub]
+//               run in a git repo's folder: adds it as a board (docs/adr/0143-kickflip-join-adds-the-current-repository-as-a-board.md).
+//               Asks for the board name, default the folder's name; with no terminal to ask in, --name is needed. The name
+//               takes letters, digits and spaces, and gives the route, lowercased with dashes for spaces. Records the
+//               folder's origin as `github` and its branch; the board's builders branch from the folder's local main and
+//               land there (`local: true`). Marks the folder trusted for Claude Code, then starts the board's session in
+//               the background as `start` does, or with --hub flags the board as the hub board, starts its session in
+//               the foreground in tmux and attaches this terminal to it, as `hub` does. Refuses a folder outside git (exit 2), and exits 1 while the hub isn't
+//               running. A folder that already has a board names it and offers to restart its session
+//   Every other join names its site with --name <name>, which gives its title and its route as above (any characters,
+//   other than letters and digits, become dashes). A name that is the route itself keeps the site's title.
+//   kickflip join --name <name> (--port <n> | --dir <folder> [--cmd '<json array>' [--port <n>]])
+//               [--description <d>] [--icon <key>] [--color <css hex>]
 //               a plain page: no session, owner, watcher or needs (docs/adr/0087-a-page-joins-without-a-session.md).
 //               --port forwards /<route>/ to a server the session already runs, which reads Down while it doesn't
 //               answer; --dir alone has the hub serve the folder's files; --cmd has the hub run that command in --dir
 //               (default the cwd) on --port or a free one. Prints {route, url, serves, port|dir, answering?, hub}.
-//               A rejoin changes how the page is served only when one of those flags is given. Exit 3 when a
-//               session owns the route
-//   kickflip join <route> --session <id> [--watch [<file,file>]] [--label <name>] [--title <t>] [--description <d>]
+//               A rejoin passes --port, --dir or --cmd again. Exit 3 when a session owns the route
+//   kickflip join --name <name> --session <id> [--watch [<file,file>]] [--label <name>] [--description <d>]
 //               [--dir <path>] [--cmd '<json array>'] [--port <n>]
 //               [--filter <regex>] [--template board [--items <waves|file>]] [--force]
 //               [--icon <key>] [--color <css hex>] [--repo <dir>] [--model <m>] [--hub | --no-hub]
 //               a site with an owning session: events, the watcher, Needs you. --watch is optional with --session;
 //               with files it watches those (relative to the dir) in place of data/events.jsonl
-//               --hub makes this board the hub board, as `set --hub` does; a join without either keeps the flag
+//               --hub makes this board the hub board, as `set --hub` does; a join without either keeps the flag.
+//               The hub board's session runs in the foreground in tmux (`hub`); every other board's in the background
 //               --template board runs the shared board (../board/server.mjs) from the site dir,
-//               writing its board.json; --items is "waves" (default) or a wave.json-format file.
+//               writing its board.json; --items is "waves" (default) or a wave.json-format file, made with no
+//               items when missing.
 //               It then runs handshake, unless this session already answered the board's hello, and
 //               asks the hub for one poll (as poll-now --keep-queue), so the board's GitHub link passes
 //               without waiting for the next slot. Prints poll: "reached this board", or why not
@@ -37,7 +49,7 @@
 //   kickflip start <route> [--repo <dir>] [--model <m>] [--prompt <text>]
 //               starts a background session (`claude --bg`, auto mode, worktree isolation off) in --repo, else
 //               the route's recorded folder, else the cwd, named after the board, whose first prompt is
-//               `/kickflip <route>` plus --prompt. Records it as the route's owner, or in `starting` until a
+//               `/kickflip --name '<board name>'` plus --prompt. Records it as the route's owner, or in `starting` until a
 //               join takes it up when the route has no site yet. Prints {route, session, confirmed, repo, argv, output}
 //   kickflip resume <route>
 //               `claude --resume <id> --bg` for the route's recorded session in its folder, prompting it to rejoin
@@ -45,36 +57,52 @@
 //               {route, session, previous, confirmed, repo, argv, output}. Exit 1 when no session or folder is recorded
 //   kickflip close <route> --name <board title>
 //               stops its session, closes builder records and removes the site; keeps its folder and open PRs.
-//               --name must match the board title exactly. The board flagged --hub cannot be closed.
+//               --name must match the board title exactly.
 //   kickflip reopen <route>
 //               restores the closed board's manifest entry and resumes its recorded session
+//   kickflip export <route> [--out <file>]
+//               writes one .tgz (default ./kickflip-<route>.tgz, never over an existing file) holding the board's
+//               folder, without its watcher cursors and watcher record; its manifest entry with only EXPORT_KEYS below,
+//               dropping its folder, port, command, owner session and restart times; the owner's label and model;
+//               settings.json's EXPORT_SETTINGS; and a README.md of the import steps. No other hub file and no key
+//               goes in. Refuses a site that isn't a board, a board whose cards live outside its folder, and a board
+//               with an open builder record. Prints {route, file, entry, dropped, settings}
+//   kickflip import <file>
+//               unpacks an export's board into ~/.claude/kickflip/sites/<route>/, adds its manifest entry with a free
+//               port and this host's board server, and writes its settings over this host's for those keys. A hub
+//               flag is kept only when no other site has it. Refuses a route this host has open, closed or starting,
+//               or whose folder exists. Prints {route, dir, port, settings, hub, join}: `join` is the line a fresh
+//               session runs to take the board over
 //   kickflip hub [--repo <dir>]
-//               opens the hub board's recorded session in this terminal, in its recorded folder and model, or in
-//               --repo when no folder is recorded; with no owner, starts a fresh session in --repo (default cwd)
-//               that joins the board with --hub. Points it to docs/hub-session.md.
-//               Exit 2 when no board has the hub flag (`set --hub`); otherwise keeps claude's exit code
+//               attaches this terminal to the hub board's tmux session (tmux attach; switch-client inside tmux).
+//               With none running, the hub board's session starts in it first, in the foreground: its recorded
+//               session resumed in its recorded folder and model, or in --repo when no folder is recorded; with no
+//               owner, a fresh session in --repo (default cwd) that joins the board with --hub. Points it to
+//               docs/hub-session.md. While the tmux session runs, nothing else starts
+//               (docs/adr/0147-boards-run-in-the-background-and-the-hub-board-in-tmux.md).
+//               Exit 2 when no board has the hub flag (`set --hub`), 3 while its session is live outside tmux;
+//               otherwise keeps tmux's exit code
 //   kickflip sessions [--json]
 //               one line per board: route, session id, live (background or terminal) or not, folder
 //   kickflip handshake <route>
 //               tests a board's hub links (../hub/boards.mjs handshake): appends a `hello` event, which the
-//               owning session answers with `board.mjs hello-ack <eventId>`. The board shows a setup checklist
-//               until the session answered and the hub's GitHub check reached it. Prints {route, hello}
+//               owning session's watcher answers when it prints it. The board shows a setup checklist
+//               until the watcher answered and the hub's GitHub check reached it. Prints {route, hello}
 //   kickflip set <route> [--icon <key>] [--color <hex>] [--hub | --no-hub]
 //               changes an existing site's icon or color without joining; '' clears one. --hub makes the board the
-//               hub board, whose session `hub` opens (`hub: true` in its entry), clearing the flag from any other
+//               hub board, whose session runs in tmux and `hub` attaches to (`hub: true` in its entry), clearing the flag from any other
 //               site; --no-hub clears it. Exit 2 for --hub on a site that isn't a board
 //   kickflip leave <route> [--session <id>] [--force]
 //               removes the entry and keeps its files; --session (or --force) only for a route a session owns
 //   kickflip restart <route>
 //   kickflip logs <route> [--lines <n>]
-//   kickflip install [--dry-run] | uninstall
-//               install is the first-run name for doctor --fix. It first moves a host set up under the web-ts names to
-//               the kickflip ones (./install.mjs migrateHome), then links the running package or clone, hooks plugin
+//   kickflip init [--dry-run] | uninstall
+//               init is the first-run name for doctor --fix. It links the running package or clone, hooks plugin
 //               and status line, configures Claude settings, starts the hub's service in place of the running one (../shared/service.mjs:
-//               a launchd login item on macOS, including one under the old label; a systemd user unit on Linux),
+//               a launchd login item on macOS; a systemd user unit on Linux),
 //               and maps Tailscale / to the hub.
 //               Conflicting skill links and real paths are refused. A dangling status-line link can be replaced.
-//               --dry-run prints what install would move, link and start, and changes nothing.
+//               --dry-run prints what init would move, link and start, and changes nothing.
 //               uninstall stops the hub and removes its service, kickflip's status-line link and Tailscale /;
 //               Claude settings and skill links are kept
 //   kickflip update
@@ -88,8 +116,8 @@
 //               can fix. A push without one is refused (exit 2): news stays on the board.
 //               The push queues, replacing a queued one with the same
 //               --tag, and goes out after the hub's next GitHub check on the polling interval
-//               (/_hub/settings/polling) or when a monitor tick ends (board.mjs checked), each
-//               queued push as its own notification. --now sends at once unless pushes are held
+//               (/_hub/settings/polling) or when a GitHub tick ends (board.mjs checked); a board's
+//               several queued pushes go as one summary. --now sends at once unless pushes are held
 //               (overnight, snoozed or the weekend), and queues if no device takes it; it is for questions,
 //               steps only the owner can run and prototypes. --urgent sends at once through
 //               those holds, for a production fault. While notifications are off every push is dropped, urgent ones too.
@@ -97,7 +125,7 @@
 //   kickflip polling
 //               prints {every, until, next, held, held_until, held_why, notifications}: the current polling
 //               window's minutes, when it ends, the next check, whether pushes are held now, until when
-//               ("never" while off) and why (off, snoozed, weekend or overnight), and the notifications settings
+//               ("never" while off, "forever" while snoozed until ended) and why (off, snoozed, weekend or overnight), and the notifications settings
 //   kickflip notifications [on | off | snooze <length> | unsnooze | weekends on|off]
 //               sets the Hub page's Notifications controls and prints them; off drops the queued pushes.
 //               A snooze length is a hub/schedule.mjs snoozeEnd choice. Without a change it only prints them
@@ -107,7 +135,7 @@
 //               builders take over until it resets.
 //               always (Always on): the same past the pause line; while Codex is out of usage, that work pauses until a
 //               usage-reset check succeeds.
-//               off: no Codex. While Codex isn't installed or logged in, the setting reads off and a change is refused.
+//               off: Claude builds and reviews. While Codex isn't installed or logged in, the setting reads off and a change is refused.
 //   kickflip usage-gate [pause-at <50..100> | keep-going | stop]
 //               prints {pause_at, state, window, used, resets_at, codex: {past, window, used, resets_at}}; a read exits 0.
 //               pause-at saves the line in steps of 5 (default 90, 100 Off); keep-going lifts the current Claude pause
@@ -117,9 +145,36 @@
 //               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 ie=Object.defineProperty;var h=(e,n)=>ie(e,"name",{value:n,configurable:!0});import g from"node:fs";import f from"node:path";import K from"node:os";import z from"node:net";import{execFileSync as M,spawnSync as re}from"node:child_process";import{fileURLToPath as ae}from"node:url";import{ICON_KEYS as U}from"../hub/icons.mjs";import{liveSessions as W}from"../hub/live.mjs";import{isBoardSite as G,writeManifest as O}from"../hub/boards.mjs";import{routeRecord as p,validRoute as Y}from"../hub/routes.mjs";import{migrateOnStart as ce,uninstallStatusLine as de,storedPath as ue}from"./install.mjs";import{hubService as Q}from"../shared/service.mjs";import{runDoctor as le}from"./doctor.mjs";import{cloneRoot as fe}from"../shared/repos.mjs";const b=fe(),J=f.join(K.homedir(),".claude","kickflip"),he=f.join(J,"manifest.json"),V=f.join(J,"logs"),_=Number(process.env.KICKFLIP_HUB_PORT||4500),E=4600,pe=/^#([0-9a-f]{3}|[0-9a-f]{6})$/i,[L,...m]=process.argv.slice(2);["install","doctor"].includes(L)||ce();const t=Object.assign(Object.create(null),{_:[]});for(let e=0;e<m.length;e++){const n=m[e];if(n.startsWith("--")){const s=n.slice(2);s==="fix"||s==="force"||s==="json"||s==="urgent"||s==="now"||s==="keep-queue"||s==="hub"||s==="no-hub"||s==="dry-run"||s==="watch"&&(e+1>=m.length||m[e+1].startsWith("--"))?t[s]=!0:t[s]=m[++e]}else t._.push(n)}const l=h(e=>console.log(typeof e=="string"?e:JSON.stringify(e,null,2)),"out");class N extends Error{static{h(this,"Exit")}constructor(n,s){super(n),this.code=s}}const i=h((e,n=1)=>{throw new N(e,n)},"fail");function B(){t.icon&&!U.includes(t.icon)&&i(`--icon takes one of: ${U.join(", ")}`,2),t.color&&!pe.test(t.color)&&i("--color takes a CSS hex color, such as #3b82f6",2)}h(B,"checkLook");function C(e){for(const n of["icon","color"])t[n]===""?delete e[n]:t[n]!==void 0&&(e[n]=t[n])}h(C,"applyLook");const X=h(()=>t.hub&&t["no-hub"]&&i("pass --hub or --no-hub, not both",2),"checkHub"),Z=h(e=>i(`/${e} is not a board; only a board can be the hub board`,2),"notBoard");function ee(e,n,s){if(t["no-hub"]&&delete s.hub,!!t.hub){G(s)||Z(n);for(const[o,u]of Object.entries(e.sites))o!==n&&u?.hub&&delete u.hub;s.hub=!0}}h(ee,"applyHub");const D=h(()=>g.existsSync("/opt/homebrew/bin/node")?"/opt/homebrew/bin/node":process.execPath,"nodeBin");function y(){try{const e=JSON.parse(g.readFileSync(he,"utf8"));return e.sites||={},e}catch(e){if(e.code==="ENOENT")return{version:1,sites:{}};i("manifest unreadable: "+e.message)}}h(y,"readManifest");const me=h(e=>{try{return JSON.parse(g.readFileSync(e,"utf8"))}catch{return null}},"readJSON"),I=h(()=>import(f.join(b,"hub","sessions.mjs")),"sessionsModule");async function P(e){const{SessionError:n}=await I();try{return await e()}catch(s){throw s instanceof n&&i(s.message,s.reason==="live"?3:s.reason==="hub"?2:1),s}}h(P,"sessionCall");async function te(e){const{handshake:n}=await import(f.join(b,"hub","boards.mjs"));try{return await n(e,y())}catch(s){return i(s.message,2)}}h(te,"runHandshake");async function we(e){for(let n=0;n<2;n++){let s;try{s=await fetch(`http://127.0.0.1:${_}/_hub/poll`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({flush:!1}),signal:AbortSignal.timeout(5*6e4)})}catch(u){return`not run (${u.message})`}if(!s.ok)return`not run (the hub answered ${s.status})`;const o=await s.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(we,"pollFor");async function $(e){const{withManifestLock:n}=await import(f.join(b,"hub","boards.mjs"));try{return await n(e)}catch(s){throw s.code==="ELOCKED"&&i(s.message),s}}h($,"withLock");function se(e){return new Promise(n=>{const s=z.connect({port:e,host:"127.0.0.1"}),o=h(u=>{s.destroy(),n(u)},"done");s.setTimeout(500,()=>o(!1)),s.on("connect",()=>o(!0)),s.on("error",()=>o(!1))})}h(se,"connects");function ge(e){return new Promise(n=>{const s=z.createServer();s.once("error",()=>n(!1)),s.listen(e,"0.0.0.0",()=>s.close(()=>n(!0)))})}h(ge,"bindable");async function ne(e){const n=new Set([...Object.values(e.sites),...Object.values(e.closed||{}).map(s=>s.site)].map(s=>s?.port));for(let s=E;s<E+400;s++)if(!n.has(s)&&!await se(s)&&await ge(s))return s;i("no free port found from "+E)}h(ne,"freePort");function be(){try{return(JSON.parse(M("tailscale",["status","--json"],{encoding:"utf8",stdio:["ignore","pipe","ignore"]})).Self?.DNSName||"").replace(/\.$/,"")}catch{return""}}h(be,"tailnetHost");const oe=h(e=>{const n=be();return n?`https://${n}/${e}/`:`http://127.0.0.1:${_}/${e}/`},"siteUrl");async function R(){try{return await(await fetch(`http://127.0.0.1:${_}/_hub/status.json`,{signal:AbortSignal.timeout(1500)})).json()}catch{return null}}h(R,"hubStatus");const ye=h(e=>{try{return g.statSync(e).isDirectory()}catch{return!1}},"isFolder");async function Se(e){B();const n=t.port===void 0?void 0:Number(t.port);n!==void 0&&!(Number.isInteger(n)&&n>0&&n<65536)&&i("--port takes a port number",2),n===_&&i(`--port ${n} is the hub's own port`,2);let s;if(t.cmd!==void 0){try{s=JSON.parse(t.cmd)}catch{s=null}(!Array.isArray(s)||!s.length||!s.every(r=>typeof r=="string"))&&i(`--cmd takes a JSON array of strings, such as '["/abs/node","/abs/server.mjs"]'`,2)}const o=t.dir===void 0?void 0:f.resolve(t.dir);o!==void 0&&!s&&n===void 0&&!ye(o)&&i(`--dir ${o} is not a folder`,2);const u=await $(async()=>{const r=y();p(r.closed,e)&&i("That board is closed; use kickflip reopen "+e,2),p(r.starting,e)&&i(`/${e} is a board that is starting; pick another route`,2);const a=p(r.sites,e);if(a?.owner?.session)throw l({error:"owned",route:e,owner:a.owner,hint:"a session owns this route: pick another route, or that session leaves it first"}),new N("",3);!a&&n===void 0&&o===void 0&&!s&&i("join needs --port <n> (a server this session runs) or --dir <folder> (files the hub serves), or --session <id> for a watched site",2);const S=new Date().toISOString(),w=a?{...a}:{created:S};if(delete w.watch,delete w.filter,n!==void 0||o!==void 0||s){const x=s?{cmd:s,dir:o||a?.dir||process.cwd(),port:n??(a?.cmd?a.port:void 0)??await ne(r)}:n!==void 0?{port:n,...o?{dir:o}:{}}:{dir:o};for(const k of["cmd","dir","port","cwd","env"])delete w[k];Object.assign(w,x)}return t.title&&(w.title=t.title),t.description&&(w.description=t.description),C(w),w.title||=e,w.updated=S,r.sites={...r.sites,[e]:w},await O(r),w}),c=u.cmd?"cmd":u.port?"port":"files",d=await R();l({route:e,url:oe(e),serves:c,...u.port?{port:u.port}:{},...u.dir?{dir:u.dir}:{},...c==="port"?{answering:await se(u.port)}:{},hub:d?"running":"NOT running: run `kickflip doctor --fix`"})}h(Se,"joinPage");const A={async doctor(){t["dry-run"]&&!t.fix&&i("--dry-run needs --fix",2);const{exitCode:e}=await le({fix:!!t.fix,dryRun:!!t["dry-run"],json:!!t.json});process.exitCode=e},async join(){const e=t._[0];if(Y(e)||i("join needs a route: lowercase letters, digits and dashes",2),!t.session){const c=["watch","template","filter","label","model","repo","hub","force"].find(d=>t[d]!==void 0);return c&&i(`--${c} needs --session <id> (this session's id)`,2),Se(e)}t.template&&t.template!=="board"&&i('--template takes "board"',2),B(),X();const n=await $(async()=>{const c=y();p(c.closed,e)&&i("That board is closed; use kickflip reopen "+e,2);const d=new Date().toISOString(),r=p(c.sites,e);if(r?.owner?.session&&r.owner.session!==t.session&&!t.force)throw l({error:"owned",route:e,owner:r.owner,hint:"ask the user, then rerun with --force to take it over"}),new N("",3);t.hub&&t.template!=="board"&&!G({dir:"",cmd:t.cmd?JSON.parse(t.cmd):r?.cmd})&&Z(e);const a=r?{...r}:{};let S=!1;if(r||(a.dir=f.resolve(t.dir||f.join(J,"sites",e)),(!g.existsSync(a.dir)||g.readdirSync(a.dir).length===0)&&!t.cmd&&!t.template&&(g.cpSync(f.join(b,"starter"),a.dir,{recursive:!0}),S=!0),a.port=t.port?Number(t.port):await ne(c),a.cmd=t.cmd?JSON.parse(t.cmd):[D(),f.join(a.dir,"server.mjs")],a.watch=["data/events.jsonl"],a.created=d),t.dir&&r&&(a.dir=f.resolve(t.dir)),t.port&&r&&(a.port=Number(t.port)),t.cmd&&r&&(a.cmd=JSON.parse(t.cmd)),t.template==="board"){g.mkdirSync(f.join(a.dir,"data"),{recursive:!0});const j=f.join(a.dir,"board.json"),v=g.existsSync(j)?JSON.parse(g.readFileSync(j,"utf8")):{};v.title=t.title||v.title||e,v.items=ue(t.items||v.items||"waves");const F=p(c.starting,e);!r&&F?.tickets&&(!F.session||F.session===t.session)&&(v.tickets=F.tickets),g.writeFileSync(j,JSON.stringify(v,null,2)+`
-`),a.cmd=[D(),f.join(b,"board","server.mjs"),a.dir],S=!r}t.title&&(a.title=t.title),t.description&&(a.description=t.description),typeof t.watch=="string"&&(a.watch=t.watch.split(",").map(j=>j.trim()).filter(Boolean)),t.filter!==void 0&&(a.filter=t.filter||void 0),C(a),ee(c,e,a),a.title||=e;const w=r?.owner&&r.owner.session!==t.session?r.owner:null,x=p(c.starting,e)?.session===t.session?p(c.starting,e):null,k=p(c.starting,e);!r&&k?.github&&(!k.session||k.session===t.session)&&(a.github=k.github,a.branch=k.branch);const H=r?.owner?.session===t.session?r.owner:null,T=H||x||w;a.owner={...H||{session:t.session,since:d},label:t.label||T?.label||"",repo:t.repo?f.resolve(t.repo):a.github&&T?.repo||W().get(t.session)?.cwd||T?.repo||process.cwd()};const q=t.model||T?.model;return q&&(a.owner.model=q),p(c.starting,e)&&(delete c.starting[e],Object.keys(c.starting).length||delete c.starting),a.updated=d,c.sites={...c.sites,[e]:a},await O(c),{route:e,created:S,previousOwner:w,site:a}}),s=await R();let o,u;if(t.template==="board"){const c=me(f.join(n.site.dir,"data","handshake.json"));o=c?.ack&&c.hello?.session===t.session?"answered before":await te(e),u=s?await we(e):"not run (the hub is not running)"}l({route:e,url:oe(e),dir:n.site.dir,port:n.site.port,owner:n.site.owner,createdFromStarter:n.created,previousOwner:n.previousOwner,log:f.join(V,e+".log"),watcher:`${D()} ${f.join(b,"bin","wait-events.mjs")} ${e} ${t.session}`,hub:s?"running":"NOT running: run `kickflip doctor --fix`",...o?{handshake:o}:{},...u?{poll:u}:{}})},async handshake(){const e=t._[0];e||i("handshake needs a route",2),l(await te(e))},async leave(){const e=t._[0];e||i("leave needs a route",2),await $(async()=>{const n=y(),s=p(n.sites,e);if(s||i("no site at /"+e),s.owner?.session&&!t.session&&!t.force&&i("a session owns /"+e+"; leave needs --session <id>, or --force",2),s.owner?.session&&s.owner.session!==t.session&&!t.force)throw l({error:"owned",route:e,owner:s.owner}),new N("",3);delete n.sites[e],await O(n),l({left:e,filesKept:s.dir})})},async start(){const e=t._[0];Y(e)||i("start needs a route: lowercase letters, digits and dashes",2);const{startSession:n,withSessionLock:s}=await I();await s(e,async()=>{const o=await P(()=>n(e,{manifest:y(),repo:t.repo,model:t.model,prompt:t.prompt}));await $(async()=>{const u=y(),c={session:o.session,label:o.name,since:new Date().toISOString(),repo:o.repo,...o.model?{model:o.model}:{}};p(u.sites,e)?(u.sites[e].owner=c,u.sites[e].updated=c.since):u.starting={...u.starting,[e]:{...p(u.starting,e),...c}},await O(u)}),l({route:o.route,session:o.session,confirmed:o.confirmed,repo:o.repo,argv:o.argv,output:o.output})})},async resume(){const e=t._[0];e||i("resume needs a route",2);const{resumeSession:n}=await I();l(await P(()=>n(e,{manifest:y()})))},async close(){const{closeBoard:e}=await import("../hub/close-board.mjs");try{l(await e(t._[0],t.name))}catch(n){i(n.message,n.status?2:1)}},async reopen(){const{reopenBoard:e}=await import("../hub/close-board.mjs");try{l(await P(()=>e(t._[0])))}catch(n){throw n.status&&i(n.message,2),n}},async sessions(){const{sessionOf:e}=await I(),{listBoards:n}=await import(f.join(b,"hub","boards.mjs")),s=y(),o=W(),c=[...n(s).map(d=>d.route),...Object.keys(s.starting||{}).filter(d=>!p(s.sites,d))].map(d=>{const r=e(s,d),a=r&&o.get(r.session);return{route:d,session:r?.session||null,live:a?a.kind==="bg"?"background":"terminal":null,repo:r?.repo||null,starting:!p(s.sites,d)}});if(t.json)return l(c);if(!c.length)return l("no boards");for(const d of c)l(`/${d.route}  ${d.session||"no session"}  ${d.live?`live (${d.live})`:"not live"}  ${d.repo||"no folder"}${d.starting?"  (starting: not joined yet)":""}`)},async hub(){const{hubSession:e}=await I(),n=await P(()=>e({manifest:y(),repo:t.repo}));process.exitCode=n.status},async set(){const e=t._[0];e||i("set needs a route",2),t.icon===void 0&&t.color===void 0&&!t.hub&&!t["no-hub"]&&i("set needs --icon, --color, --hub or --no-hub",2),B(),X(),await $(async()=>{const n=y(),s=p(n.sites,e)||i("no site at /"+e);C(s),ee(n,e,s),s.updated=new Date().toISOString(),await O(n),l({route:e,icon:s.icon??null,color:s.color??null,hub:s.hub===!0})})},async restart(){const e=t._[0];await $(async()=>{const n=y();p(n.sites,e)||i("no site at /"+e),n.sites[e].restart_at=Date.now(),await O(n)}),l(`restarting /${e}; the hub picks it up within 2 seconds`)},async logs(){const e=t._[0],n=f.join(V,e+".log");g.existsSync(n)||i("no log yet for /"+e);const s=Number(t.lines||40);l(g.readFileSync(n,"utf8").split(`
-`).slice(-s-1).join(`
-`))},async install(){t.fix=!0,await A.doctor()},async update(){g.existsSync(f.join(b,".git"))&&i(`${b} is a clone; update it with git pull`,2);const e=re("npm",["i","-g","@lovek4d/kickflip@latest"],{stdio:"inherit"});e.status!==0&&i(`npm update failed${e.error?": "+e.error.message:""}`);const n=Q(),s=n.restart();s&&i(`update finished but the hub did not restart: ${s}; run ${n.restartCommand}`),l("updated kickflip and restarted the hub")},async uninstall(){de()&&l(`removed ${f.join(K.homedir(),".claude","statusline.sh")}`);const e=Q();e.remove();try{M("tailscale",["serve","--https=443","--set-path=/","off"],{stdio:"ignore"})}catch{}l(`hub stopped and removed from ${e.manager??"the host"}; tailscale / unmapped. The manifest and sites are kept in ${J}`)},async push(){const{deliver:e,pushKindError:n}=await import(f.join(b,"hub","push.mjs")),s=n(t.kind);s&&i(s,2),t.title||i("push needs --title",2),t.url&&!t.url.startsWith("/")&&i("--url is a path on the hub, such as /<route>/page.html",2);const{clock:o,holdLine:u}=await import(f.join(b,"hub","schedule.mjs"));t.now&&t.urgent&&i("pass --now or --urgent, not both",2);const c=await e({title:t.title,body:t.body||"",url:t.url||"/",tag:t.tag},{kind:t.kind,urgent:!!t.urgent,immediate:!!t.now});if(c.noDevice&&i("no device has turned on notifications; open Hub \u2192 Notifications (/_hub/#notifications) in the Home Screen app and tap Turn on",3),c.dropped)return l("dropped (notifications are off on the Hub page)");if(c.queued){const{count:d,replaced:r,nextFlushAt:a,hold:S,sendFailed:w}=c.queued,x=t.now?S?`${u(S)}; `:w?"no device took it now; ":"":"";l(`queued (${x}${d} in queue${r?"; replaced the queued push with this tag":""}); next send ${o(a)} (${a.toISOString()})`),await R()||l("warning: the hub is not running, so the queue goes out only once it runs");return}l(c.sent),c.sent.some(d=>d.status>=200&&d.status<300)||i("every push was refused",1),l(t.urgent?"sent (urgent)":"sent")},async polling(){const{readSettings:e}=await import(f.join(b,"hub","push.mjs")),{windowAt:n,nextSlot:s,hold:o}=await import(f.join(b,"hub","schedule.mjs")),u=new Date,c=e(),d=n(u,c),r=o(u,c);l({every:d.every_minutes,until:d.endsAt.toISOString(),next:s(u,c).toISOString(),held:r!==null,held_until:r?r.until instanceof Date?r.until.toISOString():r.until:null,held_why:r?.why??null,notifications:c.notifications})},async notifications(){const{setNotifications:e,readSettings:n}=await import(f.join(b,"hub","push.mjs")),[s,o]=t._,c=s===void 0?null:s==="on"||s==="off"?{on:s==="on"}:s==="weekends"?{weekends_off:h((r,a)=>r==="on"?!0:r==="off"?!1:i(`${a} takes on or off`,2),"onOff")(o,"weekends")}:s==="snooze"?{snooze:o||i("snooze takes a length: <n>m, <n>h, <n>d, <n>w, tonight, morning, monday or a date and time",2)}:s==="unsnooze"?{snooze:"off"}:i("notifications takes on, off, snooze <length>, unsnooze, or weekends on|off",2);if(!c)return l(n().notifications);let d;try{d=await e(c)}catch(r){throw r.status===400&&i(r.message,2),r}l(d.dropped?{...d.notifications,dropped:d.dropped}:d.notifications)},async"codex-share"(){(m.length>1||m.length&&t._.length!==1)&&i("codex-share takes auto, always, or off",2);const{readCodexShare:n,setCodexShare:s}=await import(f.join(b,"hub","push.mjs"));if(!m.length)return l(n());try{l(s(m[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:n,setKeepGoing:s}=await import("../shared/usage-gate.mjs");try{m.length&&(m[0]==="pause-at"&&m.length===2?n(m[1]):m[0]==="keep-going"&&m.length===1?s("on"):m[0]==="stop"&&m.length===1?s("off"):i("usage-gate takes pause-at <50..100>, keep-going, or stop",2)),l(e())}catch(o){throw o.status&&i(o.message,o.status===400?2:1),o}},async"poll-now"(){let e;try{e=await fetch(`http://127.0.0.1:${_}/_hub/poll`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({flush:!t["keep-queue"]}),signal:AbortSignal.timeout(10*6e4)})}catch(n){i("the hub is not running: "+n.message)}e.ok||i(`the hub answered ${e.status}: ${(await e.text()).slice(0,200)}`),l(await e.json())}};if(!A[L]){const e=g.readFileSync(ae(import.meta.url),"utf8").split(`
-`).slice(1);l(e.slice(0,e.findIndex(n=>!n.startsWith("//"))).map(n=>n.replace(/^\/\/ ?/,"")).join(`
-`)),process.exit(L?2:0)}try{await A[L]()}catch(e){if(!(e instanceof N))throw e;e.message&&console.error("kickflip: "+e.message),process.exit(e.code)}
+var ve=Object.defineProperty;var h=(e,t)=>ve(e,"name",{value:t,configurable:!0});import w from"node:fs";import u from"node:path";import D from"node:os";import se from"node:net";import Oe from"node:readline/promises";import{execFileSync as oe,spawnSync as M}from"node:child_process";import{fileURLToPath as xe}from"node:url";import{ICON_KEYS as ie}from"../hub/icons.mjs";import{liveSessions as re}from"../hub/live.mjs";import{isBoardSite as L,writeManifest as O}from"../hub/boards.mjs";import{joinName as _e,routeFromName as F,routeRecord as g,validRoute as C}from"../hub/routes.mjs";import{githubFromOrigin as Ne}from"../hub/repos.mjs";import{uninstallStatusLine as Te,storedPath as Ie,nodeBin as K,watcherCommand as Fe}from"./install.mjs";import{hubService as ae}from"../shared/service.mjs";import{runDoctor as Ce}from"./doctor.mjs";import{cloneRoot as Ee}from"../shared/repos.mjs";const j=Ee(),x=u.join(D.homedir(),".claude","kickflip"),Re=u.join(x,"manifest.json"),ce=u.join(x,"logs"),T=Number(process.env.KICKFLIP_HUB_PORT||4500),G=4600,Be=/^#([0-9a-f]{3}|[0-9a-f]{6})$/i,[U,...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==="watch"&&(e+1>=S.length||S[e+1].startsWith("--"))?s[n]=!0:s[n]=S[++e]}else s._.push(t)}const p=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 W(){s.icon&&!ie.includes(s.icon)&&i(`--icon takes one of: ${ie.join(", ")}`,2),s.color&&!Be.test(s.color)&&i("--color takes a CSS hex color, such as #3b82f6",2)}h(W,"checkLook");function Y(e){for(const t of["icon","color"])s[t]===""?delete e[t]:s[t]!==void 0&&(e[t]=s[t])}h(Y,"applyLook");const de=h(()=>s.hub&&s["no-hub"]&&i("pass --hub or --no-hub, not both",2),"checkHub"),le=h(e=>i(`/${e} is not a board; only a board can be the hub board`,2),"notBoard");function X(e,t,n){if(s["no-hub"]&&delete n.hub,!!s.hub){L(n)||le(t);for(const[r,d]of Object.entries(e.sites))r!==t&&d?.hub&&delete d.hub;n.hub=!0}}h(X,"applyHub");function k(){try{const e=JSON.parse(w.readFileSync(Re,"utf8"));return e.sites||={},e}catch(e){if(e.code==="ENOENT")return{version:1,sites:{}};i("manifest unreadable: "+e.message)}}h(k,"readManifest");const ue=h(e=>{try{return JSON.parse(w.readFileSync(e,"utf8"))}catch{return null}},"readJSON"),E=h(()=>import(u.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 fe(e){const{handshake:t}=await import(u.join(j,"hub","boards.mjs"));try{return await t(e,k())}catch(n){return i(n.message,2)}}h(fe,"runHandshake");async function Ae(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(d){return`not run (${d.message})`}if(!n.ok)return`not run (the hub answered ${n.status})`;const r=await n.json();if(r.checked?.includes(e))return"reached this board";if(r.failed?.length)return`missed this board: ${r.failed[0]}`}return"missed this board"}h(Ae,"pollFor");async function _(e){const{withManifestLock:t}=await import(u.join(j,"hub","boards.mjs"));try{return await t(e)}catch(n){throw n.code==="ELOCKED"&&i(n.message),n}}h(_,"withLock");function he(e){return new Promise(t=>{const n=se.connect({port:e,host:"127.0.0.1"}),r=h(d=>{n.destroy(),t(d)},"done");n.setTimeout(500,()=>r(!1)),n.on("connect",()=>r(!0)),n.on("error",()=>r(!1))})}h(he,"connects");function De(e){return new Promise(t=>{const n=se.createServer();n.once("error",()=>t(!1)),n.listen(e,"0.0.0.0",()=>n.close(()=>t(!0)))})}h(De,"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=G;n<G+400;n++)if(!t.has(n)&&!await he(n)&&await De(n))return n;i("no free port found from "+G)}h(H,"freePort");function Le(){try{return(JSON.parse(oe("tailscale",["status","--json"],{encoding:"utf8",stdio:["ignore","pipe","ignore"]})).Self?.DNSName||"").replace(/\.$/,"")}catch{return""}}h(Le,"tailnetHost");const Z=h(e=>{const t=Le();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 pe=h(e=>{try{return w.statSync(e).isDirectory()}catch{return!1}},"isFolder"),Pe=h(e=>{try{return w.realpathSync(e)}catch{return null}},"realPath");function me(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(me,"named");function we(e,{title:t,items:n,tickets:r}){w.mkdirSync(u.join(e,"data"),{recursive:!0});const d=u.join(e,"board.json"),a=w.existsSync(d)?JSON.parse(w.readFileSync(d,"utf8")):{};a.title=t,a.items=Ie(n||a.items||"waves"),r&&(a.tickets=r),w.writeFileSync(d,JSON.stringify(a,null,2)+`
+`);const o=a.items==="waves"?null:u.resolve(e,a.items);return o&&!w.existsSync(o)&&(w.mkdirSync(u.dirname(o),{recursive:!0}),w.writeFileSync(o,JSON.stringify({title:a.title,items:[]},null,2)+`
+`)),[K(),u.join(j,"board","server.mjs"),e]}h(we,"boardFiles");async function Q(e,t){const{startSession:n,withSessionLock:r}=await E();return r(e,async()=>{const d=await P(()=>n(e,{manifest:k(),...t}));return await _(async()=>{const a=k(),o={session:d.session,label:d.name,since:new Date().toISOString(),repo:d.repo,...d.model?{model:d.model}:{}};g(a.sites,e)?(a.sites[e].owner=o,a.sites[e].updated=o.since):a.starting={...a.starting,[e]:{...g(a.starting,e),...o}},await O(a)}),d})}h(Q,"startRecorded");async function z(e){const{hubSession:t}=await E(),n=await P(()=>t({manifest:k(),repo:e}));process.exitCode=n.status}h(z,"openHub");const V=h((e,...t)=>{const n=M("git",["-C",e,...t],{encoding:"utf8"});return n.status===0?n.stdout.trim():null},"git"),ge=h(()=>!!(process.stdin.isTTY&&process.stdout.isTTY),"canAsk");async function be(e){const t=Oe.createInterface({input:process.stdin,output:process.stdout});try{return(await t.question(e)).trim()}catch(n){throw n.code==="ABORT_ERR"&&i("stopped at the prompt; nothing changed"),n}finally{t.close()}}h(be,"ask");const ye=h((e,t)=>!!(g(e.sites,t)||g(e.starting,t)||g(e.closed,t)),"taken");function He(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.":ye(k(),F(e))?`/${F(e)} is taken; pick another name.`:null}h(He,"nameProblem");const ke="--template board --items data/wave.json";async function Je(){const e=V(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(([,f])=>L(f)&&f.owner?.repo&&Pe(f.owner.repo)===t);if(n)return ze(...n);const r=u.basename(t).replace(/[^A-Za-z0-9]+/g," ").trim();let d=s.name?.trim();for(d===void 0&&!ge()&&i('join needs --name "<Board name>" when it has no terminal to ask in',2);;){d===void 0&&(d=await be(`Board name${r?` (${r})`:""}: `)||r);const f=He(d);if(!f)break;s.name!==void 0&&i(f,2),p(f),d=void 0}const a=d.replace(/\s+/g," "),o=F(a),m=V(t,"remote","get-url","origin"),l=m?Ne(m):null,c=V(t,"symbolic-ref","--quiet","--short","HEAD"),{trustFolder:b}=await import("../hub/trust.mjs");try{b(t)}catch(f){i(`Couldn't trust this folder for Claude Code: ${f.message}`)}if(await _(async()=>{const f=k();ye(f,o)&&i(`/${o} is taken; pick another name`,2);const y=u.join(x,"sites",o),$=new Date().toISOString(),v={dir:y,port:await H(f),cmd:we(y,{title:a,items:"data/wave.json"}),watch:["data/events.jsonl"],title:a,local:!0,...l?{github:l}:{},...c?{branch:c}:{},owner:{repo:t},created:$,updated:$};f.sites={...f.sites,[o]:v},X(f,o,v),await O(f)}),p(`Made ${a} at ${Z(o)}, working in ${t}${l?` (${l})`:""}.`),s.hub)return p("It is the hub board, so its session runs in tmux, attached here."),z(t);try{await Q(o,{repo:t,prompt:ke})}catch(f){throw f instanceof I&&i(`${f.message}
+The board is made; run kickflip join here again to start its session.`,f.code),f}p("Its session is starting in the background, and joins the board shortly.")}h(Je,"joinFolder");async function ze(e,t){const n=t.title||e;p(`This folder already has a board: ${n} (/${e}).`),ge()||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 r=(await be("Restart its session? (Y/n) ")).toLowerCase();if(r&&!"yes".startsWith(r))return;if(!t.owner.session)return t.hub===!0?z(t.owner.repo):(await Q(e,{repo:t.owner.repo,prompt:ke}),p("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)}),a=await d.json();if(d.ok||i(a.error),p(`Restarted ${n}'s session.`),t.hub===!0)return z(t.owner.repo)}h(ze,"restartFolderBoard");const ee=["title","description","icon","color","created","watch","filter","hub","github","remote","branch","local"],Se=["notifications","polling","codexShare"],R="kickflip-board",qe=/^(\.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 je(e){const t=M("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(je,"tar");function Me(e,t){const n=e.entry.title||e.route,r=Object.keys(e.settings).map(d=>({notifications:"Notifications",polling:"Polling",codexShare:"Codex share"})[d]);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${r.length?`, and the hub's ${r.length>1?`${r.slice(0,-1).join(", ")} and ${r.at(-1)}`:r[0]} settings, which import writes over the new machine's`:""}.
+
+## On the new machine
+
+1. Install Git, Node 22+, Claude Code, gh and Tailscale, and turn on HTTPS certificates for the tailnet.
+2. Run \`npm i -g @lovek4d/kickflip\`, then \`kickflip init\`, and fix what its report marks yours.
+3. Run \`kickflip import ${t}\`. It refuses when /${e.route} already exists there.
+4. Start a fresh Claude Code session in the folder the board works in, and have it run the \`join\` line the import prints, with its own session id. \`--force\` takes the board over.
+5. Once the board answers there, stop its session on the old machine and run \`kickflip leave ${e.route} --force\` there, so only one session acts on its cards. Its files stay on the old machine.
+
+## Set up again
+
+The bundle carries no secret and nothing tied to the old machine. Set these up on the new machine:
+
+- GitHub sign-in: \`gh auth login\`.
+- Linear API key: Hub \u2192 Linear.
+- Slack: Claude's Slack connector in the new session, and the hub's Slack identity with \`board.mjs slack set --self-dm <D\u2026> --user <U\u2026>\`.
+- Codex: \`codex login\`, if Codex builds.
+- Notifications: open the Hub page on each phone and tap Turn on.
+- 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(Me,"exportReadme");async function Ke(){W();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(l=>typeof l=="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&&!pe(n)&&i(`--dir ${n} is not a folder`,2);const{route:r,title:d}=me(l=>g(k().sites,l)),a=await _(async()=>{const l=k();g(l.closed,r)&&i("That board is closed; use kickflip reopen "+r,2),g(l.starting,r)&&i(`/${r} is a board that is starting; pick another route`,2);const c=g(l.sites,r);if(c?.owner?.session)throw p({error:"owned",route:r,owner:c.owner,hint:"a session owns this route: pick another route, or that session leaves it first"}),new I("",3);const b=new Date().toISOString(),f=c?{...c}:{created:b};delete f.watch,delete f.filter;{const y=t?{cmd:t,dir:n||c?.dir||process.cwd(),port:e??(c?.cmd?c.port:void 0)??await H(l)}:e!==void 0?{port:e,...n?{dir:n}:{}}:{dir:n};for(const $ of["cmd","dir","port","cwd","env"])delete f[$];Object.assign(f,y)}return f.title=d,s.description&&(f.description=s.description),Y(f),f.updated=b,l.sites={...l.sites,[r]:f},await O(l),f}),o=a.cmd?"cmd":a.port?"port":"files",m=await J();p({route:r,url:Z(r),serves:o,...a.port?{port:a.port}:{},...a.dir?{dir:a.dir}:{},...o==="port"?{answering:await he(a.port)}:{},hub:m?"running":"NOT running: run `kickflip doctor --fix`"})}h(Ke,"joinPage");const te={async doctor(){s["dry-run"]&&!s.fix&&i("--dry-run needs --fix",2);const{exitCode:e}=await Ce({fix:!!s.fix,dryRun:!!s["dry-run"],json:!!s.json});process.exitCode=e},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 o=["port","dir","cmd"].some(l=>s[l]!==void 0),m=["watch","template","filter","label","model","repo","force","items",...o?["hub"]:[]].find(l=>s[l]!==void 0);return m&&i(`--${m} needs --session <id> (this session's id)`,2),o?Ke():Je()}const{route:e,title:t}=me(o=>g(k().sites,o));s.template&&s.template!=="board"&&i('--template takes "board"',2),W(),de();const n=await _(async()=>{const o=k();g(o.closed,e)&&i("That board is closed; use kickflip reopen "+e,2);const m=new Date().toISOString(),l=g(o.sites,e);if(l?.owner?.session&&l.owner.session!==s.session&&!s.force)throw p({error:"owned",route:e,owner:l.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):l?.cmd})&&le(e);const c=l?{...l}:{};let b=!1;if(l||(c.dir=u.resolve(s.dir||u.join(x,"sites",e)),(!w.existsSync(c.dir)||w.readdirSync(c.dir).length===0)&&!s.cmd&&!s.template&&(w.cpSync(u.join(j,"starter"),c.dir,{recursive:!0}),b=!0),c.port=s.port?Number(s.port):await H(o),c.cmd=s.cmd?JSON.parse(s.cmd):[K(),u.join(c.dir,"server.mjs")],c.watch=["data/events.jsonl"],c.created=m),s.dir&&l&&(c.dir=u.resolve(s.dir)),s.port&&l&&(c.port=Number(s.port)),s.cmd&&l&&(c.cmd=JSON.parse(s.cmd)),s.template==="board"){const N=g(o.starting,e),$e=!l&&N?.tickets&&(!N.session||N.session===s.session)?N.tickets:void 0;c.cmd=we(c.dir,{title:t,items:s.items,tickets:$e}),b=!l}c.title=t,s.description&&(c.description=s.description),typeof s.watch=="string"&&(c.watch=s.watch.split(",").map(N=>N.trim()).filter(Boolean)),s.filter!==void 0&&(c.filter=s.filter||void 0),Y(c),X(o,e,c);const f=l?.owner&&l.owner.session!==s.session?l.owner:null,y=g(o.starting,e)?.session===s.session?g(o.starting,e):null,$=g(o.starting,e);!l&&($?.github||$?.remote)&&(!$.session||$.session===s.session)&&($.github?c.github=$.github:c.remote=$.remote,c.branch=$.branch);const v=l?.owner?.session===s.session?l.owner:null,A=v||y||f;c.owner={...v||{session:s.session,since:m},label:s.label||A?.label||"",repo:s.repo?u.resolve(s.repo):(c.github||c.remote)&&A?.repo||re().get(s.session)?.cwd||A?.repo||process.cwd()};const ne=s.model||A?.model;return ne&&(c.owner.model=ne),g(o.starting,e)&&(delete o.starting[e],Object.keys(o.starting).length||delete o.starting),c.updated=m,o.sites={...o.sites,[e]:c},await O(o),{route:e,created:b,previousOwner:f,site:c}}),r=await J();let d,a;if(s.template==="board"){const o=ue(u.join(n.site.dir,"data","handshake.json"));d=o?.ack&&o.hello?.session===s.session?"answered before":await fe(e),a=r?await Ae(e):"not run (the hub is not running)"}p({route:e,url:Z(e),dir:n.site.dir,port:n.site.port,owner:n.site.owner,createdFromStarter:n.created,previousOwner:n.previousOwner,log:u.join(ce,e+".log"),watcher:Fe(e,s.session,j),hub:r?"running":"NOT running: run `kickflip doctor --fix`",...d?{handshake:d}:{},...a?{poll:a}:{}})},async handshake(){const e=s._[0];e||i("handshake needs a route",2),p(await fe(e))},async leave(){const e=s._[0];e||i("leave needs a route",2),await _(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 p({error:"owned",route:e,owner:n.owner}),new I("",3);delete t.sites[e],await O(t),p({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 Q(e,{repo:s.repo,model:s.model,prompt:s.prompt});p({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();p(await P(()=>t(e,{manifest:k()})))},async close(){const{closeBoard:e}=await import("../hub/close-board.mjs");try{p(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{p(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 r=w.realpathSync(n.dir),{itemSources:d,openBoardBuilders:a}=await import("../board/store.mjs"),o=(await d(r)).find(y=>u.relative(r,y.file).startsWith(".."));o&&i(`/${e}'s cards live outside its folder (${o.file}); export moves only a board whose board.json items is a file in its folder`);const m=await a(r);m.length&&i(`a builder is open on /${e}: ${m.map(y=>`${y.key} (${y.label})`).join(", ")}; export once it is done`);const{readSettingsFile:l}=await import("../hub/push.mjs"),c=B(n,ee),b={kickflip_export:1,route:e,exported_at:new Date().toISOString(),from:D.hostname(),entry:c,owner:B(n.owner||{},["label","model"]),settings:B(l(),Se),dropped:Object.keys(n).filter(y=>!ee.includes(y))},f=w.mkdtempSync(u.join(D.tmpdir(),"kickflip-export-"));try{const y=u.join(f,R),$=u.join(r,"data");w.cpSync(r,u.join(y,"site"),{recursive:!0,filter:h(v=>!(u.dirname(v)===$&&qe.test(u.basename(v))),"filter")}),w.writeFileSync(u.join(y,"export.json"),JSON.stringify(b,null,2)+`
+`),w.writeFileSync(u.join(y,"README.md"),Me(b,u.basename(t))),je(["-czf",t,"-C",f,R])}finally{w.rmSync(f,{recursive:!0,force:!0})}p({route:e,file:t,entry:Object.keys(c),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(x,{recursive:!0});const t=w.mkdtempSync(u.join(x,".import-"));try{je(["-xzf",e,"-C",t]);const n=ue(u.join(t,R,"export.json"));(n?.kickflip_export!==1||!C(n.route)||!pe(u.join(t,R,"site")))&&i(`${e} is not a kickflip export`,2);const{route:r}=n,d=u.join(x,"sites",r),a=await _(async()=>{const c=k();(g(c.sites,r)||g(c.closed,r)||g(c.starting,r))&&i(`/${r} already exists on this host; import never replaces a board`),w.existsSync(d)&&i(`${d} already exists; import never replaces a board's folder`);const b=B(n.entry||{},ee);b.hub&&Object.values(c.sites).some(y=>y?.hub)&&delete b.hub;const f={...b,dir:d,port:await H(c),cmd:[K(),u.join(j,"board","server.mjs"),d],updated:new Date().toISOString()};return w.mkdirSync(u.dirname(d),{recursive:!0}),w.renameSync(u.join(t,R,"site"),d),c.sites={...c.sites,[r]:f},await O(c),f}),o=B(n.settings||{},Se);if(Object.keys(o).length){const{readSettingsFile:c,writeSettingsFile:b}=await import("../hub/push.mjs");b({...c(),...o})}const{label:m,model:l}=n.owner||{};p({route:r,dir:d,port:a.port,settings:Object.keys(o),hub:a.hub===!0,join:`kickflip join --name ${q(_e(r,a.title))} --session <this session's id> --watch --template board${m?` --label ${q(m)}`:""}${l?` --model ${q(l)}`:""} --force`})}finally{w.rmSync(t,{recursive:!0,force:!0})}},async sessions(){const{sessionOf:e}=await E(),{listBoards:t}=await import(u.join(j,"hub","boards.mjs")),n=k(),r=re(),a=[...t(n).map(o=>o.route),...Object.keys(n.starting||{}).filter(o=>!g(n.sites,o))].map(o=>{const m=e(n,o),l=m&&r.get(m.session);return{route:o,session:m?.session||null,live:l?l.kind==="bg"?"background":"terminal":null,repo:m?.repo||null,starting:!g(n.sites,o)}});if(s.json)return p(a);if(!a.length)return p("no boards");for(const o of a)p(`/${o.route}  ${o.session||"no session"}  ${o.live?`live (${o.live})`:"not live"}  ${o.repo||"no folder"}${o.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),W(),de(),await _(async()=>{const t=k(),n=g(t.sites,e)||i("no site at /"+e);Y(n),X(t,e,n),n.updated=new Date().toISOString(),await O(t),p({route:e,icon:n.icon??null,color:n.color??null,hub:n.hub===!0})})},async restart(){const e=s._[0];await _(async()=>{const t=k();g(t.sites,e)||i("no site at /"+e),t.sites[e].restart_at=Date.now(),await O(t)}),p(`restarting /${e}; the hub picks it up within 2 seconds`)},async logs(){const e=s._[0],t=u.join(ce,e+".log");w.existsSync(t)||i("no log yet for /"+e);const n=Number(s.lines||40);p(w.readFileSync(t,"utf8").split(`
+`).slice(-n-1).join(`
+`))},async init(){s.fix=!0,await te.doctor()},async update(){w.existsSync(u.join(j,".git"))&&i(`${j} is a clone; update it with git pull`,2);const e=M("npm",["i","-g","@lovek4d/kickflip@latest"],{stdio:"inherit"});e.status!==0&&i(`npm update failed${e.error?": "+e.error.message:""}`);const t=ae(),n=t.restart();n&&i(`update finished but the hub did not restart: ${n}; run ${t.restartCommand}`),p("updated kickflip and restarted the hub")},async uninstall(){Te()&&p(`removed ${u.join(D.homedir(),".claude","statusline.sh")}`);const e=ae();e.remove();try{oe("tailscale",["serve","--https=443","--set-path=/","off"],{stdio:"ignore"})}catch{}p(`hub stopped and removed from ${e.manager??"the host"}; tailscale / unmapped. The manifest and sites are kept in ${x}`)},async push(){const{deliver:e,pushKindError:t}=await import(u.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:r,holdLine:d}=await import(u.join(j,"hub","schedule.mjs"));s.now&&s.urgent&&i("pass --now or --urgent, not both",2);const a=await e({title:s.title,body:s.body||"",url:s.url||"/",tag:s.tag},{kind:s.kind,urgent:!!s.urgent,immediate:!!s.now});if(a.noDevice&&i("no device has turned on notifications; open Hub \u2192 Notifications (/_hub/#notifications) in the Home Screen app and tap Turn on",3),a.dropped)return p("dropped (notifications are off on the Hub page)");if(a.queued){const{count:o,replaced:m,nextFlushAt:l,hold:c,sendFailed:b}=a.queued,f=s.now?c?`${d(c)}; `:b?"no device took it now; ":"":"";p(`queued (${f}${o} in queue${m?"; replaced the queued push with this tag":""}); next send ${r(l)}${l instanceof Date?` (${l.toISOString()})`:""}`),await J()||p("warning: the hub is not running, so the queue goes out only once it runs");return}p(a.sent),a.sent.some(o=>o.status>=200&&o.status<300)||i("every push was refused",1),p(s.urgent?"sent (urgent)":"sent")},async polling(){const{readSettings:e}=await import(u.join(j,"hub","push.mjs")),{windowAt:t,nextSlot:n,hold:r}=await import(u.join(j,"hub","schedule.mjs")),d=new Date,a=e(),o=t(d,a),m=r(d,a);p({every:o.every_minutes,until:o.endsAt.toISOString(),next:n(d,a).toISOString(),held:m!==null,held_until:m?m.until instanceof Date?m.until.toISOString():m.until:null,held_why:m?.why??null,notifications:a.notifications})},async notifications(){const{setNotifications:e,readSettings:t}=await import(u.join(j,"hub","push.mjs")),[n,r]=s._,a=n===void 0?null:n==="on"||n==="off"?{on:n==="on"}:n==="weekends"?{weekends_off:h((m,l)=>m==="on"?!0:m==="off"?!1:i(`${l} takes on or off`,2),"onOff")(r,"weekends")}:n==="snooze"?{snooze:r||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(!a)return p(t().notifications);let o;try{o=await e(a)}catch(m){throw m.status===400&&i(m.message,2),m}p(o.dropped?{...o.notifications,dropped:o.dropped}:o.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(u.join(j,"hub","push.mjs"));if(!S.length)return p(t());try{p(n(S[0]))}catch(r){throw r.status===400&&i(r.message,2),r.status===409&&i(r.message),r}},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)),p(e())}catch(r){throw r.status&&i(r.message,r.status===400?2:1),r}},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)}`),p(await e.json())}};if(!te[U]){const e=w.readFileSync(xe(import.meta.url),"utf8").split(`
+`).slice(1);p(e.slice(0,e.findIndex(t=>!t.startsWith("//"))).map(t=>t.replace(/^\/\/ ?/,"")).join(`
+`)),process.exit(U?2:0)}try{await te[U]()}catch(e){if(!(e instanceof I))throw e;e.message&&console.error("kickflip: "+e.message),process.exit(e.code)}

package/bin/statusline.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
-var d=Object.defineProperty;var s=(e,t)=>d(e,"name",{value:t,configurable:!0});import c from"node:fs";import f from"node:os";import m from"node:path";import{execFileSync as _}from"node:child_process";import{migrateOnStart as g}from"./install.mjs";process.stdout.on("error",()=>{});function h(e){if(!e)return"";const t=s((...r)=>_("git",["-C",e,...r],{encoding:"utf8",stdio:["ignore","pipe","ignore"],timeout:500,env:{...process.env,GIT_OPTIONAL_LOCKS:"0"}}).trim(),"git");try{if(t("rev-parse","--is-inside-work-tree")!=="true")return"";const r=t("symbolic-ref","--short","HEAD");try{t("diff","--quiet"),t("diff","--cached","--quiet")}catch{return r+"*"}return r}catch{return""}}s(h,"branchOf");function S(e){if(!e)return"";const t=f.homedir(),r=e===t?"~":e.startsWith(t+"/")?"~"+e.slice(t.length):e,n=r.split("/");return n.length>2?n.slice(-2).join("/"):r}s(S,"shortDir");function b(e){if(e==null||e==="")return null;const t=typeof e=="number"||/^\d+(\.\d+)?$/.test(String(e)),r=Number(e),n=t?r>1e12?r:r*1e3:Date.parse(String(e));return Number.isFinite(n)&&Number.isFinite(new Date(n).getTime())?new Date(n).toISOString():null}s(b,"isoOf");function p(e){if(!e||typeof e!="object")return null;const t=e.used_percentage;return{used_percentage:t==null||t===""||!Number.isFinite(Number(t))?null:Number(t),resets_at:b(e.resets_at),resets_at_raw:e.resets_at??null}}s(p,"windowOf");function N(e){const t=e.rate_limits;if(!t||typeof t!="object"||Array.isArray(t))return;const r=m.join(f.homedir(),".claude","kickflip","usage.json");let n={};try{const o=JSON.parse(c.readFileSync(r,"utf8"));o&&typeof o=="object"&&!Array.isArray(o)&&(n=o)}catch{}const l={five_hour:p(t.five_hour),seven_day:p(t.seven_day),at:new Date().toISOString(),...e.session_id?{session:e.session_id}:{}};c.mkdirSync(m.dirname(r),{recursive:!0});const a=`${r}.${process.pid}.tmp`;try{c.writeFileSync(a,JSON.stringify({...n,claude:l},null,2)+`
-`,{mode:384}),c.renameSync(a,r)}finally{try{c.unlinkSync(a)}catch{}}}s(N,"saveUsage");try{const e=JSON.parse(c.readFileSync(0,"utf8"));if(e&&typeof e=="object"&&!Array.isArray(e)){const t=typeof e.cwd=="string"?e.cwd:"",r=typeof e.model?.display_name=="string"?e.model.display_name:"",n=s(i=>i==null||i===""||!Number.isFinite(Number(i))?null:Math.floor(Number(i)),"percent"),l=n(e.context_window?.used_percentage),a=[["5h",e.rate_limits?.five_hour],["7d",e.rate_limits?.seven_day]].map(([i,u])=>[i,n(u?.used_percentage)]).filter(([,i])=>i!=null).map(([i,u])=>`${i}: ${u}%`).join(" / "),o=s((i,u)=>i.filter(Boolean).join(u),"join"),y=o([o([S(t),h(t)]," "),o([r,l==null?"":`${l}% ctx`]," / "),a]," \xB7 ");process.stdout.write(y+`
-`,()=>{try{g(),N(e)}catch{}})}}catch{}process.exitCode=0;
+var d=Object.defineProperty;var s=(e,t)=>d(e,"name",{value:t,configurable:!0});import o from"node:fs";import m from"node:os";import f from"node:path";import{execFileSync as h}from"node:child_process";process.stdout.on("error",()=>{});function _(e){if(!e)return"";const t=s((...r)=>h("git",["-C",e,...r],{encoding:"utf8",stdio:["ignore","pipe","ignore"],timeout:500,env:{...process.env,GIT_OPTIONAL_LOCKS:"0"}}).trim(),"git");try{if(t("rev-parse","--is-inside-work-tree")!=="true")return"";const r=t("symbolic-ref","--short","HEAD");try{t("diff","--quiet"),t("diff","--cached","--quiet")}catch{return r+"*"}return r}catch{return""}}s(_,"branchOf");function g(e){if(!e)return"";const t=m.homedir(),r=e===t?"~":e.startsWith(t+"/")?"~"+e.slice(t.length):e,n=r.split("/");return n.length>2?n.slice(-2).join("/"):r}s(g,"shortDir");function S(e){if(e==null||e==="")return null;const t=typeof e=="number"||/^\d+(\.\d+)?$/.test(String(e)),r=Number(e),n=t?r>1e12?r:r*1e3:Date.parse(String(e));return Number.isFinite(n)&&Number.isFinite(new Date(n).getTime())?new Date(n).toISOString():null}s(S,"isoOf");function y(e){if(!e||typeof e!="object")return null;const t=e.used_percentage;return{used_percentage:t==null||t===""||!Number.isFinite(Number(t))?null:Number(t),resets_at:S(e.resets_at),resets_at_raw:e.resets_at??null}}s(y,"windowOf");function b(e){const t=e.rate_limits;if(!t||typeof t!="object"||Array.isArray(t))return;const r=f.join(m.homedir(),".claude","kickflip","usage.json");let n={};try{const u=JSON.parse(o.readFileSync(r,"utf8"));u&&typeof u=="object"&&!Array.isArray(u)&&(n=u)}catch{}const a={five_hour:y(t.five_hour),seven_day:y(t.seven_day),at:new Date().toISOString(),...e.session_id?{session:e.session_id}:{}};o.mkdirSync(f.dirname(r),{recursive:!0});const c=`${r}.${process.pid}.tmp`;try{o.writeFileSync(c,JSON.stringify({...n,claude:a},null,2)+`
+`,{mode:384}),o.renameSync(c,r)}finally{try{o.unlinkSync(c)}catch{}}}s(b,"saveUsage");function N(e,t){const r=e.session_id;if(t==null||typeof r!="string"||!/^[\w-]+$/.test(r))return;const n=f.join(m.homedir(),".claude","kickflip","context"),a=f.join(n,`${r}.json`);o.mkdirSync(n,{recursive:!0});const c=`${a}.${process.pid}.tmp`;try{o.writeFileSync(c,JSON.stringify({percent:t,at:new Date().toISOString()})+`
+`,{mode:384}),o.renameSync(c,a)}finally{try{o.unlinkSync(c)}catch{}}}s(N,"saveContext");try{const e=JSON.parse(o.readFileSync(0,"utf8"));if(e&&typeof e=="object"&&!Array.isArray(e)){const t=typeof e.cwd=="string"?e.cwd:"",r=typeof e.model?.display_name=="string"?e.model.display_name:"",n=s(i=>i==null||i===""||!Number.isFinite(Number(i))?null:Math.floor(Number(i)),"percent"),a=n(e.context_window?.used_percentage),c=[["5h",e.rate_limits?.five_hour],["7d",e.rate_limits?.seven_day]].map(([i,l])=>[i,n(l?.used_percentage)]).filter(([,i])=>i!=null).map(([i,l])=>`${i}: ${l}%`).join(" / "),u=s((i,l)=>i.filter(Boolean).join(l),"join"),p=u([u([g(t),_(t)]," "),u([r,a==null?"":`${a}% ctx`]," / "),c]," \xB7 ");process.stdout.write(p+`
+`,()=>{try{b(e)}catch{}try{N(e,a)}catch{}})}}catch{}process.exitCode=0;

package/bin/wait-events.mjs

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-var $=Object.defineProperty;var d=(e,n)=>$(e,"name",{value:n,configurable:!0});import i from"node:fs";import a from"node:path";import x from"node:os";import{routeRecord as y}from"../hub/routes.mjs";import{readHubRules as J,rulesOf as E,ruleLines as T}from"../hub/rules.mjs";import{boardAt as H,linksOf as I,hubLink as L}from"../hub/boards.mjs";import{settingsLines as R,settingsOf as A}from"../board/store.mjs";import{migrateOnStart as D}from"./install.mjs";import{readUsageGate as v,heldUsageEvent as G}from"../shared/usage-gate.mjs";const[k,h]=process.argv.slice(2);(!k||!h)&&(console.error("usage: wait-events.mjs <route> <session-id>"),process.exit(2)),D();const P=a.join(x.homedir(),".claude","kickflip","manifest.json");function F(){try{return y(JSON.parse(i.readFileSync(P,"utf8")).sites,k)||null}catch{return}}d(F,"site");function w(e){const n=e.filter?new RegExp(e.filter):null,c=Object.create(null);for(const m of e.watch||["data/events.jsonl"]){let o=[];try{o=i.readFileSync(a.resolve(e.dir,m),"utf8").split(`
-`).filter(Boolean)}catch{}c[m]=n?o.filter(s=>n.test(s)):o}return c}d(w,"matching");const p=F();p||(console.log("site-removed"),process.exit(0));const u=a.resolve(p.dir,"data",`.watch-cursor-${h}.json`),b=a.resolve(p.dir,"data","watcher.json");try{i.mkdirSync(a.dirname(u),{recursive:!0}),i.writeFileSync(b,JSON.stringify({pid:process.pid,since:new Date().toISOString()}))}catch{}process.on("exit",()=>{try{const e=JSON.parse(i.readFileSync(b,"utf8"));e.pid===process.pid&&i.writeFileSync(b,JSON.stringify({...e,exited_at:new Date().toISOString()}))}catch{}});let f;try{f=JSON.parse(i.readFileSync(u,"utf8"))}catch{}for(f||(f=Object.fromEntries(Object.entries(w(p)).map(([e,n])=>[e,n.length])),i.mkdirSync(a.dirname(u),{recursive:!0}),i.writeFileSync(u,JSON.stringify(f)));;){await new Promise(o=>setTimeout(o,2e3));const e=F();if(e===void 0)continue;e===null&&(console.log("site-removed"),process.exit(0)),e.owner?.session&&e.owner.session!==h&&(console.log("handed-over "+JSON.stringify(e.owner)),process.exit(0));const n=d(o=>Object.fromEntries(Object.entries(o).map(([s,g])=>[s,[...y(f.$usageHeld,s)||[],...g.slice(y(f,s)||0)]])),"pending"),c=d((o,s)=>s.state!=="paused"||!G(o),"eligible"),m=v();if(Object.values(n(w(e))).some(o=>o.some(s=>c(s,m)))){await new Promise(t=>setTimeout(t,2e3));const o=w(e),s=v(),g=n(o);if(!Object.values(g).some(t=>t.some(r=>c(r,s))))continue;const O=Object.create(null);for(const[t,r]of Object.entries(g)){O[t]=r.filter(S=>!c(S,s));for(const S of r.filter(N=>c(N,s)))console.log(`event ${t} ${S}`)}let l=null;try{l=JSON.parse(i.readFileSync(a.resolve(e.dir,"board.json"),"utf8"))}catch(t){t.code!=="ENOENT"&&(l={})}if(l)for(const t of T(J(),E(l)))console.log(`rule ${t}`);if(l)for(const t of R(A(l)))console.log(t);s.state==="paused"&&console.log(`usage paused ${s.resets_at} ${s.window} ${s.used}%`);try{const t=l&&H(e.dir);if(t)for(const r of[...I(t,{listen:"listening"}),L()])r.ok||console.log(`link ${r.link} ${r.detail}`)}catch(t){console.log(`link registry could not check the links (${t.message})`)}const j=Object.fromEntries(Object.entries(o).map(([t,r])=>[t,r.length]));Object.values(O).some(t=>t.length)&&(j.$usageHeld=O),i.writeFileSync(u,JSON.stringify(j)),process.exit(0)}}
+var A=Object.defineProperty;var o=(e,r)=>A(e,"name",{value:r,configurable:!0});import c from"node:fs";import f from"node:path";import I from"node:os";import{routeRecord as g}from"../hub/routes.mjs";import{readHubRules as L,rulesOf as R,ruleLines as q}from"../hub/rules.mjs";import{boardAt as D,linksOf as H,hubLink as U}from"../hub/boards.mjs";import{ackHello as _,cardName as G,markWorking as P,settingsLines as W,settingsOf as K,WORKING_KINDS as Q}from"../board/store.mjs";import{readUsageGate as F,heldUsageEvent as B}from"../shared/usage-gate.mjs";const[J,$]=process.argv.slice(2);(!J||!$)&&(console.error("usage: wait-events.mjs <route> <session-id>"),process.exit(2));const C=f.join(I.homedir(),".claude","kickflip","manifest.json");function x(){try{return g(JSON.parse(c.readFileSync(C,"utf8")).sites,J)||null}catch{return}}o(x,"site");function O(e){const r=e.filter?new RegExp(e.filter):null,n=Object.create(null);for(const d of e.watch||["data/events.jsonl"]){let s=[];try{s=c.readFileSync(f.resolve(e.dir,d),"utf8").split(`
+`).filter(Boolean)}catch{}n[d]=r?s.filter(i=>r.test(i)):s}return n}o(O,"matching");const M=`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: name cards by label (#96), never "below", "above", "here" or "this session".`,E={ask:o(e=>`new task ${e.id} received`,"ask"),"owner-answer":o(e=>`answer received to question ${e.data?.id}`,"owner-answer"),hello:o(e=>`hello ${e.id} from the hub answered`,"hello"),"todo-triage":o(e=>`Todo triage ${e.data?.date} asked: the board was idle`,"todo-triage")},T={"item-message":o(e=>`message received from ${e}'s thread`,"item-message"),"card-build":o(e=>`build started on ${e}`,"card-build"),"card-merge":o(e=>`merge asked on ${e}`,"card-merge"),"card-done":o(e=>`${e} marked done`,"card-done"),"card-bump":o(e=>`${e} bumped`,"card-bump"),"ask-bump":o(e=>`${e} bumped`,"ask-bump"),"ask-edited":o(e=>`${e} edited`,"ask-edited"),"ask-done":o(e=>`${e} marked done`,"ask-done"),"ask-withdrawn":o(e=>`${e} deleted`,"ask-withdrawn"),"card-hold":o((e,r)=>`${e} ${r.data?.hold?"held":"resumed"}`,"card-hold"),"card-unblocked":o(e=>`${e} unblocked`,"card-unblocked"),"card-pull":o(e=>`${e} pulled in`,"card-pull"),"card-plan":o(e=>`plan asked on ${e}`,"card-plan"),"prototype-request":o(e=>`prototype asked on ${e}`,"prototype-request")};async function z(e,r){let n;try{n=JSON.parse(r)}catch{return null}if(typeof n?.kind!="string")return null;const d=typeof n.data?.key=="string"?n.data.key:n.kind.startsWith("ask-")&&typeof n.data?.id=="string"?`ask:${n.data.id}`:null,s=d&&await G(e,d).catch(()=>d);return g(E,n.kind)?E[n.kind](n):s&&g(T,n.kind)?T[n.kind](s,n):s?`${n.kind} on ${s}`:`${n.kind} received`}o(z,"plainLine");const y=x();y||(console.log("site-removed"),process.exit(0));const h=f.resolve(y.dir,"data",`.watch-cursor-${$}.json`),S=f.resolve(y.dir,"data","watcher.json");try{c.mkdirSync(f.dirname(h),{recursive:!0}),c.writeFileSync(S,JSON.stringify({pid:process.pid,since:new Date().toISOString()}))}catch{}process.on("exit",()=>{try{const e=JSON.parse(c.readFileSync(S,"utf8"));e.pid===process.pid&&c.writeFileSync(S,JSON.stringify({...e,exited_at:new Date().toISOString()}))}catch{}});let m;try{m=JSON.parse(c.readFileSync(h,"utf8"))}catch{}for(m||(m=Object.fromEntries(Object.entries(O(y)).map(([e,r])=>[e,r.length])),c.mkdirSync(f.dirname(h),{recursive:!0}),c.writeFileSync(h,JSON.stringify(m)));;){await new Promise(s=>setTimeout(s,2e3));const e=x();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));const r=o(s=>Object.fromEntries(Object.entries(s).map(([i,k])=>[i,[...g(m.$usageHeld,i)||[],...k.slice(g(m,i)||0)]])),"pending"),n=o((s,i)=>i.state!=="paused"||!B(s),"eligible"),d=F();if(Object.values(r(O(e))).some(s=>s.some(i=>n(i,d)))){await new Promise(t=>setTimeout(t,2e3));const s=O(e),i=F(),k=r(s);if(!Object.values(k).some(t=>t.some(a=>n(a,i))))continue;const b=Object.create(null),v=[],j=[];for(const[t,a]of Object.entries(k)){b[t]=a.filter(p=>!n(p,i));for(const p of a.filter(w=>n(w,i))){console.log(`event ${t} ${p}`);const w=await z(e.dir,p);w&&console.log(w);try{const u=JSON.parse(p);Q.includes(u.kind)&&typeof u.id=="string"&&v.push(u.id),u.kind==="hello"&&typeof u.id=="string"&&j.push(u.id)}catch{}}}let l=null;try{l=JSON.parse(c.readFileSync(f.resolve(e.dir,"board.json"),"utf8"))}catch(t){t.code!=="ENOENT"&&(l={})}if(l&&await P(e.dir,v).catch(t=>console.log(`working marks not written (${t.message})`)),l)for(const t of j)await _(e.dir,t).catch(a=>console.log(`hello ${t} not answered (${a.message})`));if(l)for(const t of q(L(),R(l)))console.log(`rule ${t}`);if(l)for(const t of W(K(l)))console.log(t);l&&console.log(M),i.state==="paused"&&console.log(`usage paused ${i.resets_at} ${i.window} ${i.used}%`);try{const t=l&&D(e.dir);if(t)for(const a of[...H(t,{listen:"listening"}),U()])a.ok||console.log(`link ${a.link} ${a.detail}`)}catch(t){console.log(`link registry could not check the links (${t.message})`)}const N=Object.fromEntries(Object.entries(s).map(([t,a])=>[t,a.length]));Object.values(b).some(t=>t.length)&&(N.$usageHeld=b),c.writeFileSync(h,JSON.stringify(N)),process.exit(0)}}

package/board/arch-review.mjs

@@ -0,0 +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 q}from"../hub/board-repo.mjs";import{samePath as J}from"../hub/boards.mjs";import{cloneRoot as P}from"../shared/repos.mjs";import{readUsageGate as T,pauseReason as U}from"../shared/usage-gate.mjs";import{reviewWaits as W}from"../shared/skills.mjs";import{BoardError as O,addItem as x,appendThread as _,boardConfig as K,cardName as N,changeLineup as Q,createLineup as G,itemSources as F,parseKey as H,readJSON as A,resolveQuestion as E,setItem as M,startBuilder as X,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"),z={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"]},V=r(({github:e,repo:n})=>(e?e.split("/").pop():g.basename(n||""))||"this repo","repoName");function pe(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"&&i.status!=="dropped").length}},"view");return{repo:d,waits:h,last:[...e].reverse().map(o).find(Boolean)||null}}r(pe,"archOf");const Y=r(e=>e.toLocaleDateString("en-CA").replaceAll("-",""),"stampOf"),Z=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 ee=r(e=>{throw new O(e)},"fail"),te=r(e=>v.stat(e).then(()=>!0,()=>!1),"exists");async function fe(e,n,{now:s=new Date,home:d=L.homedir()}={}){const h=W(d);if(h)throw Object.assign(new O(h),{status:409});const p=T({home:d});if(p.state==="paused")throw Object.assign(new O(U(p)),{status:409});const o=q(n.route),a=V(o),u=`Architecture ${Z(s)}`,t=`arch-${Y(s)}`,c=await F(e),i=(await K(e)).items==="waves";let f,w=null,l;if(i){f=await D(t,S=>te(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 G(e,w,{title:u,goal:`Act on the architecture review of ${a}`,cards: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 X(e,l,{label:"Architecture review"}),await _(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&&J(o.repo,P())?{scope:z}:{}};return{key:l,data:m}}r(fe,"startReview");async function we(e,n){const s=(await C(e)).find(t=>t.key===n)||ee(`${n} is not an architecture review's audit card`),{wave:d}=H(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 Q(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 M(e,n,{status:"done",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(we,"fileFindings");export{z as HUB_SCOPE,pe as archOf,we as fileFindings,C as readReviews,V as repoName,fe as startReview};