@open-skills-hub/core 1.0.0

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@open-skills-hub/core",
+  "version": "1.0.0",
+  "description": "Core library for Open Skills Hub",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./config": {
+      "import": "./dist/config/index.js",
+      "types": "./dist/config/index.d.ts"
+    },
+    "./storage": {
+      "import": "./dist/storage/index.js",
+      "types": "./dist/storage/index.d.ts"
+    },
+    "./models": {
+      "import": "./dist/models/index.js",
+      "types": "./dist/models/index.d.ts"
+    },
+    "./scanner": {
+      "import": "./dist/scanner/index.js",
+      "types": "./dist/scanner/index.d.ts"
+    },
+    "./search": {
+      "import": "./dist/search/index.js",
+      "types": "./dist/search/index.d.ts"
+    },
+    "./utils": {
+      "import": "./dist/utils/index.js",
+      "types": "./dist/utils/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@skills-guard/core": "^0.2.0",
+    "date-fns": "^3.0.6",
+    "nanoid": "^5.0.4",
+    "pino": "^8.17.2",
+    "pino-pretty": "^13.1.3",
+    "sql.js": "^1.10.0",
+    "yaml": "^2.3.4",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/sql.js": "^1.4.9"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OpenSkillsHub/open-skills-hub.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/OpenSkillsHub/open-skills-hub/issues"
+  },
+  "homepage": "https://github.com/OpenSkillsHub/open-skills-hub#readme",
+  "keywords": [
+    "skills",
+    "ai",
+    "agent",
+    "mcp",
+    "registry",
+    "core"
+  ],
+  "author": "Open Skills Hub Team",
+  "license": "MIT"
+}

package/src/config/config.ts

