@planu/cli 0.62.0 → 0.63.0

package/dist/config/ecosystem-sources.json

@@ -0,0 +1,34 @@
+[
+  {
+    "id": "claude-platform",
+    "name": "Claude Platform Docs",
+    "url": "https://platform.claude.com/docs",
+    "type": "docs",
+    "crawlIntervalHours": 24,
+    "enabled": true
+  },
+  {
+    "id": "agentskills-spec",
+    "name": "Agent Skills Specification",
+    "url": "https://agentskills.io/specification",
+    "type": "docs",
+    "crawlIntervalHours": 168,
+    "enabled": true
+  },
+  {
+    "id": "anthropic-skills",
+    "name": "Anthropic Skills Repo",
+    "url": "https://github.com/anthropics/skills",
+    "type": "github",
+    "crawlIntervalHours": 48,
+    "enabled": true
+  },
+  {
+    "id": "mcp-trending",
+    "name": "GitHub MCP Trending",
+    "url": "https://github.com/topics/model-context-protocol",
+    "type": "github",
+    "crawlIntervalHours": 168,
+    "enabled": true
+  }
+]

package/dist/config/license-plans.json

@@ -50,7 +50,9 @@
     "pr_status",
     "registry_search",
     "registry_install",
-    "generate_spec_dashboard"
+    "generate_spec_dashboard",
+    "skill_search",
+    "skill_install"
   ],
   "proTools": [
     "audit",
@@ -152,7 +154,8 @@
     "registry_login",
     "registry_logout",
     "registry_whoami",
-    "scan_project"
+    "scan_project",
+    "ecosystem_status"
   ],
   "alwaysAllowed": [
     "activate_license",

package/dist/config/skill-registries.json

@@ -0,0 +1,26 @@
+[
+  {
+    "id": "anthropic",
+    "name": "Anthropic Official Skills",
+    "url": "https://github.com/anthropics/skills",
+    "type": "github",
+    "priority": 1,
+    "enabled": true
+  },
+  {
+    "id": "agentskill",
+    "name": "AgentSkill.sh",
+    "url": "https://agentskill.sh",
+    "type": "api",
+    "priority": 2,
+    "enabled": true
+  },
+  {
+    "id": "skillssh",
+    "name": "Skills.sh",
+    "url": "https://skills.sh",
+    "type": "npm",
+    "priority": 3,
+    "enabled": true
+  }
+]

package/dist/engine/dynamic-knowledge/context-resolver.d.ts

@@ -0,0 +1,15 @@
+import type { ProjectContext, KnowledgeCategory } from '../../types/index.js';
+/**
+ * Build search queries based on project context and category.
+ * Returns an array of search terms optimized for web search.
+ */
+export declare function buildSearchQueries(category: KnowledgeCategory, context: ProjectContext): string[];
+/**
+ * Determine which categories are relevant for a given project context.
+ */
+export declare function resolveRelevantCategories(context: ProjectContext): KnowledgeCategory[];
+/**
+ * Build a normalized context key for caching.
+ */
+export declare function normalizeContext(context: ProjectContext): Record<string, unknown>;
+//# sourceMappingURL=context-resolver.d.ts.map

package/dist/engine/dynamic-knowledge/context-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-resolver.d.ts","sourceRoot":"","sources":["../../../src/engine/dynamic-knowledge/context-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,EAAE,CA+CjG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,cAAc,GAAG,iBAAiB,EAAE,CAetF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQjF"}

package/dist/engine/dynamic-knowledge/context-resolver.js

@@ -0,0 +1,80 @@
+/**
+ * Build search queries based on project context and category.
+ * Returns an array of search terms optimized for web search.
+ */
+export function buildSearchQueries(category, context) {
+    const year = new Date().getFullYear();
+    const stackStr = context.stack.join(' ');
+    const queryBuilders = {
+        frameworks: () => [
+            `best ${context.target} frameworks ${stackStr} ${year}`,
+            `${stackStr} recommended libraries tools ${year}`,
+            ...(context.appType ? [`best frameworks for ${context.appType} ${year}`] : []),
+        ],
+        security: () => [
+            `OWASP top 10 ${year} ${context.target} security`,
+            `${stackStr} security best practices ${year}`,
+            `${stackStr} common vulnerabilities prevention ${year}`,
+            ...(context.target === 'frontend' ? [`XSS CSRF prevention ${stackStr} ${year}`] : []),
+            ...(context.target === 'backend' ? [`SQL injection API security ${stackStr} ${year}`] : []),
+        ],
+        pricing: () => [
+            `LLM API pricing comparison ${year}`,
+            `Claude OpenAI Gemini pricing per token ${year}`,
+            `AI model costs ${year} latest`,
+        ],
+        tooling: () => [
+            `${stackStr} recommended dev tools ${year}`,
+            `${context.target} tooling ecosystem ${stackStr} ${year}`,
+            ...(context.appType ? [`${context.appType} tooling stack ${year}`] : []),
+        ],
+        patterns: () => [
+            `${context.target} architecture patterns ${year}`,
+            `${stackStr} anti-patterns common bugs ${year}`,
+            `resilience patterns ${context.target} ${year}`,
+            `${stackStr} scalability best practices ${year}`,
+            ...(context.scope === 'architectural' ? [`distributed systems patterns ${year}`] : []),
+        ],
+        compliance: () => [
+            `data privacy regulations ${year}`,
+            `GDPR CCPA compliance requirements ${year}`,
+            `${context.target} data protection checklist ${year}`,
+        ],
+        platforms: () => [
+            `${context.target} deployment platforms comparison ${year}`,
+            `best hosting ${stackStr} ${year}`,
+            `serverless edge deployment ${stackStr} ${year}`,
+        ],
+    };
+    return queryBuilders[category]();
+}
+/**
+ * Determine which categories are relevant for a given project context.
+ */
+export function resolveRelevantCategories(context) {
+    const categories = ['patterns', 'security']; // always relevant
+    if (context.target === 'frontend' || context.target === 'fullstack') {
+        categories.push('frameworks');
+    }
+    if (context.target === 'backend' || context.target === 'fullstack') {
+        categories.push('tooling', 'platforms');
+    }
+    if (context.scope === 'architectural' || context.scope === 'cross-module') {
+        categories.push('compliance');
+    }
+    // Deduplicate
+    return [...new Set(categories)];
+}
+/**
+ * Build a normalized context key for caching.
+ */
+export function normalizeContext(context) {
+    return {
+        stack: [...context.stack].sort(),
+        target: context.target,
+        scope: context.scope,
+        ...(context.appType ? { appType: context.appType } : {}),
+        ...(context.language ? { language: context.language } : {}),
+    };
+}
+//# sourceMappingURL=context-resolver.js.map

package/dist/engine/dynamic-knowledge/context-resolver.js.map

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

package/dist/engine/dynamic-knowledge/index.d.ts

@@ -0,0 +1,7 @@
+export { readCache, writeCache, findCachedEntry, setCacheEntry, pruneCache, getCacheKey, } from './knowledge-cache.js';
+export { buildSearchQueries, resolveRelevantCategories, normalizeContext, } from './context-resolver.js';
+export { searchWeb, fetchKnowledge } from './web-researcher.js';
+export { loadStaticFallback, mergeKnowledge } from './knowledge-merger.js';
+export { filterByContext } from './stack-filter.js';
+export { queryKnowledge, queryMultipleCategories } from './query-knowledge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/dynamic-knowledge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/dynamic-knowledge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,UAAU,EACV,eAAe,EACf,aAAa,EACb,UAAU,EACV,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/engine/dynamic-knowledge/index.js

@@ -0,0 +1,7 @@
+export { readCache, writeCache, findCachedEntry, setCacheEntry, pruneCache, getCacheKey, } from './knowledge-cache.js';
+export { buildSearchQueries, resolveRelevantCategories, normalizeContext, } from './context-resolver.js';
+export { searchWeb, fetchKnowledge } from './web-researcher.js';
+export { loadStaticFallback, mergeKnowledge } from './knowledge-merger.js';
+export { filterByContext } from './stack-filter.js';
+export { queryKnowledge, queryMultipleCategories } from './query-knowledge.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/dynamic-knowledge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/dynamic-knowledge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,UAAU,EACV,eAAe,EACf,aAAa,EACb,UAAU,EACV,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/engine/dynamic-knowledge/knowledge-cache.d.ts

@@ -0,0 +1,8 @@
+import { type KnowledgeCacheStore, type KnowledgeCacheEntry, type KnowledgeCategory, type KnowledgeItem } from '../../types/index.js';
+export declare function readCache(): Promise<KnowledgeCacheStore>;
+export declare function writeCache(store: KnowledgeCacheStore): Promise<void>;
+export declare function getCacheKey(category: KnowledgeCategory, context: Record<string, unknown>): string;
+export declare function findCachedEntry(store: KnowledgeCacheStore, category: KnowledgeCategory, context: Record<string, unknown>): KnowledgeCacheEntry | null;
+export declare function setCacheEntry(category: KnowledgeCategory, context: Record<string, unknown>, items: KnowledgeItem[]): Promise<void>;
+export declare function pruneCache(store: KnowledgeCacheStore): KnowledgeCacheStore;
+//# sourceMappingURL=knowledge-cache.d.ts.map

package/dist/engine/dynamic-knowledge/knowledge-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-cache.d.ts","sourceRoot":"","sources":["../../../src/engine/dynamic-knowledge/knowledge-cache.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AA6B9B,wBAAsB,SAAS,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAO9D;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1E;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEjG;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,mBAAmB,GAAG,IAAI,CAW5B;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,EAAE,aAAa,EAAE,GACrB,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,mBAAmB,GAAG,mBAAmB,CAgB1E"}

package/dist/engine/dynamic-knowledge/knowledge-cache.js

@@ -0,0 +1,90 @@
+// Cache layer for Dynamic Knowledge Engine
+// Reads/writes data/knowledge/cache.json with per-category TTL
+import { CATEGORY_TTL, } from '../../types/index.js';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+const CACHE_DIR = 'data/knowledge';
+const CACHE_FILE = 'cache.json';
+const MAX_ENTRIES = 200;
+const PRUNE_THRESHOLD_DAYS = 30;
+function getCachePath() {
+    return join(process.cwd(), CACHE_DIR, CACHE_FILE);
+}
+function createEmptyStore() {
+    return { version: 1, entries: [], lastPruned: new Date().toISOString() };
+}
+function hashContext(context) {
+    // Simple hash: sorted JSON string -> basic hash
+    const str = JSON.stringify(context, Object.keys(context).sort());
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash |= 0;
+    }
+    return Math.abs(hash).toString(36);
+}
+export async function readCache() {
+    try {
+        const raw = await readFile(getCachePath(), 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return createEmptyStore();
+    }
+}
+export async function writeCache(store) {
+    const path = getCachePath();
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, JSON.stringify(store, null, 2), 'utf-8');
+}
+export function getCacheKey(category, context) {
+    return `${category}:${hashContext(context)}`;
+}
+export function findCachedEntry(store, category, context) {
+    const contextHash = hashContext(context);
+    const entry = store.entries.find((e) => e.category === category && e.context === contextHash);
+    if (!entry) {
+        return null;
+    }
+    // Check TTL
+    if (new Date(entry.expiresAt) < new Date()) {
+        return null;
+    }
+    return entry;
+}
+export async function setCacheEntry(category, context, items) {
+    const store = await readCache();
+    const contextHash = hashContext(context);
+    const ttlHours = CATEGORY_TTL[category];
+    const now = new Date();
+    const expiresAt = new Date(now.getTime() + ttlHours * 60 * 60 * 1000);
+    // Remove existing entry for same category+context
+    store.entries = store.entries.filter((e) => !(e.category === category && e.context === contextHash));
+    store.entries.push({
+        category,
+        context: contextHash,
+        items,
+        fetchedAt: now.toISOString(),
+        expiresAt: expiresAt.toISOString(),
+        ttl: ttlHours,
+    });
+    // Prune old entries
+    const pruned = pruneCache(store);
+    await writeCache(pruned);
+}
+export function pruneCache(store) {
+    const now = new Date();
+    const threshold = new Date(now.getTime() - PRUNE_THRESHOLD_DAYS * 24 * 60 * 60 * 1000);
+    // Remove expired entries older than threshold
+    let entries = store.entries.filter((e) => new Date(e.fetchedAt) > threshold);
+    // Cap at MAX_ENTRIES (keep newest)
+    if (entries.length > MAX_ENTRIES) {
+        entries = entries
+            .slice()
+            .sort((a, b) => new Date(b.fetchedAt).getTime() - new Date(a.fetchedAt).getTime())
+            .slice(0, MAX_ENTRIES);
+    }
+    return { ...store, entries, lastPruned: now.toISOString() };
+}
+//# sourceMappingURL=knowledge-cache.js.map

