@futdevpro/fsm-dynamo 1.20.95 → 1.20.99

package/build/_modules/game/_models/game-save.interface.d.ts

@@ -0,0 +1,76 @@
+/**
+ * BFR-WARFACTORY-011 — headless game-save contracts. No provider credential, platform binding or game payload shape
+ * lives here: the payload is opaque (`TPayload`, typically the serialized game state), adapters are the game's.
+ */
+/** The envelope format marker — an unknown one is rejected, never guessed. */
+export type DyFM_GameSave_Format_Type = 'dyfm-game-save/1';
+/** The list / conflict view of a save: everything except the payload. */
+export interface DyFM_GameSave_Metadata {
+    format: DyFM_GameSave_Format_Type;
+    /** The game (one envelope format serves several games). */
+    gameId: string;
+    /** The save slot (the adapter-level key). */
+    slotId: string;
+    /** The GAME's payload schema version (integer ≥ 1) — what migrations step through. */
+    schemaVersion: number;
+    /** When it was saved (Unix ms, from the caller's clock). */
+    savedAtMs: number;
+    /** Deterministic checksum of the payload (corruption + identity). */
+    checksum: string;
+    /** The checksum of the save this one was made FROM (lineage) — lets conflict resolution prove descent. */
+    parentChecksum?: string;
+    /** Display label (optional). */
+    label?: string;
+}
+/** A full save: metadata + the opaque payload. */
+export interface DyFM_GameSave_Envelope<TPayload = unknown> extends DyFM_GameSave_Metadata {
+    payload: TPayload;
+}
+/** What a game passes to `seal` — the checksum and the format are computed, never hand-written. */
+export interface DyFM_GameSave_SealInput<TPayload = unknown> {
+    gameId: string;
+    slotId: string;
+    schemaVersion: number;
+    savedAtMs: number;
+    payload: TPayload;
+    parentChecksum?: string;
+    label?: string;
+}
+/** A storage adapter (localStorage, file system, Steam, cloud …) — implemented by the game, not here. */
+export interface DyFM_GameSave_Adapter_Interface<TPayload = unknown> {
+    /** Writes (overwrites) the slot. */
+    write(envelope: DyFM_GameSave_Envelope<TPayload>): Promise<void>;
+    /** Reads a slot; `null` when it does not exist. Callers should pass the raw result through `parse`. */
+    read(slotId: string): Promise<unknown>;
+    /** Lists the slots' metadata (no payloads — the list UI must not load every save into memory). */
+    list(): Promise<DyFM_GameSave_Metadata[]>;
+    /** Deletes a slot; idempotent. */
+    delete(slotId: string): Promise<void>;
+}
+/** One migration step: the payload of `from` → the payload of `to` (`to` > `from`). Pure; must not mutate its input. */
+export interface DyFM_GameSave_MigrationStep {
+    from: number;
+    to: number;
+    migrate: (payload: unknown) => unknown;
+}
+/** Why a parse / migration failed — a stable code for the game's UI and telemetry. */
+export type DyFM_GameSave_Failure_Type = 'not-an-object' | 'unknown-format' | 'invalid-field' | 'checksum-mismatch' | 'future-version' | 'missing-step' | 'invalid-step' | 'step-failed';
+/** The result of `parse` / `migrate`. */
+export type DyFM_GameSave_Result<TPayload = unknown> = {
+    ok: true;
+    envelope: DyFM_GameSave_Envelope<TPayload>;
+    appliedSteps: string[];
+} | {
+    ok: false;
+    code: DyFM_GameSave_Failure_Type;
+    message: string;
+    appliedSteps: string[];
+};
+/** The deterministic conflict decision (the game maps `ask-user` to its conflict dialog). */
+export type DyFM_GameSave_ConflictDecision_Type = 'in-sync' | 'use-local' | 'use-remote' | 'ask-user' | 'none';
+/** The decision + why (for logs and the dialog). */
+export interface DyFM_GameSave_ConflictResult {
+    decision: DyFM_GameSave_ConflictDecision_Type;
+    reason: string;
+}
+//# sourceMappingURL=game-save.interface.d.ts.map

