@dzhechkov/harness-core 0.7.10 → 0.7.12

package/dist/lesson-bandit.js

@@ -0,0 +1,235 @@
+/**
+ * VENDORED — contextual Thompson-Sampling bandit (feature lesson-bandit-rerank, ADR-001 D-1).
+ *
+ * Upstream: agentdb@3.0.0-alpha.20 — dist/src/backends/rvf/SolverBandit.js
+ * Licence:  MIT, Copyright (c) 2024-2025 ruv
+ * Vendored: 2026-08-26. 215 lines, ZERO imports (both re-verified at copy time:
+ *           `wc -l` → 215, `grep -cE 'require|^import'` → 0).
+ * SHA-256:  0199299fb60ef67afa030182185894c950126038398032349fe3618d910f6d7d
+ *           (of the upstream .js at copy time; pinned by lesson-bandit-vendor.test.ts)
+ * Reason:   the path is NOT in agentdb's package.json "exports" map (verified 2026-08-26);
+ *           a deep import of a private path in a 3.0.0-alpha prerelease can change silently,
+ *           and a ranking feature that quietly stops ranking looks exactly like one that works.
+ *
+ * Do not edit logic. Re-vendor from upstream and re-diff instead.
+ *
+ * WHAT CHANGED relative to the upstream .js, and nothing else:
+ *   · `class SolverBandit` → `class LessonBandit` (ADR-001 D-1: one name, no alias);
+ *   · TYPES added (field declarations, method signatures, the three exported interfaces);
+ *   · `armKeys[0]` → `armKeys[0]!` and `ctx.get(armKey)` → `!` — required by this package's
+ *     `noUncheckedIndexedAccess`; the emitted arithmetic is unchanged.
+ * The Jöhnk / Marsaglia-Tsang samplers, the `a<=1 && b<=1 ⇒ Math.random()` short-circuit, the
+ * exploration bonus and the cost EMA are preserved verbatim — the MEASURED API behaviour (200
+ * pulls on a 0.85-vs-0.15 pair → 100/100 correct picks) is a property of exactly this arithmetic.
+ *
+ * THIS FILE MUST STAY IMPORT-FREE (NFR-2 / C-7 / INV-6) — asserted by a repo test.
+ */
+/**
+ * Thompson Sampling bandit with contextual arms.
+ *
+ * Usage:
+ *   const bandit = new LessonBandit();
+ *   const arm = bandit.selectArm('code_review', ['skill-a', 'skill-b', 'skill-c']);
+ *   // ... execute the selected arm ...
+ *   bandit.recordReward('code_review', arm, 0.85);
+ */
+export class LessonBandit {
+    contexts = new Map();
+    config;
+    constructor(config) {
+        this.config = {
+            costWeight: config?.costWeight ?? 0.01,
+            costDecay: config?.costDecay ?? 0.1,
+            explorationBonus: config?.explorationBonus ?? 0.1,
+        };
+    }
+    /**
+     * Select the best arm for a given context using Thompson Sampling.
+     *
+     * For each candidate arm, samples from its Beta(alpha, beta) distribution
+     * and subtracts a cost penalty. Returns the arm with the highest score.
+     * Unknown arms get an exploration bonus.
+     */
+    selectArm(contextKey, armKeys) {
+        if (armKeys.length === 0)
+            throw new Error('No arms provided');
+        if (armKeys.length === 1)
+            return armKeys[0];
+        const ctx = this.contexts.get(contextKey);
+        let bestArm = armKeys[0];
+        let bestScore = -Infinity;
+        for (const arm of armKeys) {
+            const stats = ctx?.get(arm);
+            let score;
+            if (!stats || stats.pulls === 0) {
+                // Unknown arm: sample from uniform + exploration bonus
+                score = Math.random() + this.config.explorationBonus;
+            }
+            else {
+                // Thompson sample from Beta(alpha, beta)
+                const sample = this.sampleBeta(stats.alpha, stats.beta);
+                score = sample - stats.costEma * this.config.costWeight;
+            }
+            if (score > bestScore) {
+                bestScore = score;
+                bestArm = arm;
+            }
+        }
+        return bestArm;
+    }
+    /**
+     * Record the outcome of pulling an arm.
+     *
+     * @param contextKey - The context bucket (e.g., task type)
+     * @param armKey - The arm that was pulled (e.g., skill name)
+     * @param reward - Success signal in [0, 1]
+     * @param cost - Optional cost signal (latency, tokens, etc.)
+     */
+    recordReward(contextKey, armKey, reward, cost) {
+        if (!this.contexts.has(contextKey)) {
+            this.contexts.set(contextKey, new Map());
+        }
+        const ctx = this.contexts.get(contextKey);
+        if (!ctx.has(armKey)) {
+            ctx.set(armKey, { alpha: 1, beta: 1, pulls: 0, totalReward: 0, costEma: 0 });
+        }
+        const arm = ctx.get(armKey);
+        // Update Beta distribution
+        const r = Math.max(0, Math.min(1, reward));
+        arm.alpha += r;
+        arm.beta += (1 - r);
+        arm.pulls++;
+        arm.totalReward += r;
+        // Update cost EMA
+        if (cost !== undefined) {
+            arm.costEma = arm.costEma * (1 - this.config.costDecay) + cost * this.config.costDecay;
+        }
+    }
+    /**
+     * Rerank a list of candidates using bandit scores.
+     * Returns indices sorted by Thompson-sampled score (best first).
+     */
+    rerank(contextKey, armKeys) {
+        if (armKeys.length <= 1)
+            return [...armKeys];
+        const ctx = this.contexts.get(contextKey);
+        const scored = armKeys.map((arm) => {
+            const stats = ctx?.get(arm);
+            let score;
+            if (!stats || stats.pulls === 0) {
+                score = Math.random() + this.config.explorationBonus;
+            }
+            else {
+                score = this.sampleBeta(stats.alpha, stats.beta) - stats.costEma * this.config.costWeight;
+            }
+            return { arm, score };
+        });
+        scored.sort((a, b) => b.score - a.score);
+        return scored.map((s) => s.arm);
+    }
+    /** Get arm stats for a specific context */
+    getArmStats(contextKey, armKey) {
+        return this.contexts.get(contextKey)?.get(armKey) ?? null;
+    }
+    /** Get aggregate statistics */
+    getStats() {
+        let totalArms = 0, totalPulls = 0, totalReward = 0;
+        for (const ctx of this.contexts.values()) {
+            totalArms += ctx.size;
+            for (const arm of ctx.values()) {
+                totalPulls += arm.pulls;
+                totalReward += arm.totalReward;
+            }
+        }
+        return { contexts: this.contexts.size, totalArms, totalPulls, totalReward };
+    }
+    /** Serialize to JSON-safe state */
+    serialize() {
+        const contexts = {};
+        for (const [ctxKey, arms] of this.contexts) {
+            contexts[ctxKey] = {};
+            for (const [armKey, stats] of arms) {
+                contexts[ctxKey][armKey] = { ...stats };
+            }
+        }
+        return { version: 1, config: { ...this.config }, contexts };
+    }
+    /**
+     * Restore from serialized state.
+     *
+     * STATIC (C-2). A first draft that called it as an instance method threw `TypeError`; the
+     * signature here makes the static call the only one that compiles.
+     */
+    static deserialize(state) {
+        const bandit = new LessonBandit(state.config);
+        for (const [ctxKey, arms] of Object.entries(state.contexts)) {
+            const ctx = new Map();
+            for (const [armKey, stats] of Object.entries(arms)) {
+                ctx.set(armKey, { ...stats });
+            }
+            bandit.contexts.set(ctxKey, ctx);
+        }
+        return bandit;
+    }
+    /** Reset all learned state */
+    reset() {
+        this.contexts.clear();
+    }
+    // ─── Private ───
+    /**
+     * Sample from Beta(a, b) using the Jöhnk algorithm.
+     * Fast approximation for typical bandit parameters.
+     */
+    sampleBeta(a, b) {
+        // For a=1, b=1 (uniform): just return Math.random()
+        if (a <= 1 && b <= 1)
+            return Math.random();
+        // Jöhnk's algorithm for general Beta
+        if (a < 1 && b < 1) {
+            for (let iter = 0; iter < 1000; iter++) {
+                const u = Math.random();
+                const v = Math.random();
+                const x = Math.pow(u, 1 / a);
+                const y = Math.pow(v, 1 / b);
+                if (x + y <= 1)
+                    return x / (x + y);
+            }
+            return Math.random(); // fallback (extremely unlikely)
+        }
+        // For larger parameters, use Gamma ratio
+        const ga = this.sampleGamma(a);
+        const gb = this.sampleGamma(b);
+        return ga / (ga + gb);
+    }
+    /**
+     * Sample from Gamma(shape, 1) using Marsaglia & Tsang's method.
+     */
+    sampleGamma(shape) {
+        if (shape < 1) {
+            return this.sampleGamma(shape + 1) * Math.pow(Math.random(), 1 / shape);
+        }
+        const d = shape - 1 / 3;
+        const c = 1 / Math.sqrt(9 * d);
+        for (let iter = 0; iter < 1000; iter++) {
+            let x, v;
+            do {
+                x = this.sampleNormal();
+                v = 1 + c * x;
+            } while (v <= 0);
+            v = v * v * v;
+            const u = Math.random();
+            if (u < 1 - 0.0331 * (x * x) * (x * x))
+                return d * v;
+            if (Math.log(u) < 0.5 * x * x + d * (1 - v + Math.log(v)))
+                return d * v;
+        }
+        return d; // fallback (extremely unlikely)
+    }
+    /** Box-Muller normal sample */
+    sampleNormal() {
+        const u1 = Math.random();
+        const u2 = Math.random();
+        return Math.sqrt(-2 * Math.log(u1)) * Math.cos(2 * Math.PI * u2);
+    }
+}
+//# sourceMappingURL=lesson-bandit.js.map

