@vibe-agent-toolkit/utils 0.1.26 → 0.1.27

package/dist/index.d.ts

@@ -15,4 +15,5 @@ export * from './git-tracker.js';
 export * from './test-helpers.js';
 export * from './zod-introspection.js';
 export * from './template.js';
+export * from './skill-targets.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,eAAe,CAAC;AAG9B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,eAAe,CAAC;AAG9B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,eAAe,CAAC;AAG9B,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -26,4 +26,6 @@ export * from './test-helpers.js';
 export * from './zod-introspection.js';
 // Handlebars template rendering (cached, no HTML escaping)
 export * from './template.js';
+// Skill target resolution (cross-platform flat skill install paths)
+export * from './skill-targets.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8DAA8D;AAC9D,cAAc,gBAAgB,CAAC;AAE/B,gCAAgC;AAChC,cAAc,iBAAiB,CAAC;AAEhC,uBAAuB;AACvB,cAAc,eAAe,CAAC;AAE9B,wCAAwC;AACxC,cAAc,mBAAmB,CAAC;AAElC,sBAAsB;AACtB,cAAc,wBAAwB,CAAC;AAEvC,8CAA8C;AAC9C,cAAc,gBAAgB,CAAC;AAE/B,kEAAkE;AAClE,cAAc,oBAAoB,CAAC;AAEnC,yDAAyD;AACzD,cAAc,kBAAkB,CAAC;AAEjC,oDAAoD;AACpD,cAAc,mBAAmB,CAAC;AAElC,4CAA4C;AAC5C,cAAc,wBAAwB,CAAC;AAEvC,2DAA2D;AAC3D,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8DAA8D;AAC9D,cAAc,gBAAgB,CAAC;AAE/B,gCAAgC;AAChC,cAAc,iBAAiB,CAAC;AAEhC,uBAAuB;AACvB,cAAc,eAAe,CAAC;AAE9B,wCAAwC;AACxC,cAAc,mBAAmB,CAAC;AAElC,sBAAsB;AACtB,cAAc,wBAAwB,CAAC;AAEvC,8CAA8C;AAC9C,cAAc,gBAAgB,CAAC;AAE/B,kEAAkE;AAClE,cAAc,oBAAoB,CAAC;AAEnC,yDAAyD;AACzD,cAAc,kBAAkB,CAAC;AAEjC,oDAAoD;AACpD,cAAc,mBAAmB,CAAC;AAElC,4CAA4C;AAC5C,cAAc,wBAAwB,CAAC;AAEvC,2DAA2D;AAC3D,cAAc,eAAe,CAAC;AAE9B,oEAAoE;AACpE,cAAc,oBAAoB,CAAC"}

package/dist/skill-targets.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Skill target resolution — map (target, scope) to an installation directory.
+ *
+ * This is a pure lookup table with no vendor-specific logic. Adding new targets
+ * is just adding entries to the SKILL_TARGETS constant.
+ *
+ * Paths use forward slashes on all platforms (see utils/CLAUDE.md).
+ */
+export declare const SKILL_TARGET_NAMES: readonly ["claude", "codex", "copilot", "gemini", "cursor", "windsurf", "agents"];
+export type SkillTarget = (typeof SKILL_TARGET_NAMES)[number];
+export declare const SKILL_SCOPE_NAMES: readonly ["user", "project"];
+export type SkillScope = (typeof SKILL_SCOPE_NAMES)[number];
+interface SkillTargetPaths {
+    /** Path relative to the user home directory (without leading ~/) */
+    readonly userRel: string;
+    /** Path relative to the project root (current working directory) */
+    readonly projectRel: string;
+}
+/**
+ * Target → {userRel, projectRel} lookup table.
+ *
+ * These paths are based on the 2026-04-08 ecosystem analysis. Update this table
+ * when platforms change their conventions. See docs/plans/2026-04-08-agent-skills-ecosystem-analysis.md.
+ */
+export declare const SKILL_TARGETS: Readonly<Record<SkillTarget, SkillTargetPaths>>;
+/**
+ * Resolve a (target, scope, cwd) triple to an absolute skills directory.
+ *
+ * @param target - Platform target (claude, codex, copilot, gemini, cursor, windsurf, agents)
+ * @param scope - user (home dir) or project (cwd)
+ * @param cwd - Current working directory for project scope. Pass explicitly for testability.
+ * @returns Absolute path to the skills directory using forward slashes
+ * @throws Error with a helpful message listing valid values if target or scope is invalid
+ */
+export declare function resolveSkillTarget(target: SkillTarget, scope: SkillScope, cwd: string): string;
+export {};
+//# sourceMappingURL=skill-targets.d.ts.map

