@agimon-ai/doompi-git 0.0.1-alpha.11 → 0.0.1-alpha.13

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["mirrorComposition","HubUnavailableError","fs","DoomGitExpectedError","createWorktreeRegistry","registryFile","require","refuseSpawn","shortId","randomUUID","worktreeDirectory","worktreesRoot","repositoryLabel","repositoryId","refuseClose","reconcile","MAX_WORKTREE_MESSAGE_BYTES","planPrune"],"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';\nimport type { DoomSessionDeliveryService } from '@agimon-ai/doompi-session';\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\nconst GIT_WORKTREE_DELEGATION_KIND = 'git.worktree.delegation';\nconst GIT_WORKTREE_MESSAGE_KIND = 'git.worktree.message';\nconst GIT_WORKTREE_REPORT_KIND = 'git.worktree.report';\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  task?: 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  /** Legacy in-memory fallback used outside the fixed Session composition. */\n  messageInbox?: WorktreeMessageInbox;\n  /** Reads the active Session provider when an operation executes. */\n  sessionDelivery?: () => DoomSessionDeliveryService | undefined;\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 readSessionDelivery = (): DoomSessionDeliveryService | undefined => deps.sessionDelivery?.();\n  const requireSessionDelivery = (): DoomSessionDeliveryService => {\n    const delivery = readSessionDelivery();\n    if (delivery === undefined)\n      throw new HubUnavailableError('The Session delivery service is unavailable. Start the cockpit and try again.');\n    return delivery;\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 taskDelivery = request.task === undefined ? undefined : requireSessionDelivery();\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      if (request.task !== undefined && taskDelivery !== undefined) {\n        try {\n          const receipt = await taskDelivery.deliver({\n            recipientKey: sessionId,\n            kind: GIT_WORKTREE_DELEGATION_KIND,\n            prompt: request.task,\n            metadata: {\n              worktreeId: record.id,\n              fromRole: 'parent',\n              text: request.task,\n              sentAt: record.createdAt,\n            },\n          });\n          const admission = await taskDelivery.waitForAdmission(receipt.deliveryId);\n          if (admission !== 'admitted') {\n            throw new Error(\n              admission === 'recovery_required'\n                ? 'The recipient could not admit the task.'\n                : 'The recipient did not confirm task admission before the timeout.',\n            );\n          }\n        } catch (error) {\n          throw new DoomGitExpectedError(\n            'task_delivery_failed',\n            `Worktree ${record.id} was created, but its task admission was not confirmed (${(error as Error).message}).`,\n            true,\n            `Use send with worktree ${record.id} to deliver the task without recreating the worktree.`,\n          );\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      const sentAt = new Date().toISOString();\n      const delivery = readSessionDelivery();\n      if (delivery !== undefined) {\n        const kind = peer.party === 'parent' ? GIT_WORKTREE_MESSAGE_KIND : GIT_WORKTREE_REPORT_KIND;\n        const receipt = await delivery.deliver({\n          recipientKey: peer.sessionId,\n          kind,\n          prompt:\n            peer.party === 'parent'\n              ? `Parent message for worktree ${record.id}:\\n\\n${message}`\n              : `Report from worktree ${record.id}:\\n\\n${message}`,\n          metadata: { worktreeId: record.id, fromRole: peer.party, text: message, sentAt },\n        });\n        const admission = await delivery.waitForAdmission(receipt.deliveryId);\n        if (admission !== 'admitted') {\n          throw new DoomGitExpectedError(\n            'message_delivery_failed',\n            `Worktree ${record.id} persisted the message, but its session did not confirm admission.`,\n            true,\n            admission === 'recovery_required'\n              ? 'Call messages from the recipient session to recover the persisted text.'\n              : 'The message remains durable; retry after the recipient is ready.',\n          );\n        }\n        return;\n      }\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,\n      });\n    },\n\n    async messages(context, id) {\n      const { records } = await resolve(context);\n      const record = require(records, id);\n      const peer = peerFor(context, record);\n      const delivery = readSessionDelivery();\n      if (delivery === undefined) return requireMessageInbox().receive(record.id);\n      const entries = delivery\n        .inbox({ consumed: false, metadata: { worktreeId: record.id } })\n        .filter(\n          (entry) =>\n            entry.senderKey === peer.sessionId &&\n            (entry.state === 'admitted' || entry.state === 'recovery_required') &&\n            (peer.party === 'parent'\n              ? entry.kind === GIT_WORKTREE_REPORT_KIND\n              : entry.kind === GIT_WORKTREE_MESSAGE_KIND || entry.kind === GIT_WORKTREE_DELEGATION_KIND),\n        );\n      return entries.map((entry) => {\n        delivery.consume(entry.deliveryId);\n        return {\n          version: 1,\n          worktreeId: record.id,\n          fromSessionId: entry.senderKey,\n          from: peer.party === 'parent' ? ('child' as const) : ('parent' as const),\n          text:\n            entry.state === 'recovery_required'\n              ? `[Recovery required: prompt admission was not confirmed] ${entry.metadata.text ?? entry.prompt}`\n              : (entry.metadata.text ?? entry.prompt),\n          sentAt: entry.metadata.sentAt ?? '',\n        };\n      });\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/worktreeOperations/index.d.cts

