@planu/cli 0.68.0 → 0.70.0

package/dist/config/discovery-queries.json

@@ -0,0 +1,267 @@
+{
+  "local-first": {
+    "npm": ["crdt", "offline-first", "local-first-database", "realtime-sync"],
+    "github_topics": ["crdt", "local-first", "offline-first", "sync-engine"],
+    "description": "Local-first data sync and offline capabilities"
+  },
+  "event-driven": {
+    "npm": ["event-sourcing", "cqrs", "message-queue", "event-bus"],
+    "github_topics": ["event-sourcing", "message-broker", "event-driven"],
+    "description": "Event-driven architecture patterns"
+  },
+  "realtime": {
+    "npm": ["realtime-database", "multiplayer", "collaborative-editing", "websocket-server"],
+    "github_topics": ["realtime", "multiplayer", "collaborative", "websocket"],
+    "description": "Real-time sync and multiplayer capabilities"
+  },
+  "ai-native": {
+    "npm": ["llm-orchestration", "rag-framework", "vector-database", "ai-agent"],
+    "github_topics": ["llm", "rag", "ai-agent", "vector-database"],
+    "description": "AI/LLM native application patterns"
+  },
+  "serverless": {
+    "npm": ["serverless-framework", "edge-function", "serverless-database"],
+    "github_topics": ["serverless", "edge-computing", "faas"],
+    "description": "Serverless and edge computing"
+  },
+  "microservices": {
+    "npm": ["service-mesh", "api-gateway", "service-discovery", "distributed-tracing"],
+    "github_topics": ["microservices", "service-mesh", "api-gateway"],
+    "description": "Microservices architecture"
+  },
+  "testing-advanced": {
+    "npm": ["property-based-testing", "mutation-testing", "chaos-engineering", "contract-testing"],
+    "github_topics": ["property-testing", "mutation-testing", "chaos-engineering"],
+    "description": "Advanced testing patterns"
+  },
+  "observability": {
+    "npm": ["opentelemetry", "distributed-tracing", "log-aggregation", "metrics-collection"],
+    "github_topics": ["observability", "tracing", "monitoring"],
+    "description": "Observability and monitoring stack"
+  },
+  "mobile-cross-platform": {
+    "npm": ["react-native", "flutter", "capacitor", "expo"],
+    "github_topics": ["react-native", "flutter", "cross-platform-mobile"],
+    "description": "Cross-platform mobile development"
+  },
+  "security": {
+    "npm": ["oauth2-server", "jwt-authentication", "rbac", "rate-limiter"],
+    "github_topics": ["authentication", "authorization", "security"],
+    "description": "Security and authentication patterns"
+  },
+  "ci-cd": {
+    "npm": ["github-actions", "ci-cd", "deployment-automation"],
+    "github_topics": ["ci-cd", "devops", "deployment"],
+    "description": "CI/CD and deployment automation"
+  },
+  "database-modern": {
+    "npm": ["edge-database", "serverless-database", "vector-store", "graph-database"],
+    "github_topics": ["database", "serverless-database", "vector-database"],
+    "description": "Modern database solutions"
+  },
+  "actor-model": {
+    "npm": ["actor-framework", "akka", "nact", "comedy"],
+    "github_topics": ["actor-model", "actor-framework", "concurrent-programming"],
+    "description": "Actor model concurrency patterns"
+  },
+  "temporal": {
+    "npm": ["temporalio", "workflow-orchestration", "durable-execution"],
+    "github_topics": ["temporal", "workflow-engine", "durable-workflow"],
+    "description": "Temporal workflow orchestration"
+  },
+  "cell-based": {
+    "npm": ["cell-architecture", "blast-radius", "fault-isolation"],
+    "github_topics": ["cell-based-architecture", "availability-zones", "fault-isolation"],
+    "description": "Cell-based architecture for fault isolation"
+  },
+  "data-mesh": {
+    "npm": ["data-mesh", "data-product", "data-catalog", "data-contract"],
+    "github_topics": ["data-mesh", "data-product", "data-governance"],
+    "description": "Data mesh and data product patterns"
+  },
+  "bff": {
+    "npm": ["backend-for-frontend", "api-composition", "graphql-gateway"],
+    "github_topics": ["bff", "backend-for-frontend", "api-gateway"],
+    "description": "Backend for Frontend pattern"
+  },
+  "modular-monolith": {
+    "npm": ["module-boundaries", "nx-module", "vertical-slice"],
+    "github_topics": ["modular-monolith", "vertical-slice-architecture", "clean-architecture"],
+    "description": "Modular monolith architecture"
+  },
+  "composable": {
+    "npm": ["composable-architecture", "headless-commerce", "mach-architecture"],
+    "github_topics": ["composable-architecture", "headless-cms", "mach"],
+    "description": "Composable and MACH architecture"
+  },
+  "ddd": {
+    "npm": ["domain-driven-design", "aggregate-root", "bounded-context", "domain-events"],
+    "github_topics": ["ddd", "domain-driven-design", "bounded-context"],
+    "description": "Domain-Driven Design patterns"
+  },
+  "wasm": {
+    "npm": ["webassembly", "wasm-pack", "assemblyscript", "emscripten"],
+    "github_topics": ["webassembly", "wasm", "assemblyscript"],
+    "description": "WebAssembly toolchain and targets"
+  },
+  "gitops": {
+    "npm": ["flux", "argocd", "gitops-operator"],
+    "github_topics": ["gitops", "flux", "argocd"],
+    "description": "GitOps deployment patterns"
+  },
+  "micro-frontend": {
+    "npm": ["module-federation", "single-spa", "micro-frontend", "webpack-federation"],
+    "github_topics": ["micro-frontends", "module-federation", "single-spa"],
+    "description": "Micro-frontend architecture"
+  },
+  "vector-db": {
+    "npm": ["pinecone", "weaviate", "qdrant", "chroma", "pgvector"],
+    "github_topics": ["vector-database", "embedding-search", "semantic-search"],
+    "description": "Vector database and embedding storage"
+  },
+  "graph-db": {
+    "npm": ["neo4j", "tigergraph", "dgraph", "arangodb"],
+    "github_topics": ["graph-database", "knowledge-graph", "neo4j"],
+    "description": "Graph database patterns"
+  },
+  "timeseries-db": {
+    "npm": ["influxdb", "timescaledb", "questdb", "prometheus"],
+    "github_topics": ["time-series-database", "timescaledb", "influxdb"],
+    "description": "Time-series data storage and analytics"
+  },
+  "cache-db": {
+    "npm": ["redis", "memcached", "keyv", "cache-manager"],
+    "github_topics": ["caching", "redis", "distributed-cache"],
+    "description": "Caching and in-memory data stores"
+  },
+  "newsql": {
+    "npm": ["cockroachdb", "yugabyte", "vitess", "tidb"],
+    "github_topics": ["newsql", "distributed-sql", "cockroachdb"],
+    "description": "NewSQL distributed relational databases"
+  },
+  "wide-column-db": {
+    "npm": ["cassandra", "scylladb", "bigtable", "hbase"],
+    "github_topics": ["wide-column-store", "cassandra", "distributed-database"],
+    "description": "Wide-column NoSQL databases"
+  },
+  "monitoring": {
+    "npm": ["prometheus", "grafana", "datadog", "newrelic"],
+    "github_topics": ["monitoring", "alerting", "metrics"],
+    "description": "Application monitoring and alerting"
+  },
+  "supply-chain": {
+    "npm": ["sbom", "dependency-check", "syft", "grype"],
+    "github_topics": ["supply-chain-security", "sbom", "dependency-scanning"],
+    "description": "Software supply chain security"
+  },
+  "finops": {
+    "npm": ["cloud-cost", "infracost", "opencost"],
+    "github_topics": ["finops", "cloud-cost-optimization", "infracost"],
+    "description": "Cloud cost optimization and FinOps"
+  },
+  "hypermedia": {
+    "npm": ["htmx", "hyperscript", "hypermedia-api", "hateoas"],
+    "github_topics": ["htmx", "hypermedia", "hateoas"],
+    "description": "Hypermedia-driven API patterns"
+  },
+  "search-engine": {
+    "npm": ["elasticsearch", "meilisearch", "typesense", "algolia"],
+    "github_topics": ["search-engine", "full-text-search", "meilisearch"],
+    "description": "Full-text and vector search engines"
+  },
+  "idp": {
+    "npm": ["backstage", "port", "cortex", "internal-developer-portal"],
+    "github_topics": ["internal-developer-portal", "backstage", "platform-engineering"],
+    "description": "Internal Developer Platform patterns"
+  },
+  "nomad": {
+    "npm": ["nomad", "hashicorp-nomad"],
+    "github_topics": ["nomad", "hashicorp-nomad", "workload-orchestration"],
+    "description": "HashiCorp Nomad workload orchestration"
+  },
+  "k3s": {
+    "npm": ["k3s", "lightweight-kubernetes"],
+    "github_topics": ["k3s", "lightweight-kubernetes", "edge-kubernetes"],
+    "description": "Lightweight Kubernetes distributions"
+  },
+  "agent-framework": {
+    "npm": ["langchain-agent", "autogen", "crewai", "langgraph"],
+    "github_topics": ["ai-agents", "multi-agent", "autogen"],
+    "description": "AI agent frameworks and orchestration"
+  },
+  "platform-specialty": {
+    "npm": ["cloudflare-workers", "aws-lambda", "vercel-edge", "deno-deploy"],
+    "github_topics": ["edge-runtime", "cloudflare-workers", "serverless-functions"],
+    "description": "Specialty platform and edge runtimes"
+  },
+  "frontend-perf": {
+    "npm": ["web-vitals", "lighthouse", "bundle-analyzer", "lazy-loading"],
+    "github_topics": ["core-web-vitals", "performance-optimization", "web-performance"],
+    "description": "Frontend performance optimization"
+  },
+  "template-engine": {
+    "npm": ["handlebars", "nunjucks", "pug", "ejs"],
+    "github_topics": ["template-engine", "server-side-rendering", "templating"],
+    "description": "Server-side template engines"
+  },
+  "resilience": {
+    "npm": ["circuit-breaker", "retry-logic", "bulkhead", "timeout-handler"],
+    "github_topics": ["resilience", "circuit-breaker", "fault-tolerance"],
+    "description": "Resilience and fault tolerance patterns"
+  },
+  "mcp-candidate": {
+    "npm": ["mcp-server", "model-context-protocol", "claude-mcp"],
+    "github_topics": ["model-context-protocol", "mcp-server", "claude-tools"],
+    "description": "Model Context Protocol server candidates"
+  },
+  "multi-tenancy": {
+    "npm": ["multi-tenant", "tenant-isolation", "saas-framework"],
+    "github_topics": ["multi-tenancy", "saas", "tenant-isolation"],
+    "description": "Multi-tenancy SaaS patterns"
+  },
+  "analytics": {
+    "npm": ["segment", "mixpanel", "posthog", "amplitude"],
+    "github_topics": ["product-analytics", "event-tracking", "analytics"],
+    "description": "Product analytics and event tracking"
+  },
+  "desktop": {
+    "npm": ["electron", "tauri", "neutralino", "nw.js"],
+    "github_topics": ["desktop-app", "electron", "tauri"],
+    "description": "Desktop application frameworks"
+  },
+  "pii": {
+    "npm": ["pii-detection", "data-masking", "gdpr-compliance"],
+    "github_topics": ["pii-detection", "data-privacy", "gdpr"],
+    "description": "PII detection and data privacy"
+  },
+  "eu-ai-act": {
+    "npm": ["ai-compliance", "model-card", "fairness-indicators"],
+    "github_topics": ["eu-ai-act", "ai-compliance", "responsible-ai"],
+    "description": "EU AI Act compliance tooling"
+  },
+  "otel-ecosystem": {
+    "npm": ["opentelemetry-sdk", "otel-exporter", "otel-collector"],
+    "github_topics": ["opentelemetry", "otel", "observability"],
+    "description": "OpenTelemetry ecosystem integrations"
+  },
+  "llm-provider": {
+    "npm": ["openai", "anthropic", "azure-openai", "google-ai"],
+    "github_topics": ["llm", "language-model", "generative-ai"],
+    "description": "LLM provider SDKs and integrations"
+  },
+  "cicd": {
+    "npm": ["jest-ci", "semantic-release", "release-it", "changesets"],
+    "github_topics": ["continuous-integration", "continuous-deployment", "release-automation"],
+    "description": "CI/CD pipeline tooling and release automation"
+  },
+  "cloud-db": {
+    "npm": ["supabase", "firebase", "planetscale", "neon"],
+    "github_topics": ["cloud-database", "serverless-postgres", "firebase"],
+    "description": "Managed cloud database services"
+  },
+  "monorepo": {
+    "npm": ["nx", "turborepo", "lerna", "pnpm-workspace"],
+    "github_topics": ["monorepo", "nx", "turborepo"],
+    "description": "Monorepo tooling and management"
+  }
+}

