@politty/loculus 0.4.1 → 0.4.3

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.
@@ -1,6 +1,6 @@
1
- import{a as e,n as t,u as n}from"./schema-extractor-BI5ypJ21.js";import{i as r,o as i}from"./registry-ZnSdmqJ1.js";import{n as a}from"./command-BXsTrIgI.js";import{c as o,i as s}from"./subcommand-router-40vA6Mka.js";import{n as c,o as l,r as u,s as d,u as f}from"./argv-parser-CVXuhpy6.js";import{t as p}from"./schema-Bz8oC0xQ.js";import{execSync as m}from"node:child_process";function h(e,t,n){return{fieldName:e.name,isArrayOption:e.valueType===`array`,isGlobal:e.isGlobal===!0,resolvedDeps:_(e.valueCompletion,e.isGlobal===!0,t,n)}}function g(e,t,n){return{fieldName:e.name,isArrayOption:!1,isGlobal:!1,resolvedDeps:_(e.valueCompletion,!1,t,n)}}function _(e,t,n,r=[]){if(e?.type!==`expand`)return[];let i=/* @__PURE__ */ new Set,a=/* @__PURE__ */ new Set;for(let e of n)e.isGlobal===!0?i.add(e.name):a.add(e.name);for(let e of r)a.add(e.name);return e.dependsOn.map(e=>({name:e,isGlobal:t||i.has(e)&&!a.has(e)}))}function v(e){let t=`$'`;for(let n of e){let e=n.codePointAt(0);t+=n===`\\`?`\\\\`:n===`'`?`\\'`:n===`
2
- `?`\\n`:n===`\r`?`\\r`:n===` `?`\\t`:e<32||e===127?`\\x${e.toString(16).padStart(2,`0`)}`:n}return t+=`'`,t}function y(e){return`'${e.replace(/'/g,`'\\''`)}'`}function b(e,t){let n=t.withSize?`%Y:%s`:`%Y`,r=t.withSize?`%m:%z`:`%m`,i=`stat -L -c '${n}' "${e}" 2>/dev/null`,a=`stat -L -f '${r}' "${e}" 2>/dev/null`;return t.shell===`fish`?`(${i}; or ${a})`:`$(${i} || ${a})`}function x(e){return e.length===1?`-${e}`:`--${e}`}function S(e,t){C(e,x(t)),t.length===1?C(e,`--${t}`):t.includes(`-`)&&C(e,`--${i(t)}`)}function C(e,t){e.includes(t)||e.push(t)}function w(e,t){let n=[`--${e}`];e.length===1&&n.push(`-${e}`),e.includes(`-`)&&n.push(`--${i(e)}`);for(let e of t??[])S(n,e);return n}function T(e){let t=/* @__PURE__ */ new Set;for(let n of e)if(n.isGlobal===!0){n.cliName.length===1&&t.add(`-${n.cliName}`);for(let e of n.alias??[])e.length===1&&t.add(`-${e}`)}return t}function E(e,t,n,r){let a=new Set(w(e,t));if(n&&(a.add(`--${n}`),n.includes(`-`)&&a.add(`--${i(n)}`)),r?.frameOptions){if(r.isGlobal===!0){for(let e of r.frameOptions)if(e.isGlobal!==!0)for(let t of A(e.cliName,e.alias))a.delete(t)}else{let e=T(r.frameOptions);if(e.size>0){let n=new Set((t??[]).filter(e=>e.length===1).map(e=>`-${e}`));for(let t of e)n.has(t)||a.delete(t)}}}return[...a].map(e=>`"${e}"`)}function D(e,t){return e.map(e=>{let n=t.find(t=>t.isGlobal!==!0&&t.name===e.name);return n&&E(n.cliName,n.alias,n.negation,{frameOptions:t})})}function O(e,t,n,r=`$_pos_count`){let i=D(e,t);if(i.every(e=>e===void 0))return;let a=[` local _slot=-1 _left=${r}`];return e.forEach((e,t)=>{let r=i[t],o=r?` && __${n}_not_used ${r.join(` `)}`:``,s=e.variadic?`_slot=${e.position}`:`if (( _left == 0 )); then _slot=${e.position}; else (( _left-- )); fi`;a.push(` if (( _slot < 0 ))${o}; then ${s}; fi`)}),a}function k(e,t){let n=[`__${e}_track_positionals() {`,` local _k=0 _w`,' for _w in "${_pos_words[@]}"; do',` local _slot=$_k`,` case "$_subcmd" in`];for(let r of t){n.push(` ${r.pathStrs.map(e=>`"${e}"`).join(`|`)})`);for(let t of O(r.positionals,r.options,e,`$_k`)??[])n.push(` ${t}`);n.push(` ;;`)}return n.push(` esac`,` __${e}_track_pos "$_subcmd" "$_slot" "$_w"`,` (( _k++ ))`,` done`,`}`,``),n}function A(e,t){let n=[`--${e}`];e.includes(`-`)&&n.push(`--${i(e)}`);for(let e of t??[])S(n,e);return n}function j(e){let t=e.completion;if(t?.custom){let n=t.custom,r=[];if(n.expand&&r.push(`expand`),n.resolve&&r.push(`resolve`),n.choices&&n.choices.length>0&&r.push(`choices`),n.shellCommand&&r.push(`shellCommand`),r.length>1)throw Error(`Field "${e.name??`<unknown>`}": completion.custom may only specify one of choices, shellCommand, resolve, expand (got ${r.join(`, `)}).`);if(n.expand)return{type:`pending-expand`,spec:n.expand};if(n.resolve)return{type:`dynamic`,resolve:n.resolve};if(n.choices&&n.choices.length>0)return{type:`choices`,choices:n.choices};if(n.shellCommand)return{type:`command`,shellCommand:n.shellCommand}}if(t?.type){if(t.type===`file`)return t.matcher?{type:`file`,matcher:t.matcher}:t.extensions?{type:`file`,extensions:t.extensions}:{type:`file`};if(t.type===`directory`)return{type:`directory`};if(t.type===`none`)return{type:`none`}}if(e.enumValues&&e.enumValues.length>0)return{type:`choices`,choices:e.enumValues}}function M(e){if(e)return e.type===`pending-expand`?{type:`runtime-expand`,dependsOn:e.spec.dependsOn,enumerate:e.spec.enumerate}:e}function ee(e){return e.args?N(e.args):[]}function N(n){return e(t(n)).map(P)}function P(e){let t=r(e);return{name:e.name,cliName:e.cliName,alias:t.length>0?t:void 0,negation:e.negationDisplay,negationDescription:e.negationDescription,description:e.description,takesValue:e.type!==`boolean`,valueType:e.type,required:e.required,defaultNegationAccepted:e.type===`boolean`&&e.negation===!0,valueCompletion:M(j(e))}}function F(e){return new Set(w(e.cliName,e.alias))}function te(e,t){let n=F(t);for(let t of e)for(let e of F(t))if(n.has(e))return t}function ne(e,t,n){let r=/* @__PURE__ */ new Set;if(t.length===0)return r;let i=/* @__PURE__ */ new Set,a=(e,t)=>{G(n,e,t,i),r.add(e.name)},o=0;for(;o<e.length;){let i=e[o];if(i===`--`||!i.startsWith(`-`))break;if(u(i)){let{isGlobal:s,flags:l,valueOption:u}=z(i,t);if(!s)break;for(let{opt:e}of l)n[e.name]=!0,r.add(e.name);if(u?.value!==void 0)a(u.opt,u.value);else if(u){let t=e[o+1];if(t===void 0)break;c(t)&&(a(u.opt,t),o++)}o++;continue}if(!i.startsWith(`--`)&&i.length>2){let e=i.indexOf(`=`);if((e>=0?i.slice(1,e):i.slice(1)).length>1)break}let s=R(i),l=q(t,s);if(!l){if(de(t,s)){o++;continue}break}if(l.takesValue){if(B(i)){let e=i.indexOf(`=`);a(l,i.slice(e+1)),o++}else if(o+1<e.length){let t=e[o+1];if(!c(t)){o++;continue}a(l,t),o+=2}else break}else{let e=V(l,s,i);e!==void 0&&(n[l.name]=e),r.add(l.name),o++}}return r}function re(e,t){return t.valueType===`array`?Array.isArray(e)?e:[e]:Array.isArray(e)?e.at(-1):e}function ie(e,t){return t.length===0?e:[...e,...t]}function ae(e,t){let n=t.length-1;if(!(n<0))return e>n?n:e}function I(e,t){return n=>{let r={...e};return l(n,e).forEach((e,n)=>{n<t.length&&(r[e.name]=t[n])}),r}}function oe(e,r,i){if(!e.args)return;let a=t(e.args),o=n(a,I(r,i));if(o!==a)return o.fields.filter(e=>e.named).map(P)}function se(e,r,i){if(!e.args)return[];let a=n(t(e.args),I(r,i));return l(a,r).map((e,t)=>({name:e.name,cliName:e.cliName,position:t,description:e.description,required:e.required,variadic:e.type===`array`,valueCompletion:M(j(e))}))}function ce(e){if(!e.subCommands)return[];let t=[];for(let[n,r]of Object.entries(e.subCommands)){if(n.startsWith(`__`))continue;t.push(n);let e=o(r);e?.aliases&&t.push(...e.aliases)}return t}function le(e,t){if(!e.subCommands)return null;let n=Object.hasOwn(e.subCommands,t)?e.subCommands[t]:void 0;if(n)return o(n);let r=s(e,t);return r?o(e.subCommands[r]):null}function L(e){return e.startsWith(`-`)}function R(e){if(e.startsWith(`--`)){let t=e.slice(2),n=t.indexOf(`=`);return{name:n>=0?t.slice(0,n):t,isLong:!0}}return e.startsWith(`-`)?{name:e.slice(1,2),isLong:!1}:{name:e,isLong:!0}}function z(e,t){let n=(e,t)=>q(e,{name:t,isLong:!1}),r=t.filter(e=>e.isGlobal!==!0),i=t.filter(e=>e.isGlobal===!0),a=e=>!n(r,e)&&n(i,e)!==void 0,o=d(e.slice(1),e=>a(e)&&n(i,e).takesValue),s=o.flags.every(a),c=s?i:r,{flags:l,valueOption:u}=s?o:d(e.slice(1),e=>n(r,e)?.takesValue===!0);return{isGlobal:s,flags:l.flatMap(e=>{let t=n(c,e);return t?[{opt:t,name:e}]:[]}),valueOption:u&&{opt:n(c,u.name),value:u.value}}}function ue(e,t){let{valueOption:n}=z(e,t);return n?.value===void 0?n?.opt:void 0}function B(e){return e.includes(`=`)}function V(e,t,n){let r=fe(e,t);return B(n)?r?void 0:f(n.slice(n.indexOf(`=`)+1)):!r}function H(e,t,n){if(!n||e.valueType!==`boolean`)return!1;let r=[e.cliName,...e.alias??[]];for(let e of r){let n=`no-${e}`;if(t===n||t===i(n))return!0}return!1}function U(e,t,n){return e.defaultNegationAccepted===!0&&H(e,t,n)}function de(e,t){return e.some(e=>e.defaultNegationAccepted!==!0&&H(e,t.name,t.isLong))}function W(e,t){return e!==void 0&&e.includes(`-`)&&i(e)===t}function G(e,t,n,r){if(t.valueType!==`array`)e[t.name]=n;else if(r.has(t.name)){let r=e[t.name];e[t.name]=Array.isArray(r)?[...r,n]:[n]}else e[t.name]=[n],r.add(t.name)}function fe(e,t){return t.isLong?e.negation!==void 0&&(e.negation===t.name||W(e.negation,t.name))?!0:U(e,t.name,t.isLong):!1}function K(e,t,n){if(e.cliName===t&&(n||e.cliName.length===1))return!0;if(e.alias){for(let r of e.alias)if(r===t&&(n||r.length===1))return!0}return n&&e.negation===t?!0:!n||t.length<=1?!1:W(e.cliName,t)||e.alias?.some(e=>W(e,t))?!0:W(e.negation,t)}function q(e,t){if(!t.isLong){let n=e.find(e=>e.isGlobal!==!0&&e.alias?.includes(t.name)===!0);if(n)return n;let r=e.find(e=>e.isGlobal===!0&&K(e,t.name,t.isLong));if(r)return r}return e.find(e=>K(e,t.name,t.isLong))||e.find(e=>U(e,t.name,t.isLong))}function J(e,t,n){let r=Y(e,t,n);return r.variantOptions?Y(e,t,n,{command:r.context.currentCommand,options:r.variantOptions}).context:r.context}function Y(e,t,n,r){let i=e=>e===r?.command?r.options:ee(e),a=t,o=[],s=n?N(n).map(e=>({...e,isGlobal:!0})):[],l=/* @__PURE__ */ new Set,d=!1,f=0,p={},m=[],h={},g=/* @__PURE__ */ new Set,_=0,v=/* @__PURE__ */ new Set,y=e=>{l.add(e.cliName);for(let t of e.alias??[])l.add(t);e.negation&&l.add(e.negation),d=!0},b=(e,t)=>{G(e.isGlobal===!0?h:p,e,t,v)},x=(e,t,n=``)=>{let r=e.isGlobal===!0?h:p,i=V(e,t,n);i!==void 0&&(r[e.name]=i)},S=0,C=ie(i(a),s),w=!1;for(;S<e.length-1;){let t=e[S];if(!w&&t===`--`){w=!0,S++;continue}if(!w&&u(t)){d=!0;let{flags:n,valueOption:r}=z(t,C);for(let{opt:e,name:t}of n)y(e),x(e,{name:t,isLong:!1});r&&(y(r.opt),r.value===void 0?S+1<e.length-1&&c(e[S+1])&&(b(r.opt,e[S+1]),S++):b(r.opt,r.value)),S++;continue}if(!w&&L(t)){d=!0;let n=R(t),r=q(C,n);if(r){if(y(r),r.takesValue){if(B(t)){let e=t.indexOf(`=`);b(r,t.slice(e+1))}else if(S+1<e.length-1){let t=e[S+1];c(t)&&(b(r,t),S++)}}else x(r,n,t)}S++;continue}let n=w?null:le(a,t);if(n){o.push(t);let r=i(a),c=e.slice(_,S);for(let e of ne(c,s,h))g.add(e);a=n,C=ie(i(a),s);for(let e of Object.keys(p)){let t=r.find(t=>t.name===e),n=s.find(t=>t.name===e)??(t?te(s,t):void 0);n&&(g.has(n.name)||(h[n.name]=re(p[e],n)))}l.clear(),f=0,p={},m=[],v=/* @__PURE__ */ new Set,_=S+1,S++}else m.push(t),f++,S++}let T=e[e.length-1]??``,E=e[e.length-2]??``,D=oe(a,p,m),O=se(a,p,m),k=ce(a);for(let e=0;e<O.length;e++){let t=O[e];if(t.variadic){p[t.name]=m.slice(e);break}e<m.length&&(p[t.name]=m[e])}let A,j,M;if(!w&&E&&L(E)&&!B(E)){let e=u(E)?ue(E,C):q(C,R(E));e&&e.takesValue?(A=`option-value`,j=e):T.startsWith(`-`)?A=`option-name`:(A=X(T,k,O,f),A===`positional`&&(M=f))}else if(!w&&T.startsWith(`-`)&&B(T)){let e=q(C,R(T));e&&e.takesValue?(A=`option-value`,j=e):A=`option-name`}else!w&&T.startsWith(`-`)?A=`option-name`:(A=X(T,k,O,f,w),A===`positional`&&(M=f));let P=[];if(j){if(j.valueType===`array`){let e=(j.isGlobal===!0?h:p)[j.name];P=Array.isArray(e)?e.filter(e=>typeof e==`string`):[]}}else if(A===`positional`&&M!==void 0){let e=ae(M,O);e!==void 0&&O[e]?.variadic&&(P=m.slice(e))}let F={...h,...p};return{context:{subcommandPath:o,currentCommand:a,currentWord:T,previousWord:E,completionType:A,targetOption:j,positionalIndex:M,options:C,subcommands:k,positionals:O,usedOptions:l,hasAnyOptionBeenUsed:d,providedPositionalCount:f,parsedArgs:F,previousValues:P},variantOptions:D}}function X(e,t,n,r,i){return i?`positional`:t.length>0&&(t.filter(t=>t.startsWith(e)).length>0||e===``)?`subcommand`:r<n.length||n.length>0&&n[n.length-1].variadic?`positional`:`subcommand`}const Z={Default:0,NoSpace:1,NoFileCompletion:2,FilterPrefix:4,KeepOrder:8,FileCompletion:16,DirectoryCompletion:32,Error:64};function pe(e){if(!e.startsWith(`-`))return;let t=e.indexOf(`=`);if(!(t<=0))return e.slice(0,t+1)}async function me(e,t){switch(e.completionType){case`subcommand`:return we(e);case`option-name`:return Te(e);case`option-value`:{let n=e.targetOption,r=n?pe(e.currentWord):void 0;return Q(r?{...e,currentWord:e.currentWord.slice(r.length)}:e,t,n?.name,n?.valueCompletion,void 0,n?.valueType===`array`)}case`positional`:{let n=he(e);return n?Q(e,t,n.name,n.valueCompletion,n.description,!1):{candidates:[],directive:Z.NoFileCompletion}}}}function he(e){let t=e.positionalIndex??0,n=ae(t,e.positionals);if(n===void 0)return;let r=e.positionals[n];if(r)return n===t||r.variadic?r:void 0}function ge(e){try{return m(e,{encoding:`utf-8`,timeout:5e3}).split(`
3
- `).map(e=>e.trim()).filter(e=>e.length>0).map(e=>({value:e,type:`value`}))}catch{return[]}}function _e(e){return e?.type===`choices`?e.choices:void 0}function ve(e,t){let n=e.options.find(e=>e.name===t&&e.isGlobal!==!0);if(n)return _e(n.valueCompletion);let r=e.positionals.find(e=>e.name===t);return _e(r?r.valueCompletion:e.options.find(e=>e.name===t&&e.isGlobal===!0)?.valueCompletion)}function ye(e,t){let n=!t.includes(`=`),r=n?be(e):xe(e,t);return{candidates:r,hasEqSuffix:n&&r.some(e=>e.value.endsWith(`=`))}}function be(e){let t=/* @__PURE__ */ new Set,n=[];for(let r of e){let e=r.value.indexOf(`=`);if(e<=0){n.push(r);continue}let i=r.value.slice(0,e+1);t.has(i)||(t.add(i),n.push({...r,value:i}))}return n}function xe(e,t){let n=t.slice(0,t.indexOf(`=`)+1);return e.filter(e=>e.value!==n)}async function Se(e,t,n,r,i){let a=[],o=Z.FilterPrefix,s,c;switch(e.type){case`choices`:if(e.choices)for(let t of e.choices)a.push({value:t,description:r,type:`value`});o|=Z.NoFileCompletion;break;case`file`:e.matcher&&e.matcher.length>0?(c=e.matcher.filter(e=>e.trim().length>0),c.length===0&&(c=void 0,o|=Z.FileCompletion)):e.extensions&&e.extensions.length>0?(s=Array.from(new Set(e.extensions.map(e=>e.trim().replace(/^\./,``)).filter(e=>e.length>0))),s.length===0&&(s=void 0,o|=Z.FileCompletion)):o|=Z.FileCompletion;break;case`directory`:o|=Z.DirectoryCompletion;break;case`command`:e.shellCommand&&a.push(...ge(e.shellCommand)),o|=Z.NoFileCompletion;break;case`none`:o|=Z.NoFileCompletion;break;case`dynamic`:try{let n=await e.resolve(t);for(let e of n.candidates){let t=typeof e==`string`?{value:e}:e;a.push({...t,type:`value`})}o=n.directive??Z.FilterPrefix|Z.NoFileCompletion}catch{o=Z.NoFileCompletion|Z.Error}break;case`expand`:o|=Z.NoFileCompletion;break;case`runtime-expand`:{let r={},i=!1;for(let a of e.dependsOn){let e=t.parsedArgs[a],o=Array.isArray(e)?e[e.length-1]:e,s=ve(n,a);if(typeof o!=`string`||s===void 0||!s.includes(o)){i=!0;break}r[a]=o}if(!i)try{let t=/* @__PURE__ */ new Set;for(let n of e.enumerate(r)){let e=typeof n==`string`?{value:n}:n;t.has(e.value)||(t.add(e.value),a.push({...e,type:`value`}))}}catch{o=Z.NoFileCompletion|Z.Error;break}o|=Z.NoFileCompletion;break}}if(e.type===`dynamic`||e.type===`expand`||e.type===`runtime-expand`){let n=ye(e.type===`runtime-expand`&&i===!0?Ce(a,t.previousValues):a,t.currentWord);return n.hasEqSuffix&&(o|=Z.NoSpace),{candidates:n.candidates,directive:o,fileExtensions:s,fileMatchers:c}}return{candidates:a,directive:o,fileExtensions:s,fileMatchers:c}}function Ce(e,t){let n=/* @__PURE__ */ new Set;for(let e of t){let t=e.indexOf(`=`);t>0&&n.add(e.slice(0,t))}return n.size===0?[...e]:e.filter(e=>{let t=e.value.indexOf(`=`);return t<=0||!n.has(e.value.slice(0,t))})}function we(e){let t=[];for(let n of e.subcommands){let r=e.currentCommand.subCommands,i=r?.[n],a=i?void 0:s(e.currentCommand,n),c=i??(a?r?.[a]:void 0),l=c?o(c)?.description:void 0;t.push({value:n,description:l,type:`subcommand`})}if(t.length===0||e.currentWord.startsWith(`-`)){let n=Te(e);t.push(...n.candidates)}return{candidates:t,directive:Z.FilterPrefix|Z.NoFileCompletion}}function Te(e){let t=[],n=e.options.filter(t=>t.valueType===`array`||!(e.usedOptions.has(t.cliName)||t.alias&&t.alias.some(t=>e.usedOptions.has(t))||t.negation&&e.usedOptions.has(t.negation)));for(let e of n)t.push({value:`--${e.cliName}`,description:e.description,type:`option`}),e.negation&&t.push({value:`--${e.negation}`,description:e.negationDescription??e.description,type:`option`});return e.hasAnyOptionBeenUsed||t.push({value:`--help`,description:`Show help information`,type:`option`},{value:`--help-all`,description:`Show help with all subcommand options`,type:`option`},{value:`--help-json`,description:`Show help as JSON`,type:`option`}),{candidates:t,directive:Z.FilterPrefix|Z.NoFileCompletion}}function Ee(e,t,n){return{currentWord:e.currentWord,shell:t.shell,parsedArgs:De(e.parsedArgs,n),previousValues:e.previousValues,subcommandPath:e.subcommandPath}}function De(e,t){if(t===void 0||!(t in e))return e;let n={...e};return delete n[t],n}async function Q(e,t,n,r,i,a){return r?Se(r,Ee(e,t,n),e,i,a):{candidates:[],directive:Z.FilterPrefix}}function Oe(e,t){switch(t.shell){case`bash`:return ke(e,t);case`zsh`:return Ae(e,t);case`fish`:return je(e,t)}}function $(e,t){let n=`:${t.directive}`;t.fileExtensions&&t.fileExtensions.length>0&&(n+=`\t@ext:${t.fileExtensions.join(`,`)}`),t.fileMatchers&&t.fileMatchers.length>0&&(n+=`\t@matcher:${t.fileMatchers.join(`,`)}`),e.push(n)}function ke(e,t){let n=((e.directive&Z.FilterPrefix)!==0&&t.currentWord?e.candidates.filter(e=>e.value.startsWith(t.currentWord)):e.candidates).map(e=>t.inlinePrefix?`${t.inlinePrefix}${e.value}`:e.value);return $(n,e),n.join(`
1
+ import{n as e}from"./command-BXsTrIgI.js";import{c as t,i as n}from"./subcommand-router-40vA6Mka.js";import{a as r,n as i,u as a}from"./schema-extractor-BI5ypJ21.js";import{n as o,o as s,r as c,s as l,u}from"./argv-parser-CVXuhpy6.js";import{i as d,o as f}from"./registry-ZnSdmqJ1.js";import{t as p}from"./schema-Bz8oC0xQ.js";import{execSync as m}from"node:child_process";function h(e,t,n){return{fieldName:e.name,isArrayOption:e.valueType===`array`,isGlobal:e.isGlobal===!0,resolvedDeps:_(e.valueCompletion,e.isGlobal===!0,t,n)}}function g(e,t,n){return{fieldName:e.name,isArrayOption:!1,isGlobal:!1,resolvedDeps:_(e.valueCompletion,!1,t,n)}}function _(e,t,n,r=[]){if(e?.type!==`expand`)return[];let i=/* @__PURE__ */ new Set,a=/* @__PURE__ */ new Set;for(let e of n)e.isGlobal===!0?i.add(e.name):a.add(e.name);for(let e of r)a.add(e.name);return e.dependsOn.map(e=>({name:e,isGlobal:t||i.has(e)&&!a.has(e)}))}function v(e){let t=`$'`;for(let n of e){let e=n.codePointAt(0);t+=n===`\\`?`\\\\`:n===`'`?`\\'`:n===`
2
+ `?`\\n`:n===`\r`?`\\r`:n===` `?`\\t`:e<32||e===127?`\\x${e.toString(16).padStart(2,`0`)}`:n}return t+=`'`,t}function y(e){return`'${e.replace(/'/g,`'\\''`)}'`}function b(e,t){let n=t.withSize?`%Y:%s`:`%Y`,r=t.withSize?`%m:%z`:`%m`,i=`stat -L -c '${n}' "${e}" 2>/dev/null`,a=`stat -L -f '${r}' "${e}" 2>/dev/null`;return t.shell===`fish`?`(${i}; or ${a})`:`$(${i} || ${a})`}function x(e){return e.length===1?`-${e}`:`--${e}`}function S(e,t){C(e,x(t)),t.length===1?C(e,`--${t}`):t.includes(`-`)&&C(e,`--${f(t)}`)}function C(e,t){e.includes(t)||e.push(t)}function w(e,t){let n=[`--${e}`];e.length===1&&n.push(`-${e}`),e.includes(`-`)&&n.push(`--${f(e)}`);for(let e of t??[])S(n,e);return n}function T(e){let t=/* @__PURE__ */ new Set;for(let n of e)if(n.isGlobal===!0){n.cliName.length===1&&t.add(`-${n.cliName}`);for(let e of n.alias??[])e.length===1&&t.add(`-${e}`)}return t}function E(e,t,n,r){let i=new Set(w(e,t));if(n&&(i.add(`--${n}`),n.includes(`-`)&&i.add(`--${f(n)}`)),r?.frameOptions){if(r.isGlobal===!0){for(let e of r.frameOptions)if(e.isGlobal!==!0)for(let t of A(e.cliName,e.alias))i.delete(t)}else{let e=T(r.frameOptions);if(e.size>0){let n=new Set((t??[]).filter(e=>e.length===1).map(e=>`-${e}`));for(let t of e)n.has(t)||i.delete(t)}}}return[...i].map(e=>`"${e}"`)}function D(e,t){return e.map(e=>{let n=t.find(t=>t.isGlobal!==!0&&t.name===e.name);return n&&E(n.cliName,n.alias,n.negation,{frameOptions:t})})}function O(e,t,n,r=`$_pos_count`){let i=D(e,t);if(i.every(e=>e===void 0))return;let a=[` local _slot=-1 _left=${r}`];return e.forEach((e,t)=>{let r=i[t],o=r?` && __${n}_not_used ${r.join(` `)}`:``,s=e.variadic?`_slot=${e.position}`:`if (( _left == 0 )); then _slot=${e.position}; else (( _left-- )); fi`;a.push(` if (( _slot < 0 ))${o}; then ${s}; fi`)}),a}function k(e,t){let n=[`__${e}_track_positionals() {`,` local _k=0 _w`,' for _w in "${_pos_words[@]}"; do',` local _slot=$_k`,` case "$_subcmd" in`];for(let r of t){n.push(` ${r.pathStrs.map(e=>`"${e}"`).join(`|`)})`);for(let t of O(r.positionals,r.options,e,`$_k`)??[])n.push(` ${t}`);n.push(` ;;`)}return n.push(` esac`,` __${e}_track_pos "$_subcmd" "$_slot" "$_w"`,` (( _k++ ))`,` done`,`}`,``),n}function A(e,t){let n=[`--${e}`];e.includes(`-`)&&n.push(`--${f(e)}`);for(let e of t??[])S(n,e);return n}function j(e){let t=e.completion;if(t?.custom){let n=t.custom,r=[];if(n.expand&&r.push(`expand`),n.resolve&&r.push(`resolve`),n.choices&&n.choices.length>0&&r.push(`choices`),n.shellCommand&&r.push(`shellCommand`),r.length>1)throw Error(`Field "${e.name??`<unknown>`}": completion.custom may only specify one of choices, shellCommand, resolve, expand (got ${r.join(`, `)}).`);if(n.expand)return{type:`pending-expand`,spec:n.expand};if(n.resolve)return{type:`dynamic`,resolve:n.resolve};if(n.choices&&n.choices.length>0)return{type:`choices`,choices:n.choices};if(n.shellCommand)return{type:`command`,shellCommand:n.shellCommand}}if(t?.type){if(t.type===`file`)return t.matcher?{type:`file`,matcher:t.matcher}:t.extensions?{type:`file`,extensions:t.extensions}:{type:`file`};if(t.type===`directory`)return{type:`directory`};if(t.type===`none`)return{type:`none`}}if(e.enumValues&&e.enumValues.length>0)return{type:`choices`,choices:e.enumValues}}function M(e){if(e)return e.type===`pending-expand`?{type:`runtime-expand`,dependsOn:e.spec.dependsOn,enumerate:e.spec.enumerate}:e}function ee(e){return e.args?N(e.args):[]}function N(e){return r(i(e)).map(P)}function P(e){let t=d(e);return{name:e.name,cliName:e.cliName,alias:t.length>0?t:void 0,negation:e.negationDisplay,negationDescription:e.negationDescription,description:e.description,takesValue:e.type!==`boolean`,valueType:e.type,required:e.required,defaultNegationAccepted:e.type===`boolean`&&e.negation===!0,valueCompletion:M(j(e))}}function F(e){return new Set(w(e.cliName,e.alias))}function te(e,t){let n=F(t);for(let t of e)for(let e of F(t))if(n.has(e))return t}function ne(e,t,n){let r=/* @__PURE__ */ new Set;if(t.length===0)return r;let i=/* @__PURE__ */ new Set,a=(e,t)=>{G(n,e,t,i),r.add(e.name)},s=0;for(;s<e.length;){let i=e[s];if(i===`--`||!i.startsWith(`-`))break;if(c(i)){let{isGlobal:c,flags:l,valueOption:u}=z(i,t);if(!c)break;for(let{opt:e}of l)n[e.name]=!0,r.add(e.name);if(u?.value!==void 0)a(u.opt,u.value);else if(u){let t=e[s+1];if(t===void 0)break;o(t)&&(a(u.opt,t),s++)}s++;continue}if(!i.startsWith(`--`)&&i.length>2){let e=i.indexOf(`=`);if((e>=0?i.slice(1,e):i.slice(1)).length>1)break}let l=R(i),u=q(t,l);if(!u){if(de(t,l)){s++;continue}break}if(u.takesValue){if(B(i)){let e=i.indexOf(`=`);a(u,i.slice(e+1)),s++}else if(s+1<e.length){let t=e[s+1];if(!o(t)){s++;continue}a(u,t),s+=2}else break}else{let e=V(u,l,i);e!==void 0&&(n[u.name]=e),r.add(u.name),s++}}return r}function re(e,t){return t.valueType===`array`?Array.isArray(e)?e:[e]:Array.isArray(e)?e.at(-1):e}function ie(e,t){return t.length===0?e:[...e,...t]}function ae(e,t){let n=t.length-1;if(!(n<0))return e>n?n:e}function I(e,t){return n=>{let r={...e};return s(n,e).forEach((e,n)=>{n<t.length&&(r[e.name]=t[n])}),r}}function oe(e,t,n){if(!e.args)return;let r=i(e.args),o=a(r,I(t,n));if(o!==r)return o.fields.filter(e=>e.named).map(P)}function se(e,t,n){if(!e.args)return[];let r=a(i(e.args),I(t,n));return s(r,t).map((e,t)=>({name:e.name,cliName:e.cliName,position:t,description:e.description,required:e.required,variadic:e.type===`array`,valueCompletion:M(j(e))}))}function ce(e){if(!e.subCommands)return[];let n=[];for(let[r,i]of Object.entries(e.subCommands)){if(r.startsWith(`__`))continue;n.push(r);let e=t(i);e?.aliases&&n.push(...e.aliases)}return n}function le(e,r){if(!e.subCommands)return null;let i=Object.hasOwn(e.subCommands,r)?e.subCommands[r]:void 0;if(i)return t(i);let a=n(e,r);return a?t(e.subCommands[a]):null}function L(e){return e.startsWith(`-`)}function R(e){if(e.startsWith(`--`)){let t=e.slice(2),n=t.indexOf(`=`);return{name:n>=0?t.slice(0,n):t,isLong:!0}}return e.startsWith(`-`)?{name:e.slice(1,2),isLong:!1}:{name:e,isLong:!0}}function z(e,t){let n=(e,t)=>q(e,{name:t,isLong:!1}),r=t.filter(e=>e.isGlobal!==!0),i=t.filter(e=>e.isGlobal===!0),a=e=>!n(r,e)&&n(i,e)!==void 0,o=l(e.slice(1),e=>a(e)&&n(i,e).takesValue),s=o.flags.every(a),c=s?i:r,{flags:u,valueOption:d}=s?o:l(e.slice(1),e=>n(r,e)?.takesValue===!0);return{isGlobal:s,flags:u.flatMap(e=>{let t=n(c,e);return t?[{opt:t,name:e}]:[]}),valueOption:d&&{opt:n(c,d.name),value:d.value}}}function ue(e,t){let{valueOption:n}=z(e,t);return n?.value===void 0?n?.opt:void 0}function B(e){return e.includes(`=`)}function V(e,t,n){let r=fe(e,t);return B(n)?r?void 0:u(n.slice(n.indexOf(`=`)+1)):!r}function H(e,t,n){if(!n||e.valueType!==`boolean`)return!1;let r=[e.cliName,...e.alias??[]];for(let e of r){let n=`no-${e}`;if(t===n||t===f(n))return!0}return!1}function U(e,t,n){return e.defaultNegationAccepted===!0&&H(e,t,n)}function de(e,t){return e.some(e=>e.defaultNegationAccepted!==!0&&H(e,t.name,t.isLong))}function W(e,t){return e!==void 0&&e.includes(`-`)&&f(e)===t}function G(e,t,n,r){if(t.valueType!==`array`)e[t.name]=n;else if(r.has(t.name)){let r=e[t.name];e[t.name]=Array.isArray(r)?[...r,n]:[n]}else e[t.name]=[n],r.add(t.name)}function fe(e,t){return t.isLong?e.negation!==void 0&&(e.negation===t.name||W(e.negation,t.name))?!0:U(e,t.name,t.isLong):!1}function K(e,t,n){if(e.cliName===t&&(n||e.cliName.length===1))return!0;if(e.alias){for(let r of e.alias)if(r===t&&(n||r.length===1))return!0}return n&&e.negation===t?!0:!n||t.length<=1?!1:W(e.cliName,t)||e.alias?.some(e=>W(e,t))?!0:W(e.negation,t)}function q(e,t){if(!t.isLong){let n=e.find(e=>e.isGlobal!==!0&&e.alias?.includes(t.name)===!0);if(n)return n;let r=e.find(e=>e.isGlobal===!0&&K(e,t.name,t.isLong));if(r)return r}return e.find(e=>K(e,t.name,t.isLong))||e.find(e=>U(e,t.name,t.isLong))}function J(e,t,n){let r=Y(e,t,n);return r.variantOptions?Y(e,t,n,{command:r.context.currentCommand,options:r.variantOptions}).context:r.context}function Y(e,t,n,r){let i=e=>e===r?.command?r.options:ee(e),a=t,s=[],l=n?N(n).map(e=>({...e,isGlobal:!0})):[],u=/* @__PURE__ */ new Set,d=!1,f=0,p={},m=[],h={},g=/* @__PURE__ */ new Set,_=0,v=/* @__PURE__ */ new Set,y=e=>{u.add(e.cliName);for(let t of e.alias??[])u.add(t);e.negation&&u.add(e.negation),d=!0},b=(e,t)=>{G(e.isGlobal===!0?h:p,e,t,v)},x=(e,t,n=``)=>{let r=e.isGlobal===!0?h:p,i=V(e,t,n);i!==void 0&&(r[e.name]=i)},S=0,C=ie(i(a),l),w=!1;for(;S<e.length-1;){let t=e[S];if(!w&&t===`--`){w=!0,S++;continue}if(!w&&c(t)){d=!0;let{flags:n,valueOption:r}=z(t,C);for(let{opt:e,name:t}of n)y(e),x(e,{name:t,isLong:!1});r&&(y(r.opt),r.value===void 0?S+1<e.length-1&&o(e[S+1])&&(b(r.opt,e[S+1]),S++):b(r.opt,r.value)),S++;continue}if(!w&&L(t)){d=!0;let n=R(t),r=q(C,n);if(r){if(y(r),r.takesValue){if(B(t)){let e=t.indexOf(`=`);b(r,t.slice(e+1))}else if(S+1<e.length-1){let t=e[S+1];o(t)&&(b(r,t),S++)}}else x(r,n,t)}S++;continue}let n=w?null:le(a,t);if(n){s.push(t);let r=i(a),o=e.slice(_,S);for(let e of ne(o,l,h))g.add(e);a=n,C=ie(i(a),l);for(let e of Object.keys(p)){let t=r.find(t=>t.name===e),n=l.find(t=>t.name===e)??(t?te(l,t):void 0);n&&(g.has(n.name)||(h[n.name]=re(p[e],n)))}u.clear(),f=0,p={},m=[],v=/* @__PURE__ */ new Set,_=S+1,S++}else m.push(t),f++,S++}let T=e[e.length-1]??``,E=e[e.length-2]??``,D=oe(a,p,m),O=se(a,p,m),k=ce(a);for(let e=0;e<O.length;e++){let t=O[e];if(t.variadic){p[t.name]=m.slice(e);break}e<m.length&&(p[t.name]=m[e])}let A,j,M;if(!w&&E&&L(E)&&!B(E)){let e=c(E)?ue(E,C):q(C,R(E));e&&e.takesValue?(A=`option-value`,j=e):T.startsWith(`-`)?A=`option-name`:(A=X(T,k,O,f),A===`positional`&&(M=f))}else if(!w&&T.startsWith(`-`)&&B(T)){let e=q(C,R(T));e&&e.takesValue?(A=`option-value`,j=e):A=`option-name`}else!w&&T.startsWith(`-`)?A=`option-name`:(A=X(T,k,O,f,w),A===`positional`&&(M=f));let P=[];if(j){if(j.valueType===`array`){let e=(j.isGlobal===!0?h:p)[j.name];P=Array.isArray(e)?e.filter(e=>typeof e==`string`):[]}}else if(A===`positional`&&M!==void 0){let e=ae(M,O);e!==void 0&&O[e]?.variadic&&(P=m.slice(e))}let F={...h,...p};return{context:{subcommandPath:s,currentCommand:a,currentWord:T,previousWord:E,completionType:A,targetOption:j,positionalIndex:M,options:C,subcommands:k,positionals:O,usedOptions:u,hasAnyOptionBeenUsed:d,providedPositionalCount:f,parsedArgs:F,previousValues:P},variantOptions:D}}function X(e,t,n,r,i){return i?`positional`:t.length>0&&(t.filter(t=>t.startsWith(e)).length>0||e===``)?`subcommand`:r<n.length||n.length>0&&n[n.length-1].variadic?`positional`:`subcommand`}const Z={Default:0,NoSpace:1,NoFileCompletion:2,FilterPrefix:4,KeepOrder:8,FileCompletion:16,DirectoryCompletion:32,Error:64};function pe(e){if(!e.startsWith(`-`))return;let t=e.indexOf(`=`);if(!(t<=0))return e.slice(0,t+1)}async function me(e,t){switch(e.completionType){case`subcommand`:return we(e);case`option-name`:return Te(e);case`option-value`:{let n=e.targetOption,r=n?pe(e.currentWord):void 0;return Q(r?{...e,currentWord:e.currentWord.slice(r.length)}:e,t,n?.name,n?.valueCompletion,void 0,n?.valueType===`array`)}case`positional`:{let n=he(e);return n?Q(e,t,n.name,n.valueCompletion,n.description,!1):{candidates:[],directive:Z.NoFileCompletion}}}}function he(e){let t=e.positionalIndex??0,n=ae(t,e.positionals);if(n===void 0)return;let r=e.positionals[n];if(r)return n===t||r.variadic?r:void 0}function ge(e){try{return m(e,{encoding:`utf-8`,timeout:5e3}).split(`
3
+ `).map(e=>e.trim()).filter(e=>e.length>0).map(e=>({value:e,type:`value`}))}catch{return[]}}function _e(e){return e?.type===`choices`?e.choices:void 0}function ve(e,t){let n=e.options.find(e=>e.name===t&&e.isGlobal!==!0);if(n)return _e(n.valueCompletion);let r=e.positionals.find(e=>e.name===t);return _e(r?r.valueCompletion:e.options.find(e=>e.name===t&&e.isGlobal===!0)?.valueCompletion)}function ye(e,t){let n=!t.includes(`=`),r=n?be(e):xe(e,t);return{candidates:r,hasEqSuffix:n&&r.some(e=>e.value.endsWith(`=`))}}function be(e){let t=/* @__PURE__ */ new Set,n=[];for(let r of e){let e=r.value.indexOf(`=`);if(e<=0){n.push(r);continue}let i=r.value.slice(0,e+1);t.has(i)||(t.add(i),n.push({...r,value:i}))}return n}function xe(e,t){let n=t.slice(0,t.indexOf(`=`)+1);return e.filter(e=>e.value!==n)}async function Se(e,t,n,r,i){let a=[],o=Z.FilterPrefix,s,c;switch(e.type){case`choices`:if(e.choices)for(let t of e.choices)a.push({value:t,description:r,type:`value`});o|=Z.NoFileCompletion;break;case`file`:e.matcher&&e.matcher.length>0?(c=e.matcher.filter(e=>e.trim().length>0),c.length===0&&(c=void 0,o|=Z.FileCompletion)):e.extensions&&e.extensions.length>0?(s=Array.from(new Set(e.extensions.map(e=>e.trim().replace(/^\./,``)).filter(e=>e.length>0))),s.length===0&&(s=void 0,o|=Z.FileCompletion)):o|=Z.FileCompletion;break;case`directory`:o|=Z.DirectoryCompletion;break;case`command`:e.shellCommand&&a.push(...ge(e.shellCommand)),o|=Z.NoFileCompletion;break;case`none`:o|=Z.NoFileCompletion;break;case`dynamic`:try{let n=await e.resolve(t);for(let e of n.candidates){let t=typeof e==`string`?{value:e}:e;a.push({...t,type:`value`})}o=n.directive??Z.FilterPrefix|Z.NoFileCompletion}catch{o=Z.NoFileCompletion|Z.Error}break;case`expand`:o|=Z.NoFileCompletion;break;case`runtime-expand`:{let r={},i=!1;for(let a of e.dependsOn){let e=t.parsedArgs[a],o=Array.isArray(e)?e[e.length-1]:e,s=ve(n,a);if(typeof o!=`string`||s===void 0||!s.includes(o)){i=!0;break}r[a]=o}if(!i)try{let t=/* @__PURE__ */ new Set;for(let n of e.enumerate(r)){let e=typeof n==`string`?{value:n}:n;t.has(e.value)||(t.add(e.value),a.push({...e,type:`value`}))}}catch{o=Z.NoFileCompletion|Z.Error;break}o|=Z.NoFileCompletion;break}}if(e.type===`dynamic`||e.type===`expand`||e.type===`runtime-expand`){let n=ye(e.type===`runtime-expand`&&i===!0?Ce(a,t.previousValues):a,t.currentWord);return n.hasEqSuffix&&(o|=Z.NoSpace),{candidates:n.candidates,directive:o,fileExtensions:s,fileMatchers:c}}return{candidates:a,directive:o,fileExtensions:s,fileMatchers:c}}function Ce(e,t){let n=/* @__PURE__ */ new Set;for(let e of t){let t=e.indexOf(`=`);t>0&&n.add(e.slice(0,t))}return n.size===0?[...e]:e.filter(e=>{let t=e.value.indexOf(`=`);return t<=0||!n.has(e.value.slice(0,t))})}function we(e){let r=[];for(let i of e.subcommands){let a=e.currentCommand.subCommands,o=a?.[i],s=o?void 0:n(e.currentCommand,i),c=o??(s?a?.[s]:void 0),l=c?t(c)?.description:void 0;r.push({value:i,description:l,type:`subcommand`})}if(r.length===0||e.currentWord.startsWith(`-`)){let t=Te(e);r.push(...t.candidates)}return{candidates:r,directive:Z.FilterPrefix|Z.NoFileCompletion}}function Te(e){let t=[],n=e.options.filter(t=>t.valueType===`array`||!(e.usedOptions.has(t.cliName)||t.alias&&t.alias.some(t=>e.usedOptions.has(t))||t.negation&&e.usedOptions.has(t.negation)));for(let e of n)t.push({value:`--${e.cliName}`,description:e.description,type:`option`}),e.negation&&t.push({value:`--${e.negation}`,description:e.negationDescription??e.description,type:`option`});return e.hasAnyOptionBeenUsed||t.push({value:`--help`,description:`Show help information`,type:`option`},{value:`--help-all`,description:`Show help with all subcommand options`,type:`option`},{value:`--help-json`,description:`Show help as JSON`,type:`option`}),{candidates:t,directive:Z.FilterPrefix|Z.NoFileCompletion}}function Ee(e,t,n){return{currentWord:e.currentWord,shell:t.shell,parsedArgs:De(e.parsedArgs,n),previousValues:e.previousValues,subcommandPath:e.subcommandPath}}function De(e,t){if(t===void 0||!(t in e))return e;let n={...e};return delete n[t],n}async function Q(e,t,n,r,i,a){return r?Se(r,Ee(e,t,n),e,i,a):{candidates:[],directive:Z.FilterPrefix}}function Oe(e,t){switch(t.shell){case`bash`:return ke(e,t);case`zsh`:return Ae(e,t);case`fish`:return je(e,t)}}function $(e,t){let n=`:${t.directive}`;t.fileExtensions&&t.fileExtensions.length>0&&(n+=`\t@ext:${t.fileExtensions.join(`,`)}`),t.fileMatchers&&t.fileMatchers.length>0&&(n+=`\t@matcher:${t.fileMatchers.join(`,`)}`),e.push(n)}function ke(e,t){let n=((e.directive&Z.FilterPrefix)!==0&&t.currentWord?e.candidates.filter(e=>e.value.startsWith(t.currentWord)):e.candidates).map(e=>t.inlinePrefix?`${t.inlinePrefix}${e.value}`:e.value);return $(n,e),n.join(`
4
4
  `)}function Ae(e,t){let n=e.candidates.map(e=>{let t=e.value.replace(/:/g,`\\:`);return e.description?`${t}:${e.description.replace(/:/g,`\\:`)}`:t});return $(n,e),n.join(`
