@fractary/faber 0.1.1 → 1.0.1

package/dist/repo/git.d.ts

@@ -0,0 +1,182 @@
+/**
+ * @fractary/faber - Git CLI Wrapper
+ *
+ * Low-level Git operations using the git CLI.
+ */
+import { GitStatus, Commit, CommitOptions, Branch, Tag, Worktree } from '../types';
+/**
+ * Git CLI wrapper class
+ */
+export declare class Git {
+    private cwd;
+    constructor(cwd?: string);
+    /**
+     * Execute a raw git command
+     */
+    exec(args: string): string;
+    /**
+     * Get repository status
+     */
+    getStatus(): GitStatus;
+    /**
+     * Get current branch name
+     */
+    getCurrentBranch(): string;
+    /**
+     * Get tracking info (ahead/behind)
+     */
+    private getTrackingInfo;
+    /**
+     * Get staged files
+     */
+    private getStagedFiles;
+    /**
+     * Get modified files
+     */
+    private getModifiedFiles;
+    /**
+     * Get untracked files
+     */
+    private getUntrackedFiles;
+    /**
+     * Get files with conflicts
+     */
+    private getConflictFiles;
+    /**
+     * Check if working directory has uncommitted changes
+     */
+    isDirty(): boolean;
+    /**
+     * Check if working directory is clean
+     */
+    isClean(): boolean;
+    /**
+     * Create a new branch
+     */
+    createBranch(name: string, baseBranch?: string): void;
+    /**
+     * Switch to a branch
+     */
+    checkout(branch: string): void;
+    /**
+     * Delete a branch
+     */
+    deleteBranch(name: string, force?: boolean): void;
+    /**
+     * Delete a remote branch
+     */
+    deleteRemoteBranch(name: string, remote?: string): void;
+    /**
+     * List local branches
+     */
+    listBranches(): Branch[];
+    /**
+     * Get default branch name
+     */
+    getDefaultBranch(): string;
+    /**
+     * Check if branch is protected (simple heuristic)
+     */
+    isProtectedBranch(name: string): boolean;
+    /**
+     * Check if branch exists
+     */
+    branchExists(name: string): boolean;
+    /**
+     * Stage files
+     */
+    stage(patterns: string[]): void;
+    /**
+     * Stage all changes
+     */
+    stageAll(): void;
+    /**
+     * Unstage files
+     */
+    unstage(patterns: string[]): void;
+    /**
+     * Create a commit
+     */
+    commit(options: CommitOptions): Commit;
+    /**
+     * Get a commit by ref
+     */
+    getCommit(ref: string): Commit;
+    /**
+     * List commits
+     */
+    listCommits(options?: {
+        branch?: string;
+        limit?: number;
+        since?: string;
+    }): Commit[];
+    /**
+     * Get diff
+     */
+    getDiff(options?: {
+        staged?: boolean;
+        base?: string;
+        head?: string;
+    }): string;
+    /**
+     * Push to remote
+     */
+    push(options?: {
+        branch?: string;
+        remote?: string;
+        setUpstream?: boolean;
+        force?: boolean;
+        forceWithLease?: boolean;
+    }): void;
+    /**
+     * Pull from remote
+     */
+    pull(options?: {
+        branch?: string;
+        remote?: string;
+        rebase?: boolean;
+    }): void;
+    /**
+     * Fetch from remote
+     */
+    fetch(remote?: string): void;
+    /**
+     * Create a tag
+     */
+    createTag(name: string, options?: {
+        message?: string;
+        sha?: string;
+    }): void;
+    /**
+     * Delete a tag
+     */
+    deleteTag(name: string): void;
+    /**
+     * Push a tag
+     */
+    pushTag(name: string, remote?: string): void;
+    /**
+     * List tags
+     */
+    listTags(options?: {
+        pattern?: string;
+        limit?: number;
+    }): Tag[];
+    /**
+     * Create a worktree
+     */
+    createWorktree(path: string, branch: string, baseBranch?: string): void;
+    /**
+     * List worktrees
+     */
+    listWorktrees(): Worktree[];
+    /**
+     * Remove a worktree
+     */
+    removeWorktree(path: string, force?: boolean): void;
+    /**
+     * Prune stale worktrees
+     */
+    pruneWorktrees(): void;
+}
+//# sourceMappingURL=git.d.ts.map

package/dist/repo/git.d.ts.map

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

package/dist/repo/git.js