package/dist/engine/dynamic-knowledge/knowledge-cache.js.map

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

package/dist/engine/dynamic-knowledge/knowledge-merger.d.ts

@@ -0,0 +1,13 @@
+import type { KnowledgeItem, KnowledgeCategory } from '../../types/index.js';
+/**
+ * Load static fallback items from JSON config files.
+ * Converts JSON entries into KnowledgeItem format.
+ */
+export declare function loadStaticFallback(category: KnowledgeCategory): Promise<KnowledgeItem[]>;
+/**
+ * Merge web-fetched items with static fallback items.
+ * Web items take priority. Static items fill gaps.
+ * Deduplicates by title similarity.
+ */
+export declare function mergeKnowledge(webItems: KnowledgeItem[], staticItems: KnowledgeItem[]): KnowledgeItem[];
+//# sourceMappingURL=knowledge-merger.d.ts.map

package/dist/engine/dynamic-knowledge/knowledge-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-merger.d.ts","sourceRoot":"","sources":["../../../src/engine/dynamic-knowledge/knowledge-merger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA0B7E;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAiB9F;AA+ED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,aAAa,EAAE,EACzB,WAAW,EAAE,aAAa,EAAE,GAC3B,aAAa,EAAE,CAwBjB"}

package/dist/engine/dynamic-knowledge/knowledge-merger.js

