@politty/loculus 0.2.2 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/README.md +4 -2
  2. package/dist/agent.d.ts +1 -1
  3. package/dist/{cli-main-BfVeBgWH.js → cli-main-CYw9CO6g.js} +2 -2
  4. package/dist/cli-main-D-cfXp31.js +1 -0
  5. package/dist/cli-run-BxsmKHV0.js +1 -0
  6. package/dist/cli.js +1 -1
  7. package/dist/compile-cache.d.ts +1 -3
  8. package/dist/{completion-HFTQqCkl.js → completion-DjxPFcWB.js} +1 -1
  9. package/dist/completion-W_nxO_kv.js +1 -0
  10. package/dist/completion.d.ts +2 -22
  11. package/dist/completion.js +1 -1
  12. package/dist/{detect-agent-EHaSY1KW.d.ts → detect-agent-hU93hctO.d.ts} +0 -4
  13. package/dist/docs.d.ts +1 -21
  14. package/dist/docs.js +2 -2
  15. package/dist/dynamic-CDaJH0_w.js +1 -0
  16. package/dist/{dynamic-6tiYA5H2.js → dynamic-D_i-A8Qb.js} +2 -2
  17. package/dist/index.d.ts +24 -49
  18. package/dist/index.js +1 -1
  19. package/dist/prompt-Bmm7QM-I.js +1 -0
  20. package/dist/prompt-clack.d.ts +2 -4
  21. package/dist/prompt-clack.js +1 -1
  22. package/dist/prompt-inquirer.d.ts +2 -4
  23. package/dist/prompt-inquirer.js +1 -1
  24. package/dist/prompt.d.ts +2 -10
  25. package/dist/prompt.js +1 -1
  26. package/dist/runner-B7QLJFxY.js +33 -0
  27. package/dist/runner-BdAfqN-z.js +1 -0
  28. package/dist/{schema-CuJVxa-M.js → schema-Dqan9VXJ.js} +1 -1
  29. package/dist/schema-extractor-D6Se8W6B.js +1 -0
  30. package/dist/skill.d.ts +7 -22
  31. package/dist/skill.js +2 -2
  32. package/dist/{types-DtQ-Zt3n.d.ts → types-CaP5nn8i.d.ts} +56 -28
  33. package/dist/{with-completion-command-QHQsd0Zt.d.ts → with-completion-command-BhjWVp1l.d.ts} +1 -9
  34. package/dist/{with-completion-command-D4dL2Wpw.js → with-completion-command-DQ1vWryG.js} +2 -2
  35. package/package.json +4 -4
  36. package/dist/cli-main-eAweK3gm.js +0 -1
  37. package/dist/cli-run-wkTnhYYA.js +0 -1
  38. package/dist/completion-spw7tGzT.js +0 -1
  39. package/dist/dynamic-ChNWK13o.js +0 -1
  40. package/dist/prompt-Bsj8hqe0.js +0 -1
  41. package/dist/runner-C5OHC75C.js +0 -33
  42. package/dist/runner-CjoCRiEO.js +0 -1
  43. package/dist/schema-extractor-BK1sJx7i.js +0 -1
package/dist/skill.js CHANGED
@@ -1,2 +1,2 @@
1
- import{d as e,n as t,u as n}from"./schema-extractor-BK1sJx7i.js";import{n as r}from"./command-BXsTrIgI.js";import{a as i,n as a}from"./logger-CoeDrmRr.js";import"./register-Ceh-HlVN.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(t){function i(e,n){let{skills:r,errors:i}=W(t),o=t.stamp,s=new Set(r.map(e=>e.frontmatter.name)),c=new Set(Pe(o,t.cwd,t.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},t.sourceDir),p=0;if(!f){let e=new Set(d.map(e=>e.frontmatter.name)),n=/* @__PURE__ */ new Set;for(let e of i)e.path!==t.sourceDir&&(n.add(v(e.path)),e.skillName!==void 0&&n.add(e.skillName));for(let r of c)e.has(r)||u.has(r)||n.has(r)||(X(r,o,t.cwd,t.sourceDir),p+=1)}let m=0;for(let e of d)Y(e,o,t,n),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 t.verbose.disabled?r({name:`sync`,description:t.descriptions.sync,args:n({exclude:e.stringArray(Ce(t))},{unknownKeys:t.unknownKeys}),run(e){i(e,K(e,`verbose`))}}):r({name:`sync`,description:t.descriptions.sync,args:n({exclude:e.stringArray(Ce(t)),verbose:e.boolean(G(t))},{unknownKeys:t.unknownKeys}),run(e){i(e,e.verbose)}})}function Te(t){let i={positional:!0,description:`Skill name(s) to install (default: all)`,placeholder:`NAME`};function o(e,n){let r=W(t),i=r.skills,o=t.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,t,n)}else if(i.length===0)U(r,t.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,t,n)}return t.verbose.disabled?r({name:t.commandNames.add.name,...t.commandNames.add.aliases.length>0?{aliases:t.commandNames.add.aliases}:{},description:t.descriptions.add,args:n({name:e.stringArray(i)},{unknownKeys:t.unknownKeys}),run(e){o(e,K(e,`verbose`))}}):r({name:t.commandNames.add.name,...t.commandNames.add.aliases.length>0?{aliases:t.commandNames.add.aliases}:{},description:t.descriptions.add,args:n({name:e.stringArray(i),verbose:e.boolean(G(t))},{unknownKeys:t.unknownKeys}),run(e){o(e,e.verbose)}})}function Ee(t){return r({name:t.commandNames.remove.name,...t.commandNames.remove.aliases.length>0?{aliases:t.commandNames.remove.aliases}:{},description:t.descriptions.remove,args:n({name:e.optionalString({positional:!0,description:`Skill name to remove (default: all)`,placeholder:`NAME`})},{unknownKeys:t.unknownKeys}),run(e){let n=W(t),r=n.skills,i=t.stamp;if(e.name){if(r.some(t=>t.frontmatter.name===e.name)&&Ae(r,e.name),!X(e.name,i,t.cwd,t.sourceDir)){if(q(e.name,t.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 n=new Set(Pe(i,t.cwd,t.sourceDir));a.info(`${e.name} is not installed; nothing to remove.\n`+J({installed:n}))}}return}if(r.length===0){U(n,t.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,t.cwd,t.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(t){function i(e){let n=W(t,{silentStdout:e}),r=n.skills,i=t.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,t.cwd,t.sourceDir),sourcePath:e.sourcePath}))));else if(r.length===0)U(n,t.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 n=De(e.frontmatter.name,i,t.cwd,t.sourceDir);a.info(` ${e.frontmatter.name.padEnd(20)} ${n.padEnd(14)} ${e.frontmatter.description}`)}}}return t.json.disabled?r({name:`list`,description:t.descriptions.list,args:n({},{unknownKeys:t.unknownKeys}),run(e){i(K(e,`json`))}}):r({name:`list`,description:t.descriptions.list,args:n({json:e.boolean({description:`Output as JSON`})},{unknownKeys:t.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,n){return e?t(e).fields.some(e=>e.name===n&&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{g as e,h as t,n}from"./schema-extractor-D6Se8W6B.js";import{n as r}from"./command-BXsTrIgI.js";import{a as i,n as a}from"./logger-CoeDrmRr.js";import"./register-Ceh-HlVN.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,5 +1,4 @@
1
- import { t as AgentInfo } from "./detect-agent-EHaSY1KW.js";
2
- //#region ../core/src/adapter/standard-schema.d.ts
1
+ import { t as AgentInfo } from "./detect-agent-hU93hctO.js";
3
2
  /**
4
3
  * Type-level subset of the Standard Schema V1 interface
5
4
  * (https://standardschema.dev), vendored so `@politty/core` can constrain
@@ -44,8 +43,6 @@ interface SchemaLike<Output = unknown> {
44
43
  }
45
44
  /** Infer the output type of a {@link SchemaLike}. */
46
45
  type InferSchemaOutput<S> = S extends SchemaLike ? NonNullable<S["~standard"]["types"]>["output"] : never;
47
- //#endregion
48
- //#region ../core/src/package-requirements.d.ts
49
46
  interface PackageRequirement<TArgs = unknown> {
50
47
  name: string;
51
48
  install?: string | undefined;
@@ -54,8 +51,6 @@ interface PackageRequirement<TArgs = unknown> {
54
51
  when?: ((args: TArgs) => boolean) | undefined;
55
52
  }
56
53
  declare function loadPackage<TModule = unknown>(requirement: Pick<PackageRequirement, "name" | "install" | "from">): Promise<TModule>;
57
- //#endregion
58
- //#region ../core/src/core/dynamic-completion-types.d.ts
59
54
  /**
60
55
  * Types for in-process dynamic value completion.
61
56
  *
@@ -111,8 +106,6 @@ interface DynamicCompletionResult {
111
106
  directive?: CompletionDirectiveMask;
112
107
  }
113
108
  type DynamicCompletionResolver = (ctx: DynamicCompletionContext) => DynamicCompletionResult | Promise<DynamicCompletionResult>;
114
- //#endregion
115
- //#region ../core/src/core/expand-completion-types.d.ts
116
109
  /**
117
110
  * Types for "expand" completion — candidates that depend on sibling arg
118
111
  * values.
@@ -157,8 +150,6 @@ interface ExpandCompletion {
157
150
  dependsOn: readonly string[];
158
151
  enumerate: (deps: Readonly<Record<string, string>>) => ReadonlyArray<string | ExpandCandidate>;
159
152
  }
160
- //#endregion
161
- //#region ../core/src/core/arg-registry.d.ts
162
153
  /**
163
154
  * Built-in completion types
164
155
  */
@@ -245,6 +236,15 @@ type CompletionMeta = {
245
236
  * - "directory": directory path input (inherited from completion type)
246
237
  */
247
238
  type PromptType = "text" | "password" | "confirm" | "select" | "file" | "directory";
239
+ interface PromptChoicesContext {
240
+ rawArgs: Readonly<Record<string, unknown>>;
241
+ globalArgs: Readonly<Record<string, unknown>>;
242
+ }
243
+ type PromptChoices = Array<string | {
244
+ label: string;
245
+ value: string;
246
+ }>;
247
+ type PromptChoicesResolver = (context: PromptChoicesContext) => PromptChoices | Promise<PromptChoices>;
248
248
  /**
249
249
  * Prompt metadata for interactive input when a value is missing.
250
250
  * Used by the `politty/prompt` module to request user input for unresolved arguments.
@@ -273,10 +273,7 @@ interface PromptMeta {
273
273
  /** Explicit prompt type. Overrides auto-detection from schema/completion. */
274
274
  type?: PromptType;
275
275
  /** Choices for select prompt. Overrides enum values from schema. */
276
- choices?: Array<string | {
277
- label: string;
278
- value: string;
279
- }>;
276
+ choices?: PromptChoices | PromptChoicesResolver;
280
277
  /** Whether to enable prompting for this field (default: true when prompt is set) */
281
278
  enabled?: boolean;
282
279
  }
@@ -539,8 +536,10 @@ interface ArgFn<TSchemaBase extends SchemaLike = SchemaLike> {
539
536
  <T extends TSchemaBase>(schema: T): T;
540
537
  <T extends TSchemaBase, M extends ArgMeta<InferSchemaOutput<T>>>(schema: T, meta: ValidateArgMeta<M, InferSchemaOutput<T>>): T;
541
538
  }
542
- //#endregion
543
- //#region ../core/src/adapter/field-meta.d.ts
539
+ /** Where a flat field's value sits in the nested output */
540
+ interface NestedFieldInfo {
541
+ path: readonly string[];
542
+ }
544
543
  /**
545
544
  * Resolved metadata for an argument field
546
545
  */
@@ -619,6 +618,11 @@ interface ResolvedFieldMeta {
619
618
  negationDescription?: string | undefined;
620
619
  /** Side-effect callback from arg() metadata */
621
620
  effect?: ((value: unknown, context: EffectContext) => void | PromiseLike<void>) | undefined;
621
+ /**
622
+ * Where the validated value sits when the schema was wrapped by an
623
+ * `unflatten` helper, which nests its output while the field name stays flat.
624
+ */
625
+ nested?: NestedFieldInfo | undefined;
622
626
  }
623
627
  /**
624
628
  * Extracted fields from a schema
@@ -677,8 +681,6 @@ declare function toKebabCase(str: string): string;
677
681
  * @example toCamelCase("dryRun") => "dryRun"
678
682
  */
679
683
  declare function toCamelCase(str: string): string;
680
- //#endregion
681
- //#region ../core/src/lazy.d.ts
682
684
  /**
683
685
  * A lazily-loaded command that carries synchronous metadata for
684
686
  * static analysis (completion, help) while deferring full module
@@ -722,8 +724,6 @@ declare function isLazyCommand(value: unknown): value is LazyCommand;
722
724
  * ```
723
725
  */
724
726
  declare function lazy<T extends AnyCommand>(meta: T, load: () => Promise<AnyCommand>): LazyCommand<T>;
725
- //#endregion
726
- //#region ../core/src/types.d.ts
727
727
  /**
728
728
  * Global args interface for declaration merging (Pattern 3).
729
729
  * Users can extend this interface to add global options to all commands:
@@ -743,10 +743,11 @@ type IsEmpty<T> = keyof T extends never ? true : false;
743
743
  * Where a resolved arg value came from:
744
744
  * - `"cli"`: an explicit CLI token (flag or positional)
745
745
  * - `"env"`: `field.env` fallback (no CLI token was provided)
746
- * - `"default"`: neither of the above (e.g. a schema default, or a value
747
- * resolved by a `prompt` handler)
746
+ * - `"prompt"`: answered by a `prompt` resolver, whether returned or written
747
+ * into its `rawArgs` in place
748
+ * - `"default"`: none of the above (e.g. a schema default)
748
749
  */
749
- type ArgSource = "cli" | "env" | "default";
750
+ type ArgSource = "cli" | "env" | "prompt" | "default";
750
751
  /**
751
752
  * Identifies the CLI name a command was invoked with in the current run.
752
753
  * - `name`: the literal token typed on the CLI to reach this command
@@ -822,6 +823,19 @@ interface GlobalCleanupContext {
822
823
  agent?: AgentInfo | undefined;
823
824
  /** Error if command execution failed */
824
825
  error?: Error | undefined;
826
+ /**
827
+ * Validated global option values recovered when the run failed before the
828
+ * global effects ran (an unknown flag, an invalid value, a failed local
829
+ * validation). A value that fails its own validation is dropped, so the
830
+ * schema's default applies where it defines one. `$source` reports where
831
+ * each value came from. Undefined when the run did not fail that way, no
832
+ * `globalArgs` schema is set, a required global value is missing, or
833
+ * recovering the values throws. A failed `setup` runs before any argument is
834
+ * parsed, so it passes none.
835
+ */
836
+ globalArgs?: (Readonly<IsEmpty<GlobalArgs> extends true ? Record<string, unknown> : GlobalArgs> & {
837
+ $source?: (name: string) => ArgSource;
838
+ }) | undefined;
825
839
  }