5
5
  `)}function je(e,t){let n=e.candidates.map(e=>e.description?`${e.value}\t${e.description}`:e.value);return $(n,e),n.join(`
6
- `)}function Me(e,t,n){return a({name:`__complete`,args:p,async run(t){let r=J(t.args,e,n),i=r.completionType===`option-value`&&r.targetOption?pe(r.currentWord):void 0,a=i?r.currentWord.slice(i.length):r.currentWord,o=Oe(await me(r,{shell:t.shell}),{shell:t.shell,currentWord:a,inlinePrefix:i});console.log(o)}})}function Ne(e){return!!e.subCommands?.__complete}export{E as _,me as a,v as c,A as d,D as f,k as g,O as h,Z as i,w as l,g as m,Ne as n,J as o,h as p,Oe as r,j as s,Me as t,T as u,y as v,b as y};
6
+ `)}function Me(t,n,r){return e({name:`__complete`,args:p,async run(e){let n=J(e.args,t,r),i=n.completionType===`option-value`&&n.targetOption?pe(n.currentWord):void 0,a=i?n.currentWord.slice(i.length):n.currentWord,o=Oe(await me(n,{shell:e.shell}),{shell:e.shell,currentWord:a,inlinePrefix:i});console.log(o)}})}function Ne(e){return!!e.subCommands?.__complete}export{E as _,me as a,v as c,A as d,D as f,k as g,O as h,Z as i,w as l,g as m,Ne as n,J as o,h as p,Oe as r,j as s,Me as t,T as u,y as v,b as y};
package/dist/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
- import { r as KnownAgentId, t as AgentInfo } from "./detect-agent-hU93hctO.js";
2
1
  import { $ as ExpandCandidate, A as SubCommandValue, B as toKebabCase, C as RunCommandOptions, D as RunResultSuccess, E as RunResultFailure, F as lazy, G as CustomCompletion, H as ArgMeta, I as ExtractedFields, J as PromptChoicesContext, K as EffectContext, L as ResolvedFieldMeta, M as UnknownSubcommandHandler, N as LazyCommand, O as RunnableCommand, P as isLazyCommand, Q as ValidateArgMeta, R as UnknownKeysMode, S as PromptResolverContext, T as RunResult, U as CompletionMeta, V as ArgFn, W as CompletionType, X as PromptMeta, Y as PromptChoicesResolver, Z as PromptType, _ as LogStream, a as ArgsSchema$1, at as DynamicCompletionResolver, b as NonRunnableCommand, c as Command, ct as loadPackage, d as GlobalArgs, et as ExpandCompletion, f as GlobalCleanupContext, g as LogLevel, h as LogEntry, i as ArgSource, it as DynamicCompletionContext, j as SubCommandsRecord, k as SetupContext, l as CommandBase, lt as InferSchemaOutput, m as IsEmpty, n as AgentHelpContext, nt as CompletionDirectiveMask, o as CleanupContext, ot as DynamicCompletionResult, p as GlobalSetupContext, q as PromptChoices, r as AnyCommand, rt as DynamicCompletionCandidate, s as CollectedLogs, st as PackageRequirement, t as AgentHelp, tt as ResolvedExpandCandidate, u as Example, ut as SchemaLike, v as Logger, w as RunInvocation, x as PromptResolver, y as MainOptions, z as toCamelCase } from "./types-D3ubanZt.js";
