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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["WORKTREE_ACTIONS","invalidRequest","WORKTREE_ACTION_FIELDS"],"sources":["../../../../src/services/runWorktree/index.ts"],"sourcesContent":["import {\n  RunWorktreeParams,\n  WORKTREE_ACTION_FIELDS,\n  WORKTREE_ACTIONS,\n  type WorktreeAction,\n  type RunWorktreeToolParams,\n} from '../../schemas/runWorktreeTool';\nimport type { WorktreeRecord } from '../../types/worktreeRegistry';\nimport { invalidRequest } from '../errors';\nimport type { WorktreeOperations } from '../worktreeOperations';\n\nexport { RunWorktreeParams };\nexport type { RunWorktreeToolParams, WorktreeAction };\n\nexport const RUN_WORKTREE_TOOL_NAME = 'run_worktree';\n\nconst IMPLEMENTED_ACTIONS: ReadonlySet<string> = new Set(Object.values(WORKTREE_ACTIONS));\n\nexport const RUN_WORKTREE_DESCRIPTION = `Create and manage git worktrees, each with its own DoomPi session nested under this one.\n\nActions:\n- spawn_worktree: create a worktree on a new branch and start a session in it. Requires 'branch'. Optional 'baseRef' (defaults to the current branch), 'name' for the rail, 'task' as the first message.\n- close_worktree: stop a worktree's session and delete its directory. Requires 'id'. Refuses a dirty tree unless 'force' is true.\n- list: every worktree for this repository, with status.\n- status: one worktree and its uncommitted files. Requires 'id'.\n- merge: merge a worktree's branch into this checkout. Requires 'id'. Refuses when this checkout is dirty.\n- prune: remove orphaned worktrees. Pass 'dryRun' to see the plan without destroying anything.\n- send: send a message to the other side of a worktree. Requires 'id' and 'message'.\n- messages: read messages waiting for you from a worktree. Requires 'id'.\n\nWorktrees live outside the repository, under ~/.pi/.doom/git/worktrees.`;\n\nexport interface RunWorktreeToolDetails {\n  action: WorktreeAction;\n  records?: WorktreeRecord[];\n}\n\nexport interface RunWorktreeToolResult {\n  content: [{ type: 'text'; text: string }];\n  details: RunWorktreeToolDetails;\n}\n\nexport interface RunWorktreeExecutionContext {\n  readonly cwd: string;\n  readonly sessionId: string;\n}\n\nexport interface RunWorktreeExecutionOptions {\n  readonly signal?: AbortSignal;\n  readonly onProgress?: (label: string) => void;\n}\n\n/** Rejects calls that do not match one documented action shape. */\nexport function validateParams(input: unknown): RunWorktreeToolParams {\n  if (typeof input !== 'object' || input === null || Array.isArray(input)) {\n    throw invalidRequest('run_worktree parameters must be an object.', 'Call it with one documented action shape.');\n  }\n  const record = input as Record<string, unknown>;\n  const action = record.action;\n  if (typeof action !== 'string' || !IMPLEMENTED_ACTIONS.has(action)) {\n    throw invalidRequest(\n      `Unknown action ${typeof action === 'string' ? `'${action}'` : 'value'}.`,\n      `Use one of: ${[...IMPLEMENTED_ACTIONS].join(', ')}.`,\n    );\n  }\n  const allowed = WORKTREE_ACTION_FIELDS[action as WorktreeAction];\n  const unexpected = Object.keys(record).filter((key) => !allowed.includes(key));\n  if (unexpected.length > 0) {\n    throw invalidRequest(\n      `action='${action}' does not accept: ${unexpected.join(', ')}.`,\n      `Fields for '${action}': ${allowed.join(', ')}.`,\n    );\n  }\n  for (const field of ['branch', 'id'] as const) {\n    if (allowed.includes(field) && field in record) {\n      const value = record[field];\n      if (typeof value !== 'string' || value.trim() === '') {\n        throw invalidRequest(`action='${action}' requires a nonblank '${field}'.`, `Pass a ${field}.`);\n      }\n    }\n  }\n  const stringFields = ['baseRef', 'name', 'task', 'message'] as const;\n  for (const field of stringFields) {\n    if (field in record && (typeof record[field] !== 'string' || record[field].trim() === '')) {\n      throw invalidRequest(`action='${action}' requires a nonblank '${field}'.`, `Pass a ${field}.`);\n    }\n  }\n  for (const field of ['force', 'dryRun'] as const) {\n    if (field in record && typeof record[field] !== 'boolean') {\n      throw invalidRequest(`action='${action}' requires boolean '${field}'.`, `Pass true or false for ${field}.`);\n    }\n  }\n  if (action === WORKTREE_ACTIONS.send && typeof record.message !== 'string') {\n    throw invalidRequest(\"action='send' requires 'message'.\", 'Pass the message to send.');\n  }\n  if (action === WORKTREE_ACTIONS.spawn_worktree && typeof record.branch !== 'string') {\n    throw invalidRequest(\"action='spawn_worktree' requires 'branch'.\", 'Name the branch to create.');\n  }\n  if (\n    (action === WORKTREE_ACTIONS.close_worktree ||\n      action === WORKTREE_ACTIONS.status ||\n      action === WORKTREE_ACTIONS.merge ||\n      action === WORKTREE_ACTIONS.send ||\n      action === WORKTREE_ACTIONS.messages) &&\n    typeof record.id !== 'string'\n  ) {\n    throw invalidRequest(`action='${action}' requires 'id'.`, 'Call list to see the current ids.');\n  }\n  return record as RunWorktreeToolParams;\n}\n\nfunction describe(record: WorktreeRecord): string {\n  return `${record.id}  ${record.branch}  ${record.status}  ${record.path}`;\n}\n\nfunction text(...lines: readonly string[]): [{ type: 'text'; text: string }] {\n  return [{ type: 'text', text: lines.join('\\n') }];\n}\n\nexport async function executeRunWorktreeTool(\n  params: RunWorktreeToolParams,\n  operations: WorktreeOperations,\n  context: RunWorktreeExecutionContext,\n  options: RunWorktreeExecutionOptions = {},\n): Promise<RunWorktreeToolResult> {\n  switch (params.action) {\n    case WORKTREE_ACTIONS.spawn_worktree: {\n      const record = await operations.spawn(\n        context,\n        {\n          branch: params.branch,\n          ...(params.baseRef === undefined ? {} : { baseRef: params.baseRef }),\n          ...(params.name === undefined ? {} : { name: params.name }),\n        },\n        options,\n      );\n      return {\n        content: text(\n          `Worktree ${record.id} created on ${record.branch} from ${record.baseRef}.`,\n          `Path: ${record.path}`,\n          `Session ${record.sessionId} is starting; it appears nested under this one in the rail.`,\n        ),\n        details: { action: params.action, records: [record] },\n      };\n    }\n    case WORKTREE_ACTIONS.close_worktree: {\n      const record = await operations.close(context, params.id, params.force ?? false);\n      return {\n        content: text(`Worktree ${record.id} (${record.branch}) closed and removed.`),\n        details: { action: params.action, records: [record] },\n      };\n    }\n    case WORKTREE_ACTIONS.list: {\n      const records = await operations.list(context);\n      return {\n        content:\n          records.length === 0\n            ? text('No worktrees for this repository.')\n            : text(`${String(records.length)} worktree(s):`, ...records.map(describe)),\n        details: { action: params.action, records },\n      };\n    }\n    case WORKTREE_ACTIONS.status: {\n      const { record, dirtyFiles } = await operations.status(context, params.id);\n      return {\n        content: text(\n          describe(record),\n          `Session: ${record.sessionId}`,\n          dirtyFiles.length === 0\n            ? 'Clean.'\n            : `${String(dirtyFiles.length)} uncommitted file(s): ${dirtyFiles.slice(0, 20).join(', ')}`,\n        ),\n        details: { action: params.action, records: [record] },\n      };\n    }\n    case WORKTREE_ACTIONS.merge: {\n      const record = await operations.merge(\n        context,\n        params.id,\n        ...(params.message === undefined ? [] : ([params.message] as const)),\n      );\n      return {\n        content: text(`Merged ${record.branch} into this checkout.`),\n        details: { action: params.action, records: [record] },\n      };\n    }\n    case WORKTREE_ACTIONS.send: {\n      await operations.send(context, params.id, params.message);\n      return { content: text(`Message sent to worktree ${params.id}.`), details: { action: params.action } };\n    }\n    case WORKTREE_ACTIONS.messages: {\n      const waiting = await operations.messages(context, params.id);\n      return {\n        content:\n          waiting.length === 0\n            ? text('No messages.')\n            : text(\n                `${String(waiting.length)} message(s):`,\n                ...waiting.map((entry) => `[${entry.sentAt}] ${entry.from}: ${entry.text}`),\n              ),\n        details: { action: params.action },\n      };\n    }\n    case WORKTREE_ACTIONS.prune: {\n      const dryRun = params.dryRun ?? false;\n      const plan = await operations.prune(context, dryRun);\n      const lines = [\n        dryRun ? 'Prune plan (nothing was changed):' : 'Pruned:',\n        `Remove: ${plan.remove.length === 0 ? 'none' : plan.remove.map((record) => record.id).join(', ')}`,\n        `Forget: ${plan.forget.length === 0 ? 'none' : plan.forget.map((record) => record.id).join(', ')}`,\n        `Kept, uncommitted work: ${plan.keptDirty.length === 0 ? 'none' : plan.keptDirty.map((record) => record.id).join(', ')}`,\n        `Untracked directories, left alone: ${plan.untracked.length === 0 ? 'none' : plan.untracked.join(', ')}`,\n        ...(plan.keptBranches.length === 0\n          ? []\n          : [`Branches kept, they hold commits: ${plan.keptBranches.join(', ')}`]),\n      ];\n      return { content: text(...lines), details: { action: params.action } };\n    }\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,142 @@
+import { invalidRequest } from "../errors/index.mjs";
+import { WORKTREE_ACTIONS, WORKTREE_ACTION_FIELDS } from "../../schemas/runWorktreeTool.mjs";
+//#region src/services/runWorktree/index.ts
+const RUN_WORKTREE_TOOL_NAME = "run_worktree";
+const IMPLEMENTED_ACTIONS = new Set(Object.values(WORKTREE_ACTIONS));
+const RUN_WORKTREE_DESCRIPTION = `Create and manage git worktrees, each with its own DoomPi session nested under this one.
+
+Actions:
+- spawn_worktree: create a worktree on a new branch and start a session in it. Requires 'branch'. Optional 'baseRef' (defaults to the current branch), 'name' for the rail, 'task' as the first message.
+- close_worktree: stop a worktree's session and delete its directory. Requires 'id'. Refuses a dirty tree unless 'force' is true.
+- list: every worktree for this repository, with status.
+- status: one worktree and its uncommitted files. Requires 'id'.
+- merge: merge a worktree's branch into this checkout. Requires 'id'. Refuses when this checkout is dirty.
+- prune: remove orphaned worktrees. Pass 'dryRun' to see the plan without destroying anything.
+- send: send a message to the other side of a worktree. Requires 'id' and 'message'.
+- messages: read messages waiting for you from a worktree. Requires 'id'.
+
+Worktrees live outside the repository, under ~/.pi/.doom/git/worktrees.`;
+/** Rejects calls that do not match one documented action shape. */
+function validateParams(input) {
+	if (typeof input !== "object" || input === null || Array.isArray(input)) throw invalidRequest("run_worktree parameters must be an object.", "Call it with one documented action shape.");
+	const record = input;
+	const action = record.action;
+	if (typeof action !== "string" || !IMPLEMENTED_ACTIONS.has(action)) throw invalidRequest(`Unknown action ${typeof action === "string" ? `'${action}'` : "value"}.`, `Use one of: ${[...IMPLEMENTED_ACTIONS].join(", ")}.`);
+	const allowed = WORKTREE_ACTION_FIELDS[action];
+	const unexpected = Object.keys(record).filter((key) => !allowed.includes(key));
+	if (unexpected.length > 0) throw invalidRequest(`action='${action}' does not accept: ${unexpected.join(", ")}.`, `Fields for '${action}': ${allowed.join(", ")}.`);
+	for (const field of ["branch", "id"]) if (allowed.includes(field) && field in record) {
+		const value = record[field];
+		if (typeof value !== "string" || value.trim() === "") throw invalidRequest(`action='${action}' requires a nonblank '${field}'.`, `Pass a ${field}.`);
+	}
+	for (const field of [
+		"baseRef",
+		"name",
+		"task",
+		"message"
+	]) if (field in record && (typeof record[field] !== "string" || record[field].trim() === "")) throw invalidRequest(`action='${action}' requires a nonblank '${field}'.`, `Pass a ${field}.`);
+	for (const field of ["force", "dryRun"]) if (field in record && typeof record[field] !== "boolean") throw invalidRequest(`action='${action}' requires boolean '${field}'.`, `Pass true or false for ${field}.`);
+	if (action === WORKTREE_ACTIONS.send && typeof record.message !== "string") throw invalidRequest("action='send' requires 'message'.", "Pass the message to send.");
+	if (action === WORKTREE_ACTIONS.spawn_worktree && typeof record.branch !== "string") throw invalidRequest("action='spawn_worktree' requires 'branch'.", "Name the branch to create.");
+	if ((action === WORKTREE_ACTIONS.close_worktree || action === WORKTREE_ACTIONS.status || action === WORKTREE_ACTIONS.merge || action === WORKTREE_ACTIONS.send || action === WORKTREE_ACTIONS.messages) && typeof record.id !== "string") throw invalidRequest(`action='${action}' requires 'id'.`, "Call list to see the current ids.");
+	return record;
+}
+function describe(record) {
+	return `${record.id}  ${record.branch}  ${record.status}  ${record.path}`;
+}
+function text(...lines) {
+	return [{
+		type: "text",
+		text: lines.join("\n")
+	}];
+}
+async function executeRunWorktreeTool(params, operations, context, options = {}) {
+	switch (params.action) {
+		case WORKTREE_ACTIONS.spawn_worktree: {
+			const record = await operations.spawn(context, {
+				branch: params.branch,
+				...params.baseRef === void 0 ? {} : { baseRef: params.baseRef },
+				...params.name === void 0 ? {} : { name: params.name }
+			}, options);
+			return {
+				content: text(`Worktree ${record.id} created on ${record.branch} from ${record.baseRef}.`, `Path: ${record.path}`, `Session ${record.sessionId} is starting; it appears nested under this one in the rail.`),
+				details: {
+					action: params.action,
+					records: [record]
+				}
+			};
+		}
+		case WORKTREE_ACTIONS.close_worktree: {
+			const record = await operations.close(context, params.id, params.force ?? false);
+			return {
+				content: text(`Worktree ${record.id} (${record.branch}) closed and removed.`),
+				details: {
+					action: params.action,
+					records: [record]
+				}
+			};
+		}
+		case WORKTREE_ACTIONS.list: {
+			const records = await operations.list(context);
+			return {
+				content: records.length === 0 ? text("No worktrees for this repository.") : text(`${String(records.length)} worktree(s):`, ...records.map(describe)),
+				details: {
+					action: params.action,
+					records
+				}
+			};
+		}
+		case WORKTREE_ACTIONS.status: {
+			const { record, dirtyFiles } = await operations.status(context, params.id);
+			return {
+				content: text(describe(record), `Session: ${record.sessionId}`, dirtyFiles.length === 0 ? "Clean." : `${String(dirtyFiles.length)} uncommitted file(s): ${dirtyFiles.slice(0, 20).join(", ")}`),
+				details: {
+					action: params.action,
+					records: [record]
+				}
+			};
+		}
+		case WORKTREE_ACTIONS.merge: {
+			const record = await operations.merge(context, params.id, ...params.message === void 0 ? [] : [params.message]);
+			return {
+				content: text(`Merged ${record.branch} into this checkout.`),
+				details: {
+					action: params.action,
+					records: [record]
+				}
+			};
+		}
+		case WORKTREE_ACTIONS.send:
+			await operations.send(context, params.id, params.message);
+			return {
+				content: text(`Message sent to worktree ${params.id}.`),
+				details: { action: params.action }
+			};
+		case WORKTREE_ACTIONS.messages: {
+			const waiting = await operations.messages(context, params.id);
+			return {
+				content: waiting.length === 0 ? text("No messages.") : text(`${String(waiting.length)} message(s):`, ...waiting.map((entry) => `[${entry.sentAt}] ${entry.from}: ${entry.text}`)),
+				details: { action: params.action }
+			};
+		}
+		case WORKTREE_ACTIONS.prune: {
+			const dryRun = params.dryRun ?? false;
+			const plan = await operations.prune(context, dryRun);
+			return {
+				content: text(...[
+					dryRun ? "Prune plan (nothing was changed):" : "Pruned:",
+					`Remove: ${plan.remove.length === 0 ? "none" : plan.remove.map((record) => record.id).join(", ")}`,
+					`Forget: ${plan.forget.length === 0 ? "none" : plan.forget.map((record) => record.id).join(", ")}`,
+					`Kept, uncommitted work: ${plan.keptDirty.length === 0 ? "none" : plan.keptDirty.map((record) => record.id).join(", ")}`,
+					`Untracked directories, left alone: ${plan.untracked.length === 0 ? "none" : plan.untracked.join(", ")}`,
+					...plan.keptBranches.length === 0 ? [] : [`Branches kept, they hold commits: ${plan.keptBranches.join(", ")}`]
+				]),
+				details: { action: params.action }
+			};
+		}
+	}
+}
+//#endregion
+export { RUN_WORKTREE_DESCRIPTION, RUN_WORKTREE_TOOL_NAME, executeRunWorktreeTool, validateParams };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/runWorktree/index.ts"],"sourcesContent":["import {\n  RunWorktreeParams,\n  WORKTREE_ACTION_FIELDS,\n  WORKTREE_ACTIONS,\n  type WorktreeAction,\n  type RunWorktreeToolParams,\n} from '../../schemas/runWorktreeTool';\nimport type { WorktreeRecord } from '../../types/worktreeRegistry';\nimport { invalidRequest } from '../errors';\nimport type { WorktreeOperations } from '../worktreeOperations';\n\nexport { RunWorktreeParams };\nexport type { RunWorktreeToolParams, WorktreeAction };\n\nexport const RUN_WORKTREE_TOOL_NAME = 'run_worktree';\n\nconst IMPLEMENTED_ACTIONS: ReadonlySet<string> = new Set(Object.values(WORKTREE_ACTIONS));\n\nexport const RUN_WORKTREE_DESCRIPTION = `Create and manage git worktrees, each with its own DoomPi session nested under this one.\n\nActions:\n- spawn_worktree: create a worktree on a new branch and start a session in it. Requires 'branch'. Optional 'baseRef' (defaults to the current branch), 'name' for the rail, 'task' as the first message.\n- close_worktree: stop a worktree's session and delete its directory. Requires 'id'. Refuses a dirty tree unless 'force' is true.\n- list: every worktree for this repository, with status.\n- status: one worktree and its uncommitted files. Requires 'id'.\n- merge: merge a worktree's branch into this checkout. Requires 'id'. Refuses when this checkout is dirty.\n- prune: remove orphaned worktrees. Pass 'dryRun' to see the plan without destroying anything.\n- send: send a message to the other side of a worktree. Requires 'id' and 'message'.\n- messages: read messages waiting for you from a worktree. Requires 'id'.\n\nWorktrees live outside the repository, under ~/.pi/.doom/git/worktrees.`;\n\nexport interface RunWorktreeToolDetails {\n  action: WorktreeAction;\n  records?: WorktreeRecord[];\n}\n\nexport interface RunWorktreeToolResult {\n  content: [{ type: 'text'; text: string }];\n  details: RunWorktreeToolDetails;\n}\n\nexport interface RunWorktreeExecutionContext {\n  readonly cwd: string;\n  readonly sessionId: string;\n}\n\nexport interface RunWorktreeExecutionOptions {\n  readonly signal?: AbortSignal;\n  readonly onProgress?: (label: string) => void;\n}\n\n/** Rejects calls that do not match one documented action shape. */\nexport function validateParams(input: unknown): RunWorktreeToolParams {\n  if (typeof input !== 'object' || input === null || Array.isArray(input)) {\n    throw invalidRequest('run_worktree parameters must be an object.', 'Call it with one documented action shape.');\n  }\n  const record = input as Record<string, unknown>;\n  const action = record.action;\n  if (typeof action !== 'string' || !IMPLEMENTED_ACTIONS.has(action)) {\n    throw invalidRequest(\n      `Unknown action ${typeof action === 'string' ? `'${action}'` : 'value'}.`,\n      `Use one of: ${[...IMPLEMENTED_ACTIONS].join(', ')}.`,\n    );\n  }\n  const allowed = WORKTREE_ACTION_FIELDS[action as WorktreeAction];\n  const unexpected = Object.keys(record).filter((key) => !allowed.includes(key));\n  if (unexpected.length > 0) {\n    throw invalidRequest(\n      `action='${action}' does not accept: ${unexpected.join(', ')}.`,\n      `Fields for '${action}': ${allowed.join(', ')}.`,\n    );\n  }\n  for (const field of ['branch', 'id'] as const) {\n    if (allowed.includes(field) && field in record) {\n      const value = record[field];\n      if (typeof value !== 'string' || value.trim() === '') {\n        throw invalidRequest(`action='${action}' requires a nonblank '${field}'.`, `Pass a ${field}.`);\n      }\n    }\n  }\n  const stringFields = ['baseRef', 'name', 'task', 'message'] as const;\n  for (const field of stringFields) {\n    if (field in record && (typeof record[field] !== 'string' || record[field].trim() === '')) {\n      throw invalidRequest(`action='${action}' requires a nonblank '${field}'.`, `Pass a ${field}.`);\n    }\n  }\n  for (const field of ['force', 'dryRun'] as const) {\n    if (field in record && typeof record[field] !== 'boolean') {\n      throw invalidRequest(`action='${action}' requires boolean '${field}'.`, `Pass true or false for ${field}.`);\n    }\n  }\n  if (action === WORKTREE_ACTIONS.send && typeof record.message !== 'string') {\n    throw invalidRequest(\"action='send' requires 'message'.\", 'Pass the message to send.');\n  }\n  if (action === WORKTREE_ACTIONS.spawn_worktree && typeof record.branch !== 'string') {\n    throw invalidRequest(\"action='spawn_worktree' requires 'branch'.\", 'Name the branch to create.');\n  }\n  if (\n    (action === WORKTREE_ACTIONS.close_worktree ||\n      action === WORKTREE_ACTIONS.status ||\n      action === WORKTREE_ACTIONS.merge ||\n      action === WORKTREE_ACTIONS.send ||\n      action === WORKTREE_ACTIONS.messages) &&\n    typeof record.id !== 'string'\n  ) {\n    throw invalidRequest(`action='${action}' requires 'id'.`, 'Call list to see the current ids.');\n  }\n  return record as RunWorktreeToolParams;\n}\n\nfunction describe(record: WorktreeRecord): string {\n  return `${record.id}  ${record.branch}  ${record.status}  ${record.path}`;\n}\n\nfunction text(...lines: readonly string[]): [{ type: 'text'; text: string }] {\n  return [{ type: 'text', text: lines.join('\\n') }];\n}\n\nexport async function executeRunWorktreeTool(\n  params: RunWorktreeToolParams,\n  operations: WorktreeOperations,\n  context: RunWorktreeExecutionContext,\n  options: RunWorktreeExecutionOptions = {},\n): Promise<RunWorktreeToolResult> {\n  switch (params.action) {\n    case WORKTREE_ACTIONS.spawn_worktree: {\n      const record = await operations.spawn(\n        context,\n        {\n          branch: params.branch,\n          ...(params.baseRef === undefined ? {} : { baseRef: params.baseRef }),\n          ...(params.name === undefined ? {} : { name: params.name }),\n        },\n        options,\n      );\n      return {\n        content: text(\n          `Worktree ${record.id} created on ${record.branch} from ${record.baseRef}.`,\n          `Path: ${record.path}`,\n          `Session ${record.sessionId} is starting; it appears nested under this one in the rail.`,\n        ),\n        details: { action: params.action, records: [record] },\n      };\n    }\n    case WORKTREE_ACTIONS.close_worktree: {\n      const record = await operations.close(context, params.id, params.force ?? false);\n      return {\n        content: text(`Worktree ${record.id} (${record.branch}) closed and removed.`),\n        details: { action: params.action, records: [record] },\n      };\n    }\n    case WORKTREE_ACTIONS.list: {\n      const records = await operations.list(context);\n      return {\n        content:\n          records.length === 0\n            ? text('No worktrees for this repository.')\n            : text(`${String(records.length)} worktree(s):`, ...records.map(describe)),\n        details: { action: params.action, records },\n      };\n    }\n    case WORKTREE_ACTIONS.status: {\n      const { record, dirtyFiles } = await operations.status(context, params.id);\n      return {\n        content: text(\n          describe(record),\n          `Session: ${record.sessionId}`,\n          dirtyFiles.length === 0\n            ? 'Clean.'\n            : `${String(dirtyFiles.length)} uncommitted file(s): ${dirtyFiles.slice(0, 20).join(', ')}`,\n        ),\n        details: { action: params.action, records: [record] },\n      };\n    }\n    case WORKTREE_ACTIONS.merge: {\n      const record = await operations.merge(\n        context,\n        params.id,\n        ...(params.message === undefined ? [] : ([params.message] as const)),\n      );\n      return {\n        content: text(`Merged ${record.branch} into this checkout.`),\n        details: { action: params.action, records: [record] },\n      };\n    }\n    case WORKTREE_ACTIONS.send: {\n      await operations.send(context, params.id, params.message);\n      return { content: text(`Message sent to worktree ${params.id}.`), details: { action: params.action } };\n    }\n    case WORKTREE_ACTIONS.messages: {\n      const waiting = await operations.messages(context, params.id);\n      return {\n        content:\n          waiting.length === 0\n            ? text('No messages.')\n            : text(\n                `${String(waiting.length)} message(s):`,\n                ...waiting.map((entry) => `[${entry.sentAt}] ${entry.from}: ${entry.text}`),\n              ),\n        details: { action: params.action },\n      };\n    }\n    case WORKTREE_ACTIONS.prune: {\n      const dryRun = params.dryRun ?? false;\n      const plan = await operations.prune(context, dryRun);\n      const lines = [\n        dryRun ? 'Prune plan (nothing was changed):' : 'Pruned:',\n        `Remove: ${plan.remove.length === 0 ? 'none' : plan.remove.map((record) => record.id).join(', ')}`,\n        `Forget: ${plan.forget.length === 0 ? 'none' : plan.forget.map((record) => record.id).join(', ')}`,\n        `Kept, uncommitted work: ${plan.keptDirty.length === 0 ? 'none' : plan.keptDirty.map((record) => record.id).join(', ')}`,\n        `Untracked directories, left alone: ${plan.untracked.length === 0 ? 'none' : plan.untracked.join(', ')}`,\n        ...(plan.keptBranches.length === 0\n          ? []\n          : [`Branches kept, they hold commits: ${plan.keptBranches.join(', ')}`]),\n      ];\n      return { content: text(...lines), details: { action: params.action } };\n    }\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,64 @@
+//#region src/services/worktreeEvents/index.ts
+const GIT_WORKTREE_LIFECYCLE_EVENT = "git_worktree_lifecycle";
+const GIT_WORKTREE_MESSAGE_EVENT = "git_worktree_message";
+const MAX_WORKTREE_MESSAGE_BYTES = 65536;
+function isMessageParty(value) {
+	return value === "parent" || value === "child";
+}
+function parseMessage(value) {
+	if (typeof value !== "object" || value === null) return void 0;
+	const record = value;
+	if (record.version !== 1) return void 0;
+	if (typeof record.worktreeId !== "string" || record.worktreeId === "") return void 0;
+	if (typeof record.fromSessionId !== "string" || record.fromSessionId === "") return void 0;
+	if (!isMessageParty(record.from)) return void 0;
+	if (typeof record.text !== "string" || record.text === "") return void 0;
+	if (Buffer.byteLength(record.text, "utf8") > 65536) return void 0;
+	if (typeof record.sentAt !== "string" || record.sentAt === "") return void 0;
+	return record;
+}
+function createWorktreeMessageInbox(directEvents, sessionId) {
+	if (sessionId === "") throw new Error("The Git message service requires a session identity.");
+	const messages = /* @__PURE__ */ new Map();
+	const unsubscribe = directEvents.subscribe(GIT_WORKTREE_MESSAGE_EVENT, sessionId, (payload) => {
+		const message = parseMessage(payload);
+		if (message === void 0) return;
+		const inbox = messages.get(message.worktreeId) ?? [];
+		if (inbox.length >= 100) inbox.shift();
+		inbox.push(message);
+		messages.set(message.worktreeId, inbox);
+	});
+	let closed = false;
+	return {
+		send(targetSessionId, message) {
+			if (closed) throw new Error("The Git message service is closed.");
+			directEvents.publish(GIT_WORKTREE_MESSAGE_EVENT, targetSessionId, message);
+		},
+		receive(worktreeId) {
+			if (closed) return [];
+			const inbox = messages.get(worktreeId);
+			if (inbox === void 0) return [];
+			messages.delete(worktreeId);
+			return inbox;
+		},
+		close() {
+			if (closed) return;
+			closed = true;
+			unsubscribe();
+			messages.clear();
+		}
+	};
+}
+function isWorktreeLifecycleEvent(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const record = value;
+	return record.version === 1 && typeof record.repositoryRoot === "string" && record.repositoryRoot !== "";
+}
+//#endregion
+exports.GIT_WORKTREE_LIFECYCLE_EVENT = GIT_WORKTREE_LIFECYCLE_EVENT;
+exports.GIT_WORKTREE_MESSAGE_EVENT = GIT_WORKTREE_MESSAGE_EVENT;
+exports.MAX_WORKTREE_MESSAGE_BYTES = MAX_WORKTREE_MESSAGE_BYTES;
+exports.createWorktreeMessageInbox = createWorktreeMessageInbox;
+exports.isWorktreeLifecycleEvent = isWorktreeLifecycleEvent;
+
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/services/worktreeEvents/index.ts"],"sourcesContent":["import type { DoomDirectEventBus } from '@agimon-ai/doompi-core/hub-channel';\n\nexport const GIT_WORKTREE_LIFECYCLE_EVENT = 'git_worktree_lifecycle';\nexport const GIT_WORKTREE_MESSAGE_EVENT = 'git_worktree_message';\nexport const WORKTREE_MESSAGE_VERSION = 1 as const;\nexport const MAX_WORKTREE_MESSAGE_BYTES = 64 * 1024;\nexport const MAX_WORKTREE_INBOX_MESSAGES = 100;\n\nexport interface WorktreeLifecycleEvent {\n  readonly version: typeof WORKTREE_MESSAGE_VERSION;\n  readonly repositoryRoot: string;\n}\n\nexport type WorktreeMessageParty = 'parent' | 'child';\n\nexport interface WorktreeMessage {\n  readonly version: typeof WORKTREE_MESSAGE_VERSION;\n  readonly worktreeId: string;\n  readonly fromSessionId: string;\n  readonly from: WorktreeMessageParty;\n  readonly text: string;\n  readonly sentAt: string;\n}\n\nexport interface WorktreeMessageInbox {\n  send(targetSessionId: string, message: WorktreeMessage): void;\n  receive(worktreeId: string): WorktreeMessage[];\n  close(): void;\n}\n\nfunction isMessageParty(value: unknown): value is WorktreeMessageParty {\n  return value === 'parent' || value === 'child';\n}\n\nfunction parseMessage(value: unknown): WorktreeMessage | undefined {\n  if (typeof value !== 'object' || value === null) return undefined;\n  const record = value as Partial<WorktreeMessage>;\n  if (record.version !== WORKTREE_MESSAGE_VERSION) return undefined;\n  if (typeof record.worktreeId !== 'string' || record.worktreeId === '') return undefined;\n  if (typeof record.fromSessionId !== 'string' || record.fromSessionId === '') return undefined;\n  if (!isMessageParty(record.from)) return undefined;\n  if (typeof record.text !== 'string' || record.text === '') return undefined;\n  if (Buffer.byteLength(record.text, 'utf8') > MAX_WORKTREE_MESSAGE_BYTES) return undefined;\n  if (typeof record.sentAt !== 'string' || record.sentAt === '') return undefined;\n  return record as WorktreeMessage;\n}\n\nexport function createWorktreeMessageInbox(directEvents: DoomDirectEventBus, sessionId: string): WorktreeMessageInbox {\n  if (sessionId === '') throw new Error('The Git message service requires a session identity.');\n  const messages = new Map<string, WorktreeMessage[]>();\n  const unsubscribe = directEvents.subscribe(GIT_WORKTREE_MESSAGE_EVENT, sessionId, (payload) => {\n    const message = parseMessage(payload);\n    if (message === undefined) return;\n    const inbox = messages.get(message.worktreeId) ?? [];\n    if (inbox.length >= MAX_WORKTREE_INBOX_MESSAGES) inbox.shift();\n    inbox.push(message);\n    messages.set(message.worktreeId, inbox);\n  });\n  let closed = false;\n  return {\n    send(targetSessionId, message) {\n      if (closed) throw new Error('The Git message service is closed.');\n      directEvents.publish(GIT_WORKTREE_MESSAGE_EVENT, targetSessionId, message);\n    },\n    receive(worktreeId) {\n      if (closed) return [];\n      const inbox = messages.get(worktreeId);\n      if (inbox === undefined) return [];\n      messages.delete(worktreeId);\n      return inbox;\n    },\n    close() {\n      if (closed) return;\n      closed = true;\n      unsubscribe();\n      messages.clear();\n    },\n  };\n}\n\nexport function isWorktreeLifecycleEvent(value: unknown): value is WorktreeLifecycleEvent {\n  if (typeof value !== 'object' || value === null) return false;\n  const record = value as Partial<WorktreeLifecycleEvent>;\n  return (\n    record.version === WORKTREE_MESSAGE_VERSION &&\n    typeof record.repositoryRoot === 'string' &&\n    record.repositoryRoot !== ''\n  );\n}\n"],"mappings":";AAEA,MAAa,+BAA+B;AAC5C,MAAa,6BAA6B;AAE1C,MAAa,6BAA6B;AAyB1C,SAAS,eAAe,OAA+C;CACrE,OAAO,UAAU,YAAY,UAAU;AACzC;AAEA,SAAS,aAAa,OAA6C;CACjE,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;CACxD,MAAM,SAAS;CACf,IAAI,OAAO,YAAA,GAAsC,OAAO,KAAA;CACxD,IAAI,OAAO,OAAO,eAAe,YAAY,OAAO,eAAe,IAAI,OAAO,KAAA;CAC9E,IAAI,OAAO,OAAO,kBAAkB,YAAY,OAAO,kBAAkB,IAAI,OAAO,KAAA;CACpF,IAAI,CAAC,eAAe,OAAO,IAAI,GAAG,OAAO,KAAA;CACzC,IAAI,OAAO,OAAO,SAAS,YAAY,OAAO,SAAS,IAAI,OAAO,KAAA;CAClE,IAAI,OAAO,WAAW,OAAO,MAAM,MAAM,IAAA,OAAgC,OAAO,KAAA;CAChF,IAAI,OAAO,OAAO,WAAW,YAAY,OAAO,WAAW,IAAI,OAAO,KAAA;CACtE,OAAO;AACT;AAEA,SAAgB,2BAA2B,cAAkC,WAAyC;CACpH,IAAI,cAAc,IAAI,MAAM,IAAI,MAAM,sDAAsD;CAC5F,MAAM,2BAAW,IAAI,IAA+B;CACpD,MAAM,cAAc,aAAa,UAAU,4BAA4B,YAAY,YAAY;EAC7F,MAAM,UAAU,aAAa,OAAO;EACpC,IAAI,YAAY,KAAA,GAAW;EAC3B,MAAM,QAAQ,SAAS,IAAI,QAAQ,UAAU,KAAK,CAAC;EACnD,IAAI,MAAM,UAAA,KAAuC,MAAM,MAAM;EAC7D,MAAM,KAAK,OAAO;EAClB,SAAS,IAAI,QAAQ,YAAY,KAAK;CACxC,CAAC;CACD,IAAI,SAAS;CACb,OAAO;EACL,KAAK,iBAAiB,SAAS;GAC7B,IAAI,QAAQ,MAAM,IAAI,MAAM,oCAAoC;GAChE,aAAa,QAAQ,4BAA4B,iBAAiB,OAAO;EAC3E;EACA,QAAQ,YAAY;GAClB,IAAI,QAAQ,OAAO,CAAC;GACpB,MAAM,QAAQ,SAAS,IAAI,UAAU;GACrC,IAAI,UAAU,KAAA,GAAW,OAAO,CAAC;GACjC,SAAS,OAAO,UAAU;GAC1B,OAAO;EACT;EACA,QAAQ;GACN,IAAI,QAAQ;GACZ,SAAS;GACT,YAAY;GACZ,SAAS,MAAM;EACjB;CACF;AACF;AAEA,SAAgB,yBAAyB,OAAiD;CACxF,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,SAAS;CACf,OACE,OAAO,YAAA,KACP,OAAO,OAAO,mBAAmB,YACjC,OAAO,mBAAmB;AAE9B"}

package/dist/{services → src/services}/worktreeEvents/index.d.cts

@@ -1,8 +1,8 @@
 import "@agimon-ai/doompi-core/hub-channel";
 //#region src/services/worktreeEvents/index.d.ts
-declare const WORKTREE_MESSAGE_VERSION: 1;
-type WorktreeMessageParty = 'parent' | 'child';
-interface WorktreeMessage {
+export declare const WORKTREE_MESSAGE_VERSION: 1;
+export type WorktreeMessageParty = 'parent' | 'child';
+export interface WorktreeMessage {
   readonly version: typeof WORKTREE_MESSAGE_VERSION;
   readonly worktreeId: string;
   readonly fromSessionId: string;
@@ -11,5 +11,4 @@ interface WorktreeMessage {
   readonly sentAt: string;
 }
 //#endregion
-export { WORKTREE_MESSAGE_VERSION, WorktreeMessage, WorktreeMessageParty };
 //# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../../src/services/worktreeEvents/index.ts"],"mappings":";;qBAIa;YASD;iBAEK;WACN,gBAAgB;WAChB;WACA;WACA,MAAM;WACN;WACA"}

package/dist/{services → src/services}/worktreeEvents/index.d.mts

@@ -1,8 +1,8 @@
 import "@agimon-ai/doompi-core/hub-channel";
 //#region src/services/worktreeEvents/index.d.ts
-declare const WORKTREE_MESSAGE_VERSION: 1;
-type WorktreeMessageParty = 'parent' | 'child';
-interface WorktreeMessage {
+export declare const WORKTREE_MESSAGE_VERSION: 1;
+export type WorktreeMessageParty = 'parent' | 'child';
+export interface WorktreeMessage {
   readonly version: typeof WORKTREE_MESSAGE_VERSION;
   readonly worktreeId: string;
   readonly fromSessionId: string;
@@ -11,5 +11,4 @@ interface WorktreeMessage {
   readonly sentAt: string;
 }
 //#endregion
-export { WORKTREE_MESSAGE_VERSION, WorktreeMessage, WorktreeMessageParty };
 //# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/worktreeEvents/index.ts"],"mappings":";;qBAIa;YASD;iBAEK;WACN,gBAAgB;WAChB;WACA;WACA,MAAM;WACN;WACA"}

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

@@ -0,0 +1,60 @@
+//#region src/services/worktreeEvents/index.ts
+const GIT_WORKTREE_LIFECYCLE_EVENT = "git_worktree_lifecycle";
+const GIT_WORKTREE_MESSAGE_EVENT = "git_worktree_message";
+const MAX_WORKTREE_MESSAGE_BYTES = 65536;
+function isMessageParty(value) {
+	return value === "parent" || value === "child";
+}
+function parseMessage(value) {
+	if (typeof value !== "object" || value === null) return void 0;
+	const record = value;
+	if (record.version !== 1) return void 0;
+	if (typeof record.worktreeId !== "string" || record.worktreeId === "") return void 0;
+	if (typeof record.fromSessionId !== "string" || record.fromSessionId === "") return void 0;
+	if (!isMessageParty(record.from)) return void 0;
+	if (typeof record.text !== "string" || record.text === "") return void 0;
+	if (Buffer.byteLength(record.text, "utf8") > 65536) return void 0;
+	if (typeof record.sentAt !== "string" || record.sentAt === "") return void 0;
+	return record;
+}
+function createWorktreeMessageInbox(directEvents, sessionId) {
+	if (sessionId === "") throw new Error("The Git message service requires a session identity.");
+	const messages = /* @__PURE__ */ new Map();
+	const unsubscribe = directEvents.subscribe(GIT_WORKTREE_MESSAGE_EVENT, sessionId, (payload) => {
+		const message = parseMessage(payload);
+		if (message === void 0) return;
+		const inbox = messages.get(message.worktreeId) ?? [];
+		if (inbox.length >= 100) inbox.shift();
+		inbox.push(message);
+		messages.set(message.worktreeId, inbox);
+	});
+	let closed = false;
+	return {
+		send(targetSessionId, message) {
+			if (closed) throw new Error("The Git message service is closed.");
+			directEvents.publish(GIT_WORKTREE_MESSAGE_EVENT, targetSessionId, message);
+		},
+		receive(worktreeId) {
+			if (closed) return [];
+			const inbox = messages.get(worktreeId);
+			if (inbox === void 0) return [];
+			messages.delete(worktreeId);
+			return inbox;
+		},
+		close() {
+			if (closed) return;
+			closed = true;
+			unsubscribe();
+			messages.clear();
+		}
+	};
+}
+function isWorktreeLifecycleEvent(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const record = value;
+	return record.version === 1 && typeof record.repositoryRoot === "string" && record.repositoryRoot !== "";
+}
+//#endregion
+export { GIT_WORKTREE_LIFECYCLE_EVENT, GIT_WORKTREE_MESSAGE_EVENT, MAX_WORKTREE_MESSAGE_BYTES, createWorktreeMessageInbox, isWorktreeLifecycleEvent };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/worktreeEvents/index.ts"],"sourcesContent":["import type { DoomDirectEventBus } from '@agimon-ai/doompi-core/hub-channel';\n\nexport const GIT_WORKTREE_LIFECYCLE_EVENT = 'git_worktree_lifecycle';\nexport const GIT_WORKTREE_MESSAGE_EVENT = 'git_worktree_message';\nexport const WORKTREE_MESSAGE_VERSION = 1 as const;\nexport const MAX_WORKTREE_MESSAGE_BYTES = 64 * 1024;\nexport const MAX_WORKTREE_INBOX_MESSAGES = 100;\n\nexport interface WorktreeLifecycleEvent {\n  readonly version: typeof WORKTREE_MESSAGE_VERSION;\n  readonly repositoryRoot: string;\n}\n\nexport type WorktreeMessageParty = 'parent' | 'child';\n\nexport interface WorktreeMessage {\n  readonly version: typeof WORKTREE_MESSAGE_VERSION;\n  readonly worktreeId: string;\n  readonly fromSessionId: string;\n  readonly from: WorktreeMessageParty;\n  readonly text: string;\n  readonly sentAt: string;\n}\n\nexport interface WorktreeMessageInbox {\n  send(targetSessionId: string, message: WorktreeMessage): void;\n  receive(worktreeId: string): WorktreeMessage[];\n  close(): void;\n}\n\nfunction isMessageParty(value: unknown): value is WorktreeMessageParty {\n  return value === 'parent' || value === 'child';\n}\n\nfunction parseMessage(value: unknown): WorktreeMessage | undefined {\n  if (typeof value !== 'object' || value === null) return undefined;\n  const record = value as Partial<WorktreeMessage>;\n  if (record.version !== WORKTREE_MESSAGE_VERSION) return undefined;\n  if (typeof record.worktreeId !== 'string' || record.worktreeId === '') return undefined;\n  if (typeof record.fromSessionId !== 'string' || record.fromSessionId === '') return undefined;\n  if (!isMessageParty(record.from)) return undefined;\n  if (typeof record.text !== 'string' || record.text === '') return undefined;\n  if (Buffer.byteLength(record.text, 'utf8') > MAX_WORKTREE_MESSAGE_BYTES) return undefined;\n  if (typeof record.sentAt !== 'string' || record.sentAt === '') return undefined;\n  return record as WorktreeMessage;\n}\n\nexport function createWorktreeMessageInbox(directEvents: DoomDirectEventBus, sessionId: string): WorktreeMessageInbox {\n  if (sessionId === '') throw new Error('The Git message service requires a session identity.');\n  const messages = new Map<string, WorktreeMessage[]>();\n  const unsubscribe = directEvents.subscribe(GIT_WORKTREE_MESSAGE_EVENT, sessionId, (payload) => {\n    const message = parseMessage(payload);\n    if (message === undefined) return;\n    const inbox = messages.get(message.worktreeId) ?? [];\n    if (inbox.length >= MAX_WORKTREE_INBOX_MESSAGES) inbox.shift();\n    inbox.push(message);\n    messages.set(message.worktreeId, inbox);\n  });\n  let closed = false;\n  return {\n    send(targetSessionId, message) {\n      if (closed) throw new Error('The Git message service is closed.');\n      directEvents.publish(GIT_WORKTREE_MESSAGE_EVENT, targetSessionId, message);\n    },\n    receive(worktreeId) {\n      if (closed) return [];\n      const inbox = messages.get(worktreeId);\n      if (inbox === undefined) return [];\n      messages.delete(worktreeId);\n      return inbox;\n    },\n    close() {\n      if (closed) return;\n      closed = true;\n      unsubscribe();\n      messages.clear();\n    },\n  };\n}\n\nexport function isWorktreeLifecycleEvent(value: unknown): value is WorktreeLifecycleEvent {\n  if (typeof value !== 'object' || value === null) return false;\n  const record = value as Partial<WorktreeLifecycleEvent>;\n  return (\n    record.version === WORKTREE_MESSAGE_VERSION &&\n    typeof record.repositoryRoot === 'string' &&\n    record.repositoryRoot !== ''\n  );\n}\n"],"mappings":";AAEA,MAAa,+BAA+B;AAC5C,MAAa,6BAA6B;AAE1C,MAAa,6BAA6B;AAyB1C,SAAS,eAAe,OAA+C;CACrE,OAAO,UAAU,YAAY,UAAU;AACzC;AAEA,SAAS,aAAa,OAA6C;CACjE,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;CACxD,MAAM,SAAS;CACf,IAAI,OAAO,YAAA,GAAsC,OAAO,KAAA;CACxD,IAAI,OAAO,OAAO,eAAe,YAAY,OAAO,eAAe,IAAI,OAAO,KAAA;CAC9E,IAAI,OAAO,OAAO,kBAAkB,YAAY,OAAO,kBAAkB,IAAI,OAAO,KAAA;CACpF,IAAI,CAAC,eAAe,OAAO,IAAI,GAAG,OAAO,KAAA;CACzC,IAAI,OAAO,OAAO,SAAS,YAAY,OAAO,SAAS,IAAI,OAAO,KAAA;CAClE,IAAI,OAAO,WAAW,OAAO,MAAM,MAAM,IAAA,OAAgC,OAAO,KAAA;CAChF,IAAI,OAAO,OAAO,WAAW,YAAY,OAAO,WAAW,IAAI,OAAO,KAAA;CACtE,OAAO;AACT;AAEA,SAAgB,2BAA2B,cAAkC,WAAyC;CACpH,IAAI,cAAc,IAAI,MAAM,IAAI,MAAM,sDAAsD;CAC5F,MAAM,2BAAW,IAAI,IAA+B;CACpD,MAAM,cAAc,aAAa,UAAU,4BAA4B,YAAY,YAAY;EAC7F,MAAM,UAAU,aAAa,OAAO;EACpC,IAAI,YAAY,KAAA,GAAW;EAC3B,MAAM,QAAQ,SAAS,IAAI,QAAQ,UAAU,KAAK,CAAC;EACnD,IAAI,MAAM,UAAA,KAAuC,MAAM,MAAM;EAC7D,MAAM,KAAK,OAAO;EAClB,SAAS,IAAI,QAAQ,YAAY,KAAK;CACxC,CAAC;CACD,IAAI,SAAS;CACb,OAAO;EACL,KAAK,iBAAiB,SAAS;GAC7B,IAAI,QAAQ,MAAM,IAAI,MAAM,oCAAoC;GAChE,aAAa,QAAQ,4BAA4B,iBAAiB,OAAO;EAC3E;EACA,QAAQ,YAAY;GAClB,IAAI,QAAQ,OAAO,CAAC;GACpB,MAAM,QAAQ,SAAS,IAAI,UAAU;GACrC,IAAI,UAAU,KAAA,GAAW,OAAO,CAAC;GACjC,SAAS,OAAO,UAAU;GAC1B,OAAO;EACT;EACA,QAAQ;GACN,IAAI,QAAQ;GACZ,SAAS;GACT,YAAY;GACZ,SAAS,MAAM;EACjB;CACF;AACF;AAEA,SAAgB,yBAAyB,OAAiD;CACxF,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,SAAS;CACf,OACE,OAAO,YAAA,KACP,OAAO,OAAO,mBAAmB,YACjC,OAAO,mBAAmB;AAE9B"}

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

@@ -0,0 +1,99 @@
+//#region src/services/worktreeNaming/index.ts
+const MAX_SLUG_LENGTH = 64;
+/**
+* A branch name reduced to one safe path segment.
+*
+* Slashes are the point: `wt/fix-auth` is a perfectly good branch and a
+* terrible directory name, because the nested directory it implies is not the
+* one the worktree lives in.
+*/
+function branchSlug(branch) {
+	const slug = branch.toLowerCase().replace(/[^a-z0-9]+/gu, "-").replace(/^-+|-+$/gu, "").slice(0, MAX_SLUG_LENGTH).replace(/-+$/gu, "");
+	return slug === "" ? "worktree" : slug;
+}
+/**
+* The directory for one worktree.
+*
+* The short id disambiguates two branches whose slugs collide, such as
+* `feature/x` and `feature_x`, which would otherwise want the same directory.
+*/
+function worktreeDirectory(input) {
+	const repository = `${input.repositoryLabel}--${input.repositoryId}`;
+	return `${input.worktreesRoot}/${repository}/${branchSlug(input.branch)}--${input.shortId}`;
+}
+/** Why a worktree cannot be created, or undefined when it can. */
+function refuseSpawn(input) {
+	if (input.branch.trim() === "") return "A branch name is required.";
+	const live = input.existing.find((record) => record.branch === input.branch && record.status !== "orphaned");
+	if (live) return `Branch ${input.branch} already has a worktree (${live.id}).`;
+}
+/** Why a worktree cannot be closed, or undefined when it can. */
+function refuseClose(input) {
+	if (!input.record) return "No worktree with that id. Call list to see the current ids.";
+	if (input.dirtyFiles.length === 0 || input.force) return void 0;
+	const names = input.dirtyFiles.slice(0, 10).join(", ");
+	const more = input.dirtyFiles.length > 10 ? `, and ${String(input.dirtyFiles.length - 10)} more` : "";
+	return `${String(input.dirtyFiles.length)} uncommitted file(s): ${names}${more}. Pass force: true to discard them.`;
+}
+/**
+* Marks records whose process or directory is gone as orphaned.
+*
+* Nothing is deleted here. A doompi-git orphan owns a directory that may hold
+* uncommitted work, so losing the record would lose the only pointer to it.
+* Deletion is always a separate, named decision.
+*/
+function reconcile(records, probe) {
+	const changed = [];
+	return {
+		records: records.map((record) => {
+			if (record.status === "orphaned") return record;
+			if (!(!probe.exists(record.path) || !probe.alive(record))) return record;
+			changed.push(record.id);
+			return {
+				...record,
+				status: "orphaned"
+			};
+		}),
+		changed
+	};
+}
+/**
+* What a prune would do, decided before anything is destroyed.
+*
+* Separating the plan from the execution is what makes dryRun honest and lets
+* the destructive half be reviewed on its own.
+*/
+function planPrune(input) {
+	const plan = {
+		remove: [],
+		forget: [],
+		untracked: [],
+		keptDirty: [],
+		keptBranches: []
+	};
+	const known = new Set(input.records.map((record) => record.path));
+	const listed = new Set(input.gitPaths);
+	for (const record of input.records) {
+		if (record.status !== "orphaned") continue;
+		if (!listed.has(record.path)) {
+			plan.forget.push(record);
+			continue;
+		}
+		if ((input.dirtyByPath.get(record.path) ?? []).length > 0) {
+			plan.keptDirty.push(record);
+			continue;
+		}
+		plan.remove.push(record);
+	}
+	for (const path of input.gitPaths) if (path.startsWith(`${input.worktreesRoot}/`) && !known.has(path)) plan.untracked.push(path);
+	return plan;
+}
+//#endregion
+exports.branchSlug = branchSlug;
+exports.planPrune = planPrune;
+exports.reconcile = reconcile;
+exports.refuseClose = refuseClose;
+exports.refuseSpawn = refuseSpawn;
+exports.worktreeDirectory = worktreeDirectory;
+
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/services/worktreeNaming/index.ts"],"sourcesContent":["/**\n * Naming and reconciliation rules for worktrees, as pure functions.\n *\n * Everything here is a function of its arguments so the interesting decisions,\n * which are the ones about destroying work, can be tested without a repository\n * or a filesystem.\n */\n\nimport type { WorktreeRecord } from '../../types/worktreeRegistry';\n\nconst MAX_SLUG_LENGTH = 64;\n\n/**\n * A branch name reduced to one safe path segment.\n *\n * Slashes are the point: `wt/fix-auth` is a perfectly good branch and a\n * terrible directory name, because the nested directory it implies is not the\n * one the worktree lives in.\n */\nexport function branchSlug(branch: string): string {\n  const slug = branch\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/gu, '-')\n    .replace(/^-+|-+$/gu, '')\n    .slice(0, MAX_SLUG_LENGTH)\n    .replace(/-+$/gu, '');\n  return slug === '' ? 'worktree' : slug;\n}\n\n/**\n * The directory for one worktree.\n *\n * The short id disambiguates two branches whose slugs collide, such as\n * `feature/x` and `feature_x`, which would otherwise want the same directory.\n */\nexport function worktreeDirectory(input: {\n  worktreesRoot: string;\n  repositoryLabel: string;\n  repositoryId: string;\n  branch: string;\n  shortId: string;\n}): string {\n  const repository = `${input.repositoryLabel}--${input.repositoryId}`;\n  return `${input.worktreesRoot}/${repository}/${branchSlug(input.branch)}--${input.shortId}`;\n}\n\n/** Why a worktree cannot be created, or undefined when it can. */\nexport function refuseSpawn(input: { branch: string; existing: readonly WorktreeRecord[] }): string | undefined {\n  if (input.branch.trim() === '') return 'A branch name is required.';\n  // Git refuses a second worktree on one branch, but its message names a path\n  // the caller never chose, so this says it in the caller's own terms first.\n  const live = input.existing.find((record) => record.branch === input.branch && record.status !== 'orphaned');\n  if (live) return `Branch ${input.branch} already has a worktree (${live.id}).`;\n  return undefined;\n}\n\n/** Why a worktree cannot be closed, or undefined when it can. */\nexport function refuseClose(input: {\n  record: WorktreeRecord | undefined;\n  dirtyFiles: readonly string[];\n  force: boolean;\n}): string | undefined {\n  if (!input.record) return 'No worktree with that id. Call list to see the current ids.';\n  if (input.dirtyFiles.length === 0 || input.force) return undefined;\n  // Naming the files is the point: \"the tree is dirty\" sends the reader to go\n  // look, and the answer is usually a file they forgot rather than one they\n  // meant to keep.\n  const names = input.dirtyFiles.slice(0, 10).join(', ');\n  const more = input.dirtyFiles.length > 10 ? `, and ${String(input.dirtyFiles.length - 10)} more` : '';\n  return `${String(input.dirtyFiles.length)} uncommitted file(s): ${names}${more}. Pass force: true to discard them.`;\n}\n\nexport interface Reconciliation {\n  records: WorktreeRecord[];\n  /** Ids whose status changed, so a caller can report what it noticed. */\n  changed: string[];\n}\n\n/**\n * Marks records whose process or directory is gone as orphaned.\n *\n * Nothing is deleted here. A doompi-git orphan owns a directory that may hold\n * uncommitted work, so losing the record would lose the only pointer to it.\n * Deletion is always a separate, named decision.\n */\nexport function reconcile(\n  records: readonly WorktreeRecord[],\n  probe: { alive: (record: WorktreeRecord) => boolean; exists: (path: string) => boolean },\n): Reconciliation {\n  const changed: string[] = [];\n  const next = records.map((record) => {\n    if (record.status === 'orphaned') return record;\n    const gone = !probe.exists(record.path) || !probe.alive(record);\n    if (!gone) return record;\n    changed.push(record.id);\n    return { ...record, status: 'orphaned' as const };\n  });\n  return { records: next, changed };\n}\n\nexport interface PrunePlan {\n  /** Orphans whose directory git still lists, safe to remove. */\n  remove: WorktreeRecord[];\n  /** Orphans whose directory is already gone; drop the record only. */\n  forget: WorktreeRecord[];\n  /** Paths git lists under our root that we have no record of; report, never touch. */\n  untracked: string[];\n  /** Orphans left alone because they still hold uncommitted work. */\n  keptDirty: WorktreeRecord[];\n  /**\n   * Branches git refused to delete because they hold commits.\n   *\n   * Filled by the prune itself, not by the plan: a dry run destroys nothing, so\n   * it has nothing to report here and leaves it empty.\n   */\n  keptBranches: string[];\n}\n\n/**\n * What a prune would do, decided before anything is destroyed.\n *\n * Separating the plan from the execution is what makes dryRun honest and lets\n * the destructive half be reviewed on its own.\n */\nexport function planPrune(input: {\n  records: readonly WorktreeRecord[];\n  gitPaths: readonly string[];\n  worktreesRoot: string;\n  dirtyByPath: ReadonlyMap<string, readonly string[]>;\n}): PrunePlan {\n  const plan: PrunePlan = { remove: [], forget: [], untracked: [], keptDirty: [], keptBranches: [] };\n  const known = new Set(input.records.map((record) => record.path));\n  const listed = new Set(input.gitPaths);\n  for (const record of input.records) {\n    if (record.status !== 'orphaned') continue;\n    if (!listed.has(record.path)) {\n      plan.forget.push(record);\n      continue;\n    }\n    if ((input.dirtyByPath.get(record.path) ?? []).length > 0) {\n      plan.keptDirty.push(record);\n      continue;\n    }\n    plan.remove.push(record);\n  }\n  for (const path of input.gitPaths) {\n    // Only ever inside our own root: a worktree the user made by hand is none\n    // of this package's business, even when it looks abandoned.\n    if (path.startsWith(`${input.worktreesRoot}/`) && !known.has(path)) plan.untracked.push(path);\n  }\n  return plan;\n}\n"],"mappings":";AAUA,MAAM,kBAAkB;;;;;;;;AASxB,SAAgB,WAAW,QAAwB;CACjD,MAAM,OAAO,OACV,YAAY,CAAC,CACb,QAAQ,gBAAgB,GAAG,CAAC,CAC5B,QAAQ,aAAa,EAAE,CAAC,CACxB,MAAM,GAAG,eAAe,CAAC,CACzB,QAAQ,SAAS,EAAE;CACtB,OAAO,SAAS,KAAK,aAAa;AACpC;;;;;;;AAQA,SAAgB,kBAAkB,OAMvB;CACT,MAAM,aAAa,GAAG,MAAM,gBAAgB,IAAI,MAAM;CACtD,OAAO,GAAG,MAAM,cAAc,GAAG,WAAW,GAAG,WAAW,MAAM,MAAM,EAAE,IAAI,MAAM;AACpF;;AAGA,SAAgB,YAAY,OAAoF;CAC9G,IAAI,MAAM,OAAO,KAAK,MAAM,IAAI,OAAO;CAGvC,MAAM,OAAO,MAAM,SAAS,MAAM,WAAW,OAAO,WAAW,MAAM,UAAU,OAAO,WAAW,UAAU;CAC3G,IAAI,MAAM,OAAO,UAAU,MAAM,OAAO,2BAA2B,KAAK,GAAG;AAE7E;;AAGA,SAAgB,YAAY,OAIL;CACrB,IAAI,CAAC,MAAM,QAAQ,OAAO;CAC1B,IAAI,MAAM,WAAW,WAAW,KAAK,MAAM,OAAO,OAAO,KAAA;CAIzD,MAAM,QAAQ,MAAM,WAAW,MAAM,GAAG,EAAE,CAAC,CAAC,KAAK,IAAI;CACrD,MAAM,OAAO,MAAM,WAAW,SAAS,KAAK,SAAS,OAAO,MAAM,WAAW,SAAS,EAAE,EAAE,SAAS;CACnG,OAAO,GAAG,OAAO,MAAM,WAAW,MAAM,EAAE,wBAAwB,QAAQ,KAAK;AACjF;;;;;;;;AAeA,SAAgB,UACd,SACA,OACgB;CAChB,MAAM,UAAoB,CAAC;CAQ3B,OAAO;EAAE,SAPI,QAAQ,KAAK,WAAW;GACnC,IAAI,OAAO,WAAW,YAAY,OAAO;GAEzC,IAAI,EADS,CAAC,MAAM,OAAO,OAAO,IAAI,KAAK,CAAC,MAAM,MAAM,MAAM,IACnD,OAAO;GAClB,QAAQ,KAAK,OAAO,EAAE;GACtB,OAAO;IAAE,GAAG;IAAQ,QAAQ;GAAoB;EAClD,CACqB;EAAG;CAAQ;AAClC;;;;;;;AA0BA,SAAgB,UAAU,OAKZ;CACZ,MAAM,OAAkB;EAAE,QAAQ,CAAC;EAAG,QAAQ,CAAC;EAAG,WAAW,CAAC;EAAG,WAAW,CAAC;EAAG,cAAc,CAAC;CAAE;CACjG,MAAM,QAAQ,IAAI,IAAI,MAAM,QAAQ,KAAK,WAAW,OAAO,IAAI,CAAC;CAChE,MAAM,SAAS,IAAI,IAAI,MAAM,QAAQ;CACrC,KAAK,MAAM,UAAU,MAAM,SAAS;EAClC,IAAI,OAAO,WAAW,YAAY;EAClC,IAAI,CAAC,OAAO,IAAI,OAAO,IAAI,GAAG;GAC5B,KAAK,OAAO,KAAK,MAAM;GACvB;EACF;EACA,KAAK,MAAM,YAAY,IAAI,OAAO,IAAI,KAAK,CAAC,EAAA,CAAG,SAAS,GAAG;GACzD,KAAK,UAAU,KAAK,MAAM;GAC1B;EACF;EACA,KAAK,OAAO,KAAK,MAAM;CACzB;CACA,KAAK,MAAM,QAAQ,MAAM,UAGvB,IAAI,KAAK,WAAW,GAAG,MAAM,cAAc,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI,GAAG,KAAK,UAAU,KAAK,IAAI;CAE9F,OAAO;AACT"}

package/dist/{services → src/services}/worktreeNaming/index.d.cts

@@ -1,6 +1,6 @@
 import { WorktreeRecord } from "../../types/worktreeRegistry.cjs";
 //#region src/services/worktreeNaming/index.d.ts
-interface PrunePlan {
+export interface PrunePlan {
   /** Orphans whose directory git still lists, safe to remove. */
   remove: WorktreeRecord[];
   /** Orphans whose directory is already gone; drop the record only. */
@@ -23,12 +23,11 @@ interface PrunePlan {
  * Separating the plan from the execution is what makes dryRun honest and lets
  * the destructive half be reviewed on its own.
  */
-declare function planPrune(input: {
+export declare function planPrune(input: {
   records: readonly WorktreeRecord[];
   gitPaths: readonly string[];
   worktreesRoot: string;
   dirtyByPath: ReadonlyMap<string, readonly string[]>;
 }): PrunePlan;
 //#endregion
-export { PrunePlan, planPrune };
 //# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../../src/services/worktreeNaming/index.ts"],"mappings":";;iBAoGiB;;EAEf,QAAQ;;EAER,QAAQ;;EAER;;EAEA,WAAW;;;;;;;EAOX;;;;;;;;wBASc,UAAU;EACxB,kBAAkB;EAClB;EACA;EACA,aAAa;IACX"}

package/dist/{services → src/services}/worktreeNaming/index.d.mts

@@ -1,6 +1,6 @@
 import { WorktreeRecord } from "../../types/worktreeRegistry.mjs";
 //#region src/services/worktreeNaming/index.d.ts
-interface PrunePlan {
+export interface PrunePlan {
   /** Orphans whose directory git still lists, safe to remove. */
   remove: WorktreeRecord[];
   /** Orphans whose directory is already gone; drop the record only. */
@@ -23,12 +23,11 @@ interface PrunePlan {
  * Separating the plan from the execution is what makes dryRun honest and lets
  * the destructive half be reviewed on its own.
  */
-declare function planPrune(input: {
+export declare function planPrune(input: {
   records: readonly WorktreeRecord[];
   gitPaths: readonly string[];
   worktreesRoot: string;
   dirtyByPath: ReadonlyMap<string, readonly string[]>;
 }): PrunePlan;
 //#endregion
-export { PrunePlan, planPrune };
 //# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/worktreeNaming/index.ts"],"mappings":";;iBAoGiB;;EAEf,QAAQ;;EAER,QAAQ;;EAER;;EAEA,WAAW;;;;;;;EAOX;;;;;;;;wBASc,UAAU;EACxB,kBAAkB;EAClB;EACA;EACA,aAAa;IACX"}