@zenobius/pi-worktrees 0.1.0 → 0.2.0

package/dist/services/config/config.d.ts

@@ -0,0 +1,62 @@
+import { PiWorktreeConfig, WorktreeSettingsConfig } from './schema.ts';
+export declare function createPiWorktreeConfigService(): Promise<{
+    worktrees: Map<string, {
+        parentDir?: string | undefined;
+        onCreate?: string | string[] | undefined;
+        worktreeRoot?: string | undefined;
+    }>;
+    current: (ctx: {
+        cwd: string;
+    }) => {
+        repo: string | null;
+        project: string;
+        mainWorktree: string;
+        parentDir: string;
+        logfile: string;
+        matchedPattern: string | null;
+        onCreate?: string | string[] | undefined;
+        worktreeRoot?: string | undefined;
+    };
+    save: (data: PiWorktreeConfig) => Promise<void>;
+    config: {
+        worktrees?: import("typebox").StaticRecord<[], "Encode", {}, {
+            worktrees: import("typebox").TOptional<import("typebox").TRecord<"^.*$", import("typebox").TObject<{
+                worktreeRoot: import("typebox").TOptional<import("typebox").TString>;
+                parentDir: import("typebox").TOptional<import("typebox").TString>;
+                onCreate: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TString, import("typebox").TArray<import("typebox").TString>]>>;
+            }>>>;
+            matchingStrategy: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TLiteral<"fail-on-tie">, import("typebox").TLiteral<"first-wins">, import("typebox").TLiteral<"last-wins">]>>;
+            logfile: import("typebox").TOptional<import("typebox").TString>;
+        }, "^.*$", import("typebox").TObject<{
+            worktreeRoot: import("typebox").TOptional<import("typebox").TString>;
+            parentDir: import("typebox").TOptional<import("typebox").TString>;
+            onCreate: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TString, import("typebox").TArray<import("typebox").TString>]>>;
+        }>> | undefined;
+        logfile?: string | undefined;
+        matchingStrategy?: "fail-on-tie" | "first-wins" | "last-wins" | undefined;
+    };
+    ready: Promise<void>;
+    set(key: string, value: unknown, target?: "home" | "project"): Promise<void>;
+    reload(): Promise<void>;
+    events: import("@zenobius/pi-extension-config").ConfigEventEmitter<{
+        worktrees?: import("typebox").StaticRecord<[], "Encode", {}, {
+            worktrees: import("typebox").TOptional<import("typebox").TRecord<"^.*$", import("typebox").TObject<{
+                worktreeRoot: import("typebox").TOptional<import("typebox").TString>;
+                parentDir: import("typebox").TOptional<import("typebox").TString>;
+                onCreate: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TString, import("typebox").TArray<import("typebox").TString>]>>;
+            }>>>;
+            matchingStrategy: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TLiteral<"fail-on-tie">, import("typebox").TLiteral<"first-wins">, import("typebox").TLiteral<"last-wins">]>>;
+            logfile: import("typebox").TOptional<import("typebox").TString>;
+        }, "^.*$", import("typebox").TObject<{
+            worktreeRoot: import("typebox").TOptional<import("typebox").TString>;
+            parentDir: import("typebox").TOptional<import("typebox").TString>;
+            onCreate: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TString, import("typebox").TArray<import("typebox").TString>]>>;
+        }>> | undefined;
+        logfile?: string | undefined;
+        matchingStrategy?: "fail-on-tie" | "first-wins" | "last-wins" | undefined;
+    }>;
+}>;
+export declare const DefaultWorktreeSettings: WorktreeSettingsConfig;
+export declare const DefaultLogfileTemplate = "/tmp/pi-worktree-{sessionId}-{name}.log";
+export type PiWorktreeConfigService = Awaited<ReturnType<typeof createPiWorktreeConfigService>>;
+export type PiWorktreeConfiguredWorktreeMap = PiWorktreeConfigService['worktrees'];

package/dist/services/config/migrations/01-flat-single.d.ts

@@ -0,0 +1,2 @@
+import { type Migration } from '@zenobius/pi-extension-config';
+export declare const migration: Migration;

package/dist/services/config/migrations/02-worktree-to-worktrees.d.ts

