@agimon-ai/doompi-git 0.0.1-alpha.0

package/dist/index.d.mts

@@ -0,0 +1,5 @@
+import { GitExtensionDependencies, GitExtensionResult, GitExtensionService } from "./types/extension.mjs";
+import { activateGitExtension } from "./adapters/pi/extension.mjs";
+import { DefaultGitExtensionService } from "./services/extensionService.mjs";
+import { createGitContainer } from "./container/index.mjs";
+export { DefaultGitExtensionService, type GitExtensionDependencies, type GitExtensionResult, type GitExtensionService, activateGitExtension, createGitContainer };

package/dist/index.mjs

@@ -0,0 +1 @@
+import{DefaultGitExtensionService as e}from"./services/extensionService.mjs";import{createGitContainer as t}from"./container/index.mjs";import{activateGitExtension as n}from"./adapters/pi/extension.mjs";export{e as DefaultGitExtensionService,n as activateGitExtension,t as createGitContainer};

package/dist/schemas/runWorktreeTool.cjs

@@ -0,0 +1,2 @@
+let e=require("typebox");const t={spawn_worktree:`spawn_worktree`,close_worktree:`close_worktree`,list:`list`,status:`status`,merge:`merge`,prune:`prune`,send:`send`,messages:`messages`},n={spawn_worktree:[`action`,`branch`,`baseRef`,`task`,`name`],close_worktree:[`action`,`id`,`force`],list:[`action`],status:[`action`,`id`],merge:[`action`,`id`,`message`],prune:[`action`,`dryRun`],send:[`action`,`id`,`message`],messages:[`action`,`id`]},r=e.Type.Object({action:e.Type.Literal(t.spawn_worktree),branch:e.Type.String({minLength:1}),baseRef:e.Type.Optional(e.Type.String({minLength:1})),task:e.Type.Optional(e.Type.String({minLength:1})),name:e.Type.Optional(e.Type.String({minLength:1}))},{additionalProperties:!1}),i=e.Type.Object({action:e.Type.Literal(t.close_worktree),id:e.Type.String({minLength:1}),force:e.Type.Optional(e.Type.Boolean())},{additionalProperties:!1}),a=e.Type.Object({action:e.Type.Literal(t.list)},{additionalProperties:!1}),o=e.Type.Object({action:e.Type.Literal(t.status),id:e.Type.String({minLength:1})},{additionalProperties:!1}),s=e.Type.Object({action:e.Type.Literal(t.merge),id:e.Type.String({minLength:1}),message:e.Type.Optional(e.Type.String({minLength:1}))},{additionalProperties:!1}),c=e.Type.Object({action:e.Type.Literal(t.prune),dryRun:e.Type.Optional(e.Type.Boolean())},{additionalProperties:!1}),l=e.Type.Object({action:e.Type.Literal(t.send),id:e.Type.String({minLength:1}),message:e.Type.String({minLength:1})},{additionalProperties:!1}),u=e.Type.Object({action:e.Type.Literal(t.messages),id:e.Type.String({minLength:1})},{additionalProperties:!1}),d=e.Type.Union([r,i,a,o,s,c,l,u]);exports.RunWorktreeParams=d,exports.WORKTREE_ACTIONS=t,exports.WORKTREE_ACTION_FIELDS=n;
+//# sourceMappingURL=runWorktreeTool.cjs.map

