ghagga-core 2.9.1 → 3.0.0

package/dist/pipeline/prepare-graph.js

@@ -0,0 +1,174 @@
+/**
+ * Graph-powered prepare steps: 2.5 blast-radius filter + 2.6 call-chain
+ * / reverse-deps context.
+ *
+ * Phase-private sibling of `prepare.ts` — split out so prepare stays under
+ * the 300-line module cap (same precedent as `gather-safe.ts` for the
+ * gather-context phase). Exported only because TS module boundaries
+ * require it; the ONLY intended importer is `prepare.ts`.
+ *
+ * Step bodies are moved LITERAL from the original `reviewPipeline`:
+ * - Blast-radius keeps its BESPOKE catch (sets a fallback
+ *   `blastRadiusMetadata` and warns with the RAW error, not `.message`) —
+ *   deliberately NOT migrated to `runDegradable` (see degrade.ts).
+ * - Call-chain degrades via `runDegradable` with `reportFailure: false`
+ *   (DELIBERATE — warn only, never lands in failedSteps; pinned by the
+ *   golden degradation suite). The degradation IS recorded in
+ *   `warnOnlyDegradations` so `coverageComplete` reflects it.
+ */
+import { computeBlastRadius } from '../graph/blast-radius.js';
+import { buildCallChainFromDiff } from '../graph/call-chain.js';
+import { buildReverseDependencyMap, findDependents } from '../graph/reverse-deps.js';
+import { isGraphStale } from '../graph/schema.js';
+import { runDegradable } from './degrade.js';
+/**
+ * Step 2.5: Blast-radius filter (optional).
+ * Narrows `filteredFiles`/`filteredDiff` to the blast radius when a
+ * dependency graph is available; falls back to the full diff otherwise.
+ */
+export async function applyBlastRadius(args) {
+    const { input, emit, failedSteps, fileList } = args;
+    let { filteredFiles, filteredDiff } = args;
+    let blastRadiusMetadata;
+    if (input.settings.enableBlastRadius && input.graphLoader) {
+        try {
+            const graph = await input.graphLoader.load();
+            if (graph) {
+                const metadata = await input.graphLoader.loadMetadata();
+                const stale = metadata ? isGraphStale(metadata) : false;
+                if (stale) {
+                    emit({
+                        step: 'blast-radius',
+                        message: `Dependency graph is stale (last indexed: ${metadata?.lastIndexedAt})`,
+                    });
+                }
+                const blastResult = computeBlastRadius(graph, fileList, {
+                    maxDepth: input.settings.traversalDepth,
+                    maxFiles: input.settings.maxBlastRadiusFiles,
+                });
+                if (blastResult.exceededCap) {
+                    emit({
+                        step: 'blast-radius',
+                        message: `Blast radius exceeds ${input.settings.maxBlastRadiusFiles ?? 50} files — using full diff`,
+                    });
+                    blastRadiusMetadata = {
+                        enabled: true,
+                        graphAvailable: true,
+                        totalFiles: filteredFiles.length,
+                        blastRadiusFiles: filteredFiles.length,
+                        fallbackReason: `blast radius exceeds ${input.settings.maxBlastRadiusFiles ?? 50} files`,
+                        graphStale: stale,
+                    };
+                }
+                else {
+                    // Filter to blast-radius files
+                    filteredFiles = filteredFiles.filter((f) => blastResult.files.has(f.path));
+                    filteredDiff = filteredFiles.map((f) => f.content).join('\n');
+                    emit({
+                        step: 'blast-radius',
+                        message: `Blast radius: ${blastResult.files.size} files (from ${fileList.length} in diff)`,
+                        detail: [
+                            `  changed: ${blastResult.changedFiles.length}`,
+                            `  dependents: ${blastResult.dependents.length}`,
+                            `  tests: ${blastResult.testFiles.length}`,
+                        ].join('\n'),
+                    });
+                    blastRadiusMetadata = {
+                        enabled: true,
+                        graphAvailable: true,
+                        totalFiles: fileList.length,
+                        blastRadiusFiles: blastResult.files.size,
+                        graphStale: stale,
+                    };
+                }
+            }
+            else {
+                emit({ step: 'blast-radius', message: 'Blast radius: skipped (no graph available)' });
+                blastRadiusMetadata = {
+                    enabled: true,
+                    graphAvailable: false,
+                    totalFiles: filteredFiles.length,
+                    blastRadiusFiles: filteredFiles.length,
+                    fallbackReason: 'no graph available',
+                };
+            }
+        }
+        catch (error) {
+            console.warn('[ghagga] Blast-radius failed (degrading gracefully):', error);
+            failedSteps.push({
+                step: 'blast-radius',
+                error: error instanceof Error ? error.message : String(error),
+            });
+            emit({ step: 'blast-radius', message: 'Blast radius: skipped (error loading graph)' });
+            blastRadiusMetadata = {
+                enabled: true,
+                graphAvailable: false,
+                totalFiles: filteredFiles.length,
+                blastRadiusFiles: filteredFiles.length,
+                fallbackReason: `error: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    return { filteredFiles, filteredDiff, blastRadiusMetadata };
+}
+/**
+ * Step 2.6: Call-chain + reverse-deps context (optional, runs when
+ * blast-radius is enabled). Returns the prompt context string ('' when
+ * disabled, no symbols affected, or degraded).
+ */
+export async function buildCallChainContext(args) {
+    const { input, emit, failedSteps, warnOnlyDegradations, fileList, filteredDiff } = args;
+    let callChainContext = '';
+    if (input.settings.enableBlastRadius) {
+        // reportFailure: false is DELIBERATE — call-chain degrades with a warn only
+        // and never lands in failedSteps (pinned by the golden degradation suite).
+        // It IS recorded in warnOnlyDegradations → coverageComplete reflects it.
+        await runDegradable({ failedSteps, warnOnlyDegradations, emit }, {
+            step: 'call-chain',
+            warnLabel: '[ghagga] Call-chain/reverse-deps failed (degrading gracefully):',
+            reportFailure: false,
+        }, async () => {
+            if (input.fileReader) {
+                const fileContentsMap = new Map();
+                for (const fp of fileList) {
+                    try {
+                        const content = await input.fileReader(fp);
+                        if (content)
+                            fileContentsMap.set(fp, content);
+                    }
+                    catch {
+                        // non-fatal — skip unreadable files
+                    }
+                }
+                if (fileContentsMap.size > 0) {
+                    const callChain = buildCallChainFromDiff(filteredDiff, fileContentsMap);
+                    if (callChain.affectedSymbols.length > 0) {
+                        const affectedFiles = [...new Set(callChain.affectedSymbols.map((s) => s.filePath))];
+                        callChainContext = `\n## Call-Chain Impact\n${callChain.affectedSymbols.length} symbol(s) across ${affectedFiles.length} file(s) may be affected by these changes (depth: ${callChain.depth}).\n`;
+                        emit({
+                            step: 'call-chain',
+                            message: `Call-chain: ${callChain.changedSymbols.length} changed symbol(s), ${callChain.affectedSymbols.length} affected symbol(s)`,
+                        });
+                    }
+                    const reverseDepMap = buildReverseDependencyMap([...fileContentsMap.keys()], fileContentsMap);
+                    const highRiskFiles = [];
+                    for (const fp of fileList) {
+                        const result = findDependents(fp, reverseDepMap, 2);
+                        if (result.transitiveCount >= 3) {
+                            highRiskFiles.push(`${fp} (${result.transitiveCount} dependents)`);
+                        }
+                    }
+                    if (highRiskFiles.length > 0) {
+                        callChainContext += `\n## High-Risk Files (many dependents)\nThese changed files have many transitive dependents — review carefully:\n${highRiskFiles.map((f) => `- ${f}`).join('\n')}\n`;
+                        emit({
+                            step: 'reverse-deps',
+                            message: `Reverse deps: ${highRiskFiles.length} high-risk file(s) detected`,
+                        });
+                    }
+                }
+            }
+        });
+    }
+    return callChainContext;
+}
+//# sourceMappingURL=prepare-graph.js.map

