@tangle-network/starter-foundry 0.7.3 → 0.13.2

package/dist/lib/prompt-planner.js

@@ -1,16 +1,42 @@
-import { emit, traced } from './telemetry.js';
-import { loadRegistry } from './registry.js';
-import { selectStarter } from './selection.js';
-import { detectCapabilities, detectIndustry, detectLane, hasAny } from './keywords.js';
-import { rewritePrompt, rewriteViaBrief } from './prompt-rewriter.js';
-import { API_SIGNALS, EXPLICIT_WORKER_SIGNALS, FRAMEWORK_API_TERMS, FRONTEND_SIGNALS, FULLSTACK_SIGNALS, REACT_FAMILIES, SINGLE_LANE_SIGNALS, STRONG_API_TERMS, WORKER_SIGNALS, WORKSPACE_SIGNALS, } from './planner/signals.js';
-import { detectAuthSlot, detectDatabaseSlot, detectEvmSupportApiPattern, detectHardhatExplicit, detectPaymentsSlot, detectQueueSlot, detectSdkSlot, detectSolanaProductApiPattern, detectSolanaWorkerPattern, detectTangleCustodyPattern, detectTangleOraclePattern, inferPartner, needsSupportApiLane, } from './planner/detectors.js';
+import { detectDomainPackAmbiguity, scoreDomainPackFamilies } from './domain-packs.js';
+import { detectCapabilities, detectIndustry, detectLane, hasAny, } from './keywords.js';
 import { buildEvmContractLayers, buildEvmContractVariables, buildSolanaProgramLayers, buildSolanaProgramVariables, } from './planner/contracts.js';
+import { detectAuthSlot, detectDatabaseSlot, detectEvmSupportApiPattern, detectHardhatExplicit, detectPaymentsSlot, detectQueueSlot, detectSdkSlot, detectSolanaProductApiPattern, detectSolanaWorkerPattern, detectTangleCustodyPattern, detectTangleOraclePattern, inferPartner, needsSupportApiLane, } from './planner/detectors.js';
+import { hasEvmDomainPackSupportApiSurface } from './planner/domain-pack-signals.js';
 import { buildSlug, resolvePartnerForFamily } from './planner/helpers.js';
 import { inferImplicitCapabilities } from './planner/implicit-caps.js';
 import { shouldPromotePartnerFirst } from './planner/partner-first.js';
