@tangle-network/starter-foundry 0.5.4 → 0.7.2

package/dist/lib/build-plan.js

@@ -20,13 +20,44 @@ const FAMILY_ARCHITECTURE = {
     'worker-job': ['Background worker loop', 'RUN_ONCE mode for validation', 'Signal handling for graceful shutdown'],
     'cloudflare-worker-ts': ['Cloudflare Worker', 'Edge runtime', 'Durable Objects if stateful'],
 };
-function gatherBuildHints(components) {
+export function gatherBuildHints(components) {
     const pages = [];
     const apiRoutes = [];
     const componentNames = [];
     const dataModels = [];
     const integrations = [];
     const architectureNotes = [];
+    const firstSteps = [];
+    const gotchas = [];
+    const placeholders = [];
+    // Family buildHints first — runtime-level guidance runs before layers.
+    const familyHints = components.family.buildHints;
+    if (familyHints) {
+        if (familyHints.pages)
+            pages.push(...familyHints.pages);
+        if (familyHints.apiRoutes)
+            apiRoutes.push(...familyHints.apiRoutes);
+        if (familyHints.components)
+            componentNames.push(...familyHints.components);
+        if (familyHints.dataModels)
+            dataModels.push(...familyHints.dataModels);
+        if (familyHints.integrations)
+            integrations.push(...familyHints.integrations);
+        if (familyHints.architectureNotes)
+            architectureNotes.push(...familyHints.architectureNotes);
+        if (familyHints.firstSteps) {
+            for (const step of familyHints.firstSteps)
+                firstSteps.push({ source: `family:${components.family.id}`, step });
+        }
+        if (familyHints.gotchas) {
+            for (const note of familyHints.gotchas)
+                gotchas.push({ source: `family:${components.family.id}`, note });
+        }
+        if (familyHints.placeholders) {
+            for (const p of familyHints.placeholders)
+                placeholders.push({ source: `family:${components.family.id}`, ...p });
+        }
+    }
     for (const layer of components.layers) {
         const hints = layer.buildHints;
         if (!hints)
@@ -43,6 +74,35 @@ function gatherBuildHints(components) {
             integrations.push(...hints.integrations);
         if (hints.architectureNotes)
             architectureNotes.push(...hints.architectureNotes);
+        if (hints.firstSteps) {
+            for (const step of hints.firstSteps)
+                firstSteps.push({ source: `${layer.group}:${layer.id}`, step });
+        }
+        if (hints.gotchas) {
+            for (const note of hints.gotchas)
+                gotchas.push({ source: `${layer.group}:${layer.id}`, note });
+        }
+        if (hints.placeholders) {
+            for (const p of hints.placeholders)
+                placeholders.push({ source: `${layer.group}:${layer.id}`, ...p });
+        }
+    }
+    if (components.partner?.buildHints) {
+        const hints = components.partner.buildHints;
+        if (hints.firstSteps) {
+            for (const step of hints.firstSteps)
+                firstSteps.push({ source: `partner:${components.partner.id}`, step });
+        }
+        if (hints.gotchas) {
+            for (const note of hints.gotchas)
+                gotchas.push({ source: `partner:${components.partner.id}`, note });
+        }
+        if (hints.placeholders) {
+            for (const p of hints.placeholders)
+                placeholders.push({ source: `partner:${components.partner.id}`, ...p });
+        }
+        if (hints.architectureNotes)
+            architectureNotes.push(...hints.architectureNotes);
     }
     return {
         pages: [...new Set(pages)],
@@ -51,6 +111,9 @@ function gatherBuildHints(components) {
         dataModels: [...new Set(dataModels)],
         integrations: [...new Set(integrations)],
         architectureNotes: [...new Set(architectureNotes)],
+        firstSteps,
+        gotchas,
+        placeholders,
     };
 }
 export function generateBuildPlan(spec, components) {
@@ -98,6 +161,9 @@ export function generateBuildPlan(spec, components) {
         dataModels,
         integrations,
         firstMoves,
+        domainFirstSteps: hints.firstSteps,
+        domainGotchas: hints.gotchas,
+        placeholders: hints.placeholders,
         designDirective,
         presetCode,
     };

package/dist/lib/build-plan.js.map

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

package/dist/lib/buildout-traces.d.ts

@@ -62,8 +62,17 @@ export interface BuildoutOutcome {
     shotsToConvergence: number | null;
     wallMs: number;
     toolCallsTotal: number;
+    /**
+     * Estimated USD cost for the session, summed across all LLM calls.
+     * Null when cost telemetry wasn't captured (older runs, or agents that
+     * don't emit token counts). Enables $/scaffold rollups and
+     * cost-per-capability attribution without re-running buildouts.
+     */
+    costUsd?: number | null;
+    /** Total input + output tokens across all LLM calls in the session. */
+    tokenCount?: number | null;
 }
-export interface MinerState {
+interface MinerState {
     schemaVersion: typeof BUILDOUT_SCHEMA_VERSION;
     /** Per-source-path last mtime observed. Unchanged mtime → skip. */
     mtimes: Record<string, number>;
@@ -111,3 +120,63 @@ export declare function parseSlug(slug: string): {
 export declare const VERTICAL_TO_PARTNER: Record<string, string>;
 /** Does the slug describe a factory-local scaffold buildout? */
 export declare function isBuildoutSlug(slug: string): boolean;
+export interface BuildoutEventInput {
+    /** Unique session id — any opaque stable string from the caller's run. */
+    sessionId: string;
+    /** e.g. "blueprint-agent-vb", "claude-code", "glm-5-1". Required for per-model rollups. */
+    sourceModel: string;
+    /** Source path (JSONL, run dir, session file) for audit + debugging. */
+    sourcePath?: string;
+    scenarioId?: string | null;
+    partnerGuess?: string | null;
+    replayRound?: number | null;
+    firstTs?: string | null;
+    lastTs?: string | null;
+    initialPrompt?: string | null;
+    addedPackages?: BuildoutEvent['addedPackages'];
+    addedDirs?: string[];
+    rewrittenFiles?: string[];
+    outcome?: BuildoutOutcome | null;
+}
+/**
+ * Append a BuildoutEvent to the pipeline. Atomic (O_APPEND) — safe to call
+ * from multiple concurrent processes. Creates the containing directory on
+ * first call.
+ *
+ * Example (blueprint-agent):
+ *
+ * ```ts
+ * import { emitBuildoutEvent } from '@tangle-network/starter-foundry'
+ *
+ * await emitBuildoutEvent({
+ *   sessionId: run.id,
+ *   sourceModel: 'blueprint-agent-vb',
+ *   sourcePath: run.manifestPath,
+ *   scenarioId: run.scenarioId,
+ *   partnerGuess: run.verticalId,
+ *   replayRound: run.round,
+ *   initialPrompt: run.prompt,
+ *   addedPackages: run.packagesInstalled.map((n) => ({ pm: 'pnpm', name: n })),
+ *   addedDirs: run.dirsCreated,
+ *   rewrittenFiles: run.filesEdited,
+ *   outcome: {
+ *     source: 'vb-execution',
+ *     allPass: run.verification.allPass,
+ *     blendedScore: run.verification.blendedScore,
+ *     failingLayers: run.verification.failingLayers,
+ *     shotsRun: run.verification.shotsRun,
+ *     shotsToConvergence: run.verification.shotsToConvergence,
+ *     wallMs: run.wallMs,
+ *     toolCallsTotal: run.toolCallsTotal,
+ *   },
+ * })
+ * ```
+ *
+ * Downstream: our capability-gap detector, template-rewrite analyzer, and
+ * meta-harness training data will pick up these events on the next
+ * `run-buildout-pipeline.mjs` invocation.
+ */
+export declare function emitBuildoutEvent(input: BuildoutEventInput, options?: {
+    path?: string;
+}): Promise<BuildoutEvent>;
+export {};

package/dist/lib/buildout-traces.js

@@ -80,4 +80,70 @@ export const VERTICAL_TO_PARTNER = {
 export function isBuildoutSlug(slug) {
     return slug.startsWith('-private-var-folders-') && slug.includes('factory-local-phase2-');
 }
+/**
+ * Append a BuildoutEvent to the pipeline. Atomic (O_APPEND) — safe to call
+ * from multiple concurrent processes. Creates the containing directory on
+ * first call.
+ *
+ * Example (blueprint-agent):
+ *
+ * ```ts
+ * import { emitBuildoutEvent } from '@tangle-network/starter-foundry'
+ *
+ * await emitBuildoutEvent({
+ *   sessionId: run.id,
+ *   sourceModel: 'blueprint-agent-vb',
+ *   sourcePath: run.manifestPath,
+ *   scenarioId: run.scenarioId,
+ *   partnerGuess: run.verticalId,
+ *   replayRound: run.round,
+ *   initialPrompt: run.prompt,
+ *   addedPackages: run.packagesInstalled.map((n) => ({ pm: 'pnpm', name: n })),
+ *   addedDirs: run.dirsCreated,
+ *   rewrittenFiles: run.filesEdited,
+ *   outcome: {
+ *     source: 'vb-execution',
+ *     allPass: run.verification.allPass,
+ *     blendedScore: run.verification.blendedScore,
+ *     failingLayers: run.verification.failingLayers,
+ *     shotsRun: run.verification.shotsRun,
+ *     shotsToConvergence: run.verification.shotsToConvergence,
+ *     wallMs: run.wallMs,
+ *     toolCallsTotal: run.toolCallsTotal,
+ *   },
+ * })
+ * ```
+ *
+ * Downstream: our capability-gap detector, template-rewrite analyzer, and
+ * meta-harness training data will pick up these events on the next
+ * `run-buildout-pipeline.mjs` invocation.
+ */
+export async function emitBuildoutEvent(input, options = {}) {
+    if (!input.sessionId)
+        throw new Error('emitBuildoutEvent: sessionId is required');
+    if (!input.sourceModel)
+        throw new Error('emitBuildoutEvent: sourceModel is required');
+    const event = {
+        schemaVersion: BUILDOUT_SCHEMA_VERSION,
+        sessionId: input.sessionId,
+        sourcePath: input.sourcePath ?? '',
+        sourceModel: input.sourceModel,
+        scenarioId: input.scenarioId ?? null,
+        partnerGuess: input.partnerGuess ?? null,
+        replayRound: input.replayRound ?? null,
+        firstTs: input.firstTs ?? null,
+        lastTs: input.lastTs ?? null,
+        initialPrompt: input.initialPrompt ?? null,
+        addedPackages: input.addedPackages ?? [],
+        addedDirs: input.addedDirs ?? [],
+        rewrittenFiles: input.rewrittenFiles ?? [],
+        outcome: input.outcome ?? null,
+    };
+    const { mkdir, appendFile } = await import('node:fs/promises');
+    const { dirname } = await import('node:path');
+    const targetPath = options.path ?? DEFAULT_PATHS.buildoutsJsonl;
+    await mkdir(dirname(targetPath), { recursive: true });
+    await appendFile(targetPath, `${JSON.stringify(event)}\n`, 'utf8');
+    return event;
+}
 //# sourceMappingURL=buildout-traces.js.map

package/dist/lib/buildout-traces.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildout-traces.js","sourceRoot":"","sources":["../../src/lib/buildout-traces.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,qDAAqD;AACrD,EAAE;AACF,uEAAuE;AACvE,8DAA8D;AAC9D,EAAE;AACF,6CAA6C;AAC7C,6CAA6C;AAC7C,gEAAgE;AAChE,EAAE;AACF,8DAA8D;AAC9D,6CAA6C;AAC7C,0DAA0D;AAC1D,EAAE;AACF,gCAAgC;AAChC,wCAAwC;AACxC,uEAAuE;AACvE,EAAE;AACF,uDAAuD;AACvD,uEAAuE;AACvE,yEAAyE;AACzE,wEAAwE;AACxE,qBAAqB;AACrB,0DAA0D;AAC1D,0DAA0D;AAC1D,EAAE;AACF,wEAAwE;AACxE,uEAAuE;AACvE,yCAAyC;AAEzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAA;AAgFxC,uDAAuD;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,cAAc,EAAE,gCAAgC;IAChD,UAAU,EAAE,4CAA4C;IACxD,WAAW,EAAE,wCAAwC;IACrD,WAAW,EAAE,gBAAgB;IAC7B,YAAY,EAAE,gCAAgC;CAC/C,CAAA;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,aAAa,EAAE,uBAAuB;QACtC,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,IAAI;KACd,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IAKpC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAA;IAC5F,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IAC1E,OAAO;QACL,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI;QAC1B,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI;QACxB,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,IAAI;KACtD,CAAA;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IACzD,aAAa,EAAE,qBAAqB;IACpC,iBAAiB,EAAE,qBAAqB;IACxC,WAAW,EAAE,iBAAiB;IAC9B,WAAW,EAAE,gBAAgB;IAC7B,uBAAuB,EAAE,mBAAmB;IAC5C,uBAAuB,EAAE,mBAAmB;CAC7C,CAAA;AAED,gEAAgE;AAChE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAA;AAC3F,CAAC"}
+{"version":3,"file":"buildout-traces.js","sourceRoot":"","sources":["../../src/lib/buildout-traces.ts"],"names":[],"mappings":"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"}

package/dist/lib/canary.d.ts

@@ -0,0 +1,38 @@
+export interface CanaryExperiment {
+    name: string;
+    /** 0..1 — fraction of consumers routed to canary */
+    percent: number;
+    /** ISO timestamp after which the experiment is considered inactive */
+    expiresAt?: string | null;
+    /** Optional explicit consumer key allowlist (always routed to canary) */
+    force?: string[];
+    /** Optional explicit consumer key denylist (always routed to main) */
+    exclude?: string[];
+}
+export type CanaryBucket = 'canary' | 'main';
+/**
+ * Core A/B decision primitive. Given a consumer key and an experiment,
+ * returns which bucket the consumer lands in.
+ *
+ * Deterministic: the same `(consumerKey, experiment.name)` tuple always
+ * produces the same bucket. Change the experiment name (not just the
+ * percentage) to re-randomize.
+ */
+export declare function decideCanaryBucket(consumerKey: string, experiment: CanaryExperiment): CanaryBucket;
+/**
+ * Select the registry version (canary vs main) for a given consumer.
+ * Returns an absolute path the composer should use as its registry root.
+ *
+ * Falls back to `registry/` if:
+ *   - experiment routes the consumer to main
+ *   - `registry-canary/` doesn't exist on disk (guard against missing dir)
+ */
+export declare function selectCanaryVersion(consumerKey: string, experiment: CanaryExperiment): Promise<{
+    bucket: CanaryBucket;
+    registryRoot: string;
+}>;
+/**
+ * Default 5%-canary experiment the CI/CD pipeline promotes by name.
+ * Tests import this to exercise the canonical config.
+ */
+export declare const DEFAULT_CANARY_EXPERIMENT: CanaryExperiment;

package/dist/lib/canary.js

@@ -0,0 +1,91 @@
+/**
+ * Canary release routing.
+ *
+ * Routes a configurable fraction of compose requests to a canary registry
+ * (parallel to `registry/` at `registry-canary/`). Decision is deterministic
+ * given a `consumerKey`, so the same consumer always lands in the same bucket
+ * for the lifetime of an experiment — no session-affinity store needed.
+ *
+ * Hash function: FNV-1a 32-bit over `experiment:consumerKey`. The output is
+ * uniformly distributed so `mod 10000 < pct*100` gives the target split to
+ * within ±0.5pp over any reasonable sample of consumer keys.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { resolveRepoRoot } from './fs.js';
+const FNV_OFFSET_32 = 0x811c9dc5;
+const FNV_PRIME_32 = 0x01000193;
+/**
+ * FNV-1a 32-bit. Deterministic and dependency-free. Output is [0, 2^32).
+ * Multiplication is force-truncated with Math.imul to avoid 53-bit float drift
+ * on strings > ~6 chars where the running product silently overflows.
+ */
+function fnv1a32(input) {
+    let hash = FNV_OFFSET_32;
+    for (let i = 0; i < input.length; i++) {
+        hash ^= input.charCodeAt(i);
+        hash = Math.imul(hash, FNV_PRIME_32);
+    }
+    return hash >>> 0;
+}
+/**
+ * Core A/B decision primitive. Given a consumer key and an experiment,
+ * returns which bucket the consumer lands in.
+ *
+ * Deterministic: the same `(consumerKey, experiment.name)` tuple always
+ * produces the same bucket. Change the experiment name (not just the
+ * percentage) to re-randomize.
+ */
+export function decideCanaryBucket(consumerKey, experiment) {
+    if (experiment.exclude?.includes(consumerKey))
+        return 'main';
+    if (experiment.force?.includes(consumerKey))
+        return 'canary';
+    if (experiment.expiresAt) {
+        const expires = Date.parse(experiment.expiresAt);
+        if (!Number.isNaN(expires) && Date.now() > expires)
+            return 'main';
+    }
+    const pct = Math.max(0, Math.min(1, experiment.percent));
+    if (pct <= 0)
+        return 'main';
+    if (pct >= 1)
+        return 'canary';
+    // 4-digit resolution — 0.01% granularity is plenty for 5% rollouts.
+    const bucket = fnv1a32(`${experiment.name}:${consumerKey}`) % 10000;
+    return bucket < Math.floor(pct * 10000) ? 'canary' : 'main';
+}
+/**
+ * Select the registry version (canary vs main) for a given consumer.
+ * Returns an absolute path the composer should use as its registry root.
+ *
+ * Falls back to `registry/` if:
+ *   - experiment routes the consumer to main
+ *   - `registry-canary/` doesn't exist on disk (guard against missing dir)
+ */
+export async function selectCanaryVersion(consumerKey, experiment) {
+    const repoRoot = await resolveRepoRoot();
+    const mainRoot = path.join(repoRoot, 'registry');
+    const canaryRoot = path.join(repoRoot, 'registry-canary');
+    const bucket = decideCanaryBucket(consumerKey, experiment);
+    if (bucket === 'main')
+        return { bucket, registryRoot: mainRoot };
+    try {
+        const stat = await fs.stat(canaryRoot);
+        if (!stat.isDirectory())
+            return { bucket: 'main', registryRoot: mainRoot };
+    }
+    catch {
+        return { bucket: 'main', registryRoot: mainRoot };
+    }
+    return { bucket: 'canary', registryRoot: canaryRoot };
+}
+/**
+ * Default 5%-canary experiment the CI/CD pipeline promotes by name.
+ * Tests import this to exercise the canonical config.
+ */
+export const DEFAULT_CANARY_EXPERIMENT = {
+    name: 'registry-canary-v1',
+    percent: 0.05,
+};
+//# sourceMappingURL=canary.js.map

package/dist/lib/canary.js.map

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

package/dist/lib/capability-inferrer.d.ts

@@ -1,4 +1,4 @@
-export interface PackageCapabilityMap {
+interface PackageCapabilityMap {
     schemaVersion: 1;
     mapping: Record<string, {
         capability: string | null;
@@ -6,7 +6,7 @@ export interface PackageCapabilityMap {
         note?: string;
     }>;
 }
-export interface BuildoutLike {
+interface BuildoutLike {
     sessionId: string;
     initialPrompt: string | null;
     scenarioId: string | null;
@@ -20,13 +20,13 @@ export interface BuildoutLike {
         blendedScore: number;
     } | null;
 }
-export interface InferredCapability {
+interface InferredCapability {
     capability: string;
     confidence: number;
     source: 'package' | 'dir';
     sourceToken: string;
 }
-export interface CapabilityMapSummary {
+interface CapabilityMapSummary {
     distinctPackages: number;
     mappedPackages: number;
     unmappedPackages: number;
@@ -38,3 +38,4 @@ export declare function loadCapabilityMap(path?: string): PackageCapabilityMap;
 export declare function inferCapabilities(buildout: BuildoutLike, map: PackageCapabilityMap): InferredCapability[];
 /** Summary stats over a mapping (for diagnostic CLIs / tests). */
 export declare function summarizeMap(map: PackageCapabilityMap): CapabilityMapSummary;
+export {};

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

@@ -16,7 +16,8 @@
  * are React-flavored) and made them duplicate the canonical agent instruction
  * wording across their codebase. This function is the single supported entrypoint.
  */
-import type { ComposeResult, ComposeSpec } from '../types.js';
+import { type ComposeWorkspaceResult } from './workspace.js';
+import type { ComposeResult, ComposeSpec, WorkspaceSpec } from '../types.js';
 export interface ComposeFromPromptOptions {
     /** Free-text user prompt — drives family routing and industry detection. */
     prompt: string;
@@ -34,17 +35,17 @@ export type ComposeFromPromptResult = {
     contextMessage: string;
 } | {
     kind: 'workspace';
-    reason: string;
+    spec: WorkspaceSpec;
+    result: ComposeWorkspaceResult;
+    contextMessage: string;
 } | {
     kind: 'error';
     error: string;
 };
 /**
- * Compose a scaffold from a free-text prompt. Returns a discriminated union
- * so callers handle workspace and error cases explicitly.
+ * Compose a scaffold from a free-text prompt. Returns a discriminated union.
  *
- * Workspace prompts (multi-project) are not composed automatically — they
- * need a workspace spec, and the caller should fall through to from-scratch
- * agent build or call composeWorkspace directly.
+ * Auto-dispatches to composeStarter or composeWorkspace based on the plan
+ * kind — downstream callers don't need to branch on plan.kind themselves.
  */
 export declare function composeFromPrompt(options: ComposeFromPromptOptions): Promise<ComposeFromPromptResult>;

package/dist/lib/compose-prompt.js

@@ -18,14 +18,13 @@
  */
 import { composeStarter } from './compose.js';
 import { planPrompt } from './prompt-planner.js';
+import { composeWorkspace } from './workspace.js';
 import { getComposedScaffoldContext } from './agent-context.js';
 /**
- * Compose a scaffold from a free-text prompt. Returns a discriminated union
- * so callers handle workspace and error cases explicitly.
+ * Compose a scaffold from a free-text prompt. Returns a discriminated union.
  *
- * Workspace prompts (multi-project) are not composed automatically — they
- * need a workspace spec, and the caller should fall through to from-scratch
- * agent build or call composeWorkspace directly.
+ * Auto-dispatches to composeStarter or composeWorkspace based on the plan
+ * kind — downstream callers don't need to branch on plan.kind themselves.
  */
 export async function composeFromPrompt(options) {
     const { prompt, outDir, partner = null, projectName = 'scaffold' } = options;
@@ -39,12 +38,25 @@ export async function composeFromPrompt(options) {
     catch (err) {
         return { kind: 'error', error: `planPrompt failed: ${err.message}` };
     }
-    if (plan.kind !== 'starter') {
+    if (plan.kind === 'workspace') {
+        const spec = plan.spec;
+        let result;
+        try {
+            result = await composeWorkspace({ spec, outDir });
+        }
+        catch (err) {
+            return { kind: 'error', error: `composeWorkspace failed: ${err.message}` };
+        }
         return {
             kind: 'workspace',
-            reason: 'multi-project workspace prompts are not auto-composed; caller should compose each project explicitly',
+            spec,
+            result,
+            contextMessage: getComposedWorkspaceContext(result),
         };
     }
+    if (plan.kind !== 'starter') {
+        return { kind: 'error', error: `planPrompt returned unexpected kind: ${plan.kind}` };
+    }
     // planPrompt has already attached capabilities, industry, and family-default
     // capabilities (tailwind + shadcn for React families). The spec is ready to compose.
     const spec = {
@@ -65,4 +77,15 @@ export async function composeFromPrompt(options) {
         contextMessage: getComposedScaffoldContext(result),
     };
 }
+function getComposedWorkspaceContext(result) {
+    const lines = [
+        `Composed workspace with ${result.projectCount} project(s) at ${result.outDir}.`,
+        `Launch plan written to ${result.launchPlanPath}.`,
+        `Workspace report written to ${result.workspaceReportPath}.`,
+        '',
+        'Projects:',
+        ...result.projects.map((p) => `  - ${p.id} (${p.components.family}) → ${p.path}`),
+    ];
+    return lines.join('\n');
+}
 //# sourceMappingURL=compose-prompt.js.map

package/dist/lib/compose-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose-prompt.js","sourceRoot":"","sources":["../../src/lib/compose-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA;AA8B/D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAiC;IAEjC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,WAAW,GAAG,UAAU,EAAE,GAAG,OAAO,CAAA;IAE5E,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAA;IACvD,CAAC;IAED,IAAI,IAAI,CAAA;IACR,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,sBAAuB,GAAa,CAAC,OAAO,EAAE,EAAE,CAAA;IACjF,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,sGAAsG;SAC/G,CAAA;IACH,CAAC;IAED,6EAA6E;IAC7E,qFAAqF;IACrF,MAAM,IAAI,GAAgB;QACxB,GAAG,IAAI,CAAC,IAAI;QACZ,WAAW;KACZ,CAAA;IAED,IAAI,MAAqB,CAAA;IACzB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,0BAA2B,GAAa,CAAC,OAAO,EAAE,EAAE,CAAA;IACrF,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,IAAI;QACJ,MAAM;QACN,cAAc,EAAE,0BAA0B,CAAC,MAAM,CAAC;KACnD,CAAA;AACH,CAAC"}
+{"version":3,"file":"compose-prompt.js","sourceRoot":"","sources":["../../src/lib/compose-prompt.ts"],"names":[],"mappings":"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"}

package/dist/lib/compose-seed.d.ts

@@ -0,0 +1,15 @@
+import type { ComposeSpec } from '../types.js';
+/**
+ * Derive the 32-byte replay seed for a compose spec. Pure function of
+ * the spec shape — not of time, random, or env unless the operator
+ * explicitly overrides via STARTER_FOUNDRY_SEED.
+ */
+export declare function deriveComposeSeed(spec: ComposeSpec, envSeed?: string): Buffer;
+/**
+ * Convenience: first 4 bytes as uint32 (for modulo picks).
+ */
+export declare function seedToUint32(seed: Buffer): number;
+/**
+ * Convenience: hex-encoded seed for logging + audit trails.
+ */
+export declare function seedToHex(seed: Buffer): string;

package/dist/lib/compose-seed.js

@@ -0,0 +1,44 @@
+// compose-seed.ts — deterministic seed for bit-identical replay of
+// composeStarter(). Every component of the compose result that's
+// seed-dependent (variant picks, library version picks, brand-tokens
+// hash fallback) reads a single 32-byte seed derived from:
+//
+//   SHA-256(projectName + "|" + family + "|" + sorted(layers).join(",") + "|" + partnerId)
+//
+// Plus an optional STARTER_FOUNDRY_SEED env override for testing or
+// explicit replay. Passing the same spec + same seed to composeStarter
+// must produce byte-identical output — the reproducibility guarantee
+// consumers need for signed audit trails + supply-chain provenance.
+import { createHash } from 'node:crypto';
+/**
+ * Derive the 32-byte replay seed for a compose spec. Pure function of
+ * the spec shape — not of time, random, or env unless the operator
+ * explicitly overrides via STARTER_FOUNDRY_SEED.
+ */
+export function deriveComposeSeed(spec, envSeed) {
+    const override = envSeed ?? process.env['STARTER_FOUNDRY_SEED'];
+    if (override && /^[a-f0-9]{64}$/i.test(override)) {
+        return Buffer.from(override, 'hex');
+    }
+    const layers = [...(spec.layers ?? [])].sort().join(',');
+    const parts = [
+        spec.projectName,
+        spec.family,
+        layers,
+        spec.partner ?? '',
+    ];
+    return createHash('sha256').update(parts.join('|')).digest();
+}
+/**
+ * Convenience: first 4 bytes as uint32 (for modulo picks).
+ */
+export function seedToUint32(seed) {
+    return seed.readUInt32BE(0);
+}
+/**
+ * Convenience: hex-encoded seed for logging + audit trails.
+ */
+export function seedToHex(seed) {
+    return seed.toString('hex');
+}
+//# sourceMappingURL=compose-seed.js.map