@@ -0,0 +1,135 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/** Safely convert an unknown value to string, falling back to a default. */
+function toStr(val, fallback) {
+    if (typeof val === 'string') {
+        return val;
+    }
+    if (typeof val === 'number') {
+        return String(val);
+    }
+    return fallback;
+}
+/** Map categories to their static fallback JSON files in src/config/ */
+const STATIC_FALLBACK_MAP = {
+    frameworks: ['framework-registry/index.json', 'build-tools-catalog.json'],
+    security: ['known-cves.json', 'security-patterns.json'],
+    pricing: ['ai-model-pricing.json', 'llm-providers.json'],
+    tooling: ['saas-registry.json', 'mcp-catalog.json'],
+    patterns: ['architecture-patterns.json', 'quality-principles.json'],
+    compliance: ['security-patterns.json'], // reuse security for compliance fallback
+    platforms: ['deploy-platforms.json'],
+};
+/**
+ * Load static fallback items from JSON config files.
+ * Converts JSON entries into KnowledgeItem format.
+ */
+export async function loadStaticFallback(category) {
+    const files = STATIC_FALLBACK_MAP[category];
+    const items = [];
+    for (const file of files) {
+        try {
+            const configDir = join(import.meta.dirname, '../../config');
+            const raw = await readFile(join(configDir, file), 'utf-8');
+            const data = JSON.parse(raw);
+            const converted = convertStaticToItems(data, category, file);
+            items.push(...converted);
+        }
+        catch {
+            // File doesn't exist or can't parse — skip silently
+        }
+    }
+    return items;
+}
+/**
+ * Convert a static JSON config into KnowledgeItem format.
+ * Handles various JSON structures found in src/config/.
+ */
+function convertStaticToItems(data, category, sourceFile) {
+    const items = [];
+    const now = new Date().toISOString();
+    // Handle arrays at top level
+    if (Array.isArray(data)) {
+        for (const entry of data) {
+            const rawId = entry.id ?? entry.name ?? items.length;
+            const id = typeof rawId === 'string' || typeof rawId === 'number'
+                ? String(rawId)
+                : String(items.length);
+            items.push({
+                id: `static-${category}-${id}`,
+                category,
+                title: toStr(entry.name ?? entry.title ?? entry.id, 'Unknown'),
+                description: toStr(entry.description ?? entry.summary, ''),
+                sourceUrl: undefined,
+                applicableTargets: inferTargetsFromStatic(entry),
+                severity: 'recommended',
+                tags: extractTagsFromStatic(entry),
+                fetchedAt: now,
+            });
+        }
+        return items;
+    }
+    // Handle object with named entries (like framework-registry)
+    for (const [key, value] of Object.entries(data)) {
+        if (typeof value === 'object' && value !== null) {
+            const entry = value;
+            items.push({
+                id: `static-${category}-${key}`,
+                category,
+                title: toStr(entry.name, key),
+                description: toStr(entry.description ?? entry.summary, `${key} from ${sourceFile}`),
+                sourceUrl: undefined,
+                applicableTargets: inferTargetsFromStatic(entry),
+                severity: 'recommended',
+                tags: extractTagsFromStatic(entry),
+                fetchedAt: now,
+            });
+        }
+    }
+    return items;
+}
+function inferTargetsFromStatic(entry) {
+    const type = toStr(entry.type ?? entry.target, '').toLowerCase();
+    if (type.includes('frontend')) {
+        return ['frontend'];
+    }
+    if (type.includes('backend')) {
+        return ['backend'];
+    }
+    return ['fullstack'];
+}
+function extractTagsFromStatic(entry) {
+    if (Array.isArray(entry.tags)) {
+        return entry.tags.filter((t) => typeof t === 'string').slice(0, 10);
+    }
+    if (typeof entry.category === 'string') {
+        return [entry.category];
+    }
+    return [];
+}
+/**
+ * Merge web-fetched items with static fallback items.
+ * Web items take priority. Static items fill gaps.
+ * Deduplicates by title similarity.
+ */
+export function mergeKnowledge(webItems, staticItems) {
+    if (webItems.length === 0) {
+        return staticItems;
+    }
+    if (staticItems.length === 0) {
+        return webItems;
+    }
+    const merged = [...webItems];
+    const webTitlesLower = new Set(webItems.map((i) => i.title.toLowerCase()));
+    // Add static items that don't overlap with web results
+    for (const staticItem of staticItems) {
+        const titleLower = staticItem.title.toLowerCase();
+        const isDuplicate = webTitlesLower.has(titleLower) ||
+            [...webTitlesLower].some((t) => t.includes(titleLower) || titleLower.includes(t));
+        if (!isDuplicate) {
+            merged.push(staticItem);
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=knowledge-merger.js.map

package/dist/engine/dynamic-knowledge/knowledge-merger.js.map

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

package/dist/engine/dynamic-knowledge/query-knowledge.d.ts

@@ -0,0 +1,17 @@
+import { type KnowledgeCategory, type KnowledgeResult, type ProjectContext } from '../../types/index.js';
+/**
+ * Query the Dynamic Knowledge Engine.
+ * Pipeline: cache check → web fetch → merge with static → filter → cache result
+ *
+ * Graceful degradation:
+ * 1. Try cache (fastest)
+ * 2. Try web search (freshest)
+ * 3. Fall back to static JSON (always available)
+ */
+export declare function queryKnowledge(category: KnowledgeCategory, context: ProjectContext): Promise<KnowledgeResult>;
+/**
+ * Query multiple categories at once.
+ * Runs queries in parallel for performance.
+ */
+export declare function queryMultipleCategories(categories: KnowledgeCategory[], context: ProjectContext): Promise<KnowledgeResult[]>;
+//# sourceMappingURL=query-knowledge.d.ts.map

package/dist/engine/dynamic-knowledge/query-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-knowledge.d.ts","sourceRoot":"","sources":["../../../src/engine/dynamic-knowledge/query-knowledge.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAO9B;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAsD1B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,iBAAiB,EAAE,EAC/B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B"}

package/dist/engine/dynamic-knowledge/query-knowledge.js

@@ -0,0 +1,73 @@
+// Main entry point — orchestrates fetch → cache → merge → filter
+import { CATEGORY_TTL, } from '../../types/index.js';
+import { findCachedEntry, readCache, setCacheEntry } from './knowledge-cache.js';
+import { buildSearchQueries, normalizeContext } from './context-resolver.js';
+import { fetchKnowledge } from './web-researcher.js';
+import { loadStaticFallback, mergeKnowledge } from './knowledge-merger.js';
+import { filterByContext } from './stack-filter.js';
+/**
+ * Query the Dynamic Knowledge Engine.
+ * Pipeline: cache check → web fetch → merge with static → filter → cache result
+ *
+ * Graceful degradation:
+ * 1. Try cache (fastest)
+ * 2. Try web search (freshest)
+ * 3. Fall back to static JSON (always available)
+ */
+export async function queryKnowledge(category, context) {
+    const normalizedCtx = normalizeContext(context);
+    const ttl = CATEGORY_TTL[category];
+    // Step 1: Check cache
+    try {
+        const store = await readCache();
+        const cached = findCachedEntry(store, category, normalizedCtx);
+        if (cached) {
+            return {
+                items: filterByContext(cached.items, context),
+                source: 'cache',
+                fetchedAt: cached.fetchedAt,
+                ttl,
+                category,
+            };
+        }
+    }
+    catch {
+        // Cache read failed — continue to web
+    }
+    // Step 2: Try web search
+    let webItems = [];
+    try {
+        const queries = buildSearchQueries(category, context);
+        webItems = await fetchKnowledge(queries, category);
+    }
+    catch {
+        // Web search failed — will use static
+    }
+    // Step 3: Load static fallback
+    const staticItems = await loadStaticFallback(category);
+    // Step 4: Merge web + static
+    const merged = mergeKnowledge(webItems, staticItems);
+    // Step 5: Filter by context
+    const filtered = filterByContext(merged, context);
+    // Step 6: Cache the merged result (fire-and-forget)
+    if (merged.length > 0) {
+        void setCacheEntry(category, normalizedCtx, merged);
+    }
+    // Determine source
+    const source = webItems.length > 0 ? 'web' : 'static';
+    return {
+        items: filtered,
+        source,
+        fetchedAt: new Date().toISOString(),
+        ttl,
+        category,
+    };
+}
+/**
+ * Query multiple categories at once.
+ * Runs queries in parallel for performance.
+ */
+export async function queryMultipleCategories(categories, context) {
+    return Promise.all(categories.map((cat) => queryKnowledge(cat, context)));
+}
+//# sourceMappingURL=query-knowledge.js.map

package/dist/engine/dynamic-knowledge/query-knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-knowledge.js","sourceRoot":"","sources":["../../../src/engine/dynamic-knowledge/query-knowledge.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,OAAO,EACL,YAAY,GAIb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAA2B,EAC3B,OAAuB;IAEvB,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEnC,sBAAsB;IACtB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC/D,IAAI,MAAM,EAAE,CAAC;YACX,OAAO;gBACL,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC;gBAC7C,MAAM,EAAE,OAAO;gBACf,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,GAAG;gBACH,QAAQ;aACT,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;IAED,yBAAyB;IACzB,IAAI,QAAQ,GAA+C,EAAE,CAAC;IAC9D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtD,QAAQ,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;IAED,+BAA+B;IAC/B,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAEvD,6BAA6B;IAC7B,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAErD,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElD,oDAAoD;IACpD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IAED,mBAAmB;IACnB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEtD,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,MAAM;QACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG;QACH,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,UAA+B,EAC/B,OAAuB;IAEvB,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/engine/dynamic-knowledge/stack-filter.d.ts

@@ -0,0 +1,7 @@
+import type { KnowledgeItem, ProjectContext } from '../../types/index.js';
+/**
+ * Filter knowledge items by relevance to the project context.
+ * Returns items sorted by relevance score (highest first).
+ */
+export declare function filterByContext(items: KnowledgeItem[], context: ProjectContext): KnowledgeItem[];
+//# sourceMappingURL=stack-filter.d.ts.map

package/dist/engine/dynamic-knowledge/stack-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-filter.d.ts","sourceRoot":"","sources":["../../../src/engine/dynamic-knowledge/stack-filter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,EAAE,CAUhG"}