package/dist/schemas/runWorktreeTool.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runWorktreeTool.cjs","names":["Type"],"sources":["../../src/schemas/runWorktreeTool.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\n/**\n * The tool's action vocabulary.\n *\n * One tool with an action field rather than six tools, matching `subagent`:\n * the actions share a subject and are meaningless apart from it, and six\n * separate tools would spend six description budgets teaching the same nouns.\n */\nexport const WORKTREE_ACTIONS = {\n  spawn_worktree: 'spawn_worktree',\n  close_worktree: 'close_worktree',\n  list: 'list',\n  status: 'status',\n  merge: 'merge',\n  prune: 'prune',\n  send: 'send',\n  messages: 'messages',\n} as const;\n\nexport type WorktreeAction = (typeof WORKTREE_ACTIONS)[keyof typeof WORKTREE_ACTIONS];\n\n/**\n * Which fields each action accepts.\n *\n * Rejecting an unknown field is what stops a plausible-looking call from doing\n * something other than what it reads like: `close_worktree` with `branch`\n * instead of `id` would otherwise close whatever the default resolved to.\n */\nexport const WORKTREE_ACTION_FIELDS: Record<WorktreeAction, readonly string[]> = {\n  spawn_worktree: ['action', 'branch', 'baseRef', 'task', 'name'],\n  close_worktree: ['action', 'id', 'force'],\n  list: ['action'],\n  status: ['action', 'id'],\n  merge: ['action', 'id', 'message'],\n  prune: ['action', 'dryRun'],\n  send: ['action', 'id', 'message'],\n  messages: ['action', 'id'],\n};\n\nconst SpawnParams = Type.Object(\n  {\n    action: Type.Literal(WORKTREE_ACTIONS.spawn_worktree),\n    branch: Type.String({ minLength: 1 }),\n    baseRef: Type.Optional(Type.String({ minLength: 1 })),\n    task: Type.Optional(Type.String({ minLength: 1 })),\n    name: Type.Optional(Type.String({ minLength: 1 })),\n  },\n  { additionalProperties: false },\n);\n\nconst CloseParams = Type.Object(\n  {\n    action: Type.Literal(WORKTREE_ACTIONS.close_worktree),\n    id: Type.String({ minLength: 1 }),\n    force: Type.Optional(Type.Boolean()),\n  },\n  { additionalProperties: false },\n);\n\nconst ListParams = Type.Object({ action: Type.Literal(WORKTREE_ACTIONS.list) }, { additionalProperties: false });\n\nconst StatusParams = Type.Object(\n  { action: Type.Literal(WORKTREE_ACTIONS.status), id: Type.String({ minLength: 1 }) },\n  { additionalProperties: false },\n);\n\nconst MergeParams = Type.Object(\n  {\n    action: Type.Literal(WORKTREE_ACTIONS.merge),\n    id: Type.String({ minLength: 1 }),\n    message: Type.Optional(Type.String({ minLength: 1 })),\n  },\n  { additionalProperties: false },\n);\n\nconst PruneParams = Type.Object(\n  { action: Type.Literal(WORKTREE_ACTIONS.prune), dryRun: Type.Optional(Type.Boolean()) },\n  { additionalProperties: false },\n);\n\nconst SendParams = Type.Object(\n  {\n    action: Type.Literal(WORKTREE_ACTIONS.send),\n    id: Type.String({ minLength: 1 }),\n    message: Type.String({ minLength: 1 }),\n  },\n  { additionalProperties: false },\n);\n\nconst MessagesParams = Type.Object(\n  { action: Type.Literal(WORKTREE_ACTIONS.messages), id: Type.String({ minLength: 1 }) },\n  { additionalProperties: false },\n);\n\nexport const RunWorktreeParams = Type.Union([\n  SpawnParams,\n  CloseParams,\n  ListParams,\n  StatusParams,\n  MergeParams,\n  PruneParams,\n  SendParams,\n  MessagesParams,\n]);\n\nexport type RunWorktreeToolParams = Static<typeof RunWorktreeParams>;\n"],"mappings":"yBASA,MAAa,EAAmB,CAC9B,eAAgB,iBAChB,eAAgB,iBAChB,KAAM,OACN,OAAQ,SACR,MAAO,QACP,MAAO,QACP,KAAM,OACN,SAAU,UACZ,EAWa,EAAoE,CAC/E,eAAgB,CAAC,SAAU,SAAU,UAAW,OAAQ,MAAM,EAC9D,eAAgB,CAAC,SAAU,KAAM,OAAO,EACxC,KAAM,CAAC,QAAQ,EACf,OAAQ,CAAC,SAAU,IAAI,EACvB,MAAO,CAAC,SAAU,KAAM,SAAS,EACjC,MAAO,CAAC,SAAU,QAAQ,EAC1B,KAAM,CAAC,SAAU,KAAM,SAAS,EAChC,SAAU,CAAC,SAAU,IAAI,CAC3B,EAEM,EAAcA,EAAAA,KAAK,OACvB,CACE,OAAQA,EAAAA,KAAK,QAAQ,EAAiB,cAAc,EACpD,OAAQA,EAAAA,KAAK,OAAO,CAAE,UAAW,CAAE,CAAC,EACpC,QAASA,EAAAA,KAAK,SAASA,EAAAA,KAAK,OAAO,CAAE,UAAW,CAAE,CAAC,CAAC,EACpD,KAAMA,EAAAA,KAAK,SAASA,EAAAA,KAAK,OAAO,CAAE,UAAW,CAAE,CAAC,CAAC,EACjD,KAAMA,EAAAA,KAAK,SAASA,EAAAA,KAAK,OAAO,CAAE,UAAW,CAAE,CAAC,CAAC,CACnD,EACA,CAAE,qBAAsB,EAAM,CAChC,EAEM,EAAcA,EAAAA,KAAK,OACvB,CACE,OAAQA,EAAAA,KAAK,QAAQ,EAAiB,cAAc,EACpD,GAAIA,EAAAA,KAAK,OAAO,CAAE,UAAW,CAAE,CAAC,EAChC,MAAOA,EAAAA,KAAK,SAASA,EAAAA,KAAK,QAAQ,CAAC,CACrC,EACA,CAAE,qBAAsB,EAAM,CAChC,EAEM,EAAaA,EAAAA,KAAK,OAAO,CAAE,OAAQA,EAAAA,KAAK,QAAQ,EAAiB,IAAI,CAAE,EAAG,CAAE,qBAAsB,EAAM,CAAC,EAEzG,EAAeA,EAAAA,KAAK,OACxB,CAAE,OAAQA,EAAAA,KAAK,QAAQ,EAAiB,MAAM,EAAG,GAAIA,EAAAA,KAAK,OAAO,CAAE,UAAW,CAAE,CAAC,CAAE,EACnF,CAAE,qBAAsB,EAAM,CAChC,EAEM,EAAcA,EAAAA,KAAK,OACvB,CACE,OAAQA,EAAAA,KAAK,QAAQ,EAAiB,KAAK,EAC3C,GAAIA,EAAAA,KAAK,OAAO,CAAE,UAAW,CAAE,CAAC,EAChC,QAASA,EAAAA,KAAK,SAASA,EAAAA,KAAK,OAAO,CAAE,UAAW,CAAE,CAAC,CAAC,CACtD,EACA,CAAE,qBAAsB,EAAM,CAChC,EAEM,EAAcA,EAAAA,KAAK,OACvB,CAAE,OAAQA,EAAAA,KAAK,QAAQ,EAAiB,KAAK,EAAG,OAAQA,EAAAA,KAAK,SAASA,EAAAA,KAAK,QAAQ,CAAC,CAAE,EACtF,CAAE,qBAAsB,EAAM,CAChC,EAEM,EAAaA,EAAAA,KAAK,OACtB,CACE,OAAQA,EAAAA,KAAK,QAAQ,EAAiB,IAAI,EAC1C,GAAIA,EAAAA,KAAK,OAAO,CAAE,UAAW,CAAE,CAAC,EAChC,QAASA,EAAAA,KAAK,OAAO,CAAE,UAAW,CAAE,CAAC,CACvC,EACA,CAAE,qBAAsB,EAAM,CAChC,EAEM,EAAiBA,EAAAA,KAAK,OAC1B,CAAE,OAAQA,EAAAA,KAAK,QAAQ,EAAiB,QAAQ,EAAG,GAAIA,EAAAA,KAAK,OAAO,CAAE,UAAW,CAAE,CAAC,CAAE,EACrF,CAAE,qBAAsB,EAAM,CAChC,EAEa,EAAoBA,EAAAA,KAAK,MAAM,CAC1C,EACA,EACA,EACA,EACA,EACA,EACA,EACA,CACF,CAAC"}

package/dist/schemas/runWorktreeTool.mjs

@@ -0,0 +1,2 @@
+import{Type as e}from"typebox";const t={spawn_worktree:`spawn_worktree`,close_worktree:`close_worktree`,list:`list`,status:`status`,merge:`merge`,prune:`prune`,send:`send`,messages:`messages`},n={spawn_worktree:[`action`,`branch`,`baseRef`,`task`,`name`],close_worktree:[`action`,`id`,`force`],list:[`action`],status:[`action`,`id`],merge:[`action`,`id`,`message`],prune:[`action`,`dryRun`],send:[`action`,`id`,`message`],messages:[`action`,`id`]},r=e.Object({action:e.Literal(t.spawn_worktree),branch:e.String({minLength:1}),baseRef:e.Optional(e.String({minLength:1})),task:e.Optional(e.String({minLength:1})),name:e.Optional(e.String({minLength:1}))},{additionalProperties:!1}),i=e.Object({action:e.Literal(t.close_worktree),id:e.String({minLength:1}),force:e.Optional(e.Boolean())},{additionalProperties:!1}),a=e.Object({action:e.Literal(t.list)},{additionalProperties:!1}),o=e.Object({action:e.Literal(t.status),id:e.String({minLength:1})},{additionalProperties:!1}),s=e.Object({action:e.Literal(t.merge),id:e.String({minLength:1}),message:e.Optional(e.String({minLength:1}))},{additionalProperties:!1}),c=e.Object({action:e.Literal(t.prune),dryRun:e.Optional(e.Boolean())},{additionalProperties:!1}),l=e.Object({action:e.Literal(t.send),id:e.String({minLength:1}),message:e.String({minLength:1})},{additionalProperties:!1}),u=e.Object({action:e.Literal(t.messages),id:e.String({minLength:1})},{additionalProperties:!1}),d=e.Union([r,i,a,o,s,c,l,u]);export{d as RunWorktreeParams,t as WORKTREE_ACTIONS,n as WORKTREE_ACTION_FIELDS};
+//# sourceMappingURL=runWorktreeTool.mjs.map