@@ -0,0 +1,39 @@
+import { WorktreeMessage } from "../worktreeEvents/index.cjs";
+import { WorktreeRecord } from "../../types/worktreeRegistry.cjs";
+import { planPrune } from "../worktreeNaming/index.cjs";
+import "@agimon-ai/doompi-core/hub-channel";
+import "@agimon-ai/doompi-session";
+//#region src/services/worktreeOperations/index.d.ts
+export interface WorktreeContext {
+  /** Where the calling session is working, used to find the repository. */
+  cwd: string;
+  /** The calling session, recorded as the new session's parent. */
+  sessionId: string;
+}
+export interface SpawnWorktreeRequest {
+  branch: string;
+  baseRef?: string;
+  name?: string;
+  task?: string;
+}
+export interface SpawnOptions {
+  /** Aborted when the caller gives up, so a spawn nobody is waiting for stops. */
+  signal?: AbortSignal;
+  /** Phase labels, for a caller that can show them while the work runs. */
+  onProgress?: (label: string) => void;
+}
+export interface WorktreeOperations {
+  spawn(context: WorktreeContext, request: SpawnWorktreeRequest, options?: SpawnOptions): Promise<WorktreeRecord>;
+  close(context: WorktreeContext, id: string, force: boolean): Promise<WorktreeRecord>;
+  list(context: WorktreeContext): Promise<WorktreeRecord[]>;
+  status(context: WorktreeContext, id: string): Promise<{
+    record: WorktreeRecord;
+    dirtyFiles: string[];
+  }>;
+  merge(context: WorktreeContext, id: string, message?: string): Promise<WorktreeRecord>;
+  prune(context: WorktreeContext, dryRun: boolean): Promise<ReturnType<typeof planPrune>>;
+  send(context: WorktreeContext, id: string, message: string): Promise<void>;
+  messages(context: WorktreeContext, id: string): Promise<WorktreeMessage[]>;
+}
+//#endregion
+//# sourceMappingURL=index.d.cts.map

package/dist/src/services/worktreeOperations/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../../src/services/worktreeOperations/index.ts"],"mappings":";;;;;;iBAmBiB;;EAEf;;EAEA;;iBAGe;EACf;EACA;EACA;EACA;;iBAGe;;EAEf,SAAS;;EAET,cAAc;;iBAGC;EACf,MAAM,SAAS,iBAAiB,SAAS,sBAAsB,UAAU,eAAe,QAAQ;EAChG,MAAM,SAAS,iBAAiB,YAAY,iBAAiB,QAAQ;EACrE,KAAK,SAAS,kBAAkB,QAAQ;EACxC,OAAO,SAAS,iBAAiB,aAAa;IAAU,QAAQ;IAAgB;;EAChF,MAAM,SAAS,iBAAiB,YAAY,mBAAmB,QAAQ;EACvE,MAAM,SAAS,iBAAiB,kBAAkB,QAAQ,kBAAkB;EAC5E,KAAK,SAAS,iBAAiB,YAAY,kBAAkB;EAC7D,SAAS,SAAS,iBAAiB,aAAa,QAA9B"}

