@crustjs/skills 0.0.20 → 0.0.22
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -2
- package/dist/index.d.ts +9 -2
- package/dist/index.js +10 -10
- package/package.json +8 -7
package/README.md
CHANGED
|
@@ -75,7 +75,7 @@ Prefer readonly commands before mutating project state.
|
|
|
75
75
|
});
|
|
76
76
|
```
|
|
77
77
|
|
|
78
|
-
The plugin automatically updates already-installed skills when the version changes, checking both project and global paths for the current working directory. First-time installation is done via the interactive `skill` subcommand (or `skill update` for update-only flows), or programmatically using the exported primitives.
|
|
78
|
+
The plugin automatically updates already-installed skills when the version changes, checking both project and global paths for the current working directory. If the current working directory is the home directory, `project` scope is normalized to `global` so installs, updates, and status checks use the global skill locations. First-time installation is done via the interactive `skill` subcommand (or `skill update` for update-only flows), or programmatically using the exported primitives.
|
|
79
79
|
|
|
80
80
|
Generated bundles are written once to a canonical store (`.crust/skills` for project scope, `~/.crust/skills` for global scope) and then installed into agent paths via symlink or copy depending on `installMode`.
|
|
81
81
|
|
|
@@ -118,7 +118,7 @@ runMain(app);
|
|
|
118
118
|
If auto-update does not appear to work:
|
|
119
119
|
|
|
120
120
|
- Ensure plugin is passed to `runMain(..., { plugins: [...] })`.
|
|
121
|
-
- Ensure at least one supported agent is detected. Auto-update checks both project and global install paths
|
|
121
|
+
- Ensure at least one supported agent is detected. Auto-update checks both project and global install paths, with home-directory `project` scope treated as `global`.
|
|
122
122
|
- Check for existing conflicting skill directories without `crust.json`.
|
|
123
123
|
|
|
124
124
|
## Recommended Export Pattern
|
|
@@ -302,6 +302,8 @@ resolveCanonicalSkillPath("global", "my-cli");
|
|
|
302
302
|
// → "~/.crust/skills/my-cli"
|
|
303
303
|
```
|
|
304
304
|
|
|
305
|
+
When `process.cwd()` is the home directory, `resolveCanonicalSkillPath("project", ...)` returns the same global path as `resolveCanonicalSkillPath("global", ...)`.
|
|
306
|
+
|
|
305
307
|
### `isValidSkillName(name)`
|
|
306
308
|
|
|
307
309
|
Validates a skill name against the [Agent Skills spec](https://agentskills.io/specification) pattern: 1–64 lowercase alphanumeric characters and hyphens, no leading/trailing/consecutive hyphens.
|
package/dist/index.d.ts
CHANGED
|
@@ -84,7 +84,7 @@ interface SkillMeta {
|
|
|
84
84
|
type AgentTarget = "amp" | "adal" | "antigravity" | "augment" | "claude-code" | "cline" | "codebuddy" | "codex" | "command-code" | "continue" | "cortex" | "crush" | "cursor" | "droid" | "gemini-cli" | "github-copilot" | "goose" | "iflow-cli" | "junie" | "kilo" | "kimi-cli" | "kiro-cli" | "kode" | "mcpjam" | "mistral-vibe" | "mux" | "neovate" | "opencode" | "openclaw" | "openhands" | "pi" | "pochi" | "qoder" | "qwen-code" | "replit" | "roo" | "trae" | "trae-cn" | "windsurf" | "zencoder";
|
|
85
85
|
/** Agent install class used by interactive skill management UX. */
|
|
86
86
|
type AgentClass = "universal" | "additional";
|
|
87
|
-
/** Installation scope — global (home directory) or project (cwd). */
|
|
87
|
+
/** Installation scope — global (home directory) or project (cwd, except home dir which normalizes to global). */
|
|
88
88
|
type Scope = "global" | "project";
|
|
89
89
|
/** Installation strategy for agent skill output paths. */
|
|
90
90
|
type SkillInstallMode = "auto" | "symlink" | "copy";
|
|
@@ -127,12 +127,14 @@ interface GenerateOptions {
|
|
|
127
127
|
* - `"copy"`: write full copies directly into each agent path.
|
|
128
128
|
*
|
|
129
129
|
* Canonical bundles are always generated once under `.crust/skills` (project)
|
|
130
|
-
* or `~/.crust/skills` (global).
|
|
130
|
+
* or `~/.crust/skills` (global). When `process.cwd()` is the home directory,
|
|
131
|
+
* project scope is normalized to the global location.
|
|
131
132
|
* @default "auto"
|
|
132
133
|
*/
|
|
133
134
|
installMode?: SkillInstallMode;
|
|
134
135
|
/**
|
|
135
136
|
* Installation scope — global (home directory) or project (cwd).
|
|
137
|
+
* When `process.cwd()` is the home directory, `"project"` is treated as `"global"`.
|
|
136
138
|
* @default "global"
|
|
137
139
|
*/
|
|
138
140
|
scope?: Scope;
|
|
@@ -182,6 +184,7 @@ interface UninstallOptions {
|
|
|
182
184
|
agents: AgentTarget[];
|
|
183
185
|
/**
|
|
184
186
|
* Installation scope to uninstall from.
|
|
187
|
+
* When `process.cwd()` is the home directory, `"project"` is treated as `"global"`.
|
|
185
188
|
* @default "global"
|
|
186
189
|
*/
|
|
187
190
|
scope?: Scope;
|
|
@@ -203,6 +206,7 @@ interface StatusOptions {
|
|
|
203
206
|
agents: AgentTarget[];
|
|
204
207
|
/**
|
|
205
208
|
* Installation scope to check.
|
|
209
|
+
* When `process.cwd()` is the home directory, `"project"` is treated as `"global"`.
|
|
206
210
|
* @default "global"
|
|
207
211
|
*/
|
|
208
212
|
scope?: Scope;
|
|
@@ -244,6 +248,8 @@ interface StatusResult {
|
|
|
244
248
|
* prompted to choose `project` or `global`.
|
|
245
249
|
* - If `defaultScope` is not set and the terminal is non-interactive, scope
|
|
246
250
|
* falls back to `"global"`.
|
|
251
|
+
* - When `process.cwd()` is the home directory, `"project"` is normalized to
|
|
252
|
+
* `"global"` for path resolution and update/status messaging.
|
|
247
253
|
*/
|
|
248
254
|
interface SkillPluginOptions {
|
|
249
255
|
/** Skill version string — compared against the installed crust.json */
|
|
@@ -253,6 +259,7 @@ interface SkillPluginOptions {
|
|
|
253
259
|
*
|
|
254
260
|
* When omitted, interactive commands prompt for scope in TTY mode.
|
|
255
261
|
* Non-interactive mode falls back to "global".
|
|
262
|
+
* When `process.cwd()` is the home directory, `"project"` behaves as `"global"`.
|
|
256
263
|
*/
|
|
257
264
|
defaultScope?: Scope;
|
|
258
265
|
/**
|
package/dist/index.js
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
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(`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
|
-
`)}function
|
|
4
|
-
`)}function
|
|
5
|
-
`)}function
|
|
6
|
-
`}]}async function
|
|
7
|
-
${
|
|
8
|
-
${
|
|
9
|
-
Skipped ${
|
|
10
|
-
${
|
|
11
|
-
${
|
|
2
|
+
import{accessSync as nQ,constants as tQ}from"fs";import{homedir as o}from"os";import{delimiter as eQ,join as Y}from"path";var j=Y(".agents","skills"),QZ=Y(".crust","skills");function TQ(Q){if(Q!==o())return Y(Q,".config");let Z=process.env.XDG_CONFIG_HOME?.trim();return Z&&Z.length>0?Z:Y(Q,".config")}function I(Q){return Y(Q,".agents","skills")}function ZZ(Q){return Y(Q,".crust","skills")}function c(Q){return Q==="project"&&process.cwd()===o()?"global":Q}var y={amp:{label:"Amp",class:"universal",projectSkillsDir:j,globalSkillsDir:I},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:j,globalSkillsDir:I},codebuddy:{label:"CodeBuddy",class:"additional",projectSkillsDir:Y(".codebuddy","skills"),globalSkillsDir:(Q)=>Y(Q,".codebuddy","skills"),detectCommands:["codebuddy"]},codex:{label:"Codex",class:"universal",projectSkillsDir:j,globalSkillsDir:I},"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(TQ(Q),"crush","skills"),detectCommands:["crush"]},cursor:{label:"Cursor",class:"universal",projectSkillsDir:j,globalSkillsDir:I},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:j,globalSkillsDir:I},"github-copilot":{label:"GitHub Copilot",class:"universal",projectSkillsDir:j,globalSkillsDir:I},goose:{label:"Goose",class:"additional",projectSkillsDir:Y(".goose","skills"),globalSkillsDir:(Q)=>Y(TQ(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:j,globalSkillsDir:I},"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:j,globalSkillsDir:I},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:j,globalSkillsDir:I},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"]}},m=Object.keys(y),D=Object.fromEntries(m.map((Q)=>[Q,y[Q].label]));function S(){return m.filter((Q)=>y[Q].class==="universal")}function h(){return m.filter((Q)=>y[Q].class==="additional")}function XZ(Q){return y[Q].class==="universal"}async function XQ(Q){let Z=typeof Q==="string"?{home:Q}:Q??{},X=Z.cwd??process.cwd(),$=Z.commandChecker??((H)=>Promise.resolve($Z(H))),W=[];for(let H of h()){let q=y[H].detectCommands??[],x=!1;for(let J of q)if(await $(J,X)){x=!0;break}if(x)W.push(H)}return W}function E(Q,Z,X){let $=c(Z),W=y[Q];if($==="project")return Y(process.cwd(),W.projectSkillsDir,X);return Y(W.globalSkillsDir(o()),X)}function C(Q,Z){if(c(Q)==="project")return Y(process.cwd(),QZ,Z);return Y(ZZ(o()),Z)}function $Z(Q){let X=(process.env.PATH??"").split(eQ).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(!$&&_Q(Y(H,Q)))return!0;if($){for(let q of W)if(_Q(Y(H,Q+q)))return!0}}return!1}function _Q(Q){try{return nQ(Q,tQ.X_OK),!0}catch{return!1}}import{Crust as WZ}from"@crustjs/core";function a(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 bQ(Q){let Z=Q?.trim();if(!Z)return[];return Z.split(/\r?\n/)}function $Q(Q){return Q.length>0}var OQ=Symbol("crust.skill.commandAnnotations");function HZ(Q){return Q instanceof WZ?Q._node:Q}function YZ(Q,Z){let X=HZ(Q),$=a(typeof Z==="string"||Array.isArray(Z)?Z:Z.instructions??[]);if($.length===0)return Q;let W=WQ(X)?.instructions??[],H=[...new Set([...W,...$])];return Object.defineProperty(X,OQ,{value:{instructions:H},enumerable:!0,configurable:!0}),Q}function WQ(Q){let Z=Q[OQ];if(!Z?.instructions||Z.instructions.length===0)return;return{instructions:[...Z.instructions]}}class N 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 LZ,mkdir as gQ,readlink as PZ,realpath as CZ,rm as r,symlink as yZ,writeFile as DZ}from"fs/promises";import{dirname as uQ,join as AQ}from"path";function RQ(Q){return kQ(Q,[])}function kQ(Q,Z){let X=qZ(Q.meta.name),$=[...Z,X],W=BZ(Q.args),H=zZ(Q.effectiveFlags),q=xZ(Q.subCommands,$),x=WQ(Q);return{name:X,path:$,description:Q.meta.description,usage:Q.meta.usage,instructions:x?.instructions,runnable:typeof Q.run==="function",args:W,flags:H,children:q}}function qZ(Q){return Q.trim().toLowerCase()}function BZ(Q){if(!Q||Q.length===0)return[];return Q.map(JZ)}function JZ(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=EQ(Q.default);return Z}function zZ(Q){if(!Q)return[];return Object.keys(Q).sort().map((X)=>{return KZ(X,Q[X])})}function KZ(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=EQ(Z.default);return X}function xZ(Q,Z){return Object.keys(Q).sort().map(($)=>{return kQ(Q[$],Z)})}function EQ(Q){if(Array.isArray(Q))return JSON.stringify(Q);return String(Q)}function d(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 jQ(Q){return Q.replace(/(?<!\\)\|/g,"\\|")}function IQ(Q,Z){let X=[],$=NQ(Q);X.push({path:"SKILL.md",content:GZ(Q,Z,$)});for(let W of $){let H=A(W),q=W.children.length>0?VZ(W,Q):UZ(W,Q);X.push({path:H,content:q})}return X}function NQ(Q){let Z=[Q];for(let X of Q.children)Z.push(...NQ(X));return Z}function A(Q){if(Q.path.length<=1)return`commands/${Q.name}.md`;return`commands/${Q.path.slice(1).join("/")}.md`}function YQ(Q){return Q.path.join(" ")}function HQ(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,q=$.slice(W);if(H===0)return q.join("/");return[...Array.from({length:H},()=>".."),...q].join("/")}function GZ(Q,Z,X){let $=[];if($.push("---"),$.push(`name: ${d(Z.name)}`),$.push(`description: ${d(Z.description)}`),Z.license)$.push(`license: ${d(Z.license)}`);if(Z.compatibility)$.push(`compatibility: ${d(Z.compatibility)}`);if(Z.disableModelInvocation)$.push("disable-model-invocation: true");if(Z.allowedTools)$.push(`allowed-tools: ${d(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(""),$Q(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(...FZ(X)),$.push(""),Q.runnable){$.push("## Usage"),$.push("");let H=A(Q);$.push(`The root command is directly executable. You should see [${Q.name}](${H}) for usage details.`),$.push("")}return $.join(`
|
|
3
|
+
`)}function FZ(Q){let Z=[];Z.push("| Command | Type | Documentation |"),Z.push("| ------- | ---- | ------------- |");for(let X of Q){let $=YQ(X),W=A(X),H=wZ(X);Z.push(`| \`${$}\` | ${H} | [${W}](${W}) |`)}return Z}function wZ(Q){if(Q.runnable&&Q.children.length>0)return"runnable, group";if(Q.runnable)return"runnable";return"group"}function UZ(Q,Z){let X=[];return X.push(...LQ(Q)),X.push(...PQ(Q)),X.push(...CQ(Q)),X.push(...DQ(Q,Z)),X.join(`
|
|
4
|
+
`)}function VZ(Q,Z){let X=[],$=A(Q);if(X.push(...LQ(Q)),X.push(...PQ(Q)),Q.runnable)X.push(...CQ(Q));return X.push(...TZ(Q,$)),X.push(...DQ(Q,Z)),X.join(`
|
|
5
|
+
`)}function MZ(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 LQ(Q){let Z=[`# \`${YQ(Q)}\``,""];if(Q.description)Z.push(Q.description,"");return Z}function PQ(Q){let Z=Q.instructions??[];if(!$Q(Z))return[];return["## Command Instructions","",...yQ(Z),""]}function CQ(Q){let Z=["## Usage","","```",Q.usage??MZ(Q),"```",""];if(Q.args.length>0)Z.push("## Arguments","",..._Z(Q.args),"");if(Q.flags.length>0)Z.push("## Flags","",...OZ(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 TZ(Q,Z){let X=["## Subcommands",""];for(let $ of Q.children){let W=A($),H=HQ(Z,W),q=$.description?` - ${$.description}`:"";X.push(`- [\`${$.name}\`](${H})${q}`)}return X.push(""),X}function _Z(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=jQ(bZ(X));Z.push(`| \`${$}\` | ${X.type} | ${W} | ${H} |`)}return Z}function bZ(Q){let Z=[];if(Q.description)Z.push(Q.description);if(Q.default!==void 0)Z.push(`Default: \`${Q.default}\``);return Z.join(". ")||"-"}function OZ(Q){let Z=[];Z.push("| Flag | Type | Required | Description |"),Z.push("| ---- | ---- | -------- | ----------- |");for(let X of Q){let $=RZ(X),W=X.required?"Yes":"No",H=jQ(kZ(X));Z.push(`| ${$} | ${X.type} | ${W} | ${H} |`)}return Z}function RZ(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 kZ(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 yQ(Q){return Q.map((Z)=>`- ${Z}`)}function EZ(Q){if(typeof Q==="string")return bQ(Q);return yQ(a(Q))}function DQ(Q,Z){let X=[],$=A(Q);if(X.push("---"),X.push(""),Q.path.length>1){let H=Q.path.slice(0,-1),q=SQ(Z,H);if(q){let x=A(q),J=HQ($,x),K=YQ(q);X.push(`Parent: [\`${K}\`](${J})`),X.push("")}}let W=HQ($,"SKILL.md");return X.push(`[Skill Overview](${W})`),X.push(""),X}function SQ(Q,Z){if(jZ(Q.path,Z))return Q;for(let X of Q.children){let $=SQ(X,Z);if($)return $}return}function jZ(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 IZ}from"fs/promises";import{join as NZ}from"path";var qQ="crust.json";async function v(Q){try{let Z=await IZ(NZ(Q,qQ),"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",cQ=/^[a-z0-9]+(-[a-z0-9]+)*$/;function mQ(Q){return Q.length>=1&&Q.length<=64&&cQ.test(Q)}function n(Q){return Q}function zQ(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:q=!1,installMode:x=SZ}=Q,J=n(X.name),K=zQ(X.name);if(!mQ(J))throw Error(`Invalid skill name "${J}": must be 1\u201364 lowercase `+`alphanumeric characters and hyphens, no leading/trailing/consecutive hyphens. Pattern: ${cQ.source}`);let z=$[0];if(!z)return{agents:[]};let G={...X,name:J},F=RQ(Z),_=IQ(F,G),b=gZ(G),T=[..._,...b].sort((w,B)=>w.path<B.path?-1:w.path>B.path?1:0),O=T.map((w)=>w.path),R=new Map;for(let w of $){let B=E(w,W,G.name),U=R.get(B);if(U)U.push(w);else R.set(B,[w])}let M=C(W,G.name),L=C(W,K),u=new Map;for(let[w,B]of R){let U=B[0];if(!U)continue;u.set(w,await GQ({outputDir:w,legacyOutputDir:E(U,W,K),canonicalOutputDir:M,legacyCanonicalOutputDir:L}))}let P=await v(M);if((await xQ(M,M)).exists&&P===null&&!q)throw new N({agent:z,outputDir:M});let i=P!==G.version;if(i){if(H)await FQ(M);await dQ(M,T)}let f=[];for(let[w,B]of R){let U=B[0];if(!U)continue;let V=u.get(w);if(!V)continue;if(V.current.inspection.exists&&!V.current.isCrustManaged&&!q)throw new N({agent:U,outputDir:w});let k=await vZ({outputDir:w,canonicalOutputDir:M,allFiles:T,clean:H,installMode:x,inspection:V.current.inspection,installedVersion:V.preferredVersion,currentVersion:G.version}),QQ=await hZ(V),ZQ=AZ({installedVersion:V.preferredVersion,currentVersion:G.version,canonicalChanged:i,pathChanged:k||QQ||V.preferredOutputDir!==w});for(let aQ of B)f.push({agent:aQ,outputDir:w,files:ZQ==="up-to-date"?[]:O,status:ZQ,previousVersion:ZQ==="updated"?V.preferredVersion??void 0:void 0})}{let w=await v(L);if(L!==M&&w!==null&&!await JQ(K,W))await r(L,{recursive:!0,force:!0})}return{agents:f}}async function KQ(Q){let{name:Z,agents:X,scope:$="global"}=Q,W=n(Z),H=zQ(Z),q=C($,W),x=C($,H),J=[],K=new Map;for(let z of X){let G=E(z,$,W),F=K.get(G);if(F)F.push(z);else K.set(G,[z])}for(let[z,G]of K){let F=G[0];if(!F)continue;let _=E(F,$,H),b=await GQ({outputDir:z,legacyOutputDir:_,canonicalOutputDir:q,legacyCanonicalOutputDir:x}),T=await BQ(b.current),O=b.legacy.outputDir!==b.current.outputDir?await BQ(b.legacy):!1,R=T||O,M=T?z:O?_:z;for(let L of G)J.push({agent:L,outputDir:M,status:R?"removed":"not-found"})}if(await v(q)!==null&&!await JQ(W,$))await r(q,{recursive:!0,force:!0});{let z=await v(x);if(x!==q&&z!==null&&!await JQ(H,$))await r(x,{recursive:!0,force:!0})}return{agents:J}}async function l(Q){let{name:Z,agents:X,scope:$="global"}=Q,W=n(Z),H=zQ(Z),q=[],x=new Map;for(let J of X){let K=E(J,$,W),z=x.get(K);if(z)z.push(J);else x.set(K,[J])}for(let[J,K]of x){let z=K[0];if(!z)continue;let G=E(z,$,H),F=C($,W),_=C($,H),b=await GQ({outputDir:J,legacyOutputDir:G,canonicalOutputDir:F,legacyCanonicalOutputDir:_}),T=b.preferredOutputDir??J,O=b.preferredVersion;for(let R of K)q.push({agent:R,outputDir:T,installed:O!==null,version:O??void 0})}return{agents:q}}function AZ(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 vZ(Q){let{outputDir:Z,canonicalOutputDir:X,allFiles:$,clean:W,installMode:H,inspection:q,installedVersion:x,currentVersion:J}=Q;if(H==="copy")return vQ({outputDir:Z,allFiles:$,clean:W,inspection:q,installedVersion:x,currentVersion:J});try{return await fZ({outputDir:Z,canonicalOutputDir:X,inspection:q})}catch(K){if(H==="symlink")throw Error(`Failed to create symlink at "${Z}" (installMode: symlink).`,{cause:K});let z=await xQ(Z,X);return vQ({outputDir:Z,allFiles:$,clean:W,inspection:z,installedVersion:x,currentVersion:J})}}async function vQ(Q){let{outputDir:Z,allFiles:X,clean:$,inspection:W,installedVersion:H,currentVersion:q}=Q;if(!(!W.exists||W.isSymlink||H!==q))return!1;if(W.isSymlink||$)await FQ(Z);return await dQ(Z,X),!0}async function fZ(Q){let{outputDir:Z,canonicalOutputDir:X,inspection:$}=Q;if($.exists&&$.isSymlink&&$.pointsToCanonical)return!1;if($.exists)await FQ(Z);return await pZ(X,Z),!0}async function xQ(Q,Z){let X;try{X=await LZ(Q)}catch{return{exists:!1,isSymlink:!1,pointsToCanonical:!1}}let $=process.platform==="win32"&&X.isDirectory()&&await pQ(Q)!==null;if(!(X.isSymbolicLink()||$))return{exists:!0,isSymlink:!1,pointsToCanonical:!1};let[H,q,x]=await Promise.all([hQ(Q),hQ(Z),pQ(Q)]);return{exists:!0,isSymlink:!0,pointsToCanonical:H!==null&&q!==null&&H===q||x===Z}}async function fQ(Q,Z){let[X,$]=await Promise.all([v(Q),xQ(Q,Z)]),W=X!==null||$.exists&&$.isSymlink&&$.pointsToCanonical;return{outputDir:Q,version:X,inspection:$,isCrustManaged:W}}async function GQ(Q){let{outputDir:Z,legacyOutputDir:X,canonicalOutputDir:$,legacyCanonicalOutputDir:W}=Q,H=await fQ(Z,$),q=X===Z?H:await fQ(X,W);if(H.isCrustManaged)return{current:H,legacy:q,preferredVersion:H.version,preferredOutputDir:H.outputDir};if(q.isCrustManaged)return{current:H,legacy:q,preferredVersion:q.version,preferredOutputDir:q.outputDir};return{current:H,legacy:q,preferredVersion:null,preferredOutputDir:null}}async function BQ(Q){if(!Q.isCrustManaged||!Q.inspection.exists)return!1;return await r(Q.outputDir,{recursive:!0,force:!0}),!0}async function hZ(Q){if(Q.legacy.outputDir===Q.current.outputDir)return!1;return BQ(Q.legacy)}async function hQ(Q){try{return await CZ(Q)}catch{return null}}async function pQ(Q){try{return await PZ(Q)}catch{return null}}async function pZ(Q,Z){await gQ(uQ(Z),{recursive:!0});let X=process.platform==="win32"?"junction":"dir";await yZ(Q,Z,X)}async function JQ(Q,Z){let X=new Set;for(let $ of m)X.add(E($,Z,Q));for(let $ of X)if(await v($)!==null)return!0;return!1}function gZ(Q){let Z={name:Q.name,description:Q.description,version:Q.version};return[{path:qQ,content:`${JSON.stringify(Z,null,"\t")}
|
|
6
|
+
`}]}async function FQ(Q){await r(Q,{recursive:!0,force:!0})}async function dQ(Q,Z){let X=new Set;for(let W of Z){let H=AQ(Q,W.path),q=uQ(H);X.add(q)}let $=[...X].sort();for(let W of $)await gQ(W,{recursive:!0});for(let W of Z){let H=AQ(Q,W.path);await DZ(H,W.content,"utf-8")}}import{Crust as lQ,VALIDATION_MODE_ENV as uZ}from"@crustjs/core";import{spinner as s}from"@crustjs/progress";import{confirm as cZ,multiselect as mZ,select as dZ}from"@crustjs/prompts";import{bold as e,dim as g,yellow as sQ}from"@crustjs/style";var rZ="skill",iQ="global",t="__universal__";function lZ(Q){return Q==="global"||Q==="project"}async function oQ(Q,Z){if(Q!==void 0){if(!lZ(Q))throw Error(`Invalid --scope value: ${String(Q)}. Expected "project" or "global".`);return Q}if(Z.defaultScope)return Z.defaultScope;return dZ({message:"Select scope",choices:[{label:"Project",value:"project"},{label:"Global",value:"global"}],default:iQ})}function wQ(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(D[$])}return X}function rQ(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:D[W.agent],outputDir:W.outputDir})}return X}function UQ(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 VQ(Q,Z,X,$){if(!$.installed)return!1;let W=E(Q,Z,X.name);return $.version!==X.version||$.outputDir!==W}async function sZ(Q,Z){let X=[...S(),...h()];if(X.length===0)return;let $=UQ(Q,Z),W=[...new Set(["project","global"].map((H)=>c(H)))];for(let H of W){let x=(await l({name:$.name,agents:X,scope:H})).agents.filter((J)=>VQ(J.agent,H,$,J));if(x.length===0)continue;try{await s({message:`Updating ${H} skills...`,task:async({updateMessage:J})=>{let K=await p({command:Q,meta:$,agents:x.map((F)=>F.agent),scope:H,installMode:Z.installMode}),z=K.agents.filter((F)=>F.status==="updated").map((F)=>F.agent),G=wQ(z);if(G.length>0)J(`Updated skill "${$.name}" to v${$.version} for ${G.join(", ")} (${H})`);return K}})}catch(J){if(J instanceof N)console.warn(sQ(`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 iZ(Q){let Z;return{name:"skills",async setup(X,$){Z=X.rootCommand;let W=Q.command??rZ;if($.addSubCommand(Z,W,oZ(Z,Q,W)),process.env[uZ]==="1")return;if(X.argv[0]===W)return;if(Q.autoUpdate!==!1)await sZ(Z,Q)}}}function oZ(Q,Z,X){let $=aZ(Q,Z);return new lQ(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=UQ(Q,Z),q=W.flags.all===!0,x=!!process.stdin.isTTY,J=q?Z.defaultScope??iQ:await oQ(W.flags.scope,Z),K=await XQ(),z=S(),G=h(),F=await l({name:H.name,agents:[...z,...G],scope:J}),_=new Set(F.agents.filter((B)=>B.installed).map((B)=>B.agent)),b=new Set(K),T=new Map(F.agents.map((B)=>[B.agent,B])),O=G.filter((B)=>{if(b.has(B))return!0;return T.get(B)?.installed===!0}),R=O.filter((B)=>_.has(B)),M=[];if(z.length>0){let B=z[0];if(!B)throw Error("Expected at least one universal agent");let V=T.get(B)?.outputDir??"path unavailable";M.push({label:"Universal",value:t,hint:V});let k=z.map((QQ)=>D[QQ]).join(", ");if(x&&!q)console.log(g(`Agents supporting universal skills: ${k}`))}for(let B of O){let V=T.get(B)?.outputDir??"path unavailable";M.push({label:D[B],value:B,hint:V})}let L=z.length>0&&z.every((B)=>_.has(B)),u=[...R.filter((B)=>!z.includes(B))];if(L)u.unshift(t);let P;if(q)P=[...z,...O];else{let B=M.length===0?[]:await mZ({message:"Select agents to install skills for",choices:M,default:u,required:!1}),U=new Set(B.filter((V)=>V!==t));if(B.includes(t))for(let V of z)U.add(V);P=[...U]}let MQ=P.filter((B)=>!_.has(B)),i=P.filter((B)=>{let U=T.get(B);return U!==void 0&&VQ(B,J,H,U)}),f=[..._].filter((B)=>!P.includes(B)),w=[...MQ,...i];if(w.length>0)try{let B=await s({message:"Installing skills...",task:async()=>p({command:Q,meta:H,agents:w,scope:J,installMode:Z.installMode})});console.log(`
|
|
7
|
+
${e(`Installed "${H.name}" v${H.version}`)}`);for(let U of rQ(B.agents))console.log(g(` ${U.label} \u2192 ${U.outputDir}`))}catch(B){if(B instanceof N)if(q?!0:await cZ({message:`"${B.details.outputDir}" already exists but was not created by Crust. Overwrite?`,default:!1})){let V=await s({message:"Overwriting skill...",task:async()=>p({command:Q,meta:H,agents:[B.details.agent],scope:J,force:!0,installMode:Z.installMode})});console.log(`
|
|
8
|
+
${e(`Installed "${H.name}" v${H.version}`)}`);for(let k of rQ(V.agents))console.log(g(` ${k.label} \u2192 ${k.outputDir}`))}else console.log(g(`
|
|
9
|
+
Skipped ${D[B.details.agent]}`));else throw B}if(f.length>0){let U=(await s({message:"Removing skills...",task:async()=>KQ({name:H.name,agents:f,scope:J})})).agents.filter((k)=>k.status==="removed").map((k)=>k.agent),V=wQ(U);if(V.length>0)console.log(`
|
|
10
|
+
${e(`Removed from ${V.join(", ")}`)}`)}if(w.length===0&&f.length===0)console.log(g("No changes."))}).command($)._node}function aZ(Q,Z){return new lQ("update").meta({description:"Update installed skills to latest version"}).flags({scope:{type:"string",description:"Update scope (project or global)"}}).run(async(X)=>{let $=await oQ(X.flags.scope,Z),W=c($),H=[...S(),...h()],q=UQ(Q,Z),J=(await l({name:q.name,agents:H,scope:$})).agents.filter((K)=>VQ(K.agent,$,q,K));if(J.length===0){console.log(g(`No updates needed (${W}).`));return}try{let z=(await s({message:`Updating ${W} skills...`,task:async()=>p({command:Q,meta:q,agents:J.map((F)=>F.agent),scope:$,installMode:Z.installMode})})).agents.filter((F)=>F.status==="updated").map((F)=>F.agent),G=wQ(z);if(G.length>0)console.log(`
|
|
11
|
+
${e(`Updated "${q.name}" to v${q.version} for ${G.join(", ")} (${W})`)}`)}catch(K){if(K instanceof N)console.warn(sQ(`Skipped ${D[K.details.agent]}: "${K.details.outputDir}" already exists but was not created by ${q.name}. Delete or rename the conflicting directory to resolve.`));else throw K}})}export{KQ as uninstallSkill,l as skillStatus,iZ as skillPlugin,n as resolveSkillName,C as resolveCanonicalSkillPath,mQ as isValidSkillName,XZ as isUniversalAgent,S as getUniversalAgents,h as getAdditionalAgents,p as generateSkill,XQ as detectInstalledAgents,YZ as annotate,N as SkillConflictError};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@crustjs/skills",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.22",
|
|
4
4
|
"description": "Agent skill generation from Crust command definitions",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -43,16 +43,17 @@
|
|
|
43
43
|
"publish": "bun publish --no-git-checks || true"
|
|
44
44
|
},
|
|
45
45
|
"dependencies": {
|
|
46
|
-
"@crustjs/
|
|
47
|
-
"@crustjs/
|
|
46
|
+
"@crustjs/progress": "0.0.2",
|
|
47
|
+
"@crustjs/prompts": "0.0.11",
|
|
48
|
+
"@crustjs/style": "0.0.6"
|
|
48
49
|
},
|
|
49
50
|
"devDependencies": {
|
|
50
51
|
"@crustjs/config": "0.0.0",
|
|
51
|
-
"@crustjs/core": "0.0.
|
|
52
|
-
"bunup": "^0.16.
|
|
52
|
+
"@crustjs/core": "0.0.16",
|
|
53
|
+
"bunup": "^0.16.31"
|
|
53
54
|
},
|
|
54
55
|
"peerDependencies": {
|
|
55
|
-
"@crustjs/core": "0.0.
|
|
56
|
-
"typescript": "^
|
|
56
|
+
"@crustjs/core": "0.0.16",
|
|
57
|
+
"typescript": "^6.0.2"
|
|
57
58
|
}
|
|
58
59
|
}
|