cc-recommender 0.1.0

package/dist/config/constants.d.ts

@@ -0,0 +1,18 @@
+/**
+ * General Constants
+ *
+ * Application-wide constants and configuration values
+ */
+/** File scanning configuration */
+export declare const FILE_SCAN_CONFIG: {
+    readonly maxDepth: 5;
+    readonly maxFiles: 1000;
+};
+/** Directories to skip during file scanning */
+export declare const SKIP_DIRECTORIES: readonly ["node_modules", ".git", "dist", "build", ".next", ".nuxt", "coverage", ".cache", ".vscode", ".idea", "__pycache__", "venv", ".venv", "target", "vendor"];
+/** Application metadata */
+export declare const APP_METADATA: {
+    readonly name: "cc-recommender";
+    readonly version: "0.1.0";
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/config/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kCAAkC;AAClC,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AAEX,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,oKAgBnB,CAAC;AAEX,2BAA2B;AAC3B,eAAO,MAAM,YAAY;;;CAGf,CAAC"}

package/dist/config/constants.js

@@ -0,0 +1,34 @@
+/**
+ * General Constants
+ *
+ * Application-wide constants and configuration values
+ */
+/** File scanning configuration */
+export const FILE_SCAN_CONFIG = {
+    maxDepth: 5, // Maximum recursion depth for directory scanning
+    maxFiles: 1000, // Maximum number of files to scan
+};
+/** Directories to skip during file scanning */
+export const SKIP_DIRECTORIES = [
+    "node_modules",
+    ".git",
+    "dist",
+    "build",
+    ".next",
+    ".nuxt",
+    "coverage",
+    ".cache",
+    ".vscode",
+    ".idea",
+    "__pycache__",
+    "venv",
+    ".venv",
+    "target", // Rust
+    "vendor", // PHP/Go
+];
+/** Application metadata */
+export const APP_METADATA = {
+    name: "cc-recommender",
+    version: "0.1.0",
+};
+//# sourceMappingURL=constants.js.map

package/dist/config/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kCAAkC;AAClC,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAE,CAAC,EAAE,iDAAiD;IAC9D,QAAQ,EAAE,IAAI,EAAE,kCAAkC;CAC1C,CAAC;AAEX,+CAA+C;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,cAAc;IACd,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,UAAU;IACV,QAAQ;IACR,SAAS;IACT,OAAO;IACP,aAAa;IACb,MAAM;IACN,OAAO;IACP,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE,SAAS;CACX,CAAC;AAEX,2BAA2B;AAC3B,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,OAAO;CACR,CAAC"}

package/dist/config/file-mappings.d.ts

@@ -0,0 +1,13 @@
+/**
+ * File Mappings Configuration
+ *
+ * Mappings between files/extensions and their corresponding languages/frameworks
+ */
+/** Common config files and their frameworks/languages */
+export declare const CONFIG_FILE_MAPPINGS: Record<string, {
+    framework?: string;
+    language?: string;
+}>;
+/** Extension to language mappings */
+export declare const EXTENSION_TO_LANGUAGE: Record<string, string>;
+//# sourceMappingURL=file-mappings.d.ts.map

package/dist/config/file-mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-mappings.d.ts","sourceRoot":"","sources":["../../src/config/file-mappings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAsC1F,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsBxD,CAAC"}

package/dist/config/file-mappings.js

@@ -0,0 +1,70 @@
+/**
+ * File Mappings Configuration
+ *
+ * Mappings between files/extensions and their corresponding languages/frameworks
+ */
+/** Common config files and their frameworks/languages */
+export const CONFIG_FILE_MAPPINGS = {
+    "package.json": { language: "javascript" },
+    "tsconfig.json": { language: "typescript" },
+    "next.config.js": { framework: "nextjs" },
+    "next.config.mjs": { framework: "nextjs" },
+    "next.config.ts": { framework: "nextjs" },
+    "nuxt.config.ts": { framework: "nuxt" },
+    "nuxt.config.js": { framework: "nuxt" },
+    "vite.config.ts": { framework: "vite" },
+    "vite.config.js": { framework: "vite" },
+    "svelte.config.js": { framework: "svelte" },
+    "angular.json": { framework: "angular" },
+    "vue.config.js": { framework: "vue" },
+    "remix.config.js": { framework: "remix" },
+    "astro.config.mjs": { framework: "astro" },
+    "requirements.txt": { language: "python" },
+    "pyproject.toml": { language: "python" },
+    "setup.py": { language: "python" },
+    "Cargo.toml": { language: "rust" },
+    "go.mod": { language: "go" },
+    Gemfile: { language: "ruby" },
+    "composer.json": { language: "php" },
+    "pom.xml": { language: "java" },
+    "build.gradle": { language: "java" },
+    "build.gradle.kts": { language: "kotlin" },
+    ".csproj": { language: "csharp" },
+    Dockerfile: { framework: "docker" },
+    "docker-compose.yml": { framework: "docker" },
+    "docker-compose.yaml": { framework: "docker" },
+    "kubernetes.yml": { framework: "kubernetes" },
+    "k8s.yml": { framework: "kubernetes" },
+    ".github/workflows": { framework: "github-actions" },
+    "vercel.json": { framework: "vercel" },
+    "netlify.toml": { framework: "netlify" },
+    "prisma/schema.prisma": { framework: "prisma" },
+    "drizzle.config.ts": { framework: "drizzle" },
+    "CLAUDE.md": { framework: "claude-code" },
+    ".claude": { framework: "claude-code" },
+};
+/** Extension to language mappings */
+export const EXTENSION_TO_LANGUAGE = {
+    ".ts": "typescript",
+    ".tsx": "typescript",
+    ".js": "javascript",
+    ".jsx": "javascript",
+    ".mjs": "javascript",
+    ".cjs": "javascript",
+    ".py": "python",
+    ".rs": "rust",
+    ".go": "go",
+    ".rb": "ruby",
+    ".php": "php",
+    ".java": "java",
+    ".kt": "kotlin",
+    ".kts": "kotlin",
+    ".cs": "csharp",
+    ".swift": "swift",
+    ".lua": "lua",
+    ".c": "c",
+    ".cpp": "cpp",
+    ".h": "c",
+    ".hpp": "cpp",
+};
+//# sourceMappingURL=file-mappings.js.map

package/dist/config/file-mappings.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Configuration Exports
+ *
+ * Central export point for all configuration values
+ */
+export { APP_METADATA, FILE_SCAN_CONFIG, SKIP_DIRECTORIES, } from "./constants.js";
+export { CONFIG_FILE_MAPPINGS, EXTENSION_TO_LANGUAGE, } from "./file-mappings.js";
+export { SCORING_MULTIPLIERS, SCORING_THRESHOLDS, SCORING_WEIGHTS, } from "./scoring-config.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,qBAAqB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,9 @@
+/**
+ * Configuration Exports
+ *
+ * Central export point for all configuration values
+ */
+export { APP_METADATA, FILE_SCAN_CONFIG, SKIP_DIRECTORIES, } from "./constants.js";
+export { CONFIG_FILE_MAPPINGS, EXTENSION_TO_LANGUAGE, } from "./file-mappings.js";
+export { SCORING_MULTIPLIERS, SCORING_THRESHOLDS, SCORING_WEIGHTS, } from "./scoring-config.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,qBAAqB,CAAC"}

