instar 1.3.131 → 1.3.133

package/dist/monitoring/CorrectionLedger.d.ts

@@ -0,0 +1,149 @@
+/** The distilled kind. Validated against this allow-list — the LLM cannot widen it. */
+export type CorrectionKind = 'infra-gap' | 'user-preference' | 'noise';
+export type CorrectionStatus = 'open' | 'acted-on' | 'verified' | 'inconclusive' | 'reopened';
+export interface CorrectionRecord {
+    id: string;
+    dedupeKey: string;
+    kind: CorrectionKind;
+    occurrenceCount: number;
+    detectedAt: string;
+    /** Post-scrubbed distilled lesson. INTERNAL-ONLY — never crosses HTTP. */
+    learning: string;
+    /** Post-scrubbed one-line summary. The ONLY text the API serves. */
+    scrubbedSummary: string;
+    /** UTC date bucket (YYYY-MM-DD), code-derived from detectedAt. */
+    dayBucket: string;
+    /** Layer-0 total weight at record time — the code-determined provenance. */
+    deterministicWeight: number;
+    /** LLM-assigned confidence [0,1] — ADVISORY, never alone admits a record. */
+    llmConfidence: number;
+    topicId: number | null;
+    sessionId: string | null;
+    /** Lifecycle */
+    status: CorrectionStatus;
+    routedVia?: string;
+    verifyWindowStart?: string;
+    verifyWindowEnd?: string;
+    reopenCount: number;
+    createdAt: string;
+    updatedAt: string;
+    version: number;
+}
+/** The shape served over HTTP — `learning` stripped, only scrubbed_summary + metadata. */
+export interface CorrectionRecordApiView {
+    id: string;
+    dedupeKey: string;
+    kind: CorrectionKind;
+    occurrenceCount: number;
+    detectedAt: string;
+    scrubbedSummary: string;
+    dayBucket: string;
+    deterministicWeight: number;
+    llmConfidence: number;
+    topicId: number | null;
+    status: CorrectionStatus;
+    routedVia?: string;
+    verifyWindowStart?: string;
+    verifyWindowEnd?: string;
+    reopenCount: number;
+    createdAt: string;
+    updatedAt: string;
+    version: number;
+}
+export interface RecordCorrectionInput {
+    kind: CorrectionKind;
+    learning: string;
+    scrubbedSummary: string;
+    deterministicWeight: number;
+    llmConfidence?: number;
+    topicId?: number | null;
+    sessionId?: string | null;
+    detectedAt?: string;
+}
+export interface ListCorrectionFilter {
+    kind?: CorrectionKind;
+    status?: CorrectionStatus;
+    sinceMs?: number;
+    /** Upper-bound (exclusive): detected_at < beforeMs (keyset pagination). */
+    beforeMs?: number;
+    limit?: number;
+}
+export type CorrectionUpdateResult = {
+    ok: true;
+    record: CorrectionRecord;
+} | {
+    ok: false;
+    conflict: true;
+    current?: CorrectionRecord;
+} | {
+    ok: false;
+    conflict: false;
+    reason: string;
+};
+export interface CorrectionLedgerOptions {
+    dbPath: string;
+    machineId?: string;
+    onError?: (where: string, err: unknown) => void;
+    /** Cap on forensic occurrence rows per dedupeKey (default 200). */
+    maxOccurrencesPerKey?: number;
+}
+/** Default forensic-log retention per dedupeKey (mirrors FailureLedger §5). */
+export declare const DEFAULT_MAX_OCCURRENCES_PER_KEY = 200;
+export declare class CorrectionLedger {
+    private db;
+    private readonly machineId;
+    private readonly onError;
+    private readonly maxOccurrencesPerKey;
+    constructor(opts: CorrectionLedgerOptions);
+    /**
+     * Canonical normalization of a distilled learning before hashing: lowercase,
+     * strip punctuation, collapse whitespace, drop stop-words, sort the remaining
+     * tokens. Two semantically-identical learnings phrased differently collapse to
+     * the SAME hash. Stability is a unit-tested invariant (spec §3.4).
+     */
+    static normalizeLearning(learning: string): string;
+    /** SHA-256 over the canonical normalized form. */
+    static normalizedLearningHash(learning: string): string;
+    /** Deterministic dedupe key: `kind:normalizedLearningHash` (spec §3.4). */
+    static dedupeKey(kind: CorrectionKind, learning: string): string;
+    /** UTC day bucket (YYYY-MM-DD), code-derived from an ISO timestamp. */
+    static dayBucketOf(isoOrMs: string | number): string;
+    private nextId;
+    /**
+     * Record (or upsert) a distilled correction. A repeat on the same dedupeKey
+     * increments occurrenceCount + logs a distinct occurrence (feeds the
+     * distinct-day / distinct-topic gates) rather than duplicating. Fail-open:
+     * returns null on any storage error.
+     */
+    record(input: RecordCorrectionInput): CorrectionRecord | null;
+    get(id: string): CorrectionRecord | null;
+    getByDedupeKey(dedupeKey: string): CorrectionRecord | null;
+    list(filter?: ListCorrectionFilter): CorrectionRecord[];
+    /**
+     * Mutate a record's lifecycle. `ifMatch` is mandatory (OCC) — a stale version
+     * loses with {ok:false, conflict:true}.
+     */
+    update(id: string, patch: Partial<Pick<CorrectionRecord, 'status' | 'routedVia' | 'verifyWindowStart' | 'verifyWindowEnd' | 'reopenCount'>>, ifMatch: number): CorrectionUpdateResult;
+    /**
+     * Distinct calendar days + distinct topics for the recurrence gate (spec §3.5).
+     * Computed from the bounded occurrences table. Restart-proof (keys on UTC
+     * day_bucket, NOT a session count instar's frequent restarts would inflate).
+     * `qualifying` only counts occurrences whose deterministic_weight ≥ threshold
+     * (the code-determined provenance filter — an LLM-only-confident occurrence
+     * never alone admits a record to the gate).
+     */
+    distinctCounts(dedupeKey: string, weightThreshold?: number): {
+        distinctDays: number;
+        distinctTopics: number;
+        qualifyingOccurrences: number;
+    };
+    /** Total deduped record count — health metric for distinct-key growth (spec §3.4). */
+    countRecords(): number;
+    /** Raw forensic-log row count (observability + retention-cap test hook). */
+    countOccurrences(dedupeKey?: string): number;
+    /** Strip `learning` (raw distilled text) — the ONLY shape allowed over HTTP (spec §3.4). */
+    static toApiView(record: CorrectionRecord): CorrectionRecordApiView;
+    close(): void;
+    private rowToRecord;
+}
+//# sourceMappingURL=CorrectionLedger.d.ts.map

