skillpkg-core 0.1.0

package/dist/store/registry.js

@@ -0,0 +1,105 @@
+/**
+ * Registry manifest management (registry.json)
+ */
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { dirname } from 'path';
+import { getRegistryPath } from './paths.js';
+/**
+ * Default empty registry
+ */
+export function createEmptyRegistry() {
+    return {
+        version: '1.0',
+        skills: {},
+        lastUpdated: new Date().toISOString(),
+    };
+}
+/**
+ * Load registry from disk
+ */
+export async function loadRegistry(storeDir) {
+    const registryPath = getRegistryPath(storeDir);
+    if (!existsSync(registryPath)) {
+        return createEmptyRegistry();
+    }
+    try {
+        const content = await readFile(registryPath, 'utf-8');
+        const registry = JSON.parse(content);
+        // Validate basic structure
+        if (!registry.version || !registry.skills) {
+            return createEmptyRegistry();
+        }
+        return registry;
+    }
+    catch {
+        // If file is corrupted, return empty registry
+        return createEmptyRegistry();
+    }
+}
+/**
+ * Save registry to disk (atomic write)
+ */
+export async function saveRegistry(storeDir, registry) {
+    const registryPath = getRegistryPath(storeDir);
+    // Ensure directory exists
+    await mkdir(dirname(registryPath), { recursive: true });
+    // Update timestamp
+    registry.lastUpdated = new Date().toISOString();
+    // Write atomically by writing to temp file first
+    const tempPath = `${registryPath}.tmp`;
+    const content = JSON.stringify(registry, null, 2);
+    await writeFile(tempPath, content, 'utf-8');
+    // Rename temp to actual (atomic on most filesystems)
+    const { rename } = await import('fs/promises');
+    await rename(tempPath, registryPath);
+}
+/**
+ * Add or update a skill entry in the registry
+ */
+export async function addSkillToRegistry(storeDir, skillName, entry) {
+    const registry = await loadRegistry(storeDir);
+    registry.skills[skillName] = {
+        name: skillName,
+        ...entry,
+    };
+    await saveRegistry(storeDir, registry);
+}
+/**
+ * Remove a skill from the registry
+ */
+export async function removeSkillFromRegistry(storeDir, skillName) {
+    const registry = await loadRegistry(storeDir);
+    if (!registry.skills[skillName]) {
+        return false;
+    }
+    delete registry.skills[skillName];
+    await saveRegistry(storeDir, registry);
+    return true;
+}
+/**
+ * Get a skill entry from the registry
+ */
+export async function getSkillFromRegistry(storeDir, skillName) {
+    const registry = await loadRegistry(storeDir);
+    return registry.skills[skillName] || null;
+}
+/**
+ * List all skills in the registry
+ */
+export async function listSkillsInRegistry(storeDir) {
+    const registry = await loadRegistry(storeDir);
+    return Object.values(registry.skills);
+}
+/**
+ * Update synced platforms for a skill
+ */
+export async function updateSyncedPlatforms(storeDir, skillName, platforms) {
+    const registry = await loadRegistry(storeDir);
+    if (registry.skills[skillName]) {
+        registry.skills[skillName].syncedPlatforms = platforms;
+        registry.skills[skillName].lastSynced = new Date().toISOString();
+        await saveRegistry(storeDir, registry);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/store/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/store/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,EAAE;QACV,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,YAAY,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,mBAAmB,EAAE,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAa,CAAC;QAEjD,2BAA2B;QAC3B,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC1C,OAAO,mBAAmB,EAAE,CAAC;QAC/B,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;QAC9C,OAAO,mBAAmB,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB,EAAE,QAAkB;IACrE,MAAM,YAAY,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAE/C,0BAA0B;IAC1B,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExD,mBAAmB;IACnB,QAAQ,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEhD,iDAAiD;IACjD,MAAM,QAAQ,GAAG,GAAG,YAAY,MAAM,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAElD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAE5C,qDAAqD;IACrD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,SAAiB,EACjB,KAA+B;IAE/B,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAE9C,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG;QAC3B,IAAI,EAAE,SAAS;QACf,GAAG,KAAK;KACT,CAAC;IAEF,MAAM,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,QAAgB,EAAE,SAAiB;IAC/E,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAE9C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEvC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAgB,EAChB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,QAAgB;IACzD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAgB,EAChB,SAAiB,EACjB,SAAmB;IAEnB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAE9C,IAAI,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,eAAe,GAAG,SAAS,CAAC;QACvD,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACjE,MAAM,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Core types for skillpkg
+ */
+/**
+ * Skill schema version
+ */
+export declare const SCHEMA_VERSION = "1.0";
+/**
+ * Skill author information
+ */
+export interface Author {
+    name: string;
+    email?: string;
+    url?: string;
+}
+/**
+ * Capability types that a skill can require
+ */
+export type Capability = 'file:read' | 'file:write' | 'shell:execute' | 'web:search' | 'web:fetch' | 'mcp:*';
+/**
+ * Claude Code specific configuration
+ */
+export interface ClaudeCodeConfig {
+    'allowed-tools'?: string[];
+}
+/**
+ * Codex (OpenAI) specific configuration
+ */
+export interface CodexConfig {
+    sandbox?: boolean;
+}
+/**
+ * GitHub Copilot specific configuration
+ */
+export interface CopilotConfig {
+    mode?: 'edit' | 'chat';
+}
+/**
+ * Cline specific configuration
+ */
+export interface ClineConfig {
+    /** Custom rules file path */
+    customRules?: string;
+}
+/**
+ * Platform-specific configurations
+ */
+export interface PlatformConfig {
+    'claude-code'?: ClaudeCodeConfig;
+    codex?: CodexConfig;
+    copilot?: CopilotConfig;
+    cline?: ClineConfig;
+}
+/**
+ * Main Skill interface - represents a skill.yaml
+ */
+export interface Skill {
+    /** Schema version (e.g., "1.0") */
+    schema: string;
+    /** Unique skill identifier in kebab-case */
+    name: string;
+    /** Semantic version (e.g., "1.0.0") */
+    version: string;
+    /** Short description of the skill */
+    description: string;
+    /** Markdown instructions for the AI agent */
+    instructions: string;
+    /** Author information */
+    author?: string | Author;
+    /** License (e.g., "MIT") */
+    license?: string;
+    /** Repository URL */
+    repository?: string;
+    /** Keywords for search */
+    keywords?: string[];
+    /** Trigger words to activate the skill */
+    triggers?: string[];
+    /** Required capabilities */
+    capabilities?: Capability[];
+    /** Platform-specific configurations */
+    platforms?: PlatformConfig;
+    /** Skill dependencies */
+    dependencies?: Record<string, string>;
+}
+/**
+ * Skill entry in local registry
+ */
+export interface SkillEntry {
+    name: string;
+    version: string;
+    installedAt: string;
+    source: 'registry' | 'local' | 'import';
+    sourceUrl?: string;
+    syncedPlatforms: string[];
+    lastSynced?: string;
+}
+/**
+ * Local registry manifest
+ */
+export interface Registry {
+    version: string;
+    skills: Record<string, SkillEntry>;
+    lastUpdated: string;
+}
+/**
+ * Registry configuration
+ */
+export interface RegistryConfig {
+    url: string;
+    token?: string;
+    scope?: string;
+}
+/**
+ * Global configuration
+ */
+export interface Config {
+    registry: string;
+    registries: Record<string, RegistryConfig>;
+    defaultPlatforms: string[];
+    autoSync: boolean;
+    ui: {
+        port: number;
+        openBrowser: boolean;
+    };
+    mcp: {
+        enabled: boolean;
+        port: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Core types for skillpkg
+ */
+/**
+ * Skill schema version
+ */
+export const SCHEMA_VERSION = '1.0';
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "skillpkg-core",
+  "version": "0.1.0",
+  "description": "Core library for skillpkg - Agent Skills Package Manager",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "skills",
+    "ai",
+    "agent",
+    "claude",
+    "copilot",
+    "codex",
+    "llm",
+    "package-manager"
+  ],
+  "author": "miles990",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/miles990/skillpkg.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/miles990/skillpkg#readme",
+  "bugs": {
+    "url": "https://github.com/miles990/skillpkg/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/tar-stream": "^3.1.4",
+    "typescript": "^5.3.0"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "tar-stream": "^3.1.7",
+    "yaml": "^2.8.2"
+  }
+}