package/dist/schemas/runWorktreeTool.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runWorktreeTool.mjs","names":[],"sources":["../../src/schemas/runWorktreeTool.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\n/**\n * The tool's action vocabulary.\n *\n * One tool with an action field rather than six tools, matching `subagent`:\n * the actions share a subject and are meaningless apart from it, and six\n * separate tools would spend six description budgets teaching the same nouns.\n */\nexport const WORKTREE_ACTIONS = {\n  spawn_worktree: 'spawn_worktree',\n  close_worktree: 'close_worktree',\n  list: 'list',\n  status: 'status',\n  merge: 'merge',\n  prune: 'prune',\n  send: 'send',\n  messages: 'messages',\n} as const;\n\nexport type WorktreeAction = (typeof WORKTREE_ACTIONS)[keyof typeof WORKTREE_ACTIONS];\n\n/**\n * Which fields each action accepts.\n *\n * Rejecting an unknown field is what stops a plausible-looking call from doing\n * something other than what it reads like: `close_worktree` with `branch`\n * instead of `id` would otherwise close whatever the default resolved to.\n */\nexport const WORKTREE_ACTION_FIELDS: Record<WorktreeAction, readonly string[]> = {\n  spawn_worktree: ['action', 'branch', 'baseRef', 'task', 'name'],\n  close_worktree: ['action', 'id', 'force'],\n  list: ['action'],\n  status: ['action', 'id'],\n  merge: ['action', 'id', 'message'],\n  prune: ['action', 'dryRun'],\n  send: ['action', 'id', 'message'],\n  messages: ['action', 'id'],\n};\n\nconst SpawnParams = Type.Object(\n  {\n    action: Type.Literal(WORKTREE_ACTIONS.spawn_worktree),\n    branch: Type.String({ minLength: 1 }),\n    baseRef: Type.Optional(Type.String({ minLength: 1 })),\n    task: Type.Optional(Type.String({ minLength: 1 })),\n    name: Type.Optional(Type.String({ minLength: 1 })),\n  },\n  { additionalProperties: false },\n);\n\nconst CloseParams = Type.Object(\n  {\n    action: Type.Literal(WORKTREE_ACTIONS.close_worktree),\n    id: Type.String({ minLength: 1 }),\n    force: Type.Optional(Type.Boolean()),\n  },\n  { additionalProperties: false },\n);\n\nconst ListParams = Type.Object({ action: Type.Literal(WORKTREE_ACTIONS.list) }, { additionalProperties: false });\n\nconst StatusParams = Type.Object(\n  { action: Type.Literal(WORKTREE_ACTIONS.status), id: Type.String({ minLength: 1 }) },\n  { additionalProperties: false },\n);\n\nconst MergeParams = Type.Object(\n  {\n    action: Type.Literal(WORKTREE_ACTIONS.merge),\n    id: Type.String({ minLength: 1 }),\n    message: Type.Optional(Type.String({ minLength: 1 })),\n  },\n  { additionalProperties: false },\n);\n\nconst PruneParams = Type.Object(\n  { action: Type.Literal(WORKTREE_ACTIONS.prune), dryRun: Type.Optional(Type.Boolean()) },\n  { additionalProperties: false },\n);\n\nconst SendParams = Type.Object(\n  {\n    action: Type.Literal(WORKTREE_ACTIONS.send),\n    id: Type.String({ minLength: 1 }),\n    message: Type.String({ minLength: 1 }),\n  },\n  { additionalProperties: false },\n);\n\nconst MessagesParams = Type.Object(\n  { action: Type.Literal(WORKTREE_ACTIONS.messages), id: Type.String({ minLength: 1 }) },\n  { additionalProperties: false },\n);\n\nexport const RunWorktreeParams = Type.Union([\n  SpawnParams,\n  CloseParams,\n  ListParams,\n  StatusParams,\n  MergeParams,\n  PruneParams,\n  SendParams,\n  MessagesParams,\n]);\n\nexport type RunWorktreeToolParams = Static<typeof RunWorktreeParams>;\n"],"mappings":"+BASA,MAAa,EAAmB,CAC9B,eAAgB,iBAChB,eAAgB,iBAChB,KAAM,OACN,OAAQ,SACR,MAAO,QACP,MAAO,QACP,KAAM,OACN,SAAU,UACZ,EAWa,EAAoE,CAC/E,eAAgB,CAAC,SAAU,SAAU,UAAW,OAAQ,MAAM,EAC9D,eAAgB,CAAC,SAAU,KAAM,OAAO,EACxC,KAAM,CAAC,QAAQ,EACf,OAAQ,CAAC,SAAU,IAAI,EACvB,MAAO,CAAC,SAAU,KAAM,SAAS,EACjC,MAAO,CAAC,SAAU,QAAQ,EAC1B,KAAM,CAAC,SAAU,KAAM,SAAS,EAChC,SAAU,CAAC,SAAU,IAAI,CAC3B,EAEM,EAAc,EAAK,OACvB,CACE,OAAQ,EAAK,QAAQ,EAAiB,cAAc,EACpD,OAAQ,EAAK,OAAO,CAAE,UAAW,CAAE,CAAC,EACpC,QAAS,EAAK,SAAS,EAAK,OAAO,CAAE,UAAW,CAAE,CAAC,CAAC,EACpD,KAAM,EAAK,SAAS,EAAK,OAAO,CAAE,UAAW,CAAE,CAAC,CAAC,EACjD,KAAM,EAAK,SAAS,EAAK,OAAO,CAAE,UAAW,CAAE,CAAC,CAAC,CACnD,EACA,CAAE,qBAAsB,EAAM,CAChC,EAEM,EAAc,EAAK,OACvB,CACE,OAAQ,EAAK,QAAQ,EAAiB,cAAc,EACpD,GAAI,EAAK,OAAO,CAAE,UAAW,CAAE,CAAC,EAChC,MAAO,EAAK,SAAS,EAAK,QAAQ,CAAC,CACrC,EACA,CAAE,qBAAsB,EAAM,CAChC,EAEM,EAAa,EAAK,OAAO,CAAE,OAAQ,EAAK,QAAQ,EAAiB,IAAI,CAAE,EAAG,CAAE,qBAAsB,EAAM,CAAC,EAEzG,EAAe,EAAK,OACxB,CAAE,OAAQ,EAAK,QAAQ,EAAiB,MAAM,EAAG,GAAI,EAAK,OAAO,CAAE,UAAW,CAAE,CAAC,CAAE,EACnF,CAAE,qBAAsB,EAAM,CAChC,EAEM,EAAc,EAAK,OACvB,CACE,OAAQ,EAAK,QAAQ,EAAiB,KAAK,EAC3C,GAAI,EAAK,OAAO,CAAE,UAAW,CAAE,CAAC,EAChC,QAAS,EAAK,SAAS,EAAK,OAAO,CAAE,UAAW,CAAE,CAAC,CAAC,CACtD,EACA,CAAE,qBAAsB,EAAM,CAChC,EAEM,EAAc,EAAK,OACvB,CAAE,OAAQ,EAAK,QAAQ,EAAiB,KAAK,EAAG,OAAQ,EAAK,SAAS,EAAK,QAAQ,CAAC,CAAE,EACtF,CAAE,qBAAsB,EAAM,CAChC,EAEM,EAAa,EAAK,OACtB,CACE,OAAQ,EAAK,QAAQ,EAAiB,IAAI,EAC1C,GAAI,EAAK,OAAO,CAAE,UAAW,CAAE,CAAC,EAChC,QAAS,EAAK,OAAO,CAAE,UAAW,CAAE,CAAC,CACvC,EACA,CAAE,qBAAsB,EAAM,CAChC,EAEM,EAAiB,EAAK,OAC1B,CAAE,OAAQ,EAAK,QAAQ,EAAiB,QAAQ,EAAG,GAAI,EAAK,OAAO,CAAE,UAAW,CAAE,CAAC,CAAE,EACrF,CAAE,qBAAsB,EAAM,CAChC,EAEa,EAAoB,EAAK,MAAM,CAC1C,EACA,EACA,EACA,EACA,EACA,EACA,EACA,CACF,CAAC"}

package/dist/services/extensionService.cjs