package/dist/config/scoring-config.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Scoring Configuration
+ *
+ * Weights and multipliers for recommendation scoring algorithm
+ */
+/** Score weights for different match types */
+export declare const SCORING_WEIGHTS: {
+    readonly language: 5;
+    readonly framework: 4;
+    readonly dependency: 3;
+    readonly file: 2;
+    readonly keyword: 1;
+};
+/** Score multipliers for quality indicators */
+export declare const SCORING_MULTIPLIERS: {
+    readonly official: 1.3;
+    readonly highSecurity: 1.1;
+    readonly lowSecurity: 0.7;
+};
+/** Scoring thresholds */
+export declare const SCORING_THRESHOLDS: {
+    readonly minScore: 1;
+    readonly maxResults: 20;
+    readonly highSecurityThreshold: 80;
+    readonly lowSecurityThreshold: 50;
+};
+//# sourceMappingURL=scoring-config.d.ts.map

package/dist/config/scoring-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-config.d.ts","sourceRoot":"","sources":["../../src/config/scoring-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8CAA8C;AAC9C,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAEX,+CAA+C;AAC/C,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX,yBAAyB;AACzB,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC"}

package/dist/config/scoring-config.js

@@ -0,0 +1,27 @@
+/**
+ * Scoring Configuration
+ *
+ * Weights and multipliers for recommendation scoring algorithm
+ */
+/** Score weights for different match types */
+export const SCORING_WEIGHTS = {
+    language: 5, // Language match is very important
+    framework: 4, // Framework match is important
+    dependency: 3, // Direct dependency match
+    file: 2, // File pattern match
+    keyword: 1, // Keyword/tag match
+};
+/** Score multipliers for quality indicators */
+export const SCORING_MULTIPLIERS = {
+    official: 1.3, // Official items get a boost
+    highSecurity: 1.1, // Security score > 80
+    lowSecurity: 0.7, // Security score < 50
+};
+/** Scoring thresholds */
+export const SCORING_THRESHOLDS = {
+    minScore: 1,
+    maxResults: 20,
+    highSecurityThreshold: 80,
+    lowSecurityThreshold: 50,
+};
+//# sourceMappingURL=scoring-config.js.map

