@planu/cli 0.62.0 → 0.63.0

package/dist/engine/dynamic-knowledge/stack-filter.js

@@ -0,0 +1,45 @@
+/**
+ * Filter knowledge items by relevance to the project context.
+ * Returns items sorted by relevance score (highest first).
+ */
+export function filterByContext(items, context) {
+    const scored = items.map((item) => ({
+        item,
+        score: calculateRelevance(item, context),
+    }));
+    return scored
+        .filter((s) => s.score > 0.1) // minimum relevance threshold
+        .sort((a, b) => b.score - a.score)
+        .map((s) => s.item);
+}
+/**
+ * Calculate relevance score (0-1) for an item given the project context.
+ */
+function calculateRelevance(item, context) {
+    let score = 0.3; // base score
+    // Target match (0.25 weight)
+    if (item.applicableTargets.includes(context.target) ||
+        item.applicableTargets.includes('fullstack')) {
+        score += 0.25;
+    }
+    // Stack match (0.25 weight)
+    const stackLower = context.stack.map((s) => s.toLowerCase());
+    const itemText = `${item.title} ${item.description} ${item.tags.join(' ')}`.toLowerCase();
+    const stackMatches = stackLower.filter((s) => itemText.includes(s)).length;
+    if (stackMatches > 0) {
+        score += Math.min(0.25, stackMatches * 0.1);
+    }
+    // Severity bonus (0.1 weight)
+    if (item.severity === 'required') {
+        score += 0.1;
+    }
+    else if (item.severity === 'recommended') {
+        score += 0.05;
+    }
+    // App type match (0.1 weight)
+    if (context.appType && itemText.includes(context.appType.toLowerCase())) {
+        score += 0.1;
+    }
+    return Math.min(1, score);
+}
+//# sourceMappingURL=stack-filter.js.map

package/dist/engine/dynamic-knowledge/stack-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-filter.js","sourceRoot":"","sources":["../../../src/engine/dynamic-knowledge/stack-filter.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAsB,EAAE,OAAuB;IAC7E,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClC,IAAI;QACJ,KAAK,EAAE,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC;KACzC,CAAC,CAAC,CAAC;IAEJ,OAAO,MAAM;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,8BAA8B;SAC3D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,IAAmB,EAAE,OAAuB;IACtE,IAAI,KAAK,GAAG,GAAG,CAAC,CAAC,aAAa;IAE9B,6BAA6B;IAC7B,IACE,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;QAC/C,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,WAAW,CAAC,EAC5C,CAAC;QACD,KAAK,IAAI,IAAI,CAAC;IAChB,CAAC;IAED,4BAA4B;IAC5B,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1F,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3E,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,GAAG,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,8BAA8B;IAC9B,IAAI,IAAI,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QACjC,KAAK,IAAI,GAAG,CAAC;IACf,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC3C,KAAK,IAAI,IAAI,CAAC;IAChB,CAAC;IAED,8BAA8B;IAC9B,IAAI,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QACxE,KAAK,IAAI,GAAG,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/dist/engine/dynamic-knowledge/web-researcher.d.ts

@@ -0,0 +1,12 @@
+import type { KnowledgeCategory, KnowledgeItem, WebSearchResult } from '../../types/index.js';
+/**
+ * Perform a web search query and return parsed results.
+ * Uses DuckDuckGo HTML search as a free, no-API-key source.
+ * Falls back gracefully on network errors.
+ */
+export declare function searchWeb(query: string): Promise<WebSearchResult[]>;
+/**
+ * Fetch and extract knowledge items from web search results.
+ */
+export declare function fetchKnowledge(queries: string[], category: KnowledgeCategory): Promise<KnowledgeItem[]>;
+//# sourceMappingURL=web-researcher.d.ts.map

package/dist/engine/dynamic-knowledge/web-researcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-researcher.d.ts","sourceRoot":"","sources":["../../../src/engine/dynamic-knowledge/web-researcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE9F;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAoBzE;AA+CD;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,aAAa,EAAE,CAAC,CAU1B"}

package/dist/engine/dynamic-knowledge/web-researcher.js