package/dist/skill-targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-targets.d.ts","sourceRoot":"","sources":["../src/skill-targets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,eAAO,MAAM,kBAAkB,mFAQrB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,eAAO,MAAM,iBAAiB,8BAA+B,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,UAAU,gBAAgB;IACxB,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAKD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAQzE,CAAC;AAUF;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,MAAM,GACV,MAAM,CAgBR"}

package/dist/skill-targets.js

@@ -0,0 +1,65 @@
+/**
+ * Skill target resolution — map (target, scope) to an installation directory.
+ *
+ * This is a pure lookup table with no vendor-specific logic. Adding new targets
+ * is just adding entries to the SKILL_TARGETS constant.
+ *
+ * Paths use forward slashes on all platforms (see utils/CLAUDE.md).
+ */
+import { homedir } from 'node:os';
+import { safePath } from './path-utils.js';
+export const SKILL_TARGET_NAMES = [
+    'claude',
+    'codex',
+    'copilot',
+    'gemini',
+    'cursor',
+    'windsurf',
+    'agents',
+];
+export const SKILL_SCOPE_NAMES = ['user', 'project'];
+/** Shared path used by both codex and agents targets (and their user/project scopes). */
+const AGENTS_SKILLS_PATH = '.agents/skills';
+/**
+ * Target → {userRel, projectRel} lookup table.
+ *
+ * These paths are based on the 2026-04-08 ecosystem analysis. Update this table
+ * when platforms change their conventions. See docs/plans/2026-04-08-agent-skills-ecosystem-analysis.md.
+ */
+export const SKILL_TARGETS = {
+    claude: { userRel: '.claude/skills', projectRel: '.claude/skills' },
+    codex: { userRel: AGENTS_SKILLS_PATH, projectRel: AGENTS_SKILLS_PATH },
+    copilot: { userRel: '.copilot/skills', projectRel: '.github/skills' },
+    gemini: { userRel: '.gemini/skills', projectRel: '.gemini/skills' },
+    cursor: { userRel: '.cursor/skills', projectRel: '.cursor/skills' },
+    windsurf: { userRel: '.codeium/windsurf/skills', projectRel: '.windsurf/skills' },
+    agents: { userRel: AGENTS_SKILLS_PATH, projectRel: AGENTS_SKILLS_PATH },
+};
+function isSkillTarget(value) {
+    return SKILL_TARGET_NAMES.includes(value);
+}
+function isSkillScope(value) {
+    return SKILL_SCOPE_NAMES.includes(value);
+}
+/**
+ * Resolve a (target, scope, cwd) triple to an absolute skills directory.
+ *
+ * @param target - Platform target (claude, codex, copilot, gemini, cursor, windsurf, agents)
+ * @param scope - user (home dir) or project (cwd)
+ * @param cwd - Current working directory for project scope. Pass explicitly for testability.
+ * @returns Absolute path to the skills directory using forward slashes
+ * @throws Error with a helpful message listing valid values if target or scope is invalid
+ */
+export function resolveSkillTarget(target, scope, cwd) {
+    if (!isSkillTarget(target)) {
+        throw new Error(`Invalid target "${String(target)}". Valid targets: ${SKILL_TARGET_NAMES.join(', ')}`);
+    }
+    if (!isSkillScope(scope)) {
+        throw new Error(`Invalid scope "${String(scope)}". Valid scopes: ${SKILL_SCOPE_NAMES.join(', ')}`);
+    }
+    const entry = SKILL_TARGETS[target];
+    const base = scope === 'user' ? homedir() : cwd;
+    const rel = scope === 'user' ? entry.userRel : entry.projectRel;
+    return safePath.join(base, rel);
+}
+//# sourceMappingURL=skill-targets.js.map

package/dist/skill-targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-targets.js","sourceRoot":"","sources":["../src/skill-targets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ;IACR,OAAO;IACP,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,QAAQ;CACA,CAAC;AAIX,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,SAAS,CAAU,CAAC;AAW9D,yFAAyF;AACzF,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAoD;IAC5E,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACnE,KAAK,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,kBAAkB,EAAE;IACtE,OAAO,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACrE,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACnE,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACnE,QAAQ,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE,UAAU,EAAE,kBAAkB,EAAE;IACjF,MAAM,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,kBAAkB,EAAE;CACxE,CAAC;AAEF,SAAS,aAAa,CAAC,KAAa;IAClC,OAAQ,kBAAwC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAQ,iBAAuC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAmB,EACnB,KAAiB,EACjB,GAAW;IAEX,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,CAAC,MAAM,CAAC,qBAAqB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,CAAC,KAAK,CAAC,oBAAoB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAChD,MAAM,GAAG,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IAChE,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-agent-toolkit/utils",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "type": "module",
   "description": "Core utility functions with no external dependencies",
   "keywords": [