@agimon-ai/doompi-git 0.0.1-alpha.7 → 0.0.1-alpha.9

package/dist/src/services/worktreeOperations/index.mjs

@@ -0,0 +1,261 @@
+import { mirrorComposition } from "../compositionMirror/index.mjs";
+import { DoomGitExpectedError, HubUnavailableError } from "../errors/index.mjs";
+import { repositoryId, repositoryLabel, shortId } from "../repositoryIdentity/index.mjs";
+import { registryFile, worktreesRoot } from "../paths/index.mjs";
+import { MAX_WORKTREE_MESSAGE_BYTES } from "../worktreeEvents/index.mjs";
+import { planPrune, reconcile, refuseClose, refuseSpawn, worktreeDirectory } from "../worktreeNaming/index.mjs";
+import { createWorktreeRegistry } from "../worktreeRegistry/index.mjs";
+import fs from "node:fs";
+import { randomUUID } from "node:crypto";
+//#region src/services/worktreeOperations/index.ts
+function createWorktreeOperations(deps) {
+	const { git } = deps;
+	const sessionService = deps.sessionService;
+	const mirror = deps.mirror ?? mirrorComposition;
+	const now = deps.now ?? (() => /* @__PURE__ */ new Date());
+	const requireSessionService = () => {
+		if (sessionService === void 0) throw new HubUnavailableError("The cockpit session service is unavailable. Start the cockpit and try again.");
+		return sessionService;
+	};
+	const requireMessageInbox = () => {
+		if (deps.messageInbox === void 0) throw new HubUnavailableError("The Git message service is unavailable. Start the cockpit and try again.");
+		return deps.messageInbox;
+	};
+	const probe = {
+		alive: (record) => requireSessionService().isLive(record.sessionId),
+		exists: (path) => fs.existsSync(path)
+	};
+	/**
+	* Everything an action needs about the repository it is acting on.
+	*
+	* Resolved per call rather than cached: a session's cwd is stable, but the
+	* worktree registry is shared and another process may have written it since
+	* the last call.
+	*/
+	const resolve = async (context) => {
+		const root = await git.repositoryRoot(context.cwd);
+		if (root === void 0) throw new DoomGitExpectedError("not_a_repository", `${context.cwd} is not inside a git repository.`, false, "Run this from a repository checkout.");
+		const store = createWorktreeRegistry(registryFile(root, deps.homeDir));
+		return {
+			root,
+			store,
+			records: store.list()
+		};
+	};
+	const require = (records, id) => {
+		const record = records.find((entry) => entry.id === id);
+		if (record === void 0) throw new DoomGitExpectedError("worktree_not_found", `No worktree with id ${id}.`, false, "Call list to see the current ids.");
+		return record;
+	};
+	/**
+	* Refuses to destroy or merge a worktree another live session is using.
+	*
+	* `parentSessionId` records who asked for the worktree. Two sessions in one
+	* checkout share this registry, so without the check either could close the
+	* other's work in progress by id.
+	*
+	* Once that session is gone there is no owner left to protect, and refusing
+	* would strand the worktree: nothing else could ever close it.
+	*/
+	const requireOwner = (context, record, action) => {
+		if (record.parentSessionId === context.sessionId) return;
+		if (!requireSessionService().isLive(record.parentSessionId)) return;
+		throw new DoomGitExpectedError("worktree_not_owned", `Worktree ${record.id} belongs to another session.`, false, `Ask the session that created it to ${action} it, or close that session first.`);
+	};
+	const peerFor = (context, record) => {
+		if (context.sessionId === record.parentSessionId) return {
+			sessionId: record.sessionId,
+			party: "parent"
+		};
+		if (context.sessionId === record.sessionId) return {
+			sessionId: record.parentSessionId,
+			party: "child"
+		};
+		throw new DoomGitExpectedError("worktree_not_owned", `Worktree ${record.id} belongs to another session.`, false, "Use a worktree owned by this session.");
+	};
+	const requirePeerLive = (peerSessionId) => {
+		if (!requireSessionService().isLive(peerSessionId)) throw new DoomGitExpectedError("worktree_peer_unavailable", "The other worktree session is no longer live.", false, "Start a new worktree session before sending a message.");
+	};
+	return {
+		async spawn(context, request, options) {
+			const { root, store, records } = await resolve(context);
+			const refusal = refuseSpawn({
+				branch: request.branch,
+				existing: records
+			});
+			if (refusal !== void 0) throw new DoomGitExpectedError("worktree_exists", refusal, false, "Pick another branch name, or close it.");
+			const baseRef = request.baseRef ?? await git.currentBranch(root) ?? "HEAD";
+			const id = shortId(randomUUID());
+			const path = worktreeDirectory({
+				worktreesRoot: worktreesRoot(deps.homeDir),
+				repositoryLabel: repositoryLabel(root),
+				repositoryId: repositoryId(root),
+				branch: request.branch,
+				shortId: id
+			});
+			const cancelled = () => options?.signal?.aborted === true;
+			const rollback = async () => {
+				await git.removeWorktree({
+					repositoryRoot: root,
+					path,
+					force: true
+				}).catch(() => void 0);
+				return await git.deleteBranch({
+					repositoryRoot: root,
+					branch: request.branch
+				}).catch(() => false) ? "" : ` The branch ${request.branch} has work on it and was kept.`;
+			};
+			options?.onProgress?.(`creating branch ${request.branch}\u2026`);
+			await git.addWorktree({
+				repositoryRoot: root,
+				path,
+				branch: request.branch,
+				baseRef
+			});
+			if (cancelled()) {
+				const kept = await rollback();
+				throw new DoomGitExpectedError("spawn_cancelled", `Cancelled before the session started.${kept}`, false, "The worktree was removed; run it again when you are ready.");
+			}
+			options?.onProgress?.("mirroring build output…");
+			mirror(root, path);
+			options?.onProgress?.("starting session…");
+			let sessionId;
+			try {
+				sessionId = (await requireSessionService().create({
+					cwd: path,
+					name: request.name ?? request.branch,
+					parentSessionId: context.sessionId,
+					sessionProvenance: "worktree",
+					...options?.signal === void 0 ? {} : { signal: options.signal }
+				})).sessionId;
+			} catch (error) {
+				const kept = await rollback();
+				if (cancelled()) throw new DoomGitExpectedError("spawn_cancelled", `Cancelled while the session was starting.${kept}`, false, "The worktree was removed; run it again when you are ready.");
+				if (error instanceof HubUnavailableError) throw new DoomGitExpectedError("hub_unavailable", `${error.message}${kept}`, true, "Start the cockpit and try again.");
+				throw error;
+			}
+			const record = {
+				version: 1,
+				id,
+				branch: request.branch,
+				baseRef,
+				path,
+				repositoryRoot: root,
+				sessionId,
+				parentSessionId: context.sessionId,
+				status: "running",
+				createdAt: now().toISOString()
+			};
+			try {
+				store.replace([...records, record]);
+			} catch (error) {
+				await requireSessionService().close(sessionId).catch(() => void 0);
+				const kept = await rollback();
+				throw new DoomGitExpectedError("registry_write_failed", `The worktree was created but the registry could not be written (${error.message}).${kept}`, true, "Check the registry file for permissions or free space, then try again.");
+			}
+			return record;
+		},
+		async close(context, id, force) {
+			const { root, store, records } = await resolve(context);
+			const record = require(records, id);
+			requireOwner(context, record, "close");
+			const dirtyFiles = fs.existsSync(record.path) ? await git.dirtyFiles(record.path) : [];
+			const refusal = refuseClose({
+				record,
+				dirtyFiles,
+				force
+			});
+			if (refusal !== void 0) throw new DoomGitExpectedError("worktree_dirty", refusal, false, "Commit the work, or pass force: true.");
+			await requireSessionService().close(record.sessionId);
+			await git.removeWorktree({
+				repositoryRoot: root,
+				path: record.path,
+				force
+			});
+			store.replace(records.filter((entry) => entry.id !== id));
+			return record;
+		},
+		async list(context) {
+			const { store, records } = await resolve(context);
+			const outcome = reconcile(records, probe);
+			if (outcome.changed.length > 0) store.replace(outcome.records);
+			return outcome.records;
+		},
+		async status(context, id) {
+			const { records } = await resolve(context);
+			const record = require(records, id);
+			return {
+				record,
+				dirtyFiles: fs.existsSync(record.path) ? await git.dirtyFiles(record.path) : []
+			};
+		},
+		async merge(context, id, message) {
+			const { root, records } = await resolve(context);
+			const record = require(records, id);
+			requireOwner(context, record, "merge");
+			const parentDirty = await git.dirtyFiles(root);
+			if (parentDirty.length > 0) throw new DoomGitExpectedError("worktree_dirty", `The parent checkout has ${String(parentDirty.length)} uncommitted file(s): ${parentDirty.slice(0, 10).join(", ")}.`, false, "Commit or stash the parent checkout first.");
+			await git.mergeBranch({
+				repositoryRoot: root,
+				branch: record.branch,
+				...message === void 0 ? {} : { message }
+			});
+			return record;
+		},
+		/** Sends only between the parent session and its own worktree session. */
+		async send(context, id, message) {
+			if (Buffer.byteLength(message, "utf8") > 65536) throw new DoomGitExpectedError("message_too_large", `A message may not exceed ${String(MAX_WORKTREE_MESSAGE_BYTES)} bytes.`, false, "Send a shorter message.");
+			const { records } = await resolve(context);
+			const record = require(records, id);
+			const peer = peerFor(context, record);
+			requirePeerLive(peer.sessionId);
+			requireMessageInbox().send(peer.sessionId, {
+				version: 1,
+				worktreeId: record.id,
+				fromSessionId: context.sessionId,
+				from: peer.party,
+				text: message,
+				sentAt: (/* @__PURE__ */ new Date()).toISOString()
+			});
+		},
+		async messages(context, id) {
+			const { records } = await resolve(context);
+			const record = require(records, id);
+			peerFor(context, record);
+			return requireMessageInbox().receive(record.id);
+		},
+		async prune(context, dryRun) {
+			const { root, store, records } = await resolve(context);
+			const reconciled = reconcile(records, probe);
+			const gitPaths = await git.listWorktreePaths(root);
+			const dirtyByPath = /* @__PURE__ */ new Map();
+			for (const record of reconciled.records) if (record.status === "orphaned" && fs.existsSync(record.path)) dirtyByPath.set(record.path, await git.dirtyFiles(record.path));
+			const plan = planPrune({
+				records: reconciled.records,
+				gitPaths,
+				worktreesRoot: worktreesRoot(deps.homeDir),
+				dirtyByPath
+			});
+			if (dryRun) {
+				store.replace(reconciled.records);
+				return plan;
+			}
+			for (const record of plan.remove) await git.removeWorktree({
+				repositoryRoot: root,
+				path: record.path,
+				force: false
+			});
+			for (const record of [...plan.remove, ...plan.forget]) if (!await git.deleteBranch({
+				repositoryRoot: root,
+				branch: record.branch
+			}).catch(() => false)) plan.keptBranches.push(record.branch);
+			const dropped = new Set([...plan.remove, ...plan.forget].map((record) => record.id));
+			store.replace(reconciled.records.filter((record) => !dropped.has(record.id)));
+			return plan;
+		}
+	};
+}
+//#endregion
+export { createWorktreeOperations };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/worktreeOperations/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/worktreeOperations/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\n\nimport type { DoomHubSessionService } from '@agimon-ai/doompi-core/hub-channel';\n\nimport { WORKTREE_RECORD_VERSION } from '../../types/worktreeRegistry';\nimport type { WorktreeGit, WorktreeRecord } from '../../types/worktreeRegistry';\nimport { mirrorComposition } from '../compositionMirror';\nimport { DoomGitExpectedError, HubUnavailableError } from '../errors';\nimport { registryFile, worktreesRoot } from '../paths';\nimport { repositoryId, repositoryLabel, shortId } from '../repositoryIdentity';\nimport { MAX_WORKTREE_MESSAGE_BYTES, type WorktreeMessageInbox, type WorktreeMessageParty } from '../worktreeEvents';\nimport { planPrune, reconcile, refuseClose, refuseSpawn, worktreeDirectory } from '../worktreeNaming';\nimport { createWorktreeRegistry } from '../worktreeRegistry';\n\nexport interface WorktreeContext {\n  /** Where the calling session is working, used to find the repository. */\n  cwd: string;\n  /** The calling session, recorded as the new session's parent. */\n  sessionId: string;\n}\n\nexport interface SpawnWorktreeRequest {\n  branch: string;\n  baseRef?: string;\n  name?: string;\n}\n\nexport interface SpawnOptions {\n  /** Aborted when the caller gives up, so a spawn nobody is waiting for stops. */\n  signal?: AbortSignal;\n  /** Phase labels, for a caller that can show them while the work runs. */\n  onProgress?: (label: string) => void;\n}\n\nexport interface WorktreeOperations {\n  spawn(context: WorktreeContext, request: SpawnWorktreeRequest, options?: SpawnOptions): Promise<WorktreeRecord>;\n  close(context: WorktreeContext, id: string, force: boolean): Promise<WorktreeRecord>;\n  list(context: WorktreeContext): Promise<WorktreeRecord[]>;\n  status(context: WorktreeContext, id: string): Promise<{ record: WorktreeRecord; dirtyFiles: string[] }>;\n  merge(context: WorktreeContext, id: string, message?: string): Promise<WorktreeRecord>;\n  prune(context: WorktreeContext, dryRun: boolean): Promise<ReturnType<typeof planPrune>>;\n  send(context: WorktreeContext, id: string, message: string): Promise<void>;\n  messages(context: WorktreeContext, id: string): Promise<import('../worktreeEvents').WorktreeMessage[]>;\n}\n\nexport interface WorktreeOperationsDeps {\n  git: WorktreeGit;\n  /** The canonical hub-owned session lifecycle. */\n  sessionService?: DoomHubSessionService;\n  /** Session-local inbox for parent/worktree messages. */\n  messageInbox?: WorktreeMessageInbox;\n  /** Injected so a test never copies a real dependency tree. */\n  mirror?: typeof mirrorComposition;\n  homeDir?: string;\n  /** Injected so a record's createdAt is reproducible in a test. */\n  now?: () => Date;\n}\n\nexport function createWorktreeOperations(deps: WorktreeOperationsDeps): WorktreeOperations {\n  const { git } = deps;\n  const sessionService = deps.sessionService;\n  const mirror = deps.mirror ?? mirrorComposition;\n  const now = deps.now ?? (() => new Date());\n  const requireSessionService = (): DoomHubSessionService => {\n    if (sessionService === undefined)\n      throw new HubUnavailableError('The cockpit session service is unavailable. Start the cockpit and try again.');\n    return sessionService;\n  };\n  const requireMessageInbox = (): WorktreeMessageInbox => {\n    if (deps.messageInbox === undefined)\n      throw new HubUnavailableError('The Git message service is unavailable. Start the cockpit and try again.');\n    return deps.messageInbox;\n  };\n  const probe = {\n    alive: (record: WorktreeRecord) => requireSessionService().isLive(record.sessionId),\n    exists: (path: string) => fs.existsSync(path),\n  };\n\n  /**\n   * Everything an action needs about the repository it is acting on.\n   *\n   * Resolved per call rather than cached: a session's cwd is stable, but the\n   * worktree registry is shared and another process may have written it since\n   * the last call.\n   */\n  const resolve = async (context: WorktreeContext) => {\n    const root = await git.repositoryRoot(context.cwd);\n    if (root === undefined) {\n      throw new DoomGitExpectedError(\n        'not_a_repository',\n        `${context.cwd} is not inside a git repository.`,\n        false,\n        'Run this from a repository checkout.',\n      );\n    }\n    const store = createWorktreeRegistry(registryFile(root, deps.homeDir));\n    return { root, store, records: store.list() };\n  };\n\n  const require = (records: readonly WorktreeRecord[], id: string): WorktreeRecord => {\n    const record = records.find((entry) => entry.id === id);\n    if (record === undefined) {\n      throw new DoomGitExpectedError(\n        'worktree_not_found',\n        `No worktree with id ${id}.`,\n        false,\n        'Call list to see the current ids.',\n      );\n    }\n    return record;\n  };\n\n  /**\n   * Refuses to destroy or merge a worktree another live session is using.\n   *\n   * `parentSessionId` records who asked for the worktree. Two sessions in one\n   * checkout share this registry, so without the check either could close the\n   * other's work in progress by id.\n   *\n   * Once that session is gone there is no owner left to protect, and refusing\n   * would strand the worktree: nothing else could ever close it.\n   */\n  const requireOwner = (context: WorktreeContext, record: WorktreeRecord, action: string): void => {\n    if (record.parentSessionId === context.sessionId) return;\n    if (!requireSessionService().isLive(record.parentSessionId)) return;\n    throw new DoomGitExpectedError(\n      'worktree_not_owned',\n      `Worktree ${record.id} belongs to another session.`,\n      false,\n      `Ask the session that created it to ${action} it, or close that session first.`,\n    );\n  };\n\n  const peerFor = (\n    context: WorktreeContext,\n    record: WorktreeRecord,\n  ): { sessionId: string; party: WorktreeMessageParty } => {\n    if (context.sessionId === record.parentSessionId) return { sessionId: record.sessionId, party: 'parent' };\n    if (context.sessionId === record.sessionId) return { sessionId: record.parentSessionId, party: 'child' };\n    throw new DoomGitExpectedError(\n      'worktree_not_owned',\n      `Worktree ${record.id} belongs to another session.`,\n      false,\n      'Use a worktree owned by this session.',\n    );\n  };\n\n  const requirePeerLive = (peerSessionId: string): void => {\n    if (!requireSessionService().isLive(peerSessionId)) {\n      throw new DoomGitExpectedError(\n        'worktree_peer_unavailable',\n        'The other worktree session is no longer live.',\n        false,\n        'Start a new worktree session before sending a message.',\n      );\n    }\n  };\n\n  return {\n    async spawn(context, request, options) {\n      const { root, store, records } = await resolve(context);\n      const refusal = refuseSpawn({ branch: request.branch, existing: records });\n      if (refusal !== undefined) {\n        throw new DoomGitExpectedError('worktree_exists', refusal, false, 'Pick another branch name, or close it.');\n      }\n      const baseRef = request.baseRef ?? (await git.currentBranch(root)) ?? 'HEAD';\n      const id = shortId(randomUUID());\n      const path = worktreeDirectory({\n        worktreesRoot: worktreesRoot(deps.homeDir),\n        repositoryLabel: repositoryLabel(root),\n        repositoryId: repositoryId(root),\n        branch: request.branch,\n        shortId: id,\n      });\n\n      // The worktree and the branch are made by one command, so they are undone\n      // by one too. `worktree remove` leaves the branch behind, and a branch\n      // nobody asked for is what a failed spawn used to leave on the floor.\n      const cancelled = (): boolean => options?.signal?.aborted === true;\n      const rollback = async (): Promise<string> => {\n        await git.removeWorktree({ repositoryRoot: root, path, force: true }).catch(() => undefined);\n        const deleted = await git.deleteBranch({ repositoryRoot: root, branch: request.branch }).catch(() => false);\n        return deleted ? '' : ` The branch ${request.branch} has work on it and was kept.`;\n      };\n\n      options?.onProgress?.(`creating branch ${request.branch}\\u2026`);\n      await git.addWorktree({ repositoryRoot: root, path, branch: request.branch, baseRef });\n\n      // Checked here rather than only inside the session call: this is the\n      // point where a checkout exists that nothing has recorded yet, which is\n      // exactly the state an interrupted spawn used to leave behind.\n      if (cancelled()) {\n        const kept = await rollback();\n        throw new DoomGitExpectedError(\n          'spawn_cancelled',\n          `Cancelled before the session started.${kept}`,\n          false,\n          'The worktree was removed; run it again when you are ready.',\n        );\n      }\n\n      // Before the session, because the session composes the extensions this\n      // repository's config names and those live in build output git does not\n      // track. A worktree without it starts and dies on the first package it\n      // cannot resolve. Nothing here can fail the spawn: a repository with no\n      // build output to mirror simply has none.\n      options?.onProgress?.('mirroring build output\\u2026');\n      mirror(root, path);\n\n      // The worktree exists from here on, so every later failure has to leave\n      // it removed or recorded. An unrecorded directory on disk is the one\n      // outcome with no way back: nothing would ever list it again.\n      options?.onProgress?.('starting session\\u2026');\n      let sessionId: string;\n      try {\n        const session = await requireSessionService().create({\n          cwd: path,\n          name: request.name ?? request.branch,\n          parentSessionId: context.sessionId,\n          sessionProvenance: 'worktree',\n          ...(options?.signal === undefined ? {} : { signal: options.signal }),\n        });\n        sessionId = session.sessionId;\n      } catch (error) {\n        const kept = await rollback();\n        if (cancelled()) {\n          throw new DoomGitExpectedError(\n            'spawn_cancelled',\n            `Cancelled while the session was starting.${kept}`,\n            false,\n            'The worktree was removed; run it again when you are ready.',\n          );\n        }\n        if (error instanceof HubUnavailableError) {\n          throw new DoomGitExpectedError(\n            'hub_unavailable',\n            `${error.message}${kept}`,\n            true,\n            'Start the cockpit and try again.',\n          );\n        }\n        throw error;\n      }\n\n      const record: WorktreeRecord = {\n        version: WORKTREE_RECORD_VERSION,\n        id,\n        branch: request.branch,\n        baseRef,\n        path,\n        repositoryRoot: root,\n        sessionId,\n        parentSessionId: context.sessionId,\n        status: 'running',\n        createdAt: now().toISOString(),\n      };\n      try {\n        store.replace([...records, record]);\n      } catch (error) {\n        // A live session with no record is the worst outcome available here:\n        // it runs, and no id anything can name points at it. The session goes\n        // back too, rather than being left for someone to find by hand.\n        await requireSessionService()\n          .close(sessionId)\n          .catch(() => undefined);\n        const kept = await rollback();\n        throw new DoomGitExpectedError(\n          'registry_write_failed',\n          `The worktree was created but the registry could not be written (${(error as Error).message}).${kept}`,\n          true,\n          'Check the registry file for permissions or free space, then try again.',\n        );\n      }\n      return record;\n    },\n\n    async close(context, id, force) {\n      const { root, store, records } = await resolve(context);\n      const record = require(records, id);\n      requireOwner(context, record, 'close');\n      const dirtyFiles = fs.existsSync(record.path) ? await git.dirtyFiles(record.path) : [];\n      const refusal = refuseClose({ record, dirtyFiles, force });\n      if (refusal !== undefined) {\n        throw new DoomGitExpectedError('worktree_dirty', refusal, false, 'Commit the work, or pass force: true.');\n      }\n      // The session is stopped before the directory goes. Removing a checkout\n      // while a process still holds files open in it is how a half-removed\n      // worktree and a stale git administrative entry are made.\n      await requireSessionService().close(record.sessionId);\n      await git.removeWorktree({ repositoryRoot: root, path: record.path, force });\n      store.replace(records.filter((entry) => entry.id !== id));\n      return record;\n    },\n\n    async list(context) {\n      const { store, records } = await resolve(context);\n      const outcome = reconcile(records, probe);\n      if (outcome.changed.length > 0) store.replace(outcome.records);\n      return outcome.records;\n    },\n\n    async status(context, id) {\n      const { records } = await resolve(context);\n      const record = require(records, id);\n      const dirtyFiles = fs.existsSync(record.path) ? await git.dirtyFiles(record.path) : [];\n      return { record, dirtyFiles };\n    },\n\n    async merge(context, id, message) {\n      const { root, records } = await resolve(context);\n      const record = require(records, id);\n      requireOwner(context, record, 'merge');\n      // The merge lands in the parent, so the parent is what must be clean. A\n      // dirty parent would mix the person's in-flight edits into a merge commit\n      // they did not intend to make.\n      const parentDirty = await git.dirtyFiles(root);\n      if (parentDirty.length > 0) {\n        throw new DoomGitExpectedError(\n          'worktree_dirty',\n          `The parent checkout has ${String(parentDirty.length)} uncommitted file(s): ${parentDirty.slice(0, 10).join(', ')}.`,\n          false,\n          'Commit or stash the parent checkout first.',\n        );\n      }\n      await git.mergeBranch({\n        repositoryRoot: root,\n        branch: record.branch,\n        ...(message === undefined ? {} : { message }),\n      });\n      return record;\n    },\n\n    /** Sends only between the parent session and its own worktree session. */\n    async send(context, id, message) {\n      if (Buffer.byteLength(message, 'utf8') > MAX_WORKTREE_MESSAGE_BYTES) {\n        throw new DoomGitExpectedError(\n          'message_too_large',\n          `A message may not exceed ${String(MAX_WORKTREE_MESSAGE_BYTES)} bytes.`,\n          false,\n          'Send a shorter message.',\n        );\n      }\n      const { records } = await resolve(context);\n      const record = require(records, id);\n      const peer = peerFor(context, record);\n      requirePeerLive(peer.sessionId);\n      requireMessageInbox().send(peer.sessionId, {\n        version: 1,\n        worktreeId: record.id,\n        fromSessionId: context.sessionId,\n        from: peer.party,\n        text: message,\n        sentAt: new Date().toISOString(),\n      });\n    },\n\n    async messages(context, id) {\n      const { records } = await resolve(context);\n      const record = require(records, id);\n      peerFor(context, record);\n      return requireMessageInbox().receive(record.id);\n    },\n\n    async prune(context, dryRun) {\n      const { root, store, records } = await resolve(context);\n      const reconciled = reconcile(records, probe);\n      const gitPaths = await git.listWorktreePaths(root);\n      const dirtyByPath = new Map<string, readonly string[]>();\n      for (const record of reconciled.records) {\n        if (record.status === 'orphaned' && fs.existsSync(record.path)) {\n          dirtyByPath.set(record.path, await git.dirtyFiles(record.path));\n        }\n      }\n      const plan = planPrune({\n        records: reconciled.records,\n        gitPaths,\n        worktreesRoot: worktreesRoot(deps.homeDir),\n        dirtyByPath,\n      });\n      if (dryRun) {\n        store.replace(reconciled.records);\n        return plan;\n      }\n      for (const record of plan.remove) {\n        await git.removeWorktree({ repositoryRoot: root, path: record.path, force: false });\n      }\n      // The checkout goes, so the branch it was made for goes with it. Safe\n      // delete only: git keeps anything holding commits, and the plan says\n      // which ones it kept rather than leaving the reader to notice later.\n      for (const record of [...plan.remove, ...plan.forget]) {\n        const deleted = await git.deleteBranch({ repositoryRoot: root, branch: record.branch }).catch(() => false);\n        if (!deleted) plan.keptBranches.push(record.branch);\n      }\n      const dropped = new Set([...plan.remove, ...plan.forget].map((record) => record.id));\n      store.replace(reconciled.records.filter((record) => !dropped.has(record.id)));\n      return plan;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/services/worktreeRegistry/index.cjs

@@ -0,0 +1,38 @@
+const require_index = require("../atomicJson/index.cjs");
+//#region src/services/worktreeRegistry/index.ts
+function isRecord(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const record = value;
+	return record.version === 1 && typeof record.id === "string" && record.id !== "" && typeof record.path === "string" && typeof record.branch === "string" && typeof record.sessionId === "string";
+}
+/**
+* The worktree registry for one repository, as a single JSON file.
+*
+* One file rather than a file per worktree, and read-modify-write rather than
+* merging: every write comes from a tool call in one session's turn, so there
+* is no concurrent writer to reconcile with. Choosing the simpler shape now
+* means a reader can see the whole registry in one place; if concurrent writers
+* ever appear, that is the point to revisit, not before.
+*
+* A file that does not parse is treated as empty rather than fatal. Losing
+* track of worktrees is recoverable through prune; refusing to run is not.
+*/
+function createWorktreeRegistry(file) {
+	return {
+		list() {
+			const parsed = require_index.readJson(file);
+			if (!parsed || parsed.version !== 1 || !Array.isArray(parsed.entries)) return [];
+			return parsed.entries.filter(isRecord);
+		},
+		replace(entries) {
+			require_index.writeJsonAtomic(file, {
+				version: 1,
+				entries
+			});
+		}
+	};
+}
+//#endregion
+exports.createWorktreeRegistry = createWorktreeRegistry;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/worktreeRegistry/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["readJson"],"sources":["../../../../src/services/worktreeRegistry/index.ts"],"sourcesContent":["import {\n  WORKTREE_RECORD_VERSION,\n  type WorktreeRecord,\n  type WorktreeRegistryFile,\n  type WorktreeRegistryStore,\n} from '../../types/worktreeRegistry';\nimport { readJson, writeJsonAtomic } from '../atomicJson';\n\nfunction isRecord(value: unknown): value is WorktreeRecord {\n  if (typeof value !== 'object' || value === null) return false;\n  const record = value as Partial<WorktreeRecord>;\n  return (\n    record.version === WORKTREE_RECORD_VERSION &&\n    typeof record.id === 'string' &&\n    record.id !== '' &&\n    typeof record.path === 'string' &&\n    typeof record.branch === 'string' &&\n    typeof record.sessionId === 'string'\n  );\n}\n\n/**\n * The worktree registry for one repository, as a single JSON file.\n *\n * One file rather than a file per worktree, and read-modify-write rather than\n * merging: every write comes from a tool call in one session's turn, so there\n * is no concurrent writer to reconcile with. Choosing the simpler shape now\n * means a reader can see the whole registry in one place; if concurrent writers\n * ever appear, that is the point to revisit, not before.\n *\n * A file that does not parse is treated as empty rather than fatal. Losing\n * track of worktrees is recoverable through prune; refusing to run is not.\n */\nexport function createWorktreeRegistry(file: string): WorktreeRegistryStore {\n  return {\n    list() {\n      const parsed = readJson<WorktreeRegistryFile>(file);\n      if (!parsed || parsed.version !== WORKTREE_RECORD_VERSION || !Array.isArray(parsed.entries)) return [];\n      return parsed.entries.filter(isRecord);\n    },\n    replace(entries) {\n      writeJsonAtomic(file, { version: WORKTREE_RECORD_VERSION, entries } satisfies WorktreeRegistryFile);\n    },\n  };\n}\n"],"mappings":";;AAQA,SAAS,SAAS,OAAyC;CACzD,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,SAAS;CACf,OACE,OAAO,YAAA,KACP,OAAO,OAAO,OAAO,YACrB,OAAO,OAAO,MACd,OAAO,OAAO,SAAS,YACvB,OAAO,OAAO,WAAW,YACzB,OAAO,OAAO,cAAc;AAEhC;;;;;;;;;;;;;AAcA,SAAgB,uBAAuB,MAAqC;CAC1E,OAAO;EACL,OAAO;GACL,MAAM,SAASA,cAAAA,SAA+B,IAAI;GAClD,IAAI,CAAC,UAAU,OAAO,YAAA,KAAuC,CAAC,MAAM,QAAQ,OAAO,OAAO,GAAG,OAAO,CAAC;GACrG,OAAO,OAAO,QAAQ,OAAO,QAAQ;EACvC;EACA,QAAQ,SAAS;GACf,cAAA,gBAAgB,MAAM;IAAE,SAAA;IAAkC;GAAQ,CAAgC;EACpG;CACF;AACF"}

package/dist/src/services/worktreeRegistry/index.mjs

@@ -0,0 +1,38 @@
+import { readJson, writeJsonAtomic } from "../atomicJson/index.mjs";
+//#region src/services/worktreeRegistry/index.ts
+function isRecord(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const record = value;
+	return record.version === 1 && typeof record.id === "string" && record.id !== "" && typeof record.path === "string" && typeof record.branch === "string" && typeof record.sessionId === "string";
+}
+/**
+* The worktree registry for one repository, as a single JSON file.
+*
+* One file rather than a file per worktree, and read-modify-write rather than
+* merging: every write comes from a tool call in one session's turn, so there
+* is no concurrent writer to reconcile with. Choosing the simpler shape now
+* means a reader can see the whole registry in one place; if concurrent writers
+* ever appear, that is the point to revisit, not before.
+*
+* A file that does not parse is treated as empty rather than fatal. Losing
+* track of worktrees is recoverable through prune; refusing to run is not.
+*/
+function createWorktreeRegistry(file) {
+	return {
+		list() {
+			const parsed = readJson(file);
+			if (!parsed || parsed.version !== 1 || !Array.isArray(parsed.entries)) return [];
+			return parsed.entries.filter(isRecord);
+		},
+		replace(entries) {
+			writeJsonAtomic(file, {
+				version: 1,
+				entries
+			});
+		}
+	};
+}
+//#endregion
+export { createWorktreeRegistry };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/worktreeRegistry/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/worktreeRegistry/index.ts"],"sourcesContent":["import {\n  WORKTREE_RECORD_VERSION,\n  type WorktreeRecord,\n  type WorktreeRegistryFile,\n  type WorktreeRegistryStore,\n} from '../../types/worktreeRegistry';\nimport { readJson, writeJsonAtomic } from '../atomicJson';\n\nfunction isRecord(value: unknown): value is WorktreeRecord {\n  if (typeof value !== 'object' || value === null) return false;\n  const record = value as Partial<WorktreeRecord>;\n  return (\n    record.version === WORKTREE_RECORD_VERSION &&\n    typeof record.id === 'string' &&\n    record.id !== '' &&\n    typeof record.path === 'string' &&\n    typeof record.branch === 'string' &&\n    typeof record.sessionId === 'string'\n  );\n}\n\n/**\n * The worktree registry for one repository, as a single JSON file.\n *\n * One file rather than a file per worktree, and read-modify-write rather than\n * merging: every write comes from a tool call in one session's turn, so there\n * is no concurrent writer to reconcile with. Choosing the simpler shape now\n * means a reader can see the whole registry in one place; if concurrent writers\n * ever appear, that is the point to revisit, not before.\n *\n * A file that does not parse is treated as empty rather than fatal. Losing\n * track of worktrees is recoverable through prune; refusing to run is not.\n */\nexport function createWorktreeRegistry(file: string): WorktreeRegistryStore {\n  return {\n    list() {\n      const parsed = readJson<WorktreeRegistryFile>(file);\n      if (!parsed || parsed.version !== WORKTREE_RECORD_VERSION || !Array.isArray(parsed.entries)) return [];\n      return parsed.entries.filter(isRecord);\n    },\n    replace(entries) {\n      writeJsonAtomic(file, { version: WORKTREE_RECORD_VERSION, entries } satisfies WorktreeRegistryFile);\n    },\n  };\n}\n"],"mappings":";;AAQA,SAAS,SAAS,OAAyC;CACzD,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,SAAS;CACf,OACE,OAAO,YAAA,KACP,OAAO,OAAO,OAAO,YACrB,OAAO,OAAO,MACd,OAAO,OAAO,SAAS,YACvB,OAAO,OAAO,WAAW,YACzB,OAAO,OAAO,cAAc;AAEhC;;;;;;;;;;;;;AAcA,SAAgB,uBAAuB,MAAqC;CAC1E,OAAO;EACL,OAAO;GACL,MAAM,SAAS,SAA+B,IAAI;GAClD,IAAI,CAAC,UAAU,OAAO,YAAA,KAAuC,CAAC,MAAM,QAAQ,OAAO,OAAO,GAAG,OAAO,CAAC;GACrG,OAAO,OAAO,QAAQ,OAAO,QAAQ;EACvC;EACA,QAAQ,SAAS;GACf,gBAAgB,MAAM;IAAE,SAAA;IAAkC;GAAQ,CAAgC;EACpG;CACF;AACF"}

package/dist/{types → src/types}/extension.d.cts

@@ -1,17 +1,16 @@
 import { WorktreeOperations } from "../services/worktreeOperations/index.cjs";
 //#region src/types/extension.d.ts
-type GitNotificationLevel = 'info';
-interface GitExtensionResult {
+export type GitNotificationLevel = 'info';
+export interface GitExtensionResult {
   message: string;
   level: GitNotificationLevel;
 }
-interface GitExtensionService {
+export interface GitExtensionService {
   execute(): Promise<GitExtensionResult>;
 }
-interface GitExtensionDependencies {
+export interface GitExtensionDependencies {
   service: GitExtensionService;
   operations: WorktreeOperations;
 }
 //#endregion
-export { GitExtensionDependencies, GitExtensionResult, GitExtensionService, GitNotificationLevel };
 //# sourceMappingURL=extension.d.cts.map

package/dist/src/types/extension.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.cts","names":[],"sources":["../../../src/types/extension.ts"],"mappings":";;YAGY;iBAEK;EACf;EACA,OAAO;;iBAGQ;EACf,WAAW,QAAQ;;iBAGJ;EACf,SAAS;EACT,YAAY"}

package/dist/{types → src/types}/extension.d.mts

@@ -1,17 +1,16 @@
 import { WorktreeOperations } from "../services/worktreeOperations/index.mjs";
 //#region src/types/extension.d.ts
-type GitNotificationLevel = 'info';
-interface GitExtensionResult {
+export type GitNotificationLevel = 'info';
+export interface GitExtensionResult {
   message: string;
   level: GitNotificationLevel;
 }
-interface GitExtensionService {
+export interface GitExtensionService {
   execute(): Promise<GitExtensionResult>;
 }
-interface GitExtensionDependencies {
+export interface GitExtensionDependencies {
   service: GitExtensionService;
   operations: WorktreeOperations;
 }
 //#endregion
-export { GitExtensionDependencies, GitExtensionResult, GitExtensionService, GitNotificationLevel };
 //# sourceMappingURL=extension.d.mts.map

package/dist/src/types/extension.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.mts","names":[],"sources":["../../../src/types/extension.ts"],"mappings":";;YAGY;iBAEK;EACf;EACA,OAAO;;iBAGQ;EACf,WAAW,QAAQ;;iBAGJ;EACf,SAAS;EACT,YAAY"}

package/dist/src/types/webWorktrees.cjs

@@ -0,0 +1,20 @@
+//#region src/types/webWorktrees.ts
+/**
+* The cockpit's view of this session's worktrees.
+*
+* DESIGN PATTERNS:
+* - Declarations only. The channel frame type is a constant so the hub and the
+*   page cannot drift apart on a string.
+* - A view is the subset of a record the dock needs, not the record. The
+*   registry may hold paths and provenance the page has no business rendering.
+*
+* AVOID:
+* - Adding behaviour here. This file is imported by browser code, so it must
+*   stay free of node builtins.
+*/
+/** The data channel carrying one session's worktrees to the page. */
+const GIT_WORKTREES_TYPE = "git_worktrees";
+//#endregion
+exports.GIT_WORKTREES_TYPE = GIT_WORKTREES_TYPE;
+
+//# sourceMappingURL=webWorktrees.cjs.map

package/dist/src/types/webWorktrees.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webWorktrees.cjs","names":[],"sources":["../../../src/types/webWorktrees.ts"],"sourcesContent":["/**\n * The cockpit's view of this session's worktrees.\n *\n * DESIGN PATTERNS:\n * - Declarations only. The channel frame type is a constant so the hub and the\n *   page cannot drift apart on a string.\n * - A view is the subset of a record the dock needs, not the record. The\n *   registry may hold paths and provenance the page has no business rendering.\n *\n * AVOID:\n * - Adding behaviour here. This file is imported by browser code, so it must\n *   stay free of node builtins.\n */\n\n/** The data channel carrying one session's worktrees to the page. */\nexport const GIT_WORKTREES_TYPE = 'git_worktrees';\n\n/** One worktree, as the activity dock and its panel render it. */\nexport interface WorktreeView {\n  id: string;\n  branch: string;\n  path: string;\n  /** The session the hub started for this worktree, when it is still live. */\n  sessionId: string | null;\n  /** True once the directory the record names has gone missing. */\n  orphaned: boolean;\n  /**\n   * True when the session that asked for this worktree is gone.\n   *\n   * An owned worktree is only ever shown to its own session. This flag marks\n   * the exception: once the parent is dead nobody would see the worktree at\n   * all, so every session in the repository does, and may close it.\n   */\n  unowned: boolean;\n}\n\n/**\n * What the panel asks the hub channel to do.\n *\n * The dock acts through its own channel rather than through the agent: a\n * worktree made from the panel and one made by the tool take the same\n * `worktreeOperations` path, but the panel no longer has to spend a turn of\n * the conversation to get there.\n */\nexport type GitWorktreesCommand =\n  | { action: 'create'; branch: string; baseRef?: string }\n  | { action: 'close'; id: string; force?: boolean };\n\nexport interface GitWorktreesPayload {\n  worktrees: WorktreeView[];\n  /** Label of the operation in flight, absent when the session is idle. */\n  pending?: string;\n  /** The last failure, cleared when the next command starts. */\n  error?: string;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAa,qBAAqB"}

package/dist/src/types/webWorktrees.mjs

@@ -0,0 +1,20 @@
+//#region src/types/webWorktrees.ts
+/**
+* The cockpit's view of this session's worktrees.
+*
+* DESIGN PATTERNS:
+* - Declarations only. The channel frame type is a constant so the hub and the
+*   page cannot drift apart on a string.
+* - A view is the subset of a record the dock needs, not the record. The
+*   registry may hold paths and provenance the page has no business rendering.
+*
+* AVOID:
+* - Adding behaviour here. This file is imported by browser code, so it must
+*   stay free of node builtins.
+*/
+/** The data channel carrying one session's worktrees to the page. */
+const GIT_WORKTREES_TYPE = "git_worktrees";
+//#endregion
+export { GIT_WORKTREES_TYPE };
+
+//# sourceMappingURL=webWorktrees.mjs.map

package/dist/src/types/webWorktrees.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webWorktrees.mjs","names":[],"sources":["../../../src/types/webWorktrees.ts"],"sourcesContent":["/**\n * The cockpit's view of this session's worktrees.\n *\n * DESIGN PATTERNS:\n * - Declarations only. The channel frame type is a constant so the hub and the\n *   page cannot drift apart on a string.\n * - A view is the subset of a record the dock needs, not the record. The\n *   registry may hold paths and provenance the page has no business rendering.\n *\n * AVOID:\n * - Adding behaviour here. This file is imported by browser code, so it must\n *   stay free of node builtins.\n */\n\n/** The data channel carrying one session's worktrees to the page. */\nexport const GIT_WORKTREES_TYPE = 'git_worktrees';\n\n/** One worktree, as the activity dock and its panel render it. */\nexport interface WorktreeView {\n  id: string;\n  branch: string;\n  path: string;\n  /** The session the hub started for this worktree, when it is still live. */\n  sessionId: string | null;\n  /** True once the directory the record names has gone missing. */\n  orphaned: boolean;\n  /**\n   * True when the session that asked for this worktree is gone.\n   *\n   * An owned worktree is only ever shown to its own session. This flag marks\n   * the exception: once the parent is dead nobody would see the worktree at\n   * all, so every session in the repository does, and may close it.\n   */\n  unowned: boolean;\n}\n\n/**\n * What the panel asks the hub channel to do.\n *\n * The dock acts through its own channel rather than through the agent: a\n * worktree made from the panel and one made by the tool take the same\n * `worktreeOperations` path, but the panel no longer has to spend a turn of\n * the conversation to get there.\n */\nexport type GitWorktreesCommand =\n  | { action: 'create'; branch: string; baseRef?: string }\n  | { action: 'close'; id: string; force?: boolean };\n\nexport interface GitWorktreesPayload {\n  worktrees: WorktreeView[];\n  /** Label of the operation in flight, absent when the session is idle. */\n  pending?: string;\n  /** The last failure, cleared when the next command starts. */\n  error?: string;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAa,qBAAqB"}

package/dist/{types → src/types}/worktreeRegistry.d.cts

@@ -14,9 +14,9 @@
  * directory has vanished, but the worktree may still hold uncommitted work, so
  * the record is kept until someone decides what to do with it.
  */
-type WorktreeStatus = 'spawning' | 'running' | 'closing' | 'orphaned';
-declare const WORKTREE_RECORD_VERSION = 1;
-interface WorktreeRecord {
+export type WorktreeStatus = 'spawning' | 'running' | 'closing' | 'orphaned';
+export declare const WORKTREE_RECORD_VERSION = 1;
+export interface WorktreeRecord {
   version: typeof WORKTREE_RECORD_VERSION;
   /** This registry's own id, distinct from the session id, and stable across restarts. */
   id: string;
@@ -37,5 +37,4 @@ interface WorktreeRecord {
   createdAt: string;
 }
 //#endregion
-export { WORKTREE_RECORD_VERSION, WorktreeRecord, WorktreeStatus };
 //# sourceMappingURL=worktreeRegistry.d.cts.map

package/dist/src/types/worktreeRegistry.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktreeRegistry.d.cts","names":[],"sources":["../../../src/types/worktreeRegistry.ts"],"mappings":";;;;;;;;;;;;;;;;YAgBY;qBAEC;iBAEI;EACf,gBAAgB;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;EACA,QAAQ;;EAER"}

package/dist/{types → src/types}/worktreeRegistry.d.mts

@@ -14,9 +14,9 @@
  * directory has vanished, but the worktree may still hold uncommitted work, so
  * the record is kept until someone decides what to do with it.
  */
-type WorktreeStatus = 'spawning' | 'running' | 'closing' | 'orphaned';
-declare const WORKTREE_RECORD_VERSION = 1;
-interface WorktreeRecord {
+export type WorktreeStatus = 'spawning' | 'running' | 'closing' | 'orphaned';
+export declare const WORKTREE_RECORD_VERSION = 1;
+export interface WorktreeRecord {
   version: typeof WORKTREE_RECORD_VERSION;
   /** This registry's own id, distinct from the session id, and stable across restarts. */
   id: string;
@@ -37,5 +37,4 @@ interface WorktreeRecord {
   createdAt: string;
 }
 //#endregion
-export { WORKTREE_RECORD_VERSION, WorktreeRecord, WorktreeStatus };
 //# sourceMappingURL=worktreeRegistry.d.mts.map

package/dist/src/types/worktreeRegistry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktreeRegistry.d.mts","names":[],"sources":["../../../src/types/worktreeRegistry.ts"],"mappings":";;;;;;;;;;;;;;;;YAgBY;qBAEC;iBAEI;EACf,gBAAgB;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;EACA,QAAQ;;EAER"}