@forgeax/engine-pack 0.0.0-dev.8d955ade1c79

package/dist/native-cooker.mjs

@@ -0,0 +1,142 @@
+import { createHash } from 'crypto';
+import { ok, err } from '@forgeax/engine-types';
+
+// src/native-cooker-registry.ts
+function canonicalize(value) {
+  if (value instanceof Uint8Array) return Buffer.from(value).toString("base64");
+  if (Array.isArray(value)) return value.map(canonicalize);
+  if (typeof value !== "object" || value === null) return value;
+  return Object.fromEntries(
+    Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, nested]) => [key, canonicalize(nested)])
+  );
+}
+function digestDraft(draft) {
+  const bytes = JSON.stringify(
+    canonicalize({
+      guid: draft.guid,
+      payload: draft.payload,
+      refs: draft.refs,
+      artifacts: draft.artifacts
+    })
+  );
+  return `sha256:${createHash("sha256").update(bytes).digest("hex")}`;
+}
+function failure(key, detail) {
+  return err({
+    stage: "native-cook",
+    code: "native-cook-failed",
+    expected: "a registered native cooker to produce a complete draft",
+    hint: "register the cooker or repair its draft, then rerun recovery",
+    detail,
+    recovery: { action: `rerun native cooker ${key}`, retryable: true }
+  });
+}
+function transactionFailure(key, reason) {
+  return failure(key, { guid: "unknown", producer: reason });
+}
+function recovered(key, previous) {
+  return {
+    ...previous,
+    status: "recovered",
+    lastKnownGood: previous.draft,
+    candidateGeneration: previous.generation + 1,
+    lastKnownGoodGeneration: previous.generation,
+    recoveryHint: `repair ${key} and submit a new candidate generation`
+  };
+}
+var NativeCookerRegistry = class {
+  cookers = /* @__PURE__ */ new Map();
+  register(cooker) {
+    if (typeof cooker.key !== "string" || cooker.key.length === 0) {
+      throw new TypeError("NativeCookerRegistry.register: key must be a non-empty string");
+    }
+    if (typeof cooker.cook !== "function") {
+      throw new TypeError(`NativeCookerRegistry.register: cooker ${cooker.key} must expose cook`);
+    }
+    this.cookers.set(cooker.key, cooker);
+  }
+  get(key) {
+    return this.cookers.get(key);
+  }
+  registeredCookers() {
+    return [...this.cookers.keys()];
+  }
+  async runDraft(key, input) {
+    const cooker = this.cookers.get(key);
+    if (cooker === void 0) {
+      return failure(key, { guid: "unknown", producer: key });
+    }
+    let draft;
+    try {
+      const typedInput = cooker.discover === void 0 ? input : await cooker.discover(input);
+      draft = await cooker.cook(typedInput);
+    } catch (error) {
+      return failure(key, { guid: "unknown", producer: String(error) });
+    }
+    if (draft.guid.length === 0 || draft.inputFingerprint.length === 0 || !Array.isArray(draft.refs) || typeof draft.payload !== "object" || draft.payload === null || typeof draft.artifacts !== "object" || draft.artifacts === null || Object.entries(draft.artifacts).some(
+      ([, artifact]) => artifact === null || typeof artifact !== "object" || typeof artifact.mediaType !== "string" || artifact.mediaType.length === 0 || !(artifact.bytes instanceof Uint8Array)
+    )) {
+      return failure(key, { guid: draft.guid || "unknown", producer: key });
+    }
+    return ok(draft);
+  }
+  async run(key, input) {
+    const draftResult = await this.runDraft(key, input);
+    if (!draftResult.ok) return draftResult;
+    const draft = draftResult.value;
+    const digest = digestDraft(draft);
+    const artifacts = {};
+    for (const [path, artifact] of Object.entries(draft.artifacts)) {
+      artifacts[path] = {
+        path,
+        mediaType: artifact.mediaType,
+        ...artifact.assetCodec === void 0 ? {} : { assetCodec: artifact.assetCodec },
+        byteLength: artifact.bytes.byteLength
+      };
+    }
+    const receipt = {
+      guid: draft.guid,
+      origin: "authoredPack",
+      status: "succeeded",
+      inputFingerprint: draft.inputFingerprint,
+      outputDigest: digest
+    };
+    const product = {
+      guid: draft.guid,
+      payload: draft.payload,
+      refs: draft.refs,
+      artifacts,
+      digest,
+      receipt
+    };
+    return ok(product);
+  }
+  async runTransaction(options) {
+    const candidate = await this.runDraft(options.key, options.input);
+    if (!candidate.ok) {
+      return options.previous === void 0 ? candidate : ok(recovered(options.key, options.previous));
+    }
+    const invalidReason = options.validate?.(candidate.value);
+    if (invalidReason !== void 0) {
+      return options.previous === void 0 ? transactionFailure(options.key, invalidReason) : ok(recovered(options.key, options.previous));
+    }
+    const generation = (options.previous?.generation ?? 0) + 1;
+    try {
+      await options.publish?.(candidate.value, generation);
+    } catch {
+      return options.previous === void 0 ? transactionFailure(options.key, "atomic producer publication failed") : ok(recovered(options.key, options.previous));
+    }
+    return ok({
+      draft: candidate.value,
+      generation,
+      status: "committed",
+      lastKnownGood: candidate.value,
+      candidateGeneration: generation,
+      lastKnownGoodGeneration: generation
+    });
+  }
+};
+
+export { NativeCookerRegistry };
+//# sourceMappingURL=native-cooker.mjs.map
+//# sourceMappingURL=native-cooker.mjs.map

