@opengroundplan/core 0.1.1 → 0.2.0

package/dist/schema.d.ts

@@ -48,73 +48,73 @@ export declare const ArchitectureEntry: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     id: string;
     name: string;
+    sources: string[];
+    teamSize: {
+        min: number;
+        max: number;
+    };
     family: "application" | "system" | "frontend" | "data" | "ai";
     oneLine: string;
     bestFor: string[];
     avoidWhen: string[];
     complexity: "low" | "medium" | "high" | "very-high";
-    teamSize: {
-        min: number;
-        max: number;
-    };
     scores: Partial<Record<"maintainability" | "testability" | "deployability" | "simplicity" | "scalability" | "elasticity" | "responsiveness" | "fault-tolerance" | "evolvability" | "abstraction" | "interoperability" | "cost", number>>;
-    stackFit: Partial<Record<"typescript" | "python" | "dotnet" | "node" | "go" | "rust" | "java" | "polyglot", "excellent" | "good" | "workable" | "awkward" | "n/a">>;
+    stackFit: Partial<Record<"typescript" | "node" | "python" | "dotnet" | "go" | "rust" | "java" | "polyglot", "excellent" | "good" | "workable" | "awkward" | "n/a">>;
     keyTradeoff: string;
-    sources: string[];
     overlay?: string | undefined;
     guidance?: string | undefined;
 }, {
     id: string;
     name: string;
+    sources: string[];
+    teamSize: {
+        min: number;
+        max: number;
+    };
     family: "application" | "system" | "frontend" | "data" | "ai";
     oneLine: string;
     bestFor: string[];
     avoidWhen: string[];
     complexity: "low" | "medium" | "high" | "very-high";
-    teamSize: {
-        min: number;
-        max: number;
-    };
     scores: Partial<Record<"maintainability" | "testability" | "deployability" | "simplicity" | "scalability" | "elasticity" | "responsiveness" | "fault-tolerance" | "evolvability" | "abstraction" | "interoperability" | "cost", number>>;
-    stackFit: Partial<Record<"typescript" | "python" | "dotnet" | "node" | "go" | "rust" | "java" | "polyglot", "excellent" | "good" | "workable" | "awkward" | "n/a">>;
+    stackFit: Partial<Record<"typescript" | "node" | "python" | "dotnet" | "go" | "rust" | "java" | "polyglot", "excellent" | "good" | "workable" | "awkward" | "n/a">>;
     keyTradeoff: string;
-    sources: string[];
     overlay?: string | undefined;
     guidance?: string | undefined;
 }>, {
     id: string;
     name: string;
+    sources: string[];
+    teamSize: {
+        min: number;
+        max: number;
+    };
     family: "application" | "system" | "frontend" | "data" | "ai";
     oneLine: string;
     bestFor: string[];
     avoidWhen: string[];
     complexity: "low" | "medium" | "high" | "very-high";
-    teamSize: {
-        min: number;
-        max: number;
-    };
     scores: Partial<Record<"maintainability" | "testability" | "deployability" | "simplicity" | "scalability" | "elasticity" | "responsiveness" | "fault-tolerance" | "evolvability" | "abstraction" | "interoperability" | "cost", number>>;
-    stackFit: Partial<Record<"typescript" | "python" | "dotnet" | "node" | "go" | "rust" | "java" | "polyglot", "excellent" | "good" | "workable" | "awkward" | "n/a">>;
+    stackFit: Partial<Record<"typescript" | "node" | "python" | "dotnet" | "go" | "rust" | "java" | "polyglot", "excellent" | "good" | "workable" | "awkward" | "n/a">>;
     keyTradeoff: string;
-    sources: string[];
     overlay?: string | undefined;
     guidance?: string | undefined;
 }, {
     id: string;
     name: string;
+    sources: string[];
+    teamSize: {
+        min: number;
+        max: number;
+    };
     family: "application" | "system" | "frontend" | "data" | "ai";
     oneLine: string;
     bestFor: string[];
     avoidWhen: string[];
     complexity: "low" | "medium" | "high" | "very-high";
-    teamSize: {
-        min: number;
-        max: number;
-    };
     scores: Partial<Record<"maintainability" | "testability" | "deployability" | "simplicity" | "scalability" | "elasticity" | "responsiveness" | "fault-tolerance" | "evolvability" | "abstraction" | "interoperability" | "cost", number>>;
-    stackFit: Partial<Record<"typescript" | "python" | "dotnet" | "node" | "go" | "rust" | "java" | "polyglot", "excellent" | "good" | "workable" | "awkward" | "n/a">>;
+    stackFit: Partial<Record<"typescript" | "node" | "python" | "dotnet" | "go" | "rust" | "java" | "polyglot", "excellent" | "good" | "workable" | "awkward" | "n/a">>;
     keyTradeoff: string;
-    sources: string[];
     overlay?: string | undefined;
     guidance?: string | undefined;
 }>;
