@tangle-network/starter-foundry 0.1.0

package/dist/lib/selection.js

@@ -0,0 +1,128 @@
+import { fuzzyKeywordScore, keywordScore } from './keywords.js';
+import { loadRegistry } from './registry.js';
+import { semanticMatch, isSemanticRouterReady } from './semantic-router.js';
+const TIER_WEIGHTS = { tier1: 4, tier2: 2, tier3: 1, archetypes: 3 };
+function frameworkLayersForFamily(familyId, layers) {
+    const result = [];
+    for (const [key, layer] of layers) {
+        if (layer.group === 'framework' && layer.appliesTo?.includes(familyId)) {
+            result.push(key);
+        }
+    }
+    return result;
+}
+/**
+ * Score a prompt against a family's tiered keywords.
+ * One pass, deterministic, traceable.
+ */
+function scoreFamilyTiered(prompt, family) {
+    const tk = family.tieredKeywords;
+    if (!tk) {
+        // Fallback to flat keywords if tieredKeywords not present
+        return family.keywords?.length ? keywordScore(prompt, family.keywords) : 0;
+    }
+    let score = 0;
+    if (tk.tier1?.length)
+        score += keywordScore(prompt, tk.tier1) * TIER_WEIGHTS.tier1;
+    if (tk.tier2?.length)
+        score += keywordScore(prompt, tk.tier2) * TIER_WEIGHTS.tier2;
+    if (tk.tier3?.length)
+        score += keywordScore(prompt, tk.tier3) * TIER_WEIGHTS.tier3;
+    if (tk.archetypes?.length)
+        score += keywordScore(prompt, tk.archetypes) * TIER_WEIGHTS.archetypes;
+    return score;
+}
+export async function selectStarter({ prompt, partner = null, }) {
+    const registry = await loadRegistry();
+    // Score all families in one pass
+    const candidates = [];
+    for (const family of registry.families.values()) {
+        const fwLayers = frameworkLayersForFamily(family.id, registry.layers);
+        const score = scoreFamilyTiered(prompt, family);
+        candidates.push({
+            family: family.id,
+            layers: fwLayers,
+            score,
+            reasons: score > 0 ? [`${family.id} matched`] : [],
+        });
+    }
+    candidates.sort((left, right) => right.score - left.score);
+    // Fuzzy fallback: when exact matching found nothing, try Levenshtein distance ≤ 1
+    if (candidates[0].score === 0) {
+        for (const candidate of candidates) {
+            const familyManifest = registry.families.get(candidate.family);
+            if (!familyManifest)
+                continue;
+            // Fuzzy only against tier1 (framework names) — fuzzy on generic words
+            // causes false positives like "lending" → "landing"
+            const allKeywords = [
+                ...(familyManifest.tieredKeywords?.tier1 ?? []),
+            ];
+            if (allKeywords.length) {
+                candidate.score = fuzzyKeywordScore(prompt, allKeywords);
+            }
+        }
+        candidates.sort((left, right) => right.score - left.score);
+    }
+    // Semantic fallback: when keyword score is low, use embedding similarity
+    // to find the best family match based on description understanding.
+    // Only fires when the semantic router has been initialized (optional).
+    // Semantic fallback only fires when keywords found NOTHING (score 0).
+    // This prevents the embedding from overriding confident keyword matches.
+    if (candidates[0].score === 0 && isSemanticRouterReady()) {
+        const match = await semanticMatch(prompt);
+        if (match && match.score > 0.55) {
+            const semanticCandidate = candidates.find((c) => c.family === match.familyId);
+            if (semanticCandidate) {
+                // Boost the semantically-matched candidate so it wins
+                semanticCandidate.score = Math.max(semanticCandidate.score, 8);
+                semanticCandidate.reasons = [`semantic match: ${match.familyId} (${Math.round(match.score * 100)}% similarity)`];
+                candidates.sort((left, right) => right.score - left.score);
+            }
+        }
+    }
+    const winner = candidates[0];
+    // Smart default: when no family scores, infer from prompt shape.
+    // Product descriptions ("build a X with Y") → fullstack-ts (needs backend).
+    // Static content requests → frontend-static.
+    let defaultFamily = 'frontend-static';
+    let defaultLayers = ['framework:web-static'];
+    if (winner.score === 0) {
+        const lower = prompt.toLowerCase();
+        const describesProduct = /\b(build|create|make|ship|launch|want|need|develop)\b/.test(lower) &&
+            /\b(app|tool|platform|system|tracker|manager|dashboard|portal|service|bot|agent|clone|saas|mvp|product|store|storefront|shop|marketplace|builder|generator|assistant|analyzer|monitor|finder|scheduler|planner|viewer|editor|player|reader|browser|client|studio|hub|suite|kit|board|library|checker|gallery|frontend|engine|workflow|inbox|scorer|splitter|compiler|canvas|sequencer|tester|formatter|validator|log|logger|maker|community|list|test|quiz|scanner|scorecard|analytics|knowledge base|companion|advisor|tutor|optimizer|space|network|aggregator|launchpad|exchange)\b/.test(lower);
+        const isStaticContent = /\b(landing page|portfolio|cv site|personal site|restaurant website|conference website)\b/.test(lower) && !/\b(ai|builder|generator|dynamic)\b/.test(lower);
+        if (describesProduct && !isStaticContent) {
+            defaultFamily = 'fullstack-ts';
+            const fwLayers = frameworkLayersForFamily('fullstack-ts', registry.layers);
+            defaultLayers = fwLayers.length > 0 ? fwLayers : ['framework:fullstack-node-ts'];
+        }
+    }
+    const family = winner.score > 0 ? winner.family : defaultFamily;
+    const layers = winner.score > 0 ? winner.layers : defaultLayers;
+    const confidence = winner.score > 6 ? 'high' : winner.score > 0 ? 'medium' : 'low';
+    const spec = {
+        projectName: partner ? `${partner}-starter` : 'generated-starter',
+        family,
+        layers,
+        partner,
+        slots: {},
+        variables: {},
+    };
+    if (partner === 'coinbase' && family === 'frontend-static') {
+        spec.layers = [...layers, 'capability:chart-widget'];
+        spec.variables = { ...spec.variables, headline: 'Ship a Coinbase-ready product surface' };
+    }
+    if (partner === 'coinbase' &&
+        (family === 'react-vite-ts' || family === 'nextjs-ts' || family === 'fullstack-ts' || family === 'x402-service')) {
+        spec.layers = [...new Set([...layers, 'capability:chart-widget'])];
+        spec.variables = { ...spec.variables, headline: 'Ship a Coinbase-ready product surface' };
+    }
+    return {
+        confidence,
+        spec,
+        fallbackUsed: winner.score === 0,
+        reasons: winner.score > 0 ? winner.reasons : ['no confident match, using default frontend family'],
+    };
+}
+//# sourceMappingURL=selection.js.map