package/dist/native-cooker.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/native-cooker-registry.ts"],"names":[],"mappings":"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","file":"native-cooker.mjs","sourcesContent":["import { createHash } from 'node:crypto';\nimport type {\n  ArtifactDescriptor,\n  AssetCodec,\n  AssetStageError,\n  CookProduct,\n  Result,\n} from '@forgeax/engine-types';\nimport { err, ok } from '@forgeax/engine-types';\n\nexport interface NativeCookArtifact {\n  readonly mediaType: string;\n  readonly assetCodec?: AssetCodec;\n  readonly bytes: Uint8Array;\n}\n\nexport interface NativeCookDraft<P = unknown> {\n  readonly guid: string;\n  readonly payload: P;\n  readonly refs: readonly string[];\n  readonly artifacts: Readonly<Record<string, NativeCookArtifact>>;\n  readonly inputFingerprint: string;\n}\n\nexport interface NativeCooker<P = unknown, I = unknown> {\n  readonly key: string;\n  readonly discover?: (input: unknown) => I | Promise<I>;\n  cook(input: I): NativeCookDraft<P> | Promise<NativeCookDraft<P>>;\n}\n\nexport interface NativeCookTransactionSnapshot<P = unknown> {\n  readonly draft: NativeCookDraft<P>;\n  readonly generation: number;\n}\n\nexport interface NativeCookTransactionOptions<P = unknown, I = unknown> {\n  readonly key: string;\n  readonly input: I;\n  readonly previous?: NativeCookTransactionSnapshot<P>;\n  readonly validate?: (draft: NativeCookDraft<P>) => string | undefined;\n  readonly publish?: (draft: NativeCookDraft<P>, generation: number) => void | Promise<void>;\n}\n\nexport interface NativeCookTransactionResult<P = unknown> extends NativeCookTransactionSnapshot<P> {\n  readonly status: 'committed' | 'recovered';\n  readonly lastKnownGood: NativeCookDraft<P>;\n  readonly candidateGeneration: number;\n  readonly lastKnownGoodGeneration: number;\n  readonly recoveryHint?: string;\n}\n\nfunction canonicalize(value: unknown): unknown {\n  if (value instanceof Uint8Array) return Buffer.from(value).toString('base64');\n  if (Array.isArray(value)) return value.map(canonicalize);\n  if (typeof value !== 'object' || value === null) return value;\n  return Object.fromEntries(\n    Object.entries(value)\n      .sort(([left], [right]) => left.localeCompare(right))\n      .map(([key, nested]) => [key, canonicalize(nested)]),\n  );\n}\n\nfunction digestDraft<P>(draft: NativeCookDraft<P>): string {\n  const bytes = JSON.stringify(\n    canonicalize({\n      guid: draft.guid,\n      payload: draft.payload,\n      refs: draft.refs,\n      artifacts: draft.artifacts,\n    }),\n  );\n  return `sha256:${createHash('sha256').update(bytes).digest('hex')}`;\n}\n\ntype NativeCookErrorDetail = Extract<\n  AssetStageError['detail'],\n  { readonly guid: string; readonly producer: string }\n>;\n\nfunction failure(key: string, detail: NativeCookErrorDetail): Result<never, AssetStageError> {\n  return err({\n    stage: 'native-cook',\n    code: 'native-cook-failed',\n    expected: 'a registered native cooker to produce a complete draft',\n    hint: 'register the cooker or repair its draft, then rerun recovery',\n    detail,\n    recovery: { action: `rerun native cooker ${key}`, retryable: true },\n  });\n}\n\nfunction transactionFailure(key: string, reason: string): Result<never, AssetStageError> {\n  return failure(key, { guid: 'unknown', producer: reason });\n}\n\nfunction recovered<P>(\n  key: string,\n  previous: NativeCookTransactionSnapshot<P>,\n): NativeCookTransactionResult<P> {\n  return {\n    ...previous,\n    status: 'recovered',\n    lastKnownGood: previous.draft,\n    candidateGeneration: previous.generation + 1,\n    lastKnownGoodGeneration: previous.generation,\n    recoveryHint: `repair ${key} and submit a new candidate generation`,\n  };\n}\n\n/** Injectable build-time table for native authored Pack producers. */\nexport class NativeCookerRegistry {\n  private readonly cookers = new Map<string, NativeCooker>();\n\n  register(cooker: NativeCooker): void {\n    if (typeof cooker.key !== 'string' || cooker.key.length === 0) {\n      throw new TypeError('NativeCookerRegistry.register: key must be a non-empty string');\n    }\n    if (typeof cooker.cook !== 'function') {\n      throw new TypeError(`NativeCookerRegistry.register: cooker ${cooker.key} must expose cook`);\n    }\n    this.cookers.set(cooker.key, cooker);\n  }\n\n  get(key: string): NativeCooker | undefined {\n    return this.cookers.get(key);\n  }\n\n  registeredCookers(): readonly string[] {\n    return [...this.cookers.keys()];\n  }\n\n  async runDraft<P = unknown, I = unknown>(\n    key: string,\n    input: I,\n  ): Promise<Result<NativeCookDraft<P>, AssetStageError>> {\n    const cooker = this.cookers.get(key) as NativeCooker<P, I> | undefined;\n    if (cooker === undefined) {\n      return failure(key, { guid: 'unknown', producer: key });\n    }\n    let draft: NativeCookDraft<P>;\n    try {\n      const typedInput = cooker.discover === undefined ? input : await cooker.discover(input);\n      draft = await cooker.cook(typedInput);\n    } catch (error) {\n      return failure(key, { guid: 'unknown', producer: String(error) });\n    }\n    if (\n      draft.guid.length === 0 ||\n      draft.inputFingerprint.length === 0 ||\n      !Array.isArray(draft.refs) ||\n      typeof draft.payload !== 'object' ||\n      draft.payload === null ||\n      typeof draft.artifacts !== 'object' ||\n      draft.artifacts === null ||\n      Object.entries(draft.artifacts).some(\n        ([, artifact]) =>\n          artifact === null ||\n          typeof artifact !== 'object' ||\n          typeof artifact.mediaType !== 'string' ||\n          artifact.mediaType.length === 0 ||\n          !(artifact.bytes instanceof Uint8Array),\n      )\n    ) {\n      return failure(key, { guid: draft.guid || 'unknown', producer: key });\n    }\n    return ok(draft);\n  }\n\n  async run<P = unknown, I = unknown>(\n    key: string,\n    input: I,\n  ): Promise<Result<CookProduct<P>, AssetStageError>> {\n    const draftResult = await this.runDraft<P, I>(key, input);\n    if (!draftResult.ok) return draftResult;\n    const draft = draftResult.value;\n    const digest = digestDraft(draft);\n    const artifacts: Record<string, ArtifactDescriptor> = {};\n    for (const [path, artifact] of Object.entries(draft.artifacts)) {\n      artifacts[path] = {\n        path,\n        mediaType: artifact.mediaType,\n        ...(artifact.assetCodec === undefined ? {} : { assetCodec: artifact.assetCodec }),\n        byteLength: artifact.bytes.byteLength,\n      };\n    }\n    const receipt = {\n      guid: draft.guid,\n      origin: 'authoredPack' as const,\n      status: 'succeeded' as const,\n      inputFingerprint: draft.inputFingerprint,\n      outputDigest: digest,\n    };\n    const product: CookProduct<P> = {\n      guid: draft.guid,\n      payload: draft.payload,\n      refs: draft.refs,\n      artifacts,\n      digest,\n      receipt,\n    };\n    return ok(product);\n  }\n\n  async runTransaction<P = unknown, I = unknown>(\n    options: NativeCookTransactionOptions<P, I>,\n  ): Promise<Result<NativeCookTransactionResult<P>, AssetStageError>> {\n    const candidate = await this.runDraft<P, I>(options.key, options.input);\n    if (!candidate.ok) {\n      return options.previous === undefined\n        ? candidate\n        : ok(recovered(options.key, options.previous));\n    }\n    const invalidReason = options.validate?.(candidate.value);\n    if (invalidReason !== undefined) {\n      return options.previous === undefined\n        ? transactionFailure(options.key, invalidReason)\n        : ok(recovered(options.key, options.previous));\n    }\n    const generation = (options.previous?.generation ?? 0) + 1;\n    try {\n      await options.publish?.(candidate.value, generation);\n    } catch {\n      return options.previous === undefined\n        ? transactionFailure(options.key, 'atomic producer publication failed')\n        : ok(recovered(options.key, options.previous));\n    }\n    return ok({\n      draft: candidate.value,\n      generation,\n      status: 'committed',\n      lastKnownGood: candidate.value,\n      candidateGeneration: generation,\n      lastKnownGoodGeneration: generation,\n    });\n  }\n}\n"]}