@@ -0,0 +1,2 @@
+var e=class{async execute(){return{message:`Show git worktrees owned by this session`,level:`info`}}};exports.DefaultGitExtensionService=e;
+//# sourceMappingURL=extensionService.cjs.map

package/dist/services/extensionService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionService.cjs","names":[],"sources":["../../src/services/extensionService.ts"],"sourcesContent":["// @scaffold-generated\nimport type { GitExtensionResult, GitExtensionService } from '../types/extension.ts';\n\nexport class DefaultGitExtensionService implements GitExtensionService {\n  async execute(): Promise<GitExtensionResult> {\n    return { message: 'Show git worktrees owned by this session', level: 'info' };\n  }\n}\n"],"mappings":"AAGA,IAAa,EAAb,KAAuE,CACrE,MAAM,SAAuC,CAC3C,MAAO,CAAE,QAAS,2CAA4C,MAAO,MAAO,CAC9E,CACF"}

package/dist/services/extensionService.d.cts

@@ -0,0 +1,8 @@
+import { GitExtensionResult, GitExtensionService } from "../types/extension.cjs";
+//#region src/services/extensionService.d.ts
+declare class DefaultGitExtensionService implements GitExtensionService {
+  execute(): Promise<GitExtensionResult>;
+}
+//#endregion
+export { DefaultGitExtensionService };
+//# sourceMappingURL=extensionService.d.cts.map

package/dist/services/extensionService.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionService.d.cts","names":[],"sources":["../../src/services/extensionService.ts"],"mappings":";;cAGa,sCAAsC;EAC3C,WAAW,QAAQ"}

package/dist/services/extensionService.d.mts

@@ -0,0 +1,8 @@
+import { GitExtensionResult, GitExtensionService } from "../types/extension.mjs";
+//#region src/services/extensionService.d.ts
+declare class DefaultGitExtensionService implements GitExtensionService {
+  execute(): Promise<GitExtensionResult>;
+}
+//#endregion
+export { DefaultGitExtensionService };
+//# sourceMappingURL=extensionService.d.mts.map

package/dist/services/extensionService.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionService.d.mts","names":[],"sources":["../../src/services/extensionService.ts"],"mappings":";;cAGa,sCAAsC;EAC3C,WAAW,QAAQ"}

package/dist/services/extensionService.mjs

@@ -0,0 +1,2 @@
+var e=class{async execute(){return{message:`Show git worktrees owned by this session`,level:`info`}}};export{e as DefaultGitExtensionService};
+//# sourceMappingURL=extensionService.mjs.map

package/dist/services/extensionService.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionService.mjs","names":[],"sources":["../../src/services/extensionService.ts"],"sourcesContent":["// @scaffold-generated\nimport type { GitExtensionResult, GitExtensionService } from '../types/extension.ts';\n\nexport class DefaultGitExtensionService implements GitExtensionService {\n  async execute(): Promise<GitExtensionResult> {\n    return { message: 'Show git worktrees owned by this session', level: 'info' };\n  }\n}\n"],"mappings":"AAGA,IAAa,EAAb,KAAuE,CACrE,MAAM,SAAuC,CAC3C,MAAO,CAAE,QAAS,2CAA4C,MAAO,MAAO,CAC9E,CACF"}

package/dist/services/support/errors.cjs

@@ -0,0 +1,2 @@
+var e=class extends Error{code;retryable;recovery;constructor(e,t,n,r){super(`[${e}] ${t}\nRecovery: ${r}`),this.code=e,this.retryable=n,this.recovery=r,this.name=`DoomGitExpectedError`}};function t(t,n){return new e(`invalid_request`,t,!1,n)}exports.DoomGitExpectedError=e,exports.invalidRequest=t;
+//# sourceMappingURL=errors.cjs.map

