@getpaseo/server 0.1.2

package/dist/server/utils/worktree-metadata.js

@@ -0,0 +1,74 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { isAbsolute, join, resolve } from "path";
+import { z } from "zod";
+const PaseoWorktreeMetadataSchema = z.object({
+    version: z.literal(1),
+    baseRefName: z.string().min(1),
+});
+function getGitDirForWorktreeRoot(worktreeRoot) {
+    const gitPath = join(worktreeRoot, ".git");
+    if (!existsSync(gitPath)) {
+        throw new Error(`Not a git repository: ${worktreeRoot}`);
+    }
+    // In a worktree checkout, `.git` is a file containing `gitdir: <path>`.
+    // In a normal checkout, `.git` is a directory.
+    try {
+        const gitFileContent = readFileSync(gitPath, "utf8");
+        const match = gitFileContent.match(/gitdir:\s*(.+)/);
+        if (match?.[1]) {
+            const raw = match[1].trim();
+            return isAbsolute(raw) ? raw : resolve(worktreeRoot, raw);
+        }
+    }
+    catch {
+        // If `.git` is a directory, readFileSync will throw; fall through.
+    }
+    return gitPath;
+}
+export function getPaseoWorktreeMetadataPath(worktreeRoot) {
+    const gitDir = getGitDirForWorktreeRoot(worktreeRoot);
+    return join(gitDir, "paseo", "worktree.json");
+}
+export function normalizeBaseRefName(input) {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        throw new Error("Base branch is required");
+    }
+    if (trimmed.startsWith("origin/")) {
+        return trimmed.slice("origin/".length);
+    }
+    return trimmed;
+}
+export function writePaseoWorktreeMetadata(worktreeRoot, options) {
+    const baseRefName = normalizeBaseRefName(options.baseRefName);
+    if (baseRefName === "HEAD") {
+        throw new Error("Base branch cannot be HEAD");
+    }
+    if (baseRefName.includes("..") || baseRefName.includes("@{")) {
+        throw new Error(`Invalid base branch: ${baseRefName}`);
+    }
+    if (!/^[0-9A-Za-z._/-]+$/.test(baseRefName)) {
+        throw new Error(`Invalid base branch: ${baseRefName}`);
+    }
+    const metadataPath = getPaseoWorktreeMetadataPath(worktreeRoot);
+    mkdirSync(join(getGitDirForWorktreeRoot(worktreeRoot), "paseo"), { recursive: true });
+    const metadata = { version: 1, baseRefName };
+    writeFileSync(metadataPath, `${JSON.stringify(metadata, null, 2)}\n`, "utf8");
+}
+export function readPaseoWorktreeMetadata(worktreeRoot) {
+    const metadataPath = getPaseoWorktreeMetadataPath(worktreeRoot);
+    if (!existsSync(metadataPath)) {
+        return null;
+    }
+    const parsed = JSON.parse(readFileSync(metadataPath, "utf8"));
+    return PaseoWorktreeMetadataSchema.parse(parsed);
+}
+export function requirePaseoWorktreeBaseRefName(worktreeRoot) {
+    const metadataPath = getPaseoWorktreeMetadataPath(worktreeRoot);
+    const metadata = readPaseoWorktreeMetadata(worktreeRoot);
+    if (!metadata) {
+        throw new Error(`Missing Paseo worktree base metadata: ${metadataPath}`);
+    }
+    return metadata.baseRefName;
+}
+//# sourceMappingURL=worktree-metadata.js.map

package/dist/server/utils/worktree-metadata.js.map

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

package/dist/server/utils/worktree.d.ts

@@ -0,0 +1,95 @@
+export interface WorktreeConfig {
+    branchName: string;
+    worktreePath: string;
+}
+export type WorktreeSetupCommandResult = {
+    command: string;
+    cwd: string;
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+};
+export declare class WorktreeSetupError extends Error {
+    readonly results: WorktreeSetupCommandResult[];
+    constructor(message: string, results: WorktreeSetupCommandResult[]);
+}
+export type WorktreeDestroyCommandResult = WorktreeSetupCommandResult;
+export declare class WorktreeDestroyError extends Error {
+    readonly results: WorktreeDestroyCommandResult[];
+    constructor(message: string, results: WorktreeDestroyCommandResult[]);
+}
+export interface PaseoWorktreeInfo {
+    path: string;
+    branchName?: string;
+    head?: string;
+}
+export type PaseoWorktreeOwnership = {
+    allowed: boolean;
+    repoRoot?: string;
+    worktreeRoot?: string;
+    worktreePath?: string;
+};
+interface CreateWorktreeOptions {
+    branchName: string;
+    cwd: string;
+    baseBranch: string;
+    worktreeSlug?: string;
+    runSetup?: boolean;
+    paseoHome?: string;
+}
+export declare function getWorktreeSetupCommands(repoRoot: string): string[];
+export declare function getWorktreeDestroyCommands(repoRoot: string): string[];
+export declare function runWorktreeSetupCommands(options: {
+    worktreePath: string;
+    branchName: string;
+    cleanupOnFailure: boolean;
+    repoRootPath?: string;
+}): Promise<WorktreeSetupCommandResult[]>;
+export declare function runWorktreeDestroyCommands(options: {
+    worktreePath: string;
+    branchName?: string;
+    repoRootPath?: string;
+}): Promise<WorktreeDestroyCommandResult[]>;
+/**
+ * Get the git common directory (shared across worktrees) for a given cwd.
+ * This is where refs, objects, etc. are stored.
+ */
+export declare function getGitCommonDir(cwd: string): Promise<string>;
+/**
+ * Validate that a string is a valid git branch name slug
+ * Must be lowercase, alphanumeric, hyphens only
+ */
+export declare function validateBranchSlug(slug: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Convert string to kebab-case for branch names
+ */
+export declare function slugify(input: string): string;
+export declare function isPaseoOwnedWorktreeCwd(cwd: string, options?: {
+    paseoHome?: string;
+}): Promise<PaseoWorktreeOwnership>;
+export declare function listPaseoWorktrees({ cwd, paseoHome, }: {
+    cwd: string;
+    paseoHome?: string;
+}): Promise<PaseoWorktreeInfo[]>;
+export declare function resolvePaseoWorktreeRootForCwd(cwd: string, options?: {
+    paseoHome?: string;
+}): Promise<{
+    repoRoot: string;
+    worktreeRoot: string;
+    worktreePath: string;
+} | null>;
+export declare function deletePaseoWorktree({ cwd, worktreePath, worktreeSlug, paseoHome, }: {
+    cwd: string;
+    worktreePath?: string;
+    worktreeSlug?: string;
+    paseoHome?: string;
+}): Promise<void>;
+/**
+ * Create a git worktree with proper naming conventions
+ */
+export declare function createWorktree({ branchName, cwd, baseBranch, worktreeSlug, runSetup, paseoHome, }: CreateWorktreeOptions): Promise<WorktreeConfig>;
+export {};
+//# sourceMappingURL=worktree.d.ts.map

package/dist/server/utils/worktree.d.ts.map

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