package/build/_modules/game/_models/game-save.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-save.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/game-save.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8EAA8E;AAC9E,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;AAE3D,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,yBAAyB,CAAC;IAClC,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,0GAA0G;IAC1G,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kDAAkD;AAClD,MAAM,WAAW,sBAAsB,CAAC,QAAQ,GAAG,OAAO,CAAE,SAAQ,sBAAsB;IACxF,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED,mGAAmG;AACnG,MAAM,WAAW,uBAAuB,CAAC,QAAQ,GAAG,OAAO;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,QAAQ,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yGAAyG;AACzG,MAAM,WAAW,+BAA+B,CAAC,QAAQ,GAAG,OAAO;IACjE,oCAAoC;IACpC,KAAK,CAAC,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,uGAAuG;IACvG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,kGAAkG;IAClG,IAAI,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC1C,kCAAkC;IAClC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,wHAAwH;AACxH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;CACxC;AAED,sFAAsF;AACtF,MAAM,MAAM,0BAA0B,GAClC,eAAe,GAAG,gBAAgB,GAAG,eAAe,GAAG,mBAAmB,GAC1E,gBAAgB,GAAG,cAAc,GAAG,cAAc,GAAG,aAAa,CAAC;AAEvE,yCAAyC;AACzC,MAAM,MAAM,oBAAoB,CAAC,QAAQ,GAAG,OAAO,IAC/C;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,GAChF;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,0BAA0B,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE7F,6FAA6F;AAC7F,MAAM,MAAM,mCAAmC,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;AAE/G,oDAAoD;AACpD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,mCAAmC,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/build/_modules/game/_models/game-save.interface.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * BFR-WARFACTORY-011 — headless game-save contracts. No provider credential, platform binding or game payload shape
+ * lives here: the payload is opaque (`TPayload`, typically the serialized game state), adapters are the game's.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=game-save.interface.js.map

package/build/_modules/game/_models/game-save.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-save.interface.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/game-save.interface.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/build/_modules/game/_models/simulation-clock.control-model.d.ts

@@ -0,0 +1,39 @@
+import { DyFM_SimulationClock_AdvanceInput, DyFM_SimulationClock_AdvanceResult, DyFM_SimulationClock_Config, DyFM_SimulationClock_State } from './simulation-clock.interface';
+/**
+ * BFR-WARFACTORY-010 — framework-independent, monotonic simulation clock.
+ *
+ * - The CALLER supplies real delta, speed and pause; the clock never reads wall time (deterministic, replayable).
+ * - Fixed-step mode (`fixedStepSeconds`): scaled time goes into an accumulator, whole steps are committed and the
+ *   remainder carries over — at speed 10 the loop runs ten times as many steps of the same size, so fast-forward is
+ *   behaviour-neutral. Variable mode (no `fixedStepSeconds`): one step of `realDelta * speed` (not neutral).
+ * - Real deltas are clamped (`maxRealDeltaSeconds`) and fixed steps capped (`maxStepsPerAdvance`); what is cut or
+ *   dropped is reported, never silently lost.
+ * - `exportState` / `importState` (versioned; the legacy `{ elapsedSimulationSeconds }` shape is accepted) / `reset`.
+ *   An invalid snapshot is rejected WITHOUT touching the running clock.
+ */
+export declare class DyFM_SimulationClock_ControlModel {
+    private readonly fixedStepSeconds;
+    private readonly maxRealDeltaSeconds;
+    private readonly maxStepsPerAdvance;
+    private elapsedSeconds;
+    private accumulatorSeconds;
+    /** Creates the clock; an invalid configuration throws (`DYFM-SIM-CLOCK-CONFIG`). */
+    constructor(config?: DyFM_SimulationClock_Config);
+    /** Total committed simulation seconds. */
+    now(): number;
+    /** Advances by one real frame. Paused, speed ≤ 0 or a non-finite input ⇒ nothing passes (a zero result). */
+    advance(input: DyFM_SimulationClock_AdvanceInput): DyFM_SimulationClock_AdvanceResult;
+    /** The save/load snapshot. */
+    exportState(): DyFM_SimulationClock_State;
+    /**
+     * Restores a snapshot; returns `false` (and changes NOTHING) when it is invalid. Accepts the legacy
+     * `{ elapsedSimulationSeconds }` shape (no `schemaVersion`) as an empty accumulator.
+     */
+    importState(snapshot: unknown): boolean;
+    /** A new run: zero elapsed time and accumulator. */
+    reset(): void;
+    private static isNonNegative;
+    private static positive;
+    private static configError;
+}
+//# sourceMappingURL=simulation-clock.control-model.d.ts.map

