gitx.do 0.0.1

package/dist/refs/branch.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Git Branch Operations
+ *
+ * Handles branch creation, deletion, renaming, listing, and tracking.
+ * Works with the RefStorage system for underlying ref management.
+ */
+import { RefStorage } from './storage';
+/**
+ * Branch tracking information
+ */
+export interface BranchTrackingInfo {
+    /** Remote name (e.g., 'origin') */
+    remote: string;
+    /** Remote branch name (e.g., 'refs/remotes/origin/main') */
+    remoteBranch: string;
+    /** Number of commits ahead of upstream */
+    ahead: number;
+    /** Number of commits behind upstream */
+    behind: number;
+    /** Whether the branch is gone from remote */
+    gone: boolean;
+}
+/**
+ * Branch information
+ */
+export interface Branch {
+    /** Short branch name (e.g., 'main', 'feature/foo') */
+    name: string;
+    /** Full ref name (e.g., 'refs/heads/main') */
+    ref: string;
+    /** SHA-1 of the commit this branch points to */
+    sha: string;
+    /** Whether this is the current branch (HEAD points to it) */
+    isCurrent: boolean;
+    /** Whether this is a remote tracking branch */
+    isRemote: boolean;
+    /** Tracking information if the branch tracks an upstream */
+    tracking?: BranchTrackingInfo;
+    /** Last commit message (optional) */
+    lastCommitMessage?: string;
+    /** Last commit author (optional) */
+    lastCommitAuthor?: string;
+    /** Last commit date (optional) */
+    lastCommitDate?: Date;
+}
+/**
+ * Options for creating a branch
+ */
+export interface CreateBranchOptions {
+    /** Start point (SHA, branch name, or ref) - defaults to HEAD */
+    startPoint?: string;
+    /** Force creation even if branch exists (overwrite) */
+    force?: boolean;
+    /** Set up tracking for the new branch */
+    track?: boolean | string;
+    /** Don't actually create the branch, just validate */
+    dryRun?: boolean;
+}
+/**
+ * Options for deleting a branch
+ */
+export interface DeleteBranchOptions {
+    /** Force delete even if not fully merged */
+    force?: boolean;
+    /** Remote branch to delete (for remote tracking branches) */
+    remote?: string;
+    /** Don't actually delete, just validate */
+    dryRun?: boolean;
+}
+/**
+ * Options for renaming a branch
+ */
+export interface RenameBranchOptions {
+    /** Force rename even if target exists (overwrite) */
+    force?: boolean;
+    /** Don't actually rename, just validate */
+    dryRun?: boolean;
+}
+/**
+ * Options for listing branches
+ */
+export interface ListBranchesOptions {
+    /** Include remote tracking branches */
+    includeRemotes?: boolean;
+    /** Only list remote tracking branches */
+    remotesOnly?: boolean;
+    /** Pattern to filter branches (glob-style) */
+    pattern?: string;
+    /** Sort by (name, committerdate, authordate, etc.) */
+    sortBy?: 'name' | 'committerdate' | 'authordate';
+    /** Sort order */
+    sortOrder?: 'asc' | 'desc';
+    /** Include tracking info (slower) */
+    includeTracking?: boolean;
+    /** Include commit info (slower) */
+    includeCommitInfo?: boolean;
+    /** Merged into this ref (filter only merged branches) */
+    mergedInto?: string;
+    /** Not merged into this ref (filter only unmerged branches) */
+    notMergedInto?: string;
+    /** Only show branches that contain this commit */
+    contains?: string;
+    /** Only show branches that don't contain this commit */
+    noContains?: string;
+}
+/**
+ * Options for setting upstream
+ */
+export interface SetUpstreamOptions {
+    /** Remote name */
+    remote?: string;
+    /** Remote branch name */
+    remoteBranch?: string;
+    /** Unset the upstream (remove tracking) */
+    unset?: boolean;
+}
+/**
+ * Result of branch validation
+ */
+export interface BranchValidationResult {
+    /** Whether the name is valid */
+    valid: boolean;
+    /** Error message if invalid */
+    error?: string;
+    /** Normalized branch name */
+    normalized?: string;
+}
+/**
+ * Error thrown when a branch operation fails
+ */
+export declare class BranchError extends Error {
+    readonly code: BranchErrorCode;
+    readonly branchName?: string | undefined;
+    constructor(message: string, code: BranchErrorCode, branchName?: string | undefined);
+}
+export type BranchErrorCode = 'NOT_FOUND' | 'ALREADY_EXISTS' | 'INVALID_NAME' | 'NOT_FULLY_MERGED' | 'CANNOT_DELETE_CURRENT' | 'CHECKOUT_CONFLICT' | 'INVALID_START_POINT' | 'NO_UPSTREAM' | 'DETACHED_HEAD';
+/**
+ * Branch manager for performing branch operations
+ */
+export declare class BranchManager {
+    constructor(storage: RefStorage);
+    /**
+     * Create a new branch
+     */
+    createBranch(_name: string, _options?: CreateBranchOptions): Promise<Branch>;
+    /**
+     * Delete a branch
+     */
+    deleteBranch(_name: string, _options?: DeleteBranchOptions): Promise<void>;
+    /**
+     * Rename a branch
+     */
+    renameBranch(_oldName: string, _newName: string, _options?: RenameBranchOptions): Promise<Branch>;
+    /**
+     * List all branches
+     */
+    listBranches(_options?: ListBranchesOptions): Promise<Branch[]>;
+    /**
+     * Get the current branch
+     */
+    getCurrentBranch(): Promise<Branch | null>;
+    /**
+     * Get a specific branch by name
+     */
+    getBranch(_name: string): Promise<Branch | null>;
+    /**
+     * Check if a branch exists
+     */
+    branchExists(_name: string): Promise<boolean>;
+    /**
+     * Set upstream branch for tracking
+     */
+    setUpstream(_branchName: string, _options: SetUpstreamOptions): Promise<void>;
+    /**
+     * Get tracking info for a branch
+     */
+    getTrackingInfo(_branchName: string): Promise<BranchTrackingInfo | null>;
+    /**
+     * Check if a branch is fully merged into another branch
+     */
+    isMerged(_branchName: string, _into?: string): Promise<boolean>;
+    /**
+     * Force delete an unmerged branch
+     */
+    forceDeleteBranch(_name: string): Promise<void>;
+}
+/**
+ * Validate a branch name according to Git rules
+ * See: https://git-scm.com/docs/git-check-ref-format
+ */
+export declare function validateBranchName(_name: string): BranchValidationResult;
+/**
+ * Check if a string is a valid branch name
+ */
+export declare function isValidBranchName(_name: string): boolean;
+/**
+ * Normalize a branch name (remove refs/heads/ prefix, etc.)
+ */
+export declare function normalizeBranchName(_name: string): string;
+/**
+ * Get the full ref name for a branch
+ */
+export declare function getBranchRefName(_name: string): string;
+/**
+ * Create a new branch (convenience function)
+ */
+export declare function createBranch(_storage: RefStorage, _name: string, _options?: CreateBranchOptions): Promise<Branch>;
+/**
+ * Delete a branch (convenience function)
+ */
+export declare function deleteBranch(_storage: RefStorage, _name: string, _options?: DeleteBranchOptions): Promise<void>;
+/**
+ * Rename a branch (convenience function)
+ */
+export declare function renameBranch(_storage: RefStorage, _oldName: string, _newName: string, _options?: RenameBranchOptions): Promise<Branch>;
+/**
+ * List all branches (convenience function)
+ */
+export declare function listBranches(_storage: RefStorage, _options?: ListBranchesOptions): Promise<Branch[]>;
+/**
+ * Get the current branch (convenience function)
+ */
+export declare function getCurrentBranch(_storage: RefStorage): Promise<Branch | null>;
+//# sourceMappingURL=branch.d.ts.map

