dsh-github-flow 0.5.0 → 0.7.0

package/lib/ui/repo-badges.js

@@ -0,0 +1,82 @@
+/**
+ * 仓库卡片徽章推导（纯函数，无 React 依赖，可被单测直接覆盖）。
+ *
+ * 为什么独立成模块：`client.ts` 是近 2000 行的巨石，其中的 UI 判定逻辑
+ * 只能靠「bundle 里有没有这个字符串」这类弱断言覆盖。把判定规则抽成纯函数后，
+ * 「什么情况出什么徽章」可以被真实断言，而不是靠人工目测。
+ */
+/** 只接受 http/https 的绝对 URL；其余（javascript:、data:、相对路径）一律拒收 */
+function safeHttpUrl(raw) {
+    if (typeof raw !== 'string' || !raw)
+        return null;
+    try {
+        const u = new URL(raw);
+        return u.protocol === 'http:' || u.protocol === 'https:' ? u.toString() : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 依据仓库元数据推导展示信息。
+ *
+ * 三条规则（与上位方案 S4 展示契约对齐，但**不含上游 star**）：
+ *   1. `isFork` 为 true → `⑂ fork` 徽章；有 parent 时附带血缘行
+ *   2. `viewerPermission` 为 READ / TRIAGE → `🔒 只读` 徽章
+ *   3. 其余一律零徽章（保持现有外观）
+ *
+ * 为什么权限未知时不显示任何徽章：离线数据没有该字段，此时既不能说
+ * 「可写」也不能说「只读」——沉默优于猜测。显示一个可能错误的徽章，
+ * 比不显示更糟。
+ *
+ * 为什么不展示上游 star：`parent` 只返回骨架，拿不到 stargazerCount
+ * （`--json` 不支持嵌套子字段，实测）；补一次网络往返实测 3~6 秒，
+ * 而 star 数不是决策信息。详见 s4 执行方案 §2.1。
+ *
+ * @param repo RepoMetadata 或 null/undefined（离线、非 Git 工作区）
+ */
+export function resolveRepoBadges(repo) {
+    const badges = [];
+    let forkLine = null;
+    if (!repo || typeof repo !== 'object') {
+        return { badges, forkLine };
+    }
+    // ---- 规则 1：fork ----
+    // 用 `=== true` 严格比较：字符串 "true" / 数字 1 都不算——
+    // 这类来源不明的真值若被接受，会在数据形态漂移时静默产生错误徽章。
+    if (repo.isFork === true) {
+        const rawName = typeof repo.parent?.nameWithOwner === 'string' ? repo.parent.nameWithOwner.trim() : '';
+        if (rawName) {
+            // URL 只信 http/https：parent.url 来自 API 响应，直接塞进 href 会承接
+            // 任意协议（javascript:/data:）。校验不过就从 nameWithOwner 重建——
+            // 拼出来的地址一定是 https://github.com/<owner>/<repo>，天然安全。
+            const parentUrl = safeHttpUrl(repo.parent?.url) || `https://github.com/${rawName}`;
+            forkLine = { parentNameWithOwner: rawName, parentUrl };
+            badges.push({
+                text: '⑂ fork',
+                tone: 'purple',
+                title: `这是 ${rawName} 的 fork。改动默认提交到你的 fork，需要时再向上游发起 PR。`,
+            });
+        }
+        else {
+            // 拿不到上游也必须告诉用户「这是 fork」——那是确定事实
+            badges.push({
+                text: '⑂ fork',
+                tone: 'purple',
+                title: '这是一个 fork 仓库（未能解析出上游仓库）。',
+            });
+        }
+    }
+    // ---- 规则 2：只读 ----
+    // 只认 READ / TRIAGE：这两个档位必然无法写代码。MAINTAIN 及以上均可写。
+    const perm = typeof repo.viewerPermission === 'string' ? repo.viewerPermission.toUpperCase() : '';
+    if (perm === 'READ' || perm === 'TRIAGE') {
+        badges.push({
+            text: '🔒 只读',
+            tone: 'yellow',
+            title: '当前账号对该仓库仅有只读权限，写操作（创建 Issue / PR / 合并等）会被 GitHub 拒绝。' +
+                '如需提交改动，请先 fork 到自己的账号（gh repo fork --clone）。',
+        });
+    }
+    return { badges, forkLine };
+}

package/lib/ui/repo-selector.d.ts

@@ -0,0 +1,14 @@
+export interface RepoSelectorProps {
+    associatedRepos?: any[];
+    currentRepo?: string;
+    cwd: string | null;
+    onRepoSwitched?: (repo: string) => void;
+    showToast?: (msg: string) => void;
+}
+/**
+ * 关联仓库（上游源仓库 ↔ 个人复刻 Fork）切换下拉组件。
+ *
+ * 为什么单仓库时返回 null：单仓库场景没有切换意义，保持现有卡片外观 100% 纯净零噪音；
+ * 仅在检测到当前工作区存在双 remote 或 Fork 关联拓扑时激活。
+ */
+export declare function RepoSelectorDropdown(props: RepoSelectorProps): any;

package/lib/ui/repo-selector.js

@@ -0,0 +1,112 @@
+/**
+ * 关联仓库（上游源仓库 ↔ 个人复刻 Fork）切换下拉组件。
+ *
+ * 为什么单仓库时返回 null：单仓库场景没有切换意义，保持现有卡片外观 100% 纯净零噪音；
+ * 仅在检测到当前工作区存在双 remote 或 Fork 关联拓扑时激活。
+ */
+export function RepoSelectorDropdown(props) {
+    var associatedRepos = Array.isArray(props.associatedRepos) ? props.associatedRepos : [];
+    var currentRepo = (props.currentRepo || '').toLowerCase();
+    var cwd = props.cwd;
+    var onRepoSwitched = props.onRepoSwitched || (() => { });
+    var showToast = props.showToast || (() => { });
+    // 严格遵守 React Hooks 铁律：所有 useState / useRef / useEffect 必须无条件在顶层执行，
+    // 严禁在任何条件分支/early return 之后调用 Hooks，杜绝触发
+    // "Rendered fewer hooks than expected" 的致命运行时崩溃。
+    var [isOpen, setIsOpen] = React.useState(false);
+    var [switching, setSwitching] = React.useState(false);
+    var containerRef = React.useRef(null);
+    React.useEffect(() => {
+        if (!isOpen)
+            return;
+        var handleClickOutside = (e) => {
+            if (containerRef.current && !containerRef.current.contains(e.target)) {
+                setIsOpen(false);
+            }
+        };
+        document.addEventListener('mousedown', handleClickOutside);
+        return () => document.removeEventListener('mousedown', handleClickOutside);
+    }, [isOpen]);
+    // Hooks 执行完毕后再进行单仓库零噪音短路返回
+    if (associatedRepos.length <= 1) {
+        return null;
+    }
+    var toggleOpen = (e) => {
+        e.stopPropagation();
+        setIsOpen(!isOpen);
+    };
+    var handleSwitch = async (targetRepo, targetRemote) => {
+        if (switching)
+            return;
+        setSwitching(true);
+        try {
+            var res = await fetch('/api/github/action', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    action: 'set_default_repo',
+                    cwd,
+                    repo: targetRepo,
+                    remote: targetRemote,
+                }),
+            });
+            var json = await res.json().catch(() => ({}));
+            if (!res.ok || !json.ok) {
+                showToast(`❌ 切换基准仓库失败：${json.error || json.message || res.statusText}`);
+                return;
+            }
+            setIsOpen(false);
+            showToast(`✅ 已将基准仓库切换为 ${targetRepo}`);
+            onRepoSwitched(targetRepo);
+        }
+        catch (err) {
+            showToast(`❌ 切换请求异常：${err?.message || err}`);
+        }
+        finally {
+            setSwitching(false);
+        }
+    };
+    var roleLabel = (role) => {
+        switch (role) {
+            case 'fork': return '我的复刻';
+            case 'upstream': return '上游源仓库';
+            case 'parent': return '上游主干';
+            case 'origin': return 'origin';
+            default: return '远程关联';
+        }
+    };
+    var roleBadgeTone = (role) => {
+        switch (role) {
+            case 'fork': return 'dsh-badge-purple';
+            case 'upstream':
+            case 'parent': return 'dsh-badge-readonly';
+            default: return 'dsh-badge-blue';
+        }
+    };
+    var h = React.createElement;
+    return h('div', {
+        ref: containerRef,
+        style: { position: 'relative', display: 'inline-flex', alignItems: 'center' },
+        className: 'dsh-github-repo-selector-container',
+    }, h('button', {
+        type: 'button',
+        className: 'dsh-github-repo-switch-trigger',
+        onClick: toggleOpen,
+        title: `当前关联 ${associatedRepos.length} 个远程仓库（点击切换基准）`,
+        disabled: switching,
+    }, h('span', null, switching ? '⏳' : '⇄'), h('span', { style: { fontSize: '11px', fontWeight: 500 } }, '切换仓库'), h('span', { style: { fontSize: '9px', opacity: 0.7 } }, '▾')), isOpen
+        ? h('div', { className: 'dsh-github-repo-dropdown' }, h('div', { className: 'dsh-github-repo-dropdown-header' }, h('span', null, '选择当前工作区基准仓库'), h('span', { style: { fontSize: '11px', opacity: 0.6 } }, `${associatedRepos.length} 可用`)), h('div', { className: 'dsh-github-repo-dropdown-list' }, associatedRepos.map(function (item) {
+            var isSelected = item.isCurrent || item.nameWithOwner.toLowerCase() === currentRepo;
+            return h('div', {
+                key: item.nameWithOwner,
+                className: 'dsh-github-repo-item' + (isSelected ? ' selected' : ''),
+                title: isSelected ? '当前正在使用的基准仓库' : `点击切换基准为 ${item.nameWithOwner}`,
+                onClick: function () {
+                    if (!isSelected && !switching) {
+                        handleSwitch(item.nameWithOwner, item.remoteName);
+                    }
+                },
+            }, h('div', { style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: '8px' } }, h('div', { style: { display: 'flex', alignItems: 'center', gap: '6px', minWidth: 0 } }, h('span', { style: { color: isSelected ? 'var(--dsw-alias-link, #0969da)' : 'inherit', fontWeight: isSelected ? 600 : 400 } }, item.nameWithOwner), h('span', { className: 'dsh-github-badge ' + roleBadgeTone(item.role), style: { fontSize: '10px', padding: '0 5px' } }, roleLabel(item.role))), isSelected ? h('span', { style: { color: 'var(--dsw-alias-state-success, #1a7f37)', fontWeight: 600 } }, '✓') : null));
+        })), h('div', { className: 'dsh-github-repo-dropdown-footer' }, '💡 切换后系统将自动调用 gh repo set-default 对齐终端与面板'))
+        : null);
+}