package/dist/package-finalizer.d.ts

@@ -0,0 +1,121 @@
+import type { AssetCodec, AssetRelation, CookReceipt } from '@forgeax/engine-types';
+export interface PackageArtifactBody {
+    readonly mediaType: string;
+    readonly assetCodec?: AssetCodec;
+    readonly bytes: Uint8Array;
+}
+export interface PackageProductAsset {
+    readonly guid: string;
+    readonly kind: string;
+    readonly name?: string;
+    readonly payload: Readonly<Record<string, unknown>>;
+    readonly refs: readonly string[];
+    readonly artifacts: Readonly<Record<string, PackageArtifactBody>>;
+}
+export interface PackageProduct {
+    readonly assets: readonly PackageProductAsset[];
+    readonly receipts: readonly CookReceipt[];
+    readonly diagnostics: readonly unknown[];
+    readonly sourceRevision: string;
+    readonly sourceKey?: string;
+}
+/** Minimal authored Pack v1/v2 shape consumed by the file transport seam. */
+export interface AuthoredPackAssetInput {
+    readonly guid: string;
+    readonly kind: string;
+    readonly name?: string;
+    readonly execution?: 'direct' | 'cooked';
+    readonly sourceKey?: string;
+    readonly sourceIndex?: number;
+    readonly relations?: readonly AssetRelation[];
+    readonly payload: Record<string, unknown>;
+    readonly refs?: readonly string[];
+    readonly artifacts?: Readonly<Record<string, unknown>>;
+}
+export interface AuthoredPackInput {
+    readonly schemaVersion?: string;
+    readonly assets?: readonly AuthoredPackAssetInput[];
+}
+export interface PackageDocumentArtifact {
+    readonly path: string;
+    readonly mediaType: string;
+    readonly assetCodec?: AssetCodec;
+    readonly byteLength: number;
+    readonly integrity: {
+        readonly algorithm: 'sha256';
+        readonly digest: string;
+    };
+}
+export interface PackageDocumentAsset {
+    readonly guid: string;
+    readonly kind: string;
+    readonly name?: string;
+    readonly payload: Record<string, unknown>;
+    readonly refs: readonly string[];
+    readonly artifacts: Readonly<Record<string, PackageDocumentArtifact>>;
+}
+export interface PackageDocument {
+    readonly schemaVersion: '2.0.0';
+    readonly kind: 'internal-text-package';
+    readonly assets: readonly PackageDocumentAsset[];
+}
+/** Upgrade the legacy authored Pack envelope at the Pack schema boundary. */
+export declare function upgradeLegacyAuthoredPack(pack: AuthoredPackInput): AuthoredPackInput;
+export interface PackageFinalizePolicy {
+    readonly base: string;
+    readonly packagePath: string;
+    readonly artifactPath: (guid: string, localKey: string) => string;
+    readonly sink?: (path: string, bytes: Uint8Array) => void | Promise<void>;
+}
+export interface FinalizedPackageProduct {
+    readonly pack: PackageDocument;
+    readonly packageUrl: string;
+    readonly digest: string;
+    readonly receipts: readonly CookReceipt[];
+    readonly diagnostics: readonly unknown[];
+    readonly sourceRevision: string;
+    readonly sourceKey?: string;
+}
+interface PackageTransportSource {
+    readonly assets: readonly PackageProduct['assets'][number][];
+    readonly receipts?: readonly CookReceipt[];
+    readonly diagnostics?: readonly unknown[];
+    readonly sourceKey?: string;
+}
+export interface PackageFinalizerError {
+    readonly code: 'duplicate-guid' | 'missing-source-revision' | 'missing-receipt' | 'invalid-artifact';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: {
+        readonly guid?: string;
+        readonly key?: string;
+    };
+}
+export type PackageFinalizeResult = {
+    readonly ok: true;
+    readonly value: FinalizedPackageProduct;
+} | {
+    readonly ok: false;
+    readonly error: PackageFinalizerError;
+};
+/** Finalize a complete producer product without owning producer-specific policy. */
+export declare function finalizePackageProduct(product: PackageProduct, policy: PackageFinalizePolicy): Promise<PackageFinalizeResult>;
+/** Finalize a product-shaped source with the deterministic transport revision. */
+export declare function finalizePackageTransportSource(input: PackageTransportSource, policy: PackageFinalizePolicy): Promise<{
+    pack: PackageDocument;
+    packageUrl: string;
+    artifacts: {
+        bytes: Uint8Array<ArrayBufferLike>;
+        assetCodec?: AssetCodec;
+        guid: string;
+        localKey: string;
+        path: string;
+        mediaType: string;
+    }[];
+    digest: string;
+    sourceRevision: string;
+    semantic: string;
+}>;
+export declare function packageTransportRevision(value: unknown): string;
+export {};
+//# sourceMappingURL=package-finalizer.d.ts.map

