@weavelogic/knowledge-graph-agent 0.2.0 → 0.3.0

package/dist/integrations/git.d.ts

@@ -0,0 +1,299 @@
+/**
+ * Git Integration
+ *
+ * Provides Git operations for the knowledge graph agent using simple-git.
+ *
+ * @module integrations/git
+ */
+import { SimpleGit } from 'simple-git';
+import { Logger, KnowledgeGraphError } from '../utils/index.js';
+/**
+ * Git client configuration
+ */
+export interface GitClientConfig {
+    /** Working directory for git operations */
+    workingDirectory?: string;
+    /** Logger instance */
+    logger?: Logger;
+    /** Timeout for git operations in milliseconds */
+    timeout?: number;
+}
+/**
+ * Git status summary
+ */
+export interface GitStatusSummary {
+    /** Current branch name */
+    branch: string;
+    /** Whether the repository is clean */
+    isClean: boolean;
+    /** Number of staged files */
+    staged: number;
+    /** Number of modified files */
+    modified: number;
+    /** Number of untracked files */
+    untracked: number;
+    /** Number of deleted files */
+    deleted: number;
+    /** Number of renamed files */
+    renamed: number;
+    /** Number of conflicted files */
+    conflicted: number;
+    /** Tracking information */
+    tracking?: {
+        ahead: number;
+        behind: number;
+        remote?: string;
+    };
+    /** List of changed files */
+    files: GitFileStatus[];
+}
+/**
+ * Individual file status
+ */
+export interface GitFileStatus {
+    /** File path */
+    path: string;
+    /** Index status (staged) */
+    indexStatus: string;
+    /** Working tree status */
+    workingTreeStatus: string;
+    /** Whether the file is staged */
+    isStaged: boolean;
+}
+/**
+ * Git diff summary
+ */
+export interface GitDiffSummary {
+    /** Number of changed files */
+    changed: number;
+    /** Number of insertions */
+    insertions: number;
+    /** Number of deletions */
+    deletions: number;
+    /** List of changed files with details */
+    files: GitDiffFile[];
+}
+/**
+ * Git diff file details
+ */
+export interface GitDiffFile {
+    /** File path */
+    file: string;
+    /** Number of insertions */
+    insertions: number;
+    /** Number of deletions */
+    deletions: number;
+    /** Whether the file is binary */
+    binary: boolean;
+}
+/**
+ * Git commit info
+ */
+export interface GitCommitInfo {
+    /** Commit hash */
+    hash: string;
+    /** Abbreviated commit hash */
+    hashAbbrev: string;
+    /** Author name */
+    author: string;
+    /** Author email */
+    email: string;
+    /** Commit date */
+    date: Date;
+    /** Commit message */
+    message: string;
+    /** Commit body */
+    body?: string;
+    /** Parent commit hashes */
+    parents: string[];
+}
+/**
+ * Git remote info
+ */
+export interface GitRemoteInfo {
+    /** Remote name */
+    name: string;
+    /** Fetch URL */
+    fetchUrl: string;
+    /** Push URL */
+    pushUrl: string;
+}
+/**
+ * Git branch info
+ */
+export interface GitBranchInfo {
+    /** Current branch name */
+    current: string;
+    /** Whether the branch is detached */
+    detached: boolean;
+    /** All local branches */
+    local: string[];
+    /** All remote branches */
+    remote: string[];
+}
+/**
+ * Git commit options
+ */
+export interface GitCommitOptions {
+    /** Commit message */
+    message: string;
+    /** Whether to amend the previous commit */
+    amend?: boolean;
+    /** Whether to allow empty commits */
+    allowEmpty?: boolean;
+    /** Specific files to commit (all staged if empty) */
+    files?: string[];
+    /** Author override */
+    author?: {
+        name: string;
+        email: string;
+    };
+}
+/**
+ * Git commit result
+ */
+export interface GitCommitResult {
+    /** Whether the commit was successful */
+    success: boolean;
+    /** Commit hash */
+    hash?: string;
+    /** Branch name */
+    branch?: string;
+    /** Commit summary */
+    summary?: {
+        changes: number;
+        insertions: number;
+        deletions: number;
+    };
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Git error class
+ */
+export declare class GitError extends KnowledgeGraphError {
+    readonly gitCommand?: string;
+    readonly gitOutput?: string;
+    constructor(message: string, gitCommand?: string, gitOutput?: string);
+}
+/**
+ * Git Client
+ *
+ * Provides a high-level interface for Git operations.
+ */
+export declare class GitClient {
+    private git;
+    private logger;
+    private workingDirectory;
+    constructor(config?: GitClientConfig);
+    /**
+     * Check if the current directory is a git repository
+     */
+    isRepo(): Promise<boolean>;
+    /**
+     * Get the current git status
+     */
+    getStatus(): Promise<GitStatusSummary>;
+    /**
+     * Get the diff of changes
+     */
+    getDiff(options?: {
+        staged?: boolean;
+        file?: string;
+        cached?: boolean;
+    }): Promise<GitDiffSummary>;
+    /**
+     * Get the full diff content
+     */
+    getDiffContent(options?: {
+        staged?: boolean;
+        file?: string;
+    }): Promise<string>;
+    /**
+     * Stage files for commit
+     */
+    add(files?: string[] | string): Promise<void>;
+    /**
+     * Unstage files
+     */
+    reset(files: string[] | string): Promise<void>;
+    /**
+     * Create a commit
+     */
+    commit(options: GitCommitOptions): Promise<GitCommitResult>;
+    /**
+     * Get commit log
+     */
+    getLog(options?: {
+        maxCount?: number;
+        file?: string;
+        since?: Date;
+        until?: Date;
+        author?: string;
+    }): Promise<GitCommitInfo[]>;
+    /**
+     * Get current branch information
+     */
+    getBranch(): Promise<GitBranchInfo>;
+    /**
+     * Get remote information
+     */
+    getRemotes(): Promise<GitRemoteInfo[]>;
+    /**
+     * Push to remote
+     */
+    push(options?: {
+        remote?: string;
+        branch?: string;
+        setUpstream?: boolean;
+        force?: boolean;
+    }): Promise<void>;
+    /**
+     * Pull from remote
+     */
+    pull(options?: {
+        remote?: string;
+        branch?: string;
+        rebase?: boolean;
+    }): Promise<void>;
+    /**
+     * Fetch from remote
+     */
+    fetch(options?: {
+        remote?: string;
+        all?: boolean;
+        prune?: boolean;
+    }): Promise<void>;
+    /**
+     * Stash changes
+     */
+    stash(options?: {
+        message?: string;
+        includeUntracked?: boolean;
+    }): Promise<void>;
+    /**
+     * Pop stash
+     */
+    stashPop(): Promise<void>;
+    /**
+     * Get the root directory of the git repository
+     */
+    getRoot(): Promise<string>;
+    /**
+     * Get the current HEAD commit hash
+     */
+    getHead(): Promise<string>;
+    /**
+     * Check if there are uncommitted changes
+     */
+    hasUncommittedChanges(): Promise<boolean>;
+    /**
+     * Get the underlying simple-git instance for advanced operations
+     */
+    getRawClient(): SimpleGit;
+}
+/**
+ * Create a GitClient instance
+ */
+export declare function createGitClient(config?: GitClientConfig): GitClient;
+//# sourceMappingURL=git.d.ts.map

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

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