@lovek4d/kickflip 0.7.1 → 0.7.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (62) hide show
  1. package/CONTEXT.md +25 -21
  2. package/SKILL.md +13 -9
  3. package/bin/event-lines.mjs +1 -1
  4. package/bin/install.mjs +3 -3
  5. package/bin/kickflip.mjs +1 -1
  6. package/bin/wait-events.mjs +2 -2
  7. package/board/bin/board.mjs +68 -50
  8. package/board/domain.mjs +7 -7
  9. package/board/finish.mjs +4 -4
  10. package/board/headless.mjs +8 -8
  11. package/board/hub-lines.mjs +1 -1
  12. package/board/onboarding.mjs +3 -3
  13. package/board/permissions.mjs +2 -2
  14. package/board/public/app-asks.js +2 -14
  15. package/board/public/app-banner.js +8 -3
  16. package/board/public/app-cards.js +7 -20
  17. package/board/public/app-core.js +2 -2
  18. package/board/public/app-lanes.js +7 -15
  19. package/board/public/app-reader.js +7 -3
  20. package/board/public/app-snapshot.js +1 -1
  21. package/board/public/app.js +1 -1
  22. package/board/public/attach.js +18 -2
  23. package/board/public/dialogs.js +10 -12
  24. package/board/public/hub.css +0 -3
  25. package/board/public/linear-key.js +1 -1
  26. package/board/public/sidebar.css +1 -1
  27. package/board/public/style.css +42 -36
  28. package/board/public/ui-cards.js +33 -27
  29. package/board/public/ui-enums.js +2 -2
  30. package/board/public/ui-links.js +0 -1
  31. package/board/public/ui-order.js +1 -1
  32. package/board/public/ui-questions.js +8 -6
  33. package/board/public/ui-sidebar.js +1 -1
  34. package/board/public/ui-threads.js +26 -22
  35. package/board/public/ui.js +15 -9
  36. package/board/public/view-hub-settings.js +25 -30
  37. package/board/public/view-hub.js +23 -5
  38. package/board/public/view-questions.js +1 -1
  39. package/board/public/view-settings.js +4 -4
  40. package/board/server.mjs +18 -18
  41. package/board/store.mjs +30 -27
  42. package/board/tickets.mjs +3 -3
  43. package/board/worktree.mjs +15 -15
  44. package/hub/board-repo.mjs +1 -1
  45. package/hub/github.mjs +3 -3
  46. package/hub/hub.mjs +11 -11
  47. package/hub/linear.mjs +1 -1
  48. package/hub/new-board.mjs +2 -2
  49. package/hub/pr-report.mjs +2 -2
  50. package/hub/readiness.mjs +1 -1
  51. package/hub/repos.mjs +3 -3
  52. package/hub/review-send.mjs +1 -1
  53. package/hub/schedule.mjs +1 -1
  54. package/hub/slack.mjs +1 -1
  55. package/hub/try.mjs +8 -6
  56. package/hub/views.mjs +1 -1
  57. package/package.json +1 -1
  58. package/shared/fake-gh.mjs +19 -4
  59. package/shared/gh.mjs +4 -0
  60. package/shared/owner-check.mjs +4 -3
  61. package/shared/service.mjs +12 -12
  62. package/starter/server.mjs +3 -3
package/board/store.mjs CHANGED
@@ -1,35 +1,38 @@
1
- var po=Object.defineProperty;var r=(e,t)=>po(e,"name",{value:t,configurable:!0});import j from"node:fs/promises";import{constants as wo,existsSync as ce,readFileSync as mo}from"node:fs";import h from"node:path";import pn from"node:os";import{execFile as ha}from"node:child_process";import{fileURLToPath as ho}from"node:url";import{BUILD_REFUSED as ga,BUILDER_ASK as Rt,COMMANDS as Nt,LANDER as $a,LANES as He,MOVE as ka,PAUSE_CLEARS as ba,PHASES as wn,handedBackAt as mn,MAX_IMPLEMENTERS as go,MAX_PLANNERS as $o,builds as ze,waveItems as Et,mergeBlockers as ko,modelName as It,noTakePicked as bo,ownerQuestion as Ne,plans as Ee,QUESTION_REOPEN as yo,PLANNER_WORD as xo,providerOf as ft,owesNext as hn,pushTag as _o,refOf as Je,roundOf as gn,roundSettledBy as So,HELPER as se,VISUAL as pe,visualAgent as vo}from"./domain.mjs";import{GITHUB_STATE as $n,appendEvent as ge,listBoards as we,readManifest as jo,samePath as _e,withManifestLock as Oo,writeManifest as Po}from"../hub/boards.mjs";import{readUsageGate as ya,pauseReason as Ao,pauseReasonFor as Do,heldFor as Fo,holdsWork as Ro,builderPick as kn,pauseEnd as No}from"../shared/usage-gate.mjs";import{reviseQueued as Eo,pushKindError as Io,readClaudeModel as bn}from"../hub/push.mjs";import{AT_RE as Lo}from"../hub/duration.mjs";import{routeRecord as V}from"../hub/routes.mjs";import{ticketSource as yn,ticketIn as xn,resolveTicket as Bo,ticketTarget as To,moveTicket as Co,titleTickets as qo,cardIdOf as Mo}from"./tickets.mjs";import{LINEAR_NEEDS_KEY as Wo,linearStatus as Uo,linearWorks as Ho}from"../hub/linear.mjs";import{validateBranch as zo}from"../hub/repos.mjs";import{withFileLock as pt}from"../hub/locks.mjs";import{audit as Jo,auditLines as Ko,boardAudit as xa,readAudit as Qo}from"../shared/audit.mjs";import{merge3 as Go}from"./merge3.mjs";import{HUB as Zo,MESSAGE_LIMIT as _a,BRIEF_LINE_LIMIT as Sa,hubLineOf as Vo,hubText as Yo}from"./hub-lines.mjs";import{fetchPR as va,reportOf as ja,githubLogin as Xo,postToPR as es,postReview as ts,reviewsSince as ns,CLAUDE_PREFIX as wt,CLAUDE_MARK as _n}from"../hub/pr-report.mjs";import{allLanded as as,cardPRs as Ie,hasPR as Le,parsePRRef as Sn,prKeyOf as mt,prNames as Ke,prURL as vn,storedPRs as Se}from"../shared/card-prs.mjs";import{reviewLinks as is,topicItems as os,reviewersOf as jn}from"./review.mjs";import{readiness as Oa}from"../hub/readiness.mjs";import{slackDay as ss}from"../hub/slack.mjs";import"../bin/install.mjs";import{readPermissions as rs}from"./permissions.mjs";import{validBuildTarget as Pa}from"./build-script.mjs";import{parseCheck as ls,checkText as cs}from"../shared/owner-check.mjs";import{RuleError as ds,rulesOf as Aa,addRule as us,editRule as fs,removeRule as ps,applyRules as ws,readHubRules as Lt,writeHubRules as ms}from"../hub/rules.mjs";import{shareEntries as hs,validLogin as gs}from"../hub/share.mjs";class re extends Error{static{r(this,"BoardError")}}const d=r(e=>{throw new re(e)},"fail"),$s=r(()=>h.join(pn.homedir(),".claude","kickflip","sites"),"sitesDir"),Bt=r(()=>h.join(pn.homedir(),".claude","waves"),"wavesDir"),Da=Symbol("read as"),g=r(async(e,t)=>{let n;try{n=await j.readFile(e,"utf8")}catch{return t}try{const a=JSON.parse(n);return a!==null&&typeof a=="object"&&!Array.isArray(a)?{...a,[Da]:n}:a}catch{return t}},"readJSON"),K=r(async e=>{try{return(await j.readFile(e,"utf8")).split(`
2
- `).filter(Boolean).map(t=>JSON.parse(t))}catch{return[]}},"readLines");async function Qe(e,t){await j.mkdir(h.dirname(e),{recursive:!0});const n=`${e}.${process.pid}.tmp`;await j.writeFile(n,t),await j.rename(n,e)}r(Qe,"replace");const k=r((e,t)=>{const{[Da]:n,...a}=t??{};return n===void 0?Qe(e,JSON.stringify(t,null,2)+`
3
- `):pt(e,async()=>{const i=JSON.parse(n),o=JSON.parse(await j.readFile(e,"utf8").catch(()=>n));await Qe(e,JSON.stringify(Go(i,a,o),null,2)+`
4
- `)})},"writeJSON");async function me(e,t){await j.mkdir(h.dirname(e),{recursive:!0}),await j.appendFile(e,JSON.stringify(t)+`
5
- `)}r(me,"appendLine");async function Fl(e){/^[\w-]+$/.test(e||"")||d(`--site takes a route such as ios-orchestrator, not "${e}"`);const t=h.join($s(),e);return await j.stat(t).then(n=>n.isDirectory(),()=>!1)||d(`no site at ${t}`),t}r(Fl,"siteDir");const ae=r(async e=>({title:"Board",items:"waves",...e?await g(h.join(e,"board.json"),{}):{}}),"boardConfig");async function M(e){const t=await ae(e);if(t.items==="waves")try{return(await j.readdir(Bt(),{withFileTypes:!0})).filter(a=>a.isDirectory()).map(a=>({slug:a.name,dir:h.join(Bt(),a.name),file:h.join(Bt(),a.name,"wave.json")}))}catch{return[]}const n=h.resolve(e,t.items);return[{slug:t.slug||h.basename(t.items,".json"),dir:h.dirname(n),file:n}]}r(M,"itemSources");const Y=r((e,t)=>h.join(e,"data","threads",t.replace(/[^\w.-]+/g,"__")+".jsonl"),"threadFile"),L=r(e=>h.join(e,"data","owner.json"),"ownerFile"),$e=r(e=>h.join(e,"data","staged-questions.json"),"stagedFile"),Ge=r(e=>h.join(e,"data","screening.json"),"screeningFile"),ks=900*1e3,A=r(e=>e||d("this command needs --site <route>"),"needSite"),S=r((e,t)=>typeof e=="string"&&e.trim()?e.trim():d(`${t} must be non-empty text`),"text"),X=r((e,t)=>e===void 0?void 0:t(e),"optional"),bs=/^prototype-[\w-]+\.html(?:[?#]\S*)?$/,ys=/^visuals\/[\w-]+\/[\w-]+\.html$/,On=r((e,t)=>typeof e=="string"&&(bs.test(e)||ys.test(e)||/^https?:\/\/\S+$/.test(e))?e:d(`${t} must be an http(s) URL or a site page such as prototype-<topic>.html?q=<id>`),"pageUrl"),Tt=r((e,t)=>typeof e=="boolean"?e:d(`${t} must be true or false`),"bool"),ve=r((e,t)=>typeof e=="string"&&/^[\w.-]+$/.test(e)?e:d(`${t} must use only letters, digits, "_", "." and "-"`),"domId"),Ze=r((e,t,n)=>{(!e||typeof e!="object"||Array.isArray(e))&&d(`${n} must be a JSON object`);const a=Object.keys(e).filter(i=>!t.includes(i));a.length&&d(`${n} has unknown field ${a.map(i=>`"${i}"`).join(", ")}; allowed: ${t.join(", ")}`)},"onlyKeys");function N(e){const t=/^([^/\s]+)\/([^/\s]+)$/.exec(e||"");return t?{file:t[1],id:t[2]}:d(`expected <file>/<id>, not "${e}"`)}r(N,"parseKey");async function Be(e,t){const n=(await M(e)).find(i=>i.slug===t)||d(`this board has no item file "${t}"`),a=await g(n.file,null);return(!a||!Array.isArray(a.items))&&d(`${n.file} is not an item file with items[]`),{source:n,itemFile:a}}r(Be,"loadItemFile");async function x(e,t){const{file:n,id:a}=N(t);let i=await Be(e,n);!i.itemFile.items.some(s=>s.id===a)&&await Rr(e,t)&&(i=await Be(e,n));const o=i.itemFile.items.find(s=>s.id===a)||d(`item file "${n}" has no item "${a}"`);return{...i,item:o}}r(x,"loadItem");async function Rl(e,t,n,a){A(e),ve(t,"the event id");const i=(await K(h.join(e,"data","events.jsonl"))).find(p=>p.id===t);i||d(`no event "${t}" in this site's data/events.jsonl`);const o=i.kind==="ask"?`ask:${t}`:i.kind==="item-message"&&typeof i.data?.key=="string"?i.data.key:null,s=a===void 0?void 0:/^ask:(.+)$/.exec(o||"")?.[1]||d(`reply --title names an ask: "${t}" is not an ask or a message in an ask's thread`);s&&S(a,"--title");const l=h.join(e,"data","replies",`${t}.html`);await Qe(l,S(n,"the reply")),s&&await Ua(e,s,a);const c=o?await An(e,o,Fs(n)):[],u=i.kind==="wave-triage"?["wave","file"].filter(p=>typeof i.data?.[p]=="string").map(p=>`${p}:${i.data[p]}`):[],w=i.kind==="ask"?`item:ask:${t}`:u[0];return w&&c.push(...await wi(e,w,"Acted on: replied")),{file:l,lines:c}}r(Rl,"writeReply");const Fa=r(e=>h.join(e,"data","working.json"),"workingFile");async function xs(e){return(await g(Fa(e),{})).events||{}}r(xs,"readWorking");const Nl=["ask","item-message","wave-triage","overnight-triage"];async function El(e,t){if(!t.length)return;const n=new Date().toISOString(),a=await xs(e);await k(Fa(e),{events:{...a,...Object.fromEntries(t.map(i=>[i,V(a,i)||n]))}})}r(El,"markWorking");const Pn=r(e=>h.join(e,"data","push-state.json"),"pushStateFile");async function _s(e,t){A(e);const n=Date.parse((await g(Pn(e),{})).last_push);if(Number.isNaN(n))return 0;const a=h.join(e,"data","replies"),i=(await j.readdir(a).catch(()=>[])).filter(s=>/\.(html|json)$/.test(s));return(await Promise.all(i.map(s=>j.stat(h.join(a,s)).then(l=>l.mtimeMs,()=>0)))).filter(s=>s>n&&s<=t.getTime()).length}r(_s,"repliesSincePush");async function Ss(e,t){return await k(Pn(A(e)),{last_push:t.toISOString()}),Pn(e)}r(Ss,"recordPush");const vs=h.join(h.dirname(ho(import.meta.url)),"..","bin","kickflip.mjs");function js(){if(!process.env.KICKFLIP_PUSH_CMD)return[process.execPath,vs,"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 re("KICKFLIP_PUSH_CMD must be a JSON array of strings")}r(js,"pushCommand");async function Il(e,t){const n=Io(t.kind);n&&d(n),t.title===void 0&&d("push needs --title");const a=new Date,i=Ps(t.body,await _s(e,a)),o={kind:t.kind,title:t.title,body:i||void 0,url:Rs(t.url),tag:t.tag},[s,...l]=js(),c=[...l,...Object.entries(o).flatMap(([p,f])=>f===void 0?[]:[`--${p}`,f]),...t.urgent?["--urgent"]:[],...t.now?["--now"]:[]],u=await new Promise(p=>{ha(s,c,{encoding:"utf8"},(f,m,$)=>p({error:f,said:`${m||""}${$||""}`.split(`
6
- `).filter(y=>y.trim())}))}),w=u.error?typeof u.error.code=="number"?u.error.code:1:0;if(w!==0)throw Object.assign(new re([...u.said,`kickflip push failed (${typeof u.error.code=="number"?`exit ${w}`:u.error.message}); the push was not recorded`].join(`
7
- `)),{exitCode:w});return await Ss(e,a),{lines:u.said}}r(Il,"sendPush");const Os=/(?:^| · )(and \d+ repl(?:y|ies))$/,Ps=r((e,t)=>[e,t&&`and ${t} ${t===1?"reply":"replies"}`].filter(Boolean).join(" \xB7 "),"withReplies"),Ra=160;function As(e){const t=String(e).split(`
8
- `).map(n=>n.replace(/\s+/g," ").trim()).find(Boolean)||"";return t.length>Ra?`${t.slice(0,Ra-1).trimEnd()}\u2026`:t}r(As,"pushLine");const Ds={amp:"&",lt:"<",gt:">",quot:'"',apos:"'",nbsp:" "};function Fs(e){return e.replace(/<details[\s\S]*?<\/details>/gi,`
9
- `).replace(/<(?:br|\/?(?:p|div|li|ul|ol|h\d|blockquote|pre|tr|summary))\b[^>]*>/gi,`
10
- `).replace(/<[^>]*>/g,"").replace(/&(?:#(x[\da-f]{1,6}|\d{1,7})|(\w+));/gi,(t,n,a)=>{const i=n&&parseInt(n.replace(/^x/i,""),/^x/i.test(n)?16:10);return n?i<=1114111?String.fromCodePoint(i):t:V(Ds,a.toLowerCase())??t})}r(Fs,"htmlText");function Rs(e){if(!e||!e.startsWith("/"))return e;const t=new URL(e,"http://board");return/^#(?:selectedCard|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(Rs,"pushUrl");const Ns=r((e,t)=>`/${h.basename(e)}/#selectedCard=${encodeURIComponent(t)}&reply`,"threadUrl");async function An(e,t,n){const a=As(n);if(!a)return[];const i=_o(t),o=await Eo(i,s=>[a,Os.exec(s)?.[1]].filter(Boolean).join(" \xB7 "),Ns(e,t));return o===null?[]:[`queued push ${i} now reads: ${o}`]}r(An,"freshenPush");const Na=r(e=>h.join(e,"data","hidden.json"),"hiddenFile"),Es=r(async e=>new Set((await g(Na(e),{events:[]})).events||[]),"readHidden");let Ea=Promise.resolve();function Ll(e,t,n){ve(t,"the event id");const a=Ea.then(async()=>{const i=await Es(e);n?i.add(t):i.delete(t),await k(Na(e),{events:[...i]})});return Ea=a.catch(()=>{}),a}r(Ll,"setHidden");const Ia=r(e=>h.join(e,"data","read.json"),"readMarksFile"),Is=r(async e=>(await g(Ia(e),{})).cards||{},"readMarks");let La=Promise.resolve();function Bl(e,t,n={}){const a=La.then(async()=>{const i=await Is(e),o=new Date().toISOString(),s=r((c,u)=>String(u||"")>c?u:c,"later"),l=Object.fromEntries([...new Set(t)].sort().map(c=>[c,s(i[c]||o,n[c])]));JSON.stringify(l)!==JSON.stringify(i)&&await k(Ia(e),{cards:l})});return La=a.catch(()=>{}),a}r(Bl,"markRead");const Dn=20*1024*1024,Te=r(e=>h.join(e,"data","uploads"),"uploadsDir"),Ve=r((e,t)=>h.join(Te(e),".meta",`${t}.json`),"uploadMeta"),Ba=/^\d+-[\w.-]+$/,Ta=/^[\w.+-]+\/[\w.+-]+$/,Ca=r(()=>Object.assign(new re(`a file can be at most ${Dn/1024/1024} MB`),{status:413}),"tooLarge");async function Tl(e,t,{name:n,type:a,length:i}){if(A(e),i>Dn)throw Ca();const o=String(n||"").trim().slice(0,200)||"file",s=h.basename(o).replace(/[^\w.-]+/g,"-").replace(/^[.-]+/,"").slice(-80)||"file",l=String(a||"").split(";")[0].trim().toLowerCase(),c=Ta.test(l)?l:"application/octet-stream";await j.mkdir(h.dirname(Ve(e,"x")),{recursive:!0});let u,w;for(let m=Date.now();!w;m++)u=`${m}-${s}`,w=await j.open(h.join(Te(e),u),"wx").catch($=>$.code==="EEXIST"?null:Promise.reject($));const p=h.join(Te(e),u);let f=0;try{for await(const m of t){if(f+=m.length,f>Dn)throw Ca();await w.write(m)}}catch(m){throw await w.close(),await j.rm(p,{force:!0}),m}return await w.close(),await k(Ve(e,u),{name:o,type:c,size:f,at:new Date().toISOString()}),{name:o,url:`uploads/${u}`,path:p,type:c,size:f}}r(Tl,"saveUpload");async function Cl(e,t){if(!Ba.test(t||""))return null;const n=h.join(Te(e),t),a=await j.stat(n).catch(()=>null);if(!a?.isFile())return null;const i=await g(Ve(e,t),{});return{path:n,name:i.name||t,type:Ta.test(i.type||"")?i.type:"application/octet-stream",size:a.size}}r(Cl,"readUpload");const qa=["github","slack"],Ma=r(async(e,t)=>String(t).startsWith("ask:")?it(e,t.slice(4),"the ask"):x(e,t),"checkThreadKey");async function W(e,t,n,a={},{link:i}={}){A(e),await Ma(e,t);const o={ts:new Date().toISOString(),who:"claude",kind:Zo,line:n,text:Yo(n,a),...i?{link:i}:{}};return await me(Y(e,t),o),{line:o,lines:Vo(o).fault?await An(e,t,o.text):[]}}r(W,"appendStatus");async function ht(e,t,{text:n,link:a,log:i,who:o="claude",via:s,by:l}){A(e),await Ma(e,t),/^[^\n]{1,40}$/.test(o.trim())||d("--who takes claude, love or a reviewer's name"),s!==void 0&&!qa.includes(s)&&d(`--via takes ${qa.join(" or ")}`);const c=s===void 0?Fn(n):S(n,"--text"),u={ts:new Date().toISOString(),who:o.trim(),text:c,link:X(a,p=>On(p,"--link")),log:i,via:s,by:l},w=Y(e,t);return await me(w,u),{file:w,lines:u.who==="claude"&&!s?await An(e,t,u.text):[]}}r(ht,"appendMessage");function Fn(e){const t=S(e,"--text");return t.length>_a&&d(`--text runs to ${t.length} characters, past a message's ${_a}: rewrite it shorter, or put the detail in an HTML page (board.mjs visual add, or --link to a page) and link it`),t}r(Fn,"messageText");async function Ce(e,t,{command:n,text:a=Nt[n],who:i="claude",by:o,card:s}){const l={ts:new Date().toISOString(),who:i,command:n,text:a,...o?{by:o}:{},...s?{card:s}:{}};return await me(Y(e,t),l),{lines:[]}}r(Ce,"appendCommand");const ke=r(e=>h.join(e,"data","ask-links.json"),"askLinksFile");async function je(e){return(await g(ke(e),{})).links||{}}r(je,"readAskLinks");async function Q(e,t){const{tickets:n}=be(await ae(e)),a=await M(e),i=/^ask:(.+)$/.exec(t)?.[1];if(i===void 0){const s=/^([^/\s]+)\/([^/\s]+)$/.exec(t);if(!s)return t;const l=a.find(w=>w.slug===s[1]),c=l&&await g(l.file,null);if(!c)return s[2];const u=(c.items||[]).find(w=>w.id===s[2]);return Je(c,u||{id:s[2]},n)}const o=e?V(await je(e),i):void 0;if(o)return Q(e,o);for(const s of a){const l=await g(s.file,null),c=(Array.isArray(l?.items)?l.items:[]).find(u=>u.from_ask===i);if(c)return Je(l,c,n)}return`task ${i}`}r(Q,"cardName");async function ql(e,t){const n=(await K(h.join(e,"data","events.jsonl"))).find(a=>a.id===t);return n?.kind==="ask"?Q(e,`ask:${t}`):typeof n?.data?.key=="string"?Q(e,n.data.key):`the ${n?.kind} event`}r(ql,"eventCard");async function Ml(e,t,n,a,i){A(e),ve(t,"the event id"),(await K(h.join(e,"data","events.jsonl"))).some(l=>l.id===t&&l.kind==="ask")||d(`no ask "${t}" in this site's data/events.jsonl`),await Mt(e,t),await x(e,n),S(a,"--summary"),i!==void 0&&S(i,"--title");const s=await je(e);return await k(ke(e),{links:{...s,[t]:n}}),await ht(e,n,{text:a}),i!==void 0&&await Ua(e,t,i),ke(e)}r(Ml,"relateAsk");const Wa=r(e=>h.join(e,"data","ask-titles.json"),"askTitlesFile");async function Ls(e){return(await g(Wa(e),{})).titles||{}}r(Ls,"readAskTitles");async function Ua(e,t,n){await k(Wa(e),{titles:{...await Ls(e),[t]:S(n,"--title")}})}r(Ua,"titleAsk");async function Wl(e,t){await it(e,t,"the ask");const n=await je(e);return V(n,t)===void 0&&d(`ask "${t}" is not folded into a card`),delete n[t],await k(ke(e),{links:n}),ke(e)}r(Wl,"unfoldAsk");const Ct=r(e=>h.join(e,"data","ask-progress.json"),"askProgressFile");async function qt(e){return(await g(Ct(e),{})).asks||{}}r(qt,"readAskProgress");async function Mt(e,t){const n=V(await qt(e),t)?.moved;n&&d(`ask "${t}" was moved to /${n.route}; it lives there now`)}r(Mt,"refuseMoved");async function Ul(e,t,n,a){await it(e,t,"the ask"),await Mt(e,t);const i=await qt(e);return await k(Ct(e),{asks:{...i,[t]:{state:n,at:new Date().toISOString(),...a===void 0?{}:{next:S(a,"--next")}}}}),Ct(e)}r(Ul,"markAsk");async function Bs(e,t,n){const a=`ask "${t}"`;if(n.some(w=>w.kind==="ask-withdrawn"&&w.data?.id===t&&!w.data?.key))return{why:`${a} was deleted by the owner`};const i=V(await qt(e),t);if(i?.moved)return{why:`${a} was already moved to /${i.moved.route}`};const o=V(await je(e),t);if(o)return{why:`${a} is folded into ${o}; run ask unfold ${t} first`};const s=[];for(const w of await M(e)){const p=await g(w.file,null);for(const f of Array.isArray(p?.items)?p.items:[])f.from_ask===t&&s.push({key:`${w.slug}/${f.id}`,it:f})}const l=s.find(({it:w})=>Le(w)||Ae(w));return l?{why:`${a} became ${l.key}, which has started`}:s.length?{items:s.map(w=>w.key)}:(await Promise.all(["html","json"].map(w=>j.stat(h.join(e,"data","replies",`${t}.${w}`)).then(()=>!0,()=>!1)))).some(Boolean)||!!i||n.some(w=>w.kind==="ask-done"&&w.data?.id===t)||(await K(Y(e,`ask:${t}`))).some(w=>(w.who||"claude")==="claude"&&w.kind!=="status")?{why:`${a} is not New: Claude already answered it`}:null}r(Bs,"askNotNew");async function Ts(e,t,n){const a=/^uploads\/([\w.-]+)$/.exec(n?.url||"")?.[1],i=Ba.test(a||"")?h.join(Te(e),a):null;if(!i||!await j.stat(i).then(c=>c.isFile(),()=>!1))return{name:String(n?.name||a||"file")};await j.mkdir(h.dirname(Ve(t,"x")),{recursive:!0});const o=a.replace(/^\d+-/,"");let s;for(let c=Date.now();s=`${c}-${o}`,!await j.copyFile(i,h.join(Te(t),s),wo.COPYFILE_EXCL).then(()=>!0,w=>w.code==="EEXIST"?!1:Promise.reject(w));c++);const l=await g(Ve(e,a),null);return l&&await k(Ve(t,s),l),{...n,url:`uploads/${s}`,path:h.join(Te(t),s)}}r(Ts,"copyUpload");async function Hl(e,t,n){A(e),ve(t,"the event id"),(typeof n!="string"||!n.trim())&&d("ask move needs --to <route>, the board to move it to");const a=await K(h.join(e,"data","events.jsonl")),i=a.find(P=>P.id===t&&P.kind==="ask")||d(`no ask "${t}" in this site's data/events.jsonl`),o=we(),s=o.find(P=>P.route===n)||d(`--to ${n}: no board at /${n} in the hub's manifest; the boards are ${o.map(P=>P.route).join(", ")||"none"}`);_e(s.dir,e)&&d(`--to ${n}: that is this board`);const l=await Bs(e,t,a);l?.why&&d(l.why);const c=a.filter(P=>P.kind==="ask-edited"&&P.data?.id===t&&typeof P.data?.text=="string").sort((P,B)=>String(P.ts).localeCompare(String(B.ts))),u=c.at(-1),w=[];for(const P of[...i.data?.files||[],...c.flatMap(B=>B.data.files||[])])w.push(await Ts(e,s.dir,P));const p={route:h.basename(e),title:(await ae(e)).title,id:t},f=u?u.data.text:i.data?.text||"",m=await ge(s,"ask",{text:f,...w.length?{files:w}:{},from:p}),$={route:n,title:s.title,id:m},y=new Date().toISOString(),_=await qt(e);await k(Ct(e),{asks:{..._,[t]:{state:"done",at:y,moved:$}}});const D=`/${n}/#selectedCard=${encodeURIComponent(`ask:${m}`)}`;await W(e,`ask:${t}`,"ask-moved",{board:s.title},{link:D});for(const P of l?.items||[])await he(e,P,{done:!0,force:!0,closing:["ask-moved-closed",{board:s.title}]});return{file:h.join(s.dir,"data","events.jsonl"),lines:[`moved to ${D}`,...(l?.items||[]).map(P=>`closed: ${P}`)]}}r(Hl,"moveAsk");async function zl(e,t,{state:n,text:a}={}){return A(e),["posted","needs"].includes(n)||d("review record needs --state posted or --state needs"),String(a??"").trim()||d("review record needs the review text, as --text or --file"),za(e,await Ha(e,t,"review record"),{state:n,text:a})}r(zl,"recordReview");async function Ha(e,t,n){/^[1-9]\d{0,6}$/.test(String(t))||d(`${n} takes the PR number, such as 437, not "${t}"`);const a=await g(h.join(e,"data","incoming.json"),{});return{...(a?.prs||[]).find(s=>s.number===Number(t))||(await g(h.join(e,"data","reviews.json"),{}))[t]||d(`PR #${t} is not an incoming PR on this board`),repo:a?.repo||oe(e,{})}}r(Ha,"incomingPR");async function za(e,{number:t,title:n,author:a,url:i,touches:o=[],asked:s=!1,head:l},{state:c,text:u,review_url:w}){const p=h.join(e,"data","reviews.json"),f=await g(p,{});return f[t]={number:Number(t),title:n,author:a,url:i,touches:o,asked:s,head:l,state:c,text:u,...w?{review_url:w}:{},at:new Date().toISOString()},await k(p,f),{file:p,lines:[]}}r(za,"saveReview");async function Jl(e,t,{words:n,readAt:a}){A(e);const i=await Ha(e,t,"review post"),o=String(n??"").trim()||d("review post needs the review text, as --file"),s=`${wt}Claude review from the ${(await ae(e)).title} board`;(o.startsWith(wt.trim())||o.includes("Claude review from")||o.includes(_n))&&d(`review post adds the ${wt.trim()} header and the claude-bridge marker itself; pass only your words`);const l=i.repo||d("review post needs a board on GitHub; this board has no repo there");Number.isNaN(Date.parse(a))&&d("--read-at takes the time you read the PR, such as 2026-11-05T09:30:00Z");const c=be(await ae(e)).github_login;try{const u=await ns({repo:l,pr:i.number,since:a});u.length&&d(`PR #${t} got ${u.length===1?"a review":`${u.length} reviews`} after ${a} (${u.map(p=>`${p.login} at ${p.at}`).join(", ")}); reread the PR and review again`);const w=await ts({repo:l,pr:i.number,head:i.head,body:`${s}
1
+ var No=Object.defineProperty;var r=(e,t)=>No(e,"name",{value:t,configurable:!0});import j from"node:fs/promises";import{constants as Ro,existsSync as de,readFileSync as Eo}from"node:fs";import g from"node:path";import xn from"node:os";import{execFile as Lo}from"node:child_process";import{nodeBin as Bo}from"../bin/install.mjs";import{gh as Co,limitWords as Io}from"../shared/gh.mjs";import{fileURLToPath as To}from"node:url";import{BUILD_REFUSED as Oa,BUILDER_ASK as Tt,COMMANDS as qt,LANDER as Aa,LANES as Ce,MOVE as Pa,PAUSE_CLEARS as Da,PHASES as _n,handedBackAt as Sn,MAX_IMPLEMENTERS as qo,MAX_PLANNERS as Mo,builds as et,waveItems as Ie,mergeBlockers as Wo,modelName as Mt,noTakePicked as Uo,ownerQuestion as Te,plans as qe,QUESTION_REOPEN as Ho,PLANNER_WORD as Jo,providerOf as _t,owesNext as vn,pushTag as zo,refOf as tt,roundOf as jn,roundSettledBy as Ko,HELPER as re,VISUAL as me,visualAgent as Qo}from"./domain.mjs";import{GITHUB_STATE as On,appendEvent as he,listBoards as ge,readManifest as Go,samePath as Pe,withManifestLock as Vo,writeManifest as Zo}from"../hub/boards.mjs";import{readUsageGate as Fa,pauseReason as Yo,pauseReasonFor as Xo,heldFor as es,holdsWork as ts,builderPick as An,pauseEnd as ns}from"../shared/usage-gate.mjs";import{reviseQueued as as,pushKindError as is,readClaudeModel as Pn}from"../hub/push.mjs";import{AT_RE as os}from"../hub/duration.mjs";import{routeRecord as ae}from"../hub/routes.mjs";import{ticketSource as Na,resolveTicket as ss,ticketTarget as rs,moveTicket as cs,cardIdOf as ls}from"./tickets.mjs";import{LINEAR_NEEDS_KEY as ds,linearStatus as us,linearWorks as fs}from"../hub/linear.mjs";import{validateBranch as ws}from"../hub/repos.mjs";import{withFileLock as nt}from"../hub/locks.mjs";import{audit as ps,auditLines as ms,boardAudit as Ra,readAudit as hs}from"../shared/audit.mjs";import{merge3 as gs}from"./merge3.mjs";import{HUB as Ea,MESSAGE_LIMIT as La,BRIEF_LINE_LIMIT as Ba,hubLineOf as $s,hubText as Ca}from"./hub-lines.mjs";import{fetchPR as Ia,reportOf as Ta,githubLogin as ks,postToPR as bs,postReview as ys,reviewsSince as xs,CLAUDE_PREFIX as St,CLAUDE_MARK as Dn}from"../hub/pr-report.mjs";import{allLanded as _s,cardPRs as Me,hasPR as be,parsePRRef as Fn,prKeyOf as vt,prNames as at,prURL as Nn,storedPRs as De}from"../shared/card-prs.mjs";import{reviewLinks as Ss,topicItems as vs,reviewersOf as Rn}from"./review.mjs";import{readiness as qa}from"../hub/readiness.mjs";import{slackDay as js}from"../hub/slack.mjs";import"../bin/install.mjs";import{readPermissions as Os}from"./permissions.mjs";import{validBuildTarget as Ma}from"./build-script.mjs";import{parseCheck as As,checkText as Ps}from"../shared/owner-check.mjs";import{RuleError as Ds,rulesOf as Wa,addRule as Fs,editRule as Ns,removeRule as Rs,applyRules as Es,readHubRules as Wt,writeHubRules as Ls}from"../hub/rules.mjs";import{shareEntries as Bs,validLogin as Cs}from"../hub/share.mjs";class ue extends Error{static{r(this,"BoardError")}}const d=r(e=>{throw new ue(e)},"fail"),Is=r(()=>g.join(xn.homedir(),".claude","kickflip","sites"),"sitesDir"),Ut=r(()=>g.join(xn.homedir(),".claude","waves"),"wavesDir"),Ua=Symbol("read as"),$=r(async(e,t)=>{let n;try{n=await j.readFile(e,"utf8")}catch{return t}try{const a=JSON.parse(n);return a!==null&&typeof a=="object"&&!Array.isArray(a)?{...a,[Ua]:n}:a}catch{return t}},"readJSON"),z=r(async e=>{try{return(await j.readFile(e,"utf8")).split(`
2
+ `).filter(Boolean).map(t=>JSON.parse(t))}catch{return[]}},"readLines");async function We(e,t){await j.mkdir(g.dirname(e),{recursive:!0});const n=`${e}.${process.pid}.tmp`;await j.writeFile(n,t),await j.rename(n,e)}r(We,"replace");const y=r((e,t)=>{const{[Ua]:n,...a}=t??{};return n===void 0?We(e,JSON.stringify(t,null,2)+`
3
+ `):nt(e,async()=>{const i=JSON.parse(n),o=JSON.parse(await j.readFile(e,"utf8").catch(()=>n));await We(e,JSON.stringify(gs(i,a,o),null,2)+`
4
+ `)})},"writeJSON");async function le(e,t){await j.mkdir(g.dirname(e),{recursive:!0}),await j.appendFile(e,JSON.stringify(t)+`
5
+ `)}r(le,"appendLine");async function Xc(e){/^[\w-]+$/.test(e||"")||d(`--site takes a route such as ios-orchestrator, not "${e}"`);const t=g.join(Is(),e);return await j.stat(t).then(n=>n.isDirectory(),()=>!1)||d(`no site at ${t}`),t}r(Xc,"siteDir");const oe=r(async e=>({title:"Board",items:"waves",...e?await $(g.join(e,"board.json"),{}):{}}),"boardConfig");async function q(e){const t=await oe(e);if(t.items==="waves")try{return(await j.readdir(Ut(),{withFileTypes:!0})).filter(a=>a.isDirectory()).map(a=>({slug:a.name,dir:g.join(Ut(),a.name),file:g.join(Ut(),a.name,"wave.json")}))}catch{return[]}const n=g.resolve(e,t.items);return[{slug:t.slug||g.basename(t.items,".json"),dir:g.dirname(n),file:n}]}r(q,"itemSources");const Z=r((e,t)=>g.join(e,"data","threads",t.replace(/[^\w.-]+/g,"__")+".jsonl"),"threadFile"),E=r(e=>g.join(e,"data","owner.json"),"ownerFile"),ye=r(e=>g.join(e,"data","staged-questions.json"),"stagedFile"),it=r(e=>g.join(e,"data","screening.json"),"screeningFile"),Ts=900*1e3,D=r(e=>e||d("this command needs --site <route>"),"needSite"),S=r((e,t)=>typeof e=="string"&&e.trim()?e.trim():d(`${t} must be non-empty text`),"text"),ee=r((e,t)=>e===void 0?void 0:t(e),"optional"),qs=/^prototype-[\w-]+\.html(?:[?#]\S*)?$/,Ms=/^visuals\/[\w-]+\/[\w-]+\.html$/,En=r((e,t)=>typeof e=="string"&&(qs.test(e)||Ms.test(e)||/^https?:\/\/\S+$/.test(e))?e:d(`${t} must be an http(s) URL or a site page such as prototype-<topic>.html?q=<id>`),"pageUrl"),Ht=r((e,t)=>typeof e=="boolean"?e:d(`${t} must be true or false`),"bool"),Fe=r((e,t)=>typeof e=="string"&&/^[\w.-]+$/.test(e)?e:d(`${t} must use only letters, digits, "_", "." and "-"`),"domId"),ot=r((e,t,n)=>{(!e||typeof e!="object"||Array.isArray(e))&&d(`${n} must be a JSON object`);const a=Object.keys(e).filter(i=>!t.includes(i));a.length&&d(`${n} has unknown field ${a.map(i=>`"${i}"`).join(", ")}; allowed: ${t.join(", ")}`)},"onlyKeys");function F(e){const t=/^([^/\s]+)\/([^/\s]+)$/.exec(e||"");return t?{file:t[1],id:t[2]}:d(`expected <file>/<id>, not "${e}"`)}r(F,"parseKey");async function Ue(e,t){const n=(await q(e)).find(i=>i.slug===t)||d(`this board has no item file "${t}"`),a=await $(n.file,null);return(!a||!Array.isArray(a.items))&&d(`${n.file} is not an item file with items[]`),{source:n,itemFile:a}}r(Ue,"loadItemFile");async function x(e,t){const{file:n,id:a}=F(t);let i=await Ue(e,n);!i.itemFile.items.some(s=>s.id===a)&&await Vr(e,t)&&(i=await Ue(e,n));const o=i.itemFile.items.find(s=>s.id===a)||d(`item file "${n}" has no item "${a}"`);return{...i,item:o}}r(x,"loadItem");const Jt=["md","html","json"];async function Ln(e,t){const n=new RegExp(`^${t.replace(/[.]/g,"\\.")}(?:~(\\d+))?\\.(${Jt.join("|")})$`);return(await j.readdir(e).catch(()=>[])).flatMap(a=>{const i=n.exec(a);return i?[{name:a,ext:i[2],n:Number(i[1]||1)}]:[]}).sort((a,i)=>a.n-i.n||Jt.indexOf(a.ext)-Jt.indexOf(i.ext)).filter((a,i,o)=>a.n!==o[i-1]?.n)}r(Ln,"replyFilesOf");async function el(e,t,n,a){D(e),Fe(t,"the event id");const i=(await z(g.join(e,"data","events.jsonl"))).find(h=>h.id===t);i||d(`no event "${t}" in this site's data/events.jsonl`);const o=i.kind==="ask"?await ze(e,t):null,s=o?o.key:i.kind==="ask"?`ask:${t}`:i.kind==="item-message"&&typeof i.data?.key=="string"?i.data.key:null;o&&ai(o.item)?(S(n,"the reply"),await ii(e,o,a)):a!==void 0&&d(`reply --title titles the New or answered card an ask became; "${t}" is not one`);const c=g.join(e,"data","replies"),l=await Ln(c,t),u=g.join(c,l.length?`${t}~${l.at(-1).n+1}.md`:`${t}.md`);await We(u,S(n,"the reply"));const p=s?await Cn(e,s,n):[],w=i.kind==="wave-triage"?["wave","file"].filter(h=>typeof i.data?.[h]=="string").map(h=>`${h}:${i.data[h]}`):[],f=o?`item:${o.key}`:w[0];return f&&p.push(...await Ei(e,f,"Acted on: replied")),{file:u,lines:p}}r(el,"writeReply");const Ha=r(e=>g.join(e,"data","working.json"),"workingFile");async function Ws(e){return(await $(Ha(e),{})).events||{}}r(Ws,"readWorking");const tl=["ask","item-message","wave-triage","overnight-triage"];async function nl(e,t){if(!t.length)return;const n=new Date().toISOString(),a=await Ws(e);await y(Ha(e),{events:{...a,...Object.fromEntries(t.map(i=>[i,ae(a,i)||n]))}})}r(nl,"markWorking");const Bn=r(e=>g.join(e,"data","push-state.json"),"pushStateFile");async function Us(e,t){D(e);const n=Date.parse((await $(Bn(e),{})).last_push);if(Number.isNaN(n))return 0;const a=g.join(e,"data","replies"),i=(await j.readdir(a).catch(()=>[])).filter(s=>Jt.includes(g.extname(s).slice(1)));return(await Promise.all(i.map(s=>j.stat(g.join(a,s)).then(c=>c.mtimeMs,()=>0)))).filter(s=>s>n&&s<=t.getTime()).length}r(Us,"repliesSincePush");async function Hs(e,t){return await y(Bn(D(e)),{last_push:t.toISOString()}),Bn(e)}r(Hs,"recordPush");const Js=g.join(g.dirname(To(import.meta.url)),"..","bin","kickflip.mjs");function zs(){if(!process.env.KICKFLIP_PUSH_CMD)return[Bo(),Js,"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 ue("KICKFLIP_PUSH_CMD must be a JSON array of strings")}r(zs,"pushCommand");async function al(e,t){const n=is(t.kind);n&&d(n),t.title===void 0&&d("push needs --title");const a=new Date,i=Qs(t.body,await Us(e,a)),o={kind:t.kind,title:t.title,body:i||void 0,url:Vs(t.url),tag:t.tag},[s,...c]=zs(),l=[...c,...Object.entries(o).flatMap(([w,f])=>f===void 0?[]:[`--${w}`,f]),...t.urgent?["--urgent"]:[],...t.now?["--now"]:[]],u=await new Promise(w=>{Lo(s,l,{encoding:"utf8"},(f,h,m)=>w({error:f,said:`${h||""}${m||""}`.split(`
6
+ `).filter(k=>k.trim())}))}),p=u.error?typeof u.error.code=="number"?u.error.code:1:0;if(p!==0)throw Object.assign(new ue([...u.said,`kickflip push failed (${typeof u.error.code=="number"?`exit ${p}`:u.error.message}); the push was not recorded`].join(`
7
+ `)),{exitCode:p});return await Hs(e,a),{lines:u.said}}r(al,"sendPush");const Ks=/(?:^| · )(and \d+ repl(?:y|ies))$/,Qs=r((e,t)=>[e,t&&`and ${t} ${t===1?"reply":"replies"}`].filter(Boolean).join(" \xB7 "),"withReplies"),Ja=160;function Gs(e){const t=String(e).split(`
8
+ `).map(n=>n.replace(/\s+/g," ").trim()).find(Boolean)||"";return t.length>Ja?`${t.slice(0,Ja-1).trimEnd()}\u2026`:t}r(Gs,"pushLine");function Vs(e){if(!e||!e.startsWith("/"))return e;const t=new URL(e,"http://board");return/^#(?:selectedCard|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(Vs,"pushUrl");const Zs=r((e,t)=>`/${g.basename(e)}/#selectedCard=${encodeURIComponent(t)}&reply`,"threadUrl");async function Cn(e,t,n){const a=Gs(n);if(!a)return[];const i=zo(t),o=await as(i,s=>[a,Ks.exec(s)?.[1]].filter(Boolean).join(" \xB7 "),Zs(e,t));return o===null?[]:[`queued push ${i} now reads: ${o}`]}r(Cn,"freshenPush");const za=r(e=>g.join(e,"data","hidden.json"),"hiddenFile"),Ys=r(async e=>new Set((await $(za(e),{events:[]})).events||[]),"readHidden");let Ka=Promise.resolve();function il(e,t,n){Fe(t,"the event id");const a=Ka.then(async()=>{const i=await Ys(e);n?i.add(t):i.delete(t),await y(za(e),{events:[...i]})});return Ka=a.catch(()=>{}),a}r(il,"setHidden");const Qa=r(e=>g.join(e,"data","read.json"),"readMarksFile"),Xs=r(async e=>(await $(Qa(e),{})).cards||{},"readMarks");let Ga=Promise.resolve();function ol(e,t,n={}){const a=Ga.then(async()=>{const i=await Xs(e),o=new Date().toISOString(),s=r((l,u)=>String(u||"")>l?u:l,"later"),c=Object.fromEntries([...new Set(t)].sort().map(l=>[l,s(i[l]||o,n[l])]));JSON.stringify(c)!==JSON.stringify(i)&&await y(Qa(e),{cards:c})});return Ga=a.catch(()=>{}),a}r(ol,"markRead");const In=20*1024*1024,He=r(e=>g.join(e,"data","uploads"),"uploadsDir"),st=r((e,t)=>g.join(He(e),".meta",`${t}.json`),"uploadMeta"),Va=/^\d+-[\w.-]+$/,Za=/^[\w.+-]+\/[\w.+-]+$/,Ya=r(()=>Object.assign(new ue(`a file can be at most ${In/1024/1024} MB`),{status:413}),"tooLarge");async function sl(e,t,{name:n,type:a,length:i}){if(D(e),i>In)throw Ya();const o=String(n||"").trim().slice(0,200)||"file",s=g.basename(o).replace(/[^\w.-]+/g,"-").replace(/^[.-]+/,"").slice(-80)||"file",c=String(a||"").split(";")[0].trim().toLowerCase(),l=Za.test(c)?c:"application/octet-stream";await j.mkdir(g.dirname(st(e,"x")),{recursive:!0});let u,p;for(let h=Date.now();!p;h++)u=`${h}-${s}`,p=await j.open(g.join(He(e),u),"wx").catch(m=>m.code==="EEXIST"?null:Promise.reject(m));const w=g.join(He(e),u);let f=0;try{for await(const h of t){if(f+=h.length,f>In)throw Ya();await p.write(h)}}catch(h){throw await p.close(),await j.rm(w,{force:!0}),h}return await p.close(),await y(st(e,u),{name:o,type:l,size:f,at:new Date().toISOString()}),{name:o,url:`uploads/${u}`,path:w,type:l,size:f}}r(sl,"saveUpload");async function rl(e,t){if(!Va.test(t||""))return null;const n=g.join(He(e),t),a=await j.stat(n).catch(()=>null);if(!a?.isFile())return null;const i=await $(st(e,t),{});return{path:n,name:i.name||t,type:Za.test(i.type||"")?i.type:"application/octet-stream",size:a.size}}r(rl,"readUpload");const Xa=["github","slack"],ei=r(async(e,t)=>String(t).startsWith("ask:")?Dt(e,t.slice(4),"the ask"):x(e,t),"checkThreadKey");async function W(e,t,n,a={},{link:i}={}){D(e),await ei(e,t);const o={ts:new Date().toISOString(),who:"claude",kind:Ea,line:n,text:Ca(n,a),...i?{link:i}:{}};return await le(Z(e,t),o),{line:o,lines:$s(o).fault?await Cn(e,t,o.text):[]}}r(W,"appendStatus");async function rt(e,t,{text:n,link:a,log:i,who:o="claude",via:s,by:c}){D(e),await ei(e,t),/^[^\n]{1,40}$/.test(o.trim())||d("--who takes claude, love or a reviewer's name"),s!==void 0&&!Xa.includes(s)&&d(`--via takes ${Xa.join(" or ")}`);const l=s===void 0?zt(n):S(n,"--text"),u={ts:new Date().toISOString(),who:o.trim(),text:l,link:ee(a,w=>En(w,"--link")),log:i,via:s,by:c},p=Z(e,t);return await le(p,u),{file:p,lines:u.who==="claude"&&!s?await Cn(e,t,u.text):[]}}r(rt,"appendMessage");function zt(e){const t=S(e,"--text");return t.length>La&&d(`--text runs to ${t.length} characters, past a message's ${La}: rewrite it shorter, or put the detail in an HTML page (board.mjs visual add, or --link to a page) and link it`),t}r(zt,"messageText");async function Je(e,t,{command:n,text:a=qt[n],who:i="claude",by:o,card:s}){const c={ts:new Date().toISOString(),who:i,command:n,text:a,...o?{by:o}:{},...s?{card:s}:{}};return await le(Z(e,t),c),{lines:[]}}r(Je,"appendCommand");const xe=r(e=>g.join(e,"data","ask-links.json"),"askLinksFile");async function _e(e){return(await $(xe(e),{})).links||{}}r(_e,"readAskLinks");async function H(e,t){const{tickets:n}=Se(await oe(e)),a=await q(e),i=/^ask:(.+)$/.exec(t)?.[1];if(i===void 0){const s=/^([^/\s]+)\/([^/\s]+)$/.exec(t);if(!s)return t;const c=a.find(p=>p.slug===s[1]),l=c&&await $(c.file,null);if(!l)return s[2];const u=(l.items||[]).find(p=>p.id===s[2]);return tt(l,u||{id:s[2]},n)}const o=e?ae(await _e(e),i):void 0;if(o)return H(e,o);for(const s of a){const c=await $(s.file,null),l=(Array.isArray(c?.items)?c.items:[]).find(u=>u.from_ask===i);if(l)return tt(c,l,n)}return`task ${i}`}r(H,"cardName");async function cl(e,t){const n=(await z(g.join(e,"data","events.jsonl"))).find(a=>a.id===t);return n?.kind==="ask"?H(e,`ask:${t}`):typeof n?.data?.key=="string"?H(e,n.data.key):`the ${n?.kind} event`}r(cl,"eventCard");async function ze(e,t){for(const n of await q(e)){const a=await $(n.file,null),i=(Array.isArray(a?.items)?a.items:[]).find(o=>o.from_ask===t);if(i)return{source:n,itemFile:a,item:i,key:`${n.slug}/${i.id}`}}return null}r(ze,"askCardOf");const Tn=r(e=>!e.phase&&!e.answered_at&&!we(e)&&!be(e)&&!e.filed_held,"stillNew");function qn(e,t){const n=t.filter(i=>i.kind==="ask-edited"&&i.data?.id===e.id&&typeof i.data?.text=="string").sort((i,o)=>String(i.ts).localeCompare(String(o.ts))).at(-1);return String(n?n.data.text:e.data?.text||"").trim().split(`
9
+ `)[0].trim()||(e.data?.files||[]).map(i=>i?.name).filter(Boolean).join(", ")||"Ask"}r(qn,"askTitle");const ll=r((e,t,n)=>ce(e,async()=>{D(e);const a=await z(g.join(e,"data","events.jsonl")),i=n||a.find(l=>l.id===t&&l.kind==="ask")||d(`no ask "${t}" in this site's data/events.jsonl`);if(await ze(e,t)||await ri(e,t,a))return null;const{source:o,itemFile:s}=await ti(e),c=await ni(e,o,i,qn(i,a));return s.items.push(c),await y(o.file,s),`${o.slug}/${c.id}`}),"fileAsk");async function ti(e){const t=await q(e);for(const n of t){const a=await $(n.file,null);if(a)return Array.isArray(a.items)||d(`${n.file} is not an item file with items[]`),{source:n,itemFile:a}}return(await oe(e)).items==="waves"&&d("this board has no wave yet to file a new task in; start a wave first"),await j.mkdir(t[0].dir,{recursive:!0}),{source:t[0],itemFile:{items:[]}}}r(ti,"askFile");async function ni(e,t,n,a){const i=new Date().toISOString(),o={id:await no(e),title:a,created:i,lane:"todo",lane_at:i,from_ask:n.id};return o.plan=Zt(t.dir,o.id),await Yt(g.join(t.dir,o.plan),`# ${o.title}
10
+ `),o}r(ni,"newAskCard");const dl=r(e=>ce(e,async()=>{D(e);const t=r((...m)=>g.join(e,"data",...m),"data"),n=await z(t("events.jsonl")),a=await _e(e),i=new Map(Object.entries(a));for(const m of await q(e))for(const k of(await $(m.file,{})).items||[])k.from_ask&&i.set(k.from_ask,`${m.slug}/${k.id}`);const o=new Set(n.filter(m=>m.kind==="ask-withdrawn").map(m=>m.data?.id)),s=n.filter(m=>m.kind==="ask"&&!o.has(m.id)&&!i.has(m.id)).sort((m,k)=>String(m.ts).localeCompare(String(k.ts))),c=(await $(t("ask-progress.json"),{})).asks||{},l=(await $(t("ask-titles.json"),{})).titles||{},u=new Map(n.filter(m=>m.kind==="ask-done").map(m=>[m.data?.id,String(m.ts)])),p=[];let w;for(const m of s){const k=await z(Z(e,`ask:${m.id}`));if(k.some(A=>A.line==="ask-moved"))continue;const _=await Promise.all((await Ln(t("replies"),m.id)).map(A=>j.stat(t("replies",A.name)).then(I=>I.mtime.toISOString()))),N=k.filter(A=>(A.who||"claude")==="claude"&&A.kind!=="status").map(A=>String(A.ts)),v=[..._,...N].sort().pop()||[ae(c,m.id)?.at,u.get(m.id)].filter(Boolean).sort().pop();w||=await ti(e);const O=await ni(e,w.source,m,ae(l,m.id)||qn(m,n));O.created=m.ts,v&&Ft(O,"done",v),w.itemFile.items.push(O),await y(w.source.file,w.itemFile),i.set(m.id,`${w.source.slug}/${O.id}`),p.push(i.get(m.id))}const f=r(m=>i.get(/^item:ask:(.+)$/.exec(m||"")?.[1]),"cardOf"),h=await $(E(e),null);if(h?.items?.some(m=>f(m.topic))){for(const m of h.items)f(m.topic)&&(m.topic=`item:${f(m.topic)}`);await y(E(e),h)}for(const m of["ask-progress.json","ask-titles.json"])await j.rm(t(m),{force:!0});return p}),"fileAsks"),ul=r((e,t)=>ce(e,async()=>{const n=await ze(D(e),t);if(!n||!Tn(n.item))return null;const a=await z(g.join(e,"data","events.jsonl"));return n.item.title=qn(a.find(i=>i.id===t&&i.kind==="ask"),a),await y(n.source.file,n.itemFile),n.key}),"retitleAskCard");async function Mn(e,{source:t,itemFile:n,item:a,key:i}){n.items=n.items.filter(l=>l!==a);const o=Number(/^T-([1-9]\d*)$/.exec(a.id)?.[1]||0);o>(Number(n.last_task)||0)&&(n.last_task=o),await y(t.file,n),a.plan&&await j.rm(g.join(t.dir,a.plan),{force:!0});const s=Z(e,i),c=await z(s);return await j.rm(s,{force:!0}),c}r(Mn,"dropCard");const fl=r((e,t)=>ce(e,async()=>{const n=await ze(D(e),t);return!n||!Tn(n.item)?null:(await Mn(e,n),n.key)}),"dropAskCard"),ai=r(e=>!e.phase&&!e.closed_at&&!be(e)&&(!we(e)||!!e.answered_at),"answerable");async function ii(e,t,n){const{item:a,key:i}=t;a.from_ask||d(`${i} is not a card an ask became; write in its thread with thread ${i} --text`),ai(a)||d(`${i} is sorted (${a.phase||Ce[a.lane]}), so it is work: write in its thread with thread ${i} --text`),n!==void 0&&(a.title=S(n,"--title")),a.answered_at||=new Date().toISOString(),await y(t.source.file,t.itemFile)}r(ii,"markAnswered");async function oi(e,t,n){const a=await ze(e,t);a&&a.key!==n&&d(`ask "${t}" is already card ${a.key}: sort it with item set ${a.key} --phase, or merge it with item relate-ask ${t} <card>`)}r(oi,"refuseFiled");async function wl(e,t,n,a){D(e);const{source:i,itemFile:o,item:s}=await x(e,t),c={source:i,itemFile:o,item:s,key:t};return zt(n),a!==void 0&&S(a,"--title"),await ii(e,c,a),rt(e,t,{text:n})}r(wl,"answerCard");async function pl(e,t,n,a,i){D(e),Fe(t,"the event id"),(await z(g.join(e,"data","events.jsonl"))).some(l=>l.id===t&&l.kind==="ask")||d(`no ask "${t}" in this site's data/events.jsonl`),await Wn(e,t),await x(e,n),S(a,"--summary"),i!==void 0&&S(i,"--title");const s=await ze(e,t);if(s&&s.key===n&&d(`ask "${t}" is ${n} already`),s&&!Tn(s.item)&&d(`ask "${t}" became ${s.key}, which is sorted; to fold that card's notes into ${n}, use item notes ${n} --from ${s.key}, then close it`),s){const l=await ce(e,()=>Mn(e,s)),u=Z(e,`ask:${t}`);for(const p of l)await le(u,p);await le(u,{ts:new Date().toISOString(),who:"claude",kind:Ea,line:"card-merged",text:Ca("card-merged",{card:await H(e,n)}),into:n,title:i??s.item.title,link:`#selectedCard=${encodeURIComponent(n)}`})}const c=await _e(e);return await y(xe(e),{links:{...c,[t]:n}}),await rt(e,n,{text:a}),xe(e)}r(pl,"relateAsk");async function ml(e,t){await Dt(e,t,"the ask");const n=await _e(e);return ae(n,t)===void 0&&d(`ask "${t}" is not folded into a card`),delete n[t],await y(xe(e),{links:n}),xe(e)}r(ml,"unfoldAsk");const si=r(async(e,t)=>(await z(Z(e,`ask:${t}`))).find(n=>n.line==="ask-moved"),"movedLine");async function Wn(e,t){const n=await si(e,t);n&&d(`ask "${t}" was moved to ${n.link}; it lives there now`)}r(Wn,"refuseMoved");async function ri(e,t,n){const a=`ask "${t}"`;if(n.some(l=>l.kind==="ask-withdrawn"&&l.data?.id===t))return{why:`${a} was deleted by the owner`};const i=await si(e,t);if(i)return{why:`${a} was already moved to ${i.link}`};const o=ae(await _e(e),t);if(o)return{why:`${a} is folded into ${o}; run ask unfold ${t} first`};const s=[];for(const l of await q(e)){const u=await $(l.file,null);for(const p of Array.isArray(u?.items)?u.items:[])p.from_ask===t&&s.push({key:`${l.slug}/${p.id}`,it:p})}const c=s.find(({it:l})=>be(l)||we(l)||l.answered_at);return c?{why:`${a} became ${c.key}, which has started or been answered`}:s.length?{items:s.map(l=>l.key)}:null}r(ri,"askNotNew");async function er(e,t,n){const a=/^uploads\/([\w.-]+)$/.exec(n?.url||"")?.[1],i=Va.test(a||"")?g.join(He(e),a):null;if(!i||!await j.stat(i).then(l=>l.isFile(),()=>!1))return{name:String(n?.name||a||"file")};await j.mkdir(g.dirname(st(t,"x")),{recursive:!0});const o=a.replace(/^\d+-/,"");let s;for(let l=Date.now();s=`${l}-${o}`,!await j.copyFile(i,g.join(He(t),s),Ro.COPYFILE_EXCL).then(()=>!0,p=>p.code==="EEXIST"?!1:Promise.reject(p));l++);const c=await $(st(e,a),null);return c&&await y(st(t,s),c),{...n,url:`uploads/${s}`,path:g.join(He(t),s)}}r(er,"copyUpload");async function hl(e,t,n){D(e),Fe(t,"the event id"),(typeof n!="string"||!n.trim())&&d("ask move needs --to <route>, the board to move it to");const a=await z(g.join(e,"data","events.jsonl")),i=a.find(k=>k.id===t&&k.kind==="ask")||d(`no ask "${t}" in this site's data/events.jsonl`),o=ge(),s=o.find(k=>k.route===n)||d(`--to ${n}: no board at /${n} in the hub's manifest; the boards are ${o.map(k=>k.route).join(", ")||"none"}`);Pe(s.dir,e)&&d(`--to ${n}: that is this board`);const c=await ri(e,t,a);c?.why&&d(c.why);const l=a.filter(k=>k.kind==="ask-edited"&&k.data?.id===t&&typeof k.data?.text=="string").sort((k,_)=>String(k.ts).localeCompare(String(_.ts))),u=l.at(-1),p=[];for(const k of[...i.data?.files||[],...l.flatMap(_=>_.data.files||[])])p.push(await er(e,s.dir,k));const w={route:g.basename(e),title:(await oe(e)).title,id:t},f=u?u.data.text:i.data?.text||"",h=await he(s,"ask",{text:f,...p.length?{files:p}:{},from:w}),m=`/${n}/#selectedCard=${encodeURIComponent(`ask:${h}`)}`;await W(e,`ask:${t}`,"ask-moved",{board:s.title},{link:m});for(const k of c?.items||[]){const{source:_,itemFile:N,item:v}=await x(e,k);await ce(e,()=>Mn(e,{source:_,itemFile:N,item:v,key:k}))}return{file:g.join(s.dir,"data","events.jsonl"),lines:[`moved to ${m}`,...(c?.items||[]).map(k=>`dropped: ${k}`)]}}r(hl,"moveAsk");async function gl(e,t,{state:n,text:a}={}){return D(e),["posted","needs"].includes(n)||d("review record needs --state posted or --state needs"),String(a??"").trim()||d("review record needs the review text, as --text or --file"),li(e,await ci(e,t,"review record"),{state:n,text:a})}r(gl,"recordReview");async function ci(e,t,n){/^[1-9]\d{0,6}$/.test(String(t))||d(`${n} takes the PR number, such as 437, not "${t}"`);const a=await $(g.join(e,"data","incoming.json"),{});return{...(a?.prs||[]).find(s=>s.number===Number(t))||(await $(g.join(e,"data","reviews.json"),{}))[t]||d(`PR #${t} is not an incoming PR on this board`),repo:a?.repo||se(e,{})}}r(ci,"incomingPR");async function li(e,{number:t,title:n,author:a,url:i,touches:o=[],asked:s=!1,head:c},{state:l,text:u,review_url:p}){const w=g.join(e,"data","reviews.json"),f=await $(w,{});return f[t]={number:Number(t),title:n,author:a,url:i,touches:o,asked:s,head:c,state:l,text:u,...p?{review_url:p}:{},at:new Date().toISOString()},await y(w,f),{file:w,lines:[]}}r(li,"saveReview");async function $l(e,t,{words:n,readAt:a}){D(e);const i=await ci(e,t,"review post"),o=String(n??"").trim()||d("review post needs the review text, as --file"),s=`${St}Claude review from the ${(await oe(e)).title} board`;(o.startsWith(St.trim())||o.includes("Claude review from")||o.includes(Dn))&&d(`review post adds the ${St.trim()} header and the claude-bridge marker itself; pass only your words`);const c=i.repo||d("review post needs a board on GitHub; this board has no repo there");Number.isNaN(Date.parse(a))&&d("--read-at takes the time you read the PR, such as 2026-11-05T09:30:00Z");const l=Se(await oe(e)).github_login;try{const u=await xs({repo:c,pr:i.number,since:a});u.length&&d(`PR #${t} got ${u.length===1?"a review":`${u.length} reviews`} after ${a} (${u.map(w=>`${w.login} at ${w.at}`).join(", ")}); reread the PR and review again`);const p=await ys({repo:c,pr:i.number,head:i.head,body:`${s}
11
11
 
12
12
  ${o}
13
13
 
14
- ${_n}`,login:c});return await za(e,i,{state:"posted",text:o,review_url:w}),{lines:[`posted review on PR #${t}: ${w}`]}}catch(u){if(u instanceof re)throw u;d(u.message)}}r(Jl,"postIncomingReview");const Wt=r(e=>h.join(e,"data","handshake.json"),"handshakeFile");async function Ja(e){const t=await g(Wt(e),null);if(!t?.hello)return t;const{hello:n,...a}=t;return{...a,ping:a.ping||n}}r(Ja,"readHandshake");async function Kl(e,t){A(e),ve(t,"the event id");const n=(await K(h.join(e,"data","events.jsonl"))).find(i=>i.id===t);n?.kind!=="ping"&&n?.kind!=="hello"&&d(`no ping event "${t}" in this site's data/events.jsonl`);const a=await Ja(e)||{};return a.ping?.id&&a.ping.id!==t&&d(`"${t}" is an older ping; ack the newest, "${a.ping.id}"`),await k(Wt(e),{...a,ping:a.ping||{id:t,at:n.ts,session:null},ack:{id:t,at:new Date().toISOString()}}),Wt(e)}r(Kl,"ackPing");async function Ql(e){const t=await Ja(e);t&&!t.done_at&&await k(Wt(e),{...t,done_at:new Date().toISOString()})}r(Ql,"finishHandshake");const Rn={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})$/},gt=r((e,t)=>e.trim().toLowerCase()===t.trim().toLowerCase(),"sameName");function Nn(e,t){return Array.isArray(e)||d(`${t} must be a JSON array of reviewers`),e.forEach((n,a)=>{const i=`${t}[${a}]`;Ze(n,Object.keys(Rn),i);for(const[o,s]of Object.entries(Rn))(typeof n[o]!="string"||!s.test(n[o].trim()))&&d(`${i}.${o} must match ${s}`);e.slice(0,a).some(o=>gt(o.name,n.name))&&d(`${t} names "${n.name}" twice`)}),e.map(n=>Object.fromEntries(Object.keys(Rn).map(a=>[a,n[a].trim()])))}r(Nn,"checkReviewers");async function En(e,t){const{file:n,reviewers:a}=await kt(e,o=>{const s=Nn(t(o.reviewers||[]),"the reviewers");return{set:{reviewers:s},reviewers:s}}),i=[];for(const o of await M(e)){const s=await g(o.file,null);(s?.items||[]).some(l=>!G(l))&&(await k(o.file,{...s,reviewers:a}),i.push(`item file ${o.slug}: reviewers copied`))}return{file:n,lines:i}}r(En,"writeReviewers");const Gl=r((e,t)=>En(e,()=>Nn(t,"the reviewer file")),"setReviewers"),Ye=r(e=>h.join(A(e),"data","pr-slack.json"),"prSlackFile"),Ut=r(e=>g(Ye(e),{}),"readPRSlack"),$t=r(e=>!!(e?.ts||e?.posting_at),"held");async function qe(e,t){return pt(e,async()=>{const n=JSON.parse(await j.readFile(e,"utf8").catch(()=>"{}")),a=t(n);return await Qe(e,JSON.stringify(n,null,2)+`
15
- `),a})}r(qe,"editJSON");async function Ht(e,t,n){await qe(e,i=>{const o=t(i);$t(o)&&d("that Slack message has already gone out"),o.posting_at=new Date().toISOString()});let a;try{a=await n()}catch(i){throw await qe(e,o=>{delete t(o).posting_at}),i}try{await qe(e,i=>{const o=t(i);o.ts=a,delete o.posting_at})}catch(i){d(`posted, but its record failed, so it won't go again: ${i.message}`)}return a}r(Ht,"postOnce");const Zl=r((e,t,n,a)=>Ht(Ye(e),i=>{const o=i[t.pr]||={head:t.head,links:{},replies:[]};return o.head??=t.head,Object.assign(o.links[t.reviewer]||={reactions:[]},{channel:n})},()=>a(n)),"postLink"),Vl=r((e,t,n)=>Ht(Ye(e),a=>a[t.pr].replies.find(i=>i.id===t.id).to[t.reviewer],n),"postReply"),Yl=r((e,t)=>qe(Ye(e),n=>{const a=n[t.pr].links[t.reviewer];a.reactions.includes(t.emoji)||a.reactions.push(t.emoji)}),"recordReaction"),Ka=r((e,t,n,a)=>qe(Ye(e),i=>{const o=i[t],s=Object.keys(o?.links||{}).filter(l=>o.links[l].ts);return s.length?(o.replies.push({id:`${n}-${o.replies.length+1}`,text:a,to:Object.fromEntries(s.map(l=>[l,{}]))}),s):[]}),"queueReply");function Cs(e,t,n){const a=e.commits||[],i=a.findIndex(o=>o.oid===n);return[`New push to #${t}`,a.slice(i+1).map(o=>o.subject).join(" \xB7 ")].filter(Boolean).join(`
16
- `)}r(Cs,"pushText");async function Xl(e){const t=await g($n,{}),n=r((a,i)=>{const o=V(t.prs,a)?.head;return!!o&&o!==i.head&&Object.values(i.links).some(s=>s.ts)},"moved");return Object.entries(await Ut(e)).some(([a,i])=>n(a,i))?qe(Ye(e),a=>{const i=[];for(const[o,s]of Object.entries(a)){if(!n(o,s))continue;const l=V(t.prs,o),c=Object.keys(s.links).filter(u=>s.links[u].ts);s.head&&(s.replies.push({id:`push-${s.replies.length+1}`,text:Cs(l,o.split("#")[1],s.head),to:Object.fromEntries(c.map(u=>[u,{}]))}),i.push(o)),s.head=l.head}return i}):[]}r(Xl,"queuePushes");function qs(e,t,n){const a=Number.isInteger(e.additions)?`+${e.additions}/-${e.deletions}, ${e.files} file${e.files===1?"":"s"}`:null;return[e.title||n.title,vn(t),a].filter(Boolean).join(`
17
- `)}r(qs,"linkText");const Qa=r(e=>!!e?.approved||e?.reviewDecision==="APPROVED","approved");async function ec(e,t){A(e);const n=await Oa.waiting("slack");if(n)return{waiting:n,links:[],replies:[],reactions:[],digest:null};const a=await ae(e),i=await g($n,{}),o=await Ut(e),s=[];for(const w of await M(e)){const p=await g(w.file,{}),f=jn(p,a.reviewers);for(const m of p.items||[])if(m.lane!=="done")for(const $ of Ie(m,oe(e,p))){const y=mt($),_=V(i.prs,y);if(!(_?.state!=="OPEN"||_.isDraft))for(const D of f)$t(o[y]?.links?.[D.name])||s.some(P=>P.pr===y&&P.reviewer===D.name)||s.push({pr:y,key:`${w.slug}/${m.id}`,reviewer:D.name,slack_user:D.slack_user,head:_.head||null,text:qs(_,$,m)})}}const l=[],c=[];for(const[w,p]of Object.entries(o)){const f=V(i.prs,w),m=[Qa(f)&&"git_approved",f?.state==="MERGED"?"git_merged":f?.state==="CLOSED"&&"x"].filter(Boolean);for(const[$,y]of Object.entries(p.links))if(y.ts)for(const _ of m)y.reactions.includes(_)||c.push({pr:w,reviewer:$,channel:y.channel,ts:y.ts,emoji:_});for(const $ of p.replies)for(const[y,_]of Object.entries($.to))$t(_)||l.push({pr:w,id:$.id,reviewer:y,channel:p.links[y].channel,thread_ts:p.links[y].ts,text:$.text})}const u=await Ms(e,t);return{links:s,replies:l,reactions:c,digest:u.due?u:null}}r(ec,"reviewDue");async function tc(e,t,n){A(e);const a=S(n,"what changed"),{itemFile:i,item:o}=await x(e,t),s=[];for(const c of Ie(o,oe(e,i)))s.push(...await Ka(e,mt(c),"updated",`Updated: ${a}`));const l=[...new Set(s)];return{lines:[l.length?`Updated queued for ${l.join(", ")} on ${t}`:`no reviewer has a link to ${t}'s PRs; nothing queued`]}}r(tc,"reviewUpdated");async function nc(e,t){const{itemFile:n,item:a}=await x(e,t),i=await Ut(e);return Ie(a,oe(e,n)).some(o=>Object.values(i[mt(o)]?.links||{}).some(s=>s.ts))}r(nc,"cardLinked");const Ga=r(e=>h.join(A(e),"data","review-digests.json"),"digestFile");async function Ms(e,{now:t=new Date}={}){A(e);const n=await ae(e),a=await g($n,{}),i=await Ut(e),o=os(),s=new Map;for(const f of await M(e)){const m=await g(f.file,{}),$=jn(m,n.reviewers);for(const y of $)s.has(y.name)||s.set(y.name,{name:y.name,slack_user:y.slack_user,dm:y.dm,items:[]});for(const y of m.items||[]){if(y.lane==="done")continue;const _=`${f.slug}/${y.id}`,D=is(m,y,_,o);for(const P of Ie(y,oe(e,m))){const B=mt(P),F=V(a.prs,B);if(!(F?.state!=="OPEN"||F.isDraft||F.failing?.length||Qa(F)))for(const I of $){const v=i[B]?.links?.[I.name]?.ts||V(D,I.name)?.ts||null,E=v?(t.getTime()-Number(v)*1e3)/864e5:null,T=E>2?Math.floor(E):null;s.get(I.name).items.push({key:_,pr:B,title:y.title,url:vn(P),sent_ts:v,...T?{days_old:T}:{},text:`${vn(P)} \xB7 ${y.title}${T?` (${T} days old)`:""}`})}}}}const{date:l,open:c}=ss(t),u=((await g(Ga(e),{})).digests||[]).filter(f=>f.date===l),w=await Oa.waiting("slack");for(const f of u)s.has(f.reviewer)||s.set(f.reviewer,{name:f.reviewer,items:[]});const p=[...s.values()].map(f=>{const m=u.find(y=>y.reviewer===f.name),$=m?!m.posting_at&&(!m.ts||m.replies.some(y=>!$t(y))):f.items.length>0;return{...f,owed:$,...m?{sent:m}:{}}}).filter(f=>f.items.length||f.sent);return{date:l,due:!w&&c&&p.some(f=>f.owed),...w?{waiting:w}:{},reviewers:p}}r(Ms,"reviewDigest");async function ac(e,t,n,{channel:a,header:i,post:o}){const s=Ga(e),l=r(w=>(w.digests||[]).find(p=>p.date===t&&p.reviewer===n.name),"entry");await qe(s,w=>{l(w)||(w.digests=[...(w.digests||[]).filter(p=>p.date===t),{date:t,reviewer:n.name,channel:a,replies:n.items.map(p=>({pr:p.pr,text:p.text}))}],delete w.last_date)});const c=l(await g(s,{})),u=c.ts||await Ht(s,l,()=>o({channel:c.channel,text:i(c.replies.length)}));for(const[w,p]of c.replies.entries())$t(p)||await Ht(s,f=>l(f).replies[w],()=>o({channel:c.channel,thread_ts:u,text:p.text}))}r(ac,"postDigest");function ic(e,t){const n=Nn(Array.isArray(t)?t:[t],"the reviewer file");return En(e,a=>[...a.map(i=>n.find(o=>gt(o.name,i.name))||i),...n.filter(i=>!a.some(o=>gt(i.name,o.name)))])}r(ic,"addReviewers");function oc(e,t){return En(e,n=>{const a=t.filter(i=>!n.some(o=>gt(o.name,i)));return a.length&&d(`this board has no reviewer ${a.map(i=>`"${i}"`).join(", ")}`),n.filter(i=>!t.some(o=>gt(i.name,o)))})}r(oc,"removeReviewers");const Ws=r(()=>h.join(pn.homedir(),".claude","kickflip","settings.json"),"hubSettingsFile"),In=r(e=>{try{return e()}catch(t){throw t instanceof ds&&d(t.message),t}},"ruleCall"),Ln=r(async e=>Aa(await g(h.join(e,"board.json"),{})),"readBoardRules");let Za=Promise.resolve();function kt(e,t){const n=Za.then(async()=>{const a=h.join(A(e),"board.json"),i=await g(a,{}),{set:o,...s}=t(i);return await k(a,{...i,...o}),{file:a,...s}});return Za=n.catch(()=>{}),n}r(kt,"writeBoardJSON");const Va=r((e,t)=>kt(e,n=>{const a=In(()=>t(Aa(n)));return{set:{rules:a.rules},...a}}),"writeBoardRules");function sc(e,t){const n=Object.keys(t||{}).sort().join(),a=n==="level,login",i=a?t.login:t?.[n],o=typeof i=="string"?i.trim():null;(!["add","remove","level,login"].includes(n)||!gs(o))&&d("Send add or remove with one login, like name@github, or a listed login with its level."),a&&!["view","full"].includes(t.level)&&d("A level is view or full.");const s=r(({login:l,level:c})=>c==="full"?{login:l,level:c}:l,"stored");return kt(e,l=>{const c=hs(l);a&&!c.some(p=>p.login===o)&&d(`${o} isn't shared with yet. Add them first.`);const w=(n==="remove"?c.filter(p=>p.login!==o):a?c.map(p=>p.login===o?{login:o,level:t.level}:p):c.some(p=>p.login===o)?c:[...c,{login:o,level:"view"}]).map(s);return{set:{share:w},share:w}}).then(({share:l})=>({share:l}))}r(sc,"saveBoardShare");const Ya=r(e=>typeof e=="string"&&/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})$/.test(e),"validGithubLogin"),Xa=r(e=>{try{return e?yn(e):null}catch{return null}},"storedTickets"),Bn=r(e=>Number.isInteger(e)&&e>=1&&e<=99,"validCap"),Tn=["max_implementers","max_planners"],be=r((e,t)=>{const n=Xa(e?.tickets);return{auto_merge:e?.auto_merge===!0,auto_build:e?.auto_build===!0,auto_pull:e?.auto_pull===!0,max_implementers:Bn(e?.max_implementers)?e.max_implementers:go,max_planners:Bn(e?.max_planners)?e.max_planners:$o,auto_triage:e?.auto_triage===!0,auto_review:e?.auto_review===!0,idle_notification:e?.idle_notification===!0,skip_draft:e?.skip_draft===!0,prs:t?.hub?e?.prs===!0:e?.prs!==!1,...n?{tickets:n}:{},...Ya(e?.github_login)?{github_login:e.github_login}:{},...Pa(e?.build_target)?{build_target:e.build_target}:{}}},"settingsOf");async function rc(e,t,n=new Date){let a;try{a=No(t,n)}catch(i){d(i.message)}return await kt(e,()=>({set:{paused_until:a??void 0}})),a}r(rc,"setBoardPause");async function Us(e){const t=A(e);return be(await g(h.join(t,"board.json"),{}),we().find(n=>_e(n.dir,t)))}r(Us,"readBoardSettings");const lc=r((e,t)=>!!e?.github&&(!e.local||e.hub===!0)&&t.prs,"opensPRs");async function Xe(e,t){Ze(t,["auto_merge","auto_build","auto_pull","max_implementers","max_planners","auto_triage","auto_review","idle_notification","skip_draft","prs","tickets","github_login","build_target"],"the settings"),Object.keys(t).length||d("the settings name nothing to change"),t={...t};for(const[n,a]of Object.entries(t))if(n==="tickets"){try{t.tickets=yn(a)}catch(o){d(o.message)}t.tickets.source==="linear"&&!Ho()&&d(Wo);const i=t.tickets.source==="github"&&e?we().find(o=>_e(o.dir,e)):null;i&&!i.github&&d("GitHub issues need the board\u2019s repo on GitHub, and this board\u2019s repo isn\u2019t; pick internal or linear")}else n==="github_login"?a===""||a===null?t.github_login=void 0:Ya(a)||d("github_login must be a GitHub login"):n==="build_target"?a===null?t.build_target=void 0:Pa(a)||d('build_target must name .kickflip/build-<target>: letters, digits, ".", "_" or "-", or null for .kickflip/build'):Tn.includes(n)?Bn(a)||d(`${n} must be a whole number from 1 to 99`):Tt(a,n);if(t.prs===!1){const n=e?we().find(a=>_e(a.dir,e)):null;n?.github&&!n.local&&!(await rs(n.owner?.repo)).pushMain&&d("Merge lands each card on main and pushes it, so turn on Push main after a land first")}return kt(e,n=>{const a=e?we().find(s=>_e(s.dir,e)):null,i=be(n,a),o=be({...n,...t},a);return{set:t,settings:o,changed:Object.keys(t).filter(s=>JSON.stringify(i[s])!==JSON.stringify(o[s]))}})}r(Xe,"saveBoardSettings");async function cc(){if(Uo().set)return[];const e=[];for(const t of we()){if((await Us(t.dir)).tickets?.source!=="linear")continue;const{settings:n}=await Xe(t.dir,{tickets:{source:"internal"}});await ge(t,"settings",{tickets:n.tickets}),e.push(`/${t.route} fell back to internal tickets: Hub has no Linear key`)}return e}r(cc,"fallBackFromLinear");async function dc(e,t,n){const a=String(t).replace(/-/g,"_"),i=["auto_merge","auto_build","auto_pull","max_implementers","max_planners","auto_triage","auto_review","idle_notification","skip_draft","prs","github_login","tickets","build_target"];if(i.includes(a)||d(`no board setting "${t}"; settings are ${i.map(l=>l.replace(/_/g,"-")).join(", ")}`),a==="tickets"){let l;try{l=JSON.parse(n)}catch{d('settings set tickets takes the source as JSON, such as {"source":"github"}')}const{file:c,settings:u}=await Xe(e,{tickets:l});return{file:c,lines:Hs({tickets:u.tickets})}}if(a==="github_login"){const{file:l,settings:c}=await Xe(e,{github_login:n});return{file:l,lines:[`github-login ${c.github_login||"unset"}`]}}if(a==="build_target"){const{file:l,settings:c}=await Xe(e,{build_target:n==="default"?null:n});return{file:l,lines:[`build-target ${c.build_target||"default"}`]}}if(Tn.includes(a)){const{file:l,settings:c}=await Xe(e,{[a]:/^\d+$/.test(n)?Number(n):n});return{file:l,lines:[`${t} ${c[a]}`]}}["on","off"].includes(n)||d(`settings set ${t} takes on or off, not "${n}"`);const{file:o,settings:s}=await Xe(e,{[a]:n==="on"});return{file:o,lines:[`${t} ${s[a]?"on":"off"}`]}}r(dc,"setBoardSetting");const Hs=r(e=>Object.entries(e).map(([t,n])=>`setting ${t.replace(/_/g,"-")} ${t==="tickets"?JSON.stringify(n):t==="github_login"||Tn.includes(t)?n:t==="build_target"?n||"default":n?"on":"off"}`),"settingsLines");async function Cn(e,t,n){const a=t?In(()=>n(Lt())):await Va(e,n);return t&&In(()=>ms(a.rules)),{file:t?Ws():a.file,lines:[`id ${a.rule.id}`]}}r(Cn,"changeRules");async function ei(e,t,n){const a=r(s=>s.map(l=>l.id),"ids");n||A(e);const[i,o]=n?[a(Lt()),e?a(await Ln(e)):[]]:[a(await Ln(e)),a(Lt())];i.includes(t)||d(`no ${n?"hub":"board"} rule "${t}"${o.includes(t)?`; it is a ${n?"board":"hub"} rule, so ${n?"drop":"pass"} --hub`:""}`)}r(ei,"checkRuleId");async function uc(e){const t=r(n=>a=>`${n} ${a.id} ${a.by==="claude"?"claude":"owner"} ${a.text}`,"line");return{lines:[...Lt().map(t("hub")),...e?(await Ln(e)).map(t("board")):[]]}}r(uc,"listRules");function fc(e,{text:t,hub:n=!1,by:a}){return n||A(e),Cn(e,n,i=>us(i,{text:t,by:a}))}r(fc,"addRuleTo");async function pc(e,t,{text:n,hub:a=!1}){return await ei(e,t,a),Cn(e,a,i=>fs(i,t,n))}r(pc,"editRuleIn");async function wc(e,t,{hub:n=!1}){return await ei(e,t,n),Cn(e,n,a=>ps(a,t))}r(wc,"removeRuleFrom");const mc=r((e,t,n)=>Va(e,a=>ws(a,t,n)),"saveBoardRules");async function hc(e,{id:t,title:n,summary:a}){A(e);const i=await g(L(e),{topics:[],items:[]}),o=i.topics||[];return o.some(s=>s.id===S(t,"the topic id"))&&d(`topic "${t}" already exists`),o.push({id:t.trim(),title:S(n,"--title"),...a===void 0?{}:{summary:S(a,"--summary")}}),await k(L(e),{...i,topics:o,items:i.items||[]}),L(e)}r(hc,"addTopic");const ti=["quiet","info","notice","danger","success"];function zs(e,t){if(e.diagram===void 0!=(e.practice===void 0)&&d(`${t} needs diagram and practice together`),e.diagram===void 0)return;const n=e.diagram;(!Array.isArray(n)||!n.length)&&d(`${t}.diagram must be a non-empty array of rows`),n.forEach((a,i)=>{(!Array.isArray(a)||!a.length||a.length>4)&&d(`${t}.diagram[${i}] must be a row of 1 to 4 boxes`),a.forEach((o,s)=>{const l=`${t}.diagram[${i}][${s}]`;Ze(o,["text","tone","to"],l),S(o.text,`${l}.text`),X(o.tone,c=>ti.includes(c)?c:d(`${l}.tone takes ${ti.join(", ")}`)),X(o.to,c=>Array.isArray(c)&&i+1<n.length&&c.every(u=>Number.isInteger(u)&&u>=0&&u<n[i+1].length)?c:d(`${l}.to must list boxes of the next row by index`))})}),(!Array.isArray(e.practice)||!e.practice.length)&&d(`${t}.practice must be a non-empty array of lines`),e.practice.forEach((a,i)=>S(a,`${t}.practice[${i}]`))}r(zs,"checkDiagram");function Js(e,t){(!Array.isArray(e)||!e.length)&&d(`${t}.options must be a non-empty array`);const n=new Set;e.forEach((a,i)=>{const o=`${t}.options[${i}]`;Ze(a,["id","label","recommended","detail","diagram","practice"],o),zs(a,o),n.has(S(a.id,`${o}.id`))&&d(`${t} has two options with id "${a.id}"`),n.add(a.id),S(a.label,`${o}.label`).startsWith(`${a.id}. `)&&d(`${o}.label starts with "${a.id}. ", but the page adds the option letter itself`),X(a.recommended,s=>Tt(s,`${o}.recommended`)),X(a.detail,s=>typeof s=="string"?s:d(`${o}.detail must be text`))}),e.filter(a=>a.recommended).length>1&&d(`${t} recommends more than one option`)}r(Js,"checkOptions");function Ks(e,t,n){Ze(e,["option","card","answer","reason"],n),t.some(a=>a.id===S(e.option,`${n}.option`))||d(`${n}.option names no option "${e.option}"`),S(e.card,`${n}.card`),S(e.answer,`${n}.answer`),X(e.reason,a=>S(a,`${n}.reason`))}r(Ks,"checkSuggested");const et=r(e=>h.join(e,"data","prototypes.json"),"prototypesFile"),qn=r((e,t,n)=>h.join(e,"public","prototypes",t,`${n}.js`),"takeFile");async function bt(e){const t=e?(await g(et(e),{})).prototypes:null;return Array.isArray(t)?t:[]}r(bt,"readPrototypes");const Qs=r(e=>typeof e=="string"&&/^[a-z0-9-]+$/.test(e)?e:d(`a prototype topic uses only a-z, 0-9 and "-", not "${e}"`),"prototypeTopic");function Gs(e){const t=/^([^:]*):(.*)$/s.exec(e);(!t||!/^[A-Z]$/.test(t[1]))&&d(`--take takes KEY:"Label" with KEY one capital letter, not "${e}"`);const n=S(t[2],`--take ${t[1]}'s label`);return/^[A-Z]\.\s/.test(n)&&d(`--take ${t[1]}'s label starts with "${n.slice(0,3)}"; the take pill shows the label alone, so drop the letter`),{key:t[1],label:n}}r(Gs,"prototypeTake");function Zs(e){const t=/^([^:]*):(.*)$/s.exec(e);return(!t||!/^[a-z0-9][a-z0-9-]*$/.test(t[1]))&&d(`--state takes KEY:"Label" with KEY in a-z, 0-9 and "-", not "${e}"`),{key:t[1],label:S(t[2],`--state ${t[1]}'s label`)}}r(Zs,"prototypeState");const ni=r(e=>e.find((t,n)=>e.findIndex(a=>a.key===t.key)!==n),"twiceIn"),Oe=r(e=>/^prototype-(.+)\.html$/.exec(h.posix.basename(String(e||"").split(/[?#]/)[0]))?.[1],"pageTopic");async function gc(e,{topic:t,title:n,card:a,takes:i=[],served:o,states:s=[]}){A(e),Qs(t),S(n,"--title"),i.length||d('prototype add needs a --take KEY:"Label" for each take');const l=i.map(Gs),c=ni(l);c&&d(`--take ${c.key} is given twice`),o!==void 0&&!/^\/\S*$/.test(o)&&d(`--served takes the page's path on the served site, starting with "/", not "${o}"`),s.length&&o===void 0&&d("--state goes with --served: only a served round re-renders its states in place");const u=s.map(Zs),w=ni(u);w&&d(`--state ${w.key} is given twice`),a!==void 0&&await x(e,a);const p=await bt(e);p.some($=>$.topic===t)&&d(`prototype ${t} is already recorded; run prototype rm ${t} first, or pick another topic`),await j.stat(h.join(e,"public",`prototype-${t}.html`)).then(()=>!0,()=>!1)&&d(`public/prototype-${t}.html is a hand-written page that questions may link; pick another topic`);const f={topic:t,title:n.trim(),...a===void 0?{}:{card:a},...o===void 0?{}:{served:o},takes:l,...u.length?{states:u}:{},at:new Date().toISOString()};await k(et(e),{prototypes:[...p,f]});const m=`page prototype-${t}.html`;return o!==void 0?{file:et(e),lines:[m,`served ${o} from the base prototype worktree (board.mjs prototype base)`,...u.length?[`states ${u.map($=>$.key).join(", ")}`]:[]]}:{file:et(e),lines:[m,...l.map($=>`take ${$.key} ${qn(e,t,$.key)}`)]}}r(gc,"addPrototype");async function $c(e){A(e);const t=await bt(e);return{lines:t.length?t.map(n=>[n.topic,n.title,n.takes.map(a=>`${a.key}: ${a.label}`).join(", "),n.card,n.served&&`served ${n.served}`,n.states&&`states ${n.states.map(a=>a.key).join(", ")}`].filter(Boolean).join(" \xB7 ")):["no prototypes recorded"]}}r($c,"listPrototypes");async function kc(e){const t=(await bt(e)).filter(a=>a.served).map(a=>a.topic);if(!t.length)return[];const n=await g(L(e),{items:[]});return t.filter(a=>(n.items||[]).some(i=>!i.resolved&&Oe(i.url)===a))}r(kc,"servedRoundsOpen");async function bc(e,t){A(e);const n=await bt(e);n.some(o=>o.topic===t)||d(`no prototype "${t}" is recorded`);const i=((await g(L(e),{items:[]})).items||[]).filter(o=>!o.resolved&&Oe(o.url)===t).map(o=>o.id);return i.length&&d(`prototype ${t} backs open question ${i.join(", ")}; resolve ${i.length===1?"it":"them"} first`),await k(et(e),{prototypes:n.filter(o=>o.topic!==t)}),et(e)}r(bc,"removePrototype");async function Vs(e,t,n){const a=t.url?.split(/[?#]/)[0];if(!a||!h.posix.basename(a).startsWith("prototype-"))return;const i=h.posix.basename(a),o=t.url.split("#")[0].split("?").slice(1).join("?"),s=`${n}.url`;new URLSearchParams(o).get("q")!==t.id&&d(`${s} must be ${i}?q=${t.id} so the pill can pick`);const l=Oe(a),c=(await bt(e)).find(f=>f.topic===l);c||d(`${s} 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 u=c.takes.map(f=>f.key),w=t.options.map(f=>f.id),p=w.map(f=>u.indexOf(f));if(p.some((f,m)=>f<0||m>0&&f<p[m-1])&&d(`${n}.options ids ${w.join(", ")} must be a non-empty subset of ${i}'s takes, in take order: ${u.join(", ")}`),!c.served)for(const f of u)await j.stat(qn(e,l,f)).then(m=>m.isFile(),()=>!1)||d(`${s} take ${f} has no file yet; write ${qn(e,l,f)}`)}r(Vs,"checkPrototype");async function yc(e,t,n=async()=>{}){A(e);const a=Array.isArray(t)?t:[t];a.length||d("the question file is empty");const i=await g(L(e),{topics:[],items:[]}),o=i.items||[],s=await g($e(e),{}),l=new Set([...o,...Object.values(s).flat()].map(p=>p.id)),c=new Set((i.topics||[]).map(p=>p.id));for(const[p,f]of a.entries()){const m=`question ${f?.id??p+1}`;Ze(f,["id","topic","source","question","context","url","urgent","options","round_of","reask_of","ask","suggested","prototype_gate"],m),l.has(ve(f.id,`${m}.id`))&&d(`question id "${f.id}" is already used`),l.add(f.id),S(f.topic,`${m}.topic`),f.topic.startsWith("item:ask:")?await it(e,f.topic.slice(9),`${m}.topic`):f.topic.startsWith("item:")?await x(e,f.topic.slice(5)):f.topic.startsWith("wave:")?await en(e,f.topic.slice(5)):f.topic.startsWith("file:")?await Ir(e,f.topic.slice(5)):c.has(f.topic)||d(`topic "${f.topic}" is not declared; add it with: topic add ${f.topic} --title <t>`),S(f.question,`${m}.question`),f.question.length>Sa&&d(`${m}.question runs to ${f.question.length} characters, past ${Sa}; keep the question to one line and move the detail into context or the option details, which take markdown`);for(const $ of["source","context"])X(f[$],y=>S(y,`${m}.${$}`));X(f.url,$=>On($,`${m}.url`)),X(f.urgent,$=>Tt($,`${m}.urgent`)),Js(f.options,m),X(f.prototype_gate,$=>Ys($,f,m)),X(f.suggested,$=>Ks($,f.options,`${m}.suggested`)),await Vs(e,f,m),f.ask!==void 0&&await Gr(e,f,m),X(f.round_of,$=>{const y=o.find(_=>_.id===$);y||d(`${m}.round_of names no question "${$}" in owner.json`),y.topic!==f.topic&&d(`${m}.round_of names ${$} on topic ${y.topic}; a round stays on its question's topic, ${f.topic}`),Oe(f.url)||d(`${m}.round_of needs a url on a recorded prototype, prototype-<topic>.html?q=${f.id}`)}),X(f.reask_of,$=>{const y=o.find(_=>_.id===$);y||d(`${m}.reask_of names no question "${$}" in owner.json`),y.topic!==f.topic&&d(`${m}.reask_of names ${$} on topic ${y.topic}; a re-ask stays on its question's topic, ${f.topic}`),y.resolved||d(`${m}.reask_of names ${$}, which is not resolved; only a resolved question is asked again`)})}for(const p of new Set(a.map(f=>Oe(f.url)).filter(Boolean)))await n(e,p);const u=[],w=[];for(const p of a){const f=p.topic.startsWith("item:")&&!p.topic.startsWith("item:ask:")?p.topic.slice(5):null,m=f&&await ai(e,f);m&&((s[f]||=[]).push(p),w.push(p),u.push(`staged: ${p.id} waits for ${f}'s ${m} to finish; the card's staged questions then publish together`))}return w.length&&await k($e(e),s),w.length===a.length?{file:$e(e),lines:u,staged:w.length}:oi(e,i,o,a.filter(p=>!w.includes(p)),u)}r(yc,"addQuestions");async function ai(e,t){const{source:n}=await x(e,t);for(const a of await H(n.dir,N(t).id)){const i=await g(a,null);if(i?.started&&!i.done&&Ee(i)&&i.kind!==pe)return i.kind}return null}r(ai,"runningPlanner");async function tt(e,t,{screen:n=!1}={}){if(!e||await ai(e,t))return;const a=await g($e(e),{});if(!a[t])return;const i=await g(Ge(e),{});if(n){i[t]||await k(Ge(e),{...i,[t]:new Date().toISOString()});return}const{[t]:o,...s}=a,l=await g(L(e),{topics:[],items:[]});await oi(e,l,l.items||[],o,[]),await k($e(e),s),i[t]&&await k(Ge(e),Mn(i,t))}r(tt,"publishStaged");const Mn=r((e,t)=>Object.fromEntries(Object.entries(e).filter(([n])=>n!==t)),"withoutKey");async function ii(e){const t=await g(Ge(e),{}),n=await g($e(e),{});return Object.fromEntries(Object.entries(t).filter(([a])=>n[a]).map(([a,i])=>[a,{since:i,ids:n[a].map(o=>o.id)}]))}r(ii,"readScreening");async function xc(e,t,n){A(e);const a=S(n,"--note"),i=await g($e(e),{}),o=await g(Ge(e),{}),s=Object.keys(i).find(p=>i[p].some(f=>f.id===t));s||d(`no staged question "${t}"; question settle takes a question a finished grill left for you to screen`),o[s]||d(`${t} waits for ${s}'s planner to finish`);const l=i[s].find(p=>p.id===t);l.prototype_gate&&d(`${t} is the card's prototype question, which is the owner's; question publish ${s} passes it on`);const c=new Date().toISOString(),u=await g(L(e),{topics:[],items:[]});await k(L(e),{...u,topics:u.topics||[],items:[...u.items||[],{...l,asked_at:c,resolved:`Settled by the orchestrator: ${a}`,resolved_at:c}]});const w=i[s].filter(p=>p.id!==t);return await k($e(e),w.length?{...i,[s]:w}:Mn(i,s)),w.length||await k(Ge(e),Mn(o,s)),await nt(e,s,`Answers (orchestrator, ${yt()})`,`- ${t} (${l.question}): settled by the orchestrator. "${a}"`),L(e)}r(xc,"settleQuestion");async function _c(e,t){A(e);const n=(await ii(e))[t]?.ids||d(`${t} has no questions waiting on you to screen`);return await tt(e,t),n}r(_c,"publishScreened");async function Sc(e,t=new Date){const n=Object.entries(await ii(e)).filter(([,a])=>t-Date.parse(a.since)>=ks).map(([a])=>a);for(const a of n)await tt(e,a),await W(e,a,"screen-timeout");return n}r(Sc,"publishUnscreened");async function oi(e,t,n,a,i){const{answers:o,requests:s,reopens:l}=await at(e),c=new Date().toISOString(),u=[],w=[];for(const f of a.filter(m=>m.round_of))f.round=gn(n.find(m=>m.id===f.round_of))+1,Pe(t,[f.round_of],`Followed by prototype round ${f.round}`,c),w.push(f.round_of);for(const f of a.filter(m=>m.reask_of))Pe(t,[f.reask_of],`Asked again as ${f.id}`,c),w.push(f.reask_of);for(const f of a){const m=Oe(f.url),$=n.filter(_=>_.topic===f.topic).map(_=>Ne(_,o,s,[],l)),y=f.topic.startsWith("item:")?fi($):[];for(const _ of $)y.includes(_.id)?(Pe(t,[_.id],`Followed by ${f.id}`,c),w.push(_.id)):!_.resolved&&m&&Oe(_.url)===m&&(Pe(t,[_.id],`Replaced by ${f.id}`,c),u.push(_.id))}const p={...t,topics:t.topics||[],items:[...n,...a.map(f=>({...f,asked_at:c}))]};await k(L(e),p);for(const f of new Set(a.map(m=>Wn(m.topic)).filter(Boolean)))await sr(e,f);return{file:L(e),lines:[...i,...u.map(f=>`replaced: ${f}`),...w.map(f=>`resolved: ${f}`)]}}r(oi,"publishQuestions");function Ys(e,t,n){Tt(e,`${n}.prototype_gate`),e&&((!t.topic.startsWith("item:")||t.topic.startsWith("item:ask:"))&&d(`${n}.prototype_gate goes on a card's topic, item:<file>/<id>`),t.options?.map(a=>a.id).join()!=="yes,no"&&d(`${n}.prototype_gate takes exactly the options yes and no, in that order`))}r(Ys,"checkGate");async function vc(e,t){const n=await g(L(e),{topics:[],items:[]}),a=new Map((n.items||[]).map(l=>[l.id,l]));for(const l of t){const c=a.get(String(l.id));if(!c?.prototype_gate||!["yes","no"].includes(l.choice))continue;Pe(n,[c.id],`Prototype round: ${l.choice}. The board moves the card on once every question is answered.`),await k(L(e),n);const u=c.topic.slice(5);l.choice==="yes"&&(await x(e,u).catch(()=>null))?.item.phase==="grilling"&&await Qn(e,u)&&await W(e,u,"prototype-after")}const i=new Map;for(const l of t){const c=a.get(String(l.id)),u=Wn(c?.topic);u&&i.set(u,[...i.get(u)||[],er(c,l)])}const o=[],s=[];for(const[l,c]of i)await x(e,l).catch(()=>null)&&await Xs(e,l,"writing them into its notes",async()=>{await nt(e,l,`Answers (owner, ${yt()})`,c.join(`
18
- `));const u=await si(e,l);u==="prototyping"&&o.push(l),u==="staging"&&s.push(l)});return{prototype:o,staged:s}}r(vc,"settleAnswers");async function si(e,t,{roundAt:n=!1}={}){const{item:a}=await x(e,t),{asked:i}=await de(e,t);if(i.some(o=>o.state==="open"))return null;if(a.phase==="grilling"&&i.some(o=>o.prototype_gate&&o.answers.at(-1)?.choice==="yes")){if(await he(e,t,{phase:"prototyping"}),n){const{source:o,itemFile:s,item:l}=await x(e,t);l.round_at=new Date().toISOString(),await k(o.file,s)}return await W(e,t,"prototype-round"),"prototyping"}return await ir(e,t)?(await Kn(e,t),"staging"):null}r(si,"moveOnAnswered");async function Xs(e,t,n,a){try{await a()}catch(i){if(!(i instanceof re))throw i;await W(e,t,"answers-failed",{what:n,error:i.message})}}r(Xs,"followUp");const Wn=r(e=>typeof e=="string"&&e.startsWith("item:")&&!e.startsWith("item:ask:")?e.slice(5):null,"cardOfTopic"),zt=r(e=>String(e).padStart(2,"0"),"pad2"),yt=r((e=new Date)=>`${zt(e.getMonth()+1)}/${zt(e.getDate())} ${zt(e.getHours())}:${zt(e.getMinutes())}`,"noteStamp");function er(e,t){const n=t.choice===null||t.choice===void 0||t.choice===""?null:(e.options||[]).find(i=>i.id===t.choice)?.label??String(t.choice),a=String(t.note||"").trim();return`- ${e.id} (${e.question}): ${n?`${n}.`:"no option picked."}${a?` Note, verbatim: "${a}"`:""}`}r(er,"answerLine");const ri=292,Un=r(e=>String(e).toLowerCase().replace(/[^a-z0-9-]+/g,"-"),"notesBase"),tr=r((e,t,n)=>pt(h.join(e,`.${Un(t)}-notes`),n),"notesLock");function Hn(e,t){let n=`${Un(t)}-notes.md`;for(let a=2;ce(h.join(e,n));a++)n=`${Un(t)}-notes-${a}.md`;return n}r(Hn,"freeNotesName");async function zn(e,t){const n=h.join(h.dirname(e),`.${h.basename(e)}.${process.pid}.tmp`);await j.rm(n,{force:!0}),await j.writeFile(n,t,{mode:ri}),await j.rename(n,e)}r(zn,"writeNotesFile");const nr=r(e=>/\n/.test(S(e,"--heading"))?d("--heading is one line, the section's title"):S(e,"--heading"),"notesHeading"),ar=r((e,t,n)=>`${e.replace(/\n*$/,`
14
+ ${Dn}`,login:l});return await li(e,i,{state:"posted",text:o,review_url:p}),{lines:[`posted review on PR #${t}: ${p}`]}}catch(u){if(u instanceof ue)throw u;d(u.message)}}r($l,"postIncomingReview");const Kt=r(e=>g.join(e,"data","handshake.json"),"handshakeFile");async function di(e){const t=await $(Kt(e),null);if(!t?.hello)return t;const{hello:n,...a}=t;return{...a,ping:a.ping||n}}r(di,"readHandshake");async function kl(e,t){D(e),Fe(t,"the event id");const n=(await z(g.join(e,"data","events.jsonl"))).find(i=>i.id===t);n?.kind!=="ping"&&n?.kind!=="hello"&&d(`no ping event "${t}" in this site's data/events.jsonl`);const a=await di(e)||{};return a.ping?.id&&a.ping.id!==t&&d(`"${t}" is an older ping; ack the newest, "${a.ping.id}"`),await y(Kt(e),{...a,ping:a.ping||{id:t,at:n.ts,session:null},ack:{id:t,at:new Date().toISOString()}}),Kt(e)}r(kl,"ackPing");async function bl(e){const t=await di(e);t&&!t.done_at&&await y(Kt(e),{...t,done_at:new Date().toISOString()})}r(bl,"finishHandshake");const Un={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})$/},jt=r((e,t)=>e.trim().toLowerCase()===t.trim().toLowerCase(),"sameName");function Hn(e,t){return Array.isArray(e)||d(`${t} must be a JSON array of reviewers`),e.forEach((n,a)=>{const i=`${t}[${a}]`;ot(n,Object.keys(Un),i);for(const[o,s]of Object.entries(Un))(typeof n[o]!="string"||!s.test(n[o].trim()))&&d(`${i}.${o} must match ${s}`);e.slice(0,a).some(o=>jt(o.name,n.name))&&d(`${t} names "${n.name}" twice`)}),e.map(n=>Object.fromEntries(Object.keys(Un).map(a=>[a,n[a].trim()])))}r(Hn,"checkReviewers");async function Jn(e,t){const{file:n,reviewers:a}=await At(e,o=>{const s=Hn(t(o.reviewers||[]),"the reviewers");return{set:{reviewers:s},reviewers:s}}),i=[];for(const o of await q(e)){const s=await $(o.file,null);(s?.items||[]).some(c=>!K(c))&&(await y(o.file,{...s,reviewers:a}),i.push(`item file ${o.slug}: reviewers copied`))}return{file:n,lines:i}}r(Jn,"writeReviewers");const yl=r((e,t)=>Jn(e,()=>Hn(t,"the reviewer file")),"setReviewers"),ct=r(e=>g.join(D(e),"data","pr-slack.json"),"prSlackFile"),Qt=r(e=>$(ct(e),{}),"readPRSlack"),Ot=r(e=>!!(e?.ts||e?.posting_at),"held");async function Ke(e,t){return nt(e,async()=>{const n=JSON.parse(await j.readFile(e,"utf8").catch(()=>"{}")),a=t(n);return await We(e,JSON.stringify(n,null,2)+`
15
+ `),a})}r(Ke,"editJSON");async function Gt(e,t,n){await Ke(e,i=>{const o=t(i);Ot(o)&&d("that Slack message has already gone out"),o.posting_at=new Date().toISOString()});let a;try{a=await n()}catch(i){throw await Ke(e,o=>{delete t(o).posting_at}),i}try{await Ke(e,i=>{const o=t(i);o.ts=a,delete o.posting_at})}catch(i){d(`posted, but its record failed, so it won't go again: ${i.message}`)}return a}r(Gt,"postOnce");const xl=r((e,t,n,a)=>Gt(ct(e),i=>{const o=i[t.pr]||={head:t.head,links:{},replies:[]};return o.head??=t.head,Object.assign(o.links[t.reviewer]||={reactions:[]},{channel:n})},()=>a(n)),"postLink"),_l=r((e,t,n)=>Gt(ct(e),a=>a[t.pr].replies.find(i=>i.id===t.id).to[t.reviewer],n),"postReply"),Sl=r((e,t)=>Ke(ct(e),n=>{const a=n[t.pr].links[t.reviewer];a.reactions.includes(t.emoji)||a.reactions.push(t.emoji)}),"recordReaction"),ui=r((e,t,n,a)=>Ke(ct(e),i=>{const o=i[t],s=Object.keys(o?.links||{}).filter(c=>o.links[c].ts);return s.length?(o.replies.push({id:`${n}-${o.replies.length+1}`,text:a,to:Object.fromEntries(s.map(c=>[c,{}]))}),s):[]}),"queueReply");function tr(e,t,n){const a=e.commits||[],i=a.findIndex(o=>o.oid===n);return[`New push to #${t}`,a.slice(i+1).map(o=>o.subject).join(" \xB7 ")].filter(Boolean).join(`
16
+ `)}r(tr,"pushText");async function vl(e){const t=await $(On,{}),n=r((a,i)=>{const o=ae(t.prs,a)?.head;return!!o&&o!==i.head&&Object.values(i.links).some(s=>s.ts)},"moved");return Object.entries(await Qt(e)).some(([a,i])=>n(a,i))?Ke(ct(e),a=>{const i=[];for(const[o,s]of Object.entries(a)){if(!n(o,s))continue;const c=ae(t.prs,o),l=Object.keys(s.links).filter(u=>s.links[u].ts);s.head&&(s.replies.push({id:`push-${s.replies.length+1}`,text:tr(c,o.split("#")[1],s.head),to:Object.fromEntries(l.map(u=>[u,{}]))}),i.push(o)),s.head=c.head}return i}):[]}r(vl,"queuePushes");function nr(e,t,n){const a=Number.isInteger(e.additions)?`+${e.additions}/-${e.deletions}, ${e.files} file${e.files===1?"":"s"}`:null;return[e.title||n.title,Nn(t),a].filter(Boolean).join(`
17
+ `)}r(nr,"linkText");const fi=r(e=>!!e?.approved||e?.reviewDecision==="APPROVED","approved");async function jl(e,t){D(e);const n=await qa.waiting("slack");if(n)return{waiting:n,links:[],replies:[],reactions:[],digest:null};const a=await oe(e),i=await $(On,{}),o=await Qt(e),s=[];for(const p of await q(e)){const w=await $(p.file,{}),f=Rn(w,a.reviewers);for(const h of w.items||[])if(h.lane!=="done")for(const m of Me(h,se(e,w))){const k=vt(m),_=ae(i.prs,k);if(!(_?.state!=="OPEN"||_.isDraft))for(const N of f)Ot(o[k]?.links?.[N.name])||s.some(v=>v.pr===k&&v.reviewer===N.name)||s.push({pr:k,key:`${p.slug}/${h.id}`,reviewer:N.name,slack_user:N.slack_user,head:_.head||null,text:nr(_,m,h)})}}const c=[],l=[];for(const[p,w]of Object.entries(o)){const f=ae(i.prs,p),h=[fi(f)&&"git_approved",f?.state==="MERGED"?"git_merged":f?.state==="CLOSED"&&"x"].filter(Boolean);for(const[m,k]of Object.entries(w.links))if(k.ts)for(const _ of h)k.reactions.includes(_)||l.push({pr:p,reviewer:m,channel:k.channel,ts:k.ts,emoji:_});for(const m of w.replies)for(const[k,_]of Object.entries(m.to))Ot(_)||c.push({pr:p,id:m.id,reviewer:k,channel:w.links[k].channel,thread_ts:w.links[k].ts,text:m.text})}const u=await ar(e,t);return{links:s,replies:c,reactions:l,digest:u.due?u:null}}r(jl,"reviewDue");async function Ol(e,t,n){D(e);const a=S(n,"what changed"),{itemFile:i,item:o}=await x(e,t),s=[];for(const l of Me(o,se(e,i)))s.push(...await ui(e,vt(l),"updated",`Updated: ${a}`));const c=[...new Set(s)];return{lines:[c.length?`Updated queued for ${c.join(", ")} on ${t}`:`no reviewer has a link to ${t}'s PRs; nothing queued`]}}r(Ol,"reviewUpdated");async function Al(e,t){const{itemFile:n,item:a}=await x(e,t),i=await Qt(e);return Me(a,se(e,n)).some(o=>Object.values(i[vt(o)]?.links||{}).some(s=>s.ts))}r(Al,"cardLinked");const wi=r(e=>g.join(D(e),"data","review-digests.json"),"digestFile");async function ar(e,{now:t=new Date}={}){D(e);const n=await oe(e),a=await $(On,{}),i=await Qt(e),o=vs(),s=new Map;for(const f of await q(e)){const h=await $(f.file,{}),m=Rn(h,n.reviewers);for(const k of m)s.has(k.name)||s.set(k.name,{name:k.name,slack_user:k.slack_user,dm:k.dm,items:[]});for(const k of h.items||[]){if(k.lane==="done")continue;const _=`${f.slug}/${k.id}`,N=Ss(h,k,_,o);for(const v of Me(k,se(e,h))){const O=vt(v),A=ae(a.prs,O);if(!(A?.state!=="OPEN"||A.isDraft||A.failing?.length||fi(A)))for(const I of m){const B=i[O]?.links?.[I.name]?.ts||ae(N,I.name)?.ts||null,P=B?(t.getTime()-Number(B)*1e3)/864e5:null,L=P>2?Math.floor(P):null;s.get(I.name).items.push({key:_,pr:O,title:k.title,url:Nn(v),sent_ts:B,...L?{days_old:L}:{},text:`${Nn(v)} \xB7 ${k.title}${L?` (${L} days old)`:""}`})}}}}const{date:c,open:l}=js(t),u=((await $(wi(e),{})).digests||[]).filter(f=>f.date===c),p=await qa.waiting("slack");for(const f of u)s.has(f.reviewer)||s.set(f.reviewer,{name:f.reviewer,items:[]});const w=[...s.values()].map(f=>{const h=u.find(k=>k.reviewer===f.name),m=h?!h.posting_at&&(!h.ts||h.replies.some(k=>!Ot(k))):f.items.length>0;return{...f,owed:m,...h?{sent:h}:{}}}).filter(f=>f.items.length||f.sent);return{date:c,due:!p&&l&&w.some(f=>f.owed),...p?{waiting:p}:{},reviewers:w}}r(ar,"reviewDigest");async function Pl(e,t,n,{channel:a,header:i,post:o}){const s=wi(e),c=r(p=>(p.digests||[]).find(w=>w.date===t&&w.reviewer===n.name),"entry");await Ke(s,p=>{c(p)||(p.digests=[...(p.digests||[]).filter(w=>w.date===t),{date:t,reviewer:n.name,channel:a,replies:n.items.map(w=>({pr:w.pr,text:w.text}))}],delete p.last_date)});const l=c(await $(s,{})),u=l.ts||await Gt(s,c,()=>o({channel:l.channel,text:i(l.replies.length)}));for(const[p,w]of l.replies.entries())Ot(w)||await Gt(s,f=>c(f).replies[p],()=>o({channel:l.channel,thread_ts:u,text:w.text}))}r(Pl,"postDigest");function Dl(e,t){const n=Hn(Array.isArray(t)?t:[t],"the reviewer file");return Jn(e,a=>[...a.map(i=>n.find(o=>jt(o.name,i.name))||i),...n.filter(i=>!a.some(o=>jt(i.name,o.name)))])}r(Dl,"addReviewers");function Fl(e,t){return Jn(e,n=>{const a=t.filter(i=>!n.some(o=>jt(o.name,i)));return a.length&&d(`this board has no reviewer ${a.map(i=>`"${i}"`).join(", ")}`),n.filter(i=>!t.some(o=>jt(i.name,o)))})}r(Fl,"removeReviewers");const ir=r(()=>g.join(xn.homedir(),".claude","kickflip","settings.json"),"hubSettingsFile"),zn=r(e=>{try{return e()}catch(t){throw t instanceof Ds&&d(t.message),t}},"ruleCall"),Kn=r(async e=>Wa(await $(g.join(e,"board.json"),{})),"readBoardRules");let pi=Promise.resolve();function At(e,t){const n=pi.then(async()=>{const a=g.join(D(e),"board.json"),i=await $(a,{}),{set:o,...s}=t(i);return await y(a,{...i,...o}),{file:a,...s}});return pi=n.catch(()=>{}),n}r(At,"writeBoardJSON");const mi=r((e,t)=>At(e,n=>{const a=zn(()=>t(Wa(n)));return{set:{rules:a.rules},...a}}),"writeBoardRules");function Nl(e,t){const n=Object.keys(t||{}).sort().join(),a=n==="level,login",i=a?t.login:t?.[n],o=typeof i=="string"?i.trim():null;(!["add","remove","level,login"].includes(n)||!Cs(o))&&d("Send add or remove with one login, like name@github, or a listed login with its level."),a&&!["view","full"].includes(t.level)&&d("A level is view or full.");const s=r(({login:c,level:l})=>l==="full"?{login:c,level:l}:c,"stored");return At(e,c=>{const l=Bs(c);a&&!l.some(w=>w.login===o)&&d(`${o} isn't shared with yet. Add them first.`);const p=(n==="remove"?l.filter(w=>w.login!==o):a?l.map(w=>w.login===o?{login:o,level:t.level}:w):l.some(w=>w.login===o)?l:[...l,{login:o,level:"view"}]).map(s);return{set:{share:p},share:p}}).then(({share:c})=>({share:c}))}r(Nl,"saveBoardShare");const hi=r(e=>typeof e=="string"&&/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})$/.test(e),"validGithubLogin"),gi=r(e=>{try{return e?Na(e):null}catch{return null}},"storedTickets"),Qn=r(e=>Number.isInteger(e)&&e>=1&&e<=99,"validCap"),Gn=["max_implementers","max_planners"],Se=r((e,t)=>{const n=gi(e?.tickets);return{auto_merge:e?.auto_merge===!0,auto_build:e?.auto_build===!0,auto_pull:e?.auto_pull===!0,max_implementers:Qn(e?.max_implementers)?e.max_implementers:qo,max_planners:Qn(e?.max_planners)?e.max_planners:Mo,auto_triage:e?.auto_triage===!0,auto_review:e?.auto_review===!0,idle_notification:e?.idle_notification===!0,skip_draft:e?.skip_draft===!0,prs:t?.hub?e?.prs===!0:e?.prs!==!1,...n?{tickets:n}:{},...hi(e?.github_login)?{github_login:e.github_login}:{},...Ma(e?.build_target)?{build_target:e.build_target}:{}}},"settingsOf");async function Rl(e,t,n=new Date){let a;try{a=ns(t,n)}catch(i){d(i.message)}return await At(e,()=>({set:{paused_until:a??void 0}})),a}r(Rl,"setBoardPause");async function or(e){const t=D(e);return Se(await $(g.join(t,"board.json"),{}),ge().find(n=>Pe(n.dir,t)))}r(or,"readBoardSettings");const El=r((e,t)=>!!e?.github&&(!e.local||e.hub===!0)&&t.prs,"opensPRs");async function lt(e,t){ot(t,["auto_merge","auto_build","auto_pull","max_implementers","max_planners","auto_triage","auto_review","idle_notification","skip_draft","prs","tickets","github_login","build_target"],"the settings"),Object.keys(t).length||d("the settings name nothing to change"),t={...t};for(const[n,a]of Object.entries(t))if(n==="tickets"){try{t.tickets=Na(a)??void 0}catch(o){d(o.message)}t.tickets?.source==="linear"&&!fs()&&d(ds);const i=t.tickets?.source==="github"&&e?ge().find(o=>Pe(o.dir,e)):null;i&&!i.github&&d("GitHub issues need the board\u2019s repo on GitHub, and this board\u2019s repo isn\u2019t; pick none or linear")}else n==="github_login"?a===""||a===null?t.github_login=void 0:hi(a)||d("github_login must be a GitHub login"):n==="build_target"?a===null?t.build_target=void 0:Ma(a)||d('build_target must name .kickflip/build-<target>: letters, digits, ".", "_" or "-", or null for .kickflip/build'):Gn.includes(n)?Qn(a)||d(`${n} must be a whole number from 1 to 99`):Ht(a,n);if(t.prs===!1){const n=e?ge().find(a=>Pe(a.dir,e)):null;n?.github&&!n.local&&!(await Os(n.owner?.repo)).pushMain&&d("Merge lands each card on main and pushes it, so turn on Push main after a land first")}return At(e,n=>{const a=e?ge().find(s=>Pe(s.dir,e)):null,i=Se(n,a),o=Se({...n,...t},a);return{set:t,settings:o,changed:Object.keys(t).filter(s=>JSON.stringify(i[s])!==JSON.stringify(o[s]))}})}r(lt,"saveBoardSettings");async function Ll(){if(us().set)return[];const e=[];for(const t of ge())(await or(t.dir)).tickets?.source==="linear"&&(await lt(t.dir,{tickets:{source:"none"}}),await he(t,"settings",{tickets:null}),e.push(`/${t.route} fell back to no ticket source: Hub has no Linear key`));return e}r(Ll,"fallBackFromLinear");async function Bl(e,t,n){const a=String(t).replace(/-/g,"_"),i=["auto_merge","auto_build","auto_pull","max_implementers","max_planners","auto_triage","auto_review","idle_notification","skip_draft","prs","github_login","tickets","build_target"];if(i.includes(a)||d(`no board setting "${t}"; settings are ${i.map(c=>c.replace(/_/g,"-")).join(", ")}`),a==="tickets"){let c;try{c=JSON.parse(n)}catch{d('settings set tickets takes the source as JSON, such as {"source":"github"}')}const{file:l,settings:u}=await lt(e,{tickets:c});return{file:l,lines:sr({tickets:u.tickets})}}if(a==="github_login"){const{file:c,settings:l}=await lt(e,{github_login:n});return{file:c,lines:[`github-login ${l.github_login||"unset"}`]}}if(a==="build_target"){const{file:c,settings:l}=await lt(e,{build_target:n==="default"?null:n});return{file:c,lines:[`build-target ${l.build_target||"default"}`]}}if(Gn.includes(a)){const{file:c,settings:l}=await lt(e,{[a]:/^\d+$/.test(n)?Number(n):n});return{file:c,lines:[`${t} ${l[a]}`]}}["on","off"].includes(n)||d(`settings set ${t} takes on or off, not "${n}"`);const{file:o,settings:s}=await lt(e,{[a]:n==="on"});return{file:o,lines:[`${t} ${s[a]?"on":"off"}`]}}r(Bl,"setBoardSetting");const sr=r(e=>Object.entries(e).map(([t,n])=>`setting ${t.replace(/_/g,"-")} ${t==="tickets"?JSON.stringify(n??{source:"none"}):t==="github_login"||Gn.includes(t)?n:t==="build_target"?n||"default":n?"on":"off"}`),"settingsLines");async function Vn(e,t,n){const a=t?zn(()=>n(Wt())):await mi(e,n);return t&&zn(()=>Ls(a.rules)),{file:t?ir():a.file,lines:[`id ${a.rule.id}`]}}r(Vn,"changeRules");async function $i(e,t,n){const a=r(s=>s.map(c=>c.id),"ids");n||D(e);const[i,o]=n?[a(Wt()),e?a(await Kn(e)):[]]:[a(await Kn(e)),a(Wt())];i.includes(t)||d(`no ${n?"hub":"board"} rule "${t}"${o.includes(t)?`; it is a ${n?"board":"hub"} rule, so ${n?"drop":"pass"} --hub`:""}`)}r($i,"checkRuleId");async function Cl(e){const t=r(n=>a=>`${n} ${a.id} ${a.by==="claude"?"claude":"owner"} ${a.text}`,"line");return{lines:[...Wt().map(t("hub")),...e?(await Kn(e)).map(t("board")):[]]}}r(Cl,"listRules");function Il(e,{text:t,hub:n=!1,by:a}){return n||D(e),Vn(e,n,i=>Fs(i,{text:t,by:a}))}r(Il,"addRuleTo");async function Tl(e,t,{text:n,hub:a=!1}){return await $i(e,t,a),Vn(e,a,i=>Ns(i,t,n))}r(Tl,"editRuleIn");async function ql(e,t,{hub:n=!1}){return await $i(e,t,n),Vn(e,n,a=>Rs(a,t))}r(ql,"removeRuleFrom");const Ml=r((e,t,n)=>mi(e,a=>Es(a,t,n)),"saveBoardRules");async function Wl(e,{id:t,title:n,summary:a}){D(e);const i=await $(E(e),{topics:[],items:[]}),o=i.topics||[];return o.some(s=>s.id===S(t,"the topic id"))&&d(`topic "${t}" already exists`),o.push({id:t.trim(),title:S(n,"--title"),...a===void 0?{}:{summary:S(a,"--summary")}}),await y(E(e),{...i,topics:o,items:i.items||[]}),E(e)}r(Wl,"addTopic");const ki=["quiet","info","notice","danger","success"];function rr(e,t){if(e.diagram===void 0!=(e.practice===void 0)&&d(`${t} needs diagram and practice together`),e.diagram===void 0)return;const n=e.diagram;(!Array.isArray(n)||!n.length)&&d(`${t}.diagram must be a non-empty array of rows`),n.forEach((a,i)=>{(!Array.isArray(a)||!a.length||a.length>4)&&d(`${t}.diagram[${i}] must be a row of 1 to 4 boxes`),a.forEach((o,s)=>{const c=`${t}.diagram[${i}][${s}]`;ot(o,["text","tone","to"],c),S(o.text,`${c}.text`),ee(o.tone,l=>ki.includes(l)?l:d(`${c}.tone takes ${ki.join(", ")}`)),ee(o.to,l=>Array.isArray(l)&&i+1<n.length&&l.every(u=>Number.isInteger(u)&&u>=0&&u<n[i+1].length)?l:d(`${c}.to must list boxes of the next row by index`))})}),(!Array.isArray(e.practice)||!e.practice.length)&&d(`${t}.practice must be a non-empty array of lines`),e.practice.forEach((a,i)=>S(a,`${t}.practice[${i}]`))}r(rr,"checkDiagram");function cr(e,t){(!Array.isArray(e)||!e.length)&&d(`${t}.options must be a non-empty array`);const n=new Set;e.forEach((a,i)=>{const o=`${t}.options[${i}]`;ot(a,["id","label","recommended","detail","diagram","practice"],o),rr(a,o),n.has(S(a.id,`${o}.id`))&&d(`${t} has two options with id "${a.id}"`),n.add(a.id),S(a.label,`${o}.label`).startsWith(`${a.id}. `)&&d(`${o}.label starts with "${a.id}. ", but the page adds the option letter itself`),ee(a.recommended,s=>Ht(s,`${o}.recommended`)),ee(a.detail,s=>typeof s=="string"?s:d(`${o}.detail must be text`))}),e.filter(a=>a.recommended).length>1&&d(`${t} recommends more than one option`)}r(cr,"checkOptions");function lr(e,t,n){ot(e,["option","card","answer","reason"],n),t.some(a=>a.id===S(e.option,`${n}.option`))||d(`${n}.option names no option "${e.option}"`),S(e.card,`${n}.card`),S(e.answer,`${n}.answer`),ee(e.reason,a=>S(a,`${n}.reason`))}r(lr,"checkSuggested");const dt=r(e=>g.join(e,"data","prototypes.json"),"prototypesFile"),Zn=r((e,t,n)=>g.join(e,"public","prototypes",t,`${n}.js`),"takeFile");async function Pt(e){const t=e?(await $(dt(e),{})).prototypes:null;return Array.isArray(t)?t:[]}r(Pt,"readPrototypes");const dr=r(e=>typeof e=="string"&&/^[a-z0-9-]+$/.test(e)?e:d(`a prototype topic uses only a-z, 0-9 and "-", not "${e}"`),"prototypeTopic");function ur(e){const t=/^([^:]*):(.*)$/s.exec(e);(!t||!/^[A-Z]$/.test(t[1]))&&d(`--take takes KEY:"Label" with KEY one capital letter, not "${e}"`);const n=S(t[2],`--take ${t[1]}'s label`);return/^[A-Z]\.\s/.test(n)&&d(`--take ${t[1]}'s label starts with "${n.slice(0,3)}"; the take pill shows the label alone, so drop the letter`),{key:t[1],label:n}}r(ur,"prototypeTake");function fr(e){const t=/^([^:]*):(.*)$/s.exec(e);return(!t||!/^[a-z0-9][a-z0-9-]*$/.test(t[1]))&&d(`--state takes KEY:"Label" with KEY in a-z, 0-9 and "-", not "${e}"`),{key:t[1],label:S(t[2],`--state ${t[1]}'s label`)}}r(fr,"prototypeState");const bi=r(e=>e.find((t,n)=>e.findIndex(a=>a.key===t.key)!==n),"twiceIn"),Ne=r(e=>/^prototype-(.+)\.html$/.exec(g.posix.basename(String(e||"").split(/[?#]/)[0]))?.[1],"pageTopic");async function Ul(e,{topic:t,title:n,card:a,takes:i=[],served:o,states:s=[]}){D(e),dr(t),S(n,"--title"),i.length||d('prototype add needs a --take KEY:"Label" for each take');const c=i.map(ur),l=bi(c);l&&d(`--take ${l.key} is given twice`),o!==void 0&&!/^\/\S*$/.test(o)&&d(`--served takes the page's path on the served site, starting with "/", not "${o}"`),s.length&&o===void 0&&d("--state goes with --served: only a served round re-renders its states in place");const u=s.map(fr),p=bi(u);p&&d(`--state ${p.key} is given twice`),a!==void 0&&await x(e,a);const w=await Pt(e);w.some(m=>m.topic===t)&&d(`prototype ${t} is already recorded; run prototype rm ${t} first, or pick another topic`),await j.stat(g.join(e,"public",`prototype-${t}.html`)).then(()=>!0,()=>!1)&&d(`public/prototype-${t}.html is a hand-written page that questions may link; pick another topic`);const f={topic:t,title:n.trim(),...a===void 0?{}:{card:a},...o===void 0?{}:{served:o},takes:c,...u.length?{states:u}:{},at:new Date().toISOString()};await y(dt(e),{prototypes:[...w,f]});const h=`page prototype-${t}.html`;return o!==void 0?{file:dt(e),lines:[h,`served ${o} from the base prototype worktree (board.mjs prototype base)`,...u.length?[`states ${u.map(m=>m.key).join(", ")}`]:[]]}:{file:dt(e),lines:[h,...c.map(m=>`take ${m.key} ${Zn(e,t,m.key)}`)]}}r(Ul,"addPrototype");async function Hl(e){D(e);const t=await Pt(e);return{lines:t.length?t.map(n=>[n.topic,n.title,n.takes.map(a=>`${a.key}: ${a.label}`).join(", "),n.card,n.served&&`served ${n.served}`,n.states&&`states ${n.states.map(a=>a.key).join(", ")}`].filter(Boolean).join(" \xB7 ")):["no prototypes recorded"]}}r(Hl,"listPrototypes");async function Jl(e){const t=(await Pt(e)).filter(a=>a.served).map(a=>a.topic);if(!t.length)return[];const n=await $(E(e),{items:[]});return t.filter(a=>(n.items||[]).some(i=>!i.resolved&&Ne(i.url)===a))}r(Jl,"servedRoundsOpen");async function zl(e,t){D(e);const n=await Pt(e);n.some(o=>o.topic===t)||d(`no prototype "${t}" is recorded`);const i=((await $(E(e),{items:[]})).items||[]).filter(o=>!o.resolved&&Ne(o.url)===t).map(o=>o.id);return i.length&&d(`prototype ${t} backs open question ${i.join(", ")}; resolve ${i.length===1?"it":"them"} first`),await y(dt(e),{prototypes:n.filter(o=>o.topic!==t)}),dt(e)}r(zl,"removePrototype");async function wr(e,t,n){const a=t.url?.split(/[?#]/)[0];if(!a||!g.posix.basename(a).startsWith("prototype-"))return;const i=g.posix.basename(a),o=t.url.split("#")[0].split("?").slice(1).join("?"),s=`${n}.url`;new URLSearchParams(o).get("q")!==t.id&&d(`${s} must be ${i}?q=${t.id} so the pill can pick`);const c=Ne(a),l=(await Pt(e)).find(f=>f.topic===c);l||d(`${s} names ${i}, which is not a recorded prototype; record it with board.mjs prototype add ${c} --title "\u2026" --take A:"\u2026", then write its take files`);const u=l.takes.map(f=>f.key),p=t.options.map(f=>f.id),w=p.map(f=>u.indexOf(f));if(w.some((f,h)=>f<0||h>0&&f<w[h-1])&&d(`${n}.options ids ${p.join(", ")} must be a non-empty subset of ${i}'s takes, in take order: ${u.join(", ")}`),!l.served)for(const f of u)await j.stat(Zn(e,c,f)).then(h=>h.isFile(),()=>!1)||d(`${s} take ${f} has no file yet; write ${Zn(e,c,f)}`)}r(wr,"checkPrototype");async function Kl(e,t,n=async()=>{}){D(e);const a=Array.isArray(t)?t:[t];a.length||d("the question file is empty");const i=await $(E(e),{topics:[],items:[]}),o=i.items||[],s=await $(ye(e),{}),c=new Set([...o,...Object.values(s).flat()].map(w=>w.id)),l=new Set((i.topics||[]).map(w=>w.id));for(const[w,f]of a.entries()){const h=`question ${f?.id??w+1}`;if(ot(f,["id","topic","source","question","context","url","urgent","options","round_of","reask_of","ask","suggested","prototype_gate","ticket_gate"],h),c.has(Fe(f.id,`${h}.id`))&&d(`question id "${f.id}" is already used`),c.add(f.id),S(f.topic,`${h}.topic`),f.topic.startsWith("item:ask:")){const m=await ze(e,await Dt(e,f.topic.slice(9),`${h}.topic`));d(`${h}.topic: an ask's questions go on its card's topic${m?`, item:${m.key}`:""}`)}else f.topic.startsWith("item:")?await x(e,f.topic.slice(5)):f.topic.startsWith("wave:")?await pt(e,f.topic.slice(5)):f.topic.startsWith("file:")?await Xr(e,f.topic.slice(5)):l.has(f.topic)||d(`topic "${f.topic}" is not declared; add it with: topic add ${f.topic} --title <t>`);S(f.question,`${h}.question`),f.question.length>Ba&&d(`${h}.question runs to ${f.question.length} characters, past ${Ba}; keep the question to one line and move the detail into context or the option details, which take markdown`);for(const m of["source","context"])ee(f[m],k=>S(k,`${h}.${m}`));ee(f.url,m=>En(m,`${h}.url`)),ee(f.urgent,m=>Ht(m,`${h}.urgent`)),cr(f.options,h),ee(f.prototype_gate,m=>Si(m,f,`${h}.prototype_gate`)),f.ticket_gate!==void 0&&Si(f.ticket_gate,f,`${h}.ticket_gate`)&&await mr(e,f,h),ee(f.suggested,m=>lr(m,f.options,`${h}.suggested`)),await wr(e,f,h),f.ask!==void 0&&await mc(e,f,h),ee(f.round_of,m=>{const k=o.find(_=>_.id===m);k||d(`${h}.round_of names no question "${m}" in owner.json`),k.topic!==f.topic&&d(`${h}.round_of names ${m} on topic ${k.topic}; a round stays on its question's topic, ${f.topic}`),Ne(f.url)||d(`${h}.round_of needs a url on a recorded prototype, prototype-<topic>.html?q=${f.id}`)}),ee(f.reask_of,m=>{const k=o.find(_=>_.id===m);k||d(`${h}.reask_of names no question "${m}" in owner.json`),k.topic!==f.topic&&d(`${h}.reask_of names ${m} on topic ${k.topic}; a re-ask stays on its question's topic, ${f.topic}`),k.resolved||d(`${h}.reask_of names ${m}, which is not resolved; only a resolved question is asked again`)})}for(const w of new Set(a.map(f=>Ne(f.url)).filter(Boolean)))await n(e,w);const u=[],p=[];for(const w of a){const f=w.topic.startsWith("item:")&&!w.topic.startsWith("item:ask:")?w.topic.slice(5):null,h=f&&await yi(e,f);h&&((s[f]||=[]).push(w),p.push(w),u.push(`staged: ${w.id} waits for ${f}'s ${h} to finish; the card's staged questions then publish together`))}return p.length&&await y(ye(e),s),p.length===a.length?{file:ye(e),lines:u,staged:p.length}:_i(e,i,o,a.filter(w=>!p.includes(w)),u)}r(Kl,"addQuestions");async function yi(e,t){const{source:n}=await x(e,t);for(const a of await G(n.dir,F(t).id)){const i=await $(a,null);if(i?.started&&!i.done&&qe(i)&&i.kind!==me)return i.kind}return null}r(yi,"runningPlanner");async function ut(e,t,{screen:n=!1}={}){if(!e||await yi(e,t))return;const a=await $(ye(e),{});if(!a[t])return;const i=await $(it(e),{});if(n){i[t]||await y(it(e),{...i,[t]:new Date().toISOString()});return}const{[t]:o,...s}=a,c=await $(E(e),{topics:[],items:[]});await _i(e,c,c.items||[],o,[]),await y(ye(e),s),i[t]&&await y(it(e),Yn(i,t))}r(ut,"publishStaged");const Yn=r((e,t)=>Object.fromEntries(Object.entries(e).filter(([n])=>n!==t)),"withoutKey");async function xi(e){const t=await $(it(e),{}),n=await $(ye(e),{});return Object.fromEntries(Object.entries(t).filter(([a])=>n[a]).map(([a,i])=>[a,{since:i,ids:n[a].map(o=>o.id)}]))}r(xi,"readScreening");async function Ql(e,t,n){D(e);const a=S(n,"--note"),i=await $(ye(e),{}),o=await $(it(e),{}),s=Object.keys(i).find(w=>i[w].some(f=>f.id===t));if(!s)return pr(e,t,a);o[s]||d(`${t} waits for ${s}'s planner to finish`);const c=i[s].find(w=>w.id===t);c.prototype_gate&&d(`${t} is the card's prototype question, which is the owner's; question publish ${s} passes it on`),c.ticket_gate&&d(`${t} is the card's ticket question, which is the owner's; question publish ${s} passes it on`);const l=new Date().toISOString(),u=await $(E(e),{topics:[],items:[]});await y(E(e),{...u,topics:u.topics||[],items:[...u.items||[],{...c,asked_at:l,resolved:`Settled by the orchestrator: ${a}`,resolved_at:l}]});const p=i[s].filter(w=>w.id!==t);return await y(ye(e),p.length?{...i,[s]:p}:Yn(i,s)),p.length||await y(it(e),Yn(o,s)),await Re(e,s,`Answers (orchestrator, ${Qe()})`,`- ${t} (${c.question}): settled by the orchestrator. "${a}"`),E(e)}r(Ql,"settleQuestion");async function pr(e,t,n){const a=await $(E(e),{topics:[],items:[]}),i=(a.items||[]).find(c=>c.id===t&&c.topic?.startsWith("item:"));i||d(`no staged question "${t}"; question settle takes a question a finished grill left for you to screen, or a card's question while it waits on your re-check`);const o=i.topic.slice(5);(await x(e,o)).item.recheck_at||d(`${o} waits on no re-check, so its question ${t} stays answered as it is`);const s=new Date().toISOString();return await y(E(e),{...a,items:a.items.map(c=>c===i?{...c,resolved:`Settled by the orchestrator: ${n}`,resolved_at:s}:c)}),await Re(e,o,`Answers (orchestrator, ${Qe()})`,`- ${t} (${i.question}): settled by the orchestrator. "${n}"`),E(e)}r(pr,"settleStale");async function Gl(e,t){D(e);const n=(await xi(e))[t]?.ids||d(`${t} has no questions waiting on you to screen`);return await ut(e,t),n}r(Gl,"publishScreened");async function Vl(e,t=new Date){const n=Object.entries(await xi(e)).filter(([,a])=>t-Date.parse(a.since)>=Ts).map(([a])=>a);for(const a of n)await ut(e,a),await W(e,a,"screen-timeout");return n}r(Vl,"publishUnscreened");async function _i(e,t,n,a,i){const{answers:o,requests:s,reopens:c}=await ft(e),l=new Date().toISOString(),u=[],p=[];for(const f of a.filter(h=>h.round_of))f.round=jn(n.find(h=>h.id===f.round_of))+1,ve(t,[f.round_of],`Followed by prototype round ${f.round}`,l),p.push(f.round_of);for(const f of a.filter(h=>h.reask_of))ve(t,[f.reask_of],`Asked again as ${f.id}`,l),p.push(f.reask_of);for(const f of a){const h=Ne(f.url),m=n.filter(_=>_.topic===f.topic).map(_=>Te(_,o,s,[],c)),k=f.topic.startsWith("item:")?Ni(m):[];for(const _ of m)k.includes(_.id)?(ve(t,[_.id],`Followed by ${f.id}`,l),p.push(_.id)):!_.resolved&&h&&Ne(_.url)===h&&(ve(t,[_.id],`Replaced by ${f.id}`,l),u.push(_.id))}const w={...t,topics:t.topics||[],items:[...n,...a.map(f=>({...f,asked_at:l}))]};await y(E(e),w);for(const f of new Set(a.map(h=>Xn(h.topic)).filter(Boolean)))await xr(e,f);return{file:E(e),lines:[...i,...u.map(f=>`replaced: ${f}`),...p.map(f=>`resolved: ${f}`)]}}r(_i,"publishQuestions");function Si(e,t,n){return Ht(e,n),e?((!t.topic.startsWith("item:")||t.topic.startsWith("item:ask:"))&&d(`${n} goes on a card's topic, item:<file>/<id>`),t.options?.map(a=>a.id).join()!=="yes,no"&&d(`${n} takes exactly the options yes and no, in that order`),!0):!1}r(Si,"checkGate");async function mr(e,t,n){const a=t.topic.slice(5),{item:i}=await x(e,a);i.ticket&&d(`${n}.ticket_gate: ${a} already has ticket ${i.ticket}`),await sn(e)||d(`${n}.ticket_gate needs a board with a ticket source; with none every card stays a task`)}r(mr,"checkTicketGate");async function Zl(e,t,n){const a=await $(E(e),{topics:[],items:[]}),i=new Map((a.items||[]).map(l=>[l.id,l]));for(const l of t){const u=i.get(String(l.id));if(!u?.ticket_gate||!["yes","no"].includes(l.choice))continue;ve(a,[u.id],`Ticket: ${l.choice}.${l.choice==="yes"?" The board makes it from the card's title and notes.":""}`),await y(E(e),a);const p=u.topic.slice(5);l.choice==="yes"&&await ji(e,p,"making its ticket",async()=>{await $e(e,p,{newTicket:!0},n),await W(e,p,"ticket-made",{ticket:(await x(e,p)).item.ticket})})}for(const l of t){const u=i.get(String(l.id));if(!u?.prototype_gate||!["yes","no"].includes(l.choice))continue;ve(a,[u.id],`Prototype round: ${l.choice}. The board moves the card on once every question is answered.`),await y(E(e),a);const p=u.topic.slice(5);l.choice==="yes"&&(await x(e,p).catch(()=>null))?.item.phase==="grilling"&&await aa(e,p)&&await W(e,p,"prototype-after")}const o=new Map;for(const l of t){const u=i.get(String(l.id)),p=Xn(u?.topic);p&&o.set(p,[...o.get(p)||[],hr(u,l)])}const s=[],c=[];for(const[l,u]of o)await x(e,l).catch(()=>null)&&await ji(e,l,"writing them into its notes",async()=>{await Re(e,l,`Answers (owner, ${Qe()})`,u.join(`
18
+ `));const p=await vi(e,l);p==="prototyping"&&s.push(l),p==="staging"&&c.push(l)});return{prototype:s,staged:c}}r(Zl,"settleAnswers");async function vi(e,t,{roundAt:n=!1}={}){const{item:a}=await x(e,t),{asked:i}=await fe(e,t);if(i.some(o=>o.state==="open"))return null;if(a.phase==="grilling"&&i.some(o=>o.prototype_gate&&o.answers.at(-1)?.choice==="yes")){if(await $e(e,t,{phase:"prototyping"}),n){const{source:o,itemFile:s,item:c}=await x(e,t);c.round_at=new Date().toISOString(),await y(o.file,s)}return await W(e,t,"prototype-round"),"prototyping"}return await br(e,t)?(await na(e,t),"staging"):null}r(vi,"moveOnAnswered");async function ji(e,t,n,a){try{await a()}catch(i){if(!(i instanceof ue))throw i;await W(e,t,"answers-failed",{what:n,error:i.message})}}r(ji,"followUp");const Xn=r(e=>typeof e=="string"&&e.startsWith("item:")&&!e.startsWith("item:ask:")?e.slice(5):null,"cardOfTopic"),Vt=r(e=>String(e).padStart(2,"0"),"pad2"),Qe=r((e=new Date)=>`${Vt(e.getMonth()+1)}/${Vt(e.getDate())} ${Vt(e.getHours())}:${Vt(e.getMinutes())}`,"noteStamp");function hr(e,t){const n=t.choice===null||t.choice===void 0||t.choice===""?null:(e.options||[]).find(i=>i.id===t.choice)?.label??String(t.choice),a=String(t.note||"").trim();return`- ${e.id} (${e.question}): ${n?`${n}.`:"no option picked."}${a?` Note, verbatim: "${a}"`:""}`}r(hr,"answerLine");const Oi=292,ea=r(e=>String(e).toLowerCase().replace(/[^a-z0-9-]+/g,"-"),"notesBase"),gr=r((e,t,n)=>nt(g.join(e,`.${ea(t)}-notes`),n),"notesLock");function Zt(e,t){let n=`${ea(t)}-notes.md`;for(let a=2;de(g.join(e,n));a++)n=`${ea(t)}-notes-${a}.md`;return n}r(Zt,"freeNotesName");async function Yt(e,t){const n=g.join(g.dirname(e),`.${g.basename(e)}.${process.pid}.tmp`);await j.rm(n,{force:!0}),await j.writeFile(n,t,{mode:Oi}),await j.rename(n,e)}r(Yt,"writeNotesFile");const $r=r(e=>/\n/.test(S(e,"--heading"))?d("--heading is one line, the section's title"):S(e,"--heading"),"notesHeading"),kr=r((e,t,n)=>`${e.replace(/\n*$/,`
19
19
  `)}
20
20
  ## ${t}
21
21
  ${n.replace(/^\n+|\s+$/g,"")}
22
- `,"withSection");async function nt(e,t,n,a){const{source:i,item:{id:o}}=await x(e,t);return tr(i.dir,o,async()=>{const{source:s,itemFile:l,item:c}=await x(e,t);let u;c.plan?(u=await Gt(s.dir,c.plan,{missingOk:!0}),ce(u)||await W(e,t,"notes-missing")):(c.plan=Hn(s.dir,c.id),u=h.join(s.dir,c.plan),await k(s.file,l));const w=ce(u)?await j.readFile(u,"utf8"):`# ${c.title}
23
- `;return await zn(u,ar(w,nr(n),a)),c.plan})}r(nt,"appendNotes");async function li(e){const{tickets:t}=be(await ae(e)),n=[],a=new Map;for(const i of await M(e)){const o=await g(i.file,null);a.set(i.slug,{source:i,itemFile:o||{}});for(const s of o?.items||[])s.plan&&n.push({key:`${i.slug}/${s.id}`,ref:Je(o,s,t),title:s.title,created:s.created||"",archived:!1,dir:i.dir,plan:s.plan})}for(const i of e?await Me(e):[]){if(!i.item?.plan)continue;const o=a.get(i.file);n.push({key:i.key,ref:Je(o?.itemFile||{},i.item,t),title:i.item.title,created:i.item.created||"",archived:!0,dir:o?.source.dir||h.join(e,"data"),plan:i.item.plan})}return n}r(li,"cardsWithNotes");const ci=r(e=>j.realpath(h.resolve(e.dir,e.plan)).catch(()=>null),"realNotes");async function di(e,t,n,a){if(t==="-")return mo(0,"utf8");const i=await j.realpath(t).catch(()=>d(`${n} ${t}: no such file`));for(const o of await li(e))await ci(o)===i&&d(`${n} ${t} is the notes file of ${o.ref} "${o.title}" (${o.key}), and a card's notes are its own; ${a(o)}`);return j.readFile(i,"utf8")}r(di,"refuseCardNotes");const Jn="write a draft of your own outside the board's data folder";async function jc(e,t,{heading:n,file:a,from:i}){let o;if(i!==void 0){i===t&&d(`${t} can't fold its own notes into itself; pass --from <the other card>`);const[c,u]=await Promise.all([x(e,t),x(e,i)]),[w,p]=await Promise.all([c,u].map(({source:f,item:m})=>m.plan?j.realpath(h.resolve(f.dir,m.plan)).catch(()=>null):null));w&&w===p&&d(`${i} and ${t} name one notes file, ${c.item.plan}, from before the board named each card's own; the board splits it as it starts`),o=(await br(e,i)).markdown,n??=`Folded from ${await Q(e,i)} "${u.item.title}"`}else o=await di(e,a,"--file",c=>c.key===t?`${Jn}, holding only the new section`:`${Jn}, or fold that card's notes in with item notes ${t} --from ${c.key}`);o.trim()||d(`${i??a} is empty`);const s=await nt(e,t,n,o),l=await Kt(e,t,"Recorded in the card's notes");return{file:s,heading:n,lines:l}}r(jc,"addNotes");const Oc=r(e=>De(e,async()=>{const t=await li(e),n=new Map;for(const i of t){const o=await ci(i);o&&n.set(o,[...n.get(o)||[],i])}const a=[];for(const[i,o]of n){const[s,...l]=o.sort((c,u)=>c.created<u.created?-1:c.created>u.created?1:c.key<u.key?-1:1);for(const c of l.filter(u=>!u.archived)){const{source:u,itemFile:w,item:p}=await Be(e,N(c.key).file).then(m=>({...m,item:m.itemFile.items.find($=>$.id===N(c.key).id)})),f=p.plan;p.plan=Hn(u.dir,p.id),await zn(h.join(u.dir,p.plan),await j.readFile(i,"utf8")),await k(u.file,w),await W(e,c.key,"notes-shared",{card:s.ref}),a.push(`${c.key}: its own notes, ${p.plan}, copied from ${h.normalize(f)}, which ${s.key} keeps`)}await j.chmod(i,ri)}return a}),"splitSharedNotes");async function ir(e,t){const{source:n,item:a}=await x(e,t);return Ae(a)||Le(a)||a.pushed||(await Promise.all((await H(n.dir,a.id)).map(o=>g(o,null)))).some(o=>o?.started&&!o.done&&o.kind!==pe)||(await de(e,t)).asked.some(o=>o.state==="open")||(await g($e(e),{}))[t]?!1:!await Gn(e,t)}r(ir,"stageable");async function Kn(e,t){const{source:n,itemFile:a,item:i}=await x(e,t);i.phase!=="staging"&&(Object.assign(i,{phase:"staging",staged_at:new Date().toISOString()}),delete i.unfiled,delete i.filed_held,await k(n.file,a),await Ce(e,t,{command:"staged"}))}r(Kn,"stage");const ui=r(({text:e,files:t})=>[String(e||"").trim(),...(Array.isArray(t)?t:[]).map(n=>`Attached: ${n?.path||n?.name||n}`)].filter(Boolean).join(`
24
- `),"messageWords");async function or(e,t,n){const{item:a}=await x(e,t);a.held&&await Fi(e,"card-hold",{key:t,hold:!1});const{owner:i,asked:o}=await de(e,t),s=o.filter(c=>c.state==="open").map(c=>c.id);s.length&&await Jt(e,i,s,"Skipped: you tapped Implement");const l=ui(n);l&&await nt(e,t,`Implement (owner, ${yt()}), verbatim`,l),await Kn(e,t)}r(or,"stageImplement");async function Pc(e,t,n){const a=ui(n);a&&await nt(e,t,`Reply (owner, ${yt()}), verbatim`,a),await Kn(e,t)}r(Pc,"stageReply");async function Ac(e,t,n){const{source:a,itemFile:i,item:o}=await x(e,t);!["ready","staging"].includes(o.phase)||Ae(o)||(o.phase=n==="prototype"?"prototyping":"grilling",delete o.staged_at,await k(a.file,i))}r(Ac,"planAgain");async function sr(e,t){const n=await x(e,t).catch(()=>null);!n||!["ready","staging"].includes(n.item.phase)||Ae(n.item)||(n.item.phase="grilling",delete n.item.staged_at,await k(n.source.file,n.itemFile),await W(e,t,"new-question"))}r(sr,"grillAgain");function fi(e){return e.filter(t=>t.state==="answered").map(t=>t.id)}r(fi,"answeredOnClaude");function Pe(e,t,n,a=new Date().toISOString()){for(const i of e.items||[])t.includes(i.id)&&Object.assign(i,{resolved:n,resolved_at:a})}r(Pe,"setResolved");async function Jt(e,t,n,a){return Pe(t,n,a),await k(L(e),t),L(e)}r(Jt,"markResolved");async function Dc(e,t,n){A(e);const a=await g(L(e),{topics:[],items:[]}),i=(a.items||[]).find(f=>f.id===t);i||d(`no question "${t}" in owner.json`);const{answers:o,requests:s,reopens:l}=await at(e),c=Ne(i,o,s,[],l);if(c.state==="resolved")return L(e);c.state==="requested"&&d(`${t} waits on the prototype the owner asked for; question add with round_of ${t} resolves it`);const u=S(n,"--note");Oe(i.url)&&rr(a,i,o);const w=await Jt(e,a,[t],u);await hi(e,i.topic);const p=Wn(i.topic);return p&&(await x(e,p).catch(()=>null))?.item.phase==="grilling"&&await si(e,p,{roundAt:!0}),w}r(Dc,"resolveQuestion");async function Fc(e,t,n,a=[]){A(e);const[i,...o]=[...new Set(t)];i||d("question move takes the ids of the questions to merge"),await x(e,n);const s=[n,...a];new Set(s).size!==s.length&&d("question move names a card twice");for(const f of a)await x(e,f);const l=await g(L(e),{topics:[],items:[]}),{answers:c,requests:u,reopens:w}=await at(e);for(const f of[i,...o]){const m=(l.items||[]).find(y=>y.id===f)||d(`no question "${f}" in owner.json`),{state:$}=Ne(m,c,u,[],w);$!=="open"&&d(`${f} is ${$}; question move takes open questions`)}for(const[f,m]of a.entries()){const{item:$}=await x(e,m),y=[...$.deps||[],s[f]].join(",");await he(e,m,{deps:y,relate:n})}const p=await Q(e,n);return Object.assign(l.items.find(f=>f.id===i),{topic:`item:${n}`}),Pe(l,o,`Duplicate of ${p}'s question ${i}`),await k(L(e),l),L(e)}r(Fc,"moveQuestions");async function Rc(e,t){const n=t.filter(({choice:i,note:o})=>!i&&String(o||"").trim()).map(i=>i.id),a=n.length?await g(L(e),{topics:[],items:[]}):null;a?.items?.some(i=>n.includes(i.id))&&(Pe(a,n,"Answered with a note"),await k(L(e),a))}r(Rc,"resolveNoteAnswers");function rr(e,t,n){const a=gn(t),i=e.items.filter(o=>o.topic===t.topic&&gn(o)===a).map(o=>Ne(o,n));So(i,a)||d(`${t.id} is in prototype round ${a}, which no pick has settled yet; a pick settles it`)}r(rr,"roundSettled");async function at(e){const t=await K(h.join(e,"data","events.jsonl"));return{answers:await Promise.all(t.filter(a=>a.kind==="owner-answer").map(async a=>{const i=await Promise.all(["html","json"].map(o=>j.stat(h.join(e,"data","replies",`${a.id}.${o}`)).then(s=>s.isFile(),()=>!1)));return{...a,reply:a.reply||i.some(Boolean)}})),requests:t.filter(a=>a.kind==="prototype-request"),reopens:t.filter(a=>a.kind===yo)}}r(at,"ownerEvents");async function Nc(e,t){const{asked:n}=await lr(e),a=new Map(n.map(i=>[i.id,i.state]));return t.filter(i=>!a.has(String(i.id))||["open","requested"].includes(a.get(String(i.id))))}r(Nc,"unrecorded");async function lr(e){const t=await g(L(e),{topics:[],items:[]}),{answers:n,requests:a,reopens:i}=await at(e);return{owner:t,asked:(t.items||[]).map(o=>Ne(o,n,a,[],i))}}r(lr,"topicQuestionsAll");async function pi(e,t){const n=await g(L(e),{topics:[],items:[]}),{answers:a,requests:i,reopens:o}=await at(e),s=(n.items||[]).filter(l=>l.topic===t).map(l=>Ne(l,a,i,[],o));return{owner:n,asked:s}}r(pi,"topicQuestions");const de=r((e,t)=>pi(e,`item:${t}`),"cardQuestions"),Kt=r((e,t,n)=>wi(e,`item:${t}`,n),"resolveAnswered");async function wi(e,t,n){if(!e)return[];const{owner:a,asked:i}=await pi(e,t),o=fi(i);return o.length&&await Jt(e,a,o,n),await hi(e,t),o.map(s=>`resolved: ${s}`)}r(wi,"resolveAnsweredOn");const Qn=r(async(e,t)=>!!e&&(await de(e,t)).asked.some(n=>n.state==="open"),"hasOpenQuestion");function mi(e,t,n){e.next=S(t,"--next"),e.next_at=new Date().toISOString(),n?e.next_on_questions=!0:delete e.next_on_questions}r(mi,"setNext");async function hi(e,t){const n=t.startsWith("item:")&&!t.startsWith("item:ask:")?t.slice(5):null;if(!n)return;let a;try{a=await x(e,n)}catch(l){if(l instanceof re)return;throw l}const{source:i,itemFile:o,item:s}=a;s.next_on_questions&&((await de(e,n)).asked.some(l=>l.state!=="resolved")||(delete s.next,delete s.next_at,delete s.next_on_questions,await k(i.file,o)))}r(hi,"clearWaitedNext");async function cr(e,t){const{source:n,itemFile:a,item:i}=await x(e,t);i.next===void 0&&i.next_on_questions===void 0||(delete i.next,delete i.next_at,delete i.next_on_questions,await k(n.file,a))}r(cr,"clearNext");async function gi(e,t,n,a){if(!e)return async()=>[];const{owner:i,asked:o}=await de(e,t),s=o.filter(c=>c.state==="open").map(c=>c.id);s.length&&!a&&d(`${n}: ${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 l=o.filter(c=>c.state!=="resolved").map(c=>c.id);return async()=>(l.length&&await Jt(e,i,l,"Closed with the card"),l.map(c=>`resolved: ${c}`))}r(gi,"closeQuestions");async function Ec(e,t,n,a,i){await x(e,t),Fn(n),X(a,o=>S(o,"--owner-step")),X(i,o=>Ri(o)),await gi(A(e),t,"land",!1)}r(Ec,"checkClose");async function Gn(e,t){const n=await g(L(e),{items:[]}),{answers:a,requests:i,reopens:o}=await at(e);return bo((n.items||[]).map(s=>Ne(s,a,i,[],o)),t)}r(Gn,"unpickedPrototype");const dr=r(e=>e.length>120?`${e.slice(0,119)}\u2026`:e,"clip"),ur={ask:"text","ask-edited":"text","item-message":"text","owner-answer":"note"};async function $i(e,t,n){const a=S(t,n).replace(/\s+/g," ");return(await K(h.join(e,"data","events.jsonl"))).map(o=>String(o.data?.[ur[o.kind]]??"").replace(/\s+/g," ").toLowerCase()).some(o=>o.includes(a.toLowerCase()))||d(`${n} must quote the owner's words in an ask, card message or answer note on this board`),a}r($i,"ownerQuote");async function Ic(e,t,n){return A(e),n===void 0&&d(`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 $i(e,n,"--asked")}"`}r(Ic,"askedGate");async function it(e,t,n="--from-ask"){return ve(t,n),(await K(h.join(A(e),"data","events.jsonl"))).some(i=>i.id===t&&i.kind==="ask")?t:d(`no ask "${t}" in this site's data/events.jsonl`)}r(it,"checkAsk");function Zn(e,t,n=new Date().toISOString(),a=ki(e,t)){if(!He[t])throw new Error(`no lane "${t}"`);const i=e.lane;return bi(e,t,a),e.lane=t,e.lane_at=n,t==="done"?(e.closed_at=n,delete e.reopened_at):i==="done"&&(e.reopened_at=n),i}r(Zn,"placeIn");function ki(e,t,n=!1){return t==="todo"?Ae(e)?"ready":e.phase??null:t==="progress"?"reading":t==="done"?n||Se(e).some(a=>a.merged_at)?"merged":"closed":null}r(ki,"movedPhase");function bi(e,t,n){if(n!==null&&!wn[t].includes(n))throw new Error(`no ${He[t]} phase "${n}"`);n===null?delete e.phase:e.phase=n}r(bi,"setPhase");async function Lc(e,t,n,a,i,o){const{source:s,itemFile:l,item:c}=await x(e,t);if(o&&((c.lane??null)!==o.lane||(c.phase??null)!==o.phase)||c.lane===n&&(i===void 0||(c.phase??null)===i))return null;if(c.lane===n)return bi(c,n,i),await k(s.file,l),null;const u=new Date().toISOString(),w=Zn(c,n,u,i);if(await k(s.file,l),w===void 0)return null;const p={ts:u,who:"claude",kind:ka,text:`Moved to ${He[n]}: ${S(a,"why")}`};return await me(Y(e,t),p),p.text}r(Lc,"moveCard");const G=r(e=>e?.lane==="done"||!!e?.reopened_at,"closed"),Ae=r(e=>!!e?.lane&&e.lane!=="todo","leftTodo"),Bc=r(async(e,t)=>G((await x(e,t)).item),"isFinished"),yi=["ready","grilling","prototyping"];function xi(e,t){t!==void 0&&d(`--state is now --phase: pass --phase ${yi.includes(t)?t:"ready, grilling or prototyping"}`),e==="staging"&&d("--phase staging is set by the board, on an owner action; pass ready, grilling or prototyping"),e!==void 0&&!yi.includes(e)&&d("--phase takes ready, grilling or prototyping")}r(xi,"checkPhase");const fr="a card goes ready only from staging, which the board sets on the owner's Send, Implement or Reply";async function _i(e,t){return(await K(h.join(A(e),"data","events.jsonl"))).some(a=>a.kind==="ask"&&a.id===t&&a.data?.quick===!0||a.kind==="item-message"&&a.data?.key===`ask:${t}`&&a.data?.intent==="build")}r(_i,"quickAsk");const pr=/^mark (?:it |this |the card )?ready\b/i;function wr(e,t,n){const a=[].concat(t).map(s=>Sn(s)||d(`--pr takes a PR number or owner/repo#<n>, not "${s}"`)),i=r((s,l)=>s.number===l.number&&(s.repo||n||null)===(l.repo||n||null),"same"),o=Se(e);for(const s of a)o.some(l=>i(l,s))||o.push(s);delete e.pr,e.prs=o}r(wr,"addPRs");const U=r((e,t)=>String(t).includes("/")?String(t):`${e}/${t}`,"depKey");async function ot(e,t,n){const a=(n.deps||[]).map(o=>U(t,o)),i=await Promise.all(a.map(o=>x(e,o).then(({item:s})=>s,()=>null)));return a.filter((o,s)=>i[s]&&!G(i[s]))}r(ot,"unfinishedDeps");async function mr(e,t,n){const a=await Promise.all((await ot(e,N(t).file,n)).map(i=>Q(e,i)));return n.blocked_until?[...a,n.blocked_until]:a}r(mr,"blockerNames");async function Qt(e,t,n){n??=(await x(e,t)).item;const a=await Promise.all((await ot(e,N(t).file,n)).map(i=>Q(e,i)));return[a.length&&`by ${a.join(", ")}`,n.blocked_until&&`until ${n.blocked_until}`].filter(Boolean).join(" and ")}r(Qt,"blockWords");const hr=r((e,t)=>!Le(e)&&!e.pushed&&!e.merge_ready&&!G(e)&&(!!mn(t)||t.some(n=>n?.started&&!n.done&&ze(n))),"inProgress");async function gr(e,t){const n=[];for(const a of await M(e)){const i=await g(a.file,null);for(const o of Array.isArray(i?.items)?i.items:[])G(o)||o.blocked_until||!(o.deps||[]).some(s=>U(a.slug,s)===t)||(await ot(e,a.slug,o)).length||n.push(`${a.slug}/${o.id}`)}return n}r(gr,"unblockedBy");async function Si(e,t,n){const{source:a,itemFile:i,item:o}=await x(e,t);Ae(o)&&(o.unblocked_at=n,await k(a.file,i))}r(Si,"markUnblocked");async function vi(e,t,n,a){const i=new Set(a.match(/#?[\w-]+(?:\.[\w-]+)*(?:\/[\w-]+(?:\.[\w-]+)*)*/g)||[]),o=new Set((n.deps||[]).map(s=>U(N(t).file,s)));for(const s of await M(e)){const l=await g(s.file,null);for(const c of l?.items||[]){const u=`${s.slug}/${c.id}`;if(u===t||o.has(u)||G(c))continue;[c.id,Je(l,c),c.ticket].filter(Boolean).flatMap(p=>[p,`${s.slug}/${p}`]).some(p=>i.has(p))&&d(`--next names unfinished card ${u}; add it with --deps`)}}}r(vi,"checkNextDeps");const ji=r(e=>`item notes ${e} --heading "<heading>" --file <draft.md>`,"NOTES_COMMAND");function $r(e,t){t.size||d(`${e} has no size; a builder starts from it, so pass --size small or large with --phase ready`),t.plan||d(`${e} has no notes file; a builder starts from it, so add its notes with ${ji(e)} before --phase ready`)}r($r,"checkSizeAndNotes");async function kr(e,t,n,a){$r(t,a);const i=await j.readFile(await Gt(n,a.plan),"utf8"),o=(await de(e,t)).asked.filter(s=>s.answers.length&&!i.includes(s.id)&&!(s.prototype_gate&&!s.answers.at(-1).note)).map(s=>s.id);o.length&&d(`${t}'s notes leave out the answered question${o.length===1?"":"s"} ${o.join(", ")}; record each answer in its notes, naming its id, with ${ji(t)} before it is ready`)}r(kr,"checkNotesComplete");async function Gt(e,t,{missingOk:n=!1}={}){const a=r(s=>d(`a notes file is a .md file inside ${e}, named relative to it: "${t}" ${s}`),"bad");(typeof t!="string"||!t.trim())&&a("is empty"),(h.isAbsolute(t)||t.split(/[\\/]/).includes(".."))&&a("leaves the folder"),h.extname(t).toLowerCase()!==".md"&&a("is not a .md file");const i=await j.realpath(e),o=await j.realpath(h.resolve(e,t)).catch(()=>n?h.resolve(i,t):a("does not exist"));return o.startsWith(i+h.sep)||a("leaves the folder"),o}r(Gt,"planPath");async function br(e,t){const{source:n,itemFile:a,item:i}=await x(e,t);if(i.plan)return{itemFile:a,item:i,markdown:await j.readFile(await Gt(n.dir,i.plan),"utf8")};if(typeof i.notes=="string"&&i.notes.trim())return{itemFile:a,item:i,markdown:i.notes};d(`${t} has no notes`)}r(br,"readNotes");function Oi({install:e,installSha:t,installLabel:n,clearInstall:a}){if(e===void 0)return(t!==void 0||n!==void 0)&&d("--install-sha and --install-label go with --install <url>"),a?null:void 0;a&&d("pass --install or --clear-install, not both");let i;try{i=new URL(String(e).trim())}catch{i=null}(!i||!["https:","itms-services:"].includes(i.protocol))&&d(`--install takes an https:// or itms-services:// URL, not "${e}"`),i.protocol==="itms-services:"&&!(i.searchParams.get("action")==="download-manifest"&&/^https:\/\//.test(i.searchParams.get("url")||""))&&d("--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():d(`--install-sha takes a commit sha of 7 to 40 hex digits, not "${t}"`);return{url:String(e).trim(),...n===void 0?{}:{label:S(n,"--install-label")},built_at:new Date().toISOString(),...o?{sha:o}:{}}}r(Oi,"installOf");async function Tc(e,{install:t,installSha:n}){const a=Oi({install:t,installSha:n});a||d("main set needs --install <url>");const i=h.join(A(e),"data","main.json");return await k(i,{install:a}),{file:i,lines:["main install set"]}}r(Tc,"setMainInstall");const yr=r((e,t)=>e.length?`Merged PR${e.length>1?"s":""} ${Ke(e,t)}.`:"Merged.","mergedLine");function xr(e,t,n,a,i,o){return o?{status:o}:n&&a===void 0?{status:["merged",{words:yr(n,i)}]}:(a===void 0&&e&&d(`--done needs --text "<what was done, or why it closes without landing>", which becomes ${t}'s last thread line`),a===void 0?null:{text:a})}r(xr,"closingLine");function _r(e,t,n){const a=new Date().toISOString(),i=r((o,s)=>o.number===s.number&&(o.repo||n||null)===(s.repo||n||null),"same");e.prs=Se(e).map(o=>{const s=t.find(l=>i(o,l));return s&&!o.merged_at?{...o,merged_at:s.at||a}:o}),delete e.pr}r(_r,"markMerged");async function Pi(e,t,{ticket:n,status:a,clearStatus:i,done:o,merged:s,landed:l,start:c,handBack:u,next:w,clearNext:p,pr:f,pushed:m,mergeReady:$,ghSince:y,fromAsk:_,phase:D,state:P,held:B,unheld:F,pickUpAt:I,deps:v,blockedUntil:E,blockReason:T,parent:q,related:O,relate:z,unrelate:ie,install:ee,installSha:J,installLabel:ue,clearInstall:jt,title:st,size:fe,model:Fe,force:Ot,text:le,closing:Pt,who:on,by:te,command:At,ownerStep:ne,ownerDone:so,check:rt},la){(a!==void 0||i)&&d(`--status${i?" and --clear-status are":" is"} gone: a card's lane is stored and moves itself. Close it with --done --text "<what was done, or why it closes without landing>"`),s&&(o=!0),O!==void 0&&(z!==void 0||ie!==void 0)&&d("pass --related, or --relate and --unrelate, not both"),xi(D,P),Ot&&!o&&d("--force goes with --done"),_!==void 0&&o&&d("--from-ask opens a card; close it in another call"),le!==void 0&&Fn(le),ne!==void 0&&S(ne,"--owner-step");const lt=rt===void 0||rt===""?rt:Ri(rt);le!==void 0&&_===void 0&&!o&&D!=="ready"&&d("--text goes with --from-ask, --done, or --phase ready on a staging card"),_!==void 0&&le===void 0&&d(`--from-ask needs --text "<first line>", the item's first thread line after the ask`),w!==void 0&&p&&d("pass --next or --clear-next, not both"),typeof w=="string"&&!w.trim()&&([w,p]=[void 0,!0]);const ct=Di({held:B,unheld:F,pickUpAt:I}),Dt=Oi({install:ee,installSha:J,installLabel:ue,clearInstall:jt});[o,c,u,w,p,f,m,$,y,_,D,ct,v,E,T,q,O,z,ie,Dt,st,fe,Fe,n,ne,rt].every(R=>R===void 0||R===!1)&&d("nothing to set: pass --done, --next, --clear-next, --pr, --pushed, --gh-since, --from-ask, --phase, --held, --unheld, --pick-up-at, --deps, --blocked-until, --block-reason, --parent, --related, --relate, --unrelate, --install, --clear-install, --title, --size, --model, --ticket or --check");const Z=_===void 0?void 0:await it(e,_);Z&&await Mt(e,Z);const ro=Z!==void 0&&await _i(e,Z),{source:Re,itemFile:Ue,item:b}=await x(e,t);D!==void 0&&Ae(b)&&d(`--phase sets a Todo card's phase; ${t} is ${He[b.lane]}, where the board sets it`),D==="ready"&&!ro&&!["staging","ready"].includes(b.phase)&&d(`${t} reads ${b.phase||"new"}, not staging; ${fr}`),Z&&b.from_ask&&b.from_ask!==Z&&d(`${t} came from ask "${b.from_ask}", so ask "${Z}" can't be its from-ask; to fold it in: item relate-ask ${Z} ${t} --summary "<line>"`),Z&&ct&&D!==void 0&&!b.phase&&d("a card filed held is filed New and takes no --phase; drop --phase, or drop --held to file it in a phase"),Z&&D===void 0&&!b.phase&&!ct&&d("--from-ask files a card, which reads New until it has a phase: pass --phase grilling, prototyping, or ready for a Quick build ask, or --held to file it for later");const ca=G(b);ne!==void 0&&ca&&d(`${t} is already Done, so its ticket closed; an owner step goes on the command that finishes the card: land --owner-step, or builder done before the merge`),ne!==void 0&&(b.owner_step=S(ne,"--owner-step")),so&&delete b.owner_step,lt!==void 0&&!b.owner_step&&d(`--check goes with an owner step, which ${t} doesn't have: pass --owner-step "<the step>" with it on builder done or land`),lt&&(b.owner_check={check:lt,since:b.owner_check?.check===lt?b.owner_check.since:new Date().toISOString()}),(lt===""||!b.owner_step)&&delete b.owner_check;const sn=await Promise.all((await H(Re.dir,b.id)).map(R=>g(R,null))),lo=hn(b,sn);if(st!==void 0&&(b.title=S(st,"--title")),Ai(b,{size:fe,model:Fe}),v!==void 0){const R=await Ni(e,N(t).file,v);R.length?b.deps=R:delete b.deps}const da=E===""?b.blocked_until:void 0;if(E!==void 0&&(E===""?delete b.blocked_until:b.blocked_until=S(E,"--blocked-until")),T&&(!b.deps?.length&&!b.blocked_until&&d("--block-reason goes with a block: --deps or --blocked-until"),b.block_reason=S(T,"--block-reason")),(T===""||!b.deps?.length&&!b.blocked_until)&&delete b.block_reason,q!==void 0){const R=await Ei(e,N(t).file,t,q);R?b.parent=R:delete b.parent}const ua=q!==void 0||O!==void 0||z!==void 0||ie!==void 0?await Vn(e,t):null;let rn=O===void 0?null:await jr(e,t,b,O);z!==void 0&&(b.related=[...new Set([...(b.related||[]).map(R=>U(N(t).file,R)),...await Vt(e,t,z,"--relate")])]),ie!==void 0&&(rn=await Or(e,t,b,await Vt(e,t,ie,"--unrelate"))),ct!==void 0&&Zt(b,ct),c&&b.held&&d(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`);const dt=f!==void 0||m!==void 0||$!==void 0;if((c||o||u||dt)&&vr(b),c){const R=await ot(e,N(t).file,b);R.length&&d(`${t} is blocked by ${R.join(", ")}; start it once ${R.length===1?"that is":"those are"} done`),b.blocked_until&&d(`${t} is blocked until ${b.blocked_until}; start it once that holds and the block is cleared with --blocked-until ""`)}const Ft=c&&e?await Gn(e,t):null;Ft&&d(`${t} has no take picked: the owner's answer to ${Ft.id} picks none${Ft.note?` ("${dr(Ft.note)}")`:""}, so it prototypes again: draw the next round from that note, or grill when the note asks a question, and build once a take is picked`);const co=o?await gi(e,t,"--done",Ot):async()=>[],ut=o?xr(e,t,s,le,oe(e,Ue),Pt):null;if(s&&_r(b,s,oe(e,Ue)),w!==void 0&&(mi(b,w,await Qn(e,t)),await vi(e,t,b,b.next)),p&&(delete b.next,delete b.next_at,delete b.next_on_questions),c&&w===void 0&&b.next_on_questions&&(delete b.next,delete b.next_at,delete b.next_on_questions),dt&&!b.review_since&&(b.review_since=new Date().toISOString()),f!==void 0&&wr(b,f,oe(e,Ue)),m!==void 0){we().find(R=>_e(R.dir,A(e)))?.remote||d("--pushed is for a board whose repo is a plain git remote; on GitHub, open a PR and pass --pr"),Le(b)&&d(`${t} has a PR; its PR says when it merges`);try{zo(m)}catch{d("--pushed takes the name of the branch you pushed")}b.pushed={branch:m,at:new Date().toISOString()},b.branch=m}if($!==void 0&&(b.merge_ready={branch:$,at:new Date().toISOString()},b.branch=$),o&&delete b.merge_ready,y!==void 0&&((typeof y!="string"||!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$/.test(y)||Number.isNaN(Date.parse(y)))&&d("--gh-since takes an ISO-8601 UTC time such as 2026-10-23T11:00:00Z"),b.gh_since=y),Z&&(b.from_ask=Z),D==="ready"&&e){const R=(await de(e,t)).asked.filter(xe=>xe.state==="open").map(xe=>xe.id);R.length&&d(`${t} has ${R.length===1?"an open question":"open questions"} ${R.join(", ")}; it is ready once the owner has answered ${R.length===1?"it":"them"}`),await kr(e,t,Re.dir,b)}const ln=D==="ready"&&b.phase==="staging"&&_===void 0;ln&&le===void 0&&d(`${t} goes ready from staging on your judgment: pass --text "<what you checked it against on the board>", which goes into its notes`),D==="ready"&&!ln&&le!==void 0&&_===void 0&&!o&&d(`${t} reads ${b.phase||"no phase"}, not staging, so there is no judgment for --text to record`);const uo=D==="ready"&&b.phase!=="ready";D!==void 0&&(D!=="ready"&&["staging","ready"].includes(b.phase)&&(b.round_at=new Date().toISOString()),b.phase=D,delete b.staged_at,delete b.unfiled,delete b.filed_held),b.phase==="ready"&&pr.test(b.next??"")&&d(`${t} would read ready with Next "${b.next}", which asks for the phase it is already in; pass --next with what happens next, or --clear-next`),Dt&&(b.install=Dt),Dt===null&&delete b.install,!lo&&!c&&hn(b,sn)&&d(`that leaves ${t} In Progress with nothing building and no Next; pass --next "<what happens next>"`);const cn=(v!==void 0||E)&&!o&&hr(b,sn)?await Qt(e,t,b):"",fa=oe(e,Ue);let dn=null;const un=r((R,xe)=>{b.lane!==R&&Zn(b,R,void 0,ki(b,R,l))!==void 0&&xe&&(dn=`Moved to ${He[R]}: ${xe}`)},"moveTo");if(o?un("done",null):dt&&b.lane!=="done"?un("review",f!==void 0?`PR ${Ke([].concat(f).map(Sn),fa)} opened`:m!==void 0?`${m} pushed for its merge`:"verified, it waits for your Merge"):c&&!G(b)&&un("progress","a build started"),(n!==void 0||Z&&!b.ticket&&!b.linear?.length)&&await Yn(e,t,Ue,b,n,la,Re.dir),await k(Re.file,Ue),dn&&await me(Y(e,t),{ts:b.lane_at,who:"claude",kind:ka,text:dn}),ln&&await nt(e,t,`Ready (orchestrator, ${yt()})`,le),uo&&await Ce(e,t,{command:"readied"}),cn){const R=e&&!await ao(e,t)&&await no(e,t,{cause:"blocked",words:`blocked ${cn}`});await W(e,t,R?"blocked-pausing":"blocked-stays",{blocked:cn})}rn&&await rn(),ua&&await Li(e,t,ua,await Vn(e,t));const ye=await co();if(D==="ready"&&e&&ye.push(...await Kt(e,t,"Recorded in the card's notes")),c&&ye.push(...await Kt(e,t,"Acted on: build started")),Z&&ye.push(...(await ht(e,t,{text:le})).lines),ut&&e){const R=At?await Ce(e,t,{command:At,text:ut.text,who:on,by:te}):ut.status?await W(e,t,...ut.status):await ht(e,t,{text:ut.text});ye.push(...R.lines)}const pa=b.owner_step&&o?null:To({start:c,done:o,handover:dt}),wa=pa&&await Co(await Bi(e),b,pa,{...la,repo:fa});wa&&ye.push(wa),(dt||o||u)&&(await oo(Re.dir,b.id,o,u?{handedBack:new Date().toISOString()}:{endHandBack:!0}),await tt(e,t));const fn=Z?await je(e):{};if(V(fn,Z)!==void 0&&(delete fn[Z],await k(ke(e),{links:fn})),da&&!G(b)&&!(await ot(e,N(t).file,b)).length){const{line:R}=await W(e,t,"unblocked",{lifted:da});await Si(e,t,R.ts),await ge({dir:e},"card-unblocked",{key:t}),ye.unshift(`unblocked: ${t}`)}if(!o||ca)return{file:Re.file,lines:ye};const ma=await gr(e,t),fo=await Q(e,t);for(const R of ma){const{line:xe}=await W(e,R,"unblocked-done",{card:fo});await Si(e,R,xe.ts),await ge({dir:e},"card-unblocked",{key:R})}return{file:Re.file,lines:[...ma.map(R=>`unblocked: ${R}`),...ye]}}r(Pi,"changeItem");function Ai(e,{size:t,model:n}){for(const[a,i,o]of[["size",t,["small","large"]],["model",n,["opus","sonnet"]]])i!==void 0&&(i===""?delete e[a]:e[a]=o.includes(i)?i:d(`--${a} takes ${o.join(" or ")}, or "" to clear it`))}r(Ai,"setBuildChoice");function Di({held:e,unheld:t,pickUpAt:n}){return[e,t,n!==void 0].filter(Boolean).length>1&&d("pass one of --held, --unheld and --pick-up-at"),n!==void 0?n===""?null:{until:Sr(n)}:e?{until:null}:t?null:void 0}r(Di,"holdOf");function Sr(e){const t=typeof e=="string"&&Lo.test(e)?Date.parse(e):NaN;return Number.isNaN(t)&&d('--pick-up-at takes an ISO time such as 2026-11-04T09:00, the host\u2019s local time unless it names an offset, or "" to resume the card'),t<=Date.now()&&d(`--pick-up-at ${e} has passed; pass a later time, or --unheld to resume the card now`),new Date(t).toISOString()}r(Sr,"pickUpTime");function vr(e){delete e.held,delete e.pick_up_at}r(vr,"clearHold");function Zt(e,t){t?e.held=!0:delete e.held,t?.until?e.pick_up_at=t.until:delete e.pick_up_at,e.held_at=new Date().toISOString()}r(Zt,"setHold");async function Cc(e,t,n,{announce:a=!0}={}){const{source:i,itemFile:o,item:s}=await x(e,t);if(a){const l=new Date(n).toLocaleString("en-US",{weekday:"short",month:"numeric",day:"numeric",hour:"numeric",minute:"2-digit"});await W(e,t,"hold-ended",{at:l}),!s.blocked_until&&!(await ot(e,N(t).file,s)).length&&await ge({dir:e},"card-unblocked",{key:t,until:n})}Zt(s,null),await k(i.file,o)}r(Cc,"pickUp");async function Fi(e,t,n){const a=String(n?.key||""),{file:i,id:o}=N(a),{source:s,itemFile:l}=await Be(e,i),c=n.shared_by?n.shared_by.name||n.shared_by.login:void 0,u={text:Nt.done,who:"love",by:c,command:"done"},w=l.items.find($=>$.id===o)||d(`item file "${i}" has no item "${o}"`);if(!(t==="card-done"&&!!w.owner_step)&&w.lane==="done")return null;if(t==="card-done")return he(e,a,{done:!0,force:!0,ownerDone:!0,...u});const f=n.hold?typeof n.until=="string"?new Date(n.until).toISOString():null:void 0;Zt(w,n.hold?{until:f}:null),await k(s.file,l),n.hold&&(await ao(e,a)||await no(e,a,{cause:"held",words:"held"}),await oo(s.dir,o,!1,{held:!0}),await tt(e,a));const m=f&&new Date(f).toLocaleString("en-US",{weekday:"short",month:"numeric",day:"numeric",hour:"numeric",minute:"2-digit"});return Ce(e,a,n.hold?{text:m?`${Nt.hold} until ${m}`:Nt.hold,who:"love",by:c,command:"hold"}:{who:"love",by:c,command:"resume"})}r(Fi,"recordOwnerTap");function Ri(e){try{return cs(ls(e))}catch(t){return d(t.message)}}r(Ri,"checkSpec");async function qc(e,t,n,a){const{item:i}=await x(e,t);return!i.owner_step||i.owner_check?.check!==n?null:he(e,t,{done:!0,force:!0,ownerDone:!0,closing:["check-passed",{found:a}]})}r(qc,"passOwnerCheck");async function Mc(e,t,n,a){const{source:i,itemFile:o,item:s}=await x(e,t);return!s.owner_step||s.owner_check?.check!==n?!1:(s.owner_check.broken=a,await k(i.file,o),await W(e,t,"check-broken",{error:a}),await ge({dir:e},"owner-check-broken",{key:t,check:n,error:a}),!0)}r(Mc,"breakOwnerCheck");async function Ni(e,t,n){const a=[...new Set(String(n).split(",").map(i=>i.trim()).filter(Boolean))];for(const i of a)await x(e,U(t,i));return a}r(Ni,"depList");async function Ei(e,t,n,a){if(!String(a).trim())return null;const i=U(t,String(a).trim());i===n&&d("--parent: a card can't be its own Parent");for(let o=i;o;){const s=o===i?await x(e,o):await x(e,o).catch(c=>{if(c instanceof re)return null;throw c});if(!s)break;const{item:l}=s;l.parent&&U(N(o).file,l.parent)===n&&d(`--parent: ${i} is a child of ${n}, so it can't be its Parent`),o=l.parent?U(N(o).file,l.parent):null}return i}r(Ei,"parentKey");async function Vt(e,t,n,a){const i=t.split("/")[0],o=[...new Set(String(n).split(",").map(s=>s.trim()).filter(Boolean).map(s=>U(i,s)))];o.includes(t)&&d(`${a}: a card can't be related to itself`);for(const s of o)await x(e,s);return o}r(Vt,"relatedKeys");const Ii=r((e,t,n)=>async()=>{for(const a of await M(e)){const i=await g(a.file,null);let o=!1;for(const s of Array.isArray(i?.items)?i.items:[]){const l=`${a.slug}/${s.id}`;l===t||!n(l)||!(s.related||[]).some(c=>U(a.slug,c)===t)||(s.related=s.related.filter(c=>U(a.slug,c)!==t),s.related.length||delete s.related,o=!0)}o&&await k(a.file,i)}},"dropLinksTo");async function Vn(e,t){const n=new Set;let a=null;for(const i of await M(e))for(const o of(await g(i.file,null))?.items||[]){const s=`${i.slug}/${o.id}`,l=(o.related||[]).map(c=>U(i.slug,c));s===t?(l.forEach(c=>n.add(c)),o.parent&&(a=U(i.slug,o.parent))):l.includes(t)&&n.add(s)}return{related:n,parent:a}}r(Vn,"linksOf");async function Li(e,t,n,a){const i=r(async(o,s,l=o,c=o)=>{await Ce(e,t,{command:l,card:s}),await Ce(e,s,{command:c,card:t})},"both");for(const o of a.related)n.related.has(o)||await i("related",o);for(const o of n.related)a.related.has(o)||await i("unrelated",o);a.parent&&a.parent!==n.parent&&await i("followup-of",a.parent,"followup-of","followup")}r(Li,"postLinkLines");async function jr(e,t,n,a){const i=await Vt(e,t,a,"--related");return i.length?n.related=i:delete n.related,Ii(e,t,o=>!i.includes(o))}r(jr,"setRelated");function Or(e,t,n,a){const i=(n.related||[]).filter(o=>!a.includes(U(N(t).file,o)));return i.length?n.related=i:delete n.related,Ii(e,t,o=>a.includes(o))}r(Or,"unrelateCards");const oe=r((e,t)=>e&&we().find(n=>_e(n.dir,e))?.github||t.repo,"boardRepoOf");async function Wc(e,t){const{itemFile:n,item:a}=await x(e,t);Le(a)||d(`${t} has no PR`);const i=Ie(a,oe(e,n));i.length||d(`${t} has no repo`);const o=a.gh_since||"1970-01-01T00:00:00Z";try{const s=be(await ae(e)).github_login||await Xo();return await Promise.all(i.map(async({repo:l,number:c})=>({repo:l,...ja(await va({repo:l,pr:c,since:o}),{pr:c,since:o,me:s})})))}catch(s){d(s.message)}}r(Wc,"prReport");async function Uc(e,t,{replyTo:n,body:a}){const i=n===void 0?"pr comment":"pr reply",o=Sn(t)||d(`${i} takes a PR number or owner/repo#<n>`);n!==void 0&&!/^[1-9]\d*$/.test(n)&&d("pr reply takes the id of the review comment it answers");const s=S(a,"--body").trim();(s.startsWith(wt.trim())||s.includes(_n))&&d(`${i} adds the ${wt.trim()} prefix and the claude-bridge marker itself; pass only your words`);const l=o.repo||oe(A(e),{})||d(`${i} needs a board on GitHub; this board has no repo there`);try{const c=await es({repo:l,pr:o.number,replyTo:n,words:s,login:be(await ae(e)).github_login}),u=await Ka(e,mt({repo:l,number:o.number}),"comment",`Comment on #${o.number}: ${s}`);return{lines:[`posted on PR ${o.repo?t:`#${t}`}: ${c}`,...u.length?[`queued for ${u.join(", ")}'s Slack thread`]:[]]}}catch(c){d(c.message)}}r(Uc,"postPR");const Bi=r(async e=>Xa((await ae(e)).tickets),"boardSource");async function Hc(e,t,{afterApproval:n,confirmed:a,tapped:i}={}){A(e);const{itemFile:o,item:s}=await x(e,t);Le(s)||d(`${t} has no PR`),G(s)&&d(`${t} is done`);const l=await Qt(e,t,s);l&&(i&&await W(e,t,"merge-blocked",{blocked:l}),d(`Not merged: blocked ${l}.`));const c=oe(e,o),u=Ie(s,c);u.length||d(`${t} has no repo`);const w=new Date().toISOString();let p;try{p=await Promise.all(u.map(v=>va({repo:v.repo,pr:v.number,since:w})))}catch(v){d(v.message)}const f=p.map(({view:v})=>v);if(as(f)){const v=u.map((E,T)=>({...E,at:f[T].mergedAt})).filter((E,T)=>f[T].state==="MERGED");return he(e,t,{merged:v,closing:["already-merged",{prs:Ke(v,c),many:v.length>1}]})}const m=u.map((v,E)=>({...v,...p[E]})).filter(({view:v})=>v.state==="OPEN"),$=jn(o,(await ae(e)).reviewers||[]).length>0,y=[];let _=!1,D=!1;for(const v of m){const{view:E,reviews:T}=v,{failing:q,pending:O}=ja(v,{pr:v.number,since:w,me:null}),z=ko({...E,checks:{state:q.length?"fail":O?"pending":"pass",failing:q,pending:O}},{needsApproval:$}),ie=T.filter(J=>J.state==="APPROVED").sort((J,ue)=>String(J.submitted_at).localeCompare(String(ue.submitted_at))).at(-1)?.commit_id;let ee=!!(ie&&E.headRefOid&&ie!==E.headRefOid);ee&&n===void 0&&qr(s,ie,E.headRefOid)&&(ee=!1,D=!0),_||=ee,ee&&n===void 0&&z.push('commits after the approval: pass --after-approval "<why they are trivial>" when they are, else ask the approver to look again'),y.push(...u.length>1?z.map(J=>`${Ke([v],c)} ${J}`):z)}m.length||y.push(u.length>1?"every PR is closed":"PR is closed"),n!==void 0&&!_&&d("--after-approval: no commit came after the approval; drop it");const P=s.manual_steps?.length?a===void 0?null:await $i(e,a,"--confirmed"):void 0;if(a!==void 0&&P===void 0&&d(`--confirmed: ${t} has no manual steps; drop it`),P===null&&y.push(`manual steps: merge only on the owner's word, with --confirmed "<their words>"`),y.length){const v=`Not merged: ${y.join("; ")}.`;i&&await W(e,t,"merge-refused",{why:y.join("; ")}),d(v)}const B=[];for(const v of m){const E=await new Promise(T=>{ha("gh",["pr","merge",String(v.number),"--repo",v.repo,"--squash"],{encoding:"utf8",timeout:12e4},(q,O,z)=>T(q?String(z||q.message).trim().split(`
25
- `)[0]:null))});E&&d(`gh pr merge ${Ke([v],c)} failed: ${E}${B.length?` (merged ${Ke(B,c)} before it)`:""}`),B.push(v)}const F=[n!==void 0&&`After the approval: ${S(n,"--after-approval")}`,D&&`After the approval: only the board's rebase onto ${s.rebased.at(-1).base}.`,P&&`The owner's word on the manual steps: "${P}"`].filter(Boolean),I=await he(e,t,{merged:B});return F.length&&await ht(e,t,{text:F.join(" ")}),I}r(Hc,"mergeCard");async function zc(e,t){return(await x(e,t)).item.merge_ready||null}r(zc,"heldMerge");async function Jc(e,t){const{source:n,itemFile:a,item:i}=await x(e,t);(!i.merge_ready||G(i))&&d(`${t} isn't waiting for its Merge`);const o=await Qt(e,t,i);return o&&d(`${t} is blocked ${o}, so its Merge waits until nothing blocks it`),i.merge_ready.tapped=new Date().toISOString(),await k(n.file,a),i.merge_ready}r(Jc,"tapMerge");async function Kc(e,t){const{source:n,item:a}=await x(e,t);return(await Promise.all((await H(n.dir,a.id)).map(o=>g(o,null)))).filter(o=>o?.worktree?.path).sort((o,s)=>String(s.started).localeCompare(String(o.started)))[0]?.model}r(Kc,"builderModel");async function Yn(e,t,n,a,i,o,s,l){try{const c=await ae(e),u=yn(c.tickets||{source:"internal"}),w=r((m,$)=>m.internal===!0?String($.id).replace(/^S(\d+)$/,`${u.prefix}-$1`):null,"ownId");i===void 0&&u.source==="internal"&&xn(u,w(n,a))&&(i=w(n,a));let p=0;if(u.source==="internal")for(const m of await M(e)){const $=await g(m.file,{});for(const y of $.items||[]){const _=[y.ticket,w($,y)];if(p=Math.max(p,..._.map(D=>xn(u,D)||0)),i!==void 0&&`${m.slug}/${y.id}`!==t&&_.includes(i))throw Object.assign(new re(`${i} is already the ticket of ${m.slug}/${y.id}`),{held:!0})}}l??=i===void 0&&u.source!=="internal"&&a.plan?await j.readFile(await Gt(s,a.plan),"utf8"):a.notes||"";const f=await Bo(u,{ticket:i,title:a.title,body:l,repo:oe(e,n),next:p+1},o);a.ticket=f.ticket,f.created&&u.source!=="internal"?a.ticket_created=!0:delete a.ticket_created}catch(c){if(c instanceof re)throw c;d(c.message)}}r(Yn,"assignTicket");const De=r((e,t)=>pt(h.join(e||Bt(),"tickets"),t,{heartbeat:!0}),"ticketWrite"),he=r((e,t,n,a)=>n.ticket!==void 0||n.fromAsk!==void 0?De(e,()=>Pi(e,t,n,a)):Pi(e,t,n,a),"setItem"),Qc=r((e,t,n,a)=>De(e,()=>Pr(e,t,n,a)),"addItem");async function Pr(e,t,{title:n,notes:a,notesFrom:i,deps:o,ticket:s,pickUpAt:l,held:c,parent:u,size:w,model:p,phase:f,state:m,relate:$,fromAsk:y,text:_,intake:D=!1},P){const{file:B,id:F}=t.includes("/")?N(t):{file:t};F!==void 0&&ve(F,"the item id"),xi(f,m),_!==void 0&&S(_,"--text"),_!==void 0&&y===void 0&&d("--text goes with --from-ask"),y!==void 0&&_===void 0&&d(`--from-ask needs --text "<first line>", the item's first thread line after the ask`);const I=y===void 0?void 0:await it(e,y);I&&await Mt(e,I);const v=Di({held:c,pickUpAt:l});v&&f!==void 0&&d("a card filed held is filed New and takes no --phase; drop --phase, or drop --held to file it in a phase"),I&&f===void 0&&!v&&d("--from-ask files a card, which reads New until it has a phase: pass --phase grilling, prototyping, or ready for a Quick build ask, or --held to file it for later"),f==="ready"&&!(I&&await _i(e,I))&&d(I?`ask "${I}" is not a Quick build ask, so item add files it grilling or prototyping`:"item add files a card grilling or prototyping; ready is for a Quick build ask, filed with --from-ask"),f==="ready"&&!w&&d("a new ready card has no size; a builder starts from it, so pass --size small or large with --phase ready"),f==="ready"&&!(a??"").trim()&&i===void 0&&d("a new ready card has no notes; a builder starts from them, so pass --notes or --notes-from with --phase ready"),D&&e&&f===void 0&&!v&&d("item add files a card on a board: pass --phase grilling or prototyping, or --held to file it for later");const{source:E,itemFile:T}=await Be(e,B);F!==void 0&&T.items.some(J=>J.id===F)&&d(`item file "${B}" already has an item "${F}"`);const q=new Date().toISOString(),O={id:F,title:S(n,"--title"),created:q,lane:"todo",lane_at:q};u!==void 0&&(O.parent=await Ei(e,B,null,u)||d("--parent takes a card, such as <file>/<id>")),a!==void 0&&i!==void 0&&d("pass --notes or --notes-from, not both");const z=i!==void 0?await di(e,i,"--notes-from",()=>`${Jn}, and link that card with --relate`):a===void 0?"":S(a,"--notes");i!==void 0&&!z.trim()&&d(`--notes-from ${i} is empty`);const ie=i!==void 0?z:`# ${O.title}
26
- ${z&&`
27
- ${z}
28
- `}`;Ai(O,{size:w,model:p}),o!==void 0&&(O.deps=await Ni(e,B,o)),v&&Zt(O,v),v&&f===void 0&&(O.filed_held=!0),$!==void 0&&(O.related=await Vt(e,t,$,"--relate")),I&&(O.from_ask=I),f!==void 0&&(O.phase=f),await Yn(e,t,T,O,s,P,E.dir,z),F===void 0&&(O.id=Mo(O.ticket),T.items.some(J=>J.id===O.id)&&d(`item file "${B}" already has an item "${O.id}"; link ${O.ticket} with item add ${B}/<id> --ticket ${O.ticket}`)),O.plan=Hn(E.dir,O.id),await zn(h.join(E.dir,O.plan),ie);const ee=`${B}/${O.id}`;if(T.items.push(O),await k(E.file,T),I){await ht(e,ee,{text:_});const J=await je(e);V(J,I)!==void 0&&(delete J[I],await k(ke(e),{links:J}))}return e&&await Li(e,ee,{related:new Set,parent:null},await Vn(e,ee)),{file:E.file,key:ee,lines:[]}}r(Pr,"createItem");const Gc=r((e,{dryRun:t=!1}={},n)=>De(A(e),()=>Ar(e,t,n)),"backfillTickets");async function Ar(e,t,n){const a=await Bi(e)||d("this board has no ticket source yet; pick one in Board settings first"),i=new Set,o=[];for(const w of await M(e)){const p=await g(w.file,null);if(Array.isArray(p?.items)){o.push({entry:w,itemFile:p});for(const f of p.items)f.ticket&&i.add(f.ticket),p.internal===!0&&a.source==="internal"&&i.add(String(f.id).replace(/^S(\d+)$/,`${a.prefix}-$1`))}}const s=[],l={linked:0,created:0,failed:0},c=r((w,p)=>p.ticket&&!(a.source!=="internal"&&w.internal===!0&&p.ticket===p.id),"ticketed");for(const{entry:w,itemFile:p}of o)for(const f of p.items){if(c(p,f)||G(f))continue;const m=`${w.slug}/${f.id}`,$=[...qo(a,f.title),...(f.linear||[]).filter(y=>xn(a,y))].find(y=>a.source!=="internal"||!i.has(y));if(t){l[$?"linked":"created"]++,s.push(`${m} would ${$?`link ${$}`:"get a new ticket"}`);continue}try{await Yn(e,m,p,f,$,n,w.dir),await k(w.file,p),i.add(f.ticket),l[$?"linked":"created"]++,s.push(`${m} ${$?"linked":"created"} ${f.ticket}`)}catch(y){if(!(y instanceof re))throw y;l.failed++,s.push(`${m} failed: ${y.message}`)}}const u=t?`would link ${l.linked}, create ${l.created}`:`linked ${l.linked}, created ${l.created}, failed ${l.failed}`;return{lines:[...s,`backfill${t?" (dry run)":""}: ${u}`]}}r(Ar,"backfill");const Zc=r(e=>De(e,async()=>{const t=[];for(const n of await M(e)){const a=await g(n.file,null);if(!Array.isArray(a?.items)||!Array.isArray(a.followups))continue;const i=a.followups.find(c=>a.items.some(u=>u.id===c.id));i&&d(`${n.slug}: follow-up ${i.id} has the id of a card; rename one, then restart the board`);const o=[];for(const{id:c,title:u,from:w,filed:p,done:f,...m}of a.followups){const $=f?e&&(await K(Y(e,`${n.slug}/${c}`))).map(y=>y.ts).filter(Boolean).sort().pop()||p:null;o.push({id:c,title:u,...p?{created:p}:{},...w?{parent:U(n.slug,w)}:{},...f?{lane:"done",...$?{lane_at:$,closed_at:$}:{}}:{},...m})}const{followups:s,...l}=a;await k(n.file,{...l,items:[...a.items,...o]}),t.push(`${n.slug}: ${o.length} follow-ups moved to cards (${o.filter(c=>c.lane==="done").length} done)`)}return t}),"migrateFollowups");function Ti(e,t=[]){if(e.status===void 0&&e.status_at===void 0&&e.merged_at===void 0)return!1;const n=e.merged_at||e.status_at||new Date().toISOString();["merged","done","dropped"].includes(e.status)&&Object.assign(e,{lane:"done",lane_at:n,closed_at:n}),(e.status==="merged"||e.merged_at)&&(e.prs=Se(e).map(i=>({...i,merged_at:i.merged_at||n})),delete e.pr),e.status==="held"&&(e.held=!0);const a=t.filter(i=>i.started&&ze(i)).sort((i,o)=>String(i.started).localeCompare(String(o.started))).at(-1);return e.status==="checking"&&a&&(a.handed_back=n),delete e.status,delete e.status_at,delete e.merged_at,!0}r(Ti,"statusToFacts");const Vc=r(e=>De(e,async()=>{const t=[];for(const n of await M(e)){const a=await g(n.file,null);let i=0;for(const o of Array.isArray(a?.items)?a.items:[]){const s=o.status==="checking"?await H(n.dir,o.id):[],l=await Promise.all(s.map(c=>g(c,null)));if(Ti(o,l.filter(Boolean))){i++;for(const[c,u]of l.entries())u?.handed_back&&await k(s[c],u)}}i&&(await k(n.file,a),t.push(`${n.slug}: ${i} cards' statuses became lanes and facts`))}return await xt(e,async()=>{const n=await Me(e),a=n.filter(i=>i.item&&Ti(i.item)).length;a&&(await _t(e,n),t.push(`archive: ${a} cards' statuses became lanes and facts`))}),t}),"migrateStatuses");function Ci(e,t){const n=e.lane==="done"&&!wn.done.includes(e.phase);if(!("state"in e)&&!n)return!1;if("state"in e&&e.state!==void 0&&(e.phase=e.state),delete e.state,n){const a=Se(e);e.phase=a.some(i=>i.merged_at)||!a.length&&t?"merged":"closed"}return!0}r(Ci,"stateToPhase");const Yc=r(e=>De(e,async()=>{const t=[],n=await M(e),a=r(async(i,o)=>!!i&&o.lane==="done"&&(await Promise.all((await H(i,o.id)).map(s=>g(s,null)))).some(s=>s?.started&&ze(s)),"built");for(const i of n){const o=await g(i.file,null);let s=0;for(const l of Array.isArray(o?.items)?o.items:[])Ci(l,await a(i.dir,l))&&s++;s&&(await k(i.file,o),t.push(`${i.slug}: ${s} cards' states became phases`))}return await xt(e,async()=>{const i=await Me(e);let o=0;for(const s of i)s.item&&Ci(s.item,await a(n.find(l=>l.slug===(s.file||N(s.key).file))?.dir,s.item))&&o++;o&&(await _t(e,i),t.push(`archive: ${o} cards' states became phases`))}),t}),"migratePhases"),Xc=r(e=>De(e,async()=>{const t=[];for(const n of await M(e)){const a=await g(n.file,null),i=(Array.isArray(a?.items)?a.items:[]).filter(o=>o.implement_at);if(i.length){for(const o of i)o.phase!=="ready"&&Object.assign(o,{phase:"staging",staged_at:o.implement_at}),delete o.implement_at;await k(n.file,a),t.push(`${n.slug}: ${i.length} Implement asks moved to staging or ready`)}}return t}),"stageImplementAsks"),Yt=r(e=>h.join(e,"data","done-archive.json"),"archiveFile"),xt=r((e,t)=>pt(h.join(e,"done-archive"),t,{heartbeat:!0}),"archiveWrite"),Me=r(async e=>(await g(Yt(e),{cards:[]})).cards||[],"readArchive"),Xt=r(e=>`${e.closed_at||""}|${e.key}`,"archiveRank"),Dr=r((e,t)=>Xt(e)<Xt(t)?1:Xt(e)>Xt(t)?-1:0,"byClosed"),Xn=r(e=>h.join(e,"data","done-archive-count.json"),"archiveCountFile");async function ed(e){const t=(await g(Xn(e),null))?.count;if(Number.isInteger(t))return t;const n=(await Me(e)).length;return await k(Xn(e),{count:n}),n}r(ed,"archiveCount");async function _t(e,t){t.length?await k(Yt(e),{cards:t.sort(Dr)}):await j.rm(Yt(e),{force:!0}),await k(Xn(e),{count:t.length})}r(_t,"writeArchive");const td=r((e,t)=>xt(e,async()=>{const n=new Map(t.map(p=>[p.key,p])),a=new Date().toISOString(),i=[],o=[];for(const p of await M(e)){const f=await g(p.file,null);if(!Array.isArray(f?.items))continue;const m=f.items.filter($=>n.has(`${p.slug}/${$.id}`)&&$.lane==="done");if(m.length){for(const $ of m){const y=n.get(`${p.slug}/${$.id}`);i.push({...y,file:p.slug,archived_at:a,item:y.prs?Fr($,y.prs):$})}o.push([p.file,{...f,items:f.items.filter($=>!m.includes($))}])}}if(!i.length)return[];const s=await g(L(e),{items:[]}),l=new Map(i.map(p=>[`item:${p.key}`,p]));for(const p of i)p.questions=(s.items||[]).filter(f=>f.topic===`item:${p.key}`&&f.resolved);const c=await je(e);for(const p of i)p.asks=p.item.from_ask&&V(c,p.item.from_ask)===void 0?[p.item.from_ask]:[];const u=new Set(i.map(p=>p.key));await _t(e,[...(await Me(e)).filter(p=>!u.has(p.key)),...i.map(({key:p,file:f,archived_at:m,closed_at:$,item:y,questions:_,asks:D})=>({key:p,file:f,archived_at:m,closed_at:$,item:y,questions:_,asks:D}))]),i.some(p=>p.asks.length)&&await k(ke(e),{links:{...c,...Object.fromEntries(i.flatMap(p=>p.asks.map(f=>[f,p.key])))}});for(const[p,f]of o)await k(p,f);const w=(s.items||[]).filter(p=>!(l.has(p.topic)&&p.resolved));return w.length!==(s.items||[]).length&&await k(L(e),{...s,items:w}),[...u]}),"archiveCards");function Fr(e,t){if(!Le(e))return e;const n=Se(e).map(o=>{const s=t.find(l=>l.state&&l.number===o.number&&(!o.repo||o.repo===l.repo));return s?{...o,kept:{checks:s.checks,reviews:s.reviews,codexOpen:s.codexOpen}}:o}),{pr:a,...i}=e;return{...i,prs:n}}r(Fr,"keptPRs");async function Rr(e,t){return!e||!ce(Yt(e))?!1:xt(e,async()=>{const n=await Me(e),a=n.find(p=>p.key===t);if(!a)return!1;const i=(await M(e)).find(p=>p.slug===a.file),o=i&&await g(i.file,null);if(!Array.isArray(o?.items))return!1;o.items.some(p=>p.id===a.item.id)||await k(i.file,{...o,items:[...o.items,a.item]});const s=await g(L(e),{items:[]}),l=new Set((s.items||[]).map(p=>p.id)),c=(a.questions||[]).filter(p=>!l.has(p.id));c.length&&await k(L(e),{...s,items:[...s.items||[],...c]});const u=await je(e),w=(a.asks||[]).filter(p=>V(u,p)===t);return w.length&&await k(ke(e),{links:Object.fromEntries(Object.entries(u).filter(([p])=>!w.includes(p)))}),await _t(e,n.filter(p=>p!==a)),!0})}r(Rr,"restoreArchived");const qi=["push_tag","no_change"],Mi=r(e=>Object.fromEntries(Object.entries(e).filter(([t])=>!qi.includes(t))),"stripQuestion"),Wi=r(({summary:e,...t})=>t,"stripItem"),Ui=r(e=>qi.some(t=>t in e),"holdsDead"),nd=r(e=>xt(e,async()=>{for(const a of await M(e)){const i=await g(a.file,null);Array.isArray(i?.items)&&i.items.some(o=>"summary"in o)&&await k(a.file,{...i,items:i.items.map(Wi)})}const t=await g(L(e),null);(t?.items||[]).some(Ui)&&await k(L(e),{...t,items:t.items.map(Mi)});const n=await Me(e);n.some(a=>"card"in a||"summary"in a.item||(a.questions||[]).some(Ui))&&await _t(e,n.map(({card:a,...i})=>({...i,...a?{closed_at:i.closed_at||a.sortAt}:{},item:Wi(i.item),questions:(i.questions||[]).map(Mi)})))}),"stripDeadFields");async function ad(){return Oo(async()=>{const e=jo(),t=Array.isArray(e.migrated)?e.migrated:[];if(t.includes("wave-names")||!Object.keys(e.sites||{}).length)return[];const n=[];for(const{route:a,dir:i}of we(e))await Nr(i),n.push(a);return e.migrated=[...t,"wave-names"],await Po(e),n})}r(ad,"migrateWaveNames");const Hi=r(async e=>JSON.parse(await j.readFile(e,"utf8")),"readPlain"),ea=r((e,t)=>Qe(e,JSON.stringify(t,null,2)+`
29
- `),"writePlain"),zi=r(e=>typeof e!="string"?e:e.replace(/^wave:([a-z0-9-]+)$/,"file:$1").replace(/^lineup:([a-z0-9-]+)$/,"wave:$1"),"renamedTopic"),ta=r(e=>Array.isArray(e)?e.map(ta):e&&typeof e=="object"?Object.fromEntries(Object.entries(e).map(([t,n])=>[zi(t),ta(n)])):zi(e),"renameTopics");async function Nr(e){const t=h.join(e,"board.json"),n=await Hi(t).catch(()=>null);if(n&&typeof n.items=="string"&&n.items!=="waves"&&h.basename(n.items)==="wave.json"){const i=h.join(h.dirname(n.items),"items.json");ce(h.resolve(e,n.items))&&await j.rename(h.resolve(e,n.items),h.resolve(e,i)),await ea(t,{...n,items:i,slug:n.slug||"wave"})}for(const i of await M(e)){const o=await Hi(i.file).catch(()=>null);if(!Array.isArray(o?.lineups))continue;const{lineups:s,...l}=o;await ea(i.file,{...l,waves:[...l.waves||[],...s]});for(const{slug:c}of s)await j.rename(h.join(i.dir,`lineup-${c}.md`),h.join(i.dir,na(c))).catch(u=>{if(u.code!=="ENOENT")throw u})}const a=h.join(e,"data");for(const i of(await j.readdir(a).catch(()=>[])).filter(o=>o.endsWith(".json"))){const o=h.join(a,i),s=await j.readFile(o,"utf8");let l;try{l=JSON.parse(s)}catch{continue}l=ta(l),i==="done-archive.json"&&Array.isArray(l.cards)&&(l.cards=l.cards.map(({wave:c,...u})=>c===void 0?u:{...u,file:c})),i==="arch-reviews.json"&&Array.isArray(l.reviews)&&(l.reviews=l.reviews.map(({wave:c,lineup:u,...w})=>u?{...w,wave:c}:{...w,file:c})),JSON.stringify(l)!==JSON.stringify(JSON.parse(s))&&await ea(o,l)}}r(Nr,"renameWaveNames");const na=r(e=>`wave-${e}.md`,"waveNoteFile"),Er=r(e=>typeof e=="string"&&/^[a-z0-9-]+$/.test(e)?e:d(`a wave's slug uses only a-z, 0-9 and "-", not "${e}"`),"waveSlug");async function en(e,t){for(const n of await M(e)){const a=await g(n.file,null),i=(a?.waves||[]).find(o=>o.slug===t);if(i)return{source:n,itemFile:a,wave:i}}return d(`this board has no wave "${t}"; wave create makes one`)}r(en,"findWave");async function Ir(e,t){(await ae(e)).items!=="waves"&&d(`topic file:${t} is for a board over ~/.claude/waves; a wave's triage uses wave:<slug>`),await Be(e,t)}r(Ir,"triagedFile");function aa(e,t,n,a){return n.map(i=>{const{file:o,id:s}=N(i);o!==e.slug&&d(`${i} is not in item file "${e.slug}"; a wave's cards share one file`),t.items.some(c=>c.id===s)||d(`item file "${o}" has no item "${s}"`);const l=(t.waves||[]).find(c=>c.slug!==a&&!c.finished_at&&Et(c).includes(s));return l&&d(`${i} is already in the wave "${l.slug}"; wave remove ${l.slug} ${i} first`),s})}r(aa,"waveCards");const ia=r(e=>[...new Set(String(e??"").split(",").map(t=>t.trim()).filter(Boolean))],"cardList");function Lr(e){const t=[e??[]].flat().map(n=>{const[a,i]=String(n).split(":");return[a.trim(),ia(i)]});return(!t.length||t.some(([n])=>!n))&&d("--card takes one card per flag in build order, as <file>/<id>, or <file>/<id>:<file>/<id>,\u2026 naming the earlier cards it conflicts with"),t}r(Lr,"cardSpecs");function tn(e,t,n,a,i){const o=n.items.indexOf(a),s=i.map(u=>{const w=U(e.slug,u),{file:p,id:f}=N(w),m=p===e.slug?n.items.indexOf(f):-1;return(m<0||m>=o)&&d(`${w} is not an earlier card of the wave "${n.slug}"`),f}),l=t.items.find(u=>u.id===a),c=[...(l.deps||[]).filter(u=>!Ji(e,n,u)),...s];c.length?l.deps=c:delete l.deps}r(tn,"relink");const Ji=r((e,t,n)=>Et(t).some(a=>U(e.slug,n)===`${e.slug}/${a}`),"inWave");async function Ki(e,t,n,a,i){i!==void 0&&await Qe(h.join(t.dir,na(a.slug)),`${S(i,"the note").replace(/\n*$/,`
30
- `)}`),await k(t.file,n);const{tickets:o}=be(await ae(e));return{file:t.file,lines:[`order: ${Qi(t,n,a,o)}`]}}r(Ki,"writeWave");function Qi(e,t,n,a){const i=r(o=>Je(t,t.items.find(s=>s.id===o)||{id:o},a),"label");return Et(n).map(o=>{const s=(t.items.find(l=>l.id===o)?.deps||[]).filter(l=>Ji(e,n,l));return s.length?`${i(o)} (after ${s.map(l=>i(N(U(e.slug,l)).id)).join(", ")})`:i(o)}).join(", ")}r(Qi,"orderLine");async function id(e,t,{title:n,goal:a,cards:i,note:o}){Er(t);const s=Lr(i);o===void 0&&d("wave create needs the wave note, as --note <text> or --file <path>");const l=await M(e);l.some(f=>f.slug===t)&&d(`"${t}" is an item file on this board; pick another slug`);for(const f of l)((await g(f.file,null))?.waves||[]).some(m=>m.slug===t)&&d(`this board already has a wave "${t}"`);const c=l.find(f=>f.slug===N(s[0][0]).file)||d(`this board has no item file "${N(s[0][0]).file}"`),{itemFile:u}=await Be(e,c.slug),w=aa(c,u,s.map(([f])=>f),t);new Set(w).size!==w.length&&d("--card names a card twice");const p={slug:t,title:S(n,"--title"),goal:S(a,"--goal"),items:w,created:new Date().toISOString()};return s.forEach(([,f],m)=>tn(c,u,p,w[m],f)),u.waves=[...u.waves||[],p],Ki(e,c,u,p,o)}r(id,"createWave");async function od(e,t,{add:n,remove:a,card:i,after:o,title:s,goal:l,note:c}){[n,a,i,o,s,l,c].every(f=>f===void 0)&&d("nothing to change: pass a card with --after, --title, --goal, --note or --file"),o!==void 0&&n===void 0&&i===void 0&&d(`--after goes with a card: wave set ${t} <file>/<id> --after <file>/<id>,\u2026`),i!==void 0&&o===void 0&&d(`wave set ${t} ${i} needs --after <file>/<id>,\u2026 ("" clears its links)`);const{source:u,itemFile:w,wave:p}=await en(e,t);if(p.finished_at&&d(`the wave "${t}" is finished`),p.items=Et(p),delete p.phases,n!==void 0){const[f]=aa(u,w,[n],t);p.items.includes(f)&&d(`${n} is already in the wave "${t}"`),p.items.push(f),tn(u,w,p,f,ia(o))}if(i!==void 0){const{file:f,id:m}=N(i);(f!==u.slug||!p.items.includes(m))&&d(`${i} is not in the wave "${t}"`),tn(u,w,p,m,ia(o))}if(a!==void 0){const[f]=aa(u,w,[a],t);p.items.includes(f)||d(`${a} is not in the wave "${t}"`),p.items.length===1&&d(`${a} is the wave's last card; wave finish ${t} ends the wave`),tn(u,w,p,f,[]);for(const m of w.items.filter($=>p.items.includes($.id)&&$.deps))m.deps=m.deps.filter($=>U(u.slug,$)!==`${u.slug}/${f}`),m.deps.length||delete m.deps;p.items=p.items.filter(m=>m!==f)}return s!==void 0&&(p.title=S(s,"--title")),l!==void 0&&(p.goal=S(l,"--goal")),Ki(e,u,w,p,c)}r(od,"changeWave");async function sd(e,t){const{source:n,itemFile:a,wave:i}=await en(e,t);return i.finished_at=new Date().toISOString(),await k(n.file,a),{file:n.file}}r(sd,"finishWave");async function rd(e,t,n){const{source:a,itemFile:i,wave:o}=await en(e,t),s=await j.readFile(h.join(a.dir,na(t)),"utf8").catch(()=>"");return{title:o.title,markdown:`**Goal** ${o.goal}
22
+ `,"withSection");async function Re(e,t,n,a){const{source:i,item:{id:o}}=await x(e,t);return gr(i.dir,o,async()=>{const{source:s,itemFile:c,item:l}=await x(e,t);let u;l.plan?(u=await nn(s.dir,l.plan,{missingOk:!0}),de(u)||await W(e,t,"notes-missing")):(l.plan=Zt(s.dir,l.id),u=g.join(s.dir,l.plan),await y(s.file,c));const p=de(u)?await j.readFile(u,"utf8"):`# ${l.title}
23
+ `;return await Yt(u,kr(p,$r(n),a)),l.plan})}r(Re,"appendNotes");async function Ai(e){const{tickets:t}=Se(await oe(e)),n=[],a=new Map;for(const i of await q(e)){const o=await $(i.file,null);a.set(i.slug,{source:i,itemFile:o||{}});for(const s of o?.items||[])s.plan&&n.push({key:`${i.slug}/${s.id}`,ref:tt(o,s,t),title:s.title,created:s.created||"",archived:!1,dir:i.dir,plan:s.plan})}for(const i of e?await Le(e):[]){if(!i.item?.plan)continue;const o=a.get(i.file);n.push({key:i.key,ref:tt(o?.itemFile||{},i.item,t),title:i.item.title,created:i.item.created||"",archived:!0,dir:o?.source.dir||g.join(e,"data"),plan:i.item.plan})}return n}r(Ai,"cardsWithNotes");const Pi=r(e=>j.realpath(g.resolve(e.dir,e.plan)).catch(()=>null),"realNotes");async function Di(e,t,n,a){if(t==="-")return Eo(0,"utf8");const i=await j.realpath(t).catch(()=>d(`${n} ${t}: no such file`));for(const o of await Ai(e))await Pi(o)===i&&d(`${n} ${t} is the notes file of ${o.ref} "${o.title}" (${o.key}), and a card's notes are its own; ${a(o)}`);return j.readFile(i,"utf8")}r(Di,"refuseCardNotes");const ta="write a draft of your own outside the board's data folder";async function Yl(e,t,{heading:n,file:a,from:i}){let o;if(i!==void 0){i===t&&d(`${t} can't fold its own notes into itself; pass --from <the other card>`);const[l,u]=await Promise.all([x(e,t),x(e,i)]),[p,w]=await Promise.all([l,u].map(({source:f,item:h})=>h.plan?j.realpath(g.resolve(f.dir,h.plan)).catch(()=>null):null));p&&p===w&&d(`${i} and ${t} name one notes file, ${l.item.plan}, from before the board named each card's own; the board splits it as it starts`),o=(await Ir(e,i)).markdown,n??=`Folded from ${await H(e,i)} "${u.item.title}"`}else o=await Di(e,a,"--file",l=>l.key===t?`${ta}, holding only the new section`:`${ta}, or fold that card's notes in with item notes ${t} --from ${l.key}`);o.trim()||d(`${i??a} is empty`);const s=await Re(e,t,n,o),c=await en(e,t,"Recorded in the card's notes");return{file:s,heading:n,lines:c}}r(Yl,"addNotes");const Xl=r(e=>ce(e,async()=>{const t=await Ai(e),n=new Map;for(const i of t){const o=await Pi(i);o&&n.set(o,[...n.get(o)||[],i])}const a=[];for(const[i,o]of n){const[s,...c]=o.sort((l,u)=>l.created<u.created?-1:l.created>u.created?1:l.key<u.key?-1:1);for(const l of c.filter(u=>!u.archived)){const{source:u,itemFile:p,item:w}=await Ue(e,F(l.key).file).then(h=>({...h,item:h.itemFile.items.find(m=>m.id===F(l.key).id)})),f=w.plan;w.plan=Zt(u.dir,w.id),await Yt(g.join(u.dir,w.plan),await j.readFile(i,"utf8")),await y(u.file,p),await W(e,l.key,"notes-shared",{card:s.ref}),a.push(`${l.key}: its own notes, ${w.plan}, copied from ${g.normalize(f)}, which ${s.key} keeps`)}await j.chmod(i,Oi)}return a}),"splitSharedNotes");async function br(e,t){const{source:n,item:a}=await x(e,t);return we(a)||be(a)||a.pushed||(await Promise.all((await G(n.dir,a.id)).map(o=>$(o,null)))).some(o=>o?.started&&!o.done&&o.kind!==me)||(await fe(e,t)).asked.some(o=>o.state==="open")||(await $(ye(e),{}))[t]?!1:!await ia(e,t)}r(br,"stageable");async function na(e,t){const{source:n,itemFile:a,item:i}=await x(e,t);i.phase!=="staging"&&(Object.assign(i,{phase:"staging",staged_at:new Date().toISOString()}),delete i.unfiled,delete i.filed_held,await y(n.file,a),await Je(e,t,{command:"staged"}))}r(na,"stage");const Fi=r(({text:e,files:t})=>[String(e||"").trim(),...(Array.isArray(t)?t:[]).map(n=>`Attached: ${n?.path||n?.name||n}`)].filter(Boolean).join(`
24
+ `),"messageWords");async function yr(e,t,n){const{item:a}=await x(e,t);a.held&&await Vi(e,"card-hold",{key:t,hold:!1});const{owner:i,asked:o}=await fe(e,t),s=o.filter(l=>l.state==="open").map(l=>l.id);s.length&&await Xt(e,i,s,"Skipped: you tapped Implement");const c=Fi(n);c&&await Re(e,t,`Implement (owner, ${Qe()}), verbatim`,c),await na(e,t)}r(yr,"stageImplement");async function ed(e,t,n){const a=Fi(n);a&&await Re(e,t,`Reply (owner, ${Qe()}), verbatim`,a),await na(e,t)}r(ed,"stageReply");async function td(e,t,n){const{source:a,itemFile:i,item:o}=await x(e,t);!["ready","staging"].includes(o.phase)||we(o)||(o.phase=n==="prototype"?"prototyping":"grilling",delete o.staged_at,await y(a.file,i))}r(td,"planAgain");async function xr(e,t){const n=await x(e,t).catch(()=>null);!n||!["ready","staging"].includes(n.item.phase)||we(n.item)||(n.item.phase="grilling",delete n.item.staged_at,await y(n.source.file,n.itemFile),await W(e,t,"new-question"))}r(xr,"grillAgain");function Ni(e){return e.filter(t=>t.state==="answered").map(t=>t.id)}r(Ni,"answeredOnClaude");function ve(e,t,n,a=new Date().toISOString()){for(const i of e.items||[])t.includes(i.id)&&Object.assign(i,{resolved:n,resolved_at:a})}r(ve,"setResolved");async function Xt(e,t,n,a){return ve(t,n,a),await y(E(e),t),E(e)}r(Xt,"markResolved");async function nd(e,t,n){D(e);const a=await $(E(e),{topics:[],items:[]}),i=(a.items||[]).find(f=>f.id===t);i||d(`no question "${t}" in owner.json`);const{answers:o,requests:s,reopens:c}=await ft(e),l=Te(i,o,s,[],c);if(l.state==="resolved")return E(e);l.state==="requested"&&d(`${t} waits on the prototype the owner asked for; question add with round_of ${t} resolves it`);const u=S(n,"--note");Ne(i.url)&&_r(a,i,o);const p=await Xt(e,a,[t],u);await Bi(e,i.topic);const w=Xn(i.topic);return w&&(await x(e,w).catch(()=>null))?.item.phase==="grilling"&&await vi(e,w,{roundAt:!0}),p}r(nd,"resolveQuestion");async function ad(e,t,n,a=[]){D(e);const[i,...o]=[...new Set(t)];i||d("question move takes the ids of the questions to merge"),await x(e,n);const s=[n,...a];new Set(s).size!==s.length&&d("question move names a card twice");for(const f of a)await x(e,f);const c=await $(E(e),{topics:[],items:[]}),{answers:l,requests:u,reopens:p}=await ft(e);for(const f of[i,...o]){const h=(c.items||[]).find(k=>k.id===f)||d(`no question "${f}" in owner.json`),{state:m}=Te(h,l,u,[],p);m!=="open"&&d(`${f} is ${m}; question move takes open questions`)}for(const[f,h]of a.entries()){const{item:m}=await x(e,h),k=[...m.deps||[],s[f]].join(",");await $e(e,h,{deps:k,relate:n})}const w=await H(e,n);return Object.assign(c.items.find(f=>f.id===i),{topic:`item:${n}`}),ve(c,o,`Duplicate of ${w}'s question ${i}`),await y(E(e),c),E(e)}r(ad,"moveQuestions");async function id(e,t){const n=t.filter(({choice:i,note:o})=>!i&&String(o||"").trim()).map(i=>i.id),a=n.length?await $(E(e),{topics:[],items:[]}):null;a?.items?.some(i=>n.includes(i.id))&&(ve(a,n,"Answered with a note"),await y(E(e),a))}r(id,"resolveNoteAnswers");function _r(e,t,n){const a=jn(t),i=e.items.filter(o=>o.topic===t.topic&&jn(o)===a).map(o=>Te(o,n));Ko(i,a)||d(`${t.id} is in prototype round ${a}, which no pick has settled yet; a pick settles it`)}r(_r,"roundSettled");async function ft(e){const t=await z(g.join(e,"data","events.jsonl"));return{answers:await Promise.all(t.filter(a=>a.kind==="owner-answer").map(async a=>({...a,reply:a.reply||(await Ln(g.join(e,"data","replies"),a.id)).length>0}))),requests:t.filter(a=>a.kind==="prototype-request"),reopens:t.filter(a=>a.kind===Ho)}}r(ft,"ownerEvents");async function od(e,t){const{asked:n}=await Sr(e),a=new Map(n.map(i=>[i.id,i.state]));return t.filter(i=>!a.has(String(i.id))||["open","requested"].includes(a.get(String(i.id))))}r(od,"unrecorded");async function Sr(e){const t=await $(E(e),{topics:[],items:[]}),{answers:n,requests:a,reopens:i}=await ft(e);return{owner:t,asked:(t.items||[]).map(o=>Te(o,n,a,[],i))}}r(Sr,"topicQuestionsAll");async function Ri(e,t){const n=await $(E(e),{topics:[],items:[]}),{answers:a,requests:i,reopens:o}=await ft(e),s=(n.items||[]).filter(c=>c.topic===t).map(c=>Te(c,a,i,[],o));return{owner:n,asked:s}}r(Ri,"topicQuestions");const fe=r((e,t)=>Ri(e,`item:${t}`),"cardQuestions"),en=r((e,t,n)=>Ei(e,`item:${t}`,n),"resolveAnswered");async function Ei(e,t,n){if(!e)return[];const{owner:a,asked:i}=await Ri(e,t),o=Ni(i);return o.length&&await Xt(e,a,o,n),await Bi(e,t),o.map(s=>`resolved: ${s}`)}r(Ei,"resolveAnsweredOn");const aa=r(async(e,t)=>!!e&&(await fe(e,t)).asked.some(n=>n.state==="open"),"hasOpenQuestion");function Li(e,t,n){e.next=S(t,"--next"),e.next_at=new Date().toISOString(),n?e.next_on_questions=!0:delete e.next_on_questions}r(Li,"setNext");async function Bi(e,t){const n=t.startsWith("item:")&&!t.startsWith("item:ask:")?t.slice(5):null;if(!n)return;let a;try{a=await x(e,n)}catch(c){if(c instanceof ue)return;throw c}const{source:i,itemFile:o,item:s}=a;s.next_on_questions&&((await fe(e,n)).asked.some(c=>c.state!=="resolved")||(delete s.next,delete s.next_at,delete s.next_on_questions,await y(i.file,o)))}r(Bi,"clearWaitedNext");async function vr(e,t){const{source:n,itemFile:a,item:i}=await x(e,t);i.next===void 0&&i.next_on_questions===void 0||(delete i.next,delete i.next_at,delete i.next_on_questions,await y(n.file,a))}r(vr,"clearNext");async function Ci(e,t,n,a){if(!e)return async()=>[];const{owner:i,asked:o}=await fe(e,t),s=o.filter(l=>l.state==="open").map(l=>l.id);s.length&&!a&&d(`${n}: ${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 c=o.filter(l=>l.state!=="resolved").map(l=>l.id);return async()=>(c.length&&await Xt(e,i,c,"Closed with the card"),c.map(l=>`resolved: ${l}`))}r(Ci,"closeQuestions");async function sd(e,t,n,a,i){await x(e,t),zt(n),ee(a,o=>S(o,"--owner-step")),ee(i,o=>Zi(o)),await Ci(D(e),t,"land",!1)}r(sd,"checkClose");async function ia(e,t){const n=await $(E(e),{items:[]}),{answers:a,requests:i,reopens:o}=await ft(e);return Uo((n.items||[]).map(s=>Te(s,a,i,[],o)),t)}r(ia,"unpickedPrototype");const jr=r(e=>e.length>120?`${e.slice(0,119)}\u2026`:e,"clip"),Or={ask:"text","ask-edited":"text","item-message":"text","owner-answer":"note"};async function Ii(e,t,n){const a=S(t,n).replace(/\s+/g," ");return(await z(g.join(e,"data","events.jsonl"))).map(o=>String(o.data?.[Or[o.kind]]??"").replace(/\s+/g," ").toLowerCase()).some(o=>o.includes(a.toLowerCase()))||d(`${n} must quote the owner's words in an ask, card message or answer note on this board`),a}r(Ii,"ownerQuote");async function rd(e,t,n){return D(e),n===void 0&&d(`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 Ii(e,n,"--asked")}"`}r(rd,"askedGate");async function Dt(e,t,n="--from-ask"){return Fe(t,n),(await z(g.join(D(e),"data","events.jsonl"))).some(i=>i.id===t&&i.kind==="ask")?t:d(`no ask "${t}" in this site's data/events.jsonl`)}r(Dt,"checkAsk");function Ft(e,t,n=new Date().toISOString(),a=Ti(e,t)){if(!Ce[t])throw new Error(`no lane "${t}"`);const i=e.lane;return qi(e,t,a),e.lane=t,e.lane_at=n,t==="done"?(e.closed_at=n,delete e.reopened_at):i==="done"&&(e.reopened_at=n),i}r(Ft,"placeIn");function Ti(e,t,n=!1){return t==="todo"?we(e)?"ready":e.phase??null:t==="progress"?"reading":t==="done"?n||De(e).some(a=>a.merged_at)?"merged":"closed":null}r(Ti,"movedPhase");function qi(e,t,n){if(n!==null&&!_n[t].includes(n))throw new Error(`no ${Ce[t]} phase "${n}"`);n===null?delete e.phase:e.phase=n}r(qi,"setPhase");async function cd(e,t,n,a,i,o){const{source:s}=await x(e,t),{id:c}=F(t),l=new Date().toISOString();if(!await nt(s.file,async()=>{const w=JSON.parse(await j.readFile(s.file,"utf8")),f=w.items.find(m=>m.id===c)||d(`item file "${s.slug}" has no item "${c}"`);if(o&&((f.lane??null)!==o.lane||(f.phase??null)!==o.phase)||f.lane===n&&(i===void 0||(f.phase??null)===i))return!1;let h;return f.lane===n?qi(f,n,i):h=Ft(f,n,l,i),await We(s.file,JSON.stringify(w,null,2)+`
25
+ `),h!==void 0}))return null;const p={ts:l,who:"claude",kind:Pa,text:`Moved to ${Ce[n]}: ${S(a,"why")}`};return await le(Z(e,t),p),p.text}r(cd,"moveCard");const K=r(e=>e?.lane==="done"||!!e?.reopened_at,"closed"),we=r(e=>!!e?.lane&&e.lane!=="todo","leftTodo"),ld=r(async(e,t)=>K((await x(e,t)).item),"isFinished"),Mi=["ready","grilling","prototyping"];function Wi(e,t){t!==void 0&&d(`--state is now --phase: pass --phase ${Mi.includes(t)?t:"ready, grilling or prototyping"}`),e==="staging"&&d("--phase staging is set by the board, on an owner action; pass ready, grilling or prototyping"),e!==void 0&&!Mi.includes(e)&&d("--phase takes ready, grilling or prototyping")}r(Wi,"checkPhase");const Ar="a card goes ready only from staging, which the board sets on the owner's Send, Implement or Reply";async function Ui(e,t){return(await z(g.join(D(e),"data","events.jsonl"))).some(a=>a.kind==="ask"&&a.id===t&&a.data?.quick===!0||a.kind==="item-message"&&a.data?.key===`ask:${t}`&&a.data?.intent==="build")}r(Ui,"quickAsk");const Pr=/^mark (?:it |this |the card )?ready\b/i;function Dr(e,t,n){const a=[].concat(t).map(s=>Fn(s)||d(`--pr takes a PR number or owner/repo#<n>, not "${s}"`)),i=r((s,c)=>s.number===c.number&&(s.repo||n||null)===(c.repo||n||null),"same"),o=De(e);for(const s of a)o.some(c=>i(c,s))||o.push(s);delete e.pr,e.prs=o}r(Dr,"addPRs");const J=r((e,t)=>String(t).includes("/")?String(t):`${e}/${t}`,"depKey"),Ge=/^wave:(.+)$/;async function wt(e,t,n){const a=await Promise.all((n||[]).map(async i=>{const o=String(i).match(Ge)?.[1];if(!o)return[J(t,i)];const{source:s,wave:c}=await pt(e,o);return Ie(c).map(l=>`${s.slug}/${l}`)}));return[...new Set(a.flat())]}r(wt,"depCards");async function Ee(e,t,n){const a=await wt(e,t,n.deps),i=await Promise.all(a.map(o=>x(e,o).then(({item:s})=>s,()=>null)));return a.filter((o,s)=>i[s]&&!K(i[s]))}r(Ee,"unfinishedDeps");async function Fr(e,t,n){const a=await Promise.all((await Ee(e,F(t).file,n)).map(i=>H(e,i)));return n.blocked_until?[...a,n.blocked_until]:a}r(Fr,"blockerNames");async function tn(e,t,n){n??=(await x(e,t)).item;const a=await Promise.all((await Ee(e,F(t).file,n)).map(i=>H(e,i)));return[a.length&&`by ${a.join(", ")}`,n.blocked_until&&`until ${n.blocked_until}`].filter(Boolean).join(" and ")}r(tn,"blockWords");const Nr=r((e,t)=>!be(e)&&!e.pushed&&!e.merge_ready&&!K(e)&&(!!Sn(t)||t.some(n=>n?.started&&!n.done&&et(n))),"inProgress");async function Rr(e,t){const n=[];for(const a of await q(e)){const i=await $(a.file,null);for(const o of Array.isArray(i?.items)?i.items:[])K(o)||o.blocked_until||!(await wt(e,a.slug,o.deps)).includes(t)||(await Ee(e,a.slug,o)).length||n.push(`${a.slug}/${o.id}`)}return n}r(Rr,"unblockedBy");async function Er(e,t,n){const a=F(t).file,i=(await sa(e,a,n)).map(c=>Ge.test(c)?c:J(a,c));i.length||d("--split-into takes wave:<slug> or the cards the split filed, <id>,<file>/<id>"),(await wt(e,a,i)).includes(t)&&d(`${t} can't be split into itself`);const o=await Promise.all(i.map(async c=>{const l=c.match(Ge)?.[1];if(!l)return H(e,c);const{source:u,wave:p}=await pt(e,l),w=await Promise.all(Ie(p).map(f=>H(e,`${u.slug}/${f}`)));return`the wave ${p.title} (${w.join(", ")})`})),s=[];for(const c of await q(e))for(const l of(await $(c.file,null))?.items||[]){const u=`${c.slug}/${l.id}`;if(!(K(l)||!(l.deps||[]).some(p=>J(c.slug,p)===t))){for(const p of i)(await wt(e,a,[p])).includes(u)&&d(Ge.test(p)?`${u} waits on ${t} and is in the wave "${p.match(Ge)[1]}", so it would wait on itself; split into the new cards by key`:`${u} waits on ${t} and is one of the cards it splits into, so it would wait on itself`);s.push(u)}}return{entries:i,words:o.join(", "),waiters:s}}r(Er,"splitPlan");async function Lr(e,t,{entries:n,words:a,waiters:i}){for(const s of await q(e)){const c=i.filter(u=>F(u).file===s.slug);if(!c.length)continue;const l=await $(s.file,null);for(const u of l.items.filter(p=>c.includes(`${s.slug}/${p.id}`))){const p=n.map(w=>!Ge.test(w)&&F(w).file===s.slug?F(w).id:w);u.deps=[...new Set([...u.deps.filter(w=>J(s.slug,w)!==t),...p])]}await y(s.file,l)}const o=await H(e,t);for(const s of i)await W(e,s,"split-moved",{card:o,to:a})}r(Lr,"moveWaiters");async function oa(e,t,n){const{source:a,itemFile:i,item:o}=await x(e,t);if(we(o))o.unblocked_at=n;else if(o.phase==="ready")o.recheck_at=n;else return;await y(a.file,i)}r(oa,"markUnblocked");async function Hi(e,t,n,a){const i=new Set(a.match(/#?[\w-]+(?:\.[\w-]+)*(?:\/[\w-]+(?:\.[\w-]+)*)*/g)||[]),o=new Set(await wt(e,F(t).file,n.deps));for(const s of await q(e)){const c=await $(s.file,null);for(const l of c?.items||[]){const u=`${s.slug}/${l.id}`;if(u===t||o.has(u)||K(l))continue;[l.id,tt(c,l),l.ticket].filter(Boolean).flatMap(w=>[w,`${s.slug}/${w}`]).some(w=>i.has(w))&&d(`--next names unfinished card ${u}; add it with --deps`)}}}r(Hi,"checkNextDeps");const Ji=r(e=>`item notes ${e} --heading "<heading>" --file <draft.md>`,"NOTES_COMMAND");function Br(e,t){t.size||d(`${e} has no size; a builder starts from it, so pass --size small or large with --phase ready`),t.plan||d(`${e} has no notes file; a builder starts from it, so add its notes with ${Ji(e)} before --phase ready`)}r(Br,"checkSizeAndNotes");async function Cr(e,t,n,a){Br(t,a);const i=await j.readFile(await nn(n,a.plan),"utf8"),o=(await fe(e,t)).asked.filter(s=>s.answers.length&&!i.includes(s.id)&&!((s.prototype_gate||s.ticket_gate)&&!s.answers.at(-1).note)).map(s=>s.id);o.length&&d(`${t}'s notes leave out the answered question${o.length===1?"":"s"} ${o.join(", ")}; record each answer in its notes, naming its id, with ${Ji(t)} before it is ready`)}r(Cr,"checkNotesComplete");async function nn(e,t,{missingOk:n=!1}={}){const a=r(s=>d(`a notes file is a .md file inside ${e}, named relative to it: "${t}" ${s}`),"bad");(typeof t!="string"||!t.trim())&&a("is empty"),(g.isAbsolute(t)||t.split(/[\\/]/).includes(".."))&&a("leaves the folder"),g.extname(t).toLowerCase()!==".md"&&a("is not a .md file");const i=await j.realpath(e),o=await j.realpath(g.resolve(e,t)).catch(()=>n?g.resolve(i,t):a("does not exist"));return o.startsWith(i+g.sep)||a("leaves the folder"),o}r(nn,"planPath");async function Ir(e,t){const{source:n,itemFile:a,item:i}=await x(e,t);if(i.plan)return{itemFile:a,item:i,markdown:await j.readFile(await nn(n.dir,i.plan),"utf8")};if(typeof i.notes=="string"&&i.notes.trim())return{itemFile:a,item:i,markdown:i.notes};d(`${t} has no notes`)}r(Ir,"readNotes");function zi({install:e,installSha:t,installLabel:n,clearInstall:a}){if(e===void 0)return(t!==void 0||n!==void 0)&&d("--install-sha and --install-label go with --install <url>"),a?null:void 0;a&&d("pass --install or --clear-install, not both");let i;try{i=new URL(String(e).trim())}catch{i=null}(!i||!["https:","itms-services:"].includes(i.protocol))&&d(`--install takes an https:// or itms-services:// URL, not "${e}"`),i.protocol==="itms-services:"&&!(i.searchParams.get("action")==="download-manifest"&&/^https:\/\//.test(i.searchParams.get("url")||""))&&d("--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():d(`--install-sha takes a commit sha of 7 to 40 hex digits, not "${t}"`);return{url:String(e).trim(),...n===void 0?{}:{label:S(n,"--install-label")},built_at:new Date().toISOString(),...o?{sha:o}:{}}}r(zi,"installOf");async function dd(e,{install:t,installSha:n}){const a=zi({install:t,installSha:n});a||d("main set needs --install <url>");const i=g.join(D(e),"data","main.json");return await y(i,{install:a}),{file:i,lines:["main install set"]}}r(dd,"setMainInstall");const Tr=r((e,t)=>e.length?`Merged PR${e.length>1?"s":""} ${at(e,t)}.`:"Merged.","mergedLine");function qr(e,t,n,a,i,o){return o?{status:o}:n&&a===void 0?{status:["merged",{words:Tr(n,i)}]}:(a===void 0&&e&&d(`--done needs --text "<what was done, or why it closes without landing>", which becomes ${t}'s last thread line`),a===void 0?null:{text:a})}r(qr,"closingLine");function Mr(e,t,n){const a=new Date().toISOString(),i=r((o,s)=>o.number===s.number&&(o.repo||n||null)===(s.repo||n||null),"same");e.prs=De(e).map(o=>{const s=t.find(c=>i(o,c));return s&&!o.merged_at?{...o,merged_at:s.at||a}:o}),delete e.pr}r(Mr,"markMerged");async function Ki(e,t,{ticket:n,newTicket:a,status:i,clearStatus:o,done:s,splitInto:c,merged:l,landed:u,start:p,handBack:w,next:f,clearNext:h,pr:m,pushed:k,mergeReady:_,ghSince:N,fromAsk:v,phase:O,state:A,held:I,unheld:B,pickUpAt:P,deps:L,blockedUntil:T,blockReason:M,parent:C,related:Y,relate:te,unrelate:V,install:Q,installSha:Ze,installLabel:un,clearInstall:ke,title:je,size:Bt,model:mt,force:ht,text:ie,closing:ne,who:fn,by:pe,command:$a,ownerStep:Ye,ownerDone:jo,check:gt},ka){(i!==void 0||o)&&d(`--status${o?" and --clear-status are":" is"} gone: a card's lane is stored and moves itself. Close it with --done --text "<what was done, or why it closes without landing>"`),l&&(s=!0),Y!==void 0&&(te!==void 0||V!==void 0)&&d("pass --related, or --relate and --unrelate, not both"),Wi(O,A),ht&&!s&&d("--force goes with --done"),c!==void 0&&!s&&d("--split-into goes with --done"),c!==void 0&&ie!==void 0&&d("--split-into writes the closing line; drop --text");const $t=c===void 0?null:await Er(e,t,c);$t&&(ie=`Split into ${$t.words}`),v!==void 0&&s&&d("--from-ask opens a card; close it in another call"),ie!==void 0&&zt(ie),Ye!==void 0&&S(Ye,"--owner-step");const kt=gt===void 0||gt===""?gt:Zi(gt);ie!==void 0&&v===void 0&&!s&&O!=="ready"&&d("--text goes with --from-ask, --done, or --phase ready on a staging card"),v!==void 0&&ie===void 0&&d(`--from-ask needs --text "<first line>", the item's first thread line after the ask`),f!==void 0&&h&&d("pass --next or --clear-next, not both"),typeof f=="string"&&!f.trim()&&([f,h]=[void 0,!0]);const bt=Gi({held:I,unheld:B,pickUpAt:P}),Ct=zi({install:Q,installSha:Ze,installLabel:un,clearInstall:ke});[s,p,w,f,h,m,k,_,N,v,O,bt,L,T,M,C,Y,te,V,Ct,je,Bt,mt,n,a,Ye,gt].every(R=>R===void 0||R===!1)&&d("nothing to set: pass --done, --next, --clear-next, --pr, --pushed, --gh-since, --from-ask, --phase, --held, --unheld, --pick-up-at, --deps, --blocked-until, --block-reason, --parent, --related, --relate, --unrelate, --install, --clear-install, --title, --size, --model, --ticket, --new-ticket or --check");const X=v===void 0?void 0:await Dt(e,v);X&&await Wn(e,X),X&&await oi(e,X,t);const{source:Be,itemFile:Xe,item:b}=await x(e,t),ba=X??(b.phase?void 0:b.from_ask),Oo=ba!==void 0&&await Ui(e,ba);O!==void 0&&b.answered_at&&!b.closed_at&&(delete b.answered_at,we(b)&&Ft(b,"todo",void 0,null)),O!==void 0&&we(b)&&d(`--phase sets a Todo card's phase; ${t} is ${Ce[b.lane]}, where the board sets it`),O==="ready"&&!Oo&&!["staging","ready"].includes(b.phase)&&d(`${t} reads ${b.phase||"new"}, not staging; ${Ar}`),X&&b.from_ask&&b.from_ask!==X&&d(`${t} came from ask "${b.from_ask}", so ask "${X}" can't be its from-ask; to fold it in: item relate-ask ${X} ${t} --summary "<line>"`),X&&bt&&O!==void 0&&!b.phase&&d("a card filed held is filed New and takes no --phase; drop --phase, or drop --held to file it in a phase"),X&&O===void 0&&!b.phase&&!bt&&d("--from-ask files a card, which reads New until it has a phase: pass --phase grilling, prototyping, or ready for a Quick build ask, or --held to file it for later");const wn=K(b);$t&&wn&&d(`${t} is already Done, so the cards waiting on it were unblocked then; move them with item set <key> --deps`),Ye!==void 0&&wn&&d(`${t} is already Done, so its ticket closed; an owner step goes on the command that finishes the card: land --owner-step, or builder done before the merge`),Ye!==void 0&&(b.owner_step=S(Ye,"--owner-step")),jo&&delete b.owner_step,kt!==void 0&&!b.owner_step&&d(`--check goes with an owner step, which ${t} doesn't have: pass --owner-step "<the step>" with it on builder done or land`),kt&&(b.owner_check={check:kt,since:b.owner_check?.check===kt?b.owner_check.since:new Date().toISOString()}),(kt===""||!b.owner_step)&&delete b.owner_check;const pn=await Promise.all((await G(Be.dir,b.id)).map(R=>$(R,null))),Ao=vn(b,pn);if(je!==void 0&&(b.title=S(je,"--title")),Qi(b,{size:Bt,model:mt}),L!==void 0){const R=await sa(e,F(t).file,L,t);R.length?b.deps=R:delete b.deps}const ya=T===""?b.blocked_until:void 0;if(T!==void 0&&(T===""?delete b.blocked_until:b.blocked_until=S(T,"--blocked-until")),M&&(!b.deps?.length&&!b.blocked_until&&d("--block-reason goes with a block: --deps or --blocked-until"),b.block_reason=S(M,"--block-reason")),(M===""||!b.deps?.length&&!b.blocked_until)&&delete b.block_reason,C!==void 0){const R=await Yi(e,F(t).file,t,C);R?b.parent=R:delete b.parent}const xa=C!==void 0||Y!==void 0||te!==void 0||V!==void 0?await ra(e,t):null;let mn=Y===void 0?null:await Hr(e,t,b,Y);te!==void 0&&(b.related=[...new Set([...(b.related||[]).map(R=>J(F(t).file,R)),...await on(e,t,te,"--relate")])]),V!==void 0&&(mn=await Jr(e,t,b,await on(e,t,V,"--unrelate"))),bt!==void 0&&an(b,bt),p&&b.held&&d(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`);const yt=m!==void 0||k!==void 0||_!==void 0;if((p||s||w||yt)&&(Ur(b),delete b.recheck_at),p){const R=await Ee(e,F(t).file,b);R.length&&d(`${t} is blocked by ${R.join(", ")}; start it once ${R.length===1?"that is":"those are"} done`),b.blocked_until&&d(`${t} is blocked until ${b.blocked_until}; start it once that holds and the block is cleared with --blocked-until ""`)}const It=p&&e?await ia(e,t):null;It&&d(`${t} has no take picked: the owner's answer to ${It.id} picks none${It.note?` ("${jr(It.note)}")`:""}, so it prototypes again: draw the next round from that note, or grill when the note asks a question, and build once a take is picked`);const Po=s?await Ci(e,t,"--done",ht):async()=>[],xt=s?qr(e,t,l,ie,se(e,Xe),ne):null;if(l&&Mr(b,l,se(e,Xe)),f!==void 0&&(Li(b,f,await aa(e,t)),await Hi(e,t,b,b.next)),h&&(delete b.next,delete b.next_at,delete b.next_on_questions),p&&f===void 0&&b.next_on_questions&&(delete b.next,delete b.next_at,delete b.next_on_questions),yt&&!b.review_since&&(b.review_since=new Date().toISOString()),m!==void 0&&Dr(b,m,se(e,Xe)),k!==void 0){ge().find(R=>Pe(R.dir,D(e)))?.remote||d("--pushed is for a board whose repo is a plain git remote; on GitHub, open a PR and pass --pr"),be(b)&&d(`${t} has a PR; its PR says when it merges`);try{ws(k)}catch{d("--pushed takes the name of the branch you pushed")}b.pushed={branch:k,at:new Date().toISOString()},b.branch=k}if(_!==void 0&&(b.merge_ready={branch:_,at:new Date().toISOString()},b.branch=_),s&&delete b.merge_ready,N!==void 0&&((typeof N!="string"||!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$/.test(N)||Number.isNaN(Date.parse(N)))&&d("--gh-since takes an ISO-8601 UTC time such as 2026-10-23T11:00:00Z"),b.gh_since=N),X&&(b.from_ask=X),O==="ready"&&e){const R=(await fe(e,t)).asked.filter(Ae=>Ae.state==="open").map(Ae=>Ae.id);R.length&&d(`${t} has ${R.length===1?"an open question":"open questions"} ${R.join(", ")}; it is ready once the owner has answered ${R.length===1?"it":"them"}`),await Cr(e,t,Be.dir,b)}const hn=O==="ready"&&b.phase==="staging"&&v===void 0;hn&&ie===void 0&&d(`${t} goes ready from staging on your judgment: pass --text "<what you checked it against on the board>", which goes into its notes`);const gn=O==="ready"&&b.phase==="ready"&&!!b.recheck_at&&v===void 0;gn&&ie===void 0&&d(`${t}'s block ended, so it builds once you re-check its notes against what landed: pass --text "<what you re-checked>", which goes into its notes`),O==="ready"&&!hn&&!gn&&ie!==void 0&&v===void 0&&!s&&d(`${t} reads ${b.phase||"no phase"}, not staging, so there is no judgment for --text to record`);const Do=O==="ready"&&b.phase!=="ready";O!==void 0&&(O!=="ready"&&["staging","ready"].includes(b.phase)&&(b.round_at=new Date().toISOString()),b.phase=O,delete b.recheck_at,delete b.staged_at,delete b.unfiled,delete b.filed_held),b.phase==="ready"&&Pr.test(b.next??"")&&d(`${t} would read ready with Next "${b.next}", which asks for the phase it is already in; pass --next with what happens next, or --clear-next`),Ct&&(b.install=Ct),Ct===null&&delete b.install,!Ao&&!p&&vn(b,pn)&&d(`that leaves ${t} In Progress with nothing building and no Next; pass --next "<what happens next>"`);const $n=(L!==void 0||T)&&!s&&Nr(b,pn)?await tn(e,t,b):"",_a=se(e,Xe);let kn=null;const bn=r((R,Ae)=>{b.lane!==R&&Ft(b,R,void 0,Ti(b,R,u))!==void 0&&Ae&&(kn=`Moved to ${Ce[R]}: ${Ae}`)},"moveTo");if(s?bn("done",null):yt&&b.lane!=="done"?bn("review",m!==void 0?`PR ${at([].concat(m).map(Fn),_a)} opened`:k!==void 0?`${k} pushed for its merge`:"verified, it waits for your Merge"):p&&!K(b)&&bn("progress","a build started"),a&&b.ticket&&d(`${t} already has ticket ${b.ticket}`),(n!==void 0||a)&&await to(e,Xe,b,n,ka,Be.dir),await y(Be.file,Xe),kn&&await le(Z(e,t),{ts:b.lane_at,who:"claude",kind:Pa,text:kn}),hn&&await Re(e,t,`Ready (orchestrator, ${Qe()})`,ie),gn&&await Re(e,t,`Re-checked (orchestrator, ${Qe()})`,ie),Do&&await Je(e,t,{command:"readied"}),$n){const R=e&&!await _o(e,t)&&await xo(e,t,{cause:"blocked",words:`blocked ${$n}`});await W(e,t,R?"blocked-pausing":"blocked-stays",{blocked:$n})}mn&&await mn(),xa&&await eo(e,t,xa,await ra(e,t));const Oe=await Po();if(O==="ready"&&e&&Oe.push(...await en(e,t,"Recorded in the card's notes")),p&&Oe.push(...await en(e,t,"Acted on: build started")),X&&Oe.push(...(await rt(e,t,{text:ie})).lines),xt&&e){const R=$a?await Je(e,t,{command:$a,text:xt.text,who:fn,by:pe}):xt.status?await W(e,t,...xt.status):await rt(e,t,{text:xt.text});Oe.push(...R.lines)}const Sa=b.owner_step&&s?null:rs({start:p,done:s,handover:yt}),va=Sa&&await cs(await sn(e),b,Sa,{...ka,repo:_a});va&&Oe.push(va),(yt||s||w)&&(await vo(Be.dir,b.id,s,w?{handedBack:new Date().toISOString()}:{endHandBack:!0}),await ut(e,t));const yn=X?await _e(e):{};if(ae(yn,X)!==void 0&&(delete yn[X],await y(xe(e),{links:yn})),ya&&!K(b)&&!(await Ee(e,F(t).file,b)).length){const{line:R}=await W(e,t,"unblocked",{lifted:ya});await oa(e,t,R.ts),await he({dir:e},"card-unblocked",{key:t}),Oe.unshift(`unblocked: ${t}`)}if(!s||wn)return{file:Be.file,lines:Oe};$t&&await Lr(e,t,$t);const ja=await Rr(e,t),Fo=await H(e,t);for(const R of ja){const{line:Ae}=await W(e,R,"unblocked-done",{card:Fo});await oa(e,R,Ae.ts),await he({dir:e},"card-unblocked",{key:R})}return{file:Be.file,lines:[...ja.map(R=>`unblocked: ${R}`),...Oe]}}r(Ki,"changeItem");function Qi(e,{size:t,model:n}){for(const[a,i,o]of[["size",t,["small","large"]],["model",n,["opus","sonnet"]]])i!==void 0&&(i===""?delete e[a]:e[a]=o.includes(i)?i:d(`--${a} takes ${o.join(" or ")}, or "" to clear it`))}r(Qi,"setBuildChoice");function Gi({held:e,unheld:t,pickUpAt:n}){return[e,t,n!==void 0].filter(Boolean).length>1&&d("pass one of --held, --unheld and --pick-up-at"),n!==void 0?n===""?null:{until:Wr(n)}:e?{until:null}:t?null:void 0}r(Gi,"holdOf");function Wr(e){const t=typeof e=="string"&&os.test(e)?Date.parse(e):NaN;return Number.isNaN(t)&&d('--pick-up-at takes an ISO time such as 2026-11-04T09:00, the host\u2019s local time unless it names an offset, or "" to resume the card'),t<=Date.now()&&d(`--pick-up-at ${e} has passed; pass a later time, or --unheld to resume the card now`),new Date(t).toISOString()}r(Wr,"pickUpTime");function Ur(e){delete e.held,delete e.pick_up_at}r(Ur,"clearHold");function an(e,t){t?e.held=!0:delete e.held,t?.until?e.pick_up_at=t.until:delete e.pick_up_at,e.held_at=new Date().toISOString()}r(an,"setHold");async function ud(e,t,n,{announce:a=!0}={}){const{source:i,itemFile:o,item:s}=await x(e,t);if(a){const c=new Date(n).toLocaleString("en-US",{weekday:"short",month:"numeric",day:"numeric",hour:"numeric",minute:"2-digit"});await W(e,t,"hold-ended",{at:c}),!s.blocked_until&&!(await Ee(e,F(t).file,s)).length&&await he({dir:e},"card-unblocked",{key:t,until:n})}an(s,null),await y(i.file,o)}r(ud,"pickUp");async function Vi(e,t,n){const a=String(n?.key||""),{file:i,id:o}=F(a),{source:s,itemFile:c}=await Ue(e,i),l=n.shared_by?n.shared_by.name||n.shared_by.login:void 0,u={text:qt.done,who:"love",by:l,command:"done"},p=c.items.find(m=>m.id===o)||d(`item file "${i}" has no item "${o}"`);if(!(t==="card-done"&&!!p.owner_step)&&p.lane==="done")return null;if(t==="card-done")return $e(e,a,{done:!0,force:!0,ownerDone:!0,...u});const f=n.hold?typeof n.until=="string"?new Date(n.until).toISOString():null:void 0;an(p,n.hold?{until:f}:null),await y(s.file,c),n.hold&&(await _o(e,a)||await xo(e,a,{cause:"held",words:"held"}),await vo(s.dir,o,!1,{held:!0}),await ut(e,a));const h=f&&new Date(f).toLocaleString("en-US",{weekday:"short",month:"numeric",day:"numeric",hour:"numeric",minute:"2-digit"});return Je(e,a,n.hold?{text:h?`${qt.hold} until ${h}`:qt.hold,who:"love",by:l,command:"hold"}:{who:"love",by:l,command:"resume"})}r(Vi,"recordOwnerTap");function Zi(e){try{return Ps(As(e))}catch(t){return d(t.message)}}r(Zi,"checkSpec");async function fd(e,t,n,a){const{item:i}=await x(e,t);return!i.owner_step||i.owner_check?.check!==n?null:$e(e,t,{done:!0,force:!0,ownerDone:!0,closing:["check-passed",{found:a}]})}r(fd,"passOwnerCheck");async function wd(e,t,n,a){const{source:i,itemFile:o,item:s}=await x(e,t);return!s.owner_step||s.owner_check?.check!==n?!1:(s.owner_check.broken=a,await y(i.file,o),await W(e,t,"check-broken",{error:a}),await he({dir:e},"owner-check-broken",{key:t,check:n,error:a}),!0)}r(wd,"breakOwnerCheck");async function sa(e,t,n,a){const i=[...new Set(String(n).split(",").map(o=>o.trim()).filter(Boolean))];for(const o of i){const s=o.match(Ge)?.[1];if(!s){await x(e,J(t,o));continue}(await wt(e,t,[o])).includes(a)&&d(`${a} is in the wave "${s}", so it would wait on itself`)}return i}r(sa,"depList");async function Yi(e,t,n,a){if(!String(a).trim())return null;const i=J(t,String(a).trim());i===n&&d("--parent: a card can't be its own Parent");for(let o=i;o;){const s=o===i?await x(e,o):await x(e,o).catch(l=>{if(l instanceof ue)return null;throw l});if(!s)break;const{item:c}=s;c.parent&&J(F(o).file,c.parent)===n&&d(`--parent: ${i} is a child of ${n}, so it can't be its Parent`),o=c.parent?J(F(o).file,c.parent):null}return i}r(Yi,"parentKey");async function on(e,t,n,a){const i=t.split("/")[0],o=[...new Set(String(n).split(",").map(s=>s.trim()).filter(Boolean).map(s=>J(i,s)))];o.includes(t)&&d(`${a}: a card can't be related to itself`);for(const s of o)await x(e,s);return o}r(on,"relatedKeys");const Xi=r((e,t,n)=>async()=>{for(const a of await q(e)){const i=await $(a.file,null);let o=!1;for(const s of Array.isArray(i?.items)?i.items:[]){const c=`${a.slug}/${s.id}`;c===t||!n(c)||!(s.related||[]).some(l=>J(a.slug,l)===t)||(s.related=s.related.filter(l=>J(a.slug,l)!==t),s.related.length||delete s.related,o=!0)}o&&await y(a.file,i)}},"dropLinksTo");async function ra(e,t){const n=new Set;let a=null;for(const i of await q(e))for(const o of(await $(i.file,null))?.items||[]){const s=`${i.slug}/${o.id}`,c=(o.related||[]).map(l=>J(i.slug,l));s===t?(c.forEach(l=>n.add(l)),o.parent&&(a=J(i.slug,o.parent))):c.includes(t)&&n.add(s)}return{related:n,parent:a}}r(ra,"linksOf");async function eo(e,t,n,a){const i=r(async(o,s,c=o,l=o)=>{await Je(e,t,{command:c,card:s}),await Je(e,s,{command:l,card:t})},"both");for(const o of a.related)n.related.has(o)||await i("related",o);for(const o of n.related)a.related.has(o)||await i("unrelated",o);a.parent&&a.parent!==n.parent&&await i("followup-of",a.parent,"followup-of","followup")}r(eo,"postLinkLines");async function Hr(e,t,n,a){const i=await on(e,t,a,"--related");return i.length?n.related=i:delete n.related,Xi(e,t,o=>!i.includes(o))}r(Hr,"setRelated");function Jr(e,t,n,a){const i=(n.related||[]).filter(o=>!a.includes(J(F(t).file,o)));return i.length?n.related=i:delete n.related,Xi(e,t,o=>a.includes(o))}r(Jr,"unrelateCards");const se=r((e,t)=>e&&ge().find(n=>Pe(n.dir,e))?.github||t.repo,"boardRepoOf");async function pd(e,t){const{itemFile:n,item:a}=await x(e,t);be(a)||d(`${t} has no PR`);const i=Me(a,se(e,n));i.length||d(`${t} has no repo`);const o=a.gh_since||"1970-01-01T00:00:00Z";try{const s=Se(await oe(e)).github_login||await ks();return await Promise.all(i.map(async({repo:c,number:l})=>({repo:c,...Ta(await Ia({repo:c,pr:l,since:o}),{pr:l,since:o,me:s})})))}catch(s){d(s.message)}}r(pd,"prReport");async function md(e,t,{replyTo:n,body:a}){const i=n===void 0?"pr comment":"pr reply",o=Fn(t)||d(`${i} takes a PR number or owner/repo#<n>`);n!==void 0&&!/^[1-9]\d*$/.test(n)&&d("pr reply takes the id of the review comment it answers");const s=S(a,"--body").trim();(s.startsWith(St.trim())||s.includes(Dn))&&d(`${i} adds the ${St.trim()} prefix and the claude-bridge marker itself; pass only your words`);const c=o.repo||se(D(e),{})||d(`${i} needs a board on GitHub; this board has no repo there`);try{const l=await bs({repo:c,pr:o.number,replyTo:n,words:s,login:Se(await oe(e)).github_login}),u=await ui(e,vt({repo:c,number:o.number}),"comment",`Comment on #${o.number}: ${s}`);return{lines:[`posted on PR ${o.repo?t:`#${t}`}: ${l}`,...u.length?[`queued for ${u.join(", ")}'s Slack thread`]:[]]}}catch(l){d(l.message)}}r(md,"postPR");const sn=r(async e=>gi((await oe(e)).tickets),"boardSource");async function hd(e,t,{afterApproval:n,confirmed:a,tapped:i}={}){D(e);const{itemFile:o,item:s}=await x(e,t);be(s)||d(`${t} has no PR`),K(s)&&d(`${t} is done`);const c=await tn(e,t,s);c&&(i&&await W(e,t,"merge-blocked",{blocked:c}),d(`Not merged: blocked ${c}.`));const l=se(e,o),u=Me(s,l);u.length||d(`${t} has no repo`);const p=new Date().toISOString(),w=r(P=>W(e,t,"gh-limited",{what:"Not merged",words:Io(P)}),"limited");let f;try{f=await Promise.all(u.map(P=>Ia({repo:P.repo,pr:P.number,since:p})))}catch(P){P.limited&&await w(P.limited),d(P.message)}const h=f.map(({view:P})=>P);if(_s(h)){const P=u.map((L,T)=>({...L,at:h[T].mergedAt})).filter((L,T)=>h[T].state==="MERGED");return $e(e,t,{merged:P,closing:["already-merged",{prs:at(P,l),many:P.length>1}]})}const m=u.map((P,L)=>({...P,...f[L]})).filter(({view:P})=>P.state==="OPEN"),k=Rn(o,(await oe(e)).reviewers||[]).length>0,_=[];let N=!1,v=!1;for(const P of m){const{view:L,reviews:T}=P,{failing:M,pending:C}=Ta(P,{pr:P.number,since:p,me:null}),Y=Wo({...L,checks:{state:M.length?"fail":C?"pending":"pass",failing:M,pending:C}},{needsApproval:k}),te=T.filter(Q=>Q.state==="APPROVED").sort((Q,Ze)=>String(Q.submitted_at).localeCompare(String(Ze.submitted_at))).at(-1)?.commit_id;let V=!!(te&&L.headRefOid&&te!==L.headRefOid);V&&n===void 0&&sc(s,te,L.headRefOid)&&(V=!1,v=!0),N||=V,V&&n===void 0&&Y.push('commits after the approval: pass --after-approval "<why they are trivial>" when they are, else ask the approver to look again'),_.push(...u.length>1?Y.map(Q=>`${at([P],l)} ${Q}`):Y)}m.length||_.push(u.length>1?"every PR is closed":"PR is closed"),n!==void 0&&!N&&d("--after-approval: no commit came after the approval; drop it");const O=s.manual_steps?.length?a===void 0?null:await Ii(e,a,"--confirmed"):void 0;if(a!==void 0&&O===void 0&&d(`--confirmed: ${t} has no manual steps; drop it`),O===null&&_.push(`manual steps: merge only on the owner's word, with --confirmed "<their words>"`),_.length){const P=`Not merged: ${_.join("; ")}.`;i&&await W(e,t,"merge-refused",{why:_.join("; ")}),d(P)}const A=[];for(const P of m){const L=await Co(["pr","merge",String(P.number),"--repo",P.repo,"--squash"],{timeout:12e4});L.limited&&await w(L.limited),L.status!==0&&d(`gh pr merge ${at([P],l)} failed: ${L.stderr.trim().split(`
26
+ `)[0]||`gh exited ${L.status}`}${A.length?` (merged ${at(A,l)} before it)`:""}`),A.push(P)}const I=[n!==void 0&&`After the approval: ${S(n,"--after-approval")}`,v&&`After the approval: only the board's rebase onto ${s.rebased.at(-1).base}.`,O&&`The owner's word on the manual steps: "${O}"`].filter(Boolean),B=await $e(e,t,{merged:A});return I.length&&await rt(e,t,{text:I.join(" ")}),B}r(hd,"mergeCard");async function gd(e,t){return(await x(e,t)).item.merge_ready||null}r(gd,"heldMerge");async function $d(e,t){const{source:n,itemFile:a,item:i}=await x(e,t);(!i.merge_ready||K(i))&&d(`${t} isn't waiting for its Merge`);const o=await tn(e,t,i);return o&&d(`${t} is blocked ${o}, so its Merge waits until nothing blocks it`),i.merge_ready.tapped=new Date().toISOString(),await y(n.file,a),i.merge_ready}r($d,"tapMerge");async function kd(e,t){const{source:n,item:a}=await x(e,t);return(await Promise.all((await G(n.dir,a.id)).map(o=>$(o,null)))).filter(o=>o?.worktree?.path).sort((o,s)=>String(s.started).localeCompare(String(o.started)))[0]?.model}r(kd,"builderModel");async function to(e,t,n,a,i,o,s){const c=await sn(e)||d(zr);try{s??=a===void 0&&n.plan?await j.readFile(await nn(o,n.plan),"utf8"):n.notes||"";const l=await ss(c,{ticket:a,title:n.title,body:s,repo:se(e,t)},i);n.ticket=l.ticket,l.created?n.ticket_created=!0:delete n.ticket_created}catch(l){if(l instanceof ue)throw l;d(l.message)}}r(to,"assignTicket");const zr="this board has no ticket source, so its cards stay tasks; pick GitHub issues or Linear in Board settings first";async function no(e){const t=[],n=[];for(const a of await q(e)){const i=await $(a.file,{});t.push(...(i.items||[]).map(o=>o.id)),n.push(Number(i.last_task)||0)}return e&&t.push(...(await Le(e)).map(a=>a.item?.id)),`T-${Math.max(0,...n,...t.map(a=>Number(/^T-([1-9]\d*)$/.exec(String(a))?.[1]||0)))+1}`}r(no,"nextTaskId");const ce=r((e,t)=>nt(g.join(e||Ut(),"tickets"),t,{heartbeat:!0}),"ticketWrite"),$e=r((e,t,n,a)=>n.ticket!==void 0||n.newTicket?ce(e,()=>Ki(e,t,n,a)):Ki(e,t,n,a),"setItem"),bd=r((e,t,n,a)=>ce(e,()=>Kr(e,t,n,a)),"addItem");async function Kr(e,t,{title:n,notes:a,notesFrom:i,deps:o,ticket:s,newTicket:c,pickUpAt:l,held:u,parent:p,size:w,model:f,phase:h,state:m,relate:k,fromAsk:_,text:N,intake:v=!1},O){const{file:A,id:I}=t.includes("/")?F(t):{file:t};I!==void 0&&Fe(I,"the item id"),Wi(h,m),N!==void 0&&S(N,"--text"),N!==void 0&&_===void 0&&d("--text goes with --from-ask"),_!==void 0&&N===void 0&&d(`--from-ask needs --text "<first line>", the item's first thread line after the ask`),s!==void 0&&c&&d("pass --ticket <id> to link a ticket or --new-ticket to make one, not both");const B=_===void 0?void 0:await Dt(e,_);B&&await Wn(e,B),B&&await oi(e,B);const P=Gi({held:u,pickUpAt:l});P&&h!==void 0&&d("a card filed held is filed New and takes no --phase; drop --phase, or drop --held to file it in a phase"),B&&h===void 0&&!P&&d("--from-ask files a card, which reads New until it has a phase: pass --phase grilling, prototyping, or ready for a Quick build ask, or --held to file it for later"),h==="ready"&&!(B&&await Ui(e,B))&&d(B?`ask "${B}" is not a Quick build ask, so item add files it grilling or prototyping`:"item add files a card grilling or prototyping; ready is for a Quick build ask, filed with --from-ask"),h==="ready"&&!w&&d("a new ready card has no size; a builder starts from it, so pass --size small or large with --phase ready"),h==="ready"&&!(a??"").trim()&&i===void 0&&d("a new ready card has no notes; a builder starts from them, so pass --notes or --notes-from with --phase ready"),v&&e&&h===void 0&&!P&&d("item add files a card on a board: pass --phase grilling or prototyping, or --held to file it for later");const{source:L,itemFile:T}=await Ue(e,A);I!==void 0&&T.items.some(Q=>Q.id===I)&&d(`item file "${A}" already has an item "${I}"`);const M=new Date().toISOString(),C={id:I,title:S(n,"--title"),created:M,lane:"todo",lane_at:M};p!==void 0&&(C.parent=await Yi(e,A,null,p)||d("--parent takes a card, such as <file>/<id>")),a!==void 0&&i!==void 0&&d("pass --notes or --notes-from, not both");const Y=i!==void 0?await Di(e,i,"--notes-from",()=>`${ta}, and link that card with --relate`):a===void 0?"":S(a,"--notes");i!==void 0&&!Y.trim()&&d(`--notes-from ${i} is empty`);const te=i!==void 0?Y:`# ${C.title}
27
+ ${Y&&`
28
+ ${Y}
29
+ `}`;Qi(C,{size:w,model:f}),o!==void 0&&(C.deps=await sa(e,A,o)),P&&an(C,P),P&&h===void 0&&(C.filed_held=!0),k!==void 0&&(C.related=await on(e,t,k,"--relate")),B&&(C.from_ask=B),h!==void 0&&(C.phase=h),(s!==void 0||c)&&await to(e,T,C,s,O,L.dir,Y),I===void 0&&C.ticket?(C.id=ls(C.ticket),T.items.some(Q=>Q.id===C.id)&&d(`item file "${A}" already has an item "${C.id}"; link ${C.ticket} with item add ${A}/<id> --ticket ${C.ticket}`)):I===void 0&&(C.id=await no(e)),C.plan=Zt(L.dir,C.id),await Yt(g.join(L.dir,C.plan),te);const V=`${A}/${C.id}`;if(T.items.push(C),await y(L.file,T),B){await rt(e,V,{text:N});const Q=await _e(e);ae(Q,B)!==void 0&&(delete Q[B],await y(xe(e),{links:Q}))}return e&&await eo(e,V,{related:new Set,parent:null},await ra(e,V)),{file:L.file,key:V,lines:[]}}r(Kr,"createItem");const yd=r(e=>ce(e,async()=>{const t=[];for(const n of await q(e)){const a=await $(n.file,null);if(!Array.isArray(a?.items)||!Array.isArray(a.followups))continue;const i=a.followups.find(l=>a.items.some(u=>u.id===l.id));i&&d(`${n.slug}: follow-up ${i.id} has the id of a card; rename one, then restart the board`);const o=[];for(const{id:l,title:u,from:p,filed:w,done:f,...h}of a.followups){const m=f?e&&(await z(Z(e,`${n.slug}/${l}`))).map(k=>k.ts).filter(Boolean).sort().pop()||w:null;o.push({id:l,title:u,...w?{created:w}:{},...p?{parent:J(n.slug,p)}:{},...f?{lane:"done",...m?{lane_at:m,closed_at:m}:{}}:{},...h})}const{followups:s,...c}=a;await y(n.file,{...c,items:[...a.items,...o]}),t.push(`${n.slug}: ${o.length} follow-ups moved to cards (${o.filter(l=>l.lane==="done").length} done)`)}return t}),"migrateFollowups");function ao(e,t=[]){if(e.status===void 0&&e.status_at===void 0&&e.merged_at===void 0)return!1;const n=e.merged_at||e.status_at||new Date().toISOString();["merged","done","dropped"].includes(e.status)&&Object.assign(e,{lane:"done",lane_at:n,closed_at:n}),(e.status==="merged"||e.merged_at)&&(e.prs=De(e).map(i=>({...i,merged_at:i.merged_at||n})),delete e.pr),e.status==="held"&&(e.held=!0);const a=t.filter(i=>i.started&&et(i)).sort((i,o)=>String(i.started).localeCompare(String(o.started))).at(-1);return e.status==="checking"&&a&&(a.handed_back=n),delete e.status,delete e.status_at,delete e.merged_at,!0}r(ao,"statusToFacts");const xd=r(e=>ce(e,async()=>{const t=[];for(const n of await q(e)){const a=await $(n.file,null);let i=0;for(const o of Array.isArray(a?.items)?a.items:[]){const s=o.status==="checking"?await G(n.dir,o.id):[],c=await Promise.all(s.map(l=>$(l,null)));if(ao(o,c.filter(Boolean))){i++;for(const[l,u]of c.entries())u?.handed_back&&await y(s[l],u)}}i&&(await y(n.file,a),t.push(`${n.slug}: ${i} cards' statuses became lanes and facts`))}return await Nt(e,async()=>{const n=await Le(e),a=n.filter(i=>i.item&&ao(i.item)).length;a&&(await Rt(e,n),t.push(`archive: ${a} cards' statuses became lanes and facts`))}),t}),"migrateStatuses");function io(e,t){const n=e.lane==="done"&&!_n.done.includes(e.phase);if(!("state"in e)&&!n)return!1;if("state"in e&&e.state!==void 0&&(e.phase=e.state),delete e.state,n){const a=De(e);e.phase=a.some(i=>i.merged_at)||!a.length&&t?"merged":"closed"}return!0}r(io,"stateToPhase");const _d=r(e=>ce(e,async()=>{const t=[],n=await q(e),a=r(async(i,o)=>!!i&&o.lane==="done"&&(await Promise.all((await G(i,o.id)).map(s=>$(s,null)))).some(s=>s?.started&&et(s)),"built");for(const i of n){const o=await $(i.file,null);let s=0;for(const c of Array.isArray(o?.items)?o.items:[])io(c,await a(i.dir,c))&&s++;s&&(await y(i.file,o),t.push(`${i.slug}: ${s} cards' states became phases`))}return await Nt(e,async()=>{const i=await Le(e);let o=0;for(const s of i)s.item&&io(s.item,await a(n.find(c=>c.slug===(s.file||F(s.key).file))?.dir,s.item))&&o++;o&&(await Rt(e,i),t.push(`archive: ${o} cards' states became phases`))}),t}),"migratePhases"),Sd=r(e=>ce(e,async()=>{const t=[];for(const n of await q(e)){const a=await $(n.file,null),i=(Array.isArray(a?.items)?a.items:[]).filter(o=>o.implement_at);if(i.length){for(const o of i)o.phase!=="ready"&&Object.assign(o,{phase:"staging",staged_at:o.implement_at}),delete o.implement_at;await y(n.file,a),t.push(`${n.slug}: ${i.length} Implement asks moved to staging or ready`)}}return t}),"stageImplementAsks"),rn=r(e=>g.join(e,"data","done-archive.json"),"archiveFile"),Nt=r((e,t)=>nt(g.join(e,"done-archive"),t,{heartbeat:!0}),"archiveWrite"),Le=r(async e=>(await $(rn(e),{cards:[]})).cards||[],"readArchive"),cn=r(e=>`${e.closed_at||""}|${e.key}`,"archiveRank"),Qr=r((e,t)=>cn(e)<cn(t)?1:cn(e)>cn(t)?-1:0,"byClosed"),ca=r(e=>g.join(e,"data","done-archive-count.json"),"archiveCountFile");async function vd(e){const t=(await $(ca(e),null))?.count;if(Number.isInteger(t))return t;const n=(await Le(e)).length;return await y(ca(e),{count:n}),n}r(vd,"archiveCount");async function Rt(e,t){t.length?await y(rn(e),{cards:t.sort(Qr)}):await j.rm(rn(e),{force:!0}),await y(ca(e),{count:t.length})}r(Rt,"writeArchive");const jd=r((e,t)=>Nt(e,async()=>{const n=new Map(t.map(w=>[w.key,w])),a=new Date().toISOString(),i=[],o=[];for(const w of await q(e)){const f=await $(w.file,null);if(!Array.isArray(f?.items))continue;const h=f.items.filter(m=>n.has(`${w.slug}/${m.id}`)&&m.lane==="done");if(h.length){for(const m of h){const k=n.get(`${w.slug}/${m.id}`);i.push({...k,file:w.slug,archived_at:a,item:k.prs?Gr(m,k.prs):m})}o.push([w.file,{...f,items:f.items.filter(m=>!h.includes(m))}])}}if(!i.length)return[];const s=await $(E(e),{items:[]}),c=new Map(i.map(w=>[`item:${w.key}`,w]));for(const w of i)w.questions=(s.items||[]).filter(f=>f.topic===`item:${w.key}`&&f.resolved);const l=await _e(e);for(const w of i)w.asks=w.item.from_ask&&ae(l,w.item.from_ask)===void 0?[w.item.from_ask]:[];const u=new Set(i.map(w=>w.key));await Rt(e,[...(await Le(e)).filter(w=>!u.has(w.key)),...i.map(({key:w,file:f,archived_at:h,closed_at:m,item:k,questions:_,asks:N})=>({key:w,file:f,archived_at:h,closed_at:m,item:k,questions:_,asks:N}))]),i.some(w=>w.asks.length)&&await y(xe(e),{links:{...l,...Object.fromEntries(i.flatMap(w=>w.asks.map(f=>[f,w.key])))}});for(const[w,f]of o)await y(w,f);const p=(s.items||[]).filter(w=>!(c.has(w.topic)&&w.resolved));return p.length!==(s.items||[]).length&&await y(E(e),{...s,items:p}),[...u]}),"archiveCards");function Gr(e,t){if(!be(e))return e;const n=De(e).map(o=>{const s=t.find(c=>c.state&&c.number===o.number&&(!o.repo||o.repo===c.repo));return s?{...o,kept:{checks:s.checks,reviews:s.reviews,codexOpen:s.codexOpen}}:o}),{pr:a,...i}=e;return{...i,prs:n}}r(Gr,"keptPRs");async function Vr(e,t){return!e||!de(rn(e))?!1:Nt(e,async()=>{const n=await Le(e),a=n.find(w=>w.key===t);if(!a)return!1;const i=(await q(e)).find(w=>w.slug===a.file),o=i&&await $(i.file,null);if(!Array.isArray(o?.items))return!1;o.items.some(w=>w.id===a.item.id)||await y(i.file,{...o,items:[...o.items,a.item]});const s=await $(E(e),{items:[]}),c=new Set((s.items||[]).map(w=>w.id)),l=(a.questions||[]).filter(w=>!c.has(w.id));l.length&&await y(E(e),{...s,items:[...s.items||[],...l]});const u=await _e(e),p=(a.asks||[]).filter(w=>ae(u,w)===t);return p.length&&await y(xe(e),{links:Object.fromEntries(Object.entries(u).filter(([w])=>!p.includes(w)))}),await Rt(e,n.filter(w=>w!==a)),!0})}r(Vr,"restoreArchived");const oo=["push_tag","no_change"],so=r(e=>Object.fromEntries(Object.entries(e).filter(([t])=>!oo.includes(t))),"stripQuestion"),ro=r(({summary:e,...t})=>t,"stripItem"),co=r(e=>oo.some(t=>t in e),"holdsDead"),Od=r(e=>Nt(e,async()=>{for(const a of await q(e)){const i=await $(a.file,null);Array.isArray(i?.items)&&i.items.some(o=>"summary"in o)&&await y(a.file,{...i,items:i.items.map(ro)})}const t=await $(E(e),null);(t?.items||[]).some(co)&&await y(E(e),{...t,items:t.items.map(so)});const n=await Le(e);n.some(a=>"card"in a||"summary"in a.item||(a.questions||[]).some(co))&&await Rt(e,n.map(({card:a,...i})=>({...i,...a?{closed_at:i.closed_at||a.sortAt}:{},item:ro(i.item),questions:(i.questions||[]).map(so)})))}),"stripDeadFields");async function Ad(){return Vo(async()=>{const e=Go(),t=Array.isArray(e.migrated)?e.migrated:[];if(t.includes("wave-names")||!Object.keys(e.sites||{}).length)return[];const n=[];for(const{route:a,dir:i}of ge(e))await Zr(i),n.push(a);return e.migrated=[...t,"wave-names"],await Zo(e),n})}r(Ad,"migrateWaveNames");const lo=r(async e=>JSON.parse(await j.readFile(e,"utf8")),"readPlain"),la=r((e,t)=>We(e,JSON.stringify(t,null,2)+`
30
+ `),"writePlain"),uo=r(e=>typeof e!="string"?e:e.replace(/^wave:([a-z0-9-]+)$/,"file:$1").replace(/^lineup:([a-z0-9-]+)$/,"wave:$1"),"renamedTopic"),da=r(e=>Array.isArray(e)?e.map(da):e&&typeof e=="object"?Object.fromEntries(Object.entries(e).map(([t,n])=>[uo(t),da(n)])):uo(e),"renameTopics");async function Zr(e){const t=g.join(e,"board.json"),n=await lo(t).catch(()=>null);if(n&&typeof n.items=="string"&&n.items!=="waves"&&g.basename(n.items)==="wave.json"){const i=g.join(g.dirname(n.items),"items.json");de(g.resolve(e,n.items))&&await j.rename(g.resolve(e,n.items),g.resolve(e,i)),await la(t,{...n,items:i,slug:n.slug||"wave"})}for(const i of await q(e)){const o=await lo(i.file).catch(()=>null);if(!Array.isArray(o?.lineups))continue;const{lineups:s,...c}=o;await la(i.file,{...c,waves:[...c.waves||[],...s]});for(const{slug:l}of s)await j.rename(g.join(i.dir,`lineup-${l}.md`),g.join(i.dir,ua(l))).catch(u=>{if(u.code!=="ENOENT")throw u})}const a=g.join(e,"data");for(const i of(await j.readdir(a).catch(()=>[])).filter(o=>o.endsWith(".json"))){const o=g.join(a,i),s=await j.readFile(o,"utf8");let c;try{c=JSON.parse(s)}catch{continue}c=da(c),i==="done-archive.json"&&Array.isArray(c.cards)&&(c.cards=c.cards.map(({wave:l,...u})=>l===void 0?u:{...u,file:l})),i==="arch-reviews.json"&&Array.isArray(c.reviews)&&(c.reviews=c.reviews.map(({wave:l,lineup:u,...p})=>u?{...p,wave:l}:{...p,file:l})),JSON.stringify(c)!==JSON.stringify(JSON.parse(s))&&await la(o,c)}}r(Zr,"renameWaveNames");const ua=r(e=>`wave-${e}.md`,"waveNoteFile"),Yr=r(e=>typeof e=="string"&&/^[a-z0-9-]+$/.test(e)?e:d(`a wave's slug uses only a-z, 0-9 and "-", not "${e}"`),"waveSlug");async function pt(e,t){for(const n of await q(e)){const a=await $(n.file,null),i=(a?.waves||[]).find(o=>o.slug===t);if(i)return{source:n,itemFile:a,wave:i}}return d(`this board has no wave "${t}"; wave create makes one`)}r(pt,"findWave");async function Xr(e,t){(await oe(e)).items!=="waves"&&d(`topic file:${t} is for a board over ~/.claude/waves; a wave's triage uses wave:<slug>`),await Ue(e,t)}r(Xr,"triagedFile");function fa(e,t,n,a){return n.map(i=>{const{file:o,id:s}=F(i);o!==e.slug&&d(`${i} is not in item file "${e.slug}"; a wave's cards share one file`),((t.items.find(u=>u.id===s)||d(`item file "${o}" has no item "${s}"`)).deps||[]).includes(`wave:${a}`)&&d(`${i} waits on the wave "${a}", so it can't be in it`);const l=(t.waves||[]).find(u=>u.slug!==a&&!u.finished_at&&Ie(u).includes(s));return l&&d(`${i} is already in the wave "${l.slug}"; wave remove ${l.slug} ${i} first`),s})}r(fa,"waveCards");const wa=r(e=>[...new Set(String(e??"").split(",").map(t=>t.trim()).filter(Boolean))],"cardList");function ec(e){const t=[e??[]].flat().map(n=>{const[a,i]=String(n).split(":");return[a.trim(),wa(i)]});return(!t.length||t.some(([n])=>!n))&&d("--card takes one card per flag in build order, as <file>/<id>, or <file>/<id>:<file>/<id>,\u2026 naming the earlier cards it conflicts with"),t}r(ec,"cardSpecs");function pa(e,t,n,a,i){const o=n.items.indexOf(a),s=i.map(u=>{const p=J(e.slug,u),{file:w,id:f}=F(p),h=w===e.slug?n.items.indexOf(f):-1;return(h<0||h>=o)&&d(`${p} is not an earlier card of the wave "${n.slug}"`),f}),c=t.items.find(u=>u.id===a),l=[...(c.deps||[]).filter(u=>!fo(e,n,u)),...s];l.length?c.deps=l:delete c.deps}r(pa,"relink");const fo=r((e,t,n)=>Ie(t).some(a=>J(e.slug,n)===`${e.slug}/${a}`),"inWave");async function wo(e,t,n,a,i){i!==void 0&&await We(g.join(t.dir,ua(a.slug)),`${S(i,"the note").replace(/\n*$/,`
31
+ `)}`),await y(t.file,n);const{tickets:o}=Se(await oe(e));return{file:t.file,lines:[`order: ${po(t,n,a,o)}`]}}r(wo,"writeWave");function po(e,t,n,a){const i=r(o=>tt(t,t.items.find(s=>s.id===o)||{id:o},a),"label");return Ie(n).map(o=>{const s=(t.items.find(c=>c.id===o)?.deps||[]).filter(c=>fo(e,n,c));return s.length?`${i(o)} (after ${s.map(c=>i(F(J(e.slug,c)).id)).join(", ")})`:i(o)}).join(", ")}r(po,"orderLine");async function Pd(e,t,{title:n,goal:a,cards:i,note:o}){Yr(t);const s=ec(i);o===void 0&&d("wave create needs the wave note, as --note <text> or --file <path>");const c=await q(e);c.some(f=>f.slug===t)&&d(`"${t}" is an item file on this board; pick another slug`);for(const f of c)((await $(f.file,null))?.waves||[]).some(h=>h.slug===t)&&d(`this board already has a wave "${t}"`);const l=c.find(f=>f.slug===F(s[0][0]).file)||d(`this board has no item file "${F(s[0][0]).file}"`),{itemFile:u}=await Ue(e,l.slug),p=fa(l,u,s.map(([f])=>f),t);new Set(p).size!==p.length&&d("--card names a card twice");const w={slug:t,title:S(n,"--title"),goal:S(a,"--goal"),items:p,created:new Date().toISOString()};return s.forEach(([,f],h)=>pa(l,u,w,p[h],f)),u.waves=[...u.waves||[],w],wo(e,l,u,w,o)}r(Pd,"createWave");async function Dd(e,t,{add:n,remove:a,card:i,after:o,title:s,goal:c,note:l}){[n,a,i,o,s,c,l].every(m=>m===void 0)&&d("nothing to change: pass a card with --after, --title, --goal, --note or --file"),o!==void 0&&n===void 0&&i===void 0&&d(`--after goes with a card: wave set ${t} <file>/<id> --after <file>/<id>,\u2026`),i!==void 0&&o===void 0&&d(`wave set ${t} ${i} needs --after <file>/<id>,\u2026 ("" clears its links)`);const{source:u,itemFile:p,wave:w}=await pt(e,t);w.finished_at&&d(`the wave "${t}" is finished`),w.items=Ie(w),delete w.phases;const f=a===void 0?[]:await tc(e,t);if(n!==void 0){const[m]=fa(u,p,[n],t);w.items.includes(m)&&d(`${n} is already in the wave "${t}"`),w.items.push(m),pa(u,p,w,m,wa(o))}if(i!==void 0){const{file:m,id:k}=F(i);(m!==u.slug||!w.items.includes(k))&&d(`${i} is not in the wave "${t}"`),pa(u,p,w,k,wa(o))}if(a!==void 0){const[m]=fa(u,p,[a],t);w.items.includes(m)||d(`${a} is not in the wave "${t}"`),w.items.length===1&&d(`${a} is the wave's last card; wave finish ${t} ends the wave`);const k=r(v=>!K(v)&&(v.deps||[]).some(O=>J(u.slug,O)===`${u.slug}/${m}`),"waiting"),_=p.items.filter(v=>w.items.includes(v.id)&&v.id!==m&&k(v)),N=p.items.find(v=>v.id===m);if(_.length&&!(N&&K(N))){const v=await Promise.all(_.map(async O=>`${await H(e,`${u.slug}/${O.id}`)} waits on ${a}: wave set ${t} ${u.slug}/${O.id} --after <its other conflicts, or "">`));d(`${a} can't leave the wave "${t}" while open cards wait on it; relink each, then remove:
32
+ ${v.join(`
33
+ `)}`)}if(N&&K(N))for(const v of p.items.filter(O=>w.items.includes(O.id)&&O.deps))v.deps=v.deps.filter(O=>J(u.slug,O)!==`${u.slug}/${m}`),v.deps.length||delete v.deps;w.items=w.items.filter(v=>v!==m)}s!==void 0&&(w.title=S(s,"--title")),c!==void 0&&(w.goal=S(c,"--goal"));const h=await wo(e,u,p,w,l);return a!==void 0&&await nc(e,t,f,a),h}r(Dd,"changeWave");async function tc(e,t){const n=[];for(const a of await q(e)){const i=await $(a.file,null);for(const o of Array.isArray(i?.items)?i.items:[])K(o)||!(o.deps||[]).includes(`wave:${t}`)||(await Ee(e,a.slug,o)).length&&n.push(`${a.slug}/${o.id}`)}return n}r(tc,"waveBlocked");async function nc(e,t,n,a){const i=`${await H(e,a)} left the wave "${t}"`;for(const o of n){const{item:s}=await x(e,o);if(s.blocked_until||(await Ee(e,F(o).file,s)).length)continue;const{line:c}=await W(e,o,"unblocked",{lifted:i});await oa(e,o,c.ts),await he({dir:e},"card-unblocked",{key:o})}}r(nc,"noticeWaveUnblocked");async function Fd(e,t){const{source:n,itemFile:a,wave:i}=await pt(e,t),o=a.items.filter(s=>Ie(i).includes(s.id)&&!K(s));if(o.length){const s=await Promise.all(o.map(c=>H(e,`${n.slug}/${c.id}`)));d(`the wave "${t}" still has ${s.join(", ")} open; wave finish waits until every card in it is Done`)}return i.finished_at=new Date().toISOString(),await y(n.file,a),{file:n.file}}r(Fd,"finishWave");async function Nd(e,t,n){const{source:a,itemFile:i,wave:o}=await pt(e,t),s=await j.readFile(g.join(a.dir,ua(t)),"utf8").catch(()=>"");return{title:o.title,markdown:`**Goal** ${o.goal}
31
34
 
32
- **Order** ${Qi(a,i,o,n)}
35
+ **Order** ${po(a,i,o,n)}
33
36
 
34
- ${s}`}}r(rd,"readWaveNotes");async function C(e,t,n,a="main"){const{id:i}=N(t);/^[\w-]{1,40}$/.test(a)||d(`--agent takes a name of letters, digits, "_" and "-", not "${a}"`);const o=a==="main"?`${i}.json`:`${i}@${a}.json`;if(n)return h.join(h.resolve(n),"agents",o);const{source:s}=await x(e,t);return h.join(s.dir,"agents",o)}r(C,"builderFile");const Gi=r((e,t)=>typeof e=="string"&&/^\d{4}-\d\d-\d\dT/.test(e)&&!Number.isNaN(Date.parse(e))?new Date(e).toISOString():d(`${t} takes an ISO time such as 2026-10-23T16:30:00-07:00`),"isoTime"),Br=wn.progress,Zi=80,Vi="reading, building, testing, checking or landing";function Yi(e,t,n,a){e||d(`${a} needs --site, since the line goes to the item's thread`),t!==void 0&&!Br.includes(t)&&d(`--phase takes ${Vi}, not "${t}"`);const i=S(n,a);return i.length>Zi&&d(`${a} is ${i.length} characters; the cap is ${Zi}. Say it shorter.`),{phase:t,detail:i}}r(Yi,"progressLine");const Xi=r((e,t,n)=>t?{detail:e.detail}:(e.phase===void 0&&d(`${n} needs --phase ${Vi}`),e),"forAgent");async function oa(e,t,n="main",a,{phase:i,detail:o},s){const l=Ee(a),c=l||n==="main"?"":a.kind===se?n:It(a)||a.kind||n,u=l?xo[a.kind]:[c,i].filter(Boolean).join(" "),w=new RegExp(`^(?:${u}|${i??u})\\s*:?\\s+`,"i"),p=u?`${u[0].toUpperCase()}${u.slice(1)}: ${o.replace(w,"")}`:o,f=Y(e,t);(await K(f)).filter(m=>m.kind==="status").pop()?.text!==p&&await me(f,{ts:s,who:"claude",kind:"status",run:a.started,...i?{phase:i}:{},...l?{planner:!0}:{},text:p})}r(oa,"statusToThread");const Tr={prototype:"sonnet",grill:"opus",[pe]:"sonnet"};async function St(e,t,{label:n,phase:a,progress:i,dir:o,agent:s="main",kind:l,model:c,eta:u,worktree:w,ownWorktree:p,dispatch:f}){a!==void 0&&i===void 0&&d('--phase goes with --progress "<detail>"');const m=X(i,te=>Yi(e,a,te,"--progress")),$=await C(e,t,o,s),y=new Date().toISOString(),_=X(l,te=>/^[\w.-]{1,30}$/.test(te)?te:d("--kind takes a short word such as claude or codex")),D=ft(_),P=c??(_==="opus"||_==="sonnet"?_:void 0),B=["build",...Kr].includes(D),F=await g($,null),I=r(te=>["tap","hub"].includes(te?.dispatched)&&!te.done,"tapOpen");if(f==="session"&&I(F))return{file:$,alreadyOpen:!0,lines:[]};s!=="main"&&_!==pe&&_!==se&&I(await g(await C(e,t,o),null))&&d(`the Implement tap opened ${t}'s main builder record and no agent has taken it up; run builder start ${t} without --agent first`);const v=F?.dispatched&&!F.done?F:null,E=B&&!o?(await x(e,t)).item:void 0,T=F&&We(F).length?F:null,q=v&&D==="build"?{kind:ft(v.kind),model:v.model,reason:{tap:"The owner's Build tap picked it.",hub:"The board's pull picked it."}[v.dispatched]??"The session's dispatch picked it."}:B?kn({card:E??{}}):null;q&&D!=="build"&&D!==q.kind&&d(`--kind ${D}: ${q.kind} builds now. ${q.reason} Pass --kind ${q.kind}, or --kind build.`);const O=q?q.kind:D,z=ya({dir:e});if(!(v&&!f)&&Fo(z,O))throw new re(Do(z,O));const ie=m&&Xi(m,Ee({kind:O}),"--progress");c!==void 0&&!["opus","sonnet"].includes(c)&&d("--model takes opus or sonnet"),P!==void 0&&O==="codex"&&d("--model is for kind claude; codex needs none");const ee=O==="claude"?bn():"auto";P!==void 0&&ee!=="auto"&&P!==ee&&d(`--model ${P}: the hub's Claude model is ${ee==="opus"?"Opus":"Sonnet"}. Pass --model ${ee}, or no --model.`);const J=O==="claude"?P??q?.model??(v&&ft(v.kind)==="claude"?v.model:void 0)??"opus":Ee({kind:O})?P??(v?.kind===O?v.model:void 0)??Tr[O]:O===se?P??F?.model:void 0,ue={label:n===void 0?"Builder":S(n,"--label"),...O?{kind:O}:{},...J?{model:J}:{},started:y,...u===void 0?{}:{eta:Gi(u,"--eta")},...f?{dispatched:f}:{},...T?{calls:T.calls,...T.verified?{verified:T.verified}:{}}:{},...Hr(F)?{session:F.session}:{},...O===se&&F?.kind===se?{label:F.label,task:F.task,writes:F.writes,requested:F.requested}:{}},jt=B&&!o&&!G(E)&&E.lane!=="progress",st=jt?await he(e,t,{start:!0}):{lines:[]};let fe,Fe=null;const Ot=p&&B&&s==="main"?[F?.worktree,E?.worktree].find(te=>te?.path&&ce(te.path))??null:null,le=(v??T)?.worktree??Ot,Pt=w??(B&&s==="main"&&!le?p:void 0);try{if(Pt){const te=await H(h.dirname(h.dirname($)),N(t).id),At=(await Promise.all(te.filter(ne=>ne!==$).map(ne=>g(ne,null)))).filter(ne=>ne?.worktree?.path&&!ne.done).map(ne=>ne.worktree.path);({remade:Fe,...fe}=await Pt({busy:At}))}else fe=le}catch(te){throw jt&&await Jr(e,t,E),te}await Cr($,F),await k($,fe?{...ue,worktree:fe}:ue),E?.rebase_run&&s==="main"&&![eo,$a].includes(ue.label)&&await to(e,t),q?.inputs&&e&&Jo(xa(e),{call:"builder-pick",key:t,result:[O,O==="claude"?J:null].filter(Boolean).join(" "),reason:q.reason,inputs:{...q.inputs,...P?{askedModel:P}:{},...f?{dispatch:f}:{}}}),Fe&&e&&await W(e,t,"worktree-remade"),ie&&await oa(e,t,s,ue,ie,y);const on=_===pe||_===se?[]:await Kt(e,t,"Acted on: builder started");return e&&B&&await cr(e,t),{file:$,kind:O??null,model:J??null,reason:q?.reason??null,worktree:fe?.path??null,lines:[...D==="build"?[`kind: ${O}. ${q.reason}`]:[],...It(ue)?[`model: ${It(ue)}`]:[],...e?[`ref: ${await Q(e,t)}`]:[],...fe?[`worktree: ${fe.path}`]:[],...Fe?[Fe]:[],...st.lines,...on]}}r(St,"startBuilder");async function Cr(e,t){if(!t?.started||!t.done||!e.endsWith(".json")||h.basename(e).includes("@"))return;const{label:n,kind:a,model:i,started:o,done:s,session:l}=t,c=h.join(h.dirname(e),`${h.basename(e,".json")}@past-${Date.parse(o)}.json`);await k(c,{label:n,...a?{kind:a}:{},...i?{model:i}:{},started:o,done:s,...l?.log?{session:{log:l.log}}:{}})}r(Cr,"keepPastRun");async function ld(e,t,n,a="tap"){try{const{held:i,blockers:o}=await Mr(e,t);if(i&&await Fi(e,"card-hold",{key:t,hold:!1}),o.length)return await Wr(e,t,o);try{const s=await St(e,t,{kind:"build",worktree:n,dispatch:a});return{key:t,ref:await Q(e,t),kind:s.kind,...s.model?{model:s.model}:{},reason:s.reason,worktree:s.worktree}}catch(s){throw i&&await zr(e,t,i),s}}catch(i){if(!(i instanceof re))throw i;return await W(e,t,ga,{why:i.message}),null}}r(ld,"startTappedBuild");async function cd(e,t,{pr:n,conflict:a,base:i},o){const{source:s,itemFile:l,item:c}=await x(e,t);c.rebase_run={pr:n,base:i,conflict:a,at:new Date().toISOString()},await k(s.file,l);try{const u=await St(e,t,{kind:"build",label:eo,dispatch:"hub",ownWorktree:o});return{key:t,kind:u.kind,...u.model?{model:u.model}:{},worktree:u.worktree}}catch(u){throw await to(e,t),u}}r(cd,"startRebase");const eo="Rebase";async function to(e,t){const{source:n,itemFile:a,item:i}=await x(e,t);delete i.rebase_run,await k(n.file,a)}r(to,"endRebaseRun");async function dd(e,t){const{itemFile:n,item:a}=await x(e,t),i=oe(e,n);return Ie(a,i).find(o=>o.repo===i)?.number??null}r(dd,"cardPR");async function ud(e,t,{from:n,to:a,replayed:i}){const{source:o,itemFile:s,item:l}=await x(e,t);return l.rebase_run?(l.rebased=[...l.rebased||[],{from:n,to:a,base:l.rebase_run.base,replayed:i,at:new Date().toISOString()}],delete l.rebase_run,await k(o.file,s),!0):!1}r(ud,"recordRebase");const qr=r((e,t,n)=>{const a=new Map((e.rebased||[]).filter(i=>i.replayed).map(i=>[i.to,i.from]));for(let i=n,o=0;i&&o<=a.size;i=a.get(i),o++)if(i===t)return!0;return!1},"onlyRebased");async function Mr(e,t){const n=ya({dir:e});Ro(n)&&d(Ao(n));const{item:a}=await x(e,t),i=a.held?{held:a.held,pick_up_at:a.pick_up_at,held_at:a.held_at}:null;return i&&Ae(a)&&d("it's held. Unhold it, then tap Implement."),await Gn(e,t)&&d("no take is picked on its prototypes, so it prototypes again. Pick a take from the next round, then tap Implement."),{held:i,blockers:await mr(e,t,a)}}r(Mr,"tapRefusals");async function fd(e,t,n){await Ce(e,t,{who:"love",by:n,command:"implement"}),await or(e,t,{})}r(fd,"implementAsIs");async function Wr(e,t,n){const a=n.join(", ");return await ge({dir:e},"card-bump",{key:t}),await W(e,t,"cant-start-yet",{names:a}),{key:t,ref:await Q(e,t),bumped:n,line:`bumped: ${t} waits on ${a}, so it stays in Todo, bumped to the top`}}r(Wr,"bumpBlocked");async function nn(e,t){const n=await C(e,t),a=await g(n,null);return a?.started&&!a.done&&ze(a)?{file:n,record:a}:null}r(nn,"openBuild");async function no(e,t,{cause:n,words:a,by:i,until:o}){const s=await nn(e,t);return!s||s.record.pause?!1:(await k(s.file,{...s.record,pause:{cause:n,words:a,at:new Date().toISOString(),...i?{by:i}:{},...o?{until:o}:{}}}),!0)}r(no,"requestPause");async function Ur(e,t){const n=await nn(e,t),a=n?.record.pause;if(!a||a.paused)return a??null;const i=new Date().toISOString(),o=(await K(Y(e,t))).filter(l=>l.kind==="status"&&l.phase&&!l.planner&&String(l.ts)>=String(n.record.started)).pop()?.phase,s={...a,paused:i,...o?{phase:o}:{}};return await k(n.file,{...n.record,pause:s}),await W(e,t,"paused",{phase:o,words:a.words,clear:ba[a.cause][0]}),s}r(Ur,"markPaused");async function an(e,t,{dir:n,agent:a="main"}){if(!e||n||a!=="main")return[];const i=await Ur(e,t);return i?[`Paused: ${i.words}. Commit what you have now with \`git -c core.commentChar=';' commit -F <file>\`, then stop: end your turn and run nothing else. The board resumes this session, telling it so, once the pause clears.`]:[]}r(an,"pauseReply");async function pd(e,t){const n=await nn(e,t),a=n?.record.pause;if(!a?.paused)return null;const{pause:i,...o}=n.record;return await k(n.file,o),await W(e,t,"resumed",{clear:ba[a.cause][1]}),{pause:a,record:o}}r(pd,"resumePaused");async function wd(e,t){const n=await nn(e,t);if(!n?.record.pause||n.record.pause.paused)return;const{pause:a,...i}=n.record;await k(n.file,i)}r(wd,"dropPause");async function md(e,t,n){const a=await C(e,t),i=await g(a,null),o=new Date().toISOString();i&&!i.done&&await k(a,{...i,done:o});const{source:s,itemFile:l,item:c}=await x(e,t);c.lane==="progress"&&Zn(c,"todo",o),await k(s.file,l),await W(e,t,ga,{why:n})}r(md,"abandonLaunch");async function hd(e,t,[n,a],i="main"){const o=await C(e,t,void 0,i),s=await g(o,null);s&&!s.done&&await k(o,{...s,done:new Date().toISOString()}),await tt(e,t),await W(e,t,n,a)}r(hd,"abandonPlanner");async function gd(e,t,n,a,i="main",o=null){const s=await C(e,t,void 0,i),l=await g(s,null);await k(s,{...l,session:{id:n,pid:a,log:o,at:new Date().toISOString()}})}r(gd,"recordSession");async function $d(e,t){const{source:n}=await x(e,t);return(await Promise.all((await H(n.dir,N(t).id)).map(i=>g(i,null)))).filter(i=>i&&i.started&&!i.done).map(i=>({pid:i.session?.pid??null,at:i.session?.at??null}))}r($d,"openAgents");async function kd(e,t){const{source:n}=await x(e,t);return(await Promise.all((await H(n.dir,N(t).id)).map(i=>g(i,null)))).filter(i=>i&&i.started&&!i.done).map(i=>({kind:i.kind??null,pid:i.session?.pid??null,at:i.session?.at??null}))}r(kd,"openRuns");async function bd(e,t,n){const{source:a}=await x(e,t),i=new Date().toISOString();for(const o of await H(a.dir,N(t).id)){const s=await g(o,null);s?.started&&!s.done&&ze(s)&&await k(o,{...s,stopped:{run:n,at:i}})}}r(bd,"markStopped");async function yd(e,t){const{source:n,itemFile:a,item:i}=await x(e,t);i.merge_ready&&(i.merge_ready.stopped=new Date().toISOString(),await k(n.file,a))}r(yd,"stopHeldMerge");async function xd(e,t,n){const a=S(n,"item stall --reason"),{source:i,itemFile:o,item:s}=await x(e,t);return s.lane==="done"&&d(`${await Q(e,t)} is done; there is nothing to stall`),s.stalled={reason:a,at:new Date().toISOString()},await k(i.file,o),a}r(xd,"markStalled");async function _d(e,t){const{source:n,itemFile:a,item:i}=await x(e,t);i.stalled&&(delete i.stalled,await k(n.file,a))}r(_d,"clearStall");async function Sd(e,t){const{item:n}=await x(e,t),a=await K(h.join(e,"data","events.jsonl")),i=r(l=>a.filter(c=>c.kind===l&&c.data?.key===t).map(c=>String(c.ts)).sort().pop()||"","latest"),o=i("card-bump");if(!o||i("card-unbump")>o)return null;const s=[n.closed_at,...Se(n).map(l=>l.merged_at)].filter(Boolean).map(String).sort().pop()||"";return o>s?o:null}r(Sd,"landFirst");async function vd(e,t,n){const{item:a}=await x(e,t);G(a)&&d(`${await Q(e,t)} is done; there is nothing to bump`);const i=await ge({dir:e},n?"card-bump":"card-unbump",{key:t});return(await K(h.join(e,"data","events.jsonl"))).find(o=>o.id===i).ts}r(vd,"bumpCard");async function ao(e,t){return(await K(Y(e,t))).filter(n=>n.kind==="status").pop()?.phase==="landing"}r(ao,"isLanding");const Hr=r(e=>!!e?.session&&e.session.at>(e.done??e.started),"launchedSession");async function jd(e,t,n){const a=await g(await C(e,t),null);if(a&&!a.done)return null;const i=await St(e,t,{kind:n,dispatch:"hub"});return{key:t,kind:n,model:i.model}}r(jd,"startPlanner");async function Od(e,t,n){const{source:a}=await x(e,t);if((await Promise.all((await H(a.dir,N(t).id)).map(l=>g(l,null)))).some(l=>l?.kind===pe&&l.started&&!l.done))return null;const o=vo(n);if(await g(await C(e,t,void 0,o),null))return null;const s=await St(e,t,{kind:pe,agent:o,dispatch:"hub"});return{key:t,kind:pe,model:s.model,agent:o}}r(Od,"startVisual");const sa=r(e=>typeof e=="string"&&/^[a-z][a-z0-9-]{0,29}$/.test(e)&&e!=="main"&&!e.startsWith(`${pe}-`)?e:d('--name takes a short lowercase name such as tests or docs-pass: letters, digits and "-", not main or visual-\u2026'),"helperName");async function ra(e,t){const{item:n}=await x(e,t);return[(await g(await C(e,t),null))?.worktree,n.worktree].find(i=>i?.path&&ce(i.path))??null}r(ra,"cardWorktree");async function Pd(e,t,{name:n,task:a,writes:i,model:o}){A(e);const s=sa(n),l=S(a,"--task");o!==void 0&&!["opus","sonnet"].includes(o)&&d("--model takes opus or sonnet");const c=bn();o!==void 0&&c!=="auto"&&o!==c&&d(`--model ${o}: the hub's Claude model is ${c==="opus"?"Opus":"Sonnet"}. Pass --model ${c}, or no --model.`);const{item:u}=await x(e,t);G(u)&&d(`${await Q(e,t)} is Done; a helper needs an open card`);const w=await C(e,t,void 0,s);return ce(w)&&d(`${t} already has an agent named ${s}; pick another --name`),i&&!await ra(e,t)&&d(`a helper that writes branches from ${t}'s worktree, and the card has none; start its build first, or drop --writes`),await k(w,{label:s,kind:se,task:l,writes:!!i,...o?{model:o}:{},requested:new Date().toISOString()}),await W(e,t,"helper-asked",{agent:s,writes:i}),{lines:[`helper ${s} requested: the board launches it ${i?"once an implementer slot is free":"now"}`,`wait for it with agent wait ${t} --name ${s}`]}}r(Pd,"requestHelper");async function Ad(e,t,n,a){const i=await C(e,t,void 0,n),o=await g(i,null);if(o?.kind!==se||o.started||o.done)return null;const{item:s}=await x(e,t),l=kn({card:s}),c=bn(),u=o.model??(c!=="auto"?c:l.kind==="claude"?l.model:"opus"),w=o.writes?await ra(e,t):null;o.writes&&!w&&d(`${t} has no worktree for helper ${n} to branch from`),await k(i,{...o,model:u});const p=await St(e,t,{agent:n,kind:se,dispatch:"hub",worktree:w?({busy:f})=>a({repo:w.repo,base:w.branch,busy:f}):void 0});return{key:t,kind:se,model:u,agent:n,task:o.task,writes:o.writes,worktree:p.worktree}}r(Ad,"startHelper");async function Dd(e,t,n){const a=await g(await C(e,t,void 0,sa(n)),null);return a?.kind!==se&&d(`${t} has no helper named ${n}`),{record:a,card:await ra(e,t)}}r(Dd,"helperOf");async function Fd(e,t,{name:n,agent:a="main",timeout:i=9,every:o=2e3,alive:s}){A(e);const l=Number(i);l>0||d("--timeout takes minutes, a number above 0");const c=await C(e,t,void 0,sa(n)),u=await C(e,t,void 0,a),w=r(async f=>{const m=await g(u,null);if(!m?.started||m.done)return;const{waits:$,...y}=m;await k(u,f?{...y,waits:f}:y)},"mark"),p=Date.now()+l*6e4;await w(n);try{for(;;){const f=await g(c,null);if(f?.kind!==se&&d(`${t} has no helper named ${n}`),f.done){const $=f.writes&&f.worktree?[`branch ${f.worktree.branch} in ${f.worktree.path}: merge it with agent merge ${t} --name ${n}`]:[];return{lines:[`helper ${n} done: ${f.note??"no hand-back"}`,...$]}}const m=f.session?.pid??null;m&&!s(m)&&d(`helper ${n}'s process exited without builder done; do its task yourself`),Date.now()>=p&&d(`helper ${n} is still ${f.started?"running":f.writes?"waiting for an implementer slot":"waiting to launch"} after ${l} minutes; run agent wait again`),await new Promise($=>setTimeout($,o))}}finally{await w(null)}}r(Fd,"waitHelper");async function Rd(e,t,n="main"){return n==="main"?!1:(await g(await C(e,t,void 0,n),null))?.kind===se}r(Rd,"isHelper");async function Nd(e,t,n="main"){const a=await g(await C(e,t,void 0,n),null);return!!(a?.started&&!a.done&&Ee(a))}r(Nd,"isPlanner");async function Ed(e,t,{file:n,title:a}){A(e);const i=S(a,"--title");(typeof n!="string"||!n.endsWith(".html"))&&d("--file takes the page, an .html file");const o=await j.readFile(h.resolve(n),"utf8").catch(()=>d(`--file ${n} can't be read`));o.trim()||d(`--file ${n} is empty`),await x(e,t);const{id:s}=N(t),l=h.join(e,"public","visuals",s);await j.mkdir(l,{recursive:!0});const c=i.toLowerCase().replace(/[^a-z0-9]+/g,"-").slice(0,60).replace(/^-+|-+$/g,"")||"visual";let u=`${c}.html`;for(let p=2;ce(h.join(l,u));p++)u=`${c}-${p}.html`;await j.writeFile(h.join(l,u),o,{flag:"wx"});const w=`visuals/${s}/${u}`;return await me(Y(e,t),{ts:new Date().toISOString(),who:"claude",kind:pe,text:S(i,"--name"),link:On(w,"--link")}),{lines:[w]}}r(Ed,"addVisual");async function Id(e){const t=[];for(const n of await M(e)){const a=await g(n.file,null);for(const i of a?.items||[]){if(G(i))continue;const o=await g(h.join(n.dir,"agents",`${i.id}.json`),null);!o?.started||o.done||!o.dispatched||Ee(o)||t.push({key:`${n.slug}/${i.id}`,kind:ft(o.kind),model:o.model})}}return t}r(Id,"cutOffBuilds");async function zr(e,t,n){const{source:a,itemFile:i,item:o}=await x(e,t);for(const s of Object.keys(n))n[s]===void 0?delete o[s]:o[s]=n[s];await k(a.file,i)}r(zr,"restoreHold");async function Jr(e,t,n){const{source:a,itemFile:i,item:o}=await x(e,t);for(const s of["lane","lane_at","closed_at","reopened_at"])n[s]===void 0?delete o[s]:o[s]=n[s];await k(a.file,i)}r(Jr,"restoreLane");async function Ld(e,t){return e||d("audit reads a board: pass --site <route>"),t!==void 0&&N(t),{lines:Ko(Qo(xa(e),{key:t}))}}r(Ld,"auditLog");const Kr=["codex","claude"];async function Bd(e,t){const{item:n}=await x(e,t),{kind:a,model:i,reason:o}=kn({card:n});return{lines:[`${[a,i].filter(Boolean).join(" ")}: ${o}`]}}r(Bd,"pickBuilder");async function io(e,t,{dir:n}={}){const{id:a}=N(t),i=h.dirname(await C(e,t,n)),o=await H(h.dirname(i),a);return(await Promise.all(o.map(l=>g(l,null)))).filter(l=>l?.worktree?.path).sort((l,c)=>String(c.started).localeCompare(String(l.started)))[0]?.worktree??null}r(io,"recordedWorktree");async function Td(e,t){const{source:n}=await x(e,t),i=(await Promise.all((await H(n.dir,N(t).id)).map(o=>g(o,null)))).filter(o=>o?.session?.id&&o.worktree?.path).sort((o,s)=>String(s.started).localeCompare(String(o.started)))[0];return i?{id:i.session.id,worktree:i.worktree.path}:null}r(Td,"recordedSession");async function Cd(e,t,n,{phase:a,dir:i,agent:o="main",eta:s,clearEta:l}){s!==void 0&&l&&d("pass --eta or --clear-eta, not both");const c=Yi(e,a,n,"builder progress"),u=await C(e,t,i,o),w=await g(u,null);(!w?.started||w.done)&&d(`builder progress needs an open builder record on ${t}; run builder start first`);const p=Xi(c,Ee(w),"builder progress");return s!==void 0&&(w.eta=Gi(s,"--eta")),l&&delete w.eta,(s!==void 0||l)&&await k(u,w),await oa(e,t,o,w,p,new Date().toISOString()),{file:u,lines:await an(e,t,{dir:i,agent:o})}}r(Cd,"builderProgress");async function qd(e,t){const{source:n}=await x(e,t),a=Y(e,t);if((await K(a)).filter(s=>s.kind==="status").pop()?.phase==="landing")return;const o=(await Promise.all((await H(n.dir,N(t).id)).map(s=>g(s,null)))).filter(s=>s?.started&&ze(s)&&s.label!==$a).map(s=>s.started).sort().pop();await me(a,{ts:new Date().toISOString(),who:"claude",kind:"status",phase:"landing",text:"Landing: rebasing onto main and landing",...o?{run:o}:{}})}r(qd,"landingLine");const We=r(e=>(e?.calls||[]).filter(t=>!e.verified||t.at>e.verified.at),"unverifiedCalls");async function Md(e,t,n,{dir:a,agent:i="main"}){const o=S(n,"builder call");/\n/.test(o)&&d("builder call takes one line; record each call on its own");const s=await C(e,t,a,i),l=await g(s,null);return(!l?.started||l.done)&&d(`builder call needs an open builder record on ${t}; run builder start first`),await k(s,{...l,calls:[...l.calls||[],{at:new Date().toISOString(),text:o}]}),{file:s,lines:await an(e,t,{dir:a,agent:i})}}r(Md,"recordCall");async function vt(e,t){const n=await K(Y(e,t)),a=new Map(n.filter(i=>i.kind===Rt.answer).map(i=>[i.ask,i]));return n.filter(i=>i.kind===Rt.ask).map(i=>{const o=a.get(i.ask);return{id:i.ask,agent:i.agent||"main",text:i.text,at:i.ts,answer:o?{text:o.text,at:o.ts}:null,deferred:!!o?.deferred}})}r(vt,"builderAsks");const Qr=r(e=>we().find(t=>_e(t.dir,e))??{dir:e},"boardTarget");async function Wd(e,t,n,{agent:a="main"}){A(e);const i=S(n,"builder ask");/\n/.test(i)&&d("builder ask takes one line; ask each question on its own");const o=await g(await C(e,t,void 0,a),null);(!o?.started||o.done)&&d(`builder ask needs an open builder record on ${t}; run builder start first`);const s=`ask${(await vt(e,t)).length+1}`;return await me(Y(e,t),{ts:new Date().toISOString(),who:`${It(o)||o.kind||"Claude"} builder`,kind:Rt.ask,ask:s,agent:a,text:i}),await ge(Qr(e),"builder-ask",{key:t,ask:s,agent:a,text:i}),{id:s,lines:await an(e,t,{agent:a})}}r(Wd,"askOrchestrator");async function Ud(e,t,n,a,{deferred:i=!1}={}){A(e);const o=S(a,"--text"),s=(await vt(e,t)).find(c=>c.id===n)||d(`no ask "${n}" on ${t}; builder asks ${t} lists them`);s.answer&&d(`${n} on ${t} is already ${s.deferred?"deferred":"answered"}`);const l=new Date().toISOString();if(await me(Y(e,t),{ts:l,who:"claude",kind:Rt.answer,ask:n,...i?{deferred:!0}:{},text:o}),i){const c=await C(e,t,void 0,s.agent),u=await g(c,null);u&&await k(c,{...u,calls:[...u.calls||[],{at:l,text:`Question: ${s.text} (deferred to the owner)`}]})}return{lines:[]}}r(Ud,"answerBuilder");async function Hd(e,t,{wait:n=!1,timeout:a=9,every:i=2e3}={}){A(e);const o=Number(a);o>0||d("--timeout takes minutes, a number above 0");const s=Date.now()+o*6e4;for(;;){const l=await vt(e,t);if(!l.length)return{lines:["no asks yet"]};const c=l.filter(p=>!p.answer),u=l.flatMap(p=>[`${p.id}. ${p.text}`,` ${p.answer?`${p.deferred?"deferred":"answered"}: ${p.answer.text}`:"waiting on the orchestrator"}`]);if(!n||!c.length)return{lines:u};const w=await an(e,t,{});if(w.length)return{lines:[...u,...w]};Date.now()>=s&&d(`${c.map(p=>p.id).join(", ")} still waiting on the orchestrator after ${o} minutes; run builder asks ${t} --wait again`),await new Promise(p=>setTimeout(p,i))}}r(Hd,"listAsks");async function Gr(e,t,n){const a=t.topic.startsWith("item:")&&!t.topic.startsWith("item:ask:")?t.topic.slice(5):d(`${n}.ask goes on a card's question, topic item:<file>/<id>`),i=(await vt(e,a)).find(o=>o.id===t.ask)||d(`${n}.ask names no ask "${t.ask}" on ${a}; builder asks ${a} lists them`);i.deferred||d(`${n}.ask names ${i.id}, which the orchestrator ${i.answer?"answered":"has not deferred"}; only a deferred ask goes to the owner`)}r(Gr,"checkAskQuestion");async function zd(e,t,{dir:n,agent:a="main"}){const i=await g(await C(e,t,n,a),null),o=i?.calls||[];if(!o.length)return{lines:["no judgment calls recorded"]};const{verified:s}=i,l=We(i).length?"not verified yet":`verified ${s.at}${s.note?`: ${s.note}`:""}`;return{lines:[...o.map((c,u)=>`${u+1}. ${c.text}`),l]}}r(zd,"listCalls");async function Jd(e,t,{dir:n,agent:a="main",note:i}){const o=await C(e,t,n,a),s=await g(o,null);if(We(s).length||d(`${t} has no unverified judgment calls${a==="main"?"":` from agent ${a}`}; builder calls ${t} lists them`),e){const l=new Set((await g(L(e),{items:[]})).items?.filter(u=>u.topic===`item:${t}`&&u.ask).map(u=>u.ask)),c=(await vt(e,t)).find(u=>u.deferred&&u.agent===a&&!l.has(u.id));c&&d(`${c.id} on ${t} was deferred to the owner; add its question with "ask": "${c.id}" first`)}return await k(o,{...s,verified:{at:new Date().toISOString(),...i===void 0?{}:{note:S(i,"--note")}}}),o}r(Jd,"verifyCalls");async function Kd(e,t){const{source:n,item:a}=await x(e,t),i=r((s,l)=>[(s.options||[]).find(c=>c.id===l.choice)?.label,l.note].filter(Boolean).join(": ")||"answered","said"),o=(await de(e,t)).asked.filter(s=>s.ask&&s.answers.length).map(s=>({ask:s.ask,question:s.question,answer:i(s,s.answers.at(-1))}));return{key:t,ref:await Q(e,t),title:a.title||t,notes:a.plan?h.join(n.dir,a.plan):null,thread:Y(e,t),worktree:(await io(e,t))?.path??null,answers:o,links:await Zr(e,t),rebasePR:a.rebase_run?.pr??null}}r(Kd,"briefFacts");async function Zr(e,t){const n=new Map;for(const l of await M(e))for(const c of(await g(l.file,null))?.items||[])n.set(`${l.slug}/${c.id}`,{entry:l,it:c});const a=N(t).file,{it:i}=n.get(t),o=[...n].filter(([,l])=>(l.it.related||[]).some(c=>U(l.entry.slug,c)===t)).map(([l])=>l),s=[...i.parent?[["parent",U(a,i.parent)]]:[],...(i.deps||[]).map(l=>["depends on",U(a,l)]),...[...new Set([...(i.related||[]).map(l=>U(a,l)),...o])].map(l=>["related",l])].filter(([,l])=>n.has(l));return Promise.all(s.map(async([l,c])=>{const{entry:u,it:w}=n.get(c);return{relation:l,ref:await Q(e,c),title:w.title||c,lane:He[w.lane||"todo"],notes:w.plan?h.join(u.dir,w.plan):null,thread:Y(e,c)}}))}r(Zr,"cardLinks");async function Qd(e){const t=[];for(const n of await M(e)){const a=await g(n.file,null);for(const i of a?.items||[]){if(G(i))continue;const o=(await Promise.all((await H(n.dir,i.id)).map(u=>g(u,null)))).filter(Boolean);if(!mn(o))continue;const s=o.map(u=>u.verified?.at).filter(Boolean).sort().at(-1);if(!s||o.some(u=>We(u).length))continue;const l=`${n.slug}/${i.id}`;if((await de(e,l)).asked.some(u=>u.state==="open")||await Qt(e,l,i))continue;const c=o.filter(u=>u.worktree?.path).sort((u,w)=>String(w.started).localeCompare(String(u.started)))[0];c&&ce(c.worktree.path)&&t.push({key:l,verified:s,kind:ft(c.kind),model:c.model})}}return t}r(Qd,"landable");async function Gd(e,t){const{source:n,item:a}=await x(e,t);(await Promise.all((await H(n.dir,a.id)).map(l=>g(l,null)))).some(l=>l?.started&&!l.done)||d(`${t} has no open builder; only a card whose lander stopped has one to relaunch`),await he(e,t,{handBack:!0,next:"A lander relaunches to land the verified build"});const o=h.join(e,"data","landers.json"),s=await g(o,{});delete s[t],await j.writeFile(o+".tmp",JSON.stringify(s)+`
35
- `),await j.rename(o+".tmp",o)}r(Gd,"relaunchLander");async function Zd(e,t,{dir:n}={}){const{id:a}=N(t),i=await H(h.dirname(h.dirname(await C(e,t,n))),a),o=[];for(const s of i){if(!We(await g(s,null)).length)continue;const l=h.basename(s,".json").slice(String(a).length+1)||"main";o.push(l==="main"?"":` --agent ${l}`)}o.length&&d(`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(Zd,"checkCallsVerified");async function Vd(e,t,{dir:n,agent:a="main",next:i}){const o=await g(await C(e,t,n,a),null),s=o&&!o.done?We(o):[];if(!s.length)return null;i!==void 0&&d(`builder done sets ${t}'s Next itself while its record has judgment calls; run it without --next`);const l=s.some(u=>u.text.startsWith("Question:"))?"Answer the builder's questions":"Verify the builder's judgment calls",c=await he(e,t,{handBack:!0,next:l});return{lines:[`handed back: Next "${l}"`,...c.lines]}}r(Vd,"handBackCalls");async function Yd(e,t,{agent:n="main"}){if(n!=="main")return!1;const a=await C(e,t,void 0,n),i=await g(a,null);if(!i?.started||i.done||!i.worktree?.path)return!1;const{id:o}=N(t);for(const s of await H(h.dirname(h.dirname(a)),o)){const l=s===a?null:await g(s,null);if(!l?.started||l.done||l.kind==="install")continue;const c=h.basename(s,".json").slice(String(o).length+1);d(`builder done would finish ${t} while agent ${c} is still open; run builder done ${t} --agent ${c} first`)}return!0}r(Yd,"finishesCard");async function Xd(e,t){const{source:n,item:a}=await x(e,t);if(G(a))return null;const i=(await Promise.all((await H(n.dir,a.id)).map(s=>g(s,null)))).filter(Boolean);if(!mn(i)||i.some(s=>We(s).length||s.started&&!s.done&&s.kind!=="install"))return null;const o=await io(e,t);return!o||!ce(o.path)?null:{waits:(await de(e,t)).asked.filter(s=>s.state==="open").map(s=>s.id)}}r(Xd,"verifiedFinish");async function eu(e,t){const{item:n}=await x(e,t);if(n.reopened_at&&d(`the owner reopened ${await Q(e,t)}; it closes on the owner's Done`),n.lane!=="done"||Se(n).some(o=>o.merged_at))return;const a=String(n.closed_at||"");(await K(h.join(e,"data","events.jsonl"))).some(o=>o.kind==="item-message"&&o.data?.key===t&&String(o.ts)>a)&&d(`the owner reopened ${await Q(e,t)} with a message; it closes on the owner's Done`)}r(eu,"checkNotReopened");async function H(e,t){const n=h.join(e,"agents");return(await j.readdir(n).catch(()=>[])).filter(a=>a===`${t}.json`||a.startsWith(`${t}@`)&&!a.startsWith(`${t}@past-`)&&a.endsWith(".json")).map(a=>h.join(n,a))}r(H,"builderFiles");async function oo(e,t,n,{handedBack:a,endHandBack:i=!1,held:o=!1}={}){const s=new Date().toISOString();for(const l of await H(e,t)){const c=await g(l,null);if(!c)continue;if(c.done||c.kind==="install"&&!n){if(i&&c.handed_back){const{handed_back:f,...m}=c;await k(l,m)}continue}if(o&&c.pause)continue;const{eta:u,handed_back:w,...p}=c;await k(l,{...p,done:s,...a?{handed_back:a}:{},...o&&c.started?{hold_stopped:!0}:{}})}}r(oo,"closeBuilders");async function tu(e,t){const n=await C(e,t),a=await g(n,null);if(!a?.hold_stopped)return null;const{hold_stopped:i,...o}=a;return await k(n,o),{kind:a.kind??null,label:a.label??null}}r(tu,"takeHoldStopped");async function Vr(e,t,{dir:n,agent:a,startedBetween:i,note:o,next:s,requireNext:l=!1}){const c=await C(e,t,n,a),u=await g(c,null);if(!u||u.done)return c;if(i){const I=Date.parse(u.started);if(!(I>=i[0]&&I<=i[1]))return c}const{eta:w,...p}=u,f=new Date().toISOString(),m={...p,done:f,...o?{note:o}:{}},{id:$}=N(t),y=h.dirname(h.dirname(c)),_=await Promise.all((await H(y,$)).map(I=>I===c?m:g(I,null))),D=!_.some(I=>I?.started&&!I.done),P=n?{file:h.join(y,"wave.json")}:(await x(e,t)).source,B=await g(P.file,null),F=B?.items?.find(I=>I.id===$);return s!==void 0&&(mi(F||d(`${t} has no item to set --next on`),s,await Qn(e,t)),e&&await vi(e,t,F,F.next)),l&&F&&hn(F,_)&&d(`builder done closes ${t}'s last open builder, which leaves it In Progress with no Next; pass --next "<what happens next>", or record a judgment call with builder call ${t} or land`),await k(c,m),await tt(e,t,{screen:u.kind==="grill"}),o&&await oa(e,t,a,u,{detail:o},f),s!==void 0&&await k(P.file,B),c}r(Vr,"stopBuilder");async function Yr(e){const t=[];for(const n of await M(e)){const a=await g(n.file,null);for(const i of a?.items||[])for(const o of await H(n.dir,i.id)){const s=await g(o,null);if(!s?.started||s.done)continue;const l=h.basename(o,".json");t.push({key:`${n.slug}/${i.id}`,agent:l.slice(String(i.id).length+1)||"main",label:s.label||"Builder",started:s.started})}}return t}r(Yr,"openBoardBuilders");async function nu(e){const t=await Yr(e);for(const n of t)await Vr(e,n.key,{agent:n.agent,note:"Board closed. Builder record stopped; work is kept for reopening."});return t}r(nu,"closeBoardBuilders");export{re as BoardError,Ra as PUSH_LINE_MAX,ks as SCREEN_AFTER,Dn as UPLOAD_LIMIT,Nl as WORKING_KINDS,md as abandonLaunch,hd as abandonPlanner,Kl as ackPing,Qc as addItem,jc as addNotes,gc as addPrototype,yc as addQuestions,ic as addReviewers,fc as addRuleTo,hc as addTopic,Ed as addVisual,Ud as answerBuilder,ht as appendMessage,W as appendStatus,td as archiveCards,ed as archiveCount,Yt as archiveFile,Xt as archiveRank,Wd as askOrchestrator,Ic as askedGate,Ld as auditLog,Gc as backfillTickets,Qt as blockWords,ae as boardConfig,oe as boardRepoOf,Mc as breakOwnerCheck,Kd as briefFacts,Kc as builderModel,Cd as builderProgress,vd as bumpCard,nc as cardLinked,Q as cardName,dd as cardPR,od as changeWave,Zd as checkCallsVerified,Ec as checkClose,eu as checkNotReopened,_d as clearStall,nu as closeBoardBuilders,id as createWave,Id as cutOffBuilds,wd as dropPause,pc as editRuleIn,ql as eventCard,cc as fallBackFromLinear,Ql as finishHandshake,sd as finishWave,Yd as finishesCard,Vd as handBackCalls,zc as heldMerge,Dd as helperOf,Na as hiddenFile,fd as implementAsIs,Bc as isFinished,Rd as isHelper,ao as isLanding,Nd as isPlanner,M as itemSources,Sd as landFirst,Qd as landable,qd as landingLine,Hd as listAsks,zd as listCalls,$c as listPrototypes,uc as listRules,Ul as markAsk,Ur as markPaused,Bl as markRead,xd as markStalled,bd as markStopped,El as markWorking,Hc as mergeCard,yr as mergedLine,Fn as messageText,Zc as migrateFollowups,Yc as migratePhases,Vc as migrateStatuses,ad as migrateWaveNames,Hl as moveAsk,Lc as moveCard,Fc as moveQuestions,$d as openAgents,Yr as openBoardBuilders,kd as openRuns,lc as opensPRs,N as parseKey,qc as passOwnerCheck,Bd as pickBuilder,Cc as pickUp,Ac as planAgain,ac as postDigest,Jl as postIncomingReview,Zl as postLink,Uc as postPR,Vl as postReply,Wc as prReport,_c as publishScreened,Sc as publishUnscreened,As as pushLine,Rs as pushUrl,Xl as queuePushes,Me as readArchive,je as readAskLinks,qt as readAskProgress,Ls as readAskTitles,Ln as readBoardRules,Us as readBoardSettings,Ja as readHandshake,Es as readHidden,g as readJSON,Is as readMarks,Ia as readMarksFile,br as readNotes,Ut as readPRSlack,bt as readPrototypes,ii as readScreening,Cl as readUpload,rd as readWaveNotes,xs as readWorking,Md as recordCall,Fi as recordOwnerTap,Ss as recordPush,Yl as recordReaction,ud as recordRebase,zl as recordReview,gd as recordSession,Td as recordedSession,io as recordedWorktree,Ml as relateAsk,Gd as relaunchLander,bc as removePrototype,oc as removeReviewers,wc as removeRuleFrom,_s as repliesSincePush,Pd as requestHelper,no as requestPause,Rc as resolveNoteAnswers,Dc as resolveQuestion,pd as resumePaused,Ms as reviewDigest,ec as reviewDue,tc as reviewUpdated,mc as saveBoardRules,Xe as saveBoardSettings,sc as saveBoardShare,Tl as saveUpload,Il as sendPush,kc as servedRoundsOpen,rc as setBoardPause,dc as setBoardSetting,Ll as setHidden,he as setItem,Tc as setMainInstall,Gl as setReviewers,Hs as settingsLines,be as settingsOf,vc as settleAnswers,xc as settleQuestion,Fl as siteDir,$s as sitesDir,Oc as splitSharedNotes,or as stageImplement,Xc as stageImplementAsks,Pc as stageReply,St as startBuilder,Ad as startHelper,jd as startPlanner,cd as startRebase,ld as startTappedBuild,Od as startVisual,Vr as stopBuilder,yd as stopHeldMerge,nd as stripDeadFields,qn as takeFile,tu as takeHoldStopped,Jc as tapMerge,Y as threadFile,pi as topicQuestions,Wl as unfoldAsk,Nc as unrecorded,Xd as verifiedFinish,Jd as verifyCalls,Fd as waitHelper,na as waveNoteFile,Bt as wavesDir,Ps as withReplies,Rl as writeReply};
37
+ ${s}`}}r(Nd,"readWaveNotes");async function U(e,t,n,a="main"){const{id:i}=F(t);/^[\w-]{1,40}$/.test(a)||d(`--agent takes a name of letters, digits, "_" and "-", not "${a}"`);const o=a==="main"?`${i}.json`:`${i}@${a}.json`;if(n)return g.join(g.resolve(n),"agents",o);const{source:s}=await x(e,t);return g.join(s.dir,"agents",o)}r(U,"builderFile");const mo=r((e,t)=>typeof e=="string"&&/^\d{4}-\d\d-\d\dT/.test(e)&&!Number.isNaN(Date.parse(e))?new Date(e).toISOString():d(`${t} takes an ISO time such as 2026-10-23T16:30:00-07:00`),"isoTime"),ac=_n.progress,ho=80,go="reading, building, testing, checking or landing";function $o(e,t,n,a){e||d(`${a} needs --site, since the line goes to the item's thread`),t!==void 0&&!ac.includes(t)&&d(`--phase takes ${go}, not "${t}"`);const i=S(n,a);return i.length>ho&&d(`${a} is ${i.length} characters; the cap is ${ho}. Say it shorter.`),{phase:t,detail:i}}r($o,"progressLine");const ko=r((e,t,n)=>t?{detail:e.detail}:(e.phase===void 0&&d(`${n} needs --phase ${go}`),e),"forAgent");async function ma(e,t,n="main",a,{phase:i,detail:o},s){const c=qe(a),l=c||n==="main"?"":a.kind===re?n:Mt(a)||a.kind||n,u=c?Jo[a.kind]:[l,i].filter(Boolean).join(" "),p=new RegExp(`^(?:${u}|${i??u})\\s*:?\\s+`,"i"),w=u?`${u[0].toUpperCase()}${u.slice(1)}: ${o.replace(p,"")}`:o,f=Z(e,t);(await z(f)).filter(h=>h.kind==="status").pop()?.text!==w&&await le(f,{ts:s,who:"claude",kind:"status",run:a.started,...i?{phase:i}:{},...c?{planner:!0}:{},text:w})}r(ma,"statusToThread");const ic={prototype:"sonnet",grill:"opus",[me]:"sonnet"};async function Et(e,t,{label:n,phase:a,progress:i,dir:o,agent:s="main",kind:c,model:l,eta:u,worktree:p,ownWorktree:w,dispatch:f}){a!==void 0&&i===void 0&&d('--phase goes with --progress "<detail>"');const h=ee(i,ne=>$o(e,a,ne,"--progress")),m=await U(e,t,o,s),k=new Date().toISOString(),_=ee(c,ne=>/^[\w.-]{1,30}$/.test(ne)?ne:d("--kind takes a short word such as claude or codex")),N=_t(_),v=l??(_==="opus"||_==="sonnet"?_:void 0),O=["build",...wc].includes(N),A=await $(m,null),I=r(ne=>["tap","hub"].includes(ne?.dispatched)&&!ne.done,"tapOpen");if(f==="session"&&I(A))return{file:m,alreadyOpen:!0,lines:[]};s!=="main"&&_!==me&&_!==re&&I(await $(await U(e,t,o),null))&&d(`the Implement tap opened ${t}'s main builder record and no agent has taken it up; run builder start ${t} without --agent first`);const B=A?.dispatched&&!A.done?A:null,P=O&&!o?(await x(e,t)).item:void 0,L=A&&Ve(A).length?A:null,T=B&&N==="build"?{kind:_t(B.kind),model:B.model,reason:{tap:"The owner's Build tap picked it.",hub:"The board's pull picked it."}[B.dispatched]??"The session's dispatch picked it."}:O?An({card:P??{}}):null;T&&N!=="build"&&N!==T.kind&&d(`--kind ${N}: ${T.kind} builds now. ${T.reason} Pass --kind ${T.kind}, or --kind build.`);const M=T?T.kind:N,C=Fa({dir:e});if(!(B&&!f)&&es(C,M))throw new ue(Xo(C,M));const Y=h&&ko(h,qe({kind:M}),"--progress");l!==void 0&&!["opus","sonnet"].includes(l)&&d("--model takes opus or sonnet"),v!==void 0&&M==="codex"&&d("--model is for kind claude; codex needs none");const te=M==="claude"?Pn():"auto";v!==void 0&&te!=="auto"&&v!==te&&d(`--model ${v}: the hub's Claude model is ${te==="opus"?"Opus":"Sonnet"}. Pass --model ${te}, or no --model.`);const V=M==="claude"?v??T?.model??(B&&_t(B.kind)==="claude"?B.model:void 0)??"opus":qe({kind:M})?v??(B?.kind===M?B.model:void 0)??ic[M]:M===re?v??A?.model:void 0,Q={label:n===void 0?"Builder":S(n,"--label"),...M?{kind:M}:{},...V?{model:V}:{},started:k,...u===void 0?{}:{eta:mo(u,"--eta")},...f?{dispatched:f}:{},...L?{calls:L.calls,...L.verified?{verified:L.verified}:{}}:{},...dc(A)?{session:A.session}:{},...M===re&&A?.kind===re?{label:A.label,task:A.task,writes:A.writes,requested:A.requested}:{}},Ze=O&&!o&&!K(P)&&P.lane!=="progress",un=Ze?await $e(e,t,{start:!0}):{lines:[]};let ke,je=null;const Bt=w&&O&&s==="main"?[A?.worktree,P?.worktree].find(ne=>ne?.path&&de(ne.path))??null:null,mt=(B??L)?.worktree??Bt,ht=p??(O&&s==="main"&&!mt?w:void 0);try{if(ht){const ne=await G(g.dirname(g.dirname(m)),F(t).id),fn=(await Promise.all(ne.filter(pe=>pe!==m).map(pe=>$(pe,null)))).filter(pe=>pe?.worktree?.path&&!pe.done).map(pe=>pe.worktree.path);({remade:je,...ke}=await ht({busy:fn}))}else ke=mt}catch(ne){throw Ze&&await fc(e,t,P),ne}await oc(m,A),await y(m,ke?{...Q,worktree:ke}:Q),P?.rebase_run&&s==="main"&&![bo,Aa].includes(Q.label)&&await yo(e,t),T?.inputs&&e&&ps(Ra(e),{call:"builder-pick",key:t,result:[M,M==="claude"?V:null].filter(Boolean).join(" "),reason:T.reason,inputs:{...T.inputs,...v?{askedModel:v}:{},...f?{dispatch:f}:{}}}),je&&e&&await W(e,t,"worktree-remade"),Y&&await ma(e,t,s,Q,Y,k);const ie=_===me||_===re?[]:await en(e,t,"Acted on: builder started");return e&&O&&await vr(e,t),{file:m,kind:M??null,model:V??null,reason:T?.reason??null,worktree:ke?.path??null,lines:[...N==="build"?[`kind: ${M}. ${T.reason}`]:[],...Mt(Q)?[`model: ${Mt(Q)}`]:[],...e?[`ref: ${await H(e,t)}`]:[],...ke?[`worktree: ${ke.path}`]:[],...je?[je]:[],...un.lines,...ie]}}r(Et,"startBuilder");async function oc(e,t){if(!t?.started||!t.done||!e.endsWith(".json")||g.basename(e).includes("@"))return;const{label:n,kind:a,model:i,started:o,done:s,session:c}=t,l=g.join(g.dirname(e),`${g.basename(e,".json")}@past-${Date.parse(o)}.json`);await y(l,{label:n,...a?{kind:a}:{},...i?{model:i}:{},started:o,done:s,...c?.log?{session:{log:c.log}}:{}})}r(oc,"keepPastRun");async function Rd(e,t,n,a="tap"){try{const{held:i,blockers:o}=await rc(e,t);if(i&&await Vi(e,"card-hold",{key:t,hold:!1}),o.length)return await cc(e,t,o);try{const s=await Et(e,t,{kind:"build",worktree:n,dispatch:a});return{key:t,ref:await H(e,t),kind:s.kind,...s.model?{model:s.model}:{},reason:s.reason,worktree:s.worktree}}catch(s){throw i&&await uc(e,t,i),s}}catch(i){if(!(i instanceof ue))throw i;return await W(e,t,Oa,{why:i.message}),null}}r(Rd,"startTappedBuild");async function Ed(e,t,{pr:n,conflict:a,base:i},o){const{source:s,itemFile:c,item:l}=await x(e,t);l.rebase_run={pr:n,base:i,conflict:a,at:new Date().toISOString()},await y(s.file,c);try{const u=await Et(e,t,{kind:"build",label:bo,dispatch:"hub",ownWorktree:o});return{key:t,kind:u.kind,...u.model?{model:u.model}:{},worktree:u.worktree}}catch(u){throw await yo(e,t),u}}r(Ed,"startRebase");const bo="Rebase";async function yo(e,t){const{source:n,itemFile:a,item:i}=await x(e,t);delete i.rebase_run,await y(n.file,a)}r(yo,"endRebaseRun");async function Ld(e,t){const{itemFile:n,item:a}=await x(e,t),i=se(e,n);return Me(a,i).find(o=>o.repo===i)?.number??null}r(Ld,"cardPR");async function Bd(e,t,{from:n,to:a,replayed:i}){const{source:o,itemFile:s,item:c}=await x(e,t);return c.rebase_run?(c.rebased=[...c.rebased||[],{from:n,to:a,base:c.rebase_run.base,replayed:i,at:new Date().toISOString()}],delete c.rebase_run,await y(o.file,s),!0):!1}r(Bd,"recordRebase");const sc=r((e,t,n)=>{const a=new Map((e.rebased||[]).filter(i=>i.replayed).map(i=>[i.to,i.from]));for(let i=n,o=0;i&&o<=a.size;i=a.get(i),o++)if(i===t)return!0;return!1},"onlyRebased");async function rc(e,t){const n=Fa({dir:e});ts(n)&&d(Yo(n));const{item:a}=await x(e,t),i=a.held?{held:a.held,pick_up_at:a.pick_up_at,held_at:a.held_at}:null;return i&&we(a)&&d("it's held. Unhold it, then tap Implement."),await ia(e,t)&&d("no take is picked on its prototypes, so it prototypes again. Pick a take from the next round, then tap Implement."),{held:i,blockers:await Fr(e,t,a)}}r(rc,"tapRefusals");async function Cd(e,t,n){await Je(e,t,{who:"love",by:n,command:"implement"}),await yr(e,t,{})}r(Cd,"implementAsIs");async function cc(e,t,n){const a=n.join(", ");return await he({dir:e},"card-bump",{key:t}),await W(e,t,"cant-start-yet",{names:a}),{key:t,ref:await H(e,t),bumped:n,line:`bumped: ${t} waits on ${a}, so it stays in Todo, bumped to the top`}}r(cc,"bumpBlocked");async function ln(e,t){const n=await U(e,t),a=await $(n,null);return a?.started&&!a.done&&et(a)?{file:n,record:a}:null}r(ln,"openBuild");async function xo(e,t,{cause:n,words:a,by:i,until:o}){const s=await ln(e,t);return!s||s.record.pause?!1:(await y(s.file,{...s.record,pause:{cause:n,words:a,at:new Date().toISOString(),...i?{by:i}:{},...o?{until:o}:{}}}),!0)}r(xo,"requestPause");async function lc(e,t){const n=await ln(e,t),a=n?.record.pause;if(!a||a.paused)return a??null;const i=new Date().toISOString(),o=(await z(Z(e,t))).filter(c=>c.kind==="status"&&c.phase&&!c.planner&&String(c.ts)>=String(n.record.started)).pop()?.phase,s={...a,paused:i,...o?{phase:o}:{}};return await y(n.file,{...n.record,pause:s}),await W(e,t,"paused",{phase:o,words:a.words,clear:Da[a.cause][0]}),s}r(lc,"markPaused");async function dn(e,t,{dir:n,agent:a="main"}){if(!e||n||a!=="main")return[];const i=await lc(e,t);return i?[`Paused: ${i.words}. Commit what you have now with \`git -c core.commentChar=';' commit -F <file>\`, then stop: end your turn and run nothing else. The board resumes this session, telling it so, once the pause clears.`]:[]}r(dn,"pauseReply");async function Id(e,t){const n=await ln(e,t),a=n?.record.pause;if(!a?.paused)return null;const{pause:i,...o}=n.record;return await y(n.file,o),await W(e,t,"resumed",{clear:Da[a.cause][1]}),{pause:a,record:o}}r(Id,"resumePaused");async function Td(e,t){const n=await ln(e,t);if(!n?.record.pause||n.record.pause.paused)return;const{pause:a,...i}=n.record;await y(n.file,i)}r(Td,"dropPause");async function qd(e,t,n){const a=await U(e,t),i=await $(a,null),o=new Date().toISOString();i&&!i.done&&await y(a,{...i,done:o});const{source:s,itemFile:c,item:l}=await x(e,t);l.lane==="progress"&&Ft(l,"todo",o),await y(s.file,c),await W(e,t,Oa,{why:n})}r(qd,"abandonLaunch");async function Md(e,t,[n,a],i="main"){const o=await U(e,t,void 0,i),s=await $(o,null);s&&!s.done&&await y(o,{...s,done:new Date().toISOString()}),await ut(e,t),await W(e,t,n,a)}r(Md,"abandonPlanner");async function Wd(e,t,n,a,i="main",o=null){const s=await U(e,t,void 0,i),c=await $(s,null);await y(s,{...c,session:{id:n,pid:a,log:o,at:new Date().toISOString()}})}r(Wd,"recordSession");async function Ud(e,t){const{source:n}=await x(e,t);return(await Promise.all((await G(n.dir,F(t).id)).map(i=>$(i,null)))).filter(i=>i&&i.started&&!i.done).map(i=>({pid:i.session?.pid??null,at:i.session?.at??null}))}r(Ud,"openAgents");async function Hd(e,t){const{source:n}=await x(e,t);return(await Promise.all((await G(n.dir,F(t).id)).map(i=>$(i,null)))).filter(i=>i&&i.started&&!i.done).map(i=>({kind:i.kind??null,pid:i.session?.pid??null,at:i.session?.at??null}))}r(Hd,"openRuns");async function Jd(e,t,n){const{source:a}=await x(e,t),i=new Date().toISOString();for(const o of await G(a.dir,F(t).id)){const s=await $(o,null);s?.started&&!s.done&&et(s)&&await y(o,{...s,stopped:{run:n,at:i}})}}r(Jd,"markStopped");async function zd(e,t){const{source:n,itemFile:a,item:i}=await x(e,t);i.merge_ready&&(i.merge_ready.stopped=new Date().toISOString(),await y(n.file,a))}r(zd,"stopHeldMerge");async function Kd(e,t,n){const a=S(n,"item stall --reason"),{source:i,itemFile:o,item:s}=await x(e,t);return s.lane==="done"&&d(`${await H(e,t)} is done; there is nothing to stall`),s.stalled={reason:a,at:new Date().toISOString()},await y(i.file,o),a}r(Kd,"markStalled");async function Qd(e,t){const{source:n,itemFile:a,item:i}=await x(e,t);i.stalled&&(delete i.stalled,await y(n.file,a))}r(Qd,"clearStall");async function Gd(e,t){const{item:n}=await x(e,t),a=await z(g.join(e,"data","events.jsonl")),i=r(c=>a.filter(l=>l.kind===c&&l.data?.key===t).map(l=>String(l.ts)).sort().pop()||"","latest"),o=i("card-bump");if(!o||i("card-unbump")>o)return null;const s=[n.closed_at,...De(n).map(c=>c.merged_at)].filter(Boolean).map(String).sort().pop()||"";return o>s?o:null}r(Gd,"landFirst");async function Vd(e,t,n){const{item:a}=await x(e,t);K(a)&&d(`${await H(e,t)} is done; there is nothing to bump`);const i=await he({dir:e},n?"card-bump":"card-unbump",{key:t});return(await z(g.join(e,"data","events.jsonl"))).find(o=>o.id===i).ts}r(Vd,"bumpCard");async function _o(e,t){return(await z(Z(e,t))).filter(n=>n.kind==="status").pop()?.phase==="landing"}r(_o,"isLanding");const dc=r(e=>!!e?.session&&e.session.at>(e.done??e.started),"launchedSession");async function Zd(e,t,n){const a=await $(await U(e,t),null);if(a&&!a.done)return null;const i=await Et(e,t,{kind:n,dispatch:"hub"});return{key:t,kind:n,model:i.model}}r(Zd,"startPlanner");async function Yd(e,t,n){const{source:a}=await x(e,t);if((await Promise.all((await G(a.dir,F(t).id)).map(c=>$(c,null)))).some(c=>c?.kind===me&&c.started&&!c.done))return null;const o=Qo(n);if(await $(await U(e,t,void 0,o),null))return null;const s=await Et(e,t,{kind:me,agent:o,dispatch:"hub"});return{key:t,kind:me,model:s.model,agent:o}}r(Yd,"startVisual");const ha=r(e=>typeof e=="string"&&/^[a-z][a-z0-9-]{0,29}$/.test(e)&&e!=="main"&&!e.startsWith(`${me}-`)?e:d('--name takes a short lowercase name such as tests or docs-pass: letters, digits and "-", not main or visual-\u2026'),"helperName");async function ga(e,t){const{item:n}=await x(e,t);return[(await $(await U(e,t),null))?.worktree,n.worktree].find(i=>i?.path&&de(i.path))??null}r(ga,"cardWorktree");async function Xd(e,t,{name:n,task:a,writes:i,model:o}){D(e);const s=ha(n),c=S(a,"--task");o!==void 0&&!["opus","sonnet"].includes(o)&&d("--model takes opus or sonnet");const l=Pn();o!==void 0&&l!=="auto"&&o!==l&&d(`--model ${o}: the hub's Claude model is ${l==="opus"?"Opus":"Sonnet"}. Pass --model ${l}, or no --model.`);const{item:u}=await x(e,t);K(u)&&d(`${await H(e,t)} is Done; a helper needs an open card`);const p=await U(e,t,void 0,s);return de(p)&&d(`${t} already has an agent named ${s}; pick another --name`),i&&!await ga(e,t)&&d(`a helper that writes branches from ${t}'s worktree, and the card has none; start its build first, or drop --writes`),await y(p,{label:s,kind:re,task:c,writes:!!i,...o?{model:o}:{},requested:new Date().toISOString()}),await W(e,t,"helper-asked",{agent:s,writes:i}),{lines:[`helper ${s} requested: the board launches it ${i?"once an implementer slot is free":"now"}`,`wait for it with agent wait ${t} --name ${s}`]}}r(Xd,"requestHelper");async function eu(e,t,n,a){const i=await U(e,t,void 0,n),o=await $(i,null);if(o?.kind!==re||o.started||o.done)return null;const{item:s}=await x(e,t),c=An({card:s}),l=Pn(),u=o.model??(l!=="auto"?l:c.kind==="claude"?c.model:"opus"),p=o.writes?await ga(e,t):null;o.writes&&!p&&d(`${t} has no worktree for helper ${n} to branch from`),await y(i,{...o,model:u});const w=await Et(e,t,{agent:n,kind:re,dispatch:"hub",worktree:p?({busy:f})=>a({repo:p.repo,base:p.branch,busy:f}):void 0});return{key:t,kind:re,model:u,agent:n,task:o.task,writes:o.writes,worktree:w.worktree}}r(eu,"startHelper");async function tu(e,t,n){const a=await $(await U(e,t,void 0,ha(n)),null);return a?.kind!==re&&d(`${t} has no helper named ${n}`),{record:a,card:await ga(e,t)}}r(tu,"helperOf");async function nu(e,t,{name:n,agent:a="main",timeout:i=9,every:o=2e3,alive:s}){D(e);const c=Number(i);c>0||d("--timeout takes minutes, a number above 0");const l=await U(e,t,void 0,ha(n)),u=await U(e,t,void 0,a),p=r(async f=>{const h=await $(u,null);if(!h?.started||h.done)return;const{waits:m,...k}=h;await y(u,f?{...k,waits:f}:k)},"mark"),w=Date.now()+c*6e4;await p(n);try{for(;;){const f=await $(l,null);if(f?.kind!==re&&d(`${t} has no helper named ${n}`),f.done){const m=f.writes&&f.worktree?[`branch ${f.worktree.branch} in ${f.worktree.path}: merge it with agent merge ${t} --name ${n}`]:[];return{lines:[`helper ${n} done: ${f.note??"no hand-back"}`,...m]}}const h=f.session?.pid??null;h&&!s(h)&&d(`helper ${n}'s process exited without builder done; do its task yourself`),Date.now()>=w&&d(`helper ${n} is still ${f.started?"running":f.writes?"waiting for an implementer slot":"waiting to launch"} after ${c} minutes; run agent wait again`),await new Promise(m=>setTimeout(m,o))}}finally{await p(null)}}r(nu,"waitHelper");async function au(e,t,n="main"){return n==="main"?!1:(await $(await U(e,t,void 0,n),null))?.kind===re}r(au,"isHelper");async function iu(e,t,n="main"){const a=await $(await U(e,t,void 0,n),null);return!!(a?.started&&!a.done&&qe(a))}r(iu,"isPlanner");async function ou(e,t,{file:n,title:a}){D(e);const i=S(a,"--title");(typeof n!="string"||!n.endsWith(".html"))&&d("--file takes the page, an .html file");const o=await j.readFile(g.resolve(n),"utf8").catch(()=>d(`--file ${n} can't be read`));o.trim()||d(`--file ${n} is empty`),await x(e,t);const{id:s}=F(t),c=g.join(e,"public","visuals",s);await j.mkdir(c,{recursive:!0});const l=i.toLowerCase().replace(/[^a-z0-9]+/g,"-").slice(0,60).replace(/^-+|-+$/g,"")||"visual";let u=`${l}.html`;for(let w=2;de(g.join(c,u));w++)u=`${l}-${w}.html`;await j.writeFile(g.join(c,u),o,{flag:"wx"});const p=`visuals/${s}/${u}`;return await le(Z(e,t),{ts:new Date().toISOString(),who:"claude",kind:me,text:S(i,"--name"),link:En(p,"--link")}),{lines:[p]}}r(ou,"addVisual");async function su(e){const t=[];for(const n of await q(e)){const a=await $(n.file,null);for(const i of a?.items||[]){if(K(i))continue;const o=await $(g.join(n.dir,"agents",`${i.id}.json`),null);!o?.started||o.done||!o.dispatched||qe(o)||t.push({key:`${n.slug}/${i.id}`,kind:_t(o.kind),model:o.model})}}return t}r(su,"cutOffBuilds");async function uc(e,t,n){const{source:a,itemFile:i,item:o}=await x(e,t);for(const s of Object.keys(n))n[s]===void 0?delete o[s]:o[s]=n[s];await y(a.file,i)}r(uc,"restoreHold");async function fc(e,t,n){const{source:a,itemFile:i,item:o}=await x(e,t);for(const s of["lane","lane_at","closed_at","reopened_at"])n[s]===void 0?delete o[s]:o[s]=n[s];await y(a.file,i)}r(fc,"restoreLane");async function ru(e,t){return e||d("audit reads a board: pass --site <route>"),t!==void 0&&F(t),{lines:ms(hs(Ra(e),{key:t}))}}r(ru,"auditLog");const wc=["codex","claude"];async function cu(e,t){const{item:n}=await x(e,t),{kind:a,model:i,reason:o}=An({card:n});return{lines:[`${[a,i].filter(Boolean).join(" ")}: ${o}`]}}r(cu,"pickBuilder");async function So(e,t,{dir:n}={}){const{id:a}=F(t),i=g.dirname(await U(e,t,n)),o=await G(g.dirname(i),a);return(await Promise.all(o.map(c=>$(c,null)))).filter(c=>c?.worktree?.path).sort((c,l)=>String(l.started).localeCompare(String(c.started)))[0]?.worktree??null}r(So,"recordedWorktree");async function lu(e,t){const{source:n}=await x(e,t),i=(await Promise.all((await G(n.dir,F(t).id)).map(o=>$(o,null)))).filter(o=>o?.session?.id&&o.worktree?.path).sort((o,s)=>String(s.started).localeCompare(String(o.started)))[0];return i?{id:i.session.id,worktree:i.worktree.path}:null}r(lu,"recordedSession");async function du(e,t,n,{phase:a,dir:i,agent:o="main",eta:s,clearEta:c}){s!==void 0&&c&&d("pass --eta or --clear-eta, not both");const l=$o(e,a,n,"builder progress"),u=await U(e,t,i,o),p=await $(u,null);(!p?.started||p.done)&&d(`builder progress needs an open builder record on ${t}; run builder start first`);const w=ko(l,qe(p),"builder progress");return s!==void 0&&(p.eta=mo(s,"--eta")),c&&delete p.eta,(s!==void 0||c)&&await y(u,p),await ma(e,t,o,p,w,new Date().toISOString()),{file:u,lines:await dn(e,t,{dir:i,agent:o})}}r(du,"builderProgress");async function uu(e,t){const{source:n}=await x(e,t),a=Z(e,t);if((await z(a)).filter(s=>s.kind==="status").pop()?.phase==="landing")return;const o=(await Promise.all((await G(n.dir,F(t).id)).map(s=>$(s,null)))).filter(s=>s?.started&&et(s)&&s.label!==Aa).map(s=>s.started).sort().pop();await le(a,{ts:new Date().toISOString(),who:"claude",kind:"status",phase:"landing",text:"Landing: rebasing onto main and landing",...o?{run:o}:{}})}r(uu,"landingLine");const Ve=r(e=>(e?.calls||[]).filter(t=>!e.verified||t.at>e.verified.at),"unverifiedCalls");async function fu(e,t,n,{dir:a,agent:i="main"}){const o=S(n,"builder call");/\n/.test(o)&&d("builder call takes one line; record each call on its own");const s=await U(e,t,a,i),c=await $(s,null);return(!c?.started||c.done)&&d(`builder call needs an open builder record on ${t}; run builder start first`),await y(s,{...c,calls:[...c.calls||[],{at:new Date().toISOString(),text:o}]}),{file:s,lines:await dn(e,t,{dir:a,agent:i})}}r(fu,"recordCall");async function Lt(e,t){const n=await z(Z(e,t)),a=new Map(n.filter(i=>i.kind===Tt.answer).map(i=>[i.ask,i]));return n.filter(i=>i.kind===Tt.ask).map(i=>{const o=a.get(i.ask);return{id:i.ask,agent:i.agent||"main",text:i.text,at:i.ts,answer:o?{text:o.text,at:o.ts}:null,deferred:!!o?.deferred}})}r(Lt,"builderAsks");const pc=r(e=>ge().find(t=>Pe(t.dir,e))??{dir:e},"boardTarget");async function wu(e,t,n,{agent:a="main"}){D(e);const i=S(n,"builder ask");/\n/.test(i)&&d("builder ask takes one line; ask each question on its own");const o=await $(await U(e,t,void 0,a),null);(!o?.started||o.done)&&d(`builder ask needs an open builder record on ${t}; run builder start first`);const s=`ask${(await Lt(e,t)).length+1}`;return await le(Z(e,t),{ts:new Date().toISOString(),who:`${Mt(o)||o.kind||"Claude"} builder`,kind:Tt.ask,ask:s,agent:a,text:i}),await he(pc(e),"builder-ask",{key:t,ask:s,agent:a,text:i}),{id:s,lines:await dn(e,t,{agent:a})}}r(wu,"askOrchestrator");async function pu(e,t,n,a,{deferred:i=!1}={}){D(e);const o=S(a,"--text"),s=(await Lt(e,t)).find(l=>l.id===n)||d(`no ask "${n}" on ${t}; builder asks ${t} lists them`);s.answer&&d(`${n} on ${t} is already ${s.deferred?"deferred":"answered"}`);const c=new Date().toISOString();if(await le(Z(e,t),{ts:c,who:"claude",kind:Tt.answer,ask:n,...i?{deferred:!0}:{},text:o}),i){const l=await U(e,t,void 0,s.agent),u=await $(l,null);u&&await y(l,{...u,calls:[...u.calls||[],{at:c,text:`Question: ${s.text} (deferred to the owner)`}]})}return{lines:[]}}r(pu,"answerBuilder");async function mu(e,t,{wait:n=!1,timeout:a=9,every:i=2e3}={}){D(e);const o=Number(a);o>0||d("--timeout takes minutes, a number above 0");const s=Date.now()+o*6e4;for(;;){const c=await Lt(e,t);if(!c.length)return{lines:["no asks yet"]};const l=c.filter(w=>!w.answer),u=c.flatMap(w=>[`${w.id}. ${w.text}`,` ${w.answer?`${w.deferred?"deferred":"answered"}: ${w.answer.text}`:"waiting on the orchestrator"}`]);if(!n||!l.length)return{lines:u};const p=await dn(e,t,{});if(p.length)return{lines:[...u,...p]};Date.now()>=s&&d(`${l.map(w=>w.id).join(", ")} still waiting on the orchestrator after ${o} minutes; run builder asks ${t} --wait again`),await new Promise(w=>setTimeout(w,i))}}r(mu,"listAsks");async function mc(e,t,n){const a=t.topic.startsWith("item:")&&!t.topic.startsWith("item:ask:")?t.topic.slice(5):d(`${n}.ask goes on a card's question, topic item:<file>/<id>`),i=(await Lt(e,a)).find(o=>o.id===t.ask)||d(`${n}.ask names no ask "${t.ask}" on ${a}; builder asks ${a} lists them`);i.deferred||d(`${n}.ask names ${i.id}, which the orchestrator ${i.answer?"answered":"has not deferred"}; only a deferred ask goes to the owner`)}r(mc,"checkAskQuestion");async function hu(e,t,{dir:n,agent:a="main"}){const i=await $(await U(e,t,n,a),null),o=i?.calls||[];if(!o.length)return{lines:["no judgment calls recorded"]};const{verified:s}=i,c=Ve(i).length?"not verified yet":`verified ${s.at}${s.note?`: ${s.note}`:""}`;return{lines:[...o.map((l,u)=>`${u+1}. ${l.text}`),c]}}r(hu,"listCalls");async function gu(e,t,{dir:n,agent:a="main",note:i}){const o=await U(e,t,n,a),s=await $(o,null);if(Ve(s).length||d(`${t} has no unverified judgment calls${a==="main"?"":` from agent ${a}`}; builder calls ${t} lists them`),e){const c=new Set((await $(E(e),{items:[]})).items?.filter(u=>u.topic===`item:${t}`&&u.ask).map(u=>u.ask)),l=(await Lt(e,t)).find(u=>u.deferred&&u.agent===a&&!c.has(u.id));l&&d(`${l.id} on ${t} was deferred to the owner; add its question with "ask": "${l.id}" first`)}return await y(o,{...s,verified:{at:new Date().toISOString(),...i===void 0?{}:{note:S(i,"--note")}}}),o}r(gu,"verifyCalls");async function $u(e,t){const{source:n,item:a}=await x(e,t),i=r((s,c)=>[(s.options||[]).find(l=>l.id===c.choice)?.label,c.note].filter(Boolean).join(": ")||"answered","said"),o=(await fe(e,t)).asked.filter(s=>s.ask&&s.answers.length).map(s=>({ask:s.ask,question:s.question,answer:i(s,s.answers.at(-1))}));return{key:t,ref:await H(e,t),title:a.title||t,notes:a.plan?g.join(n.dir,a.plan):null,thread:Z(e,t),worktree:(await So(e,t))?.path??null,answers:o,links:await hc(e,t),rebasePR:a.rebase_run?.pr??null,ticketQuestion:!a.ticket&&!!await sn(e)}}r($u,"briefFacts");async function hc(e,t){const n=new Map;for(const c of await q(e))for(const l of(await $(c.file,null))?.items||[])n.set(`${c.slug}/${l.id}`,{entry:c,it:l});const a=F(t).file,{it:i}=n.get(t),o=[...n].filter(([,c])=>(c.it.related||[]).some(l=>J(c.entry.slug,l)===t)).map(([c])=>c),s=[...i.parent?[["parent",J(a,i.parent)]]:[],...(i.deps||[]).map(c=>["depends on",J(a,c)]),...[...new Set([...(i.related||[]).map(c=>J(a,c)),...o])].map(c=>["related",c])].filter(([,c])=>n.has(c));return Promise.all(s.map(async([c,l])=>{const{entry:u,it:p}=n.get(l);return{relation:c,ref:await H(e,l),title:p.title||l,lane:Ce[p.lane||"todo"],notes:p.plan?g.join(u.dir,p.plan):null,thread:Z(e,l)}}))}r(hc,"cardLinks");async function ku(e){const t=[];for(const n of await q(e)){const a=await $(n.file,null);for(const i of a?.items||[]){if(K(i))continue;const o=(await Promise.all((await G(n.dir,i.id)).map(u=>$(u,null)))).filter(Boolean);if(!Sn(o))continue;const s=o.map(u=>u.verified?.at).filter(Boolean).sort().at(-1);if(!s||o.some(u=>Ve(u).length))continue;const c=`${n.slug}/${i.id}`;if((await fe(e,c)).asked.some(u=>u.state==="open")||await tn(e,c,i))continue;const l=o.filter(u=>u.worktree?.path).sort((u,p)=>String(p.started).localeCompare(String(u.started)))[0];l&&de(l.worktree.path)&&t.push({key:c,verified:s,kind:_t(l.kind),model:l.model})}}return t}r(ku,"landable");async function bu(e,t){const{source:n,item:a}=await x(e,t);(await Promise.all((await G(n.dir,a.id)).map(c=>$(c,null)))).some(c=>c?.started&&!c.done)||d(`${t} has no open builder; only a card whose lander stopped has one to relaunch`),await $e(e,t,{handBack:!0,next:"A lander relaunches to land the verified build"});const o=g.join(e,"data","landers.json"),s=await $(o,{});delete s[t],await j.writeFile(o+".tmp",JSON.stringify(s)+`
38
+ `),await j.rename(o+".tmp",o)}r(bu,"relaunchLander");async function yu(e,t,{dir:n}={}){const{id:a}=F(t),i=await G(g.dirname(g.dirname(await U(e,t,n))),a),o=[];for(const s of i){if(!Ve(await $(s,null)).length)continue;const c=g.basename(s,".json").slice(String(a).length+1)||"main";o.push(c==="main"?"":` --agent ${c}`)}o.length&&d(`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(yu,"checkCallsVerified");async function xu(e,t,{dir:n,agent:a="main",next:i}){const o=await $(await U(e,t,n,a),null),s=o&&!o.done?Ve(o):[];if(!s.length)return null;i!==void 0&&d(`builder done sets ${t}'s Next itself while its record has judgment calls; run it without --next`);const c=s.some(u=>u.text.startsWith("Question:"))?"Answer the builder's questions":"Verify the builder's judgment calls",l=await $e(e,t,{handBack:!0,next:c});return{lines:[`handed back: Next "${c}"`,...l.lines]}}r(xu,"handBackCalls");async function _u(e,t,{agent:n="main"}){if(n!=="main")return!1;const a=await U(e,t,void 0,n),i=await $(a,null);if(!i?.started||i.done||!i.worktree?.path)return!1;const{id:o}=F(t);for(const s of await G(g.dirname(g.dirname(a)),o)){const c=s===a?null:await $(s,null);if(!c?.started||c.done||c.kind==="install")continue;const l=g.basename(s,".json").slice(String(o).length+1);d(`builder done would finish ${t} while agent ${l} is still open; run builder done ${t} --agent ${l} first`)}return!0}r(_u,"finishesCard");async function Su(e,t){const{source:n,item:a}=await x(e,t);if(K(a))return null;const i=(await Promise.all((await G(n.dir,a.id)).map(s=>$(s,null)))).filter(Boolean);if(!Sn(i)||i.some(s=>Ve(s).length||s.started&&!s.done&&s.kind!=="install"))return null;const o=await So(e,t);return!o||!de(o.path)?null:{waits:(await fe(e,t)).asked.filter(s=>s.state==="open").map(s=>s.id)}}r(Su,"verifiedFinish");async function vu(e,t){const{item:n}=await x(e,t);if(n.reopened_at&&d(`the owner reopened ${await H(e,t)}; it closes on the owner's Done`),n.lane!=="done"||De(n).some(o=>o.merged_at))return;const a=String(n.closed_at||"");(await z(g.join(e,"data","events.jsonl"))).some(o=>o.kind==="item-message"&&o.data?.key===t&&String(o.ts)>a)&&d(`the owner reopened ${await H(e,t)} with a message; it closes on the owner's Done`)}r(vu,"checkNotReopened");async function G(e,t){const n=g.join(e,"agents");return(await j.readdir(n).catch(()=>[])).filter(a=>a===`${t}.json`||a.startsWith(`${t}@`)&&!a.startsWith(`${t}@past-`)&&a.endsWith(".json")).map(a=>g.join(n,a))}r(G,"builderFiles");async function vo(e,t,n,{handedBack:a,endHandBack:i=!1,held:o=!1}={}){const s=new Date().toISOString();for(const c of await G(e,t)){const l=await $(c,null);if(!l)continue;if(l.done||l.kind==="install"&&!n){if(i&&l.handed_back){const{handed_back:f,...h}=l;await y(c,h)}continue}if(o&&l.pause)continue;const{eta:u,handed_back:p,...w}=l;await y(c,{...w,done:s,...a?{handed_back:a}:{},...o&&l.started?{hold_stopped:!0}:{}})}}r(vo,"closeBuilders");async function ju(e,t){const n=await U(e,t),a=await $(n,null);if(!a?.hold_stopped)return null;const{hold_stopped:i,...o}=a;return await y(n,o),{kind:a.kind??null,label:a.label??null}}r(ju,"takeHoldStopped");async function gc(e,t,{dir:n,agent:a,startedBetween:i,note:o,next:s,requireNext:c=!1}){const l=await U(e,t,n,a),u=await $(l,null);if(!u||u.done)return l;if(i){const I=Date.parse(u.started);if(!(I>=i[0]&&I<=i[1]))return l}const{eta:p,...w}=u,f=new Date().toISOString(),h={...w,done:f,...o?{note:o}:{}},{id:m}=F(t),k=g.dirname(g.dirname(l)),_=await Promise.all((await G(k,m)).map(I=>I===l?h:$(I,null))),N=!_.some(I=>I?.started&&!I.done),v=n?{file:g.join(k,"wave.json")}:(await x(e,t)).source,O=await $(v.file,null),A=O?.items?.find(I=>I.id===m);return s!==void 0&&(Li(A||d(`${t} has no item to set --next on`),s,await aa(e,t)),e&&await Hi(e,t,A,A.next)),c&&A&&vn(A,_)&&d(`builder done closes ${t}'s last open builder, which leaves it In Progress with no Next; pass --next "<what happens next>", or record a judgment call with builder call ${t} or land`),await y(l,h),await ut(e,t,{screen:u.kind==="grill"}),o&&await ma(e,t,a,u,{detail:o},f),s!==void 0&&await y(v.file,O),l}r(gc,"stopBuilder");async function $c(e){const t=[];for(const n of await q(e)){const a=await $(n.file,null);for(const i of a?.items||[])for(const o of await G(n.dir,i.id)){const s=await $(o,null);if(!s?.started||s.done)continue;const c=g.basename(o,".json");t.push({key:`${n.slug}/${i.id}`,agent:c.slice(String(i.id).length+1)||"main",label:s.label||"Builder",started:s.started})}}return t}r($c,"openBoardBuilders");async function Ou(e){const t=await $c(e);for(const n of t)await gc(e,n.key,{agent:n.agent,note:"Board closed. Builder record stopped; work is kept for reopening."});return t}r(Ou,"closeBoardBuilders");export{ue as BoardError,Ja as PUSH_LINE_MAX,Jt as REPLY_EXTS,Ts as SCREEN_AFTER,In as UPLOAD_LIMIT,tl as WORKING_KINDS,qd as abandonLaunch,Md as abandonPlanner,kl as ackPing,bd as addItem,Yl as addNotes,Ul as addPrototype,Kl as addQuestions,Dl as addReviewers,Il as addRuleTo,Wl as addTopic,ou as addVisual,pu as answerBuilder,wl as answerCard,rt as appendMessage,W as appendStatus,jd as archiveCards,vd as archiveCount,rn as archiveFile,cn as archiveRank,wu as askOrchestrator,rd as askedGate,ru as auditLog,tn as blockWords,oe as boardConfig,se as boardRepoOf,wd as breakOwnerCheck,$u as briefFacts,kd as builderModel,du as builderProgress,Vd as bumpCard,Al as cardLinked,H as cardName,Ld as cardPR,Dd as changeWave,yu as checkCallsVerified,sd as checkClose,vu as checkNotReopened,Qd as clearStall,Ou as closeBoardBuilders,Pd as createWave,su as cutOffBuilds,fl as dropAskCard,Td as dropPause,Tl as editRuleIn,cl as eventCard,Ll as fallBackFromLinear,ll as fileAsk,dl as fileAsks,bl as finishHandshake,Fd as finishWave,_u as finishesCard,xu as handBackCalls,gd as heldMerge,tu as helperOf,za as hiddenFile,Cd as implementAsIs,ld as isFinished,au as isHelper,_o as isLanding,iu as isPlanner,q as itemSources,Gd as landFirst,ku as landable,uu as landingLine,mu as listAsks,hu as listCalls,Hl as listPrototypes,Cl as listRules,lc as markPaused,ol as markRead,Kd as markStalled,Jd as markStopped,nl as markWorking,hd as mergeCard,Tr as mergedLine,zt as messageText,yd as migrateFollowups,_d as migratePhases,xd as migrateStatuses,Ad as migrateWaveNames,hl as moveAsk,cd as moveCard,ad as moveQuestions,Ud as openAgents,$c as openBoardBuilders,Hd as openRuns,El as opensPRs,F as parseKey,fd as passOwnerCheck,cu as pickBuilder,ud as pickUp,td as planAgain,Pl as postDigest,$l as postIncomingReview,xl as postLink,md as postPR,_l as postReply,pd as prReport,Gl as publishScreened,Vl as publishUnscreened,Gs as pushLine,Vs as pushUrl,vl as queuePushes,Le as readArchive,_e as readAskLinks,Kn as readBoardRules,or as readBoardSettings,di as readHandshake,Ys as readHidden,$ as readJSON,Xs as readMarks,Qa as readMarksFile,Ir as readNotes,Qt as readPRSlack,Pt as readPrototypes,xi as readScreening,rl as readUpload,Nd as readWaveNotes,Ws as readWorking,fu as recordCall,Vi as recordOwnerTap,Hs as recordPush,Sl as recordReaction,Bd as recordRebase,gl as recordReview,Wd as recordSession,lu as recordedSession,So as recordedWorktree,pl as relateAsk,bu as relaunchLander,zl as removePrototype,Fl as removeReviewers,ql as removeRuleFrom,Us as repliesSincePush,Ln as replyFilesOf,Xd as requestHelper,xo as requestPause,id as resolveNoteAnswers,nd as resolveQuestion,Id as resumePaused,ul as retitleAskCard,ar as reviewDigest,jl as reviewDue,Ol as reviewUpdated,Ml as saveBoardRules,lt as saveBoardSettings,Nl as saveBoardShare,sl as saveUpload,al as sendPush,Jl as servedRoundsOpen,Rl as setBoardPause,Bl as setBoardSetting,il as setHidden,$e as setItem,dd as setMainInstall,yl as setReviewers,sr as settingsLines,Se as settingsOf,Zl as settleAnswers,Ql as settleQuestion,Xc as siteDir,Is as sitesDir,Xl as splitSharedNotes,yr as stageImplement,Sd as stageImplementAsks,ed as stageReply,Et as startBuilder,eu as startHelper,Zd as startPlanner,Ed as startRebase,Rd as startTappedBuild,Yd as startVisual,gc as stopBuilder,zd as stopHeldMerge,Od as stripDeadFields,Zn as takeFile,ju as takeHoldStopped,$d as tapMerge,Z as threadFile,Ri as topicQuestions,ml as unfoldAsk,od as unrecorded,Su as verifiedFinish,gu as verifyCalls,nu as waitHelper,ua as waveNoteFile,Ut as wavesDir,Qs as withReplies,el as writeReply};