package/dist/services/support/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","names":[],"sources":["../../../src/services/support/errors.ts"],"sourcesContent":["/**\n * Expected failures, kept private to this package.\n *\n * `@agimon-ai/doompi-extension-contracts` does not export `invalidRequest` or\n * an expected-error base, so this mirrors doompi-team's shape rather than\n * reaching across a layer boundary for it. The duplication is deliberate and\n * small; a shared helper would be the better answer only once a third package\n * needs one.\n */\n\nexport type DoomGitErrorCode =\n  | 'invalid_request'\n  | 'not_a_repository'\n  | 'worktree_exists'\n  | 'worktree_not_found'\n  | 'worktree_dirty'\n  | 'hub_unavailable'\n  | 'install_failed'\n  | 'git_failed';\n\nexport class DoomGitExpectedError extends Error {\n  constructor(\n    readonly code: DoomGitErrorCode,\n    message: string,\n    readonly retryable: boolean,\n    readonly recovery: string,\n  ) {\n    // The recovery line rides in the message because a tool result is read as\n    // text: an error the model cannot act on costs a turn to rediscover.\n    super(`[${code}] ${message}\\nRecovery: ${recovery}`);\n    this.name = 'DoomGitExpectedError';\n  }\n}\n\nexport function invalidRequest(message: string, recovery: string): DoomGitExpectedError {\n  return new DoomGitExpectedError('invalid_request', message, false, recovery);\n}\n"],"mappings":"AAoBA,IAAa,EAAb,cAA0C,KAAM,CAEnC,KAEA,UACA,SAJX,YACE,EACA,EACA,EACA,EACA,CAGA,MAAM,IAAI,EAAK,IAAI,EAAQ,cAAc,GAAU,EAP1C,KAAA,KAAA,EAEA,KAAA,UAAA,EACA,KAAA,SAAA,EAKT,KAAK,KAAO,sBACd,CACF,EAEA,SAAgB,EAAe,EAAiB,EAAwC,CACtF,OAAO,IAAI,EAAqB,kBAAmB,EAAS,GAAO,CAAQ,CAC7E"}

package/dist/services/support/errors.mjs

@@ -0,0 +1,2 @@
+var e=class extends Error{code;retryable;recovery;constructor(e,t,n,r){super(`[${e}] ${t}\nRecovery: ${r}`),this.code=e,this.retryable=n,this.recovery=r,this.name=`DoomGitExpectedError`}};function t(t,n){return new e(`invalid_request`,t,!1,n)}export{e as DoomGitExpectedError,t as invalidRequest};
+//# sourceMappingURL=errors.mjs.map

package/dist/services/support/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../../src/services/support/errors.ts"],"sourcesContent":["/**\n * Expected failures, kept private to this package.\n *\n * `@agimon-ai/doompi-extension-contracts` does not export `invalidRequest` or\n * an expected-error base, so this mirrors doompi-team's shape rather than\n * reaching across a layer boundary for it. The duplication is deliberate and\n * small; a shared helper would be the better answer only once a third package\n * needs one.\n */\n\nexport type DoomGitErrorCode =\n  | 'invalid_request'\n  | 'not_a_repository'\n  | 'worktree_exists'\n  | 'worktree_not_found'\n  | 'worktree_dirty'\n  | 'hub_unavailable'\n  | 'install_failed'\n  | 'git_failed';\n\nexport class DoomGitExpectedError extends Error {\n  constructor(\n    readonly code: DoomGitErrorCode,\n    message: string,\n    readonly retryable: boolean,\n    readonly recovery: string,\n  ) {\n    // The recovery line rides in the message because a tool result is read as\n    // text: an error the model cannot act on costs a turn to rediscover.\n    super(`[${code}] ${message}\\nRecovery: ${recovery}`);\n    this.name = 'DoomGitExpectedError';\n  }\n}\n\nexport function invalidRequest(message: string, recovery: string): DoomGitExpectedError {\n  return new DoomGitExpectedError('invalid_request', message, false, recovery);\n}\n"],"mappings":"AAoBA,IAAa,EAAb,cAA0C,KAAM,CAEnC,KAEA,UACA,SAJX,YACE,EACA,EACA,EACA,EACA,CAGA,MAAM,IAAI,EAAK,IAAI,EAAQ,cAAc,GAAU,EAP1C,KAAA,KAAA,EAEA,KAAA,UAAA,EACA,KAAA,SAAA,EAKT,KAAK,KAAO,sBACd,CACF,EAEA,SAAgB,EAAe,EAAiB,EAAwC,CACtF,OAAO,IAAI,EAAqB,kBAAmB,EAAS,GAAO,CAAQ,CAC7E"}

package/dist/services/worktreeNaming.cjs

@@ -0,0 +1,2 @@
+function e(e){let t=e.toLowerCase().replace(/[^a-z0-9]+/gu,`-`).replace(/^-+|-+$/gu,``).slice(0,64).replace(/-+$/gu,``);return t===``?`worktree`:t}function t(t){let n=`${t.repositoryLabel}--${t.repositoryId}`;return`${t.worktreesRoot}/${n}/${e(t.branch)}--${t.shortId}`}function n(e){if(e.branch.trim()===``)return`A branch name is required.`;let t=e.existing.find(t=>t.branch===e.branch&&t.status!==`orphaned`);if(t)return`Branch ${e.branch} already has a worktree (${t.id}).`}function r(e){if(!e.record)return`No worktree with that id. Call list to see the current ids.`;if(e.dirtyFiles.length===0||e.force)return;let t=e.dirtyFiles.slice(0,10).join(`, `),n=e.dirtyFiles.length>10?`, and ${String(e.dirtyFiles.length-10)} more`:``;return`${String(e.dirtyFiles.length)} uncommitted file(s): ${t}${n}. Pass force: true to discard them.`}function i(e,t){let n=[];return{records:e.map(e=>e.status===`orphaned`||t.exists(e.path)&&t.alive(e)?e:(n.push(e.id),{...e,status:`orphaned`})),changed:n}}function a(e){let t={remove:[],forget:[],untracked:[],keptDirty:[]},n=new Set(e.records.map(e=>e.path)),r=new Set(e.gitPaths);for(let n of e.records)if(n.status===`orphaned`){if(!r.has(n.path)){t.forget.push(n);continue}if((e.dirtyByPath.get(n.path)??[]).length>0){t.keptDirty.push(n);continue}t.remove.push(n)}for(let r of e.gitPaths)r.startsWith(`${e.worktreesRoot}/`)&&!n.has(r)&&t.untracked.push(r);return t}exports.branchSlug=e,exports.planPrune=a,exports.reconcile=i,exports.refuseClose=r,exports.refuseSpawn=n,exports.worktreeDirectory=t;
+//# sourceMappingURL=worktreeNaming.cjs.map

package/dist/services/worktreeNaming.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktreeNaming.cjs","names":[],"sources":["../../src/services/worktreeNaming.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.ts';\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\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: [] };\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":"AAmBA,SAAgB,EAAW,EAAwB,CACjD,IAAM,EAAO,EACV,YAAY,CAAC,CACb,QAAQ,eAAgB,GAAG,CAAC,CAC5B,QAAQ,YAAa,EAAE,CAAC,CACxB,MAAM,EAAG,EAAe,CAAC,CACzB,QAAQ,QAAS,EAAE,EACtB,OAAO,IAAS,GAAK,WAAa,CACpC,CAQA,SAAgB,EAAkB,EAMvB,CACT,IAAM,EAAa,GAAG,EAAM,gBAAgB,IAAI,EAAM,eACtD,MAAO,GAAG,EAAM,cAAc,GAAG,EAAW,GAAG,EAAW,EAAM,MAAM,EAAE,IAAI,EAAM,SACpF,CAGA,SAAgB,EAAY,EAAoF,CAC9G,GAAI,EAAM,OAAO,KAAK,IAAM,GAAI,MAAO,6BAGvC,IAAM,EAAO,EAAM,SAAS,KAAM,GAAW,EAAO,SAAW,EAAM,QAAU,EAAO,SAAW,UAAU,EAC3G,GAAI,EAAM,MAAO,UAAU,EAAM,OAAO,2BAA2B,EAAK,GAAG,GAE7E,CAGA,SAAgB,EAAY,EAIL,CACrB,GAAI,CAAC,EAAM,OAAQ,MAAO,8DAC1B,GAAI,EAAM,WAAW,SAAW,GAAK,EAAM,MAAO,OAIlD,IAAM,EAAQ,EAAM,WAAW,MAAM,EAAG,EAAE,CAAC,CAAC,KAAK,IAAI,EAC/C,EAAO,EAAM,WAAW,OAAS,GAAK,SAAS,OAAO,EAAM,WAAW,OAAS,EAAE,EAAE,OAAS,GACnG,MAAO,GAAG,OAAO,EAAM,WAAW,MAAM,EAAE,wBAAwB,IAAQ,EAAK,oCACjF,CAeA,SAAgB,EACd,EACA,EACgB,CAChB,IAAM,EAAoB,CAAC,EAQ3B,MAAO,CAAE,QAPI,EAAQ,IAAK,GACpB,EAAO,SAAW,YACR,EAAM,OAAO,EAAO,IAAI,GAAM,EAAM,MAAM,CAAM,EAC5C,GAClB,EAAQ,KAAK,EAAO,EAAE,EACf,CAAE,GAAG,EAAQ,OAAQ,UAAoB,EAE7B,EAAG,SAAQ,CAClC,CAmBA,SAAgB,EAAU,EAKZ,CACZ,IAAM,EAAkB,CAAE,OAAQ,CAAC,EAAG,OAAQ,CAAC,EAAG,UAAW,CAAC,EAAG,UAAW,CAAC,CAAE,EACzE,EAAQ,IAAI,IAAI,EAAM,QAAQ,IAAK,GAAW,EAAO,IAAI,CAAC,EAC1D,EAAS,IAAI,IAAI,EAAM,QAAQ,EACrC,IAAK,IAAM,KAAU,EAAM,QACrB,KAAO,SAAW,WACtB,IAAI,CAAC,EAAO,IAAI,EAAO,IAAI,EAAG,CAC5B,EAAK,OAAO,KAAK,CAAM,EACvB,QACF,CACA,IAAK,EAAM,YAAY,IAAI,EAAO,IAAI,GAAK,CAAC,EAAA,CAAG,OAAS,EAAG,CACzD,EAAK,UAAU,KAAK,CAAM,EAC1B,QACF,CACA,EAAK,OAAO,KAAK,CAAM,CALvB,CAOF,IAAK,IAAM,KAAQ,EAAM,SAGnB,EAAK,WAAW,GAAG,EAAM,cAAc,EAAE,GAAK,CAAC,EAAM,IAAI,CAAI,GAAG,EAAK,UAAU,KAAK,CAAI,EAE9F,OAAO,CACT"}

package/dist/services/worktreeNaming.d.cts

@@ -0,0 +1,27 @@
+import { WorktreeRecord } from "../types/worktreeRegistry.cjs";
+//#region src/services/worktreeNaming.d.ts
+interface PrunePlan {
+  /** Orphans whose directory git still lists, safe to remove. */
+  remove: WorktreeRecord[];
+  /** Orphans whose directory is already gone; drop the record only. */
+  forget: WorktreeRecord[];
+  /** Paths git lists under our root that we have no record of; report, never touch. */
+  untracked: string[];
+  /** Orphans left alone because they still hold uncommitted work. */
+  keptDirty: WorktreeRecord[];
+}
+/**
+ * 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.
+ */
+declare function planPrune(input: {
+  records: readonly WorktreeRecord[];
+  gitPaths: readonly string[];
+  worktreesRoot: string;
+  dirtyByPath: ReadonlyMap<string, readonly string[]>;
+}): PrunePlan;
+//#endregion
+export { PrunePlan, planPrune };
+//# sourceMappingURL=worktreeNaming.d.cts.map

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

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

package/dist/services/worktreeNaming.d.mts

@@ -0,0 +1,27 @@
+import { WorktreeRecord } from "../types/worktreeRegistry.mjs";
+//#region src/services/worktreeNaming.d.ts
+interface PrunePlan {
+  /** Orphans whose directory git still lists, safe to remove. */
+  remove: WorktreeRecord[];
+  /** Orphans whose directory is already gone; drop the record only. */
+  forget: WorktreeRecord[];
+  /** Paths git lists under our root that we have no record of; report, never touch. */
+  untracked: string[];
+  /** Orphans left alone because they still hold uncommitted work. */
+  keptDirty: WorktreeRecord[];
+}
+/**
+ * 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.
+ */
+declare function planPrune(input: {
+  records: readonly WorktreeRecord[];
+  gitPaths: readonly string[];
+  worktreesRoot: string;
+  dirtyByPath: ReadonlyMap<string, readonly string[]>;
+}): PrunePlan;
+//#endregion
+export { PrunePlan, planPrune };
+//# sourceMappingURL=worktreeNaming.d.mts.map

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

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

package/dist/services/worktreeNaming.mjs

@@ -0,0 +1,2 @@
+function e(e){let t=e.toLowerCase().replace(/[^a-z0-9]+/gu,`-`).replace(/^-+|-+$/gu,``).slice(0,64).replace(/-+$/gu,``);return t===``?`worktree`:t}function t(t){let n=`${t.repositoryLabel}--${t.repositoryId}`;return`${t.worktreesRoot}/${n}/${e(t.branch)}--${t.shortId}`}function n(e){if(e.branch.trim()===``)return`A branch name is required.`;let t=e.existing.find(t=>t.branch===e.branch&&t.status!==`orphaned`);if(t)return`Branch ${e.branch} already has a worktree (${t.id}).`}function r(e){if(!e.record)return`No worktree with that id. Call list to see the current ids.`;if(e.dirtyFiles.length===0||e.force)return;let t=e.dirtyFiles.slice(0,10).join(`, `),n=e.dirtyFiles.length>10?`, and ${String(e.dirtyFiles.length-10)} more`:``;return`${String(e.dirtyFiles.length)} uncommitted file(s): ${t}${n}. Pass force: true to discard them.`}function i(e,t){let n=[];return{records:e.map(e=>e.status===`orphaned`||t.exists(e.path)&&t.alive(e)?e:(n.push(e.id),{...e,status:`orphaned`})),changed:n}}function a(e){let t={remove:[],forget:[],untracked:[],keptDirty:[]},n=new Set(e.records.map(e=>e.path)),r=new Set(e.gitPaths);for(let n of e.records)if(n.status===`orphaned`){if(!r.has(n.path)){t.forget.push(n);continue}if((e.dirtyByPath.get(n.path)??[]).length>0){t.keptDirty.push(n);continue}t.remove.push(n)}for(let r of e.gitPaths)r.startsWith(`${e.worktreesRoot}/`)&&!n.has(r)&&t.untracked.push(r);return t}export{e as branchSlug,a as planPrune,i as reconcile,r as refuseClose,n as refuseSpawn,t as worktreeDirectory};
+//# sourceMappingURL=worktreeNaming.mjs.map

package/dist/services/worktreeNaming.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktreeNaming.mjs","names":[],"sources":["../../src/services/worktreeNaming.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.ts';\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\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: [] };\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":"AAmBA,SAAgB,EAAW,EAAwB,CACjD,IAAM,EAAO,EACV,YAAY,CAAC,CACb,QAAQ,eAAgB,GAAG,CAAC,CAC5B,QAAQ,YAAa,EAAE,CAAC,CACxB,MAAM,EAAG,EAAe,CAAC,CACzB,QAAQ,QAAS,EAAE,EACtB,OAAO,IAAS,GAAK,WAAa,CACpC,CAQA,SAAgB,EAAkB,EAMvB,CACT,IAAM,EAAa,GAAG,EAAM,gBAAgB,IAAI,EAAM,eACtD,MAAO,GAAG,EAAM,cAAc,GAAG,EAAW,GAAG,EAAW,EAAM,MAAM,EAAE,IAAI,EAAM,SACpF,CAGA,SAAgB,EAAY,EAAoF,CAC9G,GAAI,EAAM,OAAO,KAAK,IAAM,GAAI,MAAO,6BAGvC,IAAM,EAAO,EAAM,SAAS,KAAM,GAAW,EAAO,SAAW,EAAM,QAAU,EAAO,SAAW,UAAU,EAC3G,GAAI,EAAM,MAAO,UAAU,EAAM,OAAO,2BAA2B,EAAK,GAAG,GAE7E,CAGA,SAAgB,EAAY,EAIL,CACrB,GAAI,CAAC,EAAM,OAAQ,MAAO,8DAC1B,GAAI,EAAM,WAAW,SAAW,GAAK,EAAM,MAAO,OAIlD,IAAM,EAAQ,EAAM,WAAW,MAAM,EAAG,EAAE,CAAC,CAAC,KAAK,IAAI,EAC/C,EAAO,EAAM,WAAW,OAAS,GAAK,SAAS,OAAO,EAAM,WAAW,OAAS,EAAE,EAAE,OAAS,GACnG,MAAO,GAAG,OAAO,EAAM,WAAW,MAAM,EAAE,wBAAwB,IAAQ,EAAK,oCACjF,CAeA,SAAgB,EACd,EACA,EACgB,CAChB,IAAM,EAAoB,CAAC,EAQ3B,MAAO,CAAE,QAPI,EAAQ,IAAK,GACpB,EAAO,SAAW,YACR,EAAM,OAAO,EAAO,IAAI,GAAM,EAAM,MAAM,CAAM,EAC5C,GAClB,EAAQ,KAAK,EAAO,EAAE,EACf,CAAE,GAAG,EAAQ,OAAQ,UAAoB,EAE7B,EAAG,SAAQ,CAClC,CAmBA,SAAgB,EAAU,EAKZ,CACZ,IAAM,EAAkB,CAAE,OAAQ,CAAC,EAAG,OAAQ,CAAC,EAAG,UAAW,CAAC,EAAG,UAAW,CAAC,CAAE,EACzE,EAAQ,IAAI,IAAI,EAAM,QAAQ,IAAK,GAAW,EAAO,IAAI,CAAC,EAC1D,EAAS,IAAI,IAAI,EAAM,QAAQ,EACrC,IAAK,IAAM,KAAU,EAAM,QACrB,KAAO,SAAW,WACtB,IAAI,CAAC,EAAO,IAAI,EAAO,IAAI,EAAG,CAC5B,EAAK,OAAO,KAAK,CAAM,EACvB,QACF,CACA,IAAK,EAAM,YAAY,IAAI,EAAO,IAAI,GAAK,CAAC,EAAA,CAAG,OAAS,EAAG,CACzD,EAAK,UAAU,KAAK,CAAM,EAC1B,QACF,CACA,EAAK,OAAO,KAAK,CAAM,CALvB,CAOF,IAAK,IAAM,KAAQ,EAAM,SAGnB,EAAK,WAAW,GAAG,EAAM,cAAc,EAAE,GAAK,CAAC,EAAM,IAAI,CAAI,GAAG,EAAK,UAAU,KAAK,CAAI,EAE9F,OAAO,CACT"}

package/dist/types/extension.d.cts

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

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

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

package/dist/types/extension.d.mts

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

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

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

package/dist/types/webWorktrees.cjs

@@ -0,0 +1,2 @@
+exports.GIT_WORKTREES_TYPE=`git_worktrees`;
+//# sourceMappingURL=webWorktrees.cjs.map

package/dist/types/webWorktrees.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webWorktrees.cjs","names":[],"sources":["../../src/types/webWorktrees.ts"],"sourcesContent":["/**\n * The cockpit's view of this session's worktrees.\n *\n * DESIGN PATTERNS:\n * - Declarations only. The channel frame type is a constant so the hub and the\n *   page cannot drift apart on a string.\n * - A view is the subset of a record the dock needs, not the record. The\n *   registry may hold paths and provenance the page has no business rendering.\n *\n * AVOID:\n * - Adding behaviour here. This file is imported by browser code, so it must\n *   stay free of node builtins.\n */\n\n/** The data channel carrying one session's worktrees to the page. */\nexport const GIT_WORKTREES_TYPE = 'git_worktrees';\n\n/** One worktree, as the activity dock and its panel render it. */\nexport interface WorktreeView {\n  id: string;\n  branch: string;\n  path: string;\n  /** The session the hub started for this worktree, when it is still live. */\n  sessionId: string | null;\n  /** True once the directory the record names has gone missing. */\n  orphaned: boolean;\n}\n\nexport interface GitWorktreesPayload {\n  worktrees: WorktreeView[];\n}\n"],"mappings":""}

package/dist/types/webWorktrees.mjs

@@ -0,0 +1,2 @@
+const e=`git_worktrees`;export{e as GIT_WORKTREES_TYPE};
+//# sourceMappingURL=webWorktrees.mjs.map

package/dist/types/webWorktrees.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webWorktrees.mjs","names":[],"sources":["../../src/types/webWorktrees.ts"],"sourcesContent":["/**\n * The cockpit's view of this session's worktrees.\n *\n * DESIGN PATTERNS:\n * - Declarations only. The channel frame type is a constant so the hub and the\n *   page cannot drift apart on a string.\n * - A view is the subset of a record the dock needs, not the record. The\n *   registry may hold paths and provenance the page has no business rendering.\n *\n * AVOID:\n * - Adding behaviour here. This file is imported by browser code, so it must\n *   stay free of node builtins.\n */\n\n/** The data channel carrying one session's worktrees to the page. */\nexport const GIT_WORKTREES_TYPE = 'git_worktrees';\n\n/** One worktree, as the activity dock and its panel render it. */\nexport interface WorktreeView {\n  id: string;\n  branch: string;\n  path: string;\n  /** The session the hub started for this worktree, when it is still live. */\n  sessionId: string | null;\n  /** True once the directory the record names has gone missing. */\n  orphaned: boolean;\n}\n\nexport interface GitWorktreesPayload {\n  worktrees: WorktreeView[];\n}\n"],"mappings":"AAeA,MAAa,EAAqB"}

package/dist/types/worktreeRegistry.d.cts

@@ -0,0 +1,41 @@
+//#region src/types/worktreeRegistry.d.ts
+/**
+ * The worktree registry: what this package knows about the worktrees it made.
+ *
+ * It deliberately does not mirror `git worktree list`. Git knows which
+ * worktrees exist; only this registry knows which of them this package created,
+ * which session runs in each, and which process to signal. Reconciling the two
+ * is how orphans are found, so the two views are kept separate on purpose.
+ */
+/**
+ * A worktree's lifecycle as this package sees it.
+ *
+ * `orphaned` is a finding, not a cleanup: the session process is gone or the
+ * directory has vanished, but the worktree may still hold uncommitted work, so
+ * the record is kept until someone decides what to do with it.
+ */
+type WorktreeStatus = 'spawning' | 'running' | 'closing' | 'orphaned';
+declare const WORKTREE_RECORD_VERSION = 1;
+interface WorktreeRecord {
+  version: typeof WORKTREE_RECORD_VERSION;
+  /** This registry's own id, distinct from the session id, and stable across restarts. */
+  id: string;
+  /** The branch checked out in the worktree. */
+  branch: string;
+  /** The ref the branch was created from, kept so a merge can name its base. */
+  baseRef: string;
+  /** Absolute path to the worktree directory. */
+  path: string;
+  /** Absolute path to the repository the worktree belongs to. */
+  repositoryRoot: string;
+  /** The session spawned into the worktree. */
+  sessionId: string;
+  /** The session that asked for the worktree; the rail nests one under the other. */
+  parentSessionId: string;
+  status: WorktreeStatus;
+  /** ISO 8601. */
+  createdAt: string;
+}
+//#endregion
+export { WORKTREE_RECORD_VERSION, WorktreeRecord, WorktreeStatus };
+//# sourceMappingURL=worktreeRegistry.d.cts.map

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

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

package/dist/types/worktreeRegistry.d.mts

@@ -0,0 +1,41 @@
+//#region src/types/worktreeRegistry.d.ts
+/**
+ * The worktree registry: what this package knows about the worktrees it made.
+ *
+ * It deliberately does not mirror `git worktree list`. Git knows which
+ * worktrees exist; only this registry knows which of them this package created,
+ * which session runs in each, and which process to signal. Reconciling the two
+ * is how orphans are found, so the two views are kept separate on purpose.
+ */
+/**
+ * A worktree's lifecycle as this package sees it.
+ *
+ * `orphaned` is a finding, not a cleanup: the session process is gone or the
+ * directory has vanished, but the worktree may still hold uncommitted work, so
+ * the record is kept until someone decides what to do with it.
+ */
+type WorktreeStatus = 'spawning' | 'running' | 'closing' | 'orphaned';
+declare const WORKTREE_RECORD_VERSION = 1;
+interface WorktreeRecord {
+  version: typeof WORKTREE_RECORD_VERSION;
+  /** This registry's own id, distinct from the session id, and stable across restarts. */
+  id: string;
+  /** The branch checked out in the worktree. */
+  branch: string;
+  /** The ref the branch was created from, kept so a merge can name its base. */
+  baseRef: string;
+  /** Absolute path to the worktree directory. */
+  path: string;
+  /** Absolute path to the repository the worktree belongs to. */
+  repositoryRoot: string;
+  /** The session spawned into the worktree. */
+  sessionId: string;
+  /** The session that asked for the worktree; the rail nests one under the other. */
+  parentSessionId: string;
+  status: WorktreeStatus;
+  /** ISO 8601. */
+  createdAt: string;
+}
+//#endregion
+export { WORKTREE_RECORD_VERSION, WorktreeRecord, WorktreeStatus };
+//# sourceMappingURL=worktreeRegistry.d.mts.map

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

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

package/dist/webHub.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./adapters/web/worktreesChannel.cjs");exports.createWorktreesChannel=e.createWorktreesChannel,exports.webHubChannels=e.webHubChannels;

package/dist/webHub.d.cts

@@ -0,0 +1,2 @@
+import { createWorktreesChannel, webHubChannels } from "./adapters/web/worktreesChannel.cjs";
+export { createWorktreesChannel, webHubChannels };

package/dist/webHub.d.mts

@@ -0,0 +1,2 @@
+import { createWorktreesChannel, webHubChannels } from "./adapters/web/worktreesChannel.mjs";
+export { createWorktreesChannel, webHubChannels };

package/dist/webHub.mjs

@@ -0,0 +1 @@
+import{createWorktreesChannel as e,webHubChannels as t}from"./adapters/web/worktreesChannel.mjs";export{e as createWorktreesChannel,t as webHubChannels};

package/llms.txt

@@ -0,0 +1,11 @@
+# @agimon-ai/doompi-git
+
+Package-owned guidance for Git worktree sessions for DoomPi: spawn an isolated worktree with its own session and manage it from the parent
+
+## How to use
+
+- [Use Git](./src/prompts/doompi-use-git/SKILL.md): Run the package command and follow its package-specific usage guidance.
+
+## Resources
+
+- [Package README](./README.md): Installation, development commands, Pi entrypoint, and extension-specific usage.

package/package.json

@@ -0,0 +1,128 @@
+{
+  "name": "@agimon-ai/doompi-git",
+  "version": "0.0.1-alpha.0",
+  "description": "Git worktree sessions for DoomPi: spawn an isolated worktree with its own session and manage it from the parent",
+  "keywords": [
+    "coding-agent",
+    "doompi",
+    "git-worktree",
+    "pi-coding-agent",
+    "pi-extension",
+    "pi-package",
+    "typescript"
+  ],
+  "homepage": "https://agimon.ai",
+  "bugs": {
+    "url": "https://github.com/AgiFlow/doompi/issues"
+  },
+  "license": "MIT",
+  "author": "Vuong Ngo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgiFlow/doompi.git",
+    "directory": "layers/source-control/doompi-git"
+  },
+  "files": [
+    "LICENSE",
+    "README.md",
+    "dist",
+    "llms.txt",
+    "package.json",
+    "src/exports/webClient.ts",
+    "src/prompts",
+    "src/types/webWorktrees.ts",
+    "src/types/worktreeRegistry.ts",
+    "src/web"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.mts",
+  "jsnext:main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./api/git": {
+      "types": "./dist/hubApi.d.mts",
+      "import": "./dist/hubApi.mjs",
+      "require": "./dist/hubApi.cjs"
+    },
+    "./extensions/pi": {
+      "types": "./dist/extensions/pi.d.mts",
+      "import": "./dist/extensions/pi.mjs",
+      "require": "./dist/extensions/pi.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@deepseek-ai/cordis": "4.0.2",
+    "@tanstack/react-store": "0.11.1",
+    "@tanstack/store": "0.11.1",
+    "typebox": "1.3.19",
+    "@agimon-ai/doompi-web-components": "0.0.1-alpha.23",
+    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.63",
+    "@agimon-ai/doompi-web-contracts": "0.0.1-alpha.26"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-agent-core": "0.85.1",
+    "@earendil-works/pi-coding-agent": "0.85.1",
+    "@types/node": "26.2.0",
+    "@types/react": "19.2.18",
+    "@vitest/coverage-v8": "5.0.0",
+    "react": "19.2.8",
+    "tsdown": "0.22.14",
+    "typescript": "7.0.2",
+    "vitest": "5.0.0",
+    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.1-alpha.60"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-agent-core": "0.85.1",
+    "@earendil-works/pi-coding-agent": "0.85.1"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-agent-core": {
+      "optional": true
+    },
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "doompiApi": {
+    "basePath": "git",
+    "hub": {
+      "entry": "./src/exports/hubApi.ts",
+      "dist": "./dist/hubApi.mjs"
+    }
+  },
+  "doompiWeb": {
+    "pluginId": "git",
+    "channels": [
+      "git_worktrees"
+    ],
+    "client": "./src/exports/webClient.ts",
+    "hub": {
+      "entry": "./src/exports/webHub.ts",
+      "dist": "./dist/webHub.mjs"
+    }
+  },
+  "pi": {
+    "extensions": [
+      "./dist/extensions/pi.mjs"
+    ]
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint . && oxfmt . --check",
+    "fixcode": "oxlint . --fix && oxfmt ."
+  }
+}

package/src/exports/webClient.ts

@@ -0,0 +1 @@
+export { webPlugin } from '../web/index.ts';

package/src/prompts/doompi-use-git/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: doompi-use-git
+description: 'Use @agimon-ai/doompi-git: Git worktree sessions for DoomPi: spawn an isolated worktree with its own session and manage it from the parent'
+---
+
+# Worktree sessions
+
+`run_worktree` creates a git worktree and starts a DoomPi session inside it. The
+new session appears nested under the current one in the SESSIONS rail, so a
+parent can hand off a branch of work and keep its own checkout untouched.
+
+Worktrees live outside the repository, under `~/.pi/.doom/git/worktrees`. That
+is deliberate: a worktree inside the repository resolves workspace imports to
+the parent checkout and silently builds the wrong code.
+
+## When to use it
+
+Use a worktree when work needs its own branch **and** its own checkout at the
+same time: a long refactor you want to leave half-finished, a risky migration,
+or two features that touch the same files. A worktree costs a full install in
+the new directory, so it is the wrong tool for a quick edit; just edit.
+
+Do not reach for it to parallelise work that shares a branch. Two sessions on
+one branch in two checkouts will fight, and git refuses the second worktree.
+
+## Actions
+
+```
+run_worktree { action: 'spawn_worktree', branch: 'wt/fix-auth' }
+run_worktree { action: 'list' }
+run_worktree { action: 'status', id: 'a1b2c3d4' }
+run_worktree { action: 'merge', id: 'a1b2c3d4' }
+run_worktree { action: 'close_worktree', id: 'a1b2c3d4' }
+run_worktree { action: 'prune', dryRun: true }
+```
+
+`spawn_worktree` takes `branch`, and optionally `baseRef` (defaults to the
+current branch), `name` for the rail, and `task` as the session's first message.
+Every other action identifies a worktree by the short `id` that `list` prints,
+never by path or branch.
+
+## What it refuses, and why
+
+- **`close_worktree` on a dirty tree.** It names the uncommitted files and stops.
+  Pass `force: true` only after reading that list. The files are gone after.
+- **`merge` when the parent checkout is dirty.** The merge lands in the parent,
+  so uncommitted edits there would be folded into a merge commit nobody meant to
+  make. Commit or stash first.
+- **`spawn_worktree` on a branch that already has a worktree.** Close the
+  existing one or pick another branch.
+- **`prune` never deletes a worktree holding uncommitted work**, and never
+  touches a directory this tool did not create. It reports those instead.
+
+Run `prune` with `dryRun: true` first. The plan tells you exactly what would be
+removed, forgotten, and left alone.
+
+## Notes
+
+- A worktree session is a peer, not a subagent. It has its own context and its
+  own turn loop, and it does not report back when it finishes.
+- Closing the parent does not close its worktree sessions. They keep running and
+  stay in the rail.
+- `spawn_worktree` needs the cockpit running, because the cockpit owns session
+  lifecycle. Without it the tool says so rather than half-creating anything.