@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/daemon/remote-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-cli.d.ts","sourceRoot":"","sources":["../../src/daemon/remote-cli.ts"],"names":[],"mappings":"AAmHA,8EAA8E;AAC9E,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAiB7E;AAumBD,8FAA8F;AAC9F,wBAAsB,0BAA0B,CAC/C,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,kBAAkB,EAAE,OAAO,CAAA;CAAE,GACtC,OAAO,CAAC,OAAO,CAAC,CAsDlB","sourcesContent":["import { basename, resolve } from \"node:path\";\nimport { getAgentDir, VERSION } from \"../config.ts\";\nimport { type IrohRemoteAccessPresetName, isIrohRemoteAccessPresetName } from \"../core/remote/iroh/access-grant.ts\";\nimport { formatIrohRemoteTicketQrCode } from \"../core/remote/iroh/qr.ts\";\nimport { getIrohRemotePairingVerificationDetails } from \"../core/remote/iroh/ticket.ts\";\nimport { spawnProcess, waitForChildProcess } from \"../utils/child-process.ts\";\nimport { createDaemonClient, type DaemonClient } from \"./control-client.ts\";\nimport type { ControlEvent, ControlResponse } from \"./control-protocol.ts\";\nimport { ensureDaemonRunning, probeDaemon } from \"./spawn.ts\";\n\nfunction printRemoteUsage(): void {\n\tconsole.error(`Usage: volt remote <command>\n\nCommands:\n  pair [--workspace <name>] [--access coding|review|chat|full]\n                                Create a pairing ticket (default access: coding).\n  access <node-id> set <preset> Update a paired device's tool and RPC access.\n  status [--json]               Show daemon status (workspaces, clients, leases).\n  clients                       List paired clients.\n  revoke <node-id>              Revoke a paired client and close its connections.\n  approve-repair <node-id>      Allow a revoked client node ID to re-pair.\n  workspace add [path] [--name <name>]\n                                Register a workspace with the daemon.\n  workspace remove <name>       Unregister an empty workspace (refuses while worktrees exist).\n  workspace list                List registered workspaces.\n  worktree add [--workspace <name>] [--name <id>] [--branch <ref>] [--base <ref>]\n                                Create a daemon-managed git worktree.\n  worktree adopt <path> [--workspace <name>] [--name <id>] [--base <ref>]\n                                Adopt an existing git worktree checkout.\n  worktree list [--workspace <name>] [--json]\n                                List daemon-managed worktrees.\n  worktree remove <id> [--workspace <name>] [--force]\n                                Remove a worktree (refuses dirty/busy without --force).\n  worktree prune [--workspace <name>]\n                                Reconcile worktree records against the filesystem.\n  worktree diff <id> [--workspace <name>]\n                                Show the worktree branch's diff against its base ref.\n\n\"volt remote host\" has been replaced by the background daemon. Run \"volt daemon start\"\n(or enable remote.background). See docs/daemon.md.\n`);\n}\n\ninterface RemoteControlSession {\n\tclient: DaemonClient;\n\tevents: (handler: (event: ControlEvent) => void) => void;\n\t/** Resolves if the daemon control connection is lost before close() is called. */\n\twhenConnectionLost: Promise<void>;\n\tclose(): Promise<void>;\n}\n\nasync function connectToDaemon(options: { autoStart: boolean }): Promise<RemoteControlSession | undefined> {\n\tconst agentDir = getAgentDir();\n\tlet probe = await probeDaemon(agentDir);\n\tif (!probe.healthy && options.autoStart) {\n\t\tprobe = await ensureDaemonRunning(agentDir);\n\t}\n\tif (!probe.healthy) {\n\t\tconsole.error(\"voltd is not running. Start it with: volt daemon start\");\n\t\tprocess.exitCode = 1;\n\t\treturn undefined;\n\t}\n\tconst handlers = new Set<(event: ControlEvent) => void>();\n\tlet closing = false;\n\tlet resolveConnectionLost: () => void = () => {};\n\tconst whenConnectionLost = new Promise<void>((resolve) => {\n\t\tresolveConnectionLost = resolve;\n\t});\n\tconst client = createDaemonClient({\n\t\tsocketPath: probe.socketPath,\n\t\tclient: \"cli\",\n\t\tversion: VERSION,\n\t\tauthToken: probe.authToken,\n\t\treconnect: false,\n\t\tonEvent: (event) => {\n\t\t\tfor (const handler of handlers) {\n\t\t\t\thandler(event);\n\t\t\t}\n\t\t},\n\t\tonConnectionStateChange: (nextState) => {\n\t\t\tif (nextState === \"gone\" && !closing) {\n\t\t\t\tresolveConnectionLost();\n\t\t\t}\n\t\t},\n\t});\n\ttry {\n\t\tawait client.connect();\n\t} catch (error) {\n\t\tconsole.error(`Error: could not connect to voltd: ${error instanceof Error ? error.message : String(error)}`);\n\t\tprocess.exitCode = 1;\n\t\treturn undefined;\n\t}\n\treturn {\n\t\tclient,\n\t\tevents: (handler) => {\n\t\t\thandlers.add(handler);\n\t\t},\n\t\twhenConnectionLost,\n\t\tclose: () => {\n\t\t\tclosing = true;\n\t\t\treturn client.close();\n\t\t},\n\t};\n}\n\nfunction reportControlError(response: ControlResponse, context: string): boolean {\n\tif (response.type === \"error\") {\n\t\tconst code = response.code === \"workspace_has_worktrees\" ? ` [${response.code}]` : \"\";\n\t\tconsole.error(`Error: ${context}${code}: ${response.message}`);\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\treturn false;\n}\n\n/** Render only the non-secret ticket fields a user should compare in Volt. */\nexport function formatRemotePairingVerificationLines(ticket: string): string[] {\n\tconst details = getIrohRemotePairingVerificationDetails(ticket);\n\treturn [\n\t\t\"verify these details in Volt before confirming:\",\n\t\t\"  Fingerprint\",\n\t\t`    ${details.hostFingerprint}`,\n\t\t\"  Host ID\",\n\t\t`    ${details.hostNodeId}`,\n\t\t\"  Workspace\",\n\t\t`    ${details.workspace}`,\n\t\t\"  Relay mode\",\n\t\t`    ${details.relayMode}`,\n\t\t\"  HTTPS relay origins\",\n\t\t...(details.relayOrigins.length === 0 ? [\"    none\"] : details.relayOrigins.map((origin) => `    ${origin}`)),\n\t\t\"  Expires (UTC)\",\n\t\t`    ${details.expiresAt === undefined ? \"not specified\" : new Date(details.expiresAt).toISOString()}`,\n\t];\n}\n\nasync function handlePairCommand(args: string[]): Promise<void> {\n\tlet workspaceName: string | undefined;\n\tlet access: IrohRemoteAccessPresetName = \"coding\";\n\tconst accessIndex = args.indexOf(\"--access\");\n\tif (accessIndex !== -1) {\n\t\tconst value = args[accessIndex + 1];\n\t\tif (!isIrohRemoteAccessPresetName(value)) {\n\t\t\tconsole.error(\"Error: --access requires coding, review, chat, or full\");\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn;\n\t\t}\n\t\taccess = value;\n\t}\n\tconst workspaceIndex = args.indexOf(\"--workspace\");\n\tif (workspaceIndex !== -1) {\n\t\tworkspaceName = args[workspaceIndex + 1];\n\t\tif (!workspaceName) {\n\t\t\tconsole.error(\"Error: --workspace requires a value\");\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn;\n\t\t}\n\t}\n\n\tconst session = await connectToDaemon({ autoStart: true });\n\tif (!session) {\n\t\treturn;\n\t}\n\ttry {\n\t\t// Default the pairing workspace to the daemon workspace registered for the cwd,\n\t\t// registering the cwd when nothing matches (name = basename).\n\t\tif (workspaceName === undefined) {\n\t\t\tconst status = await session.client.request({ type: \"status\" });\n\t\t\tif (status.type !== \"status_result\") {\n\t\t\t\treportControlError(status, \"status\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst cwd = resolve(process.cwd());\n\t\t\tconst match = status.workspaces\n\t\t\t\t.filter((workspace) => cwd === workspace.path || cwd.startsWith(`${workspace.path}/`))\n\t\t\t\t.sort((left, right) => right.path.length - left.path.length)[0];\n\t\t\tif (match) {\n\t\t\t\tworkspaceName = match.name;\n\t\t\t} else {\n\t\t\t\tworkspaceName = basename(cwd) || \"workspace\";\n\t\t\t\tconst registered = await session.client.request({\n\t\t\t\t\ttype: \"workspace_register\",\n\t\t\t\t\tname: workspaceName,\n\t\t\t\t\tpath: cwd,\n\t\t\t\t});\n\t\t\t\tif (reportControlError(registered, \"workspace register\")) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconsole.error(`registered workspace: ${workspaceName} -> ${cwd}`);\n\t\t\t}\n\t\t}\n\n\t\tconst done = new Promise<void>((resolveDone) => {\n\t\t\tsession.events((event) => {\n\t\t\t\tif (event.type !== \"pairing_progress\") {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (event.phase === \"ticket\" && event.ticket) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tfor (const line of formatRemotePairingVerificationLines(event.ticket)) console.error(line);\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t\t`pairing failed: ticket verification details are invalid: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\tresolveDone();\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tif (process.stderr.isTTY) {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconsole.error(\"pairing ticket QR:\");\n\t\t\t\t\t\t\tconsole.error(formatIrohRemoteTicketQrCode(event.ticket));\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t\t\t`Could not render pairing QR: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tconsole.error(\"pairing ticket:\");\n\t\t\t\t\tconsole.log(event.ticket);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (event.phase === \"waiting\") {\n\t\t\t\t\tconsole.error(\"waiting for the phone to pair (Ctrl-C to stop waiting)...\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (event.phase === \"completed\") {\n\t\t\t\t\tconsole.error(`paired: ${event.clientNodeId ?? \"client\"}`);\n\t\t\t\t\tresolveDone();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (event.phase === \"failed\") {\n\t\t\t\t\tconsole.error(`pairing failed: ${event.error ?? \"unknown error\"}`);\n\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\tresolveDone();\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\n\t\tconst response = await session.client.request({\n\t\t\ttype: \"pair_request\",\n\t\t\taccess,\n\t\t\t...(workspaceName === undefined ? {} : { workspaceName }),\n\t\t});\n\t\tif (reportControlError(response, \"pair\")) {\n\t\t\treturn;\n\t\t}\n\t\tawait Promise.race([\n\t\t\tdone,\n\t\t\tsession.whenConnectionLost.then(() => {\n\t\t\t\tconsole.error(\"Error: lost connection to voltd while waiting for the phone to pair\");\n\t\t\t\tprocess.exitCode = 1;\n\t\t\t}),\n\t\t]);\n\t} finally {\n\t\tawait session.close();\n\t}\n}\n\nasync function handleStatusCommand(args: string[]): Promise<void> {\n\tconst session = await connectToDaemon({ autoStart: false });\n\tif (!session) {\n\t\treturn;\n\t}\n\ttry {\n\t\tconst response = await session.client.request({ type: \"status\" });\n\t\tif (response.type !== \"status_result\") {\n\t\t\treportControlError(response, \"status\");\n\t\t\treturn;\n\t\t}\n\t\tif (args.includes(\"--json\")) {\n\t\t\tconsole.log(JSON.stringify({ ...response, id: undefined, type: undefined }, null, 2));\n\t\t\treturn;\n\t\t}\n\t\tconsole.error(`voltd ${response.version} (pid ${response.pid})`);\n\t\tconsole.error(`workspaces: ${response.workspaces.length}`);\n\t\tfor (const workspace of response.workspaces) {\n\t\t\tconsole.error(`  ${workspace.name} -> ${workspace.path}`);\n\t\t}\n\t\tconsole.error(`paired clients: ${response.clients.length}`);\n\t\tfor (const client of response.clients) {\n\t\t\tconsole.error(`  ${client.clientNodeId}${client.label ? ` (${client.label})` : \"\"}`);\n\t\t}\n\t\tconsole.error(`phone connections: ${response.phoneConnections}`);\n\t\tconsole.error(`leases: ${response.leases.length}`);\n\t\tfor (const lease of response.leases) {\n\t\t\tconsole.error(\n\t\t\t\t`  ${lease.workspaceName}/${lease.sessionId}: ${lease.state} (streams ${lease.streamCount}, relays ${lease.relayCount})`,\n\t\t\t);\n\t\t}\n\t} finally {\n\t\tawait session.close();\n\t}\n}\n\nasync function handleClientsCommand(): Promise<void> {\n\tconst session = await connectToDaemon({ autoStart: false });\n\tif (!session) {\n\t\treturn;\n\t}\n\ttry {\n\t\tconst response = await session.client.request({ type: \"clients_list\" });\n\t\tif (response.type !== \"clients_result\") {\n\t\t\treportControlError(response, \"clients\");\n\t\t\treturn;\n\t\t}\n\t\tconsole.log(JSON.stringify(response.clients, null, 2));\n\t} finally {\n\t\tawait session.close();\n\t}\n}\n\nasync function handleAccessCommand(args: string[]): Promise<void> {\n\tconst [nodeId, action, presetValue] = args;\n\tif (!nodeId || action !== \"set\" || !isIrohRemoteAccessPresetName(presetValue)) {\n\t\tconsole.error(\"Error: usage: volt remote access <node-id> set coding|review|chat|full\");\n\t\tprocess.exitCode = 1;\n\t\treturn;\n\t}\n\tconst session = await connectToDaemon({ autoStart: false });\n\tif (!session) return;\n\ttry {\n\t\tconst clients = await session.client.request({ type: \"clients_list\" });\n\t\tif (clients.type !== \"clients_result\") {\n\t\t\treportControlError(clients, \"clients\");\n\t\t\treturn;\n\t\t}\n\t\tconst client = clients.clients.find((entry) => entry.clientNodeId === nodeId);\n\t\tif (!client) {\n\t\t\tconsole.error(`Error: paired client not found: ${nodeId}`);\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn;\n\t\t}\n\t\tif (!client.rpcGrant) {\n\t\t\tconsole.error(`Error: paired client has no RPC grant and must re-pair: ${nodeId}`);\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn;\n\t\t}\n\t\tconst response = await session.client.request({\n\t\t\ttype: \"client_access_update\",\n\t\t\tclientNodeId: nodeId,\n\t\t\texpectedRevision: client.rpcGrant.revision,\n\t\t\taccess: presetValue,\n\t\t});\n\t\tif (reportControlError(response, \"access set\")) return;\n\t\tif (response.type !== \"client_access_updated\" || response.client.rpcGrant === undefined) {\n\t\t\tconsole.error(\"Error: unexpected daemon response for access set\");\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn;\n\t\t}\n\t\tconsole.error(`updated access for ${nodeId}: ${presetValue} (revision ${response.client.rpcGrant.revision})`);\n\t} finally {\n\t\tawait session.close();\n\t}\n}\n\nasync function handleRevokeCommand(args: string[]): Promise<void> {\n\tconst all = args.includes(\"--all\");\n\tconst positionals = args.filter((arg) => !arg.startsWith(\"--\"));\n\tif (!all && positionals.length === 0) {\n\t\tconsole.error(\"Error: Missing node id to revoke\");\n\t\tprocess.exitCode = 1;\n\t\treturn;\n\t}\n\tconst session = await connectToDaemon({ autoStart: false });\n\tif (!session) {\n\t\treturn;\n\t}\n\ttry {\n\t\tlet nodeIds = positionals;\n\t\tif (all) {\n\t\t\tconst clients = await session.client.request({ type: \"clients_list\" });\n\t\t\tif (clients.type !== \"clients_result\") {\n\t\t\t\treportControlError(clients, \"clients\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tnodeIds = clients.clients.map((client) => client.clientNodeId);\n\t\t\tif (nodeIds.length === 0) {\n\t\t\t\tconsole.error(\"No paired clients to revoke\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t\tlet revokedCount = 0;\n\t\tfor (const nodeId of nodeIds) {\n\t\t\tconst response = await session.client.request({ type: \"client_revoke\", clientNodeId: nodeId });\n\t\t\tif (response.type === \"error\") {\n\t\t\t\tconsole.error(`Error: revoke ${nodeId}: ${response.message}`);\n\t\t\t\tprocess.exitCode = 1;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\trevokedCount++;\n\t\t\tconsole.error(`Revoked ${nodeId}`);\n\t\t}\n\t\tif (all) {\n\t\t\tconsole.error(`Revoked ${revokedCount} client${revokedCount === 1 ? \"\" : \"s\"}`);\n\t\t}\n\t} finally {\n\t\tawait session.close();\n\t}\n}\n\nasync function handleApproveRepairCommand(args: string[]): Promise<void> {\n\tconst nodeId = args[0];\n\tif (!nodeId) {\n\t\tconsole.error(\"Error: Missing node id to approve for re-pair\");\n\t\tprocess.exitCode = 1;\n\t\treturn;\n\t}\n\tconst session = await connectToDaemon({ autoStart: false });\n\tif (!session) {\n\t\treturn;\n\t}\n\ttry {\n\t\tconst response = await session.client.request({ type: \"client_approve_repair\", clientNodeId: nodeId });\n\t\tif (reportControlError(response, \"approve-repair\")) {\n\t\t\treturn;\n\t\t}\n\t\tconsole.error(`Approved re-pair for ${nodeId}`);\n\t} finally {\n\t\tawait session.close();\n\t}\n}\n\nasync function handleWorkspaceCommand(args: string[]): Promise<void> {\n\tconst subcommand = args[0];\n\tif (subcommand === \"add\") {\n\t\tconst rest = args.slice(1);\n\t\tlet name: string | undefined;\n\t\tconst nameIndex = rest.indexOf(\"--name\");\n\t\tif (nameIndex !== -1) {\n\t\t\tname = rest[nameIndex + 1];\n\t\t\tif (!name) {\n\t\t\t\tconsole.error(\"Error: --name requires a value\");\n\t\t\t\tprocess.exitCode = 1;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\trest.splice(nameIndex, 2);\n\t\t}\n\t\tconst path = resolve(rest[0] ?? process.cwd());\n\t\tconst workspaceName = name ?? basename(path) ?? \"workspace\";\n\t\tconst session = await connectToDaemon({ autoStart: true });\n\t\tif (!session) {\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tconst response = await session.client.request({ type: \"workspace_register\", name: workspaceName, path });\n\t\t\tif (reportControlError(response, \"workspace add\")) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconsole.error(`registered workspace: ${workspaceName} -> ${path}`);\n\t\t} finally {\n\t\t\tawait session.close();\n\t\t}\n\t\treturn;\n\t}\n\tif (subcommand === \"remove\") {\n\t\tconst name = args[1];\n\t\tif (!name) {\n\t\t\tconsole.error(\"Error: workspace remove requires a name\");\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn;\n\t\t}\n\t\tconst session = await connectToDaemon({ autoStart: false });\n\t\tif (!session) {\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tconst response = await session.client.request({ type: \"workspace_unregister\", name });\n\t\t\tif (reportControlError(response, \"workspace remove\")) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconsole.error(`unregistered workspace: ${name}`);\n\t\t} finally {\n\t\t\tawait session.close();\n\t\t}\n\t\treturn;\n\t}\n\tif (subcommand === \"list\") {\n\t\tconst session = await connectToDaemon({ autoStart: false });\n\t\tif (!session) {\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tconst response = await session.client.request({ type: \"status\" });\n\t\t\tif (response.type !== \"status_result\") {\n\t\t\t\treportControlError(response, \"workspace list\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconsole.log(JSON.stringify(response.workspaces, null, 2));\n\t\t} finally {\n\t\t\tawait session.close();\n\t\t}\n\t\treturn;\n\t}\n\tconsole.error(`Error: Unknown workspace command: ${subcommand ?? \"<missing>\"}`);\n\tprintRemoteUsage();\n\tprocess.exitCode = 1;\n}\n\nfunction takeFlagValue(args: string[], flag: string): { ok: true; value: string | undefined } | { ok: false } {\n\tconst index = args.indexOf(flag);\n\tif (index === -1) {\n\t\treturn { ok: true, value: undefined };\n\t}\n\tconst value = args[index + 1];\n\tif (!value) {\n\t\tconsole.error(`Error: ${flag} requires a value`);\n\t\tprocess.exitCode = 1;\n\t\treturn { ok: false };\n\t}\n\targs.splice(index, 2);\n\treturn { ok: true, value };\n}\n\n/**\n * Default the workspace to the daemon workspace registered for the cwd (same\n * prefix match as pairing), without auto-registering on miss.\n */\nasync function resolveWorkspaceNameForCwd(session: RemoteControlSession): Promise<string | undefined> {\n\tconst status = await session.client.request({ type: \"status\" });\n\tif (status.type !== \"status_result\") {\n\t\treportControlError(status, \"status\");\n\t\treturn undefined;\n\t}\n\tconst cwd = resolve(process.cwd());\n\tconst match = status.workspaces\n\t\t.filter((workspace) => cwd === workspace.path || cwd.startsWith(`${workspace.path}/`))\n\t\t.sort((left, right) => right.path.length - left.path.length)[0];\n\tif (!match) {\n\t\tconsole.error(\"Error: no registered workspace matches the current directory; pass --workspace <name>\");\n\t\tprocess.exitCode = 1;\n\t\treturn undefined;\n\t}\n\treturn match.name;\n}\n\nasync function handleWorktreeCommand(args: string[]): Promise<void> {\n\tconst subcommand = args[0];\n\tif (\n\t\tsubcommand !== \"add\" &&\n\t\tsubcommand !== \"adopt\" &&\n\t\tsubcommand !== \"list\" &&\n\t\tsubcommand !== \"remove\" &&\n\t\tsubcommand !== \"prune\" &&\n\t\tsubcommand !== \"diff\"\n\t) {\n\t\tconsole.error(`Error: Unknown worktree command: ${subcommand ?? \"<missing>\"}`);\n\t\tprintRemoteUsage();\n\t\tprocess.exitCode = 1;\n\t\treturn;\n\t}\n\tconst rest = args.slice(1);\n\tconst workspaceFlag = takeFlagValue(rest, \"--workspace\");\n\tif (!workspaceFlag.ok) {\n\t\treturn;\n\t}\n\tconst session = await connectToDaemon({ autoStart: false });\n\tif (!session) {\n\t\treturn;\n\t}\n\ttry {\n\t\tlet workspaceName = workspaceFlag.value;\n\t\tif (\n\t\t\tworkspaceName === undefined &&\n\t\t\t(subcommand === \"add\" || subcommand === \"adopt\" || subcommand === \"remove\" || subcommand === \"diff\")\n\t\t) {\n\t\t\tworkspaceName = await resolveWorkspaceNameForCwd(session);\n\t\t\tif (workspaceName === undefined) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t\tif (subcommand === \"add\") {\n\t\t\tconst nameFlag = takeFlagValue(rest, \"--name\");\n\t\t\tconst branchFlag = takeFlagValue(rest, \"--branch\");\n\t\t\tconst baseFlag = takeFlagValue(rest, \"--base\");\n\t\t\tif (!nameFlag.ok || !branchFlag.ok || !baseFlag.ok || workspaceName === undefined) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst response = await session.client.request({\n\t\t\t\ttype: \"worktree_create\",\n\t\t\t\tworkspaceName,\n\t\t\t\t...(nameFlag.value === undefined ? {} : { worktreeName: nameFlag.value }),\n\t\t\t\t...(branchFlag.value === undefined ? {} : { branch: branchFlag.value }),\n\t\t\t\t...(baseFlag.value === undefined ? {} : { baseRef: baseFlag.value }),\n\t\t\t});\n\t\t\tif (reportControlError(response, \"worktree add\")) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (response.type !== \"worktree_result\") {\n\t\t\t\tconsole.error(\"Error: unexpected daemon response for worktree add\");\n\t\t\t\tprocess.exitCode = 1;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconsole.error(\n\t\t\t\t`created worktree ${response.worktree.id} (branch ${response.worktree.branch}) -> ${response.worktree.path}`,\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\t\tif (subcommand === \"adopt\") {\n\t\t\tconst nameFlag = takeFlagValue(rest, \"--name\");\n\t\t\tconst baseFlag = takeFlagValue(rest, \"--base\");\n\t\t\tconst path = rest.filter((arg) => !arg.startsWith(\"--\"))[0];\n\t\t\tif (!nameFlag.ok || !baseFlag.ok || workspaceName === undefined) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (!path) {\n\t\t\t\tconsole.error(\"Error: worktree adopt requires a path\");\n\t\t\t\tprocess.exitCode = 1;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst response = await session.client.request({\n\t\t\t\ttype: \"worktree_adopt\",\n\t\t\t\tworkspaceName,\n\t\t\t\tpath: resolve(path),\n\t\t\t\t...(nameFlag.value === undefined ? {} : { worktreeName: nameFlag.value }),\n\t\t\t\t...(baseFlag.value === undefined ? {} : { baseRef: baseFlag.value }),\n\t\t\t});\n\t\t\tif (reportControlError(response, \"worktree adopt\")) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (response.type !== \"worktree_result\") {\n\t\t\t\tconsole.error(\"Error: unexpected daemon response for worktree adopt\");\n\t\t\t\tprocess.exitCode = 1;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconsole.error(\n\t\t\t\t`adopted worktree ${response.worktree.id} (branch ${response.worktree.branch}) -> ${response.worktree.path}`,\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\t\tif (subcommand === \"list\") {\n\t\t\tconst response = await session.client.request({\n\t\t\t\ttype: \"worktree_list\",\n\t\t\t\t...(workspaceName === undefined ? {} : { workspaceName }),\n\t\t\t});\n\t\t\tif (reportControlError(response, \"worktree list\")) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (response.type !== \"worktrees_result\") {\n\t\t\t\tconsole.error(\"Error: unexpected daemon response for worktree list\");\n\t\t\t\tprocess.exitCode = 1;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (rest.includes(\"--json\")) {\n\t\t\t\tconsole.log(JSON.stringify(response.worktrees, null, 2));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tfor (const worktree of response.worktrees) {\n\t\t\t\tconst aheadBehind =\n\t\t\t\t\tworktree.aheadBehind === undefined\n\t\t\t\t\t\t? \"\"\n\t\t\t\t\t\t: ` (+${worktree.aheadBehind.ahead}/-${worktree.aheadBehind.behind})`;\n\t\t\t\tconsole.error(\n\t\t\t\t\t`${worktree.workspaceName}/${worktree.id}: ${worktree.branch}${aheadBehind}` +\n\t\t\t\t\t\t`${worktree.available === false ? \" (missing)\" : \"\"}${worktree.dirty === true ? \" (dirty)\" : \"\"}` +\n\t\t\t\t\t\t` -> ${worktree.path}`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (response.worktrees.length === 0) {\n\t\t\t\tconsole.error(\"no worktrees\");\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\tif (subcommand === \"diff\") {\n\t\t\tconst worktreeId = rest.filter((arg) => !arg.startsWith(\"--\"))[0];\n\t\t\tif (!worktreeId || workspaceName === undefined) {\n\t\t\t\tif (!worktreeId) {\n\t\t\t\t\tconsole.error(\"Error: worktree diff requires a worktree id\");\n\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst response = await session.client.request({ type: \"worktree_list\", workspaceName });\n\t\t\tif (reportControlError(response, \"worktree diff\")) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (response.type !== \"worktrees_result\") {\n\t\t\t\tconsole.error(\"Error: unexpected daemon response for worktree diff\");\n\t\t\t\tprocess.exitCode = 1;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst worktree = response.worktrees.find((entry) => entry.id === worktreeId);\n\t\t\tif (!worktree) {\n\t\t\t\tconsole.error(`Error: no worktree ${worktreeId} in workspace ${workspaceName}`);\n\t\t\t\tprocess.exitCode = 1;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (worktree.available === false) {\n\t\t\t\tconsole.error(`Error: worktree ${worktreeId} checkout is missing (${worktree.path})`);\n\t\t\t\tprocess.exitCode = 1;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\t// Read-only, run locally in the user's terminal; the daemon never mutates\n\t\t\t// the main checkout (design §5.3).\n\t\t\tconst child = spawnProcess(\"git\", [\"-C\", worktree.path, \"diff\", `${worktree.baseRef ?? \"HEAD\"}...HEAD`], {\n\t\t\t\tstdio: [\"ignore\", \"inherit\", \"inherit\"],\n\t\t\t});\n\t\t\tconst code = await waitForChildProcess(child);\n\t\t\tif (code !== 0) {\n\t\t\t\tprocess.exitCode = 1;\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\tif (subcommand === \"remove\") {\n\t\t\tconst force = rest.includes(\"--force\");\n\t\t\tconst worktreeId = rest.filter((arg) => !arg.startsWith(\"--\"))[0];\n\t\t\tif (!worktreeId) {\n\t\t\t\tconsole.error(\"Error: worktree remove requires a worktree id\");\n\t\t\t\tprocess.exitCode = 1;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (workspaceName === undefined) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst response = await session.client.request({\n\t\t\t\ttype: \"worktree_remove\",\n\t\t\t\tworkspaceName,\n\t\t\t\tworktreeId,\n\t\t\t\t...(force ? { force } : {}),\n\t\t\t});\n\t\t\tif (reportControlError(response, \"worktree remove\")) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconsole.error(`removed worktree ${worktreeId}`);\n\t\t\treturn;\n\t\t}\n\t\tconst response = await session.client.request({\n\t\t\ttype: \"worktree_prune\",\n\t\t\t...(workspaceName === undefined ? {} : { workspaceName }),\n\t\t});\n\t\tif (reportControlError(response, \"worktree prune\")) {\n\t\t\treturn;\n\t\t}\n\t\tif (response.type !== \"worktree_prune_result\") {\n\t\t\tconsole.error(\"Error: unexpected daemon response for worktree prune\");\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn;\n\t\t}\n\t\tfor (const result of response.results) {\n\t\t\tconsole.error(\n\t\t\t\t`${result.workspaceName}: removed ${result.removedRecords.length} record(s), ` +\n\t\t\t\t\t`quarantined ${result.orphanCheckouts.length} orphan checkout(s)`,\n\t\t\t);\n\t\t}\n\t} finally {\n\t\tawait session.close();\n\t}\n}\n\n/** Router for `volt remote <command>` (daemon control clients); returns true when handled. */\nexport async function handleRemoteControlCommand(\n\targs: string[],\n\toptions: { isStandaloneBinary: boolean },\n): Promise<boolean> {\n\tif (args[0] !== \"remote\") {\n\t\treturn false;\n\t}\n\tconst command = args[1];\n\tif (command === undefined || command === \"--help\" || command === \"-h\") {\n\t\tprintRemoteUsage();\n\t\treturn true;\n\t}\n\tif (command === \"host\") {\n\t\tconsole.error(\n\t\t\t'\"volt remote host\" has been replaced by the background daemon. Run \"volt daemon start\" (or enable remote.background). See docs/daemon.md.',\n\t\t);\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\tif (options.isStandaloneBinary) {\n\t\tconsole.error(\"Error: volt remote is not available from the standalone binary release.\");\n\t\tconsole.error(\"Use a Node.js npm install or a source checkout with optional @number0/iroh dependencies.\");\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\tconst rest = args.slice(2);\n\tswitch (command) {\n\t\tcase \"pair\":\n\t\t\tawait handlePairCommand(rest);\n\t\t\treturn true;\n\t\tcase \"status\":\n\t\t\tawait handleStatusCommand(rest);\n\t\t\treturn true;\n\t\tcase \"clients\":\n\t\t\tawait handleClientsCommand();\n\t\t\treturn true;\n\t\tcase \"access\":\n\t\t\tawait handleAccessCommand(rest);\n\t\t\treturn true;\n\t\tcase \"revoke\":\n\t\t\tawait handleRevokeCommand(rest);\n\t\t\treturn true;\n\t\tcase \"approve-repair\":\n\t\t\tawait handleApproveRepairCommand(rest);\n\t\t\treturn true;\n\t\tcase \"workspace\":\n\t\t\tawait handleWorkspaceCommand(rest);\n\t\t\treturn true;\n\t\tcase \"worktree\":\n\t\t\tawait handleWorktreeCommand(rest);\n\t\t\treturn true;\n\t\tdefault:\n\t\t\tconsole.error(`Error: Unknown remote command: ${command}`);\n\t\t\tprintRemoteUsage();\n\t\t\tprocess.exitCode = 1;\n\t\t\treturn true;\n\t}\n}\n"]}