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

package/dist/lifecycle.d.ts

@@ -0,0 +1,93 @@
+export type DdcLifecycleState = 'missing' | 'cooking' | 'current' | 'stale' | 'failed';
+export interface DdcLease {
+    readonly guid: string;
+    readonly desiredKey: string;
+    readonly attempt: string;
+    readonly generation: number;
+    readonly expectedRevision: number;
+    readonly instanceId: string;
+    readonly expiresAt: number;
+}
+export interface DdcHead {
+    readonly guid: string;
+    readonly desiredKey: string;
+    readonly state: DdcLifecycleState;
+    readonly currentKey: string | undefined;
+    readonly lastKnownGoodKey: string | undefined;
+    readonly revision?: number;
+    readonly generation?: number;
+    readonly activeLease?: DdcLease;
+    readonly failure?: {
+        readonly code: string;
+        readonly detail: string;
+    };
+}
+export interface DdcCommitResult {
+    readonly result: 'current' | 'stale' | 'lease-lost' | 'invalid';
+    readonly key: string;
+    readonly revision?: number;
+    /** Internal CAS evidence retained for a later generation rollback. */
+    readonly restoreFence?: DdcRestoreFence;
+}
+export interface DdcRestoreFence {
+    readonly attempt: string;
+    readonly generation: number;
+    readonly revision: number;
+    readonly desiredKey: string;
+    readonly outcome: 'current' | 'invalid' | 'failed';
+    readonly key?: string;
+    readonly currentKey?: string;
+    readonly lastKnownGoodKey?: string;
+    readonly failure?: {
+        readonly code: string;
+        readonly detail: string;
+    };
+}
+export interface DdcRestoreResult {
+    readonly result: 'restored' | 'not-owner';
+    readonly revision: number;
+    readonly generation?: number;
+}
+export type DdcRollbackSnapshot = Omit<DdcHead, 'activeLease'>;
+export interface DdcBeginResult {
+    readonly lease: DdcLease;
+    readonly previousHead: DdcRollbackSnapshot;
+}
+/** Cross-process mkdir lock; a lock owned by a dead PID is reclaimable. */
+export declare function withDdcLock<T>(root: string, name: string, operation: () => Promise<T>): Promise<T>;
+export declare class DdcLifecycle {
+    private readonly heads;
+    private readonly entries;
+    private readonly root;
+    private readonly leaseTtlMs;
+    constructor(root: string, options?: {
+        readonly leaseTtlMs?: number;
+    });
+    inspect(guid: string, desiredKey: string): Promise<DdcHead>;
+    /** Begin a lease and capture the accepted rollback snapshot under one head lock. */
+    beginWithSnapshot(guid: string, desiredKey: string): Promise<DdcBeginResult>;
+    begin(guid: string, desiredKey: string): Promise<DdcLease>;
+    commit(lease: DdcLease, validatedKey: string): Promise<DdcCommitResult>;
+    fail(lease: DdcLease, failure: {
+        readonly code: string;
+        readonly detail: string;
+    }): Promise<DdcRestoreFence | undefined>;
+    heartbeat(lease: DdcLease): Promise<DdcLease>;
+    close(lease: DdcLease): Promise<void>;
+    discard(lease: DdcLease): Promise<void>;
+    /**
+     * Restore accepted content only when this lease still owns the mutable head.
+     * A newer active or terminal mutation makes rollback a deliberate no-op.
+     */
+    restore(head: DdcHead | DdcRollbackSnapshot, lease?: DdcLease, fence?: DdcRestoreFence): Promise<DdcRestoreResult>;
+    restoreIfCurrent(snapshot: DdcRollbackSnapshot, lease: DdcLease, fence?: DdcRestoreFence): Promise<DdcRestoreResult>;
+    revoke(lease: DdcLease): Promise<void>;
+    recover(guid: string, desiredKey: string): Promise<DdcHead>;
+    private rollbackSnapshot;
+    private matchesRestoreFence;
+    private projectHead;
+    private allocateGeneration;
+    private read;
+    private write;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

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

package/dist/publication.d.ts

@@ -0,0 +1,50 @@
+import type { AssetPublicationEnvelope, AssetPublicationExternalEvidence, AssetPublicationFailure, AssetPublicationLocator, AssetPublicationOutput, AssetPublicationRecovery, Result } from '@forgeax/engine-types';
+export interface ScriptablePackPublicationSnapshot {
+    readonly current?: AssetPublicationEnvelope;
+    readonly lastKnownGood?: AssetPublicationEnvelope;
+    readonly failure?: AssetPublicationFailure;
+}
+export interface ScriptablePackPublicationError extends AssetPublicationFailure {
+    readonly recovery: AssetPublicationRecovery;
+    readonly current?: AssetPublicationLocator;
+    readonly lastKnownGood?: AssetPublicationLocator;
+}
+export interface AcceptedPublicationCandidate {
+    readonly envelope: AssetPublicationEnvelope;
+    readonly cancelled?: boolean;
+}
+export interface ScriptablePackPublicationBuildInput {
+    readonly sourcePath: string;
+    readonly sourceRevision: string;
+    /** Optional caller generation; the DDC owner derives one when omitted. */
+    readonly generation?: number;
+    readonly digest: string;
+    readonly packageUrl: string;
+    readonly inputFingerprint: string;
+    readonly outputs: readonly AssetPublicationOutput[];
+    readonly externalEvidence: readonly AssetPublicationExternalEvidence[];
+}
+/**
+ * DDC-owned publication authority for source keyed producers.  Transport
+ * adapters may stage bytes, but they do not retain current/LKG or generation
+ * state themselves.
+ */
+export interface AcceptedPublicationStore {
+    observe(sourcePath: string): ScriptablePackPublicationSnapshot;
+    stage(sourcePath: string, candidate: AcceptedPublicationCandidate): Result<void, ScriptablePackPublicationError>;
+    commit(sourcePath: string, candidate: AcceptedPublicationCandidate, commitRoute: () => Promise<void> | void): Promise<Result<ScriptablePackPublicationSnapshot, ScriptablePackPublicationError>>;
+    discard(sourcePath: string, candidate: AssetPublicationEnvelope): void;
+    restore(sourcePath: string, snapshot: ScriptablePackPublicationSnapshot): void;
+}
+export declare function scriptablePackOutputSetDigest(outputs: readonly AssetPublicationOutput[]): string;
+/** Derive a stable positive generation from the accepted publication tuple. */
+export declare function scriptablePackPublicationGeneration(input: {
+    readonly sourceRevision: string;
+    readonly digest: string;
+    readonly outputSetDigest: string;
+}): number;
+/** Build the complete producer-owned tuple after the package route is finalized. */
+export declare function createAcceptedPublication(input: ScriptablePackPublicationBuildInput): AssetPublicationEnvelope;
+/** Create the one DDC publication authority shared by dev attempts. */
+export declare function createAcceptedPublicationStore(): AcceptedPublicationStore;
+//# sourceMappingURL=publication.d.ts.map

package/dist/publication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publication.d.ts","sourceRoot":"","sources":["../src/publication.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,wBAAwB,EACxB,gCAAgC,EAChC,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,MAAM,EACP,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,wBAAwB,CAAC;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC;CAC5C;AAED,MAAM,WAAW,8BAA+B,SAAQ,uBAAuB;IAC7E,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,uBAAuB,CAAC;CAClD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACpD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,gCAAgC,EAAE,CAAC;CACxE;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,iCAAiC,CAAC;IAC/D,KAAK,CACH,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,4BAA4B,GACtC,MAAM,CAAC,IAAI,EAAE,8BAA8B,CAAC,CAAC;IAChD,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,4BAA4B,EACvC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACtC,OAAO,CAAC,MAAM,CAAC,iCAAiC,EAAE,8BAA8B,CAAC,CAAC,CAAC;IACtF,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACvE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,iCAAiC,GAAG,IAAI,CAAC;CAChF;AAkBD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,GAAG,MAAM,CAUhG;AAED,+EAA+E;AAC/E,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC,GAAG,MAAM,CAUT;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,mCAAmC,GACzC,wBAAwB,CAmC1B;AAuPD,uEAAuE;AACvE,wBAAgB,8BAA8B,IAAI,wBAAwB,CAqDzE"}

package/dist/runtime-scope.d.ts

@@ -0,0 +1,10 @@
+export interface DdcRuntimeScope {
+    readonly scopeId: string;
+    readonly scopeHash: string;
+    readonly root: string;
+    readonly metadataPath: string;
+}
+export declare function runtimeScopeHash(scopeId: string): string;
+export declare function createRuntimeScope(root: string, scopeId: string): Promise<DdcRuntimeScope>;
+export declare function assertRuntimeScope(root: string, scope: Pick<DdcRuntimeScope, 'scopeId' | 'scopeHash'>): Promise<DdcRuntimeScope>;
+//# sourceMappingURL=runtime-scope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-scope.d.ts","sourceRoot":"","sources":["../src/runtime-scope.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAYD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA0ChG;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,WAAW,CAAC,GACpD,OAAO,CAAC,eAAe,CAAC,CAa1B"}

package/dist/session.d.ts

@@ -0,0 +1,46 @@
+import type { DdcEntry, StagedDdcEntry } from './entry-store.js';
+import type { DdcCommitResult, DdcHead, DdcLease, DdcRestoreResult, DdcRollbackSnapshot } from './lifecycle.js';
+export interface DdcSessionOptions {
+    readonly generation: number;
+    readonly leaseTtlMs?: number;
+}
+export interface DdcGenerationCandidate {
+    readonly generation: number;
+    readonly lease: DdcLease;
+    readonly previousHead: DdcRollbackSnapshot;
+}
+export interface DdcGenerationEntryCandidate extends DdcGenerationCandidate {
+    readonly staged: StagedDdcEntry;
+}
+export interface DdcSessionMetrics {
+    readonly hitCount: number;
+    readonly missCount: number;
+    readonly corruptCount: number;
+    readonly writeFailureCount: number;
+}
+export declare class DdcGenerationSession {
+    readonly generation: number;
+    private readonly lifecycle;
+    private readonly entries;
+    private readonly candidates;
+    private readonly restoreFences;
+    private readonly heartbeatTimers;
+    private readonly counters;
+    private accepting;
+    constructor(root: string, options: DdcSessionOptions);
+    beginCandidate(guid: string, desiredKey: string): Promise<DdcGenerationCandidate>;
+    stageEntry(entry: DdcEntry): Promise<DdcGenerationEntryCandidate>;
+    inspect(guid: string, desiredKey: string): Promise<DdcHead>;
+    commitCandidate(candidate: DdcGenerationCandidate, validatedKey: string): Promise<DdcCommitResult>;
+    commitEntry(candidate: DdcGenerationEntryCandidate, validatedKey: string): Promise<DdcCommitResult>;
+    discardCandidate(candidate: DdcGenerationCandidate): Promise<void>;
+    discardEntry(candidate: DdcGenerationEntryCandidate): Promise<void>;
+    restoreEntry(candidate: DdcGenerationEntryCandidate): Promise<DdcRestoreResult>;
+    metrics(): DdcSessionMetrics;
+    close(): Promise<void>;
+    private assertOpen;
+    private assertCandidate;
+    private scheduleHeartbeat;
+    private stopHeartbeat;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,KAAK,EACV,eAAe,EACf,OAAO,EACP,QAAQ,EAER,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;CAC5C;AAED,MAAM,WAAW,2BAA4B,SAAQ,sBAAsB;IACzE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAmBD,qBAAa,oBAAoB;IAC/B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoD;IAC/E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0D;IACxF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAKvB;IACF,OAAO,CAAC,SAAS,CAAQ;gBAEN,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB;IAY9C,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAejF,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,2BAA2B,CAAC;IA0BjE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ3D,eAAe,CAC1B,SAAS,EAAE,sBAAsB,EACjC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,CAAC;IAiBd,WAAW,CACtB,SAAS,EAAE,2BAA2B,EACtC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,CAAC;IAwBd,gBAAgB,CAAC,SAAS,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAalE,YAAY,CAAC,SAAS,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE,YAAY,CAAC,SAAS,EAAE,2BAA2B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2BrF,OAAO,IAAI,iBAAiB;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBnC,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,aAAa;CAOtB"}

package/dist/status.d.ts

@@ -0,0 +1,39 @@
+import type { DdcErrorRootKind } from './errors.js';
+export declare const DDC_STATUS_SCHEMA: "forgeax-ddc-status/v2";
+export type DdcStatusHealth = 'ready' | 'blocked' | 'missing' | 'stale' | 'failed';
+export type DdcStatusLayerKind = 'build' | 'project' | 'runtime';
+export type DdcStatusRootKind = DdcErrorRootKind;
+export interface DdcRecoveryAction {
+    readonly kind: 'inspect' | 'allocate-generation' | 'retry' | 'cold-rebuild' | 'prune';
+    readonly executable: boolean;
+    readonly exactTarget?: string;
+    readonly reason?: string;
+}
+export interface DdcStatusLayer {
+    readonly kind: DdcStatusLayerKind;
+    readonly owner: 'engine-ddc' | 'engine-pack' | 'plugin' | 'runtime';
+    readonly rootKind: DdcStatusRootKind;
+    readonly scopeId?: string;
+    readonly current?: number | string;
+    readonly lastKnownGood?: number | string;
+    readonly protection: readonly string[];
+    readonly actions: readonly DdcRecoveryAction[];
+}
+export interface DdcStatus {
+    readonly schemaVersion: typeof DDC_STATUS_SCHEMA;
+    readonly health: DdcStatusHealth;
+    readonly layers: readonly DdcStatusLayer[];
+    readonly gameDir?: string;
+    readonly projectDdcRoot?: string;
+}
+export type BrowserDdcRecoveryAction = Omit<DdcRecoveryAction, 'exactTarget'>;
+export type BrowserDdcStatusLayer = Omit<DdcStatusLayer, 'actions'> & {
+    readonly actions: readonly BrowserDdcRecoveryAction[];
+};
+export type BrowserDdcStatus = Omit<DdcStatus, 'gameDir' | 'projectDdcRoot' | 'layers'> & {
+    readonly layers: readonly BrowserDdcStatusLayer[];
+};
+export declare function serializeDdcStatus(status: DdcStatus): string;
+export declare function projectDdcStatusForBrowser(status: DdcStatus): BrowserDdcStatus;
+export declare const toBrowserDdcStatus: typeof projectDdcStatusForBrowser;
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,eAAO,MAAM,iBAAiB,EAAG,uBAAgC,CAAC;AAElE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AACnF,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AACjE,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,qBAAqB,GAAG,OAAO,GAAG,cAAc,GAAG,OAAO,CAAC;IACtF,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpE,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,aAAa,EAAE,OAAO,iBAAiB,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG;IACpE,QAAQ,CAAC,OAAO,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACvD,CAAC;AACF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,gBAAgB,GAAG,QAAQ,CAAC,GAAG;IACxF,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACnD,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAE5D;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,gBAAgB,CAS9E;AAED,eAAO,MAAM,kBAAkB,mCAA6B,CAAC"}

package/dist/status.mjs

@@ -0,0 +1,20 @@
+// src/status.ts
+var DDC_STATUS_SCHEMA = "forgeax-ddc-status/v2";
+function serializeDdcStatus(status) {
+  return JSON.stringify(status);
+}
+function projectDdcStatusForBrowser(status) {
+  return {
+    schemaVersion: DDC_STATUS_SCHEMA,
+    health: status.health,
+    layers: status.layers.map((layer) => ({
+      ...layer,
+      actions: layer.actions.map(({ exactTarget: _exactTarget, ...action }) => action)
+    }))
+  };
+}
+var toBrowserDdcStatus = projectDdcStatusForBrowser;
+
+export { DDC_STATUS_SCHEMA, projectDdcStatusForBrowser, serializeDdcStatus, toBrowserDdcStatus };
+//# sourceMappingURL=status.mjs.map
+//# sourceMappingURL=status.mjs.map

package/dist/status.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/status.ts"],"names":[],"mappings":";AAEO,IAAM,iBAAA,GAAoB;AAwC1B,SAAS,mBAAmB,MAAA,EAA2B;AAC5D,EAAA,OAAO,IAAA,CAAK,UAAU,MAAM,CAAA;AAC9B;AAEO,SAAS,2BAA2B,MAAA,EAAqC;AAC9E,EAAA,OAAO;AAAA,IACL,aAAA,EAAe,iBAAA;AAAA,IACf,QAAQ,MAAA,CAAO,MAAA;AAAA,IACf,MAAA,EAAQ,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,CAAC,KAAA,MAAW;AAAA,MACpC,GAAG,KAAA;AAAA,MACH,OAAA,EAAS,KAAA,CAAM,OAAA,CAAQ,GAAA,CAAI,CAAC,EAAE,WAAA,EAAa,YAAA,EAAc,GAAG,MAAA,EAAO,KAAM,MAAM;AAAA,KACjF,CAAE;AAAA,GACJ;AACF;AAEO,IAAM,kBAAA,GAAqB","file":"status.mjs","sourcesContent":["import type { DdcErrorRootKind } from './errors.js';\n\nexport const DDC_STATUS_SCHEMA = 'forgeax-ddc-status/v2' as const;\n\nexport type DdcStatusHealth = 'ready' | 'blocked' | 'missing' | 'stale' | 'failed';\nexport type DdcStatusLayerKind = 'build' | 'project' | 'runtime';\nexport type DdcStatusRootKind = DdcErrorRootKind;\n\nexport interface DdcRecoveryAction {\n  readonly kind: 'inspect' | 'allocate-generation' | 'retry' | 'cold-rebuild' | 'prune';\n  readonly executable: boolean;\n  readonly exactTarget?: string;\n  readonly reason?: string;\n}\n\nexport interface DdcStatusLayer {\n  readonly kind: DdcStatusLayerKind;\n  readonly owner: 'engine-ddc' | 'engine-pack' | 'plugin' | 'runtime';\n  readonly rootKind: DdcStatusRootKind;\n  readonly scopeId?: string;\n  readonly current?: number | string;\n  readonly lastKnownGood?: number | string;\n  readonly protection: readonly string[];\n  readonly actions: readonly DdcRecoveryAction[];\n}\n\nexport interface DdcStatus {\n  readonly schemaVersion: typeof DDC_STATUS_SCHEMA;\n  readonly health: DdcStatusHealth;\n  readonly layers: readonly DdcStatusLayer[];\n  readonly gameDir?: string;\n  readonly projectDdcRoot?: string;\n}\n\nexport type BrowserDdcRecoveryAction = Omit<DdcRecoveryAction, 'exactTarget'>;\nexport type BrowserDdcStatusLayer = Omit<DdcStatusLayer, 'actions'> & {\n  readonly actions: readonly BrowserDdcRecoveryAction[];\n};\nexport type BrowserDdcStatus = Omit<DdcStatus, 'gameDir' | 'projectDdcRoot' | 'layers'> & {\n  readonly layers: readonly BrowserDdcStatusLayer[];\n};\n\nexport function serializeDdcStatus(status: DdcStatus): string {\n  return JSON.stringify(status);\n}\n\nexport function projectDdcStatusForBrowser(status: DdcStatus): BrowserDdcStatus {\n  return {\n    schemaVersion: DDC_STATUS_SCHEMA,\n    health: status.health,\n    layers: status.layers.map((layer) => ({\n      ...layer,\n      actions: layer.actions.map(({ exactTarget: _exactTarget, ...action }) => action),\n    })),\n  };\n}\n\nexport const toBrowserDdcStatus = projectDdcStatusForBrowser;\n"]}

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "@forgeax/engine-ddc",
+  "version": "0.0.0-dev.8d955ade1c79",
+  "private": false,
+  "type": "module",
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "description": "Node-only v2 immutable derived data cache with project-local lifecycle evidence.",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "node": {
+        "import": "./dist/index.mjs"
+      },
+      "default": null
+    },
+    "./key": {
+      "types": "./dist/key.d.ts",
+      "node": {
+        "import": "./dist/key.mjs"
+      },
+      "default": null
+    },
+    "./entry-store": {
+      "types": "./dist/entry-store.d.ts",
+      "node": {
+        "import": "./dist/entry-store.mjs"
+      },
+      "default": null
+    },
+    "./layout": {
+      "types": "./dist/layout.d.ts",
+      "node": {
+        "import": "./dist/layout.mjs"
+      },
+      "default": null
+    },
+    "./status": {
+      "types": "./dist/status.d.ts",
+      "node": {
+        "import": "./dist/status.mjs"
+      },
+      "default": null
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "node": {
+        "import": "./dist/errors.mjs"
+      },
+      "default": null
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "forgeax": {
+    "metrics": {
+      "bundle-size": {
+        "enabled": true,
+        "path": "dist/index.mjs",
+        "compression": "gzip"
+      },
+      "fps": {
+        "enabled": false,
+        "reason": "Node-only build-time cache package; no runtime frame loop"
+      },
+      "bench": {
+        "enabled": false,
+        "reason": "DDC transaction correctness is covered by integration tests; no benchmark contract is declared"
+      },
+      "gate": {
+        "enabled": false,
+        "reason": "No package-level binary gate; workspace CI owns cache audit and type gates"
+      },
+      "spike-report": {
+        "enabled": false,
+        "reason": "Not a spike package"
+      }
+    }
+  },
+  "dependencies": {
+    "@forgeax/engine-types": "0.0.0-dev.8d955ade1c79"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.8.3",
+    "vitest": "4.1.5"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -b",
+    "test": "vitest run"
+  }
+}

package/src/__tests__/concurrency.integration.test.ts

@@ -0,0 +1,53 @@
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { type DdcEntry, DdcEntryStore, ddcOutputDigest } from '../entry-store.js';
+
+const KEY = 'a'.repeat(64);
+const entry = (payload: string): DdcEntry => {
+  const value = {
+    key: KEY,
+    guid: '019e3969-1d48-7c3b-ac24-6d68f457065f',
+    payload: { payload },
+    refs: [],
+    artifacts: {
+      data: { mediaType: 'application/octet-stream', bytes: new Uint8Array([1, 2, 3]) },
+    },
+    receipt: {
+      guid: '019e3969-1d48-7c3b-ac24-6d68f457065f',
+      key: KEY,
+      producer: 'test-producer',
+      inputFingerprint: 'input',
+      outputDigest: '',
+    },
+  } satisfies DdcEntry;
+  return { ...value, receipt: { ...value.receipt, outputDigest: ddcOutputDigest(value) } };
+};
+
+describe('DDC same-key writer concurrency', () => {
+  const roots: string[] = [];
+
+  afterEach(async () => {
+    await Promise.all(roots.splice(0).map((root) => rm(root, { recursive: true, force: true })));
+  });
+
+  it('lets one writer publish and makes the loser observe an identical entry', async () => {
+    const root = await mkdtemp(join(tmpdir(), 'forgeax-ddc-concurrency-'));
+    roots.push(root);
+    const store = new DdcEntryStore(root);
+    const results = await Promise.all([store.write(entry('same')), store.write(entry('same'))]);
+
+    expect(results.map((result) => result.result).sort()).toEqual(['existing', 'published']);
+    await expect(store.read(KEY)).resolves.toEqual(entry('same'));
+  });
+
+  it('reports a conflict when the same key maps to different bytes', async () => {
+    const root = await mkdtemp(join(tmpdir(), 'forgeax-ddc-concurrency-'));
+    roots.push(root);
+    const store = new DdcEntryStore(root);
+    await store.write(entry('first'));
+    await expect(store.write(entry('second'))).resolves.toEqual({ result: 'conflict', key: KEY });
+    await expect(store.read(KEY)).resolves.toEqual(entry('first'));
+  });
+});

package/src/__tests__/consumer-path.integration.test.ts

@@ -0,0 +1,61 @@
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { type DdcEntry, DdcEntryStore, ddcOutputDigest } from '../entry-store.js';
+
+const guid = '019e3969-1d48-7c3b-ac24-6d68f457065f';
+const key = 'a'.repeat(64);
+
+describe('DDC consumer path', () => {
+  const roots: string[] = [];
+
+  afterEach(async () => {
+    await Promise.all(roots.splice(0).map((root) => rm(root, { recursive: true, force: true })));
+  });
+
+  it('rebuilds the same output after deleting DDC storage', async () => {
+    const firstRoot = await mkdtemp(join(tmpdir(), 'forgeax-ddc-consumer-'));
+    const secondRoot = await mkdtemp(join(tmpdir(), 'forgeax-ddc-consumer-'));
+    roots.push(firstRoot, secondRoot);
+    const cookedBase = {
+      key,
+      guid,
+      payload: { kind: 'texture', width: 2, height: 1 },
+      refs: [],
+      artifacts: {
+        payload: { mediaType: 'application/octet-stream', bytes: new Uint8Array([1, 2]) },
+      },
+      receipt: {
+        guid,
+        key,
+        producer: 'image-importer@4',
+        inputFingerprint: 'source-bytes',
+        outputDigest: '',
+      },
+    } satisfies DdcEntry;
+    const cooked: DdcEntry = {
+      ...cookedBase,
+      receipt: { ...cookedBase.receipt, outputDigest: ddcOutputDigest(cookedBase) },
+    };
+
+    const firstStore = new DdcEntryStore(firstRoot);
+    await firstStore.write(cooked);
+    const cold = await firstStore.read(key);
+    await rm(firstRoot, { recursive: true, force: true });
+    const secondStore = new DdcEntryStore(secondRoot);
+    await secondStore.write(cooked);
+    const rebuilt = await secondStore.read(key);
+
+    expect(rebuilt).toEqual(cold);
+    expect(rebuilt?.guid).toBe(guid);
+    expect(rebuilt?.receipt.outputDigest).toBe(ddcOutputDigest(cooked));
+  });
+
+  it('keeps a direct product path independent from DDC presence', async () => {
+    const root = await mkdtemp(join(tmpdir(), 'forgeax-ddc-direct-'));
+    roots.push(root);
+    const store = new DdcEntryStore(root);
+    await expect(store.read(key)).resolves.toBeNull();
+  });
+});

package/src/__tests__/crash-recovery.integration.test.ts

@@ -0,0 +1,84 @@
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { DdcEntryStore, ddcOutputDigest } from '../entry-store.js';
+import { DdcLifecycle } from '../lifecycle.js';
+
+const GUID = '019e3969-1d48-7c3b-ac24-6d68f457065f';
+const KEY_A = 'a'.repeat(64);
+const KEY_B = 'b'.repeat(64);
+
+async function writeEntry(root: string, key: string): Promise<void> {
+  const base = {
+    key,
+    guid: GUID,
+    payload: { key },
+    refs: [],
+    artifacts: {},
+    receipt: {
+      guid: GUID,
+      key,
+      producer: 'test',
+      inputFingerprint: key,
+      outputDigest: '',
+    },
+  } as const;
+  await new DdcEntryStore(root).write({
+    ...base,
+    receipt: { ...base.receipt, outputDigest: ddcOutputDigest(base) },
+  });
+}
+
+describe('DDC lease and crash recovery', () => {
+  const roots: string[] = [];
+
+  afterEach(async () => {
+    await Promise.all(roots.splice(0).map((root) => rm(root, { recursive: true, force: true })));
+  });
+
+  it('keeps a crashed cooking attempt out of the readable head', async () => {
+    const root = await mkdtemp(join(tmpdir(), 'forgeax-ddc-crash-'));
+    roots.push(root);
+    const lifecycle = new DdcLifecycle(root);
+    await lifecycle.begin(GUID, KEY_A);
+
+    await expect(lifecycle.inspect(GUID, KEY_A)).resolves.toMatchObject({ state: 'cooking' });
+    await expect(lifecycle.recover(GUID, KEY_A)).resolves.toMatchObject({ state: 'failed' });
+    await expect(lifecycle.inspect(GUID, KEY_A)).resolves.toMatchObject({
+      state: 'failed',
+      currentKey: undefined,
+    });
+  });
+
+  it('rejects a commit after the lease is lost', async () => {
+    const root = await mkdtemp(join(tmpdir(), 'forgeax-ddc-crash-'));
+    roots.push(root);
+    const lifecycle = new DdcLifecycle(root);
+    const lease = await lifecycle.begin(GUID, KEY_A);
+    await lifecycle.revoke(lease);
+
+    await expect(lifecycle.commit(lease, KEY_A)).resolves.toEqual({
+      result: 'lease-lost',
+      key: KEY_A,
+    });
+  });
+
+  it('keeps an old writer stale after a newer desired key starts cooking', async () => {
+    const root = await mkdtemp(join(tmpdir(), 'forgeax-ddc-crash-'));
+    roots.push(root);
+    const lifecycle = new DdcLifecycle(root);
+    const oldLease = await lifecycle.begin(GUID, KEY_A);
+    const newLease = await lifecycle.begin(GUID, KEY_B);
+    await writeEntry(root, KEY_B);
+
+    await expect(lifecycle.commit(oldLease, KEY_A)).resolves.toEqual({
+      result: 'stale',
+      key: KEY_A,
+    });
+    await expect(lifecycle.commit(newLease, KEY_B)).resolves.toEqual({
+      result: 'current',
+      key: KEY_B,
+    });
+  });
+});