@code-insights/cli 3.6.1 → 4.0.0

package/server-dist/routes/reflect.js

@@ -0,0 +1,332 @@
+import { Hono } from 'hono';
+import { streamSSE } from 'hono/streaming';
+import { getDb } from '@code-insights/cli/db/client';
+import { jsonrepair } from 'jsonrepair';
+import { createLLMClient } from '../llm/client.js';
+import { requireLLM } from './route-helpers.js';
+import { extractJsonPayload } from '../llm/response-parsers.js';
+import { FRICTION_WINS_SYSTEM_PROMPT, generateFrictionWinsPrompt, RULES_SKILLS_SYSTEM_PROMPT, generateRulesSkillsPrompt, WORKING_STYLE_SYSTEM_PROMPT, generateWorkingStylePrompt, } from '../llm/reflect-prompts.js';
+import { buildWhereClause, buildPeriodFilter, parseIsoWeek, formatIsoWeek, getAggregatedData } from './shared-aggregation.js';
+const app = new Hono();
+const MIN_FACETS_FOR_REFLECT = 8;
+const ALL_SECTIONS = ['friction-wins', 'rules-skills', 'working-style'];
+// Parse LLM JSON response wrapped in <json>...</json> tags with jsonrepair fallback.
+function parseLLMJson(response) {
+    const payload = extractJsonPayload(response);
+    if (!payload)
+        return null;
+    try {
+        return JSON.parse(payload);
+    }
+    catch {
+        try {
+            return JSON.parse(jsonrepair(payload));
+        }
+        catch {
+            return null;
+        }
+    }
+}
+// Detect the dominant source tool from the database to target artifact generation.
+function detectTargetTool(db) {
+    const row = db.prepare(`SELECT source_tool, COUNT(*) as count FROM sessions WHERE deleted_at IS NULL GROUP BY source_tool ORDER BY count DESC LIMIT 1`).get();
+    return row?.source_tool || 'claude-code';
+}
+// POST /api/reflect/generate
+// Body: { sections?: ReflectSection[], period?: string, project?: string, source?: string }
+// SSE endpoint: aggregates facets in code, then calls synthesis prompts for each section.
+// Streams progress events so the UI can show phase-by-phase progress.
+app.post('/generate', requireLLM(), async (c) => {
+    const body = await c.req.json();
+    const sections = body.sections && body.sections.length > 0 ? body.sections : ALL_SECTIONS;
+    const period = body.period || '30d';
+    const db = getDb();
+    const { where, params } = buildWhereClause(period, body.project, body.source);
+    return streamSSE(c, async (stream) => {
+        const abortSignal = c.req.raw.signal;
+        try {
+            await stream.writeSSE({
+                event: 'progress',
+                data: JSON.stringify({ phase: 'aggregating', message: 'Aggregating facets...' }),
+            });
+            const aggregated = getAggregatedData(db, where, params, body.project, body.source);
+            if (aggregated.totalSessions === 0) {
+                await stream.writeSSE({
+                    event: 'error',
+                    data: JSON.stringify({ error: 'No sessions with facets found. Run analysis first.' }),
+                });
+                return;
+            }
+            if (aggregated.totalSessions < MIN_FACETS_FOR_REFLECT) {
+                await stream.writeSSE({
+                    event: 'error',
+                    data: JSON.stringify({
+                        error: `Need at least ${MIN_FACETS_FOR_REFLECT} analyzed sessions for meaningful pattern synthesis. Currently have ${aggregated.totalSessions}. Run session analysis on more sessions first.`,
+                        code: 'INSUFFICIENT_FACETS',
+                        current: aggregated.totalSessions,
+                        required: MIN_FACETS_FOR_REFLECT,
+                    }),
+                });
+                return;
+            }
+            const client = createLLMClient();
+            const results = {};
+            const targetTool = detectTargetTool(db);
+            for (const section of sections) {
+                if (abortSignal.aborted)
+                    break;
+                await stream.writeSSE({
+                    event: 'progress',
+                    data: JSON.stringify({ phase: 'synthesizing', section, message: `Generating ${section}...` }),
+                });
+                if (section === 'friction-wins') {
+                    const prompt = generateFrictionWinsPrompt({
+                        frictionCategories: aggregated.frictionCategories,
+                        effectivePatterns: aggregated.effectivePatterns,
+                        totalSessions: aggregated.totalSessions,
+                        period,
+                        pqSignals: (aggregated.pqDeficits.length || aggregated.pqStrengths.length)
+                            ? { deficits: aggregated.pqDeficits, strengths: aggregated.pqStrengths }
+                            : undefined,
+                    });
+                    const response = await client.chat([
+                        { role: 'system', content: FRICTION_WINS_SYSTEM_PROMPT },
+                        { role: 'user', content: prompt },
+                    ], { signal: abortSignal });
+                    const parsed = parseLLMJson(response.content);
+                    results['friction-wins'] = {
+                        section: 'friction-wins',
+                        ...(parsed ?? {}),
+                        frictionCategories: aggregated.frictionCategories,
+                        effectivePatterns: aggregated.effectivePatterns,
+                        pqDeficits: aggregated.pqDeficits,
+                        pqStrengths: aggregated.pqStrengths,
+                        generatedAt: new Date().toISOString(),
+                    };
+                }
+                else if (section === 'rules-skills') {
+                    // Only include patterns with sufficient occurrence counts for actionable artifacts
+                    const recurringFriction = aggregated.frictionCategories.filter(fc => fc.count >= 3);
+                    const recurringPatterns = aggregated.effectivePatterns.filter(ep => ep.frequency >= 2);
+                    const prompt = generateRulesSkillsPrompt({
+                        recurringFriction,
+                        effectivePatterns: recurringPatterns,
+                        targetTool,
+                    });
+                    const response = await client.chat([
+                        { role: 'system', content: RULES_SKILLS_SYSTEM_PROMPT },
+                        { role: 'user', content: prompt },
+                    ], { signal: abortSignal });
+                    const parsed = parseLLMJson(response.content);
+                    results['rules-skills'] = {
+                        section: 'rules-skills',
+                        ...(parsed ?? {}),
+                        targetTool,
+                        generatedAt: new Date().toISOString(),
+                    };
+                }
+                else if (section === 'working-style') {
+                    const prompt = generateWorkingStylePrompt({
+                        workflowDistribution: aggregated.workflowDistribution,
+                        outcomeDistribution: aggregated.outcomeDistribution,
+                        characterDistribution: aggregated.characterDistribution,
+                        totalSessions: aggregated.totalSessions,
+                        period,
+                        frictionFrequency: aggregated.frictionTotal,
+                    });
+                    const response = await client.chat([
+                        { role: 'system', content: WORKING_STYLE_SYSTEM_PROMPT },
+                        { role: 'user', content: prompt },
+                    ], { signal: abortSignal });
+                    const parsed = parseLLMJson(response.content);
+                    // Sanitize tagline: must be a string ≤40 chars. Non-string LLM outputs
+                    // (object, array, number) are normalized to undefined so they don't
+                    // corrupt the snapshot blob stored in SQLite.
+                    const rawTagline = parsed && parsed['tagline'];
+                    const tagline = typeof rawTagline === 'string'
+                        ? rawTagline.slice(0, 40)
+                        : undefined;
+                    results['working-style'] = {
+                        section: 'working-style',
+                        ...(parsed ?? {}),
+                        tagline,
+                        workflowDistribution: aggregated.workflowDistribution,
+                        outcomeDistribution: aggregated.outcomeDistribution,
+                        characterDistribution: aggregated.characterDistribution,
+                        generatedAt: new Date().toISOString(),
+                    };
+                }
+            }
+            // Only save snapshot if the request was not aborted mid-generation.
+            // Saving partial results would cause stale/incomplete data to auto-load on next visit.
+            if (!c.req.raw.signal.aborted) {
+                // For ISO week periods, use the exact week boundaries as window metadata.
+                // This ensures the snapshot metadata accurately reflects the week it covers.
+                const isoWeekBounds = parseIsoWeek(period);
+                const windowStart = isoWeekBounds
+                    ? isoWeekBounds.start.toISOString()
+                    : buildPeriodFilter(period);
+                const windowEnd = isoWeekBounds
+                    ? isoWeekBounds.end.toISOString()
+                    : new Date().toISOString();
+                const projectKey = body.project || '__all__';
+                db.prepare(`
+          INSERT INTO reflect_snapshots (period, project_id, results_json, generated_at, window_start, window_end, session_count, facet_count)
+          VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+          ON CONFLICT(period, project_id) DO UPDATE SET
+            results_json = excluded.results_json,
+            generated_at = excluded.generated_at,
+            window_start = excluded.window_start,
+            window_end = excluded.window_end,
+            session_count = excluded.session_count,
+            facet_count = excluded.facet_count
+        `).run(period, projectKey, JSON.stringify(results), windowEnd, windowStart, windowEnd, aggregated.totalSessions, aggregated.frictionTotal);
+            }
+            await stream.writeSSE({
+                event: 'complete',
+                data: JSON.stringify({ results }),
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            await stream.writeSSE({
+                event: 'error',
+                data: JSON.stringify({ error: message }),
+            }).catch(() => { });
+        }
+    });
+});
+// GET /api/reflect/results
+// Returns raw aggregated facet data without LLM synthesis (fast, no cost).
+// The full synthesized view requires POST /api/reflect/generate.
+app.get('/results', (c) => {
+    const db = getDb();
+    const period = c.req.query('period') || '30d';
+    const project = c.req.query('project');
+    const source = c.req.query('source');
+    const { where, params } = buildWhereClause(period, project, source);
+    const aggregated = getAggregatedData(db, where, params, project, source);
+    return c.json(aggregated);
+});
+// GET /api/reflect/weeks
+// Returns all ISO weeks from the earliest session through the current week, with snapshot status.
+// Used by the WeekSelector component to show which weeks have reflections.
+// Week list is data-driven (not capped at 8) so users with long history can navigate all weeks.
+app.get('/weeks', (c) => {
+    const db = getDb();
+    const project = c.req.query('project');
+    const projectCondition = project ? 'AND project_id = ?' : '';
+    const projectParams = project ? [project] : [];
+    // Find the earliest session to determine the full week range.
+    // If no sessions exist, return empty array.
+    const earliestRow = db.prepare(`
+    SELECT MIN(started_at) as earliest
+    FROM sessions
+    WHERE deleted_at IS NULL
+      ${projectCondition}
+  `).get(...projectParams);
+    if (!earliestRow?.earliest) {
+        return c.json({ weeks: [] });
+    }
+    // Compute the UTC midnight of the Monday of the current ISO week.
+    // Truncating to midnight ensures the while-loop comparison is stable
+    // regardless of the time-of-day component in started_at values.
+    const now = new Date();
+    const nowDay = now.getUTCDay(); // 0=Sun
+    const daysToMonday = nowDay === 0 ? 6 : nowDay - 1;
+    const thisMondayMs = Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()) - daysToMonday * 86400000;
+    // Compute the UTC midnight of the Monday of the earliest session's ISO week.
+    const earliestDate = new Date(earliestRow.earliest);
+    const earliestDay = earliestDate.getUTCDay();
+    const daysToEarliestMonday = earliestDay === 0 ? 6 : earliestDay - 1;
+    const earliestMondayMs = Date.UTC(earliestDate.getUTCFullYear(), earliestDate.getUTCMonth(), earliestDate.getUTCDate()) - daysToEarliestMonday * 86400000;
+    // Generate all weeks from earliest through current (most recent first).
+    // Cap at 520 weeks (~10 years) to stay under SQLite's 999 bind-variable limit
+    // for the snapshot IN (...) query (each week uses 1 placeholder + 1 for project_id).
+    const MAX_WEEKS = 520;
+    const weekEntries = [];
+    let weekMondayMs = thisMondayMs;
+    while (weekMondayMs >= earliestMondayMs && weekEntries.length < MAX_WEEKS) {
+        const weekMonday = new Date(weekMondayMs);
+        const week = formatIsoWeek(weekMonday);
+        const bounds = parseIsoWeek(week);
+        weekEntries.push({ week, start: bounds.start.toISOString(), end: bounds.end.toISOString() });
+        weekMondayMs -= 7 * 86400000;
+    }
+    const projectKey = project || '__all__';
+    // Query 1: session counts per ISO week using GROUP BY.
+    // The Thursday trick: 'weekday 4' advances to the ISO week's Thursday (or stays if already
+    // Thursday), then '-3 days' gives that week's Monday. This handles all 7 days correctly —
+    // unlike 'weekday 1, -7 days' which overshoots by one week for sessions starting on Monday.
+    // Returns one row per week that has sessions — O(sessions), not O(weeks).
+    const rangeStart = weekEntries[weekEntries.length - 1].start;
+    const rangeEnd = weekEntries[0].end;
+    const sessionCountRaw = db.prepare(`
+    SELECT
+      date(s.started_at, 'weekday 4', '-3 days') as week_monday,
+      COUNT(*) as cnt
+    FROM sessions s
+    WHERE s.deleted_at IS NULL
+      AND s.started_at >= ?
+      AND s.started_at < ?
+      ${projectCondition}
+    GROUP BY week_monday
+  `).all(rangeStart, rangeEnd, ...projectParams);
+    // Build a map from ISO week string -> session count.
+    // week_monday is a YYYY-MM-DD string (SQLite date()); parse it and derive the ISO week string.
+    const sessionCountMap = new Map();
+    for (const row of sessionCountRaw) {
+        const monday = new Date(row.week_monday + 'T00:00:00Z');
+        const weekStr = formatIsoWeek(monday);
+        // Accumulate in case formatIsoWeek maps two slightly-different Mondays to the same week
+        sessionCountMap.set(weekStr, (sessionCountMap.get(weekStr) ?? 0) + row.cnt);
+    }
+    // Query 2: all snapshots for these weeks in one query
+    const weekPlaceholders = weekEntries.map(() => '?').join(', ');
+    const snapshotRows = db.prepare(`
+    SELECT period, generated_at
+    FROM reflect_snapshots
+    WHERE period IN (${weekPlaceholders}) AND project_id = ?
+  `).all(...weekEntries.map(e => e.week), projectKey);
+    const snapshotMap = new Map(snapshotRows.map(r => [r.period, r.generated_at]));
+    const weeks = weekEntries.map((entry) => ({
+        week: entry.week,
+        sessionCount: sessionCountMap.get(entry.week) ?? 0,
+        hasSnapshot: snapshotMap.has(entry.week),
+        generatedAt: snapshotMap.get(entry.week) ?? null,
+    }));
+    return c.json({ weeks });
+});
+// GET /api/reflect/snapshot
+// Returns cached reflect results for a given period/project combo.
+app.get('/snapshot', (c) => {
+    const db = getDb();
+    const period = c.req.query('period') || '30d';
+    const project = c.req.query('project') || '__all__';
+    const row = db.prepare(`SELECT * FROM reflect_snapshots WHERE period = ? AND project_id = ?`).get(period, project);
+    if (!row) {
+        return c.json({ snapshot: null });
+    }
+    let results;
+    try {
+        results = JSON.parse(row.results_json);
+    }
+    catch {
+        // Corrupted snapshot data — treat as if no snapshot exists
+        return c.json({ snapshot: null });
+    }
+    return c.json({
+        snapshot: {
+            period: row.period,
+            projectId: row.project_id,
+            results,
+            generatedAt: row.generated_at,
+            windowStart: row.window_start,
+            windowEnd: row.window_end,
+            sessionCount: row.session_count,
+            facetCount: row.facet_count,
+        },
+    });
+});
+export default app;
+//# sourceMappingURL=reflect.js.map

package/server-dist/routes/reflect.js.map

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

package/server-dist/routes/route-helpers.d.ts

@@ -0,0 +1,124 @@
+import type { Context, MiddlewareHandler } from 'hono';
+import { streamSSE } from 'hono/streaming';
+import { getDb } from '@code-insights/cli/db/client';
+import type { AnalysisResult, AnalysisOptions } from '../llm/analysis.js';
+import type { SessionData } from '../llm/analysis-db.js';
+import type { SQLiteMessageRow } from '../llm/prompt-types.js';
+/**
+ * Load a session row for LLM analysis. Returns undefined if the session doesn't exist
+ * or has been soft-deleted. The selected columns match exactly what the analysis engine
+ * expects via the SessionData interface.
+ */
+export declare function loadSessionForAnalysis(db: ReturnType<typeof getDb>, sessionId: string): SessionData | undefined;
+/**
+ * Load all messages for a session, ordered by timestamp ascending.
+ * The selected columns match the SQLiteMessageRow interface consumed by the analysis engine.
+ */
+export declare function loadSessionMessages(db: ReturnType<typeof getDb>, sessionId: string): SQLiteMessageRow[];
+/**
+ * Hono middleware factory that short-circuits with a 400 if no LLM provider is configured.
+ * Apply per-route: app.post('/route', requireLLM(), async (c) => { ... })
+ * The error shape { success: false, error: '...' } matches the analysis endpoint convention.
+ */
+export declare function requireLLM(): MiddlewareHandler;
+/**
+ * Options for trackAnalysisResult. Callers may supply an onSuccess callback for
+ * any handler-specific events (e.g., insight_generated) that fire only on success.
+ */
+interface TrackAnalysisOptions {
+    /** Called after the success-path analysis_run event — emit extra events here. */
+    onSuccess?: () => void;
+}
+/**
+ * Emit the 'analysis_run' telemetry event (and captureError on failure) for a
+ * completed analysis call. Encapsulates the boilerplate shared across the session,
+ * prompt-quality, and recurring handlers in analysis.ts.
+ *
+ * Usage:
+ *   trackAnalysisResult('session', result, startTime, {
+ *     onSuccess: () => trackEvent('insight_generated', { type: 'session', count: result.insights.length }),
+ *   });
+ */
+export declare function trackAnalysisResult(analysisType: string, result: Pick<AnalysisResult, 'success' | 'error' | 'error_type' | 'response_preview'>, startTime: number, options?: TrackAnalysisOptions): void;
+/**
+ * Build the human-readable progress message for a session analysis stream event.
+ * The session analysis handler uses chunk-count information; the prompt-quality
+ * handler uses a fixed string. Accept a resolver callback so each caller decides.
+ */
+type ProgressMessageFn = (progress: {
+    phase: string;
+    currentChunk?: number;
+    totalChunks?: number;
+}) => string;
+/**
+ * Options for streamSessionAnalysis.
+ */
+interface StreamSessionAnalysisOptions {
+    /**
+     * Human-readable telemetry type string (e.g. 'session', 'prompt-quality').
+     * Used as the `type` field in the analysis_run event.
+     */
+    analysisType: string;
+    /**
+     * The analysis function to call. Must match the signature of analyzeSession /
+     * analyzePromptQuality — accepts (session, messages, options?) and returns AnalysisResult.
+     */
+    analysisFn: (session: SessionData, messages: SQLiteMessageRow[], options?: AnalysisOptions) => Promise<AnalysisResult>;
+    /**
+     * Resolve the progress event message from the current progress state.
+     * Called inside the onProgress callback to build the human-readable 'message' field.
+     */
+    progressMessage: ProgressMessageFn;
+    /**
+     * Called on the success path after tracking telemetry (e.g. to apply a generated title
+     * or emit an insight_generated event). Receives the successful AnalysisResult.
+     */
+    onSuccess?: (result: AnalysisResult) => void;
+}
+/**
+ * Shared SSE lifecycle for single-session analysis stream endpoints.
+ * Handles the streamSSE wrapper, abort signal, progress events, result telemetry,
+ * and complete/error SSE events. The two analysis stream handlers (session and
+ * prompt-quality) differed only in their progress message and analysis function —
+ * those are injected via options.
+ *
+ * Preserves the exact SSE event names and complete/error payload shapes the
+ * dashboard expects: progress → { phase, message, ...progress }, complete →
+ * { success, insightCount, tokenUsage }, error → { error }.
+ */
+export declare function streamSessionAnalysis(c: Context, session: SessionData, messages: SQLiteMessageRow[], opts: StreamSessionAnalysisOptions): ReturnType<typeof streamSSE>;
+/**
+ * Options for streamBatchBackfill. The two backfill handlers (facets and PQ) share
+ * the same loop structure but differ in how they check for existing work and which
+ * analysis function they call.
+ */
+export interface StreamBatchBackfillOptions {
+    /**
+     * Returns true if the session should be skipped (work already done).
+     * Only called when force=false; callers implement the appropriate SQL check.
+     */
+    shouldSkip: (sessionId: string) => boolean;
+    /**
+     * The analysis function to run for each session. Receives the loaded session,
+     * its messages, and an AbortSignal. Returns a result with a success boolean.
+     */
+    analysisFn: (session: SessionData, messages: SQLiteMessageRow[], options: {
+        signal: AbortSignal;
+    }) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+/**
+ * Shared SSE lifecycle for batch backfill endpoints (facets backfill and PQ backfill).
+ * Iterates sessionIds one-by-one, streaming per-session progress events and a final
+ * complete event. Preserves the exact SSE payload shapes the dashboard expects:
+ *   progress → { completed, failed, total, currentSessionId, error? }
+ *   complete → { completed, failed, total }
+ *
+ * The caller is responsible for request body validation (sessionIds array present,
+ * length ≤ MAX_BACKFILL_SESSIONS) before calling this helper.
+ */
+export declare function streamBatchBackfill(c: Context, sessionIds: string[], force: boolean, opts: StreamBatchBackfillOptions): ReturnType<typeof streamSSE>;
+export {};
+//# sourceMappingURL=route-helpers.d.ts.map

package/server-dist/routes/route-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-helpers.d.ts","sourceRoot":"","sources":["../../src/routes/route-helpers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAIrD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAM/G;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAKvG;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,iBAAiB,CAU9C;AAID;;;GAGG;AACH,UAAU,oBAAoB;IAC5B,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,kBAAkB,CAAC,EACrF,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,IAAI,CAuBN;AAID;;;;GAIG;AACH,KAAK,iBAAiB,GAAG,CAAC,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,MAAM,CAAC;AAE9G;;GAEG;AACH,UAAU,4BAA4B;IACpC;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,EAAE,CACV,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,OAAO,CAAC,EAAE,eAAe,KACtB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B;;;OAGG;IACH,eAAe,EAAE,iBAAiB,CAAC;IACnC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,OAAO,EACV,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,IAAI,EAAE,4BAA4B,GACjC,UAAU,CAAC,OAAO,SAAS,CAAC,CA0F9B;AAID;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C;;;OAGG;IACH,UAAU,EAAE,CACV,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,KAC7B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,OAAO,EACV,UAAU,EAAE,MAAM,EAAE,EACpB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,0BAA0B,GAC/B,UAAU,CAAC,OAAO,SAAS,CAAC,CA2D9B"}