@tangle-network/starter-foundry 0.1.0

package/dist/lib/fatten.js

@@ -0,0 +1,110 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { readJson } from './fs.js';
+function run(command, cwd, timeoutMs = 120000) {
+    return new Promise((resolve) => {
+        const child = spawn('sh', ['-c', command], { cwd, stdio: ['ignore', 'pipe', 'pipe'] });
+        let stdout = '';
+        let stderr = '';
+        const timer = setTimeout(() => { child.kill('SIGTERM'); resolve({ ok: false, stdout, stderr: `${stderr}\ntimeout after ${timeoutMs}ms` }); }, timeoutMs);
+        child.stdout?.on('data', (chunk) => { stdout += chunk.toString(); });
+        child.stderr?.on('data', (chunk) => { stderr += chunk.toString(); });
+        child.on('close', (code) => { clearTimeout(timer); resolve({ ok: code === 0, stdout, stderr }); });
+        child.on('error', (err) => { clearTimeout(timer); resolve({ ok: false, stdout, stderr: err.message }); });
+    });
+}
+/**
+ * Fatten a composed scaffold directory by installing dependencies,
+ * pre-bundling Vite, and optionally pre-building.
+ *
+ * After fattening, the directory contains node_modules/, .vite/ cache,
+ * and optionally dist/ or .next/. A tarball of this directory lets the
+ * dev server start instantly in the container.
+ *
+ * This is an OFFLINE operation — runs during scaffold publishing, not
+ * in the user's hot path.
+ */
+export async function fattenStarter(outDir) {
+    const start = performance.now();
+    const result = {
+        outDir,
+        hadDeps: false,
+        installed: false,
+        vitePrebundled: false,
+        built: false,
+        durationMs: 0,
+    };
+    // Check if there's a package.json with dependencies
+    const pkgPath = path.join(outDir, 'package.json');
+    try {
+        const pkg = await readJson(pkgPath);
+        const depCount = Object.keys(pkg.dependencies ?? {}).length + Object.keys(pkg.devDependencies ?? {}).length;
+        result.hadDeps = depCount > 0;
+    }
+    catch {
+        result.durationMs = Math.round(performance.now() - start);
+        return result;
+    }
+    if (!result.hadDeps) {
+        result.durationMs = Math.round(performance.now() - start);
+        return result;
+    }
+    // Step 1: Install dependencies
+    const install = await run('pnpm install --frozen-lockfile 2>/dev/null || pnpm install --no-frozen-lockfile', outDir);
+    result.installed = install.ok;
+    if (!result.installed) {
+        result.durationMs = Math.round(performance.now() - start);
+        return result;
+    }
+    // Step 2: Pre-bundle Vite dependencies (creates node_modules/.vite/)
+    const hasViteConfig = await fs.access(path.join(outDir, 'vite.config.ts')).then(() => true).catch(() => false)
+        || await fs.access(path.join(outDir, 'vite.config.js')).then(() => true).catch(() => false);
+    if (hasViteConfig) {
+        const viteOptimize = await run('npx vite optimize', outDir, 30000);
+        result.vitePrebundled = viteOptimize.ok;
+    }
+    // Step 3: Pre-build (creates dist/ or .next/)
+    const hasNextConfig = await fs.access(path.join(outDir, 'next.config.ts')).then(() => true).catch(() => false)
+        || await fs.access(path.join(outDir, 'next.config.js')).then(() => true).catch(() => false)
+        || await fs.access(path.join(outDir, 'next.config.mjs')).then(() => true).catch(() => false);
+    if (hasNextConfig) {
+        const build = await run('npx next build', outDir, 60000);
+        result.built = build.ok;
+    }
+    else if (hasViteConfig) {
+        const build = await run('npx vite build', outDir, 30000);
+        result.built = build.ok;
+    }
+    result.durationMs = Math.round(performance.now() - start);
+    return result;
+}
+/**
+ * Fatten a composed workspace directory. Finds all sub-projects with
+ * package.json and fattens each one independently.
+ */
+export async function fattenWorkspace(outDir) {
+    const start = performance.now();
+    const projects = [];
+    // Check for workspace report to find project paths
+    const reportPath = path.join(outDir, '.starter-foundry', 'workspace-report.json');
+    try {
+        const report = await readJson(reportPath);
+        for (const project of report.projects) {
+            const projectDir = path.join(outDir, project.path);
+            const result = await fattenStarter(projectDir);
+            projects.push({ path: project.path, result });
+        }
+    }
+    catch {
+        // No workspace report — try fattening the root directory
+        const result = await fattenStarter(outDir);
+        projects.push({ path: '.', result });
+    }
+    return {
+        outDir,
+        projects,
+        durationMs: Math.round(performance.now() - start),
+    };
+}
+//# sourceMappingURL=fatten.js.map