package/build/_modules/game/_models/simulation-clock.control-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulation-clock.control-model.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/simulation-clock.control-model.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iCAAiC,EACjC,kCAAkC,EAClC,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,qBAAa,iCAAiC;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IACtD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,kBAAkB,CAAa;IAEvC,oFAAoF;gBACxE,MAAM,GAAE,2BAAgC;IAcpD,0CAA0C;IAC1C,GAAG,IAAI,MAAM;IAIb,4GAA4G;IAC5G,OAAO,CAAC,KAAK,EAAE,iCAAiC,GAAG,kCAAkC;IA4CrF,8BAA8B;IAC9B,WAAW,IAAI,0BAA0B;IAIzC;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO;IAoBvC,oDAAoD;IACpD,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,MAAM,CAAC,aAAa;IAI5B,OAAO,CAAC,MAAM,CAAC,QAAQ;IAQvB,OAAO,CAAC,MAAM,CAAC,WAAW;CAO3B"}

package/build/_modules/game/_models/simulation-clock.control-model.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_SimulationClock_ControlModel = void 0;
+const error_control_model_1 = require("../../../_models/control-models/error.control-model");
+/**
+ * BFR-WARFACTORY-010 — framework-independent, monotonic simulation clock.
+ *
+ * - The CALLER supplies real delta, speed and pause; the clock never reads wall time (deterministic, replayable).
+ * - Fixed-step mode (`fixedStepSeconds`): scaled time goes into an accumulator, whole steps are committed and the
+ *   remainder carries over — at speed 10 the loop runs ten times as many steps of the same size, so fast-forward is
+ *   behaviour-neutral. Variable mode (no `fixedStepSeconds`): one step of `realDelta * speed` (not neutral).
+ * - Real deltas are clamped (`maxRealDeltaSeconds`) and fixed steps capped (`maxStepsPerAdvance`); what is cut or
+ *   dropped is reported, never silently lost.
+ * - `exportState` / `importState` (versioned; the legacy `{ elapsedSimulationSeconds }` shape is accepted) / `reset`.
+ *   An invalid snapshot is rejected WITHOUT touching the running clock.
+ */
+class DyFM_SimulationClock_ControlModel {
+    fixedStepSeconds;
+    maxRealDeltaSeconds;
+    maxStepsPerAdvance;
+    elapsedSeconds = 0;
+    accumulatorSeconds = 0;
+    /** Creates the clock; an invalid configuration throws (`DYFM-SIM-CLOCK-CONFIG`). */
+    constructor(config = {}) {
+        this.fixedStepSeconds = config.fixedStepSeconds === undefined
+            ? undefined
+            : DyFM_SimulationClock_ControlModel.positive(config.fixedStepSeconds, 'fixedStepSeconds');
+        this.maxRealDeltaSeconds =
+            DyFM_SimulationClock_ControlModel.positive(config.maxRealDeltaSeconds ?? 0.25, 'maxRealDeltaSeconds');
+        this.maxStepsPerAdvance = DyFM_SimulationClock_ControlModel.positive(config.maxStepsPerAdvance ?? 240, 'maxStepsPerAdvance');
+        if (!Number.isInteger(this.maxStepsPerAdvance)) {
+            throw DyFM_SimulationClock_ControlModel.configError('maxStepsPerAdvance must be an integer');
+        }
+    }
+    /** Total committed simulation seconds. */
+    now() {
+        return this.elapsedSeconds;
+    }
+    /** Advances by one real frame. Paused, speed ≤ 0 or a non-finite input ⇒ nothing passes (a zero result). */
+    advance(input) {
+        const idle = {
+            simulationDeltaSeconds: 0, steps: 0, stepSeconds: this.fixedStepSeconds ?? 0,
+            clampedRealSeconds: 0, droppedSimulationSeconds: 0,
+        };
+        if (input.paused || !Number.isFinite(input.realDeltaSeconds) || !Number.isFinite(input.speed)
+            || input.speed <= 0 || input.realDeltaSeconds <= 0) {
+            return idle;
+        }
+        const realSeconds = Math.min(input.realDeltaSeconds, this.maxRealDeltaSeconds);
+        const clampedRealSeconds = input.realDeltaSeconds - realSeconds;
+        const scaledSeconds = realSeconds * input.speed;
+        if (this.fixedStepSeconds === undefined) {
+            // Variable step: one update of the scaled delta (documented as NOT behaviour-neutral across speeds)
+            this.elapsedSeconds += scaledSeconds;
+            return {
+                simulationDeltaSeconds: scaledSeconds, steps: 1, stepSeconds: scaledSeconds,
+                clampedRealSeconds: clampedRealSeconds, droppedSimulationSeconds: 0,
+            };
+        }
+        // Fixed step: commit whole steps, carry the remainder, cap the burst (spiral-of-death guard)
+        this.accumulatorSeconds += scaledSeconds;
+        // the epsilon keeps 3 × (1/60) from rounding down to 2 steps
+        const available = Math.floor(this.accumulatorSeconds / this.fixedStepSeconds + 1e-9);
+        const steps = Math.min(available, this.maxStepsPerAdvance);
+        let droppedSimulationSeconds = 0;
+        this.accumulatorSeconds = Math.max(0, this.accumulatorSeconds - available * this.fixedStepSeconds);
+        if (available > steps) {
+            droppedSimulationSeconds = (available - steps) * this.fixedStepSeconds;
+        }
+        this.elapsedSeconds += steps * this.fixedStepSeconds;
+        return {
+            simulationDeltaSeconds: steps * this.fixedStepSeconds, steps: steps, stepSeconds: this.fixedStepSeconds,
+            clampedRealSeconds: clampedRealSeconds, droppedSimulationSeconds: droppedSimulationSeconds,
+        };
+    }
+    /** The save/load snapshot. */
+    exportState() {
+        return { schemaVersion: 1, elapsedSimulationSeconds: this.elapsedSeconds, accumulatorSeconds: this.accumulatorSeconds };
+    }
+    /**
+     * Restores a snapshot; returns `false` (and changes NOTHING) when it is invalid. Accepts the legacy
+     * `{ elapsedSimulationSeconds }` shape (no `schemaVersion`) as an empty accumulator.
+     */
+    importState(snapshot) {
+        if (!snapshot || typeof snapshot !== 'object') {
+            return false;
+        }
+        const state = snapshot;
+        const accumulator = state.schemaVersion === undefined ? 0 : state.accumulatorSeconds;
+        if ((state.schemaVersion !== undefined && state.schemaVersion !== 1)
+            || !DyFM_SimulationClock_ControlModel.isNonNegative(state.elapsedSimulationSeconds)
+            || !DyFM_SimulationClock_ControlModel.isNonNegative(accumulator)) {
+            return false;
+        }
+        this.elapsedSeconds = state.elapsedSimulationSeconds;
+        this.accumulatorSeconds = accumulator;
+        return true;
+    }
+    /** A new run: zero elapsed time and accumulator. */
+    reset() {
+        this.elapsedSeconds = 0;
+        this.accumulatorSeconds = 0;
+    }
+    static isNonNegative(value) {
+        return typeof value === 'number' && Number.isFinite(value) && value >= 0;
+    }
+    static positive(value, field) {
+        if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
+            throw DyFM_SimulationClock_ControlModel.configError(`${field} must be a finite number > 0 (got ${value})`);
+        }
+        return value;
+    }
+    static configError(message) {
+        return new error_control_model_1.DyFM_Error({
+            message: `DyFM_SimulationClock: ${message}`,
+            errorCode: 'DYFM-SIM-CLOCK-CONFIG',
+            issuerService: 'DyFM_SimulationClock_ControlModel',
+        });
+    }
+}
+exports.DyFM_SimulationClock_ControlModel = DyFM_SimulationClock_ControlModel;
+//# sourceMappingURL=simulation-clock.control-model.js.map

