@bitmagic/world-forger 0.1.0

package/dist/log.js

@@ -0,0 +1,14 @@
+function emit(name, level) {
+    return (context, message) => {
+        console[level](`[${name}] ${message}`, context);
+    };
+}
+export function createLogger(name) {
+    return {
+        info: emit(name, 'info'),
+        warn: emit(name, 'warn'),
+        error: emit(name, 'error'),
+        debug: emit(name, 'debug'),
+    };
+}
+//# sourceMappingURL=log.js.map

package/dist/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAyBA,SAAS,IAAI,CAAC,IAAY,EAAE,KAA0C;IACpE,OAAO,CAAC,OAAgC,EAAE,OAAe,EAAQ,EAAE;QACjE,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,KAAK,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;QACxB,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;QAC1B,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;KAC3B,CAAC;AACJ,CAAC"}

package/dist/pipeline/archetype-skips.d.ts

@@ -0,0 +1,57 @@
+import type { ForgeArchetypeRef } from './job-types.js';
+/**
+ * Recorded in `archetype-progress` / `archetype-assets` IN PLACE of the asset record
+ * of an archetype that could not be baked. It is a placeholder, not an asset: keeping
+ * the array INDEX-ALIGNED with `forge.archetypes` is what makes the resume cache (keyed
+ * by that index) and the summary's archetype↔asset pairing stay correct while the module
+ * itself disappears from the world. Every consumer must route it through
+ * {@link isSkippedArchetype} — it must never be written to world.json as an asset.
+ *
+ * A type alias rather than an interface so it is assignable to the `Record<string, unknown>`
+ * the artifacts are typed as.
+ */
+export type SkippedArchetype = {
+    skippedArchetype: true;
+    name: string;
+    /** Why the bake gave up — the browser's error text, or what the artifact lacked. */
+    reason: string;
+    /** Instances the level loses with it (all of them). */
+    instanceCount: number;
+    /**
+     * A used kit module (exact floor/wall/surround): its skip leaves bare recessed
+     * shell where carved stone belonged, so the summary note names that cost and a
+     * resume retries the bake. Absent on ordinary prop/landmark skips.
+     */
+    structural?: true;
+};
+export declare function isSkippedArchetype(entry: Record<string, unknown> | null | undefined): entry is SkippedArchetype;
+/**
+ * The forge-advisory line a skipped archetype contributes to the summary.
+ */
+export declare function skipNote(skipped: SkippedArchetype): string;
+/**
+ * The structural-module variant: the cost is real and visible — the shell behind
+ * an exact kit module is intentionally recessed/flattened, so the note must say
+ * what now shows there rather than pretend the drop was cosmetic.
+ */
+export declare function structuralSkipNote(skipped: SkippedArchetype): string;
+/**
+ * The forge-advisory line a module that came back OVER its LOD0 leaf budget contributes.
+ * It was KEPT at the kit's pinned voxel size rather than re-baked coarser (see the attempt
+ * loop in `createLevelArchetypes`), so the cost is real and worth reporting: the
+ * alternative was a wall with no relief at all.
+ */
+export declare function moduleOverBudgetNote(name: string, voxelCount: number, budget: number): string;
+/**
+ * Deliberately the SAME predicate `forge-world.ts` pins the bake resolution with, imported
+ * rather than restated. The two decisions must agree: if this file stopped classifying a
+ * real kit piece as a module while forge-world kept pinning it, the piece would be pinned to
+ * the finest voxel size AND become eligible for the coarsen-rebake loop again — silently
+ * reinstating the exact defect that exemption exists to prevent, with every test still green.
+ * (`forge-world.ts`'s other predicate, the prefix-only one, is NOT interchangeable with this:
+ * it guards the world-GLB omission and must fail safe by over-matching, the opposite way.)
+ */
+export declare const isCladdingModule: (archetype: ForgeArchetypeRef) => boolean;
+/** A used kit module is structural: the exact floor/wall/surround has no visual fallback. */
+export declare const isUsedStructuralModule: (archetype: ForgeArchetypeRef) => boolean;
+//# sourceMappingURL=archetype-skips.d.ts.map

package/dist/pipeline/archetype-skips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archetype-skips.d.ts","sourceRoot":"","sources":["../../src/pipeline/archetype-skips.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gBAAgB,EAAE,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC;CACnB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,gBAAgB,CAE/G;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAGpE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI7F;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,iBAAiB,KAAG,OAA0C,CAAC;AAE3G,6FAA6F;AAC7F,eAAO,MAAM,sBAAsB,GAAI,WAAW,iBAAiB,KAAG,OACV,CAAC"}

