@dsh-cc/tool-git-worktree 0.5.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/workspace/tool-git-worktree/README.md
+README.md: b9e39859c338cb70b6339a6d15361aded783d288
+README.zh.md: 66232faaee6cc48bb10aaef0977af9e88b92a766

package/README.md

@@ -0,0 +1,49 @@
+# @dsh-cc/tool-git-worktree
+
+English | [中文](README.zh.md)
+
+Model-facing `EnterWorktree` / `ExitWorktree` tools that create, keep, and remove isolated git worktrees under `<repo>/.claude/worktrees/`. They run every git command through the `ctx.shell` executor seam (resolve then run — never a direct spawn) and validate every path they act on stays inside the repository through `ctx.fs`.
+
+Requires a loaded shell executor Service Provider (e.g. `@deepseek-ai/dsh-bash-local`), a filesystem provider (`@deepseek-ai/dsh-fs-local`), `ctx.tools`, and `ctx.systemPrompt`. The plugin stays pending until `inject: ['tools', 'shell', 'systemPrompt', 'fs']` is satisfied.
+
+## Tools
+
+### `EnterWorktree`
+
+Creates a worktree on a fresh `worktree-<name>` branch from HEAD and switches the session into it.
+
+| Arg | Type | Notes |
+|---|---|---|
+| `name` | string | Worktree slug. Each `/`-separated segment allows letters, digits, `.`, `_`, `-`; max 64 chars. A random `adjective-noun-suffix` slug is generated when omitted. |
+
+The tool locates the repository root from the calling agent's session cwd (`git rev-parse --show-toplevel`); outside a git working tree it returns a structured error rather than changing anything. Because the session working directory is fixed at session creation in this harness, the cwd switch is declared two ways that are safe given the immutable session cwd: the tool result and a `tool:worktree:cwd` systemPrompt runtime context both state the new working directory, and the model is told to pass `workdir` equal to the reported `worktreePath` for subsequent shell and fs calls. The pre-release-state choice is recorded in the [git-worktree-tools Agent Note](../../../.agents/notes/implemented/feature/2026-08-14-git-worktree-tools.md).
+
+### `ExitWorktree`
+
+Leaves the active EnterWorktree session and returns to the original directory.
+
+| Arg | Type | Notes |
+|---|---|---|
+| `action` | `"keep"` \| `"remove"` | `keep` leaves the worktree and branch on disk; `remove` deletes both (destructive). |
+| `discard_changes` | boolean | Required `true` with `action: "remove"` when the worktree has uncommitted files or commits not on the base branch; the tool refuses and lists the evidence otherwise. |
+
+`ExitWorktree` only operates on worktrees created by `EnterWorktree` in the current session: it is a no-op otherwise and never touches manually-created or previous-session worktrees. Before a `remove` it probes `git status --porcelain` and `git rev-list --count <base>..HEAD` and **fails closed** — if the state cannot be verified it refuses without `discard_changes: true`, so a silent 0/0 can never destroy real work.
+
+## Safety
+
+- Both tools are `isConcurrencySafe = () => false`; they must not overlap other tools.
+- `ExitWorktree` with `action: "remove"` is destructive (deletes the worktree directory and its branch); with uncommitted or unmerged work it requires the explicit `discard_changes: true` grant. dsh-tools has no dedicated `isDestructive` field, so destructiveness is expressed in the human-readable tool description and the `remove`-vs-`keep` call presentation.
+- Every on-disk path is validated to stay inside the repository's `.claude/worktrees/` directory before any git command runs.
+
+## Git command construction
+
+All git commands are built in one module (`src/worktree.ts`) as `{ command, workdir, label }` opaque values that the tools hand to `ctx.shell`. This is the seam a future pure-JS git implementation would replace; tool code never interpolates git argument lists itself.
+
+## UI presentation
+
+`EnterWorktree` and `ExitWorktree` own their `presentCall`/`presentResult` render intent as generic cards. `presentCall` is a pure function of the arguments (an `EnterWorktree` call names the worktree; an `ExitWorktree` call distinguishes `remove` (destructive) from `keep` in its title and content). `presentResult` shows a plain message on success and fenced text on error; a `diff` card is not used because a worktree exit has no textual diff to render.
+
+## Known limitations
+
+- The session cwd is immutable, so the worktree switch is expressed through the declared cwd and the systemPrompt runtime context rather than a true per-session cwd mutation; subsequent shell/fs calls must pass `workdir`.
+- The active worktree session is a process-wide singleton (mirroring the claude-code reference), so one process has at most one active worktree at a time.

package/README.zh.md

@@ -0,0 +1,49 @@
+# @dsh-cc/tool-git-worktree
+
+[English](README.md) | 中文
+
+模型侧 `EnterWorktree` / `ExitWorktree` 工具：在 `<仓库>/.claude/worktrees/` 下创建、保留、删除隔离的 git worktree。所有 git 命令都经 `ctx.shell` 执行器 seam 运行（先 resolve 再 run——绝不直接 spawn），并用 `ctx.fs` 校验每个要操作的路径都在仓库内。
+
+需要加载 shell 执行器 Service Provider（例如 `@deepseek-ai/dsh-bash-local`）、文件系统 Provider（`@deepseek-ai/dsh-fs-local`）、`ctx.tools` 与 `ctx.systemPrompt`。在 `inject: ['tools', 'shell', 'systemPrompt', 'fs']` 满足之前，插件保持等待状态。
+
+## 工具
+
+### `EnterWorktree`
+
+基于 HEAD 在新建的 `worktree-<name>` 分支上创建 worktree，并将会话切换到其中。
+
+| 参数 | 类型 | 说明 |
+|---|---|---|
+| `name` | string | worktree slug。每个以 `/` 分隔的段只允许字母、数字、`.`、`_`、`-`；最长 64 字符。省略时自动生成 `形容词-名词-后缀` 随机 slug。 |
+
+工具从调用方 agent 的会话 cwd 定位仓库根（`git rev-parse --show-toplevel`）；不在 git 工作树内时返回结构化错误而不做任何更改。由于本 harness 中会话工作目录在创建时即固定，cwd 切换通过两种对不可变会话 cwd 安全的方式进行声明：工具结果与 `tool:worktree:cwd` systemPrompt 运行时上下文都会声明新的工作目录，并告知模型后续 shell/fs 调用需传入与返回的 `worktreePath` 相同的 `workdir`。pre-release 状态下的取舍记录在 [git-worktree-tools Agent Note](../../../.agents/notes/implemented/feature/2026-08-14-git-worktree-tools.md)。
+
+### `ExitWorktree`
+
+退出当前 EnterWorktree 会话并返回原目录。
+
+| 参数 | 类型 | 说明 |
+|---|---|---|
+| `action` | `"keep"` \| `"remove"` | `keep` 在磁盘上保留 worktree 与分支；`remove` 删除两者（破坏性）。 |
+| `discard_changes` | boolean | 当 `action: "remove"` 且 worktree 有未提交文件或不在基准分支上的提交时必须为 `true`；否则工具拒绝并列出证据。 |
+
+`ExitWorktree` 只操作当前会话中由 `EnterWorktree` 创建的 worktree：否则为 no-op，绝不触碰手动创建或先前会话的 worktree。执行 `remove` 前会用 `git status --porcelain` 与 `git rev-list --count <base>..HEAD` 探测状态并**失败即关闭（fail closed）**——若状态无法核实，则没有 `discard_changes: true` 就拒绝，从而绝不让静默的 0/0 摧毁真实工作。
+
+## 安全
+
+- 两个工具都为 `isConcurrencySafe = () => false`；不得与其他工具重叠。
+- `ExitWorktree` 且 `action: "remove"` 具有破坏性（删除 worktree 目录及其分支）；存在未提交或未合并工作时需要显式 `discard_changes: true` 许可。dsh-tools 没有专门的 `isDestructive` 字段，因此破坏性体现在人读的工具描述以及 `remove` 与 `keep` 的调用呈现区别中。
+- 每个磁盘路径在运行任何 git 命令前都会校验仍位于仓库的 `.claude/worktrees/` 目录内。
+
+## Git 命令构造
+
+所有 git 命令都在一个模块（`src/worktree.ts`）中构建为 `{ command, workdir, label }` 不透明值，交给 `ctx.shell`。这是未来替换为纯 JS git 实现的 seam；工具代码绝不自拼 git 参数列表。
+
+## UI 呈现
+
+`EnterWorktree` 与 `ExitWorktree` 拥有各自的 `presentCall`/`presentResult` 呈现意图，均为 generic 卡片。`presentCall` 是参数的纯函数（`EnterWorktree` 调用指明 worktree 名；`ExitWorktree` 调用在标题与内容中区分 `remove`（破坏性）与 `keep`）。`presentResult` 成功时显示普通消息、出错时显示围栏文本；不使用 `diff` 卡片，因为退出 worktree 没有可渲染的文本差异。
+
+## 已知限制
+
+- 会话 cwd 不可变，因此 worktree 切换通过声明的 cwd 与 systemPrompt 运行时上下文表达，而非真正的按会话 cwd 修改；后续 shell/fs 调用必须传入 `workdir`。
+- 活跃 worktree 会话是进程级单例（对应 claude-code 参考实现），因此一个进程任一时刻最多只有一个活跃 worktree。