package/dist/pipeline/prepare-graph.js.map

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

package/dist/pipeline/prepare.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Prepare phase: steps 1 → 4 of the review pipeline.
+ *
+ *   1   Validate input
+ *   2   Parse and filter the diff (path protection)
+ *   2.1 Flood / spam detection        → may EARLY-RETURN a skipped result
+ *   2.2 All-files-filtered check      → may EARLY-RETURN a skipped result
+ *   2.5 Blast-radius filter           (prepare-graph.ts, bespoke catch)
+ *   2.6 Call-chain + reverse-deps     (prepare-graph.ts, warn-only degrade)
+ *   3   Detect tech stacks
+ *   4   Token budget + diff truncation
+ *
+ * Because the two early-returns fire BEFORE a complete `PipelineStateBase`
+ * can exist (`fileList`/`allFiles` are readonly and only known post-parse),
+ * prepare CONSTRUCTS and RETURNS the base itself — analogous to how the
+ * execute phase returns the `ReviewResult` it creates. The outcome is a
+ * discriminated union: `early` carries the final `ReviewResult` (flood-skip
+ * / all-filtered), `continue` carries the base for the downstream phases.
+ */
+import type { ReviewInput, ReviewResult } from '../types.js';
+import type { PipelineStateBase } from './state.js';
+/**
+ * Result of the prepare phase.
+ * - `early`: the pipeline is done — return `result` as-is (flood-skip or
+ *   all-files-filtered). No further phase runs.
+ * - `continue`: proceed with `base` through gather → execute → enrich →
+ *   finalize.
+ */
+export type PrepareOutcome = {
+    readonly kind: 'early';
+    readonly result: ReviewResult;
+} | {
+    readonly kind: 'continue';
+    readonly base: PipelineStateBase;
+};
+/**
+ * Run steps 1 → 4 and construct the shared `PipelineStateBase`.
+ */
+export declare function prepare(input: ReviewInput): Promise<PrepareOutcome>;
+//# sourceMappingURL=prepare.d.ts.map

