@tangle-network/starter-foundry 0.5.3 → 0.5.4

package/dist/lib/planner/signals.js

@@ -0,0 +1,324 @@
+// Signal constants used across the planner. Pure data — no behavior.
+// Every list is a hasAny-style substring match; case handled by the caller.
+//
+// Grouped by where the signal fires in the pipeline:
+//   - Lane detection:      FRONTEND_SIGNALS, API_SIGNALS, WORKER_SIGNALS,
+//                          FULLSTACK_SIGNALS, WORKSPACE_SIGNALS, SINGLE_LANE_SIGNALS,
+//                          FRAMEWORK_API_TERMS, STRONG_API_TERMS,
+//                          EXPLICIT_WORKER_SIGNALS
+//   - Archetype inference: IMPLICIT_UI_FAMILIES, REACT_FAMILIES,
+//                          CHAT_ARCHETYPE_SIGNALS, CHART_STRONG_SIGNALS,
+//                          AI_PRODUCT_PHRASES, VIDEO_ARCHETYPE_SIGNALS,
+//                          ADMIN_ARCHETYPE_SIGNALS, AUTH_ARCHETYPE_SIGNALS
+// Families where implicit UI capability inference fires (archetype-based
+// dashboard/chat/chart attachment). Moving it out of this set means losing
+// the auto-attached React UI layers.
+export const IMPLICIT_UI_FAMILIES = new Set(['react-vite-ts', 'nextjs-ts', 'fullstack-ts', 'remix-ts']);
+// React families that get unconditional tailwind + shadcn attachment.
+// Keep in sync with IMPLICIT_UI_FAMILIES — any addition here should also
+// go there.
+export const REACT_FAMILIES = new Set(['react-vite-ts', 'nextjs-ts', 'fullstack-ts', 'remix-ts']);
+// Chat-first archetype: product's primary surface is a conversational thread,
+// not a data-heavy dashboard. Matches phrases where the user interacts by
+// talking to the AI (assistant / tutor / companion) or the product IS a chatbot.
+export const CHAT_ARCHETYPE_SIGNALS = [
+    'chatbot',
+    'chat bot',
+    'support bot',
+    'ai assistant',
+    'cooking assistant',
+    'shopping assistant',
+    'writing assistant',
+    'personal assistant',
+    'ai tutor',
+    'language tutor',
+    'homework help',
+    'homework helper',
+    'bedtime stor',
+    'voice companion',
+    'ai companion',
+    'symptom checker',
+    'describe what',
+    'i describe',
+    'conversations with',
+    'conversation with me',
+    'has conversations',
+    'chat with me',
+    'chats with me',
+    'texts me',
+    'explains concepts',
+    // dialogue-shape prompts: "I tell it...", "I ask it..."
+    'tell it ',
+    'ask it ',
+    'tells me',
+    'tells you',
+];
+// STRONG chart signals — single match triggers chart-widget. Each is a
+// near-certain indicator of a data-viz surface. Intentionally avoids single
+// words like "track" / "patterns" / "trends" / "charts" which carry too many
+// unrelated senses (seating charts, music tracks, movement patterns).
+export const CHART_STRONG_SIGNALS = [
+    'gantt',
+    'burndown',
+    'kpi',
+    'analytics',
+    'metrics',
+    'churn',
+    'sentiment analysis',
+    'sentiment patterns',
+    'sentiment over time',
+    'see trends',
+    'shows sentiment',
+    'price changes',
+    'price tracking',
+    'tracks price',
+    'tracks floor',
+    'tracks mentions',
+    'tracks what performs',
+    'compensation trends',
+    'salary ranges',
+    'portfolio tracker',
+    'portfolio value',
+    'floor prices',
+    'valuation',
+    'sales reporting',
+    'auto-generates esg',
+    'sustainability reports',
+    'status reports',
+    'yield farming',
+    'apys across',
+    'competitive pricing',
+    'competitor websites',
+    'listing aggregator',
+    'auto-compound',
+    'neighborhood trends',
+    'comparable sales',
+    'deals below market',
+    'churn metrics',
+    'nps tracking',
+    'low-stock alerts',
+    'categorizes spending',
+    'savings tips',
+    'payment tracking',
+    "track what's paid",
+    'coaching opportunities',
+    'see stats',
+    'see metrics',
+    'dashboard to see',
+    'performance tracking',
+    'p&l',
+    'revenue metrics',
+];
+// AI product signals — literal phrases that indicate "the product is AI-powered"
+// and likely ships a chat surface. Kept as a hasAny list (case-insensitive
+// word-boundary match via matchesKeyword) rather than a wide regex.
+export const AI_PRODUCT_PHRASES = [
+    'ai app',
+    'ai tool',
+    'ai platform',
+    'ai assistant',
+    'ai agent',
+    'ai bot',
+    'ai advisor',
+    'ai tutor',
+    'ai companion',
+    'ai writer',
+    'ai scheduler',
+    'ai analyzer',
+    'ai optimizer',
+    'ai planner',
+    'ai generator',
+    'ai helper',
+    'ai reviewer',
+    'ai builder',
+    'ai engine',
+    'ai system',
+    'ai pipeline',
+    'ai workflow',
+    'ai manager',
+    'ai screener',
+    'ai screening',
+    'ai coach',
+    'ai copilot',
+    'ai feature',
+    'ai cooking',
+    'ai personal',
+    'ai language',
+    'ai voice',
+    'ai travel',
+    'ai meal',
+    'ai interior',
+    'ai code',
+    'ai recipe',
+    'ai resume',
+    'ai social',
+    'ai customer',
+    'ai legal',
+    'ai medical',
+    'ai homework',
+    'ai newsletter',
+    'ai podcast',
+    'ai video',
+    'ai property',
+    'ai content',
+    'ai data',
+    'ai recruit',
+    'ai symptom',
+    'ai image',
+    'ai photo',
+    'ai audio',
+    'ai chat',
+    'ai email',
+    'ai search',
+    'ai-powered',
+    'ai-driven',
+    'generative ai',
+    'artificial intelligence',
+    // "AI <verb>s ..." — "AI does X" in plain language
+    'ai suggests',
+    'ai turns',
+    'ai generates',
+    'ai highlights',
+    'ai writes',
+    'ai answers',
+    'ai analyzes',
+    'ai estimates',
+    'ai categor',
+    'ai identif',
+    'ai creat',
+    'ai cuts',
+    'ai tailors',
+    'ai adapts',
+    'ai screens',
+    'ai extracts',
+    'ai explains',
+    'ai reads',
+    'ai understands',
+    'ai processes',
+    'ai translates',
+    'ai summar',
+    'ai detects',
+    'ai recommends',
+    'ai scores',
+    // "AI that/to/for ..." shapes
+    'ai that',
+    'ai to ',
+    'ai which',
+    'ai for',
+    // "build/make/create me an ai ..."
+    'an ai ',
+    'a ai ',
+    // Implicit-AI products (no literal "AI" but the capability is AI-dependent)
+    'transcribes',
+    'transcription',
+    'gives me a summary',
+    'summarizes',
+    'auto-summar',
+    'automatically generates',
+    'automatically cuts',
+];
+// Implicit video/call surface — natural prompts that describe video rooms,
+// consultations, low-latency audio, or streaming without saying "webrtc".
+export const VIDEO_ARCHETYPE_SIGNALS = [
+    'video consultation',
+    'video consultations',
+    'video rooms',
+    'video room',
+    'video call',
+    'video calls',
+    'video updates',
+    'video conferencing',
+    'video conference',
+    'virtual co-working',
+    'virtual coworking',
+    'low-latency audio',
+    'persistent video',
+    'video tutoring',
+    'async video',
+    'screen sharing',
+    'shared whiteboard',
+    'telehealth',
+    'livekit',
+    'peer-to-peer',
+    'jam session',
+];
+// Admin/operations archetypes — internal SaaS tools with bulk management,
+// document workflows, role-based access, approval flows. These want layout-admin
+// alongside layout-dashboard.
+export const ADMIN_ARCHETYPE_SIGNALS = [
+    'onboarding tool',
+    'onboarding app',
+    'employee onboarding',
+    'vendor onboarding',
+    'approval workflow',
+    'approval flow',
+    'back office',
+    'content management',
+    'data table',
+    'crud operations',
+    'role-based',
+    'multi-step sign-off',
+    'dues collection',
+    'maintenance requests',
+    'document storage',
+    'collects documents',
+    'auto-assign',
+    'assigns tasks',
+    'hr tool',
+    'admin panel',
+];
+// Auth/portal archetypes — client portals, tenant portals, customer-specific
+// views with login flows.
+export const AUTH_ARCHETYPE_SIGNALS = [
+    'client portal',
+    'customer portal',
+    'tenant portal',
+    'accounting firm',
+    'document portal',
+    'share tax returns',
+    'patient portal',
+    'secure login',
+];
+// Single-surface families that never become workspaces.
+export const SINGLE_LANE_SIGNALS = [
+    'expo', 'react native', 'mobile app', 'ios app', 'android app',
+    'browser extension', 'chrome extension', 'manifest v3',
+    'electron', 'desktop app', 'desktop assistant',
+    'command line', 'terminal tool',
+    'streamlit', 'gradio', 'data app', 'tauri',
+];
+export const FRONTEND_SIGNALS = [
+    'frontend', 'ui', 'website', 'landing', 'dashboard', 'web app', 'app',
+    'preview', 'next', 'react', 'platform', 'dapp', 'interface', 'portal',
+    // "X page" / "Y screen" — UI nouns. Buildout corpus showed prompts like
+    // "DEX swap page" / "NFT mint page" routing to forge-contracts only
+    // because no frontend signal matched.
+    'page', 'screen', 'mint page', 'swap page', 'bridge page',
+    'staking page', 'claim page',
+];
+export const API_SIGNALS = [
+    'api', 'backend', 'server', 'endpoint', 'service', 'webhook', 'health check',
+    'cloudflare', 'durable object', 'edge api', 'edge function', 'payment webhook',
+    'server wallet', 'rest api', 'graphql api',
+];
+// Framework namespace "api" mentions that aren't REST APIs — disambiguate.
+export const FRAMEWORK_API_TERMS = ['composition api', 'options api', 'signals api', 'context api', 'hooks api'];
+export const STRONG_API_TERMS = ['backend', 'server', 'endpoint', 'webhook', 'rest api', 'graphql api', 'api service', 'api endpoint', 'health check'];
+export const WORKER_SIGNALS = [
+    'trading bot', 'background job', 'background worker', 'worker for', 'playwright worker',
+    'automation worker', 'go worker', 'golang worker', 'queue', 'cron', 'market stream', 'bot',
+];
+export const EXPLICIT_WORKER_SIGNALS = [
+    'trading bot', 'background job', 'background worker', 'worker for', 'playwright worker',
+    'automation worker', 'go worker', 'golang worker', 'queue', 'cron', 'market stream',
+];
+export const FULLSTACK_SIGNALS = [
+    'fullstack', 'full stack', 'dashboard with api', 'app with api', 'admin app', 'admin panel',
+    'database-backed', 'dashboard and api', 'admin flows', 'saas', 'saas app', 'saas platform',
+    'internal tool', 'back office', 'crud app',
+];
+export const WORKSPACE_SIGNALS = [
+    'workspace', 'monorepo', 'separate backend', 'separate api',
+    'background worker', 'contract lane', 'contract lanes',
+];
+//# sourceMappingURL=signals.js.map