@@ -0,0 +1,420 @@
+/**
+ * Open Skills Hub - Configuration Management
+ */
+
+import { z } from 'zod';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+
+// ============================================================================
+// Configuration Schema
+// ============================================================================
+
+export const StorageMode = z.enum(['local', 'docker', 'cloud']);
+export type StorageMode = z.infer<typeof StorageMode>;
+
+export const AuthMode = z.enum(['local', 'token', 'oauth']);
+export type AuthMode = z.infer<typeof AuthMode>;
+
+export const LogLevel = z.enum(['debug', 'info', 'warn', 'error']);
+export type LogLevel = z.infer<typeof LogLevel>;
+
+export const CacheConfigSchema = z.object({
+  ttl: z.number().default(604800), // 7 days in seconds
+  maxSize: z.number().default(524288000), // 500MB
+  strategy: z.enum(['lru', 'fifo']).default('lru'),
+  autoRefresh: z.boolean().default(true),
+});
+export type CacheConfig = z.infer<typeof CacheConfigSchema>;
+
+export const AuthConfigSchema = z.object({
+  mode: AuthMode.default('local'),
+  requireAuth: z.boolean().default(false),
+  jwtSecret: z.string().optional(),
+  tokenExpiry: z.number().default(86400), // 24 hours
+});
+export type AuthConfig = z.infer<typeof AuthConfigSchema>;
+
+export const ScannerConfigSchema = z.object({
+  enabled: z.boolean().default(true),
+  timeout: z.number().default(30000), // 30 seconds
+  maxFileSize: z.number().default(10485760), // 10MB
+  rulesPath: z.string().optional(),
+});
+export type ScannerConfig = z.infer<typeof ScannerConfigSchema>;
+
+export const RetryConfigSchema = z.object({
+  maxAttempts: z.number().default(5),
+  baseDelay: z.number().default(1000),
+  maxDelay: z.number().default(3600000), // 1 hour
+  backoffMultiplier: z.number().default(2),
+  jitter: z.boolean().default(true),
+  jitterFactor: z.number().default(0.1),
+});
+export type RetryConfig = z.infer<typeof RetryConfigSchema>;
+
+export const ServerConfigSchema = z.object({
+  host: z.string().default('localhost'),
+  port: z.number().default(3000),
+  cors: z.boolean().default(true),
+  trustProxy: z.boolean().default(false),
+});
+export type ServerConfig = z.infer<typeof ServerConfigSchema>;
+
+export const RateLimitConfigSchema = z.object({
+  enabled: z.boolean().default(true),
+  windowMs: z.number().default(60000), // 1 minute
+  max: z.number().default(100),
+});
+export type RateLimitConfig = z.infer<typeof RateLimitConfigSchema>;
+
+export const DatabaseConfigSchema = z.object({
+  url: z.string().optional(),
+  filename: z.string().default('hub.db'),
+  poolSize: z.number().default(10),
+  timeout: z.number().default(5000),
+});
+export type DatabaseConfig = z.infer<typeof DatabaseConfigSchema>;
+
+export const RegistryConfigSchema = z.object({
+  // Storage mode
+  mode: StorageMode.default('local'),
+  storagePath: z.string().default('~/.open-skills-hub'),
+  
+  // API endpoint (for remote mode)
+  apiUrl: z.string().default('https://api.open-skills-hub.io'),
+  apiToken: z.string().optional(),
+  
+  // Sub-configurations
+  server: ServerConfigSchema.default({}),
+  database: DatabaseConfigSchema.default({}),
+  cache: CacheConfigSchema.default({}),
+  auth: AuthConfigSchema.default({}),
+  scanner: ScannerConfigSchema.default({}),
+  retry: RetryConfigSchema.default({}),
+  rateLimit: RateLimitConfigSchema.default({}),
+  
+  // Logging
+  logLevel: LogLevel.default('info'),
+  logFormat: z.enum(['json', 'pretty']).default('json'),
+  
+  // Telemetry
+  telemetryEnabled: z.boolean().default(true),
+});
+export type RegistryConfig = z.infer<typeof RegistryConfigSchema>;
+
+// ============================================================================
+// Configuration Manager
+// ============================================================================
+
+const DEFAULT_CONFIG_FILENAME = 'config.yaml';
+
+export class ConfigManager {
+  private config: RegistryConfig;
+  private configPath: string;
+  private loaded: boolean = false;
+
+  constructor(configPath?: string) {
+    this.configPath = configPath || this.getDefaultConfigPath();
+    this.config = RegistryConfigSchema.parse({});
+  }
+
+  /**
+   * Get the default configuration file path
+   */
+  private getDefaultConfigPath(): string {
+    const storagePath = this.expandPath('~/.open-skills-hub');
+    return path.join(storagePath, DEFAULT_CONFIG_FILENAME);
+  }
+
+  /**
+   * Expand ~ to home directory
+   */
+  private expandPath(p: string): string {
+    if (p.startsWith('~')) {
+      return path.join(os.homedir(), p.slice(1));
+    }
+    return p;
+  }
+
+  /**
+   * Get the resolved storage path
+   */
+  getStoragePath(): string {
+    return this.expandPath(this.config.storagePath);
+  }
+
+  /**
+   * Get database file path
+   */
+  getDatabasePath(): string {
+    return path.join(
+      this.getStoragePath(),
+      'data',
+      this.config.database.filename
+    );
+  }
+
+  /**
+   * Get cache directory path
+   */
+  getCachePath(): string {
+    return path.join(this.getStoragePath(), 'cache');
+  }
+
+  /**
+   * Get local skills directory path
+   */
+  getLocalSkillsPath(): string {
+    return path.join(this.getStoragePath(), 'local');
+  }
+
+  /**
+   * Get logs directory path
+   */
+  getLogsPath(): string {
+    return path.join(this.getStoragePath(), 'logs');
+  }
+
+  /**
+   * Get queue directory path
+   */
+  getQueuePath(): string {
+    return path.join(this.getStoragePath(), 'queue');
+  }
+
+  /**
+   * Load configuration from file
+   */
+  async load(): Promise<RegistryConfig> {
+    if (this.loaded) {
+      return this.config;
+    }
+
+    try {
+      // Check if config file exists
+      if (fs.existsSync(this.configPath)) {
+        const content = fs.readFileSync(this.configPath, 'utf-8');
+        const parsed = parseYaml(content) as Record<string, unknown>;
+        this.config = RegistryConfigSchema.parse(parsed);
+      }
+
+      // Override with environment variables
+      this.applyEnvironmentOverrides();
+
+      // Ensure directories exist
+      await this.ensureDirectories();
+
+      this.loaded = true;
+      return this.config;
+    } catch (error) {
+      throw new Error(`Failed to load configuration: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+
+  /**
+   * Save configuration to file
+   */
+  async save(): Promise<void> {
+    try {
+      const dir = path.dirname(this.configPath);
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+
+      const content = stringifyYaml(this.config, { indent: 2 });
+      fs.writeFileSync(this.configPath, content, 'utf-8');
+    } catch (error) {
+      throw new Error(`Failed to save configuration: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+
+  /**
+   * Apply environment variable overrides
+   */
+  private applyEnvironmentOverrides(): void {
+    const env = process.env;
+
+    // Storage mode
+    if (env['STORAGE_MODE']) {
+      const mode = StorageMode.safeParse(env['STORAGE_MODE']);
+      if (mode.success) {
+        this.config.mode = mode.data;
+      }
+    }
+
+    // Storage path
+    if (env['STORAGE_PATH']) {
+      this.config.storagePath = env['STORAGE_PATH'];
+    }
+
+    // API configuration
+    if (env['SKILLS_REGISTRY_URL']) {
+      this.config.apiUrl = env['SKILLS_REGISTRY_URL'];
+    }
+    if (env['SKILLS_API_TOKEN']) {
+      this.config.apiToken = env['SKILLS_API_TOKEN'];
+    }
+
+    // Server configuration
+    if (env['PORT']) {
+      this.config.server.port = parseInt(env['PORT'], 10);
+    }
+    if (env['HOST']) {
+      this.config.server.host = env['HOST'];
+    }
+
+    // Database URL
+    if (env['DATABASE_URL']) {
+      this.config.database.url = env['DATABASE_URL'];
+    }
+
+    // Cache configuration
+    if (env['CACHE_TTL']) {
+      this.config.cache.ttl = parseInt(env['CACHE_TTL'], 10);
+    }
+    if (env['CACHE_MAX_SIZE']) {
+      this.config.cache.maxSize = parseInt(env['CACHE_MAX_SIZE'], 10);
+    }
+
+    // Auth configuration
+    if (env['AUTH_ENABLED']) {
+      this.config.auth.requireAuth = env['AUTH_ENABLED'] === 'true';
+    }
+    if (env['JWT_SECRET']) {
+      this.config.auth.jwtSecret = env['JWT_SECRET'];
+    }
+
+    // Scanner configuration
+    if (env['SCANNER_ENABLED']) {
+      this.config.scanner.enabled = env['SCANNER_ENABLED'] === 'true';
+    }
+    if (env['SCANNER_TIMEOUT']) {
+      this.config.scanner.timeout = parseInt(env['SCANNER_TIMEOUT'], 10);
+    }
+
+    // Retry configuration
+    if (env['FEEDBACK_QUEUE_MAX_ATTEMPTS']) {
+      this.config.retry.maxAttempts = parseInt(env['FEEDBACK_QUEUE_MAX_ATTEMPTS'], 10);
+    }
+    if (env['FEEDBACK_QUEUE_BASE_DELAY']) {
+      this.config.retry.baseDelay = parseInt(env['FEEDBACK_QUEUE_BASE_DELAY'], 10);
+    }
+    if (env['FEEDBACK_QUEUE_MAX_DELAY']) {
+      this.config.retry.maxDelay = parseInt(env['FEEDBACK_QUEUE_MAX_DELAY'], 10);
+    }
+
+    // Logging
+    if (env['LOG_LEVEL']) {
+      const level = LogLevel.safeParse(env['LOG_LEVEL']);
+      if (level.success) {
+        this.config.logLevel = level.data;
+      }
+    }
+    if (env['LOG_FORMAT']) {
+      if (env['LOG_FORMAT'] === 'json' || env['LOG_FORMAT'] === 'pretty') {
+        this.config.logFormat = env['LOG_FORMAT'];
+      }
+    }
+  }
+
+  /**
+   * Ensure required directories exist
+   */
+  private async ensureDirectories(): Promise<void> {
+    const dirs = [
+      this.getStoragePath(),
+      path.join(this.getStoragePath(), 'data'),
+      this.getCachePath(),
+      this.getLocalSkillsPath(),
+      this.getLogsPath(),
+      this.getQueuePath(),
+    ];
+
+    for (const dir of dirs) {
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+    }
+  }
+
+  /**
+   * Get the current configuration
+   */
+  get(): RegistryConfig {
+    return this.config;
+  }
+
+  /**
+   * Update configuration
+   */
+  set(updates: Partial<RegistryConfig>): void {
+    this.config = RegistryConfigSchema.parse({
+      ...this.config,
+      ...updates,
+    });
+  }
+
+  /**
+   * Get a specific configuration value
+   */
+  getValue<K extends keyof RegistryConfig>(key: K): RegistryConfig[K] {
+    return this.config[key];
+  }
+
+  /**
+   * Set a specific configuration value
+   */
+  setValue<K extends keyof RegistryConfig>(key: K, value: RegistryConfig[K]): void {
+    this.config[key] = value;
+  }
+
+  /**
+   * Check if running in local mode
+   */
+  isLocalMode(): boolean {
+    return this.config.mode === 'local';
+  }
+
+  /**
+   * Check if running in Docker mode
+   */
+  isDockerMode(): boolean {
+    return this.config.mode === 'docker';
+  }
+
+  /**
+   * Check if running in cloud mode
+   */
+  isCloudMode(): boolean {
+    return this.config.mode === 'cloud';
+  }
+
+  /**
+   * Reset to default configuration
+   */
+  reset(): void {
+    this.config = RegistryConfigSchema.parse({});
+    this.loaded = false;
+  }
+}
+
+// ============================================================================
+// Singleton Instance
+// ============================================================================
+
+let configInstance: ConfigManager | null = null;
+
+export function getConfig(): ConfigManager {
+  if (!configInstance) {
+    configInstance = new ConfigManager();
+  }
+  return configInstance;
+}
+
+export function initConfig(configPath?: string): ConfigManager {
+  configInstance = new ConfigManager(configPath);
+  return configInstance;
+}

package/src/config/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Open Skills Hub - Configuration Exports
+ */
+
+export * from './config.js';

package/src/index.ts

@@ -0,0 +1,18 @@
+/**
+ * Open Skills Hub - Core Package Entry
+ */
+
+// Config
+export * from './config/index.js';
+
+// Models
+export * from './models/index.js';
+
+// Storage
+export * from './storage/index.js';
+
+// Scanner
+export * from './scanner/index.js';
+
+// Utils
+export * from './utils/index.js';

package/src/models/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Open Skills Hub - Model Exports
+ */
+
+export * from './types.js';