package/dist/pipeline/archetype-skips.js

@@ -0,0 +1,51 @@
+/**
+ * A legacy archetype that was SKIPPED, and the advisory lines it contributes.
+ *
+ * Shared by step 3 (which records the skips) and step 5 (which drops their
+ * placements and reports them in the summary), so the placeholder shape and
+ * the notes that describe its cost have exactly one definition.
+ */
+import { isKitModuleArchetype } from '../forge-constants.js';
+export function isSkippedArchetype(entry) {
+    return !!entry && entry.skippedArchetype === true;
+}
+/**
+ * The forge-advisory line a skipped archetype contributes to the summary.
+ */
+export function skipNote(skipped) {
+    const n = skipped.instanceCount;
+    return `Archetype "${skipped.name}" was dropped (${skipped.reason}), along with its ${n} instance${n === 1 ? '' : 's'}; the level keeps everything else.`;
+}
+/**
+ * The structural-module variant: the cost is real and visible — the shell behind
+ * an exact kit module is intentionally recessed/flattened, so the note must say
+ * what now shows there rather than pretend the drop was cosmetic.
+ */
+export function structuralSkipNote(skipped) {
+    const n = skipped.instanceCount;
+    return `Structural cladding module "${skipped.name}" failed to bake (${skipped.reason}) — its ${n} placement${n === 1 ? '' : 's'} were dropped, leaving bare recessed shell where its carved stone belongs; the level keeps everything else.`;
+}
+/**
+ * The forge-advisory line a module that came back OVER its LOD0 leaf budget contributes.
+ * It was KEPT at the kit's pinned voxel size rather than re-baked coarser (see the attempt
+ * loop in `createLevelArchetypes`), so the cost is real and worth reporting: the
+ * alternative was a wall with no relief at all.
+ */
+export function moduleOverBudgetNote(name, voxelCount, budget) {
+    return `Cladding module "${name}" baked to ${voxelCount} LOD0 leaves, over the ${budget} budget for its role — `
+        + 'kept at the kit\'s pinned voxel size instead of re-baked coarser, because coarsening deletes the stone relief '
+        + 'the module exists to carry. Its instances are heavier than a standard library asset.';
+}
+/**
+ * Deliberately the SAME predicate `forge-world.ts` pins the bake resolution with, imported
+ * rather than restated. The two decisions must agree: if this file stopped classifying a
+ * real kit piece as a module while forge-world kept pinning it, the piece would be pinned to
+ * the finest voxel size AND become eligible for the coarsen-rebake loop again — silently
+ * reinstating the exact defect that exemption exists to prevent, with every test still green.
+ * (`forge-world.ts`'s other predicate, the prefix-only one, is NOT interchangeable with this:
+ * it guards the world-GLB omission and must fail safe by over-matching, the opposite way.)
+ */
+export const isCladdingModule = (archetype) => isKitModuleArchetype(archetype);
+/** A used kit module is structural: the exact floor/wall/surround has no visual fallback. */
+export const isUsedStructuralModule = (archetype) => isCladdingModule(archetype) && archetype.instanceCount > 0;
+//# sourceMappingURL=archetype-skips.js.map

package/dist/pipeline/archetype-skips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archetype-skips.js","sourceRoot":"","sources":["../../src/pipeline/archetype-skips.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AA6B7D,MAAM,UAAU,kBAAkB,CAAC,KAAiD;IAClF,OAAO,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,gBAAgB,KAAK,IAAI,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAyB;IAChD,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAChC,OAAO,cAAc,OAAO,CAAC,IAAI,kBAAkB,OAAO,CAAC,MAAM,qBAAqB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,oCAAoC,CAAC;AAC5J,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAyB;IAC1D,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAChC,OAAO,+BAA+B,OAAO,CAAC,IAAI,qBAAqB,OAAO,CAAC,MAAM,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,6GAA6G,CAAC;AAChP,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,UAAkB,EAAE,MAAc;IACnF,OAAO,oBAAoB,IAAI,cAAc,UAAU,0BAA0B,MAAM,yBAAyB;UAC5G,gHAAgH;UAChH,sFAAsF,CAAC;AAC7F,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAA4B,EAAW,EAAE,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAE3G,6FAA6F;AAC7F,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,SAA4B,EAAW,EAAE,CAC9E,gBAAgB,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,aAAa,GAAG,CAAC,CAAC"}

