@tangle-network/starter-foundry 0.1.0

package/dist/lib/build-plan.js

@@ -0,0 +1,144 @@
+const FAMILY_ARCHITECTURE = {
+    'nextjs-ts': ['Next.js App Router', 'Server Components', 'Server Actions for mutations', 'Middleware for auth'],
+    'react-vite-ts': ['React SPA', 'Vite build', 'Client-side routing', 'REST or tRPC for backend'],
+    'fullstack-ts': ['Node.js HTTP server', 'TypeScript with experimental strip-types', 'Server-rendered HTML', 'JSON API endpoints'],
+    'sveltekit-ts': ['SvelteKit with SSR', 'File-based routing', 'Form actions', 'Load functions'],
+    'remix-ts': ['Remix with nested routing', 'Loaders for data fetching', 'Actions for mutations', 'Progressive enhancement'],
+    'vue-ts': ['Vue 3 Composition API', 'Vite build', 'Client-side routing with vue-router'],
+    'angular-ts': ['Angular standalone components', 'Signals for reactivity', 'Dependency injection'],
+    'api-service': ['Node.js HTTP server', 'JSON API', 'Health endpoint pattern'],
+    'python-api': ['Python HTTP server', 'JSON API', 'Async handlers if using FastAPI'],
+    'go-api': ['Go net/http', 'JSON API', 'Middleware chain'],
+    'rust-service': ['Rust HTTP server', 'Typed routes', 'Error handling with Result'],
+    'agent-service-ts': ['Agent control loop: plan → act → reflect', 'Tool registration', 'Memory/state management', 'HTTP health endpoint'],
+    'agent-service-py': ['Agent control loop: plan → act → reflect', 'Tool registration', 'Memory/state management', 'HTTP health endpoint'],
+    'agent-service-rust': ['Agent control loop: plan → act → reflect', 'Tool registration', 'Typed state management'],
+    'forge-contracts': ['Foundry project', 'Solidity contracts in src/', 'Tests in test/', 'Deploy scripts in script/'],
+    'hardhat-contracts': ['Hardhat TypeScript', 'Contracts in contracts/', 'Deploy tasks', 'Hardhat config with network settings'],
+    '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) {
+    const pages = [];
+    const apiRoutes = [];
+    const componentNames = [];
+    const dataModels = [];
+    const integrations = [];
+    const architectureNotes = [];
+    for (const layer of components.layers) {
+        const hints = layer.buildHints;
+        if (!hints)
+            continue;
+        if (hints.pages)
+            pages.push(...hints.pages);
+        if (hints.apiRoutes)
+            apiRoutes.push(...hints.apiRoutes);
+        if (hints.components)
+            componentNames.push(...hints.components);
+        if (hints.dataModels)
+            dataModels.push(...hints.dataModels);
+        if (hints.integrations)
+            integrations.push(...hints.integrations);
+        if (hints.architectureNotes)
+            architectureNotes.push(...hints.architectureNotes);
+    }
+    return {
+        pages: [...new Set(pages)],
+        apiRoutes: [...new Set(apiRoutes)],
+        componentNames: [...new Set(componentNames)],
+        dataModels: [...new Set(dataModels)],
+        integrations: [...new Set(integrations)],
+        architectureNotes: [...new Set(architectureNotes)],
+    };
+}
+export function generateBuildPlan(spec, components) {
+    const prompt = spec.userPrompt ?? '';
+    const familyArch = FAMILY_ARCHITECTURE[spec.family] ?? [];
+    const hints = gatherBuildHints(components);
+    const architecture = [...familyArch, ...hints.architectureNotes];
+    const pages = hints.pages;
+    const apiRoutes = hints.apiRoutes;
+    const componentNames = hints.componentNames;
+    const dataModels = hints.dataModels;
+    const integrations = hints.integrations;
+    // Generate first moves based on what's in the scaffold
+    const firstMoves = [];
+    if (prompt) {
+        firstMoves.push(`User goal: "${prompt}"`);
+    }
+    if (pages.length > 0) {
+        firstMoves.push(`Create pages: ${pages.join(', ')}`);
+    }
+    if (apiRoutes.length > 0) {
+        firstMoves.push(`Wire API routes: ${apiRoutes.join(', ')}`);
+    }
+    if (componentNames.length > 0) {
+        firstMoves.push(`Build components: ${componentNames.join(', ')}`);
+    }
+    if (integrations.length > 0) {
+        firstMoves.push(`Integrate: ${integrations.join(', ')}`);
+    }
+    if (firstMoves.length === 0) {
+        firstMoves.push('Extend the entry points listed in the compose report.');
+        firstMoves.push('Run the validated commands to verify the scaffold works before editing.');
+    }
+    // Generate design directive for frontend families
+    const designDirective = generateDesignDirective(spec, components);
+    // Extract shadcn preset code from layer defaults
+    const shadcnLayer = components.layers.find((l) => l.group === 'capability' && l.id === 'shadcn');
+    const presetCode = shadcnLayer?.defaults?.presetCode ?? null;
+    return {
+        goal: prompt || `Build a ${spec.family} project`,
+        architecture,
+        pages,
+        apiRoutes,
+        components: componentNames,
+        dataModels,
+        integrations,
+        firstMoves,
+        designDirective,
+        presetCode,
+    };
+}
+const FRONTEND_FAMILIES = new Set([
+    'react-vite-ts', 'nextjs-ts', 'fullstack-ts', 'sveltekit-ts',
+    'remix-ts', 'vue-ts', 'angular-ts', 'frontend-static',
+    'electron-desktop-ts', 'tauri-desktop', 'expo-react-native-ts',
+    'browser-extension-ts',
+]);
+/**
+ * Generate prompt-based design directives for the AI agent.
+ * These are English rules about aesthetics, not CSS — the LLM follows them
+ * when generating Tailwind classes and component markup.
+ */
+function generateDesignDirective(spec, components) {
+    if (!FRONTEND_FAMILIES.has(spec.family))
+        return null;
+    const layerIds = new Set(components.layers.map((l) => `${l.group}:${l.id}`));
+    const hasShadcn = layerIds.has('capability:shadcn');
+    const hasTailwind = layerIds.has('capability:tailwind');
+    const hasDashboard = layerIds.has('capability:dashboard-layout');
+    const rules = [
+        'DESIGN RULES (follow these when generating UI code):',
+        '',
+        'General:',
+        '- Build polished, production-quality interfaces — not prototypes.',
+        '- Use consistent spacing (p-4, p-6, gap-4, gap-6). Avoid arbitrary values.',
+        '- Every interactive element needs hover and focus states.',
+        '- Support dark mode via the .dark class and CSS custom properties.',
+        '- Use subtle transitions (transition-colors, duration-150) on interactive elements.',
+        '- Prefer rounded-lg for cards and rounded-md for buttons and inputs.',
+    ];
+    if (hasShadcn) {
+        rules.push('', 'shadcn/ui:', '- 27 components pre-installed in src/components/ui/: Alert, Avatar, Badge, Breadcrumb, Button, Card, Checkbox, Command, Dialog, DropdownMenu, Form, Input, Label, Progress, ScrollArea, Select, Separator, Sheet, Sidebar, Skeleton, Switch, Table, Tabs, Textarea, Toast, Toggle, Tooltip.', '- Import directly: import { Button } from "@/components/ui/button"', '- Use the cn() utility from @/lib/utils for merging Tailwind classes.', '- Never ship unstyled native HTML when a shadcn component exists.', '- For Radix-powered versions, install @radix-ui/* and update the component.', '- Follow the new-york style: tighter spacing, smaller radius, more refined.');
+    }
+    if (hasTailwind) {
+        rules.push('', 'Tailwind:', '- Use the design token colors (bg-background, text-foreground, bg-card, etc.) — never hardcode hex values.', '- Use the color scale for emphasis: text-muted-foreground for secondary text, bg-muted for subtle backgrounds.', '- Responsive: mobile-first. Use sm:, md:, lg: breakpoints.');
+    }
+    if (hasDashboard) {
+        rules.push('', 'Layout:', '- Sidebar: 16rem default, collapsible to 4rem with icon-only mode.', '- Header: sticky, contains breadcrumb trail, search/command palette trigger, theme toggle, user menu.', '- Content: max-w-7xl mx-auto, p-6 padding.', '- Mobile: sidebar collapses to a Sheet/Drawer triggered by hamburger.');
+    }
+    rules.push('', 'Quality bar:', '- Every page should look intentionally designed, not like a code demo.', '- Use proper empty states with illustrations or icons.', '- Loading states: use Skeleton components, not spinners.', '- Error states: use destructive variant Badge or Alert, not raw text.');
+    return rules.join('\n');
+}
+//# sourceMappingURL=build-plan.js.map

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

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