package/dist/package-finalizer.d.ts.map

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

package/dist/producer-contract.d.ts

@@ -0,0 +1,19 @@
+import type { ImportedOutputDeclaration, ProducerContractResult } from '@forgeax/engine-types';
+type ProducerObject = Record<string, unknown>;
+/**
+ * Validate one package or imported-output producer declaration.
+ *
+ * The accepted fields mirror the engine-types POD contract. This function
+ * validates that schema without creating a second schema or interpreting
+ * diagnostic messages.
+ */
+export declare function validateProducerContract(value: unknown): ProducerContractResult<ProducerObject>;
+/**
+ * Validate output topology without ever treating `sourceIndex` as identity.
+ *
+ * AI-readable callers should use the discriminated result and its structured
+ * `code`, `expected`, `actual`, and `hint` fields for recovery decisions.
+ */
+export declare function validateProducerOutputs(outputs: readonly ImportedOutputDeclaration[]): ProducerContractResult<readonly ImportedOutputDeclaration[]>;
+export {};
+//# sourceMappingURL=producer-contract.d.ts.map

package/dist/producer-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"producer-contract.d.ts","sourceRoot":"","sources":["../src/producer-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,yBAAyB,EAEzB,sBAAsB,EAEvB,MAAM,uBAAuB,CAAC;AAG/B,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA4I9C;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAiF/F;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,yBAAyB,EAAE,GAC5C,sBAAsB,CAAC,SAAS,yBAAyB,EAAE,CAAC,CA6B9D"}