package/dist/monitoring/CorrectionLedger.d.ts.map

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

package/dist/monitoring/CorrectionLedger.js

@@ -0,0 +1,386 @@
+/**
+ * CorrectionLedger — distilled, scrubbed correction/preference records (spec §3.4).
+ *
+ * The conversational twin of FailureLedger. Where that ledger stores dev-process
+ * failures, this stores the LESSON distilled from a moment the user had to
+ * correct the agent — privacy-safe: ONLY the post-scrubbed `learning` +
+ * `scrubbed_summary` + metadata ever land here. Raw conversation never persists.
+ *
+ * Mirrors FailureLedger's discipline (spec §3.4):
+ *  - dedupe-upsert keyed on `kind:normalizedLearningHash` so a recurring lesson
+ *    collapses to ONE record (occurrenceCount increments) — message volume can
+ *    never manufacture support.
+ *  - `correction_occurrences` is a bounded forensic log (DEFAULT_MAX_OCCURRENCES_
+ *    PER_KEY = 200, prune-in-transaction with the insert). The analyzer's
+ *    distinct-day / distinct-topic counts are computed from this bounded table.
+ *  - indexes idx_corr_dedupe + idx_corr_detected (explicitly required).
+ *  - toApiView() strips everything but scrubbed_summary + metadata — the
+ *    /corrections API never serves raw `learning` text.
+ *  - countRecords() health metric so distinct-key growth (an unstable-hash LLM)
+ *    is observable.
+ *  - fail-open: a write error logs + drops; it never throws back into the
+ *    capture/distill seam (which must keep its fire-and-forget contract).
+ *
+ * dayBucket is UTC, CODE-derived (never LLM-set). deterministicWeight is the
+ * Layer-0 total weight, CODE-set — it is the provenance field the analyzer's
+ * gate keys on (spec §3.5). llm_confidence is LLM-set + advisory only.
+ */
+import Database from 'better-sqlite3';
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { NativeModuleHealer } from '../memory/NativeModuleHealer.js';
+/** Default forensic-log retention per dedupeKey (mirrors FailureLedger §5). */
+export const DEFAULT_MAX_OCCURRENCES_PER_KEY = 200;
+/**
+ * Stop-words stripped before hashing so semantically-identical learnings phrased
+ * differently collapse to ONE dedupeKey. Conservative + deterministic — the hash
+ * stability is a unit-tested invariant.
+ */
+const STOP_WORDS = new Set([
+    'a', 'an', 'the', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+    'to', 'of', 'in', 'on', 'for', 'with', 'and', 'or', 'but', 'i', 'you',
+    'me', 'my', 'your', 'it', 'this', 'that', 'please', 'just', 'always',
+    'when', 'do', "don't", 'dont', "i'd", 'id', 'would', 'should', 'so',
+    'at', 'by', 'as', 'from', 'into', 'about', 'prefer', 'rather',
+]);
+// ── Schema ────────────────────────────────────────────────────────────
+const SCHEMA = [
+    `CREATE TABLE IF NOT EXISTS correction_records (
+     id                   TEXT PRIMARY KEY,
+     dedupe_key           TEXT NOT NULL UNIQUE,
+     kind                 TEXT NOT NULL,
+     occurrence_count     INTEGER NOT NULL DEFAULT 1,
+     detected_at          TEXT NOT NULL,
+     learning             TEXT NOT NULL DEFAULT '',
+     scrubbed_summary     TEXT NOT NULL DEFAULT '',
+     day_bucket           TEXT NOT NULL,
+     deterministic_weight INTEGER NOT NULL DEFAULT 0,
+     llm_confidence       REAL NOT NULL DEFAULT 0,
+     topic_id             INTEGER,
+     session_id           TEXT,
+     status               TEXT NOT NULL DEFAULT 'open',
+     routed_via           TEXT,
+     verify_window_start  TEXT,
+     verify_window_end    TEXT,
+     reopen_count         INTEGER NOT NULL DEFAULT 0,
+     created_at           TEXT NOT NULL,
+     updated_at           TEXT NOT NULL,
+     version              INTEGER NOT NULL DEFAULT 1
+   )`,
+    // Detected-at index for the analyzer's windowed scan + keyset pagination.
+    `CREATE INDEX IF NOT EXISTS idx_corr_detected ON correction_records(detected_at)`,
+    // Bounded forensic log — feeds COUNT(DISTINCT day_bucket / topic_id) for the
+    // analyzer's diversity prongs without growing an unbounded set on the record.
+    `CREATE TABLE IF NOT EXISTS correction_occurrences (
+     id            INTEGER PRIMARY KEY AUTOINCREMENT,
+     dedupe_key    TEXT NOT NULL,
+     day_bucket    TEXT NOT NULL,
+     topic_id      INTEGER,
+     deterministic_weight INTEGER NOT NULL DEFAULT 0,
+     detected_at   TEXT NOT NULL
+   )`,
+    `CREATE INDEX IF NOT EXISTS idx_corr_dedupe ON correction_occurrences(dedupe_key)`,
+    // Per-machine monotonic sequence for machine-scoped IDs.
+    `CREATE TABLE IF NOT EXISTS correction_seq (
+     machine_id TEXT PRIMARY KEY,
+     next_seq   INTEGER NOT NULL DEFAULT 1
+   )`,
+];
+// ── CorrectionLedger ──────────────────────────────────────────────────
+export class CorrectionLedger {
+    db;
+    machineId;
+    onError;
+    maxOccurrencesPerKey;
+    constructor(opts) {
+        this.machineId = (opts.machineId || os.hostname() || 'local')
+            .replace(/[^a-zA-Z0-9]+/g, '-')
+            .replace(/^-+|-+$/g, '')
+            .slice(0, 24) || 'local';
+        this.maxOccurrencesPerKey =
+            opts.maxOccurrencesPerKey && opts.maxOccurrencesPerKey > 0
+                ? opts.maxOccurrencesPerKey
+                : DEFAULT_MAX_OCCURRENCES_PER_KEY;
+        this.onError =
+            opts.onError ?? ((where, err) => console.error(`[CorrectionLedger] ${where}:`, err));
+        if (opts.dbPath !== ':memory:') {
+            fs.mkdirSync(path.dirname(opts.dbPath), { recursive: true });
+        }
+        this.db = NativeModuleHealer.openWithHealSync('CorrectionLedger', () => new Database(opts.dbPath));
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('synchronous = NORMAL');
+        for (const ddl of SCHEMA)
+            this.db.exec(ddl);
+    }
+    /**
+     * Canonical normalization of a distilled learning before hashing: lowercase,
+     * strip punctuation, collapse whitespace, drop stop-words, sort the remaining
+     * tokens. Two semantically-identical learnings phrased differently collapse to
+     * the SAME hash. Stability is a unit-tested invariant (spec §3.4).
+     */
+    static normalizeLearning(learning) {
+        const tokens = String(learning)
+            .toLowerCase()
+            .replace(/[^a-z0-9\s']/g, ' ')
+            .split(/\s+/)
+            .map((t) => t.trim())
+            .filter((t) => t.length > 0 && !STOP_WORDS.has(t));
+        return tokens.sort().join(' ');
+    }
+    /** SHA-256 over the canonical normalized form. */
+    static normalizedLearningHash(learning) {
+        return crypto.createHash('sha256').update(CorrectionLedger.normalizeLearning(learning)).digest('hex');
+    }
+    /** Deterministic dedupe key: `kind:normalizedLearningHash` (spec §3.4). */
+    static dedupeKey(kind, learning) {
+        return `${kind}:${CorrectionLedger.normalizedLearningHash(learning)}`;
+    }
+    /** UTC day bucket (YYYY-MM-DD), code-derived from an ISO timestamp. */
+    static dayBucketOf(isoOrMs) {
+        const d = typeof isoOrMs === 'number' ? new Date(isoOrMs) : new Date(isoOrMs);
+        return d.toISOString().slice(0, 10);
+    }
+    nextId() {
+        const row = this.db
+            .prepare(`SELECT next_seq FROM correction_seq WHERE machine_id = ?`)
+            .get(this.machineId);
+        const seq = row?.next_seq ?? 1;
+        this.db
+            .prepare(`INSERT INTO correction_seq (machine_id, next_seq) VALUES (?, ?)
+         ON CONFLICT(machine_id) DO UPDATE SET next_seq = ?`)
+            .run(this.machineId, seq + 1, seq + 1);
+        return `CORR-${this.machineId}-${String(seq).padStart(3, '0')}`;
+    }
+    /**
+     * Record (or upsert) a distilled correction. A repeat on the same dedupeKey
+     * increments occurrenceCount + logs a distinct occurrence (feeds the
+     * distinct-day / distinct-topic gates) rather than duplicating. Fail-open:
+     * returns null on any storage error.
+     */
+    record(input) {
+        try {
+            const dedupeKey = CorrectionLedger.dedupeKey(input.kind, input.learning);
+            const now = new Date().toISOString();
+            const detectedAt = input.detectedAt ?? now;
+            const dayBucket = CorrectionLedger.dayBucketOf(detectedAt);
+            const llmConfidence = clamp01(input.llmConfidence);
+            const txn = this.db.transaction(() => {
+                // Always log the occurrence (feeds COUNT(DISTINCT) diversity prongs).
+                this.db
+                    .prepare(`INSERT INTO correction_occurrences (dedupe_key, day_bucket, topic_id, deterministic_weight, detected_at)
+             VALUES (?, ?, ?, ?, ?)`)
+                    .run(dedupeKey, dayBucket, input.topicId ?? null, input.deterministicWeight, detectedAt);
+                // Bounded forensic log — prune occurrence rows for this key beyond the
+                // most-recent N. Safe: the analyzer's distinct counts are also bounded
+                // by N, so pruning cannot change a decision (worst case it UNDERcounts,
+                // the safe direction — biases toward NOT firing).
+                this.db
+                    .prepare(`DELETE FROM correction_occurrences
+              WHERE dedupe_key = @dedupeKey
+                AND id NOT IN (
+                  SELECT id FROM correction_occurrences
+                   WHERE dedupe_key = @dedupeKey
+                   ORDER BY id DESC LIMIT @keep)`)
+                    .run({ dedupeKey, keep: this.maxOccurrencesPerKey });
+                const id = this.nextId();
+                const row = this.db
+                    .prepare(`INSERT INTO correction_records
+               (id, dedupe_key, kind, occurrence_count, detected_at, learning, scrubbed_summary,
+                day_bucket, deterministic_weight, llm_confidence, topic_id, session_id,
+                status, reopen_count, created_at, updated_at, version)
+             VALUES
+               (@id, @dedupeKey, @kind, 1, @detectedAt, @learning, @scrubbedSummary,
+                @dayBucket, @deterministicWeight, @llmConfidence, @topicId, @sessionId,
+                'open', 0, @createdAt, @updatedAt, 1)
+             ON CONFLICT(dedupe_key) DO UPDATE SET
+               occurrence_count = occurrence_count + 1,
+               detected_at = excluded.detected_at,
+               day_bucket = excluded.day_bucket,
+               -- keep the strongest deterministic weight seen for this key
+               deterministic_weight = MAX(deterministic_weight, excluded.deterministic_weight),
+               -- advisory: take the max confidence seen
+               llm_confidence = MAX(llm_confidence, excluded.llm_confidence),
+               updated_at = excluded.updated_at,
+               version = version + 1
+             RETURNING id`)
+                    .get({
+                    id,
+                    dedupeKey,
+                    kind: input.kind,
+                    detectedAt,
+                    learning: input.learning,
+                    scrubbedSummary: input.scrubbedSummary,
+                    dayBucket,
+                    deterministicWeight: input.deterministicWeight,
+                    llmConfidence,
+                    topicId: input.topicId ?? null,
+                    sessionId: input.sessionId ?? null,
+                    createdAt: now,
+                    updatedAt: now,
+                });
+                return row.id;
+            });
+            const id = txn();
+            return this.get(id);
+        }
+        catch (err) {
+            this.onError('record', err);
+            return null;
+        }
+    }
+    get(id) {
+        const row = this.db.prepare(`SELECT * FROM correction_records WHERE id = ?`).get(id);
+        return row ? this.rowToRecord(row) : null;
+    }
+    getByDedupeKey(dedupeKey) {
+        const row = this.db.prepare(`SELECT * FROM correction_records WHERE dedupe_key = ?`).get(dedupeKey);
+        return row ? this.rowToRecord(row) : null;
+    }
+    list(filter = {}) {
+        const where = [];
+        const params = {};
+        if (filter.kind) {
+            where.push('kind = @kind');
+            params.kind = filter.kind;
+        }
+        if (filter.status) {
+            where.push('status = @status');
+            params.status = filter.status;
+        }
+        if (filter.sinceMs) {
+            where.push('detected_at >= @since');
+            params.since = new Date(filter.sinceMs).toISOString();
+        }
+        if (filter.beforeMs) {
+            where.push('detected_at < @before');
+            params.before = new Date(filter.beforeMs).toISOString();
+        }
+        const limit = filter.limit && filter.limit > 0 ? Math.min(filter.limit, 1000) : 100;
+        const sql = `SELECT * FROM correction_records` +
+            (where.length ? ` WHERE ${where.join(' AND ')}` : '') +
+            ` ORDER BY detected_at DESC LIMIT ${limit}`;
+        return this.db.prepare(sql).all(params).map((r) => this.rowToRecord(r));
+    }
+    /**
+     * Mutate a record's lifecycle. `ifMatch` is mandatory (OCC) — a stale version
+     * loses with {ok:false, conflict:true}.
+     */
+    update(id, patch, ifMatch) {
+        try {
+            const current = this.get(id);
+            if (!current)
+                return { ok: false, conflict: false, reason: 'not-found' };
+            if (current.version !== ifMatch)
+                return { ok: false, conflict: true, current };
+            const map = {
+                status: 'status', routedVia: 'routed_via', verifyWindowStart: 'verify_window_start',
+                verifyWindowEnd: 'verify_window_end', reopenCount: 'reopen_count',
+            };
+            const cols = [];
+            const params = { id, ifMatch };
+            for (const [k, v] of Object.entries(patch)) {
+                const col = map[k];
+                if (!col)
+                    continue;
+                cols.push(`${col} = @${k}`);
+                params[k] = v ?? null;
+            }
+            if (cols.length === 0)
+                return { ok: true, record: current };
+            const now = new Date().toISOString();
+            const res = this.db
+                .prepare(`UPDATE correction_records SET ${cols.join(', ')}, updated_at = @now, version = version + 1 WHERE id = @id AND version = @ifMatch`)
+                .run({ ...params, now });
+            if (res.changes === 0)
+                return { ok: false, conflict: true, current: this.get(id) ?? undefined };
+            return { ok: true, record: this.get(id) };
+        }
+        catch (err) {
+            this.onError('update', err);
+            return { ok: false, conflict: false, reason: 'storage-error' };
+        }
+    }
+    /**
+     * Distinct calendar days + distinct topics for the recurrence gate (spec §3.5).
+     * Computed from the bounded occurrences table. Restart-proof (keys on UTC
+     * day_bucket, NOT a session count instar's frequent restarts would inflate).
+     * `qualifying` only counts occurrences whose deterministic_weight ≥ threshold
+     * (the code-determined provenance filter — an LLM-only-confident occurrence
+     * never alone admits a record to the gate).
+     */
+    distinctCounts(dedupeKey, weightThreshold = 0) {
+        const row = this.db
+            .prepare(`SELECT COUNT(DISTINCT day_bucket) AS days,
+                COUNT(DISTINCT topic_id)  AS topics,
+                COUNT(*)                  AS occ
+           FROM correction_occurrences
+          WHERE dedupe_key = @dedupeKey AND deterministic_weight >= @threshold`)
+            .get({ dedupeKey, threshold: weightThreshold });
+        return {
+            distinctDays: row?.days ?? 0,
+            distinctTopics: row?.topics ?? 0,
+            qualifyingOccurrences: row?.occ ?? 0,
+        };
+    }
+    /** Total deduped record count — health metric for distinct-key growth (spec §3.4). */
+    countRecords() {
+        const row = this.db.prepare(`SELECT COUNT(*) c FROM correction_records`).get();
+        return row?.c ?? 0;
+    }
+    /** Raw forensic-log row count (observability + retention-cap test hook). */
+    countOccurrences(dedupeKey) {
+        const row = dedupeKey
+            ? this.db.prepare(`SELECT COUNT(*) c FROM correction_occurrences WHERE dedupe_key = ?`).get(dedupeKey)
+            : this.db.prepare(`SELECT COUNT(*) c FROM correction_occurrences`).get();
+        return (row?.c) ?? 0;
+    }
+    /** Strip `learning` (raw distilled text) — the ONLY shape allowed over HTTP (spec §3.4). */
+    static toApiView(record) {
+        const { learning: _internalLearning, sessionId: _internalSession, ...rest } = record;
+        void _internalLearning;
+        void _internalSession;
+        return { ...rest };
+    }
+    close() {
+        try {
+            this.db.close();
+        }
+        catch { /* ignore */ }
+    }
+    rowToRecord(r) {
+        return {
+            id: r.id,
+            dedupeKey: r.dedupe_key,
+            kind: r.kind,
+            occurrenceCount: r.occurrence_count,
+            detectedAt: r.detected_at,
+            learning: r.learning ?? '',
+            scrubbedSummary: r.scrubbed_summary ?? '',
+            dayBucket: r.day_bucket,
+            deterministicWeight: r.deterministic_weight,
+            llmConfidence: r.llm_confidence,
+            topicId: r.topic_id ?? null,
+            sessionId: r.session_id ?? null,
+            status: r.status,
+            routedVia: r.routed_via ?? undefined,
+            verifyWindowStart: r.verify_window_start ?? undefined,
+            verifyWindowEnd: r.verify_window_end ?? undefined,
+            reopenCount: r.reopen_count,
+            createdAt: r.created_at,
+            updatedAt: r.updated_at,
+            version: r.version,
+        };
+    }
+}
+function clamp01(v) {
+    if (typeof v !== 'number' || Number.isNaN(v))
+        return 0;
+    if (v < 0)
+        return 0;
+    if (v > 1)
+        return 1;
+    return v;
+}
+//# sourceMappingURL=CorrectionLedger.js.map

package/dist/monitoring/CorrectionLedger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CorrectionLedger.js","sourceRoot":"","sources":["../../src/monitoring/CorrectionLedger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAkGrE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO;IACnE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK;IACrE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ;IACpE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI;IACnE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ;CAC9D,CAAC,CAAC;AAEH,yEAAyE;AAEzE,MAAM,MAAM,GAAG;IACb;;;;;;;;;;;;;;;;;;;;;KAqBG;IACH,0EAA0E;IAC1E,iFAAiF;IACjF,6EAA6E;IAC7E,8EAA8E;IAC9E;;;;;;;KAOG;IACH,kFAAkF;IAClF,yDAAyD;IACzD;;;KAGG;CACJ,CAAC;AAEF,yEAAyE;AAEzE,MAAM,OAAO,gBAAgB;IACnB,EAAE,CAAuB;IAChB,SAAS,CAAS;IAClB,OAAO,CAAwC;IAC/C,oBAAoB,CAAS;IAE9C,YAAY,IAA6B;QACvC,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,QAAQ,EAAE,IAAI,OAAO,CAAC;aAC1D,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;aAC9B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;aACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC;QAC3B,IAAI,CAAC,oBAAoB;YACvB,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,oBAAoB,GAAG,CAAC;gBACxD,CAAC,CAAC,IAAI,CAAC,oBAAoB;gBAC3B,CAAC,CAAC,+BAA+B,CAAC;QACtC,IAAI,CAAC,OAAO;YACV,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,sBAAsB,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAEvF,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC/B,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,EAAE,GAAG,kBAAkB,CAAC,gBAAgB,CAC3C,kBAAkB,EAClB,GAAG,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAChC,CAAC;QACF,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;QACvC,KAAK,MAAM,GAAG,IAAI,MAAM;YAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAgB;QACvC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC;aAC5B,WAAW,EAAE;aACb,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC;aAC7B,KAAK,CAAC,KAAK,CAAC;aACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,kDAAkD;IAClD,MAAM,CAAC,sBAAsB,CAAC,QAAgB;QAC5C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxG,CAAC;IAED,2EAA2E;IAC3E,MAAM,CAAC,SAAS,CAAC,IAAoB,EAAE,QAAgB;QACrD,OAAO,GAAG,IAAI,IAAI,gBAAgB,CAAC,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC;IACxE,CAAC;IAED,uEAAuE;IACvE,MAAM,CAAC,WAAW,CAAC,OAAwB;QACzC,MAAM,CAAC,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9E,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtC,CAAC;IAEO,MAAM;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CAAC,0DAA0D,CAAC;aACnE,GAAG,CAAC,IAAI,CAAC,SAAS,CAAqC,CAAC;QAC3D,MAAM,GAAG,GAAG,GAAG,EAAE,QAAQ,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;4DACoD,CACrD;aACA,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QACzC,OAAO,QAAQ,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAClE,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAA4B;QACjC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YACzE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC;YAC3C,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YAC3D,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAEnD,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;gBACnC,sEAAsE;gBACtE,IAAI,CAAC,EAAE;qBACJ,OAAO,CACN;oCACwB,CACzB;qBACA,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,KAAK,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;gBAE3F,uEAAuE;gBACvE,uEAAuE;gBACvE,wEAAwE;gBACxE,kDAAkD;gBAClD,IAAI,CAAC,EAAE;qBACJ,OAAO,CACN;;;;;iDAKqC,CACtC;qBACA,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;gBAEvD,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;qBAChB,OAAO,CACN;;;;;;;;;;;;;;;;;;0BAkBc,CACf;qBACA,GAAG,CAAC;oBACH,EAAE;oBACF,SAAS;oBACT,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,UAAU;oBACV,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,eAAe,EAAE,KAAK,CAAC,eAAe;oBACtC,SAAS;oBACT,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;oBAC9C,aAAa;oBACb,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;oBAC9B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;oBAClC,SAAS,EAAE,GAAG;oBACd,SAAS,EAAE,GAAG;iBACf,CAAmB,CAAC;gBACvB,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,CAAC,CAAC,CAAC;YAEH,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,+CAA+C,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrF,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAA8B,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,CAAC;IAED,cAAc,CAAC,SAAiB;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,uDAAuD,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpG,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAA8B,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,CAAC;IAED,IAAI,CAAC,SAA+B,EAAE;QACpC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAAC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QAAC,CAAC;QAC3E,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAAC,CAAC;QACrF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YAAC,MAAM,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAAC,CAAC;QACnH,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YAAC,MAAM,CAAC,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAAC,CAAC;QACtH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACpF,MAAM,GAAG,GACP,kCAAkC;YAClC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,oCAAoC,KAAK,EAAE,CAAC;QAC9C,OAAQ,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAA+B,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACzG,CAAC;IAED;;;OAGG;IACH,MAAM,CACJ,EAAU,EACV,KAAwH,EACxH,OAAe;QAEf,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7B,IAAI,CAAC,OAAO;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YACzE,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAC/E,MAAM,GAAG,GAA2B;gBAClC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB;gBACnF,eAAe,EAAE,mBAAmB,EAAE,WAAW,EAAE,cAAc;aAClE,CAAC;YACF,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,MAAM,MAAM,GAA4B,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;YACxD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;gBAAC,IAAI,CAAC,GAAG;oBAAE,SAAS;gBACvC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC5B,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;YACxB,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC5D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;iBAChB,OAAO,CAAC,iCAAiC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,kFAAkF,CAAC;iBAC3I,GAAG,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YAC3B,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;YAChG,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAE,EAAE,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;QACjE,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,SAAiB,EAAE,eAAe,GAAG,CAAC;QAKnD,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CACN;;;;+EAIuE,CACxE;aACA,GAAG,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,CAA8D,CAAC;QAC/G,OAAO;YACL,YAAY,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC;YAC5B,cAAc,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC;YAChC,qBAAqB,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;SACrC,CAAC;IACJ,CAAC;IAED,sFAAsF;IACtF,YAAY;QACV,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC,GAAG,EAA+B,CAAC;QAC5G,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,4EAA4E;IAC5E,gBAAgB,CAAC,SAAkB;QACjC,MAAM,GAAG,GAAG,SAAS;YACnB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,oEAAoE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;YACtG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,+CAA+C,CAAC,CAAC,GAAG,EAAE,CAAC;QAC3E,OAAO,CAAE,GAAiC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,4FAA4F;IAC5F,MAAM,CAAC,SAAS,CAAC,MAAwB;QACvC,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACrF,KAAK,iBAAiB,CAAC;QAAC,KAAK,gBAAgB,CAAC;QAC9C,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,KAAK;QACH,IAAI,CAAC;YAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACjD,CAAC;IAEO,WAAW,CAAC,CAA0B;QAC5C,OAAO;YACL,EAAE,EAAE,CAAC,CAAC,EAAY;YAClB,SAAS,EAAE,CAAC,CAAC,UAAoB;YACjC,IAAI,EAAE,CAAC,CAAC,IAAsB;YAC9B,eAAe,EAAE,CAAC,CAAC,gBAA0B;YAC7C,UAAU,EAAE,CAAC,CAAC,WAAqB;YACnC,QAAQ,EAAG,CAAC,CAAC,QAAmB,IAAI,EAAE;YACtC,eAAe,EAAG,CAAC,CAAC,gBAA2B,IAAI,EAAE;YACrD,SAAS,EAAE,CAAC,CAAC,UAAoB;YACjC,mBAAmB,EAAE,CAAC,CAAC,oBAA8B;YACrD,aAAa,EAAE,CAAC,CAAC,cAAwB;YACzC,OAAO,EAAG,CAAC,CAAC,QAAmB,IAAI,IAAI;YACvC,SAAS,EAAG,CAAC,CAAC,UAAqB,IAAI,IAAI;YAC3C,MAAM,EAAE,CAAC,CAAC,MAA0B;YACpC,SAAS,EAAG,CAAC,CAAC,UAAqB,IAAI,SAAS;YAChD,iBAAiB,EAAG,CAAC,CAAC,mBAA8B,IAAI,SAAS;YACjE,eAAe,EAAG,CAAC,CAAC,iBAA4B,IAAI,SAAS;YAC7D,WAAW,EAAE,CAAC,CAAC,YAAsB;YACrC,SAAS,EAAE,CAAC,CAAC,UAAoB;YACjC,SAAS,EAAE,CAAC,CAAC,UAAoB;YACjC,OAAO,EAAE,CAAC,CAAC,OAAiB;SAC7B,CAAC;IACJ,CAAC;CACF;AAED,SAAS,OAAO,CAAC,CAAqB;IACpC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACpB,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACpB,OAAO,CAAC,CAAC;AACX,CAAC"}