@zqagent/core 0.2.20 → 0.3.7

package/dist/internal/tools/git.d.ts

@@ -0,0 +1,206 @@
+import { T as ToolRegistry } from '../../ToolRegistry-Cy0fQxrb.js';
+import '../../types-BYyXWWPW.js';
+import '@zqagent/shared/model-capabilities';
+
+/** git_log — 提交历史 */
+declare function makeGitLog(workspace: string): (args: Record<string, unknown>) => Promise<{
+    error: string;
+    repo?: undefined;
+    count?: undefined;
+    commits?: undefined;
+} | {
+    repo: string;
+    count: number;
+    commits: ({
+        hash: string;
+        author: string;
+        date: string;
+        subject: string;
+        raw?: undefined;
+    } | {
+        raw: string;
+        hash?: undefined;
+        author?: undefined;
+        date?: undefined;
+        subject?: undefined;
+    })[];
+    error?: undefined;
+}>;
+/** git_status — 工作区状态 */
+declare function makeGitStatus(workspace: string): (args: Record<string, unknown>) => Promise<{
+    error: string;
+    repo?: undefined;
+    clean?: undefined;
+    entries?: undefined;
+    count?: undefined;
+} | {
+    repo: string;
+    clean: boolean;
+    entries: {
+        status: string;
+        file: string;
+        index: string;
+        worktree: string;
+    }[];
+    count: number;
+    error?: undefined;
+}>;
+/** git_diff — 差异对比 */
+declare function makeGitDiff(workspace: string): (args: Record<string, unknown>) => Promise<{
+    error: string;
+    repo?: undefined;
+    staged?: undefined;
+    path?: undefined;
+    diff?: undefined;
+    truncated?: undefined;
+} | {
+    repo: string;
+    staged: boolean;
+    path: string | null;
+    diff: string;
+    truncated: boolean;
+    error?: undefined;
+}>;
+/** 注册 Git 工具 */
+declare function registerGitTools(registry: ToolRegistry, workspace: string): void;
+/** 写操作结果：ok=false 时 error 为可直接展示给用户的原因 */
+interface GitOpResult {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+    error?: string;
+}
+/** 分支名校验（拒绝空、选项注入与 git 非法字符）；返回 null 表示可用 */
+declare function gitRefProblem(name: string): string | null;
+/** git_branches — 本地分支列表 + 当前分支（detached 时 current 为短 hash） */
+declare function makeGitBranches(workspace: string): (args: Record<string, unknown>) => Promise<{
+    error: string;
+    repo?: undefined;
+    current?: undefined;
+    detached?: undefined;
+    branches?: undefined;
+} | {
+    repo: string;
+    current: string;
+    detached: boolean;
+    branches: {
+        upstream?: string | undefined;
+        name: string;
+        current: boolean;
+    }[];
+    error?: undefined;
+}>;
+/** 提交标识（hash / ref 名）校验：拒绝空、选项注入与 git 非法字符；返回 null 表示可用 */
+declare function gitObjectProblem(name: string): string | null;
+/**
+ * git_refs — 引用列表（控制台 Git 面板）
+ *
+ * 一次返回本地分支 / 远程分支 / 标签三组，供面板分组展示与切换。
+ * 远程分支与标签只有在 `git fetch` 之后才是服务端的最新状态（见 makeGitFetch）。
+ */
+declare function makeGitRefs(workspace: string): (args: Record<string, unknown>) => Promise<{
+    error: string;
+    repo?: undefined;
+    current?: undefined;
+    detached?: undefined;
+    local?: undefined;
+    remote?: undefined;
+    tags?: undefined;
+} | {
+    repo: string;
+    current: string;
+    detached: boolean;
+    local: {
+        name: string;
+        current?: boolean;
+        upstream?: string;
+    }[];
+    remote: {
+        name: string;
+    }[];
+    tags: {
+        name: string;
+        target?: string;
+    }[];
+    error?: undefined;
+}>;
+/**
+ * git_show — 单次提交详情（meta + 变更文件 + diff）
+ *
+ * path 省略时返回整个提交的 diff（截断 50000 字符）；给出 path 时只返回该文件
+ * 在此提交中的 diff（相对第一父提交，merge commit 也能给出可读结果）。
+ */
+declare function makeGitShow(workspace: string): (args: Record<string, unknown>) => Promise<{
+    error: string;
+    repo?: undefined;
+    commit?: undefined;
+    files?: undefined;
+    path?: undefined;
+    diff?: undefined;
+    truncated?: undefined;
+} | {
+    repo: string;
+    commit: {
+        hash: string;
+        short: string;
+        author: string;
+        authorEmail: string;
+        date: string;
+        subject: string;
+        body: string;
+    };
+    files: {
+        status: string;
+        file: string;
+    }[];
+    path: string | null;
+    diff: string;
+    truncated: boolean;
+    error?: undefined;
+}>;
+/** git_stage — 暂存文件（paths 为空 = 全部改动） */
+declare function makeGitStage(workspace: string): (args: Record<string, unknown>) => Promise<GitOpResult>;
+/** git_unstage — 取消暂存（paths 为空 = 全部） */
+declare function makeGitUnstage(workspace: string): (args: Record<string, unknown>) => Promise<GitOpResult>;
+/** git_commit — 提交已暂存内容 */
+declare function makeGitCommit(workspace: string): (args: Record<string, unknown>) => Promise<GitOpResult>;
+/** git_checkout — 切换分支（create=true 时新建并切换） */
+declare function makeGitCheckout(workspace: string): (args: Record<string, unknown>) => Promise<GitOpResult>;
+/** git_pull — 拉取当前分支的上游 */
+declare function makeGitPull(workspace: string): (args: Record<string, unknown>) => Promise<GitOpResult>;
+/** git_push — 推送当前分支（无 upstream 且存在 origin 时按首次推送补 -u） */
+declare function makeGitPush(workspace: string): (args: Record<string, unknown>) => Promise<GitOpResult>;
+/** git_fetch — 刷新服务端分支与标签（--all --prune --tags） */
+declare function makeGitFetch(workspace: string): (args: Record<string, unknown>) => Promise<GitOpResult>;
+interface GitRepoInfo {
+    /** 相对工作区的路径；根仓库为 "" */
+    path: string;
+    /** 目录名（根仓库为工作区目录名） */
+    name: string;
+    /** 当前分支；detached 时为短 hash */
+    branch?: string;
+    detached?: boolean;
+}
+/**
+ * 扫描工作区及其子目录中的 git 仓库。
+ *
+ * 遇到仓库后仍继续向下扫描：子模块与「仓库里嵌套独立仓库」的工程都能被发现。
+ * 根仓库排在第一位，其余按相对路径排序。
+ */
+declare function scanGitRepos(workspace: string, depth?: number): {
+    repos: GitRepoInfo[];
+    truncated?: boolean;
+};
+/** git_repos — 列出工作区内的所有 git 仓库（控制台 Git 面板的仓库选择器） */
+declare function makeGitRepos(workspace: string): (args: Record<string, unknown>) => Promise<{
+    root: string;
+    repos: never[];
+    error: string;
+} | {
+    repos: GitRepoInfo[];
+    truncated?: boolean;
+    root: string;
+    error?: undefined;
+}>;
+
+export { type GitOpResult, type GitRepoInfo, gitObjectProblem, gitRefProblem, makeGitBranches, makeGitCheckout, makeGitCommit, makeGitDiff, makeGitFetch, makeGitLog, makeGitPull, makeGitPush, makeGitRefs, makeGitRepos, makeGitShow, makeGitStage, makeGitStatus, makeGitUnstage, registerGitTools, scanGitRepos };