package/dist/pipeline/artifact-store.d.ts

@@ -0,0 +1,4 @@
+import type { ForgedWorkStore, ForgeArtifactName } from './forged-work-store.js';
+/** Read a required artifact, or fail the step with a clear message. */
+export declare function requireArtifact<T>(store: ForgedWorkStore, name: ForgeArtifactName): Promise<T>;
+//# sourceMappingURL=artifact-store.d.ts.map

package/dist/pipeline/artifact-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.d.ts","sourceRoot":"","sources":["../../src/pipeline/artifact-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGjF,uEAAuE;AACvE,wBAAsB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAMpG"}

package/dist/pipeline/artifact-store.js

@@ -0,0 +1,10 @@
+import { ForgeStepError } from './errors.js';
+/** Read a required artifact, or fail the step with a clear message. */
+export async function requireArtifact(store, name) {
+    const value = await store.get(name);
+    if (value === null) {
+        throw new ForgeStepError(`Forged-work artifact "${name}" missing for job ${store.jobId} — cannot continue`);
+    }
+    return value;
+}
+//# sourceMappingURL=artifact-store.js.map

package/dist/pipeline/artifact-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.js","sourceRoot":"","sources":["../../src/pipeline/artifact-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAI,KAAsB,EAAE,IAAuB;IACtF,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAI,IAAI,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,cAAc,CAAC,yBAAyB,IAAI,qBAAqB,KAAK,CAAC,KAAK,oBAAoB,CAAC,CAAC;IAC9G,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/pipeline/asset-catalog.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Compact view of the game's asset library handed to the designer LLM so a
+ * forge can REUSE existing assets (HQ-generated landmarks, user imports)
+ * instead of minting new placeholders. Built from world.json `assets[]`.
+ *
+ * Moved from game-play-agent verbatim: the transform itself (records ->
+ * catalog entries) is pure. The READ that used to feed it —
+ * `readWorkWorldJson().assets` via a monorepo path walk — stayed on the host
+ * side; the host calls `buildAssetCatalog` on what it read and hands the
+ * result in as `ForgeDeps.assetCatalog`.
+ */
+export interface CatalogEntry {
+    assetId: string;
+    name: string;
+    description?: string;
+    /** Real-world dimensions in meters (y = height). fitBox wins over boundingBox. */
+    dims: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** hq = HQ-regenerated placeholder; placeholder = un-upgraded forge stand-in; library = user import / other finished asset. */
+    kind: 'hq' | 'placeholder' | 'library';
+    type: 'vxl' | 'glb';
+}
+export declare function buildAssetCatalog(assets: Array<Record<string, unknown>>): CatalogEntry[];
+//# sourceMappingURL=asset-catalog.d.ts.map

package/dist/pipeline/asset-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-catalog.d.ts","sourceRoot":"","sources":["../../src/pipeline/asset-catalog.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,+HAA+H;IAC/H,IAAI,EAAE,IAAI,GAAG,aAAa,GAAG,SAAS,CAAC;IACvC,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;CACrB;AAMD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,YAAY,EAAE,CA2BxF"}

package/dist/pipeline/asset-catalog.js