package/build/_modules/game/_models/simulation-clock.control-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulation-clock.control-model.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/simulation-clock.control-model.ts"],"names":[],"mappings":"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"}

package/build/_modules/game/_models/simulation-clock.interface.d.ts

@@ -0,0 +1,44 @@
+/** BFR-WARFACTORY-010 — `DyFM_SimulationClock_ControlModel` configuration. */
+export interface DyFM_SimulationClock_Config {
+    /**
+     * Fixed simulation step in seconds (e.g. `1 / 60`). When set, `advance` accumulates scaled time and returns how many
+     * fixed steps to run — fast-forward then runs MORE steps of the SAME size, so gameplay is behaviour-neutral across
+     * speeds. When unset, one variable step of `realDelta * speed` is returned (NOT behaviour-neutral across speeds).
+     */
+    fixedStepSeconds?: number;
+    /** Real-delta clamp in seconds (a tab switch / breakpoint must not become one giant step). Default: `0.25`. */
+    maxRealDeltaSeconds?: number;
+    /** Fixed mode: at most this many steps per `advance`; the excess is DROPPED and reported. Default: `240`. */
+    maxStepsPerAdvance?: number;
+}
+/** BFR-WARFACTORY-010 — the input of one `advance` (the caller owns real time, speed and pause). */
+export interface DyFM_SimulationClock_AdvanceInput {
+    /** Real (wall) seconds since the previous frame — measured by the caller; the clock never reads wall time. */
+    realDeltaSeconds: number;
+    /** Simulation speed multiplier (`0` = stopped). The UI's speed choices stay the caller's. */
+    speed: number;
+    /** Paused ⇒ no simulation time passes. */
+    paused: boolean;
+}
+/** BFR-WARFACTORY-010 — what one `advance` produced. */
+export interface DyFM_SimulationClock_AdvanceResult {
+    /** Simulation seconds committed by this call (`steps * stepSeconds`). */
+    simulationDeltaSeconds: number;
+    /** How many simulation updates to run now (fixed mode: 0..maxStepsPerAdvance; variable mode: 0 or 1). */
+    steps: number;
+    /** The size of each step in seconds. */
+    stepSeconds: number;
+    /** Real seconds cut off by `maxRealDeltaSeconds`. */
+    clampedRealSeconds: number;
+    /** Simulation seconds dropped by `maxStepsPerAdvance` (fixed mode). */
+    droppedSimulationSeconds: number;
+}
+/** BFR-WARFACTORY-010 — the save/load snapshot (versioned). */
+export interface DyFM_SimulationClock_State {
+    schemaVersion: 1;
+    /** Total committed simulation seconds. */
+    elapsedSimulationSeconds: number;
+    /** Fixed mode: scaled time not yet committed to a step (carried over, so no time is lost between frames). */
+    accumulatorSeconds: number;
+}
+//# sourceMappingURL=simulation-clock.interface.d.ts.map

