@forgeax/engine-import 0.1.7 → 0.1.19

package/dist/scriptable-pack-host.d.ts

@@ -57,7 +57,7 @@ export interface ScriptablePackExternalImportOptions {
     readonly assetPaths?: Readonly<Record<string, string>>;
 }
 export declare function canonicalScriptableSourcePath(sourcePath: string): string;
-export declare function scriptablePackInputs(sourcePaths: readonly string[], declarations: ReadonlyMap<string, ScanSourceDeclaration>, cwd: string, generationFor: (displaySourcePath: string) => number, policyFor: (displaySourcePath: string) => ScriptablePackTransportPolicy): ScriptablePackInput[];
+export declare function scriptablePackInputs(sourcePaths: readonly string[], declarations: ReadonlyMap<string, ScanSourceDeclaration>, cwd: string, generationFor: (displaySourcePath: string) => number, policyFor: (displaySourcePath: string) => ScriptablePackTransportPolicy, sourceIdentityFor?: (sourcePath: string) => string): ScriptablePackInput[];
 /** Materialize one accepted ScriptablePack without duplicating dev/build loops. */
 export declare function materializePreparedScriptablePack(prepared: PreparedScriptablePack, paths: ScriptablePackTransportPaths, sink: ScriptablePackTransportSink): Promise<ReadonlyMap<string, string>>;
 export declare function readCookedAuthoredPack(authoredPack: AuthoredPackInput, cookers?: readonly NativeCooker[], sourcePath?: string): Promise<CookedAuthoredPack | undefined>;

package/dist/scriptable-pack-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scriptable-pack-host.d.ts","sourceRoot":"","sources":["../src/scriptable-pack-host.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,iBAAiB,EACtB,8BAA8B,EAE9B,KAAK,qBAAqB,EAG3B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,KAAK,YAAY,EAAwB,MAAM,oCAAoC,CAAC;AAC7F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,gCAAgC,EACtC,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAEV,SAAS,IAAI,aAAa,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,MAAM,EACP,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAiB,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,KAAK,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAMlG,OAAO,EAEL,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EACnC,MAAM,gCAAgC,CAAC;AAGxC,KAAK,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,8BAA8B,CAAC,CAAC,CAAC;AAE5F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,wBAAwB,CAAC,CAAC;IACxD,QAAQ,CAAC,aAAa,EAAE,SAAS,gCAAgC,EAAE,CAAC;IACpE,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC;CAChD;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,8BAA8B,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,8BAA8B,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;CAChD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED,MAAM,MAAM,6BAA6B,GACrC,qBAAqB,GACrB,CAAC,CAAC,OAAO,EAAE,8BAA8B,KAAK,qBAAqB,CAAC,CAAC;AAEzE,KAAK,uBAAuB,GAC1B,6BAA6B,SAAS,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,yBAAyB,CAAC;CAChD;AAED,6FAA6F;AAC7F,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,8FAA8F;IAC9F,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACxD,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,CAAC,iBAAiB,EAAE,MAAM,KAAK,MAAM,EACpD,SAAS,EAAE,CAAC,iBAAiB,EAAE,MAAM,KAAK,6BAA6B,GACtE,mBAAmB,EAAE,CAgBvB;AAED,mFAAmF;AACnF,wBAAsB,iCAAiC,CACrD,QAAQ,EAAE,sBAAsB,EAChC,KAAK,EAAE,4BAA4B,EACnC,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA0BtC;AAED,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,iBAAiB,EAC/B,OAAO,GAAE,SAAS,YAAY,EAAO,EACrC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAsDzC;AAED,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACxD,OAAO,GAAE,SAAS,YAAY,EAAO,EACrC,aAAa,GAAE,SAAS,aAAa,EAAO,EAC5C,cAAc,CAAC,EAAE,mCAAmC,GACnD,OAAO,CAAC,SAAS,0BAA0B,EAAE,CAAC,CA0FhD;AAED,oFAAoF;AACpF,wBAAsB,4BAA4B,CAChD,YAAY,EAAE,iBAAiB,EAC/B,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,EAC5C,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,qBAAqB,EAClD,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,qBAAqB,CAAC,CAchC;AAED,8FAA8F;AAC9F,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,8BAA8B,GACtC,MAAM,CAAC,8BAA8B,EAAE,yBAAyB,CAAC,CA+BnE;AAgBD,4FAA4F;AAC5F,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,SAAS,mBAAmB,EAAE,EACvC,uBAAuB,GAAE,SAAS,0BAA0B,EAAO,GAClE,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAyIvF"}
+{"version":3,"file":"scriptable-pack-host.d.ts","sourceRoot":"","sources":["../src/scriptable-pack-host.ts"],"names":[],"mappings":"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"}