package/dist/lib/fatten.js.map

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

package/dist/lib/fs.d.ts

@@ -0,0 +1,9 @@
+export declare function ensureDir(dirPath: string): Promise<void>;
+export declare function writeJson(filePath: string, value: unknown): Promise<void>;
+export declare function readJson<T = unknown>(filePath: string): Promise<T>;
+export declare function resolveRepoRoot(): Promise<string>;
+export declare function createTempDir(prefix: string): Promise<string>;
+export declare function removeDir(dirPath: string): Promise<void>;
+export declare function sanitizePackageName(name: string): string;
+export declare function fileExists(filePath: string): Promise<boolean>;
+export declare function listFilesRecursive(rootDir: string): Promise<string[]>;

package/dist/lib/fs.js

@@ -0,0 +1,87 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+export async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+export async function writeJson(filePath, value) {
+    await ensureDir(path.dirname(filePath));
+    await fs.writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+}
+export async function readJson(filePath) {
+    const raw = await fs.readFile(filePath, 'utf8');
+    return JSON.parse(raw);
+}
+export async function resolveRepoRoot() {
+    // Resolve from import.meta.url, handling Vite's /@fs/ prefix and URL mangling
+    let modulePath;
+    try {
+        const url = new URL(import.meta.url);
+        modulePath = url.protocol === 'file:' ? url.pathname : import.meta.url;
+    }
+    catch {
+        modulePath = import.meta.url;
+    }
+    // Strip Vite's /@fs/ prefix
+    if (modulePath.startsWith('/@fs/'))
+        modulePath = modulePath.slice(4);
+    // On Windows, strip leading slash from /C:/...
+    if (/^\/[A-Z]:/.test(modulePath))
+        modulePath = modulePath.slice(1);
+    // Walk up from the module file to find the directory containing registry/
+    let dir = path.dirname(path.resolve(modulePath));
+    for (let i = 0; i < 10; i++) {
+        try {
+            const registryPath = path.join(dir, 'registry');
+            const stat = await fs.stat(registryPath);
+            if (stat.isDirectory())
+                return dir;
+        }
+        catch { /* continue walking up */ }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Fallback: standard ../../ resolution
+    return path.resolve(path.dirname(modulePath), '..', '..');
+}
+export async function createTempDir(prefix) {
+    return fs.mkdtemp(path.join(os.tmpdir(), `${prefix}-`));
+}
+export async function removeDir(dirPath) {
+    await fs.rm(dirPath, { recursive: true, force: true });
+}
+export function sanitizePackageName(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 64);
+}
+export async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function listFilesRecursive(rootDir) {
+    const results = [];
+    async function walk(currentDir) {
+        const entries = await fs.readdir(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const absolutePath = path.join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(absolutePath);
+                continue;
+            }
+            results.push(path.relative(rootDir, absolutePath));
+        }
+    }
+    await walk(rootDir);
+    return results.sort();
+}
+//# sourceMappingURL=fs.js.map

package/dist/lib/fs.js.map

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

package/dist/lib/index.d.ts

@@ -0,0 +1,16 @@
+export { planPrompt } from './prompt-planner.js';
+export { composeStarter } from './compose.js';
+export { createContextPack } from './context-pack.js';
+export { generateBuildPlan } from './build-plan.js';
+export { loadRegistry, resolveComponents, clearRegistryCache, initSemanticRouting } from './registry.js';
+export { semanticMatch, isSemanticRouterReady } from './semantic-router.js';
+export { selectStarter } from './selection.js';
+export { validateStarter } from './validate.js';
+export { benchmarkStarter } from './benchmark.js';
+export { composeWorkspace, createWorkspaceContextPack, benchmarkWorkspace } from './workspace.js';
+export { augmentWithLayer } from './augment.js';
+export { fattenStarter, fattenWorkspace } from './fatten.js';
+export { matchesKeyword, hasAny, detectLane, detectCapabilities } from './keywords.js';
+export { on, off, emit, traced } from './telemetry.js';
+export type { RouteEvent, ComposeEvent, CapabilityEvent } from './telemetry.js';
+export type { ComposeSpec, WorkspaceSpec, PromptPlan, StarterPromptPlan, WorkspacePromptPlan, SelectionResult, ComposeResult, ValidationResult, BenchmarkReport, ContextPack, BuildPlan, BuildHints, Registry, FamilyManifest, LayerManifest, PartnerManifest, } from '../types.js';