826
840
  /**
827
841
  * Context passed to a function-form {@link AgentHelp}
@@ -942,12 +956,19 @@ type SubCommandValue = AnyCommand | (() => Promise<AnyCommand>) | LazyCommand;
942
956
  * Record of subcommands indexed by name
943
957
  */
944
958
  type SubCommandsRecord = Record<string, SubCommandValue>;
959
+ /**
960
+ * Shared-argument context passed from the runner to a {@link PromptResolver}.
961
+ */
962
+ interface PromptResolverContext {
963
+ /** Validated global args for command prompts, or values resolved so far for global prompts */
964
+ globalArgs: Record<string, unknown>;
965
+ }
945
966
  /**
946
967
  * Async callback to resolve missing argument values interactively.
947
968
  * Called after env fallback, before schema validation.
948
969
  * Provided by adapter subpath modules (e.g. `politty/prompt/clack`).
949
970
  */
950
- type PromptResolver = (rawArgs: Record<string, unknown>, extracted: ExtractedFields) => Promise<Record<string, unknown>>;
971
+ type PromptResolver = (rawArgs: Record<string, unknown>, extracted: ExtractedFields, context?: PromptResolverContext) => Promise<Record<string, unknown>>;
951
972
  /**
952
973
  * Options for runMain (CLI entry point)
953
974
  */