package/dist/source-package-errors.d.ts

@@ -47,6 +47,8 @@ export interface SourcePackageError {
     readonly detail: SourcePackageErrorDetail;
 }
 export declare function sourcePackageError(code: SourcePackageErrorCode, context: SourcePackageErrorContext, detail: Omit<SourcePackageErrorDetail, keyof SourcePackageErrorContext>): SourcePackageError;
+/** Return whether an error chain contains a source-package/import contract error. */
+export declare function containsSourcePackageError(error: unknown, seen?: Set<unknown>): boolean;
 export declare function normalizeSourcePackageError(error: unknown, context: SourcePackageErrorContext): SourcePackageError;
 export {};
 //# sourceMappingURL=source-package-errors.d.ts.map

package/dist/source-package-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-package-errors.d.ts","sourceRoot":"","sources":["../src/source-package-errors.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;CAyBvB,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,2BAA2B,CAAC;AAE9E,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,UAAU,GACV,YAAY,GACZ,SAAS,GACT,KAAK,GACL,iBAAiB,CAAC;AAEtB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAyB,SAAQ,yBAAyB;IACzE,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;CAC3C;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,yBAAyB,EAClC,MAAM,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,yBAAyB,CAAC,GACtE,kBAAkB,CAQpB;AA8CD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,yBAAyB,GACjC,kBAAkB,CAuBpB"}
+{"version":3,"file":"source-package-errors.d.ts","sourceRoot":"","sources":["../src/source-package-errors.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;CAyBvB,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,2BAA2B,CAAC;AAE9E,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,UAAU,GACV,YAAY,GACZ,SAAS,GACT,KAAK,GACL,iBAAiB,CAAC;AAEtB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAyB,SAAQ,yBAAyB;IACzE,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;CAC3C;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,yBAAyB,EAClC,MAAM,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,yBAAyB,CAAC,GACtE,kBAAkB,CAQpB;AAsED,qFAAqF;AACrF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,eAAqB,GAAG,OAAO,CAM7F;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,yBAAyB,GACjC,kBAAkB,CAyBpB"}

package/dist/source-path.d.ts

@@ -0,0 +1,12 @@
+import type { ScanSourceDeclaration } from '@forgeax/engine-pack/scanner';
+export interface CatalogSourceDeclaration {
+    readonly sourcePath: string;
+    readonly declaration: ScanSourceDeclaration;
+}
+/**
+ * Resolve a Catalog row's logical source locator back to its physical scanner
+ * declaration. Catalog rows are host identities; declaration maps remain
+ * physical because production still has to read those files from disk.
+ */
+export declare function sourceDeclarationForCatalogPath(sourcePath: string, declarations: ReadonlyMap<string, ScanSourceDeclaration>, sourceIdentityFor?: (sourcePath: string) => string, cwd?: string): CatalogSourceDeclaration | undefined;
+//# sourceMappingURL=source-path.d.ts.map

package/dist/source-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-path.d.ts","sourceRoot":"","sources":["../src/source-path.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAM1E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACxD,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,EAClD,GAAG,SAAgB,GAClB,wBAAwB,GAAG,SAAS,CAYtC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-import",
-  "version": "0.1.7",
+  "version": "0.1.19",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -27,12 +27,12 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-ddc": "0.1.7",
-    "@forgeax/engine-ecs": "0.1.7",
-    "@forgeax/engine-geometry": "0.1.7",
-    "@forgeax/engine-pack": "0.1.7",
-    "@forgeax/engine-scene": "0.1.7",
-    "@forgeax/engine-types": "0.1.7",
+    "@forgeax/engine-ddc": "0.1.19",
+    "@forgeax/engine-ecs": "0.1.19",
+    "@forgeax/engine-geometry": "0.1.19",
+    "@forgeax/engine-pack": "0.1.19",
+    "@forgeax/engine-scene": "0.1.19",
+    "@forgeax/engine-types": "0.1.19",
     "@noble/hashes": "^2.2.0"
   },
   "devDependencies": {

package/src/__tests__/import-dependencies.test.ts

@@ -62,4 +62,38 @@ describe('import runner dependency observation', () => {
       'ui/icons/missing.svg',
     ]);
   });