package/dist/lib/catalog.d.ts

@@ -0,0 +1,15 @@
+export declare function buildCatalog(): Promise<{
+    schemaVersion: 1;
+    implemented: Array<{
+        id: string;
+        status: 'implemented';
+        language?: string;
+        runtime?: string;
+        surface?: string;
+        description: string;
+    }>;
+    planned: unknown[];
+    capabilityThemes: string[];
+    databaseTargets: string[];
+    cryptoTargets: string[];
+}>;

package/dist/lib/catalog.js

@@ -0,0 +1,41 @@
+import { loadRegistry } from './registry.js';
+const plannedFamilies = [];
+export async function buildCatalog() {
+    const registry = await loadRegistry();
+    const implemented = [...registry.families.values()].map((family) => ({
+        id: family.id,
+        status: 'implemented',
+        ...(family.taxonomy ?? {}),
+        description: family.description,
+    }));
+    return {
+        schemaVersion: 1,
+        implemented,
+        planned: plannedFamilies,
+        capabilityThemes: [
+            'frontend',
+            'mobile',
+            'extension',
+            'desktop',
+            'automation',
+            'cli',
+            'ai',
+            'backend',
+            'worker',
+            'edge',
+            'data',
+            'protocol',
+            'infra',
+            'database',
+            'auth',
+            'payments',
+            'queue',
+            'sdk',
+            'crypto',
+            'agents',
+        ],
+        databaseTargets: ['convex', 'sqlite', 'postgres', 'mongodb'],
+        cryptoTargets: ['forge', 'solana', 'move'],
+    };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/lib/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/lib/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C,MAAM,eAAe,GAAc,EAAE,CAAA;AAErC,MAAM,CAAC,KAAK,UAAU,YAAY;IAehC,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAA;IACrC,MAAM,WAAW,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACnE,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,MAAM,EAAE,aAAsB;QAC9B,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC,CAAA;IAEH,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,WAAW;QACX,OAAO,EAAE,eAAe;QACxB,gBAAgB,EAAE;YAChB,UAAU;YACV,QAAQ;YACR,WAAW;YACX,SAAS;YACT,YAAY;YACZ,KAAK;YACL,IAAI;YACJ,SAAS;YACT,QAAQ;YACR,MAAM;YACN,MAAM;YACN,UAAU;YACV,OAAO;YACP,UAAU;YACV,MAAM;YACN,UAAU;YACV,OAAO;YACP,KAAK;YACL,QAAQ;YACR,QAAQ;SACT;QACD,eAAe,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC;QAC5D,aAAa,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC;KAC3C,CAAA;AACH,CAAC"}

package/dist/lib/compose.d.ts

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

package/dist/lib/compose.js

@@ -0,0 +1,242 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { generateBuildPlan } from './build-plan.js';
+import { ensureDir, sanitizePackageName, writeJson } from './fs.js';
+import { buildVariables, resolveComponents, resolveTemplateObject } from './registry.js';
+import { emit, traced } from './telemetry.js';
+async function renderFile(sourcePath, targetPath, variables) {
+    const raw = await fs.readFile(sourcePath, 'utf8');
+    const rendered = raw.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
+        if (key in variables) {
+            return String(variables[key]);
+        }
+        return '';
+    });
+    await ensureDir(path.dirname(targetPath));
+    await fs.writeFile(targetPath, rendered, 'utf8');
+}
+function simpleHash(str) {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        hash = ((hash << 5) - hash + str.charCodeAt(i)) | 0;
+    }
+    return Math.abs(hash);
+}
+function resolveVariantSource(component, filePath, variantSeed) {
+    const layer = component;
+    const variants = layer.variants;
+    if (!variants?.length || !filePath.startsWith('files/'))
+        return path.join(component.baseDir, filePath);
+    const idx = simpleHash(variantSeed + layer.id) % variants.length;
+    const variantDir = `variants/${variants[idx]}`;
+    return path.join(component.baseDir, filePath.replace(/^files\//, `${variantDir}/`));
+}
+function collectComponentFiles(component, variantSeed) {
+    return (component.files ?? []).map((file) => ({
+        ...file,
+        source: resolveVariantSource(component, file.source, variantSeed),
+        owner: component.kind === 'layer'
+            ? `${component.group}:${component.id}`
+            : component.id,
+    }));
+}
+function buildComponentOrder(components) {
+    const order = [components.family, ...components.layers];
+    if (components.partner) {
+        order.push(components.partner);
+    }
+    return order;
+}
+function collectValidationChecks(components, variables) {
+    return buildComponentOrder(components).flatMap((component) => resolveTemplateObject(component.validationChecks ?? [], variables));
+}
+function collectContextHints(components, variables) {
+    const merged = {
+        commands: [],
+        entrypoints: [],
+        preview: null,
+        extensionPoints: [],
+    };
+    for (const component of buildComponentOrder(components)) {
+        const hints = resolveTemplateObject(component.contextHints ?? {}, variables);
+        merged.commands.push(...(hints.commands ?? []));
+        merged.entrypoints.push(...(hints.entrypoints ?? []));
+        merged.extensionPoints.push(...(hints.extensionPoints ?? []));
+        if (hints.preview) {
+            merged.preview = hints.preview;
+        }
+    }
+    merged.commands = [...new Set(merged.commands)];
+    merged.entrypoints = [...new Set(merged.entrypoints)];
+    merged.extensionPoints = [...new Set(merged.extensionPoints)];
+    return merged;
+}
+export async function composeStarter({ spec, outDir }) {
+    const { result, durationMs } = await traced('composeStarter', async () => {
+        return composeStarterInner(spec, outDir);
+    });
+    const layers = result.components.layers;
+    emit('compose', {
+        family: spec.family,
+        layers,
+        filesWritten: result.filesWritten,
+        partner: spec.partner ?? null,
+        durationMs,
+    });
+    return result;
+}
+async function mergeMediaManifests(outDir) {
+    const manifestPath = path.join(outDir, 'media-manifest.json');
+    let existing = null;
+    try {
+        const raw = await fs.readFile(manifestPath, 'utf8');
+        existing = JSON.parse(raw);
+    }
+    catch {
+        // no existing manifest
+    }
+    if (!existing || !existing.slots?.length)
+        return [];
+    // Deduplicate by slot id, last write wins
+    const seen = new Map();
+    for (const slot of existing.slots) {
+        seen.set(slot.id, slot);
+    }
+    const merged = { slots: [...seen.values()] };
+    await fs.writeFile(manifestPath, `${JSON.stringify(merged, null, 2)}\n`, 'utf8');
+    return merged.slots;
+}
+async function composeStarterInner(spec, outDir) {
+    const components = await resolveComponents(spec);
+    const variables = buildVariables({
+        ...spec,
+        packageName: spec.packageName ?? sanitizePackageName(spec.projectName),
+    }, components);
+    const componentOrder = buildComponentOrder(components);
+    const fileOwnership = {};
+    const filesWritten = [];
+    const resolvedOutDir = path.resolve(outDir);
+    await ensureDir(outDir);
+    const variantSeed = spec.projectName;
+    for (const component of componentOrder) {
+        const files = collectComponentFiles(component, variantSeed);
+        for (const file of files) {
+            const resolvedTarget = resolveTemplateObject(file.target, variables);
+            const targetPath = path.join(outDir, resolvedTarget);
+            // Guard against directory traversal
+            if (!path.resolve(targetPath).startsWith(resolvedOutDir + path.sep) && path.resolve(targetPath) !== resolvedOutDir) {
+                throw new Error(`File target ${resolvedTarget} would escape output directory`);
+            }
+            await renderFile(file.source, targetPath, variables);
+            fileOwnership[resolvedTarget] = file.owner;
+            filesWritten.push(resolvedTarget);
+        }
+    }
+    const composeReport = {
+        spec,
+        components: {
+            family: components.family.id,
+            layers: components.layers.map((layer) => `${layer.group}:${layer.id}`),
+            partner: components.partner?.id ?? null,
+            slots: components.slotSelections,
+        },
+        variables,
+        fileOwnership,
+        validationChecks: collectValidationChecks(components, variables),
+        contextHints: collectContextHints(components, variables),
+    };
+    await ensureDir(path.join(outDir, '.starter-foundry'));
+    await writeJson(path.join(outDir, '.starter-foundry', 'compose-report.json'), composeReport);
+    // Merge media manifests from all layers into a single root manifest
+    const mediaSlots = await mergeMediaManifests(outDir);
+    // Generate AGENTS.md — per-project agent instructions
+    const agentsMd = buildAgentsMd(spec, components, composeReport.contextHints, mediaSlots);
+    await fs.writeFile(path.join(outDir, 'AGENTS.md'), `${agentsMd}\n`, 'utf8');
+    // Generate llms.txt — machine-readable project description for AI agents
+    const llmsTxt = buildLlmsTxt(spec, components, composeReport.contextHints);
+    await fs.writeFile(path.join(outDir, 'llms.txt'), `${llmsTxt}\n`, 'utf8');
+    return {
+        outDir,
+        filesWritten: [...new Set([...filesWritten, 'AGENTS.md', 'llms.txt'])].sort(),
+        composeReportPath: path.join(outDir, '.starter-foundry', 'compose-report.json'),
+        components: composeReport.components,
+    };
+}
+function buildLlmsTxt(spec, components, contextHints) {
+    const lines = [
+        `# ${spec.projectName}`,
+        '',
+        `> ${components.family.description}`,
+        '',
+        `## Stack`,
+        `- Family: ${spec.family}`,
+        `- Layers: ${components.layers.map(l => `${l.group}:${l.id}`).join(', ')}`,
+        components.partner ? `- Partner: ${components.partner.id}` : null,
+        '',
+        `## Entry Points`,
+        ...contextHints.entrypoints.map(e => `- ${e}`),
+        '',
+        `## Commands`,
+        ...contextHints.commands.map(c => `- ${c}`),
+        '',
+        `## Extension Points`,
+        ...contextHints.extensionPoints.map(e => `- ${e}`),
+    ].filter(line => line !== null);
+    return lines.join('\n');
+}
+function buildAgentsMd(spec, components, contextHints, mediaSlots = []) {
+    const buildPlan = generateBuildPlan(spec, components);
+    const lines = [
+        '# AGENTS.md',
+        '',
+    ];
+    if (buildPlan.goal) {
+        lines.push(buildPlan.goal, '');
+    }
+    lines.push('## What\'s here', '', `This project was scaffolded by starter-foundry. The user\'s prompt drove the choices below — read their prompt first, it takes priority over everything in this file.`, '', `- **Family:** \`${spec.family}\``, `- **Layers:** ${components.layers.map((l) => `\`${l.group}:${l.id}\``).join(', ')}`);
+    if (components.partner) {
+        lines.push(`- **Partner:** \`${components.partner.id}\``);
+    }
+    lines.push('');
+    if (buildPlan.architecture.length > 0) {
+        lines.push('### Architecture notes');
+        buildPlan.architecture.forEach((a) => lines.push(`- ${a}`));
+        lines.push('');
+    }
+    lines.push('## Getting started', '');
+    if (contextHints.commands.length > 0) {
+        lines.push('```bash');
+        contextHints.commands.forEach((c) => lines.push(c));
+        lines.push('```', '');
+    }
+    if (contextHints.entrypoints.length > 0) {
+        lines.push(`Key files: ${contextHints.entrypoints.map((e) => `\`${e}\``).join(', ')}`, '');
+    }
+    if (buildPlan.pages.length > 0 || buildPlan.apiRoutes.length > 0 || buildPlan.components.length > 0) {
+        lines.push('## Suggested build plan', '', 'These are starting points — adapt them to the user\'s actual needs.', '');
+        if (buildPlan.pages.length > 0)
+            lines.push(`- **Pages:** ${buildPlan.pages.join(', ')}`);
+        if (buildPlan.apiRoutes.length > 0)
+            lines.push(`- **API routes:** ${buildPlan.apiRoutes.join(', ')}`);
+        if (buildPlan.components.length > 0)
+            lines.push(`- **Components:** ${buildPlan.components.join(', ')}`);
+        if (buildPlan.dataModels.length > 0)
+            lines.push(`- **Data models:** ${buildPlan.dataModels.join(', ')}`);
+        if (buildPlan.integrations.length > 0)
+            lines.push(`- **Integrations:** ${buildPlan.integrations.join(', ')}`);
+        lines.push('');
+    }
+    if (buildPlan.designDirective) {
+        lines.push('## Design', '', buildPlan.designDirective, '');
+    }
+    if (mediaSlots.length > 0) {
+        lines.push('## Media', '', 'Image slots are declared in `media-manifest.json` with generation prompts.', 'Adapt the prompts to match the user\'s product before generating.', '', '| Slot | Size | Path | Purpose |', '|------|------|------|---------|');
+        for (const slot of mediaSlots) {
+            lines.push(`| ${slot.id} | ${slot.width}\u00d7${slot.height} | \`${slot.path}\` | ${slot.purpose} |`);
+        }
+        lines.push('', 'Skip any slots that don\'t apply. Add new ones if the product needs them.', '');
+    }
+    lines.push('## How to use this scaffold', '', 'This is a starting point, not a contract. You own every file.', '', '- **Customize freely.** Replace components, change the layout, swap the color scheme — whatever fits the user\'s product.', '- **The scaffold saves you setup time** — Tailwind, shadcn/ui, path aliases, and framework config are ready. Don\'t redo them.', '- **Check `.starter-foundry/compose-report.json`** if you want to see which layer wrote which file.', '- **Update this file** as the project evolves. Delete sections that no longer apply.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=compose.js.map

package/dist/lib/compose.js.map

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

package/dist/lib/context-pack.d.ts

@@ -0,0 +1,10 @@
+import type { ComposeSpec, ContextPack } from '../types.js';
+export interface ContextPackResult {
+    outDir: string;
+    contextPath: string;
+    contextPack: ContextPack;
+}
+export declare function createContextPack({ spec, outDir, }: {
+    spec: ComposeSpec;
+    outDir?: string | null;
+}): Promise<ContextPackResult>;

package/dist/lib/context-pack.js

@@ -0,0 +1,49 @@
+import path from 'node:path';
+import { generateBuildPlan } from './build-plan.js';
+import { composeStarter } from './compose.js';
+import { createTempDir, listFilesRecursive, readJson, removeDir, writeJson } from './fs.js';
+import { resolveComponents } from './registry.js';
+export async function createContextPack({ spec, outDir = null, }) {
+    const composedDir = outDir ?? (await createTempDir('starter-foundry-context'));
+    const cleanup = !outDir;
+    const composeResult = await composeStarter({ spec, outDir: composedDir });
+    try {
+        const composeReport = await readJson(composeResult.composeReportPath);
+        const files = await listFilesRecursive(composedDir);
+        const components = await resolveComponents(spec);
+        const buildPlan = generateBuildPlan(spec, components);
+        const contextPack = {
+            schemaVersion: 1,
+            generatedAt: new Date().toISOString(),
+            projectName: spec.projectName,
+            components: composeReport.components,
+            variables: composeReport.variables,
+            files,
+            fileOwnership: composeReport.fileOwnership,
+            commands: composeReport.contextHints.commands,
+            entrypoints: composeReport.contextHints.entrypoints,
+            preview: composeReport.contextHints.preview ?? null,
+            extensionPoints: composeReport.contextHints.extensionPoints,
+            validationChecks: composeReport.validationChecks,
+            agentBrief: {
+                summary: buildPlan.goal,
+                firstMoves: buildPlan.firstMoves,
+            },
+            buildPlan,
+            userPrompt: spec.userPrompt ?? null,
+        };
+        const contextPath = path.join(composedDir, '.starter-foundry', 'context-pack.json');
+        await writeJson(contextPath, contextPack);
+        return {
+            outDir: composedDir,
+            contextPath,
+            contextPack,
+        };
+    }
+    finally {
+        if (cleanup) {
+            await removeDir(composedDir);
+        }
+    }
+}
+//# sourceMappingURL=context-pack.js.map

package/dist/lib/context-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pack.js","sourceRoot":"","sources":["../../src/lib/context-pack.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AASjD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EACtC,IAAI,EACJ,MAAM,GAAG,IAAI,GAId;IACC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,aAAa,CAAC,yBAAyB,CAAC,CAAC,CAAA;IAC9E,MAAM,OAAO,GAAG,CAAC,MAAM,CAAA;IACvB,MAAM,aAAa,GAAG,MAAM,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;IAEzE,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAgB,aAAa,CAAC,iBAAiB,CAAC,CAAA;QACpF,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAA;QACnD,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAChD,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QAErD,MAAM,WAAW,GAAgB;YAC/B,aAAa,EAAE,CAAC;YAChB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,aAAa,CAAC,UAAU;YACpC,SAAS,EAAE,aAAa,CAAC,SAAS;YAClC,KAAK;YACL,aAAa,EAAE,aAAa,CAAC,aAAa;YAC1C,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,QAAQ;YAC7C,WAAW,EAAE,aAAa,CAAC,YAAY,CAAC,WAAW;YACnD,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,OAAO,IAAI,IAAI;YACnD,eAAe,EAAE,aAAa,CAAC,YAAY,CAAC,eAAe;YAC3D,gBAAgB,EAAE,aAAa,CAAC,gBAAgB;YAChD,UAAU,EAAE;gBACV,OAAO,EAAE,SAAS,CAAC,IAAI;gBACvB,UAAU,EAAE,SAAS,CAAC,UAAU;aACjC;YACD,SAAS;YACT,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI;SACpC,CAAA;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,CAAA;QACnF,MAAM,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;QAEzC,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,WAAW;YACX,WAAW;SACZ,CAAA;IACH,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,SAAS,CAAC,WAAW,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/lib/fatten.d.ts

@@ -0,0 +1,34 @@
+interface FattenResult {
+    outDir: string;
+    hadDeps: boolean;
+    installed: boolean;
+    vitePrebundled: boolean;
+    built: boolean;
+    durationMs: number;
+}
+interface FattenWorkspaceResult {
+    outDir: string;
+    projects: Array<{
+        path: string;
+        result: FattenResult;
+    }>;
+    durationMs: number;
+}
+/**
+ * Fatten a composed scaffold directory by installing dependencies,
+ * pre-bundling Vite, and optionally pre-building.
+ *
+ * After fattening, the directory contains node_modules/, .vite/ cache,
+ * and optionally dist/ or .next/. A tarball of this directory lets the
+ * dev server start instantly in the container.
+ *
+ * This is an OFFLINE operation — runs during scaffold publishing, not
+ * in the user's hot path.
+ */
+export declare function fattenStarter(outDir: string): Promise<FattenResult>;
+/**
+ * Fatten a composed workspace directory. Finds all sub-projects with
+ * package.json and fattens each one independently.
+ */
+export declare function fattenWorkspace(outDir: string): Promise<FattenWorkspaceResult>;
+export {};