package/build/_modules/game/_models/simulation-clock.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulation-clock.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/simulation-clock.interface.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+GAA+G;IAC/G,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6GAA6G;IAC7G,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,oGAAoG;AACpG,MAAM,WAAW,iCAAiC;IAChD,8GAA8G;IAC9G,gBAAgB,EAAE,MAAM,CAAC;IACzB,6FAA6F;IAC7F,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wDAAwD;AACxD,MAAM,WAAW,kCAAkC;IACjD,yEAAyE;IACzE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yGAAyG;IACzG,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,+DAA+D;AAC/D,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,CAAC,CAAC;IACjB,0CAA0C;IAC1C,wBAAwB,EAAE,MAAM,CAAC;IACjC,6GAA6G;IAC7G,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}

package/build/_modules/game/_models/simulation-clock.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=simulation-clock.interface.js.map

package/build/_modules/game/_models/simulation-clock.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulation-clock.interface.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/simulation-clock.interface.ts"],"names":[],"mappings":""}

package/build/_modules/game/_models/work-order-scheduler.control-model.d.ts

@@ -0,0 +1,55 @@
+import { DyFM_WorkOrder_State, DyFM_WorkOrderScheduler_AdvanceResult, DyFM_WorkOrderScheduler_CancelResult, DyFM_WorkOrderScheduler_Config, DyFM_WorkOrderScheduler_HealReport, DyFM_WorkOrderScheduler_State } from './work-order-scheduler.interface';
+/**
+ * BFR-WARFACTORY-012 — headless, cancel-safe scheduler of interchangeable workers over parallel work orders.
+ *
+ * Guarantees (each pinned by a spec):
+ * - **Release is structural, not a happy-path step:** an assignment exists only as `worker → order`; cancelling an
+ *   order, completing it or removing (destroying) a worker deletes the entry in the same call ⇒ no stranded worker.
+ * - **Every pending order gets ≥ 1 worker when possible:** idle workers first; if none is idle, one is moved from the
+ *   order that has the most (only from an order with > 1) — so one plan cannot starve the others ("frozen" plans).
+ * - **Stable least-assigned distribution:** extra workers go to the order with the fewest (tie → the earliest order);
+ *   existing assignments are not reshuffled.
+ * - **Self-healing import:** stale ownership (unknown worker / order, duplicates) is dropped and REPORTED; importing
+ *   the same state twice gives the same result.
+ * No clock, no RNG: time comes in through `advance(simulationSeconds)` (e.g. from `DyFM_SimulationClock_ControlModel`).
+ */
+export declare class DyFM_WorkOrderScheduler_ControlModel {
+    private readonly rate;
+    private orders;
+    private workerIds;
+    /** workerId → orderId (the ONLY ownership record). */
+    private assignments;
+    /** Creates the scheduler; an invalid rate throws `DYFM-WORK-ORDER-CONFIG`. */
+    constructor(config?: DyFM_WorkOrderScheduler_Config);
+    /** Adds a work order at the end of the FIFO; a duplicate id or non-positive work throws `DYFM-WORK-ORDER-INVALID`. */
+    addOrder(order: {
+        orderId: string;
+        work: number;
+        progress?: number;
+    }): void;
+    /** Adds an (idle) worker; duplicates are ignored. */
+    addWorker(workerId: string): void;
+    /** Removes (destroys) a worker; its assignment goes with it. Idempotent. */
+    removeWorker(workerId: string): void;
+    /** Cancels an order: removes it and releases its workers in the same call. Idempotent (unknown → found: false). */
+    cancel(orderId: string): DyFM_WorkOrderScheduler_CancelResult;
+    /** Advances every order by its workers × rate × seconds; completed orders leave and free their workers. */
+    advance(simulationSeconds: number): DyFM_WorkOrderScheduler_AdvanceResult;
+    /** The workers of an order, in assignment order. */
+    workersOf(orderId: string): string[];
+    /** The order a worker is on (`undefined` = idle). */
+    orderOf(workerId: string): string | undefined;
+    /** Current orders (copies, FIFO). */
+    getOrders(): DyFM_WorkOrder_State[];
+    /** The save/load snapshot. */
+    exportState(): DyFM_WorkOrderScheduler_State;
+    /**
+     * Restores a snapshot and HEALS stale ownership (assignments to unknown workers / orders, duplicates): dropped and
+     * reported, then the distribution rules re-apply. An unreadable snapshot throws `DYFM-WORK-ORDER-STATE`.
+     */
+    importState(state: DyFM_WorkOrderScheduler_State): DyFM_WorkOrderScheduler_HealReport;
+    /** Applies the distribution rules (stable: existing valid assignments are kept). */
+    private rebalance;
+    private static error;
+}
+//# sourceMappingURL=work-order-scheduler.control-model.d.ts.map