+
+  it('uses host-provided logical identities for dependency fingerprints', async () => {
+    const importer: Importer = {
+      key: 'fixture',
+      async import(ctx: ImportContext): Promise<ImportResult> {
+        await ctx.readSibling('./main.css');
+        return {
+          ok: true,
+          value: {
+            assets: [{ guid: GUID, kind: 'mesh', payload: MESH, refs: [], artifacts: {} }],
+            sourceDependencies: [],
+          },
+        };
+      },
+    };
+    const registry = new ImporterRegistry();
+    registry.register(importer);
+    const result = await runImport(meta(), registry, {
+      sourceIdentityFor: (sourcePath) =>
+        sourcePath.replace('ui/', '@shared/ui/').replace('\\\\', '/'),
+      readSource: async () => ({ ok: true, value: new Uint8Array([1]) }),
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok && 'product' in result.value) {
+      expect(result.value.product.sourceDependencies).toEqual([
+        '@shared/ui/main.html',
+        '@shared/ui/main.css',
+      ]);
+      expect(result.value.product.sourceRevision).toBe(
+        'source:@shared/ui/main.css|@shared/ui/main.html',
+      );
+    }
+  });
 });

package/src/__tests__/source-package-errors.unit.test.ts

@@ -0,0 +1,62 @@
+import { describe, expect, it } from 'vitest';
+import {
+  containsSourcePackageError,
+  normalizeSourcePackageError,
+  sourcePackageError,
+} from '../source-package-errors.js';
+
+const context = {
+  sourceMeta: '/game/assets/fox.glb.meta.json',
+  anchorGuid: '018e7a4d-1234-7abc-8def-000000000020',
+  affectedGuids: ['018e7a4d-1234-7abc-8def-000000000020'],
+  producer: 'source-package/gltf',
+  importer: 'gltf',
+};
+
+describe('source-package error normalization', () => {
+  it('walks nested production wrappers to retain the source-package failure', () => {
+    const sourceFailure = sourcePackageError('source-package-ddc-failed', context, {
+      stage: 'ddc',
+      reason: 'DDC lifecycle commit returned stale',
+    });
+    const wrapped = {
+      code: 'commit-failed',
+      expected: 'DDC to commit the staged publication',
+      hint: 'retry the active generation',
+      detail: { stage: 'commit' },
+      cause: {
+        code: 'produce-failed',
+        expected: 'the production generation to complete',
+        hint: 'repair the producer',
+        detail: { stage: 'produce' },
+        cause: sourceFailure,
+      },
+    };
+
+    expect(normalizeSourcePackageError(wrapped, context)).toEqual(sourceFailure);
+    expect(containsSourcePackageError(wrapped)).toBe(true);
+  });
+
+  it('does not mistake an unrelated lifecycle wrapper for an ImportError', () => {
+    const normalized = normalizeSourcePackageError(
+      {
+        code: 'commit-failed',
+        expected: 'a commit',
+        hint: 'retry',
+        detail: { stage: 'commit' },
+      },
+      context,
+    );
+
+    expect(normalized.code).toBe('source-package-conversion-failed');
+    expect(normalized.detail.reason).toContain('commit-failed');
+    expect(
+      containsSourcePackageError({
+        code: 'pack-source-load-failed',
+        expected: 'a ScriptablePack build',
+        hint: 'retry',
+        detail: { reason: 'timeout' },
+      }),
+    ).toBe(false);
+  });
+});

