@massa-ai/core 1.2.1

package/dist/scripts/symbol-benchmark.js

@@ -0,0 +1,319 @@
+#!/usr/bin/env bun
+/**
+ * Symbol Benchmark (symbol-benchmark.ts)
+ *
+ * Mede a qualidade e performance do Symbol Graph sobre o próprio projeto massa-ai.
+ *
+ * Métricas coletadas:
+ *   - listDefinitions  : latência p50/p95, total de símbolos indexados
+ *   - goToDefinition   : hit-rate e latência para fixtures conhecidas
+ *   - getReferences    : recall e latência para fixtures conhecidas
+ *   - centralityRank   : verifica que símbolos "hub" têm score > threshold
+ *
+ * Uso:
+ *   bun packages/core/src/scripts/symbol-benchmark.ts [--projectPath <path>] [--projectId <id>] [--k <n>]
+ *
+ * Argumentos:
+ *   --projectPath   Caminho absoluto do projeto a indexar (padrão: cwd)
+ *   --projectId     ID do projeto no Symbol Graph (padrão: "massa-ai-bench")
+ *   --k             Top-K para hit-rate (padrão: 3)
+ *   --forceReindex  Limpar índice antes de indexar (padrão: false)
+ *   --json          Saída em JSON puro (padrão: false, modo pretty)
+ */
+import fsSync from "fs";
+import path from "path";
+import dotenv from "dotenv";
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function resolveEnvPath(startDir) {
+    let current = path.resolve(startDir);
+    let firstFound = null;
+    while (true) {
+        const candidate = path.join(current, ".env");
+        if (fsSync.existsSync(candidate)) {
+            if (!firstFound)
+                firstFound = candidate;
+            const pkgJson = path.join(current, "package.json");
+            if (fsSync.existsSync(pkgJson)) {
+                try {
+                    const content = fsSync.readFileSync(pkgJson, "utf-8");
+                    if (content.includes('"workspaces"'))
+                        return candidate;
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            return firstFound;
+        current = parent;
+    }
+}
+function loadEnvironment() {
+    const explicit = process.env.DOTENV_CONFIG_PATH;
+    const envPath = explicit || resolveEnvPath(process.cwd());
+    if (!envPath) {
+        console.warn("[symbol-bench] .env not found; using existing process environment");
+        return;
+    }
+    const result = dotenv.config({ path: envPath, override: false });
+    if (result.error) {
+        console.warn(`[symbol-bench] failed to load .env at ${envPath}: ${result.error.message}`);
+        return;
+    }
+    console.log(`[symbol-bench] loaded .env from ${envPath}`);
+}
+function parseArgs(argv) {
+    const args = new Map();
+    for (let i = 2; i < argv.length; i += 1) {
+        const key = argv[i];
+        if (!key.startsWith("--"))
+            continue;
+        const next = argv[i + 1];
+        if (!next || next.startsWith("--")) {
+            args.set(key.slice(2), "true");
+            continue;
+        }
+        args.set(key.slice(2), next);
+        i += 1;
+    }
+    return {
+        projectPath: path.resolve(args.get("projectPath") || process.cwd()),
+        projectId: args.get("projectId") || "massa-ai-bench",
+        k: Number(args.get("k") || "3"),
+        forceReindex: args.get("forceReindex") === "true",
+        jsonOutput: args.get("json") === "true",
+    };
+}
+function percentile(sorted, p) {
+    if (sorted.length === 0)
+        return 0;
+    const idx = Math.min(sorted.length - 1, Math.floor(sorted.length * p));
+    return sorted[idx];
+}
+function latencyStats(samples) {
+    const sorted = [...samples].sort((a, b) => a - b);
+    const avg = samples.length === 0 ? 0 : samples.reduce((a, b) => a + b, 0) / samples.length;
+    return {
+        p50Ms: percentile(sorted, 0.5),
+        p95Ms: percentile(sorted, 0.95),
+        avgMs: Math.round(avg),
+        minMs: sorted[0] ?? 0,
+        maxMs: sorted[sorted.length - 1] ?? 0,
+        samples: samples.length,
+    };
+}
+function measure(fn) {
+    const start = performance.now();
+    return fn().then((result) => ({ result, ms: Math.round(performance.now() - start) }));
+}
+// ─── Fixtures ─────────────────────────────────────────────────────────────────
+/**
+ * Símbolos que devem existir no projeto massa-ai.
+ * Se o benchmark for usado em outro projeto, apenas os que existirem serão contados.
+ *
+ * Cada fixture declara:
+ *   - name       : nome do símbolo
+ *   - kind       : tipo esperado (function/class/etc.) — opcional para validação
+ *   - minRefs    : mínimo esperado de referências no projeto (0 = só testa latência)
+ */
+const DEFINITION_FIXTURES = [
+    { name: "ContextualSearchRLM", kind: "class", minRefs: 2 },
+    { name: "symbolGraphService", kind: "variable", minRefs: 1 },
+    { name: "workspaceManager", kind: "variable", minRefs: 1 },
+    { name: "computePageRank", kind: "function", minRefs: 1 },
+    { name: "SearchController", kind: "class", minRefs: 1 },
+    { name: "ContextController", kind: "class", minRefs: 0 },
+    { name: "IndexManager", kind: "class", minRefs: 1 },
+    { name: "SearchCache", kind: "class", minRefs: 1 },
+    { name: "smartChunk", kind: "function", minRefs: 1 },
+];
+/**
+ * Símbolos "hub" esperados com centralidade alta.
+ * São os símbolos com mais conexões no grafo de dependências.
+ */
+const HUB_SYMBOLS = [
+    "ContextualSearchRLM",
+    "symbolGraphService",
+    "workspaceManager",
+    "SearchController",
+];
+const CENTRALITY_THRESHOLD = 0.01; // score mínimo para ser considerado "hub"
+// ─── Main ─────────────────────────────────────────────────────────────────────
+async function main() {
+    loadEnvironment();
+    const { symbolGraphService } = await import("../services/symbol/symbol-graph.service.js");
+    const { ContextualSearchRLM } = await import("../services/search/contextual-search-rlm.js");
+    const contextualSearch = new ContextualSearchRLM();
+    const opts = parseArgs(process.argv);
+    if (!opts.jsonOutput) {
+        console.log("\n╔══════════════════════════════════════════════╗");
+        console.log("║         massa-ai Symbol Graph Benchmark          ║");
+        console.log("╚══════════════════════════════════════════════╝");
+        console.log(`Project path : ${opts.projectPath}`);
+        console.log(`Project ID   : ${opts.projectId}`);
+        console.log(`Top-K        : ${opts.k}`);
+        console.log(`Force reindex: ${opts.forceReindex}`);
+        console.log("");
+    }
+    // ── 1. Indexing ────────────────────────────────────────────────────────────
+    if (opts.forceReindex) {
+        await contextualSearch.clearProjectIndex(opts.projectId);
+        if (!opts.jsonOutput)
+            console.log("[1/5] Cleared existing index.");
+    }
+    if (!opts.jsonOutput)
+        console.log("[1/5] Indexing project (vector + keyword)...");
+    const indexStart = performance.now();
+    const indexStats = await contextualSearch.indexProject(opts.projectPath, opts.projectId);
+    const indexMs = Math.round(performance.now() - indexStart);
+    if (!opts.jsonOutput) {
+        console.log(`      Done: ${indexStats.filesIndexed} files, ${indexStats.chunksIndexed} chunks in ${indexMs}ms`);
+    }
+    // ── 2. listDefinitions ─────────────────────────────────────────────────────
+    if (!opts.jsonOutput)
+        console.log("[2/5] Benchmarking listDefinitions...");
+    const listLatencies = [];
+    // Warm run (sem cache de símbolo)
+    const { result: allDefsResult } = await measure(() => symbolGraphService.listDefinitions(opts.projectId, { limit: 1000 }));
+    const allDefs = allDefsResult.definitions;
+    // 5 medições para latência estável
+    for (let i = 0; i < 5; i++) {
+        const { ms } = await measure(() => symbolGraphService.listDefinitions(opts.projectId, { limit: 100 }));
+        listLatencies.push(ms);
+    }
+    if (!opts.jsonOutput) {
+        console.log(`      Total symbols indexed: ${allDefs.length}`);
+        console.log(`      Latency (5 runs): avg=${latencyStats(listLatencies).avgMs}ms, p95=${latencyStats(listLatencies).p95Ms}ms`);
+    }
+    // ── 3. goToDefinition hit-rate ─────────────────────────────────────────────
+    if (!opts.jsonOutput)
+        console.log("[3/5] Benchmarking goToDefinition hit-rate...");
+    let gotoHits = 0;
+    const gotoLatencies = [];
+    for (const fixture of DEFINITION_FIXTURES) {
+        const { result: defs, ms } = await measure(() => symbolGraphService.goToDefinition(opts.projectId, fixture.name));
+        gotoLatencies.push(ms);
+        const hit = defs.length > 0;
+        if (hit)
+            gotoHits++;
+        if (!opts.jsonOutput) {
+            const kindMatch = !fixture.kind || defs.some((d) => d.kind === fixture.kind);
+            const status = hit ? (kindMatch ? "✓" : "⚠ wrong kind") : "✗";
+            console.log(`      ${status} ${fixture.name} (${ms}ms, ${defs.length} result(s))`);
+        }
+    }
+    const gotoHitRate = DEFINITION_FIXTURES.length === 0 ? 0 : gotoHits / DEFINITION_FIXTURES.length;
+    // ── 4. getReferences recall ────────────────────────────────────────────────
+    if (!opts.jsonOutput)
+        console.log("[4/5] Benchmarking getReferences recall...");
+    let refsWithResults = 0;
+    const refLatencies = [];
+    // Only test symbols that had a definition hit (otherwise refs are expected empty)
+    const fixturesWithDef = DEFINITION_FIXTURES.filter((f) => f.minRefs > 0);
+    for (const fixture of fixturesWithDef) {
+        const { result: refs, ms } = await measure(() => symbolGraphService.getReferences(opts.projectId, fixture.name));
+        refLatencies.push(ms);
+        const hasEnoughRefs = refs.length >= fixture.minRefs;
+        if (hasEnoughRefs)
+            refsWithResults++;
+        if (!opts.jsonOutput) {
+            const status = hasEnoughRefs ? "✓" : "⚠";
+            console.log(`      ${status} ${fixture.name}: ${refs.length} ref(s) (expected ≥${fixture.minRefs}, ${ms}ms)`);
+        }
+    }
+    const recallRate = fixturesWithDef.length === 0 ? 1 : refsWithResults / fixturesWithDef.length;
+    // ── 5. centralityRank ──────────────────────────────────────────────────────
+    if (!opts.jsonOutput)
+        console.log("[5/5] Checking centralityRank for hub symbols...");
+    let hubsAboveThreshold = 0;
+    const topByScore = [...allDefs]
+        .filter((d) => d.centralityScore > 0)
+        .sort((a, b) => b.centralityScore - a.centralityScore)
+        .slice(0, 10);
+    for (const hubName of HUB_SYMBOLS) {
+        const match = allDefs.find((d) => d.name === hubName);
+        if (!match) {
+            if (!opts.jsonOutput)
+                console.log(`      ✗ ${hubName}: not found in index`);
+            continue;
+        }
+        const above = match.centralityScore >= CENTRALITY_THRESHOLD;
+        if (above)
+            hubsAboveThreshold++;
+        if (!opts.jsonOutput) {
+            const status = above ? "✓" : "⚠";
+            console.log(`      ${status} ${hubName}: centralityScore=${match.centralityScore.toFixed(4)} (threshold=${CENTRALITY_THRESHOLD})`);
+        }
+    }
+    const hubsChecked = Math.min(HUB_SYMBOLS.length, allDefs.length > 0 ? HUB_SYMBOLS.length : 0);
+    const centralityPassRate = hubsChecked === 0 ? 0 : hubsAboveThreshold / hubsChecked;
+    // ── Result ─────────────────────────────────────────────────────────────────
+    const result = {
+        projectPath: opts.projectPath,
+        projectId: opts.projectId,
+        k: opts.k,
+        timestamp: new Date().toISOString(),
+        indexing: {
+            durationMs: indexMs,
+            symbolsIndexed: allDefs.length,
+            filesIndexed: indexStats.filesIndexed,
+        },
+        listDefinitions: {
+            totalSymbols: allDefs.length,
+            latency: latencyStats(listLatencies),
+        },
+        goToDefinition: {
+            fixtures: DEFINITION_FIXTURES.length,
+            hits: gotoHits,
+            hitRate: gotoHitRate,
+            latency: latencyStats(gotoLatencies),
+        },
+        getReferences: {
+            fixtures: fixturesWithDef.length,
+            withResults: refsWithResults,
+            recallRate,
+            latency: latencyStats(refLatencies),
+        },
+        centralityRank: {
+            hubsChecked,
+            hubsAboveThreshold,
+            passRate: centralityPassRate,
+            threshold: CENTRALITY_THRESHOLD,
+            topSymbols: topByScore.map((d) => ({
+                name: d.name,
+                score: d.centralityScore,
+                file: d.file,
+            })),
+        },
+    };
+    if (opts.jsonOutput) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        console.log("\n═══ SYMBOL BENCHMARK RESULT ═══════════════════════════════");
+        console.log(`Symbols indexed      : ${result.indexing.symbolsIndexed}`);
+        console.log(`Files indexed        : ${result.indexing.filesIndexed}`);
+        console.log(`Index time           : ${result.indexing.durationMs}ms`);
+        console.log(`listDefinitions avg  : ${result.listDefinitions.latency.avgMs}ms (p95: ${result.listDefinitions.latency.p95Ms}ms)`);
+        console.log(`goToDefinition hits  : ${result.goToDefinition.hits}/${result.goToDefinition.fixtures} (${(gotoHitRate * 100).toFixed(1)}%)`);
+        console.log(`goToDefinition avg   : ${result.goToDefinition.latency.avgMs}ms (p95: ${result.goToDefinition.latency.p95Ms}ms)`);
+        console.log(`getReferences recall : ${result.getReferences.withResults}/${result.getReferences.fixtures} (${(recallRate * 100).toFixed(1)}%)`);
+        console.log(`getReferences avg    : ${result.getReferences.latency.avgMs}ms (p95: ${result.getReferences.latency.p95Ms}ms)`);
+        console.log(`Centrality pass rate : ${result.centralityRank.hubsAboveThreshold}/${result.centralityRank.hubsChecked} (${(centralityPassRate * 100).toFixed(1)}%)`);
+        if (topByScore.length > 0) {
+            console.log(`\nTop-5 by centrality:`);
+            topByScore.slice(0, 5).forEach((s, i) => {
+                console.log(`  ${i + 1}. ${s.name} (${s.centralityScore.toFixed(4)}) — ${s.file}`);
+            });
+        }
+        console.log("════════════════════════════════════════════════════════════\n");
+    }
+    process.exit(0);
+}
+main().catch((err) => {
+    console.error("[symbol-bench] Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=symbol-benchmark.js.map

package/dist/scripts/symbol-benchmark.js.map

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

package/dist/services/bootstrap/bootstrap-service.d.ts

@@ -0,0 +1,157 @@
+/**
+ * BootstrapService — Phase 4 repo bootstrap (G6).
+ *
+ * Scans a project root for high-signal context (recent git history, README,
+ * docs, package manifests, top-central files from the existing PageRank ETL)
+ * and turns them into seed memories (types pattern/code/decision) via the
+ * Phase-1 llm-client. Stored through the existing MemoryRepository so they
+ * are searchable by the existing recall/FTS path.
+ *
+ * Contract (spec.md R1–R6, NF1–NF2):
+ *  - Idempotent: a seed memory tagged `bootstrap:<projectId>` is the marker;
+ *    a second run without `force` is a no-op.
+ *  - Silent degradation: when the LLM is off / `{ok:false}` / throws, falls
+ *    back to rule-based minimal seeds derived from README + git log. When
+ *    even those signals are empty, skips seeding with a logged reason.
+ *    NEVER throws.
+ *  - Migration-free: seed memories are rows in the existing memories table.
+ *
+ * Test-isolation (mirrors Phase-3 ObservationConsolidationJob): the ctor
+ * accepts injectable `memoryRepo`, `llm` (LlmSurface), `isBootstrapped`,
+ * `symbolGraph`, and `gitRunner` seams. Defaults resolve lazily at run time
+ * so the closed-MemoryRepository-singleton landmine (memory-crud.test.ts)
+ * does not poison bootstrap tests.
+ */
+import { z } from "zod";
+import type { InsertMemoryInput } from "../../data/memory/memory-repository.js";
+import type { LlmSurface } from "../memory/consolidator.js";
+export type SeedType = "pattern" | "code" | "decision";
+export interface BootstrapSeed {
+    summary: string;
+    type: SeedType;
+    level: 0 | 1 | 2;
+    importance: number;
+    rationale?: string;
+}
+export interface BootstrapSignals {
+    gitLog: string[];
+    readme?: string;
+    docs: Array<{
+        path: string;
+        snippet: string;
+    }>;
+    manifests: Array<{
+        kind: string;
+        name?: string;
+        description?: string;
+        deps?: string[];
+    }>;
+    centralFiles: Array<{
+        filePath: string;
+        score: number;
+    }>;
+}
+export type BootstrapSource = "llm" | "rule-based" | "none";
+export interface BootstrapResult {
+    bootstrapped: boolean;
+    reason?: string;
+    skipped?: boolean;
+    source: BootstrapSource;
+    bootstrapId?: string;
+    seedMemoryIds: string[];
+    signalCount: number;
+    memoryCount: number;
+}
+export interface BootstrapOptions {
+    projectPath?: string;
+    force?: boolean;
+}
+/**
+ * Injectable memory-repository seam. The default implementation resolves
+ * getMemoryRepository() lazily inside each method (test-isolation).
+ */
+export interface MemoryRepoSeam {
+    insert(input: InsertMemoryInput): void | Promise<void>;
+    /** Whether any non-deleted memory tagged `bootstrap:<projectId>` exists. */
+    hasBootstrapMarker(projectId: string): boolean;
+}
+/** Centrality source — narrowed SymbolGraphService surface. */
+export interface CentralitySource {
+    getTopCentralFiles(projectId: string, limit?: number): Promise<Array<{
+        filePath: string;
+        score: number;
+        updatedAt: number;
+    }>>;
+}
+/** Git runner — narrowed surface so tests inject a fake (no subprocess). */
+export interface GitRunner {
+    (cwd: string, args: string[]): Promise<{
+        ok: boolean;
+        stdout: string;
+        stderr?: string;
+    }>;
+}
+export interface BootstrapDeps {
+    llm?: LlmSurface;
+    memoryRepo?: MemoryRepoSeam;
+    isBootstrapped?: (projectId: string) => boolean;
+    symbolGraph?: CentralitySource;
+    gitRunner?: GitRunner;
+}
+/**
+ * zod schema for the LLM object call. A bounded list of seed memories.
+ * Exported for tests + consumers that want the same contract.
+ */
+export declare const SeedMemoriesSchema: z.ZodObject<{
+    memories: z.ZodArray<z.ZodObject<{
+        summary: z.ZodString;
+        type: z.ZodEnum<{
+            code: "code";
+            pattern: "pattern";
+            decision: "decision";
+        }>;
+        level: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>;
+        importance: z.ZodNumber;
+        rationale: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SeedMemories = z.infer<typeof SeedMemoriesSchema>;
+export declare class BootstrapService {
+    private readonly llm;
+    private readonly memoryRepo;
+    private readonly isBootstrappedFn;
+    private readonly symbolGraph;
+    private readonly gitRunner;
+    constructor(deps?: BootstrapDeps);
+    /**
+     * Run a bootstrap pass for `projectId`. Idempotent unless `force`. Never
+     * throws (R5 silent degradation).
+     */
+    bootstrap(projectId: string, opts?: BootstrapOptions): Promise<BootstrapResult>;
+}
+/**
+ * Gather repo signals. Every step is best-effort; a failing step yields its
+ * empty default. Never throws.
+ */
+export declare function scanSignals(_projectId: string, projectRoot: string, caps: {
+    gitLogLimit: number;
+    centralityLimit: number;
+}, symbolGraph: CentralitySource, gitRunner: GitRunner): Promise<BootstrapSignals>;
+export declare function summarizeWithLlm(signals: BootstrapSignals, surface: LlmSurface, maxSeedMemories: number): Promise<{
+    ok: true;
+    seeds: BootstrapSeed[];
+} | {
+    ok: false;
+    reason: string;
+}>;
+/**
+ * Derive minimal seeds from the cheapest signals without an LLM call.
+ * Capped at 3 seeds. Empty when no usable signal exists.
+ */
+export declare function ruleBasedSeed(signals: BootstrapSignals): BootstrapSeed[];
+export declare function storeSeeds(memoryRepo: MemoryRepoSeam, projectId: string, bootstrapId: string, seeds: BootstrapSeed[], signals: BootstrapSignals): Promise<string[]>;
+export declare function countSignals(s: BootstrapSignals): number;
+export declare function getBootstrapService(): BootstrapService;
+export declare function resetBootstrapService(): void;
+export declare const bootstrapService: BootstrapService;
+//# sourceMappingURL=bootstrap-service.d.ts.map

package/dist/services/bootstrap/bootstrap-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-service.d.ts","sourceRoot":"","sources":["../../../src/services/bootstrap/bootstrap-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAGhF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAK5D,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC,CAAC;IACH,YAAY,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1D;AAED,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,YAAY,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,4EAA4E;IAC5E,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CAChD;AAED,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CAC3E;AAED,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,CACE,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAkDD;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAE7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiC;IAClE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,IAAI,GAAE,aAAkB;IAkCpC;;;OAGG;IACG,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,eAAe,CAAC;CAuG5B;AAeD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,EACtD,WAAW,EAAE,gBAAgB,EAC7B,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAoG3B;AA8BD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,UAAU,EACnB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA0B/E;AA8CD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,EAAE,CA0CxE;AAID,wBAAsB,UAAU,CAC9B,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,aAAa,EAAE,EACtB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC,CA2BnB;AA0BD,wBAAgB,YAAY,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAQxD;AA6CD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAGtD;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,eAAO,MAAM,gBAAgB,EAAE,gBAAyC,CAAC"}