@@ -0,0 +1,2 @@
+import { type Migration } from '@zenobius/pi-extension-config';
+export declare const migration: Migration;

package/dist/services/config/migrations/03-parentDir-to-worktreeRoot.d.ts

@@ -0,0 +1,2 @@
+import { type Migration } from '@zenobius/pi-extension-config';
+export declare const migration: Migration;

package/dist/services/config/schema.d.ts

@@ -0,0 +1,25 @@
+import { Static } from 'typebox';
+declare const WorktreeSettingsSchema: import("typebox").TObject<{
+    worktreeRoot: import("typebox").TOptional<import("typebox").TString>;
+    parentDir: import("typebox").TOptional<import("typebox").TString>;
+    onCreate: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TString, import("typebox").TArray<import("typebox").TString>]>>;
+}>;
+declare const MatchingStrategySchema: import("typebox").TUnion<[import("typebox").TLiteral<"fail-on-tie">, import("typebox").TLiteral<"first-wins">, import("typebox").TLiteral<"last-wins">]>;
+declare const MatchStrategyResultSchema: import("typebox").TUnion<[import("typebox").TLiteral<"exact">, import("typebox").TLiteral<"unmatched">]>;
+export declare const PiWorktreeConfigSchema: import("typebox").TObject<{
+    worktrees: import("typebox").TOptional<import("typebox").TRecord<"^.*$", import("typebox").TObject<{
+        worktreeRoot: import("typebox").TOptional<import("typebox").TString>;
+        parentDir: import("typebox").TOptional<import("typebox").TString>;
+        onCreate: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TString, import("typebox").TArray<import("typebox").TString>]>>;
+    }>>>;
+    matchingStrategy: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TLiteral<"fail-on-tie">, import("typebox").TLiteral<"first-wins">, import("typebox").TLiteral<"last-wins">]>>;
+    logfile: import("typebox").TOptional<import("typebox").TString>;
+}>;
+export type WorktreeSettingsConfig = Static<typeof WorktreeSettingsSchema>;
+export type MatchingStrategy = Static<typeof MatchingStrategySchema>;
+export type MatchingStrategyResult = Static<typeof MatchStrategyResultSchema>;
+export type PiWorktreeConfig = Static<typeof PiWorktreeConfigSchema>;
+export type PiWorktreeRecord = NonNullable<PiWorktreeConfig['worktrees']>;
+export type PiWorktreeLogTemplate = NonNullable<PiWorktreeConfig['logfile']>;
+export declare function getConfiguredWorktreeRoot(settings: WorktreeSettingsConfig): string | undefined;
+export {};

package/dist/services/git.d.ts

@@ -0,0 +1,83 @@
+import { MatchingStrategy, WorktreeSettingsConfig } from './config/schema.ts';
+import { PiWorktreeConfiguredWorktreeMap } from './config/config.ts';
+export interface WorktreeInfo {
+    path: string;
+    branch: string;
+    head: string;
+    isMain: boolean;
+    isCurrent: boolean;
+}
+/**
+ * Execute a git command and return stdout.
+ */
+export declare function git(args: string[], cwd?: string): string;
+/**
+ * Get git remote URL for repository.
+ */
+export declare function getRemoteUrl(cwd: string, remote?: string): string | null;
+/**
+ * Check if we're in a git repository.
+ */
+export declare function isGitRepo(cwd: string): boolean;
+/**
+ * Get the main worktree path (handles both regular repos and worktrees).
+ */
+export declare function getMainWorktreePath(cwd: string): string;
+/**
+ * Get the project name from the main worktree path.
+ */
+export declare function getProjectName(cwd: string): string;
+/**
+ * Check if current directory is a worktree (not the main repo).
+ */
+export declare function isWorktree(cwd: string): boolean;
+/**
+ * Get current branch name.
+ */
+export declare function getCurrentBranch(cwd: string): string;
+/**
+ * List all worktrees.
+ */
+export declare function listWorktrees(cwd: string): WorktreeInfo[];
+/**
+ * Check if a target path is inside the repository root.
+ */
+export declare function isPathInsideRepo(repoPath: string, targetPath: string): boolean;
+/**
+ * Resolve the parent directory used for worktrees.
+ *
+ * Attempts to match to a configured repo, or defaults to using current git repos main worktree
+ */
+export declare function getWorktreeParentDir(cwd: string, repos: PiWorktreeConfiguredWorktreeMap, matchStrategy?: MatchingStrategy): string;
+/**
+ * Ensure worktree dir is excluded from git tracking when it lives inside repo.
+ */
+export declare function ensureExcluded(cwd: string, worktreeParentDir: string): void;
+export interface MatchResult {
+    settings: WorktreeSettingsConfig;
+    matchedPattern: string | null;
+}
+export interface TieConflictError {
+    patterns: string[];
+    url: string;
+    message: string;
+}
+export interface ScoredMatch {
+    pattern: string;
+    normalizedPattern: string;
+    specificity: number;
+}
+export type Result = ({
+    type: 'exact';
+} & MatchResult) | ({
+    type: 'no-match';
+} & MatchResult) | ({
+    type: 'default';
+} & MatchResult) | ({
+    type: 'tie-conflict';
+} & TieConflictError) | ({
+    type: 'first-wins';
+} & MatchResult) | ({
+    type: 'last-wins';
+} & MatchResult);
+export declare function matchRepo(url: string | null, repos: PiWorktreeConfiguredWorktreeMap, matchStrategy?: MatchingStrategy): Result;