package/dist/src/services/worktreeOperations/index.d.mts

@@ -0,0 +1,39 @@
+import { WorktreeMessage } from "../worktreeEvents/index.mjs";
+import { WorktreeRecord } from "../../types/worktreeRegistry.mjs";
+import { planPrune } from "../worktreeNaming/index.mjs";
+import "@agimon-ai/doompi-session";
+import "@agimon-ai/doompi-core/hub-channel";
+//#region src/services/worktreeOperations/index.d.ts
+export interface WorktreeContext {
+  /** Where the calling session is working, used to find the repository. */
+  cwd: string;
+  /** The calling session, recorded as the new session's parent. */
+  sessionId: string;
+}
+export interface SpawnWorktreeRequest {
+  branch: string;
+  baseRef?: string;
+  name?: string;
+  task?: string;
+}
+export interface SpawnOptions {
+  /** Aborted when the caller gives up, so a spawn nobody is waiting for stops. */
+  signal?: AbortSignal;
+  /** Phase labels, for a caller that can show them while the work runs. */
+  onProgress?: (label: string) => void;
+}
+export interface WorktreeOperations {
+  spawn(context: WorktreeContext, request: SpawnWorktreeRequest, options?: SpawnOptions): Promise<WorktreeRecord>;
+  close(context: WorktreeContext, id: string, force: boolean): Promise<WorktreeRecord>;
+  list(context: WorktreeContext): Promise<WorktreeRecord[]>;
+  status(context: WorktreeContext, id: string): Promise<{
+    record: WorktreeRecord;
+    dirtyFiles: string[];
+  }>;
+  merge(context: WorktreeContext, id: string, message?: string): Promise<WorktreeRecord>;
+  prune(context: WorktreeContext, dryRun: boolean): Promise<ReturnType<typeof planPrune>>;
+  send(context: WorktreeContext, id: string, message: string): Promise<void>;
+  messages(context: WorktreeContext, id: string): Promise<WorktreeMessage[]>;
+}
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/src/services/worktreeOperations/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/worktreeOperations/index.ts"],"mappings":";;;;;;iBAmBiB;;EAEf;;EAEA;;iBAGe;EACf;EACA;EACA;EACA;;iBAGe;;EAEf,SAAS;;EAET,cAAc;;iBAGC;EACf,MAAM,SAAS,iBAAiB,SAAS,sBAAsB,UAAU,eAAe,QAAQ;EAChG,MAAM,SAAS,iBAAiB,YAAY,iBAAiB,QAAQ;EACrE,KAAK,SAAS,kBAAkB,QAAQ;EACxC,OAAO,SAAS,iBAAiB,aAAa;IAAU,QAAQ;IAAgB;;EAChF,MAAM,SAAS,iBAAiB,YAAY,mBAAmB,QAAQ;EACvE,MAAM,SAAS,iBAAiB,kBAAkB,QAAQ,kBAAkB;EAC5E,KAAK,SAAS,iBAAiB,YAAY,kBAAkB;EAC7D,SAAS,SAAS,iBAAiB,aAAa,QAA9B"}

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

