@idlekit/core 0.2.1 → 0.3.0

package/dist/sim/analysis/metrics.js

@@ -0,0 +1,266 @@
+import { analysisAlgorithmVersion, classifyAmount, classifyFinite, unavailableReading, } from "./contracts";
+const NET_WORTH_FALLBACK = "netWorth missing; wallet amount used";
+// Attach the observer to the original predicate so met overrides keep working.
+// A shared symbol also works when a plugin and its caller load separate core copies.
+const GOAL_OBSERVATION = Symbol.for("@idlekit/core.goalObservation.v1");
+export function walletMoneyMetric() {
+    return {
+        id: "money",
+        version: 1,
+        meaning: "Current wallet amount",
+        domain: "amount",
+        timeAxis: "instant",
+        kind: "stock",
+        extract(_ctx, state) {
+            return {
+                available: true,
+                domain: "amount",
+                amount: state.wallet.money.amount,
+                unit: state.wallet.money.unit.code,
+            };
+        },
+    };
+}
+export function netWorthMetric(read) {
+    return {
+        id: "netWorth",
+        version: 1,
+        meaning: "Current net worth amount",
+        domain: "amount",
+        timeAxis: "instant",
+        kind: "stock",
+        extract(ctx, state) {
+            const worth = read(ctx, state);
+            if (!worth)
+                return { available: false, status: "unsupported", reason: "netWorth is not provided" };
+            return { available: true, domain: "amount", amount: worth.amount, unit: worth.unit };
+        },
+    };
+}
+export function prestigePointsMetric() {
+    return {
+        id: "prestige.points",
+        version: 1,
+        meaning: "Current prestige points",
+        domain: "amount",
+        timeAxis: "instant",
+        kind: "stock",
+        extract(_ctx, state) {
+            return {
+                available: true,
+                domain: "amount",
+                amount: state.prestige.points,
+                unit: "prestige.points",
+            };
+        },
+    };
+}
+export function finiteValueMetric(args) {
+    return {
+        id: args.id,
+        version: args.version ?? 1,
+        meaning: args.meaning,
+        domain: args.domain,
+        timeAxis: args.timeAxis ?? "instant",
+        kind: args.kind ?? "stock",
+        extract(ctx, state) {
+            const value = args.read(ctx, state);
+            if (value === undefined)
+                return { available: false, status: "unsupported", reason: "value is not provided" };
+            return { available: true, domain: args.domain, value };
+        },
+    };
+}
+export function readMetric(metric, ctx, state, method) {
+    const extracted = metric.extract(ctx, state);
+    const base = {
+        metricId: metric.id,
+        metricVersion: metric.version,
+        meaning: metric.meaning,
+        metricKind: metric.kind,
+        timeAxis: metric.timeAxis,
+        domain: metric.domain,
+    };
+    if (!extracted.available) {
+        return unavailableReading({
+            ...base,
+            status: extracted.status,
+            ...(extracted.reason !== undefined ? { reason: extracted.reason } : {}),
+        });
+    }
+    // A registered extractor is typed apart from its definition. A mismatch is reported, not mixed into one reading.
+    if (extracted.domain !== metric.domain) {
+        return unavailableReading({
+            ...base,
+            status: "invalid",
+            reason: `extractor returned domain ${extracted.domain}; the metric declares ${metric.domain}`,
+        });
+    }
+    const classified = extracted.domain === "amount"
+        ? classifyAmount(ctx.E, extracted.amount, extracted.unit)
+        : classifyFinite(extracted.value);
+    const reading = method === undefined ? "observed" : "estimated";
+    return {
+        ...base,
+        reading: classified.status === "ok" ? reading : "unavailable",
+        ...classified,
+        ...(method !== undefined && classified.status === "ok" ? { method } : {}),
+    };
+}
+function amountGoalObservation(target, read) {
+    const observe = (state, ctx) => {
+        // Some decimal engines saturate an Infinity spelling to a finite sentinel.
+        if (/^[+-]?(?:nan|infinity)$/i.test(target.trim()))
+            return { status: "invalid" };
+        const threshold = ctx.E.from(target);
+        if (!ctx.E.isFinite(threshold))
+            return { status: "invalid" };
+        const amount = read(state, ctx);
+        if (amount === undefined)
+            return { status: "unsupported" };
+        if (!ctx.E.isFinite(amount))
+            return { status: "invalid" };
+        return { status: "ok", reached: ctx.E.cmp(amount, threshold) >= 0 };
+    };
+    const met = (state, ctx) => {
+        const result = observe(state, ctx);
+        return result.status === "ok" ? result.reached : undefined;
+    };
+    Object.defineProperty(met, GOAL_OBSERVATION, { value: observe });
+    return { met };
+}
+export function moneyAtLeast(target) {
+    return {
+        id: "money.atLeast",
+        version: 1,
+        observation: "state",
+        timeResolution: "step",
+        ...amountGoalObservation(target, (state) => state.wallet.money.amount),
+    };
+}
+export function netWorthAtLeast(args) {
+    return {
+        id: "netWorth.atLeast",
+        version: 1,
+        observation: "state",
+        timeResolution: "step",
+        ...amountGoalObservation(args.target, (state, ctx) => {
+            const worth = args.netWorth(state, ctx);
+            return worth ?? (args.fallbackToWallet ? state.wallet.money.amount : undefined);
+        }),
+        assumptionsFor(state, ctx) {
+            if (!args.fallbackToWallet || args.netWorth(state, ctx) !== undefined)
+                return [];
+            return [NET_WORTH_FALLBACK];
+        },
+    };
+}
+export function prestigePointsAtLeast(target) {
+    return {
+        id: "prestige.points.atLeast",
+        version: 1,
+        observation: "state",
+        timeResolution: "step",
+        ...amountGoalObservation(target, (state) => state.prestige.points),
+    };
+}
+export function milestoneReached(args) {
+    return {
+        id: `milestone.${args.key}`,
+        version: 1,
+        observation: "milestone-key",
+        timeResolution: "step",
+        met() {
+            return args.seen.includes(args.key);
+        },
+    };
+}
+export function defineGoal(goal) {
+    return goal;
+}
+export function evaluateGoal(goal, state, ctx) {
+    let observation;
+    const observe = goal.met[GOAL_OBSERVATION];
+    if (observe) {
+        observation = observe(state, ctx);
+    }
+    else {
+        const reached = goal.met(state, ctx);
+        observation = reached === undefined ? { status: "unsupported" } : { status: "ok", reached };
+    }
+    if (observation.status !== "ok") {
+        return {
+            goalId: goal.id,
+            goalVersion: goal.version,
+            status: observation.status,
+            assumptions: [],
+        };
+    }
+    return {
+        goalId: goal.id,
+        goalVersion: goal.version,
+        reached: observation.reached,
+        status: "ok",
+        assumptions: goal.assumptionsFor?.(state, ctx) ?? [],
+    };
+}
+function withMethod(evaluation, method) {
+    if (evaluation.status !== "ok") {
+        return {
+            goalId: evaluation.goalId,
+            goalVersion: evaluation.goalVersion,
+            status: evaluation.status,
+            assumptions: evaluation.assumptions,
+        };
+    }
+    return {
+        goalId: evaluation.goalId,
+        goalVersion: evaluation.goalVersion,
+        status: "ok",
+        method,
+        ...(evaluation.reached !== undefined ? { reached: evaluation.reached } : {}),
+        assumptions: evaluation.assumptions,
+    };
+}
+export function evaluateGoalForEta(goal, state, ctx) {
+    return withMethod(evaluateGoal(goal, state, ctx), "fixed-step");
+}
+export function evaluateGoalForExperiment(goal, state, ctx) {
+    return withMethod(evaluateGoal(goal, state, ctx), "monte-carlo");
+}
+export function evaluateGoalForCheck(goal, state, ctx) {
+    return withMethod(evaluateGoal(goal, state, ctx), "exact");
+}
+export function capabilityKnowledge(declared, name) {
+    if (declared === undefined)
+        return "unknown";
+    if (declared[name] === "statically-known")
+        return "statically-known";
+    return "unsupported";
+}
+export function unsupportedCapabilityResult(name) {
+    return { capability: name, knowledge: "unsupported", status: "unsupported" };
+}
+export function buildAnalysisArtifact(draft = {}) {
+    const capabilities = draft.capabilities ?? {
+        metrics: "unknown",
+        goals: "unknown",
+        reset: "unknown",
+        flow: "unknown",
+        advance: "unknown",
+    };
+    return {
+        schemaVersion: 1,
+        algorithmVersion: draft.algorithmVersion ?? analysisAlgorithmVersion(),
+        assumptions: draft.assumptions ?? [],
+        warnings: draft.warnings ?? [],
+        observationCoverage: draft.observationCoverage ?? "unknown",
+        ...(draft.horizon !== undefined ? { horizon: draft.horizon } : {}),
+        ...(draft.sampleCount !== undefined ? { sampleCount: draft.sampleCount } : {}),
+        ...(draft.effectiveRunHash !== undefined ? { effectiveRunHash: draft.effectiveRunHash } : {}),
+        metrics: draft.metrics ?? [],
+        goals: draft.goals ?? [],
+        capabilities,
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/sim/analysis/metrics.js.map

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

package/dist/sim/analysis/prestigeCycle.d.ts

@@ -8,6 +8,11 @@ export type PrestigeCycleRow = Readonly<{
     breakEvenSec: number;
     stability: "stable" | "drifting";
 }>;
+/**
+ * The row fields above are the legacy interval scan.
+ * They are not counts of committed resets and not a steady state.
+ */
+export declare const legacyPrestigeCycleWarnings: readonly ["stability is cycles >= 5 and is not a measured steady state", "breakEvenSec is min(interval, horizon) and is not a committed reset", "cycles is copied onto each row and is not a count of committed resets"];
 export declare function analyzePrestigeCycle<N, U extends string, Vars>(args: {
     scenario: CompiledScenario<N, U, Vars>;
     scan: Readonly<{
@@ -21,4 +26,5 @@ export declare function analyzePrestigeCycle<N, U extends string, Vars>(args: {
 }): Readonly<{
     best: PrestigeCycleRow;
     rows: PrestigeCycleRow[];
+    warnings: readonly string[];
 }>;

package/dist/sim/analysis/prestigeCycle.js

@@ -1,5 +1,14 @@
 import { runScenario } from "../simulator";
 import { assertHorizonReached } from "../types";
+/**
+ * The row fields above are the legacy interval scan.
+ * They are not counts of committed resets and not a steady state.
+ */
+export const legacyPrestigeCycleWarnings = [
+    "stability is cycles >= 5 and is not a measured steady state",
+    "breakEvenSec is min(interval, horizon) and is not a committed reset",
+    "cycles is copied onto each row and is not a count of committed resets",
+];
 function metric(row, objective) {
     return Number(objective === "netWorthPerHour" ? row.netWorthPerHour : row.pointsPerHour);
 }
@@ -71,6 +80,6 @@ export function analyzePrestigeCycle(args) {
     if (!best) {
         throw new Error(`analyzePrestigeCycle has no finite ${args.objective} to rank`);
     }
-    return { best, rows };
+    return { best, rows, warnings: legacyPrestigeCycleWarnings };
 }
 //# sourceMappingURL=prestigeCycle.js.map

package/dist/sim/analysis/prestigeCycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"prestigeCycle.js","sourceRoot":"","sources":["../../../src/sim/analysis/prestigeCycle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prestigeCycle.js","sourceRoot":"","sources":["../../../src/sim/analysis/prestigeCycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAyB,MAAM,UAAU,CAAC;AAavE;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,6DAA6D;IAC7D,qEAAqE;IACrE,uEAAuE;CAC/D,CAAC;AAEX,SAAS,MAAM,CAAC,GAAqB,EAAE,SAAiC;IACtE,OAAO,MAAM,CAAC,SAAS,KAAK,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAEzC,MAAM,UAAU,oBAAoB,CAA4B,IAM/D;IACC,MAAM,IAAI,GAAuB,EAAE,CAAC;IACpC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;IAC9C,sGAAsG;IACtG,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QACzB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvB,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QACzB,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;QACd,KAAK,GAAG,OAAO;QACf,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,EACd,CAAC;QACD,MAAM,IAAI,KAAK,CACb,0FAA0F,OAAO,KAAK,KAAK,SAAS,OAAO,GAAG,CAC/H,CAAC;IACJ,CAAC;IACD,gEAAgE;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACjE,wGAAwG;IACxG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,wBAAwB,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CACb,6BAA6B,OAAO,KAAK,KAAK,SAAS,OAAO,QAAQ,KAAK,4BAA4B,wBAAwB,EAAE,CAClI,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,4BAA4B,QAAQ,EAAE,CAAC,CAAC;QACnG,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,WAAW,CAAC;YACtB,GAAG,IAAI,CAAC,QAAQ;YAChB,GAAG,EAAE;gBACH,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG;gBACpB,WAAW,EAAE,QAAQ;gBACrB,KAAK,EAAE,SAAS;aACjB;SACF,CAAC,CAAC;QACH,sEAAsE;QACtE,oBAAoB,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;QAElD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;QACjG,MAAM,eAAe,GACnB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;QAEnF,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjG,MAAM,aAAa,GACjB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;QAEnF,IAAI,CAAC,IAAI,CAAC;YACR,WAAW,EAAE,QAAQ;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,eAAe,EAAE,MAAM,CAAC,eAAe,CAAC;YACxC,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC;YACpC,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC;YACjD,SAAS,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU;SACpD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,oGAAoG;IACpG,IAAI,IAAkC,CAAC;IACvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACtC,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/D,IAAI,GAAG,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,CAAC,SAAS,UAAU,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,2BAA2B,EAAE,CAAC;AAC/D,CAAC"}

package/dist/sim/analysis/registry.d.ts

@@ -0,0 +1,41 @@
+import type { AnalysisCapabilityName, CapabilityKnowledge } from "./contracts";
+import type { GoalDefinition, MetricDefinition } from "./metrics";
+/**
+ * What one model version can explain.
+ * AnalyzerRegistry, which chooses an analysis method, is DX-02 and is not this type.
+ * Flow and advance method bodies stay in later PRs.
+ */
+export type ModelAnalysisAdapter<N, U extends string, Vars> = Readonly<{
+    modelId: string;
+    modelVersion: number;
+    /** Omitted capabilities on a registered adapter are unsupported. */
+    capabilities?: Partial<Record<AnalysisCapabilityName, "statically-known" | "unsupported">>;
+    metrics?: readonly MetricDefinition<N, U, Vars>[];
+    goals?: readonly GoalDefinition<N, U, Vars>[];
+}>;
+export type ModelAnalysisRegistry<N, U extends string, Vars> = Readonly<{
+    register: (adapter: ModelAnalysisAdapter<N, U, Vars>) => void;
+    get: (modelId: string, modelVersion: number) => ModelAnalysisAdapter<N, U, Vars> | undefined;
+    list: () => readonly Readonly<{
+        modelId: string;
+        modelVersion: number;
+    }>[];
+    knowledge: (modelId: string, modelVersion: number, name: AnalysisCapabilityName) => CapabilityKnowledge;
+}>;
+export declare function createModelAnalysisRegistry<N, U extends string, Vars>(): ModelAnalysisRegistry<N, U, Vars>;
+export declare function flowResult(knowledge: CapabilityKnowledge): Readonly<{
+    capability: "flow";
+    knowledge: CapabilityKnowledge;
+    status: "unsupported" | "insufficient-data";
+}> | Readonly<{
+    capability: "flow";
+    knowledge: "statically-known";
+    status: "unsupported";
+    reason: string;
+}>;
+export declare function resetResult(knowledge: CapabilityKnowledge): Readonly<{
+    capability: "reset";
+    knowledge: CapabilityKnowledge;
+    status: "unsupported" | "insufficient-data";
+    reason?: string;
+}>;

package/dist/sim/analysis/registry.js

@@ -0,0 +1,54 @@
+import { capabilityKnowledge } from "./metrics";
+function keyOf(modelId, modelVersion) {
+    return `${modelId}@${modelVersion}`;
+}
+export function createModelAnalysisRegistry() {
+    const map = new Map();
+    return {
+        register(adapter) {
+            map.set(keyOf(adapter.modelId, adapter.modelVersion), adapter);
+        },
+        get(modelId, modelVersion) {
+            return map.get(keyOf(modelId, modelVersion));
+        },
+        list() {
+            return [...map.values()].map((adapter) => ({
+                modelId: adapter.modelId,
+                modelVersion: adapter.modelVersion,
+            }));
+        },
+        knowledge(modelId, modelVersion, name) {
+            const adapter = map.get(keyOf(modelId, modelVersion));
+            if (!adapter)
+                return "unknown";
+            return capabilityKnowledge(adapter.capabilities ?? {}, name);
+        },
+    };
+}
+export function flowResult(knowledge) {
+    if (knowledge === "unknown")
+        return { capability: "flow", knowledge, status: "insufficient-data" };
+    if (knowledge === "statically-known") {
+        return {
+            capability: "flow",
+            knowledge,
+            status: "unsupported",
+            reason: "flow method body is not in this PR",
+        };
+    }
+    return { capability: "flow", knowledge: "unsupported", status: "unsupported" };
+}
+export function resetResult(knowledge) {
+    if (knowledge === "unknown")
+        return { capability: "reset", knowledge, status: "insufficient-data" };
+    if (knowledge === "statically-known") {
+        return {
+            capability: "reset",
+            knowledge,
+            status: "unsupported",
+            reason: "reset execution is not in this PR",
+        };
+    }
+    return { capability: "reset", knowledge: "unsupported", status: "unsupported" };
+}
+//# sourceMappingURL=registry.js.map

package/dist/sim/analysis/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/sim/analysis/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAwBhD,SAAS,KAAK,CAAC,OAAe,EAAE,YAAoB;IAClD,OAAO,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,MAAM,GAAG,GAAG,IAAI,GAAG,EAA4C,CAAC;IAChE,OAAO;QACL,QAAQ,CAAC,OAAO;YACd,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;QACjE,CAAC;QACD,GAAG,CAAC,OAAO,EAAE,YAAY;YACvB,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI;YACF,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACzC,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC,CAAC,CAAC;QACN,CAAC;QACD,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI;YACnC,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;YACtD,IAAI,CAAC,OAAO;gBAAE,OAAO,SAAS,CAAC;YAC/B,OAAO,mBAAmB,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QAC/D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,SAA8B;IAKvD,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACnG,IAAI,SAAS,KAAK,kBAAkB,EAAE,CAAC;QACrC,OAAO;YACL,UAAU,EAAE,MAAM;YAClB,SAAS;YACT,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,oCAAoC;SAC7C,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAA8B;IAMxD,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACpG,IAAI,SAAS,KAAK,kBAAkB,EAAE,CAAC;QACrC,OAAO;YACL,UAAU,EAAE,OAAO;YACnB,SAAS;YACT,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,mCAAmC;SAC5C,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AAClF,CAAC"}

package/dist/sim/analysis/resetActions.d.ts

@@ -0,0 +1,7 @@
+import type { Model } from "../types";
+import type { ResetAdapter } from "./resetCycle";
+/**
+ * The executor is the only reset authority. During an interval the strategy does not see the reset action,
+ * so it cannot commit a reset the artifact would not count. Without an adapter, prestige actions are hidden.
+ */
+export declare function withoutResetActions<N, U extends string, Vars>(model: Model<N, U, Vars>, adapter: ResetAdapter<N, U, Vars> | undefined): Model<N, U, Vars>;

package/dist/sim/analysis/resetActions.js

@@ -0,0 +1,45 @@
+/*
+ * Internal to reset analysis. Not exported from the package barrel.
+ */
+/**
+ * The executor is the only reset authority. During an interval the strategy does not see the reset action,
+ * so it cannot commit a reset the artifact would not count. Without an adapter, prestige actions are hidden.
+ */
+export function withoutResetActions(model, adapter) {
+    const actions = (actionCtx, actionState) => {
+        // Prestige actions are resets under any adapter. A custom adapter does not make them ordinary interval actions.
+        const listed = model.actions(actionCtx, actionState).filter((candidate) => candidate.kind !== "prestige");
+        if (!adapter)
+            return listed;
+        // Resolve the adapter's reset for this state, whatever kind the adapter declares. A prestige-declared adapter can
+        // still return a custom action, and the strategy must not commit it during the interval.
+        const reset = adapter.action(actionCtx, actionState);
+        if (!reset || reset.kind === "prestige")
+            return listed;
+        // A listed reset is removed by identity, so an ordinary custom action sharing its id stays available.
+        if (listed.includes(reset))
+            return listed.filter((candidate) => candidate !== reset);
+        return listed.filter((candidate) => !(candidate.kind === "custom" && candidate.id === reset.id));
+    };
+    return delegateModel(model, actions);
+}
+/**
+ * A plain object whose members read from, and call on, the original model. Methods keep the model as
+ * their receiver, so class methods that use private fields still work.
+ */
+function delegateModel(model, actions) {
+    const out = {};
+    const seen = new Set();
+    for (let level = model; level && level !== Object.prototype; level = Object.getPrototypeOf(level)) {
+        for (const key of Reflect.ownKeys(level)) {
+            if (key === "constructor" || seen.has(key))
+                continue;
+            seen.add(key);
+            const value = Reflect.get(model, key, model);
+            out[key] = typeof value === "function" ? value.bind(model) : value;
+        }
+    }
+    out.actions = actions;
+    return out;
+}
+//# sourceMappingURL=resetActions.js.map

package/dist/sim/analysis/resetActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resetActions.js","sourceRoot":"","sources":["../../../src/sim/analysis/resetActions.ts"],"names":[],"mappings":"AAGA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAwB,EACxB,OAA6C;IAE7C,MAAM,OAAO,GAAG,CAAC,SAAiC,EAAE,WAAiC,EAAE,EAAE;QACvF,gHAAgH;QAChH,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QAC1G,IAAI,CAAC,OAAO;YAAE,OAAO,MAAM,CAAC;QAC5B,kHAAkH;QAClH,yFAAyF;QACzF,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO,MAAM,CAAC;QACvD,sGAAsG;QACtG,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC;QACrF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,SAAS,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACnG,CAAC,CAAC;IACF,OAAO,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CACpB,KAAwB,EACxB,OAAqC;IAErC,MAAM,GAAG,GAAiC,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAe,CAAC;IACpC,KAAK,IAAI,KAAK,GAAkB,KAAK,EAAE,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QACjH,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,IAAI,GAAG,KAAK,aAAa,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YACrD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,MAAM,KAAK,GAAY,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YACtD,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAE,KAAyC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC1G,CAAC;IACH,CAAC;IACD,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;IACtB,OAAO,GAAmC,CAAC;AAC7C,CAAC"}