package/dist/config/scoring-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-config.js","sourceRoot":"","sources":["../../src/config/scoring-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8CAA8C;AAC9C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ,EAAE,CAAC,EAAE,mCAAmC;IAChD,SAAS,EAAE,CAAC,EAAE,+BAA+B;IAC7C,UAAU,EAAE,CAAC,EAAE,0BAA0B;IACzC,IAAI,EAAE,CAAC,EAAE,qBAAqB;IAC9B,OAAO,EAAE,CAAC,EAAE,oBAAoB;CACxB,CAAC;AAEX,+CAA+C;AAC/C,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,GAAG,EAAE,6BAA6B;IAC5C,YAAY,EAAE,GAAG,EAAE,sBAAsB;IACzC,WAAW,EAAE,GAAG,EAAE,sBAAsB;CAChC,CAAC;AAEX,yBAAyB;AACzB,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,EAAE;IACd,qBAAqB,EAAE,EAAE;IACzB,oBAAoB,EAAE,EAAE;CAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * cc-recommender MCP Server
+ *
+ * Recommends Claude Code skills, plugins, and MCP servers
+ * based on project analysis
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * cc-recommender MCP Server
+ *
+ * Recommends Claude Code skills, plugins, and MCP servers
+ * based on project analysis
+ */
+import { recommendationRepository } from "./repositories/recommendation.repository.js";
+import { createMcpServer } from "./server/mcp-server.js";
+/**
+ * Main entry point
+ */
+async function main() {
+    // Load database
+    const database = await recommendationRepository.load();
+    console.error(`Loaded ${database.items.length} recommendations`);
+    // Create and start MCP server
+    await createMcpServer(database);
+}
+// Run
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,gBAAgB;IAChB,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC,IAAI,EAAE,CAAC;IACvD,OAAO,CAAC,KAAK,CAAC,UAAU,QAAQ,CAAC,KAAK,CAAC,MAAM,kBAAkB,CAAC,CAAC;IAEjE,8BAA8B;IAC9B,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,MAAM;AACN,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/repositories/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Repository Exports
+ *
+ * Central export point for all repository classes
+ */
+export { RecommendationRepository, recommendationRepository, } from "./recommendation.repository.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repositories/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,gCAAgC,CAAC"}

package/dist/repositories/index.js

@@ -0,0 +1,7 @@
+/**
+ * Repository Exports
+ *
+ * Central export point for all repository classes
+ */
+export { RecommendationRepository, recommendationRepository, } from "./recommendation.repository.js";
+//# sourceMappingURL=index.js.map

package/dist/repositories/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/repositories/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,gCAAgC,CAAC"}