@@ -0,0 +1,322 @@
+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
+const GIT_WORKTREE_DELEGATION_KIND = "git.worktree.delegation";
+const GIT_WORKTREE_MESSAGE_KIND = "git.worktree.message";
+const GIT_WORKTREE_REPORT_KIND = "git.worktree.report";
+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 readSessionDelivery = () => deps.sessionDelivery?.();
+	const requireSessionDelivery = () => {
+		const delivery = readSessionDelivery();
+		if (delivery === void 0) throw new HubUnavailableError("The Session delivery service is unavailable. Start the cockpit and try again.");
+		return delivery;
+	};
+	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 taskDelivery = request.task === void 0 ? void 0 : requireSessionDelivery();
+			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.");
+			}
+			if (request.task !== void 0 && taskDelivery !== void 0) try {
+				const receipt = await taskDelivery.deliver({
+					recipientKey: sessionId,
+					kind: GIT_WORKTREE_DELEGATION_KIND,
+					prompt: request.task,
+					metadata: {
+						worktreeId: record.id,
+						fromRole: "parent",
+						text: request.task,
+						sentAt: record.createdAt
+					}
+				});
+				const admission = await taskDelivery.waitForAdmission(receipt.deliveryId);
+				if (admission !== "admitted") throw new Error(admission === "recovery_required" ? "The recipient could not admit the task." : "The recipient did not confirm task admission before the timeout.");
+			} catch (error) {
+				throw new DoomGitExpectedError("task_delivery_failed", `Worktree ${record.id} was created, but its task admission was not confirmed (${error.message}).`, true, `Use send with worktree ${record.id} to deliver the task without recreating the worktree.`);
+			}
+			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);
+			const sentAt = (/* @__PURE__ */ new Date()).toISOString();
+			const delivery = readSessionDelivery();
+			if (delivery !== void 0) {
+				const kind = peer.party === "parent" ? GIT_WORKTREE_MESSAGE_KIND : GIT_WORKTREE_REPORT_KIND;
+				const receipt = await delivery.deliver({
+					recipientKey: peer.sessionId,
+					kind,
+					prompt: peer.party === "parent" ? `Parent message for worktree ${record.id}:\n\n${message}` : `Report from worktree ${record.id}:\n\n${message}`,
+					metadata: {
+						worktreeId: record.id,
+						fromRole: peer.party,
+						text: message,
+						sentAt
+					}
+				});
+				const admission = await delivery.waitForAdmission(receipt.deliveryId);
+				if (admission !== "admitted") throw new DoomGitExpectedError("message_delivery_failed", `Worktree ${record.id} persisted the message, but its session did not confirm admission.`, true, admission === "recovery_required" ? "Call messages from the recipient session to recover the persisted text." : "The message remains durable; retry after the recipient is ready.");
+				return;
+			}
+			requireMessageInbox().send(peer.sessionId, {
+				version: 1,
+				worktreeId: record.id,
+				fromSessionId: context.sessionId,
+				from: peer.party,
+				text: message,
+				sentAt
+			});
+		},
+		async messages(context, id) {
+			const { records } = await resolve(context);
+			const record = require(records, id);
+			const peer = peerFor(context, record);
+			const delivery = readSessionDelivery();
+			if (delivery === void 0) return requireMessageInbox().receive(record.id);
+			return delivery.inbox({
+				consumed: false,
+				metadata: { worktreeId: record.id }
+			}).filter((entry) => entry.senderKey === peer.sessionId && (entry.state === "admitted" || entry.state === "recovery_required") && (peer.party === "parent" ? entry.kind === GIT_WORKTREE_REPORT_KIND : entry.kind === GIT_WORKTREE_MESSAGE_KIND || entry.kind === GIT_WORKTREE_DELEGATION_KIND)).map((entry) => {
+				delivery.consume(entry.deliveryId);
+				return {
+					version: 1,
+					worktreeId: record.id,
+					fromSessionId: entry.senderKey,
+					from: peer.party === "parent" ? "child" : "parent",
+					text: entry.state === "recovery_required" ? `[Recovery required: prompt admission was not confirmed] ${entry.metadata.text ?? entry.prompt}` : entry.metadata.text ?? entry.prompt,
+					sentAt: entry.metadata.sentAt ?? ""
+				};
+			});
+		},
+		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';\nimport type { DoomSessionDeliveryService } from '@agimon-ai/doompi-session';\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\nconst GIT_WORKTREE_DELEGATION_KIND = 'git.worktree.delegation';\nconst GIT_WORKTREE_MESSAGE_KIND = 'git.worktree.message';\nconst GIT_WORKTREE_REPORT_KIND = 'git.worktree.report';\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  task?: 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  /** Legacy in-memory fallback used outside the fixed Session composition. */\n  messageInbox?: WorktreeMessageInbox;\n  /** Reads the active Session provider when an operation executes. */\n  sessionDelivery?: () => DoomSessionDeliveryService | undefined;\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 readSessionDelivery = (): DoomSessionDeliveryService | undefined => deps.sessionDelivery?.();\n  const requireSessionDelivery = (): DoomSessionDeliveryService => {\n    const delivery = readSessionDelivery();\n    if (delivery === undefined)\n      throw new HubUnavailableError('The Session delivery service is unavailable. Start the cockpit and try again.');\n    return delivery;\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 taskDelivery = request.task === undefined ? undefined : requireSessionDelivery();\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      if (request.task !== undefined && taskDelivery !== undefined) {\n        try {\n          const receipt = await taskDelivery.deliver({\n            recipientKey: sessionId,\n            kind: GIT_WORKTREE_DELEGATION_KIND,\n            prompt: request.task,\n            metadata: {\n              worktreeId: record.id,\n              fromRole: 'parent',\n              text: request.task,\n              sentAt: record.createdAt,\n            },\n          });\n          const admission = await taskDelivery.waitForAdmission(receipt.deliveryId);\n          if (admission !== 'admitted') {\n            throw new Error(\n              admission === 'recovery_required'\n                ? 'The recipient could not admit the task.'\n                : 'The recipient did not confirm task admission before the timeout.',\n            );\n          }\n        } catch (error) {\n          throw new DoomGitExpectedError(\n            'task_delivery_failed',\n            `Worktree ${record.id} was created, but its task admission was not confirmed (${(error as Error).message}).`,\n            true,\n            `Use send with worktree ${record.id} to deliver the task without recreating the worktree.`,\n          );\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      const sentAt = new Date().toISOString();\n      const delivery = readSessionDelivery();\n      if (delivery !== undefined) {\n        const kind = peer.party === 'parent' ? GIT_WORKTREE_MESSAGE_KIND : GIT_WORKTREE_REPORT_KIND;\n        const receipt = await delivery.deliver({\n          recipientKey: peer.sessionId,\n          kind,\n          prompt:\n            peer.party === 'parent'\n              ? `Parent message for worktree ${record.id}:\\n\\n${message}`\n              : `Report from worktree ${record.id}:\\n\\n${message}`,\n          metadata: { worktreeId: record.id, fromRole: peer.party, text: message, sentAt },\n        });\n        const admission = await delivery.waitForAdmission(receipt.deliveryId);\n        if (admission !== 'admitted') {\n          throw new DoomGitExpectedError(\n            'message_delivery_failed',\n            `Worktree ${record.id} persisted the message, but its session did not confirm admission.`,\n            true,\n            admission === 'recovery_required'\n              ? 'Call messages from the recipient session to recover the persisted text.'\n              : 'The message remains durable; retry after the recipient is ready.',\n          );\n        }\n        return;\n      }\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,\n      });\n    },\n\n    async messages(context, id) {\n      const { records } = await resolve(context);\n      const record = require(records, id);\n      const peer = peerFor(context, record);\n      const delivery = readSessionDelivery();\n      if (delivery === undefined) return requireMessageInbox().receive(record.id);\n      const entries = delivery\n        .inbox({ consumed: false, metadata: { worktreeId: record.id } })\n        .filter(\n          (entry) =>\n            entry.senderKey === peer.sessionId &&\n            (entry.state === 'admitted' || entry.state === 'recovery_required') &&\n            (peer.party === 'parent'\n              ? entry.kind === GIT_WORKTREE_REPORT_KIND\n              : entry.kind === GIT_WORKTREE_MESSAGE_KIND || entry.kind === GIT_WORKTREE_DELEGATION_KIND),\n        );\n      return entries.map((entry) => {\n        delivery.consume(entry.deliveryId);\n        return {\n          version: 1,\n          worktreeId: record.id,\n          fromSessionId: entry.senderKey,\n          from: peer.party === 'parent' ? ('child' as const) : ('parent' as const),\n          text:\n            entry.state === 'recovery_required'\n              ? `[Recovery required: prompt admission was not confirmed] ${entry.metadata.text ?? entry.prompt}`\n              : (entry.metadata.text ?? entry.prompt),\n          sentAt: entry.metadata.sentAt ?? '',\n        };\n      });\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"}