package/lib/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Model-facing `EnterWorktree` / `ExitWorktree` tools over the `ctx.shell`
+ * executor seam. EnterWorktree creates an isolated git worktree under
+ * `<repo>/.claude/worktrees/` and declares the cwd switch; ExitWorktree keeps
+ * or removes it after a fail-closed safety gate. Software is `git` today, but
+ * every command is constructed in one module so a pure-JS git backend can
+ * replace it later.
+ * @module @dsh-cc/tool-git-worktree
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+export declare const name = "tool-git-worktree";
+export declare const inject: string[];
+/** Runtime configuration for the git-worktree tools. */
+export interface Config {
+    /** Whether `EnterWorktree` may create worktrees (default true). */
+    enableEnterWorktree?: boolean;
+    /** Whether `ExitWorktree` may remove worktrees (default true). */
+    enableExitWorktree?: boolean;
+}
+/** Runtime configuration schema. */
+export declare const Config: z<Config>;
+export declare function apply(ctx: Context, config?: Config): void;
+export { validateSlug, worktreeBranch, worktreePathFor, randomSlug, flattenSlug } from './worktree.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AA4BxC,eAAO,MAAM,IAAI,sBAAsB,CAAA;AACvC,eAAO,MAAM,MAAM,UAA2C,CAAA;AAE9D,wDAAwD;AACxD,MAAM,WAAW,MAAM;IACrB,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,oCAAoC;AACpC,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAG3B,CAAA;AA6JF,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,IAAI,CA+L7D;AAED,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}

package/lib/index.js

