@insiderfinance/totalfinance 0.1.0

package/modules/core/dist/artifacts/migration.js

@@ -0,0 +1,106 @@
+/**
+ * Explicit schema migration for spine envelopes (Gate B).
+ *
+ * The version policy every reader shares:
+ *
+ * - an envelope whose `schemaVersion` MATCHES the build restores directly;
+ * - a NEWER envelope is refused — this build cannot know what changed, and restoring it anyway
+ *   would silently misread state (the TA snapshot reader's law, applied spine-wide);
+ * - an OLDER envelope restores ONLY through an explicitly registered migration chain. There is no
+ *   silent upgrade: a migration is a named function with a stated reason, each step raises the
+ *   version by exactly one, and every applied step is reported back to the caller.
+ *
+ * The registry is an ARGUMENT to the readers, never module-global state — a hidden process-wide
+ * registry is exactly the "result depends on hidden process state" failure the artifact spine
+ * exists to make impossible (roadmap Program 11 exit gate).
+ */
+import { ErrorCode, InputError } from '../errors.js';
+import { ensureKnownKeys, requireArgumentObject } from '../invariants.js';
+const MIGRATION_KEYS = ['kind', 'fromVersion', 'toVersion', 'description', 'migrate'];
+function requireVersionInteger(functionName, field, value) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0) {
+        throw new InputError(`${functionName}: ${field} must be a non-negative integer schema version. Received ${typeof value === 'number' ? value : value === null ? 'null' : typeof value}.`, { code: ErrorCode.InputOutOfRange, context: { function: functionName, field } });
+    }
+    return value;
+}
+/** Create an empty, caller-owned migration registry. */
+export function createArtifactMigrationRegistry() {
+    const steps = new Map();
+    const keyOf = (kind, fromVersion) => `${kind}@${fromVersion}`;
+    const register = (migration) => {
+        requireArgumentObject('register', 'migration', migration);
+        ensureKnownKeys('register', 'migration', migration, MIGRATION_KEYS);
+        const { kind, description, migrate } = migration;
+        if (typeof kind !== 'string' || kind.length === 0) {
+            throw new InputError(`register: migration.kind must be the envelope kind string it migrates, e.g. 'totalfinance.market-snapshot'.`, { code: ErrorCode.InputWrongType, context: { field: 'kind' } });
+        }
+        const fromVersion = requireVersionInteger('register', 'migration.fromVersion', migration.fromVersion);
+        const toVersion = requireVersionInteger('register', 'migration.toVersion', migration.toVersion);
+        if (toVersion !== fromVersion + 1) {
+            throw new InputError(`register: migration.toVersion must be fromVersion + 1 (got ${fromVersion} → ${toVersion}). ` +
+                `Chains are single steps so each shape change stays individually reviewable.`, { code: ErrorCode.InputOutOfRange, context: { fromVersion, toVersion } });
+        }
+        if (typeof description !== 'string' || description.length === 0) {
+            throw new InputError(`register: migration.description must state why the schema changed — it is echoed to every caller the migration touches.`, { code: ErrorCode.InputWrongType, context: { field: 'description' } });
+        }
+        if (typeof migrate !== 'function') {
+            throw new InputError(`register: migration.migrate must be a function (envelope) => envelope.`, {
+                code: ErrorCode.InputWrongType,
+                context: { field: 'migrate' },
+            });
+        }
+        const key = keyOf(kind, fromVersion);
+        if (steps.has(key)) {
+            throw new InputError(`register: a migration for ${kind} version ${fromVersion} → ${fromVersion + 1} is already registered — ` +
+                `two upgrades for one stored shape cannot both be the truth.`, { code: ErrorCode.ArtifactDuplicateMigration, context: { kind, fromVersion } });
+        }
+        steps.set(key, migration);
+    };
+    const find = (kind, fromVersion) => steps.get(keyOf(kind, fromVersion));
+    const upgrade = (input) => {
+        requireArgumentObject('upgrade', 'input', input);
+        ensureKnownKeys('upgrade', 'input', input, ['envelope', 'targetVersion']);
+        requireArgumentObject('upgrade', 'input.envelope', input.envelope);
+        const targetVersion = requireVersionInteger('upgrade', 'input.targetVersion', input.targetVersion);
+        let envelope = input.envelope;
+        const kind = envelope['kind'];
+        if (typeof kind !== 'string' || kind.length === 0) {
+            throw new InputError(`upgrade: input.envelope.kind must be the envelope's kind string.`, {
+                code: ErrorCode.SnapshotWrongShape,
+                context: { received: kind === null ? 'null' : typeof kind },
+            });
+        }
+        let version = requireVersionInteger('upgrade', 'input.envelope.schemaVersion', envelope['schemaVersion']);
+        const migrationsApplied = [];
+        while (version < targetVersion) {
+            const step = find(kind, version);
+            if (step === undefined) {
+                throw new InputError(`upgrade: no migration is registered for ${kind} version ${version} → ${version + 1} ` +
+                    `(stored ${envelope['schemaVersion'] === version ? version : `${String(envelope['schemaVersion'])}, currently at ${version}`}, this build reads ${targetVersion}). ` +
+                    `Schema upgrades are explicit: register the missing step with registry.register(...) — nothing is migrated silently.`, {
+                    code: ErrorCode.ArtifactMigrationMissing,
+                    context: { kind, fromVersion: version, targetVersion },
+                });
+            }
+            envelope = step.migrate(envelope);
+            requireArgumentObject('upgrade', `migrated envelope (${kind} v${version} → v${version + 1})`, envelope);
+            const migratedVersion = envelope['schemaVersion'];
+            if (migratedVersion !== version + 1) {
+                throw new InputError(`upgrade: the ${kind} v${version} → v${version + 1} migration returned schemaVersion ${String(migratedVersion)} — a migration must stamp exactly the version it declares.`, {
+                    code: ErrorCode.SnapshotInvalidVersion,
+                    context: { kind, fromVersion: version, returned: migratedVersion },
+                });
+            }
+            migrationsApplied.push({
+                kind,
+                fromVersion: version,
+                toVersion: version + 1,
+                description: step.description,
+            });
+            version += 1;
+        }
+        return { envelope, migrationsApplied };
+    };
+    return { register, find, upgrade };
+}
+//# sourceMappingURL=migration.js.map