package/build/_modules/game/_models/work-order-scheduler.control-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-order-scheduler.control-model.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/work-order-scheduler.control-model.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,qCAAqC,EACrC,oCAAoC,EACpC,8BAA8B,EAC9B,kCAAkC,EAClC,6BAA6B,EAC9B,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,qBAAa,oCAAoC;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,SAAS,CAAgB;IACjC,sDAAsD;IACtD,OAAO,CAAC,WAAW,CAAkC;IAErD,8EAA8E;gBAClE,MAAM,GAAE,8BAAmC;IASvD,sHAAsH;IACtH,QAAQ,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAU3E,qDAAqD;IACrD,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOjC,4EAA4E;IAC5E,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMpC,mHAAmH;IACnH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,oCAAoC;IAgB7D,2GAA2G;IAC3G,OAAO,CAAC,iBAAiB,EAAE,MAAM,GAAG,qCAAqC;IA0BzE,oDAAoD;IACpD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAKpC,qDAAqD;IACrD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI7C,qCAAqC;IACrC,SAAS,IAAI,oBAAoB,EAAE;IAInC,8BAA8B;IAC9B,WAAW,IAAI,6BAA6B;IAS5C;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,6BAA6B,GAAG,kCAAkC;IAmDrF,oFAAoF;IACpF,OAAO,CAAC,SAAS;IA0CjB,OAAO,CAAC,MAAM,CAAC,KAAK;CAOrB"}

