dsh-github-flow 0.3.0 → 0.4.0

package/lib/renderers/status.js

@@ -0,0 +1,124 @@
+import { sanitizeCell } from './common.js';
+/**
+ * 解析 gh status 的输出，提取待办 Issue、待办 PR、评审请求、提及与近期动态
+ */
+export function parseStatusOutput(output) {
+    const trimmed = (output || '').trim();
+    const report = {
+        assignedIssues: [],
+        assignedPrs: [],
+        reviewRequests: [],
+        mentions: [],
+        activity: [],
+        rawText: trimmed,
+    };
+    if (!trimmed)
+        return report;
+    const lines = trimmed.split(/[\r\n]+/);
+    let currentSection = null;
+    for (const line of lines) {
+        const rawLine = line.trim();
+        if (!rawLine)
+            continue;
+        // 检查是否包含版块头
+        if (/Assigned Issues/i.test(rawLine)) {
+            currentSection = 'assignedIssues';
+            // 如果同一行有双列分割
+            if (/Assigned Pull Requests/i.test(rawLine)) {
+                // 双列行，仅做标记
+                continue;
+            }
+            continue;
+        }
+        if (/Assigned Pull Requests/i.test(rawLine)) {
+            currentSection = 'assignedPrs';
+            continue;
+        }
+        if (/Review Requests/i.test(rawLine)) {
+            currentSection = 'reviewRequests';
+            continue;
+        }
+        if (/Mentions/i.test(rawLine)) {
+            currentSection = 'mentions';
+            continue;
+        }
+        if (/Repository Activity/i.test(rawLine)) {
+            currentSection = 'activity';
+            continue;
+        }
+        // 过滤空状态占位符
+        if (rawLine.includes('Nothing here') || rawLine.includes('^_^')) {
+            continue;
+        }
+        // 处理行内容（支持制表符或双列分隔）
+        const cleanSegments = rawLine
+            .split('│')
+            .map((s) => s.trim())
+            .filter((s) => s && !s.includes('Nothing here') && !s.includes('^_^'));
+        for (const segment of cleanSegments) {
+            if (!segment)
+                continue;
+            // 尝试匹配制表符或 "repo#123\tdesc\tdetail"
+            const tabParts = segment.split('\t').map((p) => p.trim());
+            const itemMatch = tabParts[0].match(/^([^#\s]+)#(\d+)/);
+            const item = {
+                raw: segment,
+            };
+            if (itemMatch) {
+                item.repo = itemMatch[1];
+                item.number = itemMatch[2];
+                item.title = tabParts[1] || '';
+                item.detail = tabParts[2] || '';
+            }
+            else {
+                item.detail = segment;
+            }
+            if (currentSection && report[currentSection]) {
+                report[currentSection].push(item);
+            }
+            else {
+                // 未匹配版块默认归入 activity
+                report.activity.push(item);
+            }
+        }
+    }
+    return report;
+}
+/**
+ * Status 领域渲染器：负责用户跨仓待办大盘的 Markdown 格式化
+ */
+export function renderStatusMarkdown(args, value) {
+    if (!value)
+        return '无返回内容';
+    const report = value.parsed || parseStatusOutput(value.rawText || value.output || '');
+    const renderSection = (title, icon, items, emptyText) => {
+        if (!items || items.length === 0) {
+            return `#### ${icon} ${title}\n*${emptyText}*\n`;
+        }
+        const rows = items.map((it) => {
+            const repoRef = it.repo && it.number ? `\`${it.repo}#${it.number}\`` : '-';
+            const titleText = sanitizeCell(it.title || it.raw, 40);
+            const detailText = sanitizeCell(it.detail, 40);
+            return `| ${repoRef} | ${titleText} | ${detailText} |`;
+        });
+        return [
+            `#### ${icon} ${title} (${items.length})\n`,
+            '| 仓库 & 编号 | 标题 / 动作 | 详情 / 摘要 |',
+            '| :--- | :--- | :--- |',
+            ...rows,
+            '',
+        ].join('\n');
+    };
+    const sections = [
+        renderSection('指派给我的 Issue (Assigned Issues)', '📌', report.assignedIssues, '🟢 暂无分配给你的未决 Issue'),
+        renderSection('指派给我的 PR (Assigned Pull Requests)', '🔀', report.assignedPrs, '🟢 暂无分配给你的未决 PR'),
+        renderSection('等待我评审的 PR (Review Requests)', '👀', report.reviewRequests, '🟢 暂无待你评审的 PR'),
+        renderSection('提及我的动态 (Mentions)', '🔔', report.mentions, '🟢 暂无与你相关的近期提及'),
+        renderSection('订阅仓库近期动态 (Repository Activity)', '⚡', report.activity, '暂无近期仓库动态'),
+    ];
+    return [
+        '### 🧭 GitHub 个人待办与跨仓动态聚合看板\n',
+        ...sections,
+        '> 💡 **待办操作建议**: 可通过 `github_issue(action: \'view\')` 或 `github_pr(action: \'checkout\')` 快速检视对应议题并展开工作。',
+    ].join('\n');
+}

package/lib/tools/cache.d.ts

@@ -0,0 +1,64 @@
+import type { GhExecutor } from '../executor.js';
+export declare function createCacheTool(executor: GhExecutor): {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            repo: {
+                type: string;
+                description: string;
+            };
+            cache_id: {
+                type: string;
+                description: string;
+            };
+            key: {
+                type: string;
+                description: string;
+            };
+            ref: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            sort: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            order: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            all: {
+                type: string;
+                description: string;
+            };
+            confirm: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    output: {
+        schema: {
+            type: string;
+        };
+        render(args: any, value: any): {
+            type: string;
+            text: string;
+        }[];
+    };
+    execute(args: any, execContext: any): Promise<Record<string, any>>;
+};

package/lib/tools/cache.js

@@ -0,0 +1,186 @@
+import { renderCacheMarkdown } from '../renderers/markdown.js';
+function normalizeOutput(data) {
+    if (data && typeof data === 'object' && !Array.isArray(data)) {
+        return data;
+    }
+    if (Array.isArray(data)) {
+        return { items: data, count: data.length };
+    }
+    return { result: data !== undefined && data !== null ? data : '' };
+}
+export function createCacheTool(executor) {
+    return {
+        name: 'github_cache',
+        description: '管理 GitHub Actions 构建缓存 (Caches)：查看缓存列表与占用容量、按 ID 或 Key 删除指定缓存、以及全量清空仓库缓存。全量清空不可逆，需 confirm: true。',
+        parameters: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['list', 'delete'],
+                    description: 'Cache 操作类型。list 查看缓存列表与体积、delete 删除缓存。',
+                },
+                repo: {
+                    type: 'string',
+                    description: '目标仓库 [owner/repo]，留空则识别当前工作区仓库。',
+                },
+                cache_id: {
+                    type: 'string',
+                    description: '缓存数字 ID（delete 动作指定单条缓存删除时使用）。',
+                },
+                key: {
+                    type: 'string',
+                    description: '缓存 Key 键名前缀或完整键名（list 动作过滤检索，或 delete 动作按键删除时使用）。',
+                },
+                ref: {
+                    type: 'string',
+                    description: '分支或 PR Git Ref（如 "refs/heads/main" 或 "refs/pull/42/merge"，用于过滤或定向删除）。',
+                },
+                limit: {
+                    type: 'number',
+                    description: '返回缓存数量上限（list 动作使用，默认 30）。',
+                },
+                sort: {
+                    type: 'string',
+                    enum: ['created_at', 'last_accessed_at', 'size_in_bytes'],
+                    description: '排序字段（list 动作使用，默认 last_accessed_at）。',
+                },
+                order: {
+                    type: 'string',
+                    enum: ['asc', 'desc'],
+                    description: '排序方向（list 动作使用，默认 desc）。',
+                },
+                all: {
+                    type: 'boolean',
+                    description: '是否清空仓库全部缓存（delete 动作使用，高危操作，必需配合 confirm: true）。',
+                },
+                confirm: {
+                    type: 'boolean',
+                    description: '高危破坏性操作确认标志（delete 当 all: true 时必需）。未传 true 时输出影响评估报告并拦截。',
+                },
+            },
+            required: ['action'],
+        },
+        output: {
+            schema: { type: 'object' },
+            render(args, value) {
+                return [{ type: 'text', text: renderCacheMarkdown(args, value) }];
+            },
+        },
+        async execute(args, execContext) {
+            const cwd = execContext?.cwd || process.cwd();
+            const sessionId = execContext?.sessionId || execContext?.session?.id || process.env.DSH_SESSION_ID;
+            let repoTarget = args.repo;
+            if (!repoTarget) {
+                const meta = await executor.getRepoMetadata(cwd, sessionId);
+                if (meta?.nameWithOwner) {
+                    repoTarget = meta.nameWithOwner;
+                }
+            }
+            if (!repoTarget) {
+                throw new Error('未能自动识别当前工作区关联的 GitHub 仓库。请通过 `repo` 参数显式指定目标仓库 [owner/repo]（例如: "ItQianChen/dsh-github-flow"），或在当前工作区目录下关联 Git 远程仓库。');
+            }
+            const repoArgs = ['-R', repoTarget];
+            const runOpts = { cwd, sessionId };
+            switch (args.action) {
+                case 'list': {
+                    const listCmd = [
+                        'cache',
+                        'list',
+                        ...repoArgs,
+                        '--json',
+                        'createdAt,id,key,lastAccessedAt,ref,sizeInBytes,version',
+                    ];
+                    const limit = typeof args.limit === 'number' && args.limit > 0 ? args.limit : 30;
+                    listCmd.push('-L', String(limit));
+                    if (args.key) {
+                        listCmd.push('-k', String(args.key));
+                    }
+                    if (args.ref) {
+                        listCmd.push('-r', String(args.ref));
+                    }
+                    if (args.sort) {
+                        listCmd.push('--sort', args.sort);
+                    }
+                    if (args.order) {
+                        listCmd.push('--order', args.order);
+                    }
+                    const res = await executor.run(listCmd, runOpts);
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    let rawData = res.data;
+                    if (!rawData && typeof res.rawOutput === 'string') {
+                        try {
+                            rawData = JSON.parse(res.rawOutput);
+                        }
+                        catch {
+                            rawData = [];
+                        }
+                    }
+                    return normalizeOutput(rawData || []);
+                }
+                case 'delete': {
+                    // 1. 全量清空分支
+                    if (args.all === true) {
+                        if (args.confirm !== true) {
+                            return {
+                                status: 'AWAITING_CONFIRMATION',
+                                action: 'delete',
+                                all: true,
+                                repo: repoTarget,
+                                warning: `⚠️ 高危破坏性操作：即将清空仓库 ${repoTarget} 的所有 GitHub Actions 构建缓存`,
+                                impact: `清空缓存不可逆，会导致后续流水线构建无法复用依赖与构建产物，显著增加 CI 运行耗时。`,
+                                requiredAction: `如确认彻底清空，请在参数中附加 \`confirm: true\` 重新调用。示例：\`github_cache(action: 'delete', all: true, confirm: true)\``,
+                            };
+                        }
+                        const delCmd = ['cache', 'delete', '--all', '--succeed-on-no-caches', ...repoArgs];
+                        if (args.ref) {
+                            delCmd.push('-r', String(args.ref));
+                        }
+                        const res = await executor.run(delCmd, runOpts);
+                        if (!res.ok)
+                            throw new Error(res.error);
+                        return {
+                            success: true,
+                            all: true,
+                            message: `🗑️ 成功清空仓库 ${repoTarget} 的 Actions 构建缓存` + (args.ref ? ` (Ref: ${args.ref})` : ''),
+                            detail: res.rawOutput || '',
+                        };
+                    }
+                    // 2. 按 cache_id 删除
+                    if (args.cache_id !== undefined && args.cache_id !== null && String(args.cache_id).trim() !== '') {
+                        const delCmd = ['cache', 'delete', String(args.cache_id), ...repoArgs];
+                        const res = await executor.run(delCmd, runOpts);
+                        if (!res.ok)
+                            throw new Error(res.error);
+                        return {
+                            success: true,
+                            cache_id: String(args.cache_id),
+                            message: `🗑️ 成功删除仓库 ${repoTarget} 中 ID 为 "${args.cache_id}" 的 Actions 缓存`,
+                            detail: res.rawOutput || '',
+                        };
+                    }
+                    // 3. 按 key 删除
+                    if (args.key !== undefined && args.key !== null && String(args.key).trim() !== '') {
+                        const delCmd = ['cache', 'delete', String(args.key), ...repoArgs];
+                        if (args.ref) {
+                            delCmd.push('-r', String(args.ref));
+                        }
+                        const res = await executor.run(delCmd, runOpts);
+                        if (!res.ok)
+                            throw new Error(res.error);
+                        return {
+                            success: true,
+                            key: String(args.key),
+                            message: `🗑️ 成功删除仓库 ${repoTarget} 中 Key 为 "${args.key}" 的 Actions 缓存` + (args.ref ? ` (Ref: ${args.ref})` : ''),
+                            detail: res.rawOutput || '',
+                        };
+                    }
+                    throw new Error('删除缓存时必须指定 `cache_id`、`key` 或 `all: true`（全量删除需配合 confirm: true）。');
+                }
+                default:
+                    throw new Error(`不支持的 cache 操作: "${args.action}"。可选值: list, delete。`);
+            }
+        },
+    };
+}