package/modules/core/dist/artifacts/migration.js.map

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

package/modules/core/dist/artifacts/numeric-comparison.d.ts

@@ -0,0 +1,12 @@
+import type { ComparisonTolerance } from './comparison.js';
+/** Shared finite-number comparison: exact tolerance decisions, rounded finite-or-null deltas. */
+export declare function compareFiniteNumbers(input: {
+    baseline: number;
+    candidate: number;
+    tolerance: ComparisonTolerance | null;
+}): {
+    absoluteDelta: number | null;
+    relativeDelta: number | null;
+    withinTolerance: boolean | null;
+};
+//# sourceMappingURL=numeric-comparison.d.ts.map

package/modules/core/dist/artifacts/numeric-comparison.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numeric-comparison.d.ts","sourceRoot":"","sources":["../../src/artifacts/numeric-comparison.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AA4C3D,iGAAiG;AACjG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACvC,GAAG;IACF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;CACjC,CAiBA"}

package/modules/core/dist/artifacts/numeric-comparison.js

@@ -0,0 +1,53 @@
+const FLOAT_BITS = new DataView(new ArrayBuffer(8));
+const FRACTION_MASK = (1n << 52n) - 1n;
+/** Every finite binary64 is an exact integer multiple of 2^-1074, including subnormals. */
+function integerUnits(value) {
+    FLOAT_BITS.setFloat64(0, value);
+    const bits = FLOAT_BITS.getBigUint64(0);
+    const exponent = Number((bits >> 52n) & 0x7ffn);
+    const fraction = bits & FRACTION_MASK;
+    const magnitude = exponent === 0 ? fraction : ((1n << 52n) | fraction) << BigInt(exponent - 1);
+    return bits >> 63n === 0n ? magnitude : -magnitude;
+}
+function magnitude(value) {
+    return value < 0n ? -value : value;
+}
+/**
+ * Exact inequality on the supplied IEEE values, not their rounded subtraction/product/sum.
+ * Multiply both sides by 2^2148 to compare integer units, including the tolerance product.
+ * The largest intermediate is bounded by binary64's exponent range (under 4,200 bits).
+ * Equality and zero tolerance have exact cheap paths; all other cases use this same rule,
+ * avoiding an epsilon heuristic or an unproven "far enough from the boundary" fast path.
+ */
+function exactWithinTolerance(input) {
+    const { baseline, candidate, tolerance } = input;
+    if (baseline === candidate)
+        return true;
+    if (tolerance.absolute === 0 && tolerance.relative === 0)
+        return false;
+    const baselineUnits = integerUnits(baseline);
+    const differenceUnits = magnitude(integerUnits(candidate) - baselineUnits);
+    const absoluteUnits = integerUnits(tolerance.absolute);
+    if (tolerance.relative === 0)
+        return differenceUnits <= absoluteUnits;
+    return (differenceUnits << 1074n <=
+        (absoluteUnits << 1074n) + integerUnits(tolerance.relative) * magnitude(baselineUnits));
+}
+/** Shared finite-number comparison: exact tolerance decisions, rounded finite-or-null deltas. */
+export function compareFiniteNumbers(input) {
+    const { baseline, candidate, tolerance } = input;
+    const difference = candidate - baseline;
+    const scale = Math.max(Math.abs(baseline), Math.abs(candidate));
+    const relative = baseline === 0
+        ? null
+        : Number.isFinite(difference)
+            ? difference / Math.abs(baseline)
+            : (candidate / scale - baseline / scale) / (Math.abs(baseline) / scale);
+    const withinTolerance = tolerance === null ? null : exactWithinTolerance({ baseline, candidate, tolerance });
+    return {
+        absoluteDelta: Number.isFinite(difference) ? difference : null,
+        relativeDelta: relative !== null && Number.isFinite(relative) ? relative : null,
+        withinTolerance,
+    };
+}
+//# sourceMappingURL=numeric-comparison.js.map