@@ -0,0 +1,330 @@
+/**
+ * Model-facing `EnterWorktree` / `ExitWorktree` tools over the `ctx.shell`
+ * executor seam. EnterWorktree creates an isolated git worktree under
+ * `<repo>/.claude/worktrees/` and declares the cwd switch; ExitWorktree keeps
+ * or removes it after a fail-closed safety gate. Software is `git` today, but
+ * every command is constructed in one module so a pure-JS git backend can
+ * replace it later.
+ * @module @dsh-cc/tool-git-worktree
+ */
+import z from '@deepseek-ai/schemastery';
+import { relative, sep } from 'node:path';
+import { defineTool, TOOL_ABORTED } from '@dsh-cc/tools';
+import { HarnessError } from '@deepseek-ai/dsh-llm';
+import { addWorktree, clearActiveWorktreeSession, commitsAhead, deleteBranch, forceRemoveWorktree, getActiveWorktreeSession, randomSlug, repoLabel, setActiveWorktreeSession, status, validateSlug, worktreeBranch, worktreePathFor, } from "./worktree.js";
+import { presentEnterCall, presentWorktreeResult, presentExitCall } from "./render.js";
+import { setSessionCwd } from '@dsh-cc/session-cwd';
+export const name = 'tool-git-worktree';
+export const inject = ['tools', 'shell', 'systemPrompt', 'fs'];
+/** Runtime configuration schema. */
+export const Config = z.object({
+    enableEnterWorktree: z.boolean().default(true),
+    enableExitWorktree: z.boolean().default(true),
+});
+/** A structured, model-visible failure (maps to an isError tool result). */
+class WorktreeError extends Error {
+}
+/**
+ * Resolve the canonical session working directory this tool operates in.
+ * Follows the bash/fs convention of reading the agent's durable session cwd,
+ * falling back to the process working directory.
+ * @param exec - the running tool call.
+ * @returns the absolute cwd, or `undefined` when none is known.
+ */
+function sessionCwd(exec) {
+    return exec.agent?.session.header.cwd;
+}
+/**
+ * Propagate a cwd change into the session-cwd plugin (WS1): a durable
+ * `worktree/entered` event plus the live overlay. Tolerant of test fakes and
+ * headless contexts whose session face lacks the append seam — the tool must
+ * not fail because a non-persistent session cannot record the move.
+ * @param exec - the running tool call.
+ * @param path - the new absolute session working directory.
+ */
+function updateSessionCwd(exec, path) {
+    const agent = exec.agent;
+    if (agent === undefined)
+        return;
+    const session = agent.session;
+    if (session === undefined || typeof session.append !== 'function')
+        return;
+    // Fail-soft: a session that cannot persist the event still completes the
+    // worktree operation; the worktree session singleton remains authoritative.
+    try {
+        setSessionCwd(agent, path);
+    }
+    catch {
+        // cwd bookkeeping is best-effort here.
+    }
+}
+/**
+ * Run one git command to completion through the `ctx.shell` seam. Resolves a
+ * fresh request (never passing an unresolved one to `run`) and maps abort /
+ * spawn failures to a structured {@link HarnessError}; a nonzero git exit
+ * resolves normally for the caller to interpret.
+ * @param ctx - the Cordis context.
+ * @param cmd - the constructed git command.
+ * @param signal - the tool-call cancellation signal.
+ * @returns the shell result, with `exitCode` nonzero representing a git-level failure.
+ */
+async function runGit(ctx, cmd, signal) {
+    const result = await ctx.shell.run(ctx.shell.resolve({
+        command: cmd.command,
+        workdir: cmd.workdir,
+        signal,
+    }));
+    if (result.aborted) {
+        const error = new HarnessError('tool call aborted', TOOL_ABORTED);
+        error.name = 'AbortError';
+        throw error;
+    }
+    return result;
+}
+/** Truncated stderr tail used to surface git failure causes in messages. */
+function gitFailure(result) {
+    return result.stderr.text.trim() || result.stdout.text.trim() || `exit code ${result.exitCode}`;
+}
+/**
+ * Assert a computed worktree path is contained by this repo's `worktrees`
+ * directory. All paths a tool will act on are validated here before any git
+ * command runs.
+ * @param ctx - the Cordis context.
+ * @param repoRoot - the canonical repository root.
+ * @param worktreePath - candidate absolute worktree path.
+ */
+async function assertPathInRepo(ctx, repoRoot, worktreePath) {
+    if (relative(repoRoot, worktreePath).startsWith(`..${sep}`)) {
+        throw new WorktreeError(`refusing worktree path outside the repository: "${worktreePath}"`);
+    }
+    const rootTarget = await ctx.fs.resolve(repoRoot);
+    const pathTarget = await ctx.fs.resolve(worktreePath);
+    if (!ctx.fs.contains(rootTarget, pathTarget)) {
+        throw new WorktreeError(`refusing worktree path outside the repository: "${worktreePath}"`);
+    }
+}
+/**
+ * Find the canonical repository root for a working directory using git. A
+ * nonzero exit means the cwd is not inside a git working tree.
+ * @param ctx - the Cordis context.
+ * @param cwd - the working directory to search from.
+ * @param signal - the tool-call cancellation signal.
+ * @returns the canonical root, or `undefined` when not a git repository.
+ */
+async function findRepoRoot(ctx, cwd, signal) {
+    const result = await runGit(ctx, { command: 'git rev-parse --show-toplevel', workdir: cwd, label: 'locate repository root' }, signal);
+    const root = result.stdout.text.trim();
+    return result.exitCode === 0 && root.length > 0 ? root : undefined;
+}
+/**
+ * Probe whether the (remove-gate) worktree currently differs from the commit it
+ * was created from, counting both uncommitted files and new commits. Returns
+ * `null` when the state cannot be determined reliably — callers treat that as
+ * "unknown, assume unsafe" (fail-closed) so a silent 0/0 can never let a remove
+ * destroy real work.
+ * @param ctx - the Cordis context.
+ * @param session - the active worktree session.
+ * @returns the change counts, or `null` when unknown.
+ */
+async function countWorktreeChanges(ctx, session, signal) {
+    const statusResult = await runGit(ctx, status(session.worktreePath), signal);
+    if (statusResult.exitCode !== 0)
+        return null;
+    const changedFiles = statusResult.stdout.text.split('\n').filter(line => line.trim() !== '').length;
+    const revResult = await runGit(ctx, commitsAhead(session.worktreePath, session.originalHead), signal);
+    if (revResult.exitCode !== 0)
+        return null;
+    const commits = parseInt(revResult.stdout.text.trim(), 10) || 0;
+    return { changedFiles, commits };
+}
+/**
+ * Register the runtime-context entry that surfaces the active worktree cwd to
+ * the model. When no worktree is active the provider contributes nothing, so
+ * the entry is inert outside an EnterWorktree session.
+ * @param ctx - the Cordis context.
+ */
+function registerWorktreeCwdContext(ctx) {
+    ctx.systemPrompt.context({
+        name: 'tool:worktree:cwd',
+        order: 120,
+        text: () => {
+            const session = getActiveWorktreeSession();
+            if (session === null)
+                return '';
+            return `Current working directory: ${session.worktreePath}`;
+        },
+    });
+}
+export function apply(ctx, config = {}) {
+    registerWorktreeCwdContext(ctx);
+    if (config.enableEnterWorktree ?? true) {
+        ctx.tools.register(defineTool({
+            name: 'EnterWorktree',
+            description: 'Creates an isolated git worktree under <repo>/.claude/worktrees/ and switches the session into it. '
+                + 'Run an uncommitted or speculative change in the worktree without touching the main working tree. '
+                + 'Because the session working directory is fixed at creation, subsequent shell and fs calls should pass '
+                + '`workdir` equal to the reported worktreePath to operate inside it; the runtime context and this result '
+                + 'both declare the current working directory. This tool is NOT concurrency-safe and must not overlap '
+                + 'other tools. Only call it when the user explicitly asks to work in a worktree.',
+            parameters: {
+                name: {
+                    type: 'string',
+                    description: 'Optional name for the worktree. Each "/"-separated segment may contain only letters, digits, dots, underscores, and dashes; max 64 chars total. A random name is generated if not provided.',
+                },
+            },
+            output: {
+                schema: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: {
+                        worktreePath: { type: 'string', required: true },
+                        worktreeBranch: { type: 'string', required: true },
+                        message: { type: 'string', required: true },
+                    },
+                },
+                render: (_args, value) => [{ type: 'text', text: value.message }],
+            },
+            isConcurrencySafe: () => false,
+            presentCall: presentEnterCall,
+            presentResult: presentWorktreeResult,
+            async execute(args, exec) {
+                const cwd = sessionCwd(exec) ?? process.cwd();
+                const repoRoot = await findRepoRoot(ctx, cwd, exec.signal);
+                if (repoRoot === undefined) {
+                    throw new WorktreeError(`cannot create a worktree: not in a git repository (cwd: ${cwd}). EnterWorktree requires a git working tree.`);
+                }
+                const slug = args.name ?? randomSlug();
+                validateSlug(slug);
+                const worktreePath = worktreePathFor(repoRoot, slug);
+                await assertPathInRepo(ctx, repoRoot, worktreePath);
+                const branch = worktreeBranch(slug);
+                const headResult = await runGit(ctx, { command: 'git rev-parse HEAD', workdir: repoRoot, label: 'resolve HEAD' }, exec.signal);
+                if (headResult.exitCode !== 0) {
+                    throw new WorktreeError(`cannot resolve repository HEAD at ${repoRoot}: ${gitFailure(headResult)}`);
+                }
+                const originalHead = headResult.stdout.text.trim();
+                const create = await runGit(ctx, addWorktree(repoRoot, slug), exec.signal);
+                if (create.exitCode !== 0) {
+                    throw new WorktreeError(`failed to create worktree: ${gitFailure(create)}`);
+                }
+                setActiveWorktreeSession({ originalCwd: cwd, repoRoot, worktreePath, worktreeBranch: branch, originalHead });
+                updateSessionCwd(exec, worktreePath);
+                return {
+                    worktreePath,
+                    worktreeBranch: branch,
+                    message: `Created worktree at ${worktreePath} on branch ${branch} in ${repoLabel(repoRoot)}. `
+                        + `The session's working directory is now the worktree; pass \`workdir: ${worktreePath}\` to shell and fs calls. `
+                        + 'Use ExitWorktree to leave it (keep or remove).',
+                };
+            },
+        }));
+    }
+    if (config.enableExitWorktree ?? true) {
+        ctx.tools.register(defineTool({
+            name: 'ExitWorktree',
+            description: 'Leaves a worktree session created by EnterWorktree and returns the session to its original directory. '
+                + 'This tool ONLY operates on worktrees created by EnterWorktree in this session; it never touches '
+                + 'manually-created worktrees or worktrees from a previous session, and is a no-op when EnterWorktree '
+                + 'was never called. action "remove" deletes the worktree directory AND its branch (DESTRUCTIVE, permanent): '
+                + 'it refuses unless discard_changes is true when the worktree has uncommitted files or new commits, and '
+                + 'lists the evidence otherwise. action "keep" leaves the worktree and branch on disk untouched. '
+                + 'This tool is NOT concurrency-safe and must not overlap other tools.',
+            parameters: {
+                action: {
+                    type: 'string',
+                    enum: ['keep', 'remove'],
+                    description: '"keep" leaves the worktree and branch intact on disk; "remove" deletes both (destructive).',
+                },
+                discard_changes: {
+                    type: 'boolean',
+                    description: 'Required true when action is "remove" and the worktree has uncommitted files or unmerged commits. The tool refuses and lists them otherwise.',
+                },
+            },
+            output: {
+                schema: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: {
+                        action: { type: 'string', required: true },
+                        originalCwd: { type: 'string', required: true },
+                        worktreePath: { type: 'string', required: true },
+                        worktreeBranch: { type: 'string', required: true },
+                        discardedFiles: { type: 'integer' },
+                        discardedCommits: { type: 'integer' },
+                        message: { type: 'string', required: true },
+                    },
+                },
+                render: (_args, value) => [{ type: 'text', text: value.message }],
+            },
+            isConcurrencySafe: () => false,
+            presentCall: presentExitCall,
+            presentResult: presentWorktreeResult,
+            async execute(args, exec) {
+                const session = getActiveWorktreeSession();
+                if (session === null) {
+                    throw new WorktreeError('No-op: there is no active EnterWorktree session to exit. This tool only operates on worktrees '
+                        + 'created by EnterWorktree in the current session — it will not touch manually-created worktrees '
+                        + 'or worktrees from a previous session. No filesystem changes were made.');
+                }
+                if (args.action === 'keep') {
+                    clearActiveWorktreeSession();
+                    updateSessionCwd(exec, session.originalCwd);
+                    return {
+                        action: 'keep',
+                        originalCwd: session.originalCwd,
+                        worktreePath: session.worktreePath,
+                        worktreeBranch: session.worktreeBranch,
+                        message: `Exited worktree. Your work is preserved at ${session.worktreePath} on branch `
+                            + `${session.worktreeBranch}. Session is now back in ${session.originalCwd}.`,
+                    };
+                }
+                // action === 'remove': gate on the safety probe.
+                const summary = await countWorktreeChanges(ctx, session, exec.signal);
+                if (summary === null) {
+                    throw new WorktreeError(`Could not verify worktree state at ${session.worktreePath}. Refusing to remove without explicit `
+                        + 'confirmation. Re-invoke with discard_changes: true to proceed, or use action: "keep" to preserve it.');
+                }
+                const { changedFiles, commits } = summary;
+                if (!args.discard_changes && (changedFiles > 0 || commits > 0)) {
+                    const parts = [];
+                    if (changedFiles > 0)
+                        parts.push(`${changedFiles} uncommitted ${changedFiles === 1 ? 'file' : 'files'}`);
+                    if (commits > 0)
+                        parts.push(`${commits} ${commits === 1 ? 'commit' : 'commits'} on ${session.worktreeBranch}`);
+                    throw new WorktreeError(`Worktree has ${parts.join(' and ')}. Removing will discard this work permanently. Confirm with '
+            + 'the user, then re-invoke with discard_changes: true — or use action: "keep" to preserve the worktree.`);
+                }
+                await assertPathInRepo(ctx, session.repoRoot, session.worktreePath);
+                const removed = await runGit(ctx, forceRemoveWorktree(session.repoRoot, session.worktreePath), exec.signal);
+                if (removed.exitCode !== 0) {
+                    throw new WorktreeError(`failed to remove worktree: ${gitFailure(removed)}`);
+                }
+                const branchDeleted = await runGit(ctx, deleteBranch(session.repoRoot, session.worktreeBranch), exec.signal);
+                if (branchDeleted.exitCode !== 0) {
+                    // The worktree directory is gone; a surviving branch is a lint residue, not a locked failure.
+                    ctx.logger.warn(`could not delete worktree branch ${session.worktreeBranch}: ${gitFailure(branchDeleted)}`);
+                }
+                clearActiveWorktreeSession();
+                updateSessionCwd(exec, session.originalCwd);
+                const discardParts = [];
+                if (commits > 0)
+                    discardParts.push(`${commits} ${commits === 1 ? 'commit' : 'commits'}`);
+                if (changedFiles > 0)
+                    discardParts.push(`${changedFiles} uncommitted ${changedFiles === 1 ? 'file' : 'files'}`);
+                const discardNote = discardParts.length > 0 ? ` Discarded ${discardParts.join(' and ')}.` : '';
+                return {
+                    action: 'remove',
+                    originalCwd: session.originalCwd,
+                    worktreePath: session.worktreePath,
+                    worktreeBranch: session.worktreeBranch,
+                    discardedFiles: changedFiles,
+                    discardedCommits: commits,
+                    message: `Exited and removed worktree at ${session.worktreePath}.${discardNote} `
+                        + `Session is now back in ${session.originalCwd}.`,
+                };
+            },
+        }));
+    }
+}
+export { validateSlug, worktreeBranch, worktreePathFor, randomSlug, flattenSlug } from "./worktree.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAKnD,OAAO,EACL,WAAW,EACX,0BAA0B,EAC1B,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACV,SAAS,EACT,wBAAwB,EACxB,MAAM,EACN,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,MAAM,CAAC,MAAM,IAAI,GAAG,mBAAmB,CAAA;AACvC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,CAAA;AAU9D,oCAAoC;AACpC,MAAM,CAAC,MAAM,MAAM,GAAc,CAAC,CAAC,MAAM,CAAC;IACxC,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9C,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAC9C,CAAC,CAAA;AAaF,4EAA4E;AAC5E,MAAM,aAAc,SAAQ,KAAK;CAAG;AAEpC;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,IAAoB;IACtC,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAA;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,gBAAgB,CAAC,IAAoB,EAAE,IAAY;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IACxB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAM;IAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAsD,CAAA;IAC5E,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU;QAAE,OAAM;IACzE,yEAAyE;IACzE,4EAA4E;IAC5E,IAAI,CAAC;QACH,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,MAAM,CACnB,GAAY,EACZ,GAAW,EACX,MAAmB;IAEnB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;QACnD,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM;KACP,CAAC,CAAC,CAAA;IACH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,mBAAmB,EAAE,YAAY,CAAC,CAAA;QACjE,KAAK,CAAC,IAAI,GAAG,YAAY,CAAA;QACzB,MAAM,KAAK,CAAA;IACb,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,4EAA4E;AAC5E,SAAS,UAAU,CAAC,MAAsB;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,aAAa,MAAM,CAAC,QAAQ,EAAE,CAAA;AACjG,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,gBAAgB,CAAC,GAAY,EAAE,QAAgB,EAAE,YAAoB;IAClF,IAAI,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,aAAa,CAAC,mDAAmD,YAAY,GAAG,CAAC,CAAA;IAC7F,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IACjD,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IACrD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,aAAa,CAAC,mDAAmD,YAAY,GAAG,CAAC,CAAA;IAC7F,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,YAAY,CAAC,GAAY,EAAE,GAAW,EAAE,MAAmB;IACxE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,wBAAwB,EAAE,EAAE,MAAM,CAAC,CAAA;IACrI,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;IACtC,OAAO,MAAM,CAAC,QAAQ,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;AACpE,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,oBAAoB,CACjC,GAAY,EACZ,OAAwB,EACxB,MAAmB;IAEnB,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,CAAA;IAC5E,IAAI,YAAY,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAC5C,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAA;IACnG,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,CAAA;IACrG,IAAI,SAAS,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;IAC/D,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAA;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAS,0BAA0B,CAAC,GAAY;IAC9C,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC;QACvB,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,GAAG,EAAE;YACT,MAAM,OAAO,GAAG,wBAAwB,EAAE,CAAA;YAC1C,IAAI,OAAO,KAAK,IAAI;gBAAE,OAAO,EAAE,CAAA;YAC/B,OAAO,8BAA8B,OAAO,CAAC,YAAY,EAAE,CAAA;QAC7D,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,SAAiB,EAAE;IACrD,0BAA0B,CAAC,GAAG,CAAC,CAAA;IAE/B,IAAI,MAAM,CAAC,mBAAmB,IAAI,IAAI,EAAE,CAAC;QACvC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC5B,IAAI,EAAE,eAAe;YACrB,WAAW,EACT,qGAAqG;kBACnG,mGAAmG;kBACnG,wGAAwG;kBACxG,yGAAyG;kBACzG,qGAAqG;kBACrG,gFAAgF;YACpF,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6LAA6L;iBAC3M;aACF;YACD,MAAM,EAAE;gBACN,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,KAAK;oBAC3B,UAAU,EAAE;wBACV,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;wBAChD,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;wBAClD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;qBAC5C;iBACF;gBACD,MAAM,EAAE,CAAC,KAAwB,EAAE,KAAwE,EAAE,EAAE,CAC7G,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;aAC1C;YACD,iBAAiB,EAAE,GAAG,EAAE,CAAC,KAAK;YAC9B,WAAW,EAAE,gBAAgB;YAC7B,aAAa,EAAE,qBAAqB;YACpC,KAAK,CAAC,OAAO,CAAC,IAAuB,EAAE,IAAI;gBACzC,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;gBAC7C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;gBAC1D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,MAAM,IAAI,aAAa,CACrB,2DAA2D,GAAG,+CAA+C,CAC9G,CAAA;gBACH,CAAC;gBACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,UAAU,EAAE,CAAA;gBACtC,YAAY,CAAC,IAAI,CAAC,CAAA;gBAElB,MAAM,YAAY,GAAG,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;gBACpD,MAAM,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAA;gBAEnD,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;gBACnC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;gBAC9H,IAAI,UAAU,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBAC9B,MAAM,IAAI,aAAa,CAAC,qCAAqC,QAAQ,KAAK,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;gBACrG,CAAC;gBACD,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;gBAElD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;gBAC1E,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBAC1B,MAAM,IAAI,aAAa,CAAC,8BAA8B,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;gBAC7E,CAAC;gBAED,wBAAwB,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAA;gBAC5G,gBAAgB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;gBAEpC,OAAO;oBACL,YAAY;oBACZ,cAAc,EAAE,MAAM;oBACtB,OAAO,EACL,uBAAuB,YAAY,cAAc,MAAM,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI;0BACnF,wEAAwE,YAAY,4BAA4B;0BAChH,gDAAgD;iBACrD,CAAA;YACH,CAAC;SACF,CAAC,CAAC,CAAA;IACL,CAAC;IAED,IAAI,MAAM,CAAC,kBAAkB,IAAI,IAAI,EAAE,CAAC;QACtC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC5B,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,wGAAwG;kBACtG,kGAAkG;kBAClG,qGAAqG;kBACrG,4GAA4G;kBAC5G,wGAAwG;kBACxG,gGAAgG;kBAChG,qEAAqE;YACzE,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;oBACxB,WAAW,EAAE,4FAA4F;iBAC1G;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,8IAA8I;iBAC5J;aACF;YACD,MAAM,EAAE;gBACN,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,KAAK;oBAC3B,UAAU,EAAE;wBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;wBAC1C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;wBAC/C,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;wBAChD,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;wBAClD,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;wBACnC,gBAAgB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;wBACrC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;qBAC5C;iBACF;gBACD,MAAM,EAAE,CAAC,KAAuB,EAAE,KAA0B,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;aACzG;YACD,iBAAiB,EAAE,GAAG,EAAE,CAAC,KAAK;YAC9B,WAAW,EAAE,eAAe;YAC5B,aAAa,EAAE,qBAAqB;YACpC,KAAK,CAAC,OAAO,CAAC,IAAsB,EAAE,IAAI;gBACxC,MAAM,OAAO,GAAG,wBAAwB,EAAE,CAAA;gBAC1C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;oBACrB,MAAM,IAAI,aAAa,CACrB,gGAAgG;0BAC9F,iGAAiG;0BACjG,wEAAwE,CAC3E,CAAA;gBACH,CAAC;gBAED,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;oBAC3B,0BAA0B,EAAE,CAAA;oBAC5B,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;oBAC3C,OAAO;wBACL,MAAM,EAAE,MAAe;wBACvB,WAAW,EAAE,OAAO,CAAC,WAAW;wBAChC,YAAY,EAAE,OAAO,CAAC,YAAY;wBAClC,cAAc,EAAE,OAAO,CAAC,cAAc;wBACtC,OAAO,EACL,8CAA8C,OAAO,CAAC,YAAY,aAAa;8BAC7E,GAAG,OAAO,CAAC,cAAc,4BAA4B,OAAO,CAAC,WAAW,GAAG;qBAChF,CAAA;gBACH,CAAC;gBAED,iDAAiD;gBACjD,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;gBACrE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;oBACrB,MAAM,IAAI,aAAa,CACrB,sCAAsC,OAAO,CAAC,YAAY,wCAAwC;0BAChG,sGAAsG,CACzG,CAAA;gBACH,CAAC;gBACD,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;gBACzC,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,YAAY,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC;oBAC/D,MAAM,KAAK,GAAa,EAAE,CAAA;oBAC1B,IAAI,YAAY,GAAG,CAAC;wBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,gBAAgB,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;oBACxG,IAAI,OAAO,GAAG,CAAC;wBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,OAAO,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;oBAC9G,MAAM,IAAI,aAAa,CACrB,gBAAgB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;qHACsE,CAC1G,CAAA;gBACH,CAAC;gBAED,MAAM,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;gBACnE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,mBAAmB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;gBAC3G,IAAI,OAAO,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBAC3B,MAAM,IAAI,aAAa,CAAC,8BAA8B,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;gBAC9E,CAAC;gBACD,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;gBAC5G,IAAI,aAAa,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBACjC,8FAA8F;oBAC9F,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,OAAO,CAAC,cAAc,KAAK,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;gBAC7G,CAAC;gBAED,0BAA0B,EAAE,CAAA;gBAC5B,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;gBAC3C,MAAM,YAAY,GAAa,EAAE,CAAA;gBACjC,IAAI,OAAO,GAAG,CAAC;oBAAE,YAAY,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAA;gBACxF,IAAI,YAAY,GAAG,CAAC;oBAAE,YAAY,CAAC,IAAI,CAAC,GAAG,YAAY,gBAAgB,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;gBAC/G,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;gBAC9F,OAAO;oBACL,MAAM,EAAE,QAAiB;oBACzB,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,YAAY,EAAE,OAAO,CAAC,YAAY;oBAClC,cAAc,EAAE,OAAO,CAAC,cAAc;oBACtC,cAAc,EAAE,YAAY;oBAC5B,gBAAgB,EAAE,OAAO;oBACzB,OAAO,EACL,kCAAkC,OAAO,CAAC,YAAY,IAAI,WAAW,GAAG;0BACtE,0BAA0B,OAAO,CAAC,WAAW,GAAG;iBACrD,CAAA;YACH,CAAC;SACF,CAAC,CAAC,CAAA;IACL,CAAC;AACH,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}

