@crustjs/skills 0.0.19 → 0.0.20

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 (2) hide show
  1. package/dist/index.js +2 -2
  2. package/package.json +1 -1
package/dist/index.js CHANGED
@@ -1,8 +1,8 @@
1
1
  // @bun
2
- import{accessSync as aQ,constants as nQ}from"fs";import{homedir as e}from"os";import{delimiter as tQ,join as Y}from"path";var k=Y(".agents","skills"),eQ=Y(".crust","skills");function VQ(Q){if(Q!==e())return Y(Q,".config");let Z=process.env.XDG_CONFIG_HOME?.trim();return Z&&Z.length>0?Z:Y(Q,".config")}function j(Q){return Y(Q,".agents","skills")}function QZ(Q){return Y(Q,".crust","skills")}var C={amp:{label:"Amp",class:"universal",projectSkillsDir:k,globalSkillsDir:j},adal:{label:"AdaL",class:"additional",projectSkillsDir:Y(".adal","skills"),globalSkillsDir:(Q)=>Y(Q,".adal","skills"),detectCommands:["adal"]},antigravity:{label:"Antigravity",class:"additional",projectSkillsDir:Y(".agent","skills"),globalSkillsDir:(Q)=>Y(Q,".gemini","antigravity","skills"),detectCommands:["antigravity"]},augment:{label:"Augment",class:"additional",projectSkillsDir:Y(".augment","skills"),globalSkillsDir:(Q)=>Y(Q,".augment","skills"),detectCommands:["augment"]},"claude-code":{label:"Claude Code",class:"additional",projectSkillsDir:Y(".claude","skills"),globalSkillsDir:(Q)=>Y(process.env.CLAUDE_CONFIG_DIR?.trim()||Y(Q,".claude"),"skills"),detectCommands:["claude","claude-code"]},cline:{label:"Cline",class:"universal",projectSkillsDir:k,globalSkillsDir:j},codebuddy:{label:"CodeBuddy",class:"additional",projectSkillsDir:Y(".codebuddy","skills"),globalSkillsDir:(Q)=>Y(Q,".codebuddy","skills"),detectCommands:["codebuddy"]},codex:{label:"Codex",class:"universal",projectSkillsDir:k,globalSkillsDir:j},"command-code":{label:"Command Code",class:"additional",projectSkillsDir:Y(".commandcode","skills"),globalSkillsDir:(Q)=>Y(Q,".commandcode","skills"),detectCommands:["command-code","commandcode"]},continue:{label:"Continue",class:"additional",projectSkillsDir:Y(".continue","skills"),globalSkillsDir:(Q)=>Y(Q,".continue","skills"),detectCommands:["continue"]},cortex:{label:"Cortex Code",class:"additional",projectSkillsDir:Y(".cortex","skills"),globalSkillsDir:(Q)=>Y(Q,".snowflake","cortex","skills"),detectCommands:["cortex"]},crush:{label:"Crush",class:"additional",projectSkillsDir:Y(".crush","skills"),globalSkillsDir:(Q)=>Y(VQ(Q),"crush","skills"),detectCommands:["crush"]},cursor:{label:"Cursor",class:"universal",projectSkillsDir:k,globalSkillsDir:j},droid:{label:"Droid",class:"additional",projectSkillsDir:Y(".factory","skills"),globalSkillsDir:(Q)=>Y(Q,".factory","skills"),detectCommands:["droid"]},"gemini-cli":{label:"Gemini CLI",class:"universal",projectSkillsDir:k,globalSkillsDir:j},"github-copilot":{label:"GitHub Copilot",class:"universal",projectSkillsDir:k,globalSkillsDir:j},goose:{label:"Goose",class:"additional",projectSkillsDir:Y(".goose","skills"),globalSkillsDir:(Q)=>Y(VQ(Q),"goose","skills"),detectCommands:["goose"]},"iflow-cli":{label:"iFlow CLI",class:"additional",projectSkillsDir:Y(".iflow","skills"),globalSkillsDir:(Q)=>Y(Q,".iflow","skills"),detectCommands:["iflow","iflow-cli"]},junie:{label:"Junie",class:"additional",projectSkillsDir:Y(".junie","skills"),globalSkillsDir:(Q)=>Y(Q,".junie","skills"),detectCommands:["junie"]},kilo:{label:"Kilo Code",class:"additional",projectSkillsDir:Y(".kilocode","skills"),globalSkillsDir:(Q)=>Y(Q,".kilocode","skills"),detectCommands:["kilo","kilocode"]},"kimi-cli":{label:"Kimi Code CLI",class:"universal",projectSkillsDir:k,globalSkillsDir:j},"kiro-cli":{label:"Kiro CLI",class:"additional",projectSkillsDir:Y(".kiro","skills"),globalSkillsDir:(Q)=>Y(Q,".kiro","skills"),detectCommands:["kiro","kiro-cli"]},kode:{label:"Kode",class:"additional",projectSkillsDir:Y(".kode","skills"),globalSkillsDir:(Q)=>Y(Q,".kode","skills"),detectCommands:["kode"]},mcpjam:{label:"MCPJam",class:"additional",projectSkillsDir:Y(".mcpjam","skills"),globalSkillsDir:(Q)=>Y(Q,".mcpjam","skills"),detectCommands:["mcpjam"]},"mistral-vibe":{label:"Mistral Vibe",class:"additional",projectSkillsDir:Y(".vibe","skills"),globalSkillsDir:(Q)=>Y(Q,".vibe","skills"),detectCommands:["mistral-vibe","vibe"]},mux:{label:"Mux",class:"additional",projectSkillsDir:Y(".mux","skills"),globalSkillsDir:(Q)=>Y(Q,".mux","skills"),detectCommands:["mux"]},neovate:{label:"Neovate",class:"additional",projectSkillsDir:Y(".neovate","skills"),globalSkillsDir:(Q)=>Y(Q,".neovate","skills"),detectCommands:["neovate"]},opencode:{label:"OpenCode",class:"universal",projectSkillsDir:k,globalSkillsDir:j},openclaw:{label:"OpenClaw",class:"additional",projectSkillsDir:"skills",globalSkillsDir:(Q)=>Y(Q,".openclaw","skills"),detectCommands:["openclaw"]},openhands:{label:"OpenHands",class:"additional",projectSkillsDir:Y(".openhands","skills"),globalSkillsDir:(Q)=>Y(Q,".openhands","skills"),detectCommands:["openhands"]},pi:{label:"Pi",class:"additional",projectSkillsDir:Y(".pi","skills"),globalSkillsDir:(Q)=>Y(Q,".pi","agent","skills"),detectCommands:["pi"]},pochi:{label:"Pochi",class:"additional",projectSkillsDir:Y(".pochi","skills"),globalSkillsDir:(Q)=>Y(Q,".pochi","skills"),detectCommands:["pochi"]},qoder:{label:"Qoder",class:"additional",projectSkillsDir:Y(".qoder","skills"),globalSkillsDir:(Q)=>Y(Q,".qoder","skills"),detectCommands:["qoder"]},"qwen-code":{label:"Qwen Code",class:"additional",projectSkillsDir:Y(".qwen","skills"),globalSkillsDir:(Q)=>Y(Q,".qwen","skills"),detectCommands:["qwen","qwen-code"]},replit:{label:"Replit",class:"universal",projectSkillsDir:k,globalSkillsDir:j},roo:{label:"Roo Code",class:"additional",projectSkillsDir:Y(".roo","skills"),globalSkillsDir:(Q)=>Y(Q,".roo","skills"),detectCommands:["roo","roo-code"]},trae:{label:"Trae",class:"additional",projectSkillsDir:Y(".trae","skills"),globalSkillsDir:(Q)=>Y(Q,".trae","skills"),detectCommands:["trae"]},"trae-cn":{label:"Trae CN",class:"additional",projectSkillsDir:Y(".trae","skills"),globalSkillsDir:(Q)=>Y(Q,".trae-cn","skills"),detectCommands:["trae-cn","trae"]},windsurf:{label:"Windsurf",class:"additional",projectSkillsDir:Y(".windsurf","skills"),globalSkillsDir:(Q)=>Y(Q,".codeium","windsurf","skills"),detectCommands:["windsurf"]},zencoder:{label:"Zencoder",class:"additional",projectSkillsDir:Y(".zencoder","skills"),globalSkillsDir:(Q)=>Y(Q,".zencoder","skills"),detectCommands:["zencoder"]}},u=Object.keys(C),y=Object.fromEntries(u.map((Q)=>[Q,C[Q].label]));function S(){return u.filter((Q)=>C[Q].class==="universal")}function h(){return u.filter((Q)=>C[Q].class==="additional")}function ZZ(Q){return C[Q].class==="universal"}async function QQ(Q){let Z=typeof Q==="string"?{home:Q}:Q??{},X=Z.cwd??process.cwd(),$=Z.commandChecker??((H)=>Promise.resolve(XZ(H))),W=[];for(let H of h()){let B=C[H].detectCommands??[],z=!1;for(let J of B)if(await $(J,X)){z=!0;break}if(z)W.push(H)}return W}function O(Q,Z,X){let $=C[Q];if(Z==="project")return Y(process.cwd(),$.projectSkillsDir,X);return Y($.globalSkillsDir(e()),X)}function P(Q,Z){if(Q==="project")return Y(process.cwd(),eQ,Z);return Y(QZ(e()),Z)}function XZ(Q){let X=(process.env.PATH??"").split(tQ).filter((H)=>H.length>0),$=process.platform==="win32",W=$?(process.env.PATHEXT??".EXE;.CMD;.BAT;.COM").split(";").filter((H)=>H.length>0):[];for(let H of X){if(!$&&MQ(Y(H,Q)))return!0;if($){for(let B of W)if(MQ(Y(H,Q+B)))return!0}}return!1}function MQ(Q){try{return aQ(Q,nQ.X_OK),!0}catch{return!1}}import{Crust as $Z}from"@crustjs/core";function s(Q){if(Q===void 0)return[];return(Array.isArray(Q)?Q:[Q]).flatMap((X)=>X.split(/\r?\n/)).map((X)=>X.trim()).filter((X)=>X.length>0)}function TQ(Q){let Z=Q?.trim();if(!Z)return[];return Z.split(/\r?\n/)}function ZQ(Q){return Q.length>0}var _Q=Symbol("crust.skill.commandAnnotations");function WZ(Q){return Q instanceof $Z?Q._node:Q}function HZ(Q,Z){let X=WZ(Q),$=s(typeof Z==="string"||Array.isArray(Z)?Z:Z.instructions??[]);if($.length===0)return Q;let W=XQ(X)?.instructions??[],H=[...new Set([...W,...$])];return Object.defineProperty(X,_Q,{value:{instructions:H},enumerable:!0,configurable:!0}),Q}function XQ(Q){let Z=Q[_Q];if(!Z?.instructions||Z.instructions.length===0)return;return{instructions:[...Z.instructions]}}class I extends Error{name="SkillConflictError";details;constructor(Q){let Z=`Skill conflict for agent "${Q.agent}": directory "${Q.outputDir}" already exists but was not created by Crust (no crust.json found). Delete or rename the conflicting skill to resolve.`;super(Z);this.details=Q}}import{lstat as NZ,mkdir as hQ,readlink as LZ,realpath as PZ,rm as m,symlink as CZ,writeFile as yZ}from"fs/promises";import{dirname as pQ,join as SQ}from"path";function bQ(Q){return OQ(Q,[])}function OQ(Q,Z){let X=YZ(Q.meta.name),$=[...Z,X],W=qZ(Q.args),H=JZ(Q.effectiveFlags),B=KZ(Q.subCommands,$),z=XQ(Q);return{name:X,path:$,description:Q.meta.description,usage:Q.meta.usage,instructions:z?.instructions,runnable:typeof Q.run==="function",args:W,flags:H,children:B}}function YZ(Q){return Q.trim().toLowerCase()}function qZ(Q){if(!Q||Q.length===0)return[];return Q.map(BZ)}function BZ(Q){let Z={name:Q.name,type:Q.type,required:Q.required===!0,variadic:Q.variadic===!0};if(Q.description!==void 0)Z.description=Q.description;if(Q.default!==void 0)Z.default=RQ(Q.default);return Z}function JZ(Q){if(!Q)return[];return Object.keys(Q).sort().map((X)=>{return zZ(X,Q[X])})}function zZ(Q,Z){let X={name:Q,type:Z.type,required:Z.required===!0,multiple:Z.multiple===!0,short:Z.short,aliases:Z.aliases?[...Z.aliases].sort():[]};if(Z.description!==void 0)X.description=Z.description;if(Z.default!==void 0)X.default=RQ(Z.default);return X}function KZ(Q,Z){return Object.keys(Q).sort().map(($)=>{return OQ(Q[$],Z)})}function RQ(Q){if(Array.isArray(Q))return JSON.stringify(Q);return String(Q)}function c(Q){if(/[:#[\]{}&*!|>'"`,@?\\]|^\s|\s$|^---|[\n\r]/.test(Q))return`"${Q.replace(/\\/g,"\\\\").replace(/"/g,"\\\"").replace(/\n/g,"\\n").replace(/\r/g,"\\r")}"`;return Q}function EQ(Q){return Q.replace(/(?<!\\)\|/g,"\\|")}function kQ(Q,Z){let X=[],$=jQ(Q);X.push({path:"SKILL.md",content:xZ(Q,Z,$)});for(let W of $){let H=D(W),B=W.children.length>0?UZ(W,Q):wZ(W,Q);X.push({path:H,content:B})}return X}function jQ(Q){let Z=[Q];for(let X of Q.children)Z.push(...jQ(X));return Z}function D(Q){if(Q.path.length<=1)return`commands/${Q.name}.md`;return`commands/${Q.path.slice(1).join("/")}.md`}function WQ(Q){return Q.path.join(" ")}function $Q(Q,Z){let X=Q.split("/").slice(0,-1),$=Z.split("/"),W=0;while(W<X.length&&W<$.length&&X[W]===$[W])W++;let H=X.length-W,B=$.slice(W);if(H===0)return B.join("/");return[...Array.from({length:H},()=>".."),...B].join("/")}function xZ(Q,Z,X){let $=[];if($.push("---"),$.push(`name: ${c(Z.name)}`),$.push(`description: ${c(Z.description)}`),Z.license)$.push(`license: ${c(Z.license)}`);if(Z.compatibility)$.push(`compatibility: ${c(Z.compatibility)}`);if(Z.disableModelInvocation)$.push("disable-model-invocation: true");if(Z.allowedTools)$.push(`allowed-tools: ${c(Z.allowedTools)}`);if($.push("metadata:"),$.push(` version: "${Z.version}"`),$.push("---"),$.push(""),$.push(`# ${Z.name}`),$.push(""),Q.description)$.push(Q.description),$.push("");$.push(`Use this skill when you need accurate help with \`${Z.name}\` commands, including command selection, syntax, arguments, flags, defaults, and subcommands.`),$.push("");let W=EZ(Z.instructions);if($.push("## How to Use This Skill"),$.push(""),$.push("1. Find the command that best matches the user's task from the Command Reference below"),$.push("2. Check the `Type` column before suggesting execution: `runnable` and `runnable, group` commands can be executed, while `group` commands are organizational only"),$.push("3. Read only the linked file or files you need from `commands/`"),$.push("4. Before answering a command-specific question or suggesting a command, read that command's file"),$.push("5. Treat the command file as the source of truth for usage, arguments, flags, aliases, and defaults"),$.push("6. If a flag, argument, alias, or default is not documented there, say it is not documented instead of guessing"),$.push(""),ZQ(W))$.push("## General Guidance"),$.push(""),$.push(...W),$.push("");if($.push("## Command Reference"),$.push(""),$.push("Use this table to locate the command file you need."),$.push(""),$.push(...GZ(X)),$.push(""),Q.runnable){$.push("## Usage"),$.push("");let H=D(Q);$.push(`The root command is directly executable. See [${Q.name}](${H}) for usage details.`),$.push("")}return $.join(`
2
+ import{accessSync as aQ,constants as nQ}from"fs";import{homedir as e}from"os";import{delimiter as tQ,join as Y}from"path";var k=Y(".agents","skills"),eQ=Y(".crust","skills");function VQ(Q){if(Q!==e())return Y(Q,".config");let Z=process.env.XDG_CONFIG_HOME?.trim();return Z&&Z.length>0?Z:Y(Q,".config")}function j(Q){return Y(Q,".agents","skills")}function QZ(Q){return Y(Q,".crust","skills")}var C={amp:{label:"Amp",class:"universal",projectSkillsDir:k,globalSkillsDir:j},adal:{label:"AdaL",class:"additional",projectSkillsDir:Y(".adal","skills"),globalSkillsDir:(Q)=>Y(Q,".adal","skills"),detectCommands:["adal"]},antigravity:{label:"Antigravity",class:"additional",projectSkillsDir:Y(".agent","skills"),globalSkillsDir:(Q)=>Y(Q,".gemini","antigravity","skills"),detectCommands:["antigravity"]},augment:{label:"Augment",class:"additional",projectSkillsDir:Y(".augment","skills"),globalSkillsDir:(Q)=>Y(Q,".augment","skills"),detectCommands:["augment"]},"claude-code":{label:"Claude Code",class:"additional",projectSkillsDir:Y(".claude","skills"),globalSkillsDir:(Q)=>Y(process.env.CLAUDE_CONFIG_DIR?.trim()||Y(Q,".claude"),"skills"),detectCommands:["claude","claude-code"]},cline:{label:"Cline",class:"universal",projectSkillsDir:k,globalSkillsDir:j},codebuddy:{label:"CodeBuddy",class:"additional",projectSkillsDir:Y(".codebuddy","skills"),globalSkillsDir:(Q)=>Y(Q,".codebuddy","skills"),detectCommands:["codebuddy"]},codex:{label:"Codex",class:"universal",projectSkillsDir:k,globalSkillsDir:j},"command-code":{label:"Command Code",class:"additional",projectSkillsDir:Y(".commandcode","skills"),globalSkillsDir:(Q)=>Y(Q,".commandcode","skills"),detectCommands:["command-code","commandcode"]},continue:{label:"Continue",class:"additional",projectSkillsDir:Y(".continue","skills"),globalSkillsDir:(Q)=>Y(Q,".continue","skills"),detectCommands:["continue"]},cortex:{label:"Cortex Code",class:"additional",projectSkillsDir:Y(".cortex","skills"),globalSkillsDir:(Q)=>Y(Q,".snowflake","cortex","skills"),detectCommands:["cortex"]},crush:{label:"Crush",class:"additional",projectSkillsDir:Y(".crush","skills"),globalSkillsDir:(Q)=>Y(VQ(Q),"crush","skills"),detectCommands:["crush"]},cursor:{label:"Cursor",class:"universal",projectSkillsDir:k,globalSkillsDir:j},droid:{label:"Droid",class:"additional",projectSkillsDir:Y(".factory","skills"),globalSkillsDir:(Q)=>Y(Q,".factory","skills"),detectCommands:["droid"]},"gemini-cli":{label:"Gemini CLI",class:"universal",projectSkillsDir:k,globalSkillsDir:j},"github-copilot":{label:"GitHub Copilot",class:"universal",projectSkillsDir:k,globalSkillsDir:j},goose:{label:"Goose",class:"additional",projectSkillsDir:Y(".goose","skills"),globalSkillsDir:(Q)=>Y(VQ(Q),"goose","skills"),detectCommands:["goose"]},"iflow-cli":{label:"iFlow CLI",class:"additional",projectSkillsDir:Y(".iflow","skills"),globalSkillsDir:(Q)=>Y(Q,".iflow","skills"),detectCommands:["iflow","iflow-cli"]},junie:{label:"Junie",class:"additional",projectSkillsDir:Y(".junie","skills"),globalSkillsDir:(Q)=>Y(Q,".junie","skills"),detectCommands:["junie"]},kilo:{label:"Kilo Code",class:"additional",projectSkillsDir:Y(".kilocode","skills"),globalSkillsDir:(Q)=>Y(Q,".kilocode","skills"),detectCommands:["kilo","kilocode"]},"kimi-cli":{label:"Kimi Code CLI",class:"universal",projectSkillsDir:k,globalSkillsDir:j},"kiro-cli":{label:"Kiro CLI",class:"additional",projectSkillsDir:Y(".kiro","skills"),globalSkillsDir:(Q)=>Y(Q,".kiro","skills"),detectCommands:["kiro","kiro-cli"]},kode:{label:"Kode",class:"additional",projectSkillsDir:Y(".kode","skills"),globalSkillsDir:(Q)=>Y(Q,".kode","skills"),detectCommands:["kode"]},mcpjam:{label:"MCPJam",class:"additional",projectSkillsDir:Y(".mcpjam","skills"),globalSkillsDir:(Q)=>Y(Q,".mcpjam","skills"),detectCommands:["mcpjam"]},"mistral-vibe":{label:"Mistral Vibe",class:"additional",projectSkillsDir:Y(".vibe","skills"),globalSkillsDir:(Q)=>Y(Q,".vibe","skills"),detectCommands:["mistral-vibe","vibe"]},mux:{label:"Mux",class:"additional",projectSkillsDir:Y(".mux","skills"),globalSkillsDir:(Q)=>Y(Q,".mux","skills"),detectCommands:["mux"]},neovate:{label:"Neovate",class:"additional",projectSkillsDir:Y(".neovate","skills"),globalSkillsDir:(Q)=>Y(Q,".neovate","skills"),detectCommands:["neovate"]},opencode:{label:"OpenCode",class:"universal",projectSkillsDir:k,globalSkillsDir:j},openclaw:{label:"OpenClaw",class:"additional",projectSkillsDir:"skills",globalSkillsDir:(Q)=>Y(Q,".openclaw","skills"),detectCommands:["openclaw"]},openhands:{label:"OpenHands",class:"additional",projectSkillsDir:Y(".openhands","skills"),globalSkillsDir:(Q)=>Y(Q,".openhands","skills"),detectCommands:["openhands"]},pi:{label:"Pi",class:"additional",projectSkillsDir:Y(".pi","skills"),globalSkillsDir:(Q)=>Y(Q,".pi","agent","skills"),detectCommands:["pi"]},pochi:{label:"Pochi",class:"additional",projectSkillsDir:Y(".pochi","skills"),globalSkillsDir:(Q)=>Y(Q,".pochi","skills"),detectCommands:["pochi"]},qoder:{label:"Qoder",class:"additional",projectSkillsDir:Y(".qoder","skills"),globalSkillsDir:(Q)=>Y(Q,".qoder","skills"),detectCommands:["qoder"]},"qwen-code":{label:"Qwen Code",class:"additional",projectSkillsDir:Y(".qwen","skills"),globalSkillsDir:(Q)=>Y(Q,".qwen","skills"),detectCommands:["qwen","qwen-code"]},replit:{label:"Replit",class:"universal",projectSkillsDir:k,globalSkillsDir:j},roo:{label:"Roo Code",class:"additional",projectSkillsDir:Y(".roo","skills"),globalSkillsDir:(Q)=>Y(Q,".roo","skills"),detectCommands:["roo","roo-code"]},trae:{label:"Trae",class:"additional",projectSkillsDir:Y(".trae","skills"),globalSkillsDir:(Q)=>Y(Q,".trae","skills"),detectCommands:["trae"]},"trae-cn":{label:"Trae CN",class:"additional",projectSkillsDir:Y(".trae","skills"),globalSkillsDir:(Q)=>Y(Q,".trae-cn","skills"),detectCommands:["trae-cn","trae"]},windsurf:{label:"Windsurf",class:"additional",projectSkillsDir:Y(".windsurf","skills"),globalSkillsDir:(Q)=>Y(Q,".codeium","windsurf","skills"),detectCommands:["windsurf"]},zencoder:{label:"Zencoder",class:"additional",projectSkillsDir:Y(".zencoder","skills"),globalSkillsDir:(Q)=>Y(Q,".zencoder","skills"),detectCommands:["zencoder"]}},u=Object.keys(C),y=Object.fromEntries(u.map((Q)=>[Q,C[Q].label]));function S(){return u.filter((Q)=>C[Q].class==="universal")}function h(){return u.filter((Q)=>C[Q].class==="additional")}function ZZ(Q){return C[Q].class==="universal"}async function QQ(Q){let Z=typeof Q==="string"?{home:Q}:Q??{},X=Z.cwd??process.cwd(),$=Z.commandChecker??((H)=>Promise.resolve(XZ(H))),W=[];for(let H of h()){let B=C[H].detectCommands??[],z=!1;for(let J of B)if(await $(J,X)){z=!0;break}if(z)W.push(H)}return W}function O(Q,Z,X){let $=C[Q];if(Z==="project")return Y(process.cwd(),$.projectSkillsDir,X);return Y($.globalSkillsDir(e()),X)}function P(Q,Z){if(Q==="project")return Y(process.cwd(),eQ,Z);return Y(QZ(e()),Z)}function XZ(Q){let X=(process.env.PATH??"").split(tQ).filter((H)=>H.length>0),$=process.platform==="win32",W=$?(process.env.PATHEXT??".EXE;.CMD;.BAT;.COM").split(";").filter((H)=>H.length>0):[];for(let H of X){if(!$&&MQ(Y(H,Q)))return!0;if($){for(let B of W)if(MQ(Y(H,Q+B)))return!0}}return!1}function MQ(Q){try{return aQ(Q,nQ.X_OK),!0}catch{return!1}}import{Crust as $Z}from"@crustjs/core";function s(Q){if(Q===void 0)return[];return(Array.isArray(Q)?Q:[Q]).flatMap((X)=>X.split(/\r?\n/)).map((X)=>X.trim()).filter((X)=>X.length>0)}function TQ(Q){let Z=Q?.trim();if(!Z)return[];return Z.split(/\r?\n/)}function ZQ(Q){return Q.length>0}var _Q=Symbol("crust.skill.commandAnnotations");function WZ(Q){return Q instanceof $Z?Q._node:Q}function HZ(Q,Z){let X=WZ(Q),$=s(typeof Z==="string"||Array.isArray(Z)?Z:Z.instructions??[]);if($.length===0)return Q;let W=XQ(X)?.instructions??[],H=[...new Set([...W,...$])];return Object.defineProperty(X,_Q,{value:{instructions:H},enumerable:!0,configurable:!0}),Q}function XQ(Q){let Z=Q[_Q];if(!Z?.instructions||Z.instructions.length===0)return;return{instructions:[...Z.instructions]}}class I extends Error{name="SkillConflictError";details;constructor(Q){let Z=`Skill conflict for agent "${Q.agent}": directory "${Q.outputDir}" already exists but was not created by Crust (no crust.json found). Delete or rename the conflicting skill to resolve.`;super(Z);this.details=Q}}import{lstat as NZ,mkdir as hQ,readlink as LZ,realpath as PZ,rm as m,symlink as CZ,writeFile as yZ}from"fs/promises";import{dirname as pQ,join as SQ}from"path";function bQ(Q){return OQ(Q,[])}function OQ(Q,Z){let X=YZ(Q.meta.name),$=[...Z,X],W=qZ(Q.args),H=JZ(Q.effectiveFlags),B=KZ(Q.subCommands,$),z=XQ(Q);return{name:X,path:$,description:Q.meta.description,usage:Q.meta.usage,instructions:z?.instructions,runnable:typeof Q.run==="function",args:W,flags:H,children:B}}function YZ(Q){return Q.trim().toLowerCase()}function qZ(Q){if(!Q||Q.length===0)return[];return Q.map(BZ)}function BZ(Q){let Z={name:Q.name,type:Q.type,required:Q.required===!0,variadic:Q.variadic===!0};if(Q.description!==void 0)Z.description=Q.description;if(Q.default!==void 0)Z.default=RQ(Q.default);return Z}function JZ(Q){if(!Q)return[];return Object.keys(Q).sort().map((X)=>{return zZ(X,Q[X])})}function zZ(Q,Z){let X={name:Q,type:Z.type,required:Z.required===!0,multiple:Z.multiple===!0,short:Z.short,aliases:Z.aliases?[...Z.aliases].sort():[]};if(Z.description!==void 0)X.description=Z.description;if(Z.default!==void 0)X.default=RQ(Z.default);return X}function KZ(Q,Z){return Object.keys(Q).sort().map(($)=>{return OQ(Q[$],Z)})}function RQ(Q){if(Array.isArray(Q))return JSON.stringify(Q);return String(Q)}function c(Q){if(/[:#[\]{}&*!|>'"`,@?\\]|^\s|\s$|^---|[\n\r]/.test(Q))return`"${Q.replace(/\\/g,"\\\\").replace(/"/g,"\\\"").replace(/\n/g,"\\n").replace(/\r/g,"\\r")}"`;return Q}function EQ(Q){return Q.replace(/(?<!\\)\|/g,"\\|")}function kQ(Q,Z){let X=[],$=jQ(Q);X.push({path:"SKILL.md",content:xZ(Q,Z,$)});for(let W of $){let H=D(W),B=W.children.length>0?UZ(W,Q):wZ(W,Q);X.push({path:H,content:B})}return X}function jQ(Q){let Z=[Q];for(let X of Q.children)Z.push(...jQ(X));return Z}function D(Q){if(Q.path.length<=1)return`commands/${Q.name}.md`;return`commands/${Q.path.slice(1).join("/")}.md`}function WQ(Q){return Q.path.join(" ")}function $Q(Q,Z){let X=Q.split("/").slice(0,-1),$=Z.split("/"),W=0;while(W<X.length&&W<$.length&&X[W]===$[W])W++;let H=X.length-W,B=$.slice(W);if(H===0)return B.join("/");return[...Array.from({length:H},()=>".."),...B].join("/")}function xZ(Q,Z,X){let $=[];if($.push("---"),$.push(`name: ${c(Z.name)}`),$.push(`description: ${c(Z.description)}`),Z.license)$.push(`license: ${c(Z.license)}`);if(Z.compatibility)$.push(`compatibility: ${c(Z.compatibility)}`);if(Z.disableModelInvocation)$.push("disable-model-invocation: true");if(Z.allowedTools)$.push(`allowed-tools: ${c(Z.allowedTools)}`);if($.push("metadata:"),$.push(` version: "${Z.version}"`),$.push("---"),$.push(""),$.push(`# ${Z.name}`),$.push(""),Q.description)$.push(Q.description),$.push("");$.push(`You should use this skill when you need accurate help with \`${Z.name}\` commands, including command selection, syntax, arguments, flags, defaults, and subcommands.`),$.push("");let W=EZ(Z.instructions);if($.push("## How to Use This Skill"),$.push(""),$.push("1. You must find the command that best matches the user's task from the Command Reference below."),$.push("2. You must check the `Type` column before suggesting execution: `runnable` and `runnable, group` commands can be executed, while `group` commands are organizational only."),$.push("3. You should read only the linked file or files you need from `commands/`."),$.push("4. You must read a command's file before answering a command-specific question or suggesting that command."),$.push("5. You must treat the command file as the source of truth for usage, arguments, flags, aliases, and defaults."),$.push("6. If a flag, argument, alias, or default is not documented there, you must say it is not documented instead of guessing."),$.push(""),ZQ(W))$.push("## General Guidance"),$.push(""),$.push(...W),$.push("");if($.push("## Command Reference"),$.push(""),$.push("You should use this table to locate the command file you need."),$.push(""),$.push(...GZ(X)),$.push(""),Q.runnable){$.push("## Usage"),$.push("");let H=D(Q);$.push(`The root command is directly executable. You should see [${Q.name}](${H}) for usage details.`),$.push("")}return $.join(`
3
3
  `)}function GZ(Q){let Z=[];Z.push("| Command | Type | Documentation |"),Z.push("| ------- | ---- | ------------- |");for(let X of Q){let $=WQ(X),W=D(X),H=FZ(X);Z.push(`| \`${$}\` | ${H} | [${W}](${W}) |`)}return Z}function FZ(Q){if(Q.runnable&&Q.children.length>0)return"runnable, group";if(Q.runnable)return"runnable";return"group"}function wZ(Q,Z){let X=[];return X.push(...IQ(Q)),X.push(...NQ(Q)),X.push(...LQ(Q)),X.push(...CQ(Q,Z)),X.join(`
4
4
  `)}function UZ(Q,Z){let X=[],$=D(Q);if(X.push(...IQ(Q)),X.push(...NQ(Q)),Q.runnable)X.push(...LQ(Q));return X.push(...MZ(Q,$)),X.push(...CQ(Q,Z)),X.join(`
5
- `)}function VZ(Q){let Z=[...Q.path];for(let X of Q.args)if(X.variadic)Z.push(X.required?`<${X.name}...>`:`[${X.name}...]`);else Z.push(X.required?`<${X.name}>`:`[${X.name}]`);if(Q.flags.length>0)Z.push("[options]");return Z.join(" ")}function IQ(Q){let Z=[`# \`${WQ(Q)}\``,""];if(Q.description)Z.push(Q.description,"");return Z}function NQ(Q){let Z=Q.instructions??[];if(!ZQ(Z))return[];return["## Command Instructions","",...PQ(Z),""]}function LQ(Q){let Z=["## Usage","","```",Q.usage??VZ(Q),"```",""];if(Q.args.length>0)Z.push("## Arguments","",...TZ(Q.args),"");if(Q.flags.length>0)Z.push("## Flags","",...bZ(Q.flags),"");return Z.push("## Command Documentation Authority","","Only arguments, flags, options, aliases, and defaults documented in this file are supported for this command.","Do not infer or invent additional command-line options.",""),Z}function MZ(Q,Z){let X=["## Subcommands",""];for(let $ of Q.children){let W=D($),H=$Q(Z,W),B=$.description?` - ${$.description}`:"";X.push(`- [\`${$.name}\`](${H})${B}`)}return X.push(""),X}function TZ(Q){let Z=[];Z.push("| Argument | Type | Required | Description |"),Z.push("| -------- | ---- | -------- | ----------- |");for(let X of Q){let $=X.variadic?`${X.name}...`:X.name,W=X.required?"Yes":"No",H=EQ(_Z(X));Z.push(`| \`${$}\` | ${X.type} | ${W} | ${H} |`)}return Z}function _Z(Q){let Z=[];if(Q.description)Z.push(Q.description);if(Q.default!==void 0)Z.push(`Default: \`${Q.default}\``);return Z.join(". ")||"-"}function bZ(Q){let Z=[];Z.push("| Flag | Type | Required | Description |"),Z.push("| ---- | ---- | -------- | ----------- |");for(let X of Q){let $=OZ(X),W=X.required?"Yes":"No",H=EQ(RZ(X));Z.push(`| ${$} | ${X.type} | ${W} | ${H} |`)}return Z}function OZ(Q){let Z=[`\`--${Q.name}\``];if(Q.short)Z.push(`\`-${Q.short}\``);for(let X of Q.aliases)Z.push(`\`--${X}\``);return Z.join(", ")}function RZ(Q){let Z=[];if(Q.description)Z.push(Q.description);if(Q.multiple)Z.push("Can be specified multiple times");if(Q.default!==void 0)Z.push(`Default: \`${Q.default}\``);return Z.join(". ")||"-"}function PQ(Q){return Q.map((Z)=>`- ${Z}`)}function EZ(Q){if(typeof Q==="string")return TQ(Q);return PQ(s(Q))}function CQ(Q,Z){let X=[],$=D(Q);if(X.push("---"),X.push(""),Q.path.length>1){let H=Q.path.slice(0,-1),B=yQ(Z,H);if(B){let z=D(B),J=$Q($,z),K=WQ(B);X.push(`Parent: [\`${K}\`](${J})`),X.push("")}}let W=$Q($,"SKILL.md");return X.push(`[Skill Overview](${W})`),X.push(""),X}function yQ(Q,Z){if(kZ(Q.path,Z))return Q;for(let X of Q.children){let $=yQ(X,Z);if($)return $}return}function kZ(Q,Z){if(Q.length!==Z.length)return!1;for(let X=0;X<Q.length;X++)if(Q[X]!==Z[X])return!1;return!0}import{readFile as jZ}from"fs/promises";import{join as IZ}from"path";var HQ="crust.json";async function A(Q){try{let Z=await jZ(IZ(Q,HQ),"utf-8"),X=JSON.parse(Z);if(typeof X==="object"&&X!==null&&"version"in X&&typeof X.version==="string")return X.version;return null}catch{return null}}var SZ="auto",gQ=/^[a-z0-9]+(-[a-z0-9]+)*$/;function uQ(Q){return Q.length>=1&&Q.length<=64&&gQ.test(Q)}function i(Q){return Q}function BQ(Q){return Q.startsWith("use-")?Q:`use-${Q}`}async function p(Q){let{command:Z,meta:X,agents:$,scope:W="global",clean:H=!0,force:B=!1,installMode:z=SZ}=Q,J=i(X.name),K=BQ(X.name);if(!uQ(J))throw Error(`Invalid skill name "${J}": must be 1\u201364 lowercase `+`alphanumeric characters and hyphens, no leading/trailing/consecutive hyphens. Pattern: ${gQ.source}`);let x=$[0];if(!x)return{agents:[]};let G={...X,name:J},U=bQ(Z),N=kQ(U,G),M=pZ(G),b=[...N,...M].sort((q,F)=>q.path<F.path?-1:q.path>F.path?1:0),R=b.map((q)=>q.path),T=new Map;for(let q of $){let F=O(q,W,G.name),w=T.get(F);if(w)w.push(q);else T.set(F,[q])}let _=P(W,G.name),E=P(W,K),L=new Map;for(let[q,F]of T){let w=F[0];if(!w)continue;L.set(q,await KQ({outputDir:q,legacyOutputDir:O(w,W,K),canonicalOutputDir:_,legacyCanonicalOutputDir:E}))}let l=await A(_);if((await zQ(_,_)).exists&&l===null&&!B)throw new I({agent:x,outputDir:_});let v=l!==G.version;if(v){if(H)await xQ(_);await cQ(_,b)}let f=[];for(let[q,F]of T){let w=F[0];if(!w)continue;let V=L.get(q);if(!V)continue;if(V.current.inspection.exists&&!V.current.isCrustManaged&&!B)throw new I({agent:w,outputDir:q});let n=await AZ({outputDir:q,canonicalOutputDir:_,allFiles:b,clean:H,installMode:z,inspection:V.current.inspection,installedVersion:V.preferredVersion,currentVersion:G.version}),iQ=await fZ(V),t=DZ({installedVersion:V.preferredVersion,currentVersion:G.version,canonicalChanged:v,pathChanged:n||iQ||V.preferredOutputDir!==q});for(let oQ of F)f.push({agent:oQ,outputDir:q,files:t==="up-to-date"?[]:R,status:t,previousVersion:t==="updated"?V.preferredVersion??void 0:void 0})}{let q=await A(E);if(E!==_&&q!==null&&!await qQ(K,W))await m(E,{recursive:!0,force:!0})}return{agents:f}}async function JQ(Q){let{name:Z,agents:X,scope:$="global"}=Q,W=i(Z),H=BQ(Z),B=P($,W),z=P($,H),J=[],K=new Map;for(let x of X){let G=O(x,$,W),U=K.get(G);if(U)U.push(x);else K.set(G,[x])}for(let[x,G]of K){let U=G[0];if(!U)continue;let N=O(U,$,H),M=await KQ({outputDir:x,legacyOutputDir:N,canonicalOutputDir:B,legacyCanonicalOutputDir:z}),b=await YQ(M.current),R=M.legacy.outputDir!==M.current.outputDir?await YQ(M.legacy):!1,T=b||R,_=b?x:R?N:x;for(let E of G)J.push({agent:E,outputDir:_,status:T?"removed":"not-found"})}if(await A(B)!==null&&!await qQ(W,$))await m(B,{recursive:!0,force:!0});{let x=await A(z);if(z!==B&&x!==null&&!await qQ(H,$))await m(z,{recursive:!0,force:!0})}return{agents:J}}async function d(Q){let{name:Z,agents:X,scope:$="global"}=Q,W=i(Z),H=BQ(Z),B=[],z=new Map;for(let J of X){let K=O(J,$,W),x=z.get(K);if(x)x.push(J);else z.set(K,[J])}for(let[J,K]of z){let x=K[0];if(!x)continue;let G=O(x,$,H),U=P($,W),N=P($,H),M=await KQ({outputDir:J,legacyOutputDir:G,canonicalOutputDir:U,legacyCanonicalOutputDir:N}),b=M.preferredOutputDir??J,R=M.preferredVersion;for(let T of K)B.push({agent:T,outputDir:b,installed:R!==null,version:R??void 0})}return{agents:B}}function DZ(Q){let{installedVersion:Z,currentVersion:X,canonicalChanged:$,pathChanged:W}=Q;if(Z===null)return"installed";if(Z===X&&!$&&!W)return"up-to-date";return"updated"}async function AZ(Q){let{outputDir:Z,canonicalOutputDir:X,allFiles:$,clean:W,installMode:H,inspection:B,installedVersion:z,currentVersion:J}=Q;if(H==="copy")return DQ({outputDir:Z,allFiles:$,clean:W,inspection:B,installedVersion:z,currentVersion:J});try{return await vZ({outputDir:Z,canonicalOutputDir:X,inspection:B})}catch(K){if(H==="symlink")throw Error(`Failed to create symlink at "${Z}" (installMode: symlink).`,{cause:K});let x=await zQ(Z,X);return DQ({outputDir:Z,allFiles:$,clean:W,inspection:x,installedVersion:z,currentVersion:J})}}async function DQ(Q){let{outputDir:Z,allFiles:X,clean:$,inspection:W,installedVersion:H,currentVersion:B}=Q;if(!(!W.exists||W.isSymlink||H!==B))return!1;if(W.isSymlink||$)await xQ(Z);return await cQ(Z,X),!0}async function vZ(Q){let{outputDir:Z,canonicalOutputDir:X,inspection:$}=Q;if($.exists&&$.isSymlink&&$.pointsToCanonical)return!1;if($.exists)await xQ(Z);return await hZ(X,Z),!0}async function zQ(Q,Z){let X;try{X=await NZ(Q)}catch{return{exists:!1,isSymlink:!1,pointsToCanonical:!1}}let $=process.platform==="win32"&&X.isDirectory()&&await fQ(Q)!==null;if(!(X.isSymbolicLink()||$))return{exists:!0,isSymlink:!1,pointsToCanonical:!1};let[H,B,z]=await Promise.all([vQ(Q),vQ(Z),fQ(Q)]);return{exists:!0,isSymlink:!0,pointsToCanonical:H!==null&&B!==null&&H===B||z===Z}}async function AQ(Q,Z){let[X,$]=await Promise.all([A(Q),zQ(Q,Z)]),W=X!==null||$.exists&&$.isSymlink&&$.pointsToCanonical;return{outputDir:Q,version:X,inspection:$,isCrustManaged:W}}async function KQ(Q){let{outputDir:Z,legacyOutputDir:X,canonicalOutputDir:$,legacyCanonicalOutputDir:W}=Q,H=await AQ(Z,$),B=X===Z?H:await AQ(X,W);if(H.isCrustManaged)return{current:H,legacy:B,preferredVersion:H.version,preferredOutputDir:H.outputDir};if(B.isCrustManaged)return{current:H,legacy:B,preferredVersion:B.version,preferredOutputDir:B.outputDir};return{current:H,legacy:B,preferredVersion:null,preferredOutputDir:null}}async function YQ(Q){if(!Q.isCrustManaged||!Q.inspection.exists)return!1;return await m(Q.outputDir,{recursive:!0,force:!0}),!0}async function fZ(Q){if(Q.legacy.outputDir===Q.current.outputDir)return!1;return YQ(Q.legacy)}async function vQ(Q){try{return await PZ(Q)}catch{return null}}async function fQ(Q){try{return await LZ(Q)}catch{return null}}async function hZ(Q,Z){await hQ(pQ(Z),{recursive:!0});let X=process.platform==="win32"?"junction":"dir";await CZ(Q,Z,X)}async function qQ(Q,Z){let X=new Set;for(let $ of u)X.add(O($,Z,Q));for(let $ of X)if(await A($)!==null)return!0;return!1}function pZ(Q){let Z={name:Q.name,description:Q.description,version:Q.version};return[{path:HQ,content:`${JSON.stringify(Z,null,"\t")}
5
+ `)}function VZ(Q){let Z=[...Q.path];for(let X of Q.args)if(X.variadic)Z.push(X.required?`<${X.name}...>`:`[${X.name}...]`);else Z.push(X.required?`<${X.name}>`:`[${X.name}]`);if(Q.flags.length>0)Z.push("[options]");return Z.join(" ")}function IQ(Q){let Z=[`# \`${WQ(Q)}\``,""];if(Q.description)Z.push(Q.description,"");return Z}function NQ(Q){let Z=Q.instructions??[];if(!ZQ(Z))return[];return["## Command Instructions","",...PQ(Z),""]}function LQ(Q){let Z=["## Usage","","```",Q.usage??VZ(Q),"```",""];if(Q.args.length>0)Z.push("## Arguments","",...TZ(Q.args),"");if(Q.flags.length>0)Z.push("## Flags","",...bZ(Q.flags),"");return Z.push("## Command Documentation Authority","","You must treat only the arguments, flags, options, aliases, and defaults documented in this file as supported for this command.","You must not infer or invent additional command-line options.",""),Z}function MZ(Q,Z){let X=["## Subcommands",""];for(let $ of Q.children){let W=D($),H=$Q(Z,W),B=$.description?` - ${$.description}`:"";X.push(`- [\`${$.name}\`](${H})${B}`)}return X.push(""),X}function TZ(Q){let Z=[];Z.push("| Argument | Type | Required | Description |"),Z.push("| -------- | ---- | -------- | ----------- |");for(let X of Q){let $=X.variadic?`${X.name}...`:X.name,W=X.required?"Yes":"No",H=EQ(_Z(X));Z.push(`| \`${$}\` | ${X.type} | ${W} | ${H} |`)}return Z}function _Z(Q){let Z=[];if(Q.description)Z.push(Q.description);if(Q.default!==void 0)Z.push(`Default: \`${Q.default}\``);return Z.join(". ")||"-"}function bZ(Q){let Z=[];Z.push("| Flag | Type | Required | Description |"),Z.push("| ---- | ---- | -------- | ----------- |");for(let X of Q){let $=OZ(X),W=X.required?"Yes":"No",H=EQ(RZ(X));Z.push(`| ${$} | ${X.type} | ${W} | ${H} |`)}return Z}function OZ(Q){let Z=[`\`--${Q.name}\``];if(Q.short)Z.push(`\`-${Q.short}\``);for(let X of Q.aliases)Z.push(`\`--${X}\``);return Z.join(", ")}function RZ(Q){let Z=[];if(Q.description)Z.push(Q.description);if(Q.multiple)Z.push("Can be specified multiple times");if(Q.default!==void 0)Z.push(`Default: \`${Q.default}\``);return Z.join(". ")||"-"}function PQ(Q){return Q.map((Z)=>`- ${Z}`)}function EZ(Q){if(typeof Q==="string")return TQ(Q);return PQ(s(Q))}function CQ(Q,Z){let X=[],$=D(Q);if(X.push("---"),X.push(""),Q.path.length>1){let H=Q.path.slice(0,-1),B=yQ(Z,H);if(B){let z=D(B),J=$Q($,z),K=WQ(B);X.push(`Parent: [\`${K}\`](${J})`),X.push("")}}let W=$Q($,"SKILL.md");return X.push(`[Skill Overview](${W})`),X.push(""),X}function yQ(Q,Z){if(kZ(Q.path,Z))return Q;for(let X of Q.children){let $=yQ(X,Z);if($)return $}return}function kZ(Q,Z){if(Q.length!==Z.length)return!1;for(let X=0;X<Q.length;X++)if(Q[X]!==Z[X])return!1;return!0}import{readFile as jZ}from"fs/promises";import{join as IZ}from"path";var HQ="crust.json";async function A(Q){try{let Z=await jZ(IZ(Q,HQ),"utf-8"),X=JSON.parse(Z);if(typeof X==="object"&&X!==null&&"version"in X&&typeof X.version==="string")return X.version;return null}catch{return null}}var SZ="auto",gQ=/^[a-z0-9]+(-[a-z0-9]+)*$/;function uQ(Q){return Q.length>=1&&Q.length<=64&&gQ.test(Q)}function i(Q){return Q}function BQ(Q){return Q.startsWith("use-")?Q:`use-${Q}`}async function p(Q){let{command:Z,meta:X,agents:$,scope:W="global",clean:H=!0,force:B=!1,installMode:z=SZ}=Q,J=i(X.name),K=BQ(X.name);if(!uQ(J))throw Error(`Invalid skill name "${J}": must be 1\u201364 lowercase `+`alphanumeric characters and hyphens, no leading/trailing/consecutive hyphens. Pattern: ${gQ.source}`);let x=$[0];if(!x)return{agents:[]};let G={...X,name:J},U=bQ(Z),N=kQ(U,G),M=pZ(G),b=[...N,...M].sort((q,F)=>q.path<F.path?-1:q.path>F.path?1:0),R=b.map((q)=>q.path),T=new Map;for(let q of $){let F=O(q,W,G.name),w=T.get(F);if(w)w.push(q);else T.set(F,[q])}let _=P(W,G.name),E=P(W,K),L=new Map;for(let[q,F]of T){let w=F[0];if(!w)continue;L.set(q,await KQ({outputDir:q,legacyOutputDir:O(w,W,K),canonicalOutputDir:_,legacyCanonicalOutputDir:E}))}let l=await A(_);if((await zQ(_,_)).exists&&l===null&&!B)throw new I({agent:x,outputDir:_});let v=l!==G.version;if(v){if(H)await xQ(_);await cQ(_,b)}let f=[];for(let[q,F]of T){let w=F[0];if(!w)continue;let V=L.get(q);if(!V)continue;if(V.current.inspection.exists&&!V.current.isCrustManaged&&!B)throw new I({agent:w,outputDir:q});let n=await AZ({outputDir:q,canonicalOutputDir:_,allFiles:b,clean:H,installMode:z,inspection:V.current.inspection,installedVersion:V.preferredVersion,currentVersion:G.version}),iQ=await fZ(V),t=DZ({installedVersion:V.preferredVersion,currentVersion:G.version,canonicalChanged:v,pathChanged:n||iQ||V.preferredOutputDir!==q});for(let oQ of F)f.push({agent:oQ,outputDir:q,files:t==="up-to-date"?[]:R,status:t,previousVersion:t==="updated"?V.preferredVersion??void 0:void 0})}{let q=await A(E);if(E!==_&&q!==null&&!await qQ(K,W))await m(E,{recursive:!0,force:!0})}return{agents:f}}async function JQ(Q){let{name:Z,agents:X,scope:$="global"}=Q,W=i(Z),H=BQ(Z),B=P($,W),z=P($,H),J=[],K=new Map;for(let x of X){let G=O(x,$,W),U=K.get(G);if(U)U.push(x);else K.set(G,[x])}for(let[x,G]of K){let U=G[0];if(!U)continue;let N=O(U,$,H),M=await KQ({outputDir:x,legacyOutputDir:N,canonicalOutputDir:B,legacyCanonicalOutputDir:z}),b=await YQ(M.current),R=M.legacy.outputDir!==M.current.outputDir?await YQ(M.legacy):!1,T=b||R,_=b?x:R?N:x;for(let E of G)J.push({agent:E,outputDir:_,status:T?"removed":"not-found"})}if(await A(B)!==null&&!await qQ(W,$))await m(B,{recursive:!0,force:!0});{let x=await A(z);if(z!==B&&x!==null&&!await qQ(H,$))await m(z,{recursive:!0,force:!0})}return{agents:J}}async function d(Q){let{name:Z,agents:X,scope:$="global"}=Q,W=i(Z),H=BQ(Z),B=[],z=new Map;for(let J of X){let K=O(J,$,W),x=z.get(K);if(x)x.push(J);else z.set(K,[J])}for(let[J,K]of z){let x=K[0];if(!x)continue;let G=O(x,$,H),U=P($,W),N=P($,H),M=await KQ({outputDir:J,legacyOutputDir:G,canonicalOutputDir:U,legacyCanonicalOutputDir:N}),b=M.preferredOutputDir??J,R=M.preferredVersion;for(let T of K)B.push({agent:T,outputDir:b,installed:R!==null,version:R??void 0})}return{agents:B}}function DZ(Q){let{installedVersion:Z,currentVersion:X,canonicalChanged:$,pathChanged:W}=Q;if(Z===null)return"installed";if(Z===X&&!$&&!W)return"up-to-date";return"updated"}async function AZ(Q){let{outputDir:Z,canonicalOutputDir:X,allFiles:$,clean:W,installMode:H,inspection:B,installedVersion:z,currentVersion:J}=Q;if(H==="copy")return DQ({outputDir:Z,allFiles:$,clean:W,inspection:B,installedVersion:z,currentVersion:J});try{return await vZ({outputDir:Z,canonicalOutputDir:X,inspection:B})}catch(K){if(H==="symlink")throw Error(`Failed to create symlink at "${Z}" (installMode: symlink).`,{cause:K});let x=await zQ(Z,X);return DQ({outputDir:Z,allFiles:$,clean:W,inspection:x,installedVersion:z,currentVersion:J})}}async function DQ(Q){let{outputDir:Z,allFiles:X,clean:$,inspection:W,installedVersion:H,currentVersion:B}=Q;if(!(!W.exists||W.isSymlink||H!==B))return!1;if(W.isSymlink||$)await xQ(Z);return await cQ(Z,X),!0}async function vZ(Q){let{outputDir:Z,canonicalOutputDir:X,inspection:$}=Q;if($.exists&&$.isSymlink&&$.pointsToCanonical)return!1;if($.exists)await xQ(Z);return await hZ(X,Z),!0}async function zQ(Q,Z){let X;try{X=await NZ(Q)}catch{return{exists:!1,isSymlink:!1,pointsToCanonical:!1}}let $=process.platform==="win32"&&X.isDirectory()&&await fQ(Q)!==null;if(!(X.isSymbolicLink()||$))return{exists:!0,isSymlink:!1,pointsToCanonical:!1};let[H,B,z]=await Promise.all([vQ(Q),vQ(Z),fQ(Q)]);return{exists:!0,isSymlink:!0,pointsToCanonical:H!==null&&B!==null&&H===B||z===Z}}async function AQ(Q,Z){let[X,$]=await Promise.all([A(Q),zQ(Q,Z)]),W=X!==null||$.exists&&$.isSymlink&&$.pointsToCanonical;return{outputDir:Q,version:X,inspection:$,isCrustManaged:W}}async function KQ(Q){let{outputDir:Z,legacyOutputDir:X,canonicalOutputDir:$,legacyCanonicalOutputDir:W}=Q,H=await AQ(Z,$),B=X===Z?H:await AQ(X,W);if(H.isCrustManaged)return{current:H,legacy:B,preferredVersion:H.version,preferredOutputDir:H.outputDir};if(B.isCrustManaged)return{current:H,legacy:B,preferredVersion:B.version,preferredOutputDir:B.outputDir};return{current:H,legacy:B,preferredVersion:null,preferredOutputDir:null}}async function YQ(Q){if(!Q.isCrustManaged||!Q.inspection.exists)return!1;return await m(Q.outputDir,{recursive:!0,force:!0}),!0}async function fZ(Q){if(Q.legacy.outputDir===Q.current.outputDir)return!1;return YQ(Q.legacy)}async function vQ(Q){try{return await PZ(Q)}catch{return null}}async function fQ(Q){try{return await LZ(Q)}catch{return null}}async function hZ(Q,Z){await hQ(pQ(Z),{recursive:!0});let X=process.platform==="win32"?"junction":"dir";await CZ(Q,Z,X)}async function qQ(Q,Z){let X=new Set;for(let $ of u)X.add(O($,Z,Q));for(let $ of X)if(await A($)!==null)return!0;return!1}function pZ(Q){let Z={name:Q.name,description:Q.description,version:Q.version};return[{path:HQ,content:`${JSON.stringify(Z,null,"\t")}
6
6
  `}]}async function xQ(Q){await m(Q,{recursive:!0,force:!0})}async function cQ(Q,Z){let X=new Set;for(let W of Z){let H=SQ(Q,W.path),B=pQ(H);X.add(B)}let $=[...X].sort();for(let W of $)await hQ(W,{recursive:!0});for(let W of Z){let H=SQ(Q,W.path);await yZ(H,W.content,"utf-8")}}import{Crust as dQ,VALIDATION_MODE_ENV as gZ}from"@crustjs/core";import{confirm as uZ,multiselect as cZ,select as mZ,spinner as r}from"@crustjs/prompts";import{bold as a,dim as g,yellow as rQ}from"@crustjs/style";var dZ="skill",lQ="global",o="__universal__";function rZ(Q){return Q==="global"||Q==="project"}async function sQ(Q,Z){if(Q!==void 0){if(!rZ(Q))throw Error(`Invalid --scope value: ${String(Q)}. Expected "project" or "global".`);return Q}if(Z.defaultScope)return Z.defaultScope;return mZ({message:"Select scope",choices:[{label:"Project",value:"project"},{label:"Global",value:"global"}],default:lQ})}function GQ(Q){let Z=new Set(S()),X=[];if(Q.some(($)=>Z.has($)))X.push("Universal");for(let $ of Q){if(Z.has($))continue;X.push(y[$])}return X}function mQ(Q){let Z=new Set(S()),X=[],$=Q.find((W)=>Z.has(W.agent));if($)X.push({label:"Universal",outputDir:$.outputDir});for(let W of Q){if(Z.has(W.agent))continue;X.push({label:y[W.agent],outputDir:W.outputDir})}return X}function FQ(Q,Z){return{name:Q.meta.name,description:Q.meta.description??"",version:Z.version,instructions:Z.instructions,license:Z.license,allowedTools:Z.allowedTools,compatibility:Z.compatibility,disableModelInvocation:Z.disableModelInvocation}}function wQ(Q,Z,X,$){if(!$.installed)return!1;let W=O(Q,Z,X.name);return $.version!==X.version||$.outputDir!==W}async function lZ(Q,Z){let X=[...S(),...h()];if(X.length===0)return;let $=FQ(Q,Z),W=["project","global"];for(let H of W){let z=(await d({name:$.name,agents:X,scope:H})).agents.filter((J)=>wQ(J.agent,H,$,J));if(z.length===0)continue;try{await r({message:`Updating ${H} skills...`,task:async({updateMessage:J})=>{let K=await p({command:Q,meta:$,agents:z.map((U)=>U.agent),scope:H,installMode:Z.installMode}),x=K.agents.filter((U)=>U.status==="updated").map((U)=>U.agent),G=GQ(x);if(G.length>0)J(`Updated skill "${$.name}" to v${$.version} for ${G.join(", ")} (${H})`);return K}})}catch(J){if(J instanceof I)console.warn(rQ(`Skill conflict: "${J.details.outputDir}" already exists but was not created by ${$.name}. Skipping auto-update for ${H}. Delete or rename the conflicting skill to resolve.`));else throw J}}}function sZ(Q){let Z;return{name:"skills",async setup(X,$){Z=X.rootCommand;let W=Q.command??dZ;if($.addSubCommand(Z,W,iZ(Z,Q,W)),process.env[gZ]==="1")return;if(X.argv[0]===W)return;if(Q.autoUpdate!==!1)await lZ(Z,Q)}}}function iZ(Q,Z,X){let $=oZ(Q,Z);return new dQ(X).meta({description:"Manage agent skill installations"}).flags({scope:{type:"string",description:"Install scope (project or global)"},all:{type:"boolean",description:"Install for all detected agents non-interactively (universal + detected)"}}).run(async(W)=>{let H=FQ(Q,Z),B=W.flags.all===!0,z=B?Z.defaultScope??lQ:await sQ(W.flags.scope,Z),J=await QQ(),K=S(),x=h(),G=await d({name:H.name,agents:[...K,...x],scope:z}),U=new Set(G.agents.filter((q)=>q.installed).map((q)=>q.agent)),N=new Set(J),M=new Map(G.agents.map((q)=>[q.agent,q])),b=x.filter((q)=>{if(N.has(q))return!0;return M.get(q)?.installed===!0}),R=b.filter((q)=>U.has(q)),T=[];if(K.length>0){let q=K[0];if(!q)throw Error("Expected at least one universal agent");let w=M.get(q)?.outputDir??"path unavailable";T.push({label:"Universal",value:o,hint:w});let V=K.map((n)=>y[n]).join(", ");console.log(g(`Agents supporting universal skills: ${V}`))}for(let q of b){let w=M.get(q)?.outputDir??"path unavailable";T.push({label:y[q],value:q,hint:w})}let _=K.length>0&&K.every((q)=>U.has(q)),E=[...R.filter((q)=>!K.includes(q))];if(_)E.unshift(o);let L;if(B)L=[...K,...b];else{let q=T.length===0?[]:await cZ({message:"Select agents to install skills for",choices:T,default:E,required:!1}),F=new Set(q.filter((w)=>w!==o));if(q.includes(o))for(let w of K)F.add(w);L=[...F]}let l=L.filter((q)=>!U.has(q)),UQ=L.filter((q)=>{let F=M.get(q);return F!==void 0&&wQ(q,z,H,F)}),v=[...U].filter((q)=>!L.includes(q)),f=[...l,...UQ];if(f.length>0)try{let q=await r({message:"Installing skills...",task:async()=>p({command:Q,meta:H,agents:f,scope:z,installMode:Z.installMode})});console.log(`
7
7
  ${a(`Installed "${H.name}" v${H.version}`)}`);for(let F of mQ(q.agents))console.log(g(` ${F.label} \u2192 ${F.outputDir}`))}catch(q){if(q instanceof I)if(B?!0:await uZ({message:`"${q.details.outputDir}" already exists but was not created by Crust. Overwrite?`,default:!1})){let w=await r({message:"Overwriting skill...",task:async()=>p({command:Q,meta:H,agents:[q.details.agent],scope:z,force:!0,installMode:Z.installMode})});console.log(`
8
8
  ${a(`Installed "${H.name}" v${H.version}`)}`);for(let V of mQ(w.agents))console.log(g(` ${V.label} \u2192 ${V.outputDir}`))}else console.log(g(`
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@crustjs/skills",
3
- "version": "0.0.19",
3
+ "version": "0.0.20",
4
4
  "description": "Agent skill generation from Crust command definitions",
5
5
  "type": "module",
6
6
  "license": "MIT",