@@ -137,8 +137,8 @@ export declare const Variable: z.ZodObject<{
     /** Only ask when this holds — keeps the interview short. */
     when: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    name: string;
     type: "string" | "number" | "boolean" | "select" | "multiselect";
+    name: string;
     prompt: string;
     required: boolean;
     choices?: {
@@ -148,8 +148,8 @@ export declare const Variable: z.ZodObject<{
     default?: unknown;
     when?: string | undefined;
 }, {
-    name: string;
     type: "string" | "number" | "boolean" | "select" | "multiselect";
+    name: string;
     prompt: string;
     choices?: {
         value: string;
@@ -176,14 +176,14 @@ export declare const FileRule: z.ZodObject<{
     from: string;
     to: string;
     raw: boolean;
-    onConflict: "skip" | "overwrite" | "merge" | "merge-json" | "append" | "fail";
+    onConflict: "overwrite" | "merge" | "skip" | "merge-json" | "append" | "fail";
     when?: string | undefined;
 }, {
     from: string;
     when?: string | undefined;
     to?: string | undefined;
     raw?: boolean | undefined;
-    onConflict?: "skip" | "overwrite" | "merge" | "merge-json" | "append" | "fail" | undefined;
+    onConflict?: "overwrite" | "merge" | "skip" | "merge-json" | "append" | "fail" | undefined;
 }>;
 /**
  * Licenses we may copy and adapt code from. Permissive only — anything copyleft would
@@ -303,8 +303,8 @@ export declare const Blueprint: z.ZodObject<{
         /** Only ask when this holds — keeps the interview short. */
         when: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        name: string;
         type: "string" | "number" | "boolean" | "select" | "multiselect";
+        name: string;
         prompt: string;
         required: boolean;
         choices?: {
@@ -314,8 +314,8 @@ export declare const Blueprint: z.ZodObject<{
         default?: unknown;
         when?: string | undefined;
     }, {
-        name: string;
         type: "string" | "number" | "boolean" | "select" | "multiselect";
+        name: string;
         prompt: string;
         choices?: {
             value: string;
@@ -336,14 +336,14 @@ export declare const Blueprint: z.ZodObject<{
         from: string;
         to: string;
         raw: boolean;
-        onConflict: "skip" | "overwrite" | "merge" | "merge-json" | "append" | "fail";
+        onConflict: "overwrite" | "merge" | "skip" | "merge-json" | "append" | "fail";
         when?: string | undefined;
     }, {
         from: string;
         when?: string | undefined;
         to?: string | undefined;
         raw?: boolean | undefined;
-        onConflict?: "skip" | "overwrite" | "merge" | "merge-json" | "append" | "fail" | undefined;
+        onConflict?: "overwrite" | "merge" | "skip" | "merge-json" | "append" | "fail" | undefined;
     }>, "many">>;
     /** Shell steps run after apply; each declares why it is safe to run unattended. */
     postApply: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -356,30 +356,20 @@ export declare const Blueprint: z.ZodObject<{
         when?: string | undefined;
     }, {
         run: string;
-        when?: string | undefined;
         optional?: boolean | undefined;
+        when?: string | undefined;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
-    id: string;
-    name: string;
-    sources: {
-        name: string;
-        url: string;
-        license: "MIT" | "Apache-2.0" | "BSD-2-Clause" | "BSD-3-Clause" | "ISC" | "Unlicense" | "0BSD" | "CC0-1.0";
-        adapted: string;
+    files: {
+        from: string;
+        to: string;
+        raw: boolean;
+        onConflict: "overwrite" | "merge" | "skip" | "merge-json" | "append" | "fail";
+        when?: string | undefined;
     }[];
-    kind: "base" | "layer" | "architecture" | "agent-kit";
-    description: string;
-    tags: string[];
-    requires: string[];
-    conflicts: string[];
-    provides: string[];
-    supportsArchitectures: string[];
-    peerProvidedBy: string[];
-    choiceDefault: boolean;
     variables: {
-        name: string;
         type: "string" | "number" | "boolean" | "select" | "multiselect";
+        name: string;
         prompt: string;
         required: boolean;
         choices?: {
@@ -389,18 +379,28 @@ export declare const Blueprint: z.ZodObject<{
         default?: unknown;
         when?: string | undefined;
     }[];
-    files: {
-        from: string;
-        to: string;
-        raw: boolean;
-        onConflict: "skip" | "overwrite" | "merge" | "merge-json" | "append" | "fail";
-        when?: string | undefined;
-    }[];
     postApply: {
         run: string;
         optional: boolean;
         when?: string | undefined;
     }[];
+    id: string;
+    kind: "architecture" | "base" | "layer" | "agent-kit";
+    name: string;
+    description: string;
+    sources: {
+        name: string;
+        url: string;
+        license: "MIT" | "Apache-2.0" | "BSD-2-Clause" | "BSD-3-Clause" | "ISC" | "Unlicense" | "0BSD" | "CC0-1.0";
+        adapted: string;
+    }[];
+    tags: string[];
+    requires: string[];
+    conflicts: string[];
+    provides: string[];
+    supportsArchitectures: string[];
+    peerProvidedBy: string[];
+    choiceDefault: boolean;
     commands?: {
         build: string;
         test: string;
@@ -408,13 +408,37 @@ export declare const Blueprint: z.ZodObject<{
         typecheck?: string | undefined;
         dev?: string | undefined;
     } | undefined;
-    stack?: "typescript" | "python" | "dotnet" | "node" | "go" | "rust" | "java" | "polyglot" | undefined;
+    stack?: "typescript" | "node" | "python" | "dotnet" | "go" | "rust" | "java" | "polyglot" | undefined;
     choiceSet?: string | undefined;
 }, {
     id: string;
+    kind: "architecture" | "base" | "layer" | "agent-kit";
     name: string;
-    kind: "base" | "layer" | "architecture" | "agent-kit";
     description: string;
+    files?: {
+        from: string;
+        when?: string | undefined;
+        to?: string | undefined;
+        raw?: boolean | undefined;
+        onConflict?: "overwrite" | "merge" | "skip" | "merge-json" | "append" | "fail" | undefined;
+    }[] | undefined;
+    variables?: {
+        type: "string" | "number" | "boolean" | "select" | "multiselect";
+        name: string;
+        prompt: string;
+        choices?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        default?: unknown;
+        required?: boolean | undefined;
+        when?: string | undefined;
+    }[] | undefined;
+    postApply?: {
+        run: string;
+        optional?: boolean | undefined;
+        when?: string | undefined;
+    }[] | undefined;
     sources?: {
         name: string;
         url: string;
@@ -428,7 +452,7 @@ export declare const Blueprint: z.ZodObject<{
         typecheck?: string | undefined;
         dev?: string | undefined;
     } | undefined;
-    stack?: "typescript" | "python" | "dotnet" | "node" | "go" | "rust" | "java" | "polyglot" | undefined;
+    stack?: "typescript" | "node" | "python" | "dotnet" | "go" | "rust" | "java" | "polyglot" | undefined;
     tags?: string[] | undefined;
     requires?: string[] | undefined;
     conflicts?: string[] | undefined;
@@ -437,30 +461,6 @@ export declare const Blueprint: z.ZodObject<{
     choiceSet?: string | undefined;
     peerProvidedBy?: string[] | undefined;
     choiceDefault?: boolean | undefined;
-    variables?: {
-        name: string;
-        type: "string" | "number" | "boolean" | "select" | "multiselect";
-        prompt: string;
-        choices?: {
-            value: string;
-            label: string;
-        }[] | undefined;
-        default?: unknown;
-        required?: boolean | undefined;
-        when?: string | undefined;
-    }[] | undefined;
-    files?: {
-        from: string;
-        when?: string | undefined;
-        to?: string | undefined;
-        raw?: boolean | undefined;
-        onConflict?: "skip" | "overwrite" | "merge" | "merge-json" | "append" | "fail" | undefined;
-    }[] | undefined;
-    postApply?: {
-        run: string;
-        when?: string | undefined;
-        optional?: boolean | undefined;
-    }[] | undefined;
 }>;
 export declare const AdapterCapability: z.ZodEnum<["instructions", "nested-instructions", "glob-scoped-rules", "slash-commands", "subagents", "hooks", "skills", "mcp"]>;
 /**
@@ -503,14 +503,14 @@ export declare const Invocation: z.ZodObject<{
         successor: z.ZodOptional<z.ZodString>;
         source: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        source: string;
         since: string;
         note: string;
-        source: string;
         successor?: string | undefined;
     }, {
+        source: string;
         since: string;
         note: string;
-        source: string;
         successor?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -524,9 +524,9 @@ export declare const Invocation: z.ZodObject<{
     verifiedOn: string;
     verified: string;
     deprecated?: {
+        source: string;
         since: string;
         note: string;
-        source: string;
         successor?: string | undefined;
     } | undefined;
 }, {
@@ -540,9 +540,9 @@ export declare const Invocation: z.ZodObject<{
     modelFlag?: string[] | undefined;
     detect?: string[] | undefined;
     deprecated?: {
+        source: string;
         since: string;
         note: string;
-        source: string;
         successor?: string | undefined;
     } | undefined;
 }>;
@@ -585,14 +585,14 @@ export declare const Adapter: z.ZodObject<{
             successor: z.ZodOptional<z.ZodString>;
             source: z.ZodString;
         }, "strip", z.ZodTypeAny, {
+            source: string;
             since: string;
             note: string;
-            source: string;
             successor?: string | undefined;
         }, {
+            source: string;
             since: string;
             note: string;
-            source: string;
             successor?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
@@ -606,9 +606,9 @@ export declare const Adapter: z.ZodObject<{
         verifiedOn: string;
         verified: string;
         deprecated?: {
+            source: string;
             since: string;
             note: string;
-            source: string;
             successor?: string | undefined;
         } | undefined;
     }, {
@@ -622,9 +622,9 @@ export declare const Adapter: z.ZodObject<{
         modelFlag?: string[] | undefined;
         detect?: string[] | undefined;
         deprecated?: {
+            source: string;
             since: string;
             note: string;
-            source: string;
             successor?: string | undefined;
         } | undefined;
     }>>;
@@ -682,9 +682,9 @@ export declare const Adapter: z.ZodObject<{
         verifiedOn: string;
         verified: string;
         deprecated?: {
+            source: string;
             since: string;
             note: string;
-            source: string;
             successor?: string | undefined;
         } | undefined;
     } | undefined;
@@ -704,9 +704,9 @@ export declare const Adapter: z.ZodObject<{
         modelFlag?: string[] | undefined;
         detect?: string[] | undefined;
         deprecated?: {
+            source: string;
             since: string;
             note: string;
-            source: string;
             successor?: string | undefined;
         } | undefined;
     } | undefined;
@@ -745,8 +745,8 @@ export declare const RegistryItem: z.ZodObject<{
     body: z.ZodDefault<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    name: string;
     kind: "command" | "agent" | "hook" | "skill";
+    name: string;
     description: string;
     tags: string[];
     targets: string[];
@@ -755,12 +755,12 @@ export declare const RegistryItem: z.ZodObject<{
     when?: string | undefined;
 }, {
     id: string;
-    name: string;
     kind: "command" | "agent" | "hook" | "skill";
+    name: string;
     description: string;
     targets: string[];
-    when?: string | undefined;
     tags?: string[] | undefined;
+    when?: string | undefined;
     requiresCapability?: ("instructions" | "nested-instructions" | "glob-scoped-rules" | "slash-commands" | "subagents" | "hooks" | "skills" | "mcp")[] | undefined;
     body?: string | undefined;
 }>;
@@ -773,13 +773,13 @@ export declare const PlannedFile: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     path: string;
     source: string;
-    action: "skip" | "overwrite" | "merge" | "create";
+    action: "create" | "overwrite" | "merge" | "skip";
     bytes: number;
     fromBlueprint: string;
 }, {
     path: string;
     source: string;
-    action: "skip" | "overwrite" | "merge" | "create";
+    action: "create" | "overwrite" | "merge" | "skip";
     bytes: number;
     fromBlueprint: string;
 }>;
@@ -799,13 +799,13 @@ export declare const Plan: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         path: string;
         source: string;
-        action: "skip" | "overwrite" | "merge" | "create";
+        action: "create" | "overwrite" | "merge" | "skip";
         bytes: number;
         fromBlueprint: string;
     }, {
         path: string;
         source: string;
-        action: "skip" | "overwrite" | "merge" | "create";
+        action: "create" | "overwrite" | "merge" | "skip";
         bytes: number;
         fromBlueprint: string;
     }>, "many">;
@@ -824,42 +824,42 @@ export declare const Plan: z.ZodObject<{
     /** Rendered NOTICE content when any blueprint adapts upstream code; absent otherwise. */
     notice: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    variables: Record<string, unknown>;
+    adapters: string[];
     files: {
         path: string;
         source: string;
-        action: "skip" | "overwrite" | "merge" | "create";
+        action: "create" | "overwrite" | "merge" | "skip";
         bytes: number;
         fromBlueprint: string;
     }[];
+    solution: string;
+    target: string;
+    blueprints: string[];
+    variables: Record<string, unknown>;
     postApply: {
         run: string;
         optional: boolean;
     }[];
-    solution: string;
-    target: string;
-    blueprints: string[];
-    adapters: string[];
     warnings: string[];
     architecture?: string | undefined;
     notice?: string | undefined;
 }, {
-    variables: Record<string, unknown>;
+    adapters: string[];
     files: {
         path: string;
         source: string;
-        action: "skip" | "overwrite" | "merge" | "create";
+        action: "create" | "overwrite" | "merge" | "skip";
         bytes: number;
         fromBlueprint: string;
     }[];
+    solution: string;
+    target: string;
+    blueprints: string[];
+    variables: Record<string, unknown>;
     postApply: {
         run: string;
         optional?: boolean | undefined;
     }[];
-    solution: string;
-    target: string;
-    blueprints: string[];
-    adapters: string[];
     architecture?: string | undefined;
     warnings?: string[] | undefined;
     notice?: string | undefined;

package/dist/simulate.d.ts

@@ -0,0 +1,15 @@
+import type { AutoSelection } from './autoplan.js';
+export type Scale = 'small' | 'growing' | 'large';
+export interface Simulation {
+    scale: Scale;
+    requestsPerDay: string;
+    peakConcurrency: string;
+    instances: string;
+    dbQueriesPerSecond: string;
+    storageGrowth: string;
+    monthlyCost: string;
+    bottlenecks: string[];
+    scalingLimits: string[];
+}
+export declare function simulate(selection: AutoSelection): Simulation;
+export declare function renderSimulation(sim: Simulation): string;

package/dist/simulate.js

@@ -0,0 +1,89 @@
+/**
+ * Simulation — a back-of-envelope projection of what the system will face before a line is
+ * written: traffic, concurrency, infrastructure, database load, storage growth, the bottlenecks
+ * that will appear, and the monthly cost. Deterministic bands keyed on the inferred scale and the
+ * selected layers — not a benchmark, a sanity check that the architecture matches the load.
+ */
+import { costEstimate } from './analysis.js';
+const has = (layers, prefix) => layers.some((l) => l === prefix || l.startsWith(prefix));
+/** Deterministic bands per scale — a defensible order of magnitude, not a precise number. */
+const BANDS = {
+    small: { requestsPerDay: '~1k', peakConcurrency: '~5', instances: '1', dbQueriesPerSecond: '~1', storageGrowth: '~1 GB/mo' },
+    growing: { requestsPerDay: '~100k', peakConcurrency: '~50', instances: '2–3', dbQueriesPerSecond: '~20', storageGrowth: '~10 GB/mo' },
+    large: { requestsPerDay: '~10M', peakConcurrency: '~1,000', instances: 'autoscaling', dbQueriesPerSecond: '~500', storageGrowth: '~100 GB/mo' },
+};
+function inferScale(s) {
+    const sig = (id) => s.intent.matched.some((m) => m.signal === id);
+    if (sig('high-traffic'))
+        return 'large';
+    if (sig('multi-tenant') || (s.intent.priorities.scalability ?? 0) >= 3)
+        return 'growing';
+    return 'small';
+}
+export function simulate(selection) {
+    const scale = inferScale(selection);
+    const layers = selection.layers;
+    const bottlenecks = [];
+    const scalingLimits = [];
+    if (scale !== 'small' && !has(layers, 'cache')) {
+        bottlenecks.push('Database read load — every request hits the datastore with no cache in front.');
+    }
+    if (scale !== 'small' && !has(layers, 'queue')) {
+        bottlenecks.push('Synchronous request path — slow work (email, exports, webhooks) blocks the response with no queue.');
+    }
+    if (layers.includes('db-sqlite')) {
+        bottlenecks.push('Single writer — SQLite serialises writes; concurrent writes will contend.');
+        scalingLimits.push('SQLite is single-node — you cannot scale the datastore horizontally.');
+    }
+    if (!has(layers, 'observability') && scale !== 'small') {
+        bottlenecks.push('Blind spots — without observability you will not see the bottleneck when it appears.');
+    }
+    if (scale === 'large')
+        scalingLimits.push('At this scale, stateless app tiers and a read-replica or sharded datastore are assumed.');
+    const cost = costEstimate(selection);
+    const multiplier = scale === 'large' ? 30 : scale === 'growing' ? 4 : 1;
+    const range = cost.reduce((acc, band) => {
+        const [lo, hi] = parseBand(band.monthly);
+        return { lo: acc.lo + lo * multiplier, hi: acc.hi + hi * multiplier };
+    }, { lo: 0, hi: 0 });
+    return {
+        scale,
+        ...BANDS[scale],
+        monthlyCost: `$${Math.round(range.lo)}–${Math.round(range.hi)}${scale === 'large' ? '+' : ''}`,
+        bottlenecks,
+        scalingLimits,
+    };
+}
+/** Parse a "$15–60" style band into [low, high]; the variable "+" bands read as their low bound. */
+function parseBand(text) {
+    const nums = text.replace(/[$,+]/g, '').split(/[–-]/).map((n) => Number(n.trim()));
+    const lo = Number.isFinite(nums[0]) ? nums[0] : 0;
+    const hi = Number.isFinite(nums[1]) ? nums[1] : lo;
+    return [lo, hi];
+}
+export function renderSimulation(sim) {
+    return [
+        `# Simulation`,
+        ``,
+        `Projected load at **${sim.scale}** scale — an order-of-magnitude sanity check, not a benchmark.`,
+        ``,
+        `| | |`,
+        `|---|---|`,
+        `| Requests/day | ${sim.requestsPerDay} |`,
+        `| Peak concurrency | ${sim.peakConcurrency} |`,
+        `| App instances | ${sim.instances} |`,
+        `| DB queries/sec | ${sim.dbQueriesPerSecond} |`,
+        `| Storage growth | ${sim.storageGrowth} |`,
+        `| Est. monthly cost | ${sim.monthlyCost} |`,
+        ``,
+        `## Expected bottlenecks`,
+        ``,
+        ...(sim.bottlenecks.length ? sim.bottlenecks.map((b) => `- ${b}`) : ['- None at this scale with the selected layers.']),
+        ``,
+        `## Scaling limits`,
+        ``,
+        ...(sim.scalingLimits.length ? sim.scalingLimits.map((l) => `- ${l}`) : ['- No hard limits identified for this selection.']),
+        ``,
+    ].join('\n');
+}
+//# sourceMappingURL=simulate.js.map

package/dist/simulate.js.map

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

package/dist/variables.d.ts

@@ -0,0 +1,7 @@
+import type { Blueprint } from './schema.js';
+export interface ResolvedVariables {
+    vars: Record<string, unknown>;
+    /** Active variables with no default — a blueprint bug, surfaced rather than silently blanked. */
+    missing: string[];
+}
+export declare function resolveVariableDefaults(blueprints: Blueprint[], context: Record<string, unknown>, overrides?: Record<string, unknown>): ResolvedVariables;