@@ -0,0 +1,189 @@
+/**
+ * Perform a web search query and return parsed results.
+ * Uses DuckDuckGo HTML search as a free, no-API-key source.
+ * Falls back gracefully on network errors.
+ */
+export async function searchWeb(query) {
+    try {
+        const encoded = encodeURIComponent(query);
+        const url = `https://html.duckduckgo.com/html/?q=${encoded}`;
+        const response = await fetch(url, {
+            headers: {
+                'User-Agent': 'Planu/1.0 (Dynamic Knowledge Engine)',
+            },
+            signal: AbortSignal.timeout(10000), // 10s timeout
+        });
+        if (!response.ok) {
+            return [];
+        }
+        const html = await response.text();
+        return parseDuckDuckGoResults(html);
+    }
+    catch {
+        return []; // graceful degradation
+    }
+}
+/**
+ * Parse DuckDuckGo HTML results into structured data.
+ */
+function parseDuckDuckGoResults(html) {
+    const results = [];
+    // Extract result blocks - DuckDuckGo HTML uses class="result__a" for links
+    const linkRegex = /class="result__a"[^>]*href="([^"]*)"[^>]*>([^<]*)</g;
+    const snippetRegex = /class="result__snippet"[^>]*>([^<]*(?:<[^>]*>[^<]*)*)<\/a>/g;
+    let linkMatch;
+    const links = [];
+    while ((linkMatch = linkRegex.exec(html)) !== null) {
+        const rawUrl = linkMatch[1] ?? '';
+        const rawTitle = linkMatch[2] ?? '';
+        // DuckDuckGo wraps URLs in a redirect - extract actual URL
+        const urlMatch = /uddg=([^&]*)/.exec(rawUrl);
+        const url = urlMatch?.[1] !== undefined ? decodeURIComponent(urlMatch[1]) : rawUrl;
+        links.push({ url, title: rawTitle.trim() });
+    }
+    let snippetMatch;
+    const snippets = [];
+    while ((snippetMatch = snippetRegex.exec(html)) !== null) {
+        // Strip HTML tags from snippet
+        const raw = snippetMatch[1] ?? '';
+        snippets.push(raw.replace(/<[^>]*>/g, '').trim());
+    }
+    for (let i = 0; i < Math.min(links.length, 10); i++) {
+        const link = links[i];
+        if (!link) {
+            continue;
+        }
+        results.push({
+            title: link.title,
+            url: link.url,
+            snippet: snippets[i] ?? '',
+        });
+    }
+    return results;
+}
+/**
+ * Fetch and extract knowledge items from web search results.
+ */
+export async function fetchKnowledge(queries, category) {
+    const allResults = [];
+    // Run queries sequentially to avoid rate limiting (max 3 queries)
+    for (const query of queries.slice(0, 3)) {
+        const results = await searchWeb(query);
+        allResults.push(...results);
+    }
+    return parseResultsToItems(allResults, category);
+}
+/**
+ * Convert raw web search results into structured KnowledgeItems.
+ */
+function parseResultsToItems(results, category) {
+    const items = [];
+    const seen = new Set();
+    const now = new Date().toISOString();
+    for (const result of results) {
+        // Skip duplicates by URL
+        if (seen.has(result.url)) {
+            continue;
+        }
+        seen.add(result.url);
+        // Skip irrelevant results (ads, unrelated)
+        if (!result.snippet || result.snippet.length < 20) {
+            continue;
+        }
+        const id = `${category}-${Buffer.from(result.url).toString('base64url').slice(0, 12)}`;
+        items.push({
+            id,
+            category,
+            title: result.title,
+            description: result.snippet,
+            sourceUrl: result.url,
+            applicableTargets: inferTargets(result.snippet, category),
+            severity: inferSeverity(result.snippet, category),
+            tags: extractTags(result.snippet),
+            fetchedAt: now,
+        });
+    }
+    return items;
+}
+/**
+ * Infer which targets (frontend/backend/fullstack) a result applies to.
+ */
+function inferTargets(snippet, category) {
+    const lower = snippet.toLowerCase();
+    const targets = [];
+    if (/\b(frontend|react|vue|angular|css|dom|browser|ui)\b/.test(lower)) {
+        targets.push('frontend');
+    }
+    if (/\b(backend|server|api|database|sql|endpoint|node)\b/.test(lower)) {
+        targets.push('backend');
+    }
+    if (/\b(fullstack|full.stack|both|universal)\b/.test(lower)) {
+        targets.push('fullstack');
+    }
+    // Security and compliance apply everywhere
+    if (targets.length === 0 && (category === 'security' || category === 'compliance')) {
+        return ['frontend', 'backend', 'fullstack'];
+    }
+    return targets.length > 0 ? targets : ['fullstack'];
+}
+/**
+ * Infer severity based on content signals.
+ */
+function inferSeverity(snippet, category) {
+    const lower = snippet.toLowerCase();
+    if (category === 'security' && /\b(critical|vulnerability|exploit|owasp|cve)\b/.test(lower)) {
+        return 'required';
+    }
+    if (/\b(must|required|mandatory|essential|always)\b/.test(lower)) {
+        return 'required';
+    }
+    if (/\b(should|recommended|best practice|important)\b/.test(lower)) {
+        return 'recommended';
+    }
+    return 'optional';
+}
+/**
+ * Extract tags from snippet text.
+ */
+function extractTags(snippet) {
+    const lower = snippet.toLowerCase();
+    const tags = [];
+    const techKeywords = [
+        'react',
+        'vue',
+        'angular',
+        'svelte',
+        'next',
+        'nuxt',
+        'express',
+        'nestjs',
+        'django',
+        'fastapi',
+        'rails',
+        'typescript',
+        'python',
+        'go',
+        'rust',
+        'java',
+        'postgres',
+        'mysql',
+        'mongodb',
+        'redis',
+        'docker',
+        'kubernetes',
+        'aws',
+        'gcp',
+        'azure',
+        'owasp',
+        'csrf',
+        'xss',
+        'sql injection',
+    ];
+    for (const kw of techKeywords) {
+        if (lower.includes(kw)) {
+            tags.push(kw);
+        }
+    }
+    return tags.slice(0, 10); // max 10 tags
+}
+//# sourceMappingURL=web-researcher.js.map