package/src/build-production.ts

@@ -31,6 +31,7 @@ import {
   produceSourcePackage,
   sourcePackageAssetsByGuid,
 } from './source-package.js';
+import { sourceDeclarationForCatalogPath } from './source-path.js';
 
 export interface BuildProductionFailure {
   readonly code: string;
@@ -106,13 +107,9 @@ function runtimePublicationFor(
 async function buildAuthoredPackages(
   context: BuildProductionOptions,
 ): Promise<ReadonlyMap<string, ScriptableBuildPackage>> {
-  const scriptableSources = [
-    ...new Set(
-      context.inventory.entries
-        .filter((entry) => entry.sourcePath.endsWith('.pack.ts'))
-        .map((entry) => entry.sourcePath),
-    ),
-  ];
+  const scriptableSources = [...context.inventory.sourceDeclarations.entries()]
+    .filter(([, declaration]) => declaration.format === 'pack.ts')
+    .map(([sourcePath]) => sourcePath);
   if (scriptableSources.length === 0) return new Map();
   const inputs = scriptablePackInputs(
     scriptableSources,
@@ -124,6 +121,7 @@ async function buildAuthoredPackages(
       packagePath: `assets/${product.anchorGuid}.pack.json`,
       artifactPath: scriptableArtifactPath,
     }),
+    context.fsForImport.sourceIdentityFor,
   );
   const preparedResult = await produceScriptablePackProducts(
     inputs,
@@ -210,6 +208,7 @@ function updateImportedEntries(
   projection: Record<string, unknown> = {},
   refsByGuid?: ReadonlyMap<string, readonly string[]>,
   publication?: AssetPublicationEnvelope,
+  sourcePath?: string,
 ): void {
   const selected = new Set(guids.map((guid) => guid.toLowerCase()));
   for (let index = 0; index < entries.length; index += 1) {
@@ -220,6 +219,7 @@ function updateImportedEntries(
       ...entry,
       packageUrl,
       ...projection,
+      ...(sourcePath === undefined ? {} : { sourcePath }),
       ...(publication === undefined ? {} : { publication }),
       ...(refs === undefined ? {} : { refs }),
     };
@@ -240,6 +240,7 @@ interface PackEmissionOptions {
   readonly projection?: Record<string, unknown>;
   readonly refsByGuid?: ReadonlyMap<string, readonly string[]>;
   readonly publication?: AssetPublicationEnvelope;
+  readonly sourcePath?: string;
 }
 
 async function emitPackDocument(
@@ -267,6 +268,7 @@ async function emitPackDocument(
     options.projection,
     options.refsByGuid,
     options.publication,
+    options.sourcePath,
   );
   return packageUrl;
 }
@@ -276,8 +278,14 @@ async function emitAuthoredPack(
   guidSeen: Set<string>,
   entry: PackIndexEntry,
 ): Promise<void> {
-  const packPath = resolve(work.context.cwd, entry.sourcePath);
-  const declaration = work.context.inventory.sourceDeclarations.get(packPath);
+  const sourceDeclaration = sourceDeclarationForCatalogPath(
+    entry.sourcePath,
+    work.context.inventory.sourceDeclarations,
+    work.context.fsForImport.sourceIdentityFor,
+    work.context.cwd,
+  );
+  const packPath = sourceDeclaration?.sourcePath ?? resolve(work.context.cwd, entry.sourcePath);
+  const declaration = sourceDeclaration?.declaration;
   if (declaration?.format !== 'pack.json') {
     throw work.context.fail({
       code: 'catalog-declaration-missing',
@@ -303,8 +311,8 @@ async function emitAuthoredPack(
       ? undefined
       : runtimePublicationFor(work.context, {
           pack: { assets: authoredPack.assets },
-          sourcePath: packPath,
-          sourceRevision: prepared.finalized?.sourceRevision ?? entry.sourcePath,
+          sourcePath: entry.sourcePath,
+          sourceRevision: declaration.sourceRevision,
           packageUrl:
             prepared.finalized?.packageUrl ??
             `${work.context.basePrefix === '/' ? '' : work.context.basePrefix}/assets/${outputGuid}.pack.json`,
@@ -333,6 +341,7 @@ async function emitAuthoredPack(
 async function emitFinalizedOwner(
   work: BuildEmissionWork,
   metaPath: string,
+  sourcePath: string,
   subAssets: readonly { readonly guid: string }[],
   sourcePackage: Extract<
     Awaited<ReturnType<typeof produceSourcePackage>>,
@@ -379,7 +388,10 @@ async function emitFinalizedOwner(
   );
   const runtimePublication = runtimePublicationFor(work.context, {
     pack: { assets: ownerPackage.pack.assets },
-    sourcePath: metaPath,
+    // The Catalog entry identifies the imported source, while metaPath is the
+    // sidecar declaration that drove the import. Keep publication fences on
+    // the Catalog identity in production just as the dev importer does.
+    sourcePath,
     sourceRevision: ownerPackage.sourceRevision,
     packageUrl: ownerPackage.packageUrl,
     digest: ownerPackage.digest,
@@ -398,6 +410,7 @@ async function emitFinalizedOwner(
       ]),
     ),
     publication: runtimePublication.publication,
+    sourcePath,
   });
 }
 
@@ -433,7 +446,14 @@ async function emitBuildEntry(
   if (!sourcePackage.ok) throw work.context.fail(sourcePackage.error);
   const ownerFinalizer = work.context.importerRegistry.get(runMeta.importer)?.finalize;
   if (ownerFinalizer !== undefined) {
-    await emitFinalizedOwner(work, metaPath, subAssets, sourcePackage.value, ownerFinalizer);
+    await emitFinalizedOwner(
+      work,
+      metaPath,
+      canonicalScriptableSourcePath(entry.sourcePath),
+      subAssets,
+      sourcePackage.value,
+      ownerFinalizer,
+    );
     return;
   }
   const finalized = await finalizePackageTransportSource(
@@ -446,9 +466,12 @@ async function emitBuildEntry(
     },
   );
   const productByGuid = sourcePackageAssetsByGuid(sourcePackage.value);
+  const canonicalSourcePath = canonicalScriptableSourcePath(entry.sourcePath);
   const runtimePublication = runtimePublicationFor(work.context, {
     pack: { assets: finalized.pack.assets },
-    sourcePath: metaPath,
+    // See emitFinalizedOwner: the sidecar path is an import driver, not the
+    // stable source identity carried by the Catalog row.
+    sourcePath: canonicalSourcePath,
     sourceRevision: finalized.sourceRevision,
     packageUrl: finalized.packageUrl,
     digest: finalized.digest,
@@ -464,6 +487,7 @@ async function emitBuildEntry(
       [...productByGuid].map(([guid, asset]) => [guid, asset.refs.map((ref) => ref.guid)]),
     ),
     publication: runtimePublication.publication,
+    sourcePath: canonicalSourcePath,
   });
 }
 

package/src/catalog-inventory.ts

@@ -13,12 +13,14 @@ export async function buildCatalogResult(
   registeredImporterKeys: ReadonlySet<string> = new Set(),
   scanOptions: ScanOptions = {},
   catalogVisibility: CatalogProducerVisibility = () => true,
+  sourceIdentityFor?: (sourcePath: string) => string,
 ): Promise<CatalogBuildResult> {
   const options: CatalogBuildProjectionOptions = {
     base,
     scanOptions,
     importerPolicy: (importer) => catalogImporterPolicy(importer, registeredImporterKeys),
     visibility: catalogVisibility,
+    ...(sourceIdentityFor === undefined ? {} : { sourceIdentityFor }),
   };
   return buildCatalogProjection(roots, options);
 }

package/src/import-runner.ts

@@ -218,6 +218,15 @@ function declarationFields(
  * `ImportRunnerFs`.
  */
 export interface ImportRunnerFs {
+  /**
+   * Map a physical read path to the host's stable logical source identity.
+   *
+   * Hosts may expose the same source through different filesystem coordinates
+   * (for example a symlink farm in a browser Vite root).  The identity is used
+   * only for dependency/revision facts; `readSource` and `readSibling` still
+   * receive the physical path supplied by the importer.
+   */
+  sourceIdentityFor?(sourcePath: string): string;
   readSource(
     sourcePath: string,
   ): Promise<
@@ -259,6 +268,10 @@ function normalizeDependencyPath(path: string): string {
   return parts.join('/');
 }
 
+function dependencyIdentity(fs: ImportRunnerFs, sourcePath: string): string {
+  return normalizeDependencyPath(fs.sourceIdentityFor?.(sourcePath) ?? sourcePath);
+}
+
 function errResult(error: ImportErrorType): {
   readonly ok: false;
   readonly error: ImportErrorType;
@@ -451,7 +464,7 @@ export async function runImport(
 
   const dependencies = new Set<string>();
   const readSource = async (sourcePath: string) => {
-    dependencies.add(normalizeDependencyPath(sourcePath));
+    dependencies.add(dependencyIdentity(fs, sourcePath));
     try {
       return await fs.readSource(sourcePath);
     } catch (error) {
@@ -471,7 +484,7 @@ export async function runImport(
       | { readonly ok: false; readonly error: ImportErrorType };
     try {
       if (fs.readSibling) {
-        dependencies.add(normalizeDependencyPath(joinSiblingPath(meta.source, uri)));
+        dependencies.add(dependencyIdentity(fs, joinSiblingPath(meta.source, uri)));
         inner = await fs.readSibling(meta.source, uri);
       } else {
         inner = await readSource(joinSiblingPath(meta.source, uri));

package/src/index.ts

@@ -153,6 +153,7 @@ export {
   sourcePackageAssetsByGuid,
 } from './source-package.js';
 export {
+  containsSourcePackageError,
   normalizeSourcePackageError,
   type SourcePackageError,
   type SourcePackageErrorCode,
@@ -173,3 +174,7 @@ export {
   type StagedImportPublicationResult,
   stageImportPublication,
 } from './source-package-publication.js';
+export {
+  type CatalogSourceDeclaration,
+  sourceDeclarationForCatalogPath,
+} from './source-path.js';

package/src/scriptable-pack-host.ts

@@ -1,6 +1,6 @@
 import { createHash } from 'node:crypto';
 import { stat } from 'node:fs/promises';
-import { resolve } from 'node:path';
+import { isAbsolute, relative, resolve } from 'node:path';
 import { createAcceptedPublication } from '@forgeax/engine-ddc';
 import {
   type AuthoredPackInput,
@@ -120,11 +120,15 @@ export function scriptablePackInputs(
   cwd: string,
   generationFor: (displaySourcePath: string) => number,
   policyFor: (displaySourcePath: string) => ScriptablePackTransportPolicy,
+  sourceIdentityFor?: (sourcePath: string) => string,
 ): ScriptablePackInput[] {
   return sourcePaths.flatMap((sourcePath) => {
     const declaration = declarations.get(resolve(cwd, sourcePath));
     if (declaration?.format !== 'pack.ts') return [];
-    const displaySourcePath = canonicalScriptableSourcePath(sourcePath);
+    const projected = sourceIdentityFor?.(sourcePath);
+    const catalogSourcePath =
+      projected === undefined || isAbsolute(projected) ? relative(cwd, sourcePath) : projected;
+    const displaySourcePath = canonicalScriptableSourcePath(catalogSourcePath);
     return [
       {
         sourcePath: resolve(cwd, sourcePath),

package/src/source-package-errors.ts

@@ -118,10 +118,45 @@ function importFailureCode(error: ImportError): SourcePackageErrorCode {
   }
 }
 
+const IMPORT_ERROR_CODES = new Set([
+  'importer-not-registered',
+  'source-read-failed',
+  'import-produced-no-assets',
+  'guid-mismatch',
+  'mesh-material-slot-topology-change',
+  'import-internal-error',
+  'source-validation-failed',
+  'unknown-source-key',
+  'duplicate-source-key',
+  'invalid-source-overrides',
+  'invalid-source-override-payload',
+]);
+
+function findNormalizableCause(error: unknown, seen = new Set<unknown>()): unknown {
+  if (error === null || typeof error !== 'object' || seen.has(error)) return undefined;
+  seen.add(error);
+  if (isSourcePackageError(error) || isScriptablePackFailure(error) || isImportError(error)) {
+    return error;
+  }
+  const cause = (error as { readonly cause?: unknown }).cause;
+  return cause === undefined ? undefined : findNormalizableCause(cause, seen);
+}
+
+/** Return whether an error chain contains a source-package/import contract error. */
+export function containsSourcePackageError(error: unknown, seen = new Set<unknown>()): boolean {
+  if (error === null || typeof error !== 'object' || seen.has(error)) return false;
+  seen.add(error);
+  if (isSourcePackageError(error) || isImportError(error)) return true;
+  const cause = (error as { readonly cause?: unknown }).cause;
+  return cause !== undefined && containsSourcePackageError(cause, seen);
+}
+
 export function normalizeSourcePackageError(
   error: unknown,
   context: SourcePackageErrorContext,
 ): SourcePackageError {
+  const cause = findNormalizableCause(error);
+  if (cause !== undefined && cause !== error) return normalizeSourcePackageError(cause, context);
   if (isSourcePackageError(error)) return error;
   if (isScriptablePackFailure(error)) {
     return sourcePackageError('source-package-conversion-failed', context, {
@@ -174,6 +209,8 @@ function isImportError(error: unknown): error is ImportError {
     error !== null &&
     typeof error === 'object' &&
     'code' in error &&
+    typeof error.code === 'string' &&
+    IMPORT_ERROR_CODES.has(error.code) &&
     'expected' in error &&
     'hint' in error &&
     'detail' in error

package/src/source-path.ts

@@ -0,0 +1,36 @@
+import { resolve } from 'node:path';
+import { catalogSourcePathFor } from '@forgeax/engine-pack/build';
+import type { ScanSourceDeclaration } from '@forgeax/engine-pack/scanner';
+
+function normalizeCatalogPath(path: string): string {
+  return path.replaceAll('\\', '/').replace(/^\.\//, '');
+}
+
+export interface CatalogSourceDeclaration {
+  readonly sourcePath: string;
+  readonly declaration: ScanSourceDeclaration;
+}
+
+/**
+ * Resolve a Catalog row's logical source locator back to its physical scanner
+ * declaration. Catalog rows are host identities; declaration maps remain
+ * physical because production still has to read those files from disk.
+ */
+export function sourceDeclarationForCatalogPath(
+  sourcePath: string,
+  declarations: ReadonlyMap<string, ScanSourceDeclaration>,
+  sourceIdentityFor?: (sourcePath: string) => string,
+  cwd = process.cwd(),
+): CatalogSourceDeclaration | undefined {
+  const normalized = normalizeCatalogPath(sourcePath);
+  const direct = declarations.get(resolve(cwd, sourcePath));
+  if (direct !== undefined) {
+    return { sourcePath: resolve(cwd, sourcePath), declaration: direct };
+  }
+  for (const [physicalPath, declaration] of declarations) {
+    if (catalogSourcePathFor(cwd, physicalPath, sourceIdentityFor) === normalized) {
+      return { sourcePath: physicalPath, declaration };
+    }
+  }
+  return undefined;
+}