@junctionpanel/server 0.1.16

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

@@ -0,0 +1,175 @@
+export interface WorktreeConfig {
+    branchName: string;
+    worktreePath: string;
+}
+export type WorktreeRuntimeEnv = {
+    JUNCTION_SOURCE_CHECKOUT_PATH: string;
+    JUNCTION_ROOT_PATH: string;
+    JUNCTION_WORKTREE_PATH: string;
+    JUNCTION_BRANCH_NAME: string;
+    JUNCTION_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 WorktreeDestroyCommandResult = WorktreeSetupCommandResult;
+export declare class WorktreeDestroyError extends Error {
+    readonly results: WorktreeDestroyCommandResult[];
+    constructor(message: string, results: WorktreeDestroyCommandResult[]);
+}
+export interface JunctionWorktreeInfo {
+    path: string;
+    branchName?: string;
+    head?: string;
+}
+export type JunctionWorktreeOwnership = {
+    allowed: boolean;
+    repoRoot?: string;
+    worktreeRoot?: string;
+    worktreePath?: string;
+};
+interface CreateWorktreeOptions {
+    branchName: string;
+    cwd: string;
+    baseBranch: string;
+    worktreeSlug?: string;
+    runSetup?: boolean;
+    junctionHome?: string;
+}
+export declare function getWorktreeSetupCommands(repoRoot: string): string[];
+export declare function getWorktreeDestroyCommands(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 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 deriveWorktreeProjectHash(cwd: string): Promise<string>;
+export declare function isJunctionOwnedWorktreeCwd(cwd: string, options?: {
+    junctionHome?: string;
+}): Promise<JunctionWorktreeOwnership>;
+export declare function listJunctionWorktrees({ cwd, junctionHome, }: {
+    cwd: string;
+    junctionHome?: string;
+}): Promise<JunctionWorktreeInfo[]>;
+export declare function resolveJunctionWorktreeRootForCwd(cwd: string, options?: {
+    junctionHome?: string;
+}): Promise<{
+    repoRoot: string;
+    worktreeRoot: string;
+    worktreePath: string;
+} | null>;
+export declare function deleteJunctionWorktree({ cwd, worktreePath, worktreeSlug, junctionHome, }: {
+    cwd: string;
+    worktreePath?: string;
+    worktreeSlug?: string;
+    junctionHome?: string;
+}): Promise<void>;
+/**
+ * Create a git worktree with proper naming conventions
+ */
+export declare function createWorktree({ branchName, cwd, baseBranch, worktreeSlug, runSetup, junctionHome, }: CreateWorktreeOptions): Promise<WorktreeConfig>;
+export interface InRepoWorktreeConfig extends WorktreeConfig {
+    slug: string;
+}
+/**
+ * Get the root directory for in-repo worktrees: `{repoRoot}/.junction`
+ */
+export declare function getInRepoWorktreesRoot(repoRoot: string): string;
+/**
+ * List existing worktree directory names inside `{repoRoot}/.junction/`.
+ */
+export declare function listInRepoWorktreeNames(repoRoot: string): string[];
+/**
+ * Ensure `.junction/` is ignored without mutating tracked files.
+ *
+ * Preference order:
+ * 1) If repo `.gitignore` already covers `.junction/`, do nothing.
+ * 2) Otherwise, append to `.git/info/exclude` (local-only ignore rules).
+ */
+export declare function ensureJunctionGitignore(repoRoot: string): void;
+/**
+ * Check whether a path is already inside an in-repo `.junction/` worktree.
+ */
+export declare function isInsideInRepoWorktree(cwd: string): boolean;
+interface CreateInRepoWorktreeOptions {
+    repoRoot: string;
+    baseBranch: string;
+    runSetup?: boolean;
+}
+/**
+ * Create an in-repo worktree inside `{repoRoot}/.junction/{citySlug}`.
+ *
+ * The branch name is set to the city slug (e.g. "tokyo", "tokyo-v2").
+ */
+export declare function createInRepoWorktree({ repoRoot, baseBranch, runSetup, }: CreateInRepoWorktreeOptions): Promise<InRepoWorktreeConfig>;
+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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"}