@@ -0,0 +1,47 @@
+import { createLogger } from '../log.js';
+const log = createLogger('world-forger-asset-catalog');
+const PLACEABLE_TYPES = new Set(['vxl', 'voxels', 'glb', 'gltf', 'polygon-mesh']);
+const CATALOG_CAP = 200;
+const KIND_ORDER = { hq: 0, library: 1, placeholder: 2 };
+export function buildAssetCatalog(assets) {
+    const entries = [];
+    for (const a of assets) {
+        const type = String(a.type ?? '');
+        if (!PLACEABLE_TYPES.has(type))
+            continue;
+        const dims = deriveDims(a);
+        if (!dims)
+            continue;
+        entries.push({
+            assetId: String(a.id),
+            name: String(a.name ?? a.id),
+            description: typeof a.description === 'string' ? a.description : undefined,
+            dims,
+            kind: a.hqGeneratedAt ? 'hq' : a.placeholder === true ? 'placeholder' : 'library',
+            type: type === 'glb' || type === 'gltf' || type === 'polygon-mesh' ? 'glb' : 'vxl',
+        });
+    }
+    // Stable sort (Node guarantees stability): hq > library > placeholder, so
+    // the cap drops the least valuable entries first.
+    entries.sort((x, y) => KIND_ORDER[x.kind] - KIND_ORDER[y.kind]);
+    if (entries.length > CATALOG_CAP) {
+        // No silent caps — dropped entries are invisible to the designer.
+        log.warn({ total: entries.length, dropped: entries.length - CATALOG_CAP }, 'Asset catalog over the designer cap — placeholder/library tail dropped');
+    }
+    return entries.slice(0, CATALOG_CAP);
+}
+function deriveDims(a) {
+    const fit = a.fitBox;
+    if (fit && fit.x && fit.z && fit.height)
+        return { x: fit.x, y: fit.height, z: fit.z };
+    const bb = a.boundingBox;
+    if (!bb)
+        return null;
+    const dx = (bb.maxX ?? 0) - (bb.minX ?? 0);
+    const dy = (bb.maxY ?? 0) - (bb.minY ?? 0);
+    const dz = (bb.maxZ ?? 0) - (bb.minZ ?? 0);
+    if (dx <= 0 || dy <= 0 || dz <= 0)
+        return null;
+    return { x: dx, y: dy, z: dz };
+}
+//# sourceMappingURL=asset-catalog.js.map

package/dist/pipeline/asset-catalog.js.map

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

package/dist/pipeline/create-level-archetypes.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Step 3 — create the archetype LIBRARY ASSETS by voxelizing each uploaded GLB
+ * in the browser, through the host's transport seam.
+ *
+ * Moved from game-play-agent's `pipeline.ts` verbatim, with the one
+ * `sendAndWaitForResult` call site turned into `deps.transport.sendAndWait`
+ * (same arguments, same `null`-on-timeout contract — see transport-types.ts)
+ * and the logger turned into `deps.logger`.
+ */
+import type { ForgedWorkStore } from './forged-work-store.js';
+import type { ForgeDeps } from './deps.js';
+/**
+ * Minimum gap between archetype-progress checkpoint writes. GCS rate-limits
+ * mutations of one object to ~1/s sustained — sub-second archetype bakes used to
+ * rewrite the checkpoint faster than that and 429-fail the whole step.
+ */
+export declare const ARCHETYPE_CHECKPOINT_MIN_INTERVAL_MS = 2000;
+/**
+ * Create the archetype LIBRARY ASSETS by voxelizing each uploaded GLB at fine
+ * resolution in the browser. Before the level bake, so an unresponsive browser
+ * is caught BEFORE the expensive bake.
+ *
+ * Resumability: each archetype's engine record is cached (keyed by its index in
+ * forge.archetypes) the moment it bakes, so a resume after a partial failure
+ * skips the ones already baked instead of re-baking the whole set. Each bake is
+ * a SINGLE attempt (maxRetries: 1) — like the level bake, it is an expensive,
+ * non-idempotent browser job; retrying just re-fires a fresh bake (new asset id)
+ * into an already-struggling browser. A failed/slow archetype is retried only by
+ * the orchestrator's resume, which now picks up from the per-archetype cache.
+ *
+ * A bake FAILURE (the browser answered and rejected this one GLB) never aborts, not
+ * even for a used structural dungeon module: the failure is individual and
+ * deterministic, so aborting would fail every resume identically and forfeit the
+ * whole forge for one archetype. The archetype is dropped with a note — structural
+ * modules get a note naming the bare shell left behind — and the forge keeps
+ * everything else. A TIMEOUT still aborts resumably: the browser is not answering,
+ * so every remaining bake would burn the same timeout, and a resume can succeed.
+ * Structural skip markers are removed on resume so those bakes get a second chance.
+ *
+ * Modules remain exempt from the budget COARSENING below: a module is kept at the
+ * voxel size forge-world.ts pinned it to and noted, because doubling that size deletes the
+ * relief the kit exists for. Every other archetype coarsens exactly as before.
+ */
+export declare function createLevelArchetypes(store: ForgedWorkStore, deps: ForgeDeps): Promise<void>;
+//# sourceMappingURL=create-level-archetypes.d.ts.map

package/dist/pipeline/create-level-archetypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-level-archetypes.d.ts","sourceRoot":"","sources":["../../src/pipeline/create-level-archetypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAY3C;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,OAAO,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAwLlG"}