package/dist/engine/dynamic-knowledge/web-researcher.js.map

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

package/dist/engine/ecosystem-absorber/capability-detector.d.ts

@@ -0,0 +1,11 @@
+import type { EcosystemCapability } from '../../types/index.js';
+/**
+ * Score and rank ecosystem capabilities by relevance to project context.
+ * Returns top N most relevant, each with updated relevance score and suggestion.
+ */
+export declare function rankCapabilities(capabilities: EcosystemCapability[], stackHints: string[], topN?: number): EcosystemCapability[];
+/**
+ * Extract actionable suggestions as plain text lines.
+ */
+export declare function extractSuggestions(capabilities: EcosystemCapability[]): string[];
+//# sourceMappingURL=capability-detector.d.ts.map

package/dist/engine/ecosystem-absorber/capability-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/ecosystem-absorber/capability-detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAkDhE;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,mBAAmB,EAAE,EACnC,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,SAAK,GACR,mBAAmB,EAAE,CASvB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,mBAAmB,EAAE,GAAG,MAAM,EAAE,CAQhF"}

package/dist/engine/ecosystem-absorber/capability-detector.js

@@ -0,0 +1,65 @@
+// engine/ecosystem-absorber/capability-detector.ts — Scores and filters capabilities by relevance
+const CATEGORY_SCORE_MAP = {
+    api: 0.8,
+    sdk: 0.75,
+    'tool-use': 0.9,
+    agent: 0.85,
+    skill: 0.7,
+    pattern: 0.5,
+};
+const STACK_SIGNALS = {
+    react: ['frontend', 'ui', 'component', 'design'],
+    typescript: ['sdk', 'type', 'library'],
+    python: ['ml', 'ai', 'data', 'notebook'],
+    docker: ['container', 'deployment', 'devops'],
+    mcp: ['tool-use', 'agent', 'protocol'],
+};
+/**
+ * Score a capability against a known project stack.
+ */
+function scoreCapability(cap, stackHints) {
+    let base = CATEGORY_SCORE_MAP[cap.category] ?? 0.5;
+    const lowerName = cap.name.toLowerCase();
+    const lowerDesc = cap.description.toLowerCase();
+    for (const hint of stackHints) {
+        const signals = STACK_SIGNALS[hint] ?? [];
+        const matched = signals.some((s) => lowerName.includes(s) || lowerDesc.includes(s));
+        if (matched) {
+            base = Math.min(1, base + 0.15);
+        }
+    }
+    return Math.round(base * 100) / 100;
+}
+/**
+ * Generate an actionable suggestion for a capability.
+ */
+function buildSuggestion(cap, stackHints) {
+    if (cap.suggestion) {
+        return cap.suggestion;
+    }
+    const stackHint = stackHints.length > 0 ? ` (detected stack: ${stackHints.join(', ')})` : '';
+    return `Consider integrating "${cap.name}" from ${cap.source}${stackHint}`;
+}
+/**
+ * Score and rank ecosystem capabilities by relevance to project context.
+ * Returns top N most relevant, each with updated relevance score and suggestion.
+ */
+export function rankCapabilities(capabilities, stackHints, topN = 10) {
+    const scored = capabilities.map((cap) => ({
+        ...cap,
+        relevance: scoreCapability(cap, stackHints),
+        suggestion: buildSuggestion(cap, stackHints),
+        actionable: cap.relevance > 0.5 || cap.actionable,
+    }));
+    return scored.sort((a, b) => b.relevance - a.relevance).slice(0, topN);
+}
+/**
+ * Extract actionable suggestions as plain text lines.
+ */
+export function extractSuggestions(capabilities) {
+    return capabilities
+        .filter((c) => c.actionable && typeof c.suggestion === 'string')
+        .map((c) => c.suggestion)
+        .slice(0, 5);
+}
+//# sourceMappingURL=capability-detector.js.map

