@lovek4d/kickflip 0.3.1 → 0.5.0

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 (111) hide show
  1. package/CONTEXT.md +170 -118
  2. package/README.md +23 -14
  3. package/SKILL.md +40 -38
  4. package/bin/doctor.mjs +4 -4
  5. package/bin/install.mjs +3 -3
  6. package/bin/kickflip.mjs +34 -26
  7. package/bin/wait-events.mjs +2 -2
  8. package/board/arch-review.mjs +1 -1
  9. package/board/auto-review.mjs +2 -0
  10. package/board/bin/board.mjs +213 -74
  11. package/board/domain.mjs +8 -5
  12. package/board/finish.mjs +4 -0
  13. package/board/headless.mjs +4 -0
  14. package/board/merge3.mjs +1 -0
  15. package/board/on-host.mjs +1 -1
  16. package/board/permissions.mjs +2 -0
  17. package/board/public/app-arch.js +2 -2
  18. package/board/public/app-asks.js +39 -103
  19. package/board/public/app-banner.js +2 -2
  20. package/board/public/app-cards.js +166 -73
  21. package/board/public/app-core.js +2 -23
  22. package/board/public/app-header.js +12 -5
  23. package/board/public/app-lanes.js +201 -47
  24. package/board/public/app-needs.js +2 -1
  25. package/board/public/app-reader.js +174 -0
  26. package/board/public/app-snapshot.js +2 -2
  27. package/board/public/app-threads.js +53 -42
  28. package/board/public/app.html +4 -1
  29. package/board/public/app.js +78 -96
  30. package/board/public/attach.js +39 -3
  31. package/board/public/dialogs.js +59 -14
  32. package/board/public/hub-kit.js +9 -6
  33. package/board/public/hub.css +6 -18
  34. package/board/public/linear-key.js +6 -4
  35. package/board/public/log.html +48 -0
  36. package/board/public/new-task.js +121 -0
  37. package/board/public/prompts.js +9 -8
  38. package/board/public/prototype-kit.js +6 -6
  39. package/board/public/prototype-switcher.js +13 -5
  40. package/board/public/prototype.html +1 -0
  41. package/board/public/router.js +8 -7
  42. package/board/public/rules-editor.js +3 -4
  43. package/board/public/shell.js +24 -6
  44. package/board/public/sidebar.css +22 -1
  45. package/board/public/sidebar.js +64 -31
  46. package/board/public/style.css +245 -64
  47. package/board/public/toasts.js +2 -2
  48. package/board/public/ui-cards.js +205 -75
  49. package/board/public/ui-enums.js +6 -5
  50. package/board/public/ui-header.js +10 -10
  51. package/board/public/ui-hub.js +4 -4
  52. package/board/public/ui-markdown.js +1 -1
  53. package/board/public/ui-order.js +9 -6
  54. package/board/public/ui-page-header.js +10 -7
  55. package/board/public/ui-patch.js +53 -0
  56. package/board/public/ui-phase-bars.js +17 -0
  57. package/board/public/ui-prompts.js +8 -8
  58. package/board/public/ui-questions.js +61 -29
  59. package/board/public/ui-sidebar.js +54 -24
  60. package/board/public/ui-snapshot.js +20 -9
  61. package/board/public/ui-threads.js +40 -21
  62. package/board/public/ui.js +116 -18
  63. package/board/public/view-frame.js +2 -1
  64. package/board/public/view-hub-settings.js +25 -18
  65. package/board/public/view-hub.js +53 -12
  66. package/board/public/view-notes.js +1 -1
  67. package/board/public/view-questions.js +142 -62
  68. package/board/public/view-settings.js +189 -52
  69. package/board/review.mjs +1 -1
  70. package/board/server.mjs +20 -12
  71. package/board/store.mjs +15 -12
  72. package/board/tickets.mjs +3 -3
  73. package/board/worktree.mjs +21 -15
  74. package/docs/hub-session.md +4 -4
  75. package/hooks-plugin/hooks/codex-share-auto.mjs +1 -1
  76. package/hooks-plugin/hooks/watcher-stop.mjs +2 -2
  77. package/hub/board-repo.mjs +1 -1
  78. package/hub/boards.mjs +4 -4
  79. package/hub/close-board.mjs +1 -1
  80. package/hub/front-door.mjs +20 -0
  81. package/hub/github.mjs +4 -4
  82. package/hub/home.mjs +1 -1
  83. package/hub/hub.mjs +11 -14
  84. package/hub/incoming.mjs +2 -0
  85. package/hub/linear.mjs +2 -2
  86. package/hub/live.mjs +2 -2
  87. package/hub/new-board.mjs +2 -2
  88. package/hub/owner-checks.mjs +1 -0
  89. package/hub/permission-denied-hook.mjs +2 -0
  90. package/hub/pr-report.mjs +3 -1
  91. package/hub/presence.mjs +1 -1
  92. package/hub/prompts.mjs +1 -1
  93. package/hub/push.mjs +2 -2
  94. package/hub/readiness.mjs +2 -2
  95. package/hub/repos.mjs +3 -3
  96. package/hub/restart-board.mjs +1 -1
  97. package/hub/schedule.mjs +1 -1
  98. package/hub/sessions.mjs +2 -2
  99. package/hub/sw.js +1 -1
  100. package/hub/try.mjs +8 -4
  101. package/hub/usage.mjs +3 -3
  102. package/hub/views.mjs +1 -1
  103. package/package.json +5 -1
  104. package/shared/card-prs.mjs +1 -0
  105. package/shared/colors.css +5 -4
  106. package/shared/fake-gh.mjs +59 -8
  107. package/shared/owner-check.mjs +3 -0
  108. package/shared/repos.mjs +1 -1
  109. package/shared/tailscale.mjs +1 -0
  110. package/shared/usage-gate.mjs +1 -1
  111. package/board/public/view-polling.js +0 -87