package/dist/pipeline/create-level-archetypes.js

@@ -0,0 +1,197 @@
+import { requireArtifact } from './artifact-store.js';
+import { ForgeStepError } from './errors.js';
+import { forgeRequestId } from './request-id.js';
+import { isCladdingModule, isSkippedArchetype, isUsedStructuralModule, } from './archetype-skips.js';
+import { ASSET_LOD0_VOXEL_BUDGET } from '../forge-constants.js';
+/** Per-archetype asset voxelization (small objects at fine resolution). */
+const ASSET_CREATE_TIMEOUT_MS = 5 * 60 * 1000;
+/**
+ * Minimum gap between archetype-progress checkpoint writes. GCS rate-limits
+ * mutations of one object to ~1/s sustained — sub-second archetype bakes used to
+ * rewrite the checkpoint faster than that and 429-fail the whole step.
+ */
+export const ARCHETYPE_CHECKPOINT_MIN_INTERVAL_MS = 2000;
+/**
+ * Create the archetype LIBRARY ASSETS by voxelizing each uploaded GLB at fine
+ * resolution in the browser. Before the level bake, so an unresponsive browser
+ * is caught BEFORE the expensive bake.
+ *
+ * Resumability: each archetype's engine record is cached (keyed by its index in
+ * forge.archetypes) the moment it bakes, so a resume after a partial failure
+ * skips the ones already baked instead of re-baking the whole set. Each bake is
+ * a SINGLE attempt (maxRetries: 1) — like the level bake, it is an expensive,
+ * non-idempotent browser job; retrying just re-fires a fresh bake (new asset id)
+ * into an already-struggling browser. A failed/slow archetype is retried only by
+ * the orchestrator's resume, which now picks up from the per-archetype cache.
+ *
+ * A bake FAILURE (the browser answered and rejected this one GLB) never aborts, not
+ * even for a used structural dungeon module: the failure is individual and
+ * deterministic, so aborting would fail every resume identically and forfeit the
+ * whole forge for one archetype. The archetype is dropped with a note — structural
+ * modules get a note naming the bare shell left behind — and the forge keeps
+ * everything else. A TIMEOUT still aborts resumably: the browser is not answering,
+ * so every remaining bake would burn the same timeout, and a resume can succeed.
+ * Structural skip markers are removed on resume so those bakes get a second chance.
+ *
+ * Modules remain exempt from the budget COARSENING below: a module is kept at the
+ * voxel size forge-world.ts pinned it to and noted, because doubling that size deletes the
+ * relief the kit exists for. Every other archetype coarsens exactly as before.
+ */
+export async function createLevelArchetypes(store, deps) {
+    const forge = await requireArtifact(store, 'forge');
+    const progress = (await store.get('archetype-progress')) ?? {};
+    const structuralNames = new Set(forge.archetypes.filter(isUsedStructuralModule).map((archetype) => archetype.name));
+    for (const [index, record] of Object.entries(progress)) {
+        const archetype = forge.archetypes[Number(index)];
+        const recordedName = typeof record.name === 'string' ? record.name : null;
+        // Progress is index-addressed for ordering, but NAME-addressed for identity.
+        // A resumed forge may reorder archetypes, so an index hit alone cannot prove
+        // that the cached asset belongs to its current occupant.
+        const identityMatches = !!archetype && recordedName === archetype.name;
+        // A structural skip is retried on resume — the skip was a degrade, and a
+        // resume is a free second chance at the exact visual the kit exists for.
+        // Match it by the RECORDED name so reordering cannot hide it under a
+        // non-structural current occupant.
+        const isStructuralSkip = isSkippedArchetype(record)
+            && recordedName !== null
+            && structuralNames.has(recordedName);
+        if (!identityMatches || isStructuralSkip) {
+            delete progress[index];
+        }
+    }
+    // A dungeon's glow (rune inlays, crystal veins, torch flames) is authored as
+    // PALETTE COLORS, and the fixture/key/door-leaf archetypes are baked from the
+    // same palette as the level. The map is passed WHOLE to every archetype of a
+    // dungeon level rather than sliced per archetype: matching is exact-color, so
+    // a key whose color never appears in that archetype is a silent no-op (it
+    // comes back in `emissiveUnmatched`, which is a note, never an error).
+    const emissiveByColor = forge.dungeonEmissiveByColor;
+    // GCS caps mutations of a SINGLE object at ~1/s; checkpointing after every archetype
+    // hammered that limit when small props baked sub-second, 429-failing forges whose bakes
+    // had all succeeded. The checkpoint is pure resume state (the in-memory map is
+    // authoritative for this run), so writes are throttled AND best-effort: a skipped or
+    // failed write only means a resume re-bakes the archetypes recorded since the last one.
+    let lastCheckpointAt = 0;
+    const checkpoint = async () => {
+        if (Date.now() - lastCheckpointAt < ARCHETYPE_CHECKPOINT_MIN_INTERVAL_MS)
+            return;
+        lastCheckpointAt = Date.now(); // advance even on failure — re-hitting a 429ing object makes the storm worse
+        try {
+            await store.put('archetype-progress', progress);
+        }
+        catch (err) {
+            deps.logger.warn({ err, jobId: store.jobId }, 'archetype-progress checkpoint write failed — continuing; a resume re-bakes the unrecorded archetypes');
+        }
+    };
+    for (let i = 0; i < forge.archetypes.length; i++) {
+        if (progress[String(i)])
+            continue; // already baked in a prior attempt — skip
+        const archetype = forge.archetypes[i];
+        // Reused library asset: no GLB, no voxelize — record a stub that carries
+        // the EXISTING asset id so placement/persist resolve instances to it. The
+        // asset record itself is never rewritten (it may be an HQ model).
+        if (archetype.reuse) {
+            progress[String(i)] = { id: archetype.reuse.assetId, name: archetype.reuse.assetName, reused: true };
+            await checkpoint();
+            deps.logger.info({ jobId: store.jobId, archetype: archetype.name, assetId: archetype.reuse.assetId }, 'Archetype reuses existing library asset — bake skipped');
+            continue;
+        }
+        const isModule = isCladdingModule(archetype);
+        const isStructuralModule = isUsedStructuralModule(archetype);
+        // Neither a bake nor a reuse target. Even a structural module degrades to a
+        // skip: the defect is deterministic (a resume would find the same artifact),
+        // so aborting would trade a level that is 99% fine for no level at all.
+        if (!archetype.glbUrl || !archetype.assetVoxelOptions) {
+            const skipped = {
+                skippedArchetype: true,
+                name: archetype.name,
+                reason: 'the forge artifact carried neither a GLB nor a reuse target for it',
+                instanceCount: archetype.instanceCount,
+                ...(isStructuralModule ? { structural: true } : {}),
+            };
+            progress[String(i)] = skipped;
+            await checkpoint();
+            deps.logger.warn({ jobId: store.jobId, archetype: archetype.name, structural: isStructuralModule }, 'Archetype has no GLB and no reuse target — dropped, the level keeps everything else');
+            continue;
+        }
+        // Bake at the budget-predicted size first (deriveArchetypeVoxelBake); if the
+        // result still exceeds the archetype's own LOD0 budget (bbox under-estimated
+        // the real surface), re-bake with doubled voxel sizes until it fits. The
+        // re-bake upserts the same asset name, so only the final bake survives.
+        const leafBudget = archetype.assetVoxelOptions.lod0Budget ?? ASSET_LOD0_VOXEL_BUDGET;
+        let opts = { ...archetype.assetVoxelOptions };
+        let asset = null;
+        let failureReason = null;
+        const MAX_COARSEN_REBAKES = 2;
+        for (let attempt = 0;; attempt++) {
+            const requestId = forgeRequestId('asset');
+            const result = await deps.transport.sendAndWait({
+                type: 'CREATE_ASSET_FROM_GLB_URL',
+                requestId,
+                name: archetype.name,
+                glbUrl: archetype.glbUrl,
+                options: { ...opts, ...(emissiveByColor ? { emissiveByColor } : {}) },
+            }, 'ASSET_FROM_GLB_URL_RESULT', ASSET_CREATE_TIMEOUT_MS, { maxRetries: 1 });
+            if (!result) {
+                // The browser did not answer inside the timeout — infrastructure, not an
+                // individual archetype error: with the editor gone, every remaining bake
+                // would burn the same timeout. Abort resumably; baked archetypes are
+                // checkpointed and the resume retries from here.
+                throw new ForgeStepError(`Voxelizing archetype "${archetype.name}" timed out — is the editor open?`, forge.glbUrl);
+            }
+            if (!result.success || !result.asset) {
+                failureReason = result.error ?? 'unknown error';
+                break;
+            }
+            asset = result.asset;
+            const voxelCount = typeof asset.voxelCount === 'number' ? asset.voxelCount : 0;
+            if (voxelCount <= leafBudget)
+                break;
+            // A cladding module is EXEMPT from coarsening. Its relief is authored in multiples of
+            // MODULE_MIN_VOXEL_M — mortar recesses one voxel deep, protrusions two — which is why
+            // forge-world.ts pins the bake there. The first doubling already drops the mortar
+            // lines and the chamfers below a voxel; the second takes the protrusions with them and
+            // the piece bakes to flat colour, the very surface the kit exists to replace. Nothing
+            // downstream can tell: the asset is still produced and every other check still passes.
+            // So keep the bake at its pinned size and NOTE it (moduleOverBudgetNote) — heavier
+            // instances are a cost the caller can see and act on; a flattened kit is not.
+            if (isModule) {
+                deps.logger.warn({ jobId: store.jobId, archetype: archetype.name, voxelCount, budget: leafBudget, minVoxelSize: opts.minVoxelSize }, 'Cladding module baked over its voxel budget — kept at the pinned module voxel size and noted; coarsening it would delete the stone relief');
+                break;
+            }
+            if (attempt >= MAX_COARSEN_REBAKES) {
+                deps.logger.warn({ jobId: store.jobId, archetype: archetype.name, voxelCount, minVoxelSize: opts.minVoxelSize }, 'Archetype still over the voxel budget after coarsening rebakes — keeping the last bake');
+                break;
+            }
+            opts = { ...opts, minVoxelSize: opts.minVoxelSize * 2, maxVoxelSize: opts.maxVoxelSize * 2 };
+            deps.logger.info({ jobId: store.jobId, archetype: archetype.name, voxelCount, budget: leafBudget, nextMinVoxelSize: opts.minVoxelSize }, 'Archetype bake over the voxel budget — re-baking at doubled voxel sizes');
+        }
+        if (failureReason !== null) {
+            // The browser ANSWERED and rejected this one bake — an individual,
+            // deterministic error. Aborting would fail every resume identically and
+            // forfeit the whole forge for one archetype, so degrade instead: drop it
+            // (its placements follow at persist) with a note. For a structural module
+            // the cost is bare recessed shell where its carved stone belonged — the
+            // note says so, and a resume retries the bake for a second chance.
+            const skipped = {
+                skippedArchetype: true,
+                name: archetype.name,
+                reason: failureReason,
+                instanceCount: archetype.instanceCount,
+                ...(isStructuralModule ? { structural: true } : {}),
+            };
+            progress[String(i)] = skipped;
+            await checkpoint();
+            deps.logger.warn({ jobId: store.jobId, archetype: archetype.name, structural: isStructuralModule, reason: failureReason }, 'Archetype bake failed — dropped, the level keeps everything else');
+            continue;
+        }
+        progress[String(i)] = asset;
+        await checkpoint(); // persist incrementally for resume (throttled, best-effort)
+        deps.logger.info({ jobId: store.jobId, archetype: archetype.name, assetId: asset.id }, 'Archetype asset created');
+    }
+    // All archetypes baked — write the ordered combined array (the completion
+    // marker the runner skips on; index order matches buildSummary's pairing).
+    const created = forge.archetypes.map((_, i) => progress[String(i)]);
+    await store.put('archetype-assets', created);
+}
+//# sourceMappingURL=create-level-archetypes.js.map