package/lib/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@dsh-cc/tool-git-worktree`.
+ * @module @dsh-cc/tool-git-worktree/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "tool-git-worktree-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/invariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,oCAAoC;AACpC,eAAO,MAAM,IAAI,gCAAgC,CAAA;AACjD,2EAA2E;AAC3E,eAAO,MAAM,MAAM,UAAiB,CAAA;AASpC;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,OAAO,KAAG,OAAO,CAAC,MAAM,IAAI,CACU,CAAA"}

package/lib/invariant.js

@@ -0,0 +1,23 @@
+/**
+ * Package-owned invariant companion for `@dsh-cc/tool-git-worktree`.
+ * @module @dsh-cc/tool-git-worktree/invariant
+ */
+const PACKAGE_NAME = '@dsh-cc/tool-git-worktree';
+/** Cordis companion plugin name. */
+export const name = 'tool-git-worktree-invariant';
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants'];
+/**
+ * No runtime invariant: git is an external process the package never vends a
+ * snapshot of, and the active worktree session is process-local navigation
+ * state rather than a durable published projection a companion could cross-check.
+ */
+const install = () => { };
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+/* jscpd:ignore-end */
+//# sourceMappingURL=invariant.js.map

package/lib/invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,YAAY,GAAG,2BAA2B,CAAA;AAEhD,oCAAoC;AACpC,MAAM,CAAC,MAAM,IAAI,GAAG,6BAA6B,CAAA;AACjD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,YAAY,CAAC,CAAA;AAEpC;;;;GAIG;AACH,MAAM,OAAO,GAAuB,GAAG,EAAE,GAAE,CAAC,CAAA;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAY,EAAuB,EAAE,CACzD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;AACjE,sBAAsB"}

package/lib/render.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Pure presentation (presentCall / presentResult) and message rendering for
+ * the git-worktree tools. All functions are pure in their arguments so the
+ * registry can replay them against logged call metadata.
+ * @module @dsh-cc/tool-git-worktree/render
+ */
+import type { GenericCallView, ToolResult, ToolResultView } from '@dsh-cc/tools';
+/** Arguments accepted by the EnterWorktree tool. */
+export interface EnterWorktreeArgs {
+    name?: string;
+}
+/** Arguments accepted by the ExitWorktree tool. */
+export interface ExitWorktreeArgs {
+    action: 'keep' | 'remove';
+    discard_changes?: boolean;
+}
+/**
+ * Present an EnterWorktree pending call as a generic execute card.
+ * @param args - validated tool arguments.
+ * @returns a generic card view.
+ */
+export declare function presentEnterCall(args: EnterWorktreeArgs): GenericCallView;
+/**
+ * Present a worktree tool result as a generic card with a human-readable
+ * summary. Both tools share this presenter because their result shapes are the
+ * same — a plain message on success, fenced text on error so a failure is
+ * visually distinct from a success summary.
+ * @param _args - validated tool arguments (unused by the presenter).
+ * @param result - the finalized tool result.
+ * @returns a generic card view, or `undefined` for an unexpected shape.
+ */
+export declare function presentWorktreeResult(_args: unknown, result: ToolResult): ToolResultView | undefined;
+/**
+ * Present an ExitWorktree pending call. A `remove` is the destructive branch
+ * and is surfaced with a generic execute card whose content states the deletion
+ * consequence; `keep` is a generic card stating that nothing is deleted.
+ * @param args - validated tool arguments.
+ * @returns a generic card view.
+ */
+export declare function presentExitCall(args: ExitWorktreeArgs): GenericCallView;
+//# sourceMappingURL=render.d.ts.map

package/lib/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEhF,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAA;IACzB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,eAAe,CAezE;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,CAMpG;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAkBvE"}

package/lib/render.js

@@ -0,0 +1,71 @@
+/**
+ * Pure presentation (presentCall / presentResult) and message rendering for
+ * the git-worktree tools. All functions are pure in their arguments so the
+ * registry can replay them against logged call metadata.
+ * @module @dsh-cc/tool-git-worktree/render
+ */
+/**
+ * Present an EnterWorktree pending call as a generic execute card.
+ * @param args - validated tool arguments.
+ * @returns a generic card view.
+ */
+export function presentEnterCall(args) {
+    return {
+        card: 'generic',
+        title: 'Creating worktree',
+        kind: 'execute',
+        rawInput: args.name ?? '(generated name)',
+        content: [
+            {
+                type: 'text',
+                text: args.name === undefined
+                    ? 'Create a new git worktree with a generated name and switch the session into it.'
+                    : `Create a new git worktree "${args.name}" and switch the session into it.`,
+            },
+        ],
+    };
+}
+/**
+ * Present a worktree tool result as a generic card with a human-readable
+ * summary. Both tools share this presenter because their result shapes are the
+ * same — a plain message on success, fenced text on error so a failure is
+ * visually distinct from a success summary.
+ * @param _args - validated tool arguments (unused by the presenter).
+ * @param result - the finalized tool result.
+ * @returns a generic card view, or `undefined` for an unexpected shape.
+ */
+export function presentWorktreeResult(_args, result) {
+    const block = result.content.length === 1 ? result.content[0] : undefined;
+    if (block === undefined || block.type !== 'text')
+        return undefined;
+    return result.isError
+        ? { card: 'generic', content: [{ type: 'text', text: `\`\`\`\n${block.text.replace(/\n+$/, '')}\n\`\`\`` }] }
+        : { card: 'generic', content: [{ type: 'text', text: block.text }] };
+}
+/**
+ * Present an ExitWorktree pending call. A `remove` is the destructive branch
+ * and is surfaced with a generic execute card whose content states the deletion
+ * consequence; `keep` is a generic card stating that nothing is deleted.
+ * @param args - validated tool arguments.
+ * @returns a generic card view.
+ */
+export function presentExitCall(args) {
+    const removing = args.action === 'remove';
+    return {
+        card: 'generic',
+        title: removing ? 'Removing worktree' : 'Keeping worktree',
+        kind: 'execute',
+        rawInput: removing ? 'remove' : 'keep',
+        content: [
+            {
+                type: 'text',
+                text: removing
+                    ? 'Remove the active worktree and its branch. This deletes the worktree directory'
+                        + (args.discard_changes === true ? ' and discards any uncommitted changes and commits' : '')
+                        + '.'
+                    : 'Leave the active worktree and its branch on disk and return to the original directory.',
+            },
+        ],
+    };
+}
+//# sourceMappingURL=render.js.map

