crewly 1.20.419 → 1.20.421

package/dist/backend/backend/src/services/memory/correction-ladder.service.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Correction ladder (#810, specs/2026-10-25-correction-ladder.md).
+ *
+ * When an agent is corrected, the correction lands in memory, an SOP or a
+ * prompt: prose that is read every turn and still lets the same mistake
+ * back in. This service keeps a per-project tally of corrections by
+ * **class** (a short slug the recorder chooses, e.g. `git-add-all`) and,
+ * the second time a class is recorded, hands the project's team lead one
+ * WorkItem: "can this be made impossible or checked in code?" with the
+ * ladder as options —
+ *
+ *   (a) structural / API change — the mistake can no longer be expressed
+ *   (b) lint / test / CI check — it is caught before merge
+ *   (c) state-triggered hook — it is caught when it happens
+ *   (d) keep as prose, with a stated reason
+ *
+ * The WorkItem is deduplicated: one open item per class. The lead records
+ * the rung with `decide`; until then a third occurrence does not raise a
+ * second item. A decision of (d) is not final: when the prose did not
+ * stick (two more occurrences after it), the class is raised again. No LLM;
+ * a plain JSON store under the project's `.crewly/`.
+ *
+ * @module services/memory/correction-ladder.service
+ */
+import { CORRECTION_LADDER_CONSTANTS } from '../../constants.js';
+import { type WorkItem } from '../../types/v2/work-item.types.js';
+/** Where a correction came from. */
+export type CorrectionSource = 'learning' | 'failure' | 'manual';
+/** The rungs of the ladder, from "cannot happen" to "we tell them again". */
+export type CorrectionRung = (typeof CORRECTION_LADDER_CONSTANTS.RUNGS)[number];
+/** One time a class was recorded. */
+export interface CorrectionOccurrence {
+    /** ISO timestamp */
+    at: string;
+    /** Who recorded it (session name or agent id) */
+    agentId: string;
+    /** Learning, TL failure handling, or a direct call */
+    source: CorrectionSource;
+    /** The correction text as recorded (trimmed to `OCCURRENCE_TEXT_MAX_CHARS`) */
+    text: string;
+    /** Ticket / WorkItem the correction came from */
+    relatedTask?: string;
+}
+/** The lead's answer for a class. */
+export interface CorrectionDecision {
+    rung: CorrectionRung;
+    /** Why this rung — required for every rung, and the whole point of (d) */
+    reason: string;
+    /** PR, file, rule or hook that implements it */
+    link?: string;
+    decidedBy: string;
+    decidedAt: string;
+}
+/** Everything known about one correction class in one project. */
+export interface CorrectionClassRecord {
+    class: string;
+    /** Times recorded, all time */
+    count: number;
+    firstAt: string;
+    lastAt: string;
+    /** Newest last; capped at `MAX_OCCURRENCES_KEPT` */
+    occurrences: CorrectionOccurrence[];
+    /** The open ladder WorkItem, if one was raised and not yet decided */
+    workItemId: string | null;
+    workItemAt: string | null;
+    /** The current decision; `null` while undecided or after a re-raise */
+    decision: CorrectionDecision | null;
+    /** Earlier decisions that did not hold (a (d) that was raised again) */
+    previousDecisions: CorrectionDecision[];
+}
+/** The per-project store. */
+export interface CorrectionLadderStore {
+    version: 1;
+    classes: Record<string, CorrectionClassRecord>;
+}
+/** Input of {@link CorrectionLadderService.record}. */
+export interface RecordCorrectionInput {
+    projectPath: string;
+    /** Free text; normalised with {@link normalizeCorrectionClass} */
+    correctionClass: string;
+    agentId: string;
+    text: string;
+    source: CorrectionSource;
+    relatedTask?: string;
+}
+/** Why a second occurrence did not raise a WorkItem. */
+export type CorrectionRaiseSkip = 'below_threshold' | 'already_raised' | 'decided' | 'no_pool' | 'target_dormant';
+/** Result of {@link CorrectionLadderService.record}. */
+export interface RecordCorrectionResult {
+    record: CorrectionClassRecord;
+    /** Whether this call raised the lead's WorkItem */
+    raised: boolean;
+    workItemId?: string;
+    target?: string;
+    skipped?: CorrectionRaiseSkip;
+}
+/** Input of {@link CorrectionLadderService.decide}. */
+export interface DecideCorrectionInput {
+    projectPath: string;
+    correctionClass: string;
+    rung: string;
+    reason: string;
+    link?: string;
+    decidedBy: string;
+}
+/** The pool slice this service needs. */
+export interface CorrectionLadderPool {
+    addToPool(workItem: WorkItem): Promise<void>;
+}
+/** Wiring. */
+export interface CorrectionLadderOptions {
+    pool?: CorrectionLadderPool;
+    /** The team-lead session for a project root; `null` falls back to the orchestrator */
+    resolveTarget?: (projectPath: string) => Promise<string | null>;
+    /** Whether a session is awake; a dormant lead is not woken for a chore */
+    isTargetAwake?: (sessionName: string) => Promise<boolean>;
+    /** Target when no lead resolves (default: the orchestrator) */
+    fallbackTarget?: string;
+    /** Clock (tests) */
+    now?: () => number;
+}
+/**
+ * Normalise a class to a slug: lower case, `a-z0-9-`, no leading/trailing
+ * or doubled dashes, at most `CLASS_MAX_CHARS`. Returns `null` when nothing
+ * usable is left.
+ *
+ * @param raw - What the recorder typed
+ * @returns The slug, or null
+ */
+export declare function normalizeCorrectionClass(raw: unknown): string | null;
+/**
+ * Whether a string names a rung of the ladder.
+ *
+ * @param rung - Candidate
+ * @returns True for one of `RUNGS`
+ */
+export declare function isCorrectionRung(rung: unknown): rung is CorrectionRung;
+/**
+ * Where a project's ladder store lives.
+ *
+ * @param projectPath - Project root
+ * @returns `<project data dir>/correction-ladder.json`
+ */
+export declare function correctionLadderPath(projectPath: string): string;
+/**
+ * Occurrences recorded after the current decision (or all, when undecided).
+ *
+ * @param record - Class record
+ * @returns Count
+ */
+export declare function occurrencesSinceDecision(record: CorrectionClassRecord): number;
+/**
+ * The lead's WorkItem for a class: the tally, the recorded texts, the four
+ * rungs, and how to record the choice.
+ *
+ * @param record - Class record (after the occurrence that raised it)
+ * @param projectPath - Project root
+ * @param target - Lead (or orchestrator) session
+ * @param again - Whether an earlier (d) did not hold
+ * @returns The WorkItem to add to the pool
+ */
+export declare function buildCorrectionWorkItem(record: CorrectionClassRecord, projectPath: string, target: string, again: boolean): WorkItem;
+/**
+ * Per-project tally of correction classes with one ladder WorkItem per
+ * class for the team lead.
+ */
+export declare class CorrectionLadderService {
+    private static instance;
+    private readonly logger;
+    private readonly pool?;
+    private readonly resolveTarget?;
+    private readonly isTargetAwake?;
+    private readonly fallbackTarget;
+    private readonly now;
+    /** Serialises writes per store file */
+    private readonly locks;
+    /**
+     * @param options - Wiring (pool, lead resolver, wake check)
+     */
+    constructor(options?: CorrectionLadderOptions);
+    /** The wired instance (an unwired one records and never raises). */
+    static getInstance(): CorrectionLadderService;
+    /** Install the wired instance (boot) or reset (tests). */
+    static setInstance(instance: CorrectionLadderService | null): void;
+    /**
+     * Record one correction of a class and, on the second occurrence (or the
+     * second after a (d) that did not hold), raise the lead's WorkItem.
+     *
+     * @param input - Class, who, what, where
+     * @returns The class record and whether a WorkItem was raised
+     * @throws Error when the class normalises to nothing or the text is empty
+     */
+    record(input: RecordCorrectionInput): Promise<RecordCorrectionResult>;
+    /**
+     * Record the lead's choice for a class and close the ladder for it.
+     *
+     * @param input - Class, rung, reason, who
+     * @returns The updated record
+     * @throws Error for an unknown class, an unknown rung or an empty reason
+     */
+    decide(input: DecideCorrectionInput): Promise<CorrectionClassRecord>;
+    /**
+     * Every class of a project, most recorded first.
+     *
+     * @param projectPath - Project root
+     * @returns Records
+     */
+    list(projectPath: string): Promise<CorrectionClassRecord[]>;
+    /**
+     * Raise the lead's WorkItem when the class has earned it: `THRESHOLD`
+     * occurrences with no decision and no open item, or `THRESHOLD`
+     * occurrences after a (d) decision. An open item older than
+     * `REOPEN_AFTER_MS` with no decision counts as abandoned and is replaced.
+     */
+    private maybeRaise;
+    /** The lead for a project; errors count as "no lead". */
+    private targetFor;
+    /** Errors count as dormant: a chore is never worth risking a wake. */
+    private targetAwake;
+    private read;
+    private write;
+    /** Run `fn` after every earlier operation on the same project's store. */
+    private withLock;
+}
+//# sourceMappingURL=correction-ladder.service.d.ts.map

package/dist/backend/backend/src/services/memory/correction-ladder.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correction-ladder.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/memory/correction-ladder.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/memory/correction-ladder.service.js

@@ -0,0 +1,335 @@
+/**
+ * Correction ladder (#810, specs/2026-10-25-correction-ladder.md).
+ *
+ * When an agent is corrected, the correction lands in memory, an SOP or a
+ * prompt: prose that is read every turn and still lets the same mistake
+ * back in. This service keeps a per-project tally of corrections by
+ * **class** (a short slug the recorder chooses, e.g. `git-add-all`) and,
+ * the second time a class is recorded, hands the project's team lead one
+ * WorkItem: "can this be made impossible or checked in code?" with the
+ * ladder as options —
+ *
+ *   (a) structural / API change — the mistake can no longer be expressed
+ *   (b) lint / test / CI check — it is caught before merge
+ *   (c) state-triggered hook — it is caught when it happens
+ *   (d) keep as prose, with a stated reason
+ *
+ * The WorkItem is deduplicated: one open item per class. The lead records
+ * the rung with `decide`; until then a third occurrence does not raise a
+ * second item. A decision of (d) is not final: when the prose did not
+ * stick (two more occurrences after it), the class is raised again. No LLM;
+ * a plain JSON store under the project's `.crewly/`.
+ *
+ * @module services/memory/correction-ladder.service
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { LoggerService } from '../core/logger.service.js';
+import { CORRECTION_LADDER_CONSTANTS, ORCHESTRATOR_SESSION_NAME } from '../../constants.js';
+import { atomicWriteJson, safeReadJson } from '../../utils/file-io.utils.js';
+import { resolveProjectDataDir } from '../core/crewly-home.utils.js';
+import { createWorkItem } from '../../types/v2/work-item.types.js';
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Normalise a class to a slug: lower case, `a-z0-9-`, no leading/trailing
+ * or doubled dashes, at most `CLASS_MAX_CHARS`. Returns `null` when nothing
+ * usable is left.
+ *
+ * @param raw - What the recorder typed
+ * @returns The slug, or null
+ */
+export function normalizeCorrectionClass(raw) {
+    if (typeof raw !== 'string')
+        return null;
+    const slug = raw
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .replace(/-{2,}/g, '-')
+        .slice(0, CORRECTION_LADDER_CONSTANTS.CLASS_MAX_CHARS)
+        .replace(/-+$/g, '');
+    return slug.length >= CORRECTION_LADDER_CONSTANTS.CLASS_MIN_CHARS ? slug : null;
+}
+/**
+ * Whether a string names a rung of the ladder.
+ *
+ * @param rung - Candidate
+ * @returns True for one of `RUNGS`
+ */
+export function isCorrectionRung(rung) {
+    return typeof rung === 'string' && CORRECTION_LADDER_CONSTANTS.RUNGS.includes(rung);
+}
+/**
+ * Where a project's ladder store lives.
+ *
+ * @param projectPath - Project root
+ * @returns `<project data dir>/correction-ladder.json`
+ */
+export function correctionLadderPath(projectPath) {
+    return path.join(resolveProjectDataDir(projectPath), CORRECTION_LADDER_CONSTANTS.STORE_FILE);
+}
+/**
+ * Occurrences recorded after the current decision (or all, when undecided).
+ *
+ * @param record - Class record
+ * @returns Count
+ */
+export function occurrencesSinceDecision(record) {
+    if (!record.decision)
+        return record.count;
+    const since = record.decision.decidedAt;
+    return record.occurrences.filter((o) => o.at > since).length;
+}
+/**
+ * The lead's WorkItem for a class: the tally, the recorded texts, the four
+ * rungs, and how to record the choice.
+ *
+ * @param record - Class record (after the occurrence that raised it)
+ * @param projectPath - Project root
+ * @param target - Lead (or orchestrator) session
+ * @param again - Whether an earlier (d) did not hold
+ * @returns The WorkItem to add to the pool
+ */
+export function buildCorrectionWorkItem(record, projectPath, target, again) {
+    const c = record.class;
+    const recent = record.occurrences.slice(-CORRECTION_LADDER_CONSTANTS.OCCURRENCES_IN_BRIEF);
+    const lines = [
+        `# Correction ladder — \`${c}\`${again ? ' (again)' : ''}`,
+        '',
+        `Project: \`${projectPath}\``,
+        `Recorded ${record.count} time${record.count === 1 ? '' : 's'}; first ${record.firstAt.slice(0, 10)}, last ${record.lastAt.slice(0, 10)}.`,
+        '',
+    ];
+    if (again && record.previousDecisions.length) {
+        const prev = record.previousDecisions[record.previousDecisions.length - 1];
+        lines.push(`An earlier decision kept this as prose (${prev.decidedAt.slice(0, 10)}: "${prev.reason}") and the mistake came back ${occurrencesSinceDecision({ ...record, decision: prev })} more times. Prose did not hold; pick a higher rung or say why prose is still right.`, '');
+    }
+    lines.push('## What was recorded', '');
+    for (const o of recent)
+        lines.push(`- ${o.at.slice(0, 10)} · ${o.agentId} · ${o.source}${o.relatedTask ? ` · ${o.relatedTask}` : ''}: ${o.text}`);
+    lines.push('', '## The question', '', 'The same class of mistake has come back. Prose (memory, SOP, prompt) is read every turn and still let it through. Decide which rung makes it stop, highest feasible first:', '', '- **structural** — change the API, type or file layout so the mistake can no longer be expressed.', '- **check** — a lint rule, test or CI step that fails before merge.', '- **hook** — a state-triggered hook or skill guard that catches it the moment it happens.', '- **prose** — keep it as memory/SOP text, with the reason why nothing above is worth it.', '', 'Do the work for the rung you pick (or open the PR / ticket for it), then record the choice:', '', '```bash', `bash {{SKILLS_PATH}}/team-leader/decide-correction/execute.sh --project "${projectPath}" --class ${c} --rung <structural|check|hook|prose> --reason "<why this rung>" [--link <PR, file or rule>]`, '```', '', 'This WorkItem counts as done only when the choice is recorded. The owner is not involved; never post this in the owner\'s thread.');
+    return createWorkItem({
+        type: 'delegate',
+        owner: target === ORCHESTRATOR_SESSION_NAME ? 'orchestrator' : 'team_lead',
+        target,
+        title: `Correction ladder: "${c}" came back (${record.count}×)${again ? ' — prose did not hold' : ''}`,
+        description: `The correction class "${c}" was recorded ${record.count} times in ${projectPath}. Decide whether it can be made impossible (structural), caught by a check, caught by a hook, or must stay prose — and record the choice with decide-correction.`,
+        briefMarkdown: lines.join('\n'),
+        maxRetries: 1,
+        metadata: {
+            kind: CORRECTION_LADDER_CONSTANTS.WORKITEM_KIND,
+            correctionClass: c,
+            projectPath,
+            count: record.count,
+            again,
+            autoCreated: true,
+        },
+    });
+}
+// =============================================================================
+// Service
+// =============================================================================
+/**
+ * Per-project tally of correction classes with one ladder WorkItem per
+ * class for the team lead.
+ */
+export class CorrectionLadderService {
+    static instance = null;
+    logger;
+    pool;
+    resolveTarget;
+    isTargetAwake;
+    fallbackTarget;
+    now;
+    /** Serialises writes per store file */
+    locks = new Map();
+    /**
+     * @param options - Wiring (pool, lead resolver, wake check)
+     */
+    constructor(options = {}) {
+        this.logger = LoggerService.getInstance().createComponentLogger('CorrectionLadder');
+        this.pool = options.pool;
+        this.resolveTarget = options.resolveTarget;
+        this.isTargetAwake = options.isTargetAwake;
+        this.fallbackTarget = options.fallbackTarget ?? ORCHESTRATOR_SESSION_NAME;
+        this.now = options.now ?? (() => Date.now());
+    }
+    /** The wired instance (an unwired one records and never raises). */
+    static getInstance() {
+        if (!this.instance)
+            this.instance = new CorrectionLadderService();
+        return this.instance;
+    }
+    /** Install the wired instance (boot) or reset (tests). */
+    static setInstance(instance) {
+        this.instance = instance;
+    }
+    /**
+     * Record one correction of a class and, on the second occurrence (or the
+     * second after a (d) that did not hold), raise the lead's WorkItem.
+     *
+     * @param input - Class, who, what, where
+     * @returns The class record and whether a WorkItem was raised
+     * @throws Error when the class normalises to nothing or the text is empty
+     */
+    async record(input) {
+        const cls = normalizeCorrectionClass(input.correctionClass);
+        if (!cls)
+            throw new Error(`Correction class "${String(input.correctionClass)}" has no letters or digits to make a slug from`);
+        const text = (input.text ?? '').trim();
+        if (!text)
+            throw new Error('A correction needs the text that was recorded');
+        return this.withLock(input.projectPath, async () => {
+            const store = await this.read(input.projectPath);
+            const at = new Date(this.now()).toISOString();
+            const existing = store.classes[cls];
+            const occurrence = {
+                at,
+                agentId: input.agentId,
+                source: input.source,
+                text: text.slice(0, CORRECTION_LADDER_CONSTANTS.OCCURRENCE_TEXT_MAX_CHARS),
+                ...(input.relatedTask ? { relatedTask: input.relatedTask } : {}),
+            };
+            const record = existing
+                ? {
+                    ...existing,
+                    count: existing.count + 1,
+                    lastAt: at,
+                    occurrences: [...existing.occurrences, occurrence].slice(-CORRECTION_LADDER_CONSTANTS.MAX_OCCURRENCES_KEPT),
+                }
+                : { class: cls, count: 1, firstAt: at, lastAt: at, occurrences: [occurrence], workItemId: null, workItemAt: null, decision: null, previousDecisions: [] };
+            store.classes[cls] = record;
+            const raise = await this.maybeRaise(record, input.projectPath);
+            await this.write(input.projectPath, store);
+            if (raise.raised) {
+                this.logger.info('Correction class raised to the team lead', { projectPath: input.projectPath, class: cls, count: record.count, target: raise.target, workItemId: raise.workItemId });
+            }
+            return { record, ...raise };
+        });
+    }
+    /**
+     * Record the lead's choice for a class and close the ladder for it.
+     *
+     * @param input - Class, rung, reason, who
+     * @returns The updated record
+     * @throws Error for an unknown class, an unknown rung or an empty reason
+     */
+    async decide(input) {
+        const cls = normalizeCorrectionClass(input.correctionClass);
+        if (!cls)
+            throw new Error(`Correction class "${String(input.correctionClass)}" is not a slug`);
+        const rung = input.rung;
+        if (!isCorrectionRung(rung))
+            throw new Error(`Unknown rung "${String(rung)}" — one of ${CORRECTION_LADDER_CONSTANTS.RUNGS.join(', ')}`);
+        const reason = (input.reason ?? '').trim();
+        if (!reason)
+            throw new Error('A decision needs a reason, for every rung');
+        return this.withLock(input.projectPath, async () => {
+            const store = await this.read(input.projectPath);
+            const record = store.classes[cls];
+            if (!record)
+                throw new Error(`No correction class "${cls}" recorded in ${input.projectPath}`);
+            const decision = {
+                rung,
+                reason,
+                ...(input.link?.trim() ? { link: input.link.trim() } : {}),
+                decidedBy: input.decidedBy,
+                decidedAt: new Date(this.now()).toISOString(),
+            };
+            const updated = { ...record, decision, workItemId: null, workItemAt: null };
+            store.classes[cls] = updated;
+            await this.write(input.projectPath, store);
+            this.logger.info('Correction class decided', { projectPath: input.projectPath, class: cls, rung: decision.rung, decidedBy: input.decidedBy });
+            return updated;
+        });
+    }
+    /**
+     * Every class of a project, most recorded first.
+     *
+     * @param projectPath - Project root
+     * @returns Records
+     */
+    async list(projectPath) {
+        const store = await this.read(projectPath);
+        return Object.values(store.classes).sort((a, b) => b.count - a.count || a.class.localeCompare(b.class));
+    }
+    // ---------------------------------------------------------------------------
+    /**
+     * Raise the lead's WorkItem when the class has earned it: `THRESHOLD`
+     * occurrences with no decision and no open item, or `THRESHOLD`
+     * occurrences after a (d) decision. An open item older than
+     * `REOPEN_AFTER_MS` with no decision counts as abandoned and is replaced.
+     */
+    async maybeRaise(record, projectPath) {
+        const since = occurrencesSinceDecision(record);
+        const again = record.decision?.rung === 'prose';
+        if (record.decision && !again)
+            return { raised: false, skipped: 'decided' };
+        if (since < CORRECTION_LADDER_CONSTANTS.THRESHOLD)
+            return { raised: false, skipped: 'below_threshold' };
+        if (record.workItemId) {
+            const age = record.workItemAt ? this.now() - Date.parse(record.workItemAt) : 0;
+            if (age < CORRECTION_LADDER_CONSTANTS.REOPEN_AFTER_MS)
+                return { raised: false, skipped: 'already_raised', workItemId: record.workItemId };
+            this.logger.warn('Correction ladder WorkItem never decided; raising again', { projectPath, class: record.class, workItemId: record.workItemId });
+        }
+        if (!this.pool)
+            return { raised: false, skipped: 'no_pool' };
+        const target = (await this.targetFor(projectPath)) ?? this.fallbackTarget;
+        if (!(await this.targetAwake(target)))
+            return { raised: false, skipped: 'target_dormant', target };
+        if (again && record.decision) {
+            record.previousDecisions = [...record.previousDecisions, record.decision];
+            record.decision = null;
+        }
+        const wi = buildCorrectionWorkItem(record, projectPath, target, again);
+        await this.pool.addToPool(wi);
+        record.workItemId = wi.id;
+        record.workItemAt = new Date(this.now()).toISOString();
+        return { raised: true, workItemId: wi.id, target };
+    }
+    /** The lead for a project; errors count as "no lead". */
+    async targetFor(projectPath) {
+        if (!this.resolveTarget)
+            return null;
+        try {
+            return await this.resolveTarget(projectPath);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Errors count as dormant: a chore is never worth risking a wake. */
+    async targetAwake(target) {
+        if (!this.isTargetAwake)
+            return true;
+        try {
+            return await this.isTargetAwake(target);
+        }
+        catch {
+            return false;
+        }
+    }
+    async read(projectPath) {
+        const data = await safeReadJson(correctionLadderPath(projectPath), null);
+        const classes = data && typeof data.classes === 'object' && data.classes ? data.classes : {};
+        return { version: 1, classes: { ...classes } };
+    }
+    async write(projectPath, store) {
+        const file = correctionLadderPath(projectPath);
+        await fs.mkdir(path.dirname(file), { recursive: true });
+        await atomicWriteJson(file, store);
+    }
+    /** Run `fn` after every earlier operation on the same project's store. */
+    withLock(projectPath, fn) {
+        const key = path.resolve(projectPath);
+        const prev = this.locks.get(key) ?? Promise.resolve();
+        const next = prev.then(fn, fn);
+        this.locks.set(key, next.catch(() => undefined));
+        return next;
+    }
+}
+//# sourceMappingURL=correction-ladder.service.js.map

package/dist/backend/backend/src/services/memory/correction-ladder.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correction-ladder.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/memory/correction-ladder.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAwB,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,cAAc,EAAiB,MAAM,mCAAmC,CAAC;AAiHlF,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAY;IACnD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,IAAI,GAAG,GAAG;SACb,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,eAAe,CAAC;SACrD,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC,MAAM,IAAI,2BAA2B,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAClF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAK,2BAA2B,CAAC,KAA2B,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC7G,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;AAC/F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAA6B;IACpE,IAAI,CAAC,MAAM,CAAC,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;IACxC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC;AAC/D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA6B,EAAE,WAAmB,EAAE,MAAc,EAAE,KAAc;IACxH,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;IACvB,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,2BAA2B,CAAC,oBAAoB,CAAC,CAAC;IAC3F,MAAM,KAAK,GAAa;QACtB,2BAA2B,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1D,EAAE;QACF,cAAc,WAAW,IAAI;QAC7B,YAAY,MAAM,CAAC,KAAK,QAAQ,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG;QAC1I,EAAE;KACH,CAAC;IACF,IAAI,KAAK,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,2CAA2C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,MAAM,gCAAgC,wBAAwB,CAAC,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,sFAAsF,EAAE,EAAE,CAAC,CAAC;IACvR,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAClJ,KAAK,CAAC,IAAI,CACR,EAAE,EACF,iBAAiB,EACjB,EAAE,EACF,4KAA4K,EAC5K,EAAE,EACF,mGAAmG,EACnG,qEAAqE,EACrE,2FAA2F,EAC3F,0FAA0F,EAC1F,EAAE,EACF,6FAA6F,EAC7F,EAAE,EACF,SAAS,EACT,4EAA4E,WAAW,aAAa,CAAC,8FAA8F,EACnM,KAAK,EACL,EAAE,EACF,mIAAmI,CACpI,CAAC;IACF,OAAO,cAAc,CAAC;QACpB,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,MAAM,KAAK,yBAAyB,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW;QAC1E,MAAM;QACN,KAAK,EAAE,uBAAuB,CAAC,gBAAgB,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,EAAE;QACtG,WAAW,EAAE,yBAAyB,CAAC,kBAAkB,MAAM,CAAC,KAAK,aAAa,WAAW,kKAAkK;QAC/P,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/B,UAAU,EAAE,CAAC;QACb,QAAQ,EAAE;YACR,IAAI,EAAE,2BAA2B,CAAC,aAAa;YAC/C,eAAe,EAAE,CAAC;YAClB,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK;YACL,WAAW,EAAE,IAAI;SAClB;KACF,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IAC1B,MAAM,CAAC,QAAQ,GAAmC,IAAI,CAAC;IAC9C,MAAM,CAAkB;IACxB,IAAI,CAAwB;IAC5B,aAAa,CAAmD;IAChE,aAAa,CAA6C;IAC1D,cAAc,CAAS;IACvB,GAAG,CAAe;IACnC,uCAAuC;IACtB,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;IAE7D;;OAEG;IACH,YAAY,UAAmC,EAAE;QAC/C,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,yBAAyB,CAAC;QAC1E,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,oEAAoE;IACpE,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,uBAAuB,EAAE,CAAC;QAClE,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,0DAA0D;IAC1D,MAAM,CAAC,WAAW,CAAC,QAAwC;QACzD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,KAA4B;QACvC,MAAM,GAAG,GAAG,wBAAwB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC5D,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,gDAAgD,CAAC,CAAC;QAC9H,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAE5E,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACjD,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,UAAU,GAAyB;gBACvC,EAAE;gBACF,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,yBAAyB,CAAC;gBAC1E,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjE,CAAC;YACF,MAAM,MAAM,GAA0B,QAAQ;gBAC5C,CAAC,CAAC;oBACE,GAAG,QAAQ;oBACX,KAAK,EAAE,QAAQ,CAAC,KAAK,GAAG,CAAC;oBACzB,MAAM,EAAE,EAAE;oBACV,WAAW,EAAE,CAAC,GAAG,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,2BAA2B,CAAC,oBAAoB,CAAC;iBAC5G;gBACH,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC;YAC5J,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YAE5B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;YAC/D,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC3C,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YACxL,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,KAA4B;QACvC,MAAM,GAAG,GAAG,wBAAwB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC5D,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;QAC/F,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,CAAC,IAAI,CAAC,cAAc,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxI,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAE1E,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,iBAAiB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YAC9F,MAAM,QAAQ,GAAuB;gBACnC,IAAI;gBACJ,MAAM;gBACN,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1D,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;aAC9C,CAAC;YACF,MAAM,OAAO,GAA0B,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;YACnG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;YAC7B,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;YAC9I,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,WAAmB;QAC5B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1G,CAAC;IAED,8EAA8E;IAE9E;;;;;OAKG;IACK,KAAK,CAAC,UAAU,CAAC,MAA6B,EAAE,WAAmB;QACzE,MAAM,KAAK,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI,KAAK,OAAO,CAAC;QAChD,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QAC5E,IAAI,KAAK,GAAG,2BAA2B,CAAC,SAAS;YAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;QACxG,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/E,IAAI,GAAG,GAAG,2BAA2B,CAAC,eAAe;gBAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;YAC1I,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yDAAyD,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACnJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QAE7D,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC;QAC1E,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAEnG,IAAI,KAAK,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC7B,MAAM,CAAC,iBAAiB,GAAG,CAAC,GAAG,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC1E,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,MAAM,EAAE,GAAG,uBAAuB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,UAAU,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACvD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC;IACrD,CAAC;IAED,yDAAyD;IACjD,KAAK,CAAC,SAAS,CAAC,WAAmB;QACzC,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,sEAAsE;IAC9D,KAAK,CAAC,WAAW,CAAC,MAAc;QACtC,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,WAAmB;QACpC,MAAM,IAAI,GAAG,MAAM,YAAY,CAAwC,oBAAoB,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;QAChH,MAAM,OAAO,GAAG,IAAI,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC;IACjD,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,WAAmB,EAAE,KAA4B;QACnE,MAAM,IAAI,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,MAAM,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,0EAA0E;IAClE,QAAQ,CAAI,WAAmB,EAAE,EAAoB;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC"}