package/dist/lib/selection.js.map

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

package/dist/lib/semantic-router.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Semantic Router — embedding-based family matching
+ *
+ * Used as a fallback when the keyword scorer is low-confidence.
+ * Encodes family descriptions once at init, then compares against
+ * user prompts via cosine similarity.
+ *
+ * Model: bge-small-en-v1.5 (17MB quantized, ~15ms per inference)
+ * Dependencies: @huggingface/transformers (uses onnxruntime-node)
+ */
+import type { Registry } from '../types.js';
+/**
+ * Initialize the embedding model and pre-compute family embeddings.
+ * Call once at startup — subsequent calls are no-ops.
+ * Takes ~300ms for model load + ~600ms for 39 family embeddings.
+ */
+export declare function initSemanticRouter(registry: Registry): Promise<void>;
+export interface SemanticMatch {
+    familyId: string;
+    score: number;
+}
+/**
+ * Find the best matching family for a prompt using embedding similarity.
+ * Returns null if the semantic router isn't initialized.
+ * ~15ms per call (warm).
+ */
+export declare function semanticMatch(prompt: string): Promise<SemanticMatch | null>;
+/** Returns true if the semantic router is ready. */
+export declare function isSemanticRouterReady(): boolean;

package/dist/lib/semantic-router.js