package/lib/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAuB;IACtD,OAAO;QACL,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,IAAI,CAAC,IAAI,IAAI,kBAAkB;QACzC,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,SAAS;oBAC3B,CAAC,CAAC,iFAAiF;oBACnF,CAAC,CAAC,8BAA8B,IAAI,CAAC,IAAI,mCAAmC;aAC/E;SACF;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc,EAAE,MAAkB;IACtE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACzE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,SAAS,CAAA;IAClE,OAAO,MAAM,CAAC,OAAO;QACnB,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE;QAC7G,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAA;AACxE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,IAAsB;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAA;IACzC,OAAO;QACL,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,kBAAkB;QAC1D,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;QACtC,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ;oBACZ,CAAC,CAAC,gFAAgF;0BAC9E,CAAC,IAAI,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC,CAAC,mDAAmD,CAAC,CAAC,CAAC,EAAE,CAAC;0BAC1F,GAAG;oBACP,CAAC,CAAC,wFAAwF;aAC7F;SACF;KACF,CAAA;AACH,CAAC"}

package/lib/worktree.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Centralized git-worktree command construction and active-session state for
+ * `@dsh-cc/tool-git-worktree`. Keeping every git command in one module
+ * is the seam a future pure-JS git implementation would replace; callers never
+ * construct `git ...` argument lists themselves.
+ * @module @dsh-cc/tool-git-worktree/worktree
+ */
+/**
+ * Maximum length of a worktree slug. Mirrors the claude-code reference constraint.
+ */
+export declare const MAX_SLUG_LENGTH = 64;
+/**
+ * Validate a worktree slug to keep it inside `.claude/worktrees/` and safe as a
+ * git branch suffix. Rejects empty segments, `.`/`..`, drive characters, and
+ * leading/trailing slashes; allows `user/feature` nesting.
+ * @param slug - The requested worktree name.
+ * @returns nothing on success; throws on an invalid slug.
+ */
+export declare function validateSlug(slug: string): void;
+/**
+ * Flatten a possibly nested slug (`user/feature` → `user+feature`) into a value
+ * safe as a single directory name and a single git ref. `+` is valid in branch
+ * names and paths but absent from the slug allowlist, so the map is injective.
+ * @param slug - A validated worktree slug.
+ * @returns the flattened name under `.claude/worktrees/`.
+ */
+export declare function flattenSlug(slug: string): string;
+/**
+ * The git branch backing a worktree. Prefixes `worktree-` so it never collides
+ * with a user branch.
+ * @param slug - A validated worktree slug.
+ * @returns the branch name.
+ */
+export declare function worktreeBranch(slug: string): string;
+/**
+ * The on-disk worktree path for a repo root and slug.
+ * @param repoRoot - The canonical repository root.
+ * @param slug - A validated worktree slug.
+ * @returns the absolute worktree path.
+ */
+export declare function worktreePathFor(repoRoot: string, slug: string): string;
+/** The directory holding all worktrees for a repo root. */
+export declare function worktreesDir(repoRoot: string): string;
+export interface GitCmd {
+    /** The full command string to run in the shell. */
+    readonly command: string;
+    /** The directory git runs in (the repo root, never the worktree being removed). */
+    readonly workdir: string;
+    /** Short human label for logs and errors. */
+    readonly label: string;
+}
+/**
+ * `git worktree add` on a fresh branch based on the current HEAD. Uses `-B`
+ * (not `-b`) so a stale orphan branch left by a removed worktree is reset
+ * rather than failing.
+ * @param repoRoot - The canonical repository root.
+ * @param slug - A validated worktree slug.
+ * @returns the command to run.
+ */
+export declare function addWorktree(repoRoot: string, slug: string): GitCmd;
+/**
+ * `git worktree remove --force <path>`: git's force flag removes a dirty or
+ * committed-on worktree. Callers gate `--force` on an explicit
+ * `discard_changes` grant; this command is constructed only for that path.
+ * @param repoRoot - The canonical repository root.
+ * @param path - Absolute worktree path (must be a registered worktree).
+ * @returns the command to run.
+ */
+export declare function forceRemoveWorktree(repoRoot: string, path: string): GitCmd;
+/**
+ * `git branch -D <branch>` to delete the now-unregistered worktree branch.
+ * @param repoRoot - The canonical repository root.
+ * @param branch - Worktree branch to delete.
+ * @returns the command to run.
+ */
+export declare function deleteBranch(repoRoot: string, branch: string): GitCmd;
+/**
+ * `git status --porcelain` inside the worktree — the working-tree dirtiness
+ * probe for the remove gate.
+ * @param worktreePath - Absolute worktree path.
+ * @returns the command to run.
+ */
+export declare function status(worktreePath: string): GitCmd;
+/**
+ * `git rev-list --count <base>..HEAD` inside the worktree — the commit probe
+ * for the remove gate.
+ * @param worktreePath - Absolute worktree path.
+ * @param originalHead - The commit the worktree was created from.
+ * @returns the command to run.
+ */
+export declare function commitsAhead(worktreePath: string, originalHead: string): GitCmd;
+/**
+ * Quote an argument for a `bash -c` command line using single-quote escaping.
+ * @param arg - A path or ref to embed literally.
+ * @returns the shell-quoted token.
+ */
+export declare function quote(arg: string): string;
+/** Human-readable for a repo — the basename of its canonical root. */
+export declare function repoLabel(repoRoot: string): string;
+/** A live EnterWorktree session for the current process. */
+export interface WorktreeSession {
+    /** The cwd of the session before EnterWorktree ran. */
+    readonly originalCwd: string;
+    /** The session's canonical repository root (where `.claude/worktrees` lives). */
+    readonly repoRoot: string;
+    /** Absolute on-disk worktree path. */
+    readonly worktreePath: string;
+    /** The worktree branch name. */
+    readonly worktreeBranch: string;
+    /** The commit the worktree was based on (the remove gate's baseline). */
+    readonly originalHead: string;
+}
+/** The active worktree session, or `null` when not inside one. */
+export declare function getActiveWorktreeSession(): WorktreeSession | null;
+/** Set the active worktree session. @internal */
+export declare function setActiveWorktreeSession(session: WorktreeSession): void;
+/** Clear the active worktree session. @internal */
+export declare function clearActiveWorktreeSession(): void;
+/**
+ * Generate a random, valid worktree slug in the style of the claude-code
+ * reference (`swift-fox-8f3a`).
+ * @returns a valid random slug.
+ */
+export declare function randomSlug(): string;
+//# sourceMappingURL=worktree.d.ts.map