package/dist/engine/ecosystem-absorber/capability-detector.js.map

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

package/dist/engine/ecosystem-absorber/ecosystem-watcher.d.ts

@@ -0,0 +1,11 @@
+import type { EcosystemCapability, EcosystemSource, WatcherSummary } from '../../types/index.js';
+/**
+ * Orchestrate crawling all enabled sources, respecting TTL.
+ * Returns a summary of what was crawled and discovered.
+ */
+export declare function runEcosystemWatcher(sources: EcosystemSource[], forceRefresh?: boolean): Promise<WatcherSummary>;
+/**
+ * Load cached capabilities without re-crawling.
+ */
+export declare function loadCachedCapabilities(): EcosystemCapability[];
+//# sourceMappingURL=ecosystem-watcher.d.ts.map

package/dist/engine/ecosystem-absorber/ecosystem-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosystem-watcher.d.ts","sourceRoot":"","sources":["../../../src/engine/ecosystem-absorber/ecosystem-watcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAoBjG;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,eAAe,EAAE,EAC1B,YAAY,UAAQ,GACnB,OAAO,CAAC,cAAc,CAAC,CAwCzB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,EAAE,CAE9D"}

package/dist/engine/ecosystem-absorber/ecosystem-watcher.js

@@ -0,0 +1,57 @@
+// engine/ecosystem-absorber/ecosystem-watcher.ts — Orchestrates crawling all enabled sources
+import { crawlDocsSource, crawlGitHubSource } from './platform-crawler.js';
+import { readCache, writeCache, mergeCapabilities, isCacheStale, markCrawled, } from './knowledge-cache.js';
+/**
+ * Crawl a single source based on its type. Never throws.
+ */
+async function crawlSource(source) {
+    if (source.type === 'github') {
+        return crawlGitHubSource(source);
+    }
+    return crawlDocsSource(source);
+}
+/**
+ * Orchestrate crawling all enabled sources, respecting TTL.
+ * Returns a summary of what was crawled and discovered.
+ */
+export async function runEcosystemWatcher(sources, forceRefresh = false) {
+    const cache = readCache();
+    const crawledSources = [];
+    const skippedSources = [];
+    let allNew = [];
+    const enabled = sources.filter((s) => s.enabled);
+    for (const source of enabled) {
+        const stale = forceRefresh || isCacheStale(cache.lastCrawled, source.id, source.crawlIntervalHours);
+        if (!stale) {
+            skippedSources.push(source.id);
+            continue;
+        }
+        const discovered = await crawlSource(source);
+        allNew = allNew.concat(discovered);
+        crawledSources.push(source.id);
+        cache.lastCrawled = markCrawled(cache.lastCrawled, source.id);
+    }
+    const merged = mergeCapabilities(cache.capabilities, allNew);
+    const updatedCache = {
+        ...cache,
+        capabilities: merged,
+    };
+    if (crawledSources.length > 0) {
+        writeCache(updatedCache);
+    }
+    return {
+        crawledSources,
+        skippedSources,
+        newCapabilities: allNew.length,
+        totalCapabilities: merged.length,
+        lastCrawled: updatedCache.lastCrawled,
+        capabilities: merged,
+    };
+}
+/**
+ * Load cached capabilities without re-crawling.
+ */
+export function loadCachedCapabilities() {
+    return readCache().capabilities;
+}
+//# sourceMappingURL=ecosystem-watcher.js.map