@@ -0,0 +1,114 @@
+/**
+ * Semantic Router — embedding-based family matching
+ *
+ * Used as a fallback when the keyword scorer is low-confidence.
+ * Encodes family descriptions once at init, then compares against
+ * user prompts via cosine similarity.
+ *
+ * Model: bge-small-en-v1.5 (17MB quantized, ~15ms per inference)
+ * Dependencies: @huggingface/transformers (uses onnxruntime-node)
+ */
+let pipeline = null;
+let familyEmbeddings = null;
+let initPromise = null;
+function cosine(a, b) {
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    return dot / (Math.sqrt(normA) * Math.sqrt(normB));
+}
+async function embed(text) {
+    if (!pipeline)
+        throw new Error('Semantic router not initialized');
+    const result = await pipeline(text, { pooling: 'mean', normalize: true });
+    return new Float32Array(result.data);
+}
+/**
+ * Initialize the embedding model and pre-compute family embeddings.
+ * Call once at startup — subsequent calls are no-ops.
+ * Takes ~300ms for model load + ~600ms for 39 family embeddings.
+ */
+export async function initSemanticRouter(registry) {
+    if (initPromise)
+        return initPromise;
+    initPromise = (async () => {
+        try {
+            // Dynamic import with loose typing — the HF transformers API varies across versions
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const hf = await import('@huggingface/transformers');
+            const pipelineFn = hf.pipeline ?? hf.default?.pipeline;
+            if (!pipelineFn) {
+                console.warn('semantic-router: @huggingface/transformers pipeline not found, fallback disabled');
+                return;
+            }
+            pipeline = await pipelineFn('feature-extraction', 'Xenova/bge-small-en-v1.5', {
+                quantized: true,
+            });
+            // Pre-compute embeddings for all family descriptions
+            familyEmbeddings = new Map();
+            for (const [id, family] of registry.families) {
+                const desc = buildFamilyText(family);
+                const embedding = await embed(desc);
+                familyEmbeddings.set(id, embedding);
+            }
+        }
+        catch (err) {
+            console.warn('semantic-router: initialization failed, fallback disabled', err instanceof Error ? err.message : err);
+            pipeline = null;
+            familyEmbeddings = null;
+        }
+    })();
+    return initPromise;
+}
+/**
+ * Build a rich text description of a family for embedding.
+ * Includes description, tags, keywords, and taxonomy.
+ */
+function buildFamilyText(family) {
+    const parts = [family.description];
+    if (family.tags?.length)
+        parts.push(family.tags.join(', '));
+    if (family.taxonomy) {
+        if (family.taxonomy.language)
+            parts.push(family.taxonomy.language);
+        if (family.taxonomy.surface)
+            parts.push(family.taxonomy.surface);
+    }
+    // Include tier1 keywords for stronger signal
+    const tk = family.tieredKeywords;
+    if (tk?.tier1?.length)
+        parts.push(tk.tier1.join(', '));
+    return parts.join('. ');
+}
+/**
+ * Find the best matching family for a prompt using embedding similarity.
+ * Returns null if the semantic router isn't initialized.
+ * ~15ms per call (warm).
+ */
+export async function semanticMatch(prompt) {
+    if (!pipeline || !familyEmbeddings)
+        return null;
+    const promptEmbedding = await embed(prompt);
+    let bestId = '';
+    let bestScore = -1;
+    for (const [id, embedding] of familyEmbeddings) {
+        const score = cosine(promptEmbedding, embedding);
+        if (score > bestScore) {
+            bestScore = score;
+            bestId = id;
+        }
+    }
+    if (!bestId)
+        return null;
+    return { familyId: bestId, score: bestScore };
+}
+/** Returns true if the semantic router is ready. */
+export function isSemanticRouterReady() {
+    return pipeline !== null && familyEmbeddings !== null;
+}
+//# sourceMappingURL=semantic-router.js.map