package/build/_modules/game/_models/work-order-scheduler.control-model.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_WorkOrderScheduler_ControlModel = void 0;
+const error_control_model_1 = require("../../../_models/control-models/error.control-model");
+/**
+ * BFR-WARFACTORY-012 — headless, cancel-safe scheduler of interchangeable workers over parallel work orders.
+ *
+ * Guarantees (each pinned by a spec):
+ * - **Release is structural, not a happy-path step:** an assignment exists only as `worker → order`; cancelling an
+ *   order, completing it or removing (destroying) a worker deletes the entry in the same call ⇒ no stranded worker.
+ * - **Every pending order gets ≥ 1 worker when possible:** idle workers first; if none is idle, one is moved from the
+ *   order that has the most (only from an order with > 1) — so one plan cannot starve the others ("frozen" plans).
+ * - **Stable least-assigned distribution:** extra workers go to the order with the fewest (tie → the earliest order);
+ *   existing assignments are not reshuffled.
+ * - **Self-healing import:** stale ownership (unknown worker / order, duplicates) is dropped and REPORTED; importing
+ *   the same state twice gives the same result.
+ * No clock, no RNG: time comes in through `advance(simulationSeconds)` (e.g. from `DyFM_SimulationClock_ControlModel`).
+ */
+class DyFM_WorkOrderScheduler_ControlModel {
+    rate;
+    orders = [];
+    workerIds = [];
+    /** workerId → orderId (the ONLY ownership record). */
+    assignments = new Map();
+    /** Creates the scheduler; an invalid rate throws `DYFM-WORK-ORDER-CONFIG`. */
+    constructor(config = {}) {
+        const rate = config.workPerWorkerPerSecond ?? 1;
+        if (!Number.isFinite(rate) || rate <= 0) {
+            throw DyFM_WorkOrderScheduler_ControlModel.error('DYFM-WORK-ORDER-CONFIG', `workPerWorkerPerSecond must be > 0 (${rate})`);
+        }
+        this.rate = rate;
+    }
+    /** Adds a work order at the end of the FIFO; a duplicate id or non-positive work throws `DYFM-WORK-ORDER-INVALID`. */
+    addOrder(order) {
+        if (!order?.orderId || this.orders.some((o) => o.orderId === order.orderId)
+            || !Number.isFinite(order.work) || order.work <= 0) {
+            throw DyFM_WorkOrderScheduler_ControlModel.error('DYFM-WORK-ORDER-INVALID', `order needs a unique orderId and work > 0 (${order?.orderId})`);
+        }
+        this.orders.push({ orderId: order.orderId, work: order.work, progress: Math.max(0, order.progress ?? 0) });
+        this.rebalance();
+    }
+    /** Adds an (idle) worker; duplicates are ignored. */
+    addWorker(workerId) {
+        if (workerId && !this.workerIds.includes(workerId)) {
+            this.workerIds.push(workerId);
+            this.rebalance();
+        }
+    }
+    /** Removes (destroys) a worker; its assignment goes with it. Idempotent. */
+    removeWorker(workerId) {
+        this.workerIds = this.workerIds.filter((id) => id !== workerId);
+        this.assignments.delete(workerId);
+        this.rebalance();
+    }
+    /** Cancels an order: removes it and releases its workers in the same call. Idempotent (unknown → found: false). */
+    cancel(orderId) {
+        const order = this.orders.find((o) => o.orderId === orderId);
+        if (!order) {
+            return { found: false, releasedWorkerIds: [], progressRatio: 0 };
+        }
+        const released = this.workersOf(orderId);
+        this.orders = this.orders.filter((o) => o.orderId !== orderId);
+        released.forEach((workerId) => this.assignments.delete(workerId));
+        this.rebalance();
+        return { found: true, releasedWorkerIds: released, progressRatio: Math.min(1, order.progress / order.work) };
+    }
+    /** Advances every order by its workers × rate × seconds; completed orders leave and free their workers. */
+    advance(simulationSeconds) {
+        if (!Number.isFinite(simulationSeconds) || simulationSeconds <= 0) {
+            return { completedOrderIds: [] };
+        }
+        const completed = [];
+        for (const order of this.orders) {
+            order.progress += this.workersOf(order.orderId).length * this.rate * simulationSeconds;
+            if (order.progress >= order.work) {
+                completed.push(order.orderId);
+            }
+        }
+        if (completed.length) {
+            this.orders = this.orders.filter((o) => !completed.includes(o.orderId));
+            for (const [workerId, orderId] of [...this.assignments]) {
+                if (completed.includes(orderId)) {
+                    this.assignments.delete(workerId);
+                }
+            }
+            this.rebalance();
+        }
+        return { completedOrderIds: completed };
+    }
+    /** The workers of an order, in assignment order. */
+    workersOf(orderId) {
+        return [...this.assignments].filter(([, id]) => id === orderId)
+            .map(([workerId]) => workerId);
+    }
+    /** The order a worker is on (`undefined` = idle). */
+    orderOf(workerId) {
+        return this.assignments.get(workerId);
+    }
+    /** Current orders (copies, FIFO). */
+    getOrders() {
+        return this.orders.map((o) => ({ ...o }));
+    }
+    /** The save/load snapshot. */
+    exportState() {
+        return {
+            schemaVersion: 1,
+            orders: this.getOrders(),
+            workerIds: [...this.workerIds],
+            assignments: Object.fromEntries(this.assignments),
+        };
+    }
+    /**
+     * Restores a snapshot and HEALS stale ownership (assignments to unknown workers / orders, duplicates): dropped and
+     * reported, then the distribution rules re-apply. An unreadable snapshot throws `DYFM-WORK-ORDER-STATE`.
+     */
+    importState(state) {
+        if (!state || state.schemaVersion !== 1 || !Array.isArray(state.orders) || !Array.isArray(state.workerIds)
+            || !state.assignments || typeof state.assignments !== 'object') {
+            throw DyFM_WorkOrderScheduler_ControlModel.error('DYFM-WORK-ORDER-STATE', 'unreadable scheduler snapshot');
+        }
+        const report = { droppedUnknownWorkers: [], droppedUnknownOrders: [], skippedDuplicates: [] };
+        const orders = [];
+        for (const order of state.orders) {
+            if (!order?.orderId || orders.some((o) => o.orderId === order.orderId)
+                || !Number.isFinite(order.work) || order.work <= 0) {
+                report.skippedDuplicates.push(String(order?.orderId));
+                continue;
+            }
+            if (Number(order.progress) >= order.work) {
+                continue; // a completed order is not "active" — its assignments heal below
+            }
+            orders.push({ orderId: order.orderId, work: order.work, progress: Math.max(0, Number(order.progress) || 0) });
+        }
+        const workerIds = [];
+        for (const workerId of state.workerIds) {
+            if (!workerId || workerIds.includes(workerId)) {
+                report.skippedDuplicates.push(String(workerId));
+                continue;
+            }
+            workerIds.push(workerId);
+        }
+        const assignments = new Map();
+        for (const [workerId, orderId] of Object.entries(state.assignments)) {
+            if (!workerIds.includes(workerId)) {
+                report.droppedUnknownWorkers.push(workerId);
+            }
+            else if (!orders.some((o) => o.orderId === orderId)) {
+                report.droppedUnknownOrders.push(`${workerId}→${orderId}`);
+            }
+            else {
+                assignments.set(workerId, orderId);
+            }
+        }
+        this.orders = orders;
+        this.workerIds = workerIds;
+        this.assignments = assignments;
+        this.rebalance();
+        return report;
+    }
+    /** Applies the distribution rules (stable: existing valid assignments are kept). */
+    rebalance() {
+        const count = (orderId) => this.workersOf(orderId).length;
+        const idle = () => this.workerIds.filter((id) => !this.assignments.has(id));
+        // 1) every order without a worker gets one: an idle worker, else one moved from the richest order (> 1)
+        for (const order of this.orders) {
+            if (count(order.orderId) > 0) {
+                continue;
+            }
+            const free = idle()[0];
+            if (free) {
+                this.assignments.set(free, order.orderId);
+                continue;
+            }
+            const donor = [...this.orders]
+                .filter((o) => count(o.orderId) > 1)
+                .sort((a, b) => count(b.orderId) - count(a.orderId) || this.orders.indexOf(b) - this.orders.indexOf(a))[0];
+            if (donor) {
+                const moved = this.workersOf(donor.orderId).slice(-1)[0];
+                this.assignments.set(moved, order.orderId);
+            }
+        }
+        // 2) the remaining idle workers go to the least-assigned order (tie → the earliest)
+        for (const workerId of idle()) {
+            const target = [...this.orders]
+                .sort((a, b) => count(a.orderId) - count(b.orderId) || this.orders.indexOf(a) - this.orders.indexOf(b))[0];
+            if (!target) {
+                return;
+            }
+            this.assignments.set(workerId, target.orderId);
+        }
+    }
+    static error(code, message) {
+        return new error_control_model_1.DyFM_Error({
+            message: `DyFM_WorkOrderScheduler: ${message}`,
+            errorCode: code,
+            issuerService: 'DyFM_WorkOrderScheduler_ControlModel',
+        });
+    }
+}
+exports.DyFM_WorkOrderScheduler_ControlModel = DyFM_WorkOrderScheduler_ControlModel;
+//# sourceMappingURL=work-order-scheduler.control-model.js.map

package/build/_modules/game/_models/work-order-scheduler.control-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-order-scheduler.control-model.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/work-order-scheduler.control-model.ts"],"names":[],"mappings":"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"}