package/dist/engine/ecosystem-absorber/ecosystem-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosystem-watcher.js","sourceRoot":"","sources":["../../../src/engine/ecosystem-absorber/ecosystem-watcher.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAG7F,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EACL,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,KAAK,UAAU,WAAW,CAAC,MAAuB;IAChD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAA0B,EAC1B,YAAY,GAAG,KAAK;IAEpB,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,IAAI,MAAM,GAA0B,EAAE,CAAC;IAEvC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAEjD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GACT,YAAY,IAAI,YAAY,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACxF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC/B,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACnC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/B,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG;QACnB,GAAG,KAAK;QACR,YAAY,EAAE,MAAM;KACrB,CAAC;IAEF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,UAAU,CAAC,YAAY,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,cAAc;QACd,cAAc;QACd,eAAe,EAAE,MAAM,CAAC,MAAM;QAC9B,iBAAiB,EAAE,MAAM,CAAC,MAAM;QAChC,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,YAAY,EAAE,MAAM;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,SAAS,EAAE,CAAC,YAAY,CAAC;AAClC,CAAC"}

package/dist/engine/ecosystem-absorber/index.d.ts

@@ -0,0 +1,5 @@
+export { crawlDocsSource, crawlGitHubSource } from './platform-crawler.js';
+export { rankCapabilities, extractSuggestions } from './capability-detector.js';
+export { readCache, writeCache, mergeCapabilities, isCacheStale, markCrawled, } from './knowledge-cache.js';
+export { runEcosystemWatcher, loadCachedCapabilities } from './ecosystem-watcher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/ecosystem-absorber/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/ecosystem-absorber/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EACL,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/engine/ecosystem-absorber/index.js

@@ -0,0 +1,6 @@
+// engine/ecosystem-absorber/index.ts — Barrel export for ecosystem absorber engine
+export { crawlDocsSource, crawlGitHubSource } from './platform-crawler.js';
+export { rankCapabilities, extractSuggestions } from './capability-detector.js';
+export { readCache, writeCache, mergeCapabilities, isCacheStale, markCrawled, } from './knowledge-cache.js';
+export { runEcosystemWatcher, loadCachedCapabilities } from './ecosystem-watcher.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/ecosystem-absorber/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/ecosystem-absorber/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EACL,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/engine/ecosystem-absorber/knowledge-cache.d.ts

@@ -0,0 +1,23 @@
+import type { EcosystemCache, EcosystemCapability } from '../../types/index.js';
+/**
+ * Read the ecosystem cache from disk. Returns empty cache on any error.
+ */
+export declare function readCache(): EcosystemCache;
+/**
+ * Write updated cache to disk. Silently ignores write errors.
+ */
+export declare function writeCache(cache: EcosystemCache): void;
+/**
+ * Merge new capabilities into existing cache, deduplicating by id.
+ * Prunes capabilities older than PRUNE_DAYS days.
+ */
+export declare function mergeCapabilities(existing: EcosystemCapability[], incoming: EcosystemCapability[]): EcosystemCapability[];
+/**
+ * Check whether a source needs re-crawling given its TTL in hours.
+ */
+export declare function isCacheStale(lastCrawled: Record<string, string>, sourceId: string, intervalHours: number): boolean;
+/**
+ * Update the lastCrawled timestamp for a source.
+ */
+export declare function markCrawled(lastCrawled: Record<string, string>, sourceId: string): Record<string, string>;
+//# sourceMappingURL=knowledge-cache.d.ts.map