package/dist/lib/semantic-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-router.js","sourceRoot":"","sources":["../../src/lib/semantic-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,IAAI,QAAQ,GAA6B,IAAI,CAAA;AAC7C,IAAI,gBAAgB,GAAqC,IAAI,CAAA;AAC7D,IAAI,WAAW,GAAyB,IAAI,CAAA;AAE5C,SAAS,MAAM,CAAC,CAAe,EAAE,CAAe;IAC9C,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;QACpB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;QACtB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;IACxB,CAAC;IACD,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;AACpD,CAAC;AAED,KAAK,UAAU,KAAK,CAAC,IAAY;IAC/B,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IACjE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACzE,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAkB;IACzD,IAAI,WAAW;QAAE,OAAO,WAAW,CAAA;IAEnC,WAAW,GAAG,CAAC,KAAK,IAAI,EAAE;QACxB,IAAI,CAAC;YACH,oFAAoF;YACpF,8DAA8D;YAC9D,MAAM,EAAE,GAAQ,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAA;YACzD,MAAM,UAAU,GAAG,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAA;YACtD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC,kFAAkF,CAAC,CAAA;gBAChG,OAAM;YACR,CAAC;YAED,QAAQ,GAAG,MAAM,UAAU,CAAC,oBAAoB,EAAE,0BAA0B,EAAE;gBAC5E,SAAS,EAAE,IAAI;aAChB,CAAsB,CAAA;YAEvB,qDAAqD;YACrD,gBAAgB,GAAG,IAAI,GAAG,EAAE,CAAA;YAC5B,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBAC7C,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;gBACpC,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAA;gBACnC,gBAAgB,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAA;YACrC,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,2DAA2D,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;YACnH,QAAQ,GAAG,IAAI,CAAA;YACf,gBAAgB,GAAG,IAAI,CAAA;QACzB,CAAC;IACH,CAAC,CAAC,EAAE,CAAA;IAEJ,OAAO,WAAW,CAAA;AACpB,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,MAAsB;IAC7C,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAClC,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IAC3D,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAClE,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAClE,CAAC;IACD,6CAA6C;IAC7C,MAAM,EAAE,GAAG,MAAM,CAAC,cAAc,CAAA;IAChC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACtD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAOD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc;IAChD,IAAI,CAAC,QAAQ,IAAI,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAA;IAE/C,MAAM,eAAe,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAA;IAE3C,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,SAAS,GAAG,CAAC,CAAC,CAAA;IAElB,KAAK,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,gBAAgB,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,EAAE,SAAS,CAAC,CAAA;QAChD,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;YACtB,SAAS,GAAG,KAAK,CAAA;YACjB,MAAM,GAAG,EAAE,CAAA;QACb,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;AAC/C,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,qBAAqB;IACnC,OAAO,QAAQ,KAAK,IAAI,IAAI,gBAAgB,KAAK,IAAI,CAAA;AACvD,CAAC"}

package/dist/lib/telemetry.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Telemetry module for starter-foundry.
+ *
+ * Two integration patterns:
+ *
+ * 1. **Event-based** (lightweight, no deps) — subscribe to typed events:
+ *    ```ts
+ *    import { on } from 'starter-foundry/telemetry'
+ *    on('route', (e) => console.log(e.family, e.confidence, e.durationMs))
+ *    on('compose', (e) => console.log(e.family, e.filesWritten, e.durationMs))
+ *    ```
+ *
+ * 2. **OpenTelemetry** (production) — if @opentelemetry/api is installed,
+ *    spans are emitted automatically under the 'starter-foundry' tracer.
+ *    No additional setup needed in library code.
+ */
+export interface RouteEvent {
+    prompt: string;
+    kind: 'starter' | 'workspace';
+    family: string;
+    confidence: 'high' | 'medium' | 'low';
+    capabilities: string[];
+    fallbackUsed: boolean;
+    durationMs: number;
+}
+export interface ComposeEvent {
+    family: string;
+    layers: string[];
+    filesWritten: string[];
+    partner: string | null;
+    durationMs: number;
+}
+export interface CapabilityEvent {
+    family: string;
+    detected: string[];
+    prompt: string;
+}
+interface TelemetryEvents {
+    route: RouteEvent;
+    compose: ComposeEvent;
+    capability: CapabilityEvent;
+}
+type EventHandler<T> = (event: T) => void;
+export declare function on<K extends keyof TelemetryEvents>(event: K, handler: EventHandler<TelemetryEvents[K]>): void;
+export declare function off<K extends keyof TelemetryEvents>(event: K, handler: EventHandler<TelemetryEvents[K]>): void;
+export declare function emit<K extends keyof TelemetryEvents>(event: K, data: TelemetryEvents[K]): void;
+interface OtelSpan {
+    setAttribute(key: string, value: string | number | boolean): void;
+    setStatus(status: {
+        code: number;
+        message?: string;
+    }): void;
+    end(): void;
+}
+export declare function startSpan(name: string): OtelSpan | null;
+export declare function endSpan(span: OtelSpan | null, attrs?: Record<string, string | number | boolean>): void;
+export declare function failSpan(span: OtelSpan | null, error: string): void;
+export declare function traced<T>(name: string, fn: () => Promise<T>): Promise<{
+    result: T;
+    durationMs: number;
+}>;
+export {};

package/dist/lib/telemetry.js