3
2
  import { _ as CompletionResult, g as CompletionOptions, i as GenerateBundledCompletionWorkerResult, n as withCompletionCommand, r as GenerateBundledCompletionWorkerOptions, t as WithCompletionOptions, x as InternalArgsSchema } from "./with-completion-command-BkTioGwX.js";
3
+ import { r as KnownAgentId, t as AgentInfo } from "./detect-agent-hU93hctO.js";
4
4
  import { Field, Schema, unflatten as unflatten$1 } from "loculus";
5
5
  /**
6
6
  * Detect the unknown-keys handling mode of an args schema. Works for any
@@ -339,6 +339,37 @@ interface NonRunnableConfig<TArgsSchema extends ArgsSchema$1 | undefined, TGloba
339
339
  */
340
340
  defaultSubCommand?: DefaultSubCommandKey<TSubCommands> | undefined;
341
341
  }
342
+ interface EnvFileRequest {
343
+ path: string;
344
+ ifExists: boolean;
345
+ }
346
+ export declare class EnvFileNotFoundError extends Error {
347
+ constructor(envPath: string);
348
+ }
349
+ interface LoadEnvFilesFromArgsOptions {
350
+ /** Command-line arguments to read. Defaults to `process.argv.slice(2)`. */
351
+ argv?: readonly string[];
352
+ }
353
+ /**
354
+ * Load env files into `process.env` with the semantics of Node.js
355
+ * `--env-file`: a later file overrides an earlier one, and a variable that was
356
+ * already set before the first file was read is left alone.
357
+ *
358
+ * Pass the requests to load, or the `globalArgs` schema to load the files its
359
+ * `envFile` options name on the command line. The second form reads every
360
+ * `envFile` option wherever it sits in `argv`, so a CLI can load the files
361
+ * before it hands the arguments to a plugin that politty does not parse. Files
362
+ * load in option declaration order, then in the order given on the command
363
+ * line. Nothing after `--` is read, and no file is read when help or the
364
+ * version is requested. A bundle of short flags counts only when every option
365
+ * in it is defined in `globalArgs`, so `-fe file` is skipped when `-f` is a
366
+ * plugin's own flag.
367
+ *
368
+ * A missing required file throws {@link EnvFileNotFoundError} and applies no
369
+ * file.
370
+ */
371
+ export declare function loadEnvFiles(requests: readonly EnvFileRequest[]): void;
372
+ export declare function loadEnvFiles(globalArgs: ArgsSchema$1, options?: LoadEnvFilesFromArgsOptions): void;
342
373
  /**
343
374
  * Run a command with the given arguments (programmatic/test usage)
344
375
  *
@@ -1072,4 +1103,4 @@ export declare const arg: ArgFn<Field<any, any, boolean> & {
1072
1103
  * why an `unflatten` imported from `loculus` itself is not enough.
1073
1104
  */
1074
1105
  export declare const unflatten: typeof unflatten$1;
