@lovek4d/kickflip 0.1.0 → 0.3.1

package/board/store.mjs

@@ -1,7 +1,15 @@
-var _e=Object.defineProperty;var s=(t,e)=>_e(t,"name",{value:e,configurable:!0});import S from"node:fs/promises";import{constants as Pe}from"node:fs";import f from"node:path";import $t from"node:os";import{ITEM_STATUSES as Mt,ownerQuestion as Jt,refOf as Te}from"./domain.mjs";import{appendEvent as Ht,listBoards as zt,samePath as Kt}from"../hub/boards.mjs";import{readUsageGate as Ee,pauseReason as Le}from"../shared/usage-gate.mjs";import{dropQueued as Qt,reviseQueued as Be,flushQueue as Fe,queueStatus as Ne}from"../hub/push.mjs";import{holdLine as Ce}from"../hub/schedule.mjs";import{routeRecord as W}from"../hub/routes.mjs";import{ticketSource as yt,ticketIn as gt,resolveTicket as qe,ticketTarget as Ue,moveTicket as We,titleTickets as Ie,mcpCreateLine as Me}from"./tickets.mjs";import{withFileLock as Je}from"../hub/locks.mjs";import"../bin/install.mjs";import{RuleError as He,rulesOf as Zt,addRule as ze,editRule as Ke,removeRule as Qe,applyRules as Ze,readHubRules as nt,writeHubRules as Ye}from"../hub/rules.mjs";class I extends Error{static{s(this,"BoardError")}}const c=s(t=>{throw new I(t)},"fail"),Ge=s(()=>f.join($t.homedir(),".claude","kickflip","sites"),"sitesDir"),at=s(()=>f.join($t.homedir(),".claude","waves"),"wavesDir"),g=s(async(t,e)=>{try{return JSON.parse(await S.readFile(t,"utf8"))}catch{return e}},"readJSON"),R=s(async t=>{try{return(await S.readFile(t,"utf8")).split(`
-`).filter(Boolean).map(e=>JSON.parse(e))}catch{return[]}},"readLines");async function Yt(t,e){await S.mkdir(f.dirname(t),{recursive:!0});const a=`${t}.${process.pid}.tmp`;await S.writeFile(a,e),await S.rename(a,t)}s(Yt,"replace");const k=s((t,e)=>Yt(t,JSON.stringify(e,null,2)+`
-`),"writeJSON");async function K(t,e){await S.mkdir(f.dirname(t),{recursive:!0}),await S.appendFile(t,JSON.stringify(e)+`
-`)}s(K,"appendLine");async function Zn(t){/^[\w-]+$/.test(t||"")||c(`--site takes a route such as ios-orchestrator, not "${t}"`);const e=f.join(Ge(),t);return await S.stat(e).then(a=>a.isDirectory(),()=>!1)||c(`no site at ${e}`),e}s(Zn,"siteDir");const it=s(async t=>({title:"Board",items:"waves",...t?await g(f.join(t,"board.json"),{}):{}}),"boardConfig");async function F(t){const e=await it(t);if(e.items==="waves")try{return(await S.readdir(at(),{withFileTypes:!0})).filter(n=>n.isDirectory()).map(n=>({slug:n.name,dir:f.join(at(),n.name),file:f.join(at(),n.name,"wave.json")}))}catch{return[]}const a=f.resolve(t,e.items);return[{slug:e.slug||f.basename(e.items,".json"),dir:f.dirname(a),file:a}]}s(F,"itemSources");const M=s((t,e)=>f.join(t,"data","threads",e.replace(/[^\w.-]+/g,"__")+".jsonl"),"threadFile"),D=s(t=>f.join(t,"data","owner.json"),"ownerFile"),v=s(t=>t||c("this command needs --site <route>"),"needSite"),x=s((t,e)=>typeof t=="string"&&t.trim()?t.trim():c(`${e} must be non-empty text`),"text"),_=s((t,e)=>t===void 0?void 0:e(t),"optional"),Xe=/^prototype-[\w-]+\.html(?:[?#]\S*)?$/,Gt=s((t,e)=>typeof t=="string"&&(Xe.test(t)||/^https?:\/\/\S+$/.test(t))?t:c(`${e} must be an http(s) URL or a site page such as prototype-<topic>.html?q=<id>`),"pageUrl"),kt=s((t,e)=>typeof t=="boolean"?t:c(`${e} must be true or false`),"bool"),P=s((t,e)=>typeof t=="string"&&/^[\w.-]+$/.test(t)?t:c(`${e} must use only letters, digits, "_", "." and "-"`),"domId"),Q=s((t,e,a)=>{(!t||typeof t!="object"||Array.isArray(t))&&c(`${a} must be a JSON object`);const n=Object.keys(t).filter(i=>!e.includes(i));n.length&&c(`${a} has unknown field ${n.map(i=>`"${i}"`).join(", ")}; allowed: ${e.join(", ")}`)},"onlyKeys");function T(t){const e=/^([^/\s]+)\/([^/\s]+)$/.exec(t||"");return e?{wave:e[1],id:e[2]}:c(`expected <wave>/<id>, not "${t}"`)}s(T,"parseKey");async function J(t,e){const a=(await F(t)).find(i=>i.slug===e)||c(`this board has no wave "${e}"`),n=await g(a.file,null);return(!n||!Array.isArray(n.items))&&c(`${a.file} is not a wave file with items[]`),{source:a,wave:n}}s(J,"loadWave");async function E(t,e){const{wave:a,id:n}=T(e),i=await J(t,a),o=i.wave.items.find(r=>r.id===n)||c(`wave "${a}" has no item "${n}"`);return{...i,item:o}}s(E,"loadItem");async function Yn(t,e,a){v(t),P(e,"the event id");const n=(await R(f.join(t,"data","events.jsonl"))).find(r=>r.id===e);n||c(`no event "${e}" in this site's data/events.jsonl`);const i=f.join(t,"data","replies",`${e}.html`);await Yt(i,x(a,"the reply"));const o=n.kind==="ask"?`ask:${e}`:n.kind==="item-message"&&typeof n.data?.key=="string"?n.data.key:null;return{file:i,lines:o?await Vt(t,o,on(a)):[]}}s(Yn,"writeReply");const bt=s(t=>f.join(t,"data","working.json"),"workingFile");async function Ve(t){return(await g(bt(t),{})).events||{}}s(Ve,"readWorking");async function Gn(t,e){v(t),P(e,"the event id"),(await R(f.join(t,"data","events.jsonl"))).some(i=>i.id===e)||c(`no event "${e}" in this site's data/events.jsonl`);const n=await Ve(t);return await k(bt(t),{events:{...n,[e]:new Date().toISOString()}}),bt(t)}s(Gn,"setWorking");const jt=s(t=>f.join(t,"data","push-state.json"),"pushStateFile");async function Xn(t,e){v(t);const a=Date.parse((await g(jt(t),{})).last_push);if(Number.isNaN(a))return 0;const n=f.join(t,"data","replies"),i=(await S.readdir(n).catch(()=>[])).filter(r=>/\.(html|json)$/.test(r));return(await Promise.all(i.map(r=>S.stat(f.join(n,r)).then(l=>l.mtimeMs,()=>0)))).filter(r=>r>a&&r<=e.getTime()).length}s(Xn,"repliesSincePush");async function Vn(t,e){return await k(jt(v(t)),{last_push:e.toISOString()}),jt(t)}s(Vn,"recordPush");const tn=/(?:^| · )(and \d+ repl(?:y|ies))$/,ta=s((t,e)=>[t,e&&`and ${e} ${e===1?"reply":"replies"}`].filter(Boolean).join(" \xB7 "),"withReplies"),en=s(t=>t.startsWith("ask:")?`ask-${t.slice(4)}`:`item-${t}`,"pushTag"),Xt=160;function nn(t){const e=String(t).split(`
-`).map(a=>a.replace(/\s+/g," ").trim()).find(Boolean)||"";return e.length>Xt?`${e.slice(0,Xt-1).trimEnd()}\u2026`:e}s(nn,"pushLine");const an={amp:"&",lt:"<",gt:">",quot:'"',apos:"'",nbsp:" "};function on(t){return t.replace(/<details[\s\S]*?<\/details>/gi,`
+var Un=Object.defineProperty;var r=(e,t)=>Un(e,"name",{value:t,configurable:!0});import D from"node:fs/promises";import{constants as Wn}from"node:fs";import h from"node:path";import Je from"node:os";import{execFile as Rt}from"node:child_process";import{fileURLToPath as Hn}from"node:url";import{BUILD_REFUSED as Nt,ITEM_STATUSES as Et,builds as Kn,mergeBlockers as Jn,modelName as ze,noTakePicked as zn,ownerQuestion as ge,plans as Tt,providerOf as Ge,owesNext as Qe,pushTag as Gn,refOf as ke,roundOf as Ze,roundSettledBy as Qn}from"./domain.mjs";import{GITHUB_STATE as Lt,appendEvent as Ve,listBoards as Ae,samePath as Pe}from"../hub/boards.mjs";import{readUsageGate as Bt,pauseReason as Ct,builderPick as It}from"../shared/usage-gate.mjs";import{reviseQueued as Zn,flushQueue as Vn,queueStatus as Yn,readSettings as Xn,pushKindError as ei,readClaudeModel as ti}from"../hub/push.mjs";import{holdLine as ni,windowAt as ii}from"../hub/schedule.mjs";import{AT_RE as ai}from"../hub/duration.mjs";import{routeRecord as I}from"../hub/routes.mjs";import{ticketSource as Ye,ticketIn as Xe,resolveTicket as oi,ticketTarget as si,moveTicket as ri,titleTickets as ci,mcpCreateLine as di,cardIdOf as li}from"./tickets.mjs";import{validateBranch as ui}from"../hub/repos.mjs";import{withFileLock as qt}from"../hub/locks.mjs";import{fetchPR as Ft,reportOf as Mt,githubLogin as fi}from"../hub/pr-report.mjs";import{reviewLinks as et,topicItems as tt,reviewersOf as nt}from"./review.mjs";import{readiness as Ut}from"../hub/readiness.mjs";import{slackDay as Wt}from"../hub/slack.mjs";import"../bin/install.mjs";import{RuleError as pi,rulesOf as Ht,addRule as wi,editRule as mi,removeRule as hi,applyRules as $i,readHubRules as Re,writeHubRules as gi}from"../hub/rules.mjs";class Q extends Error{static{r(this,"BoardError")}}const c=r(e=>{throw new Q(e)},"fail"),ki=r(()=>h.join(Je.homedir(),".claude","kickflip","sites"),"sitesDir"),Ne=r(()=>h.join(Je.homedir(),".claude","waves"),"wavesDir"),y=r(async(e,t)=>{try{return JSON.parse(await D.readFile(e,"utf8"))}catch{return t}},"readJSON"),U=r(async e=>{try{return(await D.readFile(e,"utf8")).split(`
+`).filter(Boolean).map(t=>JSON.parse(t))}catch{return[]}},"readLines");async function it(e,t){await D.mkdir(h.dirname(e),{recursive:!0});const i=`${e}.${process.pid}.tmp`;await D.writeFile(i,t),await D.rename(i,e)}r(it,"replace");const x=r((e,t)=>it(e,JSON.stringify(t,null,2)+`
+`),"writeJSON");async function V(e,t){await D.mkdir(h.dirname(e),{recursive:!0}),await D.appendFile(e,JSON.stringify(t)+`
+`)}r(V,"appendLine");async function za(e){/^[\w-]+$/.test(e||"")||c(`--site takes a route such as ios-orchestrator, not "${e}"`);const t=h.join(ki(),e);return await D.stat(t).then(i=>i.isDirectory(),()=>!1)||c(`no site at ${t}`),t}r(za,"siteDir");const W=r(async e=>({title:"Board",items:"waves",...e?await y(h.join(e,"board.json"),{}):{}}),"boardConfig");async function C(e){const t=await W(e);if(t.items==="waves")try{return(await D.readdir(Ne(),{withFileTypes:!0})).filter(n=>n.isDirectory()).map(n=>({slug:n.name,dir:h.join(Ne(),n.name),file:h.join(Ne(),n.name,"wave.json")}))}catch{return[]}const i=h.resolve(e,t.items);return[{slug:t.slug||h.basename(t.items,".json"),dir:h.dirname(i),file:i}]}r(C,"itemSources");const H=r((e,t)=>h.join(e,"data","threads",t.replace(/[^\w.-]+/g,"__")+".jsonl"),"threadFile"),q=r(e=>h.join(e,"data","owner.json"),"ownerFile"),O=r(e=>e||c("this command needs --site <route>"),"needSite"),_=r((e,t)=>typeof e=="string"&&e.trim()?e.trim():c(`${t} must be non-empty text`),"text"),z=r((e,t)=>e===void 0?void 0:t(e),"optional"),yi=/^prototype-[\w-]+\.html(?:[?#]\S*)?$/,Kt=r((e,t)=>typeof e=="string"&&(yi.test(e)||/^https?:\/\/\S+$/.test(e))?e:c(`${t} must be an http(s) URL or a site page such as prototype-<topic>.html?q=<id>`),"pageUrl"),at=r((e,t)=>typeof e=="boolean"?e:c(`${t} must be true or false`),"bool"),te=r((e,t)=>typeof e=="string"&&/^[\w.-]+$/.test(e)?e:c(`${t} must use only letters, digits, "_", "." and "-"`),"domId"),ye=r((e,t,i)=>{(!e||typeof e!="object"||Array.isArray(e))&&c(`${i} must be a JSON object`);const n=Object.keys(e).filter(a=>!t.includes(a));n.length&&c(`${i} has unknown field ${n.map(a=>`"${a}"`).join(", ")}; allowed: ${t.join(", ")}`)},"onlyKeys");function T(e){const t=/^([^/\s]+)\/([^/\s]+)$/.exec(e||"");return t?{wave:t[1],id:t[2]}:c(`expected <wave>/<id>, not "${e}"`)}r(T,"parseKey");async function le(e,t){const i=(await C(e)).find(a=>a.slug===t)||c(`this board has no wave "${t}"`),n=await y(i.file,null);return(!n||!Array.isArray(n.items))&&c(`${i.file} is not a wave file with items[]`),{source:i,wave:n}}r(le,"loadWave");async function P(e,t){const{wave:i,id:n}=T(t),a=await le(e,i),o=a.wave.items.find(s=>s.id===n)||c(`wave "${i}" has no item "${n}"`);return{...a,item:o}}r(P,"loadItem");async function Ga(e,t,i){O(e),te(t,"the event id");const n=(await U(h.join(e,"data","events.jsonl"))).find(u=>u.id===t);n||c(`no event "${t}" in this site's data/events.jsonl`);const a=h.join(e,"data","replies",`${t}.html`);await it(a,_(i,"the reply"));const o=n.kind==="ask"?`ask:${t}`:n.kind==="item-message"&&typeof n.data?.key=="string"?n.data.key:null,s=o?await Gt(e,o,Pi(i)):[],d=n.kind==="wave-triage"?["lineup","wave"].filter(u=>typeof n.data?.[u]=="string").map(u=>`${u}:${n.data[u]}`):[],l=n.kind==="ask"?`item:ask:${t}`:d[0];return l&&s.push(...await mn(e,l,"Acted on: replied")),{file:a,lines:s}}r(Ga,"writeReply");const Jt=r(e=>h.join(e,"data","working.json"),"workingFile");async function bi(e){return(await y(Jt(e),{})).events||{}}r(bi,"readWorking");const Qa=["ask","item-message","wave-triage","todo-triage"];async function Za(e,t){if(!t.length)return;const i=new Date().toISOString(),n=await bi(e);await x(Jt(e),{events:{...n,...Object.fromEntries(t.map(a=>[a,I(n,a)||i]))}})}r(Za,"markWorking");const ot=r(e=>h.join(e,"data","push-state.json"),"pushStateFile");async function xi(e,t){O(e);const i=Date.parse((await y(ot(e),{})).last_push);if(Number.isNaN(i))return 0;const n=h.join(e,"data","replies"),a=(await D.readdir(n).catch(()=>[])).filter(s=>/\.(html|json)$/.test(s));return(await Promise.all(a.map(s=>D.stat(h.join(n,s)).then(d=>d.mtimeMs,()=>0)))).filter(s=>s>i&&s<=t.getTime()).length}r(xi,"repliesSincePush");async function vi(e,t){return await x(ot(O(e)),{last_push:t.toISOString()}),ot(e)}r(vi,"recordPush");const Si=h.join(h.dirname(Hn(import.meta.url)),"..","bin","kickflip.mjs");function _i(){if(!process.env.KICKFLIP_PUSH_CMD)return[process.execPath,Si,"push"];try{const e=JSON.parse(process.env.KICKFLIP_PUSH_CMD);if(Array.isArray(e)&&e.length&&e.every(t=>typeof t=="string"))return e}catch{}throw new Q("KICKFLIP_PUSH_CMD must be a JSON array of strings")}r(_i,"pushCommand");async function Va(e,t){const i=ei(t.kind);i&&c(i),t.title===void 0&&c("push needs --title");const n=new Date,a=Oi(t.body,await xi(e,n)),o={kind:t.kind,title:t.title,body:a||void 0,url:Ri(t.url),tag:t.tag},[s,...d]=_i(),l=[...d,...Object.entries(o).flatMap(([m,p])=>p===void 0?[]:[`--${m}`,p]),...t.urgent?["--urgent"]:[],...t.now?["--now"]:[]],u=await new Promise(m=>{Rt(s,l,{encoding:"utf8"},(p,w,$)=>m({error:p,said:`${w||""}${$||""}`.split(`
+`).filter(g=>g.trim())}))}),f=u.error?typeof u.error.code=="number"?u.error.code:1:0;if(f!==0)throw Object.assign(new Q([...u.said,`kickflip push failed (${typeof u.error.code=="number"?`exit ${f}`:u.error.message}); the push was not recorded`].join(`
+`)),{exitCode:f});return await vi(e,n),{lines:u.said}}r(Va,"sendPush");const ji=/(?:^| · )(and \d+ repl(?:y|ies))$/,Oi=r((e,t)=>[e,t&&`and ${t} ${t===1?"reply":"replies"}`].filter(Boolean).join(" \xB7 "),"withReplies"),zt=160;function Di(e){const t=String(e).split(`
+`).map(i=>i.replace(/\s+/g," ").trim()).find(Boolean)||"";return t.length>zt?`${t.slice(0,zt-1).trimEnd()}\u2026`:t}r(Di,"pushLine");const Ai={amp:"&",lt:"<",gt:">",quot:'"',apos:"'",nbsp:" "};function Pi(e){return e.replace(/<details[\s\S]*?<\/details>/gi,`
 `).replace(/<(?:br|\/?(?:p|div|li|ul|ol|h\d|blockquote|pre|tr|summary))\b[^>]*>/gi,`
-`).replace(/<[^>]*>/g,"").replace(/&(?:#(x[\da-f]{1,6}|\d{1,7})|(\w+));/gi,(e,a,n)=>{const i=a&&parseInt(a.replace(/^x/i,""),/^x/i.test(a)?16:10);return a?i<=1114111?String.fromCodePoint(i):e:W(an,n.toLowerCase())??e})}s(on,"htmlText");function ea(t){if(!t||!t.startsWith("/"))return t;const e=new URL(t,"http://board");return/^#item=[^&]+$/.test(e.hash)&&(e.hash=`${e.hash}&reply`),/\/[\w-]+\.html$/.test(e.pathname)&&!e.pathname.endsWith("/index.html")&&e.searchParams.set("from","push"),e.pathname+e.search+e.hash}s(ea,"pushUrl");const sn=s((t,e)=>`/${f.basename(t)}/#item=${encodeURIComponent(e)}&reply`,"threadUrl");async function Vt(t,e,a){const n=nn(a);if(!n)return[];const i=en(e),o=await Be(i,r=>[n,tn.exec(r)?.[1]].filter(Boolean).join(" \xB7 "),sn(t,e));return o===null?[]:[`queued push ${i} now reads: ${o}`]}s(Vt,"freshenPush");const te=s(t=>f.join(t,"data","hidden.json"),"hiddenFile"),rn=s(async t=>new Set((await g(te(t),{events:[]})).events||[]),"readHidden");let ee=Promise.resolve();function na(t,e,a){P(e,"the event id");const n=ee.then(async()=>{const i=await rn(t);a?i.add(e):i.delete(e),await k(te(t),{events:[...i]})});return ee=n.catch(()=>{}),n}s(na,"setHidden");const xt=20*1024*1024,N=s(t=>f.join(t,"data","uploads"),"uploadsDir"),H=s((t,e)=>f.join(N(t),".meta",`${e}.json`),"uploadMeta"),ne=/^\d+-[\w.-]+$/,ae=/^[\w.+-]+\/[\w.+-]+$/,ie=s(()=>Object.assign(new I(`a file can be at most ${xt/1024/1024} MB`),{status:413}),"tooLarge");async function aa(t,e,{name:a,type:n,length:i}){if(v(t),i>xt)throw ie();const o=String(a||"").trim().slice(0,200)||"file",r=f.basename(o).replace(/[^\w.-]+/g,"-").replace(/^[.-]+/,"").slice(-80)||"file",l=String(n||"").split(";")[0].trim().toLowerCase(),d=ae.test(l)?l:"application/octet-stream";await S.mkdir(f.dirname(H(t,"x")),{recursive:!0});let p,u;for(let h=Date.now();!u;h++)p=`${h}-${r}`,u=await S.open(f.join(N(t),p),"wx").catch($=>$.code==="EEXIST"?null:Promise.reject($));const w=f.join(N(t),p);let m=0;try{for await(const h of e){if(m+=h.length,m>xt)throw ie();await u.write(h)}}catch(h){throw await u.close(),await S.rm(w,{force:!0}),h}return await u.close(),await k(H(t,p),{name:o,type:d,size:m,at:new Date().toISOString()}),{name:o,url:`uploads/${p}`,path:w,type:d,size:m}}s(aa,"saveUpload");async function ia(t,e){if(!ne.test(e||""))return null;const a=f.join(N(t),e),n=await S.stat(a).catch(()=>null);if(!n?.isFile())return null;const i=await g(H(t,e),{});return{path:a,name:i.name||e,type:ae.test(i.type||"")?i.type:"application/octet-stream",size:n.size}}s(ia,"readUpload");const oe=["github","slack"];async function cn(t,e,{text:a,link:n,who:i="claude",via:o}){if(v(t),String(e).startsWith("ask:"))await X(t,e.slice(4),"the ask");else{const{wave:d,id:p}=T(e),{wave:u}=await J(t,d);[...u.items,...u.followups||[]].some(w=>w.id===p)||c(`wave "${d}" has no item or follow-up "${p}"`)}/^[^\n]{1,40}$/.test(i.trim())||c("--who takes claude, love or a reviewer's name"),o!==void 0&&!oe.includes(o)&&c(`--via takes ${oe.join(" or ")}`);const r={ts:new Date().toISOString(),who:i.trim(),text:x(a,"--text"),link:_(n,d=>Gt(d,"--link")),via:o},l=M(t,e);return await K(l,r),{file:l,lines:r.who==="claude"&&!o?await Vt(t,e,r.text):[]}}s(cn,"appendThread");const z=s(t=>f.join(t,"data","ask-links.json"),"askLinksFile");async function ot(t){return(await g(z(t),{})).links||{}}s(ot,"readAskLinks");async function oa(t,e,a,n){v(t),P(e,"the event id"),(await R(f.join(t,"data","events.jsonl"))).some(l=>l.id===e&&l.kind==="ask")||c(`no ask "${e}" in this site's data/events.jsonl`),await St(t,e),await E(t,a);const o={ts:new Date().toISOString(),who:"claude",text:x(n,"--summary")},r=await ot(t);return await k(z(t),{links:{...r,[e]:a}}),await K(M(t,a),o),z(t)}s(oa,"relateAsk");async function sa(t,e){await X(t,e,"the ask");const a=await ot(t);return W(a,e)===void 0&&c(`ask "${e}" is not folded into a card`),delete a[e],await k(z(t),{links:a}),z(t)}s(sa,"unfoldAsk");const st=s(t=>f.join(t,"data","ask-progress.json"),"askProgressFile");async function rt(t){return(await g(st(t),{})).asks||{}}s(rt,"readAskProgress");async function St(t,e){const a=W(await rt(t),e)?.moved;a&&c(`ask "${e}" was moved to /${a.route}; it lives there now`)}s(St,"refuseMoved");async function ra(t,e,a,n){await X(t,e,"the ask"),await St(t,e);const i=await rt(t);return await k(st(t),{asks:{...i,[e]:{state:a,at:new Date().toISOString(),...n===void 0?{}:{next:x(n,"--next")}}}}),st(t)}s(ra,"markAsk");const ln=[void 0,"planned","waiting"];async function dn(t,e,a){const n=`ask "${e}"`;if(a.some(u=>u.kind==="ask-withdrawn"&&u.data?.id===e&&!u.data?.key))return{why:`${n} was deleted by the owner`};const i=W(await rt(t),e);if(i?.moved)return{why:`${n} was already moved to /${i.moved.route}`};const o=W(await ot(t),e);if(o)return{why:`${n} is folded into ${o}; run ask unfold ${e} first`};const r=[];for(const u of await F(t)){const w=await g(u.file,null);for(const m of Array.isArray(w?.items)?w.items:[])m.from_ask===e&&r.push({key:`${u.slug}/${m.id}`,it:m})}const l=r.find(({it:u})=>u.pr||!ln.includes(u.status));return l?{why:`${n} became ${l.key}, which has started`}:r.length?{items:r.map(u=>u.key)}:(await Promise.all(["html","json"].map(u=>S.stat(f.join(t,"data","replies",`${e}.${u}`)).then(()=>!0,()=>!1)))).some(Boolean)||!!i||a.some(u=>u.kind==="ask-done"&&u.data?.id===e)||(await R(M(t,`ask:${e}`))).some(u=>(u.who||"claude")==="claude"&&u.kind!=="status")?{why:`${n} is not New: Claude already answered it`}:null}s(dn,"askNotNew");async function un(t,e,a){const n=/^uploads\/([\w.-]+)$/.exec(a?.url||"")?.[1],i=ne.test(n||"")?f.join(N(t),n):null;if(!i||!await S.stat(i).then(d=>d.isFile(),()=>!1))return{name:String(a?.name||n||"file")};await S.mkdir(f.dirname(H(e,"x")),{recursive:!0});const o=n.replace(/^\d+-/,"");let r;for(let d=Date.now();r=`${d}-${o}`,!await S.copyFile(i,f.join(N(e),r),Pe.COPYFILE_EXCL).then(()=>!0,u=>u.code==="EEXIST"?!1:Promise.reject(u));d++);const l=await g(H(t,n),null);return l&&await k(H(e,r),l),{...a,url:`uploads/${r}`,path:f.join(N(e),r)}}s(un,"copyUpload");async function ca(t,e,a){v(t),P(e,"the event id"),(typeof a!="string"||!a.trim())&&c("ask move needs --to <route>, the board to move it to");const n=await R(f.join(t,"data","events.jsonl")),i=n.find(y=>y.id===e&&y.kind==="ask")||c(`no ask "${e}" in this site's data/events.jsonl`),o=zt(),r=o.find(y=>y.route===a)||c(`--to ${a}: no board at /${a} in the hub's manifest; the boards are ${o.map(y=>y.route).join(", ")||"none"}`);Kt(r.dir,t)&&c(`--to ${a}: that is this board`);const l=await dn(t,e,n);l?.why&&c(l.why);const d=n.filter(y=>y.kind==="ask-edited"&&y.data?.id===e&&typeof y.data?.text=="string").sort((y,C)=>String(y.ts).localeCompare(String(C.ts))).pop(),p=[];for(const y of i.data?.files||[])p.push(await un(t,r.dir,y));const u={route:f.basename(t),title:(await it(t)).title,id:e},w=d?d.data.text:i.data?.text||"",m=await Ht(r,"ask",{text:w,...p.length?{files:p}:{},from:u}),h={route:a,title:r.title,id:m},$=new Date().toISOString(),j=await rt(t);await k(st(t),{asks:{...j,[e]:{state:"done",at:$,moved:h}}});const O=`/${a}/#item=${encodeURIComponent(`ask:${m}`)}`;await K(M(t,`ask:${e}`),{ts:$,who:"claude",text:`Moved to ${r.title}.`,link:O});for(const y of l?.items||[])await vn(t,y,{status:"dropped",force:!0});return{file:f.join(r.dir,"data","events.jsonl"),lines:[`moved to ${O}`,...(l?.items||[]).map(y=>`dropped: ${y}`)]}}s(ca,"moveAsk");const se=s(t=>f.join(t,"data","checked.json"),"checkedFile");async function la(t,e,{idle:a=!1}={}){v(t),a&&e!==void 0&&c("pass --every or --idle, not both");const n=a?null:/^[1-9]\d{0,3}$/.test(String(e??"30"))?Number(e??"30"):c("--every takes the minutes between checks, such as 30");return await k(se(t),a?{at:new Date().toISOString(),every:null,idle:!0}:{at:new Date().toISOString(),every:n}),{file:se(t),lines:await fn()}}s(la,"writeChecked");async function fn(){const t=Ne(new Date);if(t.hold)return t.count?[`queued pushes held: ${Ce(t.hold)}`]:[];const e=await Fe();return e?[`sent ${e.sent} of ${e.count} queued push${e.count===1?"":"es"}${e.ok?"":"; the rest stay queued"}`]:[]}s(fn,"flushAfterTick");const ct=s(t=>f.join(t,"data","handshake.json"),"handshakeFile"),re=s(t=>g(ct(t),null),"readHandshake");async function da(t,e){v(t),P(e,"the event id");const a=(await R(f.join(t,"data","events.jsonl"))).find(i=>i.id===e);a?.kind!=="hello"&&c(`no hello event "${e}" in this site's data/events.jsonl`);const n=await re(t)||{};return n.hello?.id&&n.hello.id!==e&&c(`"${e}" is an older hello; ack the newest, "${n.hello.id}"`),await k(ct(t),{...n,hello:n.hello||{id:e,at:a.ts,session:null},ack:{id:e,at:new Date().toISOString()}}),ct(t)}s(da,"ackHello");async function ua(t){const e=await re(t);e&&!e.done_at&&await k(ct(t),{...e,done_at:new Date().toISOString()})}s(ua,"finishHandshake");const vt={name:/^[^\n]{1,40}$/,slack_user:/^U[A-Z0-9]+$/,dm:/^D[A-Z0-9]+$/,github:/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})$/},Z=s((t,e)=>t.trim().toLowerCase()===e.trim().toLowerCase(),"sameName");function Ot(t,e){return Array.isArray(t)||c(`${e} must be a JSON array of reviewers`),t.forEach((a,n)=>{const i=`${e}[${n}]`;Q(a,Object.keys(vt),i);for(const[o,r]of Object.entries(vt))(typeof a[o]!="string"||!r.test(a[o].trim()))&&c(`${i}.${o} must match ${r}`);t.slice(0,n).some(o=>Z(o.name,a.name))&&c(`${e} names "${a.name}" twice`)}),t.map(a=>Object.fromEntries(Object.keys(vt).map(n=>[n,a[n].trim()])))}s(Ot,"checkReviewers");async function At(t,e){const a=f.join(v(t),"board.json"),n=await g(a,{});return await k(a,{...n,reviewers:Ot(e(n.reviewers||[]),"the reviewers")}),a}s(At,"writeReviewers");const fa=s((t,e)=>At(t,()=>Ot(e,"the reviewer file")),"setReviewers");function pa(t,e){const a=Ot(Array.isArray(e)?e:[e],"the reviewer file");return At(t,n=>[...n.map(i=>a.find(o=>Z(o.name,i.name))||i),...a.filter(i=>!n.some(o=>Z(i.name,o.name)))])}s(pa,"addReviewers");function wa(t,e){return At(t,a=>{const n=e.filter(i=>!a.some(o=>Z(o.name,i)));return n.length&&c(`this board has no reviewer ${n.map(i=>`"${i}"`).join(", ")}`),a.filter(i=>!e.some(o=>Z(i.name,o)))})}s(wa,"removeReviewers");const pn=s(()=>f.join($t.homedir(),".claude","kickflip","settings.json"),"hubSettingsFile"),Dt=s(t=>{try{return t()}catch(e){throw e instanceof He&&c(e.message),e}},"ruleCall"),Rt=s(async t=>Zt(await g(f.join(t,"board.json"),{})),"readBoardRules");let ce=Promise.resolve();function le(t,e){const a=ce.then(async()=>{const n=f.join(v(t),"board.json"),i=await g(n,{}),{set:o,...r}=e(i);return await k(n,{...i,...o}),{file:n,...r}});return ce=a.catch(()=>{}),a}s(le,"writeBoardJSON");const de=s((t,e)=>le(t,a=>{const n=Dt(()=>e(Zt(a)));return{set:{rules:n.rules},...n}}),"writeBoardRules"),ue=s(t=>{try{return t?yt(t):null}catch{return null}},"storedTickets"),_t=s(t=>{const e=ue(t?.tickets);return{auto_merge:t?.auto_merge===!0,auto_build:t?.auto_build===!0,...e?{tickets:e}:{}}},"settingsOf");async function ma(t){return _t(await g(f.join(v(t),"board.json"),{}))}s(ma,"readBoardSettings");function wn(t,e){Q(e,["auto_merge","auto_build","tickets"],"the settings"),Object.keys(e).length||c("the settings name nothing to change"),e={...e};for(const[a,n]of Object.entries(e))if(a==="tickets")try{e.tickets=yt(n)}catch(i){c(i.message)}else kt(n,a);return le(t,a=>{const n=_t(a),i={...n,...e};return{set:e,settings:i,changed:Object.keys(e).filter(o=>JSON.stringify(n[o])!==JSON.stringify(i[o]))}})}s(wn,"saveBoardSettings");async function ha(t,e,a){const n=String(e).replace(/-/g,"_");["auto_merge","auto_build"].includes(n)||c(`no board setting "${e}"; settings are ${Object.keys(_t({})).map(r=>r.replace(/_/g,"-")).join(", ")}`),["on","off"].includes(a)||c(`settings set ${e} takes on or off, not "${a}"`);const{file:i,settings:o}=await wn(t,{[n]:a==="on"});return{file:i,lines:[`${e} ${o[n]?"on":"off"}`]}}s(ha,"setBoardSetting");const $a=s(t=>Object.entries(t).map(([e,a])=>`setting ${e.replace(/_/g,"-")} ${e==="tickets"?JSON.stringify(a):a?"on":"off"}`),"settingsLines");async function Pt(t,e,a){const n=e?Dt(()=>a(nt())):await de(t,a);return e&&Dt(()=>Ye(n.rules)),{file:e?pn():n.file,lines:[`id ${n.rule.id}`]}}s(Pt,"changeRules");async function fe(t,e,a){const n=s(r=>r.map(l=>l.id),"ids");a||v(t);const[i,o]=a?[n(nt()),t?n(await Rt(t)):[]]:[n(await Rt(t)),n(nt())];i.includes(e)||c(`no ${a?"hub":"board"} rule "${e}"${o.includes(e)?`; it is a ${a?"board":"hub"} rule, so ${a?"drop":"pass"} --hub`:""}`)}s(fe,"checkRuleId");async function ya(t){const e=s(a=>n=>`${a} ${n.id} ${n.by==="claude"?"claude":"owner"} ${n.text}`,"line");return{lines:[...nt().map(e("hub")),...t?(await Rt(t)).map(e("board")):[]]}}s(ya,"listRules");function ga(t,{text:e,hub:a=!1,by:n}){return a||v(t),Pt(t,a,i=>ze(i,{text:e,by:n}))}s(ga,"addRuleTo");async function ka(t,e,{text:a,hub:n=!1}){return await fe(t,e,n),Pt(t,n,i=>Ke(i,e,a))}s(ka,"editRuleIn");async function ba(t,e,{hub:a=!1}){return await fe(t,e,a),Pt(t,a,n=>Qe(n,e))}s(ba,"removeRuleFrom");const ja=s((t,e,a)=>de(t,n=>Ze(n,e,a)),"saveBoardRules");async function xa(t,{id:e,title:a,summary:n}){v(t);const i=await g(D(t),{topics:[],items:[]}),o=i.topics||[];return o.some(r=>r.id===x(e,"the topic id"))&&c(`topic "${e}" already exists`),o.push({id:e.trim(),title:x(a,"--title"),...n===void 0?{}:{summary:x(n,"--summary")}}),await k(D(t),{...i,topics:o,items:i.items||[]}),D(t)}s(xa,"addTopic");const pe=["quiet","info","notice","danger","success"];function mn(t,e){if(t.diagram===void 0!=(t.practice===void 0)&&c(`${e} needs diagram and practice together`),t.diagram===void 0)return;const a=t.diagram;(!Array.isArray(a)||!a.length)&&c(`${e}.diagram must be a non-empty array of rows`),a.forEach((n,i)=>{(!Array.isArray(n)||!n.length||n.length>4)&&c(`${e}.diagram[${i}] must be a row of 1 to 4 boxes`),n.forEach((o,r)=>{const l=`${e}.diagram[${i}][${r}]`;Q(o,["text","tone","to"],l),x(o.text,`${l}.text`),_(o.tone,d=>pe.includes(d)?d:c(`${l}.tone takes ${pe.join(", ")}`)),_(o.to,d=>Array.isArray(d)&&i+1<a.length&&d.every(p=>Number.isInteger(p)&&p>=0&&p<a[i+1].length)?d:c(`${l}.to must list boxes of the next row by index`))})}),(!Array.isArray(t.practice)||!t.practice.length)&&c(`${e}.practice must be a non-empty array of lines`),t.practice.forEach((n,i)=>x(n,`${e}.practice[${i}]`))}s(mn,"checkDiagram");function hn(t,e){(!Array.isArray(t)||!t.length)&&c(`${e}.options must be a non-empty array`);const a=new Set;t.forEach((n,i)=>{const o=`${e}.options[${i}]`;Q(n,["id","label","recommended","detail","diagram","practice"],o),mn(n,o),a.has(x(n.id,`${o}.id`))&&c(`${e} has two options with id "${n.id}"`),a.add(n.id),x(n.label,`${o}.label`).startsWith(`${n.id}. `)&&c(`${o}.label starts with "${n.id}. ", but the page adds the option letter itself`),_(n.recommended,r=>kt(r,`${o}.recommended`)),_(n.detail,r=>typeof r=="string"?r:c(`${o}.detail must be text`))}),t.filter(n=>n.recommended).length>1&&c(`${e} recommends more than one option`)}s(hn,"checkOptions");const Y=s(t=>f.join(t,"data","prototypes.json"),"prototypesFile"),Tt=s((t,e,a)=>f.join(t,"public","prototypes",e,`${a}.js`),"takeFile");async function lt(t){const e=t?(await g(Y(t),{})).prototypes:null;return Array.isArray(e)?e:[]}s(lt,"readPrototypes");const $n=s(t=>typeof t=="string"&&/^[a-z0-9-]+$/.test(t)?t:c(`a prototype topic uses only a-z, 0-9 and "-", not "${t}"`),"prototypeTopic");function yn(t){const e=/^([^:]*):(.*)$/s.exec(t);(!e||!/^[A-Z]$/.test(e[1]))&&c(`--take takes KEY:"Label" with KEY one capital letter, not "${t}"`);const a=x(e[2],`--take ${e[1]}'s label`);return/^[A-Z]\.\s/.test(a)&&c(`--take ${e[1]}'s label starts with "${a.slice(0,3)}"; the take pill shows the label alone, so drop the letter`),{key:e[1],label:a}}s(yn,"prototypeTake");const G=s(t=>/^prototype-(.+)\.html$/.exec(f.posix.basename(String(t||"").split(/[?#]/)[0]))?.[1],"pageTopic");async function Sa(t,{topic:e,title:a,card:n,takes:i=[]}){v(t),$n(e),x(a,"--title"),i.length||c('prototype add needs a --take KEY:"Label" for each take');const o=i.map(yn),r=o.find((p,u)=>o.findIndex(w=>w.key===p.key)!==u);r&&c(`--take ${r.key} is given twice`),n!==void 0&&await E(t,n);const l=await lt(t);l.some(p=>p.topic===e)&&c(`prototype ${e} is already recorded; run prototype rm ${e} first, or pick another topic`),await S.stat(f.join(t,"public",`prototype-${e}.html`)).then(()=>!0,()=>!1)&&c(`public/prototype-${e}.html is a hand-written page that questions may link; pick another topic`);const d={topic:e,title:a.trim(),...n===void 0?{}:{card:n},takes:o,at:new Date().toISOString()};return await k(Y(t),{prototypes:[...l,d]}),{file:Y(t),lines:[`page prototype-${e}.html`,...o.map(p=>`take ${p.key} ${Tt(t,e,p.key)}`)]}}s(Sa,"addPrototype");async function va(t){v(t);const e=await lt(t);return{lines:e.length?e.map(a=>`${a.topic} \xB7 ${a.title} \xB7 ${a.takes.map(n=>`${n.key}: ${n.label}`).join(", ")}${a.card?` \xB7 ${a.card}`:""}`):["no prototypes recorded"]}}s(va,"listPrototypes");async function Oa(t,e){v(t);const a=await lt(t);a.some(o=>o.topic===e)||c(`no prototype "${e}" is recorded`);const i=((await g(D(t),{items:[]})).items||[]).filter(o=>!o.resolved&&G(o.url)===e).map(o=>o.id);return i.length&&c(`prototype ${e} backs open question ${i.join(", ")}; resolve ${i.length===1?"it":"them"} first`),await k(Y(t),{prototypes:a.filter(o=>o.topic!==e)}),Y(t)}s(Oa,"removePrototype");async function gn(t,e,a){const n=e.url?.split(/[?#]/)[0];if(!n||!f.posix.basename(n).startsWith("prototype-"))return;const i=f.posix.basename(n),o=e.url.split("#")[0].split("?").slice(1).join("?"),r=`${a}.url`;new URLSearchParams(o).get("q")!==e.id&&c(`${r} must be ${i}?q=${e.id} so the pill can pick`);const l=G(n),d=(await lt(t)).find(m=>m.topic===l);d||c(`${r} names ${i}, which is not a recorded prototype; record it with board.mjs prototype add ${l} --title "\u2026" --take A:"\u2026", then write its take files`);const p=d.takes.map(m=>m.key),u=e.options.map(m=>m.id),w=u.map(m=>p.indexOf(m));w.some((m,h)=>m<0||h>0&&m<w[h-1])&&c(`${a}.options ids ${u.join(", ")} must be a non-empty subset of ${i}'s takes, in take order: ${p.join(", ")}`);for(const m of p)await S.stat(Tt(t,l,m)).then(h=>h.isFile(),()=>!1)||c(`${r} take ${m} has no file yet; write ${Tt(t,l,m)}`)}s(gn,"checkPrototype");async function Aa(t,e){v(t);const a=Array.isArray(e)?e:[e];a.length||c("the question file is empty");const n=await g(D(t),{topics:[],items:[]}),i=n.items||[],o=new Set(i.map(w=>w.id)),r=new Set((n.topics||[]).map(w=>w.id));for(const[w,m]of a.entries()){const h=`question ${m?.id??w+1}`;Q(m,["id","topic","source","question","context","url","urgent","options"],h),o.has(P(m.id,`${h}.id`))&&c(`question id "${m.id}" is already used`),o.add(m.id),x(m.topic,`${h}.topic`),m.topic.startsWith("item:ask:")?await X(t,m.topic.slice(9),`${h}.topic`):m.topic.startsWith("item:")?await E(t,m.topic.slice(5)):r.has(m.topic)||c(`topic "${m.topic}" is not declared; add it with: topic add ${m.topic} --title <t>`),x(m.question,`${h}.question`);for(const $ of["source","context"])_(m[$],j=>x(j,`${h}.${$}`));_(m.url,$=>Gt($,`${h}.url`)),_(m.urgent,$=>kt($,`${h}.urgent`)),hn(m.options,h),await gn(t,m,h)}const l=await we(t),d=new Date().toISOString(),p=[],u=[];for(const w of a){const m=G(w.url);for(const h of i)h.topic===w.topic&&(w.topic.startsWith("item:")&&Jt(h,l).state==="answered"?(Et(n,[h.id],`Followed by ${w.id}`,d),u.push(h.id)):!h.resolved&&m&&G(h.url)===m&&(Et(n,[h.id],`Replaced by ${w.id}`,d),p.push(h.id)))}return await k(D(t),{...n,topics:n.topics||[],items:[...i,...a]}),await Qt([...p,...u].map(w=>`q-${w}`),f.basename(t)),{file:D(t),lines:[...p.map(w=>`replaced: ${w}`),...u.map(w=>`resolved: ${w}`)]}}s(Aa,"addQuestions");function Et(t,e,a,n=new Date().toISOString()){for(const i of t.items||[])e.includes(i.id)&&Object.assign(i,{resolved:a,resolved_at:n})}s(Et,"setResolved");async function Lt(t,e,a,n){return Et(e,a,n),await k(D(t),e),await Qt(a.map(i=>`q-${i}`),f.basename(t)),D(t)}s(Lt,"markResolved");async function Da(t,e,a){v(t);const n=await g(D(t),{topics:[],items:[]});return(n.items||[]).some(i=>i.id===e)||c(`no question "${e}" in owner.json`),Lt(t,n,[e],x(a,"--note"))}s(Da,"resolveQuestion");async function we(t){const e=(await R(f.join(t,"data","events.jsonl"))).filter(a=>a.kind==="owner-answer");return Promise.all(e.map(async a=>{const n=await Promise.all(["html","json"].map(i=>S.stat(f.join(t,"data","replies",`${a.id}.${i}`)).then(o=>o.isFile(),()=>!1)));return{...a,reply:a.reply||n.some(Boolean)}}))}s(we,"ownerAnswers");async function me(t,e){const a=await g(D(t),{topics:[],items:[]}),n=await we(t),i=(a.items||[]).filter(o=>o.topic===`item:${e}`).map(o=>Jt(o,n));return{owner:a,asked:i}}s(me,"cardQuestions");async function kn(t,e,a){if(!t)return[];const{owner:n,asked:i}=await me(t,e),o=i.filter(r=>r.state==="answered").map(r=>r.id);return o.length&&await Lt(t,n,o,a),o.map(r=>`resolved: ${r}`)}s(kn,"resolveAnswered");async function he(t,e,a,n){if(!t)return async()=>[];const{owner:i,asked:o}=await me(t,e),r=o.filter(d=>d.state==="open").map(d=>d.id);r.length&&!n&&c(`${a}: ${e} has ${r.length===1?"an open question":"open questions"} ${r.join(", ")} with no answer yet; pass --force to close the card and resolve ${r.length===1?"it":"them"} too`);const l=o.filter(d=>d.state!=="resolved").map(d=>d.id);return async()=>(l.length&&await Lt(t,i,l,"Closed with the card"),l.map(d=>`resolved: ${d}`))}s(he,"closeQuestions");async function bn(t,e){const a=await g(D(t),{items:[]}),n=new Set((a.items||[]).filter(r=>r.topic===`item:${e}`&&G(r.url)).map(r=>r.id)),i=(await R(f.join(t,"data","events.jsonl"))).filter(r=>r.kind==="owner-answer"&&n.has(r.data?.id)).at(-1),o=String(i?.data?.note||"").replace(/\s+/g," ").trim();return o?{id:i.data.id,note:o}:null}s(bn,"unconfirmedPrototype");async function jn(t,e,a){const n=t?await bn(t,e):null;if(a===void 0)return n&&c(`${e} waits on a confirm round: the owner's answer to ${n.id} has a note ("${$e(n.note)}"); post the final version with prototype add and question add, or pass --confirmed "<the owner's words>" when that note says go`),null;const i=x(a,"--confirmed").replace(/\s+/g," ");return n||c(`${e} has no prototype answer with a note to confirm; drop --confirmed`),n.note.toLowerCase().includes(i.toLowerCase())||c(`--confirmed must quote the owner's note on ${n.id}: "${$e(n.note)}"`),`Building on the owner's go in their answer to ${n.id}: "${i}"`}s(jn,"confirmGate");const $e=s(t=>t.length>120?`${t.slice(0,119)}\u2026`:t,"clip");async function X(t,e,a="--from-ask"){return P(e,a),(await R(f.join(v(t),"data","events.jsonl"))).some(i=>i.id===e&&i.kind==="ask")?e:c(`no ask "${e}" in this site's data/events.jsonl`)}s(X,"checkAsk");const L=["done","merged","dropped"];function ye(t){return["building","fixing"].includes(t?.status)?(delete t.status,t.status_at=new Date().toISOString(),!0):!1}s(ye,"clearBuildingStatus");const dt=s((t,e)=>String(e).includes("/")?String(e):`${t}/${e}`,"depKey");async function ge(t,e,a){const n=(a.deps||[]).map(o=>dt(e,o)),i=await Promise.all(n.map(o=>E(t,o).then(({item:r})=>r,()=>null)));return n.filter((o,r)=>i[r]&&!L.includes(i[r].status))}s(ge,"unfinishedDeps");async function xn(t,e){const a=[];for(const n of await F(t)){const i=await g(n.file,null);for(const o of Array.isArray(i?.items)?i.items:[])![void 0,"planned","waiting","held"].includes(o.status)||!(o.deps||[]).some(r=>dt(n.slug,r)===e)||(await ge(t,n.slug,o)).length||a.push(`${n.slug}/${o.id}`)}return a}s(xn,"unblockedBy");async function Sn(t,e,a,n){const i=new Set(n.match(/[\w-]+(?:\.[\w-]+)*(?:\/[\w-]+(?:\.[\w-]+)*)*/g)||[]),o=new Set((a.deps||[]).map(r=>dt(T(e).wave,r)));for(const r of await F(t)){const l=await g(r.file,null);for(const d of l?.items||[]){const p=`${r.slug}/${d.id}`;if(p===e||o.has(p)||L.includes(d.status))continue;[d.id,Te(l,d.id)].flatMap(w=>[w,`${r.slug}/${w}`]).some(w=>i.has(w))&&c(`--next names unfinished card ${p}; add it with --deps`)}}}s(Sn,"checkNextDeps");async function ut(t,e){const a=s(i=>c(`a notes file is a .md file inside ${t}, named relative to it: "${e}" ${i}`),"bad");(typeof e!="string"||!e.trim())&&a("is empty"),(f.isAbsolute(e)||e.split(/[\\/]/).includes(".."))&&a("leaves the folder"),f.extname(e).toLowerCase()!==".md"&&a("is not a .md file");const n=await S.realpath(f.resolve(t,e)).catch(()=>a("does not exist"));return n.startsWith(await S.realpath(t)+f.sep)||a("leaves the folder"),n}s(ut,"planPath");async function Ra(t,e){const{source:a,wave:n,item:i}=await E(t,e);if(i.plan)return{wave:n,item:i,markdown:await S.readFile(await ut(a.dir,i.plan),"utf8")};if(typeof i.notes=="string"&&i.notes.trim())return{wave:n,item:i,markdown:i.notes};c(`${e} has no notes`)}s(Ra,"readNotes");function ke({install:t,installSha:e,installLabel:a,clearInstall:n}){if(t===void 0)return(e!==void 0||a!==void 0)&&c("--install-sha and --install-label go with --install <url>"),n?null:void 0;n&&c("pass --install or --clear-install, not both");let i;try{i=new URL(String(t).trim())}catch{i=null}(!i||!["https:","itms-services:"].includes(i.protocol))&&c(`--install takes an https:// or itms-services:// URL, not "${t}"`),i.protocol==="itms-services:"&&!(i.searchParams.get("action")==="download-manifest"&&/^https:\/\//.test(i.searchParams.get("url")||""))&&c("--install: an itms-services:// URL needs ?action=download-manifest&url=https://\u2026/manifest.plist");const o=e===void 0?void 0:/^[0-9a-f]{7,40}$/i.test(e)?e.toLowerCase():c(`--install-sha takes a commit sha of 7 to 40 hex digits, not "${e}"`);return{url:String(t).trim(),...a===void 0?{}:{label:x(a,"--install-label")},built_at:new Date().toISOString(),...o?{sha:o}:{}}}s(ke,"installOf");async function _a(t,{install:e,installSha:a}){const n=ke({install:e,installSha:a});n||c("main set needs --install <url>");const i=f.join(v(t),"data","main.json");return await k(i,{install:n}),{file:i,lines:["main install set"]}}s(_a,"setMainInstall");async function be(t,e,{ticket:a,status:n,clearStatus:i,next:o,clearNext:r,pr:l,fromAsk:d,held:p,unheld:u,notesFile:w,deps:m,install:h,installSha:$,installLabel:j,clearInstall:O,title:y,force:C,confirmed:Ft},Nt){n!==void 0&&i&&c("pass --status or --clear-status, not both"),Ft!==void 0&&n!=="building"&&c("--confirmed goes with --status building"),C&&!L.includes(n)&&c(`--force goes with --status ${L.join(", ")}`),o!==void 0&&r&&c("pass --next or --clear-next, not both"),typeof o=="string"&&!o.trim()&&([o,r]=[void 0,!0]),p&&u&&c("pass --held or --unheld, not both");const et=ke({install:h,installSha:$,installLabel:j,clearInstall:O});[n,i,o,r,l,d,p,u,w,m,et,y,a].every(A=>A===void 0||A===!1)&&c("nothing to set: pass --status, --clear-status, --next, --clear-next, --pr, --from-ask, --held, --unheld, --notes-file, --deps, --install, --clear-install, --title or --ticket");const B=d===void 0?void 0:await X(t,d);B&&await St(t,B);const{source:q,wave:mt,item:b}=await E(t,e),Ae=L.includes(b.status);if(w!==void 0&&(await ut(q.dir,w),b.plan=f.normalize(w)),y!==void 0&&(b.title=x(y,"--title")),m!==void 0){const A=await je(t,T(e).wave,m);A.length?b.deps=A:delete b.deps}if(p&&(b.held=!0),u&&(delete b.held,b.status==="held"&&delete b.status),(p||u)&&(b.held_at=new Date().toISOString()),n==="building"&&(b.held||b.status==="held")&&c(`${e} is held; start it only once the owner resumes it, with item set ${e} --unheld`),n!==void 0&&(b.status=Mt.includes(n)?n:c(`--status takes ${Mt.join(", ")}`)),n==="building"){const A=await ge(t,T(e).wave,b);A.length&&c(`${e} is blocked by ${A.join(", ")}; start it once ${A.length===1?"that is":"those are"} done or merged`)}const Ct=n==="building"?await jn(t,e,Ft):null,De=L.includes(n)?await he(t,e,`--status ${n}`,C):async()=>[];i&&delete b.status,(n!==void 0||i)&&(b.status_at=new Date().toISOString()),o!==void 0&&(b.next=x(o,"--next"),await Sn(t,e,b,b.next)),r&&delete b.next,l!==void 0&&(b.pr=/^[1-9]\d*$/.test(String(l))?Number(l):c("--pr takes a PR number"),ye(b)),B&&(b.from_ask=B),et&&(b.install=et),et===null&&delete b.install;const qt=a!==void 0||B&&!b.ticket&&!b.linear?.length?await V(t,e,mt,b,a,Nt,q.dir,ft(t,e)):null;await k(q.file,mt);const U=await De();w!==void 0&&U.push(...await kn(t,e,"Recorded in the card's notes")),Ct&&U.push(...(await cn(t,e,{text:Ct})).lines),qt&&U.push(qt);const Ut=Ue({status:n,pr:l}),Wt=Ut&&await We(await Se(t),b,Ut,{...Nt,repo:xe(t,mt)});Wt&&U.push(Wt),(l!==void 0||Rn.includes(n))&&await _n(q.dir,b.id,L.includes(n));const ht=B?await ot(t):{};if(W(ht,B)!==void 0&&(delete ht[B],await k(z(t),{links:ht})),!L.includes(n)||Ae)return{file:q.file,lines:U};const It=await xn(t,e),Re=new Date().toISOString();for(const A of It)await K(M(t,A),{ts:Re,who:"claude",text:`Unblocked: ${b.id} is ${n}.`}),await Ht({dir:t},"card-unblocked",{key:A});return{file:q.file,lines:[...It.map(A=>`unblocked: ${A}`),...U]}}s(be,"changeItem");async function je(t,e,a){const n=[...new Set(String(a).split(",").map(i=>i.trim()).filter(Boolean))];for(const i of n)await E(t,dt(e,i));return n}s(je,"depList");const xe=s((t,e)=>t&&zt().find(a=>Kt(a.dir,t))?.github||e.repo,"boardRepoOf"),Se=s(async t=>ue((await it(t)).tickets),"boardSource");async function V(t,e,a,n,i,o,r,l){try{const d=await it(t),p=yt(d.tickets||{source:"internal"}),u=s(($,j)=>$.internal===!0?String(j.id).replace(/^S(\d+)$/,`${p.prefix}-$1`):null,"ownId");i===void 0&&p.source==="internal"&&gt(p,u(a,n))&&(i=u(a,n));let w=0;if(p.source==="internal")for(const $ of await F(t)){const j=await g($.file,{});for(const O of[...j.items||[],...j.followups||[]]){const y=[O.ticket,u(j,O)];if(w=Math.max(w,...y.map(C=>gt(p,C)||0)),i!==void 0&&`${$.slug}/${O.id}`!==e&&y.includes(i))throw Object.assign(new I(`${i} is already the ticket of ${$.slug}/${O.id}`),{held:!0})}}const m=i===void 0&&p.source!=="internal"&&n.plan?await S.readFile(await ut(r,n.plan),"utf8"):n.notes||"",h=await qe(p,{ticket:i,title:n.title,body:m,repo:xe(t,a),next:w+1},o);return h.mcp?(delete n.ticket,delete n.ticket_created,Me(p,n.title,l)):(n.ticket=h.ticket,h.created&&p.source!=="internal"?n.ticket_created=!0:delete n.ticket_created,null)}catch(d){if(d instanceof I)throw d;c(d.message)}}s(V,"assignTicket");const tt=s((t,e)=>Je(f.join(t||at(),"tickets"),e,{heartbeat:!0}),"ticketWrite"),vn=s((t,e,a,n)=>a.ticket!==void 0||a.fromAsk!==void 0?tt(t,()=>be(t,e,a,n)):be(t,e,a,n),"setItem"),Pa=s((t,e,a,n)=>tt(t,()=>On(t,e,a,n)),"addItem"),Ta=s((t,e,a,n)=>tt(t,()=>An(t,e,a,n)),"addFollowup");async function On(t,e,{title:a,notes:n,deps:i,notesFile:o,ticket:r},l){const{wave:d,id:p}=T(e);P(p,"the item id");const{source:u,wave:w}=await J(t,d);w.items.some($=>$.id===p)&&c(`wave "${d}" already has an item "${p}"`);const m={id:p,title:x(a,"--title"),created:new Date().toISOString()};n!==void 0&&(m.notes=x(n,"--notes")),i!==void 0&&(m.deps=await je(t,d,i)),o!==void 0&&(await ut(u.dir,o),m.plan=f.normalize(o)),m.status=m.deps?.length?"waiting":"planned";const h=await V(t,e,w,m,r,l,u.dir,ft(t,e));return w.items.push(m),await k(u.file,w),{file:u.file,lines:h?[h]:[]}}s(On,"createItem");async function An(t,e,{id:a,title:n,from:i,ticket:o},r){const{source:l,wave:d}=await J(t,e);P(a,"--id");const p=d.followups||[];p.some(m=>m.id===a)&&c(`wave "${e}" already has follow-up ${a}`);const u={id:a,title:x(n,"--title"),...i===void 0?{}:{from:x(i,"--from")},filed:new Date().toISOString().slice(0,10)},w=await V(t,`${e}/${a}`,d,u,o,r,l.dir,ft(t,`${e}/${a}`,!0));return p.push(u),await k(l.file,{...d,followups:p}),{file:l.file,lines:w?[w]:[]}}s(An,"createFollowup");const Ea=s((t,e,a,n)=>tt(t,async()=>{const{source:i,wave:o}=await J(t,e),r=(o.followups||[]).find(l=>l.id===a)||c(`wave "${e}" has no follow-up "${a}"`);return await V(t,`${e}/${a}`,o,r,x(n,"--ticket"),void 0,i.dir),await k(i.file,o),i.file}),"setFollowupTicket"),ft=s((t,e,a=!1)=>{const n=t?`--site ${f.basename(t)} `:"";return a?`board.mjs ${n}followup set ${e.replace("/"," ")}`:`board.mjs ${n}item set ${e}`},"setTicketCommand"),La=s((t,{dryRun:e=!1}={},a)=>tt(v(t),()=>Dn(t,e,a)),"backfillTickets");async function Dn(t,e,a){const n=await Se(t)||c("this board has no ticket source yet; pick one in Board settings first"),i=new Set,o=[];for(const p of await F(t)){const u=await g(p.file,null);if(Array.isArray(u?.items)){o.push({entry:p,wave:u});for(const w of[...u.items,...u.followups||[]])w.ticket&&i.add(w.ticket),u.internal===!0&&n.source==="internal"&&i.add(String(w.id).replace(/^S(\d+)$/,`${n.prefix}-$1`))}}const r=[],l={linked:0,created:0,failed:0,mcp:0};for(const{entry:p,wave:u}of o)for(const w of[...u.items,...u.followups||[]]){const m=!u.items.includes(w);if(w.ticket||(m?w.done:L.includes(w.status)))continue;const h=`${p.slug}/${w.id}`,$=[...Ie(n,w.title),...(w.linear||[]).filter(j=>gt(n,j))].find(j=>n.source!=="internal"||!i.has(j));if(e){l[$?"linked":"created"]++,r.push(`${h} would ${$?`link ${$}`:"get a new ticket"}`);continue}try{const j=await V(t,h,u,w,$,a,p.dir,ft(t,h,u.items.includes(w)===!1));if(j){l.mcp++,r.push(`${h} ${j}`);continue}await k(p.file,u),i.add(w.ticket),l[$?"linked":"created"]++,r.push(`${h} ${$?"linked":"created"} ${w.ticket}`)}catch(j){if(!(j instanceof I))throw j;l.failed++,r.push(`${h} failed: ${j.message}`)}}const d=e?`would link ${l.linked}, create ${l.created}`:`linked ${l.linked}, created ${l.created}, failed ${l.failed}${l.mcp?`, ${l.mcp} to create through the Linear MCP`:""}`;return{lines:[...r,`backfill${e?" (dry run)":""}: ${d}`]}}s(Dn,"backfill");async function Ba(t,e,a,{force:n}={}){const{source:i,wave:o}=await J(t,e),r=(o.followups||[]).find(d=>d.id===a)||c(`wave "${e}" has no follow-up "${a}"`),l=await he(t,`${e}/${a}`,"followup done",n);return r.done=!0,await k(i.file,o),{file:i.file,lines:await l()}}s(Ba,"finishFollowup");async function pt(t,e,a,n="main"){const{id:i}=T(e);/^[\w-]{1,40}$/.test(n)||c(`--agent takes a name of letters, digits, "_" and "-", not "${n}"`);const o=n==="main"?`${i}.json`:`${i}@${n}.json`;if(a)return f.join(f.resolve(a),"agents",o);const{source:r}=await E(t,e);return f.join(r.dir,"agents",o)}s(pt,"builderFile");const ve=s((t,e)=>typeof t=="string"&&/^\d{4}-\d\d-\d\dT/.test(t)&&!Number.isNaN(Date.parse(t))?new Date(t).toISOString():c(`${e} takes an ISO time such as 2026-10-23T16:30:00-07:00`),"isoTime"),Oe=s((t,e,a)=>t?x(e,a).slice(0,160):c(`${a} needs --site, since the line goes to the item's thread`),"progressLine");async function Bt(t,e,a="main",n,i,o){const r=a==="main"?"":n||a,l=r?`${r[0].toUpperCase()}${r.slice(1)}: ${i}`:i,d=M(t,e);(await R(d)).filter(p=>p.kind==="status").pop()?.text!==l&&await K(d,{ts:o,who:"claude",kind:"status",text:l})}s(Bt,"statusToThread");async function Fa(t,e,{label:a,progress:n,dir:i,agent:o="main",kind:r,eta:l,worktree:d}){const p=Ee();if(p.state==="paused")throw new I(Le(p));const u=_(n,O=>Oe(t,O,"--progress")),w=await pt(t,e,i,o),m=new Date().toISOString(),h=_(r,O=>/^[\w.-]{1,30}$/.test(O)?O:c("--kind takes a short word such as opus or codex")),$={label:a===void 0?"Builder":x(a,"--label"),...h?{kind:h}:{},started:m,...l===void 0?{}:{eta:ve(l,"--eta")}},j=d?await d():null;return await k(w,j?{...$,worktree:j}:$),u&&await Bt(t,e,o,h,u,m),{file:w,lines:j?[`worktree: ${j.path}`]:[]}}s(Fa,"startBuilder");async function Na(t,e,{dir:a}={}){const{id:n}=T(e),i=f.dirname(await pt(t,e,a)),o=await wt(f.dirname(i),n);return(await Promise.all(o.map(l=>g(l,null)))).filter(l=>l?.worktree?.path).sort((l,d)=>String(d.started).localeCompare(String(l.started)))[0]?.worktree??null}s(Na,"recordedWorktree");async function Ca(t,e,a,{dir:n,agent:i="main",eta:o,clearEta:r}){o!==void 0&&r&&c("pass --eta or --clear-eta, not both");const l=Oe(t,a,"builder progress"),d=await pt(t,e,n,i),p=new Date().toISOString(),{progress:u,progress_at:w,done:m,...h}=await g(d,{label:"Builder",started:p});return o!==void 0&&(h.eta=ve(o,"--eta")),r&&delete h.eta,await k(d,h),await Bt(t,e,i,h.kind,l,p),d}s(Ca,"builderProgress");const Rn=["checking","done","merged","dropped"];async function wt(t,e){const a=f.join(t,"agents");return(await S.readdir(a).catch(()=>[])).filter(n=>n===`${e}.json`||n.startsWith(`${e}@`)&&n.endsWith(".json")).map(n=>f.join(a,n))}s(wt,"builderFiles");async function _n(t,e,a){const n=new Date().toISOString();for(const i of await wt(t,e)){const o=await g(i,null);if(!o||o.done||o.kind==="install"&&!a)continue;const{eta:r,...l}=o;await k(i,{...l,done:n})}}s(_n,"closeBuilders");async function Pn(t,e,{dir:a,agent:n,startedBetween:i,note:o}){const r=await pt(t,e,a,n),l=await g(r,null);if(!l||l.done)return r;if(i){const y=Date.parse(l.started);if(!(y>=i[0]&&y<=i[1]))return r}const{eta:d,...p}=l,u=new Date().toISOString();await k(r,{...p,done:u,...o?{note:o}:{}}),o&&await Bt(t,e,n,l.kind,o,u);const{id:w}=T(e),m=f.dirname(f.dirname(r));if((await Promise.all((await wt(m,w)).map(y=>g(y,null)))).some(y=>y?.started&&!y.done))return r;const $=a?{file:f.join(m,"wave.json")}:(await E(t,e)).source,j=await g($.file,null),O=j?.items?.find(y=>y.id===w);return ye(O)&&await k($.file,j),r}s(Pn,"stopBuilder");async function Tn(t){const e=[];for(const a of await F(t)){const n=await g(a.file,null);for(const i of n?.items||[])for(const o of await wt(a.dir,i.id)){const r=await g(o,null);if(!r?.started||r.done)continue;const l=f.basename(o,".json");e.push({key:`${a.slug}/${i.id}`,agent:l.slice(String(i.id).length+1)||"main",label:r.label||"Builder",started:r.started})}}return e}s(Tn,"openBoardBuilders");async function qa(t){const e=await Tn(t);for(const a of e)await Pn(t,a.key,{agent:a.agent,note:"Board closed. Builder record stopped; work is kept for reopening."});return e}s(qa,"closeBoardBuilders");export{I as BoardError,Xt as PUSH_LINE_MAX,xt as UPLOAD_LIMIT,da as ackHello,Ta as addFollowup,Pa as addItem,Sa as addPrototype,Aa as addQuestions,pa as addReviewers,ga as addRuleTo,xa as addTopic,cn as appendThread,La as backfillTickets,it as boardConfig,Ca as builderProgress,qa as closeBoardBuilders,ka as editRuleIn,Ba as finishFollowup,ua as finishHandshake,te as hiddenFile,F as itemSources,va as listPrototypes,ya as listRules,ra as markAsk,ca as moveAsk,Tn as openBoardBuilders,T as parseKey,nn as pushLine,en as pushTag,ea as pushUrl,ot as readAskLinks,rt as readAskProgress,Rt as readBoardRules,ma as readBoardSettings,re as readHandshake,rn as readHidden,g as readJSON,Ra as readNotes,lt as readPrototypes,ia as readUpload,Ve as readWorking,Vn as recordPush,Na as recordedWorktree,oa as relateAsk,Oa as removePrototype,wa as removeReviewers,ba as removeRuleFrom,Xn as repliesSincePush,Da as resolveQuestion,ja as saveBoardRules,wn as saveBoardSettings,aa as saveUpload,ha as setBoardSetting,Ea as setFollowupTicket,na as setHidden,vn as setItem,_a as setMainInstall,fa as setReviewers,Gn as setWorking,$a as settingsLines,_t as settingsOf,Zn as siteDir,Ge as sitesDir,Fa as startBuilder,Pn as stopBuilder,Tt as takeFile,M as threadFile,sa as unfoldAsk,at as wavesDir,ta as withReplies,la as writeChecked,Yn as writeReply};
+`).replace(/<[^>]*>/g,"").replace(/&(?:#(x[\da-f]{1,6}|\d{1,7})|(\w+));/gi,(t,i,n)=>{const a=i&&parseInt(i.replace(/^x/i,""),/^x/i.test(i)?16:10);return i?a<=1114111?String.fromCodePoint(a):t:I(Ai,n.toLowerCase())??t})}r(Pi,"htmlText");function Ri(e){if(!e||!e.startsWith("/"))return e;const t=new URL(e,"http://board");return/^#item=[^&]+$/.test(t.hash)&&(t.hash=`${t.hash}&reply`),/\/[\w-]+\.html$/.test(t.pathname)&&!t.pathname.endsWith("/index.html")&&t.searchParams.set("from","push"),t.pathname+t.search+t.hash}r(Ri,"pushUrl");const Ni=r((e,t)=>`/${h.basename(e)}/#item=${encodeURIComponent(t)}&reply`,"threadUrl");async function Gt(e,t,i){const n=Di(i);if(!n)return[];const a=Gn(t),o=await Zn(a,s=>[n,ji.exec(s)?.[1]].filter(Boolean).join(" \xB7 "),Ni(e,t));return o===null?[]:[`queued push ${a} now reads: ${o}`]}r(Gt,"freshenPush");const Qt=r(e=>h.join(e,"data","hidden.json"),"hiddenFile"),Ei=r(async e=>new Set((await y(Qt(e),{events:[]})).events||[]),"readHidden");let Zt=Promise.resolve();function Ya(e,t,i){te(t,"the event id");const n=Zt.then(async()=>{const a=await Ei(e);i?a.add(t):a.delete(t),await x(Qt(e),{events:[...a]})});return Zt=n.catch(()=>{}),n}r(Ya,"setHidden");const st=20*1024*1024,se=r(e=>h.join(e,"data","uploads"),"uploadsDir"),ue=r((e,t)=>h.join(se(e),".meta",`${t}.json`),"uploadMeta"),Vt=/^\d+-[\w.-]+$/,Yt=/^[\w.+-]+\/[\w.+-]+$/,Xt=r(()=>Object.assign(new Q(`a file can be at most ${st/1024/1024} MB`),{status:413}),"tooLarge");async function Xa(e,t,{name:i,type:n,length:a}){if(O(e),a>st)throw Xt();const o=String(i||"").trim().slice(0,200)||"file",s=h.basename(o).replace(/[^\w.-]+/g,"-").replace(/^[.-]+/,"").slice(-80)||"file",d=String(n||"").split(";")[0].trim().toLowerCase(),l=Yt.test(d)?d:"application/octet-stream";await D.mkdir(h.dirname(ue(e,"x")),{recursive:!0});let u,f;for(let w=Date.now();!f;w++)u=`${w}-${s}`,f=await D.open(h.join(se(e),u),"wx").catch($=>$.code==="EEXIST"?null:Promise.reject($));const m=h.join(se(e),u);let p=0;try{for await(const w of t){if(p+=w.length,p>st)throw Xt();await f.write(w)}}catch(w){throw await f.close(),await D.rm(m,{force:!0}),w}return await f.close(),await x(ue(e,u),{name:o,type:l,size:p,at:new Date().toISOString()}),{name:o,url:`uploads/${u}`,path:m,type:l,size:p}}r(Xa,"saveUpload");async function eo(e,t){if(!Vt.test(t||""))return null;const i=h.join(se(e),t),n=await D.stat(i).catch(()=>null);if(!n?.isFile())return null;const a=await y(ue(e,t),{});return{path:i,name:a.name||t,type:Yt.test(a.type||"")?a.type:"application/octet-stream",size:n.size}}r(eo,"readUpload");const en=["github","slack"];async function Ee(e,t,{text:i,link:n,who:a="claude",via:o}){if(O(e),String(t).startsWith("ask:"))await _e(e,t.slice(4),"the ask");else{const{wave:l,id:u}=T(t),{wave:f}=await le(e,l);f.items.some(m=>m.id===u)||c(`wave "${l}" has no item "${u}"`)}/^[^\n]{1,40}$/.test(a.trim())||c("--who takes claude, love or a reviewer's name"),o!==void 0&&!en.includes(o)&&c(`--via takes ${en.join(" or ")}`);const s={ts:new Date().toISOString(),who:a.trim(),text:_(i,"--text"),link:z(n,l=>Kt(l,"--link")),via:o},d=H(e,t);return await V(d,s),{file:d,lines:s.who==="claude"&&!o?await Gt(e,t,s.text):[]}}r(Ee,"appendThread");const fe=r(e=>h.join(e,"data","ask-links.json"),"askLinksFile");async function be(e){return(await y(fe(e),{})).links||{}}r(be,"readAskLinks");async function ne(e,t){const{tickets:i}=pe(await W(e)),n=await C(e),a=/^ask:(.+)$/.exec(t)?.[1];if(a===void 0){const s=/^([^/\s]+)\/([^/\s]+)$/.exec(t);if(!s)return t;const d=n.find(f=>f.slug===s[1]),l=d&&await y(d.file,null);if(!l)return s[2];const u=(l.items||[]).find(f=>f.id===s[2]);return ke(l,u||{id:s[2]},i)}const o=e?I(await be(e),a):void 0;if(o)return ne(e,o);for(const s of n){const d=await y(s.file,null),l=(Array.isArray(d?.items)?d.items:[]).find(u=>u.from_ask===a);if(l)return ke(d,l,i)}return`task ${a}`}r(ne,"cardName");async function to(e,t){const i=(await U(h.join(e,"data","events.jsonl"))).find(n=>n.id===t);return i?.kind==="ask"?ne(e,`ask:${t}`):typeof i?.data?.key=="string"?ne(e,i.data.key):`the ${i?.kind} event`}r(to,"eventCard");async function no(e,t,i,n){O(e),te(t,"the event id"),(await U(h.join(e,"data","events.jsonl"))).some(d=>d.id===t&&d.kind==="ask")||c(`no ask "${t}" in this site's data/events.jsonl`),await rt(e,t),await P(e,i);const o={ts:new Date().toISOString(),who:"claude",text:_(n,"--summary")},s=await be(e);return await x(fe(e),{links:{...s,[t]:i}}),await V(H(e,i),o),fe(e)}r(no,"relateAsk");async function io(e,t){await _e(e,t,"the ask");const i=await be(e);return I(i,t)===void 0&&c(`ask "${t}" is not folded into a card`),delete i[t],await x(fe(e),{links:i}),fe(e)}r(io,"unfoldAsk");const Te=r(e=>h.join(e,"data","ask-progress.json"),"askProgressFile");async function Le(e){return(await y(Te(e),{})).asks||{}}r(Le,"readAskProgress");async function rt(e,t){const i=I(await Le(e),t)?.moved;i&&c(`ask "${t}" was moved to /${i.route}; it lives there now`)}r(rt,"refuseMoved");async function ao(e,t,i,n){await _e(e,t,"the ask"),await rt(e,t);const a=await Le(e);return await x(Te(e),{asks:{...a,[t]:{state:i,at:new Date().toISOString(),...n===void 0?{}:{next:_(n,"--next")}}}}),Te(e)}r(ao,"markAsk");const Ti=[void 0,"planned","waiting"];async function Li(e,t,i){const n=`ask "${t}"`;if(i.some(f=>f.kind==="ask-withdrawn"&&f.data?.id===t&&!f.data?.key))return{why:`${n} was deleted by the owner`};const a=I(await Le(e),t);if(a?.moved)return{why:`${n} was already moved to /${a.moved.route}`};const o=I(await be(e),t);if(o)return{why:`${n} is folded into ${o}; run ask unfold ${t} first`};const s=[];for(const f of await C(e)){const m=await y(f.file,null);for(const p of Array.isArray(m?.items)?m.items:[])p.from_ask===t&&s.push({key:`${f.slug}/${p.id}`,it:p})}const d=s.find(({it:f})=>f.pr||!Ti.includes(f.status));return d?{why:`${n} became ${d.key}, which has started`}:s.length?{items:s.map(f=>f.key)}:(await Promise.all(["html","json"].map(f=>D.stat(h.join(e,"data","replies",`${t}.${f}`)).then(()=>!0,()=>!1)))).some(Boolean)||!!a||i.some(f=>f.kind==="ask-done"&&f.data?.id===t)||(await U(H(e,`ask:${t}`))).some(f=>(f.who||"claude")==="claude"&&f.kind!=="status")?{why:`${n} is not New: Claude already answered it`}:null}r(Li,"askNotNew");async function Bi(e,t,i){const n=/^uploads\/([\w.-]+)$/.exec(i?.url||"")?.[1],a=Vt.test(n||"")?h.join(se(e),n):null;if(!a||!await D.stat(a).then(l=>l.isFile(),()=>!1))return{name:String(i?.name||n||"file")};await D.mkdir(h.dirname(ue(t,"x")),{recursive:!0});const o=n.replace(/^\d+-/,"");let s;for(let l=Date.now();s=`${l}-${o}`,!await D.copyFile(a,h.join(se(t),s),Wn.COPYFILE_EXCL).then(()=>!0,f=>f.code==="EEXIST"?!1:Promise.reject(f));l++);const d=await y(ue(e,n),null);return d&&await x(ue(t,s),d),{...i,url:`uploads/${s}`,path:h.join(se(t),s)}}r(Bi,"copyUpload");async function oo(e,t,i){O(e),te(t,"the event id"),(typeof i!="string"||!i.trim())&&c("ask move needs --to <route>, the board to move it to");const n=await U(h.join(e,"data","events.jsonl")),a=n.find(v=>v.id===t&&v.kind==="ask")||c(`no ask "${t}" in this site's data/events.jsonl`),o=Ae(),s=o.find(v=>v.route===i)||c(`--to ${i}: no board at /${i} in the hub's manifest; the boards are ${o.map(v=>v.route).join(", ")||"none"}`);Pe(s.dir,e)&&c(`--to ${i}: that is this board`);const d=await Li(e,t,n);d?.why&&c(d.why);const l=n.filter(v=>v.kind==="ask-edited"&&v.data?.id===t&&typeof v.data?.text=="string").sort((v,S)=>String(v.ts).localeCompare(String(S.ts))).pop(),u=[];for(const v of a.data?.files||[])u.push(await Bi(e,s.dir,v));const f={route:h.basename(e),title:(await W(e)).title,id:t},m=l?l.data.text:a.data?.text||"",p=await Ve(s,"ask",{text:m,...u.length?{files:u}:{},from:f}),w={route:i,title:s.title,id:p},$=new Date().toISOString(),g=await Le(e);await x(Te(e),{asks:{...g,[t]:{state:"done",at:$,moved:w}}});const k=`/${i}/#item=${encodeURIComponent(`ask:${p}`)}`;await V(H(e,`ask:${t}`),{ts:$,who:"claude",text:`Moved to ${s.title}.`,link:k});for(const v of d?.items||[])await Oe(e,v,{status:"dropped",force:!0,text:`Dropped: its ask moved to ${s.title}.`});return{file:h.join(s.dir,"data","events.jsonl"),lines:[`moved to ${k}`,...(d?.items||[]).map(v=>`dropped: ${v}`)]}}r(oo,"moveAsk");const tn=r(e=>h.join(e,"data","checked.json"),"checkedFile");async function so(e,t,{idle:i}={}){O(e),i&&t!==void 0&&c("pass --every or --idle, not both"),i===void 0&&t===void 0&&(i=!await Ci(e));const n=new Date,a=i?null:t===void 0?ii(n,Xn()).every_minutes:/^[1-9]\d{0,3}$/.test(String(t))?Number(t):c("--every takes the minutes between checks, such as 30");return await x(tn(e),i?{at:n.toISOString(),every:null,idle:!0}:{at:n.toISOString(),every:a}),{file:tn(e),every:a,lines:await Ii()}}r(so,"writeChecked");async function Ci(e){for(const t of await C(e)){const i=await y(t.file,null);if((i?.items||[]).some(n=>Number.isInteger(n.pr)&&!L.includes(n.status))&&re(e,i))return!0}return!1}r(Ci,"hasOpenPR");async function Ii(){const e=Yn(new Date);if(e.hold)return e.count?[`queued pushes held: ${ni(e.hold)}`]:[];const t=await Vn();return t?[`sent ${t.sent} of ${t.count} queued push${t.count===1?"":"es"}${t.ok?"":"; the rest stay queued"}`]:[]}r(Ii,"flushAfterTick");const Be=r(e=>h.join(e,"data","handshake.json"),"handshakeFile"),nn=r(e=>y(Be(e),null),"readHandshake");async function ro(e,t){O(e),te(t,"the event id");const i=(await U(h.join(e,"data","events.jsonl"))).find(a=>a.id===t);i?.kind!=="hello"&&c(`no hello event "${t}" in this site's data/events.jsonl`);const n=await nn(e)||{};return n.hello?.id&&n.hello.id!==t&&c(`"${t}" is an older hello; ack the newest, "${n.hello.id}"`),await x(Be(e),{...n,hello:n.hello||{id:t,at:i.ts,session:null},ack:{id:t,at:new Date().toISOString()}}),Be(e)}r(ro,"ackHello");async function co(e){const t=await nn(e);t&&!t.done_at&&await x(Be(e),{...t,done_at:new Date().toISOString()})}r(co,"finishHandshake");const ct={name:/^[^\n]{1,40}$/,slack_user:/^U[A-Z0-9]+$/,dm:/^D[A-Z0-9]+$/,github:/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})$/},xe=r((e,t)=>e.trim().toLowerCase()===t.trim().toLowerCase(),"sameName");function dt(e,t){return Array.isArray(e)||c(`${t} must be a JSON array of reviewers`),e.forEach((i,n)=>{const a=`${t}[${n}]`;ye(i,Object.keys(ct),a);for(const[o,s]of Object.entries(ct))(typeof i[o]!="string"||!s.test(i[o].trim()))&&c(`${a}.${o} must match ${s}`);e.slice(0,n).some(o=>xe(o.name,i.name))&&c(`${t} names "${i.name}" twice`)}),e.map(i=>Object.fromEntries(Object.keys(ct).map(n=>[n,i[n].trim()])))}r(dt,"checkReviewers");async function lt(e,t){const i=h.join(O(e),"board.json"),n=await y(i,{}),a=dt(t(n.reviewers||[]),"the reviewers");await x(i,{...n,reviewers:a});const o=[];for(const s of await C(e)){const d=await y(s.file,null);(d?.items||[]).some(l=>!L.includes(l.status))&&(await x(s.file,{...d,reviewers:a}),o.push(`wave ${s.slug}: reviewers copied`))}return{file:i,lines:o}}r(lt,"writeReviewers");const lo=r((e,t)=>lt(e,()=>dt(t,"the reviewer file")),"setReviewers"),an=r((e,t)=>((typeof e!="string"||!/^\d+(?:\.\d+)?$/.test(e)||Number(e)<=0)&&c("--ts must be a Slack message timestamp"),(typeof t!="string"||!/^D[A-Z0-9]+$/.test(t))&&c("--channel must be a DM channel id"),{ts:e,channel:t}),"linkMessage"),ut=r((e,t,i)=>nt(e,t).find(n=>n.name===i)||c(`no reviewer "${i}" on this wave or board`),"reviewerOn"),uo=r((e,t,i,{ts:n,channel:a})=>me(e,async()=>{const o=an(n,a),{source:s,wave:d,item:l}=await P(e,t);return ut(d,(await W(e)).reviewers,i),l.review_link_ts={...l.review_link_ts,[i]:o},await x(s.file,d),s.file}),"reviewSent"),fo=r((e,t,i,n)=>me(e,async()=>{(typeof n!="string"||!/^[\w+-]+$/.test(n))&&c("emoji must be a Slack emoji name without colons");const{source:a,wave:o,item:s}=await P(e,t),d=ut(o,(await W(e)).reviewers,i),l=et(o,s,t,tt())[i];l?.ts||c(`no review link recorded for ${i} on ${t}`);const u=I(s.review_link_ts,i),f=typeof u=="object"&&Array.isArray(u?.reactions)?u.reactions:[];return f.includes(n)||(s.review_link_ts={...s.review_link_ts,[i]:{...l,channel:l.channel||d.dm,reactions:[...f,n]}},await x(a.file,o)),a.file}),"reviewReact"),on=r(e=>h.join(O(e),"data","review-digests.json"),"digestFile");async function po(e,t){O(e);const i=await Ut.waiting("slack");if(i)return{waiting:i,dms:[],reactions:[],digest:null};const n=await W(e),a=await y(Lt,{}),o=tt(),s=`board.mjs --site ${h.basename(e)}`,d=r(m=>/^[\w.@-]+$/.test(m)?m:JSON.stringify(m),"arg"),l=[],u=[];for(const m of await C(e)){const p=await y(m.file,{}),w=nt(p,n.reviewers),$=re(e,p);for(const g of p.items||[]){if(!Number.isInteger(g.pr)||!$||["done","dropped"].includes(g.status))continue;const k=`${m.slug}/${g.id}`,v=I(a.prs,`${$}#${g.pr}`),S=et(p,g,k,o);if(g.status==="merged"||g.merged_at||v?.state==="MERGED")for(const j of w){const R=I(S,j.name),B=I(g.review_link_ts,j.name);!R?.ts||Array.isArray(B?.reactions)&&B.reactions.includes("git_merged")||u.push({key:k,reviewer:j.name,channel:R.channel||j.dm,ts:R.ts,emoji:"git_merged",record:`${s} review react ${k} ${d(j.name)} git_merged`})}else if(v?.state==="OPEN"&&!v.isDraft){const j=`https://github.com/${$}/pull/${g.pr}`;for(const R of w.filter(B=>!I(S,B.name)))l.push({key:k,reviewer:R.name,channel:R.dm,text:j,record:`${s} review sent ${k} ${d(R.name)} --ts <ts> --channel ${R.dm}`})}}}const f=await qi(e,t);return{dms:l,reactions:u,digest:f.due?{...f,record:`${s} review digest sent <reviewer> --ts <ts> --channel <dm> --items <key,key>`}:null}}r(po,"reviewDue");async function qi(e,{now:t=new Date}={}){O(e);const i=await W(e),n=await y(Lt,{}),a=tt(),o=new Map;for(const f of await C(e)){const m=await y(f.file,{}),p=nt(m,i.reviewers);for(const $ of p)o.has($.name)||o.set($.name,{name:$.name,slack_user:$.slack_user,dm:$.dm,items:[]});const w=re(e,m);for(const $ of m.items||[]){if(!Number.isInteger($.pr)||!w||["merged","done","dropped"].includes($.status))continue;const g=`${f.slug}/${$.id}`,k=I(n.prs,`${w}#${$.pr}`);if(k?.state!=="OPEN"||k.isDraft||k.failing?.length||k.reviewDecision==="APPROVED")continue;const v=et(m,$,g,a);for(const S of p){const j=I(v,S.name),R=j?.ts?(t.getTime()-Number(j.ts)*1e3)/864e5:null;o.get(S.name).items.push({key:g,title:$.title,pr:$.pr,url:`https://github.com/${w}/pull/${$.pr}`,sent_ts:j?.ts||null,...R>2?{days_old:Math.floor(R)}:{}})}}}const{date:s,morning:d}=Wt(t),l=await y(on(e),{}),u=await Ut.waiting("slack");return{date:s,due:!u&&d&&l.last_date!==s,...u?{waiting:u}:{},reviewers:[...o.values()].filter(f=>f.items.length)}}r(qi,"reviewDigest");async function wo(e,t,{ts:i,channel:n,items:a},{now:o=new Date}={}){const s=an(i,n),d=[...new Set(_(a,"--items").split(",").map(f=>f.trim()))],l=await W(e);for(const f of d){const{wave:m}=await P(e,f);ut(m,l.reviewers,t)}const u=on(e);return qt(u,async()=>{const f=await y(u,{});return await x(u,{last_date:Wt(o).date,digests:[...f.digests||[],{reviewer:t,dm:s.channel,ts:s.ts,items:d,reactions:[]}]}),u})}r(wo,"reviewDigestSent");function mo(e,t){const i=dt(Array.isArray(t)?t:[t],"the reviewer file");return lt(e,n=>[...n.map(a=>i.find(o=>xe(o.name,a.name))||a),...i.filter(a=>!n.some(o=>xe(a.name,o.name)))])}r(mo,"addReviewers");function ho(e,t){return lt(e,i=>{const n=t.filter(a=>!i.some(o=>xe(o.name,a)));return n.length&&c(`this board has no reviewer ${n.map(a=>`"${a}"`).join(", ")}`),i.filter(a=>!t.some(o=>xe(a.name,o)))})}r(ho,"removeReviewers");const Fi=r(()=>h.join(Je.homedir(),".claude","kickflip","settings.json"),"hubSettingsFile"),ft=r(e=>{try{return e()}catch(t){throw t instanceof pi&&c(t.message),t}},"ruleCall"),pt=r(async e=>Ht(await y(h.join(e,"board.json"),{})),"readBoardRules");let sn=Promise.resolve();function rn(e,t){const i=sn.then(async()=>{const n=h.join(O(e),"board.json"),a=await y(n,{}),{set:o,...s}=t(a);return await x(n,{...a,...o}),{file:n,...s}});return sn=i.catch(()=>{}),i}r(rn,"writeBoardJSON");const cn=r((e,t)=>rn(e,i=>{const n=ft(()=>t(Ht(i)));return{set:{rules:n.rules},...n}}),"writeBoardRules"),dn=r(e=>typeof e=="string"&&/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})$/.test(e),"validGithubLogin"),ln=r(e=>{try{return e?Ye(e):null}catch{return null}},"storedTickets"),pe=r(e=>{const t=ln(e?.tickets);return{auto_merge:e?.auto_merge===!0,auto_build:e?.auto_build===!0,auto_pull:e?.auto_pull===!0,auto_triage:e?.auto_triage===!0,...t?{tickets:t}:{},...dn(e?.github_login)?{github_login:e.github_login}:{}}},"settingsOf");async function $o(e){return pe(await y(h.join(O(e),"board.json"),{}))}r($o,"readBoardSettings");function wt(e,t){ye(t,["auto_merge","auto_build","auto_pull","auto_triage","tickets","github_login"],"the settings"),Object.keys(t).length||c("the settings name nothing to change"),t={...t};for(const[i,n]of Object.entries(t))if(i==="tickets"){try{t.tickets=Ye(n)}catch(o){c(o.message)}const a=t.tickets.source==="github"&&e?Ae().find(o=>Pe(o.dir,e)):null;a&&!a.github&&c("GitHub issues need the board\u2019s repo on GitHub, and this board\u2019s repo isn\u2019t; pick internal or linear")}else i==="github_login"?n===""||n===null?t.github_login=void 0:dn(n)||c("github_login must be a GitHub login"):at(n,i);return rn(e,i=>{const n=pe(i),a=pe({...i,...t});return{set:t,settings:a,changed:Object.keys(t).filter(o=>JSON.stringify(n[o])!==JSON.stringify(a[o]))}})}r(wt,"saveBoardSettings");async function go(e,t,i){const n=String(t).replace(/-/g,"_"),a=["auto_merge","auto_build","auto_pull","auto_triage","github_login","tickets"];if(a.includes(n)||c(`no board setting "${t}"; settings are ${a.map(d=>d.replace(/_/g,"-")).join(", ")}`),n==="tickets"){let d;try{d=JSON.parse(i)}catch{c('settings set tickets takes the source as JSON, such as {"source":"github"}')}const{file:l,settings:u}=await wt(e,{tickets:d});return{file:l,lines:Mi({tickets:u.tickets})}}if(n==="github_login"){const{file:d,settings:l}=await wt(e,{github_login:i});return{file:d,lines:[`github-login ${l.github_login||"unset"}`]}}["on","off"].includes(i)||c(`settings set ${t} takes on or off, not "${i}"`);const{file:o,settings:s}=await wt(e,{[n]:i==="on"});return{file:o,lines:[`${t} ${s[n]?"on":"off"}`]}}r(go,"setBoardSetting");const Mi=r(e=>Object.entries(e).map(([t,i])=>`setting ${t.replace(/_/g,"-")} ${t==="tickets"?JSON.stringify(i):t==="github_login"?i:i?"on":"off"}`),"settingsLines");async function mt(e,t,i){const n=t?ft(()=>i(Re())):await cn(e,i);return t&&ft(()=>gi(n.rules)),{file:t?Fi():n.file,lines:[`id ${n.rule.id}`]}}r(mt,"changeRules");async function un(e,t,i){const n=r(s=>s.map(d=>d.id),"ids");i||O(e);const[a,o]=i?[n(Re()),e?n(await pt(e)):[]]:[n(await pt(e)),n(Re())];a.includes(t)||c(`no ${i?"hub":"board"} rule "${t}"${o.includes(t)?`; it is a ${i?"board":"hub"} rule, so ${i?"drop":"pass"} --hub`:""}`)}r(un,"checkRuleId");async function ko(e){const t=r(i=>n=>`${i} ${n.id} ${n.by==="claude"?"claude":"owner"} ${n.text}`,"line");return{lines:[...Re().map(t("hub")),...e?(await pt(e)).map(t("board")):[]]}}r(ko,"listRules");function yo(e,{text:t,hub:i=!1,by:n}){return i||O(e),mt(e,i,a=>wi(a,{text:t,by:n}))}r(yo,"addRuleTo");async function bo(e,t,{text:i,hub:n=!1}){return await un(e,t,n),mt(e,n,a=>mi(a,t,i))}r(bo,"editRuleIn");async function xo(e,t,{hub:i=!1}){return await un(e,t,i),mt(e,i,n=>hi(n,t))}r(xo,"removeRuleFrom");const vo=r((e,t,i)=>cn(e,n=>$i(n,t,i)),"saveBoardRules");async function So(e,{id:t,title:i,summary:n}){O(e);const a=await y(q(e),{topics:[],items:[]}),o=a.topics||[];return o.some(s=>s.id===_(t,"the topic id"))&&c(`topic "${t}" already exists`),o.push({id:t.trim(),title:_(i,"--title"),...n===void 0?{}:{summary:_(n,"--summary")}}),await x(q(e),{...a,topics:o,items:a.items||[]}),q(e)}r(So,"addTopic");const fn=["quiet","info","notice","danger","success"];function Ui(e,t){if(e.diagram===void 0!=(e.practice===void 0)&&c(`${t} needs diagram and practice together`),e.diagram===void 0)return;const i=e.diagram;(!Array.isArray(i)||!i.length)&&c(`${t}.diagram must be a non-empty array of rows`),i.forEach((n,a)=>{(!Array.isArray(n)||!n.length||n.length>4)&&c(`${t}.diagram[${a}] must be a row of 1 to 4 boxes`),n.forEach((o,s)=>{const d=`${t}.diagram[${a}][${s}]`;ye(o,["text","tone","to"],d),_(o.text,`${d}.text`),z(o.tone,l=>fn.includes(l)?l:c(`${d}.tone takes ${fn.join(", ")}`)),z(o.to,l=>Array.isArray(l)&&a+1<i.length&&l.every(u=>Number.isInteger(u)&&u>=0&&u<i[a+1].length)?l:c(`${d}.to must list boxes of the next row by index`))})}),(!Array.isArray(e.practice)||!e.practice.length)&&c(`${t}.practice must be a non-empty array of lines`),e.practice.forEach((n,a)=>_(n,`${t}.practice[${a}]`))}r(Ui,"checkDiagram");function Wi(e,t){(!Array.isArray(e)||!e.length)&&c(`${t}.options must be a non-empty array`);const i=new Set;e.forEach((n,a)=>{const o=`${t}.options[${a}]`;ye(n,["id","label","recommended","detail","diagram","practice"],o),Ui(n,o),i.has(_(n.id,`${o}.id`))&&c(`${t} has two options with id "${n.id}"`),i.add(n.id),_(n.label,`${o}.label`).startsWith(`${n.id}. `)&&c(`${o}.label starts with "${n.id}. ", but the page adds the option letter itself`),z(n.recommended,s=>at(s,`${o}.recommended`)),z(n.detail,s=>typeof s=="string"?s:c(`${o}.detail must be text`))}),e.filter(n=>n.recommended).length>1&&c(`${t} recommends more than one option`)}r(Wi,"checkOptions");const ve=r(e=>h.join(e,"data","prototypes.json"),"prototypesFile"),ht=r((e,t,i)=>h.join(e,"public","prototypes",t,`${i}.js`),"takeFile");async function Ce(e){const t=e?(await y(ve(e),{})).prototypes:null;return Array.isArray(t)?t:[]}r(Ce,"readPrototypes");const Hi=r(e=>typeof e=="string"&&/^[a-z0-9-]+$/.test(e)?e:c(`a prototype topic uses only a-z, 0-9 and "-", not "${e}"`),"prototypeTopic");function Ki(e){const t=/^([^:]*):(.*)$/s.exec(e);(!t||!/^[A-Z]$/.test(t[1]))&&c(`--take takes KEY:"Label" with KEY one capital letter, not "${e}"`);const i=_(t[2],`--take ${t[1]}'s label`);return/^[A-Z]\.\s/.test(i)&&c(`--take ${t[1]}'s label starts with "${i.slice(0,3)}"; the take pill shows the label alone, so drop the letter`),{key:t[1],label:i}}r(Ki,"prototypeTake");const we=r(e=>/^prototype-(.+)\.html$/.exec(h.posix.basename(String(e||"").split(/[?#]/)[0]))?.[1],"pageTopic");async function _o(e,{topic:t,title:i,card:n,takes:a=[]}){O(e),Hi(t),_(i,"--title"),a.length||c('prototype add needs a --take KEY:"Label" for each take');const o=a.map(Ki),s=o.find((u,f)=>o.findIndex(m=>m.key===u.key)!==f);s&&c(`--take ${s.key} is given twice`),n!==void 0&&await P(e,n);const d=await Ce(e);d.some(u=>u.topic===t)&&c(`prototype ${t} is already recorded; run prototype rm ${t} first, or pick another topic`),await D.stat(h.join(e,"public",`prototype-${t}.html`)).then(()=>!0,()=>!1)&&c(`public/prototype-${t}.html is a hand-written page that questions may link; pick another topic`);const l={topic:t,title:i.trim(),...n===void 0?{}:{card:n},takes:o,at:new Date().toISOString()};return await x(ve(e),{prototypes:[...d,l]}),{file:ve(e),lines:[`page prototype-${t}.html`,...o.map(u=>`take ${u.key} ${ht(e,t,u.key)}`)]}}r(_o,"addPrototype");async function jo(e){O(e);const t=await Ce(e);return{lines:t.length?t.map(i=>`${i.topic} \xB7 ${i.title} \xB7 ${i.takes.map(n=>`${n.key}: ${n.label}`).join(", ")}${i.card?` \xB7 ${i.card}`:""}`):["no prototypes recorded"]}}r(jo,"listPrototypes");async function Oo(e,t){O(e);const i=await Ce(e);i.some(o=>o.topic===t)||c(`no prototype "${t}" is recorded`);const a=((await y(q(e),{items:[]})).items||[]).filter(o=>!o.resolved&&we(o.url)===t).map(o=>o.id);return a.length&&c(`prototype ${t} backs open question ${a.join(", ")}; resolve ${a.length===1?"it":"them"} first`),await x(ve(e),{prototypes:i.filter(o=>o.topic!==t)}),ve(e)}r(Oo,"removePrototype");async function Ji(e,t,i){const n=t.url?.split(/[?#]/)[0];if(!n||!h.posix.basename(n).startsWith("prototype-"))return;const a=h.posix.basename(n),o=t.url.split("#")[0].split("?").slice(1).join("?"),s=`${i}.url`;new URLSearchParams(o).get("q")!==t.id&&c(`${s} must be ${a}?q=${t.id} so the pill can pick`);const d=we(n),l=(await Ce(e)).find(p=>p.topic===d);l||c(`${s} names ${a}, which is not a recorded prototype; record it with board.mjs prototype add ${d} --title "\u2026" --take A:"\u2026", then write its take files`);const u=l.takes.map(p=>p.key),f=t.options.map(p=>p.id),m=f.map(p=>u.indexOf(p));m.some((p,w)=>p<0||w>0&&p<m[w-1])&&c(`${i}.options ids ${f.join(", ")} must be a non-empty subset of ${a}'s takes, in take order: ${u.join(", ")}`);for(const p of u)await D.stat(ht(e,d,p)).then(w=>w.isFile(),()=>!1)||c(`${s} take ${p} has no file yet; write ${ht(e,d,p)}`)}r(Ji,"checkPrototype");async function zi(e,t){const{item:i}=await P(e,t);(i.status==="merged"||i.merged_at)&&c(`${t} is merged and stays closed; ask on an open card or a declared topic`)}r(zi,"refuseMergedCard");async function Do(e,t){O(e);const i=Array.isArray(t)?t:[t];i.length||c("the question file is empty");const n=await y(q(e),{topics:[],items:[]}),a=n.items||[],o=new Set(a.map(p=>p.id)),s=new Set((n.topics||[]).map(p=>p.id));for(const[p,w]of i.entries()){const $=`question ${w?.id??p+1}`;ye(w,["id","topic","source","question","context","url","urgent","options","round_of"],$),o.has(te(w.id,`${$}.id`))&&c(`question id "${w.id}" is already used`),o.add(w.id),_(w.topic,`${$}.topic`),w.topic.startsWith("item:ask:")?await _e(e,w.topic.slice(9),`${$}.topic`):w.topic.startsWith("item:")?await zi(e,w.topic.slice(5)):w.topic.startsWith("lineup:")?await Ue(e,w.topic.slice(7)):w.topic.startsWith("wave:")?await da(e,w.topic.slice(5)):s.has(w.topic)||c(`topic "${w.topic}" is not declared; add it with: topic add ${w.topic} --title <t>`),_(w.question,`${$}.question`);for(const g of["source","context"])z(w[g],k=>_(k,`${$}.${g}`));z(w.url,g=>Kt(g,`${$}.url`)),z(w.urgent,g=>at(g,`${$}.urgent`)),Wi(w.options,$),await Ji(e,w,$),z(w.round_of,g=>{const k=a.find(v=>v.id===g);k||c(`${$}.round_of names no question "${g}" in owner.json`),k.topic!==w.topic&&c(`${$}.round_of names ${g} on topic ${k.topic}; a round stays on its question's topic, ${w.topic}`),we(w.url)||c(`${$}.round_of needs a url on a recorded prototype, prototype-<topic>.html?q=${w.id}`)})}const d=await Ie(e),l=new Date().toISOString(),u=[],f=[];for(const p of i.filter(w=>w.round_of))p.round=Ze(a.find(w=>w.id===p.round_of))+1,Se(n,[p.round_of],`Followed by prototype round ${p.round}`,l),f.push(p.round_of);for(const p of i){const w=we(p.url),$=a.filter(k=>k.topic===p.topic).map(k=>ge(k,d)),g=p.topic.startsWith("item:")?pn($):[];for(const k of $)g.includes(k.id)?(Se(n,[k.id],`Followed by ${p.id}`,l),f.push(k.id)):!k.resolved&&w&&we(k.url)===w&&(Se(n,[k.id],`Replaced by ${p.id}`,l),u.push(k.id))}const m={...n,topics:n.topics||[],items:[...a,...i.map(p=>({...p,asked_at:l}))]};return await x(q(e),m),{file:q(e),lines:[...u.map(p=>`replaced: ${p}`),...f.map(p=>`resolved: ${p}`)]}}r(Do,"addQuestions");function pn(e){return e.filter(t=>t.state==="answered").map(t=>t.id)}r(pn,"answeredOnClaude");function Se(e,t,i,n=new Date().toISOString()){for(const a of e.items||[])t.includes(a.id)&&Object.assign(a,{resolved:i,resolved_at:n})}r(Se,"setResolved");async function $t(e,t,i,n){return Se(t,i,n),await x(q(e),t),q(e)}r($t,"markResolved");async function Ao(e,t,i){O(e);const n=await y(q(e),{topics:[],items:[]}),a=(n.items||[]).find(u=>u.id===t);a||c(`no question "${t}" in owner.json`);const o=await Ie(e);if(ge(a,o).state==="resolved")return q(e);const d=_(i,"--note");we(a.url)&&Gi(n,a,o);const l=await $t(e,n,[t],d);return await kt(e,a.topic),l}r(Ao,"resolveQuestion");async function Po(e,t){const i=t.filter(({choice:a,note:o})=>!a&&String(o||"").trim()).map(a=>a.id),n=i.length?await y(q(e),{topics:[],items:[]}):null;n?.items?.some(a=>i.includes(a.id))&&(Se(n,i,"Answered with a note"),await x(q(e),n))}r(Po,"resolveNoteAnswers");function Gi(e,t,i){const n=Ze(t),a=e.items.filter(o=>o.topic===t.topic&&Ze(o)===n).map(o=>ge(o,i));Qn(a,n)||c(`${t.id} is in prototype round ${n}, which no pick has settled yet; a pick settles it`)}r(Gi,"roundSettled");async function Ie(e){const t=(await U(h.join(e,"data","events.jsonl"))).filter(i=>i.kind==="owner-answer");return Promise.all(t.map(async i=>{const n=await Promise.all(["html","json"].map(a=>D.stat(h.join(e,"data","replies",`${i.id}.${a}`)).then(o=>o.isFile(),()=>!1)));return{...i,reply:i.reply||n.some(Boolean)}}))}r(Ie,"ownerAnswers");async function wn(e,t){const i=await y(q(e),{topics:[],items:[]}),n=await Ie(e),a=(i.items||[]).filter(o=>o.topic===t).map(o=>ge(o,n));return{owner:i,asked:a}}r(wn,"topicQuestions");const qe=r((e,t)=>wn(e,`item:${t}`),"cardQuestions"),gt=r((e,t,i)=>mn(e,`item:${t}`,i),"resolveAnswered");async function mn(e,t,i){if(!e)return[];const{owner:n,asked:a}=await wn(e,t),o=pn(a);return o.length&&await $t(e,n,o,i),await kt(e,t),o.map(s=>`resolved: ${s}`)}r(mn,"resolveAnsweredOn");const hn=r(async(e,t)=>!!e&&(await qe(e,t)).asked.some(i=>i.state==="open"),"hasOpenQuestion");function $n(e,t,i){e.next=_(t,"--next"),i?e.next_on_questions=!0:delete e.next_on_questions}r($n,"setNext");async function kt(e,t,{build:i=!1}={}){const n=t.startsWith("item:")&&!t.startsWith("item:ask:")?t.slice(5):null;if(!n)return;let a;try{a=await P(e,n)}catch(l){if(l instanceof Q)return;throw l}const{source:o,wave:s,item:d}=a;d.next_on_questions&&(!i&&(await qe(e,n)).asked.some(l=>l.state!=="resolved")||(delete d.next,delete d.next_on_questions,await x(o.file,s)))}r(kt,"clearWaitedNext");async function gn(e,t,i,n){if(!e)return async()=>[];const{owner:a,asked:o}=await qe(e,t),s=o.filter(l=>l.state==="open").map(l=>l.id);s.length&&!n&&c(`${i}: ${t} has ${s.length===1?"an open question":"open questions"} ${s.join(", ")} with no answer yet; pass --force to close the card and resolve ${s.length===1?"it":"them"} too`);const d=o.filter(l=>l.state!=="resolved").map(l=>l.id);return async()=>(d.length&&await $t(e,a,d,"Closed with the card"),d.map(l=>`resolved: ${l}`))}r(gn,"closeQuestions");async function Ro(e,t,i){await P(e,t),_(i,"--text"),await gn(O(e),t,"land",!1)}r(Ro,"checkClose");async function kn(e,t){const i=await y(q(e),{items:[]}),n=await Ie(e);return zn((i.items||[]).map(a=>ge(a,n)),t)}r(kn,"unpickedPrototype");const Qi=r(e=>e.length>120?`${e.slice(0,119)}\u2026`:e,"clip"),Zi={ask:"text","ask-edited":"text","item-message":"text","owner-answer":"note"};async function yn(e,t,i){const n=_(t,i).replace(/\s+/g," ");return(await U(h.join(e,"data","events.jsonl"))).map(o=>String(o.data?.[Zi[o.kind]]??"").replace(/\s+/g," ").toLowerCase()).some(o=>o.includes(n.toLowerCase()))||c(`${i} must quote the owner's words in an ask, card message or answer note on this board`),n}r(yn,"ownerQuote");async function No(e,t,i){return O(e),i===void 0&&c(`only the owner's Serve / Build and the hub's Auto-build start a card run; pass --asked "<the owner's words>" quoting where the owner asked for ${t}'s run`),`Running at the owner's ask: "${await yn(e,i,"--asked")}"`}r(No,"askedGate");async function _e(e,t,i="--from-ask"){return te(t,i),(await U(h.join(O(e),"data","events.jsonl"))).some(a=>a.id===t&&a.kind==="ask")?t:c(`no ask "${t}" in this site's data/events.jsonl`)}r(_e,"checkAsk");const L=["done","merged","dropped"],Vi=["ready","grilling","prototyping"];function yt(e){return["building","fixing"].includes(e?.status)?(delete e.status,e.status_at=new Date().toISOString(),!0):!1}r(yt,"clearBuildingStatus");const K=r((e,t)=>String(t).includes("/")?String(t):`${e}/${t}`,"depKey");async function je(e,t,i){const n=(i.deps||[]).map(o=>K(t,o)),a=await Promise.all(n.map(o=>P(e,o).then(({item:s})=>s,()=>null)));return n.filter((o,s)=>a[s]&&!L.includes(a[s].status))}r(je,"unfinishedDeps");async function Yi(e,t){const i=[];for(const n of await C(e)){const a=await y(n.file,null);for(const o of Array.isArray(a?.items)?a.items:[])![void 0,"planned","waiting","held"].includes(o.status)||!(o.deps||[]).some(s=>K(n.slug,s)===t)||(await je(e,n.slug,o)).length||i.push({key:`${n.slug}/${o.id}`,queued:!!o.queued_at})}return i}r(Yi,"unblockedBy");async function bn(e,t,i,n){const a=new Set(n.match(/[\w-]+(?:\.[\w-]+)*(?:\/[\w-]+(?:\.[\w-]+)*)*/g)||[]),o=new Set((i.deps||[]).map(s=>K(T(t).wave,s)));for(const s of await C(e)){const d=await y(s.file,null);for(const l of d?.items||[]){const u=`${s.slug}/${l.id}`;if(u===t||o.has(u)||L.includes(l.status))continue;[l.id,ke(d,l)].flatMap(m=>[m,`${s.slug}/${m}`]).some(m=>a.has(m))&&c(`--next names unfinished card ${u}; add it with --deps`)}}}r(bn,"checkNextDeps");async function Fe(e,t){const i=r(a=>c(`a notes file is a .md file inside ${e}, named relative to it: "${t}" ${a}`),"bad");(typeof t!="string"||!t.trim())&&i("is empty"),(h.isAbsolute(t)||t.split(/[\\/]/).includes(".."))&&i("leaves the folder"),h.extname(t).toLowerCase()!==".md"&&i("is not a .md file");const n=await D.realpath(h.resolve(e,t)).catch(()=>i("does not exist"));return n.startsWith(await D.realpath(e)+h.sep)||i("leaves the folder"),n}r(Fe,"planPath");async function Eo(e,t){const{source:i,wave:n,item:a}=await P(e,t);if(a.plan)return{wave:n,item:a,markdown:await D.readFile(await Fe(i.dir,a.plan),"utf8")};if(typeof a.notes=="string"&&a.notes.trim())return{wave:n,item:a,markdown:a.notes};c(`${t} has no notes`)}r(Eo,"readNotes");function xn({install:e,installSha:t,installLabel:i,clearInstall:n}){if(e===void 0)return(t!==void 0||i!==void 0)&&c("--install-sha and --install-label go with --install <url>"),n?null:void 0;n&&c("pass --install or --clear-install, not both");let a;try{a=new URL(String(e).trim())}catch{a=null}(!a||!["https:","itms-services:"].includes(a.protocol))&&c(`--install takes an https:// or itms-services:// URL, not "${e}"`),a.protocol==="itms-services:"&&!(a.searchParams.get("action")==="download-manifest"&&/^https:\/\//.test(a.searchParams.get("url")||""))&&c("--install: an itms-services:// URL needs ?action=download-manifest&url=https://\u2026/manifest.plist");const o=t===void 0?void 0:/^[0-9a-f]{7,40}$/i.test(t)?t.toLowerCase():c(`--install-sha takes a commit sha of 7 to 40 hex digits, not "${t}"`);return{url:String(e).trim(),...i===void 0?{}:{label:_(i,"--install-label")},built_at:new Date().toISOString(),...o?{sha:o}:{}}}r(xn,"installOf");async function To(e,{install:t,installSha:i}){const n=xn({install:t,installSha:i});n||c("main set needs --install <url>");const a=h.join(O(e),"data","main.json");return await x(a,{install:n}),{file:a,lines:["main install set"]}}r(To,"setMainInstall");function Xi(e,t,i,n,a){return n==="merged"?a??(i.status==="merged"?null:i.pr?`Merged PR #${i.pr}.`:"Merged."):(a===void 0&&e&&c(`--status ${n} needs --text "<what was done or left>", which becomes ${t}'s last thread line`),a??null)}r(Xi,"closingLine");async function vn(e,t,{ticket:i,status:n,clearStatus:a,next:o,clearNext:s,pr:d,pushed:l,ghSince:u,fromAsk:f,state:m,held:p,unheld:w,pickUpAt:$,notesFile:g,deps:k,parent:v,related:S,install:j,installSha:R,installLabel:B,clearInstall:N,title:ae,size:Y,model:M,force:F,text:J,who:$e},X){n!==void 0&&a&&c("pass --status or --clear-status, not both"),m!==void 0&&!Vi.includes(m)&&c("--state takes ready, grilling or prototyping"),F&&!L.includes(n)&&c(`--force goes with --status ${L.join(", ")}`),f!==void 0&&L.includes(n)&&c("--from-ask opens a card; close it in another call"),J!==void 0&&_(J,"--text"),J!==void 0&&f===void 0&&!L.includes(n)&&c(`--text goes with --from-ask or --status ${L.join(", ")}`),f!==void 0&&J===void 0&&c(`--from-ask needs --text "<first line>", the item's first thread line after the ask`),o!==void 0&&s&&c("pass --next or --clear-next, not both"),typeof o=="string"&&!o.trim()&&([o,s]=[void 0,!0]);const ce=ea({held:p,unheld:w,pickUpAt:$}),de=xn({install:j,installSha:R,installLabel:B,clearInstall:N});[n,a,o,s,d,l,u,f,m,ce,g,k,v,S,de,ae,Y,M,i].every(A=>A===void 0||A===!1)&&c("nothing to set: pass --status, --clear-status, --next, --clear-next, --pr, --pushed, --gh-since, --from-ask, --state, --held, --unheld, --pick-up-at, --notes-file, --deps, --parent, --related, --install, --clear-install, --title, --size, --model or --ticket");const E=f===void 0?void 0:await _e(e,f);E&&await rt(e,E);const{source:Z,wave:G,item:b}=await P(e,t);E&&b.from_ask&&b.from_ask!==E&&c(`${t} came from ask "${b.from_ask}", so ask "${E}" can't be its from-ask; to fold it in: item relate-ask ${E} ${t} --summary "<line>"`);const Cn=b.status,In=L.includes(b.status),St=await Promise.all((await he(Z.dir,b.id)).map(A=>y(A,null))),qn=Qe(b,St);if(g!==void 0&&(await Fe(Z.dir,g),b.plan=h.normalize(g)),ae!==void 0&&(b.title=_(ae,"--title")),Sn(b,{size:Y,model:M}),k!==void 0){const A=await jn(e,T(t).wave,k);A.length?b.deps=A:delete b.deps}if(v!==void 0){const A=await On(e,T(t).wave,t,v);A?b.parent=A:delete b.parent}const _t=S===void 0?null:await aa(e,t,b,S);if(ce!==void 0&&Me(b,ce),n==="building"&&(b.held||b.status==="held")&&c(b.pick_up_at?`${t} is held until ${b.pick_up_at}, when the board resumes it; start it early only with item set ${t} --unheld`:`${t} is held; start it only once the owner resumes it, with item set ${t} --unheld`),n!==void 0&&(b.status=Et.includes(n)?n:c(`--status takes ${Et.join(", ")}`)),(ta.includes(n)||d!==void 0||l!==void 0)&&na(b),n==="building"){const A=await je(e,T(t).wave,b);A.length&&c(`${t} is blocked by ${A.join(", ")}; start it once ${A.length===1?"that is":"those are"} done or merged`)}(n==="building"||L.includes(n))&&delete b.queued_at;const De=n==="building"&&e?await kn(e,t):null;De&&c(`${t} has no take picked: the owner's answer to ${De.id} picks none${De.note?` ("${Qi(De.note)}")`:""}; act on its note, with another prototype round when it asks for one, and build once a take is picked`);const Fn=L.includes(n)?await gn(e,t,`--status ${n}`,F):async()=>[],jt=L.includes(n)?Xi(e,t,{...b,status:Cn},n,J):null;if(a&&delete b.status,(n!==void 0||a)&&(b.status_at=new Date().toISOString()),o!==void 0&&($n(b,o,await hn(e,t)),await bn(e,t,b,b.next)),s&&(delete b.next,delete b.next_on_questions),n==="building"&&o===void 0&&b.next_on_questions&&(delete b.next,delete b.next_on_questions),d!==void 0&&(b.pr=/^[1-9]\d*$/.test(String(d))?Number(d):c("--pr takes a PR number"),yt(b)),l!==void 0){Ae().find(A=>Pe(A.dir,O(e)))?.remote||c("--pushed is for a board whose repo is a plain git remote; on GitHub, open a PR and pass --pr"),b.pr&&c(`${t} has PR #${b.pr}; its PR says when it merges`);try{ui(l)}catch{c("--pushed takes the name of the branch you pushed")}b.pushed={branch:l,at:new Date().toISOString()},b.branch=l,yt(b)}if(u!==void 0&&((typeof u!="string"||!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$/.test(u)||Number.isNaN(Date.parse(u)))&&c("--gh-since takes an ISO-8601 UTC time such as 2026-10-23T11:00:00Z"),b.gh_since=u),E&&(b.from_ask=E),m==="ready"&&e){const A=(await qe(e,t)).asked.filter(oe=>oe.state==="open").map(oe=>oe.id);A.length&&c(`${t} has ${A.length===1?"an open question":"open questions"} ${A.join(", ")}; it is ready once the owner has answered ${A.length===1?"it":"them"}`)}m!==void 0&&(b.state=m),de&&(b.install=de),de===null&&delete b.install,!qn&&!["building","fixing"].includes(n)&&Qe(b,St)&&c(`that leaves ${t} In Progress with nothing building and no Next; pass --next "<what happens next>"`);const Ot=i!==void 0||E&&!b.ticket&&!b.linear?.length?await bt(e,t,G,b,i,X,Z.dir,xt(e,t)):null;await x(Z.file,G),_t&&await _t();const ee=await Fn();g!==void 0&&ee.push(...await gt(e,t,"Recorded in the card's notes")),n==="building"&&ee.push(...await gt(e,t,"Acted on: build started")),E&&ee.push(...(await Ee(e,t,{text:J})).lines),jt&&e&&ee.push(...(await Ee(e,t,{text:jt,who:$e})).lines),Ot&&ee.push(Ot);const Dt=si({status:n,pr:d??l}),At=Dt&&await ri(await Dn(e),b,Dt,{...X,repo:re(e,G)});At&&ee.push(At),(d!==void 0||l!==void 0||ka.includes(n))&&await ya(Z.dir,b.id,L.includes(n));const Ke=E?await be(e):{};if(I(Ke,E)!==void 0&&(delete Ke[E],await x(fe(e),{links:Ke})),!L.includes(n)||In)return{file:Z.file,lines:ee};const Pt=await Yi(e,t),Mn=new Date().toISOString();for(const{key:A,queued:oe}of Pt)await V(H(e,A),{ts:Mn,who:"claude",text:`Unblocked: ${await ne(e,t)} is ${n}.`}),oe||await Ve({dir:e},"card-unblocked",{key:A});return{file:Z.file,lines:[...Pt.map(({key:A,queued:oe})=>oe?`queued build starts: ${A}`:`unblocked: ${A}`),...ee]}}r(vn,"changeItem");function Sn(e,{size:t,model:i}){for(const[n,a,o]of[["size",t,["small","large"]],["model",i,["opus","sonnet"]]])a!==void 0&&(a===""?delete e[n]:e[n]=o.includes(a)?a:c(`--${n} takes ${o.join(" or ")}, or "" to clear it`))}r(Sn,"setBuildChoice");function ea({held:e,unheld:t,pickUpAt:i}){return[e,t,i!==void 0].filter(Boolean).length>1&&c("pass one of --held, --unheld and --pick-up-at"),i!==void 0?i===""?null:{until:_n(i)}:e?{until:null}:t?null:void 0}r(ea,"holdOf");function _n(e){const t=typeof e=="string"&&ai.test(e)?Date.parse(e):NaN;return Number.isNaN(t)&&c('--pick-up-at takes an ISO time such as 2026-11-04T09:00, the Mac\u2019s local time unless it names an offset, or "" to resume the card'),t<=Date.now()&&c(`--pick-up-at ${e} has passed; pass a later time, or --unheld to resume the card now`),new Date(t).toISOString()}r(_n,"pickUpTime");const ta=["building","fixing","checking",...L];function na(e){delete e.held,delete e.pick_up_at}r(na,"clearHold");function Me(e,t){t?e.held=!0:delete e.held,t?.until?e.pick_up_at=t.until:delete e.pick_up_at,!t&&e.status==="held"&&delete e.status,e.held_at=new Date().toISOString()}r(Me,"setHold");async function Lo(e,t,i,{announce:n=!0}={}){const{source:a,wave:o,item:s}=await P(e,t);if(n){const d=new Date(i).toLocaleString("en-US",{weekday:"short",month:"numeric",day:"numeric",hour:"numeric",minute:"2-digit"});await V(H(e,t),{ts:new Date().toISOString(),who:"claude",text:`Resumed: its hold until ${d} ended.`}),!s.queued_at&&!(await je(e,T(t).wave,s)).length&&await Ve({dir:e},"card-unblocked",{key:t,until:i})}Me(s,null),await x(a.file,o)}r(Lo,"pickUp");async function ia(e,t,i){const n=String(i?.key||""),{wave:a,id:o}=T(n),{source:s,wave:d}=await le(e,a),l={text:"Marked done.",who:"love"},u=d.items.find(p=>p.id===o)||c(`wave "${a}" has no item "${o}"`);if(["merged","dropped"].includes(u.status))return null;if(t==="card-done")return Oe(e,n,{status:"done",force:!0,...l});const f=i.hold?typeof i.until=="string"?new Date(i.until).toISOString():null:void 0;Me(u,i.hold?{until:f}:null),await x(s.file,d);const m=f&&new Date(f).toLocaleString("en-US",{weekday:"short",month:"numeric",day:"numeric",hour:"numeric",minute:"2-digit"});return Ee(e,n,{text:i.hold?m?`Held until ${m}.`:"Held.":"Resumed.",who:"love"})}r(ia,"recordOwnerTap");async function jn(e,t,i){const n=[...new Set(String(i).split(",").map(a=>a.trim()).filter(Boolean))];for(const a of n)await P(e,K(t,a));return n}r(jn,"depList");async function On(e,t,i,n){if(!String(n).trim())return null;const a=K(t,String(n).trim());a===i&&c("--parent: a card can't be its own Parent");for(let o=a;o;){const{item:s}=await P(e,o);s.parent&&K(T(o).wave,s.parent)===i&&c(`--parent: ${a} is a child of ${i}, so it can't be its Parent`),o=s.parent?K(T(o).wave,s.parent):null}return a}r(On,"parentKey");async function aa(e,t,i,n){const a=[...new Set(String(n).split(",").map(o=>o.trim()).filter(Boolean).map(o=>K(T(t).wave,o)))];a.includes(t)&&c("--related: a card can't be related to itself");for(const o of a)await P(e,o);return a.length?i.related=a:delete i.related,async()=>{for(const o of await C(e)){const s=await y(o.file,null);let d=!1;for(const l of Array.isArray(s?.items)?s.items:[]){const u=`${o.slug}/${l.id}`;u===t||a.includes(u)||!(l.related||[]).some(f=>K(o.slug,f)===t)||(l.related=l.related.filter(f=>K(o.slug,f)!==t),l.related.length||delete l.related,d=!0)}d&&await x(o.file,s)}}}r(aa,"setRelated");const re=r((e,t)=>e&&Ae().find(i=>Pe(i.dir,e))?.github||t.repo,"boardRepoOf");async function Bo(e,t){const{wave:i,item:n}=await P(e,t);(!Number.isInteger(n.pr)||n.pr<=0)&&c(`${t} has no PR`);const a=re(e,i);a||c(`${t} has no repo`);const o=n.gh_since||"1970-01-01T00:00:00Z";try{const s=pe(await W(e)).github_login||await fi();return Mt(await Ft({repo:a,pr:n.pr,since:o}),{pr:n.pr,since:o,me:s})}catch(s){c(s.message)}}r(Bo,"prReport");const Dn=r(async e=>ln((await W(e)).tickets),"boardSource");async function Co(e,t,{afterApproval:i,confirmed:n}={}){O(e);const{wave:a,item:o}=await P(e,t);Number.isInteger(o.pr)||c(`${t} has no PR`),L.includes(o.status)&&c(`${t} is ${o.status}`);const s=re(e,a)||c(`${t} has no repo`);let d;try{d=await Ft({repo:s,pr:o.pr,since:new Date().toISOString()})}catch(S){c(S.message)}const{view:l,reviews:u}=d;if(l.state==="MERGED")return Oe(e,t,{status:"merged",text:`PR #${o.pr} was already merged.`});const{failing:f,pending:m}=Mt(d,{pr:o.pr,since:new Date().toISOString(),me:null}),p=Jn({...l,checks:{state:f.length?"fail":m?"pending":"pass",failing:f,pending:m}}),w=u.filter(S=>S.state==="APPROVED").sort((S,j)=>String(S.submitted_at).localeCompare(String(j.submitted_at))).at(-1)?.commit_id,$=!!(w&&l.headRefOid&&w!==l.headRefOid);i!==void 0&&!$&&c("--after-approval: no commit came after the approval; drop it"),$&&i===void 0&&p.push('commits after the approval: pass --after-approval "<why they are trivial>" when they are, else ask the approver to look again');const g=o.manual_steps?.length?n===void 0?null:await yn(e,n,"--confirmed"):void 0;if(n!==void 0&&g===void 0&&c(`--confirmed: ${t} has no manual steps; drop it`),g===null&&p.push(`manual steps: merge only on the owner's word, with --confirmed "<their words>"`),p.length){const S=`Not merged: ${p.join("; ")}.`;await oa(e,t)&&await Ee(e,t,{text:S}),c(S)}const k=await new Promise(S=>{Rt("gh",["pr","merge",String(o.pr),"--repo",s,"--squash"],{encoding:"utf8",timeout:12e4},(j,R,B)=>S(j?String(B||j.message).trim().split(`
+`)[0]:null))});k&&c(`gh pr merge #${o.pr} failed: ${k}`);const v=[`Merged PR #${o.pr}.`,i!==void 0&&`After the approval: ${_(i,"--after-approval")}`,g&&`The owner's word on the manual steps: "${g}"`];return Oe(e,t,{status:"merged",text:v.filter(Boolean).join(" ")})}r(Co,"mergeCard");async function oa(e,t){const i=(await U(h.join(e,"data","events.jsonl"))).filter(a=>a.kind==="card-merge"&&a.data?.key===t).at(-1)?.ts,n=(await U(H(e,t))).filter(a=>(a.who||"claude")==="claude"&&a.kind!=="status").at(-1)?.ts;return!!i&&String(i)>String(n||"")}r(oa,"ownerMergeWaits");async function bt(e,t,i,n,a,o,s,d){try{const l=await W(e),u=Ye(l.tickets||{source:"internal"}),f=r(($,g)=>$.internal===!0?String(g.id).replace(/^S(\d+)$/,`${u.prefix}-$1`):null,"ownId");a===void 0&&u.source==="internal"&&Xe(u,f(i,n))&&(a=f(i,n));let m=0;if(u.source==="internal")for(const $ of await C(e)){const g=await y($.file,{});for(const k of g.items||[]){const v=[k.ticket,f(g,k)];if(m=Math.max(m,...v.map(S=>Xe(u,S)||0)),a!==void 0&&`${$.slug}/${k.id}`!==t&&v.includes(a))throw Object.assign(new Q(`${a} is already the ticket of ${$.slug}/${k.id}`),{held:!0})}}const p=a===void 0&&u.source!=="internal"&&n.plan?await D.readFile(await Fe(s,n.plan),"utf8"):n.notes||"",w=await oi(u,{ticket:a,title:n.title,body:p,repo:re(e,i),next:m+1},o);return w.mcp?(delete n.ticket,delete n.ticket_created,di(u,n.title,d)):(n.ticket=w.ticket,w.created&&u.source!=="internal"?n.ticket_created=!0:delete n.ticket_created,null)}catch(l){if(l instanceof Q)throw l;c(l.message)}}r(bt,"assignTicket");const me=r((e,t)=>qt(h.join(e||Ne(),"tickets"),t,{heartbeat:!0}),"ticketWrite"),Oe=r((e,t,i,n)=>i.ticket!==void 0||i.fromAsk!==void 0?me(e,()=>vn(e,t,i,n)):vn(e,t,i,n),"setItem"),Io=r((e,t,i,n)=>me(e,()=>sa(e,t,i,n)),"addItem");async function sa(e,t,{title:i,notes:n,deps:a,notesFile:o,ticket:s,pickUpAt:d,parent:l,size:u,model:f},m){const{wave:p,id:w}=t.includes("/")?T(t):{wave:t};w!==void 0&&te(w,"the item id");const{source:$,wave:g}=await le(e,p);w!==void 0&&g.items.some(j=>j.id===w)&&c(`wave "${p}" already has an item "${w}"`);const k={id:w,title:_(i,"--title"),created:new Date().toISOString()};l!==void 0&&(k.parent=await On(e,p,null,l)||c("--parent takes a card, such as <wave>/<id>")),n!==void 0&&(k.notes=_(n,"--notes")),Sn(k,{size:u,model:f}),a!==void 0&&(k.deps=await jn(e,p,a)),o!==void 0&&(await Fe($.dir,o),k.plan=h.normalize(o)),k.status=k.deps?.length?"waiting":"planned",d!==void 0&&Me(k,{until:_n(d)});const v=w===void 0?`${An(e)}item add ${p}/<id> --title <t>`:xt(e,t),S=await bt(e,t,g,k,s,m,$.dir,v);return w===void 0&&(S&&c(S),k.id=li(k.ticket),g.items.some(j=>j.id===k.id)&&c(`wave "${p}" already has an item "${k.id}"; link ${k.ticket} with item add ${p}/<id> --ticket ${k.ticket}`)),g.items.push(k),await x($.file,g),{file:$.file,key:`${p}/${k.id}`,lines:S?[S]:[]}}r(sa,"createItem");const An=r(e=>`board.mjs ${e?`--site ${h.basename(e)} `:""}`,"boardCommand"),xt=r((e,t)=>`${An(e)}item set ${t}`,"setTicketCommand"),qo=r((e,{dryRun:t=!1}={},i)=>me(O(e),()=>ra(e,t,i)),"backfillTickets");async function ra(e,t,i){const n=await Dn(e)||c("this board has no ticket source yet; pick one in Board settings first"),a=new Set,o=[];for(const f of await C(e)){const m=await y(f.file,null);if(Array.isArray(m?.items)){o.push({entry:f,wave:m});for(const p of m.items)p.ticket&&a.add(p.ticket),m.internal===!0&&n.source==="internal"&&a.add(String(p.id).replace(/^S(\d+)$/,`${n.prefix}-$1`))}}const s=[],d={linked:0,created:0,failed:0,mcp:0},l=r((f,m)=>m.ticket&&!(n.source!=="internal"&&f.internal===!0&&m.ticket===m.id),"ticketed");for(const{entry:f,wave:m}of o)for(const p of m.items){if(l(m,p)||L.includes(p.status))continue;const w=`${f.slug}/${p.id}`,$=[...ci(n,p.title),...(p.linear||[]).filter(g=>Xe(n,g))].find(g=>n.source!=="internal"||!a.has(g));if(t){d[$?"linked":"created"]++,s.push(`${w} would ${$?`link ${$}`:"get a new ticket"}`);continue}try{const g=await bt(e,w,m,p,$,i,f.dir,xt(e,w));if(g){d.mcp++,s.push(`${w} ${g}`);continue}await x(f.file,m),a.add(p.ticket),d[$?"linked":"created"]++,s.push(`${w} ${$?"linked":"created"} ${p.ticket}`)}catch(g){if(!(g instanceof Q))throw g;d.failed++,s.push(`${w} failed: ${g.message}`)}}const u=t?`would link ${d.linked}, create ${d.created}`:`linked ${d.linked}, created ${d.created}, failed ${d.failed}${d.mcp?`, ${d.mcp} to create through the Linear MCP`:""}`;return{lines:[...s,`backfill${t?" (dry run)":""}: ${u}`]}}r(ra,"backfill");const Fo=r(e=>me(e,async()=>{const t=[];for(const i of await C(e)){const n=await y(i.file,null);if(!Array.isArray(n?.items)||!Array.isArray(n.followups))continue;const a=n.followups.find(l=>n.items.some(u=>u.id===l.id));a&&c(`${i.slug}: follow-up ${a.id} has the id of a card; rename one, then restart the board`);const o=[];for(const{id:l,title:u,from:f,filed:m,done:p,...w}of n.followups){const $=p?e&&(await U(H(e,`${i.slug}/${l}`))).map(g=>g.ts).filter(Boolean).sort().pop()||m:null;o.push({id:l,title:u,...m?{created:m}:{},...f?{parent:K(i.slug,f)}:{},status:p?"done":"planned",...$?{status_at:$}:{},...w})}const{followups:s,...d}=n;await x(i.file,{...d,items:[...n.items,...o]}),t.push(`${i.slug}: ${o.length} follow-ups moved to cards (${o.filter(l=>l.status==="done").length} done)`)}return t}),"migrateFollowups"),Pn=r(e=>`lineup-${e}.md`,"lineupNoteFile"),ca=r(e=>typeof e=="string"&&/^[a-z0-9-]+$/.test(e)?e:c(`a wave's slug uses only a-z, 0-9 and "-", not "${e}"`),"lineupSlug");async function Ue(e,t){for(const i of await C(e)){const n=await y(i.file,null),a=(n?.lineups||[]).find(o=>o.slug===t);if(a)return{source:i,wave:n,lineup:a}}return c(`this board has no wave "${t}"; lineup create makes one`)}r(Ue,"findLineup");async function da(e,t){(await W(e)).items!=="waves"&&c(`topic wave:${t} is for a board over ~/.claude/waves; a lineup's triage uses lineup:<slug>`),await le(e,t)}r(da,"triagedWave");function We(e,t,i,n){return i.map(a=>{const{wave:o,id:s}=T(a);o!==e.slug&&c(`${a} is not in wave file "${e.slug}"; a wave's cards share one file`),t.items.some(l=>l.id===s)||c(`wave "${o}" has no item "${s}"`);const d=(t.lineups||[]).find(l=>l.slug!==n&&!l.finished_at&&l.items.includes(s));return d&&c(`${a} is already in the wave "${d.slug}"; lineup remove ${d.slug} ${a} first`),s})}r(We,"lineupCards");function Rn(e,t,i,n){const a=new Set(i.map(o=>`${e.slug}/${o}`));for(const o of i){const s=t.items.find(u=>u.id===o),d=(s.deps||[]).filter(u=>!a.has(K(e.slug,u))),l=n.indexOf(o);l>0&&d.push(n[l-1]),d.length?s.deps=d:delete s.deps}}r(Rn,"chain");async function Nn(e,t,i,n,a){a!==void 0&&await it(h.join(t.dir,Pn(n.slug)),`${_(a,"the note").replace(/\n*$/,`
+`)}`),await x(t.file,i);const{tickets:o}=pe(await W(e));return{file:t.file,lines:[`order: ${n.items.map(s=>ke(i,i.items.find(d=>d.id===s),o)).join(" \u2192 ")}`]}}r(Nn,"writeLineup");async function Mo(e,t,{title:i,goal:n,cards:a,note:o}){ca(t);const s=String(a??"").split(",").map(p=>p.trim()).filter(Boolean);s.length||c("--cards takes the cards in build order, as <wave>/<id>,<wave>/<id>"),o===void 0&&c("lineup create needs the wave note, as --note <text> or --file <path>");const d=await C(e);d.some(p=>p.slug===t)&&c(`"${t}" is a wave file on this board; pick another slug`);for(const p of d)((await y(p.file,null))?.lineups||[]).some(w=>w.slug===t)&&c(`this board already has a wave "${t}"`);const l=d.find(p=>p.slug===T(s[0]).wave)||c(`this board has no wave "${T(s[0]).wave}"`),{wave:u}=await le(e,l.slug),f=We(l,u,s,t);new Set(f).size!==f.length&&c("--cards names a card twice");const m={slug:t,title:_(i,"--title"),goal:_(n,"--goal"),items:f,created:new Date().toISOString()};return Rn(l,u,f,f),u.lineups=[...u.lineups||[],m],Nn(e,l,u,m,o)}r(Mo,"createLineup");async function Uo(e,t,{add:i,after:n,remove:a,title:o,goal:s,note:d}){[i,a,o,s,d].every(p=>p===void 0)&&c("nothing to change: pass --add, --remove, --title, --goal, --note or --file"),n!==void 0&&i===void 0&&c("--after goes with --add");const{source:l,wave:u,lineup:f}=await Ue(e,t);f.finished_at&&c(`the wave "${t}" is finished`);const m=[...f.items];if(i!==void 0){const[p]=We(l,u,[i],t);f.items.includes(p)&&c(`${i} is already in the wave "${t}"`);const w=n===void 0?f.items.length:f.items.indexOf(We(l,u,[n],t)[0])+1;w===0&&c(`--after ${n} is not in the wave "${t}"`),f.items.splice(w,0,p)}if(a!==void 0){const[p]=We(l,u,[a],t);f.items.includes(p)||c(`${a} is not in the wave "${t}"`),f.items.length===1&&c(`${a} is the wave's last card; lineup finish ${t} ends the wave`),f.items=f.items.filter(w=>w!==p)}return o!==void 0&&(f.title=_(o,"--title")),s!==void 0&&(f.goal=_(s,"--goal")),Rn(l,u,[...new Set([...m,...f.items])],f.items),Nn(e,l,u,f,d)}r(Uo,"changeLineup");async function Wo(e,t){const{source:i,wave:n,lineup:a}=await Ue(e,t);return a.finished_at=new Date().toISOString(),await x(i.file,n),{file:i.file}}r(Wo,"finishLineup");async function Ho(e,t,i){const{source:n,wave:a,lineup:o}=await Ue(e,t),s=await D.readFile(h.join(n.dir,Pn(t)),"utf8").catch(()=>""),d=o.items.map(l=>ke(a,a.items.find(u=>u.id===l)||{id:l},i)).join(" \u2192 ");return{title:o.title,markdown:`**Goal** ${o.goal}
+
+**Order** ${d}
+
+${s}`}}r(Ho,"readLineupNotes");async function ie(e,t,i,n="main"){const{id:a}=T(t);/^[\w-]{1,40}$/.test(n)||c(`--agent takes a name of letters, digits, "_" and "-", not "${n}"`);const o=n==="main"?`${a}.json`:`${a}@${n}.json`;if(i)return h.join(h.resolve(i),"agents",o);const{source:s}=await P(e,t);return h.join(s.dir,"agents",o)}r(ie,"builderFile");const En=r((e,t)=>typeof e=="string"&&/^\d{4}-\d\d-\d\dT/.test(e)&&!Number.isNaN(Date.parse(e))?new Date(e).toISOString():c(`${t} takes an ISO time such as 2026-10-23T16:30:00-07:00`),"isoTime"),la=["reading","building","testing","checking","landing"],Tn=80,Ln="reading, building, testing, checking or landing";function Bn(e,t,i,n){e||c(`${n} needs --site, since the line goes to the item's thread`),t===void 0&&c(`${n} needs --phase ${Ln}`),la.includes(t)||c(`--phase takes ${Ln}, not "${t}"`);const a=_(i,n);return a.length>Tn&&c(`${n} is ${a.length} characters; the cap is ${Tn}. Say it shorter.`),{phase:t,detail:a}}r(Bn,"progressLine");async function vt(e,t,i="main",n,{phase:a,detail:o},s){const d=Tt(n),u=[i==="main"?"":(d?n.kind:ze(n))||n.kind||i,a].filter(Boolean).join(" "),f=u?`${u[0].toUpperCase()}${u.slice(1)}: ${o}`:o,m=H(e,t);(await U(m)).filter(p=>p.kind==="status").pop()?.text!==f&&await V(m,{ts:s,who:"claude",kind:"status",...a?{phase:a}:{},...d?{planner:!0}:{},text:f})}r(vt,"statusToThread");const ua={prototype:"sonnet",grill:"opus"};async function fa(e,t,{label:i,phase:n,progress:a,dir:o,agent:s="main",kind:d,model:l,eta:u,worktree:f,tapped:m,dispatch:p}){const w=Bt();if(w.state==="paused")throw new Q(Ct(w));n!==void 0&&a===void 0&&c('--phase goes with --progress "<detail>"');const $=z(a,G=>Bn(e,n,G,"--progress")),g=await ie(e,t,o,s),k=new Date().toISOString(),v=z(d,G=>/^[\w.-]{1,30}$/.test(G)?G:c("--kind takes a short word such as claude or codex")),S=Ge(v),j=l??(v==="opus"||v==="sonnet"?v:void 0),R=["build",...ga].includes(S),B=await y(g,null),N=(B?.tapped||B?.dispatched)&&!B.done?B:null,ae=R&&!o?(await P(e,t)).item:void 0,Y=B&&He(B).length?B:null,M=N&&S==="build"?{kind:Ge(N.kind),model:N.model,reason:N.tapped?"The owner's Build tap picked it.":"The session's dispatch picked it."}:R?It({card:ae??{}}):null;M&&S!=="build"&&S!==M.kind&&c(`--kind ${S}: ${M.kind} builds now. ${M.reason} Pass --kind ${M.kind}, or --kind build.`);const F=M?M.kind:S;l!==void 0&&!["opus","sonnet"].includes(l)&&c("--model takes opus or sonnet"),j!==void 0&&F==="codex"&&c("--model is for kind claude; codex needs none");const J=F==="claude"?ti():"auto";j!==void 0&&J!=="auto"&&j!==J&&c(`--model ${j}: the hub's Claude model is ${J==="opus"?"Opus":"Sonnet"}. Pass --model ${J}, or no --model.`);const $e=F==="claude"?j??M?.model??(N&&Ge(N.kind)==="claude"?N.model:void 0)??"opus":Tt({kind:F})?j??(N?.kind===F?N.model:void 0)??ua[F]:void 0,X={label:i===void 0?"Builder":_(i,"--label"),...F?{kind:F}:{},...$e?{model:$e}:{},started:k,...u===void 0?{}:{eta:En(u,"--eta")},...m?{tapped:!0}:{},...p?{dispatched:!0}:{},...Y?{calls:Y.calls,...Y.verified?{verified:Y.verified}:{}}:{}},ce=R&&!o&&![...L,"building","fixing"].includes(ae.status),de=ce?await Oe(e,t,{status:"building"}):{lines:[]};let E;try{E=f?await f():(N??Y)?.worktree??null}catch(G){throw ce&&await $a(e,t,ae),G}await x(g,E?{...X,worktree:E}:X),$&&await vt(e,t,s,X,$,k);const Z=await gt(e,t,"Acted on: builder started");return e&&Kn({kind:F})&&await kt(e,`item:${t}`,{build:!0}),{file:g,kind:F??null,model:$e??null,reason:M?.reason??null,worktree:E?.path??null,lines:[...S==="build"?[`kind: ${F}. ${M.reason}`]:[],...ze(X)?[`model: ${ze(X)}`]:[],...e?[`ref: ${await ne(e,t)}`]:[],...E?[`worktree: ${E.path}`]:[],...de.lines,...Z]}}r(fa,"startBuilder");async function pa(e,t,i){try{const{held:n,blockers:a}=await wa(e,t);if(n&&await ia(e,"card-hold",{key:t,hold:!1}),a.length)return await ma(e,t,a);try{const o=await fa(e,t,{kind:"build",worktree:i,tapped:!0});return{key:t,ref:await ne(e,t),kind:o.kind,...o.model?{model:o.model}:{},reason:o.reason,worktree:o.worktree}}catch(o){throw n&&await ha(e,t,n),o}}catch(n){if(!(n instanceof Q))throw n;return await V(H(e,t),{ts:new Date().toISOString(),who:"claude",kind:Nt,text:`Couldn't start implementing: ${n.message}`}),null}}r(pa,"startTappedBuild");async function wa(e,t){const i=Bt();i.state==="paused"&&c(Ct(i));const{item:n}=await P(e,t),a=n.held||n.status==="held"?{held:n.held,status:n.status,pick_up_at:n.pick_up_at,held_at:n.held_at}:null;a&&n.status&&n.status!=="held"&&c("it's held. Unhold it, then tap Implement."),await kn(e,t)&&c("no take is picked on its prototypes. Pick one, then tap Implement.");const o=await Promise.all((await je(e,T(t).wave,n)).map(s=>ne(e,s)));return{held:a,blockers:o}}r(wa,"tapRefusals");async function ma(e,t,i){const{source:n,wave:a,item:o}=await P(e,t);return o.queued_at||(o.queued_at=new Date().toISOString(),await x(n.file,a),await V(H(e,t),{ts:o.queued_at,who:"claude",text:`Implement queued: it starts once ${i.join(", ")} ${i.length===1?"is":"are"} done.`})),{key:t,ref:await ne(e,t),queued:i}}r(ma,"queueBuild");async function Ko(e){const t=[];for(const i of await C(e)){const n=await y(i.file,null);for(const a of Array.isArray(n?.items)?n.items:[])!a.queued_at||a.held||a.status==="held"||L.includes(a.status)||(await je(e,i.slug,a)).length||t.push(`${i.slug}/${a.id}`)}return t}r(Ko,"dueQueuedBuilds");async function Jo(e,t,i){let n;try{n=await pa(e,t,i)}catch(a){await V(H(e,t),{ts:new Date().toISOString(),who:"claude",kind:Nt,text:`Couldn't start implementing: ${a.message}`}),n=null}if(!n){const{source:a,wave:o,item:s}=await P(e,t);delete s.queued_at,await x(a.file,o)}return n}r(Jo,"startQueuedBuild");async function ha(e,t,i){const{source:n,wave:a,item:o}=await P(e,t);for(const s of Object.keys(i))i[s]===void 0?delete o[s]:o[s]=i[s];await x(n.file,a)}r(ha,"restoreHold");async function $a(e,t,i){const{source:n,wave:a,item:o}=await P(e,t);for(const s of["status","status_at"])i[s]===void 0?delete o[s]:o[s]=i[s];await x(n.file,a)}r($a,"restoreStatus");const ga=["codex","claude"];async function zo(e,t){const{item:i}=await P(e,t),{kind:n,model:a,reason:o}=It({card:i});return{lines:[`${[n,a].filter(Boolean).join(" ")}: ${o}`]}}r(zo,"pickBuilder");async function Go(e,t,{dir:i}={}){const{id:n}=T(t),a=h.dirname(await ie(e,t,i)),o=await he(h.dirname(a),n);return(await Promise.all(o.map(d=>y(d,null)))).filter(d=>d?.worktree?.path).sort((d,l)=>String(l.started).localeCompare(String(d.started)))[0]?.worktree??null}r(Go,"recordedWorktree");async function Qo(e,t,i,{phase:n,dir:a,agent:o="main",eta:s,clearEta:d}){s!==void 0&&d&&c("pass --eta or --clear-eta, not both");const l=Bn(e,n,i,"builder progress"),u=await ie(e,t,a,o),f=new Date().toISOString(),{progress:m,progress_at:p,done:w,...$}=await y(u,{label:"Builder",started:f});return s!==void 0&&($.eta=En(s,"--eta")),d&&delete $.eta,await x(u,$),await vt(e,t,o,$,l,f),u}r(Qo,"builderProgress");const He=r(e=>(e?.calls||[]).filter(t=>!e.verified||t.at>e.verified.at),"unverifiedCalls");async function Zo(e,t,i,{dir:n,agent:a="main"}){const o=_(i,"builder call");/\n/.test(o)&&c("builder call takes one line; record each call on its own");const s=await ie(e,t,n,a),d=await y(s,null);return(!d?.started||d.done)&&c(`builder call needs an open builder record on ${t}; run builder start first`),await x(s,{...d,calls:[...d.calls||[],{at:new Date().toISOString(),text:o}]}),s}r(Zo,"recordCall");async function Vo(e,t,{dir:i,agent:n="main"}){const a=await y(await ie(e,t,i,n),null),o=a?.calls||[];if(!o.length)return{lines:["no judgment calls recorded"]};const{verified:s}=a,d=He(a).length?"not verified yet":`verified ${s.at}${s.note?`: ${s.note}`:""}`;return{lines:[...o.map((l,u)=>`${u+1}. ${l.text}`),d]}}r(Vo,"listCalls");async function Yo(e,t,{dir:i,agent:n="main",note:a}){const o=await ie(e,t,i,n),s=await y(o,null);return He(s).length||c(`${t} has no unverified judgment calls${n==="main"?"":` from agent ${n}`}; builder calls ${t} lists them`),await x(o,{...s,verified:{at:new Date().toISOString(),...a===void 0?{}:{note:_(a,"--note")}}}),o}r(Yo,"verifyCalls");async function Xo(e,t,{dir:i}={}){const{id:n}=T(t),a=await he(h.dirname(h.dirname(await ie(e,t,i))),n),o=[];for(const s of a){if(!He(await y(s,null)).length)continue;const d=h.basename(s,".json").slice(String(n).length+1)||"main";o.push(d==="main"?"":` --agent ${d}`)}o.length&&c(`land: ${t} has judgment calls nobody verified yet; check them with ${o.map(s=>`builder calls ${t}${s}`).join(", ")}, then run ${o.map(s=>`builder verified ${t}${s}`).join(", ")}`)}r(Xo,"checkCallsVerified");const ka=["checking","done","merged","dropped"];async function he(e,t){const i=h.join(e,"agents");return(await D.readdir(i).catch(()=>[])).filter(n=>n===`${t}.json`||n.startsWith(`${t}@`)&&n.endsWith(".json")).map(n=>h.join(i,n))}r(he,"builderFiles");async function ya(e,t,i){const n=new Date().toISOString();for(const a of await he(e,t)){const o=await y(a,null);if(!o||o.done||o.kind==="install"&&!i)continue;const{eta:s,...d}=o;await x(a,{...d,done:n})}}r(ya,"closeBuilders");async function ba(e,t,{dir:i,agent:n,startedBetween:a,note:o,next:s,requireNext:d=!1}){const l=await ie(e,t,i,n),u=await y(l,null);if(!u||u.done)return l;if(a){const N=Date.parse(u.started);if(!(N>=a[0]&&N<=a[1]))return l}const{eta:f,...m}=u,p=new Date().toISOString(),w={...m,done:p,...o?{note:o}:{}},{id:$}=T(t),g=h.dirname(h.dirname(l)),k=await Promise.all((await he(g,$)).map(N=>N===l?w:y(N,null))),v=!k.some(N=>N?.started&&!N.done),S=i?{file:h.join(g,"wave.json")}:(await P(e,t)).source,j=await y(S.file,null),R=j?.items?.find(N=>N.id===$);s!==void 0&&($n(R||c(`${t} has no item to set --next on`),s,await hn(e,t)),e&&await bn(e,t,R,R.next));const B=v&&yt(R);return d&&R&&Qe(R,k)&&c(`builder done closes ${t}'s last open builder, which leaves it In Progress with no Next; pass --next "<what happens next>", or hand it back with item set ${t} --status checking or land`),await x(l,w),o&&await vt(e,t,n,u,{detail:o},p),(B||s!==void 0)&&await x(S.file,j),l}r(ba,"stopBuilder");async function xa(e){const t=[];for(const i of await C(e)){const n=await y(i.file,null);for(const a of n?.items||[])for(const o of await he(i.dir,a.id)){const s=await y(o,null);if(!s?.started||s.done)continue;const d=h.basename(o,".json");t.push({key:`${i.slug}/${a.id}`,agent:d.slice(String(a.id).length+1)||"main",label:s.label||"Builder",started:s.started})}}return t}r(xa,"openBoardBuilders");async function es(e){const t=await xa(e);for(const i of t)await ba(e,i.key,{agent:i.agent,note:"Board closed. Builder record stopped; work is kept for reopening."});return t}r(es,"closeBoardBuilders");export{Q as BoardError,zt as PUSH_LINE_MAX,st as UPLOAD_LIMIT,Qa as WORKING_KINDS,ro as ackHello,Io as addItem,_o as addPrototype,Do as addQuestions,mo as addReviewers,yo as addRuleTo,So as addTopic,Ee as appendThread,No as askedGate,qo as backfillTickets,W as boardConfig,re as boardRepoOf,Qo as builderProgress,ne as cardName,Uo as changeLineup,Xo as checkCallsVerified,Ro as checkClose,es as closeBoardBuilders,Mo as createLineup,Ko as dueQueuedBuilds,bo as editRuleIn,to as eventCard,co as finishHandshake,Wo as finishLineup,Qt as hiddenFile,C as itemSources,Pn as lineupNoteFile,Vo as listCalls,jo as listPrototypes,ko as listRules,ao as markAsk,Za as markWorking,Co as mergeCard,Fo as migrateFollowups,oo as moveAsk,xa as openBoardBuilders,T as parseKey,zo as pickBuilder,Lo as pickUp,Bo as prReport,Di as pushLine,Ri as pushUrl,be as readAskLinks,Le as readAskProgress,pt as readBoardRules,$o as readBoardSettings,nn as readHandshake,Ei as readHidden,y as readJSON,Ho as readLineupNotes,Eo as readNotes,Ce as readPrototypes,eo as readUpload,bi as readWorking,Zo as recordCall,ia as recordOwnerTap,vi as recordPush,Go as recordedWorktree,no as relateAsk,Oo as removePrototype,ho as removeReviewers,xo as removeRuleFrom,xi as repliesSincePush,Po as resolveNoteAnswers,Ao as resolveQuestion,qi as reviewDigest,wo as reviewDigestSent,po as reviewDue,fo as reviewReact,uo as reviewSent,vo as saveBoardRules,wt as saveBoardSettings,Xa as saveUpload,Va as sendPush,go as setBoardSetting,Ya as setHidden,Oe as setItem,To as setMainInstall,lo as setReviewers,Mi as settingsLines,pe as settingsOf,za as siteDir,ki as sitesDir,fa as startBuilder,Jo as startQueuedBuild,pa as startTappedBuild,ba as stopBuilder,ht as takeFile,H as threadFile,wn as topicQuestions,io as unfoldAsk,Yo as verifyCalls,Ne as wavesDir,Oi as withReplies,so as writeChecked,Ga as writeReply};

package/board/tickets.mjs

@@ -1,3 +1,3 @@
-var T=Object.defineProperty;var o=(e,t)=>T(e,"name",{value:t,configurable:!0});import{runRepo as b,validateGithub as S}from"../hub/repos.mjs";import{savedClient as k}from"../hub/linear.mjs";const r=o(e=>{throw Object.assign(new Error(e),{status:400})},"refuse");function A(e){(!e||typeof e!="object"||Array.isArray(e))&&r("Tickets must name a source.");const t={internal:["source","prefix"],github:["source"],linear:["source","workspace","team","project"]};if(Object.hasOwn(t,e.source)||r("Ticket source must be internal, github or linear."),Object.keys(e).some(i=>!t[e.source].includes(i))&&r("Unknown ticket source field."),e.source==="internal"){const i=e.prefix===void 0||e.prefix===""?"INT":e.prefix;return(typeof i!="string"||!/^[A-Z]{2,6}$/.test(i))&&r("Prefix must be 2\u20136 uppercase letters."),{source:"internal",prefix:i}}return e.source==="github"?{source:"github"}:((typeof e.workspace!="string"||!/^[a-z\d][a-z\d-]*$/i.test(e.workspace))&&r("Linear needs a workspace."),(typeof e.team!="string"||!/^[A-Z][A-Z0-9]*$/.test(e.team))&&r("Linear needs an uppercase team key."),(typeof e.project!="string"||!e.project.trim())&&r("Linear needs a project."),{source:"linear",workspace:e.workspace,team:e.team,project:e.project.trim()})}o(A,"ticketSource");const w=o(e=>{const t=e?Number(e[1]):null;return Number.isSafeInteger(t)?t:null},"numberOf"),x=o(e=>w(/^#?([1-9]\d*)$/.exec(String(e??""))),"issueNumber"),y=o(e=>e.source==="internal"?e.prefix||"INT":e.source==="linear"?e.team:null,"keyOf");function p(e,t){if(!e)return null;const i=y(e),u=String(t??"");return i?u.startsWith(`${i}-`)?w(/^([1-9]\d*)$/.exec(u.slice(i.length+1))):null:w(/^#([1-9]\d*)$/.exec(u))}o(p,"ticketIn");function G(e,t,{repo:i,key:u}={}){const a=p(e,t);if(!a)return null;if(e.source==="internal")return{id:`${y(e)}-${a}`,url:`#item=${encodeURIComponent(u)}`,source:"internal"};if(e.source==="github")return i?{id:`#${a}`,url:`https://github.com/${i}/issues/${a}`,source:"github"}:null;const m=`${e.team}-${a}`;return{id:m,url:`https://linear.app/${e.workspace}/issue/${m}`,source:"linear"}}o(G,"ticketBadge");const j=o(async e=>{try{return await e()}catch(t){r(t.message)}},"linearCall");async function E(e,{ticket:t,title:i,body:u="",repo:a,next:m},{run:s=b,linearFetch:$}={}){if(e.source==="internal")return t!==void 0&&!p(e,t)&&r(`Ticket must match ${e.prefix}-<number>.`),{ticket:t??`${e.prefix}-${m}`,created:t===void 0};if(e.source==="linear"){t!==void 0&&!p(e,t)&&r(`Ticket must match ${e.team}-<number>.`);const l=k({fetch:$});if(!l)return t===void 0?{ticket:null,created:!1,mcp:!0}:{ticket:t,created:!1};if(t===void 0)return{ticket:(await j(()=>l.createIssue({team:e.team,project:e.project,title:i,description:u}))).identifier,created:!0};const g=await j(()=>l.issue(t));return g||r(`Linear has no issue ${t}.`),g.team!==e.team&&r(`${t} is in Linear's ${g.team} team, not ${e.team}.`),{ticket:g.identifier,created:!1}}S(a);const n=t===void 0?null:x(t);t!==void 0&&!n&&r("GitHub ticket must be an issue number such as #41.");const h=n?["issue","view",String(n),"--repo",a,"--json","number,url"]:["issue","create","--repo",a,"--title",i,"--body",u],c=await s("gh",h);c.status!==0&&r((c.stderr||"GitHub refused the issue.").trim().split(`
-`)[0]);let d;if(n){let l;try{l=JSON.parse(c.stdout)}catch{r("GitHub returned an invalid issue.")}l.number!==n&&r("GitHub returned a different issue."),d=l.url}else d=c.stdout?.trim();const f=/^https:\/\/github\.com\/([^/]+\/[^/]+)\/issues\/([1-9]\d*)$/.exec(d||"");return(!f||f[1].toLowerCase()!==a.toLowerCase()||n&&Number(f[2])!==n||!x(f[2]))&&r("Ticket must be an issue in the board\u2019s repo."),{ticket:`#${f[2]}`,created:!n}}o(E,"resolveTicket");function H(e,t){const i=e.source==="github"?String(t??"").match(/(?<![\w#])#[1-9]\d*\b/g):String(t??"").match(/\b[A-Z][A-Z0-9]*-[1-9]\d*\b/g);return[...new Set((i||[]).filter(u=>p(e,u)))]}o(H,"titleTickets");function P({status:e,pr:t}){return["done","merged"].includes(e)?"done":["building","fixing"].includes(e)?"started":t!==void 0&&e===void 0?"review":null}o(P,"ticketTarget");const L={started:"In Progress",review:"In Review",done:"Done"};async function R(e,t,i,{repo:u,run:a=b,linearFetch:m}={}){const s=t.ticket;if(!e||!i||!s||!p(e,s)||e.source==="internal"||e.source==="github"&&i!=="done")return null;if(e.source==="github"&&!u)return`ticket ${s}: not closed, the board has no GitHub repo`;const $=o(n=>`ticket ${s}: could not move to ${L[i]} (${String(n.message||n).split(`
-`)[0]})`,"why");try{if(e.source==="linear"){const c=k({fetch:m});if(!c)return`ticket ${s}: move to ${L[i]} through the Linear MCP${t.ticket_created?"":" if it's assigned to you"}`;if(!t.ticket_created){const f=await c.issue(s);if(!f)return`ticket ${s}: not moved, Linear has no such issue`;if(f.assignee!==c.saved.viewer?.id)return`ticket ${s}: left as it is, not assigned to you`}const d=await c.moveIssue(s,i);return d?`ticket ${s}: moved to ${d}`:null}const n=s.slice(1);if(!t.ticket_created){const c=await a("gh",["issue","view",n,"--repo",u,"--json","state,assignees"]);if(c.status!==0)throw new Error(c.stderr||"gh issue view failed");const d=await a("gh",["api","user","--jq",".login"]);if(d.status!==0)throw new Error(d.stderr||"gh api user failed");const f=JSON.parse(c.stdout);if(f.state!=="OPEN")return null;if(!(f.assignees||[]).some(l=>l.login?.toLowerCase()===d.stdout.trim().toLowerCase()))return`ticket ${s}: left as it is, not assigned to you`}const h=await a("gh",["issue","close",n,"--repo",u]);if(h.status!==0)throw new Error(h.stderr||"gh issue close failed");return`ticket ${s}: closed`}catch(n){return $(n)}}o(R,"moveTicket");const Z=o((e,t,i)=>`ticket: create the Linear issue "${t}" in team ${e.team}, project ${e.project}, through your Linear MCP, then run ${i} --ticket <id>`,"mcpCreateLine");export{Z as mcpCreateLine,R as moveTicket,E as resolveTicket,G as ticketBadge,p as ticketIn,A as ticketSource,P as ticketTarget,H as titleTickets};
+var O=Object.defineProperty;var r=(e,t)=>O(e,"name",{value:t,configurable:!0});import{runRepo as b,validateGithub as S}from"../hub/repos.mjs";import{savedClient as k}from"../hub/linear.mjs";const i=r(e=>{throw Object.assign(new Error(e),{status:400})},"refuse");function N(e){(!e||typeof e!="object"||Array.isArray(e))&&i("Tickets must name a source.");const t={internal:["source","prefix"],github:["source","account"],linear:["source","workspace","team","project"]};if(Object.hasOwn(t,e.source)||i("Ticket source must be internal, github or linear."),Object.keys(e).some(n=>!t[e.source].includes(n))&&i("Unknown ticket source field."),e.source==="internal"){const n=e.prefix===void 0||e.prefix===""?"INT":e.prefix;return(typeof n!="string"||!/^[A-Z]{2,6}$/.test(n))&&i("Prefix must be 2\u20136 uppercase letters."),{source:"internal",prefix:n}}return e.source==="github"?e.account===void 0||e.account===""?{source:"github"}:((typeof e.account!="string"||!/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})$/.test(e.account))&&i("The gh account must be a GitHub login."),{source:"github",account:e.account}):((typeof e.workspace!="string"||!/^[a-z\d][a-z\d-]*$/i.test(e.workspace))&&i("Linear needs a workspace."),(typeof e.team!="string"||!/^[A-Z][A-Z0-9]*$/.test(e.team))&&i("Linear needs an uppercase team key."),(typeof e.project!="string"||!e.project.trim())&&i("Linear needs a project."),{source:"linear",workspace:e.workspace,team:e.team,project:e.project.trim()})}r(N,"ticketSource");const w=r(e=>{const t=e?Number(e[1]):null;return Number.isSafeInteger(t)?t:null},"numberOf"),y=r(e=>w(/^#?([1-9]\d*)$/.exec(String(e??""))),"issueNumber"),x=r(e=>e.source==="internal"?e.prefix||"INT":e.source==="linear"?e.team:null,"keyOf");function g(e,t){if(!e)return null;const n=x(e),s=String(t??"");return n?s.startsWith(`${n}-`)?w(/^([1-9]\d*)$/.exec(s.slice(n.length+1))):null:w(/^#([1-9]\d*)$/.exec(s))}r(g,"ticketIn");function H(e,t,{repo:n,key:s}={}){const a=g(e,t);if(!a)return null;if(e.source==="internal")return{id:`${x(e)}-${a}`,url:`#item=${encodeURIComponent(s)}`,source:"internal"};if(e.source==="github")return n?{id:`#${a}`,url:`https://github.com/${n}/issues/${a}`,source:"github"}:null;const l=`${e.team}-${a}`;return{id:l,url:`https://linear.app/${e.workspace}/issue/${l}`,source:"linear"}}r(H,"ticketBadge");async function j(e,t){if(!e.account)return t;const n=await t("gh",["auth","token","-u",e.account]);(n.status!==0||!n.stdout?.trim())&&i(`gh has no ${e.account} account; run gh auth login`);const s={...process.env,GH_TOKEN:n.stdout.trim()};return(a,l)=>t(a,l,{env:s})}r(j,"issueRunner");const T=r(async e=>{try{return await e()}catch(t){i(t.message)}},"linearCall");async function E(e,{ticket:t,title:n,body:s="",repo:a,next:l},{run:u=b,linearFetch:$}={}){if(e.source==="internal")return t!==void 0&&!g(e,t)&&i(`Ticket must match ${e.prefix}-<number>.`),{ticket:t??`${e.prefix}-${l}`,created:t===void 0};if(e.source==="linear"){t!==void 0&&!g(e,t)&&i(`Ticket must match ${e.team}-<number>.`);const c=k({fetch:$});if(!c)return t===void 0?{ticket:null,created:!1,mcp:!0}:{ticket:t,created:!1};if(t===void 0)return{ticket:(await T(()=>c.createIssue({team:e.team,project:e.project,title:n,description:s}))).identifier,created:!0};const h=await T(()=>c.issue(t));return h||i(`Linear has no issue ${t}.`),h.team!==e.team&&i(`${t} is in Linear's ${h.team} team, not ${e.team}.`),{ticket:h.identifier,created:!1}}S(a);const o=t===void 0?null:y(t);t!==void 0&&!o&&i("GitHub ticket must be an issue number such as #41.");const p=o?["issue","view",String(o),"--repo",a,"--json","number,url"]:["issue","create","--repo",a,"--title",n,"--body",s],m=await(await j(e,u))("gh",p);m.status!==0&&i((m.stderr||"GitHub refused the issue.").trim().split(`
+`)[0]);let f;if(o){let c;try{c=JSON.parse(m.stdout)}catch{i("GitHub returned an invalid issue.")}c.number!==o&&i("GitHub returned a different issue."),f=c.url}else f=m.stdout?.trim();const d=/^https:\/\/github\.com\/([^/]+\/[^/]+)\/issues\/([1-9]\d*)$/.exec(f||"");return(!d||d[1].toLowerCase()!==a.toLowerCase()||o&&Number(d[2])!==o||!y(d[2]))&&i("Ticket must be an issue in the board\u2019s repo."),{ticket:`#${d[2]}`,created:!o}}r(E,"resolveTicket");const Z=r(e=>e.startsWith("#")?`GH-${e.slice(1)}`:e,"cardIdOf");function R(e,t){const n=e.source==="github"?String(t??"").match(/(?<![\w#])#[1-9]\d*\b/g):String(t??"").match(/\b[A-Z][A-Z0-9]*-[1-9]\d*\b/g);return[...new Set((n||[]).filter(s=>g(e,s)))]}r(R,"titleTickets");function P({status:e,pr:t}){return["done","merged"].includes(e)?"done":["building","fixing"].includes(e)?"started":t!==void 0&&e===void 0?"review":null}r(P,"ticketTarget");const L={started:"In Progress",review:"In Review",done:"Done"};async function _(e,t,n,{repo:s,run:a=b,linearFetch:l}={}){const u=t.ticket;if(!e||!n||!u||!g(e,u)||e.source==="internal"||e.source==="github"&&n!=="done")return null;if(e.source==="github"&&!s)return`ticket ${u}: not closed, the board has no GitHub repo`;const $=r(o=>`ticket ${u}: could not move to ${L[n]} (${String(o.message||o).split(`
+`)[0]})`,"why");try{if(e.source==="linear"){const f=k({fetch:l});if(!f)return`ticket ${u}: move to ${L[n]} through the Linear MCP${t.ticket_created?"":" if it's assigned to you"}`;if(!t.ticket_created){const c=await f.issue(u);if(!c)return`ticket ${u}: not moved, Linear has no such issue`;if(c.assignee!==f.saved.viewer?.id)return`ticket ${u}: left as it is, not assigned to you`}const d=await f.moveIssue(u,n);return d?`ticket ${u}: moved to ${d}`:null}const o=u.slice(1),p=await j(e,a);if(!t.ticket_created){const f=await p("gh",["issue","view",o,"--repo",s,"--json","state,assignees"]);if(f.status!==0)throw new Error(f.stderr||"gh issue view failed");const d=await p("gh",["api","user","--jq",".login"]);if(d.status!==0)throw new Error(d.stderr||"gh api user failed");const c=JSON.parse(f.stdout);if(c.state!=="OPEN")return null;if(!(c.assignees||[]).some(h=>h.login?.toLowerCase()===d.stdout.trim().toLowerCase()))return`ticket ${u}: left as it is, not assigned to you`}const m=await p("gh",["issue","close",o,"--repo",s]);if(m.status!==0)throw new Error(m.stderr||"gh issue close failed");return`ticket ${u}: closed`}catch(o){return $(o)}}r(_,"moveTicket");const z=r((e,t,n)=>`ticket: create the Linear issue "${t}" in team ${e.team}, project ${e.project}, through your Linear MCP, then run ${n} --ticket <id>`,"mcpCreateLine");export{Z as cardIdOf,z as mcpCreateLine,_ as moveTicket,E as resolveTicket,H as ticketBadge,g as ticketIn,N as ticketSource,P as ticketTarget,R as titleTickets};