package/dist/repositories/recommendation.repository.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Recommendation Repository
+ *
+ * Handles data access for recommendations database
+ */
+import type { RecommendationDatabase } from "../types/domain-types.js";
+/**
+ * Repository for managing recommendation data
+ */
+export declare class RecommendationRepository {
+    private pluginsPath;
+    private mcpServersPath;
+    private skillsPath;
+    private cache;
+    private cacheTimestamp;
+    private readonly CACHE_TTL;
+    constructor(dataDir?: string);
+    /**
+     * Load the recommendations database
+     *
+     * Strategy:
+     * 1. Return cached database if available and not expired
+     * 2. Try to fetch from remote (GitHub) if enabled
+     * 3. Fallback to bundled data (load 3 files in parallel)
+     */
+    load(): Promise<RecommendationDatabase>;
+    /**
+     * Load plugins from bundled data
+     */
+    private loadPlugins;
+    /**
+     * Load MCP servers from bundled data
+     */
+    private loadMCPServers;
+    /**
+     * Load skills from bundled data
+     */
+    private loadSkills;
+    /**
+     * Reload the database (clears cache)
+     */
+    reload(): Promise<RecommendationDatabase>;
+    /**
+     * Get the current cached database without loading
+     */
+    getCached(): RecommendationDatabase | null;
+    /**
+     * Clear the cache
+     */
+    clearCache(): void;
+}
+/**
+ * Default repository instance
+ */
+export declare const recommendationRepository: RecommendationRepository;
+//# sourceMappingURL=recommendation.repository.d.ts.map

package/dist/repositories/recommendation.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendation.repository.d.ts","sourceRoot":"","sources":["../../src/repositories/recommendation.repository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAGV,sBAAsB,EAEvB,MAAM,0BAA0B,CAAC;AAGlC;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;gBAEzB,OAAO,CAAC,EAAE,MAAM;IAgB5B;;;;;;;OAOG;IACG,IAAI,IAAI,OAAO,CAAC,sBAAsB,CAAC;IA+D7C;;OAEG;YACW,WAAW;IAKzB;;OAEG;YACW,cAAc;IAK5B;;OAEG;YACW,UAAU;IAKxB;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAK/C;;OAEG;IACH,SAAS,IAAI,sBAAsB,GAAG,IAAI;IAI1C;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,0BAAiC,CAAC"}

package/dist/repositories/recommendation.repository.js