1075
- export { type AgentHelp, type AgentHelpContext, type AgentInfo, type AnyCommand, type ArgFn, type ArgMeta, type ArgSource, type BoundDefineCommandFn, type BuiltinOptionDescriptions, type CamelCase, type CleanupContext, type CollectedLogs, type Command, type CommandBase, type CommandContext, type CommandValidationError, type CommandValidationResult, type CompletionDirectiveMask, type CompletionMeta, type CompletionOptions, type CompletionResult, type CompletionType, type CreateDefineCommandFn, type CustomCompletion, type DefineCommandFn, type DynamicCompletionCandidate, type DynamicCompletionContext, type DynamicCompletionResolver, type DynamicCompletionResult, type EffectContext, type Example, type ExpandCandidate, type ExpandCompletion, type ExtractedFields, type GenerateBundledCompletionWorkerOptions, type GenerateBundledCompletionWorkerResult, type GenerateCompileCacheShimOptions, type GenerateCompileCacheShimResult, type GlobalArgs, type GlobalCleanupContext, type GlobalSetupContext, type HelpData, type HelpDataOptions, type HelpFieldData, type HelpOptions, type HelpSubcommandData, type HelpUsageData, type HelpVariantData, type InferSchemaOutput, type KebabCase, type KnownAgentId, type LazyCommand, type LogEntry, type LogLevel, type LogStream, type Logger, type MainOptions, type MergedArgs, type NonRunnableCommand, type PackageRequirement, type ParsedArgv, type ParserOptions, type PromptChoices, type PromptChoicesContext, type PromptChoicesResolver, type PromptMeta, type PromptResolver, type PromptResolverContext, type PromptType, type ResolvedExpandCandidate, type ResolvedFieldMeta, type RunCommandOptions, type RunInvocation, type RunResult, type RunResultFailure, type RunResultSuccess, type RunnableCommand, type SchemaLike, type SetupContext, type SubCommandValue, type SubCommandsRecord, type UnknownKeysMode, type UnknownSubcommandHandler, type ValidateArgMeta, type ValidationError, type ValidationResult, type WithCaseVariants, type WithCompletionOptions, isLazyCommand, lazy, loadPackage, toCamelCase, toKebabCase, withCompletionCommand };
1106
+ export { type AgentHelp, type AgentHelpContext, type AgentInfo, type AnyCommand, type ArgFn, type ArgMeta, type ArgSource, type BoundDefineCommandFn, type BuiltinOptionDescriptions, type CamelCase, type CleanupContext, type CollectedLogs, type Command, type CommandBase, type CommandContext, type CommandValidationError, type CommandValidationResult, type CompletionDirectiveMask, type CompletionMeta, type CompletionOptions, type CompletionResult, type CompletionType, type CreateDefineCommandFn, type CustomCompletion, type DefineCommandFn, type DynamicCompletionCandidate, type DynamicCompletionContext, type DynamicCompletionResolver, type DynamicCompletionResult, type EffectContext, type EnvFileRequest, type Example, type ExpandCandidate, type ExpandCompletion, type ExtractedFields, type GenerateBundledCompletionWorkerOptions, type GenerateBundledCompletionWorkerResult, type GenerateCompileCacheShimOptions, type GenerateCompileCacheShimResult, type GlobalArgs, type GlobalCleanupContext, type GlobalSetupContext, type HelpData, type HelpDataOptions, type HelpFieldData, type HelpOptions, type HelpSubcommandData, type HelpUsageData, type HelpVariantData, type InferSchemaOutput, type KebabCase, type KnownAgentId, type LazyCommand, type LoadEnvFilesFromArgsOptions, type LogEntry, type LogLevel, type LogStream, type Logger, type MainOptions, type MergedArgs, type NonRunnableCommand, type PackageRequirement, type ParsedArgv, type ParserOptions, type PromptChoices, type PromptChoicesContext, type PromptChoicesResolver, type PromptMeta, type PromptResolver, type PromptResolverContext, type PromptType, type ResolvedExpandCandidate, type ResolvedFieldMeta, type RunCommandOptions, type RunInvocation, type RunResult, type RunResultFailure, type RunResultSuccess, type RunnableCommand, type SchemaLike, type SetupContext, type SubCommandValue, type SubCommandsRecord, type UnknownKeysMode, type UnknownSubcommandHandler, type ValidateArgMeta, type ValidationError, type ValidationResult, type WithCaseVariants, type WithCompletionOptions, isLazyCommand, lazy, loadPackage, toCamelCase, toKebabCase, withCompletionCommand };
package/dist/index.js CHANGED
@@ -1 +1 @@
1
- import{d as e,i as t,m as n,n as r}from"./schema-extractor-BI5ypJ21.js";import{o as i,s as a}from"./registry-ZnSdmqJ1.js";import{n as o,t as s}from"./cli-main-CdXCj3sh.js";import{n as c,t as l}from"./command-BXsTrIgI.js";import{d as u,o as d,s as f}from"./subcommand-router-40vA6Mka.js";import{C as p,D as m,E as h,O as g,S as _,T as v,_ as y,a as b,b as x,c as S,d as C,f as w,g as T,h as E,i as D,l as ee,m as O,n as k,o as A,p as j,r as M,s as N,t as P,u as F,v as I,w as L,x as R,y as z}from"./runner-BbIyh52c.js";import{a as B,i as V,n as H,r as U,t as W}from"./logger-CoeDrmRr.js";import{a as G}from"./argv-parser-CVXuhpy6.js";import{t as K}from"./with-completion-command-DOtEG943.js";import{t as q}from"./register-D-aEK58y.js";import{unflatten as J}from"loculus";const Y=o(`@politty/loculus`),X=c,Z=l,Q=q,$=((t,r)=>(t.meta.shape&&e(Object.keys(t.meta.shape),r),n(J(t,r),r??{})));export{T as CaseVariantCollisionError,y as DefaultSubCommandError,I as DuplicateAliasError,z as DuplicateFieldError,x as DuplicateNegationError,R as FieldTypeConflictError,_ as PositionalConfigError,p as ReservedAliasError,L as ReservedFieldNameError,Q as arg,o as createCompileCacheShimGenerator,Z as createDefineCommand,M as createDualCaseProxy,X as defineCommand,r as extractFields,b as formatCommandValidationErrors,D as formatValidationErrors,Y as generateCompileCacheShim,v as generateHelp,h as generateHelpData,t as getUnknownKeysMode,W as isColorEnabled,d as isLazyCommand,f as lazy,u as loadPackage,H as logger,G as parseArgv,m as renderInline,g as renderMarkdown,P as runCommand,k as runMain,s as runPolittyCli,U as setColorEnabled,V as styles,B as symbols,i as toCamelCase,a as toKebabCase,$ as unflatten,A as validateCaseVariantCollisions,N as validateCommand,S as validateCrossSchemaCollisions,ee as validateDefaultSubCommand,F as validateDuplicateAliases,C as validateDuplicateFields,w as validateDuplicateNegations,j as validatePositionalConfig,O as validateReservedAliases,E as validateReservedFieldNames,K as withCompletionCommand};
1
+ import{n as e,t}from"./cli-main-Bs2qeKG_.js";import{o as n,s as r}from"./registry-ZnSdmqJ1.js";import{t as i}from"./with-completion-command-BH--VXVo.js";import{n as a,t as o}from"./command-BXsTrIgI.js";import{d as s,o as c,s as l}from"./subcommand-router-40vA6Mka.js";import{A as u,C as d,D as f,E as p,O as m,S as h,T as g,_,a as v,b as y,c as b,d as x,f as S,g as C,h as w,i as T,k as E,l as D,m as O,n as k,o as A,p as j,r as M,s as N,t as P,u as F,v as I,w as L,x as R,y as z}from"./runner-BJCgs-_W.js";import{a as B,i as V,n as H,r as U,t as W}from"./logger-CoeDrmRr.js";import{a as G}from"./argv-parser-CVXuhpy6.js";import{d as K,i as q,m as J,n as Y}from"./schema-extractor-BI5ypJ21.js";import{t as X}from"./register-D-aEK58y.js";import{unflatten as Z}from"loculus";const Q=e(`@politty/loculus`),$=a,ee=o,te=X,ne=((e,t)=>(e.meta.shape&&K(Object.keys(e.meta.shape),t),J(Z(e,t),t??{})));export{I as CaseVariantCollisionError,z as DefaultSubCommandError,y as DuplicateAliasError,R as DuplicateFieldError,h as DuplicateNegationError,M as EnvFileNotFoundError,d as FieldTypeConflictError,L as PositionalConfigError,g as ReservedAliasError,p as ReservedFieldNameError,te as arg,e as createCompileCacheShimGenerator,ee as createDefineCommand,v as createDualCaseProxy,$ as defineCommand,Y as extractFields,N as formatCommandValidationErrors,A as formatValidationErrors,Q as generateCompileCacheShim,f as generateHelp,m as generateHelpData,q as getUnknownKeysMode,W as isColorEnabled,c as isLazyCommand,l as lazy,T as loadEnvFiles,s as loadPackage,H as logger,G as parseArgv,E as renderInline,u as renderMarkdown,P as runCommand,k as runMain,t as runPolittyCli,U as setColorEnabled,V as styles,B as symbols,n as toCamelCase,r as toKebabCase,ne as unflatten,b as validateCaseVariantCollisions,D as validateCommand,F as validateCrossSchemaCollisions,x as validateDefaultSubCommand,S as validateDuplicateAliases,j as validateDuplicateFields,O as validateDuplicateNegations,w as validatePositionalConfig,C as validateReservedAliases,_ as validateReservedFieldNames,i as withCompletionCommand};
@@ -0,0 +1,33 @@
1
+ import{_ as e,a as t,c as n,f as r,l as i,n as a,o,p as s,r as c,s as l,t as u,u as d,v as f}from"./schema-extractor-BI5ypJ21.js";import{t as p}from"./detect-agent-D7KSeWMh.js";import{n as m}from"./compile-cache-6u9hgeWu.js";import{a as h,c as g,f as _,i as v,l as y,n as b,o as ee,r as x,t as S,u as C}from"./subcommand-router-40vA6Mka.js";import{n as w,r as T,t as E}from"./log-collector-uhRWYT-z.js";import{a as D,i as O}from"./logger-CoeDrmRr.js";import{i as k,o as A,r as j,s as M,t as te}from"./registry-ZnSdmqJ1.js";import{a as N,c as ne,d as re,i as P,l as ie,n as F,o as I,r as ae,s as L,t as R}from"./argv-parser-CVXuhpy6.js";import*as z from"node:fs";import*as oe from"node:path";import{isDeepStrictEqual as se,parseEnv as ce,stripVTControlCharacters as le}from"node:util";async function ue(e,t,n={}){let i,a,o=n.captureLogs??!1?E():null;o?.start();let s={args:t},c={args:t,error:i},l;n.handleSignals&&(l=async t=>{l&&(process.off(`SIGINT`,l),process.off(`SIGTERM`,l));let r=/* @__PURE__ */ Error(`Process interrupted`);if(c.error=r,e.cleanup)try{await e.cleanup(c)}catch(e){console.error(`Error during signal cleanup:`,e)}if(n.globalCleanup)try{await n.globalCleanup({error:r})}catch(e){console.error(`Error during global signal cleanup:`,e)}o?.stop(),process.stdout.writableNeedDrain&&await new Promise(e=>{let t=setTimeout(()=>{process.stdout.off(`drain`,n),e()},200),n=()=>{clearTimeout(t),e()};process.stdout.once(`drain`,n)}),process.exit(1)},process.on(`SIGINT`,l),process.on(`SIGTERM`,l));try{e.requiredPackages?.length&&await _(e.requiredPackages,t);let i=typeof t==`object`&&t?t:{};for(let e of n.packageFields??[])e.requiredPackages?.length&&(e.nested?r(i,e)!==void 0:e.name in i)&&(n.packageDiscriminators?.includes(e.name)||r(i,e)===!0)&&await _(e.requiredPackages,t);e.setup&&await e.setup(s),e.run&&(a=await e.run(t))}catch(e){i=e instanceof Error?e:Error(String(e))}finally{l&&(process.off(`SIGINT`,l),process.off(`SIGTERM`,l))}if(e.cleanup){c.error=i;try{await e.cleanup(c)}catch(e){i||=e instanceof Error?e:Error(String(e))}}o?.stop();let u=n.existingLogs??w(),d=o?.getLogs()??w(),f=T(u,d);return i?{success:!1,error:i,exitCode:1,logs:f}:{success:!0,result:a,exitCode:0,logs:f}}function de(e){return e<=31||e>=127&&e<=159||e>=768&&e<=879||e>=6832&&e<=6911||e>=7616&&e<=7679||e>=8400&&e<=8447||e>=65056&&e<=65071||e===8203||e>=8204&&e<=8207||e===65279||e>=65024&&e<=65039||e>=917760&&e<=917999}function fe(e){return e>=4352&&e<=4447||e>=11904&&e<=12350||e>=12353&&e<=13311||e>=13312&&e<=19903||e>=19968&&e<=40959||e>=40960&&e<=42191||e>=43360&&e<=43391||e>=44032&&e<=55203||e>=63744&&e<=64255||e>=65040&&e<=65049||e>=65072&&e<=65135||e>=65280&&e<=65376||e>=65504&&e<=65510||e>=110592&&e<=110959||e>=127488&&e<=127569||e>=131072&&e<=262141||e>=9728&&e<=10175||e>=126976&&e<=129791}function pe(e){let t=!1,n=!1,r=!1;for(let i of e){let e=i.codePointAt(0);e===65039?r=!0:de(e)||(t=!0,fe(e)&&(n=!0))}return t?n||r?2:1:0}const me=(()=>{try{return new Intl.Segmenter(`en`,{granularity:`grapheme`})}catch{return}})();function he(e){if(e.length===0)return 0;let t=e.includes(`\x1B`)||e.includes(`›`)?le(e):e,n=0;if(me)for(let{segment:e}of me.segment(t))n+=pe(e);else for(let e of t)n+=pe(e);return n}function B(e){let t=[],n=e.replace(/`([^`]+)`/g,(e,n)=>{let r=t.length;return t.push(O.cyan(n)),`\x00CODE${r}\x00`});return n=n.replace(/\*\*(.+?)\*\*/g,(e,t)=>O.bold(t)),n=n.replace(/__(.+?)__/g,(e,t)=>O.bold(t)),n=n.replace(/\*(.+?)\*/g,(e,t)=>O.italic(t)),n=n.replace(/(?<!\w)_(.+?)_(?!\w)/g,(e,t)=>O.italic(t)),n=n.replace(/\[([^\]]+)\]\(([^)]+)\)/g,(e,t,n)=>`${O.underline(t)} ${O.dim(`(${n})`)}`),n=n.replace(/\x00CODE(\d+)\x00/g,(e,n)=>t[Number(n)]),n}function ge(e){return Ee(e.split(`
2
+ `)).map(je).join(`
3
+
4
+ `)}const _e=/^(#{1,6})\s+(.+)$/,ve=/^(?:---+|\*\*\*+|___+)\s*$/,ye=/^>\s?(.*)$/,be=/^-\s+(.+)$/,xe=/^(\d+)[.)]\s+(.+)$/,Se=/^(`{3,}|~{3,})(\S*)\s*$/,Ce=/^\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\]\s*$/,we=/^\|(.+)\|$/,Te=/^\|(\s*:?-+:?\s*\|)+$/;function Ee(e){let t=[],n=0;for(;n<e.length;){let r=e[n];if(r.trim()===``){n++;continue}let i=r.match(Se);if(i){let r=i[1],a=i[2]??``,o=[];for(n++;n<e.length;){if(e[n].startsWith(r.charAt(0).repeat(r.length))&&e[n].trim()===r.charAt(0).repeat(Math.max(r.length,e[n].trim().length))){n++;break}o.push(e[n]),n++}t.push({type:`code`,lang:a,lines:o});continue}let a=r.match(_e);if(a){t.push({type:`heading`,level:a[1].length,content:a[2]}),n++;continue}if(ve.test(r)){t.push({type:`hr`}),n++;continue}if(ye.test(r)){let r=[];for(;n<e.length;){let t=e[n].match(ye);if(t)r.push(t[1]),n++;else break}if(r.length>0){let e=r[0].match(Ce);if(e){let n=r.slice(1).filter(e=>e!==``);t.push({type:`alert`,alertType:e[1],lines:n});continue}}t.push({type:`blockquote`,lines:r});continue}if(be.test(r)){let r=[];for(;n<e.length;){let t=e[n].match(be);if(t)r.push(t[1]),n++;else break}t.push({type:`ul`,items:r});continue}let o=r.match(xe);if(o){let r=Number(o[1]),i=[];for(;n<e.length;){let t=e[n].match(xe);if(t)i.push(t[2]),n++;else break}t.push({type:`ol`,items:i,start:r});continue}if(we.test(r)&&n+1<e.length&&Te.test(e[n+1])){let i=De(r),a=Oe(e[n+1]);n+=2;let o=[];for(;n<e.length&&we.test(e[n]);)o.push(De(e[n])),n++;t.push({type:`table`,headers:i,alignments:a,rows:o});continue}let s=[];for(;n<e.length;){let t=e[n];if(t.trim()===``||_e.test(t)||ve.test(t)||ye.test(t)||be.test(t)||xe.test(t)||Se.test(t)||we.test(t)&&n+1<e.length&&Te.test(e[n+1]))break;s.push(t),n++}s.length>0&&t.push({type:`paragraph`,lines:s})}return t}function De(e){return e.slice(1,-1).split(`|`).map(e=>e.trim())}function Oe(e){return e.slice(1,-1).split(`|`).map(e=>{let t=e.trim();return t.startsWith(`:`)&&t.endsWith(`:`)?`center`:t.endsWith(`:`)?`right`:`left`})}function ke(e,t,n){let r=he(e),i=Math.max(0,t-r);if(n===`right`)return` `.repeat(i)+e;if(n===`center`){let t=Math.floor(i/2);return` `.repeat(t)+e+` `.repeat(i-t)}return e+` `.repeat(i)}const Ae={NOTE:{icon:`ℹ`,label:`Note`,styleFn:O.cyan},TIP:{icon:`💡`,label:`Tip`,styleFn:O.green},IMPORTANT:{icon:`❗`,label:`Important`,styleFn:O.magenta},WARNING:{icon:`⚠`,label:`Warning`,styleFn:O.yellow},CAUTION:{icon:`🔴`,label:`Caution`,styleFn:O.red}};function je(e){switch(e.type){case`heading`:return O.green(O.bold(B(e.content)));case`hr`:return O.dim(`─`.repeat(40));case`blockquote`:{let t=O.dim(`│ `);return e.lines.map(e=>`${t}${B(e)}`).join(`
5
+ `)}case`alert`:{let{icon:t,label:n,styleFn:r}=Ae[e.alertType],i=r(O.bold(`│`))+` `,a=`${i}${r(t)} ${r(n)}`;return e.lines.length===0?a:`${a}\n${e.lines.map(e=>`${i}${B(e)}`).join(`
6
+ `)}`}case`ul`:return e.items.map(e=>`${O.dim(`•`)} ${B(e)}`).join(`
7
+ `);case`ol`:{let t=e.start+e.items.length-1,n=String(t).length;return e.items.map((t,r)=>{let i=String(e.start+r).padStart(n,` `);return`${O.dim(`${i}.`)} ${B(t)}`}).join(`
8
+ `)}case`table`:{let t=e.headers.length,n=e.headers.map(e=>B(e)),r=e.rows.map(e=>Array.from({length:t},(t,n)=>B(e[n]??``))),i=n.map((e,t)=>{let n=he(e),i=r.map(e=>he(e[t]));return Math.max(n,...i)}),a=O.dim(`│`),o=O.dim(`┌─${i.map(e=>`─`.repeat(e)).join(`─┬─`)}─┐`),s=O.dim(`├─${i.map(e=>`─`.repeat(e)).join(`─┼─`)}─┤`),c=O.dim(`└─${i.map(e=>`─`.repeat(e)).join(`─┴─`)}─┘`);return[o,`${a} ${n.map((t,n)=>O.bold(ke(t,i[n],e.alignments[n]??`left`))).join(` ${a} `)} ${a}`,s,...r.map(t=>{let n=t.map((t,n)=>ke(t,i[n],e.alignments[n]??`left`));return`${a} ${n.join(` ${a} `)} ${a}`}),c].join(`
9
+ `)}case`code`:return e.lines.map(e=>` ${O.yellow(e)}`).join(`
10
+ `);case`paragraph`:return B(e.lines.join(` `))}}const V={help:`Show help`,helpAll:`Show help with all subcommand options`,helpJson:`Show help as JSON`,version:`Show version`};function Me(e){return!e.startsWith(`__`)}function H(e){return Object.entries(e).filter(([e])=>Me(e))}function Ne(e,t){return t?.rootName&&t.commandPath&&t.commandPath.length>0?t.commandPath.join(` `):e.name??`command`}function Pe(e,t){return t?.rootName&&t.commandPath&&t.commandPath.length>0?`${t.rootName} ${t.commandPath.join(` `)}`:e.name??`command`}function Fe(e,t){let r=[],i=Pe(e,t);r.push(O.commandName(i)),t?.globalExtracted?.fields.length&&r.push(O.placeholder(`[global options]`));let a=c(e);if(a){let t=n(a);l(a).length>0&&r.push(O.placeholder(`[options]`)),e.subCommands&&H(e.subCommands).length>0&&(e.run||e.defaultSubCommand?r.push(O.placeholder(`[command]`)):r.push(O.option(`<command>`)));for(let e of t)e.required?r.push(O.option(`<${e.name}>`)):r.push(O.placeholder(`[${e.name}]`))}else e.subCommands&&H(e.subCommands).length>0&&(e.run||e.defaultSubCommand?r.push(O.placeholder(`[command]`)):r.push(O.option(`<command>`)));return r.join(` `)}function Ie(e,t){let n=`${O.dim(`When`)} ${O.option(e)}=${O.bold(t.discriminatorValue)}:`;return t.description?`${n} ${t.description}`:n}function Le(e,t){return` ${O.bold(`${e.description??`Variant ${t+1}`}:`)}`}function Re(e,t=0){let n=e.required?O.option(`<${e.name}>`):O.placeholder(`[${e.name}]`),r=e.named?`${n}, ${W(e)}`:n,i=[q(e),e.defaultValue===void 0?void 0:O.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)].filter(Boolean).join(` `);return i?K(r,i,t):`${` `.repeat(t)} ${r}`}function ze(e){let t=c(e);if(!t)return``;let n=[];if(t.schemaType===`discriminatedUnion`&&t.discriminator){let e=t.discriminator;n=(t.variants??[]).map(t=>({label:Ie(e,t),fields:t.fields}))}else(t.schemaType===`union`||t.schemaType===`xor`)&&t.unionOptions&&(n=t.unionOptions.map((e,t)=>({label:Le(e,t),fields:e.fields})));let r=n.length>0?u(n):void 0,i=t.fields.filter(e=>e.positional&&(r===void 0||r.has(e.name))).map(e=>Re(e));for(let e of n){let t=e.fields.filter(e=>e.positional&&!r?.has(e.name));t.length!==0&&i.push(``,e.label,...t.map(e=>Re(e,1)))}return i.join(`
11
+ `)}function Be(e,t={},n){let r=[],i={help:t.help??V.help,helpAll:t.helpAll??V.helpAll,helpJson:t.helpJson??V.helpJson,version:t.version??V.version},a=c(e),o=a?.fields.some(e=>e.overrideBuiltinAlias===!0&&k(e).includes(`h`))??!1,s=a?.fields.some(e=>e.overrideBuiltinAlias===!0&&k(e).includes(`H`))??!1;if(o?r.push(K(O.option(`--help`),i.help)):r.push(K(`${O.option(`-h`)}, ${O.option(`--help`)}`,i.help)),s?r.push(K(O.option(`--help-all`),i.helpAll)):r.push(K(`${O.option(`-H`)}, ${O.option(`--help-all`)}`,i.helpAll)),r.push(K(O.option(`--help-json`),i.helpJson)),n?.rootVersion&&r.push(K(O.option(`--version`),i.version)),!a)return r.join(`
12
+ `);if(a.schemaType===`discriminatedUnion`&&a.discriminator)return Ve(a,e,r);if(a.schemaType===`union`&&a.unionOptions||a.schemaType===`xor`&&a.unionOptions)return He(a,e,r);let l=[],u=a.fields.filter(e=>!e.positional);for(let e of u){let t=W(e),n=q(e);e.defaultValue!==void 0&&(n+=` ${O.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${O.required(`(required)`)}`);let r=G(e.env);r&&(n+=` ${r}`),l.push(K(t,n));let i=U(e);i&&l.push(i)}return l.push(...r),l.join(`
13
+ `)}function U(e,t=0,n=0){return!e.negationDisplay||!e.negationDescription?null:K(O.option(`--${e.negationDisplay}`),`${e.negationDescription} ${O.dim(`(↔ --${e.cliName})`)}`,t,n)}function Ve(e,t,n){let r=[],i=e.discriminator,a=e.variants??[],s=o(e,i);if(s){let t=a.map(e=>e.discriminatorValue).join(`|`),n=`${O.option(`--${i}`)} ${O.placeholder(`<${t}>`)}`,o=e.description??s.description??`Action to perform`;r.push(K(n,o))}let c=u(a,i);for(let t of c){let n=e.fields.find(e=>e.name===t);if(n&&!n.positional){let e=W(n),t=q(n);n.defaultValue!==void 0&&(t+=` ${O.defaultValue(`(default: ${JSON.stringify(n.defaultValue)})`)}`);let i=G(n.env);i&&(t+=` ${i}`),r.push(K(e,t));let a=U(n);a&&r.push(a)}}r.push(...n);for(let e of a){let t=e.fields.filter(e=>e.name!==i&&!c.has(e.name)&&!e.positional),n=y(e.fields.find(e=>e.name===i)?.requiredPackages);if(t.length>0||n){r.push(``),r.push(Ie(i,e)),n&&r.push(Ge(n,2));for(let e of t){let t=W(e),n=q(e);e.defaultValue!==void 0&&(n+=` ${O.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${O.required(`(required)`)}`);let i=G(e.env);i&&(n+=` ${i}`),r.push(K(t,n,1));let a=U(e,1);a&&r.push(a)}}}return r.join(`
14
+ `)}function He(e,t,n){let r=[],i=e.unionOptions??[],a=u(i);for(let t of a){let n=e.fields.find(e=>e.name===t);if(n&&!n.positional){let e=W(n),t=q(n);n.defaultValue!==void 0&&(t+=` ${O.defaultValue(`(default: ${JSON.stringify(n.defaultValue)})`)}`);let i=G(n.env);i&&(t+=` ${i}`),r.push(K(e,t));let a=U(n);a&&r.push(a)}}r.push(...n);for(let e=0;e<i.length;e++){let t=i[e];if(!t)continue;let n=t.fields.filter(e=>!a.has(e.name)&&!e.positional),o=Le(t,e);if(n.length>0){r.push(``),r.push(o);for(let e of n){let t=W(e),n=q(e);e.defaultValue!==void 0&&(n+=` ${O.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${O.required(`(required)`)}`);let i=G(e.env);i&&(n+=` ${i}`),r.push(K(t,n,1));let a=U(e,1);a&&r.push(a)}}else r.push(``),r.push(o),r.push(` ${O.dim(O.italic(`no options`))}`)}return r.join(`
15
+ `)}function W(e){let t=[];if(e.alias)for(let n of e.alias)n.length===1&&t.push(O.option(`-${n}`));let n=O.option(`--${e.cliName}`);if(e.type!==`boolean`){let t=e.placeholder??e.cliName.toUpperCase();n+=` ${O.placeholder(`<${t}>`)}`}if(t.push(n),e.alias){for(let n of e.alias)if(n.length>1){let r=O.option(`--${n}`);if(e.type!==`boolean`){let t=e.placeholder??e.cliName.toUpperCase();r+=` ${O.placeholder(`<${t}>`)}`}t.push(r)}}let r=t.join(`, `);return e.type===`boolean`&&e.negationDisplay&&!e.negationDescription?`${r} / ${O.option(`--${e.negationDisplay}`)}`:r}function G(e){if(!e)return``;let t=Array.isArray(e)?e:[e];return O.dim(`[env: ${t.join(`, `)}]`)}function Ue(e){return e.replace(/\x1B\[[0-9;]*m/g,``)}function We(e,t){let n=Ue(e).length,r=Math.max(0,t-n);return e+` `.repeat(r)}function Ge(e,t){if(!e.includes(`
16
+ `))return e;let n=` `.repeat(t);return e.split(`
17
+ `).join(`\n${n}`)}function K(e,t,n=0,r=0){let i=` `.repeat(n),a=Ue(e).length,o=32-n*2+r,s=o+2+n*2,c=Ge(t,s);return a>=o?`${i} ${e}\n${` `.repeat(s)}${c}`:`${i} ${We(e,o)}${c}`}function Ke(e,t=0,n=0){let r=W(e),i=q(e);e.defaultValue!==void 0&&(i+=` ${O.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(i+=` ${O.required(`(required)`)}`);let a=G(e.env);return a&&(i+=` ${a}`),K(r,i,t,n)}function qe(e){let t=[];for(let n of e.fields){if(n.positional)continue;t.push(Ke(n));let e=U(n);e&&t.push(e)}return t.join(`
18
+ `)}function Je(e,t){let n=[],r=c(e);if(r){let e=r.fields.filter(e=>!e.positional);for(let r of e){let e=W(r),i=q(r);r.defaultValue!==void 0&&(i+=` ${O.defaultValue(`(default: ${JSON.stringify(r.defaultValue)})`)}`);let a=G(r.env);a&&(i+=` ${a}`),n.push(K(e,i,t,2));let o=U(r,t,2);o&&n.push(o)}}return n}function Ye(e,t,n){let r=[];for(let[i,a]of H(e)){let e=g(a),o=t?`${t} ${i}`:i,s=[e?.description,y(e?.requiredPackages)].filter(Boolean).join(`
19
+ `),c=e?.aliases,l=c&&c.length>0?`${o}, ${c.join(`, `)}`:o;if(r.push(K(O.command(l),s,n)),e){let t=Je(e,n+1);r.push(...t);let i=e.subCommands?Object.fromEntries(H(e.subCommands)):void 0;if(i&&Object.keys(i).length>0){let e=Ye(i,o,n);r.push(...e)}}}return r}function Xe(e,t){let n=[],r=t.context;t.agentHelp&&n.push(ge(t.agentHelp));let i=Ne(e,r);if(i){let e=O.commandName(i);r?.rootName&&r.commandPath&&r.commandPath.length>0?r.rootVersion?e+=` ${O.version(`(${r.rootName} v${r.rootVersion})`)}`:e+=` ${O.version(`(${r.rootName})`)}`:r?.rootVersion&&(e+=` ${O.version(`v${r.rootVersion}`)}`),n.push(e)}r?.aliasFor&&n.push(O.dim(`Alias for ${O.commandName(r.aliasFor)}`)),e.description&&n.push(e.description),!r?.aliasFor&&e.aliases&&e.aliases.length>0&&n.push(`${O.sectionHeader(`Aliases:`)} ${e.aliases.map(e=>O.command(e)).join(`, `)}`),n.push(`${O.sectionHeader(`Usage:`)} ${Fe(e,r)}`);let a=ze(e);a&&n.push(`${O.sectionHeader(`Arguments:`)}\n${a}`);let o=Be(e,t.descriptions,r);if(o&&n.push(`${O.sectionHeader(`Options:`)}\n${o}`),r?.globalExtracted?.fields.length&&n.push(`${O.sectionHeader(`Global Options:`)}\n${qe(r.globalExtracted)}`),t.showSubcommands!==!1&&e.subCommands&&H(e.subCommands).length>0){let i=r?.commandPath?.join(` `)??``,a=Object.fromEntries(H(e.subCommands));if(t.showSubcommandOptions){let e=Ye(a,i,0);n.push(`${O.sectionHeader(`Commands:`)}\n${e.join(`
20
+ `)}`)}else{let e=[];for(let[t,n]of Object.entries(a)){let r=g(n),a=[r?.description,y(r?.requiredPackages)].filter(Boolean).join(`
21
+ `),o=i?`${i} ${t}`:t,s=r?.aliases,c=s&&s.length>0?`${o}, ${s.join(`, `)}`:o;e.push(K(O.command(c),a))}n.push(`${O.sectionHeader(`Commands:`)}\n${e.join(`
22
+ `)}`)}}if(e.examples&&e.examples.length>0){let t=$e(e.examples,r);n.push(`${O.sectionHeader(`Examples:`)}\n${t}`)}let s=y(e.requiredPackages);if(s&&n.push(`${O.sectionHeader(`Required packages:`)}\n${s}`),e.notes){let t=ge(e.notes).split(`
23
+ `).map(e=>e===``?``:` ${e}`).join(`
24
+ `);n.push(`${O.sectionHeader(`Notes:`)}\n${t}`)}return`\n${n.join(`
25
+
26
+ `)}\n`}function q(e){return[e.description,y(e.requiredPackages)].filter(Boolean).join(`
27
+ `)}function J(e){let t={name:e.name,cliName:e.cliName,positional:e.positional,named:e.named,required:e.required,type:e.type};return e.requiredPackages?.length&&(t.requiredPackages=e.requiredPackages.map(e=>({name:e.name,install:C(e)}))),e.alias&&(t.alias=e.alias),e.description!==void 0&&(t.description=e.description),e.placeholder!==void 0&&(t.placeholder=e.placeholder),e.env!==void 0&&(t.env=e.env),e.defaultValue!==void 0&&(t.defaultValue=e.defaultValue),e.enumValues!==void 0&&(t.enumValues=e.enumValues),e.negation!==void 0&&(t.negation=e.negation),e.negationDisplay!==void 0&&(t.negationDisplay=e.negationDisplay),e.negationDescription!==void 0&&(t.negationDescription=e.negationDescription),t}function Ze(e,t){let r=Pe(e,t),i=!!t?.globalExtracted?.fields.length,a=e.subCommands&&H(e.subCommands).length>0?e.run?`optional`:`required`:void 0,o=c(e);return{commandName:r,hasGlobalOptions:i,hasOptions:o?l(o).length>0:!1,subcommand:a,positionals:o?n(o).map(e=>({name:e.name,required:e.required})):[]}}function Qe(e,t={}){let r=t.context,i=r?.commandPath??[],a={help:t.descriptions?.help??V.help,helpAll:t.descriptions?.helpAll??V.helpAll,helpJson:t.descriptions?.helpJson??V.helpJson,...r?.rootVersion?{version:t.descriptions?.version??V.version}:{}},s=c(e),l,d=[],f=[],p,m,h;if(s){if(l=s.schemaType,d=n(s).map(J),s.schemaType===`discriminatedUnion`&&s.discriminator&&s.variants){let e=s.discriminator;p=e;let t=s.variants,n=u(t,e),r=o(s,e),i=s.fields.filter(e=>!e.positional&&n.has(e.name));f=[...r?[{...J({...r,requiredPackages:void 0}),description:s.description??r.description??`Action to perform`}]:[],...i.map(J)],m=t.map(t=>{let r=t.fields.find(t=>t.name===e);return{discriminatorValue:t.discriminatorValue,...r?.requiredPackages?.length?{requiredPackages:J(r).requiredPackages}:{},description:t.description,fields:t.fields.filter(t=>t.name!==e&&!n.has(t.name)).map(J)}})}else if((s.schemaType===`union`||s.schemaType===`xor`)&&s.unionOptions){let e=s.unionOptions,t=u(e);f=s.fields.filter(e=>!e.positional&&t.has(e.name)).map(J),h=e.map(e=>({description:e.description,fields:e.fields.filter(e=>!t.has(e.name)).map(J)}))}else f=s.fields.filter(e=>!e.positional).map(J)}let _=r?.globalExtracted?.fields.length?r.globalExtracted.fields.filter(e=>!e.positional).map(J):void 0,v;if(e.subCommands){let n=H(e.subCommands);n.length>0&&(v=n.map(([n,a])=>{let o=g(a);if(!o)return{name:n,unresolved:!0};let s={commandPath:[...i,n],rootName:r?.rootName??e.name,rootVersion:r?.rootVersion,globalExtracted:r?.globalExtracted};return{name:n,aliases:o.aliases,data:Qe(o,{descriptions:t.descriptions,context:s})}}))}return{name:e.name??`command`,commandPath:i,rootName:r?.rootName,version:r?.rootVersion,aliasFor:r?.aliasFor,description:e.description,aliases:e.aliases,usage:Ze(e,r),builtinOptions:a,schemaType:l,positionals:d,options:f,discriminator:p,variants:m,unionOptions:h,globalOptions:_,subcommands:v,examples:e.examples,notes:e.notes,...e.requiredPackages?.length?{requiredPackages:e.requiredPackages.map(e=>({name:e.name,install:C(e),description:e.description}))}:{},agentHelp:t.agentHelp}}function $e(e,t){let n=[],r=t?.rootName?`${t.rootName} `:``,i=t?.commandPath?.join(` `)??``,a=i?`${r}${i} `:r;for(let t of e){if(n.push(` ${O.dim(t.desc).split(`
28
+ `).join(`
29
+ `)}`),n.push(` ${O.dim(`$`)} ${a}${t.cmd}`),t.output)for(let e of t.output.split(`
30
+ `))n.push(` ${e}`);n.push(``)}return n.length>0&&n[n.length-1]===``&&n.pop(),n.join(`
31
+ `)}var et=class extends Error{constructor(e){super(e),this.name=`PositionalConfigError`}},tt=class extends Error{constructor(e){super(e),this.name=`ReservedAliasError`}},nt=class extends Error{constructor(e){super(e),this.name=`DuplicateFieldError`}},rt=class extends Error{constructor(e){super(e),this.name=`DuplicateAliasError`}},it=class extends Error{constructor(e){super(e),this.name=`CaseVariantCollisionError`}},at=class extends Error{constructor(e){super(e),this.name=`DuplicateNegationError`}},ot=class extends Error{constructor(e){super(e),this.name=`ReservedFieldNameError`}},st=class extends Error{constructor(e){super(e),this.name=`DefaultSubCommandError`}},ct=class extends Error{constructor(e){super(e),this.name=`FieldTypeConflictError`}};function lt(e,t){let n=[],r=/* @__PURE__ */ new Map;for(let i of e.fields)r.has(i.name)&&n.push({commandPath:t,type:`duplicate_field`,message:`Duplicate field name "${i.name}" detected.`,field:i.name}),r.set(i.name,i.name);return n}function ut(e,t){let n=[],r=/* @__PURE__ */ new Map;for(let i of e.fields){let e=A(i.name),a=r.get(e);a&&a!==i.name&&n.push({commandPath:t,type:`case_variant_collision`,message:`Fields "${a}" and "${i.name}" are case variants of each other and would collide.`,field:i.name}),r.set(e,i.name)}return n}function dt(e,t){let n=[],r=/* @__PURE__ */ new Map,i=new Set(e.fields.map(e=>e.name)),a=new Set(e.fields.map(e=>e.cliName)),o=(e,o,s)=>{(i.has(e)||a.has(e))&&n.push({commandPath:t,type:`duplicate_alias`,message:`Alias "${e}" for field "${o}" conflicts with existing field name or CLI name "${e}".`,field:o});let c=r.get(e);if(c&&c!==o){let r=s?` (derived camelCase variant)`:``;n.push({commandPath:t,type:`duplicate_alias`,message:`Duplicate alias "${e}"${r} detected. Both "${c}" and "${o}" use the same alias.`,field:o})}r.set(e,o)};for(let t of e.fields){let e=k(t);if(e.length!==0){for(let n of e)if(o(n,t.name,!1),n.length>1&&n.includes(`-`)){let e=A(n);e!==n&&!i.has(e)&&o(e,t.name,!0)}}}return n}function ft(e,t){let n=[],r=/* @__PURE__ */ new Map,i=(e,t,n)=>{r.has(e)||r.set(e,{field:t,kind:n})};for(let t of e.fields){if(i(t.name,t.name,`field name`),t.name.includes(`-`)){let e=A(t.name);e!==t.name&&i(e,t.name,`field name`)}if(t.cliName!==t.name&&i(t.cliName,t.name,`CLI name`),t.cliName.includes(`-`)){let e=A(t.cliName);e!==t.cliName&&i(e,t.name,`CLI name`)}for(let e of k(t))if(i(e,t.name,`alias`),e.length>1&&e.includes(`-`)){let n=A(e);n!==e&&i(n,t.name,`alias`)}if(t.type===`boolean`&&t.negation===!0){let e=`no-${t.cliName}`;i(e,t.name,`default negation`);let n=A(t.cliName),r=`no${n[0]?.toUpperCase()??``}${n.slice(1)}`;r!==e&&i(r,t.name,`default negation`)}}let a=/* @__PURE__ */ new Map,o=(e,i,o)=>{let s=r.get(e);if(s){let r=o?` (derived camelCase variant)`:``,a=s.field===i?`the same field's own ${s.kind} "${e}"`:`${s.kind} "${e}" of field "${s.field}"`;n.push({commandPath:t,type:`duplicate_negation`,message:`Negation "${e}"${r} for field "${i}" conflicts with ${a}.`,field:i})}let c=a.get(e);if(c&&c!==i){let r=o?` (derived camelCase variant)`:``;n.push({commandPath:t,type:`duplicate_negation`,message:`Duplicate negation "${e}"${r} detected. Both "${c}" and "${i}" use the same negation name.`,field:i})}a.set(e,i)};for(let t of e.fields)if(typeof t.negation==`string`&&(o(t.negation,t.name,!1),t.negation.includes(`-`))){let e=A(t.negation);e!==t.negation&&o(e,t.name,!0)}return n}function pt(e,t){let n=[e,...e.variants??[],...e.unionOptions??[]],r=/* @__PURE__ */ new Set;return n.flatMap(e=>mt(e.fields,t)).filter(e=>!r.has(e.message)&&r.add(e.message))}function mt(e,t){let n=[],r=e.filter(e=>e.positional),i=null,a=null;for(let e of r)i!==null&&n.push({commandPath:t,type:`positional_config`,message:`Positional argument "${e.name}" cannot follow array positional argument "${i}".`,field:e.name}),e.type===`array`&&a!==null&&n.push({commandPath:t,type:`positional_config`,message:`Array positional "${e.name}" cannot be used with optional positional "${a}" (ambiguous parsing).`,field:e.name}),a!==null&&e.required&&n.push({commandPath:t,type:`positional_config`,message:`Required positional "${e.name}" cannot follow optional positional "${a}".`,field:e.name}),e.type===`array`&&(i=e.name),e.required||(a=e.name);return n}function ht(e,t){let n=[];for(let r of e.fields){if(r.overrideBuiltinAlias!==!0)for(let e of k(r))(e===`h`||e===`H`)&&n.push({commandPath:t,type:`reserved_alias`,message:`Alias "${e}" is reserved for --${e===`h`?`help`:`help-all`}. To override this, set { overrideBuiltinAlias: true } for "${r.name}" and keep the alias where it is currently defined (in alias or hiddenAlias).`,field:r.name});let e=/* @__PURE__ */ new Set([r.cliName,...k(r)]);for(let i of e){if(!j.has(i))continue;let e=i===r.cliName;n.push({commandPath:t,type:`reserved_alias`,message:`${e?`Field "${r.name}"`:`Alias "${i}" for field "${r.name}"`} collides with the built-in --${i} option, which always takes precedence. Rename the field or its alias; this collision cannot be overridden.`,field:r.name})}}return n}function gt(e,t){let n=[];for(let r of e.fields)r.name.startsWith(`$`)&&n.push({commandPath:t,type:`reserved_field_name`,message:`Field "${r.name}" starts with "$", which is reserved for framework-injected helpers (e.g. $source).`,field:r.name});return n}function _t(e){let t=lt(e,[]);if(t.length>0)throw new nt(`Duplicate field name "${t[0]?.field??`unknown`}" detected. Each field must have a unique name.`)}function vt(e){let t=dt(e,[]);if(t.length>0){let e=t[0];throw new rt(e.message)}}function yt(e){let t=pt(e,[]);if(t.length>0){let e=t[0];throw new et(e.message)}}function bt(e,t){let n=ht(e,[]);if(n.length>0)throw new tt(n[0].message)}function xt(e){let t=gt(e,[]);if(t.length>0){let e=t[0];throw new ot(e.message)}}function St(e){let t=ft(e,[]);if(t.length>0){let e=t[0];throw new at(e.message)}}function Ct(e){let t=ut(e,[]);if(t.length>0){let e=t[0];throw new it(e.message)}}function wt(e,t,n){let r=[],i=/* @__PURE__ */ new Map;for(let t of e.fields)i.set(A(t.name),t);for(let e of t.fields){let t=A(e.name),a=i.get(t);a&&(a.name===e.name?r.push({commandPath:n,type:`field_type_conflict`,message:`Global field "${a.name}" and command field "${e.name}" share the same name. A field name can only be declared in one schema, even when the definitions are identical.`,field:e.name}):r.push({commandPath:n,type:`case_variant_collision`,message:`Global field "${a.name}" and command field "${e.name}" are case variants of each other and would collide.`,field:e.name}))}return r.push(...Tt(e,t,n)),r}function Tt(e,t,n){let r=e=>e.fields.map(e=>({field:e,path:e.nested?.path??[e.name]})),i=r(e),a=r(t);if(![...i,...a].some(({field:e})=>e.nested))return[];let o=[];for(let e of i)for(let t of a){if(!e.field.nested&&!t.field.nested)continue;let r=Math.min(e.path.length,t.path.length),i=e.path.length!==t.path.length&&e.path.slice(0,r).every((e,n)=>e===t.path[n])?`one is a value where the other nests a group`:e.path[0]!==t.path[0]&&M(e.path[0])===M(t.path[0])?`their group names are spellings of the same name`:void 0;i&&o.push({commandPath:n,type:`field_type_conflict`,message:`Global field "${e.field.name}" and command field "${t.field.name}" nest into conflicting output positions: ${i}.`,field:t.field.name})}return o}function Et(e,t){let n=wt(e,t,[])[0];if(n)throw n.type===`case_variant_collision`?new it(n.message):new ct(n.message)}function Dt(e,t,n){return[...lt(e,n),...ut(e,n),...dt(e,n),...ft(e,n),...pt(e,n),...ht(e,n),...gt(e,n)]}function Ot(e,t){let n=e,r=[];if(n.defaultSubCommand===void 0)return r;n.run&&r.push({commandPath:t,type:`default_subcommand_conflict`,message:`Command "${n.name}" defines both "run" and "defaultSubCommand". Define only one.`});let i=e.subCommands?Object.keys(e.subCommands):[];return i.includes(n.defaultSubCommand)||r.push({commandPath:t,type:`default_subcommand_not_found`,message:`defaultSubCommand "${n.defaultSubCommand}" does not match any subCommands key of "${n.name}". Registered: ${i.length>0?i.join(`, `):`(none)`}.`,field:n.defaultSubCommand}),r}function kt(e){let t=Ot(e,[]);if(t.length>0)throw new st(t[0].message)}function At(e,t){let n=[];if(!e.subCommands)return n;let r=/* @__PURE__ */ new Map;for(let[t]of Object.entries(e.subCommands))r.set(t,t);for(let[i,a]of Object.entries(e.subCommands)){let e=ee(a)?a.meta:typeof a==`function`?null:a;if(!e?.aliases)continue;let o=[...t,i];for(let t of e.aliases){if(!/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/.test(t)){n.push({commandPath:o,type:`invalid_alias`,message:`Alias "${t}" is invalid. Aliases must start with an alphanumeric character and contain only alphanumeric characters, hyphens, or underscores.`,field:i});continue}if(t===i){n.push({commandPath:o,type:`duplicate_alias`,message:`Alias "${t}" conflicts with its own name.`,field:i});continue}let e=r.get(t);e?e===i?n.push({commandPath:o,type:`duplicate_alias`,message:`Alias "${t}" is duplicated within the alias list.`,field:i}):n.push({commandPath:o,type:`duplicate_alias`,message:`Alias "${t}" conflicts with existing subcommand or alias "${e}".`,field:i}):r.set(t,i)}}return n}function jt(e,t,n){return e===t?[]:[{commandPath:[...n,e],type:`subcommand_key_name_mismatch`,message:`Subcommand registered as "${e}" but its own name is "${t}".`,field:e}]}async function Mt(e,t={}){return Nt(e,t,!1)}async function Nt(e,t,n){n||=!!e.requiredPackages?.length;let r=t.commandPath??[e.name],i=[],o=e.subCommands?Object.keys(e.subCommands).length>0:!1,s=t.globalArgs?a(t.globalArgs):void 0;if(e.args){let t=a(e.args);i.push(...Dt(t,o,r)),s&&i.push(...wt(s,t,r))}if(i.push(...At(e,r)),i.push(...Ot(e,r)),e.subCommands)for(let[a,o]of Object.entries(e.subCommands)){let e=await x(o,e=>n||!!e.requiredPackages?.length);i.push(...jt(a,e.name,r));let s=await Nt(e,{commandPath:[...r,a],...t.globalArgs?{globalArgs:t.globalArgs}:{}},n);s.valid||i.push(...s.errors)}return i.length===0?{valid:!0}:{valid:!1,errors:i}}function Pt(e){if(e.length===0)return``;let t=[`Command definition errors:`];for(let n of e){let e=n.commandPath.join(` > `);t.push(` - [${e}] ${n.message}`)}return t.join(`
32
+ `)}function Ft(e){let{aliasMap:t=/* @__PURE__ */ new Map,booleanFlags:n=/* @__PURE__ */ new Set,definedNames:r=/* @__PURE__ */ new Set,negationMap:i=/* @__PURE__ */ new Map,defaultNegationDisabledFields:a=/* @__PURE__ */ new Set}=R(e),o=/* @__PURE__ */ new Set;for(let t of e.fields)for(let e of k(t))e.length===1&&o.add(e);return{aliasMap:t,booleanFlags:n,definedNames:r,flagNames:new Set(e.fields.map(e=>e.name)),cliNames:new Set(e.fields.map(e=>e.cliName)),aliases:o,negationMap:i,defaultNegationDisabledFields:a}}function It(e,t){let{resolvedName:n,withoutDashes:r,isNegated:i,isCustomNegation:a,isSuppressedNegation:o}=ie(e,t);if(o)return{resolvedName:n,withoutDashes:r,isNegated:!1,isGlobal:!1,isSuppressedNegation:o};let s=i&&!a?r.startsWith(`no-`)?r.slice(3):r[2].toLowerCase()+r.slice(3):r;return{resolvedName:n,withoutDashes:r,isNegated:i,isGlobal:t.flagNames.has(n)||t.cliNames.has(r)||t.cliNames.has(s),isSuppressedNegation:!1}}function Y(e,t,n,r,i){return!e.includes(`=`)&&!i.has(t)&&!n&&r!==void 0&&F(r)}function X(e,t,n,r,i,a){let o=e[t];return a.push(o),Y(o,n,r,e[t+1],i)?(a.push(e[t+1]),2):1}function Lt(e,t,n,r=()=>!1){let i=e[t];if(!ae(i))return 0;let a=e=>n.aliasMap.get(e)??e,o=e=>!r(e)&&(n.aliases.has(e)||n.flagNames.has(a(e))),{flags:s,valueOption:c}=L(i.slice(1),e=>o(e)&&!n.booleanFlags.has(a(e)));return s.every(o)?c&&c.value===void 0&&Y(i,a(c.name),!1,e[t+1],n.booleanFlags)?2:1:0}function Rt(e,t,n){let r=Ft(n),i=new Set(t),a=[],o=[],s=0;for(;s<e.length;){let t=e[s];if(t===`--`||zt.has(t))break;if(!t.startsWith(`-`)&&i.has(t))return{subCommandIndex:s,globalTokensBefore:a,tokensAfterSubcommand:e.slice(s+1),suppressedTokens:o};if(t.startsWith(`--`)){let{resolvedName:n,withoutDashes:i,isNegated:c,isGlobal:l,isSuppressedNegation:u}=It(t,r);if(l){s+=X(e,s,n,c,r.booleanFlags,a);continue}if(u){o.push(i),s++;continue}break}if(t.startsWith(`-`)&&t.length>1){let n=t.includes(`=`)?t.slice(1,t.indexOf(`=`)):t.slice(1);if(n.length===1){let t=r.aliasMap.get(n)??n;if(r.aliases.has(n)||r.flagNames.has(t)){s+=X(e,s,t,!1,r.booleanFlags,a);continue}}let i=Lt(e,s,r);if(i>0){a.push(...e.slice(s,s+i)),s+=i;continue}break}break}return{subCommandIndex:-1,globalTokensBefore:a,tokensAfterSubcommand:[],suppressedTokens:o}}const zt=/* @__PURE__ */ new Set([`--help`,`-h`,`--help-all`,`-H`,`--help-json`,`--version`]);function Bt(e,t,n={}){let r=n.stopOnSuppressedNegation===!0||t?.unknownKeysMode===`strict`,i=t?Ft(t):{aliasMap:/* @__PURE__ */ new Map,booleanFlags:/* @__PURE__ */ new Set,definedNames:/* @__PURE__ */ new Set,flagNames:/* @__PURE__ */ new Set,cliNames:/* @__PURE__ */ new Set,aliases:/* @__PURE__ */ new Set,negationMap:/* @__PURE__ */ new Map,defaultNegationDisabledFields:/* @__PURE__ */ new Set};for(let t=0;t<e.length;t++){let n=e[t];if(!n.startsWith(`-`))return t;if(n===`--`||zt.has(n))return-1;if(n.startsWith(`--`)){let{resolvedName:a,isNegated:o,isGlobal:s,isSuppressedNegation:c}=It(n,i);if(s){Y(n,a,o,e[t+1],i.booleanFlags)&&t++;continue}if(c){if(r)return-1;continue}return-1}let a=n.includes(`=`)?n.slice(1,n.indexOf(`=`)):n.slice(1);if(a.length===1){let r=i.aliasMap.get(a)??a;if(i.aliases.has(a)||i.flagNames.has(r)){Y(n,r,!1,e[t+1],i.booleanFlags)&&t++;continue}}let o=Lt(e,t,i);if(o>0)t+=o-1;else return-1}return-1}function Vt(e,t){let n=Bt(e,t);return n>=0?e[n]:void 0}function Ht(e,n,r={}){let i=S(n),o=[...i],s=o.length>0,c=s&&!n.run;if(s&&e.length>0){if(r.globalExtracted){let t=Rt(e,o,r.globalExtracted);if(t.subCommandIndex>=0){let n=Gt(t.globalTokensBefore,r.globalExtracted);return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:e[t.subCommandIndex],remainingArgs:t.tokensAfterSubcommand,rawArgs:{},positionals:[],rest:[],unknownFlags:t.suppressedTokens,unknownGlobalFlags:t.suppressedTokens,rawGlobalArgs:n}}}else{let t=e[0];if(t&&!t.startsWith(`-`)&&i.has(t))return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:t,remainingArgs:e.slice(1),rawArgs:{},positionals:[],rest:[],unknownFlags:[]}}}let l;n.args&&(l=a(n.args),r.skipValidation||(_t(l),Ct(l),vt(l),St(l),yt(l),bt(l,s),xt(l),r.globalExtracted&&Et(r.globalExtracted,l)));let u=e,d,f=[];if(r.globalExtracted){let n=l?t(l):[],i=new Set(n.map(e=>e.name)),{separated:a,globalParsed:o,suppressedTokens:s}=Jt(e,r.globalExtracted,l&&{...l,fields:[...n,...l.fields.filter(e=>!i.has(e.name))]});u=a,d=o,f=s}let{helpRequested:p,helpAllRequested:m,helpJsonRequested:h,versionRequested:g}=Kt(e,l);if(p||m||h||g)return{helpRequested:p,helpAllRequested:m,helpJsonRequested:h,versionRequested:g,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:[],rest:[],unknownFlags:[],unknownGlobalFlags:f,rawGlobalArgs:d};if(c||r.beforeEnvFallback?.(d),!l){let e=u.indexOf(`--`),t=e>=0?u.slice(0,e):u,n=e>=0?u.slice(e+1):[],i=e=>c&&e.startsWith(`-`)&&e!==`-`,a=new Set(r.globalExtracted?.fields.flatMap(e=>[e.name,e.cliName,...k(e)])),o=r.globalExtracted?R(r.globalExtracted):{},s=t.filter(i).flatMap(e=>Object.keys(N([e],o).options)).filter(e=>!a.has(e));return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:t.filter(e=>!i(e)),rest:n,unknownFlags:s,unknownGlobalFlags:f,rawGlobalArgs:d}}let _=Ut(l,u,{promptAvailable:r.promptAvailable===!0,inheritedNames:r.inheritedNames??/* @__PURE__ */ new Set});if(!_)return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:[],rest:[],unknownFlags:[],unknownGlobalFlags:f,extractedFields:l,matchesNoUnionOption:!0,rawGlobalArgs:d};let v=R(_),y=N(u,{...v,unknownFlagsTakeNoValue:c}),b=P(y,_),ee=Z(b,_),x=_.fields.filter(e=>e.named),C=new Set(x.map(e=>e.name)),w=new Set(x.map(e=>e.cliName)),T=/* @__PURE__ */ new Set;for(let e of x)for(let t of k(e))T.add(t);if(r.globalExtracted)for(let e of r.globalExtracted.fields){C.add(e.name),w.add(e.cliName);for(let t of k(e))T.add(t)}let E=[];for(let e of Object.keys(y.options))C.has(e)||w.has(e)||T.has(e)||E.push(e);return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:b,positionals:y.positionals,rest:y.rest,unknownFlags:E,unknownGlobalFlags:f,extractedFields:l,optionFields:x,positionalSlotFields:I(_,y.options),rawGlobalArgs:d,envFallbackFields:ee}}function Ut(e,t,n){let{discriminator:r,variants:i,unionOptions:a}=e;if(r&&i){let n=e=>{let n=P(N(t,R(e)),e);return Z(n,e),n},r=d(e,n);return r===e?i.some(t=>{let r=n({...e,fields:t.fields});return d(e,()=>r)!==e})?void 0:e:r}if(a){let r=a.flatMap(e=>{let r=Ut(e,t,n);return r?[r]:[]}),i=n.promptAvailable?r.filter(e=>Wt(e,t,void 0)):[],o=r.find(e=>Wt(e,t,n.inheritedNames))??(i.length===1?i[0]:void 0);return o&&{...e,fields:o.fields}}return e}function Z(e,t){let n=/* @__PURE__ */ new Set;for(let r of t.fields)if(r.env&&e[r.name]===void 0)for(let t of[r.env].flat()){let i=process.env[t];if(i!==void 0){e[r.name]=re(i,r.type),n.add(r.name);break}}return n}function Wt(e,t,n){let r=N(t,R(e)),i=e.fields.filter(e=>e.named),a=new Set(i.flatMap(e=>[e.name,e.cliName,...k(e)]));if(Object.keys(r.options).some(e=>!a.has(e)))return!1;let o=I(e,r.options),s=r.positionals.length+r.rest.length;if(!o.some(e=>e.type===`array`)&&s>o.length)return!1;let c=P(r,e);return e.fields.some(e=>e.type!==`boolean`&&[c[e.name]].flat().includes(!0))?!1:n===void 0||(Z(c,e),e.fields.every(e=>!e.required||c[e.name]!==void 0||n.has(e.name)))}function Gt(e,t){if(e.length===0)return{};let n=R(t),r=N(e,n);return P(r,t)}function Kt(e,t){let n=e.indexOf(`--`),r=n>=0?e.slice(0,n):e,i=t?.fields.some(e=>e.overrideBuiltinAlias===!0&&k(e).includes(`H`))??!1,a=t?.fields.some(e=>e.overrideBuiltinAlias===!0&&k(e).includes(`h`))??!1,o=r.includes(`--help-all`)||!i&&r.includes(`-H`),s=r.includes(`--help-json`);return{helpRequested:!o&&!s&&(r.includes(`--help`)||!a&&r.includes(`-h`)),helpAllRequested:o,helpJsonRequested:s,versionRequested:r.includes(`--version`)}}function qt(e,t){return Jt([...e],t).globalParsed}function Jt(e,t,n){let r=Ft(t),i=new Set(n?.fields.map(e=>e.name)??[]),a=new Set(n?.fields.map(e=>e.cliName)??[]),o=n?R(n):void 0,s=new Set(o?.aliasMap?.keys()??[]),c=new Set(o?.negationMap?.keys()??[]),l=/* @__PURE__ */ new Set;for(let e of n?.fields??[])if(e.type===`boolean`&&e.negation===!0)for(let t of[e.cliName,...k(e)]){let e=`no-${t}`;l.add(e),l.add(A(e))}let u=[],d=[],f=[];for(let t=0;t<e.length;t++){let n=e[t];if(n===`--`){d.push(...e.slice(t));break}if(n.startsWith(`--`)){let{resolvedName:o,withoutDashes:d,isNegated:p,isGlobal:m,isSuppressedNegation:h}=It(n,r),g=o,_=i.has(d)||i.has(g)||a.has(d)||a.has(g)||s.has(d)||s.has(g)||c.has(d)||c.has(g)||l.has(d);if(m&&!_){t+=X(e,t,o,p,r.booleanFlags,u)-1;continue}if(h&&!_){f.push(d);continue}}else if(n.startsWith(`-`)&&n.length>1){let i=n.includes(`=`)?n.slice(1,n.indexOf(`=`)):n.slice(1);if(i.length===1){let n=r.aliasMap.get(i)??i;if((r.aliases.has(i)||r.flagNames.has(n))&&!s.has(i)){t+=X(e,t,n,!1,r.booleanFlags,u)-1;continue}}let a=Lt(e,t,r,e=>s.has(e));if(a>0){u.push(...e.slice(t,t+a)),t+=a-1;continue}}d.push(n)}return{separated:d,globalParsed:Gt(u,t),suppressedTokens:f}}function Q(t,n){return e(n)?f(t,n):te().validate(t,n)}function Yt(e){return e.map(e=>`${e.path.length>0?`${e.path.join(`.`)}: `:``}${e.message}`).join(`
33
+ `)}function Xt(e,t){let n=[];for(let e=0;e<=t.length;e++)n[e]=[e];for(let t=0;t<=e.length;t++)n[0][t]=t;for(let r=1;r<=t.length;r++)for(let i=1;i<=e.length;i++)t.charAt(r-1)===e.charAt(i-1)?n[r][i]=n[r-1][i-1]:n[r][i]=Math.min(n[r-1][i-1]+1,n[r][i-1]+1,n[r-1][i]+1);return n[t.length][e.length]}function Zt(e,t){let n=Math.max(2,Math.floor(e.length/2));return t.map(t=>({candidate:t,distance:Xt(e.toLowerCase(),t.toLowerCase())})).filter(({distance:e})=>e<=n).sort((e,t)=>e.distance-t.distance).map(({candidate:e})=>e).slice(0,3)}function Qt(e,t){let n=Zt(e.replace(/^-{1,2}/,``),t),r=`${O.warning(`Warning: Unknown option:`)} ${O.bold(e)}`;if(n.length>0){r+=`\n\n${O.info(`Did you mean?`)}`;for(let e of n)r+=`\n ${D.arrow} ${O.option(`--${e}`)}`}return r}function $t(e,t){return t&&e.stack?`${O.error(`Error:`)} ${e.message}\n\n${O.dim(e.stack)}`:`${O.error(`Error:`)} ${e.message}`}function $(e){return new Proxy(e,{get(e,t,n){if(typeof t==`string`){if(t in e)return Reflect.get(e,t,n);let r=A(t);if(r!==t&&r in e)return Reflect.get(e,r,n);let i=M(t);if(i!==t&&i in e)return Reflect.get(e,i,n)}return Reflect.get(e,t,n)},has(e,t){if(typeof t==`string`){if(t in e)return!0;let n=A(t);if(n!==t&&n in e)return!0;let r=M(t);if(r!==t&&r in e)return!0}return Reflect.has(e,t)}})}async function en(e,t,n){for(let i of t.fields)i.effect&&await i.effect(r(e,i),{name:i.name,args:e,...n!=null&&{globalArgs:n}})}var tn=class extends Error{constructor(e){super(`Environment file not found: ${e}`),this.name=`EnvFileNotFoundError`}};function nn(e,t){return t.fields.flatMap(t=>{if(!t.envFile)return[];let n=t.envFile===`if-exists`;return e.flatMap(e=>[e[t.name]].flat().filter(e=>typeof e==`string`).map(e=>({path:e,ifExists:n})))})}function rn(e,t){return Object.fromEntries((t?.fields??[]).flatMap(t=>{if(!t.envFile||t.type!==`array`)return[];let n=e.flatMap(e=>[e[t.name]].flat());return n.length>0&&n.every(e=>typeof e==`string`)?[[t.name,n]]:[]}))}function an(e,t={}){sn(Array.isArray(e)?e:on(e,t.argv??process.argv.slice(2)))}function on(e,t){let n=a(e);return ln(n),Object.values(Kt(t)).some(Boolean)?[]:nn([qt(t,{...n,fields:n.fields.map(e=>e.envFile&&e.type===`string`?{...e,type:`array`}:e)})],n)}function sn(e){let t=e.flatMap(e=>{let t=oe.resolve(process.cwd(),e.path);if(!z.existsSync(t)){if(e.ifExists)return[];throw new tn(t)}return[ce(z.readFileSync(t,`utf-8`))]}),n=new Set(t.flatMap(e=>Object.keys(e)).filter(e=>typeof process.env[e]==`string`));for(let e of t)for(let[t,r]of Object.entries(e))n.has(t)||(process.env[t]=r)}function cn(e){return[...e.fields,...(e.variants??[]).flatMap(e=>e.fields),...(e.unionOptions??[]).flatMap(cn)]}function ln(e){let t=/* @__PURE__ */ new Map;for(let n of cn(e)){if(n.envFile&&n.type!==`string`&&n.type!==`array`)throw Error(`Global option "${n.name}" sets envFile but its value is not a string or an array of strings`);let e=t.get(n.name)??/* @__PURE__ */ new Set;e.add(n.envFile??!1),t.set(n.name,e)}for(let[e,n]of t)if(n.size>1)throw Error(`Global option "${e}" has different envFile settings across union variants (${[...n].map(e=>JSON.stringify(e)).join(`, `)}); use the same setting in every variant`)}const un={log:e=>console.log(e),error:e=>console.error(e),warn:e=>console.warn(e)};function dn(e){let t={};for(let[n,r]of Object.entries(e))try{t[n]=structuredClone(r)}catch{t[n]=r}return t}function fn(e,t){Object.defineProperty(e,"$source",{value:e=>t.get(e)??t.get(A(e))??t.get(M(e))??`default`,enumerable:!1})}function pn(e,t,n){let r=/* @__PURE__ */ new Map;for(let t of e)r.set(t,`cli`);for(let e of t)r.set(e,`env`);for(let e of n)r.set(e,`prompt`);return r}function mn(e,t){Object.defineProperty(e,"$invocation",{value:t,enumerable:!1})}function hn(e,t){Object.defineProperty(e,"$agent",{value:t,enumerable:!1})}function gn(e,t){return e&&(n=>e({...n,agent:t}))}function _n(e,t,n){if(!e.rawGlobalArgs)return;let r=new Set(n.fields.map(e=>e.name)),i={};for(let[t,n]of Object.entries(e.rawGlobalArgs))r.has(t)&&(i[t]=n);let a=new Set(Object.keys(i)),o=Z(i,n);for(let[t,n]of Object.entries(e.promptedGlobalArgs??{}))r.has(t)&&(o.delete(t),n===void 0?(delete i[t],a.delete(t)):i[t]=n);for(let n=0;n<=r.size;n++){let n=Q(i,t);if(n.success){let t=n.data,r=/* @__PURE__ */ new Map;for(let e of a)e in i&&r.set(e,`cli`);for(let e of o)e in i&&r.set(e,`env`);for(let[t,n]of Object.entries(e.promptedGlobalArgs??{}))n!==void 0&&t in i&&r.set(t,`prompt`);return fn(t,r),$(t)}let r=n.errors.map(e=>e.path[0]).filter(e=>e!==void 0&&Object.hasOwn(i,e));if(r.length===0){let e=Object.keys(i).filter(e=>{let{[e]:n,...r}=i;return Q(r,t).success});if(e.length!==1)return;r=e}for(let e of r)delete i[e]}}function vn(e,t,n,r){let i=e.success?void 0:e.error;if(e.success||t.effectsRan||!n||!r)return{error:i};try{return{error:i,globalArgs:_n(t,n,r)}}catch{return{error:i}}}function yn(e,t){let{agentHelp:n,_agent:r}=e;if(n&&r)return typeof n==`string`?n:n({agent:r,commandPath:t.commandPath??[]})}function bn(e,t){let n=t.commandPath?.at(-1)??e.name;return t.aliasFor?{name:n,aliasFor:t.aliasFor}:{name:n}}async function xn(e,t,n={}){let r=En(n),i=p(),a=gn(n.cleanup,i),o=n.captureLogs??!1,s=o?E():null;if(n.setup){s?.start();try{await n.setup({agent:i})}catch(e){let t=e instanceof Error?e:Error(String(e));if(a)try{await a({error:t})}catch{}return s?.stop(),{success:!1,error:t,exitCode:1,logs:s?.getLogs()??w()}}s?.stop()}let c={},l=await Tn(e,t,{...n,handleSignals:!1,_globalExtracted:r,_globalCleanup:a,_existingLogs:s?.getLogs(),_agent:i,_globalTrace:c});if(a){let e=o?E():null;e?.start();let t=vn(l,c,n.globalArgs,r);try{await a(t)}catch(t){if(l.success){let n=t instanceof Error?t:Error(String(t));return e?.stop(),{success:!1,error:n,exitCode:1,logs:T(l.logs,e?.getLogs()??w())}}}e?.stop();let i=e?.getLogs()??w();if(i.entries.length>0)return{...l,logs:T(l.logs,i)}}return l}function Sn(e,t,n){let r=Vt(t,n);return!r||!r.startsWith(`__`)?!1:Object.hasOwn(e.subCommands??{},r)}async function Cn(e,t={}){if(t.compileCache!==!1&&m(typeof t.compileCache==`string`?{cacheDir:t.compileCache}:{programName:e.name}),e.runMainHook)try{e.runMainHook(process.argv.slice(2))}catch{}let n=process.argv.slice(2),r;if(t.globalArgs)try{r=a(t.globalArgs)}catch{}let i=t;if(Sn(e,n,r)){let{setup:e,cleanup:n,prompt:r,globalArgs:a,...o}=t;i=o}let o=En(i),s=p(),c=gn(i.cleanup,s);if(i.skipValidation||kt(e),i.onUnknownSubcommand&&!e.run&&!Sn(e,n,r)){let t=S(e);if(t.size>0){let e=Bt(n,o,{stopOnSuppressedNegation:o?.unknownKeysMode!==`passthrough`}),r=e>=0?n[e]:void 0;if(r&&!t.has(r)){let t=n.slice(e+1),a=await i.onUnknownSubcommand({commandPath:[],name:r,args:t,precedingArgs:n.slice(0,e)});if(typeof a==`number`)return await wn(),process.exit(a)}}}if(i.setup)try{await i.setup({agent:s})}catch(e){let t=e instanceof Error?e:Error(String(e));if(c)try{await c({error:t})}catch{}process.exit(1)}let l={},u=await Tn(e,n,{debug:i.debug,captureLogs:i.captureLogs,skipValidation:i.skipValidation,handleSignals:!0,logger:i.logger,globalArgs:i.globalArgs,prompt:i.prompt,onUnknownSubcommand:i.onUnknownSubcommand,agentHelp:i.agentHelp,_globalExtracted:o,_globalCleanup:c,_agent:s,_globalTrace:l,_context:{commandPath:[],rootName:e.name,rootVersion:i.version,globalExtracted:o}});if((i.displayErrors??!0)&&!u.success&&u.error&&(i.logger??un).error($t(u.error,i.debug??!1)),c){let e=vn(u,l,i.globalArgs,o);try{await c(e)}catch{}}await wn(),process.exit(u.exitCode)}async function wn(){await Promise.all([process.stdout,process.stderr].map(e=>e.writableLength>0?new Promise(t=>e.write(``,()=>t())):Promise.resolve()))}async function Tn(e,t,n={}){let r=n.logger??un,a=n._context??{commandPath:[],rootName:e.name,globalExtracted:n._globalExtracted},o=n.captureLogs??!1?E():null;o?.start();let c=()=>{let e=n._existingLogs??w(),t=o?.getLogs()??w();return T(e,t)};try{n.skipValidation||kt(e);let l=(()=>{if(!n.onUnknownSubcommand||e.run||(a.commandPath??[]).length===0)return;let r=S(e);if(r.size===0)return;let i=Bt(t,n._globalExtracted,{stopOnSuppressedNegation:n._globalExtracted?.unknownKeysMode!==`passthrough`}),o=i>=0?t[i]:void 0;return o&&!r.has(o)?{positionalIndex:i,name:o}:void 0})(),u;try{u=Ht(t,e,{skipValidation:n.skipValidation,globalExtracted:n._globalExtracted,promptAvailable:n.prompt!==void 0,inheritedNames:new Set(Object.keys(n._parsedGlobalArgs??{})),beforeEnvFallback:e=>{n._globalExtracted&&!l&&(n._globalTrace&&(n._globalTrace.rawGlobalArgs={...n._parsedGlobalArgs,...e,...rn([n._parsedGlobalArgs??{},e??{}],n._globalExtracted)}),an(nn([...n._globalArgLevels??[],e??{}],n._globalExtracted)))}})}catch(e){if(!(e instanceof tn))throw e;return o?.stop(),{success:!1,error:e,exitCode:2,logs:c()}}let f={...n._parsedGlobalArgs,...u.rawGlobalArgs,...rn([n._parsedGlobalArgs??{},u.rawGlobalArgs??{}],n._globalExtracted)};n._globalTrace&&(n._globalTrace.rawGlobalArgs={...f});let p=a.commandPath??[],m=n.onUnknownSubcommand;if(l&&m){let{positionalIndex:e,name:r}=l;{let i=await m({commandPath:p,name:r,args:t.slice(e+1),precedingArgs:[...n._precedingArgs??[],...t.slice(0,e)]});if(typeof i==`number`){if(o?.stop(),n.handleSignals){if(n._globalCleanup)try{await n._globalCleanup({error:void 0})}catch{}await wn(),process.exit(i)}return i===0?{success:!0,result:void 0,exitCode:0,logs:c()}:{success:!1,error:/* @__PURE__ */ Error(`Plugin "${[...p,r].join(` `)}" exited with code ${i}`),exitCode:i,logs:c()}}}}if(u.helpRequested||u.helpAllRequested||u.helpJsonRequested){let i=!1,s=b(e),l=S(e);if(s.length>0){let e=Vt(t,a.globalExtracted);e&&!l.has(e)&&(i=!0)}let d=yn(n,a);if(u.helpJsonRequested){let t=Qe(e,{context:a,agentHelp:d});r.log(JSON.stringify(t))}else{let t=Xe(e,{showSubcommands:n.showSubcommands??!0,showSubcommandOptions:u.helpAllRequested||n.showSubcommandOptions,context:a,agentHelp:d});r.log(t)}if(o?.stop(),i){let e=Vt(t,a.globalExtracted)??``,n=Zt(e,[...l]),r=n.length>0?` Did you mean: ${n.join(`, `)}?`:``;return{success:!1,error:/* @__PURE__ */ Error(`Unknown subcommand: ${e}${r?`.${r}`:``}`),exitCode:2,logs:c()}}return{success:!0,result:void 0,exitCode:0,logs:c()}}if(u.unknownGlobalFlags&&u.unknownGlobalFlags.length>0){let e=a.globalExtracted?.unknownKeysMode??`strip`;if(e===`strict`)return o?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown flags: ${u.unknownGlobalFlags.join(`, `)}`),exitCode:2,logs:c()};if(e===`strip`){let e=a.globalExtracted?.fields.map(e=>e.name)??[];for(let t of u.unknownGlobalFlags)r.error(Qt(t,e))}}if(u.versionRequested){let e=a.rootVersion;return e&&r.log(e),o?.stop(),{success:!0,result:void 0,exitCode:0,logs:c()}}if(u.subCommand){let r=n._metadataOnly??!1,i=await h(e,u.subCommand,e=>{if(r)return!0;if(!e.requiredPackages?.length)return!1;let t=e,i=u.remainingArgs;for(;;){let e=Ht(i,t,{skipValidation:n.skipValidation,globalExtracted:a.globalExtracted,promptAvailable:!!n.prompt});if(e.helpRequested||e.helpAllRequested||e.helpJsonRequested||e.versionRequested)return r=!0,!0;if(!e.subCommand||!t.subCommands)return!1;let o=Object.hasOwn(t.subCommands,e.subCommand)?e.subCommand:v(t,e.subCommand)??e.subCommand,s=t.subCommands[o],c=s?g(s):null;if(!c)return!1;t=c,i=e.remainingArgs}});if(i){let e={commandPath:[...a.commandPath??[],u.subCommand],rootName:a.rootName,rootVersion:a.rootVersion,globalExtracted:a.globalExtracted,aliasFor:i.aliasFor};o?.stop();let s=new Set(n._globalExtracted?.unknownKeysMode===`passthrough`?[]:u.unknownGlobalFlags??[]),l=e=>e.startsWith(`--`)&&s.has(ne(e)),d=t.slice(0,t.length-u.remainingArgs.length-1).filter(e=>!l(e));return Tn(i.command,u.remainingArgs,{...n,_metadataOnly:r,_context:e,_existingLogs:c(),_parsedGlobalArgs:f,_globalArgLevels:[...n._globalArgLevels??[],u.rawGlobalArgs??{}],_precedingArgs:[...n._precedingArgs??[],...d]})}}let _=u.positionalSlotFields??[],y=_.some(e=>e.type===`array`),ee=[...u.positionals,...u.rest],C=y?[]:ee.slice(_.length),w=y?[]:u.positionals.slice(_.length);if(u.matchesNoUnionOption)return o?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Arguments match none of the accepted forms. See --help for the accepted forms.`),exitCode:2,logs:c()};let T=S(e),E=T.size>0?w.find(e=>!e.startsWith(`-`)&&!T.has(e)):void 0;if(E){let e=Zt(E,[...T]),t=e.length>0?` Did you mean: ${e.join(`, `)}?`:``;return o?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown subcommand: ${E}${t?`.${t}`:``}`),exitCode:2,logs:c()}}if(u.unknownFlags.length>0){let e=u.extractedFields?.unknownKeysMode??a.globalExtracted?.unknownKeysMode??`strip`,t=u.optionFields?.map(e=>e.name)??a.globalExtracted?.fields.map(e=>e.name)??[];if(e===`strict`)return o?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown flags: ${u.unknownFlags.join(`, `)}`),exitCode:2,logs:c()};if(e===`strip`)for(let e of u.unknownFlags)r.error(Qt(e,t))}if(b(e).length>0&&!u.subCommand&&!e.run&&C.length===0){if(e.defaultSubCommand){let r=e.subCommands?.[e.defaultSubCommand];if(r){let i=await x(r),s={commandPath:[...a.commandPath??[],e.defaultSubCommand],rootName:a.rootName,rootVersion:a.rootVersion,globalExtracted:a.globalExtracted};o?.stop();let l=new Set(n._globalExtracted?.unknownKeysMode===`passthrough`?[]:u.unknownGlobalFlags??[]),d=e=>e.startsWith(`--`)&&l.has(ne(e)),p=t.filter(e=>!d(e));return Tn(i,[],{...n,_context:s,_existingLogs:c(),_parsedGlobalArgs:f,_globalArgLevels:[...n._globalArgLevels??[],u.rawGlobalArgs??{}],_precedingArgs:[...n._precedingArgs??[],...p]})}}if(n.globalArgs&&n._globalExtracted){let e={...f};Z(e,n._globalExtracted);let t=Q(e,n.globalArgs),r=t.success?[]:t.errors.filter(t=>t.path[0]&&e[t.path[0]]!==void 0);if(r.length>0)return o?.stop(),{success:!1,error:Error(Yt(r)),exitCode:2,logs:c()}}let i=Xe(e,{showSubcommands:n.showSubcommands??!0,context:a,agentHelp:yn(n,a)});return r.log(i),o?.stop(),{success:!0,result:void 0,exitCode:0,logs:c()}}if(C.length>0){let e=u.extractedFields?.unknownKeysMode??`strip`;if(e===`strict`)return o?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unexpected positional argument${C.length>1?`s`:``}: ${C.join(`, `)}`),exitCode:2,logs:c()};if(e===`strip`)for(let e of C)(r.warn??r.error)(`Warning: Unexpected positional argument: ${e}`)}let D={},O=e.name===`__complete`,k=new Set(Object.keys(f)),A=/* @__PURE__ */ new Set,j=/* @__PURE__ */ new Set;if(n.globalArgs&&n._globalExtracted&&!O){if(A=Z(f,n._globalExtracted),n.prompt){let e=dn(f);try{let e=await n.prompt(f,n._globalExtracted,{globalArgs:f});for(let[t,n]of Object.entries(e))n!==void 0&&(f[t]=n)}finally{let t={};for(let n of/* @__PURE__ */ new Set([...Object.keys(e),...Object.keys(f)])){let r=f[n];se(e[n],r)||(t[n]=r,r===void 0&&(k.delete(n),A.delete(n)))}j=new Set(Object.keys(t).filter(e=>t[e]!==void 0)),n._globalTrace&&(n._globalTrace.promptedGlobalArgs=t)}}let e=Q(f,n.globalArgs);if(!e.success)return o?.stop(),{success:!1,error:Error(Yt(e.errors)),exitCode:2,logs:c()};D=e.data}let M=n.globalArgs&&n._globalExtracted&&!O?i(n._globalExtracted,e=>Q(f,e).success,()=>f):n._globalExtracted,te=O||!n._globalExtracted?void 0:M===n._globalExtracted?d(n._globalExtracted,()=>D).fields:M?.fields;if(!e.args){let t=pn(k,A,j);fn(D,t),mn(D,bn(e,a)),hn(D,n._agent);let r=$(D);return n._globalExtracted&&!O&&(n._globalTrace&&(n._globalTrace.effectsRan=!0),await en(r,M,r)),o?.stop(),await ue(e,r,{handleSignals:n.handleSignals,captureLogs:n.captureLogs,existingLogs:c(),globalCleanup:n._globalCleanup,packageDiscriminators:n._globalExtracted?.discriminator?[n._globalExtracted.discriminator]:[],packageFields:te})}let N=u.rawArgs,re=n.prompt?dn(u.rawArgs):u.rawArgs,P=e=>Object.hasOwn(re,e),ie=/* @__PURE__ */ new Set;if(n.prompt&&u.extractedFields){let e=await n.prompt(N,u.extractedFields,{globalArgs:D}),t={...N};for(let[n,r]of Object.entries(e))r!==void 0&&(t[n]=r);N=t;for(let[e,t]of Object.entries(N))t===void 0||P(e)&&se(re[e],t)||ie.add(e)}let F=Q(N,e.args);if(!F.success)return o?.stop(),{success:!1,error:Error(Yt(F.errors)),exitCode:2,logs:c()};let I=$(F.data),ae=pn(k,A,j);fn(D,ae),mn(D,bn(e,a)),hn(D,n._agent);let L=$(D);n._globalExtracted&&!O&&(n._globalTrace&&(n._globalTrace.effectsRan=!0),await en(L,M,L));let R=u.extractedFields?O?u.extractedFields:i(u.extractedFields,e=>Q(N,e).success,()=>N):void 0;R&&!O&&await en(I,R,L);let z=s({...L},{...I},M?.fields??[],R?.fields??[]),oe=new Map(ae),ce=u.envFallbackFields??/* @__PURE__ */ new Set;for(let e of u.extractedFields?.fields??[]){let t=N[e.name]!==void 0;oe.set(e.name,ie.has(e.name)?`prompt`:t&&ce.has(e.name)?`env`:t&&P(e.name)?`cli`:`default`)}fn(z,oe),mn(z,bn(e,a)),hn(z,n._agent);let le=$(z);return o?.stop(),await ue(e,le,{handleSignals:n.handleSignals,captureLogs:n.captureLogs,existingLogs:c(),globalCleanup:n._globalCleanup,packageDiscriminators:[u.extractedFields?.discriminator,n._globalExtracted?.discriminator].filter(e=>e!==void 0),packageFields:O?void 0:[...te??[],...R!==u.extractedFields&&R?R.fields:[...u.optionFields??[],...u.positionalSlotFields??[]]]})}catch(e){let t=e instanceof Error?e:Error(String(e));return o?.stop(),{success:!1,error:t,exitCode:1,logs:c()}}}function En(e){if(!e.globalArgs)return;let t=a(e.globalArgs);if(!e.skipValidation){_t(t),Ct(t),vt(t),St(t),bt(t,!0),xt(t),ln(t);let e=t.fields.filter(e=>e.positional).map(e=>e.name);if(e.length>0)throw Error(`Global options schema must not contain positional arguments. Found: ${e.join(`, `)}`)}return t}export{ge as A,ct as C,Xe as D,ot as E,Qe as O,at as S,tt as T,xt as _,$ as a,rt as b,Ct as c,kt as d,vt as f,bt as g,yt as h,an as i,B as k,Mt as l,St as m,Cn as n,Yt as o,_t as p,tn as r,Pt as s,xn as t,Et as u,it as v,et as w,nt as x,st as y};
@@ -0,0 +1 @@
1
+ export{t as runCommand}from"./runner-BJCgs-_W.js";
package/dist/skill.js CHANGED
@@ -1,2 +1,2 @@
1
- import{g as e,h as t,n}from"./schema-extractor-BI5ypJ21.js";import{n as r}from"./command-BXsTrIgI.js";import{a as i,n as a}from"./logger-CoeDrmRr.js";import"./register-D-aEK58y.js";import{copyFileSync as o,existsSync as s,lstatSync as c,mkdirSync as l,mkdtempSync as u,readFileSync as d,readdirSync as f,readlinkSync as p,realpathSync as m,renameSync as ee,rmSync as h,statSync as g,symlinkSync as te,unlinkSync as _}from"node:fs";import{basename as v,dirname as y,isAbsolute as b,join as x,parse as ne,relative as S,resolve as C,sep as w}from"node:path";import{parse as re}from"yaml";const ie=/^[a-z0-9]+(-[a-z0-9]+)*$/;function T(e){return e===null?`null`:Array.isArray(e)?`array`:typeof e}function ae(e){let t=[],n=(n,r)=>{let i=e[n];i===void 0?r.required&&t.push({path:[n],message:`Invalid input: expected string, received undefined`}):typeof i==`string`?(r.min!==void 0&&i.length<r.min&&t.push({path:[n],message:`Too small: expected string to have >=${r.min} characters`}),r.max!==void 0&&i.length>r.max&&t.push({path:[n],message:`Too big: expected string to have <=${r.max} characters`})):t.push({path:[n],message:`Invalid input: expected string, received ${T(i)}`})};n(`name`,{required:!0,min:1,max:64}),typeof e.name==`string`&&!ie.test(e.name)&&t.push({path:[`name`],message:`name must be lowercase alphanumerics separated by single hyphens`}),n(`description`,{required:!0,min:1,max:1024}),n(`license`,{min:1}),n(`compatibility`,{max:500}),n(`allowed-tools`,{});let r=e.metadata;if(r!==void 0){if(typeof r!=`object`||!r||Array.isArray(r))t.push({path:[`metadata`],message:`Invalid input: expected record, received ${T(r)}`});else for(let[e,n]of Object.entries(r))typeof n!=`string`&&t.push({path:[`metadata`,e],message:`Invalid input: expected string, received ${T(n)}`})}return t.length>0?{success:!1,issues:t}:{success:!0,data:{...e}}}const oe=/^\uFEFF?---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)([\s\S]*)$/;function E(e){let t=e.match(oe);if(!t)return{data:{},body:e};let n=t[1],r=t[2];try{let e=re(n);return se(e)?{data:e,body:r}:{data:{},body:r}}catch(e){return{data:{},body:r,parseError:e instanceof Error?e.message:String(e)}}}function se(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function ce(e){let{data:t,body:n}=E(e),r=ae(t);return r.success?{frontmatter:r.data,body:n,rawContent:e}:null}const D=`.agents/skills`,O=[`.claude/skills`],k=`politty-cli`;function A(e){if(e.length<1||e.length>64||!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e))throw Error(`Invalid skill name: ${JSON.stringify(e)}`)}function le(e,t=process.cwd(),n={}){let r=e.frontmatter.name;A(r);let i=n.mode??`symlink`,a=e.frontmatter.metadata?.[`politty-cli`]??null;if(i===`copy`&&a===null)throw Error(`Refusing to install "${e.frontmatter.name}" in copy mode without an ownership stamp. Add metadata.${k}="{package}:{cli}" to the source SKILL.md so subsequent installs can replace the copy in place.`);let o=C(t,D),s=m(e.sourcePath),c=ue(e.sourcePath),u=[x(M(o),r),...O.map(e=>x(M(C(t,e)),r))].find(e=>ye(e,s));if(u!==void 0)throw Error(`Refusing to install "${r}": source ${s} overlaps install destination ${u}. Choose a sourceDir outside .agents/skills/ and any agent-specific slot directory (e.g. .claude/skills/).`);if(i===`symlink`){let e=M(o);j(x(e,r),S(e,c));for(let n of O){let i=M(C(t,n));j(x(i,r),x(S(i,e),r))}}l(o,{recursive:!0});let d=m(o),f=x(d,r);he(f,a),ge({linkTarget:S(d,c),linkPath:f,copyFrom:s,mode:i}),ve(t,r,f,a,i)}function j(e,t){if(b(t))throw Error(`Refusing to write an absolute symlink target at ${e} → ${t}. The skill source and install root appear to live on different filesystem roots (e.g. different Windows drive letters); retry with mode: "copy".`)}function ue(e){let t=C(e),{root:n}=ne(t),r=t.slice(n.length).split(w).filter(e=>e!==``),i=n;for(let[e,t]of r.entries()){let n=x(i,t),a;try{a=c(n)}catch{return x(i,...r.slice(e))}if(a.isSymbolicLink()){if(de(i))return x(i,...r.slice(e));i=m(n)}else i=n}return i}function de(e){return v(e)===`node_modules`||v(e).startsWith(`@`)&&v(y(e))===`node_modules`}function M(e){let t=e,n=[];for(;;)try{let e=m(t);return n.length===0?e:C(e,...n.reverse())}catch{let r=y(t);if(r===t)return e;n.push(t.slice(r.length).replace(/^[/\\]+/,``)),t=r}}function fe(e,t=process.cwd(),n={}){A(e);let r=n.expectedOwnership??null,i=C(t,D,e);for(let n of O)me(C(t,n,e),r,{restrictSymlinkTo:i});me(i,r)}function pe(e,t){let n;try{n=p(e)}catch{return!1}let r=b(n)?n:C(y(e),n);if(r===t)return!0;try{return m(r)===m(t)}catch{return!1}}function me(e,t,n={}){let r;try{r=c(e)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return;throw e}if(r.isSymbolicLink()){if(n.restrictSymlinkTo!==void 0){pe(e,n.restrictSymlinkTo)&&_(e);return}(t===null||P(e)===t)&&_(e)}else r.isDirectory()&&t!==null&&P(e)===t&&h(e,{recursive:!0,force:!0})}function he(e,t,n={}){let r;try{r=c(e)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return;throw e}if(r.isSymbolicLink()){if(n.restrictSymlinkTo===void 0||pe(e,n.restrictSymlinkTo)){_(e);return}throw Error(`Refusing to replace symlink at ${e}: it does not route to this CLI's canonical slot (${n.restrictSymlinkTo}). Remove or migrate the foreign symlink before retrying.`)}if(r.isDirectory()&&t!==null&&P(e)===t)h(e,{recursive:!0,force:!0});else throw Error(`Refusing to replace non-symlink path at ${e}. This looks like a legacy or manual install; remove or migrate it before retrying.`)}function ge(e){let{linkTarget:t,linkPath:n,copyFrom:r,mode:i}=e;if(i===`copy`)_e(r,n);else{j(n,t);try{te(t,n,`dir`)}catch(e){let r=e instanceof Error?e.message:String(e);throw Error(`Failed to symlink ${n} → ${t}: ${r}. If this filesystem does not support symlinks (e.g. Windows without Developer Mode), retry with mode: "copy".`,{cause:e})}}}function _e(e,t){let n=u(`${t}.partial-`);try{N(e,n),ee(n,t)}catch(e){try{h(n,{recursive:!0,force:!0})}catch{}throw e}}function N(e,t,n=/* @__PURE__ */ new Set){let r=g(e);if(r.isDirectory()){let r=m(e);if(n.has(r))throw Error(`Refusing to recursively copy cyclic directory symlink at ${e} (resolves to ${r}, already on the copy stack).`);n.add(r);try{l(t,{recursive:!0});for(let r of f(e))N(x(e,r),x(t,r),n)}finally{n.delete(r)}}else r.isFile()&&o(e,t)}function P(e){let t;try{t=d(x(e,`SKILL.md`),`utf-8`)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return null;throw e}let{data:n}=E(t),r=n.metadata;if(!r||typeof r!=`object`||Array.isArray(r))return null;let i=r[k];return typeof i==`string`?i:null}function F(e,t=process.cwd()){return A(e),s(C(t,D,e,`SKILL.md`))}function I(e,t=process.cwd()){A(e);let n=C(t,D,e,`SKILL.md`),r;try{r=d(n,`utf-8`)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return null;throw e}let{data:i}=E(r),a=i.metadata;if(!a||typeof a!=`object`||Array.isArray(a))return null;let o=a[k];return typeof o==`string`?o:null}function ve(e,t,n,r,i){for(let a of O){let o=C(e,a);l(o,{recursive:!0});let s=m(o),c=x(s,t);he(c,r,{restrictSymlinkTo:n});let u=m(C(n,`..`));ge({linkTarget:x(S(s,u),t),linkPath:c,copyFrom:n,mode:i})}}function L(e){return e instanceof Error&&typeof e.code==`string`}function ye(e,t){if(e===t)return!0;let n=(e,t)=>{let n=S(t,e);return n===``||n===`.`||!b(n)&&n!==`..`&&!n.startsWith(`..${w}`)};return n(e,t)||n(t,e)}const R=`SKILL.md`;function z(e){let t=[],n=[];try{let r;try{r=g(e)}catch(r){return H(r)&&(r.code===`ENOENT`||r.code===`ENOTDIR`)?n.push({path:e,reason:`missing-source`,message:`Source directory does not exist: ${e}`}):n.push({path:e,reason:`read-failed`,message:`Failed to stat source directory ${e}: ${V(r)}`}),{skills:t,errors:n}}if(!r.isDirectory())return n.push({path:e,reason:`missing-source`,message:`Source path is not a directory: ${e}`}),{skills:t,errors:n};let i=x(e,R),a=xe(i);if(a.kind===`error`)return n.push({path:e,reason:`read-failed`,message:`Failed to check ${i}: ${a.message}`}),{skills:t,errors:n};if(a.kind===`present`)return be(B(e,{enforceParentMatch:!1}),t,n),{skills:t,errors:n};let o=f(e,{withFileTypes:!0});for(let r of o){let i=x(e,r.name),a;try{a=g(i).isDirectory()}catch(e){if(H(e)&&e.code===`ENOENT`&&!r.isSymbolicLink())continue;n.push({path:i,reason:`read-failed`,message:r.isSymbolicLink()?`Dangling symlink at ${i}: ${V(e)}`:`Failed to stat ${i}: ${V(e)}`});continue}if(!a)continue;let o=x(i,R),s=xe(o);s.kind===`error`?n.push({path:i,reason:`read-failed`,message:`Failed to check ${o}: ${s.message}`}):s.kind!==`absent`&&be(B(i,{enforceParentMatch:!0}),t,n)}}catch(t){n.push({path:e,reason:`read-failed`,message:`Failed to scan ${e}: ${V(t)}`})}return t.sort((e,t)=>e.frontmatter.name<t.frontmatter.name?-1:+(e.frontmatter.name>t.frontmatter.name)),{skills:t,errors:n}}function B(e,t){let n=x(e,R),r;try{r=d(n,`utf-8`)}catch(t){return{path:e,reason:`read-failed`,message:`Failed to read ${n}: ${V(t)}`}}let{data:i,parseError:a}=E(r);if(a!==void 0)return{path:e,reason:`parse-failed`,message:`Invalid SKILL.md frontmatter in ${e}: YAML parse error: ${a}`};let o=ae(i);if(!o.success)return{path:e,reason:`parse-failed`,message:`Invalid SKILL.md frontmatter in ${e}: ${o.issues.map(e=>`${e.path.join(`.`)||`<root>`}: ${e.message}`).join(`; `)}`};if(t.enforceParentMatch){let t=v(e);if(t!==o.data.name)return{path:e,reason:`name-mismatch`,message:`Skill name "${o.data.name}" does not match directory "${t}"`,skillName:o.data.name}}return{frontmatter:o.data,sourcePath:e,rawContent:r}}function be(e,t,n){`frontmatter`in e?t.push(e):n.push(e)}function V(e){return e instanceof Error?e.message:String(e)}function H(e){return e instanceof Error&&typeof e.code==`string`}function xe(e){try{return c(e),{kind:`present`}}catch(e){return H(e)&&e.code===`ENOENT`?{kind:`absent`}:{kind:`error`,message:V(e)}}}function Se(e,t={}){let n=0,r=!1;for(let i of e)i.reason===`missing-source`||i.path===t.sourceDir?(r=!0,a.warn(`Failed to scan source directory ${i.path}: ${i.message}`)):(n+=1,a.warn(`Skipping skill at ${i.path}: ${i.message}`));t.silentStdout||(n>0&&a.info(`${i.warning} Skipped ${n} skill(s) due to scan errors (see warnings above).`),r&&a.info(`${i.warning} Source directory scan failed (see warnings above); subsequent operations may be skipped.`))}function U(e,t){let n=e.errors.some(e=>e.reason===`missing-source`||e.path===t),r=e.errors.length>0&&e.skills.length===0;return n||r}function W(e,t={}){let n=z(e.sourceDir);return Se(n.errors,{...t,sourceDir:e.sourceDir}),n}function Ce(e){let t={description:`Skill names to exclude from sync`};return e.excludeAlias!==void 0&&(t.alias=e.excludeAlias),t}function G(e){let t={description:`Print install paths and modes`};return e.verbose.alias!==void 0&&(t.alias=e.verbose.alias),t}function K(e,t){return!!e[t]}function we(n){function i(e,t){let{skills:r,errors:i}=W(n),o=n.stamp,s=new Set(r.map(e=>e.frontmatter.name)),c=new Set(Pe(o,n.cwd,n.sourceDir)),l=Array.from(new Set(e.exclude)).filter(e=>!s.has(e)&&!c.has(e));if(l.length>0){let e=l.length===1?`Skill`:`Skills`,t=l.map(e=>JSON.stringify(e)).join(`, `);throw Error(`--exclude: ${e} ${t} not found in source directory or among installed skills.\n`+J({source:r,installed:c}))}let u=new Set(e.exclude),d=r.filter(e=>!u.has(e.frontmatter.name)),f=U({skills:r,errors:i},n.sourceDir),p=0;if(!f){let e=new Set(d.map(e=>e.frontmatter.name)),t=/* @__PURE__ */ new Set;for(let e of i)e.path!==n.sourceDir&&(t.add(v(e.path)),e.skillName!==void 0&&t.add(e.skillName));for(let r of c)e.has(r)||u.has(r)||t.has(r)||(X(r,o,n.cwd,n.sourceDir),p+=1)}let m=0;for(let e of d)Y(e,o,n,t),m+=1;if(m===0&&p===0){let e=f?`source directory scan failed; see warnings`:r.length>0&&d.length===0?`all skills excluded`:`no skills bundled`;a.info(`No skills installed (${e}).`)}else a.info(`Sync complete: ${m} installed, ${p} removed.`)}return n.verbose.disabled?r({name:`sync`,description:n.descriptions.sync,args:t({exclude:e.stringArray(Ce(n))},{unknownKeys:n.unknownKeys}),run(e){i(e,K(e,`verbose`))}}):r({name:`sync`,description:n.descriptions.sync,args:t({exclude:e.stringArray(Ce(n)),verbose:e.boolean(G(n))},{unknownKeys:n.unknownKeys}),run(e){i(e,e.verbose)}})}function Te(n){let i={positional:!0,description:`Skill name(s) to install (default: all)`,placeholder:`NAME`};function o(e,t){let r=W(n),i=r.skills,o=n.stamp;if(e.name.length>0){let r=new Set(i.map(e=>e.frontmatter.name)),a=Array.from(new Set(e.name)),s=a.filter(e=>!r.has(e));if(s.length>0){let e=s.length===1?`Skill`:`Skills`,t=s.map(e=>JSON.stringify(e)).join(`, `);throw Error(`${e} ${t} not found in source directory.\n`+J({source:i}))}let c=new Set(a);for(let e of i)c.has(e.frontmatter.name)&&Y(e,o,n,t)}else if(i.length===0)U(r,n.sourceDir)?a.info(`No skills installed (source directory scan failed; see warnings).`):a.info(`No skills found in source directory.`);else for(let e of i)Y(e,o,n,t)}return n.verbose.disabled?r({name:n.commandNames.add.name,...n.commandNames.add.aliases.length>0?{aliases:n.commandNames.add.aliases}:{},description:n.descriptions.add,args:t({name:e.stringArray(i)},{unknownKeys:n.unknownKeys}),run(e){o(e,K(e,`verbose`))}}):r({name:n.commandNames.add.name,...n.commandNames.add.aliases.length>0?{aliases:n.commandNames.add.aliases}:{},description:n.descriptions.add,args:t({name:e.stringArray(i),verbose:e.boolean(G(n))},{unknownKeys:n.unknownKeys}),run(e){o(e,e.verbose)}})}function Ee(n){return r({name:n.commandNames.remove.name,...n.commandNames.remove.aliases.length>0?{aliases:n.commandNames.remove.aliases}:{},description:n.descriptions.remove,args:t({name:e.optionalString({positional:!0,description:`Skill name to remove (default: all)`,placeholder:`NAME`})},{unknownKeys:n.unknownKeys}),run(e){let t=W(n),r=t.skills,i=n.stamp;if(e.name){if(r.some(t=>t.frontmatter.name===e.name)&&Ae(r,e.name),!X(e.name,i,n.cwd,n.sourceDir)){if(q(e.name,n.cwd))a.info(`${e.name} is installed without a ${k} stamp this CLI recognises; refusing to remove. Remove .agents/skills/${e.name} manually if intended.`);else{let t=new Set(Pe(i,n.cwd,n.sourceDir));a.info(`${e.name} is not installed; nothing to remove.\n`+J({installed:t}))}}return}if(r.length===0){U(t,n.sourceDir)?a.info(`No skills found (source directory scan failed; see warnings); nothing to remove.`):a.info(`No skills found in source directory; nothing to remove.`);return}let o=0;for(let e of r)X(e.frontmatter.name,i,n.cwd,n.sourceDir)&&(o+=1);o===0&&a.info(`No installed skills owned by this CLI; nothing to remove.`)}})}function De(e,t,n,r){let i;try{i=I(e,n)}catch(t){return a.warn(`Failed to read ownership for installed skill ${e}: ${Oe(t)}`),`unreadable`}if(i===t)return`installed`;if(i!==null)return`foreign`;if(!F(e,n)){let t=C(n,D,e);return Q(t)&&Z(t,r)?`missing`:q(e,n)?`unstamped`:`not-installed`}return`unstamped`}function Oe(e){return e instanceof Error?e.message:String(e)}function q(e,t){try{return c(C(t,D,e)),!0}catch{return!1}}function ke(n){function i(e){let t=W(n,{silentStdout:e}),r=t.skills,i=n.stamp;if(e)console.log(JSON.stringify(r.map(e=>({name:e.frontmatter.name,description:e.frontmatter.description,owner:e.frontmatter.metadata?.[`politty-cli`]??null,expectedOwner:i,status:De(e.frontmatter.name,i,n.cwd,n.sourceDir),sourcePath:e.sourcePath}))));else if(r.length===0)U(t,n.sourceDir)?a.info(`Source directory scan failed; see warnings.`):a.info(`No skills found in source directory.`);else{a.info(`Available skills:`);for(let e of r){let t=De(e.frontmatter.name,i,n.cwd,n.sourceDir);a.info(` ${e.frontmatter.name.padEnd(20)} ${t.padEnd(14)} ${e.frontmatter.description}`)}}}return n.json.disabled?r({name:`list`,description:n.descriptions.list,args:t({},{unknownKeys:n.unknownKeys}),run(e){i(K(e,`json`))}}):r({name:`list`,description:n.descriptions.list,args:t({json:e.boolean({description:`Output as JSON`})},{unknownKeys:n.unknownKeys}),run(e){i(e.json)}})}function Ae(e,t){let n=e.find(e=>e.frontmatter.name===t);if(!n){let n=e.map(e=>e.frontmatter.name).join(`, `)||`<none>`;throw Error(`Skill "${t}" not found in source directory. Available: ${n}`)}return n}function J(e){let t=[];return e.source!==void 0&&t.push(` Source: ${e.source.map(e=>e.frontmatter.name).join(`, `)||`<none>`}`),e.installed!==void 0&&t.push(` Installed: ${[...e.installed].sort().join(`, `)||`<none>`}`),t.join(`
2
- `)}function Y(e,t,n,r){let o=e.frontmatter.name,s=n.cwd,c=n.mode,l=e.frontmatter.metadata?.[`politty-cli`]??null;if(l!==t)throw Error(`Refusing to install "${o}": source SKILL.md declares metadata.${k}=${JSON.stringify(l)}, expected ${JSON.stringify(t)}.`);let u=I(o,s);if(u!==null&&u!==t)throw Error(`Refusing to install "${o}": owned by ${JSON.stringify(u)}, not ${JSON.stringify(t)}. Check metadata.${k} in .agents/skills/${o}/SKILL.md.`);let d=C(s,D,o),f=Q(d)&&Z(d,n.sourceDir);if(u===null&&q(o,s)&&!f)throw Error(`Refusing to install "${o}": .agents/skills/${o} exists without a ${k} stamp, so it was not installed by this CLI. Remove it manually (or add the stamp to take ownership) before running "skills add".`);if(le(e,s,c===void 0?{}:{mode:c}),a.info(`${i.success} Installed ${o}`),r){let e=c??`symlink`;a.info(` mode=${e} path=${d}`)}}function X(e,t,n,r){let o=I(e,n);if(o===null)return je(e,n,r)?(a.info(`${i.success} Removed ${e} (broken symlink)`),!0):!1;if(o!==t)throw Error(`Refusing to remove "${e}": owned by ${JSON.stringify(o)}, not ${JSON.stringify(t)}. Check metadata.${k} in .agents/skills/${e}/SKILL.md.`);return fe(e,n,{expectedOwnership:t}),a.info(`${i.success} Removed ${e}`),!0}function je(e,t,n){let r=C(t,D,e);if(!Q(r)||!Z(r,n))return!1;for(let n of O){let i=C(t,n,e);Q(i)&&Ne(i,r)&&_(i)}return _(r),!0}function Z(e,t){let n;try{n=p(e)}catch{return!1}let r=b(n)?n:C(y(e),n),i=Me(C(t)),a=Me(r),o=S(i,a);return!(b(o)||o===`..`||o.startsWith(`..${w}`))}function Me(e){let t=e,n=[];for(;;)try{let e=m(t);return n.length===0?e:C(e,...n.reverse())}catch{let r=y(t);if(r===t)return e;n.push(t.slice(r.length).replace(/^[/\\]+/,``)),t=r}}function Ne(e,t){let n;try{n=p(e)}catch{return!1}let r=b(n)?n:C(y(e),n);if(r===t)return!0;try{return m(r)===m(t)}catch{return!1}}function Q(e){let t;try{t=c(e)}catch{return!1}return t.isSymbolicLink()?!s(e):!1}function Pe(e,t,n){let r=C(t,D),i=[],o;try{o=f(r,{withFileTypes:!0})}catch(e){let t=e.code;return t===`ENOENT`||t===`ENOTDIR`||a.warn(`Failed to enumerate ${r}: ${e instanceof Error?e.message:String(e)}`),i}for(let s of o){if(!s.isDirectory()&&!s.isSymbolicLink()||s.name.length<1||s.name.length>64||!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(s.name))continue;let o;try{o=I(s.name,t)}catch(e){a.warn(`Failed to read ownership for ${s.name}: ${e instanceof Error?e.message:String(e)}`);continue}if(o===e){i.push(s.name);continue}let c=C(r,s.name);o===null&&Q(c)&&Z(c,n)&&i.push(s.name)}return i}const Fe=[`add`,`install`],Ie=[`remove`,`uninstall`],$={skills:`Manage agent skills`,sync:`Remove and reinstall all skills from source`,add:`Install skills from source`,remove:`Remove installed skills`,list:`List available skills from source`},Le=/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/,Re=[`.git`,`package.json`];function ze(e,t){return{sourceDir:e.sourceDir,package:e.package,mode:e.mode,cwd:Ve(e.cwd),excludeAlias:Ue(e.flags?.exclude?.alias),verbose:Ge(e.flags?.verbose,e.globalArgs),json:{disabled:Ke(e.globalArgs,`json`)},commandNames:{add:We(e.commandMap?.add,Fe,`add`),remove:We(e.commandMap?.remove,Ie,`remove`)},unknownKeys:e.unknownKeys??`strip`,descriptionAppend:qe(e.descriptionAppend,t),stamp:`${e.package}:${t}`,descriptions:Be(e.descriptions)}}function Be(e){return{skills:e?.skills??$.skills,sync:e?.sync??$.sync,add:e?.add??$.add,remove:e?.remove??$.remove,list:e?.list??$.list}}function Ve(e){if(e!==void 0)return C(e);let t=process.cwd();return He(t)??t}function He(e){let t=C(e);for(;;){for(let e of Re)if(s(C(t,e)))return t;let e=y(t);if(e===t)return null;t=e}}function Ue(e){if(e!==!1)return typeof e==`string`?e:`x`}function We(e,t,n){let r=e??t;if(r.length===0)throw Error(`SkillCommandOptions.commandMap.${n} must include at least one name.`);let i=r.find(e=>!Le.test(e));if(i!==void 0)throw Error(`SkillCommandOptions.commandMap.${n} contains an invalid entry ${JSON.stringify(i)}. Names/aliases must start with an alphanumeric character and contain only alphanumeric characters, hyphens, or underscores.`);return{name:r[0],aliases:r.slice(1)}}function Ge(e,t){return{alias:e?.alias===!1?void 0:e?.alias??`v`,disabled:Ke(t,`verbose`)}}function Ke(e,t){return e?n(e).fields.some(e=>e.name===t&&e.named&&e.type===`boolean`):!1}function qe(e,t){return e===!1?!1:typeof e==`string`?e:`Manage agent skills with \`${t} skills <add|sync|remove|list>\`.`}const Je=[`parse-failed`,`name-mismatch`,`read-failed`,`missing-source`];function Ye(e,t){if(e.subCommands&&Object.hasOwn(e.subCommands,`skills`))throw Error(`withSkillCommand: command "${e.name}" already defines a "skills" subcommand.`);let n=ze(t,e.name),i=n.commandNames.add.name,a=n.commandNames.remove.name,o=[`sync`,`list`,i,...n.commandNames.add.aliases,a,...n.commandNames.remove.aliases],s=o.find((e,t)=>o.indexOf(e)!==t);if(s)throw Error(`withSkillCommand: commandMap produced duplicate subcommand name/alias "${s}".`);let c=r({name:`skills`,description:n.descriptions.skills,subCommands:{sync:we(n),[i]:Te(n),[a]:Ee(n),list:ke(n)}});return{...e,description:Xe(e.description,n.descriptionAppend),subCommands:{...e.subCommands,skills:c}}}function Xe(e,t){return t===!1||t===``?e:e?e.endsWith(t)?e:`${e}\n\n${t}`:t}export{k as OWNERSHIP_METADATA_KEY,Je as SCAN_ERROR_REASONS,F as hasInstalledSkill,le as installSkill,E as parseFrontmatter,ce as parseSkillMd,I as readInstalledOwnership,z as scanSourceDir,fe as uninstallSkill,Ye as withSkillCommand};
1
+ import"./register-D-aEK58y.js";import{n as e}from"./command-BXsTrIgI.js";import{g as t,h as n,n as r}from"./schema-extractor-BI5ypJ21.js";import{a as i,n as a}from"./logger-CoeDrmRr.js";import{copyFileSync as o,existsSync as s,lstatSync as c,mkdirSync as l,mkdtempSync as u,readFileSync as d,readdirSync as f,readlinkSync as p,realpathSync as m,renameSync as ee,rmSync as h,statSync as g,symlinkSync as te,unlinkSync as _}from"node:fs";import{basename as v,dirname as y,isAbsolute as b,join as x,parse as ne,relative as S,resolve as C,sep as w}from"node:path";import{parse as re}from"yaml";const ie=/^[a-z0-9]+(-[a-z0-9]+)*$/;function T(e){return e===null?`null`:Array.isArray(e)?`array`:typeof e}function ae(e){let t=[],n=(n,r)=>{let i=e[n];i===void 0?r.required&&t.push({path:[n],message:`Invalid input: expected string, received undefined`}):typeof i==`string`?(r.min!==void 0&&i.length<r.min&&t.push({path:[n],message:`Too small: expected string to have >=${r.min} characters`}),r.max!==void 0&&i.length>r.max&&t.push({path:[n],message:`Too big: expected string to have <=${r.max} characters`})):t.push({path:[n],message:`Invalid input: expected string, received ${T(i)}`})};n(`name`,{required:!0,min:1,max:64}),typeof e.name==`string`&&!ie.test(e.name)&&t.push({path:[`name`],message:`name must be lowercase alphanumerics separated by single hyphens`}),n(`description`,{required:!0,min:1,max:1024}),n(`license`,{min:1}),n(`compatibility`,{max:500}),n(`allowed-tools`,{});let r=e.metadata;if(r!==void 0){if(typeof r!=`object`||!r||Array.isArray(r))t.push({path:[`metadata`],message:`Invalid input: expected record, received ${T(r)}`});else for(let[e,n]of Object.entries(r))typeof n!=`string`&&t.push({path:[`metadata`,e],message:`Invalid input: expected string, received ${T(n)}`})}return t.length>0?{success:!1,issues:t}:{success:!0,data:{...e}}}const oe=/^\uFEFF?---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)([\s\S]*)$/;function E(e){let t=e.match(oe);if(!t)return{data:{},body:e};let n=t[1],r=t[2];try{let e=re(n);return se(e)?{data:e,body:r}:{data:{},body:r}}catch(e){return{data:{},body:r,parseError:e instanceof Error?e.message:String(e)}}}function se(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function ce(e){let{data:t,body:n}=E(e),r=ae(t);return r.success?{frontmatter:r.data,body:n,rawContent:e}:null}const D=`.agents/skills`,O=[`.claude/skills`],k=`politty-cli`;function A(e){if(e.length<1||e.length>64||!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e))throw Error(`Invalid skill name: ${JSON.stringify(e)}`)}function le(e,t=process.cwd(),n={}){let r=e.frontmatter.name;A(r);let i=n.mode??`symlink`,a=e.frontmatter.metadata?.[`politty-cli`]??null;if(i===`copy`&&a===null)throw Error(`Refusing to install "${e.frontmatter.name}" in copy mode without an ownership stamp. Add metadata.${k}="{package}:{cli}" to the source SKILL.md so subsequent installs can replace the copy in place.`);let o=C(t,D),s=m(e.sourcePath),c=ue(e.sourcePath),u=[x(M(o),r),...O.map(e=>x(M(C(t,e)),r))].find(e=>ye(e,s));if(u!==void 0)throw Error(`Refusing to install "${r}": source ${s} overlaps install destination ${u}. Choose a sourceDir outside .agents/skills/ and any agent-specific slot directory (e.g. .claude/skills/).`);if(i===`symlink`){let e=M(o);j(x(e,r),S(e,c));for(let n of O){let i=M(C(t,n));j(x(i,r),x(S(i,e),r))}}l(o,{recursive:!0});let d=m(o),f=x(d,r);he(f,a),ge({linkTarget:S(d,c),linkPath:f,copyFrom:s,mode:i}),ve(t,r,f,a,i)}function j(e,t){if(b(t))throw Error(`Refusing to write an absolute symlink target at ${e} → ${t}. The skill source and install root appear to live on different filesystem roots (e.g. different Windows drive letters); retry with mode: "copy".`)}function ue(e){let t=C(e),{root:n}=ne(t),r=t.slice(n.length).split(w).filter(e=>e!==``),i=n;for(let[e,t]of r.entries()){let n=x(i,t),a;try{a=c(n)}catch{return x(i,...r.slice(e))}if(a.isSymbolicLink()){if(de(i))return x(i,...r.slice(e));i=m(n)}else i=n}return i}function de(e){return v(e)===`node_modules`||v(e).startsWith(`@`)&&v(y(e))===`node_modules`}function M(e){let t=e,n=[];for(;;)try{let e=m(t);return n.length===0?e:C(e,...n.reverse())}catch{let r=y(t);if(r===t)return e;n.push(t.slice(r.length).replace(/^[/\\]+/,``)),t=r}}function fe(e,t=process.cwd(),n={}){A(e);let r=n.expectedOwnership??null,i=C(t,D,e);for(let n of O)me(C(t,n,e),r,{restrictSymlinkTo:i});me(i,r)}function pe(e,t){let n;try{n=p(e)}catch{return!1}let r=b(n)?n:C(y(e),n);if(r===t)return!0;try{return m(r)===m(t)}catch{return!1}}function me(e,t,n={}){let r;try{r=c(e)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return;throw e}if(r.isSymbolicLink()){if(n.restrictSymlinkTo!==void 0){pe(e,n.restrictSymlinkTo)&&_(e);return}(t===null||P(e)===t)&&_(e)}else r.isDirectory()&&t!==null&&P(e)===t&&h(e,{recursive:!0,force:!0})}function he(e,t,n={}){let r;try{r=c(e)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return;throw e}if(r.isSymbolicLink()){if(n.restrictSymlinkTo===void 0||pe(e,n.restrictSymlinkTo)){_(e);return}throw Error(`Refusing to replace symlink at ${e}: it does not route to this CLI's canonical slot (${n.restrictSymlinkTo}). Remove or migrate the foreign symlink before retrying.`)}if(r.isDirectory()&&t!==null&&P(e)===t)h(e,{recursive:!0,force:!0});else throw Error(`Refusing to replace non-symlink path at ${e}. This looks like a legacy or manual install; remove or migrate it before retrying.`)}function ge(e){let{linkTarget:t,linkPath:n,copyFrom:r,mode:i}=e;if(i===`copy`)_e(r,n);else{j(n,t);try{te(t,n,`dir`)}catch(e){let r=e instanceof Error?e.message:String(e);throw Error(`Failed to symlink ${n} → ${t}: ${r}. If this filesystem does not support symlinks (e.g. Windows without Developer Mode), retry with mode: "copy".`,{cause:e})}}}function _e(e,t){let n=u(`${t}.partial-`);try{N(e,n),ee(n,t)}catch(e){try{h(n,{recursive:!0,force:!0})}catch{}throw e}}function N(e,t,n=/* @__PURE__ */ new Set){let r=g(e);if(r.isDirectory()){let r=m(e);if(n.has(r))throw Error(`Refusing to recursively copy cyclic directory symlink at ${e} (resolves to ${r}, already on the copy stack).`);n.add(r);try{l(t,{recursive:!0});for(let r of f(e))N(x(e,r),x(t,r),n)}finally{n.delete(r)}}else r.isFile()&&o(e,t)}function P(e){let t;try{t=d(x(e,`SKILL.md`),`utf-8`)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return null;throw e}let{data:n}=E(t),r=n.metadata;if(!r||typeof r!=`object`||Array.isArray(r))return null;let i=r[k];return typeof i==`string`?i:null}function F(e,t=process.cwd()){return A(e),s(C(t,D,e,`SKILL.md`))}function I(e,t=process.cwd()){A(e);let n=C(t,D,e,`SKILL.md`),r;try{r=d(n,`utf-8`)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return null;throw e}let{data:i}=E(r),a=i.metadata;if(!a||typeof a!=`object`||Array.isArray(a))return null;let o=a[k];return typeof o==`string`?o:null}function ve(e,t,n,r,i){for(let a of O){let o=C(e,a);l(o,{recursive:!0});let s=m(o),c=x(s,t);he(c,r,{restrictSymlinkTo:n});let u=m(C(n,`..`));ge({linkTarget:x(S(s,u),t),linkPath:c,copyFrom:n,mode:i})}}function L(e){return e instanceof Error&&typeof e.code==`string`}function ye(e,t){if(e===t)return!0;let n=(e,t)=>{let n=S(t,e);return n===``||n===`.`||!b(n)&&n!==`..`&&!n.startsWith(`..${w}`)};return n(e,t)||n(t,e)}const R=`SKILL.md`;function z(e){let t=[],n=[];try{let r;try{r=g(e)}catch(r){return H(r)&&(r.code===`ENOENT`||r.code===`ENOTDIR`)?n.push({path:e,reason:`missing-source`,message:`Source directory does not exist: ${e}`}):n.push({path:e,reason:`read-failed`,message:`Failed to stat source directory ${e}: ${V(r)}`}),{skills:t,errors:n}}if(!r.isDirectory())return n.push({path:e,reason:`missing-source`,message:`Source path is not a directory: ${e}`}),{skills:t,errors:n};let i=x(e,R),a=xe(i);if(a.kind===`error`)return n.push({path:e,reason:`read-failed`,message:`Failed to check ${i}: ${a.message}`}),{skills:t,errors:n};if(a.kind===`present`)return be(B(e,{enforceParentMatch:!1}),t,n),{skills:t,errors:n};let o=f(e,{withFileTypes:!0});for(let r of o){let i=x(e,r.name),a;try{a=g(i).isDirectory()}catch(e){if(H(e)&&e.code===`ENOENT`&&!r.isSymbolicLink())continue;n.push({path:i,reason:`read-failed`,message:r.isSymbolicLink()?`Dangling symlink at ${i}: ${V(e)}`:`Failed to stat ${i}: ${V(e)}`});continue}if(!a)continue;let o=x(i,R),s=xe(o);s.kind===`error`?n.push({path:i,reason:`read-failed`,message:`Failed to check ${o}: ${s.message}`}):s.kind!==`absent`&&be(B(i,{enforceParentMatch:!0}),t,n)}}catch(t){n.push({path:e,reason:`read-failed`,message:`Failed to scan ${e}: ${V(t)}`})}return t.sort((e,t)=>e.frontmatter.name<t.frontmatter.name?-1:+(e.frontmatter.name>t.frontmatter.name)),{skills:t,errors:n}}function B(e,t){let n=x(e,R),r;try{r=d(n,`utf-8`)}catch(t){return{path:e,reason:`read-failed`,message:`Failed to read ${n}: ${V(t)}`}}let{data:i,parseError:a}=E(r);if(a!==void 0)return{path:e,reason:`parse-failed`,message:`Invalid SKILL.md frontmatter in ${e}: YAML parse error: ${a}`};let o=ae(i);if(!o.success)return{path:e,reason:`parse-failed`,message:`Invalid SKILL.md frontmatter in ${e}: ${o.issues.map(e=>`${e.path.join(`.`)||`<root>`}: ${e.message}`).join(`; `)}`};if(t.enforceParentMatch){let t=v(e);if(t!==o.data.name)return{path:e,reason:`name-mismatch`,message:`Skill name "${o.data.name}" does not match directory "${t}"`,skillName:o.data.name}}return{frontmatter:o.data,sourcePath:e,rawContent:r}}function be(e,t,n){`frontmatter`in e?t.push(e):n.push(e)}function V(e){return e instanceof Error?e.message:String(e)}function H(e){return e instanceof Error&&typeof e.code==`string`}function xe(e){try{return c(e),{kind:`present`}}catch(e){return H(e)&&e.code===`ENOENT`?{kind:`absent`}:{kind:`error`,message:V(e)}}}function Se(e,t={}){let n=0,r=!1;for(let i of e)i.reason===`missing-source`||i.path===t.sourceDir?(r=!0,a.warn(`Failed to scan source directory ${i.path}: ${i.message}`)):(n+=1,a.warn(`Skipping skill at ${i.path}: ${i.message}`));t.silentStdout||(n>0&&a.info(`${i.warning} Skipped ${n} skill(s) due to scan errors (see warnings above).`),r&&a.info(`${i.warning} Source directory scan failed (see warnings above); subsequent operations may be skipped.`))}function U(e,t){let n=e.errors.some(e=>e.reason===`missing-source`||e.path===t),r=e.errors.length>0&&e.skills.length===0;return n||r}function W(e,t={}){let n=z(e.sourceDir);return Se(n.errors,{...t,sourceDir:e.sourceDir}),n}function Ce(e){let t={description:`Skill names to exclude from sync`};return e.excludeAlias!==void 0&&(t.alias=e.excludeAlias),t}function G(e){let t={description:`Print install paths and modes`};return e.verbose.alias!==void 0&&(t.alias=e.verbose.alias),t}function K(e,t){return!!e[t]}function we(r){function i(e,t){let{skills:n,errors:i}=W(r),o=r.stamp,s=new Set(n.map(e=>e.frontmatter.name)),c=new Set(Pe(o,r.cwd,r.sourceDir)),l=Array.from(new Set(e.exclude)).filter(e=>!s.has(e)&&!c.has(e));if(l.length>0){let e=l.length===1?`Skill`:`Skills`,t=l.map(e=>JSON.stringify(e)).join(`, `);throw Error(`--exclude: ${e} ${t} not found in source directory or among installed skills.\n`+J({source:n,installed:c}))}let u=new Set(e.exclude),d=n.filter(e=>!u.has(e.frontmatter.name)),f=U({skills:n,errors:i},r.sourceDir),p=0;if(!f){let e=new Set(d.map(e=>e.frontmatter.name)),t=/* @__PURE__ */ new Set;for(let e of i)e.path!==r.sourceDir&&(t.add(v(e.path)),e.skillName!==void 0&&t.add(e.skillName));for(let n of c)e.has(n)||u.has(n)||t.has(n)||(X(n,o,r.cwd,r.sourceDir),p+=1)}let m=0;for(let e of d)Y(e,o,r,t),m+=1;if(m===0&&p===0){let e=f?`source directory scan failed; see warnings`:n.length>0&&d.length===0?`all skills excluded`:`no skills bundled`;a.info(`No skills installed (${e}).`)}else a.info(`Sync complete: ${m} installed, ${p} removed.`)}return r.verbose.disabled?e({name:`sync`,description:r.descriptions.sync,args:n({exclude:t.stringArray(Ce(r))},{unknownKeys:r.unknownKeys}),run(e){i(e,K(e,`verbose`))}}):e({name:`sync`,description:r.descriptions.sync,args:n({exclude:t.stringArray(Ce(r)),verbose:t.boolean(G(r))},{unknownKeys:r.unknownKeys}),run(e){i(e,e.verbose)}})}function Te(r){let i={positional:!0,description:`Skill name(s) to install (default: all)`,placeholder:`NAME`};function o(e,t){let n=W(r),i=n.skills,o=r.stamp;if(e.name.length>0){let n=new Set(i.map(e=>e.frontmatter.name)),a=Array.from(new Set(e.name)),s=a.filter(e=>!n.has(e));if(s.length>0){let e=s.length===1?`Skill`:`Skills`,t=s.map(e=>JSON.stringify(e)).join(`, `);throw Error(`${e} ${t} not found in source directory.\n`+J({source:i}))}let c=new Set(a);for(let e of i)c.has(e.frontmatter.name)&&Y(e,o,r,t)}else if(i.length===0)U(n,r.sourceDir)?a.info(`No skills installed (source directory scan failed; see warnings).`):a.info(`No skills found in source directory.`);else for(let e of i)Y(e,o,r,t)}return r.verbose.disabled?e({name:r.commandNames.add.name,...r.commandNames.add.aliases.length>0?{aliases:r.commandNames.add.aliases}:{},description:r.descriptions.add,args:n({name:t.stringArray(i)},{unknownKeys:r.unknownKeys}),run(e){o(e,K(e,`verbose`))}}):e({name:r.commandNames.add.name,...r.commandNames.add.aliases.length>0?{aliases:r.commandNames.add.aliases}:{},description:r.descriptions.add,args:n({name:t.stringArray(i),verbose:t.boolean(G(r))},{unknownKeys:r.unknownKeys}),run(e){o(e,e.verbose)}})}function Ee(r){return e({name:r.commandNames.remove.name,...r.commandNames.remove.aliases.length>0?{aliases:r.commandNames.remove.aliases}:{},description:r.descriptions.remove,args:n({name:t.optionalString({positional:!0,description:`Skill name to remove (default: all)`,placeholder:`NAME`})},{unknownKeys:r.unknownKeys}),run(e){let t=W(r),n=t.skills,i=r.stamp;if(e.name){if(n.some(t=>t.frontmatter.name===e.name)&&Ae(n,e.name),!X(e.name,i,r.cwd,r.sourceDir)){if(q(e.name,r.cwd))a.info(`${e.name} is installed without a ${k} stamp this CLI recognises; refusing to remove. Remove .agents/skills/${e.name} manually if intended.`);else{let t=new Set(Pe(i,r.cwd,r.sourceDir));a.info(`${e.name} is not installed; nothing to remove.\n`+J({installed:t}))}}return}if(n.length===0){U(t,r.sourceDir)?a.info(`No skills found (source directory scan failed; see warnings); nothing to remove.`):a.info(`No skills found in source directory; nothing to remove.`);return}let o=0;for(let e of n)X(e.frontmatter.name,i,r.cwd,r.sourceDir)&&(o+=1);o===0&&a.info(`No installed skills owned by this CLI; nothing to remove.`)}})}function De(e,t,n,r){let i;try{i=I(e,n)}catch(t){return a.warn(`Failed to read ownership for installed skill ${e}: ${Oe(t)}`),`unreadable`}if(i===t)return`installed`;if(i!==null)return`foreign`;if(!F(e,n)){let t=C(n,D,e);return Q(t)&&Z(t,r)?`missing`:q(e,n)?`unstamped`:`not-installed`}return`unstamped`}function Oe(e){return e instanceof Error?e.message:String(e)}function q(e,t){try{return c(C(t,D,e)),!0}catch{return!1}}function ke(r){function i(e){let t=W(r,{silentStdout:e}),n=t.skills,i=r.stamp;if(e)console.log(JSON.stringify(n.map(e=>({name:e.frontmatter.name,description:e.frontmatter.description,owner:e.frontmatter.metadata?.[`politty-cli`]??null,expectedOwner:i,status:De(e.frontmatter.name,i,r.cwd,r.sourceDir),sourcePath:e.sourcePath}))));else if(n.length===0)U(t,r.sourceDir)?a.info(`Source directory scan failed; see warnings.`):a.info(`No skills found in source directory.`);else{a.info(`Available skills:`);for(let e of n){let t=De(e.frontmatter.name,i,r.cwd,r.sourceDir);a.info(` ${e.frontmatter.name.padEnd(20)} ${t.padEnd(14)} ${e.frontmatter.description}`)}}}return r.json.disabled?e({name:`list`,description:r.descriptions.list,args:n({},{unknownKeys:r.unknownKeys}),run(e){i(K(e,`json`))}}):e({name:`list`,description:r.descriptions.list,args:n({json:t.boolean({description:`Output as JSON`})},{unknownKeys:r.unknownKeys}),run(e){i(e.json)}})}function Ae(e,t){let n=e.find(e=>e.frontmatter.name===t);if(!n){let n=e.map(e=>e.frontmatter.name).join(`, `)||`<none>`;throw Error(`Skill "${t}" not found in source directory. Available: ${n}`)}return n}function J(e){let t=[];return e.source!==void 0&&t.push(` Source: ${e.source.map(e=>e.frontmatter.name).join(`, `)||`<none>`}`),e.installed!==void 0&&t.push(` Installed: ${[...e.installed].sort().join(`, `)||`<none>`}`),t.join(`
2
+ `)}function Y(e,t,n,r){let o=e.frontmatter.name,s=n.cwd,c=n.mode,l=e.frontmatter.metadata?.[`politty-cli`]??null;if(l!==t)throw Error(`Refusing to install "${o}": source SKILL.md declares metadata.${k}=${JSON.stringify(l)}, expected ${JSON.stringify(t)}.`);let u=I(o,s);if(u!==null&&u!==t)throw Error(`Refusing to install "${o}": owned by ${JSON.stringify(u)}, not ${JSON.stringify(t)}. Check metadata.${k} in .agents/skills/${o}/SKILL.md.`);let d=C(s,D,o),f=Q(d)&&Z(d,n.sourceDir);if(u===null&&q(o,s)&&!f)throw Error(`Refusing to install "${o}": .agents/skills/${o} exists without a ${k} stamp, so it was not installed by this CLI. Remove it manually (or add the stamp to take ownership) before running "skills add".`);if(le(e,s,c===void 0?{}:{mode:c}),a.info(`${i.success} Installed ${o}`),r){let e=c??`symlink`;a.info(` mode=${e} path=${d}`)}}function X(e,t,n,r){let o=I(e,n);if(o===null)return je(e,n,r)?(a.info(`${i.success} Removed ${e} (broken symlink)`),!0):!1;if(o!==t)throw Error(`Refusing to remove "${e}": owned by ${JSON.stringify(o)}, not ${JSON.stringify(t)}. Check metadata.${k} in .agents/skills/${e}/SKILL.md.`);return fe(e,n,{expectedOwnership:t}),a.info(`${i.success} Removed ${e}`),!0}function je(e,t,n){let r=C(t,D,e);if(!Q(r)||!Z(r,n))return!1;for(let n of O){let i=C(t,n,e);Q(i)&&Ne(i,r)&&_(i)}return _(r),!0}function Z(e,t){let n;try{n=p(e)}catch{return!1}let r=b(n)?n:C(y(e),n),i=Me(C(t)),a=Me(r),o=S(i,a);return!(b(o)||o===`..`||o.startsWith(`..${w}`))}function Me(e){let t=e,n=[];for(;;)try{let e=m(t);return n.length===0?e:C(e,...n.reverse())}catch{let r=y(t);if(r===t)return e;n.push(t.slice(r.length).replace(/^[/\\]+/,``)),t=r}}function Ne(e,t){let n;try{n=p(e)}catch{return!1}let r=b(n)?n:C(y(e),n);if(r===t)return!0;try{return m(r)===m(t)}catch{return!1}}function Q(e){let t;try{t=c(e)}catch{return!1}return t.isSymbolicLink()?!s(e):!1}function Pe(e,t,n){let r=C(t,D),i=[],o;try{o=f(r,{withFileTypes:!0})}catch(e){let t=e.code;return t===`ENOENT`||t===`ENOTDIR`||a.warn(`Failed to enumerate ${r}: ${e instanceof Error?e.message:String(e)}`),i}for(let s of o){if(!s.isDirectory()&&!s.isSymbolicLink()||s.name.length<1||s.name.length>64||!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(s.name))continue;let o;try{o=I(s.name,t)}catch(e){a.warn(`Failed to read ownership for ${s.name}: ${e instanceof Error?e.message:String(e)}`);continue}if(o===e){i.push(s.name);continue}let c=C(r,s.name);o===null&&Q(c)&&Z(c,n)&&i.push(s.name)}return i}const Fe=[`add`,`install`],Ie=[`remove`,`uninstall`],$={skills:`Manage agent skills`,sync:`Remove and reinstall all skills from source`,add:`Install skills from source`,remove:`Remove installed skills`,list:`List available skills from source`},Le=/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/,Re=[`.git`,`package.json`];function ze(e,t){return{sourceDir:e.sourceDir,package:e.package,mode:e.mode,cwd:Ve(e.cwd),excludeAlias:Ue(e.flags?.exclude?.alias),verbose:Ge(e.flags?.verbose,e.globalArgs),json:{disabled:Ke(e.globalArgs,`json`)},commandNames:{add:We(e.commandMap?.add,Fe,`add`),remove:We(e.commandMap?.remove,Ie,`remove`)},unknownKeys:e.unknownKeys??`strip`,descriptionAppend:qe(e.descriptionAppend,t),stamp:`${e.package}:${t}`,descriptions:Be(e.descriptions)}}function Be(e){return{skills:e?.skills??$.skills,sync:e?.sync??$.sync,add:e?.add??$.add,remove:e?.remove??$.remove,list:e?.list??$.list}}function Ve(e){if(e!==void 0)return C(e);let t=process.cwd();return He(t)??t}function He(e){let t=C(e);for(;;){for(let e of Re)if(s(C(t,e)))return t;let e=y(t);if(e===t)return null;t=e}}function Ue(e){if(e!==!1)return typeof e==`string`?e:`x`}function We(e,t,n){let r=e??t;if(r.length===0)throw Error(`SkillCommandOptions.commandMap.${n} must include at least one name.`);let i=r.find(e=>!Le.test(e));if(i!==void 0)throw Error(`SkillCommandOptions.commandMap.${n} contains an invalid entry ${JSON.stringify(i)}. Names/aliases must start with an alphanumeric character and contain only alphanumeric characters, hyphens, or underscores.`);return{name:r[0],aliases:r.slice(1)}}function Ge(e,t){return{alias:e?.alias===!1?void 0:e?.alias??`v`,disabled:Ke(t,`verbose`)}}function Ke(e,t){return e?r(e).fields.some(e=>e.name===t&&e.named&&e.type===`boolean`):!1}function qe(e,t){return e===!1?!1:typeof e==`string`?e:`Manage agent skills with \`${t} skills <add|sync|remove|list>\`.`}const Je=[`parse-failed`,`name-mismatch`,`read-failed`,`missing-source`];function Ye(t,n){if(t.subCommands&&Object.hasOwn(t.subCommands,`skills`))throw Error(`withSkillCommand: command "${t.name}" already defines a "skills" subcommand.`);let r=ze(n,t.name),i=r.commandNames.add.name,a=r.commandNames.remove.name,o=[`sync`,`list`,i,...r.commandNames.add.aliases,a,...r.commandNames.remove.aliases],s=o.find((e,t)=>o.indexOf(e)!==t);if(s)throw Error(`withSkillCommand: commandMap produced duplicate subcommand name/alias "${s}".`);let c=e({name:`skills`,description:r.descriptions.skills,subCommands:{sync:we(r),[i]:Te(r),[a]:Ee(r),list:ke(r)}});return{...t,description:Xe(t.description,r.descriptionAppend),subCommands:{...t.subCommands,skills:c}}}function Xe(e,t){return t===!1||t===``?e:e?e.endsWith(t)?e:`${e}\n\n${t}`:t}export{k as OWNERSHIP_METADATA_KEY,Je as SCAN_ERROR_REASONS,F as hasInstalledSkill,le as installSkill,E as parseFrontmatter,ce as parseSkillMd,I as readInstalledOwnership,z as scanSourceDir,fe as uninstallSkill,Ye as withSkillCommand};
@@ -0,0 +1,3 @@
1
+ import{n as e}from"./command-BXsTrIgI.js";import{s as t}from"./subcommand-router-40vA6Mka.js";import{t as n}from"./schema-Bz8oC0xQ.js";import{g as r,h as i}from"./schema-extractor-BI5ypJ21.js";import{existsSync as a,readFileSync as o}from"node:fs";import{join as s}from"node:path";import{spawn as c}from"node:child_process";function l(){let e=(process.env.SHELL||``).split(`/`).pop()?.toLowerCase()||``;return e.includes(`bash`)?`bash`:e.includes(`zsh`)?`zsh`:e.includes(`fish`)?`fish`:null}function u(e){return`${process.env.XDG_CACHE_HOME??`${process.env.HOME??``}/.cache`}/${e}`}function d(e,t,n){if(t===`fish`){let t=process.env.XDG_CONFIG_HOME??`${process.env.HOME??``}/.config`;return s(t,`fish`,`completions`,`${e}.fish`)}let r=n??u(e);return s(r,`completion.${t}`)}function f(e){try{if(!a(e))return null;let t=o(e,`utf8`).split(`
2
+ `,6).join(`
3
+ `).match(/^# politty-bin-sig: (\S+)/m);return t?t[1]:null}catch{return null}}function p(e,t){return f(d(e.programName,t,e.cacheDir))!==null}function m(e,t){try{c(process.execPath,[e,`__refresh-completion`,t],{detached:!0,stdio:`ignore`}).unref()}catch{}}const h=i({shell:r.optionalEnum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell type (bash, zsh, or fish)`,placeholder:`SHELL`}),instructions:r.boolean({alias:`i`,description:`Show installation instructions`}),loader:r.boolean({description:`Print just the rc loader snippet (bash/zsh). Add it to ~/.bashrc or ~/.zshrc; it auto-regenerates the cache when the binary changes.`}),install:r.boolean({description:`Write the completion script to its on-disk cache (bash/zsh) or autoload location (fish) instead of printing it.`}),static:r.boolean({description:`Generate the legacy static completion script with command metadata baked in.`}),dispatcher:r.boolean({description:`Generate the runtime dispatcher completion script. This is the default.`}),worker:r.boolean({description:`Generate an internal static worker artifact for dispatcher mode.`})}),g=i({shell:r.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell to refresh`,placeholder:`SHELL`}),target:r.optionalString({positional:!0,description:`Existing politty-generated completion file to refresh`,placeholder:`TARGET`}),static:r.boolean({description:`Refresh using the legacy static completion script mode.`}),worker:r.boolean({description:`Refresh an internal static worker completion script.`})}),_=i({shell:r.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell worker to locate`,placeholder:`SHELL`})});function v(r,i){let{programName:a,globalArgsSchema:o,cacheDir:s,programVersion:c,bundledWorker:l}=typeof i==`string`?{programName:i}:i??{},u=a??r.name,d={...s!==void 0&&{cacheDir:s},...c!==void 0&&{programVersion:c},...o!==void 0&&{globalArgsSchema:o},...l!==void 0&&{bundledWorker:l}},f={...r};return f.subCommands={...r.subCommands,completion:t(e({name:`completion`,description:`Generate shell completion script`,args:h,run(){}}),()=>import(`./completion-B-O5x0KK.js`).then(e=>e.createCompletionCommand(f,a,o,d))),__complete:t(e({name:`__complete`,args:n,run(){}}),()=>import(`./dynamic-BPH__Tf7.js`).then(e=>e.createDynamicCompleteCommand(f,a,o))),"__refresh-completion":t(e({name:`__refresh-completion`,description:`(internal) Refresh the on-disk completion cache if stale.`,args:g,run(){}}),()=>import(`./completion-B-O5x0KK.js`).then(e=>e.createRefreshCompletionCommand(f,u,d))),"__completion-worker-path":t(e({name:`__completion-worker-path`,description:`(internal) Print the bundled completion worker path when available.`,args:_,run(){}}),()=>import(`./completion-B-O5x0KK.js`).then(e=>e.createCompletionWorkerPathCommand(u,d)))},f.runMainHook=e=>{y(e,{programName:u,...s!==void 0&&{cacheDir:s}})},f}function y(e,t){if(process.env.POLITTY_NO_COMPLETION_REFRESH)return;let n=e.find(e=>!e.startsWith(`-`));if(n===`__complete`||n===`__refresh-completion`||n===`__completion-worker-path`||n===`completion`)return;let r=l();if(!r)return;let i=process.argv[1];i&&p(t,r)&&m(i,r)}export{d as a,_ as i,h as n,f as o,g as r,l as s,v as t};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@politty/loculus",
3
- "version": "0.4.1",
3
+ "version": "0.4.3",
4
4
  "description": "Politty CLI framework with flat loculus schemas",
5
5
  "keywords": [
6
6
  "argument-parser",
@@ -76,10 +76,10 @@
76
76
  },
77
77
  "devDependencies": {
78
78
  "@politty/core": "0.1.0",
79
- "@types/node": "26.6.5",
79
+ "@types/node": "26.6.6",
80
80
  "@typescript/native-preview": "7.0.0-dev.20260707.2",
81
81
  "loculus": "0.4.1",
82
- "tsdown": "0.23.1",
82
+ "tsdown": "0.23.5",
83
83
  "typescript": "7.0.2"
84
84
  },
85
85
  "peerDependencies": {
@@ -1 +0,0 @@
1
- export{t as runPolittyCli}from"./cli-main-CdXCj3sh.js";
@@ -1 +0,0 @@
1
- import"./register-D-aEK58y.js";const{runPolittyCli:e}=await import(`./cli-main-CTVeQxs0.js`);await e(`@politty/loculus`);export{};