package/dist/resolve-asset-source.d.ts

@@ -0,0 +1,4 @@
+import type { Result } from '@forgeax/engine-types';
+import { PackError } from './errors.js';
+export declare function resolveAssetSource(metaPath: string, source: string | undefined, paths: Record<string, string>): Result<string, PackError>;
+//# sourceMappingURL=resolve-asset-source.d.ts.map

package/dist/resolve-asset-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-asset-source.d.ts","sourceRoot":"","sources":["../src/resolve-asset-source.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAaxC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAkE3B"}

package/dist/resolve-asset-source.mjs

@@ -0,0 +1,109 @@
+import { dirname, resolve, posix } from 'path';
+import { ok, err, PACK_ERROR_HINTS } from '@forgeax/engine-types';
+
+// src/resolve-asset-source.ts
+
+// src/deriveAssetName.ts
+function baseName(p) {
+  const trimmed = p.replace(/[/\\]+$/, "");
+  const idx = Math.max(trimmed.lastIndexOf("/"), trimmed.lastIndexOf("\\"));
+  return idx === -1 ? trimmed : trimmed.slice(idx + 1);
+}
+function deriveAssetName(packagePath, assetCount, storedName) {
+  if (packagePath === null) {
+    return "";
+  }
+  {
+    return baseName(packagePath);
+  }
+}
+
+// src/errors.ts
+var PackError = class extends Error {
+  code;
+  expected;
+  hint;
+  detail;
+  constructor(args) {
+    super(`[PackError ${args.code}] expected: ${args.expected}; hint: ${args.hint}`);
+    this.name = "PackError";
+    this.code = args.code;
+    this.expected = args.expected;
+    this.hint = args.hint;
+    this.detail = args.detail;
+  }
+};
+
+// src/resolve-asset-source.ts
+function deriveSourceName(metaFileName) {
+  return metaFileName.replace(/\.meta\.json$/, "");
+}
+var PATH_REF_RE = /^@([^/]+)\/(.+)$/;
+function isPathEscape(pathDir, resolved) {
+  const rel = posix.relative(pathDir, resolved);
+  return rel.startsWith("..") || posix.isAbsolute(rel);
+}
+function resolveAssetSource(metaPath, source, paths) {
+  if (source === void 0) {
+    const metaDir = dirname(metaPath);
+    const metaName = deriveAssetName(metaPath);
+    const derived = deriveSourceName(metaName);
+    return ok(resolve(metaDir, derived));
+  }
+  if (source.startsWith("@")) {
+    const match = source.match(PATH_REF_RE);
+    if (!match) {
+      return err(
+        new PackError({
+          code: "pack-malformed-path-ref",
+          expected: "source in format @<name>/<rest>",
+          hint: PACK_ERROR_HINTS["pack-malformed-path-ref"],
+          detail: {
+            code: "pack-malformed-path-ref",
+            reason: "format",
+            rawSource: source,
+            expectedFormat: "@<name>/<rest>"
+          }
+        })
+      );
+    }
+    const [, name, rest] = match;
+    const pathDir = paths[name];
+    if (pathDir === void 0) {
+      return err(
+        new PackError({
+          code: "pack-unknown-path",
+          expected: "path name found in package.json#forgeax.assets.paths",
+          hint: PACK_ERROR_HINTS["pack-unknown-path"],
+          detail: {
+            code: "pack-unknown-path",
+            pathName: name,
+            knownNames: Object.keys(paths)
+          }
+        })
+      );
+    }
+    const resolved = resolve(pathDir, rest);
+    if (isPathEscape(pathDir, resolved)) {
+      return err(
+        new PackError({
+          code: "pack-malformed-path-ref",
+          expected: "rest path must not escape the declared path directory",
+          hint: PACK_ERROR_HINTS["pack-malformed-path-ref"],
+          detail: {
+            code: "pack-malformed-path-ref",
+            reason: "escape",
+            rawSource: source,
+            expectedFormat: "@<name>/<rest>"
+          }
+        })
+      );
+    }
+    return ok(resolved);
+  }
+  return ok(resolve(dirname(metaPath), source));
+}
+
+export { resolveAssetSource };
+//# sourceMappingURL=resolve-asset-source.mjs.map
+//# sourceMappingURL=resolve-asset-source.mjs.map