package/dist/lib/index.js

@@ -0,0 +1,16 @@
+// Public API — import from 'starter-foundry'
+export { planPrompt } from './prompt-planner.js';
+export { composeStarter } from './compose.js';
+export { createContextPack } from './context-pack.js';
+export { generateBuildPlan } from './build-plan.js';
+export { loadRegistry, resolveComponents, clearRegistryCache, initSemanticRouting } from './registry.js';
+export { semanticMatch, isSemanticRouterReady } from './semantic-router.js';
+export { selectStarter } from './selection.js';
+export { validateStarter } from './validate.js';
+export { benchmarkStarter } from './benchmark.js';
+export { composeWorkspace, createWorkspaceContextPack, benchmarkWorkspace } from './workspace.js';
+export { augmentWithLayer } from './augment.js';
+export { fattenStarter, fattenWorkspace } from './fatten.js';
+export { matchesKeyword, hasAny, detectLane, detectCapabilities } from './keywords.js';
+export { on, off, emit, traced } from './telemetry.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACxG,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACtF,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/lib/keywords.d.ts

@@ -0,0 +1,29 @@
+export declare function matchesKeyword(text: string, keyword: string): boolean;
+/**
+ * Fuzzy keyword scoring — ONLY used as a fallback when exact matching produces zero hits.
+ * Scores each keyword with Levenshtein distance ≤ 1 against words in the text.
+ * Requires keywords of 5+ characters to avoid short-word collisions.
+ */
+export declare function fuzzyKeywordScore(text: string, keywords: string[]): number;
+export declare function hasAny(text: string, keywords: string[]): boolean;
+export declare function countMatches(text: string, keywords: string[]): number;
+export declare function keywordScore(prompt: string, keywords: string[]): number;
+export interface LaneRoute {
+    id: string;
+    keywords: string[];
+}
+export declare const LANE_ROUTES: LaneRoute[];
+/**
+ * Returns true if `text` matches the keyword list for the given lane id.
+ * The `agent` lane is false when `mcp` or `dspy` also matches (they take priority).
+ */
+export declare function detectLane(text: string, id: string): boolean;
+/** Returns the keyword list for a lane, or empty array if unknown. */
+export declare function getLaneKeywords(id: string): string[];
+import type { Registry } from '../types.js';
+/**
+ * Detect capability layers from registry manifests. Each capability manifest
+ * declares its own `keywords` and `appliesTo` — no parallel source arrays needed.
+ * Adding a new capability = one manifest.json file.
+ */
+export declare function detectCapabilities(text: string, family: string, registry: Registry): string[];

package/dist/lib/keywords.js

