borgmcp 2.16.1 → 3.0.2

package/docs/SEAT_LIFECYCLE.md

@@ -17,7 +17,7 @@ Only two seat states are persisted:
 `revoked`, `superseded`, and `evicted` are server verdicts, not values written
 to `seats.json`. Revocation and supersession do not silently delete local
 state. An authoritative eviction is the sole verdict that permits the terminal
-assimilation flow to replace a rejected seat. `borg reset-local-seat` is the
+assimilation flow to replace a rejected seat. `borg reset-local-connection` is the
 explicit offline deletion path.
 
 Seat sessions do not expire. A legacy `expiresAt` field is ignored, and current
@@ -26,11 +26,11 @@ invitation can expire; recovery is to request a new invitation. An expired
 stream cursor is also separate from seat identity and is recovered by resetting
 the cursor and reconnecting.
 
-The whole seat store fails closed if any persisted record is malformed. The
+The whole private store fails closed if any persisted record is malformed. The
 store reader raises:
 
 ```text
-Borg seat store is malformed or has an unsupported version; refusing to read it
+Borg private store is malformed or has an unsupported version; refusing to read it
 ```
 
 The file is not rewritten and no bearer material is included in the error.
@@ -74,7 +74,7 @@ probes it. A live seat is reattached with the identical bearer; its saved role
 is authoritative, and no new drone is minted. The success line is:
 
 ```text
-re-attached to existing seat <drone-label> (same session, no new drone minted)
+re-attached as <drone-label> (same session, no new drone minted)
 ```
 
 Before relaunch, Borg checks the seat's inbox-monitor PID. A live holder refuses
@@ -82,7 +82,7 @@ the relaunch, names its PID, and gives both the safe fresh-worktree path and the
 explicit one-time override:
 
 ```text
-This worktree's Borg seat already has a live session (inbox monitor pid <pid>).
+This worktree's Borg drone already has a live session (inbox monitor pid <pid>).
 No agent was launched. Stop the existing session or use a fresh worktree with `borg assimilate --worktree <name>`. If the live monitor is wedged, override once with `borg assimilate --here --force`.
 ```
 
@@ -100,7 +100,7 @@ If a second monitor reaches the singleton after launch, it exits successfully
 without tailing and prints:
 
 ```text
-borg-inbox-monitor: seat inbox "<path>" is already monitored by a live instance (pid <pid>); yielding — another session likely holds this seat.
+borg-inbox-monitor: inbox "<path>" is already monitored by a live instance (pid <pid>); yielding — another session likely holds this worktree's connection.
 ```
 
 The existing monitor remains the sole inbox reader.
@@ -114,7 +114,7 @@ worktree to another cube.
 With no saved identity, it returns:
 
 ```text
-◼ This session has no drone seat for this worktree, and in-session borg_assimilate is re-attach-only (it never creates seats — gh#780). To create a seat for cube "<cube>", run `borg assimilate` in a terminal — it spawns the worktree, persists the identity, and launches the agent in one step.
+◼ This session has no drone for this worktree, and in-session borg_assimilate is re-attach-only (it never creates drones — gh#780). To create a drone for cube "<cube>", run `borg assimilate` in a terminal — it spawns the worktree, persists the identity, and launches the agent in one step.
 ```
 
 For another cube, it returns:
@@ -129,15 +129,15 @@ A successful in-session re-attach begins:
 # Re-attached to cube: <cube>
 
 **Drone label:** <drone-label>
