@bensandee/forgejo-cli 0.10.0 → 0.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -1
- package/dist/bin.mjs +22 -21
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -61,7 +61,8 @@ command takes `--json`, which prints exactly one JSON document, failures include
|
|
|
61
61
|
| `pr:retarget` | Repoint an open pull request at a new base branch, confirm the forge took it, and report its mergeability as advice; the number defaults to the current branch's open pull request |
|
|
62
62
|
| `workflow:dispatch` | Dispatch a workflow with `--workflow`, `--ref` and repeatable `--input`; takes `--repo owner/repo`, not a URL |
|
|
63
63
|
| `ci:runs` | List a repository's workflow runs with their jobs, filtered by workflow, ref, pull request, head SHA or status |
|
|
64
|
-
| `ci:
|
|
64
|
+
| `ci:rerun` | Rerun a finished workflow run, or one job and the jobs that depend on it (Forgejo 17 or later); Forgejo reports no id for the new attempt |
|
|
65
|
+
| `ci:log` | Print one workflow job's whole log, or with `--grep` only the lines whose text matches; on Forgejo 17 it shows the job's step table and `--step` reads one step |
|
|
65
66
|
|
|
66
67
|
Zero posted statuses reads as `no-status`, never as green. Every command is Forgejo-only: on
|
|
67
68
|
GitHub, use `gh`. The `issue:*`, `pr:create`, `pr:update`, `pr:ready`, `pr:reopen` and `pr:retarget`
|
package/dist/bin.mjs
CHANGED
|
@@ -1,31 +1,32 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import{existsSync as e,mkdirSync as t,readFileSync as n,statSync as r,writeFileSync as i,writeSync as a}from"node:fs";import o,*as s from"node:path";import{parseArgs as c,parseEnv as l}from"node:util";import{FatalError as u,TransientError as d,UnexpectedError as f,describeError as p,redact as m,redact as h}from"@bensandee/common";import{z as g}from"zod";import{defineCommand as _,renderUsage as v,runCommand as y,runMain as b}from"citty";import{execFileSync as x,spawn as S}from"node:child_process";function resolveJsonMode(e){return!(!e.some(requestsJson)||e.includes(`--help`)||e.includes(`-h`)||e.length===1&&(e[0]===`--version`||e[0]===`-v`))}function requestsJson(e){return e===`--json`?!0:e.startsWith(`--json=`)?e!==`--json=false`:!1}function resolveCommandName(e){for(let t of e){if(t===`--`)return;if(!t.startsWith(`-`))return t}}function verboseRequested(e){return process.env.TOOLING_TRACE===`true`||process.env.TOOLING_DEBUG===`true`||e.includes(`--verbose`)||e.includes(`-v`)||e.includes(`--trace`)}function asCommandDef(e){if(e!==void 0&&typeof e!=`function`&&!(e instanceof Promise))return e}function commandDeclaresJson(e){if(e===void 0)return!1;let t=e.args;return t===void 0||typeof t==`function`||t instanceof Promise?!1:`json`in t}function buildErrorDocument(e){let t=e.detail===void 0?{kind:e.kind,message:e.message}:{kind:e.kind,message:e.message,detail:e.detail};return{ok:!1,command:e.command,version:e.version,error:t}}function runJsonExitNet(e){if(e.wroteDocument())return;let t=e.command??e.binName,n=buildErrorDocument({command:e.command,version:e.version,kind:`runtime`,message:`${t} --json exited before the command produced a result: the process ended with the command still outstanding, so no document was recorded.`});try{e.write(JSON.stringify(n)+`
|
|
3
|
-
`)}catch{}process.exitCode=1}function installJsonExitNet(e,t,n,r){process.on(`exit`,()=>{runJsonExitNet({write:e=>a(1,e),wroteDocument:r,command:t,version:n,binName:e})})}function classifyThrown(e,t){let n=e instanceof Error&&e.name===`CLIError`?`usage`:`runtime`,r=m(p(e));if(!t)return{kind:n,message:r};let i=e instanceof Error&&typeof e.stack==`string`?m(e.stack):void 0;return i===void 0?{kind:n,message:r}:{kind:n,message:r,detail:i}}const C=`BST_ENV_FILE`;function loadEnvFileFromEnv(){let e=process.env[C]?.trim();if(e===void 0||e===``)return;let t=s.resolve(e),r;try{r=n(t,`utf8`)}catch(e){let n=e instanceof Error?e.message:String(e);throw new u(`${C} names ${t}, which could not be read (${n}). Unset ${C} or point it at a readable env file.`)}let i=[],a=[];for(let[e,t]of Object.entries(l(r)))process.env[e]===void 0?(process.env[e]=t,i.push(e)):a.push(e);return{path:t,added:i,kept:a}}function describeEnvFileLoad(e){if(e===void 0)return`No env file loaded -- ${C} is unset or empty.`;let t=[`Loaded ${String(e.added.length)} variable(s) from ${e.path} (${C}): `+(e.added.length===0?`none`:e.added.join(`, `))];return e.kept.length>0&&t.push(`${String(e.kept.length)} already set in the environment kept their value: `+e.kept.join(`, `)),t.join(`; `)}const w={out:e=>{process.stdout.write(`${e}\n`)},err:e=>{process.stderr.write(`${e}\n`)},exit:e=>process.exit(e)};function loadEnvFileForBin(e,t,n=w){try{return loadEnvFileFromEnv()}catch(r){let i=r instanceof Error?r.message:String(r);if(resolveJsonMode(e)){let r=buildErrorDocument({command:resolveCommandName(e),version:t.version,kind:`usage`,message:i});n.out(JSON.stringify(r))}else n.err(`${t.name}: ${i}`);return n.exit(1)}}const T=g.object({version:g.string()}).safeParse({name:`@bensandee/forgejo-cli`,version:`0.10.0`,description:`bst-fj: Forgejo API commands without the rest of bst`,license:`MIT`,repository:{type:`git`,url:`https://codeberg.org/bensandee/tooling.git`,directory:`packages/forgejo-cli`},bin:{"bst-fj":`./bin/bst-fj.mjs`},files:[`bin`,`dist`],type:`module`,imports:{"#src/*.ts":`./src/*.ts`},exports:{"./package.json":`./package.json`,"./*":`./src/*.ts`,"./test/*":`./test/*.ts`},publishConfig:{exports:{"./package.json":`./package.json`},access:`public`,registry:`https://registry.npmjs.org`},scripts:{build:`tsdown`,dev:`tsdown --watch`,test:`vitest run`},dependencies:{"@bensandee/common":`0.2.0`,citty:`^0.2.2`,zod:`^4.6.7`},devDependencies:{"@bensandee/cli-kit":`workspace:*`,"@bensandee/forgejo":`workspace:*`,"@types/node":`24.19.2`,tsdown:`0.23.4`}});if(!T.success)throw new f(`@bensandee/forgejo-cli's package.json has no string version.`);const E=T.data.version,ee=loadEnvFileForBin(process.argv.slice(2),{name:`bst-fj`,version:E}),D={error:0,warn:1,info:2,debug:3,trace:4};let O=`info`;function setLogLevel(e){O=e}function resolveLogLevel(e){return e.trace===!0||process.env.TOOLING_TRACE===`true`?`trace`:e.verbose===!0||process.env.TOOLING_DEBUG===`true`?`debug`:`info`}process.env.CI;const out=e=>console.log(e),err=e=>console.error(e),k={info:out,warn:e=>out(`[warn] ${e}`),error:e=>out(`[error] ${e}`),success:e=>out(`[ok] ${e}`)};let A=!1;function setJsonMode(e){A=e}function isJsonMode(){return A}let j;function setJsonNoticeSink(e){j=e}function formatContext(e){let t=[];if(e.repo!==void 0){let n=e.repo.split(`/`).findLast(e=>e.length>0);n!==void 0&&t.push(n)}return e.issue!==void 0&&t.push(`#${String(e.issue)}`),e.pr!==void 0&&t.push(`PR#${String(e.pr)}`),e.phase!==void 0&&t.push(e.phase),t.length>0?`[${t.join(` `)}]`:``}function build(e){let t=formatContext(e.context),enabled=t=>D[t]<=D[e.level??O],stamp=()=>`[${e.now().toISOString()}]`,userFacing=(n,r)=>i=>{if(!enabled(r))return;if(A){(n===`warn`||n===`error`)&&j&&j(h(i));return}let a=[];(e.timestamps??!1)&&a.push(stamp()),t&&a.push(t),a.push(h(i)),(e.userSink??k)[n](a.join(` `))},diagnostic=n=>r=>{if(!enabled(n))return;let i=[stamp()];t&&i.push(t),i.push(`[${n}]`,h(r)),e.diagnosticSink(i.join(` `))};return{info:userFacing(`info`,`info`),warn:userFacing(`warn`,`warn`),error:userFacing(`error`,`error`),success:userFacing(`success`,`info`),debug:diagnostic(`debug`),trace:diagnostic(`trace`),child:t=>build({...e,context:{...e.context,...t}})}}function createLogger(e={}){return build({level:e.level,timestamps:e.timestamps,context:e.context??{},userSink:e.userSink,diagnosticSink:e.diagnosticSink??err,now:e.now??(()=>/* @__PURE__ */ new Date)})}const M=createLogger(),N=[`--help`,`-h`,`--version`,`-v`,`--verbose`,`--trace`],P=new Set(N.map(flagName));function hasHelpFlag(e){return e.includes(`--help`)||e.includes(`-h`)}function isLoneVersionQuery(e){return e.length===1&&(e[0]===`--version`||e[0]===`-v`)}function splitAtCommand(e,t){for(let n=0;n<e.length;n++){let r=e[n];if(r===`--`)return;if(r.startsWith(`-`))t!==void 0&&!r.includes(`=`)&&declaresValueFlag(r,t)&&n++;else return{index:n,before:e.slice(0,n)}}}function declaresValueFlag(e,t){let n=flagName(e),r=toCamelCase(n);for(let[e,i]of Object.entries(t)){if(i.type!==`string`&&i.type!==`enum`)continue;if(r===toCamelCase(e))return!0;let t=`alias`in i?i.alias:void 0;if(t!==void 0&&(Array.isArray(t)?t.includes(n):t===n))return!0}return!1}function flagBase(e){let t=e.indexOf(`=`);return t===-1?e:e.slice(0,t)}function flagName(e){return flagBase(e).replace(/^-{1,2}/,``)}function resolveStaticArgsDef(e){let t=e.args;if(t!==void 0&&typeof t!=`function`&&!(t instanceof Promise))return t}function toCamelCase(e){return e.replace(/-([a-z0-9])/g,(e,t)=>t.toUpperCase())}function toKebabCase(e){return e.replace(/([a-z0-9])([A-Z])/g,`$1-$2`).toLowerCase()}function buildParseTable(e){let t=/* @__PURE__ */ new Set,n=/* @__PURE__ */ new Map,r=new Set(P),i=[];for(let[a,o]of Object.entries(e)){if(o.type===`positional`)continue;o.type===`boolean`&&t.add(a);let e=`alias`in o?o.alias:void 0,s;s=e===void 0?[]:Array.isArray(e)?e:[e];let c=[...s],l=toCamelCase(a),u=toKebabCase(a);l!==a&&!c.includes(l)&&c.push(l),u!==a&&!c.includes(u)&&c.push(u),n.set(a,c),r.add(a);for(let e of c)r.add(e);i.push(`--${a}`)}function typeFor(e){if(t.has(e))return`boolean`;for(let[r,i]of n)if((r===e||i.includes(e))&&t.has(r))return`boolean`;return`string`}let a={};for(let[e,t]of n){a[e]={type:typeFor(e)};for(let e of t)a[e]={type:typeFor(e)}}return{nodeOptions:a,knownNames:r,acceptedFlags:i}}function parsePostCommandArgs(e,t){let n=[],r=[];for(let t=0;t<e.length;t++){let i=e[t];if(i===`--`){r.push(...e.slice(t));break}i.startsWith(`--no-`)?n.push(i.slice(5)):r.push(i)}let i={},a=[];try{let e=c({args:r,options:Object.keys(t).length>0?t:void 0,allowPositionals:!0,strict:!1});i=e.values,a=e.positionals}catch{i={}}return{values:i,positionals:a,negatedNames:n}}function findBadDirArg(e,t,n,r){let{positionals:i}=parsePostCommandArgs(e,n),a=Object.entries(t).filter(([,e])=>e.type===`positional`);for(let[e,[t,n]]of a.entries()){let a=i.at(e);if(a===void 0||n.valueHint!==`dir`)continue;let o=r(a);if(o!==`directory`)return{argName:t,value:a,missing:o===`missing`}}}function computeUnknownArgNames(e,t){let n=buildParseTable(t),{values:r,negatedNames:i}=parsePostCommandArgs(e,n.nodeOptions),a=/* @__PURE__ */ new Set;for(let e of Object.keys(r))n.knownNames.has(e)||a.add(e);for(let e of i)n.knownNames.has(e)||a.add(e);return[...a]}function buildDisplayTokenMap(e){let t=/* @__PURE__ */ new Map;for(let n of e){if(n===`--`)break;if(n.startsWith(`--no-`)){let e=n.slice(5);t.has(e)||t.set(e,flagBase(n));continue}if(!n.startsWith(`-`))continue;let e=flagName(n);t.has(e)||t.set(e,flagBase(n))}return t}function formatFlagToken(e){return e.length===1?`-${e}`:`--${e}`}function resolveStaticSubCommands(e){let t=e.subCommands;if(t!==void 0&&typeof t!=`function`&&!(t instanceof Promise))return t}function resolveLeafCommand(e,t,n){let r=resolveStaticArgsDef(e),i=resolveStaticSubCommands(e);if(i!==void 0){let e=splitAtCommand(n,r);if(e!==void 0){let r=n[e.index];if(!(r in i))return;let a=asCommandDef(i[r]);return a===void 0?void 0:resolveLeafCommand(a,[...t,r],n.slice(e.index+1))}}return r===void 0?void 0:{chain:t,argsDef:r,postCommandArgs:n}}function findUnknownFlags(e,t,n){if(hasHelpFlag(e)||isLoneVersionQuery(e))return{kind:`none`};let r=splitAtCommand(e);if(r===void 0)return{kind:`none`};let i=e[r.index];if(!(i in t))return{kind:`none`};let a=asCommandDef(t[i]);if(a===void 0)return{kind:`none`};for(let e of r.before)if(!P.has(flagName(e)))return{kind:`before-command`,command:i,flag:flagBase(e)};let o=resolveLeafCommand(a,[i],e.slice(r.index+1));if(o===void 0)return{kind:`none`};let s=buildParseTable(o.argsDef),c=computeUnknownArgNames(o.postCommandArgs,o.argsDef);if(c.length===0){let e=n===void 0?void 0:findBadDirArg(o.postCommandArgs,o.argsDef,s.nodeOptions,n);return e===void 0?{kind:`none`}:{kind:`not-a-directory`,command:i,commandPath:o.chain.join(` `),...e}}let l=buildDisplayTokenMap(o.postCommandArgs);return{kind:`unknown`,command:i,commandPath:o.chain.join(` `),unknownFlags:c.map(e=>l.get(e)??formatFlagToken(e)),accepted:s.acceptedFlags}}function formatUnknownFlagsMessage(e){let t=`Unknown ${e.unknownFlags.length===1?`flag`:`flags`} ${e.unknownFlags.join(`, `)} for ${e.commandPath}. Nothing ran.`,n=N.filter(t=>t.startsWith(`--`)&&t!==`--version`&&!e.accepted.includes(t));return`${t}\nAccepted: ${n.length===0?e.accepted.join(`, `):`${e.accepted.join(`, `)} (plus ${n.join(`, `)})`}.`}function formatFlagBeforeCommandMessage(e){return`${e.flag} must come after the command name.`}function formatNotADirectoryMessage(e){return`${e.missing?`No such directory: ${e.value}.`:`${e.value} is not a directory.`} ${e.commandPath} takes a directory as [${e.argName}]. Nothing ran.`}function formatFlagCheckMessage(e){return e.kind===`before-command`?formatFlagBeforeCommandMessage(e):e.kind===`not-a-directory`?formatNotADirectoryMessage(e):formatUnknownFlagsMessage(e)}function collectFlagValues(e,t){let n=`${t}=`,r=[];for(let i=0;i<e.length;i+=1){let a=e[i];if(a!==void 0){if(a===`--`)break;if(a===t){let t=e[i+1];t!==void 0&&(r.push(t),i+=1)}else a.startsWith(n)&&r.push(a.slice(n.length))}}return r.map(e=>e.trim()).filter(e=>e!==``)}function hasNegationFlag(e,t){for(let n of e){if(n===`--`)break;if(n===t)return!0}return!1}function flagPresent(e,t){for(let n of e){if(n===`--`)break;if(n===t||n.startsWith(`${t}=`))return!0}return!1}function resolveRepeatableFlag(e,t,n,r){let i=collectFlagValues(e,t),a=hasNegationFlag(e,n);if(i.length>0&&a)throw new u(`${t} and ${n} are contradictory -- pass only one.`);if(i.length===0&&flagPresent(e,t)){let e=r.fallback===void 0?``:` Refusing rather than falling back to ${r.fallback}.`;throw new u(`${t} was given with no ${r.noun} (expected e.g. ${t} ${r.example}).${e}`)}return a?{kind:`negated`}:i.length>0?{kind:`values`,values:i}:{kind:`absent`}}const te=/^(\d+)(s|m|h)?$/,ne={s:1e3,m:6e4,h:36e5};function parseDuration(e,t){let n=te.exec(e.trim());if(!n)throw new u(`${t} expects a duration like "30s", "15m", or "1h" (a bare integer means seconds) -- got ${JSON.stringify(e)}.`);let[,r,i]=n,a=ne[i??`s`];return Number.parseInt(r??`0`,10)*a}function parseListFlag(e,t){let n=`--${t}`,r=[];for(let[t,i]of e.entries()){if(i===`--`)break;if(i.startsWith(`${n}=`)){r.push(i.slice(n.length+1));continue}if(i!==n)continue;let a=e[t+1];a!==void 0&&!a.startsWith(`--`)&&r.push(a)}return r.flatMap(e=>e.split(`,`)).map(e=>e.trim()).filter(e=>e.length>0)}function listFlagPresent(e,t){let n=`--${t}`;return e.some(e=>e===n||e.startsWith(`${n}=`))}function parseLimitFlag(e){let t=Number(e);if(!Number.isInteger(t)||t<1)throw new u(`--limit must be a positive integer, got "${e}"`);return t}const stdout=e=>console.log(e);function initialState(){return{payload:void 0,hasPayload:!1,error:void 0,hasError:!1,notices:[],wrote:!1}}let F=initialState();function isJsonRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function isStringArray(e){return Array.isArray(e)&&e.every(e=>typeof e==`string`)}function createCliOutput(e){let t=e||isJsonMode();return{json:e=>{t&&(F.hasPayload&&M.debug(`output: a second json() call overwrote the first -- last call wins.`),F.payload=e,F.hasPayload=!0)},text:e=>{t||stdout(e)},notice:e=>{t?F.notices.push(h(e)):stdout(e)}}}function recordJsonError(e){F.error=e,F.hasError=!0}function buildFlushDocument(){let e;if(F.hasError?e=F.error:F.hasPayload&&(e=F.payload),e!==void 0){if(F.notices.length===0)return e;if(isJsonRecord(e)){let{notices:t}=e;return{...e,notices:isStringArray(t)?[...t,...F.notices]:F.notices}}return{payload:e,notices:F.notices}}}function flushJsonOutput(){let e=buildFlushDocument();return e!==void 0&&(stdout(JSON.stringify(e)),F.wrote=!0,!0)}function jsonDocumentWritten(){return F.wrote}function probeCliPath(e){try{let t=r(e,{throwIfNoEntry:!1});return t===void 0?`missing`:t.isDirectory()?`directory`:`file`}catch{return`missing`}}function classifyWithHook(e,t,n){let r=classifyThrown(e,t),i=n?.(e);return i===void 0?r:{...r,message:m(i)}}function drain(e){return new Promise(t=>{e.write(``,()=>t())})}function applyVerbosityFromArgs(e){setLogLevel(resolveLogLevel({verbose:e.includes(`--verbose`)||e.includes(`-v`),trace:e.includes(`--trace`)}))}function guardCommand(e,t,n){let{run:r,subCommands:i}=e,a={...e};return r!==void 0&&(a.run=async e=>{try{return await r(e)}catch(e){if(!(!t&&e instanceof Error&&(e.name===`FatalError`||e.name===`TransientError`)))throw e;console.error(classifyWithHook(e,!1,n).message),process.exitCode=1;return}}),i!==void 0&&(a.subCommands=async()=>{let e=typeof i==`function`?await i():await i,r={};for(let[i,a]of Object.entries(e))r[i]=async()=>guardCommand(typeof a==`function`?await a():await a,t,n);return r}),a}function firstSentence(e){let t=/^[\s\S]*?\.(?=\s+[A-Z])/.exec(e);return t===null?e:t[0]}async function renderTableUsage(e,t){return v(shortenChildren(e),t)}function shortenChildren(e){let{subCommands:t}=e;return t===void 0?e:{...e,subCommands:async()=>{let e=typeof t==`function`?await t():await t,n={};for(let[t,r]of Object.entries(e))n[t]=async()=>{let e=typeof r==`function`?await r():await r,t=typeof e.meta==`function`?await e.meta():await e.meta,n=t?.description;return{...shortenChildren(e),meta:{...t,...n===void 0?{}:{description:firstSentence(n).replace(/\s+/g,` `)}}}};return n}}}async function showTableUsage(e,t){console.log(await renderTableUsage(e,t)+`
|
|
4
|
-
`)}async function runCli(e){let t=e.subCommands,n=_({meta:{name:e.name,version:e.version,description:e.description},subCommands:t}),exitWithJsonError=async(t,n,r,i)=>{recordJsonError(buildErrorDocument({command:t,version:e.version,kind:n,message:r,detail:i})),(process.exitCode??0)===0&&(process.exitCode=1),flushJsonOutput(),await Promise.all([drain(process.stdout),drain(process.stderr)]),process.exit(process.exitCode??0)},r=process.argv.slice(2);applyVerbosityFromArgs(r);let i=resolveCommandName(r);if(!resolveJsonMode(r)){let i=findUnknownFlags(r,t,probeCliPath);i.kind!==`none`&&(console.error(formatFlagCheckMessage(i)),process.exitCode=1,await Promise.all([drain(process.stdout),drain(process.stderr)]),process.exit(process.exitCode??0)),e.banner!==void 0&&console.error(e.banner),await b(guardCommand(n,verboseRequested(r),e.describeError),{showUsage:showTableUsage}),await Promise.all([drain(process.stdout),drain(process.stderr)]),process.exit(process.exitCode??0)}setJsonMode(!0),setJsonNoticeSink(e=>createCliOutput(!0).notice(e)),installJsonExitNet(e.name,i,e.version,jsonDocumentWritten);let a=findUnknownFlags(r,t,probeCliPath);a.kind!==`none`&&await exitWithJsonError(a.command,`usage`,formatFlagCheckMessage(a));let o=asCommandDef(i!==void 0&&i in t?t[i]:void 0);if(i===void 0||o===void 0||!commandDeclaresJson(o)){let e;e=i===void 0?`No command specified.`:o===void 0?`Unknown command ${i}.`:`Command ${i} does not support --json.`,await exitWithJsonError(i,`usage`,e)}try{await y(n,{rawArgs:r})}catch(t){let n=classifyWithHook(t,verboseRequested(r),e.describeError);await exitWithJsonError(i,n.kind,n.message,n.detail)}flushJsonOutput()||await exitWithJsonError(i,`runtime`,`${i} --json completed without recording a JSON payload. This is a bug in the command's --json support -- it does not necessarily mean the command's underlying action failed.`),await Promise.all([drain(process.stdout),drain(process.stderr)]),process.exit(process.exitCode??0)}let I={warn(e){process.stderr.write(`${e}\n`)},debug(){}};function setForgejoLogger(e){I=e}const L={warn(e){I.warn(e)},debug(e){I.debug(e)}};function parseGitUrl(e){try{let t=new URL(e),n=t.pathname.replace(/\.git$/,``).replace(/^\//,``);return n.includes(`/`)?{protocol:t.protocol,hostname:t.hostname,repository:n}:null}catch{return null}}function forgeTokenFromEnv(e){return e.RELEASE_TOKEN||e.FORGEJO_TOKEN}function resolveRepoUrlFrom(e,t){let n=normalizeGitUrl(e()??``);if(n!==null&&parseGitUrl(n)!==null)return n;let r=t();return r===null||parseGitUrl(r)===null?null:normalizeGitUrl(r)}function resolveForgejoConnection(e,t){let n=e.FORGEJO_SERVER_URL,r=e.FORGEJO_REPOSITORY,i=forgeTokenFromEnv(e);if(n&&r&&i)return{serverUrl:n,repository:r,token:i};let a=t(),o=a===null?null:parseGitUrl(a);if(o===null){if(n){if(!r)throw new u(`FORGEJO_REPOSITORY environment variable is required`);if(!i)throw new u(`RELEASE_TOKEN environment variable is required`)}return null}if(o.hostname===`github.com`)return null;if(!i)throw new u(`RELEASE_TOKEN environment variable is required (server URL and repository were resolved from package.json)`);return{serverUrl:n??`${o.protocol}//${o.hostname}`,repository:r??o.repository,token:i}}const re=/^\/([^/]+\/[^/]+)\/(?:issues|pulls?)\/(\d+)\/?$/;function parseIssueRef(e){if(e===void 0||e.trim()===``)return{};let t=e.trim();if(/^\d+$/.test(t))return{number:Number.parseInt(t,10)};let n;try{n=new URL(t)}catch{n=void 0}if(n!==void 0&&n.protocol!==`http:`&&n.protocol!==`https:`)throw new u(`Not an issue number or issue URL: "${t}" (expected e.g. 273 or https://host/owner/repo/issues/273)`);if(n!==void 0){let e=re.exec(n.pathname);if(e){let[,t,r]=e;if(t!==void 0&&r!==void 0)return{number:Number.parseInt(r,10),target:{serverUrl:n.origin,repository:t,hostname:n.hostname}}}}throw new u(`Not an issue number or issue URL: "${t}" (expected e.g. 273 or https://host/owner/repo/issues/273)`)}var RepoTargetEmptyError=class extends u{constructor(){super(`No repository URL was given.`)}},RepoTargetMismatchError=class extends u{given;fromReference;constructor(e,t){super(`The repository (${e}) and the issue URL (${t}) disagree.`),this.given=e,this.fromReference=t}};function parseRepoTarget(e){if(e===void 0)return;if(e.trim()===``)throw new RepoTargetEmptyError;let t=/^(https?:\/\/[^/]+)\/([^/]+\/[^/]+?)(?:\.git)?\/?$/.exec(e.trim());if(!t)throw new u(`Not a repository URL: "${e}"`);let[,n,r]=t;if(n===void 0||r===void 0)throw new u(`Not a repository URL: "${e}"`);return{serverUrl:n,repository:r,hostname:new URL(n).hostname}}function resolveIssueTarget(e,t){let n=parseRepoTarget(t);if(e===void 0)return n;if(n===void 0||e.serverUrl===n.serverUrl&&e.repository===n.repository)return e;throw new RepoTargetMismatchError(`${n.serverUrl}/${n.repository}`,`${e.serverUrl}/${e.repository}`)}function normalizeGitUrl(e){let t=e.startsWith(`git+`)?e.slice(4):e,n=t.match(/^git@([^:]+):(.+?)(?:\.git)?$/);if(n)return`https://${n[1]}/${n[2]}`;try{let e=new URL(t);return e.pathname=e.pathname.replace(/\.git$/,``),e.username=``,e.password=``,e.toString().replace(/\/$/,``)}catch{return null}}function describeForgeError(e){if(e instanceof RepoTargetEmptyError)return`--repo was given with no repository URL (expected e.g. https://host/owner/repo).`;if(e instanceof RepoTargetMismatchError)return`--repo disagrees with the issue URL: --repo names ${e.given}, the issue URL names ${e.fromReference}.`}const R={attempts:5,baseDelayMs:250,maxDelayMs:2e3};function isTransientTransportError(e){return e instanceof TypeError||e instanceof DOMException&&(e.name===`TimeoutError`||e.name===`AbortError`)}function withTimeoutSignal(e,t){if(t<=0)return e;let n=AbortSignal.timeout(t);return e?.signal==null?{...e,signal:n}:{...e,signal:AbortSignal.any([e.signal,n])}}async function retryBackoff(e,t,n){if(t<=0)return;let r=Math.min(t*2**(e-1),n);await new Promise(e=>setTimeout(e,r))}async function retryOnTransient(e,t=R,n=null){let r;for(let i=1;i<=t.attempts;i++)try{return await e()}catch(e){if(n?.aborted||!isTransientTransportError(e))throw e;r=e,i<t.attempts&&await retryBackoff(i,t.baseDelayMs,t.maxDelayMs)}throw r}function fetchWithRetry(e,t=R,n=12e4){return(r,i,a)=>{let o=(i?.method??`GET`).toUpperCase(),s=o===`GET`||o===`HEAD`||a?.idempotent===!0,c=a?.timeoutMs??n,l=i?.signal??null,attempt=()=>e(r,withTimeoutSignal(i,c));return s?retryOnTransient(attempt,a?.attempts===void 0?t:{...t,attempts:a.attempts},l):attempt()}}function createForgeFetcher(e=R){return{fetch:fetchWithRetry((e,t)=>globalThis.fetch(e,t),e)}}function cliFetcher(){return createForgeFetcher()}var ForgeAccessError=class extends u{};function authHeaders(e){return{Authorization:`token ${e.token}`}}function jsonHeaders(e){return{...authHeaders(e),"Content-Type":`application/json`}}function repoNotFoundMessage(e){return`Repository ${e.repository} not found (or the token cannot see it)`}function repoBase(e){return`${e.serverUrl}/api/v1/repos/${e.repository}`}function issuesBase(e){return`${repoBase(e)}/issues`}function issueNotFoundMessage(e,t){return`Issue #${String(t)} not found in ${e.repository}`}const z=g.object({id:g.number(),name:g.string(),size:g.number(),created_at:g.string(),browser_download_url:g.string()}),ie=g.array(z);function normalizeAttachment(e){return{id:e.id,name:e.name,size:e.size,createdAt:e.created_at,downloadUrl:e.browser_download_url}}async function responseBodyText(e){try{let t=await e.text(),n=t.length>500?t.slice(0,500)+`...`:t;return m(n)}catch{return`(could not read response body)`}}const ae=g.union([g.object({message:g.literal(``)}),g.object({message:g.string(),url:g.string().regex(/\/api\/swagger$/)})]);function isForgejoGenericServerErrorBody(e){if(e===``)return!0;try{let t=JSON.parse(e);return ae.safeParse(t).success}catch{return!1}}const oe=/\bdispatch\b/i;function forgejoErrorHint(e,t,n){let r=oe.test(n.verb),i=n.resource??`the resource`;if(e===401||e===403)return`Forgejo rejected the token. It needs the scope required for "${n.verb}" on ${i}.`;if(e===404){let e=`"${i}" was not found on the server. Verify the name${n.ref?`, that it exists on ${n.ref}`:``}, and that the token can see it.`;return r?`${e} For dispatch, also confirm the workflow has an "on: workflow_dispatch:" trigger.`:e}if(e===400||e===422){let e=`Forgejo rejected the request payload for "${n.verb}". Check for missing or invalid fields.`;return r?`${e} For dispatch, common causes are a missing "on: workflow_dispatch:" trigger or a required input not being provided.`:e}if(e>=500&&e<600){if(isForgejoGenericServerErrorBody(t)){let e=n.ref?` on ${n.ref}`:``;return`Forgejo returned a generic server error. Most often this means the requested route is unavailable${r?` (e.g. "${i}" doesn't exist${e}, or the workflow lacks an "on: workflow_dispatch:" trigger)`:``}. Less commonly: the token lacks scope, or it is a server-side bug.`}return`Forgejo server error -- usually transient. Retry; if it persists, check the server logs.`}return``}async function forgejoErrorMessage(e,t){let n=await responseBodyText(e),r=forgejoErrorHint(e.status,n,t);return`Failed to ${t.verb} on Forgejo: ${String(e.status)} ${e.statusText}`+(r?`\nHint: ${r}`:``)+(n?`\nResponse: ${n}`:``)}async function throwForgejoFailure(e,t,n){if(e.status===404)throw new ForgeAccessError(n??await forgejoErrorMessage(e,t));let r=await forgejoErrorMessage(e,t);throw e.status===401||e.status===403?new ForgeAccessError(r):e.status===422?new u(`${r}\nForgejo rejected this as invalid (422) -- retrying with the same input cannot succeed (e.g. a nonexistent label or an assignee the repository will not accept).`):e.status===410?new u(`${r}\nForgejo returned 410 Gone -- issues are likely disabled on this repository; retrying will not help.`):new d(r)}const se=g.object({state:g.string(),statuses:g.array(g.unknown())}),ce=g.object({context:g.string().nullish(),status:g.string().nullish(),description:g.string().nullish(),target_url:g.string().nullish(),updated_at:g.string().nullish(),id:g.number().nullish()}),le=/ \([^()]+\)$/;function classifyVerdict(e){return e===`success`?`good`:e===`pending`?`pending`:e===`skipped`||e===`neutral`?`skipped`:`red`}function entryKey(e,t){return typeof e.context==`string`&&e.context.length>0?e.context:`#${String(t)}`}function updatedAtMillis(e){if(!e)return 0;let t=Date.parse(e);return Number.isNaN(t)?0:t}function dedupeEntries(e){let t=/* @__PURE__ */ new Map;e.forEach((e,n)=>{let r=entryKey(e,n),i=t.get(r);if(!i){t.set(r,{entry:e,index:n});return}let a=updatedAtMillis(i.entry.updated_at),o=updatedAtMillis(e.updated_at);if(o>a)t.set(r,{entry:e,index:n});else if(o===a){let a=i.entry.id??-1/0;(e.id??-1/0)>a&&t.set(r,{entry:e,index:n})}});let n=[...t.values()];return n.sort((e,t)=>e.index-t.index),n}async function readCommitChecks(e,t,n){let r=`${t.serverUrl}/api/v1/repos/${t.repository}/commits/${n}/status`,i=await e.fetch(r,{headers:{Authorization:`token ${t.token}`}});i.ok||await throwForgejoFailure(i,{verb:`read commit status`,resource:n});let a=await i.json(),o=se.safeParse(a);if(!o.success)return{parsed:!1,state:``,green:!1,contexts:[]};let s=o.data.state===`success`&&o.data.statuses.length>0,c={context:null,status:null,description:null,target_url:null,updated_at:null,id:null},l=dedupeEntries(o.data.statuses.map(e=>{let t=ce.safeParse(e);return t.success?t.data:c})).map(({entry:e})=>{let t=e.context??``;return{context:t,name:t.replace(le,``),state:e.status??``,verdict:classifyVerdict(e.status),description:e.description??null,targetUrl:e.target_url??null,updatedAt:e.updated_at??null}});return{parsed:!0,state:o.data.state,green:s,contexts:l}}g.object({default_branch:g.string()});const ue=g.object({commit:g.object({id:g.string()})});g.object({total_commits:g.number(),commits:g.array(g.unknown())}),g.object({sha:g.string()}),g.object({sha:g.string(),created:g.string()}),g.array(g.unknown());function branchNotFoundMessage(e,t){return`Branch ${t} not found in ${e.repository}`}g.object({full_name:g.string()}),g.object({description:g.string().optional()});async function getBranchHeadSha(e,t,n){let r=`${repoBase(t)}/branches/${encodeURIComponent(n)}`,i=await e.fetch(r,{headers:authHeaders(t)});i.ok||await throwForgejoFailure(i,{verb:`read branch`,resource:n},branchNotFoundMessage(t,n));let a=ue.safeParse(await i.json());if(!a.success)throw new f(`Unexpected branch response: ${a.error.message}`);return a.data.commit.id}async function branchExists(e,t,n){let r=`${repoBase(t)}/branches/${encodeURIComponent(n)}`,i=await e.fetch(r,{headers:authHeaders(t)});return i.status!==404&&(i.ok||await throwForgejoFailure(i,{verb:`check branch`,resource:n},branchNotFoundMessage(t,n)),!0)}function defaultGitRunner(e,t,n){try{let r=x(`git`,e,{cwd:t,stdio:[`ignore`,`pipe`,`ignore`],timeout:n?.timeoutMs}).toString(`utf-8`).trim();return r===``?void 0:r}catch{return}}function resolveCurrentBranch(e){let t=e.env??process.env,n=t.GITHUB_REF;if(n!==void 0&&n!==``){if(!n.startsWith(`refs/heads/`))return;let e=t.GITHUB_REF_NAME;return e!==void 0&&e!==``?e:n.slice(11)}let r=(e.git??defaultGitRunner)([`rev-parse`,`--abbrev-ref`,`HEAD`],e.cwd);if(r!==void 0&&r!==`HEAD`)return r}function readOriginUrl(e,t=defaultGitRunner){return t([`remote`,`get-url`,`origin`],e,{timeoutMs:5e3})??null}const de=g.union([g.string(),g.object({url:g.string()})]);function readPackageRepositoryUrl(e){let t=o.join(e,`package.json`),r;try{r=n(t,`utf-8`)}catch{return null}let i;try{i=JSON.parse(r)}catch(e){throw new u(`${t} is not valid JSON: ${e instanceof Error?e.message:String(e)}`)}let a=g.object({repository:de.optional()}).safeParse(i);if(!a.success)return null;let s=a.data.repository;return s?typeof s==`string`?s:s.url:null}function resolveRepoUrl(e){return resolveRepoUrlFrom(()=>readOriginUrl(e),()=>readPackageRepositoryUrl(e))}function requireForgejoTargetFromRepo(e,t,n,r=process.env){return requireForgejoTarget(e,parseRepoTarget(t),n,r)}function requireForgejoTarget(e,t,n,r=process.env){if(t!==void 0){if(t.hostname===`github.com`)throw new u(n);let e=forgeTokenFromEnv(r);if(!e)throw new u(`bst-fj needs a forge token -- set RELEASE_TOKEN (preferred) or FORGEJO_TOKEN.`);return{serverUrl:t.serverUrl,repository:t.repository,token:e}}let i=resolveForgejoConnection(r,()=>resolveRepoUrl(e));if(i===null)throw new u(n);return i}function classifyBaseStatus(e){return e.parsed?e.contexts.length===0?`no-status`:e.green?`green`:e.contexts.some(e=>e.verdict===`pending`)?`pending`:`red`:`unparseable`}function isSettled(e){return!e.parsed||e.contexts.length===0?!1:!e.contexts.some(e=>e.verdict===`pending`)}function disagreesWithCombinedState(e){if(!e.parsed||e.contexts.length===0)return!1;let t=e.contexts.every(e=>e.verdict===`good`||e.verdict===`skipped`);return e.green!==t}function pushDisagreementNotice(e,t,n){if(!disagreesWithCombinedState(n))return;let r=`The combined status ("${n.state}") for ${t} disagrees with this build's per-check classification -- the combined status wins the verdict.`;e.includes(r)||e.push(r)}const B={parsed:!1,state:``,green:!1,contexts:[]};async function readPollChecks(e,t,n){try{let r=await readCommitChecks(e,t,n);return r.parsed?{checks:r}:{failureDetail:`The commit status response did not match the shape this build expects.`}}catch(e){return{failureDetail:p(e)}}}async function settleChecks(e,t,n,r){let{timeoutMs:i,intervalMs:a,sleep:o,now:s}=n,c=s(),elapsed=()=>s()-c,l=0,u,d,f=null;for(;;){let n=r.sha(),{checks:s,failureDetail:c}=await readPollChecks(e,t,n);if(c!==void 0&&(u=c),s===void 0){if(l+=1,l>=3)return r.report(B,{exit:`retry-budget`,elapsed,failureDetail:u})}else if(l=0,d=s,r.observe?.(s),pushDisagreementNotice(r.notices,n,s),isSettled(s)){let e=new Set(s.contexts.map(e=>e.context));if(f!==null&&f.size===e.size&&[...f].every(t=>e.has(t)))return r.report(s,{exit:`settled`,elapsed});f=e}else f=null;if(elapsed()>=i)return r.report(d??B,{exit:`timeout`,elapsed});if(await o(a),r.afterSleep!==void 0){let e=await r.afterSleep(n,elapsed);if(e!==`retry`&&e!==`next`)return e.done}}}function renderCheckLine(e){let t=[e.state,e.context];e.description!==null&&t.push(e.description);let n=t.join(` -- `);return e.verdict===`red`&&e.targetUrl!==null&&(n+=` (${e.targetUrl})`),n}function envMsOverride(e,t){if(e===void 0)return t;let n=Number(e.trim());return!Number.isSafeInteger(n)||n<=0?t:Math.min(n,t)}function resolvePollTimings(e){let t=e.timeout===void 0?12e5:parseDuration(e.timeout,`--timeout`),n=e.interval===void 0?15e3:parseDuration(e.interval,`--interval`);return{timeoutMs:t,intervalMs:envMsOverride(process.env.BST_TEST_CHECK_POLL_INTERVAL_MS,Math.max(n,5e3))}}function sleep(e){return new Promise(t=>{setTimeout(t,e)})}async function resolveCommitStatusTarget(e,t){let n=parseRepoTarget(t.repo),r=requireForgejoTarget(t.cwd,n,"commit:status is Forgejo-only: GitHub Actions publishes check runs, not commit statuses. Use `gh run list` / `gh run view` instead."),i=t.ref!==void 0&&t.ref.trim()!==``?t.ref.trim():`HEAD`,a=i;if(!V.test(i)){if(n===void 0){let n=t.git??defaultGitRunner,o=i===`HEAD`?void 0:n([`rev-parse`,`--symbolic-full-name`,i],t.cwd);if(o!==void 0&&o.startsWith(`refs/heads/`))a=await forgeBranchHeadSha(e,r,i)??i;else{let o=n([`rev-parse`,`${i}^{commit}`],t.cwd);a=o!==void 0&&o.length===40?o:await forgeBranchHeadSha(e,r,i)??i}}else a=await forgeBranchHeadSha(e,r,i)??i}let o=V.test(a)?`commit`:`commits`,s=`${r.serverUrl}/${r.repository}/${o}/${a}`;return{conn:r,ref:i,sha:a,url:s}}const V=/^[0-9a-f]{40}$/;async function forgeBranchHeadSha(e,t,n){try{return await getBranchHeadSha(e,t,n)}catch(e){if(e instanceof ForgeAccessError)return;throw e}}function buildReport$1(e,t,n,r={}){let{notices:i,waited:a,elapsedMs:o}=n,s=r.statusOverride??classifyBaseStatus(t),c={sha:e.sha,ref:e.ref,repository:e.conn.repository,url:e.url,status:s,settled:isSettled(t),combinedState:t.state,waited:a,elapsedMs:o,checks:t.contexts.map(e=>({...e})),notices:i};return r.detailOverride===void 0?s===`unparseable`&&(c.detail=`The commit status response did not match the shape this build expects.`):c.detail=r.detailOverride,c}async function waitForSettledChecks$1(e,t,n,r){return settleChecks(e,t.conn,r,{sha:()=>t.sha,notices:n,report:(e,r)=>{let i={};return r.exit===`timeout`?i.statusOverride=`timeout`:r.exit===`retry-budget`&&(i.statusOverride=`unparseable`,r.failureDetail!==void 0&&(i.detailOverride=r.failureDetail)),buildReport$1(t,e,{notices:n,waited:!0,elapsedMs:r.elapsed()},i)}})}async function runCommitStatus(e,t){let n=t.wait===!0?resolvePollTimings(t):void 0,r=await resolveCommitStatusTarget(e,t),i=[];if(n!==void 0)return waitForSettledChecks$1(e,r,i,{...n,sleep:t.sleep??sleep,now:t.now??Date.now});let a=await readCommitChecks(e,r.conn,r.sha);return pushDisagreementNotice(i,r.sha,a),buildReport$1(r,a,{notices:i,waited:!1,elapsedMs:0})}function renderCommitStatus(e){let t=e.checks.map(renderCheckLine),n=V.test(e.sha)?e.sha.slice(0,12):e.sha,r=e.checks.filter(e=>e.verdict===`red`).length,i=e.checks.filter(e=>e.verdict===`pending`).length,a=e.checks.filter(e=>e.verdict===`good`).length,o=e.checks.filter(e=>e.verdict===`skipped`).length,s=[`commit ${n}: ${e.status}`,`${String(r)} red, ${String(i)} pending, ${String(a)} good, ${String(o)} skipped`,e.url];return t.push(s.join(` -- `)),t.join(`
|
|
5
|
-
`)}const
|
|
6
|
-
`);return t.trim()===``?r:`${t}\n\n${r}`}function parseIssueList(e){let t=/* @__PURE__ */ new Set;for(let n of e.split(`,`)){let r=/^#?([1-9]\d*)$/.exec(n.trim());if(r?.[1]===void 0)throw new u(`--closes takes issue numbers separated by commas, such as 12 or 12,15; got ${JSON.stringify(e)}.`);t.add(Number(r[1]))}return[...t]}function morePagesFollow(e,t,n,r){if(t===0)return!1;let i=e.headers.get(`x-total-count`)?.trim()??``,a=i===``?NaN:Number(i);return!Number.isSafeInteger(a)||a<0?t>=r:n<a}const U=g.object({id:g.number(),name:g.string(),color:g.string().optional(),description:g.string().optional(),exclusive:g.boolean().optional()}),pe=g.array(U);async function fetchAllForgejoLabels(e,t){let n=[];for(let r=1;r<=20;r++){let i=await e.fetch(`${t.serverUrl}/api/v1/repos/${t.repository}/labels?limit=50&page=${String(r)}`,{headers:authHeaders(t)});i.ok||await throwForgejoFailure(i,{verb:`list labels`,resource:t.repository},repoNotFoundMessage(t));let a=pe.safeParse(await i.json());if(!a.success)throw new f(`Unexpected label-list response: ${a.error.message}`);if(n.push(...a.data),!morePagesFollow(i,a.data.length,n.length,50))break}return n}async function resolveLabelIds(e,t,n){if(n.length===0)return[];let r=await fetchAllForgejoLabels(e,t);return n.map(e=>{let n=r.find(t=>t.name===e);if(n===void 0){let n=r.map(e=>e.name).join(`, `);throw new u(`No label named "${e}" found among the repository's labels in ${t.repository} (organization-level labels are not searched). Known labels: ${n}`)}return n.id})}function isRetiringExpired(e,t){return t>e.until}function retiringAsLabelSpec(e){return{name:e.name,color:e.color,description:e.description,exclusive:!1}}const me=g.strictObject({name:g.string().min(1),color:g.string().regex(/^#[0-9a-fA-F]{6}$/),description:g.string(),exclusive:g.boolean().optional()}),he=g.record(g.string(),g.array(me));function normalizeColor(e){return e.replace(/^#/,``).toLowerCase()}function hasCosmeticDrift(e,t){return normalizeColor(e.color??``)!==normalizeColor(t.color)||(e.description??``)!==t.description}function isNonExclusive(e,t){return(t.exclusive??!1)&&!(e.exclusive??!1)}function isExclusivityDrifted(e,t){return(e.exclusive??!1)!==(t.exclusive??!1)}async function auditForgejoLabels(e,t,n){let r=await fetchAllForgejoLabels(e,t),i=new Map(r.map(e=>[e.name,e])),a=new Map(r.map(e=>[e.name,e.id])),o=[],s=[],c=[],l=[];for(let e of n){let t=i.get(e.name);t===void 0?o.push(e.name):(isNonExclusive(t,e)&&s.push(e.name),isExclusivityDrifted(t,e)&&c.push(e.name),hasCosmeticDrift(t,e)&&l.push(e.name))}return{labelIds:a,missing:o,nonExclusive:s,exclusivityDrift:c,cosmeticDrift:l}}function labelScope(e){let t=e.indexOf(`/`);return t===-1?null:e.slice(0,t+1)}function staleLabelNames(e,t,n=[]){let r=/* @__PURE__ */ new Set;for(let t of e){let e=labelScope(t.name);e!==null&&r.add(e)}let i=new Set(e.map(e=>e.name));for(let e of n)i.add(e.name);let a=[];for(let e of t){if(i.has(e))continue;let t=labelScope(e);t!==null&&r.has(t)&&a.push(e)}return a.sort((e,t)=>e.localeCompare(t)),a}async function ensureForgejoLabels(e,t,n){let r=await auditForgejoLabels(e,t,n),i=new Map(r.labelIds),a=new Set(r.missing),o=/* @__PURE__ */ new Set([...r.exclusivityDrift,...r.cosmeticDrift]),s=`${t.serverUrl}/api/v1/repos/${t.repository}/labels`;for(let r of n)if(a.has(r.name)){let n=await e.fetch(s,{method:`POST`,headers:jsonHeaders(t),body:JSON.stringify({name:r.name,color:r.color,description:r.description,exclusive:r.exclusive??!1})});n.ok||await throwForgejoFailure(n,{verb:`create label`,resource:r.name},repoNotFoundMessage(t));let a=U.safeParse(await n.json());if(!a.success)throw new f(`Unexpected label-create response: ${a.error.message}`);i.set(r.name,a.data.id)}else if(o.has(r.name)){let n=i.get(r.name);if(n===void 0)throw new f(`Audit reported drift for "${r.name}" with no known id`);let a=await e.fetch(`${s}/${String(n)}`,{method:`PATCH`,headers:jsonHeaders(t),body:JSON.stringify({name:r.name,color:r.color,description:r.description,exclusive:r.exclusive??!1})});a.ok||await throwForgejoFailure(a,{verb:`update label`,resource:r.name},repoNotFoundMessage(t))}return i}async function deleteForgejoLabel(e,t,n){let r=await e.fetch(`${t.serverUrl}/api/v1/repos/${t.repository}/labels/${String(n)}`,{method:`DELETE`,headers:authHeaders(t)},{idempotent:!0});r.ok||await throwForgejoFailure(r,{verb:`delete label`,resource:String(n)},repoNotFoundMessage(t))}const W=g.object({number:g.number(),title:g.string(),state:g.string(),html_url:g.string(),body:g.string().nullish(),user:g.object({login:g.string()}).nullish(),labels:g.array(g.object({name:g.string()})).nullish(),assignees:g.array(g.object({login:g.string()})).nullish(),created_at:g.string(),updated_at:g.string(),closed_at:g.string().nullish(),pull_request:g.unknown().nullish(),assets:g.array(z).nullish()}),ge=g.array(W);function parseIssueOrThrow(e){let t=W.safeParse(e);if(!t.success)throw new f(`Unexpected issue response: ${t.error.message}`);return t.data}function parseIssueListOrThrow(e){let t=ge.safeParse(e);if(!t.success)throw new f(`Unexpected issue-list response: ${t.error.message}`);return t.data}function normalizeIssue(e){return{number:e.number,title:e.title,state:e.state,url:e.html_url,author:e.user?.login??``,labels:(e.labels??[]).map(e=>e.name),createdAt:e.created_at,updatedAt:e.updated_at,closedAt:e.closed_at??null,body:e.body??``,isPullRequest:e.pull_request!==null&&e.pull_request!==void 0,attachments:(e.assets??[]).map(normalizeAttachment),assignees:(e.assignees??[]).map(e=>e.login)}}async function getForgejoIssue(e,t,n){let r=await e.fetch(`${issuesBase(t)}/${String(n)}`,{headers:authHeaders(t)});return r.ok||await throwForgejoFailure(r,{verb:`get issue`,resource:`#${String(n)}`},issueNotFoundMessage(t,n)),normalizeIssue(parseIssueOrThrow(await r.json()))}const _e=g.object({number:g.number(),state:g.string(),repository:g.object({full_name:g.string()}).nullish()});g.array(_e);function issueListParams(e,t){let n=t.type??e,r=new URLSearchParams(n===`all`?{}:{type:n});return r.set(`state`,t.state),r.set(`limit`,String(t.limit)),t.label!==void 0&&r.set(`labels`,t.label),t.page!==void 0&&r.set(`page`,String(t.page)),t.since!==void 0&&r.set(`since`,t.since),t.sort!==void 0&&r.set(`sort`,t.sort),t.q!==void 0&&r.set(`q`,t.q),r}async function fetchIssueListPage(e,t,n){let r=await e.fetch(`${issuesBase(t)}?${n.toString()}`,{headers:authHeaders(t)});return r.ok||await throwForgejoFailure(r,{verb:`list issues`,resource:t.repository},repoNotFoundMessage(t)),{raw:parseIssueListOrThrow(await r.json()),res:r}}function normalizeDetailedIssues(e,t){let n=e.map(normalizeIssue);return t===`issues`?n.filter(e=>!e.isPullRequest):n}async function listForgejoIssuesDetailedPaged(e,t,n,r){let i=[];for(let a=1;a<=20;a++){let{raw:o}=await fetchIssueListPage(e,t,issueListParams(n.type,{...n,limit:50,page:a}));if(i.push(...normalizeDetailedIssues(o,n.type)),o.length===0||i.length>=n.limit)break;a===20&&(L.warn(`Detailed issue listing on ${t.repository} hit the 20-page cap without an empty page; results may be truncated`),r?.onPageCap?.())}return i}async function listOpenObjectsWithLabel(e,t,n){let r=[];for(let i=1;i<=20;i++){let{raw:a}=await fetchIssueListPage(e,t,issueListParams(`all`,{state:`open`,label:n,limit:50,page:i}));for(let e of a.map(normalizeIssue))e.labels.includes(n)&&r.push({number:e.number,kind:e.isPullRequest?`pull`:`issue`,title:e.title,url:e.url});if(a.length===0)break;i===20&&L.warn(`Open-object listing on ${t.repository} hit the 20-page cap without an empty page; results may be truncated`)}return r}const ve=g.object({full_name:g.string(),default_branch:g.string().nullish(),archived:g.boolean().nullish(),permissions:g.object({push:g.boolean().optional(),admin:g.boolean().optional()}).nullish()}),ye=g.array(ve);async function fetchAccessibleRepos(e,t,n){let r={Authorization:`token ${n}`},i=[];for(let n=1;n<=20;n++){let a=new URLSearchParams({limit:`50`,page:String(n)}),o=await e.fetch(`${t}/api/v1/user/repos?${a.toString()}`,{headers:r});o.ok||await throwForgejoFailure(o,{verb:`list repositories`,resource:t},`Repository listing failed on ${t} (or the token cannot see any repositories)`);let s=ye.safeParse(await o.json());if(!s.success)throw new f(`Unexpected user-repos response: ${s.error.message}`);for(let e of s.data)i.push({fullName:e.full_name,canWrite:e.permissions?.push===!0||e.permissions?.admin===!0,defaultBranch:e.default_branch??null,archived:e.archived===!0});if(s.data.length===0)break;n===20&&L.warn(`Repository listing on ${t} hit the 20-page cap without an empty page; results may be truncated`)}return i}async function createForgejoIssue(e,t,n){let r=[],i=[];for(let e of n.labels){let t=n.labelIds?.get(e);t===void 0?i.push(e):r.push(t)}i.length>0&&r.push(...await resolveLabelIds(e,t,i));let a={title:n.title,body:n.body,...r.length>0?{labels:r}:{},...n.assignees!==void 0&&n.assignees.length>0?{assignees:n.assignees}:{}},o=await e.fetch(issuesBase(t),{method:`POST`,headers:jsonHeaders(t),body:JSON.stringify(a)});return o.ok||await throwForgejoFailure(o,{verb:`create issue`,resource:n.title},repoNotFoundMessage(t)),normalizeIssue(parseIssueOrThrow(await o.json()))}async function updateForgejoIssue(e,t,n,r){let i=await e.fetch(`${issuesBase(t)}/${String(n)}`,{method:`PATCH`,headers:jsonHeaders(t),body:JSON.stringify({title:r.title,body:r.body})},{idempotent:!0});return i.ok||await throwForgejoFailure(i,{verb:`update issue`,resource:`#${String(n)}`},issueNotFoundMessage(t,n)),normalizeIssue(parseIssueOrThrow(await i.json()))}async function setForgejoIssueState(e,t,n,r){let i=await e.fetch(`${issuesBase(t)}/${String(n)}`,{method:`PATCH`,headers:jsonHeaders(t),body:JSON.stringify({state:r})},{idempotent:!0});return i.ok||await throwForgejoFailure(i,{verb:r===`closed`?`close issue`:`reopen issue`,resource:`#${String(n)}`},issueNotFoundMessage(t,n)),normalizeIssue(parseIssueOrThrow(await i.json()))}function resolveSyncMode(e,t){return e?`check`:t?`dry-run`:`apply`}function targetConnection(e,t){return t===void 0?e:{...e,repository:t}}async function resolveFleetTargets(e,t){return(await fetchAccessibleRepos(e,t.serverUrl,t.token)).filter(e=>e.canWrite).map(e=>targetConnection(t,e.fullName))}function outcomeFromAudit(e,t,n,r){let i=new Set(n.missing),a=/* @__PURE__ */ new Set([...n.exclusivityDrift,...n.cosmeticDrift]),o=t.map(e=>e.name).filter(e=>!i.has(e)&&!a.has(e));return{repository:e.repository,created:n.missing,updated:[...a],unchanged:o,...r}}async function checkPruneCandidate(e,t,n){let r;try{r=await listOpenObjectsWithLabel(e,t,n)}catch(e){return{ok:!1,reason:`could not check open objects: ${p(e)}`,objects:[]}}return r.length===0?{ok:!0}:{ok:!1,reason:`on ${String(r.length)} open object(s)`,objects:r}}async function syncOneRepo(e){let{fetcher:t,conn:n,specs:r,mode:i,prune:a,allowedPruneNames:o,resolveTargetSpecs:s,retiring:c,today:l}=e,u=s===void 0?{specs:r,omitted:[],aliasNames:[]}:await s(n,r),d=new Set(c.map(e=>e.name)),p=await auditForgejoLabels(t,n,[...u.specs,...c.map(retiringAsLabelSpec)]),m=c.filter(e=>p.labelIds.has(e.name)),h={...p,missing:p.missing.filter(e=>!d.has(e))},g=staleLabelNames(r,h.labelIds.keys(),c).filter(e=>!u.aliasNames.includes(e)),_=m.filter(e=>isRetiringExpired(e,l)).map(e=>e.name),v=a?[...u.omitted,...g,..._].filter(e=>h.labelIds.has(e)&&(o===void 0||o.includes(e))):[],y=[],b=[];for(let e of v){let r=await checkPruneCandidate(t,n,e);r.ok?y.push(e):b.push({name:e,reason:r.reason,objects:r.objects})}let x=[];for(let e of m)x.push({name:e.name,replacement:e.replacement,until:e.until,expired:isRetiringExpired(e,l),openObjects:await listOpenObjectsWithLabel(t,n,e.name)});let S=outcomeFromAudit(n,u.specs,h,{omitted:u.omitted,pruned:y,stale:a?g.filter(e=>!v.includes(e)):g,retiring:x,refused:b});if(i===`apply`){(S.created.length>0||S.updated.length>0)&&await ensureForgejoLabels(t,n,[...u.specs,...m.map(retiringAsLabelSpec)]);for(let e of y){let r=h.labelIds.get(e);if(r===void 0)throw new f(`Prune candidate "${e}" had no known id after the audit`);await deleteForgejoLabel(t,n,r)}}return S}async function syncLabelSet(e){let{fetcher:t,targets:n,specs:r,setName:i,mode:a,contained:o,prune:s,pruneAllowlist:c}=e,l=e.retiring??[],u=e.today??``;if(l.length>0&&e.today===void 0)throw new f("syncLabelSet was given retiring label specs but no `today` to compare their expiry against: an expired entry is a prune candidate, and a guessed date could delete a name whose retirement window is still open.");let d=[...r],m=[],h=[];for(let r of n){let n=c?.get(r.repository),i={fetcher:t,conn:r,specs:d,mode:a,prune:s===!0,allowedPruneNames:n,resolveTargetSpecs:e.resolveTargetSpecs,retiring:l,today:u};if(o!==!0)m.push(await syncOneRepo(i));else try{m.push(await syncOneRepo(i))}catch(e){h.push({repository:r.repository,error:p(e)})}}return{set:i,mode:a,repos:m,failures:h,drifted:m.some(e=>e.created.length>0||e.updated.length>0||e.pruned.length>0)}}function syncSummaryLines(e){let t=e.mode===`apply`?``:`would `,n=[];for(let r of e.repos){let e=[];r.created.length>0&&e.push(`${t}create: ${r.created.join(`, `)}`),r.updated.length>0&&e.push(`${t}update: ${r.updated.join(`, `)}`),r.omitted.length>0&&e.push(`omitted (repo declares its own priority vocabulary): ${r.omitted.join(`, `)}`),r.pruned.length>0&&e.push(`${t}prune: ${r.pruned.join(`, `)}`),r.stale.length>0&&e.push(`stale (present, not in this set): ${r.stale.join(`, `)}`);for(let t of r.refused){let n=t.objects.map(e=>`#${String(e.number)} (${e.kind}) ${e.title}`).join(`, `);e.push(`refused to prune ${t.name}: ${t.reason}${n===``?``:` (${n})`}`)}for(let t of r.retiring)e.push(`retiring ${t.name}: replaced by ${t.replacement}, prunable after ${t.until}${t.expired?` (expired)`:``}; ${String(t.openObjects.length)} open object(s)`);e.length===0?n.push(`${r.repository}: up to date (${String(r.unchanged.length)} unchanged)`):n.push(`${r.repository}: ${e.join(`; `)}`)}return{repoLines:n,failureLines:e.failures.map(e=>`${e.repository}: failed: ${e.error}`)}}function readLabelSet(e,t){let r;try{r=n(e,`utf-8`)}catch(t){throw new u(`Cannot read label-sets file ${e}: ${p(t)}`)}let i;try{i=JSON.parse(r)}catch(t){throw new u(`Label-sets file ${e} is not valid JSON: ${p(t)}`)}let a=he.safeParse(i);if(!a.success){let t=a.error.issues[0],n=t===void 0||t.path.length===0?`(root)`:t.path.join(`.`);throw new u(`Label-sets file ${e} is invalid at ${n}: ${t?.message??`unknown error`}`)}let o=a.data[t];if(o===void 0){let n=Object.keys(a.data).toSorted().join(`, `)||`(none)`;throw new u(`Unknown label set "${t}" in ${e}. Known sets: ${n}`)}return o}async function runLabelsList(e,t){let n=await fetchAllForgejoLabels(e,t);return{repository:t.repository,labels:n}}function renderList(e){if(e.labels.length===0)M.info(`No labels found in ${e.repository}`);else for(let t of e.labels.toSorted((e,t)=>e.name.localeCompare(t.name))){let e=t.exclusive===!0?` [exclusive]`:``;M.info(`${t.name}${e} #${t.color??``} ${t.description??``}`)}}async function runLabelsSync(e){let{fetcher:t,targets:n,specs:r,setName:i,mode:a,contained:o}=e;return syncLabelSet({fetcher:t,targets:n,specs:r,setName:i,mode:a,contained:o})}function renderSync(e){let{repoLines:t,failureLines:n}=syncSummaryLines(e);for(let e of t)M.info(e);for(let e of n)M.warn(e)}const G=`bst-fj labels requires a Forgejo repository`,be=_({meta:{name:`list`,description:`List a repository's existing labels`},args:{repo:{type:`string`,description:`Target owner/repo (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: repository, labels ([{id, name, color?, description?, exclusive?}]).`}},async run({args:e,rawArgs:t}){let n=requireForgejoTarget(process.cwd(),void 0,G),r=parseListFlag(t,`repo`);if(r.length===0&&listFlagPresent(t,`repo`))throw new u(`--repo was given with no repository name (expected e.g. owner/repo). Refusing rather than falling back to the current repo.`);let i=targetConnection(n,r.at(-1)),a=await runLabelsList(cliFetcher(),i);e.json===!0?createCliOutput(!0).json(a):renderList(a)}}),xe=_({meta:{name:`sync`,description:`Create/update a repo's labels from a named set in a label-sets file (never deletes a label)`},args:{file:{type:`string`,required:!0,description:`JSON file mapping each set name to an array of label specs. A spec is { "name", "color" ("#rrggbb"), "description", "exclusive"? (boolean) } and takes no other field`},set:{type:`string`,required:!0,description:`Label set name, a key of --file`},repo:{type:`string`,description:`Target owner/repo. Repeatable (unions); default: this repo`},fleet:{type:`boolean`,description:`Target every repo the token can write to, discovered live. Mutually exclusive with --repo`},check:{type:`boolean`,description:`Report drift without writing; exits 1 if any label is missing or drifted. A stale label (left on the repo but gone from the set) is reported and never counted as drift`},"dry-run":{type:`boolean`,description:`Report what would change without writing`},json:{type:`boolean`,description:`Emit one JSON document: set, mode (apply | check | dry-run), repos ([{repository, created, updated, unchanged, omitted, stale, retiring, refused}], every field but repository and those two a list of label names; retiring and refused are always empty here, since this command never prunes), failures ([{repository, error}]; always present, filled only under --fleet), drifted. drifted is true when any label is missing or drifted, and sets the exit code only under --check.`}},async run({args:e,rawArgs:t}){let n=requireForgejoTarget(process.cwd(),void 0,G),r=parseListFlag(t,`repo`);if(r.length===0&&listFlagPresent(t,`repo`))throw new u(`--repo was given with no repository name (expected e.g. owner/repo). Refusing rather than falling back to the current repo.`);let i=e.fleet===!0;if(i&&r.length>0)throw new u(`--repo and --fleet are mutually exclusive`);let a=readLabelSet(e.file,e.set),o=cliFetcher(),s;s=i?await resolveFleetTargets(o,n):r.length>0?r.map(e=>targetConnection(n,e)):[n];let c=resolveSyncMode(e.check===!0,e[`dry-run`]===!0),l=await runLabelsSync({fetcher:o,targets:s,specs:a,setName:e.set,mode:c,contained:i});e.json===!0?createCliOutput(!0).json(l):renderSync(l),(c===`check`&&l.drifted||l.failures.length>0)&&(process.exitCode=1)}}),Se=_({meta:{name:`labels`,description:`Provision and audit a repository's label definitions from a named label set (sync, list)`},args:{json:{type:`boolean`,description:`Emit one JSON document; the keys are the subcommand's (see labels list --help and labels sync --help).`}},subCommands:{list:be,sync:xe}}),Ce=g.object({id:g.number(),tag_name:g.string().optional(),created_at:g.string().optional(),published_at:g.string().optional(),html_url:g.string().nullish(),prerelease:g.boolean().optional()});function isEpochReleaseDate(e){if(!e)return!0;let t=new Date(e).getTime();return Number.isNaN(t)||t<=0}async function getReleaseByTag(e,t,n){let r=encodeURIComponent(n),i=`${t.serverUrl}/api/v1/repos/${t.repository}/releases/tags/${r}`,a=await e.fetch(i,{headers:{Authorization:`token ${t.token}`}});if(a.status===404)return null;if(!a.ok)throw new d(await forgejoErrorMessage(a,{verb:`check release`,resource:n}));let o=Ce.safeParse(await a.json());if(!o.success)throw new f(`Unexpected release response: ${o.error.message}`);return o.data}async function createRelease(e,t,n,r={}){let i=`${t.serverUrl}/api/v1/repos/${t.repository}/releases`,a={tag_name:n,name:r.name??n,body:r.body??`Published ${n}`,prerelease:r.prerelease??!1};r.target&&(a.target_commitish=r.target);let o=await e.fetch(i,{method:`POST`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify(a)});if(!o.ok)throw new d(await forgejoErrorMessage(o,{verb:`create release`,resource:n}))}async function deleteTag(e,t,n){let r=encodeURIComponent(n),i=`${t.serverUrl}/api/v1/repos/${t.repository}/tags/${r}`,a=await e.fetch(i,{method:`DELETE`,headers:{Authorization:`token ${t.token}`}});if(!a.ok&&a.status!==404)throw new d(await forgejoErrorMessage(a,{verb:`delete tag`,resource:n}))}const we=g.looseObject({name:g.string(),id:g.string(),commit:g.object({sha:g.string().regex(/^[0-9a-f]{40}$/)})});async function getTagCommit(e,t,n){let r=encodeURIComponent(n),i=`${t.serverUrl}/api/v1/repos/${t.repository}/tags/${r}`,a=await e.fetch(i,{headers:{Authorization:`token ${t.token}`}});if(a.status===404)return null;if(!a.ok)throw new d(await forgejoErrorMessage(a,{verb:`read tag`,resource:n}));let o=we.safeParse(await a.json());if(!o.success)throw new f(`Unexpected tag response: ${o.error.message}`);return o.data.commit.sha}async function deleteRelease(e,t,n){let r=`${t.serverUrl}/api/v1/repos/${t.repository}/releases/${String(n)}`,i=await e.fetch(r,{method:`DELETE`,headers:{Authorization:`token ${t.token}`}});if(!i.ok&&i.status!==404)throw new d(await forgejoErrorMessage(i,{verb:`delete release`,resource:String(n)}))}async function markReleasePrerelease(e,t,n,r){let i=`${t.serverUrl}/api/v1/repos/${t.repository}/releases/${String(n)}`,a=await e.fetch(i,{method:`PATCH`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify({prerelease:!0})},{idempotent:!0});if(!a.ok)throw new d(await forgejoErrorMessage(a,{verb:`edit release`,resource:r}))}async function ensureRelease(e,t,n,r={}){let i=r.attempts??4,a=r.baseDelayMs??2e3,o=await getReleaseByTag(e,t,n);if(o&&!isEpochReleaseDate(o.created_at))return r.prerelease===!0&&o.prerelease===!1&&await markReleasePrerelease(e,t,o.id,n),{status:`exists`,release:releaseRef(o)};let s=o,c=!1;for(let o=1;o<=i;o++){s&&isEpochReleaseDate(s.created_at)&&(await deleteRelease(e,t,s.id),s=null,c=!0,await settleBackoff(o,a));try{await createRelease(e,t,n,{target:r.target,prerelease:r.prerelease,name:r.name,body:r.body})}catch(r){let c=await getReleaseByTag(e,t,n);if(c&&!isEpochReleaseDate(c.created_at))return{status:`race`,release:releaseRef(c)};if(s=c,o>=i)break;L.warn(`Release creation attempt ${String(o)}/${String(i)} failed: ${p(r)}`),await settleBackoff(o,a);continue}if(s=await getReleaseByTag(e,t,n),s&&!isEpochReleaseDate(s.created_at))return{status:c?`repaired`:`created`,release:releaseRef(s)};o<i&&L.warn(`Release for ${n} came back epoch-dated (attempt ${String(o)}/${String(i)}) -- waiting for Forgejo to settle the tag's date before retrying`)}let l=r.target?await recreateTagViaApi(e,t,n,{target:r.target,prerelease:r.prerelease,name:r.name,body:r.body,current:s,attempts:i,baseDelayMs:a}):null;if(l)return{status:`repaired`,release:releaseRef(l)};throw new d(`Release for ${n} never got a real (non-epoch) created date after ${String(i)} attempts. This is an intermittent Forgejo bug: a pushed tag's date settles asynchronously and a racing release creation freezes it at the Unix epoch (1969/1970). `+(r.target?`Recreating the tag via the API did not help -- investigate the server or upgrade Forgejo.`:`Pass the release tag's target commit so the tag can be recreated, or retry the release.`))}async function recreateTagViaApi(e,t,n,r){let{target:i,prerelease:a,name:o,body:s,current:c,attempts:l,baseDelayMs:u}=r;L.warn(`Release for ${n} stayed epoch-dated -- recreating the tag via the API so Forgejo stamps a real date (the tag becomes lightweight)`),c&&await deleteRelease(e,t,c.id),await deleteTag(e,t,n);for(let r=1;r<=l;r++){try{await createRelease(e,t,n,{target:i,prerelease:a,name:o,body:s})}catch(e){if(r>=l)throw new d(`Release for ${n} was deleted to repair its epoch date, but recreating it from ${i} failed: ${p(e)}. The tag no longer exists on the server -- re-push it (or re-run the release) to restore it.`);await settleBackoff(r,u);continue}let c=await getReleaseByTag(e,t,n);return c&&!isEpochReleaseDate(c.created_at)?c:null}return null}function releaseRef(e){return{id:e.id,url:e.html_url??null}}async function settleBackoff(e,t){if(t<=0)return;let n=Math.min(t*2**(e-1),16e3);await new Promise(e=>setTimeout(e,n))}const Te=g.object({id:g.number(),name:g.string()});g.object({id:g.number(),assets:g.array(Te).nullish()}),g.object({id:g.number()}),g.looseObject({id:g.number(),tag_name:g.string(),name:g.string().nullish(),target_commitish:g.string().nullish(),created_at:g.string().nullish(),html_url:g.string().nullish(),draft:g.boolean().optional(),prerelease:g.boolean().optional(),assets:g.array(g.unknown()).nullish()}),g.looseObject({name:g.string(),commit:g.looseObject({sha:g.string(),created:g.string().nullish()})});const Ee=_({meta:{name:`release:create`,description:`Create a Forgejo release for a tag the forge already has, or with --target, for a new tag created at that commit`},args:{tag:{type:`string`,description:`Git tag to create a release for`,required:!0},prerelease:{type:`boolean`,description:`Flag the release as a prerelease, so the forge's Latest pointer skips it`,default:!1},target:{type:`string`,description:`Commit SHA the tag points at (default: read from the forge's tags API). A tag the forge lacks is created at this commit; the epoch-date repair recreates the tag from it.`},json:{type:`boolean`,description:`Emit one JSON document: status (created | exists | race | repaired), tag, target, prerelease, release ({id, url (or null)}).`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=requireForgejoTarget(process.cwd(),void 0,`bst-fj release:create requires a Forgejo repository`);if(e.target!==void 0&&e.target.trim()===``)throw new u(`--target needs a commit SHA; it was given an empty value.`);let r=cliFetcher(),i=e.prerelease===!0,a=e.target??await getTagCommit(r,n,e.tag);if(a===null)throw new u(`Tag ${e.tag} does not exist on ${n.repository}. Push the tag first, or pass --target <sha> naming the commit it points at.`);let o=await ensureRelease(r,n,e.tag,{target:a,prerelease:i});t.json({status:o.status,tag:e.tag,target:a,prerelease:i,release:o.release}),o.status===`exists`?M.info(`Release for ${e.tag} already exists -- skipping`):M.info(`Created Forgejo release for ${e.tag}`)}}),De=g.array(g.object({name:g.string()}));g.object({sha1:g.string()});const Oe=/^[A-Za-z_][A-Za-z0-9_]*$/,ke=/^(FORGEJO_|GITEA_|GITHUB_|[0-9])/i;function isValidSecretName(e){return Oe.test(e)&&!ke.test(e)}async function setActionSecret(e,t,n,r){let[i,a]=t.repository.split(`/`),o=`${t.serverUrl}/api/v1/repos/${i}/${a}/actions/secrets/${encodeURIComponent(n)}`,s=await e.fetch(o,{method:`PUT`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify({data:r})});if(!s.ok)throw new d(await forgejoErrorMessage(s,{verb:`set secret`,resource:n}))}async function listActionSecrets(e,t){let[n,r]=t.repository.split(`/`),i=[];for(let a=1;a<=21;a++){let o=`${t.serverUrl}/api/v1/repos/${n}/${r}/actions/secrets?page=${String(a)}&limit=50`,s=await e.fetch(o,{headers:{Authorization:`token ${t.token}`}});if(!s.ok)throw new d(await forgejoErrorMessage(s,{verb:`list secrets`,resource:`${n}/${r}`}));let c=De.safeParse(await s.json());if(!c.success)throw new f(`Unexpected secrets list response: ${c.error.message}`);for(let e of c.data)i.push(e.name);if(c.data.length===0)break;if(a===21)throw new f(`${n}/${r} still lists secrets after 20 pages; refusing to report a prefix of them`)}return i}async function deleteActionSecret(e,t,n){let[r,i]=t.repository.split(`/`),a=`${t.serverUrl}/api/v1/repos/${r}/${i}/actions/secrets/${encodeURIComponent(n)}`,o=await e.fetch(a,{method:`DELETE`,headers:{Authorization:`token ${t.token}`}});if(!o.ok)throw new d(await forgejoErrorMessage(o,{verb:`delete secret`,resource:n}))}async function runSecretsSet(e,t){if(!isValidSecretName(t.secretName))throw new u(`Invalid secret name "${t.secretName}". A name must match [A-Za-z_][A-Za-z0-9_]* and must not start with FORGEJO_, GITEA_, GITHUB_, or a digit.`);return t.dryRun?(M.info(`[dry-run] Would set secret ${t.secretName} on ${t.conn.repository}`),{status:`would-set`,name:t.secretName,repository:t.conn.repository}):(await setActionSecret(e,t.conn,t.secretName,t.secretValue),M.success(`Set secret ${t.secretName}`),{status:`set`,name:t.secretName,repository:t.conn.repository})}async function runSecretsList(e,t){let n=await listActionSecrets(e,t.conn);if(n.length===0)M.info(`No secrets found`);else for(let e of n)M.info(e);return n}async function runSecretsDelete(e,t){return t.dryRun?(M.info(`[dry-run] Would delete secret ${t.secretName} from ${t.conn.repository}`),{status:`would-delete`,name:t.secretName,repository:t.conn.repository}):(await deleteActionSecret(e,t.conn,t.secretName),M.success(`Deleted secret ${t.secretName}`),{status:`deleted`,name:t.secretName,repository:t.conn.repository})}function readSecretValue(e){if(e)return e;try{let e=n(`/dev/stdin`,`utf-8`).trim();if(e.length===0)throw new u(`No secret value provided. Use --body or pipe a value via stdin.`);return e}catch(e){throw e instanceof u?e:new u(`No secret value provided. Use --body or pipe a value via stdin.`)}}const Ae=_({meta:{name:`set`,description:`Set a repository secret (reads value from --body or stdin)`},args:{name:{type:`positional`,description:`Secret name`,required:!0},body:{type:`string`,description:`Secret value (reads from stdin if omitted)`},"dry-run":{type:`boolean`,description:`Show what would be done without making API calls`},verbose:{type:`boolean`,description:`Enable verbose output`},json:{type:`boolean`,description:`Emit one JSON document: status (set | would-set), name, repository. The secret value is never included.`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=requireForgejoTarget(process.cwd(),void 0,`bst-fj secrets requires a Forgejo repository`),r=cliFetcher(),i=readSecretValue(e.body),a=await runSecretsSet(r,{conn:n,secretName:e.name,secretValue:i,dryRun:e[`dry-run`]===!0});t.json(a)}}),je=_({meta:{name:`list`,description:`List repository secret names`},args:{verbose:{type:`boolean`,description:`Enable verbose output`},json:{type:`boolean`,description:`Emit one JSON document: repository, secrets (secret names). Values are never returned.`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=requireForgejoTarget(process.cwd(),void 0,`bst-fj secrets requires a Forgejo repository`),r=await runSecretsList(cliFetcher(),{conn:n});t.json({repository:n.repository,secrets:r})}}),Me=_({meta:{name:`delete`,description:`Delete a repository secret`},args:{name:{type:`positional`,description:`Secret name to delete`,required:!0},"dry-run":{type:`boolean`,description:`Show what would be done without making API calls`},verbose:{type:`boolean`,description:`Enable verbose output`},json:{type:`boolean`,description:`Emit one JSON document: status (deleted | would-delete), name, repository.`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=requireForgejoTarget(process.cwd(),void 0,`bst-fj secrets requires a Forgejo repository`),r=await runSecretsDelete(cliFetcher(),{conn:n,secretName:e.name,dryRun:e[`dry-run`]===!0});t.json(r)}}),Ne=_({meta:{name:`secrets`,description:`Low-level CRUD for individual Forgejo Actions secrets (set, list, delete). Use pnpm exec bst setup:secrets (in @bensandee/tooling) for initial repo onboarding`},args:{json:{type:`boolean`,description:`Emit one JSON document; the keys are the subcommand's (see secrets set --help, secrets list --help and secrets delete --help).`}},subCommands:{set:Ae,list:je,delete:Me}}),Pe=g.object({login:g.string(),email:g.string().nullish()});async function getAuthenticatedUser(e,t,n=null){let r=await e.fetch(`${t.serverUrl}/api/v1/user`,{headers:authHeaders(t),signal:n});if(!r.ok)return{ok:!1,httpStatus:r.status,statusText:r.statusText};let i=Pe.safeParse(await r.json());if(!i.success)throw new f(`Unexpected /user response: ${i.error.message}`);return{ok:!0,login:i.data.login,email:i.data.email||null}}const Fe=g.object({id:g.number(),type:g.string(),active:g.boolean(),config:g.record(g.string(),g.string()).optional()}),Ie=g.array(Fe);async function fetchHooks(e,t,n){let r=await e.fetch(`${t.serverUrl}/api/v1${n}`,{headers:{Authorization:`token ${t.token}`}});if(r.status===401||r.status===403)return{status:`unauthorized`,httpStatus:r.status};if(!r.ok){let e=await responseBodyText(r);return{status:`error`,httpStatus:r.status,message:`${r.statusText}\n${e}`}}let i=Ie.safeParse(await r.json());if(!i.success)throw new f(`Unexpected webhook list response for ${n}: ${i.error.message}`);return{status:`ok`,hooks:i.data}}async function listSystemHooks(e,t){return fetchHooks(e,t,`/admin/hooks`)}async function listUserHooks(e,t){return fetchHooks(e,t,`/user/hooks`)}async function listOrgHooks(e,t,n){return fetchHooks(e,t,`/orgs/${encodeURIComponent(n)}/hooks`)}async function listRepoHooks(e,t,n){return fetchHooks(e,t,`/repos/${n}/hooks`)}async function hasAdminAccess(e,t){return(await e.fetch(`${t.serverUrl}/api/v1/admin/users?limit=1`,{headers:{Authorization:`token ${t.token}`}})).ok}const Le=g.object({username:g.string()}),Re=g.array(Le);async function paginate(e,t,n,r,i){let a=[],o=n.includes(`?`)?`&`:`?`;for(let s=1;s<=101;s++){let c=`${t.serverUrl}/api/v1${n}${o}page=${String(s)}&limit=50`,l=await e.fetch(c,{headers:{Authorization:`token ${t.token}`}});if(!l.ok)throw new d(await forgejoErrorMessage(l,{verb:r,resource:`${n} (page ${String(s)})`}));let u=i(await l.json());if(a.push(...u),!morePagesFollow(l,u.length,a.length,50))break;if(s===101)throw new f(`${n} still returns full pages after 100 pages; refusing to report a prefix of it`)}return a}async function listOrgs(e,t,n){let r=n===`admin`?`/admin/orgs`:`/user/orgs`;return(await paginate(e,t,r,`list orgs`,e=>{let t=Re.safeParse(e);if(!t.success)throw new f(`Unexpected ${r} response: ${t.error.message}`);return t.data})).map(e=>e.username)}const ze=g.object({data:g.array(g.object({full_name:g.string()}))});async function searchRepos(e,t){return(await paginate(e,t,`/repos/search`,`list repos`,e=>{let t=ze.safeParse(e);if(!t.success)throw new f(`Unexpected /repos/search response: ${t.error.message}`);return t.data.data})).map(e=>e.full_name)}function collectGroup(e,t,n){return n.status===`ok`?n.hooks.length>0?{label:e,hooks:n.hooks}:null:n.status===`unauthorized`?(M.warn(`${e}: HTTP ${String(n.httpStatus)} -- token likely missing scope: ${t}`),null):(M.warn(`${e}: HTTP ${String(n.httpStatus)} ${n.message}`),null)}async function runListWebhooks(e,t){let n=await getAuthenticatedUser(e,t);if(!n.ok)throw new u(`Token is invalid or lacks read:user scope (HTTP ${String(n.httpStatus)})`);let r=n.login,i=await hasAdminAccess(e,t),a=[],o=collectGroup(`System`,`read:admin`,await listSystemHooks(e,t));o&&a.push(o);let s=collectGroup(`User: ${r}`,`read:user`,await listUserHooks(e,t));s&&a.push(s);let c=await listOrgs(e,t,i?`admin`:`user`);for(let n of c){let r=collectGroup(`Org: ${n}`,`read:organization`,await listOrgHooks(e,t,n));r&&a.push(r)}let l=await searchRepos(e,t);for(let n of l){let r=collectGroup(`Repo: ${n}`,`read:repository + repo admin`,await listRepoHooks(e,t,n));r&&a.push(r)}return{user:r,isAdmin:i,groups:a,totalCount:a.reduce((e,t)=>e+t.hooks.length,0)}}function renderText(e,t){if(M.info(`Forgejo Webhook Inventory -- ${t}`),M.info(`Token user: ${e.user}${e.isAdmin?` (admin)`:``}`),e.groups.length===0)M.info(`No webhooks found.`);else{for(let t of e.groups){M.info(`${t.label} (${String(t.hooks.length)} webhook(s))`);for(let e of t.hooks){let t=e.config?.url??`n/a`;M.info(` id=${String(e.id)} type=${e.type} active=${String(e.active)} url=${t}`)}}M.info(`Total: ${String(e.totalCount)} webhook(s)`),e.isAdmin&&M.info(`Note: User-level webhooks for other accounts cannot be enumerated via the API. Check the admin UI or run this command with tokens from individual user accounts.`)}}const Be=_({meta:{name:`webhooks`,description:`Enumerate webhooks across a Forgejo instance (system, user, org, and repo levels)`},args:{json:{type:`boolean`,description:`Emit one JSON document: user, isAdmin, groups ([{label, hooks ([{id, type, active, config?}])}]), totalCount.`}},async run({args:e}){let t=requireForgejoTarget(process.cwd(),void 0,`bst-fj webhooks requires a Forgejo repository`),n=await runListWebhooks(cliFetcher(),t);e.json?createCliOutput(!0).json(n):renderText(n,t.serverUrl)}});function forgeTimestamp(e){if(e==null||e===``)return null;let t=Date.parse(e);return!Number.isFinite(t)||t<=0?null:e}const K=g.object({id:g.number(),index_in_repo:g.number().nullish(),workflow_id:g.string().nullish(),title:g.string().nullish(),prettyref:g.string().nullish(),commit_sha:g.string().nullish(),event:g.string().nullish(),status:g.string().nullish(),started:g.string().nullish(),stopped:g.string().nullish(),duration:g.number().nullish(),html_url:g.string().nullish()}),Ve=g.object({workflow_runs:g.array(K)}),He=g.object({id:g.number(),name:g.string(),status:g.string()}),Ue=g.array(He);function toActionsRun(e){let t=e.duration??null;return{id:e.id,number:e.index_in_repo??null,workflow:e.workflow_id??null,title:e.title??null,ref:e.prettyref??null,headSha:e.commit_sha??null,event:e.event??null,status:e.status??null,startedAt:forgeTimestamp(e.started),completedAt:forgeTimestamp(e.stopped),durationMs:t===null||t<=0?null:Math.round(t/1e6),url:e.html_url??null}}async function getActionsRunByNumber(e,t,n){let r=new URLSearchParams({run_number:n,page:`1`,limit:`1`}),i=`${t.serverUrl}/api/v1/repos/${t.repository}/actions/runs?${r.toString()}`,a=await e.fetch(i,{headers:{Authorization:`token ${t.token}`}});a.ok||await throwForgejoFailure(a,{verb:`look up run`,resource:n});let o=Ve.safeParse(await a.json());if(!o.success)throw new f(`Unexpected run lookup response for run ${n}: ${o.error.message}`);let[s]=o.data.workflow_runs;if(s===void 0)throw new u(`No run numbered ${n} in ${t.repository}`);let c=toActionsRun(s);if(c.number!==null&&String(c.number)!==n)throw new f(`Asked ${t.repository} for run ${n} and got run ${String(c.number)}: the forge ignored the run_number filter`);return c}async function listActionsRunJobs(e,t,n){let r=`${t.serverUrl}/api/v1/repos/${t.repository}/actions/runs/${String(n)}/jobs`,i=await e.fetch(r,{headers:{Authorization:`token ${t.token}`}});i.ok||await throwForgejoFailure(i,{verb:`list run jobs`,resource:String(n)});let a=Ue.safeParse(await i.json());if(!a.success)throw new f(`Unexpected run-jobs response for run ${String(n)}: ${a.error.message}`);let o=[];for(let[e,t]of a.data.entries())o.push({index:e,id:t.id,name:t.name,status:t.status});return o}async function fetchActionsJobLogById(e,t,n,r){let i=`${t.serverUrl}/api/v1/repos/${t.repository}/actions/jobs/${String(n)}/logs`,a=await e.fetch(i,{headers:{Authorization:`token ${t.token}`}});a.ok||await throwForgejoFailure(a,{verb:`read job log`,resource:String(n)});let o=await a.text();if(`head`in r)return{text:o.slice(0,r.head),truncated:o.length>r.head};let s=r.tail;return o.length<=s?{text:o,truncated:!1}:{text:o.slice(o.length-s),truncated:!0}}const We=g.object({workflow_runs:g.array(K)});async function listActionsRuns(e,t,n){let r={Authorization:`token ${t.token}`},i=Math.min(n.limit,50),a=[];for(let o=1;o<=20;o++){let s=new URLSearchParams({page:String(o),limit:String(i)});n.workflow!==void 0&&s.set(`workflow_id`,n.workflow),n.ref!==void 0&&s.set(`ref`,n.ref),n.headSha!==void 0&&s.set(`head_sha`,n.headSha),n.status!==void 0&&s.set(`status`,n.status);let c=`${t.serverUrl}/api/v1/repos/${t.repository}/actions/runs?${s.toString()}`,l=await e.fetch(c,{headers:r});l.ok||await throwForgejoFailure(l,{verb:`list workflow runs`,resource:t.repository});let u=We.safeParse(await l.json());if(!u.success)throw new f(`Unexpected workflow-runs response for ${t.repository}: ${u.error.message}`);let d=u.data.workflow_runs.map(toActionsRun);if(a.push(...d),d.length===0||a.length>=n.limit)break;o===20&&(L.warn(`Workflow run listing on ${t.repository} hit the 20-page cap without an empty page; results may be truncated`),n.onPageCap?.())}return a.slice(0,n.limit)}const Ge=/\/actions\/runs\/(\d+)\/jobs\/(\d+)(?:[/?#]|$)/u;function parseActionsJobTargetUrl(e){if(e===null)return null;let t=Ge.exec(e);return t===null?null:{run:t[1],index:Number(t[2])}}function parseActionsJobTargetRepo(e){let t=e.indexOf(`/actions/runs/`);if(t===-1)return;let n=e.slice(0,t);if(n.startsWith(`http://`)||n.startsWith(`https://`))return parseRepoTarget(n)}async function dispatchWorkflow(e,t,n){let r=n.repository??t.repository,i=`${t.serverUrl}/api/v1/repos/${r}/actions/workflows/${encodeURIComponent(n.workflow)}/dispatches`,a={ref:n.ref};Object.keys(n.inputs).length>0&&(a.inputs=n.inputs);let o=await e.fetch(i,{method:`POST`,headers:jsonHeaders(t),body:JSON.stringify(a)});if(!o.ok)throw new u(await forgejoErrorMessage(o,{verb:`dispatch workflow`,resource:n.workflow,ref:n.ref}));return{repository:r,workflow:n.workflow,ref:n.ref,inputs:n.inputs}}const Ke=/\u001b\[[0-?]*[ -/]*[@-~]/gu,qe=/\u001b\][^\u0007]*(?:\u0007|\u001b\\)/gu,Je=/\u001b/gu,Ye=/[\u0000-\u0008\u000a-\u001f\u007f]/gu,Xe=/^\d{4}-\d{2}-\d{2}T\S+$/u;function stripControlSequences(e){return e.replace(Ke,``).replace(qe,``).replace(Je,``).replace(Ye,``)}function splitLogLine(e){let t=e.indexOf(` `),n=t===-1?e:e.slice(0,t);return Xe.test(n)&&Number.isFinite(Date.parse(n))?{at:n,text:stripControlSequences(t===-1?``:e.slice(t+1))}:{at:null,text:stripControlSequences(e)}}function spanBetween(e,t){if(e===null||t===null)return null;let n=Date.parse(e),r=Date.parse(t);return!Number.isFinite(n)||!Number.isFinite(r)?null:r-n}function readActionsJobLog(e){let t=e.split(`
|
|
7
|
-
`);t.length>0&&t[t.length-1]===``&&t.pop();let n=t.map(e=>splitLogLine(e.endsWith(`\r`)?e.slice(0,-1):e)),r=n.find(e=>e.at!==null)?.at??null,i=null;for(let e=n.length-1;e>=0&&i===null;e--)i=n[e]?.at??null;return{firstLineAt:r,lastLineAt:i,spanMs:spanBetween(r,i),lines:n}}const
|
|
8
|
-
`)}function jobAtIndex(e,t,n){let r=e.find(e=>e.index===t);if(r===void 0)throw new u(`${n} ${String(t)} is not one of this run's jobs. Jobs in this run:\n${jobTable(e)}`);return r}function chooseJob(e,t,n){if(t!==void 0){let r=/^\d+$/.test(t)?jobAtIndex(e,Number(t),`--job ${t}`):e.find(e=>e.name.toLowerCase()===t.toLowerCase());if(r===void 0)throw new u(`No job is named "${t}". Jobs in this run:\n${jobTable(e)}`);if(n!==null&&r.index!==n)throw new u(`--job "${t}" is job ${String(r.index)}, but the URL names job ${String(n)} -- give one of them.`);return r}if(n!==null)return jobAtIndex(e,n,`The URL's job index`);let r=e.length===1?e[0]:void 0;if(r!==void 0)return r;throw new u(`This run has ${String(e.length)} jobs, so --job must say which one (a name or the index).\nJobs in this run:\n${jobTable(e)}`)}
|
|
9
|
-
`)}
|
|
10
|
-
`)}const
|
|
11
|
-
`)}const ot={"branch:delete":_({meta:{name:`branch:delete`,description:`Delete a branch; the forge's refusal (forbidden, locked) is reported (Forgejo-only)`},args:{name:{type:`positional`,required:!0,description:`Branch name`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: deleted.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=await runBranchDelete(cliFetcher(),{cwd:process.cwd(),name:e.name,repo:e.repo??void 0});t.json(n),t.text(`Deleted branch ${n.deleted}.`)}}),"branch:list":_({meta:{name:`branch:list`,description:`List a repository's branches (Forgejo-only)`},args:{repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: branches ([{name, protected, commitSha (or null), commitDate (or null)}]), truncated.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=await runBranchList(cliFetcher(),{cwd:process.cwd(),repo:e.repo??void 0});t.json({branches:n.branches,truncated:n.truncated}),t.text(renderBranchList(n))}})};function tryRead(e,t){try{return e()}catch(e){throw new u(`Could not read ${t}: ${p(e)}`)}}function readBodySource(t,r,i={}){let a=i.flags??{text:`--body`,file:`--body-file`};if(t!==void 0&&r!==void 0)throw new u(`Pass either ${a.text} or ${a.file}, not both.`);if(t!==void 0)return t;if(r!==void 0){if(r===`-`)return tryRead(i.readStdin??(()=>n(0,`utf-8`)),`stdin`);if(!e(r))throw new u(`${a.file} not found: ${r}`);return tryRead(()=>n(r,`utf-8`),`${a.file} "${r}"`)}}const q=g.object({id:g.number(),body:g.string().nullish(),user:g.object({login:g.string()}).nullish(),created_at:g.string(),updated_at:g.string().nullish(),html_url:g.string().nullish(),assets:ie.nullish()}),st=g.array(q);function parseCommentOrThrow(e){let t=q.safeParse(e);if(!t.success)throw new f(`Unexpected comment response: ${t.error.message}`);return t.data}function parseCommentListOrThrow(e){let t=st.safeParse(e);if(!t.success)throw new f(`Unexpected comment-list response: ${t.error.message}`);return t.data}function normalizeComment(e){return{id:e.id,author:e.user?.login??``,createdAt:e.created_at,updatedAt:e.updated_at??e.created_at,body:e.body??``,...e.html_url===void 0||e.html_url===null?{}:{url:e.html_url},attachments:(e.assets??[]).map(normalizeAttachment)}}async function listForgejoComments(e,t,n,r={}){let i=[];for(let a=1;a<=20;a++){let o=new URLSearchParams({limit:`50`,page:String(a)}),s=await e.fetch(`${issuesBase(t)}/${String(n)}/comments?${o.toString()}`,{headers:authHeaders(t)});s.ok||await throwForgejoFailure(s,{verb:`list comments`,resource:`#${String(n)}`},issueNotFoundMessage(t,n));let c=parseCommentListOrThrow(await s.json());if(i.push(...c.map(normalizeComment)),!morePagesFollow(s,c.length,i.length,50))break;a===20&&(L.warn(`Comment listing for #${String(n)} hit the 20-page cap; results may be truncated`),r.onPageCap?.())}return i}const ct=q.extend({issue_url:g.string().nullish(),pull_request_url:g.string().nullish(),updated_at:g.string().nullish()});g.array(ct);async function addForgejoComment(e,t,n,r){let i=await e.fetch(`${issuesBase(t)}/${String(n)}/comments`,{method:`POST`,headers:jsonHeaders(t),body:JSON.stringify({body:r})});return i.ok||await throwForgejoFailure(i,{verb:`comment on issue`,resource:`#${String(n)}`},issueNotFoundMessage(t,n)),normalizeComment(parseCommentOrThrow(await i.json()))}const lt=[`WIP:`,`[WIP]`];function hasWipPrefix(e){return matchedWipPrefix(e)!==void 0}function matchedWipPrefix(e){let t=e.toLowerCase();return lt.find(e=>t.startsWith(e.toLowerCase()))}function stripWipPrefix(e){let t=matchedWipPrefix(e);return t===void 0?e:e.slice(t.length).trimStart()}const ut=g.object({number:g.number(),html_url:g.string().optional()});function prWebUrl(e,t){return`${e.serverUrl}/${e.repository}/pulls/${String(t)}`}async function findOpenPrEntry(e,t,n,r=null){let i=t.repository.toLowerCase(),isThisRepo=e=>e.headRef===n&&e.headRepo!==null&&e.headRepo.toLowerCase()===i,a=!1,o=(await listPulls(e,t,{state:`open`,stopWhen:isThisRepo,onPageCap:()=>{a=!0},signal:r})).find(isThisRepo);if(o!==void 0){if(o.baseRef===null)throw new f(`Open PR #${String(o.number)} on ${t.repository} carries no base branch`);return{number:o.number,base:o.baseRef}}if(a)throw new u(`Open PR lookup on ${t.repository} for head "${n}" hit the 20-page cap without finding it or reaching an empty page; a truncated read here reads as "no open PR" and makes a caller create a duplicate`);return null}async function findOpenPr(e,t,n,r=null){return(await findOpenPrEntry(e,t,n,r))?.number??null}async function listBranchPulls(e,t,n,r,i=null){let a=!1,o=await listPulls(e,t,{state:r,head:n,onPageCap:()=>{a=!0},signal:i}),s=t.repository.toLowerCase(),c=o.filter(e=>e.headRef===n&&e.headRepo!==null&&e.headRepo.toLowerCase()===s).map(e=>({number:e.number,base:e.baseRef,merged:e.merged}));if(a)throw new u(`Pull request listing on ${t.repository} for branch "${n}" hit the 20-page cap without reaching an empty page, so it cannot say how many pull requests that branch has; pass the pull request NUMBER instead of autodetecting it.`);return c}const dt=g.object({number:g.number(),title:g.string().nullish(),body:g.string().nullish(),head:g.object({ref:g.string(),repo:g.object({full_name:g.string()}).nullish()}),base:g.object({ref:g.string()}).nullish(),state:g.enum([`open`,`closed`]),merged:g.boolean().nullish(),merged_at:g.string().nullish(),html_url:g.string().nullish(),draft:g.boolean().nullish(),user:g.object({login:g.string().nullish()}).nullish(),updated_at:g.string().nullish(),labels:g.array(g.object({name:g.string()})).nullish()});function updatedBefore(e){return t=>t.updatedAt!==null&&Date.parse(t.updatedAt)<e}async function listPulls(e,t,n={}){let r=n.startPage??1;if(!Number.isInteger(r)||r<1)throw new u(`Cannot list PRs on ${t.repository}: startPage must be an integer of at least 1, got ${String(r)}`);let i=r+20-1,a={Authorization:`token ${t.token}`},o=[];for(let s=r;s<=i;s++){n.signal?.throwIfAborted();let r=new URLSearchParams({state:n.state??`all`,limit:`50`,page:String(s)}),c=n.updatedSince===void 0?n.sort:`recentupdate`;c!==void 0&&r.set(`sort`,c);for(let e of n.labelIds??[])r.append(`labels`,String(e));n.head!==void 0&&r.set(`head`,n.head);let l=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls?${r.toString()}`,u=await e.fetch(l,{headers:a,signal:n.signal??null});u.ok||await throwForgejoFailure(u,{verb:`list PRs`,resource:t.repository});let d=dt.array().safeParse(await u.json());if(!d.success)throw new f(`Unexpected PR list response: ${d.error.message}`);let p=d.data.map(e=>({number:e.number,title:e.title??null,body:e.body??null,headRef:e.head.ref,headRepo:e.head.repo?.full_name??null,baseRef:e.base?.ref??null,state:e.state,merged:e.merged??e.merged_at!=null,mergedAt:e.merged_at??null,url:e.html_url??null,draft:e.draft??null,author:e.user?.login??null,updatedAt:e.updated_at??null,labels:(e.labels??[]).map(e=>e.name)}));if(o.push(...p),p.length===0||n.stopWhen!==void 0&&p.some(n.stopWhen)||n.updatedSince!==void 0&&p.some(updatedBefore(n.updatedSince))||n.limit!==void 0&&o.length>=n.limit)break;s===i&&(L.warn(`PR listing on ${t.repository} hit the 20-page cap without an empty page; results may be truncated`),n.onPageCap?.(i))}return o}async function createPr(e,t,n){let r=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls`,i={title:n.title,head:n.head,base:n.base};n.body&&(i.body=n.body);let a=await e.fetch(r,{method:`POST`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify(i)});a.ok||await throwForgejoFailure(a,{verb:`create PR`,resource:`${n.head}->${n.base}`});let o=ut.safeParse(await a.json());if(!o.success)throw new f(`Unexpected create-PR response: ${o.error.message}`);return{number:o.data.number,htmlUrl:o.data.html_url??prWebUrl(t,o.data.number)}}g.object({body:g.string().nullish()});async function readPrField(e,t,n,r,i){let a=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls/${String(n)}`,o=await e.fetch(a,{headers:{Authorization:`token ${t.token}`}});o.ok||await throwForgejoFailure(o,{verb:`read PR ${i}`,resource:`#${String(n)}`});let s=r.safeParse(await o.json());if(!s.success)throw new f(`Unexpected PR ${i} response: ${s.error.message}`);return s.data}g.object({head:g.object({ref:g.string()})}),g.object({head:g.object({ref:g.string()}),base:g.object({ref:g.string()})});const J=g.object({ref:g.string(),sha:g.string(),repo:g.object({full_name:g.string()}).nullish()}),ft=g.object({head:J,base:J,draft:g.boolean(),merged:g.boolean(),mergeable:g.boolean().nullish(),merge_commit_sha:g.string().nullish(),state:g.string()}),pt=/^[0-9a-f]{7,64}$/;function isMergeCommitSha(e){return e!=null&&pt.test(e)}function normalizePrDetail(e){return{head:{ref:e.head.ref,sha:e.head.sha,repo:e.head.repo?.full_name??null},base:{ref:e.base.ref,sha:e.base.sha,repo:e.base.repo?.full_name??null},draft:e.draft,merged:e.merged,mergeable:e.mergeable??null,mergeCommitSha:isMergeCommitSha(e.merge_commit_sha)?e.merge_commit_sha:null,state:e.state}}async function getForgejoPrDetail(e,t,n){return normalizePrDetail(await readPrField(e,t,n,ft,`detail`))}const mt=g.object({state:g.string(),merged:g.boolean(),draft:g.boolean(),title:g.string(),head:g.object({ref:g.string()}),base:g.object({ref:g.string()}),mergeable:g.boolean().nullish(),html_url:g.string().optional()});async function getPrEditState(e,t,n){let r=await readPrField(e,t,n,mt,`edit state`);return{state:r.state,merged:r.merged,draft:r.draft,title:r.title,head:r.head.ref,base:r.base.ref,mergeable:r.mergeable??null,url:r.html_url??prWebUrl(t,n)}}async function retargetPr(e,t,n,r){let i=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls/${String(n)}`,a=await e.fetch(i,{method:`PATCH`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify({base:r})},{idempotent:!0});a.ok||await throwForgejoFailure(a,{verb:`retarget PR`,resource:`#${String(n)}`})}async function reopenPr(e,t,n){let r=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls/${String(n)}`,i=await e.fetch(r,{method:`PATCH`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify({state:`open`})},{idempotent:!0});i.ok||await throwForgejoFailure(i,{verb:`reopen PR`,resource:`#${String(n)}`})}const ht=g.object({title:g.string(),body:g.string().nullish()});async function getPrContent(e,t,n){let r=await readPrField(e,t,n,ht,`content`);return{title:r.title,body:r.body??``}}g.object({title:g.string(),draft:g.boolean()});async function updatePr(e,t,n,r){if(r.title===void 0&&r.body===void 0)return;let i=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls/${String(n)}`,a=await e.fetch(i,{method:`PATCH`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify({title:r.title,body:r.body})},{idempotent:!0});a.ok||await throwForgejoFailure(a,{verb:`update PR`,resource:`#${String(n)}`})}const gt=g.object({id:g.number(),body:g.string(),commit_id:g.string().nullish(),user:g.object({login:g.string()}).nullish(),html_url:g.string().nullish(),submitted_at:g.string().nullish()});g.array(gt),g.object({head:g.object({sha:g.string()})});const _t=g.object({body:g.string(),path:g.string().optional(),diff_hunk:g.string().optional(),user:g.object({login:g.string()}).nullish()});g.array(_t),g.array(g.object({id:g.number()}));var IssueNumberRequiredError=class extends u{constructor(){super(`An issue number or issue URL is required.`)}};function requireIssueNumber(e){if(e.number===void 0)throw new IssueNumberRequiredError;return e.number}function forgejoIssueApi(e,t){return{get:n=>getForgejoIssue(e,t,n),list:async(n,r)=>(await listForgejoIssuesDetailedPaged(e,t,{...n,type:`issues`},r)).slice(0,n.limit).map(({body:e,...t})=>t),comments:(n,r)=>listForgejoComments(e,t,n,r),create:n=>createForgejoIssue(e,t,n),update:(n,r)=>updateForgejoIssue(e,t,n,r),setState:(n,r)=>setForgejoIssueState(e,t,n,r),addComment:(n,r)=>addForgejoComment(e,t,n,r),pullRequest:n=>getForgejoPrDetail(e,t,n)}}function describeIssueNumberRequired(e){return`An issue number or issue URL is required, e.g. \`${e}\`.`}function describeInvalidListQuery(e,t){return e.field===`state`?`${t.state} must be one of open, closed, all (got "${e.value}")`:`${t.limit} must be a positive integer (got "${e.value}")`}function describeNothingToUpdate(e){return`Nothing to change -- pass ${e.title} and/or ${e.body}/${e.bodyFile}. (Omitting them leaves the issue exactly as authored; this command never derives a replacement.)`}function describeEmptyComment(e){return`${e.text} / ${e.file} resolved to empty text -- pass a comment or omit the flag.`}function describePullRequestState(e,t){return`#${String(e.number)} is a pull request, not an issue -- ${t.command} refuses to write pull-request state. ${t.advice}`}function describeNoLabelsGiven(e,t){return`No labels given, which would strip every label off #${String(e.number)}. Pass ${t} if that is what you mean, or name the labels the issue should end up with.`}function describeAttachmentExists(e,t){return`"${e.filePath}" already exists -- pass ${t} to overwrite it.`}var NothingToUpdateError=class extends u{constructor(){super(`Nothing to change: neither a title nor a body was given.`)}},IssueTitleRequiredError=class extends u{constructor(){super(`An issue title is required.`)}},InvalidListQueryError=class extends u{field;value;constructor(e,t){super(`The list ${e} is not valid (got "${t}").`),this.field=e,this.value=t}};async function viewIssue(e,t){let n=parseIssueRef(t.ref),r=requireIssueNumber(n),{api:i}=e(resolveIssueTarget(n.target,t.repo)),a=!1,[o,s]=await Promise.all([i.get(r),i.comments(r,{onPageCap:()=>{a=!0}})]);if(!o.isPullRequest)return{...o,comments:s,commentsTruncated:a};try{return{...o,comments:s,commentsTruncated:a,pr:await i.pullRequest(r)}}catch(e){if(!(e instanceof ForgeAccessError))throw e;return{...o,comments:s,commentsTruncated:a,prUnavailable:{reason:m(e.message)}}}}function formatPrHead(e){return e.head.repo===null?`${e.head.ref} (head repo gone)`:e.head.repo===e.base.repo?e.head.ref:`${e.head.repo}:${e.head.ref}`}function formatMergeable(e){return e===null?`mergeable: unknown`:e?`mergeable`:`not mergeable`}function formatPrLine(e){let t=e.head.sha.slice(0,12),n=`pr: ${formatPrHead(e)} -> ${e.base.ref} head ${t}`;return e.draft&&(n+=` draft`),e.merged&&(n+=` merged`),n+=` ${formatMergeable(e.mergeable)}`,n}function formatPrUnavailableLine(e){let t=e.reason.indexOf(`
|
|
3
|
+
`)}catch{}process.exitCode=1}function installJsonExitNet(e,t,n,r){process.on(`exit`,()=>{runJsonExitNet({write:e=>a(1,e),wroteDocument:r,command:t,version:n,binName:e})})}function classifyThrown(e,t){let n=e instanceof Error&&e.name===`CLIError`?`usage`:`runtime`,r=m(p(e));if(!t)return{kind:n,message:r};let i=e instanceof Error&&typeof e.stack==`string`?m(e.stack):void 0;return i===void 0?{kind:n,message:r}:{kind:n,message:r,detail:i}}const C=`BST_ENV_FILE`;function loadEnvFileFromEnv(){let e=process.env[C]?.trim();if(e===void 0||e===``)return;let t=s.resolve(e),r;try{r=n(t,`utf8`)}catch(e){let n=e instanceof Error?e.message:String(e);throw new u(`${C} names ${t}, which could not be read (${n}). Unset ${C} or point it at a readable env file.`)}let i=[],a=[];for(let[e,t]of Object.entries(l(r)))process.env[e]===void 0?(process.env[e]=t,i.push(e)):a.push(e);return{path:t,added:i,kept:a}}function describeEnvFileLoad(e){if(e===void 0)return`No env file loaded -- ${C} is unset or empty.`;let t=[`Loaded ${String(e.added.length)} variable(s) from ${e.path} (${C}): `+(e.added.length===0?`none`:e.added.join(`, `))];return e.kept.length>0&&t.push(`${String(e.kept.length)} already set in the environment kept their value: `+e.kept.join(`, `)),t.join(`; `)}const w={out:e=>{process.stdout.write(`${e}\n`)},err:e=>{process.stderr.write(`${e}\n`)},exit:e=>process.exit(e)};function loadEnvFileForBin(e,t,n=w){try{return loadEnvFileFromEnv()}catch(r){let i=r instanceof Error?r.message:String(r);if(resolveJsonMode(e)){let r=buildErrorDocument({command:resolveCommandName(e),version:t.version,kind:`usage`,message:i});n.out(JSON.stringify(r))}else n.err(`${t.name}: ${i}`);return n.exit(1)}}const T=g.object({version:g.string()}).safeParse({name:`@bensandee/forgejo-cli`,version:`0.11.0`,description:`bst-fj: Forgejo API commands without the rest of bst`,license:`MIT`,repository:{type:`git`,url:`https://codeberg.org/bensandee/tooling.git`,directory:`packages/forgejo-cli`},bin:{"bst-fj":`./bin/bst-fj.mjs`},files:[`bin`,`dist`],type:`module`,imports:{"#src/*.ts":`./src/*.ts`},exports:{"./package.json":`./package.json`,"./*":`./src/*.ts`,"./test/*":`./test/*.ts`},publishConfig:{exports:{"./package.json":`./package.json`},access:`public`,registry:`https://registry.npmjs.org`},scripts:{build:`tsdown`,dev:`tsdown --watch`,test:`vitest run`},dependencies:{"@bensandee/common":`0.2.0`,citty:`^0.2.2`,zod:`^4.6.7`},devDependencies:{"@bensandee/cli-kit":`workspace:*`,"@bensandee/forgejo":`workspace:*`,"@types/node":`24.19.2`,tsdown:`0.23.7`}});if(!T.success)throw new f(`@bensandee/forgejo-cli's package.json has no string version.`);const E=T.data.version,ee=loadEnvFileForBin(process.argv.slice(2),{name:`bst-fj`,version:E}),D={error:0,warn:1,info:2,debug:3,trace:4};let O=`info`;function setLogLevel(e){O=e}function resolveLogLevel(e){return e.trace===!0||process.env.TOOLING_TRACE===`true`?`trace`:e.verbose===!0||process.env.TOOLING_DEBUG===`true`?`debug`:`info`}process.env.CI;const out=e=>console.log(e),err=e=>console.error(e),te={info:out,warn:e=>out(`[warn] ${e}`),error:e=>out(`[error] ${e}`),success:e=>out(`[ok] ${e}`)};let k=!1;function setJsonMode(e){k=e}function isJsonMode(){return k}let A;function setJsonNoticeSink(e){A=e}function formatContext(e){let t=[];if(e.repo!==void 0){let n=e.repo.split(`/`).findLast(e=>e.length>0);n!==void 0&&t.push(n)}return e.issue!==void 0&&t.push(`#${String(e.issue)}`),e.pr!==void 0&&t.push(`PR#${String(e.pr)}`),e.phase!==void 0&&t.push(e.phase),t.length>0?`[${t.join(` `)}]`:``}function build(e){let t=formatContext(e.context),enabled=t=>D[t]<=D[e.level??O],stamp=()=>`[${e.now().toISOString()}]`,userFacing=(n,r)=>i=>{if(!enabled(r))return;if(k){(n===`warn`||n===`error`)&&A&&A(h(i));return}let a=[];(e.timestamps??!1)&&a.push(stamp()),t&&a.push(t),a.push(h(i)),(e.userSink??te)[n](a.join(` `))},diagnostic=n=>r=>{if(!enabled(n))return;let i=[stamp()];t&&i.push(t),i.push(`[${n}]`,h(r)),e.diagnosticSink(i.join(` `))};return{info:userFacing(`info`,`info`),warn:userFacing(`warn`,`warn`),error:userFacing(`error`,`error`),success:userFacing(`success`,`info`),debug:diagnostic(`debug`),trace:diagnostic(`trace`),child:t=>build({...e,context:{...e.context,...t}})}}function createLogger(e={}){return build({level:e.level,timestamps:e.timestamps,context:e.context??{},userSink:e.userSink,diagnosticSink:e.diagnosticSink??err,now:e.now??(()=>/* @__PURE__ */ new Date)})}const j=createLogger(),M=[`--help`,`-h`,`--version`,`-v`,`--verbose`,`--trace`],N=new Set(M.map(flagName));function hasHelpFlag(e){return e.includes(`--help`)||e.includes(`-h`)}function isLoneVersionQuery(e){return e.length===1&&(e[0]===`--version`||e[0]===`-v`)}function splitAtCommand(e,t){for(let n=0;n<e.length;n++){let r=e[n];if(r===`--`)return;if(r.startsWith(`-`))t!==void 0&&!r.includes(`=`)&&declaresValueFlag(r,t)&&n++;else return{index:n,before:e.slice(0,n)}}}function declaresValueFlag(e,t){let n=flagName(e),r=toCamelCase(n);for(let[e,i]of Object.entries(t)){if(i.type!==`string`&&i.type!==`enum`)continue;if(r===toCamelCase(e))return!0;let t=`alias`in i?i.alias:void 0;if(t!==void 0&&(Array.isArray(t)?t.includes(n):t===n))return!0}return!1}function flagBase(e){let t=e.indexOf(`=`);return t===-1?e:e.slice(0,t)}function flagName(e){return flagBase(e).replace(/^-{1,2}/,``)}function resolveStaticArgsDef(e){let t=e.args;if(t!==void 0&&typeof t!=`function`&&!(t instanceof Promise))return t}function toCamelCase(e){return e.replace(/-([a-z0-9])/g,(e,t)=>t.toUpperCase())}function toKebabCase(e){return e.replace(/([a-z0-9])([A-Z])/g,`$1-$2`).toLowerCase()}function buildParseTable(e){let t=/* @__PURE__ */ new Set,n=/* @__PURE__ */ new Map,r=new Set(N),i=[];for(let[a,o]of Object.entries(e)){if(o.type===`positional`)continue;o.type===`boolean`&&t.add(a);let e=`alias`in o?o.alias:void 0,s;s=e===void 0?[]:Array.isArray(e)?e:[e];let c=[...s],l=toCamelCase(a),u=toKebabCase(a);l!==a&&!c.includes(l)&&c.push(l),u!==a&&!c.includes(u)&&c.push(u),n.set(a,c),r.add(a);for(let e of c)r.add(e);i.push(`--${a}`)}function typeFor(e){if(t.has(e))return`boolean`;for(let[r,i]of n)if((r===e||i.includes(e))&&t.has(r))return`boolean`;return`string`}let a={};for(let[e,t]of n){a[e]={type:typeFor(e)};for(let e of t)a[e]={type:typeFor(e)}}return{nodeOptions:a,knownNames:r,acceptedFlags:i}}function parsePostCommandArgs(e,t){let n=[],r=[];for(let t=0;t<e.length;t++){let i=e[t];if(i===`--`){r.push(...e.slice(t));break}i.startsWith(`--no-`)?n.push(i.slice(5)):r.push(i)}let i={},a=[];try{let e=c({args:r,options:Object.keys(t).length>0?t:void 0,allowPositionals:!0,strict:!1});i=e.values,a=e.positionals}catch{i={}}return{values:i,positionals:a,negatedNames:n}}function findBadDirArg(e,t,n,r){let{positionals:i}=parsePostCommandArgs(e,n),a=Object.entries(t).filter(([,e])=>e.type===`positional`);for(let[e,[t,n]]of a.entries()){let a=i.at(e);if(a===void 0||n.valueHint!==`dir`)continue;let o=r(a);if(o!==`directory`)return{argName:t,value:a,missing:o===`missing`}}}function computeUnknownArgNames(e,t){let n=buildParseTable(t),{values:r,negatedNames:i}=parsePostCommandArgs(e,n.nodeOptions),a=/* @__PURE__ */ new Set;for(let e of Object.keys(r))n.knownNames.has(e)||a.add(e);for(let e of i)n.knownNames.has(e)||a.add(e);return[...a]}function buildDisplayTokenMap(e){let t=/* @__PURE__ */ new Map;for(let n of e){if(n===`--`)break;if(n.startsWith(`--no-`)){let e=n.slice(5);t.has(e)||t.set(e,flagBase(n));continue}if(!n.startsWith(`-`))continue;let e=flagName(n);t.has(e)||t.set(e,flagBase(n))}return t}function formatFlagToken(e){return e.length===1?`-${e}`:`--${e}`}function resolveStaticSubCommands(e){let t=e.subCommands;if(t!==void 0&&typeof t!=`function`&&!(t instanceof Promise))return t}function resolveLeafCommand(e,t,n){let r=resolveStaticArgsDef(e),i=resolveStaticSubCommands(e);if(i!==void 0){let e=splitAtCommand(n,r);if(e!==void 0){let r=n[e.index];if(!(r in i))return;let a=asCommandDef(i[r]);return a===void 0?void 0:resolveLeafCommand(a,[...t,r],n.slice(e.index+1))}}return r===void 0?void 0:{chain:t,argsDef:r,postCommandArgs:n}}function findUnknownFlags(e,t,n){if(hasHelpFlag(e)||isLoneVersionQuery(e))return{kind:`none`};let r=splitAtCommand(e);if(r===void 0)return{kind:`none`};let i=e[r.index];if(!(i in t))return{kind:`none`};let a=asCommandDef(t[i]);if(a===void 0)return{kind:`none`};for(let e of r.before)if(!N.has(flagName(e)))return{kind:`before-command`,command:i,flag:flagBase(e)};let o=resolveLeafCommand(a,[i],e.slice(r.index+1));if(o===void 0)return{kind:`none`};let s=buildParseTable(o.argsDef),c=computeUnknownArgNames(o.postCommandArgs,o.argsDef);if(c.length===0){let e=n===void 0?void 0:findBadDirArg(o.postCommandArgs,o.argsDef,s.nodeOptions,n);return e===void 0?{kind:`none`}:{kind:`not-a-directory`,command:i,commandPath:o.chain.join(` `),...e}}let l=buildDisplayTokenMap(o.postCommandArgs);return{kind:`unknown`,command:i,commandPath:o.chain.join(` `),unknownFlags:c.map(e=>l.get(e)??formatFlagToken(e)),accepted:s.acceptedFlags}}function formatUnknownFlagsMessage(e){let t=`Unknown ${e.unknownFlags.length===1?`flag`:`flags`} ${e.unknownFlags.join(`, `)} for ${e.commandPath}. Nothing ran.`,n=M.filter(t=>t.startsWith(`--`)&&t!==`--version`&&!e.accepted.includes(t));return`${t}\nAccepted: ${n.length===0?e.accepted.join(`, `):`${e.accepted.join(`, `)} (plus ${n.join(`, `)})`}.`}function formatFlagBeforeCommandMessage(e){return`${e.flag} must come after the command name.`}function formatNotADirectoryMessage(e){return`${e.missing?`No such directory: ${e.value}.`:`${e.value} is not a directory.`} ${e.commandPath} takes a directory as [${e.argName}]. Nothing ran.`}function formatFlagCheckMessage(e){return e.kind===`before-command`?formatFlagBeforeCommandMessage(e):e.kind===`not-a-directory`?formatNotADirectoryMessage(e):formatUnknownFlagsMessage(e)}function collectFlagValues(e,t){let n=`${t}=`,r=[];for(let i=0;i<e.length;i+=1){let a=e[i];if(a!==void 0){if(a===`--`)break;if(a===t){let t=e[i+1];t!==void 0&&(r.push(t),i+=1)}else a.startsWith(n)&&r.push(a.slice(n.length))}}return r.map(e=>e.trim()).filter(e=>e!==``)}function hasNegationFlag(e,t){for(let n of e){if(n===`--`)break;if(n===t)return!0}return!1}function flagPresent(e,t){for(let n of e){if(n===`--`)break;if(n===t||n.startsWith(`${t}=`))return!0}return!1}function resolveRepeatableFlag(e,t,n,r){let i=collectFlagValues(e,t),a=hasNegationFlag(e,n);if(i.length>0&&a)throw new u(`${t} and ${n} are contradictory -- pass only one.`);if(i.length===0&&flagPresent(e,t)){let e=r.fallback===void 0?``:` Refusing rather than falling back to ${r.fallback}.`;throw new u(`${t} was given with no ${r.noun} (expected e.g. ${t} ${r.example}).${e}`)}return a?{kind:`negated`}:i.length>0?{kind:`values`,values:i}:{kind:`absent`}}const ne=/^(\d+)(s|m|h)?$/,re={s:1e3,m:6e4,h:36e5};function parseDuration(e,t){let n=ne.exec(e.trim());if(!n)throw new u(`${t} expects a duration like "30s", "15m", or "1h" (a bare integer means seconds) -- got ${JSON.stringify(e)}.`);let[,r,i]=n,a=re[i??`s`];return Number.parseInt(r??`0`,10)*a}function parseListFlag(e,t){let n=`--${t}`,r=[];for(let[t,i]of e.entries()){if(i===`--`)break;if(i.startsWith(`${n}=`)){r.push(i.slice(n.length+1));continue}if(i!==n)continue;let a=e[t+1];a!==void 0&&!a.startsWith(`--`)&&r.push(a)}return r.flatMap(e=>e.split(`,`)).map(e=>e.trim()).filter(e=>e.length>0)}function listFlagPresent(e,t){let n=`--${t}`;return e.some(e=>e===n||e.startsWith(`${n}=`))}function parseLimitFlag(e){let t=Number(e);if(!Number.isInteger(t)||t<1)throw new u(`--limit must be a positive integer, got "${e}"`);return t}const stdout=e=>console.log(e);function initialState(){return{payload:void 0,hasPayload:!1,error:void 0,hasError:!1,notices:[],wrote:!1}}let P=initialState();function isJsonRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function isStringArray(e){return Array.isArray(e)&&e.every(e=>typeof e==`string`)}function createCliOutput(e){let t=e||isJsonMode();return{json:e=>{t&&(P.hasPayload&&j.debug(`output: a second json() call overwrote the first -- last call wins.`),P.payload=e,P.hasPayload=!0)},text:e=>{t||stdout(e)},notice:e=>{t?P.notices.push(h(e)):stdout(e)}}}function recordJsonError(e){P.error=e,P.hasError=!0}function buildFlushDocument(){let e;if(P.hasError?e=P.error:P.hasPayload&&(e=P.payload),e!==void 0){if(P.notices.length===0)return e;if(isJsonRecord(e)){let{notices:t}=e;return{...e,notices:isStringArray(t)?[...t,...P.notices]:P.notices}}return{payload:e,notices:P.notices}}}function flushJsonOutput(){let e=buildFlushDocument();return e!==void 0&&(stdout(JSON.stringify(e)),P.wrote=!0,!0)}function jsonDocumentWritten(){return P.wrote}function probeCliPath(e){try{let t=r(e,{throwIfNoEntry:!1});return t===void 0?`missing`:t.isDirectory()?`directory`:`file`}catch{return`missing`}}function classifyWithHook(e,t,n){let r=classifyThrown(e,t),i=n?.(e);return i===void 0?r:{...r,message:m(i)}}function drain(e){return new Promise(t=>{e.write(``,()=>t())})}function applyVerbosityFromArgs(e){setLogLevel(resolveLogLevel({verbose:e.includes(`--verbose`)||e.includes(`-v`),trace:e.includes(`--trace`)}))}function guardCommand(e,t,n){let{run:r,subCommands:i}=e,a={...e};return r!==void 0&&(a.run=async e=>{try{return await r(e)}catch(e){if(!(!t&&e instanceof Error&&(e.name===`FatalError`||e.name===`TransientError`)))throw e;console.error(classifyWithHook(e,!1,n).message),process.exitCode=1;return}}),i!==void 0&&(a.subCommands=async()=>{let e=typeof i==`function`?await i():await i,r={};for(let[i,a]of Object.entries(e))r[i]=async()=>guardCommand(typeof a==`function`?await a():await a,t,n);return r}),a}function firstSentence(e){let t=/^[\s\S]*?\.(?=\s+[A-Z])/.exec(e);return t===null?e:t[0]}async function renderTableUsage(e,t){return v(shortenChildren(e),t)}function shortenChildren(e){let{subCommands:t}=e;return t===void 0?e:{...e,subCommands:async()=>{let e=typeof t==`function`?await t():await t,n={};for(let[t,r]of Object.entries(e))n[t]=async()=>{let e=typeof r==`function`?await r():await r,t=typeof e.meta==`function`?await e.meta():await e.meta,n=t?.description;return{...shortenChildren(e),meta:{...t,...n===void 0?{}:{description:firstSentence(n).replace(/\s+/g,` `)}}}};return n}}}async function showTableUsage(e,t){console.log(await renderTableUsage(e,t)+`
|
|
4
|
+
`)}async function runCli(e){let t=e.subCommands,n=_({meta:{name:e.name,version:e.version,description:e.description},subCommands:t}),exitWithJsonError=async(t,n,r,i)=>{recordJsonError(buildErrorDocument({command:t,version:e.version,kind:n,message:r,detail:i})),(process.exitCode??0)===0&&(process.exitCode=1),flushJsonOutput(),await Promise.all([drain(process.stdout),drain(process.stderr)]),process.exit(process.exitCode??0)},r=process.argv.slice(2);applyVerbosityFromArgs(r);let i=resolveCommandName(r);if(!resolveJsonMode(r)){let i=findUnknownFlags(r,t,probeCliPath);i.kind!==`none`&&(console.error(formatFlagCheckMessage(i)),process.exitCode=1,await Promise.all([drain(process.stdout),drain(process.stderr)]),process.exit(process.exitCode??0)),e.banner!==void 0&&console.error(e.banner),await b(guardCommand(n,verboseRequested(r),e.describeError),{showUsage:showTableUsage}),await Promise.all([drain(process.stdout),drain(process.stderr)]),process.exit(process.exitCode??0)}setJsonMode(!0),setJsonNoticeSink(e=>createCliOutput(!0).notice(e)),installJsonExitNet(e.name,i,e.version,jsonDocumentWritten);let a=findUnknownFlags(r,t,probeCliPath);a.kind!==`none`&&await exitWithJsonError(a.command,`usage`,formatFlagCheckMessage(a));let o=asCommandDef(i!==void 0&&i in t?t[i]:void 0);if(i===void 0||o===void 0||!commandDeclaresJson(o)){let e;e=i===void 0?`No command specified.`:o===void 0?`Unknown command ${i}.`:`Command ${i} does not support --json.`,await exitWithJsonError(i,`usage`,e)}try{await y(n,{rawArgs:r})}catch(t){let n=classifyWithHook(t,verboseRequested(r),e.describeError);await exitWithJsonError(i,n.kind,n.message,n.detail)}flushJsonOutput()||await exitWithJsonError(i,`runtime`,`${i} --json completed without recording a JSON payload. This is a bug in the command's --json support -- it does not necessarily mean the command's underlying action failed.`),await Promise.all([drain(process.stdout),drain(process.stderr)]),process.exit(process.exitCode??0)}let F={warn(e){process.stderr.write(`${e}\n`)},debug(){}};function setForgejoLogger(e){F=e}const I={warn(e){F.warn(e)},debug(e){F.debug(e)}};function parseGitUrl(e){try{let t=new URL(e),n=t.pathname.replace(/\.git$/,``).replace(/^\//,``);return n.includes(`/`)?{protocol:t.protocol,hostname:t.hostname,repository:n}:null}catch{return null}}function forgeTokenFromEnv(e){return e.RELEASE_TOKEN||e.FORGEJO_TOKEN}function resolveRepoUrlFrom(e,t){let n=normalizeGitUrl(e()??``);if(n!==null&&parseGitUrl(n)!==null)return n;let r=t();return r===null||parseGitUrl(r)===null?null:normalizeGitUrl(r)}function resolveForgejoConnection(e,t){let n=e.FORGEJO_SERVER_URL,r=e.FORGEJO_REPOSITORY,i=forgeTokenFromEnv(e);if(n&&r&&i)return{serverUrl:n,repository:r,token:i};let a=t(),o=a===null?null:parseGitUrl(a);if(o===null){if(n){if(!r)throw new u(`FORGEJO_REPOSITORY environment variable is required`);if(!i)throw new u(`RELEASE_TOKEN environment variable is required`)}return null}if(o.hostname===`github.com`)return null;if(!i)throw new u(`RELEASE_TOKEN environment variable is required (server URL and repository were resolved from package.json)`);return{serverUrl:n??`${o.protocol}//${o.hostname}`,repository:r??o.repository,token:i}}const ie=/^\/([^/]+\/[^/]+)\/(?:issues|pulls?)\/(\d+)\/?$/;function parseIssueRef(e){if(e===void 0||e.trim()===``)return{};let t=e.trim();if(/^\d+$/.test(t))return{number:Number.parseInt(t,10)};let n;try{n=new URL(t)}catch{n=void 0}if(n!==void 0&&n.protocol!==`http:`&&n.protocol!==`https:`)throw new u(`Not an issue number or issue URL: "${t}" (expected e.g. 273 or https://host/owner/repo/issues/273)`);if(n!==void 0){let e=ie.exec(n.pathname);if(e){let[,t,r]=e;if(t!==void 0&&r!==void 0)return{number:Number.parseInt(r,10),target:{serverUrl:n.origin,repository:t,hostname:n.hostname}}}}throw new u(`Not an issue number or issue URL: "${t}" (expected e.g. 273 or https://host/owner/repo/issues/273)`)}var RepoTargetEmptyError=class extends u{constructor(){super(`No repository URL was given.`)}},RepoTargetMismatchError=class extends u{given;fromReference;constructor(e,t){super(`The repository (${e}) and the issue URL (${t}) disagree.`),this.given=e,this.fromReference=t}};function parseRepoTarget(e){if(e===void 0)return;if(e.trim()===``)throw new RepoTargetEmptyError;let t=/^(https?:\/\/[^/]+)\/([^/]+\/[^/]+?)(?:\.git)?\/?$/.exec(e.trim());if(!t)throw new u(`Not a repository URL: "${e}"`);let[,n,r]=t;if(n===void 0||r===void 0)throw new u(`Not a repository URL: "${e}"`);return{serverUrl:n,repository:r,hostname:new URL(n).hostname}}function resolveIssueTarget(e,t){let n=parseRepoTarget(t);if(e===void 0)return n;if(n===void 0||e.serverUrl===n.serverUrl&&e.repository===n.repository)return e;throw new RepoTargetMismatchError(`${n.serverUrl}/${n.repository}`,`${e.serverUrl}/${e.repository}`)}function normalizeGitUrl(e){let t=e.startsWith(`git+`)?e.slice(4):e,n=t.match(/^git@([^:]+):(.+?)(?:\.git)?$/);if(n)return`https://${n[1]}/${n[2]}`;try{let e=new URL(t);return e.pathname=e.pathname.replace(/\.git$/,``),e.username=``,e.password=``,e.toString().replace(/\/$/,``)}catch{return null}}function describeForgeError(e){if(e instanceof RepoTargetEmptyError)return`--repo was given with no repository URL (expected e.g. https://host/owner/repo).`;if(e instanceof RepoTargetMismatchError)return`--repo disagrees with the issue URL: --repo names ${e.given}, the issue URL names ${e.fromReference}.`}const L={attempts:5,baseDelayMs:250,maxDelayMs:2e3};function isTransientTransportError(e){return e instanceof TypeError||e instanceof DOMException&&(e.name===`TimeoutError`||e.name===`AbortError`)}function withTimeoutSignal(e,t){if(t<=0)return e;let n=AbortSignal.timeout(t);return e?.signal==null?{...e,signal:n}:{...e,signal:AbortSignal.any([e.signal,n])}}async function retryBackoff(e,t,n){if(t<=0)return;let r=Math.min(t*2**(e-1),n);await new Promise(e=>setTimeout(e,r))}async function retryOnTransient(e,t=L,n=null){let r;for(let i=1;i<=t.attempts;i++)try{return await e()}catch(e){if(n?.aborted||!isTransientTransportError(e))throw e;r=e,i<t.attempts&&await retryBackoff(i,t.baseDelayMs,t.maxDelayMs)}throw r}function fetchWithRetry(e,t=L,n=12e4){return(r,i,a)=>{let o=(i?.method??`GET`).toUpperCase(),s=o===`GET`||o===`HEAD`||a?.idempotent===!0,c=a?.timeoutMs??n,l=i?.signal??null,attempt=()=>e(r,withTimeoutSignal(i,c));return s?retryOnTransient(attempt,a?.attempts===void 0?t:{...t,attempts:a.attempts},l):attempt()}}function createForgeFetcher(e=L){return{fetch:fetchWithRetry((e,t)=>globalThis.fetch(e,t),e)}}function cliFetcher(){return createForgeFetcher()}var ForgeAccessError=class extends u{};function authHeaders(e){return{Authorization:`token ${e.token}`}}function jsonHeaders(e){return{...authHeaders(e),"Content-Type":`application/json`}}function repoNotFoundMessage(e){return`Repository ${e.repository} not found (or the token cannot see it)`}function repoBase(e){return`${e.serverUrl}/api/v1/repos/${e.repository}`}function issuesBase(e){return`${repoBase(e)}/issues`}function issueNotFoundMessage(e,t){return`Issue #${String(t)} not found in ${e.repository}`}const R=g.object({id:g.number(),name:g.string(),size:g.number(),created_at:g.string(),browser_download_url:g.string()}),ae=g.array(R);function normalizeAttachment(e){return{id:e.id,name:e.name,size:e.size,createdAt:e.created_at,downloadUrl:e.browser_download_url}}async function responseBodyText(e){try{let t=await e.text(),n=t.length>500?t.slice(0,500)+`...`:t;return m(n)}catch{return`(could not read response body)`}}const oe=g.union([g.object({message:g.literal(``)}),g.object({message:g.string(),url:g.string().regex(/\/api\/swagger$/)})]);function isForgejoGenericServerErrorBody(e){if(e===``)return!0;try{let t=JSON.parse(e);return oe.safeParse(t).success}catch{return!1}}const se=/\bdispatch\b/i;function forgejoErrorHint(e,t,n){let r=se.test(n.verb),i=n.resource??`the resource`;if(e===401||e===403)return`Forgejo rejected the token. It needs the scope required for "${n.verb}" on ${i}.`;if(e===404){let e=`"${i}" was not found on the server. Verify the name${n.ref?`, that it exists on ${n.ref}`:``}, and that the token can see it.`;return r?`${e} For dispatch, also confirm the workflow has an "on: workflow_dispatch:" trigger.`:e}if(e===400||e===422){let e=`Forgejo rejected the request payload for "${n.verb}". Check for missing or invalid fields.`;return r?`${e} For dispatch, common causes are a missing "on: workflow_dispatch:" trigger or a required input not being provided.`:e}if(e>=500&&e<600){if(isForgejoGenericServerErrorBody(t)){let e=n.ref?` on ${n.ref}`:``;return`Forgejo returned a generic server error. Most often this means the requested route is unavailable${r?` (e.g. "${i}" doesn't exist${e}, or the workflow lacks an "on: workflow_dispatch:" trigger)`:``}. Less commonly: the token lacks scope, or it is a server-side bug.`}return`Forgejo server error -- usually transient. Retry; if it persists, check the server logs.`}return``}async function forgejoErrorMessage(e,t){let n=await responseBodyText(e),r=forgejoErrorHint(e.status,n,t);return`Failed to ${t.verb} on Forgejo: ${String(e.status)} ${e.statusText}`+(r?`\nHint: ${r}`:``)+(n?`\nResponse: ${n}`:``)}async function throwForgejoFailure(e,t,n){if(e.status===404)throw new ForgeAccessError(n??await forgejoErrorMessage(e,t));let r=await forgejoErrorMessage(e,t);throw e.status===401||e.status===403?new ForgeAccessError(r):e.status===422?new u(`${r}\nForgejo rejected this as invalid (422) -- retrying with the same input cannot succeed (e.g. a nonexistent label or an assignee the repository will not accept).`):e.status===410?new u(`${r}\nForgejo returned 410 Gone -- issues are likely disabled on this repository; retrying will not help.`):new d(r)}const ce=g.object({state:g.string(),statuses:g.array(g.unknown())}),le=g.object({context:g.string().nullish(),status:g.string().nullish(),description:g.string().nullish(),target_url:g.string().nullish(),updated_at:g.string().nullish(),id:g.number().nullish()}),ue=/ \([^()]+\)$/;function classifyVerdict(e){return e===`success`?`good`:e===`pending`?`pending`:e===`skipped`||e===`neutral`?`skipped`:`red`}function entryKey(e,t){return typeof e.context==`string`&&e.context.length>0?e.context:`#${String(t)}`}function updatedAtMillis(e){if(!e)return 0;let t=Date.parse(e);return Number.isNaN(t)?0:t}function dedupeEntries(e){let t=/* @__PURE__ */ new Map;e.forEach((e,n)=>{let r=entryKey(e,n),i=t.get(r);if(!i){t.set(r,{entry:e,index:n});return}let a=updatedAtMillis(i.entry.updated_at),o=updatedAtMillis(e.updated_at);if(o>a)t.set(r,{entry:e,index:n});else if(o===a){let a=i.entry.id??-1/0;(e.id??-1/0)>a&&t.set(r,{entry:e,index:n})}});let n=[...t.values()];return n.sort((e,t)=>e.index-t.index),n}async function readCommitChecks(e,t,n){let r=`${t.serverUrl}/api/v1/repos/${t.repository}/commits/${n}/status`,i=await e.fetch(r,{headers:{Authorization:`token ${t.token}`}});i.ok||await throwForgejoFailure(i,{verb:`read commit status`,resource:n});let a=await i.json(),o=ce.safeParse(a);if(!o.success)return{parsed:!1,state:``,green:!1,contexts:[]};let s=o.data.state===`success`&&o.data.statuses.length>0,c={context:null,status:null,description:null,target_url:null,updated_at:null,id:null},l=dedupeEntries(o.data.statuses.map(e=>{let t=le.safeParse(e);return t.success?t.data:c})).map(({entry:e})=>{let t=e.context??``;return{context:t,name:t.replace(ue,``),state:e.status??``,verdict:classifyVerdict(e.status),description:e.description??null,targetUrl:e.target_url??null,updatedAt:e.updated_at??null}});return{parsed:!0,state:o.data.state,green:s,contexts:l}}g.object({default_branch:g.string()});const de=g.object({commit:g.object({id:g.string()})});g.object({total_commits:g.number(),commits:g.array(g.unknown())}),g.object({sha:g.string()}),g.object({sha:g.string(),created:g.string()}),g.array(g.unknown());function branchNotFoundMessage(e,t){return`Branch ${t} not found in ${e.repository}`}g.object({full_name:g.string()}),g.object({description:g.string().optional()});async function getBranchHeadSha(e,t,n){let r=`${repoBase(t)}/branches/${encodeURIComponent(n)}`,i=await e.fetch(r,{headers:authHeaders(t)});i.ok||await throwForgejoFailure(i,{verb:`read branch`,resource:n},branchNotFoundMessage(t,n));let a=de.safeParse(await i.json());if(!a.success)throw new f(`Unexpected branch response: ${a.error.message}`);return a.data.commit.id}async function branchExists(e,t,n){let r=`${repoBase(t)}/branches/${encodeURIComponent(n)}`,i=await e.fetch(r,{headers:authHeaders(t)});return i.status!==404&&(i.ok||await throwForgejoFailure(i,{verb:`check branch`,resource:n},branchNotFoundMessage(t,n)),!0)}function defaultGitRunner(e,t,n){try{let r=x(`git`,e,{cwd:t,stdio:[`ignore`,`pipe`,`ignore`],timeout:n?.timeoutMs}).toString(`utf-8`).trim();return r===``?void 0:r}catch{return}}function resolveCurrentBranch(e){let t=e.env??process.env,n=t.GITHUB_REF;if(n!==void 0&&n!==``){if(!n.startsWith(`refs/heads/`))return;let e=t.GITHUB_REF_NAME;return e!==void 0&&e!==``?e:n.slice(11)}let r=(e.git??defaultGitRunner)([`rev-parse`,`--abbrev-ref`,`HEAD`],e.cwd);if(r!==void 0&&r!==`HEAD`)return r}function readOriginUrl(e,t=defaultGitRunner){return t([`remote`,`get-url`,`origin`],e,{timeoutMs:5e3})??null}const fe=g.union([g.string(),g.object({url:g.string()})]);function readPackageRepositoryUrl(e){let t=o.join(e,`package.json`),r;try{r=n(t,`utf-8`)}catch{return null}let i;try{i=JSON.parse(r)}catch(e){throw new u(`${t} is not valid JSON: ${e instanceof Error?e.message:String(e)}`)}let a=g.object({repository:fe.optional()}).safeParse(i);if(!a.success)return null;let s=a.data.repository;return s?typeof s==`string`?s:s.url:null}function resolveRepoUrl(e){return resolveRepoUrlFrom(()=>readOriginUrl(e),()=>readPackageRepositoryUrl(e))}function requireForgejoTargetFromRepo(e,t,n,r=process.env){return requireForgejoTarget(e,parseRepoTarget(t),n,r)}function requireForgejoTarget(e,t,n,r=process.env){if(t!==void 0){if(t.hostname===`github.com`)throw new u(n);let e=forgeTokenFromEnv(r);if(!e)throw new u(`bst-fj needs a forge token -- set RELEASE_TOKEN (preferred) or FORGEJO_TOKEN.`);return{serverUrl:t.serverUrl,repository:t.repository,token:e}}let i=resolveForgejoConnection(r,()=>resolveRepoUrl(e));if(i===null)throw new u(n);return i}function classifyBaseStatus(e){return e.parsed?e.contexts.length===0?`no-status`:e.green?`green`:e.contexts.some(e=>e.verdict===`pending`)?`pending`:`red`:`unparseable`}function isSettled(e){return!e.parsed||e.contexts.length===0?!1:!e.contexts.some(e=>e.verdict===`pending`)}function disagreesWithCombinedState(e){if(!e.parsed||e.contexts.length===0)return!1;let t=e.contexts.every(e=>e.verdict===`good`||e.verdict===`skipped`);return e.green!==t}function pushDisagreementNotice(e,t,n){if(!disagreesWithCombinedState(n))return;let r=`The combined status ("${n.state}") for ${t} disagrees with this build's per-check classification -- the combined status wins the verdict.`;e.includes(r)||e.push(r)}const z={parsed:!1,state:``,green:!1,contexts:[]};async function readPollChecks(e,t,n){try{let r=await readCommitChecks(e,t,n);return r.parsed?{checks:r}:{failureDetail:`The commit status response did not match the shape this build expects.`}}catch(e){return{failureDetail:p(e)}}}async function settleChecks(e,t,n,r){let{timeoutMs:i,intervalMs:a,sleep:o,now:s}=n,c=s(),elapsed=()=>s()-c,l=0,u,d,f=null;for(;;){let n=r.sha(),{checks:s,failureDetail:c}=await readPollChecks(e,t,n);if(c!==void 0&&(u=c),s===void 0){if(l+=1,l>=3)return r.report(z,{exit:`retry-budget`,elapsed,failureDetail:u})}else if(l=0,d=s,r.observe?.(s),pushDisagreementNotice(r.notices,n,s),isSettled(s)){let e=new Set(s.contexts.map(e=>e.context));if(f!==null&&f.size===e.size&&[...f].every(t=>e.has(t)))return r.report(s,{exit:`settled`,elapsed});f=e}else f=null;if(elapsed()>=i)return r.report(d??z,{exit:`timeout`,elapsed});if(await o(a),r.afterSleep!==void 0){let e=await r.afterSleep(n,elapsed);if(e!==`retry`&&e!==`next`)return e.done}}}function renderCheckLine(e){let t=[e.state,e.context];e.description!==null&&t.push(e.description);let n=t.join(` -- `);return e.verdict===`red`&&e.targetUrl!==null&&(n+=` (${e.targetUrl})`),n}function envMsOverride(e,t){if(e===void 0)return t;let n=Number(e.trim());return!Number.isSafeInteger(n)||n<=0?t:Math.min(n,t)}function resolvePollTimings(e){let t=e.timeout===void 0?12e5:parseDuration(e.timeout,`--timeout`),n=e.interval===void 0?15e3:parseDuration(e.interval,`--interval`);return{timeoutMs:t,intervalMs:envMsOverride(process.env.BST_TEST_CHECK_POLL_INTERVAL_MS,Math.max(n,5e3))}}function sleep(e){return new Promise(t=>{setTimeout(t,e)})}async function resolveCommitStatusTarget(e,t){let n=parseRepoTarget(t.repo),r=requireForgejoTarget(t.cwd,n,"commit:status is Forgejo-only: GitHub Actions publishes check runs, not commit statuses. Use `gh run list` / `gh run view` instead."),i=t.ref!==void 0&&t.ref.trim()!==``?t.ref.trim():`HEAD`,a=i;if(!B.test(i)){if(n===void 0){let n=t.git??defaultGitRunner,o=i===`HEAD`?void 0:n([`rev-parse`,`--symbolic-full-name`,i],t.cwd);if(o!==void 0&&o.startsWith(`refs/heads/`))a=await forgeBranchHeadSha(e,r,i)??i;else{let o=n([`rev-parse`,`${i}^{commit}`],t.cwd);a=o!==void 0&&o.length===40?o:await forgeBranchHeadSha(e,r,i)??i}}else a=await forgeBranchHeadSha(e,r,i)??i}let o=B.test(a)?`commit`:`commits`,s=`${r.serverUrl}/${r.repository}/${o}/${a}`;return{conn:r,ref:i,sha:a,url:s}}const B=/^[0-9a-f]{40}$/;async function forgeBranchHeadSha(e,t,n){try{return await getBranchHeadSha(e,t,n)}catch(e){if(e instanceof ForgeAccessError)return;throw e}}function buildReport$1(e,t,n,r={}){let{notices:i,waited:a,elapsedMs:o}=n,s=r.statusOverride??classifyBaseStatus(t),c={sha:e.sha,ref:e.ref,repository:e.conn.repository,url:e.url,status:s,settled:isSettled(t),combinedState:t.state,waited:a,elapsedMs:o,checks:t.contexts.map(e=>({...e})),notices:i};return r.detailOverride===void 0?s===`unparseable`&&(c.detail=`The commit status response did not match the shape this build expects.`):c.detail=r.detailOverride,c}async function waitForSettledChecks$1(e,t,n,r){return settleChecks(e,t.conn,r,{sha:()=>t.sha,notices:n,report:(e,r)=>{let i={};return r.exit===`timeout`?i.statusOverride=`timeout`:r.exit===`retry-budget`&&(i.statusOverride=`unparseable`,r.failureDetail!==void 0&&(i.detailOverride=r.failureDetail)),buildReport$1(t,e,{notices:n,waited:!0,elapsedMs:r.elapsed()},i)}})}async function runCommitStatus(e,t){let n=t.wait===!0?resolvePollTimings(t):void 0,r=await resolveCommitStatusTarget(e,t),i=[];if(n!==void 0)return waitForSettledChecks$1(e,r,i,{...n,sleep:t.sleep??sleep,now:t.now??Date.now});let a=await readCommitChecks(e,r.conn,r.sha);return pushDisagreementNotice(i,r.sha,a),buildReport$1(r,a,{notices:i,waited:!1,elapsedMs:0})}function renderCommitStatus(e){let t=e.checks.map(renderCheckLine),n=B.test(e.sha)?e.sha.slice(0,12):e.sha,r=e.checks.filter(e=>e.verdict===`red`).length,i=e.checks.filter(e=>e.verdict===`pending`).length,a=e.checks.filter(e=>e.verdict===`good`).length,o=e.checks.filter(e=>e.verdict===`skipped`).length,s=[`commit ${n}: ${e.status}`,`${String(r)} red, ${String(i)} pending, ${String(a)} good, ${String(o)} skipped`,e.url];return t.push(s.join(` -- `)),t.join(`
|
|
5
|
+
`)}const V=_({meta:{name:`commit:status`,description:`Query Forgejo commit status checks for an arbitrary commit SHA, branch, tag, or local git ref. Unlike pr:checks, which requires an open PR, commit:status inspects commit checks directly. Exits 0 only when status is green.`},args:{ref:{type:`positional`,description:`Commit SHA, branch, tag, or git ref (default: HEAD)`,required:!1},repo:{type:`string`,description:`Repository URL (default: this repo)`},wait:{type:`boolean`,description:`Poll until every check for the commit has settled`},timeout:{type:`string`,description:`--wait's give-up duration, e.g. 20m (default: 20m). Checked once per poll, so a wait can run up to one --interval past it.`},interval:{type:`string`,description:`--wait's poll interval, e.g. 15s (default: 15s, floored at 5s)`},json:{type:`boolean`,description:`Emit one JSON document: sha, ref, repository, url, status (green | red | pending | no-status | unparseable | timeout), settled, combinedState, waited, elapsedMs, checks ([{context, name, state, verdict, description (or null), targetUrl (or null), updatedAt (or null)}]), detail? (unparseable only). no-status means no check was posted and is never green.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=await runCommitStatus(cliFetcher(),{cwd:process.cwd(),ref:e.ref,repo:e.repo,wait:e.wait===!0,timeout:e.timeout,interval:e.interval}),{notices:r,...i}=n;for(let e of r)t.notice(e);t.json(i),t.text(renderCommitStatus(n)),process.exitCode=n.status===`green`?0:1}}),pe=/(?:^|[\s([])(clos(?:e|es|ed)|fix(?:es|ed)?|resolv(?:e|es|ed))(?::[ \t]*|[ \t]+)((?:[\w.-]+\/[\w.-]+)?#\d+)(?![\w-])/gim;function capitalize(e){return e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()}function extractClosingRefs(e){let t=/* @__PURE__ */ new Map;for(let n of e)for(let[,e,r]of n.matchAll(pe)){if(e===void 0||r===void 0)continue;let n=r.toLowerCase();t.has(n)||t.set(n,{text:`${capitalize(e)} ${r}`,issue:r})}return[...t.values()]}function closedIssues(e){return new Set(extractClosingRefs([e]).map(e=>e.issue.toLowerCase()))}function droppedClosingRefs(e,t){let n=closedIssues(t);return extractClosingRefs(e).filter(e=>!n.has(e.issue.toLowerCase()))}function carryForwardClosingRefs(e,t){let n=droppedClosingRefs([e],t);if(n.length===0)return t;let r=n.map(e=>e.text).join(`
|
|
6
|
+
`);return t.trim()===``?r:`${t}\n\n${r}`}function parseIssueList(e){let t=/* @__PURE__ */ new Set;for(let n of e.split(`,`)){let r=/^#?([1-9]\d*)$/.exec(n.trim());if(r?.[1]===void 0)throw new u(`--closes takes issue numbers separated by commas, such as 12 or 12,15; got ${JSON.stringify(e)}.`);t.add(Number(r[1]))}return[...t]}function morePagesFollow(e,t,n,r){if(t===0)return!1;let i=e.headers.get(`x-total-count`)?.trim()??``,a=i===``?NaN:Number(i);return!Number.isSafeInteger(a)||a<0?t>=r:n<a}const H=g.object({id:g.number(),name:g.string(),color:g.string().optional(),description:g.string().optional(),exclusive:g.boolean().optional()}),me=g.array(H);async function fetchAllForgejoLabels(e,t){let n=[];for(let r=1;r<=20;r++){let i=await e.fetch(`${t.serverUrl}/api/v1/repos/${t.repository}/labels?limit=50&page=${String(r)}`,{headers:authHeaders(t)});i.ok||await throwForgejoFailure(i,{verb:`list labels`,resource:t.repository},repoNotFoundMessage(t));let a=me.safeParse(await i.json());if(!a.success)throw new f(`Unexpected label-list response: ${a.error.message}`);if(n.push(...a.data),!morePagesFollow(i,a.data.length,n.length,50))break}return n}async function resolveLabelIds(e,t,n){if(n.length===0)return[];let r=await fetchAllForgejoLabels(e,t);return n.map(e=>{let n=r.find(t=>t.name===e);if(n===void 0){let n=r.map(e=>e.name).join(`, `);throw new u(`No label named "${e}" found among the repository's labels in ${t.repository} (organization-level labels are not searched). Known labels: ${n}`)}return n.id})}function isRetiringExpired(e,t){return t>e.until}function retiringAsLabelSpec(e){return{name:e.name,color:e.color,description:e.description,exclusive:!1}}const he=g.strictObject({name:g.string().min(1),color:g.string().regex(/^#[0-9a-fA-F]{6}$/),description:g.string(),exclusive:g.boolean().optional()}),ge=g.record(g.string(),g.array(he));function normalizeColor(e){return e.replace(/^#/,``).toLowerCase()}function hasCosmeticDrift(e,t){return normalizeColor(e.color??``)!==normalizeColor(t.color)||(e.description??``)!==t.description}function isNonExclusive(e,t){return(t.exclusive??!1)&&!(e.exclusive??!1)}function isExclusivityDrifted(e,t){return(e.exclusive??!1)!==(t.exclusive??!1)}async function auditForgejoLabels(e,t,n){let r=await fetchAllForgejoLabels(e,t),i=new Map(r.map(e=>[e.name,e])),a=new Map(r.map(e=>[e.name,e.id])),o=[],s=[],c=[],l=[];for(let e of n){let t=i.get(e.name);t===void 0?o.push(e.name):(isNonExclusive(t,e)&&s.push(e.name),isExclusivityDrifted(t,e)&&c.push(e.name),hasCosmeticDrift(t,e)&&l.push(e.name))}return{labelIds:a,missing:o,nonExclusive:s,exclusivityDrift:c,cosmeticDrift:l}}function labelScope(e){let t=e.indexOf(`/`);return t===-1?null:e.slice(0,t+1)}function staleLabelNames(e,t,n=[]){let r=/* @__PURE__ */ new Set;for(let t of e){let e=labelScope(t.name);e!==null&&r.add(e)}let i=new Set(e.map(e=>e.name));for(let e of n)i.add(e.name);let a=[];for(let e of t){if(i.has(e))continue;let t=labelScope(e);t!==null&&r.has(t)&&a.push(e)}return a.sort((e,t)=>e.localeCompare(t)),a}async function ensureForgejoLabels(e,t,n){let r=await auditForgejoLabels(e,t,n),i=new Map(r.labelIds),a=new Set(r.missing),o=/* @__PURE__ */ new Set([...r.exclusivityDrift,...r.cosmeticDrift]),s=`${t.serverUrl}/api/v1/repos/${t.repository}/labels`;for(let r of n)if(a.has(r.name)){let n=await e.fetch(s,{method:`POST`,headers:jsonHeaders(t),body:JSON.stringify({name:r.name,color:r.color,description:r.description,exclusive:r.exclusive??!1})});n.ok||await throwForgejoFailure(n,{verb:`create label`,resource:r.name},repoNotFoundMessage(t));let a=H.safeParse(await n.json());if(!a.success)throw new f(`Unexpected label-create response: ${a.error.message}`);i.set(r.name,a.data.id)}else if(o.has(r.name)){let n=i.get(r.name);if(n===void 0)throw new f(`Audit reported drift for "${r.name}" with no known id`);let a=await e.fetch(`${s}/${String(n)}`,{method:`PATCH`,headers:jsonHeaders(t),body:JSON.stringify({name:r.name,color:r.color,description:r.description,exclusive:r.exclusive??!1})});a.ok||await throwForgejoFailure(a,{verb:`update label`,resource:r.name},repoNotFoundMessage(t))}return i}async function deleteForgejoLabel(e,t,n){let r=await e.fetch(`${t.serverUrl}/api/v1/repos/${t.repository}/labels/${String(n)}`,{method:`DELETE`,headers:authHeaders(t)},{idempotent:!0});r.ok||await throwForgejoFailure(r,{verb:`delete label`,resource:String(n)},repoNotFoundMessage(t))}const U=g.object({number:g.number(),title:g.string(),state:g.string(),html_url:g.string(),body:g.string().nullish(),user:g.object({login:g.string()}).nullish(),labels:g.array(g.object({name:g.string()})).nullish(),assignees:g.array(g.object({login:g.string()})).nullish(),created_at:g.string(),updated_at:g.string(),closed_at:g.string().nullish(),pull_request:g.unknown().nullish(),assets:g.array(R).nullish()}),_e=g.array(U);function parseIssueOrThrow(e){let t=U.safeParse(e);if(!t.success)throw new f(`Unexpected issue response: ${t.error.message}`);return t.data}function parseIssueListOrThrow(e){let t=_e.safeParse(e);if(!t.success)throw new f(`Unexpected issue-list response: ${t.error.message}`);return t.data}function normalizeIssue(e){return{number:e.number,title:e.title,state:e.state,url:e.html_url,author:e.user?.login??``,labels:(e.labels??[]).map(e=>e.name),createdAt:e.created_at,updatedAt:e.updated_at,closedAt:e.closed_at??null,body:e.body??``,isPullRequest:e.pull_request!==null&&e.pull_request!==void 0,attachments:(e.assets??[]).map(normalizeAttachment),assignees:(e.assignees??[]).map(e=>e.login)}}async function getForgejoIssue(e,t,n){let r=await e.fetch(`${issuesBase(t)}/${String(n)}`,{headers:authHeaders(t)});return r.ok||await throwForgejoFailure(r,{verb:`get issue`,resource:`#${String(n)}`},issueNotFoundMessage(t,n)),normalizeIssue(parseIssueOrThrow(await r.json()))}const ve=g.object({number:g.number(),state:g.string(),repository:g.object({full_name:g.string()}).nullish()});g.array(ve);function issueListParams(e,t){let n=t.type??e,r=new URLSearchParams(n===`all`?{}:{type:n});return r.set(`state`,t.state),r.set(`limit`,String(t.limit)),t.label!==void 0&&r.set(`labels`,t.label),t.page!==void 0&&r.set(`page`,String(t.page)),t.since!==void 0&&r.set(`since`,t.since),t.sort!==void 0&&r.set(`sort`,t.sort),t.q!==void 0&&r.set(`q`,t.q),r}async function fetchIssueListPage(e,t,n){let r=await e.fetch(`${issuesBase(t)}?${n.toString()}`,{headers:authHeaders(t)});return r.ok||await throwForgejoFailure(r,{verb:`list issues`,resource:t.repository},repoNotFoundMessage(t)),{raw:parseIssueListOrThrow(await r.json()),res:r}}function normalizeDetailedIssues(e,t){let n=e.map(normalizeIssue);return t===`issues`?n.filter(e=>!e.isPullRequest):n}async function listForgejoIssuesDetailedPaged(e,t,n,r){let i=[];for(let a=1;a<=20;a++){let{raw:o}=await fetchIssueListPage(e,t,issueListParams(n.type,{...n,limit:50,page:a}));if(i.push(...normalizeDetailedIssues(o,n.type)),o.length===0||i.length>=n.limit)break;a===20&&(I.warn(`Detailed issue listing on ${t.repository} hit the 20-page cap without an empty page; results may be truncated`),r?.onPageCap?.())}return i}async function listOpenObjectsWithLabel(e,t,n){let r=[];for(let i=1;i<=20;i++){let{raw:a}=await fetchIssueListPage(e,t,issueListParams(`all`,{state:`open`,label:n,limit:50,page:i}));for(let e of a.map(normalizeIssue))e.labels.includes(n)&&r.push({number:e.number,kind:e.isPullRequest?`pull`:`issue`,title:e.title,url:e.url});if(a.length===0)break;i===20&&I.warn(`Open-object listing on ${t.repository} hit the 20-page cap without an empty page; results may be truncated`)}return r}const ye=g.object({full_name:g.string(),default_branch:g.string().nullish(),archived:g.boolean().nullish(),permissions:g.object({push:g.boolean().optional(),admin:g.boolean().optional()}).nullish()}),be=g.array(ye);async function fetchAccessibleRepos(e,t,n){let r={Authorization:`token ${n}`},i=[];for(let n=1;n<=20;n++){let a=new URLSearchParams({limit:`50`,page:String(n)}),o=await e.fetch(`${t}/api/v1/user/repos?${a.toString()}`,{headers:r});o.ok||await throwForgejoFailure(o,{verb:`list repositories`,resource:t},`Repository listing failed on ${t} (or the token cannot see any repositories)`);let s=be.safeParse(await o.json());if(!s.success)throw new f(`Unexpected user-repos response: ${s.error.message}`);for(let e of s.data)i.push({fullName:e.full_name,canWrite:e.permissions?.push===!0||e.permissions?.admin===!0,defaultBranch:e.default_branch??null,archived:e.archived===!0});if(s.data.length===0)break;n===20&&I.warn(`Repository listing on ${t} hit the 20-page cap without an empty page; results may be truncated`)}return i}async function createForgejoIssue(e,t,n){let r=[],i=[];for(let e of n.labels){let t=n.labelIds?.get(e);t===void 0?i.push(e):r.push(t)}i.length>0&&r.push(...await resolveLabelIds(e,t,i));let a={title:n.title,body:n.body,...r.length>0?{labels:r}:{},...n.assignees!==void 0&&n.assignees.length>0?{assignees:n.assignees}:{}},o=await e.fetch(issuesBase(t),{method:`POST`,headers:jsonHeaders(t),body:JSON.stringify(a)});return o.ok||await throwForgejoFailure(o,{verb:`create issue`,resource:n.title},repoNotFoundMessage(t)),normalizeIssue(parseIssueOrThrow(await o.json()))}async function updateForgejoIssue(e,t,n,r){let i=await e.fetch(`${issuesBase(t)}/${String(n)}`,{method:`PATCH`,headers:jsonHeaders(t),body:JSON.stringify({title:r.title,body:r.body})},{idempotent:!0});return i.ok||await throwForgejoFailure(i,{verb:`update issue`,resource:`#${String(n)}`},issueNotFoundMessage(t,n)),normalizeIssue(parseIssueOrThrow(await i.json()))}async function setForgejoIssueState(e,t,n,r){let i=await e.fetch(`${issuesBase(t)}/${String(n)}`,{method:`PATCH`,headers:jsonHeaders(t),body:JSON.stringify({state:r})},{idempotent:!0});return i.ok||await throwForgejoFailure(i,{verb:r===`closed`?`close issue`:`reopen issue`,resource:`#${String(n)}`},issueNotFoundMessage(t,n)),normalizeIssue(parseIssueOrThrow(await i.json()))}function resolveSyncMode(e,t){return e?`check`:t?`dry-run`:`apply`}function targetConnection(e,t){return t===void 0?e:{...e,repository:t}}async function resolveFleetTargets(e,t){return(await fetchAccessibleRepos(e,t.serverUrl,t.token)).filter(e=>e.canWrite).map(e=>targetConnection(t,e.fullName))}function outcomeFromAudit(e,t,n,r){let i=new Set(n.missing),a=/* @__PURE__ */ new Set([...n.exclusivityDrift,...n.cosmeticDrift]),o=t.map(e=>e.name).filter(e=>!i.has(e)&&!a.has(e));return{repository:e.repository,created:n.missing,updated:[...a],unchanged:o,...r}}async function checkPruneCandidate(e,t,n){let r;try{r=await listOpenObjectsWithLabel(e,t,n)}catch(e){return{ok:!1,reason:`could not check open objects: ${p(e)}`,objects:[]}}return r.length===0?{ok:!0}:{ok:!1,reason:`on ${String(r.length)} open object(s)`,objects:r}}async function syncOneRepo(e){let{fetcher:t,conn:n,specs:r,mode:i,prune:a,allowedPruneNames:o,resolveTargetSpecs:s,retiring:c,today:l}=e,u=s===void 0?{specs:r,omitted:[],aliasNames:[]}:await s(n,r),d=new Set(c.map(e=>e.name)),p=await auditForgejoLabels(t,n,[...u.specs,...c.map(retiringAsLabelSpec)]),m=c.filter(e=>p.labelIds.has(e.name)),h={...p,missing:p.missing.filter(e=>!d.has(e))},g=staleLabelNames(r,h.labelIds.keys(),c).filter(e=>!u.aliasNames.includes(e)),_=m.filter(e=>isRetiringExpired(e,l)).map(e=>e.name),v=a?[...u.omitted,...g,..._].filter(e=>h.labelIds.has(e)&&(o===void 0||o.includes(e))):[],y=[],b=[];for(let e of v){let r=await checkPruneCandidate(t,n,e);r.ok?y.push(e):b.push({name:e,reason:r.reason,objects:r.objects})}let x=[];for(let e of m)x.push({name:e.name,replacement:e.replacement,until:e.until,expired:isRetiringExpired(e,l),openObjects:await listOpenObjectsWithLabel(t,n,e.name)});let S=outcomeFromAudit(n,u.specs,h,{omitted:u.omitted,pruned:y,stale:a?g.filter(e=>!v.includes(e)):g,retiring:x,refused:b});if(i===`apply`){(S.created.length>0||S.updated.length>0)&&await ensureForgejoLabels(t,n,[...u.specs,...m.map(retiringAsLabelSpec)]);for(let e of y){let r=h.labelIds.get(e);if(r===void 0)throw new f(`Prune candidate "${e}" had no known id after the audit`);await deleteForgejoLabel(t,n,r)}}return S}async function syncLabelSet(e){let{fetcher:t,targets:n,specs:r,setName:i,mode:a,contained:o,prune:s,pruneAllowlist:c}=e,l=e.retiring??[],u=e.today??``;if(l.length>0&&e.today===void 0)throw new f("syncLabelSet was given retiring label specs but no `today` to compare their expiry against: an expired entry is a prune candidate, and a guessed date could delete a name whose retirement window is still open.");let d=[...r],m=[],h=[];for(let r of n){let n=c?.get(r.repository),i={fetcher:t,conn:r,specs:d,mode:a,prune:s===!0,allowedPruneNames:n,resolveTargetSpecs:e.resolveTargetSpecs,retiring:l,today:u};if(o!==!0)m.push(await syncOneRepo(i));else try{m.push(await syncOneRepo(i))}catch(e){h.push({repository:r.repository,error:p(e)})}}return{set:i,mode:a,repos:m,failures:h,drifted:m.some(e=>e.created.length>0||e.updated.length>0||e.pruned.length>0)}}function syncSummaryLines(e){let t=e.mode===`apply`?``:`would `,n=[];for(let r of e.repos){let e=[];r.created.length>0&&e.push(`${t}create: ${r.created.join(`, `)}`),r.updated.length>0&&e.push(`${t}update: ${r.updated.join(`, `)}`),r.omitted.length>0&&e.push(`omitted (repo declares its own vocabulary for these): ${r.omitted.join(`, `)}`),r.pruned.length>0&&e.push(`${t}prune: ${r.pruned.join(`, `)}`),r.stale.length>0&&e.push(`stale (present, not in this set): ${r.stale.join(`, `)}`);for(let t of r.refused){let n=t.objects.map(e=>`#${String(e.number)} (${e.kind}) ${e.title}`).join(`, `);e.push(`refused to prune ${t.name}: ${t.reason}${n===``?``:` (${n})`}`)}for(let t of r.retiring)e.push(`retiring ${t.name}: replaced by ${t.replacement}, prunable after ${t.until}${t.expired?` (expired)`:``}; ${String(t.openObjects.length)} open object(s)`);e.length===0?n.push(`${r.repository}: up to date (${String(r.unchanged.length)} unchanged)`):n.push(`${r.repository}: ${e.join(`; `)}`)}return{repoLines:n,failureLines:e.failures.map(e=>`${e.repository}: failed: ${e.error}`)}}function readLabelSet(e,t){let r;try{r=n(e,`utf-8`)}catch(t){throw new u(`Cannot read label-sets file ${e}: ${p(t)}`)}let i;try{i=JSON.parse(r)}catch(t){throw new u(`Label-sets file ${e} is not valid JSON: ${p(t)}`)}let a=ge.safeParse(i);if(!a.success){let t=a.error.issues[0],n=t===void 0||t.path.length===0?`(root)`:t.path.join(`.`);throw new u(`Label-sets file ${e} is invalid at ${n}: ${t?.message??`unknown error`}`)}let o=a.data[t];if(o===void 0){let n=Object.keys(a.data).toSorted().join(`, `)||`(none)`;throw new u(`Unknown label set "${t}" in ${e}. Known sets: ${n}`)}return o}async function runLabelsList(e,t){let n=await fetchAllForgejoLabels(e,t);return{repository:t.repository,labels:n}}function renderList(e){if(e.labels.length===0)j.info(`No labels found in ${e.repository}`);else for(let t of e.labels.toSorted((e,t)=>e.name.localeCompare(t.name))){let e=t.exclusive===!0?` [exclusive]`:``;j.info(`${t.name}${e} #${t.color??``} ${t.description??``}`)}}async function runLabelsSync(e){let{fetcher:t,targets:n,specs:r,setName:i,mode:a,contained:o}=e;return syncLabelSet({fetcher:t,targets:n,specs:r,setName:i,mode:a,contained:o})}function renderSync(e){let{repoLines:t,failureLines:n}=syncSummaryLines(e);for(let e of t)j.info(e);for(let e of n)j.warn(e)}const W=`bst-fj labels requires a Forgejo repository`,xe=_({meta:{name:`list`,description:`List a repository's existing labels`},args:{repo:{type:`string`,description:`Target owner/repo (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: repository, labels ([{id, name, color?, description?, exclusive?}]).`}},async run({args:e,rawArgs:t}){let n=requireForgejoTarget(process.cwd(),void 0,W),r=parseListFlag(t,`repo`);if(r.length===0&&listFlagPresent(t,`repo`))throw new u(`--repo was given with no repository name (expected e.g. owner/repo). Refusing rather than falling back to the current repo.`);let i=targetConnection(n,r.at(-1)),a=await runLabelsList(cliFetcher(),i);e.json===!0?createCliOutput(!0).json(a):renderList(a)}}),Se=_({meta:{name:`sync`,description:`Create/update a repo's labels from a named set in a label-sets file (never deletes a label)`},args:{file:{type:`string`,required:!0,description:`JSON file mapping each set name to an array of label specs. A spec is { "name", "color" ("#rrggbb"), "description", "exclusive"? (boolean) } and takes no other field`},set:{type:`string`,required:!0,description:`Label set name, a key of --file`},repo:{type:`string`,description:`Target owner/repo. Repeatable (unions); default: this repo`},fleet:{type:`boolean`,description:`Target every repo the token can write to, discovered live. Mutually exclusive with --repo`},check:{type:`boolean`,description:`Report drift without writing; exits 1 if any label is missing or drifted. A stale label (left on the repo but gone from the set) is reported and never counted as drift`},"dry-run":{type:`boolean`,description:`Report what would change without writing`},json:{type:`boolean`,description:`Emit one JSON document: set, mode (apply | check | dry-run), repos ([{repository, created, updated, unchanged, omitted, stale, retiring, refused}], every field but repository and those two a list of label names; retiring and refused are always empty here, since this command never prunes), failures ([{repository, error}]; always present, filled only under --fleet), drifted. drifted is true when any label is missing or drifted, and sets the exit code only under --check.`}},async run({args:e,rawArgs:t}){let n=requireForgejoTarget(process.cwd(),void 0,W),r=parseListFlag(t,`repo`);if(r.length===0&&listFlagPresent(t,`repo`))throw new u(`--repo was given with no repository name (expected e.g. owner/repo). Refusing rather than falling back to the current repo.`);let i=e.fleet===!0;if(i&&r.length>0)throw new u(`--repo and --fleet are mutually exclusive`);let a=readLabelSet(e.file,e.set),o=cliFetcher(),s;s=i?await resolveFleetTargets(o,n):r.length>0?r.map(e=>targetConnection(n,e)):[n];let c=resolveSyncMode(e.check===!0,e[`dry-run`]===!0),l=await runLabelsSync({fetcher:o,targets:s,specs:a,setName:e.set,mode:c,contained:i});e.json===!0?createCliOutput(!0).json(l):renderSync(l),(c===`check`&&l.drifted||l.failures.length>0)&&(process.exitCode=1)}}),Ce=_({meta:{name:`labels`,description:`Provision and audit a repository's label definitions from a named label set (sync, list)`},args:{json:{type:`boolean`,description:`Emit one JSON document; the keys are the subcommand's (see labels list --help and labels sync --help).`}},subCommands:{list:xe,sync:Se}}),we=g.object({id:g.number(),tag_name:g.string().optional(),created_at:g.string().optional(),published_at:g.string().optional(),html_url:g.string().nullish(),prerelease:g.boolean().optional()});function isEpochReleaseDate(e){if(!e)return!0;let t=new Date(e).getTime();return Number.isNaN(t)||t<=0}async function getReleaseByTag(e,t,n){let r=encodeURIComponent(n),i=`${t.serverUrl}/api/v1/repos/${t.repository}/releases/tags/${r}`,a=await e.fetch(i,{headers:{Authorization:`token ${t.token}`}});if(a.status===404)return null;if(!a.ok)throw new d(await forgejoErrorMessage(a,{verb:`check release`,resource:n}));let o=we.safeParse(await a.json());if(!o.success)throw new f(`Unexpected release response: ${o.error.message}`);return o.data}async function createRelease(e,t,n,r={}){let i=`${t.serverUrl}/api/v1/repos/${t.repository}/releases`,a={tag_name:n,name:r.name??n,body:r.body??`Published ${n}`,prerelease:r.prerelease??!1};r.target&&(a.target_commitish=r.target);let o=await e.fetch(i,{method:`POST`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify(a)});if(!o.ok)throw new d(await forgejoErrorMessage(o,{verb:`create release`,resource:n}))}async function deleteTag(e,t,n){let r=encodeURIComponent(n),i=`${t.serverUrl}/api/v1/repos/${t.repository}/tags/${r}`,a=await e.fetch(i,{method:`DELETE`,headers:{Authorization:`token ${t.token}`}});if(!a.ok&&a.status!==404)throw new d(await forgejoErrorMessage(a,{verb:`delete tag`,resource:n}))}const Te=g.looseObject({name:g.string(),id:g.string(),commit:g.object({sha:g.string().regex(/^[0-9a-f]{40}$/)})});async function getTagCommit(e,t,n){let r=encodeURIComponent(n),i=`${t.serverUrl}/api/v1/repos/${t.repository}/tags/${r}`,a=await e.fetch(i,{headers:{Authorization:`token ${t.token}`}});if(a.status===404)return null;if(!a.ok)throw new d(await forgejoErrorMessage(a,{verb:`read tag`,resource:n}));let o=Te.safeParse(await a.json());if(!o.success)throw new f(`Unexpected tag response: ${o.error.message}`);return o.data.commit.sha}async function deleteRelease(e,t,n){let r=`${t.serverUrl}/api/v1/repos/${t.repository}/releases/${String(n)}`,i=await e.fetch(r,{method:`DELETE`,headers:{Authorization:`token ${t.token}`}});if(!i.ok&&i.status!==404)throw new d(await forgejoErrorMessage(i,{verb:`delete release`,resource:String(n)}))}async function markReleasePrerelease(e,t,n,r){let i=`${t.serverUrl}/api/v1/repos/${t.repository}/releases/${String(n)}`,a=await e.fetch(i,{method:`PATCH`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify({prerelease:!0})},{idempotent:!0});if(!a.ok)throw new d(await forgejoErrorMessage(a,{verb:`edit release`,resource:r}))}async function ensureRelease(e,t,n,r={}){let i=r.attempts??4,a=r.baseDelayMs??2e3,o=r.queuePolls??5,s=await getReleaseByTag(e,t,n);if(s&&!isEpochReleaseDate(s.created_at))return r.prerelease===!0&&s.prerelease===!1&&await markReleasePrerelease(e,t,s.id,n),{status:`exists`,release:releaseRef(s)};let c=s,l=!1;for(let s=1;s<=i;s++){c&&isEpochReleaseDate(c.created_at)&&(await deleteRelease(e,t,c.id),c=null,l=!0,await settleBackoff(s,a));try{await createRelease(e,t,n,{target:r.target,prerelease:r.prerelease,name:r.name,body:r.body})}catch(r){let o=await getReleaseByTag(e,t,n);if(o&&!isEpochReleaseDate(o.created_at))return{status:`race`,release:releaseRef(o)};if(c=o,s>=i)break;I.warn(`Release creation attempt ${String(s)}/${String(i)} failed: ${p(r)}`),await settleBackoff(s,a);continue}if(c=await getReleaseByTag(e,t,n),c&&isEpochReleaseDate(c.created_at)&&o>0&&(c=await awaitQueueDate(e,t,n,o,a),o=0),c&&!isEpochReleaseDate(c.created_at))return{status:l?`repaired`:`created`,release:releaseRef(c)};s<i&&I.warn(`Release for ${n} came back epoch-dated (attempt ${String(s)}/${String(i)}) -- waiting for Forgejo to settle the tag's date before retrying`)}let u=r.target?await recreateTagViaApi(e,t,n,{target:r.target,prerelease:r.prerelease,name:r.name,body:r.body,current:c,attempts:i,baseDelayMs:a}):null;if(u)return{status:`repaired`,release:releaseRef(u)};throw new d(`Release for ${n} never got a real (non-epoch) created date after ${String(i)} attempts. Forgejo dates a release for a pushed tag from its push queue, which did not date this one, so it stayed at the Unix epoch (1969/1970). `+(r.target?`Recreating the tag via the API did not help -- investigate the server or upgrade Forgejo.`:`Pass the release tag's target commit so the tag can be recreated, or retry the release.`))}async function recreateTagViaApi(e,t,n,r){let{target:i,prerelease:a,name:o,body:s,current:c,attempts:l,baseDelayMs:u}=r;I.warn(`Release for ${n} stayed epoch-dated -- recreating the tag via the API so Forgejo stamps a real date (the tag becomes lightweight)`),c&&await deleteRelease(e,t,c.id),await deleteTag(e,t,n);for(let r=1;r<=l;r++){try{await createRelease(e,t,n,{target:i,prerelease:a,name:o,body:s})}catch(e){if(r>=l)throw new d(`Release for ${n} was deleted to repair its epoch date, but recreating it from ${i} failed: ${p(e)}. The tag no longer exists on the server -- re-push it (or re-run the release) to restore it.`);await settleBackoff(r,u);continue}let c=await getReleaseByTag(e,t,n);return c&&!isEpochReleaseDate(c.created_at)?c:null}return null}function releaseRef(e){return{id:e.id,url:e.html_url??null}}async function awaitQueueDate(e,t,n,r,i){let a=null;for(let o=1;o<=r;o++)if(await settleBackoff(o,i/4),a=await getReleaseByTag(e,t,n),!a||!isEpochReleaseDate(a.created_at))return a;return I.debug(`Release for ${n} is still epoch-dated after ${String(r)} re-reads`),a}async function settleBackoff(e,t){if(t<=0)return;let n=Math.min(t*2**(e-1),16e3);await new Promise(e=>setTimeout(e,n))}const Ee=g.object({id:g.number(),name:g.string()});g.object({id:g.number(),assets:g.array(Ee).nullish()}),g.object({id:g.number()}),g.looseObject({id:g.number(),tag_name:g.string(),name:g.string().nullish(),target_commitish:g.string().nullish(),created_at:g.string().nullish(),html_url:g.string().nullish(),draft:g.boolean().optional(),prerelease:g.boolean().optional(),assets:g.array(g.unknown()).nullish()}),g.looseObject({name:g.string(),commit:g.looseObject({sha:g.string(),created:g.string().nullish()})});const De=_({meta:{name:`release:create`,description:`Create a Forgejo release for a tag the forge already has, or with --target, for a new tag created at that commit`},args:{tag:{type:`string`,description:`Git tag to create a release for`,required:!0},prerelease:{type:`boolean`,description:`Flag the release as a prerelease, so the forge's Latest pointer skips it`,default:!1},target:{type:`string`,description:`Commit SHA the tag points at (default: read from the forge's tags API). A tag the forge lacks is created at this commit; the epoch-date repair recreates the tag from it.`},json:{type:`boolean`,description:`Emit one JSON document: status (created | exists | race | repaired), tag, target, prerelease, release ({id, url (or null)}).`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=requireForgejoTarget(process.cwd(),void 0,`bst-fj release:create requires a Forgejo repository`);if(e.target!==void 0&&e.target.trim()===``)throw new u(`--target needs a commit SHA; it was given an empty value.`);let r=cliFetcher(),i=e.prerelease===!0,a=e.target??await getTagCommit(r,n,e.tag);if(a===null)throw new u(`Tag ${e.tag} does not exist on ${n.repository}. Push the tag first, or pass --target <sha> naming the commit it points at.`);let o=await ensureRelease(r,n,e.tag,{target:a,prerelease:i});t.json({status:o.status,tag:e.tag,target:a,prerelease:i,release:o.release}),o.status===`exists`?j.info(`Release for ${e.tag} already exists -- skipping`):j.info(`Created Forgejo release for ${e.tag}`)}}),Oe=g.array(g.object({name:g.string()}));g.object({sha1:g.string()});const ke=/^[A-Za-z_][A-Za-z0-9_]*$/,Ae=/^(FORGEJO_|GITEA_|GITHUB_|[0-9])/i;function isValidSecretName(e){return ke.test(e)&&!Ae.test(e)}async function setActionSecret(e,t,n,r){let[i,a]=t.repository.split(`/`),o=`${t.serverUrl}/api/v1/repos/${i}/${a}/actions/secrets/${encodeURIComponent(n)}`,s=await e.fetch(o,{method:`PUT`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify({data:r})});if(!s.ok)throw new d(await forgejoErrorMessage(s,{verb:`set secret`,resource:n}))}async function listActionSecrets(e,t){let[n,r]=t.repository.split(`/`),i=[];for(let a=1;a<=21;a++){let o=`${t.serverUrl}/api/v1/repos/${n}/${r}/actions/secrets?page=${String(a)}&limit=50`,s=await e.fetch(o,{headers:{Authorization:`token ${t.token}`}});if(!s.ok)throw new d(await forgejoErrorMessage(s,{verb:`list secrets`,resource:`${n}/${r}`}));let c=Oe.safeParse(await s.json());if(!c.success)throw new f(`Unexpected secrets list response: ${c.error.message}`);for(let e of c.data)i.push(e.name);if(c.data.length===0)break;if(a===21)throw new f(`${n}/${r} still lists secrets after 20 pages; refusing to report a prefix of them`)}return i}async function deleteActionSecret(e,t,n){let[r,i]=t.repository.split(`/`),a=`${t.serverUrl}/api/v1/repos/${r}/${i}/actions/secrets/${encodeURIComponent(n)}`,o=await e.fetch(a,{method:`DELETE`,headers:{Authorization:`token ${t.token}`}});if(!o.ok)throw new d(await forgejoErrorMessage(o,{verb:`delete secret`,resource:n}))}async function runSecretsSet(e,t){if(!isValidSecretName(t.secretName))throw new u(`Invalid secret name "${t.secretName}". A name must match [A-Za-z_][A-Za-z0-9_]* and must not start with FORGEJO_, GITEA_, GITHUB_, or a digit.`);return t.dryRun?(j.info(`[dry-run] Would set secret ${t.secretName} on ${t.conn.repository}`),{status:`would-set`,name:t.secretName,repository:t.conn.repository}):(await setActionSecret(e,t.conn,t.secretName,t.secretValue),j.success(`Set secret ${t.secretName}`),{status:`set`,name:t.secretName,repository:t.conn.repository})}async function runSecretsList(e,t){let n=await listActionSecrets(e,t.conn);if(n.length===0)j.info(`No secrets found`);else for(let e of n)j.info(e);return n}async function runSecretsDelete(e,t){return t.dryRun?(j.info(`[dry-run] Would delete secret ${t.secretName} from ${t.conn.repository}`),{status:`would-delete`,name:t.secretName,repository:t.conn.repository}):(await deleteActionSecret(e,t.conn,t.secretName),j.success(`Deleted secret ${t.secretName}`),{status:`deleted`,name:t.secretName,repository:t.conn.repository})}function readSecretValue(e){if(e)return e;try{let e=n(`/dev/stdin`,`utf-8`).trim();if(e.length===0)throw new u(`No secret value provided. Use --body or pipe a value via stdin.`);return e}catch(e){throw e instanceof u?e:new u(`No secret value provided. Use --body or pipe a value via stdin.`)}}const je=_({meta:{name:`set`,description:`Set a repository secret (reads value from --body or stdin)`},args:{name:{type:`positional`,description:`Secret name`,required:!0},body:{type:`string`,description:`Secret value (reads from stdin if omitted)`},"dry-run":{type:`boolean`,description:`Show what would be done without making API calls`},verbose:{type:`boolean`,description:`Enable verbose output`},json:{type:`boolean`,description:`Emit one JSON document: status (set | would-set), name, repository. The secret value is never included.`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=requireForgejoTarget(process.cwd(),void 0,`bst-fj secrets requires a Forgejo repository`),r=cliFetcher(),i=readSecretValue(e.body),a=await runSecretsSet(r,{conn:n,secretName:e.name,secretValue:i,dryRun:e[`dry-run`]===!0});t.json(a)}}),Me=_({meta:{name:`list`,description:`List repository secret names`},args:{verbose:{type:`boolean`,description:`Enable verbose output`},json:{type:`boolean`,description:`Emit one JSON document: repository, secrets (secret names). Values are never returned.`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=requireForgejoTarget(process.cwd(),void 0,`bst-fj secrets requires a Forgejo repository`),r=await runSecretsList(cliFetcher(),{conn:n});t.json({repository:n.repository,secrets:r})}}),Ne=_({meta:{name:`delete`,description:`Delete a repository secret`},args:{name:{type:`positional`,description:`Secret name to delete`,required:!0},"dry-run":{type:`boolean`,description:`Show what would be done without making API calls`},verbose:{type:`boolean`,description:`Enable verbose output`},json:{type:`boolean`,description:`Emit one JSON document: status (deleted | would-delete), name, repository.`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=requireForgejoTarget(process.cwd(),void 0,`bst-fj secrets requires a Forgejo repository`),r=await runSecretsDelete(cliFetcher(),{conn:n,secretName:e.name,dryRun:e[`dry-run`]===!0});t.json(r)}}),Pe=_({meta:{name:`secrets`,description:`Low-level CRUD for individual Forgejo Actions secrets (set, list, delete). Use pnpm exec bst setup:secrets (in @bensandee/tooling) for initial repo onboarding`},args:{json:{type:`boolean`,description:`Emit one JSON document; the keys are the subcommand's (see secrets set --help, secrets list --help and secrets delete --help).`}},subCommands:{set:je,list:Me,delete:Ne}}),Fe=g.object({login:g.string(),email:g.string().nullish()});async function getAuthenticatedUser(e,t,n=null){let r=await e.fetch(`${t.serverUrl}/api/v1/user`,{headers:authHeaders(t),signal:n});if(!r.ok)return{ok:!1,httpStatus:r.status,statusText:r.statusText};let i=Fe.safeParse(await r.json());if(!i.success)throw new f(`Unexpected /user response: ${i.error.message}`);return{ok:!0,login:i.data.login,email:i.data.email||null}}const Ie=g.object({id:g.number(),type:g.string(),active:g.boolean(),config:g.record(g.string(),g.string()).optional()}),Le=g.array(Ie);async function fetchHooks(e,t,n){let r=await e.fetch(`${t.serverUrl}/api/v1${n}`,{headers:{Authorization:`token ${t.token}`}});if(r.status===401||r.status===403)return{status:`unauthorized`,httpStatus:r.status};if(!r.ok){let e=await responseBodyText(r);return{status:`error`,httpStatus:r.status,message:`${r.statusText}\n${e}`}}let i=Le.safeParse(await r.json());if(!i.success)throw new f(`Unexpected webhook list response for ${n}: ${i.error.message}`);return{status:`ok`,hooks:i.data}}async function listSystemHooks(e,t){return fetchHooks(e,t,`/admin/hooks`)}async function listUserHooks(e,t){return fetchHooks(e,t,`/user/hooks`)}async function listOrgHooks(e,t,n){return fetchHooks(e,t,`/orgs/${encodeURIComponent(n)}/hooks`)}async function listRepoHooks(e,t,n){return fetchHooks(e,t,`/repos/${n}/hooks`)}async function hasAdminAccess(e,t){return(await e.fetch(`${t.serverUrl}/api/v1/admin/users?limit=1`,{headers:{Authorization:`token ${t.token}`}})).ok}const Re=g.object({username:g.string()}),ze=g.array(Re);async function paginate(e,t,n,r,i){let a=[],o=n.includes(`?`)?`&`:`?`;for(let s=1;s<=101;s++){let c=`${t.serverUrl}/api/v1${n}${o}page=${String(s)}&limit=50`,l=await e.fetch(c,{headers:{Authorization:`token ${t.token}`}});if(!l.ok)throw new d(await forgejoErrorMessage(l,{verb:r,resource:`${n} (page ${String(s)})`}));let u=i(await l.json());if(a.push(...u),!morePagesFollow(l,u.length,a.length,50))break;if(s===101)throw new f(`${n} still returns full pages after 100 pages; refusing to report a prefix of it`)}return a}async function listOrgs(e,t,n){let r=n===`admin`?`/admin/orgs`:`/user/orgs`;return(await paginate(e,t,r,`list orgs`,e=>{let t=ze.safeParse(e);if(!t.success)throw new f(`Unexpected ${r} response: ${t.error.message}`);return t.data})).map(e=>e.username)}const Be=g.object({data:g.array(g.object({full_name:g.string()}))});async function searchRepos(e,t){return(await paginate(e,t,`/repos/search`,`list repos`,e=>{let t=Be.safeParse(e);if(!t.success)throw new f(`Unexpected /repos/search response: ${t.error.message}`);return t.data.data})).map(e=>e.full_name)}function collectGroup(e,t,n){return n.status===`ok`?n.hooks.length>0?{label:e,hooks:n.hooks}:null:n.status===`unauthorized`?(j.warn(`${e}: HTTP ${String(n.httpStatus)} -- token likely missing scope: ${t}`),null):(j.warn(`${e}: HTTP ${String(n.httpStatus)} ${n.message}`),null)}async function runListWebhooks(e,t){let n=await getAuthenticatedUser(e,t);if(!n.ok)throw new u(`Token is invalid or lacks read:user scope (HTTP ${String(n.httpStatus)})`);let r=n.login,i=await hasAdminAccess(e,t),a=[],o=collectGroup(`System`,`read:admin`,await listSystemHooks(e,t));o&&a.push(o);let s=collectGroup(`User: ${r}`,`read:user`,await listUserHooks(e,t));s&&a.push(s);let c=await listOrgs(e,t,i?`admin`:`user`);for(let n of c){let r=collectGroup(`Org: ${n}`,`read:organization`,await listOrgHooks(e,t,n));r&&a.push(r)}let l=await searchRepos(e,t);for(let n of l){let r=collectGroup(`Repo: ${n}`,`read:repository + repo admin`,await listRepoHooks(e,t,n));r&&a.push(r)}return{user:r,isAdmin:i,groups:a,totalCount:a.reduce((e,t)=>e+t.hooks.length,0)}}function renderText(e,t){if(j.info(`Forgejo Webhook Inventory -- ${t}`),j.info(`Token user: ${e.user}${e.isAdmin?` (admin)`:``}`),e.groups.length===0)j.info(`No webhooks found.`);else{for(let t of e.groups){j.info(`${t.label} (${String(t.hooks.length)} webhook(s))`);for(let e of t.hooks){let t=e.config?.url??`n/a`;j.info(` id=${String(e.id)} type=${e.type} active=${String(e.active)} url=${t}`)}}j.info(`Total: ${String(e.totalCount)} webhook(s)`),e.isAdmin&&j.info(`Note: User-level webhooks for other accounts cannot be enumerated via the API. Check the admin UI or run this command with tokens from individual user accounts.`)}}const Ve=_({meta:{name:`webhooks`,description:`Enumerate webhooks across a Forgejo instance (system, user, org, and repo levels)`},args:{json:{type:`boolean`,description:`Emit one JSON document: user, isAdmin, groups ([{label, hooks ([{id, type, active, config?}])}]), totalCount.`}},async run({args:e}){let t=requireForgejoTarget(process.cwd(),void 0,`bst-fj webhooks requires a Forgejo repository`),n=await runListWebhooks(cliFetcher(),t);e.json?createCliOutput(!0).json(n):renderText(n,t.serverUrl)}}),He=/^(\d+)\./u,Ue=g.object({version:g.string()});function capabilitiesFromVersion(e){if(e===null)return{version:null,jobSteps:!1,rerun:!1};let t=He.exec(e);if(t===null)return{version:e,jobSteps:!1,rerun:!1};let n=Number.parseInt(t[1]??``,10);return!Number.isSafeInteger(n)||n<17?{version:e,jobSteps:!1,rerun:!1}:{version:e,jobSteps:!0,rerun:!0}}const G=/* @__PURE__ */ new Map;async function readVersion(e,t){try{let n=await e.fetch(`${t.serverUrl}/api/v1/version`,{headers:authHeaders(t)});if(!n.ok)return capabilitiesFromVersion(null);let r=Ue.safeParse(await n.json());return r.success?capabilitiesFromVersion(r.data.version):capabilitiesFromVersion(null)}catch(e){return I.debug(`version read on ${t.serverUrl} failed: ${String(e)}`),capabilitiesFromVersion(null)}}async function readForgeCapabilities(e,t){let n=G.get(t.serverUrl);if(n!==void 0)return n;let r=readVersion(e,t);return G.set(t.serverUrl,r),r}function forgeVersionRefusal(e,t,n){return new u(`${e} needs Forgejo 17 or later; ${t.serverUrl} reports ${n.version??`no readable version`}`)}function forgeTimestamp(e){if(e==null||e===``)return null;let t=Date.parse(e);return!Number.isFinite(t)||t<=0?null:e}const K=g.object({id:g.number(),index_in_repo:g.number().nullish(),workflow_id:g.string().nullish(),title:g.string().nullish(),prettyref:g.string().nullish(),commit_sha:g.string().nullish(),event:g.string().nullish(),status:g.string().nullish(),started:g.string().nullish(),stopped:g.string().nullish(),duration:g.number().nullish(),html_url:g.string().nullish()}),We=g.object({workflow_runs:g.array(K)}),Ge=g.object({id:g.number(),name:g.string(),status:g.string()}),Ke=g.array(Ge);function toActionsRun(e){let t=e.duration??null;return{id:e.id,number:e.index_in_repo??null,workflow:e.workflow_id??null,title:e.title??null,ref:e.prettyref??null,headSha:e.commit_sha??null,event:e.event??null,status:e.status??null,startedAt:forgeTimestamp(e.started),completedAt:forgeTimestamp(e.stopped),durationMs:t===null||t<=0?null:Math.round(t/1e6),url:e.html_url??null}}async function getActionsRunByNumber(e,t,n){let r=new URLSearchParams({run_number:n,page:`1`,limit:`1`}),i=`${t.serverUrl}/api/v1/repos/${t.repository}/actions/runs?${r.toString()}`,a=await e.fetch(i,{headers:{Authorization:`token ${t.token}`}});a.ok||await throwForgejoFailure(a,{verb:`look up run`,resource:n});let o=We.safeParse(await a.json());if(!o.success)throw new f(`Unexpected run lookup response for run ${n}: ${o.error.message}`);let[s]=o.data.workflow_runs;if(s===void 0)throw new u(`No run numbered ${n} in ${t.repository}`);let c=toActionsRun(s);if(c.number!==null&&String(c.number)!==n)throw new f(`Asked ${t.repository} for run ${n} and got run ${String(c.number)}: the forge ignored the run_number filter`);return c}async function listActionsRunJobs(e,t,n){let r=`${t.serverUrl}/api/v1/repos/${t.repository}/actions/runs/${String(n)}/jobs`,i=await e.fetch(r,{headers:{Authorization:`token ${t.token}`}});i.ok||await throwForgejoFailure(i,{verb:`list run jobs`,resource:String(n)});let a=Ke.safeParse(await i.json());if(!a.success)throw new f(`Unexpected run-jobs response for run ${String(n)}: ${a.error.message}`);let o=[];for(let[e,t]of a.data.entries())o.push({index:e,id:t.id,name:t.name,status:t.status});return o}const qe=g.object({number:g.number(),name:g.string(),status:g.string(),started:g.string().nullish(),stopped:g.string().nullish()}),Je=g.object({id:g.number(),name:g.string(),status:g.string(),steps:g.array(qe).nullish()});async function getActionsJob(e,t,n){let r=`${t.serverUrl}/api/v1/repos/${t.repository}/actions/jobs/${String(n)}`,i=await e.fetch(r,{headers:{Authorization:`token ${t.token}`}});i.ok||await throwForgejoFailure(i,{verb:`read job`,resource:String(n)});let a=Je.safeParse(await i.json());if(!a.success)throw new f(`Unexpected job response for job ${String(n)}: ${a.error.message}`);let o=a.data,s=o.steps===null||o.steps===void 0?null:o.steps.map(e=>({number:e.number,name:e.name,status:e.status,startedAt:forgeTimestamp(e.started),completedAt:forgeTimestamp(e.stopped)}));return{id:o.id,name:o.name,status:o.status,steps:s}}async function fetchActionsJobLogById(e,t,n,r,i){let a=`${t.serverUrl}/api/v1/repos/${t.repository}/actions/jobs/${String(n)}/logs`;if(i!==void 0){let n=await readForgeCapabilities(e,t);if(!n.jobSteps)throw forgeVersionRefusal(`Reading one step's log`,t,n);a=`${a}?step=${String(i)}`}let o=`head`in r?`bytes=0-${String(r.head-1)}`:`bytes=-${String(r.tail)}`,s=await e.fetch(a,{headers:{Authorization:`token ${t.token}`,Range:o}});if(s.status===416)return{text:``,truncated:!1};if(s.ok||await throwForgejoFailure(s,{verb:`read job log`,resource:String(n)}),s.status===206){let e=parseContentRange(s.headers.get(`content-range`));if(e!==null)return`head`in r?readRangedHead(await s.arrayBuffer(),e,r.head):readRangedTail(await s.arrayBuffer(),e)}let c=await s.text();if(`head`in r)return{text:c.slice(0,r.head),truncated:c.length>r.head};let l=r.tail;return c.length<=l?{text:c,truncated:!1}:{text:c.slice(c.length-l),truncated:!0}}const Ye=/^bytes (\d+)-(\d+)\/(\d+|\*)$/u;function parseContentRange(e){if(e===null)return null;let t=Ye.exec(e.trim());if(t===null)return null;let n=Number.parseInt(t[1]??``,10),r=Number.parseInt(t[2]??``,10);if(!Number.isSafeInteger(n)||!Number.isSafeInteger(r))return null;let i=t[3]??`*`,a=i===`*`?null:Number.parseInt(i,10);return{start:n,end:r,total:a!==null&&Number.isSafeInteger(a)?a:null}}function readRangedTail(e,t){let n=new Uint8Array(e),r=0;if(t.start>0){let e=n.indexOf(10);e!==-1&&(r=e+1)}return{text:new TextDecoder(`utf-8`).decode(n.subarray(r)),truncated:t.start>0}}function readRangedHead(e,t,n){let r=new Uint8Array(e);if(!(t.total===null?r.length>=n:t.end<t.total-1))return{text:new TextDecoder(`utf-8`).decode(r),truncated:!1};let i=r.length,a=r.lastIndexOf(10);return a!==-1&&(i=a+1),{text:new TextDecoder(`utf-8`).decode(r.subarray(0,i)),truncated:!0}}async function rerunActionsRun(e,t,n){await postRerun(e,t,`runs/${String(n)}`,`run`,String(n))}async function rerunActionsJob(e,t,n){await postRerun(e,t,`jobs/${String(n)}`,`job`,String(n))}async function postRerun(e,t,n,r,i){let a=`${t.serverUrl}/api/v1/repos/${t.repository}/actions/${n}/rerun`,o=await e.fetch(a,{method:`POST`,headers:authHeaders(t)});if(!o.ok){if(o.status===400)throw new u(`The ${r} ${i} has not finished, so it cannot be rerun -- wait for it to finish and try again.`);if(o.status===403)throw new ForgeAccessError(`Rerunning ${r} ${i} was refused: the token needs write:repository scope and write access to Actions in ${t.repository}.`);await throwForgejoFailure(o,{verb:`rerun ${r}`,resource:i})}}const Xe=g.object({workflow_runs:g.array(K)});async function listActionsRuns(e,t,n){let r={Authorization:`token ${t.token}`},i=Math.min(n.limit,50),a=[];for(let o=1;o<=20;o++){let s=new URLSearchParams({page:String(o),limit:String(i)});n.workflow!==void 0&&s.set(`workflow_id`,n.workflow),n.ref!==void 0&&s.set(`ref`,n.ref),n.headSha!==void 0&&s.set(`head_sha`,n.headSha),n.status!==void 0&&s.set(`status`,n.status);let c=`${t.serverUrl}/api/v1/repos/${t.repository}/actions/runs?${s.toString()}`,l=await e.fetch(c,{headers:r});l.ok||await throwForgejoFailure(l,{verb:`list workflow runs`,resource:t.repository});let u=Xe.safeParse(await l.json());if(!u.success)throw new f(`Unexpected workflow-runs response for ${t.repository}: ${u.error.message}`);let d=u.data.workflow_runs.map(toActionsRun);if(a.push(...d),d.length===0||a.length>=n.limit)break;o===20&&(I.warn(`Workflow run listing on ${t.repository} hit the 20-page cap without an empty page; results may be truncated`),n.onPageCap?.())}return a.slice(0,n.limit)}const Ze=/\/actions\/runs\/(\d+)\/jobs\/(\d+)(?:[/?#]|$)/u;function parseActionsJobTargetUrl(e){if(e===null)return null;let t=Ze.exec(e);return t===null?null:{run:t[1],index:Number(t[2])}}function parseActionsJobTargetRepo(e){let t=e.indexOf(`/actions/runs/`);if(t===-1)return;let n=e.slice(0,t);if(n.startsWith(`http://`)||n.startsWith(`https://`))return parseRepoTarget(n)}async function dispatchWorkflow(e,t,n){let r=n.repository??t.repository,i=`${t.serverUrl}/api/v1/repos/${r}/actions/workflows/${encodeURIComponent(n.workflow)}/dispatches`,a={ref:n.ref};Object.keys(n.inputs).length>0&&(a.inputs=n.inputs);let o=await e.fetch(i,{method:`POST`,headers:jsonHeaders(t),body:JSON.stringify(a)});if(!o.ok)throw new u(await forgejoErrorMessage(o,{verb:`dispatch workflow`,resource:n.workflow,ref:n.ref}));return{repository:r,workflow:n.workflow,ref:n.ref,inputs:n.inputs}}const Qe=/\u001b\[[0-?]*[ -/]*[@-~]/gu,$e=/\u001b\][^\u0007]*(?:\u0007|\u001b\\)/gu,et=/\u001b/gu,tt=/[\u0000-\u0008\u000a-\u001f\u007f]/gu,nt=/^\d{4}-\d{2}-\d{2}T\S+$/u;function stripControlSequences(e){return e.replace(Qe,``).replace($e,``).replace(et,``).replace(tt,``)}function splitLogLine(e){let t=e.indexOf(` `),n=t===-1?e:e.slice(0,t);return nt.test(n)&&Number.isFinite(Date.parse(n))?{at:n,text:stripControlSequences(t===-1?``:e.slice(t+1))}:{at:null,text:stripControlSequences(e)}}function spanBetween(e,t){if(e===null||t===null)return null;let n=Date.parse(e),r=Date.parse(t);return!Number.isFinite(n)||!Number.isFinite(r)?null:r-n}function readActionsJobLog(e){let t=e.split(`
|
|
7
|
+
`);t.length>0&&t[t.length-1]===``&&t.pop();let n=t.map(e=>splitLogLine(e.endsWith(`\r`)?e.slice(0,-1):e)),r=n.find(e=>e.at!==null)?.at??null,i=null;for(let e=n.length-1;e>=0&&i===null;e--)i=n[e]?.at??null;return{firstLineAt:r,lastLineAt:i,spanMs:spanBetween(r,i),lines:n}}const rt=/\/actions\/runs\/(\d+)\/?(?:[?#]|$)/u;function parseCiLogTarget(e){if(/^\d+$/.test(e))return{run:e,index:null,repoTarget:void 0};let t=parseActionsJobTargetUrl(e);if(t!==null)return{run:t.run,index:t.index,repoTarget:parseActionsJobTargetRepo(e)};let n=rt.exec(e);if(n!==null)return{run:n[1],index:null,repoTarget:parseActionsJobTargetRepo(e)};throw new u(`Not a run number or an Actions run or job URL: "${e}" (expected e.g. 6693, https://host/owner/repo/actions/runs/6693 or .../actions/runs/6693/jobs/0).`)}function jobTable(e){return e.map(e=>` ${String(e.index)} ${e.name} ${e.status}`).join(`
|
|
8
|
+
`)}function jobAtIndex(e,t,n){let r=e.find(e=>e.index===t);if(r===void 0)throw new u(`${n} ${String(t)} is not one of this run's jobs. Jobs in this run:\n${jobTable(e)}`);return r}function chooseJob(e,t,n){if(t!==void 0){let r=/^\d+$/.test(t)?jobAtIndex(e,Number(t),`--job ${t}`):e.find(e=>e.name.toLowerCase()===t.toLowerCase());if(r===void 0)throw new u(`No job is named "${t}". Jobs in this run:\n${jobTable(e)}`);if(n!==null&&r.index!==n)throw new u(`--job "${t}" is job ${String(r.index)}, but the URL names job ${String(n)} -- give one of them.`);return r}if(n!==null)return jobAtIndex(e,n,`The URL's job index`);let r=e.length===1?e[0]:void 0;if(r!==void 0)return r;throw new u(`This run has ${String(e.length)} jobs, so --job must say which one (a name or the index).\nJobs in this run:\n${jobTable(e)}`)}function stepTable(e){return e.map(e=>` ${String(e.number)} ${e.name} ${e.status}`).join(`
|
|
9
|
+
`)}function chooseStep(e,t){if(e===null)throw new u(`This job has no step table, so --step cannot choose a step from it.`);if(/^\d+$/u.test(t)){let n=e.find(e=>e.number===Number(t));if(n!==void 0)return n;throw new u(`--step ${t} is not one of this job's steps. Steps in this job:\n${stepTable(e)}`)}let n=e.filter(e=>e.name.toLowerCase()===t.toLowerCase()),[r]=n;if(r===void 0)throw new u(`No step is named "${t}". Steps in this job:\n${stepTable(e)}`);if(n.length>1)throw new u(`"${t}" names ${String(n.length)} of this job's steps, so --step must give a number. Steps in this job:\n${stepTable(e)}`);return r}function toCiLogStep(e){return{number:e.number,name:e.name,status:e.status,startedAt:e.startedAt,completedAt:e.completedAt,durationMs:stepDurationMs(e)}}function stepDurationMs(e){if(e.startedAt===null||e.completedAt===null)return null;let t=Date.parse(e.completedAt)-Date.parse(e.startedAt);return Number.isFinite(t)&&t>=0?t:null}async function runCiLog(e,t){let n=parseCiLogTarget(t.target),r;if(t.grep!==void 0)try{r=new RegExp(t.grep)}catch{throw new u(`--grep is not a valid JavaScript regular expression: "${t.grep}"`)}let i=requireForgejoTarget(t.cwd,resolveIssueTarget(n.repoTarget,t.repo),`ci:log is Forgejo-only -- gh run view --log already serves GitHub, first-class. Use that instead.`);j.debug(`ci:log repository=${i.repository} run=${n.run}`);let a=await readForgeCapabilities(e,i);if(t.step!==void 0&&!a.jobSteps)throw forgeVersionRefusal(`--step`,i,a);let o=await getActionsRunByNumber(e,i,n.run),s=chooseJob(await listActionsRunJobs(e,i,o.id),t.job,n.index),c=[],l=null;if(a.jobSteps)try{let t=await getActionsJob(e,i,s.id);l=t.steps===null?null:t.steps.map(toCiLogStep)}catch(e){if(t.step!==void 0)throw e;j.debug(`ci:log could not read job ${String(s.id)}'s steps: ${String(e)}`),c.push(`The job's step table could not be read.`)}let d;t.step!==void 0&&(d=chooseStep(l,t.step));let f=await fetchActionsJobLogById(e,i,s.id,{head:67108864},d?.number),p=readActionsJobLog(f.text);return f.truncated&&c.push(`The job log is longer than the whole-log ceiling, so only its head was read: later lines are missing.`),{repository:i.repository,run:{number:o.number??Number.parseInt(n.run,10),id:o.id,workflow:o.workflow,ref:o.ref,headSha:o.headSha,status:o.status},job:{index:s.index,id:s.id,name:s.name,status:s.status,...l===null?{}:{steps:l}},log:{firstLineAt:p.firstLineAt,lastLineAt:p.lastLineAt,spanMs:p.spanMs,lineCount:p.lines.length,truncated:f.truncated},...d===void 0?{}:{step:{number:d.number,name:d.name,status:d.status}},lines:r===void 0?p.lines:p.lines.filter(e=>r.test(e.text)),grep:r!==void 0,notices:c}}function renderDuration(e){return e===null?`?`:`${String(Math.round(e/1e3))}s`}function renderCiLog(e){let t=[`run ${String(e.run.number)} ${e.run.status??`?`} ${e.run.workflow??`?`}`,`job ${String(e.job.index)} ${e.job.name} (${e.job.status})`];for(let n of e.job.steps??[])t.push(` step ${String(n.number)} ${n.name} ${n.status} ${renderDuration(n.durationMs)}`);e.step!==void 0&&t.push(`step ${String(e.step.number)} ${e.step.name} (${e.step.status})`);for(let n of e.lines)t.push(n.at===null?n.text:`${n.at} ${n.text}`);return t.join(`
|
|
10
|
+
`)}const it=_({meta:{name:`ci:log`,description:`Show one workflow job's log, or the lines matching --grep (Forgejo-only; use gh run view --log on GitHub)`},args:{target:{type:`positional`,required:!0,description:`Run number, run URL (actions/runs/<run>), or a status target_url (actions/runs/<run>/jobs/<index>)`},job:{type:`string`,description:`Job name (case-insensitive) or zero-based index (refused when a URL names one)`},step:{type:`string`,description:`Step number or name (case-insensitive); Forgejo 17 or later`},grep:{type:`string`,description:`JavaScript regular expression over each line's text; prints only matching lines`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: {repository, run: {number, id, workflow, ref, headSha, status}, job: {index, id, name, status, steps (Forgejo 17 only)}, step (with --step), log: {firstLineAt, lastLineAt, spanMs, lineCount, truncated}, lines ([{at, text}], with --grep only)}.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=e.target??``,r=await runCiLog(cliFetcher(),{cwd:process.cwd(),target:n,...e.job===void 0?{}:{job:e.job},...e.step===void 0?{}:{step:e.step},...e.grep===void 0?{}:{grep:e.grep},...e.repo===void 0?{}:{repo:e.repo}});for(let e of r.notices)t.notice(e);t.json({repository:r.repository,run:r.run,job:r.job,...r.step===void 0?{}:{step:r.step},log:r.log,...r.grep?{lines:r.lines}:{}}),t.text(renderCiLog(r))}});async function runCiRerun(e,t){let n=parseCiLogTarget(t.target),r=requireForgejoTarget(t.cwd,resolveIssueTarget(n.repoTarget,t.repo),`ci:rerun is Forgejo-only -- gh run rerun already serves GitHub, first-class. Use that instead.`);j.debug(`ci:rerun repository=${r.repository} run=${n.run}`);let i=await readForgeCapabilities(e,r);if(!i.rerun)throw forgeVersionRefusal(`ci:rerun`,r,i);let a=await getActionsRunByNumber(e,r,n.run),o=a.number??Number.parseInt(n.run,10);if(t.job===void 0&&n.index===null)return await rerunActionsRun(e,r,a.id),{repository:r.repository,run:{number:o,id:a.id},job:null};let s=chooseJob(await listActionsRunJobs(e,r,a.id),t.job,n.index);return await rerunActionsJob(e,r,s.id),{repository:r.repository,run:{number:o,id:a.id},job:{index:s.index,id:s.id,name:s.name}}}function renderCiRerun(e){return e.job===null?`Reran run ${String(e.run.number)}.`:`Reran job ${String(e.job.index)} ${e.job.name} of run ${String(e.run.number)} and the jobs that depend on it.`}const at=_({meta:{name:`ci:rerun`,description:`Rerun a workflow run, or one job and the jobs that depend on it (Forgejo 17 or later; use gh run rerun on GitHub); Forgejo reports no id for the new attempt, and ci:runs shows the run running again`},args:{target:{type:`positional`,required:!0,description:`Run number, run URL (actions/runs/<run>), or a status target_url (actions/runs/<run>/jobs/<index>)`},job:{type:`string`,description:`Job name (case-insensitive) or zero-based index; omitting it reruns the whole run`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: {repository, run: {number, id}, job: {index, id, name} | null}.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=await runCiRerun(cliFetcher(),{cwd:process.cwd(),target:e.target??``,...e.job===void 0?{}:{job:e.job},...e.repo===void 0?{}:{repo:e.repo}});t.json({repository:n.repository,run:n.run,job:n.job}),t.text(renderCiRerun(n))}});function resolveRunsRef(e,t){if(e!==void 0&&t!==void 0)throw new u(`--ref and --pr are the same filter -- give one of them (--pr 273 for a pull request's own runs, --ref main for a branch's).`);if(t!==void 0){let e=parseIssueRef(t);if(e.number===void 0)throw new u(`Not a pull request number or URL: "${t}"`);return{ref:`refs/pull/${String(e.number)}/head`,target:e.target}}return e===void 0?{ref:void 0,target:void 0}:e.startsWith(`refs/`)?{ref:e,target:void 0}:{ref:`refs/heads/${e}`,target:void 0}}async function runCiRuns(e,t){let n=parseLimitFlag(t.limit),r=resolveRunsRef(t.ref,t.pr),i=requireForgejoTarget(t.cwd,resolveIssueTarget(r.target,t.repo),`ci:runs is Forgejo-only -- gh run list already serves GitHub, first-class. Use that instead.`);j.debug(`ci:runs repository=${i.repository} limit=${String(n)}`);let a=[],o=await listActionsRuns(e,i,{limit:n,workflow:t.workflow,ref:r.ref,headSha:t.sha,status:t.status,onPageCap:()=>{a.push(`Workflow run listing hit the page cap before an empty page; results may be truncated.`)}}),s=await Promise.all(o.map(async t=>({run:t,jobs:await listActionsRunJobs(e,i,t.id)}))),c=[];for(let{run:e,jobs:t}of s)c.push({...e,jobs:t});return{repository:i.repository,runs:c,notices:a}}function durationText(e){return e===null?`-`:`${String(e)}ms`}function renderCiRuns(e){if(e.runs.length===0)return`No workflow runs in ${e.repository}.`;let t=[];for(let n of e.runs){t.push([n.number===null?`?`:String(n.number),n.status??`?`,n.workflow??`?`,n.event??`?`,n.ref??`?`,n.headSha??`?`,durationText(n.durationMs),n.url??`?`].join(` `));for(let e of n.jobs)t.push(` ${String(e.index)} ${e.status} ${e.name}`)}return t.join(`
|
|
11
|
+
`)}const ot=_({meta:{name:`ci:runs`,description:`List a repository's workflow runs with their jobs, newest first (Forgejo-only; use gh run list on GitHub)`},args:{workflow:{type:`string`,description:`Workflow file name, e.g. check.yml (the forge's workflow_id)`},ref:{type:`string`,description:`Branch or full ref; a bare name means refs/heads/<name> (refuses --pr)`},pr:{type:`string`,description:`Pull request number or URL: its own runs (refs/pull/<n>/head)`},sha:{type:`string`,description:`Head SHA (the forge's head_sha)`},status:{type:`string`,description:`Run status: pending | queued | in_progress | failure | success | skipped (the forge interprets the string)`},limit:{type:`string`,default:`20`,description:`Maximum runs to return`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: {repository, runs: [{number, id, workflow, title, ref (main, or #<pr> for a PR run), headSha, event, status, startedAt, completedAt, durationMs, url (each nullable but id), jobs: [{index, id, name, status}]}]}.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=await runCiRuns(cliFetcher(),{cwd:process.cwd(),workflow:e.workflow??void 0,ref:e.ref??void 0,pr:e.pr??void 0,sha:e.sha??void 0,status:e.status??void 0,limit:e.limit,repo:e.repo??void 0});for(let e of n.notices)t.notice(e);t.json({repository:n.repository,runs:n.runs}),t.text(renderCiRuns(n))}});function collectInputArgs(e){let t=[];for(let n=0;n<e.length;n+=1){let r=e[n];if(r!==void 0){if(r===`--`)break;if(r===`--input`){let r=e[n+1];if(r===void 0)throw new u("Missing value for --input: expected `--input key=value`");t.push(r),n+=1}else r.startsWith(`--input=`)&&t.push(r.slice(8))}}return t}function parseInputs(e){let t={};for(let n of e){let e=n.indexOf(`=`);if(e<=0)throw new u(`Invalid --input "${n}": expected key=value`);t[n.slice(0,e)]=n.slice(e+1)}return t}async function runWorkflowDispatch(e,t){let n=await dispatchWorkflow(e,requireForgejoTarget(t.cwd,void 0,`workflow:dispatch is Forgejo-only -- use gh workflow run on GitHub.`),{...t.repo===void 0?{}:{repository:t.repo},workflow:t.workflow,ref:t.ref,inputs:t.inputs});return{status:`dispatched`,host:`forgejo`,repo:n.repository,workflow:n.workflow,ref:n.ref,inputs:n.inputs}}const st={"ci:log":it,"ci:rerun":at,"ci:runs":ot,"workflow:dispatch":_({meta:{name:`workflow:dispatch`,description:`Trigger a workflow_dispatch event for a workflow in any repo on the same Forgejo host (Forgejo-only; use gh workflow run on GitHub). The token must have rights on --repo when it differs from the current repo.`},args:{repo:{type:`string`,description:`Target repository as owner/repo, not a URL (default: the current repo)`,required:!1},workflow:{type:`string`,description:`Workflow filename (e.g. deploy.yml) or numeric ID`,required:!0},ref:{type:`string`,description:`Git ref to dispatch on (default: main)`,required:!1},input:{type:`string`,description:`Workflow input as key=value (repeatable)`,required:!1},json:{type:`boolean`,description:`Emit one JSON document: status (dispatched), host (forgejo), repo (owner/repo), workflow, ref, inputs.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e,rawArgs:t}){let n=createCliOutput(e.json===!0);if(!e.workflow)throw new u(`--workflow is required`);let r=await runWorkflowDispatch(cliFetcher(),{cwd:process.cwd(),repo:e.repo??void 0,workflow:e.workflow,ref:e.ref??`main`,inputs:parseInputs(collectInputArgs(t))});n.json(r),n.text(`Dispatched ${r.workflow} on ${r.repo} (ref: ${r.ref})`)}})};g.object({content:g.string(),encoding:g.literal(`base64`)});function encodeRepoPath(e){let t=e.split(`/`);if(t.some(e=>e===``||e===`.`||e===`..`))throw new f(`Refusing a repository path with a relative segment: ${e}`);return t.map(encodeURIComponent).join(`/`)}const ct=g.looseObject({name:g.string(),sha:g.string(),type:g.string()});g.array(ct);const lt=g.object({name:g.string(),protected:g.boolean().optional(),commit:g.object({id:g.string().optional(),timestamp:g.string().optional()}).optional()});async function listBranches(e,t,n={}){let r=n.signal,i=n.maxPages??20,a=[];for(let n=1;n<=i;n++){r?.throwIfAborted();let i=new URLSearchParams({limit:`50`,page:String(n)}),o=await e.fetch(`${repoBase(t)}/branches?${i.toString()}`,{headers:authHeaders(t),signal:r});o.ok||await throwForgejoFailure(o,{verb:`list branches`,resource:t.repository});let s=lt.array().safeParse(await o.json());if(!s.success)throw new f(`Unexpected branch list response: ${s.error.message}`);if(s.data.length===0)return{branches:a,truncated:!1};for(let e of s.data)a.push({name:e.name,protected:e.protected??!1,commitSha:e.commit?.id??null,commitDate:e.commit?.timestamp??null})}return{branches:a,truncated:!0}}const ut={403:`forbidden`,423:`locked`,404:`not-found`},dt=g.object({message:g.string()});async function refusalMessage(e){let t=await responseBodyText(e);try{let e=dt.safeParse(JSON.parse(t));if(e.success)return e.data.message}catch{}return t}async function deleteBranch(e,t,n){let r=await e.fetch(`${repoBase(t)}/branches/${encodeRepoPath(n)}`,{method:`DELETE`,headers:authHeaders(t)});if(r.ok)return{ok:!0};let i=ut[r.status];return i===void 0?throwForgejoFailure(r,{verb:`delete branch`,resource:`${t.repository}/${n}`}):{ok:!1,reason:i,status:r.status,message:await refusalMessage(r)}}const ft={forbidden:`forbidden`,locked:`locked`,"not-found":`not found`};function runBranchList(e,t){return listBranches(e,requireForgejoTarget(t.cwd,parseRepoTarget(t.repo),`branch:list is Forgejo-only -- use git branch -r on GitHub.`))}async function runBranchDelete(e,t){let n=await deleteBranch(e,requireForgejoTarget(t.cwd,parseRepoTarget(t.repo),`branch:delete is Forgejo-only -- use git push --delete on GitHub.`),t.name);if(!n.ok)throw new u(`Cannot delete branch "${t.name}": ${ft[n.reason]} (HTTP ${String(n.status)})${n.message===``?``:`: ${n.message}`}.`);return{deleted:t.name}}function renderBranch(e){let t=[e.name];return e.protected&&t.push(`protected`),e.commitSha!==null&&t.push(e.commitSha.slice(0,7)),t.join(` `)}function renderBranchList(e){let t=e.branches.map(renderBranch);return t.length===0&&t.push(`No branches.`),e.truncated&&t.push(`Listing truncated at the page cap; more branches exist.`),t.join(`
|
|
12
|
+
`)}const pt={"branch:delete":_({meta:{name:`branch:delete`,description:`Delete a branch; the forge's refusal (forbidden, locked) is reported (Forgejo-only)`},args:{name:{type:`positional`,required:!0,description:`Branch name`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: deleted.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=await runBranchDelete(cliFetcher(),{cwd:process.cwd(),name:e.name,repo:e.repo??void 0});t.json(n),t.text(`Deleted branch ${n.deleted}.`)}}),"branch:list":_({meta:{name:`branch:list`,description:`List a repository's branches (Forgejo-only)`},args:{repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: branches ([{name, protected, commitSha (or null), commitDate (or null)}]), truncated.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=await runBranchList(cliFetcher(),{cwd:process.cwd(),repo:e.repo??void 0});t.json({branches:n.branches,truncated:n.truncated}),t.text(renderBranchList(n))}})};function tryRead(e,t){try{return e()}catch(e){throw new u(`Could not read ${t}: ${p(e)}`)}}function readBodySource(t,r,i={}){let a=i.flags??{text:`--body`,file:`--body-file`};if(t!==void 0&&r!==void 0)throw new u(`Pass either ${a.text} or ${a.file}, not both.`);if(t!==void 0)return t;if(r!==void 0){if(r===`-`)return tryRead(i.readStdin??(()=>n(0,`utf-8`)),`stdin`);if(!e(r))throw new u(`${a.file} not found: ${r}`);return tryRead(()=>n(r,`utf-8`),`${a.file} "${r}"`)}}const q=g.object({id:g.number(),body:g.string().nullish(),user:g.object({login:g.string()}).nullish(),created_at:g.string(),updated_at:g.string().nullish(),html_url:g.string().nullish(),assets:ae.nullish()}),mt=g.array(q);function parseCommentOrThrow(e){let t=q.safeParse(e);if(!t.success)throw new f(`Unexpected comment response: ${t.error.message}`);return t.data}function parseCommentListOrThrow(e){let t=mt.safeParse(e);if(!t.success)throw new f(`Unexpected comment-list response: ${t.error.message}`);return t.data}function normalizeComment(e){return{id:e.id,author:e.user?.login??``,createdAt:e.created_at,updatedAt:e.updated_at??e.created_at,body:e.body??``,...e.html_url===void 0||e.html_url===null?{}:{url:e.html_url},attachments:(e.assets??[]).map(normalizeAttachment)}}async function listForgejoComments(e,t,n,r={}){let i=[];for(let a=1;a<=20;a++){let o=new URLSearchParams({limit:`50`,page:String(a)}),s=await e.fetch(`${issuesBase(t)}/${String(n)}/comments?${o.toString()}`,{headers:authHeaders(t)});s.ok||await throwForgejoFailure(s,{verb:`list comments`,resource:`#${String(n)}`},issueNotFoundMessage(t,n));let c=parseCommentListOrThrow(await s.json());if(i.push(...c.map(normalizeComment)),!morePagesFollow(s,c.length,i.length,50))break;a===20&&(I.warn(`Comment listing for #${String(n)} hit the 20-page cap; results may be truncated`),r.onPageCap?.())}return i}const ht=q.extend({issue_url:g.string().nullish(),pull_request_url:g.string().nullish(),updated_at:g.string().nullish()});g.array(ht);async function addForgejoComment(e,t,n,r){let i=await e.fetch(`${issuesBase(t)}/${String(n)}/comments`,{method:`POST`,headers:jsonHeaders(t),body:JSON.stringify({body:r})});return i.ok||await throwForgejoFailure(i,{verb:`comment on issue`,resource:`#${String(n)}`},issueNotFoundMessage(t,n)),normalizeComment(parseCommentOrThrow(await i.json()))}const gt=[`WIP:`,`[WIP]`];function hasWipPrefix(e){return matchedWipPrefix(e)!==void 0}function matchedWipPrefix(e){let t=e.toLowerCase();return gt.find(e=>t.startsWith(e.toLowerCase()))}function stripWipPrefix(e){let t=matchedWipPrefix(e);return t===void 0?e:e.slice(t.length).trimStart()}const _t=g.object({number:g.number(),html_url:g.string().optional()});function prWebUrl(e,t){return`${e.serverUrl}/${e.repository}/pulls/${String(t)}`}function headOfThisRepo(e,t){let n=e.repository.toLowerCase();return e=>e.headRef===t&&e.headRepo!==null&&e.headRepo.toLowerCase()===n}async function findOpenPrEntry(e,t,n,r=null){let i=headOfThisRepo(t,n),a=!1,o=(await listPulls(e,t,{state:`open`,stopWhen:i,onPageCap:()=>{a=!0},signal:r})).find(i);if(o!==void 0){if(o.baseRef===null)throw new f(`Open PR #${String(o.number)} on ${t.repository} carries no base branch`);return{number:o.number,base:o.baseRef}}if(a)throw new u(`Open PR lookup on ${t.repository} for head "${n}" hit the 20-page cap without finding it or reaching an empty page; a truncated read here reads as "no open PR" and makes a caller create a duplicate`);return null}async function findOpenPr(e,t,n,r=null){return(await findOpenPrEntry(e,t,n,r))?.number??null}async function listBranchPulls(e,t,n,r,i=null){let a=!1,o=await listPulls(e,t,{state:r,head:n,onPageCap:()=>{a=!0},signal:i}),s=headOfThisRepo(t,n),c=o.filter(s).map(e=>({number:e.number,base:e.baseRef,merged:e.merged}));if(a)throw new u(`Pull request listing on ${t.repository} for branch "${n}" hit the 20-page cap without reaching an empty page, so it cannot say how many pull requests that branch has; pass the pull request NUMBER instead of autodetecting it.`);return c}const vt=g.object({number:g.number(),title:g.string().nullish(),body:g.string().nullish(),head:g.object({ref:g.string(),repo:g.object({full_name:g.string()}).nullish()}),base:g.object({ref:g.string()}).nullish(),state:g.enum([`open`,`closed`]),merged:g.boolean().nullish(),merged_at:g.string().nullish(),html_url:g.string().nullish(),draft:g.boolean().nullish(),user:g.object({login:g.string().nullish()}).nullish(),updated_at:g.string().nullish(),labels:g.array(g.object({name:g.string()})).nullish()});function updatedBefore(e){return t=>t.updatedAt!==null&&Date.parse(t.updatedAt)<e}async function listPulls(e,t,n={}){let r=n.startPage??1;if(!Number.isInteger(r)||r<1)throw new u(`Cannot list PRs on ${t.repository}: startPage must be an integer of at least 1, got ${String(r)}`);let i=r+20-1,a={Authorization:`token ${t.token}`},o=[];for(let s=r;s<=i;s++){n.signal?.throwIfAborted();let r=new URLSearchParams({state:n.state??`all`,limit:`50`,page:String(s)}),c=n.updatedSince===void 0?n.sort:`recentupdate`;c!==void 0&&r.set(`sort`,c);for(let e of n.labelIds??[])r.append(`labels`,String(e));n.head!==void 0&&r.set(`head`,n.head);let l=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls?${r.toString()}`,u=await e.fetch(l,{headers:a,signal:n.signal??null});u.ok||await throwForgejoFailure(u,{verb:`list PRs`,resource:t.repository});let d=vt.array().safeParse(await u.json());if(!d.success)throw new f(`Unexpected PR list response: ${d.error.message}`);let p=d.data.map(e=>({number:e.number,title:e.title??null,body:e.body??null,headRef:e.head.ref,headRepo:e.head.repo?.full_name??null,baseRef:e.base?.ref??null,state:e.state,merged:e.merged??e.merged_at!=null,mergedAt:e.merged_at??null,url:e.html_url??null,draft:e.draft??null,author:e.user?.login??null,updatedAt:e.updated_at??null,labels:(e.labels??[]).map(e=>e.name)}));if(o.push(...p),p.length===0||n.stopWhen!==void 0&&p.some(n.stopWhen)||n.updatedSince!==void 0&&p.some(updatedBefore(n.updatedSince))||n.limit!==void 0&&o.length>=n.limit)break;s===i&&(I.warn(`PR listing on ${t.repository} hit the 20-page cap without an empty page; results may be truncated`),n.onPageCap?.(i))}return o}async function createPr(e,t,n){let r=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls`,i={title:n.title,head:n.head,base:n.base};n.body&&(i.body=n.body);let a=await e.fetch(r,{method:`POST`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify(i)});a.ok||await throwForgejoFailure(a,{verb:`create PR`,resource:`${n.head}->${n.base}`});let o=_t.safeParse(await a.json());if(!o.success)throw new f(`Unexpected create-PR response: ${o.error.message}`);return{number:o.data.number,htmlUrl:o.data.html_url??prWebUrl(t,o.data.number)}}g.object({body:g.string().nullish()});async function readPrField(e,t,n,r,i){let a=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls/${String(n)}`,o=await e.fetch(a,{headers:{Authorization:`token ${t.token}`}});o.ok||await throwForgejoFailure(o,{verb:`read PR ${i}`,resource:`#${String(n)}`});let s=r.safeParse(await o.json());if(!s.success)throw new f(`Unexpected PR ${i} response: ${s.error.message}`);return s.data}g.object({head:g.object({ref:g.string()})}),g.object({head:g.object({ref:g.string()}),base:g.object({ref:g.string()})});const J=g.object({ref:g.string(),sha:g.string(),repo:g.object({full_name:g.string()}).nullish()}),yt=g.object({head:J,base:J,draft:g.boolean(),merged:g.boolean(),mergeable:g.boolean().nullish(),merge_commit_sha:g.string().nullish(),state:g.string()}),bt=/^[0-9a-f]{7,64}$/;function isMergeCommitSha(e){return e!=null&&bt.test(e)}function normalizePrDetail(e){return{head:{ref:e.head.ref,sha:e.head.sha,repo:e.head.repo?.full_name??null},base:{ref:e.base.ref,sha:e.base.sha,repo:e.base.repo?.full_name??null},draft:e.draft,merged:e.merged,mergeable:e.mergeable??null,mergeCommitSha:isMergeCommitSha(e.merge_commit_sha)?e.merge_commit_sha:null,state:e.state}}async function getForgejoPrDetail(e,t,n){return normalizePrDetail(await readPrField(e,t,n,yt,`detail`))}const xt=g.object({state:g.string(),merged:g.boolean(),draft:g.boolean(),title:g.string(),head:g.object({ref:g.string()}),base:g.object({ref:g.string()}),mergeable:g.boolean().nullish(),html_url:g.string().optional()});async function getPrEditState(e,t,n){let r=await readPrField(e,t,n,xt,`edit state`);return{state:r.state,merged:r.merged,draft:r.draft,title:r.title,head:r.head.ref,base:r.base.ref,mergeable:r.mergeable??null,url:r.html_url??prWebUrl(t,n)}}async function retargetPr(e,t,n,r){let i=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls/${String(n)}`,a=await e.fetch(i,{method:`PATCH`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify({base:r})},{idempotent:!0});a.ok||await throwForgejoFailure(a,{verb:`retarget PR`,resource:`#${String(n)}`})}async function reopenPr(e,t,n){let r=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls/${String(n)}`,i=await e.fetch(r,{method:`PATCH`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify({state:`open`})},{idempotent:!0});i.ok||await throwForgejoFailure(i,{verb:`reopen PR`,resource:`#${String(n)}`})}const St=g.object({title:g.string(),body:g.string().nullish()});async function getPrContent(e,t,n){let r=await readPrField(e,t,n,St,`content`);return{title:r.title,body:r.body??``}}g.object({title:g.string(),draft:g.boolean()});async function updatePr(e,t,n,r){if(r.title===void 0&&r.body===void 0)return;let i=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls/${String(n)}`,a=await e.fetch(i,{method:`PATCH`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify({title:r.title,body:r.body})},{idempotent:!0});a.ok||await throwForgejoFailure(a,{verb:`update PR`,resource:`#${String(n)}`})}const Ct=g.object({id:g.number(),body:g.string(),commit_id:g.string().nullish(),user:g.object({login:g.string()}).nullish(),html_url:g.string().nullish(),submitted_at:g.string().nullish()});g.array(Ct),g.object({head:g.object({sha:g.string()})});const wt=g.object({body:g.string(),path:g.string().optional(),diff_hunk:g.string().optional(),user:g.object({login:g.string()}).nullish()});g.array(wt),g.array(g.object({id:g.number()}));var IssueNumberRequiredError=class extends u{constructor(){super(`An issue number or issue URL is required.`)}};function requireIssueNumber(e){if(e.number===void 0)throw new IssueNumberRequiredError;return e.number}function forgejoIssueApi(e,t){return{get:n=>getForgejoIssue(e,t,n),list:async(n,r)=>(await listForgejoIssuesDetailedPaged(e,t,{...n,type:`issues`},r)).slice(0,n.limit).map(({body:e,...t})=>t),comments:(n,r)=>listForgejoComments(e,t,n,r),create:n=>createForgejoIssue(e,t,n),update:(n,r)=>updateForgejoIssue(e,t,n,r),setState:(n,r)=>setForgejoIssueState(e,t,n,r),addComment:(n,r)=>addForgejoComment(e,t,n,r),pullRequest:n=>getForgejoPrDetail(e,t,n)}}function describeIssueNumberRequired(e){return`An issue number or issue URL is required, e.g. \`${e}\`.`}function describeInvalidListQuery(e,t){return e.field===`state`?`${t.state} must be one of open, closed, all (got "${e.value}")`:`${t.limit} must be a positive integer (got "${e.value}")`}function describeNothingToUpdate(e){return`Nothing to change -- pass ${e.title} and/or ${e.body}/${e.bodyFile}. (Omitting them leaves the issue exactly as authored; this command never derives a replacement.)`}function describeEmptyComment(e){return`${e.text} / ${e.file} resolved to empty text -- pass a comment or omit the flag.`}function describePullRequestState(e,t){return`#${String(e.number)} is a pull request, not an issue -- ${t.command} refuses to write pull-request state. ${t.advice}`}function describeNoLabelsGiven(e,t){return`No labels given, which would strip every label off #${String(e.number)}. Pass ${t} if that is what you mean, or name the labels the issue should end up with.`}function describeAttachmentExists(e,t){return`"${e.filePath}" already exists -- pass ${t} to overwrite it.`}var NothingToUpdateError=class extends u{constructor(){super(`Nothing to change: neither a title nor a body was given.`)}},IssueTitleRequiredError=class extends u{constructor(){super(`An issue title is required.`)}},InvalidListQueryError=class extends u{field;value;constructor(e,t){super(`The list ${e} is not valid (got "${t}").`),this.field=e,this.value=t}};async function viewIssue(e,t){let n=parseIssueRef(t.ref),r=requireIssueNumber(n),{api:i}=e(resolveIssueTarget(n.target,t.repo)),a=!1,[o,s]=await Promise.all([i.get(r),i.comments(r,{onPageCap:()=>{a=!0}})]);if(!o.isPullRequest)return{...o,comments:s,commentsTruncated:a};try{return{...o,comments:s,commentsTruncated:a,pr:await i.pullRequest(r)}}catch(e){if(!(e instanceof ForgeAccessError))throw e;return{...o,comments:s,commentsTruncated:a,prUnavailable:{reason:m(e.message)}}}}function formatPrHead(e){return e.head.repo===null?`${e.head.ref} (head repo gone)`:e.head.repo===e.base.repo?e.head.ref:`${e.head.repo}:${e.head.ref}`}function formatMergeable(e){return e===null?`mergeable: unknown`:e?`mergeable`:`not mergeable`}function formatPrLine(e){let t=e.head.sha.slice(0,12),n=`pr: ${formatPrHead(e)} -> ${e.base.ref} head ${t}`;return e.draft&&(n+=` draft`),e.merged&&(n+=` merged`),n+=` ${formatMergeable(e.mergeable)}`,n}function formatPrUnavailableLine(e){let t=e.reason.indexOf(`
|
|
12
13
|
`);return`pr: unavailable -- ${t===-1?e.reason:e.reason.slice(0,t)}`}function formatIssue(e){let t=[],n=e.labels.length>0?` labels: ${e.labels.join(`, `)}`:``;if(t.push(`#${String(e.number)} ${e.title} [${e.state}]`),t.push(`${e.author} - ${e.createdAt}${n}`),e.assignees.length>0&&t.push(`assigned: ${e.assignees.join(`, `)}`),t.push(e.url),e.pr===void 0?e.prUnavailable!==void 0&&t.push(formatPrUnavailableLine(e.prUnavailable)):t.push(formatPrLine(e.pr)),t.push(``),t.push(e.body===``?`(no description)`:e.body),e.attachments.length>0){t.push(``),t.push(`-- ${String(e.attachments.length)} attachment(s) --`);for(let n of e.attachments)t.push(`${n.name} (${String(n.size)} bytes)`)}if(e.comments.length>0){t.push(``),t.push(`-- ${String(e.comments.length)} comment(s) --`);for(let n of e.comments)t.push(``),t.push(`${n.author} - ${n.createdAt}`),t.push(n.body);e.commentsTruncated&&(t.push(``),t.push(`(comment listing hit the page cap; the thread may be truncated)`))}return t.join(`
|
|
13
14
|
`)}function parseState$1(e){if(e===`open`||e===`closed`||e===`all`)return e;throw new InvalidListQueryError(`state`,e)}function parseLimit(e){let t=Number(e);if(!Number.isInteger(t)||t<=0)throw new InvalidListQueryError(`limit`,e);return t}function normalizeLabel(e){if(e!==void 0&&e.trim()!==``)return e}async function listIssues(e,t){let n=normalizeLabel(t.label),r={state:parseState$1(t.state),limit:parseLimit(t.limit),...n===void 0?{}:{label:n}},{api:i}=e(parseRepoTarget(t.repo)),a=!1;return{issues:await i.list(r,{onPageCap:()=>{a=!0}}),truncated:a}}async function commentOnIssue(e,t){let n=parseIssueRef(t.ref),r=requireIssueNumber(n),{api:i,target:a}=e(resolveIssueTarget(n.target,t.repo)),o=`${a.serverUrl}/${a.repository}/issues/${String(r)}`;return t.dryRun||await i.addComment(r,t.body),{number:r,url:o}}function formatIssueComment(e,t){return`${t?`[dry-run] Would comment`:`Commented`} on issue #${String(e.number)}`}async function updateIssue(e,t){let n=parseIssueRef(t.ref),r=requireIssueNumber(n),i={title:t.title,body:t.body},a=[`title`,`body`].filter(e=>i[e]!==void 0);if(a.length===0)throw new NothingToUpdateError;let{api:o}=e(resolveIssueTarget(n.target,t.repo)),s=await o.get(r),c={title:s.title,body:s.body},l={title:i.title??s.title,body:i.body??s.body};if(t.dryRun)return{number:r,url:s.url,previous:c,current:l,changed:a};let u=await o.update(r,i);return{number:r,url:u.url,previous:c,current:{title:u.title,body:u.body},changed:a}}function formatIssueUpdate(e,t){let n=[`${t?`Would update`:`Updated`} issue #${String(e.number)} (${e.url})`],r=[`title`,`body`].filter(t=>!e.changed.includes(t));if(e.changed.includes(`title`)&&(e.previous.title===e.current.title?n.push(` title: unchanged (already that value)`):(n.push(` title: ${e.previous.title}`),n.push(` -> ${e.current.title}`))),e.changed.includes(`body`)){if(e.previous.body===e.current.body)n.push(` body: unchanged (already that value)`);else{let t=e.previous.body===``?0:e.previous.body.split(`
|
|
14
15
|
`).length,r=e.current.body===``?0:e.current.body.split(`
|
|
15
16
|
`).length;n.push(` body: replaced (${String(t)} line(s) -> ${String(r)} line(s))`)}}return r.length>0&&n.push(` ${r.join(` and `)} left as authored`),n.join(`
|
|
16
17
|
`)}function droppedAssignees(e,t){let n=new Set(t.map(e=>e.toLowerCase()));return e.filter(e=>!n.has(e.toLowerCase()))}async function createIssue(e,t){let n=t.title.trim();if(n===``)throw new IssueTitleRequiredError;let{api:r}=e(parseRepoTarget(t.repo));if(t.dryRun)return{number:0,url:``,assignees:t.assignees};let i=await r.create({title:n,body:t.body,labels:t.labels,...t.assignees.length>0?{assignees:t.assignees}:{}});if(t.assignees.length>0){let e=droppedAssignees(t.assignees,i.assignees);if(e.length>0)throw new u(`Issue #${String(i.number)} (${i.url}) was created, but the forge did not assign ${e.join(`, `)}. The issue exists -- do not retry the create.`)}return{number:i.number,url:i.url,assignees:t.assignees}}function formatIssueCreate(e,t,n){if(n)return[`[dry-run] Would open an issue titled "${t}"${e.assignees.length>0?` assigned to ${e.assignees.join(`, `)}`:``}`];let r=[`Opened issue #${String(e.number)}`];return e.url!==``&&r.push(e.url),r}function formatIssueList(e){let t=[];return e.issues.length===0?t.push(`No issues found.`):t.push(e.issues.map(e=>{let t=e.labels.length>0?` [${e.labels.join(`, `)}]`:``;return`#${String(e.number).padEnd(5)} ${e.state.padEnd(6)} ${e.title}${t}`}).join(`
|
|
17
18
|
`)),e.truncated&&(t.push(``),t.push(`(issue listing hit the page cap; results may be truncated)`)),t.join(`
|
|
18
|
-
`)}function githubRefusal(e){return`bst-fj is Forgejo-only -- use \`gh\` or \`pnpm exec bst ${e}\` for a github.com repository.`}function forgejoIssueTarget(e,t,n){let r=requireForgejoTarget(e,t,githubRefusal(n));return{fetcher:cliFetcher(),conn:r,target:t??{serverUrl:r.serverUrl,repository:r.repository,hostname:new URL(r.serverUrl).hostname}}}function forgejoIssueTransport(e,t,n){let r=forgejoIssueTarget(e,t,n);return{api:forgejoIssueApi(r.fetcher,r.conn),target:r.target}}const
|
|
19
|
-
`)}const
|
|
20
|
-
`)}function defineIssueLabelCommand(e){let t=e===`add`?`issue:label`:`issue:unlabel`;return _({meta:{name:t,description:e===`add`?`Add a label to an issue (Forgejo only)`:`Remove a label from an issue (Forgejo only)`},args:{ref:{type:`positional`,required:!0,description:`Issue number or issue URL`},label:{type:`positional`,required:!0,description:e===`add`?`Label name to add`:`Label name to remove`},repo:{type:`string`,description:`Target repository URL (default: this repo's origin)`},json:{type:`boolean`,description:`Emit one JSON document: number, label, action (add | remove), url.`},"dry-run":{type:`boolean`,description:`Report what would change, mutate nothing`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:n}){let r=createCliOutput(n.json===!0),i=process.cwd(),a=n[`dry-run`]===!0;try{let o=await labelIssue(e=>forgejoIssueTarget(i,e,t),{ref:n.ref,label:n.label,action:e,dryRun:a,...n.repo===void 0?{}:{repo:n.repo}});r.json(o),r.text(formatIssueLabel(o,a))}catch(e){throw e instanceof IssueNumberRequiredError?new u(describeIssueNumberRequired(`pnpm exec bst-fj ${t} 273 agent/implement`)):e}}})}const
|
|
21
|
-
`)}function defineIssueStateCommand(e){let t=e===`close`?`issue:close`:`issue:reopen`;return _({meta:{name:t,description:e===`close`?`Close an issue, optionally posting a comment first. An issue already closed is reported, not an error, and no comment is posted. A pull request is refused.`:`Reopen an issue, optionally posting a comment first. An issue already open is reported, not an error, and no comment is posted. A pull request is refused.`},args:{ref:{type:`positional`,required:!0,description:`Issue number or issue URL`},comment:{type:`string`,description:`Post this comment before writing state`},"comment-file":{type:`string`,description:`Read the comment from a file ('-' for stdin)`},repo:{type:`string`,description:`Target repository URL (default: this repo's origin)`},json:{type:`boolean`,description:`Emit one JSON document: number, url, action (close | reopen), state ({previous, current}), changed, comment? ({posted}; present only when a comment was given).`},"dry-run":{type:`boolean`,description:`Report what would change, mutate nothing`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:n}){let r=createCliOutput(n.json===!0),i=process.cwd(),a={text:`--comment`,file:`--comment-file`},o=readBodySource(n.comment??void 0,n[`comment-file`]??void 0,{flags:a}),s=n[`dry-run`]===!0;try{let a=await setIssueState(e=>forgejoIssueTransport(i,e,t),{ref:n.ref,action:e,dryRun:s,...o===void 0?{}:{comment:o},...n.repo===void 0?{}:{repo:n.repo}});r.json(a),r.text(formatIssueState(a,s)),s&&o!==void 0&&a.comment?.posted===!0&&r.text(`[dry-run] Comment that would be posted:\n${o}`)}catch(n){if(n instanceof IssueNumberRequiredError)throw new u(describeIssueNumberRequired(`pnpm exec bst-fj ${t} 273`));if(n instanceof EmptyCommentError)throw new u(describeEmptyComment(a));if(n instanceof PullRequestStateError){let r=e===`close`?`Run \`pnpm exec bst-fj pr:close ${String(n.number)}\` to close it.`:`Run \`pnpm exec bst-fj pr:reopen ${String(n.number)}\` to reopen it.`;throw new u(describePullRequestState(n,{command:`bst-fj ${t}`,advice:r}))}throw n}}})}const Ot=defineIssueStateCommand(`close`),kt=defineIssueStateCommand(`reopen`),At=_({meta:{name:`issue:list`,description:`List a repository's issues (pull requests are excluded)`},args:{state:{type:`string`,default:`open`,description:`open | closed | all`},label:{type:`string`,description:`Filter by label name`},limit:{type:`string`,default:`30`,description:`Maximum issues to return (at most 1000 are read); --json reports truncated: true when that cap cut the list short`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: issues ([{number, title, state, url, author, labels, createdAt, updatedAt, closedAt (null while open), isPullRequest, assignees, attachments ([{id, name, size, createdAt, downloadUrl}])}]), truncated.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=process.cwd();try{let r=await listIssues(e=>forgejoIssueTransport(n,e,`issue:list`),{state:e.state,limit:e.limit,...e.label===void 0?{}:{label:e.label},...e.repo===void 0?{}:{repo:e.repo}});t.json({issues:r.issues,truncated:r.truncated}),t.text(formatIssueList(r))}catch(e){throw e instanceof InvalidListQueryError?new u(describeInvalidListQuery(e,{state:`--state`,limit:`--limit`})):e}}}),jt=_({meta:{name:`issue:update`,description:`Edit an existing issue's title and/or body`},args:{ref:{type:`positional`,required:!0,description:`Issue number or issue URL`},title:{type:`string`,description:`Replace the title (default: leave it unchanged)`},body:{type:`string`,description:`Replace the body (default: leave it unchanged)`},"body-file":{type:`string`,description:`Read the new body from a file ('-' for stdin)`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: number, url, previous ({title, body}), current ({title, body}), changed ([title | body]). A dry run reports current as it would be and writes nothing.`},"dry-run":{type:`boolean`,description:`Report what would change, mutate nothing`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=process.cwd(),r=readBodySource(e.body??void 0,e[`body-file`]??void 0),i=e[`dry-run`]===!0;try{let a=await updateIssue(e=>forgejoIssueTransport(n,e,`issue:update`),{ref:e.ref,dryRun:i,...e.title===void 0?{}:{title:e.title},...r===void 0?{}:{body:r},...e.repo===void 0?{}:{repo:e.repo}});if(t.json(a),t.text(formatIssueUpdate(a,i)),i&&a.changed.includes(`body`)){let e=a.previous.body===``?`(empty)`:a.previous.body;t.text(`[dry-run] Current body:\n${e}`)}}catch(e){throw e instanceof IssueNumberRequiredError?new u(describeIssueNumberRequired(`pnpm exec bst-fj issue:update 273 --title '...'`)):e instanceof NothingToUpdateError?new u(describeNothingToUpdate({title:`--title`,body:`--body`,bodyFile:`--body-file`})):e}}}),Mt={"issue:view":_({meta:{name:`issue:view`,description:`Show an issue and its comments (accepts a number or an issue URL). Comments come oldest first. Review comments on a pull request are not included.`},args:{ref:{type:`positional`,required:!0,description:`Issue number or issue URL`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: number, title, state, url, author, labels, createdAt, updatedAt, closedAt, body, isPullRequest, assignees, attachments, comments ([{id, author, createdAt, updatedAt?, body, url?}]), commentsTruncated, pr? ({head ({ref, sha, repo (or null)}), base ({ref, sha, repo (or null)}), draft, merged, mergeable (true | false | null), state}), prUnavailable? ({reason}). On a pull request exactly one of pr and prUnavailable is present, and neither is otherwise; repo is null for a deleted fork; commentsTruncated is true when the comment read hit its cap of about 1000.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=process.cwd();try{let r=await viewIssue(e=>forgejoIssueTransport(n,e,`issue:view`),{ref:e.ref,...e.repo===void 0?{}:{repo:e.repo}});t.json(r),t.text(formatIssue(r))}catch(e){throw e instanceof IssueNumberRequiredError?new u(describeIssueNumberRequired(`pnpm exec bst-fj issue:view 273`)):e}}}),"issue:list":At,"issue:comment":vt,"issue:create":yt,"issue:update":jt,"issue:close":Ot,"issue:reopen":kt,"issue:label":Ct,"issue:unlabel":wt,"issue:set-labels":Tt,"issue:download":xt};async function resolvePrChecksTarget(e,t){let n=parseIssueRef(t.pr);if(t.repo!==void 0&&n.number===void 0&&t.branch===void 0)throw new u(`--repo requires --pr or --branch -- the current branch of this checkout means nothing in another repository, and inferring it there would silently answer about the wrong PR.`);let r=requireForgejoTarget(t.cwd,resolveIssueTarget(n.target,t.repo),"pr:checks is Forgejo-only: GitHub Actions publishes check runs, not commit statuses, so a combined-status read against a github.com PR would confidently report `no-status` for a green PR. Use `gh pr checks --watch` instead."),i;if(n.number!==void 0)i=n.number;else{let n=t.branch??resolveCurrentBranch({cwd:t.cwd,git:t.git,env:t.env});if(n===void 0)throw new u(`Could not determine the current branch (detached HEAD, or not a git repository) -- pass --branch or --pr explicitly.`);let a=await findOpenPr(e,r,n);if(a===null)throw new u(`No open pull request found for branch "${n}".`);i=a}let a=await getForgejoPrDetail(e,r,i);return{prNumber:i,conn:r,url:prWebUrl(r,i),detail:a}}async function readBaseline(e,t,n,r){if(!r)return{ref:n,status:`skipped`,redNames:[]};let unavailable=(e,t)=>t===void 0?{ref:n,status:`unavailable`,reason:e,redNames:[]}:{ref:n,sha:t,status:`unavailable`,reason:e,redNames:[]},i;try{i=await getBranchHeadSha(e,t,n)}catch(e){return unavailable(p(e))}let a;try{a=await readCommitChecks(e,t,i)}catch(e){return unavailable(p(e),i)}if(!a.parsed)return unavailable(`The base branch's commit status response did not match the shape this build expects.`,i);if(a.contexts.length===0)return unavailable(`No checks have been posted for ${n}'s current head (${i}).`,i);let o=a.contexts.filter(e=>e.verdict===`red`).map(e=>e.name);return{ref:n,sha:i,status:`read`,redNames:o}}function buildReport(e,t,n,r={}){let{target:i,baseline:a,notices:o,waited:s,elapsedMs:c}=n,l=new Set(a.status===`read`?a.redNames:[]),u=r.statusOverride??classifyBaseStatus(t),d={pr:i.prNumber,repository:i.conn.repository,url:i.url,state:e.state,headSha:e.head.sha,baseRef:e.base.ref,status:u,settled:isSettled(t),combinedState:t.state,waited:s,elapsedMs:c,checks:t.contexts.map(e=>({...e,preexisting:e.verdict===`red`&&l.has(e.name)})),baseline:a,notices:o};return r.detailOverride===void 0?u===`unparseable`&&(d.detail=`The commit status response did not match the shape this build expects.`):d.detail=r.detailOverride,r.previousHeadSha!==void 0&&(d.previousHeadSha=r.previousHeadSha),d}async function waitForSettledChecks(e,t,n,r,i){let a=t.detail,o=0,reportFor=(e,i,a,o={})=>buildReport(e,i,{target:t,baseline:n,notices:r,waited:!0,elapsedMs:a},o);return settleChecks(e,t.conn,i,{sha:()=>a.head.sha,notices:r,report:(e,t)=>{let n={};return t.exit===`timeout`?n.statusOverride=`timeout`:t.exit===`retry-budget`&&(n.statusOverride=`unparseable`,t.failureDetail!==void 0&&(n.detailOverride=t.failureDetail)),reportFor(a,e,t.elapsed(),n)},afterSleep:async(n,r)=>{let i;try{i=await getForgejoPrDetail(e,t.conn,t.prNumber),o=0}catch(e){if(o+=1,o>=3)throw e;return`retry`}return i.head.sha===n?(a=i,`next`):{done:reportFor(i,B,r(),{statusOverride:`head-moved`,previousHeadSha:n})}}})}async function runPrChecks(e,t){let n=t.wait===!0?resolvePollTimings(t):void 0,r=await resolvePrChecksTarget(e,t),i=[],a=r.detail.merged||r.detail.state!==`open`;r.detail.merged?i.push(`PR #${String(r.prNumber)} is merged -- reporting its last checks rather than a live wait.`):r.detail.state!==`open`&&i.push(`PR #${String(r.prNumber)} is closed (not merged) -- reporting its last checks rather than a live wait.`);let o=await readBaseline(e,r.conn,r.detail.base.ref,t.baseline??!0);if(n!==void 0&&!a)return waitForSettledChecks(e,r,o,i,{...n,sleep:t.sleep??sleep,now:t.now??Date.now});let s=await readCommitChecks(e,r.conn,r.detail.head.sha);return pushDisagreementNotice(i,r.detail.head.sha,s),buildReport(r.detail,s,{target:r,baseline:o,notices:i,waited:!1,elapsedMs:0})}function baselineClause(e){if(e.baseline.status!==`read`)return null;let t=e.checks.filter(e=>e.verdict===`red`);if(t.length===0)return null;let n=t.filter(e=>e.preexisting).length;return`${String(t.length)} red, ${String(n)} of them already red on `+e.baseline.ref}function renderPrChecks(e){let t=e.checks.map(e=>renderCheckLine(e)),n=[`head ${e.headSha.slice(0,12)}: ${e.status}`],r=baselineClause(e);return r!==null&&n.push(r),n.push(e.url),t.push(n.join(` -- `)),t.join(`
|
|
22
|
-
`)}const
|
|
23
|
-
`)}function parsePrNumber(e){let t=Number(e);if(!/^\d+$/.test(e)||!Number.isSafeInteger(t)||t<1)throw new u(`Invalid pull request number "${e}" (expected a positive integer).`);return t}const
|
|
24
|
-
`).map(e=>e.trim()).filter(e=>e!==``)}async function commitMessages(e,t,n,r=null){let i=await e.run([`log`,`-z`,`--format=%B`,`${n}..HEAD`],{cwd:t,timeoutMs:Y,signal:r});if(i.exitCode!==0)throw new u(`Failed to read commit messages: ${i.stderr||i.stdout}`);return i.stdout.split(`\0`).map(e=>e.trim()).filter(e=>e!==``)}async function hasUncommittedChanges(e,t,n=null){return(await e.run([`status`,`--porcelain`],{cwd:t,timeoutMs:Y,signal:n})).stdout.trim()!==``}async function pushBranch(e,t,n,r,i=!1){let a=i?[`push`,`--force-with-lease`,`-u`,`origin`,n]:[`push`,`-u`,`origin`,n],o=await e.run(a,r===void 0?{cwd:t,timeoutMs:X,signal:null}:{cwd:t,env:r,timeoutMs:X,signal:null});if(o.exitCode!==0)throw new u(`Failed to push ${n}: ${o.stderr||o.stdout}`)}const
|
|
19
|
+
`)}function githubRefusal(e){return`bst-fj is Forgejo-only -- use \`gh\` or \`pnpm exec bst ${e}\` for a github.com repository.`}function forgejoIssueTarget(e,t,n){let r=requireForgejoTarget(e,t,githubRefusal(n));return{fetcher:cliFetcher(),conn:r,target:t??{serverUrl:r.serverUrl,repository:r.repository,hostname:new URL(r.serverUrl).hostname}}}function forgejoIssueTransport(e,t,n){let r=forgejoIssueTarget(e,t,n);return{api:forgejoIssueApi(r.fetcher,r.conn),target:r.target}}const Tt=_({meta:{name:`issue:comment`,description:`Post a new comment on an issue (append-only)`},args:{ref:{type:`positional`,required:!0,description:`Issue number or issue URL`},body:{type:`string`,description:`Comment body`},"body-file":{type:`string`,description:`Read the body from a file ('-' for stdin)`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: number, url.`},"dry-run":{type:`boolean`,description:`Show what would happen without writing`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=process.cwd(),r=readBodySource(e.body??void 0,e[`body-file`]??void 0);if(r===void 0)throw new u(`One of --body or --body-file is required.`);let i=e[`dry-run`]===!0;try{let a=await commentOnIssue(e=>forgejoIssueTransport(n,e,`issue:comment`),{ref:e.ref,body:r,dryRun:i,...e.repo===void 0?{}:{repo:e.repo}});t.json(a),t.text(formatIssueComment(a,i))}catch(e){throw e instanceof IssueNumberRequiredError?new u(describeIssueNumberRequired(`pnpm exec bst-fj issue:comment 273`)):e}}}),Et=_({meta:{name:`issue:create`,description:`Open a new issue`},args:{title:{type:`string`,required:!0,description:`Issue title`},body:{type:`string`,description:`Issue body`},"body-file":{type:`string`,description:`Read the body from a file ('-' for stdin)`},label:{type:`string`,description:`Label name (repeatable)`},repo:{type:`string`,description:`Repository URL (default: this repo)`},assignee:{type:`string`,description:`Assignee username (repeatable; --no-assignee opens the issue unassigned)`},json:{type:`boolean`,description:`Emit one JSON document: number, url, assignees. A dry run reports number 0 and an empty url.`},"dry-run":{type:`boolean`,description:`Show what would happen without writing`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e,rawArgs:t}){let n=createCliOutput(e.json===!0),r=process.cwd(),i=collectFlagValues(t,`--label`),a=resolveRepeatableFlag(t,`--assignee`,`--no-assignee`,{noun:`assignee username`,example:`alice`}),o=a.kind===`values`?a.values:[],s=readBodySource(e.body??void 0,e[`body-file`]??void 0)??``,c=e[`dry-run`]===!0;try{let t=await createIssue(e=>forgejoIssueTransport(r,e,`issue:create`),{title:e.title,body:s,labels:i,assignees:o,dryRun:c,...e.repo===void 0?{}:{repo:e.repo}});n.json(t);for(let r of formatIssueCreate(t,e.title,c))n.text(r)}catch(e){throw e instanceof IssueTitleRequiredError?new u(`--title is required.`):e}}});function isReadableFile(e){try{return n(e),!0}catch{return!1}}const Dt={exists:isReadableFile,write:(e,n)=>{t(o.dirname(e),{recursive:!0}),i(e,n)}};var AttachmentExistsError=class extends u{filePath;constructor(e){super(`"${e}" already exists.`),this.filePath=e}};function sanitizeAttachmentName(e){let t=Array.from(e).filter(e=>{let t=e.codePointAt(0)??0;return!(t<=31||t===127)}).join(``),n=o.basename(t.replaceAll(`\\`,`/`));if(n===``||n===`.`||n===`..`)throw new u(`Refusing to write an attachment with an unusable filename: "${e}"`);return n}function resolveTargetPath(e,t,n){let r=sanitizeAttachmentName(t),i=o.extname(r),a=r.slice(0,r.length-i.length),s=r,c=2;for(;n.has(s);)s=`${a}-${String(c)}${i}`,c+=1;n.add(s);let l=o.resolve(e,s),d=o.resolve(e);if(l!==d&&!l.startsWith(d+o.sep))throw new u(`Refusing to write outside ${e}: "${t}"`);return l}async function downloadAttachment(e,t,n){let r=await e.fetch(n.downloadUrl,{headers:{Authorization:`token ${t}`}},{timeoutMs:6e5});if(r.status===401||r.status===403||r.status===404)throw new u(`Cannot download "${n.name}" (HTTP ${String(r.status)}) -- the token needs issue scope and access to this repository.`);if(r.status===410||r.status===422)throw new u(`Cannot download "${n.name}": HTTP ${String(r.status)} -- this attachment is permanently unavailable; retrying will not help.`);if(!r.ok)throw new d(`Failed to download "${n.name}": HTTP ${String(r.status)}`);let i=new Uint8Array(await r.arrayBuffer());if(i.byteLength!==n.size)throw new u(`Refusing to write "${n.name}": expected ${String(n.size)} bytes but received ${String(i.byteLength)}. The server returned a 200 with the wrong content -- most likely a login page, meaning the token cannot see this attachment.`);return i}async function downloadIssueAttachments(e,t){let n=parseIssueRef(t.ref),r=requireIssueNumber(n),{fetcher:i,conn:a}=e(resolveIssueTarget(n.target,t.repo)),s=t.files??Dt,c=await getForgejoIssue(i,a,r),l=await listForgejoComments(i,a,r),u=[...c.attachments,...l.flatMap(e=>e.attachments)],d=t.outDir,f=/* @__PURE__ */ new Set,p=[];for(let e of u){let n=resolveTargetPath(d,e.name,f);if(!t.force&&s.exists(n))throw new AttachmentExistsError(n);if(!t.dryRun){let t=await downloadAttachment(i,a.token,e);s.write(n,t)}p.push({name:o.basename(n),size:e.size,path:n})}return{dir:d,files:p}}function formatDownload(e,t){let n=[],r=t?`[dry-run] Would download`:`Downloaded`;n.push(`${r} ${String(e.files.length)} attachment(s) to ${e.dir}`);for(let t of e.files)n.push(` ${t.name} (${String(t.size)} bytes)`);return n.join(`
|
|
20
|
+
`)}const Ot=_({meta:{name:`issue:download`,description:`Download an issue's attachments (Forgejo only)`},args:{ref:{type:`positional`,required:!0,description:`Issue number or issue URL`},out:{type:`string`,default:`.`,description:`Directory to download into`},force:{type:`boolean`,description:`Overwrite existing files`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: dir, files ([{name, size, path}]). A dry run lists the files it would write and writes nothing.`},"dry-run":{type:`boolean`,description:`List what would be downloaded, write nothing`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=process.cwd(),r=e[`dry-run`]===!0;try{let i=await downloadIssueAttachments(e=>forgejoIssueTarget(n,e,`issue:download`),{ref:e.ref,outDir:o.resolve(n,e.out),force:e.force===!0,dryRun:r,...e.repo===void 0?{}:{repo:e.repo}});t.json(i),t.text(formatDownload(i,r))}catch(e){throw e instanceof IssueNumberRequiredError?new u(describeIssueNumberRequired(`pnpm exec bst-fj issue:download 273`)):e instanceof AttachmentExistsError?new u(describeAttachmentExists(e,`--force`)):e}}}),kt=g.object({id:g.number(),type:g.string(),body:g.string().nullish(),created_at:g.string(),label:g.object({name:g.string()}).nullish(),user:g.object({login:g.string()}).nullish()});g.array(kt).nullable();async function resolveLabelId(e,t,n,r){let i=r?.get(n);if(i!==void 0)return i;let[a]=await resolveLabelIds(e,t,[n]);if(a===void 0)throw new f(`Label id resolution returned nothing for "${n}"`);return a}async function addForgejoIssueLabel(e,t,n,r,i){let a=await resolveLabelId(e,t,r,i),o=await e.fetch(`${issuesBase(t)}/${String(n)}/labels`,{method:`POST`,headers:jsonHeaders(t),body:JSON.stringify({labels:[a]})},{idempotent:!0});o.ok||await throwForgejoFailure(o,{verb:`add label`,resource:`#${String(n)}`},issueNotFoundMessage(t,n))}async function removeForgejoIssueLabel(e,t,n,r,i){let a=await resolveLabelId(e,t,r,i),o=await e.fetch(`${issuesBase(t)}/${String(n)}/labels/${String(a)}`,{method:`DELETE`,headers:authHeaders(t)},{idempotent:!0});o.ok||await throwForgejoFailure(o,{verb:`remove label`,resource:`#${String(n)}`},issueNotFoundMessage(t,n))}async function replaceForgejoIssueLabels(e,t,n,r){let i=await e.fetch(`${issuesBase(t)}/${String(n)}/labels`,{method:`PUT`,headers:jsonHeaders(t),body:JSON.stringify({labels:r})},{idempotent:!0});i.ok||await throwForgejoFailure(i,{verb:`replace labels`,resource:`#${String(n)}`},issueNotFoundMessage(t,n))}async function labelIssue(e,t){let n=parseIssueRef(t.ref),r=requireIssueNumber(n),{fetcher:i,target:a,conn:o}=e(resolveIssueTarget(n.target,t.repo)),s=`${a.serverUrl}/${a.repository}/issues/${String(r)}`;return t.dryRun||(t.action===`add`?await addForgejoIssueLabel(i,o,r,t.label):await removeForgejoIssueLabel(i,o,r,t.label)),{number:r,label:t.label,action:t.action,url:s}}function formatIssueLabel(e,t){let n=e.action===`add`,r;r=n?t?`Would add`:`Added`:t?`Would remove`:`Removed`;let i=n?`to`:`from`;return`${r} label "${e.label}" ${i} #${String(e.number)} (${e.url})`}var NoLabelsGivenError=class extends u{number;constructor(e){super(`No labels given, which would strip every label off #${String(e)}.`),this.number=e}};async function setIssueLabels(e,t){let n=parseIssueRef(t.ref),r=requireIssueNumber(n);if(t.labels.length===0&&t.clear!==!0)throw new NoLabelsGivenError(r);let{fetcher:i,target:a,conn:o}=e(resolveIssueTarget(n.target,t.repo)),s=`${a.serverUrl}/${a.repository}/issues/${String(r)}`,c=(await getForgejoIssue(i,o,r)).labels,l=diffLabels(c,t.labels);return t.dryRun||await replaceForgejoIssueLabels(i,o,r,await resolveLabelIds(i,o,t.labels)),{number:r,labels:t.labels,previous:c,url:s,...l}}function diffLabels(e,t){let n=new Set(e),r=new Set(t);return{added:t.filter(e=>!n.has(e)),removed:e.filter(e=>!r.has(e))}}function formatIssueSetLabels(e,t){let n=`${t?`Would set`:`Set`} labels [${e.labels.length===0?`(none)`:e.labels.join(`, `)}] on #${String(e.number)} (${e.url})`;if(e.added.length===0&&e.removed.length===0)return`${n}\n no change (the issue already carries exactly these)`;let r=[n];return e.removed.length>0&&r.push(` ${t?`would remove`:`removed`}: ${e.removed.join(`, `)}`),e.added.length>0&&r.push(` ${t?`would add`:`added`}: ${e.added.join(`, `)}`),r.join(`
|
|
21
|
+
`)}function defineIssueLabelCommand(e){let t=e===`add`?`issue:label`:`issue:unlabel`;return _({meta:{name:t,description:e===`add`?`Add a label to an issue (Forgejo only)`:`Remove a label from an issue (Forgejo only)`},args:{ref:{type:`positional`,required:!0,description:`Issue number or issue URL`},label:{type:`positional`,required:!0,description:e===`add`?`Label name to add`:`Label name to remove`},repo:{type:`string`,description:`Target repository URL (default: this repo's origin)`},json:{type:`boolean`,description:`Emit one JSON document: number, label, action (add | remove), url.`},"dry-run":{type:`boolean`,description:`Report what would change, mutate nothing`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:n}){let r=createCliOutput(n.json===!0),i=process.cwd(),a=n[`dry-run`]===!0;try{let o=await labelIssue(e=>forgejoIssueTarget(i,e,t),{ref:n.ref,label:n.label,action:e,dryRun:a,...n.repo===void 0?{}:{repo:n.repo}});r.json(o),r.text(formatIssueLabel(o,a))}catch(e){throw e instanceof IssueNumberRequiredError?new u(describeIssueNumberRequired(`pnpm exec bst-fj ${t} 273 agent/implement`)):e}}})}const At=defineIssueLabelCommand(`add`),jt=defineIssueLabelCommand(`remove`),Mt=_({meta:{name:`issue:set-labels`,description:`Replace an issue's entire label set in one atomic call (Forgejo only)`},args:{ref:{type:`positional`,required:!0,description:`Issue number or issue URL`},labels:{type:`positional`,required:!1,description:`The label names the issue should end up with; any label you omit is removed`},clear:{type:`boolean`,description:`Permit an empty label list (remove every label). Required for that case`},repo:{type:`string`,description:`Target repository URL (default: this repo's origin)`},json:{type:`boolean`,description:`Emit one JSON document: number, labels, previous, added, removed, url. A dry run reports the change it would make and writes nothing.`},"dry-run":{type:`boolean`,description:`Report what would change, mutate nothing`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=process.cwd(),r=e._.slice(1),i=e[`dry-run`]===!0;try{let a=await setIssueLabels(e=>forgejoIssueTarget(n,e,`issue:set-labels`),{ref:e.ref,labels:r,dryRun:i,...e.clear===!0?{clear:!0}:{},...e.repo===void 0?{}:{repo:e.repo}});t.json(a),t.text(formatIssueSetLabels(a,i))}catch(e){throw e instanceof IssueNumberRequiredError?new u(describeIssueNumberRequired(`pnpm exec bst-fj issue:set-labels 273 agent/plan`)):e instanceof NoLabelsGivenError?new u(describeNoLabelsGiven(e,`--clear`)):e}}});var EmptyCommentError=class extends u{constructor(){super(`The comment resolved to empty text.`)}};function rejectEmptyComment(e){if(e!==void 0&&e.trim()===``)throw new EmptyCommentError}var PullRequestStateError=class extends u{number;action;constructor(e,t){super(`#${String(e)} is a pull request, not an issue; its state is not written here.`),this.number=e,this.action=t}},NotAPullRequestError=class extends u{number;constructor(e){super(`#${String(e)} is an issue, not a pull request.`),this.number=e}},StateNotTakenError=class extends u{number;expected;actual;constructor(e,t,n){super(`The forge did not change #${String(e)}: it is still ${n}, not ${t}.`),this.number=e,this.expected=t,this.actual=n}};const Nt={close:`closed`,reopen:`open`};async function changeState(e,t,n,r){let i=await e.get(t);if(r===`issue`&&i.isPullRequest)throw new PullRequestStateError(t,n.action);if(r===`pull-request`&&!i.isPullRequest)throw new NotAPullRequestError(t);let a=n.comment!==void 0,o=Nt[n.action],buildResult=(e,r,o,s,c)=>({number:t,url:e,action:n.action,state:{previous:i.state,current:r},changed:o,...a?{comment:{posted:s}}:{},...c===void 0?{}:{merged:c}});if(i.state===o){let n=r===`pull-request`?(await e.pullRequest(t)).merged:void 0;return buildResult(i.url,i.state,!1,!1,n)}if(n.dryRun)return buildResult(i.url,o,!0,!0);a&&await e.addComment(t,n.comment??``);let s;try{if(s=await e.setState(t,o),s.state!==o)throw new StateNotTakenError(t,o,s.state)}catch(e){throw a&&e instanceof Error&&(e.message=`The comment on #${String(t)} was already posted; a retry will duplicate it. `+e.message),e}return buildResult(s.url,s.state,!0,!0)}async function setIssueState(e,t){let n=parseIssueRef(t.ref),r=requireIssueNumber(n);rejectEmptyComment(t.comment);let{api:i}=e(resolveIssueTarget(n.target,t.repo));return changeState(i,r,t,`issue`)}const Pt={close:`Closed`,reopen:`Reopened`};function formatIssueState(e,t){let n=[];return e.changed?t?n.push(`Would ${e.action} #${String(e.number)}: ${e.state.previous} -> ${e.state.current} (${e.url})`):n.push(`${Pt[e.action]} #${String(e.number)}: ${e.state.previous} -> ${e.state.current} (${e.url})`):n.push(`#${String(e.number)} is already ${e.state.current} -- nothing to ${e.action}. (${e.url})`),e.comment!==void 0&&(e.comment.posted?n.push(t?` would post a comment before writing state`:` comment posted`):n.push(` comment: not posted (issue was already in that state)`)),n.join(`
|
|
22
|
+
`)}function defineIssueStateCommand(e){let t=e===`close`?`issue:close`:`issue:reopen`;return _({meta:{name:t,description:e===`close`?`Close an issue, optionally posting a comment first. An issue already closed is reported, not an error, and no comment is posted. A pull request is refused.`:`Reopen an issue, optionally posting a comment first. An issue already open is reported, not an error, and no comment is posted. A pull request is refused.`},args:{ref:{type:`positional`,required:!0,description:`Issue number or issue URL`},comment:{type:`string`,description:`Post this comment before writing state`},"comment-file":{type:`string`,description:`Read the comment from a file ('-' for stdin)`},repo:{type:`string`,description:`Target repository URL (default: this repo's origin)`},json:{type:`boolean`,description:`Emit one JSON document: number, url, action (close | reopen), state ({previous, current}), changed, comment? ({posted}; present only when a comment was given).`},"dry-run":{type:`boolean`,description:`Report what would change, mutate nothing`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:n}){let r=createCliOutput(n.json===!0),i=process.cwd(),a={text:`--comment`,file:`--comment-file`},o=readBodySource(n.comment??void 0,n[`comment-file`]??void 0,{flags:a}),s=n[`dry-run`]===!0;try{let a=await setIssueState(e=>forgejoIssueTransport(i,e,t),{ref:n.ref,action:e,dryRun:s,...o===void 0?{}:{comment:o},...n.repo===void 0?{}:{repo:n.repo}});r.json(a),r.text(formatIssueState(a,s)),s&&o!==void 0&&a.comment?.posted===!0&&r.text(`[dry-run] Comment that would be posted:\n${o}`)}catch(n){if(n instanceof IssueNumberRequiredError)throw new u(describeIssueNumberRequired(`pnpm exec bst-fj ${t} 273`));if(n instanceof EmptyCommentError)throw new u(describeEmptyComment(a));if(n instanceof PullRequestStateError){let r=e===`close`?`Run \`pnpm exec bst-fj pr:close ${String(n.number)}\` to close it.`:`Run \`pnpm exec bst-fj pr:reopen ${String(n.number)}\` to reopen it.`;throw new u(describePullRequestState(n,{command:`bst-fj ${t}`,advice:r}))}throw n}}})}const Ft=defineIssueStateCommand(`close`),It=defineIssueStateCommand(`reopen`),Lt=_({meta:{name:`issue:list`,description:`List a repository's issues (pull requests are excluded)`},args:{state:{type:`string`,default:`open`,description:`open | closed | all`},label:{type:`string`,description:`Filter by label name`},limit:{type:`string`,default:`30`,description:`Maximum issues to return (at most 1000 are read); --json reports truncated: true when that cap cut the list short`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: issues ([{number, title, state, url, author, labels, createdAt, updatedAt, closedAt (null while open), isPullRequest, assignees, attachments ([{id, name, size, createdAt, downloadUrl}])}]), truncated.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=process.cwd();try{let r=await listIssues(e=>forgejoIssueTransport(n,e,`issue:list`),{state:e.state,limit:e.limit,...e.label===void 0?{}:{label:e.label},...e.repo===void 0?{}:{repo:e.repo}});t.json({issues:r.issues,truncated:r.truncated}),t.text(formatIssueList(r))}catch(e){throw e instanceof InvalidListQueryError?new u(describeInvalidListQuery(e,{state:`--state`,limit:`--limit`})):e}}}),Rt=_({meta:{name:`issue:update`,description:`Edit an existing issue's title and/or body`},args:{ref:{type:`positional`,required:!0,description:`Issue number or issue URL`},title:{type:`string`,description:`Replace the title (default: leave it unchanged)`},body:{type:`string`,description:`Replace the body (default: leave it unchanged)`},"body-file":{type:`string`,description:`Read the new body from a file ('-' for stdin)`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: number, url, previous ({title, body}), current ({title, body}), changed ([title | body]). A dry run reports current as it would be and writes nothing.`},"dry-run":{type:`boolean`,description:`Report what would change, mutate nothing`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=process.cwd(),r=readBodySource(e.body??void 0,e[`body-file`]??void 0),i=e[`dry-run`]===!0;try{let a=await updateIssue(e=>forgejoIssueTransport(n,e,`issue:update`),{ref:e.ref,dryRun:i,...e.title===void 0?{}:{title:e.title},...r===void 0?{}:{body:r},...e.repo===void 0?{}:{repo:e.repo}});if(t.json(a),t.text(formatIssueUpdate(a,i)),i&&a.changed.includes(`body`)){let e=a.previous.body===``?`(empty)`:a.previous.body;t.text(`[dry-run] Current body:\n${e}`)}}catch(e){throw e instanceof IssueNumberRequiredError?new u(describeIssueNumberRequired(`pnpm exec bst-fj issue:update 273 --title '...'`)):e instanceof NothingToUpdateError?new u(describeNothingToUpdate({title:`--title`,body:`--body`,bodyFile:`--body-file`})):e}}}),zt={"issue:view":_({meta:{name:`issue:view`,description:`Show an issue and its comments (accepts a number or an issue URL). Comments come oldest first. Review comments on a pull request are not included.`},args:{ref:{type:`positional`,required:!0,description:`Issue number or issue URL`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: number, title, state, url, author, labels, createdAt, updatedAt, closedAt, body, isPullRequest, assignees, attachments, comments ([{id, author, createdAt, updatedAt?, body, url?}]), commentsTruncated, pr? ({head ({ref, sha, repo (or null)}), base ({ref, sha, repo (or null)}), draft, merged, mergeable (true | false | null), state}), prUnavailable? ({reason}). On a pull request exactly one of pr and prUnavailable is present, and neither is otherwise; repo is null for a deleted fork; commentsTruncated is true when the comment read hit its cap of about 1000.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=process.cwd();try{let r=await viewIssue(e=>forgejoIssueTransport(n,e,`issue:view`),{ref:e.ref,...e.repo===void 0?{}:{repo:e.repo}});t.json(r),t.text(formatIssue(r))}catch(e){throw e instanceof IssueNumberRequiredError?new u(describeIssueNumberRequired(`pnpm exec bst-fj issue:view 273`)):e}}}),"issue:list":Lt,"issue:comment":Tt,"issue:create":Et,"issue:update":Rt,"issue:close":Ft,"issue:reopen":It,"issue:label":At,"issue:unlabel":jt,"issue:set-labels":Mt,"issue:download":Ot};async function resolvePrChecksTarget(e,t){let n=parseIssueRef(t.pr);if(t.repo!==void 0&&n.number===void 0&&t.branch===void 0)throw new u(`--repo requires --pr or --branch -- the current branch of this checkout means nothing in another repository, and inferring it there would silently answer about the wrong PR.`);let r=requireForgejoTarget(t.cwd,resolveIssueTarget(n.target,t.repo),"pr:checks is Forgejo-only: GitHub Actions publishes check runs, not commit statuses, so a combined-status read against a github.com PR would confidently report `no-status` for a green PR. Use `gh pr checks --watch` instead."),i;if(n.number!==void 0)i=n.number;else{let n=t.branch??resolveCurrentBranch({cwd:t.cwd,git:t.git,env:t.env});if(n===void 0)throw new u(`Could not determine the current branch (detached HEAD, or not a git repository) -- pass --branch or --pr explicitly.`);let a=await findOpenPr(e,r,n);if(a===null)throw new u(`No open pull request found for branch "${n}".`);i=a}let a=await getForgejoPrDetail(e,r,i);return{prNumber:i,conn:r,url:prWebUrl(r,i),detail:a}}async function readBaseline(e,t,n,r){if(!r)return{ref:n,status:`skipped`,redNames:[]};let unavailable=(e,t)=>t===void 0?{ref:n,status:`unavailable`,reason:e,redNames:[]}:{ref:n,sha:t,status:`unavailable`,reason:e,redNames:[]},i;try{i=await getBranchHeadSha(e,t,n)}catch(e){return unavailable(p(e))}let a;try{a=await readCommitChecks(e,t,i)}catch(e){return unavailable(p(e),i)}if(!a.parsed)return unavailable(`The base branch's commit status response did not match the shape this build expects.`,i);if(a.contexts.length===0)return unavailable(`No checks have been posted for ${n}'s current head (${i}).`,i);let o=a.contexts.filter(e=>e.verdict===`red`).map(e=>e.name);return{ref:n,sha:i,status:`read`,redNames:o}}function buildReport(e,t,n,r={}){let{target:i,baseline:a,notices:o,waited:s,elapsedMs:c}=n,l=new Set(a.status===`read`?a.redNames:[]),u=r.statusOverride??classifyBaseStatus(t),d={pr:i.prNumber,repository:i.conn.repository,url:i.url,state:e.state,headSha:e.head.sha,baseRef:e.base.ref,status:u,settled:isSettled(t),combinedState:t.state,waited:s,elapsedMs:c,checks:t.contexts.map(e=>({...e,preexisting:e.verdict===`red`&&l.has(e.name)})),baseline:a,notices:o};return r.detailOverride===void 0?u===`unparseable`&&(d.detail=`The commit status response did not match the shape this build expects.`):d.detail=r.detailOverride,r.previousHeadSha!==void 0&&(d.previousHeadSha=r.previousHeadSha),d}async function waitForSettledChecks(e,t,n,r,i){let a=t.detail,o=0,reportFor=(e,i,a,o={})=>buildReport(e,i,{target:t,baseline:n,notices:r,waited:!0,elapsedMs:a},o);return settleChecks(e,t.conn,i,{sha:()=>a.head.sha,notices:r,report:(e,t)=>{let n={};return t.exit===`timeout`?n.statusOverride=`timeout`:t.exit===`retry-budget`&&(n.statusOverride=`unparseable`,t.failureDetail!==void 0&&(n.detailOverride=t.failureDetail)),reportFor(a,e,t.elapsed(),n)},afterSleep:async(n,r)=>{let i;try{i=await getForgejoPrDetail(e,t.conn,t.prNumber),o=0}catch(e){if(o+=1,o>=3)throw e;return`retry`}return i.head.sha===n?(a=i,`next`):{done:reportFor(i,z,r(),{statusOverride:`head-moved`,previousHeadSha:n})}}})}async function runPrChecks(e,t){let n=t.wait===!0?resolvePollTimings(t):void 0,r=await resolvePrChecksTarget(e,t),i=[],a=r.detail.merged||r.detail.state!==`open`;r.detail.merged?i.push(`PR #${String(r.prNumber)} is merged -- reporting its last checks rather than a live wait.`):r.detail.state!==`open`&&i.push(`PR #${String(r.prNumber)} is closed (not merged) -- reporting its last checks rather than a live wait.`);let o=await readBaseline(e,r.conn,r.detail.base.ref,t.baseline??!0);if(n!==void 0&&!a)return waitForSettledChecks(e,r,o,i,{...n,sleep:t.sleep??sleep,now:t.now??Date.now});let s=await readCommitChecks(e,r.conn,r.detail.head.sha);return pushDisagreementNotice(i,r.detail.head.sha,s),buildReport(r.detail,s,{target:r,baseline:o,notices:i,waited:!1,elapsedMs:0})}function baselineClause(e){if(e.baseline.status!==`read`)return null;let t=e.checks.filter(e=>e.verdict===`red`);if(t.length===0)return null;let n=t.filter(e=>e.preexisting).length;return`${String(t.length)} red, ${String(n)} of them already red on `+e.baseline.ref}function renderPrChecks(e){let t=e.checks.map(e=>renderCheckLine(e)),n=[`head ${e.headSha.slice(0,12)}: ${e.status}`],r=baselineClause(e);return r!==null&&n.push(r),n.push(e.url),t.push(n.join(` -- `)),t.join(`
|
|
23
|
+
`)}const Bt=_({meta:{name:`pr:checks`,description:`Read a PR's CI verdict off its current head SHA, over the same combined-status read the automerge gate uses -- optionally --wait for it to settle. It runs nothing locally: it reads what the forge's CI already said about a PR. Exits 0 only when status is green.`},args:{pr:{type:`string`,description:`PR number or URL (default: the current branch's open PR)`},branch:{type:`string`,description:`Resolve the open PR whose head is this branch`},repo:{type:`string`,description:`Target repository (requires --pr or --branch)`},wait:{type:`boolean`,description:`Poll until every check for the head SHA has settled. A push during the wait ends it with status head-moved`},timeout:{type:`string`,description:`--wait's give-up duration, e.g. 20m (default: 20m). Checked once per poll, so a wait can run up to one --interval past it.`},interval:{type:`string`,description:`--wait's poll interval, e.g. 15s (default: 15s, floored at 5s)`},baseline:{type:`boolean`,default:!0,description:`Also read the base branch's checks, to mark which red checks are pre-existing. --no-baseline skips both reads. This is a note only: the verdict and exit code do not change.`},json:{type:`boolean`,description:`Emit one JSON document: pr, repository, url, state, headSha, baseRef, status (green | red | pending | no-status | unparseable | head-moved | timeout), settled, combinedState, waited, elapsedMs, checks ([{context, name, state, verdict, description (or null), targetUrl (or null), updatedAt (or null), preexisting}]), baseline ({ref, sha?, status, reason?, redNames}), detail? (unparseable only), previousHeadSha? (head-moved only). no-status means no check was posted and is never green.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=await runPrChecks(cliFetcher(),{cwd:process.cwd(),pr:e.pr,branch:e.branch,repo:e.repo,wait:e.wait===!0,timeout:e.timeout,interval:e.interval,baseline:e.baseline}),{notices:r,...i}=n;for(let e of r)t.notice(e);t.json(i),t.text(renderPrChecks(n)),process.exitCode=n.status===`green`?0:1}});async function closePullRequest(e,t){return rejectEmptyComment(t.comment),changeState(e,t.number,{action:`close`,dryRun:t.dryRun,...t.comment===void 0?{}:{comment:t.comment}},`pull-request`)}function formatPrClose(e,t){if(e.changed)return formatIssueState(e,t);let n=e.merged===!0?`merged`:`closed`,r=[`#${String(e.number)} is already ${n} -- nothing to close. (${e.url})`];return e.comment!==void 0&&r.push(` comment: not posted (pull request was already closed)`),r.join(`
|
|
24
|
+
`)}function parsePrNumber(e){let t=Number(e);if(!/^\d+$/.test(e)||!Number.isSafeInteger(t)||t<1)throw new u(`Invalid pull request number "${e}" (expected a positive integer).`);return t}const Vt=_({meta:{name:`pr:close`,description:`Close an open pull request, optionally posting a comment first. A pull request already closed or merged is reported, not an error, and no comment is posted. An issue is refused (Forgejo-only; use gh pr close on GitHub)`},args:{number:{type:`positional`,required:!0,description:`Pull request number`},comment:{type:`string`,description:`Post this comment before writing state`},"comment-file":{type:`string`,description:`Read the comment from a file ('-' for stdin)`},repo:{type:`string`,description:`Target repository URL (default: this repo's origin)`},"dry-run":{type:`boolean`,description:`Report what would change, mutate nothing`},json:{type:`boolean`,description:`Emit one JSON document: number, url, action (close), state ({previous, current}), changed, merged? (present only when the pull request was already closed), comment? ({posted}; present only when a comment was given).`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n={text:`--comment`,file:`--comment-file`},r=parsePrNumber(e.number),i=readBodySource(e.comment??void 0,e[`comment-file`]??void 0,{flags:n}),a=e[`dry-run`]===!0;try{rejectEmptyComment(i);let n=requireForgejoTargetFromRepo(process.cwd(),e.repo??void 0,`pr:close is Forgejo-only -- use gh pr close <n> on GitHub.`),o=await closePullRequest(forgejoIssueApi(cliFetcher(),n),{number:r,dryRun:a,...i===void 0?{}:{comment:i}});t.json(o),t.text(formatPrClose(o,a)),a&&i!==void 0&&o.comment?.posted===!0&&t.text(`[dry-run] Comment that would be posted:\n${i}`)}catch(e){throw e instanceof EmptyCommentError?new u(describeEmptyComment(n)):e instanceof NotAPullRequestError?new u(`#${String(e.number)} is an issue, not a pull request -- pr:close refuses to write issue state. Use \`pnpm exec bst-fj issue:close ${String(e.number)}\` to close it.`):e}}}),Y=6e4,X=3e5;function pickDefaultBranch(e,t){if(e!==void 0&&e!==``)return e;if(t!==void 0){let e=t.startsWith(`origin/`)?t.slice(7):t;if(e!==``)return e}return`main`}async function resolveOriginHead(e,t,n=null){let r=await e.run([`symbolic-ref`,`--short`,`refs/remotes/origin/HEAD`],{cwd:t,timeoutMs:Y,signal:n});if(r.exitCode!==0)return;let i=r.stdout.trim();return i===``?void 0:i}async function currentBranch(e,t,n=null){let r=await e.run([`rev-parse`,`--abbrev-ref`,`HEAD`],{cwd:t,timeoutMs:Y,signal:n}),i=r.stdout.trim();if(r.exitCode!==0||i===``)throw new u(`Could not determine the current branch -- is this a git repository?`);if(i===`HEAD`)throw new u(`HEAD is detached. Check out a feature branch first.`);return i}async function baseRef(e,t,n,r=null){let i=`origin/${n}`,a=await e.run([`rev-parse`,`--verify`,`--quiet`,i],{cwd:t,timeoutMs:Y,signal:r});return a.exitCode===0&&a.stdout.trim()!==``?i:n}async function commitSubjects(e,t,n,r=null){return(await e.run([`log`,`--format=%s`,`${n}..HEAD`],{cwd:t,timeoutMs:Y,signal:r})).stdout.split(`
|
|
25
|
+
`).map(e=>e.trim()).filter(e=>e!==``)}async function commitMessages(e,t,n,r=null){let i=await e.run([`log`,`-z`,`--format=%B`,`${n}..HEAD`],{cwd:t,timeoutMs:Y,signal:r});if(i.exitCode!==0)throw new u(`Failed to read commit messages: ${i.stderr||i.stdout}`);return i.stdout.split(`\0`).map(e=>e.trim()).filter(e=>e!==``)}async function hasUncommittedChanges(e,t,n=null){return(await e.run([`status`,`--porcelain`],{cwd:t,timeoutMs:Y,signal:n})).stdout.trim()!==``}async function pushBranch(e,t,n,r,i=!1){let a=i?[`push`,`--force-with-lease`,`-u`,`origin`,n]:[`push`,`-u`,`origin`,n],o=await e.run(a,r===void 0?{cwd:t,timeoutMs:X,signal:null}:{cwd:t,env:r,timeoutMs:X,signal:null});if(o.exitCode!==0)throw new u(`Failed to push ${n}: ${o.stderr||o.stdout}`)}const Ht=/* @__PURE__ */ new Set([`main`,`master`]);function stateWord(e){return e===`open`?`open`:`closed, unmerged`}async function refuseProtectedBranch(e,t,n){let{cwd:r,branch:i}=t,a=t.defaultBranchOverride,o=pickDefaultBranch(a,a===void 0||a===``?await resolveOriginHead(e,r,t.signal):void 0);if(Ht.has(i)||i===o)throw new u(n(i));return o}var BranchPrError=class extends u{reason;branch;state;numbers;openNumbers;constructor(e){let t=e.openNumbers??[];super(branchPrMessage(e,t)),this.reason=e.reason,this.branch=e.branch,this.state=e.state,this.numbers=e.numbers,this.openNumbers=t}};function branchPrMessage(e,t){let n=e.numbers.map(e=>`#${String(e)}`).join(`, `);if(e.reason===`several`)return`${e.branch} has ${String(e.numbers.length)} ${stateWord(e.state)} pull requests (${n}), so there is no way to tell which one you mean. Pass the pull request NUMBER.`;if(t.length===1)return`${e.branch} has no ${stateWord(e.state)} pull request; #${String(t[0])} is already open. Pass the pull request NUMBER.`;if(t.length>1){let n=t.map(e=>`#${String(e)}`).join(`, `);return`${e.branch} has no ${stateWord(e.state)} pull request; it has open pull requests (${n}). Pass the pull request NUMBER.`}return`${e.branch} has no ${stateWord(e.state)} pull request. Pass the pull request NUMBER.`}async function resolveBranchPr(e,t,n){let r=await currentBranch(e,n.cwd,n.signal);await refuseProtectedBranch(e,{cwd:n.cwd,branch:r,...n.defaultBranchOverride===void 0?{}:{defaultBranchOverride:n.defaultBranchOverride},signal:n.signal},e=>`Autodetect will not run on the protected branch "${e}" -- pass the pull request NUMBER.`);let i=await listBranchNumbers(t,r,n.state,n.signal),a=i[0];if(i.length===1&&a!==void 0)return{branch:r,number:a};if(i.length>1)throw new BranchPrError({reason:`several`,branch:r,state:n.state,numbers:i});let o=n.state===`closed-unmerged`?await listBranchNumbers(t,r,`open`,n.signal):[];throw new BranchPrError({reason:`none`,branch:r,state:n.state,numbers:[],openNumbers:o})}async function listBranchNumbers(e,t,n,r){return n===`open`?(await e.listForBranch(t,`open`,r)).map(e=>e.number):(await e.listForBranch(t,`closed`,r)).filter(e=>!e.merged).map(e=>e.number)}function refuseRepoWithoutNumber(e,t){if(t!==void 0&&e===void 0)throw new u(`--repo names ${t}, and the current branch says nothing about another repository -- pass the pull request NUMBER.`)}const Z=/* @__PURE__ */ new Set([`feat`,`fix`,`chore`,`docs`,`refactor`,`test`,`perf`,`build`,`ci`,`style`,`revert`]);function words(e){return e.replaceAll(`-`,` `).replaceAll(`_`,` `)}function humanizeBranch(e){let t=e.indexOf(`/`);if(t===-1)return words(e);let n=e.slice(0,t),r=e.slice(t+1);return Z.has(n)?`${n}: ${words(r)}`:`${words(n)} ${words(r.replaceAll(`/`,` `))}`}function withWipPrefix(e,t){return t&&!hasWipPrefix(e)?`WIP: ${e}`:e}function derivePrContent(e){let[t]=e.subjects,n=e.subjects.length===1&&t!==void 0?t:humanizeBranch(e.branch),r=e.title??n,i=e.wipTitles?withWipPrefix(r,e.draft):r;if(e.body!==void 0)return{title:i,body:e.body,droppedRefs:droppedClosingRefs(e.messages,e.body)};let a=e.subjects.map(e=>`- ${e}`).join(`
|
|
25
26
|
`),o=droppedClosingRefs(e.messages,a);return{title:i,body:o.length===0?a:`${a}\n\n${o.map(e=>e.text).join(`
|
|
26
|
-
`)}`,droppedRefs:[]}}var PrModeError=class extends u{reason;branch;existing;numbers;mode;constructor(e,t,n,r=[],i=null){super(prModeMessage(e,t,n,r)),this.reason=e,this.branch=t,this.existing=n,this.numbers=[...r],this.mode=i}};function prModeMessage(e,t,n,r){if(e===`already-open`)return`${t} already has an open PR (#${String(n)}).`;if(e===`several-open`){let e=r.map(e=>`#${String(e)}`).join(`, `);return`${t} has ${String(r.length)} open PRs (${e}), so there is no way to tell which one to update.`}return e===`not-branch-pr`?`#${String(n)} is not an open PR of ${t}.`:`${t} has no open PR to update.`}function choosePrForMode(e,t,n,r){let i=t.map(e=>e.number);if(r!==void 0){let a=t.find(e=>e.number===r);if(a===void 0)throw new PrModeError(`not-branch-pr`,n,r,i,e);return refuseBaseless(a,n)}
|
|
27
|
-
`),r=droppedClosingRefs([n],e.effective.body).map(e=>Number(e.issue.slice(1)));if(r.length===0)return{plan:e,added:r};let i=carryForwardClosingRefs(n,e.effective.body);return{plan:{...e,patch:{...e.patch,body:i},effective:{...e.effective,body:i}},added:r}}async function planUpsert(e,t,n,r){let i;if(i=t===null?{patch:{title:n.title,body:n.body},effective:n,previousBody:null}:planPrUpdate(r,n,prUpdateNeedsLive(r)?await e.readLive(t,r.signal??null):null,e.wipTitles),r.closes===void 0)return{plan:i,closesAdded:void 0};let a=addClosingIssues(i,r.closes);return{plan:a.plan,closesAdded:a.added}}async function runPrUpsert(e,t,n){let{cwd:r}=n,i=n.mode??`upsert`,a=n.signal??null,o=await currentBranch(e,r,a),s=await refuseProtectedBranch(e,{cwd:r,branch:o,...n.defaultBranchOverride===void 0?{}:{defaultBranchOverride:n.defaultBranchOverride},signal:a},e=>`Refusing to open a PR from the protected branch "${e}" -- create a branch first.`),c=n.base??s,l=await baseRef(e,r,c,a),d=await commitSubjects(e,r,l,a);if(d.length===0)throw new u(`No commits on ${o} that are not already on ${c}.`);let f=await commitMessages(e,r,l,a);await hasUncommittedChanges(e,r,a)&&L.warn(`Working tree has uncommitted changes -- they will not be part of this PR.`);let p=derivePrContent({branch:o,subjects:d,messages:f,title:n.title,body:n.body,draft:n.draft===!0,wipTitles:t.wipTitles});n.onResolved?.({mode:i,branch:o,base:c});let m=choosePrForMode(i,await t.listForBranch(o,`open`,a),o,n.expectedNumber),h=m?.number??null;!n.dryRun&&n.skipPush!==!0&&await pushBranch(e,r,o,n.pushEnv,n.forceWithLease);let{plan:g,closesAdded:_}=await planUpsert(t,h,p,n),v=checkClosingLinks(f,g,n.allowUnlink===!0);n.onClosingLinks?.(v);let y={branch:o,base:m?.base??c,...g.effective,..._===void 0?{}:{closesAdded:_}};if(n.dryRun)return{action:h===null?`would-create`:`would-update`,number:null,url:null,...y};if(h===null){let e=await t.create(y,n.draft);return{action:`created`,number:e.number,url:e.url,...y}}return{action:`updated`,number:h,url:(await t.update(h,g.patch,n.draft)).url,...y}}function describePrModeError(e,t){if(e.reason===`already-open`){let n=t.create.split(` `).at(-1)??t.create;return`${e.branch} already has an open PR (#${String(e.existing)}) -- use \`${t.update}\` to push new commits to it. (${n} refuses rather than rewrite its title and body from the branch's commits, which is how an authored description gets replaced by "${humanizeBranch(e.branch)}".)`}if(e.reason===`several-open`){let n=e.numbers.map(e=>`#${String(e)}`).join(`, `);return e.mode===`upsert`?`${e.branch} has ${String(e.numbers.length)} open PRs, so nothing can tell which one to update -- close all but one of ${n}, or pass NUMBER to \`${t.update}\` by hand.`:`${e.branch} has ${String(e.numbers.length)} open PRs (${n}), so nothing can tell which one to update -- pass one NUMBER to \`${t.update}\`.`}return e.reason===`not-branch-pr`?`#${String(e.existing)} is not an open PR of ${e.branch} -- ${describeBranchPrs(e.numbers)}. Update the branch's own PR, or run \`${t.create}\` to open one.`:`${e.branch} has no open PR to update -- use \`${t.create}\` to open one.`}function describeBranchPrs(e){return e.length===0?`it has none`:`it has ${e.map(e=>`#${String(e)}`).join(`, `)}`}function describeClosingLinks(e,t){let n=[];if(e.fromCommits.length>0){let r=e.fromCommits.map(e=>e.text).join(`, `);n.push(`The commits say ${r}, but the PR body does not -- the issue may not close on merge. Link it with ${t.closes}.`)}if(e.unlinked.length>0){let r=e.unlinked.map(e=>e.text).join(`, `);n.push(`${t.allowUnlink}: dropping ${r} from the PR body as instructed.`)}return n}function describeLostClosingRefs(e,t){return`Refusing to update: this would remove ${e.lost.map(e=>e.text).join(`, `)} from the PR body, and the new body does not close it -- the issue would stay open when the PR merges, and nothing else reports that. Keep the line in the body you are passing, or pass ${t.allowUnlink} if the PR really should stop closing it.`}function rewordPrUpsertError(e,t){if(e instanceof PrModeError)return new u(describePrModeError(e,t.commands));if(e instanceof LostClosingRefsError){let n={fromCommits:e.fromCommits,unlinked:[]};for(let e of describeClosingLinks(n,t.flags))t.warn(e);return new u(describeLostClosingRefs(e,t.flags))}return e}function prTarget(e){return`${e.branch} -> ${e.base}`}function prLabel(e){return e.number===null?`PR`:`PR #${String(e.number)}`}function isDryRun(e){return e.action===`would-create`||e.action===`would-update`}function formatPrCreate(e){let t=e.action===`created`||e.action===`would-create`;if(isDryRun(e)){let n=t?`create`:`update`;return{lines:[`[dry-run] Would push ${prTarget(e)} and ${n} its PR: ${e.title}`],body:{heading:`[dry-run] Body`,text:e.body}}}let n=[`${t?`Created`:`Updated`} ${prLabel(e)} (${prTarget(e)})`];return e.url!==null&&n.push(e.url),{lines:n,body:null}}function formatPrUpdate(e,t,n){let r=e.closesAdded??[];if(isDryRun(e))return{lines:[`[dry-run] Would push ${prTarget(e)} to ${prLabel(e)}`],body:{heading:t||r.length>0?`[dry-run] Body`:`[dry-run] Body (unchanged)`,text:e.body}};let i=[`Updated ${prLabel(e)} (${prTarget(e)})`];return r.length>0?i.push(`Linked ${r.map(e=>`#${String(e)}`).join(`, `)} with a Closes line.`):t||i.push(`Title and body left as authored -- pass ${n.title}/${n.body} to change them.`),e.url!==null&&i.push(e.url),{lines:i,body:null}}function forgejoPrHost(e,t){return{wipTitles:!0,findOpen:(n,r)=>findOpenPrEntry(e,t,n,r),listForBranch:(n,r,i)=>listBranchPulls(e,t,n,r,i),readLive:n=>getPrContent(e,t,n),async create(n){let r=await createPr(e,t,{title:n.title,head:n.branch,base:n.base,body:n.body});return{number:r.number,url:r.htmlUrl}},async update(n,r){return await updatePr(e,t,n,r),{url:prWebUrl(t,n)}}}}function forgejoPrEditHost(e,t){return{wipTitles:!0,readLive:n=>getPrEditState(e,t,n),branchExists:n=>branchExists(e,t,n),listForBranch:(n,r,i)=>listBranchPulls(e,t,n,r,i),setBase:(n,r)=>retargetPr(e,t,n,r),ready:(n,r)=>updatePr(e,t,n,{title:r.title}),reopen:n=>reopenPr(e,t,n)}}function cliGit(){return{run:(e,{cwd:t,env:n,timeoutMs:r,signal:i})=>new Promise((a,o)=>{if(i?.aborted===!0){a({exitCode:143,stdout:``,stderr:`git run aborted`});return}let s=S(`git`,[...e],{cwd:t,env:n===void 0?process.env:{...process.env,...n},stdio:[`ignore`,`pipe`,`pipe`]}),c=``,l=``,u=null;s.stdout.setEncoding(`utf-8`),s.stderr.setEncoding(`utf-8`),s.stdout.on(`data`,e=>{c+=e}),s.stderr.on(`data`,e=>{l+=e});let stop=(e,t)=>{u={exitCode:e,note:t},s.kill(`SIGKILL`)},d=setTimeout(()=>{stop(124,`git ${e[0]??``} timed out after ${String(r)}ms`)},r),onAbort=()=>{stop(143,`git run aborted`)};i?.addEventListener(`abort`,onAbort,{once:!0});let cleanup=()=>{clearTimeout(d),i?.removeEventListener(`abort`,onAbort)};s.on(`error`,e=>{cleanup(),o(new f(`Could not run git: ${e.message}`))}),s.on(`close`,e=>{cleanup(),a(u===null?{exitCode:e??1,stdout:c,stderr:l}:{exitCode:u.exitCode,stdout:c,stderr:l===``?u.note:`${l}\n${u.note}`})})})}}const It={create:`pnpm exec bst-fj pr:create`,update:`pnpm exec bst-fj pr:update`},Q={closes:`--closes`,allowUnlink:`--allow-unlink`};function warnClosingLinks(e){for(let t of describeClosingLinks(e,Q))M.warn(t)}async function runForgejoPr(e,t){let n=process.cwd(),r=requireForgejoTarget(n,void 0,e);try{return await runPrUpsert(cliGit(),forgejoPrHost(cliFetcher(),r),{...t,cwd:n,onResolved:({mode:e,branch:t,base:n})=>{M.debug(`pr:${e} ${t} (diff base ${n}, forgejo)`)},onClosingLinks:warnClosingLinks})}catch(e){throw rewordPrUpsertError(e,{commands:It,flags:Q,warn:e=>{M.warn(e)}})}}const Lt=_({meta:{name:`pr:create`,description:`Push the current branch and open its pull request (Forgejo-only). Refuses to run on main, master or the default branch.`},args:{title:{type:`string`,description:`PR title (default: derived from the branch's commits)`},body:{type:`string`,description:`PR body (default: a list of the branch's commits)`},"body-file":{type:`string`,description:`Read the PR body from a file ('-' for stdin)`},base:{type:`string`,description:`Base branch for a new PR (default: the repo's default branch); with --upsert on an already-open PR it selects only the diff range`},draft:{type:`boolean`,description:`Open the PR as a draft`},upsert:{type:`boolean`,description:`Update the PR instead of failing when the branch already has one open`},"allow-unlink":{type:`boolean`,description:`With --upsert: permit a --body that drops a closing keyword the PR carries`},closes:{type:`string`,description:`Issues the PR closes, comma-separated (12 or 12,15): adds a Closes #<n> line to the body for each one it does not already close`},"dry-run":{type:`boolean`,description:`Show what would happen without pushing`},json:{type:`boolean`,description:`Emit one JSON document: action (created | updated | would-create | would-update), number (or null), url (or null), branch, base, title, body, droppedRefs? ([{text, issue}]), closesAdded? (with --closes: the issues it added a Closes line for), dryRun. A create or would-create carries droppedRefs; on a dry run, number and url are null. The document carries no claims member and no claim advice line: the closed-issue claim check reads the repo's .tooling.json and is bst pr:create's alone.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=readBodySource(e.body??void 0,e[`body-file`]??void 0),r=await runForgejoPr("bst-fj pr:create works on Forgejo only. Use `gh pr create` on GitHub, or `pnpm exec bst pr:create`, which covers both.",{mode:e.upsert===!0?`upsert`:`create`,title:e.title??void 0,body:n,base:e.base??void 0,allowUnlink:e[`allow-unlink`]===!0,closes:e.closes===void 0?void 0:parseIssueList(e.closes),draft:e.draft===!0||void 0,dryRun:e[`dry-run`]===!0});t.json({...r,dryRun:e[`dry-run`]===!0});let i=formatPrCreate(r);for(let e of i.lines)t.text(e);i.body!==null&&t.text(`${i.body.heading}\n${i.body.text}`)}}),Rt=g.object({filename:g.string(),previous_filename:g.string().nullish(),status:g.string().nullish(),additions:g.number().default(0),deletions:g.number().default(0)});async function listAllPrFiles(e,t,n){let r=[];for(let i=1;i<=20;i++){let a=await readPrFilesPage(e,t,n,i,100);if(r.push(...a.files),!a.truncated)return{files:r,truncated:!1}}return{files:r,truncated:!0}}async function readPrFilesPage(e,t,n,r,i){let a=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls/${String(n)}/files?page=${String(r)}&limit=${String(i)}`,o=await e.fetch(a,{headers:{Authorization:`token ${t.token}`}});o.ok||await throwForgejoFailure(o,{verb:`list PR files`,resource:`#${String(n)}`});let s=g.array(Rt).safeParse(await o.json());if(!s.success)throw new f(`Unexpected PR files response: ${s.error.message}`);return{files:s.data.map(e=>({filename:e.filename,previousFilename:e.previous_filename??null,status:e.status??null,additions:e.additions,deletions:e.deletions})),truncated:o.headers.get(`x-hasmore`)===`true`}}function runPrFiles(e,t){let n=parsePrNumber(t.number);return listAllPrFiles(e,requireForgejoTarget(t.cwd,parseRepoTarget(t.repo),`pr:files is Forgejo-only -- gh pr diff --name-only already serves GitHub.`),n)}function renderPrFiles(e){let t=e.files.map(e=>`${e.status??`unknown`} ${e.filename}`);return t.length===0&&t.push(`No changed files.`),e.truncated&&t.push(`Listing truncated; the pull request changes more files.`),t.join(`
|
|
28
|
-
`)}const
|
|
29
|
-
`)}const Bt=_({meta:{name:`pr:list`,description:`List a repository's pull requests, most recently updated first (Forgejo-only; use gh pr list on GitHub)`},args:{state:{type:`string`,default:`open`,description:`open | closed | all`},limit:{type:`string`,default:`30`,description:`Maximum pull requests to return`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: pulls ([{number, title (nullable), headRef, baseRef (nullable), state (open | closed), merged, mergedAt (null unless merged), url (nullable), draft (nullable), author (nullable), updatedAt (nullable), labels}]).`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=await runPrList(cliFetcher(),{cwd:process.cwd(),state:e.state,limit:e.limit,repo:e.repo??void 0});for(let e of n.notices)t.notice(e);t.json({pulls:n.pulls}),t.text(renderPrList(n))}});async function mergePr(e,t,n,r){let i=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls/${String(n)}/merge`,a={Do:r?.method??`merge`,delete_branch_after_merge:r?.deleteBranch??!0};r?.expectedHeadSha!==void 0&&(a.head_commit_id=r.expectedHeadSha);let o=await e.fetch(i,{method:`POST`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify(a)});o.ok||await throwForgejoFailure(o,{verb:`merge PR`,resource:`#${String(n)}`})}const Vt=g.object({state:g.string(),draft:g.boolean(),mergeable:g.boolean().nullable(),head:g.object({sha:g.string()}),merge_base:g.string(),changed_files:g.number().nullish(),base:g.object({ref:g.string()}),labels:g.array(g.object({name:g.string()})).nullable(),updated_at:g.string().nullish()});async function readMergeGate(e,t,n){let r=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls/${String(n)}`,i=await e.fetch(r,{headers:{Authorization:`token ${t.token}`}});i.ok||await throwForgejoFailure(i,{verb:`read PR merge gate`,resource:`#${String(n)}`});let a=Vt.safeParse(await i.json());if(!a.success)throw new f(`Unexpected PR merge-gate response: ${a.error.message}`);return{open:a.data.state===`open`,draft:a.data.draft,mergeable:a.data.mergeable??!1,headSha:a.data.head.sha,mergeBase:a.data.merge_base,changedFiles:a.data.changed_files??null,baseRef:a.data.base.ref,labels:(a.data.labels??[]).map(e=>e.name),updatedAt:a.data.updated_at??null}}async function confirmMergeable(e,t,n,r){let i=await readMergeGate(e,t,n);if(i.mergeable)return{verdict:`mergeable`,gate:i,firstGate:i,rechecked:!1,evidence:null};if(r.settleOnFirstRead?.(i)===!0)return{verdict:`unconfirmed`,gate:i,firstGate:i,rechecked:!1,evidence:null};r.beforeRecheck?.(i),await r.sleep(r.delayMs);let a=await readMergeGate(e,t,n);return a.mergeable?{verdict:`mergeable`,gate:a,firstGate:i,rechecked:!0,evidence:null}:a.headSha===i.headSha&&a.mergeBase===i.mergeBase?{verdict:`conflicted`,gate:a,firstGate:i,rechecked:!0,evidence:`The forge reported it unmergeable on two reads ${String(r.delayMs)}ms apart, at head ${a.headSha}.`}:{verdict:`unconfirmed`,gate:a,firstGate:i,rechecked:!0,evidence:a.headSha===i.headSha?`Its merge base moved from ${i.mergeBase} to ${a.mergeBase} between the two reads.`:`Its head moved from ${i.headSha} to ${a.headSha} between the two reads.`}}g.object({draft:g.boolean(),mergeable:g.boolean().nullable(),merge_base:g.string(),base:g.object({ref:g.string(),sha:g.string()})});const $=[`merge`,`rebase`,`squash`];function sleepDefault(e){return new Promise(t=>{setTimeout(t,e)})}function headMatches(e,t){let n=e.trim().toLowerCase();return n.length>=7&&t.toLowerCase().startsWith(n)}async function runPrMergeCore(e,t,n,r={}){let i=`PR #${String(n)}`,a=r.method??`merge`,o=r.expectedHeadSha,moved=e=>o!==void 0&&!headMatches(o,e),s=await confirmMergeable(e,t,n,{delayMs:2e3,sleep:r.sleep??sleepDefault,settleOnFirstRead:e=>!e.open||e.draft||moved(e.headSha)}),{gate:c,verdict:l}=s,refuse=e=>({kind:`refused`,reason:`Refusing to merge ${i}: ${e}`});if(!c.open)return refuse(`it is closed.`);if(c.draft)return refuse(`it is a draft.`);if(r.refuseEmpty===!0&&(c.headSha===c.mergeBase||c.changedFiles===0))return refuse(`its diff against its base is empty, so its branch is left alone.`);if(o!==void 0&&moved(c.headSha))return refuse(`its head is ${c.headSha}, not the approved ${o}.`);if(l===`conflicted`)return refuse(`it has conflicts. ${s.evidence??``}`.trimEnd());if(l===`unconfirmed`)return refuse(`the forge could not confirm it is mergeable. ${s.evidence??``}`.trimEnd());let u=await readCommitChecks(e,t,c.headSha),d=classifyBaseStatus(u),f=u.parsed&&u.contexts.length>0&&u.contexts.every(e=>e.verdict===`skipped`);if(!(d===`green`||r.ignoreChecks===!0||(d===`no-status`||f)&&r.allowNoStatus===!0))return{kind:`refused`,reason:`Refusing to merge ${i}: its checks at ${c.headSha} are ${d}, not green.`,checks:d};let p={number:n,merged:!1,method:a,headSha:c.headSha,verdict:l,checks:d};return r.dryRun===!0?{kind:`ok`,result:p}:(await mergePr(e,t,n,{method:a,deleteBranch:r.deleteBranch??!1,expectedHeadSha:c.headSha}),{kind:`ok`,result:{...p,merged:!0}})}function parseMethod(e){if(e===void 0)return`merge`;let t=$.find(t=>t===e);if(t===void 0)throw new u(`Invalid --method "${e}" (expected one of: ${$.join(`, `)}).`);return t}async function runPrMerge(e,t){let n=parsePrNumber(t.number),r=parseMethod(t.method),i=await runPrMergeCore(e,requireForgejoTarget(t.cwd,parseRepoTarget(t.repo),`pr:merge is Forgejo-only -- use gh pr merge on GitHub.`),n,{method:r,deleteBranch:t.deleteBranch,ignoreChecks:t.ignoreChecks,dryRun:t.dryRun,sleep:t.sleep??sleep});if(i.kind===`refused`){let e=i.checks===void 0?``:` Pass --ignore-checks to merge anyway.`;throw new u(`${i.reason}${e}`)}return i.result}function renderPrMerge(e){let t=`PR #${String(e.number)} (${e.method}) at ${e.headSha.slice(0,12)}, checks ${e.checks}`;return e.merged?`Merged ${t}.`:`Dry run: would merge ${t}.`}const Ht=_({meta:{name:`pr:merge`,description:`Merge an open, non-draft pull request the forge confirms is mergeable and whose checks are green, pinned to the head SHA it read (Forgejo-only; use gh pr merge on GitHub)`},args:{number:{type:`positional`,required:!0,description:`Pull request number`},method:{type:`string`,description:`Merge method: merge, rebase or squash (default: merge)`},"delete-branch":{type:`boolean`,description:`Delete the head branch after the merge`},"ignore-checks":{type:`boolean`,description:`Merge even when the head's combined status is not green`},"dry-run":{type:`boolean`,description:`Run every check and report, but do not merge`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: number, merged, method (merge | rebase | squash), headSha, verdict (mergeable), checks (green | red | pending | no-status | unparseable). merged is false on a dry run; a refusal is an error, never this document.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=await runPrMerge(cliFetcher(),{cwd:process.cwd(),number:e.number,method:e.method??void 0,deleteBranch:e[`delete-branch`]===!0,ignoreChecks:e[`ignore-checks`]===!0,dryRun:e[`dry-run`]===!0,repo:e.repo??void 0});t.json(n),t.text(renderPrMerge(n))}});function isOpen(e){return e.state===`open`&&e.merged===!1}function notOpenMessage(e,t){let n=`#${String(e)}`;return t.merged?`Pull request ${n} is merged, so it has no base or draft state left to change.`:`Pull request ${n} is ${t.state}, so it has no base or draft state left to change. Run \`pr:reopen ${String(e)}\` first if this work is still live.`}async function runPrRetarget(e,t){let n=await e.readLive(t.number);if(!isOpen(n))throw new u(notOpenMessage(t.number,n));if(t.base===n.head)throw new u(`Pull request #${String(t.number)} cannot target its own head branch "${t.base}" -- choose a branch it is meant to merge into.`);if(t.base===n.base)return{action:`unchanged`,number:t.number,url:n.url,previousBase:n.base,base:n.base,head:n.head,mergeable:n.mergeable,dryRun:t.dryRun};if(!await e.branchExists(t.base))throw new u(`Branch "${t.base}" does not exist in this repository, so pull request #${String(t.number)} cannot target it -- push the branch, or pass a base the forge has.`);if(t.dryRun)return{action:`would-retarget`,number:t.number,url:n.url,previousBase:n.base,base:t.base,head:n.head,mergeable:n.mergeable,dryRun:!0};await e.setBase(t.number,t.base);let r=await e.readLive(t.number);if(r.base!==t.base)throw new u(`Pull request #${String(t.number)} still reports its base as "${r.base}" after the request to move it to "${t.base}" -- this forge accepted the field and ignored it, so change the base in its web interface.`);let i=r.mergeable;return i===!1&&(await t.sleep(t.recheckDelayMs),i=(await e.readLive(t.number)).mergeable),{action:`retargeted`,number:t.number,url:r.url,previousBase:n.base,base:t.base,head:n.head,mergeable:i,dryRun:!1}}async function runPrReady(e,t){let n=await e.readLive(t.number);if(!isOpen(n))throw new u(notOpenMessage(t.number,n));let r=t.title;if(r!==void 0){if(r.trim()===``)throw new u(`--title is empty -- pass the title to write, or omit --title to drop the WIP marker from pull request #${String(t.number)}'s current title.`);if(hasWipPrefix(r)){let t=e.wipTitles?`which on this forge keeps the pull request a draft`:`so the pull request would still read as work in progress`;throw new u(`--title ${JSON.stringify(r)} carries a WIP marker, ${t} -- pass the title you want it to read without one.`)}}let i=r??stripWipPrefix(n.title);if(i.trim()===``)throw new u(`Pull request #${String(t.number)} would be left with an empty title, which neither forge accepts -- pass --title with the title to write.`);if(e.wipTitles&&n.draft&&r===void 0&&!hasWipPrefix(n.title))throw new u(`Pull request #${String(t.number)} is a draft and its title ${JSON.stringify(n.title)} carries no WIP marker this tool recognises, so there is nothing to strip -- pass --title "<title>" to write the title that clears the draft.`);let a=i!==n.title;if(!n.draft&&!a)return{action:`already-ready`,number:t.number,url:n.url,previousTitle:n.title,title:n.title,draft:n.draft,dryRun:t.dryRun};if(t.dryRun)return{action:n.draft?`would-ready`:`would-retitle`,number:t.number,url:n.url,previousTitle:n.title,title:i,draft:n.draft,dryRun:!0};await e.ready(t.number,{draft:n.draft,title:i,titleChanged:a});let o=await e.readLive(t.number);if(o.draft)throw new u(`Pull request #${String(t.number)} is still a draft after the title ${JSON.stringify(i)} was written -- its draft state is set by something other than the title, so clear it in the forge's interface.`);return{action:n.draft?`readied`:`retitled`,number:t.number,url:o.url,previousTitle:n.title,title:o.title,draft:o.draft,dryRun:!1}}async function runPrReopen(e,t){let n=await e.readLive(t.number);if(n.merged===!0)throw new u(`Pull request #${String(t.number)} was merged, so there is nothing to reopen -- open a new pull request for further work.`);if(n.state===`open`)return{action:`already-open`,number:t.number,url:n.url,title:n.title,head:n.head,base:n.base,draft:n.draft,dryRun:t.dryRun};if(n.state!==`closed`)throw new u(`Pull request #${String(t.number)} reports the state "${n.state}", which this command has no rule for -- it reopens a pull request reported as closed, and guesses at no state it did not expect.`);if(t.dryRun)return{action:`would-reopen`,number:t.number,url:n.url,title:n.title,head:n.head,base:n.base,draft:n.draft,dryRun:!0};await e.reopen(t.number);let r=await e.readLive(t.number);if(!isOpen(r))throw new u(`Pull request #${String(t.number)} still reports \`${r.state}\` after the request to reopen it -- reopen it in the forge's web interface.`);return{action:`reopened`,number:t.number,url:r.url,title:r.title,head:r.head,base:r.base,draft:r.draft,dryRun:!1}}function mergeabilityLine(e){return e===!0?`Mergeability: mergeable.`:e===!1?`Mergeability: not mergeable -- advice, not a verdict.`:`Mergeability: unknown -- the forge has not computed it.`}function renderPrRetarget(e){let t=`#${String(e.number)}`,n=[];return e.action===`retargeted`?n.push(`Pull request ${t} now targets "${e.base}" (was "${e.previousBase}").`):e.action===`unchanged`?n.push(`Pull request ${t} already targets "${e.base}".`):n.push(`Dry run: pull request ${t} would move from "${e.previousBase}" to "${e.base}".`),n.push(mergeabilityLine(e.mergeable)),n.join(`
|
|
27
|
+
`)}`,droppedRefs:[]}}var PrModeError=class extends u{reason;branch;existing;numbers;mode;constructor(e,t,n,r=[],i=null){super(prModeMessage(e,t,n,r)),this.reason=e,this.branch=t,this.existing=n,this.numbers=[...r],this.mode=i}};function prModeMessage(e,t,n,r){if(e===`already-open`)return`${t} already has an open PR (#${String(n)}).`;if(e===`several-open`){let e=r.map(e=>`#${String(e)}`).join(`, `);return`${t} has ${String(r.length)} open PRs (${e}), so there is no way to tell which one to update.`}return e===`not-branch-pr`?`#${String(n)} is not an open PR of ${t}.`:`${t} has no open PR to update.`}function choosePrForMode(e,t,n,r){let i=t.map(e=>e.number),a=t[0];if(e===`create`&&a!==void 0)throw new PrModeError(`already-open`,n,a.number,i,e);if(r!==void 0){let a=t.find(e=>e.number===r);if(a===void 0)throw new PrModeError(`not-branch-pr`,n,r,i,e);return refuseBaseless(a,n)}if(e===`update`&&t.length===0)throw new PrModeError(`none-open`,n,null,i,e);if(t.length>1)throw new PrModeError(`several-open`,n,null,i,e);return a===void 0?null:refuseBaseless(a,n)}function refuseBaseless(e,t){if(e.base===null)throw new f(`Open PR #${String(e.number)} on ${t} carries no base branch`);return e}function prUpdateNeedsLive(e){return e.title===void 0||e.body===void 0||e.draft===void 0||e.managedBodyMarkers!==void 0}function planPrUpdate(e,t,n,r){if(e.managedBodyMarkers!==void 0&&n!==null)return planManagedUpdate(e,t,n,r);let i=e.title===void 0?void 0:t.title,a={...i===void 0?{}:{title:r&&e.draft===void 0&&n!==null?keepWipPrefix(n.title,i):i},...e.body===void 0?{}:{body:t.body}};return{patch:a,effective:{title:a.title??n?.title??``,body:a.body??n?.body??``},previousBody:n?.body??null}}function planManagedUpdate(e,t,n,r){let i=(e.managedBodyMarkers??[]).some(e=>n.body.startsWith(e)),a=i&&e.title!==void 0,o=i&&e.body!==void 0,s;s=a?e.draft===void 0&&r?keepWipPrefix(n.title,t.title):t.title:reconcileWipTitle(r,e.draft,n.title);let c=o?carryForwardClosingRefs(n.body,t.body):carryForwardClosingRefs(t.body,n.body);return{patch:{...s===n.title?{}:{title:s},...c===n.body?{}:{body:c}},effective:{title:s,body:c},previousBody:n.body}}function reconcileWipTitle(e,t,n){if(!e||t===void 0)return n;if(t)return hasWipPrefix(n)?n:`WIP: ${n}`;let r=stripWipPrefix(n);return r===``?(I.warn(`Preserving PR title ${JSON.stringify(n)}: stripping its WIP prefix would leave it empty -- retitle it by hand.`),n):r}function keepWipPrefix(e,t){return hasWipPrefix(e)&&!hasWipPrefix(t)?`WIP: ${t}`:t}var LostClosingRefsError=class extends u{lost;fromCommits;constructor(e,t){super(`This update would remove ${e.map(e=>e.text).join(`, `)} from the PR body, and the new body does not close it.`),this.lost=e,this.fromCommits=t}};function checkClosingLinks(e,t,n){let r=droppedClosingRefs(e,t.effective.body);if(t.previousBody===null)return{fromCommits:r,unlinked:[]};let i=droppedClosingRefs([t.previousBody],t.effective.body);if(i.length>0&&!n)throw new LostClosingRefsError(i,r);return{fromCommits:r,unlinked:i}}function addClosingIssues(e,t){let n=t.map(e=>`Closes #${String(e)}`).join(`
|
|
28
|
+
`),r=droppedClosingRefs([n],e.effective.body).map(e=>Number(e.issue.slice(1)));if(r.length===0)return{plan:e,added:r};let i=carryForwardClosingRefs(n,e.effective.body);return{plan:{...e,patch:{...e.patch,body:i},effective:{...e.effective,body:i}},added:r}}async function planUpsert(e,t,n,r){let i;if(i=t===null?{patch:{title:n.title,body:n.body},effective:n,previousBody:null}:planPrUpdate(r,n,prUpdateNeedsLive(r)?await e.readLive(t,r.signal??null):null,e.wipTitles),r.closes===void 0)return{plan:i,closesAdded:void 0};let a=addClosingIssues(i,r.closes);return{plan:a.plan,closesAdded:a.added}}async function runPrUpsert(e,t,n){let{cwd:r}=n,i=n.mode??`upsert`,a=n.signal??null,o=await currentBranch(e,r,a),s=await refuseProtectedBranch(e,{cwd:r,branch:o,...n.defaultBranchOverride===void 0?{}:{defaultBranchOverride:n.defaultBranchOverride},signal:a},e=>`Refusing to open a PR from the protected branch "${e}" -- create a branch first.`),c=n.base??s,l=await baseRef(e,r,c,a),d=await commitSubjects(e,r,l,a);if(d.length===0)throw new u(`No commits on ${o} that are not already on ${c}.`);let f=await commitMessages(e,r,l,a);await hasUncommittedChanges(e,r,a)&&I.warn(`Working tree has uncommitted changes -- they will not be part of this PR.`);let p=derivePrContent({branch:o,subjects:d,messages:f,title:n.title,body:n.body,draft:n.draft===!0,wipTitles:t.wipTitles});n.onResolved?.({mode:i,branch:o,base:c});let m=choosePrForMode(i,await t.listForBranch(o,`open`,a),o,n.expectedNumber),h=m?.number??null;!n.dryRun&&n.skipPush!==!0&&await pushBranch(e,r,o,n.pushEnv,n.forceWithLease);let{plan:g,closesAdded:_}=await planUpsert(t,h,p,n),v=checkClosingLinks(f,g,n.allowUnlink===!0);n.onClosingLinks?.(v);let y={branch:o,base:m?.base??c,...g.effective,..._===void 0?{}:{closesAdded:_}};if(n.dryRun)return{action:h===null?`would-create`:`would-update`,number:null,url:null,...y};if(h===null){let e=await t.create(y,n.draft);return{action:`created`,number:e.number,url:e.url,...y}}return{action:`updated`,number:h,url:(await t.update(h,g.patch,n.draft)).url,...y}}function describePrModeError(e,t){if(e.reason===`already-open`){let n=t.create.split(` `).at(-1)??t.create;return`${e.branch} already has an open PR (#${String(e.existing)}) -- use \`${t.update}\` to push new commits to it. (${n} refuses rather than rewrite its title and body from the branch's commits, which is how an authored description gets replaced by "${humanizeBranch(e.branch)}".)`}if(e.reason===`several-open`){let n=e.numbers.map(e=>`#${String(e)}`).join(`, `);return e.mode===`upsert`?`${e.branch} has ${String(e.numbers.length)} open PRs, so nothing can tell which one to update -- close all but one of ${n}, or pass NUMBER to \`${t.update}\` by hand.`:`${e.branch} has ${String(e.numbers.length)} open PRs (${n}), so nothing can tell which one to update -- pass one NUMBER to \`${t.update}\`.`}return e.reason===`not-branch-pr`?`#${String(e.existing)} is not an open PR of ${e.branch} -- ${describeBranchPrs(e.numbers)}. Update the branch's own PR, or run \`${t.create}\` to open one.`:`${e.branch} has no open PR to update -- use \`${t.create}\` to open one.`}function describeBranchPrs(e){return e.length===0?`it has none`:`it has ${e.map(e=>`#${String(e)}`).join(`, `)}`}function describeClosingLinks(e,t){let n=[];if(e.fromCommits.length>0){let r=e.fromCommits.map(e=>e.text).join(`, `);n.push(`The commits say ${r}, but the PR body does not -- the issue may not close on merge. Link it with ${t.closes}.`)}if(e.unlinked.length>0){let r=e.unlinked.map(e=>e.text).join(`, `);n.push(`${t.allowUnlink}: dropping ${r} from the PR body as instructed.`)}return n}function describeLostClosingRefs(e,t){return`Refusing to update: this would remove ${e.lost.map(e=>e.text).join(`, `)} from the PR body, and the new body does not close it -- the issue would stay open when the PR merges, and nothing else reports that. Keep the line in the body you are passing, or pass ${t.allowUnlink} if the PR really should stop closing it.`}function rewordPrUpsertError(e,t){if(e instanceof PrModeError)return new u(describePrModeError(e,t.commands));if(e instanceof LostClosingRefsError){let n={fromCommits:e.fromCommits,unlinked:[]};for(let e of describeClosingLinks(n,t.flags))t.warn(e);return new u(describeLostClosingRefs(e,t.flags))}return e}function prTarget(e){return`${e.branch} -> ${e.base}`}function prLabel(e){return e.number===null?`PR`:`PR #${String(e.number)}`}function isDryRun(e){return e.action===`would-create`||e.action===`would-update`}function formatPrCreate(e){let t=e.action===`created`||e.action===`would-create`;if(isDryRun(e)){let n=t?`create`:`update`;return{lines:[`[dry-run] Would push ${prTarget(e)} and ${n} its PR: ${e.title}`],body:{heading:`[dry-run] Body`,text:e.body}}}let n=[`${t?`Created`:`Updated`} ${prLabel(e)} (${prTarget(e)})`];return e.url!==null&&n.push(e.url),{lines:n,body:null}}function formatPrUpdate(e,t,n){let r=e.closesAdded??[];if(isDryRun(e))return{lines:[`[dry-run] Would push ${prTarget(e)} to ${prLabel(e)}`],body:{heading:t||r.length>0?`[dry-run] Body`:`[dry-run] Body (unchanged)`,text:e.body}};let i=[`Updated ${prLabel(e)} (${prTarget(e)})`];return r.length>0?i.push(`Linked ${r.map(e=>`#${String(e)}`).join(`, `)} with a Closes line.`):t||i.push(`Title and body left as authored -- pass ${n.title}/${n.body} to change them.`),e.url!==null&&i.push(e.url),{lines:i,body:null}}function forgejoPrHost(e,t){return{wipTitles:!0,findOpen:(n,r)=>findOpenPrEntry(e,t,n,r),listForBranch:(n,r,i)=>listBranchPulls(e,t,n,r,i),readLive:n=>getPrContent(e,t,n),async create(n){let r=await createPr(e,t,{title:n.title,head:n.branch,base:n.base,body:n.body});return{number:r.number,url:r.htmlUrl}},async update(n,r){return await updatePr(e,t,n,r),{url:prWebUrl(t,n)}}}}function forgejoPrEditHost(e,t){return{wipTitles:!0,readLive:n=>getPrEditState(e,t,n),branchExists:n=>branchExists(e,t,n),listForBranch:(n,r,i)=>listBranchPulls(e,t,n,r,i),setBase:(n,r)=>retargetPr(e,t,n,r),ready:(n,r)=>updatePr(e,t,n,{title:r.title}),reopen:n=>reopenPr(e,t,n)}}function cliGit(){return{run:(e,{cwd:t,env:n,timeoutMs:r,signal:i})=>new Promise((a,o)=>{if(i?.aborted===!0){a({exitCode:143,stdout:``,stderr:`git run aborted`});return}let s=S(`git`,[...e],{cwd:t,env:n===void 0?process.env:{...process.env,...n},stdio:[`ignore`,`pipe`,`pipe`]}),c=``,l=``,u=null;s.stdout.setEncoding(`utf-8`),s.stderr.setEncoding(`utf-8`),s.stdout.on(`data`,e=>{c+=e}),s.stderr.on(`data`,e=>{l+=e});let stop=(e,t)=>{u={exitCode:e,note:t},s.kill(`SIGKILL`)},d=setTimeout(()=>{stop(124,`git ${e[0]??``} timed out after ${String(r)}ms`)},r),onAbort=()=>{stop(143,`git run aborted`)};i?.addEventListener(`abort`,onAbort,{once:!0});let cleanup=()=>{clearTimeout(d),i?.removeEventListener(`abort`,onAbort)};s.on(`error`,e=>{cleanup(),o(new f(`Could not run git: ${e.message}`))}),s.on(`close`,e=>{cleanup(),a(u===null?{exitCode:e??1,stdout:c,stderr:l}:{exitCode:u.exitCode,stdout:c,stderr:l===``?u.note:`${l}\n${u.note}`})})})}}const Ut={create:`pnpm exec bst-fj pr:create`,update:`pnpm exec bst-fj pr:update`},Q={closes:`--closes`,allowUnlink:`--allow-unlink`};function warnClosingLinks(e){for(let t of describeClosingLinks(e,Q))j.warn(t)}async function runForgejoPr(e,t){let n=process.cwd(),r=requireForgejoTarget(n,void 0,e);try{return await runPrUpsert(cliGit(),forgejoPrHost(cliFetcher(),r),{...t,cwd:n,onResolved:({mode:e,branch:t,base:n})=>{j.debug(`pr:${e} ${t} (diff base ${n}, forgejo)`)},onClosingLinks:warnClosingLinks})}catch(e){throw rewordPrUpsertError(e,{commands:Ut,flags:Q,warn:e=>{j.warn(e)}})}}const Wt=_({meta:{name:`pr:create`,description:`Push the current branch and open its pull request (Forgejo-only). Refuses to run on main, master or the default branch.`},args:{title:{type:`string`,description:`PR title (default: derived from the branch's commits)`},body:{type:`string`,description:`PR body (default: a list of the branch's commits)`},"body-file":{type:`string`,description:`Read the PR body from a file ('-' for stdin)`},base:{type:`string`,description:`Base branch for a new PR (default: the repo's default branch); with --upsert on an already-open PR it selects only the diff range`},draft:{type:`boolean`,description:`Open the PR as a draft`},upsert:{type:`boolean`,description:`Update the PR instead of failing when the branch already has one open`},"allow-unlink":{type:`boolean`,description:`With --upsert: permit a --body that drops a closing keyword the PR carries`},closes:{type:`string`,description:`Issues the PR closes, comma-separated (12 or 12,15): adds a Closes #<n> line to the body for each one it does not already close`},"dry-run":{type:`boolean`,description:`Show what would happen without pushing`},json:{type:`boolean`,description:`Emit one JSON document: action (created | updated | would-create | would-update), number (or null), url (or null), branch, base, title, body, droppedRefs? ([{text, issue}]), closesAdded? (with --closes: the issues it added a Closes line for), dryRun. A create or would-create carries droppedRefs; on a dry run, number and url are null. The document carries no claims member and no claim advice line: the closed-issue claim check reads the repo's .tooling.json and is bst pr:create's alone.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=readBodySource(e.body??void 0,e[`body-file`]??void 0),r=await runForgejoPr("bst-fj pr:create works on Forgejo only. Use `gh pr create` on GitHub, or `pnpm exec bst pr:create`, which covers both.",{mode:e.upsert===!0?`upsert`:`create`,title:e.title??void 0,body:n,base:e.base??void 0,allowUnlink:e[`allow-unlink`]===!0,closes:e.closes===void 0?void 0:parseIssueList(e.closes),draft:e.draft===!0||void 0,dryRun:e[`dry-run`]===!0});t.json({...r,dryRun:e[`dry-run`]===!0});let i=formatPrCreate(r);for(let e of i.lines)t.text(e);i.body!==null&&t.text(`${i.body.heading}\n${i.body.text}`)}}),Gt=g.object({filename:g.string(),previous_filename:g.string().nullish(),status:g.string().nullish(),additions:g.number().default(0),deletions:g.number().default(0)});async function listAllPrFiles(e,t,n){let r=[];for(let i=1;i<=20;i++){let a=await readPrFilesPage(e,t,n,i,100);if(r.push(...a.files),!a.truncated)return{files:r,truncated:!1}}return{files:r,truncated:!0}}async function readPrFilesPage(e,t,n,r,i){let a=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls/${String(n)}/files?page=${String(r)}&limit=${String(i)}`,o=await e.fetch(a,{headers:{Authorization:`token ${t.token}`}});o.ok||await throwForgejoFailure(o,{verb:`list PR files`,resource:`#${String(n)}`});let s=g.array(Gt).safeParse(await o.json());if(!s.success)throw new f(`Unexpected PR files response: ${s.error.message}`);return{files:s.data.map(e=>({filename:e.filename,previousFilename:e.previous_filename??null,status:e.status??null,additions:e.additions,deletions:e.deletions})),truncated:o.headers.get(`x-hasmore`)===`true`}}function runPrFiles(e,t){let n=parsePrNumber(t.number);return listAllPrFiles(e,requireForgejoTarget(t.cwd,parseRepoTarget(t.repo),`pr:files is Forgejo-only -- gh pr diff --name-only already serves GitHub.`),n)}function renderPrFiles(e){let t=e.files.map(e=>`${e.status??`unknown`} ${e.filename}`);return t.length===0&&t.push(`No changed files.`),e.truncated&&t.push(`Listing truncated; the pull request changes more files.`),t.join(`
|
|
29
|
+
`)}const Kt=_({meta:{name:`pr:files`,description:`List every file a pull request changes, reading every page (Forgejo-only)`},args:{number:{type:`positional`,required:!0,description:`Pull request number`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: files ([{filename, status (or null), additions, deletions}]), truncated (true only when the pull request changes more files than the command reads, at least 1000).`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=await runPrFiles(cliFetcher(),{cwd:process.cwd(),number:e.number,repo:e.repo??void 0});t.json({files:n.files,truncated:n.truncated}),t.text(renderPrFiles(n))}});function parseState(e){if(e===`open`||e===`closed`||e===`all`)return e;throw new u(`Invalid --state "${e}" (expected open, closed, or all).`)}async function runPrList(e,t){let n=parseState(t.state),r=parseLimitFlag(t.limit);j.debug(`pr:list state=${n} limit=${String(r)}`);let i=requireForgejoTarget(t.cwd,parseRepoTarget(t.repo),`pr:list is Forgejo-only -- gh pr list already serves GitHub, first-class. Use that instead.`),a=[];return{pulls:(await listPulls(e,i,{state:n,sort:`recentupdate`,limit:r,onPageCap:()=>{a.push(`PR listing hit the page cap before an empty page; results may be truncated.`)}})).slice(0,r),notices:a}}function statusLabel(e){return e.merged?`merged`:e.draft===!0?`${e.state}/draft`:e.state}function renderPrList(e){return e.pulls.length===0?`No pull requests.`:e.pulls.map(e=>{let t=`${e.headRef} -> ${e.baseRef??`?`}`,n=e.labels.length===0?``:` [${e.labels.join(`, `)}]`,r=e.url===null?``:` ${e.url}`;return`#${String(e.number)} ${statusLabel(e)} ${t}: ${e.title??`(no title)`}${n}${r}`}).join(`
|
|
30
|
+
`)}const qt=_({meta:{name:`pr:list`,description:`List a repository's pull requests, most recently updated first (Forgejo-only; use gh pr list on GitHub)`},args:{state:{type:`string`,default:`open`,description:`open | closed | all`},limit:{type:`string`,default:`30`,description:`Maximum pull requests to return`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: pulls ([{number, title (nullable), headRef, baseRef (nullable), state (open | closed), merged, mergedAt (null unless merged), url (nullable), draft (nullable), author (nullable), updatedAt (nullable), labels}]).`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=await runPrList(cliFetcher(),{cwd:process.cwd(),state:e.state,limit:e.limit,repo:e.repo??void 0});for(let e of n.notices)t.notice(e);t.json({pulls:n.pulls}),t.text(renderPrList(n))}});async function mergePr(e,t,n,r){let i=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls/${String(n)}/merge`,a={Do:r?.method??`merge`,delete_branch_after_merge:r?.deleteBranch??!0};r?.expectedHeadSha!==void 0&&(a.head_commit_id=r.expectedHeadSha);let o=await e.fetch(i,{method:`POST`,headers:{Authorization:`token ${t.token}`,"Content-Type":`application/json`},body:JSON.stringify(a)});o.ok||await throwForgejoFailure(o,{verb:`merge PR`,resource:`#${String(n)}`})}const Jt=g.object({state:g.string(),draft:g.boolean(),mergeable:g.boolean().nullable(),head:g.object({sha:g.string()}),merge_base:g.string(),changed_files:g.number().nullish(),base:g.object({ref:g.string()}),labels:g.array(g.object({name:g.string()})).nullable(),updated_at:g.string().nullish()});async function readMergeGate(e,t,n){let r=`${t.serverUrl}/api/v1/repos/${t.repository}/pulls/${String(n)}`,i=await e.fetch(r,{headers:{Authorization:`token ${t.token}`}});i.ok||await throwForgejoFailure(i,{verb:`read PR merge gate`,resource:`#${String(n)}`});let a=Jt.safeParse(await i.json());if(!a.success)throw new f(`Unexpected PR merge-gate response: ${a.error.message}`);return{open:a.data.state===`open`,draft:a.data.draft,mergeable:a.data.mergeable??!1,headSha:a.data.head.sha,mergeBase:a.data.merge_base,changedFiles:a.data.changed_files??null,baseRef:a.data.base.ref,labels:(a.data.labels??[]).map(e=>e.name),updatedAt:a.data.updated_at??null}}async function confirmMergeable(e,t,n,r){let i=await readMergeGate(e,t,n);if(i.mergeable)return{verdict:`mergeable`,gate:i,firstGate:i,rechecked:!1,evidence:null};if(r.settleOnFirstRead?.(i)===!0)return{verdict:`unconfirmed`,gate:i,firstGate:i,rechecked:!1,evidence:null};r.beforeRecheck?.(i),await r.sleep(r.delayMs);let a=await readMergeGate(e,t,n);return a.mergeable?{verdict:`mergeable`,gate:a,firstGate:i,rechecked:!0,evidence:null}:a.headSha===i.headSha&&a.mergeBase===i.mergeBase?{verdict:`conflicted`,gate:a,firstGate:i,rechecked:!0,evidence:`The forge reported it unmergeable on two reads ${String(r.delayMs)}ms apart, at head ${a.headSha}.`}:{verdict:`unconfirmed`,gate:a,firstGate:i,rechecked:!0,evidence:a.headSha===i.headSha?`Its merge base moved from ${i.mergeBase} to ${a.mergeBase} between the two reads.`:`Its head moved from ${i.headSha} to ${a.headSha} between the two reads.`}}g.object({draft:g.boolean(),mergeable:g.boolean().nullable(),merge_base:g.string(),base:g.object({ref:g.string(),sha:g.string()})});const $=[`merge`,`rebase`,`squash`];function sleepDefault(e){return new Promise(t=>{setTimeout(t,e)})}function headMatches(e,t){let n=e.trim().toLowerCase();return n.length>=7&&t.toLowerCase().startsWith(n)}async function runPrMergeCore(e,t,n,r={}){let i=`PR #${String(n)}`,a=r.method??`merge`,o=r.expectedHeadSha,moved=e=>o!==void 0&&!headMatches(o,e),s=await confirmMergeable(e,t,n,{delayMs:2e3,sleep:r.sleep??sleepDefault,settleOnFirstRead:e=>!e.open||e.draft||moved(e.headSha)}),{gate:c,verdict:l}=s,refuse=e=>({kind:`refused`,reason:`Refusing to merge ${i}: ${e}`});if(!c.open)return refuse(`it is closed.`);if(c.draft)return refuse(`it is a draft.`);if(r.refuseEmpty===!0&&(c.headSha===c.mergeBase||c.changedFiles===0))return refuse(`its diff against its base is empty, so its branch is left alone.`);if(o!==void 0&&moved(c.headSha))return refuse(`its head is ${c.headSha}, not the approved ${o}.`);if(l===`conflicted`)return refuse(`it has conflicts. ${s.evidence??``}`.trimEnd());if(l===`unconfirmed`)return refuse(`the forge could not confirm it is mergeable. ${s.evidence??``}`.trimEnd());let u=await readCommitChecks(e,t,c.headSha),d=classifyBaseStatus(u),f=u.parsed&&u.contexts.length>0&&u.contexts.every(e=>e.verdict===`skipped`);if(!(d===`green`||r.ignoreChecks===!0||(d===`no-status`||f)&&r.allowNoStatus===!0))return{kind:`refused`,reason:`Refusing to merge ${i}: its checks at ${c.headSha} are ${d}, not green.`,checks:d};let p={number:n,merged:!1,method:a,headSha:c.headSha,verdict:l,checks:d};return r.dryRun===!0?{kind:`ok`,result:p}:(await mergePr(e,t,n,{method:a,deleteBranch:r.deleteBranch??!1,expectedHeadSha:c.headSha}),{kind:`ok`,result:{...p,merged:!0}})}function parseMethod(e){if(e===void 0)return`merge`;let t=$.find(t=>t===e);if(t===void 0)throw new u(`Invalid --method "${e}" (expected one of: ${$.join(`, `)}).`);return t}async function runPrMerge(e,t){let n=parsePrNumber(t.number),r=parseMethod(t.method),i=await runPrMergeCore(e,requireForgejoTarget(t.cwd,parseRepoTarget(t.repo),`pr:merge is Forgejo-only -- use gh pr merge on GitHub.`),n,{method:r,deleteBranch:t.deleteBranch,ignoreChecks:t.ignoreChecks,dryRun:t.dryRun,sleep:t.sleep??sleep});if(i.kind===`refused`){let e=i.checks===void 0?``:` Pass --ignore-checks to merge anyway.`;throw new u(`${i.reason}${e}`)}return i.result}function renderPrMerge(e){let t=`PR #${String(e.number)} (${e.method}) at ${e.headSha.slice(0,12)}, checks ${e.checks}`;return e.merged?`Merged ${t}.`:`Dry run: would merge ${t}.`}const Yt=_({meta:{name:`pr:merge`,description:`Merge an open, non-draft pull request the forge confirms is mergeable and whose checks are green, pinned to the head SHA it read (Forgejo-only; use gh pr merge on GitHub)`},args:{number:{type:`positional`,required:!0,description:`Pull request number`},method:{type:`string`,description:`Merge method: merge, rebase or squash (default: merge)`},"delete-branch":{type:`boolean`,description:`Delete the head branch after the merge`},"ignore-checks":{type:`boolean`,description:`Merge even when the head's combined status is not green`},"dry-run":{type:`boolean`,description:`Run every check and report, but do not merge`},repo:{type:`string`,description:`Repository URL (default: this repo)`},json:{type:`boolean`,description:`Emit one JSON document: number, merged, method (merge | rebase | squash), headSha, verdict (mergeable), checks (green | red | pending | no-status | unparseable). merged is false on a dry run; a refusal is an error, never this document.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=await runPrMerge(cliFetcher(),{cwd:process.cwd(),number:e.number,method:e.method??void 0,deleteBranch:e[`delete-branch`]===!0,ignoreChecks:e[`ignore-checks`]===!0,dryRun:e[`dry-run`]===!0,repo:e.repo??void 0});t.json(n),t.text(renderPrMerge(n))}});function isOpen(e){return e.state===`open`&&e.merged===!1}function notOpenMessage(e,t){let n=`#${String(e)}`;return t.merged?`Pull request ${n} is merged, so it has no base or draft state left to change.`:`Pull request ${n} is ${t.state}, so it has no base or draft state left to change. Run \`pr:reopen ${String(e)}\` first if this work is still live.`}async function runPrRetarget(e,t){let n=await e.readLive(t.number);if(!isOpen(n))throw new u(notOpenMessage(t.number,n));if(t.base===n.head)throw new u(`Pull request #${String(t.number)} cannot target its own head branch "${t.base}" -- choose a branch it is meant to merge into.`);if(t.base===n.base)return{action:`unchanged`,number:t.number,url:n.url,previousBase:n.base,base:n.base,head:n.head,mergeable:n.mergeable,dryRun:t.dryRun};if(!await e.branchExists(t.base))throw new u(`Branch "${t.base}" does not exist in this repository, so pull request #${String(t.number)} cannot target it -- push the branch, or pass a base the forge has.`);if(t.dryRun)return{action:`would-retarget`,number:t.number,url:n.url,previousBase:n.base,base:t.base,head:n.head,mergeable:n.mergeable,dryRun:!0};await e.setBase(t.number,t.base);let r=await e.readLive(t.number);if(r.base!==t.base)throw new u(`Pull request #${String(t.number)} still reports its base as "${r.base}" after the request to move it to "${t.base}" -- this forge accepted the field and ignored it, so change the base in its web interface.`);let i=r.mergeable;return i===!1&&(await t.sleep(t.recheckDelayMs),i=(await e.readLive(t.number)).mergeable),{action:`retargeted`,number:t.number,url:r.url,previousBase:n.base,base:t.base,head:n.head,mergeable:i,dryRun:!1}}async function runPrReady(e,t){let n=await e.readLive(t.number);if(!isOpen(n))throw new u(notOpenMessage(t.number,n));let r=t.title;if(r!==void 0){if(r.trim()===``)throw new u(`--title is empty -- pass the title to write, or omit --title to drop the WIP marker from pull request #${String(t.number)}'s current title.`);if(hasWipPrefix(r)){let t=e.wipTitles?`which on this forge keeps the pull request a draft`:`so the pull request would still read as work in progress`;throw new u(`--title ${JSON.stringify(r)} carries a WIP marker, ${t} -- pass the title you want it to read without one.`)}}let i=r??stripWipPrefix(n.title);if(i.trim()===``)throw new u(`Pull request #${String(t.number)} would be left with an empty title, which neither forge accepts -- pass --title with the title to write.`);if(e.wipTitles&&n.draft&&r===void 0&&!hasWipPrefix(n.title))throw new u(`Pull request #${String(t.number)} is a draft and its title ${JSON.stringify(n.title)} carries no WIP marker this tool recognises, so there is nothing to strip -- pass --title "<title>" to write the title that clears the draft.`);let a=i!==n.title;if(!n.draft&&!a)return{action:`already-ready`,number:t.number,url:n.url,previousTitle:n.title,title:n.title,draft:n.draft,dryRun:t.dryRun};if(t.dryRun)return{action:n.draft?`would-ready`:`would-retitle`,number:t.number,url:n.url,previousTitle:n.title,title:i,draft:n.draft,dryRun:!0};await e.ready(t.number,{draft:n.draft,title:i,titleChanged:a});let o=await e.readLive(t.number);if(o.draft)throw new u(`Pull request #${String(t.number)} is still a draft after the title ${JSON.stringify(i)} was written -- its draft state is set by something other than the title, so clear it in the forge's interface.`);return{action:n.draft?`readied`:`retitled`,number:t.number,url:o.url,previousTitle:n.title,title:o.title,draft:o.draft,dryRun:!1}}async function runPrReopen(e,t){let n=await e.readLive(t.number);if(n.merged===!0)throw new u(`Pull request #${String(t.number)} was merged, so there is nothing to reopen -- open a new pull request for further work.`);if(n.state===`open`)return{action:`already-open`,number:t.number,url:n.url,title:n.title,head:n.head,base:n.base,draft:n.draft,dryRun:t.dryRun};if(n.state!==`closed`)throw new u(`Pull request #${String(t.number)} reports the state "${n.state}", which this command has no rule for -- it reopens a pull request reported as closed, and guesses at no state it did not expect.`);if(t.dryRun)return{action:`would-reopen`,number:t.number,url:n.url,title:n.title,head:n.head,base:n.base,draft:n.draft,dryRun:!0};await e.reopen(t.number);let r=await e.readLive(t.number);if(!isOpen(r))throw new u(`Pull request #${String(t.number)} still reports \`${r.state}\` after the request to reopen it -- reopen it in the forge's web interface.`);return{action:`reopened`,number:t.number,url:r.url,title:r.title,head:r.head,base:r.base,draft:r.draft,dryRun:!1}}function mergeabilityLine(e){return e===!0?`Mergeability: mergeable.`:e===!1?`Mergeability: not mergeable -- advice, not a verdict.`:`Mergeability: unknown -- the forge has not computed it.`}function renderPrRetarget(e){let t=`#${String(e.number)}`,n=[];return e.action===`retargeted`?n.push(`Pull request ${t} now targets "${e.base}" (was "${e.previousBase}").`):e.action===`unchanged`?n.push(`Pull request ${t} already targets "${e.base}".`):n.push(`Dry run: pull request ${t} would move from "${e.previousBase}" to "${e.base}".`),n.push(mergeabilityLine(e.mergeable)),n.join(`
|
|
30
31
|
`)}function renderPrReady(e){let t=`#${String(e.number)}`;return e.action===`readied`?`Pull request ${t} is no longer a draft, reading as "${e.title}".`:e.action===`retitled`?`Pull request ${t} now reads "${e.title}".`:e.action===`already-ready`?`Pull request ${t} is already ready and reads "${e.title}".`:e.action===`would-ready`?`Dry run: pull request ${t} would stop being a draft, reading "${e.title}".`:`Dry run: pull request ${t} would read "${e.title}".`}function renderPrReopen(e){let t=`#${String(e.number)}`;if(e.action===`reopened`){let n=[`Pull request ${t} is open again (head "${e.head}" -> "${e.base}").`];return e.draft&&n.push(`It is still a draft -- run pr:ready ${String(e.number)} when it is ready for review.`),n.join(`
|
|
31
|
-
`)}return e.action===`already-open`?`Pull request ${t} is already open.`:`Dry run: pull request ${t} would be reopened.`}async function resolvePrEditNumber(e,t,n){return t===void 0?{number:(await resolveBranchPr(cliGit(),e,{cwd:process.cwd(),state:n,signal:null})).number,autodetected:!0}:{number:parsePrNumber(t),autodetected:!1}}const
|
|
32
|
+
`)}return e.action===`already-open`?`Pull request ${t} is already open.`:`Dry run: pull request ${t} would be reopened.`}async function resolvePrEditNumber(e,t,n){return t===void 0?{number:(await resolveBranchPr(cliGit(),e,{cwd:process.cwd(),state:n,signal:null})).number,autodetected:!0}:{number:parsePrNumber(t),autodetected:!1}}const Xt={"pr:checks":Bt,"pr:close":Vt,"pr:create":Wt,"pr:files":Kt,"pr:list":qt,"pr:merge":Yt,"pr:ready":_({meta:{name:`pr:ready`,description:`Mark a draft pull request ready, dropping one WIP: prefix or taking --title, and confirm the forge no longer reports a draft (Forgejo-only; use gh pr ready on GitHub)`},args:{number:{type:`positional`,required:!1,description:`Pull request number (default: the current branch's open pull request)`},title:{type:`string`,description:`Write this title instead of stripping the WIP prefix from the current one`},repo:{type:`string`,description:`Repository URL (default: this repo)`},"dry-run":{type:`boolean`,description:`Run every read and report, but do not write`},json:{type:`boolean`,description:`Emit one JSON document: action (readied | retitled | already-ready | would-ready | would-retitle), number, url, previousTitle, title, draft, dryRun; a refusal is an error, never this document.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0);refuseRepoWithoutNumber(e.number,e.repo);let n=requireForgejoTargetFromRepo(process.cwd(),e.repo??void 0,`pr:ready is Forgejo-only -- use gh pr ready <n> on GitHub.`),r=forgejoPrEditHost(cliFetcher(),n),{number:i}=await resolvePrEditNumber(r,e.number,`open`),a=await runPrReady(r,{number:i,title:e.title??void 0,dryRun:e[`dry-run`]===!0});t.json(a),t.text(renderPrReady(a))}}),"pr:reopen":_({meta:{name:`pr:reopen`,description:`Reopen a closed, unmerged pull request and confirm the forge reports it open. An already-open pull request is reported without writing; a merged one, or an issue, is refused (Forgejo-only; use gh pr reopen on GitHub)`},args:{number:{type:`positional`,required:!1,description:`Pull request number (default: the current branch's closed pull request)`},repo:{type:`string`,description:`Repository URL (default: this repo)`},"dry-run":{type:`boolean`,description:`Run every read and report, but do not write`},json:{type:`boolean`,description:`Emit one JSON document: action (reopened | already-open | would-reopen), number, url, title, head, base, draft, dryRun; a refusal is an error, never this document.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0);refuseRepoWithoutNumber(e.number,e.repo);let n=requireForgejoTargetFromRepo(process.cwd(),e.repo??void 0,`pr:reopen is Forgejo-only -- use gh pr reopen <n> on GitHub.`),r=forgejoPrEditHost(cliFetcher(),n),{number:i,autodetected:a}=await resolvePrEditNumber(r,e.number,`closed-unmerged`);if(!a&&!(await forgejoIssueApi(cliFetcher(),n).get(i)).isPullRequest)throw new u(`#${String(i)} is an issue, not a pull request -- pr:reopen refuses to write issue state. Use \`pnpm exec bst-fj issue:reopen ${String(i)}\` to reopen it.`);let o=await runPrReopen(r,{number:i,dryRun:e[`dry-run`]===!0});t.json(o),t.text(renderPrReopen(o))}}),"pr:retarget":_({meta:{name:`pr:retarget`,description:`Change an open pull request's base branch, confirm the forge took it, and report its mergeability as advice (Forgejo-only; use gh pr edit on GitHub)`},args:{number:{type:`positional`,required:!1,description:`Pull request number (default: the current branch's open pull request)`},base:{type:`string`,required:!0,description:`The branch to retarget the pull request onto`},repo:{type:`string`,description:`Repository URL (default: this repo)`},"dry-run":{type:`boolean`,description:`Run every read and report, but do not write`},json:{type:`boolean`,description:`Emit one JSON document: action (retargeted | unchanged | would-retarget), number, url, previousBase, base, head, mergeable (true | false | null, advice only), dryRun; a refusal is an error, never this document.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0);refuseRepoWithoutNumber(e.number,e.repo);let n=requireForgejoTargetFromRepo(process.cwd(),e.repo??void 0,`pr:retarget is Forgejo-only -- use gh pr edit <n> --base <branch> on GitHub.`),r=forgejoPrEditHost(cliFetcher(),n),{number:i}=await resolvePrEditNumber(r,e.number,`open`),a=await runPrRetarget(r,{number:i,base:e.base,dryRun:e[`dry-run`]===!0,recheckDelayMs:2e3,sleep});t.json(a),t.text(renderPrRetarget(a))}}),"pr:update":_({meta:{name:`pr:update`,description:`Push the current branch to its open pull request (Forgejo-only). Refuses to run on main, master or the default branch. Fails when no PR is open; use pr:create then. Never changes the PR's draft state.`},args:{number:{type:`positional`,required:!1,description:`Pull request number; must be the current branch's open pull request (default: that pull request)`},title:{type:`string`,description:`Replace the PR title (default: leave it unchanged); on Forgejo a draft keeps its WIP: prefix`},body:{type:`string`,description:`Replace the PR body (default: leave it unchanged)`},"body-file":{type:`string`,description:`Read the new PR body from a file ('-' for stdin)`},base:{type:`string`,description:`Base branch to diff against (default: the repo's); never repoints the PR (pr:retarget does)`},"allow-unlink":{type:`boolean`,description:`Permit a --body that drops a closing keyword the current body carries`},closes:{type:`string`,description:`Issues the PR closes, comma-separated (12 or 12,15): adds a Closes #<n> line to the body for each one it does not already close`},"dry-run":{type:`boolean`,description:`Show what would happen without pushing`},json:{type:`boolean`,description:`Emit one JSON document: action (updated | would-update), number (or null), url (or null), branch, base, title, body, closesAdded? (with --closes: the issues it added a Closes line for), dryRun, rewrites. On a dry run, number and url are null.`},verbose:{type:`boolean`,description:`Emit detailed debug output`}},async run({args:e}){let t=createCliOutput(e.json===!0),n=readBodySource(e.body??void 0,e[`body-file`]??void 0),r=e.title!==void 0||n!==void 0,i=await runForgejoPr("bst-fj pr:update works on Forgejo only. Use `gh pr edit` on GitHub, or `pnpm exec bst pr:update`, which covers both.",{mode:`update`,title:e.title??void 0,body:n,base:e.base??void 0,allowUnlink:e[`allow-unlink`]===!0,closes:e.closes===void 0?void 0:parseIssueList(e.closes),draft:void 0,expectedNumber:e.number===void 0?void 0:parsePrNumber(e.number),dryRun:e[`dry-run`]===!0});t.json({...i,rewrites:r,dryRun:e[`dry-run`]===!0});let a=formatPrUpdate(i,r,{title:`--title`,body:`--body`});for(let e of a.lines)t.text(e);a.body!==null&&t.text(`${a.body.heading}\n${a.body.text}`)}})},Zt={"commit:status":V,labels:Ce,...st,...pt,...Xt,"release:create":De,secrets:Pe,webhooks:Ve,...zt};applyVerbosityFromArgs(process.argv.slice(2)),j.debug(describeEnvFileLoad(ee)),setForgejoLogger(j),await runCli({name:`bst-fj`,version:E,description:`Forgejo API commands: labels, secrets, webhooks, releases, issues, PRs, branches, workflows, CI runs and logs, and commit checks`,banner:void 0,subCommands:Zt,describeError:describeForgeError});export{};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@bensandee/forgejo-cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.11.0",
|
|
4
4
|
"description": "bst-fj: Forgejo API commands without the rest of bst",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -35,7 +35,7 @@
|
|
|
35
35
|
"@bensandee/cli-kit": "0.0.0",
|
|
36
36
|
"@bensandee/forgejo": "0.7.0",
|
|
37
37
|
"@types/node": "24.19.2",
|
|
38
|
-
"tsdown": "0.23.
|
|
38
|
+
"tsdown": "0.23.7"
|
|
39
39
|
},
|
|
40
40
|
"scripts": {
|
|
41
41
|
"build": "tsdown",
|