package/lib/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../src/worktree.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,eAAO,MAAM,eAAe,KAAK,CAAA;AAKjC;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkB/C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,MAAM,WAAW,MAAM;IACrB,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAOlE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAM/E;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sCAAsC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,gCAAgC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B;AAUD,kEAAkE;AAClE,wBAAgB,wBAAwB,IAAI,eAAe,GAAG,IAAI,CAEjE;AAED,iDAAiD;AACjD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEvE;AAED,mDAAmD;AACnD,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAOD;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAKnC"}

package/lib/worktree.js

@@ -0,0 +1,184 @@
+/**
+ * Centralized git-worktree command construction and active-session state for
+ * `@dsh-cc/tool-git-worktree`. Keeping every git command in one module
+ * is the seam a future pure-JS git implementation would replace; callers never
+ * construct `git ...` argument lists themselves.
+ * @module @dsh-cc/tool-git-worktree/worktree
+ */
+import { basename, join } from 'node:path';
+/**
+ * Maximum length of a worktree slug. Mirrors the claude-code reference constraint.
+ */
+export const MAX_SLUG_LENGTH = 64;
+/** Allowlist for one `/`-separated slug segment (letters, digits, `.`, `_`, `-`). */
+const SEGMENT = /^[a-zA-Z0-9._-]+$/;
+/**
+ * Validate a worktree slug to keep it inside `.claude/worktrees/` and safe as a
+ * git branch suffix. Rejects empty segments, `.`/`..`, drive characters, and
+ * leading/trailing slashes; allows `user/feature` nesting.
+ * @param slug - The requested worktree name.
+ * @returns nothing on success; throws on an invalid slug.
+ */
+export function validateSlug(slug) {
+    if (slug.length > MAX_SLUG_LENGTH) {
+        throw new Error(`invalid worktree name: must be ${MAX_SLUG_LENGTH} characters or fewer (got ${slug.length})`);
+    }
+    for (const segment of slug.split('/')) {
+        if (segment === '.' || segment === '..') {
+            throw new Error(`invalid worktree name "${slug}": must not contain "." or ".." path segments`);
+        }
+        if (!SEGMENT.test(segment)) {
+            throw new Error(`invalid worktree name "${slug}": each "/"-separated segment must be non-empty and contain only letters, digits, dots, underscores, and dashes`);
+        }
+    }
+}
+/**
+ * Flatten a possibly nested slug (`user/feature` → `user+feature`) into a value
+ * safe as a single directory name and a single git ref. `+` is valid in branch
+ * names and paths but absent from the slug allowlist, so the map is injective.
+ * @param slug - A validated worktree slug.
+ * @returns the flattened name under `.claude/worktrees/`.
+ */
+export function flattenSlug(slug) {
+    return slug.replaceAll('/', '+');
+}
+/**
+ * The git branch backing a worktree. Prefixes `worktree-` so it never collides
+ * with a user branch.
+ * @param slug - A validated worktree slug.
+ * @returns the branch name.
+ */
+export function worktreeBranch(slug) {
+    return `worktree-${flattenSlug(slug)}`;
+}
+/**
+ * The on-disk worktree path for a repo root and slug.
+ * @param repoRoot - The canonical repository root.
+ * @param slug - A validated worktree slug.
+ * @returns the absolute worktree path.
+ */
+export function worktreePathFor(repoRoot, slug) {
+    return join(repoRoot, '.claude', 'worktrees', flattenSlug(slug));
+}
+/** The directory holding all worktrees for a repo root. */
+export function worktreesDir(repoRoot) {
+    return join(repoRoot, '.claude', 'worktrees');
+}
+/**
+ * `git worktree add` on a fresh branch based on the current HEAD. Uses `-B`
+ * (not `-b`) so a stale orphan branch left by a removed worktree is reset
+ * rather than failing.
+ * @param repoRoot - The canonical repository root.
+ * @param slug - A validated worktree slug.
+ * @returns the command to run.
+ */
+export function addWorktree(repoRoot, slug) {
+    const path = worktreePathFor(repoRoot, slug);
+    return {
+        command: `git worktree add -B ${quote(worktreeBranch(slug))} ${quote(path)} HEAD`,
+        workdir: repoRoot,
+        label: `create worktree "${path}"`,
+    };
+}
+/**
+ * `git worktree remove --force <path>`: git's force flag removes a dirty or
+ * committed-on worktree. Callers gate `--force` on an explicit
+ * `discard_changes` grant; this command is constructed only for that path.
+ * @param repoRoot - The canonical repository root.
+ * @param path - Absolute worktree path (must be a registered worktree).
+ * @returns the command to run.
+ */
+export function forceRemoveWorktree(repoRoot, path) {
+    return {
+        command: `git worktree remove --force ${quote(path)}`,
+        workdir: repoRoot,
+        label: `remove worktree "${path}"`,
+    };
+}
+/**
+ * `git branch -D <branch>` to delete the now-unregistered worktree branch.
+ * @param repoRoot - The canonical repository root.
+ * @param branch - Worktree branch to delete.
+ * @returns the command to run.
+ */
+export function deleteBranch(repoRoot, branch) {
+    return {
+        command: `git branch -D ${quote(branch)}`,
+        workdir: repoRoot,
+        label: `delete worktree branch "${branch}"`,
+    };
+}
+/**
+ * `git status --porcelain` inside the worktree — the working-tree dirtiness
+ * probe for the remove gate.
+ * @param worktreePath - Absolute worktree path.
+ * @returns the command to run.
+ */
+export function status(worktreePath) {
+    return {
+        command: 'git status --porcelain',
+        workdir: worktreePath,
+        label: `status "${worktreePath}"`,
+    };
+}
+/**
+ * `git rev-list --count <base>..HEAD` inside the worktree — the commit probe
+ * for the remove gate.
+ * @param worktreePath - Absolute worktree path.
+ * @param originalHead - The commit the worktree was created from.
+ * @returns the command to run.
+ */
+export function commitsAhead(worktreePath, originalHead) {
+    return {
+        command: `git rev-list --count ${quote(`${originalHead}..HEAD`)}`,
+        workdir: worktreePath,
+        label: `count commits ahead of worktree "${worktreePath}"`,
+    };
+}
+/**
+ * Quote an argument for a `bash -c` command line using single-quote escaping.
+ * @param arg - A path or ref to embed literally.
+ * @returns the shell-quoted token.
+ */
+export function quote(arg) {
+    return `'${arg.replaceAll('\'', '\'\\\'\'')}'`;
+}
+/** Human-readable for a repo — the basename of its canonical root. */
+export function repoLabel(repoRoot) {
+    return basename(repoRoot);
+}
+/**
+ * The single active worktree session for this process, mirroring the
+ * claude-code reference's module-level singleton. EnterWorktree sets it;
+ * ExitWorktree clears it. This is intentionally process-wide (not per-session)
+ * to match the reference and keep systemPrompt context injection unambiguous.
+ */
+let currentSession = null;
+/** The active worktree session, or `null` when not inside one. */
+export function getActiveWorktreeSession() {
+    return currentSession;
+}
+/** Set the active worktree session. @internal */
+export function setActiveWorktreeSession(session) {
+    currentSession = session;
+}
+/** Clear the active worktree session. @internal */
+export function clearActiveWorktreeSession() {
+    currentSession = null;
+}
+/** A base repo name for default (random) worktree slugs. @internal */
+const ADJECTIVES = ['swift', 'bright', 'calm', 'keen', 'bold'];
+/** A base repo noun for default (random) worktree slugs. @internal */
+const NOUNS = ['fox', 'owl', 'elm', 'oak', 'ray'];
+/**
+ * Generate a random, valid worktree slug in the style of the claude-code
+ * reference (`swift-fox-8f3a`).
+ * @returns a valid random slug.
+ */
+export function randomSlug() {
+    const adjective = ADJECTIVES[Math.floor(Math.random() * ADJECTIVES.length)];
+    const noun = NOUNS[Math.floor(Math.random() * NOUNS.length)];
+    const suffix = Math.random().toString(36).slice(2, 6);
+    return `${adjective}-${noun}-${suffix}`;
+}
+//# sourceMappingURL=worktree.js.map