@@ -0,0 +1,377 @@
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Levenshtein distance between two strings. */
+function levenshtein(a, b) {
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    const matrix = [];
+    for (let i = 0; i <= b.length; i++)
+        matrix[i] = [i];
+    for (let j = 0; j <= a.length; j++)
+        matrix[0][j] = j;
+    for (let i = 1; i <= b.length; i++) {
+        for (let j = 1; j <= a.length; j++) {
+            const cost = b[i - 1] === a[j - 1] ? 0 : 1;
+            matrix[i][j] = Math.min(matrix[i - 1][j] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j - 1] + cost);
+        }
+    }
+    return matrix[b.length][a.length];
+}
+/**
+ * Check if any word in the text fuzzy-matches the keyword (Levenshtein ≤ maxDist).
+ * Only applies to single-word keywords of 4+ characters to avoid false positives
+ * on short words like "go", "api", "ui".
+ */
+function fuzzyMatchesWord(text, keyword, maxDist = 2) {
+    if (keyword.length < 4)
+        return false;
+    const words = text.split(/\s+/);
+    for (const word of words) {
+        if (word.length < 3)
+            continue;
+        if (Math.abs(word.length - keyword.length) > maxDist)
+            continue;
+        if (levenshtein(word, keyword) <= maxDist)
+            return true;
+    }
+    return false;
+}
+export function matchesKeyword(text, keyword) {
+    const normalizedText = text.toLowerCase();
+    const normalizedKeyword = keyword.toLowerCase();
+    if (normalizedKeyword.includes(' ') ||
+        normalizedKeyword.includes('.') ||
+        normalizedKeyword.includes('/') ||
+        normalizedKeyword.includes('-')) {
+        return normalizedText.includes(normalizedKeyword);
+    }
+    return new RegExp(`\\b${escapeRegex(normalizedKeyword)}\\b`, 'i').test(normalizedText);
+}
+/**
+ * Fuzzy keyword scoring — ONLY used as a fallback when exact matching produces zero hits.
+ * Scores each keyword with Levenshtein distance ≤ 1 against words in the text.
+ * Requires keywords of 5+ characters to avoid short-word collisions.
+ */
+export function fuzzyKeywordScore(text, keywords) {
+    const lower = text.toLowerCase();
+    return keywords.reduce((total, keyword) => {
+        const k = keyword.toLowerCase();
+        if (k.length < 5)
+            return total;
+        if (k.includes(' ') || k.includes('.') || k.includes('/') || k.includes('-'))
+            return total;
+        return total + (fuzzyMatchesWord(lower, k, 1) ? 1 : 0);
+    }, 0);
+}
+export function hasAny(text, keywords) {
+    return keywords.some((keyword) => matchesKeyword(text, keyword));
+}
+export function countMatches(text, keywords) {
+    return keywords.reduce((total, keyword) => total + (matchesKeyword(text, keyword) ? 1 : 0), 0);
+}
+export function keywordScore(prompt, keywords) {
+    return keywords.reduce((total, keyword) => total + (matchesKeyword(prompt, keyword) ? 1 : 0), 0);
+}
+export const LANE_ROUTES = [
+    {
+        id: 'tangle',
+        keywords: [
+            'tangle blueprint',
+            'blueprint sdk',
+            'cargo tangle',
+            'oracle blueprint',
+            'storage blueprint',
+            'blueprint for tangle',
+            'tangle network',
+            'using tangle',
+            "tangle's",
+            'tangle native',
+            'frost blueprint',
+            'tangle oracle',
+            'tangle custody',
+        ],
+    },
+    {
+        id: 'avs',
+        keywords: ['eigenlayer', 'avs', 'oracle avs', 'keeper avs', 'sequencer avs', 'coprocessor avs'],
+    },
+    {
+        id: 'stylus',
+        keywords: ['stylus', 'arbitrum stylus'],
+    },
+    {
+        id: 'zk',
+        keywords: [
+            'risc zero',
+            'sp1',
+            'circom',
+            'snarkjs',
+            'zk prover',
+            'verifiable ml',
+            'private voting',
+            'dark pool',
+            'mixer',
+        ],
+    },
+    {
+        id: 'mcp',
+        keywords: ['model context protocol', 'mcp server', 'mcp tools', 'mcp tool server'],
+    },
+    {
+        id: 'dspy',
+        keywords: ['dspy', 'rag system', 'summarization system', 'text classification system', 'prompt engineering'],
+    },
+    {
+        id: 'agent',
+        // agent is explicitly excluded when mcp or dspy is present (they are more specific)
+        keywords: [
+            // generic agent terms
+            'ai agent',
+            'agent runtime',
+            'agent service',
+            'agent backend',
+            'multi-agent',
+            'multi agent',
+            'autonomous agent',
+            'assistant runtime',
+            'chatbot',
+            'chat bot',
+            'ai assistant',
+            'ai copilot',
+            'rag',
+            'retrieval augmented',
+            'ai that can',
+            'ai that answers',
+            'ai to answer',
+            'ai to search',
+            // domain agent patterns — catch "X agent" and "X bot" for AI use cases
+            'support agent',
+            'support bot',
+            'slack bot',
+            'slack agent',
+            'github bot',
+            'github agent',
+            'trading agent',
+            'code review agent',
+            'code agent',
+            'data agent',
+            'data analysis agent',
+            'data analyst agent',
+            'research agent',
+            'research bot',
+            'email agent',
+            'scheduling agent',
+            'sales agent',
+            'recruitment agent',
+            'onboarding agent',
+            'fine-tuning',
+            'fine tuning',
+            'finetune',
+            'unsloth',
+            'train a model',
+            'modal gpu',
+            'hermes agent',
+            'hermes function calling',
+            'openclaw agent',
+            'function-calling agent',
+            'function calling agent',
+            'langchain',
+            'autogpt',
+            'auto-gpt',
+            'ai copilot',
+            'copilot',
+            'ai that writes',
+            'ai receptionist',
+            'custom gpt',
+            'ai writer',
+            'content generator',
+            // frameworks
+            'langgraph',
+            'mastra',
+            'openai agents',
+            'openai agents sdk',
+            'anthropic sdk',
+            'claude sdk',
+            'crewai',
+            'autogen',
+            'pydanticai',
+            'agno',
+            'llamaindex',
+            'agentkit',
+            'tool-calling agent',
+            'tool calling agent',
+            // voice agent patterns
+            'voice agent',
+            'voice bot',
+            'phone agent',
+            'call center ai',
+            // browser agent patterns
+            'browser agent',
+            'browser use',
+            'computer use',
+            'web agent',
+        ],
+    },
+    {
+        id: 'fhenix',
+        keywords: ['fhenix', 'cofhe', 'cofhejs', 'fhenix network', 'inco'],
+    },
+    {
+        id: 'fhevm',
+        keywords: ['fhevm', 'zama', 'zama fhe', 'tfhe contract', 'fhevm contract', 'confidential erc20'],
+    },
+    {
+        id: 'fhe',
+        keywords: ['fhe', 'fully homomorphic', 'encrypted computation', 'euint', 'encrypted auction', 'encrypted voting', 'private token'],
+    },
+    {
+        id: 'x402',
+        keywords: ['x402', 'micropayments', 'pay-per-request', 'monetized api'],
+    },
+    {
+        id: 'evm-infra',
+        keywords: [
+            'viem',
+            'ethers',
+            'rpc',
+            'block monitor',
+            'gas price',
+            'transaction count',
+            'multicall',
+            'wallet balance',
+            'wallet balances',
+            'stats json endpoint',
+            'layerzero',
+            'oft',
+            'sendtokens',
+            'bundler',
+            'permissionless.js',
+            'monitor x layer',
+            'monitor ethereum',
+            'monitor arbitrum',
+            'okb',
+            'oklink',
+            'okx',
+        ],
+    },
+    {
+        id: 'evm',
+        keywords: [
+            'solidity',
+            'foundry',
+            'forge',
+            'erc20',
+            'erc-20',
+            'erc721',
+            'erc-721',
+            'erc-4337',
+            'erc4337',
+            'evm',
+            'ethereum',
+            'arbitrum',
+            'base network',
+            'base mainnet',
+            'polygon',
+            'x layer',
+            'xlayer',
+            'layerzero',
+            'chainlink',
+            'walletconnect',
+            'flashbots',
+            'flash loan',
+            'aave',
+            'uniswap',
+            'sushiswap',
+            'curve',
+            'convex',
+            'reservoir api',
+            'marketplace core',
+            'auction house',
+            'lendingpool',
+            'cover manager',
+            'wallet factory',
+            'bonding curve',
+            'gateway',
+            'erc-4626',
+            'erc4626',
+            'vault',
+            'bridge protocol',
+            'cross-chain',
+            'lending protocol',
+            'borrowing protocol',
+            'dex protocol',
+            'amm',
+            'perpetual futures',
+            'perps protocol',
+            'restaking',
+            'shared security',
+            'funding rate',
+            'margin trading',
+            'gmx',
+            'hyperliquid',
+            'symbiotic',
+            'karak',
+            'erc-1155',
+            'erc1155',
+            'dao',
+            'governance',
+            'multisig',
+            'multi-sig',
+            'gnosis safe',
+            'dex aggregator',
+            '1inch',
+            'nft contract',
+            'deploy a token',
+            'create a token',
+            'token on base',
+            'memecoin',
+            'meme coin',
+            'pump.fun',
+            'token launcher',
+            'defi',
+            'smart contract',
+        ],
+    },
+];
+/**
+ * Returns true if `text` matches the keyword list for the given lane id.
+ * The `agent` lane is false when `mcp` or `dspy` also matches (they take priority).
+ */
+export function detectLane(text, id) {
+    const route = LANE_ROUTES.find((r) => r.id === id);
+    if (!route)
+        return false;
+    if (!hasAny(text, route.keywords))
+        return false;
+    if (id === 'agent')
+        return !detectLane(text, 'mcp') && !detectLane(text, 'dspy');
+    return true;
+}
+/** Returns the keyword list for a lane, or empty array if unknown. */
+export function getLaneKeywords(id) {
+    return LANE_ROUTES.find((r) => r.id === id)?.keywords ?? [];
+}
+/**
+ * Detect capability layers from registry manifests. Each capability manifest
+ * declares its own `keywords` and `appliesTo` — no parallel source arrays needed.
+ * Adding a new capability = one manifest.json file.
+ */
+export function detectCapabilities(text, family, registry) {
+    const results = [];
+    for (const [key, layer] of registry.layers) {
+        if (layer.group !== 'capability')
+            continue;
+        if (!layer.keywords?.length)
+            continue;
+        if (!layer.appliesTo?.includes(family))
+            continue;
+        if (hasAny(text, layer.keywords)) {
+            results.push(key);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=keywords.js.map