package/lib/tools/gist.d.ts

@@ -0,0 +1,155 @@
+import type { GhExecutor } from '../executor.js';
+export declare function createGistTool(executor: GhExecutor): {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            gist_id: {
+                type: string;
+                description: string;
+            };
+            filename: {
+                type: string;
+                description: string;
+            };
+            files: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            public: {
+                type: string;
+                description: string;
+            };
+            filter: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            confirm: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    output: {
+        schema: {
+            type: string;
+        };
+        render(args: any, value: any): {
+            type: string;
+            text: string;
+        }[];
+    };
+    execute(args: any, execContext: any): Promise<{
+        items: import("../renderers/gist.js").ParsedGistSummary[];
+        count: number;
+        rawText: string;
+        filename?: undefined;
+        content?: undefined;
+        url?: undefined;
+        public?: undefined;
+        description?: undefined;
+        success?: undefined;
+        message?: undefined;
+        detail?: undefined;
+        status?: undefined;
+        action?: undefined;
+        gist_id?: undefined;
+        warning?: undefined;
+        impact?: undefined;
+        requiredAction?: undefined;
+    } | {
+        items?: undefined;
+        count?: undefined;
+        rawText?: undefined;
+        gist_id: string;
+        filename: any;
+        content: string;
+        url?: undefined;
+        public?: undefined;
+        description?: undefined;
+        success?: undefined;
+        message?: undefined;
+        detail?: undefined;
+        status?: undefined;
+        action?: undefined;
+        warning?: undefined;
+        impact?: undefined;
+        requiredAction?: undefined;
+    } | {
+        items?: undefined;
+        count?: undefined;
+        rawText?: undefined;
+        filename?: undefined;
+        content?: undefined;
+        success: boolean;
+        url: string;
+        gist_id: string;
+        public: boolean;
+        description: any;
+        message: string;
+        detail?: undefined;
+        status?: undefined;
+        action?: undefined;
+        warning?: undefined;
+        impact?: undefined;
+        requiredAction?: undefined;
+    } | {
+        items?: undefined;
+        count?: undefined;
+        rawText?: undefined;
+        filename?: undefined;
+        content?: undefined;
+        url?: undefined;
+        public?: undefined;
+        description?: undefined;
+        success: boolean;
+        gist_id: string;
+        message: string;
+        detail: string;
+        status?: undefined;
+        action?: undefined;
+        warning?: undefined;
+        impact?: undefined;
+        requiredAction?: undefined;
+    } | {
+        items?: undefined;
+        count?: undefined;
+        rawText?: undefined;
+        filename?: undefined;
+        content?: undefined;
+        url?: undefined;
+        public?: undefined;
+        description?: undefined;
+        success?: undefined;
+        message?: undefined;
+        detail?: undefined;
+        status: string;
+        action: string;
+        gist_id: string;
+        warning: string;
+        impact: string;
+        requiredAction: string;
+    }>;
+};