package/lib/worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../src/worktree.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@dsh-cc/tool-git-worktree",
+  "description": "EnterWorktree / ExitWorktree model tools over the ctx.shell seam: create, keep, and remove isolated git worktrees inside .claude/worktrees",
+  "version": "0.5.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dsh-cc/dsh-cc.git",
+    "directory": "packages/workspace/tool-git-worktree"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "license": "Apache-2.0",
+  "peerDependencies": {
+    "@deepseek-ai/dsh-agent": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-fs": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-invariants": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-shell": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": ">=0.1.1-rc.2",
+    "@deepseek-ai/cordis": ">=0.1.1-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@dsh-cc/session-cwd": "^0.5.0",
+    "@dsh-cc/tools": "^0.5.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-agent": "link:../../../../deepseek-harness/packages/core/agent",
+    "@deepseek-ai/dsh-agent-loop": "link:../../../../deepseek-harness/packages/core/agent-loop",
+    "@deepseek-ai/dsh-agent-loop-testkit": "link:../../../../deepseek-harness/packages/test-support/agent-loop-testkit",
+    "@deepseek-ai/dsh-fs": "link:../../../../deepseek-harness/packages/fs/fs",
+    "@deepseek-ai/dsh-fs-local": "link:../../../../deepseek-harness/packages/fs/fs-local",
+    "@deepseek-ai/dsh-invariants": "link:../../../../deepseek-harness/packages/runtime-diagnostics/invariants",
+    "@deepseek-ai/dsh-llm": "link:../../../../deepseek-harness/packages/llm/llm",
+    "@deepseek-ai/dsh-shell": "link:../../../../deepseek-harness/packages/shell/shell",
+    "@deepseek-ai/dsh-subprocess-local": "link:../../../../deepseek-harness/packages/subprocess/subprocess-local",
+    "@deepseek-ai/dsh-system-prompt": "link:../../../../deepseek-harness/packages/core/system-prompt",
+    "@dsh-cc/session-cwd": "link:../session-cwd",
+    "@deepseek-ai/cordis": "link:../../../../deepseek-harness/vendor/cordis",
+    "@deepseek-ai/schemastery": "link:../../../../deepseek-harness/vendor/schemastery",
+    "@deepseek-ai/dsh-bash-local": "link:../../../../deepseek-harness/packages/shell/bash-local",
+    "@dsh-cc/tools": "^0.5.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}