@zenobius/pi-worktrees 0.1.0 → 0.2.0

package/README.md

@@ -58,6 +58,32 @@ In Pi:
 /worktree prune
 ```
 
+### How I use `/worktrees`
+
+Since I use nvim and zellij, i want the worktrees I create to be clones of the workspace
+I have for the current one, so to this end, my `onCreate` looks like: 
+
+```json
+{
+  "worktrees": {
+    "**": {
+      "worktreeRoot": "{{mainWorktree}}.worktrees",
+      "onCreate": [
+        "mise trust --yes",
+        "mise setup",
+        "zellij action new-tab --name {{name}} --cwd {{path}}",
+        "zellij action new-pane --in-place --cwd {{path}} -- nvim",
+        "zellij action new-pane --cwd {{path}} --direction right -- pi"
+      ]
+    }
+  }
+}
+
+```
+
+This means when ever i create a new worktree, it creates a new zellij tab with nvim and pi running
+in it on the new worktree path.
+
 ---
 
 ## Command reference
@@ -66,7 +92,7 @@ In Pi:
 |---|---|
 | `/worktree init` | Interactive setup for extension settings |
 | `/worktree settings` | Show all current settings |
-| `/worktree settings <key>` | Get one setting (`parentDir`, `onCreate`) |
+| `/worktree settings <key>` | Get one setting (`worktreeRoot`, `onCreate`) |
 | `/worktree settings <key> <value>` | Set one setting |
 | `/worktree create <feature-name>` | Create a new worktree + branch `feature/<feature-name>` |
 | `/worktree list` | List all worktrees (`/worktree ls` alias) |
@@ -74,47 +100,97 @@ In Pi:
 | `/worktree cd <name>` | Print matching worktree path |
 | `/worktree remove <name>` | Remove a worktree (`/worktree rm` alias) |
 | `/worktree prune` | Remove stale worktree metadata |
+| `/worktree templates` | Preview template variables with current + generated values |
 
 ---
 
 ## Configuration
 
-Settings live in `~/.pi/agent/pi-worktrees-settings.json` under `worktree`: 
+Settings live in `~/.pi/agent/pi-worktrees-settings.json`.
 
 ```json
 {
+  "worktrees": {
+    "github.com/org/repo": {
+      "worktreeRoot": "~/work/org/repo.worktrees",
+      "onCreate": ["mise install", "bun install"]
+    },
+    "github.com/org/*": {
+      "worktreeRoot": "~/work/org/shared.worktrees",
+      "onCreate": "mise setup"
+    }
+  },
+  "matchingStrategy": "fail-on-tie",
   "worktree": {
-    "parentDir": "~/.local/share/worktrees/{{project}}",
+    "worktreeRoot": "~/.local/share/worktrees/{{project}}",
     "onCreate": "mise setup"
   }
 }
 ```
 
-### `parentDir`
+### Matching model
 
-Where new worktrees are created.
+For the current repository, settings are resolved in this order:
 
-- **Default**: `../<project>.worktrees/` (relative to your main worktree)
-- Supports template variables
+1. Exact URL match in `worktrees`
+2. Most-specific glob match in `worktrees`
+3. Fallback to legacy `worktree`
+
+`matchingStrategy` controls ties between equally specific patterns:
+
+- `fail-on-tie` (default)
+- `first-wins`
+- `last-wins`
 
 ### `onCreate`
 
-Optional command run **after** successful worktree creation, in the new worktree directory.
+`onCreate` accepts either:
+
+- a single string command
+- an array of commands
 
-Useful examples:
+When an array is used, commands run sequentially and stop on first failure.
 
-- `mise setup`
-- `bun install`
-- `mise setup && bun install`
+### `worktreeRoot`
 
+Where new worktrees are created.
+
+- **Default**: `{{mainWorktree}}.worktrees`
+- Supports template variables
+
+> Backward compatibility: `parentDir` is still accepted as a deprecated alias for `worktreeRoot`.
+> The extension will migrate existing `parentDir` values to `worktreeRoot` automatically.
 ### Template variables
 
-Available in `parentDir` and `onCreate` strings:
+Available in `worktreeRoot` and `onCreate` values:
 
 - `{{path}}` → created worktree path
 - `{{name}}` → feature/worktree name
 - `{{branch}}` → created branch name
 - `{{project}}` → repository name
+- `{{mainWorktree}}` → main worktree path (repository root)
+
+### Migration note
+
+Legacy single-worktree config remains supported and is migrated through the shared
+`@zenobius/pi-extension-config` migration chain.
+```json
+{
+  "worktree": {
+    "worktreeRoot": "...",
+    "onCreate": "..."
+  }
+}
+```
+
+Migration behavior:
+
+1. Legacy flat keys are normalized to `worktree`
+2. Legacy `worktree` is migrated to `worktrees["**"]`
+3. Migration version metadata is managed by `@zenobius/pi-extension-config`
+
+Deprecation timing follows the migration policy in `@zenobius/pi-extension-config`.
+This extension does not apply a separate ad-hoc deprecation mechanism.
 
 ---
 

package/dist/cmds/cmdCd.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionCommandContext } from '@mariozechner/pi-coding-agent';
+import type { CommandDeps } from '../types.ts';
+export declare function cmdCd(args: string, ctx: ExtensionCommandContext, deps: CommandDeps): Promise<void>;

package/dist/cmds/cmdCreate.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionCommandContext } from '@mariozechner/pi-coding-agent';
+import type { CommandDeps } from '../types.ts';
+export declare function cmdCreate(args: string, ctx: ExtensionCommandContext, deps: CommandDeps): Promise<void>;

package/dist/cmds/cmdInit.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionCommandContext } from '@mariozechner/pi-coding-agent';
+import type { CommandDeps } from '../types.ts';
+export declare function cmdInit(_args: string, ctx: ExtensionCommandContext, deps: CommandDeps): Promise<void>;

package/dist/cmds/cmdList.d.ts

@@ -0,0 +1,2 @@
+import { CmdHandler } from '../types.ts';
+export declare const cmdList: CmdHandler;

package/dist/cmds/cmdPrune.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionCommandContext } from '@mariozechner/pi-coding-agent';
+export declare function cmdPrune(_args: string, ctx: ExtensionCommandContext): Promise<void>;

package/dist/cmds/cmdRemove.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionCommandContext } from '@mariozechner/pi-coding-agent';
+import type { CommandDeps } from '../types.ts';
+export declare function cmdRemove(args: string, ctx: ExtensionCommandContext, deps: CommandDeps): Promise<void>;

package/dist/cmds/cmdSettings.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionCommandContext } from '@mariozechner/pi-coding-agent';
+import type { CommandDeps } from '../types.ts';
+export declare function cmdSettings(args: string, ctx: ExtensionCommandContext, deps: CommandDeps): Promise<void>;

package/dist/cmds/cmdStatus.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionCommandContext } from '@mariozechner/pi-coding-agent';
+export declare function cmdStatus(_args: string, ctx: ExtensionCommandContext): Promise<void>;

package/dist/cmds/cmdTemplates.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionCommandContext } from '@mariozechner/pi-coding-agent';
+import type { CommandDeps } from '../types.ts';
+export declare function cmdTemplates(_args: string, ctx: ExtensionCommandContext, deps: CommandDeps): Promise<void>;

package/dist/cmds/shared.d.ts

@@ -0,0 +1,19 @@
+import type { WorktreeCreatedContext } from '../types.ts';
+import { WorktreeSettingsConfig } from '../services/config/schema.ts';
+export interface OnCreateResult {
+    success: boolean;
+    executed: string[];
+    failed?: {
+        command: string;
+        code: number;
+        error: string;
+    };
+}
+export interface OnCreateHookOptions {
+    logPath?: string;
+}
+/**
+ * Runs post-create hooks sequentially.
+ * Stops at first failure and reports the failing command.
+ */
+export declare function runOnCreateHook(createdCtx: WorktreeCreatedContext, settings: WorktreeSettingsConfig, notify: (msg: string, type: 'info' | 'error' | 'warning') => void, options?: OnCreateHookOptions): Promise<OnCreateResult>;

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Worktree Extension - Git worktree management for isolated workspaces
+ *
+ * Provides commands to create, list, and manage git worktrees for feature development.
+ * Codifies the patterns from the using-git-worktrees skill into an interactive command.
+ */
+import type { ExtensionFactory } from '@mariozechner/pi-coding-agent';
+declare const PiWorktreeExtension: ExtensionFactory;
+export default PiWorktreeExtension;