@@ -958,7 +979,11 @@ interface MainOptions {
958
979
  debug?: boolean;
959
980
  /** Capture console and process.stdout/stderr output during execution (default: false) */
960
981
  captureLogs?: boolean;
961
- /** Skip command definition validation (useful in production where tests already verified) */
982
+ /**
983
+ * Skip command definition validation (useful in production where tests already verified).
984
+ * A field declared in both `globalArgs` and a command's `args` is then not rejected, and
985
+ * the command's value wins.
986
+ */
962
987
  skipValidation?: boolean;
963
988
  /** Custom logger for output (default: console) */
964
989
  logger?: Logger;
@@ -1041,7 +1066,11 @@ interface RunCommandOptions {
1041
1066
  debug?: boolean;
1042
1067
  /** Capture console and process.stdout/stderr output during execution (default: false) */
1043
1068
  captureLogs?: boolean;
1044
- /** Skip command definition validation (useful in production where tests already verified) */
1069
+ /**
1070
+ * Skip command definition validation (useful in production where tests already verified).
1071
+ * A field declared in both `globalArgs` and a command's `args` is then not rejected, and
1072
+ * the command's value wins.
1073
+ */
1045
1074
  skipValidation?: boolean;
1046
1075
  /** Custom logger for output (default: console) */
1047
1076
  logger?: Logger;
@@ -1131,5 +1160,4 @@ interface RunResultFailure {
1131
1160
  * Result of command execution (discriminated union)
1132
1161
  */
1133
1162
  type RunResult<T = unknown> = RunResultSuccess<T> | RunResultFailure;
1134
- //#endregion
1135
- export { DynamicCompletionCandidate as $, SubCommandsRecord as A, ArgFn as B, RunInvocation as C, RunnableCommand as D, RunResultSuccess as E, ExtractedFields as F, EffectContext as G, CompletionMeta as H, ResolvedFieldMeta as I, ValidateArgMeta as J, PromptMeta as K, UnknownKeysMode as L, LazyCommand as M, isLazyCommand as N, SetupContext as O, lazy as P, CompletionDirectiveMask as Q, toCamelCase as R, RunCommandOptions as S, RunResultFailure as T, CompletionType as U, ArgMeta as V, CustomCompletion as W, ExpandCompletion as X, ExpandCandidate as Y, ResolvedExpandCandidate as Z, LogStream as _, ArgsSchema as a, InferSchemaOutput as at, NonRunnableCommand as b, Command as c, GlobalArgs as d, DynamicCompletionContext as et, GlobalCleanupContext as f, LogLevel as g, LogEntry as h, ArgSource as i, loadPackage as it, UnknownSubcommandHandler as j, SubCommandValue as k, CommandBase as l, IsEmpty as m, AgentHelpContext as n, DynamicCompletionResult as nt, CleanupContext as o, SchemaLike as ot, GlobalSetupContext as p, PromptType as q, AnyCommand as r, PackageRequirement as rt, CollectedLogs as s, AgentHelp as t, DynamicCompletionResolver as tt, Example as u, Logger as v, RunResult as w, PromptResolver as x, MainOptions as y, toKebabCase as z };
1163
+ export { ExpandCandidate as $, SubCommandValue as A, toKebabCase as B, RunCommandOptions as C, RunResultSuccess as D, RunResultFailure as E, lazy as F, CustomCompletion as G, ArgMeta as H, ExtractedFields as I, PromptChoicesContext as J, EffectContext as K, ResolvedFieldMeta as L, UnknownSubcommandHandler as M, LazyCommand as N, RunnableCommand as O, isLazyCommand as P, ValidateArgMeta as Q, UnknownKeysMode as R, PromptResolverContext as S, RunResult as T, CompletionMeta as U, ArgFn as V, CompletionType as W, PromptMeta as X, PromptChoicesResolver as Y, PromptType as Z, LogStream as _, ArgsSchema as a, DynamicCompletionResolver as at, NonRunnableCommand as b, Command as c, loadPackage as ct, GlobalArgs as d, ExpandCompletion as et, GlobalCleanupContext as f, LogLevel as g, LogEntry as h, ArgSource as i, DynamicCompletionContext as it, SubCommandsRecord as j, SetupContext as k, CommandBase as l, InferSchemaOutput as lt, IsEmpty as m, AgentHelpContext as n, CompletionDirectiveMask as nt, CleanupContext as o, DynamicCompletionResult as ot, GlobalSetupContext as p, PromptChoices as q, AnyCommand as r, DynamicCompletionCandidate as rt, CollectedLogs as s, PackageRequirement as st, AgentHelp as t, ResolvedExpandCandidate as tt, Example as u, SchemaLike as ut, Logger as v, RunInvocation as w, PromptResolver as x, MainOptions as y, toCamelCase as z };
@@ -1,5 +1,4 @@
1
- import { L as UnknownKeysMode, V as ArgMeta, Z as ResolvedExpandCandidate, a as ArgsSchema, r as AnyCommand, tt as DynamicCompletionResolver } from "./types-DtQ-Zt3n.js";
2
- //#region ../core/src/adapter/internal-args.d.ts
1
+ import { H as ArgMeta, R as UnknownKeysMode, a as ArgsSchema, at as DynamicCompletionResolver, r as AnyCommand, tt as ResolvedExpandCandidate } from "./types-CaP5nn8i.js";
3
2
  /** Runtime brand distinguishing internal descriptors from library schemas. */
4
3
  declare const INTERNAL_ARGS_BRAND = "__polittyInternalArgs";
5
4
  type InternalFieldKind = "string" | "boolean" | "enum" | "string-array";
@@ -37,8 +36,6 @@ type InternalArgsSchema<TOut extends Record<string, unknown> = Record<string, un
37
36
  type InferInternalArgs<S> = S extends {
38
37
  readonly __out?: infer TOut;
39
38
  } ? NonNullable<TOut> : never;
40
- //#endregion
41
- //#region ../core/src/completion/types.d.ts
42
39
  /**
43
40
  * A single resolved entry in an "expand" lookup table.
44
41
  *
@@ -305,8 +302,6 @@ interface CompletionResult {
305
302
  * Generator function type for shell completions
306
303
  */
307
304
  type CompletionGenerator = (command: AnyCommand, options: CompletionOptions) => CompletionResult;
308
- //#endregion
309
- //#region ../core/src/completion/bundled-worker.d.ts
310
305
  interface GenerateBundledCompletionWorkerOptions {
311
306
  /** CLI binary or built JS entry file to invoke. */
312
307
  bin: string;
@@ -337,8 +332,6 @@ declare function bundledWorkerShellExtension(shell: ShellType): string;
337
332
  declare function defaultBundledWorkerOutputPath(shell: ShellType): string;
338
333
  declare function validateBundledWorkerFile(path: string, programName: string, shell: ShellType): void;
339
334
  declare function generateBundledCompletionWorker(options: GenerateBundledCompletionWorkerOptions): Promise<GenerateBundledCompletionWorkerResult>;
340
- //#endregion
341
- //#region ../core/src/completion/with-completion-command.d.ts
342
335
  /**
343
336
  * Options for withCompletionCommand
344
337
  */
@@ -380,5 +373,4 @@ interface WithCompletionOptions {
380
373
  * ```
381
374
  */
382
375
  declare function withCompletionCommand<T extends AnyCommand>(command: T, options?: string | WithCompletionOptions): T;
383
- //#endregion
384
376
  export { CompletionResult as _, bundledWorkerShellExtension as a, InferInternalArgs as b, validateBundledWorkerFile as c, CompletablePositional as d, CompletableSubcommand as f, CompletionOptions as g, CompletionMode as h, GenerateBundledCompletionWorkerResult as i, BundledWorkerOptions as l, CompletionGenerator as m, withCompletionCommand as n, defaultBundledWorkerOutputPath as o, CompletionData as p, GenerateBundledCompletionWorkerOptions as r, generateBundledCompletionWorker as s, WithCompletionOptions as t, CompletableOption as u, ShellType as v, InternalArgsSchema as x, ValueCompletion as y };
@@ -1,3 +1,3 @@
1
- import{d as e,u as t}from"./schema-extractor-BK1sJx7i.js";import{n}from"./command-BXsTrIgI.js";import{s as r}from"./subcommand-router-40vA6Mka.js";import{t as i}from"./schema-CuJVxa-M.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(`
1
+ import{g as e,h as t}from"./schema-extractor-D6Se8W6B.js";import{n}from"./command-BXsTrIgI.js";import{s as r}from"./subcommand-router-40vA6Mka.js";import{t as i}from"./schema-Dqan9VXJ.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
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=t({shell:e.optionalEnum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell type (bash, zsh, or fish)`,placeholder:`SHELL`}),instructions:e.boolean({alias:`i`,description:`Show installation instructions`}),loader:e.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:e.boolean({description:`Write the completion script to its on-disk cache (bash/zsh) or autoload location (fish) instead of printing it.`}),static:e.boolean({description:`Generate the legacy static completion script with command metadata baked in.`}),dispatcher:e.boolean({description:`Generate the runtime dispatcher completion script. This is the default.`}),worker:e.boolean({description:`Generate an internal static worker artifact for dispatcher mode.`})}),g=t({shell:e.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell to refresh`,placeholder:`SHELL`}),target:e.optionalString({positional:!0,description:`Existing politty-generated completion file to refresh`,placeholder:`TARGET`}),static:e.boolean({description:`Refresh using the legacy static completion script mode.`}),worker:e.boolean({description:`Refresh an internal static worker completion script.`})}),_=t({shell:e.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell worker to locate`,placeholder:`SHELL`})});function v(e,t){let{programName:a,globalArgsSchema:o,cacheDir:s,programVersion:c,bundledWorker:l}=typeof t==`string`?{programName:t}:t??{},u=a??e.name,d={...s!==void 0&&{cacheDir:s},...c!==void 0&&{programVersion:c},...o!==void 0&&{globalArgsSchema:o},...l!==void 0&&{bundledWorker:l}},f={...e};return f.subCommands={...e.subCommands,completion:r(n({name:`completion`,description:`Generate shell completion script`,args:h,run(){}}),()=>import(`./completion-spw7tGzT.js`).then(e=>e.createCompletionCommand(f,a,o,d))),__complete:r(n({name:`__complete`,args:i,run(){}}),()=>import(`./dynamic-ChNWK13o.js`).then(e=>e.createDynamicCompleteCommand(f,a,o))),"__refresh-completion":r(n({name:`__refresh-completion`,description:`(internal) Refresh the on-disk completion cache if stale.`,args:g,run(){}}),()=>import(`./completion-spw7tGzT.js`).then(e=>e.createRefreshCompletionCommand(f,u,d))),"__completion-worker-path":r(n({name:`__completion-worker-path`,description:`(internal) Print the bundled completion worker path when available.`,args:_,run(){}}),()=>import(`./completion-spw7tGzT.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};
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=t({shell:e.optionalEnum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell type (bash, zsh, or fish)`,placeholder:`SHELL`}),instructions:e.boolean({alias:`i`,description:`Show installation instructions`}),loader:e.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:e.boolean({description:`Write the completion script to its on-disk cache (bash/zsh) or autoload location (fish) instead of printing it.`}),static:e.boolean({description:`Generate the legacy static completion script with command metadata baked in.`}),dispatcher:e.boolean({description:`Generate the runtime dispatcher completion script. This is the default.`}),worker:e.boolean({description:`Generate an internal static worker artifact for dispatcher mode.`})}),g=t({shell:e.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell to refresh`,placeholder:`SHELL`}),target:e.optionalString({positional:!0,description:`Existing politty-generated completion file to refresh`,placeholder:`TARGET`}),static:e.boolean({description:`Refresh using the legacy static completion script mode.`}),worker:e.boolean({description:`Refresh an internal static worker completion script.`})}),_=t({shell:e.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell worker to locate`,placeholder:`SHELL`})});function v(e,t){let{programName:a,globalArgsSchema:o,cacheDir:s,programVersion:c,bundledWorker:l}=typeof t==`string`?{programName:t}:t??{},u=a??e.name,d={...s!==void 0&&{cacheDir:s},...c!==void 0&&{programVersion:c},...o!==void 0&&{globalArgsSchema:o},...l!==void 0&&{bundledWorker:l}},f={...e};return f.subCommands={...e.subCommands,completion:r(n({name:`completion`,description:`Generate shell completion script`,args:h,run(){}}),()=>import(`./completion-W_nxO_kv.js`).then(e=>e.createCompletionCommand(f,a,o,d))),__complete:r(n({name:`__complete`,args:i,run(){}}),()=>import(`./dynamic-CDaJH0_w.js`).then(e=>e.createDynamicCompleteCommand(f,a,o))),"__refresh-completion":r(n({name:`__refresh-completion`,description:`(internal) Refresh the on-disk completion cache if stale.`,args:g,run(){}}),()=>import(`./completion-W_nxO_kv.js`).then(e=>e.createRefreshCompletionCommand(f,u,d))),"__completion-worker-path":r(n({name:`__completion-worker-path`,description:`(internal) Print the bundled completion worker path when available.`,args:_,run(){}}),()=>import(`./completion-W_nxO_kv.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.2.2",
3
+ "version": "0.4.0",
4
4
  "description": "Politty CLI framework with flat loculus schemas",
5
5
  "keywords": [
6
6
  "argument-parser",
@@ -76,16 +76,16 @@
76
76
  },
77
77
  "devDependencies": {
78
78
  "@politty/core": "0.1.0",
79
- "@types/node": "25.9.9",
79
+ "@types/node": "26.6.5",
80
80
  "@typescript/native-preview": "7.0.0-dev.20260707.2",
81
- "loculus": "0.3.0",
81
+ "loculus": "0.4.1",
82
82
  "tsdown": "0.23.1",
83
83
  "typescript": "7.0.2"
84
84
  },
85
85
  "peerDependencies": {
86
86
  "@clack/prompts": "^0.10.0 || ^0.11.0 || ^1.0.0",
87
87
  "@inquirer/prompts": "^8.3.2",
88
- "loculus": "^0.2.5 || ^0.3.0"
88
+ "loculus": "^0.4.0"
89
89
  },
90
90
  "peerDependenciesMeta": {
91
91
  "@clack/prompts": {
@@ -1 +0,0 @@
1
- export{t as runPolittyCli}from"./cli-main-BfVeBgWH.js";
@@ -1 +0,0 @@
1
- import"./register-Ceh-HlVN.js";const{runPolittyCli:e}=await import(`./cli-main-eAweK3gm.js`);await e(`@politty/loculus`);export{};
@@ -1 +0,0 @@
1
- import"./with-completion-command-D4dL2Wpw.js";import"./dynamic-6tiYA5H2.js";export{t as createCompletionCommand,n as createCompletionWorkerPathCommand,r as createRefreshCompletionCommand,c as generateBundledCompletionWorker}from"./completion-HFTQqCkl.js";
@@ -1 +0,0 @@
1
- export{t as createDynamicCompleteCommand}from"./dynamic-6tiYA5H2.js";
@@ -1 +0,0 @@
1
- import{l as e}from"./schema-extractor-BK1sJx7i.js";function t(e){let t=e.prompt;if(!t||t.enabled===!1)return null;let n=t.message??e.description??e.name,a=r(e,t),o=i(e,t,a);return{field:e,type:a===`select`&&!o?`text`:a,message:n,...o&&{choices:o}}}function n(e){return e!==void 0&&e.length>0}function r(e,t){return t.type?t.type===`file`||t.type===`directory`?`text`:t.type:n(t.choices)?`select`:e.completion?.type===`file`||e.completion?.type===`directory`?`text`:n(e.enumValues)?`select`:e.type===`boolean`?`confirm`:`text`}function i(e,t,r){if(n(t.choices))return t.choices.map(e=>typeof e==`string`?{label:e,value:e}:e);if(r===`select`&&n(e.enumValues))return e.enumValues.map(e=>({label:e,value:e}))}function a(e,n){let r=[];for(let i of e){if(n[i.name]!==void 0||i.type===`array`)continue;let e=t(i);e&&r.push(e)}return r}function o(){return!(!process.stdin.isTTY||!process.stdout.isTTY||process.env.CI||process.env.POLITTY_NO_PROMPT)}async function s(e,t,n){if(!(n.interactive??o()))return e;let r=n.adapter,i={...e};return t.schemaType===`discriminatedUnion`&&t.discriminator&&t.variants?await c(r,i,t):t.schemaType===`union`||t.schemaType===`xor`||await u(r,i,t.fields),i}async function c(n,r,i){let{discriminator:a,variants:o}=i;if(!a||!o)return;if(r[a]===void 0){let e=l(i.fields,o,a),s=e?t(e):null;if(s){let e=o.map(e=>e.discriminatorValue).filter(Boolean);e.length>0&&(s.type=`select`,s.choices=e.map(e=>({label:e,value:e}))),await d(n,r,s)}}let s=e(i,()=>r);s!==i&&await u(n,r,s.fields.filter(e=>e.name!==a))}function l(e,t,n){let r=e.find(e=>e.name===n);if(r?.prompt)return r;for(let e of t){let t=e.fields.find(e=>e.name===n);if(t?.prompt)return t}}async function u(e,t,n){let r=a(n,t);for(let n of r)await d(e,t,n)}async function d(e,t,n){let{message:r}=n,i;switch(n.type){case`text`:i=await e.text({message:r,placeholder:n.field.placeholder});break;case`password`:i=await e.password({message:r});break;case`confirm`:i=await e.confirm({message:r});break;case`select`:i=await e.select({message:r,options:n.choices??[]})}if(e.isCancelled(i))throw Error(`Prompt cancelled by user`);t[n.field.name]=i}export{t as i,o as n,a as r,s as t};
@@ -1,33 +0,0 @@
1
- import{i as e,o as t,r as n,s as r,t as i}from"./registry-BEz5iex_.js";import{a,c as o,f as s,l as c,n as l,o as u,p as d,r as f,s as p,t as m}from"./schema-extractor-BK1sJx7i.js";import{t as h}from"./detect-agent-D7KSeWMh.js";import{n as g}from"./compile-cache-6u9hgeWu.js";import{a as _,c as v,f as y,i as ee,l as b,n as x,o as S,r as C,t as w,u as T}from"./subcommand-router-40vA6Mka.js";import{n as E,r as D,t as O}from"./log-collector-uhRWYT-z.js";import{a as k,i as A}from"./logger-CoeDrmRr.js";import{a as j,c as M,d as N,i as P,l as F,n as I,o as L,r as te,s as ne,t as R}from"./argv-parser-CVlS6mSo.js";import{stripVTControlCharacters as re}from"node:util";async function ie(e,t,n={}){let r,i,a=n.captureLogs??!1?O():null;a?.start();let o={args:t},s={args:t,error:r},c;n.handleSignals&&(c=async t=>{c&&(process.off(`SIGINT`,c),process.off(`SIGTERM`,c));let r=/* @__PURE__ */ Error(`Process interrupted`);if(s.error=r,e.cleanup)try{await e.cleanup(s)}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)}a?.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`,c),process.on(`SIGTERM`,c));try{e.requiredPackages?.length&&await y(e.requiredPackages,t);for(let e of n.packageFields??[])e.requiredPackages?.length&&typeof t==`object`&&t&&e.name in t&&(n.packageDiscriminators?.includes(e.name)||t[e.name]===!0)&&await y(e.requiredPackages,t);e.setup&&await e.setup(o),e.run&&(i=await e.run(t))}catch(e){r=e instanceof Error?e:Error(String(e))}finally{c&&(process.off(`SIGINT`,c),process.off(`SIGTERM`,c))}if(e.cleanup){s.error=r;try{await e.cleanup(s)}catch(e){r||=e instanceof Error?e:Error(String(e))}}a?.stop();let l=n.existingLogs??E(),u=a?.getLogs()??E(),d=D(l,u);return r?{success:!1,error:r,exitCode:1,logs:d}:{success:!0,result:i,exitCode:0,logs:d}}function ae(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 oe(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 se(e){let t=!1,n=!1,r=!1;for(let i of e){let e=i.codePointAt(0);e===65039?r=!0:ae(e)||(t=!0,oe(e)&&(n=!0))}return t?n||r?2:1:0}const ce=(()=>{try{return new Intl.Segmenter(`en`,{granularity:`grapheme`})}catch{return}})();function le(e){if(e.length===0)return 0;let t=e.includes(`\x1B`)||e.includes(`›`)?re(e):e,n=0;if(ce)for(let{segment:e}of ce.segment(t))n+=se(e);else for(let e of t)n+=se(e);return n}function z(e){let t=[],n=e.replace(/`([^`]+)`/g,(e,n)=>{let r=t.length;return t.push(A.cyan(n)),`\x00CODE${r}\x00`});return n=n.replace(/\*\*(.+?)\*\*/g,(e,t)=>A.bold(t)),n=n.replace(/__(.+?)__/g,(e,t)=>A.bold(t)),n=n.replace(/\*(.+?)\*/g,(e,t)=>A.italic(t)),n=n.replace(/(?<!\w)_(.+?)_(?!\w)/g,(e,t)=>A.italic(t)),n=n.replace(/\[([^\]]+)\]\(([^)]+)\)/g,(e,t,n)=>`${A.underline(t)} ${A.dim(`(${n})`)}`),n=n.replace(/\x00CODE(\d+)\x00/g,(e,n)=>t[Number(n)]),n}function ue(e){return be(e.split(`
2
- `)).map(Te).join(`
3
-
4
- `)}const de=/^(#{1,6})\s+(.+)$/,fe=/^(?:---+|\*\*\*+|___+)\s*$/,pe=/^>\s?(.*)$/,me=/^-\s+(.+)$/,he=/^(\d+)[.)]\s+(.+)$/,ge=/^(`{3,}|~{3,})(\S*)\s*$/,_e=/^\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\]\s*$/,ve=/^\|(.+)\|$/,ye=/^\|(\s*:?-+:?\s*\|)+$/;function be(e){let t=[],n=0;for(;n<e.length;){let r=e[n];if(r.trim()===``){n++;continue}let i=r.match(ge);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(de);if(a){t.push({type:`heading`,level:a[1].length,content:a[2]}),n++;continue}if(fe.test(r)){t.push({type:`hr`}),n++;continue}if(pe.test(r)){let r=[];for(;n<e.length;){let t=e[n].match(pe);if(t)r.push(t[1]),n++;else break}if(r.length>0){let e=r[0].match(_e);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(me.test(r)){let r=[];for(;n<e.length;){let t=e[n].match(me);if(t)r.push(t[1]),n++;else break}t.push({type:`ul`,items:r});continue}let o=r.match(he);if(o){let r=Number(o[1]),i=[];for(;n<e.length;){let t=e[n].match(he);if(t)i.push(t[2]),n++;else break}t.push({type:`ol`,items:i,start:r});continue}if(ve.test(r)&&n+1<e.length&&ye.test(e[n+1])){let i=xe(r),a=Se(e[n+1]);n+=2;let o=[];for(;n<e.length&&ve.test(e[n]);)o.push(xe(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()===``||de.test(t)||fe.test(t)||pe.test(t)||me.test(t)||he.test(t)||ge.test(t)||ve.test(t)&&n+1<e.length&&ye.test(e[n+1]))break;s.push(t),n++}s.length>0&&t.push({type:`paragraph`,lines:s})}return t}function xe(e){return e.slice(1,-1).split(`|`).map(e=>e.trim())}function Se(e){return e.slice(1,-1).split(`|`).map(e=>{let t=e.trim();return t.startsWith(`:`)&&t.endsWith(`:`)?`center`:t.endsWith(`:`)?`right`:`left`})}function Ce(e,t,n){let r=le(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 we={NOTE:{icon:`ℹ`,label:`Note`,styleFn:A.cyan},TIP:{icon:`💡`,label:`Tip`,styleFn:A.green},IMPORTANT:{icon:`❗`,label:`Important`,styleFn:A.magenta},WARNING:{icon:`⚠`,label:`Warning`,styleFn:A.yellow},CAUTION:{icon:`🔴`,label:`Caution`,styleFn:A.red}};function Te(e){switch(e.type){case`heading`:return A.green(A.bold(z(e.content)));case`hr`:return A.dim(`─`.repeat(40));case`blockquote`:{let t=A.dim(`│ `);return e.lines.map(e=>`${t}${z(e)}`).join(`
5
- `)}case`alert`:{let{icon:t,label:n,styleFn:r}=we[e.alertType],i=r(A.bold(`│`))+` `,a=`${i}${r(t)} ${r(n)}`;return e.lines.length===0?a:`${a}\n${e.lines.map(e=>`${i}${z(e)}`).join(`
6
- `)}`}case`ul`:return e.items.map(e=>`${A.dim(`•`)} ${z(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`${A.dim(`${i}.`)} ${z(t)}`}).join(`
8
- `)}case`table`:{let t=e.headers.length,n=e.headers.map(e=>z(e)),r=e.rows.map(e=>Array.from({length:t},(t,n)=>z(e[n]??``))),i=n.map((e,t)=>{let n=le(e),i=r.map(e=>le(e[t]));return Math.max(n,...i)}),a=A.dim(`│`),o=A.dim(`┌─${i.map(e=>`─`.repeat(e)).join(`─┬─`)}─┐`),s=A.dim(`├─${i.map(e=>`─`.repeat(e)).join(`─┼─`)}─┤`),c=A.dim(`└─${i.map(e=>`─`.repeat(e)).join(`─┴─`)}─┘`);return[o,`${a} ${n.map((t,n)=>A.bold(Ce(t,i[n],e.alignments[n]??`left`))).join(` ${a} `)} ${a}`,s,...r.map(t=>{let n=t.map((t,n)=>Ce(t,i[n],e.alignments[n]??`left`));return`${a} ${n.join(` ${a} `)} ${a}`}),c].join(`
9
- `)}case`code`:return e.lines.map(e=>` ${A.yellow(e)}`).join(`
10
- `);case`paragraph`:return z(e.lines.join(` `))}}const B={help:`Show help`,helpAll:`Show help with all subcommand options`,helpJson:`Show help as JSON`,version:`Show version`};function Ee(e){return!e.startsWith(`__`)}function V(e){return Object.entries(e).filter(([e])=>Ee(e))}function De(e,t){return t?.rootName&&t.commandPath&&t.commandPath.length>0?t.commandPath.join(` `):e.name??`command`}function Oe(e,t){return t?.rootName&&t.commandPath&&t.commandPath.length>0?`${t.rootName} ${t.commandPath.join(` `)}`:e.name??`command`}function ke(e,t){let n=[],r=Oe(e,t);n.push(A.commandName(r)),t?.globalExtracted?.fields.length&&n.push(A.placeholder(`[global options]`));let i=f(e);if(i){let t=o(i);p(i).length>0&&n.push(A.placeholder(`[options]`)),e.subCommands&&V(e.subCommands).length>0&&(e.run||e.defaultSubCommand?n.push(A.placeholder(`[command]`)):n.push(A.option(`<command>`)));for(let e of t)e.required?n.push(A.option(`<${e.name}>`)):n.push(A.placeholder(`[${e.name}]`))}else e.subCommands&&V(e.subCommands).length>0&&(e.run||e.defaultSubCommand?n.push(A.placeholder(`[command]`)):n.push(A.option(`<command>`)));return n.join(` `)}function Ae(e,t){let n=`${A.dim(`When`)} ${A.option(e)}=${A.bold(t.discriminatorValue)}:`;return t.description?`${n} ${t.description}`:n}function je(e,t){return` ${A.bold(`${e.description??`Variant ${t+1}`}:`)}`}function Me(e,t=0){let n=e.required?A.option(`<${e.name}>`):A.placeholder(`[${e.name}]`),r=e.named?`${n}, ${U(e)}`:n,i=[K(e),e.defaultValue===void 0?void 0:A.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)].filter(Boolean).join(` `);return i?G(r,i,t):`${` `.repeat(t)} ${r}`}function Ne(e){let t=f(e);if(!t)return``;let n=[];if(t.schemaType===`discriminatedUnion`&&t.discriminator){let e=t.discriminator;n=(t.variants??[]).map(t=>({label:Ae(e,t),fields:t.fields}))}else(t.schemaType===`union`||t.schemaType===`xor`)&&t.unionOptions&&(n=t.unionOptions.map((e,t)=>({label:je(e,t),fields:e.fields})));let r=n.length>0?m(n):void 0,i=t.fields.filter(e=>e.positional&&(r===void 0||r.has(e.name))).map(e=>Me(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=>Me(e,1)))}return i.join(`
11
- `)}function Pe(t,n={},r){let i=[],a={help:n.help??B.help,helpAll:n.helpAll??B.helpAll,helpJson:n.helpJson??B.helpJson,version:n.version??B.version},o=f(t),s=o?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`h`))??!1,c=o?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`H`))??!1;if(s?i.push(G(A.option(`--help`),a.help)):i.push(G(`${A.option(`-h`)}, ${A.option(`--help`)}`,a.help)),c?i.push(G(A.option(`--help-all`),a.helpAll)):i.push(G(`${A.option(`-H`)}, ${A.option(`--help-all`)}`,a.helpAll)),i.push(G(A.option(`--help-json`),a.helpJson)),r?.rootVersion&&i.push(G(A.option(`--version`),a.version)),!o)return i.join(`
12
- `);if(o.schemaType===`discriminatedUnion`&&o.discriminator)return Fe(o,t,i);if(o.schemaType===`union`&&o.unionOptions||o.schemaType===`xor`&&o.unionOptions)return Ie(o,t,i);let l=[],u=o.fields.filter(e=>!e.positional);for(let e of u){let t=U(e),n=K(e);e.defaultValue!==void 0&&(n+=` ${A.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${A.required(`(required)`)}`);let r=W(e.env);r&&(n+=` ${r}`),l.push(G(t,n));let i=H(e);i&&l.push(i)}return l.push(...i),l.join(`
13
- `)}function H(e,t=0,n=0){return!e.negationDisplay||!e.negationDescription?null:G(A.option(`--${e.negationDisplay}`),`${e.negationDescription} ${A.dim(`(↔ --${e.cliName})`)}`,t,n)}function Fe(e,t,n){let r=[],i=e.discriminator,a=e.variants??[],o=u(e,i);if(o){let t=a.map(e=>e.discriminatorValue).join(`|`),n=`${A.option(`--${i}`)} ${A.placeholder(`<${t}>`)}`,s=e.description??o.description??`Action to perform`;r.push(G(n,s))}let s=m(a,i);for(let t of s){let n=e.fields.find(e=>e.name===t);if(n&&!n.positional){let e=U(n),t=K(n);n.defaultValue!==void 0&&(t+=` ${A.defaultValue(`(default: ${JSON.stringify(n.defaultValue)})`)}`);let i=W(n.env);i&&(t+=` ${i}`),r.push(G(e,t));let a=H(n);a&&r.push(a)}}r.push(...n);for(let e of a){let t=e.fields.filter(e=>e.name!==i&&!s.has(e.name)&&!e.positional),n=b(e.fields.find(e=>e.name===i)?.requiredPackages);if(t.length>0||n){r.push(``),r.push(Ae(i,e)),n&&r.push(ze(n,2));for(let e of t){let t=U(e),n=K(e);e.defaultValue!==void 0&&(n+=` ${A.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${A.required(`(required)`)}`);let i=W(e.env);i&&(n+=` ${i}`),r.push(G(t,n,1));let a=H(e,1);a&&r.push(a)}}}return r.join(`
14
- `)}function Ie(e,t,n){let r=[],i=e.unionOptions??[],a=m(i);for(let t of a){let n=e.fields.find(e=>e.name===t);if(n&&!n.positional){let e=U(n),t=K(n);n.defaultValue!==void 0&&(t+=` ${A.defaultValue(`(default: ${JSON.stringify(n.defaultValue)})`)}`);let i=W(n.env);i&&(t+=` ${i}`),r.push(G(e,t));let a=H(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=je(t,e);if(n.length>0){r.push(``),r.push(o);for(let e of n){let t=U(e),n=K(e);e.defaultValue!==void 0&&(n+=` ${A.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${A.required(`(required)`)}`);let i=W(e.env);i&&(n+=` ${i}`),r.push(G(t,n,1));let a=H(e,1);a&&r.push(a)}}else r.push(``),r.push(o),r.push(` ${A.dim(A.italic(`no options`))}`)}return r.join(`
15
- `)}function U(e){let t=[];if(e.alias)for(let n of e.alias)n.length===1&&t.push(A.option(`-${n}`));let n=A.option(`--${e.cliName}`);if(e.type!==`boolean`){let t=e.placeholder??e.cliName.toUpperCase();n+=` ${A.placeholder(`<${t}>`)}`}if(t.push(n),e.alias){for(let n of e.alias)if(n.length>1){let r=A.option(`--${n}`);if(e.type!==`boolean`){let t=e.placeholder??e.cliName.toUpperCase();r+=` ${A.placeholder(`<${t}>`)}`}t.push(r)}}let r=t.join(`, `);return e.type===`boolean`&&e.negationDisplay&&!e.negationDescription?`${r} / ${A.option(`--${e.negationDisplay}`)}`:r}function W(e){if(!e)return``;let t=Array.isArray(e)?e:[e];return A.dim(`[env: ${t.join(`, `)}]`)}function Le(e){return e.replace(/\x1B\[[0-9;]*m/g,``)}function Re(e,t){let n=Le(e).length,r=Math.max(0,t-n);return e+` `.repeat(r)}function ze(e,t){if(!e.includes(`
16
- `))return e;let n=` `.repeat(t);return e.split(`
17
- `).join(`\n${n}`)}function G(e,t,n=0,r=0){let i=` `.repeat(n),a=Le(e).length,o=32-n*2+r,s=o+2+n*2,c=ze(t,s);return a>=o?`${i} ${e}\n${` `.repeat(s)}${c}`:`${i} ${Re(e,o)}${c}`}function Be(e,t=0,n=0){let r=U(e),i=K(e);e.defaultValue!==void 0&&(i+=` ${A.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(i+=` ${A.required(`(required)`)}`);let a=W(e.env);return a&&(i+=` ${a}`),G(r,i,t,n)}function Ve(e){let t=[];for(let n of e.fields){if(n.positional)continue;t.push(Be(n));let e=H(n);e&&t.push(e)}return t.join(`
18
- `)}function He(e,t){let n=[],r=f(e);if(r){let e=r.fields.filter(e=>!e.positional);for(let r of e){let e=U(r),i=K(r);r.defaultValue!==void 0&&(i+=` ${A.defaultValue(`(default: ${JSON.stringify(r.defaultValue)})`)}`);let a=W(r.env);a&&(i+=` ${a}`),n.push(G(e,i,t,2));let o=H(r,t,2);o&&n.push(o)}}return n}function Ue(e,t,n){let r=[];for(let[i,a]of V(e)){let e=v(a),o=t?`${t} ${i}`:i,s=[e?.description,b(e?.requiredPackages)].filter(Boolean).join(`
19
- `),c=e?.aliases,l=c&&c.length>0?`${o}, ${c.join(`, `)}`:o;if(r.push(G(A.command(l),s,n)),e){let t=He(e,n+1);r.push(...t);let i=e.subCommands?Object.fromEntries(V(e.subCommands)):void 0;if(i&&Object.keys(i).length>0){let e=Ue(i,o,n);r.push(...e)}}}return r}function We(e,t){let n=[],r=t.context;t.agentHelp&&n.push(ue(t.agentHelp));let i=De(e,r);if(i){let e=A.commandName(i);r?.rootName&&r.commandPath&&r.commandPath.length>0?r.rootVersion?e+=` ${A.version(`(${r.rootName} v${r.rootVersion})`)}`:e+=` ${A.version(`(${r.rootName})`)}`:r?.rootVersion&&(e+=` ${A.version(`v${r.rootVersion}`)}`),n.push(e)}r?.aliasFor&&n.push(A.dim(`Alias for ${A.commandName(r.aliasFor)}`)),e.description&&n.push(e.description),!r?.aliasFor&&e.aliases&&e.aliases.length>0&&n.push(`${A.sectionHeader(`Aliases:`)} ${e.aliases.map(e=>A.command(e)).join(`, `)}`),n.push(`${A.sectionHeader(`Usage:`)} ${ke(e,r)}`);let a=Ne(e);a&&n.push(`${A.sectionHeader(`Arguments:`)}\n${a}`);let o=Pe(e,t.descriptions,r);if(o&&n.push(`${A.sectionHeader(`Options:`)}\n${o}`),r?.globalExtracted?.fields.length&&n.push(`${A.sectionHeader(`Global Options:`)}\n${Ve(r.globalExtracted)}`),t.showSubcommands!==!1&&e.subCommands&&V(e.subCommands).length>0){let i=r?.commandPath?.join(` `)??``,a=Object.fromEntries(V(e.subCommands));if(t.showSubcommandOptions){let e=Ue(a,i,0);n.push(`${A.sectionHeader(`Commands:`)}\n${e.join(`
20
- `)}`)}else{let e=[];for(let[t,n]of Object.entries(a)){let r=v(n),a=[r?.description,b(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(G(A.command(c),a))}n.push(`${A.sectionHeader(`Commands:`)}\n${e.join(`
22
- `)}`)}}if(e.examples&&e.examples.length>0){let t=qe(e.examples,r);n.push(`${A.sectionHeader(`Examples:`)}\n${t}`)}let s=b(e.requiredPackages);if(s&&n.push(`${A.sectionHeader(`Required packages:`)}\n${s}`),e.notes){let t=ue(e.notes).split(`
23
- `).map(e=>e===``?``:` ${e}`).join(`
24
- `);n.push(`${A.sectionHeader(`Notes:`)}\n${t}`)}return`\n${n.join(`
25
-
26
- `)}\n`}function K(e){return[e.description,b(e.requiredPackages)].filter(Boolean).join(`
27
- `)}function q(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:T(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 Ge(e,t){let n=Oe(e,t),r=!!t?.globalExtracted?.fields.length,i=e.subCommands&&V(e.subCommands).length>0?e.run?`optional`:`required`:void 0,a=f(e);return{commandName:n,hasGlobalOptions:r,hasOptions:a?p(a).length>0:!1,subcommand:i,positionals:a?o(a).map(e=>({name:e.name,required:e.required})):[]}}function Ke(e,t={}){let n=t.context,r=n?.commandPath??[],i={help:t.descriptions?.help??B.help,helpAll:t.descriptions?.helpAll??B.helpAll,helpJson:t.descriptions?.helpJson??B.helpJson,...n?.rootVersion?{version:t.descriptions?.version??B.version}:{}},a=f(e),s,c=[],l=[],d,p,h;if(a){if(s=a.schemaType,c=o(a).map(q),a.schemaType===`discriminatedUnion`&&a.discriminator&&a.variants){let e=a.discriminator;d=e;let t=a.variants,n=m(t,e),r=u(a,e),i=a.fields.filter(e=>!e.positional&&n.has(e.name));l=[...r?[{...q({...r,requiredPackages:void 0}),description:a.description??r.description??`Action to perform`}]:[],...i.map(q)],p=t.map(t=>{let r=t.fields.find(t=>t.name===e);return{discriminatorValue:t.discriminatorValue,...r?.requiredPackages?.length?{requiredPackages:q(r).requiredPackages}:{},description:t.description,fields:t.fields.filter(t=>t.name!==e&&!n.has(t.name)).map(q)}})}else if((a.schemaType===`union`||a.schemaType===`xor`)&&a.unionOptions){let e=a.unionOptions,t=m(e);l=a.fields.filter(e=>!e.positional&&t.has(e.name)).map(q),h=e.map(e=>({description:e.description,fields:e.fields.filter(e=>!t.has(e.name)).map(q)}))}else l=a.fields.filter(e=>!e.positional).map(q)}let g=n?.globalExtracted?.fields.length?n.globalExtracted.fields.filter(e=>!e.positional).map(q):void 0,_;if(e.subCommands){let i=V(e.subCommands);i.length>0&&(_=i.map(([i,a])=>{let o=v(a);if(!o)return{name:i,unresolved:!0};let s={commandPath:[...r,i],rootName:n?.rootName??e.name,rootVersion:n?.rootVersion,globalExtracted:n?.globalExtracted};return{name:i,aliases:o.aliases,data:Ke(o,{descriptions:t.descriptions,context:s})}}))}return{name:e.name??`command`,commandPath:r,rootName:n?.rootName,version:n?.rootVersion,aliasFor:n?.aliasFor,description:e.description,aliases:e.aliases,usage:Ge(e,n),builtinOptions:i,schemaType:s,positionals:c,options:l,discriminator:d,variants:p,unionOptions:h,globalOptions:g,subcommands:_,examples:e.examples,notes:e.notes,...e.requiredPackages?.length?{requiredPackages:e.requiredPackages.map(e=>({name:e.name,install:T(e),description:e.description}))}:{},agentHelp:t.agentHelp}}function qe(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(` ${A.dim(t.desc).split(`
28
- `).join(`
29
- `)}`),n.push(` ${A.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 Je=class extends Error{constructor(e){super(e),this.name=`PositionalConfigError`}},Ye=class extends Error{constructor(e){super(e),this.name=`ReservedAliasError`}},Xe=class extends Error{constructor(e){super(e),this.name=`DuplicateFieldError`}},Ze=class extends Error{constructor(e){super(e),this.name=`DuplicateAliasError`}},Qe=class extends Error{constructor(e){super(e),this.name=`CaseVariantCollisionError`}},$e=class extends Error{constructor(e){super(e),this.name=`DuplicateNegationError`}},et=class extends Error{constructor(e){super(e),this.name=`ReservedFieldNameError`}},tt=class extends Error{constructor(e){super(e),this.name=`DefaultSubCommandError`}},nt=class extends Error{constructor(e){super(e),this.name=`FieldTypeConflictError`}};function rt(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 it(e,n){let r=[],i=/* @__PURE__ */ new Map;for(let a of e.fields){let e=t(a.name),o=i.get(e);o&&o!==a.name&&r.push({commandPath:n,type:`case_variant_collision`,message:`Fields "${o}" and "${a.name}" are case variants of each other and would collide.`,field:a.name}),i.set(e,a.name)}return r}function at(n,r){let i=[],a=/* @__PURE__ */ new Map,o=new Set(n.fields.map(e=>e.name)),s=new Set(n.fields.map(e=>e.cliName)),c=(e,t,n)=>{(o.has(e)||s.has(e))&&i.push({commandPath:r,type:`duplicate_alias`,message:`Alias "${e}" for field "${t}" conflicts with existing field name or CLI name "${e}".`,field:t});let c=a.get(e);if(c&&c!==t){let a=n?` (derived camelCase variant)`:``;i.push({commandPath:r,type:`duplicate_alias`,message:`Duplicate alias "${e}"${a} detected. Both "${c}" and "${t}" use the same alias.`,field:t})}a.set(e,t)};for(let r of n.fields){let n=e(r);if(n.length!==0){for(let e of n)if(c(e,r.name,!1),e.length>1&&e.includes(`-`)){let n=t(e);n!==e&&!o.has(n)&&c(n,r.name,!0)}}}return i}function ot(n,r){let i=[],a=/* @__PURE__ */ new Map,o=(e,t,n)=>{a.has(e)||a.set(e,{field:t,kind:n})};for(let r of n.fields){if(o(r.name,r.name,`field name`),r.name.includes(`-`)){let e=t(r.name);e!==r.name&&o(e,r.name,`field name`)}if(r.cliName!==r.name&&o(r.cliName,r.name,`CLI name`),r.cliName.includes(`-`)){let e=t(r.cliName);e!==r.cliName&&o(e,r.name,`CLI name`)}for(let n of e(r))if(o(n,r.name,`alias`),n.length>1&&n.includes(`-`)){let e=t(n);e!==n&&o(e,r.name,`alias`)}if(r.type===`boolean`&&r.negation===!0){let e=`no-${r.cliName}`;o(e,r.name,`default negation`);let n=t(r.cliName),i=`no${n[0]?.toUpperCase()??``}${n.slice(1)}`;i!==e&&o(i,r.name,`default negation`)}}let s=/* @__PURE__ */ new Map,c=(e,t,n)=>{let o=a.get(e);if(o){let a=n?` (derived camelCase variant)`:``,s=o.field===t?`the same field's own ${o.kind} "${e}"`:`${o.kind} "${e}" of field "${o.field}"`;i.push({commandPath:r,type:`duplicate_negation`,message:`Negation "${e}"${a} for field "${t}" conflicts with ${s}.`,field:t})}let c=s.get(e);if(c&&c!==t){let a=n?` (derived camelCase variant)`:``;i.push({commandPath:r,type:`duplicate_negation`,message:`Duplicate negation "${e}"${a} detected. Both "${c}" and "${t}" use the same negation name.`,field:t})}s.set(e,t)};for(let e of n.fields)if(typeof e.negation==`string`&&(c(e.negation,e.name,!1),e.negation.includes(`-`))){let n=t(e.negation);n!==e.negation&&c(n,e.name,!0)}return i}function st(e,t){let n=[e,...e.variants??[],...e.unionOptions??[]],r=/* @__PURE__ */ new Set;return n.flatMap(e=>ct(e.fields,t)).filter(e=>!r.has(e.message)&&r.add(e.message))}function ct(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 lt(t,r){let i=[];for(let a of t.fields){if(a.overrideBuiltinAlias!==!0)for(let t of e(a))(t===`h`||t===`H`)&&i.push({commandPath:r,type:`reserved_alias`,message:`Alias "${t}" is reserved for --${t===`h`?`help`:`help-all`}. To override this, set { overrideBuiltinAlias: true } for "${a.name}" and keep the alias where it is currently defined (in alias or hiddenAlias).`,field:a.name});let t=/* @__PURE__ */ new Set([a.cliName,...e(a)]);for(let e of t){if(!n.has(e))continue;let t=e===a.cliName;i.push({commandPath:r,type:`reserved_alias`,message:`${t?`Field "${a.name}"`:`Alias "${e}" for field "${a.name}"`} collides with the built-in --${e} option, which always takes precedence. Rename the field or its alias; this collision cannot be overridden.`,field:a.name})}}return i}function ut(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 dt(e){let t=rt(e,[]);if(t.length>0)throw new Xe(`Duplicate field name "${t[0]?.field??`unknown`}" detected. Each field must have a unique name.`)}function ft(e){let t=at(e,[]);if(t.length>0){let e=t[0];throw new Ze(e.message)}}function pt(e){let t=st(e,[]);if(t.length>0){let e=t[0];throw new Je(e.message)}}function mt(e,t){let n=lt(e,[]);if(n.length>0)throw new Ye(n[0].message)}function ht(e){let t=ut(e,[]);if(t.length>0){let e=t[0];throw new et(e.message)}}function gt(e){let t=ot(e,[]);if(t.length>0){let e=t[0];throw new $e(e.message)}}function _t(e){let t=it(e,[]);if(t.length>0){let e=t[0];throw new Qe(e.message)}}function vt(e,t){if(e.type!==t.type||e.positional!==t.positional)return!1;let n=e.enumValues,r=t.enumValues;if(!n&&!r)return!0;if(!n||!r)return!1;let i=new Set(n),a=new Set(r);if(i.size!==a.size)return!1;for(let e of i)if(!a.has(e))return!1;return!0}function yt(e,n,r){let i=[],a=/* @__PURE__ */ new Map;for(let n of e.fields)a.set(t(n.name),n);for(let e of n.fields){let n=t(e.name),o=a.get(n);o&&(o.name===e.name?vt(o,e)||i.push({commandPath:r,type:`field_type_conflict`,message:`Global field "${o.name}" and command field "${e.name}" share the same name but have different definitions.`,field:e.name}):i.push({commandPath:r,type:`case_variant_collision`,message:`Global field "${o.name}" and command field "${e.name}" are case variants of each other and would collide.`,field:e.name}))}return i}function bt(e,t){let n=yt(e,t,[])[0];if(n)throw n.type===`case_variant_collision`?new Qe(n.message):new nt(n.message)}function xt(e,t,n){return[...rt(e,n),...it(e,n),...at(e,n),...ot(e,n),...st(e,n),...lt(e,n),...ut(e,n)]}function St(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 Ct(e){let t=St(e,[]);if(t.length>0)throw new tt(t[0].message)}function wt(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=S(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 Tt(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 Et(e,t={}){return Dt(e,t,!1)}async function Dt(e,t,n){n||=!!e.requiredPackages?.length;let r=t.commandPath??[e.name],i=[],a=e.subCommands?Object.keys(e.subCommands).length>0:!1,o=t.globalArgs?l(t.globalArgs):void 0;if(e.args){let t=l(e.args);i.push(...xt(t,a,r)),o&&i.push(...yt(o,t,r))}if(i.push(...wt(e,r)),i.push(...St(e,r)),e.subCommands)for(let[a,o]of Object.entries(e.subCommands)){let e=await C(o,e=>n||!!e.requiredPackages?.length);i.push(...Tt(a,e.name,r));let s=await Dt(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 Ot(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 kt(t){let{aliasMap:n=/* @__PURE__ */ new Map,booleanFlags:r=/* @__PURE__ */ new Set,definedNames:i=/* @__PURE__ */ new Set,negationMap:a=/* @__PURE__ */ new Map,defaultNegationDisabledFields:o=/* @__PURE__ */ new Set}=R(t),s=/* @__PURE__ */ new Set;for(let n of t.fields)for(let t of e(n))t.length===1&&s.add(t);return{aliasMap:n,booleanFlags:r,definedNames:i,flagNames:new Set(t.fields.map(e=>e.name)),cliNames:new Set(t.fields.map(e=>e.cliName)),aliases:s,negationMap:a,defaultNegationDisabledFields:o}}function At(e,t){let{resolvedName:n,withoutDashes:r,isNegated:i,isCustomNegation:a,isSuppressedNegation:o}=F(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 J(e,t,n,r,i){return!e.includes(`=`)&&!i.has(t)&&!n&&r!==void 0&&I(r)}function Y(e,t,n,r,i,a){let o=e[t];return a.push(o),J(o,n,r,e[t+1],i)?(a.push(e[t+1]),2):1}function jt(e,t,n,r=()=>!1){let i=e[t];if(!te(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}=ne(i.slice(1),e=>o(e)&&!n.booleanFlags.has(a(e)));return s.every(o)?c&&c.value===void 0&&J(i,a(c.name),!1,e[t+1],n.booleanFlags)?2:1:0}function Mt(e,t,n){let r=kt(n),i=new Set(t),a=[],o=[],s=0;for(;s<e.length;){let t=e[s];if(t===`--`||Nt.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}=At(t,r);if(l){s+=Y(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+=Y(e,s,t,!1,r.booleanFlags,a);continue}}let i=jt(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 Nt=/* @__PURE__ */ new Set([`--help`,`-h`,`--help-all`,`-H`,`--help-json`,`--version`]);function Pt(e,t,n={}){let r=n.stopOnSuppressedNegation===!0||t?.unknownKeysMode===`strict`,i=t?kt(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===`--`||Nt.has(n))return-1;if(n.startsWith(`--`)){let{resolvedName:a,isNegated:o,isGlobal:s,isSuppressedNegation:c}=At(n,i);if(s){J(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)){J(n,r,!1,e[t+1],i.booleanFlags)&&t++;continue}}let o=jt(e,t,i);if(o>0)t+=o-1;else return-1}return-1}function Ft(e,t){let n=Pt(e,t);return n>=0?e[n]:void 0}function It(t,n,r={}){let i=w(n),o=[...i],s=o.length>0,c=s&&!n.run;if(s&&t.length>0){if(r.globalExtracted){let e=Mt(t,o,r.globalExtracted);if(e.subCommandIndex>=0){let n=zt(e.globalTokensBefore,r.globalExtracted);return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:t[e.subCommandIndex],remainingArgs:e.tokensAfterSubcommand,rawArgs:{},positionals:[],rest:[],unknownFlags:e.suppressedTokens,unknownGlobalFlags:e.suppressedTokens,rawGlobalArgs:n}}}else{let e=t[0];if(e&&!e.startsWith(`-`)&&i.has(e))return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:e,remainingArgs:t.slice(1),rawArgs:{},positionals:[],rest:[],unknownFlags:[]}}}let u;n.args&&(u=l(n.args),r.skipValidation||(dt(u),_t(u),ft(u),gt(u),pt(u),mt(u,s),ht(u),r.globalExtracted&&bt(r.globalExtracted,u)));let d=t,f,p=[];if(r.globalExtracted){let e=u?a(u):[],n=new Set(e.map(e=>e.name)),{separated:i,globalParsed:o,suppressedTokens:s}=Bt(t,r.globalExtracted,u&&{...u,fields:[...e,...u.fields.filter(e=>!n.has(e.name))]});d=i,f=o,p=s}let m=t.indexOf(`--`),h=m>=0?t.slice(0,m):t,g=u?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`H`))??!1,_=u?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`h`))??!1,v=h.includes(`--help-all`)||!g&&h.includes(`-H`),y=h.includes(`--help-json`),ee=!v&&!y&&(h.includes(`--help`)||!_&&h.includes(`-h`)),b=h.includes(`--version`);if(ee||v||y||b)return{helpRequested:ee,helpAllRequested:v,helpJsonRequested:y,versionRequested:b,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:[],rest:[],unknownFlags:[],unknownGlobalFlags:p,rawGlobalArgs:f};if(!u){let t=d.indexOf(`--`),n=t>=0?d.slice(0,t):d,i=t>=0?d.slice(t+1):[],a=e=>c&&e.startsWith(`-`)&&e!==`-`,o=new Set(r.globalExtracted?.fields.flatMap(t=>[t.name,t.cliName,...e(t)])),s=r.globalExtracted?R(r.globalExtracted):{},l=n.filter(a).flatMap(e=>Object.keys(j([e],s).options)).filter(e=>!o.has(e));return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:n.filter(e=>!a(e)),rest:i,unknownFlags:l,unknownGlobalFlags:p,rawGlobalArgs:f}}let x=Lt(u,d,{promptAvailable:r.promptAvailable===!0,inheritedNames:r.inheritedNames??/* @__PURE__ */ new Set});if(!x)return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:[],rest:[],unknownFlags:[],unknownGlobalFlags:p,extractedFields:u,matchesNoUnionOption:!0,rawGlobalArgs:f};let S=R(x),C=j(d,{...S,unknownFlagsTakeNoValue:c}),T=P(C,x),E=X(T,x),D=x.fields.filter(e=>e.named),O=new Set(D.map(e=>e.name)),k=new Set(D.map(e=>e.cliName)),A=/* @__PURE__ */ new Set;for(let t of D)for(let n of e(t))A.add(n);if(r.globalExtracted)for(let t of r.globalExtracted.fields){O.add(t.name),k.add(t.cliName);for(let n of e(t))A.add(n)}let M=[];for(let e of Object.keys(C.options))!O.has(e)&&!k.has(e)&&!A.has(e)&&M.push(e);return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:T,positionals:C.positionals,rest:C.rest,unknownFlags:M,unknownGlobalFlags:p,extractedFields:u,optionFields:D,positionalSlotFields:L(x,C.options),rawGlobalArgs:f,envFallbackFields:E}}function Lt(e,t,n){let{discriminator:r,variants:i,unionOptions:a}=e;if(r&&i){let n=e=>{let n=P(j(t,R(e)),e);return X(n,e),n},r=c(e,n);return r===e?i.some(t=>{let r=n({...e,fields:t.fields});return c(e,()=>r)!==e})?void 0:e:r}if(a){let r=a.flatMap(e=>{let r=Lt(e,t,n);return r?[r]:[]}),i=n.promptAvailable?r.filter(e=>Rt(e,t,void 0)):[],o=r.find(e=>Rt(e,t,n.inheritedNames))??(i.length===1?i[0]:void 0);return o&&{...e,fields:o.fields}}return e}function X(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]=N(i,r.type),n.add(r.name);break}}return n}function Rt(t,n,r){let i=j(n,R(t)),a=t.fields.filter(e=>e.named),o=new Set(a.flatMap(t=>[t.name,t.cliName,...e(t)]));if(Object.keys(i.options).some(e=>!o.has(e)))return!1;let s=L(t,i.options),c=i.positionals.length+i.rest.length;if(!s.some(e=>e.type===`array`)&&c>s.length)return!1;let l=P(i,t);return t.fields.some(e=>e.type!==`boolean`&&[l[e.name]].flat().includes(!0))?!1:r===void 0||(X(l,t),t.fields.every(e=>!e.required||l[e.name]!==void 0||r.has(e.name)))}function zt(e,t){if(e.length===0)return{};let n=R(t),r=j(e,n);return P(r,t)}function Bt(n,r,i){let a=kt(r),o=new Set(i?.fields.map(e=>e.name)??[]),s=new Set(i?.fields.map(e=>e.cliName)??[]),c=i?R(i):void 0,l=new Set(c?.aliasMap?.keys()??[]),u=new Set(c?.negationMap?.keys()??[]),d=/* @__PURE__ */ new Set;for(let n of i?.fields??[])if(n.type===`boolean`&&n.negation===!0)for(let r of[n.cliName,...e(n)]){let e=`no-${r}`;d.add(e),d.add(t(e))}let f=[],p=[],m=[];for(let e=0;e<n.length;e++){let t=n[e];if(t===`--`){p.push(...n.slice(e));break}if(t.startsWith(`--`)){let{resolvedName:r,withoutDashes:i,isNegated:c,isGlobal:p,isSuppressedNegation:h}=At(t,a),g=r,_=o.has(i)||o.has(g)||s.has(i)||s.has(g)||l.has(i)||l.has(g)||u.has(i)||u.has(g)||d.has(i);if(p&&!_){e+=Y(n,e,r,c,a.booleanFlags,f)-1;continue}if(h&&!_){m.push(i);continue}}else if(t.startsWith(`-`)&&t.length>1){let r=t.includes(`=`)?t.slice(1,t.indexOf(`=`)):t.slice(1);if(r.length===1){let t=a.aliasMap.get(r)??r;if((a.aliases.has(r)||a.flagNames.has(t))&&!l.has(r)){e+=Y(n,e,t,!1,a.booleanFlags,f)-1;continue}}let i=jt(n,e,a,e=>l.has(e));if(i>0){f.push(...n.slice(e,e+i)),e+=i-1;continue}}p.push(t)}return{separated:p,globalParsed:zt(f,r),suppressedTokens:m}}function Vt(e,t){return s(t)?d(e,t):i().validate(e,t)}function Z(e){return e.map(e=>`${e.path.length>0?`${e.path.join(`.`)}: `:``}${e.message}`).join(`
33
- `)}function Ht(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 Ut(e,t){let n=Math.max(2,Math.floor(e.length/2));return t.map(t=>({candidate:t,distance:Ht(e.toLowerCase(),t.toLowerCase())})).filter(({distance:e})=>e<=n).sort((e,t)=>e.distance-t.distance).map(({candidate:e})=>e).slice(0,3)}function Wt(e,t){let n=Ut(e.replace(/^-{1,2}/,``),t),r=`${A.warning(`Warning: Unknown option:`)} ${A.bold(e)}`;if(n.length>0){r+=`\n\n${A.info(`Did you mean?`)}`;for(let e of n)r+=`\n ${k.arrow} ${A.option(`--${e}`)}`}return r}function Gt(e,t){return t&&e.stack?`${A.error(`Error:`)} ${e.message}\n\n${A.dim(e.stack)}`:`${A.error(`Error:`)} ${e.message}`}function Q(e){return new Proxy(e,{get(e,n,i){if(typeof n==`string`){if(n in e)return Reflect.get(e,n,i);let a=t(n);if(a!==n&&a in e)return Reflect.get(e,a,i);let o=r(n);if(o!==n&&o in e)return Reflect.get(e,o,i)}return Reflect.get(e,n,i)},has(e,n){if(typeof n==`string`){if(n in e)return!0;let i=t(n);if(i!==n&&i in e)return!0;let a=r(n);if(a!==n&&a in e)return!0}return Reflect.has(e,n)}})}async function Kt(e,t,n){for(let r of t.fields)r.effect&&await r.effect(e[r.name],{name:r.name,args:e,...n!=null&&{globalArgs:n}})}const qt={log:e=>console.log(e),error:e=>console.error(e),warn:e=>console.warn(e)};function Jt(e,n){Object.defineProperty(e,"$source",{value:e=>n.get(e)??n.get(t(e))??n.get(r(e))??`default`,enumerable:!1})}function Yt(e,t){Object.defineProperty(e,"$invocation",{value:t,enumerable:!1})}function Xt(e,t){Object.defineProperty(e,"$agent",{value:t,enumerable:!1})}function Zt(e,t){return e&&(n=>e({...n,agent:t}))}function Qt(e,t){let{agentHelp:n,_agent:r}=e;if(n&&r)return typeof n==`string`?n:n({agent:r,commandPath:t.commandPath??[]})}function $t(e,t){let n=t.commandPath?.at(-1)??e.name;return t.aliasFor?{name:n,aliasFor:t.aliasFor}:{name:n}}async function en(e,t,n={}){let r=an(n),i=h(),a=Zt(n.cleanup,i),o=n.captureLogs??!1,s=o?O():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()??E()}}s?.stop()}let c=await $(e,t,{...n,handleSignals:!1,_globalExtracted:r,_globalCleanup:a,_existingLogs:s?.getLogs(),_agent:i});if(a){let e=o?O():null;e?.start();let t={error:c.success?void 0:c.error};try{await a(t)}catch(t){if(c.success){let n=t instanceof Error?t:Error(String(t));return e?.stop(),{success:!1,error:n,exitCode:1,logs:D(c.logs,e?.getLogs()??E())}}}e?.stop();let n=e?.getLogs()??E();if(n.entries.length>0)return{...c,logs:D(c.logs,n)}}return c}function tn(e,t,n){let r=Ft(t,n);return!r||!r.startsWith(`__`)?!1:Object.hasOwn(e.subCommands??{},r)}async function nn(e,t={}){if(t.compileCache!==!1&&g(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=l(t.globalArgs)}catch{}let i=t;if(tn(e,n,r)){let{setup:e,cleanup:n,prompt:r,globalArgs:a,...o}=t;i=o}let a=an(i),o=h(),s=Zt(i.cleanup,o);if(i.skipValidation||Ct(e),i.onUnknownSubcommand&&!e.run&&!tn(e,n,r)){let t=w(e);if(t.size>0){let e=Pt(n,a,{stopOnSuppressedNegation:a?.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 rn(),process.exit(a)}}}if(i.setup)try{await i.setup({agent:o})}catch(e){let t=e instanceof Error?e:Error(String(e));if(s)try{await s({error:t})}catch{}process.exit(1)}let c=await $(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:a,_globalCleanup:s,_agent:o,_context:{commandPath:[],rootName:e.name,rootVersion:i.version,globalExtracted:a}});if((i.displayErrors??!0)&&!c.success&&c.error&&(i.logger??qt).error(Gt(c.error,i.debug??!1)),s){let e={error:c.success?void 0:c.error};try{await s(e)}catch{}}await rn(),process.exit(c.exitCode)}async function rn(){await Promise.all([process.stdout,process.stderr].map(e=>e.writableLength>0?new Promise(t=>e.write(``,()=>t())):Promise.resolve()))}async function $(e,t,n={}){let r=n.logger??qt,i=n._context??{commandPath:[],rootName:e.name,globalExtracted:n._globalExtracted},a=n.captureLogs??!1?O():null;a?.start();let o=()=>{let e=n._existingLogs??E(),t=a?.getLogs()??E();return D(e,t)};try{n.skipValidation||Ct(e);let s=It(t,e,{skipValidation:n.skipValidation,globalExtracted:n._globalExtracted,promptAvailable:n.prompt!==void 0,inheritedNames:new Set(Object.keys(n._parsedGlobalArgs??{}))}),l={...n._parsedGlobalArgs,...s.rawGlobalArgs},u=i.commandPath??[];if(n.onUnknownSubcommand&&!e.run&&u.length>0){let r=w(e);if(r.size>0){let e=Pt(t,n._globalExtracted,{stopOnSuppressedNegation:n._globalExtracted?.unknownKeysMode!==`passthrough`}),i=e>=0?t[e]:void 0;if(i&&!r.has(i)){let r=t.slice(e+1),s=await n.onUnknownSubcommand({commandPath:u,name:i,args:r,precedingArgs:[...n._precedingArgs??[],...t.slice(0,e)]});if(typeof s==`number`){if(a?.stop(),n.handleSignals){if(n._globalCleanup)try{await n._globalCleanup({error:void 0})}catch{}await rn(),process.exit(s)}return s===0?{success:!0,result:void 0,exitCode:0,logs:o()}:{success:!1,error:/* @__PURE__ */ Error(`Plugin "${[...u,i].join(` `)}" exited with code ${s}`),exitCode:s,logs:o()}}}}}if(s.helpRequested||s.helpAllRequested||s.helpJsonRequested){let c=!1,l=x(e),u=w(e);if(l.length>0){let e=Ft(t,i.globalExtracted);e&&!u.has(e)&&(c=!0)}let d=Qt(n,i);if(s.helpJsonRequested){let t=Ke(e,{context:i,agentHelp:d});r.log(JSON.stringify(t))}else{let t=We(e,{showSubcommands:n.showSubcommands??!0,showSubcommandOptions:s.helpAllRequested||n.showSubcommandOptions,context:i,agentHelp:d});r.log(t)}if(a?.stop(),c){let e=Ft(t,i.globalExtracted)??``,n=Ut(e,[...u]),r=n.length>0?` Did you mean: ${n.join(`, `)}?`:``;return{success:!1,error:/* @__PURE__ */ Error(`Unknown subcommand: ${e}${r?`.${r}`:``}`),exitCode:2,logs:o()}}return{success:!0,result:void 0,exitCode:0,logs:o()}}if(s.unknownGlobalFlags&&s.unknownGlobalFlags.length>0){let e=i.globalExtracted?.unknownKeysMode??`strip`;if(e===`strict`)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown flags: ${s.unknownGlobalFlags.join(`, `)}`),exitCode:2,logs:o()};if(e===`strip`){let e=i.globalExtracted?.fields.map(e=>e.name)??[];for(let t of s.unknownGlobalFlags)r.error(Wt(t,e))}}if(s.versionRequested){let e=i.rootVersion;return e&&r.log(e),a?.stop(),{success:!0,result:void 0,exitCode:0,logs:o()}}if(s.subCommand){let r=n._metadataOnly??!1,c=await _(e,s.subCommand,e=>{if(r)return!0;if(!e.requiredPackages?.length)return!1;let t=e,a=s.remainingArgs;for(;;){let e=It(a,t,{skipValidation:n.skipValidation,globalExtracted:i.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:ee(t,e.subCommand)??e.subCommand,s=t.subCommands[o],c=s?v(s):null;if(!c)return!1;t=c,a=e.remainingArgs}});if(c){let e={commandPath:[...i.commandPath??[],s.subCommand],rootName:i.rootName,rootVersion:i.rootVersion,globalExtracted:i.globalExtracted,aliasFor:c.aliasFor};a?.stop();let u=new Set(n._globalExtracted?.unknownKeysMode===`passthrough`?[]:s.unknownGlobalFlags??[]),d=e=>e.startsWith(`--`)&&u.has(M(e)),f=t.slice(0,t.length-s.remainingArgs.length-1).filter(e=>!d(e));return $(c.command,s.remainingArgs,{...n,_metadataOnly:r,_context:e,_existingLogs:o(),_parsedGlobalArgs:l,_precedingArgs:[...n._precedingArgs??[],...f]})}}let d=s.positionalSlotFields??[],f=d.some(e=>e.type===`array`),p=[...s.positionals,...s.rest],m=f?[]:p.slice(d.length),h=f?[]:s.positionals.slice(d.length);if(s.matchesNoUnionOption)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Arguments match none of the accepted forms. See --help for the accepted forms.`),exitCode:2,logs:o()};let g=w(e),y=g.size>0?h.find(e=>!e.startsWith(`-`)&&!g.has(e)):void 0;if(y){let e=Ut(y,[...g]),t=e.length>0?` Did you mean: ${e.join(`, `)}?`:``;return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown subcommand: ${y}${t?`.${t}`:``}`),exitCode:2,logs:o()}}if(s.unknownFlags.length>0){let e=s.extractedFields?.unknownKeysMode??i.globalExtracted?.unknownKeysMode??`strip`,t=s.optionFields?.map(e=>e.name)??i.globalExtracted?.fields.map(e=>e.name)??[];if(e===`strict`)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown flags: ${s.unknownFlags.join(`, `)}`),exitCode:2,logs:o()};if(e===`strip`)for(let e of s.unknownFlags)r.error(Wt(e,t))}if(x(e).length>0&&!s.subCommand&&!e.run&&m.length===0){if(e.defaultSubCommand){let r=e.subCommands?.[e.defaultSubCommand];if(r){let c=await C(r),u={commandPath:[...i.commandPath??[],e.defaultSubCommand],rootName:i.rootName,rootVersion:i.rootVersion,globalExtracted:i.globalExtracted};a?.stop();let d=new Set(n._globalExtracted?.unknownKeysMode===`passthrough`?[]:s.unknownGlobalFlags??[]),f=e=>e.startsWith(`--`)&&d.has(M(e)),p=t.filter(e=>!f(e));return $(c,[],{...n,_context:u,_existingLogs:o(),_parsedGlobalArgs:l,_precedingArgs:[...n._precedingArgs??[],...p]})}}if(n.globalArgs&&n._globalExtracted){let e={...l};X(e,n._globalExtracted);let t=Vt(e,n.globalArgs),r=t.success?[]:t.errors.filter(t=>t.path[0]&&e[t.path[0]]!==void 0);if(r.length>0)return a?.stop(),{success:!1,error:Error(Z(r)),exitCode:2,logs:o()}}let c=We(e,{showSubcommands:n.showSubcommands??!0,context:i,agentHelp:Qt(n,i)});return r.log(c),a?.stop(),{success:!0,result:void 0,exitCode:0,logs:o()}}if(m.length>0){let e=s.extractedFields?.unknownKeysMode??`strip`;if(e===`strict`)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unexpected positional argument${m.length>1?`s`:``}: ${m.join(`, `)}`),exitCode:2,logs:o()};if(e===`strip`)for(let e of m)(r.warn??r.error)(`Warning: Unexpected positional argument: ${e}`)}let b={},S=e.name===`__complete`,T=new Set(Object.keys(l)),E=/* @__PURE__ */ new Set;if(n.globalArgs&&n._globalExtracted&&!S){if(E=X(l,n._globalExtracted),n.prompt){let e=await n.prompt(l,n._globalExtracted);for(let[t,n]of Object.entries(e))n!==void 0&&(l[t]=n)}let e=Vt(l,n.globalArgs);if(!e.success)return a?.stop(),{success:!1,error:Error(Z(e.errors)),exitCode:2,logs:o()};b=e.data}if(!e.args){let t=/* @__PURE__ */ new Map;for(let e of T)t.set(e,`cli`);for(let e of E)t.set(e,`env`);Jt(b,t),Yt(b,$t(e,i)),Xt(b,n._agent);let r=Q(b);return n._globalExtracted&&!S&&await Kt(r,n._globalExtracted,r),a?.stop(),await ie(e,r,{handleSignals:n.handleSignals,captureLogs:n.captureLogs,existingLogs:o(),globalCleanup:n._globalCleanup,packageDiscriminators:n._globalExtracted?.discriminator?[n._globalExtracted.discriminator]:[],packageFields:S||!n._globalExtracted?void 0:c(n._globalExtracted,()=>b).fields})}let D=s.rawArgs,O=/* @__PURE__ */ new Set;if(n.prompt&&s.extractedFields){let e=await n.prompt(D,s.extractedFields),t={...D};for(let[n,r]of Object.entries(e))r!==void 0&&(t[n]=r,O.add(n));D=t}let k=/* @__PURE__ */ new Set;if(s.extractedFields)for(let e of s.extractedFields.fields)!(Object.hasOwn(s.rawArgs,e.name)||O.has(e.name))&&T.has(e.name)&&Object.hasOwn(b,e.name)&&(D={...D,[e.name]:b[e.name]},k.add(e.name));let A=Vt(D,e.args);if(!A.success)return a?.stop(),{success:!1,error:Error(Z(A.errors)),exitCode:2,logs:o()};let j=Q(A.data),N=/* @__PURE__ */ new Map;for(let e of T)N.set(e,`cli`);for(let e of E)N.set(e,`env`);Jt(b,N),Yt(b,$t(e,i)),Xt(b,n._agent);let P=Q(b);n._globalExtracted&&!S&&await Kt(P,n._globalExtracted,P),s.extractedFields&&!S&&await Kt(j,s.extractedFields,P);let F={...P,...j},I=new Map(N),L=s.envFallbackFields??/* @__PURE__ */ new Set;for(let e of s.extractedFields?.fields??[]){if(k.has(e.name)){I.set(e.name,`cli`);continue}let t=Object.hasOwn(s.rawArgs,e.name)||L.has(e.name);I.set(e.name,t?L.has(e.name)?`env`:`cli`:`default`)}Jt(F,I),Yt(F,$t(e,i)),Xt(F,n._agent);let te=Q(F);return a?.stop(),await ie(e,te,{handleSignals:n.handleSignals,captureLogs:n.captureLogs,existingLogs:o(),globalCleanup:n._globalCleanup,packageDiscriminators:[s.extractedFields?.discriminator,n._globalExtracted?.discriminator].filter(e=>e!==void 0),packageFields:S?void 0:[...n._globalExtracted?c(n._globalExtracted,()=>b).fields:[],...s.optionFields??[],...s.positionalSlotFields??[]]})}catch(e){let t=e instanceof Error?e:Error(String(e));return a?.stop(),{success:!1,error:t,exitCode:1,logs:o()}}}function an(e){if(!e.globalArgs)return;let t=l(e.globalArgs);if(!e.skipValidation){dt(t),_t(t),ft(t),gt(t),mt(t,!0),ht(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{Ye as C,z as D,Ke as E,ue as O,Je as S,We as T,tt as _,Ot as a,$e as b,bt as c,dt as d,gt as f,Qe as g,ht as h,Z as i,Ct as l,mt as m,nn as n,_t as o,pt as p,Q as r,Et as s,en as t,ft as u,Ze as v,et as w,nt as x,Xe as y};
@@ -1 +0,0 @@
1
- export{t as runCommand}from"./runner-C5OHC75C.js";
@@ -1 +0,0 @@
1
- import{a as e,t}from"./registry-BEz5iex_.js";const n=`__polittyInternalArgs`,r={string(e){return{kind:`string`,optional:!1,meta:e}},optionalString(e){return{kind:`string`,optional:!0,meta:e}},boolean(e){return{kind:`boolean`,optional:!1,defaultValue:!1,meta:e}},enum(e,t){return{kind:`enum`,enumValues:e,optional:!1,meta:t}},optionalEnum(e,t){return{kind:`enum`,enumValues:e,optional:!0,meta:t}},stringArray(e){return{kind:`string-array`,optional:!1,defaultValue:[],meta:e}},optionalStringArray(e){return{kind:`string-array`,optional:!0,meta:e}}};function i(e,t={}){return{[n]:!0,fields:e,unknownKeys:t.unknownKeys??`strip`}}function a(e){return typeof e==`object`&&!!e&&e[n]===!0}const o={string:`string`,boolean:`boolean`,enum:`string`,"string-array":`array`},s=/* @__PURE__ */ new WeakMap;function c(t){let n=s.get(t);if(n)return n;let r={fields:Object.entries(t.fields).map(([t,n])=>e(t,{argMeta:n.meta,description:void 0,required:!n.optional&&n.defaultValue===void 0,defaultValue:n.defaultValue,type:o[n.kind],enumValues:n.enumValues?[...n.enumValues]:void 0,schema:n})),schema:t,schemaType:`object`,unknownKeysMode:t.unknownKeys};return s.set(t,r),r}function l(e){switch(e.kind){case`enum`:return`one of ${(e.enumValues??[]).map(e=>JSON.stringify(e)).join(` | `)}`;case`string-array`:return`array`;default:return e.kind}}function u(e){return e===null?`null`:Array.isArray(e)?`array`:typeof e}function d(e,t,n){return{path:[e],message:`Invalid input: expected ${l(t)}, received ${u(n)}`,code:`invalid_type`,received:n,expected:l(t)}}function f(e,t,n){switch(t.kind){case`string`:return typeof n==`string`?null:d(e,t,n);case`boolean`:return typeof n==`boolean`?null:d(e,t,n);case`enum`:return typeof n!=`string`||!(t.enumValues??[]).includes(n)?{path:[e],message:`Invalid option: expected ${l(t)}`,code:`invalid_value`,received:n,expected:l(t)}:null;case`string-array`:return!Array.isArray(n)||n.some(e=>typeof e!=`string`)?d(e,t,n):null}}function p(e,t){let n=[],r={};for(let[i,a]of Object.entries(t.fields)){let t=e[i];if(t===void 0){a.defaultValue===void 0?a.optional||n.push(d(i,a,void 0)):r[i]=Array.isArray(a.defaultValue)?[...a.defaultValue]:a.defaultValue;continue}let o=f(i,a,t);o?n.push(o):r[i]=t}let i=new Set(Object.keys(t.fields)),a=Object.keys(e).filter(e=>!i.has(e));if(a.length>0){if(t.unknownKeys===`strict`)n.push({path:[],message:`Unrecognized key${a.length>1?`s`:``}: ${a.map(e=>JSON.stringify(e)).join(`, `)}`,code:`unrecognized_keys`});else if(t.unknownKeys===`passthrough`)for(let t of a)Object.defineProperty(r,t,{value:e[t],enumerable:!0,writable:!0,configurable:!0})}return n.length>0?{success:!1,errors:n}:{success:!0,data:r}}function m(e){return a(e)?e.unknownKeys:t().getUnknownKeysMode(e)}const h=/* @__PURE__ */ new WeakSet;function g(e){let n=a(e)?c(e):t().extractFields(e);return h.has(n)||(_(n),h.add(n)),n}function _(e){let t=e.variants??[e];for(let n of t)for(let t of n.fields)if(t.requiredPackages?.length&&t.type!==`boolean`&&t.name!==e.discriminator)throw Error(`Invalid requiredPackages for field "${t.name}": requiredPackages can only be used on boolean fields or discriminators.`);for(let t of e.unionOptions??[])_(t)}function v(e){return e.args?g(e.args):null}function y(e,t){let[n,...r]=e,i=/* @__PURE__ */ new Set;for(let e of n?.fields??[])e.name!==t&&r.every(t=>t.fields.some(t=>t.name===e.name&&t.positional===e.positional&&t.named===e.named&&b(t.requiredPackages,e.requiredPackages)))&&i.add(e.name);return i}function b(e,t){return(e?.length??0)===(t?.length??0)&&(e??[]).every((e,n)=>{let r=t?.[n];return e.name===r?.name&&e.install===r.install&&e.from?.toString()===r.from?.toString()})}function x(e){let t=w(e).filter(e=>e.named);return T(e,e=>e.named).map(e=>{let n=t.filter(t=>t.name===e.name),r=[...new Set(n.flatMap(e=>e.alias??[]))],i=[...new Set(n.flatMap(e=>e.hiddenAlias??[]))];return{...e,alias:r.length>0?r:e.alias,hiddenAlias:i.length>0?i:e.hiddenAlias}})}function S(e){return T(e,e=>e.positional)}function C(e){return T(e,e=>!e.positional)}function w(e){let t=e.variants??e.unionOptions??[];return[e.fields,...t.map(e=>e.fields)].flat()}function T(e,t){let n=/* @__PURE__ */ new Map;for(let r of w(e))t(r)&&!n.has(r.name)&&n.set(r.name,r);return[...n.values()]}function E(e,t){let{discriminator:n,variants:r}=e;if(!n||!r){let n=e.unionOptions??[],r=n.map(e=>E(e,t));if(r.every((e,t)=>e===n[t]))return e;let i=r.filter((r,i)=>{let a=t(r),o=n[i];if(o.discriminator&&a[o.discriminator]!==void 0&&r===o)return!1;let s=new Set(r.fields.map(e=>e.name));return!e.fields.some(e=>a[e.name]!==void 0&&!s.has(e.name))});if(!i.length)return e;let a=/* @__PURE__ */ new Map;for(let e of i)for(let t of e.fields){let e=a.get(t.name);e?a.set(t.name,{...e,type:e.type===t.type?e.type:`unknown`,named:e.named||t.named,positional:e.positional||t.positional,alias:[.../* @__PURE__ */ new Set([...e.alias??[],...t.alias??[]])],hiddenAlias:[.../* @__PURE__ */ new Set([...e.hiddenAlias??[],...t.hiddenAlias??[]])]}):a.set(t.name,t)}return{...e,fields:[...a.values()]}}let i=r.map(r=>{let i={...e,fields:r.fields};return{variant:r,fields:i,value:t(i)[n]}});for(let{variant:e,fields:t,value:n}of i)if(n!==void 0&&String(n)===e.discriminatorValue)return t;for(let{variant:e,fields:t,value:n}of i)if(n!==void 0&&e.normalizeDiscriminator&&String(e.normalizeDiscriminator(n))===e.discriminatorValue)return t;return e}function D(e,t){return C(e).find(e=>e.name===t)}export{x as a,S as c,r as d,a as f,m as i,E as l,g as n,D as o,p,v as r,C as s,y as t,i as u};