#!/usr/bin/env node /** * 領取一顆工作包:上鎖、貼標籤。 * * 鎖用 assignee 加標籤,不用碼錶;碼錶與耗時統計已移除。 * * 他人已認領時擋下,自己已認領時可冪等重跑;所有判斷都在寫入前完成。 * * 所有會擋的判斷都做在任何寫入之前:擋下來卻已經改了一半,比直接放行更難收拾。 * `--dry-run` 走的是同一條路,只是停在寫入之前——它印出的是這一顆此刻真正缺的那幾步, * 而不是一份手寫的固定清單。 * * 用法: * node scripts/claim.js --repo owner/name --index 11 [--host <網址>] [--dry-run] */ import { ScriptError, expectOk, fetchIssue, giteaRequest, listLabels, main, parseFlags, parseIndex, parseRepo, preflight, resolveLogin, } from './lib.js'; /** 領取鎖的另一半。本 plugin 不自動建立標籤,這個名字要在 repo 上先存在。 */ const IN_PROGRESS = '進行中'; main(async () => { const flags = parseFlags(process.argv.slice(2), { required: ['repo', 'index'], optional: ['host'], booleans: ['dry-run'], }); const repo = parseRepo(flags.repo); const index = parseIndex(flags.index); const issuePath = `/repos/${repo}/issues/${index}`; const dryRun = flags['dry-run'] === true; const login = resolveLogin({ host: flags.host }); // 試跑照樣讀現況:手寫一份固定的清單會跟實作走鐘,也說不出「這顆已經是你的了」。 // 前置檢查第二層本來就問過「我是誰」,實跑時直接用它的答案,不再問第二次。 const checked = dryRun ? null : await preflight(login, repo); const me = (checked?.user ?? expectOk(await giteaRequest(login, 'GET', '/user'), 'GET /user')).login; const issue = await fetchIssue(login, repo, index); const assignees = (issue.assignees ?? []).map((user) => user.login); const labels = (issue.labels ?? []).map((label) => label.name); checkClaimable(assignees, me, index); // 本 plugin 不建標籤,缺了就整件事不做,不要只設一半的鎖 const inProgress = (await listLabels(login, repo)).find((label) => label.name === IN_PROGRESS); if (!inProgress) { throw new ScriptError( 'LABEL_NOT_FOUND', `repo ${repo} 上沒有「${IN_PROGRESS}」標籤,領取鎖貼不上去;` + '請先在該 repo 的 Issues → Labels 建立它(本工具不自動建立標籤)', ); } const 已認領過 = assignees.includes(me); const planned = []; if (!已認領過) { planned.push({ method: 'PATCH', path: issuePath, body: { assignees: [me] } }); } if (!labels.includes(IN_PROGRESS)) { planned.push({ method: 'POST', path: `${issuePath}/labels`, body: { labels: [inProgress.id] }, }); labels.push(IN_PROGRESS); } if (dryRun) { return { dryRun: true, repo, index, title: issue.title, requests: planned, 已認領過 }; } for (const { method, path, body } of planned) { expectOk(await giteaRequest(login, method, path, { body }), `${method} ${path}`); } return { repo, index: issue.number, title: issue.title, url: issue.html_url, assignee: me, labels, 已認領過, }; }); /** 他人已認領就擋。自己也在裡面但還有別人時一樣擋——那是兩個人都以為自己在做。 */ function checkClaimable(assignees, me, index) { const others = assignees.filter((login) => login !== me); if (others.length > 0) { throw new ScriptError( 'CLAIMED_BY_OTHER', `議題 #${index} 已由 ${others.join('、')} 認領;` + '請改領別顆,或先與對方確認後由對方取消認領', ); } }