package/lib/ui/run-modal.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Actions run / job / step 的耗时格式化（导出以便单测直接覆盖）。
+ *
+ * 为什么不用 formatRelativeTime：那个函数答的是「发生在多久前」，这里是「跑了多久」；
+ * 而且 run → job → step 三层共用同一套精度规则（<60s → `12s`、<60m → `3m20s`、
+ * 其余 `1h05m`），分钟/秒补零才能让三层的列宽稳定对齐。
+ * 任一端缺失或不可解析一律返回空串：排队中/已跳过的 job 没有 startedAt/completedAt，
+ * 硬算只会渲染出「0s」这种假精确值，比不显示更误导。
+ */
+export declare function formatRunDuration(startISO?: string, endISO?: string): string;
+export interface RunDetailModalProps {
+    runId: number;
+    repoNameWithOwner?: string;
+    cwd?: string | null;
+    onClose: () => void;
+    showToast?: (msg: string) => void;
+}
+/**
+ * Actions Run 详情弹窗（只读：run 元信息 + job/step 树 + 失败日志片段）。
+ *
+ * 单列纵向：run 的信息天然是「job 列表 + 一条日志流」的阅读顺序，没有需要并排
+ * 对照的第二个信息源（PR 才有 diff 双栏）。
+ * 日志刻意渲染成 <pre> 原文而不是 markdown-lite：原始日志里的 `#`、`|`、`---`
+ * 是 shell 注释、表格与 diff 分隔符，交给 Markdown 解析会把堆栈与 diff 撕碎。
+ */
+export declare function RunDetailModal(props: RunDetailModalProps): any;