@@ -0,0 +1,142 @@
+/**
+ * Recommendation Repository
+ *
+ * Handles data access for recommendations database
+ */
+import { readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { fetchRemoteData, isRemoteDataEnabled } from "./remote-data.repository.js";
+/**
+ * Repository for managing recommendation data
+ */
+export class RecommendationRepository {
+    pluginsPath;
+    mcpServersPath;
+    skillsPath;
+    cache = null;
+    cacheTimestamp = 0;
+    CACHE_TTL = 3600000; // 1 hour in milliseconds
+    constructor(dataDir) {
+        if (dataDir) {
+            this.pluginsPath = join(dataDir, "plugins.json");
+            this.mcpServersPath = join(dataDir, "mcp-servers.json");
+            this.skillsPath = join(dataDir, "skills.json");
+        }
+        else {
+            // Default paths: ../data/*.json relative to this file
+            const __filename = fileURLToPath(import.meta.url);
+            const __dirname = dirname(__filename);
+            const defaultDataDir = join(__dirname, "..", "..", "data");
+            this.pluginsPath = join(defaultDataDir, "plugins.json");
+            this.mcpServersPath = join(defaultDataDir, "mcp-servers.json");
+            this.skillsPath = join(defaultDataDir, "skills.json");
+        }
+    }
+    /**
+     * Load the recommendations database
+     *
+     * Strategy:
+     * 1. Return cached database if available and not expired
+     * 2. Try to fetch from remote (GitHub) if enabled
+     * 3. Fallback to bundled data (load 3 files in parallel)
+     */
+    async load() {
+        const now = Date.now();
+        // Return cached database if available and not expired
+        if (this.cache && now - this.cacheTimestamp < this.CACHE_TTL) {
+            return this.cache;
+        }
+        // Cache expired or not available - clear it
+        if (this.cache) {
+            console.error("🔄 Cache expired, refreshing data...");
+            this.cache = null;
+        }
+        // Try remote data first (if enabled)
+        if (isRemoteDataEnabled()) {
+            const remoteData = await fetchRemoteData();
+            if (remoteData) {
+                this.cache = remoteData;
+                this.cacheTimestamp = Date.now();
+                return remoteData;
+            }
+            console.error("⚠️  Falling back to bundled data");
+        }
+        // Fallback to bundled data (load 3 files in parallel)
+        try {
+            const [pluginsDb, mcpServersDb, skillsDb] = await Promise.all([
+                this.loadPlugins(),
+                this.loadMCPServers(),
+                this.loadSkills(),
+            ]);
+            // Merge databases
+            const database = {
+                version: pluginsDb.version,
+                lastUpdated: pluginsDb.lastUpdated,
+                items: [...pluginsDb.items, ...mcpServersDb.items, ...skillsDb.items],
+            };
+            this.cache = database;
+            this.cacheTimestamp = Date.now();
+            console.error(`📦 Loaded ${database.items.length} recommendations from bundled data (${database.version})`);
+            console.error(`   - Plugins: ${pluginsDb.items.length}, MCP: ${mcpServersDb.items.length}, Skills: ${skillsDb.items.length}`);
+            return database;
+        }
+        catch (error) {
+            console.error("Failed to load database:", error);
+            // Return empty database
+            const emptyDatabase = {
+                version: "0.0.0",
+                lastUpdated: new Date().toISOString(),
+                items: [],
+            };
+            this.cache = emptyDatabase;
+            this.cacheTimestamp = Date.now();
+            return emptyDatabase;
+        }
+    }
+    /**
+     * Load plugins from bundled data
+     */
+    async loadPlugins() {
+        const content = await readFile(this.pluginsPath, "utf-8");
+        return JSON.parse(content);
+    }
+    /**
+     * Load MCP servers from bundled data
+     */
+    async loadMCPServers() {
+        const content = await readFile(this.mcpServersPath, "utf-8");
+        return JSON.parse(content);
+    }
+    /**
+     * Load skills from bundled data
+     */
+    async loadSkills() {
+        const content = await readFile(this.skillsPath, "utf-8");
+        return JSON.parse(content);
+    }
+    /**
+     * Reload the database (clears cache)
+     */
+    async reload() {
+        this.cache = null;
+        return this.load();
+    }
+    /**
+     * Get the current cached database without loading
+     */
+    getCached() {
+        return this.cache;
+    }
+    /**
+     * Clear the cache
+     */
+    clearCache() {
+        this.cache = null;
+    }
+}
+/**
+ * Default repository instance
+ */
+export const recommendationRepository = new RecommendationRepository();
+//# sourceMappingURL=recommendation.repository.js.map

package/dist/repositories/recommendation.repository.js.map

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

package/dist/repositories/remote-data.repository.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Remote Data Repository
+ *
+ * Fetches latest recommendations data from CDN/GitHub
+ */
+import type { RecommendationDatabase } from "../types/index.js";
+/**
+ * リモートからレコメンデーションデータを取得
+ *
+ * @param remoteUrl - リモートデータのURL（省略時はデフォルト）
+ * @returns データベース or null（失敗時）
+ */
+export declare function fetchRemoteData(remoteUrl?: string): Promise<RecommendationDatabase | null>;
+/**
+ * リモートデータ取得が有効かチェック
+ *
+ * @returns 有効ならtrue
+ */
+export declare function isRemoteDataEnabled(): boolean;
+//# sourceMappingURL=remote-data.repository.d.ts.map

package/dist/repositories/remote-data.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-data.repository.d.ts","sourceRoot":"","sources":["../../src/repositories/remote-data.repository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAGV,sBAAsB,EAEvB,MAAM,mBAAmB,CAAC;AAyB3B;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CA2ChG;AAiSD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAG7C"}