@@ -0,0 +1,496 @@
+"use strict";
+/**
+ * @fractary/faber - Git CLI Wrapper
+ *
+ * Low-level Git operations using the git CLI.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Git = void 0;
+const child_process_1 = require("child_process");
+const errors_1 = require("../errors");
+const config_1 = require("../config");
+/**
+ * Execute a git command
+ */
+function git(args, cwd) {
+    const execOptions = {
+        encoding: 'utf-8',
+        cwd: cwd || (0, config_1.findProjectRoot)(),
+        maxBuffer: 10 * 1024 * 1024,
+    };
+    try {
+        const result = (0, child_process_1.execSync)(`git ${args}`, execOptions);
+        return (typeof result === 'string' ? result : result.toString()).trim();
+    }
+    catch (error) {
+        const err = error;
+        const exitCode = err.status || 1;
+        const stderr = err.stderr?.toString() || '';
+        throw new errors_1.CommandExecutionError(`git ${args}`, exitCode, stderr);
+    }
+}
+/**
+ * Git CLI wrapper class
+ */
+class Git {
+    cwd;
+    constructor(cwd) {
+        this.cwd = cwd || (0, config_1.findProjectRoot)();
+    }
+    /**
+     * Execute a raw git command
+     */
+    exec(args) {
+        return git(args, this.cwd);
+    }
+    // =========================================================================
+    // STATUS & INFO
+    // =========================================================================
+    /**
+     * Get repository status
+     */
+    getStatus() {
+        const branch = this.getCurrentBranch();
+        const tracking = this.getTrackingInfo();
+        const staged = this.getStagedFiles();
+        const modified = this.getModifiedFiles();
+        const untracked = this.getUntrackedFiles();
+        const conflicts = this.getConflictFiles();
+        return {
+            branch,
+            ahead: tracking.ahead,
+            behind: tracking.behind,
+            staged,
+            modified,
+            untracked,
+            conflicts,
+        };
+    }
+    /**
+     * Get current branch name
+     */
+    getCurrentBranch() {
+        return git('rev-parse --abbrev-ref HEAD', this.cwd);
+    }
+    /**
+     * Get tracking info (ahead/behind)
+     */
+    getTrackingInfo() {
+        try {
+            const result = git('rev-list --left-right --count HEAD...@{upstream}', this.cwd);
+            const [ahead, behind] = result.split('\t').map(n => parseInt(n, 10));
+            return { ahead: ahead || 0, behind: behind || 0 };
+        }
+        catch {
+            return { ahead: 0, behind: 0 };
+        }
+    }
+    /**
+     * Get staged files
+     */
+    getStagedFiles() {
+        try {
+            const result = git('diff --cached --name-only', this.cwd);
+            return result ? result.split('\n').filter(f => f) : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Get modified files
+     */
+    getModifiedFiles() {
+        try {
+            const result = git('diff --name-only', this.cwd);
+            return result ? result.split('\n').filter(f => f) : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Get untracked files
+     */
+    getUntrackedFiles() {
+        try {
+            const result = git('ls-files --others --exclude-standard', this.cwd);
+            return result ? result.split('\n').filter(f => f) : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Get files with conflicts
+     */
+    getConflictFiles() {
+        try {
+            const result = git('diff --name-only --diff-filter=U', this.cwd);
+            return result ? result.split('\n').filter(f => f) : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Check if working directory has uncommitted changes
+     */
+    isDirty() {
+        const status = this.getStatus();
+        return status.staged.length > 0 ||
+            status.modified.length > 0 ||
+            status.conflicts.length > 0;
+    }
+    /**
+     * Check if working directory is clean
+     */
+    isClean() {
+        return !this.isDirty();
+    }
+    // =========================================================================
+    // BRANCHES
+    // =========================================================================
+    /**
+     * Create a new branch
+     */
+    createBranch(name, baseBranch) {
+        if (baseBranch) {
+            git(`checkout -b ${name} ${baseBranch}`, this.cwd);
+        }
+        else {
+            git(`checkout -b ${name}`, this.cwd);
+        }
+    }
+    /**
+     * Switch to a branch
+     */
+    checkout(branch) {
+        git(`checkout ${branch}`, this.cwd);
+    }
+    /**
+     * Delete a branch
+     */
+    deleteBranch(name, force = false) {
+        const flag = force ? '-D' : '-d';
+        git(`branch ${flag} ${name}`, this.cwd);
+    }
+    /**
+     * Delete a remote branch
+     */
+    deleteRemoteBranch(name, remote = 'origin') {
+        git(`push ${remote} --delete ${name}`, this.cwd);
+    }
+    /**
+     * List local branches
+     */
+    listBranches() {
+        const result = git('branch --format="%(refname:short)|%(objectname:short)|%(upstream:short)"', this.cwd);
+        if (!result)
+            return [];
+        return result.split('\n').filter(l => l).map(line => {
+            const [name, sha, upstream] = line.split('|');
+            const defaultBranch = this.getDefaultBranch();
+            return {
+                name,
+                sha,
+                isDefault: name === defaultBranch,
+                isProtected: this.isProtectedBranch(name),
+                upstream: upstream || undefined,
+            };
+        });
+    }
+    /**
+     * Get default branch name
+     */
+    getDefaultBranch() {
+        try {
+            const result = git('symbolic-ref refs/remotes/origin/HEAD', this.cwd);
+            return result.replace('refs/remotes/origin/', '');
+        }
+        catch {
+            return 'main';
+        }
+    }
+    /**
+     * Check if branch is protected (simple heuristic)
+     */
+    isProtectedBranch(name) {
+        const protectedNames = ['main', 'master', 'develop', 'production', 'staging'];
+        return protectedNames.includes(name);
+    }
+    /**
+     * Check if branch exists
+     */
+    branchExists(name) {
+        try {
+            git(`rev-parse --verify ${name}`, this.cwd);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // =========================================================================
+    // COMMITS
+    // =========================================================================
+    /**
+     * Stage files
+     */
+    stage(patterns) {
+        git(`add ${patterns.join(' ')}`, this.cwd);
+    }
+    /**
+     * Stage all changes
+     */
+    stageAll() {
+        git('add -A', this.cwd);
+    }
+    /**
+     * Unstage files
+     */
+    unstage(patterns) {
+        git(`reset HEAD ${patterns.join(' ')}`, this.cwd);
+    }
+    /**
+     * Create a commit
+     */
+    commit(options) {
+        // Build commit message
+        let message = options.message;
+        if (options.type) {
+            const scope = options.scope ? `(${options.scope})` : '';
+            message = `${options.type}${scope}: ${options.message}`;
+        }
+        if (options.body) {
+            message += `\n\n${options.body}`;
+        }
+        if (options.workId) {
+            message += `\n\nWork-Item: ${options.workId}`;
+        }
+        if (options.breaking) {
+            message += '\n\nBREAKING CHANGE: Breaking changes included';
+        }
+        if (options.coAuthors && options.coAuthors.length > 0) {
+            message += '\n\n' + options.coAuthors.map(a => `Co-Authored-By: ${a}`).join('\n');
+        }
+        // Execute commit
+        const args = options.allowEmpty ? '--allow-empty' : '';
+        git(`commit ${args} -m "${message.replace(/"/g, '\\"')}"`, this.cwd);
+        // Get the commit we just made
+        return this.getCommit('HEAD');
+    }
+    /**
+     * Get a commit by ref
+     */
+    getCommit(ref) {
+        const format = '%H|%s|%an|%ae|%aI|%P';
+        const result = git(`log -1 --format="${format}" ${ref}`, this.cwd);
+        const [sha, message, author, authorEmail, date, parents] = result.split('|');
+        return {
+            sha,
+            message,
+            author,
+            authorEmail,
+            date,
+            parents: parents ? parents.split(' ') : [],
+        };
+    }
+    /**
+     * List commits
+     */
+    listCommits(options) {
+        const format = '%H|%s|%an|%ae|%aI|%P';
+        const args = [`--format="${format}"`];
+        if (options?.limit) {
+            args.push(`-n ${options.limit}`);
+        }
+        if (options?.since) {
+            args.push(`--since="${options.since}"`);
+        }
+        if (options?.branch) {
+            args.push(options.branch);
+        }
+        const result = git(`log ${args.join(' ')}`, this.cwd);
+        if (!result)
+            return [];
+        return result.split('\n').filter(l => l).map(line => {
+            const [sha, message, author, authorEmail, date, parents] = line.split('|');
+            return {
+                sha,
+                message,
+                author,
+                authorEmail,
+                date,
+                parents: parents ? parents.split(' ') : [],
+            };
+        });
+    }
+    /**
+     * Get diff
+     */
+    getDiff(options) {
+        const args = [];
+        if (options?.staged) {
+            args.push('--cached');
+        }
+        if (options?.base && options?.head) {
+            args.push(`${options.base}...${options.head}`);
+        }
+        else if (options?.base) {
+            args.push(options.base);
+        }
+        return git(`diff ${args.join(' ')}`, this.cwd);
+    }
+    // =========================================================================
+    // PUSH/PULL
+    // =========================================================================
+    /**
+     * Push to remote
+     */
+    push(options) {
+        const args = [];
+        const remote = options?.remote || 'origin';
+        const branch = options?.branch || this.getCurrentBranch();
+        args.push(remote);
+        args.push(branch);
+        if (options?.setUpstream) {
+            args.unshift('-u');
+        }
+        if (options?.forceWithLease) {
+            args.unshift('--force-with-lease');
+        }
+        else if (options?.force) {
+            args.unshift('--force');
+        }
+        git(`push ${args.join(' ')}`, this.cwd);
+    }
+    /**
+     * Pull from remote
+     */
+    pull(options) {
+        const args = [];
+        if (options?.rebase) {
+            args.push('--rebase');
+        }
+        const remote = options?.remote || 'origin';
+        const branch = options?.branch || this.getCurrentBranch();
+        git(`pull ${args.join(' ')} ${remote} ${branch}`, this.cwd);
+    }
+    /**
+     * Fetch from remote
+     */
+    fetch(remote = 'origin') {
+        git(`fetch ${remote}`, this.cwd);
+    }
+    // =========================================================================
+    // TAGS
+    // =========================================================================
+    /**
+     * Create a tag
+     */
+    createTag(name, options) {
+        const args = [];
+        if (options?.message) {
+            args.push(`-a -m "${options.message.replace(/"/g, '\\"')}"`);
+        }
+        args.push(name);
+        if (options?.sha) {
+            args.push(options.sha);
+        }
+        git(`tag ${args.join(' ')}`, this.cwd);
+    }
+    /**
+     * Delete a tag
+     */
+    deleteTag(name) {
+        git(`tag -d ${name}`, this.cwd);
+    }
+    /**
+     * Push a tag
+     */
+    pushTag(name, remote = 'origin') {
+        git(`push ${remote} ${name}`, this.cwd);
+    }
+    /**
+     * List tags
+     */
+    listTags(options) {
+        const args = ['--format="%(refname:short)|%(objectname:short)|%(taggerdate:iso)"'];
+        if (options?.pattern) {
+            args.push(`-l "${options.pattern}"`);
+        }
+        const result = git(`tag ${args.join(' ')}`, this.cwd);
+        if (!result)
+            return [];
+        let tags = result.split('\n').filter(l => l).map(line => {
+            const [name, sha, date] = line.split('|');
+            return { name, sha, date };
+        });
+        if (options?.limit) {
+            tags = tags.slice(-options.limit);
+        }
+        return tags;
+    }
+    // =========================================================================
+    // WORKTREES
+    // =========================================================================
+    /**
+     * Create a worktree
+     */
+    createWorktree(path, branch, baseBranch) {
+        if (baseBranch) {
+            git(`worktree add -b ${branch} ${path} ${baseBranch}`, this.cwd);
+        }
+        else {
+            git(`worktree add ${path} ${branch}`, this.cwd);
+        }
+    }
+    /**
+     * List worktrees
+     */
+    listWorktrees() {
+        const result = git('worktree list --porcelain', this.cwd);
+        if (!result)
+            return [];
+        const worktrees = [];
+        let current = {};
+        for (const line of result.split('\n')) {
+            if (line.startsWith('worktree ')) {
+                if (current.path) {
+                    worktrees.push(current);
+                }
+                current = { path: line.substring(9) };
+            }
+            else if (line.startsWith('HEAD ')) {
+                current.sha = line.substring(5);
+            }
+            else if (line.startsWith('branch ')) {
+                current.branch = line.substring(7).replace('refs/heads/', '');
+            }
+        }
+        if (current.path) {
+            worktrees.push(current);
+        }
+        // Mark main worktree
+        if (worktrees.length > 0) {
+            worktrees[0].isMain = true;
+        }
+        return worktrees;
+    }
+    /**
+     * Remove a worktree
+     */
+    removeWorktree(path, force = false) {
+        const flag = force ? '--force' : '';
+        git(`worktree remove ${flag} ${path}`, this.cwd);
+    }
+    /**
+     * Prune stale worktrees
+     */
+    pruneWorktrees() {
+        git('worktree prune', this.cwd);
+    }
+}
+exports.Git = Git;
+//# sourceMappingURL=git.js.map