package/dist/lib/planner/signals.js.map

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

package/dist/lib/product-brief.d.ts

@@ -0,0 +1,25 @@
+export interface ProductBrief {
+    canonicalPrompt: string;
+    vision: string;
+    taskChecklist: string[];
+    milestones: string[];
+    testingPlan: string[];
+    e2ePlan: string[];
+    securityConcerns: string[];
+    openQuestions: string[];
+    confidence: number;
+}
+export interface BriefArgs {
+    prompt: string;
+    partner?: string | null;
+    knownFamilies: string[];
+    knownCapabilities: string[];
+}
+export interface BriefResult {
+    brief: ProductBrief;
+    cacheHit: boolean;
+    latencyMs: number;
+}
+export type BriefFn = (args: BriefArgs) => Promise<BriefResult | null>;
+export declare function __setTestBrief(fn: BriefFn | null): void;
+export declare function generateProductBrief(args: BriefArgs): Promise<BriefResult | null>;

package/dist/lib/product-brief.js

@@ -0,0 +1,129 @@
+import { createHash } from 'node:crypto';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { performance } from 'node:perf_hooks';
+import { ax } from '@ax-llm/ax';
+import { createLLM, isLLMAvailable } from './llm.js';
+const CACHE_DIR = '.evolve';
+const CACHE_PATH = path.join(CACHE_DIR, 'product-brief-cache.json');
+const MAX_LRU = 256;
+const inMemLRU = new Map();
+let diskCache = null;
+let testOverride = null;
+export function __setTestBrief(fn) {
+    testOverride = fn;
+}
+function hashKey(prompt, partner) {
+    return createHash('sha1').update(`brief::${prompt}::${partner ?? ''}`).digest('hex').slice(0, 16);
+}
+async function loadDiskCache() {
+    if (diskCache)
+        return diskCache;
+    try {
+        const raw = await fs.readFile(CACHE_PATH, 'utf8');
+        const obj = JSON.parse(raw);
+        diskCache = new Map(Object.entries(obj));
+    }
+    catch {
+        diskCache = new Map();
+    }
+    return diskCache;
+}
+async function persistDiskCache() {
+    if (!diskCache)
+        return;
+    await fs.mkdir(CACHE_DIR, { recursive: true });
+    const obj = {};
+    for (const [k, v] of diskCache)
+        obj[k] = v;
+    await fs.writeFile(CACHE_PATH, JSON.stringify(obj, null, 2));
+}
+// Rich brief generator: one LLM call yields everything the downstream pipeline
+// needs — the canonical routing prompt AND the product plan. Signatures use
+// ax's field-description syntax so the model knows what each field should
+// contain without needing a prose system prompt.
+const briefAgent = ax([
+    '"Turn a user product prompt into a structured product brief that drives a deterministic scaffold pipeline downstream. The canonicalPrompt must be a keyword-rich expansion that names concrete technologies drawn from knownFamilies (e.g. nextjs-ts, fullstack-ts, agent-service-ts, go-api, python-api, forge-contracts, solana-program) and concrete UI/infra capabilities drawn from knownCapabilities (e.g. capability:ai-chat-ui, capability:layout-dashboard, capability:saas-billing). It MUST be longer and more specific than the user prompt. Preserve the user intent exactly — do not invent features. The brief is for humans AND for AI agents that will build the project, so be concrete and specific. Each list field should have 3-8 items." ',
+    'userPrompt:string, ',
+    'knownFamilies:string[], ',
+    'knownCapabilities:string[] ',
+    '-> ',
+    'canonicalPrompt:string, ',
+    'vision:string, ',
+    'taskChecklist:string[], ',
+    'milestones:string[], ',
+    'testingPlan:string[], ',
+    'e2ePlan:string[], ',
+    'securityConcerns:string[], ',
+    'openQuestions:string[], ',
+    'confidence:number',
+].join(''));
+function normalizeConfidence(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return 0.5;
+    if (value <= 0)
+        return 0;
+    if (value >= 1)
+        return 1;
+    return value;
+}
+function sanitizeList(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.map((v) => String(v).trim()).filter(Boolean);
+}
+async function generateProductBriefImpl({ prompt, partner = null, knownFamilies, knownCapabilities, }) {
+    const key = hashKey(prompt, partner);
+    const mem = inMemLRU.get(key);
+    if (mem)
+        return { brief: mem, cacheHit: true, latencyMs: 0 };
+    const disk = await loadDiskCache();
+    const cached = disk.get(key);
+    if (cached) {
+        inMemLRU.set(key, cached);
+        return { brief: cached, cacheHit: true, latencyMs: 0 };
+    }
+    if (!isLLMAvailable())
+        return null;
+    const llm = createLLM();
+    const t0 = performance.now();
+    let raw;
+    try {
+        raw = (await briefAgent.forward(llm, {
+            userPrompt: prompt,
+            knownFamilies,
+            knownCapabilities,
+        }, { stream: false }));
+    }
+    catch {
+        return null;
+    }
+    const latencyMs = performance.now() - t0;
+    const canonicalPrompt = (raw.canonicalPrompt ?? '').trim();
+    if (!canonicalPrompt)
+        return null;
+    const brief = {
+        canonicalPrompt,
+        vision: (raw.vision ?? '').trim(),
+        taskChecklist: sanitizeList(raw.taskChecklist),
+        milestones: sanitizeList(raw.milestones),
+        testingPlan: sanitizeList(raw.testingPlan),
+        e2ePlan: sanitizeList(raw.e2ePlan),
+        securityConcerns: sanitizeList(raw.securityConcerns),
+        openQuestions: sanitizeList(raw.openQuestions),
+        confidence: normalizeConfidence(raw.confidence),
+    };
+    inMemLRU.set(key, brief);
+    if (inMemLRU.size > MAX_LRU) {
+        const first = inMemLRU.keys().next().value;
+        if (typeof first === 'string')
+            inMemLRU.delete(first);
+    }
+    disk.set(key, brief);
+    persistDiskCache().catch(() => { });
+    return { brief, cacheHit: false, latencyMs };
+}
+export function generateProductBrief(args) {
+    return (testOverride ?? generateProductBriefImpl)(args);
+}
+//# sourceMappingURL=product-brief.js.map

package/dist/lib/product-brief.js.map

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

package/dist/lib/prompt-planner.d.ts

@@ -1,9 +1,13 @@
 import type { PromptPlan } from '../types.js';
-export declare function planPrompt({ prompt, partner, forceKind, familyHint, }: {
+export declare function planPrompt({ prompt, partner, forceKind, familyHint, rewriter, brief, }: {
     prompt: string;
     partner?: string | null;
     /** Force the result to be 'starter' or 'workspace'. Used by scaffold-builder for curated templates. */
     forceKind?: 'starter' | 'workspace' | null;
     /** Hint the family directly. Skips family scoring, only detects capabilities + slots. */
     familyHint?: string | null;
+    /** Narrow rewriter: LLM produces a short canonical prompt for re-planning. Back-compat flag; prefer `brief`. */
+    rewriter?: boolean;
+    /** Rich product brief: one LLM call produces canonical prompt + vision + tasks + milestones + tests + e2e + security + openQuestions. Attached to the returned plan via .brief for downstream context-pack use. */
+    brief?: boolean;
 }): Promise<PromptPlan>;