package/board/store.mjs CHANGED
@@ -1,15 +1,18 @@
1
- var Un=Object.defineProperty;var r=(e,t)=>Un(e,"name",{value:t,configurable:!0});import D from"node:fs/promises";import{constants as Wn}from"node:fs";import h from"node:path";import Je from"node:os";import{execFile as Rt}from"node:child_process";import{fileURLToPath as Hn}from"node:url";import{BUILD_REFUSED as Nt,ITEM_STATUSES as Et,builds as Kn,mergeBlockers as Jn,modelName as ze,noTakePicked as zn,ownerQuestion as ge,plans as Tt,providerOf as Ge,owesNext as Qe,pushTag as Gn,refOf as ke,roundOf as Ze,roundSettledBy as Qn}from"./domain.mjs";import{GITHUB_STATE as Lt,appendEvent as Ve,listBoards as Ae,samePath as Pe}from"../hub/boards.mjs";import{readUsageGate as Bt,pauseReason as Ct,builderPick as It}from"../shared/usage-gate.mjs";import{reviseQueued as Zn,flushQueue as Vn,queueStatus as Yn,readSettings as Xn,pushKindError as ei,readClaudeModel as ti}from"../hub/push.mjs";import{holdLine as ni,windowAt as ii}from"../hub/schedule.mjs";import{AT_RE as ai}from"../hub/duration.mjs";import{routeRecord as I}from"../hub/routes.mjs";import{ticketSource as Ye,ticketIn as Xe,resolveTicket as oi,ticketTarget as si,moveTicket as ri,titleTickets as ci,mcpCreateLine as di,cardIdOf as li}from"./tickets.mjs";import{validateBranch as ui}from"../hub/repos.mjs";import{withFileLock as qt}from"../hub/locks.mjs";import{fetchPR as Ft,reportOf as Mt,githubLogin as fi}from"../hub/pr-report.mjs";import{reviewLinks as et,topicItems as tt,reviewersOf as nt}from"./review.mjs";import{readiness as Ut}from"../hub/readiness.mjs";import{slackDay as Wt}from"../hub/slack.mjs";import"../bin/install.mjs";import{RuleError as pi,rulesOf as Ht,addRule as wi,editRule as mi,removeRule as hi,applyRules as $i,readHubRules as Re,writeHubRules as gi}from"../hub/rules.mjs";class Q extends Error{static{r(this,"BoardError")}}const c=r(e=>{throw new Q(e)},"fail"),ki=r(()=>h.join(Je.homedir(),".claude","kickflip","sites"),"sitesDir"),Ne=r(()=>h.join(Je.homedir(),".claude","waves"),"wavesDir"),y=r(async(e,t)=>{try{return JSON.parse(await D.readFile(e,"utf8"))}catch{return t}},"readJSON"),U=r(async e=>{try{return(await D.readFile(e,"utf8")).split(`
2
- `).filter(Boolean).map(t=>JSON.parse(t))}catch{return[]}},"readLines");async function it(e,t){await D.mkdir(h.dirname(e),{recursive:!0});const i=`${e}.${process.pid}.tmp`;await D.writeFile(i,t),await D.rename(i,e)}r(it,"replace");const x=r((e,t)=>it(e,JSON.stringify(t,null,2)+`
3
- `),"writeJSON");async function V(e,t){await D.mkdir(h.dirname(e),{recursive:!0}),await D.appendFile(e,JSON.stringify(t)+`
4
- `)}r(V,"appendLine");async function za(e){/^[\w-]+$/.test(e||"")||c(`--site takes a route such as ios-orchestrator, not "${e}"`);const t=h.join(ki(),e);return await D.stat(t).then(i=>i.isDirectory(),()=>!1)||c(`no site at ${t}`),t}r(za,"siteDir");const W=r(async e=>({title:"Board",items:"waves",...e?await y(h.join(e,"board.json"),{}):{}}),"boardConfig");async function C(e){const t=await W(e);if(t.items==="waves")try{return(await D.readdir(Ne(),{withFileTypes:!0})).filter(n=>n.isDirectory()).map(n=>({slug:n.name,dir:h.join(Ne(),n.name),file:h.join(Ne(),n.name,"wave.json")}))}catch{return[]}const i=h.resolve(e,t.items);return[{slug:t.slug||h.basename(t.items,".json"),dir:h.dirname(i),file:i}]}r(C,"itemSources");const H=r((e,t)=>h.join(e,"data","threads",t.replace(/[^\w.-]+/g,"__")+".jsonl"),"threadFile"),q=r(e=>h.join(e,"data","owner.json"),"ownerFile"),O=r(e=>e||c("this command needs --site <route>"),"needSite"),_=r((e,t)=>typeof e=="string"&&e.trim()?e.trim():c(`${t} must be non-empty text`),"text"),z=r((e,t)=>e===void 0?void 0:t(e),"optional"),yi=/^prototype-[\w-]+\.html(?:[?#]\S*)?$/,Kt=r((e,t)=>typeof e=="string"&&(yi.test(e)||/^https?:\/\/\S+$/.test(e))?e:c(`${t} must be an http(s) URL or a site page such as prototype-<topic>.html?q=<id>`),"pageUrl"),at=r((e,t)=>typeof e=="boolean"?e:c(`${t} must be true or false`),"bool"),te=r((e,t)=>typeof e=="string"&&/^[\w.-]+$/.test(e)?e:c(`${t} must use only letters, digits, "_", "." and "-"`),"domId"),ye=r((e,t,i)=>{(!e||typeof e!="object"||Array.isArray(e))&&c(`${i} must be a JSON object`);const n=Object.keys(e).filter(a=>!t.includes(a));n.length&&c(`${i} has unknown field ${n.map(a=>`"${a}"`).join(", ")}; allowed: ${t.join(", ")}`)},"onlyKeys");function T(e){const t=/^([^/\s]+)\/([^/\s]+)$/.exec(e||"");return t?{wave:t[1],id:t[2]}:c(`expected <wave>/<id>, not "${e}"`)}r(T,"parseKey");async function le(e,t){const i=(await C(e)).find(a=>a.slug===t)||c(`this board has no wave "${t}"`),n=await y(i.file,null);return(!n||!Array.isArray(n.items))&&c(`${i.file} is not a wave file with items[]`),{source:i,wave:n}}r(le,"loadWave");async function P(e,t){const{wave:i,id:n}=T(t),a=await le(e,i),o=a.wave.items.find(s=>s.id===n)||c(`wave "${i}" has no item "${n}"`);return{...a,item:o}}r(P,"loadItem");async function Ga(e,t,i){O(e),te(t,"the event id");const n=(await U(h.join(e,"data","events.jsonl"))).find(u=>u.id===t);n||c(`no event "${t}" in this site's data/events.jsonl`);const a=h.join(e,"data","replies",`${t}.html`);await it(a,_(i,"the reply"));const o=n.kind==="ask"?`ask:${t}`:n.kind==="item-message"&&typeof n.data?.key=="string"?n.data.key:null,s=o?await Gt(e,o,Pi(i)):[],d=n.kind==="wave-triage"?["lineup","wave"].filter(u=>typeof n.data?.[u]=="string").map(u=>`${u}:${n.data[u]}`):[],l=n.kind==="ask"?`item:ask:${t}`:d[0];return l&&s.push(...await mn(e,l,"Acted on: replied")),{file:a,lines:s}}r(Ga,"writeReply");const Jt=r(e=>h.join(e,"data","working.json"),"workingFile");async function bi(e){return(await y(Jt(e),{})).events||{}}r(bi,"readWorking");const Qa=["ask","item-message","wave-triage","todo-triage"];async function Za(e,t){if(!t.length)return;const i=new Date().toISOString(),n=await bi(e);await x(Jt(e),{events:{...n,...Object.fromEntries(t.map(a=>[a,I(n,a)||i]))}})}r(Za,"markWorking");const ot=r(e=>h.join(e,"data","push-state.json"),"pushStateFile");async function xi(e,t){O(e);const i=Date.parse((await y(ot(e),{})).last_push);if(Number.isNaN(i))return 0;const n=h.join(e,"data","replies"),a=(await D.readdir(n).catch(()=>[])).filter(s=>/\.(html|json)$/.test(s));return(await Promise.all(a.map(s=>D.stat(h.join(n,s)).then(d=>d.mtimeMs,()=>0)))).filter(s=>s>i&&s<=t.getTime()).length}r(xi,"repliesSincePush");async function vi(e,t){return await x(ot(O(e)),{last_push:t.toISOString()}),ot(e)}r(vi,"recordPush");const Si=h.join(h.dirname(Hn(import.meta.url)),"..","bin","kickflip.mjs");function _i(){if(!process.env.KICKFLIP_PUSH_CMD)return[process.execPath,Si,"push"];try{const e=JSON.parse(process.env.KICKFLIP_PUSH_CMD);if(Array.isArray(e)&&e.length&&e.every(t=>typeof t=="string"))return e}catch{}throw new Q("KICKFLIP_PUSH_CMD must be a JSON array of strings")}r(_i,"pushCommand");async function Va(e,t){const i=ei(t.kind);i&&c(i),t.title===void 0&&c("push needs --title");const n=new Date,a=Oi(t.body,await xi(e,n)),o={kind:t.kind,title:t.title,body:a||void 0,url:Ri(t.url),tag:t.tag},[s,...d]=_i(),l=[...d,...Object.entries(o).flatMap(([m,p])=>p===void 0?[]:[`--${m}`,p]),...t.urgent?["--urgent"]:[],...t.now?["--now"]:[]],u=await new Promise(m=>{Rt(s,l,{encoding:"utf8"},(p,w,$)=>m({error:p,said:`${w||""}${$||""}`.split(`
5
- `).filter(g=>g.trim())}))}),f=u.error?typeof u.error.code=="number"?u.error.code:1:0;if(f!==0)throw Object.assign(new Q([...u.said,`kickflip push failed (${typeof u.error.code=="number"?`exit ${f}`:u.error.message}); the push was not recorded`].join(`
6
- `)),{exitCode:f});return await vi(e,n),{lines:u.said}}r(Va,"sendPush");const ji=/(?:^| · )(and \d+ repl(?:y|ies))$/,Oi=r((e,t)=>[e,t&&`and ${t} ${t===1?"reply":"replies"}`].filter(Boolean).join(" \xB7 "),"withReplies"),zt=160;function Di(e){const t=String(e).split(`
7
- `).map(i=>i.replace(/\s+/g," ").trim()).find(Boolean)||"";return t.length>zt?`${t.slice(0,zt-1).trimEnd()}\u2026`:t}r(Di,"pushLine");const Ai={amp:"&",lt:"<",gt:">",quot:'"',apos:"'",nbsp:" "};function Pi(e){return e.replace(/<details[\s\S]*?<\/details>/gi,`
1
+ var bi=Object.defineProperty;var r=(e,t)=>bi(e,"name",{value:t,configurable:!0});import R from"node:fs/promises";import{constants as xi,existsSync as He}from"node:fs";import g from"node:path";import ht from"node:os";import{execFile as Xt}from"node:child_process";import{fileURLToPath as vi}from"node:url";import{BUILD_REFUSED as gt,BUILDER_ASK as Ke,ITEM_STATUSES as Yt,MAX_IMPLEMENTERS as _i,lineupPhases as $t,mergeBlockers as Si,modelName as Je,noTakePicked as ji,ownerQuestion as Ee,plans as ze,PLANNER_WORD as Oi,providerOf as kt,owesNext as yt,pushTag as Di,refOf as Qe,roundOf as bt,roundSettledBy as Pi}from"./domain.mjs";import{GITHUB_STATE as en,appendEvent as Se,listBoards as ge,samePath as je}from"../hub/boards.mjs";import{readUsageGate as tn,pauseReason as nn,builderPick as an}from"../shared/usage-gate.mjs";import{reviseQueued as Ai,flushQueue as Ri,queueStatus as Ni,pushKindError as Ei,readClaudeModel as Ii}from"../hub/push.mjs";import{holdLine as Ci,CHECK_MINUTES as Li}from"../hub/schedule.mjs";import{AT_RE as Bi}from"../hub/duration.mjs";import{routeRecord as U}from"../hub/routes.mjs";import{ticketSource as xt,ticketIn as vt,resolveTicket as qi,ticketTarget as Ti,moveTicket as Fi,titleTickets as Mi,cardIdOf as Ui}from"./tickets.mjs";import{LINEAR_NEEDS_KEY as Wi,linearStatus as Hi,linearWorks as Ki}from"../hub/linear.mjs";import{validateBranch as Ji}from"../hub/repos.mjs";import{withFileLock as Ge}from"../hub/locks.mjs";import{merge3 as zi}from"./merge3.mjs";import{fetchPR as sn,reportOf as on,githubLogin as Qi,postToPR as Gi,CLAUDE_PREFIX as rn,CLAUDE_MARK as Zi}from"../hub/pr-report.mjs";import{allLanded as cn,cardPRs as Ze,hasPR as Ve,leastReady as Vi,parsePRRef as ln,prKeyOf as Xi,prNames as Ie,prURL as Yi,storedPRs as dn}from"../shared/card-prs.mjs";import{reviewLinks as _t,topicItems as St,reviewersOf as Xe}from"./review.mjs";import{readiness as un}from"../hub/readiness.mjs";import{slackDay as fn}from"../hub/slack.mjs";import"../bin/install.mjs";import{readPermissions as ea}from"./permissions.mjs";import{parseCheck as ta,checkText as na}from"../shared/owner-check.mjs";import{RuleError as ia,rulesOf as wn,addRule as aa,editRule as sa,removeRule as oa,applyRules as ra,readHubRules as Ye,writeHubRules as ca}from"../hub/rules.mjs";class ne extends Error{static{r(this,"BoardError")}}const l=r(e=>{throw new ne(e)},"fail"),la=r(()=>g.join(ht.homedir(),".claude","kickflip","sites"),"sitesDir"),et=r(()=>g.join(ht.homedir(),".claude","waves"),"wavesDir"),pn=Symbol("read as"),y=r(async(e,t)=>{let i;try{i=await R.readFile(e,"utf8")}catch{return t}try{const n=JSON.parse(i);return n!==null&&typeof n=="object"&&!Array.isArray(n)?{...n,[pn]:i}:n}catch{return t}},"readJSON"),G=r(async e=>{try{return(await R.readFile(e,"utf8")).split(`
2
+ `).filter(Boolean).map(t=>JSON.parse(t))}catch{return[]}},"readLines");async function tt(e,t){await R.mkdir(g.dirname(e),{recursive:!0});const i=`${e}.${process.pid}.tmp`;await R.writeFile(i,t),await R.rename(i,e)}r(tt,"replace");const x=r((e,t)=>{const{[pn]:i,...n}=t??{};return i===void 0?tt(e,JSON.stringify(t,null,2)+`
3
+ `):Ge(e,async()=>{const a=JSON.parse(i),s=JSON.parse(await R.readFile(e,"utf8").catch(()=>i));await tt(e,JSON.stringify(zi(a,n,s),null,2)+`
4
+ `)})},"writeJSON");async function Z(e,t){await R.mkdir(g.dirname(e),{recursive:!0}),await R.appendFile(e,JSON.stringify(t)+`
5
+ `)}r(Z,"appendLine");async function Gs(e){/^[\w-]+$/.test(e||"")||l(`--site takes a route such as ios-orchestrator, not "${e}"`);const t=g.join(la(),e);return await R.stat(t).then(i=>i.isDirectory(),()=>!1)||l(`no site at ${t}`),t}r(Gs,"siteDir");const H=r(async e=>({title:"Board",items:"waves",...e?await y(g.join(e,"board.json"),{}):{}}),"boardConfig");async function q(e){const t=await H(e);if(t.items==="waves")try{return(await R.readdir(et(),{withFileTypes:!0})).filter(n=>n.isDirectory()).map(n=>({slug:n.name,dir:g.join(et(),n.name),file:g.join(et(),n.name,"wave.json")}))}catch{return[]}const i=g.resolve(e,t.items);return[{slug:t.slug||g.basename(t.items,".json"),dir:g.dirname(i),file:i}]}r(q,"itemSources");const K=r((e,t)=>g.join(e,"data","threads",t.replace(/[^\w.-]+/g,"__")+".jsonl"),"threadFile"),C=r(e=>g.join(e,"data","owner.json"),"ownerFile"),A=r(e=>e||l("this command needs --site <route>"),"needSite"),j=r((e,t)=>typeof e=="string"&&e.trim()?e.trim():l(`${t} must be non-empty text`),"text"),J=r((e,t)=>e===void 0?void 0:t(e),"optional"),da=/^prototype-[\w-]+\.html(?:[?#]\S*)?$/,mn=r((e,t)=>typeof e=="string"&&(da.test(e)||/^https?:\/\/\S+$/.test(e))?e:l(`${t} must be an http(s) URL or a site page such as prototype-<topic>.html?q=<id>`),"pageUrl"),jt=r((e,t)=>typeof e=="boolean"?e:l(`${t} must be true or false`),"bool"),le=r((e,t)=>typeof e=="string"&&/^[\w.-]+$/.test(e)?e:l(`${t} must use only letters, digits, "_", "." and "-"`),"domId"),Oe=r((e,t,i)=>{(!e||typeof e!="object"||Array.isArray(e))&&l(`${i} must be a JSON object`);const n=Object.keys(e).filter(a=>!t.includes(a));n.length&&l(`${i} has unknown field ${n.map(a=>`"${a}"`).join(", ")}; allowed: ${t.join(", ")}`)},"onlyKeys");function L(e){const t=/^([^/\s]+)\/([^/\s]+)$/.exec(e||"");return t?{wave:t[1],id:t[2]}:l(`expected <wave>/<id>, not "${e}"`)}r(L,"parseKey");async function De(e,t){const i=(await q(e)).find(a=>a.slug===t)||l(`this board has no wave "${t}"`),n=await y(i.file,null);return(!n||!Array.isArray(n.items))&&l(`${i.file} is not a wave file with items[]`),{source:i,wave:n}}r(De,"loadWave");async function O(e,t){const{wave:i,id:n}=L(t);let a=await De(e,i);!a.wave.items.some(o=>o.id===n)&&await ns(e,t)&&(a=await De(e,i));const s=a.wave.items.find(o=>o.id===n)||l(`wave "${i}" has no item "${n}"`);return{...a,item:s}}r(O,"loadItem");async function Zs(e,t,i){A(e),le(t,"the event id");const n=(await G(g.join(e,"data","events.jsonl"))).find(u=>u.id===t);n||l(`no event "${t}" in this site's data/events.jsonl`);const a=g.join(e,"data","replies",`${t}.html`);await tt(a,j(i,"the reply"));const s=n.kind==="ask"?`ask:${t}`:n.kind==="item-message"&&typeof n.data?.key=="string"?n.data.key:null,o=s?await $n(e,s,ya(i)):[],c=n.kind==="wave-triage"?["lineup","wave"].filter(u=>typeof n.data?.[u]=="string").map(u=>`${u}:${n.data[u]}`):[],d=n.kind==="ask"?`item:ask:${t}`:c[0];return d&&o.push(...await Tn(e,d,"Acted on: replied")),{file:a,lines:o}}r(Zs,"writeReply");const hn=r(e=>g.join(e,"data","working.json"),"workingFile");async function ua(e){return(await y(hn(e),{})).events||{}}r(ua,"readWorking");const Vs=["ask","item-message","wave-triage","overnight-triage"];async function Xs(e,t){if(!t.length)return;const i=new Date().toISOString(),n=await ua(e);await x(hn(e),{events:{...n,...Object.fromEntries(t.map(a=>[a,U(n,a)||i]))}})}r(Xs,"markWorking");const Ot=r(e=>g.join(e,"data","push-state.json"),"pushStateFile");async function fa(e,t){A(e);const i=Date.parse((await y(Ot(e),{})).last_push);if(Number.isNaN(i))return 0;const n=g.join(e,"data","replies"),a=(await R.readdir(n).catch(()=>[])).filter(o=>/\.(html|json)$/.test(o));return(await Promise.all(a.map(o=>R.stat(g.join(n,o)).then(c=>c.mtimeMs,()=>0)))).filter(o=>o>i&&o<=t.getTime()).length}r(fa,"repliesSincePush");async function wa(e,t){return await x(Ot(A(e)),{last_push:t.toISOString()}),Ot(e)}r(wa,"recordPush");const pa=g.join(g.dirname(vi(import.meta.url)),"..","bin","kickflip.mjs");function ma(){if(!process.env.KICKFLIP_PUSH_CMD)return[process.execPath,pa,"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 ne("KICKFLIP_PUSH_CMD must be a JSON array of strings")}r(ma,"pushCommand");async function Ys(e,t){const i=Ei(t.kind);i&&l(i),t.title===void 0&&l("push needs --title");const n=new Date,a=ga(t.body,await fa(e,n)),s={kind:t.kind,title:t.title,body:a||void 0,url:ba(t.url),tag:t.tag},[o,...c]=ma(),d=[...c,...Object.entries(s).flatMap(([f,p])=>p===void 0?[]:[`--${f}`,p]),...t.urgent?["--urgent"]:[],...t.now?["--now"]:[]],u=await new Promise(f=>{Xt(o,d,{encoding:"utf8"},(p,h,m)=>f({error:p,said:`${h||""}${m||""}`.split(`
6
+ `).filter($=>$.trim())}))}),w=u.error?typeof u.error.code=="number"?u.error.code:1:0;if(w!==0)throw Object.assign(new ne([...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 wa(e,n),{lines:u.said}}r(Ys,"sendPush");const ha=/(?:^| · )(and \d+ repl(?:y|ies))$/,ga=r((e,t)=>[e,t&&`and ${t} ${t===1?"reply":"replies"}`].filter(Boolean).join(" \xB7 "),"withReplies"),gn=160;function $a(e){const t=String(e).split(`
8
+ `).map(i=>i.replace(/\s+/g," ").trim()).find(Boolean)||"";return t.length>gn?`${t.slice(0,gn-1).trimEnd()}\u2026`:t}r($a,"pushLine");const ka={amp:"&",lt:"<",gt:">",quot:'"',apos:"'",nbsp:" "};function ya(e){return e.replace(/<details[\s\S]*?<\/details>/gi,`
8
9
  `).replace(/<(?:br|\/?(?:p|div|li|ul|ol|h\d|blockquote|pre|tr|summary))\b[^>]*>/gi,`
9
- `).replace(/<[^>]*>/g,"").replace(/&(?:#(x[\da-f]{1,6}|\d{1,7})|(\w+));/gi,(t,i,n)=>{const a=i&&parseInt(i.replace(/^x/i,""),/^x/i.test(i)?16:10);return i?a<=1114111?String.fromCodePoint(a):t:I(Ai,n.toLowerCase())??t})}r(Pi,"htmlText");function Ri(e){if(!e||!e.startsWith("/"))return e;const t=new URL(e,"http://board");return/^#item=[^&]+$/.test(t.hash)&&(t.hash=`${t.hash}&reply`),/\/[\w-]+\.html$/.test(t.pathname)&&!t.pathname.endsWith("/index.html")&&t.searchParams.set("from","push"),t.pathname+t.search+t.hash}r(Ri,"pushUrl");const Ni=r((e,t)=>`/${h.basename(e)}/#item=${encodeURIComponent(t)}&reply`,"threadUrl");async function Gt(e,t,i){const n=Di(i);if(!n)return[];const a=Gn(t),o=await Zn(a,s=>[n,ji.exec(s)?.[1]].filter(Boolean).join(" \xB7 "),Ni(e,t));return o===null?[]:[`queued push ${a} now reads: ${o}`]}r(Gt,"freshenPush");const Qt=r(e=>h.join(e,"data","hidden.json"),"hiddenFile"),Ei=r(async e=>new Set((await y(Qt(e),{events:[]})).events||[]),"readHidden");let Zt=Promise.resolve();function Ya(e,t,i){te(t,"the event id");const n=Zt.then(async()=>{const a=await Ei(e);i?a.add(t):a.delete(t),await x(Qt(e),{events:[...a]})});return Zt=n.catch(()=>{}),n}r(Ya,"setHidden");const st=20*1024*1024,se=r(e=>h.join(e,"data","uploads"),"uploadsDir"),ue=r((e,t)=>h.join(se(e),".meta",`${t}.json`),"uploadMeta"),Vt=/^\d+-[\w.-]+$/,Yt=/^[\w.+-]+\/[\w.+-]+$/,Xt=r(()=>Object.assign(new Q(`a file can be at most ${st/1024/1024} MB`),{status:413}),"tooLarge");async function Xa(e,t,{name:i,type:n,length:a}){if(O(e),a>st)throw Xt();const o=String(i||"").trim().slice(0,200)||"file",s=h.basename(o).replace(/[^\w.-]+/g,"-").replace(/^[.-]+/,"").slice(-80)||"file",d=String(n||"").split(";")[0].trim().toLowerCase(),l=Yt.test(d)?d:"application/octet-stream";await D.mkdir(h.dirname(ue(e,"x")),{recursive:!0});let u,f;for(let w=Date.now();!f;w++)u=`${w}-${s}`,f=await D.open(h.join(se(e),u),"wx").catch($=>$.code==="EEXIST"?null:Promise.reject($));const m=h.join(se(e),u);let p=0;try{for await(const w of t){if(p+=w.length,p>st)throw Xt();await f.write(w)}}catch(w){throw await f.close(),await D.rm(m,{force:!0}),w}return await f.close(),await x(ue(e,u),{name:o,type:l,size:p,at:new Date().toISOString()}),{name:o,url:`uploads/${u}`,path:m,type:l,size:p}}r(Xa,"saveUpload");async function eo(e,t){if(!Vt.test(t||""))return null;const i=h.join(se(e),t),n=await D.stat(i).catch(()=>null);if(!n?.isFile())return null;const a=await y(ue(e,t),{});return{path:i,name:a.name||t,type:Yt.test(a.type||"")?a.type:"application/octet-stream",size:n.size}}r(eo,"readUpload");const en=["github","slack"];async function Ee(e,t,{text:i,link:n,who:a="claude",via:o}){if(O(e),String(t).startsWith("ask:"))await _e(e,t.slice(4),"the ask");else{const{wave:l,id:u}=T(t),{wave:f}=await le(e,l);f.items.some(m=>m.id===u)||c(`wave "${l}" has no item "${u}"`)}/^[^\n]{1,40}$/.test(a.trim())||c("--who takes claude, love or a reviewer's name"),o!==void 0&&!en.includes(o)&&c(`--via takes ${en.join(" or ")}`);const s={ts:new Date().toISOString(),who:a.trim(),text:_(i,"--text"),link:z(n,l=>Kt(l,"--link")),via:o},d=H(e,t);return await V(d,s),{file:d,lines:s.who==="claude"&&!o?await Gt(e,t,s.text):[]}}r(Ee,"appendThread");const fe=r(e=>h.join(e,"data","ask-links.json"),"askLinksFile");async function be(e){return(await y(fe(e),{})).links||{}}r(be,"readAskLinks");async function ne(e,t){const{tickets:i}=pe(await W(e)),n=await C(e),a=/^ask:(.+)$/.exec(t)?.[1];if(a===void 0){const s=/^([^/\s]+)\/([^/\s]+)$/.exec(t);if(!s)return t;const d=n.find(f=>f.slug===s[1]),l=d&&await y(d.file,null);if(!l)return s[2];const u=(l.items||[]).find(f=>f.id===s[2]);return ke(l,u||{id:s[2]},i)}const o=e?I(await be(e),a):void 0;if(o)return ne(e,o);for(const s of n){const d=await y(s.file,null),l=(Array.isArray(d?.items)?d.items:[]).find(u=>u.from_ask===a);if(l)return ke(d,l,i)}return`task ${a}`}r(ne,"cardName");async function to(e,t){const i=(await U(h.join(e,"data","events.jsonl"))).find(n=>n.id===t);return i?.kind==="ask"?ne(e,`ask:${t}`):typeof i?.data?.key=="string"?ne(e,i.data.key):`the ${i?.kind} event`}r(to,"eventCard");async function no(e,t,i,n){O(e),te(t,"the event id"),(await U(h.join(e,"data","events.jsonl"))).some(d=>d.id===t&&d.kind==="ask")||c(`no ask "${t}" in this site's data/events.jsonl`),await rt(e,t),await P(e,i);const o={ts:new Date().toISOString(),who:"claude",text:_(n,"--summary")},s=await be(e);return await x(fe(e),{links:{...s,[t]:i}}),await V(H(e,i),o),fe(e)}r(no,"relateAsk");async function io(e,t){await _e(e,t,"the ask");const i=await be(e);return I(i,t)===void 0&&c(`ask "${t}" is not folded into a card`),delete i[t],await x(fe(e),{links:i}),fe(e)}r(io,"unfoldAsk");const Te=r(e=>h.join(e,"data","ask-progress.json"),"askProgressFile");async function Le(e){return(await y(Te(e),{})).asks||{}}r(Le,"readAskProgress");async function rt(e,t){const i=I(await Le(e),t)?.moved;i&&c(`ask "${t}" was moved to /${i.route}; it lives there now`)}r(rt,"refuseMoved");async function ao(e,t,i,n){await _e(e,t,"the ask"),await rt(e,t);const a=await Le(e);return await x(Te(e),{asks:{...a,[t]:{state:i,at:new Date().toISOString(),...n===void 0?{}:{next:_(n,"--next")}}}}),Te(e)}r(ao,"markAsk");const Ti=[void 0,"planned","waiting"];async function Li(e,t,i){const n=`ask "${t}"`;if(i.some(f=>f.kind==="ask-withdrawn"&&f.data?.id===t&&!f.data?.key))return{why:`${n} was deleted by the owner`};const a=I(await Le(e),t);if(a?.moved)return{why:`${n} was already moved to /${a.moved.route}`};const o=I(await be(e),t);if(o)return{why:`${n} is folded into ${o}; run ask unfold ${t} first`};const s=[];for(const f of await C(e)){const m=await y(f.file,null);for(const p of Array.isArray(m?.items)?m.items:[])p.from_ask===t&&s.push({key:`${f.slug}/${p.id}`,it:p})}const d=s.find(({it:f})=>f.pr||!Ti.includes(f.status));return d?{why:`${n} became ${d.key}, which has started`}:s.length?{items:s.map(f=>f.key)}:(await Promise.all(["html","json"].map(f=>D.stat(h.join(e,"data","replies",`${t}.${f}`)).then(()=>!0,()=>!1)))).some(Boolean)||!!a||i.some(f=>f.kind==="ask-done"&&f.data?.id===t)||(await U(H(e,`ask:${t}`))).some(f=>(f.who||"claude")==="claude"&&f.kind!=="status")?{why:`${n} is not New: Claude already answered it`}:null}r(Li,"askNotNew");async function Bi(e,t,i){const n=/^uploads\/([\w.-]+)$/.exec(i?.url||"")?.[1],a=Vt.test(n||"")?h.join(se(e),n):null;if(!a||!await D.stat(a).then(l=>l.isFile(),()=>!1))return{name:String(i?.name||n||"file")};await D.mkdir(h.dirname(ue(t,"x")),{recursive:!0});const o=n.replace(/^\d+-/,"");let s;for(let l=Date.now();s=`${l}-${o}`,!await D.copyFile(a,h.join(se(t),s),Wn.COPYFILE_EXCL).then(()=>!0,f=>f.code==="EEXIST"?!1:Promise.reject(f));l++);const d=await y(ue(e,n),null);return d&&await x(ue(t,s),d),{...i,url:`uploads/${s}`,path:h.join(se(t),s)}}r(Bi,"copyUpload");async function oo(e,t,i){O(e),te(t,"the event id"),(typeof i!="string"||!i.trim())&&c("ask move needs --to <route>, the board to move it to");const n=await U(h.join(e,"data","events.jsonl")),a=n.find(v=>v.id===t&&v.kind==="ask")||c(`no ask "${t}" in this site's data/events.jsonl`),o=Ae(),s=o.find(v=>v.route===i)||c(`--to ${i}: no board at /${i} in the hub's manifest; the boards are ${o.map(v=>v.route).join(", ")||"none"}`);Pe(s.dir,e)&&c(`--to ${i}: that is this board`);const d=await Li(e,t,n);d?.why&&c(d.why);const l=n.filter(v=>v.kind==="ask-edited"&&v.data?.id===t&&typeof v.data?.text=="string").sort((v,S)=>String(v.ts).localeCompare(String(S.ts))).pop(),u=[];for(const v of a.data?.files||[])u.push(await Bi(e,s.dir,v));const f={route:h.basename(e),title:(await W(e)).title,id:t},m=l?l.data.text:a.data?.text||"",p=await Ve(s,"ask",{text:m,...u.length?{files:u}:{},from:f}),w={route:i,title:s.title,id:p},$=new Date().toISOString(),g=await Le(e);await x(Te(e),{asks:{...g,[t]:{state:"done",at:$,moved:w}}});const k=`/${i}/#item=${encodeURIComponent(`ask:${p}`)}`;await V(H(e,`ask:${t}`),{ts:$,who:"claude",text:`Moved to ${s.title}.`,link:k});for(const v of d?.items||[])await Oe(e,v,{status:"dropped",force:!0,text:`Dropped: its ask moved to ${s.title}.`});return{file:h.join(s.dir,"data","events.jsonl"),lines:[`moved to ${k}`,...(d?.items||[]).map(v=>`dropped: ${v}`)]}}r(oo,"moveAsk");const tn=r(e=>h.join(e,"data","checked.json"),"checkedFile");async function so(e,t,{idle:i}={}){O(e),i&&t!==void 0&&c("pass --every or --idle, not both"),i===void 0&&t===void 0&&(i=!await Ci(e));const n=new Date,a=i?null:t===void 0?ii(n,Xn()).every_minutes:/^[1-9]\d{0,3}$/.test(String(t))?Number(t):c("--every takes the minutes between checks, such as 30");return await x(tn(e),i?{at:n.toISOString(),every:null,idle:!0}:{at:n.toISOString(),every:a}),{file:tn(e),every:a,lines:await Ii()}}r(so,"writeChecked");async function Ci(e){for(const t of await C(e)){const i=await y(t.file,null);if((i?.items||[]).some(n=>Number.isInteger(n.pr)&&!L.includes(n.status))&&re(e,i))return!0}return!1}r(Ci,"hasOpenPR");async function Ii(){const e=Yn(new Date);if(e.hold)return e.count?[`queued pushes held: ${ni(e.hold)}`]:[];const t=await Vn();return t?[`sent ${t.sent} of ${t.count} queued push${t.count===1?"":"es"}${t.ok?"":"; the rest stay queued"}`]:[]}r(Ii,"flushAfterTick");const Be=r(e=>h.join(e,"data","handshake.json"),"handshakeFile"),nn=r(e=>y(Be(e),null),"readHandshake");async function ro(e,t){O(e),te(t,"the event id");const i=(await U(h.join(e,"data","events.jsonl"))).find(a=>a.id===t);i?.kind!=="hello"&&c(`no hello event "${t}" in this site's data/events.jsonl`);const n=await nn(e)||{};return n.hello?.id&&n.hello.id!==t&&c(`"${t}" is an older hello; ack the newest, "${n.hello.id}"`),await x(Be(e),{...n,hello:n.hello||{id:t,at:i.ts,session:null},ack:{id:t,at:new Date().toISOString()}}),Be(e)}r(ro,"ackHello");async function co(e){const t=await nn(e);t&&!t.done_at&&await x(Be(e),{...t,done_at:new Date().toISOString()})}r(co,"finishHandshake");const ct={name:/^[^\n]{1,40}$/,slack_user:/^U[A-Z0-9]+$/,dm:/^D[A-Z0-9]+$/,github:/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})$/},xe=r((e,t)=>e.trim().toLowerCase()===t.trim().toLowerCase(),"sameName");function dt(e,t){return Array.isArray(e)||c(`${t} must be a JSON array of reviewers`),e.forEach((i,n)=>{const a=`${t}[${n}]`;ye(i,Object.keys(ct),a);for(const[o,s]of Object.entries(ct))(typeof i[o]!="string"||!s.test(i[o].trim()))&&c(`${a}.${o} must match ${s}`);e.slice(0,n).some(o=>xe(o.name,i.name))&&c(`${t} names "${i.name}" twice`)}),e.map(i=>Object.fromEntries(Object.keys(ct).map(n=>[n,i[n].trim()])))}r(dt,"checkReviewers");async function lt(e,t){const i=h.join(O(e),"board.json"),n=await y(i,{}),a=dt(t(n.reviewers||[]),"the reviewers");await x(i,{...n,reviewers:a});const o=[];for(const s of await C(e)){const d=await y(s.file,null);(d?.items||[]).some(l=>!L.includes(l.status))&&(await x(s.file,{...d,reviewers:a}),o.push(`wave ${s.slug}: reviewers copied`))}return{file:i,lines:o}}r(lt,"writeReviewers");const lo=r((e,t)=>lt(e,()=>dt(t,"the reviewer file")),"setReviewers"),an=r((e,t)=>((typeof e!="string"||!/^\d+(?:\.\d+)?$/.test(e)||Number(e)<=0)&&c("--ts must be a Slack message timestamp"),(typeof t!="string"||!/^D[A-Z0-9]+$/.test(t))&&c("--channel must be a DM channel id"),{ts:e,channel:t}),"linkMessage"),ut=r((e,t,i)=>nt(e,t).find(n=>n.name===i)||c(`no reviewer "${i}" on this wave or board`),"reviewerOn"),uo=r((e,t,i,{ts:n,channel:a})=>me(e,async()=>{const o=an(n,a),{source:s,wave:d,item:l}=await P(e,t);return ut(d,(await W(e)).reviewers,i),l.review_link_ts={...l.review_link_ts,[i]:o},await x(s.file,d),s.file}),"reviewSent"),fo=r((e,t,i,n)=>me(e,async()=>{(typeof n!="string"||!/^[\w+-]+$/.test(n))&&c("emoji must be a Slack emoji name without colons");const{source:a,wave:o,item:s}=await P(e,t),d=ut(o,(await W(e)).reviewers,i),l=et(o,s,t,tt())[i];l?.ts||c(`no review link recorded for ${i} on ${t}`);const u=I(s.review_link_ts,i),f=typeof u=="object"&&Array.isArray(u?.reactions)?u.reactions:[];return f.includes(n)||(s.review_link_ts={...s.review_link_ts,[i]:{...l,channel:l.channel||d.dm,reactions:[...f,n]}},await x(a.file,o)),a.file}),"reviewReact"),on=r(e=>h.join(O(e),"data","review-digests.json"),"digestFile");async function po(e,t){O(e);const i=await Ut.waiting("slack");if(i)return{waiting:i,dms:[],reactions:[],digest:null};const n=await W(e),a=await y(Lt,{}),o=tt(),s=`board.mjs --site ${h.basename(e)}`,d=r(m=>/^[\w.@-]+$/.test(m)?m:JSON.stringify(m),"arg"),l=[],u=[];for(const m of await C(e)){const p=await y(m.file,{}),w=nt(p,n.reviewers),$=re(e,p);for(const g of p.items||[]){if(!Number.isInteger(g.pr)||!$||["done","dropped"].includes(g.status))continue;const k=`${m.slug}/${g.id}`,v=I(a.prs,`${$}#${g.pr}`),S=et(p,g,k,o);if(g.status==="merged"||g.merged_at||v?.state==="MERGED")for(const j of w){const R=I(S,j.name),B=I(g.review_link_ts,j.name);!R?.ts||Array.isArray(B?.reactions)&&B.reactions.includes("git_merged")||u.push({key:k,reviewer:j.name,channel:R.channel||j.dm,ts:R.ts,emoji:"git_merged",record:`${s} review react ${k} ${d(j.name)} git_merged`})}else if(v?.state==="OPEN"&&!v.isDraft){const j=`https://github.com/${$}/pull/${g.pr}`;for(const R of w.filter(B=>!I(S,B.name)))l.push({key:k,reviewer:R.name,channel:R.dm,text:j,record:`${s} review sent ${k} ${d(R.name)} --ts <ts> --channel ${R.dm}`})}}}const f=await qi(e,t);return{dms:l,reactions:u,digest:f.due?{...f,record:`${s} review digest sent <reviewer> --ts <ts> --channel <dm> --items <key,key>`}:null}}r(po,"reviewDue");async function qi(e,{now:t=new Date}={}){O(e);const i=await W(e),n=await y(Lt,{}),a=tt(),o=new Map;for(const f of await C(e)){const m=await y(f.file,{}),p=nt(m,i.reviewers);for(const $ of p)o.has($.name)||o.set($.name,{name:$.name,slack_user:$.slack_user,dm:$.dm,items:[]});const w=re(e,m);for(const $ of m.items||[]){if(!Number.isInteger($.pr)||!w||["merged","done","dropped"].includes($.status))continue;const g=`${f.slug}/${$.id}`,k=I(n.prs,`${w}#${$.pr}`);if(k?.state!=="OPEN"||k.isDraft||k.failing?.length||k.reviewDecision==="APPROVED")continue;const v=et(m,$,g,a);for(const S of p){const j=I(v,S.name),R=j?.ts?(t.getTime()-Number(j.ts)*1e3)/864e5:null;o.get(S.name).items.push({key:g,title:$.title,pr:$.pr,url:`https://github.com/${w}/pull/${$.pr}`,sent_ts:j?.ts||null,...R>2?{days_old:Math.floor(R)}:{}})}}}const{date:s,morning:d}=Wt(t),l=await y(on(e),{}),u=await Ut.waiting("slack");return{date:s,due:!u&&d&&l.last_date!==s,...u?{waiting:u}:{},reviewers:[...o.values()].filter(f=>f.items.length)}}r(qi,"reviewDigest");async function wo(e,t,{ts:i,channel:n,items:a},{now:o=new Date}={}){const s=an(i,n),d=[...new Set(_(a,"--items").split(",").map(f=>f.trim()))],l=await W(e);for(const f of d){const{wave:m}=await P(e,f);ut(m,l.reviewers,t)}const u=on(e);return qt(u,async()=>{const f=await y(u,{});return await x(u,{last_date:Wt(o).date,digests:[...f.digests||[],{reviewer:t,dm:s.channel,ts:s.ts,items:d,reactions:[]}]}),u})}r(wo,"reviewDigestSent");function mo(e,t){const i=dt(Array.isArray(t)?t:[t],"the reviewer file");return lt(e,n=>[...n.map(a=>i.find(o=>xe(o.name,a.name))||a),...i.filter(a=>!n.some(o=>xe(a.name,o.name)))])}r(mo,"addReviewers");function ho(e,t){return lt(e,i=>{const n=t.filter(a=>!i.some(o=>xe(o.name,a)));return n.length&&c(`this board has no reviewer ${n.map(a=>`"${a}"`).join(", ")}`),i.filter(a=>!t.some(o=>xe(a.name,o)))})}r(ho,"removeReviewers");const Fi=r(()=>h.join(Je.homedir(),".claude","kickflip","settings.json"),"hubSettingsFile"),ft=r(e=>{try{return e()}catch(t){throw t instanceof pi&&c(t.message),t}},"ruleCall"),pt=r(async e=>Ht(await y(h.join(e,"board.json"),{})),"readBoardRules");let sn=Promise.resolve();function rn(e,t){const i=sn.then(async()=>{const n=h.join(O(e),"board.json"),a=await y(n,{}),{set:o,...s}=t(a);return await x(n,{...a,...o}),{file:n,...s}});return sn=i.catch(()=>{}),i}r(rn,"writeBoardJSON");const cn=r((e,t)=>rn(e,i=>{const n=ft(()=>t(Ht(i)));return{set:{rules:n.rules},...n}}),"writeBoardRules"),dn=r(e=>typeof e=="string"&&/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})$/.test(e),"validGithubLogin"),ln=r(e=>{try{return e?Ye(e):null}catch{return null}},"storedTickets"),pe=r(e=>{const t=ln(e?.tickets);return{auto_merge:e?.auto_merge===!0,auto_build:e?.auto_build===!0,auto_pull:e?.auto_pull===!0,auto_triage:e?.auto_triage===!0,...t?{tickets:t}:{},...dn(e?.github_login)?{github_login:e.github_login}:{}}},"settingsOf");async function $o(e){return pe(await y(h.join(O(e),"board.json"),{}))}r($o,"readBoardSettings");function wt(e,t){ye(t,["auto_merge","auto_build","auto_pull","auto_triage","tickets","github_login"],"the settings"),Object.keys(t).length||c("the settings name nothing to change"),t={...t};for(const[i,n]of Object.entries(t))if(i==="tickets"){try{t.tickets=Ye(n)}catch(o){c(o.message)}const a=t.tickets.source==="github"&&e?Ae().find(o=>Pe(o.dir,e)):null;a&&!a.github&&c("GitHub issues need the board\u2019s repo on GitHub, and this board\u2019s repo isn\u2019t; pick internal or linear")}else i==="github_login"?n===""||n===null?t.github_login=void 0:dn(n)||c("github_login must be a GitHub login"):at(n,i);return rn(e,i=>{const n=pe(i),a=pe({...i,...t});return{set:t,settings:a,changed:Object.keys(t).filter(o=>JSON.stringify(n[o])!==JSON.stringify(a[o]))}})}r(wt,"saveBoardSettings");async function go(e,t,i){const n=String(t).replace(/-/g,"_"),a=["auto_merge","auto_build","auto_pull","auto_triage","github_login","tickets"];if(a.includes(n)||c(`no board setting "${t}"; settings are ${a.map(d=>d.replace(/_/g,"-")).join(", ")}`),n==="tickets"){let d;try{d=JSON.parse(i)}catch{c('settings set tickets takes the source as JSON, such as {"source":"github"}')}const{file:l,settings:u}=await wt(e,{tickets:d});return{file:l,lines:Mi({tickets:u.tickets})}}if(n==="github_login"){const{file:d,settings:l}=await wt(e,{github_login:i});return{file:d,lines:[`github-login ${l.github_login||"unset"}`]}}["on","off"].includes(i)||c(`settings set ${t} takes on or off, not "${i}"`);const{file:o,settings:s}=await wt(e,{[n]:i==="on"});return{file:o,lines:[`${t} ${s[n]?"on":"off"}`]}}r(go,"setBoardSetting");const Mi=r(e=>Object.entries(e).map(([t,i])=>`setting ${t.replace(/_/g,"-")} ${t==="tickets"?JSON.stringify(i):t==="github_login"?i:i?"on":"off"}`),"settingsLines");async function mt(e,t,i){const n=t?ft(()=>i(Re())):await cn(e,i);return t&&ft(()=>gi(n.rules)),{file:t?Fi():n.file,lines:[`id ${n.rule.id}`]}}r(mt,"changeRules");async function un(e,t,i){const n=r(s=>s.map(d=>d.id),"ids");i||O(e);const[a,o]=i?[n(Re()),e?n(await pt(e)):[]]:[n(await pt(e)),n(Re())];a.includes(t)||c(`no ${i?"hub":"board"} rule "${t}"${o.includes(t)?`; it is a ${i?"board":"hub"} rule, so ${i?"drop":"pass"} --hub`:""}`)}r(un,"checkRuleId");async function ko(e){const t=r(i=>n=>`${i} ${n.id} ${n.by==="claude"?"claude":"owner"} ${n.text}`,"line");return{lines:[...Re().map(t("hub")),...e?(await pt(e)).map(t("board")):[]]}}r(ko,"listRules");function yo(e,{text:t,hub:i=!1,by:n}){return i||O(e),mt(e,i,a=>wi(a,{text:t,by:n}))}r(yo,"addRuleTo");async function bo(e,t,{text:i,hub:n=!1}){return await un(e,t,n),mt(e,n,a=>mi(a,t,i))}r(bo,"editRuleIn");async function xo(e,t,{hub:i=!1}){return await un(e,t,i),mt(e,i,n=>hi(n,t))}r(xo,"removeRuleFrom");const vo=r((e,t,i)=>cn(e,n=>$i(n,t,i)),"saveBoardRules");async function So(e,{id:t,title:i,summary:n}){O(e);const a=await y(q(e),{topics:[],items:[]}),o=a.topics||[];return o.some(s=>s.id===_(t,"the topic id"))&&c(`topic "${t}" already exists`),o.push({id:t.trim(),title:_(i,"--title"),...n===void 0?{}:{summary:_(n,"--summary")}}),await x(q(e),{...a,topics:o,items:a.items||[]}),q(e)}r(So,"addTopic");const fn=["quiet","info","notice","danger","success"];function Ui(e,t){if(e.diagram===void 0!=(e.practice===void 0)&&c(`${t} needs diagram and practice together`),e.diagram===void 0)return;const i=e.diagram;(!Array.isArray(i)||!i.length)&&c(`${t}.diagram must be a non-empty array of rows`),i.forEach((n,a)=>{(!Array.isArray(n)||!n.length||n.length>4)&&c(`${t}.diagram[${a}] must be a row of 1 to 4 boxes`),n.forEach((o,s)=>{const d=`${t}.diagram[${a}][${s}]`;ye(o,["text","tone","to"],d),_(o.text,`${d}.text`),z(o.tone,l=>fn.includes(l)?l:c(`${d}.tone takes ${fn.join(", ")}`)),z(o.to,l=>Array.isArray(l)&&a+1<i.length&&l.every(u=>Number.isInteger(u)&&u>=0&&u<i[a+1].length)?l:c(`${d}.to must list boxes of the next row by index`))})}),(!Array.isArray(e.practice)||!e.practice.length)&&c(`${t}.practice must be a non-empty array of lines`),e.practice.forEach((n,a)=>_(n,`${t}.practice[${a}]`))}r(Ui,"checkDiagram");function Wi(e,t){(!Array.isArray(e)||!e.length)&&c(`${t}.options must be a non-empty array`);const i=new Set;e.forEach((n,a)=>{const o=`${t}.options[${a}]`;ye(n,["id","label","recommended","detail","diagram","practice"],o),Ui(n,o),i.has(_(n.id,`${o}.id`))&&c(`${t} has two options with id "${n.id}"`),i.add(n.id),_(n.label,`${o}.label`).startsWith(`${n.id}. `)&&c(`${o}.label starts with "${n.id}. ", but the page adds the option letter itself`),z(n.recommended,s=>at(s,`${o}.recommended`)),z(n.detail,s=>typeof s=="string"?s:c(`${o}.detail must be text`))}),e.filter(n=>n.recommended).length>1&&c(`${t} recommends more than one option`)}r(Wi,"checkOptions");const ve=r(e=>h.join(e,"data","prototypes.json"),"prototypesFile"),ht=r((e,t,i)=>h.join(e,"public","prototypes",t,`${i}.js`),"takeFile");async function Ce(e){const t=e?(await y(ve(e),{})).prototypes:null;return Array.isArray(t)?t:[]}r(Ce,"readPrototypes");const Hi=r(e=>typeof e=="string"&&/^[a-z0-9-]+$/.test(e)?e:c(`a prototype topic uses only a-z, 0-9 and "-", not "${e}"`),"prototypeTopic");function Ki(e){const t=/^([^:]*):(.*)$/s.exec(e);(!t||!/^[A-Z]$/.test(t[1]))&&c(`--take takes KEY:"Label" with KEY one capital letter, not "${e}"`);const i=_(t[2],`--take ${t[1]}'s label`);return/^[A-Z]\.\s/.test(i)&&c(`--take ${t[1]}'s label starts with "${i.slice(0,3)}"; the take pill shows the label alone, so drop the letter`),{key:t[1],label:i}}r(Ki,"prototypeTake");const we=r(e=>/^prototype-(.+)\.html$/.exec(h.posix.basename(String(e||"").split(/[?#]/)[0]))?.[1],"pageTopic");async function _o(e,{topic:t,title:i,card:n,takes:a=[]}){O(e),Hi(t),_(i,"--title"),a.length||c('prototype add needs a --take KEY:"Label" for each take');const o=a.map(Ki),s=o.find((u,f)=>o.findIndex(m=>m.key===u.key)!==f);s&&c(`--take ${s.key} is given twice`),n!==void 0&&await P(e,n);const d=await Ce(e);d.some(u=>u.topic===t)&&c(`prototype ${t} is already recorded; run prototype rm ${t} first, or pick another topic`),await D.stat(h.join(e,"public",`prototype-${t}.html`)).then(()=>!0,()=>!1)&&c(`public/prototype-${t}.html is a hand-written page that questions may link; pick another topic`);const l={topic:t,title:i.trim(),...n===void 0?{}:{card:n},takes:o,at:new Date().toISOString()};return await x(ve(e),{prototypes:[...d,l]}),{file:ve(e),lines:[`page prototype-${t}.html`,...o.map(u=>`take ${u.key} ${ht(e,t,u.key)}`)]}}r(_o,"addPrototype");async function jo(e){O(e);const t=await Ce(e);return{lines:t.length?t.map(i=>`${i.topic} \xB7 ${i.title} \xB7 ${i.takes.map(n=>`${n.key}: ${n.label}`).join(", ")}${i.card?` \xB7 ${i.card}`:""}`):["no prototypes recorded"]}}r(jo,"listPrototypes");async function Oo(e,t){O(e);const i=await Ce(e);i.some(o=>o.topic===t)||c(`no prototype "${t}" is recorded`);const a=((await y(q(e),{items:[]})).items||[]).filter(o=>!o.resolved&&we(o.url)===t).map(o=>o.id);return a.length&&c(`prototype ${t} backs open question ${a.join(", ")}; resolve ${a.length===1?"it":"them"} first`),await x(ve(e),{prototypes:i.filter(o=>o.topic!==t)}),ve(e)}r(Oo,"removePrototype");async function Ji(e,t,i){const n=t.url?.split(/[?#]/)[0];if(!n||!h.posix.basename(n).startsWith("prototype-"))return;const a=h.posix.basename(n),o=t.url.split("#")[0].split("?").slice(1).join("?"),s=`${i}.url`;new URLSearchParams(o).get("q")!==t.id&&c(`${s} must be ${a}?q=${t.id} so the pill can pick`);const d=we(n),l=(await Ce(e)).find(p=>p.topic===d);l||c(`${s} names ${a}, which is not a recorded prototype; record it with board.mjs prototype add ${d} --title "\u2026" --take A:"\u2026", then write its take files`);const u=l.takes.map(p=>p.key),f=t.options.map(p=>p.id),m=f.map(p=>u.indexOf(p));m.some((p,w)=>p<0||w>0&&p<m[w-1])&&c(`${i}.options ids ${f.join(", ")} must be a non-empty subset of ${a}'s takes, in take order: ${u.join(", ")}`);for(const p of u)await D.stat(ht(e,d,p)).then(w=>w.isFile(),()=>!1)||c(`${s} take ${p} has no file yet; write ${ht(e,d,p)}`)}r(Ji,"checkPrototype");async function zi(e,t){const{item:i}=await P(e,t);(i.status==="merged"||i.merged_at)&&c(`${t} is merged and stays closed; ask on an open card or a declared topic`)}r(zi,"refuseMergedCard");async function Do(e,t){O(e);const i=Array.isArray(t)?t:[t];i.length||c("the question file is empty");const n=await y(q(e),{topics:[],items:[]}),a=n.items||[],o=new Set(a.map(p=>p.id)),s=new Set((n.topics||[]).map(p=>p.id));for(const[p,w]of i.entries()){const $=`question ${w?.id??p+1}`;ye(w,["id","topic","source","question","context","url","urgent","options","round_of"],$),o.has(te(w.id,`${$}.id`))&&c(`question id "${w.id}" is already used`),o.add(w.id),_(w.topic,`${$}.topic`),w.topic.startsWith("item:ask:")?await _e(e,w.topic.slice(9),`${$}.topic`):w.topic.startsWith("item:")?await zi(e,w.topic.slice(5)):w.topic.startsWith("lineup:")?await Ue(e,w.topic.slice(7)):w.topic.startsWith("wave:")?await da(e,w.topic.slice(5)):s.has(w.topic)||c(`topic "${w.topic}" is not declared; add it with: topic add ${w.topic} --title <t>`),_(w.question,`${$}.question`);for(const g of["source","context"])z(w[g],k=>_(k,`${$}.${g}`));z(w.url,g=>Kt(g,`${$}.url`)),z(w.urgent,g=>at(g,`${$}.urgent`)),Wi(w.options,$),await Ji(e,w,$),z(w.round_of,g=>{const k=a.find(v=>v.id===g);k||c(`${$}.round_of names no question "${g}" in owner.json`),k.topic!==w.topic&&c(`${$}.round_of names ${g} on topic ${k.topic}; a round stays on its question's topic, ${w.topic}`),we(w.url)||c(`${$}.round_of needs a url on a recorded prototype, prototype-<topic>.html?q=${w.id}`)})}const d=await Ie(e),l=new Date().toISOString(),u=[],f=[];for(const p of i.filter(w=>w.round_of))p.round=Ze(a.find(w=>w.id===p.round_of))+1,Se(n,[p.round_of],`Followed by prototype round ${p.round}`,l),f.push(p.round_of);for(const p of i){const w=we(p.url),$=a.filter(k=>k.topic===p.topic).map(k=>ge(k,d)),g=p.topic.startsWith("item:")?pn($):[];for(const k of $)g.includes(k.id)?(Se(n,[k.id],`Followed by ${p.id}`,l),f.push(k.id)):!k.resolved&&w&&we(k.url)===w&&(Se(n,[k.id],`Replaced by ${p.id}`,l),u.push(k.id))}const m={...n,topics:n.topics||[],items:[...a,...i.map(p=>({...p,asked_at:l}))]};return await x(q(e),m),{file:q(e),lines:[...u.map(p=>`replaced: ${p}`),...f.map(p=>`resolved: ${p}`)]}}r(Do,"addQuestions");function pn(e){return e.filter(t=>t.state==="answered").map(t=>t.id)}r(pn,"answeredOnClaude");function Se(e,t,i,n=new Date().toISOString()){for(const a of e.items||[])t.includes(a.id)&&Object.assign(a,{resolved:i,resolved_at:n})}r(Se,"setResolved");async function $t(e,t,i,n){return Se(t,i,n),await x(q(e),t),q(e)}r($t,"markResolved");async function Ao(e,t,i){O(e);const n=await y(q(e),{topics:[],items:[]}),a=(n.items||[]).find(u=>u.id===t);a||c(`no question "${t}" in owner.json`);const o=await Ie(e);if(ge(a,o).state==="resolved")return q(e);const d=_(i,"--note");we(a.url)&&Gi(n,a,o);const l=await $t(e,n,[t],d);return await kt(e,a.topic),l}r(Ao,"resolveQuestion");async function Po(e,t){const i=t.filter(({choice:a,note:o})=>!a&&String(o||"").trim()).map(a=>a.id),n=i.length?await y(q(e),{topics:[],items:[]}):null;n?.items?.some(a=>i.includes(a.id))&&(Se(n,i,"Answered with a note"),await x(q(e),n))}r(Po,"resolveNoteAnswers");function Gi(e,t,i){const n=Ze(t),a=e.items.filter(o=>o.topic===t.topic&&Ze(o)===n).map(o=>ge(o,i));Qn(a,n)||c(`${t.id} is in prototype round ${n}, which no pick has settled yet; a pick settles it`)}r(Gi,"roundSettled");async function Ie(e){const t=(await U(h.join(e,"data","events.jsonl"))).filter(i=>i.kind==="owner-answer");return Promise.all(t.map(async i=>{const n=await Promise.all(["html","json"].map(a=>D.stat(h.join(e,"data","replies",`${i.id}.${a}`)).then(o=>o.isFile(),()=>!1)));return{...i,reply:i.reply||n.some(Boolean)}}))}r(Ie,"ownerAnswers");async function wn(e,t){const i=await y(q(e),{topics:[],items:[]}),n=await Ie(e),a=(i.items||[]).filter(o=>o.topic===t).map(o=>ge(o,n));return{owner:i,asked:a}}r(wn,"topicQuestions");const qe=r((e,t)=>wn(e,`item:${t}`),"cardQuestions"),gt=r((e,t,i)=>mn(e,`item:${t}`,i),"resolveAnswered");async function mn(e,t,i){if(!e)return[];const{owner:n,asked:a}=await wn(e,t),o=pn(a);return o.length&&await $t(e,n,o,i),await kt(e,t),o.map(s=>`resolved: ${s}`)}r(mn,"resolveAnsweredOn");const hn=r(async(e,t)=>!!e&&(await qe(e,t)).asked.some(i=>i.state==="open"),"hasOpenQuestion");function $n(e,t,i){e.next=_(t,"--next"),i?e.next_on_questions=!0:delete e.next_on_questions}r($n,"setNext");async function kt(e,t,{build:i=!1}={}){const n=t.startsWith("item:")&&!t.startsWith("item:ask:")?t.slice(5):null;if(!n)return;let a;try{a=await P(e,n)}catch(l){if(l instanceof Q)return;throw l}const{source:o,wave:s,item:d}=a;d.next_on_questions&&(!i&&(await qe(e,n)).asked.some(l=>l.state!=="resolved")||(delete d.next,delete d.next_on_questions,await x(o.file,s)))}r(kt,"clearWaitedNext");async function gn(e,t,i,n){if(!e)return async()=>[];const{owner:a,asked:o}=await qe(e,t),s=o.filter(l=>l.state==="open").map(l=>l.id);s.length&&!n&&c(`${i}: ${t} has ${s.length===1?"an open question":"open questions"} ${s.join(", ")} with no answer yet; pass --force to close the card and resolve ${s.length===1?"it":"them"} too`);const d=o.filter(l=>l.state!=="resolved").map(l=>l.id);return async()=>(d.length&&await $t(e,a,d,"Closed with the card"),d.map(l=>`resolved: ${l}`))}r(gn,"closeQuestions");async function Ro(e,t,i){await P(e,t),_(i,"--text"),await gn(O(e),t,"land",!1)}r(Ro,"checkClose");async function kn(e,t){const i=await y(q(e),{items:[]}),n=await Ie(e);return zn((i.items||[]).map(a=>ge(a,n)),t)}r(kn,"unpickedPrototype");const Qi=r(e=>e.length>120?`${e.slice(0,119)}\u2026`:e,"clip"),Zi={ask:"text","ask-edited":"text","item-message":"text","owner-answer":"note"};async function yn(e,t,i){const n=_(t,i).replace(/\s+/g," ");return(await U(h.join(e,"data","events.jsonl"))).map(o=>String(o.data?.[Zi[o.kind]]??"").replace(/\s+/g," ").toLowerCase()).some(o=>o.includes(n.toLowerCase()))||c(`${i} must quote the owner's words in an ask, card message or answer note on this board`),n}r(yn,"ownerQuote");async function No(e,t,i){return O(e),i===void 0&&c(`only the owner's Serve / Build and the hub's Auto-build start a card run; pass --asked "<the owner's words>" quoting where the owner asked for ${t}'s run`),`Running at the owner's ask: "${await yn(e,i,"--asked")}"`}r(No,"askedGate");async function _e(e,t,i="--from-ask"){return te(t,i),(await U(h.join(O(e),"data","events.jsonl"))).some(a=>a.id===t&&a.kind==="ask")?t:c(`no ask "${t}" in this site's data/events.jsonl`)}r(_e,"checkAsk");const L=["done","merged","dropped"],Vi=["ready","grilling","prototyping"];function yt(e){return["building","fixing"].includes(e?.status)?(delete e.status,e.status_at=new Date().toISOString(),!0):!1}r(yt,"clearBuildingStatus");const K=r((e,t)=>String(t).includes("/")?String(t):`${e}/${t}`,"depKey");async function je(e,t,i){const n=(i.deps||[]).map(o=>K(t,o)),a=await Promise.all(n.map(o=>P(e,o).then(({item:s})=>s,()=>null)));return n.filter((o,s)=>a[s]&&!L.includes(a[s].status))}r(je,"unfinishedDeps");async function Yi(e,t){const i=[];for(const n of await C(e)){const a=await y(n.file,null);for(const o of Array.isArray(a?.items)?a.items:[])![void 0,"planned","waiting","held"].includes(o.status)||!(o.deps||[]).some(s=>K(n.slug,s)===t)||(await je(e,n.slug,o)).length||i.push({key:`${n.slug}/${o.id}`,queued:!!o.queued_at})}return i}r(Yi,"unblockedBy");async function bn(e,t,i,n){const a=new Set(n.match(/[\w-]+(?:\.[\w-]+)*(?:\/[\w-]+(?:\.[\w-]+)*)*/g)||[]),o=new Set((i.deps||[]).map(s=>K(T(t).wave,s)));for(const s of await C(e)){const d=await y(s.file,null);for(const l of d?.items||[]){const u=`${s.slug}/${l.id}`;if(u===t||o.has(u)||L.includes(l.status))continue;[l.id,ke(d,l)].flatMap(m=>[m,`${s.slug}/${m}`]).some(m=>a.has(m))&&c(`--next names unfinished card ${u}; add it with --deps`)}}}r(bn,"checkNextDeps");async function Fe(e,t){const i=r(a=>c(`a notes file is a .md file inside ${e}, named relative to it: "${t}" ${a}`),"bad");(typeof t!="string"||!t.trim())&&i("is empty"),(h.isAbsolute(t)||t.split(/[\\/]/).includes(".."))&&i("leaves the folder"),h.extname(t).toLowerCase()!==".md"&&i("is not a .md file");const n=await D.realpath(h.resolve(e,t)).catch(()=>i("does not exist"));return n.startsWith(await D.realpath(e)+h.sep)||i("leaves the folder"),n}r(Fe,"planPath");async function Eo(e,t){const{source:i,wave:n,item:a}=await P(e,t);if(a.plan)return{wave:n,item:a,markdown:await D.readFile(await Fe(i.dir,a.plan),"utf8")};if(typeof a.notes=="string"&&a.notes.trim())return{wave:n,item:a,markdown:a.notes};c(`${t} has no notes`)}r(Eo,"readNotes");function xn({install:e,installSha:t,installLabel:i,clearInstall:n}){if(e===void 0)return(t!==void 0||i!==void 0)&&c("--install-sha and --install-label go with --install <url>"),n?null:void 0;n&&c("pass --install or --clear-install, not both");let a;try{a=new URL(String(e).trim())}catch{a=null}(!a||!["https:","itms-services:"].includes(a.protocol))&&c(`--install takes an https:// or itms-services:// URL, not "${e}"`),a.protocol==="itms-services:"&&!(a.searchParams.get("action")==="download-manifest"&&/^https:\/\//.test(a.searchParams.get("url")||""))&&c("--install: an itms-services:// URL needs ?action=download-manifest&url=https://\u2026/manifest.plist");const o=t===void 0?void 0:/^[0-9a-f]{7,40}$/i.test(t)?t.toLowerCase():c(`--install-sha takes a commit sha of 7 to 40 hex digits, not "${t}"`);return{url:String(e).trim(),...i===void 0?{}:{label:_(i,"--install-label")},built_at:new Date().toISOString(),...o?{sha:o}:{}}}r(xn,"installOf");async function To(e,{install:t,installSha:i}){const n=xn({install:t,installSha:i});n||c("main set needs --install <url>");const a=h.join(O(e),"data","main.json");return await x(a,{install:n}),{file:a,lines:["main install set"]}}r(To,"setMainInstall");function Xi(e,t,i,n,a){return n==="merged"?a??(i.status==="merged"?null:i.pr?`Merged PR #${i.pr}.`:"Merged."):(a===void 0&&e&&c(`--status ${n} needs --text "<what was done or left>", which becomes ${t}'s last thread line`),a??null)}r(Xi,"closingLine");async function vn(e,t,{ticket:i,status:n,clearStatus:a,next:o,clearNext:s,pr:d,pushed:l,ghSince:u,fromAsk:f,state:m,held:p,unheld:w,pickUpAt:$,notesFile:g,deps:k,parent:v,related:S,install:j,installSha:R,installLabel:B,clearInstall:N,title:ae,size:Y,model:M,force:F,text:J,who:$e},X){n!==void 0&&a&&c("pass --status or --clear-status, not both"),m!==void 0&&!Vi.includes(m)&&c("--state takes ready, grilling or prototyping"),F&&!L.includes(n)&&c(`--force goes with --status ${L.join(", ")}`),f!==void 0&&L.includes(n)&&c("--from-ask opens a card; close it in another call"),J!==void 0&&_(J,"--text"),J!==void 0&&f===void 0&&!L.includes(n)&&c(`--text goes with --from-ask or --status ${L.join(", ")}`),f!==void 0&&J===void 0&&c(`--from-ask needs --text "<first line>", the item's first thread line after the ask`),o!==void 0&&s&&c("pass --next or --clear-next, not both"),typeof o=="string"&&!o.trim()&&([o,s]=[void 0,!0]);const ce=ea({held:p,unheld:w,pickUpAt:$}),de=xn({install:j,installSha:R,installLabel:B,clearInstall:N});[n,a,o,s,d,l,u,f,m,ce,g,k,v,S,de,ae,Y,M,i].every(A=>A===void 0||A===!1)&&c("nothing to set: pass --status, --clear-status, --next, --clear-next, --pr, --pushed, --gh-since, --from-ask, --state, --held, --unheld, --pick-up-at, --notes-file, --deps, --parent, --related, --install, --clear-install, --title, --size, --model or --ticket");const E=f===void 0?void 0:await _e(e,f);E&&await rt(e,E);const{source:Z,wave:G,item:b}=await P(e,t);E&&b.from_ask&&b.from_ask!==E&&c(`${t} came from ask "${b.from_ask}", so ask "${E}" can't be its from-ask; to fold it in: item relate-ask ${E} ${t} --summary "<line>"`);const Cn=b.status,In=L.includes(b.status),St=await Promise.all((await he(Z.dir,b.id)).map(A=>y(A,null))),qn=Qe(b,St);if(g!==void 0&&(await Fe(Z.dir,g),b.plan=h.normalize(g)),ae!==void 0&&(b.title=_(ae,"--title")),Sn(b,{size:Y,model:M}),k!==void 0){const A=await jn(e,T(t).wave,k);A.length?b.deps=A:delete b.deps}if(v!==void 0){const A=await On(e,T(t).wave,t,v);A?b.parent=A:delete b.parent}const _t=S===void 0?null:await aa(e,t,b,S);if(ce!==void 0&&Me(b,ce),n==="building"&&(b.held||b.status==="held")&&c(b.pick_up_at?`${t} is held until ${b.pick_up_at}, when the board resumes it; start it early only with item set ${t} --unheld`:`${t} is held; start it only once the owner resumes it, with item set ${t} --unheld`),n!==void 0&&(b.status=Et.includes(n)?n:c(`--status takes ${Et.join(", ")}`)),(ta.includes(n)||d!==void 0||l!==void 0)&&na(b),n==="building"){const A=await je(e,T(t).wave,b);A.length&&c(`${t} is blocked by ${A.join(", ")}; start it once ${A.length===1?"that is":"those are"} done or merged`)}(n==="building"||L.includes(n))&&delete b.queued_at;const De=n==="building"&&e?await kn(e,t):null;De&&c(`${t} has no take picked: the owner's answer to ${De.id} picks none${De.note?` ("${Qi(De.note)}")`:""}; act on its note, with another prototype round when it asks for one, and build once a take is picked`);const Fn=L.includes(n)?await gn(e,t,`--status ${n}`,F):async()=>[],jt=L.includes(n)?Xi(e,t,{...b,status:Cn},n,J):null;if(a&&delete b.status,(n!==void 0||a)&&(b.status_at=new Date().toISOString()),o!==void 0&&($n(b,o,await hn(e,t)),await bn(e,t,b,b.next)),s&&(delete b.next,delete b.next_on_questions),n==="building"&&o===void 0&&b.next_on_questions&&(delete b.next,delete b.next_on_questions),d!==void 0&&(b.pr=/^[1-9]\d*$/.test(String(d))?Number(d):c("--pr takes a PR number"),yt(b)),l!==void 0){Ae().find(A=>Pe(A.dir,O(e)))?.remote||c("--pushed is for a board whose repo is a plain git remote; on GitHub, open a PR and pass --pr"),b.pr&&c(`${t} has PR #${b.pr}; its PR says when it merges`);try{ui(l)}catch{c("--pushed takes the name of the branch you pushed")}b.pushed={branch:l,at:new Date().toISOString()},b.branch=l,yt(b)}if(u!==void 0&&((typeof u!="string"||!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$/.test(u)||Number.isNaN(Date.parse(u)))&&c("--gh-since takes an ISO-8601 UTC time such as 2026-10-23T11:00:00Z"),b.gh_since=u),E&&(b.from_ask=E),m==="ready"&&e){const A=(await qe(e,t)).asked.filter(oe=>oe.state==="open").map(oe=>oe.id);A.length&&c(`${t} has ${A.length===1?"an open question":"open questions"} ${A.join(", ")}; it is ready once the owner has answered ${A.length===1?"it":"them"}`)}m!==void 0&&(b.state=m),de&&(b.install=de),de===null&&delete b.install,!qn&&!["building","fixing"].includes(n)&&Qe(b,St)&&c(`that leaves ${t} In Progress with nothing building and no Next; pass --next "<what happens next>"`);const Ot=i!==void 0||E&&!b.ticket&&!b.linear?.length?await bt(e,t,G,b,i,X,Z.dir,xt(e,t)):null;await x(Z.file,G),_t&&await _t();const ee=await Fn();g!==void 0&&ee.push(...await gt(e,t,"Recorded in the card's notes")),n==="building"&&ee.push(...await gt(e,t,"Acted on: build started")),E&&ee.push(...(await Ee(e,t,{text:J})).lines),jt&&e&&ee.push(...(await Ee(e,t,{text:jt,who:$e})).lines),Ot&&ee.push(Ot);const Dt=si({status:n,pr:d??l}),At=Dt&&await ri(await Dn(e),b,Dt,{...X,repo:re(e,G)});At&&ee.push(At),(d!==void 0||l!==void 0||ka.includes(n))&&await ya(Z.dir,b.id,L.includes(n));const Ke=E?await be(e):{};if(I(Ke,E)!==void 0&&(delete Ke[E],await x(fe(e),{links:Ke})),!L.includes(n)||In)return{file:Z.file,lines:ee};const Pt=await Yi(e,t),Mn=new Date().toISOString();for(const{key:A,queued:oe}of Pt)await V(H(e,A),{ts:Mn,who:"claude",text:`Unblocked: ${await ne(e,t)} is ${n}.`}),oe||await Ve({dir:e},"card-unblocked",{key:A});return{file:Z.file,lines:[...Pt.map(({key:A,queued:oe})=>oe?`queued build starts: ${A}`:`unblocked: ${A}`),...ee]}}r(vn,"changeItem");function Sn(e,{size:t,model:i}){for(const[n,a,o]of[["size",t,["small","large"]],["model",i,["opus","sonnet"]]])a!==void 0&&(a===""?delete e[n]:e[n]=o.includes(a)?a:c(`--${n} takes ${o.join(" or ")}, or "" to clear it`))}r(Sn,"setBuildChoice");function ea({held:e,unheld:t,pickUpAt:i}){return[e,t,i!==void 0].filter(Boolean).length>1&&c("pass one of --held, --unheld and --pick-up-at"),i!==void 0?i===""?null:{until:_n(i)}:e?{until:null}:t?null:void 0}r(ea,"holdOf");function _n(e){const t=typeof e=="string"&&ai.test(e)?Date.parse(e):NaN;return Number.isNaN(t)&&c('--pick-up-at takes an ISO time such as 2026-11-04T09:00, the Mac\u2019s local time unless it names an offset, or "" to resume the card'),t<=Date.now()&&c(`--pick-up-at ${e} has passed; pass a later time, or --unheld to resume the card now`),new Date(t).toISOString()}r(_n,"pickUpTime");const ta=["building","fixing","checking",...L];function na(e){delete e.held,delete e.pick_up_at}r(na,"clearHold");function Me(e,t){t?e.held=!0:delete e.held,t?.until?e.pick_up_at=t.until:delete e.pick_up_at,!t&&e.status==="held"&&delete e.status,e.held_at=new Date().toISOString()}r(Me,"setHold");async function Lo(e,t,i,{announce:n=!0}={}){const{source:a,wave:o,item:s}=await P(e,t);if(n){const d=new Date(i).toLocaleString("en-US",{weekday:"short",month:"numeric",day:"numeric",hour:"numeric",minute:"2-digit"});await V(H(e,t),{ts:new Date().toISOString(),who:"claude",text:`Resumed: its hold until ${d} ended.`}),!s.queued_at&&!(await je(e,T(t).wave,s)).length&&await Ve({dir:e},"card-unblocked",{key:t,until:i})}Me(s,null),await x(a.file,o)}r(Lo,"pickUp");async function ia(e,t,i){const n=String(i?.key||""),{wave:a,id:o}=T(n),{source:s,wave:d}=await le(e,a),l={text:"Marked done.",who:"love"},u=d.items.find(p=>p.id===o)||c(`wave "${a}" has no item "${o}"`);if(["merged","dropped"].includes(u.status))return null;if(t==="card-done")return Oe(e,n,{status:"done",force:!0,...l});const f=i.hold?typeof i.until=="string"?new Date(i.until).toISOString():null:void 0;Me(u,i.hold?{until:f}:null),await x(s.file,d);const m=f&&new Date(f).toLocaleString("en-US",{weekday:"short",month:"numeric",day:"numeric",hour:"numeric",minute:"2-digit"});return Ee(e,n,{text:i.hold?m?`Held until ${m}.`:"Held.":"Resumed.",who:"love"})}r(ia,"recordOwnerTap");async function jn(e,t,i){const n=[...new Set(String(i).split(",").map(a=>a.trim()).filter(Boolean))];for(const a of n)await P(e,K(t,a));return n}r(jn,"depList");async function On(e,t,i,n){if(!String(n).trim())return null;const a=K(t,String(n).trim());a===i&&c("--parent: a card can't be its own Parent");for(let o=a;o;){const{item:s}=await P(e,o);s.parent&&K(T(o).wave,s.parent)===i&&c(`--parent: ${a} is a child of ${i}, so it can't be its Parent`),o=s.parent?K(T(o).wave,s.parent):null}return a}r(On,"parentKey");async function aa(e,t,i,n){const a=[...new Set(String(n).split(",").map(o=>o.trim()).filter(Boolean).map(o=>K(T(t).wave,o)))];a.includes(t)&&c("--related: a card can't be related to itself");for(const o of a)await P(e,o);return a.length?i.related=a:delete i.related,async()=>{for(const o of await C(e)){const s=await y(o.file,null);let d=!1;for(const l of Array.isArray(s?.items)?s.items:[]){const u=`${o.slug}/${l.id}`;u===t||a.includes(u)||!(l.related||[]).some(f=>K(o.slug,f)===t)||(l.related=l.related.filter(f=>K(o.slug,f)!==t),l.related.length||delete l.related,d=!0)}d&&await x(o.file,s)}}}r(aa,"setRelated");const re=r((e,t)=>e&&Ae().find(i=>Pe(i.dir,e))?.github||t.repo,"boardRepoOf");async function Bo(e,t){const{wave:i,item:n}=await P(e,t);(!Number.isInteger(n.pr)||n.pr<=0)&&c(`${t} has no PR`);const a=re(e,i);a||c(`${t} has no repo`);const o=n.gh_since||"1970-01-01T00:00:00Z";try{const s=pe(await W(e)).github_login||await fi();return Mt(await Ft({repo:a,pr:n.pr,since:o}),{pr:n.pr,since:o,me:s})}catch(s){c(s.message)}}r(Bo,"prReport");const Dn=r(async e=>ln((await W(e)).tickets),"boardSource");async function Co(e,t,{afterApproval:i,confirmed:n}={}){O(e);const{wave:a,item:o}=await P(e,t);Number.isInteger(o.pr)||c(`${t} has no PR`),L.includes(o.status)&&c(`${t} is ${o.status}`);const s=re(e,a)||c(`${t} has no repo`);let d;try{d=await Ft({repo:s,pr:o.pr,since:new Date().toISOString()})}catch(S){c(S.message)}const{view:l,reviews:u}=d;if(l.state==="MERGED")return Oe(e,t,{status:"merged",text:`PR #${o.pr} was already merged.`});const{failing:f,pending:m}=Mt(d,{pr:o.pr,since:new Date().toISOString(),me:null}),p=Jn({...l,checks:{state:f.length?"fail":m?"pending":"pass",failing:f,pending:m}}),w=u.filter(S=>S.state==="APPROVED").sort((S,j)=>String(S.submitted_at).localeCompare(String(j.submitted_at))).at(-1)?.commit_id,$=!!(w&&l.headRefOid&&w!==l.headRefOid);i!==void 0&&!$&&c("--after-approval: no commit came after the approval; drop it"),$&&i===void 0&&p.push('commits after the approval: pass --after-approval "<why they are trivial>" when they are, else ask the approver to look again');const g=o.manual_steps?.length?n===void 0?null:await yn(e,n,"--confirmed"):void 0;if(n!==void 0&&g===void 0&&c(`--confirmed: ${t} has no manual steps; drop it`),g===null&&p.push(`manual steps: merge only on the owner's word, with --confirmed "<their words>"`),p.length){const S=`Not merged: ${p.join("; ")}.`;await oa(e,t)&&await Ee(e,t,{text:S}),c(S)}const k=await new Promise(S=>{Rt("gh",["pr","merge",String(o.pr),"--repo",s,"--squash"],{encoding:"utf8",timeout:12e4},(j,R,B)=>S(j?String(B||j.message).trim().split(`
10
- `)[0]:null))});k&&c(`gh pr merge #${o.pr} failed: ${k}`);const v=[`Merged PR #${o.pr}.`,i!==void 0&&`After the approval: ${_(i,"--after-approval")}`,g&&`The owner's word on the manual steps: "${g}"`];return Oe(e,t,{status:"merged",text:v.filter(Boolean).join(" ")})}r(Co,"mergeCard");async function oa(e,t){const i=(await U(h.join(e,"data","events.jsonl"))).filter(a=>a.kind==="card-merge"&&a.data?.key===t).at(-1)?.ts,n=(await U(H(e,t))).filter(a=>(a.who||"claude")==="claude"&&a.kind!=="status").at(-1)?.ts;return!!i&&String(i)>String(n||"")}r(oa,"ownerMergeWaits");async function bt(e,t,i,n,a,o,s,d){try{const l=await W(e),u=Ye(l.tickets||{source:"internal"}),f=r(($,g)=>$.internal===!0?String(g.id).replace(/^S(\d+)$/,`${u.prefix}-$1`):null,"ownId");a===void 0&&u.source==="internal"&&Xe(u,f(i,n))&&(a=f(i,n));let m=0;if(u.source==="internal")for(const $ of await C(e)){const g=await y($.file,{});for(const k of g.items||[]){const v=[k.ticket,f(g,k)];if(m=Math.max(m,...v.map(S=>Xe(u,S)||0)),a!==void 0&&`${$.slug}/${k.id}`!==t&&v.includes(a))throw Object.assign(new Q(`${a} is already the ticket of ${$.slug}/${k.id}`),{held:!0})}}const p=a===void 0&&u.source!=="internal"&&n.plan?await D.readFile(await Fe(s,n.plan),"utf8"):n.notes||"",w=await oi(u,{ticket:a,title:n.title,body:p,repo:re(e,i),next:m+1},o);return w.mcp?(delete n.ticket,delete n.ticket_created,di(u,n.title,d)):(n.ticket=w.ticket,w.created&&u.source!=="internal"?n.ticket_created=!0:delete n.ticket_created,null)}catch(l){if(l instanceof Q)throw l;c(l.message)}}r(bt,"assignTicket");const me=r((e,t)=>qt(h.join(e||Ne(),"tickets"),t,{heartbeat:!0}),"ticketWrite"),Oe=r((e,t,i,n)=>i.ticket!==void 0||i.fromAsk!==void 0?me(e,()=>vn(e,t,i,n)):vn(e,t,i,n),"setItem"),Io=r((e,t,i,n)=>me(e,()=>sa(e,t,i,n)),"addItem");async function sa(e,t,{title:i,notes:n,deps:a,notesFile:o,ticket:s,pickUpAt:d,parent:l,size:u,model:f},m){const{wave:p,id:w}=t.includes("/")?T(t):{wave:t};w!==void 0&&te(w,"the item id");const{source:$,wave:g}=await le(e,p);w!==void 0&&g.items.some(j=>j.id===w)&&c(`wave "${p}" already has an item "${w}"`);const k={id:w,title:_(i,"--title"),created:new Date().toISOString()};l!==void 0&&(k.parent=await On(e,p,null,l)||c("--parent takes a card, such as <wave>/<id>")),n!==void 0&&(k.notes=_(n,"--notes")),Sn(k,{size:u,model:f}),a!==void 0&&(k.deps=await jn(e,p,a)),o!==void 0&&(await Fe($.dir,o),k.plan=h.normalize(o)),k.status=k.deps?.length?"waiting":"planned",d!==void 0&&Me(k,{until:_n(d)});const v=w===void 0?`${An(e)}item add ${p}/<id> --title <t>`:xt(e,t),S=await bt(e,t,g,k,s,m,$.dir,v);return w===void 0&&(S&&c(S),k.id=li(k.ticket),g.items.some(j=>j.id===k.id)&&c(`wave "${p}" already has an item "${k.id}"; link ${k.ticket} with item add ${p}/<id> --ticket ${k.ticket}`)),g.items.push(k),await x($.file,g),{file:$.file,key:`${p}/${k.id}`,lines:S?[S]:[]}}r(sa,"createItem");const An=r(e=>`board.mjs ${e?`--site ${h.basename(e)} `:""}`,"boardCommand"),xt=r((e,t)=>`${An(e)}item set ${t}`,"setTicketCommand"),qo=r((e,{dryRun:t=!1}={},i)=>me(O(e),()=>ra(e,t,i)),"backfillTickets");async function ra(e,t,i){const n=await Dn(e)||c("this board has no ticket source yet; pick one in Board settings first"),a=new Set,o=[];for(const f of await C(e)){const m=await y(f.file,null);if(Array.isArray(m?.items)){o.push({entry:f,wave:m});for(const p of m.items)p.ticket&&a.add(p.ticket),m.internal===!0&&n.source==="internal"&&a.add(String(p.id).replace(/^S(\d+)$/,`${n.prefix}-$1`))}}const s=[],d={linked:0,created:0,failed:0,mcp:0},l=r((f,m)=>m.ticket&&!(n.source!=="internal"&&f.internal===!0&&m.ticket===m.id),"ticketed");for(const{entry:f,wave:m}of o)for(const p of m.items){if(l(m,p)||L.includes(p.status))continue;const w=`${f.slug}/${p.id}`,$=[...ci(n,p.title),...(p.linear||[]).filter(g=>Xe(n,g))].find(g=>n.source!=="internal"||!a.has(g));if(t){d[$?"linked":"created"]++,s.push(`${w} would ${$?`link ${$}`:"get a new ticket"}`);continue}try{const g=await bt(e,w,m,p,$,i,f.dir,xt(e,w));if(g){d.mcp++,s.push(`${w} ${g}`);continue}await x(f.file,m),a.add(p.ticket),d[$?"linked":"created"]++,s.push(`${w} ${$?"linked":"created"} ${p.ticket}`)}catch(g){if(!(g instanceof Q))throw g;d.failed++,s.push(`${w} failed: ${g.message}`)}}const u=t?`would link ${d.linked}, create ${d.created}`:`linked ${d.linked}, created ${d.created}, failed ${d.failed}${d.mcp?`, ${d.mcp} to create through the Linear MCP`:""}`;return{lines:[...s,`backfill${t?" (dry run)":""}: ${u}`]}}r(ra,"backfill");const Fo=r(e=>me(e,async()=>{const t=[];for(const i of await C(e)){const n=await y(i.file,null);if(!Array.isArray(n?.items)||!Array.isArray(n.followups))continue;const a=n.followups.find(l=>n.items.some(u=>u.id===l.id));a&&c(`${i.slug}: follow-up ${a.id} has the id of a card; rename one, then restart the board`);const o=[];for(const{id:l,title:u,from:f,filed:m,done:p,...w}of n.followups){const $=p?e&&(await U(H(e,`${i.slug}/${l}`))).map(g=>g.ts).filter(Boolean).sort().pop()||m:null;o.push({id:l,title:u,...m?{created:m}:{},...f?{parent:K(i.slug,f)}:{},status:p?"done":"planned",...$?{status_at:$}:{},...w})}const{followups:s,...d}=n;await x(i.file,{...d,items:[...n.items,...o]}),t.push(`${i.slug}: ${o.length} follow-ups moved to cards (${o.filter(l=>l.status==="done").length} done)`)}return t}),"migrateFollowups"),Pn=r(e=>`lineup-${e}.md`,"lineupNoteFile"),ca=r(e=>typeof e=="string"&&/^[a-z0-9-]+$/.test(e)?e:c(`a wave's slug uses only a-z, 0-9 and "-", not "${e}"`),"lineupSlug");async function Ue(e,t){for(const i of await C(e)){const n=await y(i.file,null),a=(n?.lineups||[]).find(o=>o.slug===t);if(a)return{source:i,wave:n,lineup:a}}return c(`this board has no wave "${t}"; lineup create makes one`)}r(Ue,"findLineup");async function da(e,t){(await W(e)).items!=="waves"&&c(`topic wave:${t} is for a board over ~/.claude/waves; a lineup's triage uses lineup:<slug>`),await le(e,t)}r(da,"triagedWave");function We(e,t,i,n){return i.map(a=>{const{wave:o,id:s}=T(a);o!==e.slug&&c(`${a} is not in wave file "${e.slug}"; a wave's cards share one file`),t.items.some(l=>l.id===s)||c(`wave "${o}" has no item "${s}"`);const d=(t.lineups||[]).find(l=>l.slug!==n&&!l.finished_at&&l.items.includes(s));return d&&c(`${a} is already in the wave "${d.slug}"; lineup remove ${d.slug} ${a} first`),s})}r(We,"lineupCards");function Rn(e,t,i,n){const a=new Set(i.map(o=>`${e.slug}/${o}`));for(const o of i){const s=t.items.find(u=>u.id===o),d=(s.deps||[]).filter(u=>!a.has(K(e.slug,u))),l=n.indexOf(o);l>0&&d.push(n[l-1]),d.length?s.deps=d:delete s.deps}}r(Rn,"chain");async function Nn(e,t,i,n,a){a!==void 0&&await it(h.join(t.dir,Pn(n.slug)),`${_(a,"the note").replace(/\n*$/,`
11
- `)}`),await x(t.file,i);const{tickets:o}=pe(await W(e));return{file:t.file,lines:[`order: ${n.items.map(s=>ke(i,i.items.find(d=>d.id===s),o)).join(" \u2192 ")}`]}}r(Nn,"writeLineup");async function Mo(e,t,{title:i,goal:n,cards:a,note:o}){ca(t);const s=String(a??"").split(",").map(p=>p.trim()).filter(Boolean);s.length||c("--cards takes the cards in build order, as <wave>/<id>,<wave>/<id>"),o===void 0&&c("lineup create needs the wave note, as --note <text> or --file <path>");const d=await C(e);d.some(p=>p.slug===t)&&c(`"${t}" is a wave file on this board; pick another slug`);for(const p of d)((await y(p.file,null))?.lineups||[]).some(w=>w.slug===t)&&c(`this board already has a wave "${t}"`);const l=d.find(p=>p.slug===T(s[0]).wave)||c(`this board has no wave "${T(s[0]).wave}"`),{wave:u}=await le(e,l.slug),f=We(l,u,s,t);new Set(f).size!==f.length&&c("--cards names a card twice");const m={slug:t,title:_(i,"--title"),goal:_(n,"--goal"),items:f,created:new Date().toISOString()};return Rn(l,u,f,f),u.lineups=[...u.lineups||[],m],Nn(e,l,u,m,o)}r(Mo,"createLineup");async function Uo(e,t,{add:i,after:n,remove:a,title:o,goal:s,note:d}){[i,a,o,s,d].every(p=>p===void 0)&&c("nothing to change: pass --add, --remove, --title, --goal, --note or --file"),n!==void 0&&i===void 0&&c("--after goes with --add");const{source:l,wave:u,lineup:f}=await Ue(e,t);f.finished_at&&c(`the wave "${t}" is finished`);const m=[...f.items];if(i!==void 0){const[p]=We(l,u,[i],t);f.items.includes(p)&&c(`${i} is already in the wave "${t}"`);const w=n===void 0?f.items.length:f.items.indexOf(We(l,u,[n],t)[0])+1;w===0&&c(`--after ${n} is not in the wave "${t}"`),f.items.splice(w,0,p)}if(a!==void 0){const[p]=We(l,u,[a],t);f.items.includes(p)||c(`${a} is not in the wave "${t}"`),f.items.length===1&&c(`${a} is the wave's last card; lineup finish ${t} ends the wave`),f.items=f.items.filter(w=>w!==p)}return o!==void 0&&(f.title=_(o,"--title")),s!==void 0&&(f.goal=_(s,"--goal")),Rn(l,u,[...new Set([...m,...f.items])],f.items),Nn(e,l,u,f,d)}r(Uo,"changeLineup");async function Wo(e,t){const{source:i,wave:n,lineup:a}=await Ue(e,t);return a.finished_at=new Date().toISOString(),await x(i.file,n),{file:i.file}}r(Wo,"finishLineup");async function Ho(e,t,i){const{source:n,wave:a,lineup:o}=await Ue(e,t),s=await D.readFile(h.join(n.dir,Pn(t)),"utf8").catch(()=>""),d=o.items.map(l=>ke(a,a.items.find(u=>u.id===l)||{id:l},i)).join(" \u2192 ");return{title:o.title,markdown:`**Goal** ${o.goal}
10
+ `).replace(/<[^>]*>/g,"").replace(/&(?:#(x[\da-f]{1,6}|\d{1,7})|(\w+));/gi,(t,i,n)=>{const a=i&&parseInt(i.replace(/^x/i,""),/^x/i.test(i)?16:10);return i?a<=1114111?String.fromCodePoint(a):t:U(ka,n.toLowerCase())??t})}r(ya,"htmlText");function ba(e){if(!e||!e.startsWith("/"))return e;const t=new URL(e,"http://board");return/^#item=[^&]+$/.test(t.hash)&&(t.hash=`${t.hash}&reply`),/\/[\w-]+\.html$/.test(t.pathname)&&!t.pathname.endsWith("/index.html")&&t.searchParams.set("from","push"),t.pathname+t.search+t.hash}r(ba,"pushUrl");const xa=r((e,t)=>`/${g.basename(e)}/#item=${encodeURIComponent(t)}&reply`,"threadUrl");async function $n(e,t,i){const n=$a(i);if(!n)return[];const a=Di(t),s=await Ai(a,o=>[n,ha.exec(o)?.[1]].filter(Boolean).join(" \xB7 "),xa(e,t));return s===null?[]:[`queued push ${a} now reads: ${s}`]}r($n,"freshenPush");const kn=r(e=>g.join(e,"data","hidden.json"),"hiddenFile"),va=r(async e=>new Set((await y(kn(e),{events:[]})).events||[]),"readHidden");let yn=Promise.resolve();function eo(e,t,i){le(t,"the event id");const n=yn.then(async()=>{const a=await va(e);i?a.add(t):a.delete(t),await x(kn(e),{events:[...a]})});return yn=n.catch(()=>{}),n}r(eo,"setHidden");const Dt=20*1024*1024,$e=r(e=>g.join(e,"data","uploads"),"uploadsDir"),Pe=r((e,t)=>g.join($e(e),".meta",`${t}.json`),"uploadMeta"),bn=/^\d+-[\w.-]+$/,xn=/^[\w.+-]+\/[\w.+-]+$/,vn=r(()=>Object.assign(new ne(`a file can be at most ${Dt/1024/1024} MB`),{status:413}),"tooLarge");async function to(e,t,{name:i,type:n,length:a}){if(A(e),a>Dt)throw vn();const s=String(i||"").trim().slice(0,200)||"file",o=g.basename(s).replace(/[^\w.-]+/g,"-").replace(/^[.-]+/,"").slice(-80)||"file",c=String(n||"").split(";")[0].trim().toLowerCase(),d=xn.test(c)?c:"application/octet-stream";await R.mkdir(g.dirname(Pe(e,"x")),{recursive:!0});let u,w;for(let h=Date.now();!w;h++)u=`${h}-${o}`,w=await R.open(g.join($e(e),u),"wx").catch(m=>m.code==="EEXIST"?null:Promise.reject(m));const f=g.join($e(e),u);let p=0;try{for await(const h of t){if(p+=h.length,p>Dt)throw vn();await w.write(h)}}catch(h){throw await w.close(),await R.rm(f,{force:!0}),h}return await w.close(),await x(Pe(e,u),{name:s,type:d,size:p,at:new Date().toISOString()}),{name:s,url:`uploads/${u}`,path:f,type:d,size:p}}r(to,"saveUpload");async function no(e,t){if(!bn.test(t||""))return null;const i=g.join($e(e),t),n=await R.stat(i).catch(()=>null);if(!n?.isFile())return null;const a=await y(Pe(e,t),{});return{path:i,name:a.name||t,type:xn.test(a.type||"")?a.type:"application/octet-stream",size:n.size}}r(no,"readUpload");const _n=["github","slack"];async function ke(e,t,{text:i,link:n,log:a,who:s="claude",via:o,kind:c}){A(e),String(t).startsWith("ask:")?await qe(e,t.slice(4),"the ask"):await O(e,t),/^[^\n]{1,40}$/.test(s.trim())||l("--who takes claude, love or a reviewer's name"),o!==void 0&&!_n.includes(o)&&l(`--via takes ${_n.join(" or ")}`);const d={ts:new Date().toISOString(),who:s.trim(),text:j(i,"--text"),link:J(n,w=>mn(w,"--link")),log:a,via:o,kind:c},u=K(e,t);return await Z(u,d),{file:u,lines:d.who==="claude"&&!o?await $n(e,t,d.text):[]}}r(ke,"appendThread");const de=r(e=>g.join(e,"data","ask-links.json"),"askLinksFile");async function ye(e){return(await y(de(e),{})).links||{}}r(ye,"readAskLinks");async function se(e,t){const{tickets:i}=be(await H(e)),n=await q(e),a=/^ask:(.+)$/.exec(t)?.[1];if(a===void 0){const o=/^([^/\s]+)\/([^/\s]+)$/.exec(t);if(!o)return t;const c=n.find(w=>w.slug===o[1]),d=c&&await y(c.file,null);if(!d)return o[2];const u=(d.items||[]).find(w=>w.id===o[2]);return Qe(d,u||{id:o[2]},i)}const s=e?U(await ye(e),a):void 0;if(s)return se(e,s);for(const o of n){const c=await y(o.file,null),d=(Array.isArray(c?.items)?c.items:[]).find(u=>u.from_ask===a);if(d)return Qe(c,d,i)}return`task ${a}`}r(se,"cardName");async function io(e,t){const i=(await G(g.join(e,"data","events.jsonl"))).find(n=>n.id===t);return i?.kind==="ask"?se(e,`ask:${t}`):typeof i?.data?.key=="string"?se(e,i.data.key):`the ${i?.kind} event`}r(io,"eventCard");async function ao(e,t,i,n){A(e),le(t,"the event id"),(await G(g.join(e,"data","events.jsonl"))).some(c=>c.id===t&&c.kind==="ask")||l(`no ask "${t}" in this site's data/events.jsonl`),await Pt(e,t),await O(e,i);const s={ts:new Date().toISOString(),who:"claude",text:j(n,"--summary")},o=await ye(e);return await x(de(e),{links:{...o,[t]:i}}),await Z(K(e,i),s),de(e)}r(ao,"relateAsk");async function so(e,t){await qe(e,t,"the ask");const i=await ye(e);return U(i,t)===void 0&&l(`ask "${t}" is not folded into a card`),delete i[t],await x(de(e),{links:i}),de(e)}r(so,"unfoldAsk");const nt=r(e=>g.join(e,"data","ask-progress.json"),"askProgressFile");async function it(e){return(await y(nt(e),{})).asks||{}}r(it,"readAskProgress");async function Pt(e,t){const i=U(await it(e),t)?.moved;i&&l(`ask "${t}" was moved to /${i.route}; it lives there now`)}r(Pt,"refuseMoved");async function oo(e,t,i,n){await qe(e,t,"the ask"),await Pt(e,t);const a=await it(e);return await x(nt(e),{asks:{...a,[t]:{state:i,at:new Date().toISOString(),...n===void 0?{}:{next:j(n,"--next")}}}}),nt(e)}r(oo,"markAsk");const _a=[void 0,"planned","waiting"];async function Sa(e,t,i){const n=`ask "${t}"`;if(i.some(w=>w.kind==="ask-withdrawn"&&w.data?.id===t&&!w.data?.key))return{why:`${n} was deleted by the owner`};const a=U(await it(e),t);if(a?.moved)return{why:`${n} was already moved to /${a.moved.route}`};const s=U(await ye(e),t);if(s)return{why:`${n} is folded into ${s}; run ask unfold ${t} first`};const o=[];for(const w of await q(e)){const f=await y(w.file,null);for(const p of Array.isArray(f?.items)?f.items:[])p.from_ask===t&&o.push({key:`${w.slug}/${p.id}`,it:p})}const c=o.find(({it:w})=>Ve(w)||!_a.includes(w.status));return c?{why:`${n} became ${c.key}, which has started`}:o.length?{items:o.map(w=>w.key)}:(await Promise.all(["html","json"].map(w=>R.stat(g.join(e,"data","replies",`${t}.${w}`)).then(()=>!0,()=>!1)))).some(Boolean)||!!a||i.some(w=>w.kind==="ask-done"&&w.data?.id===t)||(await G(K(e,`ask:${t}`))).some(w=>(w.who||"claude")==="claude"&&w.kind!=="status")?{why:`${n} is not New: Claude already answered it`}:null}r(Sa,"askNotNew");async function ja(e,t,i){const n=/^uploads\/([\w.-]+)$/.exec(i?.url||"")?.[1],a=bn.test(n||"")?g.join($e(e),n):null;if(!a||!await R.stat(a).then(d=>d.isFile(),()=>!1))return{name:String(i?.name||n||"file")};await R.mkdir(g.dirname(Pe(t,"x")),{recursive:!0});const s=n.replace(/^\d+-/,"");let o;for(let d=Date.now();o=`${d}-${s}`,!await R.copyFile(a,g.join($e(t),o),xi.COPYFILE_EXCL).then(()=>!0,w=>w.code==="EEXIST"?!1:Promise.reject(w));d++);const c=await y(Pe(e,n),null);return c&&await x(Pe(t,o),c),{...i,url:`uploads/${o}`,path:g.join($e(t),o)}}r(ja,"copyUpload");async function ro(e,t,i){A(e),le(t,"the event id"),(typeof i!="string"||!i.trim())&&l("ask move needs --to <route>, the board to move it to");const n=await G(g.join(e,"data","events.jsonl")),a=n.find(S=>S.id===t&&S.kind==="ask")||l(`no ask "${t}" in this site's data/events.jsonl`),s=ge(),o=s.find(S=>S.route===i)||l(`--to ${i}: no board at /${i} in the hub's manifest; the boards are ${s.map(S=>S.route).join(", ")||"none"}`);je(o.dir,e)&&l(`--to ${i}: that is this board`);const c=await Sa(e,t,n);c?.why&&l(c.why);const d=n.filter(S=>S.kind==="ask-edited"&&S.data?.id===t&&typeof S.data?.text=="string").sort((S,_)=>String(S.ts).localeCompare(String(_.ts))),u=d.at(-1),w=[];for(const S of[...a.data?.files||[],...d.flatMap(_=>_.data.files||[])])w.push(await ja(e,o.dir,S));const f={route:g.basename(e),title:(await H(e)).title,id:t},p=u?u.data.text:a.data?.text||"",h=await Se(o,"ask",{text:p,...w.length?{files:w}:{},from:f}),m={route:i,title:o.title,id:h},$=new Date().toISOString(),b=await it(e);await x(nt(e),{asks:{...b,[t]:{state:"done",at:$,moved:m}}});const v=`/${i}/#item=${encodeURIComponent(`ask:${h}`)}`;await Z(K(e,`ask:${t}`),{ts:$,who:"claude",text:`Moved to ${o.title}.`,link:v});for(const S of c?.items||[])await fe(e,S,{status:"dropped",force:!0,text:`Dropped: its ask moved to ${o.title}.`});return{file:g.join(o.dir,"data","events.jsonl"),lines:[`moved to ${v}`,...(c?.items||[]).map(S=>`dropped: ${S}`)]}}r(ro,"moveAsk");const Sn=r(e=>g.join(e,"data","checked.json"),"checkedFile");async function co(e,t,{idle:i}={}){A(e),i&&t!==void 0&&l("pass --every or --idle, not both"),i===void 0&&t===void 0&&(i=!await Oa(e));const n=new Date,a=i?null:t===void 0?Li.away:/^[1-9]\d{0,3}$/.test(String(t))?Number(t):l("--every takes the minutes between checks, such as 30");return await x(Sn(e),i?{at:n.toISOString(),every:null,idle:!0}:{at:n.toISOString(),every:a}),{file:Sn(e),every:a,lines:await Da()}}r(co,"writeChecked");async function lo(e,t,{state:i,text:n,url:a}={}){A(e),/^[1-9]\d{0,6}$/.test(String(t))||l(`review record takes the PR number, such as 437, not "${t}"`),["posted","needs"].includes(i)||l("review record needs --state posted or --state needs"),String(n??"").trim()||l("review record needs the review text, as --text or --file"),a!==void 0&&!/^https:\/\/github\.com\/\S+$/.test(a)&&l("--url takes the review's link on GitHub");const s=g.join(e,"data","reviews.json"),o=await y(s,{}),d=((await y(g.join(e,"data","incoming.json"),{}))?.prs||[]).find($=>$.number===Number(t))||o[t]||l(`PR #${t} is not an incoming PR on this board`),{title:u,author:w,url:f,touches:p=[],asked:h=!1,head:m}=d;return o[t]={number:Number(t),title:u,author:w,url:f,touches:p,asked:h,head:m,state:i,text:n,...a?{review_url:a}:{},at:new Date().toISOString()},await x(s,o),{file:s,lines:[]}}r(lo,"recordReview");async function Oa(e){for(const t of await q(e)){const i=await y(t.file,null);if((i?.items||[]).some(n=>!I.includes(n.status)&&Ze(n,oe(e,i)).length))return!0}return!1}r(Oa,"hasOpenPR");async function Da(){const e=Ni(new Date);if(e.hold)return e.count?[`queued pushes held: ${Ci(e.hold)}`]:[];const t=await Ri();return t?[`sent ${t.sent} of ${t.count} queued push${t.count===1?"":"es"}${t.ok?"":"; the rest stay queued"}`]:[]}r(Da,"flushAfterTick");const at=r(e=>g.join(e,"data","handshake.json"),"handshakeFile"),jn=r(e=>y(at(e),null),"readHandshake");async function uo(e,t){A(e),le(t,"the event id");const i=(await G(g.join(e,"data","events.jsonl"))).find(a=>a.id===t);i?.kind!=="hello"&&l(`no hello event "${t}" in this site's data/events.jsonl`);const n=await jn(e)||{};return n.hello?.id&&n.hello.id!==t&&l(`"${t}" is an older hello; ack the newest, "${n.hello.id}"`),await x(at(e),{...n,hello:n.hello||{id:t,at:i.ts,session:null},ack:{id:t,at:new Date().toISOString()}}),at(e)}r(uo,"ackHello");async function fo(e){const t=await jn(e);t&&!t.done_at&&await x(at(e),{...t,done_at:new Date().toISOString()})}r(fo,"finishHandshake");const At={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})$/},Ce=r((e,t)=>e.trim().toLowerCase()===t.trim().toLowerCase(),"sameName");function Rt(e,t){return Array.isArray(e)||l(`${t} must be a JSON array of reviewers`),e.forEach((i,n)=>{const a=`${t}[${n}]`;Oe(i,Object.keys(At),a);for(const[s,o]of Object.entries(At))(typeof i[s]!="string"||!o.test(i[s].trim()))&&l(`${a}.${s} must match ${o}`);e.slice(0,n).some(s=>Ce(s.name,i.name))&&l(`${t} names "${i.name}" twice`)}),e.map(i=>Object.fromEntries(Object.keys(At).map(n=>[n,i[n].trim()])))}r(Rt,"checkReviewers");async function Nt(e,t){const{file:i,reviewers:n}=await Lt(e,s=>{const o=Rt(t(s.reviewers||[]),"the reviewers");return{set:{reviewers:o},reviewers:o}}),a=[];for(const s of await q(e)){const o=await y(s.file,null);(o?.items||[]).some(c=>!I.includes(c.status))&&(await x(s.file,{...o,reviewers:n}),a.push(`wave ${s.slug}: reviewers copied`))}return{file:i,lines:a}}r(Nt,"writeReviewers");const wo=r((e,t)=>Nt(e,()=>Rt(t,"the reviewer file")),"setReviewers"),On=r((e,t)=>((typeof e!="string"||!/^\d+(?:\.\d+)?$/.test(e)||Number(e)<=0)&&l("--ts must be a Slack message timestamp"),(typeof t!="string"||!/^D[A-Z0-9]+$/.test(t))&&l("--channel must be a DM channel id"),{ts:e,channel:t}),"linkMessage"),Et=r((e,t,i)=>Xe(e,t).find(n=>n.name===i)||l(`no reviewer "${i}" on this wave or board`),"reviewerOn"),po=r((e,t,i,{ts:n,channel:a})=>Ne(e,async()=>{const s=On(n,a),{source:o,wave:c,item:d}=await O(e,t);return Et(c,(await H(e)).reviewers,i),d.review_link_ts={...d.review_link_ts,[i]:s},await x(o.file,c),o.file}),"reviewSent"),mo=r((e,t,i,n)=>Ne(e,async()=>{(typeof n!="string"||!/^[\w+-]+$/.test(n))&&l("emoji must be a Slack emoji name without colons");const{source:a,wave:s,item:o}=await O(e,t),c=Et(s,(await H(e)).reviewers,i),d=_t(s,o,t,St())[i];d?.ts||l(`no review link recorded for ${i} on ${t}`);const u=U(o.review_link_ts,i),w=typeof u=="object"&&Array.isArray(u?.reactions)?u.reactions:[];return w.includes(n)||(o.review_link_ts={...o.review_link_ts,[i]:{...d,channel:d.channel||c.dm,reactions:[...w,n]}},await x(a.file,s)),a.file}),"reviewReact"),Dn=r(e=>g.join(A(e),"data","review-digests.json"),"digestFile");async function ho(e,t){A(e);const i=await un.waiting("slack");if(i)return{waiting:i,dms:[],reactions:[],digest:null};const n=await H(e),a=await y(en,{}),s=St(),o=`board.mjs --site ${g.basename(e)}`,c=r(f=>/^[\w.@-]+$/.test(f)?f:JSON.stringify(f),"arg"),d=[],u=[];for(const f of await q(e)){const p=await y(f.file,{}),h=Xe(p,n.reviewers),m=oe(e,p);for(const $ of p.items||[]){const{prs:b,pr:v}=Pn(a,$,m);if(!v||["done","dropped"].includes($.status))continue;const S=`${f.slug}/${$.id}`,_=_t(p,$,S,s);if($.status==="merged"||$.merged_at||cn(b.map(D=>D.gh)))for(const D of h){const P=U(_,D.name),E=U($.review_link_ts,D.name);!P?.ts||Array.isArray(E?.reactions)&&E.reactions.includes("git_merged")||u.push({key:S,reviewer:D.name,channel:P.channel||D.dm,ts:P.ts,emoji:"git_merged",record:`${o} review react ${S} ${c(D.name)} git_merged`})}else if(v.gh?.state==="OPEN"&&!v.gh.isDraft){const D=b.filter(P=>P.gh?.state==="OPEN").map(P=>P.url).join(`
11
+ `);for(const P of h.filter(E=>!U(_,E.name)))d.push({key:S,reviewer:P.name,channel:P.dm,text:D,record:`${o} review sent ${S} ${c(P.name)} --ts <ts> --channel ${P.dm}`})}}}const w=await Pa(e,t);return{dms:d,reactions:u,digest:w.due?{...w,record:`${o} review digest sent <reviewer> --ts <ts> --channel <dm> --items <key,key>`}:null}}r(ho,"reviewDue");function Pn(e,t,i){const n=Ze(t,i).map(a=>({...a,url:Yi(a),gh:U(e.prs,Xi(a))||null}));return{prs:n,pr:n[Vi(n.map(a=>a.gh))]||null}}r(Pn,"cachedPRs");async function Pa(e,{now:t=new Date}={}){A(e);const i=await H(e),n=await y(en,{}),a=St(),s=new Map;for(const w of await q(e)){const f=await y(w.file,{}),p=Xe(f,i.reviewers);for(const m of p)s.has(m.name)||s.set(m.name,{name:m.name,slack_user:m.slack_user,dm:m.dm,items:[]});const h=oe(e,f);for(const m of f.items||[]){if(["merged","done","dropped"].includes(m.status))continue;const $=`${w.slug}/${m.id}`,{pr:b}=Pn(n,m,h),v=b?.gh;if(v?.state!=="OPEN"||v.isDraft||v.failing?.length||v.reviewDecision==="APPROVED")continue;const S=_t(f,m,$,a);for(const _ of p){const D=U(S,_.name),P=D?.ts?(t.getTime()-Number(D.ts)*1e3)/864e5:null;s.get(_.name).items.push({key:$,title:m.title,pr:b.number,url:b.url,sent_ts:D?.ts||null,...P>2?{days_old:Math.floor(P)}:{}})}}}const{date:o,morning:c}=fn(t),d=await y(Dn(e),{}),u=await un.waiting("slack");return{date:o,due:!u&&c&&d.last_date!==o,...u?{waiting:u}:{},reviewers:[...s.values()].filter(w=>w.items.length)}}r(Pa,"reviewDigest");async function go(e,t,{ts:i,channel:n,items:a},{now:s=new Date}={}){const o=On(i,n),c=[...new Set(j(a,"--items").split(",").map(w=>w.trim()))],d=await H(e);for(const w of c){const{wave:f}=await O(e,w);Et(f,d.reviewers,t)}const u=Dn(e);return Ge(u,async()=>{const w=await y(u,{});return await x(u,{last_date:fn(s).date,digests:[...w.digests||[],{reviewer:t,dm:o.channel,ts:o.ts,items:c,reactions:[]}]}),u})}r(go,"reviewDigestSent");function $o(e,t){const i=Rt(Array.isArray(t)?t:[t],"the reviewer file");return Nt(e,n=>[...n.map(a=>i.find(s=>Ce(s.name,a.name))||a),...i.filter(a=>!n.some(s=>Ce(a.name,s.name)))])}r($o,"addReviewers");function ko(e,t){return Nt(e,i=>{const n=t.filter(a=>!i.some(s=>Ce(s.name,a)));return n.length&&l(`this board has no reviewer ${n.map(a=>`"${a}"`).join(", ")}`),i.filter(a=>!t.some(s=>Ce(a.name,s)))})}r(ko,"removeReviewers");const Aa=r(()=>g.join(ht.homedir(),".claude","kickflip","settings.json"),"hubSettingsFile"),It=r(e=>{try{return e()}catch(t){throw t instanceof ia&&l(t.message),t}},"ruleCall"),Ct=r(async e=>wn(await y(g.join(e,"board.json"),{})),"readBoardRules");let An=Promise.resolve();function Lt(e,t){const i=An.then(async()=>{const n=g.join(A(e),"board.json"),a=await y(n,{}),{set:s,...o}=t(a);return await x(n,{...a,...s}),{file:n,...o}});return An=i.catch(()=>{}),i}r(Lt,"writeBoardJSON");const Rn=r((e,t)=>Lt(e,i=>{const n=It(()=>t(wn(i)));return{set:{rules:n.rules},...n}}),"writeBoardRules"),Nn=r(e=>typeof e=="string"&&/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})$/.test(e),"validGithubLogin"),En=r(e=>{try{return e?xt(e):null}catch{return null}},"storedTickets"),In=r(e=>Number.isInteger(e)&&e>=1&&e<=99,"validMaxImplementers"),be=r(e=>{const t=En(e?.tickets);return{auto_merge:e?.auto_merge===!0,auto_build:e?.auto_build===!0,auto_pull:e?.auto_pull===!0,max_implementers:In(e?.max_implementers)?e.max_implementers:_i,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:e?.prs!==!1,...t?{tickets:t}:{},...Nn(e?.github_login)?{github_login:e.github_login}:{}}},"settingsOf");async function Ra(e){return be(await y(g.join(A(e),"board.json"),{}))}r(Ra,"readBoardSettings");const yo=r((e,t)=>!!e?.github&&!e.local&&t.prs,"opensPRs");async function Le(e,t){Oe(t,["auto_merge","auto_build","auto_pull","max_implementers","auto_triage","auto_review","idle_notification","skip_draft","prs","tickets","github_login"],"the settings"),Object.keys(t).length||l("the settings name nothing to change"),t={...t};for(const[i,n]of Object.entries(t))if(i==="tickets"){try{t.tickets=xt(n)}catch(s){l(s.message)}t.tickets.source==="linear"&&!Ki()&&l(Wi);const a=t.tickets.source==="github"&&e?ge().find(s=>je(s.dir,e)):null;a&&!a.github&&l("GitHub issues need the board\u2019s repo on GitHub, and this board\u2019s repo isn\u2019t; pick internal or linear")}else i==="github_login"?n===""||n===null?t.github_login=void 0:Nn(n)||l("github_login must be a GitHub login"):i==="max_implementers"?In(n)||l("max_implementers must be a whole number from 1 to 99"):jt(n,i);if(t.prs===!1){const i=e?ge().find(n=>je(n.dir,e)):null;i?.github&&!i.local&&!(await ea(i.owner?.repo)).pushMain&&l("PRs off lands each card on main and pushes it, so turn on Push main after a land first")}return Lt(e,i=>{const n=be(i),a=be({...i,...t});return{set:t,settings:a,changed:Object.keys(t).filter(s=>JSON.stringify(n[s])!==JSON.stringify(a[s]))}})}r(Le,"saveBoardSettings");async function bo(){if(Hi().set)return[];const e=[];for(const t of ge()){if((await Ra(t.dir)).tickets?.source!=="linear")continue;const{settings:i}=await Le(t.dir,{tickets:{source:"internal"}});await Se(t,"settings",{tickets:i.tickets}),e.push(`/${t.route} fell back to internal tickets: Hub has no Linear key`)}return e}r(bo,"fallBackFromLinear");async function xo(e,t,i){const n=String(t).replace(/-/g,"_"),a=["auto_merge","auto_build","auto_pull","max_implementers","auto_triage","auto_review","idle_notification","skip_draft","prs","github_login","tickets"];if(a.includes(n)||l(`no board setting "${t}"; settings are ${a.map(c=>c.replace(/_/g,"-")).join(", ")}`),n==="tickets"){let c;try{c=JSON.parse(i)}catch{l('settings set tickets takes the source as JSON, such as {"source":"github"}')}const{file:d,settings:u}=await Le(e,{tickets:c});return{file:d,lines:Na({tickets:u.tickets})}}if(n==="github_login"){const{file:c,settings:d}=await Le(e,{github_login:i});return{file:c,lines:[`github-login ${d.github_login||"unset"}`]}}if(n==="max_implementers"){const{file:c,settings:d}=await Le(e,{max_implementers:/^\d+$/.test(i)?Number(i):i});return{file:c,lines:[`${t} ${d.max_implementers}`]}}["on","off"].includes(i)||l(`settings set ${t} takes on or off, not "${i}"`);const{file:s,settings:o}=await Le(e,{[n]:i==="on"});return{file:s,lines:[`${t} ${o[n]?"on":"off"}`]}}r(xo,"setBoardSetting");const Na=r(e=>Object.entries(e).map(([t,i])=>`setting ${t.replace(/_/g,"-")} ${t==="tickets"?JSON.stringify(i):t==="github_login"||t==="max_implementers"?i:i?"on":"off"}`),"settingsLines");async function Bt(e,t,i){const n=t?It(()=>i(Ye())):await Rn(e,i);return t&&It(()=>ca(n.rules)),{file:t?Aa():n.file,lines:[`id ${n.rule.id}`]}}r(Bt,"changeRules");async function Cn(e,t,i){const n=r(o=>o.map(c=>c.id),"ids");i||A(e);const[a,s]=i?[n(Ye()),e?n(await Ct(e)):[]]:[n(await Ct(e)),n(Ye())];a.includes(t)||l(`no ${i?"hub":"board"} rule "${t}"${s.includes(t)?`; it is a ${i?"board":"hub"} rule, so ${i?"drop":"pass"} --hub`:""}`)}r(Cn,"checkRuleId");async function vo(e){const t=r(i=>n=>`${i} ${n.id} ${n.by==="claude"?"claude":"owner"} ${n.text}`,"line");return{lines:[...Ye().map(t("hub")),...e?(await Ct(e)).map(t("board")):[]]}}r(vo,"listRules");function _o(e,{text:t,hub:i=!1,by:n}){return i||A(e),Bt(e,i,a=>aa(a,{text:t,by:n}))}r(_o,"addRuleTo");async function So(e,t,{text:i,hub:n=!1}){return await Cn(e,t,n),Bt(e,n,a=>sa(a,t,i))}r(So,"editRuleIn");async function jo(e,t,{hub:i=!1}){return await Cn(e,t,i),Bt(e,i,n=>oa(n,t))}r(jo,"removeRuleFrom");const Oo=r((e,t,i)=>Rn(e,n=>ra(n,t,i)),"saveBoardRules");async function Do(e,{id:t,title:i,summary:n}){A(e);const a=await y(C(e),{topics:[],items:[]}),s=a.topics||[];return s.some(o=>o.id===j(t,"the topic id"))&&l(`topic "${t}" already exists`),s.push({id:t.trim(),title:j(i,"--title"),...n===void 0?{}:{summary:j(n,"--summary")}}),await x(C(e),{...a,topics:s,items:a.items||[]}),C(e)}r(Do,"addTopic");const Ln=["quiet","info","notice","danger","success"];function Ea(e,t){if(e.diagram===void 0!=(e.practice===void 0)&&l(`${t} needs diagram and practice together`),e.diagram===void 0)return;const i=e.diagram;(!Array.isArray(i)||!i.length)&&l(`${t}.diagram must be a non-empty array of rows`),i.forEach((n,a)=>{(!Array.isArray(n)||!n.length||n.length>4)&&l(`${t}.diagram[${a}] must be a row of 1 to 4 boxes`),n.forEach((s,o)=>{const c=`${t}.diagram[${a}][${o}]`;Oe(s,["text","tone","to"],c),j(s.text,`${c}.text`),J(s.tone,d=>Ln.includes(d)?d:l(`${c}.tone takes ${Ln.join(", ")}`)),J(s.to,d=>Array.isArray(d)&&a+1<i.length&&d.every(u=>Number.isInteger(u)&&u>=0&&u<i[a+1].length)?d:l(`${c}.to must list boxes of the next row by index`))})}),(!Array.isArray(e.practice)||!e.practice.length)&&l(`${t}.practice must be a non-empty array of lines`),e.practice.forEach((n,a)=>j(n,`${t}.practice[${a}]`))}r(Ea,"checkDiagram");function Ia(e,t){(!Array.isArray(e)||!e.length)&&l(`${t}.options must be a non-empty array`);const i=new Set;e.forEach((n,a)=>{const s=`${t}.options[${a}]`;Oe(n,["id","label","recommended","detail","diagram","practice"],s),Ea(n,s),i.has(j(n.id,`${s}.id`))&&l(`${t} has two options with id "${n.id}"`),i.add(n.id),j(n.label,`${s}.label`).startsWith(`${n.id}. `)&&l(`${s}.label starts with "${n.id}. ", but the page adds the option letter itself`),J(n.recommended,o=>jt(o,`${s}.recommended`)),J(n.detail,o=>typeof o=="string"?o:l(`${s}.detail must be text`))}),e.filter(n=>n.recommended).length>1&&l(`${t} recommends more than one option`)}r(Ia,"checkOptions");function Ca(e,t,i){Oe(e,["option","card","answer"],i),t.some(n=>n.id===j(e.option,`${i}.option`))||l(`${i}.option names no option "${e.option}"`),j(e.card,`${i}.card`),j(e.answer,`${i}.answer`)}r(Ca,"checkSuggested");const Be=r(e=>g.join(e,"data","prototypes.json"),"prototypesFile"),qt=r((e,t,i)=>g.join(e,"public","prototypes",t,`${i}.js`),"takeFile");async function st(e){const t=e?(await y(Be(e),{})).prototypes:null;return Array.isArray(t)?t:[]}r(st,"readPrototypes");const La=r(e=>typeof e=="string"&&/^[a-z0-9-]+$/.test(e)?e:l(`a prototype topic uses only a-z, 0-9 and "-", not "${e}"`),"prototypeTopic");function Ba(e){const t=/^([^:]*):(.*)$/s.exec(e);(!t||!/^[A-Z]$/.test(t[1]))&&l(`--take takes KEY:"Label" with KEY one capital letter, not "${e}"`);const i=j(t[2],`--take ${t[1]}'s label`);return/^[A-Z]\.\s/.test(i)&&l(`--take ${t[1]}'s label starts with "${i.slice(0,3)}"; the take pill shows the label alone, so drop the letter`),{key:t[1],label:i}}r(Ba,"prototypeTake");const Ae=r(e=>/^prototype-(.+)\.html$/.exec(g.posix.basename(String(e||"").split(/[?#]/)[0]))?.[1],"pageTopic");async function Po(e,{topic:t,title:i,card:n,takes:a=[]}){A(e),La(t),j(i,"--title"),a.length||l('prototype add needs a --take KEY:"Label" for each take');const s=a.map(Ba),o=s.find((u,w)=>s.findIndex(f=>f.key===u.key)!==w);o&&l(`--take ${o.key} is given twice`),n!==void 0&&await O(e,n);const c=await st(e);c.some(u=>u.topic===t)&&l(`prototype ${t} is already recorded; run prototype rm ${t} first, or pick another topic`),await R.stat(g.join(e,"public",`prototype-${t}.html`)).then(()=>!0,()=>!1)&&l(`public/prototype-${t}.html is a hand-written page that questions may link; pick another topic`);const d={topic:t,title:i.trim(),...n===void 0?{}:{card:n},takes:s,at:new Date().toISOString()};return await x(Be(e),{prototypes:[...c,d]}),{file:Be(e),lines:[`page prototype-${t}.html`,...s.map(u=>`take ${u.key} ${qt(e,t,u.key)}`)]}}r(Po,"addPrototype");async function Ao(e){A(e);const t=await st(e);return{lines:t.length?t.map(i=>`${i.topic} \xB7 ${i.title} \xB7 ${i.takes.map(n=>`${n.key}: ${n.label}`).join(", ")}${i.card?` \xB7 ${i.card}`:""}`):["no prototypes recorded"]}}r(Ao,"listPrototypes");async function Ro(e,t){A(e);const i=await st(e);i.some(s=>s.topic===t)||l(`no prototype "${t}" is recorded`);const a=((await y(C(e),{items:[]})).items||[]).filter(s=>!s.resolved&&Ae(s.url)===t).map(s=>s.id);return a.length&&l(`prototype ${t} backs open question ${a.join(", ")}; resolve ${a.length===1?"it":"them"} first`),await x(Be(e),{prototypes:i.filter(s=>s.topic!==t)}),Be(e)}r(Ro,"removePrototype");async function qa(e,t,i){const n=t.url?.split(/[?#]/)[0];if(!n||!g.posix.basename(n).startsWith("prototype-"))return;const a=g.posix.basename(n),s=t.url.split("#")[0].split("?").slice(1).join("?"),o=`${i}.url`;new URLSearchParams(s).get("q")!==t.id&&l(`${o} must be ${a}?q=${t.id} so the pill can pick`);const c=Ae(n),d=(await st(e)).find(p=>p.topic===c);d||l(`${o} names ${a}, 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=d.takes.map(p=>p.key),w=t.options.map(p=>p.id),f=w.map(p=>u.indexOf(p));f.some((p,h)=>p<0||h>0&&p<f[h-1])&&l(`${i}.options ids ${w.join(", ")} must be a non-empty subset of ${a}'s takes, in take order: ${u.join(", ")}`);for(const p of u)await R.stat(qt(e,c,p)).then(h=>h.isFile(),()=>!1)||l(`${o} take ${p} has no file yet; write ${qt(e,c,p)}`)}r(qa,"checkPrototype");async function No(e,t){A(e);const i=Array.isArray(t)?t:[t];i.length||l("the question file is empty");const n=await y(C(e),{topics:[],items:[]}),a=n.items||[],s=new Set(a.map(h=>h.id)),o=new Set((n.topics||[]).map(h=>h.id));for(const[h,m]of i.entries()){const $=`question ${m?.id??h+1}`;Oe(m,["id","topic","source","question","context","url","urgent","options","round_of","reask_of","ask","suggested"],$),s.has(le(m.id,`${$}.id`))&&l(`question id "${m.id}" is already used`),s.add(m.id),j(m.topic,`${$}.topic`),m.topic.startsWith("item:ask:")?await qe(e,m.topic.slice(9),`${$}.topic`):m.topic.startsWith("item:")?await O(e,m.topic.slice(5)):m.topic.startsWith("lineup:")?await wt(e,m.topic.slice(7)):m.topic.startsWith("wave:")?await as(e,m.topic.slice(5)):o.has(m.topic)||l(`topic "${m.topic}" is not declared; add it with: topic add ${m.topic} --title <t>`),j(m.question,`${$}.question`);for(const b of["source","context"])J(m[b],v=>j(v,`${$}.${b}`));J(m.url,b=>mn(b,`${$}.url`)),J(m.urgent,b=>jt(b,`${$}.urgent`)),Ia(m.options,$),J(m.suggested,b=>Ca(b,m.options,`${$}.suggested`)),await qa(e,m,$),m.ask!==void 0&&await ps(e,m,$),J(m.round_of,b=>{const v=a.find(S=>S.id===b);v||l(`${$}.round_of names no question "${b}" in owner.json`),v.topic!==m.topic&&l(`${$}.round_of names ${b} on topic ${v.topic}; a round stays on its question's topic, ${m.topic}`),Ae(m.url)||l(`${$}.round_of needs a url on a recorded prototype, prototype-<topic>.html?q=${m.id}`)}),J(m.reask_of,b=>{const v=a.find(S=>S.id===b);v||l(`${$}.reask_of names no question "${b}" in owner.json`),v.topic!==m.topic&&l(`${$}.reask_of names ${b} on topic ${v.topic}; a re-ask stays on its question's topic, ${m.topic}`),v.resolved||l(`${$}.reask_of names ${b}, which is not resolved; only a resolved question is asked again`)})}const{answers:c,requests:d}=await ot(e),u=new Date().toISOString(),w=[],f=[];for(const h of i.filter(m=>m.round_of))h.round=bt(a.find(m=>m.id===h.round_of))+1,Re(n,[h.round_of],`Followed by prototype round ${h.round}`,u),f.push(h.round_of);for(const h of i.filter(m=>m.reask_of))Re(n,[h.reask_of],`Asked again as ${h.id}`,u),f.push(h.reask_of);for(const h of i){const m=Ae(h.url),$=a.filter(v=>v.topic===h.topic).map(v=>Ee(v,c,d)),b=h.topic.startsWith("item:")?Bn($):[];for(const v of $)b.includes(v.id)?(Re(n,[v.id],`Followed by ${h.id}`,u),f.push(v.id)):!v.resolved&&m&&Ae(v.url)===m&&(Re(n,[v.id],`Replaced by ${h.id}`,u),w.push(v.id))}const p={...n,topics:n.topics||[],items:[...a,...i.map(h=>({...h,asked_at:u}))]};return await x(C(e),p),{file:C(e),lines:[...w.map(h=>`replaced: ${h}`),...f.map(h=>`resolved: ${h}`)]}}r(No,"addQuestions");function Bn(e){return e.filter(t=>t.state==="answered").map(t=>t.id)}r(Bn,"answeredOnClaude");function Re(e,t,i,n=new Date().toISOString()){for(const a of e.items||[])t.includes(a.id)&&Object.assign(a,{resolved:i,resolved_at:n})}r(Re,"setResolved");async function Tt(e,t,i,n){return Re(t,i,n),await x(C(e),t),C(e)}r(Tt,"markResolved");async function Eo(e,t,i){A(e);const n=await y(C(e),{topics:[],items:[]}),a=(n.items||[]).find(w=>w.id===t);a||l(`no question "${t}" in owner.json`);const{answers:s,requests:o}=await ot(e),c=Ee(a,s,o);if(c.state==="resolved")return C(e);c.state==="requested"&&l(`${t} waits on the prototype the owner asked for; question add with round_of ${t} resolves it`);const d=j(i,"--note");Ae(a.url)&&Ta(n,a,s);const u=await Tt(e,n,[t],d);return await Un(e,a.topic),u}r(Eo,"resolveQuestion");async function Io(e,t){const i=t.filter(({choice:a,note:s})=>!a&&String(s||"").trim()).map(a=>a.id),n=i.length?await y(C(e),{topics:[],items:[]}):null;n?.items?.some(a=>i.includes(a.id))&&(Re(n,i,"Answered with a note"),await x(C(e),n))}r(Io,"resolveNoteAnswers");function Ta(e,t,i){const n=bt(t),a=e.items.filter(s=>s.topic===t.topic&&bt(s)===n).map(s=>Ee(s,i));Pi(a,n)||l(`${t.id} is in prototype round ${n}, which no pick has settled yet; a pick settles it`)}r(Ta,"roundSettled");async function ot(e){const t=await G(g.join(e,"data","events.jsonl"));return{answers:await Promise.all(t.filter(n=>n.kind==="owner-answer").map(async n=>{const a=await Promise.all(["html","json"].map(s=>R.stat(g.join(e,"data","replies",`${n.id}.${s}`)).then(o=>o.isFile(),()=>!1)));return{...n,reply:n.reply||a.some(Boolean)}})),requests:t.filter(n=>n.kind==="prototype-request")}}r(ot,"ownerEvents");async function qn(e,t){const i=await y(C(e),{topics:[],items:[]}),{answers:n,requests:a}=await ot(e),s=(i.items||[]).filter(o=>o.topic===t).map(o=>Ee(o,n,a));return{owner:i,asked:s}}r(qn,"topicQuestions");const ue=r((e,t)=>qn(e,`item:${t}`),"cardQuestions"),Ft=r((e,t,i)=>Tn(e,`item:${t}`,i),"resolveAnswered");async function Tn(e,t,i){if(!e)return[];const{owner:n,asked:a}=await qn(e,t),s=Bn(a);return s.length&&await Tt(e,n,s,i),await Un(e,t),s.map(o=>`resolved: ${o}`)}r(Tn,"resolveAnsweredOn");const Fn=r(async(e,t)=>!!e&&(await ue(e,t)).asked.some(i=>i.state==="open"),"hasOpenQuestion");function Mn(e,t,i){e.next=j(t,"--next"),i?e.next_on_questions=!0:delete e.next_on_questions}r(Mn,"setNext");async function Un(e,t){const i=t.startsWith("item:")&&!t.startsWith("item:ask:")?t.slice(5):null;if(!i)return;let n;try{n=await O(e,i)}catch(c){if(c instanceof ne)return;throw c}const{source:a,wave:s,item:o}=n;o.next_on_questions&&((await ue(e,i)).asked.some(c=>c.state!=="resolved")||(delete o.next,delete o.next_on_questions,await x(a.file,s)))}r(Un,"clearWaitedNext");async function Fa(e,t){const{source:i,wave:n,item:a}=await O(e,t);a.next===void 0&&a.next_on_questions===void 0||(delete a.next,delete a.next_on_questions,await x(i.file,n))}r(Fa,"clearNext");async function Wn(e,t,i,n){if(!e)return async()=>[];const{owner:a,asked:s}=await ue(e,t),o=s.filter(d=>d.state==="open").map(d=>d.id);o.length&&!n&&l(`${i}: ${t} has ${o.length===1?"an open question":"open questions"} ${o.join(", ")} with no answer yet; pass --force to close the card and resolve ${o.length===1?"it":"them"} too`);const c=s.filter(d=>d.state!=="resolved").map(d=>d.id);return async()=>(c.length&&await Tt(e,a,c,"Closed with the card"),c.map(d=>`resolved: ${d}`))}r(Wn,"closeQuestions");async function Co(e,t,i,n,a){await O(e,t),j(i,"--text"),J(n,s=>j(s,"--owner-step")),J(a,s=>Xn(s)),await Wn(A(e),t,"land",!1)}r(Co,"checkClose");async function Hn(e,t){const i=await y(C(e),{items:[]}),{answers:n,requests:a}=await ot(e);return ji((i.items||[]).map(s=>Ee(s,n,a)),t)}r(Hn,"unpickedPrototype");const Ma=r(e=>e.length>120?`${e.slice(0,119)}\u2026`:e,"clip"),Ua={ask:"text","ask-edited":"text","item-message":"text","owner-answer":"note"};async function Kn(e,t,i){const n=j(t,i).replace(/\s+/g," ");return(await G(g.join(e,"data","events.jsonl"))).map(s=>String(s.data?.[Ua[s.kind]]??"").replace(/\s+/g," ").toLowerCase()).some(s=>s.includes(n.toLowerCase()))||l(`${i} must quote the owner's words in an ask, card message or answer note on this board`),n}r(Kn,"ownerQuote");async function Lo(e,t,i){return A(e),i===void 0&&l(`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 Kn(e,i,"--asked")}"`}r(Lo,"askedGate");async function qe(e,t,i="--from-ask"){return le(t,i),(await G(g.join(A(e),"data","events.jsonl"))).some(a=>a.id===t&&a.kind==="ask")?t:l(`no ask "${t}" in this site's data/events.jsonl`)}r(qe,"checkAsk");const I=["done","merged","dropped"],Bo=r(async(e,t)=>I.includes((await O(e,t)).item.status),"isFinished"),Wa=["ready","grilling","prototyping"];function rt(e){return["building","fixing"].includes(e?.status)?(delete e.status,e.status_at=new Date().toISOString(),!0):!1}r(rt,"clearBuildingStatus");function Ha(e,t,i){const n=[].concat(t).map(o=>ln(o)||l(`--pr takes a PR number or owner/repo#<n>, not "${o}"`)),a=r((o,c)=>o.number===c.number&&(o.repo||i||null)===(c.repo||i||null),"same"),s=dn(e);for(const o of n)s.some(c=>a(c,o))||s.push(o);delete e.pr,e.prs=s}r(Ha,"addPRs");const V=r((e,t)=>String(t).includes("/")?String(t):`${e}/${t}`,"depKey");async function ct(e,t,i){const n=(i.deps||[]).map(s=>V(t,s)),a=await Promise.all(n.map(s=>O(e,s).then(({item:o})=>o,()=>null)));return n.filter((s,o)=>a[o]&&!I.includes(a[o].status))}r(ct,"unfinishedDeps");async function Ka(e,t){const i=[];for(const n of await q(e)){const a=await y(n.file,null);for(const s of Array.isArray(a?.items)?a.items:[])![void 0,"planned","waiting","held"].includes(s.status)||!(s.deps||[]).some(o=>V(n.slug,o)===t)||(await ct(e,n.slug,s)).length||i.push({key:`${n.slug}/${s.id}`,queued:!!s.queued_at})}return i}r(Ka,"unblockedBy");async function Jn(e,t,i,n){const a=new Set(n.match(/[\w-]+(?:\.[\w-]+)*(?:\/[\w-]+(?:\.[\w-]+)*)*/g)||[]),s=new Set((i.deps||[]).map(o=>V(L(t).wave,o)));for(const o of await q(e)){const c=await y(o.file,null);for(const d of c?.items||[]){const u=`${o.slug}/${d.id}`;if(u===t||s.has(u)||I.includes(d.status))continue;[d.id,Qe(c,d)].flatMap(f=>[f,`${o.slug}/${f}`]).some(f=>a.has(f))&&l(`--next names unfinished card ${u}; add it with --deps`)}}}r(Jn,"checkNextDeps");async function Ja(e,t,i,n){const a="a builder starts from it, so pass";n.size||l(`${t} has no size; ${a} --size small or large with --state ready`),n.plan||l(`${t} has no notes file; ${a} --notes-file <file.md> with --state ready`);const s=await R.readFile(await Te(i,n.plan),"utf8"),o=(await ue(e,t)).asked.filter(c=>c.answers.length&&!s.includes(c.id)).map(c=>c.id);o.length&&l(`${t}'s notes leave out the answered question${o.length===1?"":"s"} ${o.join(", ")}; record each answer in ${n.plan}, naming its id, before it is ready`)}r(Ja,"checkNotesComplete");async function Te(e,t){const i=r(a=>l(`a notes file is a .md file inside ${e}, named relative to it: "${t}" ${a}`),"bad");(typeof t!="string"||!t.trim())&&i("is empty"),(g.isAbsolute(t)||t.split(/[\\/]/).includes(".."))&&i("leaves the folder"),g.extname(t).toLowerCase()!==".md"&&i("is not a .md file");const n=await R.realpath(g.resolve(e,t)).catch(()=>i("does not exist"));return n.startsWith(await R.realpath(e)+g.sep)||i("leaves the folder"),n}r(Te,"planPath");async function qo(e,t){const{source:i,wave:n,item:a}=await O(e,t);if(a.plan)return{wave:n,item:a,markdown:await R.readFile(await Te(i.dir,a.plan),"utf8")};if(typeof a.notes=="string"&&a.notes.trim())return{wave:n,item:a,markdown:a.notes};l(`${t} has no notes`)}r(qo,"readNotes");function zn({install:e,installSha:t,installLabel:i,clearInstall:n}){if(e===void 0)return(t!==void 0||i!==void 0)&&l("--install-sha and --install-label go with --install <url>"),n?null:void 0;n&&l("pass --install or --clear-install, not both");let a;try{a=new URL(String(e).trim())}catch{a=null}(!a||!["https:","itms-services:"].includes(a.protocol))&&l(`--install takes an https:// or itms-services:// URL, not "${e}"`),a.protocol==="itms-services:"&&!(a.searchParams.get("action")==="download-manifest"&&/^https:\/\//.test(a.searchParams.get("url")||""))&&l("--install: an itms-services:// URL needs ?action=download-manifest&url=https://\u2026/manifest.plist");const s=t===void 0?void 0:/^[0-9a-f]{7,40}$/i.test(t)?t.toLowerCase():l(`--install-sha takes a commit sha of 7 to 40 hex digits, not "${t}"`);return{url:String(e).trim(),...i===void 0?{}:{label:j(i,"--install-label")},built_at:new Date().toISOString(),...s?{sha:s}:{}}}r(zn,"installOf");async function To(e,{install:t,installSha:i}){const n=zn({install:t,installSha:i});n||l("main set needs --install <url>");const a=g.join(A(e),"data","main.json");return await x(a,{install:n}),{file:a,lines:["main install set"]}}r(To,"setMainInstall");const Qn=r((e,t)=>e.length?`Merged PR${e.length>1?"s":""} ${Ie(e,t)}.`:"Merged.","mergedLine");function za(e,t,i,n,a,s){return n==="merged"?a??(i.status==="merged"?null:Qn(dn(i),s)):(a===void 0&&e&&l(`--status ${n} needs --text "<what was done or left>", which becomes ${t}'s last thread line`),a??null)}r(za,"closingLine");async function Gn(e,t,{ticket:i,status:n,clearStatus:a,next:s,clearNext:o,pr:c,pushed:d,mergeReady:u,ghSince:w,fromAsk:f,state:p,held:h,unheld:m,pickUpAt:$,notesFile:b,deps:v,parent:S,related:_,install:D,installSha:P,installLabel:E,clearInstall:F,title:z,size:X,model:M,force:B,text:Y,who:ve,ownerStep:ae,ownerDone:we,check:ce},Ue){n!==void 0&&a&&l("pass --status or --clear-status, not both"),p!==void 0&&!Wa.includes(p)&&l("--state takes ready, grilling or prototyping"),B&&!I.includes(n)&&l(`--force goes with --status ${I.join(", ")}`),f!==void 0&&I.includes(n)&&l("--from-ask opens a card; close it in another call"),Y!==void 0&&j(Y,"--text"),ae!==void 0&&j(ae,"--owner-step");const Q=ce===void 0||ce===""?ce:Xn(ce);Y!==void 0&&f===void 0&&!I.includes(n)&&l(`--text goes with --from-ask or --status ${I.join(", ")}`),f!==void 0&&Y===void 0&&l(`--from-ask needs --text "<first line>", the item's first thread line after the ask`),s!==void 0&&o&&l("pass --next or --clear-next, not both"),typeof s=="string"&&!s.trim()&&([s,o]=[void 0,!0]);const re=Qa({held:h,unheld:m,pickUpAt:$}),_e=zn({install:D,installSha:P,installLabel:E,clearInstall:F});[n,a,s,o,c,d,u,w,f,p,re,b,v,S,_,_e,z,X,M,i,ae,ce].every(N=>N===void 0||N===!1)&&l("nothing to set: pass --status, --clear-status, --next, --clear-next, --pr, --pushed, --gh-since, --from-ask, --state, --held, --unheld, --pick-up-at, --notes-file, --deps, --parent, --related, --install, --clear-install, --title, --size, --model, --ticket or --check");const T=f===void 0?void 0:await qe(e,f);T&&await Pt(e,T);const{source:ee,wave:pe,item:k}=await O(e,t);T&&k.from_ask&&k.from_ask!==T&&l(`${t} came from ask "${k.from_ask}", so ask "${T}" can't be its from-ask; to fold it in: item relate-ask ${T} ${t} --summary "<line>"`),T&&p===void 0&&!k.state&&l("--from-ask files a card, which reads New until it has a state: pass --state ready, grilling or prototyping");const pt=k.status,te=I.includes(k.status);ae!==void 0&&te&&l(`${t} is already ${k.status}, so its ticket closed; an owner step goes on the command that finishes the card: land --owner-step, or builder done before the merge`),ae!==void 0&&(k.owner_step=j(ae,"--owner-step")),(we||n==="dropped")&&delete k.owner_step,Q!==void 0&&!k.owner_step&&l(`--check goes with an owner step, which ${t} doesn't have: pass --owner-step "<the step>" with it on builder done or land`),Q&&(k.owner_check={check:Q,since:k.owner_check?.check===Q?k.owner_check.since:new Date().toISOString()}),(Q===""||!k.owner_step)&&delete k.owner_check;const Jt=await Promise.all((await ie(ee.dir,k.id)).map(N=>y(N,null))),$i=yt(k,Jt);if(b!==void 0&&(await Te(ee.dir,b),k.plan=g.normalize(b)),z!==void 0&&(k.title=j(z,"--title")),Zn(k,{size:X,model:M}),v!==void 0){const N=await Yn(e,L(t).wave,v);N.length?k.deps=N:delete k.deps}if(S!==void 0){const N=await ei(e,L(t).wave,t,S);N?k.parent=N:delete k.parent}const zt=_===void 0?null:await Xa(e,t,k,_);if(re!==void 0&&lt(k,re),n==="building"&&(k.held||k.status==="held")&&l(k.pick_up_at?`${t} is held until ${k.pick_up_at}, when the board resumes it; start it early only with item set ${t} --unheld`:`${t} is held; start it only once the owner resumes it, with item set ${t} --unheld`),n!==void 0&&(k.status=Yt.includes(n)?n:l(`--status takes ${Yt.join(", ")}`)),(Ga.includes(n)||c!==void 0||d!==void 0||u!==void 0)&&Za(k),n==="building"){const N=await ct(e,L(t).wave,k);N.length&&l(`${t} is blocked by ${N.join(", ")}; start it once ${N.length===1?"that is":"those are"} done or merged`)}(n==="building"||I.includes(n))&&delete k.queued_at;const We=n==="building"&&e?await Hn(e,t):null;We&&l(`${t} has no take picked: the owner's answer to ${We.id} picks none${We.note?` ("${Ma(We.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 ki=I.includes(n)?await Wn(e,t,`--status ${n}`,B):async()=>[],Qt=I.includes(n)?za(e,t,{...k,status:pt},n,Y,oe(e,pe)):null;if(a&&delete k.status,(n!==void 0||a)&&(k.status_at=new Date().toISOString()),s!==void 0&&(Mn(k,s,await Fn(e,t)),await Jn(e,t,k,k.next)),o&&(delete k.next,delete k.next_on_questions),n==="building"&&s===void 0&&k.next_on_questions&&(delete k.next,delete k.next_on_questions),(c!==void 0||d!==void 0||u!==void 0)&&!k.review_since&&(k.review_since=new Date().toISOString()),c!==void 0&&(Ha(k,c,oe(e,pe)),rt(k)),d!==void 0){ge().find(N=>je(N.dir,A(e)))?.remote||l("--pushed is for a board whose repo is a plain git remote; on GitHub, open a PR and pass --pr"),Ve(k)&&l(`${t} has a PR; its PR says when it merges`);try{Ji(d)}catch{l("--pushed takes the name of the branch you pushed")}k.pushed={branch:d,at:new Date().toISOString()},k.branch=d,rt(k)}if(u!==void 0&&(k.merge_ready={branch:u,at:new Date().toISOString()},k.branch=u,rt(k)),I.includes(n)&&delete k.merge_ready,w!==void 0&&((typeof w!="string"||!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$/.test(w)||Number.isNaN(Date.parse(w)))&&l("--gh-since takes an ISO-8601 UTC time such as 2026-10-23T11:00:00Z"),k.gh_since=w),T&&(k.from_ask=T),p==="ready"&&e){const N=(await ue(e,t)).asked.filter(he=>he.state==="open").map(he=>he.id);N.length&&l(`${t} has ${N.length===1?"an open question":"open questions"} ${N.join(", ")}; it is ready once the owner has answered ${N.length===1?"it":"them"}`),await Ja(e,t,ee.dir,k)}p!==void 0&&(k.state=p),_e&&(k.install=_e),_e===null&&delete k.install,!$i&&!["building","fixing"].includes(n)&&yt(k,Jt)&&l(`that leaves ${t} In Progress with nothing building and no Next; pass --next "<what happens next>"`),(i!==void 0||T&&!k.ticket&&!k.linear?.length)&&await Mt(e,t,pe,k,i,Ue,ee.dir),await x(ee.file,pe),zt&&await zt();const me=await ki();(b!==void 0||p==="ready"&&e)&&me.push(...await Ft(e,t,"Recorded in the card's notes")),n==="building"&&me.push(...await Ft(e,t,"Acted on: build started")),T&&me.push(...(await ke(e,t,{text:Y})).lines),Qt&&e&&me.push(...(await ke(e,t,{text:Qt,who:ve})).lines);const Gt=k.owner_step&&I.includes(n)?null:Ti({status:n,pr:c??d??u}),Zt=Gt&&await Fi(await ti(e),k,Gt,{...Ue,repo:oe(e,pe)});Zt&&me.push(Zt),(c!==void 0||d!==void 0||u!==void 0||ms.includes(n))&&await hs(ee.dir,k.id,I.includes(n));const mt=T?await ye(e):{};if(U(mt,T)!==void 0&&(delete mt[T],await x(de(e),{links:mt})),!I.includes(n)||te)return{file:ee.file,lines:me};const Vt=await Ka(e,t),yi=new Date().toISOString();for(const{key:N,queued:he}of Vt)await Z(K(e,N),{ts:yi,who:"claude",text:`Unblocked: ${await se(e,t)} is ${n}.`}),he||await Se({dir:e},"card-unblocked",{key:N});return{file:ee.file,lines:[...Vt.map(({key:N,queued:he})=>he?`queued build starts: ${N}`:`unblocked: ${N}`),...me]}}r(Gn,"changeItem");function Zn(e,{size:t,model:i}){for(const[n,a,s]of[["size",t,["small","large"]],["model",i,["opus","sonnet"]]])a!==void 0&&(a===""?delete e[n]:e[n]=s.includes(a)?a:l(`--${n} takes ${s.join(" or ")}, or "" to clear it`))}r(Zn,"setBuildChoice");function Qa({held:e,unheld:t,pickUpAt:i}){return[e,t,i!==void 0].filter(Boolean).length>1&&l("pass one of --held, --unheld and --pick-up-at"),i!==void 0?i===""?null:{until:Vn(i)}:e?{until:null}:t?null:void 0}r(Qa,"holdOf");function Vn(e){const t=typeof e=="string"&&Bi.test(e)?Date.parse(e):NaN;return Number.isNaN(t)&&l('--pick-up-at takes an ISO time such as 2026-11-04T09:00, the Mac\u2019s local time unless it names an offset, or "" to resume the card'),t<=Date.now()&&l(`--pick-up-at ${e} has passed; pass a later time, or --unheld to resume the card now`),new Date(t).toISOString()}r(Vn,"pickUpTime");const Ga=["building","fixing","checking",...I];function Za(e){delete e.held,delete e.pick_up_at}r(Za,"clearHold");function lt(e,t){t?e.held=!0:delete e.held,t?.until?e.pick_up_at=t.until:delete e.pick_up_at,!t&&e.status==="held"&&delete e.status,e.held_at=new Date().toISOString()}r(lt,"setHold");async function Fo(e,t,i,{announce:n=!0}={}){const{source:a,wave:s,item:o}=await O(e,t);if(n){const c=new Date(i).toLocaleString("en-US",{weekday:"short",month:"numeric",day:"numeric",hour:"numeric",minute:"2-digit"});await Z(K(e,t),{ts:new Date().toISOString(),who:"claude",text:`Resumed: its hold until ${c} ended.`}),!o.queued_at&&!(await ct(e,L(t).wave,o)).length&&await Se({dir:e},"card-unblocked",{key:t,until:i})}lt(o,null),await x(a.file,s)}r(Fo,"pickUp");async function Va(e,t,i){const n=String(i?.key||""),{wave:a,id:s}=L(n),{source:o,wave:c}=await De(e,a),d={text:"Marked done.",who:"love"},u=c.items.find(h=>h.id===s)||l(`wave "${a}" has no item "${s}"`);if(!(t==="card-done"&&!!u.owner_step)&&["merged","dropped"].includes(u.status))return null;if(t==="card-done")return fe(e,n,{status:u.status==="merged"?"merged":"done",force:!0,ownerDone:!0,...d});const f=i.hold?typeof i.until=="string"?new Date(i.until).toISOString():null:void 0;lt(u,i.hold?{until:f}:null),await x(o.file,c);const p=f&&new Date(f).toLocaleString("en-US",{weekday:"short",month:"numeric",day:"numeric",hour:"numeric",minute:"2-digit"});return ke(e,n,{text:i.hold?p?`Held until ${p}.`:"Held.":"Resumed.",who:"love"})}r(Va,"recordOwnerTap");function Xn(e){try{return na(ta(e))}catch(t){return l(t.message)}}r(Xn,"checkSpec");async function Mo(e,t,i,n){const{item:a}=await O(e,t);return!a.owner_step||a.owner_check?.check!==i?null:fe(e,t,{status:a.status==="merged"?"merged":"done",force:!0,ownerDone:!0,text:`Check passed: ${n}. Closed.`})}r(Mo,"passOwnerCheck");async function Uo(e,t,i,n){const{source:a,wave:s,item:o}=await O(e,t);return!o.owner_step||o.owner_check?.check!==i?!1:(o.owner_check.broken=n,await x(a.file,s),await ke(e,t,{text:`The check for "${o.owner_step}" can't run (${n}), so it stopped; Claude is asked to fix it. Done still closes the card.`}),await Se({dir:e},"owner-check-broken",{key:t,check:i,error:n}),!0)}r(Uo,"breakOwnerCheck");async function Yn(e,t,i){const n=[...new Set(String(i).split(",").map(a=>a.trim()).filter(Boolean))];for(const a of n)await O(e,V(t,a));return n}r(Yn,"depList");async function ei(e,t,i,n){if(!String(n).trim())return null;const a=V(t,String(n).trim());a===i&&l("--parent: a card can't be its own Parent");for(let s=a;s;){const o=s===a?await O(e,s):await O(e,s).catch(d=>{if(d instanceof ne)return null;throw d});if(!o)break;const{item:c}=o;c.parent&&V(L(s).wave,c.parent)===i&&l(`--parent: ${a} is a child of ${i}, so it can't be its Parent`),s=c.parent?V(L(s).wave,c.parent):null}return a}r(ei,"parentKey");async function Xa(e,t,i,n){const a=[...new Set(String(n).split(",").map(s=>s.trim()).filter(Boolean).map(s=>V(L(t).wave,s)))];a.includes(t)&&l("--related: a card can't be related to itself");for(const s of a)await O(e,s);return a.length?i.related=a:delete i.related,async()=>{for(const s of await q(e)){const o=await y(s.file,null);let c=!1;for(const d of Array.isArray(o?.items)?o.items:[]){const u=`${s.slug}/${d.id}`;u===t||a.includes(u)||!(d.related||[]).some(w=>V(s.slug,w)===t)||(d.related=d.related.filter(w=>V(s.slug,w)!==t),d.related.length||delete d.related,c=!0)}c&&await x(s.file,o)}}}r(Xa,"setRelated");const oe=r((e,t)=>e&&ge().find(i=>je(i.dir,e))?.github||t.repo,"boardRepoOf");async function Wo(e,t){const{wave:i,item:n}=await O(e,t);Ve(n)||l(`${t} has no PR`);const a=Ze(n,oe(e,i));a.length||l(`${t} has no repo`);const s=n.gh_since||"1970-01-01T00:00:00Z";try{const o=be(await H(e)).github_login||await Qi();return await Promise.all(a.map(async({repo:c,number:d})=>({repo:c,...on(await sn({repo:c,pr:d,since:s}),{pr:d,since:s,me:o})})))}catch(o){l(o.message)}}r(Wo,"prReport");async function Ho(e,t,{replyTo:i,body:n}){const a=i===void 0?"pr comment":"pr reply",s=ln(t)||l(`${a} takes a PR number or owner/repo#<n>`);i!==void 0&&!/^[1-9]\d*$/.test(i)&&l("pr reply takes the id of the review comment it answers");const o=j(n,"--body").trim();(o.startsWith(rn.trim())||o.includes(Zi))&&l(`${a} adds the ${rn.trim()} prefix and the claude-bridge marker itself; pass only your words`);const c=s.repo||oe(A(e),{})||l(`${a} needs a board on GitHub; this board has no repo there`);try{const d=await Gi({repo:c,pr:s.number,replyTo:i,words:o,login:be(await H(e)).github_login});return{lines:[`posted on PR ${s.repo?t:`#${t}`}: ${d}`]}}catch(d){l(d.message)}}r(Ho,"postPR");const ti=r(async e=>En((await H(e)).tickets),"boardSource");async function Ko(e,t,{afterApproval:i,confirmed:n,tapped:a}={}){A(e);const{wave:s,item:o}=await O(e,t);Ve(o)||l(`${t} has no PR`),I.includes(o.status)&&l(`${t} is ${o.status}`);const c=oe(e,s),d=Ze(o,c);d.length||l(`${t} has no repo`);const u=new Date().toISOString();let w;try{w=await Promise.all(d.map(_=>sn({repo:_.repo,pr:_.number,since:u})))}catch(_){l(_.message)}const f=w.map(({view:_})=>_);if(cn(f)){const _=d.filter((D,P)=>f[P].state==="MERGED");return fe(e,t,{status:"merged",text:`PR${_.length>1?"s":""} ${Ie(_,c)} ${_.length>1?"were":"was"} already merged.`})}const p=d.map((_,D)=>({..._,...w[D]})).filter(({view:_})=>_.state==="OPEN"),h=Xe(s,(await H(e)).reviewers||[]).length>0,m=[];let $=!1;for(const _ of p){const{view:D,reviews:P}=_,{failing:E,pending:F}=on(_,{pr:_.number,since:u,me:null}),z=Si({...D,checks:{state:E.length?"fail":F?"pending":"pass",failing:E,pending:F}},{needsApproval:h}),X=P.filter(B=>B.state==="APPROVED").sort((B,Y)=>String(B.submitted_at).localeCompare(String(Y.submitted_at))).at(-1)?.commit_id,M=!!(X&&D.headRefOid&&X!==D.headRefOid);$||=M,M&&i===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'),m.push(...d.length>1?z.map(B=>`${Ie([_],c)} ${B}`):z)}p.length||m.push(d.length>1?"every PR is closed":"PR is closed"),i!==void 0&&!$&&l("--after-approval: no commit came after the approval; drop it");const b=o.manual_steps?.length?n===void 0?null:await Kn(e,n,"--confirmed"):void 0;if(n!==void 0&&b===void 0&&l(`--confirmed: ${t} has no manual steps; drop it`),b===null&&m.push(`manual steps: merge only on the owner's word, with --confirmed "<their words>"`),m.length){const _=`Not merged: ${m.join("; ")}.`;a&&await ke(e,t,{text:_}),l(_)}const v=[];for(const _ of p){const D=await new Promise(P=>{Xt("gh",["pr","merge",String(_.number),"--repo",_.repo,"--squash"],{encoding:"utf8",timeout:12e4},(E,F,z)=>P(E?String(z||E.message).trim().split(`
12
+ `)[0]:null))});D&&l(`gh pr merge ${Ie([_],c)} failed: ${D}${v.length?` (merged ${Ie(v,c)} before it)`:""}`),v.push(_)}const S=[Qn(v,c),i!==void 0&&`After the approval: ${j(i,"--after-approval")}`,b&&`The owner's word on the manual steps: "${b}"`];return fe(e,t,{status:"merged",text:S.filter(Boolean).join(" ")})}r(Ko,"mergeCard");async function Jo(e,t){return(await O(e,t)).item.merge_ready||null}r(Jo,"heldMerge");async function zo(e,t){const{source:i,wave:n,item:a}=await O(e,t);return(!a.merge_ready||I.includes(a.status))&&l(`${t} isn't waiting for its Merge`),a.merge_ready.tapped=new Date().toISOString(),await x(i.file,n),a.merge_ready}r(zo,"tapMerge");async function Qo(e,t){const{source:i,item:n}=await O(e,t);return(await Promise.all((await ie(i.dir,n.id)).map(s=>y(s,null)))).filter(s=>s?.worktree?.path).sort((s,o)=>String(o.started).localeCompare(String(s.started)))[0]?.model}r(Qo,"builderModel");async function Mt(e,t,i,n,a,s,o){try{const c=await H(e),d=xt(c.tickets||{source:"internal"}),u=r((h,m)=>h.internal===!0?String(m.id).replace(/^S(\d+)$/,`${d.prefix}-$1`):null,"ownId");a===void 0&&d.source==="internal"&&vt(d,u(i,n))&&(a=u(i,n));let w=0;if(d.source==="internal")for(const h of await q(e)){const m=await y(h.file,{});for(const $ of m.items||[]){const b=[$.ticket,u(m,$)];if(w=Math.max(w,...b.map(v=>vt(d,v)||0)),a!==void 0&&`${h.slug}/${$.id}`!==t&&b.includes(a))throw Object.assign(new ne(`${a} is already the ticket of ${h.slug}/${$.id}`),{held:!0})}}const f=a===void 0&&d.source!=="internal"&&n.plan?await R.readFile(await Te(o,n.plan),"utf8"):n.notes||"",p=await qi(d,{ticket:a,title:n.title,body:f,repo:oe(e,i),next:w+1},s);n.ticket=p.ticket,p.created&&d.source!=="internal"?n.ticket_created=!0:delete n.ticket_created}catch(c){if(c instanceof ne)throw c;l(c.message)}}r(Mt,"assignTicket");const Ne=r((e,t)=>Ge(g.join(e||et(),"tickets"),t,{heartbeat:!0}),"ticketWrite"),fe=r((e,t,i,n)=>i.ticket!==void 0||i.fromAsk!==void 0?Ne(e,()=>Gn(e,t,i,n)):Gn(e,t,i,n),"setItem"),Go=r((e,t,i,n)=>Ne(e,()=>Ya(e,t,i,n)),"addItem");async function Ya(e,t,{title:i,notes:n,deps:a,notesFile:s,ticket:o,pickUpAt:c,parent:d,size:u,model:w},f){const{wave:p,id:h}=t.includes("/")?L(t):{wave:t};h!==void 0&&le(h,"the item id");const{source:m,wave:$}=await De(e,p);h!==void 0&&$.items.some(v=>v.id===h)&&l(`wave "${p}" already has an item "${h}"`);const b={id:h,title:j(i,"--title"),created:new Date().toISOString()};return d!==void 0&&(b.parent=await ei(e,p,null,d)||l("--parent takes a card, such as <wave>/<id>")),n!==void 0&&(b.notes=j(n,"--notes")),Zn(b,{size:u,model:w}),a!==void 0&&(b.deps=await Yn(e,p,a)),s!==void 0&&(await Te(m.dir,s),b.plan=g.normalize(s)),b.status=b.deps?.length?"waiting":"planned",c!==void 0&&lt(b,{until:Vn(c)}),await Mt(e,t,$,b,o,f,m.dir),h===void 0&&(b.id=Ui(b.ticket),$.items.some(v=>v.id===b.id)&&l(`wave "${p}" already has an item "${b.id}"; link ${b.ticket} with item add ${p}/<id> --ticket ${b.ticket}`)),$.items.push(b),await x(m.file,$),{file:m.file,key:`${p}/${b.id}`,lines:[]}}r(Ya,"createItem");const Zo=r((e,{dryRun:t=!1}={},i)=>Ne(A(e),()=>es(e,t,i)),"backfillTickets");async function es(e,t,i){const n=await ti(e)||l("this board has no ticket source yet; pick one in Board settings first"),a=new Set,s=[];for(const w of await q(e)){const f=await y(w.file,null);if(Array.isArray(f?.items)){s.push({entry:w,wave:f});for(const p of f.items)p.ticket&&a.add(p.ticket),f.internal===!0&&n.source==="internal"&&a.add(String(p.id).replace(/^S(\d+)$/,`${n.prefix}-$1`))}}const o=[],c={linked:0,created:0,failed:0},d=r((w,f)=>f.ticket&&!(n.source!=="internal"&&w.internal===!0&&f.ticket===f.id),"ticketed");for(const{entry:w,wave:f}of s)for(const p of f.items){if(d(f,p)||I.includes(p.status))continue;const h=`${w.slug}/${p.id}`,m=[...Mi(n,p.title),...(p.linear||[]).filter($=>vt(n,$))].find($=>n.source!=="internal"||!a.has($));if(t){c[m?"linked":"created"]++,o.push(`${h} would ${m?`link ${m}`:"get a new ticket"}`);continue}try{await Mt(e,h,f,p,m,i,w.dir),await x(w.file,f),a.add(p.ticket),c[m?"linked":"created"]++,o.push(`${h} ${m?"linked":"created"} ${p.ticket}`)}catch($){if(!($ instanceof ne))throw $;c.failed++,o.push(`${h} failed: ${$.message}`)}}const u=t?`would link ${c.linked}, create ${c.created}`:`linked ${c.linked}, created ${c.created}, failed ${c.failed}`;return{lines:[...o,`backfill${t?" (dry run)":""}: ${u}`]}}r(es,"backfill");const Vo=r(e=>Ne(e,async()=>{const t=[];for(const i of await q(e)){const n=await y(i.file,null);if(!Array.isArray(n?.items)||!Array.isArray(n.followups))continue;const a=n.followups.find(d=>n.items.some(u=>u.id===d.id));a&&l(`${i.slug}: follow-up ${a.id} has the id of a card; rename one, then restart the board`);const s=[];for(const{id:d,title:u,from:w,filed:f,done:p,...h}of n.followups){const m=p?e&&(await G(K(e,`${i.slug}/${d}`))).map($=>$.ts).filter(Boolean).sort().pop()||f:null;s.push({id:d,title:u,...f?{created:f}:{},...w?{parent:V(i.slug,w)}:{},status:p?"done":"planned",...m?{status_at:m}:{},...h})}const{followups:o,...c}=n;await x(i.file,{...c,items:[...n.items,...s]}),t.push(`${i.slug}: ${s.length} follow-ups moved to cards (${s.filter(d=>d.status==="done").length} done)`)}return t}),"migrateFollowups"),dt=r(e=>g.join(e,"data","done-archive.json"),"archiveFile"),Ut=r((e,t)=>Ge(g.join(e,"done-archive"),t,{heartbeat:!0}),"archiveWrite"),ut=r(async e=>(await y(dt(e),{cards:[]})).cards||[],"readArchive"),ft=r(e=>`${e.closed_at||""}|${e.key}`,"archiveRank"),ts=r((e,t)=>ft(e)<ft(t)?1:ft(e)>ft(t)?-1:0,"byClosed"),Wt=r(e=>g.join(e,"data","done-archive-count.json"),"archiveCountFile");async function Xo(e){const t=(await y(Wt(e),null))?.count;if(Number.isInteger(t))return t;const i=(await ut(e)).length;return await x(Wt(e),{count:i}),i}r(Xo,"archiveCount");async function Ht(e,t){t.length?await x(dt(e),{cards:t.sort(ts)}):await R.rm(dt(e),{force:!0}),await x(Wt(e),{count:t.length})}r(Ht,"writeArchive");const Yo=r((e,t)=>Ut(e,async()=>{const i=new Map(t.map(f=>[f.key,f])),n=new Date().toISOString(),a=[],s=[];for(const f of await q(e)){const p=await y(f.file,null);if(!Array.isArray(p?.items))continue;const h=p.items.filter(m=>i.has(`${f.slug}/${m.id}`)&&I.includes(m.status));if(h.length){for(const m of h)a.push({...i.get(`${f.slug}/${m.id}`),wave:f.slug,archived_at:n,item:m});s.push([f.file,{...p,items:p.items.filter(m=>!h.includes(m))}])}}if(!a.length)return[];const o=await y(C(e),{items:[]}),c=new Map(a.map(f=>[`item:${f.key}`,f]));for(const f of a)f.questions=(o.items||[]).filter(p=>p.topic===`item:${f.key}`&&p.resolved);const d=await ye(e);for(const f of a)f.asks=f.item.from_ask&&U(d,f.item.from_ask)===void 0?[f.item.from_ask]:[];const u=new Set(a.map(f=>f.key));await Ht(e,[...(await ut(e)).filter(f=>!u.has(f.key)),...a.map(({key:f,wave:p,archived_at:h,closed_at:m,item:$,questions:b,asks:v})=>({key:f,wave:p,archived_at:h,closed_at:m,item:$,questions:b,asks:v}))]),a.some(f=>f.asks.length)&&await x(de(e),{links:{...d,...Object.fromEntries(a.flatMap(f=>f.asks.map(p=>[p,f.key])))}});for(const[f,p]of s)await x(f,p);const w=(o.items||[]).filter(f=>!(c.has(f.topic)&&f.resolved));return w.length!==(o.items||[]).length&&await x(C(e),{...o,items:w}),[...u]}),"archiveCards");async function ns(e,t){return!e||!He(dt(e))?!1:Ut(e,async()=>{const i=await ut(e),n=i.find(f=>f.key===t);if(!n)return!1;const a=(await q(e)).find(f=>f.slug===n.wave),s=a&&await y(a.file,null);if(!Array.isArray(s?.items))return!1;s.items.some(f=>f.id===n.item.id)||await x(a.file,{...s,items:[...s.items,n.item]});const o=await y(C(e),{items:[]}),c=new Set((o.items||[]).map(f=>f.id)),d=(n.questions||[]).filter(f=>!c.has(f.id));d.length&&await x(C(e),{...o,items:[...o.items||[],...d]});const u=await ye(e),w=(n.asks||[]).filter(f=>U(u,f)===t);return w.length&&await x(de(e),{links:Object.fromEntries(Object.entries(u).filter(([f])=>!w.includes(f)))}),await Ht(e,i.filter(f=>f!==n)),!0})}r(ns,"restoreArchived");const ni=["push_tag","no_change"],ii=r(e=>Object.fromEntries(Object.entries(e).filter(([t])=>!ni.includes(t))),"stripQuestion"),ai=r(({summary:e,...t})=>t,"stripItem"),si=r(e=>ni.some(t=>t in e),"holdsDead"),er=r(e=>Ut(e,async()=>{for(const n of await q(e)){const a=await y(n.file,null);Array.isArray(a?.items)&&a.items.some(s=>"summary"in s)&&await x(n.file,{...a,items:a.items.map(ai)})}const t=await y(C(e),null);(t?.items||[]).some(si)&&await x(C(e),{...t,items:t.items.map(ii)});const i=await ut(e);i.some(n=>"card"in n||"summary"in n.item||(n.questions||[]).some(si))&&await Ht(e,i.map(({card:n,...a})=>({...a,...n?{closed_at:a.closed_at||n.sortAt}:{},item:ai(a.item),questions:(a.questions||[]).map(ii)})))}),"stripDeadFields"),oi=r(e=>`lineup-${e}.md`,"lineupNoteFile"),is=r(e=>typeof e=="string"&&/^[a-z0-9-]+$/.test(e)?e:l(`a wave's slug uses only a-z, 0-9 and "-", not "${e}"`),"lineupSlug");async function wt(e,t){for(const i of await q(e)){const n=await y(i.file,null),a=(n?.lineups||[]).find(s=>s.slug===t);if(a)return{source:i,wave:n,lineup:a}}return l(`this board has no wave "${t}"; lineup create makes one`)}r(wt,"findLineup");async function as(e,t){(await H(e)).items!=="waves"&&l(`topic wave:${t} is for a board over ~/.claude/waves; a lineup's triage uses lineup:<slug>`),await De(e,t)}r(as,"triagedWave");function Fe(e,t,i,n){return i.map(a=>{const{wave:s,id:o}=L(a);s!==e.slug&&l(`${a} is not in wave file "${e.slug}"; a wave's cards share one file`),t.items.some(d=>d.id===o)||l(`wave "${s}" has no item "${o}"`);const c=(t.lineups||[]).find(d=>d.slug!==n&&!d.finished_at&&$t(d).flat().includes(o));return c&&l(`${a} is already in the wave "${c.slug}"; lineup remove ${c.slug} ${a} first`),o})}r(Fe,"lineupCards");function ri(e){const t=[e??[]].flat().map(i=>String(i).split(",").map(n=>n.trim()).filter(Boolean));return(!t.length||t.some(i=>!i.length))&&l("--phase takes one phase's cards, as <wave>/<id>,<wave>/<id>, once per phase in build order"),t}r(ri,"phaseKeys");function ci(e,t,i,n){const a=new Set(i.map(s=>`${e.slug}/${s}`));for(const s of i){const o=t.items.find(u=>u.id===s),c=(o.deps||[]).filter(u=>!a.has(V(e.slug,u))),d=n.findIndex(u=>u.includes(s));d>0&&c.push(...n[d-1]),c.length?o.deps=c:delete o.deps}}r(ci,"chain");async function li(e,t,i,n,a){a!==void 0&&await tt(g.join(t.dir,oi(n.slug)),`${j(a,"the note").replace(/\n*$/,`
13
+ `)}`),await x(t.file,i);const{tickets:s}=be(await H(e));return{file:t.file,lines:[`order: ${di(i,n.phases,s)}`]}}r(li,"writeLineup");const di=r((e,t,i)=>t.map(n=>n.map(a=>Qe(e,e.items.find(s=>s.id===a)||{id:a},i)).join(", ")).join(" \u2192 "),"orderLine");async function tr(e,t,{title:i,goal:n,phases:a,note:s}){is(t);const o=ri(a);s===void 0&&l("lineup create needs the wave note, as --note <text> or --file <path>");const c=await q(e);c.some(p=>p.slug===t)&&l(`"${t}" is a wave file on this board; pick another slug`);for(const p of c)((await y(p.file,null))?.lineups||[]).some(h=>h.slug===t)&&l(`this board already has a wave "${t}"`);const d=c.find(p=>p.slug===L(o[0][0]).wave)||l(`this board has no wave "${L(o[0][0]).wave}"`),{wave:u}=await De(e,d.slug),w=o.map(p=>Fe(d,u,p,t));new Set(w.flat()).size!==w.flat().length&&l("--phase names a card twice");const f={slug:t,title:j(i,"--title"),goal:j(n,"--goal"),phases:w,created:new Date().toISOString()};return ci(d,u,w.flat(),w),u.lineups=[...u.lineups||[],f],li(e,d,u,f,s)}r(tr,"createLineup");async function nr(e,t,{add:i,after:n,remove:a,phases:s,title:o,goal:c,note:d}){[i,a,s,o,c,d].every(h=>h===void 0)&&l("nothing to change: pass --add, --remove, --phase, --title, --goal, --note or --file"),n!==void 0&&i===void 0&&l("--after goes with --add");const{source:u,wave:w,lineup:f}=await wt(e,t);f.finished_at&&l(`the wave "${t}" is finished`),f.phases=$t(f),delete f.items;const p=f.phases.flat();if(i!==void 0){const[h]=Fe(u,w,[i],t);p.includes(h)&&l(`${i} is already in the wave "${t}"`);const m=n===void 0?f.phases.length:f.phases.findIndex($=>$.includes(Fe(u,w,[n],t)[0]))+1;m===0&&l(`--after ${n} is not in the wave "${t}"`),f.phases.splice(m,0,[h])}if(a!==void 0){const[h]=Fe(u,w,[a],t);p.includes(h)||l(`${a} is not in the wave "${t}"`),p.length===1&&l(`${a} is the wave's last card; lineup finish ${t} ends the wave`),f.phases=f.phases.map(m=>m.filter($=>$!==h)).filter(m=>m.length)}if(s!==void 0){const h=ri(s).map($=>Fe(u,w,$,t)),m=h.flat();(m.length!==p.length||new Set(m).size!==m.length||m.some($=>!p.includes($)))&&l("--phase lists each of the wave's cards once"),f.phases=h}return o!==void 0&&(f.title=j(o,"--title")),c!==void 0&&(f.goal=j(c,"--goal")),ci(u,w,[...new Set([...p,...f.phases.flat()])],f.phases),li(e,u,w,f,d)}r(nr,"changeLineup");async function ir(e,t){const{source:i,wave:n,lineup:a}=await wt(e,t);return a.finished_at=new Date().toISOString(),await x(i.file,n),{file:i.file}}r(ir,"finishLineup");async function ar(e,t,i){const{source:n,wave:a,lineup:s}=await wt(e,t),o=await R.readFile(g.join(n.dir,oi(t)),"utf8").catch(()=>"");return{title:s.title,markdown:`**Goal** ${s.goal}
12
14
 
13
- **Order** ${d}
15
+ **Order** ${di(a,$t(s),i)}
14
16
 
15
- ${s}`}}r(Ho,"readLineupNotes");async function ie(e,t,i,n="main"){const{id:a}=T(t);/^[\w-]{1,40}$/.test(n)||c(`--agent takes a name of letters, digits, "_" and "-", not "${n}"`);const o=n==="main"?`${a}.json`:`${a}@${n}.json`;if(i)return h.join(h.resolve(i),"agents",o);const{source:s}=await P(e,t);return h.join(s.dir,"agents",o)}r(ie,"builderFile");const En=r((e,t)=>typeof e=="string"&&/^\d{4}-\d\d-\d\dT/.test(e)&&!Number.isNaN(Date.parse(e))?new Date(e).toISOString():c(`${t} takes an ISO time such as 2026-10-23T16:30:00-07:00`),"isoTime"),la=["reading","building","testing","checking","landing"],Tn=80,Ln="reading, building, testing, checking or landing";function Bn(e,t,i,n){e||c(`${n} needs --site, since the line goes to the item's thread`),t===void 0&&c(`${n} needs --phase ${Ln}`),la.includes(t)||c(`--phase takes ${Ln}, not "${t}"`);const a=_(i,n);return a.length>Tn&&c(`${n} is ${a.length} characters; the cap is ${Tn}. Say it shorter.`),{phase:t,detail:a}}r(Bn,"progressLine");async function vt(e,t,i="main",n,{phase:a,detail:o},s){const d=Tt(n),u=[i==="main"?"":(d?n.kind:ze(n))||n.kind||i,a].filter(Boolean).join(" "),f=u?`${u[0].toUpperCase()}${u.slice(1)}: ${o}`:o,m=H(e,t);(await U(m)).filter(p=>p.kind==="status").pop()?.text!==f&&await V(m,{ts:s,who:"claude",kind:"status",...a?{phase:a}:{},...d?{planner:!0}:{},text:f})}r(vt,"statusToThread");const ua={prototype:"sonnet",grill:"opus"};async function fa(e,t,{label:i,phase:n,progress:a,dir:o,agent:s="main",kind:d,model:l,eta:u,worktree:f,tapped:m,dispatch:p}){const w=Bt();if(w.state==="paused")throw new Q(Ct(w));n!==void 0&&a===void 0&&c('--phase goes with --progress "<detail>"');const $=z(a,G=>Bn(e,n,G,"--progress")),g=await ie(e,t,o,s),k=new Date().toISOString(),v=z(d,G=>/^[\w.-]{1,30}$/.test(G)?G:c("--kind takes a short word such as claude or codex")),S=Ge(v),j=l??(v==="opus"||v==="sonnet"?v:void 0),R=["build",...ga].includes(S),B=await y(g,null),N=(B?.tapped||B?.dispatched)&&!B.done?B:null,ae=R&&!o?(await P(e,t)).item:void 0,Y=B&&He(B).length?B:null,M=N&&S==="build"?{kind:Ge(N.kind),model:N.model,reason:N.tapped?"The owner's Build tap picked it.":"The session's dispatch picked it."}:R?It({card:ae??{}}):null;M&&S!=="build"&&S!==M.kind&&c(`--kind ${S}: ${M.kind} builds now. ${M.reason} Pass --kind ${M.kind}, or --kind build.`);const F=M?M.kind:S;l!==void 0&&!["opus","sonnet"].includes(l)&&c("--model takes opus or sonnet"),j!==void 0&&F==="codex"&&c("--model is for kind claude; codex needs none");const J=F==="claude"?ti():"auto";j!==void 0&&J!=="auto"&&j!==J&&c(`--model ${j}: the hub's Claude model is ${J==="opus"?"Opus":"Sonnet"}. Pass --model ${J}, or no --model.`);const $e=F==="claude"?j??M?.model??(N&&Ge(N.kind)==="claude"?N.model:void 0)??"opus":Tt({kind:F})?j??(N?.kind===F?N.model:void 0)??ua[F]:void 0,X={label:i===void 0?"Builder":_(i,"--label"),...F?{kind:F}:{},...$e?{model:$e}:{},started:k,...u===void 0?{}:{eta:En(u,"--eta")},...m?{tapped:!0}:{},...p?{dispatched:!0}:{},...Y?{calls:Y.calls,...Y.verified?{verified:Y.verified}:{}}:{}},ce=R&&!o&&![...L,"building","fixing"].includes(ae.status),de=ce?await Oe(e,t,{status:"building"}):{lines:[]};let E;try{E=f?await f():(N??Y)?.worktree??null}catch(G){throw ce&&await $a(e,t,ae),G}await x(g,E?{...X,worktree:E}:X),$&&await vt(e,t,s,X,$,k);const Z=await gt(e,t,"Acted on: builder started");return e&&Kn({kind:F})&&await kt(e,`item:${t}`,{build:!0}),{file:g,kind:F??null,model:$e??null,reason:M?.reason??null,worktree:E?.path??null,lines:[...S==="build"?[`kind: ${F}. ${M.reason}`]:[],...ze(X)?[`model: ${ze(X)}`]:[],...e?[`ref: ${await ne(e,t)}`]:[],...E?[`worktree: ${E.path}`]:[],...de.lines,...Z]}}r(fa,"startBuilder");async function pa(e,t,i){try{const{held:n,blockers:a}=await wa(e,t);if(n&&await ia(e,"card-hold",{key:t,hold:!1}),a.length)return await ma(e,t,a);try{const o=await fa(e,t,{kind:"build",worktree:i,tapped:!0});return{key:t,ref:await ne(e,t),kind:o.kind,...o.model?{model:o.model}:{},reason:o.reason,worktree:o.worktree}}catch(o){throw n&&await ha(e,t,n),o}}catch(n){if(!(n instanceof Q))throw n;return await V(H(e,t),{ts:new Date().toISOString(),who:"claude",kind:Nt,text:`Couldn't start implementing: ${n.message}`}),null}}r(pa,"startTappedBuild");async function wa(e,t){const i=Bt();i.state==="paused"&&c(Ct(i));const{item:n}=await P(e,t),a=n.held||n.status==="held"?{held:n.held,status:n.status,pick_up_at:n.pick_up_at,held_at:n.held_at}:null;a&&n.status&&n.status!=="held"&&c("it's held. Unhold it, then tap Implement."),await kn(e,t)&&c("no take is picked on its prototypes. Pick one, then tap Implement.");const o=await Promise.all((await je(e,T(t).wave,n)).map(s=>ne(e,s)));return{held:a,blockers:o}}r(wa,"tapRefusals");async function ma(e,t,i){const{source:n,wave:a,item:o}=await P(e,t);return o.queued_at||(o.queued_at=new Date().toISOString(),await x(n.file,a),await V(H(e,t),{ts:o.queued_at,who:"claude",text:`Implement queued: it starts once ${i.join(", ")} ${i.length===1?"is":"are"} done.`})),{key:t,ref:await ne(e,t),queued:i}}r(ma,"queueBuild");async function Ko(e){const t=[];for(const i of await C(e)){const n=await y(i.file,null);for(const a of Array.isArray(n?.items)?n.items:[])!a.queued_at||a.held||a.status==="held"||L.includes(a.status)||(await je(e,i.slug,a)).length||t.push(`${i.slug}/${a.id}`)}return t}r(Ko,"dueQueuedBuilds");async function Jo(e,t,i){let n;try{n=await pa(e,t,i)}catch(a){await V(H(e,t),{ts:new Date().toISOString(),who:"claude",kind:Nt,text:`Couldn't start implementing: ${a.message}`}),n=null}if(!n){const{source:a,wave:o,item:s}=await P(e,t);delete s.queued_at,await x(a.file,o)}return n}r(Jo,"startQueuedBuild");async function ha(e,t,i){const{source:n,wave:a,item:o}=await P(e,t);for(const s of Object.keys(i))i[s]===void 0?delete o[s]:o[s]=i[s];await x(n.file,a)}r(ha,"restoreHold");async function $a(e,t,i){const{source:n,wave:a,item:o}=await P(e,t);for(const s of["status","status_at"])i[s]===void 0?delete o[s]:o[s]=i[s];await x(n.file,a)}r($a,"restoreStatus");const ga=["codex","claude"];async function zo(e,t){const{item:i}=await P(e,t),{kind:n,model:a,reason:o}=It({card:i});return{lines:[`${[n,a].filter(Boolean).join(" ")}: ${o}`]}}r(zo,"pickBuilder");async function Go(e,t,{dir:i}={}){const{id:n}=T(t),a=h.dirname(await ie(e,t,i)),o=await he(h.dirname(a),n);return(await Promise.all(o.map(d=>y(d,null)))).filter(d=>d?.worktree?.path).sort((d,l)=>String(l.started).localeCompare(String(d.started)))[0]?.worktree??null}r(Go,"recordedWorktree");async function Qo(e,t,i,{phase:n,dir:a,agent:o="main",eta:s,clearEta:d}){s!==void 0&&d&&c("pass --eta or --clear-eta, not both");const l=Bn(e,n,i,"builder progress"),u=await ie(e,t,a,o),f=new Date().toISOString(),{progress:m,progress_at:p,done:w,...$}=await y(u,{label:"Builder",started:f});return s!==void 0&&($.eta=En(s,"--eta")),d&&delete $.eta,await x(u,$),await vt(e,t,o,$,l,f),u}r(Qo,"builderProgress");const He=r(e=>(e?.calls||[]).filter(t=>!e.verified||t.at>e.verified.at),"unverifiedCalls");async function Zo(e,t,i,{dir:n,agent:a="main"}){const o=_(i,"builder call");/\n/.test(o)&&c("builder call takes one line; record each call on its own");const s=await ie(e,t,n,a),d=await y(s,null);return(!d?.started||d.done)&&c(`builder call needs an open builder record on ${t}; run builder start first`),await x(s,{...d,calls:[...d.calls||[],{at:new Date().toISOString(),text:o}]}),s}r(Zo,"recordCall");async function Vo(e,t,{dir:i,agent:n="main"}){const a=await y(await ie(e,t,i,n),null),o=a?.calls||[];if(!o.length)return{lines:["no judgment calls recorded"]};const{verified:s}=a,d=He(a).length?"not verified yet":`verified ${s.at}${s.note?`: ${s.note}`:""}`;return{lines:[...o.map((l,u)=>`${u+1}. ${l.text}`),d]}}r(Vo,"listCalls");async function Yo(e,t,{dir:i,agent:n="main",note:a}){const o=await ie(e,t,i,n),s=await y(o,null);return He(s).length||c(`${t} has no unverified judgment calls${n==="main"?"":` from agent ${n}`}; builder calls ${t} lists them`),await x(o,{...s,verified:{at:new Date().toISOString(),...a===void 0?{}:{note:_(a,"--note")}}}),o}r(Yo,"verifyCalls");async function Xo(e,t,{dir:i}={}){const{id:n}=T(t),a=await he(h.dirname(h.dirname(await ie(e,t,i))),n),o=[];for(const s of a){if(!He(await y(s,null)).length)continue;const d=h.basename(s,".json").slice(String(n).length+1)||"main";o.push(d==="main"?"":` --agent ${d}`)}o.length&&c(`land: ${t} has judgment calls nobody verified yet; check them with ${o.map(s=>`builder calls ${t}${s}`).join(", ")}, then run ${o.map(s=>`builder verified ${t}${s}`).join(", ")}`)}r(Xo,"checkCallsVerified");const ka=["checking","done","merged","dropped"];async function he(e,t){const i=h.join(e,"agents");return(await D.readdir(i).catch(()=>[])).filter(n=>n===`${t}.json`||n.startsWith(`${t}@`)&&n.endsWith(".json")).map(n=>h.join(i,n))}r(he,"builderFiles");async function ya(e,t,i){const n=new Date().toISOString();for(const a of await he(e,t)){const o=await y(a,null);if(!o||o.done||o.kind==="install"&&!i)continue;const{eta:s,...d}=o;await x(a,{...d,done:n})}}r(ya,"closeBuilders");async function ba(e,t,{dir:i,agent:n,startedBetween:a,note:o,next:s,requireNext:d=!1}){const l=await ie(e,t,i,n),u=await y(l,null);if(!u||u.done)return l;if(a){const N=Date.parse(u.started);if(!(N>=a[0]&&N<=a[1]))return l}const{eta:f,...m}=u,p=new Date().toISOString(),w={...m,done:p,...o?{note:o}:{}},{id:$}=T(t),g=h.dirname(h.dirname(l)),k=await Promise.all((await he(g,$)).map(N=>N===l?w:y(N,null))),v=!k.some(N=>N?.started&&!N.done),S=i?{file:h.join(g,"wave.json")}:(await P(e,t)).source,j=await y(S.file,null),R=j?.items?.find(N=>N.id===$);s!==void 0&&($n(R||c(`${t} has no item to set --next on`),s,await hn(e,t)),e&&await bn(e,t,R,R.next));const B=v&&yt(R);return d&&R&&Qe(R,k)&&c(`builder done closes ${t}'s last open builder, which leaves it In Progress with no Next; pass --next "<what happens next>", or hand it back with item set ${t} --status checking or land`),await x(l,w),o&&await vt(e,t,n,u,{detail:o},p),(B||s!==void 0)&&await x(S.file,j),l}r(ba,"stopBuilder");async function xa(e){const t=[];for(const i of await C(e)){const n=await y(i.file,null);for(const a of n?.items||[])for(const o of await he(i.dir,a.id)){const s=await y(o,null);if(!s?.started||s.done)continue;const d=h.basename(o,".json");t.push({key:`${i.slug}/${a.id}`,agent:d.slice(String(a.id).length+1)||"main",label:s.label||"Builder",started:s.started})}}return t}r(xa,"openBoardBuilders");async function es(e){const t=await xa(e);for(const i of t)await ba(e,i.key,{agent:i.agent,note:"Board closed. Builder record stopped; work is kept for reopening."});return t}r(es,"closeBoardBuilders");export{Q as BoardError,zt as PUSH_LINE_MAX,st as UPLOAD_LIMIT,Qa as WORKING_KINDS,ro as ackHello,Io as addItem,_o as addPrototype,Do as addQuestions,mo as addReviewers,yo as addRuleTo,So as addTopic,Ee as appendThread,No as askedGate,qo as backfillTickets,W as boardConfig,re as boardRepoOf,Qo as builderProgress,ne as cardName,Uo as changeLineup,Xo as checkCallsVerified,Ro as checkClose,es as closeBoardBuilders,Mo as createLineup,Ko as dueQueuedBuilds,bo as editRuleIn,to as eventCard,co as finishHandshake,Wo as finishLineup,Qt as hiddenFile,C as itemSources,Pn as lineupNoteFile,Vo as listCalls,jo as listPrototypes,ko as listRules,ao as markAsk,Za as markWorking,Co as mergeCard,Fo as migrateFollowups,oo as moveAsk,xa as openBoardBuilders,T as parseKey,zo as pickBuilder,Lo as pickUp,Bo as prReport,Di as pushLine,Ri as pushUrl,be as readAskLinks,Le as readAskProgress,pt as readBoardRules,$o as readBoardSettings,nn as readHandshake,Ei as readHidden,y as readJSON,Ho as readLineupNotes,Eo as readNotes,Ce as readPrototypes,eo as readUpload,bi as readWorking,Zo as recordCall,ia as recordOwnerTap,vi as recordPush,Go as recordedWorktree,no as relateAsk,Oo as removePrototype,ho as removeReviewers,xo as removeRuleFrom,xi as repliesSincePush,Po as resolveNoteAnswers,Ao as resolveQuestion,qi as reviewDigest,wo as reviewDigestSent,po as reviewDue,fo as reviewReact,uo as reviewSent,vo as saveBoardRules,wt as saveBoardSettings,Xa as saveUpload,Va as sendPush,go as setBoardSetting,Ya as setHidden,Oe as setItem,To as setMainInstall,lo as setReviewers,Mi as settingsLines,pe as settingsOf,za as siteDir,ki as sitesDir,fa as startBuilder,Jo as startQueuedBuild,pa as startTappedBuild,ba as stopBuilder,ht as takeFile,H as threadFile,wn as topicQuestions,io as unfoldAsk,Yo as verifyCalls,Ne as wavesDir,Oi as withReplies,so as writeChecked,Ga as writeReply};
17
+ ${o}`}}r(ar,"readLineupNotes");async function W(e,t,i,n="main"){const{id:a}=L(t);/^[\w-]{1,40}$/.test(n)||l(`--agent takes a name of letters, digits, "_" and "-", not "${n}"`);const s=n==="main"?`${a}.json`:`${a}@${n}.json`;if(i)return g.join(g.resolve(i),"agents",s);const{source:o}=await O(e,t);return g.join(o.dir,"agents",s)}r(W,"builderFile");const ui=r((e,t)=>typeof e=="string"&&/^\d{4}-\d\d-\d\dT/.test(e)&&!Number.isNaN(Date.parse(e))?new Date(e).toISOString():l(`${t} takes an ISO time such as 2026-10-23T16:30:00-07:00`),"isoTime"),ss=["reading","building","testing","checking","landing"],fi=80,wi="reading, building, testing, checking or landing";function pi(e,t,i,n){e||l(`${n} needs --site, since the line goes to the item's thread`),t!==void 0&&!ss.includes(t)&&l(`--phase takes ${wi}, not "${t}"`);const a=j(i,n);return a.length>fi&&l(`${n} is ${a.length} characters; the cap is ${fi}. Say it shorter.`),{phase:t,detail:a}}r(pi,"progressLine");const mi=r((e,t,i)=>t?{detail:e.detail}:(e.phase===void 0&&l(`${i} needs --phase ${wi}`),e),"forAgent");async function Kt(e,t,i="main",n,{phase:a,detail:s},o){const c=ze(n),d=c||i==="main"?"":Je(n)||n.kind||i,u=c?Oi[n.kind]:[d,a].filter(Boolean).join(" "),w=u?`${u[0].toUpperCase()}${u.slice(1)}: ${s}`:s,f=K(e,t);(await G(f)).filter(p=>p.kind==="status").pop()?.text!==w&&await Z(f,{ts:o,who:"claude",kind:"status",...a?{phase:a}:{},...c?{planner:!0}:{},text:w})}r(Kt,"statusToThread");const os={prototype:"sonnet",grill:"opus"};async function hi(e,t,{label:i,phase:n,progress:a,dir:s,agent:o="main",kind:c,model:d,eta:u,worktree:w,ownWorktree:f,dispatch:p}){const h=tn();if(h.state==="paused")throw new ne(nn(h));n!==void 0&&a===void 0&&l('--phase goes with --progress "<detail>"');const m=J(a,k=>pi(e,n,k,"--progress")),$=await W(e,t,s,o),b=new Date().toISOString(),v=J(c,k=>/^[\w.-]{1,30}$/.test(k)?k:l("--kind takes a short word such as claude or codex")),S=kt(v),_=d??(v==="opus"||v==="sonnet"?v:void 0),D=["build",...fs].includes(S),P=await y($,null),E=r(k=>["tap","hub"].includes(k?.dispatched)&&!k.done,"tapOpen");if(p==="session"&&E(P))return{file:$,alreadyOpen:!0,lines:[]};o!=="main"&&E(await y(await W(e,t,s),null))&&l(`the Implement tap opened ${t}'s main builder record and no agent has taken it up; run builder start ${t} without --agent first`);const F=P?.dispatched&&!P.done?P:null,z=D&&!s?(await O(e,t)).item:void 0,X=P&&xe(P).length?P:null,M=F&&S==="build"?{kind:kt(F.kind),model:F.model,reason:{tap:"The owner's Build tap picked it.",hub:"The board's pull picked it."}[F.dispatched]??"The session's dispatch picked it."}:D?an({card:z??{}}):null;M&&S!=="build"&&S!==M.kind&&l(`--kind ${S}: ${M.kind} builds now. ${M.reason} Pass --kind ${M.kind}, or --kind build.`);const B=M?M.kind:S,Y=m&&mi(m,ze({kind:B}),"--progress");d!==void 0&&!["opus","sonnet"].includes(d)&&l("--model takes opus or sonnet"),_!==void 0&&B==="codex"&&l("--model is for kind claude; codex needs none");const ve=B==="claude"?Ii():"auto";_!==void 0&&ve!=="auto"&&_!==ve&&l(`--model ${_}: the hub's Claude model is ${ve==="opus"?"Opus":"Sonnet"}. Pass --model ${ve}, or no --model.`);const ae=B==="claude"?_??M?.model??(F&&kt(F.kind)==="claude"?F.model:void 0)??"opus":ze({kind:B})?_??(F?.kind===B?F.model:void 0)??os[B]:void 0,we={label:i===void 0?"Builder":j(i,"--label"),...B?{kind:B}:{},...ae?{model:ae}:{},started:b,...u===void 0?{}:{eta:ui(u,"--eta")},...p?{dispatched:p}:{},...X?{calls:X.calls,...X.verified?{verified:X.verified}:{}}:{}},ce=D&&!s&&![...I,"building","fixing"].includes(z.status),Ue=ce?await fe(e,t,{status:"building"}):{lines:[]};let Q,re=null;const _e=f&&D&&o==="main"&&P?.worktree?.path&&He(P.worktree.path)?P.worktree:null,T=(F??X)?.worktree??_e,ee=w??(D&&o==="main"&&!T?f:void 0);try{if(ee){const k=await ie(g.dirname(g.dirname($)),L(t).id),pt=(await Promise.all(k.filter(te=>te!==$).map(te=>y(te,null)))).filter(te=>te?.worktree?.path&&!te.done).map(te=>te.worktree.path);({remade:re,...Q}=await ee({busy:pt}))}else Q=T}catch(k){throw ce&&await us(e,t,z),k}await x($,Q?{...we,worktree:Q}:we),re&&e&&await ke(e,t,{text:re}),Y&&await Kt(e,t,o,we,Y,b);const pe=await Ft(e,t,"Acted on: builder started");return e&&D&&await Fa(e,t),{file:$,kind:B??null,model:ae??null,reason:M?.reason??null,worktree:Q?.path??null,lines:[...S==="build"?[`kind: ${B}. ${M.reason}`]:[],...Je(we)?[`model: ${Je(we)}`]:[],...e?[`ref: ${await se(e,t)}`]:[],...Q?[`worktree: ${Q.path}`]:[],...re?[re]:[],...Ue.lines,...pe]}}r(hi,"startBuilder");async function rs(e,t,i,n="tap"){try{const{held:a,blockers:s}=await cs(e,t);if(a&&await Va(e,"card-hold",{key:t,hold:!1}),s.length)return await ls(e,t,s);try{const o=await hi(e,t,{kind:"build",worktree:i,dispatch:n});return{key:t,ref:await se(e,t),kind:o.kind,...o.model?{model:o.model}:{},reason:o.reason,worktree:o.worktree}}catch(o){throw a&&await ds(e,t,a),o}}catch(a){if(!(a instanceof ne))throw a;return await Z(K(e,t),{ts:new Date().toISOString(),who:"claude",kind:gt,text:`Couldn't start implementing: ${a.message}`}),null}}r(rs,"startTappedBuild");async function cs(e,t){const i=tn();i.state==="paused"&&l(nn(i));const{item:n}=await O(e,t),a=n.held||n.status==="held"?{held:n.held,status:n.status,pick_up_at:n.pick_up_at,held_at:n.held_at}:null;a&&n.status&&n.status!=="held"&&l("it's held. Unhold it, then tap Implement."),await Hn(e,t)&&l("no take is picked on its prototypes, so it prototypes again. Pick a take from the next round, then tap Implement.");const s=await Promise.all((await ct(e,L(t).wave,n)).map(o=>se(e,o)));return{held:a,blockers:s}}r(cs,"tapRefusals");async function ls(e,t,i){const{source:n,wave:a,item:s}=await O(e,t);return s.queued_at||(s.queued_at=new Date().toISOString(),await x(n.file,a),await Z(K(e,t),{ts:s.queued_at,who:"claude",text:`Implement queued: it starts once ${i.join(", ")} ${i.length===1?"is":"are"} done.`})),{key:t,ref:await se(e,t),queued:i}}r(ls,"queueBuild");async function sr(e,t,i){let n;try{n=await rs(e,t,i)}catch(a){await Z(K(e,t),{ts:new Date().toISOString(),who:"claude",kind:gt,text:`Couldn't start implementing: ${a.message}`}),n=null}if(!n){const{source:a,wave:s,item:o}=await O(e,t);delete o.queued_at,await x(a.file,s)}return n}r(sr,"startQueuedBuild");async function or(e,t,i){const n=await W(e,t),a=await y(n,null),s=new Date().toISOString();a&&!a.done&&await x(n,{...a,done:s});const{source:o,wave:c,item:d}=await O(e,t);d.status==="building"&&(delete d.status,d.status_at=s),await x(o.file,c),await Z(K(e,t),{ts:s,who:"claude",kind:gt,text:`Couldn't start implementing: ${i}`})}r(or,"abandonLaunch");async function rr(e,t,i){const n=await W(e,t),a=await y(n,null);a&&!a.done&&await x(n,{...a,done:new Date().toISOString()}),await ke(e,t,{text:i})}r(rr,"abandonPlanner");async function cr(e,t,i){const n=await y(await W(e,t),null);if(n&&!n.done)return null;const a=await hi(e,t,{kind:i,dispatch:"hub"});return{key:t,kind:i,model:a.model}}r(cr,"startPlanner");async function ds(e,t,i){const{source:n,wave:a,item:s}=await O(e,t);for(const o of Object.keys(i))i[o]===void 0?delete s[o]:s[o]=i[o];await x(n.file,a)}r(ds,"restoreHold");async function us(e,t,i){const{source:n,wave:a,item:s}=await O(e,t);for(const o of["status","status_at"])i[o]===void 0?delete s[o]:s[o]=i[o];await x(n.file,a)}r(us,"restoreStatus");const fs=["codex","claude"];async function lr(e,t){const{item:i}=await O(e,t),{kind:n,model:a,reason:s}=an({card:i});return{lines:[`${[n,a].filter(Boolean).join(" ")}: ${s}`]}}r(lr,"pickBuilder");async function gi(e,t,{dir:i}={}){const{id:n}=L(t),a=g.dirname(await W(e,t,i)),s=await ie(g.dirname(a),n);return(await Promise.all(s.map(c=>y(c,null)))).filter(c=>c?.worktree?.path).sort((c,d)=>String(d.started).localeCompare(String(c.started)))[0]?.worktree??null}r(gi,"recordedWorktree");async function dr(e,t,i,{phase:n,dir:a,agent:s="main",eta:o,clearEta:c}){o!==void 0&&c&&l("pass --eta or --clear-eta, not both");const d=pi(e,n,i,"builder progress"),u=await W(e,t,a,s),w=await y(u,null);(!w?.started||w.done)&&l(`builder progress needs an open builder record on ${t}; run builder start first`);const f=mi(d,ze(w),"builder progress");return o!==void 0&&(w.eta=ui(o,"--eta")),c&&delete w.eta,(o!==void 0||c)&&await x(u,w),await Kt(e,t,s,w,f,new Date().toISOString()),u}r(dr,"builderProgress");const xe=r(e=>(e?.calls||[]).filter(t=>!e.verified||t.at>e.verified.at),"unverifiedCalls");async function ur(e,t,i,{dir:n,agent:a="main"}){const s=j(i,"builder call");/\n/.test(s)&&l("builder call takes one line; record each call on its own");const o=await W(e,t,n,a),c=await y(o,null);return(!c?.started||c.done)&&l(`builder call needs an open builder record on ${t}; run builder start first`),await x(o,{...c,calls:[...c.calls||[],{at:new Date().toISOString(),text:s}]}),o}r(ur,"recordCall");async function Me(e,t){const i=await G(K(e,t)),n=new Map(i.filter(a=>a.kind===Ke.answer).map(a=>[a.ask,a]));return i.filter(a=>a.kind===Ke.ask).map(a=>{const s=n.get(a.ask);return{id:a.ask,agent:a.agent||"main",text:a.text,at:a.ts,answer:s?{text:s.text,at:s.ts}:null,deferred:!!s?.deferred}})}r(Me,"builderAsks");const ws=r(e=>ge().find(t=>je(t.dir,e))??{dir:e},"boardTarget");async function fr(e,t,i,{agent:n="main"}){A(e);const a=j(i,"builder ask");/\n/.test(a)&&l("builder ask takes one line; ask each question on its own");const s=await y(await W(e,t,void 0,n),null);(!s?.started||s.done)&&l(`builder ask needs an open builder record on ${t}; run builder start first`);const o=`ask${(await Me(e,t)).length+1}`;return await Z(K(e,t),{ts:new Date().toISOString(),who:`${Je(s)||s.kind||"Claude"} builder`,kind:Ke.ask,ask:o,agent:n,text:a}),await Se(ws(e),"builder-ask",{key:t,ask:o,agent:n,text:a}),{id:o,lines:[]}}r(fr,"askOrchestrator");async function wr(e,t,i,n,{deferred:a=!1}={}){A(e);const s=j(n,"--text"),o=(await Me(e,t)).find(d=>d.id===i)||l(`no ask "${i}" on ${t}; builder asks ${t} lists them`);o.answer&&l(`${i} on ${t} is already ${o.deferred?"deferred":"answered"}`);const c=new Date().toISOString();if(await Z(K(e,t),{ts:c,who:"claude",kind:Ke.answer,ask:i,...a?{deferred:!0}:{},text:s}),a){const d=await W(e,t,void 0,o.agent),u=await y(d,null);u&&await x(d,{...u,calls:[...u.calls||[],{at:c,text:`Question: ${o.text} (deferred to the owner)`}]})}return{lines:[]}}r(wr,"answerBuilder");async function pr(e,t){A(e);const i=await Me(e,t);return i.length?{lines:i.flatMap(n=>[`${n.id}. ${n.text}`,` ${n.answer?`${n.deferred?"deferred":"answered"}: ${n.answer.text}`:"waiting on the orchestrator"}`])}:{lines:["no asks yet"]}}r(pr,"listAsks");async function ps(e,t,i){const n=t.topic.startsWith("item:")&&!t.topic.startsWith("item:ask:")?t.topic.slice(5):l(`${i}.ask goes on a card's question, topic item:<wave>/<id>`),a=(await Me(e,n)).find(s=>s.id===t.ask)||l(`${i}.ask names no ask "${t.ask}" on ${n}; builder asks ${n} lists them`);a.deferred||l(`${i}.ask names ${a.id}, which the orchestrator ${a.answer?"answered":"has not deferred"}; only a deferred ask goes to the owner`)}r(ps,"checkAskQuestion");async function mr(e,t,{dir:i,agent:n="main"}){const a=await y(await W(e,t,i,n),null),s=a?.calls||[];if(!s.length)return{lines:["no judgment calls recorded"]};const{verified:o}=a,c=xe(a).length?"not verified yet":`verified ${o.at}${o.note?`: ${o.note}`:""}`;return{lines:[...s.map((d,u)=>`${u+1}. ${d.text}`),c]}}r(mr,"listCalls");async function hr(e,t,{dir:i,agent:n="main",note:a}){const s=await W(e,t,i,n),o=await y(s,null);if(xe(o).length||l(`${t} has no unverified judgment calls${n==="main"?"":` from agent ${n}`}; builder calls ${t} lists them`),e){const c=new Set((await y(C(e),{items:[]})).items?.filter(u=>u.topic===`item:${t}`&&u.ask).map(u=>u.ask)),d=(await Me(e,t)).find(u=>u.deferred&&u.agent===n&&!c.has(u.id));d&&l(`${d.id} on ${t} was deferred to the owner; add its question with "ask": "${d.id}" first`)}return await x(s,{...o,verified:{at:new Date().toISOString(),...a===void 0?{}:{note:j(a,"--note")}}}),s}r(hr,"verifyCalls");async function gr(e,t){const{source:i,item:n}=await O(e,t),a=r((o,c)=>[(o.options||[]).find(d=>d.id===c.choice)?.label,c.note].filter(Boolean).join(": ")||"answered","said"),s=(await ue(e,t)).asked.filter(o=>o.ask&&o.answers.length).map(o=>({ask:o.ask,question:o.question,answer:a(o,o.answers.at(-1))}));return{key:t,ref:await se(e,t),title:n.title||t,notes:n.plan?g.join(i.dir,n.plan):null,worktree:(await gi(e,t))?.path??null,answers:s}}r(gr,"briefFacts");async function $r(e){const t=[];for(const i of await q(e)){const n=await y(i.file,null);for(const a of n?.items||[]){if(a.status!=="checking")continue;const s=(await Promise.all((await ie(i.dir,a.id)).map(u=>y(u,null)))).filter(Boolean),o=s.map(u=>u.verified?.at).filter(Boolean).sort().at(-1);if(!o||s.some(u=>xe(u).length))continue;const c=`${i.slug}/${a.id}`;if((await ue(e,c)).asked.some(u=>u.state==="open"))continue;const d=s.filter(u=>u.worktree?.path).sort((u,w)=>String(w.started).localeCompare(String(u.started)))[0];d&&He(d.worktree.path)&&t.push({key:c,verified:o,model:d.model})}}return t}r($r,"landable");async function kr(e,t){const{item:i}=await O(e,t);i.status!=="building"&&l(`${t} is ${i.status||"not started"}; only a card at building has a stopped lander to relaunch`),await fe(e,t,{status:"checking",next:"A lander relaunches to land the verified build"});const n=g.join(e,"data","landers.json"),a=await y(n,{});delete a[t],await R.writeFile(n+".tmp",JSON.stringify(a)+`
18
+ `),await R.rename(n+".tmp",n)}r(kr,"relaunchLander");async function yr(e,t,{dir:i}={}){const{id:n}=L(t),a=await ie(g.dirname(g.dirname(await W(e,t,i))),n),s=[];for(const o of a){if(!xe(await y(o,null)).length)continue;const c=g.basename(o,".json").slice(String(n).length+1)||"main";s.push(c==="main"?"":` --agent ${c}`)}s.length&&l(`land: ${t} has judgment calls nobody verified yet; check them with ${s.map(o=>`builder calls ${t}${o}`).join(", ")}, then run ${s.map(o=>`builder verified ${t}${o}`).join(", ")}`)}r(yr,"checkCallsVerified");async function br(e,t,{dir:i,agent:n="main",next:a}){const s=await y(await W(e,t,i,n),null),o=s&&!s.done?xe(s):[];if(!o.length)return null;a!==void 0&&l(`builder done sets ${t}'s Next itself while its record has judgment calls; run it without --next`);const c=o.some(u=>u.text.startsWith("Question:"))?"Answer the builder's questions":"Verify the builder's judgment calls",d=await fe(e,t,{status:"checking",next:c});return{lines:[`handed back: checking, Next "${c}"`,...d.lines]}}r(br,"handBackCalls");async function xr(e,t,{agent:i="main"}){if(i!=="main")return!1;const n=await W(e,t,void 0,i),a=await y(n,null);if(!a?.started||a.done||!a.worktree?.path)return!1;const{id:s}=L(t);for(const o of await ie(g.dirname(g.dirname(n)),s)){const c=o===n?null:await y(o,null);if(!c?.started||c.done||c.kind==="install")continue;const d=g.basename(o,".json").slice(String(s).length+1);l(`builder done would finish ${t} while agent ${d} is still open; run builder done ${t} --agent ${d} first`)}return!0}r(xr,"finishesCard");async function vr(e,t){const{source:i,item:n}=await O(e,t);if(n.status!=="checking"||(await Promise.all((await ie(i.dir,n.id)).map(o=>y(o,null)))).filter(Boolean).some(o=>xe(o).length||o.started&&!o.done&&o.kind!=="install"))return null;const s=await gi(e,t);return!s||!He(s.path)?null:{waits:(await ue(e,t)).asked.filter(o=>o.state==="open").map(o=>o.id)}}r(vr,"verifiedFinish");async function _r(e,t){const{item:i}=await O(e,t);if(i.status!=="done"||i.merged_at)return;const n=String(i.status_at||"");(await G(g.join(e,"data","events.jsonl"))).some(s=>s.kind==="item-message"&&s.data?.key===t&&String(s.ts)>n)&&l(`the owner reopened ${await se(e,t)} with a message; it closes on the owner's Done`)}r(_r,"checkNotReopened");const ms=["checking","done","merged","dropped"];async function ie(e,t){const i=g.join(e,"agents");return(await R.readdir(i).catch(()=>[])).filter(n=>n===`${t}.json`||n.startsWith(`${t}@`)&&n.endsWith(".json")).map(n=>g.join(i,n))}r(ie,"builderFiles");async function hs(e,t,i){const n=new Date().toISOString();for(const a of await ie(e,t)){const s=await y(a,null);if(!s||s.done||s.kind==="install"&&!i)continue;const{eta:o,...c}=s;await x(a,{...c,done:n})}}r(hs,"closeBuilders");async function gs(e,t,{dir:i,agent:n,startedBetween:a,note:s,next:o,requireNext:c=!1}){const d=await W(e,t,i,n),u=await y(d,null);if(!u||u.done)return d;if(a){const E=Date.parse(u.started);if(!(E>=a[0]&&E<=a[1]))return d}const{eta:w,...f}=u,p=new Date().toISOString(),h={...f,done:p,...s?{note:s}:{}},{id:m}=L(t),$=g.dirname(g.dirname(d)),b=await Promise.all((await ie($,m)).map(E=>E===d?h:y(E,null))),v=!b.some(E=>E?.started&&!E.done),S=i?{file:g.join($,"wave.json")}:(await O(e,t)).source,_=await y(S.file,null),D=_?.items?.find(E=>E.id===m);o!==void 0&&(Mn(D||l(`${t} has no item to set --next on`),o,await Fn(e,t)),e&&await Jn(e,t,D,D.next));const P=v&&rt(D);return c&&D&&yt(D,b)&&l(`builder done closes ${t}'s last open builder, which leaves it In Progress with no Next; pass --next "<what happens next>", or hand it back with item set ${t} --status checking or land`),await x(d,h),s&&await Kt(e,t,n,u,{detail:s},p),(P||o!==void 0)&&await x(S.file,_),d}r(gs,"stopBuilder");async function $s(e){const t=[];for(const i of await q(e)){const n=await y(i.file,null);for(const a of n?.items||[])for(const s of await ie(i.dir,a.id)){const o=await y(s,null);if(!o?.started||o.done)continue;const c=g.basename(s,".json");t.push({key:`${i.slug}/${a.id}`,agent:c.slice(String(a.id).length+1)||"main",label:o.label||"Builder",started:o.started})}}return t}r($s,"openBoardBuilders");async function Sr(e){const t=await $s(e);for(const i of t)await gs(e,i.key,{agent:i.agent,note:"Board closed. Builder record stopped; work is kept for reopening."});return t}r(Sr,"closeBoardBuilders");export{ne as BoardError,gn as PUSH_LINE_MAX,Dt as UPLOAD_LIMIT,Vs as WORKING_KINDS,or as abandonLaunch,rr as abandonPlanner,uo as ackHello,Go as addItem,Po as addPrototype,No as addQuestions,$o as addReviewers,_o as addRuleTo,Do as addTopic,wr as answerBuilder,ke as appendThread,Yo as archiveCards,Xo as archiveCount,dt as archiveFile,ft as archiveRank,fr as askOrchestrator,Lo as askedGate,Zo as backfillTickets,H as boardConfig,oe as boardRepoOf,Uo as breakOwnerCheck,gr as briefFacts,Qo as builderModel,dr as builderProgress,se as cardName,nr as changeLineup,yr as checkCallsVerified,Co as checkClose,_r as checkNotReopened,Sr as closeBoardBuilders,tr as createLineup,So as editRuleIn,io as eventCard,bo as fallBackFromLinear,fo as finishHandshake,ir as finishLineup,xr as finishesCard,br as handBackCalls,Jo as heldMerge,kn as hiddenFile,Bo as isFinished,q as itemSources,$r as landable,oi as lineupNoteFile,pr as listAsks,mr as listCalls,Ao as listPrototypes,vo as listRules,oo as markAsk,Xs as markWorking,Ko as mergeCard,Qn as mergedLine,Vo as migrateFollowups,ro as moveAsk,$s as openBoardBuilders,yo as opensPRs,L as parseKey,Mo as passOwnerCheck,lr as pickBuilder,Fo as pickUp,Ho as postPR,Wo as prReport,$a as pushLine,ba as pushUrl,ut as readArchive,ye as readAskLinks,it as readAskProgress,Ct as readBoardRules,Ra as readBoardSettings,jn as readHandshake,va as readHidden,y as readJSON,ar as readLineupNotes,qo as readNotes,st as readPrototypes,no as readUpload,ua as readWorking,ur as recordCall,Va as recordOwnerTap,wa as recordPush,lo as recordReview,gi as recordedWorktree,ao as relateAsk,kr as relaunchLander,Ro as removePrototype,ko as removeReviewers,jo as removeRuleFrom,fa as repliesSincePush,Io as resolveNoteAnswers,Eo as resolveQuestion,Pa as reviewDigest,go as reviewDigestSent,ho as reviewDue,mo as reviewReact,po as reviewSent,Oo as saveBoardRules,Le as saveBoardSettings,to as saveUpload,Ys as sendPush,xo as setBoardSetting,eo as setHidden,fe as setItem,To as setMainInstall,wo as setReviewers,Na as settingsLines,be as settingsOf,Gs as siteDir,la as sitesDir,hi as startBuilder,cr as startPlanner,sr as startQueuedBuild,rs as startTappedBuild,gs as stopBuilder,er as stripDeadFields,qt as takeFile,zo as tapMerge,K as threadFile,qn as topicQuestions,so as unfoldAsk,vr as verifiedFinish,hr as verifyCalls,et as wavesDir,ga as withReplies,co as writeChecked,Zs as writeReply};
package/board/tickets.mjs CHANGED
@@ -1,3 +1,3 @@
1
- var O=Object.defineProperty;var r=(e,t)=>O(e,"name",{value:t,configurable:!0});import{runRepo as b,validateGithub as S}from"../hub/repos.mjs";import{savedClient as k}from"../hub/linear.mjs";const i=r(e=>{throw Object.assign(new Error(e),{status:400})},"refuse");function N(e){(!e||typeof e!="object"||Array.isArray(e))&&i("Tickets must name a source.");const t={internal:["source","prefix"],github:["source","account"],linear:["source","workspace","team","project"]};if(Object.hasOwn(t,e.source)||i("Ticket source must be internal, github or linear."),Object.keys(e).some(n=>!t[e.source].includes(n))&&i("Unknown ticket source field."),e.source==="internal"){const n=e.prefix===void 0||e.prefix===""?"INT":e.prefix;return(typeof n!="string"||!/^[A-Z]{2,6}$/.test(n))&&i("Prefix must be 2\u20136 uppercase letters."),{source:"internal",prefix:n}}return e.source==="github"?e.account===void 0||e.account===""?{source:"github"}:((typeof e.account!="string"||!/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})$/.test(e.account))&&i("The gh account must be a GitHub login."),{source:"github",account:e.account}):((typeof e.workspace!="string"||!/^[a-z\d][a-z\d-]*$/i.test(e.workspace))&&i("Linear needs a workspace."),(typeof e.team!="string"||!/^[A-Z][A-Z0-9]*$/.test(e.team))&&i("Linear needs an uppercase team key."),(typeof e.project!="string"||!e.project.trim())&&i("Linear needs a project."),{source:"linear",workspace:e.workspace,team:e.team,project:e.project.trim()})}r(N,"ticketSource");const w=r(e=>{const t=e?Number(e[1]):null;return Number.isSafeInteger(t)?t:null},"numberOf"),y=r(e=>w(/^#?([1-9]\d*)$/.exec(String(e??""))),"issueNumber"),x=r(e=>e.source==="internal"?e.prefix||"INT":e.source==="linear"?e.team:null,"keyOf");function g(e,t){if(!e)return null;const n=x(e),s=String(t??"");return n?s.startsWith(`${n}-`)?w(/^([1-9]\d*)$/.exec(s.slice(n.length+1))):null:w(/^#([1-9]\d*)$/.exec(s))}r(g,"ticketIn");function H(e,t,{repo:n,key:s}={}){const a=g(e,t);if(!a)return null;if(e.source==="internal")return{id:`${x(e)}-${a}`,url:`#item=${encodeURIComponent(s)}`,source:"internal"};if(e.source==="github")return n?{id:`#${a}`,url:`https://github.com/${n}/issues/${a}`,source:"github"}:null;const l=`${e.team}-${a}`;return{id:l,url:`https://linear.app/${e.workspace}/issue/${l}`,source:"linear"}}r(H,"ticketBadge");async function j(e,t){if(!e.account)return t;const n=await t("gh",["auth","token","-u",e.account]);(n.status!==0||!n.stdout?.trim())&&i(`gh has no ${e.account} account; run gh auth login`);const s={...process.env,GH_TOKEN:n.stdout.trim()};return(a,l)=>t(a,l,{env:s})}r(j,"issueRunner");const T=r(async e=>{try{return await e()}catch(t){i(t.message)}},"linearCall");async function E(e,{ticket:t,title:n,body:s="",repo:a,next:l},{run:u=b,linearFetch:$}={}){if(e.source==="internal")return t!==void 0&&!g(e,t)&&i(`Ticket must match ${e.prefix}-<number>.`),{ticket:t??`${e.prefix}-${l}`,created:t===void 0};if(e.source==="linear"){t!==void 0&&!g(e,t)&&i(`Ticket must match ${e.team}-<number>.`);const c=k({fetch:$});if(!c)return t===void 0?{ticket:null,created:!1,mcp:!0}:{ticket:t,created:!1};if(t===void 0)return{ticket:(await T(()=>c.createIssue({team:e.team,project:e.project,title:n,description:s}))).identifier,created:!0};const h=await T(()=>c.issue(t));return h||i(`Linear has no issue ${t}.`),h.team!==e.team&&i(`${t} is in Linear's ${h.team} team, not ${e.team}.`),{ticket:h.identifier,created:!1}}S(a);const o=t===void 0?null:y(t);t!==void 0&&!o&&i("GitHub ticket must be an issue number such as #41.");const p=o?["issue","view",String(o),"--repo",a,"--json","number,url"]:["issue","create","--repo",a,"--title",n,"--body",s],m=await(await j(e,u))("gh",p);m.status!==0&&i((m.stderr||"GitHub refused the issue.").trim().split(`
2
- `)[0]);let f;if(o){let c;try{c=JSON.parse(m.stdout)}catch{i("GitHub returned an invalid issue.")}c.number!==o&&i("GitHub returned a different issue."),f=c.url}else f=m.stdout?.trim();const d=/^https:\/\/github\.com\/([^/]+\/[^/]+)\/issues\/([1-9]\d*)$/.exec(f||"");return(!d||d[1].toLowerCase()!==a.toLowerCase()||o&&Number(d[2])!==o||!y(d[2]))&&i("Ticket must be an issue in the board\u2019s repo."),{ticket:`#${d[2]}`,created:!o}}r(E,"resolveTicket");const Z=r(e=>e.startsWith("#")?`GH-${e.slice(1)}`:e,"cardIdOf");function R(e,t){const n=e.source==="github"?String(t??"").match(/(?<![\w#])#[1-9]\d*\b/g):String(t??"").match(/\b[A-Z][A-Z0-9]*-[1-9]\d*\b/g);return[...new Set((n||[]).filter(s=>g(e,s)))]}r(R,"titleTickets");function P({status:e,pr:t}){return["done","merged"].includes(e)?"done":["building","fixing"].includes(e)?"started":t!==void 0&&e===void 0?"review":null}r(P,"ticketTarget");const L={started:"In Progress",review:"In Review",done:"Done"};async function _(e,t,n,{repo:s,run:a=b,linearFetch:l}={}){const u=t.ticket;if(!e||!n||!u||!g(e,u)||e.source==="internal"||e.source==="github"&&n!=="done")return null;if(e.source==="github"&&!s)return`ticket ${u}: not closed, the board has no GitHub repo`;const $=r(o=>`ticket ${u}: could not move to ${L[n]} (${String(o.message||o).split(`
3
- `)[0]})`,"why");try{if(e.source==="linear"){const f=k({fetch:l});if(!f)return`ticket ${u}: move to ${L[n]} through the Linear MCP${t.ticket_created?"":" if it's assigned to you"}`;if(!t.ticket_created){const c=await f.issue(u);if(!c)return`ticket ${u}: not moved, Linear has no such issue`;if(c.assignee!==f.saved.viewer?.id)return`ticket ${u}: left as it is, not assigned to you`}const d=await f.moveIssue(u,n);return d?`ticket ${u}: moved to ${d}`:null}const o=u.slice(1),p=await j(e,a);if(!t.ticket_created){const f=await p("gh",["issue","view",o,"--repo",s,"--json","state,assignees"]);if(f.status!==0)throw new Error(f.stderr||"gh issue view failed");const d=await p("gh",["api","user","--jq",".login"]);if(d.status!==0)throw new Error(d.stderr||"gh api user failed");const c=JSON.parse(f.stdout);if(c.state!=="OPEN")return null;if(!(c.assignees||[]).some(h=>h.login?.toLowerCase()===d.stdout.trim().toLowerCase()))return`ticket ${u}: left as it is, not assigned to you`}const m=await p("gh",["issue","close",o,"--repo",s]);if(m.status!==0)throw new Error(m.stderr||"gh issue close failed");return`ticket ${u}: closed`}catch(o){return $(o)}}r(_,"moveTicket");const z=r((e,t,n)=>`ticket: create the Linear issue "${t}" in team ${e.team}, project ${e.project}, through your Linear MCP, then run ${n} --ticket <id>`,"mcpCreateLine");export{Z as cardIdOf,z as mcpCreateLine,_ as moveTicket,E as resolveTicket,H as ticketBadge,g as ticketIn,N as ticketSource,P as ticketTarget,R as titleTickets};
1
+ var L=Object.defineProperty;var o=(e,t)=>L(e,"name",{value:t,configurable:!0});import{runRepo as $,validateGithub as O}from"../hub/repos.mjs";import{savedClient as k}from"../hub/linear.mjs";const i=o(e=>{throw Object.assign(new Error(e),{status:400})},"refuse");function N(e){(!e||typeof e!="object"||Array.isArray(e))&&i("Tickets must name a source.");const t={internal:["source","prefix"],github:["source","account"],linear:["source","workspace","team","project"]};if(Object.hasOwn(t,e.source)||i("Ticket source must be internal, github or linear."),Object.keys(e).some(n=>!t[e.source].includes(n))&&i("Unknown ticket source field."),e.source==="internal"){const n=e.prefix===void 0||e.prefix===""?"INT":e.prefix;return(typeof n!="string"||!/^[A-Z]{2,6}$/.test(n))&&i("Prefix must be 2\u20136 uppercase letters."),{source:"internal",prefix:n}}return e.source==="github"?e.account===void 0||e.account===""?{source:"github"}:((typeof e.account!="string"||!/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})$/.test(e.account))&&i("The gh account must be a GitHub login."),{source:"github",account:e.account}):((typeof e.workspace!="string"||!/^[a-z\d][a-z\d-]*$/i.test(e.workspace))&&i("Linear needs a workspace."),(typeof e.team!="string"||!/^[A-Z][A-Z0-9]*$/.test(e.team))&&i("Linear needs an uppercase team key."),(typeof e.project!="string"||!e.project.trim())&&i("Linear needs a project."),{source:"linear",workspace:e.workspace,team:e.team,project:e.project.trim()})}o(N,"ticketSource");const w=o(e=>{const t=e?Number(e[1]):null;return Number.isSafeInteger(t)?t:null},"numberOf"),y=o(e=>w(/^#?([1-9]\d*)$/.exec(String(e??""))),"issueNumber"),x=o(e=>e.source==="internal"?e.prefix||"INT":e.source==="linear"?e.team:null,"keyOf");function g(e,t){if(!e)return null;const n=x(e),r=String(t??"");return n?r.startsWith(`${n}-`)?w(/^([1-9]\d*)$/.exec(r.slice(n.length+1))):null:w(/^#([1-9]\d*)$/.exec(r))}o(g,"ticketIn");function C(e,t,{repo:n,key:r}={}){const a=g(e,t);if(!a)return null;if(e.source==="internal")return{id:`${x(e)}-${a}`,url:`#item=${encodeURIComponent(r)}`,source:"internal"};if(e.source==="github")return n?{id:`#${a}`,url:`https://github.com/${n}/issues/${a}`,source:"github"}:null;const l=`${e.team}-${a}`;return{id:l,url:`https://linear.app/${e.workspace}/issue/${l}`,source:"linear"}}o(C,"ticketBadge");async function j(e,t){if(!e.account)return t;const n=await t("gh",["auth","token","-u",e.account]);(n.status!==0||!n.stdout?.trim())&&i(`gh has no ${e.account} account; run gh auth login`);const r={...process.env,GH_TOKEN:n.stdout.trim()};return(a,l)=>t(a,l,{env:r})}o(j,"issueRunner");const T=o(async e=>{try{return await e()}catch(t){i(t.message)}},"linearCall");async function E(e,{ticket:t,title:n,body:r="",repo:a,next:l},{run:u=$,linearFetch:b}={}){if(e.source==="internal")return t!==void 0&&!g(e,t)&&i(`Ticket must match ${e.prefix}-<number>.`),{ticket:t??`${e.prefix}-${l}`,created:t===void 0};if(e.source==="linear"){t!==void 0&&!g(e,t)&&i(`Ticket must match ${e.team}-<number>.`);const c=k({fetch:b});if(c||i("Hub has no Linear key, so this board can\u2019t create Linear tickets; add it in Hub settings \u203A Linear, or pick another ticket source."),t===void 0)return{ticket:(await T(()=>c.createIssue({team:e.team,project:e.project,title:n,description:r}))).identifier,created:!0};const h=await T(()=>c.issue(t));return h||i(`Linear has no issue ${t}.`),h.team!==e.team&&i(`${t} is in Linear's ${h.team} team, not ${e.team}.`),{ticket:h.identifier,created:!1}}O(a);const s=t===void 0?null:y(t);t!==void 0&&!s&&i("GitHub ticket must be an issue number such as #41.");const p=s?["issue","view",String(s),"--repo",a,"--json","number,url"]:["issue","create","--repo",a,"--title",n,"--body",r],m=await(await j(e,u))("gh",p);m.status!==0&&i((m.stderr||"GitHub refused the issue.").trim().split(`
2
+ `)[0]);let f;if(s){let c;try{c=JSON.parse(m.stdout)}catch{i("GitHub returned an invalid issue.")}c.number!==s&&i("GitHub returned a different issue."),f=c.url}else f=m.stdout?.trim();const d=/^https:\/\/github\.com\/([^/]+\/[^/]+)\/issues\/([1-9]\d*)$/.exec(f||"");return(!d||d[1].toLowerCase()!==a.toLowerCase()||s&&Number(d[2])!==s||!y(d[2]))&&i("Ticket must be an issue in the board\u2019s repo."),{ticket:`#${d[2]}`,created:!s}}o(E,"resolveTicket");const Z=o(e=>e.startsWith("#")?`GH-${e.slice(1)}`:e,"cardIdOf");function R(e,t){const n=e.source==="github"?String(t??"").match(/(?<![\w#])#[1-9]\d*\b/g):String(t??"").match(/\b[A-Z][A-Z0-9]*-[1-9]\d*\b/g);return[...new Set((n||[]).filter(r=>g(e,r)))]}o(R,"titleTickets");function z({status:e,pr:t}){return["done","merged"].includes(e)?"done":["building","fixing"].includes(e)?"started":t!==void 0&&e===void 0?"review":null}o(z,"ticketTarget");const S={started:"In Progress",review:"In Review",done:"Done"};async function _(e,t,n,{repo:r,run:a=$,linearFetch:l}={}){const u=t.ticket;if(!e||!n||!u||!g(e,u)||e.source==="internal"||e.source==="github"&&n!=="done")return null;if(e.source==="github"&&!r)return`ticket ${u}: not closed, the board has no GitHub repo`;const b=o(s=>`ticket ${u}: could not move to ${S[n]} (${String(s.message||s).split(`
3
+ `)[0]})`,"why");try{if(e.source==="linear"){const f=k({fetch:l});if(!f)return`ticket ${u}: not moved, Hub has no Linear key`;if(!t.ticket_created){const c=await f.issue(u);if(!c)return`ticket ${u}: not moved, Linear has no such issue`;if(c.assignee!==f.saved.viewer?.id)return`ticket ${u}: left as it is, not assigned to you`}const d=await f.moveIssue(u,n);return d?`ticket ${u}: moved to ${d}`:null}const s=u.slice(1),p=await j(e,a);if(!t.ticket_created){const f=await p("gh",["issue","view",s,"--repo",r,"--json","state,assignees"]);if(f.status!==0)throw new Error(f.stderr||"gh issue view failed");const d=await p("gh",["api","user","--jq",".login"]);if(d.status!==0)throw new Error(d.stderr||"gh api user failed");const c=JSON.parse(f.stdout);if(c.state!=="OPEN")return null;if(!(c.assignees||[]).some(h=>h.login?.toLowerCase()===d.stdout.trim().toLowerCase()))return`ticket ${u}: left as it is, not assigned to you`}const m=await p("gh",["issue","close",s,"--repo",r]);if(m.status!==0)throw new Error(m.stderr||"gh issue close failed");return`ticket ${u}: closed`}catch(s){return b(s)}}o(_,"moveTicket");export{Z as cardIdOf,_ as moveTicket,E as resolveTicket,C as ticketBadge,g as ticketIn,N as ticketSource,z as ticketTarget,R as titleTickets};