@@ -0,0 +1,102 @@
+/**
+ * Telemetry module for starter-foundry.
+ *
+ * Two integration patterns:
+ *
+ * 1. **Event-based** (lightweight, no deps) — subscribe to typed events:
+ *    ```ts
+ *    import { on } from 'starter-foundry/telemetry'
+ *    on('route', (e) => console.log(e.family, e.confidence, e.durationMs))
+ *    on('compose', (e) => console.log(e.family, e.filesWritten, e.durationMs))
+ *    ```
+ *
+ * 2. **OpenTelemetry** (production) — if @opentelemetry/api is installed,
+ *    spans are emitted automatically under the 'starter-foundry' tracer.
+ *    No additional setup needed in library code.
+ */
+const handlers = {};
+export function on(event, handler) {
+    if (!handlers[event])
+        handlers[event] = [];
+    handlers[event].push(handler);
+}
+export function off(event, handler) {
+    const list = handlers[event];
+    if (!list)
+        return;
+    const idx = list.indexOf(handler);
+    if (idx >= 0)
+        list.splice(idx, 1);
+}
+export function emit(event, data) {
+    const list = handlers[event];
+    if (!list)
+        return;
+    for (const handler of list) {
+        try {
+            handler(data);
+        }
+        catch {
+            // subscriber errors don't propagate
+        }
+    }
+}
+let otelApi = null;
+let otelResolved = false;
+function getOtel() {
+    if (otelResolved)
+        return otelApi;
+    otelResolved = true;
+    try {
+        // Dynamic require — no-op if @opentelemetry/api not installed
+        otelApi = require('@opentelemetry/api');
+    }
+    catch {
+        otelApi = null;
+    }
+    return otelApi;
+}
+function getTracer() {
+    const api = getOtel();
+    return api?.trace.getTracer('starter-foundry', '0.1.0') ?? null;
+}
+export function startSpan(name) {
+    return getTracer()?.startSpan(name) ?? null;
+}
+export function endSpan(span, attrs) {
+    if (!span)
+        return;
+    if (attrs) {
+        for (const [k, v] of Object.entries(attrs)) {
+            span.setAttribute(k, v);
+        }
+    }
+    const api = getOtel();
+    if (api)
+        span.setStatus({ code: api.SpanStatusCode.OK });
+    span.end();
+}
+export function failSpan(span, error) {
+    if (!span)
+        return;
+    const api = getOtel();
+    if (api)
+        span.setStatus({ code: api.SpanStatusCode.ERROR, message: error });
+    span.end();
+}
+// --- Convenience: timed operation ---
+export async function traced(name, fn) {
+    const span = startSpan(name);
+    const start = performance.now();
+    try {
+        const result = await fn();
+        const durationMs = Math.round(performance.now() - start);
+        endSpan(span, { 'starter_foundry.duration_ms': durationMs });
+        return { result, durationMs };
+    }
+    catch (err) {
+        failSpan(span, err instanceof Error ? err.message : String(err));
+        throw err;
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/lib/telemetry.js.map

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

package/dist/lib/validate.d.ts

@@ -0,0 +1,5 @@
+import type { ComposeSpec, ValidationResult } from '../types.js';
+export declare function validateStarter({ spec, outDir, }: {
+    spec: ComposeSpec;
+    outDir?: string | null;
+}): Promise<ValidationResult>;

package/dist/lib/validate.js

@@ -0,0 +1,201 @@
+import { spawn } from 'node:child_process';
+import net from 'node:net';
+import path from 'node:path';
+import { createTempDir, fileExists, readJson, removeDir } from './fs.js';
+import { composeStarter } from './compose.js';
+function waitForExit(child) {
+    return new Promise((resolve, reject) => {
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.on('data', (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr?.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on('error', reject);
+        child.on('close', (code) => {
+            resolve({ code: code ?? 1, stdout, stderr });
+        });
+    });
+}
+async function runCommand(command, cwd, env = {}) {
+    const [bin, ...args] = command;
+    const child = spawn(bin, args, {
+        cwd,
+        env: { ...process.env, ...env },
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    return waitForExit(child);
+}
+async function reservePort() {
+    return new Promise((resolve, reject) => {
+        const server = net.createServer();
+        server.listen(0, '127.0.0.1', () => {
+            const address = server.address();
+            if (!address || typeof address === 'string') {
+                server.close();
+                reject(new Error('Failed to reserve port'));
+                return;
+            }
+            const { port } = address;
+            server.close((error) => {
+                if (error) {
+                    reject(error);
+                    return;
+                }
+                resolve(port);
+            });
+        });
+        server.on('error', reject);
+    });
+}
+async function waitForHttp(url, expected, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        try {
+            const response = await fetch(url);
+            const body = await response.text();
+            if (response.ok && body.includes(expected)) {
+                return { ok: true, body };
+            }
+        }
+        catch {
+            // retry
+        }
+        await new Promise((resolve) => setTimeout(resolve, 150));
+    }
+    return { ok: false, body: '' };
+}
+async function runHttpStartCheck(check, cwd) {
+    const env = {};
+    const port = await reservePort();
+    env['PORT'] = String(port);
+    if (check.runOnce) {
+        env['RUN_ONCE'] = '1';
+    }
+    const command = check.command;
+    const [bin, ...args] = command;
+    const child = spawn(bin, args, {
+        cwd,
+        env: { ...process.env, ...env },
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    let stdout = '';
+    let stderr = '';
+    child.stdout?.on('data', (chunk) => {
+        stdout += chunk.toString();
+    });
+    child.stderr?.on('data', (chunk) => {
+        stderr += chunk.toString();
+    });
+    // Bail early if process exits before HTTP check completes
+    let processExited = false;
+    child.on('close', () => {
+        processExited = true;
+    });
+    try {
+        const url = `http://127.0.0.1:${port}${check.path}`;
+        const result = await waitForHttp(url, check.expect ?? 'ok', 5000);
+        if (!result.ok) {
+            if (processExited) {
+                throw new Error(`Server exited before HTTP check completed for ${url}`);
+            }
+            throw new Error(`HTTP check failed for ${url}`);
+        }
+        return { ok: true, stdout, stderr };
+    }
+    finally {
+        child.kill('SIGTERM');
+        await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+}
+async function runCommandSuccessCheck(check, cwd) {
+    const result = await runCommand(check.command, cwd, check.env ?? {});
+    if (result.code !== 0) {
+        throw new Error(`Command failed: ${check.command.join(' ')}`);
+    }
+    if (check.expect && !result.stdout.includes(check.expect) && !result.stderr.includes(check.expect)) {
+        throw new Error(`Command output missing expected text: ${check.expect}`);
+    }
+    return result;
+}
+async function runPythonCompileCheck(check, cwd) {
+    const result = await runCommand(['python3', '-m', 'py_compile', check.path], cwd);
+    if (result.code !== 0) {
+        throw new Error(result.stderr || `Python compile failed for ${check.path}`);
+    }
+    return result;
+}
+async function runCheck(check, cwd) {
+    switch (check.type) {
+        case 'file-exists': {
+            const exists = await fileExists(path.join(cwd, check.path));
+            if (!exists) {
+                throw new Error(`Missing required file ${check.path}`);
+            }
+            return { type: check.type, path: check.path, ok: true };
+        }
+        case 'node-syntax': {
+            const result = await runCommand(['node', '--check', check.path], cwd);
+            if (result.code !== 0) {
+                throw new Error(result.stderr || `Node syntax failed for ${check.path}`);
+            }
+            return { type: check.type, path: check.path, ok: true };
+        }
+        case 'http-start': {
+            await runHttpStartCheck(check, cwd);
+            return { type: check.type, path: check.path, ok: true };
+        }
+        case 'command-success': {
+            await runCommandSuccessCheck(check, cwd);
+            return { type: check.type, command: check.command, ok: true };
+        }
+        case 'python-compile': {
+            await runPythonCompileCheck(check, cwd);
+            return { type: check.type, path: check.path, ok: true };
+        }
+        default:
+            throw new Error(`Unsupported validation check ${check.type}`);
+    }
+}
+export async function validateStarter({ spec, outDir = null, }) {
+    const composedDir = outDir ?? (await createTempDir('starter-foundry-validate'));
+    const cleanup = !outDir;
+    const composeResult = await composeStarter({ spec, outDir: composedDir });
+    const composeReport = await readJson(composeResult.composeReportPath);
+    const results = [];
+    try {
+        for (const check of composeReport.validationChecks) {
+            const startedAt = performance.now();
+            try {
+                const result = await runCheck(check, composedDir);
+                results.push({
+                    ok: true,
+                    check,
+                    durationMs: Math.round(performance.now() - startedAt),
+                    result,
+                });
+            }
+            catch (error) {
+                results.push({
+                    ok: false,
+                    check,
+                    durationMs: Math.round(performance.now() - startedAt),
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    finally {
+        if (cleanup) {
+            await removeDir(composedDir);
+        }
+    }
+    return {
+        ok: results.every((result) => result.ok),
+        outDir: composedDir,
+        checks: results,
+    };
+}
+//# sourceMappingURL=validate.js.map