package/dist/resolve-asset-source.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/deriveAssetName.ts","../src/errors.ts","../src/resolve-asset-source.ts"],"names":["resultOk","resultErr"],"mappings":"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","file":"resolve-asset-source.mjs","sourcesContent":["/**\n * Last path segment of a `/`- or `\\`-separated path, trailing separators\n * stripped. Inlined rather than imported from `node:path` so this module stays\n * browser-safe: the dev-server pack path (`vite-plugin-pack` `/__pack/`) runs\n * `buildCatalog` -> `deriveAssetName` in client code where `node:path` is\n * externalized and `path.basename` throws.\n */\nfunction baseName(p: string): string {\n  const trimmed = p.replace(/[/\\\\]+$/, '');\n  const idx = Math.max(trimmed.lastIndexOf('/'), trimmed.lastIndexOf('\\\\'));\n  return idx === -1 ? trimmed : trimmed.slice(idx + 1);\n}\n\n/**\n * Derive an asset's display name from package metadata.\n *\n * Pure function -- zero IO, zero side effects, browser-safe. Build-time\n * (build-catalog) and runtime (resolveName) share this single source of truth\n * for the XOR name-resolution rules (plan-strategy D-6).\n *\n * Branches:\n *   1. single-asset package (assetCount === 1)      -> baseName(packagePath)\n *   2. multi-asset package + storedName              -> storedName\n *   3. multi-asset package + no storedName (AC-15.1) -> baseName(packagePath)\n *   4. null packagePath + no storedName  (AC-15.2)   -> ''\n */\nexport function deriveAssetName(\n  packagePath: string | null,\n  assetCount: number,\n  storedName?: string,\n): string {\n  if (packagePath === null) {\n    return storedName ?? '';\n  }\n  if (assetCount === 1) {\n    return baseName(packagePath);\n  }\n  if (storedName !== undefined) {\n    return storedName;\n  }\n  return baseName(packagePath);\n}\n","// errors.ts — PackError class (feat-20260513-guid-asset-package-system w15)\n//\n// Four-field surface: .code / .expected / .hint / .detail\n// Structurally parallel to AssetError / RhiError / RemoteError\n// (charter proposition 5 consistent abstraction).\n//\n// .detail is narrowed per .code via PackErrorDetail discriminated union\n// (requirements §6.2 AC-07; plan-strategy §D-5).\n\nimport type { PackErrorCode, PackErrorDetail } from '@forgeax/engine-types';\n\n/**\n * Structured error for the engine-pack disk scanner fail-fast chain.\n *\n * AI users consume via exhaustive switch on .code — no default case needed:\n * ```ts\n * switch (err.code) {\n *   case 'pack-guid-collision':\n *     console.error(err.detail.paths);\n *     break;\n *   case 'pack-cyclic-reference':\n *     console.error(err.detail.cycle);\n *     break;\n *   // ...all 8 cases\n * }\n * ```\n */\nexport class PackError extends Error {\n  readonly code: PackErrorCode;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: PackErrorDetail;\n\n  constructor(args: {\n    code: PackErrorCode;\n    expected: string;\n    hint: string;\n    detail: PackErrorDetail;\n  }) {\n    super(`[PackError ${args.code}] expected: ${args.expected}; hint: ${args.hint}`);\n    this.name = 'PackError';\n    this.code = args.code;\n    this.expected = args.expected;\n    this.hint = args.hint;\n    this.detail = args.detail;\n  }\n}\n","import { dirname, posix, resolve } from 'node:path';\nimport type { Result } from '@forgeax/engine-types';\nimport { PACK_ERROR_HINTS, err as resultErr, ok as resultOk } from '@forgeax/engine-types';\nimport { deriveAssetName } from './deriveAssetName.js';\nimport { PackError } from './errors.js';\n\nfunction deriveSourceName(metaFileName: string): string {\n  return metaFileName.replace(/\\.meta\\.json$/, '');\n}\n\nconst PATH_REF_RE = /^@([^/]+)\\/(.+)$/;\n\nfunction isPathEscape(pathDir: string, resolved: string): boolean {\n  const rel = posix.relative(pathDir, resolved);\n  return rel.startsWith('..') || posix.isAbsolute(rel);\n}\n\nexport function resolveAssetSource(\n  metaPath: string,\n  source: string | undefined,\n  paths: Record<string, string>,\n): Result<string, PackError> {\n  if (source === undefined) {\n    const metaDir = dirname(metaPath);\n    const metaName = deriveAssetName(metaPath, 1);\n    const derived = deriveSourceName(metaName);\n    return resultOk(resolve(metaDir, derived));\n  }\n\n  if (source.startsWith('@')) {\n    const match = source.match(PATH_REF_RE);\n    if (!match) {\n      return resultErr(\n        new PackError({\n          code: 'pack-malformed-path-ref',\n          expected: 'source in format @<name>/<rest>',\n          hint: PACK_ERROR_HINTS['pack-malformed-path-ref'],\n          detail: {\n            code: 'pack-malformed-path-ref',\n            reason: 'format',\n            rawSource: source,\n            expectedFormat: '@<name>/<rest>',\n          },\n        }),\n      );\n    }\n\n    const [, name, rest] = match as [string, string, string];\n    const pathDir = paths[name];\n\n    if (pathDir === undefined) {\n      return resultErr(\n        new PackError({\n          code: 'pack-unknown-path',\n          expected: 'path name found in package.json#forgeax.assets.paths',\n          hint: PACK_ERROR_HINTS['pack-unknown-path'],\n          detail: {\n            code: 'pack-unknown-path',\n            pathName: name,\n            knownNames: Object.keys(paths),\n          },\n        }),\n      );\n    }\n\n    const resolved = resolve(pathDir, rest);\n\n    if (isPathEscape(pathDir, resolved)) {\n      return resultErr(\n        new PackError({\n          code: 'pack-malformed-path-ref',\n          expected: 'rest path must not escape the declared path directory',\n          hint: PACK_ERROR_HINTS['pack-malformed-path-ref'],\n          detail: {\n            code: 'pack-malformed-path-ref',\n            reason: 'escape',\n            rawSource: source,\n            expectedFormat: '@<name>/<rest>',\n          },\n        }),\n      );\n    }\n\n    return resultOk(resolved);\n  }\n\n  return resultOk(resolve(dirname(metaPath), source));\n}\n"]}

