@hoangsonw/forge 0.1.0

package/dist/core/conversation.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Unified conversation domain model — the single source of truth for
+ * multi-turn interactions, shared by the CLI REPL and the Web UI chat.
+ *
+ * A conversation is an append-only JSONL file on disk at:
+ *     <project>/sessions/<source>-<id>.jsonl
+ *
+ * where `source` is `repl` or `chat` (indicating which surface started the
+ * conversation — history only, not authoritative; either surface may append
+ * turns to either file).
+ *
+ * Event schema (unified, forward-going):
+ *   { at, kind: 'session-created', meta }
+ *   { at, kind: 'turn-user',       turn }
+ *   { at, kind: 'turn-result',     turnId, taskId, result, status }
+ *   { at, kind: 'meta-updated',    patch }
+ *
+ * Readers ALSO accept legacy REPL events written by an earlier build:
+ *   { type: 'user',   content: { input, mode }, timestamp }
+ *   { type: 'result', content: TurnResult,      timestamp }
+ *
+ * Writers emit only the unified format. No migration — legacy files remain
+ * readable forever.
+ *
+ * Concurrency: all mutations route through conversation-store's atomic
+ * append primitives, so multiple writers (CLI REPL + UI chat + tasks) are
+ * safe without an explicit coordinator.
+ */
+import { Mode } from '../types';
+import { ConversationWatcher } from '../persistence/conversation-store';
+export type ConversationSource = 'repl' | 'chat';
+export type TurnStatus = 'pending' | 'running' | 'done' | 'failed' | 'cancelled';
+export interface TurnResult {
+    taskId: string;
+    success: boolean;
+    summary: string;
+    filesChanged: string[];
+    durationMs: number;
+    costUsd?: number;
+}
+export interface ConversationTurn {
+    id: string;
+    at: string;
+    input: string;
+    mode: Mode;
+    taskId?: string;
+    status: TurnStatus;
+    result?: TurnResult;
+}
+export interface ConversationMeta {
+    id: string;
+    projectPath: string;
+    title: string;
+    mode: Mode;
+    source: ConversationSource;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Conversation {
+    meta: ConversationMeta;
+    turns: ConversationTurn[];
+}
+export interface ConversationSummary {
+    id: string;
+    source: ConversationSource;
+    title: string;
+    mode: Mode;
+    turns: number;
+    createdAt: string;
+    lastAt: string;
+    sizeBytes: number;
+}
+type ConvEvent = {
+    at: string;
+    kind: 'session-created';
+    meta: ConversationMeta;
+} | {
+    at: string;
+    kind: 'turn-user';
+    turn: ConversationTurn;
+} | {
+    at: string;
+    kind: 'turn-result';
+    turnId: string;
+    taskId: string;
+    result: TurnResult;
+    status: TurnStatus;
+} | {
+    at: string;
+    kind: 'meta-updated';
+    patch: Partial<ConversationMeta>;
+};
+/** Exported for defensive checks at other boundaries (CLI /load input, HTTP
+ *  route parameters). */
+export declare const isValidConversationId: (id: string) => boolean;
+export interface CreateConversationOpts {
+    projectPath: string;
+    title?: string;
+    mode?: Mode;
+    source?: ConversationSource;
+    /** Supply an id (without prefix) to use deterministic names — mostly for tests. */
+    id?: string;
+}
+export declare const createConversation: (opts: CreateConversationOpts) => Promise<Conversation>;
+export declare const loadConversation: (projectPath: string, id: string) => Conversation | null;
+export declare const listConversations: (projectPath: string) => ConversationSummary[];
+export declare const appendUserTurn: (projectPath: string, conversationId: string, turn: ConversationTurn) => Promise<void>;
+export declare const attachTurnResult: (projectPath: string, conversationId: string, args: {
+    turnId: string;
+    taskId: string;
+    result: TurnResult;
+    status: TurnStatus;
+}) => Promise<void>;
+/** Synchronous variant of attachTurnResult for callers that can't await
+ *  (task-runner's resolution listeners). */
+export declare const attachTurnResultSync: (projectPath: string, conversationId: string, args: {
+    turnId: string;
+    taskId: string;
+    result: TurnResult;
+    status: TurnStatus;
+}) => void;
+export declare const renameConversation: (projectPath: string, conversationId: string, title: string) => Promise<void>;
+export declare const deleteConversation: (projectPath: string, conversationId: string) => boolean;
+export declare const findConversationFile: (projectPath: string, conversationId: string) => string;
+export interface ConversationUpdate {
+    events: ConvEvent[];
+    newTurns: ConversationTurn[];
+    completedTurns: Array<{
+        turn: ConversationTurn;
+        prior: TurnStatus;
+    }>;
+    metaChanged: boolean;
+}
+/**
+ * Watch a conversation file for appended events. Higher-level than the store
+ * watcher: it delivers typed ConvEvents and annotates which turns were newly
+ * added or completed. Used by CLI REPL to display cross-terminal edits and
+ * by the UI to push live updates to connected browsers.
+ */
+export declare const watchConversationFile: (projectPath: string, conversationId: string, onUpdate: (update: ConversationUpdate) => void) => ConversationWatcher;
+export declare const MAX_TURNS_IN_CONTEXT = 6;
+/**
+ * Produce a planner-friendly description that embeds prior turns as context
+ * so the agent sees the conversation so far. The latest user input is the
+ * headline; older turns are summarised.
+ *
+ * Kept small and deterministic — no LLM calls, no heavyweight formatting.
+ */
+export declare const composeDescription: (newInput: string, turns: ConversationTurn[], maxTurns?: number) => string;
+export declare const newTurnId: () => string;
+export {};
+//# sourceMappingURL=conversation.d.ts.map

package/dist/core/conversation.d.ts.map

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

package/dist/core/conversation.js

@@ -0,0 +1,435 @@
+"use strict";
+/**
+ * Unified conversation domain model — the single source of truth for
+ * multi-turn interactions, shared by the CLI REPL and the Web UI chat.
+ *
+ * A conversation is an append-only JSONL file on disk at:
+ *     <project>/sessions/<source>-<id>.jsonl
+ *
+ * where `source` is `repl` or `chat` (indicating which surface started the
+ * conversation — history only, not authoritative; either surface may append
+ * turns to either file).
+ *
+ * Event schema (unified, forward-going):
+ *   { at, kind: 'session-created', meta }
+ *   { at, kind: 'turn-user',       turn }
+ *   { at, kind: 'turn-result',     turnId, taskId, result, status }
+ *   { at, kind: 'meta-updated',    patch }
+ *
+ * Readers ALSO accept legacy REPL events written by an earlier build:
+ *   { type: 'user',   content: { input, mode }, timestamp }
+ *   { type: 'result', content: TurnResult,      timestamp }
+ *
+ * Writers emit only the unified format. No migration — legacy files remain
+ * readable forever.
+ *
+ * Concurrency: all mutations route through conversation-store's atomic
+ * append primitives, so multiple writers (CLI REPL + UI chat + tasks) are
+ * safe without an explicit coordinator.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.newTurnId = exports.composeDescription = exports.MAX_TURNS_IN_CONTEXT = exports.watchConversationFile = exports.findConversationFile = exports.deleteConversation = exports.renameConversation = exports.attachTurnResultSync = exports.attachTurnResult = exports.appendUserTurn = exports.listConversations = exports.loadConversation = exports.createConversation = exports.isValidConversationId = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const paths_1 = require("../config/paths");
+const trace_1 = require("../logging/trace");
+const conversation_store_1 = require("../persistence/conversation-store");
+const logger_1 = require("../logging/logger");
+// ---------- Paths ----------
+/**
+ * Conversation ids are embedded in filenames; an id like "../../../etc/passwd"
+ * would escape the sessions directory and write somewhere we don't want.
+ * Enforce a strict allow-list: letters, digits, underscore, dash, and the
+ * three recognised prefixes. Reject anything else at the earliest boundary.
+ */
+const ID_PATTERN = /^(?:repl|chat|conv)-[a-z0-9_-]+$/;
+const assertSafeId = (id) => {
+    if (typeof id !== 'string' || id.length === 0 || id.length > 256) {
+        throw new Error(`invalid conversation id: '${String(id)}'`);
+    }
+    if (!ID_PATTERN.test(id)) {
+        throw new Error(`invalid conversation id: '${id}' (expected /^(repl|chat|conv)-[a-z0-9_-]+$/)`);
+    }
+};
+/** Exported for defensive checks at other boundaries (CLI /load input, HTTP
+ *  route parameters). */
+const isValidConversationId = (id) => {
+    try {
+        assertSafeId(id);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+exports.isValidConversationId = isValidConversationId;
+const conversationPath = (projectPath, id) => {
+    assertSafeId(id);
+    const sub = (0, paths_1.projectSubdirs)(projectPath);
+    return path.join(sub.sessions, `${id}.jsonl`);
+};
+const deriveSourceFromId = (id) => id.startsWith('chat-') ? 'chat' : 'repl';
+// ---------- Replay ----------
+/**
+ * Fold an event stream into a Conversation. Handles both new and legacy
+ * events. When legacy `user`/`result` entries are seen without a prior
+ * `session-created`, we synthesise a minimal meta from the file name +
+ * first event timestamp.
+ */
+const replay = (events, id, projectPath) => {
+    let meta = null;
+    const turns = [];
+    let firstTimestamp = '';
+    let lastTimestamp = '';
+    const now = () => new Date().toISOString();
+    for (const ev of events) {
+        // Unified format (discriminated by `kind`).
+        if ('kind' in ev) {
+            lastTimestamp = ev.at;
+            if (!firstTimestamp)
+                firstTimestamp = ev.at;
+            switch (ev.kind) {
+                case 'session-created':
+                    meta = { ...ev.meta };
+                    break;
+                case 'turn-user':
+                    turns.push({ ...ev.turn });
+                    break;
+                case 'turn-result': {
+                    const t = turns.find((x) => x.id === ev.turnId || x.taskId === ev.taskId);
+                    if (t) {
+                        t.result = ev.result;
+                        t.status = ev.status;
+                        if (!t.taskId)
+                            t.taskId = ev.taskId;
+                    }
+                    break;
+                }
+                case 'meta-updated': {
+                    if (meta) {
+                        const patch = (ev.patch ?? {});
+                        meta = Object.assign({}, meta, patch, { updatedAt: ev.at });
+                    }
+                    break;
+                }
+            }
+            continue;
+        }
+        // Legacy format (SessionEntry { type, content, timestamp }).
+        if (ev.type === 'user') {
+            lastTimestamp = ev.timestamp;
+            if (!firstTimestamp)
+                firstTimestamp = ev.timestamp;
+            const c = ev.content;
+            turns.push({
+                id: `legacy-${turns.length}`,
+                at: ev.timestamp,
+                input: c.input ?? '',
+                mode: c.mode ?? 'balanced',
+                status: 'pending',
+            });
+        }
+        else if (ev.type === 'result' && turns.length) {
+            lastTimestamp = ev.timestamp;
+            const last = turns[turns.length - 1];
+            const raw = (ev.content ?? {});
+            const r = {
+                taskId: String(raw.taskId ?? ''),
+                success: Boolean(raw.success),
+                summary: String(raw.summary ?? ''),
+                filesChanged: Array.isArray(raw.filesChanged) ? raw.filesChanged : [],
+                durationMs: Number(raw.durationMs ?? 0),
+                costUsd: typeof raw.costUsd === 'number' ? raw.costUsd : undefined,
+            };
+            last.result = r;
+            last.status = r.success ? 'done' : 'failed';
+            if (!last.taskId && r.taskId)
+                last.taskId = r.taskId;
+        }
+    }
+    if (!meta) {
+        // Synthesise from file name + first user turn if available.
+        const firstInput = turns[0]?.input ?? '';
+        meta = {
+            id,
+            projectPath,
+            title: firstInput.slice(0, 80) || 'Untitled',
+            mode: turns[0]?.mode ?? 'balanced',
+            source: deriveSourceFromId(id),
+            createdAt: firstTimestamp || now(),
+            updatedAt: lastTimestamp || firstTimestamp || now(),
+        };
+    }
+    else if (lastTimestamp) {
+        meta = { ...meta, updatedAt: lastTimestamp };
+    }
+    return { meta, turns };
+};
+const createConversation = async (opts) => {
+    const source = opts.source ?? 'chat';
+    const id = opts.id ? opts.id : `${source}-${(0, trace_1.newSessionId)()}`;
+    (0, paths_1.ensureProjectDir)(opts.projectPath);
+    const meta = {
+        id,
+        projectPath: opts.projectPath,
+        title: opts.title ?? 'New conversation',
+        mode: opts.mode ?? 'balanced',
+        source,
+        createdAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+    };
+    const event = { at: meta.createdAt, kind: 'session-created', meta };
+    await (0, conversation_store_1.atomicAppendLine)(conversationPath(opts.projectPath, id), JSON.stringify(event));
+    return { meta, turns: [] };
+};
+exports.createConversation = createConversation;
+const loadConversation = (projectPath, id) => {
+    // Reject invalid ids with a `null` result rather than throwing so callers
+    // (CLI /load, HTTP GET) can treat "bad id" and "missing" identically.
+    if (!(0, exports.isValidConversationId)(id))
+        return null;
+    const file = conversationPath(projectPath, id);
+    if (!fs.existsSync(file))
+        return null;
+    const events = (0, conversation_store_1.readAllLines)(file);
+    if (!events.length)
+        return null;
+    return replay(events, id, projectPath);
+};
+exports.loadConversation = loadConversation;
+const listConversations = (projectPath) => {
+    const sub = (0, paths_1.projectSubdirs)(projectPath);
+    if (!fs.existsSync(sub.sessions))
+        return [];
+    const files = fs.readdirSync(sub.sessions).filter((f) => {
+        if (!f.endsWith('.jsonl'))
+            return false;
+        return f.startsWith('repl-') || f.startsWith('chat-') || f.startsWith('conv-');
+    });
+    const out = [];
+    for (const f of files) {
+        const full = path.join(sub.sessions, f);
+        const id = path.basename(f, '.jsonl');
+        try {
+            const stat = fs.statSync(full);
+            const events = (0, conversation_store_1.readAllLines)(full);
+            if (!events.length)
+                continue;
+            const conv = replay(events, id, projectPath);
+            out.push({
+                id: conv.meta.id,
+                source: conv.meta.source ?? deriveSourceFromId(conv.meta.id),
+                title: conv.meta.title,
+                mode: conv.meta.mode,
+                turns: conv.turns.length,
+                createdAt: conv.meta.createdAt,
+                lastAt: conv.meta.updatedAt,
+                sizeBytes: stat.size,
+            });
+        }
+        catch (err) {
+            logger_1.log.warn('conversation summary skip', { file: f, err: String(err) });
+        }
+    }
+    out.sort((a, b) => b.lastAt.localeCompare(a.lastAt));
+    return out;
+};
+exports.listConversations = listConversations;
+const appendUserTurn = async (projectPath, conversationId, turn) => {
+    const event = { at: turn.at, kind: 'turn-user', turn };
+    await (0, conversation_store_1.atomicAppendLine)(conversationPath(projectPath, conversationId), JSON.stringify(event));
+};
+exports.appendUserTurn = appendUserTurn;
+const attachTurnResult = async (projectPath, conversationId, args) => {
+    const event = {
+        at: new Date().toISOString(),
+        kind: 'turn-result',
+        turnId: args.turnId,
+        taskId: args.taskId,
+        result: args.result,
+        status: args.status,
+    };
+    await (0, conversation_store_1.atomicAppendLine)(conversationPath(projectPath, conversationId), JSON.stringify(event));
+};
+exports.attachTurnResult = attachTurnResult;
+/** Synchronous variant of attachTurnResult for callers that can't await
+ *  (task-runner's resolution listeners). */
+const attachTurnResultSync = (projectPath, conversationId, args) => {
+    const event = {
+        at: new Date().toISOString(),
+        kind: 'turn-result',
+        turnId: args.turnId,
+        taskId: args.taskId,
+        result: args.result,
+        status: args.status,
+    };
+    (0, conversation_store_1.atomicAppendLineSync)(conversationPath(projectPath, conversationId), JSON.stringify(event));
+};
+exports.attachTurnResultSync = attachTurnResultSync;
+const renameConversation = async (projectPath, conversationId, title) => {
+    const event = {
+        at: new Date().toISOString(),
+        kind: 'meta-updated',
+        patch: { title: title.slice(0, 120) },
+    };
+    await (0, conversation_store_1.atomicAppendLine)(conversationPath(projectPath, conversationId), JSON.stringify(event));
+};
+exports.renameConversation = renameConversation;
+const deleteConversation = (projectPath, conversationId) => {
+    // Match the load/lookup semantics: bad ids are treated as "not present"
+    // rather than throwing, so callers can unconditionally call and check.
+    if (!(0, exports.isValidConversationId)(conversationId))
+        return false;
+    const file = conversationPath(projectPath, conversationId);
+    if (!fs.existsSync(file))
+        return false;
+    try {
+        fs.rmSync(file);
+        // clean up any stray lockfile
+        fs.rmdirSync(`${file}.lock`, { recursive: false });
+    }
+    catch {
+        /* non-fatal */
+    }
+    return true;
+};
+exports.deleteConversation = deleteConversation;
+const findConversationFile = (projectPath, conversationId) => conversationPath(projectPath, conversationId);
+exports.findConversationFile = findConversationFile;
+/**
+ * Watch a conversation file for appended events. Higher-level than the store
+ * watcher: it delivers typed ConvEvents and annotates which turns were newly
+ * added or completed. Used by CLI REPL to display cross-terminal edits and
+ * by the UI to push live updates to connected browsers.
+ */
+const watchConversationFile = (projectPath, conversationId, onUpdate) => {
+    // Snapshot the current state so we can diff against new events.
+    const snapshot = (0, exports.loadConversation)(projectPath, conversationId);
+    const knownTurns = new Map();
+    if (snapshot)
+        for (const t of snapshot.turns)
+            knownTurns.set(t.id, { ...t });
+    return (0, conversation_store_1.watchConversation)(conversationPath(projectPath, conversationId), (items) => {
+        // Filter to unified events; legacy events in live-written files are rare.
+        const convEvents = [];
+        for (const item of items) {
+            if (item && typeof item === 'object' && 'kind' in item) {
+                convEvents.push(item);
+            }
+        }
+        if (!convEvents.length)
+            return;
+        const newTurns = [];
+        const completedTurns = [];
+        let metaChanged = false;
+        for (const ev of convEvents) {
+            if (ev.kind === 'turn-user') {
+                if (!knownTurns.has(ev.turn.id)) {
+                    knownTurns.set(ev.turn.id, { ...ev.turn });
+                    newTurns.push(ev.turn);
+                }
+            }
+            else if (ev.kind === 'turn-result') {
+                const existing = knownTurns.get(ev.turnId) ?? null;
+                const prior = existing?.status ?? 'pending';
+                const updated = existing
+                    ? { ...existing, taskId: ev.taskId, status: ev.status, result: ev.result }
+                    : {
+                        id: ev.turnId,
+                        at: ev.at,
+                        input: '',
+                        mode: 'balanced',
+                        taskId: ev.taskId,
+                        status: ev.status,
+                        result: ev.result,
+                    };
+                knownTurns.set(ev.turnId, updated);
+                completedTurns.push({ turn: updated, prior });
+            }
+            else if (ev.kind === 'meta-updated' || ev.kind === 'session-created') {
+                metaChanged = true;
+            }
+        }
+        onUpdate({
+            events: convEvents,
+            newTurns,
+            completedTurns,
+            metaChanged,
+        });
+    });
+};
+exports.watchConversationFile = watchConversationFile;
+// ---------- Context threading ----------
+exports.MAX_TURNS_IN_CONTEXT = 6;
+/**
+ * Produce a planner-friendly description that embeds prior turns as context
+ * so the agent sees the conversation so far. The latest user input is the
+ * headline; older turns are summarised.
+ *
+ * Kept small and deterministic — no LLM calls, no heavyweight formatting.
+ */
+const composeDescription = (newInput, turns, maxTurns = exports.MAX_TURNS_IN_CONTEXT) => {
+    const prior = turns.filter((t) => t.status === 'done' || t.status === 'failed').slice(-maxTurns);
+    if (!prior.length)
+        return newInput;
+    const lines = [
+        '## Current request',
+        newInput,
+        '',
+        '## Conversation so far (earliest → latest)',
+    ];
+    prior.forEach((t, i) => {
+        const r = t.result;
+        lines.push(`${i + 1}. user: ${t.input.replace(/\s+/g, ' ').slice(0, 240)}`);
+        if (r) {
+            lines.push(`   assistant: ${r.success ? 'OK' : 'FAILED'} — ${(r.summary ?? '').replace(/\s+/g, ' ').slice(0, 240)}`);
+            if (r.filesChanged?.length) {
+                const shown = r.filesChanged.slice(0, 6).join(', ');
+                const extra = r.filesChanged.length > 6 ? ` …+${r.filesChanged.length - 6}` : '';
+                lines.push(`   files: ${shown}${extra}`);
+            }
+        }
+    });
+    lines.push('', '## Notes');
+    lines.push('- "Current request" is the user\'s latest message; prior turns are context only.');
+    lines.push('- Prefer extending files already touched in prior turns when relevant.');
+    return lines.join('\n');
+};
+exports.composeDescription = composeDescription;
+// ---------- Turn ID helpers ----------
+const newTurnId = () => `turn-${(0, trace_1.newSessionId)()}`;
+exports.newTurnId = newTurnId;
+//# sourceMappingURL=conversation.js.map

package/dist/core/conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../../src/core/conversation.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAC7B,2CAAmE;AACnE,4CAAgD;AAEhD,0EAM2C;AAC3C,8CAAwC;AA6ExC,8BAA8B;AAE9B;;;;;GAKG;AACH,MAAM,UAAU,GAAG,kCAAkC,CAAC;AAEtD,MAAM,YAAY,GAAG,CAAC,EAAU,EAAQ,EAAE;IACxC,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,6BAA6B,EAAE,+CAA+C,CAAC,CAAC;IAClG,CAAC;AACH,CAAC,CAAC;AAEF;yBACyB;AAClB,MAAM,qBAAqB,GAAG,CAAC,EAAU,EAAW,EAAE;IAC3D,IAAI,CAAC;QACH,YAAY,CAAC,EAAE,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAPW,QAAA,qBAAqB,yBAOhC;AAEF,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAE,EAAU,EAAU,EAAE;IACnE,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,MAAM,GAAG,GAAG,IAAA,sBAAc,EAAC,WAAW,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,EAAU,EAAsB,EAAE,CAC5D,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AAE3C,+BAA+B;AAE/B;;;;;GAKG;AACH,MAAM,MAAM,GAAG,CAAC,MAAkB,EAAE,EAAU,EAAE,WAAmB,EAAgB,EAAE;IACnF,IAAI,IAAI,GAA4B,IAAI,CAAC;IACzC,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,IAAI,aAAa,GAAG,EAAE,CAAC;IAEvB,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,4CAA4C;QAC5C,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;YACjB,aAAa,GAAG,EAAE,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,cAAc;gBAAE,cAAc,GAAG,EAAE,CAAC,EAAE,CAAC;YAC5C,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;gBAChB,KAAK,iBAAiB;oBACpB,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;oBACtB,MAAM;gBACR,KAAK,WAAW;oBACd,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC3B,MAAM;gBACR,KAAK,aAAa,CAAC,CAAC,CAAC;oBACnB,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;oBAC1E,IAAI,CAAC,EAAE,CAAC;wBACN,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;wBACrB,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;wBACrB,IAAI,CAAC,CAAC,CAAC,MAAM;4BAAE,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;oBACtC,CAAC;oBACD,MAAM;gBACR,CAAC;gBACD,KAAK,cAAc,CAAC,CAAC,CAAC;oBACpB,IAAI,IAAI,EAAE,CAAC;wBACT,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;wBAC1D,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAqB,CAAC;oBAClF,CAAC;oBACD,MAAM;gBACR,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QACD,6DAA6D;QAC7D,IAAI,EAAE,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACvB,aAAa,GAAG,EAAE,CAAC,SAAS,CAAC;YAC7B,IAAI,CAAC,cAAc;gBAAE,cAAc,GAAG,EAAE,CAAC,SAAS,CAAC;YACnD,MAAM,CAAC,GAAG,EAAE,CAAC,OAA0C,CAAC;YACxD,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,UAAU,KAAK,CAAC,MAAM,EAAE;gBAC5B,EAAE,EAAE,EAAE,CAAC,SAAS;gBAChB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;gBACpB,IAAI,EAAG,CAAC,CAAC,IAAa,IAAI,UAAU;gBACpC,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAChD,aAAa,GAAG,EAAE,CAAC,SAAS,CAAC;YAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACrC,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,OAAO,IAAI,EAAE,CAA4B,CAAC;YAC1D,MAAM,CAAC,GAAe;gBACpB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;gBAChC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;gBAC7B,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;gBAClC,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,YAAyB,CAAC,CAAC,CAAC,EAAE;gBACnF,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC;gBACvC,OAAO,EAAE,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;aACnE,CAAC;YACF,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YAChB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC5C,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM;gBAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACvD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,4DAA4D;QAC5D,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;QACzC,IAAI,GAAG;YACL,EAAE;YACF,WAAW;YACX,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU;YAC5C,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,UAAU;YAClC,MAAM,EAAE,kBAAkB,CAAC,EAAE,CAAC;YAC9B,SAAS,EAAE,cAAc,IAAI,GAAG,EAAE;YAClC,SAAS,EAAE,aAAa,IAAI,cAAc,IAAI,GAAG,EAAE;SACpD,CAAC;IACJ,CAAC;SAAM,IAAI,aAAa,EAAE,CAAC;QACzB,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;IAC/C,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC,CAAC;AAaK,MAAM,kBAAkB,GAAG,KAAK,EAAE,IAA4B,EAAyB,EAAE;IAC9F,MAAM,MAAM,GAAuB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC;IACzD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAA,oBAAY,GAAE,EAAE,CAAC;IAC7D,IAAA,wBAAgB,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnC,MAAM,IAAI,GAAqB;QAC7B,EAAE;QACF,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,kBAAkB;QACvC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,UAAU;QAC7B,MAAM;QACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IACF,MAAM,KAAK,GAAc,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAC/E,MAAM,IAAA,qCAAgB,EAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACtF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAC7B,CAAC,CAAC;AAhBW,QAAA,kBAAkB,sBAgB7B;AAEK,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAE,EAAU,EAAuB,EAAE;IACvF,0EAA0E;IAC1E,sEAAsE;IACtE,IAAI,CAAC,IAAA,6BAAqB,EAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,IAAI,GAAG,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,MAAM,GAAG,IAAA,iCAAY,EAAW,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;AACzC,CAAC,CAAC;AATW,QAAA,gBAAgB,oBAS3B;AAEK,MAAM,iBAAiB,GAAG,CAAC,WAAmB,EAAyB,EAAE;IAC9E,MAAM,GAAG,GAAG,IAAA,sBAAc,EAAC,WAAW,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACtD,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QACxC,OAAO,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IACH,MAAM,GAAG,GAA0B,EAAE,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACxC,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAA,iCAAY,EAAW,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,MAAM;gBAAE,SAAS;YAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;YAC7C,GAAG,CAAC,IAAI,CAAC;gBACP,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;gBAChB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5D,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;gBACtB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;gBACpB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;gBACxB,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;gBAC9B,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;gBAC3B,SAAS,EAAE,IAAI,CAAC,IAAI;aACrB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAhCW,QAAA,iBAAiB,qBAgC5B;AAEK,MAAM,cAAc,GAAG,KAAK,EACjC,WAAmB,EACnB,cAAsB,EACtB,IAAsB,EACP,EAAE;IACjB,MAAM,KAAK,GAAc,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAClE,MAAM,IAAA,qCAAgB,EAAC,gBAAgB,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/F,CAAC,CAAC;AAPW,QAAA,cAAc,kBAOzB;AAEK,MAAM,gBAAgB,GAAG,KAAK,EACnC,WAAmB,EACnB,cAAsB,EACtB,IAAgF,EACjE,EAAE;IACjB,MAAM,KAAK,GAAc;QACvB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;IACF,MAAM,IAAA,qCAAgB,EAAC,gBAAgB,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/F,CAAC,CAAC;AAdW,QAAA,gBAAgB,oBAc3B;AAEF;4CAC4C;AACrC,MAAM,oBAAoB,GAAG,CAClC,WAAmB,EACnB,cAAsB,EACtB,IAAgF,EAC1E,EAAE;IACR,MAAM,KAAK,GAAc;QACvB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;IACF,IAAA,yCAAoB,EAAC,gBAAgB,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7F,CAAC,CAAC;AAdW,QAAA,oBAAoB,wBAc/B;AAEK,MAAM,kBAAkB,GAAG,KAAK,EACrC,WAAmB,EACnB,cAAsB,EACtB,KAAa,EACE,EAAE;IACjB,MAAM,KAAK,GAAc;QACvB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;KACtC,CAAC;IACF,MAAM,IAAA,qCAAgB,EAAC,gBAAgB,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/F,CAAC,CAAC;AAXW,QAAA,kBAAkB,sBAW7B;AAEK,MAAM,kBAAkB,GAAG,CAAC,WAAmB,EAAE,cAAsB,EAAW,EAAE;IACzF,wEAAwE;IACxE,uEAAuE;IACvE,IAAI,CAAC,IAAA,6BAAqB,EAAC,cAAc,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,MAAM,IAAI,GAAG,gBAAgB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC3D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChB,8BAA8B;QAC9B,EAAE,CAAC,SAAS,CAAC,GAAG,IAAI,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAdW,QAAA,kBAAkB,sBAc7B;AAEK,MAAM,oBAAoB,GAAG,CAAC,WAAmB,EAAE,cAAsB,EAAU,EAAE,CAC1F,gBAAgB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AADnC,QAAA,oBAAoB,wBACe;AAWhD;;;;;GAKG;AACI,MAAM,qBAAqB,GAAG,CACnC,WAAmB,EACnB,cAAsB,EACtB,QAA8C,EACzB,EAAE;IACvB,gEAAgE;IAChE,MAAM,QAAQ,GAAG,IAAA,wBAAgB,EAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,IAAI,GAAG,EAA4B,CAAC;IACvD,IAAI,QAAQ;QAAE,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK;YAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAE7E,OAAO,IAAA,sCAAU,EAAW,gBAAgB,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE;QACnF,0EAA0E;QAC1E,MAAM,UAAU,GAAgB,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;gBACvD,UAAU,CAAC,IAAI,CAAC,IAAiB,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,MAAM;YAAE,OAAO;QAE/B,MAAM,QAAQ,GAAuB,EAAE,CAAC;QACxC,MAAM,cAAc,GAAyD,EAAE,CAAC;QAChF,IAAI,WAAW,GAAG,KAAK,CAAC;QAExB,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,EAAE,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;oBAChC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;iBAAM,IAAI,EAAE,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;gBACnD,MAAM,KAAK,GAAe,QAAQ,EAAE,MAAM,IAAI,SAAS,CAAC;gBACxD,MAAM,OAAO,GAAqB,QAAQ;oBACxC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE;oBAC1E,CAAC,CAAC;wBACE,EAAE,EAAE,EAAE,CAAC,MAAM;wBACb,EAAE,EAAE,EAAE,CAAC,EAAE;wBACT,KAAK,EAAE,EAAE;wBACT,IAAI,EAAE,UAAU;wBAChB,MAAM,EAAE,EAAE,CAAC,MAAM;wBACjB,MAAM,EAAE,EAAE,CAAC,MAAM;wBACjB,MAAM,EAAE,EAAE,CAAC,MAAM;qBAClB,CAAC;gBACN,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACnC,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAChD,CAAC;iBAAM,IAAI,EAAE,CAAC,IAAI,KAAK,cAAc,IAAI,EAAE,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACvE,WAAW,GAAG,IAAI,CAAC;YACrB,CAAC;QACH,CAAC;QAED,QAAQ,CAAC;YACP,MAAM,EAAE,UAAU;YAClB,QAAQ;YACR,cAAc;YACd,WAAW;SACZ,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AA1DW,QAAA,qBAAqB,yBA0DhC;AAEF,0CAA0C;AAE7B,QAAA,oBAAoB,GAAG,CAAC,CAAC;AAEtC;;;;;;GAMG;AACI,MAAM,kBAAkB,GAAG,CAChC,QAAgB,EAChB,KAAyB,EACzB,QAAQ,GAAG,4BAAoB,EACvB,EAAE;IACV,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjG,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IACnC,MAAM,KAAK,GAAa;QACtB,oBAAoB;QACpB,QAAQ;QACR,EAAE;QACF,4CAA4C;KAC7C,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,EAAE,CAAC;YACN,KAAK,CAAC,IAAI,CACR,iBAAiB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACzG,CAAC;YACF,IAAI,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAG,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpD,MAAM,KAAK,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjF,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,kFAAkF,CAAC,CAAC;IAC/F,KAAK,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;IACrF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC,CAAC;AA/BW,QAAA,kBAAkB,sBA+B7B;AAEF,wCAAwC;AAEjC,MAAM,SAAS,GAAG,GAAW,EAAE,CAAC,QAAQ,IAAA,oBAAY,GAAE,EAAE,CAAC;AAAnD,QAAA,SAAS,aAA0C"}

package/dist/core/estimation.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Pre-execution resource estimation.
+ *
+ * Produces a human-readable preview: estimated file touches, shell calls,
+ * runtime. Pure heuristics based on the plan structure; the value is in
+ * warning the user before they approve a 30-step plan that will take 10
+ * minutes and hit production DBs.
+ */
+import { Plan } from '../types';
+export interface Estimate {
+    stepCount: number;
+    fileWrites: number;
+    shellCalls: number;
+    networkCalls: number;
+    estimatedSeconds: number;
+    summary: string;
+}
+export declare const estimatePlan: (plan: Plan) => Estimate;
+//# sourceMappingURL=estimation.d.ts.map

package/dist/core/estimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimation.d.ts","sourceRoot":"","sources":["../../src/core/estimation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAkBD,eAAO,MAAM,YAAY,GAAI,MAAM,IAAI,KAAG,QA+BzC,CAAC"}