package/modules/core/dist/artifacts/numeric-comparison.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numeric-comparison.js","sourceRoot":"","sources":["../../src/artifacts/numeric-comparison.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,IAAI,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,MAAM,aAAa,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;AAEvC,2FAA2F;AAC3F,SAAS,YAAY,CAAC,KAAa;IACjC,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,GAAG,aAAa,CAAC;IACtC,MAAM,SAAS,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC/F,OAAO,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,SAAS,oBAAoB,CAAC,KAI7B;IACC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IACjD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,SAAS,CAAC,QAAQ,KAAK,CAAC,IAAI,SAAS,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvE,MAAM,aAAa,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,aAAa,CAAC,CAAC;IAC3E,MAAM,aAAa,GAAG,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACvD,IAAI,SAAS,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO,eAAe,IAAI,aAAa,CAAC;IACtE,OAAO,CACL,eAAe,IAAI,KAAK;QACxB,CAAC,aAAa,IAAI,KAAK,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,aAAa,CAAC,CACvF,CAAC;AACJ,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,oBAAoB,CAAC,KAIpC;IAKC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IACjD,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAChE,MAAM,QAAQ,GACZ,QAAQ,KAAK,CAAC;QACZ,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC3B,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;YACjC,CAAC,CAAC,CAAC,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC;IAC9E,MAAM,eAAe,GACnB,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;IACvF,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;QAC9D,aAAa,EAAE,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;QAC/E,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/modules/core/dist/artifacts/scenario-set.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Serializable scenario sets (Gate B, ahead of Gate D's shared runner): named scenario
+ * DEFINITIONS — shocks and overrides over a market snapshot — as pure data one runner can later
+ * apply across domains. Deliberately NOT a DSL: no expressions, no conditionals, no references —
+ * a scenario is a list of typed records, and anything a list of records cannot say belongs in
+ * caller code via the escape hatch (a custom reprice function), not in a language embedded here.
+ *
+ * The shock grammar is the one `@insiderfinance/totalfinance/risk` already speaks — `{ factor, kind: 'percent' |
+ * 'absolute', value }`, with the same factor vocabulary (`spot`, `volatility`, `riskFreeRate`,
+ * `time`, `dividend`, or a custom label) — extended with an optional `target` symbol so one
+ * scenario can shock AAPL and SPY differently. A spine shock without `target` is exactly a risk
+ * `Shock`, so Gate D's runner can hand these to the existing Taylor engine unchanged (no second
+ * vocabulary, no adapter tax).
+ *
+ * Semantics fixed here so every future runner agrees:
+ *
+ * - **overrides apply first**, setting an observation to an absolute value;
+ * - **shocks then apply in array order** (deterministic composition — `+10 pts` then `-5%` is not
+ *   `-5%` then `+10 pts`, and the data says which one is meant);
+ * - **two overrides for the same `(factor, target)` in one scenario are a CONFLICT** and are
+ *   refused at creation — the second absolute set would silently win;
+ * - repeated SHOCKS on one factor are legal: they compose, in order.
+ */
+import type { Provenance } from '../provenance.js';
+import type { AppliedMigration, ArtifactMigrationRegistry } from './migration.js';
+export declare const SCENARIO_SET_KIND = "totalfinance.scenario-set";
+/** Current scenario-set schema version — same bump-with-migration policy as the other envelopes. */
+export declare const SCENARIO_SET_SCHEMA_VERSION = 1;
+/** The factor vocabulary shared with `@insiderfinance/totalfinance/risk`'s scenario engine; open for custom labels. */
+export type ScenarioFactor = 'spot' | 'volatility' | 'riskFreeRate' | 'time' | 'dividend' | string;
+/** A relative change: `percent` scales the base level; `absolute` adds in the factor's own unit. */
+export interface ScenarioShock {
+    factor: ScenarioFactor;
+    kind: 'percent' | 'absolute';
+    value: number;
+    /** Which symbol the shock hits; absent = every target the runner prices with this factor. */
+    target?: string;
+}
+/** An absolute set: the observation for `(factor, target)` BECOMES `value` before shocks apply. */
+export interface ScenarioOverride {
+    factor: ScenarioFactor;
+    value: number;
+    target?: string;
+}
+export interface ScenarioDefinition {
+    /** Unique within the set — result cells trace back to scenarios by name. */
+    name: string;
+    shocks: ScenarioShock[];
+    overrides?: ScenarioOverride[];
+}
+export interface ScenarioSet {
+    kind: typeof SCENARIO_SET_KIND;
+    schemaVersion: number;
+    name: string;
+    scenarios: ScenarioDefinition[];
+    /** Where the definitions came from (a historical-event library, a desk doc) — caller-supplied. */
+    provenance?: Provenance;
+}
+/**
+ * Build an immutable, serializable scenario set.
+ *
+ * @example
+ * ```ts
+ * const stress = createScenarioSet({
+ *   name: 'q3-desk-stress',
+ *   scenarios: [
+ *     { name: 'crash -20%', shocks: [{ factor: 'spot', kind: 'percent', value: -0.20 },
+ *                                    { factor: 'volatility', kind: 'absolute', value: 0.15 }] },
+ *     { name: 'rates 2019', overrides: [{ factor: 'riskFreeRate', value: 0.0155 }], shocks: [] },
+ *   ],
+ * });
+ * ```
+ */
+export declare function createScenarioSet(input: {
+    name: string;
+    scenarios: ScenarioDefinition[];
+    provenance?: Provenance;
+}): ScenarioSet;
+/**
+ * Sound structural test for a CURRENT-version scenario-set envelope: the complete read-door
+ * validation behind a boolean door — `true` means `readScenarioSet` would accept the value
+ * unchanged, with no migrations. (An earlier version checked four fields, so
+ * `{ …, scenarios: [42] }` passed as `ScenarioSet` and detonated at first use.) Full-walk, not
+ * constant-time; call the read door when you also need the restored copy.
+ */
+export declare function isScenarioSet(value: unknown): value is ScenarioSet;
+/** Restore a stored scenario set, with the shared version/migration policy. */
+export declare function readScenarioSet(input: {
+    scenarioSet: unknown;
+    migrations?: ArtifactMigrationRegistry;
+}): {
+    scenarioSet: ScenarioSet;
+    migrationsApplied: AppliedMigration[];
+};
+/** Content identity for a scenario set: the canonical envelope WITHOUT `provenance`. */
+export declare function scenarioSetContentHash(scenarioSet: ScenarioSet): string;
+//# sourceMappingURL=scenario-set.d.ts.map