package/dist/lesson-bandit.js.map

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

package/dist/lesson-payoff.d.ts

@@ -0,0 +1,260 @@
+/**
+ * Lesson Payoff — the anti-corruption layer around the vendored bandit engine
+ * (feature lesson-bandit-rerank; ADR-001 / ADR-002 / ADR-003, domain model §6).
+ *
+ * WHAT THIS OWNS. One question: *how often did THIS lesson, in THIS kind of situation, actually
+ * resolve a problem?* It knows a lesson only as an opaque `ArmKey` (its `dzId`). It never reads
+ * lesson text, never writes to the pattern store, never decides candidate membership, and never
+ * touches quarantine state (INV-9).
+ *
+ * WHY AN ACL WHEN WE OWN THE COPY. Vendoring gives us the FILE, not the LANGUAGE. The engine's
+ * only counter-advancing method (`recordReward`) also moves the Beta parameters, so there is no way
+ * to tell it "a pull happened, no evidence either way". Our domain MUST be able to say that: an
+ * EXPOSURE is not a REWARD (INV-2 — the defect cross-model QE already removed once from
+ * `patterns.ts`, where recall-hit telemetry was silently promoting every viewed lesson). So the
+ * exposure counter lives in OUR envelope, beside the engine payload, and INV-2 is true by DATA
+ * LAYOUT rather than by call-site discipline: there is no field in `bandit.contexts` an exposure is
+ * allowed to touch.
+ *
+ * DETERMINISM (ADR-001 D-2 / D-7, reaffirmed by ADR-003's P5). The default payoff term is the
+ * POSTERIOR MEAN `alpha/(alpha+beta)`, mapped to `[-1,+1]`, using ONLY `getArmStats` — never
+ * `selectArm`, never `rerank`. Both of those Thompson-SAMPLE (`Math.random()` on every zero-pull
+ * arm), which would make two identical recalls disagree, defeat the byte-identity proof, and hand
+ * quarantined lessons a random lift. `05_architecture.md` §3 and `04_domain_model.md` §6.2 sketch an
+ * order-projection over `rerank()` instead; that draft is refuted by ADR-003's P5 ("with
+ * `banditExploration` absent, no `Math.random()` is consumed on the recall path"), which `rerank`
+ * cannot satisfy. The ADRs are the decision record and they win; this file implements them, and the
+ * bound the order-projection was chosen for is preserved exactly — the term is in `[-1,+1]` by
+ * construction, so the caller's cap is an EXACT bound.
+ *
+ * FAILURE POSTURE (NFR-5 / INV-7). Every read here degrades to "no term applied, honest reason
+ * recorded"; every write degrades to "this reward was dropped, counted, and logged". Nothing in
+ * this module may throw into `hybridRecall` or `reinforcePattern`.
+ */
+import { type SerializedBanditState } from './lesson-bandit.js';
+import { type MemoryLearningConfig } from './patterns.js';
+/** OUR envelope version — distinct from the engine's own `version` field (architecture §7.2). */
+export declare const BANDIT_STATE_SCHEMA = 1;
+/**
+ * The named lock guarding the state file. It resolves to `<projectRoot>/.dz/locks/lesson-bandit.lock`,
+ * i.e. the lock sits in the SAME `.dz` that holds the store — two worktrees pointing at one brain
+ * therefore share one lock, which is the only placement that serializes the right writers.
+ */
+export declare const BANDIT_LOCK_NAME = "lesson-bandit";
+export declare function banditStateDir(projectRoot: string): string;
+/**
+ * `<projectRoot>/.dz/lesson-bandit/state.json` (plan §0 D0-1 — the ADRs' worked examples say
+ * `.dz/memory/bandit-state.json`; ADR-002's FR-2 already hedges "or equivalent path under `.dz/`",
+ * and requirements/domain-model/architecture all key on this one).
+ */
+export declare function banditStatePath(projectRoot: string): string;
+export interface ResolvedBanditConfig {
+    /** `memory.learning.banditRerank === true`. Absent/invalid ⇒ false ⇒ this context is never built. */
+    readonly enabled: boolean;
+    /** What the config ASKED for, before the `enabled` gate. */
+    readonly explorationRequested: boolean;
+    /** Effective exploration: requested AND armed. `explore` without `rerank` is a no-op (ADR-003). */
+    readonly exploration: boolean;
+}
+export declare function resolveBanditConfig(projectRoot: string, cfg?: MemoryLearningConfig): ResolvedBanditConfig;
+/**
+ * ContextKey (domain model §3.3) — the coarse situation bucket a recall happened in, derived from
+ * the resolved recall domain (the axis `dz recall --domain` already boosts on). COARSE on purpose:
+ * with a per-query key every arm would sit at `pulls === 0` forever and the term would be noise.
+ * Normalising constructor, so two spellings of one domain cannot fork a posterior.
+ */
+export declare function contextKeyFor(domain?: string | null | undefined): string;
+/** A confirmation happened: this lesson demonstrably helped. */
+export interface RewardEvent {
+    readonly dzId: string;
+    readonly contextKey: string;
+    readonly reward: number;
+    readonly ts: string;
+}
+/** A lesson was merely SEEN in a recall result. Carries no reward mass, by construction. */
+export interface ExposureEvent {
+    readonly dzId: string;
+    readonly contextKey: string;
+    readonly ts: string;
+}
+/**
+ * Build a {@link RewardEvent}, clamping reward into `[0,1]` at the domain boundary (INV-8/AC-7).
+ *
+ * A NON-FINITE reward (`NaN`, `Infinity`) is REJECTED (`null`), not coerced: `clamp01(NaN)` is
+ * `NaN`, which would poison `alpha`; and coercing it to `0` would be worse still — `reward: 0` moves
+ * `beta`, i.e. it records evidence the lesson FAILED. Dropping is the only fail-safe direction.
+ */
+export declare function makeRewardEvent(dzId: string, contextKey: string, reward: number, ts: string): RewardEvent | null;
+/**
+ * Translate one upstream learning sample into exactly one domain event (domain model §5).
+ *
+ * `kind:'merge'` and every UNRECOGNISED kind are DROPPED — a sample kind added upstream tomorrow
+ * defaults to *ignored*, never to *rewarded*. That asymmetry is the whole point of translating
+ * rather than subscribing.
+ */
+export declare function classifySignal(sample: {
+    readonly kind: string;
+    readonly dzId: string;
+    readonly reward?: number | undefined;
+    readonly ts: string;
+}, contextKey: string): {
+    readonly type: 'reward';
+    readonly event: RewardEvent;
+} | {
+    readonly type: 'exposure';
+    readonly event: ExposureEvent;
+} | null;
+/** The single bounded number the ranker gets for one candidate (domain model §3.5). */
+export interface PayoffTerm {
+    readonly dzId: string;
+    /** In `[-1,+1]` BEFORE the caller's cap. */
+    readonly term: number;
+    readonly basis: 'posterior' | 'unknown-arm' | 'explored';
+}
+export interface BanditStateEnvelope {
+    readonly schemaVersion: number;
+    /** Verbatim `LessonBandit.serialize()` output — nested untouched so a re-vendor stays a diff. */
+    readonly bandit: SerializedBanditState;
+    /** OUR projection. INV-2 lives here: an exposure moves this map and nothing in `bandit`. */
+    readonly exposures: Record<string, Record<string, number>>;
+    /** OUR projection (ADR-003 §4) — trial impressions, kept separate from confirmed reward. */
+    readonly explorePulls: Record<string, Record<string, number>>;
+    readonly updatedAt: string;
+}
+export type BanditLoadReason = 'absent' | 'future-schema' | 'malformed' | `corrupt: ${string}`;
+export declare function freshBanditEnvelope(now?: string): BanditStateEnvelope;
+/**
+ * Read the state envelope. **Never throws** (INV-7): every failure yields a FRESH empty envelope
+ * plus an honest `reason`, and recall proceeds with no payoff axis.
+ *
+ * This function is READ-ONLY — it does not delete, repair, or rename anything. `dz recall` is not
+ * the right process to destroy state, and the read path is lock-free (§7.4), so a rename here would
+ * race every concurrent recall. Quarantining a corrupt file happens once, inside the WRITE
+ * transaction, where a write is expected and the lock is held (see {@link mutateBanditState}).
+ */
+export declare function loadBanditState(projectRoot: string): {
+    readonly state: BanditStateEnvelope;
+    readonly reason?: BanditLoadReason;
+};
+export interface BanditWriteOutcome {
+    readonly ok: boolean;
+    readonly reason?: string;
+}
+/**
+ * Record a genuine confirmation (ADR-001 D-5). This is the ONLY operation that moves reward mass.
+ * Called from `reinforcePattern`'s non-exposure branch, AFTER the store lock is released.
+ */
+export declare function recordReward(projectRoot: string, event: RewardEvent): BanditWriteOutcome;
+/**
+ * Record that lessons were merely SEEN (INV-2 / AC-2).
+ *
+ * ONE locked transaction per RECALL, not per hit (architecture §4) — `limit` transactions per recall
+ * would hold the lock far more often than the work justifies.
+ *
+ * **No engine call happens here, at any reward value, including `0`.** `recordReward(ctx, arm, 0)`
+ * adds `beta += 1`: it is evidence the lesson FAILED. Penalising a lesson for being read is the
+ * mirror image of the promote-by-view defect this invariant exists to prevent.
+ *
+ * `exploredDzIds` are the arms that received a trial lift on this recall (ADR-003 §4) — counted in
+ * their own projection, never in `alpha`/`beta`, and never touching `qStatus`.
+ */
+export declare function recordExposures(projectRoot: string, events: readonly ExposureEvent[], exploredDzIds?: readonly string[], meta?: {
+    readonly moved?: number;
+    readonly arms?: number;
+}): BanditWriteOutcome;
+export interface PayoffTerms {
+    /** Keyed by `dzId`. An arm absent from `armKeys` is NEVER present here (INV-4 / AC-4). */
+    readonly terms: ReadonlyMap<string, PayoffTerm>;
+    /** `null` when the state loaded cleanly; otherwise the honest degradation reason (§10). */
+    readonly reason: BanditLoadReason | null;
+    /** Arms with `pulls === 0` — "no measured payoff yet". */
+    readonly unknownArms: number;
+    /** Arms that received a trial lift on this call (0 unless exploration is armed). */
+    readonly explored: readonly string[];
+    /** The ids behind `unknownArms`, so a downstream cut can narrow that counter too. */
+    readonly unknownDzIds: readonly string[];
+}
+/**
+ * Project the posterior for each arm into a bounded term (ADR-001 D-2). **Lock-free** (§7.4): the
+ * writer's final step is a rename, so a reader sees the whole old document or the whole new one,
+ * never a partial; a reader that loses the race by microseconds ranks with a state one reward stale,
+ * which is a ranking hint, not a fact.
+ *
+ * ```
+ * term = (alpha/(alpha+beta) - 0.5) * 2   ∈ [-1,+1]     when pulls > 0   ('posterior')
+ * term = 0                                              when pulls === 0 ('unknown-arm')
+ * ```
+ * `pulls === 0 ⇒ 0` is the cold start ADR-001 accepts on purpose: no evidence ⇒ no nudge, and
+ * crucially no RANDOM lift. `Math.random()` is reached only when `opts.exploration` is true, and
+ * then only for a NON-QUARANTINED zero-pull arm (ADR-003 P5/P6) — quarantined lessons are excluded
+ * here as a SET RELATION, in addition to the ranker's own arm-list filter upstream.
+ *
+ * Never throws (NFR-5): any failure yields an empty map plus a reason.
+ */
+export declare function payoffTermsFor(projectRoot: string, contextKey: string, armKeys: readonly string[], opts?: {
+    readonly exploration?: boolean;
+    readonly quarantined?: ReadonlySet<string>;
+    readonly rng?: () => number;
+}): PayoffTerms;
+/**
+ * The per-query explanation carried on `HybridRecall` when the feature is armed. When disarmed the
+ * whole field is ABSENT (not `null`, not `{}`) — its mere presence tells a reader the feature ran.
+ */
+export interface BanditRecallReport {
+    readonly contextKey: string;
+    /** POST-cut count: exactly the arms that were reordered and survived to the caller (FR-8/AC-11). */
+    readonly armsConsidered: number;
+    /** Arms filtered out before the engine ever saw them (INV-3). */
+    readonly quarantinedExcluded: number;
+    /** `pulls === 0` — no measured payoff yet. */
+    readonly unknownArms: number;
+    /** Candidates whose position changed against the same ranking WITHOUT the bandit term. */
+    readonly moved: number;
+    /** Exploration state and how many arms received a trial lift (ADR-003 D5 — a stochastic ranking
+     * is never presented as a deterministic one). */
+    readonly exploration: boolean;
+    readonly explored: number;
+    readonly reason: BanditLoadReason | null;
+    /** The POST-cut arm ids, so a further truncation downstream can narrow this report honestly. */
+    readonly armDzIds: readonly string[];
+    readonly movedDzIds: readonly string[];
+    /** Ids behind `unknownArms` and `explored`, so a downstream cut narrows EVERY list-dependent
+     * counter, not just two of four. */
+    readonly unknownDzIds: readonly string[];
+    readonly exploredDzIds: readonly string[];
+    /** The two rankings `moved` was derived from. Kept because `moved` cannot be narrowed by
+     * intersection: whether a SURVIVING candidate still changed position is a fact about the order
+     * AFTER the dropped candidates are removed, and only a recomputation can answer it. */
+    readonly beforeOrder: readonly string[];
+    readonly afterOrder: readonly string[];
+}
+/**
+ * Narrow a report to the hits a caller actually PRINTED. `dz recall` over-fetches under `--domain`
+ * and truncates again, so the un-narrowed count would describe a PRE-cut list the reader never saw —
+ * the exact dishonesty FR-8/AC-11 names.
+ */
+export declare function narrowBanditReport(report: BanditRecallReport, shownDzIds: readonly string[]): BanditRecallReport;
+export interface BanditHealth {
+    readonly present: boolean;
+    readonly verdict: 'INSUFFICIENT_DATA' | 'OK';
+    readonly reason: BanditLoadReason | null;
+    readonly updatedAt: string | null;
+    readonly contexts: number;
+    readonly armsTotal: number;
+    /** Arms with ANY measured payoff (`alpha > 1`). Zero means the payoff axis is empty. */
+    readonly armsWithReward: number;
+    readonly totalPulls: number;
+    readonly totalReward: number;
+    readonly exposureTotal: number;
+    readonly explorePullTotal: number;
+    readonly rewardEvents: number;
+    readonly exposureEvents: number;
+    readonly banditWriteErrors: number;
+    /** Mean `moved / armsConsidered` over logged recalls; `null` when nothing was logged. */
+    readonly movedRate: number | null;
+}
+/** Read-only health snapshot from the state file + `sessions.jsonl`. Never throws. */
+export declare function banditStats(projectRoot: string): BanditHealth;
+/** Text rendering of {@link banditStats} for `dz compounding`. Pure. */
+export declare function renderBanditHealth(h: BanditHealth): string;
+//# sourceMappingURL=lesson-payoff.d.ts.map

package/dist/lesson-payoff.d.ts.map

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