package/dist/pipeline/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../src/pipeline/prepare.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAe,WAAW,EAAE,YAAY,EAAc,MAAM,aAAa,CAAC;AAOtF,OAAO,KAAK,EAAc,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAiEpE;;GAEG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CA8KzE"}

package/dist/pipeline/prepare.js

@@ -0,0 +1,233 @@
+/**
+ * Prepare phase: steps 1 → 4 of the review pipeline.
+ *
+ *   1   Validate input
+ *   2   Parse and filter the diff (path protection)
+ *   2.1 Flood / spam detection        → may EARLY-RETURN a skipped result
+ *   2.2 All-files-filtered check      → may EARLY-RETURN a skipped result
+ *   2.5 Blast-radius filter           (prepare-graph.ts, bespoke catch)
+ *   2.6 Call-chain + reverse-deps     (prepare-graph.ts, warn-only degrade)
+ *   3   Detect tech stacks
+ *   4   Token budget + diff truncation
+ *
+ * Because the two early-returns fire BEFORE a complete `PipelineStateBase`
+ * can exist (`fileList`/`allFiles` are readonly and only known post-parse),
+ * prepare CONSTRUCTS and RETURNS the base itself — analogous to how the
+ * execute phase returns the `ReviewResult` it creates. The outcome is a
+ * discriminated union: `early` carries the final `ReviewResult` (flood-skip
+ * / all-filtered), `continue` carries the base for the downstream phases.
+ */
+import { buildStackHints } from '../agents/prompts.js';
+import { detectFlood } from '../flood/index.js';
+import { filterDiffFiles, parseDiffFiles, truncateDiff } from '../utils/diff.js';
+import { detectStacks } from '../utils/stack-detect.js';
+import { calculateTokenBudget } from '../utils/token-budget.js';
+import { applyBlastRadius, buildCallChainContext } from './prepare-graph.js';
+import { resolveAiEnabled, resolvePrimaryModel } from './providers.js';
+import { createSkippedResult } from './results.js';
+// ─── Validation ─────────────────────────────────────────────────
+/**
+ * Validate the review input for required fields.
+ * Throws descriptive errors for misconfiguration.
+ */
+function validateInput(input) {
+    if (!input.diff || input.diff.trim().length === 0) {
+        throw new Error('Review input must include a non-empty diff');
+    }
+    // If AI review is explicitly disabled, no provider/model/key needed
+    if (input.aiReviewEnabled === false) {
+        return;
+    }
+    // Provider chain mode: validate the chain has entries
+    if (input.providerChain && input.providerChain.length > 0) {
+        return;
+    }
+    // CLI Bridge mode: no API key required (uses CLI auth)
+    if (input.provider === 'cli-bridge') {
+        return;
+    }
+    // Gateway mode: uses dashboard-configured token (stored as apiKey in chain entry)
+    if (input.provider === 'gateway') {
+        return;
+    }
+    // Ollama mode: no API key required (local instance)
+    if (input.provider === 'ollama') {
+        return;
+    }
+    // Single provider mode — must be one of the 3 supported providers
+    if (input.provider) {
+        const supported = ['gateway', 'cli-bridge', 'ollama'];
+        if (!supported.includes(input.provider)) {
+            throw new Error(`Provider '${input.provider}' is no longer supported directly. ` +
+                `Set provider: 'gateway' and configure credentials in mcp-llm-bridge. ` +
+                `See docs/configuration.md#gateway-mode-mcp-llm-bridge`);
+        }
+    }
+    if (!input.apiKey && input.provider !== 'cli-bridge' && input.provider !== 'ollama') {
+        throw new Error('Review input must include an API key');
+    }
+    if (!input.provider) {
+        throw new Error('Review input must specify an LLM provider');
+    }
+    if (!input.model) {
+        throw new Error('Review input must specify a model');
+    }
+}
+// ─── Prepare phase ──────────────────────────────────────────────
+/**
+ * Run steps 1 → 4 and construct the shared `PipelineStateBase`.
+ */
+export async function prepare(input) {
+    const startTime = Date.now();
+    const emit = input.onProgress ?? (() => { });
+    // Track steps that failed but were gracefully degraded
+    const failedSteps = [];
+    // Track warn-only degradations (reportFailure: false sites) — never
+    // surface in failedSteps but still count against coverageComplete.
+    const warnOnlyDegradations = [];
+    // Resolve whether AI review is enabled
+    const aiEnabled = resolveAiEnabled(input);
+    // ── Step 1: Validate ───────────────────────────────────────
+    validateInput(input);
+    emit({ step: 'validate', message: 'Input validated' });
+    // ── Step 2: Parse and filter the diff ──────────────────────
+    const allFiles = parseDiffFiles(input.diff);
+    let { filtered: filteredFiles, blocked, redacted, } = filterDiffFiles(allFiles, input.settings.ignorePatterns);
+    if (blocked.length > 0) {
+        emit({
+            step: 'path-protection',
+            message: `Blocked ${blocked.length} sensitive file(s) from review`,
+            detail: blocked.map((p) => `  [BLOCKED] ${p}`).join('\n'),
+        });
+    }
+    if (redacted.length > 0) {
+        emit({
+            step: 'path-protection',
+            message: `Redacted ${redacted.length} file(s) — paths visible, content hidden`,
+            detail: redacted.map((p) => `  [REDACTED] ${p}`).join('\n'),
+        });
+    }
+    emit({
+        step: 'parse-diff',
+        message: `Parsed ${allFiles.length} files from diff, ${filteredFiles.length} after filtering (${blocked.length} blocked, ${redacted.length} redacted)`,
+        detail: filteredFiles.map((f) => `  ${f.path}`).join('\n'),
+    });
+    // ── Step 2.1: Flood / spam detection ──────────────────────
+    // Runs before any expensive operation (static analysis, LLM).
+    const linesChanged = allFiles.reduce((sum, f) => sum + f.additions + f.deletions, 0);
+    const floodResult = detectFlood({
+        authorLogin: input.author ?? '',
+        prTitle: input.context?.commitMessages[0] ?? '',
+        prBody: input.context?.commitMessages.slice(1).join('\n') ?? null,
+        linesChanged,
+        recentPrCount: undefined,
+    });
+    if (floodResult.isFlood) {
+        emit({
+            step: 'flood-detection',
+            message: `Flood detected: ${floodResult.recommendation}`,
+            detail: floodResult.signals.map((s) => `  [${s.type}] ${s.detail}`).join('\n'),
+        });
+    }
+    if (floodResult.recommendation === 'skip') {
+        const skipped = createSkippedResult(input, startTime);
+        return {
+            kind: 'early',
+            result: {
+                ...skipped,
+                summary: 'Flood detection: PR skipped (bot author or spam signal).',
+            },
+        };
+    }
+    // If all files were filtered out, skip the review
+    if (filteredFiles.length === 0) {
+        return { kind: 'early', result: createSkippedResult(input, startTime) };
+    }
+    // Reconstruct filtered diff and get file list
+    let filteredDiff = filteredFiles.map((f) => f.content).join('\n');
+    const fileList = filteredFiles.map((f) => f.path);
+    // ── Step 2.5: Blast-radius filter (optional) ──────────────
+    const blast = await applyBlastRadius({
+        input,
+        emit,
+        failedSteps,
+        fileList,
+        filteredFiles,
+        filteredDiff,
+    });
+    filteredFiles = blast.filteredFiles;
+    filteredDiff = blast.filteredDiff;
+    const blastRadiusMetadata = blast.blastRadiusMetadata;
+    // ── Step 2.6: Call-chain + reverse-deps (optional, runs when blast-radius enabled) ──
+    const callChainContext = await buildCallChainContext({
+        input,
+        emit,
+        failedSteps,
+        warnOnlyDegradations,
+        fileList,
+        filteredDiff,
+    });
+    // ── Step 3: Detect tech stacks ─────────────────────────────
+    const stacks = detectStacks(fileList);
+    const stackHints = buildStackHints(stacks);
+    emit({
+        step: 'detect-stacks',
+        message: `Detected ${stacks.length} tech stack(s)`,
+        detail: stacks.length > 0 ? stacks.map((s) => `  ${s}`).join('\n') : '  (none detected)',
+    });
+    // ── Step 4: Truncate diff to fit token budget ──────────────
+    const primaryModel = resolvePrimaryModel(input);
+    const { diffBudget, contextBudget } = calculateTokenBudget(primaryModel);
+    const { truncated: truncatedDiff } = truncateDiff(filteredDiff, diffBudget);
+    emit({
+        step: 'token-budget',
+        message: `Token budget: ${diffBudget.toLocaleString()} tokens for diff, ${contextBudget.toLocaleString()} tokens for context`,
+    });
+    // ── Construct the shared PipelineState (sans result) ────────
+    // Locals settled by steps 1–4 migrate into the base here. The
+    // gather-context phase overwrites the gather-owned placeholders below
+    // UNCONDITIONALLY before any consumer reads them; the execute phase
+    // resolves provider flags / enhance / trust onto this state and
+    // RETURNS the ReviewResult it creates; enrich and finalize then
+    // mutate `state.result` in-place.
+    const pendingTool = () => ({ status: 'skipped', findings: [], executionTimeMs: 0 });
+    const base = {
+        input,
+        startTime,
+        emit,
+        aiEnabled,
+        allFiles,
+        fileList,
+        filteredFiles,
+        filteredDiff,
+        blastRadiusMetadata,
+        callChainContext,
+        stacks,
+        stackHints,
+        truncatedDiff,
+        diffBudget,
+        contextBudget,
+        // Gathered by the gather-context phase (placeholders until then —
+        // never read pre-gather):
+        staticResult: { semgrep: pendingTool(), trivy: pendingTool(), cpd: pendingTool() },
+        rawMemoryContext: null,
+        codeIntelResults: [],
+        staticContext: '',
+        memoryContext: null,
+        codeIntelContext: '',
+        checklistContext: '',
+        resolvedChecklist: null,
+        negativeExamplesPrompt: '',
+        selfImproveRulesPrompt: '',
+        // Resolved by the execute phase (placeholders until then):
+        activeProvider: '',
+        isCliBridge: false,
+        isGateway: false,
+        isOllama: false,
+        resolvedInputMode: input.mode, // pre-trust value; execute overwrites
+        failedSteps,
+        warnOnlyDegradations,
+    };
+    return { kind: 'continue', base };
+}
+//# sourceMappingURL=prepare.js.map