package/dist/pipeline/create-level-archetypes.js.map

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

package/dist/pipeline/deps.d.ts

@@ -0,0 +1,72 @@
+/**
+ * ForgeDeps — everything the world-forger pipeline needs from its host, so
+ * the SAME implementation runs behind game-play-agent's Mastra web lane and
+ * the CLI lane (`bitmagic forge`, split across api-server for steps 1-2 and
+ * the CLI's own headless browser for steps 3-5). Modeled on
+ * `shared/asset-core/src/types.ts`'s
+ * `GenerateDeps` (read that first) — a generator/pipeline takes its host's
+ * capabilities as a parameter and owns no framework, filesystem or tenant of
+ * its own.
+ *
+ * Six seams:
+ *  - `storage`   — the StorageEnv shape `createForgedWorkStore(jobId, env)`
+ *                  already accepts (see forged-work-store.ts) and step 2's
+ *                  uploads write through.
+ *  - `model`     — the LLM client the director and designer call.
+ *  - `transport` — replaces `sendAndWaitForResult`: the browser round-trips
+ *                  steps 3-5 make (archetype bakes, the level bake, instance
+ *                  placement). Not read by steps 1-2.
+ *  - `worldJson` — reads the game's current world.json for step 5's persist
+ *                  plan. Read-only by design: the step RETURNS modifications
+ *                  and the host applies them (see world-json-source.ts).
+ *  - `assetCatalog` — optional; absence degrades to "no reuse", never a
+ *                  failure. The host reads world.json and calls
+ *                  `buildAssetCatalog` itself (see asset-catalog.ts).
+ *  - `hqAssetIds`   — optional, defaults to empty. Read by step 5's placeholder
+ *                  purge, and read WHEN that purge runs rather than when these
+ *                  deps were built (see the field).
+ */
+import type { ForgeStorageEnv } from './storage-types.js';
+import type { ForgeModelClient } from './model-types.js';
+import type { ForgeTransport } from './transport-types.js';
+import type { ForgeWorldJsonSource } from './world-json-source.js';
+import type { CatalogEntry } from './asset-catalog.js';
+/**
+ * The logging surface the pipeline needs. Structurally satisfied by a pino
+ * logger (game-play-agent passes its own `createLogger(...)` result
+ * directly), same pattern as `shared/asset-core`'s `CoreLogger`. The
+ * object-first overload matters for errors: `warn({ err }, msg)` serializes
+ * the Error with its stack as a structured field, where
+ * `warn(\`${err.message}\`)` throws the stack away.
+ */
+export interface ForgeLogger {
+    info(message: string, ...rest: unknown[]): void;
+    info(context: Record<string, unknown>, message: string): void;
+    warn(message: string, ...rest: unknown[]): void;
+    warn(context: Record<string, unknown>, message: string): void;
+    error(message: string, ...rest: unknown[]): void;
+    error(context: Record<string, unknown>, message: string): void;
+}
+export interface ForgeDeps {
+    storage: ForgeStorageEnv;
+    model: ForgeModelClient;
+    transport: ForgeTransport;
+    worldJson: ForgeWorldJsonSource;
+    /** Existing library assets the designer may reuse. Absent/empty = no reuse
+     *  candidates (best-effort — this must never fail the job). */
+    assetCatalog?: CatalogEntry[];
+    /**
+     * Asset ids with an HQ regeneration currently in flight, whose placeholder
+     * assets step 5's purge must therefore spare. Omitted = none.
+     *
+     * A FUNCTION, for the same reason `worldJson` above is one: the purge runs at
+     * the very end of a 30-60 minute forge (an LLM design, a geometry build, the
+     * archetype bakes and a level bake that alone may take 20 minutes), and HQ
+     * jobs both start and finish inside that window. A set captured when the host
+     * built these deps would miss every job STARTED since — purging the exact
+     * placeholders that protection exists for.
+     */
+    hqAssetIds?: () => Promise<Set<string>>;
+    logger: ForgeLogger;
+}
+//# sourceMappingURL=deps.d.ts.map

