uasp-skills 0.1.0

package/dist/core/github.js

@@ -0,0 +1,91 @@
+/**
+ * GitHub integration for fetching skills
+ */
+import fetch from 'node-fetch';
+import fs from 'fs/promises';
+import path from 'path';
+/**
+ * Parse a GitHub URL or local path into components
+ * Supports formats:
+ * - https://github.com/owner/repo/tree/branch/path
+ * - https://github.com/owner/repo/path (assumes main branch)
+ * - github:owner/repo/path
+ * - file:///absolute/path (local file)
+ * - /absolute/path (local file)
+ * - ./relative/path (local file)
+ */
+export function parseGitHubUrl(url) {
+    // Handle local file paths
+    if (url.startsWith('file://') || url.startsWith('/') || url.startsWith('./') || url.startsWith('../')) {
+        const localPath = url.startsWith('file://') ? url.slice(7) : url;
+        return {
+            owner: 'local',
+            repo: 'local',
+            path: '',
+            ref: 'local',
+            isLocal: true,
+            localPath: path.resolve(localPath),
+        };
+    }
+    // Handle github: shorthand
+    if (url.startsWith('github:')) {
+        const parts = url.slice(7).split('/');
+        if (parts.length < 2)
+            return null;
+        const [owner, repo, ...pathParts] = parts;
+        return {
+            owner,
+            repo,
+            path: pathParts.join('/') || '',
+            ref: 'main',
+        };
+    }
+    // Handle full GitHub URLs
+    const match = url.match(/github\.com\/([^/]+)\/([^/]+)(?:\/tree\/([^/]+))?(?:\/(.*))?/);
+    if (!match)
+        return null;
+    const [, owner, repo, ref = 'main', pathStr = ''] = match;
+    return { owner, repo, path: pathStr, ref };
+}
+/**
+ * Build a raw GitHub URL for fetching file content
+ */
+export function buildRawUrl(source, filePath) {
+    const fullPath = source.path ? `${source.path}/${filePath}` : filePath;
+    return `https://raw.githubusercontent.com/${source.owner}/${source.repo}/${source.ref}/${fullPath}`;
+}
+/**
+ * Fetch a file from GitHub or local filesystem
+ */
+export async function fetchFromGitHub(source, filePath) {
+    // Handle local files
+    if (source.isLocal && source.localPath) {
+        const fullPath = path.join(source.localPath, filePath);
+        try {
+            return await fs.readFile(fullPath, 'utf-8');
+        }
+        catch (error) {
+            throw new Error(`Failed to read local file ${fullPath}: ${error.message}`);
+        }
+    }
+    // Handle remote files
+    const url = buildRawUrl(source, filePath);
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);
+    }
+    return response.text();
+}
+/**
+ * Fetch the registry.json from a GitHub repository
+ */
+export async function fetchRegistry(source) {
+    return fetchFromGitHub(source, 'registry.json');
+}
+/**
+ * Fetch a skill file from a GitHub repository
+ */
+export async function fetchSkillFile(source, skillPath) {
+    return fetchFromGitHub(source, skillPath);
+}
+//# sourceMappingURL=github.js.map

package/dist/core/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/core/github.ts"],"names":[],"mappings":"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"}

package/dist/core/index.d.ts

@@ -0,0 +1,5 @@
+export * from './github.js';
+export * from './registry.js';
+export * from './installer.js';
+export * from './validator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,5 @@
+export * from './github.js';
+export * from './registry.js';
+export * from './installer.js';
+export * from './validator.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist/core/installer.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Skill installation management
+ */
+import type { InstalledSkill, RegistrySkill, SkillsConfig, Skill } from '../types/index.js';
+import { type GitHubSource } from './github.js';
+/**
+ * Get the .agent directory path (project-local, new format)
+ */
+export declare function getAgentDir(projectDir?: string): string;
+/**
+ * Get the ~/.agents directory path (Claude Code global skills)
+ */
+export declare function getClaudeAgentsDir(): string;
+/**
+ * Get the ~/.agents/skills directory path
+ */
+export declare function getClaudeSkillsDir(): string;
+/**
+ * Get the ~/.claude directory path
+ */
+export declare function getClaudeDir(): string;
+/**
+ * Get the ~/.claude/skills directory path (symlinks)
+ */
+export declare function getClaudeSymlinksDir(): string;
+/**
+ * Get the ~/.agents/.skill-lock.json path
+ */
+export declare function getClaudeLockFilePath(): string;
+/**
+ * Get the skills directory within .agent
+ */
+export declare function getSkillsDir(projectDir?: string): string;
+/**
+ * Convert a UASP skill to Claude Code SKILL.md format
+ */
+export declare function convertToSkillMd(skill: Skill, registrySkill: RegistrySkill): string;
+/**
+ * Get the settings.json path
+ */
+export declare function getSettingsPath(projectDir?: string): string;
+/**
+ * Load or create settings.json
+ */
+export declare function loadSettings(projectDir?: string): Promise<SkillsConfig>;
+/**
+ * Save settings.json
+ */
+export declare function saveSettings(config: SkillsConfig, projectDir?: string): Promise<void>;
+/**
+ * Initialize .agent directory structure
+ */
+export declare function initAgentDir(projectDir?: string): Promise<void>;
+export interface InstallResult {
+    success: boolean;
+    skill?: InstalledSkill;
+    error?: string;
+    claudeCodeInstalled?: boolean;
+}
+export interface InstallOptions {
+    projectDir?: string;
+    claudeCode?: boolean;
+}
+/**
+ * Install a skill from a GitHub registry
+ *
+ * Installs to:
+ * 1. .agent/skills/ (project-local, UASP format)
+ * 2. ~/.agents/skills/ (Claude Code compatible, SKILL.md format) - if claudeCode option is true
+ */
+export declare function installSkill(source: GitHubSource, registrySkill: RegistrySkill, options?: InstallOptions): Promise<InstallResult>;
+export interface RemoveOptions {
+    projectDir?: string;
+    claudeCode?: boolean;
+}
+/**
+ * Remove an installed skill
+ *
+ * Removes from:
+ * 1. .agent/skills/ (project-local)
+ * 2. ~/.agents/skills/ (Claude Code) - if claudeCode option is true
+ */
+export declare function removeSkill(skillName: string, options?: RemoveOptions): Promise<boolean>;
+/**
+ * List installed skills
+ */
+export declare function listInstalledSkills(projectDir?: string): Promise<InstalledSkill[]>;
+//# sourceMappingURL=installer.d.ts.map

package/dist/core/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/core/installer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhE;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,GAAE,MAAsB,GAAG,MAAM,CAEtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,GAAE,MAAsB,GAAG,MAAM,CAEvE;AAmDD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,GAAG,MAAM,CA4KnF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,GAAE,MAAsB,GAAG,MAAM,CAE1E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,UAAU,GAAE,MAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAmB5F;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,YAAY,EACpB,UAAU,GAAE,MAAsB,GACjC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,UAAU,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBpF;AAkFD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,YAAY,EACpB,aAAa,EAAE,aAAa,EAC5B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAsGxB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,OAAO,CAAC,CA6ClB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,GAAE,MAAsB,GACjC,OAAO,CAAC,cAAc,EAAE,CAAC,CAG3B"}