branch-nexus 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,326 @@
+import { z } from 'zod';
+
+declare const LayoutSchema: z.ZodEnum<["horizontal", "vertical", "grid"]>;
+type Layout = z.infer<typeof LayoutSchema>;
+declare const CleanupPolicySchema: z.ZodEnum<["session", "persistent"]>;
+type CleanupPolicy = z.infer<typeof CleanupPolicySchema>;
+declare const ColorThemeSchema: z.ZodEnum<["cyan", "green", "magenta", "blue", "yellow", "red"]>;
+type ColorTheme = z.infer<typeof ColorThemeSchema>;
+declare const TerminalRuntimeSchema: z.ZodEnum<["wsl", "powershell", "native"]>;
+type TerminalRuntime = z.infer<typeof TerminalRuntimeSchema>;
+declare const RepositoryCacheEntrySchema: z.ZodObject<{
+    full_name: z.ZodString;
+    clone_url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    full_name: string;
+    clone_url: string;
+}, {
+    full_name: string;
+    clone_url: string;
+}>;
+type RepositoryCacheEntry = z.infer<typeof RepositoryCacheEntrySchema>;
+declare const PresetConfigSchema: z.ZodObject<{
+    layout: z.ZodEnum<["horizontal", "vertical", "grid"]>;
+    panes: z.ZodNumber;
+    cleanup: z.ZodEnum<["session", "persistent"]>;
+}, "strip", z.ZodTypeAny, {
+    layout: "horizontal" | "vertical" | "grid";
+    panes: number;
+    cleanup: "session" | "persistent";
+}, {
+    layout: "horizontal" | "vertical" | "grid";
+    panes: number;
+    cleanup: "session" | "persistent";
+}>;
+type PresetConfig = z.infer<typeof PresetConfigSchema>;
+declare const AppConfigSchema: z.ZodObject<{
+    defaultRoot: z.ZodDefault<z.ZodString>;
+    remoteRepoUrl: z.ZodDefault<z.ZodString>;
+    githubToken: z.ZodDefault<z.ZodString>;
+    githubRepositoriesCache: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        full_name: z.ZodString;
+        clone_url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        full_name: string;
+        clone_url: string;
+    }, {
+        full_name: string;
+        clone_url: string;
+    }>, "many">>;
+    githubBranchesCache: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+    defaultLayout: z.ZodDefault<z.ZodEnum<["horizontal", "vertical", "grid"]>>;
+    defaultPanes: z.ZodDefault<z.ZodNumber>;
+    cleanupPolicy: z.ZodDefault<z.ZodEnum<["session", "persistent"]>>;
+    tmuxAutoInstall: z.ZodDefault<z.ZodBoolean>;
+    wslDistribution: z.ZodDefault<z.ZodString>;
+    terminalDefaultRuntime: z.ZodDefault<z.ZodEnum<["wsl", "powershell", "native"]>>;
+    terminalMaxCount: z.ZodDefault<z.ZodNumber>;
+    sessionRestoreEnabled: z.ZodDefault<z.ZodBoolean>;
+    lastSession: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    colorTheme: z.ZodDefault<z.ZodEnum<["cyan", "green", "magenta", "blue", "yellow", "red"]>>;
+    presets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        layout: z.ZodEnum<["horizontal", "vertical", "grid"]>;
+        panes: z.ZodNumber;
+        cleanup: z.ZodEnum<["session", "persistent"]>;
+    }, "strip", z.ZodTypeAny, {
+        layout: "horizontal" | "vertical" | "grid";
+        panes: number;
+        cleanup: "session" | "persistent";
+    }, {
+        layout: "horizontal" | "vertical" | "grid";
+        panes: number;
+        cleanup: "session" | "persistent";
+    }>>>;
+    commandHooks: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    defaultRoot: string;
+    remoteRepoUrl: string;
+    githubToken: string;
+    githubRepositoriesCache: {
+        full_name: string;
+        clone_url: string;
+    }[];
+    githubBranchesCache: Record<string, string[]>;
+    defaultLayout: "horizontal" | "vertical" | "grid";
+    defaultPanes: number;
+    cleanupPolicy: "session" | "persistent";
+    tmuxAutoInstall: boolean;
+    wslDistribution: string;
+    terminalDefaultRuntime: "wsl" | "powershell" | "native";
+    terminalMaxCount: number;
+    sessionRestoreEnabled: boolean;
+    lastSession: Record<string, unknown>;
+    colorTheme: "cyan" | "green" | "magenta" | "blue" | "yellow" | "red";
+    presets: Record<string, {
+        layout: "horizontal" | "vertical" | "grid";
+        panes: number;
+        cleanup: "session" | "persistent";
+    }>;
+    commandHooks: Record<string, string[]>;
+}, {
+    defaultRoot?: string | undefined;
+    remoteRepoUrl?: string | undefined;
+    githubToken?: string | undefined;
+    githubRepositoriesCache?: {
+        full_name: string;
+        clone_url: string;
+    }[] | undefined;
+    githubBranchesCache?: Record<string, string[]> | undefined;
+    defaultLayout?: "horizontal" | "vertical" | "grid" | undefined;
+    defaultPanes?: number | undefined;
+    cleanupPolicy?: "session" | "persistent" | undefined;
+    tmuxAutoInstall?: boolean | undefined;
+    wslDistribution?: string | undefined;
+    terminalDefaultRuntime?: "wsl" | "powershell" | "native" | undefined;
+    terminalMaxCount?: number | undefined;
+    sessionRestoreEnabled?: boolean | undefined;
+    lastSession?: Record<string, unknown> | undefined;
+    colorTheme?: "cyan" | "green" | "magenta" | "blue" | "yellow" | "red" | undefined;
+    presets?: Record<string, {
+        layout: "horizontal" | "vertical" | "grid";
+        panes: number;
+        cleanup: "session" | "persistent";
+    }> | undefined;
+    commandHooks?: Record<string, string[]> | undefined;
+}>;
+type AppConfig = z.infer<typeof AppConfigSchema>;
+declare const DEFAULT_CONFIG: AppConfig;
+
+declare enum ExitCode {
+    SUCCESS = 0,
+    INVALID_ARGS = 2,
+    CONFIG_ERROR = 3,
+    RUNTIME_ERROR = 4,
+    GIT_ERROR = 5,
+    TMUX_ERROR = 6,
+    VALIDATION_ERROR = 7,
+    UNSUPPORTED_PLATFORM = 8
+}
+declare class BranchNexusError extends Error {
+    readonly code: ExitCode;
+    readonly hint: string;
+    constructor(message: string, code?: ExitCode, hint?: string);
+    toString(): string;
+}
+declare function userFacingError(message: string, hint?: string): string;
+
+interface WorktreeAssignment {
+    pane: number;
+    repoPath: string;
+    branch: string;
+}
+interface ManagedWorktree {
+    pane: number;
+    repoPath: string;
+    branch: string;
+    path: string;
+}
+
+declare function getConfigPath(): string;
+declare function loadConfig(): AppConfig;
+declare function saveConfig(config: AppConfig): void;
+
+declare function savePreset(name: string, preset: PresetConfig): void;
+declare function loadPresets(): Record<string, PresetConfig>;
+declare function applyPreset(name: string): PresetConfig;
+declare function deletePreset(name: string): void;
+declare function renamePreset(oldName: string, newName: string): void;
+
+interface OrchestrationRequest {
+    distribution: string;
+    availableDistributions: string[];
+    layout: Layout;
+    cleanupPolicy: CleanupPolicy;
+    assignments: WorktreeAssignment[];
+    worktreeBase: string;
+    sessionName?: string;
+    tmuxAutoInstall: boolean;
+    colorTheme?: ColorTheme;
+    paneNames?: string[];
+    displayBranches?: string[];
+    startupCommands?: string[];
+}
+interface OrchestrationResult {
+    worktrees: ManagedWorktree[];
+    executedCommands: string[][];
+}
+declare function orchestrate(request: OrchestrationRequest): Promise<OrchestrationResult>;
+
+declare class WorktreeManager {
+    private baseDir;
+    private cleanupPolicy;
+    private posixMode;
+    private managed;
+    constructor(baseDir: string, cleanupPolicy?: CleanupPolicy);
+    setPosixMode(enabled: boolean): void;
+    private safe;
+    private asPosix;
+    private commandPath;
+    buildWorktreePath(assignment: WorktreeAssignment): string;
+    addWorktree(assignment: WorktreeAssignment, distribution?: string): Promise<ManagedWorktree>;
+    private getCurrentBranch;
+    materialize(assignments: WorktreeAssignment[], distribution?: string): Promise<ManagedWorktree[]>;
+    checkDirty(worktree: ManagedWorktree, distribution?: string): Promise<boolean>;
+    cleanup(options?: {
+        force?: boolean;
+        selected?: ManagedWorktree[];
+        ignorePolicy?: boolean;
+        distribution?: string;
+    }): Promise<string[]>;
+    getManaged(): ManagedWorktree[];
+    getCleanupPolicy(): CleanupPolicy;
+    private isUnderBaseDir;
+    private getWorktreesForBranch;
+}
+
+interface BranchListResult {
+    branches: string[];
+    warning?: string;
+}
+declare function listLocalBranches(repoPath: string): Promise<BranchListResult>;
+
+declare function validateLayout(layout: string, panes: number): void;
+declare function buildLayoutCommands(sessionName: string, layout: Layout, panePaths: string[], colorTheme?: ColorTheme, paneBranches?: string[], paneNames?: string[], startupCommands?: string[]): string[][];
+
+declare function startSession(sessionName: string, commands: string[][], distribution?: string): Promise<void>;
+declare function killSession(sessionName: string, distribution?: string): Promise<void>;
+declare function sessionExists(sessionName: string, distribution?: string): Promise<boolean>;
+declare function attachSession(sessionName: string, distribution?: string): Promise<void>;
+declare function listSessions(distribution?: string): Promise<string[]>;
+
+declare enum Platform {
+    WINDOWS = "windows",
+    MACOS = "macos",
+    LINUX = "linux"
+}
+declare function detectPlatform(): Platform;
+declare function hasTmux(): Promise<boolean>;
+declare function expandHomeDir(filepath: string): string;
+
+declare function listDistributions(): Promise<string[]>;
+declare function buildWslCommand(distribution: string, command: string[]): string[];
+declare function toWslPath(distribution: string, hostPath: string): Promise<string>;
+
+interface ShellResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+interface RunCommandOptions {
+    cwd?: string;
+    timeout?: number;
+    captureOutput?: boolean;
+    input?: string;
+}
+declare function runCommand$1(command: string[], options?: RunCommandOptions): Promise<ShellResult>;
+declare function runCommandViaWSL(distribution: string, command: string[], options?: RunCommandOptions): Promise<ShellResult>;
+
+interface RunOptions {
+    root?: string;
+    layout?: Layout;
+    panes?: number;
+    cleanup?: CleanupPolicy;
+    fresh?: boolean;
+    terminalTemplate?: string;
+    maxTerminals?: number;
+    logLevel?: string;
+    logFile?: string;
+    session?: string;
+    hooks?: boolean;
+}
+declare function runCommand(options: RunOptions): Promise<void>;
+
+declare function configCommand(action?: string, key?: string, value?: string): void;
+
+declare function killCommand(sessionName?: string): Promise<void>;
+
+declare function presetCommand(action?: string, name?: string, extra?: string): void;
+
+declare function statusCommand(): Promise<void>;
+
+declare function attachCommand(sessionName?: string): Promise<void>;
+
+declare function initCommand(): Promise<void>;
+
+interface HookExecution {
+    command: string;
+    success: boolean;
+    returncode: number;
+    output: string;
+}
+interface HookRunResult {
+    pane: number;
+    executions: HookExecution[];
+    hasFailures: boolean;
+}
+declare class HookRunner {
+    private timeoutSeconds;
+    private trustedConfig;
+    private allowCommandPrefixes;
+    constructor(options?: {
+        timeoutSeconds?: number;
+        trustedConfig?: boolean;
+        allowCommandPrefixes?: string[];
+    });
+    private isCommandAllowed;
+    run(pane: number, commands: string[], distribution?: string): Promise<HookRunResult>;
+}
+
+interface GitHubRepo {
+    fullName: string;
+    cloneUrl: string;
+}
+interface GitHubBranch {
+    name: string;
+    isDefault: boolean;
+}
+declare class GitHubClient {
+    private token;
+    constructor(token?: string);
+    private fetch;
+    listRepositories(): Promise<GitHubRepo[]>;
+    listBranches(owner: string, repo: string): Promise<GitHubBranch[]>;
+    getDefaultBranch(owner: string, repo: string): Promise<string>;
+}
+
+export { type AppConfig, type BranchListResult, BranchNexusError, type CleanupPolicy, DEFAULT_CONFIG, ExitCode, type GitHubBranch, GitHubClient, type GitHubRepo, type HookExecution, type HookRunResult, HookRunner, type Layout, type OrchestrationRequest, type OrchestrationResult, Platform, type PresetConfig, type RepositoryCacheEntry, type ShellResult, type TerminalRuntime, WorktreeManager, applyPreset, attachCommand, attachSession, buildLayoutCommands, buildWslCommand, configCommand, deletePreset, detectPlatform, expandHomeDir, getConfigPath, hasTmux, initCommand, killCommand, killSession, listDistributions, listLocalBranches, listSessions, loadConfig, loadPresets, orchestrate, presetCommand, renamePreset, runCommand as run, runCommand$1 as runCommand, runCommandViaWSL, saveConfig, savePreset, sessionExists, startSession, statusCommand, toWslPath, userFacingError, validateLayout };