-**Seat:** existing identity reused — no new drone minted (gh#780)
+**Drone:** existing identity reused — no new drone minted (gh#780)
 ```
 
 If the server no longer accepts the saved seat, the tool fails rather than
 reminting:
 
 ```text
-◼ Re-attach failed — this worktree's saved seat is unreachable (likely evicted or its session was revoked). Server said: <server-error>
-Recover by running `borg assimilate` in a terminal to create a fresh seat; in-session borg_assimilate never re-mints (gh#780).
+◼ Re-attach failed — this worktree's saved connection is unreachable (likely evicted or its session was revoked). Server said: <server-error>
+Recover by running `borg assimilate` in a terminal to create a fresh drone; in-session borg_assimilate never re-mints (gh#780).
 ```
 
 ## Terminal verdicts and recovery
@@ -149,12 +149,12 @@ does not mutate the saved seat. The exact output is one of:
 
 ```text
 Local session was revoked.
-Next: run borg reset-local-seat, then borg assimilate --host <server> --enroll.
+Next: run borg reset-local-connection, then borg assimilate --host <server> --enroll.
 ```
 
 ```text
 Local session was superseded by a newer enrollment.
-Next: run borg reset-local-seat, then borg assimilate --host <server> --enroll.
+Next: run borg reset-local-connection, then borg assimilate --host <server> --enroll.
 ```
 
 Run the named offline reset, obtain a new invitation, and enroll again.
@@ -171,7 +171,7 @@ If the attach itself returns the eviction after re-attach began, Borg does not
 claim recovery. It prints:
 
 ```text
-This worktree's saved seat on <server> was evicted. Remove this worktree, or from a fresh worktree run `borg assimilate --host <server>`.
+This worktree's drone on <server> was evicted. Remove this worktree, or from a fresh worktree run `borg assimilate --host <server>`.
 ```
 
 The stream path also treats typed `DRONE_EVICTED` as terminal: it marks that
@@ -188,20 +188,20 @@ The enrollment invitation for <server> was rejected or expired. Ask the server o
 
 ## Offline reset
 
-`borg reset-local-seat` clears only the current worktree's saved credential and
+`borg reset-local-connection` clears only the current worktree's saved credential and
 cube binding. It makes no network call, revokes nothing server-side, and leaves
 the server, trust anchor, cube, and sibling worktrees unchanged.
 
 Its shipped help describes the command as:
 
 ```text
-borg reset-local-seat (borgmcp <version>) — clear ONLY this worktree's saved local seat
+borg reset-local-connection (borgmcp <version>) — clear ONLY this worktree's saved connection to its cube
 
 Usage:
-  borg reset-local-seat                 Reset this worktree's saved seat (TTY confirms [y/N])
-  borg reset-local-seat --host <host>   No-op unless this worktree's seat is on <host>
-  borg reset-local-seat --yes           Reset without a prompt (required when non-interactive)
-  borg reset-local-seat --help          Show this help
+  borg reset-local-connection                 Reset this worktree's saved connection (TTY confirms [y/N])
+  borg reset-local-connection --host <host>   No-op unless this worktree connects to <host>
+  borg reset-local-connection --yes           Reset without a prompt (required when non-interactive)
+  borg reset-local-connection --help          Show this help
 ```
 
 The command snapshots the exact binding and token-safe bearer observation,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "borgmcp",
-  "version": "2.16.1",
+  "version": "3.0.2",
   "description": "Coordinate AI coding agents in shared cubes. Works with Claude Code, Codex, and OpenCode.",
   "type": "module",
   "main": "./dist/index.js",

package/src/assimilate-cmd.ts

@@ -615,7 +615,7 @@ function reportServerFailure(
     );
     return 1;
   }
-  if (/seat store lock file .* is stale/i.test(message)) {
+  if (/(?:private|seat) store lock file .* is stale/i.test(message)) {
     // RULED option (b): a lock whose recorded holder is DEAD (or whose payload is
     // corrupt) is NEVER auto-removed. Surface the fail-closed guidance verbatim —
     // it already names the exact lockfile path and the delete-only-if-no-borg
@@ -626,16 +626,16 @@ function reportServerFailure(
     );
     return 1;
   }
-  if (/(?:seat|credential) store is busy/i.test(message)) {
+  if (/(?:private|seat|credential) store is busy/i.test(message)) {
     deps.stderr(
-      `Borg's local seat store is busy for ${apiUrl} because another Borg process is ` +
-        `creating or resuming saved seat state. Wait for it to finish, then rerun ${retryCommand}.\n`,
+      `Borg's private store is busy for ${apiUrl} because another Borg process is ` +
+        `creating or resuming saved connection state. Wait for it to finish, then rerun ${retryCommand}.\n`,
     );
     return 1;
   }
-  if (/(?:local )?seat store|(?:secure )?credential (?:store|storage)/i.test(message)) {
+  if (/(?:(?:local )?(?:private|seat) store|(?:secure )?credential (?:store|storage))/i.test(message)) {
     deps.stderr(
-      `Borg could not access its local seat store for ${apiUrl}. ` +
+      `Borg could not access its private store for ${apiUrl}. ` +
         `Ensure its directory on this machine is readable and writable, then rerun ${retryCommand}.\n`,
     );
     return 1;
@@ -680,7 +680,7 @@ function reportServerFailure(
 }
 
 function resetLocalSeatCommand(apiUrl: string): string {
-  return `\`borg reset-local-seat --host ${apiUrl}\``;
+  return `\`borg reset-local-connection --host ${apiUrl}\``;
 }
 
 // Pin-matched terminal session diagnosis. This is intentionally output-only:
@@ -699,7 +699,7 @@ function diagnoseSessionTermination(
     : `borg assimilate --host ${apiUrl} --enroll`;
   deps.stderr(
     `${message}\n` +
-      `Next: run borg reset-local-seat, then ${recovery}.\n`,
+      `Next: run borg reset-local-connection, then ${recovery}.\n`,
   );
   return 1;
 }
@@ -1287,9 +1287,9 @@ export async function runAssimilate(
         }
       } else {
         deps.stderr(
-          `This worktree has saved seat metadata for ${authority.apiUrl}, but its local session ` +
-            'credential could not be loaded from the local seat store. No new seat was created. Run ' +
-            `${resetLocalSeatCommand(authority.apiUrl)} to clear this worktree's saved seat, then ` +
+          `This worktree has a saved connection to ${authority.apiUrl}, but its local session ` +
+            'credential could not be loaded from the private store. No drone was created. Run ' +
+            `${resetLocalSeatCommand(authority.apiUrl)} to clear this worktree's saved connection, then ` +
             `ask the operator for a new invitation and rerun ${localAssimilateCommand(authority.apiUrl, true)}.\n`,
         );
         return 1;
@@ -1301,8 +1301,8 @@ export async function runAssimilate(
         existing.serverTrustIdentity !== auth.serverTrustIdentity)
     ) {
       deps.stderr(
-        `This worktree's saved seat does not match ${authority.apiUrl}. ` +
-          'No new seat was created. Restore the expected server identity or use a fresh ' +
+        `This worktree's saved connection does not match ${authority.apiUrl}. ` +
+          'No drone was created. Restore the expected server identity or use a fresh ' +
           `worktree, then rerun ${localAssimilateCommand(authority.apiUrl)}.\n`,
       );
       return 1;
@@ -1323,7 +1323,7 @@ export async function runAssimilate(
       );
       // Canonical rotated/revoked path: a pin-matched 401 on THIS worktree's
       // saved bearer. PURE DIAGNOSIS — attach never mutates local state on a
-      // rejection; it points at the offline `borg reset-local-seat` command.
+      // rejection; it points at the offline `borg reset-local-connection` command.
       // Distinct from unreachable/404/5xx/trust-mismatch, which stay
       // indeterminate below.
       if (status === 'revoked') {
@@ -1338,7 +1338,7 @@ export async function runAssimilate(
         // The saved SESSION bearer was rejected WITHOUT the typed takeover code
         // (a bare/other 401). Non-destructive: re-enroll, never a seat reset.
         deps.stderr(
-          `The saved enrollment for ${authority.apiUrl} was rejected. No new seat was created ` +
+          `The saved enrollment for ${authority.apiUrl} was rejected. No drone was created ` +
             `and nothing was changed. Re-enroll with ${localAssimilateCommand(authority.apiUrl, true)} ` +
             'from the operator’s terminal.\n',
         );
@@ -1349,7 +1349,7 @@ export async function runAssimilate(
         // fix it — verify this is the expected server / re-initialization.
         deps.stderr(
           `Borg could not verify the expected server identity for ${authority.apiUrl}. ` +
-            'No new seat was created. Verify that this is the expected server; if it was ' +
+            'No drone was created. Verify that this is the expected server; if it was ' +
             're-initialized, restore the expected identity, then rerun ' +
             `${localAssimilateCommand(authority.apiUrl)}.\n`,
         );
@@ -1361,7 +1361,7 @@ export async function runAssimilate(
         // fix it; align versions. Non-destructive: no seat created, nothing reset.
         deps.stderr(
           `Borg reached ${authority.apiUrl} but it did not recognize this worktree's drone ` +
-            'endpoint — the client and server versions are likely incompatible. No new seat ' +
+            'endpoint — the client and server versions are likely incompatible. No drone ' +
             'was created and nothing was changed. Update the Borg client and/or server so ' +
             `their versions match, then rerun ${localAssimilateCommand(authority.apiUrl)}.\n`,
         );
@@ -1372,7 +1372,7 @@ export async function runAssimilate(
         // check the server, then retry. Non-destructive.
         deps.stderr(
           `Borg reached ${authority.apiUrl} but it returned a server error while verifying ` +
-            "this worktree's saved seat. No new seat was created. Check the server (its logs / " +
+            "this worktree's saved connection. No drone was created. Check the server (its logs / " +
             `\`borg-mcp-server start\`), then rerun ${localAssimilateCommand(authority.apiUrl)}.\n`,
         );
         return 1;
@@ -1381,16 +1381,16 @@ export async function runAssimilate(
         // CR5: transport failure / timeout (unreachable) or a genuinely ambiguous
         // failure (indeterminate) — both transient. Start or restart the server.
         deps.stderr(
-          `Borg could not verify this worktree's saved seat on ${authority.apiUrl}. ` +
-            'No new seat was created. Start or restart the server with ' +
+          `Borg could not verify this worktree's saved connection to ${authority.apiUrl}. ` +
+            'No drone was created. Start or restart the server with ' +
             `\`borg-mcp-server start\`, then rerun ${localAssimilateCommand(authority.apiUrl)}.\n`,
         );
         return 1;
       }
       if (status === 'live' && !savedLocalRole) {
         deps.stderr(
-          `Borg verified this worktree's saved seat on ${authority.apiUrl}, but its saved ` +
-            'role is unavailable. No new seat was created. Ask the server operator to restore ' +
+          `Borg verified this worktree's saved connection to ${authority.apiUrl}, but its saved ` +
+            'role is unavailable. No drone was created. Ask the server operator to restore ' +
             `the role, then rerun ${localAssimilateCommand(authority.apiUrl)}.\n`,
         );
         return 1;
@@ -1401,8 +1401,8 @@ export async function runAssimilate(
   } else if (existing && args.flags.here) {
     if (existing.serverTrustIdentity !== undefined || existing.apiUrl !== auth.apiUrl) {
       deps.stderr(
-        'This worktree\'s saved seat belongs to a different Borg authority. ' +
-          'No new seat was created; use a fresh worktree.\n',
+        'This worktree\'s saved connection belongs to a different Borg authority. ' +
+          'No drone was created; use a fresh worktree.\n',
       );
       return 1;
     }
@@ -1583,7 +1583,7 @@ export async function runAssimilate(
     // a non-reattach DroneEvictedError falls through to the generic message.
     if (err instanceof DroneEvictedError && reattachPriorId != null) {
       deps.stderr(
-        `This worktree's saved seat on ${authority.apiUrl} was evicted. ` +
+        `This worktree's drone on ${authority.apiUrl} was evicted. ` +
           `Remove this worktree, or from a fresh worktree run ` +
           `${localAssimilateCommand(authority.apiUrl)}.\n`,
       );
@@ -1593,7 +1593,7 @@ export async function runAssimilate(
     // Reached only after a successful pinned-TLS attach, so it is pin-matched by
     // construction — a pin mismatch throws a distinct trust error and never
     // enters this branch. Attach mutates NOTHING; it recommends the offline
-    // `borg reset-local-seat` command.
+    // `borg reset-local-connection` command.
     if (err instanceof BorgServerError && reattachPriorId != null) {
       if (err.code === 'SESSION_REVOKED') {
         return diagnoseSessionTermination(deps, authority.apiUrl, 'revoked');
@@ -1616,7 +1616,7 @@ export async function runAssimilate(
     // concurrent offline reset, or a competing enroll). No FS/network mutation
     // happened; never silently recreate.
     deps.stderr(
-      `This worktree's saved local seat on ${authority.apiUrl} changed before the attach ` +
+      `This worktree's saved connection to ${authority.apiUrl} changed before the attach ` +
         '(a concurrent reset or enroll); no credential was created or sent and nothing was ' +
         `changed. Re-run ${localAssimilateCommand(authority.apiUrl)} to attach against the ` +
         'current state.\n',
@@ -1641,16 +1641,16 @@ export async function runAssimilate(
   const assignedRole =
     cubeDetail.roles.find((r) => r.id === result.role_id) ?? resolvedRole;
   if (result.result === 'reused') {
-    // The seat's existing role is authoritative on an idempotent reattach —
+    // The drone's existing role is authoritative on an idempotent reattach —
     // a role difference is expected, not a grant fallback. The bearer is
     // reused, not rotated: no new drone minted.
     deps.stderr(
-      `re-attached to existing seat ${result.drone_label} (same session, no new drone minted)\n`
+      `re-attached as ${result.drone_label} (same session, no new drone minted)\n`
     );
   } else if (assignedRole.id !== resolvedRole.id) {
     deps.stderr(
       `The requested role "${resolvedRole.name}" was unavailable; ` +
-      `attached to the "${assignedRole.name}" seat instead.\n`
+      `attached under the "${assignedRole.name}" role instead.\n`
     );
   }
 
@@ -1814,7 +1814,7 @@ export async function runAssimilate(
     }
     deps.stderr(
       `spawned sibling worktree at ${candidate} on branch ${wtBranch} (${startRef}); ` +
-      `the original dir keeps its active drone binding — run \`borg reset-local-seat\` there if that binding is stale.\n`
+      `the original dir keeps its active drone binding — run \`borg reset-local-connection\` there if that binding is stale.\n`
     );
     deps.chdir(candidate);
     deps.stderr(renderWorktreeSteeringNote(candidate, wtBranch, projectRoot));
@@ -1903,7 +1903,7 @@ export async function runAssimilate(
   // EXACT prior binding with its live-bearer digest; eviction remint = EXACT ref
   // only, bearer intentionally replaced; fresh/sibling = ABSENT).
   if (result.finalize === undefined || deps.finalizeServerSeat === undefined) {
-    deps.stderr('Local Borg server session metadata is incomplete; no seat was saved.\n');
+    deps.stderr('Local Borg server session metadata is incomplete; no connection was saved.\n');
     rollbackWorktree();
     return 1;
   }
@@ -1959,12 +1959,12 @@ export async function runAssimilate(
         if (bindOutcome === 'bound') {
           // The worktree now owns a durable locator (the bound-pending record points
           // here). PRESERVE it. Truthful convergence copy: a rerun FROM here re-sends
-          // the identical bearer (no duplicate), and `reset-local-seat` from here now
+          // the identical bearer (no duplicate), and `reset-local-connection` from here now
           // discovers + clears the bound-pending record.
           deps.stderr(
             `This worktree's secure session on ${auth.apiUrl} did not finish activating, but ` +
-              'its resumable seat state was PRESERVED here. This worktree was NOT removed. From ' +
-              `here, re-run ${localAssimilateCommand(auth.apiUrl)} to converge (the identical seat ` +
+              'its resumable connection state was PRESERVED here. This worktree was NOT removed. From ' +
+              `here, re-run ${localAssimilateCommand(auth.apiUrl)} to converge (the identical connection ` +
               `is reused — no duplicate is minted), or run ${resetLocalSeatCommand(auth.apiUrl)} to ` +
               'clear it.\n',
           );
@@ -1977,17 +1977,17 @@ export async function runAssimilate(
         // that can silently create a duplicate server seat (#35).
         const bindFailure =
           bindOutcome === 'missing'
-            ? 'the exact pending seat record went missing locally before it could be bound'
+            ? 'the exact pending connection record went missing locally before it could be bound'
             : bindOutcome === 'replaced'
-              ? 'the exact pending seat record was replaced locally before it could be bound; the replacement was left untouched'
+              ? 'the exact pending connection record was replaced locally before it could be bound; the replacement was left untouched'
               : bindOutcome === 'threw'
-                ? 'the local seat store could not be read or written while preserving the pending seat'
-                : 'this client did not receive a pending-seat preservation handle';
+                ? 'the private store could not be read or written while preserving the pending connection'
+                : 'this client did not receive a pending-connection preservation handle';
         deps.stderr(
           `This worktree's secure session on ${auth.apiUrl} did not finish activating: ` +
             `${bindFailure}. The spawned worktree will be removed. No client-only command can ` +
-            'prove reuse or safely clear the possibly accepted server-side seat; ask the server ' +
-            'operator to inspect that seat before retrying.\n',
+            'prove reuse or safely clear the possibly accepted server-side drone; ask the server ' +
+            'operator to inspect that drone before retrying.\n',
         );
         rollbackWorktree();
         return 1;
@@ -1997,8 +1997,8 @@ export async function runAssimilate(
       // reset or enroll). The composite scrubbed only our own pending record — no
       // orphan ACTIVE credential — so a just-spawned worktree is safe to remove.
       deps.stderr(
-        `This worktree's saved local seat on ${auth.apiUrl} changed during attach ` +
-          '(a concurrent reset or enroll); no seat was created and nothing was overwritten. ' +
+        `This worktree's saved connection to ${auth.apiUrl} changed during attach ` +
+          '(a concurrent reset or enroll); no drone was created and nothing was overwritten. ' +
           `Re-run ${localAssimilateCommand(auth.apiUrl)} to attach against the current state.\n`,
       );
       rollbackWorktree();

package/src/assimilate-deps.ts

@@ -474,13 +474,13 @@ export function buildDefaultAssimilateDeps(
           if (params.remint_invalid_prior) {
             if (prepared.result !== 'created' || prepared.drone.id === params.prior_drone_id) {
               await prepared.scrubPending();
-              throw new Error('Borg server did not remint a fresh seat after eviction');
+              throw new Error('Borg server did not remint a fresh drone after eviction');
             }
           } else if (prepared.result !== 'reused' || prepared.drone.id !== params.prior_drone_id) {
             await prepared.scrubPending();
             throw new BorgServerError(
               'ATTACH_CONFLICT',
-              'Borg server did not reattach the saved seat',
+              'Borg server did not reattach the saved connection',
             );
           }
         }

package/src/assimilate-guard.ts

@@ -48,8 +48,8 @@ export function reattachOnlyRefusal(
 ): string {
   if (decision.kind === 'no-identity') {
     return (
-      `◼ This session has no drone seat for this worktree, and in-session borg_assimilate is ` +
-      `re-attach-only (it never creates seats — gh#780). To create a seat for cube ` +
+      `◼ This session has no drone for this worktree, and in-session borg_assimilate is ` +
+      `re-attach-only (it never creates drones — gh#780). To create a drone for cube ` +
       `"${requestedCubeName}", run \`borg assimilate\` in a terminal — it spawns the worktree, ` +
       `persists the identity, and launches the agent in one step.`
     );
@@ -76,9 +76,9 @@ export function reattachFailureMessage(error: {
 }): string {
   const detail = error.message ?? String(error);
   return (
-    `◼ Re-attach failed — this worktree's saved seat is unreachable (likely evicted or its ` +
+    `◼ Re-attach failed — this worktree's saved connection is unreachable (likely evicted or its ` +
     `session was revoked). Server said: ${detail}\n` +
-    `Recover by running \`borg assimilate\` in a terminal to create a fresh seat; ` +
+    `Recover by running \`borg assimilate\` in a terminal to create a fresh drone; ` +
     `in-session borg_assimilate never re-mints (gh#780).`
   );
 }

package/src/assimilate-welcome.ts

@@ -31,8 +31,8 @@ export function renderAssimilationWelcome(
   return [
     `${check} Attached \`${droneLabel}\` to \`${roleName}\` in cube \`${cubeName}\`.`,
     ``,
-    `In the launched agent, run \`borg_whoami\` and \`borg_roster\` to verify the seat`,
-    `and begin coordinating.`,
+    `In the launched agent, run \`borg_whoami\` and \`borg_roster\``,
+    `to verify the connection and begin coordinating.`,
     `Launch future sessions in this repository with \`borg\`.`,
     ...teammateLines,
     ``,

package/src/bare-launch-menu.ts

@@ -4,13 +4,13 @@
  * When `borg` is run with NO arguments in a TTY, offer a small launch selector
  * instead of launching immediately:
  *   1. Launch (default)             — the configured agent (Enter selects).
- *   2. Launch with <other> instead  — the OTHER installed agent, ONE-SHOT
+ *   2. Launch with <other> instead  — the OTHER configured agent, ONE-SHOT
  *                                      (does NOT persist the preference).
  *   3. Launch all                   — runLaunchAll for the active cube.
  *
  * The option-set, the selection→action mapping, and the show/collapse decision
  * are pure functions so they're unit-testable without a real TTY. claude.ts
- * main() is thin glue: it computes the inputs (default cli, other-installed cli,
+ * main() is thin glue: it computes the inputs (default cli, other-configured cli,
  * launch-all targets), gates on shouldShowLaunchMenu, runs the orchestrator with
  * the real readline prompt, then dispatches the returned action.
  *
@@ -33,8 +33,8 @@ export interface LaunchMenuOption {
 export interface LaunchMenuInputs {
   /** The configured/resolved current agent (option 1). */
   defaultCli: BorgCli;
-  /** All installed agents that are NOT the default, in display order. */
-  otherInstalledClis: BorgCli[];
+  /** All configured agents that are NOT the default, in display order. */
+  otherConfiguredClis: BorgCli[];
   /** True iff there's an active cube with >=1 discoverable drone (option 3). */
   hasLaunchAllTargets: boolean;
 }
@@ -44,7 +44,7 @@ export interface LaunchMenuInputs {
  *
  * This callback deliberately runs after the one-shot menu choice. A bare
  * launch may resolve one default CLI first and then launch a different
- * installed CLI for this invocation; only the final CLI may be self-healed.
+ * configured CLI for this invocation; only the final CLI may be self-healed.
  */
 export function configureSelectedLaunchCli(
   defaultCli: BorgCli,
@@ -105,7 +105,7 @@ export function buildLaunchMenuOptions(inputs: LaunchMenuInputs): LaunchMenuOpti
       action: { kind: 'launch', cli: inputs.defaultCli },
     },
   ];
-  for (const cli of inputs.otherInstalledClis) {
+  for (const cli of inputs.otherConfiguredClis) {
     options.push({
       key: String(options.length + 1),
       label: `Launch with ${PRETTY[cli]} (one-shot)`,

package/src/claude.ts

@@ -12,8 +12,6 @@
  *   borg setup          → Re-route to the setup wizard
  *   borg spawn <name>   → Create a sibling git worktree + launch a
  *                         fresh drone inside it (see spawn.ts)
- *   borg sync           → Advance the current worktree across the 5
- *                         lifecycle states (see sync.ts, gh#33)
  *   borg server <cmd>   → Forward a lifecycle command to borg-mcp-server
  */
 
@@ -31,7 +29,6 @@ import { handleVersionFlag, getPackageVersion } from './version.js';
 import { clientSubcommandHelpText, topLevelHelpText } from './cli-help.js';
 import { runSpawn } from './spawn.js';
 import { buildClaudeLaunchArgs } from './claude-launch-args.js';
-import { parseSyncArgs, runSync } from './sync.js';
 import { parseCleanupArgs, runCleanup } from './cleanup-cmd.js';
 import { parseAssimilateArgs } from './parse-assimilate-args.js';
 import { runAssimilate } from './assimilate-cmd.js';
@@ -58,7 +55,7 @@ import {
 import { setTerminalTitle } from './terminal-title.js';
 import { initConsolePrefix, consolePrefix } from './console-prefix.js';
 import { initDebugFromArgv } from './debug.js';
-import { defaultCliChoiceDeps, detectCliAvailability, installedCliNames, parseCliFlag, resolveCliChoice } from './cli-platform.js';
+import { configuredCliNames, defaultCliChoiceDeps, detectCliAvailability, detectCliConfiguration, parseCliFlag, resolveCliChoice } from './cli-platform.js';
 import { prepareCodexRemoteLaunch, resolveCodexLaunchCwd, withCodexCwdArg, defaultCodexRemoteDeps, checkCodexBridgeHealthy } from './codex-remote.js';
 import {
   BORG_CODEX_REMOTE_WAKE_ENV,
@@ -216,11 +213,11 @@ async function main() {
     const code = await runAssimilateEntry(process.argv.slice(3));
     process.exit(code);
   }
-  if (process.argv[2] === 'reset-local-seat') {
+  if (process.argv[2] === 'reset-local-connection') {
     const parsed = parseResetLocalSeatArgs(process.argv.slice(3));
     if (!parsed.ok) {
       process.stderr.write(
-        chalk.red(`${consolePrefix()}◼ borg reset-local-seat: ${parsed.error}\n`)
+        chalk.red(`${consolePrefix()}◼ borg reset-local-connection: ${parsed.error}\n`)
       );
       process.stderr.write(`Run \`borg --help\` for usage.\n`);
       process.exit(1);
@@ -254,18 +251,6 @@ async function main() {
     const code = await runSpawn();
     process.exit(code);
   }
-  if (process.argv[2] === 'sync') {
-    const parsed = parseSyncArgs(process.argv.slice(3));
-    if (!parsed.ok) {
-      process.stderr.write(
-        chalk.red(`${consolePrefix()}◼ borg sync: ${parsed.error}\n`)
-      );
-      process.stderr.write(`Run \`borg --help\` for usage.\n`);
-      process.exit(1);
-    }
-    const code = await runSync({}, parsed.options);
-    process.exit(code);
-  }
   if (process.argv[2] === 'cleanup') {
     const parsed = parseCleanupArgs(process.argv.slice(3));
     if (!parsed.ok) {
@@ -372,10 +357,12 @@ async function main() {
       stdoutIsTTY,
     })
   ) {
-    const otherInstalledClis =
-      installedCliNames(detectCliAvailability()).filter((c) => c !== cli);
+    const otherConfiguredClis = configuredCliNames(
+      detectCliAvailability(),
+      detectCliConfiguration(),
+    ).filter((c) => c !== cli);
     const action = await runBareLaunchMenu(
-      { defaultCli: cli, otherInstalledClis, hasLaunchAllTargets: await hasLaunchAllTargets() },
+      { defaultCli: cli, otherConfiguredClis, hasLaunchAllTargets: await hasLaunchAllTargets() },
       prompt
     );
     if (action.kind === 'launch-all') {

package/src/cleanup-cmd.ts

@@ -74,7 +74,7 @@ export type CleanupReason =
   | 'SURVIVES-live'
   | 'SURVIVES-self'
   | 'UNKNOWN-indeterminate'
-  | 'UNKNOWN-no-seat'
+  | 'UNKNOWN-no-connection'
   | 'LEGACY-manual-review';
 
 export interface CleanupRow {
@@ -350,7 +350,7 @@ async function classifyWorktree(
     case 'revoked':
       return { reason: 'SURVIVES-revoked', detail: 'session revoked — recoverable via re-enroll, never delete' };
     case 'live':
-      return { reason: 'SURVIVES-live', detail: 'seat resolves (drone alive)' };
+      return { reason: 'SURVIVES-live', detail: 'connection resolves (drone alive)' };
     case 'indeterminate':
     default:
       return {
@@ -431,7 +431,7 @@ export async function buildCleanupReport(
       // sibling → REPORT for manual review, never auto-prune (S5). No seat →
       // an arbitrary user worktree we never touch or list.
       if (seat) {
-        rows.push({ worktreePath: wt, wtBranch: null, reason: 'LEGACY-manual-review', detail: 'borg seat outside worktreesHome (pre-gh#556 sibling)' });
+        rows.push({ worktreePath: wt, wtBranch: null, reason: 'LEGACY-manual-review', detail: 'borg connection outside worktreesHome (pre-gh#556 sibling)' });
       }
       continue;
     }
@@ -439,7 +439,7 @@ export async function buildCleanupReport(
     // Under worktreesHome but no saved seat → not eviction-orphaned
     // (pre-assimilate or hand-made). Report, never auto-prune.
     if (!seat) {
-      rows.push({ worktreePath: wt, wtBranch: null, reason: 'UNKNOWN-no-seat', detail: 'no saved seat — manual review' });
+      rows.push({ worktreePath: wt, wtBranch: null, reason: 'UNKNOWN-no-connection', detail: 'no saved connection — manual review' });
       continue;
     }