package/dist/services/glob.d.ts

@@ -0,0 +1 @@
+export declare function globMatch(input: string, pattern: string): boolean;

package/dist/services/templates.d.ts

@@ -0,0 +1,8 @@
+export interface TemplateContext {
+    path: string;
+    name: string;
+    branch: string;
+    project: string;
+    mainWorktree: string;
+}
+export declare function expandTemplate(template: string, ctx: TemplateContext): string;

package/dist/types.d.ts

@@ -0,0 +1,15 @@
+import type { ExtensionCommandContext } from '@mariozechner/pi-coding-agent';
+import type { PiWorktreeConfigService } from './services/config/config.ts';
+import { WorktreeSettingsConfig } from './services/config/schema.ts';
+export interface WorktreeCreatedContext {
+    path: string;
+    name: string;
+    branch: string;
+    project: string;
+    mainWorktree: string;
+}
+export interface CommandDeps {
+    settings: WorktreeSettingsConfig;
+    configService: PiWorktreeConfigService;
+}
+export type CmdHandler = (...args: [string, ExtensionCommandContext, CommandDeps]) => Promise<void>;

package/dist/ui/templatePreview.d.ts

@@ -0,0 +1,21 @@
+import type { Theme } from '@mariozechner/pi-coding-agent';
+export interface TemplateToken {
+    token: string;
+    value: string;
+    source: string;
+}
+type TemplatePreviewTheme = Pick<Theme, 'fg' | 'bold'>;
+interface TemplatePreviewInput {
+    cwd: string;
+    currentBranch: string;
+    parentDirTemplate: string;
+    parentDirPreview: string;
+    sampleFeatureName: string;
+    tokens: TemplateToken[];
+}
+export declare function createTemplatePreviewComponent(input: TemplatePreviewInput, theme: TemplatePreviewTheme, done: () => void): {
+    render: (width: number) => string[];
+    invalidate: () => void;
+    handleInput: (data: string) => void;
+};
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenobius/pi-worktrees",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Worktrees extension for Pi Coding Agent",
   "author": {
     "name": "Zenobius",
@@ -28,14 +28,19 @@
     "dist",
     "README.md"
   ],
+  "pi": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
   "dependencies": {
     "@mariozechner/pi-coding-agent": "~0.52.9",
     "@mariozechner/pi-tui": "~0.52.9",
-    "nconf": "^0.13.0",
+    "@zenobius/pi-extension-config": "^0.2.0",
     "typebox": "^1.0.81"
   },
   "devDependencies": {
-    "@types/nconf": "^0.10.7",
+    "@arethetypeswrong/cli": "^0.18.2",
     "@eslint/js": "^9.39.1",
     "@types/node": "^20.11.5",
     "@typescript-eslint/eslint-plugin": "8.47.0",