package/board/worktree.mjs

@@ -1,14 +1,15 @@
-var W=Object.defineProperty;var u=(e,r)=>W(e,"name",{value:r,configurable:!0});import w from"node:fs";import p from"node:path";import S from"node:os";import{randomUUID as I}from"node:crypto";import{spawnSync as x}from"node:child_process";import{fileURLToPath as C}from"node:url";import{BoardError as R}from"./store.mjs";import{hubCode as D,listBoards as F}from"../hub/boards.mjs";import{cloneRoot as _}from"../shared/repos.mjs";import{storedPath as j}from"../bin/install.mjs";import{hubService as K}from"../shared/service.mjs";const P=p.join(p.dirname(C(import.meta.url)),"..","bin","kickflip.mjs"),q=_,A=u(()=>p.join(S.homedir(),".claude","kickflip","worktrees"),"worktreesDir"),m=u(e=>{throw new R(e)},"fail");function f(e,...r){const t=x("git",["-C",e,...r],{encoding:"utf8"});return{ok:t.status===0,out:(t.stdout||"").trim(),err:(t.stderr||t.error?.message||"").trim().split(`
-`)[0]}}u(f,"git");const E=u((e,r)=>f(e,"rev-parse","--short",r).out,"short");function et(e,{repo:r=q(),base:t="main",remote:n=!1}={}){const o=p.resolve(r);f(o,"rev-parse","--git-dir").ok||m(`--repo ${o} is not a git repo`),f(o,"check-ref-format","--branch",e).ok||m(`--worktree: "${e}" can't be a branch name`),f(o,"check-ref-format","--branch",t).ok||m("--worktree: invalid base branch");const i=n?`refs/remotes/origin/${t}`:`refs/heads/${t}`;n&&f(o,"fetch","--quiet","--no-tags","origin",`+refs/heads/${t}:${i}`),f(o,"rev-parse","--verify","--quiet",i).ok||m(`--worktree: ${o} has no ${t} branch`);const c=p.join(A(),e);w.existsSync(c)&&m(`--worktree: ${c} already exists; land or remove it first`),f(o,"rev-parse","--verify","--quiet",`refs/heads/${e}`).ok&&m(`--worktree: branch ${e} already exists in ${o}`),w.mkdirSync(p.dirname(c),{recursive:!0});const d=f(o,"worktree","add","--quiet","-b",e,c,i);return d.ok||m(`--worktree: git worktree add failed: ${d.err}`),{path:j(c),branch:e,repo:j(o)}}u(et,"makeWorktree");function N(e){const r=[],t=u(n=>{for(const o of w.readdirSync(n,{withFileTypes:!0}))o.name===".git"||o.name===".repos"||o.name==="node_modules"||(o.isDirectory()?t(p.join(n,o.name)):o.name.endsWith(".test.mjs")&&r.push(p.join(n,o.name)))},"walk");return t(e),r.sort()}u(N,"testFiles");function O(e){const r=N(e);if(!r.length)return{ok:!0,pass:0,fail:0};const{NODE_TEST_CONTEXT:t,...n}=process.env,o=x(process.execPath,["--test","--test-reporter=tap",...r],{cwd:e,env:n,encoding:"utf8",maxBuffer:256*1024*1024}),i=u(d=>Number((o.stdout||"").match(new RegExp(`^# ${d} (\\d+)$`,"m"))?.[1]??0),"count"),c={ok:o.status===0,pass:i("pass"),fail:i("fail")};if(!c.ok){const d=(o.stdout||"")+(o.stderr||"")+(o.error?`
+var D=Object.defineProperty;var c=(r,e)=>D(r,"name",{value:e,configurable:!0});import $ from"node:fs";import g from"node:path";import v from"node:os";import{randomUUID as W}from"node:crypto";import{spawnSync as j}from"node:child_process";import{fileURLToPath as F}from"node:url";import{BoardError as N}from"./store.mjs";import{boardAt as C,hubCode as A,listBoards as O,readManifest as P}from"../hub/boards.mjs";import{boardRepo as _}from"../hub/board-repo.mjs";import{cloneRoot as K}from"../shared/repos.mjs";import{storedPath as R}from"../bin/install.mjs";import{hubService as q}from"../shared/service.mjs";const L=g.join(g.dirname(F(import.meta.url)),"..","bin","kickflip.mjs"),E=K,M=c(()=>g.join(v.homedir(),".claude","kickflip","worktrees"),"worktreesDir"),u=c(r=>{throw new N(r)},"fail");function d(r,...e){const t=j("git",["-C",r,"-c","core.commentChar=;",...e],{encoding:"utf8"});return{ok:t.status===0,out:(t.stdout||"").trim(),err:(t.stderr||t.error?.message||"").trim().split(`
+`)[0]}}c(d,"git");const T=c((r,e)=>d(r,"rev-parse","--short",e).out,"short");function J(r,{repo:e=E(),base:t="main",remote:n=!1}={}){const o=g.resolve(e);d(o,"rev-parse","--git-dir").ok||u(`--repo ${o} is not a git repo`),d(o,"check-ref-format","--branch",r).ok||u(`--worktree: "${r}" can't be a branch name`),d(o,"check-ref-format","--branch",t).ok||u("--worktree: invalid base branch");const s=n?`refs/remotes/origin/${t}`:`refs/heads/${t}`;n&&d(o,"fetch","--quiet","--no-tags","origin",`+refs/heads/${t}:${s}`),d(o,"rev-parse","--verify","--quiet",s).ok||u(`--worktree: ${o} has no ${t} branch`);const l=g.join(M(),r);$.existsSync(l)&&u(`--worktree: ${l} already exists; land or remove it first`),d(o,"rev-parse","--verify","--quiet",`refs/heads/${r}`).ok&&u(`--worktree: branch ${r} already exists in ${o}`),$.mkdirSync(g.dirname(l),{recursive:!0});const h=d(o,"worktree","add","--quiet","-b",r,l,s);return h.ok||u(`--worktree: git worktree add failed: ${h.err}`),{path:R(l),branch:r,repo:R(o)}}c(J,"makeWorktree");function B(r,{repo:e,manifest:t=P()}={}){const n=r?C(r,t):null;if(!n)return{repo:e??E(),base:"main",remote:!1};const o=_(n.route,t),s=e??(o.repo||u(`/${n.route} has no folder recorded for its session; rejoin it from its repo folder`));return o.local?{repo:s,base:"main",remote:!1}:{repo:s,base:o.branch||"main",remote:!0}}c(B,"builderRepo");const ut=c((r,e,{repo:t}={})=>J(e,B(r,{repo:t})),"boardWorktree");function U(r){const e=[],t=c(n=>{for(const o of $.readdirSync(n,{withFileTypes:!0}))o.name===".git"||o.name===".repos"||o.name==="node_modules"||(o.isDirectory()?t(g.join(n,o.name)):o.name.endsWith(".test.mjs")&&e.push(g.join(n,o.name)))},"walk");return t(r),e.sort()}c(U,"testFiles");function H(r){const e=U(r);if(!e.length)return{ok:!0,pass:0,fail:0};const{NODE_TEST_CONTEXT:t,...n}=process.env,o=j(process.execPath,["--test","--test-reporter=tap",...e],{cwd:r,env:n,encoding:"utf8",maxBuffer:256*1024*1024}),s=c(h=>Number((o.stdout||"").match(new RegExp(`^# ${h} (\\d+)$`,"m"))?.[1]??0),"count"),l={ok:o.status===0,pass:s("pass"),fail:s("fail")};if(!l.ok){const h=(o.stdout||"")+(o.stderr||"")+(o.error?`
 ${o.error.message}
-`:""),a=p.join(S.homedir(),".claude","kickflip","logs");try{w.mkdirSync(a,{recursive:!0});const h=p.join(a,`land-${I()}.tap`);w.writeFileSync(h,d,{mode:384}),c.log=h}catch(h){c.logError=`Could not save the full test output: ${h.message}`}c.failures=B(o.stdout||"");const k=(o.stderr||"").trim().split(`
-`)[0];c.error=o.error?.message||`${o.signal?`test runner killed by ${o.signal}`:`test runner exited ${o.status}`}${k?`: ${k}`:""}`}return c}u(O,"nodeTests");function B(e){const r=e.split(`
-`),t=[],n=[],o=u(i=>i.startsWith("'")?i.slice(1,-1).replaceAll("''","'"):i.startsWith('"')?JSON.parse(i):i,"scalar");for(let i=0;i<r.length;i++){const c=/^(\s*)# Subtest: (.*)$/.exec(r[i]);if(c){const s=c[1].length;for(;t.length&&t.at(-1).indent>=s;)t.pop();t.push({indent:s,name:c[2]})}const d=/^(\s*)not ok \d+ - (.*)$/.exec(r[i]);if(!d||/ # (?:TODO|SKIP)\b/i.test(d[2]))continue;const a=d[1].length,k=[...t.filter(s=>s.indent<a).map(s=>s.name),d[2]].join(" > "),h=[];for(let s=i+1;s<r.length&&r[s].startsWith(" ".repeat(a+2));s++)h.push(r[s]);const $=u(s=>h.find(l=>l.startsWith(`${" ".repeat(a+2)}${s}: `))?.slice(a+s.length+4),"field"),v=$("location"),b=$("error");let g=[];if(b&&/^[|>]/.test(b)){const s=h.findIndex(l=>l.startsWith(`${" ".repeat(a+2)}error: `))+1;for(let l=s;l<h.length&&h[l].startsWith(" ".repeat(a+4));l++)g.push(h[l].slice(a+4))}else b&&(g=o(b).split(`
-`));if(g[0]==="test failed"){const s=[];let l=i-1;for(r[l]?.startsWith("# Subtest: ")&&l--;l>=0&&r[l].startsWith("# ")&&!r[l].startsWith("# Subtest: ");l--)s.unshift(r[l].slice(2));const y=s.findIndex(T=>/^\w*Error(?: \[[^\]]+\])?:/.test(T));y>=0&&(g=s.slice(y))}n.push(`${k}
-  ${v?o(v):"file not reported by test runner"}${g.length?`
-`+g.slice(0,3).map(s=>`  ${s}`).join(`
-`):""}`)}return n}u(B,"tapFailures");function L(e,r){let t;if(process.env.KICKFLIP_RESTART_CMD){try{t=JSON.parse(process.env.KICKFLIP_RESTART_CMD)}catch{}(!Array.isArray(t)||!t.length||!t.every(o=>typeof o=="string"))&&m("KICKFLIP_RESTART_CMD must be a JSON array of strings"),t=[...t,e,...r?[r]:[]]}else{if(e==="hub")return K().restart();t=[process.execPath,P,"restart",r]}const n=x(t[0],t.slice(1),{encoding:"utf8"});return n.status===0?null:(n.stderr||n.error?.message||`exit ${n.status}`).trim().split(`
-`)[0]}u(L,"restartRunner");function rt({path:e,branch:r,repo:t},{say:n=console.log,runTests:o=O,restart:i=L,boards:c=u(()=>F(),"boards")}={}){w.existsSync(e)||m(`no worktree at ${e}`);const d=f(t,"symbolic-ref","--quiet","--short","HEAD").out;if(d!=="main"&&m(`${t} is on ${d||"a detached HEAD"}, not main; land fast-forwards main there`),f(e,"status","--porcelain").out&&m(`${e} has uncommitted changes; commit them there first`),Number(f(t,"rev-list","--count",`main..${r}`).out)===0&&m(`${r} has no commits beyond main; nothing to land`),!f(t,"merge-base","--is-ancestor","main",r).ok){if(!f(e,"rebase","--quiet","main").ok){const s=f(e,"diff","--name-only","--diff-filter=U").out.split(`
-`).filter(Boolean);f(e,"rebase","--abort"),m(`rebasing ${r} onto main conflicts in ${s.join(", ")||"files git did not name"}; resolve it in ${e} and land again`)}n(`rebased ${r} onto main (${E(t,"main")})`)}const a=o(e);a.ok||m([`tests failed in ${e} (${a.fail} failing); nothing landed`,...a.failures?.length?a.failures:[a.error||"test runner failed without test diagnostics"],...a.log?[`Full test output: ${a.log}`]:a.logError?[a.logError]:[]].join(`
-`)),n(`tests passed: ${a.pass}`);const k=f(t,"diff","--name-only","main",r).out.split(`
-`).filter(Boolean),h=f(t,"merge","--quiet","--ff-only",r);h.ok||m(`could not fast-forward main in ${t}: ${h.err}`),n(`main fast-forwarded to ${E(t,"main")} in ${t}`);const $=[],v=new Set(D(p.join(t,"hub","hub.mjs")).files);if(k.some(s=>s.startsWith("hub/")||v.has(s))){const s=i("hub");s?$.push(`the hub didn't restart (${s})`):n("hub restarted, with every site")}else if(k.some(s=>s.startsWith("board/")))for(const s of c()){const l=i("board",s.route);l?$.push(`/${s.route} didn't restart (${l})`):n(`board restarted: ${s.route}`)}const b=f(t,"worktree","remove",e);b.ok?n(`worktree removed: ${e}`):$.push(`could not remove ${e} (${b.err})`);const g=f(t,"branch","--quiet","-d",r);g.ok?n(`branch deleted: ${r}`):$.push(`could not delete branch ${r} (${g.err})`),$.length&&m(`landed, but ${$.join("; ")}`)}u(rt,"land");export{rt as land,et as makeWorktree,O as nodeTests,L as restartRunner,q as skillRepo,A as worktreesDir};
+`:""),p=g.join(v.homedir(),".claude","kickflip","logs");try{$.mkdirSync(p,{recursive:!0});const a=g.join(p,`land-${W()}.tap`);$.writeFileSync(a,h,{mode:384}),l.log=a}catch(a){l.logError=`Could not save the full test output: ${a.message}`}l.failures=X(o.stdout||"");const y=(o.stderr||"").trim().split(`
+`)[0];l.error=o.error?.message||`${o.signal?`test runner killed by ${o.signal}`:`test runner exited ${o.status}`}${y?`: ${y}`:""}`}return l}c(H,"nodeTests");function X(r){const e=r.split(`
+`),t=[],n=[],o=c(s=>s.startsWith("'")?s.slice(1,-1).replaceAll("''","'"):s.startsWith('"')?JSON.parse(s):s,"scalar");for(let s=0;s<e.length;s++){const l=/^(\s*)# Subtest: (.*)$/.exec(e[s]);if(l){const i=l[1].length;for(;t.length&&t.at(-1).indent>=i;)t.pop();t.push({indent:i,name:l[2]})}const h=/^(\s*)not ok \d+ - (.*)$/.exec(e[s]);if(!h||/ # (?:TODO|SKIP)\b/i.test(h[2]))continue;const p=h[1].length,y=[...t.filter(i=>i.indent<p).map(i=>i.name),h[2]].join(" > "),a=[];for(let i=s+1;i<e.length&&e[i].startsWith(" ".repeat(p+2));i++)a.push(e[i]);const x=c(i=>a.find(m=>m.startsWith(`${" ".repeat(p+2)}${i}: `))?.slice(p+i.length+4),"field"),S=x("location"),k=x("error");let b=[];if(k&&/^[|>]/.test(k)){const i=a.findIndex(m=>m.startsWith(`${" ".repeat(p+2)}error: `))+1;for(let m=i;m<a.length&&a[m].startsWith(" ".repeat(p+4));m++)b.push(a[m].slice(p+4))}else k&&(b=o(k).split(`
+`));if(b[0]==="test failed"){const i=[];let m=s-1;for(e[m]?.startsWith("# Subtest: ")&&m--;m>=0&&e[m].startsWith("# ")&&!e[m].startsWith("# Subtest: ");m--)i.unshift(e[m].slice(2));const w=i.findIndex(f=>/^\w*Error(?: \[[^\]]+\])?:/.test(f));w>=0&&(b=i.slice(w))}n.push(`${y}
+  ${S?o(S):"file not reported by test runner"}${b.length?`
+`+b.slice(0,3).map(i=>`  ${i}`).join(`
+`):""}`)}return n}c(X,"tapFailures");function z(r,e){let t;if(process.env.KICKFLIP_RESTART_CMD){try{t=JSON.parse(process.env.KICKFLIP_RESTART_CMD)}catch{}(!Array.isArray(t)||!t.length||!t.every(o=>typeof o=="string"))&&u("KICKFLIP_RESTART_CMD must be a JSON array of strings"),t=[...t,r,...e?[e]:[]]}else{if(r==="hub")return q().restart();t=[process.execPath,L,"restart",e]}const n=j(t[0],t.slice(1),{encoding:"utf8"});return n.status===0?null:(n.stderr||n.error?.message||`exit ${n.status}`).trim().split(`
+`)[0]}c(z,"restartRunner");const G=c(()=>g.join(v.homedir(),".claude","kickflip","land.lock"),"landLock"),Q=c(r=>{try{return process.kill(r,0),!0}catch(e){return e.code==="EPERM"}},"alive");async function dt(r,e){const t=G();for($.mkdirSync(g.dirname(t),{recursive:!0});;)try{$.writeFileSync(t,JSON.stringify({card:r,pid:process.pid,at:new Date().toISOString()}),{flag:"wx"});break}catch(n){if(n.code!=="EEXIST")throw n;let o=null;try{o=JSON.parse($.readFileSync(t,"utf8"))}catch{}Number.isInteger(o?.pid)&&Q(o.pid)&&u(`${o.card} is landing (since ${o.at}); land again once it finishes`),$.rmSync(t,{force:!0})}try{return await e()}finally{try{JSON.parse($.readFileSync(t,"utf8")).pid===process.pid&&$.rmSync(t,{force:!0})}catch{}}}c(dt,"holdingLandLock");function V(r){const e=g.join(r,"docs","adr");if(!$.existsSync(e))return;const t=new Map;for(const h of $.readdirSync(e).sort()){const p=h.match(/^(\d{4})-/)?.[1];p&&t.set(p,[...t.get(p)||[],h])}const n=[...t].find(([,h])=>h.length>1);if(!n)return;const[o,s]=n,l=String(Math.max(...t.keys().map(Number))+1).padStart(4,"0");u(`land: docs/adr has two ADRs numbered ${o} (${s.join(", ")}); renumber yours to ${l} and land again`)}c(V,"refuseDuplicateAdr");function mt({path:r,branch:e,repo:t},{say:n=console.log,runTests:o=H,restart:s=z,boards:l=c(()=>O(),"boards"),clone:h=E()}={}){$.existsSync(r)||u(`no worktree at ${r}`);const p=d(t,"symbolic-ref","--quiet","--short","HEAD").out;if(p!=="main"&&u(`${t} is on ${p||"a detached HEAD"}, not main; land fast-forwards main there`),d(r,"status","--porcelain").out&&u(`${r} has uncommitted changes; commit them there first`),Number(d(t,"rev-list","--count",`main..${e}`).out)===0&&u(`${e} has no commits beyond main; nothing to land`),!d(t,"merge-base","--is-ancestor","main",e).ok){if(!d(r,"rebase","--quiet","main").ok){const f=d(r,"diff","--name-only","--diff-filter=U").out.split(`
+`).filter(Boolean);d(r,"rebase","--abort"),u(`rebasing ${e} onto main conflicts in ${f.join(", ")||"files git did not name"}; resolve it in ${r} and land again`)}n(`rebased ${e} onto main (${T(t,"main")})`)}const y=d(t,"log","--format=%h %s",`main..${e}`).out.split(`
+`).filter(f=>f&&!f.includes(" "));y.length&&u(`${e} has a commit with an empty subject (${y[0]}); reword it in ${r} and land again`),V(r);const a=o(r);a.ok||u([`tests failed in ${r} (${a.fail} failing); nothing landed`,...a.failures?.length?a.failures:[a.error||"test runner failed without test diagnostics"],...a.log?[`Full test output: ${a.log}`]:a.logError?[a.logError]:[]].join(`
+`)),n(`tests passed: ${a.pass}`);const x=d(t,"diff","--name-only","main",e).out.split(`
+`).filter(Boolean),S=d(t,"merge","--quiet","--ff-only",e);S.ok||u(`could not fast-forward main in ${t}: ${S.err}`),n(`main fast-forwarded to ${T(t,"main")} in ${t}`);const k=[],b=$.realpathSync(t)===$.realpathSync(h)?x.filter(f=>!/\.test\.mjs$/.test(f)):[],i=new Set(b.length?A(g.join(t,"hub","hub.mjs")).files:[]);if(b.some(f=>f.startsWith("hub/")||i.has(f))){const f=s("hub");f?k.push(`the hub didn't restart (${f})`):n("hub restarted, with every site")}else if(b.some(f=>f.startsWith("board/")))for(const f of l()){const I=s("board",f.route);I?k.push(`/${f.route} didn't restart (${I})`):n(`board restarted: ${f.route}`)}const m=d(t,"worktree","remove",r);m.ok?n(`worktree removed: ${r}`):k.push(`could not remove ${r} (${m.err})`);const w=d(t,"branch","--quiet","-d",e);w.ok?n(`branch deleted: ${e}`):k.push(`could not delete branch ${e} (${w.err})`),k.length&&u(`landed, but ${k.join("; ")}`)}c(mt,"land");export{ut as boardWorktree,B as builderRepo,dt as holdingLandLock,mt as land,J as makeWorktree,H as nodeTests,z as restartRunner,E as skillRepo,M as worktreesDir};

package/docs/hub-session.md

@@ -1,11 +1,11 @@
 # Hub session
 
-You own the hub board, the one board whose manifest entry has `hub: true` (`kickflip set <route> --hub`). This is a dev-time role: build the app from inside it; the product needs only the hub server, with boards added in the app ([ADR 0068](adr/0068-the-hub-session-is-a-dev-time-role.md)). Keep new features independent of this session.
+You own the hub board, the one board whose manifest entry has `hub: true` (`kickflip set <route> --hub`, `kickflip join --hub`). That flag only means your session runs in the foreground, in the tmux session `kickflip-<route>` the hub starts, and `kickflip hub` attaches the owner's terminal to it; every other board's session runs in the background, and kickflip runs without a hub board ([ADR 0147](adr/0147-boards-run-in-the-background-and-the-hub-board-in-tmux.md)). Your board is otherwise a local board of its folder: builders branch from that folder's local main and land there. Your permission prompts also reach the owner's phone. Keep new features independent of this session.
 
-- Rejoin the board with your current session id, relaunch its watcher and record how to restart it, following [Steps 1, 3, 5 and 6](../SKILL.md#steps).
+- Rejoin the board by its name, `join --name '<board name>'` as your prompt gives it, with your current session id, relaunch its watcher and record how to restart it, following [Steps 1, 3, 5 and 6](../SKILL.md#steps). The owner makes a hub board from a repo folder with `kickflip join --hub` ([ADR 0143](adr/0143-kickflip-join-adds-the-current-repository-as-a-board.md)).
 - Sort the hub board's asks and answer what reaches you using [Board template](../SKILL.md#reference).
 - Start and resume board sessions with `kickflip start` and `kickflip resume`, following [Board sessions](../SKILL.md#reference). Check `kickflip sessions` before acting; a live session already has a process.
 - Relay between boards: check which board owns the work, move asks with the owner's choice as [Board template](../SKILL.md#reference) describes, and carry relevant results back to the requesting card. Put decisions for the owner on the card as open questions; the owner answers background sessions' pending prompts in the app, as [Board sessions](../SKILL.md#reference) describes.
 - Edit the skill through builders in worktrees and land with `board.mjs land`, following [Board template](../SKILL.md#reference) and [ADR 0064](adr/0064-every-builder-works-in-a-worktree.md). Keep long builds, investigations, checks and lands in background agents or tasks so you can keep answering board events.
 
-The hub server owns card and main builds and serves through the repo’s fixed `.kickflip/build` ([ADR 0099](adr/0099-a-boards-build-script-serves-or-builds-each-card-and-main.md)). Keep the script working in kickflip’s main and each card branch; file broken build steps as a card. Main always rebuilds after a merge. Auto-build cards, off by default, controls only card builds after new heads. Sessions can request `board.mjs --site <route> build <key>`; the server writes `data/try.json` and logs, without builder records or a session rebuild on GitHub head changes.
+The hub server owns card and main builds and serves through the repo’s fixed `.kickflip/build` ([ADR 0099](adr/0099-a-boards-build-script-serves-or-builds-each-card-and-main.md)). Keep the script working in kickflip’s main and each card branch; file broken build steps as a card. Main always rebuilds after a merge. Auto-build cards, off by default, controls only card builds after new heads. A session starts a card run only when the owner asks in words, with `board.mjs --site <route> build <key> --asked "<the owner's words>"` ([ADR 0124](adr/0124-only-the-owner-or-auto-build-starts-a-card-run.md)); the server writes `data/try.json` and logs, without builder records or a session rebuild on GitHub head changes.

package/hooks-plugin/hooks/codex-share-auto.mjs

@@ -1,21 +1,23 @@
 #!/usr/bin/env node
-// SessionStart and UserPromptSubmit: the hub setting is the default for every session.
+// SessionStart and UserPromptSubmit: every session runs as the hub setting (docs/adr/0105-the-hubs-codex-share-is-the-only-codex-setting.md),
+// stated each prompt, off included, so a change replaces what an earlier turn was told.
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { codexStatus, effectiveCodexShare } from '../../shared/codex.mjs';
-import { readUsageGate } from '../../shared/usage-gate.mjs';
 
 process.stdout.on('error', () => {});
 try {
   let stored;
   try { stored = JSON.parse(fs.readFileSync(path.join(os.homedir(), '.claude', 'kickflip', 'settings.json'), 'utf8')).codexShare; } catch {}
   const codexShare = effectiveCodexShare(stored, codexStatus());
-  const line = readUsageGate().pause_at;
+  const pick = 'Before each build, run `board.mjs builder pick <key>`: it prints codex or claude (with its model) and why, from this setting and the pause line, and builder start refuses the other kind (--kind build takes the pick). Hand codex builds and reviews to Codex as ~/.claude/skills/codex-share/SKILL.md describes (read it first).';
   if (codexShare === 'auto') {
-    console.log(`The hub's Codex setting is auto: unless this session's codex-share-mode file says otherwise, run as codex-share auto. Hand implementation and review to Codex as ~/.claude/skills/codex-share/SKILL.md describes (read it first); while Codex is past the pause line (${line}%) or out of usage, Opus builders take over until it resets. Say so in one line the first time it applies in this session.`);
+    console.log(`The hub's Codex setting is auto: run as codex-share auto. ${pick} When Codex reports it is out of usage, Opus builders take over until it resets.`);
   } else if (codexShare === 'always') {
-    console.log(`The hub's Codex setting is always on: unless this session's codex-share-mode file says otherwise, run as codex-share on. Hand implementation and review to Codex as ~/.claude/skills/codex-share/SKILL.md describes (read it first); while Codex is past the pause line (${line}%), Opus builders take over until it resets, and while Codex is out of usage, pause that work until the usage-reset probe answers. Say so in one line the first time it applies in this session.`);
+    console.log(`The hub's Codex setting is always on: run as codex-share on. ${pick} When Codex reports it is out of usage, pause that work until the usage-reset probe answers.`);
+  } else {
+    console.log("The hub's Codex setting is off: Claude builds and reviews, whatever an earlier turn said. Before each build, run `board.mjs builder pick <key>`; builder start refuses any other kind.");
   }
 } catch { /* Errors are silent and never fail the session. */ }
 process.exitCode = 0;