package/dist/config/license-plans.json

@@ -62,6 +62,7 @@
     "check_readiness",
     "contribute_context",
     "context_budget",
+    "token_intelligence",
     "data_governance",
     "legal_compliance_report",
     "define_ui_contract",

package/dist/engine/discovery/registry-search.d.ts

@@ -0,0 +1,4 @@
+import type { DiscoveredTool } from './result-ranker.js';
+export declare function searchNpmRegistry(keywords: string[]): Promise<DiscoveredTool[]>;
+export declare function searchGitHubTopics(topics: string[]): Promise<DiscoveredTool[]>;
+//# sourceMappingURL=registry-search.d.ts.map

package/dist/engine/discovery/registry-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-search.d.ts","sourceRoot":"","sources":["../../../src/engine/discovery/registry-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAqCzD,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAuCrF;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAoCpF"}

package/dist/engine/discovery/registry-search.js

@@ -0,0 +1,82 @@
+const NPM_SEARCH_URL = 'https://registry.npmjs.org/-/v1/search';
+const NPM_DOWNLOADS_URL = 'https://api.npmjs.org/downloads/point/last-week';
+const GITHUB_SEARCH_URL = 'https://api.github.com/search/repositories';
+const TIMEOUT_MS = 5000;
+function withTimeout(promise, ms) {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => {
+            reject(new Error('timeout'));
+        }, ms)),
+    ]);
+}
+async function fetchJson(url) {
+    const response = await withTimeout(fetch(url), TIMEOUT_MS);
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status}`);
+    }
+    return response.json();
+}
+async function getWeeklyDownloads(name) {
+    try {
+        const data = (await fetchJson(`${NPM_DOWNLOADS_URL}/${encodeURIComponent(name)}`));
+        return data.downloads;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function searchNpmRegistry(keywords) {
+    const targets = keywords.slice(0, 3);
+    const results = [];
+    for (const keyword of targets) {
+        try {
+            const url = `${NPM_SEARCH_URL}?text=keywords:${encodeURIComponent(keyword)}&size=5`;
+            const data = (await fetchJson(url));
+            const packages = data.objects ?? [];
+            for (const obj of packages) {
+                const pkg = obj.package;
+                const downloads = await getWeeklyDownloads(pkg.name);
+                results.push({
+                    name: pkg.name,
+                    description: pkg.description ?? '',
+                    url: pkg.links?.npm ?? `https://www.npmjs.com/package/${pkg.name}`,
+                    source: 'npm',
+                    publishedAt: pkg.date,
+                    weeklyDownloads: downloads,
+                });
+            }
+        }
+        catch {
+            // best-effort: skip failed keyword
+        }
+    }
+    return results;
+}
+export async function searchGitHubTopics(topics) {
+    const targets = topics.slice(0, 2);
+    const results = [];
+    for (const topic of targets) {
+        try {
+            const query = `topic:${encodeURIComponent(topic)}+stars:>500`;
+            const url = `${GITHUB_SEARCH_URL}?q=${query}&sort=stars&per_page=5`;
+            const data = (await fetchJson(url));
+            const items = data.items ?? [];
+            for (const item of items) {
+                results.push({
+                    name: item.full_name,
+                    description: item.description ?? '',
+                    url: item.html_url,
+                    source: 'github',
+                    stars: item.stargazers_count,
+                    pushedAt: item.pushed_at,
+                });
+            }
+        }
+        catch {
+            // best-effort: skip failed topic
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=registry-search.js.map

package/dist/engine/discovery/registry-search.js.map

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

package/dist/engine/discovery/result-ranker.d.ts

@@ -0,0 +1,8 @@
+import type { DiscoveredTool } from '../../types/index.js';
+export type { DiscoveredTool };
+/**
+ * Ranks npm and GitHub discovery results by popularity and stack relevance.
+ * Deduplicates by name (case-insensitive), returns top 10 sorted descending by score.
+ */
+export declare function rankResults(npmResults: DiscoveredTool[], githubResults: DiscoveredTool[], stackLanguage: string): DiscoveredTool[];
+//# sourceMappingURL=result-ranker.d.ts.map

package/dist/engine/discovery/result-ranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-ranker.d.ts","sourceRoot":"","sources":["../../../src/engine/discovery/result-ranker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,YAAY,EAAE,cAAc,EAAE,CAAC;AAiC/B;;;GAGG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,cAAc,EAAE,EAC5B,aAAa,EAAE,cAAc,EAAE,EAC/B,aAAa,EAAE,MAAM,GACpB,cAAc,EAAE,CAclB"}

package/dist/engine/discovery/result-ranker.js

@@ -0,0 +1,46 @@
+// engine/discovery/result-ranker.ts — SPEC-181
+// Ranks and deduplicates npm + GitHub discovery results by popularity and stack relevance.
+const MAX_RESULTS = 10;
+const MAX_SCORE = 50;
+function scoreNpm(tool) {
+    if (!tool.weeklyDownloads || tool.weeklyDownloads <= 0) {
+        return 0;
+    }
+    return Math.min(Math.log10(tool.weeklyDownloads) * 10, MAX_SCORE);
+}
+function scoreGithub(tool) {
+    if (!tool.stars || tool.stars <= 0) {
+        return 0;
+    }
+    return Math.min(Math.log10(tool.stars) * 15, MAX_SCORE);
+}
+function stackBonus(tool, stackLanguage) {
+    if (!stackLanguage) {
+        return 0;
+    }
+    const lang = stackLanguage.toLowerCase();
+    const text = `${tool.name} ${tool.description}`.toLowerCase();
+    return text.includes(lang) ? 10 : 0;
+}
+function computeScore(tool, stackLanguage) {
+    const base = tool.source === 'npm' ? scoreNpm(tool) : scoreGithub(tool);
+    return base + stackBonus(tool, stackLanguage);
+}
+/**
+ * Ranks npm and GitHub discovery results by popularity and stack relevance.
+ * Deduplicates by name (case-insensitive), returns top 10 sorted descending by score.
+ */
+export function rankResults(npmResults, githubResults, stackLanguage) {
+    const seen = new Map();
+    for (const tool of [...npmResults, ...githubResults]) {
+        const key = tool.name.toLowerCase();
+        const computedScore = computeScore(tool, stackLanguage);
+        const scored = { ...tool, score: computedScore };
+        const existing = seen.get(key);
+        if (!existing || computedScore > (existing.score ?? 0)) {
+            seen.set(key, scored);
+        }
+    }
+    return [...seen.values()].sort((a, b) => (b.score ?? 0) - (a.score ?? 0)).slice(0, MAX_RESULTS);
+}
+//# sourceMappingURL=result-ranker.js.map

package/dist/engine/discovery/result-ranker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-ranker.js","sourceRoot":"","sources":["../../../src/engine/discovery/result-ranker.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,2FAA2F;AAM3F,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB,SAAS,QAAQ,CAAC,IAAoB;IACpC,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,eAAe,IAAI,CAAC,EAAE,CAAC;QACvD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,WAAW,CAAC,IAAoB;IACvC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,UAAU,CAAC,IAAoB,EAAE,aAAqB;IAC7D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9D,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,YAAY,CAAC,IAAoB,EAAE,aAAqB;IAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACxE,OAAO,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,UAA4B,EAC5B,aAA+B,EAC/B,aAAqB;IAErB,MAAM,IAAI,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE/C,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,UAAU,EAAE,GAAG,aAAa,CAAC,EAAE,CAAC;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QACxD,MAAM,MAAM,GAAmB,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,IAAI,aAAa,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;AAClG,CAAC"}

package/dist/engine/discovery/tech-discovery.d.ts

@@ -0,0 +1,4 @@
+import type { DiscoveredTool } from '../../types/discovery.js';
+export type { DiscoveredTool };
+export declare function discoverTools(patterns: string[], _stackLanguage: string, dataDir: string): Promise<DiscoveredTool[]>;
+//# sourceMappingURL=tech-discovery.d.ts.map

package/dist/engine/discovery/tech-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tech-discovery.d.ts","sourceRoot":"","sources":["../../../src/engine/discovery/tech-discovery.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,0BAA0B,CAAC;AAElC,YAAY,EAAE,cAAc,EAAE,CAAC;AAwD/B,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAAE,EAClB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,EAAE,CAAC,CAwC3B"}

package/dist/engine/discovery/tech-discovery.js

@@ -0,0 +1,83 @@
+// tech-discovery.ts — Main orchestrator for tool discovery across npm and GitHub registries
+import { readFileSync } from 'node:fs';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { searchNpmRegistry, searchGitHubTopics } from './registry-search.js';
+import { rankResults } from './result-ranker.js';
+// --- config (loaded once at module init) ---
+const CONFIG_PATH = join(dirname(fileURLToPath(import.meta.url)), '../../config/discovery-queries.json');
+let queryMapping = null;
+function loadDiscoveryQueryMapping() {
+    if (queryMapping !== null) {
+        return queryMapping;
+    }
+    try {
+        queryMapping = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8'));
+    }
+    catch {
+        queryMapping = {};
+    }
+    return queryMapping;
+}
+// --- cache helpers ---
+const CACHE_TTL_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+function cacheFile(dataDir) {
+    return join(dataDir, 'discovery-cache.json');
+}
+async function readCache(dataDir) {
+    try {
+        const raw = await readFile(cacheFile(dataDir), 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+async function writeCache(dataDir, cache) {
+    try {
+        const path = cacheFile(dataDir);
+        await mkdir(dirname(path), { recursive: true });
+        await writeFile(path, JSON.stringify(cache, null, 2), 'utf-8');
+    }
+    catch {
+        // best-effort — never fail the caller
+    }
+}
+function isFresh(entry) {
+    return Date.now() - new Date(entry.cachedAt).getTime() < CACHE_TTL_MS;
+}
+// --- main export ---
+export async function discoverTools(patterns, _stackLanguage, dataDir) {
+    const mapping = loadDiscoveryQueryMapping();
+    const cache = await readCache(dataDir);
+    const cacheUpdated = { ...cache };
+    const allResults = await Promise.all(patterns.map(async (pattern) => {
+        const cached = cache[pattern];
+        if (cached && isFresh(cached)) {
+            return cached.results;
+        }
+        const config = mapping[pattern];
+        const keywords = config?.npm_keywords ?? [pattern];
+        const topics = config?.github_topics ?? [pattern];
+        const [npmResults, ghResults] = await Promise.all([
+            searchNpmRegistry(keywords),
+            searchGitHubTopics(topics),
+        ]);
+        const ranked = rankResults(npmResults, ghResults, _stackLanguage);
+        cacheUpdated[pattern] = { results: ranked, cachedAt: new Date().toISOString() };
+        return ranked;
+    }));
+    await writeCache(dataDir, cacheUpdated);
+    const merged = allResults.flat();
+    const seen = new Set();
+    const deduped = merged.filter((tool) => {
+        if (seen.has(tool.name)) {
+            return false;
+        }
+        seen.add(tool.name);
+        return true;
+    });
+    return rankResults(deduped, [], _stackLanguage);
+}
+//# sourceMappingURL=tech-discovery.js.map

package/dist/engine/discovery/tech-discovery.js.map

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

package/dist/engine/token-optimizer/analytics.d.ts

@@ -0,0 +1,10 @@
+import type { LedgerEntry, LedgerAggregation, BudgetConfig, LedgerBudgetStatus, DailyBreakdown, TrendResult, Anomaly, TopConsumer, OptimizationSavings } from '../../types/index.js';
+export type { DailyBreakdown, TrendResult, Anomaly, TopConsumer, OptimizationSavings };
+export declare function aggregateEntries(entries: LedgerEntry[]): LedgerAggregation;
+export declare function computeDailyBreakdown(entries: LedgerEntry[]): DailyBreakdown[];
+export declare function detectTrend(dailyBreakdown: DailyBreakdown[]): TrendResult;
+export declare function detectAnomalies(entries: LedgerEntry[], dailyBreakdown: DailyBreakdown[]): Anomaly[];
+export declare function computeBudgetStatus(entries: LedgerEntry[], config: BudgetConfig): LedgerBudgetStatus;
+export declare function getTopConsumers(entries: LedgerEntry[], limit?: number): TopConsumer[];
+export declare function computeOptimizationSavings(entries: LedgerEntry[]): OptimizationSavings;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/engine/token-optimizer/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../src/engine/token-optimizer/analytics.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,OAAO,EACP,WAAW,EACX,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;AAoGvF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,iBAAiB,CAuE1E;AAMD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,CA2B9E;AAMD,wBAAgB,WAAW,CAAC,cAAc,EAAE,cAAc,EAAE,GAAG,WAAW,CAuCzE;AAMD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EAAE,EACtB,cAAc,EAAE,cAAc,EAAE,GAC/B,OAAO,EAAE,CAyDX;AAMD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EAAE,EACtB,MAAM,EAAE,YAAY,GACnB,kBAAkB,CAgDpB;AAMD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,GAAE,MAAoC,GAC1C,WAAW,EAAE,CAsBf;AAMD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,mBAAmB,CAkCtF"}