package/dist/refs/branch.d.ts.map

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

package/dist/refs/branch.js

@@ -0,0 +1,170 @@
+/**
+ * Git Branch Operations
+ *
+ * Handles branch creation, deletion, renaming, listing, and tracking.
+ * Works with the RefStorage system for underlying ref management.
+ */
+/**
+ * Error thrown when a branch operation fails
+ */
+export class BranchError extends Error {
+    code;
+    branchName;
+    constructor(message, code, branchName) {
+        super(message);
+        this.code = code;
+        this.branchName = branchName;
+        this.name = 'BranchError';
+    }
+}
+/**
+ * Branch manager for performing branch operations
+ */
+export class BranchManager {
+    constructor(storage) {
+        void storage; // Suppress unused variable warning until implementation
+        // TODO: Implement in GREEN phase
+    }
+    /**
+     * Create a new branch
+     */
+    async createBranch(_name, _options) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * Delete a branch
+     */
+    async deleteBranch(_name, _options) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * Rename a branch
+     */
+    async renameBranch(_oldName, _newName, _options) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * List all branches
+     */
+    async listBranches(_options) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * Get the current branch
+     */
+    async getCurrentBranch() {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * Get a specific branch by name
+     */
+    async getBranch(_name) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * Check if a branch exists
+     */
+    async branchExists(_name) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * Set upstream branch for tracking
+     */
+    async setUpstream(_branchName, _options) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * Get tracking info for a branch
+     */
+    async getTrackingInfo(_branchName) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * Check if a branch is fully merged into another branch
+     */
+    async isMerged(_branchName, _into) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * Force delete an unmerged branch
+     */
+    async forceDeleteBranch(_name) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+}
+/**
+ * Validate a branch name according to Git rules
+ * See: https://git-scm.com/docs/git-check-ref-format
+ */
+export function validateBranchName(_name) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Check if a string is a valid branch name
+ */
+export function isValidBranchName(_name) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Normalize a branch name (remove refs/heads/ prefix, etc.)
+ */
+export function normalizeBranchName(_name) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Get the full ref name for a branch
+ */
+export function getBranchRefName(_name) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Create a new branch (convenience function)
+ */
+export async function createBranch(_storage, _name, _options) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Delete a branch (convenience function)
+ */
+export async function deleteBranch(_storage, _name, _options) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Rename a branch (convenience function)
+ */
+export async function renameBranch(_storage, _oldName, _newName, _options) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * List all branches (convenience function)
+ */
+export async function listBranches(_storage, _options) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Get the current branch (convenience function)
+ */
+export async function getCurrentBranch(_storage) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+//# sourceMappingURL=branch.js.map

package/dist/refs/branch.js.map

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

package/dist/refs/storage.d.ts

@@ -0,0 +1,208 @@
+/**
+ * Git Reference Storage
+ *
+ * Handles storage and resolution of Git refs (branches, tags, HEAD).
+ * Supports both loose refs and packed refs formats.
+ */
+export type RefType = 'direct' | 'symbolic';
+/**
+ * Represents a Git reference (branch, tag, HEAD, etc.)
+ */
+export interface Ref {
+    /** Full ref name (e.g., 'refs/heads/main', 'HEAD') */
+    name: string;
+    /** Target - either a SHA-1 hash (direct) or another ref name (symbolic) */
+    target: string;
+    /** Type of reference */
+    type: RefType;
+}
+/**
+ * Options for updating a ref
+ */
+export interface UpdateRefOptions {
+    /** If true, create the ref if it doesn't exist */
+    create?: boolean;
+    /** Expected old value for CAS (compare-and-swap) */
+    oldValue?: string | null;
+    /** Force update even if not a fast-forward */
+    force?: boolean;
+    /** Reason for the update (for reflog) */
+    reason?: string;
+    /** If provided, use this lock instead of acquiring a new one */
+    lock?: RefLock;
+}
+/**
+ * Options for listing refs
+ */
+export interface ListRefsOptions {
+    /** Pattern to filter refs (e.g., 'refs/heads/*') */
+    pattern?: string;
+    /** Include HEAD in the listing */
+    includeHead?: boolean;
+    /** Include symbolic refs */
+    includeSymbolic?: boolean;
+}
+/**
+ * Options for resolving refs
+ */
+export interface ResolveRefOptions {
+    /** Maximum depth for following symbolic refs (default: 10) */
+    maxDepth?: number;
+}
+/**
+ * Result of a ref resolution
+ */
+export interface ResolvedRef {
+    /** The original ref that was resolved */
+    ref: Ref;
+    /** The final SHA-1 target after following all symbolic refs */
+    sha: string;
+    /** Chain of refs followed during resolution */
+    chain: Ref[];
+}
+/**
+ * Error thrown when a ref operation fails
+ */
+export declare class RefError extends Error {
+    readonly code: RefErrorCode;
+    readonly refName?: string | undefined;
+    constructor(message: string, code: RefErrorCode, refName?: string | undefined);
+}
+export type RefErrorCode = 'NOT_FOUND' | 'ALREADY_EXISTS' | 'INVALID_NAME' | 'LOCKED' | 'CONFLICT' | 'CIRCULAR_REF' | 'MAX_DEPTH_EXCEEDED' | 'INVALID_SHA';
+/**
+ * Lock handle for ref updates
+ */
+export interface RefLock {
+    /** The ref being locked */
+    refName: string;
+    /** Release the lock */
+    release(): Promise<void>;
+    /** Check if lock is still held */
+    isHeld(): boolean;
+}
+/**
+ * Storage backend interface for refs
+ */
+export interface RefStorageBackend {
+    /** Read a single ref */
+    readRef(name: string): Promise<Ref | null>;
+    /** Write a ref */
+    writeRef(ref: Ref): Promise<void>;
+    /** Delete a ref */
+    deleteRef(name: string): Promise<boolean>;
+    /** List all refs matching a pattern */
+    listRefs(pattern?: string): Promise<Ref[]>;
+    /** Acquire a lock on a ref */
+    acquireLock(name: string, timeout?: number): Promise<RefLock>;
+    /** Read packed refs */
+    readPackedRefs(): Promise<Map<string, string>>;
+    /** Write packed refs */
+    writePackedRefs(refs: Map<string, string>): Promise<void>;
+}
+/**
+ * Validate a ref name according to Git rules
+ * See: https://git-scm.com/docs/git-check-ref-format
+ */
+export declare function isValidRefName(name: string): boolean;
+/**
+ * Validate a SHA-1 hash
+ */
+export declare function isValidSha(sha: string): boolean;
+/**
+ * Parse a ref file content
+ */
+export declare function parseRefContent(content: string): {
+    type: RefType;
+    target: string;
+};
+/**
+ * Serialize a ref to file content
+ */
+export declare function serializeRefContent(ref: Ref): string;
+/**
+ * Parse packed-refs file content
+ */
+export declare function parsePackedRefs(content: string): Map<string, string>;
+/**
+ * Serialize refs to packed-refs format
+ */
+export declare function serializePackedRefs(refs: Map<string, string>): string;
+/**
+ * Ref storage implementation
+ */
+export declare class RefStorage {
+    private backend;
+    constructor(backend: RefStorageBackend);
+    /**
+     * Get a ref by name
+     */
+    getRef(name: string): Promise<Ref | null>;
+    /**
+     * Resolve a ref to its final SHA target
+     */
+    resolveRef(name: string, options?: ResolveRefOptions): Promise<ResolvedRef>;
+    /**
+     * Update or create a ref
+     *
+     * Note: For atomic operations, callers can acquire a lock via acquireLock()
+     * and pass it via options.lock to avoid double-locking.
+     */
+    updateRef(name: string, target: string, options?: UpdateRefOptions): Promise<Ref>;
+    /**
+     * Delete a ref
+     */
+    deleteRef(name: string, options?: UpdateRefOptions): Promise<boolean>;
+    /**
+     * List refs matching a pattern
+     */
+    listRefs(options?: ListRefsOptions): Promise<Ref[]>;
+    /**
+     * List all branches
+     */
+    listBranches(): Promise<Ref[]>;
+    /**
+     * List all tags
+     */
+    listTags(): Promise<Ref[]>;
+    /**
+     * Get HEAD ref
+     */
+    getHead(): Promise<Ref>;
+    /**
+     * Update HEAD (can be symbolic or detached)
+     */
+    updateHead(target: string, symbolic?: boolean): Promise<Ref>;
+    /**
+     * Check if HEAD is detached
+     */
+    isHeadDetached(): Promise<boolean>;
+    /**
+     * Create a symbolic ref
+     */
+    createSymbolicRef(name: string, target: string): Promise<Ref>;
+    /**
+     * Acquire a lock for updating a ref
+     */
+    acquireLock(name: string, timeout?: number): Promise<RefLock>;
+    /**
+     * Pack loose refs into packed-refs file
+     */
+    packRefs(): Promise<void>;
+}
+/**
+ * Resolve a ref to its final SHA target (convenience function)
+ */
+export declare function resolveRef(storage: RefStorage, name: string, options?: ResolveRefOptions): Promise<string>;
+/**
+ * Update a ref (convenience function)
+ */
+export declare function updateRef(storage: RefStorage, name: string, target: string, options?: UpdateRefOptions): Promise<Ref>;
+/**
+ * Delete a ref (convenience function)
+ */
+export declare function deleteRef(storage: RefStorage, name: string, options?: UpdateRefOptions): Promise<boolean>;
+/**
+ * List refs (convenience function)
+ */
+export declare function listRefs(storage: RefStorage, options?: ListRefsOptions): Promise<Ref[]>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/refs/storage.d.ts.map

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