-import { buildApiProject, buildWebProject, buildWorkerProject, chooseApiFamily } from './planner/projects.js';
-function detectLanes(text, partner) {
+import { buildApiProject, buildWebProject, buildWorkerProject, chooseApiFamily, } from './planner/projects.js';
+import { API_SIGNALS, CONTRACT_SURFACE_SIGNALS, EXPLICIT_WORKER_SIGNALS, FRAMEWORK_API_TERMS, FRONTEND_SIGNALS, FULLSTACK_SIGNALS, REACT_FAMILIES, SINGLE_LANE_SIGNALS, STRONG_API_TERMS, WORKER_SIGNALS, WORKSPACE_SIGNALS, } from './planner/signals.js';
+import { rewritePrompt, rewriteViaBrief } from './prompt-rewriter.js';
+import { loadRegistry } from './registry.js';
+import { selectStarter } from './selection.js';
+import { emit, traced } from './telemetry.js';
+const NON_CONTRACT_SURFACE_SIGNALS = [
+    ...FRONTEND_SIGNALS,
+    ...API_SIGNALS,
+    ...WORKER_SIGNALS,
+    ...FRAMEWORK_API_TERMS,
+];
+function hasContractSurfaceIntent(text) {
+    return hasAny(text, CONTRACT_SURFACE_SIGNALS);
+}
+function hasCompetingNonContractSurfaceIntent(text) {
+    return hasAny(text, NON_CONTRACT_SURFACE_SIGNALS);
+}
+function hasDomainAuthenticityEvidence(match) {
+    return match.reasons.some((reason) => reason.startsWith('authenticity-signals:'));
+}
+function layerContractMatchIsSpecificEnough(text, match) {
+    if (!match.layers?.length)
+        return true;
+    if (hasContractSurfaceIntent(text))
+        return true;
+    if (hasCompetingNonContractSurfaceIntent(text))
+        return false;
+    return hasDomainAuthenticityEvidence(match);
+}
+function detectLanes(prompt, text, partner, registry) {
     const hasApiRaw = hasAny(text, API_SIGNALS);
     const apiIsFalsePositive = hasApiRaw && !hasAny(text, STRONG_API_TERMS) && hasAny(text, FRAMEWORK_API_TERMS);
     const api = hasApiRaw && !apiIsFalsePositive;
@@ -23,44 +49,119 @@ function detectLanes(text, partner) {
     const move = hasAny(text, ['move', 'aptos', 'sui']);
     const tangle = detectLane(text, 'tangle');
     const avs = detectLane(text, 'avs');
-    const stylus = detectLane(text, 'stylus');
+    const domainContract = selectDomainContractFamily(prompt, partner, registry, { includeLayerMatches: true }) !== null;
     const zk = detectLane(text, 'zk');
     const mcp = detectLane(text, 'mcp');
     const dspy = detectLane(text, 'dspy');
     const x402 = detectLane(text, 'x402');
     const evmInfra = detectLane(text, 'evm-infra');
-    const hasProtocol = evm || solana || tangle || avs || stylus || evmInfra;
-    const commerceSupportApi = !api && frontend && needsSupportApiLane(text) &&
-        (partner === 'coinbase' || detectPaymentsSlot(text) !== null || detectSdkSlot(text, partner) !== null) &&
-        hasAny(text, ['api', 'backend', 'server', 'endpoint', 'webhook', 'order management', 'order history', 'payment webhook', 'indexer', 'transaction history']);
+    const domainPackSupportApi = hasEvmDomainPackSupportApiSurface({ prompt, partner, registry });
+    const hasProtocol = evm || solana || tangle || avs || domainContract || evmInfra;
+    const commerceSupportApi = !api &&
+        frontend &&
+        needsSupportApiLane(text) &&
+        (partner === 'coinbase' ||
+            detectPaymentsSlot(text) !== null ||
+            detectSdkSlot(text, partner) !== null) &&
+        hasAny(text, [
+            'api',
+            'backend',
+            'server',
+            'endpoint',
+            'webhook',
+            'order management',
+            'order history',
+            'payment webhook',
+            'indexer',
+            'transaction history',
+        ]);
     const implicitApi = !api &&
-        ((hasProtocol && (needsSupportApiLane(text) || detectEvmSupportApiPattern(text) || (solana && detectSolanaProductApiPattern(text)))) ||
+        ((hasProtocol &&
+            (needsSupportApiLane(text) ||
+                detectEvmSupportApiPattern(text) ||
+                domainPackSupportApi ||
+                (solana && detectSolanaProductApiPattern(text)))) ||
             commerceSupportApi);
     const implicitWorker = !worker &&
         ((solana && detectSolanaWorkerPattern(text)) ||
             (evm && hasAny(text, ['keeper', 'bundler'])) ||
             (x402 && agentLane));
     return {
-        frontend, api, worker, evm, solana, move, tangle, avs, stylus,
-        zk, mcp, dspy, agent: agentLane, x402, evmInfra, implicitApi, implicitWorker,
+        frontend,
+        api,
+        worker,
+        evm,
+        solana,
+        move,
+        tangle,
+        avs,
+        domainContract,
+        zk,
+        mcp,
+        dspy,
+        agent: agentLane,
+        x402,
+        evmInfra,
+        implicitApi,
+        implicitWorker,
     };
 }
 function shouldBeWorkspace(lanes, text, partner) {
     if (hasAny(text, SINGLE_LANE_SIGNALS))
         return false;
-    const { frontend, api, worker, evm, solana, move, tangle, avs, stylus, zk, mcp, dspy, agent, x402, evmInfra, implicitApi, implicitWorker } = lanes;
+    const { frontend, api, worker, evm, solana, move, tangle, avs, domainContract, zk, mcp, dspy, agent, x402, evmInfra, implicitApi, implicitWorker, } = lanes;
     const runtimeCount = [evm, solana, move].filter(Boolean).length;
-    const protocolLanes = [tangle, avs, stylus, zk, mcp, dspy, x402];
+    const protocolLanes = [tangle, avs, domainContract, zk, mcp, dspy, x402];
     // Plain agent/protocol without other surfaces → single starter
-    const onlyAgent = agent && !frontend && !worker && !evm && !solana && !move && !protocolLanes.some(Boolean) && !evmInfra;
+    const onlyAgent = agent &&
+        !frontend &&
+        !worker &&
+        !evm &&
+        !solana &&
+        !move &&
+        !protocolLanes.some(Boolean) &&
+        !evmInfra;
     const onlyProtocol = !frontend && !api && !worker && !agent && protocolLanes.some(Boolean);
     if (onlyAgent || onlyProtocol)
         return false;
     // Fullstack (frontend + api, no other lanes) → single fullstack-ts starter
-    const noSpecialLanes = !worker && !evm && !solana && !move && !tangle && !avs && !stylus && !zk && !mcp && !dspy && !agent && !x402 && !evmInfra;
-    if (noSpecialLanes && frontend && api && !hasAny(text, WORKSPACE_SIGNALS) && hasAny(text, FULLSTACK_SIGNALS))
+    const noSpecialLanes = !worker &&
+        !evm &&
+        !solana &&
+        !move &&
+        !tangle &&
+        !avs &&
+        !domainContract &&
+        !zk &&
+        !mcp &&
+        !dspy &&
+        !agent &&
+        !x402 &&
+        !evmInfra;
+    if (noSpecialLanes &&
+        frontend &&
+        api &&
+        !hasAny(text, WORKSPACE_SIGNALS) &&
+        hasAny(text, FULLSTACK_SIGNALS))
         return false;
-    const laneCount = [frontend, api, worker, evm, solana, move, tangle, avs, stylus, zk, mcp, dspy, agent, x402, evmInfra, implicitApi].filter(Boolean).length;
+    const laneCount = [
+        frontend,
+        api,
+        worker,
+        evm,
+        solana,
+        move,
+        tangle,
+        avs,
+        domainContract,
+        zk,
+        mcp,
+        dspy,
+        agent,
+        x402,
+        evmInfra,
+        implicitApi,
+    ].filter(Boolean).length;
     const apiChoice = api ? chooseApiFamily(text) : null;
     return (runtimeCount > 1 ||
         (frontend && runtimeCount > 0) ||
@@ -70,23 +171,71 @@ function shouldBeWorkspace(lanes, text, partner) {
         (frontend && agent) ||
         (frontend && api && apiChoice !== null && apiChoice.family !== 'api-service') ||
         (frontend && implicitApi) ||
-        (implicitApi && (evm || solana || move || tangle || avs || stylus)) ||
+        (implicitApi && (evm || solana || move || tangle || avs || domainContract)) ||
         implicitWorker ||
         (hasAny(text, WORKSPACE_SIGNALS) && laneCount > 1));
 }
 function buildProtocolProject(id, path, family, layers, prompt, partner, variables) {
     return {
-        id, path,
+        id,
+        path,
         spec: {
             projectName: `${buildSlug(prompt, 'workspace')}-${id}`,
-            family, layers,
+            family,
+            layers,
             partner: resolvePartnerForFamily(partner, family),
             slots: {},
             variables,
         },
     };
 }
-function collectProtocolProjects(lanes, prompt, partner, text) {
+function frameworkLayersForFamily(registry, familyId) {
+    const layers = [];
+    for (const [key, layer] of registry.layers) {
+        if (layer.group === 'framework' && layer.appliesTo?.includes(familyId))
+            layers.push(key);
+    }
+    return layers;
+}
+function selectDomainContractFamily(prompt, partner, registry, options = {}) {
+    const text = prompt.toLowerCase();
+    const includeLayerMatches = options.includeLayerMatches ?? true;
+    const hardhatExplicit = detectHardhatExplicit(text);
+    const matches = scoreDomainPackFamilies({ prompt, partner, registry });
+    const ambiguity = detectDomainPackAmbiguity(matches);
+    for (const match of matches) {
+        if (!includeLayerMatches && match.layers?.length)
+            continue;
+        if (ambiguity?.families.includes(match.family))
+            continue;
+        const family = registry.families.get(match.family);
+        if (family?.taxonomy?.surface !== 'contracts')
+            continue;
+        if (!layerContractMatchIsSpecificEnough(text, match))
+            continue;
+        const runtime = family.domainPack?.domain.runtime ?? family.taxonomy.runtime;
+        if (hardhatExplicit && runtime !== 'hardhat')
+            continue;
+        const layers = [
+            ...new Set([...frameworkLayersForFamily(registry, match.family), ...(match.layers ?? [])]),
+        ];
+        return { family: match.family, layers, taxonomy: family.taxonomy };
+    }
+    return null;
+}
+function contractProjectIdentity(choice, family) {
+    if (family.taxonomy?.language === 'solidity')
+        return { id: 'evm', path: 'contracts/evm' };
+    const id = (choice?.taxonomy?.runtime ??
+        choice?.taxonomy?.language ??
+        family.taxonomy?.runtime ??
+        'contract')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'contract';
+    return { id, path: `contracts/${id}` };
+}
+function collectProtocolProjects(lanes, prompt, partner, text, registry) {
     const projects = [];
     if (lanes.tangle) {
         const tangleLayers = ['framework:tangle-blueprint'];
@@ -104,25 +253,48 @@ function collectProtocolProjects(lanes, prompt, partner, text) {
         projects.push(buildProtocolProject('tangle', 'protocols/tangle', 'tangle-blueprint', tangleLayers, prompt, partner, profile));
     }
     if (lanes.avs) {
-        const avsName = text.includes('oracle') ? 'oracle-avs'
-            : text.includes('keeper') ? 'keeper-avs'
-                : text.includes('sequencer') ? 'sequencer-avs'
-                    : text.includes('bridge') ? 'bridge-avs'
+        const avsName = text.includes('oracle')
+            ? 'oracle-avs'
+            : text.includes('keeper')
+                ? 'keeper-avs'
+                : text.includes('sequencer')
+                    ? 'sequencer-avs'
+                    : text.includes('bridge')
+                        ? 'bridge-avs'
                         : 'data-availability-avs';
         projects.push(buildProtocolProject('avs', 'protocols/avs', 'eigenlayer-avs', ['framework:eigenlayer-avs'], prompt, partner, { avsName }));
     }
-    if (lanes.stylus) {
-        projects.push(buildProtocolProject('stylus', 'contracts/stylus', 'stylus-contracts', ['framework:stylus-contracts'], prompt, partner, { contractName: 'StylusPool' }));
-    }
-    if (lanes.evm) {
-        const family = detectHardhatExplicit(text) ? 'hardhat-contracts' : 'forge-contracts';
-        projects.push(buildProtocolProject('evm', 'contracts/evm', family, buildEvmContractLayers(text), prompt, partner, buildEvmContractVariables(text)));
+    if (lanes.evm || lanes.domainContract) {
+        const domainContract = selectDomainContractFamily(prompt, partner, registry);
+        const family = domainContract?.family ??
+            (detectHardhatExplicit(text) ? 'hardhat-contracts' : 'forge-contracts');
+        const familyManifest = registry.families.get(family);
+        if (familyManifest) {
+            const layers = domainContract?.layers ?? buildEvmContractLayers(text);
+            const variables = buildEvmContractVariables(text);
+            if (domainContract && variables.contractName === 'Counter') {
+                delete variables.contractName;
+            }
+            const identity = contractProjectIdentity(domainContract, familyManifest);
+            projects.push(buildProtocolProject(identity.id, identity.path, family, layers, prompt, partner, variables));
+        }
     }
     if (lanes.solana) {
         projects.push(buildProtocolProject('solana', 'contracts/solana', 'solana-program', buildSolanaProgramLayers(text), prompt, partner, buildSolanaProgramVariables(text)));
     }
     if (lanes.move) {
-        projects.push({ id: 'move', path: 'contracts/move', spec: { projectName: 'move_treasury', family: 'move-contracts', layers: ['framework:move-package'], partner: null, slots: {}, variables: { moduleName: 'TreasuryVault' } } });
+        projects.push({
+            id: 'move',
+            path: 'contracts/move',
+            spec: {
+                projectName: 'move_treasury',
+                family: 'move-contracts',
+                layers: ['framework:move-package'],
+                partner: null,
+                slots: {},
+                variables: { moduleName: 'TreasuryVault' },
+            },
+        });
     }
     return projects;
 }
@@ -135,7 +307,19 @@ function collectServiceProjects(lanes, prompt, partner, text, registry) {
         projects.push(buildProtocolProject('ai', 'apps/ai', 'dspy-pipeline-py', ['framework:dspy-pipeline-py'], prompt, null, {}));
     }
     if (lanes.x402 && !lanes.api) {
-        projects.push({ id: 'api', path: 'apps/api', spec: { projectName: `${buildSlug(prompt, 'workspace')}-api`, family: 'x402-service', layers: ['framework:x402-service'], partner: resolvePartnerForFamily(partner, 'x402-service'), slots: {}, variables: {}, primaryArtifactTargetMs: 2500 } });
+        projects.push({
+            id: 'api',
+            path: 'apps/api',
+            spec: {
+                projectName: `${buildSlug(prompt, 'workspace')}-api`,
+                family: 'x402-service',
+                layers: ['framework:x402-service'],
+                partner: resolvePartnerForFamily(partner, 'x402-service'),
+                slots: {},
+                variables: {},
+                primaryArtifactTargetMs: 2500,
+            },
+        });
     }
     if (lanes.zk && !lanes.api) {
         // Dispatch to the specific zkVM family when the prompt names one; fall
@@ -146,7 +330,10 @@ function collectServiceProjects(lanes, prompt, partner, text, registry) {
         let zkFamily = 'zk-prover-service';
         let zkFramework = 'framework:zk-prover-service';
         const zkVars = {};
-        if (text.includes('risc zero') || text.includes('risc0') || text.includes('risczero') || text.includes('bonsai')) {
+        if (text.includes('risc zero') ||
+            text.includes('risc0') ||
+            text.includes('risczero') ||
+            text.includes('bonsai')) {
             zkFamily = 'risczero-zkvm';
             zkFramework = 'framework:risczero-zkvm';
         }
@@ -154,14 +341,16 @@ function collectServiceProjects(lanes, prompt, partner, text, registry) {
             zkFamily = 'sp1-zkvm';
             zkFramework = 'framework:sp1-zkvm';
         }
-        else if (text.includes('arkworks') || text.includes('hand-rolled r1cs') || text.includes('custom snark circuit')) {
+        else if (text.includes('arkworks') ||
+            text.includes('hand-rolled r1cs') ||
+            text.includes('custom snark circuit')) {
             zkFamily = 'arkworks-prover';
             zkFramework = 'framework:arkworks-prover';
         }
         else {
             // Generic fallback — keep the pre-existing proof-system slot logic so
             // the generic scaffold composes with a proofSystem hint.
-            zkVars.proofSystem = text.includes('circom') ? 'circom' : text.includes('fhenix') ? 'fhenix' : 'sp1';
+            zkVars.proofSystem = text.includes('circom') ? 'circom' : 'sp1';
         }
         projects.push(buildProtocolProject('zk', 'apps/prover', zkFamily, [zkFramework], prompt, null, zkVars));
     }
@@ -171,7 +360,7 @@ function collectServiceProjects(lanes, prompt, partner, text, registry) {
     return projects;
 }
 function buildWorkspacePromptPlan({ prompt, partner, text, registry, }) {
-    const lanes = detectLanes(text, partner);
+    const lanes = detectLanes(prompt, text, partner, registry);
     if (!shouldBeWorkspace(lanes, text, partner))
         return null;
     const projects = [];
@@ -182,7 +371,7 @@ function buildWorkspacePromptPlan({ prompt, partner, text, registry, }) {
     if (lanes.worker || lanes.implicitWorker)
         projects.push(buildWorkerProject(prompt, partner, text));
     projects.push(...collectServiceProjects(lanes, prompt, partner, text, registry));
-    projects.push(...collectProtocolProjects(lanes, prompt, partner, text));
+    projects.push(...collectProtocolProjects(lanes, prompt, partner, text, registry));
     const runtimeCount = [lanes.evm, lanes.solana, lanes.move].filter(Boolean).length;
     const primaryProjectId = projects.find((p) => p.id === 'web')?.id ?? projects[0]?.id ?? 'web';
     return {
@@ -216,7 +405,12 @@ export async function planPrompt({ prompt, partner = null, forceKind = null, fam
                 if (key.startsWith('capability:'))
                     knownCapabilities.push(key);
             }
-            const briefResult = await rewriteViaBrief({ prompt, partner, knownFamilies, knownCapabilities });
+            const briefResult = await rewriteViaBrief({
+                prompt,
+                partner,
+                knownFamilies,
+                knownCapabilities,
+            });
             if (briefResult) {
                 const plan = await planPrompt({
                     prompt: briefResult.canonicalPrompt,
@@ -242,7 +436,13 @@ export async function planPrompt({ prompt, partner = null, forceKind = null, fam
             }
             const rewrite = await rewritePrompt({ prompt, partner, knownFamilies, knownCapabilities });
             if (rewrite) {
-                return planPrompt({ prompt: rewrite.canonicalPrompt, partner, forceKind, familyHint, rewriter: false });
+                return planPrompt({
+                    prompt: rewrite.canonicalPrompt,
+                    partner,
+                    forceKind,
+                    familyHint,
+                    rewriter: false,
+                });
             }
         }
     }
@@ -252,7 +452,12 @@ export async function planPrompt({ prompt, partner = null, forceKind = null, fam
         const registry = await loadRegistry();
         // Skip workspace detection when caller knows this is a single project
         if (forceKind !== 'starter') {
-            const workspacePlan = buildWorkspacePromptPlan({ prompt, partner: effectivePartner, text, registry });
+            const workspacePlan = buildWorkspacePromptPlan({
+                prompt,
+                partner: effectivePartner,
+                text,
+                registry,
+            });
             if (workspacePlan) {
                 return workspacePlan;
             }
@@ -277,7 +482,11 @@ export async function planPrompt({ prompt, partner = null, forceKind = null, fam
         //   (3) forceKind === 'starter' callers (scaffold-builder with a
         //       curated family) bypass this branch.
         const PARTNER_FIRST_SURFACES = new Set([
-            'frontend', 'api', 'agent-service', 'fullstack', 'blueprint',
+            'frontend',
+            'api',
+            'agent-service',
+            'fullstack',
+            'blueprint',
         ]);
         if (forceKind !== 'starter' && partner) {
             const partnerMatch = shouldPromotePartnerFirst(partner, registry);
@@ -296,8 +505,18 @@ export async function planPrompt({ prompt, partner = null, forceKind = null, fam
                     frontend: { id: 'web', path: 'apps/web', artifactKind: 'preview', artifactPath: '/' },
                     fullstack: { id: 'web', path: 'apps/web', artifactKind: 'preview', artifactPath: '/' },
                     api: { id: 'api', path: 'apps/api', artifactKind: 'service', artifactPath: '/health' },
-                    'agent-service': { id: 'agent', path: 'apps/agent', artifactKind: 'service', artifactPath: '/health' },
-                    blueprint: { id: 'blueprint', path: 'protocols/tangle', artifactKind: 'service', artifactPath: '/health' },
+                    'agent-service': {
+                        id: 'agent',
+                        path: 'apps/agent',
+                        artifactKind: 'service',
+                        artifactPath: '/health',
+                    },
+                    blueprint: {
+                        id: 'blueprint',
+                        path: 'protocols/tangle',
+                        artifactKind: 'service',
+                        artifactPath: '/health',
+                    },
                 };
                 const cfg = surfaceConfig[partnerMatch.surface] ?? surfaceConfig.frontend;
                 const wrapped = {
@@ -353,6 +572,7 @@ export async function planPrompt({ prompt, partner = null, forceKind = null, fam
                 },
                 fallbackUsed: false,
                 reasons: [`family hint: ${familyHint}`],
+                routingRisk: 'safe',
             };
         }
         else {
@@ -363,31 +583,129 @@ export async function planPrompt({ prompt, partner = null, forceKind = null, fam
             // prompt clearly demands. When the prompt carries unambiguous phrases, we
             // pick the specialty family directly.
             const specialtyRules = [
-                { family: 'expo-rn-rich', phrases: ['skia', 'reanimated', 'rich animations mobile', 'expo skia', 'expo reanimated', 'react native skia'] },
-                { family: 'tauri-tray', phrases: ['tauri system tray', 'system tray daemon', 'tray icon only', 'tray menu daemon'] },
-                { family: 'tauri-menubar', phrases: ['macos menubar', 'menu bar app', 'raycast-like', 'floating panel app'] },
-                { family: 'electron-native-os', phrases: ['electron native os', 'deep links desktop', 'native os integration', 'auto updater electron'] },
-                { family: 'voice-first-agent', phrases: ['voice-first conversational', 'voice first agent', 'browser mic agent', 'push to talk agent'] },
-                { family: 'vision-first-agent', phrases: ['camera agent', 'vision-first agent', 'visual qa agent'] },
-                { family: 'multimodal-agent', phrases: ['multimodal agent', 'text image audio agent', 'gpt-4o client app'] },
-                { family: 'webgpu-inference', phrases: ['webgpu browser compute', 'webgpu inference', 'wgsl matmul', 'wgsl compute'] },
-                { family: 'webgpu-render', phrases: ['raw webgpu', 'wgsl graphics', 'wgsl vertex', 'webgpu triangle'] },
+                {
+                    family: 'expo-rn-rich',
+                    phrases: [
+                        'skia',
+                        'reanimated',
+                        'rich animations mobile',
+                        'expo skia',
+                        'expo reanimated',
+                        'react native skia',
+                    ],
+                },
+                {
+                    family: 'tauri-tray',
+                    phrases: [
+                        'tauri system tray',
+                        'system tray daemon',
+                        'tray icon only',
+                        'tray menu daemon',
+                    ],
+                },
+                {
+                    family: 'tauri-menubar',
+                    phrases: ['macos menubar', 'menu bar app', 'raycast-like', 'floating panel app'],
+                },
+                {
+                    family: 'electron-native-os',
+                    phrases: [
+                        'electron native os',
+                        'deep links desktop',
+                        'native os integration',
+                        'auto updater electron',
+                    ],
+                },
+                {
+                    family: 'voice-first-agent',
+                    phrases: [
+                        'voice-first conversational',
+                        'voice first agent',
+                        'browser mic agent',
+                        'push to talk agent',
+                    ],
+                },
+                {
+                    family: 'vision-first-agent',
+                    phrases: ['camera agent', 'vision-first agent', 'visual qa agent'],
+                },
+                {
+                    family: 'multimodal-agent',
+                    phrases: ['multimodal agent', 'text image audio agent', 'gpt-4o client app'],
+                },
+                {
+                    family: 'webgpu-inference',
+                    phrases: ['webgpu browser compute', 'webgpu inference', 'wgsl matmul', 'wgsl compute'],
+                },
+                {
+                    family: 'webgpu-render',
+                    phrases: ['raw webgpu', 'wgsl graphics', 'wgsl vertex', 'webgpu triangle'],
+                },
                 { family: 'bevy-web', phrases: ['bevy web game', 'bevy wasm', 'rust web game'] },
                 { family: 'godot-web', phrases: ['godot 4 web', 'godot html5', 'godot web game'] },
                 { family: 'unity-web-proxy', phrases: ['unity webgl export', 'unity web build'] },
-                { family: 'livekit-sfu', phrases: ['livekit sfu', 'self-hosted livekit', 'selective forwarding unit'] },
+                {
+                    family: 'livekit-sfu',
+                    phrases: ['livekit sfu', 'self-hosted livekit', 'selective forwarding unit'],
+                },
                 { family: 'hls-origin', phrases: ['hls origin', 'hls live streaming', 'rtmp ingest'] },
-                { family: 'realtime-audio-ts', phrases: ['realtime audio visualiz', 'webaudio analyser', 'peer audio'] },
-                { family: 'hipaa-compliance-pack', phrases: ['hipaa compliance pack', 'hipaa-compliant compliance pack', 'phi audit trail and baa', 'baa template'] },
-                { family: 'soc2-compliance-pack', phrases: ['soc 2 type ii compliance pack', 'soc 2 compliance pack', 'soc2 compliance pack', 'change management and incident response'] },
-                { family: 'pci-dss-compliance-pack', phrases: ['pci-dss 4.0 compliance pack', 'pci dss compliance pack', 'pan redaction and stripe tokenization', 'pci compliance pack'] },
-                { family: 'gdpr-compliance-pack', phrases: ['gdpr compliance pack', 'gdpr-compliant consent management', 'data subject rights endpoint'] },
-                { family: 'healthcare-hipaa-backend', phrases: ['hipaa-compliant', 'phi audit log', 'healthcare backend'] },
-                { family: 'fintech-ledger-backend', phrases: ['double-entry ledger', 'double entry ledger', 'debits and credits'] },
-                { family: 'legal-case-mgmt', phrases: ['legal case management', 'matter management', 'attorney timekeeping'] },
+                {
+                    family: 'realtime-audio-ts',
+                    phrases: ['realtime audio visualiz', 'webaudio analyser', 'peer audio'],
+                },
+                {
+                    family: 'hipaa-compliance-pack',
+                    phrases: [
+                        'hipaa compliance pack',
+                        'hipaa-compliant compliance pack',
+                        'phi audit trail and baa',
+                        'baa template',
+                    ],
+                },
+                {
+                    family: 'soc2-compliance-pack',
+                    phrases: [
+                        'soc 2 type ii compliance pack',
+                        'soc 2 compliance pack',
+                        'soc2 compliance pack',
+                        'change management and incident response',
+                    ],
+                },
+                {
+                    family: 'pci-dss-compliance-pack',
+                    phrases: [
+                        'pci-dss 4.0 compliance pack',
+                        'pci dss compliance pack',
+                        'pan redaction and stripe tokenization',
+                        'pci compliance pack',
+                    ],
+                },
+                {
+                    family: 'gdpr-compliance-pack',
+                    phrases: [
+                        'gdpr compliance pack',
+                        'gdpr-compliant consent management',
+                        'data subject rights endpoint',
+                    ],
+                },
+                {
+                    family: 'healthcare-hipaa-backend',
+                    phrases: ['hipaa-compliant', 'phi audit log', 'healthcare backend'],
+                },
+                {
+                    family: 'fintech-ledger-backend',
+                    phrases: ['double-entry ledger', 'double entry ledger', 'debits and credits'],
+                },
+                {
+                    family: 'legal-case-mgmt',
+                    phrases: ['legal case management', 'matter management', 'attorney timekeeping'],
+                },
                 { family: 'k12-edtech', phrases: ['k-12 edtech', 'k12 edtech', 'ferpa'] },
                 { family: 'crm-backend', phrases: ['sales crm', 'deals pipeline', 'sales pipeline'] },
-                { family: 'ecommerce-headless', phrases: ['headless commerce', 'ecommerce backend', 'cart checkout'] },
+                {
+                    family: 'ecommerce-headless',
+                    phrases: ['headless commerce', 'ecommerce backend', 'cart checkout'],
+                },
                 { family: 'aptos-move', phrases: ['aptos move', 'aptos_framework', 'aptos framework'] },
                 { family: 'celestia-da', phrases: ['celestia', 'data availability node', 'celestia blob'] },
                 { family: 'ollama-server', phrases: ['ollama local', 'ollama server', 'gguf'] },
@@ -396,9 +714,15 @@ export async function planPrompt({ prompt, partner = null, forceKind = null, fam
                 { family: 'triton-server', phrases: ['nvidia triton', 'triton inference'] },
                 { family: 'skypilot-serving', phrases: ['skypilot', 'sky serve'] },
                 { family: 'lora-training', phrases: ['lora fine-tun', 'qlora', 'lora training'] },
-                { family: 'streamlit-advanced', phrases: ['multipage streamlit', 'streamlit multipage', 'production streamlit'] },
+                {
+                    family: 'streamlit-advanced',
+                    phrases: ['multipage streamlit', 'streamlit multipage', 'production streamlit'],
+                },
                 { family: 'jupyter-book', phrases: ['jupyter book', 'jupyterbook', 'executable book'] },
-                { family: 'observable-notebook', phrases: ['observable framework', 'observablehq', 'observable notebook'] },
+                {
+                    family: 'observable-notebook',
+                    phrases: ['observable framework', 'observablehq', 'observable notebook'],
+                },
                 { family: 'eleventy-static', phrases: ['eleventy', '11ty'] },
                 { family: 'hugo-static', phrases: ['hugo static', 'hugo site', 'hugo blog'] },
                 { family: 'zola-static', phrases: ['zola static', 'zola site', 'tera template'] },
@@ -406,11 +730,26 @@ export async function planPrompt({ prompt, partner = null, forceKind = null, fam
                 { family: 'threejs-game', phrases: ['three.js', 'threejs', 'webgl 3d scene'] },
                 { family: 'phaser-game', phrases: ['phaser 3', '2d arcade game'] },
                 { family: 'pixijs-game', phrases: ['pixi.js v8', 'pixijs', '2d webgpu'] },
-                { family: 'flutter-app', phrases: ['flutter app', 'flutter dart', 'material design flutter', 'cupertino flutter'] },
-                { family: 'kotlin-multiplatform', phrases: ['kotlin multiplatform', 'compose multiplatform', 'kmp kotlin', 'expect-actual'] },
-                { family: 'esp32-rust', phrases: ['esp32 rust', 'esp-idf-svc', 'xtensa rust', 'espressif rust'] },
-                { family: 'stm32-rust', phrases: ['stm32 rust', 'embassy stm32', 'stm32 embassy', 'stm32 bare metal'] },
-                { family: 'ros2-node-py', phrases: ['ros2 rclpy', 'ros2 python node', 'rclpy publisher', 'ros2 node python'] },
+                {
+                    family: 'flutter-app',
+                    phrases: ['flutter app', 'flutter dart', 'material design flutter', 'cupertino flutter'],
+                },
+                {
+                    family: 'kotlin-multiplatform',
+                    phrases: ['kotlin multiplatform', 'compose multiplatform', 'kmp kotlin', 'expect-actual'],
+                },
+                {
+                    family: 'esp32-rust',
+                    phrases: ['esp32 rust', 'esp-idf-svc', 'xtensa rust', 'espressif rust'],
+                },
+                {
+                    family: 'stm32-rust',
+                    phrases: ['stm32 rust', 'embassy stm32', 'stm32 embassy', 'stm32 bare metal'],
+                },
+                {
+                    family: 'ros2-node-py',
+                    phrases: ['ros2 rclpy', 'ros2 python node', 'rclpy publisher', 'ros2 node python'],
+                },
             ];
             const lower = prompt.toLowerCase();
             for (const rule of specialtyRules) {
@@ -433,6 +772,7 @@ export async function planPrompt({ prompt, partner = null, forceKind = null, fam
                         },
                         fallbackUsed: false,
                         reasons: [`specialty override → ${rule.family}`],
+                        routingRisk: 'safe',
                     };
                     break;
                 }
@@ -456,16 +796,16 @@ export async function planPrompt({ prompt, partner = null, forceKind = null, fam
         const paymentsSlot = detectPaymentsSlot(text);
         const queueSlot = detectQueueSlot(text);
         spec.slots = { ...(spec.slots ?? {}) };
-        if (databaseSlot && family?.slots?.['database'])
-            spec.slots['database'] = databaseSlot;
-        if (sdkSlot && family?.slots?.['sdk'])
-            spec.slots['sdk'] = sdkSlot;
-        if (authSlot && family?.slots?.['auth'])
-            spec.slots['auth'] = authSlot;
-        if (paymentsSlot && family?.slots?.['payments'])
-            spec.slots['payments'] = paymentsSlot;
-        if (queueSlot && family?.slots?.['queue'])
-            spec.slots['queue'] = queueSlot;
+        if (databaseSlot && family?.slots?.database)
+            spec.slots.database = databaseSlot;
+        if (sdkSlot && family?.slots?.sdk)
+            spec.slots.sdk = sdkSlot;
+        if (authSlot && family?.slots?.auth)
+            spec.slots.auth = authSlot;
+        if (paymentsSlot && family?.slots?.payments)
+            spec.slots.payments = paymentsSlot;
+        if (queueSlot && family?.slots?.queue)
+            spec.slots.queue = queueSlot;
         const capabilities = detectCapabilities(text, spec.family, registry);
         if (capabilities.length > 0) {
             spec.layers = [...new Set([...(spec.layers ?? []), ...capabilities])];
@@ -503,10 +843,10 @@ export async function planPrompt({ prompt, partner = null, forceKind = null, fam
             spec,
         };
     });
-    const family = plan.kind === 'starter' ? plan.spec.family : plan.spec.projects?.[0]?.spec.family ?? 'unknown';
+    const family = plan.kind === 'starter' ? plan.spec.family : (plan.spec.projects?.[0]?.spec.family ?? 'unknown');
     const capabilities = plan.kind === 'starter'
         ? (plan.spec.layers ?? []).filter((l) => l.startsWith('capability:'))
-        : plan.spec.projects?.flatMap((p) => (p.spec.layers ?? []).filter((l) => l.startsWith('capability:'))) ?? [];
+        : (plan.spec.projects?.flatMap((p) => (p.spec.layers ?? []).filter((l) => l.startsWith('capability:'))) ?? []);
     emit('route', {
         prompt,
         kind: plan.kind,