package/modules/core/dist/artifacts/scenario-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-set.d.ts","sourceRoot":"","sources":["../../src/artifacts/scenario-set.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAGlF,eAAO,MAAM,iBAAiB,8BAA8B,CAAC;AAE7D,oGAAoG;AACpG,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,uHAAuH;AACvH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,GAAG,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAEnG,oGAAoG;AACpG,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,mGAAmG;AACnG,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,iBAAiB,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,kGAAkG;IAClG,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AA6ID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,GAAG,WAAW,CAiBd;AA8CD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAQlE;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,yBAAyB,CAAC;CACxC,GAAG;IAAE,WAAW,EAAE,WAAW,CAAC;IAAC,iBAAiB,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAmDtE;AAED,wFAAwF;AACxF,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAYvE"}

package/modules/core/dist/artifacts/scenario-set.js

@@ -0,0 +1,249 @@
+/**
+ * Serializable scenario sets (Gate B, ahead of Gate D's shared runner): named scenario
+ * DEFINITIONS — shocks and overrides over a market snapshot — as pure data one runner can later
+ * apply across domains. Deliberately NOT a DSL: no expressions, no conditionals, no references —
+ * a scenario is a list of typed records, and anything a list of records cannot say belongs in
+ * caller code via the escape hatch (a custom reprice function), not in a language embedded here.
+ *
+ * The shock grammar is the one `@insiderfinance/totalfinance/risk` already speaks — `{ factor, kind: 'percent' |
+ * 'absolute', value }`, with the same factor vocabulary (`spot`, `volatility`, `riskFreeRate`,
+ * `time`, `dividend`, or a custom label) — extended with an optional `target` symbol so one
+ * scenario can shock AAPL and SPY differently. A spine shock without `target` is exactly a risk
+ * `Shock`, so Gate D's runner can hand these to the existing Taylor engine unchanged (no second
+ * vocabulary, no adapter tax).
+ *
+ * Semantics fixed here so every future runner agrees:
+ *
+ * - **overrides apply first**, setting an observation to an absolute value;
+ * - **shocks then apply in array order** (deterministic composition — `+10 pts` then `-5%` is not
+ *   `-5%` then `+10 pts`, and the data says which one is meant);
+ * - **two overrides for the same `(factor, target)` in one scenario are a CONFLICT** and are
+ *   refused at creation — the second absolute set would silently win;
+ * - repeated SHOCKS on one factor are legal: they compose, in order.
+ */
+import { ErrorCode, InputError } from '../errors.js';
+import { ensureKnownKeys, requireArgumentArray, requireArgumentObject } from '../invariants.js';
+import { requireProvenance } from '../provenance.js';
+import { canonicalJsonOf, fromCanonicalJson } from '../canonical-json.js';
+import { contentHash } from './content-hash.js';
+import { deepFreeze } from './deep-freeze.js';
+import { createArtifactMigrationRegistry } from './migration.js';
+export const SCENARIO_SET_KIND = 'totalfinance.scenario-set';
+/** Current scenario-set schema version — same bump-with-migration policy as the other envelopes. */
+export const SCENARIO_SET_SCHEMA_VERSION = 1;
+const ENVELOPE_KEYS = ['kind', 'schemaVersion', 'name', 'scenarios', 'provenance'];
+const EXAMPLE_CALL = "createScenarioSet({ name: 'rate-and-vol-stress', scenarios: [{ name: 'vol +10pts', shocks: [{ factor: 'volatility', kind: 'absolute', value: 0.10 }] }] })";
+function scenarioError(message, code, context) {
+    return new InputError(message, { code, context });
+}
+function requireFiniteValue(functionName, path, value) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw scenarioError(`${functionName}: ${path} must be a finite number. Received ${typeof value === 'number' ? value : value === null ? 'null' : typeof value}.`, typeof value === 'number' ? ErrorCode.InputNotFinite : ErrorCode.InputWrongType, { function: functionName, field: path });
+    }
+    return value;
+}
+function requireFactor(functionName, path, value) {
+    if (typeof value !== 'string' || value.length === 0) {
+        throw scenarioError(`${functionName}: ${path} must be a factor name — 'spot', 'volatility', 'riskFreeRate', 'time', 'dividend', or a custom label.\n  e.g. ${EXAMPLE_CALL}`, ErrorCode.InputWrongType, { function: functionName, field: path });
+    }
+    return value;
+}
+function validateScenarioSetBody(functionName, body) {
+    if (typeof body.name !== 'string' || body.name.length === 0) {
+        throw scenarioError(`${functionName}: name must be a non-empty string — saved scenario sets are referenced by name.\n  e.g. ${EXAMPLE_CALL}`, ErrorCode.InputWrongType, { field: 'name' });
+    }
+    requireArgumentArray(functionName, 'scenarios', body.scenarios);
+    if (body.scenarios.length === 0) {
+        throw scenarioError(`${functionName}: scenarios must name at least one scenario — an empty set answers nothing.`, ErrorCode.InputOutOfRange, { field: 'scenarios' });
+    }
+    const seenNames = new Set();
+    for (let s = 0; s < body.scenarios.length; s++) {
+        const scenario = body.scenarios[s];
+        const path = `scenarios[${s}]`;
+        requireArgumentObject(functionName, path, scenario);
+        ensureKnownKeys(functionName, path, scenario, ['name', 'shocks', 'overrides']);
+        if (typeof scenario.name !== 'string' || scenario.name.length === 0) {
+            throw scenarioError(`${functionName}: ${path}.name must be a non-empty string — result cells trace back to scenarios by name.`, ErrorCode.InputWrongType, { field: `${path}.name` });
+        }
+        if (seenNames.has(scenario.name)) {
+            throw scenarioError(`${functionName}: scenario name '${scenario.name}' appears twice — names are the set's row identity, so each must be unique.`, ErrorCode.InputOutOfRange, { field: `${path}.name`, name: scenario.name });
+        }
+        seenNames.add(scenario.name);
+        requireArgumentArray(functionName, `${path}.shocks`, scenario.shocks);
+        for (let i = 0; i < scenario.shocks.length; i++) {
+            const shock = scenario.shocks[i];
+            const shockPath = `${path}.shocks[${i}]`;
+            requireArgumentObject(functionName, shockPath, shock);
+            ensureKnownKeys(functionName, shockPath, shock, ['factor', 'kind', 'value', 'target']);
+            requireFactor(functionName, `${shockPath}.factor`, shock.factor);
+            if (shock.kind !== 'percent' && shock.kind !== 'absolute') {
+                throw scenarioError(`${functionName}: ${shockPath}.kind must be 'percent' or 'absolute'; got ${JSON.stringify(shock.kind)}.`, ErrorCode.InputInvalidEnum, { field: `${shockPath}.kind`, value: shock.kind });
+            }
+            requireFiniteValue(functionName, `${shockPath}.value`, shock.value);
+            if (shock.target !== undefined &&
+                (typeof shock.target !== 'string' || shock.target.length === 0)) {
+                throw scenarioError(`${functionName}: ${shockPath}.target must be a non-empty symbol string when present.`, ErrorCode.InputWrongType, { field: `${shockPath}.target` });
+            }
+        }
+        if (scenario.overrides !== undefined) {
+            requireArgumentArray(functionName, `${path}.overrides`, scenario.overrides);
+            const seenOverrides = new Set();
+            for (let i = 0; i < scenario.overrides.length; i++) {
+                const override = scenario.overrides[i];
+                const overridePath = `${path}.overrides[${i}]`;
+                requireArgumentObject(functionName, overridePath, override);
+                ensureKnownKeys(functionName, overridePath, override, ['factor', 'value', 'target']);
+                const factor = requireFactor(functionName, `${overridePath}.factor`, override.factor);
+                requireFiniteValue(functionName, `${overridePath}.value`, override.value);
+                if (override.target !== undefined &&
+                    (typeof override.target !== 'string' || override.target.length === 0)) {
+                    throw scenarioError(`${functionName}: ${overridePath}.target must be a non-empty symbol string when present.`, ErrorCode.InputWrongType, { field: `${overridePath}.target` });
+                }
+                const overrideKey = JSON.stringify([factor, override.target ?? null]);
+                if (seenOverrides.has(overrideKey)) {
+                    throw scenarioError(`${functionName}: ${overridePath} sets (${factor}${override.target === undefined ? '' : `, ${override.target}`}) a second time in '${scenario.name}' — two absolute sets for one observation conflict, and the second would silently win. Merge them or split the scenario.`, ErrorCode.InputOutOfRange, {
+                        field: overridePath,
+                        factor,
+                        ...(override.target !== undefined ? { target: override.target } : {}),
+                    });
+                }
+                seenOverrides.add(overrideKey);
+            }
+        }
+    }
+}
+/**
+ * Build an immutable, serializable scenario set.
+ *
+ * @example
+ * ```ts
+ * const stress = createScenarioSet({
+ *   name: 'q3-desk-stress',
+ *   scenarios: [
+ *     { name: 'crash -20%', shocks: [{ factor: 'spot', kind: 'percent', value: -0.20 },
+ *                                    { factor: 'volatility', kind: 'absolute', value: 0.15 }] },
+ *     { name: 'rates 2019', overrides: [{ factor: 'riskFreeRate', value: 0.0155 }], shocks: [] },
+ *   ],
+ * });
+ * ```
+ */
+export function createScenarioSet(input) {
+    requireArgumentObject('createScenarioSet', 'input', input);
+    ensureKnownKeys('createScenarioSet', 'input', input, ['name', 'scenarios', 'provenance']);
+    const envelope = {
+        kind: SCENARIO_SET_KIND,
+        schemaVersion: SCENARIO_SET_SCHEMA_VERSION,
+        name: input.name,
+        scenarios: input.scenarios,
+        ...(input.provenance !== undefined ? { provenance: input.provenance } : {}),
+    };
+    validateScenarioSetBody('createScenarioSet', envelope);
+    if (envelope.provenance !== undefined) {
+        // The ONE shared provenance validator — the same closed-key, fully typed check every envelope
+        // applies, so `provenance: { provider: 42 }` is refused here exactly as a snapshot refuses it.
+        requireProvenance('createScenarioSet', 'provenance', envelope.provenance);
+    }
+    return deepFreeze(fromCanonicalJson(canonicalJsonOf(envelope)));
+}
+/**
+ * Validate a CURRENT-version scenario-set envelope in FULL: closed key set, kind, exact schema
+ * version, the whole scenarios body (names unique, shocks/overrides typed, override conflicts
+ * refused), and provenance shape. The read door's own validation extracted into a callable that
+ * does not migrate — shared by `readScenarioSet` (post-migration) and the public
+ * {@link isScenarioSet} guard, so the two can never disagree about what a scenario set is.
+ */
+function requireCurrentScenarioSetEnvelope(functionName, candidate) {
+    ensureKnownKeys(functionName, 'scenarioSet', candidate, ENVELOPE_KEYS);
+    if (candidate['kind'] !== SCENARIO_SET_KIND) {
+        throw scenarioError(`${functionName}: scenarioSet.kind is ${JSON.stringify(candidate['kind'])}, not '${SCENARIO_SET_KIND}'.`, ErrorCode.SnapshotKindMismatch, { received: candidate['kind'] });
+    }
+    if (candidate['schemaVersion'] !== SCENARIO_SET_SCHEMA_VERSION) {
+        throw scenarioError(`${functionName}: scenarioSet.schemaVersion is ${String(candidate['schemaVersion'])}, not the current ${SCENARIO_SET_SCHEMA_VERSION} — older versions load only through readScenarioSet's explicit migrations.`, ErrorCode.SnapshotInvalidVersion, { version: candidate['schemaVersion'] });
+    }
+    const body = {
+        kind: SCENARIO_SET_KIND,
+        schemaVersion: SCENARIO_SET_SCHEMA_VERSION,
+        name: candidate['name'],
+        scenarios: candidate['scenarios'],
+        ...(candidate['provenance'] !== undefined
+            ? { provenance: candidate['provenance'] }
+            : {}),
+    };
+    validateScenarioSetBody(functionName, body);
+    // The body validator deliberately omits provenance (labels are not identity); presence still
+    // demands the full shared shape — a `{ provider: 42 }` label bag is not provenance.
+    if (body.provenance !== undefined) {
+        requireProvenance(functionName, 'provenance', body.provenance);
+    }
+    return body;
+}
+/**
+ * Sound structural test for a CURRENT-version scenario-set envelope: the complete read-door
+ * validation behind a boolean door — `true` means `readScenarioSet` would accept the value
+ * unchanged, with no migrations. (An earlier version checked four fields, so
+ * `{ …, scenarios: [42] }` passed as `ScenarioSet` and detonated at first use.) Full-walk, not
+ * constant-time; call the read door when you also need the restored copy.
+ */
+export function isScenarioSet(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    try {
+        requireCurrentScenarioSetEnvelope('isScenarioSet', value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Restore a stored scenario set, with the shared version/migration policy. */
+export function readScenarioSet(input) {
+    requireArgumentObject('readScenarioSet', 'input', input);
+    ensureKnownKeys('readScenarioSet', 'input', input, ['scenarioSet', 'migrations']);
+    const raw = input.scenarioSet;
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw scenarioError(`readScenarioSet: scenarioSet must be a ScenarioSet envelope object. Received ${raw === null ? 'null' : Array.isArray(raw) ? 'array' : typeof raw}.`, ErrorCode.SnapshotWrongShape, { received: raw === null ? 'null' : typeof raw });
+    }
+    const candidate = raw;
+    ensureKnownKeys('readScenarioSet', 'scenarioSet', candidate, ENVELOPE_KEYS);
+    if (candidate['kind'] !== SCENARIO_SET_KIND) {
+        throw scenarioError(`readScenarioSet: scenarioSet.kind is ${JSON.stringify(candidate['kind'])}, not '${SCENARIO_SET_KIND}' — this reader restores scenario sets only.`, ErrorCode.SnapshotKindMismatch, { received: candidate['kind'] });
+    }
+    const version = candidate['schemaVersion'];
+    if (typeof version !== 'number' || !Number.isSafeInteger(version) || version < 0) {
+        throw scenarioError(`readScenarioSet: scenarioSet has an invalid schema version: ${String(version)}.`, ErrorCode.SnapshotInvalidVersion, { version });
+    }
+    if (version > SCENARIO_SET_SCHEMA_VERSION) {
+        throw scenarioError(`readScenarioSet: scenarioSet schema version ${version} is newer than this build supports (${SCENARIO_SET_SCHEMA_VERSION}). Upgrade @insiderfinance/totalfinance to restore it.`, ErrorCode.SnapshotUnsupportedVersion, { version, supported: SCENARIO_SET_SCHEMA_VERSION });
+    }
+    let envelope = candidate;
+    let migrationsApplied = [];
+    if (version < SCENARIO_SET_SCHEMA_VERSION) {
+        const registry = input.migrations ?? createArtifactMigrationRegistry();
+        ({ envelope, migrationsApplied } = registry.upgrade({
+            envelope,
+            targetVersion: SCENARIO_SET_SCHEMA_VERSION,
+        }));
+    }
+    // The shared current-version validator — one law with isScenarioSet. Post-migration it also
+    // proves the registry actually delivered the current shape (kind and version included).
+    const body = requireCurrentScenarioSetEnvelope('readScenarioSet', envelope);
+    return {
+        scenarioSet: deepFreeze(fromCanonicalJson(canonicalJsonOf(body))),
+        migrationsApplied,
+    };
+}
+/** Content identity for a scenario set: the canonical envelope WITHOUT `provenance`. */
+export function scenarioSetContentHash(scenarioSet) {
+    requireArgumentObject('scenarioSetContentHash', 'scenarioSet', scenarioSet);
+    // FULL validation, not the structural predicate: a malformed envelope must be refused, never
+    // identified (the deep probe convicted the predicate-only version for hashing unknown keys and a
+    // null provenance). Reusing the read path keeps ONE validator.
+    const { scenarioSet: validated } = readScenarioSet({ scenarioSet });
+    return contentHash({
+        kind: validated.kind,
+        schemaVersion: validated.schemaVersion,
+        name: validated.name,
+        scenarios: validated.scenarios,
+    });
+}
+//# sourceMappingURL=scenario-set.js.map

package/modules/core/dist/artifacts/scenario-set.js.map

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