package/dist/runtime-projection.d.ts

@@ -0,0 +1,14 @@
+import type { AssetPublicationTuple, AssetRuntimeArtifactDescriptor, PackV2, PackV2Error, Result } from '@forgeax/engine-types';
+export interface RuntimeAssetProjectionInput<P = unknown> {
+    readonly guid: string;
+    readonly kind: string;
+    readonly payload: P;
+    readonly refs: readonly string[];
+    readonly artifacts: Readonly<Record<string, AssetRuntimeArtifactDescriptor>>;
+}
+export interface RuntimePackProjectionInput<P = unknown> extends AssetPublicationTuple {
+    readonly assets: readonly RuntimeAssetProjectionInput<P>[];
+}
+/** Project producer facts into the only runtime Pack v2 envelope. */
+export declare function projectRuntimePack<P = unknown>(value: unknown): Result<PackV2<P>, PackV2Error>;
+//# sourceMappingURL=runtime-projection.d.ts.map

package/dist/runtime-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-projection.d.ts","sourceRoot":"","sources":["../src/runtime-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,qBAAqB,EACrB,8BAA8B,EAC9B,MAAM,EACN,WAAW,EACX,MAAM,EACP,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,2BAA2B,CAAC,CAAC,GAAG,OAAO;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,8BAA8B,CAAC,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,0BAA0B,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,qBAAqB;IACpF,QAAQ,CAAC,MAAM,EAAE,SAAS,2BAA2B,CAAC,CAAC,CAAC,EAAE,CAAC;CAC5D;AA2CD,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAmC9F"}

