opencode-gitwt 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 voischev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,53 @@
-# Temporary Holding Version
+# opencode-gitwt
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+OpenCode adapter for `gitwt`. It exposes the shared worktree core as agent tools:
+https://github.com/voischev/gitwt
+
+Requires Node.js 22.14+ and Git. Supports OpenCode 1.19.3–<2.
+
+## Use in OpenCode
+
+Add the plugin to your project's `opencode.json`, then restart OpenCode:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-gitwt@latest"]
+}
+```
+
+Ask the agent in chat, for example:
+
+> Create a worktree on branch feature/login from main, fix the login issue there,
+> and run the tests. Keep the worktree for review.
+
+The agent calls `gitwt_create` with `{"branch":"feature/login","base":"main"}`.
+Use the returned `worktreePath` as the cwd for commands and as the base for
+absolute paths in file operations. Continue in the same session; approve access
+to that directory if OpenCode asks. `gitwt_cd` only returns the path and does not
+change the session directory. Use `gitwt_list` to inspect copies and
+`gitwt_remove` only on explicit request when the worktree is no longer in use.
+
+## Tools
+
+- `gitwt_create` creates and verifies a worktree.
+- `gitwt_list` shows registered worktrees with optional status.
+- `gitwt_cd` resolves a branch or full path without changing cwd.
+- `gitwt_remove` removes a worktree explicitly, optionally with `force`.
+
+## Configuration
+
+The plugin uses the shared gitwt configuration: `.gitwt.jsonc` in the project
+and `~/.config/gitwt/config.jsonc` globally. Options include `remote`, `base`,
+`prefix`, `worktreeDir`, and `hooks`. See the core repository for details.
+
+For the standalone `gitwt` command, run `npm install -g @voischev/gitwt`.
+Upgrading from 0.1.x: move `.opencode/gitwt.jsonc` to `.gitwt.jsonc` and global
+settings from `~/.config/opencode/gitwt.jsonc` to `~/.config/gitwt/config.jsonc`.
+
+## Development
+
+GitHub is the primary repository; SourceCraft is a mirror. Releases publish to
+npm from GitHub with `NPM_TOKEN`.
+
+Run `npm ci --ignore-scripts`, `npm run check`, and `npm test`.

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "opencode-gitwt",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Git worktree для OpenCode: создать, проверить, вернуть путь и явно удалить",
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./server": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.14.0",
+    "opencode": ">=1.19.3 <2"
+  },
+  "scripts": {
+    "check": "biome check .",
+    "test": "node --test",
+    "release": "node scripts/release.js"
+  },
+  "dependencies": {
+    "@voischev/gitwt": "^0.1.3",
+    "zod": "4.1.8"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.6.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/voischev/opencode-gitwt.git"
+  },
+  "homepage": "https://github.com/voischev/opencode-gitwt",
+  "bugs": {
+    "url": "https://github.com/voischev/opencode-gitwt/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "git",
+    "worktree"
+  ],
+  "license": "MIT"
+}

package/src/index.js

@@ -0,0 +1,66 @@
+import { createWorktree, listWorktrees, removeWorktree, resolveWorktree } from "@voischev/gitwt";
+import { z } from "zod";
+
+export async function GitwtPlugin({ directory }, config = {}) {
+  return {
+    tool: {
+      gitwt_create: {
+        description:
+          "Создать и проверить новый worktree. Продолжайте текущую сессию, используя возвращённый worktreePath в командах и файловых операциях. Сохраняйте worktree при паузе и передаче задачи.",
+        args: {
+          branch: z.string().describe("Имя новой ветки"),
+          base: z.string().optional().describe("Базовая remote-ветка"),
+          from: z
+            .string()
+            .optional()
+            .describe("Явная локальная ссылка или проверенный commit вместо remote-базы"),
+          path: z.string().optional().describe("Полный путь нового worktree"),
+          noHooks: z.boolean().optional().describe("Явно отключить хуки для создаваемого worktree"),
+        },
+        execute: async (args, ctx) =>
+          JSON.stringify(
+            await createWorktree(ctx.directory ?? directory, {
+              ...args,
+              signal: ctx.abort,
+              config: { ...config, base: args.base ?? config.base },
+            }),
+          ),
+      },
+      gitwt_list: {
+        description:
+          "Показать worktree из реестра Git. status проверяет dirty и доступные ahead/behind; null означает неизвестное состояние.",
+        args: { status: z.boolean().optional() },
+        execute: async (args, ctx) =>
+          JSON.stringify(await listWorktrees(ctx.directory ?? directory, args)),
+      },
+      gitwt_cd: {
+        description:
+          "Найти worktree по точной ветке или полному пути и вернуть его путь, HEAD и статус. Каталог текущей сессии не меняется: используйте worktreePath явно.",
+        args: { target: z.string() },
+        execute: async ({ target }, ctx) =>
+          JSON.stringify(
+            await resolveWorktree(ctx.directory ?? directory, target, { status: true }),
+          ),
+      },
+      gitwt_remove: {
+        description:
+          "Только по явной просьбе удалить указанный worktree, убедившись, что он больше не используется. force разрешает потерю изменений, но не обходит ошибку preRemove. Без автокоммитов и отложенной очистки.",
+        args: {
+          target: z.string(),
+          force: z.boolean().optional(),
+          keepBranch: z.boolean().optional(),
+        },
+        execute: async ({ target, force, keepBranch }, ctx) =>
+          JSON.stringify(
+            await removeWorktree(ctx.directory ?? directory, target, {
+              force,
+              deleteBranch: !keepBranch,
+              signal: ctx.abort,
+            }),
+          ),
+      },
+    },
+  };
+}
+
+export default { id: "opencode-gitwt", server: GitwtPlugin };