borgmcp 1.1.15 → 2.0.1

package/dist/index.js

@@ -1,38 +1,1035 @@
 #!/usr/bin/env node
-import{Server as ee}from"@modelcontextprotocol/sdk/server/index.js";import{StdioServerTransport as te}from"@modelcontextprotocol/sdk/server/stdio.js";import{CallToolRequestSchema as oe,ListToolsRequestSchema as re,ListPromptsRequestSchema as ne,GetPromptRequestSchema as se}from"@modelcontextprotocol/sdk/types.js";import{assertRoleMatches as ie}from"./role-match.js";import{getCubeInfo as ae,getRoleInfo as L,getRoleInfoByName as ce,getRoster as de,readLog as le,appendLog as ue,submitReport as pe,fetchReports as me,ackLogEntry as be,recordDecision as fe,removeDecision as ge,listDecisions as he,regen as O,listCubes as _e,createCube as ye,updateCube as B,deleteCube as we,createRole as xe,updateRole as $e,patchRoleSection as C,patchTaxonomyClass as F,deleteRole as ve,reassignDrone as ke,evictDrone as Re,getCube as $,checkSubscriptionStatus as Ee,createBillingPortalSession as Ce,createSubscription as Se,syncRoles as Te,applyTemplate as Ie,whoami as qe,roleRationale as De,getValidToken as Pe}from"./remote-client.js";import{startHealthBeatTick as Ue}from"./health-beat.js";import{getTemplate as S,listTemplateNames as T,resolveCubeDirectiveForCreate as Me,resolveCubeDirectiveForApply as Ne,resolveMessageTaxonomyForCreate as je}from"./templates.js";import{activeCubeWithFreshRegenIdentity as H,getActiveCube as _,setActiveCube as W,findProjectRoot as I,inboxPathForDrone as q}from"./cubes.js";import{monitorStateRootForWorktree as D}from"./inbox-monitor.js";import{addSessionStartHook as Ae,addUserPromptSubmitHook as Le}from"./config-utils.js";import{humanAgo as V,formatLogEntryMarkdown as Oe,formatRegenMarkdown as z,getDronePlaybook as Be,getDronePlaybookChapter as Fe,nullTaxonomyTip as He,regenWakePathDroneLabel as We}from"./regen-format.js";import{startLogStream as Ve,getStreamStatus as P}from"./log-stream.js";import{isMcpReadinessProbe as ze}from"./readiness-probe.js";import{runMcpStartupServices as Ke}from"./startup-services.js";import{TOOL_MANIFEST as Je}from"./tool-manifest.js";import{DOCS_SECTIONS as Qe,matchDocsSections as Ye,formatDocsIndex as Ge}from"./docs-sections.js";import{renderRoleList as Xe}from"./list-roles-render.js";import{filterToolsForRole as Ze}from"./tool-scope.js";import{getPackageVersion as v,getOnDiskVersion as et,handleVersionFlag as tt}from"./version.js";import{renderStreamStatus as ot,checkInboxMonitorHealthy as U,formatWakePathPrefix as rt,shouldShowWakePathWarning as nt}from"./stream-status.js";import{formatRoleAgentLabel as st,formatWorkingRepoLabel as it,renderRoster as at}from"./roster-render.js";import{resolveWorkingRepo as K}from"./working-repo.js";import{resolveDroneIdByLabel as ct,isUuidShape as dt}from"./evict-drone.js";import{authRecoveryMessage as lt}from"./auth-recovery.js";import{DroneEvictedError as ut,DroneFrozenError as pt,formatEvictedToolResult as mt,formatFrozenToolResult as bt}from"./drone-lifecycle.js";import{classifyInSessionAssimilate as ft,reattachOnlyRefusal as gt,reattachFailureMessage as ht}from"./assimilate-guard.js";import{gateAllowsActivation as _t,borgSessionToolNotice as yt}from"./launch-gate.js";import{renderSyncRolesResult as wt}from"./sync-roles-render.js";import{initConsolePrefix as xt,consolePrefix as k}from"./console-prefix.js";import{isCodexRemoteWakeEnabled as $t,resolveSessionAgentKind as M,probeCodexBridgeArmed as vt}from"./codex-app-wake.js";import{connectOpenCodeDrone as kt,injectOpenCodeEntry as Rt,probeOpenCodeDroneArmed as Et,computeOpenCodePort as Ct}from"./opencode-drone.js";import{installBorgPlugin as St}from"./opencode-plugin.js";import{setModuleInjectOpenCode as Tt}from"./log-stream.js";import{lifecycleSignalForMessage as It,recordLifecycleLog as J,shouldSuppressLifecycleLog as qt}from"./lifecycle-log-guard.js";import{normalizeDirectLogRecipients as Dt}from"./direct-log.js";import Q from"open";import Pt from"os";function Ut(){try{const b=Pt.hostname();return b&&b.trim()?b.trim().slice(0,255):null}catch{return null}}async function Y(b,y){return await Ie(b,y.name)}async function h(){const b=await _();if(!b)throw new Error("Not assimilated to a cube. Use borg_assimilate <cube-name> first.");return b}async function Mt(){tt();const b=ze();await Ke(b,{sessionStartHook:()=>{Ae()},auditHook:()=>{Le()},sseStream:()=>{Ve()},openCode:async()=>{St();const d=await _();if(d&&process.env.BORG_OPENCODE==="1"){const o=`http://127.0.0.1:${Ct(d.droneId)}`;await kt({serverUrl:o,directory:process.cwd(),droneLabel:d.droneLabel,cubeName:d.name}),Tt(Rt)}},healthBeat:()=>{Ue({getActiveCube:_,getStreamConnected:()=>P().connected,getInboxPath:d=>q(d.cubeId,d.droneId),checkMonitor:d=>U(d,D(I())),isCodexRemoteWake:$t,probeBridgeArmed:d=>vt({cubeId:d.cubeId,droneId:d.droneId}),probeOpenCodeDrone:()=>Et(),resolveAgentKind:M,resolveHostname:Ut,resolveVersion:v,getToken:Pe,fetchImpl:globalThis.fetch.bind(globalThis)})}});const y=new ee({name:"borg-mcp-client",version:v()},{capabilities:{tools:{},prompts:{}}}),N=Je;y.setRequestHandler(re,async()=>{let d=null;try{const u=await _();u&&(d={roleName:u.roleName,roleClass:u.roleClass,isHumanSeat:u.isHumanSeat})}catch{d=null}return{tools:Ze(N,d)}}),y.setRequestHandler(oe,async d=>{let{name:u,arguments:o}=d.params;if(u==="borg_describe-tool"){const e=typeof o?.name=="string"?o.name:"",t=N.find(r=>r.name===e);return t?{content:[{type:"text",text:JSON.stringify({name:t.name,description:t.description,inputSchema:t.inputSchema},null,2)}]}:{content:[{type:"text",text:`Unknown borg tool: ${e||"(none)"}. Pass { name: "<borg_tool>" }.`}],isError:!0}}if(u==="borg_tool"){const e=typeof o?.name=="string"?o.name:"";if(!e||e==="borg_tool"||e==="borg_describe-tool")return{content:[{type:"text",text:'borg_tool: pass { name: "<borg_tool>", arguments: {...} } naming a real borg tool (not the dispatcher itself).'}],isError:!0};o=o?.arguments&&typeof o.arguments=="object"?o.arguments:{},u=e}if(!_t(`tool ${u}`))return{content:[{type:"text",text:yt(u)}],isError:!0};try{switch(u){case"borg_regen":{const e=await _();if(!e)return{content:[{type:"text",text:'Not connected to a cube. Use `borg_assimilate cube_name="<name>"` to join one.'}]};const t=typeof o?.since=="string"?o.since:void 0,r=o?.mode==="lite"?"lite":"full",n=typeof o?.model=="string"?o.model:void 0,i=await O(e.sessionToken,e.apiUrl,{since:t,reportedModel:n,workingRepo:K()}),s=H(e,i);s!==e&&await W(s);const a=P(),c=q(s.cubeId,s.droneId),m=D(I()),f=M()==="claude"?U(c,m):!0,l=nt(a,f)?rt({inboxPath:c,monitorStateRoot:m,droneLabel:We(i,s.droneLabel),cubeName:s.name}):"";let g="";try{const w=v(),x=et();if(w!=="unknown"&&x!=="unknown"&&x!==w){const[R,j,X]=w.split(".").map(Number),[E,A,Z]=x.split(".").map(Number);(E>R||E===R&&A>j||E===R&&A===j&&Z>X)&&(g=`## \u{1F504} borgmcp ${x} installed \u2014 run /mcp and reconnect (or restart Claude Code) to apply. Currently running ${w}.
-
-`)}}catch{}return{content:[{type:"text",text:g+l+z(i,{mode:r})}]}}case"borg_subscribe":return{content:[{type:"text",text:`Complete your subscription at: ${await Se()}`}]};case"borg_upgrade-subscription":{const e=await Ce();try{await Q(e)}catch{}return{content:[{type:"text",text:`Manage your Borg MCP subscription at: ${e}`}]}}case"borg_subscription_status":{const e=await Ee();return{content:[{type:"text",text:JSON.stringify(e,null,2)}]}}case"borg_open_dashboard":{const e="https://borgmcp.ai/dashboard";return await Q(e),{content:[{type:"text",text:`\u25FC Opened dashboard in browser: ${e}`}]}}case"borg_assimilate":{const e=o?.cube_name;if(!e)throw new Error("cube_name is required");const t=await _(),r=ft(t,e);if(r.kind!=="reattach")return{content:[{type:"text",text:gt(r,e)}],isError:!0};try{const n=await O(t.sessionToken,t.apiUrl,{workingRepo:K()}),i=H(t,n);return i!==t&&await W(i),{content:[{type:"text",text:[`# Re-attached to cube: ${i.name}`,"",`**Drone label:** ${i.droneLabel}`,"**Seat:** existing identity reused \u2014 no new drone minted (gh#780)","",""].join(`
-`)+z(n,{mode:"full"})}]}}catch(n){const i=ht(n??{});if(!i)throw n;return{content:[{type:"text",text:i}],isError:!0}}}case"borg_version":return{content:[{type:"text",text:`borgmcp ${v()}`}]};case"borg_playbook":return{content:[{type:"text",text:Fe()}]};case"borg_docs":{const e=typeof o?.topic=="string"?o.topic.trim():"",t=e?Ye(e):[],r=t.length>0?t:Qe;return{content:[{type:"text",text:`${e&&t.length>0?`Best-matching docs section(s) for "${e}" \u2014 WebFetch the URL for the full page:`:e?`No exact match for "${e}". Full Borg MCP docs index \u2014 WebFetch the URL you need:`:"Borg MCP docs index \u2014 WebFetch the URL of the section you need:"}
-
-${Ge(r)}`}]}}case"borg_whoami":{const e=await h(),t=await qe(e.sessionToken,e.apiUrl);return{content:[{type:"text",text:JSON.stringify(t,null,2)}]}}case"borg_cube":{const e=await h(),[{cube:t,roles:r}]=await Promise.all([ae(e.sessionToken,e.apiUrl),L(e.sessionToken,e.apiUrl)]),n=[];n.push(`# Cube: ${t.name}`),n.push(""),n.push("## Cube directive"),n.push(t.cube_directive||"_(none)_"),n.push("");const i=He(t.message_taxonomy);if(i&&(n.push(i),n.push("")),n.push("## Roles in this cube"),!r.length)n.push("_(no roles defined)_");else{for(const s of r){const a=[s.role_class==="queen"?"Queen":null,s.is_human_seat?"human-seat":null,s.is_default?"default":null,s.is_mandatory?"mandatory":null].filter(Boolean).join(", "),c=a?` (${a})`:"",m=s.short_description||"_(no description)_";n.push(`- **${s.name}**${c} \u2014 ${m}`)}n.push(""),n.push("_(Coordinator-class drones can fetch role IDs via `borg_list-roles` for use with `borg_reassign-drone`.)_")}return n.push(""),n.push(Be()),{content:[{type:"text",text:n.join(`
-`)}]}}case"borg_role":{const e=await h(),t=typeof o?.role=="string"?o.role.trim():"";if(t){const{role:i}=await ce(e.sessionToken,e.apiUrl,t);return ie(t,i),{content:[{type:"text",text:[`# Role: ${i.name}`,"",i.detailed_description||"_(no detailed description set)_"].join(`
-`)}]}}const{role:r}=await L(e.sessionToken,e.apiUrl);return{content:[{type:"text",text:[`# Your role: ${r.name}`,"",r.detailed_description||"_(no detailed description set)_"].join(`
-`)}]}}case"borg_role-rationale":{const e=await h(),t=typeof o?.role=="string"?o.role:"",r=typeof o?.section=="string"?o.section:"",n=await De(e.sessionToken,e.apiUrl,t,r);return{content:[{type:"text",text:[`# Role rationale: ${n.role} \u2014 ${n.section}`,"",n.body||"_(empty)_"].join(`
-`)}]}}case"borg_roster":{const e=await h(),t=typeof o?.since=="string"?o.since:void 0,{drones:r,roles:n,since:i}=await de(e.sessionToken,e.apiUrl,t);return{content:[{type:"text",text:at({cubeName:e.name,drones:r,roles:n,resolvedSince:i??null,humanAgo:V})}]}}case"borg_stream-status":{const e=P(),t=await _(),r=t?q(t.cubeId,t.droneId):null,n=t?D(I()):null,i=t&&M()!=="claude",s=t?i?!0:U(r,n):null;let a="";e.runLoopHealth==="silent-inert"&&(a=`## \u26A0 SSE stream loop silent-inert \u2014 run /mcp and reconnect to restart
-
-The log-stream consumer started but never connected. This drone will not receive real-time cube events.
-
-`);const c=ot({status:e,inboxMonitorHealthy:s,inboxPath:r,monitorStateRoot:n,droneLabel:t?.droneLabel??null,cubeName:t?.name??null,humanAgo:V});return{content:[{type:"text",text:a+c}]}}case"borg_read-log":{const e=await h(),t=typeof o?.since=="string"?o.since:void 0,r=typeof o?.limit=="number"?o.limit:void 0,n=o?.unread_only===!0||o?.unread_only==="true",{entries:i,drones:s,roles:a,behind_by:c,has_more:m}=await le(e.sessionToken,e.apiUrl,{since:t,limit:r,unreadOnly:n}),p=new Map;for(const g of s)p.set(g.id,g);const f=new Map;for(const g of a)f.set(g.id,g);const l=[];if(l.push(`# Activity log: ${e.name}`),l.push(""),!i.length)l.push("_(no entries)_");else for(const g of i)l.push(Oe(g,p,f));return m===!0?(l.push(""),l.push("\u26A0 has_more: true \u2014 call `borg_read-log unread_only=true` again until has_more=false so you finish draining unread entries.")):typeof c=="number"&&c>0&&(l.push(""),l.push(`\u26A0 behind_by: ${c} more unread ${c===1?"entry":"entries"} addressed to you \u2014 call \`borg_read-log unread_only=true\` again until behind_by=0 so you don't skip messages.`)),{content:[{type:"text",text:l.join(`
-`)}]}}case"borg_log":{const e=o?.message;if(!e||typeof e!="string")throw new Error("message is required");const t=await _();if(!t)throw new Error("Not assimilated to a cube. Use borg_assimilate <cube-name> first.");if(It(e)){const l=await qt(t,e);if(l.suppress)return await J(t,e),{content:[{type:"text",text:`Suppressed duplicate ${l.signal?.toUpperCase()} lifecycle log for ${t.droneLabel}; recent cube log already contains this signal.`}]}}const r=Object.prototype.hasOwnProperty.call(o??{},"to"),n=r?Dt(o?.to):void 0,i=typeof o?.class=="string"?o.class:void 0,s=o?.visibility==="broadcast"||o?.visibility==="direct"?o.visibility:void 0,a={...i?{class:i}:{},...r?{to:n??[]}:{},...s?{visibility:s}:{}},c=await ue(t.sessionToken,t.apiUrl,e,a);await J(t,e);const m=c.routing?.message?`
-${c.routing.message}`:"",p=c.unreachableRecipients?.length?`
-\u26A0 ${c.unreachableRecipients.length} directed recipient(s) currently unreachable (wake-path:deaf): ${c.unreachableRecipients.map(l=>l.label).join(", ")}. Message delivered \u2014 they'll read it when they return.`:"";return{content:[{type:"text",text:`Logged to cube "${t.name}" as ${t.droneLabel}. (entry id: ${c.entry.id})${m}${p}`}]}}case"borg_report-friction":{const e=o?.message;if(!e||typeof e!="string")throw new Error("message is required");const t=await _();if(!t)throw new Error("Not assimilated to a cube. Use borg_assimilate <cube-name> first.");const r=o?.kind==="bug"?"bug":"friction",n=o?.metadata&&typeof o.metadata=="object"&&!Array.isArray(o.metadata)?o.metadata:void 0;return{content:[{type:"text",text:(await pe(t.sessionToken,t.apiUrl,{kind:r,message:e,metadata:n})).ok?"Report submitted \u2014 thank you. The borgmcp team will see it. (Write-only: you cannot read reports back.)":"Report did not submit. Try again, or raise it in the cube log."}]}}case"borg_reports":{const e=await me();if(e.forbidden)return{content:[{type:"text",text:"Reports triage is builder/dogfooder-tier only. Your account is not on the dogfooder (builder) tier, so the friction-reports store is not readable. (Server-enforced gate.)"}]};if(!e.reports.length)return{content:[{type:"text",text:"No reports yet. Submissions via borg_report-friction will appear here, newest first."}]};const t=e.reports.map(r=>{const n=r.metadata&&Object.keys(r.metadata).length?" \xB7 "+Object.entries(r.metadata).map(([s,a])=>`${s}=${a}`).join(", "):"",i=r.redacted?" \xB7 [secrets-scrubbed]":"";return`**[${r.kind}]** ${r.created_at} \xB7 ${r.reporter_email}${n}${i}
-${r.message}`});return{content:[{type:"text",text:`Reports (${e.reports.length}, newest first):
-
-${t.join(`
-
----
-
-`)}`}]}}case"borg_ack":{const e=o?.entry_id;if(!e||typeof e!="string")throw new Error("entry_id is required");const t=o?.kind==="claim"?"claim":"ack",r=await h();return await be(r.sessionToken,r.apiUrl,e,t),{content:[{type:"text",text:t==="claim"?`Claimed entry ${e} in cube "${r.name}" (advisory \u2014 merge stays keyed on REVIEW-APPROVED).`:`Acked entry ${e} in cube "${r.name}".`}]}}case"borg_decide":{const e=o?.topic,t=o?.decision;if(!e||typeof e!="string")throw new Error("topic is required");if(!t||typeof t!="string")throw new Error("decision is required");const r=typeof o?.rationale=="string"?o.rationale:void 0,n=await h(),{decision:i}=await fe(n.sessionToken,n.apiUrl,{topic:e,decision:t,...r!==void 0?{rationale:r}:{}}),s=i?.supersedes?" (superseded the prior decision on this topic)":"";return{content:[{type:"text",text:`Recorded ratified decision on "${e}" in cube "${n.name}"${s}. Cite it via borg_decisions; it surfaces in borg_regen.`}]}}case"borg_decisions":{const e=typeof o?.topic=="string"?o.topic:void 0,t=await h(),{decisions:r}=await he(t.sessionToken,t.apiUrl,e);return{content:[{type:"text",text:r.length===0?e?`No active ratified decision on "${e}" in cube "${t.name}".`:`No active ratified decisions in cube "${t.name}".`:r.map(i=>`**${i.topic}:** ${i.decision}${i.rationale?` \u2014 ${i.rationale}`:""}`).join(`
-`)}]}}case"borg_remove-decision":{const e=typeof o?.topic=="string"?o.topic:void 0,t=typeof o?.decision_id=="string"?o.decision_id:void 0;if(+(e!==void 0)+ +(t!==void 0)!=1)throw new Error("provide exactly one of topic or decision_id");const r=await h(),n=e!==void 0?{topic:e}:{decision_id:t},{decision:i}=await ge(r.sessionToken,r.apiUrl,n);return{content:[{type:"text",text:`Removed the active ratified decision on "${i.topic}" from cube "${r.name}".`}]}}case"borg_list-cubes":{const{cubes:e}=await _e();if(!e.length)return{content:[{type:"text",text:"No cubes yet. Use borg_create-cube to make your first one."}]};const t=e.map(r=>`- **${r.name}** (id: ${r.id})
-  ${(r.cube_directive||"_(no directive set)_").split(`
-`)[0].slice(0,120)}`);return{content:[{type:"text",text:`Your cubes (${e.length}):
-
-${t.join(`
-
-`)}`}]}}case"borg_create-cube":{const e=o?.name,t=o?.cube_directive,r=o?.template;if(!e)throw new Error("name is required");if(t===void 0)throw new Error("cube_directive is required (pass empty string if none)");let n=null;if(r&&(n=S(r),!n))throw new Error(`Unknown template "${r}". Available: ${T().join(", ")}`);const i=Me(t,n),s=je(void 0,n),a=await ye(e,i,{message_taxonomy:s});if(n){const m=await Y(a.id,n),p=i!==t?" Template cube directive applied (operator passed empty).":"";return{content:[{type:"text",text:`Created cube **${a.name}** (id: ${a.id}) with template **${r}** applied \u2014 ${m.created} role(s) created, ${m.updated} updated.${p} Use borg_assimilate ${a.name} to join as a drone.`}]}}return{content:[{type:"text",text:`Created cube **${a.name}** (id: ${a.id}). A default "Drone" role was seeded \u2014 rename or replace it via borg_update-role / borg_create-role / borg_delete-role. Use borg_assimilate ${a.name} to join as a drone.`}]}}case"borg_update-cube":{const e=o?.cube_id;if(!e)throw new Error("cube_id is required");const t={};if(typeof o?.name=="string"&&(t.name=o.name),typeof o?.cube_directive=="string"&&(t.cube_directive=o.cube_directive),Array.isArray(o?.message_taxonomy)&&(t.message_taxonomy=o.message_taxonomy),Object.keys(t).length===0)throw new Error("Pass at least one of: name, cube_directive, message_taxonomy.");const{cube:r}=await B(e,t);return{content:[{type:"text",text:`Updated cube **${r.name}** (id: ${r.id}).`}]}}case"borg_patch-taxonomy-class":{const e=o?.cube_id;if(!e)throw new Error("cube_id is required");const t=o?.action;if(t!=="add"&&t!=="replace"&&t!=="remove")throw new Error("action must be one of: add, replace, remove.");let r,n;if(t==="remove"){const s=o?.class;if(!s)throw new Error("class is required for remove.");({cube:r}=await F(e,{action:t,class:s})),n=s}else{const s=o?.class_def;if(s==null||typeof s!="object"||Array.isArray(s))throw new Error("class_def (object) is required for add/replace.");({cube:r}=await F(e,{action:t,class_def:s})),n=String(s.class??"")}return{content:[{type:"text",text:`${t==="add"?"Added":t==="replace"?"Replaced":"Removed"} taxonomy class **${n}** in cube **${r.name}** (id: ${r.id}).`}]}}case"borg_delete-cube":{const e=o?.cube_id;if(!e)throw new Error("cube_id is required");return await we(e),{content:[{type:"text",text:`Deleted cube ${e} (and all its roles, drones, log entries).`}]}}case"borg_create-role":{const e=o?.cube_id,t=o?.name,r=o?.short_description,n=o?.detailed_description;if(!e)throw new Error("cube_id is required");if(!t)throw new Error("name is required");if(r===void 0)throw new Error("short_description is required (pass empty string if none)");if(n===void 0)throw new Error("detailed_description is required (pass empty string if none)");const i=o?.is_default===!0,s=o?.is_mandatory===!0,a=o?.is_human_seat===!0,c=o?.can_broadcast===!0,m=o?.receives_all_direct===!0,{role:p}=await xe(e,{name:t,short_description:r,detailed_description:n,is_default:i,is_mandatory:s,is_human_seat:a,can_broadcast:c,receives_all_direct:m,...typeof o?.default_model=="string"?{default_model:o.default_model}:{}}),f=[p.role_class==="queen"?"Queen":null,p.is_human_seat?"human-seat":null,p.is_default?"default":null,p.is_mandatory?"mandatory":null].filter(Boolean).join(", "),l=f?` (${f})`:"";return{content:[{type:"text",text:`Created role **${p.name}**${l} (id: ${p.id}) in cube ${e}.`}]}}case"borg_update-role":{const e=o?.role_id;if(!e)throw new Error("role_id is required");const t={};if(typeof o?.name=="string"&&(t.name=o.name),typeof o?.short_description=="string"&&(t.short_description=o.short_description),typeof o?.detailed_description=="string"&&(t.detailed_description=o.detailed_description),typeof o?.is_default=="boolean"&&(t.is_default=o.is_default),typeof o?.is_mandatory=="boolean"&&(t.is_mandatory=o.is_mandatory),typeof o?.is_human_seat=="boolean"&&(t.is_human_seat=o.is_human_seat),typeof o?.can_broadcast=="boolean"&&(t.can_broadcast=o.can_broadcast),typeof o?.receives_all_direct=="boolean"&&(t.receives_all_direct=o.receives_all_direct),typeof o?.default_model=="string"&&(t.default_model=o.default_model),Object.keys(t).length===0)throw new Error("Pass at least one of: name, short_description, detailed_description, is_default, is_mandatory, is_human_seat, can_broadcast, receives_all_direct.");const{role:r}=await $e(e,t),n=[r.role_class==="queen"?"Queen":null,r.is_human_seat?"human-seat":null,r.is_default?"default":null,r.is_mandatory?"mandatory":null].filter(Boolean).join(", "),i=n?` (${n})`:"";return{content:[{type:"text",text:`Updated role **${r.name}**${i} (id: ${r.id}).`}]}}case"borg_patch-role-section":{const e=o?.role_id;if(!e)throw new Error("role_id is required");const t=o?.action;if(t!=="replace"&&t!=="insert"&&t!=="delete")throw new Error("action must be one of: replace, insert, delete.");const r=o?.heading;if(!r)throw new Error("heading is required");let n;if(t==="delete")({role:n}=await C(e,{action:t,heading:r}));else{const s=o?.body;if(typeof s!="string")throw new Error("body is required for replace/insert (pass empty string for an empty section).");if(t==="insert"){const a=typeof o?.after=="string"?o.after:null;({role:n}=await C(e,{action:t,heading:r,body:s,after:a}))}else({role:n}=await C(e,{action:t,heading:r,body:s}))}return{content:[{type:"text",text:`${t==="replace"?"Replaced":t==="insert"?"Inserted":"Deleted"} section **${r}** in role **${n.name}** (id: ${n.id}).`}]}}case"borg_delete-role":{const e=o?.role_id;if(!e)throw new Error("role_id is required");return await ve(e),{content:[{type:"text",text:`Deleted role ${e}.`}]}}case"borg_reassign-drone":{const e=o?.drone_id,t=o?.role_id;if(!e)throw new Error("drone_id is required");if(!t)throw new Error("role_id is required");const{drone:r}=await ke(e,t);return{content:[{type:"text",text:`Reassigned drone ${r.label} (${r.id}) to role ${r.role_id}.`}]}}case"borg_evict-drone":{const e=o?.drone_id?.trim(),t=o?.label?.trim(),r=o?.cube_id?.trim();let n,i;if(e){if(!dt(e))throw new Error(`drone_id "${e}" is not a UUID \u2014 if that's a drone label, pass it as label + cube_id instead.`);n=e,i=e}else if(t){if(!r)throw new Error("cube_id is required when evicting by label");const{drones:s}=await $(r),a=ct(s,t);if(!a)throw new Error(`No active drone labelled "${t}" in cube ${r} (it may already be evicted; check borg_list-drones).`);n=a.id,i=a.label}else throw new Error("Provide drone_id, or label + cube_id, to identify the drone to evict");return await Re(n),{content:[{type:"text",text:`Evicted drone ${i} (${n}). Soft-deleted: removed from the roster and freed its seat; log history preserved with anonymized attribution.`}]}}case"borg_list-drones":{const e=o?.cube_id;if(!e)throw new Error("cube_id is required");const{drones:t,roles:r}=await $(e);if(!t.length)return{content:[{type:"text",text:"No drones in this cube yet."}]};const n=new Map(r.map(s=>[s.id,s])),i=t.map(s=>{const a=n.get(s.role_id),c=st(a?.name??"?",s.agent_kind),m=s.wake_path_alert_class&&s.wake_path_alert_class!=="independent"?` \u2014 wake-path-class: ${s.wake_path_alert_class}`:"",p=s.reported_model?` \u2014 Reported model: ${s.reported_model}`:" \u2014 Reported model: not reported",f=it(s),l=f?` \u2014 ${f}`:"";return`- **${s.label}** (id: ${s.id}) \u2014 role: ${c} (${s.role_id}) \u2014 last seen ${s.last_seen}${m}${p}${l}`});return{content:[{type:"text",text:`Drones in cube ${e} (${t.length}):
-
-${i.join(`
-`)}`}]}}case"borg_list-roles":{const e=o?.cube_id;if(!e)throw new Error("cube_id is required");const{roles:t}=await $(e);return{content:[{type:"text",text:Xe(t,e)}]}}case"borg_list-templates":return{content:[{type:"text",text:`Available templates:
-
-${T().map(r=>{const n=S(r);return`- **${r}**: ${n.description}`}).join(`
-`)}`}]};case"borg_sync-roles":{const e=o?.cube_id,t=o?.template_name||"software-dev",r=o?.apply===!0,n=o?.decisions&&typeof o.decisions=="object"?o.decisions:void 0;if(!e)throw new Error("cube_id is required");const i=await Te(e,t,r,n);return{content:[{type:"text",text:wt(i,t)}]}}case"borg_apply-template":{const e=o?.cube_id,t=o?.template_name;if(!e)throw new Error("cube_id is required");if(!t)throw new Error("template_name is required");const r=S(t);if(!r)throw new Error(`Unknown template "${t}". Available: ${T().join(", ")}`);const n=await Y(e,r);let i="";const s=await $(e),a=Ne(s.cube_directive,r);return a!==null&&(await B(e,{cube_directive:a}),i=" Template cube directive applied (cube directive was empty)."),{content:[{type:"text",text:`Applied template **${t}** to cube ${e} \u2014 ${n.created} role(s) created, ${n.updated} updated.${i}`}]}}default:throw new Error(`Unknown tool: ${u}`)}}catch(e){if(e instanceof ut)return{content:[{type:"text",text:mt(e.message)}],isError:!0};if(e instanceof pt)return{content:[{type:"text",text:bt(e.message)}],isError:!0};const t=lt(e??{});return t?{content:[{type:"text",text:t}],isError:!0}:{content:[{type:"text",text:`Error: ${e.message}`}],isError:!0}}}),y.setRequestHandler(ne,async()=>({prompts:[{name:"borg_subscribe",description:"Set up Borg MCP Cube tier subscription ($1/month per cube; each cube adds 8 pooled agent sessions + 1000 req/hr). Free tier is permanent (1 cube + 3 agent sessions + 100 req/hr); no trial."},{name:"dashboard",description:"Open Borg MCP dashboard to manage cubes"}]})),y.setRequestHandler(se,async d=>{const{name:u}=d.params;switch(u){case"borg_subscribe":return{description:"Set up Borg MCP Cube tier subscription ($1/month per cube; each cube adds 8 pooled agent sessions + 1000 req/hr). Free tier is permanent (1 cube + 3 agent sessions + 100 req/hr); no trial.",messages:[{role:"user",content:{type:"text",text:"Please help me set up a Borg MCP subscription using the subscribe tool."}}]};case"dashboard":return{description:"Open Borg MCP dashboard to manage cubes",messages:[{role:"user",content:{type:"text",text:"Please open the Borg MCP dashboard using the borg_open_dashboard tool."}}]};default:throw new Error(`Unknown prompt: ${u}`)}});const G=new te;await y.connect(G),await xt(),console.error(`${k()}\u25FC Borg MCP Client started`),console.error(`${k()}\u25FC Use borg_assimilate <cube-name> to join a cube as a drone`),console.error(`${k()}\u25FC Manage your cubes at https://borgmcp.ai/dashboard`)}Mt().catch(b=>{console.error(`${k()}Fatal error:`,b),process.exit(1)});
+/**
+ * Borg MCP Client - Main Entry Point
+ *
+ * stdio MCP server that:
+ * 1. Connects to Claude Code via stdio transport
+ * 2. Proxies MCP tools to a verified local (self-hosted) Borg server
+ * 3. Provides the borg: cube tool surface (assimilate / cube / role /
+ *    roster / read-log) so Claude can act as a Drone in a hive of
+ *    collaborating sessions.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { assertRoleMatches } from './role-match.js';
+import { getCubeInfo, getRoleInfo, getRoleInfoByName, getRoster, readLog, appendLog, ackLogEntry, recordDecision, removeDecision, listDecisions, regen, listCubes, createCube, updateCube, deleteCube, createRole, updateRole, patchRoleSection, patchTaxonomyClass, deleteRole, getCube, listRoles, syncRoles, applyTemplate, whoami, roleRationale, } from './remote-client.js';
+import { getTemplate, listTemplateNames, resolveCubeDirectiveForCreate, resolveCubeDirectiveForApply, resolveMessageTaxonomyForCreate, } from 'borgmcp-shared/templates';
+import { activeCubeWithFreshRegenIdentity, getActiveCube, refreshActiveCubeMetadata, findProjectRoot, inboxPathForDrone, } from './cubes.js';
+import { isEntryInvocation, monitorStateRootForWorktree } from './inbox-monitor.js';
+import { addSessionStartHook, addUserPromptSubmitHook } from './config-utils.js';
+import { humanAgo, formatLogEntryMarkdown, formatRegenMarkdown, getDronePlaybook, getDronePlaybookChapter, nullTaxonomyTip, regenWakePathDroneLabel, } from './regen-format.js';
+import { startLogStream, getStreamStatus } from './log-stream.js';
+import { isMcpReadinessProbe } from './readiness-probe.js';
+import { runMcpStartupServices } from './startup-services.js';
+import { TOOL_MANIFEST } from './tool-manifest.js';
+import { DOCS_SECTIONS, matchDocsSections, formatDocsIndex } from './docs-sections.js';
+import { renderRoleList } from './list-roles-render.js';
+import { filterToolsForRole } from './tool-scope.js';
+import { getPackageVersion, getOnDiskVersion, handleVersionFlag } from './version.js';
+import { renderStreamStatus, checkInboxMonitorHealthy, formatWakePathPrefix, shouldShowWakePathWarning, } from './stream-status.js';
+import { formatRoleAgentLabel, formatWorkingRepoLabel, renderRoster } from './roster-render.js';
+import { resolveWorkingRepo } from './working-repo.js';
+import { DroneEvictedError, formatEvictedToolResult, } from './drone-lifecycle.js';
+import { classifyInSessionAssimilate, reattachOnlyRefusal, reattachFailureMessage, } from './assimilate-guard.js';
+import { gateAllowsActivation, borgSessionToolNotice } from './launch-gate.js';
+import { renderSyncRolesResult } from './sync-roles-render.js';
+import { initConsolePrefix, consolePrefix } from './console-prefix.js';
+import { resolveSessionAgentKind, } from './codex-app-wake.js';
+import { connectOpenCodeDrone, injectOpenCodeEntry, computeOpenCodePort, } from './opencode-drone.js';
+import { installBorgPlugin } from './opencode-plugin.js';
+import { setModuleInjectOpenCode } from './log-stream.js';
+import { lifecycleSignalForMessage, recordLifecycleLog, shouldSuppressLifecycleLog, } from './lifecycle-log-guard.js';
+import { normalizeDirectLogRecipients, } from './direct-log.js';
+import { formatLocalManageToolResult } from './local-manage-tool-result.js';
+import { runEvictDroneTool, runReassignDroneTool, } from './drone-management.js';
+/**
+ * Apply a template's roles + message_taxonomy to a cube.
+ *
+ * gh#473 PR2 — delegates to the NON-CLOBBERING server route. New roles
+ * are inserted; existing template-named roles get ADD fragments (template
+ * sections/classes the cube lacks) auto-applied, but EVOLVED (conflicting)
+ * fragments are surfaced server-side and KEPT — never silently
+ * overwritten. The old per-role blanket `updateRole`/whole-taxonomy
+ * `updateCube` overwrite path is removed. Operators who want to take the
+ * template version of a conflicting fragment use `borg_sync-roles` with a
+ * `decisions` map. Returns `{ created, updated }` for the caller's toast.
+ */
+async function applyTemplateToCube(cubeId, template) {
+    return await applyTemplate(cubeId, template.name);
+}
+/**
+ * Throw a friendly error if the client has not been assimilated to a cube.
+ */
+async function requireActiveCube() {
+    const active = await getActiveCube();
+    if (!active) {
+        throw new Error('Not assimilated to a cube. Use borg_assimilate <cube-name> first.');
+    }
+    return active;
+}
+/**
+ * Main entry point - MCP stdio server
+ */
+export async function main() {
+    // Honor `--version` / `-v` BEFORE any side-effecting work (hooks,
+    // readiness checks, stream consumer spawn, MCP handshake). Lets
+    // operators run `borg-mcp --version` cleanly to confirm the
+    // installed client version.
+    handleVersionFlag();
+    const readinessProbe = isMcpReadinessProbe();
+    await runMcpStartupServices(readinessProbe, {
+        // Auto-register the SessionStart hook so existing users get borg-regen
+        // auto-orientation on session start without re-running borg setup. Idempotent.
+        sessionStartHook: () => {
+            addSessionStartHook();
+        },
+        // Auto-register the UserPromptSubmit audit hook so the drone gets a
+        // nudge if the previous assistant span used state-changing tools
+        // without calling borg_log. Domain-agnostic — knows nothing about git
+        // or any specific convention. Idempotent.
+        auditHook: () => {
+            addUserPromptSubmitHook();
+        },
+        // Spawn the SSE log-stream consumer. This gives drones real-time
+        // wakeup: when another drone posts to the cube, the worker pushes
+        // an `event: log` over SSE, the consumer appends one line to the
+        // per-drone inbox file (see inboxPathForDrone in cubes.ts), and the
+        // launcher's Monitor wakes the active /loop iteration immediately.
+        // Same inbox-file shape as the prior long-poll path — the file is
+        // still the harness-side wake primitive — only the wire layer
+        // changed. See:
+        //   docs/superpowers/specs/2026-05-11-server-push-log-subscription.md
+        // Failure here is non-fatal — the launcher's fallback heartbeat
+        // still keeps things moving.
+        sseStream: () => {
+            startLogStream();
+        },
+        // gh#opencode: initialize opencode drone module for autonomous entry
+        // injection. Installs the plugin (idempotent) and connects the SDK client
+        // when the runtime is opencode (BORG_OPENCODE=1). The module-level
+        // injectOpenCode hook routes SSE entries into the TUI's session.
+        // Best-effort; never breaks the MCP server.
+        openCode: async () => {
+            installBorgPlugin();
+            const active = await getActiveCube();
+            if (active && process.env.BORG_OPENCODE === '1') {
+                const port = computeOpenCodePort(active.droneId);
+                const serverUrl = `http://127.0.0.1:${port}`;
+                await connectOpenCodeDrone({
+                    serverUrl,
+                    directory: process.cwd(),
+                    droneLabel: active.droneLabel,
+                    cubeName: active.name,
+                });
+                setModuleInjectOpenCode(injectOpenCodeEntry);
+            }
+        },
+    });
+    // Create MCP server. `version` is the installed borgmcp version
+    // (T1.4 of 0.6.0): read at runtime from package.json so Claude
+    // Code's `/mcp` view shows the real version instead of the
+    // long-standing hardcoded "0.1.0".
+    const server = new Server({
+        name: 'borg-mcp-client',
+        version: getPackageVersion(),
+    }, {
+        capabilities: {
+            tools: {},
+            prompts: {},
+        },
+    });
+    // gh#899: tool definitions built once at setup, then role-scoped per caller
+    // in the ListTools handler below (the dispatcher reaches deferred tools).
+    const allToolDefs = TOOL_MANIFEST;
+    // Register tool listing — role-scope the native surface (gh#899). Missing role
+    // (old cubes.json / pre-assimilate) → full set; deferred tools stay reachable
+    // via borg_tool. Never an auth boundary — live per-client cube grants govern.
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        let scope = null;
+        try {
+            const active = await getActiveCube();
+            if (active) {
+                scope = { roleName: active.roleName, roleClass: active.roleClass, isHumanSeat: active.isHumanSeat };
+            }
+        }
+        catch {
+            scope = null; // unreadable cube state → full set (fail-safe)
+        }
+        return { tools: filterToolsForRole(allToolDefs, scope) };
+    });
+    // Register tool execution handler
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        let { name, arguments: args } = request.params;
+        // gh#899: borg_describe-tool — schema-only, NEVER executes. Returns the
+        // named tool's def from allToolDefs so a role-scoped session can learn a
+        // deferred tool's arguments before invoking it via borg_tool.
+        if (name === 'borg_describe-tool') {
+            const target = typeof args?.name === 'string' ? args.name : '';
+            const def = allToolDefs.find((t) => t.name === target);
+            if (!def) {
+                return {
+                    content: [{ type: 'text', text: `Unknown borg tool: ${target || '(none)'}. Pass { name: "<borg_tool>" }.` }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ name: def.name, description: def.description, inputSchema: def.inputSchema }, null, 2) }],
+            };
+        }
+        // gh#899: borg_tool dispatcher — unwrap to the inner tool and fall through
+        // to the SAME switch below (identical activation gate + per-tool auth/Zod
+        // validation; no weaker entry — the server's live cube-grant boundary is
+        // unchanged). Guards against dispatcher self-reference / recursion.
+        if (name === 'borg_tool') {
+            const inner = typeof args?.name === 'string' ? args.name : '';
+            if (!inner || inner === 'borg_tool' || inner === 'borg_describe-tool') {
+                return {
+                    content: [{ type: 'text', text: 'borg_tool: pass { name: "<borg_tool>", arguments: {...} } naming a real borg tool (not the dispatcher itself).' }],
+                    isError: true,
+                };
+            }
+            args = (args?.arguments && typeof args.arguments === 'object')
+                ? args.arguments
+                : {};
+            name = inner;
+        }
+        // gh#673 P1 (WI-5): the borg tool surface activates only in
+        // borg-launched sessions — BOTH harnesses ride the same gate. A
+        // vanilla `claude`/`codex` gets a non-silent re-launch notice per
+        // tool, never a half-activated, un-wakeable drone; ListTools stays
+        // intact so the agent learns WHY. Claude children inherit
+        // BORG_SESSION from the wrapper's launchEnv; codex children receive
+        // it via the per-launch `-c mcp_servers.borg.env.BORG_SESSION="1"`
+        // override (codexBorgSessionConfigArgs — inherited env never reaches
+        // codex MCP children, V2/V2b probes). ACTIVATION-only per the SR
+        // binding — never a security decision (server auth unchanged).
+        if (!gateAllowsActivation(`tool ${name}`)) {
+            return {
+                content: [{ type: 'text', text: borgSessionToolNotice(name) }],
+                isError: true,
+            };
+        }
+        try {
+            switch (name) {
+                case 'borg_regen': {
+                    const active = await getActiveCube();
+                    if (!active) {
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: 'Not connected to a cube. Use `borg_assimilate cube_name="<name>"` to join one.',
+                                },
+                            ],
+                        };
+                    }
+                    const since = typeof args?.since === 'string' ? args.since : undefined;
+                    const mode = args?.mode === 'lite' ? 'lite' : 'full';
+                    const reportedModel = typeof args?.model === 'string' ? args.model : undefined;
+                    const result = await regen(active.sessionToken, active.apiUrl, {
+                        since,
+                        reportedModel,
+                        workingRepo: resolveWorkingRepo(),
+                        serverTrustIdentity: active.serverTrustIdentity,
+                    });
+                    const freshActive = activeCubeWithFreshRegenIdentity(active, result);
+                    if (freshActive !== active) {
+                        await refreshActiveCubeMetadata(freshActive);
+                    }
+                    // Wake-path self-heal (gh#43): SSE delivery to the inbox file
+                    // is independent from Claude Code waking on file writes. The
+                    // latter requires a `tail -F` Monitor against the inbox path;
+                    // if that Monitor dies (or was never armed across a session
+                    // boundary), the drone misses every incoming entry until the
+                    // /loop fallback heartbeat. Because regen runs on every /loop
+                    // iteration, surfacing the breakage here gives self-healing at
+                    // worst-case latency = the heartbeat interval. Mirrors the
+                    // State-5 self-arm instruction in stream-status.ts.
+                    const streamStatus = getStreamStatus();
+                    const inboxPath = inboxPathForDrone(freshActive.cubeId, freshActive.droneId);
+                    const monitorStateRoot = monitorStateRootForWorktree(findProjectRoot());
+                    // Non-Claude CLIs do not use the Claude inbox Monitor. Keep the
+                    // agent CLI distinction independent from whether Codex's optional
+                    // remote-wake transport is currently armed.
+                    const agentKind = resolveSessionAgentKind();
+                    const inboxMonitorHealthy = agentKind === 'claude'
+                        ? checkInboxMonitorHealthy(inboxPath, monitorStateRoot)
+                        : true;
+                    const prefix = shouldShowWakePathWarning(streamStatus, inboxMonitorHealthy)
+                        ? formatWakePathPrefix({
+                            inboxPath,
+                            monitorStateRoot,
+                            droneLabel: regenWakePathDroneLabel(result, freshActive.droneLabel),
+                            cubeName: freshActive.name,
+                        })
+                        : '';
+                    // gh#285: version-mismatch nudge when on-disk package is newer.
+                    let versionHeader = '';
+                    try {
+                        const running = getPackageVersion();
+                        const onDisk = getOnDiskVersion();
+                        if (running !== 'unknown' && onDisk !== 'unknown' && onDisk !== running) {
+                            const [rMaj, rMin, rPat] = running.split('.').map(Number);
+                            const [dMaj, dMin, dPat] = onDisk.split('.').map(Number);
+                            const onDiskNewer = dMaj > rMaj || (dMaj === rMaj && dMin > rMin) || (dMaj === rMaj && dMin === rMin && dPat > rPat);
+                            if (onDiskNewer) {
+                                versionHeader = `## 🔄 borgmcp ${onDisk} installed — run /mcp and reconnect (or restart Claude Code) to apply. Currently running ${running}.\n\n`;
+                            }
+                        }
+                    }
+                    catch { /* never break regen */ }
+                    return { content: [{ type: 'text', text: versionHeader + prefix + formatRegenMarkdown(result, { mode }) }] };
+                }
+                case 'borg_assimilate': {
+                    const cubeName = args?.cube_name;
+                    if (!cubeName)
+                        throw new Error('cube_name is required');
+                    // gh#780 (Queen ruling 33a62d94): RE-ATTACH-ONLY. The old handler
+                    // used the retired attach path, which always minted a new drone row —
+                    // so agents "recovering" from auth blips spawned orphan seats.
+                    // This tool now re-attaches to the worktree's saved identity or
+                    // refuses with CLI guidance; it is structurally incapable of
+                    // minting. Seat creation lives in the CLI (`borg assimilate`).
+                    const active = await getActiveCube();
+                    const decision = classifyInSessionAssimilate(active, cubeName);
+                    if (decision.kind !== 'reattach') {
+                        return {
+                            content: [{ type: 'text', text: reattachOnlyRefusal(decision, cubeName) }],
+                            isError: true,
+                        };
+                    }
+                    // Re-attach = serve the saved identity through the
+                    // server-validated regen path (SR cond-4: no fabricated success
+                    // — an evicted/revoked seat FAILS server-side and is surfaced).
+                    try {
+                        const result = await regen(active.sessionToken, active.apiUrl, {
+                            workingRepo: resolveWorkingRepo(),
+                            serverTrustIdentity: active.serverTrustIdentity,
+                        });
+                        const freshActive = activeCubeWithFreshRegenIdentity(active, result);
+                        if (freshActive !== active) {
+                            await refreshActiveCubeMetadata(freshActive);
+                        }
+                        const header = [
+                            `# Re-attached to cube: ${freshActive.name}`,
+                            ``,
+                            `**Drone label:** ${freshActive.droneLabel}`,
+                            `**Seat:** existing identity reused — no new drone minted (gh#780)`,
+                            ``,
+                            ``,
+                        ].join('\n');
+                        return {
+                            content: [{ type: 'text', text: header + formatRegenMarkdown(result, { mode: 'full' }) }],
+                        };
+                    }
+                    catch (err) {
+                        const failure = reattachFailureMessage(err ?? {});
+                        return { content: [{ type: 'text', text: failure }], isError: true };
+                    }
+                }
+                case 'borg_version': {
+                    return { content: [{ type: 'text', text: `borgmcp ${getPackageVersion()}` }] };
+                }
+                case 'borg_playbook': {
+                    // gh#912: serve the on-demand operating-playbook chapter (static
+                    // client-side text — no cube/auth needed; the rule-spine is already
+                    // inline in regen). Lets the bootstrap regen stay light.
+                    return { content: [{ type: 'text', text: getDronePlaybookChapter() }] };
+                }
+                case 'borg_docs': {
+                    // gh#docs-site B: return the docs index (URLs + summaries) so the agent
+                    // can WebFetch the right page. No server-side fetch, no search service —
+                    // the topic match is a lazy keyword filter over DOCS_SECTIONS.
+                    const topic = typeof args?.topic === 'string' ? args.topic.trim() : '';
+                    const matched = topic ? matchDocsSections(topic) : [];
+                    const sections = matched.length > 0 ? matched : DOCS_SECTIONS;
+                    const header = topic && matched.length > 0
+                        ? `Best-matching docs section(s) for "${topic}" — WebFetch the URL for the full page:`
+                        : topic
+                            ? `No exact match for "${topic}". Full Borg MCP docs index — WebFetch the URL you need:`
+                            : `Borg MCP docs index — WebFetch the URL of the section you need:`;
+                    return { content: [{ type: 'text', text: `${header}\n\n${formatDocsIndex(sections)}` }] };
+                }
+                case 'borg_whoami': {
+                    const active = await requireActiveCube();
+                    const result = await whoami(active.sessionToken, active.apiUrl, active.serverTrustIdentity);
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                }
+                case 'borg_cube': {
+                    // No-cache invariant (T1.2 — 0.7.0): both `getCubeInfo` and
+                    // `getRoleInfo` MUST fetch fresh per invocation. Never
+                    // memoize / cache the cube or role payload in process memory
+                    // or in `cubes.json` — `borg_reassign-drone` changes the
+                    // calling drone's role in the DB, and subsequent
+                    // `borg_cube` reads MUST reflect the new role within one
+                    // round-trip. Locked in by the regression probe at
+                    // `client/__tests__/integration/01-role-cache-freshness.integration.ts`;
+                    // a future refactor that introduces caching here will fail
+                    // that probe. See drone-8's 19:38:56 observation + drone-6's
+                    // 06:00:31 finding for the original incident trace.
+                    const active = await requireActiveCube();
+                    const [{ cube, roles }] = await Promise.all([
+                        getCubeInfo(active.sessionToken, active.apiUrl, active.serverTrustIdentity),
+                        getRoleInfo(active.sessionToken, active.apiUrl, active.serverTrustIdentity),
+                    ]);
+                    const lines = [];
+                    lines.push(`# Cube: ${cube.name}`);
+                    lines.push('');
+                    lines.push('## Cube directive');
+                    lines.push(cube.cube_directive || '_(none)_');
+                    lines.push('');
+                    const taxonomyTip = nullTaxonomyTip(cube.message_taxonomy);
+                    if (taxonomyTip) {
+                        lines.push(taxonomyTip);
+                        lines.push('');
+                    }
+                    lines.push('## Roles in this cube');
+                    if (!roles.length) {
+                        lines.push('_(no roles defined)_');
+                    }
+                    else {
+                        for (const r of roles) {
+                            const tags = [
+                                r.role_class === 'queen' ? 'Queen' : null,
+                                r.is_human_seat ? 'human-seat' : null,
+                                r.is_default ? 'default' : null,
+                                r.is_mandatory ? 'mandatory' : null,
+                            ].filter(Boolean).join(', ');
+                            const marker = tags ? ` (${tags})` : '';
+                            const desc = r.short_description || '_(no description)_';
+                            lines.push(`- **${r.name}**${marker} — ${desc}`);
+                        }
+                        // Sprint 6 / gh#153 discoverability nudge per drone-7 UX-FEEDBACK:
+                        // point Coordinator-class readers at the tool that surfaces role IDs.
+                        lines.push('');
+                        lines.push('_(Coordinator-class drones can fetch role IDs via `borg_list-roles` for use with `borg_reassign-drone`.)_');
+                    }
+                    lines.push('');
+                    lines.push(getDronePlaybook());
+                    return { content: [{ type: 'text', text: lines.join('\n') }] };
+                }
+                case 'borg_role': {
+                    // No-cache invariant (T1.2 — 0.7.0): role reads MUST fetch
+                    // fresh per invocation. See 01-role-cache-freshness.integration.ts.
+                    const active = await requireActiveCube();
+                    const requested = typeof args?.role === 'string' ? args.role.trim() : '';
+                    if (requested) {
+                        const { role } = await getRoleInfoByName(active.sessionToken, active.apiUrl, requested, active.serverTrustIdentity);
+                        assertRoleMatches(requested, role);
+                        const text = [
+                            `# Role: ${role.name}`,
+                            ``,
+                            role.detailed_description || '_(no detailed description set)_',
+                        ].join('\n');
+                        return { content: [{ type: 'text', text }] };
+                    }
+                    const { role } = await getRoleInfo(active.sessionToken, active.apiUrl, active.serverTrustIdentity);
+                    const text = [
+                        `# Your role: ${role.name}`,
+                        ``,
+                        role.detailed_description || '_(no detailed description set)_',
+                    ].join('\n');
+                    return { content: [{ type: 'text', text }] };
+                }
+                case 'borg_role-rationale': {
+                    const active = await requireActiveCube();
+                    const role = typeof args?.role === 'string' ? args.role : '';
+                    const section = typeof args?.section === 'string' ? args.section : '';
+                    const result = await roleRationale(active.sessionToken, active.apiUrl, role, section, active.serverTrustIdentity);
+                    const text = [
+                        `# Role rationale: ${result.role} — ${result.section}`,
+                        '',
+                        result.body || '_(empty)_',
+                    ].join('\n');
+                    return { content: [{ type: 'text', text }] };
+                }
+                case 'borg_roster': {
+                    const active = await requireActiveCube();
+                    const since = typeof args?.since === 'string' ? args.since : undefined;
+                    const { drones, roles, since: resolvedSince } = await getRoster(active.sessionToken, active.apiUrl, since, active.serverTrustIdentity);
+                    const text = renderRoster({
+                        cubeName: active.name,
+                        drones,
+                        roles,
+                        resolvedSince: resolvedSince ?? null,
+                        humanAgo,
+                    });
+                    return { content: [{ type: 'text', text }] };
+                }
+                case 'borg_stream-status': {
+                    // Probe the in-process SSE consumer state. Does NOT require
+                    // an active cube — if the consumer hasn't started or is
+                    // between cubes, the snapshot still reports current values.
+                    // Also probes wake-path completeness (T1.2): is anyone tailing
+                    // the inbox file? Without that, SSE delivery still works but
+                    // the harness `/loop` never wakes on the file write.
+                    const status = getStreamStatus();
+                    const active = await getActiveCube();
+                    const inboxPath = active
+                        ? inboxPathForDrone(active.cubeId, active.droneId)
+                        : null;
+                    const monitorStateRoot = active
+                        ? monitorStateRootForWorktree(findProjectRoot())
+                        : null;
+                    // Non-Claude CLIs have their own wake mechanism, so this Claude-only
+                    // Monitor diagnostic must not be inferred from Codex transport state.
+                    const nonClaudeSession = active && resolveSessionAgentKind() !== 'claude';
+                    const inboxMonitorHealthy = active
+                        ? nonClaudeSession
+                            ? true
+                            : checkInboxMonitorHealthy(inboxPath, monitorStateRoot)
+                        : null;
+                    let silentInertWarning = '';
+                    if (status.runLoopHealth === 'silent-inert') {
+                        silentInertWarning = '## ⚠ SSE stream loop silent-inert — run /mcp and reconnect to restart\n\n' +
+                            'The log-stream consumer started but never connected. This drone will not receive real-time cube events.\n\n';
+                    }
+                    const text = renderStreamStatus({
+                        status,
+                        inboxMonitorHealthy,
+                        inboxPath,
+                        monitorStateRoot,
+                        droneLabel: active?.droneLabel ?? null,
+                        cubeName: active?.name ?? null,
+                        humanAgo,
+                    });
+                    return { content: [{ type: 'text', text: silentInertWarning + text }] };
+                }
+                case 'borg_read-log': {
+                    const active = await requireActiveCube();
+                    const since = typeof args?.since === 'string' ? args.since : undefined;
+                    const limit = typeof args?.limit === 'number' ? args.limit : undefined;
+                    const unreadOnly = args?.unread_only === true || args?.unread_only === 'true';
+                    const { entries, drones, roles, behind_by, has_more } = await readLog(active.sessionToken, active.apiUrl, {
+                        since,
+                        limit,
+                        unreadOnly,
+                        serverTrustIdentity: active.serverTrustIdentity,
+                    });
+                    const droneById = new Map();
+                    for (const d of drones)
+                        droneById.set(d.id, d);
+                    const roleById = new Map();
+                    for (const r of roles)
+                        roleById.set(r.id, r);
+                    const lines = [];
+                    lines.push(`# Activity log: ${active.name}`);
+                    lines.push('');
+                    if (!entries.length) {
+                        lines.push('_(no entries)_');
+                    }
+                    else {
+                        for (const e of entries) {
+                            lines.push(formatLogEntryMarkdown(e, droneById, roleById));
+                        }
+                    }
+                    // gh#709 part B: nudge a behind drone to drain. `behind_by` is the
+                    // count of entries VISIBLE to this drone still unread AFTER this read
+                    // advanced the watermark — if > 0 you under-read (limit-capped or a
+                    // non-cursor read) and will skip messages unless you keep reading.
+                    if (has_more === true) {
+                        lines.push('');
+                        lines.push(`⚠ has_more: true — call \`borg_read-log unread_only=true\` again until has_more=false so you finish draining unread entries.`);
+                    }
+                    else if (typeof behind_by === 'number' && behind_by > 0) {
+                        lines.push('');
+                        lines.push(`⚠ behind_by: ${behind_by} more unread ${behind_by === 1 ? 'entry' : 'entries'} addressed to you — call \`borg_read-log unread_only=true\` again until behind_by=0 so you don't skip messages.`);
+                    }
+                    return { content: [{ type: 'text', text: lines.join('\n') }] };
+                }
+                case 'borg_log': {
+                    const message = args?.message;
+                    if (!message || typeof message !== 'string')
+                        throw new Error('message is required');
+                    const active = await getActiveCube();
+                    if (!active)
+                        throw new Error('Not assimilated to a cube. Use borg_assimilate <cube-name> first.');
+                    if (lifecycleSignalForMessage(message)) {
+                        const decision = await shouldSuppressLifecycleLog(active, message);
+                        if (decision.suppress) {
+                            await recordLifecycleLog(active, message);
+                            return {
+                                content: [
+                                    {
+                                        type: 'text',
+                                        text: `Suppressed duplicate ${decision.signal?.toUpperCase()} lifecycle log for ${active.droneLabel}; recent cube log already contains this signal.`,
+                                    },
+                                ],
+                            };
+                        }
+                    }
+                    const hasTo = Object.prototype.hasOwnProperty.call(args ?? {}, 'to');
+                    const recipients = hasTo ? normalizeDirectLogRecipients(args?.to) : undefined;
+                    const explicitClass = typeof args?.class === 'string' ? args.class : undefined;
+                    const visibility = args?.visibility === 'broadcast' || args?.visibility === 'direct'
+                        ? args.visibility
+                        : undefined;
+                    if (!active.serverTrustIdentity) {
+                        throw new Error('Selected Borg server authority state is missing or unreadable');
+                    }
+                    const appendOpts = {
+                        ...(explicitClass ? { class: explicitClass } : {}),
+                        ...(hasTo ? { to: recipients ?? [] } : {}),
+                        ...(visibility ? { visibility } : {}),
+                        serverTrustIdentity: active.serverTrustIdentity,
+                    };
+                    const result = await appendLog(active.sessionToken, active.apiUrl, message, appendOpts);
+                    await recordLifecycleLog(active, message);
+                    const echo = result.routing?.message ? `\n${result.routing.message}` : '';
+                    // gh#534: surface to the SENDER which directed recipients are
+                    // currently unreachable via the wake path. The message is delivered
+                    // regardless (persisted server-side); they read it when they return.
+                    const unreachable = result.unreachableRecipients?.length
+                        ? `\n⚠ ${result.unreachableRecipients.length} directed recipient(s) currently unreachable (wake-path:deaf): ${result.unreachableRecipients
+                            .map((r) => r.label)
+                            .join(', ')}. Message delivered — they'll read it when they return.`
+                        : '';
+                    const text = `Logged to cube "${active.name}" as ${active.droneLabel}. (entry id: ${result.entry.id})${echo}${unreachable}`;
+                    return { content: [{ type: 'text', text }] };
+                }
+                case 'borg_ack': {
+                    const entryId = args?.entry_id;
+                    if (!entryId || typeof entryId !== 'string') {
+                        throw new Error('entry_id is required');
+                    }
+                    // gh#418: default 'ack'. Only 'claim' is the other allowed kind; the
+                    // worker re-validates at the Zod boundary so an unknown value is
+                    // rejected server-side, but normalize here to keep the wire clean.
+                    const kind = args?.kind === 'claim' ? 'claim' : 'ack';
+                    const active = await requireActiveCube();
+                    await ackLogEntry(active.sessionToken, active.apiUrl, entryId, kind, active.serverTrustIdentity);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: kind === 'claim'
+                                    ? `Claimed entry ${entryId} in cube "${active.name}" (advisory — merge stays keyed on REVIEW-APPROVED).`
+                                    : `Acked entry ${entryId} in cube "${active.name}".`,
+                            },
+                        ],
+                    };
+                }
+                case 'borg_decide': {
+                    const topic = args?.topic;
+                    const decision = args?.decision;
+                    if (!topic || typeof topic !== 'string')
+                        throw new Error('topic is required');
+                    if (!decision || typeof decision !== 'string')
+                        throw new Error('decision is required');
+                    const rationale = typeof args?.rationale === 'string' ? args.rationale : undefined;
+                    const active = await requireActiveCube();
+                    const { decision: row } = await recordDecision(active.sessionToken, active.apiUrl, {
+                        topic,
+                        decision,
+                        ...(rationale !== undefined ? { rationale } : {}),
+                    }, active.serverTrustIdentity);
+                    const superseded = row?.supersedes ? ' (superseded the prior decision on this topic)' : '';
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Recorded ratified decision on "${topic}" in cube "${active.name}"${superseded}. Cite it via borg_decisions; it surfaces in borg_regen.`,
+                            },
+                        ],
+                    };
+                }
+                case 'borg_decisions': {
+                    const topic = typeof args?.topic === 'string' ? args.topic : undefined;
+                    const active = await requireActiveCube();
+                    const { decisions } = await listDecisions(active.sessionToken, active.apiUrl, topic, active.serverTrustIdentity);
+                    const text = decisions.length === 0
+                        ? topic
+                            ? `No active ratified decision on "${topic}" in cube "${active.name}".`
+                            : `No active ratified decisions in cube "${active.name}".`
+                        : decisions
+                            .map((d) => `**${d.topic}:** ${d.decision}${d.rationale ? ` — ${d.rationale}` : ''}`)
+                            .join('\n');
+                    return { content: [{ type: 'text', text }] };
+                }
+                case 'borg_remove-decision': {
+                    const topic = typeof args?.topic === 'string' ? args.topic : undefined;
+                    const decisionId = typeof args?.decision_id === 'string' ? args.decision_id : undefined;
+                    if (Number(topic !== undefined) + Number(decisionId !== undefined) !== 1) {
+                        throw new Error('provide exactly one of topic or decision_id');
+                    }
+                    const active = await requireActiveCube();
+                    const selector = topic !== undefined ? { topic } : { decision_id: decisionId };
+                    const { decision } = await removeDecision(active.sessionToken, active.apiUrl, selector, active.serverTrustIdentity);
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: `Removed the active ratified decision on "${decision.topic}" from cube "${active.name}".`,
+                            }],
+                    };
+                }
+                case 'borg_list-cubes': {
+                    const { cubes } = await listCubes();
+                    if (!cubes.length) {
+                        return { content: [{ type: 'text', text: 'No cubes yet. Use borg_create-cube to make your first one.' }] };
+                    }
+                    const lines = cubes.map((c) => `- **${c.name}** (id: ${c.id})\n  ${(c.cube_directive || '_(no directive set)_').split('\n')[0].slice(0, 120)}`);
+                    return { content: [{ type: 'text', text: `Your cubes (${cubes.length}):\n\n${lines.join('\n\n')}` }] };
+                }
+                case 'borg_create-cube': {
+                    const name = args?.name;
+                    const cubeDirective = args?.cube_directive;
+                    const templateName = args?.template;
+                    if (!name)
+                        throw new Error('name is required');
+                    if (cubeDirective === undefined)
+                        throw new Error('cube_directive is required (pass empty string if none)');
+                    // Resolve template (validates name early so the cube isn't
+                    // created in a partial state if the template name is wrong).
+                    let template = null;
+                    if (templateName) {
+                        template = getTemplate(templateName);
+                        if (!template) {
+                            throw new Error(`Unknown template "${templateName}". Available: ${listTemplateNames().join(', ')}`);
+                        }
+                    }
+                    // Sprint 14: template cube_directive fills empty operator input.
+                    // Operator-supplied text takes precedence — templates fill
+                    // the blank, never stomp.
+                    const resolvedCubeDirective = resolveCubeDirectiveForCreate(cubeDirective, template);
+                    // v0.9.2: createCube now returns the flat shape directly
+                    // (see remote-client unwrap). `cube.id` / `cube.name` work
+                    // verbatim on the returned object.
+                    const resolvedMessageTaxonomy = resolveMessageTaxonomyForCreate(undefined, template);
+                    const cube = await createCube(name, resolvedCubeDirective, {
+                        message_taxonomy: resolvedMessageTaxonomy,
+                    });
+                    // Apply template roles if requested. Merges by name: any role the
+                    // server auto-seeded (e.g. "Drone") that the template doesn't
+                    // also include stays put; templated roles upsert.
+                    if (template) {
+                        const summary = await applyTemplateToCube(cube.id, template);
+                        const cubeDirectiveNote = resolvedCubeDirective !== cubeDirective
+                            ? ' Template cube directive applied (operator passed empty).'
+                            : '';
+                        const text = `Created cube **${cube.name}** (id: ${cube.id}) with template **${templateName}** applied — ${summary.created} role(s) created, ${summary.updated} updated.${cubeDirectiveNote} Use borg_assimilate ${cube.name} to join as a drone.`;
+                        return { content: [{ type: 'text', text }] };
+                    }
+                    const text = `Created cube **${cube.name}** (id: ${cube.id}). A default "Drone" role was seeded — rename or replace it via borg_update-role / borg_create-role / borg_delete-role. Use borg_assimilate ${cube.name} to join as a drone.`;
+                    return { content: [{ type: 'text', text }] };
+                }
+                case 'borg_update-cube': {
+                    const cubeId = args?.cube_id;
+                    if (!cubeId)
+                        throw new Error('cube_id is required');
+                    const updates = {};
+                    if (typeof args?.name === 'string')
+                        updates.name = args.name;
+                    if (typeof args?.cube_directive === 'string')
+                        updates.cube_directive = args.cube_directive;
+                    if (Array.isArray(args?.message_taxonomy))
+                        updates.message_taxonomy = args.message_taxonomy;
+                    if (Object.keys(updates).length === 0)
+                        throw new Error('Pass at least one of: name, cube_directive, message_taxonomy.');
+                    const { cube } = await updateCube(cubeId, updates);
+                    return { content: [{ type: 'text', text: `Updated cube **${cube.name}** (id: ${cube.id}).` }] };
+                }
+                case 'borg_patch-taxonomy-class': {
+                    const cubeId = args?.cube_id;
+                    if (!cubeId)
+                        throw new Error('cube_id is required');
+                    const action = args?.action;
+                    if (action !== 'add' && action !== 'replace' && action !== 'remove') {
+                        throw new Error('action must be one of: add, replace, remove.');
+                    }
+                    let cube;
+                    let label;
+                    if (action === 'remove') {
+                        const className = args?.class;
+                        if (!className)
+                            throw new Error('class is required for remove.');
+                        ({ cube } = await patchTaxonomyClass(cubeId, { action, class: className }));
+                        label = className;
+                    }
+                    else {
+                        const classDef = args?.class_def;
+                        if (classDef == null || typeof classDef !== 'object' || Array.isArray(classDef)) {
+                            throw new Error('class_def (object) is required for add/replace.');
+                        }
+                        ({ cube } = await patchTaxonomyClass(cubeId, { action, class_def: classDef }));
+                        label = String(classDef.class ?? '');
+                    }
+                    const verb = action === 'add' ? 'Added' : action === 'replace' ? 'Replaced' : 'Removed';
+                    return { content: [{ type: 'text', text: `${verb} taxonomy class **${label}** in cube **${cube.name}** (id: ${cube.id}).` }] };
+                }
+                case 'borg_delete-cube': {
+                    const cubeId = args?.cube_id;
+                    if (!cubeId)
+                        throw new Error('cube_id is required');
+                    await deleteCube(cubeId);
+                    return { content: [{ type: 'text', text: `Deleted cube ${cubeId} (and all its roles, drones, log entries).` }] };
+                }
+                case 'borg_create-role': {
+                    const cubeId = args?.cube_id;
+                    const name = args?.name;
+                    const shortDesc = args?.short_description;
+                    const detailedDesc = args?.detailed_description;
+                    if (!cubeId)
+                        throw new Error('cube_id is required');
+                    if (!name)
+                        throw new Error('name is required');
+                    if (shortDesc === undefined)
+                        throw new Error('short_description is required (pass empty string if none)');
+                    if (detailedDesc === undefined)
+                        throw new Error('detailed_description is required (pass empty string if none)');
+                    const isDefault = args?.is_default === true;
+                    const isMandatory = args?.is_mandatory === true;
+                    const isHumanSeat = args?.is_human_seat === true;
+                    const canBroadcast = args?.can_broadcast === true;
+                    const receivesAllDirect = args?.receives_all_direct === true;
+                    const { role } = await createRole(cubeId, {
+                        name,
+                        short_description: shortDesc,
+                        detailed_description: detailedDesc,
+                        is_default: isDefault,
+                        is_mandatory: isMandatory,
+                        is_human_seat: isHumanSeat,
+                        can_broadcast: canBroadcast,
+                        receives_all_direct: receivesAllDirect,
+                        ...(typeof args?.default_model === 'string' ? { default_model: args.default_model } : {}),
+                    });
+                    const tags = [
+                        role.role_class === 'queen' ? 'Queen' : null,
+                        role.is_human_seat ? 'human-seat' : null,
+                        role.is_default ? 'default' : null,
+                        role.is_mandatory ? 'mandatory' : null,
+                    ].filter(Boolean).join(', ');
+                    const tag = tags ? ` (${tags})` : '';
+                    return { content: [{ type: 'text', text: `Created role **${role.name}**${tag} (id: ${role.id}) in cube ${cubeId}.` }] };
+                }
+                case 'borg_update-role': {
+                    const roleId = args?.role_id;
+                    if (!roleId)
+                        throw new Error('role_id is required');
+                    const updates = {};
+                    if (typeof args?.name === 'string')
+                        updates.name = args.name;
+                    if (typeof args?.short_description === 'string')
+                        updates.short_description = args.short_description;
+                    if (typeof args?.detailed_description === 'string')
+                        updates.detailed_description = args.detailed_description;
+                    if (typeof args?.is_default === 'boolean')
+                        updates.is_default = args.is_default;
+                    if (typeof args?.is_mandatory === 'boolean')
+                        updates.is_mandatory = args.is_mandatory;
+                    if (typeof args?.is_human_seat === 'boolean')
+                        updates.is_human_seat = args.is_human_seat;
+                    if (typeof args?.can_broadcast === 'boolean')
+                        updates.can_broadcast = args.can_broadcast;
+                    if (typeof args?.receives_all_direct === 'boolean')
+                        updates.receives_all_direct = args.receives_all_direct;
+                    if (typeof args?.default_model === 'string')
+                        updates.default_model = args.default_model;
+                    if (Object.keys(updates).length === 0)
+                        throw new Error('Pass at least one of: name, short_description, detailed_description, is_default, is_mandatory, is_human_seat, can_broadcast, receives_all_direct.');
+                    const { role } = await updateRole(roleId, updates);
+                    const tags = [
+                        role.role_class === 'queen' ? 'Queen' : null,
+                        role.is_human_seat ? 'human-seat' : null,
+                        role.is_default ? 'default' : null,
+                        role.is_mandatory ? 'mandatory' : null,
+                    ].filter(Boolean).join(', ');
+                    const tag = tags ? ` (${tags})` : '';
+                    return { content: [{ type: 'text', text: `Updated role **${role.name}**${tag} (id: ${role.id}).` }] };
+                }
+                case 'borg_patch-role-section': {
+                    const roleId = args?.role_id;
+                    if (!roleId)
+                        throw new Error('role_id is required');
+                    const action = args?.action;
+                    if (action !== 'replace' && action !== 'insert' && action !== 'delete') {
+                        throw new Error('action must be one of: replace, insert, delete.');
+                    }
+                    const heading = args?.heading;
+                    if (!heading)
+                        throw new Error('heading is required');
+                    let role;
+                    if (action === 'delete') {
+                        ({ role } = await patchRoleSection(roleId, { action, heading }));
+                    }
+                    else {
+                        const body = args?.body;
+                        if (typeof body !== 'string') {
+                            throw new Error('body is required for replace/insert (pass empty string for an empty section).');
+                        }
+                        if (action === 'insert') {
+                            const after = (typeof args?.after === 'string' ? args.after : null);
+                            ({ role } = await patchRoleSection(roleId, { action, heading, body, after }));
+                        }
+                        else {
+                            ({ role } = await patchRoleSection(roleId, { action, heading, body }));
+                        }
+                    }
+                    const verb = action === 'replace' ? 'Replaced' : action === 'insert' ? 'Inserted' : 'Deleted';
+                    return { content: [{ type: 'text', text: `${verb} section **${heading}** in role **${role.name}** (id: ${role.id}).` }] };
+                }
+                case 'borg_delete-role': {
+                    const roleId = args?.role_id;
+                    if (!roleId)
+                        throw new Error('role_id is required');
+                    await deleteRole(roleId);
+                    return { content: [{ type: 'text', text: `Deleted role ${roleId}.` }] };
+                }
+                case 'borg_reassign-drone': {
+                    return {
+                        content: [{ type: 'text', text: await runReassignDroneTool({
+                                    droneId: args?.drone_id,
+                                    roleId: args?.role_id,
+                                }) }],
+                    };
+                }
+                case 'borg_evict-drone': {
+                    return {
+                        content: [{ type: 'text', text: await runEvictDroneTool(args) }],
+                    };
+                }
+                case 'borg_list-drones': {
+                    const cubeId = args?.cube_id;
+                    if (!cubeId)
+                        throw new Error('cube_id is required');
+                    const { drones, roles } = await getCube(cubeId);
+                    if (!drones.length) {
+                        return { content: [{ type: 'text', text: 'No drones in this cube yet.' }] };
+                    }
+                    const rolesById = new Map(roles.map((r) => [r.id, r]));
+                    const lines = drones.map((d) => {
+                        const r = rolesById.get(d.role_id);
+                        const roleLabel = formatRoleAgentLabel(r?.name ?? '?', d.agent_kind);
+                        const wakeClass = d.wake_path_alert_class && d.wake_path_alert_class !== 'independent'
+                            ? ` — wake-path-class: ${d.wake_path_alert_class}`
+                            : '';
+                        const reportedModel = d.reported_model
+                            ? ` — Reported model: ${d.reported_model}`
+                            : ' — Reported model: not reported';
+                        const workingRepo = formatWorkingRepoLabel(d);
+                        const workingRepoText = workingRepo ? ` — ${workingRepo}` : '';
+                        return `- **${d.label}** (id: ${d.id}) — role: ${roleLabel} (${d.role_id}) — last seen ${d.last_seen}${wakeClass}${reportedModel}${workingRepoText}`;
+                    });
+                    return { content: [{ type: 'text', text: `Drones in cube ${cubeId} (${drones.length}):\n\n${lines.join('\n')}` }] };
+                }
+                case 'borg_list-roles': {
+                    // Sprint 6 / gh#153: surface role IDs to Coordinator-class drones
+                    // for use with borg_reassign-drone (e.g. promoting a drone to Queen).
+                    // Uses the same cube-grant-scoped GET /api/cubes/:id endpoint as
+                    // borg_list-drones — data is already accessible to the cube owner
+                    // over the local server; this tool just makes role IDs
+                    // discoverable inside the MCP tool namespace per drone-7's UX-FEEDBACK.
+                    // Render logic extracted to list-roles-render.ts for testability
+                    // per drone-3 QA-FAIL 2026-05-18T13:27:53Z.
+                    const cubeId = args?.cube_id;
+                    if (!cubeId)
+                        throw new Error('cube_id is required');
+                    const roles = await listRoles(cubeId);
+                    return { content: [{ type: 'text', text: renderRoleList(roles, cubeId) }] };
+                }
+                case 'borg_list-templates': {
+                    const names = listTemplateNames();
+                    const lines = names.map((n) => {
+                        const t = getTemplate(n);
+                        return `- **${n}**: ${t.description}`;
+                    });
+                    return { content: [{ type: 'text', text: `Available templates:\n\n${lines.join('\n')}` }] };
+                }
+                case 'borg_sync-roles': {
+                    const cubeId = args?.cube_id;
+                    const templateName = args?.template_name || 'software-dev';
+                    const apply = args?.apply === true;
+                    // gh#473 PR2 — per-conflict-fragment accept/reject decisions.
+                    // Keyed on the stable fragment key surfaced by the dry-run (e.g.
+                    // `role:Builder:section:Workflow`). Unspecified conflicts default
+                    // to REJECT (keep the cube's evolved text).
+                    const decisions = args?.decisions && typeof args.decisions === 'object'
+                        ? args.decisions
+                        : undefined;
+                    if (!cubeId)
+                        throw new Error('cube_id is required');
+                    const result = await syncRoles(cubeId, templateName, apply, decisions);
+                    return { content: [{ type: 'text', text: renderSyncRolesResult(result, templateName) }] };
+                }
+                case 'borg_apply-template': {
+                    const cubeId = args?.cube_id;
+                    const templateName = args?.template_name;
+                    if (!cubeId)
+                        throw new Error('cube_id is required');
+                    if (!templateName)
+                        throw new Error('template_name is required');
+                    const template = getTemplate(templateName);
+                    if (!template) {
+                        throw new Error(`Unknown template "${templateName}". Available: ${listTemplateNames().join(', ')}`);
+                    }
+                    const summary = await applyTemplateToCube(cubeId, template);
+                    // Sprint 14: optionally write template's cube_directive to the
+                    // cube. No-clobber discipline — only fills empty directives,
+                    // never overwrites operator-customized text.
+                    let cubeDirectiveNote = '';
+                    const cubeForRules = await getCube(cubeId);
+                    const newCubeDirective = resolveCubeDirectiveForApply(cubeForRules.cube_directive, template);
+                    if (newCubeDirective !== null) {
+                        await updateCube(cubeId, { cube_directive: newCubeDirective });
+                        cubeDirectiveNote = ' Template cube directive applied (cube directive was empty).';
+                    }
+                    return { content: [{ type: 'text', text: `Applied template **${templateName}** to cube ${cubeId} — ${summary.created} role(s) created, ${summary.updated} updated.${cubeDirectiveNote}` }] };
+                }
+                default:
+                    throw new Error(`Unknown tool: ${name}`);
+            }
+        }
+        catch (error) {
+            // gh#877: the drone-lifecycle verdict returns a RECOGNIZABLE tool RESULT
+            // (not a generic "Error: ..." the agent retries) so the /loop + role
+            // playbook can branch deterministically. Checked FIRST: an evicted seat is
+            // a lifecycle terminal — it gets its own recognizable result rather than
+            // the generic error rendering below.
+            if (error instanceof DroneEvictedError) {
+                const active = await getActiveCube();
+                return {
+                    content: [{ type: 'text', text: formatEvictedToolResult(active?.name) }],
+                    isError: true,
+                };
+            }
+            const localManageResult = formatLocalManageToolResult(error);
+            if (localManageResult)
+                return localManageResult;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Register prompts listing — the client exposes no prompts.
+    server.setRequestHandler(ListPromptsRequestSchema, async () => {
+        return { prompts: [] };
+    });
+    // Register prompt getter
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const { name } = request.params;
+        throw new Error(`Unknown prompt: ${name}`);
+    });
+    // Create stdio transport
+    const transport = new StdioServerTransport();
+    // Connect server to transport
+    await server.connect(transport);
+    // Resolve drone self-identification prefix before any console output
+    // (gh#25). Falls back to `[unassimilated · <repo>]` if no cube cached.
+    await initConsolePrefix();
+    console.error(`${consolePrefix()}◼ Borg MCP Client started`);
+    console.error(`${consolePrefix()}◼ Use borg_assimilate <cube-name> to join a cube as a drone`);
+    console.error(`${consolePrefix()}◼ Manage your cubes with borg --help`);
+}
+if (isEntryInvocation(process.argv[1], import.meta.url)) {
+    main().catch((error) => {
+        console.error(`${consolePrefix()}Fatal error:`, error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map