package/dist/engine/ecosystem-absorber/knowledge-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-cache.d.ts","sourceRoot":"","sources":["../../../src/engine/ecosystem-absorber/knowledge-cache.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAiBhF;;GAEG;AACH,wBAAgB,SAAS,IAAI,cAAc,CAe1C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAOtD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,mBAAmB,EAAE,CAgBvB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExB"}

package/dist/engine/ecosystem-absorber/knowledge-cache.js

@@ -0,0 +1,83 @@
+// engine/ecosystem-absorber/knowledge-cache.ts — Reads/writes ecosystem capability cache
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+const CACHE_VERSION = '1';
+const PRUNE_DAYS = 30;
+const DATA_DIR = join(process.cwd(), 'data', 'ecosystem');
+const CACHE_FILE = join(DATA_DIR, 'capabilities.json');
+function emptyCache() {
+    return { lastCrawled: {}, capabilities: [], version: CACHE_VERSION };
+}
+function ensureDir() {
+    if (!existsSync(DATA_DIR)) {
+        mkdirSync(DATA_DIR, { recursive: true });
+    }
+}
+/**
+ * Read the ecosystem cache from disk. Returns empty cache on any error.
+ */
+export function readCache() {
+    try {
+        if (!existsSync(CACHE_FILE)) {
+            return emptyCache();
+        }
+        const raw = readFileSync(CACHE_FILE, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return {
+            lastCrawled: parsed.lastCrawled ?? {},
+            capabilities: Array.isArray(parsed.capabilities) ? parsed.capabilities : [],
+            version: parsed.version ?? CACHE_VERSION,
+        };
+    }
+    catch {
+        return emptyCache();
+    }
+}
+/**
+ * Write updated cache to disk. Silently ignores write errors.
+ */
+export function writeCache(cache) {
+    try {
+        ensureDir();
+        writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2), 'utf-8');
+    }
+    catch {
+        // Graceful degradation — do not throw
+    }
+}
+/**
+ * Merge new capabilities into existing cache, deduplicating by id.
+ * Prunes capabilities older than PRUNE_DAYS days.
+ */
+export function mergeCapabilities(existing, incoming) {
+    const cutoff = Date.now() - PRUNE_DAYS * 24 * 60 * 60 * 1000;
+    const map = new Map();
+    for (const cap of existing) {
+        const ts = new Date(cap.discoveredAt).getTime();
+        if (ts >= cutoff) {
+            map.set(cap.id, cap);
+        }
+    }
+    for (const cap of incoming) {
+        map.set(cap.id, cap);
+    }
+    return Array.from(map.values());
+}
+/**
+ * Check whether a source needs re-crawling given its TTL in hours.
+ */
+export function isCacheStale(lastCrawled, sourceId, intervalHours) {
+    const last = lastCrawled[sourceId];
+    if (!last) {
+        return true;
+    }
+    const elapsed = (Date.now() - new Date(last).getTime()) / 3_600_000;
+    return elapsed >= intervalHours;
+}
+/**
+ * Update the lastCrawled timestamp for a source.
+ */
+export function markCrawled(lastCrawled, sourceId) {
+    return { ...lastCrawled, [sourceId]: new Date().toISOString() };
+}
+//# sourceMappingURL=knowledge-cache.js.map

package/dist/engine/ecosystem-absorber/knowledge-cache.js.map

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

package/dist/engine/ecosystem-absorber/platform-crawler.d.ts

@@ -0,0 +1,12 @@
+import type { EcosystemCapability, EcosystemSource } from '../../types/index.js';
+/**
+ * Crawl a docs-type source and return discovered capabilities.
+ * Never throws — returns empty array on any error.
+ */
+export declare function crawlDocsSource(source: EcosystemSource): Promise<EcosystemCapability[]>;
+/**
+ * Crawl a GitHub-type source using the public API.
+ * Never throws — returns empty array on any error.
+ */
+export declare function crawlGitHubSource(source: EcosystemSource): Promise<EcosystemCapability[]>;
+//# sourceMappingURL=platform-crawler.d.ts.map

package/dist/engine/ecosystem-absorber/platform-crawler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-crawler.d.ts","sourceRoot":"","sources":["../../../src/engine/ecosystem-absorber/platform-crawler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAkFjF;;;GAGG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAM7F;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAsC/F"}