package/dist/pipeline/prepare.js.map

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

package/dist/pipeline/providers.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Provider resolution helpers for the review pipeline.
+ *
+ * Moved verbatim from pipeline.ts (split-review-pipeline refactor).
+ */
+import { type GenerateTextFn } from '../providers/generate-fn.js';
+import type { ProviderChainEntry, ReviewInput, ReviewMode } from '../types.js';
+/**
+ * Determine if AI review is enabled.
+ * Defaults to true for backward compatibility (CLI/Action don't set this).
+ */
+export declare function resolveAiEnabled(input: ReviewInput): boolean;
+/**
+ * Resolve the primary provider from chain or flat fields.
+ * Returns the first entry in the chain, or builds one from flat fields.
+ */
+export declare function resolvePrimaryProvider(input: ReviewInput): ProviderChainEntry;
+/**
+ * Build the 3-entry ConsensusModelConfig array for the for/against/neutral votes.
+ *
+ * Distribution rules (given a chain of length N):
+ *   N >= 3 : chain[0]→for, chain[1]→against, chain[2]→neutral
+ *   N == 2 : chain[0]→for, chain[1]→against, chain[0]→neutral
+ *   N == 1 : all 3 votes use chain[0]  (same as primary-only)
+ *   N == 0 : all 3 votes use `primary` (backward compat)
+ *
+ * This spreads consensus votes across providers so each vote hits a
+ * different TPM budget instead of all three hammering the same limit.
+ */
+export declare function buildConsensusModels(chain: ProviderChainEntry[] | undefined, primary: ProviderChainEntry): import('../agents/consensus.js').ConsensusModelConfig[];
+/**
+ * Resolve the model name for token budget calculation.
+ */
+export declare function resolvePrimaryModel(input: ReviewInput): string;
+/**
+ * Create the appropriate GenerateTextFn(s) based on the provider type.
+ *
+ * - cli-bridge: single fn wrapping generateViaCLI
+ * - gateway: one fn per gateway chain entry (for round-robin distribution)
+ * - ollama: single fn wrapping local Ollama OpenAI-compatible API
+ *
+ * Providers that are no longer supported directly (anthropic, openai, etc.)
+ * throw a migration error pointing users to gateway mode.
+ */
+export declare function resolveGenerateTextFns(input: ReviewInput, isCliBridge: boolean, isGateway: boolean, isOllama: boolean): GenerateTextFn[];
+/**
+ * Resolve the effective review mode.
+ *
+ * Diagnostic mode requires direct model access. Ollama provides it
+ * (runDiagnosticReview uses createOllamaGenerateFn); CLI bridge and
+ * gateway do not, so they fall back to simple mode.
+ */
+export declare function resolveEffectiveMode(mode: ReviewMode, isCliBridge: boolean, isGateway: boolean): ReviewMode;
+//# sourceMappingURL=providers.d.ts.map

package/dist/pipeline/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/pipeline/providers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI/E;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAU5D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,kBAAkB,CAe7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,EAAE,GAAG,SAAS,EACvC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,wBAAwB,EAAE,oBAAoB,EAAE,CAazD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAK9D;AAID;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,OAAO,EACpB,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,OAAO,GAChB,cAAc,EAAE,CAyElB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,OAAO,EACpB,SAAS,EAAE,OAAO,GACjB,UAAU,CAMZ"}