@seawork/server 1.0.0

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

@@ -0,0 +1,144 @@
+export interface WorktreeConfig {
+    branchName: string;
+    worktreePath: string;
+}
+export type WorktreeRuntimeEnv = {
+    SEAWORK_SOURCE_CHECKOUT_PATH: string;
+    SEAWORK_ROOT_PATH: string;
+    SEAWORK_WORKTREE_PATH: string;
+    SEAWORK_BRANCH_NAME: string;
+    SEAWORK_WORKTREE_PORT: string;
+};
+export type WorktreeSetupCommandResult = {
+    command: string;
+    cwd: string;
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    durationMs: number;
+};
+export type WorktreeSetupCommandProgressEvent = {
+    type: "command_started";
+    index: number;
+    total: number;
+    command: string;
+    cwd: string;
+} | {
+    type: "output";
+    index: number;
+    total: number;
+    command: string;
+    cwd: string;
+    stream: "stdout" | "stderr";
+    chunk: string;
+} | {
+    type: "command_completed";
+    index: number;
+    total: number;
+    command: string;
+    cwd: string;
+    exitCode: number | null;
+    durationMs: number;
+    stdout: string;
+    stderr: string;
+};
+export interface WorktreeTerminalConfig {
+    name?: string;
+    command: string;
+}
+export declare class WorktreeSetupError extends Error {
+    readonly results: WorktreeSetupCommandResult[];
+    constructor(message: string, results: WorktreeSetupCommandResult[]);
+}
+export type WorktreeTeardownCommandResult = WorktreeSetupCommandResult;
+export declare class WorktreeTeardownError extends Error {
+    readonly results: WorktreeTeardownCommandResult[];
+    constructor(message: string, results: WorktreeTeardownCommandResult[]);
+}
+export interface SeaworkWorktreeInfo {
+    path: string;
+    createdAt: string;
+    branchName?: string;
+    head?: string;
+}
+export type SeaworkWorktreeOwnership = {
+    allowed: boolean;
+    repoRoot?: string;
+    worktreeRoot?: string;
+    worktreePath?: string;
+};
+interface CreateWorktreeOptions {
+    branchName: string;
+    cwd: string;
+    baseBranch: string;
+    worktreeSlug?: string;
+    runSetup?: boolean;
+    seaworkHome?: string;
+}
+export declare function getWorktreeSetupCommands(repoRoot: string): string[];
+export declare function getWorktreeTeardownCommands(repoRoot: string): string[];
+export declare function getWorktreeTerminalSpecs(repoRoot: string): WorktreeTerminalConfig[];
+export declare function runWorktreeSetupCommands(options: {
+    worktreePath: string;
+    branchName: string;
+    cleanupOnFailure: boolean;
+    repoRootPath?: string;
+    runtimeEnv?: WorktreeRuntimeEnv;
+    onEvent?: (event: WorktreeSetupCommandProgressEvent) => void;
+}): Promise<WorktreeSetupCommandResult[]>;
+export declare function resolveWorktreeRuntimeEnv(options: {
+    worktreePath: string;
+    branchName?: string;
+    repoRootPath?: string;
+}): Promise<WorktreeRuntimeEnv>;
+export declare function runWorktreeTeardownCommands(options: {
+    worktreePath: string;
+    branchName?: string;
+    repoRootPath?: string;
+}): Promise<WorktreeTeardownCommandResult[]>;
+/**
+ * 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 deriveWorktreeProjectHash(cwd: string): Promise<string>;
+export declare function getSeaworkWorktreesRoot(cwd: string, seaworkHome?: string): Promise<string>;
+export declare function computeWorktreePath(cwd: string, slug: string, seaworkHome?: string): Promise<string>;
+export declare function isSeaworkOwnedWorktreeCwd(cwd: string, options?: {
+    seaworkHome?: string;
+}): Promise<SeaworkWorktreeOwnership>;
+export declare function listSeaworkWorktrees({ cwd, seaworkHome, }: {
+    cwd: string;
+    seaworkHome?: string;
+}): Promise<SeaworkWorktreeInfo[]>;
+export declare function resolveSeaworkWorktreeRootForCwd(cwd: string, options?: {
+    seaworkHome?: string;
+}): Promise<{
+    repoRoot: string;
+    worktreeRoot: string;
+    worktreePath: string;
+} | null>;
+export declare function deleteSeaworkWorktree({ cwd, worktreePath, worktreeSlug, seaworkHome, }: {
+    cwd: string;
+    worktreePath?: string;
+    worktreeSlug?: string;
+    seaworkHome?: string;
+}): Promise<void>;
+/**
+ * Create a git worktree with proper naming conventions
+ */
+export declare function createWorktree({ branchName, cwd, baseBranch, worktreeSlug, runSetup, seaworkHome, }: 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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"}