package/dist/pipeline/deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/pipeline/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChE;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,gBAAgB,CAAC;IACxB,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,oBAAoB,CAAC;IAChC;mEAC+D;IAC/D,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,MAAM,EAAE,WAAW,CAAC;CACrB"}

package/dist/pipeline/deps.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deps.js.map

package/dist/pipeline/deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../src/pipeline/deps.ts"],"names":[],"mappings":""}

package/dist/pipeline/errors.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A pipeline step failed. Carries `glbUrl` when the source GLB already exists
+ * so the caller can tell the user it can be voxelized manually from the
+ * Assets tab (the original tool's timeout affordance).
+ */
+export declare class ForgeStepError extends Error {
+    readonly glbUrl?: string;
+    constructor(message: string, glbUrl?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/pipeline/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/pipeline/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAK7C"}

package/dist/pipeline/errors.js

@@ -0,0 +1,13 @@
+/**
+ * A pipeline step failed. Carries `glbUrl` when the source GLB already exists
+ * so the caller can tell the user it can be voxelized manually from the
+ * Assets tab (the original tool's timeout affordance).
+ */
+export class ForgeStepError extends Error {
+    constructor(message, glbUrl) {
+        super(message);
+        this.name = 'ForgeStepError';
+        this.glbUrl = glbUrl;
+    }
+}
+//# sourceMappingURL=errors.js.map