package/dist/runtime-publication.d.ts

@@ -0,0 +1,44 @@
+import type { AssetPublicationEnvelope, AssetPublicationExternalEvidence, AssetPublicationOutput } from '@forgeax/engine-types';
+export interface RuntimePackAssetInput {
+    readonly guid: string;
+    readonly kind: string;
+    readonly name?: string;
+    readonly payload: unknown;
+    readonly refs?: readonly string[];
+    readonly artifacts?: Readonly<Record<string, unknown>>;
+}
+export interface RuntimePackInput {
+    readonly assets: readonly RuntimePackAssetInput[];
+}
+export interface RuntimePackEnvelope {
+    readonly schemaVersion: '2.0.0';
+    readonly kind: 'internal-text-package';
+    readonly scopeId: string;
+    readonly generation: number;
+    readonly digest: string;
+    readonly outputSetDigest: string;
+    readonly assets: readonly RuntimePackAsset[];
+}
+export interface RuntimePackPublication {
+    readonly pack: RuntimePackEnvelope;
+    readonly publication: AssetPublicationEnvelope;
+}
+interface RuntimePackAsset extends RuntimePackAssetInput {
+    readonly refs: readonly string[];
+    readonly artifacts: Readonly<Record<string, unknown>>;
+}
+export interface RuntimePackPublicationInput {
+    readonly pack: RuntimePackInput;
+    readonly scopeId: string;
+    readonly sourcePath: string;
+    readonly sourceRevision: string;
+    readonly packageUrl: string;
+    readonly inputFingerprint?: string;
+    readonly digest?: string;
+    readonly generation?: number;
+    readonly outputs?: readonly AssetPublicationOutput[];
+    readonly externalEvidence?: readonly AssetPublicationExternalEvidence[];
+}
+export declare function createRuntimePackPublication(input: RuntimePackPublicationInput): RuntimePackPublication;
+export {};
+//# sourceMappingURL=runtime-publication.d.ts.map

package/dist/runtime-publication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-publication.d.ts","sourceRoot":"","sources":["../src/runtime-publication.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,wBAAwB,EACxB,gCAAgC,EAChC,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;CAChD;AAED,UAAU,gBAAiB,SAAQ,qBAAqB;IACtD,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACrD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,gCAAgC,EAAE,CAAC;CACzE;AAoFD,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,2BAA2B,GACjC,sBAAsB,CAoDxB"}

package/dist/runtime.d.ts

@@ -0,0 +1,8 @@
+import type { PackV2, PackV2Error, Result } from '@forgeax/engine-types';
+export { validateMeta, validatePack, validatePackV2 } from './schema-compiled.js';
+/**
+ * Parse a Pack v2 envelope without loading the Node-only scanner/evidence
+ * barrel. Browser runtime consumers should import this subpath.
+ */
+export declare function parsePackV2(value: unknown): Result<PackV2, PackV2Error>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAKzE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAElF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAWvE"}