@kaisers-io/refs 0.16.0 → 0.17.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/CHANGELOG.md +31 -0
- package/dist/refs.mjs +15 -15
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,37 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [0.17.0] - 2026-09-13
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
|
|
12
|
+
- **`refs doctor` and `refs sync` show what they are doing while they work.** Both used to print
|
|
13
|
+
nothing until they were done: about 4 and 9 seconds on a home with 8 refs, long enough to look
|
|
14
|
+
stuck. A terminal now gets a one-line spinner on stderr naming the running step. For `doctor`
|
|
15
|
+
that is each check (`Checking SSH authentication`), for `sync` how many refs are done
|
|
16
|
+
(`Syncing refs: 3/8 done`). The line is cleared before any
|
|
17
|
+
output, so what the commands print, their `--json` envelopes and their exit codes are unchanged.
|
|
18
|
+
|
|
19
|
+
Agents never see it. It is off under `--json` whatever the terminal is, and off when stderr is
|
|
20
|
+
not a terminal, with `TERM=dumb`, in CI, and with the new `REFS_PROGRESS=0`. It adds no
|
|
21
|
+
dependency. A spinner library would add 6 to 46 KB to the bundle, and the small ones install
|
|
22
|
+
SIGINT handlers that call `process.exit`, cutting across how refs stops its git processes on
|
|
23
|
+
Ctrl-C. The cursor stays visible, so an interrupted run cannot leave it hidden.
|
|
24
|
+
|
|
25
|
+
## [0.16.1] - 2026-09-13
|
|
26
|
+
|
|
27
|
+
### Changed
|
|
28
|
+
|
|
29
|
+
- **The skill answers "which packages are not registered?" with `refs doctor`.** Asked whether a
|
|
30
|
+
tracked repository declares packages the configuration does not register, agents often never ran
|
|
31
|
+
doctor. They read `packages_count` from `refs show`, counted directories, and inferred an answer,
|
|
32
|
+
which turned into a confident wrong one when discovery could not finish. `SKILL.md` now routes
|
|
33
|
+
the question to `refs doctor --json`. It also says that `packages_count`, `refs show --packages`
|
|
34
|
+
and `refs list --packages` describe what is registered, not what the repository declares.
|
|
35
|
+
`MAINTAIN.md` explains how to read the answer: the `config-drift` findings regardless of its
|
|
36
|
+
status, the "could not check" case, and declined packages. The claim that an undecided package
|
|
37
|
+
keeps `config-drift` on `warn` is gone. It stopped being true in 0.15.0.
|
|
38
|
+
|
|
8
39
|
## [0.16.0] - 2026-09-13
|
|
9
40
|
|
|
10
41
|
### Added
|
package/dist/refs.mjs
CHANGED
|
@@ -325,32 +325,32 @@ sync_ttl = "1h"
|
|
|
325
325
|
`)[0]??t;return n.length<=200?n:`${n.slice(0,200)}…`},fd=(e,t)=>t?`restored`:e.oldSha===e.newSha?`fresh`:`updated`,pd=(e,t)=>{let n=[];if(e&&n.push(`checkout had local changes (managed checkouts are read-only) — discarded and restored to the remote state`),t!==void 0&&n.push(t),n.length!==0)return n.join(` | `)},md=e=>{let{branchRenamedTo:t,dirty:n,setHeadWarning:r,shas:i}=e,a={...i,status:fd(i,n)};t!==void 0&&(a.branchRenamedTo=t);let o=pd(n,r);return o!==void 0&&(a.warning=o),a},hd=(e,t,n)=>{let r={dirty:t,shas:n};return e.branchRenamedTo!==void 0&&(r.branchRenamedTo=e.branchRenamedTo),e.warning!==void 0&&(r.setHeadWarning=e.warning),r},U=e=>pe(m(e,`.git`)),gd=e=>`refusing to sync ${e}: not a refs-managed checkout`,_d=async(e,t)=>{if(!U(t))throw y(gd(t));let n=await e.run(`git`,[`config`,`--local`,`--get`,`core.hooksPath`],{cwd:t});if(n.exitCode!==0||n.stdout.trim()===``)throw y(gd(t))},vd=/filtering not recognized/iu,yd=e=>e===void 0?{}:{cwd:e},bd=(e,t,n)=>({action:e,args:t,cmd:`git`,...yd(n)}),xd=async(e,t)=>{let n=await e.run(t.cmd,t.args,yd(t.cwd));if(n.exitCode===0)return n;let r=n.stderr.trim()||n.stdout.trim()||`exit code ${n.exitCode}`;throw y(`${t.action} failed: ${r}`)},Sd=async(e,t)=>{let n=[`clone`,`-q`];t.mode===`blobless`&&n.push(`--filter=blob:none`),n.push(`--`,t.cloneUrl,t.dest);let r=await xd(e,bd(`git clone`,n));return await xd(e,bd(`git config core.hooksPath`,[`config`,`core.hooksPath`,t.hooksDir],t.dest)),t.mode===`blobless`&&vd.test(r.stderr)?{effectiveMode:`full`,warning:`server did not honour the partial-clone filter (blob:none); fell back to a full clone`}:{effectiveMode:t.mode}},Cd=async(e,t)=>{let n=await e.run(`git`,[`symbolic-ref`,`--short`,`refs/remotes/origin/HEAD`],{cwd:t});if(n.exitCode!==0)return;let r=n.stdout.trim();return r.startsWith(`origin/`)?r.slice(7):r},wd=async(e,t)=>{let n=await Cd(e,t);if(n!==void 0)return n;await e.run(`git`,[`remote`,`set-head`,`origin`,`--auto`],{cwd:t});let r=await Cd(e,t);if(r!==void 0)return r;throw y(`could not detect the default branch for checkout: ${t}`)},Td=async(e,t)=>(await xd(e,bd(`git rev-parse HEAD`,[`rev-parse`,`HEAD`],t))).stdout.trim(),Ed=async(e,t)=>(await xd(e,bd(`git status --porcelain`,[`status`,`--porcelain`],t))).stdout.trim()!==``,Dd=async(e,t)=>{await xd(e,bd(`git fetch`,[`fetch`,`--prune`,`--tags`,`origin`],t.dir));let n=await e.run(`git`,[`remote`,`set-head`,`origin`,`--auto`],{cwd:t.dir}),r=await wd(e,t.dir),i={branch:r};return r!==t.defaultBranch&&(i.branchRenamedTo=r),n.exitCode!==0&&(i.warning=`could not refresh origin/HEAD: ${dd(n)}`),i},Od=e=>[bd(`git reset --hard HEAD (pre-checkout)`,[`reset`,`--hard`,`HEAD`],e),bd(`git clean -fd`,[`clean`,`-fd`],e)],kd=async(e,t)=>{let{branch:n,dir:r,dirty:i}=t,a=[];i&&a.push(...Od(r)),a.push(bd(`git checkout -B`,[`checkout`,`-B`,n,`origin/${n}`],r),bd(`git reset --hard`,[`reset`,`--hard`,`origin/${n}`],r));for(let t of a)await xd(e,t)},Ad=async(e,t)=>{await _d(e,t.dir);let n=await Td(e,t.dir),r=await Dd(e,t),i=await Ed(e,t.dir);await kd(e,{branch:r.branch,dir:t.dir,dirty:i});let a=await Td(e,t.dir);return md(hd(r,i,{newSha:a,oldSha:n}))},jd=async(e,t,n)=>(await e.run(`git`,[`show-ref`,`--verify`,`--`,`refs/tags/${n}`],{cwd:t})).exitCode===0,Md=[`#!/bin/sh`,`echo "refs: this checkout is a managed read-only reference — commits are blocked" >&2`,`exit 1`,``].join(`
|
|
326
326
|
`),Nd=async e=>{await Promise.all([`pre-commit`,`pre-push`].map(async n=>{let r=m(e.hooksDir,n);await $l(r,Md),await t(r,493)}))},Pd=async(e,t,n)=>{let r=await xd(e,bd(`git tag`,[`tag`,`--sort=-version:refname`],t)),i=r.stdout.split(`
|
|
327
327
|
`).map(e=>e.trim()).filter(e=>e!==``),a=!r.stderr.includes(`refs: stdout exceeded`);return n===void 0?{complete:a,tags:i}:{complete:a&&i.length<=n,tags:i.slice(0,n)}},Fd=/\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?/u,Id=/\d+\.\d+\.\d+/gu,Ld=e=>ll.safeParse(e).success,Rd=e=>{let t=e.match(Id);return t!==null&&t.length>1},zd=e=>{let t=Fd.exec(e);if(!t||Rd(e))return;let[n]=t,r=e.replace(n,`{version}`);if(Ld(r))return r},Bd=(e,t,n)=>{let r=e.get(t);r===void 0?e.set(t,{count:1,index:n}):r.count+=1},Vd=e=>{let t=new Map;for(let[n,r]of e.entries()){let e=zd(r);e&&Bd(t,e,n)}return t},Hd=(e,t)=>e.count>t.count||e.count===t.count&&e.index<t.index,Ud=e=>{let t=[...e.entries()],[n]=t;if(n===void 0)return null;let[r,i]=n;return t.slice(1).reduce(({format:e,data:t},[n,r])=>Hd(r,t)?{data:r,format:n}:{data:t,format:e},{data:i,format:r}).format},Wd=e=>{let t=Vd(e);return Ud(t)},Gd=(e,t)=>e.replaceAll(`{version}`,()=>t),Kd=async(e,t,n,r)=>{let i=Gd(n,r);if(!await jd(e,t,i))throw _(`tag '${i}' not found in ${t} — check the version or tag_format`);return i},qd=/^(?<scheme>[a-z][a-z0-9+.-]*:\/\/)?[\s\S]*@/iu,W=e=>{let t=e.replace(qd,`$<scheme><redacted>@`);return t.length<=200?t:`${t.slice(0,200)}…`},Jd=/\.git$/u,Yd=e=>e.replace(Jd,``),Xd=e=>{let t=0,n=e.length;for(;t<n&&e.charAt(t)===`/`;)t+=1;for(;n>t&&e.charAt(n-1)===`/`;)--n;return e.slice(t,n)},Zd=/^git@(?<host>[^:/\s]+):(?<path>[^\s]+)$/u,Qd=/^git\+/u,$d={"https:":`443`,"ssh:":`22`},ef=e=>e.split(`/`).some(e=>e===`.`||e===`..`),tf=e=>e.includes(`\\`),nf=e=>e.includes(`%`),rf=e=>{let t=il.safeParse(e);if(!t.success)throw y(`not a supported git url: derived key '${W(e)}' is invalid`);return t.data},af=({host:e,port:t,protocol:n})=>{let r=$d[n];return t===``||t===r?e.toLowerCase():`${e.toLowerCase()}_${t}`},of=e=>{let t=Yd(Xd(e.path));return rf(`${af(e)}/${t}`)},sf=e=>{let t=decodeURIComponent(e).split(`/`).filter(e=>e!==``);if(t.length<2)throw y(`not a supported git url: file url path must have at least 2 segments`);let n=t.at(-2)??``,r=t.at(-1)??``;return rf(`local/${n}/${r}`)},cf=(e,t)=>{try{return new URL(e)}catch{throw y(`not a supported git url: ${W(t)}`)}},lf=e=>{if(e.password!==``)throw y(`not a supported git url: credentials embedded in url`);if(e.protocol===`https:`&&e.username!==``)throw y(`not a supported git url: credentials embedded in https url`)},uf=(e,t)=>{if(e.protocol===`file:`){if(!t)throw y(`not a supported git url: unsupported protocol ${e.protocol}`);return sf(e.pathname)}if(e.protocol!==`https:`&&e.protocol!==`ssh:`)throw y(`not a supported git url: unsupported protocol ${e.protocol}`);return lf(e),of({host:e.hostname,path:e.pathname,port:e.port,protocol:e.protocol})},df=(e,t)=>{if(nf(e))throw y(`not a supported git url: percent-encoding not supported in ${W(t)}`);if(e.includes(`:`))throw y(`not a supported git url: ambiguous ':' in scp-style path ${W(t)}; use the ssh:// url form instead`);if(e.startsWith(`/`)||e.startsWith(`~`))throw y(`not a supported git url: ambiguous absolute/home-relative scp path in ${W(t)}; use the ssh:// url form instead`)},ff=(e,t)=>{let n=e.groups?.path??``;return df(n,t),of({host:e.groups?.host??``,path:n,port:``,protocol:`ssh:`})},pf=(e,t)=>{if(tf(e))throw y(`not a supported git url: backslash not allowed in ${W(t)}`)},mf=(e,t)=>{if(ef(e))throw y(`not a supported git url: path traversal segment in ${W(t)}`)},hf=(e,t,n)=>{if(e.protocol!==`file:`&&nf(t))throw y(`not a supported git url: percent-encoding not supported in ${W(n)}`)},gf=(e,t)=>{let n=t?.allowFileUrls??!1,r=e.replace(Qd,``);pf(r,e),mf(r,e);let i=Zd.exec(r);if(i?.groups!==void 0)return{cloneUrl:r,key:ff(i,e)};let a=cf(r,e);return hf(a,r,e),{cloneUrl:r,key:uf(a,n)}},_f=`.git`,vf=e=>e.endsWith(_f)?e:`${e}${_f}`,yf=(e,t)=>`https://${e.toLowerCase()}/${Xd(t)}`,bf=(e,t)=>`git@${e.toLowerCase()}:${vf(Xd(t))}`,xf=e=>{if(e===`https:`)return`https`;if(e===`ssh:`)return`ssh`;throw y(`not a supported git url: unsupported protocol ${e}`)},Sf=(e,t,n)=>{let r=$d[e.protocol];if(e.port!==``&&e.port!==r)throw y(`cannot apply git_transport=${t} to ${W(n)}: its non-default port ${e.port} cannot be expressed in the ${t} url form — add the repo with an explicit url instead`)},Cf=(e,t)=>t===`https`?yf(e.hostname,e.pathname):bf(e.hostname,e.pathname),wf=(e,t,n)=>{let r=gf(t).key;if(r!==n)throw y(`git_transport transform changed repo identity: '${W(e)}' → '${t}' (key '${n}' → '${r}')`);return t},Tf=(e,t)=>{if(t.transport===`ssh`)return t.cloneUrl;let n=e.groups?.host??``,r=e.groups?.path??``;return wf(t.cloneUrl,yf(n,r),t.originalKey)},Ef=e=>{let t=cf(e.cloneUrl,e.cloneUrl);return xf(t.protocol)===e.transport?e.cloneUrl:(Sf(t,e.transport,e.cloneUrl),wf(e.cloneUrl,Cf(t,e.transport),e.originalKey))},Df=(e,t)=>{if(e.startsWith(`file:`))return e;let n={cloneUrl:e,originalKey:gf(e).key,transport:t},r=Zd.exec(e);return r?.groups===void 0?Ef(n):Tf(r,n)},Of=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/u,kf=(e,t)=>{if(Of.test(t))return m(e,`lease-${t}`)},Af=async(e,t)=>{let n=kf(e,t);n!==void 0&&await(await o(n,`w`)).close()},jf=async(e,t)=>{let n=kf(e,t);if(n===void 0)return`gone`;let r=new Date;try{await ee(n,r,r)}catch(e){if(R(e))return`gone`;throw e}return`renewed`},Mf=async(e,t)=>{let n=kf(e,t);if(n===void 0)return{state:`absent`};try{return{mtimeMs:(await p(n)).mtimeMs,state:`ok`}}catch(e){return{state:R(e)?`absent`:`unreadable`}}},Nf=`meta.json`,Pf=e=>{if(typeof e==`object`&&e&&`code`in e){let{code:t}=e;if(typeof t==`string`)return t}},Ff=e=>{try{return process.kill(e,0),!0}catch(e){return Pf(e)!==`ESRCH`}},If=e=>{try{return JSON.parse(e)}catch{return}},Lf=async e=>{try{return await s(e,`utf8`)}catch{return}},Rf=new Set([`ENOENT`,`ENOTDIR`]),zf=async e=>{try{return{state:`read`,text:await s(e,`utf8`)}}catch(e){let t=Pf(e);return{state:t!==void 0&&Rf.has(t)?`missing`:`unreadable`}}},Bf=e=>{if(typeof e!=`string`)return;let t=Date.parse(e);if(!Number.isNaN(t))return t},Vf=e=>{if(typeof e!=`object`||!e)return;let{token:t}=e;if(typeof t==`string`)return t},Hf=e=>{if(!(typeof e!=`number`||!Number.isSafeInteger(e)||e<=0||e>2147483647))return e},Uf=e=>{if(typeof e!=`object`||!e)return;let t=e,n=Hf(t.pid),r=Bf(t.acquired_at);if(n===void 0||r===void 0)return;let i=Vf(e);return{acquiredAtMs:r,pid:n,...i===void 0?{}:{token:i}}},Wf=async e=>{let t=await Lf(m(e,Nf));if(t!==void 0)return Vf(If(t))},Gf=async e=>{let t=await zf(m(e,Nf));if(t.state!==`read`)return{state:t.state};let n=Uf(If(t.text));return n===void 0?{state:`malformed`}:{meta:n,state:`valid`}},Kf=async e=>{try{return{mtimeMs:(await p(e)).mtimeMs,state:`ok`}}catch(e){return{state:Pf(e)===`ENOENT`?`gone`:`unreadable`}}},qf=async(e,t)=>{let n=m(e,Nf),r=`${n}.tmp-${de()}`;await te(r,t,`utf8`),await u(r,n)},Jf=()=>de(),Yf=async(e,t)=>{await Af(e,t),await qf(e,JSON.stringify({acquired_at:new Date().toISOString(),pid:process.pid,token:t}))},Xf=5e3,Zf=async(e,t,n)=>{if(t===`unreadable`)return{meta:t,observedAtMs:n,pidState:`unknown`,policy:`unknown`,stale:!1};let r=await Kf(e);if(r.state===`gone`)return{meta:t,observedAtMs:n,pidState:`unknown`,policy:`none`,stale:!1};if(r.state===`unreadable`)return{meta:t,observedAtMs:n,pidState:`unknown`,policy:`unknown`,stale:!1};let i=n-r.mtimeMs;return{ageMs:i,budgetMs:Xf,meta:t,observedAtMs:n,pidState:`unknown`,policy:`grace`,stale:i>Xf}},Qf=async(e,t,n)=>{let r=t.token===void 0?{state:`absent`}:await Mf(e,t.token);return r.state===`unreadable`?{policy:`unknown`}:r.state===`absent`?{ageMs:n-t.acquiredAtMs,budgetMs:6e5,policy:`legacy`}:{ageMs:n-r.mtimeMs,budgetMs:12e4,policy:`lease`}},$f=async(e,t)=>{let n=await Gf(e);if(n.state!==`valid`)return Zf(e,n.state,t);let{meta:r}=n,i=await Qf(e,r,t),a=!Ff(r.pid),o=i.ageMs!==void 0&&i.budgetMs!==void 0&&i.ageMs>i.budgetMs;return{...i,meta:`valid`,observedAtMs:t,pid:r.pid,pidState:a?`definitely-dead`:`present-or-unknown`,stale:a||o,...r.token===void 0?{}:{token:r.token}}},ep=e=>e.meta===`valid`&&e.pidState===`definitely-dead`&&e.token!==void 0,tp=async(e,t)=>await Wf(e)===t?await jf(e,t)===`gone`?`lost`:`renewed`:`lost`,np=new Set([`EEXIST`,`EPERM`,`EACCES`,`EBUSY`]),rp=new Set([`ENOENT`,`EPERM`,`EACCES`,`EBUSY`]),ip=async e=>{try{return await a(e,{recursive:!1}),!0}catch(e){let t=Pf(e);if(t!==void 0&&np.has(t))return!1;throw e}},ap=async(e,t)=>{try{return await u(e,t),!0}catch(e){let t=Pf(e);if(t!==void 0&&rp.has(t))return!1;throw e}},op=`.claims`,sp=`.tombstones`,cp=(e,t)=>({lockPath:m(e,t),locksDir:e,name:t}),lp=e=>m(e.locksDir,op,e.name),up=e=>m(e.locksDir,sp,de()),dp=async e=>{await a(m(e,op),{recursive:!0}),await a(m(e,sp),{recursive:!0})},fp=e=>ip(e),pp=async e=>{try{await f(e)}catch{}},mp=async e=>{let t=up(e);return await ap(e.lockPath,t)?t:void 0},hp=async e=>{let t=await $f(e.lockPath,Date.now());if(!ep(t)||await Wf(e.lockPath)!==t.token)return!1;let n=await mp(e);return n!==void 0&&(await d(n,{force:!0,recursive:!0}),!0)},gp=async e=>{await dp(e.locksDir);let t=lp(e);if(!await fp(t))return!1;let n=await hp(e).then(e=>({ok:!0,stolen:e}),e=>({error:e,ok:!1}));if(await pp(t),!n.ok)throw n.error;return n.stolen},_p=async e=>{try{return(await c(e,{withFileTypes:!0})).map(e=>({isDir:e.isDirectory(),name:e.name})).toSorted((e,t)=>e.name.localeCompare(t.name))}catch(e){if(R(e))return[];throw e}},vp=async e=>(await _p(e)).filter(e=>!e.name.startsWith(`.`)),yp=async(e,t,n)=>{let r=await $f(m(e,t.name),n);if(r.policy!==`none`)return{diagnosis:r,isDirectory:t.isDir,kind:`lock`,name:t.name}},bp=async(e,t)=>{let n=m(e,op),r=await _p(n);return(await Promise.all(r.map(async e=>({diagnosis:await $f(m(n,e.name),t),isDirectory:e.isDir,kind:`claim`,name:e.name})))).filter(e=>e.diagnosis.policy!==`none`)},xp=async e=>{let t=Date.now(),n=await vp(e.locksDir),[r,i]=await Promise.all([Promise.all(n.map(n=>yp(e.locksDir,n,t))),bp(e.locksDir,t)]);return[...r.filter(e=>e!==void 0),...i]},Sp=e=>{let t=Math.floor(e/1e3),n=t%60,r=Math.floor(t/60),i=r%60,a=Math.floor(r/60);return a>0?i===0?`${a}h`:`${a}h ${i}m`:r>0?n===0?`${r}m`:`${r}m ${n}s`:`${n}s`},Cp=e=>e.pid===void 0?`owner unknown (metadata ${e.meta})`:e.pidState===`definitely-dead`?`recorded pid ${e.pid} is not running`:`recorded pid ${e.pid} is present (identity not verified)`,wp={grace:`created`,lease:`lease renewed`,legacy:`acquired`,none:`observed`,unknown:`observed`},Tp={grace:`from creation, while its metadata has not been published`,lease:`from the last renewal`,legacy:`from acquisition (no renewable lease)`,none:``,unknown:``},Ep=e=>{let{ageMs:t,budgetMs:n,policy:r}=e;return t===void 0||n===void 0?``:t<0?`, but its recorded time is in the future — check the system clock`:`, ${wp[r]} ${Sp(t)} ago; its window is ${Sp(n)} ${Tp[r]}`},Dp=(e,t)=>{if(t.policy===`none`)return`lock ${e} could not be acquired before the timeout, but it was released while the failure was being diagnosed. Retry the operation.`;let n=`lock ${e} is held: ${Cp(t)}`;return ep(t)?`${n}, and refs is entitled to reclaim it — it could not do so before the timeout. Retry; if it persists, run refs doctor.`:t.stale?`${n}${Ep(t)}. refs does not reclaim this automatically: only a recorded process the operating system reports as gone is reclaimed, and this one is not. Run refs doctor for what to do about it.`:`${n}${Ep(t)}. Retry once the other refs command finishes.`},Op=(e,t)=>{if(t.stopped)return;let n=setTimeout(()=>{t.stopped||(t.inFlight=kp(e,t))},e.intervalMs);n.unref(),t.timer=n},kp=async(e,t)=>{try{if(await e.renew()===`lost`){t.lost=!0,t.stopped=!0;return}}catch{}Op(e,t)},Ap=e=>{let t={inFlight:Promise.resolve(),lost:!1,stopped:!1};return Op(e,t),{ownershipLost:()=>t.lost,stop:async()=>{t.stopped=!0,t.timer!==void 0&&clearTimeout(t.timer),await t.inFlight}}},jp=/^[a-zA-Z0-9][a-zA-Z0-9_.-]*$/u,Mp=async(e,t)=>{try{await Yf(e,t)}catch(e){if(Pf(e)===`ENOENT`)return`retry`;throw e}return t},Np=async(e,t)=>{if(!await ip(e))return;let n=await Mp(e,Jf());return n===`retry`?Date.now()>=t?void 0:Np(e,t):n},Pp=async(e,t)=>{if(!await gp(e)){if(Date.now()>=t){let t=await $f(e.lockPath,Date.now());throw Ce(Dp(e.name,t))}await ge(100)}},Fp=async(e,t)=>{let n=await Np(e.lockPath,t);return n===void 0?(await Pp(e,t),Fp(e,t)):n},Ip=async(e,t)=>await Wf(e)===t&&(await d(e,{force:!0,recursive:!0}),!0),Lp=async e=>{try{return{ok:!0,value:await e()}}catch(e){return{error:e,ok:!1}}},Rp=async(e,t,n,r)=>{await n.stop();let i=await Lp(()=>Ip(e.lockPath,t));if(!r.ok)throw r.error;if(!i.ok)throw i.error;if(n.ownershipLost()||!i.value)throw Ce(`lock ${e.name} was lost while the operation was running`);return r.value},zp=e=>e!==`.`&&e!==`..`&&jp.test(e),Bp=e=>{if(!zp(e))throw y(`lock name must not contain "/" or other unsafe characters — only letters, digits, and "_.-" are allowed, and it may not be "." or "..": ${e}`)},G=async(e,t,n,r)=>{Bp(t);let i=cp(e.locksDir,t);await a(e.locksDir,{recursive:!0});let o=Date.now()+(r?.timeoutMs??1e4),s=await Fp(i,o),c=Ap({intervalMs:3e4,renew:()=>tp(i.lockPath,s)});return Rp(i,s,c,await Lp(n))},Vp=sc({directory:P().optional(),url:P().optional()}),Hp=sc({repository:lc([P(),Vp]).optional()}),Up=/^(?:@[a-z0-9-~][a-z0-9._~-]*\/)?[a-z0-9-~][a-z0-9._~-]*$/u,Wp=new Set([`node_modules`,`favicon.ico`]),Gp=e=>_(`package '${e}' has no usable repository field — find the repository and run: refs add <git-url>`),Kp=e=>{let[t,n]=e.split(`/`);return n??t??e},qp=e=>{if(e.length>214)throw v(`invalid package name: '${e}' exceeds maximum length of 214 characters`);if(!Up.test(e))throw v(`invalid package name: '${e}' does not match npm naming rules`);let t=Kp(e);if(Wp.has(t))throw v(`invalid package name: '${e}' uses a reserved name`)},Jp=e=>e.replaceAll(`/`,`%2F`),Yp=e=>typeof e==`string`?e:e?.url,Xp=e=>{if(typeof e==`object`&&e?.directory){let t=ul.safeParse(e.directory);if(t.success)return t.data}},Zp=async(e,t)=>{try{return await e.json()}catch{throw y(`invalid npm registry response for '${t}': not parseable JSON`)}},Qp=async(e,t)=>{let n=await e(`https://registry.npmjs.org/${Jp(t)}`);if(n.status===404)throw _(`npm package '${t}' not found`);if(n.status!==200)throw y(`failed to fetch npm package '${t}': status ${n.status}`);let r=await Zp(n,t),i=Hp.safeParse(r);if(!i.success)throw y(`invalid npm package response for '${t}'`);return i.data},$p=(e,t)=>{try{return gf(e)}catch{throw Gp(t)}},em=async(e,t)=>{qp(t);let n=await Qp(e,t),r=Yp(n.repository);if(r===void 0||r===``)throw Gp(t);let{cloneUrl:i,key:a}=$p(r,t),o=Xp(n.repository);return o===void 0?{cloneUrl:i,key:a}:{cloneUrl:i,directory:o,key:a}},tm=(e,t,n)=>{let r=e instanceof RegExp?nm(e,n):e,i=t instanceof RegExp?nm(t,n):t,a=r!==null&&i!=null&&rm(r,i,n);return a&&{start:a[0],end:a[1],pre:n.slice(0,a[0]),body:n.slice(a[0]+r.length,a[1]),post:n.slice(a[1]+i.length)}},nm=(e,t)=>{let n=t.match(e);return n?n[0]:null},rm=(e,t,n)=>{let r,i,a,o,s,c=n.indexOf(e),l=n.indexOf(t,c+1),u=c;if(c>=0&&l>0){if(e===t)return[c,l];for(r=[],a=n.length;u>=0&&!s;){if(u===c)r.push(u),c=n.indexOf(e,u+1);else if(r.length===1){let e=r.pop();e!==void 0&&(s=[e,l])}else i=r.pop(),i!==void 0&&i<a&&(a=i,o=l),l=n.indexOf(t,u+1);u=c<l&&c>=0?c:l}r.length&&o!==void 0&&(s=[a,o])}return s},im=`\0SLASH`+Math.random()+`\0`,am=`\0OPEN`+Math.random()+`\0`,om=`\0CLOSE`+Math.random()+`\0`,sm=`\0COMMA`+Math.random()+`\0`,cm=`\0PERIOD`+Math.random()+`\0`,lm=new RegExp(im,`g`),um=new RegExp(am,`g`),dm=new RegExp(om,`g`),fm=new RegExp(sm,`g`),pm=new RegExp(cm,`g`),mm=/\\\\/g,hm=/\\{/g,gm=/\\}/g,_m=/\\,/g,vm=/\\\./g;function ym(e){return isNaN(e)?e.charCodeAt(0):parseInt(e,10)}function bm(e){return e.replace(mm,im).replace(hm,am).replace(gm,om).replace(_m,sm).replace(vm,cm)}function xm(e){return e.replace(lm,`\\`).replace(um,`{`).replace(dm,`}`).replace(fm,`,`).replace(pm,`.`)}function Sm(e){if(!e)return[``];let t=[],n=tm(`{`,`}`,e);if(!n)return e.split(`,`);let{pre:r,body:i,post:a}=n,o=r.split(`,`);o[o.length-1]+=`{`+i+`}`;let s=Sm(a);return a.length&&(o[o.length-1]+=s.shift(),o.push.apply(o,s)),t.push.apply(t,o),t}function Cm(e,t={}){if(!e)return[];let{max:n=1e5,maxLength:r=4e6}=t;return e.slice(0,2)===`{}`&&(e=`\\{\\}`+e.slice(2)),Am(bm(e),n,r,!0).map(xm)}function wm(e){return`{`+e+`}`}function Tm(e){return/^-?0\d/.test(e)}function Em(e,t){return e<=t}function Dm(e,t){return e>=t}function Om(e,t,n,r,i,a){let o=[],s=0;for(let c=0;c<e.length;c++)for(let l=0;l<n.length;l++){if(o.length>=r)return o;let u=e[c]+t+n[l];if(!a||u){if(s+u.length>i)return o;o.push(u),s+=u.length}}return o}function km(e,t,n,r){let i=e.split(/\.\./),a=[];if(i[0]===void 0||i[1]===void 0)return a;let o=ym(i[0]),s=ym(i[1]),c=Math.max(i[0].length,i[1].length),l=i.length===3&&i[2]!==void 0?Math.max(Math.abs(ym(i[2])),1):1,u=Em;s<o&&(l*=-1,u=Dm);let d=i.some(Tm),f=0;for(let e=o;u(e,s)&&a.length<n;e+=l){let n;if(t)n=String.fromCharCode(e),n===`\\`&&(n=``);else if(n=String(e),d){let t=c-n.length;if(t>0){let r=Array(t+1).join(`0`);n=e<0?`-`+r+n.slice(1):r+n}}if(f+n.length>r)break;a.push(n),f+=n.length}return a}function Am(e,t,n,r){let i=[``],a=!1,o=!0;for(;;){let s=tm(`{`,`}`,e);if(!s)return Om(i,e,[``],t,n,a);let c=s.pre;if(/\$$/.test(c)){if(i=Om(i,c+`{`+s.body+`}`,[``],t,n,a&&!s.post.length),o=!1,!s.post.length)break;e=s.post;continue}let l=/^-?\d+\.\.-?\d+(?:\.\.-?\d+)?$/.test(s.body),u=/^[a-zA-Z]\.\.[a-zA-Z](?:\.\.-?\d+)?$/.test(s.body),d=l||u,f=s.body.indexOf(`,`)>=0;if(!d&&!f){if(s.post.match(/,(?!,).*\}/)){e=s.pre+`{`+s.body+om+s.post,r=!0;continue}return Om(i,c+`{`+s.body+`}`+s.post,[``],t,n,a)}o&&=(a=r&&!d,!1);let p;if(d)p=km(s.body,u,t,n);else{let r=Sm(s.body);if(r.length===1&&r[0]!==void 0&&(r=Am(r[0],t,n,!1).map(wm),r.length===1)){if(i=Om(i,c+r[0],[``],t,n,a&&!s.post.length),!s.post.length)break;e=s.post;continue}let o=a&&!s.post.length&&!c;for(let e=0;o&&e<i.length;e++)i[e]&&(o=!1);p=[];let l=0;outer:for(let e=0;e<r.length;e++){let i=Am(r[e],t,n,!1);for(let e=0;e<i.length;e++){let r=i[e];if(!o||r){if(p.length>=t||l+r.length>n)break outer;p.push(r),l+=r.length}}}}if(i=Om(i,c,p,t,n,a&&!s.post.length),!s.post.length)break;e=s.post}return i}const jm=e=>{if(typeof e!=`string`)throw TypeError(`invalid pattern`);if(e.length>65536)throw TypeError(`pattern is too long`)},Mm={"[:alnum:]":[`\\p{L}\\p{Nl}\\p{Nd}`,!0],"[:alpha:]":[`\\p{L}\\p{Nl}`,!0],"[:ascii:]":[`\\x00-\\x7f`,!1],"[:blank:]":[`\\p{Zs}\\t`,!0],"[:cntrl:]":[`\\p{Cc}`,!0],"[:digit:]":[`\\p{Nd}`,!0],"[:graph:]":[`\\p{Z}\\p{C}`,!0,!0],"[:lower:]":[`\\p{Ll}`,!0],"[:print:]":[`\\p{C}`,!0],"[:punct:]":[`\\p{P}`,!0],"[:space:]":[`\\p{Z}\\t\\r\\n\\v\\f`,!0],"[:upper:]":[`\\p{Lu}`,!0],"[:word:]":[`\\p{L}\\p{Nl}\\p{Nd}\\p{Pc}`,!0],"[:xdigit:]":[`A-Fa-f0-9`,!1]},Nm=e=>e.replace(/[[\]\\-]/g,`\\$&`),Pm=e=>e.replace(/[-[\]{}()*+?.,\\^$|#\s]/g,`\\$&`),Fm=e=>e.join(``),Im=(e,t)=>{let n=t;if(e.charAt(n)!==`[`)throw Error(`not in a brace expression`);let r=[],i=[],a=n+1,o=!1,s=!1,c=!1,l=!1,u=n,d=``;WHILE:for(;a<e.length;){let t=e.charAt(a);if((t===`!`||t===`^`)&&a===n+1){l=!0,a++;continue}if(t===`]`&&o&&!c){u=a+1;break}if(o=!0,t===`\\`&&!c){c=!0,a++;continue}if(t===`[`&&!c){for(let[t,[o,c,l]]of Object.entries(Mm))if(e.startsWith(t,a)){if(d)return[`$.`,!1,e.length-n,!0];a+=t.length,l?i.push(o):r.push(o),s||=c;continue WHILE}}if(c=!1,d){t>d?r.push(Nm(d)+`-`+Nm(t)):t===d&&r.push(Nm(t)),d=``,a++;continue}if(e.startsWith(`-]`,a+1)){r.push(Nm(t+`-`)),a+=2;continue}if(e.startsWith(`-`,a+1)){d=t,a+=2;continue}r.push(Nm(t)),a++}if(u<a)return[``,!1,0,!1];if(!r.length&&!i.length)return[`$.`,!1,e.length-n,!0];if(i.length===0&&r.length===1&&/^\\?.$/.test(r[0])&&!l){let e=r[0].length===2?r[0].slice(-1):r[0];return[Pm(e),!1,u-n,!1]}let f=`[`+(l?`^`:``)+Fm(r)+`]`,p=`[`+(l?``:`^`)+Fm(i)+`]`;return[r.length&&i.length?`(`+f+`|`+p+`)`:r.length?f:p,s,u-n,!0]},Lm=(e,{windowsPathsNoEscape:t=!1,magicalBraces:n=!0}={})=>n?t?e.replace(/\[([^/\\])\]/g,`$1`):e.replace(/((?!\\).|^)\[([^/\\])\]/g,`$1$2`).replace(/\\([^/])/g,`$1`):t?e.replace(/\[([^/\\{}])\]/g,`$1`):e.replace(/((?!\\).|^)\[([^/\\{}])\]/g,`$1$2`).replace(/\\([^/{}])/g,`$1`);var K;const Rm=new Set([`!`,`?`,`+`,`*`,`@`]),zm=e=>Rm.has(e),Bm=e=>zm(e.type),Vm=new Map([[`!`,[`@`]],[`?`,[`?`,`@`]],[`@`,[`@`]],[`*`,[`*`,`+`,`?`,`@`]],[`+`,[`+`,`@`]]]),Hm=new Map([[`!`,[`?`]],[`@`,[`?`]],[`+`,[`?`,`*`]]]),Um=new Map([[`!`,[`?`,`@`]],[`?`,[`?`,`@`]],[`@`,[`?`,`@`]],[`*`,[`*`,`+`,`?`,`@`]],[`+`,[`+`,`@`,`?`,`*`]]]),Wm=new Map([[`!`,new Map([[`!`,`@`]])],[`?`,new Map([[`*`,`*`],[`+`,`*`]])],[`@`,new Map([[`!`,`!`],[`?`,`?`],[`@`,`@`],[`*`,`*`],[`+`,`+`]])],[`+`,new Map([[`?`,`*`],[`*`,`*`]])]]),Gm=`(?!\\.)`,Km=new Set([`[`,`.`]),qm=new Set([`..`,`.`]),Jm=new Set(`().*{}+?[]^$\\!`),Ym=e=>e.replace(/[-[\]{}()*+?.,\\^$|#\s]/g,`\\$&`),Xm=`[^/]+?`;let Zm=0;var Qm=class{type;#e;#t;#n=!1;#r=[];#i;#a;#o;#s=!1;#c;#l;#u=!1;id=++Zm;get depth(){return(this.#i?.depth??-1)+1}[Symbol.for(`nodejs.util.inspect.custom`)](){return{"@@type":`AST`,id:this.id,type:this.type,root:this.#e.id,parent:this.#i?.id,depth:this.depth,partsLength:this.#r.length,parts:this.#r}}constructor(e,t,n={}){this.type=e,e&&(this.#t=!0),this.#i=t,this.#e=this.#i?this.#i.#e:this,this.#c=this.#e===this?n:this.#e.#c,this.#o=this.#e===this?[]:this.#e.#o,e===`!`&&!this.#e.#s&&this.#o.push(this),this.#a=this.#i?this.#i.#r.length:0}get hasMagic(){if(this.#t!==void 0)return this.#t;for(let e of this.#r)if(typeof e!=`string`&&(e.type||e.hasMagic))return this.#t=!0;return this.#t}toString(){return this.#l===void 0?this.#l=this.type?this.type+`(`+this.#r.map(e=>String(e)).join(`|`)+`)`:this.#r.map(e=>String(e)).join(``):this.#l}#d(){if(this!==this.#e)throw Error(`should only call on root`);if(this.#s)return this;this.toString(),this.#s=!0;let e;for(;e=this.#o.pop();){if(e.type!==`!`)continue;let t=e,n=t.#i;for(;n;){for(let r=t.#a+1;!n.type&&r<n.#r.length;r++)for(let t of e.#r){if(typeof t==`string`)throw Error(`string part in extglob AST??`);t.copyIn(n.#r[r])}t=n,n=t.#i}}return this}push(...e){for(let t of e)if(t!==``){if(typeof t!=`string`&&!(t instanceof K&&t.#i===this))throw Error(`invalid part: `+t);this.#r.push(t)}}toJSON(){let e=this.type===null?this.#r.slice().map(e=>typeof e==`string`?e:e.toJSON()):[this.type,...this.#r.map(e=>e.toJSON())];return this.isStart()&&!this.type&&e.unshift([]),this.isEnd()&&(this===this.#e||this.#e.#s&&this.#i?.type===`!`)&&e.push({}),e}isStart(){if(this.#e===this)return!0;if(!this.#i?.isStart())return!1;if(this.#a===0)return!0;let e=this.#i;for(let t=0;t<this.#a;t++){let n=e.#r[t];if(!(n instanceof K&&n.type===`!`))return!1}return!0}isEnd(){if(this.#e===this||this.#i?.type===`!`)return!0;if(!this.#i?.isEnd())return!1;if(!this.type)return this.#i?.isEnd();let e=this.#i?this.#i.#r.length:0;return this.#a===e-1}copyIn(e){typeof e==`string`?this.push(e):this.push(e.clone(this))}clone(e){let t=new K(this.type,e);for(let e of this.#r)t.copyIn(e);return t}static#f(e,t,n,r,i){let a=r.maxExtglobRecursion??2,o=!1,s=!1,c=-1,l=!1;if(t.type===null){let u=n,d=``;for(;u<e.length;){let n=e.charAt(u++);if(o||n===`\\`){o=!o,d+=n;continue}if(s){u===c+1?(n===`^`||n===`!`)&&(l=!0):n===`]`&&!(u===c+2&&l)&&(s=!1),d+=n;continue}if(n===`[`){s=!0,c=u,l=!1,d+=n;continue}if(!r.noext&&zm(n)&&e.charAt(u)===`(`&&i<=a){t.push(d),d=``;let a=new K(n,t);u=K.#f(e,a,u,r,i+1),t.push(a);continue}d+=n}return t.push(d),u}let u=n+1,d=new K(null,t),f=[],p=``;for(;u<e.length;){let n=e.charAt(u++);if(o||n===`\\`){o=!o,p+=n;continue}if(s){u===c+1?(n===`^`||n===`!`)&&(l=!0):n===`]`&&!(u===c+2&&l)&&(s=!1),p+=n;continue}if(n===`[`){s=!0,c=u,l=!1,p+=n;continue}if(!r.noext&&zm(n)&&e.charAt(u)===`(`&&(i<=a||t&&t.#h(n))){let a=t&&t.#h(n)?0:1;d.push(p),p=``;let o=new K(n,d);d.push(o),u=K.#f(e,o,u,r,i+a);continue}if(n===`|`){d.push(p),p=``,f.push(d),d=new K(null,t);continue}if(n===`)`)return p===``&&t.#r.length===0&&(t.#u=!0),d.push(p),p=``,t.push(...f,d),u;p+=n}return t.type=null,t.#t=void 0,t.#r=[e.substring(n-1)],u}#p(e){return this.#m(e,Hm)}#m(e,t=Vm){if(!e||typeof e!=`object`||e.type!==null||e.#r.length!==1||this.type===null)return!1;let n=e.#r[0];return!n||typeof n!=`object`||n.type===null?!1:this.#h(n.type,t)}#h(e,t=Um){return!!t.get(this.type)?.includes(e)}#g(e,t){let n=e.#r[0],r=new K(null,n,this.options);r.#r.push(``),n.push(r),this.#_(e,t)}#_(e,t){let n=e.#r[0];this.#r.splice(t,1,...n.#r);for(let e of n.#r)typeof e==`object`&&(e.#i=this);this.#l=void 0}#v(e){return!!Wm.get(this.type)?.has(e)}#y(e){if(!e||typeof e!=`object`||e.type!==null||e.#r.length!==1||this.type===null||this.#r.length!==1)return!1;let t=e.#r[0];return!t||typeof t!=`object`||t.type===null?!1:this.#v(t.type)}#b(e){let t=Wm.get(this.type),n=e.#r[0],r=t?.get(n.type);if(!r)return!1;this.#r=n.#r;for(let e of this.#r)typeof e==`object`&&(e.#i=this);this.type=r,this.#l=void 0,this.#u=!1}static fromGlob(e,t={}){let n=new K(null,void 0,t);return K.#f(e,n,0,t,0),n}toMMPattern(){if(this!==this.#e)return this.#e.toMMPattern();let e=this.toString(),[t,n,r,i]=this.toRegExpSource();if(!(r||this.#t||this.#c.nocase&&!this.#c.nocaseMagicOnly&&e.toUpperCase()!==e.toLowerCase()))return n;let a=(this.#c.nocase?`i`:``)+(i?`u`:``);return Object.assign(RegExp(`^${t}$`,a),{_src:t,_glob:e})}get options(){return this.#c}toRegExpSource(e){let t=e??!!this.#c.dot;if(this.#e===this&&(this.#x(),this.#d()),!Bm(this)){let n=this.isStart()&&this.isEnd()&&!this.#r.some(e=>typeof e!=`string`),r=this.#r.map(t=>{let[r,i,a,o]=typeof t==`string`?K.#C(t,this.#t,n):t.toRegExpSource(e);return this.#t=this.#t||a,this.#n=this.#n||o,r}).join(``),i=``;if(this.isStart()&&typeof this.#r[0]==`string`&&!(this.#r.length===1&&qm.has(this.#r[0]))){let n=Km,a=t&&n.has(r.charAt(0))||r.startsWith(`\\.`)&&n.has(r.charAt(2))||r.startsWith(`\\.\\.`)&&n.has(r.charAt(4)),o=!t&&!e&&n.has(r.charAt(0));i=a?`(?!(?:^|/)\\.\\.?(?:$|/))`:o?Gm:``}let a=``;return this.isEnd()&&this.#e.#s&&this.#i?.type===`!`&&(a=`(?:$|\\/)`),[i+r+a,Lm(r),this.#t=!!this.#t,this.#n]}let n=this.type===`*`||this.type===`+`,r=this.type===`!`?`(?:(?!(?:`:`(?:`,i=this.#S(t);if(this.isStart()&&this.isEnd()&&!i&&this.type!==`!`){let e=this.toString(),t=this;return t.#r=[e],t.type=null,t.#t=void 0,[e,Lm(this.toString()),!1,!1]}let a=!n||e||t?``:this.#S(!0);a===i&&(a=``),a&&(i=`(?:${i})(?:${a})*?`);let o=``;if(this.type===`!`&&this.#u)o=(this.isStart()&&!t?Gm:``)+Xm;else{let n=this.type===`!`?`))`+(this.isStart()&&!t&&!e?Gm:``)+`[^/]*?)`:this.type===`@`?`)`:this.type===`?`?`)?`:this.type===`+`&&a?`)`:this.type===`*`&&a?`)?`:`)${this.type}`;o=r+i+n}return[o,Lm(i),this.#t=!!this.#t,this.#n]}#x(){if(Bm(this)){let e=0,t=!1;do{t=!0;for(let e=0;e<this.#r.length;e++){let n=this.#r[e];typeof n==`object`&&(n.#x(),this.#m(n)?(t=!1,this.#_(n,e)):this.#p(n)?(t=!1,this.#g(n,e)):this.#y(n)&&(t=!1,this.#b(n)))}}while(!t&&++e<10)}else for(let e of this.#r)typeof e==`object`&&e.#x();this.#l=void 0}#S(e){return this.#r.map(t=>{if(typeof t==`string`)throw Error(`string type in extglob ast??`);let[n,r,i,a]=t.toRegExpSource(e);return this.#n=this.#n||a,n}).filter(e=>!(this.isStart()&&this.isEnd())||!!e).join(`|`)}static#C(e,t,n=!1){let r=!1,i=``,a=!1,o=!1;for(let s=0;s<e.length;s++){let c=e.charAt(s);if(r){r=!1,i+=(Jm.has(c)?`\\`:``)+c;continue}if(c===`*`){if(o)continue;o=!0,i+=n&&/^[*]+$/.test(e)?Xm:`[^/]*?`,t=!0;continue}if(o=!1,c===`\\`){s===e.length-1?i+=`\\\\`:r=!0;continue}if(c===`[`){let[n,r,o,c]=Im(e,s);if(o){i+=n,a||=r,s+=o-1,t||=c;continue}}if(c===`?`){i+=`[^/]`,t=!0;continue}i+=Ym(c)}return[i,Lm(e),!!t,a]}};K=Qm;const $m=(e,{windowsPathsNoEscape:t=!1,magicalBraces:n=!1}={})=>n?t?e.replace(/[?*()[\]{}]/g,`[$&]`):e.replace(/[?*()[\]\\{}]/g,`\\$&`):t?e.replace(/[?*()[\]]/g,`[$&]`):e.replace(/[?*()[\]\\]/g,`\\$&`),q=(e,t,n={})=>(jm(t),!n.nocomment&&t.charAt(0)===`#`?!1:new Th(t,n).match(e)),eh=/^\*+([^+@!?*[(]*)$/,th=e=>t=>!t.startsWith(`.`)&&t.endsWith(e),nh=e=>t=>t.endsWith(e),rh=e=>(e=e.toLowerCase(),t=>!t.startsWith(`.`)&&t.toLowerCase().endsWith(e)),ih=e=>(e=e.toLowerCase(),t=>t.toLowerCase().endsWith(e)),ah=/^\*+\.\*+$/,oh=e=>!e.startsWith(`.`)&&e.includes(`.`),sh=e=>e!==`.`&&e!==`..`&&e.includes(`.`),ch=/^\.\*+$/,lh=e=>e!==`.`&&e!==`..`&&e.startsWith(`.`),uh=/^\*+$/,dh=e=>e.length!==0&&!e.startsWith(`.`),fh=e=>e.length!==0&&e!==`.`&&e!==`..`,ph=/^\?+([^+@!?*[(]*)?$/,mh=([e,t=``])=>{let n=vh([e]);return t?(t=t.toLowerCase(),e=>n(e)&&e.toLowerCase().endsWith(t)):n},hh=([e,t=``])=>{let n=yh([e]);return t?(t=t.toLowerCase(),e=>n(e)&&e.toLowerCase().endsWith(t)):n},gh=([e,t=``])=>{let n=yh([e]);return t?e=>n(e)&&e.endsWith(t):n},_h=([e,t=``])=>{let n=vh([e]);return t?e=>n(e)&&e.endsWith(t):n},vh=([e])=>{let t=e.length;return e=>e.length===t&&!e.startsWith(`.`)},yh=([e])=>{let t=e.length;return e=>e.length===t&&e!==`.`&&e!==`..`},bh=typeof process==`object`&&process?typeof process.env==`object`&&process.env&&process.env.__MINIMATCH_TESTING_PLATFORM__||process.platform:`posix`,xh={win32:{sep:`\\`},posix:{sep:`/`}};q.sep=bh===`win32`?xh.win32.sep:xh.posix.sep;const J=Symbol(`globstar **`);q.GLOBSTAR=J,q.filter=(e,t={})=>n=>q(n,e,t);const Y=(e,t={})=>Object.assign({},e,t);q.defaults=e=>{if(!e||typeof e!=`object`||!Object.keys(e).length)return q;let t=q;return Object.assign((n,r,i={})=>t(n,r,Y(e,i)),{Minimatch:class extends t.Minimatch{constructor(t,n={}){super(t,Y(e,n))}static defaults(n){return t.defaults(Y(e,n)).Minimatch}},AST:class extends t.AST{constructor(t,n,r={}){super(t,n,Y(e,r))}static fromGlob(n,r={}){return t.AST.fromGlob(n,Y(e,r))}},unescape:(n,r={})=>t.unescape(n,Y(e,r)),escape:(n,r={})=>t.escape(n,Y(e,r)),filter:(n,r={})=>t.filter(n,Y(e,r)),defaults:n=>t.defaults(Y(e,n)),makeRe:(n,r={})=>t.makeRe(n,Y(e,r)),braceExpand:(n,r={})=>t.braceExpand(n,Y(e,r)),match:(n,r,i={})=>t.match(n,r,Y(e,i)),sep:t.sep,GLOBSTAR:J})};const Sh=(e,t={})=>(jm(e),t.nobrace||!/\{(?:(?!\{).)*\}/.test(e)?[e]:Cm(e,{max:t.braceExpandMax}));q.braceExpand=Sh,q.makeRe=(e,t={})=>new Th(e,t).makeRe(),q.match=(e,t,n={})=>{let r=new Th(t,n);return e=e.filter(e=>r.match(e)),r.options.nonull&&!e.length&&e.push(t),e};const Ch=/[?*]|[+@!]\(.*?\)|\[|\]/,wh=e=>e.replace(/[-[\]{}()*+?.,\\^$|#\s]/g,`\\$&`);var Th=class{options;set;pattern;windowsPathsNoEscape;nonegate;negate;comment;empty;preserveMultipleSlashes;partial;globSet;globParts;nocase;isWindows;platform;windowsNoMagicRoot;maxGlobstarRecursion;regexp;constructor(e,t={}){jm(e),t||={},this.options=t,this.maxGlobstarRecursion=t.maxGlobstarRecursion??200,this.pattern=e,this.platform=t.platform||bh,this.isWindows=this.platform===`win32`,this.windowsPathsNoEscape=!!t.windowsPathsNoEscape||t.allowWindowsEscape===!1,this.windowsPathsNoEscape&&(this.pattern=this.pattern.replace(/\\/g,`/`)),this.preserveMultipleSlashes=!!t.preserveMultipleSlashes,this.regexp=null,this.negate=!1,this.nonegate=!!t.nonegate,this.comment=!1,this.empty=!1,this.partial=!!t.partial,this.nocase=!!this.options.nocase,this.windowsNoMagicRoot=t.windowsNoMagicRoot===void 0?!!(this.isWindows&&this.nocase):t.windowsNoMagicRoot,this.globSet=[],this.globParts=[],this.set=[],this.make()}hasMagic(){if(this.options.magicalBraces&&this.set.length>1)return!0;for(let e of this.set)for(let t of e)if(typeof t!=`string`)return!0;return!1}debug(...e){}make(){let e=this.pattern,t=this.options;if(!t.nocomment&&e.charAt(0)===`#`){this.comment=!0;return}if(!e){this.empty=!0;return}this.parseNegate(),this.globSet=[...new Set(this.braceExpand())],t.debug&&(this.debug=(...e)=>console.error(...e)),this.debug(this.pattern,this.globSet);let n=this.globSet.map(e=>this.slashSplit(e));this.globParts=this.preprocess(n),this.debug(this.pattern,this.globParts);let r=this.globParts.map((e,t,n)=>{if(this.isWindows&&this.windowsNoMagicRoot){let t=e[0]===``&&e[1]===``&&(e[2]===`?`||!Ch.test(e[2]))&&!Ch.test(e[3]),n=/^[a-z]:/i.test(e[0]);if(t)return[...e.slice(0,4),...e.slice(4).map(e=>this.parse(e))];if(n)return[e[0],...e.slice(1).map(e=>this.parse(e))]}return e.map(e=>this.parse(e))});if(this.debug(this.pattern,r),this.set=r.filter(e=>e.indexOf(!1)===-1),this.isWindows)for(let e=0;e<this.set.length;e++){let t=this.set[e];t[0]===``&&t[1]===``&&this.globParts[e][2]===`?`&&typeof t[3]==`string`&&/^[a-z]:$/i.test(t[3])&&(t[2]=`?`)}this.debug(this.pattern,this.set)}preprocess(e){if(this.options.noglobstar)for(let t of e)for(let e=0;e<t.length;e++)t[e]===`**`&&(t[e]=`*`);let{optimizationLevel:t=1}=this.options;return t>=2?(e=this.firstPhasePreProcess(e),e=this.secondPhasePreProcess(e)):e=t>=1?this.levelOneOptimize(e):this.adjascentGlobstarOptimize(e),e}adjascentGlobstarOptimize(e){return e.map(e=>{let t=-1;for(;(t=e.indexOf(`**`,t+1))!==-1;){let n=t;for(;e[n+1]===`**`;)n++;n!==t&&e.splice(t,n-t)}return e})}levelOneOptimize(e){return e.map(e=>(e=e.reduce((e,t)=>{let n=e[e.length-1];return t===`**`&&n===`**`?e:t===`..`&&n&&n!==`..`&&n!==`.`&&n!==`**`?(e.pop(),e):(e.push(t),e)},[]),e.length===0?[``]:e))}levelTwoFileOptimize(e){Array.isArray(e)||(e=this.slashSplit(e));let t=!1;do{if(t=!1,!this.preserveMultipleSlashes){for(let n=1;n<e.length-1;n++){let r=e[n];(n!==1||r!==``||e[0]!==``)&&(r===`.`||r===``)&&(t=!0,e.splice(n,1),n--)}e[0]===`.`&&e.length===2&&(e[1]===`.`||e[1]===``)&&(t=!0,e.pop())}let n=0;for(;(n=e.indexOf(`..`,n+1))!==-1;){let r=e[n-1];r&&r!==`.`&&r!==`..`&&r!==`**`&&!(this.isWindows&&/^[a-z]:$/i.test(r))&&(t=!0,e.splice(n-1,2),n-=2)}}while(t);return e.length===0?[``]:e}firstPhasePreProcess(e){let t=!1;do{t=!1;for(let n of e){let r=-1;for(;(r=n.indexOf(`**`,r+1))!==-1;){let i=r;for(;n[i+1]===`**`;)i++;i>r&&n.splice(r+1,i-r);let a=n[r+1],o=n[r+2],s=n[r+3];if(a!==`..`||!o||o===`.`||o===`..`||!s||s===`.`||s===`..`)continue;t=!0,n.splice(r,1);let c=n.slice(0);c[r]=`**`,e.push(c),r--}if(!this.preserveMultipleSlashes){for(let e=1;e<n.length-1;e++){let r=n[e];(e!==1||r!==``||n[0]!==``)&&(r===`.`||r===``)&&(t=!0,n.splice(e,1),e--)}n[0]===`.`&&n.length===2&&(n[1]===`.`||n[1]===``)&&(t=!0,n.pop())}let i=0;for(;(i=n.indexOf(`..`,i+1))!==-1;){let e=n[i-1];if(e&&e!==`.`&&e!==`..`&&e!==`**`){t=!0;let e=i===1&&n[i+1]===`**`?[`.`]:[];n.splice(i-1,2,...e),n.length===0&&n.push(``),i-=2}}}}while(t);return e}secondPhasePreProcess(e){for(let t=0;t<e.length-1;t++)for(let n=t+1;n<e.length;n++){let r=this.partsMatch(e[t],e[n],!this.preserveMultipleSlashes);if(r){e[t]=[],e[n]=r;break}}return e.filter(e=>e.length)}partsMatch(e,t,n=!1){let r=0,i=0,a=[],o=``;for(;r<e.length&&i<t.length;)if(e[r]===t[i])a.push(o===`b`?t[i]:e[r]),r++,i++;else if(n&&e[r]===`**`&&t[i]===e[r+1])a.push(e[r]),r++;else if(n&&t[i]===`**`&&e[r]===t[i+1])a.push(t[i]),i++;else if(e[r]===`*`&&t[i]&&(this.options.dot||!t[i].startsWith(`.`))&&t[i]!==`**`){if(o===`b`)return!1;o=`a`,a.push(e[r]),r++,i++}else if(t[i]===`*`&&e[r]&&(this.options.dot||!e[r].startsWith(`.`))&&e[r]!==`**`){if(o===`a`)return!1;o=`b`,a.push(t[i]),r++,i++}else return!1;return e.length===t.length&&a}parseNegate(){if(this.nonegate)return;let e=this.pattern,t=!1,n=0;for(let r=0;r<e.length&&e.charAt(r)===`!`;r++)t=!t,n++;n&&(this.pattern=e.slice(n)),this.negate=t}matchOne(e,t,n=!1){let r=0,i=0;if(this.isWindows){let n=typeof e[0]==`string`&&/^[a-z]:$/i.test(e[0]),a=!n&&e[0]===``&&e[1]===``&&e[2]===`?`&&/^[a-z]:$/i.test(e[3]),o=typeof t[0]==`string`&&/^[a-z]:$/i.test(t[0]),s=!o&&t[0]===``&&t[1]===``&&t[2]===`?`&&typeof t[3]==`string`&&/^[a-z]:$/i.test(t[3]),c=a?3:n?0:void 0,l=s?3:o?0:void 0;if(typeof c==`number`&&typeof l==`number`){let[n,a]=[e[c],t[l]];n.toLowerCase()===a.toLowerCase()&&(t[l]=n,i=l,r=c)}}let{optimizationLevel:a=1}=this.options;return a>=2&&(e=this.levelTwoFileOptimize(e)),t.includes(J)?this.#e(e,t,n,r,i):this.#n(e,t,n,r,i)}#e(e,t,n,r,i){let a=t.indexOf(J,i),o=t.lastIndexOf(J),[s,c,l]=n?[t.slice(i,a),t.slice(a+1),[]]:[t.slice(i,a),t.slice(a+1,o),t.slice(o+1)];if(s.length){let t=e.slice(r,r+s.length);if(!this.#n(t,s,n,0,0))return!1;r+=s.length,i+=s.length}let u=0;if(l.length){if(l.length+r>e.length)return!1;let t=e.length-l.length;if(this.#n(e,l,n,t,0))u=l.length;else{if(e[e.length-1]!==``||r+l.length===e.length||(t--,!this.#n(e,l,n,t,0)))return!1;u=l.length+1}}if(!c.length){let t=!!u;for(let n=r;n<e.length-u;n++){let r=String(e[n]);if(t=!0,r===`.`||r===`..`||!this.options.dot&&r.startsWith(`.`))return!1}return n||t}let d=[[[],0]],f=d[0],p=0,ee=[0];for(let e of c)e===J?(ee.push(p),f=[[],0],d.push(f)):(f[0].push(e),p++);let te=d.length-1,ne=e.length-u;for(let e of d)e[1]=ne-(ee[te--]+e[0].length);return!!this.#t(e,d,r,0,n,0,!!u)}#t(e,t,n,r,i,a,o){let s=t[r];if(!s){for(let t=n;t<e.length;t++){o=!0;let n=e[t];if(n===`.`||n===`..`||!this.options.dot&&n.startsWith(`.`))return!1}return o}let[c,l]=s;for(;n<=l;){if(this.#n(e.slice(0,n+c.length),c,i,n,0)&&a<this.maxGlobstarRecursion){let s=this.#t(e,t,n+c.length,r+1,i,a+1,o);if(s!==!1)return s}let s=e[n];if(s===`.`||s===`..`||!this.options.dot&&s.startsWith(`.`))return!1;n++}return i||null}#n(e,t,n,r,i){let a,o,s,c;for(a=r,o=i,c=e.length,s=t.length;a<c&&o<s;a++,o++){this.debug(`matchOne loop`);let n=t[o],r=e[a];if(this.debug(t,n,r),n===!1||n===J)return!1;let i;if(typeof n==`string`?(i=r===n,this.debug(`string match`,n,r,i)):(i=n.test(r),this.debug(`pattern match`,n,r,i)),!i)return!1}if(a===c&&o===s)return!0;if(a===c)return n;if(o===s)return a===c-1&&e[a]===``;throw Error(`wtf?`)}braceExpand(){return Sh(this.pattern,this.options)}parse(e){jm(e);let t=this.options;if(e===`**`)return J;if(e===``)return``;let n,r=null;(n=e.match(uh))?r=t.dot?fh:dh:(n=e.match(eh))?r=(t.nocase?t.dot?ih:rh:t.dot?nh:th)(n[1]):(n=e.match(ph))?r=(t.nocase?t.dot?hh:mh:t.dot?gh:_h)(n):(n=e.match(ah))?r=t.dot?sh:oh:(n=e.match(ch))&&(r=lh);let i=Qm.fromGlob(e,this.options).toMMPattern();return r&&typeof i==`object`&&Reflect.defineProperty(i,"test",{value:r}),i}makeRe(){if(this.regexp||this.regexp===!1)return this.regexp;let e=this.set;if(!e.length)return this.regexp=!1,this.regexp;let t=this.options,n=t.noglobstar?`[^/]*?`:t.dot?`(?:(?!(?:\\/|^)(?:\\.{1,2})($|\\/)).)*?`:`(?:(?!(?:\\/|^)\\.).)*?`,r=new Set(t.nocase?[`i`]:[]),i=e.map(e=>{let t=e.map(e=>{if(e instanceof RegExp)for(let t of e.flags.split(``))r.add(t);return typeof e==`string`?wh(e):e===J?J:e._src});t.forEach((e,r)=>{let i=t[r+1],a=t[r-1];e===J&&a!==J&&(a===void 0?i!==void 0&&i!==J?t[r+1]=`(?:\\/|`+n+`\\/)?`+i:t[r]=n:i===void 0?t[r-1]=a+`(?:\\/|\\/`+n+`)?`:i!==J&&(t[r-1]=a+`(?:\\/|\\/`+n+`\\/)`+i,t[r+1]=J))});let i=t.filter(e=>e!==J);if(this.partial&&i.length>=1){let e=[];for(let t=1;t<=i.length;t++)e.push(i.slice(0,t).join(`/`));return`(?:`+e.join(`|`)+`)`}return i.join(`/`)}).join(`|`),[a,o]=e.length>1?[`(?:`,`)`]:[``,``];i=`^`+a+i+o+`$`,this.partial&&(i=`^(?:\\/|`+a+i.slice(1,-1)+o+`)$`),this.negate&&(i=`^(?!`+i+`).+$`);try{this.regexp=new RegExp(i,[...r].join(``))}catch{this.regexp=!1}return this.regexp}slashSplit(e){return this.preserveMultipleSlashes?e.split(`/`):this.isWindows&&/^\/\/[^/]+/.test(e)?[``,...e.split(/\/+/)]:e.split(/\/+/)}match(e,t=this.partial){if(this.debug(`match`,e,this.pattern),this.comment)return!1;if(this.empty)return e===``;if(e===`/`&&t)return!0;let n=this.options;this.isWindows&&(e=e.split(`\\`).join(`/`));let r=this.slashSplit(e);this.debug(this.pattern,`split`,r);let i=this.set;this.debug(this.pattern,`set`,i);let a=r[r.length-1];if(!a)for(let e=r.length-2;!a&&e>=0;e--)a=r[e];for(let e of i){let i=r;if(n.matchBase&&e.length===1&&(i=[a]),this.matchOne(i,e,t))return n.flipNegate?!0:!this.negate}return!n.flipNegate&&this.negate}static defaults(e){return q.defaults(e).Minimatch}};q.AST=Qm,q.Minimatch=Th,q.escape=$m,q.unescape=Lm;const Eh=/[/\\]/u,Dh={kind:`ignore`},Oh=e=>!ae(e)&&e.split(Eh).every(e=>e!==`.`&&e!==`..`),kh=/^!+/u,Ah=/^\.?\/+/u,jh=e=>{let t=kh.exec(e)?.[0]??``;return{body:e.slice(t.length).replace(Ah,``),negated:t.length%2==1}},Mh=e=>jh(e).negated,Nh=e=>jh(e).body,Ph=/[?[\]{}()]/u,Fh=e=>Oh(e)&&!Mh(e)&&!Ph.test(e),Ih=(e,t)=>q(e,t),Lh=e=>e.replaceAll(/\/+/gu,`/`).replace(/\/$/u,``),Rh=e=>{let t=Lh(e).split(`/`),n=t.findIndex(e=>e.includes(`*`));return n===-1?Dh:{baseDir:n===0?`.`:t.slice(0,n).join(`/`),kind:`expand-children`,pattern:Lh(e),suffix:t.slice(n+1).join(`/`)}},zh=e=>{let t=Lh(e).split(`/`).filter(e=>e.includes(`*`));return t.length<=1&&!t.includes(`**`)},Bh=e=>{let t=Lh(e).split(`/`),n=t.findIndex(e=>e.includes(`*`));return n<=0?`.`:t.slice(0,n).join(`/`)},Vh=e=>Fh(e)?e.includes(`*`)?zh(e)?Rh(e):{baseDir:Bh(e),kind:`expand-recursive`,pattern:Lh(e)}:{dir:e,kind:`probe-dir`,pattern:e}:Dh,Hh=new Set([`candidate_not_inspected`,`scan_budget_exhausted`,`manifest_unreadable`,`unsupported_pattern`,`workspace_declaration_unparsed`,`workspace_dir_unreadable`,`workspace_file_unreadable`]),Uh=(e,t)=>t?.name?{name:t.name,path:e}:void 0,Wh=e=>{let t=e.map(e=>[e.path,e]),n=[...new Map(t).values()];return n.sort((e,t)=>e.path.localeCompare(t.path)),n},Gh=e=>!e.diagnostics.some(e=>Hh.has(e.kind)),Kh=e=>!e.diagnostics.some(e=>e.kind===`no_workspace_declaration`),qh=(e,t)=>e<t?-1:+(e>t),Jh=e=>`path`in e?`${e.kind} ${e.path}`:`file`in e?`${e.kind} ${e.file}`:`pattern`in e?`${e.kind} ${e.pattern}`:e.kind,Yh=e=>e.toSorted((e,t)=>qh(Jh(e),Jh(t))),Xh=e=>!ae(e)&&!e.split(/[/\\]/u).includes(`..`),Zh=(e,t)=>e.kind===`missing`?{kind:`absent`}:e.kind===`outside`?{kind:`unreadable`,reason:`${t} escapes the checkout`}:{kind:`unreadable`,reason:e.code},Qh=async(e,t,n)=>{if(!Xh(t))return{kind:`unreadable`,reason:`path escapes the checkout`};let r=await $h(e,t);if(`probe`in r)return r.probe;let i=await eg(r.real);return`reason`in i?{kind:`unreadable`,reason:i.reason}:i.found===n?{kind:`match`}:{found:i.found,kind:`mismatch`}},$h=async(e,t)=>{let n=await H(e,m(e,t));if(n.kind!==`inside`)return{probe:Zh(n,`path`)};let r=await H(e,m(n.real,`package.json`));return r.kind===`inside`?{real:r.real}:{probe:Zh(r,`manifest`)}},eg=async e=>{try{let t=JSON.parse(await s(e,`utf8`));return{found:Iu(t)}}catch(e){return{reason:e.code??String(e)}}},tg=(e,t)=>{let n=e.filter(e=>e.name===t).map(e=>e.path);return n.length===0?{kind:`absent`}:n.length===1?{kind:`found`,path:n[0]}:{kind:`ambiguous`,paths:n.toSorted(qh)}},ng=new Set;let rg=!1;const ig=()=>{for(let e of ng)try{e.kill(`SIGKILL`)}catch{}},ag=[`SIGINT`,`SIGTERM`,`SIGHUP`,`SIGBREAK`],og=e=>{let t=()=>{ig(),process.removeListener(e,t),process.kill(process.pid,e)};process.on(e,t)},sg=()=>{rg||(rg=!0,ag.forEach(e=>{og(e)}),process.on(`exit`,ig))},cg=()=>{let e=[],t=0,n=!1;return{finish:()=>({text:Buffer.concat(e).toString(`utf8`),truncated:n}),push:r=>{if(n)return;let i=67108864-t;if(r.length<=i){e.push(r),t+=r.length;return}i>0&&e.push(r.subarray(0,i)),n=!0}}},lg=(e,t)=>[e.replace(/\r?\n$/u,``),t].filter(e=>e!==``).join(`
|
|
328
|
-
`),ug=(e,t,n)=>{let r=e;return t.truncated&&(r=lg(r,`refs: stdout exceeded 67108864 bytes, truncated`)),n.truncated&&(r=lg(r,`refs: stderr exceeded 67108864 bytes, truncated`)),r},dg={clear:()=>{},markedTimedOut:()=>!1},fg=(e,t)=>{if(t===void 0)return dg;let n=!1,r,i=setTimeout(()=>{n=!0,e.kill(`SIGTERM`),r=setTimeout(()=>{e.kill(`SIGKILL`)},2e3)},t);return{clear:()=>{clearTimeout(i),r!==void 0&&clearTimeout(r)},markedTimedOut:()=>n}},pg=e=>e===void 0?{}:{cwd:e},mg=(e,t)=>lg(e,`refs: command timed out after ${String(t)}ms`),hg=(e,t)=>({exitCode:124,stderr:mg(e,t),stdout:``,timedOut:!0}),gg=(e,t,n)=>{let r=be(e,t,{...pg(n?.cwd),stdio:[`ignore`,`pipe`,`pipe`]});ng.add(r);let i=cg(),a=cg();return r.stdout.on(`data`,e=>{i.push(e)}),r.stderr.on(`data`,e=>{a.push(e)}),{child:r,stderrCollector:a,stdoutCollector:i,timeout:fg(r,n?.timeoutMs)}},_g=(e,t,n)=>{try{return gg(e,t,n)}catch(e){return{exitCode:127,stderr:yg(e),stdout:``}}},vg=e=>!(`child`in e),yg=e=>e instanceof Error?e.message:String(e),bg=async e=>{try{let[t]=await ve(e,`close`);return{code:t}}catch(e){return{code:null,errorMessage:yg(e)}}},xg=e=>e===null?1:e,Sg=(e,t)=>t.truncated?{...e,stdoutTruncated:!0}:e,Cg=e=>e.timedOut?hg(e.stderr.text,e.timeoutMs):e.errorMessage===void 0?Sg({exitCode:xg(e.code),stderr:ug(e.stderr.text,e.stdout,e.stderr),stdout:e.stdout.text},e.stdout):Sg({exitCode:127,stderr:lg(e.stderr.text,e.errorMessage),stdout:e.stdout.text},e.stdout);var wg=class{async run(e,t,n){sg();let r=_g(e,t,n);if(vg(r))return r;let i=await bg(r.child);return ng.delete(r.child),r.timeout.clear(),Cg({code:i.code,errorMessage:i.errorMessage,stderr:r.stderrCollector.finish(),stdout:r.stdoutCollector.finish(),timedOut:r.timeout.markedTimedOut(),timeoutMs:n?.timeoutMs})}};const Tg=`package.json`,Eg=/^\.\/[^\s%?#\\]*$/u,Dg=async e=>{try{return(await p(e)).isDirectory()?`directory`:`file`}catch{return`unverifiable`}},Og=async(e,t)=>{if(!Eg.test(t)||t.includes(`*`))return`not_checked`;let n=await H(e,m(e,t.slice(2)));return n.kind===`missing`?`absent`:n.kind===`inside`?Dg(n.real):`unverifiable`},kg=async(e,t,n)=>Array.isArray(t)?{alternatives:await Promise.all(t.map(t=>Ag(e,t,n+1))),kind:`alternatives`}:{branches:await Promise.all(Object.entries(t).map(async([t,r])=>({condition:t,value:await Ag(e,r,n+1)}))),kind:`conditions`},Ag=async(e,t,n)=>t===null?{kind:`excluded`}:n>8?{kind:`unsupported`,reason:`nested deeper than this reports on`}:typeof t==`string`?{kind:`target`,observed:await Og(e,t),target:t}:typeof t==`object`?kg(e,t,n):{kind:`unsupported`,reason:`unexpected ${typeof t}`},jg=[`main`,`module`,`types`,`typings`],Mg=(e,t)=>{let n=jg.filter(e=>typeof t[e]==`string`);return Promise.all(n.map(async n=>({from:n,subpath:`.`,value:await Ag(e,Ng(t[n]),0)})))},Ng=e=>e.startsWith(`/`)||e.startsWith(`./`)||e.startsWith(`../`)?e:`./${e}`,Pg=async(e,t)=>{if(typeof t==`string`||Array.isArray(t))return[{from:`exports`,subpath:`.`,value:await Ag(e,t,0)}];if(t===void 0)return[];if(typeof t!=`object`||!t)return[{from:`exports`,subpath:`.`,value:await Ag(e,t,0)}];let n=Object.keys(t);return n.length>0&&!n.some(e=>e.startsWith(`.`))?[{from:`exports`,subpath:`.`,value:await Ag(e,t,0)}]:Promise.all(Object.entries(t).map(async([t,n])=>({from:`exports`,subpath:t,value:await Ag(e,n,0)})))},Fg=async(e,t)=>{let n=await H(e,m(e,Tg));if(n.kind!==`inside`)return{entries:[],manifest:Tg,reason:n.kind,status:`unverifiable`};try{let r=JSON.parse(await s(n.real,`utf8`));return r.name===t?{entries:[...await Pg(e,r.exports),...await Mg(e,r)],manifest:Tg,status:`complete`}:{entries:[],manifest:Tg,reason:`manifest no longer names this package`,status:`unverifiable`}}catch(e){return{entries:[],manifest:Tg,reason:e.code??String(e),status:`unverifiable`}}},Ig=hl.partial({description:!0}),Lg=I({default_branch:P().min(1),key:il,tag_format_candidate:ll.nullable(),url:P().min(1)});Lg.extend({description:P().default(``),packages:Gc(Ig)});const Rg=Lg.extend({description:P().min(1),packages:Gc(hl)}),zg=I({effective_clone_mode:sl.optional(),head_sha:P().regex(/^[0-9a-f]{40}$/u,`head_sha must be a 40-character lowercase hex string`).optional(),last_error:P().optional(),last_fetched_at:Vc().optional(),pending_proposal_at:Vc().optional()}),Bg=I({refs:Uc(e=>e.length>0&&!Hc.has(e),()=>`state ref key must be non-empty and not "__proto__", "constructor", or "prototype"`,pc(P(),zg)).default({})}),Vg=(e,t,n)=>t?.[e]??n[e],Hg=async e=>{try{return await s(e.statePath,`utf8`)}catch(e){if(R(e))return;throw e}},Ug=e=>{try{return JSON.parse(e)}catch{return}},Wg=async e=>{let t=await Hg(e);if(t===void 0)return Bg.parse({});let n=Ug(t);if(n===void 0)return Bg.parse({});let r=Bg.safeParse(n);return r.success?r.data:Bg.parse({})},Gg=async(e,t)=>{let n=Bg.safeParse(t);if(!n.success)throw y(T(n.error));await $l(e.statePath,`${JSON.stringify(n.data,void 0,2)}\n`)},Kg=/^\d+\.\d+\.\d+$/u,qg=/^0+(?=\d)/u,Jg=(e,t)=>{let n=e.replace(qg,``),r=t.replace(qg,``);return n.length===r.length?n===r?0:n<r?-1:1:n.length<r.length?-1:1},Yg=(e,t)=>{if(!Kg.test(e)||!Kg.test(t))return;let n=e.split(`.`),r=t.split(`.`);return n.map((e,t)=>Jg(e,r[t]??``)).find(e=>e!==0)??0},Xg=sc({version:P().regex(Kg)}),Zg=I({checked_at:Vc(),latest_version:P().regex(Kg)}),Qg=async e=>{try{let t=Zg.safeParse(JSON.parse(await s(e.updateCachePath,`utf8`)));return t.success?t.data:void 0}catch{return}},$g=async(e,t)=>{try{await p(e.root),await $l(e.updateCachePath,`${JSON.stringify(t,void 0,2)}\n`)}catch{}},e_=(e,t)=>{let n=t-Date.parse(e.checked_at);return n>=0&&n<864e5},t_=async e=>{try{let t=await e(`https://registry.npmjs.org/@kaisers-io%2Frefs/latest`,{signal:AbortSignal.timeout(2e3)});if(t.status!==200)return;let n=Xg.safeParse(await t.json());return n.success?n.data.version:void 0}catch{return}},n_=async e=>{let t=await Qg(e.home);if(t!==void 0&&e_(t,e.nowMs))return{latest:t.latest_version,refreshed:!1,stale:!1};let n=await t_(e.fetch);return n===void 0?{latest:t?.latest_version,refreshed:!1,stale:!0}:(await $g(e.home,{checked_at:new Date(e.nowMs).toISOString(),latest_version:n}),{latest:n,refreshed:!0,stale:!1})},r_=(e,t)=>{let n=Yg(e,t);return n!==void 0&&n<0},i_=(e,t)=>`refs ${t} is available (this is ${e}) — update: npm i -g @kaisers-io/refs@latest`,a_=e=>{let t=e.REFS_UPDATE_CHECK?.trim();if(t===`0`)return!1;if(t===`1`)return!0},o_=e=>{let t=e.CI?.trim().toLowerCase();return t!==void 0&&t!==``&&t!==`false`&&t!==`0`},s_={check:!0,notify:!0},c_=e=>{let t=a_(e.env);return t===void 0?(e.updates??s_).check?o_(e.env)?`ci`:`on`:`config`:t?`on`:`env`},l_=e=>c_(e)===`on`,u_=e=>l_(e)&&(e.updates??s_).notify,d_=async(e,t)=>{let n=await H(e,m(t,`package.json`));if(n.kind===`inside`)try{let e=JSON.parse(await s(n.real,`utf8`));return{name:Iu(e)}}catch{return}},f_=async(e,t)=>{let n=await d_(e,m(e,t));if(n===void 0)return{diagnostic:{kind:`manifest_unreadable`,path:t}};let r=Uh(t,n);return r===void 0?{diagnostic:{kind:`manifest_missing_name`,path:t}}:{pkg:r}},p_=e=>{let t=[],n=[];for(let r of e)r.diagnostic!==void 0&&t.push(r.diagnostic),r.pkg!==void 0&&n.push(r.pkg);return{diagnostics:t,packages:n}},m_=new Set([`ENOENT`,`ENOTDIR`]),h_=async(e,t)=>{let n=await H(e,m(t,`package.json`));if(n.kind===`missing`)return`none`;if(n.kind!==`inside`)return`rejected`;try{return await s(n.real,`utf8`),`manifest`}catch{return`rejected`}},g_=async e=>{try{return{entries:await c(e,{withFileTypes:!0})}}catch(e){return{code:e.code??``}}},__=e=>Promise.all(e.entries.map(t=>h_(e.repoDir,m(e.fullPath,t.name,e.suffix)))),v_=(e,t,n)=>e.filter((e,r)=>n(t[r])).map(e=>e.name),y_=async e=>{let{baseDir:t,dirs:n,fullPath:r,repoDir:i,suffix:a,symlinks:o}=e,s=e=>oe.join(t===`.`?``:t,e,a),[c,l]=await Promise.all([__({entries:n,fullPath:r,repoDir:i,suffix:a}),__({entries:o,fullPath:r,repoDir:i,suffix:a})]);return{diagnostics:[...v_(n,c,e=>e===`rejected`).map(e=>({kind:`manifest_unreadable`,path:s(e)})),...v_(o,l,e=>e!==`none`).map(e=>({kind:`candidate_not_inspected`,path:s(e)}))],dirs:v_(n,c,e=>e===`manifest`).map(e=>s(e))}},b_=async e=>{let t=await f_(e,`.`);return`pkg`in t?[t]:[]},x_=e=>{let t=e.find(e=>e.path===`.`);return t===void 0?[...e]:e.some(e=>e.path!==`.`&&e.name===t.name)?e.filter(e=>e!==t):[...e]},S_=async e=>{let[t]=await b_(e);return t!==void 0&&`pkg`in t?t.pkg:void 0},C_=`package.json`,w_=e=>{let t=Lh(e).split(`/`);return t.includes(`**`)?void 0:t.length},T_=e=>Lh(e).split(`/`).some(e=>e.startsWith(`.`)),E_=e=>e===`.`?0:e.split(`/`).length,D_=e=>{let t=Lh(e),n=new Th(`${t}/${C_}`),r=new Th(t);return{couldHold:e=>r.match(e,!0),selects:e=>n.match(oe.join(e,C_))}},O_=e=>({...D_(e),maxDepth:w_(e),selectsHidden:T_(e)}),k_=new Set([`ENOENT`,`ENOTDIR`]),A_=new Set([`.git`,`node_modules`]),j_=e=>e.some(e=>e.name.toLowerCase()===`package.json`&&!e.isDirectory()),M_=e=>e.some(e=>e.isSymbolicLink()&&!A_.has(e.name)),N_=async(e,t)=>{let n=await g_(t);return`code`in n?{answer:k_.has(n.code)}:(e.budget.entries-=n.entries.length,e.budget.entries<0||j_(n.entries)||M_(n.entries)?{answer:!1}:{entries:n.entries})},P_=async(e,t,n)=>{if(e.budget.dirs<=0||n>32)return!1;--e.budget.dirs;let r=await N_(e,t);return`answer`in r?r.answer:F_(e,{dir:t,entries:r.entries},n)},F_=async(e,t,n)=>{let r=t.entries.filter(e=>e.isDirectory()&&!A_.has(e.name));for(let i of r)if(!await P_(e,m(t.dir,i.name),n+1))return!1;return!0},I_=async(e,t)=>{let n=await H(e.repoDir,m(e.repoDir,t));if(n.kind!==`outside`&&n.kind!==`missing`){if(n.kind===`unreadable`){e.diagnostics.push({kind:`candidate_not_inspected`,path:t});return}await P_(e,n.real,1)||e.diagnostics.push({kind:`candidate_not_inspected`,path:t})}},L_=()=>({dirs:2e4,entries:2e5}),R_=new Set([`.git`,`node_modules`]),z_=(e,t)=>{e.diagnostics.push({kind:`scan_budget_exhausted`,path:t,pattern:e.pattern})},B_=async(e,t,n)=>{if(!e.selects(t)||n.has(t))return;let r=await h_(e.repoDir,m(e.repoDir,t));r===`manifest`&&e.dirs.push(t),r===`rejected`&&e.diagnostics.push({kind:`manifest_unreadable`,path:t})},V_=(e,t)=>!e.selectsHidden&&t.excluded.coversSubtree(t.relPath),H_=async(e,t,n)=>!e.couldHold(n.relPath)||R_.has(t.name)||V_(e,n)?!1:t.isSymbolicLink()?(V_(e,n)||await I_(e,n.relPath),!1):t.isDirectory(),U_=async(e,t)=>{let n=await g_(m(e.repoDir,t));if(`code`in n){m_.has(n.code)||e.diagnostics.push({kind:`workspace_dir_unreadable`,path:t});return}if(e.budget.entries-=n.entries.length,e.budget.entries<0){z_(e,t);return}return n.entries},W_=async(e,t,n)=>{if(e.budget.dirs<=0){z_(e,t.relPath);return}if(--e.budget.dirs,await B_(e,t.relPath,n),e.maxDepth!==void 0&&E_(t.relPath)>=e.maxDepth)return;let r=await U_(e,t.relPath);r!==void 0&&await K_(e,{depth:t.depth,entries:r,relPath:t.relPath},n)},G_=(e,t)=>oe.join(e===`.`?``:e,t),K_=async(e,t,n)=>{for(let r of t.entries){let i=G_(t.relPath,r.name);await H_(e,r,{excluded:n,relPath:i})&&(t.depth+1>32?z_(e,i):await W_(e,{depth:t.depth+1,relPath:i},n))}},q_=async(e,t)=>{let n=await H(e,m(e,t));if(n.kind!==`inside`)return n.kind===`missing`?{diagnostics:[],dirs:[]}:{diagnostics:[{kind:`workspace_dir_unreadable`,path:t}],dirs:[]}},J_=async(e,t,n)=>{let r=await q_(e,t.baseDir);if(r!==void 0)return r;let i={...O_(t.pattern),budget:n.budget,diagnostics:[],dirs:[],pattern:t.pattern,repoDir:e};return await W_(i,{depth:1,relPath:t.baseDir},n.excluded),{diagnostics:i.diagnostics,dirs:i.dirs}},Y_=(e,t)=>oe.join(e.baseDir===`.`?``:e.baseDir,t,e.suffix),X_=(e,t)=>Ih(Y_(t,e.name),t.pattern),Z_=async(e,t)=>{let n=m(e,t),r=await H(e,n);if(r.kind===`missing`)return{result:{diagnostics:[],dirs:[]}};if(r.kind!==`inside`)return{result:{diagnostics:[{kind:`workspace_dir_unreadable`,path:t}],dirs:[]}};let i=await g_(n);return`code`in i?{result:m_.has(i.code)?{diagnostics:[],dirs:[]}:{diagnostics:[{kind:`workspace_dir_unreadable`,path:t}],dirs:[]}}:{entries:i.entries}},Q_=async(e,t,n)=>{let{baseDir:r}=t,i=await Z_(e,r);if(`result`in i)return i.result;let a=e=>X_(e,t)&&!n.has(Y_(t,e.name)),o={entries:i.entries};return y_({baseDir:r,dirs:o.entries.filter(e=>e.isDirectory()&&a(e)),fullPath:m(e,r),repoDir:e,suffix:t.suffix,symlinks:o.entries.filter(e=>e.isSymbolicLink()&&a(e))})},$_=async(e,t)=>{let n=await h_(e,m(e,t));return n===`manifest`?{diagnostics:[],dirs:[Lh(t)]}:n===`rejected`?{diagnostics:[{kind:`manifest_unreadable`,path:t}],dirs:[]}:{diagnostics:[],dirs:[]}},ev=(e,t,n)=>{let{excluded:r}=n,i=Vh(t.body);return i.kind===`expand-children`?Q_(e,i,r):i.kind===`expand-recursive`?J_(e,i,n):i.kind===`probe-dir`?r.has(Lh(i.dir))?Promise.resolve({diagnostics:[],dirs:[]}):$_(e,i.dir):Promise.resolve({diagnostics:[{kind:`unsupported_pattern`,pattern:t.declared}],dirs:[]})},tv=(e,t)=>Ih(Nh(e),Nh(t)),nv=e=>({negations:e.filter(e=>Mh(e)),patterns:e.filter(e=>!Mh(e))}),rv=e=>{let t=e.reduce((e,t)=>Mh(t)?{negations:[...e.negations,t],patterns:e.patterns}:{negations:e.negations.filter(e=>!tv(t,e)),patterns:[...e.patterns,t]},{negations:[],patterns:[]});return{negations:t.negations,patterns:t.patterns.filter(e=>!t.negations.some(t=>tv(e,t)))}},iv=e=>e.endsWith(`/`)?e:`${e}/`,av=(e,t)=>e.some(e=>Ih(iv(t),iv(Nh(e)))),ov=(e,t)=>{let n=Nh(e);return n.endsWith(`/**`)&&Ih(t,n.slice(0,-3))},sv=e=>({coversSubtree:t=>e.some(e=>ov(e,t)),has:t=>av(e,t)}),cv=e=>{let t=new Set,n=[];for(let r of e)r.dirs.forEach(e=>t.add(e)),n.push(...r.diagnostics);return{diagnostics:n,dirs:[...t]}},lv=async(e,t,n)=>{let{negations:r,patterns:i}=t,a=sv(r),o=cv(await Promise.all(i.map(t=>ev(e,{body:Nh(t),declared:t},{budget:n,excluded:a}))));return{diagnostics:o.diagnostics,dirs:o.dirs}},uv=async(e,t)=>{let n=rv(t.npm),r=nv(t.pnpm),i=L_(),a=await Promise.all([lv(e,n,i),lv(e,r,i)]);return cv(a)},dv=async e=>{let t=await Uu(e);if(t.npm.length===0&&t.pnpm.length===0)return{diagnostics:Yh([...t.diagnostics,{kind:`no_workspace_declaration`}]),packages:[]};let n=await uv(e,t),[r,i]=await Promise.all([b_(e),Promise.all(n.dirs.map(t=>f_(e,t)))]),a=p_([...r,...i]);return{diagnostics:Yh([...t.diagnostics,...n.diagnostics,...a.diagnostics]),packages:x_(Wh(a.packages))}};var fv=`0.16.0`;const pv=async()=>{let e=[];for await(let t of process.stdin)e.push(Buffer.from(t));return Buffer.concat(e).toString(`utf8`)},mv=()=>{try{return he()}catch{return``}},hv=()=>({cliVersion:fv,cwd:process.cwd(),env:process.env,errLine:e=>{process.stderr.write(`${e}\n`)},fetcher:(e,t)=>fetch(e,t),homedir:mv(),nodeVersion:process.version,out:e=>{process.stdout.write(`${e}\n`)},readStdin:pv,runner:new wg});var gv=class extends Error{constructor(e,t,n){super(n),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name,this.code=t,this.exitCode=e,this.nestedError=void 0}},_v=class extends gv{constructor(e){super(1,`commander.invalidArgument`,e),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name}},vv=class{constructor(e,t){switch(this.description=t||``,this.variadic=!1,this.parseArg=void 0,this.defaultValue=void 0,this.defaultValueDescription=void 0,this.argChoices=void 0,e[0]){case`<`:this.required=!0,this._name=e.slice(1,-1);break;case`[`:this.required=!1,this._name=e.slice(1,-1);break;default:this.required=!0,this._name=e}this._name.endsWith(`...`)&&(this.variadic=!0,this._name=this._name.slice(0,-3))}name(){return this._name}_collectValue(e,t){return t===this.defaultValue||!Array.isArray(t)?[e]:(t.push(e),t)}default(e,t){return this.defaultValue=e,this.defaultValueDescription=t,this}argParser(e){return this.parseArg=e,this}choices(e){return this.argChoices=e.slice(),this.parseArg=(e,t)=>{if(!this.argChoices.includes(e))throw new _v(`Allowed choices are ${this.argChoices.join(`, `)}.`);return this.variadic?this._collectValue(e,t):e},this}argRequired(){return this.required=!0,this}argOptional(){return this.required=!1,this}};function yv(e){let t=e.name()+(e.variadic===!0?`...`:``);return e.required?`<`+t+`>`:`[`+t+`]`}var bv=class{constructor(){this.helpWidth=void 0,this.minWidthToWrap=40,this.sortSubcommands=!1,this.sortOptions=!1,this.showGlobalOptions=!1}prepareContext(e){this.helpWidth=this.helpWidth??e.helpWidth??80}visibleCommands(e){let t=e.commands.filter(e=>!e._hidden),n=e._getHelpCommand();return n&&!n._hidden&&t.push(n),this.sortSubcommands&&t.sort((e,t)=>e.name().localeCompare(t.name())),t}compareOptions(e,t){let n=e=>e.short?e.short.replace(/^-/,``):e.long.replace(/^--/,``);return n(e).localeCompare(n(t))}visibleOptions(e){let t=e.options.filter(e=>!e.hidden),n=e._getHelpOption();if(n&&!n.hidden){let r=n.short&&e._findOption(n.short),i=n.long&&e._findOption(n.long);!r&&!i?t.push(n):n.long&&!i?t.push(e.createOption(n.long,n.description)):n.short&&!r&&t.push(e.createOption(n.short,n.description))}return this.sortOptions&&t.sort(this.compareOptions),t}visibleGlobalOptions(e){if(!this.showGlobalOptions)return[];let t=[];for(let n=e.parent;n;n=n.parent){let e=n.options.filter(e=>!e.hidden);t.push(...e)}return this.sortOptions&&t.sort(this.compareOptions),t}visibleArguments(e){return e._argsDescription&&e.registeredArguments.forEach(t=>{t.description=t.description||e._argsDescription[t.name()]||``}),e.registeredArguments.find(e=>e.description)?e.registeredArguments:[]}subcommandTerm(e){let t=e.registeredArguments.map(e=>yv(e)).join(` `);return e._name+(e._aliases[0]?`|`+e._aliases[0]:``)+(e.options.length?` [options]`:``)+(t?` `+t:``)}optionTerm(e){return e.flags}argumentTerm(e){return e.name()}longestSubcommandTermLength(e,t){return t.visibleCommands(e).reduce((e,n)=>Math.max(e,this.displayWidth(t.styleSubcommandTerm(t.subcommandTerm(n)))),0)}longestOptionTermLength(e,t){return t.visibleOptions(e).reduce((e,n)=>Math.max(e,this.displayWidth(t.styleOptionTerm(t.optionTerm(n)))),0)}longestGlobalOptionTermLength(e,t){return t.visibleGlobalOptions(e).reduce((e,n)=>Math.max(e,this.displayWidth(t.styleOptionTerm(t.optionTerm(n)))),0)}longestArgumentTermLength(e,t){return t.visibleArguments(e).reduce((e,n)=>Math.max(e,this.displayWidth(t.styleArgumentTerm(t.argumentTerm(n)))),0)}commandUsage(e){let t=e._name;e._aliases[0]&&(t=t+`|`+e._aliases[0]);let n=``;for(let t=e.parent;t;t=t.parent)n=t.name()+` `+n;return n+t+` `+e.usage()}commandDescription(e){return e.description()}subcommandDescription(e){return e.summary()||e.description()}optionDescription(e){let t=[];if(e.argChoices&&t.push(`choices: ${e.argChoices.map(e=>JSON.stringify(e)).join(`, `)}`),e.defaultValue!==void 0&&(e.required||e.optional||e.isBoolean()&&typeof e.defaultValue==`boolean`)&&t.push(`default: ${e.defaultValueDescription||JSON.stringify(e.defaultValue)}`),e.presetArg!==void 0&&e.optional&&t.push(`preset: ${JSON.stringify(e.presetArg)}`),e.envVar!==void 0&&t.push(`env: ${e.envVar}`),t.length>0){let n=`(${t.join(`, `)})`;return e.description?`${e.description} ${n}`:n}return e.description}argumentDescription(e){let t=[];if(e.argChoices&&t.push(`choices: ${e.argChoices.map(e=>JSON.stringify(e)).join(`, `)}`),e.defaultValue!==void 0&&t.push(`default: ${e.defaultValueDescription||JSON.stringify(e.defaultValue)}`),t.length>0){let n=`(${t.join(`, `)})`;return e.description?`${e.description} ${n}`:n}return e.description}formatItemList(e,t,n){return t.length===0?[]:[n.styleTitle(e),...t,``]}groupItems(e,t,n){let r=new Map;return e.forEach(e=>{let t=n(e);r.has(t)||r.set(t,[])}),t.forEach(e=>{let t=n(e);r.has(t)||r.set(t,[]),r.get(t).push(e)}),r}formatHelp(e,t){let n=t.padWidth(e,t),r=t.helpWidth??80;function i(e,r){return t.formatItem(e,n,r,t)}let a=[`${t.styleTitle(`Usage:`)} ${t.styleUsage(t.commandUsage(e))}`,``],o=t.commandDescription(e);o.length>0&&(a=a.concat([t.boxWrap(t.styleCommandDescription(o),r),``]));let s=t.visibleArguments(e).map(e=>i(t.styleArgumentTerm(t.argumentTerm(e)),t.styleArgumentDescription(t.argumentDescription(e))));if(a=a.concat(this.formatItemList(`Arguments:`,s,t)),this.groupItems(e.options,t.visibleOptions(e),e=>e.helpGroupHeading??`Options:`).forEach((e,n)=>{let r=e.map(e=>i(t.styleOptionTerm(t.optionTerm(e)),t.styleOptionDescription(t.optionDescription(e))));a=a.concat(this.formatItemList(n,r,t))}),t.showGlobalOptions){let n=t.visibleGlobalOptions(e).map(e=>i(t.styleOptionTerm(t.optionTerm(e)),t.styleOptionDescription(t.optionDescription(e))));a=a.concat(this.formatItemList(`Global Options:`,n,t))}return this.groupItems(e.commands,t.visibleCommands(e),e=>e.helpGroup()||`Commands:`).forEach((e,n)=>{let r=e.map(e=>i(t.styleSubcommandTerm(t.subcommandTerm(e)),t.styleSubcommandDescription(t.subcommandDescription(e))));a=a.concat(this.formatItemList(n,r,t))}),a.join(`
|
|
328
|
+
`),ug=(e,t,n)=>{let r=e;return t.truncated&&(r=lg(r,`refs: stdout exceeded 67108864 bytes, truncated`)),n.truncated&&(r=lg(r,`refs: stderr exceeded 67108864 bytes, truncated`)),r},dg={clear:()=>{},markedTimedOut:()=>!1},fg=(e,t)=>{if(t===void 0)return dg;let n=!1,r,i=setTimeout(()=>{n=!0,e.kill(`SIGTERM`),r=setTimeout(()=>{e.kill(`SIGKILL`)},2e3)},t);return{clear:()=>{clearTimeout(i),r!==void 0&&clearTimeout(r)},markedTimedOut:()=>n}},pg=e=>e===void 0?{}:{cwd:e},mg=(e,t)=>lg(e,`refs: command timed out after ${String(t)}ms`),hg=(e,t)=>({exitCode:124,stderr:mg(e,t),stdout:``,timedOut:!0}),gg=(e,t,n)=>{let r=be(e,t,{...pg(n?.cwd),stdio:[`ignore`,`pipe`,`pipe`]});ng.add(r);let i=cg(),a=cg();return r.stdout.on(`data`,e=>{i.push(e)}),r.stderr.on(`data`,e=>{a.push(e)}),{child:r,stderrCollector:a,stdoutCollector:i,timeout:fg(r,n?.timeoutMs)}},_g=(e,t,n)=>{try{return gg(e,t,n)}catch(e){return{exitCode:127,stderr:yg(e),stdout:``}}},vg=e=>!(`child`in e),yg=e=>e instanceof Error?e.message:String(e),bg=async e=>{try{let[t]=await ve(e,`close`);return{code:t}}catch(e){return{code:null,errorMessage:yg(e)}}},xg=e=>e===null?1:e,Sg=(e,t)=>t.truncated?{...e,stdoutTruncated:!0}:e,Cg=e=>e.timedOut?hg(e.stderr.text,e.timeoutMs):e.errorMessage===void 0?Sg({exitCode:xg(e.code),stderr:ug(e.stderr.text,e.stdout,e.stderr),stdout:e.stdout.text},e.stdout):Sg({exitCode:127,stderr:lg(e.stderr.text,e.errorMessage),stdout:e.stdout.text},e.stdout);var wg=class{async run(e,t,n){sg();let r=_g(e,t,n);if(vg(r))return r;let i=await bg(r.child);return ng.delete(r.child),r.timeout.clear(),Cg({code:i.code,errorMessage:i.errorMessage,stderr:r.stderrCollector.finish(),stdout:r.stdoutCollector.finish(),timedOut:r.timeout.markedTimedOut(),timeoutMs:n?.timeoutMs})}};const Tg=`package.json`,Eg=/^\.\/[^\s%?#\\]*$/u,Dg=async e=>{try{return(await p(e)).isDirectory()?`directory`:`file`}catch{return`unverifiable`}},Og=async(e,t)=>{if(!Eg.test(t)||t.includes(`*`))return`not_checked`;let n=await H(e,m(e,t.slice(2)));return n.kind===`missing`?`absent`:n.kind===`inside`?Dg(n.real):`unverifiable`},kg=async(e,t,n)=>Array.isArray(t)?{alternatives:await Promise.all(t.map(t=>Ag(e,t,n+1))),kind:`alternatives`}:{branches:await Promise.all(Object.entries(t).map(async([t,r])=>({condition:t,value:await Ag(e,r,n+1)}))),kind:`conditions`},Ag=async(e,t,n)=>t===null?{kind:`excluded`}:n>8?{kind:`unsupported`,reason:`nested deeper than this reports on`}:typeof t==`string`?{kind:`target`,observed:await Og(e,t),target:t}:typeof t==`object`?kg(e,t,n):{kind:`unsupported`,reason:`unexpected ${typeof t}`},jg=[`main`,`module`,`types`,`typings`],Mg=(e,t)=>{let n=jg.filter(e=>typeof t[e]==`string`);return Promise.all(n.map(async n=>({from:n,subpath:`.`,value:await Ag(e,Ng(t[n]),0)})))},Ng=e=>e.startsWith(`/`)||e.startsWith(`./`)||e.startsWith(`../`)?e:`./${e}`,Pg=async(e,t)=>{if(typeof t==`string`||Array.isArray(t))return[{from:`exports`,subpath:`.`,value:await Ag(e,t,0)}];if(t===void 0)return[];if(typeof t!=`object`||!t)return[{from:`exports`,subpath:`.`,value:await Ag(e,t,0)}];let n=Object.keys(t);return n.length>0&&!n.some(e=>e.startsWith(`.`))?[{from:`exports`,subpath:`.`,value:await Ag(e,t,0)}]:Promise.all(Object.entries(t).map(async([t,n])=>({from:`exports`,subpath:t,value:await Ag(e,n,0)})))},Fg=async(e,t)=>{let n=await H(e,m(e,Tg));if(n.kind!==`inside`)return{entries:[],manifest:Tg,reason:n.kind,status:`unverifiable`};try{let r=JSON.parse(await s(n.real,`utf8`));return r.name===t?{entries:[...await Pg(e,r.exports),...await Mg(e,r)],manifest:Tg,status:`complete`}:{entries:[],manifest:Tg,reason:`manifest no longer names this package`,status:`unverifiable`}}catch(e){return{entries:[],manifest:Tg,reason:e.code??String(e),status:`unverifiable`}}},Ig=hl.partial({description:!0}),Lg=I({default_branch:P().min(1),key:il,tag_format_candidate:ll.nullable(),url:P().min(1)});Lg.extend({description:P().default(``),packages:Gc(Ig)});const Rg=Lg.extend({description:P().min(1),packages:Gc(hl)}),zg=I({effective_clone_mode:sl.optional(),head_sha:P().regex(/^[0-9a-f]{40}$/u,`head_sha must be a 40-character lowercase hex string`).optional(),last_error:P().optional(),last_fetched_at:Vc().optional(),pending_proposal_at:Vc().optional()}),Bg=I({refs:Uc(e=>e.length>0&&!Hc.has(e),()=>`state ref key must be non-empty and not "__proto__", "constructor", or "prototype"`,pc(P(),zg)).default({})}),Vg=(e,t,n)=>t?.[e]??n[e],Hg=async e=>{try{return await s(e.statePath,`utf8`)}catch(e){if(R(e))return;throw e}},Ug=e=>{try{return JSON.parse(e)}catch{return}},Wg=async e=>{let t=await Hg(e);if(t===void 0)return Bg.parse({});let n=Ug(t);if(n===void 0)return Bg.parse({});let r=Bg.safeParse(n);return r.success?r.data:Bg.parse({})},Gg=async(e,t)=>{let n=Bg.safeParse(t);if(!n.success)throw y(T(n.error));await $l(e.statePath,`${JSON.stringify(n.data,void 0,2)}\n`)},Kg=/^\d+\.\d+\.\d+$/u,qg=/^0+(?=\d)/u,Jg=(e,t)=>{let n=e.replace(qg,``),r=t.replace(qg,``);return n.length===r.length?n===r?0:n<r?-1:1:n.length<r.length?-1:1},Yg=(e,t)=>{if(!Kg.test(e)||!Kg.test(t))return;let n=e.split(`.`),r=t.split(`.`);return n.map((e,t)=>Jg(e,r[t]??``)).find(e=>e!==0)??0},Xg=sc({version:P().regex(Kg)}),Zg=I({checked_at:Vc(),latest_version:P().regex(Kg)}),Qg=async e=>{try{let t=Zg.safeParse(JSON.parse(await s(e.updateCachePath,`utf8`)));return t.success?t.data:void 0}catch{return}},$g=async(e,t)=>{try{await p(e.root),await $l(e.updateCachePath,`${JSON.stringify(t,void 0,2)}\n`)}catch{}},e_=(e,t)=>{let n=t-Date.parse(e.checked_at);return n>=0&&n<864e5},t_=async e=>{try{let t=await e(`https://registry.npmjs.org/@kaisers-io%2Frefs/latest`,{signal:AbortSignal.timeout(2e3)});if(t.status!==200)return;let n=Xg.safeParse(await t.json());return n.success?n.data.version:void 0}catch{return}},n_=async e=>{let t=await Qg(e.home);if(t!==void 0&&e_(t,e.nowMs))return{latest:t.latest_version,refreshed:!1,stale:!1};let n=await t_(e.fetch);return n===void 0?{latest:t?.latest_version,refreshed:!1,stale:!0}:(await $g(e.home,{checked_at:new Date(e.nowMs).toISOString(),latest_version:n}),{latest:n,refreshed:!0,stale:!1})},r_=(e,t)=>{let n=Yg(e,t);return n!==void 0&&n<0},i_=(e,t)=>`refs ${t} is available (this is ${e}) — update: npm i -g @kaisers-io/refs@latest`,a_=e=>{let t=e.REFS_UPDATE_CHECK?.trim();if(t===`0`)return!1;if(t===`1`)return!0},o_=e=>{let t=e.CI?.trim().toLowerCase();return t!==void 0&&t!==``&&t!==`false`&&t!==`0`},s_={check:!0,notify:!0},c_=e=>{let t=a_(e.env);return t===void 0?(e.updates??s_).check?o_(e.env)?`ci`:`on`:`config`:t?`on`:`env`},l_=e=>c_(e)===`on`,u_=e=>l_(e)&&(e.updates??s_).notify,d_=async(e,t)=>{let n=await H(e,m(t,`package.json`));if(n.kind===`inside`)try{let e=JSON.parse(await s(n.real,`utf8`));return{name:Iu(e)}}catch{return}},f_=async(e,t)=>{let n=await d_(e,m(e,t));if(n===void 0)return{diagnostic:{kind:`manifest_unreadable`,path:t}};let r=Uh(t,n);return r===void 0?{diagnostic:{kind:`manifest_missing_name`,path:t}}:{pkg:r}},p_=e=>{let t=[],n=[];for(let r of e)r.diagnostic!==void 0&&t.push(r.diagnostic),r.pkg!==void 0&&n.push(r.pkg);return{diagnostics:t,packages:n}},m_=new Set([`ENOENT`,`ENOTDIR`]),h_=async(e,t)=>{let n=await H(e,m(t,`package.json`));if(n.kind===`missing`)return`none`;if(n.kind!==`inside`)return`rejected`;try{return await s(n.real,`utf8`),`manifest`}catch{return`rejected`}},g_=async e=>{try{return{entries:await c(e,{withFileTypes:!0})}}catch(e){return{code:e.code??``}}},__=e=>Promise.all(e.entries.map(t=>h_(e.repoDir,m(e.fullPath,t.name,e.suffix)))),v_=(e,t,n)=>e.filter((e,r)=>n(t[r])).map(e=>e.name),y_=async e=>{let{baseDir:t,dirs:n,fullPath:r,repoDir:i,suffix:a,symlinks:o}=e,s=e=>oe.join(t===`.`?``:t,e,a),[c,l]=await Promise.all([__({entries:n,fullPath:r,repoDir:i,suffix:a}),__({entries:o,fullPath:r,repoDir:i,suffix:a})]);return{diagnostics:[...v_(n,c,e=>e===`rejected`).map(e=>({kind:`manifest_unreadable`,path:s(e)})),...v_(o,l,e=>e!==`none`).map(e=>({kind:`candidate_not_inspected`,path:s(e)}))],dirs:v_(n,c,e=>e===`manifest`).map(e=>s(e))}},b_=async e=>{let t=await f_(e,`.`);return`pkg`in t?[t]:[]},x_=e=>{let t=e.find(e=>e.path===`.`);return t===void 0?[...e]:e.some(e=>e.path!==`.`&&e.name===t.name)?e.filter(e=>e!==t):[...e]},S_=async e=>{let[t]=await b_(e);return t!==void 0&&`pkg`in t?t.pkg:void 0},C_=`package.json`,w_=e=>{let t=Lh(e).split(`/`);return t.includes(`**`)?void 0:t.length},T_=e=>Lh(e).split(`/`).some(e=>e.startsWith(`.`)),E_=e=>e===`.`?0:e.split(`/`).length,D_=e=>{let t=Lh(e),n=new Th(`${t}/${C_}`),r=new Th(t);return{couldHold:e=>r.match(e,!0),selects:e=>n.match(oe.join(e,C_))}},O_=e=>({...D_(e),maxDepth:w_(e),selectsHidden:T_(e)}),k_=new Set([`ENOENT`,`ENOTDIR`]),A_=new Set([`.git`,`node_modules`]),j_=e=>e.some(e=>e.name.toLowerCase()===`package.json`&&!e.isDirectory()),M_=e=>e.some(e=>e.isSymbolicLink()&&!A_.has(e.name)),N_=async(e,t)=>{let n=await g_(t);return`code`in n?{answer:k_.has(n.code)}:(e.budget.entries-=n.entries.length,e.budget.entries<0||j_(n.entries)||M_(n.entries)?{answer:!1}:{entries:n.entries})},P_=async(e,t,n)=>{if(e.budget.dirs<=0||n>32)return!1;--e.budget.dirs;let r=await N_(e,t);return`answer`in r?r.answer:F_(e,{dir:t,entries:r.entries},n)},F_=async(e,t,n)=>{let r=t.entries.filter(e=>e.isDirectory()&&!A_.has(e.name));for(let i of r)if(!await P_(e,m(t.dir,i.name),n+1))return!1;return!0},I_=async(e,t)=>{let n=await H(e.repoDir,m(e.repoDir,t));if(n.kind!==`outside`&&n.kind!==`missing`){if(n.kind===`unreadable`){e.diagnostics.push({kind:`candidate_not_inspected`,path:t});return}await P_(e,n.real,1)||e.diagnostics.push({kind:`candidate_not_inspected`,path:t})}},L_=()=>({dirs:2e4,entries:2e5}),R_=new Set([`.git`,`node_modules`]),z_=(e,t)=>{e.diagnostics.push({kind:`scan_budget_exhausted`,path:t,pattern:e.pattern})},B_=async(e,t,n)=>{if(!e.selects(t)||n.has(t))return;let r=await h_(e.repoDir,m(e.repoDir,t));r===`manifest`&&e.dirs.push(t),r===`rejected`&&e.diagnostics.push({kind:`manifest_unreadable`,path:t})},V_=(e,t)=>!e.selectsHidden&&t.excluded.coversSubtree(t.relPath),H_=async(e,t,n)=>!e.couldHold(n.relPath)||R_.has(t.name)||V_(e,n)?!1:t.isSymbolicLink()?(V_(e,n)||await I_(e,n.relPath),!1):t.isDirectory(),U_=async(e,t)=>{let n=await g_(m(e.repoDir,t));if(`code`in n){m_.has(n.code)||e.diagnostics.push({kind:`workspace_dir_unreadable`,path:t});return}if(e.budget.entries-=n.entries.length,e.budget.entries<0){z_(e,t);return}return n.entries},W_=async(e,t,n)=>{if(e.budget.dirs<=0){z_(e,t.relPath);return}if(--e.budget.dirs,await B_(e,t.relPath,n),e.maxDepth!==void 0&&E_(t.relPath)>=e.maxDepth)return;let r=await U_(e,t.relPath);r!==void 0&&await K_(e,{depth:t.depth,entries:r,relPath:t.relPath},n)},G_=(e,t)=>oe.join(e===`.`?``:e,t),K_=async(e,t,n)=>{for(let r of t.entries){let i=G_(t.relPath,r.name);await H_(e,r,{excluded:n,relPath:i})&&(t.depth+1>32?z_(e,i):await W_(e,{depth:t.depth+1,relPath:i},n))}},q_=async(e,t)=>{let n=await H(e,m(e,t));if(n.kind!==`inside`)return n.kind===`missing`?{diagnostics:[],dirs:[]}:{diagnostics:[{kind:`workspace_dir_unreadable`,path:t}],dirs:[]}},J_=async(e,t,n)=>{let r=await q_(e,t.baseDir);if(r!==void 0)return r;let i={...O_(t.pattern),budget:n.budget,diagnostics:[],dirs:[],pattern:t.pattern,repoDir:e};return await W_(i,{depth:1,relPath:t.baseDir},n.excluded),{diagnostics:i.diagnostics,dirs:i.dirs}},Y_=(e,t)=>oe.join(e.baseDir===`.`?``:e.baseDir,t,e.suffix),X_=(e,t)=>Ih(Y_(t,e.name),t.pattern),Z_=async(e,t)=>{let n=m(e,t),r=await H(e,n);if(r.kind===`missing`)return{result:{diagnostics:[],dirs:[]}};if(r.kind!==`inside`)return{result:{diagnostics:[{kind:`workspace_dir_unreadable`,path:t}],dirs:[]}};let i=await g_(n);return`code`in i?{result:m_.has(i.code)?{diagnostics:[],dirs:[]}:{diagnostics:[{kind:`workspace_dir_unreadable`,path:t}],dirs:[]}}:{entries:i.entries}},Q_=async(e,t,n)=>{let{baseDir:r}=t,i=await Z_(e,r);if(`result`in i)return i.result;let a=e=>X_(e,t)&&!n.has(Y_(t,e.name)),o={entries:i.entries};return y_({baseDir:r,dirs:o.entries.filter(e=>e.isDirectory()&&a(e)),fullPath:m(e,r),repoDir:e,suffix:t.suffix,symlinks:o.entries.filter(e=>e.isSymbolicLink()&&a(e))})},$_=async(e,t)=>{let n=await h_(e,m(e,t));return n===`manifest`?{diagnostics:[],dirs:[Lh(t)]}:n===`rejected`?{diagnostics:[{kind:`manifest_unreadable`,path:t}],dirs:[]}:{diagnostics:[],dirs:[]}},ev=(e,t,n)=>{let{excluded:r}=n,i=Vh(t.body);return i.kind===`expand-children`?Q_(e,i,r):i.kind===`expand-recursive`?J_(e,i,n):i.kind===`probe-dir`?r.has(Lh(i.dir))?Promise.resolve({diagnostics:[],dirs:[]}):$_(e,i.dir):Promise.resolve({diagnostics:[{kind:`unsupported_pattern`,pattern:t.declared}],dirs:[]})},tv=(e,t)=>Ih(Nh(e),Nh(t)),nv=e=>({negations:e.filter(e=>Mh(e)),patterns:e.filter(e=>!Mh(e))}),rv=e=>{let t=e.reduce((e,t)=>Mh(t)?{negations:[...e.negations,t],patterns:e.patterns}:{negations:e.negations.filter(e=>!tv(t,e)),patterns:[...e.patterns,t]},{negations:[],patterns:[]});return{negations:t.negations,patterns:t.patterns.filter(e=>!t.negations.some(t=>tv(e,t)))}},iv=e=>e.endsWith(`/`)?e:`${e}/`,av=(e,t)=>e.some(e=>Ih(iv(t),iv(Nh(e)))),ov=(e,t)=>{let n=Nh(e);return n.endsWith(`/**`)&&Ih(t,n.slice(0,-3))},sv=e=>({coversSubtree:t=>e.some(e=>ov(e,t)),has:t=>av(e,t)}),cv=e=>{let t=new Set,n=[];for(let r of e)r.dirs.forEach(e=>t.add(e)),n.push(...r.diagnostics);return{diagnostics:n,dirs:[...t]}},lv=async(e,t,n)=>{let{negations:r,patterns:i}=t,a=sv(r),o=cv(await Promise.all(i.map(t=>ev(e,{body:Nh(t),declared:t},{budget:n,excluded:a}))));return{diagnostics:o.diagnostics,dirs:o.dirs}},uv=async(e,t)=>{let n=rv(t.npm),r=nv(t.pnpm),i=L_(),a=await Promise.all([lv(e,n,i),lv(e,r,i)]);return cv(a)},dv=async e=>{let t=await Uu(e);if(t.npm.length===0&&t.pnpm.length===0)return{diagnostics:Yh([...t.diagnostics,{kind:`no_workspace_declaration`}]),packages:[]};let n=await uv(e,t),[r,i]=await Promise.all([b_(e),Promise.all(n.dirs.map(t=>f_(e,t)))]),a=p_([...r,...i]);return{diagnostics:Yh([...t.diagnostics,...n.diagnostics,...a.diagnostics]),packages:x_(Wh(a.packages))}},fv=()=>{},pv={stop:fv,update:fv},mv={frames:[`⠋`,`⠙`,`⠹`,`⠸`,`⠼`,`⠴`,`⠦`,`⠧`,`⠇`,`⠏`],interval:80},hv={frames:[`-`,`\\`,`|`,`/`],interval:130},gv=`\r\x1B[K`,_v={24:`\x1B[38;2;7;210;86m`,4:`\x1B[32m`,8:`\x1B[38;5;41m`},vv=/[^ -~]/gu,yv=(e,t)=>t.isTTY===!0&&e.TERM!==`dumb`&&!o_(e)&&e.REFS_PROGRESS?.trim()!==`0`,bv=new Set([`alacritty`,`rxvt-unicode`,`rxvt-unicode-256color`,`xterm-256color`]),xv=(e,t)=>t===`win32`?!!e.WT_SESSION||!!e.TERMINUS_SUBLIME||e.ConEmuTask===`{cmd::Cmder}`||e.TERM_PROGRAM===`Terminus-Sublime`||e.TERM_PROGRAM===`vscode`||e.TERMINAL_EMULATOR===`JetBrains-JediTerm`||bv.has(e.TERM??``):e.TERM!==`linux`,Sv=(e,t)=>e.replaceAll(vv,`?`).slice(0,Math.max(0,t)),Cv=(e,t,n)=>{let r=(e.stream.columns??80)-3,i=_v[e.stream.getColorDepth?.(e.env)??1],a=i===void 0?t:`${i}${t}[39m`;return`${gv}${a} ${Sv(n,r)}`},wv=e=>{if(!yv(e.env,e.stream))return pv;let{frames:t,interval:n}=xv(e.env,e.platform)?mv:hv,r={drawn:!1,index:0,stopped:!1,text:``},i=()=>{e.stream.write(Cv(e,t[r.index%t.length]??``,r.text)),r.drawn=!0,r.index+=1},a={},o=()=>{i(),a.ticker=setInterval(i,n).unref()};return{stop:()=>{r.stopped=!0,clearTimeout(a.delay),clearInterval(a.ticker),r.drawn&&=(e.stream.write(gv),!1)},update:e=>{r.stopped||(r.text=e,a.delay??=setTimeout(o,100).unref())}}};var Tv=`0.17.0`;const Ev=async()=>{let e=[];for await(let t of process.stdin)e.push(Buffer.from(t));return Buffer.concat(e).toString(`utf8`)},Dv=()=>{try{return he()}catch{return``}},Ov=()=>({cliVersion:Tv,cwd:process.cwd(),env:process.env,errLine:e=>{process.stderr.write(`${e}\n`)},fetcher:(e,t)=>fetch(e,t),homedir:Dv(),nodeVersion:process.version,out:e=>{process.stdout.write(`${e}\n`)},readStdin:Ev,runner:new wg,spinner:()=>wv({env:process.env,platform:process.platform,stream:process.stderr})});var kv=class extends Error{constructor(e,t,n){super(n),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name,this.code=t,this.exitCode=e,this.nestedError=void 0}},Av=class extends kv{constructor(e){super(1,`commander.invalidArgument`,e),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name}},jv=class{constructor(e,t){switch(this.description=t||``,this.variadic=!1,this.parseArg=void 0,this.defaultValue=void 0,this.defaultValueDescription=void 0,this.argChoices=void 0,e[0]){case`<`:this.required=!0,this._name=e.slice(1,-1);break;case`[`:this.required=!1,this._name=e.slice(1,-1);break;default:this.required=!0,this._name=e}this._name.endsWith(`...`)&&(this.variadic=!0,this._name=this._name.slice(0,-3))}name(){return this._name}_collectValue(e,t){return t===this.defaultValue||!Array.isArray(t)?[e]:(t.push(e),t)}default(e,t){return this.defaultValue=e,this.defaultValueDescription=t,this}argParser(e){return this.parseArg=e,this}choices(e){return this.argChoices=e.slice(),this.parseArg=(e,t)=>{if(!this.argChoices.includes(e))throw new Av(`Allowed choices are ${this.argChoices.join(`, `)}.`);return this.variadic?this._collectValue(e,t):e},this}argRequired(){return this.required=!0,this}argOptional(){return this.required=!1,this}};function Mv(e){let t=e.name()+(e.variadic===!0?`...`:``);return e.required?`<`+t+`>`:`[`+t+`]`}var Nv=class{constructor(){this.helpWidth=void 0,this.minWidthToWrap=40,this.sortSubcommands=!1,this.sortOptions=!1,this.showGlobalOptions=!1}prepareContext(e){this.helpWidth=this.helpWidth??e.helpWidth??80}visibleCommands(e){let t=e.commands.filter(e=>!e._hidden),n=e._getHelpCommand();return n&&!n._hidden&&t.push(n),this.sortSubcommands&&t.sort((e,t)=>e.name().localeCompare(t.name())),t}compareOptions(e,t){let n=e=>e.short?e.short.replace(/^-/,``):e.long.replace(/^--/,``);return n(e).localeCompare(n(t))}visibleOptions(e){let t=e.options.filter(e=>!e.hidden),n=e._getHelpOption();if(n&&!n.hidden){let r=n.short&&e._findOption(n.short),i=n.long&&e._findOption(n.long);!r&&!i?t.push(n):n.long&&!i?t.push(e.createOption(n.long,n.description)):n.short&&!r&&t.push(e.createOption(n.short,n.description))}return this.sortOptions&&t.sort(this.compareOptions),t}visibleGlobalOptions(e){if(!this.showGlobalOptions)return[];let t=[];for(let n=e.parent;n;n=n.parent){let e=n.options.filter(e=>!e.hidden);t.push(...e)}return this.sortOptions&&t.sort(this.compareOptions),t}visibleArguments(e){return e._argsDescription&&e.registeredArguments.forEach(t=>{t.description=t.description||e._argsDescription[t.name()]||``}),e.registeredArguments.find(e=>e.description)?e.registeredArguments:[]}subcommandTerm(e){let t=e.registeredArguments.map(e=>Mv(e)).join(` `);return e._name+(e._aliases[0]?`|`+e._aliases[0]:``)+(e.options.length?` [options]`:``)+(t?` `+t:``)}optionTerm(e){return e.flags}argumentTerm(e){return e.name()}longestSubcommandTermLength(e,t){return t.visibleCommands(e).reduce((e,n)=>Math.max(e,this.displayWidth(t.styleSubcommandTerm(t.subcommandTerm(n)))),0)}longestOptionTermLength(e,t){return t.visibleOptions(e).reduce((e,n)=>Math.max(e,this.displayWidth(t.styleOptionTerm(t.optionTerm(n)))),0)}longestGlobalOptionTermLength(e,t){return t.visibleGlobalOptions(e).reduce((e,n)=>Math.max(e,this.displayWidth(t.styleOptionTerm(t.optionTerm(n)))),0)}longestArgumentTermLength(e,t){return t.visibleArguments(e).reduce((e,n)=>Math.max(e,this.displayWidth(t.styleArgumentTerm(t.argumentTerm(n)))),0)}commandUsage(e){let t=e._name;e._aliases[0]&&(t=t+`|`+e._aliases[0]);let n=``;for(let t=e.parent;t;t=t.parent)n=t.name()+` `+n;return n+t+` `+e.usage()}commandDescription(e){return e.description()}subcommandDescription(e){return e.summary()||e.description()}optionDescription(e){let t=[];if(e.argChoices&&t.push(`choices: ${e.argChoices.map(e=>JSON.stringify(e)).join(`, `)}`),e.defaultValue!==void 0&&(e.required||e.optional||e.isBoolean()&&typeof e.defaultValue==`boolean`)&&t.push(`default: ${e.defaultValueDescription||JSON.stringify(e.defaultValue)}`),e.presetArg!==void 0&&e.optional&&t.push(`preset: ${JSON.stringify(e.presetArg)}`),e.envVar!==void 0&&t.push(`env: ${e.envVar}`),t.length>0){let n=`(${t.join(`, `)})`;return e.description?`${e.description} ${n}`:n}return e.description}argumentDescription(e){let t=[];if(e.argChoices&&t.push(`choices: ${e.argChoices.map(e=>JSON.stringify(e)).join(`, `)}`),e.defaultValue!==void 0&&t.push(`default: ${e.defaultValueDescription||JSON.stringify(e.defaultValue)}`),t.length>0){let n=`(${t.join(`, `)})`;return e.description?`${e.description} ${n}`:n}return e.description}formatItemList(e,t,n){return t.length===0?[]:[n.styleTitle(e),...t,``]}groupItems(e,t,n){let r=new Map;return e.forEach(e=>{let t=n(e);r.has(t)||r.set(t,[])}),t.forEach(e=>{let t=n(e);r.has(t)||r.set(t,[]),r.get(t).push(e)}),r}formatHelp(e,t){let n=t.padWidth(e,t),r=t.helpWidth??80;function i(e,r){return t.formatItem(e,n,r,t)}let a=[`${t.styleTitle(`Usage:`)} ${t.styleUsage(t.commandUsage(e))}`,``],o=t.commandDescription(e);o.length>0&&(a=a.concat([t.boxWrap(t.styleCommandDescription(o),r),``]));let s=t.visibleArguments(e).map(e=>i(t.styleArgumentTerm(t.argumentTerm(e)),t.styleArgumentDescription(t.argumentDescription(e))));if(a=a.concat(this.formatItemList(`Arguments:`,s,t)),this.groupItems(e.options,t.visibleOptions(e),e=>e.helpGroupHeading??`Options:`).forEach((e,n)=>{let r=e.map(e=>i(t.styleOptionTerm(t.optionTerm(e)),t.styleOptionDescription(t.optionDescription(e))));a=a.concat(this.formatItemList(n,r,t))}),t.showGlobalOptions){let n=t.visibleGlobalOptions(e).map(e=>i(t.styleOptionTerm(t.optionTerm(e)),t.styleOptionDescription(t.optionDescription(e))));a=a.concat(this.formatItemList(`Global Options:`,n,t))}return this.groupItems(e.commands,t.visibleCommands(e),e=>e.helpGroup()||`Commands:`).forEach((e,n)=>{let r=e.map(e=>i(t.styleSubcommandTerm(t.subcommandTerm(e)),t.styleSubcommandDescription(t.subcommandDescription(e))));a=a.concat(this.formatItemList(n,r,t))}),a.join(`
|
|
329
329
|
`)}displayWidth(e){return xe(e).length}styleTitle(e){return e}styleUsage(e){return e.split(` `).map(e=>e===`[options]`?this.styleOptionText(e):e===`[command]`?this.styleSubcommandText(e):e[0]===`[`||e[0]===`<`?this.styleArgumentText(e):this.styleCommandText(e)).join(` `)}styleCommandDescription(e){return this.styleDescriptionText(e)}styleOptionDescription(e){return this.styleDescriptionText(e)}styleSubcommandDescription(e){return this.styleDescriptionText(e)}styleArgumentDescription(e){return this.styleDescriptionText(e)}styleDescriptionText(e){return e}styleOptionTerm(e){return this.styleOptionText(e)}styleSubcommandTerm(e){return e.split(` `).map(e=>e===`[options]`?this.styleOptionText(e):e[0]===`[`||e[0]===`<`?this.styleArgumentText(e):this.styleSubcommandText(e)).join(` `)}styleArgumentTerm(e){return this.styleArgumentText(e)}styleOptionText(e){return e}styleArgumentText(e){return e}styleSubcommandText(e){return e}styleCommandText(e){return e}padWidth(e,t){return Math.max(t.longestOptionTermLength(e,t),t.longestGlobalOptionTermLength(e,t),t.longestSubcommandTermLength(e,t),t.longestArgumentTermLength(e,t))}preformatted(e){return/\n[^\S\r\n]/.test(e)}formatItem(e,t,n,r){let i=` `.repeat(2);if(!n)return i+e;let a=e.padEnd(t+e.length-r.displayWidth(e)),o=(this.helpWidth??80)-t-2-2,s;return s=o<this.minWidthToWrap||r.preformatted(n)?n:r.boxWrap(n,o).replace(/\n/g,`
|
|
330
330
|
`+` `.repeat(t+2)),i+a+` `.repeat(2)+s.replace(/\n/g,`\n${i}`)}boxWrap(e,t){if(t<this.minWidthToWrap)return e;let n=e.split(/\r\n|\n/),r=/[\s]*[^\s]+/g,i=[];return n.forEach(e=>{let n=e.match(r);if(n===null){i.push(``);return}let a=[n.shift()],o=this.displayWidth(a[0]);n.forEach(e=>{let n=this.displayWidth(e);if(o+n<=t){a.push(e),o+=n;return}i.push(a.join(``));let r=e.trimStart();a=[r],o=this.displayWidth(r)}),i.push(a.join(``))}),i.join(`
|
|
331
|
-
`)}},
|
|
331
|
+
`)}},Pv=class{constructor(e,t){this.flags=e,this.description=t||``,this.required=e.includes(`<`),this.optional=e.includes(`[`),this.variadic=/\w\.\.\.[>\]]$/.test(e),this.mandatory=!1;let n=Lv(e);this.short=n.shortFlag,this.long=n.longFlag,this.negate=!1,this.long&&(this.negate=this.long.startsWith(`--no-`)),this.defaultValue=void 0,this.defaultValueDescription=void 0,this.presetArg=void 0,this.envVar=void 0,this.parseArg=void 0,this.hidden=!1,this.argChoices=void 0,this.conflictsWith=[],this.implied=void 0,this.helpGroupHeading=void 0}default(e,t){return this.defaultValue=e,this.defaultValueDescription=t,this}preset(e){return this.presetArg=e,this}conflicts(e){return this.conflictsWith=this.conflictsWith.concat(e),this}implies(e){let t=e;return typeof e==`string`&&(t={[e]:!0}),this.implied=Object.assign(this.implied||{},t),this}env(e){return this.envVar=e,this}argParser(e){return this.parseArg=e,this}makeOptionMandatory(e=!0){return this.mandatory=!!e,this}hideHelp(e=!0){return this.hidden=!!e,this}_collectValue(e,t){return t===this.defaultValue||!Array.isArray(t)?[e]:(t.push(e),t)}choices(e){return this.argChoices=e.slice(),this.parseArg=(e,t)=>{if(!this.argChoices.includes(e))throw new Av(`Allowed choices are ${this.argChoices.join(`, `)}.`);return this.variadic?this._collectValue(e,t):e},this}name(){return this.long?this.long.replace(/^--/,``):this.short.replace(/^-/,``)}attributeName(){return this.negate?Iv(this.name().replace(/^no-/,``)):Iv(this.name())}helpGroup(e){return this.helpGroupHeading=e,this}is(e){return this.short===e||this.long===e}isBoolean(){return!this.required&&!this.optional&&!this.negate}},Fv=class{constructor(e){this.positiveOptions=new Map,this.negativeOptions=new Map,this.dualOptions=new Set,e.forEach(e=>{e.negate?this.negativeOptions.set(e.attributeName(),e):this.positiveOptions.set(e.attributeName(),e)}),this.negativeOptions.forEach((e,t)=>{this.positiveOptions.has(t)&&this.dualOptions.add(t)})}valueFromOption(e,t){let n=t.attributeName();if(!this.dualOptions.has(n))return!0;let r=this.negativeOptions.get(n).presetArg,i=r!==void 0&&r;return t.negate===(i===e)}};function Iv(e){return e.split(`-`).reduce((e,t)=>e+t[0].toUpperCase()+t.slice(1))}function Lv(e){let t,n,r=/^-[^-]$/,i=/^--[^-]/,a=e.split(/[ |,]+/).concat(`guard`);if(r.test(a[0])&&(t=a.shift()),i.test(a[0])&&(n=a.shift()),!t&&r.test(a[0])&&(t=a.shift()),!t&&i.test(a[0])&&(t=n,n=a.shift()),a[0].startsWith(`-`)){let t=a[0],n=`option creation failed due to '${t}' in option flags '${e}'`;throw/^-[^-][^-]/.test(t)?Error(`${n}
|
|
332
332
|
- a short flag is a single dash and a single character
|
|
333
333
|
- either use a single dash and a single character (for a short flag)
|
|
334
334
|
- or use a double dash for a long option (and can have two, like '--ws, --workspace')`):r.test(t)?Error(`${n}
|
|
335
335
|
- too many short flags`):i.test(t)?Error(`${n}
|
|
336
336
|
- too many long flags`):Error(`${n}
|
|
337
|
-
- unrecognised flag format`)}if(t===void 0&&n===void 0)throw Error(`option creation failed due to no flags found in '${e}'.`);return{shortFlag:t,longFlag:n}}function
|
|
338
|
-
- specify the name in Command constructor or using .name()`);return t||={},t.isDefault&&(this._defaultCommandName=e._name),(t.noHelp||t.hidden)&&(e._hidden=!0),this._registerCommand(e),e.parent=this,e._checkForBrokenPassThrough(),this}createArgument(e,t){return new
|
|
339
|
-
Expecting one of '${n.join(`', '`)}'`);return this._lifeCycleHooks[e]?this._lifeCycleHooks[e].push(t):this._lifeCycleHooks[e]=[t],this}exitOverride(e){return this._exitCallback=e||(e=>{if(e.code!==`commander.executeSubCommandAsync`)throw e}),this}_exit(e,t,n){this._exitCallback&&this._exitCallback(new
|
|
340
|
-
- already used by option '${t.flags}'`)}this._initOptionGroup(e),this.options.push(e)}_registerCommand(e){let t=e=>[e.name()].concat(e.aliases()),n=t(e).find(e=>this._findCommand(e));if(n){let r=t(this._findCommand(n)).join(`|`),i=t(e).join(`|`);throw Error(`cannot add command '${i}' as already have command '${r}'`)}this._initCommandGroup(e),this.commands.push(e)}addOption(e){this._registerOption(e);let t=e.name(),n=e.attributeName();e.defaultValue!==void 0&&this.setOptionValueWithSource(n,e.defaultValue,`default`);let r=(t,r,i)=>{t==null&&e.presetArg!==void 0&&(t=e.presetArg);let a=this.getOptionValue(n);t!==null&&e.parseArg?t=this._callParseArg(e,t,a,r):t!==null&&e.variadic&&(t=e._collectValue(t,a)),t??=e.negate?!1:e.isBoolean()||e.optional?!0:``,this.setOptionValueWithSource(n,t,i)};return this.on(`option:`+t,t=>{let n=`error: option '${e.flags}' argument '${t}' is invalid.`;r(t,n,`cli`)}),e.envVar&&this.on(`optionEnv:`+t,t=>{let n=`error: option '${e.flags}' value '${t}' from env '${e.envVar}' is invalid.`;r(t,n,`env`)}),this}_optionEx(e,t,n,r,i){if(typeof t==`object`&&t instanceof
|
|
337
|
+
- unrecognised flag format`)}if(t===void 0&&n===void 0)throw Error(`option creation failed due to no flags found in '${e}'.`);return{shortFlag:t,longFlag:n}}function Rv(e,t){if(Math.abs(e.length-t.length)>3)return Math.max(e.length,t.length);let n=[];for(let t=0;t<=e.length;t++)n[t]=[t];for(let e=0;e<=t.length;e++)n[0][e]=e;for(let r=1;r<=t.length;r++)for(let i=1;i<=e.length;i++){let a;a=e[i-1]===t[r-1]?0:1,n[i][r]=Math.min(n[i-1][r]+1,n[i][r-1]+1,n[i-1][r-1]+a),i>1&&r>1&&e[i-1]===t[r-2]&&e[i-2]===t[r-1]&&(n[i][r]=Math.min(n[i][r],n[i-2][r-2]+1))}return n[e.length][t.length]}function zv(e,t){if(!t||t.length===0)return``;t=Array.from(new Set(t));let n=e.startsWith(`--`);n&&(e=e.slice(2),t=t.map(e=>e.slice(2)));let r=[],i=3;return t.forEach(t=>{if(t.length<=1)return;let n=Rv(e,t),a=Math.max(e.length,t.length);(a-n)/a>.4&&(n<i?(i=n,r=[t]):n===i&&r.push(t))}),r.sort((e,t)=>e.localeCompare(t)),n&&(r=r.map(e=>`--${e}`)),r.length>1?`\n(Did you mean one of ${r.join(`, `)}?)`:r.length===1?`\n(Did you mean ${r[0]}?)`:``}var Bv=class e extends _e{constructor(e){super(),this.commands=[],this.options=[],this.parent=null,this._allowUnknownOption=!1,this._allowExcessArguments=!1,this.registeredArguments=[],this._args=this.registeredArguments,this.args=[],this.rawArgs=[],this.processedArgs=[],this._scriptPath=null,this._name=e||``,this._optionValues={},this._optionValueSources={},this._storeOptionsAsProperties=!1,this._actionHandler=null,this._executableHandler=!1,this._executableFile=null,this._executableDir=null,this._defaultCommandName=null,this._exitCallback=null,this._aliases=[],this._combineFlagAndOptionalValue=!0,this._description=``,this._summary=``,this._argsDescription=void 0,this._enablePositionalOptions=!1,this._passThroughOptions=!1,this._lifeCycleHooks={},this._showHelpAfterError=!1,this._showSuggestionAfterError=!0,this._savedState=null,this._outputConfiguration={writeOut:e=>h.stdout.write(e),writeErr:e=>h.stderr.write(e),outputError:(e,t)=>t(e),getOutHelpWidth:()=>h.stdout.isTTY?h.stdout.columns:void 0,getErrHelpWidth:()=>h.stderr.isTTY?h.stderr.columns:void 0,getOutHasColors:()=>Hv()??(h.stdout.isTTY&&h.stdout.hasColors?.()),getErrHasColors:()=>Hv()??(h.stderr.isTTY&&h.stderr.hasColors?.()),stripColor:e=>xe(e)},this._hidden=!1,this._helpOption=void 0,this._addImplicitHelpCommand=void 0,this._helpCommand=void 0,this._helpConfiguration={},this._helpGroupHeading=void 0,this._defaultCommandGroup=void 0,this._defaultOptionGroup=void 0}copyInheritedSettings(e){return this._outputConfiguration=e._outputConfiguration,this._helpOption=e._helpOption,this._helpCommand=e._helpCommand,this._helpConfiguration=e._helpConfiguration,this._exitCallback=e._exitCallback,this._storeOptionsAsProperties=e._storeOptionsAsProperties,this._combineFlagAndOptionalValue=e._combineFlagAndOptionalValue,this._allowExcessArguments=e._allowExcessArguments,this._enablePositionalOptions=e._enablePositionalOptions,this._showHelpAfterError=e._showHelpAfterError,this._showSuggestionAfterError=e._showSuggestionAfterError,this}_getCommandAndAncestors(){let e=[];for(let t=this;t;t=t.parent)e.push(t);return e}command(e,t,n){let r=t,i=n;typeof r==`object`&&r&&(i=r,r=null),i||={};let[,a,o]=e.match(/([^ ]+) *(.*)/),s=this.createCommand(a);return r&&(s.description(r),s._executableHandler=!0),i.isDefault&&(this._defaultCommandName=s._name),s._hidden=!!(i.noHelp||i.hidden),s._executableFile=i.executableFile||null,o&&s.arguments(o),this._registerCommand(s),s.parent=this,s.copyInheritedSettings(this),r?this:s}createCommand(t){return new e(t)}createHelp(){return Object.assign(new Nv,this.configureHelp())}configureHelp(e){return e===void 0?this._helpConfiguration:(this._helpConfiguration=e,this)}configureOutput(e){return e===void 0?this._outputConfiguration:(this._outputConfiguration={...this._outputConfiguration,...e},this)}showHelpAfterError(e=!0){return typeof e!=`string`&&(e=!!e),this._showHelpAfterError=e,this}showSuggestionAfterError(e=!0){return this._showSuggestionAfterError=!!e,this}addCommand(e,t){if(!e._name)throw Error(`Command passed to .addCommand() must have a name
|
|
338
|
+
- specify the name in Command constructor or using .name()`);return t||={},t.isDefault&&(this._defaultCommandName=e._name),(t.noHelp||t.hidden)&&(e._hidden=!0),this._registerCommand(e),e.parent=this,e._checkForBrokenPassThrough(),this}createArgument(e,t){return new jv(e,t)}argument(e,t,n,r){let i=this.createArgument(e,t);return typeof n==`function`?i.default(r).argParser(n):i.default(n),this.addArgument(i),this}arguments(e){return e.trim().split(/ +/).forEach(e=>{this.argument(e)}),this}addArgument(e){let t=this.registeredArguments.slice(-1)[0];if(t?.variadic)throw Error(`only the last argument can be variadic '${t.name()}'`);if(e.required&&e.defaultValue!==void 0&&e.parseArg===void 0)throw Error(`a default value for a required argument is never used: '${e.name()}'`);return this.registeredArguments.push(e),this}helpCommand(e,t){if(typeof e==`boolean`)return this._addImplicitHelpCommand=e,e&&this._defaultCommandGroup&&this._initCommandGroup(this._getHelpCommand()),this;let[,n,r]=(e??`help [command]`).match(/([^ ]+) *(.*)/),i=t??`display help for command`,a=this.createCommand(n);return a.helpOption(!1),r&&a.arguments(r),i&&a.description(i),this._addImplicitHelpCommand=!0,this._helpCommand=a,(e||t)&&this._initCommandGroup(a),this}addHelpCommand(e,t){return typeof e==`object`?(this._addImplicitHelpCommand=!0,this._helpCommand=e,this._initCommandGroup(e),this):(this.helpCommand(e,t),this)}_getHelpCommand(){return this._addImplicitHelpCommand??(this.commands.length&&!this._actionHandler&&!this._findCommand(`help`))?(this._helpCommand===void 0&&this.helpCommand(void 0,void 0),this._helpCommand):null}hook(e,t){let n=[`preSubcommand`,`preAction`,`postAction`];if(!n.includes(e))throw Error(`Unexpected value for event passed to hook : '${e}'.
|
|
339
|
+
Expecting one of '${n.join(`', '`)}'`);return this._lifeCycleHooks[e]?this._lifeCycleHooks[e].push(t):this._lifeCycleHooks[e]=[t],this}exitOverride(e){return this._exitCallback=e||(e=>{if(e.code!==`commander.executeSubCommandAsync`)throw e}),this}_exit(e,t,n){this._exitCallback&&this._exitCallback(new kv(e,t,n)),h.exit(e)}action(e){let t=t=>{let n=this.registeredArguments.length,r=t.slice(0,n);return r[n]=this._storeOptionsAsProperties?this:this.opts(),r.push(this),e.apply(this,r)};return this._actionHandler=t,this}createOption(e,t){return new Pv(e,t)}_callParseArg(e,t,n,r){try{return e.parseArg(t,n)}catch(e){if(e.code===`commander.invalidArgument`){let t=`${r} ${e.message}`;this.error(t,{exitCode:e.exitCode,code:e.code})}throw e}}_registerOption(e){let t=e.short&&this._findOption(e.short)||e.long&&this._findOption(e.long);if(t){let n=e.long&&this._findOption(e.long)?e.long:e.short;throw Error(`Cannot add option '${e.flags}'${this._name&&` to command '${this._name}'`} due to conflicting flag '${n}'
|
|
340
|
+
- already used by option '${t.flags}'`)}this._initOptionGroup(e),this.options.push(e)}_registerCommand(e){let t=e=>[e.name()].concat(e.aliases()),n=t(e).find(e=>this._findCommand(e));if(n){let r=t(this._findCommand(n)).join(`|`),i=t(e).join(`|`);throw Error(`cannot add command '${i}' as already have command '${r}'`)}this._initCommandGroup(e),this.commands.push(e)}addOption(e){this._registerOption(e);let t=e.name(),n=e.attributeName();e.defaultValue!==void 0&&this.setOptionValueWithSource(n,e.defaultValue,`default`);let r=(t,r,i)=>{t==null&&e.presetArg!==void 0&&(t=e.presetArg);let a=this.getOptionValue(n);t!==null&&e.parseArg?t=this._callParseArg(e,t,a,r):t!==null&&e.variadic&&(t=e._collectValue(t,a)),t??=e.negate?!1:e.isBoolean()||e.optional?!0:``,this.setOptionValueWithSource(n,t,i)};return this.on(`option:`+t,t=>{let n=`error: option '${e.flags}' argument '${t}' is invalid.`;r(t,n,`cli`)}),e.envVar&&this.on(`optionEnv:`+t,t=>{let n=`error: option '${e.flags}' value '${t}' from env '${e.envVar}' is invalid.`;r(t,n,`env`)}),this}_optionEx(e,t,n,r,i){if(typeof t==`object`&&t instanceof Pv)throw Error(`To add an Option object use addOption() instead of option() or requiredOption()`);let a=this.createOption(t,n);if(a.makeOptionMandatory(!!e.mandatory),typeof r==`function`)a.default(i).argParser(r);else if(r instanceof RegExp){let e=r;r=(t,n)=>{let r=e.exec(t);return r?r[0]:n},a.default(i).argParser(r)}else a.default(r);return this.addOption(a)}option(e,t,n,r){return this._optionEx({},e,t,n,r)}requiredOption(e,t,n,r){return this._optionEx({mandatory:!0},e,t,n,r)}combineFlagAndOptionalValue(e=!0){return this._combineFlagAndOptionalValue=!!e,this}allowUnknownOption(e=!0){return this._allowUnknownOption=!!e,this}allowExcessArguments(e=!0){return this._allowExcessArguments=!!e,this}enablePositionalOptions(e=!0){return this._enablePositionalOptions=!!e,this}passThroughOptions(e=!0){return this._passThroughOptions=!!e,this._checkForBrokenPassThrough(),this}_checkForBrokenPassThrough(){if(this.parent&&this._passThroughOptions&&!this.parent._enablePositionalOptions)throw Error(`passThroughOptions cannot be used for '${this._name}' without turning on enablePositionalOptions for parent command(s)`)}storeOptionsAsProperties(e=!0){if(this.options.length)throw Error(`call .storeOptionsAsProperties() before adding options`);if(Object.keys(this._optionValues).length)throw Error(`call .storeOptionsAsProperties() before setting option values`);return this._storeOptionsAsProperties=!!e,this}getOptionValue(e){return this._storeOptionsAsProperties?this[e]:this._optionValues[e]}setOptionValue(e,t){return this.setOptionValueWithSource(e,t,void 0)}setOptionValueWithSource(e,t,n){return this._storeOptionsAsProperties?this[e]=t:this._optionValues[e]=t,this._optionValueSources[e]=n,this}getOptionValueSource(e){return this._optionValueSources[e]}getOptionValueSourceWithGlobals(e){let t;return this._getCommandAndAncestors().forEach(n=>{n.getOptionValueSource(e)!==void 0&&(t=n.getOptionValueSource(e))}),t}_prepareUserArgs(e,t){if(e!==void 0&&!Array.isArray(e))throw Error(`first parameter to parse must be array or undefined`);if(t||={},e===void 0&&t.from===void 0){h.versions?.electron&&(t.from=`electron`);let e=h.execArgv??[];(e.includes(`-e`)||e.includes(`--eval`)||e.includes(`-p`)||e.includes(`--print`))&&(t.from=`eval`)}e===void 0&&(e=h.argv),this.rawArgs=e.slice();let n;switch(t.from){case void 0:case`node`:this._scriptPath=e[1],n=e.slice(2);break;case`electron`:h.defaultApp?(this._scriptPath=e[1],n=e.slice(2)):n=e.slice(1);break;case`user`:n=e.slice(0);break;case`eval`:n=e.slice(1);break;default:throw Error(`unexpected parse option { from: '${t.from}' }`)}return!this._name&&this._scriptPath&&this.nameFromFilename(this._scriptPath),this._name=this._name||`program`,n}parse(e,t){this._prepareForParse();let n=this._prepareUserArgs(e,t);return this._parseCommand([],n),this}async parseAsync(e,t){this._prepareForParse();let n=this._prepareUserArgs(e,t);return await this._parseCommand([],n),this}_prepareForParse(){this._savedState===null?(this.options.filter(e=>e.negate&&e.defaultValue===void 0&&this.getOptionValue(e.attributeName())===void 0).forEach(e=>{let t=e.long.replace(/^--no-/,`--`);this._findOption(t)||this.setOptionValueWithSource(e.attributeName(),!0,`default`)}),this.saveStateBeforeParse()):this.restoreStateBeforeParse()}saveStateBeforeParse(){this._savedState={_name:this._name,_optionValues:{...this._optionValues},_optionValueSources:{...this._optionValueSources}}}restoreStateBeforeParse(){if(this._storeOptionsAsProperties)throw Error(`Can not call parse again when storeOptionsAsProperties is true.
|
|
341
341
|
- either make a new Command for each call to parse, or stop storing options as properties`);this._name=this._savedState._name,this._scriptPath=null,this.rawArgs=[],this._optionValues={...this._savedState._optionValues},this._optionValueSources={...this._savedState._optionValueSources},this.args=[],this.processedArgs=[]}_checkForMissingExecutable(e,t,n){if(fe.existsSync(e))return;let r=`'${e}' does not exist
|
|
342
342
|
- if '${n}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead
|
|
343
343
|
- if the default executable name is not suitable, use the executableFile option to supply a custom name or path
|
|
344
|
-
- ${t?`searched for local subcommand relative to directory '${t}'`:`no directory for search for local subcommand, use .executableDir() to supply a custom directory`}`;throw Error(r)}_executeSubCommand(e,t){t=t.slice();let n=[`.js`,`.ts`,`.tsx`,`.mjs`,`.cjs`];function r(e,t){let r=ne.resolve(e,t);if(fe.existsSync(r))return r;if(n.includes(ne.extname(t)))return;let i=n.find(e=>fe.existsSync(`${r}${e}`));if(i)return`${r}${i}`}this._checkForMissingMandatoryOptions(),this._checkForConflictingOptions();let i=e._executableFile||`${this._name}-${e._name}`,a=this._executableDir||``;if(this._scriptPath){let e;try{e=fe.realpathSync(this._scriptPath)}catch{e=this._scriptPath}a=ne.resolve(ne.dirname(e),a)}if(a){let t=r(a,i);if(!t&&!e._executableFile&&this._scriptPath){let n=ne.basename(this._scriptPath,ne.extname(this._scriptPath));n!==this._name&&(t=r(a,`${n}-${e._name}`))}i=t||i}let o=n.includes(ne.extname(i)),s;h.platform===`win32`?(this._checkForMissingExecutable(i,a,e._name),t.unshift(i),t=
|
|
345
|
-
`),this.outputHelp({error:!0}));let n=t||{},r=n.exitCode||1,i=n.code||`commander.error`;this._exit(r,i,e)}_parseOptionsEnv(){this.options.forEach(e=>{if(e.envVar&&e.envVar in h.env){let t=e.attributeName();(this.getOptionValue(t)===void 0||[`default`,`config`,`env`].includes(this.getOptionValueSource(t)))&&(e.required||e.optional?this.emit(`optionEnv:${e.name()}`,h.env[e.envVar]):this.emit(`optionEnv:${e.name()}`))}})}_parseOptionsImplied(){let e=new
|
|
346
|
-
Expecting one of '${n.join(`', '`)}'`);let r=`${e}Help`;return this.on(r,e=>{let n;n=typeof t==`function`?t({error:e.error,command:e.command}):t,n&&e.write(`${n}\n`)}),this}_outputHelpIfRequested(e){let t=this._getHelpOption();t&&e.find(e=>t.is(e))&&(this.outputHelp(),this._exit(0,`commander.helpDisplayed`,`(outputHelp)`))}};function
|
|
347
|
-
refs add ${
|
|
344
|
+
- ${t?`searched for local subcommand relative to directory '${t}'`:`no directory for search for local subcommand, use .executableDir() to supply a custom directory`}`;throw Error(r)}_executeSubCommand(e,t){t=t.slice();let n=[`.js`,`.ts`,`.tsx`,`.mjs`,`.cjs`];function r(e,t){let r=ne.resolve(e,t);if(fe.existsSync(r))return r;if(n.includes(ne.extname(t)))return;let i=n.find(e=>fe.existsSync(`${r}${e}`));if(i)return`${r}${i}`}this._checkForMissingMandatoryOptions(),this._checkForConflictingOptions();let i=e._executableFile||`${this._name}-${e._name}`,a=this._executableDir||``;if(this._scriptPath){let e;try{e=fe.realpathSync(this._scriptPath)}catch{e=this._scriptPath}a=ne.resolve(ne.dirname(e),a)}if(a){let t=r(a,i);if(!t&&!e._executableFile&&this._scriptPath){let n=ne.basename(this._scriptPath,ne.extname(this._scriptPath));n!==this._name&&(t=r(a,`${n}-${e._name}`))}i=t||i}let o=n.includes(ne.extname(i)),s;h.platform===`win32`?(this._checkForMissingExecutable(i,a,e._name),t.unshift(i),t=Vv(h.execArgv).concat(t),s=ye.spawn(h.execPath,t,{stdio:`inherit`})):o?(t.unshift(i),t=Vv(h.execArgv).concat(t),s=ye.spawn(h.argv[0],t,{stdio:`inherit`})):s=ye.spawn(i,t,{stdio:`inherit`}),s.killed||[`SIGUSR1`,`SIGUSR2`,`SIGTERM`,`SIGINT`,`SIGHUP`].forEach(e=>{h.on(e,()=>{s.killed===!1&&s.exitCode===null&&s.kill(e)})});let c=this._exitCallback;s.on(`close`,e=>{e??=1,c?c(new kv(e,`commander.executeSubCommandAsync`,`(close)`)):h.exit(e)}),s.on(`error`,t=>{if(t.code===`ENOENT`)this._checkForMissingExecutable(i,a,e._name);else if(t.code===`EACCES`)throw Error(`'${i}' not executable`);if(!c)h.exit(1);else{let e=new kv(1,`commander.executeSubCommandAsync`,`(error)`);e.nestedError=t,c(e)}}),this.runningCommand=s}_dispatchSubcommand(e,t,n){let r=this._findCommand(e);r||this.help({error:!0}),r._prepareForParse();let i;return i=this._chainOrCallSubCommandHook(i,r,`preSubcommand`),i=this._chainOrCall(i,()=>{if(r._executableHandler)this._executeSubCommand(r,t.concat(n));else return r._parseCommand(t,n)}),i}_dispatchHelpCommand(e){e||this.help();let t=this._findCommand(e);return t&&!t._executableHandler&&t.help(),this._dispatchSubcommand(e,[],[this._getHelpOption()?.long??this._getHelpOption()?.short??`--help`])}_checkNumberOfArguments(){this.registeredArguments.forEach((e,t)=>{e.required&&this.args[t]==null&&this.missingArgument(e.name())}),!(this.registeredArguments.length>0&&this.registeredArguments[this.registeredArguments.length-1].variadic)&&this.args.length>this.registeredArguments.length&&this._excessArguments(this.args)}_processArguments(){let e=(e,t,n)=>{let r=t;if(t!==null&&e.parseArg){let i=`error: command-argument value '${t}' is invalid for argument '${e.name()}'.`;r=this._callParseArg(e,t,n,i)}return r};this._checkNumberOfArguments();let t=[];this.registeredArguments.forEach((n,r)=>{let i=n.defaultValue;n.variadic?r<this.args.length?(i=this.args.slice(r),n.parseArg&&(i=i.reduce((t,r)=>e(n,r,t),n.defaultValue))):i===void 0&&(i=[]):r<this.args.length&&(i=this.args[r],n.parseArg&&(i=e(n,i,n.defaultValue))),t[r]=i}),this.processedArgs=t}_chainOrCall(e,t){return e?.then&&typeof e.then==`function`?e.then(()=>t()):t()}_chainOrCallHooks(e,t){let n=e,r=[];return this._getCommandAndAncestors().reverse().filter(e=>e._lifeCycleHooks[t]!==void 0).forEach(e=>{e._lifeCycleHooks[t].forEach(t=>{r.push({hookedCommand:e,callback:t})})}),t===`postAction`&&r.reverse(),r.forEach(e=>{n=this._chainOrCall(n,()=>e.callback(e.hookedCommand,this))}),n}_chainOrCallSubCommandHook(e,t,n){let r=e;return this._lifeCycleHooks[n]!==void 0&&this._lifeCycleHooks[n].forEach(e=>{r=this._chainOrCall(r,()=>e(this,t))}),r}_parseCommand(e,t){let n=this.parseOptions(t);if(this._parseOptionsEnv(),this._parseOptionsImplied(),e=e.concat(n.operands),t=n.unknown,this.args=e.concat(t),e&&this._findCommand(e[0]))return this._dispatchSubcommand(e[0],e.slice(1),t);if(this._getHelpCommand()&&e[0]===this._getHelpCommand().name())return this._dispatchHelpCommand(e[1]);if(this._defaultCommandName)return this._outputHelpIfRequested(t),this._dispatchSubcommand(this._defaultCommandName,e,t);this.commands.length&&this.args.length===0&&!this._actionHandler&&!this._defaultCommandName&&this.help({error:!0}),this._outputHelpIfRequested(n.unknown),this._checkForMissingMandatoryOptions(),this._checkForConflictingOptions();let r=()=>{n.unknown.length>0&&this.unknownOption(n.unknown[0])},i=`command:${this.name()}`;if(this._actionHandler){r(),this._processArguments();let n;return n=this._chainOrCallHooks(n,`preAction`),n=this._chainOrCall(n,()=>this._actionHandler(this.processedArgs)),this.parent&&(n=this._chainOrCall(n,()=>{this.parent.emit(i,e,t)})),n=this._chainOrCallHooks(n,`postAction`),n}if(this.parent?.listenerCount(i))r(),this._processArguments(),this.parent.emit(i,e,t);else if(e.length){if(this._findCommand(`*`))return this._dispatchSubcommand(`*`,e,t);this.listenerCount(`command:*`)?this.emit(`command:*`,e,t):this.commands.length?this.unknownCommand():(r(),this._processArguments())}else this.commands.length?(r(),this.help({error:!0})):(r(),this._processArguments())}_findCommand(e){if(e)return this.commands.find(t=>t._name===e||t._aliases.includes(e))}_findOption(e){return this.options.find(t=>t.is(e))}_checkForMissingMandatoryOptions(){this._getCommandAndAncestors().forEach(e=>{e.options.forEach(t=>{t.mandatory&&e.getOptionValue(t.attributeName())===void 0&&e.missingMandatoryOptionValue(t)})})}_checkForConflictingLocalOptions(){let e=this.options.filter(e=>{let t=e.attributeName();return this.getOptionValue(t)!==void 0&&this.getOptionValueSource(t)!=="default"});e.filter(e=>e.conflictsWith.length>0).forEach(t=>{let n=e.find(e=>t.conflictsWith.includes(e.attributeName()));n&&this._conflictingOption(t,n)})}_checkForConflictingOptions(){this._getCommandAndAncestors().forEach(e=>{e._checkForConflictingLocalOptions()})}parseOptions(e){let t=[],n=[],r=t;function i(e){return e.length>1&&e[0]===`-`}let a=e=>/^-(\d+|\d*\.\d+)(e[+-]?\d+)?$/.test(e)?!this._getCommandAndAncestors().some(e=>e.options.map(e=>e.short).some(e=>/^-\d$/.test(e))):!1,o=null,s=null,c=0;for(;c<e.length||s;){let l=s??e[c++];if(s=null,l===`--`){r===n&&r.push(l),r.push(...e.slice(c));break}if(o&&(!i(l)||a(l))){this.emit(`option:${o.name()}`,l);continue}if(o=null,i(l)){let t=this._findOption(l);if(t){if(t.required){let n=e[c++];n===void 0&&this.optionMissingArgument(t),this.emit(`option:${t.name()}`,n)}else if(t.optional){let n=null;c<e.length&&(!i(e[c])||a(e[c]))&&(n=e[c++]),this.emit(`option:${t.name()}`,n)}else this.emit(`option:${t.name()}`);o=t.variadic?t:null;continue}}if(l.length>2&&l[0]===`-`&&l[1]!==`-`){let e=this._findOption(`-${l[1]}`);if(e){e.required||e.optional&&this._combineFlagAndOptionalValue?this.emit(`option:${e.name()}`,l.slice(2)):(this.emit(`option:${e.name()}`),s=`-${l.slice(2)}`);continue}}if(/^--[^=]+=/.test(l)){let e=l.indexOf(`=`),t=this._findOption(l.slice(0,e));if(t&&(t.required||t.optional)){this.emit(`option:${t.name()}`,l.slice(e+1));continue}}if(r===t&&i(l)&&!(this.commands.length===0&&a(l))&&(r=n),(this._enablePositionalOptions||this._passThroughOptions)&&t.length===0&&n.length===0){if(this._findCommand(l)){t.push(l),n.push(...e.slice(c));break}if(this._getHelpCommand()&&l===this._getHelpCommand().name()){t.push(l,...e.slice(c));break}if(this._defaultCommandName){n.push(l,...e.slice(c));break}}if(this._passThroughOptions){r.push(l,...e.slice(c));break}r.push(l)}return{operands:t,unknown:n}}opts(){if(this._storeOptionsAsProperties){let e={},t=this.options.length;for(let n=0;n<t;n++){let t=this.options[n].attributeName();e[t]=t===this._versionOptionName?this._version:this[t]}return e}return this._optionValues}optsWithGlobals(){return this._getCommandAndAncestors().reduce((e,t)=>Object.assign(e,t.opts()),{})}error(e,t){this._outputConfiguration.outputError(`${e}\n`,this._outputConfiguration.writeErr),typeof this._showHelpAfterError==`string`?this._outputConfiguration.writeErr(`${this._showHelpAfterError}\n`):this._showHelpAfterError&&(this._outputConfiguration.writeErr(`
|
|
345
|
+
`),this.outputHelp({error:!0}));let n=t||{},r=n.exitCode||1,i=n.code||`commander.error`;this._exit(r,i,e)}_parseOptionsEnv(){this.options.forEach(e=>{if(e.envVar&&e.envVar in h.env){let t=e.attributeName();(this.getOptionValue(t)===void 0||[`default`,`config`,`env`].includes(this.getOptionValueSource(t)))&&(e.required||e.optional?this.emit(`optionEnv:${e.name()}`,h.env[e.envVar]):this.emit(`optionEnv:${e.name()}`))}})}_parseOptionsImplied(){let e=new Fv(this.options),t=e=>this.getOptionValue(e)!==void 0&&![`default`,`implied`].includes(this.getOptionValueSource(e));this.options.filter(n=>n.implied!==void 0&&t(n.attributeName())&&e.valueFromOption(this.getOptionValue(n.attributeName()),n)).forEach(e=>{Object.keys(e.implied).filter(e=>!t(e)).forEach(t=>{this.setOptionValueWithSource(t,e.implied[t],`implied`)})})}missingArgument(e){let t=`error: missing required argument '${e}'`;this.error(t,{code:`commander.missingArgument`})}optionMissingArgument(e){let t=`error: option '${e.flags}' argument missing`;this.error(t,{code:`commander.optionMissingArgument`})}missingMandatoryOptionValue(e){let t=`error: required option '${e.flags}' not specified`;this.error(t,{code:`commander.missingMandatoryOptionValue`})}_conflictingOption(e,t){let n=e=>{let t=e.attributeName(),n=this.getOptionValue(t),r=this.options.find(e=>e.negate&&t===e.attributeName()),i=this.options.find(e=>!e.negate&&t===e.attributeName());return r&&(r.presetArg===void 0&&n===!1||r.presetArg!==void 0&&n===r.presetArg)?r:i||e},r=e=>{let t=n(e),r=t.attributeName();return this.getOptionValueSource(r)===`env`?`environment variable '${t.envVar}'`:`option '${t.flags}'`},i=`error: ${r(e)} cannot be used with ${r(t)}`;this.error(i,{code:`commander.conflictingOption`})}unknownOption(e){if(this._allowUnknownOption)return;let t=``;if(e.startsWith(`--`)&&this._showSuggestionAfterError){let n=[],r=this;do{let e=r.createHelp().visibleOptions(r).filter(e=>e.long).map(e=>e.long);n=n.concat(e),r=r.parent}while(r&&!r._enablePositionalOptions);t=zv(e,n)}let n=`error: unknown option '${e}'${t}`;this.error(n,{code:`commander.unknownOption`})}_excessArguments(e){if(this._allowExcessArguments)return;let t=this.registeredArguments.length,n=t===1?``:`s`,r=e.length,i=`error: too many arguments${this.parent?` for '${this.name()}'`:``}. Expected ${t} argument${n} but got ${r}: ${e.join(`, `)}.`;this.error(i,{code:`commander.excessArguments`})}unknownCommand(){let e=this.args[0],t=``;if(this._showSuggestionAfterError){let n=[];this.createHelp().visibleCommands(this).forEach(e=>{n.push(e.name()),e.alias()&&n.push(e.alias())}),t=zv(e,n)}let n=`error: unknown command '${e}'${t}`;this.error(n,{code:`commander.unknownCommand`})}version(e,t,n){if(e===void 0)return this._version;this._version=e,t||=`-V, --version`,n||=`output the version number`;let r=this.createOption(t,n);return this._versionOptionName=r.attributeName(),this._registerOption(r),this.on(`option:`+r.name(),()=>{this._outputConfiguration.writeOut(`${e}\n`),this._exit(0,`commander.version`,e)}),this}description(e,t){return e===void 0&&t===void 0?this._description:(this._description=e,t&&(this._argsDescription=t),this)}summary(e){return e===void 0?this._summary:(this._summary=e,this)}alias(e){if(e===void 0)return this._aliases[0];let t=this;if(this.commands.length!==0&&this.commands[this.commands.length-1]._executableHandler&&(t=this.commands[this.commands.length-1]),e===t._name)throw Error(`Command alias can't be the same as its name`);let n=this.parent?._findCommand(e);if(n){let t=[n.name()].concat(n.aliases()).join(`|`);throw Error(`cannot add alias '${e}' to command '${this.name()}' as already have command '${t}'`)}return t._aliases.push(e),this}aliases(e){return e===void 0?this._aliases:(e.forEach(e=>this.alias(e)),this)}usage(e){if(e===void 0){if(this._usage)return this._usage;let e=this.registeredArguments.map(e=>Mv(e));return[].concat(this.options.length||this._helpOption!==null?`[options]`:[],this.commands.length?`[command]`:[],this.registeredArguments.length?e:[]).join(` `)}return this._usage=e,this}name(e){return e===void 0?this._name:(this._name=e,this)}helpGroup(e){return e===void 0?this._helpGroupHeading??``:(this._helpGroupHeading=e,this)}commandsGroup(e){return e===void 0?this._defaultCommandGroup??``:(this._defaultCommandGroup=e,this)}optionsGroup(e){return e===void 0?this._defaultOptionGroup??``:(this._defaultOptionGroup=e,this)}_initOptionGroup(e){this._defaultOptionGroup&&!e.helpGroupHeading&&e.helpGroup(this._defaultOptionGroup)}_initCommandGroup(e){this._defaultCommandGroup&&!e.helpGroup()&&e.helpGroup(this._defaultCommandGroup)}nameFromFilename(e){return this._name=ne.basename(e,ne.extname(e)),this}executableDir(e){return e===void 0?this._executableDir:(this._executableDir=e,this)}helpInformation(e){let t=this.createHelp(),n=this._getOutputContext(e);t.prepareContext({error:n.error,helpWidth:n.helpWidth,outputHasColors:n.hasColors});let r=t.formatHelp(this,t);return n.hasColors?r:this._outputConfiguration.stripColor(r)}_getOutputContext(e){e||={};let t=!!e.error,n,r,i;return t?(n=e=>this._outputConfiguration.writeErr(e),r=this._outputConfiguration.getErrHasColors(),i=this._outputConfiguration.getErrHelpWidth()):(n=e=>this._outputConfiguration.writeOut(e),r=this._outputConfiguration.getOutHasColors(),i=this._outputConfiguration.getOutHelpWidth()),{error:t,write:e=>(r||(e=this._outputConfiguration.stripColor(e)),n(e)),hasColors:r,helpWidth:i}}outputHelp(e){let t;typeof e==`function`&&(t=e,e=void 0);let n=this._getOutputContext(e),r={error:n.error,write:n.write,command:this};this._getCommandAndAncestors().reverse().forEach(e=>e.emit(`beforeAllHelp`,r)),this.emit(`beforeHelp`,r);let i=this.helpInformation({error:n.error});if(t&&(i=t(i),typeof i!=`string`&&!Buffer.isBuffer(i)))throw Error(`outputHelp callback must return a string or a Buffer`);n.write(i),this._getHelpOption()?.long&&this.emit(this._getHelpOption().long),this.emit(`afterHelp`,r),this._getCommandAndAncestors().forEach(e=>e.emit(`afterAllHelp`,r))}helpOption(e,t){return typeof e==`boolean`?(e?(this._helpOption===null&&(this._helpOption=void 0),this._defaultOptionGroup&&this._initOptionGroup(this._getHelpOption())):this._helpOption=null,this):(this._helpOption=this.createOption(e??`-h, --help`,t??`display help for command`),(e||t)&&this._initOptionGroup(this._helpOption),this)}_getHelpOption(){return this._helpOption===void 0&&this.helpOption(void 0,void 0),this._helpOption}addHelpOption(e){return this._helpOption=e,this._initOptionGroup(e),this}help(e){this.outputHelp(e);let t=Number(h.exitCode??0);t===0&&e&&typeof e!=`function`&&e.error&&(t=1),this._exit(t,`commander.help`,`(outputHelp)`)}addHelpText(e,t){let n=[`beforeAll`,`before`,`after`,`afterAll`];if(!n.includes(e))throw Error(`Unexpected value for position to addHelpText.
|
|
346
|
+
Expecting one of '${n.join(`', '`)}'`);let r=`${e}Help`;return this.on(r,e=>{let n;n=typeof t==`function`?t({error:e.error,command:e.command}):t,n&&e.write(`${n}\n`)}),this}_outputHelpIfRequested(e){let t=this._getHelpOption();t&&e.find(e=>t.is(e))&&(this.outputHelp(),this._exit(0,`commander.helpDisplayed`,`(outputHelp)`))}};function Vv(e){return e.map(e=>{if(!e.startsWith(`--inspect`))return e;let t,n=`127.0.0.1`,r=`9229`,i;return(i=e.match(/^(--inspect(-brk)?)$/))===null?(i=e.match(/^(--inspect(-brk|-port)?)=([^:]+)$/))===null?(i=e.match(/^(--inspect(-brk|-port)?)=([^:]+):(\d+)$/))!==null&&(t=i[1],n=i[3],r=i[4]):(t=i[1],/^\d+$/.test(i[3])?r=i[3]:n=i[3]):t=i[1],t&&r!==`0`?`${t}=${n}:${parseInt(r)+1}`:e})}function Hv(){if(h.env.NO_COLOR||h.env.FORCE_COLOR===`0`||h.env.FORCE_COLOR===`false`)return!1;if(h.env.FORCE_COLOR||h.env.CLICOLOR_FORCE!==void 0)return!0}new Bv;const Uv=[],Wv=e=>Array.isArray(e)?e:[e],Gv=e=>e===void 0?Uv:[e],Kv=e=>e instanceof Error?e.message:String(e),X=e=>{let t=e.optsWithGlobals();return{json:t.json===!0,verbose:t.verbose===!0}},Z=(e,t,n,r,i)=>{if(t.json){let t={data:r,ok:!0,warnings:i??Uv};e.out(JSON.stringify(t));return}for(let t of Wv(n))e.out(t);for(let t of i??Uv)e.errLine(`refs: warning: ${t}`)},qv=(e,t,n)=>{if(t.json){let t={error:{code:n.code,message:n.message,...n.reason===void 0?{}:{reason:n.reason}},ok:!1};e.out(JSON.stringify(t));return}e.errLine(`refs: ${n.message}`)},Jv=(e,t)=>{e.errLine(`refs: ${t}`)},Yv=async(e,t,n)=>{let r=t.json?pv:e.spinner();try{return await n(r)}finally{r.stop()}},Q=(e,t,n)=>async()=>{try{await n()}catch(n){let r=Te(n,{verbose:t.verbose});qv(e,t,r),process.exitCode=r.exitCode}},Xv=e=>`'${e.replaceAll(`'`,String.raw`'\''`)}'`,Zv=(e,t)=>{let n=t.some(e=>e.startsWith(`-`))?[`--`]:[];return[`refs edit`,...e,...n,...t.map(e=>Xv(e))].join(` `)},Qv=e=>`rm -rf -- ${Xv(e)}`,$v=e=>`rmdir -- ${Xv(e)}`,ey=e=>({path:e.path}),ty=e=>e.filter(e=>e.path!==`.`),ny=e=>e.find(e=>e.path===`.`),ry=e=>{let t=ny(e);return t===void 0?{}:{[t.name]:ey(t)}},iy=(e,t,n)=>{let r=ty(e),i=ry(e);return r.length>0?{...i,...Object.fromEntries(r.map(e=>[e.name,ey(e)]))}:n===void 0?i:{...i,[n]:{path:t??`.`}}},ay=e=>{let t=e.description??``;return e.tag_format===void 0?{description:t,path:e.path}:{description:t,path:e.path,tag_format:e.tag_format}},oy=(e,t)=>{let n=Object.entries(e);if(n.length!==0)return Object.fromEntries(n.map(([e,n])=>[e,ay(e===t.rootPackageName?cy(n,t.refDescription):n)]))},sy=(e,t)=>{let[n]=Object.keys(ry(e));if(n!==void 0)return t[n]?.path===`.`?n:void 0},cy=(e,t)=>({...e,description:t}),ly=(e,t)=>Object.keys(e).filter(e=>e!==t).toSorted(),uy=(e,t,n)=>{if(ly(e,n).length!==0)throw y(`refs add --description cannot describe a package: it has one description, about the repository. Run the two-phase flow instead:
|
|
347
|
+
refs add ${Xv(t)} --dry-run --json > proposal.json\nFill in the ref's own description, and one written from its own source for each package below, then:
|
|
348
348
|
refs add --proposal proposal.json
|
|
349
|
-
packages to describe: ${Object.keys(e).toSorted().join(`, `)}`)},
|
|
350
|
-
`)},$y=e=>{let t=Rg.safeParse(e);if(!t.success)throw y(Qy(t.error));return t.data},eb=async(e,t)=>{let n=await Hy(e,t);return $y(Ky(Uy(n)))},tb=(e,t)=>[`refs add: dry-run proposal ready for '${e}' (checkout: ${t})`,`next: review the proposal, then run refs add --proposal <file> to finalize`],nb=e=>[...Mv(e.warning),...Mv(e.detectionWarning)],rb=async(e,t)=>{let n=await Ly(e,t),r=z(e.env);await Ry(r,n.proposal.key,n.effectiveCloneMode);let i=nb(n);return{data:n.proposal,human:tb(n.proposal.key,n.dest),warnings:i}},ib=e=>[`refs add: '${e}' added to config`],ab=e=>{let t={default_branch:e.default_branch,description:e.description,key:e.key,url:e.url};e.tag_format_candidate!==null&&(t.tag_format=e.tag_format_candidate);let n=Zv(e.packages);return n!==void 0&&(t.packages=n),t},ob=async(e,t)=>{let n=await eb(e,t),r=z(e.env),i=B(r,n.key);if(!U(i))throw _(`no checkout found at ${i} — run: refs add <source> --dry-run first`);let a=ab(n),{entry:o,key:s}=await Vy(e,{dest:i,home:r,ref:a});return{data:{entry:o,key:s},human:ib(s),warnings:[]}},sb=(e,t,n)=>{Xv(e.proposal.packages,n,e.rootPackageName);let r={default_branch:e.proposal.default_branch,description:t,key:e.proposal.key,url:e.proposal.url};e.proposal.tag_format_candidate!==null&&(r.tag_format=e.proposal.tag_format_candidate);let i=Kv(e.proposal.packages,{refDescription:t,...e.rootPackageName===void 0?{}:{rootPackageName:e.rootPackageName}});return i!==void 0&&(r.packages=i),r},cb=async(e,t,n)=>{let r=await Ly(e,t),i=z(e.env);await Ry(i,r.proposal.key,r.effectiveCloneMode);let a=sb(r,n,t),o={dest:r.dest,home:i,ref:a};r.effectiveCloneMode!==void 0&&(o.effectiveCloneMode=r.effectiveCloneMode);let{entry:s,key:c}=await Vy(e,o);return{data:{entry:s,key:c},human:ib(c),warnings:nb(r)}},lb=e=>{let t=[e.dryRun,e.proposal!==void 0,e.description!==void 0].filter(Boolean).length;if(t>1)throw v(`refs add: use only one of --dry-run, --proposal, or --description`);if(t===0)throw v(`refs add needs --dry-run, --proposal, or --description`)},ub=e=>{if(e===void 0||e===``)throw v(`refs add requires <source> (a git url or npm:<package>)`);return e},db=(e,t)=>(lb(t),t.proposal===void 0?t.description===void 0?rb(e,ub(t.source)):cb(e,ub(t.source),t.description):ob(e,t.proposal)),fb=(e,t)=>{let n={dryRun:t.dryRun===!0};return e!==void 0&&(n.source=e),t.proposal!==void 0&&(n.proposal=t.proposal),t.description!==void 0&&(n.description=t.description),n},pb=(e,t)=>{e.command(`add`).description(`Add a git reference in two phases: propose (--dry-run), then finalize (--proposal).`).argument(`[source]`,`git url or npm:<package> (omit when finalizing with --proposal)`).option(`--dry-run`,`resolve and clone the source, writing a reviewable proposal`).option(`--proposal <file>`,`finalize from a completed proposal JSON file (- for stdin)`).option(`--description <text>`,`one-shot: dry-run then finalize immediately with this description`).action((e,n,r)=>{let i=X(r);return Q(t,i,async()=>{let r=await db(t,fb(e,n));Z(t,i,r.human,r.data,r.warnings)})()})},mb=async e=>{let t=await e.runner.run(`git`,[`--version`]);return t.exitCode===0?{detail:t.stdout.trim(),name:`git`,status:`ok`}:{detail:t.stderr.trim()||`git --version exited with code ${t.exitCode}`,name:`git`,status:`fail`}},hb=/^v(?<major>\d+)\.(?<minor>\d+)/u,gb=e=>{let t=hb.exec(e),n=t?.groups?.major,r=t?.groups?.minor;if(n!==void 0&&r!==void 0)return{major:Number(n),minor:Number(r)}},_b=e=>e===void 0?!1:e.major>24||e.major===24&&e.minor>=2,vb=e=>{let{nodeVersion:t}=e;return _b(gb(t))?{detail:t,name:`node`,status:`ok`}:{detail:`${t} does not satisfy the required range >=24.2`,name:`node`,status:`fail`}},yb=()=>bl.parse({meta:{cli_version:`0.0.0`,schema_version:1},refs:{},settings:{}}),bb=async e=>{try{return{config:await V(e)}}catch(e){return{config:yb(),errorMessage:Nv(e)}}},xb=e=>e===void 0?{detail:`config is present and matches the current schema`,name:`config`,status:`ok`}:{detail:e,name:`config`,status:`fail`},Sb={ci:`update check is off in CI — set REFS_UPDATE_CHECK=1 to run it here anyway`,config:`update check is off ([updates].check = false in config.toml)`,env:`update check is off (REFS_UPDATE_CHECK=0)`},Cb=(e,t,n)=>{if(r_(e,t)){let r=n?` (npm was unreachable just now; this was its last answer)`:``;return{detail:`${i_(e,t)}${r}`,name:`cli-update`,status:`warn`}}return n?{detail:`could not reach npm to check; its last answer was ${t}, which this CLI (${e}) already has`,name:`cli-update`,status:`warn`}:{detail:`this CLI (${e}) is npm's latest published release`,name:`cli-update`,status:`ok`}},wb=async(e,t)=>{let n=c_({env:e.env,updates:t.updates});if(n!==`on`)return{detail:Sb[n],name:`cli-update`,status:`ok`};let{latest:r,stale:i}=await n_({fetch:e.fetcher,home:z(e.env),nowMs:Date.now()});return r===void 0?{detail:`could not reach npm to learn the latest published version — not a fault of your setup, and nothing else depends on it`,name:`cli-update`,status:`warn`}:Cb(e.cliVersion,r,i)},Tb=(e,t)=>Object.keys(t.refs).map(e=>il.parse(e)).map(t=>({dest:B(e,t),key:t})).filter(e=>U(e.dest)),Eb=[`pre-commit`,`pre-push`],Db=async(t,r)=>{try{return await e(m(t.hooksDir,r),n.X_OK),!0}catch{return!1}},Ob=async e=>{let t=await Promise.all(Eb.map(t=>Db(e,t)));return Eb.filter((e,n)=>!t[n])},kb=async(e,t,n)=>{let r=await e.runner.run(`git`,[`config`,`--local`,`--get`,`core.hooksPath`],{cwd:n});return r.exitCode===0&&r.stdout.trim()===t.hooksDir},Ab=e=>e.missingHooks.length>0?{detail:`${e.missingHooks.map(e=>`hooks/${e}`).join(`, `)} missing or not executable — run: refs init`,name:`hooks-guard`,status:`fail`}:e.badKeys.length>0?{detail:`core.hooksPath not set for: ${e.badKeys.join(`, `)} — run: refs init`,name:`hooks-guard`,status:`fail`}:{detail:`${Eb.map(e=>`hooks/${e}`).join(`, `)} present; ${e.checkoutCount} checkout(s) guarded`,name:`hooks-guard`,status:`ok`},jb=async(e,t,n)=>{let r=Tb(t,n),[i,a]=await Promise.all([Ob(t),Promise.all(r.map(n=>kb(e,t,n.dest)))]),o=r.filter((e,t)=>!a[t]).map(e=>e.key);return Ab({badKeys:o,checkoutCount:r.length,missingHooks:i})},Mb=async(e,t)=>{let n=await e.runner.run(`git`,[`status`,`--porcelain`],{cwd:t.dest});return n.exitCode===0?{broken:!1,detail:``,dirty:n.stdout.trim()!==``,key:t.key}:{broken:!0,detail:n.stderr.trim(),dirty:!1,key:t.key}},Nb=e=>{let t=e.filter(e=>e.broken);if(t.length>0)return{detail:t.map(e=>`${e.key}: git status failed — ${e.detail}`).join(`; `),name:`dirty-checkouts`,status:`fail`};let n=e.filter(e=>e.dirty).map(e=>e.key);return n.length===0?{detail:`no local changes in any checkout`,name:`dirty-checkouts`,status:`ok`}:{detail:`local changes will be discarded on next sync: ${n.join(`, `)}`,name:`dirty-checkouts`,status:`warn`}},Pb=async(e,t,n)=>{let r=Tb(t,n),i=await Promise.all(r.map(t=>Mb(e,t)));return Nb(i)},Fb=async e=>{try{return await Wg(e)}catch{return Bg.parse({})}},Ib=async e=>{try{return(await c(e,{withFileTypes:!0})).filter(e=>e.isDirectory()).map(e=>e.name)}catch(e){if(R(e))return[];throw e}},Lb=async(e,t)=>{if(U(e))return[[...t]];let n=await Ib(e);return(await Promise.all(n.map(n=>Lb(m(e,n),[...t,n])))).flat()},Rb=(e,t,n)=>{let r=e.refs[t]?.pending_proposal_at;return r!==void 0&&n-Date.parse(r)<864e5},zb=(e,t,n)=>Rb(t,e.key,n)?`${e.key}: pending add`:`${e.key}: orphan — remove with: ${Rv(e.dest)}`,Bb=(e,t)=>({dest:m(e.sourcesDir,...t),key:t.join(`/`)}),Vb=async(e,t,n)=>{let r=(await Lb(e.sourcesDir,[])).map(t=>Bb(e,t)).filter(e=>!Object.hasOwn(t.refs,e.key));if(r.length===0)return{detail:`no orphaned checkouts under sources/`,name:`orphans`,status:`ok`};let i=Date.now();return{detail:r.map(e=>zb(e,n,i)).join(`; `),name:`orphans`,status:`warn`}},Hb=e=>{let t=(e??``).lastIndexOf(`/`);return t===-1?`.`:(e??``).slice(0,t)},Ub=e=>{let[t=`.`,...n]=e,r=t.split(`/`),i=r.length;for(let e of n){let t=e.split(`/`),n=0;for(;n<i&&n<t.length&&r[n]===t[n];)n+=1;i=n}return i===0?`.`:r.slice(0,i).join(`/`)},Wb=`(unknown)`,Gb=e=>ul.safeParse(e.path).success,Kb=(e,t)=>{let n=`${e.name}: declared in this checkout but not registered — it cannot be resolved by name until it is`;if(e.path===void 0)return`${n}. Declared at several paths (${(e.candidates??[]).join(`, `)}) — pick one`;if(!Gb(e))return`${n}. Its path is one the configuration cannot hold, so there is no command for it — report it and leave it unregistered`;let r=Lv([`--package=${Iv(e.name)}`,`--decline`,`--path=${Iv(e.path)}`],[t]);return Kc(e.name)?`${n}. To register it: ${Lv([`--package=${Iv(e.name)}`,`--create`,`--path=${Iv(e.path)}`,`--description="<what it is>"`],[t])}. If it should not be: ${r}`:`${n}. Its name is one the packages table cannot hold, so it cannot be registered — if that is the answer, record it: ${r}`},qb=(e,t,n)=>{let r=`${e.name}: moved to ${e.path??Wb} — update the entry's path (${n})`,i=Lv([`--package=${Iv(e.name)}`],[t,`path`,e.path??``]);return ul.safeParse(e.path).success?`${r}. To fix it: ${i}`:r},Jb=(e,t)=>{let n=`configured: ${e.configured_path??Wb}`;if(e.status===`relocated`)return qb(e,t,n);if(e.status===`missing`){let r=Lv([`--package=${Iv(e.name)}`,`--remove`],[t]);return`${e.name}: gone from this repo's workspaces (${n}) — repoint the entry if it moved out of them, or unregister it: ${r}`}if(e.status===`ambiguous`){let t=(e.candidates??[]).join(`, `);return`${e.name}: declared at several paths (${t}) — point the entry at one (${n})`}return`${e.name}: could not be checked — ${e.reason??`(no reason given)`} (${n})`},Yb=(e,t)=>e.status===`unregistered`?Kb(e,t):Jb(e,t),Xb=e=>`could not check for unregistered packages — ${e}`,Zb=e=>`…and ${e} more finding(s) — act on the ones above (register, repoint or decline) and run the check again to see the rest`,Qb=e=>{let t=e.length-10;return t<=0?[...e]:[...e.slice(0,10),Zb(t)]},$b=e=>{let t=new Map;for(let n of e){let[e=`.`]=Hb(n.path).split(`/`);t.set(e,[...t.get(e)??[],n])}return t},ex=e=>e.path===void 0,tx=(e,t,n)=>{if(e.length<3)return e.map(e=>({candidates:1,dir:n,line:Kb(e,t)}));let r=Ub(e.map(e=>Hb(e.path)));return[{candidates:e.length,dir:r,line:`${r}: ${e.length} unregistered package(s) the configuration does not have`}]},nx=e=>{let t=e.reduce((e,t)=>e+t.candidates,0),n=new Set(e.flatMap(e=>e.dir===void 0?[]:[e.dir])).size;return`…and ${t} more unregistered package(s)${n===0?``:` in ${n} director(ies)`} — 'refs doctor --json' lists every candidate`},rx=(e,t)=>{let n=e.filter(e=>ex(e)).map(e=>({candidates:1,line:Kb(e,t)})),r=[...$b(e.filter(e=>!ex(e)))].toSorted(([e],[t])=>e.localeCompare(t)).flatMap(([e,n])=>tx(n,t,e)),i=[...n,...r],a=i.slice(10);return a.length===0?i.map(e=>e.line):[...i.slice(0,10).map(e=>e.line),nx(a)]},ix=(e,t)=>e.reason===void 0?[...Qb((e.packages??[]).map(e=>Yb(e,t))),...rx(e.discovery??[],t),...e.discovery_incomplete===void 0?[]:[Xb(e.discovery_incomplete)]]:[`could not be checked — ${e.reason}`],ax=e=>{let t;return()=>(t??=dv(e),t)},ox=async(e,t,n)=>{let r=await S_(e);if(r===void 0||t.some(e=>e.packageName===r.name))return{issues:[]};let i=await n();if(!Gh(i))return{incomplete:vy(i),issues:[]};let a=tg(i.packages,r.name);return a.kind===`ambiguous`?{issues:[{candidates:a.paths,name:r.name,status:`unregistered`}]}:{issues:a.kind===`found`?[{name:r.name,path:a.path,status:`unregistered`}]:[]}},sx=e=>{let t=new Map;for(let n of e)t.set(n.name,[...t.get(n.name)??[],n.path]);return t},cx=(e,t)=>{let n=new Set(e.changedDirs),r=t.filter(e=>!n.has(e.path)).map(e=>e.name);return new Set([...e.namesBefore,...r])},lx=(e,t)=>t.length===1&&t[0]!==void 0?{name:e,path:t[0],status:`unregistered`}:{candidates:[...t],name:e,status:`unregistered`},ux=async(e,t,n)=>{if(t.kind===`arrivals`&&t.changedDirs.length===0)return{issues:[]};let r=await n();if(!Gh(r))return{incomplete:vy(r),issues:[]};let i=new Set(e.map(e=>e.packageName)),a=r.packages.filter(e=>e.path!==`.`),o=t.kind===`all`?void 0:cx(t,a);return{issues:[...sx(a)].filter(([e])=>!i.has(e)).filter(([e])=>o===void 0||!o.has(e)).map(([e,t])=>lx(e,t)).toSorted((e,t)=>e.name.localeCompare(t.name))}},dx=(e,t)=>{if(t.length===0)return{issues:[...e],suppressed:[]};let n=(e,n)=>t.some(t=>t.name===e&&t.path===n),r=[];return{issues:e.flatMap(e=>{if(e.status!==`unregistered`)return[e];let t=e.path===void 0?e.candidates??[]:[e.path],i=t.filter(t=>!n(e.name,t)),a=t.filter(t=>n(e.name,t));return r.push(...a.map(t=>({name:e.name,path:t}))),i.length===0?[]:[lx(e.name,i)]}),suppressed:r}},fx=e=>e!==`unmaterialized`&&e!==`verified`,px=new Set([`ambiguous`,`missing`,`relocated`]),mx=(e,t={})=>{let{declined:n=[],discoveryIncomplete:r}=t,i=e.filter(e=>e.status!==`unregistered`),a=e.filter(e=>e.status===`unregistered`);return{...n.length===0?{}:{declined:[...n]},...a.length===0?{}:{discovery:a},...r===void 0?{}:{discovery_incomplete:r},...i.length===0?{}:{packages:i},status:hx(i,r)}},hx=(e,t)=>e.some(e=>px.has(e.status))?`drift`:e.length===0&&t===void 0?`ok`:`unknown`,gx=(e,t)=>({path:e.configuredPath,reason:t,status:`unverifiable`}),_x=(e,t)=>Kh(t)?{configuredPath:e.configuredPath,path:null,status:`missing`}:gx(e,`this repo declares no workspaces, so there was nowhere to search`),vx=(e,t)=>t===e.configuredPath,yx=e=>e.packages.filter(e=>e.path!==`.`),bx=(e,t)=>{let n=tg(yx(t),e.packageName);return n.kind===`ambiguous`?{candidates:n.paths,configuredPath:e.configuredPath,path:null,status:`ambiguous`}:Gh(t)?n.kind===`absent`?_x(e,t):vx(e,n.path)?gx(e,`the checkout changed while it was being inspected`):{configuredPath:e.configuredPath,path:n.path,status:`relocated`}:gx(e,n.kind===`found`?`workspace detection was incomplete, so the new location is not confirmed unique`:`workspace detection was incomplete`)},xx=e=>{let t=new Map(Object.entries(e??{}));return[...t.keys()].toSorted().flatMap(e=>{let n=t.get(e);return n===void 0?[]:[{configuredPath:n.path,packageName:e}]})},Sx=async(e,t)=>{let n=await Qh(e,t.configuredPath,t.packageName);if(n.kind===`match`)return{path:t.configuredPath,status:`verified`};if(n.kind===`unreadable`)return{path:t.configuredPath,reason:n.reason,status:`unverifiable`}},Cx=e=>e.flatMap(e=>e.settled===void 0?[]:[{outcome:e.settled,query:e.query}]),wx=async(e,t,n)=>{let r=await Promise.all(t.map(async t=>({query:t,settled:await Sx(e,t)})));if(r.every(e=>e.settled!==void 0))return Cx(r);let i=await n();return r.map(e=>({outcome:e.settled??bx(e.query,i),query:e.query}))},Tx=e=>{let{outcome:t,query:n}=e;return fx(t.status)?[{...t.candidates===void 0?{}:{candidates:t.candidates},configured_path:n.configuredPath,name:n.packageName,...t.status===`relocated`&&t.path!==null?{path:t.path}:{},...t.reason===void 0?{}:{reason:t.reason},status:t.status}]:[]},Ex=(e,t)=>{let n=new Set(e.map(e=>e.name));return[...e,...t.filter(e=>!n.has(e.name))]},Dx=async(e,t,n)=>{let r=xx(t.packages),[i]=r;if(i===void 0)return{status:`ok`};let a=ax(e);try{let[i,o,s]=await Promise.all([wx(e,r,a),ox(e,r,a),ux(r,n,a)]),c=dx([...i.flatMap(e=>Tx(e)),...Ex(o.issues,s.issues)],t.declined_packages??[]);return mx(c.issues,{declined:c.suppressed,...(s.incomplete??o.incomplete)===void 0?{}:{discoveryIncomplete:s.incomplete??o.incomplete}})}catch(e){return{reason:Nv(e),status:`unknown`}}},Ox=async(e,t,n)=>{try{return await G(e,ry(n.key),()=>Dx(n.dest,t.refs[n.key]??{},{kind:`all`}),{timeoutMs:100})}catch(e){if(e instanceof g&&e.code===`conflict`)return{reason:`another refs process is holding this ref`,status:`unknown`};throw e}},kx=e=>e===0?``:` (${e} declined package(s) not reported)`,Ax=(e,t)=>e.unhealthy.length===0?`every configured package path resolves in ${t} checkout(s)`:e.unhealthy.join(`; `),jx=(e,t)=>{let{declined:n,discovery:r,findings:i}=e;return{detail:[Ax(e,t)+kx(n),...r].join(`; `),...i.length===0?{}:{findings:i},name:`config-drift`,status:e.unhealthy.length===0?`ok`:`warn`}},Mx=async(e,t,n)=>{let[r,...i]=n;if(r===void 0)return{declined:0,discovery:[],findings:[],unhealthy:[]};let a=await Ox(e,t,r),o=await Mx(e,t,i);return Nx(o,{key:r.key,report:a})},Nx=(e,t)=>{let{key:n,report:r}=t,i=e=>e.map(e=>`${n}: ${e}`),a=r.discovery??[],o=r.packages??[],s=[...o,...a];return{declined:(r.declined??[]).length+e.declined,discovery:[...i(ix({discovery:a,status:`ok`},n)),...e.discovery],findings:s.length===0?e.findings:[{key:n,packages:s},...e.findings],unhealthy:[...i(ix({...r.discovery_incomplete===void 0?{}:{discovery_incomplete:r.discovery_incomplete},...r.reason===void 0?{}:{reason:r.reason},packages:o,status:r.status},n)),...e.unhealthy]}},Px=async(e,t)=>{let n=Tb(e,t);return jx(await Mx(e,t,n),n.length)},Fx=e=>{let{diagnosis:t}=e;return e.kind===`claim`||!e.isDirectory||t.pidState===`definitely-dead`||t.stale||t.meta===`malformed`||t.meta===`unreadable`||t.policy===`unknown`?!1:t.ageMs===void 0||t.ageMs>=0},Ix=e=>{let{ageMs:t,budgetMs:n,policy:r}=e;return r===`unknown`?`, state could not be read`:t===void 0||n===void 0?``:t<0?`, recorded time is in the future — check the system clock`:`, ${Sp(t)} into a ${Sp(n)} window`},Lx=e=>e.pid===void 0?`owner unknown (metadata ${e.meta})`:e.pidState===`definitely-dead`?`recorded pid ${e.pid} is not running`:`recorded pid ${e.pid} present`,Rx=(e,t)=>{let n=m(e.locksDir,op,t.name),r=t.diagnosis.ageMs===void 0?``:` for ${Sp(t.diagnosis.ageMs)}`;return`steal claim on ${t.name}: present${r}. Stealing this lock is blocked while it is here. A reclaim in progress clears it within a moment; if it stays, ${zx}: ${zv(n)}`},zx=`stop every refs process using this home — including suspended ones — and then run`,Bx=(e,t)=>{let{diagnosis:n}=t;if(ep(n))return`, reclaimable now`;if(!n.stale&&t.isDirectory)return``;let r=m(e.locksDir,t.name);return`, not automatically reclaimable — if it is genuinely abandoned, ${zx}: ${Rv(r)}`},Vx=(e,t)=>{let{diagnosis:n}=t,r=t.isDirectory?``:`not a directory, `,i=Bx(e,t);return`${t.name}: ${r}${Lx(n)}${Ix(n)}${i}`},Hx=async e=>{let t=await xp(e),[n]=t;return n===void 0?{detail:`no locks held`,name:`locks`,status:`ok`}:{detail:t.map(t=>t.kind===`claim`?Rx(e,t):Vx(e,t)).join(`; `),name:`locks`,status:t.every(e=>Fx(e))?`ok`:`warn`}},Ux=[`.agents`,`skills`,`refs`,`SKILL.md`],Wx=[`skills`,`refs`,`SKILL.md`],Gx=[`.claude`,`skills`,`refs`,`SKILL.md`],Kx=`npx skills add kaisers-io/refs`,qx=`npm i -g @kaisers-io/refs@latest`,Jx=(e,t)=>e===void 0?void 0:{display:t,path:e},Yx=e=>{let{dirName:t,env:n,home:r,overrideName:i}=e,a=n[i]?.trim();return a!==void 0&&a.length>0?{display:a,path:a}:Jx(r===void 0?void 0:m(r,t),`~/${t}`)},Xx=e=>{let t=e.homedir.length>0?e.homedir:void 0;return[{label:`shared ~/.agents`,root:Jx(t,`~/.agents`),segments:Ux},{label:`Claude Code`,root:Yx({dirName:`.claude`,env:e.env,home:t,overrideName:`CLAUDE_CONFIG_DIR`}),segments:Wx},{label:`Codex`,root:Yx({dirName:`.codex`,env:e.env,home:t,overrideName:`CODEX_HOME`}),segments:Wx},{label:`project ./.agents`,root:Jx(e.cwd,`./.agents`),segments:Ux},{label:`project ./.claude`,root:Jx(e.cwd,`./.claude`),segments:Gx}].flatMap(({label:e,root:t,segments:n})=>t===void 0?[]:[{display:t.display,label:e,path:m(t.path,...n)}])},Zx=async(e,t)=>{try{let n=await l(e);return{label:t,realPath:n,source:await s(n,`utf8`)}}catch{return}},Qx=e=>{let t=new Map;for(let n of e)t.has(n.realPath)||t.set(n.realPath,n);return[...t.values()]},$x=/^---\r?\n(?<body>[\s\S]*?)\r?\n---/u,eS=/^\s*cli_version:\s*["']?(?<version>[^"'\s]+)["']?\s*$/mu,tS=e=>{let t=$x.exec(e)?.groups?.body;if(t!==void 0)return eS.exec(t)?.groups?.version},nS=(e,t)=>{if(e===t)return`match`;let n=Yg(e,t);return n===void 0?`unknown`:n===0?`match`:n>0?`cli-older`:`skill-older`},rS={"cli-older":(e,t)=>`the refs skill targets CLI ${e} but this CLI is ${t} — update the CLI: ${qx}`,match:(e,t)=>`the refs skill is installed and matches this CLI (${t})`,"skill-older":(e,t)=>`the refs skill targets CLI ${e} but this CLI is ${t} — update the skill: ${Kx}`,unknown:(e,t)=>`the refs skill targets CLI ${e} but this CLI is ${t} — reinstall both: ${qx} and ${Kx}`},iS=e=>{let{cliVersion:t,label:n,skillVersion:r}=e;if(r===void 0)return{detail:`the refs skill (${n}) predates the version gate — update it: ${Kx}`,name:`skill`,status:`warn`};let i=nS(r,t);return{detail:`${n}: ${rS[i](r,t)}`,name:`skill`,status:i===`match`?`ok`:`warn`}},aS=e=>({detail:`refs skill not found in the locations this check knows about (${e.map(e=>e.display).join(`, `)}) — an install anywhere else is invisible here and still works; if it really is missing: ${Kx}`,name:`skill`,status:`warn`}),oS=async e=>{let t=Xx(e),n=await Promise.all(t.map(e=>Zx(e.path,e.label))),r=Qx(n.filter(e=>e!==void 0)).map(t=>iS({cliVersion:e.cliVersion,label:t.label,skillVersion:tS(t.source)}));return r.find(e=>e.status!==`ok`)??r[0]??aS(t)},sS=/^(?<user>[^/\s@]+)@(?<host>[^:/\s]+):/u,cS=e=>e===``?{}:{user:e},lS=e=>e===``?{}:{port:e},uS=e=>{try{let t=new URL(e);return t.protocol===`ssh:`?{host:t.hostname,...cS(t.username),...lS(t.port)}:void 0}catch{return}},dS=e=>{let t=sS.exec(e),n=t?.groups?.host;return n===void 0?uS(e):{host:n,user:t?.groups?.user??`git`}},fS=e=>e.port===void 0?e.host:`${e.host}:${e.port}`,pS=e=>e.user===void 0?fS(e):`${e.user}@${fS(e)}`,mS=e=>{let t=Object.values(e.refs).map(e=>dS(e.url)).filter(e=>e!==void 0),n=new Map;for(let e of t)n.set(pS(e),e);return[...n.values()].toSorted((e,t)=>pS(e).localeCompare(pS(t)))},hS=/Permission denied/u,gS=[/Could not resolve hostname/u,/Connection refused/u,/Host key verification failed/u,/timed out/u],_S=e=>e.user===void 0?e.host:`${e.user}@${e.host}`,vS=e=>{let t=[`-o`,`ConnectTimeout=5`,`-o`,`BatchMode=yes`],n=_S(e);return e.port===void 0?[...t,`-T`,n]:[...t,`-p`,e.port,`-T`,n]},yS=async(e,t,n)=>{let r=pS(t),i=await e.runner.run(`ssh`,vS(t),{timeoutMs:n});return i.timedOut===!0?{host:r,outcome:`timeout`}:hS.test(i.stderr)?{host:r,outcome:`denied`}:gS.some(e=>e.test(i.stderr))?{detail:i.stderr.trim(),host:r,outcome:`connection-warn`}:{host:r,outcome:`ok`}},bS=(e,t)=>{let n=e.filter(e=>e.outcome===`timeout`).map(e=>e.host);if(n.length!==0)return{detail:`ssh probe timed out after ${t/1e3}s: ${n.join(`, `)}`,name:`ssh-auth`,status:`fail`}},xS=e=>{let t=e.filter(e=>e.outcome===`denied`).map(e=>e.host);if(t.length!==0)return{detail:`ssh permission denied for: ${t.join(`, `)}`,name:`ssh-auth`,status:`fail`}},SS=e=>{let t=e.filter(e=>e.outcome===`connection-warn`);if(t.length!==0)return{detail:`ssh connection issue, treated as warn: ${t.map(e=>`${e.host} (${e.detail??``})`).join(`; `)}`,name:`ssh-auth`,status:`warn`}},CS=e=>({detail:`ssh auth ok for: ${e.map(e=>e.host).join(`, `)}`,name:`ssh-auth`,status:`ok`}),wS=(e,t)=>bS(e,t)??xS(e)??SS(e)??CS(e),TS=async(e,t,n)=>{let r=mS(t);if(r.length===0)return;let i=n?.timeoutMs??1e4,a=await Promise.all(r.map(t=>yS(e,t,i)));return wS(a,i)},ES=async e=>{try{return await e.run()}catch(t){return{detail:`check crashed: ${Nv(t)}`,name:e.name,status:`fail`}}},DS=async e=>{let[t,...n]=e;if(t===void 0)return[];let r=await ES(t),i=await DS(n);return r===void 0?i:[r,...i]},OS=e=>{let{configLoad:t,ctx:n,home:r,state:i}=e;return[{name:`git`,run:()=>mb(n)},{name:`node`,run:()=>Promise.resolve(vb(n))},{name:`config`,run:()=>Promise.resolve(xb(t.errorMessage))},{name:`hooks-guard`,run:()=>jb(n,r,t.config)},{name:`dirty-checkouts`,run:()=>Pb(n,r,t.config)},{name:`config-drift`,run:()=>Px(r,t.config)},{name:`orphans`,run:()=>Vb(r,t.config,i)},{name:`locks`,run:()=>Hx(r)},{name:`skill`,run:()=>oS(n)},{name:`cli-update`,run:()=>wb(n,t.config)},{name:`ssh-auth`,run:()=>TS(n,t.config)}]},kS=async e=>{let t=z(e.env),n=await bb(t),r=await Fb(t);return DS(OS({configLoad:n,ctx:e,home:t,state:r}))},AS={fail:`FAIL`,ok:`OK`,warn:`WARN`},jS=e=>e.map(e=>`[${AS[e.status]}] ${e.name}: ${e.detail}`),MS=e=>e.some(e=>e.status===`fail`),NS=(e,t)=>{e.command(`doctor`).description(`Run environment/integrity checks (git, node, config, hooks, checkouts, drift, locks, ssh).`).action((e,n)=>{let r=X(n);return Q(t,r,async()=>{let e=await kS(t);Z(t,r,jS(e),{checks:e}),MS(e)&&(process.exitCode=Se.UNEXPECTED)})()})},PS=(e,t)=>{let n=e.refs[t];if(n===void 0)throw Error(`internal: matched ref key '${t}' is missing from config.refs`);return n},FS=(e,t)=>{if(!U(e))throw _(`checkout for '${t}' is missing — run: refs sync ${t}`)},IS=(e,t,n)=>{let r=e.packages?.[n];if(r===void 0)throw _(`no package '${n}' registered on ref '${t}'`);return r},LS=`never`,RS=(e,t,n)=>e===void 0||n-Date.parse(e)>t,zS=(e,t)=>`${e} ${t}${e===1?``:`s`} ago`,BS=(e,t)=>{if(e===void 0)return LS;let n=t-Date.parse(e);if(Number.isNaN(n))return LS;let r=Math.floor(n/1e3);if(r<60)return`just now`;let i=Math.floor(r/60);if(i<60)return zS(i,`minute`);let a=Math.floor(i/60);if(a<24)return zS(a,`hour`);let o=Math.floor(a/24);return o<365?zS(o,`day`):zS(Math.floor(o/365),`year`)},VS=e=>{let t=BS(e.lastFetchedAt,e.now),n=[`synced: ${t}`];return e.stale&&t!==LS&&n.push(`status: stale`),e.missing&&n.push(`missing: checkout not found — run: refs sync`),n},HS=(e,t,n)=>{let r=e.state.refs[t],i=ol(Vg(`sync_ttl`,n,e.settings)),a=Object.keys(n.packages??{}).toSorted();return{clone_mode:Vg(`clone_mode`,n,e.settings),description:n.description,key:t,...r?.last_fetched_at===void 0?{}:{last_fetched_at:r.last_fetched_at},missing:!U(B(e.home,il.parse(t))),...e.includePackages?{packages:a}:{},packages_count:a.length,stale:RS(r?.last_fetched_at,i,e.now)}},US=e=>{let t={home:e.home,includePackages:e.includePackages,now:e.now,settings:e.config.settings,state:e.state};return Object.entries(e.config.refs).map(([e,n])=>HS(t,e,n)).toSorted((e,t)=>e.key.localeCompare(t.key))},WS=async(e,t,n)=>{let r=z(e.env),i=await V(r),a=await Wg(r);return US({config:i,home:r,includePackages:t,now:n,state:a})},GS=(e,t)=>[`ref: ${e.key}`,`description: ${e.description}`,...VS({lastFetchedAt:e.last_fetched_at,missing:e.missing,now:t,stale:e.stale})],KS=(e,t)=>e.length===0?[`no refs configured — run: refs add <source>`]:e.reduce((e,n,r)=>(r>0&&e.push(``),e.push(...GS(n,t)),e),[]),qS=e=>e.split(`/`),JS=(e,t)=>{let n=qS(e);if(t.length>n.length)return!1;let r=n.length-t.length;return t.every((e,t)=>e===n[r+t])},YS=(e,t)=>{if(Object.hasOwn(e.refs,t))return il.parse(t);let n=qS(t),r=Object.keys(e.refs).filter(e=>JS(e,n)).toSorted(),[i]=r;if(i===void 0)throw _(`no ref matches '${t}'`);if(r.length>1)throw v(`'${t}' matches more than one ref: ${r.join(`, `)}`);return il.parse(i)},XS=(e,t)=>{e.command(`list`).description(`List configured refs with their staleness/missing checkout status.`).option(`--packages`,`include each ref's package names in --json output (off by default)`).action((e,n)=>{let r=X(n);return Q(t,r,async()=>{let n=Date.now(),i=await WS(t,e.packages===!0,n);Z(t,r,KS(i,n),i)})()})},ZS=e=>e===void 0?null:e,QS=(e,t)=>e.name===t.name&&e.path===t.path,$S=(e,t)=>{let n=(e.declined_packages??[]).filter(e=>!QS(e,t));if(n.length===0){let{declined_packages:t,...n}=e;return n}return{...e,declined_packages:n}},eC=(e,t)=>`package '${e.name}' at '${e.path}' is already declined on ref '${t}'`,tC=(e,t)=>`package '${e.name}' at '${e.path}' is not declined on ref '${t}' — nothing to undo`,nC=(e,t)=>`package '${e}' is registered on ref '${t}' — declining applies to packages the configuration does not have; unregister it first with --remove`,rC=(e,t,n)=>{if(Object.hasOwn(e.packages??{},t.name))throw y(nC(t.name,n));let r=e.declined_packages??[];if(r.some(e=>QS(e,t)))throw y(eC(t,n));return{...e,declined_packages:[...r,t]}},iC=e=>{if(e.declined)return rC(e.entry,e.record,e.key);if(!(e.entry.declined_packages??[]).some(t=>QS(t,e.record)))throw y(tC(e.record,e.key));return $S(e.entry,e.record)},aC=(e,t)=>{let n=z(e.env);return G(n,`home`,async()=>{let e=await V(n),r=YS(e,t.query),i=PS(e,r),a={name:t.packageName,path:t.path},o=iC({declined:t.declined,entry:i,key:r,record:a});return await fu(n,{...e,refs:{...e.refs,[r]:o}}),{declined:t.declined,field:`declined_packages`,key:r,new:t.declined?a:null,old:t.declined?null:a}})},oC=`packages`,sC=()=>Object.keys(hl.shape).toSorted().join(`, `),cC=e=>`unknown package field '${e}' — valid fields: ${sC()}`,lC=e=>Object.hasOwn(hl.shape,e),uC=(e,t,n)=>{if(!lC(t))throw v(cC(t));let r=e[t],i=hl.safeParse({...e,[t]:n});if(!i.success)throw y(T(i.error));return{field:t,newValue:i.data[t],oldValue:r,updated:i.data}},dC=async e=>{let t=IS(e.entry,e.key,e.packageName),n=uC(t,e.field,e.value),r={...e.entry,packages:{...e.entry.packages,[e.packageName]:n.updated}};return await fu(e.home,{...e.config,refs:{...e.config.refs,[e.key]:r}}),{field:n.field,key:e.key,new:ZS(n.newValue),old:ZS(n.oldValue)}},fC=(e,t)=>`package '${e}' is already registered on ref '${t}' — edit its fields instead`,pC=(e,t)=>{let n=z(e.env);return G(n,`home`,async()=>{let e=await V(n),r=YS(e,t.query),i=PS(e,r);if(Object.hasOwn(i.packages??{},t.packageName))throw y(fC(t.packageName,r));let a=gl.safeParse({...$S(i,{name:t.packageName,path:t.path}),packages:{...i.packages,[t.packageName]:{description:t.description,path:t.path}}});if(!a.success)throw y(T(a.error));return await fu(n,{...e,refs:{...e.refs,[r]:a.data}}),{created:!0,field:oC,key:r,new:{description:t.description,name:t.packageName,path:t.path},old:null}})},mC=(e,t)=>`package '${e}' is not registered on ref '${t}' — nothing to remove`,hC=(e,t)=>{let n=z(e.env);return G(n,`home`,async()=>{let e=await V(n),r=YS(e,t.query),i=PS(e,r),a=i.packages??{};if(!Object.hasOwn(a,t.packageName))throw y(mC(t.packageName,r));let{[t.packageName]:o,...s}=a,c=Object.keys(s).length===0?gC(i):{...i,packages:s};return await fu(n,{...e,refs:{...e.refs,[r]:c}}),{field:oC,key:r,new:null,old:{description:o?.description??``,name:t.packageName,path:o?.path??``},removed:!0}})},gC=e=>{let{packages:t,...n}=e;return n},_C=e=>e.second===void 0&&e.value===void 0,vC=e=>{let{description:t,path:n}=e.create,{packageName:r}=e;if(r===void 0||t===void 0||n===void 0||!_C(e))throw v(`--create registers a new package: it needs --package <name>, --path <path> and --description <text>, and takes no <field> <value> arguments`);return{description:t,packageName:r,path:n}},yC=e=>{let{packageName:t}=e;if(t===void 0||e.create.path!==void 0||!_C(e)||e.create.description!==void 0)throw v(`--remove unregisters a package: it needs --package <name>, and takes no <field> <value> arguments, no --path and no --description`);return{packageName:t}},bC=e=>{let{packageName:t}=e,{path:n}=e.create;if(t===void 0||n===void 0||!_C(e)||e.create.description!==void 0)throw v(`--decline and --undecline record a decision about one package at one path: each needs --package <name> and --path <path>, and takes no <field> <value> arguments and no --description`);return{packageName:t,path:n}},xC=[`create`,`remove`,`decline`,`undecline`],SC=e=>{let t=xC.filter(t=>e[t]===!0);if(t.length>1)throw v(`use one of --create, --remove, --decline or --undecline: they are different answers about the same package, and running two at once would guess which one was meant`);return t[0]},CC=(e,t,n)=>t===`create`?pC(e,{...vC(n),query:n.first}):t===`remove`?hC(e,{...yC(n),query:n.first}):aC(e,{...bC(n),declined:t===`decline`,query:n.first}),wC=`packages`,TC=()=>Object.keys(gl.shape).filter(e=>e!==wC).toSorted().join(`, `),EC=e=>`unknown ref field '${e}' — valid fields: ${TC()}`,DC=e=>Object.hasOwn(gl.shape,e),OC=(e,t,n)=>`failed to rewrite git remote at ${e} to '${W(t)}': ${n.trim()}`,kC=async(e,t)=>{if(iu(t.home,t.dest),!U(t.dest))return;let n=await e.runner.run(`git`,[`remote`,`set-url`,`--`,`origin`,t.cloneUrl],{cwd:t.dest});if(n.exitCode!==0)throw y(OC(t.dest,t.cloneUrl,n.stderr))},AC=async(e,t)=>{let n=gf(t.value,{allowFileUrls:iy(e.env)});if(n.key!==t.key)throw y(`new url derives a different key — remove and re-add instead`);let r=B(t.home,t.key);return await kC(e,{cloneUrl:n.cloneUrl,dest:r,home:t.home}),{...t.entry,url:n.cloneUrl}},jC=(e,t,n)=>{let r={...e,[t]:n},i=gl.safeParse(r);if(!i.success)throw y(T(i.error));return i.data},MC=(e,t)=>t.field===`url`?AC(e,{entry:t.entry,home:t.home,key:t.key,value:t.value}):Promise.resolve(jC(t.entry,t.field,t.value)),NC=async(e,t)=>{let{field:n}=t;if(n===wC)throw v(`use --package <name> <field> <value>`);if(!DC(n))throw v(EC(n));let r=t.entry[n],i=await MC(e,{entry:t.entry,field:n,home:t.home,key:t.key,value:t.value});return{new:i[n],old:r,updated:i}},PC=(e,t)=>{let n=z(e.env),{field:r,opts:i,query:a,value:o}=t;return G(n,`home`,async()=>{let t=await V(n),s=YS(t,a),c=PS(t,s);if(i.packageName!==void 0)return dC({config:t,entry:c,field:r,home:n,key:s,packageName:i.packageName,value:o});let l=await NC(e,{entry:c,field:r,home:n,key:s,value:o});return await fu(n,{...t,refs:{...t.refs,[s]:l.updated}}),{field:r,key:s,new:ZS(l.new),old:ZS(l.old)}})},FC=`settings`,IC=[],LC=()=>Object.keys(fl.shape).toSorted().join(`, `),RC=e=>`unknown setting '${e}' — valid settings: ${LC()}`,zC=e=>Object.hasOwn(fl.shape,e),BC=e=>`note: 'settings' addressed the global settings, not ${e} — use the full ref key to edit that ref`,VC=e=>{try{let t=YS(e,FC);return[BC(`ref '${t}'`)]}catch(e){if(e instanceof g&&e.code===`usage`)return[BC("one of several matching refs — see `refs list`")];if(e instanceof g&&e.code===`not_found`)return IC;throw e}},HC=e=>({data:{field:e.key,key:FC,new:ZS(e.parsed[e.key]),old:ZS(e.old)},warnings:VC(e.config)}),UC=(e,t)=>{let n=z(e.env);return G(n,`home`,async()=>{let e=await V(n);if(!zC(t.key))throw v(RC(t.key));let r=e.settings[t.key],i={...e.settings,[t.key]:t.value},a=fl.safeParse(i);if(!a.success)throw y(T(a.error));return await fu(n,{...e,settings:a.data}),HC({config:e,key:t.key,old:r,parsed:a.data})})},WC=[],GC=e=>{let t={};return e.package!==void 0&&(t.packageName=e.package),t},KC=e=>{if(e.second===void 0||e.value===void 0)throw v(`missing <field> and <value> — see 'refs edit --help'`);return{field:e.second,value:e.value}},qC=(e,t,n)=>{if(t.opts.packageName!==void 0)throw v(`--package is not valid with 'refs edit settings ...' — it only applies to ref/package edits`);return UC(e,n)},JC=async(e,t)=>{if(t.create.description!==void 0||t.create.path!==void 0)throw v(`--path and --description only apply to the package modes — to change one field of a registered package use: refs edit <ref> <field> <value> --package <name>`);let{field:n,value:r}=KC(t);return t.first===`settings`?qC(e,t,{key:n,value:r}):{data:await PC(e,{field:n,opts:t.opts,query:t.first,value:r}),warnings:WC}},YC=async(e,t)=>{let n=SC(t.create);return n===void 0?JC(e,t):{data:await CC(e,n,{create:t.create,first:t.first,packageName:t.opts.packageName,second:t.second,value:t.value}),warnings:WC}},XC=e=>e==null?`(unset)`:String(e),ZC=(e,t)=>{let n=t?e.new:e.old,r=t?`declined`:`no longer declining`;return`${e.key}: ${r} '${n.name}' at ${n.path}`},QC=e=>{if(e.created===!0){let t=e.new;return`${e.key}: registered '${t.name}' at ${t.path}`}if(e.removed===!0){let t=e.old;return`${e.key}: unregistered '${t.name}' (was at ${t.path})`}return e.declined===void 0?void 0:ZC(e,e.declined)},$C=e=>{let t=QC(e);return t===void 0?[`${e.key}: ${e.field} '${XC(e.old)}' -> '${XC(e.new)}'`]:[t]},ew=(e,t)=>{e.command(`edit`).description(`Edit one field: 'refs edit settings <key> <value>' for a global setting, or 'refs edit <ref> <field> <value> [--package <name>]' for a ref or package field. With --create, registers a package the config does not have yet; with --remove, unregisters one it has; with --decline, records that a package the checkout declares is deliberately not registered, so drift stops reporting it.`).argument(`<ref-or-settings>`,`a ref key/unique suffix, or the literal 'settings'`).argument(`[field-or-key]`,`field to edit (or, in settings mode, the setting key)`).argument(`[value]`,`the new value`).option(`--package <name>`,`edit this package's field instead of a top-level ref field`).option(`--create`,`register --package as a new package on this ref`).option(`--remove`,`unregister --package from this ref, leaving the checkout alone`).option(`--decline`,`record that --package at --path is deliberately not registered`).option(`--undecline`,`withdraw a decline, so the package is reported again`).option(`--path <path>`,`with --create/--decline/--undecline: the package path, relative to the checkout root`).option(`--description <text>`,`with --create: what the package is`).action((e,n,r,i,a)=>{let o=X(a);return Q(t,o,async()=>{let{data:a,warnings:s}=await YC(t,{create:i,first:e,opts:GC(i),second:n,value:r});Z(t,o,$C(a),a,s)})()})},tw=`Install the agent skill: npx skills add kaisers-io/refs (from a local clone: npx skills add <path-to-this-repo> --skill refs)`,nw={migrated:`migrated`,noop:`unchanged`,seeded:`seeded`},rw=async e=>{await a(e.root,{recursive:!0}),await a(e.sourcesDir,{recursive:!0}),await a(e.locksDir,{recursive:!0}),await a(e.hooksDir,{recursive:!0})},iw=async e=>{let t=z(e.env);return await rw(t),{config:await G(t,`home`,async()=>{let e=await Su(t,fv);return await Nd(t),e}),home:t.root,skill_hint:tw}},aw=(e,t)=>{e.command(`init`).description(`Seed or migrate the refs home directory, its config, and the git hooks guard.`).action((e,n)=>{let r=X(n);return Q(t,r,async()=>{let e=await iw(t);Z(t,r,[`home: ${e.home}`,`config: ${nw[e.config]}`,``,tw],e)})()})},ow=async e=>{let t=z(e.env),n=await G(t,`home`,()=>Su(t,fv));return n===`migrated`?{backup:eu(t),result:n}:{backup:null,result:n}},sw=e=>e.result===`migrated`&&e.backup!==null?`config migrated (backup: ${re(e.backup)})`:e.result===`seeded`?`config seeded`:`config up to date`,cw=(e,t)=>{e.command(`migrate`).description(`Migrate the refs config to the current schema, seeding it if absent.`).action((e,n)=>{let r=X(n);return Q(t,r,async()=>{let e=await ow(t);Z(t,r,sw(e),e)})()})},lw=async e=>{try{return await i(e),!0}catch(e){if(R(e))return!1;throw e}},uw=async e=>{try{return await c(e)}catch(e){if(R(e))return;throw e}},dw=async e=>{try{return(await i(e)).isDirectory()}catch(e){if(R(e))return;throw e}},fw=async e=>{let t=await uw(e);if(t===void 0)return!0;if(t.length>0)return!1;try{await f(e)}catch(e){if(!R(e))throw e}return!0},pw=async e=>{let t=await dw(e);return t===void 0?!0:t?fw(e):!1},mw=async(e,t)=>{t!==e.sourcesDir&&await pw(t)&&await mw(e,ie(t))},hw=async(e,t)=>await lw(t)?(iu(e,t),await d(t,{force:!0,recursive:!0}),await mw(e,ie(t)),{removedCheckout:!0}):{removedCheckout:!1,warning:`checkout was already missing`},gw=(e,t)=>Object.fromEntries(Object.entries(e).filter(([e])=>e!==t)),_w=async(e,t)=>{let n=await V(e),r={...n,refs:gw(n.refs,t)};await fu(e,r);let i=await Wg(e),a={...i,refs:gw(i.refs,t)};await Gg(e,a)},vw=async(e,t)=>{let n=z(e.env),r=await V(n),i=YS(r,t),a=B(n,i),{removedCheckout:o,warning:s}=await G(n,ry(i),()=>hw(n,a));return await G(n,`home`,()=>_w(n,i)),{data:{key:i,removed_checkout:o},warnings:Mv(s)}},yw=e=>e.removed_checkout?[`removed ${e.key} (checkout deleted)`]:[`removed ${e.key} (checkout was already missing)`],bw=(e,t)=>{e.command(`remove`).description(`Remove a configured ref: its config/state entry AND its checkout directory.`).argument(`<ref>`,`full ref key or a unique suffix, e.g. zod`).action((e,n,r)=>{let i=X(r);return Q(t,i,async()=>{let{data:n,warnings:r}=await vw(t,e);Z(t,i,yw(n),n,r)})()})},xw=async e=>{let t=await Qh(e.checkoutDir,e.configuredPath,e.packageName);return t.kind===`match`?{path:e.configuredPath,status:`verified`}:t.kind===`unreadable`?{path:e.configuredPath,reason:t.reason,status:`unverifiable`}:Sw(e)},Sw=async e=>bx(e,await dv(e.checkoutDir)),Cw=async e=>{try{return await G(e.home,ry(e.key),()=>xw(e),e.lockTimeoutMs===void 0?void 0:{timeoutMs:e.lockTimeoutMs})}catch(t){if(t instanceof g&&t.code===`conflict`)return{path:e.configuredPath,reason:`could not acquire the ref lock in time`,status:`unverifiable`};throw t}},ww=async e=>{if(!U(e.checkoutDir))return{path:e.configuredPath,status:`unmaterialized`};let t=await Qh(e.checkoutDir,e.configuredPath,e.packageName);return t.kind===`match`?{path:e.configuredPath,status:`verified`}:t.kind===`unreadable`?{path:e.configuredPath,reason:t.reason,status:`unverifiable`}:(e.onProbed?.(),Cw(e))},Tw=(e,t)=>({local_path:null,name:e,path:null,reason:t,status:`unverifiable`}),Ew=async e=>{if(!e.checkoutManaged)return Tw(e.packageName,e.checkoutReason);let t=await ww(e),n=(t.status===`verified`||t.status===`relocated`)&&t.path!==null?await Fg(m(e.checkoutDir,t.path),e.packageName):void 0;return{...t.candidates===void 0?{}:{candidates:t.candidates},...t.configuredPath===void 0?{}:{configured_path:t.configuredPath},...n===void 0?{}:{entry_points:n},local_path:t.path===null?null:m(e.checkoutDir,t.path),name:e.packageName,path:t.path,...t.reason===void 0?{}:{reason:t.reason},status:t.status}},Dw=e=>e.kind===`target`?[{observed:e.observed,target:e.target}]:e.kind===`alternatives`?e.alternatives.flatMap(e=>Dw(e)):e.kind===`conditions`?e.branches.flatMap(e=>Dw(e.value)):[],Ow=e=>{if(e.length===0)return[];let t=e.filter(e=>e.observed===`not_checked`||e.observed===`unverifiable`).length,n=e.length-t,r=t===0?``:`, ${t} not inspected`;return n===0?[`entry points: none of the ${e.length} declared target(s) was inspected`]:[`entry points: ${n} declared target(s) absent here${r}`]},kw=e=>{if(e.status!==`complete`)return[`entry points: could not be read (${e.reason??`unknown`})`];let t=e.entries.flatMap(e=>Dw(e.value)),n=t.filter(e=>e.observed===`file`||e.observed===`directory`);if(n.length===0)return Ow(t);let r=n.slice(0,3).map(e=>e.target),i=n.length-r.length;return[`entry points present: ${r.join(`, `)}${i===0?``:` (+${i} more)`}`]},Aw=e=>[`package: ${e.name}`,`package path: ${e.local_path??`(unknown)`}`,...e.status===`verified`?[]:[`package status: ${e.status}`],...e.configured_path===void 0?[]:[`configured path: ${e.configured_path}`],...e.candidates===void 0?[]:[`candidates: ${e.candidates.join(`, `)}`],...e.reason===void 0?[]:[`reason: ${e.reason}`],...e.entry_points===void 0?[]:kw(e.entry_points)],jw=`node_modules`,Mw=[`.pnp.cjs`,`.pnp.js`],Nw=new Set([``,`.`,`..`]),Pw=e=>!ae(e)&&!e.includes(`\\`)&&e.split(`/`).every(e=>!Nw.has(e)),Fw=function*(e){let t=ce(e);for(;;){re(t)!==jw&&(yield m(t,jw));let e=ie(t);if(e===t)return;t=e}},Iw=async e=>{if(await zw(e)!==`absent`)try{let t=JSON.parse(await s(e,`utf8`)),{name:n,version:r}=typeof t==`object`&&t?t:{};return typeof r!=`string`||r===``?{package_json:e,reason:`manifest_has_no_version`,status:`unverifiable`}:{...typeof n==`string`?{name:n}:{},package_json:e,status:`found`,version:r}}catch{return{package_json:e,reason:`manifest_unreadable`,status:`unverifiable`}}},Lw=new Set([`ENOENT`,`ENOTDIR`]),Rw=async e=>{try{return(await c(e)).length===0}catch{return!1}},zw=async e=>{try{return await p(e),`present`}catch(e){let t=typeof e==`object`&&e&&`code`in e&&typeof e.code==`string`?e.code:void 0;return t!==void 0&&Lw.has(t)?`absent`:`unreadable`}},Bw=async e=>{for(let t of Fw(e)){let e=ie(t);if((await Promise.all(Mw.map(t=>zw(m(e,t))))).includes(`present`))return!0}return!1},Vw=async e=>{try{if(!(await p(e)).isDirectory())throw v(`--project must be a directory: ${e}`)}catch(t){throw t instanceof Error&&t.message.startsWith(`--project`)?t:v(`--project path does not exist: ${e}`)}},Hw=async e=>{let t=await zw(e);if(t===`unreadable`)return{reason:`slot_unreadable`,status:`unverifiable`};if(t===`absent`)return;let n=await Iw(m(e,`package.json`));return n===void 0?await Rw(e)?void 0:{reason:`installed_without_manifest`,status:`unverifiable`}:n},Uw=async(e,t)=>{if(!Pw(t))return{reason:`unsupported_package_name`,status:`unverifiable`};for(let n of Fw(e)){let e=await Hw(m(n,...t.split(`/`)));if(e!==void 0)return e}return await Bw(e)?{reason:`yarn_pnp`,status:`unsupported_layout`}:{status:`not_materialized`}},Ww={'"':`"`,"\\":`\\`,b:`\b`,n:`
|
|
351
|
-
`,t:` `},
|
|
349
|
+
packages to describe: ${Object.keys(e).toSorted().join(`, `)}`)},dy=e=>{if(Object.keys(e).length!==0)return e},fy=e=>{let t={default_branch:e.default_branch,description:e.description,url:e.url};return e.packages!==void 0&&(t.packages=e.packages),e.tag_format!==void 0&&(t.tag_format=e.tag_format),t},py=`ref.`,my=`${py}_`,hy=`${my}_`,gy=e=>`${hy}${ue(`sha256`).update(e,`utf8`).digest(`hex`)}`,_y=e=>{let t=e.includes(`_`)?`${my}${e.replaceAll(`_`,`_u`).replaceAll(`/`,`_s`)}`:`${py}${e.replaceAll(`/`,`_`)}`;return Buffer.byteLength(t,`utf8`)<=212&&zp(t)?t:gy(e)},vy=e=>e.REFS_ALLOW_FILE_URLS===`1`,yy=(e,t)=>{let n=gf(t,{allowFileUrls:vy(e.env)});return{cloneUrl:n.cloneUrl,key:n.key}},by=async(e,t)=>{if(t===``)throw v(`refs add npm: requires a package name, e.g. npm:left-pad`);Jv(e,`resolving npm package '${t}'…`);let n=await em(e.fetcher,t),r={cloneUrl:n.cloneUrl,key:n.key,npmPkgName:t};return n.directory!==void 0&&(r.npmDirectory=n.directory),r},xy=(e,t)=>t.startsWith(`npm:`)?by(e,t.slice(4)):Promise.resolve(yy(e,t)),Sy=(e,t)=>{if(e.npmPkgName===void 0)return e;let n=Vg(`git_transport`,void 0,t);return{...e,cloneUrl:Df(e.cloneUrl,n)}},Cy=e=>`ref '${e}' already exists — use refs edit or refs remove`,wy=(e,t)=>{if(e.refs[t]!==void 0)throw Ce(Cy(t))},Ty=async e=>{try{return await c(e,{withFileTypes:!0})}catch(e){if(R(e))return;throw e}},Ey=e=>e.filter(e=>e.isDirectory()).map(e=>e.name),Dy=async(e,t)=>{let n=await Ty(e);if(n===void 0)return{kind:`stop`};let r=Ey(n);if(r.includes(t))return{kind:`continue`,nextDir:m(e,t)};let i=r.find(e=>e.toLowerCase()===t.toLowerCase());return i===void 0?{kind:`stop`}:{kind:`collision`,name:i}},Oy=async(e,t,n)=>{let[r,...i]=t;if(r===void 0)return;let a=await Dy(e,r);if(a.kind!==`stop`)return a.kind===`collision`?[...n,a.name].join(`/`):Oy(a.nextDir,i,[...n,r])},ky=[],Ay=async(e,t)=>{let n=await Oy(e.sourcesDir,t.split(`/`),ky);if(n!==void 0)throw Ce(`checkout path for '${t}' collides case-insensitively with existing '${n}'`)},jy=e=>{switch(e.kind){case`candidate_not_inspected`:case`manifest_missing_name`:case`manifest_unreadable`:case`workspace_dir_unreadable`:return e.path;case`workspace_declaration_unparsed`:case`workspace_file_unreadable`:return e.file;case`unsupported_pattern`:return e.pattern;case`scan_budget_exhausted`:return`${e.pattern} at ${e.path}`;case`no_workspace_declaration`:return}},My=e=>e.diagnostics.filter(e=>!Gh({diagnostics:[e],packages:[]})).map(e=>{let t=jy(e);return t===void 0?e.kind:`${t}: ${e.kind}`}).toSorted().join(`, `),Ny=(e,t,n)=>`checkout at ${e} points at '${W(t)}' — expected '${W(n)}'; remove the checkout directory or run refs remove before retrying`,Py=e=>e.exitCode===0?e.stdout.trim():`(no origin remote)`,Fy=(e,t)=>{try{return gf(e,{allowFileUrls:t}).key}catch{return}},Iy=async(e,t)=>{let n=await e.run(`git`,[`remote`,`get-url`,`origin`],{cwd:t.dest}),r=Py(n),i=Fy(t.expectedUrl,t.allowFileUrls),a=Fy(r,t.allowFileUrls);if(i===void 0||a!==i)throw Ce(Ny(t.dest,r,t.expectedUrl))},Ly=e=>`checkout at ${e} exists but is not refs-managed — remove it (${Qv(e)}) and retry`,Ry=async(e,t)=>{let n=await e.run(`git`,[`config`,`--local`,`core.hooksPath`],{cwd:t.dest});if(n.exitCode!==0||n.stdout.trim()!==t.hooksDir)throw Ce(Ly(t.dest))},zy=async(e,t)=>{await a(ie(t.dest),{recursive:!0}),Jv(e,`cloning ${W(t.cloneUrl)} into ${t.dest}…`);let n=await Sd(e.runner,t);return n.warning===void 0?{effectiveMode:n.effectiveMode}:{effectiveMode:n.effectiveMode,warning:n.warning}},By=async(e,t)=>(iu(t.home,t.dest),U(t.dest)?(await Iy(e.runner,{allowFileUrls:t.allowFileUrls,dest:t.dest,expectedUrl:t.cloneUrl}),await Ry(e.runner,{dest:t.dest,hooksDir:t.hooksDir}),{}):zy(e,t)),Vy=(e,t)=>`checkout for '${e}' at ${t} is missing or corrupt (git rev-parse HEAD failed) — run: refs remove ${e}, then refs add <source> --dry-run again`,Hy=(e,t,n)=>`checkout for '${e}' at ${t} has a HEAD sha refs cannot store yet (${n.length} hex chars, expected 40) — only SHA-1 repositories are supported for now; \`--object-format=sha256\` repositories are not yet supported`,Uy=async(e,t)=>{await Iy(e,t),await Ry(e,{dest:t.dest,hooksDir:t.hooksDir});let n=await e.run(`git`,[`rev-parse`,`HEAD`],{cwd:t.dest});if(n.exitCode!==0)throw y(Vy(t.key,t.dest));let r=n.stdout.trim();if(!zg.shape.head_sha.safeParse(r).success)throw y(Hy(t.key,t.dest,r));return r},Wy=e=>Gh(e)?void 0:`workspace detection could not fully inspect the declared workspaces (${My(e)}) — members may be missing from the detected packages; the repository's own workspace declaration is what settles it`,Gy=(e,t)=>{let n=iy(e.packages,t.resolved.npmDirectory,t.resolved.npmPkgName),r=sy(e.packages,n),i=Wy(e);return{defaultBranch:t.defaultBranch,...i===void 0?{}:{detectionWarning:i},packages:n,...r===void 0?{}:{rootPackageName:r},tagFormatCandidate:t.tagFormatCandidate}},Ky=e=>e.complete?Wd(e.tags):null,qy=async(e,t,n)=>{let r=await wd(e.runner,t),i=await Pd(e.runner,t),a=Ky(i);Jv(e,`detecting workspace packages…`);let o=await dv(t);return Gy(o,{defaultBranch:r,resolved:n,tagFormatCandidate:a})},Jy=(e,t)=>G(t.home,_y(t.resolved.key),async()=>{let n=await By(e,{allowFileUrls:vy(e.env),cloneUrl:t.resolved.cloneUrl,dest:t.dest,home:t.home,hooksDir:t.home.hooksDir,mode:t.cloneMode}),r={fields:await qy(e,t.dest,t.resolved)};return n.effectiveMode!==void 0&&(r.effectiveMode=n.effectiveMode),n.warning!==void 0&&(r.warning=n.warning),r}),Yy=(e,t)=>({default_branch:e.defaultBranch,description:``,key:t.key,packages:e.packages,tag_format_candidate:e.tagFormatCandidate,url:t.cloneUrl}),Xy=e=>{let{effectiveMode:t,fields:n,warning:r}=e.cloneResult;return{dest:e.dest,proposal:Yy(n,e.resolved),...n.detectionWarning===void 0?{}:{detectionWarning:n.detectionWarning},...n.rootPackageName===void 0?{}:{rootPackageName:n.rootPackageName},...t===void 0?{}:{effectiveCloneMode:t},...r===void 0?{}:{warning:r}}},Zy=async(e,t)=>{let n=z(e.env),r=await V(n),i=Sy(await xy(e,t),r.settings);wy(r,i.key),await Ay(n,i.key);let a=B(n,i.key),o=Vg(`clone_mode`,void 0,r.settings),s=await Jy(e,{cloneMode:o,dest:a,home:n,resolved:i});return Xy({cloneResult:s,dest:a,resolved:i})},Qy=(e,t,n)=>G(e,`home`,async()=>{let r=await V(e);wy(r,t);let i=await Wg(e),a=i.refs[t],o=n??a?.effective_clone_mode,s={...a,pending_proposal_at:new Date().toISOString()};o!==void 0&&(s.effective_clone_mode=o),i.refs[t]=s,await Gg(e,i)}),$y=(e,t)=>{let n=bl.safeParse(e);if(!n.success)throw y(T(n.error));let r=Bg.safeParse(t);if(!r.success)throw y(T(r.error));return{config:n.data,state:r.data}},eb=async(e,t)=>{let n=await V(e.home);wy(n,e.ref.key);let r=fy(e.ref);n.refs[e.ref.key]=r;let i=await Wg(e.home);return i.refs[e.ref.key]={effective_clone_mode:e.effectiveCloneMode??i.refs[e.ref.key]?.effective_clone_mode??Vg(`clone_mode`,void 0,n.settings),head_sha:t,last_fetched_at:new Date().toISOString()},{...$y(n,i),entry:r}},tb=async(e,t)=>{let n=vy(e.env),r=await G(t.home,_y(t.ref.key),()=>(iu(t.home,t.dest),Uy(e.runner,{allowFileUrls:n,dest:t.dest,expectedUrl:t.ref.url,hooksDir:t.home.hooksDir,key:t.ref.key})));return G(t.home,`home`,async()=>{let{config:e,entry:n,state:i}=await eb(t,r);return await Gg(t.home,i),await fu(t.home,e),{entry:n,key:t.ref.key}})},nb=(e,t)=>t===`-`?e.readStdin():s(t,`utf8`),rb=e=>{try{return JSON.parse(e)}catch(e){throw y(`invalid JSON in proposal: ${Kv(e)}`)}},ib=e=>typeof e==`object`&&!!e&&!Array.isArray(e),ab=e=>ib(e)&&`ok`in e&&!(`key`in e),ob=e=>{if(!ab(e))return e;if(e.ok===!1)throw y(`proposal file contains a failed refs envelope (ok is false) — re-run the dry-run`);if(ib(e.data))return e.data;throw y(`proposal file is a refs envelope without a usable data object — re-run the dry-run`)},sb=e=>e.code===`unrecognized_keys`,cb=e=>e.path.length===0,lb=(e,t)=>{let n=t.toSorted().map(e=>`"${e}"`).join(`, `);return e===``?`✖ unrecognized key(s) in proposal: ${n}`:`✖ unrecognized key(s) in proposal at ${e}: ${n}`},ub=e=>{let t=new Map;for(let n of e){let e=Yt(n.path);t.set(e,[...t.get(e)??[],...n.keys])}return[...t.entries()].toSorted(([e],[t])=>e.localeCompare(t)).map(([e,t])=>lb(e,t))},db=e=>`✖ invalid proposal: ${e.message}`,fb=e=>{let t=e.issues.filter(e=>sb(e)),n=e.issues.filter(e=>!sb(e)),r=n.filter(e=>cb(e));if(t.length===0&&r.length===0)return T(e);let i=n.filter(e=>!cb(e)),a=[...ub(t),...r.map(e=>db(e))];return i.length>0&&a.push(T({issues:i})),a.join(`
|
|
350
|
+
`)},pb=e=>{let t=Rg.safeParse(e);if(!t.success)throw y(fb(t.error));return t.data},mb=async(e,t)=>{let n=await nb(e,t);return pb(ob(rb(n)))},hb=(e,t)=>[`refs add: dry-run proposal ready for '${e}' (checkout: ${t})`,`next: review the proposal, then run refs add --proposal <file> to finalize`],gb=e=>[...Gv(e.warning),...Gv(e.detectionWarning)],_b=async(e,t)=>{let n=await Zy(e,t),r=z(e.env);await Qy(r,n.proposal.key,n.effectiveCloneMode);let i=gb(n);return{data:n.proposal,human:hb(n.proposal.key,n.dest),warnings:i}},vb=e=>[`refs add: '${e}' added to config`],yb=e=>{let t={default_branch:e.default_branch,description:e.description,key:e.key,url:e.url};e.tag_format_candidate!==null&&(t.tag_format=e.tag_format_candidate);let n=dy(e.packages);return n!==void 0&&(t.packages=n),t},bb=async(e,t)=>{let n=await mb(e,t),r=z(e.env),i=B(r,n.key);if(!U(i))throw _(`no checkout found at ${i} — run: refs add <source> --dry-run first`);let a=yb(n),{entry:o,key:s}=await tb(e,{dest:i,home:r,ref:a});return{data:{entry:o,key:s},human:vb(s),warnings:[]}},xb=(e,t,n)=>{uy(e.proposal.packages,n,e.rootPackageName);let r={default_branch:e.proposal.default_branch,description:t,key:e.proposal.key,url:e.proposal.url};e.proposal.tag_format_candidate!==null&&(r.tag_format=e.proposal.tag_format_candidate);let i=oy(e.proposal.packages,{refDescription:t,...e.rootPackageName===void 0?{}:{rootPackageName:e.rootPackageName}});return i!==void 0&&(r.packages=i),r},Sb=async(e,t,n)=>{let r=await Zy(e,t),i=z(e.env);await Qy(i,r.proposal.key,r.effectiveCloneMode);let a=xb(r,n,t),o={dest:r.dest,home:i,ref:a};r.effectiveCloneMode!==void 0&&(o.effectiveCloneMode=r.effectiveCloneMode);let{entry:s,key:c}=await tb(e,o);return{data:{entry:s,key:c},human:vb(c),warnings:gb(r)}},Cb=e=>{let t=[e.dryRun,e.proposal!==void 0,e.description!==void 0].filter(Boolean).length;if(t>1)throw v(`refs add: use only one of --dry-run, --proposal, or --description`);if(t===0)throw v(`refs add needs --dry-run, --proposal, or --description`)},wb=e=>{if(e===void 0||e===``)throw v(`refs add requires <source> (a git url or npm:<package>)`);return e},Tb=(e,t)=>(Cb(t),t.proposal===void 0?t.description===void 0?_b(e,wb(t.source)):Sb(e,wb(t.source),t.description):bb(e,t.proposal)),Eb=(e,t)=>{let n={dryRun:t.dryRun===!0};return e!==void 0&&(n.source=e),t.proposal!==void 0&&(n.proposal=t.proposal),t.description!==void 0&&(n.description=t.description),n},Db=(e,t)=>{e.command(`add`).description(`Add a git reference in two phases: propose (--dry-run), then finalize (--proposal).`).argument(`[source]`,`git url or npm:<package> (omit when finalizing with --proposal)`).option(`--dry-run`,`resolve and clone the source, writing a reviewable proposal`).option(`--proposal <file>`,`finalize from a completed proposal JSON file (- for stdin)`).option(`--description <text>`,`one-shot: dry-run then finalize immediately with this description`).action((e,n,r)=>{let i=X(r);return Q(t,i,async()=>{let r=await Tb(t,Eb(e,n));Z(t,i,r.human,r.data,r.warnings)})()})},Ob=async e=>{let t=await e.runner.run(`git`,[`--version`]);return t.exitCode===0?{detail:t.stdout.trim(),name:`git`,status:`ok`}:{detail:t.stderr.trim()||`git --version exited with code ${t.exitCode}`,name:`git`,status:`fail`}},kb=/^v(?<major>\d+)\.(?<minor>\d+)/u,Ab=e=>{let t=kb.exec(e),n=t?.groups?.major,r=t?.groups?.minor;if(n!==void 0&&r!==void 0)return{major:Number(n),minor:Number(r)}},jb=e=>e===void 0?!1:e.major>24||e.major===24&&e.minor>=2,Mb=e=>{let{nodeVersion:t}=e;return jb(Ab(t))?{detail:t,name:`node`,status:`ok`}:{detail:`${t} does not satisfy the required range >=24.2`,name:`node`,status:`fail`}},Nb=()=>bl.parse({meta:{cli_version:`0.0.0`,schema_version:1},refs:{},settings:{}}),Pb=async e=>{try{return{config:await V(e)}}catch(e){return{config:Nb(),errorMessage:Kv(e)}}},Fb=e=>e===void 0?{detail:`config is present and matches the current schema`,name:`config`,status:`ok`}:{detail:e,name:`config`,status:`fail`},Ib={ci:`update check is off in CI — set REFS_UPDATE_CHECK=1 to run it here anyway`,config:`update check is off ([updates].check = false in config.toml)`,env:`update check is off (REFS_UPDATE_CHECK=0)`},Lb=(e,t,n)=>{if(r_(e,t)){let r=n?` (npm was unreachable just now; this was its last answer)`:``;return{detail:`${i_(e,t)}${r}`,name:`cli-update`,status:`warn`}}return n?{detail:`could not reach npm to check; its last answer was ${t}, which this CLI (${e}) already has`,name:`cli-update`,status:`warn`}:{detail:`this CLI (${e}) is npm's latest published release`,name:`cli-update`,status:`ok`}},Rb=async(e,t)=>{let n=c_({env:e.env,updates:t.updates});if(n!==`on`)return{detail:Ib[n],name:`cli-update`,status:`ok`};let{latest:r,stale:i}=await n_({fetch:e.fetcher,home:z(e.env),nowMs:Date.now()});return r===void 0?{detail:`could not reach npm to learn the latest published version — not a fault of your setup, and nothing else depends on it`,name:`cli-update`,status:`warn`}:Lb(e.cliVersion,r,i)},zb=(e,t)=>Object.keys(t.refs).map(e=>il.parse(e)).map(t=>({dest:B(e,t),key:t})).filter(e=>U(e.dest)),Bb=[`pre-commit`,`pre-push`],Vb=async(t,r)=>{try{return await e(m(t.hooksDir,r),n.X_OK),!0}catch{return!1}},Hb=async e=>{let t=await Promise.all(Bb.map(t=>Vb(e,t)));return Bb.filter((e,n)=>!t[n])},Ub=async(e,t,n)=>{let r=await e.runner.run(`git`,[`config`,`--local`,`--get`,`core.hooksPath`],{cwd:n});return r.exitCode===0&&r.stdout.trim()===t.hooksDir},Wb=e=>e.missingHooks.length>0?{detail:`${e.missingHooks.map(e=>`hooks/${e}`).join(`, `)} missing or not executable — run: refs init`,name:`hooks-guard`,status:`fail`}:e.badKeys.length>0?{detail:`core.hooksPath not set for: ${e.badKeys.join(`, `)} — run: refs init`,name:`hooks-guard`,status:`fail`}:{detail:`${Bb.map(e=>`hooks/${e}`).join(`, `)} present; ${e.checkoutCount} checkout(s) guarded`,name:`hooks-guard`,status:`ok`},Gb=async(e,t,n)=>{let r=zb(t,n),[i,a]=await Promise.all([Hb(t),Promise.all(r.map(n=>Ub(e,t,n.dest)))]),o=r.filter((e,t)=>!a[t]).map(e=>e.key);return Wb({badKeys:o,checkoutCount:r.length,missingHooks:i})},Kb=async(e,t)=>{let n=await e.runner.run(`git`,[`status`,`--porcelain`],{cwd:t.dest});return n.exitCode===0?{broken:!1,detail:``,dirty:n.stdout.trim()!==``,key:t.key}:{broken:!0,detail:n.stderr.trim(),dirty:!1,key:t.key}},qb=e=>{let t=e.filter(e=>e.broken);if(t.length>0)return{detail:t.map(e=>`${e.key}: git status failed — ${e.detail}`).join(`; `),name:`dirty-checkouts`,status:`fail`};let n=e.filter(e=>e.dirty).map(e=>e.key);return n.length===0?{detail:`no local changes in any checkout`,name:`dirty-checkouts`,status:`ok`}:{detail:`local changes will be discarded on next sync: ${n.join(`, `)}`,name:`dirty-checkouts`,status:`warn`}},Jb=async(e,t,n)=>{let r=zb(t,n),i=await Promise.all(r.map(t=>Kb(e,t)));return qb(i)},Yb=async e=>{try{return await Wg(e)}catch{return Bg.parse({})}},Xb=async e=>{try{return(await c(e,{withFileTypes:!0})).filter(e=>e.isDirectory()).map(e=>e.name)}catch(e){if(R(e))return[];throw e}},Zb=async(e,t)=>{if(U(e))return[[...t]];let n=await Xb(e);return(await Promise.all(n.map(n=>Zb(m(e,n),[...t,n])))).flat()},Qb=(e,t,n)=>{let r=e.refs[t]?.pending_proposal_at;return r!==void 0&&n-Date.parse(r)<864e5},$b=(e,t,n)=>Qb(t,e.key,n)?`${e.key}: pending add`:`${e.key}: orphan — remove with: ${Qv(e.dest)}`,ex=(e,t)=>({dest:m(e.sourcesDir,...t),key:t.join(`/`)}),tx=async(e,t,n)=>{let r=(await Zb(e.sourcesDir,[])).map(t=>ex(e,t)).filter(e=>!Object.hasOwn(t.refs,e.key));if(r.length===0)return{detail:`no orphaned checkouts under sources/`,name:`orphans`,status:`ok`};let i=Date.now();return{detail:r.map(e=>$b(e,n,i)).join(`; `),name:`orphans`,status:`warn`}},nx=e=>{let t=(e??``).lastIndexOf(`/`);return t===-1?`.`:(e??``).slice(0,t)},rx=e=>{let[t=`.`,...n]=e,r=t.split(`/`),i=r.length;for(let e of n){let t=e.split(`/`),n=0;for(;n<i&&n<t.length&&r[n]===t[n];)n+=1;i=n}return i===0?`.`:r.slice(0,i).join(`/`)},ix=`(unknown)`,ax=e=>ul.safeParse(e.path).success,ox=(e,t)=>{let n=`${e.name}: declared in this checkout but not registered — it cannot be resolved by name until it is`;if(e.path===void 0)return`${n}. Declared at several paths (${(e.candidates??[]).join(`, `)}) — pick one`;if(!ax(e))return`${n}. Its path is one the configuration cannot hold, so there is no command for it — report it and leave it unregistered`;let r=Zv([`--package=${Xv(e.name)}`,`--decline`,`--path=${Xv(e.path)}`],[t]);return Kc(e.name)?`${n}. To register it: ${Zv([`--package=${Xv(e.name)}`,`--create`,`--path=${Xv(e.path)}`,`--description="<what it is>"`],[t])}. If it should not be: ${r}`:`${n}. Its name is one the packages table cannot hold, so it cannot be registered — if that is the answer, record it: ${r}`},sx=(e,t,n)=>{let r=`${e.name}: moved to ${e.path??ix} — update the entry's path (${n})`,i=Zv([`--package=${Xv(e.name)}`],[t,`path`,e.path??``]);return ul.safeParse(e.path).success?`${r}. To fix it: ${i}`:r},cx=(e,t)=>{let n=`configured: ${e.configured_path??ix}`;if(e.status===`relocated`)return sx(e,t,n);if(e.status===`missing`){let r=Zv([`--package=${Xv(e.name)}`,`--remove`],[t]);return`${e.name}: gone from this repo's workspaces (${n}) — repoint the entry if it moved out of them, or unregister it: ${r}`}if(e.status===`ambiguous`){let t=(e.candidates??[]).join(`, `);return`${e.name}: declared at several paths (${t}) — point the entry at one (${n})`}return`${e.name}: could not be checked — ${e.reason??`(no reason given)`} (${n})`},lx=(e,t)=>e.status===`unregistered`?ox(e,t):cx(e,t),ux=e=>`could not check for unregistered packages — ${e}`,dx=e=>`…and ${e} more finding(s) — act on the ones above (register, repoint or decline) and run the check again to see the rest`,fx=e=>{let t=e.length-10;return t<=0?[...e]:[...e.slice(0,10),dx(t)]},px=e=>{let t=new Map;for(let n of e){let[e=`.`]=nx(n.path).split(`/`);t.set(e,[...t.get(e)??[],n])}return t},mx=e=>e.path===void 0,hx=(e,t,n)=>{if(e.length<3)return e.map(e=>({candidates:1,dir:n,line:ox(e,t)}));let r=rx(e.map(e=>nx(e.path)));return[{candidates:e.length,dir:r,line:`${r}: ${e.length} unregistered package(s) the configuration does not have`}]},gx=e=>{let t=e.reduce((e,t)=>e+t.candidates,0),n=new Set(e.flatMap(e=>e.dir===void 0?[]:[e.dir])).size;return`…and ${t} more unregistered package(s)${n===0?``:` in ${n} director(ies)`} — 'refs doctor --json' lists every candidate`},_x=(e,t)=>{let n=e.filter(e=>mx(e)).map(e=>({candidates:1,line:ox(e,t)})),r=[...px(e.filter(e=>!mx(e)))].toSorted(([e],[t])=>e.localeCompare(t)).flatMap(([e,n])=>hx(n,t,e)),i=[...n,...r],a=i.slice(10);return a.length===0?i.map(e=>e.line):[...i.slice(0,10).map(e=>e.line),gx(a)]},vx=(e,t)=>e.reason===void 0?[...fx((e.packages??[]).map(e=>lx(e,t))),..._x(e.discovery??[],t),...e.discovery_incomplete===void 0?[]:[ux(e.discovery_incomplete)]]:[`could not be checked — ${e.reason}`],yx=e=>{let t;return()=>(t??=dv(e),t)},bx=async(e,t,n)=>{let r=await S_(e);if(r===void 0||t.some(e=>e.packageName===r.name))return{issues:[]};let i=await n();if(!Gh(i))return{incomplete:My(i),issues:[]};let a=tg(i.packages,r.name);return a.kind===`ambiguous`?{issues:[{candidates:a.paths,name:r.name,status:`unregistered`}]}:{issues:a.kind===`found`?[{name:r.name,path:a.path,status:`unregistered`}]:[]}},xx=e=>{let t=new Map;for(let n of e)t.set(n.name,[...t.get(n.name)??[],n.path]);return t},Sx=(e,t)=>{let n=new Set(e.changedDirs),r=t.filter(e=>!n.has(e.path)).map(e=>e.name);return new Set([...e.namesBefore,...r])},Cx=(e,t)=>t.length===1&&t[0]!==void 0?{name:e,path:t[0],status:`unregistered`}:{candidates:[...t],name:e,status:`unregistered`},wx=async(e,t,n)=>{if(t.kind===`arrivals`&&t.changedDirs.length===0)return{issues:[]};let r=await n();if(!Gh(r))return{incomplete:My(r),issues:[]};let i=new Set(e.map(e=>e.packageName)),a=r.packages.filter(e=>e.path!==`.`),o=t.kind===`all`?void 0:Sx(t,a);return{issues:[...xx(a)].filter(([e])=>!i.has(e)).filter(([e])=>o===void 0||!o.has(e)).map(([e,t])=>Cx(e,t)).toSorted((e,t)=>e.name.localeCompare(t.name))}},Tx=(e,t)=>{if(t.length===0)return{issues:[...e],suppressed:[]};let n=(e,n)=>t.some(t=>t.name===e&&t.path===n),r=[];return{issues:e.flatMap(e=>{if(e.status!==`unregistered`)return[e];let t=e.path===void 0?e.candidates??[]:[e.path],i=t.filter(t=>!n(e.name,t)),a=t.filter(t=>n(e.name,t));return r.push(...a.map(t=>({name:e.name,path:t}))),i.length===0?[]:[Cx(e.name,i)]}),suppressed:r}},Ex=e=>e!==`unmaterialized`&&e!==`verified`,Dx=new Set([`ambiguous`,`missing`,`relocated`]),Ox=(e,t={})=>{let{declined:n=[],discoveryIncomplete:r}=t,i=e.filter(e=>e.status!==`unregistered`),a=e.filter(e=>e.status===`unregistered`);return{...n.length===0?{}:{declined:[...n]},...a.length===0?{}:{discovery:a},...r===void 0?{}:{discovery_incomplete:r},...i.length===0?{}:{packages:i},status:kx(i,r)}},kx=(e,t)=>e.some(e=>Dx.has(e.status))?`drift`:e.length===0&&t===void 0?`ok`:`unknown`,Ax=(e,t)=>({path:e.configuredPath,reason:t,status:`unverifiable`}),jx=(e,t)=>Kh(t)?{configuredPath:e.configuredPath,path:null,status:`missing`}:Ax(e,`this repo declares no workspaces, so there was nowhere to search`),Mx=(e,t)=>t===e.configuredPath,Nx=e=>e.packages.filter(e=>e.path!==`.`),Px=(e,t)=>{let n=tg(Nx(t),e.packageName);return n.kind===`ambiguous`?{candidates:n.paths,configuredPath:e.configuredPath,path:null,status:`ambiguous`}:Gh(t)?n.kind===`absent`?jx(e,t):Mx(e,n.path)?Ax(e,`the checkout changed while it was being inspected`):{configuredPath:e.configuredPath,path:n.path,status:`relocated`}:Ax(e,n.kind===`found`?`workspace detection was incomplete, so the new location is not confirmed unique`:`workspace detection was incomplete`)},Fx=e=>{let t=new Map(Object.entries(e??{}));return[...t.keys()].toSorted().flatMap(e=>{let n=t.get(e);return n===void 0?[]:[{configuredPath:n.path,packageName:e}]})},Ix=async(e,t)=>{let n=await Qh(e,t.configuredPath,t.packageName);if(n.kind===`match`)return{path:t.configuredPath,status:`verified`};if(n.kind===`unreadable`)return{path:t.configuredPath,reason:n.reason,status:`unverifiable`}},Lx=e=>e.flatMap(e=>e.settled===void 0?[]:[{outcome:e.settled,query:e.query}]),Rx=async(e,t,n)=>{let r=await Promise.all(t.map(async t=>({query:t,settled:await Ix(e,t)})));if(r.every(e=>e.settled!==void 0))return Lx(r);let i=await n();return r.map(e=>({outcome:e.settled??Px(e.query,i),query:e.query}))},zx=e=>{let{outcome:t,query:n}=e;return Ex(t.status)?[{...t.candidates===void 0?{}:{candidates:t.candidates},configured_path:n.configuredPath,name:n.packageName,...t.status===`relocated`&&t.path!==null?{path:t.path}:{},...t.reason===void 0?{}:{reason:t.reason},status:t.status}]:[]},Bx=(e,t)=>{let n=new Set(e.map(e=>e.name));return[...e,...t.filter(e=>!n.has(e.name))]},Vx=async(e,t,n)=>{let r=Fx(t.packages),[i]=r;if(i===void 0)return{status:`ok`};let a=yx(e);try{let[i,o,s]=await Promise.all([Rx(e,r,a),bx(e,r,a),wx(r,n,a)]),c=Tx([...i.flatMap(e=>zx(e)),...Bx(o.issues,s.issues)],t.declined_packages??[]);return Ox(c.issues,{declined:c.suppressed,...(s.incomplete??o.incomplete)===void 0?{}:{discoveryIncomplete:s.incomplete??o.incomplete}})}catch(e){return{reason:Kv(e),status:`unknown`}}},Hx=async(e,t,n)=>{try{return await G(e,_y(n.key),()=>Vx(n.dest,t.refs[n.key]??{},{kind:`all`}),{timeoutMs:100})}catch(e){if(e instanceof g&&e.code===`conflict`)return{reason:`another refs process is holding this ref`,status:`unknown`};throw e}},Ux=e=>e===0?``:` (${e} declined package(s) not reported)`,Wx=(e,t)=>e.unhealthy.length===0?`every configured package path resolves in ${t} checkout(s)`:e.unhealthy.join(`; `),Gx=(e,t)=>{let{declined:n,discovery:r,findings:i}=e;return{detail:[Wx(e,t)+Ux(n),...r].join(`; `),...i.length===0?{}:{findings:i},name:`config-drift`,status:e.unhealthy.length===0?`ok`:`warn`}},Kx=async(e,t,n)=>{let[r,...i]=n;if(r===void 0)return{declined:0,discovery:[],findings:[],unhealthy:[]};let a=await Hx(e,t,r),o=await Kx(e,t,i);return qx(o,{key:r.key,report:a})},qx=(e,t)=>{let{key:n,report:r}=t,i=e=>e.map(e=>`${n}: ${e}`),a=r.discovery??[],o=r.packages??[],s=[...o,...a];return{declined:(r.declined??[]).length+e.declined,discovery:[...i(vx({discovery:a,status:`ok`},n)),...e.discovery],findings:s.length===0?e.findings:[{key:n,packages:s},...e.findings],unhealthy:[...i(vx({...r.discovery_incomplete===void 0?{}:{discovery_incomplete:r.discovery_incomplete},...r.reason===void 0?{}:{reason:r.reason},packages:o,status:r.status},n)),...e.unhealthy]}},Jx=async(e,t)=>{let n=zb(e,t);return Gx(await Kx(e,t,n),n.length)},Yx=e=>{let{diagnosis:t}=e;return e.kind===`claim`||!e.isDirectory||t.pidState===`definitely-dead`||t.stale||t.meta===`malformed`||t.meta===`unreadable`||t.policy===`unknown`?!1:t.ageMs===void 0||t.ageMs>=0},Xx=e=>{let{ageMs:t,budgetMs:n,policy:r}=e;return r===`unknown`?`, state could not be read`:t===void 0||n===void 0?``:t<0?`, recorded time is in the future — check the system clock`:`, ${Sp(t)} into a ${Sp(n)} window`},Zx=e=>e.pid===void 0?`owner unknown (metadata ${e.meta})`:e.pidState===`definitely-dead`?`recorded pid ${e.pid} is not running`:`recorded pid ${e.pid} present`,Qx=(e,t)=>{let n=m(e.locksDir,op,t.name),r=t.diagnosis.ageMs===void 0?``:` for ${Sp(t.diagnosis.ageMs)}`;return`steal claim on ${t.name}: present${r}. Stealing this lock is blocked while it is here. A reclaim in progress clears it within a moment; if it stays, ${$x}: ${$v(n)}`},$x=`stop every refs process using this home — including suspended ones — and then run`,eS=(e,t)=>{let{diagnosis:n}=t;if(ep(n))return`, reclaimable now`;if(!n.stale&&t.isDirectory)return``;let r=m(e.locksDir,t.name);return`, not automatically reclaimable — if it is genuinely abandoned, ${$x}: ${Qv(r)}`},tS=(e,t)=>{let{diagnosis:n}=t,r=t.isDirectory?``:`not a directory, `,i=eS(e,t);return`${t.name}: ${r}${Zx(n)}${Xx(n)}${i}`},nS=async e=>{let t=await xp(e),[n]=t;return n===void 0?{detail:`no locks held`,name:`locks`,status:`ok`}:{detail:t.map(t=>t.kind===`claim`?Qx(e,t):tS(e,t)).join(`; `),name:`locks`,status:t.every(e=>Yx(e))?`ok`:`warn`}},rS=[`.agents`,`skills`,`refs`,`SKILL.md`],iS=[`skills`,`refs`,`SKILL.md`],aS=[`.claude`,`skills`,`refs`,`SKILL.md`],oS=`npx skills add kaisers-io/refs`,sS=`npm i -g @kaisers-io/refs@latest`,cS=(e,t)=>e===void 0?void 0:{display:t,path:e},lS=e=>{let{dirName:t,env:n,home:r,overrideName:i}=e,a=n[i]?.trim();return a!==void 0&&a.length>0?{display:a,path:a}:cS(r===void 0?void 0:m(r,t),`~/${t}`)},uS=e=>{let t=e.homedir.length>0?e.homedir:void 0;return[{label:`shared ~/.agents`,root:cS(t,`~/.agents`),segments:rS},{label:`Claude Code`,root:lS({dirName:`.claude`,env:e.env,home:t,overrideName:`CLAUDE_CONFIG_DIR`}),segments:iS},{label:`Codex`,root:lS({dirName:`.codex`,env:e.env,home:t,overrideName:`CODEX_HOME`}),segments:iS},{label:`project ./.agents`,root:cS(e.cwd,`./.agents`),segments:rS},{label:`project ./.claude`,root:cS(e.cwd,`./.claude`),segments:aS}].flatMap(({label:e,root:t,segments:n})=>t===void 0?[]:[{display:t.display,label:e,path:m(t.path,...n)}])},dS=async(e,t)=>{try{let n=await l(e);return{label:t,realPath:n,source:await s(n,`utf8`)}}catch{return}},fS=e=>{let t=new Map;for(let n of e)t.has(n.realPath)||t.set(n.realPath,n);return[...t.values()]},pS=/^---\r?\n(?<body>[\s\S]*?)\r?\n---/u,mS=/^\s*cli_version:\s*["']?(?<version>[^"'\s]+)["']?\s*$/mu,hS=e=>{let t=pS.exec(e)?.groups?.body;if(t!==void 0)return mS.exec(t)?.groups?.version},gS=(e,t)=>{if(e===t)return`match`;let n=Yg(e,t);return n===void 0?`unknown`:n===0?`match`:n>0?`cli-older`:`skill-older`},_S={"cli-older":(e,t)=>`the refs skill targets CLI ${e} but this CLI is ${t} — update the CLI: ${sS}`,match:(e,t)=>`the refs skill is installed and matches this CLI (${t})`,"skill-older":(e,t)=>`the refs skill targets CLI ${e} but this CLI is ${t} — update the skill: ${oS}`,unknown:(e,t)=>`the refs skill targets CLI ${e} but this CLI is ${t} — reinstall both: ${sS} and ${oS}`},vS=e=>{let{cliVersion:t,label:n,skillVersion:r}=e;if(r===void 0)return{detail:`the refs skill (${n}) predates the version gate — update it: ${oS}`,name:`skill`,status:`warn`};let i=gS(r,t);return{detail:`${n}: ${_S[i](r,t)}`,name:`skill`,status:i===`match`?`ok`:`warn`}},yS=e=>({detail:`refs skill not found in the locations this check knows about (${e.map(e=>e.display).join(`, `)}) — an install anywhere else is invisible here and still works; if it really is missing: ${oS}`,name:`skill`,status:`warn`}),bS=async e=>{let t=uS(e),n=await Promise.all(t.map(e=>dS(e.path,e.label))),r=fS(n.filter(e=>e!==void 0)).map(t=>vS({cliVersion:e.cliVersion,label:t.label,skillVersion:hS(t.source)}));return r.find(e=>e.status!==`ok`)??r[0]??yS(t)},xS=/^(?<user>[^/\s@]+)@(?<host>[^:/\s]+):/u,SS=e=>e===``?{}:{user:e},CS=e=>e===``?{}:{port:e},wS=e=>{try{let t=new URL(e);return t.protocol===`ssh:`?{host:t.hostname,...SS(t.username),...CS(t.port)}:void 0}catch{return}},TS=e=>{let t=xS.exec(e),n=t?.groups?.host;return n===void 0?wS(e):{host:n,user:t?.groups?.user??`git`}},ES=e=>e.port===void 0?e.host:`${e.host}:${e.port}`,DS=e=>e.user===void 0?ES(e):`${e.user}@${ES(e)}`,OS=e=>{let t=Object.values(e.refs).map(e=>TS(e.url)).filter(e=>e!==void 0),n=new Map;for(let e of t)n.set(DS(e),e);return[...n.values()].toSorted((e,t)=>DS(e).localeCompare(DS(t)))},kS=/Permission denied/u,AS=[/Could not resolve hostname/u,/Connection refused/u,/Host key verification failed/u,/timed out/u],jS=e=>e.user===void 0?e.host:`${e.user}@${e.host}`,MS=e=>{let t=[`-o`,`ConnectTimeout=5`,`-o`,`BatchMode=yes`],n=jS(e);return e.port===void 0?[...t,`-T`,n]:[...t,`-p`,e.port,`-T`,n]},NS=async(e,t,n)=>{let r=DS(t),i=await e.runner.run(`ssh`,MS(t),{timeoutMs:n});return i.timedOut===!0?{host:r,outcome:`timeout`}:kS.test(i.stderr)?{host:r,outcome:`denied`}:AS.some(e=>e.test(i.stderr))?{detail:i.stderr.trim(),host:r,outcome:`connection-warn`}:{host:r,outcome:`ok`}},PS=(e,t)=>{let n=e.filter(e=>e.outcome===`timeout`).map(e=>e.host);if(n.length!==0)return{detail:`ssh probe timed out after ${t/1e3}s: ${n.join(`, `)}`,name:`ssh-auth`,status:`fail`}},FS=e=>{let t=e.filter(e=>e.outcome===`denied`).map(e=>e.host);if(t.length!==0)return{detail:`ssh permission denied for: ${t.join(`, `)}`,name:`ssh-auth`,status:`fail`}},IS=e=>{let t=e.filter(e=>e.outcome===`connection-warn`);if(t.length!==0)return{detail:`ssh connection issue, treated as warn: ${t.map(e=>`${e.host} (${e.detail??``})`).join(`; `)}`,name:`ssh-auth`,status:`warn`}},LS=e=>({detail:`ssh auth ok for: ${e.map(e=>e.host).join(`, `)}`,name:`ssh-auth`,status:`ok`}),RS=(e,t)=>PS(e,t)??FS(e)??IS(e)??LS(e),zS=async(e,t,n)=>{let r=OS(t);if(r.length===0)return;let i=n?.timeoutMs??1e4,a=await Promise.all(r.map(t=>NS(e,t,i)));return RS(a,i)},BS=async e=>{try{return await e.run()}catch(t){return{detail:`check crashed: ${Kv(t)}`,name:e.name,status:`fail`}}},VS={"cli-update":`Checking for a newer refs release`,config:`Checking the config`,"config-drift":`Comparing registered packages with the checkouts`,"dirty-checkouts":`Looking for local changes in checkouts`,git:`Checking Git`,"hooks-guard":`Checking the checkout protection hooks`,locks:`Checking locks`,node:`Checking Node.js`,orphans:`Looking for orphaned checkouts`,skill:`Checking the installed skill`,"ssh-auth":`Checking SSH authentication`},HS=async(e,t)=>{let[n,...r]=e;if(n===void 0)return[];t.update(VS[n.name]??`Running the ${n.name} check`);let i=await BS(n),a=await HS(r,t);return i===void 0?a:[i,...a]},US=e=>{let{configLoad:t,ctx:n,home:r,state:i}=e;return[{name:`git`,run:()=>Ob(n)},{name:`node`,run:()=>Promise.resolve(Mb(n))},{name:`config`,run:()=>Promise.resolve(Fb(t.errorMessage))},{name:`hooks-guard`,run:()=>Gb(n,r,t.config)},{name:`dirty-checkouts`,run:()=>Jb(n,r,t.config)},{name:`config-drift`,run:()=>Jx(r,t.config)},{name:`orphans`,run:()=>tx(r,t.config,i)},{name:`locks`,run:()=>nS(r)},{name:`skill`,run:()=>bS(n)},{name:`cli-update`,run:()=>Rb(n,t.config)},{name:`ssh-auth`,run:()=>zS(n,t.config)}]},WS=async(e,t)=>{t.update(`Reading config and state`);let n=z(e.env),r=await Pb(n),i=await Yb(n);return HS(US({configLoad:r,ctx:e,home:n,state:i}),t)},GS={fail:`FAIL`,ok:`OK`,warn:`WARN`},KS=e=>e.map(e=>`[${GS[e.status]}] ${e.name}: ${e.detail}`),qS=e=>e.some(e=>e.status===`fail`),JS=(e,t)=>{e.command(`doctor`).description(`Run environment/integrity checks (git, node, config, hooks, checkouts, drift, locks, ssh).`).action((e,n)=>{let r=X(n);return Q(t,r,async()=>{let e=await Yv(t,r,e=>WS(t,e));Z(t,r,KS(e),{checks:e}),qS(e)&&(process.exitCode=Se.UNEXPECTED)})()})},YS=(e,t)=>{let n=e.refs[t];if(n===void 0)throw Error(`internal: matched ref key '${t}' is missing from config.refs`);return n},XS=(e,t)=>{if(!U(e))throw _(`checkout for '${t}' is missing — run: refs sync ${t}`)},ZS=(e,t,n)=>{let r=e.packages?.[n];if(r===void 0)throw _(`no package '${n}' registered on ref '${t}'`);return r},QS=`never`,$S=(e,t,n)=>e===void 0||n-Date.parse(e)>t,eC=(e,t)=>`${e} ${t}${e===1?``:`s`} ago`,tC=(e,t)=>{if(e===void 0)return QS;let n=t-Date.parse(e);if(Number.isNaN(n))return QS;let r=Math.floor(n/1e3);if(r<60)return`just now`;let i=Math.floor(r/60);if(i<60)return eC(i,`minute`);let a=Math.floor(i/60);if(a<24)return eC(a,`hour`);let o=Math.floor(a/24);return o<365?eC(o,`day`):eC(Math.floor(o/365),`year`)},nC=e=>{let t=tC(e.lastFetchedAt,e.now),n=[`synced: ${t}`];return e.stale&&t!==QS&&n.push(`status: stale`),e.missing&&n.push(`missing: checkout not found — run: refs sync`),n},rC=(e,t,n)=>{let r=e.state.refs[t],i=ol(Vg(`sync_ttl`,n,e.settings)),a=Object.keys(n.packages??{}).toSorted();return{clone_mode:Vg(`clone_mode`,n,e.settings),description:n.description,key:t,...r?.last_fetched_at===void 0?{}:{last_fetched_at:r.last_fetched_at},missing:!U(B(e.home,il.parse(t))),...e.includePackages?{packages:a}:{},packages_count:a.length,stale:$S(r?.last_fetched_at,i,e.now)}},iC=e=>{let t={home:e.home,includePackages:e.includePackages,now:e.now,settings:e.config.settings,state:e.state};return Object.entries(e.config.refs).map(([e,n])=>rC(t,e,n)).toSorted((e,t)=>e.key.localeCompare(t.key))},aC=async(e,t,n)=>{let r=z(e.env),i=await V(r),a=await Wg(r);return iC({config:i,home:r,includePackages:t,now:n,state:a})},oC=(e,t)=>[`ref: ${e.key}`,`description: ${e.description}`,...nC({lastFetchedAt:e.last_fetched_at,missing:e.missing,now:t,stale:e.stale})],sC=(e,t)=>e.length===0?[`no refs configured — run: refs add <source>`]:e.reduce((e,n,r)=>(r>0&&e.push(``),e.push(...oC(n,t)),e),[]),cC=e=>e.split(`/`),lC=(e,t)=>{let n=cC(e);if(t.length>n.length)return!1;let r=n.length-t.length;return t.every((e,t)=>e===n[r+t])},uC=(e,t)=>{if(Object.hasOwn(e.refs,t))return il.parse(t);let n=cC(t),r=Object.keys(e.refs).filter(e=>lC(e,n)).toSorted(),[i]=r;if(i===void 0)throw _(`no ref matches '${t}'`);if(r.length>1)throw v(`'${t}' matches more than one ref: ${r.join(`, `)}`);return il.parse(i)},dC=(e,t)=>{e.command(`list`).description(`List configured refs with their staleness/missing checkout status.`).option(`--packages`,`include each ref's package names in --json output (off by default)`).action((e,n)=>{let r=X(n);return Q(t,r,async()=>{let n=Date.now(),i=await aC(t,e.packages===!0,n);Z(t,r,sC(i,n),i)})()})},fC=e=>e===void 0?null:e,pC=(e,t)=>e.name===t.name&&e.path===t.path,mC=(e,t)=>{let n=(e.declined_packages??[]).filter(e=>!pC(e,t));if(n.length===0){let{declined_packages:t,...n}=e;return n}return{...e,declined_packages:n}},hC=(e,t)=>`package '${e.name}' at '${e.path}' is already declined on ref '${t}'`,gC=(e,t)=>`package '${e.name}' at '${e.path}' is not declined on ref '${t}' — nothing to undo`,_C=(e,t)=>`package '${e}' is registered on ref '${t}' — declining applies to packages the configuration does not have; unregister it first with --remove`,vC=(e,t,n)=>{if(Object.hasOwn(e.packages??{},t.name))throw y(_C(t.name,n));let r=e.declined_packages??[];if(r.some(e=>pC(e,t)))throw y(hC(t,n));return{...e,declined_packages:[...r,t]}},yC=e=>{if(e.declined)return vC(e.entry,e.record,e.key);if(!(e.entry.declined_packages??[]).some(t=>pC(t,e.record)))throw y(gC(e.record,e.key));return mC(e.entry,e.record)},bC=(e,t)=>{let n=z(e.env);return G(n,`home`,async()=>{let e=await V(n),r=uC(e,t.query),i=YS(e,r),a={name:t.packageName,path:t.path},o=yC({declined:t.declined,entry:i,key:r,record:a});return await fu(n,{...e,refs:{...e.refs,[r]:o}}),{declined:t.declined,field:`declined_packages`,key:r,new:t.declined?a:null,old:t.declined?null:a}})},xC=`packages`,SC=()=>Object.keys(hl.shape).toSorted().join(`, `),CC=e=>`unknown package field '${e}' — valid fields: ${SC()}`,wC=e=>Object.hasOwn(hl.shape,e),TC=(e,t,n)=>{if(!wC(t))throw v(CC(t));let r=e[t],i=hl.safeParse({...e,[t]:n});if(!i.success)throw y(T(i.error));return{field:t,newValue:i.data[t],oldValue:r,updated:i.data}},EC=async e=>{let t=ZS(e.entry,e.key,e.packageName),n=TC(t,e.field,e.value),r={...e.entry,packages:{...e.entry.packages,[e.packageName]:n.updated}};return await fu(e.home,{...e.config,refs:{...e.config.refs,[e.key]:r}}),{field:n.field,key:e.key,new:fC(n.newValue),old:fC(n.oldValue)}},DC=(e,t)=>`package '${e}' is already registered on ref '${t}' — edit its fields instead`,OC=(e,t)=>{let n=z(e.env);return G(n,`home`,async()=>{let e=await V(n),r=uC(e,t.query),i=YS(e,r);if(Object.hasOwn(i.packages??{},t.packageName))throw y(DC(t.packageName,r));let a=gl.safeParse({...mC(i,{name:t.packageName,path:t.path}),packages:{...i.packages,[t.packageName]:{description:t.description,path:t.path}}});if(!a.success)throw y(T(a.error));return await fu(n,{...e,refs:{...e.refs,[r]:a.data}}),{created:!0,field:xC,key:r,new:{description:t.description,name:t.packageName,path:t.path},old:null}})},kC=(e,t)=>`package '${e}' is not registered on ref '${t}' — nothing to remove`,AC=(e,t)=>{let n=z(e.env);return G(n,`home`,async()=>{let e=await V(n),r=uC(e,t.query),i=YS(e,r),a=i.packages??{};if(!Object.hasOwn(a,t.packageName))throw y(kC(t.packageName,r));let{[t.packageName]:o,...s}=a,c=Object.keys(s).length===0?jC(i):{...i,packages:s};return await fu(n,{...e,refs:{...e.refs,[r]:c}}),{field:xC,key:r,new:null,old:{description:o?.description??``,name:t.packageName,path:o?.path??``},removed:!0}})},jC=e=>{let{packages:t,...n}=e;return n},MC=e=>e.second===void 0&&e.value===void 0,NC=e=>{let{description:t,path:n}=e.create,{packageName:r}=e;if(r===void 0||t===void 0||n===void 0||!MC(e))throw v(`--create registers a new package: it needs --package <name>, --path <path> and --description <text>, and takes no <field> <value> arguments`);return{description:t,packageName:r,path:n}},PC=e=>{let{packageName:t}=e;if(t===void 0||e.create.path!==void 0||!MC(e)||e.create.description!==void 0)throw v(`--remove unregisters a package: it needs --package <name>, and takes no <field> <value> arguments, no --path and no --description`);return{packageName:t}},FC=e=>{let{packageName:t}=e,{path:n}=e.create;if(t===void 0||n===void 0||!MC(e)||e.create.description!==void 0)throw v(`--decline and --undecline record a decision about one package at one path: each needs --package <name> and --path <path>, and takes no <field> <value> arguments and no --description`);return{packageName:t,path:n}},IC=[`create`,`remove`,`decline`,`undecline`],LC=e=>{let t=IC.filter(t=>e[t]===!0);if(t.length>1)throw v(`use one of --create, --remove, --decline or --undecline: they are different answers about the same package, and running two at once would guess which one was meant`);return t[0]},RC=(e,t,n)=>t===`create`?OC(e,{...NC(n),query:n.first}):t===`remove`?AC(e,{...PC(n),query:n.first}):bC(e,{...FC(n),declined:t===`decline`,query:n.first}),zC=`packages`,BC=()=>Object.keys(gl.shape).filter(e=>e!==zC).toSorted().join(`, `),VC=e=>`unknown ref field '${e}' — valid fields: ${BC()}`,HC=e=>Object.hasOwn(gl.shape,e),UC=(e,t,n)=>`failed to rewrite git remote at ${e} to '${W(t)}': ${n.trim()}`,WC=async(e,t)=>{if(iu(t.home,t.dest),!U(t.dest))return;let n=await e.runner.run(`git`,[`remote`,`set-url`,`--`,`origin`,t.cloneUrl],{cwd:t.dest});if(n.exitCode!==0)throw y(UC(t.dest,t.cloneUrl,n.stderr))},GC=async(e,t)=>{let n=gf(t.value,{allowFileUrls:vy(e.env)});if(n.key!==t.key)throw y(`new url derives a different key — remove and re-add instead`);let r=B(t.home,t.key);return await WC(e,{cloneUrl:n.cloneUrl,dest:r,home:t.home}),{...t.entry,url:n.cloneUrl}},KC=(e,t,n)=>{let r={...e,[t]:n},i=gl.safeParse(r);if(!i.success)throw y(T(i.error));return i.data},qC=(e,t)=>t.field===`url`?GC(e,{entry:t.entry,home:t.home,key:t.key,value:t.value}):Promise.resolve(KC(t.entry,t.field,t.value)),JC=async(e,t)=>{let{field:n}=t;if(n===zC)throw v(`use --package <name> <field> <value>`);if(!HC(n))throw v(VC(n));let r=t.entry[n],i=await qC(e,{entry:t.entry,field:n,home:t.home,key:t.key,value:t.value});return{new:i[n],old:r,updated:i}},YC=(e,t)=>{let n=z(e.env),{field:r,opts:i,query:a,value:o}=t;return G(n,`home`,async()=>{let t=await V(n),s=uC(t,a),c=YS(t,s);if(i.packageName!==void 0)return EC({config:t,entry:c,field:r,home:n,key:s,packageName:i.packageName,value:o});let l=await JC(e,{entry:c,field:r,home:n,key:s,value:o});return await fu(n,{...t,refs:{...t.refs,[s]:l.updated}}),{field:r,key:s,new:fC(l.new),old:fC(l.old)}})},XC=`settings`,ZC=[],QC=()=>Object.keys(fl.shape).toSorted().join(`, `),$C=e=>`unknown setting '${e}' — valid settings: ${QC()}`,ew=e=>Object.hasOwn(fl.shape,e),tw=e=>`note: 'settings' addressed the global settings, not ${e} — use the full ref key to edit that ref`,nw=e=>{try{let t=uC(e,XC);return[tw(`ref '${t}'`)]}catch(e){if(e instanceof g&&e.code===`usage`)return[tw("one of several matching refs — see `refs list`")];if(e instanceof g&&e.code===`not_found`)return ZC;throw e}},rw=e=>({data:{field:e.key,key:XC,new:fC(e.parsed[e.key]),old:fC(e.old)},warnings:nw(e.config)}),iw=(e,t)=>{let n=z(e.env);return G(n,`home`,async()=>{let e=await V(n);if(!ew(t.key))throw v($C(t.key));let r=e.settings[t.key],i={...e.settings,[t.key]:t.value},a=fl.safeParse(i);if(!a.success)throw y(T(a.error));return await fu(n,{...e,settings:a.data}),rw({config:e,key:t.key,old:r,parsed:a.data})})},aw=[],ow=e=>{let t={};return e.package!==void 0&&(t.packageName=e.package),t},sw=e=>{if(e.second===void 0||e.value===void 0)throw v(`missing <field> and <value> — see 'refs edit --help'`);return{field:e.second,value:e.value}},cw=(e,t,n)=>{if(t.opts.packageName!==void 0)throw v(`--package is not valid with 'refs edit settings ...' — it only applies to ref/package edits`);return iw(e,n)},lw=async(e,t)=>{if(t.create.description!==void 0||t.create.path!==void 0)throw v(`--path and --description only apply to the package modes — to change one field of a registered package use: refs edit <ref> <field> <value> --package <name>`);let{field:n,value:r}=sw(t);return t.first===`settings`?cw(e,t,{key:n,value:r}):{data:await YC(e,{field:n,opts:t.opts,query:t.first,value:r}),warnings:aw}},uw=async(e,t)=>{let n=LC(t.create);return n===void 0?lw(e,t):{data:await RC(e,n,{create:t.create,first:t.first,packageName:t.opts.packageName,second:t.second,value:t.value}),warnings:aw}},dw=e=>e==null?`(unset)`:String(e),fw=(e,t)=>{let n=t?e.new:e.old,r=t?`declined`:`no longer declining`;return`${e.key}: ${r} '${n.name}' at ${n.path}`},pw=e=>{if(e.created===!0){let t=e.new;return`${e.key}: registered '${t.name}' at ${t.path}`}if(e.removed===!0){let t=e.old;return`${e.key}: unregistered '${t.name}' (was at ${t.path})`}return e.declined===void 0?void 0:fw(e,e.declined)},mw=e=>{let t=pw(e);return t===void 0?[`${e.key}: ${e.field} '${dw(e.old)}' -> '${dw(e.new)}'`]:[t]},hw=(e,t)=>{e.command(`edit`).description(`Edit one field: 'refs edit settings <key> <value>' for a global setting, or 'refs edit <ref> <field> <value> [--package <name>]' for a ref or package field. With --create, registers a package the config does not have yet; with --remove, unregisters one it has; with --decline, records that a package the checkout declares is deliberately not registered, so drift stops reporting it.`).argument(`<ref-or-settings>`,`a ref key/unique suffix, or the literal 'settings'`).argument(`[field-or-key]`,`field to edit (or, in settings mode, the setting key)`).argument(`[value]`,`the new value`).option(`--package <name>`,`edit this package's field instead of a top-level ref field`).option(`--create`,`register --package as a new package on this ref`).option(`--remove`,`unregister --package from this ref, leaving the checkout alone`).option(`--decline`,`record that --package at --path is deliberately not registered`).option(`--undecline`,`withdraw a decline, so the package is reported again`).option(`--path <path>`,`with --create/--decline/--undecline: the package path, relative to the checkout root`).option(`--description <text>`,`with --create: what the package is`).action((e,n,r,i,a)=>{let o=X(a);return Q(t,o,async()=>{let{data:a,warnings:s}=await uw(t,{create:i,first:e,opts:ow(i),second:n,value:r});Z(t,o,mw(a),a,s)})()})},gw=`Install the agent skill: npx skills add kaisers-io/refs (from a local clone: npx skills add <path-to-this-repo> --skill refs)`,_w={migrated:`migrated`,noop:`unchanged`,seeded:`seeded`},vw=async e=>{await a(e.root,{recursive:!0}),await a(e.sourcesDir,{recursive:!0}),await a(e.locksDir,{recursive:!0}),await a(e.hooksDir,{recursive:!0})},yw=async e=>{let t=z(e.env);return await vw(t),{config:await G(t,`home`,async()=>{let e=await Su(t,Tv);return await Nd(t),e}),home:t.root,skill_hint:gw}},bw=(e,t)=>{e.command(`init`).description(`Seed or migrate the refs home directory, its config, and the git hooks guard.`).action((e,n)=>{let r=X(n);return Q(t,r,async()=>{let e=await yw(t);Z(t,r,[`home: ${e.home}`,`config: ${_w[e.config]}`,``,gw],e)})()})},xw=async e=>{let t=z(e.env),n=await G(t,`home`,()=>Su(t,Tv));return n===`migrated`?{backup:eu(t),result:n}:{backup:null,result:n}},Sw=e=>e.result===`migrated`&&e.backup!==null?`config migrated (backup: ${re(e.backup)})`:e.result===`seeded`?`config seeded`:`config up to date`,Cw=(e,t)=>{e.command(`migrate`).description(`Migrate the refs config to the current schema, seeding it if absent.`).action((e,n)=>{let r=X(n);return Q(t,r,async()=>{let e=await xw(t);Z(t,r,Sw(e),e)})()})},ww=async e=>{try{return await i(e),!0}catch(e){if(R(e))return!1;throw e}},Tw=async e=>{try{return await c(e)}catch(e){if(R(e))return;throw e}},Ew=async e=>{try{return(await i(e)).isDirectory()}catch(e){if(R(e))return;throw e}},Dw=async e=>{let t=await Tw(e);if(t===void 0)return!0;if(t.length>0)return!1;try{await f(e)}catch(e){if(!R(e))throw e}return!0},Ow=async e=>{let t=await Ew(e);return t===void 0?!0:t?Dw(e):!1},kw=async(e,t)=>{t!==e.sourcesDir&&await Ow(t)&&await kw(e,ie(t))},Aw=async(e,t)=>await ww(t)?(iu(e,t),await d(t,{force:!0,recursive:!0}),await kw(e,ie(t)),{removedCheckout:!0}):{removedCheckout:!1,warning:`checkout was already missing`},jw=(e,t)=>Object.fromEntries(Object.entries(e).filter(([e])=>e!==t)),Mw=async(e,t)=>{let n=await V(e),r={...n,refs:jw(n.refs,t)};await fu(e,r);let i=await Wg(e),a={...i,refs:jw(i.refs,t)};await Gg(e,a)},Nw=async(e,t)=>{let n=z(e.env),r=await V(n),i=uC(r,t),a=B(n,i),{removedCheckout:o,warning:s}=await G(n,_y(i),()=>Aw(n,a));return await G(n,`home`,()=>Mw(n,i)),{data:{key:i,removed_checkout:o},warnings:Gv(s)}},Pw=e=>e.removed_checkout?[`removed ${e.key} (checkout deleted)`]:[`removed ${e.key} (checkout was already missing)`],Fw=(e,t)=>{e.command(`remove`).description(`Remove a configured ref: its config/state entry AND its checkout directory.`).argument(`<ref>`,`full ref key or a unique suffix, e.g. zod`).action((e,n,r)=>{let i=X(r);return Q(t,i,async()=>{let{data:n,warnings:r}=await Nw(t,e);Z(t,i,Pw(n),n,r)})()})},Iw=async e=>{let t=await Qh(e.checkoutDir,e.configuredPath,e.packageName);return t.kind===`match`?{path:e.configuredPath,status:`verified`}:t.kind===`unreadable`?{path:e.configuredPath,reason:t.reason,status:`unverifiable`}:Lw(e)},Lw=async e=>Px(e,await dv(e.checkoutDir)),Rw=async e=>{try{return await G(e.home,_y(e.key),()=>Iw(e),e.lockTimeoutMs===void 0?void 0:{timeoutMs:e.lockTimeoutMs})}catch(t){if(t instanceof g&&t.code===`conflict`)return{path:e.configuredPath,reason:`could not acquire the ref lock in time`,status:`unverifiable`};throw t}},zw=async e=>{if(!U(e.checkoutDir))return{path:e.configuredPath,status:`unmaterialized`};let t=await Qh(e.checkoutDir,e.configuredPath,e.packageName);return t.kind===`match`?{path:e.configuredPath,status:`verified`}:t.kind===`unreadable`?{path:e.configuredPath,reason:t.reason,status:`unverifiable`}:(e.onProbed?.(),Rw(e))},Bw=(e,t)=>({local_path:null,name:e,path:null,reason:t,status:`unverifiable`}),Vw=async e=>{if(!e.checkoutManaged)return Bw(e.packageName,e.checkoutReason);let t=await zw(e),n=(t.status===`verified`||t.status===`relocated`)&&t.path!==null?await Fg(m(e.checkoutDir,t.path),e.packageName):void 0;return{...t.candidates===void 0?{}:{candidates:t.candidates},...t.configuredPath===void 0?{}:{configured_path:t.configuredPath},...n===void 0?{}:{entry_points:n},local_path:t.path===null?null:m(e.checkoutDir,t.path),name:e.packageName,path:t.path,...t.reason===void 0?{}:{reason:t.reason},status:t.status}},Hw=e=>e.kind===`target`?[{observed:e.observed,target:e.target}]:e.kind===`alternatives`?e.alternatives.flatMap(e=>Hw(e)):e.kind===`conditions`?e.branches.flatMap(e=>Hw(e.value)):[],Uw=e=>{if(e.length===0)return[];let t=e.filter(e=>e.observed===`not_checked`||e.observed===`unverifiable`).length,n=e.length-t,r=t===0?``:`, ${t} not inspected`;return n===0?[`entry points: none of the ${e.length} declared target(s) was inspected`]:[`entry points: ${n} declared target(s) absent here${r}`]},Ww=e=>{if(e.status!==`complete`)return[`entry points: could not be read (${e.reason??`unknown`})`];let t=e.entries.flatMap(e=>Hw(e.value)),n=t.filter(e=>e.observed===`file`||e.observed===`directory`);if(n.length===0)return Uw(t);let r=n.slice(0,3).map(e=>e.target),i=n.length-r.length;return[`entry points present: ${r.join(`, `)}${i===0?``:` (+${i} more)`}`]},Gw=e=>[`package: ${e.name}`,`package path: ${e.local_path??`(unknown)`}`,...e.status===`verified`?[]:[`package status: ${e.status}`],...e.configured_path===void 0?[]:[`configured path: ${e.configured_path}`],...e.candidates===void 0?[]:[`candidates: ${e.candidates.join(`, `)}`],...e.reason===void 0?[]:[`reason: ${e.reason}`],...e.entry_points===void 0?[]:Ww(e.entry_points)],Kw=`node_modules`,qw=[`.pnp.cjs`,`.pnp.js`],Jw=new Set([``,`.`,`..`]),Yw=e=>!ae(e)&&!e.includes(`\\`)&&e.split(`/`).every(e=>!Jw.has(e)),Xw=function*(e){let t=ce(e);for(;;){re(t)!==Kw&&(yield m(t,Kw));let e=ie(t);if(e===t)return;t=e}},Zw=async e=>{if(await eT(e)!==`absent`)try{let t=JSON.parse(await s(e,`utf8`)),{name:n,version:r}=typeof t==`object`&&t?t:{};return typeof r!=`string`||r===``?{package_json:e,reason:`manifest_has_no_version`,status:`unverifiable`}:{...typeof n==`string`?{name:n}:{},package_json:e,status:`found`,version:r}}catch{return{package_json:e,reason:`manifest_unreadable`,status:`unverifiable`}}},Qw=new Set([`ENOENT`,`ENOTDIR`]),$w=async e=>{try{return(await c(e)).length===0}catch{return!1}},eT=async e=>{try{return await p(e),`present`}catch(e){let t=typeof e==`object`&&e&&`code`in e&&typeof e.code==`string`?e.code:void 0;return t!==void 0&&Qw.has(t)?`absent`:`unreadable`}},tT=async e=>{for(let t of Xw(e)){let e=ie(t);if((await Promise.all(qw.map(t=>eT(m(e,t))))).includes(`present`))return!0}return!1},nT=async e=>{try{if(!(await p(e)).isDirectory())throw v(`--project must be a directory: ${e}`)}catch(t){throw t instanceof Error&&t.message.startsWith(`--project`)?t:v(`--project path does not exist: ${e}`)}},rT=async e=>{let t=await eT(e);if(t===`unreadable`)return{reason:`slot_unreadable`,status:`unverifiable`};if(t===`absent`)return;let n=await Zw(m(e,`package.json`));return n===void 0?await $w(e)?void 0:{reason:`installed_without_manifest`,status:`unverifiable`}:n},iT=async(e,t)=>{if(!Yw(t))return{reason:`unsupported_package_name`,status:`unverifiable`};for(let n of Xw(e)){let e=await rT(m(n,...t.split(`/`)));if(e!==void 0)return e}return await tT(e)?{reason:`yarn_pnp`,status:`unsupported_layout`}:{status:`not_materialized`}},aT={'"':`"`,"\\":`\\`,b:`\b`,n:`
|
|
351
|
+
`,t:` `},oT={'"':`"`,"\\":`\\`},sT=new Set([` `,` `]),$=Symbol(`malformed git config`),cT=e=>e!==void 0&&!e.quoted&&sT.has(e.char),lT=e=>{let t=0,n=e.length;for(;t<n&&cT(e[t]);)t+=1;for(;n>t&&cT(e[n-1]);)--n;return e.slice(t,n).map(e=>e.char).join(``)},uT=e=>{let t=[],n=!1;for(let r=0;r<e.length;r+=1){let i=e[r];if(i===`\\`){r+=1;let n=aT[e[r]??``];if(n===void 0)return $;t.push({char:n,quoted:!0})}else if(i===`"`)n=!n;else if(!n&&(i===`#`||i===`;`))return lT(t);else t.push({char:i??``,quoted:n})}return n?$:lT(t)},dT=e=>{let t=``;for(let n=0;n<e.length;n+=1){let r=e[n];if(r===`\\`){n+=1;let r=oT[e[n]??``];if(r===void 0)return $;t+=r}else t+=r??``}return t},fT=/^[ \t]+|[ \t]+$/gu,pT=e=>e.replace(fT,``),mT=/^\[[ \t]*(?<section>[A-Za-z0-9.-]+)[ \t]*(?:"(?<subsection>(?:[^"\\]|\\.)*)")?[ \t]*\]/u,hT=/^(?<name>[A-Za-z][A-Za-z0-9-]*)[ \t]*(?:=[ \t]*(?<value>.*))?$/u,gT=function*(e){let t=``,n=!1,r=!1;for(let i=0;i<e.length;i+=1){let a=e[i];if(a===`
|
|
352
352
|
`)yield t,t=``,n=!1,r=!1;else if(a!==`\r`||e[i+1]!==`
|
|
353
353
|
`){if(r)t+=a;else if(a===`\\`){let n=e[i+1];n===`
|
|
354
354
|
`||n===`\r`&&e[i+2]===`
|
|
355
|
-
`?i+=n===`\r`?2:1:(t+=a+(n??``),i+=1)}else a===`"`?n=!n:!n&&(a===`#`||a===`;`)&&(r=!0),t+=a}}t!==``&&(yield t)},nT=(e,t)=>e.subsection===void 0?`${e.name}.${t.toLowerCase()}`:`${e.name}.${e.subsection}.${t.toLowerCase()}`,rT=(e,t)=>{let n=e.toLowerCase();if(t===void 0)return{name:n};let r=Xw(t);return r===$?$:{name:n,subsection:r}},iT=e=>{let t=$w.exec(e),n=t?.groups?.section;if(n===void 0)return;let r=Qw(e.slice(t?.[0].length??0)),i=rT(n,t?.groups?.subsection);return i===$?$:{rest:r,section:i}},aT=e=>e===``||e.startsWith(`#`)||e.startsWith(`;`),oT=e=>{let t=eT.exec(e),n=t?.groups?.name;if(n===void 0)return $;let r=Yw(t?.groups?.value??``);return r===$?$:{name:n,value:r}},sT=(e,t)=>{let n=oT(t.line);if(n===$)return`malformed`;let r=nT(t.section,n.name);return t.wanted.includes(r)&&e.set(r,[...e.get(r)??[],n.value]),`ok`},cT=(e,t,n)=>t.rest===``||aT(t.rest)?t.section:sT(e,{line:t.rest,section:t.section,wanted:n})===`malformed`?$:t.section,lT=(e,t)=>{let n=iT(t.line);return n===$?$:n===void 0?t.section===uT||sT(e,t)===`malformed`?$:t.section:cT(e,n,t.wanted)},uT={name:``},dT=(e,t)=>{let n=new Map,r=uT;for(let i of tT(e)){let e=Qw(i),a=aT(e)?r:lT(n,{line:e,section:r,wanted:t});if(a===$)return;r=a}return n},fT=`core.hookspath`,pT=`remote.origin.url`,mT=[fT,pT],hT={status:`managed`},gT={status:`missing`},_T=e=>({reason:e,status:`unmanaged`}),vT=e=>({reason:e,status:`unverifiable`}),yT=new Set([`ENOENT`,`ENOTDIR`]),bT=e=>typeof e==`object`&&e&&`code`in e&&typeof e.code==`string`?e.code:void 0,xT=async e=>{try{return await i(e),`present`}catch(e){let t=bT(e);return t!==void 0&&yT.has(t)?`absent`:`unreadable`}},ST=async e=>{try{let t=await i(m(e,`.git`));return t.isSymbolicLink()?_T(`git_is_symlink`):t.isDirectory()?void 0:_T(`git_is_file`)}catch(e){let t=bT(e);return t!==void 0&&yT.has(t)?_T(`no_git`):vT(`git_unreadable`)}},CT=(e,t)=>{let n=e.get(t);if(n===void 0||n.length!==1)return;let[r]=n;return r===void 0||r===``?void 0:r},wT=(e,t,n)=>{try{return gf(e,{allowFileUrls:n}).key===gf(t,{allowFileUrls:n}).key}catch{return!1}},TT=e=>(e.get(fT)?.length??0)>1||(e.get(pT)?.length??0)>1,ET=(e,t)=>{let n=dT(e,mT);return n===void 0?vT(`config_malformed`):TT(n)?vT(`duplicate_config_values`):DT(n,t)},DT=(e,t)=>{if(CT(e,fT)!==t.hooksDir)return _T(`no_refs_marker`);let n=CT(e,pT);return n===void 0?_T(`no_origin`):wT(n,t.expectedUrl,t.allowFileUrls)?hT:_T(`origin_mismatch`)},OT={missing:gT,outside:_T(`outside_sources`),unreadable:vT(`path_unreadable`)},kT=async e=>{let t=await H(e.sourcesDir,e.dest);if(t.kind!==`inside`)return t.kind===`unreadable`?await xT(e.sourcesDir)===`absent`?gT:OT.unreadable:OT[t.kind]},AT=async e=>{let t=await kT(e);if(t!==void 0)return t;let n=await ST(e.dest);if(n!==void 0)return n;try{return ET(await s(m(e.dest,`.git`,`config`),`utf8`),e)}catch{return vT(`config_unreadable`)}},jT=e=>`no registered package or ref matches '${e}' — this does not establish that the repository is untracked; it may be registered under a different identifier. Run: refs list --json`,MT=e=>`ref '${e}' is not in the active refs configuration — to track it: refs add <url>`,NT=e=>`--ref '${e}' matched no configured ref — pass a full ref key or a unique suffix of one. Run: refs list --json`,PT=/^[a-z][a-z0-9+.-]*:\/\//iu,FT=/^git@[^:/\s]+:[^\s]+$/u,IT=e=>PT.test(e)||FT.test(e),LT=(e,t)=>{try{return gf(e,t)}catch{if(IT(e))throw y(`query looks like a git url but is not a supported form — check the url (credentials are never accepted) or run: refs resolve <package|ref-suffix>`);return}},RT=(e,t,n)=>{let r=LT(t,n);if(r!==void 0){if(Object.hasOwn(e.refs,r.key))return{key:r.key};throw _(MT(r.key),`ref_not_registered`)}},zT=(e,t)=>{let n=[];for(let r of Object.keys(e.refs).toSorted()){let i=e.refs[r]?.packages?.[t];i!==void 0&&n.push({entry:i,key:il.parse(r)})}return n},BT=(e,t)=>`package '${e}' is registered by more than one ref: ${t.join(`, `)} — pick one with: refs resolve ${e} --ref <ref>`,VT=(e,t)=>{let n=zT(e,t),[r]=n;if(r!==void 0){if(n.length>1)throw v(BT(t,n.map(e=>e.key)));return r}},HT=function*(e){let t=e.split(`/`);for(let e=t.length-1;e>=1;--e)yield t.slice(0,e).join(`/`)},UT=(e,t)=>{for(let n of HT(t)){let t=VT(e,n);if(t!==void 0)return{...t,name:n}}},WT=(e,t,n)=>{try{return YS(e,t)}catch(e){throw e instanceof g&&e.code===`not_found`?_(n,`unmatched_query`):e}},GT=(e,t)=>{let n=e[t];if(n!==void 0)return{entry:n,name:t};for(let n of HT(t)){let t=e[n];if(t!==void 0)return{entry:t,name:n}}},KT=(e,t,n)=>{let r=WT(e,n,NT(n)),i=GT(e.refs[r]?.packages??{},t);if(i===void 0)throw _(IT(t)?`ref '${r}' is tracked but registers no package matching that query — inspect: refs show ${r} --packages --json`:`ref '${r}' is tracked but registers no package matching '${t}' — inspect: refs show ${r} --packages --json`,`package_not_registered`);return{key:r,packageMatch:{...i,key:r}}},qT=(e,t,n)=>{let r=RT(e,t,n);if(r!==void 0)return r;let i=VT(e,t);if(i!==void 0)return{key:i.key,packageMatch:{...i,name:t}};let a=UT(e,t);return a===void 0?{key:WT(e,t,jT(t))}:{key:a.key,packageMatch:a}},JT=(e,t,n)=>n.ref===void 0?qT(e,t,n):KT(e,t,n.ref),YT=(e,t)=>{let n={head_sha:t.headSha,last_fetched_at:new Date().toISOString()},r=t.effectiveCloneMode??e?.effective_clone_mode;return r!==void 0&&(n.effective_clone_mode=r),n},XT=async(e,t,n)=>{let r=await V(e),i=r.refs[t];i!==void 0&&(r.refs[t]={...i,default_branch:n},await fu(e,r))},ZT=(e,t,n)=>G(e,`home`,async()=>{n.branchRenamedTo!==void 0&&await XT(e,t,n.branchRenamedTo);let r=await Wg(e);r.refs[t]=YT(r.refs[t],n),await Gg(e,r)}),QT=2e3,$T=e=>{if(e.length<=QT)return e;let t=e.slice(0,1500),n=e.slice(e.length-500),r=e.length-QT;return`${t}\n… ${String(r)} characters omitted …\n${n}`},eE=async(e,t,n)=>{try{await G(e,`home`,async()=>{let r=await Wg(e);r.refs[t]={...r.refs[t],last_error:$T(n)},await Gg(e,r)})}catch{}},tE=e=>{let t=0,n=[];return{acquire:()=>{if(t<e)return t+=1,Promise.resolve();let{promise:r,resolve:i}=Promise.withResolvers();return n.push(()=>{t+=1,i()}),r},release:()=>{--t;let e=n.shift();e!==void 0&&e()}}},nE=async(e,t)=>{await e.acquire();try{return await t()}finally{e.release()}},rE=(e,t,n)=>`sync produced a HEAD sha for '${e}' at ${t} that refs cannot store yet (${n.length} hex chars) — only SHA-1 repositories are supported for now`,iE=(e,t,n)=>{if(!zg.shape.head_sha.safeParse(n).success)throw y(rE(e,t,n));return n},aE=(e,t,n)=>{let r={effectiveCloneMode:t.effectiveMode,headSha:n.headSha,status:`cloned`};return n.actualBranch!==e.ref.default_branch&&(r.branchRenamedTo=n.actualBranch),t.warning!==void 0&&(r.warning=t.warning),r},oE=async(e,t,n)=>{await a(ie(n),{recursive:!0});let r=Vg(`clone_mode`,t.ref,t.settings),i=await Sd(e.runner,{cloneUrl:t.ref.url,dest:n,hooksDir:t.home.hooksDir,mode:r}),o=await wd(e.runner,n),s=await ky(e.runner,{allowFileUrls:iy(e.env),dest:n,expectedUrl:t.ref.url,hooksDir:t.home.hooksDir,key:t.key});return aE(t,i,{actualBranch:o,headSha:s})},sE=async(e,t,n)=>{await wy(e.runner,{dest:n,hooksDir:t.home.hooksDir}),await Sy(e.runner,{allowFileUrls:iy(e.env),dest:n,expectedUrl:t.ref.url});let r=await Ad(e.runner,{defaultBranch:t.ref.default_branch,dir:n}),i={headSha:iE(t.key,n,r.newSha),previousSha:r.oldSha,status:r.status};return r.branchRenamedTo!==void 0&&(i.branchRenamedTo=r.branchRenamedTo),r.warning!==void 0&&(i.warning=r.warning),i},cE=(e,t,n)=>(iu(t.home,n),U(n)?sE(e,t,n):oE(e,t,n)),lE={changedDirs:[],kind:`arrivals`,namesBefore:[]},uE=async(e,t,n)=>{if(n.previousSha===void 0)return lE;let r=await ud(e.runner,{dir:t,from:n.previousSha,to:n.headSha});return r===void 0?lE:{...r,kind:`arrivals`}},dE=(e,t)=>G(t.home,ry(t.key),async()=>{let n=B(t.home,t.key),r=await cE(e,t,n),i=await uE(e,n,r);return{...r,structure:await Dx(n,t.ref,i)}}),fE=e=>{let t=[];e.branchRenamedTo!==void 0&&t.push(`default branch renamed to ${e.branchRenamedTo}`),e.warning!==void 0&&t.push(e.warning);let[n]=t;if(n!==void 0)return t.join(` | `)},pE=(e,t)=>{let n={key:e,status:t.status},r=fE(t);return r!==void 0&&(n.warning=r),t.structure!==void 0&&(n.structure=t.structure),n},mE=async(e,t)=>{try{let n=await dE(e,t);return await ZT(t.home,t.key,n),n}catch(e){throw await eE(t.home,t.key,Nv(e)),e}},hE=async(e,t)=>{try{return pE(t.key,await mE(e,t))}catch(e){return{error:Nv(e),key:t.key,status:`failed`}}},gE=(e,t)=>e.status===`rejected`?{error:Nv(e.reason),key:t,status:`failed`}:e.value,_E=async(e,t)=>{let n=tE(4);return(await Promise.allSettled(t.map(t=>nE(n,()=>hE(e,t))))).map((e,n)=>{let r=t[n];if(r===void 0)throw Error(`internal: sync target at index ${n} is missing`);return gE(e,r.key)})},vE=async e=>{let{packageMatch:t}=e.match;return t===void 0?null:await Ew({checkoutDir:e.dest,checkoutManaged:e.checkout.status===`managed`||e.checkout.status===`missing`,checkoutReason:`checkout is ${e.checkout.status}`,configuredPath:t.entry.path,home:e.home,key:e.match.key,packageName:t.name})},yE=(e,t,n)=>JT(t,n.query,{allowFileUrls:iy(e.env),...n.ref===void 0?{}:{ref:n.ref}}),bE=async(e,t)=>{let n=z(e.env),r=await V(n);return{config:r,home:n,match:yE(e,r,t),state:await Wg(n)}},xE=async(e,t)=>{if(t===void 0)return;let{packageMatch:n}=e;if(n===void 0)throw v(`--project needs a query that names a package; '${e.key}' resolves to the ref itself`);return await Uw(t,n.name)},SE=(e,t)=>{if(e.status!==`managed`&&e.status!==`missing`)throw y(`refusing to sync ${t}: its checkout is ${e.status}${e.reason===void 0?``:` (${e.reason})`} — run: refs doctor`)},CE=async(e,t)=>(await mE(e,{home:t.home,key:t.match.key,ref:PS(t.config,t.match.key),settings:t.config.settings})).status,wE=async(e,t)=>{t.project!==void 0&&await Vw(t.project);let n=await bE(e,t),r=await EE(e,n,t);return t.syncIfStale!==!0||!(r.stale||r.missing)?r:(SE(r.checkout,r.key),await TE(e,{key:r.key,opts:t,target:n}))},TE=async(e,t)=>{let{key:n,opts:r}=t,i=await CE(e,t.target),a=await bE(e,r);if(a.match.key!==n)throw Ce(`configuration changed while resolving '${r.query}' — retry`);return{...await EE(e,a,r),sync:{status:i}}},EE=async(e,t,n)=>{let{config:r,home:i,match:a,state:o}=t,{now:s}=n,c=PS(r,a.key),l=B(i,a.key),u=ol(Vg(`sync_ttl`,c,r.settings)),d=o.refs[a.key]?.last_fetched_at,f=await AT({allowFileUrls:iy(e.env),dest:l,expectedUrl:c.url,hooksDir:i.hooksDir,sourcesDir:i.sourcesDir}),p=await xE(a,n.project);return{checkout:f,key:a.key,...d===void 0?{}:{last_fetched_at:d},...p===void 0?{}:{installed:p},local_path:l,missing:f.status===`missing`,package:await vE({checkout:f,dest:l,home:i,match:a}),stale:RS(d,u,s)}},DE=(e,t)=>{let n=[`ref: ${e.key}`,`path: ${e.local_path}`,...VS({lastFetchedAt:e.last_fetched_at,missing:e.missing,now:t,stale:e.stale}),...e.checkout.status===`managed`||e.checkout.status===`missing`?[]:[`checkout: ${e.checkout.status}${e.checkout.reason===void 0?``:` (${e.checkout.reason})`}`]];return e.package!==null&&n.push(...Aw(e.package)),e.sync!==void 0&&n.push(`sync: ${e.sync.status}`),e.installed!==void 0&&n.push(`installed: ${e.installed.version??`(${e.installed.status})`}`,...e.installed.name===void 0?[]:[`installed name: ${e.installed.name}`],...e.installed.reason===void 0?[]:[`installed reason: ${e.installed.reason}`]),n},OE=(e,t,n)=>({now:t,...n.project===void 0?{}:{project:n.project},query:e,...n.ref===void 0?{}:{ref:n.ref},...n.syncIfStale===!0?{syncIfStale:!0}:{}}),kE=(e,t)=>{e.command(`resolve`).description(`Resolve a git url, npm package name, import path, or ref-key suffix to its ref/package.`).argument(`<query>`,`git url, npm package name, import path, or unique ref-key suffix`).option(`--ref <ref>`,`resolve the query as a package within this ref (full key or unique suffix)`).option(`--project <dir>`,`report the version this project has installed of the query's package`).option(`--sync-if-stale`,`fetch or clone first when the ref is stale or its checkout is absent`).action((e,n,r)=>{let i=X(r);return Q(t,i,async()=>{let r=Date.now(),a=await wE(t,OE(e,r,n));Z(t,i,DE(a,r),a)})()})},AE={},jE=async(e,t)=>{if(!U(t))return{tags:[]};try{let{tags:n}=await Pd(e.runner,t,5);return{tags:n}}catch(e){return{tags:[],warning:`could not list tags: ${Nv(e)}`}}},ME=async(e,t,n,r)=>{let i=z(e.env),a=await V(i),o=YS(a,t),s=PS(a,o),c=await Wg(i),l=B(i,o),{packages:u,...d}=s,f=n.tags?await jE(e,l):void 0,p=c.refs[o]??AE;return{data:{...d,key:o,local_path:l,missing:!U(l),...n.packages?{packages:u??{}}:{},packages_count:Object.keys(u??{}).length,...f===void 0?{}:{sample_tags:f.tags},stale:RS(p.last_fetched_at,ol(Vg(`sync_ttl`,s,a.settings)),r),state:p},warnings:Mv(f?.warning)}},NE=(e,t)=>{let n=[`ref: ${e.key}`,`description: ${e.description}`,`url: ${e.url}`,`path: ${e.local_path}`,...VS({lastFetchedAt:e.state.last_fetched_at,missing:e.missing,now:t,stale:e.stale})];return e.sample_tags!==void 0&&e.sample_tags.length>0&&n.push(`tags: ${e.sample_tags.join(`, `)}`),n},PE=(e,t)=>{e.command(`show`).description(`Show a configured ref: entry, state, local path, package count; --packages/--tags add the package map and sample tags to --json.`).argument(`<ref>`,`full ref key or a unique suffix, e.g. zod`).option(`--packages`,`include the ref's full package map in --json output (off by default)`).option(`--tags`,`include sample tags in --json output (human output always probes for them)`).action((e,n,r)=>{let i=X(r);return Q(t,i,async()=>{let r={packages:n.packages===!0,tags:!i.json||n.tags===!0},a=Date.now(),{data:o,warnings:s}=await ME(t,e,r,a);Z(t,i,NE(o,a),o,s)})()})},FE=(e,t,n)=>({home:e,key:n,ref:PS(t,n),settings:t.settings}),IE=(e,t,n)=>n.length===0?Object.keys(t.refs).toSorted().map(n=>FE(e,t,il.parse(n))):n.map(n=>FE(e,t,YS(t,n))),LE=(e,t,n)=>{let r=Date.now();return t.filter(t=>{let i=ol(Vg(`sync_ttl`,t.ref,t.settings)),a=RS(n.refs[t.key]?.last_fetched_at,i,r),o=!U(B(e,t.key));return a||o})},RE=async(e,t,n)=>{if(!u_({env:e.env,updates:n.updates}))return[];let{latest:r,refreshed:i}=await n_({fetch:e.fetcher,home:t,nowMs:Date.now()});return!i||r===void 0||!r_(e.cliVersion,r)?[]:[i_(e.cliVersion,r)]},zE=async(e,t,n)=>{if(!n)return t;let r=await Wg(e);return LE(e,t,r)},BE=async(e,t)=>{let n=z(e.env),r=await V(n),i=IE(n,r,t.refs),a=await zE(n,i,t.staleOnly),[o,s]=await Promise.all([_E(e,a),a.length>0?RE(e,n,r):Promise.resolve([])]);return{failedCount:o.filter(e=>e.status===`failed`).length,results:o,warnings:s}},VE=[`updated`,`fresh`,`cloned`,`restored`,`failed`],HE={cloned:`Cloned`,failed:`Failed`,fresh:`Fresh`,restored:`Restored`,updated:`Updated`},UE=e=>{let t={cloned:[],failed:[],fresh:[],restored:[],updated:[]};for(let n of e)t[n.status].push(n);return t},WE=e=>{if(e.status===`failed`)return[` ${e.key}: ${e.error??`unknown error`}`];let t=e.warning===void 0?` ${e.key}`:` ${e.key} (${e.warning})`;return e.structure===void 0?[t]:[t,...ix(e.structure,e.key).map(e=>` ${e}`)]},GE=e=>{let t=UE(e),n=[VE.map(e=>`${HE[e]} (${t[e].length})`).join(` / `)];for(let e of VE)for(let r of t[e])n.push(...WE(r));return n},KE=(e,t)=>({refs:e,staleOnly:t.staleOnly===!0}),qE=(e,t)=>{e.command(`sync`).description(`Fetch (or re-clone, if the checkout is missing) configured refs — all by default.`).argument(`[refs...]`,`ref keys or unique suffixes to sync (default: every configured ref)`).option(`--stale-only`,`skip refs whose last sync is still within their ref's sync_ttl`).action((e,n,r)=>{let i=X(r);return Q(t,i,async()=>{let r=await BE(t,KE(e,n));Z(t,i,GE(r.results),{results:r.results},r.warnings),r.failedCount>0&&(process.exitCode=Se.UNEXPECTED)})()})},JE=(e,t,n)=>n===void 0?e.tag_format:IS(e,t,n).tag_format??e.tag_format,YE=(e,t,n)=>{if(e!==void 0)return e;let r=n===void 0?`ref '${t}'`:`package '${n}'`,i=n===void 0?[]:[`--package=${Iv(n)}`];throw y(`${r} has no tag_format configured — inspect the repository's real tags and set one with: ${Lv(i,[t,`tag_format`,`<format>`])}`)},XE=async(e,t)=>{let n=z(e.env),r=await V(n),i=YS(r,t.query),a=PS(r,i),o=YE(JE(a,i,t.opts.packageName),i,t.opts.packageName),s=B(n,i);FS(s,i);let c=await Kd(e.runner,s,o,t.version);return{key:i,ref_path:`refs/tags/${c}`,tag:c,version:t.version}},ZE=e=>[`${e.key}@${e.version} -> ${e.tag}`],QE=e=>{let t={};return e.package!==void 0&&(t.packageName=e.package),t},$E=[aw,pb,ew,XS,NS,cw,bw,kE,PE,qE,(e,t)=>{e.command(`tag`).description(`Resolve a version to its git tag, via the ref's (or a package's) tag_format.`).argument(`<ref>`,`full ref key or a unique suffix, e.g. zod`).argument(`<version>`,`version to resolve, e.g. 4.1.0`).option(`--package <name>`,`resolve against this package's tag_format instead of the ref's`).action((e,n,r,i)=>{let a=X(i);return Q(t,a,async()=>{let i=await XE(t,{opts:QE(r),query:e,version:n});Z(t,a,ZE(i),i)})()})}],eD=(e,t)=>{for(let n of $E)n(e,t)},tD=[``,`Examples:`,` $ refs list --json`,` $ refs sync --stale-only --json`,` $ refs resolve zod/mini --json`,``,`Every command accepts --json for structured output and --verbose for stack traces on error.`].join(`
|
|
356
|
-
`),
|
|
355
|
+
`?i+=n===`\r`?2:1:(t+=a+(n??``),i+=1)}else a===`"`?n=!n:!n&&(a===`#`||a===`;`)&&(r=!0),t+=a}}t!==``&&(yield t)},_T=(e,t)=>e.subsection===void 0?`${e.name}.${t.toLowerCase()}`:`${e.name}.${e.subsection}.${t.toLowerCase()}`,vT=(e,t)=>{let n=e.toLowerCase();if(t===void 0)return{name:n};let r=dT(t);return r===$?$:{name:n,subsection:r}},yT=e=>{let t=mT.exec(e),n=t?.groups?.section;if(n===void 0)return;let r=pT(e.slice(t?.[0].length??0)),i=vT(n,t?.groups?.subsection);return i===$?$:{rest:r,section:i}},bT=e=>e===``||e.startsWith(`#`)||e.startsWith(`;`),xT=e=>{let t=hT.exec(e),n=t?.groups?.name;if(n===void 0)return $;let r=uT(t?.groups?.value??``);return r===$?$:{name:n,value:r}},ST=(e,t)=>{let n=xT(t.line);if(n===$)return`malformed`;let r=_T(t.section,n.name);return t.wanted.includes(r)&&e.set(r,[...e.get(r)??[],n.value]),`ok`},CT=(e,t,n)=>t.rest===``||bT(t.rest)?t.section:ST(e,{line:t.rest,section:t.section,wanted:n})===`malformed`?$:t.section,wT=(e,t)=>{let n=yT(t.line);return n===$?$:n===void 0?t.section===TT||ST(e,t)===`malformed`?$:t.section:CT(e,n,t.wanted)},TT={name:``},ET=(e,t)=>{let n=new Map,r=TT;for(let i of gT(e)){let e=pT(i),a=bT(e)?r:wT(n,{line:e,section:r,wanted:t});if(a===$)return;r=a}return n},DT=`core.hookspath`,OT=`remote.origin.url`,kT=[DT,OT],AT={status:`managed`},jT={status:`missing`},MT=e=>({reason:e,status:`unmanaged`}),NT=e=>({reason:e,status:`unverifiable`}),PT=new Set([`ENOENT`,`ENOTDIR`]),FT=e=>typeof e==`object`&&e&&`code`in e&&typeof e.code==`string`?e.code:void 0,IT=async e=>{try{return await i(e),`present`}catch(e){let t=FT(e);return t!==void 0&&PT.has(t)?`absent`:`unreadable`}},LT=async e=>{try{let t=await i(m(e,`.git`));return t.isSymbolicLink()?MT(`git_is_symlink`):t.isDirectory()?void 0:MT(`git_is_file`)}catch(e){let t=FT(e);return t!==void 0&&PT.has(t)?MT(`no_git`):NT(`git_unreadable`)}},RT=(e,t)=>{let n=e.get(t);if(n===void 0||n.length!==1)return;let[r]=n;return r===void 0||r===``?void 0:r},zT=(e,t,n)=>{try{return gf(e,{allowFileUrls:n}).key===gf(t,{allowFileUrls:n}).key}catch{return!1}},BT=e=>(e.get(DT)?.length??0)>1||(e.get(OT)?.length??0)>1,VT=(e,t)=>{let n=ET(e,kT);return n===void 0?NT(`config_malformed`):BT(n)?NT(`duplicate_config_values`):HT(n,t)},HT=(e,t)=>{if(RT(e,DT)!==t.hooksDir)return MT(`no_refs_marker`);let n=RT(e,OT);return n===void 0?MT(`no_origin`):zT(n,t.expectedUrl,t.allowFileUrls)?AT:MT(`origin_mismatch`)},UT={missing:jT,outside:MT(`outside_sources`),unreadable:NT(`path_unreadable`)},WT=async e=>{let t=await H(e.sourcesDir,e.dest);if(t.kind!==`inside`)return t.kind===`unreadable`?await IT(e.sourcesDir)===`absent`?jT:UT.unreadable:UT[t.kind]},GT=async e=>{let t=await WT(e);if(t!==void 0)return t;let n=await LT(e.dest);if(n!==void 0)return n;try{return VT(await s(m(e.dest,`.git`,`config`),`utf8`),e)}catch{return NT(`config_unreadable`)}},KT=e=>`no registered package or ref matches '${e}' — this does not establish that the repository is untracked; it may be registered under a different identifier. Run: refs list --json`,qT=e=>`ref '${e}' is not in the active refs configuration — to track it: refs add <url>`,JT=e=>`--ref '${e}' matched no configured ref — pass a full ref key or a unique suffix of one. Run: refs list --json`,YT=/^[a-z][a-z0-9+.-]*:\/\//iu,XT=/^git@[^:/\s]+:[^\s]+$/u,ZT=e=>YT.test(e)||XT.test(e),QT=(e,t)=>{try{return gf(e,t)}catch{if(ZT(e))throw y(`query looks like a git url but is not a supported form — check the url (credentials are never accepted) or run: refs resolve <package|ref-suffix>`);return}},$T=(e,t,n)=>{let r=QT(t,n);if(r!==void 0){if(Object.hasOwn(e.refs,r.key))return{key:r.key};throw _(qT(r.key),`ref_not_registered`)}},eE=(e,t)=>{let n=[];for(let r of Object.keys(e.refs).toSorted()){let i=e.refs[r]?.packages?.[t];i!==void 0&&n.push({entry:i,key:il.parse(r)})}return n},tE=(e,t)=>`package '${e}' is registered by more than one ref: ${t.join(`, `)} — pick one with: refs resolve ${e} --ref <ref>`,nE=(e,t)=>{let n=eE(e,t),[r]=n;if(r!==void 0){if(n.length>1)throw v(tE(t,n.map(e=>e.key)));return r}},rE=function*(e){let t=e.split(`/`);for(let e=t.length-1;e>=1;--e)yield t.slice(0,e).join(`/`)},iE=(e,t)=>{for(let n of rE(t)){let t=nE(e,n);if(t!==void 0)return{...t,name:n}}},aE=(e,t,n)=>{try{return uC(e,t)}catch(e){throw e instanceof g&&e.code===`not_found`?_(n,`unmatched_query`):e}},oE=(e,t)=>{let n=e[t];if(n!==void 0)return{entry:n,name:t};for(let n of rE(t)){let t=e[n];if(t!==void 0)return{entry:t,name:n}}},sE=(e,t,n)=>{let r=aE(e,n,JT(n)),i=oE(e.refs[r]?.packages??{},t);if(i===void 0)throw _(ZT(t)?`ref '${r}' is tracked but registers no package matching that query — inspect: refs show ${r} --packages --json`:`ref '${r}' is tracked but registers no package matching '${t}' — inspect: refs show ${r} --packages --json`,`package_not_registered`);return{key:r,packageMatch:{...i,key:r}}},cE=(e,t,n)=>{let r=$T(e,t,n);if(r!==void 0)return r;let i=nE(e,t);if(i!==void 0)return{key:i.key,packageMatch:{...i,name:t}};let a=iE(e,t);return a===void 0?{key:aE(e,t,KT(t))}:{key:a.key,packageMatch:a}},lE=(e,t,n)=>n.ref===void 0?cE(e,t,n):sE(e,t,n.ref),uE=(e,t)=>{let n={head_sha:t.headSha,last_fetched_at:new Date().toISOString()},r=t.effectiveCloneMode??e?.effective_clone_mode;return r!==void 0&&(n.effective_clone_mode=r),n},dE=async(e,t,n)=>{let r=await V(e),i=r.refs[t];i!==void 0&&(r.refs[t]={...i,default_branch:n},await fu(e,r))},fE=(e,t,n)=>G(e,`home`,async()=>{n.branchRenamedTo!==void 0&&await dE(e,t,n.branchRenamedTo);let r=await Wg(e);r.refs[t]=uE(r.refs[t],n),await Gg(e,r)}),pE=2e3,mE=e=>{if(e.length<=pE)return e;let t=e.slice(0,1500),n=e.slice(e.length-500),r=e.length-pE;return`${t}\n… ${String(r)} characters omitted …\n${n}`},hE=async(e,t,n)=>{try{await G(e,`home`,async()=>{let r=await Wg(e);r.refs[t]={...r.refs[t],last_error:mE(n)},await Gg(e,r)})}catch{}},gE=e=>{let t=0,n=[];return{acquire:()=>{if(t<e)return t+=1,Promise.resolve();let{promise:r,resolve:i}=Promise.withResolvers();return n.push(()=>{t+=1,i()}),r},release:()=>{--t;let e=n.shift();e!==void 0&&e()}}},_E=async(e,t)=>{await e.acquire();try{return await t()}finally{e.release()}},vE=(e,t,n)=>`sync produced a HEAD sha for '${e}' at ${t} that refs cannot store yet (${n.length} hex chars) — only SHA-1 repositories are supported for now`,yE=(e,t,n)=>{if(!zg.shape.head_sha.safeParse(n).success)throw y(vE(e,t,n));return n},bE=(e,t,n)=>{let r={effectiveCloneMode:t.effectiveMode,headSha:n.headSha,status:`cloned`};return n.actualBranch!==e.ref.default_branch&&(r.branchRenamedTo=n.actualBranch),t.warning!==void 0&&(r.warning=t.warning),r},xE=async(e,t,n)=>{await a(ie(n),{recursive:!0});let r=Vg(`clone_mode`,t.ref,t.settings),i=await Sd(e.runner,{cloneUrl:t.ref.url,dest:n,hooksDir:t.home.hooksDir,mode:r}),o=await wd(e.runner,n),s=await Uy(e.runner,{allowFileUrls:vy(e.env),dest:n,expectedUrl:t.ref.url,hooksDir:t.home.hooksDir,key:t.key});return bE(t,i,{actualBranch:o,headSha:s})},SE=async(e,t,n)=>{await Ry(e.runner,{dest:n,hooksDir:t.home.hooksDir}),await Iy(e.runner,{allowFileUrls:vy(e.env),dest:n,expectedUrl:t.ref.url});let r=await Ad(e.runner,{defaultBranch:t.ref.default_branch,dir:n}),i={headSha:yE(t.key,n,r.newSha),previousSha:r.oldSha,status:r.status};return r.branchRenamedTo!==void 0&&(i.branchRenamedTo=r.branchRenamedTo),r.warning!==void 0&&(i.warning=r.warning),i},CE=(e,t,n)=>(iu(t.home,n),U(n)?SE(e,t,n):xE(e,t,n)),wE={changedDirs:[],kind:`arrivals`,namesBefore:[]},TE=async(e,t,n)=>{if(n.previousSha===void 0)return wE;let r=await ud(e.runner,{dir:t,from:n.previousSha,to:n.headSha});return r===void 0?wE:{...r,kind:`arrivals`}},EE=(e,t)=>G(t.home,_y(t.key),async()=>{let n=B(t.home,t.key),r=await CE(e,t,n),i=await TE(e,n,r);return{...r,structure:await Vx(n,t.ref,i)}}),DE=(e,t)=>`Syncing refs: ${e}/${t} done`,OE=(e,t)=>{let n=0;return{finished:()=>{n+=1,e.update(DE(n,t))},started:()=>{e.update(DE(n,t))}}},kE=e=>{let t=[];e.branchRenamedTo!==void 0&&t.push(`default branch renamed to ${e.branchRenamedTo}`),e.warning!==void 0&&t.push(e.warning);let[n]=t;if(n!==void 0)return t.join(` | `)},AE=(e,t)=>{let n={key:e,status:t.status},r=kE(t);return r!==void 0&&(n.warning=r),t.structure!==void 0&&(n.structure=t.structure),n},jE=async(e,t)=>{try{let n=await EE(e,t);return await fE(t.home,t.key,n),n}catch(e){throw await hE(t.home,t.key,Kv(e)),e}},ME=async(e,t)=>{try{return AE(t.key,await jE(e,t))}catch(e){return{error:Kv(e),key:t.key,status:`failed`}}},NE=(e,t)=>e.status===`rejected`?{error:Kv(e.reason),key:t,status:`failed`}:e.value,PE=async(e,t,n)=>{let r=gE(4),i=n===void 0?void 0:OE(n,t.length);return(await Promise.allSettled(t.map(t=>_E(r,async()=>{i?.started();try{return await ME(e,t)}finally{i?.finished()}})))).map((e,n)=>{let r=t[n];if(r===void 0)throw Error(`internal: sync target at index ${n} is missing`);return NE(e,r.key)})},FE=async e=>{let{packageMatch:t}=e.match;return t===void 0?null:await Vw({checkoutDir:e.dest,checkoutManaged:e.checkout.status===`managed`||e.checkout.status===`missing`,checkoutReason:`checkout is ${e.checkout.status}`,configuredPath:t.entry.path,home:e.home,key:e.match.key,packageName:t.name})},IE=(e,t,n)=>lE(t,n.query,{allowFileUrls:vy(e.env),...n.ref===void 0?{}:{ref:n.ref}}),LE=async(e,t)=>{let n=z(e.env),r=await V(n);return{config:r,home:n,match:IE(e,r,t),state:await Wg(n)}},RE=async(e,t)=>{if(t===void 0)return;let{packageMatch:n}=e;if(n===void 0)throw v(`--project needs a query that names a package; '${e.key}' resolves to the ref itself`);return await iT(t,n.name)},zE=(e,t)=>{if(e.status!==`managed`&&e.status!==`missing`)throw y(`refusing to sync ${t}: its checkout is ${e.status}${e.reason===void 0?``:` (${e.reason})`} — run: refs doctor`)},BE=async(e,t)=>(await jE(e,{home:t.home,key:t.match.key,ref:YS(t.config,t.match.key),settings:t.config.settings})).status,VE=async(e,t)=>{t.project!==void 0&&await nT(t.project);let n=await LE(e,t),r=await UE(e,n,t);return t.syncIfStale!==!0||!(r.stale||r.missing)?r:(zE(r.checkout,r.key),await HE(e,{key:r.key,opts:t,target:n}))},HE=async(e,t)=>{let{key:n,opts:r}=t,i=await BE(e,t.target),a=await LE(e,r);if(a.match.key!==n)throw Ce(`configuration changed while resolving '${r.query}' — retry`);return{...await UE(e,a,r),sync:{status:i}}},UE=async(e,t,n)=>{let{config:r,home:i,match:a,state:o}=t,{now:s}=n,c=YS(r,a.key),l=B(i,a.key),u=ol(Vg(`sync_ttl`,c,r.settings)),d=o.refs[a.key]?.last_fetched_at,f=await GT({allowFileUrls:vy(e.env),dest:l,expectedUrl:c.url,hooksDir:i.hooksDir,sourcesDir:i.sourcesDir}),p=await RE(a,n.project);return{checkout:f,key:a.key,...d===void 0?{}:{last_fetched_at:d},...p===void 0?{}:{installed:p},local_path:l,missing:f.status===`missing`,package:await FE({checkout:f,dest:l,home:i,match:a}),stale:$S(d,u,s)}},WE=(e,t)=>{let n=[`ref: ${e.key}`,`path: ${e.local_path}`,...nC({lastFetchedAt:e.last_fetched_at,missing:e.missing,now:t,stale:e.stale}),...e.checkout.status===`managed`||e.checkout.status===`missing`?[]:[`checkout: ${e.checkout.status}${e.checkout.reason===void 0?``:` (${e.checkout.reason})`}`]];return e.package!==null&&n.push(...Gw(e.package)),e.sync!==void 0&&n.push(`sync: ${e.sync.status}`),e.installed!==void 0&&n.push(`installed: ${e.installed.version??`(${e.installed.status})`}`,...e.installed.name===void 0?[]:[`installed name: ${e.installed.name}`],...e.installed.reason===void 0?[]:[`installed reason: ${e.installed.reason}`]),n},GE=(e,t,n)=>({now:t,...n.project===void 0?{}:{project:n.project},query:e,...n.ref===void 0?{}:{ref:n.ref},...n.syncIfStale===!0?{syncIfStale:!0}:{}}),KE=(e,t)=>{e.command(`resolve`).description(`Resolve a git url, npm package name, import path, or ref-key suffix to its ref/package.`).argument(`<query>`,`git url, npm package name, import path, or unique ref-key suffix`).option(`--ref <ref>`,`resolve the query as a package within this ref (full key or unique suffix)`).option(`--project <dir>`,`report the version this project has installed of the query's package`).option(`--sync-if-stale`,`fetch or clone first when the ref is stale or its checkout is absent`).action((e,n,r)=>{let i=X(r);return Q(t,i,async()=>{let r=Date.now(),a=await VE(t,GE(e,r,n));Z(t,i,WE(a,r),a)})()})},qE={},JE=async(e,t)=>{if(!U(t))return{tags:[]};try{let{tags:n}=await Pd(e.runner,t,5);return{tags:n}}catch(e){return{tags:[],warning:`could not list tags: ${Kv(e)}`}}},YE=async(e,t,n,r)=>{let i=z(e.env),a=await V(i),o=uC(a,t),s=YS(a,o),c=await Wg(i),l=B(i,o),{packages:u,...d}=s,f=n.tags?await JE(e,l):void 0,p=c.refs[o]??qE;return{data:{...d,key:o,local_path:l,missing:!U(l),...n.packages?{packages:u??{}}:{},packages_count:Object.keys(u??{}).length,...f===void 0?{}:{sample_tags:f.tags},stale:$S(p.last_fetched_at,ol(Vg(`sync_ttl`,s,a.settings)),r),state:p},warnings:Gv(f?.warning)}},XE=(e,t)=>{let n=[`ref: ${e.key}`,`description: ${e.description}`,`url: ${e.url}`,`path: ${e.local_path}`,...nC({lastFetchedAt:e.state.last_fetched_at,missing:e.missing,now:t,stale:e.stale})];return e.sample_tags!==void 0&&e.sample_tags.length>0&&n.push(`tags: ${e.sample_tags.join(`, `)}`),n},ZE=(e,t)=>{e.command(`show`).description(`Show a configured ref: entry, state, local path, package count; --packages/--tags add the package map and sample tags to --json.`).argument(`<ref>`,`full ref key or a unique suffix, e.g. zod`).option(`--packages`,`include the ref's full package map in --json output (off by default)`).option(`--tags`,`include sample tags in --json output (human output always probes for them)`).action((e,n,r)=>{let i=X(r);return Q(t,i,async()=>{let r={packages:n.packages===!0,tags:!i.json||n.tags===!0},a=Date.now(),{data:o,warnings:s}=await YE(t,e,r,a);Z(t,i,XE(o,a),o,s)})()})},QE=(e,t,n)=>({home:e,key:n,ref:YS(t,n),settings:t.settings}),$E=(e,t,n)=>n.length===0?Object.keys(t.refs).toSorted().map(n=>QE(e,t,il.parse(n))):n.map(n=>QE(e,t,uC(t,n))),eD=(e,t,n)=>{let r=Date.now();return t.filter(t=>{let i=ol(Vg(`sync_ttl`,t.ref,t.settings)),a=$S(n.refs[t.key]?.last_fetched_at,i,r),o=!U(B(e,t.key));return a||o})},tD=async(e,t,n)=>{if(!u_({env:e.env,updates:n.updates}))return[];let{latest:r,refreshed:i}=await n_({fetch:e.fetcher,home:t,nowMs:Date.now()});return!i||r===void 0||!r_(e.cliVersion,r)?[]:[i_(e.cliVersion,r)]},nD=async(e,t,n)=>{if(!n)return t;let r=await Wg(e);return eD(e,t,r)},rD=e=>{let{config:t,ctx:n,home:r,scoped:i,spinner:a}=e;if(i.length===0)return Promise.resolve([[],[]]);let o={pending:!0};return Promise.all([(async()=>{let e=await PE(n,i,a);return o.pending&&a.update(`Checking for a newer refs release`),e})(),(async()=>{try{return await tD(n,r,t)}finally{o.pending=!1}})()])},iD=async(e,t,n)=>{n.update(`Reading the config`);let r=z(e.env),i=await V(r),a=$E(r,i,t.refs),o=await nD(r,a,t.staleOnly),[s,c]=await rD({config:i,ctx:e,home:r,scoped:o,spinner:n});return{failedCount:s.filter(e=>e.status===`failed`).length,results:s,warnings:c}},aD=[`updated`,`fresh`,`cloned`,`restored`,`failed`],oD={cloned:`Cloned`,failed:`Failed`,fresh:`Fresh`,restored:`Restored`,updated:`Updated`},sD=e=>{let t={cloned:[],failed:[],fresh:[],restored:[],updated:[]};for(let n of e)t[n.status].push(n);return t},cD=e=>{if(e.status===`failed`)return[` ${e.key}: ${e.error??`unknown error`}`];let t=e.warning===void 0?` ${e.key}`:` ${e.key} (${e.warning})`;return e.structure===void 0?[t]:[t,...vx(e.structure,e.key).map(e=>` ${e}`)]},lD=e=>{let t=sD(e),n=[aD.map(e=>`${oD[e]} (${t[e].length})`).join(` / `)];for(let e of aD)for(let r of t[e])n.push(...cD(r));return n},uD=(e,t)=>({refs:e,staleOnly:t.staleOnly===!0}),dD=(e,t)=>{e.command(`sync`).description(`Fetch (or re-clone, if the checkout is missing) configured refs — all by default.`).argument(`[refs...]`,`ref keys or unique suffixes to sync (default: every configured ref)`).option(`--stale-only`,`skip refs whose last sync is still within their ref's sync_ttl`).action((e,n,r)=>{let i=X(r);return Q(t,i,async()=>{let r=await Yv(t,i,r=>iD(t,uD(e,n),r));Z(t,i,lD(r.results),{results:r.results},r.warnings),r.failedCount>0&&(process.exitCode=Se.UNEXPECTED)})()})},fD=(e,t,n)=>n===void 0?e.tag_format:ZS(e,t,n).tag_format??e.tag_format,pD=(e,t,n)=>{if(e!==void 0)return e;let r=n===void 0?`ref '${t}'`:`package '${n}'`,i=n===void 0?[]:[`--package=${Xv(n)}`];throw y(`${r} has no tag_format configured — inspect the repository's real tags and set one with: ${Zv(i,[t,`tag_format`,`<format>`])}`)},mD=async(e,t)=>{let n=z(e.env),r=await V(n),i=uC(r,t.query),a=YS(r,i),o=pD(fD(a,i,t.opts.packageName),i,t.opts.packageName),s=B(n,i);XS(s,i);let c=await Kd(e.runner,s,o,t.version);return{key:i,ref_path:`refs/tags/${c}`,tag:c,version:t.version}},hD=e=>[`${e.key}@${e.version} -> ${e.tag}`],gD=e=>{let t={};return e.package!==void 0&&(t.packageName=e.package),t},_D=[bw,Db,hw,dC,JS,Cw,Fw,KE,ZE,dD,(e,t)=>{e.command(`tag`).description(`Resolve a version to its git tag, via the ref's (or a package's) tag_format.`).argument(`<ref>`,`full ref key or a unique suffix, e.g. zod`).argument(`<version>`,`version to resolve, e.g. 4.1.0`).option(`--package <name>`,`resolve against this package's tag_format instead of the ref's`).action((e,n,r,i)=>{let a=X(i);return Q(t,a,async()=>{let i=await mD(t,{opts:gD(r),query:e,version:n});Z(t,a,hD(i),i)})()})}],vD=(e,t)=>{for(let n of _D)n(e,t)},yD=[``,`Examples:`,` $ refs list --json`,` $ refs sync --stale-only --json`,` $ refs resolve zod/mini --json`,``,`Every command accepts --json for structured output and --verbose for stack traces on error.`].join(`
|
|
356
|
+
`),bD=new Set([`commander.help`,`commander.helpDisplayed`,`commander.version`]),xD=`--json`,SD=`--verbose`,CD=/\n$/u,wD=/^error: /u,TD=e=>e.replace(wD,``),ED=(e,t)=>{for(let n of e){if(n===`--`)return!1;if(n===t)return!0}return!1},DD=e=>ED(e,xD),OD=e=>ED(e,SD),kD=(e,t,n)=>n&&t!==void 0?`${e}\n${t}`:e,AD=e=>{let t=new Bv().name(`refs`).description(`Manage git-based reference checkouts shared across a workspace.`).version(Tv).option(xD,`emit machine-readable JSON on stdout instead of human-readable text`).option(SD,`include stack traces in error output`).allowExcessArguments(!1).exitOverride().configureOutput({outputError:()=>{},writeErr:t=>{e.errLine(t.replace(CD,``))},writeOut:t=>{e.out(t.replace(CD,``))}});return t.addHelpText(`after`,yD),vD(t,e),t},jD=()=>{process.exitCode=Se.OK},MD=(e,t,n)=>{let r={code:`usage`,message:kD(TD(n.message),n.stack,t.verbose)};qv(e,t,r),process.exitCode=Se.USAGE},ND=(e,t,n)=>{if(bD.has(n.code)){jD();return}MD(e,t,n)},PD=(e,t,n)=>{let r=Te(n,{verbose:t.verbose});qv(e,t,r),process.exitCode=r.exitCode},FD=async(e,t,n)=>{let r={json:DD(n),verbose:OD(n)};try{await t.parseAsync(n)}catch(t){if(t instanceof kv){ND(e,r,t);return}PD(e,r,t)}},ID=(e,t)=>FD(e,AD(e),t);import.meta.main&&await ID(Ov(),process.argv);export{AD as buildProgram,X as cliOptsOf,Z as emit,qv as emitError,Kv as errorMessageOf,Jv as progress,Ov as realContext,vD as registerCommands,ID as run,FD as runProgram,Gv as warningsFor,Yv as withSpinner,Q as wrapAction};
|