borgmcp 1.0.33 → 1.0.35
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.
- package/dist/assimilate-cmd.d.ts +3 -3
- package/dist/assimilate-cmd.js +32 -32
- package/dist/assimilate-deps.js +3 -3
- package/dist/backends/launch-all-tmux.d.ts +4 -0
- package/dist/backends/launch-all-tmux.js +1 -1
- package/dist/backends/launch-all-windows.d.ts +4 -0
- package/dist/backends/launch-all-windows.js +7 -7
- package/dist/claude.js +6 -6
- package/dist/cubes.d.ts +11 -3
- package/dist/cubes.js +5 -5
- package/dist/launch-all-cmd.d.ts +8 -0
- package/dist/launch-all-cmd.js +27 -27
- package/dist/parse-launch-all-args.d.ts +7 -0
- package/dist/parse-launch-all-args.js +1 -1
- package/dist/remote-client.d.ts +1 -0
- package/dist/remote-client.js +1 -1
- package/dist/templates.d.ts +1 -1
- package/dist/templates.js +2 -2
- package/package.json +1 -1
package/dist/assimilate-cmd.d.ts
CHANGED
|
@@ -107,15 +107,15 @@ export interface AssimilateDeps {
|
|
|
107
107
|
ok: boolean;
|
|
108
108
|
message?: string;
|
|
109
109
|
}>;
|
|
110
|
-
getLaunchModel: (cubeId: string,
|
|
110
|
+
getLaunchModel: (cubeId: string, worktreePath: string, priorDroneId: string | null) => Promise<{
|
|
111
111
|
model: string;
|
|
112
112
|
ollamaBaseUrl: string | null;
|
|
113
113
|
} | null>;
|
|
114
|
-
setLaunchModel: (cubeId: string,
|
|
114
|
+
setLaunchModel: (cubeId: string, worktreePath: string, record: {
|
|
115
115
|
model: string;
|
|
116
116
|
ollamaBaseUrl: string | null;
|
|
117
117
|
}) => Promise<void>;
|
|
118
|
-
clearLaunchModel: (cubeId: string,
|
|
118
|
+
clearLaunchModel: (cubeId: string, worktreePath: string) => Promise<void>;
|
|
119
119
|
}
|
|
120
120
|
export declare function runAssimilate(args: AssimilateArgs, deps: AssimilateDeps): Promise<number>;
|
|
121
121
|
/**
|
package/dist/assimilate-cmd.js
CHANGED
|
@@ -1,48 +1,48 @@
|
|
|
1
|
-
import{dirname as
|
|
2
|
-
`),1}if(r.flags.worktree!==void 0){const t=
|
|
3
|
-
`),1}let i=await e.getCachedAuth();if(!i){if(!e.isTTY()&&!r.flags.yes)return e.stderr("borg setup required and stdin is non-interactive. Run `borg setup` first in an interactive terminal, then `borg assimilate`.\n"),1;i=await e.runSetup()}const a=e.findProjectRoot(e.cwd());let n;if(r.flags.cubeName)n=r.flags.cubeName;else{const t=e.runSync("git",["remote","get-url","origin"],a),o=t.status===0?t.stdout:null;if(n=
|
|
4
|
-
`)}}let
|
|
5
|
-
`);let
|
|
6
|
-
`),i=await e.runSetup(),
|
|
7
|
-
`),1;let
|
|
1
|
+
import{dirname as re,basename as E}from"node:path";import{randomUUID as ne}from"node:crypto";import{roleSlug as oe,matchRoleByName as ie,pickDefaultRole as ae}from"./role-resolver.js";import{deriveCubeName as se,parseGitRemote as le,sanitizeRemoteUrl as ce}from"./cube-name.js";import{validateName as G}from"./name-validator.js";import{renderAssimilationWelcome as ue}from"./assimilate-welcome.js";import{shellEscape as me}from"./shell-escape.js";import{withCodexCwdArg as de}from"./codex-remote.js";import{buildAgentKickoffPrompt as fe,recordCodexWakeTarget as he,socketPathFromRemoteArgs as ge}from"./codex-launch.js";import{perWorktreeBranchName as q,adoptWorktree as we,computeWorktreePath as z}from"./worktree-lifecycle.js";import{DroneEvictedError as be}from"./drone-lifecycle.js";import{codexBorgSessionConfigArgs as ke}from"./launch-gate.js";import{resolveLaunchEnv as ye,resolveOllamaBaseUrl as ve,parseModel as pe}from"./model-presets.js";async function Fe(r,e){if(r.role!==void 0){const t=G(r.role);if(!t.ok)return e.stderr(t.error+`
|
|
2
|
+
`),1}if(r.flags.worktree!==void 0){const t=G(r.flags.worktree);if(!t.ok)return e.stderr(t.error+`
|
|
3
|
+
`),1}let i=await e.getCachedAuth();if(!i){if(!e.isTTY()&&!r.flags.yes)return e.stderr("borg setup required and stdin is non-interactive. Run `borg setup` first in an interactive terminal, then `borg assimilate`.\n"),1;i=await e.runSetup()}const a=e.findProjectRoot(e.cwd());let n;if(r.flags.cubeName)n=r.flags.cubeName;else{const t=e.runSync("git",["remote","get-url","origin"],a),o=t.status===0?t.stdout:null;if(n=se(a,o),o){const u=ce(o),m=u?le(u):null;u&&!m&&n&&e.stderr(`couldn't parse git remote '${u}' \u2014 using directory name '${n}' as cube name
|
|
4
|
+
`)}}let s=null;if(n&&n.includes("@")&&n.includes(":")){const t=n.lastIndexOf(":");s={ownerEmail:n.substring(0,t),cubeName:n.substring(t+1)},n=s.cubeName}const R=e.cwd();e.stderr(`Checking your cubes\u2026
|
|
5
|
+
`);let N;try{N=await e.listCubes(i.apiUrl,i.token)}catch(t){const o=t instanceof Error?t.message:String(t);if(o.includes("Authentication required")||o.includes("Authentication expired"))e.stderr(`Re-authenticating...
|
|
6
|
+
`),i=await e.runSetup(),N=await e.listCubes(i.apiUrl,i.token);else throw t}const T=N.find(t=>t.name===n);if(!T&&s)return e.stderr(`No cube named '${s.cubeName}' accessible to you owned by '${s.ownerEmail}'. Did you accept their invite? See borgmcp.ai/dashboard.
|
|
7
|
+
`),1;let l,A;if(T)l=await e.getCube(i.apiUrl,i.token,T.id),A=!1;else{let t;if(r.flags.template)t=r.flags.template;else if(r.flags.noTemplate)t=void 0;else if(e.isTTY())if(r.flags.yes)t="starter";else{const o=await e.listTemplates(i.apiUrl,i.token),u=["First drone joining a new cube. Apply a template?"];o.forEach((y,v)=>{const C=v===0?" (default)":"";u.push(` ${v+1}) ${y.name}${C} \u2014 ${y.description}`)}),u.push(` ${o.length+1}) skip \u2014 no template`);const m=(await e.prompt(u.join(`
|
|
8
8
|
`)+`
|
|
9
9
|
[1]: `)).trim(),k=m===""?1:parseInt(m,10);if(Number.isNaN(k)||k<1||k>o.length+1)return e.stderr(`invalid choice "${m}"
|
|
10
10
|
`),1;t=k<=o.length?o[k-1].name:void 0}else{if(!r.flags.yes)return e.stderr(`cube creation needs a template choice but stdin is non-interactive.
|
|
11
11
|
Pass --template <name>, --no-template, or --yes (defaults to starter).
|
|
12
12
|
`),1;t="starter"}e.stderr(n?`Creating cube '${n}'\u2026
|
|
13
13
|
`:`Creating your cube\u2026
|
|
14
|
-
`),
|
|
14
|
+
`),l=await e.createCube(i.apiUrl,i.token,t?{name:n??void 0,template:t}:{name:n??void 0}),A=!0}let d;if(r.role!==void 0){if(d=ie(l.roles,r.role),!d){const t=l.roles.map(m=>m.name).join(", "),o=Se(r.role,l.roles.map(m=>m.name)),u=o?` Did you mean "${o}"?`:"";return e.stderr(`no role matching "${r.role}" in cube "${l.name}". Available: ${t}.${u}
|
|
15
15
|
(Use --template <name> on first-drone setup or run \`borg_create-role\` from inside Claude.)
|
|
16
|
-
`),1}}else if(d=
|
|
17
|
-
`),1;const
|
|
18
|
-
`),1;const
|
|
19
|
-
`),1}const
|
|
20
|
-
`);let
|
|
16
|
+
`),1}}else if(d=ae(l.roles,{isFirstDrone:A}),!d)return e.stderr(`cube "${l.name}" has no default or human-seat role; cannot infer a role. Either pass a role argument explicitly (e.g. \`borg assimilate builder\`) or run \`borg_create-role\` from inside Claude to set up roles.
|
|
17
|
+
`),1;const p=await e.getActiveCube();let $;if(p&&r.flags.here)if(p.cubeId===l.id)$=p.droneId;else return e.stderr(`this directory already hosts an active drone; remove --here or run from a fresh worktree
|
|
18
|
+
`),1;const M=r.flags.worktree!==void 0||p!==null&&!r.flags.here,V=$??p?.droneId??null,_=M?null:await e.getLaunchModel(l.id,a,V),g=r.flags.model??_?.model??d.default_model??null,I=ve(process.env,g!=null&&g===_?.model?_?.ollamaBaseUrl:void 0);if(g){const t=await e.checkModelReachable(g,e.fetch,I);if(!t.ok)return e.stderr(`${t.message}
|
|
19
|
+
`),1}const w=await e.resolveCli(r.flags.cli);e.stderr(`Joining cube '${l.name}' as ${d.name}\u2026
|
|
20
|
+
`);let c;try{c=await e.assimilate(i.apiUrl,i.token,{cube_id:l.id,role_id:d.id,hostname:e.getHostname(),agent_kind:w,model:g,...$?{prior_drone_id:$}:{}})}catch(t){if(t instanceof be&&$!=null)return e.stderr(`seat evicted \u2014 this worktree's saved seat was evicted from the cube. Re-assimilate fresh from a terminal, or remove this worktree.
|
|
21
21
|
`),1;const o=t instanceof Error?t.message:String(t);return e.stderr(`assimilate failed: ${o}
|
|
22
|
-
`),1}const
|
|
23
|
-
`):
|
|
24
|
-
`);const
|
|
22
|
+
`),1}const x=l.roles.find(t=>t.id===c.role_id)??d;c.reattached?e.stderr(`re-attached to existing seat ${c.drone_label} (session token rotated, no new drone minted)
|
|
23
|
+
`):x.id!==d.id&&e.stderr(`Note: your invite didn't grant the "${d.name}" role \u2014 assimilated as "${x.name}" instead.
|
|
24
|
+
`);const J=M;let f=null;if(J){const t=e.runSync("git",["rev-parse","--verify","HEAD"],a);if(t.status!==0)return e.stderr(`sibling worktree spawn requires HEAD pointing at a commit.
|
|
25
25
|
Fix: create at least one commit (\`git commit --allow-empty -m "initial"\`)
|
|
26
26
|
OR: pass --here to skip the sibling spawn and use the current directory
|
|
27
27
|
`),1;e.runSync("git",["fetch","origin"],a);let o="origin/main";e.runSync("git",["rev-parse","--verify","origin/main"],a).status!==0&&e.runSync("git",["rev-parse","--verify","origin/master"],a).status===0&&(o="origin/master");const m=t.stdout.trim(),k=e.runSync("git",["rev-parse",o],a).stdout.trim();m!==k&&e.stderr(`note: local HEAD (${m.slice(0,7)}) differs from ${o} (${k.slice(0,7)}); new worktree will start on ${o}
|
|
28
|
-
`);const
|
|
29
|
-
`),1;const
|
|
28
|
+
`);const y=E(a),v=r.flags.worktree??oe(x.name);if(v.length===0)return e.stderr(`cannot derive a worktree name from role "${x.name}"; pass an explicit --worktree <name>
|
|
29
|
+
`),1;const C=e.homedir();let b=z(C,y,v),F=2;for(;e.pathExists(b)||Re(e,a,b);)b=z(C,y,v,F),F++;e.mkdirp(re(b));const O=q(E(b),y),Y=e.runSync("git",["worktree","add","-b",O,b,o],a);if(Y.status!==0)return e.stderr(`git worktree add failed: ${K(Y.stderr)}
|
|
30
30
|
`),1;e.stderr(`spawned sibling worktree at ${b} on branch ${O} (${o}); original dir is registered as active (edit ~/.config/borgmcp/cubes.json if stale).
|
|
31
|
-
`),e.chdir(b),e.stderr(
|
|
31
|
+
`),e.chdir(b),e.stderr($e(b,O,a)),f=e.cwd()}try{await e.setActiveCube({cubeId:c.cube_id,droneId:c.drone_id,name:l.name,sessionToken:c.session_token,droneLabel:c.drone_label,apiUrl:i.apiUrl})}catch(t){const o=t instanceof Error?t.message:String(t);if(e.stderr(`setActiveCube failed: ${o}
|
|
32
32
|
`),f){const u=e.runSync("git",["worktree","remove","--force",f],a);u.status===0?e.stderr(`rolled back spawned worktree at ${f}
|
|
33
|
-
`):e.stderr(`manual cleanup needed: \`git worktree remove --force ${f}\` (rollback attempt failed: ${
|
|
34
|
-
`)}return 1}e.setTerminalTitle(
|
|
35
|
-
`)}if(!f){e.runSync("git",["fetch","origin","--prune"],
|
|
36
|
-
`),e.stderr(
|
|
37
|
-
`)}await e.probeMcpReady()||e.stderr(`warning: borg-mcp readiness probe did not complete within the timeout; launching ${
|
|
38
|
-
`);const
|
|
39
|
-
`),
|
|
40
|
-
Agent exited. You were working in ${f}; your shell is back in ${
|
|
33
|
+
`):e.stderr(`manual cleanup needed: \`git worktree remove --force ${f}\` (rollback attempt failed: ${K(u.stderr).trim()||"unknown"})
|
|
34
|
+
`)}return 1}e.setTerminalTitle(c.drone_label,l.name);const Q=e.isTTY()&&!process.env.NO_COLOR&&!process.env.CI;e.stdout(ue(x.name,l.name,Q));const h=e.cwd();try{e.installProjectSessionHook(h)}catch{e.stderr(`warning: could not install the project-local SessionStart hook in ${h}; it will be re-attempted on the next borg launch
|
|
35
|
+
`)}if(!f){e.runSync("git",["fetch","origin","--prune"],h);const t=q(E(h),E(a)),o=we(e.runSync,h,t,"origin/main");o.action==="adopted"?(e.stderr(`worktree: adopted branch ${t} at origin/main
|
|
36
|
+
`),e.stderr(xe(h,t))):o.message&&e.stderr(`worktree sync: ${o.message}
|
|
37
|
+
`)}await e.probeMcpReady()||e.stderr(`warning: borg-mcp readiness probe did not complete within the timeout; launching ${w} anyway \u2014 the kickoff prompt's ToolSearch fallback will recover if the MCP server takes longer to start.
|
|
38
|
+
`);const X=e.getInboxPath(c.cube_id,c.drone_id),P=w==="codex"?`borg-wake-${ne()}`:null,Z=w==="claude"?`If you haven't yet, arm a persistent Monitor running the command \`borg-inbox-monitor ${X}\` so each event's task-notification title summarizes the new cube log entry (drone label, role, and first ~80 chars of the message body) \u2014 letting you triage events without reading the full body. This Monitor is your cube wake path: keep it armed for the whole session and NEVER TaskStop it \u2014 the generic /loop "TaskStop any Monitor you armed" step does NOT apply to it (it targets throwaway loop-scratch watches only). The sole exception is a confirmed terminal eviction (410 DRONE_EVICTED). `:"";let D,W=[],S,U=null,L=null;const H=e.findProjectRoot(h);g?await e.setLaunchModel(c.cube_id,H,{model:g,ollamaBaseUrl:pe(g).kind==="ollama"?I:null}):await e.clearLaunchModel(c.cube_id,H);const B=ye(g,I),j={...process.env,...B.set,BORG_SESSION:"1"};for(const t of B.unset)delete j[t];if(w==="codex"){const t=await e.prepareCodexRemoteLaunch();t.warning?(e.stderr(`warning: ${t.warning}
|
|
39
|
+
`),D="\u26A0 Codex wake-path capability check failed: remote-control is unavailable for this session. Run borg_regen manually whenever you return, and expect only fallback wakeups until relaunch."):D="Codex wake-path capability check passed: remote-control socket established for this session.",W=t.args,Object.keys(t.env).length>0&&Object.assign(j,t.env),U=ge(t.args),L=t.server?.cleanup??null}S=[fe({cli:w,codexWakeNonce:P,monitorClause:Z,codexWakePathClause:D})],w==="codex"&&(S=[...ke(),...W,...de(S,h)]);const ee=e.exec(w,S,h,j);w==="codex"&&U&&P&&he({deps:e,cubeId:c.cube_id,droneId:c.drone_id,socketPath:U,cwd:h,previewNeedle:P,launchedAtSeconds:Math.floor(Date.now()/1e3)});const te=await ee;if(L)try{L()}catch{}return f&&R!==f&&e.stderr(`
|
|
40
|
+
Agent exited. You were working in ${f}; your shell is back in ${R}.
|
|
41
41
|
To return:
|
|
42
|
-
cd ${
|
|
43
|
-
`),
|
|
42
|
+
cd ${me(f)}
|
|
43
|
+
`),te}function $e(r,e,i){return`
|
|
44
44
|
WORKTREE STEERING: You are in worktree ${r} on branch ${e}. Do ALL work HERE \u2014 cut your feature branch (fix/.../feat/...) off ${e} in THIS worktree, use relative paths / your cwd. NEVER \`git -C ${i}\` or operate on the primary checkout ${i}: the same branch can't be checked out in two worktrees, so work created in the primary won't reach your wt-branch without manual surgery (cherry-pick/merge).
|
|
45
|
-
`}function
|
|
45
|
+
`}function xe(r,e){return`
|
|
46
46
|
WORKTREE STEERING: This checkout is now on branch ${e}. Do ALL work HERE in ${r} \u2014 cut your feature branch (fix/.../feat/...) off ${e}, use relative paths / your cwd.
|
|
47
|
-
`}function
|
|
48
|
-
`).some(n=>n===`worktree ${i}`)}function
|
|
47
|
+
`}function K(r){return r.replace(/[\x00-\x1F\x7F]/g,"")}function Re(r,e,i){const a=r.runSync("git",["worktree","list","--porcelain"],e);return a.status!==0?!1:a.stdout.split(`
|
|
48
|
+
`).some(n=>n===`worktree ${i}`)}function Se(r,e){if(e.length===0)return null;const i=r.toLowerCase();let a=null;for(const n of e){const s=Ce(i,n.toLowerCase());s<=2&&(a===null||s<a.distance)&&(a={name:n,distance:s})}return a?a.name:null}function Ce(r,e){if(r===e)return 0;if(r.length===0)return e.length;if(e.length===0)return r.length;const i=new Array(e.length+1),a=new Array(e.length+1);for(let n=0;n<=e.length;n++)i[n]=n;for(let n=1;n<=r.length;n++){a[0]=n;for(let s=1;s<=e.length;s++){const R=r[n-1]===e[s-1]?0:1;a[s]=Math.min(a[s-1]+1,i[s]+1,i[s-1]+R)}for(let s=0;s<=e.length;s++)i[s]=a[s]}return i[e.length]}export{Fe as runAssimilate,K as safeStderr,Se as suggestRoleName};
|
package/dist/assimilate-deps.js
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import{spawnSync as p,spawn as l}from"node:child_process";import{existsSync as h,mkdirSync as f}from"node:fs";import{hostname as b,homedir as C}from"node:os";import{createInterface as d}from"node:readline/promises";import{API_URL as u,getValidToken as m,listCubes as _,getCube as T,createCube as y,assimilate as k,listTemplates as w}from"./remote-client.js";import{findProjectRoot as g,getActiveCube as L,setActiveCube as x,inboxPathForDrone as M,setCodexWakeTarget as S,getLaunchModel as v,setLaunchModel as R,clearLaunchModel as A}from"./cubes.js";import{authenticateWithGoogle as P}from"./auth.js";import{addProjectSessionStartHook as U}from"./config-utils.js";import{setTerminalTitle as j}from"./terminal-title.js";import{defaultCliChoiceDeps as D,resolveCliChoice as G}from"./cli-platform.js";import{prepareCodexRemoteLaunch as H,defaultCodexRemoteDeps as I}from"./codex-remote.js";import{findLoadedCodexThread as q}from"./codex-app-server.js";import{checkModelReachable as V}from"./model-presets.js";function $(){return{runSync:(e,t
|
|
2
|
-
`))if(c.includes('"protocolVersion"')&&c.includes('"result"')){clearTimeout(i),s(!0);return}});const a=JSON.stringify({jsonrpc:"2.0",id:1,method:"initialize",params:{protocolVersion:"2024-11-05",capabilities:{},clientInfo:{name:"borg-assimilate-probe",version:"0.9.3"}}});try{
|
|
3
|
-
`)}catch{clearTimeout(i),s(!1)}}),resolveCli:e=>G(e,D(async
|
|
1
|
+
import{spawnSync as p,spawn as l}from"node:child_process";import{existsSync as h,mkdirSync as f}from"node:fs";import{hostname as b,homedir as C}from"node:os";import{createInterface as d}from"node:readline/promises";import{API_URL as u,getValidToken as m,listCubes as _,getCube as T,createCube as y,assimilate as k,listTemplates as w}from"./remote-client.js";import{findProjectRoot as g,getActiveCube as L,setActiveCube as x,inboxPathForDrone as M,setCodexWakeTarget as S,getLaunchModel as v,setLaunchModel as R,clearLaunchModel as A}from"./cubes.js";import{authenticateWithGoogle as P}from"./auth.js";import{addProjectSessionStartHook as U}from"./config-utils.js";import{setTerminalTitle as j}from"./terminal-title.js";import{defaultCliChoiceDeps as D,resolveCliChoice as G}from"./cli-platform.js";import{prepareCodexRemoteLaunch as H,defaultCodexRemoteDeps as I}from"./codex-remote.js";import{findLoadedCodexThread as q}from"./codex-app-server.js";import{checkModelReachable as V}from"./model-presets.js";function $(){return{runSync:(e,o,t)=>{const r=p(e,o,{cwd:t,encoding:"utf-8"});return{status:r.status,stdout:r.stdout??"",stderr:r.stderr??""}},pathExists:e=>h(e),cwd:()=>process.cwd(),chdir:e=>process.chdir(e),homedir:()=>C(),mkdirp:e=>f(e,{recursive:!0}),exec:(e,o,t,r)=>new Promise((s,i)=>{const a=l(e,o,{cwd:t,stdio:"inherit",shell:!1,env:r??process.env});a.on("error",i),a.on("exit",n=>s(n??0))}),stderr:e=>process.stderr.write(e),stdout:e=>process.stdout.write(e),prompt:async e=>{const o=d({input:process.stdin,output:process.stdout});try{return await o.question(e)}finally{o.close()}},isTTY:()=>process.stdin.isTTY===!0,getHostname:()=>b(),setTerminalTitle:(e,o)=>{j({label:e,cubeName:o},o)},getActiveCube:()=>L(),setActiveCube:e=>x(e),findProjectRoot:e=>g(e),installProjectSessionHook:e=>{U(e)},getCachedAuth:async()=>{try{return{token:await m(),apiUrl:u}}catch{return null}},runSetup:async()=>(await P(),{token:await m(),apiUrl:u}),listCubes:async(e,o)=>{const{cubes:t}=await _();return t.map(r=>({id:r.id,name:r.name}))},getCube:async(e,o,t)=>{const r=await T(t);return{id:r.id,name:r.name,roles:r.roles}},createCube:async(e,o,t)=>{const r=await y(t.name,"",t.template?{template:t.template}:void 0);return{id:r.id,name:r.name,roles:r.roles}},assimilate:async(e,o,t)=>{const r=await k({cube_id:t.cube_id,role_id:t.role_id,...t.prior_drone_id?{prior_drone_id:t.prior_drone_id}:{},...t.model!=null?{model:t.model}:{}},void 0,t.hostname??null,t.agent_kind??null);return{cube_id:r.cube.id,drone_id:r.drone.id,drone_label:r.drone.label,session_token:r.sessionToken,role_id:r.role.id,reattached:r.reattached===!0}},listTemplates:async(e,o)=>{const{templates:t}=await w();return t.map(r=>({name:r.name,description:r.description}))},getInboxPath:(e,o)=>M(e,o),probeMcpReady:()=>new Promise(e=>{const o=l("borg-mcp",[],{stdio:["pipe","pipe","pipe"],shell:!1});let t="",r=!1;const s=n=>{if(!r){r=!0;try{o.kill("SIGTERM")}catch{}e(n)}},i=setTimeout(()=>s(!1),2e3);o.on("error",()=>{clearTimeout(i),s(!1)}),o.on("exit",()=>{clearTimeout(i),s(r)}),o.stdout?.on("data",n=>{t+=n.toString("utf-8");for(const c of t.split(`
|
|
2
|
+
`))if(c.includes('"protocolVersion"')&&c.includes('"result"')){clearTimeout(i),s(!0);return}});const a=JSON.stringify({jsonrpc:"2.0",id:1,method:"initialize",params:{protocolVersion:"2024-11-05",capabilities:{},clientInfo:{name:"borg-assimilate-probe",version:"0.9.3"}}});try{o.stdin?.write(a+`
|
|
3
|
+
`)}catch{clearTimeout(i),s(!1)}}),resolveCli:e=>G(e,D(async o=>{const t=d({input:process.stdin,output:process.stdout});try{return await t.question(o)}finally{t.close()}},()=>process.stdin.isTTY===!0)),prepareCodexRemoteLaunch:()=>H(I()),setCodexWakeTarget:S,findLoadedCodexThread:q,fetch,checkModelReachable:V,getLaunchModel:(e,o,t)=>v(e,o,t),setLaunchModel:(e,o,t)=>R(e,o,t),clearLaunchModel:(e,o)=>A(e,o)}}export{$ as buildDefaultAssimilateDeps};
|
|
@@ -7,6 +7,10 @@ export interface TmuxOpts {
|
|
|
7
7
|
attachMode: 'attach' | 'switch' | 'none';
|
|
8
8
|
/** ISO-8601 captured before the first send-keys (lock-marker launchedAt). */
|
|
9
9
|
launchedAtISO: string;
|
|
10
|
+
/** Stagger between drone launches (ms) to avoid the rate limiter; 0 disables. */
|
|
11
|
+
launchDelayMs: number;
|
|
12
|
+
/** Injectable sleep (real setTimeout in prod; no-op spy in tests). */
|
|
13
|
+
sleep: (ms: number) => Promise<void>;
|
|
10
14
|
}
|
|
11
15
|
export declare function runTmuxBackend(candidates: DroneCandidate[], opts: TmuxOpts, deps: LaunchAllDeps): Promise<void>;
|
|
12
16
|
//# sourceMappingURL=launch-all-tmux.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{buildLaunchCommand as
|
|
1
|
+
import{buildLaunchCommand as d}from"../launch-all-command.js";import{writeLockMarker as x}from"../launch-all-locks.js";async function y(o,s,t){const{sessionName:e,borgPath:u,attachMode:c,launchedAtISO:w,launchDelayMs:a,sleep:m}=s,l=t.runSyncExitCode("tmux",["has-session","-t",e])===0;for(let r=0;r<o.length;r++){const n=o[r];r>0&&a>0&&await m(a);let i;r===0&&!l?i=t.runSync("tmux",["new-session","-d","-P","-F","#{window_id}","-s",e,"-c",n.worktreeDir]).trim():i=t.runSync("tmux",["new-window","-P","-F","#{window_id}","-t",e,"-c",n.worktreeDir]).trim(),t.runSync("tmux",["rename-window","-t",i,n.droneLabel]);const h=d(n.worktreeDir,u,{keepOpenOnFail:!0});t.runSync("tmux",["send-keys","-t",i,h,"Enter"]),x(t,n.cubeId,n.droneLabel,n.worktreeDir,w)}c==="switch"?t.attachInteractive("tmux",["switch-client","-t",e]):c==="attach"&&t.attachInteractive("tmux",["attach-session","-t",e])}export{y as runTmuxBackend};
|
|
@@ -4,6 +4,10 @@ export interface WindowsOpts {
|
|
|
4
4
|
borgPath: string;
|
|
5
5
|
platform: NodeJS.Platform;
|
|
6
6
|
launchedAtISO: string;
|
|
7
|
+
/** Stagger between drone launches (ms) to avoid the rate limiter; 0 disables. */
|
|
8
|
+
launchDelayMs: number;
|
|
9
|
+
/** Injectable sleep (real setTimeout in prod; no-op spy in tests). */
|
|
10
|
+
sleep: (ms: number) => Promise<void>;
|
|
7
11
|
}
|
|
8
12
|
export declare function runWindowsBackend(candidates: DroneCandidate[], opts: WindowsOpts, deps: LaunchAllDeps): Promise<void>;
|
|
9
13
|
//# sourceMappingURL=launch-all-windows.d.ts.map
|
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
import{buildLaunchCommand as
|
|
1
|
+
import{buildLaunchCommand as m}from"../launch-all-command.js";import{writeLockMarker as u}from"../launch-all-locks.js";function s(t){return t.replace(/\\/g,"\\\\").replace(/"/g,'\\"')}class f extends Error{}async function w(t,e,r){const i=r.pathExists("/Applications/iTerm.app"),o=r.pathExists("/Applications/Terminal.app");if(!i&&!o)throw new f(`borg launch-all: --mode windows requires a compatible terminal app.
|
|
2
2
|
Not found: iTerm.app, Terminal.app
|
|
3
3
|
Install iTerm2 (https://iterm2.com) or use --mode tmux (brew install tmux).
|
|
4
|
-
`);for(const n
|
|
5
|
-
tell current window to create tab with default profile command "${s(
|
|
4
|
+
`);for(let a=0;a<t.length;a++){const n=t[a];a>0&&e.launchDelayMs>0&&await e.sleep(e.launchDelayMs);const l=m(n.worktreeDir,e.borgPath),c=i?`tell application "iTerm"
|
|
5
|
+
tell current window to create tab with default profile command "${s(l)}"
|
|
6
6
|
end tell`:`tell application "Terminal"
|
|
7
|
-
do script "${s(
|
|
7
|
+
do script "${s(l)}"
|
|
8
8
|
activate
|
|
9
|
-
end tell`;
|
|
9
|
+
end tell`;r.runSync("osascript",["-e",c]),u(r,n.cubeId,n.droneLabel,n.worktreeDir,e.launchedAtISO)}}async function h(t,e,r){const i=r.getEnv("BORG_TERMINAL")||r.getEnv("TERMINAL"),o=["gnome-terminal","konsole","kitty","wezterm","xterm"];let a=i;if(!a){for(const n of o)if(r.runSyncExitCode("which",[n])===0){a=n;break}}if(!a)throw new f(`borg launch-all: --mode windows requires a terminal emulator.
|
|
10
10
|
Not found. Set $BORG_TERMINAL=<path> or use --mode tmux.
|
|
11
|
-
`);for(const
|
|
12
|
-
`),!1):!0);
|
|
11
|
+
`);for(let n=0;n<t.length;n++){const l=t[n];n>0&&e.launchDelayMs>0&&await e.sleep(e.launchDelayMs);const c=m(l.worktreeDir,e.borgPath,{keepOpenOnFail:!0});r.runSync(a,["-e","sh","-c",c]),u(r,l.cubeId,l.droneLabel,l.worktreeDir,e.launchedAtISO)}}const p=/[\x00-\x1f\x7f]/;async function k(t,e,r){const i=t.filter(o=>p.test(o.worktreeDir)?(r.stderr(`skipping ${o.droneLabel} (${JSON.stringify(o.worktreeDir)}): worktree path contains a control character \u2014 unsafe for --mode windows; use --mode tmux instead.
|
|
12
|
+
`),!1):!0);e.platform==="darwin"?await w(i,e,r):await h(i,e,r)}export{k as runWindowsBackend};
|
package/dist/claude.js
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{spawn as
|
|
3
|
-
`)})();if((process.argv[2]==="--help"||process.argv[2]==="-h")&&(process.stdout.write(V(g())),process.exit(0)),process.argv[2]==="setup"){
|
|
2
|
+
import{spawn as L}from"child_process";import{randomUUID as M}from"node:crypto";import{basename as E}from"node:path";import{createInterface as O}from"node:readline/promises";import t from"chalk";import{findProjectRoot as y,getActiveCube as H,getLaunchModel as F,inboxPathForDrone as N,setCodexWakeTarget as B,pruneDeadCodexWakeTargets as _}from"./cubes.js";import{applyOllamaLaunchEnv as G,checkModelReachable as W}from"./model-presets.js";import{handleVersionFlag as Y,getPackageVersion as g}from"./version.js";import{isHelpFlag as S,setupHelpText as U,topLevelHelpText as V,assimilateHelpText as j}from"./cli-help.js";import{runSpawn as K}from"./spawn.js";import{parseSyncArgs as q,runSync as z}from"./sync.js";import{parseCleanupArgs as X,runCleanup as J}from"./cleanup-cmd.js";import{parseAssimilateArgs as Q}from"./parse-assimilate-args.js";import{runAssimilate as Z}from"./assimilate-cmd.js";import{buildDefaultAssimilateDeps as ee}from"./assimilate-deps.js";import{parseLaunchAllArgs as T}from"./parse-launch-all-args.js";import{runLaunchAll as A}from"./launch-all-cmd.js";import{buildDefaultLaunchAllDeps as w}from"./launch-all-deps.js";import{discoverDroneCandidates as re}from"./launch-all-discovery.js";import{runBareLaunchMenu as oe,shouldShowLaunchMenu as se}from"./bare-launch-menu.js";import{setTerminalTitle as te}from"./terminal-title.js";import{initConsolePrefix as ae,consolePrefix as o}from"./console-prefix.js";import{initDebugFromArgv as ie}from"./debug.js";import{fetchLatestBorgmcpVersion as ne,compareVersionsForStaleness as ce}from"./stale-version-check.js";import{defaultCliChoiceDeps as le,detectCliAvailability as x,installedCliNames as I,parseCliFlag as de,resolveCliChoice as pe}from"./cli-platform.js";import{getRefreshToken as ue,getIdToken as me}from"./config.js";import{composeGetStarted as fe,shouldShowGetStarted as ge}from"./get-started.js";import{prepareCodexRemoteLaunch as he,withCodexCwdArg as we,defaultCodexRemoteDeps as xe,checkCodexBridgeHealthy as ve}from"./codex-remote.js";import{findLoadedCodexThread as be}from"./codex-app-server.js";import{buildAgentKickoffPrompt as Ce,recordCodexWakeTarget as ke,socketPathFromRemoteArgs as P}from"./codex-launch.js";import{codexBorgSessionConfigArgs as $e}from"./launch-gate.js";import{addCodexMcpServer as ye,addCodexSessionStartHook as Se,addCodexUserPromptSubmitHook as Te,addMcpServer as Ae,addProjectSessionStartHook as Ie,addUserPromptSubmitHook as Pe,isCodexMcpServerConfigured as Re,isMcpServerConfigured as De,removeSessionStartHook as Le}from"./config-utils.js";async function Me(){ie(process.argv),Y(),await ae();const c=(async()=>{if(!process.stderr.isTTY)return;const e=g(),r=await ne();if(!r)return;const i=ce(e,r);i.stale&&i.message&&process.stderr.write(`${o()}${i.message}
|
|
3
|
+
`)})();if((process.argv[2]==="--help"||process.argv[2]==="-h")&&(process.stdout.write(V(g())),process.exit(0)),process.argv[2]==="setup"){S(process.argv[3])&&(process.stdout.write(U(g())),process.exit(0)),await import("./setup.js");return}if(process.argv[2]==="assimilate"){process.argv.slice(3).some(S)&&(process.stdout.write(j(g())),process.exit(0));const e=Q(process.argv.slice(3));e.ok||(process.stderr.write(t.red(`${o()}\u25FC borg assimilate: ${e.error}
|
|
4
4
|
`)),process.stderr.write("Run `borg --help` for usage.\n"),process.exit(1));const r=ee(),i=await Z({role:e.role,flags:e.flags},r);process.exit(i)}if(process.argv[2]==="spawn"){const e=await K();process.exit(e)}if(process.argv[2]==="sync"){const e=q(process.argv.slice(3));e.ok||(process.stderr.write(t.red(`${o()}\u25FC borg sync: ${e.error}
|
|
5
5
|
`)),process.stderr.write("Run `borg --help` for usage.\n"),process.exit(1));const r=await z({},e.options);process.exit(r)}if(process.argv[2]==="cleanup"){const e=X(process.argv.slice(3));e.ok||(process.stderr.write(t.red(`${o()}\u25FC borg cleanup: ${e.error}
|
|
6
|
-
`)),process.stderr.write("Run `borg --help` for usage.\n"),process.exit(1));const r=await J({},e.options);process.exit(r)}if(process.argv[2]==="launch-all"){const e=
|
|
7
|
-
`)),process.stderr.write("Run `borg --help` for usage.\n"),process.exit(1));const r=w(),i=await
|
|
8
|
-
`)),process.stderr.write("Run `borg --help` for usage.\n"),process.exit(1));const v=async e=>{const r=
|
|
6
|
+
`)),process.stderr.write("Run `borg --help` for usage.\n"),process.exit(1));const r=await J({},e.options);process.exit(r)}if(process.argv[2]==="launch-all"){const e=T(process.argv.slice(3));e.ok||(process.stderr.write(t.red(`${o()}\u25FC borg launch-all: ${e.error}
|
|
7
|
+
`)),process.stderr.write("Run `borg --help` for usage.\n"),process.exit(1));const r=w(),i=await A(e.args,r);process.exit(i)}if(ge(await ue()!==null,await me()!==null)){const e=I(x()).length>0;process.stdout.write(fe(e)),process.exit(0)}const n=de(process.argv.slice(2));n.error&&(process.stderr.write(t.red(`${o()}\u25FC ${n.error}
|
|
8
|
+
`)),process.stderr.write("Run `borg --help` for usage.\n"),process.exit(1));const v=async e=>{const r=O({input:process.stdin,output:process.stdout});try{return await r.question(e)}finally{r.close()}};let s=await pe(n.cli,le(v,()=>process.stdin.isTTY===!0));Ee();const a=await H();if(se({extraArgs:process.argv.slice(2),stdinIsTTY:process.stdin.isTTY===!0,stdoutIsTTY:process.stdout.isTTY===!0})){const e=I(x()).find(m=>m!==s)??null;let r=!1;a&&(r=(await re({targetCubeId:a.cubeId},w())).length>0);const i=await oe({defaultCli:s,otherInstalledCli:e,hasLaunchAllTargets:r},v);if(i.kind==="launch-all"){const m=T([]),D=m.ok?await A(m.args,w()):1;process.exit(D)}s=i.cli}const l=n.rest;te(a?{label:a.droneLabel,cubeName:a.name}:null,E(process.cwd()));const R=a&&s==="claude"?`If you haven't yet, arm a persistent Monitor running the command \`borg-inbox-monitor ${N(a.cubeId,a.droneId)}\` so each event's task-notification title summarizes the new cube log entry (drone label, role, and first ~80 chars of the message body) \u2014 letting you triage events without reading the full body. `:"";await Promise.race([c,new Promise(e=>setTimeout(e,2e3))]);const b=s==="codex"?`borg-wake-${M()}`:null;let f,C=[],d={...process.env,BORG_SESSION:"1"},p=null,u=null;if(s==="codex"&&!l.includes("--remote")){console.error(`${o()}${t.gray("\u25FC Starting Codex remote-wake app-server\u2026")}`);const e=await he(xe());e.warning?(console.error(`${o()}${t.yellow(`warning: ${e.warning}`)}`),f="\u26A0 Codex wake-path capability check failed: remote-control is unavailable for this session. Run borg_regen manually whenever you return, and expect only fallback wakeups until relaunch."):f="Codex wake-path capability check passed: remote-control socket established for this session.",C=e.args,d={...process.env,...e.env,BORG_SESSION:"1"},p=P(e.args),u=e.server?.cleanup??null}else s==="codex"&&l.includes("--remote")&&(f="Codex wake-path capability check: using caller-provided --remote socket; if no wake arrives, run borg_regen manually when returning to the session.",p=P(l),p&&(d={...process.env,BORG_CODEX_REMOTE_WAKE:"1",BORG_SESSION:"1"}));if(a){const e=await F(a.cubeId,y(),a.droneId),r=G(d,e,process.env);if(d=r.env,r.probe){const i=await W(r.probe.descriptor,fetch,r.probe.baseUrl);i.ok||console.error(`${o()}${t.yellow(`warning: ${i.message}`)}`)}}const k=Ce({cli:s,codexWakeNonce:b,monitorClause:R,codexWakePathClause:f});let h=[...l,k];s==="codex"&&(h=[...$e(),...C,...we(h,process.cwd())]),console.error(`${o()}${t.blue(`\u25FC Launching ${s==="claude"?"Claude Code":"Codex"}\u2026`)}`);const $=L(s,h,{stdio:"inherit",shell:!1,env:d});s==="codex"&&a&&p&&(ke({deps:{setCodexWakeTarget:B,findLoadedCodexThread:be},cubeId:a.cubeId,droneId:a.droneId,socketPath:p,passthroughArgs:l,previewNeedle:b??k.slice(0,120),cwd:process.cwd(),launchedAtSeconds:Math.floor(Date.now()/1e3)}),_(e=>ve(e))),$.on("error",e=>{if(u)try{u()}catch{}e.code==="ENOENT"?(console.error(`${o()}${t.red(`
|
|
9
9
|
\u25FC Failed to launch ${s}`)}`),console.error(`${o()}${t.gray(`Make sure ${s} is installed.
|
|
10
10
|
`)}`)):console.error(`${o()}${t.red(`
|
|
11
11
|
\u25FC Failed to launch ${s}: ${e.message}
|
|
12
|
-
`)}`),process.exit(1)}),$.on("exit",e=>{if(u)try{u()}catch{}process.exit(e??0)})}function Ee(){const c=x();if(c.claude)try{De()||Ae(),Ie(
|
|
12
|
+
`)}`),process.exit(1)}),$.on("exit",e=>{if(u)try{u()}catch{}process.exit(e??0)})}function Ee(){const c=x();if(c.claude)try{De()||Ae(),Ie(y(process.cwd())),Le(),Pe()}catch(n){console.error(`${o()}${t.yellow(`warning: Claude Code integration check failed: ${n?.message??n}`)}`)}if(c.codex)try{Re()||ye(),Se(),Te()}catch(n){console.error(`${o()}${t.yellow(`warning: Codex integration check failed: ${n?.message??n}`)}`)}}Me().catch(c=>{console.error(`${o()}${t.red(`
|
|
13
13
|
\u25FC Error: ${c.message}
|
|
14
14
|
`)}`),process.exit(1)});
|
package/dist/cubes.d.ts
CHANGED
|
@@ -98,7 +98,15 @@ export interface LaunchModelRecord {
|
|
|
98
98
|
/** Resolved Ollama host for an ollama model; null for claude. */
|
|
99
99
|
ollamaBaseUrl: string | null;
|
|
100
100
|
}
|
|
101
|
-
export declare function setLaunchModel(cubeId: string,
|
|
102
|
-
|
|
103
|
-
|
|
101
|
+
export declare function setLaunchModel(cubeId: string, worktreePath: string, record: LaunchModelRecord, file?: string): Promise<void>;
|
|
102
|
+
/**
|
|
103
|
+
* Read the launch model for a worktree. On a worktree-key miss, if `priorDroneId`
|
|
104
|
+
* is supplied (the seat that previously occupied this worktree, derived from
|
|
105
|
+
* cubes.json), a legacy droneId-keyed entry is migrated ON READ to the worktree
|
|
106
|
+
* key and the old key dropped (a move, not a copy — no silent loss). Without a
|
|
107
|
+
* prior droneId the legacy entry is unreachable but LEFT INTACT for a one-time
|
|
108
|
+
* operator re-pin (HARD constraint: never silently destroy a stored entry).
|
|
109
|
+
*/
|
|
110
|
+
export declare function getLaunchModel(cubeId: string, worktreePath: string, priorDroneId?: string | null, file?: string): Promise<LaunchModelRecord | null>;
|
|
111
|
+
export declare function clearLaunchModel(cubeId: string, worktreePath: string, file?: string): Promise<void>;
|
|
104
112
|
//# sourceMappingURL=cubes.d.ts.map
|
package/dist/cubes.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import{existsSync as
|
|
2
|
-
`,{mode:384})}function
|
|
3
|
-
`,{mode:384})}function
|
|
4
|
-
`,{mode:384})}async function
|
|
5
|
-
`,{mode:384})}async function
|
|
1
|
+
import{existsSync as $}from"node:fs";import{mkdir as f,readFile as d,writeFile as p,unlink as L}from"node:fs/promises";import{homedir as v}from"node:os";import{dirname as l,join as i,resolve as I}from"node:path";import{pruneDeadWakeTargets as _}from"./codex-wake-resolve.js";import{MODEL_DESCRIPTOR_REGEX as U}from"./model-presets.js";const u=i(v(),".config","borgmcp"),y=i(u,"cubes.json"),m=i(u,"launch.json"),h=i(u,"codex-wake-targets.json"),j=i(u,"launch-models.json"),R=i(u,"inboxes");function c(t=process.cwd()){let e=I(t);for(;;){if($(i(e,".git")))return e;const r=l(e);if(r===e)return I(t);e=r}}const a=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Q(t,e){if(!a.test(t))throw new Error(`Invalid cubeId: ${t}`);if(!a.test(e))throw new Error(`Invalid droneId: ${e}`);return i(R,t,`${e}.log`)}function W(t){return t!==null&&typeof t=="object"&&typeof t.projects=="object"&&t.projects!==null&&!Array.isArray(t.projects)}async function w(){let t;try{t=await d(y,"utf8")}catch(r){if(r?.code==="ENOENT")return null;throw r}let e;try{e=JSON.parse(t)}catch{return null}return W(e)?e:null}async function S(t){await f(l(y),{recursive:!0}),await p(y,JSON.stringify(t,null,2)+`
|
|
2
|
+
`,{mode:384})}function D(t){return t!==null&&typeof t=="object"&&typeof t.projects=="object"&&t.projects!==null&&!Array.isArray(t.projects)}async function x(){let t;try{t=await d(m,"utf8")}catch(e){if(e?.code==="ENOENT")return null;throw e}try{const e=JSON.parse(t);return D(e)?e:null}catch{return null}}async function P(t){await f(l(m),{recursive:!0}),await p(m,JSON.stringify(t,null,2)+`
|
|
3
|
+
`,{mode:384})}function A(t,e){if(!a.test(t))throw new Error(`Invalid cubeId: ${t}`);if(!a.test(e))throw new Error(`Invalid droneId: ${e}`);return`${t}:${e}`}function B(t){return t!==null&&typeof t=="object"&&typeof t.targets=="object"&&t.targets!==null&&!Array.isArray(t.targets)}async function E(){let t;try{t=await d(h,"utf8")}catch(e){if(e?.code==="ENOENT")return null;throw e}try{const e=JSON.parse(t);return B(e)?e:null}catch{return null}}async function T(t){await f(l(h),{recursive:!0}),await p(h,JSON.stringify(t,null,2)+`
|
|
4
|
+
`,{mode:384})}async function V(){const t=await w();if(!t)return null;const e=c(),r=t.projects[e];return!r||typeof r.cubeId!="string"||!r.cubeId||typeof r.droneId!="string"||!r.droneId?null:r}async function Y(t){const e=await w()??{projects:{}};e.projects[c()]=t,await S(e)}function Z(t,e){const r=e.cube?.name??t.name,n=e.drone?.label??t.droneLabel;return r===t.name&&n===t.droneLabel?t:{...t,name:r,droneLabel:n}}async function tt(){const t=await w();if(!t)return;const e=c();if(e in t.projects){if(delete t.projects[e],Object.keys(t.projects).length===0){try{await L(y)}catch(r){if(r?.code!=="ENOENT")throw r}return}await S(t)}}async function et(){const t=await x();if(!t)return null;const e=t.projects[c()];return e?.cli==="claude"||e?.cli==="codex"?e.cli:null}async function rt(t){const e=await x();if(!e)return null;const r=e.projects[c(t)];return r?.cli==="claude"||r?.cli==="codex"?r.cli:null}async function nt(){const t=await w();return t?Object.entries(t.projects).filter(([,e])=>e!==null&&typeof e=="object"&&typeof e.cubeId=="string"&&e.cubeId.length>0&&typeof e.droneId=="string"&&e.droneId.length>0).map(([e,r])=>({projectPath:e,cube:r})):[]}async function ot(t){const e=await x()??{projects:{}};e.projects[c()]={cli:t},await P(e)}async function it(t,e,r){const n=await E()??{targets:{}};n.targets[A(t,e)]={...r,updatedAt:new Date().toISOString()},await T(n)}async function at(t,e){const r=await E();if(!r)return null;const n=r.targets[A(t,e)];return!n||typeof n.threadId!="string"||typeof n.socketPath!="string"?null:n}async function ct(t){const e=await E();if(!e)return;const{targets:r,changed:n}=_(e.targets,t);n&&await T({...e,targets:r})}function b(t,e){if(!a.test(t))throw new Error(`Invalid cubeId: ${t}`);if(typeof e!="string"||e.length===0)throw new Error(`Invalid worktree path: ${e}`);return`${t}:${e}`}function J(t,e){if(!a.test(t))throw new Error(`Invalid cubeId: ${t}`);if(!a.test(e))throw new Error(`Invalid droneId: ${e}`);return`${t}:${e}`}function k(t){return!t||typeof t.model!="string"||!U.test(t.model)?null:{model:t.model,ollamaBaseUrl:typeof t.ollamaBaseUrl=="string"?t.ollamaBaseUrl:null}}function M(t){return t!==null&&typeof t=="object"&&typeof t.models=="object"&&t.models!==null&&!Array.isArray(t.models)}async function N(t){let e;try{e=await d(t,"utf8")}catch(r){if(r?.code==="ENOENT")return null;throw r}try{const r=JSON.parse(e);return M(r)?r:null}catch{return null}}async function O(t,e){await f(l(t),{recursive:!0}),await p(t,JSON.stringify(e,null,2)+`
|
|
5
|
+
`,{mode:384})}async function st(t,e,r,n=j){const o=await N(n)??{models:{}};o.models[b(t,e)]={model:r.model,ollamaBaseUrl:r.ollamaBaseUrl},await O(n,o)}async function lt(t,e,r=null,n=j){const o=await N(n);if(!o)return null;const s=b(t,e),C=k(o.models[s]);if(C)return C;if(!r||!a.test(r))return null;const F=J(t,r),g=k(o.models[F]);return g?(o.models[s]=g,delete o.models[F],await O(n,o),g):null}async function ut(t,e,r=j){const n=await N(r);if(!n)return;const o=b(t,e);if(o in n.models){if(delete n.models[o],Object.keys(n.models).length===0){try{await L(r)}catch(s){if(s?.code!=="ENOENT")throw s}return}await O(r,n)}}export{Z as activeCubeWithFreshRegenIdentity,tt as clearActiveCube,ut as clearLaunchModel,c as findProjectRoot,V as getActiveCube,at as getCodexWakeTarget,lt as getLaunchModel,et as getProjectCliPreference,rt as getProjectCliPreferenceForPath,Q as inboxPathForDrone,ct as pruneDeadCodexWakeTargets,nt as readAllProjectIdentities,Y as setActiveCube,it as setCodexWakeTarget,st as setLaunchModel,ot as setProjectCliPreference};
|
package/dist/launch-all-cmd.d.ts
CHANGED
|
@@ -1,5 +1,13 @@
|
|
|
1
1
|
import type { LaunchAllArgs } from './parse-launch-all-args.js';
|
|
2
2
|
import type { LaunchAllDeps } from './launch-all-deps.js';
|
|
3
|
+
/**
|
|
4
|
+
* Default ms to wait BETWEEN each drone launch, so a fleet's agents don't all
|
|
5
|
+
* bootstrap at once and trip the per-user/IP rate limiter. Override per-run with
|
|
6
|
+
* `--launch-delay <ms>` or persistently with `$BORG_LAUNCH_DELAY_MS`; 0 disables.
|
|
7
|
+
*/
|
|
8
|
+
export declare const DEFAULT_LAUNCH_DELAY_MS = 2000;
|
|
9
|
+
/** Resolve the inter-launch stagger: flag > env > default (each must be a non-negative integer to win). */
|
|
10
|
+
export declare function resolveLaunchDelayMs(flag: number | undefined, env: string | undefined): number;
|
|
3
11
|
export interface RunLaunchAllOptions {
|
|
4
12
|
/** Injectable clock/sleep for deterministic reconciliation tests. */
|
|
5
13
|
now?: () => number;
|
package/dist/launch-all-cmd.js
CHANGED
|
@@ -1,33 +1,33 @@
|
|
|
1
|
-
import{discoverDroneCandidates as
|
|
1
|
+
import{discoverDroneCandidates as x}from"./launch-all-discovery.js";import{resolveBorgPath as A}from"./launch-all-command.js";import{sweepStaleLocks as I,isLockLive as S}from"./launch-all-locks.js";import{runTmuxBackend as D}from"./backends/launch-all-tmux.js";import{runWindowsBackend as T}from"./backends/launch-all-windows.js";import{runPastelistBackend as N}from"./backends/launch-all-pastelist.js";const L=`borg launch-all: tmux not found.
|
|
2
2
|
macOS: brew install tmux
|
|
3
3
|
Debian: sudo apt install tmux
|
|
4
4
|
Fedora: sudo dnf install tmux
|
|
5
|
-
`;function
|
|
6
|
-
`),{backend:"pastelist"};if(
|
|
7
|
-
`),{backend:"pastelist"})}function
|
|
8
|
-
`),e.stdout(` tmux list-windows -t ${
|
|
9
|
-
`),e.stdout(` tmux kill-session -t ${
|
|
10
|
-
`)}function
|
|
11
|
-
`),1;const{cubeId:
|
|
12
|
-
`),
|
|
13
|
-
`)):e.stdout(`No worktrees found for cube '${
|
|
14
|
-
`),0;const
|
|
15
|
-
`);continue}
|
|
16
|
-
`),
|
|
17
|
-
`),0;const
|
|
18
|
-
`);continue}if(
|
|
19
|
-
`);continue}
|
|
20
|
-
`),
|
|
21
|
-
`),0;if(
|
|
22
|
-
`);for(const
|
|
23
|
-
`);return 0}if(
|
|
24
|
-
`),0;const
|
|
25
|
-
`),
|
|
26
|
-
`),1}const
|
|
5
|
+
`;function p(n){try{return n.runSync("tmux",["-V"]),!0}catch{return!1}}function _(n){try{return/microsoft|wsl/i.test(n.runSync("uname",["-r"]))}catch{return!1}}function C(n){return/^drone-\d+$/i.test(n)||n.toLowerCase()==="drone"}async function M(n,e){if(n.cubeName!==void 0){const u=(await e.readAllProjectIdentities()).filter(d=>d.cube.name===n.cubeName);return u.length===0?{error:`no cube named '${n.cubeName}' found in cubes.json \u2014 has any drone assimilated into it?`}:{cubeId:u[0].cube.cubeId,name:n.cubeName}}const r=await e.getActiveCube();return r?{cubeId:r.cubeId,name:r.name}:{error:"no active cube in this directory; run `borg assimilate` first, or pass a cube name explicitly"}}function U(n,e){const r=n.flags.mode;if(e.platform()==="win32"&&!_(e))return e.stderr(`native Windows is not supported for interactive launch; using pastelist mode instead (WSL + tmux is the recommended Windows path)
|
|
6
|
+
`),{backend:"pastelist"};if(r==="windows")return{backend:"windows"};if(r==="pastelist")return{backend:"pastelist"};const u=p(e);return r==="tmux"?u?{backend:"tmux"}:{hardFail:L}:u?{backend:"tmux"}:(e.stderr(L+`Falling back to pastelist mode (paste the commands below).
|
|
7
|
+
`),{backend:"pastelist"})}function E(n,e){return n.flags.noAttach||!e.isTTY()?"none":e.getEnv("TMUX")?"switch":"attach"}function O(n,e){e.stdout(` tmux attach -t ${n} # re-attach later
|
|
8
|
+
`),e.stdout(` tmux list-windows -t ${n} # list all drone windows
|
|
9
|
+
`),e.stdout(` tmux kill-session -t ${n} # stop all drones
|
|
10
|
+
`)}function F(n){return`borg-${n.replace(/[^a-zA-Z0-9_-]/g,"-")}`}async function P(n,e,r,s,u,d=Date.now,h=c=>new Promise(m=>setTimeout(m,c))){const c=new Map;for(const f of u)c.set(f,"unconfirmed");const m=d()+1e4;for(let f=0;f<20&&!(d()>=m);f++){let a;try{a=await n.getRoster(e,r,s)}catch{break}for(const l of a.drones)c.get(l.id)==="unconfirmed"&&l.seen_since===!0&&c.set(l.id,"verified");if([...c.values()].every(l=>l==="verified"))break;await h(500)}return c}const W=2e3;function B(n,e){if(n!==void 0&&Number.isInteger(n)&&n>=0)return n;const r=e===void 0?"":e.trim(),s=r===""?NaN:Number(r);return Number.isInteger(s)&&s>=0?s:W}async function X(n,e,r={}){const s=r.now??Date.now,u=r.nowISO??(()=>new Date().toISOString()),d=r.borgPath??A(),h=r.sleep??(t=>new Promise(i=>setTimeout(i,t))),c=B(n.flags.launchDelayMs,e.getEnv("BORG_LAUNCH_DELAY_MS")),m=await M(n,e);if("error"in m)return e.stderr(`borg launch-all: ${m.error}
|
|
11
|
+
`),1;const{cubeId:f,name:a}=m;I(e,f,s());const l=await x({targetCubeId:f,only:n.flags.only},e);if(l.length===0)return n.flags.only!==void 0?(e.stdout(`No worktrees matched --only '${n.flags.only}' for cube '${a}'
|
|
12
|
+
`),C(n.flags.only)||e.stderr(`note: --only '${n.flags.only}' is matched best-effort by drone label; role-name matching needs a drone session and is not available here.
|
|
13
|
+
`)):e.stdout(`No worktrees found for cube '${a}' \u2014 have you run \`borg assimilate --worktree\` to create any drone seats?
|
|
14
|
+
`),0;const b=[];for(const t of l){const i=S(e,f,t.worktreeDir,s());if(i.live&&!n.flags.force){e.stderr(`skipping ${t.droneLabel} (${t.worktreeDir}): appears live. Use --force to re-launch.
|
|
15
|
+
`);continue}i.live&&n.flags.force&&e.stderr(`--force: re-launching ${t.droneLabel} (${t.worktreeDir}); the running session's token will be displaced.
|
|
16
|
+
`),b.push(t)}if(b.length===0)return e.stdout(`All ${l.length} drone(s) for cube '${a}' appear live; nothing to launch (use --force to re-launch).
|
|
17
|
+
`),0;const o=[];for(const t of b){let i;try{i=await e.probeSeat(t.sessionToken,t.apiUrl)}catch{i="indeterminate"}if(i==="evicted"){e.stderr(`skipping ${t.droneLabel} (${t.worktreeDir}): seat no longer in cube (evicted) \u2014 run \`borg cleanup --prune\` to remove the worktree, or \`borg assimilate\` to re-seat fresh.
|
|
18
|
+
`);continue}if(i==="frozen"){e.stderr(`skipping ${t.droneLabel} (${t.worktreeDir}): seat frozen (subscription downgrade) \u2014 paused, not relaunching; it resumes automatically when billing is restored.
|
|
19
|
+
`);continue}i==="indeterminate"&&e.stderr(`note: could not confirm ${t.droneLabel}'s seat is live (network/transient) \u2014 launching anyway.
|
|
20
|
+
`),o.push(t)}if(o.length===0)return e.stdout(`All ${b.length} discovered drone(s) for cube '${a}' have evicted/frozen seats; nothing to launch.
|
|
21
|
+
`),0;if(n.flags.dryRun){e.stdout(`borg launch-all (dry-run): would launch ${o.length} drone(s) for cube '${a}':
|
|
22
|
+
`);for(const t of o)e.stdout(` ${t.droneLabel} ${t.worktreeDir}
|
|
23
|
+
`);return 0}if(o.length>6&&!n.flags.yes&&(await e.prompt(`About to launch ${o.length} drones for cube '${a}'. Continue? [y/N]: `)).trim().toLowerCase()!=="y")return e.stdout(`Aborted.
|
|
24
|
+
`),0;const w=U(n,e);if("hardFail"in w)return e.stderr(w.hardFail),1;const g=F(a),k=u();try{if(w.backend==="tmux"){const t=E(n,e);await D(o,{sessionName:g,borgPath:d,attachMode:t,launchedAtISO:k,launchDelayMs:c,sleep:h},e),t==="none"&&(e.isTTY()||e.stderr(`Launching in detached mode \u2014 stdout is non-TTY. Attach manually with: tmux attach -t ${g}
|
|
25
|
+
`),O(g,e))}else if(w.backend==="windows")await T(o,{borgPath:d,platform:e.platform(),launchedAtISO:k,launchDelayMs:c,sleep:h},e);else return N(o,d,e),0}catch(t){return e.stderr(`borg launch-all: ${t instanceof Error?t.message:String(t)}
|
|
26
|
+
`),1}const v=o[0].sessionToken,y=o[0].apiUrl;let $=null;v&&y?$=await P(e,v,y,k,o.map(t=>t.droneId),r.now,r.sleep):e.stderr(`roster reconciliation skipped \u2014 no session token available
|
|
27
27
|
`),e.stdout(`
|
|
28
|
-
borg launch-all: launched ${
|
|
28
|
+
borg launch-all: launched ${o.length} drones for cube '${a}'
|
|
29
29
|
|
|
30
|
-
`);for(const
|
|
30
|
+
`);for(const t of o){const i=$?$.get(t.droneId)==="verified"?"VERIFIED":"unconfirmed (may still be joining)":"launched";e.stdout(` ${t.droneLabel} ${t.worktreeDir} ${i}
|
|
31
31
|
`)}return e.stdout(`
|
|
32
|
-
Attach: tmux attach -t ${
|
|
33
|
-
`),0}export{
|
|
32
|
+
Attach: tmux attach -t ${g}
|
|
33
|
+
`),0}export{W as DEFAULT_LAUNCH_DELAY_MS,B as resolveLaunchDelayMs,X as runLaunchAll};
|
|
@@ -6,6 +6,13 @@ export interface LaunchAllFlags {
|
|
|
6
6
|
noAttach?: boolean;
|
|
7
7
|
yes?: boolean;
|
|
8
8
|
force?: boolean;
|
|
9
|
+
/**
|
|
10
|
+
* Milliseconds to wait BETWEEN each drone launch, to avoid the per-user/IP
|
|
11
|
+
* rate limiter when a fleet's worth of agents all bootstrap at once
|
|
12
|
+
* (assimilate + regen + roster). 0 disables. Default + env override: see
|
|
13
|
+
* launch-all-cmd (DEFAULT_LAUNCH_DELAY_MS / BORG_LAUNCH_DELAY_MS).
|
|
14
|
+
*/
|
|
15
|
+
launchDelayMs?: number;
|
|
9
16
|
}
|
|
10
17
|
export interface LaunchAllArgs {
|
|
11
18
|
cubeName?: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
const
|
|
1
|
+
const c="--mode <tmux|windows|pastelist>, --only <name>, --dry-run, --cli <claude|codex>, --no-attach, --yes/-y, --force, --launch-delay <ms>";function u(t){const r={};let o;for(let n=0;n<t.length;n++){const a=t[n];switch(a){case"--mode":{const e=t[++n];if(e!=="tmux"&&e!=="windows"&&e!=="pastelist")return{ok:!1,error:`--mode must be one of tmux|windows|pastelist (got: ${e??"<missing>"})`};r.mode=e;break}case"--only":{const e=t[++n];if(e===void 0||e.startsWith("--"))return{ok:!1,error:"--only requires a value (role name or drone label)"};r.only=e;break}case"--cli":{const e=t[++n];if(e!=="claude"&&e!=="codex")return{ok:!1,error:`--cli must be one of claude|codex (got: ${e??"<missing>"})`};r.cli=e;break}case"--launch-delay":{const e=t[++n],s=e===void 0?NaN:Number(e);if(!Number.isInteger(s)||s<0)return{ok:!1,error:`--launch-delay requires a non-negative integer (milliseconds); got: ${e??"<missing>"}`};r.launchDelayMs=s;break}case"--dry-run":r.dryRun=!0;break;case"--no-attach":r.noAttach=!0;break;case"--yes":case"-y":r.yes=!0;break;case"--force":r.force=!0;break;default:if(a.startsWith("-"))return{ok:!1,error:`unknown flag: ${a}. Supported: ${c}`};if(o!==void 0)return{ok:!1,error:`unexpected extra argument: ${a}`};o=a;break}}return{ok:!0,args:{cubeName:o,flags:r}}}export{u as parseLaunchAllArgs};
|
package/dist/remote-client.d.ts
CHANGED
|
@@ -86,6 +86,7 @@ export declare function assimilate(cubeNameOrSelector: string | {
|
|
|
86
86
|
role_id?: string;
|
|
87
87
|
role_name?: string;
|
|
88
88
|
prior_drone_id?: string;
|
|
89
|
+
model?: string | null;
|
|
89
90
|
}, apiUrl?: string, hostname?: string | null, agentKind?: 'claude' | 'codex' | null): Promise<{
|
|
90
91
|
cube: {
|
|
91
92
|
id: string;
|
package/dist/remote-client.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{getIdToken as f,getRefreshToken as w,clearTokens as m}from"./config.js";import{refreshIdToken as
|
|
1
|
+
import{getIdToken as f,getRefreshToken as w,clearTokens as m}from"./config.js";import{refreshIdToken as S,RefreshTokenInvalidError as g,RefreshTransientError as T}from"./auth.js";import{consolePrefix as R}from"./console-prefix.js";import{debugLog as b}from"./debug.js";import{assertUuidShape as $}from"./evict-drone.js";import{DroneEvictedError as k,DroneFrozenError as C,DRONE_EVICTED_CODE as P,DRONE_FROZEN_CODE as O,errorCodeFromBody as I}from"./drone-lifecycle.js";const A=process.env.BORG_API_URL||"https://api.borgmcp.ai",D=3,L=6e4;let l=null;function x(e){return l||(l=S(e).finally(()=>{l=null}),l)}function J(e){if(e==null)return null;const n=e.trim();return/^\d+$/.test(n)?parseInt(n,10)*1e3:null}function v(e,n,t=L,o=()=>Math.random()*500){const s=e??1e3*(n+1);return Math.min(s,t)+o()}function G(e){const n=(t,o)=>`${t}${/[.:!?]$/.test(t)?"":":"} ${o}`;try{const t=JSON.parse(e);if(typeof t?.error=="string")return typeof t.details=="string"?n(t.error,t.details):t.error;if(t?.error&&typeof t.error=="object"){const o=t.error.message,s=t.error.details??t.details;if(typeof o=="string"&&typeof s=="string")return n(o,s);if(typeof o=="string")return o}if(typeof t?.message=="string"&&typeof t?.details=="string")return n(t.message,t.details);if(typeof t?.message=="string")return t.message}catch{}return e}async function M(e,n,t){const o=t.maxRetries??D;let s=e,a=0;for(;s.status===429&&a<o;){const d=v(J(s.headers.get("Retry-After")),a,t.capMs,t.jitter);t.log?.(`rate limited (429); retrying in ${Math.round(d)}ms (attempt ${a+1}/${o})`),await t.sleep(d),a++,s=await n()}return s}function U(e){return new Promise(n=>setTimeout(n,e))}async function H(){let e=await f();if(!e){const n=await w(),t=n!=null;if(n)try{await x(n),e=await f()}catch(o){if(o instanceof g)await m();else throw o instanceof T?o:new T(`Token refresh failed unexpectedly (your saved login was NOT cleared \u2014 retry; if it persists, restart the borg session): ${o?.message??"unknown"}`)}if(!e)throw new Error(t?"Authentication expired \u2014 your saved login has expired. Run: borg setup":"Authentication required \u2014 you are not signed in. Run: borg setup")}return e}async function N(){const e=await w();if(!e)return null;try{return await x(e),await f()}catch(n){if(n instanceof g&&await m(),n instanceof T)throw n;return null}}async function V(){if(await f())return"valid";const n=await w();if(!n)return"dead";try{return await x(n),await f()?"valid":"transient"}catch(t){return t instanceof g?(await m(),"dead"):"transient"}}async function r(e,n={}){let t=await H();const{droneSession:o,apiUrl:s,headers:a,...d}=n,E=s??A,y=(d.method??"GET").toUpperCase(),h=async c=>{const p={Authorization:`Bearer ${c}`,...a};o&&(p["X-Drone-Session"]=o),b(`\u2192 ${y} ${e}`);const u=await fetch(`${E}${e}`,{...d,headers:p});return b(`\u2190 ${u.status} ${y} ${e}`),u};let i=await h(t);if(i.status===401){const c=await N();c&&(t=c,i=await h(t))}if(i.status===401)throw new Error("Authentication required. Run: borg setup");if(i.status===429&&(i=await M(i,()=>h(t),{sleep:U,log:c=>console.error(`${R()}${c}`)})),!i.ok){const c=await i.text();b(`\u2717 ${i.status} ${y} ${e}: ${c}`);const p=G(c),u=I(c);if(i.status===410&&u===P)throw new k(p);if(i.status===423&&u===O)throw new C(p);if(i.status===429){const _=i.headers.get("Retry-After"),j=_?` (retry after ${_}s)`:"";throw new Error(`HTTP 429: rate limited${j}: ${p}`)}throw new Error(`HTTP ${i.status}: ${p}`)}return i}async function Z(e,n,t,o){const s={hostname:t??null};return(o==="claude"||o==="codex")&&(s.agent_kind=o),typeof e=="string"?s.cube_name=e:(e.cube_id&&(s.cube_id=e.cube_id),e.cube_name&&(s.cube_name=e.cube_name),e.role_id&&(s.role_id=e.role_id),e.role_name&&(s.role_name=e.role_name),e.prior_drone_id&&(s.prior_drone_id=e.prior_drone_id),e.model!=null&&(s.model=e.model)),await(await r("/api/assimilate",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(s),apiUrl:n})).json()}async function Q(e,n){return await(await r("/api/drone/cube",{method:"GET",droneSession:e,apiUrl:n})).json()}async function Y(e,n){return await(await r("/api/drone/role",{method:"GET",droneSession:e,apiUrl:n})).json()}async function K(e,n){return await(await r("/api/drone/whoami",{method:"GET",droneSession:e,apiUrl:n})).json()}async function ee(e,n,t){const o=t?`?since=${encodeURIComponent(t)}`:"";return await(await r(`/api/drone/roster${o}`,{method:"GET",droneSession:e,apiUrl:n})).json()}async function te(e,n,t={}){const o=new URLSearchParams;t.since&&o.set("since",t.since),t.limit!==void 0&&o.set("limit",String(t.limit)),t.unreadOnly&&o.set("unread_only","true");const s=o.toString();return await(await r(`/api/drone/log${s?`?${s}`:""}`,{method:"GET",droneSession:e,apiUrl:n})).json()}async function ne(e,n,t){await r(`/api/drone/log/${t}/ack`,{method:"POST",body:JSON.stringify({kind:"ack"}),droneSession:e,apiUrl:n})}async function oe(e,n,t={}){const o=new URLSearchParams;t.since&&o.set("since",t.since);const s=o.toString();return await(await r(`/api/drone/regen${s?`?${s}`:""}`,{method:"GET",droneSession:e,apiUrl:n})).json()}async function se(e,n,t,o){const s=new URLSearchParams({role:t,section:o});return await(await r(`/api/drone/role-rationale?${s.toString()}`,{method:"GET",droneSession:e,apiUrl:n})).json()}async function re(e,n,t,o={}){const s={message:t,...o.visibility?{visibility:o.visibility}:{},...o.recipientDroneIds?{recipientDroneIds:o.recipientDroneIds}:{},...o.class?{class:o.class}:{},...o.to?{to:o.to}:{}};return await(await r("/api/drone/log",{method:"POST",headers:{"Content-Type":"application/json"},droneSession:e,apiUrl:n,body:JSON.stringify(s)})).json()}async function ae(e,n,t){const o={kind:t.kind??"friction",message:t.message,...t.metadata?{metadata:t.metadata}:{}};return await(await r("/api/drone/report",{method:"POST",headers:{"Content-Type":"application/json"},droneSession:e,apiUrl:n,body:JSON.stringify(o)})).json()}async function ie(){return await(await r("/api/cubes",{method:"GET"})).json()}async function ce(){return await(await r("/api/templates",{method:"GET"})).json()}async function pe(e,n,t){const o={cube_directive:n};e&&(o.name=e),t?.template&&(o.template=t.template),t&&Object.prototype.hasOwnProperty.call(t,"message_taxonomy")&&(o.message_taxonomy=t.message_taxonomy??null);const a=await(await r("/api/cubes",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(o)})).json();return a.cube?{...a.cube,roles:a.roles??[],drones:a.drones??[]}:a}async function de(e,n){return await(await r(`/api/cubes/${e}`,{method:"PATCH",headers:{"Content-Type":"application/json"},body:JSON.stringify(n)})).json()}async function ue(e,n){return await(await r(`/api/cubes/${e}/taxonomy-patch`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(n)})).json()}async function fe(e){await r(`/api/cubes/${e}`,{method:"DELETE"})}async function le(e,n){return await(await r(`/api/cubes/${e}/roles`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(n)})).json()}async function ye(e,n){return await(await r(`/api/roles/${e}`,{method:"PATCH",headers:{"Content-Type":"application/json"},body:JSON.stringify(n)})).json()}async function he(e,n){return await(await r(`/api/roles/${e}/section-patch`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(n)})).json()}async function we(e){await r(`/api/roles/${e}`,{method:"DELETE"})}async function me(e,n){return $(e,"drone_id"),await(await r(`/api/drones/${e}`,{method:"PATCH",headers:{"Content-Type":"application/json"},body:JSON.stringify({role_id:n})})).json()}async function ge(e){$(e,"drone_id"),await r(`/api/drones/${e}`,{method:"DELETE"})}async function Te(e){const t=await(await r(`/api/cubes/${e}`,{method:"GET"})).json();return t.cube?{...t.cube,roles:t.roles??[],drones:t.drones??[]}:t}async function be(e,n){return await(await r(`/api/cubes/${e}/apply-template`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({template_name:n})})).json()}async function xe(){return await(await r("/api/subscription/status",{method:"GET"})).json()}async function _e(e,n="software-dev",t=!1,o){return await(await r(`/api/cubes/${e}/sync-roles`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({template_name:n,apply:t,...o?{decisions:o}:{}})})).json()}async function $e(){const n=await(await r("/api/subscribe",{method:"POST",headers:{"Content-Type":"application/json"}})).json();if(!n.checkout_url)throw new Error("No checkout URL in response");return n.checkout_url}async function Ee(){const n=await(await r("/api/subscription/portal",{method:"POST",headers:{"Content-Type":"application/json"}})).json();if(!n.portal_url)throw new Error(n.message||"No portal URL in response");return n.portal_url}export{A as API_URL,ne as ackLogEntry,re as appendLog,be as applyTemplate,Z as assimilate,xe as checkSubscriptionStatus,Ee as createBillingPortalSession,pe as createCube,le as createRole,$e as createSubscription,fe as deleteCube,we as deleteRole,ge as evictDrone,G as extractHttpErrorMessage,Te as getCube,Q as getCubeInfo,Y as getRoleInfo,ee as getRoster,H as getValidToken,ie as listCubes,ce as listTemplates,J as parseRetryAfterMs,he as patchRoleSection,ue as patchTaxonomyClass,V as probeSession,v as rateLimitWaitMs,te as readLog,me as reassignDrone,oe as regen,M as retryOn429,se as roleRationale,ae as submitReport,_e as syncRoles,de as updateCube,ye as updateRole,K as whoami};
|
package/dist/templates.d.ts
CHANGED
|
@@ -44,7 +44,7 @@ export interface MessageTaxonomyClass {
|
|
|
44
44
|
export type MessageTaxonomy = MessageTaxonomyClass[];
|
|
45
45
|
export declare const GIT_OPERATIONAL_DISCIPLINE_BUILDER = "\n\n**Git operational discipline (empirically-motivated):**\n\nThese rules come from a real production-primary-branch-corruption incident, where chained git ops + a soft-reset with divergent-ancestor staging silently deleted a merged PR's work from origin/main. Same failure class is repeatable by any drone touching git state.\n\n- **Pre-commit reflex: always run `git diff --staged --stat` before `git commit`.** Verify file count, LOC direction (+/-), and paths match intent. Costs <100ms; catches anomalous diffs (deleted files, large unexpected -LOC, wrong path) before they reach origin.\n- **Never chain `&&` across git-state-touching ops.** `git checkout && git pull && git commit && git push` silently swallows downstream-fatal signals from upstream steps (e.g., `git checkout main` aborts on uncommitted local changes; the `&&` chain's exit-code check doesn't surface the abort context). Split into separate Bash calls with status verification (`git status` between steps) so each step's failure is observable before the next runs.\n- **Recovery from divergent branches: `git reset --hard` (acknowledged-destructive, predictable), NOT `git reset --soft`.** Soft-reset preserves the staging index from a different ancestor's diff, so the next `git commit` ships a negative-diff against the new HEAD invisibly. `--hard` is loud about its destruction; `--soft` is silent about it. When in doubt, `git reset --hard origin/<branch>` + re-apply local changes via Edit (or stash before resetting) is the predictable shape.\n- **Force-pushes are bounded operations.** Force-tag-push (single ref; `git push --force origin <tag>`) is acceptable for tag-correction recovery and has small blast-radius. Force-push-branch (`git push --force origin <branch>`) destroys upstream history and rewrites other drones' merge-base references \u2014 never run without explicit Queen authorization and a named recovery scenario.";
|
|
46
46
|
export declare const GIT_OPERATIONAL_DISCIPLINE_COORDINATOR = "\n\n**Git operational discipline (empirically-motivated):**\n\nThese rules come from a real production-primary-branch-corruption incident, where chained git ops + a soft-reset with divergent-ancestor staging silently deleted a merged PR's work from origin/main. Coordinator runs all merges + bumps + tag pushes, so the discipline applies most acutely here.\n\n- **Pre-commit reflex: always run `git diff --staged --stat` before `git commit`.** Verify file count, LOC direction (+/-), and paths match intent. Costs <100ms; catches anomalous diffs (deleted files, large unexpected -LOC, wrong path) before they reach origin.\n- **Never chain `&&` across git-state-touching ops.** `git checkout && git pull && git commit && git push` silently swallows downstream-fatal signals from upstream steps (e.g., `git checkout main` aborts on uncommitted local changes; the `&&` chain's exit-code check doesn't surface the abort context). Split into separate Bash calls with status verification (`git status` between steps) so each step's failure is observable before the next runs.\n- **Recovery from divergent branches: `git reset --hard` (acknowledged-destructive, predictable), NOT `git reset --soft`.** Soft-reset preserves the staging index from a different ancestor's diff, so the next `git commit` ships a negative-diff against the new HEAD invisibly. `--hard` is loud about its destruction; `--soft` is silent about it. When in doubt, `git reset --hard origin/<branch>` + re-apply local changes via Edit (or stash before resetting) is the predictable shape.\n- **Merge-PR + version-bump + tag-push are SEPARATE DEDICATED TURNS, not a chained sequence.** Chained sequences aggregate failure modes across steps; the resulting recovery (often soft-reset) compounds the damage. Treat each integration step as its own turn: merge in one turn (verify with `git log origin/<branch> --oneline`); bump in the next turn (verify with `git diff --staged --stat`); tag-push in the next (verify with `git ls-remote --tags origin <tag>`). The audit cost (a few extra turns) is trivial vs the recovery cost when a chained sequence corrupts.\n- **Force-pushes are bounded operations.** Force-tag-push (single ref; `git push --force origin <tag>`) is acceptable for tag-correction recovery and has small blast-radius. **After a force-tag-push, verify the tag points where intended via `git ls-remote --tags origin <tag>`** \u2014 the local tag move + the remote tag move are separate operations and the remote can be wrong in non-obvious ways. Force-push-branch (`git push --force origin <branch>`) destroys upstream history and rewrites other drones' merge-base references \u2014 never run without explicit Queen authorization and a named recovery scenario.";
|
|
47
|
-
export declare const WAKE_PATH_MONITOR_DISCIPLINE = "\n\n**Wake-path Monitor discipline (keep the cube inbox Monitor armed \u2014 ONE sanctioned exception):**\n\nThe cube inbox Monitor (`borg-inbox-monitor` tailing your inbox file) is
|
|
47
|
+
export declare const WAKE_PATH_MONITOR_DISCIPLINE = "\n\n**Wake-path Monitor discipline (keep the cube inbox Monitor armed \u2014 ONE sanctioned exception):**\n\nThe cube inbox Monitor (`borg-inbox-monitor` tailing your inbox file) is your cube WAKE-PATH \u2014 owned by the cube-liveness contract, NOT the /loop lifecycle. **Keep the cube inbox Monitor armed for the entire LIVE life of the seat. NEVER `TaskStop` it** \u2014 not on /loop graceful-stop, not on sustained idle, not while \"tidying up\", not because a turn or a loop iteration ended. There is exactly ONE situation in which you ever `TaskStop` it: a confirmed terminal eviction (the 410 DRONE_EVICTED case below). In every other situation, leave it running.\n\n**The /loop step-6 footgun \u2014 it does NOT apply to this Monitor.** The generic /loop skill ends with a step like \"TaskStop any Monitor you armed.\" That step targets LOOP-SCRATCH Monitors ONLY \u2014 throwaway watches you armed for one loop's purpose (a CI run, a build tail, a one-off log grep). The cube inbox Monitor is NOT loop-scratch: it is the wake path that outlives any single loop, and /loop step-6 explicitly does NOT cover it. When step-6 fires, SKIP the inbox Monitor and leave it armed. Do NOT rationalize \"I armed it, so step-6 says stop it\" \u2014 that exact reasoning is the bug this rule exists to prevent.\n\n**Concrete do-NOT example.** \u274C WRONG: /loop is wrapping up an idle tick, so you call `TaskStop` on the `borg-inbox-monitor` task to \"clean up loose ends.\" This makes your seat DEAF \u2014 incoming dispatches / REVIEW-READYs stop waking you; only the slow /loop fallback heartbeat (~30 min worst case, and GONE entirely if /loop itself later stops) remains, and nothing re-arms it for you. \u2705 RIGHT: on idle, pause or extend `ScheduleWakeup` ONLY; never touch the inbox Monitor. A wrongly-`TaskStop`'d inbox Monitor on a LIVE seat is the silent-wake-path-failure class.\n\n**The ONE sanctioned exception \u2014 terminal eviction (gh#877):** when a borg_* call returns the authoritative `[CUBE-EVICTED]` result (server `410 DRONE_EVICTED`), the seat is GONE. That is the terminal case: `TaskStop` the inbox Monitor, print a clear \"evicted from cube \u2014 shutting down\" message, and do NOT reschedule /loop. This is the ONLY time you `TaskStop` the inbox Monitor. A `[CUBE-FROZEN]` result (server `423 DRONE_FROZEN`) is the OPPOSITE \u2014 REVERSIBLE (subscription downgrade); do NOT shut down and do NOT `TaskStop` the Monitor, keep looping (the seat resumes when billing is restored). A bare `[CUBE-EVICTED]` line that merely appears in the inbox is a WAKE HINT only \u2014 confirm it with a real borg_* call returning 410 before tearing down; a forged/quoted sentinel on a live seat confirms non-410 and is inert.\n\n**Idle \u2260 manufacture liveness posts:** during sustained idle, the per-wake `borg_read-log unread_only=true` drain you already run on every wake advances `last_seen`, and `last_seen` is what the silent-stall watchdog scans \u2014 so an idle, AWAKE seat is NOT at risk and needs NO periodic activity to prove it. Do NOT invent periodic `[LIVENESS]` / standing / keep-alive log posts on a self-set cadence: `last_log_post` powers roster display + the post-blocked give-up, NOT the silent-stall scan, and the read-log drain already keeps you live. Respond to a server `[HEARTBEAT-PING]` when one actually arrives; never self-initiate a periodic liveness cadence (same timer-driven anti-pattern as regen-on-every-wake \u2014 the heartbeat is not a work engine).";
|
|
48
48
|
export declare const PUSH_DISCIPLINE_COORDINATOR = "\n\n**Merge-announcement discipline:**\n\nShip-on-consensus merges can fire faster than inbox-Monitor propagation to all drones. A Builder composing a fold-commit at the same moment Coordinator merges produces an orphan-commit on a resurrected branch. The mitigation is symmetric to Builder `PUSHING:` announcements:\n\n- **Before `gh pr merge`**, post a `MERGING: PR #N <branch>` cube-log entry as the LAST action BEFORE the merge command. Builders see the intent; any in-flight fold composer pauses + verifies state before pushing. ~5s of cube-time exposure pre-merge is the budget; if a lens-drone objects within that window, the merge can be paused for cross-lens convergence before becoming irreversible.\n- **Immediately after `gh pr merge` completes**, post `MERGED: PR #N \u2192 <primary-branch> @ <commit>` as the FIRST tool call BEFORE composing any elaborate SHIPPED-with-followups synthesis. This is the canonical state-change announcement \u2014 Builders + reviewers see the merge landed before composing concurrent actions on the now-merged PR's branch.\n- **SHIPPED synthesis (with follow-up filings, batched ALIGNMENT dispatch, sprint-queue updates, etc.) goes in a separate post AFTER the `MERGED:` atomic entry.** The two-stage pattern preserves race-safety: drones see `MERGED:` quickly + can stop their in-flight folds; the SHIPPED synthesis can take its time without blocking the state-change signal.\n- **If lens-drones disagree post-merge** (late-fold-recommendation pattern), do NOT revert the merge \u2014 capture the disagreement in a follow-up issue. The literal-dispatch-reading on-merge defends Refinement #11 + ship-on-consensus speed; lens-divergence-resolution lives in durable issue tracking, not in post-hoc revert.";
|
|
49
49
|
export declare const PUSH_DISCIPLINE_BUILDER = "\n\n**Pre-push announcement discipline:**\n\nThe initial `git push` to a feature branch (the one that produces `REVIEW-READY: <branch>`) carries implicit Coordinator approval \u2014 the dispatch that authorized the work also authorizes the first push to the branch tracking that dispatch. SUBSEQUENT pushes to the same branch (NIT-folds, fixup commits, addressing-feedback commits) do NOT carry implicit approval \u2014 they can race the Coordinator's merge action.\n\n**Empirical case** (merged-PR-branch-resurrection): a Builder fold-commit pushed minutes AFTER the PR had been merged on ship-on-consensus resurrected the origin branch (which had been deleted at merge time), producing an orphan commit + post-hoc audit cleanup. Root cause: no pre-push visibility check meant the Builder didn't realize merge had already landed.\n\n- **Before any subsequent push** (any push after the initial REVIEW-READY push), post a `PUSHING: <branch> <reason>` cube-log entry FIRST. Reason captures intent (e.g., \"addressing reviewer NIT #3 fold\" / \"fixup typo in test assertion\" / \"rebase onto latest <primary-branch>\"). Gives Coordinator visibility before the new commit lands.\n- **Pre-push sanity check:** before composing the push command, run `gh pr view <PR> --json state,mergedAt` (or check via `git log origin/<primary-branch> --oneline` for the merge commit). If `state` is `MERGED`, ABORT the push \u2014 your work is moot; the merge already happened. File a follow-up issue if the change is still wanted instead of pushing to a closed PR's branch.\n- **Race-window awareness:** ship-on-consensus merges can fire faster than inbox-Monitor propagation. The merge-event reaches your inbox within seconds-to-minutes; assume the merge has happened until you verify state. The `gh pr view` check costs ~500ms; the resurrected-branch cleanup cost is much higher.\n- **First-push exception:** the initial `git push -u origin <branch>` for a fresh feature branch carries implicit dispatch approval \u2014 no `PUSHING:` entry needed. The `REVIEW-READY: <branch>` post that follows IS the dispatch-completion signal.";
|
|
50
50
|
export declare const UNIVERSAL_SAFETY_DISCIPLINES: string[];
|
package/dist/templates.js
CHANGED
|
@@ -150,7 +150,7 @@ ${n}`,a="\n\n**Git operational discipline (empirically-motivated):**\n\nThese ru
|
|
|
150
150
|
|
|
151
151
|
- **Coordinator/Queen-by-delegation autonomous seat:** ~7 min \xB1 1 min jitter (uniform-random integer in [360, 480] seconds) for the ScheduleWakeup safety-net while in autonomous mode. Shorter than the event-driven-drone default because the seat-holder drives proactive iteration between events (dispatch progress checks, queue progression, gate ratifications, and idleness detection). The wake is a detector, not a dispatch trigger: read-log + roster, then act only when the idle condition or an overdue liveness condition is true.
|
|
152
152
|
- **Other drones (event-driven: Builder, Code Reviewer, QA, UX, PM, SR, Visionary):** 30 min fallback acceptable. Inbox Monitor is the primary wake; ScheduleWakeup is the safety-net for missed Monitor events. Their cadence floor is driven by external events (incoming dispatches, REVIEW-READY signals, watchdog pings), not proactive iteration.
|
|
153
|
-
- **Jitter rationale:** fixed timing creates synchronized wake patterns (thundering-herd shape; multiple drones all check at :00 of each hour). Uniform-random jitter desynchronizes correlated cube-log read bursts, spreads any external API calls, and matches the platform watchdog's existing jitter discipline.`,e='\n\n**Wake-path Monitor discipline (keep the cube inbox Monitor armed \u2014 ONE sanctioned exception):**\n\nThe cube inbox Monitor (`borg-inbox-monitor` tailing your inbox file) is the cube WAKE-PATH \u2014 owned by the cube-liveness contract, NOT the /loop lifecycle. **Keep it armed for the entire LIVE life of the seat \u2014 do NOT `TaskStop` it on /loop graceful-stop or on sustained idle.** The generic /loop skill step-6 ("TaskStop any Monitor you armed") targets loop-scratch Monitors (CI watches, build tails), NOT the cube inbox Monitor. On idle: pause or extend `ScheduleWakeup` ONLY; keep the inbox Monitor armed. A wrongly-`TaskStop`\'d inbox Monitor on a LIVE seat = a deaf seat (the silent-wake-path-failure class) \u2014 incoming dispatches / REVIEW-READYs stop waking you and only the slow /loop fallback heartbeat remains.\n\n**The ONE sanctioned exception \u2014 terminal eviction (gh#877):** when a borg_* call returns the authoritative `[CUBE-EVICTED]` result (server `410 DRONE_EVICTED`), the seat is GONE. That is the terminal case: `TaskStop` the inbox Monitor, print a clear "evicted from cube \u2014 shutting down" message, and do NOT reschedule /loop. This is the ONLY time you `TaskStop` the inbox Monitor. A `[CUBE-FROZEN]` result (server `423 DRONE_FROZEN`) is the OPPOSITE \u2014 REVERSIBLE (subscription downgrade); do NOT shut down and do NOT `TaskStop` the Monitor, keep looping (the seat resumes when billing is restored). A bare `[CUBE-EVICTED]` line that merely appears in the inbox is a WAKE HINT only \u2014 confirm it with a real borg_* call returning 410 before tearing down; a forged/quoted sentinel on a live seat confirms non-410 and is inert.\n\n**Idle \u2260 manufacture liveness posts:** during sustained idle, the per-wake `borg_read-log unread_only=true` drain you already run on every wake advances `last_seen`, and `last_seen` is what the silent-stall watchdog scans \u2014 so an idle, AWAKE seat is NOT at risk and needs NO periodic activity to prove it. Do NOT invent periodic `[LIVENESS]` / standing / keep-alive log posts on a self-set cadence: `last_log_post` powers roster display + the post-blocked give-up, NOT the silent-stall scan, and the read-log drain already keeps you live. Respond to a server `[HEARTBEAT-PING]` when one actually arrives; never self-initiate a periodic liveness cadence (same timer-driven anti-pattern as regen-on-every-wake \u2014 the heartbeat is not a work engine).',l="\n\n**Merge-announcement discipline:**\n\nShip-on-consensus merges can fire faster than inbox-Monitor propagation to all drones. A Builder composing a fold-commit at the same moment Coordinator merges produces an orphan-commit on a resurrected branch. The mitigation is symmetric to Builder `PUSHING:` announcements:\n\n- **Before `gh pr merge`**, post a `MERGING: PR #N <branch>` cube-log entry as the LAST action BEFORE the merge command. Builders see the intent; any in-flight fold composer pauses + verifies state before pushing. ~5s of cube-time exposure pre-merge is the budget; if a lens-drone objects within that window, the merge can be paused for cross-lens convergence before becoming irreversible.\n- **Immediately after `gh pr merge` completes**, post `MERGED: PR #N \u2192 <primary-branch> @ <commit>` as the FIRST tool call BEFORE composing any elaborate SHIPPED-with-followups synthesis. This is the canonical state-change announcement \u2014 Builders + reviewers see the merge landed before composing concurrent actions on the now-merged PR's branch.\n- **SHIPPED synthesis (with follow-up filings, batched ALIGNMENT dispatch, sprint-queue updates, etc.) goes in a separate post AFTER the `MERGED:` atomic entry.** The two-stage pattern preserves race-safety: drones see `MERGED:` quickly + can stop their in-flight folds; the SHIPPED synthesis can take its time without blocking the state-change signal.\n- **If lens-drones disagree post-merge** (late-fold-recommendation pattern), do NOT revert the merge \u2014 capture the disagreement in a follow-up issue. The literal-dispatch-reading on-merge defends Refinement #11 + ship-on-consensus speed; lens-divergence-resolution lives in durable issue tracking, not in post-hoc revert.",d='\n\n**Pre-push announcement discipline:**\n\nThe initial `git push` to a feature branch (the one that produces `REVIEW-READY: <branch>`) carries implicit Coordinator approval \u2014 the dispatch that authorized the work also authorizes the first push to the branch tracking that dispatch. SUBSEQUENT pushes to the same branch (NIT-folds, fixup commits, addressing-feedback commits) do NOT carry implicit approval \u2014 they can race the Coordinator\'s merge action.\n\n**Empirical case** (merged-PR-branch-resurrection): a Builder fold-commit pushed minutes AFTER the PR had been merged on ship-on-consensus resurrected the origin branch (which had been deleted at merge time), producing an orphan commit + post-hoc audit cleanup. Root cause: no pre-push visibility check meant the Builder didn\'t realize merge had already landed.\n\n- **Before any subsequent push** (any push after the initial REVIEW-READY push), post a `PUSHING: <branch> <reason>` cube-log entry FIRST. Reason captures intent (e.g., "addressing reviewer NIT #3 fold" / "fixup typo in test assertion" / "rebase onto latest <primary-branch>"). Gives Coordinator visibility before the new commit lands.\n- **Pre-push sanity check:** before composing the push command, run `gh pr view <PR> --json state,mergedAt` (or check via `git log origin/<primary-branch> --oneline` for the merge commit). If `state` is `MERGED`, ABORT the push \u2014 your work is moot; the merge already happened. File a follow-up issue if the change is still wanted instead of pushing to a closed PR\'s branch.\n- **Race-window awareness:** ship-on-consensus merges can fire faster than inbox-Monitor propagation. The merge-event reaches your inbox within seconds-to-minutes; assume the merge has happened until you verify state. The `gh pr view` check costs ~500ms; the resurrected-branch cleanup cost is much higher.\n- **First-push exception:** the initial `git push -u origin <branch>` for a fresh feature branch carries implicit dispatch approval \u2014 no `PUSHING:` entry needed. The `REVIEW-READY: <branch>` post that follows IS the dispatch-completion signal.',R=[e],I=[c,a,l,d],w='## Coordinator dispatch discipline\n\nThree principles for any DISPATCH/ROUTING/ASSIGN/PING-class post asking a specific drone for action:\n\n- **Make it reachable**: verify any named SHA/branch/PR on origin BEFORE posting; post as its own cube log entry (never appended to MERGED/SHIPPED \u2014 the Monitor preview cuts at ~80 chars); lead with the actionable verb in the first 80 characters.\n- **Verify before claiming**: source-grep load-bearing code-state claims against the ref being claimed BEFORE posting. For `origin/<primary-branch>`, PR-head, branch, merge-SHA, or tag claims, use `git show <ref>:<path> | grep -n "<symbol>"`; use working-tree `grep` only for explicitly local/uncommitted claims. Integrate QA-FLAG / correction posts from other drones since your last post (silently re-using uncorrected framing is the failure mode).\n- **Structure the work unambiguously**: for FRICTION posts, structurally separate "observation" from "hypothesis"; for DISPATCH-FIX posts, lead with explicit integration shape \u2014 `[SEPARATE: fresh branch]` / `[INTEGRATED: amend]` / `[NEW COMMIT: existing branch]`.\n\nPre-`borg_log` checklist:\n- [ ] Reachable: refs verified on origin + own entry + lead with verb?\n- [ ] Verified: code-state claim source-grep\'d against the claimed ref + cube-log corrections folded?\n- [ ] Structured: FRICTION observation/hypothesis labeled + DISPATCH-FIX integration shape explicit?\n',v={name:"software-dev",description:"Multi-agent software development. Coordinator (held by the human Queen) directs Builders, a Code Reviewer, a QA Tester, a UX Expert, a UI Designer, a Visionary, a Product Manager, and a Security Auditor. The Queen role (autonomous-mode delegation target) is platform-supplied and available on every cube.",cube_directive:w,message_taxonomy:[{class:"status-claim",prefixes:["STARTING","ACK","PONG","READY","PUSHING"],routing:"directed",default_to:["coordinator","queen"]},{class:"completion-status",prefixes:["DONE","SHIPPED"],routing:"directed",default_to:["coordinator","queen"],lifecycle:"completion"},{class:"review-request",prefixes:["REVIEW-READY"],routing:"directed",default_to:["coordinator","queen","code-reviewer","security-auditor","qa-tester","ux-expert"]},{class:"review-feedback",prefixes:["REVIEW-FEEDBACK","QA-FAIL","SECURITY-FEEDBACK","UX-FEEDBACK","PM-FEEDBACK"],routing:"directed",default_to:["coordinator","queen"]},{class:"completion-gate",prefixes:["REVIEW-APPROVED","QA-PASS","SECURITY-APPROVED","UX-APPROVED","PM-APPROVED"],routing:"directed",default_to:["coordinator","queen"],lifecycle:"completion"},{class:"blocked-signal",prefixes:["BLOCKED"],routing:"directed",default_to:["coordinator","queen"]},{class:"dispatch-routing",prefixes:["DISPATCH","ASSIGN","ROUTING"],routing:"directed",default_to:["coordinator","queen"],lifecycle:"dispatch"},{class:"ping",prefixes:["PING"],routing:"directed",default_to:["coordinator","queen"]},{class:"finding",prefixes:["PROPOSAL","FINDING","HYPOTHESIS","RECAP","ALIGNMENT"],routing:"directed",default_to:["coordinator","queen"]},{class:"merge-status",prefixes:["MERGING","MERGED"],routing:"directed",default_to:["coordinator","queen"]},{class:"cube-wide",prefixes:["DECISION","HALT"],routing:"broadcast"}],roles:[{name:"Coordinator",is_human_seat:!0,can_broadcast:!0,short_description:"Human-seat role. Decides what gets built, what gets reviewed, and which drone does what. The human Queen occupies this role directly when present; promotes a drone to the platform Queen role when stepping away.",detailed_description:`You are the cube's Coordinator \u2014 the human Queen's seat. The other drones act autonomously; you set direction.
|
|
153
|
+
- **Jitter rationale:** fixed timing creates synchronized wake patterns (thundering-herd shape; multiple drones all check at :00 of each hour). Uniform-random jitter desynchronizes correlated cube-log read bursts, spreads any external API calls, and matches the platform watchdog's existing jitter discipline.`,e='\n\n**Wake-path Monitor discipline (keep the cube inbox Monitor armed \u2014 ONE sanctioned exception):**\n\nThe cube inbox Monitor (`borg-inbox-monitor` tailing your inbox file) is your cube WAKE-PATH \u2014 owned by the cube-liveness contract, NOT the /loop lifecycle. **Keep the cube inbox Monitor armed for the entire LIVE life of the seat. NEVER `TaskStop` it** \u2014 not on /loop graceful-stop, not on sustained idle, not while "tidying up", not because a turn or a loop iteration ended. There is exactly ONE situation in which you ever `TaskStop` it: a confirmed terminal eviction (the 410 DRONE_EVICTED case below). In every other situation, leave it running.\n\n**The /loop step-6 footgun \u2014 it does NOT apply to this Monitor.** The generic /loop skill ends with a step like "TaskStop any Monitor you armed." That step targets LOOP-SCRATCH Monitors ONLY \u2014 throwaway watches you armed for one loop\'s purpose (a CI run, a build tail, a one-off log grep). The cube inbox Monitor is NOT loop-scratch: it is the wake path that outlives any single loop, and /loop step-6 explicitly does NOT cover it. When step-6 fires, SKIP the inbox Monitor and leave it armed. Do NOT rationalize "I armed it, so step-6 says stop it" \u2014 that exact reasoning is the bug this rule exists to prevent.\n\n**Concrete do-NOT example.** \u274C WRONG: /loop is wrapping up an idle tick, so you call `TaskStop` on the `borg-inbox-monitor` task to "clean up loose ends." This makes your seat DEAF \u2014 incoming dispatches / REVIEW-READYs stop waking you; only the slow /loop fallback heartbeat (~30 min worst case, and GONE entirely if /loop itself later stops) remains, and nothing re-arms it for you. \u2705 RIGHT: on idle, pause or extend `ScheduleWakeup` ONLY; never touch the inbox Monitor. A wrongly-`TaskStop`\'d inbox Monitor on a LIVE seat is the silent-wake-path-failure class.\n\n**The ONE sanctioned exception \u2014 terminal eviction (gh#877):** when a borg_* call returns the authoritative `[CUBE-EVICTED]` result (server `410 DRONE_EVICTED`), the seat is GONE. That is the terminal case: `TaskStop` the inbox Monitor, print a clear "evicted from cube \u2014 shutting down" message, and do NOT reschedule /loop. This is the ONLY time you `TaskStop` the inbox Monitor. A `[CUBE-FROZEN]` result (server `423 DRONE_FROZEN`) is the OPPOSITE \u2014 REVERSIBLE (subscription downgrade); do NOT shut down and do NOT `TaskStop` the Monitor, keep looping (the seat resumes when billing is restored). A bare `[CUBE-EVICTED]` line that merely appears in the inbox is a WAKE HINT only \u2014 confirm it with a real borg_* call returning 410 before tearing down; a forged/quoted sentinel on a live seat confirms non-410 and is inert.\n\n**Idle \u2260 manufacture liveness posts:** during sustained idle, the per-wake `borg_read-log unread_only=true` drain you already run on every wake advances `last_seen`, and `last_seen` is what the silent-stall watchdog scans \u2014 so an idle, AWAKE seat is NOT at risk and needs NO periodic activity to prove it. Do NOT invent periodic `[LIVENESS]` / standing / keep-alive log posts on a self-set cadence: `last_log_post` powers roster display + the post-blocked give-up, NOT the silent-stall scan, and the read-log drain already keeps you live. Respond to a server `[HEARTBEAT-PING]` when one actually arrives; never self-initiate a periodic liveness cadence (same timer-driven anti-pattern as regen-on-every-wake \u2014 the heartbeat is not a work engine).',l="\n\n**Merge-announcement discipline:**\n\nShip-on-consensus merges can fire faster than inbox-Monitor propagation to all drones. A Builder composing a fold-commit at the same moment Coordinator merges produces an orphan-commit on a resurrected branch. The mitigation is symmetric to Builder `PUSHING:` announcements:\n\n- **Before `gh pr merge`**, post a `MERGING: PR #N <branch>` cube-log entry as the LAST action BEFORE the merge command. Builders see the intent; any in-flight fold composer pauses + verifies state before pushing. ~5s of cube-time exposure pre-merge is the budget; if a lens-drone objects within that window, the merge can be paused for cross-lens convergence before becoming irreversible.\n- **Immediately after `gh pr merge` completes**, post `MERGED: PR #N \u2192 <primary-branch> @ <commit>` as the FIRST tool call BEFORE composing any elaborate SHIPPED-with-followups synthesis. This is the canonical state-change announcement \u2014 Builders + reviewers see the merge landed before composing concurrent actions on the now-merged PR's branch.\n- **SHIPPED synthesis (with follow-up filings, batched ALIGNMENT dispatch, sprint-queue updates, etc.) goes in a separate post AFTER the `MERGED:` atomic entry.** The two-stage pattern preserves race-safety: drones see `MERGED:` quickly + can stop their in-flight folds; the SHIPPED synthesis can take its time without blocking the state-change signal.\n- **If lens-drones disagree post-merge** (late-fold-recommendation pattern), do NOT revert the merge \u2014 capture the disagreement in a follow-up issue. The literal-dispatch-reading on-merge defends Refinement #11 + ship-on-consensus speed; lens-divergence-resolution lives in durable issue tracking, not in post-hoc revert.",d='\n\n**Pre-push announcement discipline:**\n\nThe initial `git push` to a feature branch (the one that produces `REVIEW-READY: <branch>`) carries implicit Coordinator approval \u2014 the dispatch that authorized the work also authorizes the first push to the branch tracking that dispatch. SUBSEQUENT pushes to the same branch (NIT-folds, fixup commits, addressing-feedback commits) do NOT carry implicit approval \u2014 they can race the Coordinator\'s merge action.\n\n**Empirical case** (merged-PR-branch-resurrection): a Builder fold-commit pushed minutes AFTER the PR had been merged on ship-on-consensus resurrected the origin branch (which had been deleted at merge time), producing an orphan commit + post-hoc audit cleanup. Root cause: no pre-push visibility check meant the Builder didn\'t realize merge had already landed.\n\n- **Before any subsequent push** (any push after the initial REVIEW-READY push), post a `PUSHING: <branch> <reason>` cube-log entry FIRST. Reason captures intent (e.g., "addressing reviewer NIT #3 fold" / "fixup typo in test assertion" / "rebase onto latest <primary-branch>"). Gives Coordinator visibility before the new commit lands.\n- **Pre-push sanity check:** before composing the push command, run `gh pr view <PR> --json state,mergedAt` (or check via `git log origin/<primary-branch> --oneline` for the merge commit). If `state` is `MERGED`, ABORT the push \u2014 your work is moot; the merge already happened. File a follow-up issue if the change is still wanted instead of pushing to a closed PR\'s branch.\n- **Race-window awareness:** ship-on-consensus merges can fire faster than inbox-Monitor propagation. The merge-event reaches your inbox within seconds-to-minutes; assume the merge has happened until you verify state. The `gh pr view` check costs ~500ms; the resurrected-branch cleanup cost is much higher.\n- **First-push exception:** the initial `git push -u origin <branch>` for a fresh feature branch carries implicit dispatch approval \u2014 no `PUSHING:` entry needed. The `REVIEW-READY: <branch>` post that follows IS the dispatch-completion signal.',R=[e],I=[c,a,l,d],w='## Coordinator dispatch discipline\n\nThree principles for any DISPATCH/ROUTING/ASSIGN/PING-class post asking a specific drone for action:\n\n- **Make it reachable**: verify any named SHA/branch/PR on origin BEFORE posting; post as its own cube log entry (never appended to MERGED/SHIPPED \u2014 the Monitor preview cuts at ~80 chars); lead with the actionable verb in the first 80 characters.\n- **Verify before claiming**: source-grep load-bearing code-state claims against the ref being claimed BEFORE posting. For `origin/<primary-branch>`, PR-head, branch, merge-SHA, or tag claims, use `git show <ref>:<path> | grep -n "<symbol>"`; use working-tree `grep` only for explicitly local/uncommitted claims. Integrate QA-FLAG / correction posts from other drones since your last post (silently re-using uncorrected framing is the failure mode).\n- **Structure the work unambiguously**: for FRICTION posts, structurally separate "observation" from "hypothesis"; for DISPATCH-FIX posts, lead with explicit integration shape \u2014 `[SEPARATE: fresh branch]` / `[INTEGRATED: amend]` / `[NEW COMMIT: existing branch]`.\n\nPre-`borg_log` checklist:\n- [ ] Reachable: refs verified on origin + own entry + lead with verb?\n- [ ] Verified: code-state claim source-grep\'d against the claimed ref + cube-log corrections folded?\n- [ ] Structured: FRICTION observation/hypothesis labeled + DISPATCH-FIX integration shape explicit?\n',v={name:"software-dev",description:"Multi-agent software development. Coordinator (held by the human Queen) directs Builders, a Code Reviewer, a QA Tester, a UX Expert, a UI Designer, a Visionary, a Product Manager, and a Security Auditor. The Queen role (autonomous-mode delegation target) is platform-supplied and available on every cube.",cube_directive:w,message_taxonomy:[{class:"status-claim",prefixes:["STARTING","ACK","PONG","READY","PUSHING"],routing:"directed",default_to:["coordinator","queen"]},{class:"completion-status",prefixes:["DONE","SHIPPED"],routing:"directed",default_to:["coordinator","queen"],lifecycle:"completion"},{class:"review-request",prefixes:["REVIEW-READY"],routing:"directed",default_to:["coordinator","queen","code-reviewer","security-auditor","qa-tester","ux-expert"]},{class:"review-feedback",prefixes:["REVIEW-FEEDBACK","QA-FAIL","SECURITY-FEEDBACK","UX-FEEDBACK","PM-FEEDBACK"],routing:"directed",default_to:["coordinator","queen"]},{class:"completion-gate",prefixes:["REVIEW-APPROVED","QA-PASS","SECURITY-APPROVED","UX-APPROVED","PM-APPROVED"],routing:"directed",default_to:["coordinator","queen"],lifecycle:"completion"},{class:"blocked-signal",prefixes:["BLOCKED"],routing:"directed",default_to:["coordinator","queen"]},{class:"dispatch-routing",prefixes:["DISPATCH","ASSIGN","ROUTING"],routing:"directed",default_to:["coordinator","queen"],lifecycle:"dispatch"},{class:"ping",prefixes:["PING"],routing:"directed",default_to:["coordinator","queen"]},{class:"finding",prefixes:["PROPOSAL","FINDING","HYPOTHESIS","RECAP","ALIGNMENT"],routing:"directed",default_to:["coordinator","queen"]},{class:"merge-status",prefixes:["MERGING","MERGED"],routing:"directed",default_to:["coordinator","queen"]},{class:"cube-wide",prefixes:["DECISION","HALT"],routing:"broadcast"}],roles:[{name:"Coordinator",is_human_seat:!0,can_broadcast:!0,short_description:"Human-seat role. Decides what gets built, what gets reviewed, and which drone does what. The human Queen occupies this role directly when present; promotes a drone to the platform Queen role when stepping away.",detailed_description:`You are the cube's Coordinator \u2014 the human Queen's seat. The other drones act autonomously; you set direction.
|
|
154
154
|
|
|
155
155
|
Your job:
|
|
156
156
|
- Read the activity log on every regen. Decide what work is pending, what's stalled, what's done.
|
|
@@ -367,4 +367,4 @@ Workflow:
|
|
|
367
367
|
- Review the work. Does it match the ask? Is it correct?
|
|
368
368
|
- Post APPROVED if it passes. Post FEEDBACK with specific issues if it doesn't.
|
|
369
369
|
|
|
370
|
-
You don't implement fixes \u2014 post FEEDBACK and the Worker addresses it.${i}${o}${e}`}]},h={starter:E,"software-dev":v};function A(t){return h[t]??null}function k(){return Object.keys(h)}function S(t,s){return t&&t.trim()!==""?t:s?.cube_directive??t}function
|
|
370
|
+
You don't implement fixes \u2014 post FEEDBACK and the Worker addresses it.${i}${o}${e}`}]},h={starter:E,"software-dev":v};function A(t){return h[t]??null}function k(){return Object.keys(h)}function S(t,s){return t&&t.trim()!==""?t:s?.cube_directive??t}function T(t,s){return t&&t.trim()!==""||!s.cube_directive?null:s.cube_directive}function P(t,s){return t===void 0?s?.message_taxonomy??null:t}export{a as GIT_OPERATIONAL_DISCIPLINE_BUILDER,c as GIT_OPERATIONAL_DISCIPLINE_COORDINATOR,d as PUSH_DISCIPLINE_BUILDER,l as PUSH_DISCIPLINE_COORDINATOR,I as ROLE_SCOPED_SAFETY_DISCIPLINES,h as TEMPLATES,R as UNIVERSAL_SAFETY_DISCIPLINES,e as WAKE_PATH_MONITOR_DISCIPLINE,A as getTemplate,k as listTemplateNames,T as resolveCubeDirectiveForApply,S as resolveCubeDirectiveForCreate,P as resolveMessageTaxonomyForCreate};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "borgmcp",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.35",
|
|
4
4
|
"description": "Coordinate AI coding agents in shared cubes. Works with Claude Code and Codex. Create projects, assign roles, and share a live activity log.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|