@sfdxy/anypoint-connect 0.2.3 → 0.4.0

package/README.md

@@ -97,6 +97,15 @@ src/
 │   ├── ApiManagerApi.ts     API instances, policies, SLA tiers
 │   ├── DesignCenterApi.ts   Projects, files, lock/save, publish
 │   └── AccessManagementApi.ts
+├── analysis/          Log analysis pipeline
+│   ├── LogAnalyzer.ts       Pipeline orchestrator
+│   ├── parser.ts            Multi-line joiner + JSON Logger parser
+│   ├── error-context.ts     Error context windows (before/after)
+│   ├── error-grouper.ts     Clusters similar errors
+│   ├── pattern-detector.ts  Recurring message templates
+│   ├── stats.ts             Level distribution, error spikes
+│   ├── types.ts             Shared type definitions
+│   └── utils.ts             Noise detection, templatization
 ├── commands/          CLI commands
 │   ├── config.ts      init | show | set | path
 │   ├── auth.ts        login | logout | status
@@ -373,6 +382,9 @@ No `env` block needed — the MCP server reads from `~/.anypoint-connect/` autom
 | `scale_app` | ⚠️ Scale application replicas (1–8) |
 | `get_logs` | Fetch recent log entries |
 | `download_logs` | Download logs for a time range |
+| `analyze_errors` | Clustered error groups with before/after context windows |
+| `get_log_patterns` | Top recurring message templates with counts |
+| `get_log_stats` | Statistical health summary: error rate, spikes, noise % |
 | `get_metrics` | Fetch monitoring metrics (AMQL) |
 | `search_exchange` | Search assets in Exchange |
 | `download_api_spec` | Download RAML/OAS spec from Exchange |
@@ -407,6 +419,9 @@ No `env` block needed — the MCP server reads from `~/.anypoint-connect/` autom
 - *"What apps are running in Sandbox?"*
 - *"Show me the resource allocation across all Production apps"*
 - *"Show me the last 50 error logs for my-api in Production"*
+- *"Analyze the errors in my-api in Production — what's failing and why?"*
+- *"What are the top log patterns for billing-api in Development?"*
+- *"Give me a health summary of external-sapi in Production"*
 - *"Compare Development and Production environments"*
 - *"What policies are applied to the Order API?"*
 - *"Show me the RAML spec for the order-api project"*

package/dist/analysis/LogAnalyzer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Log Analyzer — Orchestrator
+ * Thin pipeline that composes the individual analysis modules.
+ *
+ * Module structure:
+ *  - types.ts          — Shared type definitions
+ *  - utils.ts          — Noise detection, templatization, constants
+ *  - parser.ts         — Multi-line log parser (JSON Logger, stack traces)
+ *  - error-context.ts  — Error context window builder
+ *  - error-grouper.ts  — Clusters similar errors
+ *  - pattern-detector.ts — Identifies recurring message templates
+ *  - stats.ts          — Level distribution, error rate, spike detection
+ */
+export type { EnrichedLogEntry, ErrorWithContext, ErrorGroup, LogPattern, ErrorSpike, LogStats, AnalysisOptions, AnalysisResult, } from './types.js';
+export { parseRawLogs } from './parser.js';
+export { buildErrorContexts } from './error-context.js';
+export { groupErrors } from './error-grouper.js';
+export { detectPatterns } from './pattern-detector.js';
+export { calculateStats } from './stats.js';
+export { templatize, isNoise, LEVEL_PRIORITY } from './utils.js';
+import type { AnalysisOptions, AnalysisResult } from './types.js';
+/**
+ * Full analysis pipeline: parse → enrich → context → group → pattern → stats.
+ */
+export declare function analyzeLogs(rawText: string, options?: AnalysisOptions): AnalysisResult;
+//# sourceMappingURL=LogAnalyzer.d.ts.map

package/dist/analysis/LogAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/LogAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,YAAY,EACR,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,eAAe,EACf,cAAc,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjE,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQlE;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc,CAsC1F"}

package/dist/analysis/LogAnalyzer.js

@@ -0,0 +1,61 @@
+/**
+ * Log Analyzer — Orchestrator
+ * Thin pipeline that composes the individual analysis modules.
+ *
+ * Module structure:
+ *  - types.ts          — Shared type definitions
+ *  - utils.ts          — Noise detection, templatization, constants
+ *  - parser.ts         — Multi-line log parser (JSON Logger, stack traces)
+ *  - error-context.ts  — Error context window builder
+ *  - error-grouper.ts  — Clusters similar errors
+ *  - pattern-detector.ts — Identifies recurring message templates
+ *  - stats.ts          — Level distribution, error rate, spike detection
+ */
+// Re-export individual modules for direct use
+export { parseRawLogs } from './parser.js';
+export { buildErrorContexts } from './error-context.js';
+export { groupErrors } from './error-grouper.js';
+export { detectPatterns } from './pattern-detector.js';
+export { calculateStats } from './stats.js';
+export { templatize, isNoise, LEVEL_PRIORITY } from './utils.js';
+import { LEVEL_PRIORITY } from './utils.js';
+import { parseRawLogs } from './parser.js';
+import { buildErrorContexts } from './error-context.js';
+import { groupErrors } from './error-grouper.js';
+import { detectPatterns } from './pattern-detector.js';
+import { calculateStats } from './stats.js';
+/**
+ * Full analysis pipeline: parse → enrich → context → group → pattern → stats.
+ */
+export function analyzeLogs(rawText, options = {}) {
+    const totalLines = rawText.split('\n').length;
+    // 1. Parse and join multi-line entries
+    let entries = parseRawLogs(rawText);
+    // 2. Filter by time if requested
+    if (options.hoursBack) {
+        const cutoff = Date.now() - options.hoursBack * 60 * 60 * 1000;
+        entries = entries.filter((e) => e.timestamp >= cutoff);
+    }
+    // 3. Filter by level if requested
+    if (options.level) {
+        const minLevel = LEVEL_PRIORITY[options.level.toUpperCase()] ?? 0;
+        entries = entries.filter((e) => (LEVEL_PRIORITY[e.priority] ?? 0) >= minLevel);
+    }
+    // 4. Build error contexts
+    const errorContexts = buildErrorContexts(entries, {
+        beforeCount: options.contextBefore,
+        afterCount: options.contextAfter,
+    });
+    // 5. Group errors
+    const errorGroups = groupErrors(errorContexts, {
+        maxGroups: options.maxErrorGroups,
+    });
+    // 6. Detect patterns
+    const patterns = detectPatterns(entries, {
+        topN: options.maxPatterns,
+    });
+    // 7. Calculate stats
+    const stats = calculateStats(entries, totalLines, errorGroups, patterns);
+    return { entries, errorContexts, errorGroups, patterns, stats };
+}
+//# sourceMappingURL=LogAnalyzer.js.map

package/dist/analysis/LogAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogAnalyzer.js","sourceRoot":"","sources":["../../src/analysis/LogAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAcH,8CAA8C;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,UAA2B,EAAE;IACtE,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAE9C,uCAAuC;IACvC,IAAI,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAEpC,iCAAiC;IACjC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC/D,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED,kCAAkC;IAClC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC;QAClE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC;IACnF,CAAC;IAED,0BAA0B;IAC1B,MAAM,aAAa,GAAG,kBAAkB,CAAC,OAAO,EAAE;QAC9C,WAAW,EAAE,OAAO,CAAC,aAAa;QAClC,UAAU,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC,CAAC;IAEH,kBAAkB;IAClB,MAAM,WAAW,GAAG,WAAW,CAAC,aAAa,EAAE;QAC3C,SAAS,EAAE,OAAO,CAAC,cAAc;KACpC,CAAC,CAAC;IAEH,qBAAqB;IACrB,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,EAAE;QACrC,IAAI,EAAE,OAAO,CAAC,WAAW;KAC5B,CAAC,CAAC;IAEH,qBAAqB;IACrB,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAEzE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACpE,CAAC"}

package/dist/analysis/error-context.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Log Analysis — Error Context
+ * Builds before/after context windows for ERROR entries.
+ * Uses correlation-based context when available, time-window fallback otherwise.
+ */
+import type { EnrichedLogEntry, ErrorWithContext } from './types.js';
+export interface ErrorContextOptions {
+    /** Number of entries to capture before the error (default: 15) */
+    beforeCount?: number;
+    /** Number of entries to capture after the error (default: 10) */
+    afterCount?: number;
+    /** Time window in ms for fallback mode (default: 30000) */
+    timeWindowMs?: number;
+}
+/**
+ * Build error context for all ERROR entries.
+ */
+export declare function buildErrorContexts(entries: EnrichedLogEntry[], options?: ErrorContextOptions): ErrorWithContext[];
+//# sourceMappingURL=error-context.d.ts.map

package/dist/analysis/error-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-context.d.ts","sourceRoot":"","sources":["../../src/analysis/error-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAChC,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,OAAO,GAAE,mBAAwB,GAAG,gBAAgB,EAAE,CAiDrH"}

package/dist/analysis/error-context.js

@@ -0,0 +1,69 @@
+/**
+ * Log Analysis — Error Context
+ * Builds before/after context windows for ERROR entries.
+ * Uses correlation-based context when available, time-window fallback otherwise.
+ */
+/**
+ * Build error context for all ERROR entries.
+ */
+export function buildErrorContexts(entries, options = {}) {
+    const beforeCount = options.beforeCount ?? 15;
+    const afterCount = options.afterCount ?? 10;
+    const timeWindowMs = options.timeWindowMs ?? 30000;
+    const errorEntries = entries.filter((e) => e.priority === 'ERROR');
+    const contexts = [];
+    // Build correlation index for fast lookup
+    const correlationIndex = new Map();
+    for (const entry of entries) {
+        if (entry.correlationId) {
+            let group = correlationIndex.get(entry.correlationId);
+            if (!group) {
+                group = [];
+                correlationIndex.set(entry.correlationId, group);
+            }
+            group.push(entry);
+        }
+    }
+    for (const error of errorEntries) {
+        let before;
+        let after;
+        let correlationId;
+        if (error.correlationId && correlationIndex.has(error.correlationId)) {
+            // Correlation-based context — follow the full request lifecycle
+            correlationId = error.correlationId;
+            const correlated = correlationIndex.get(correlationId);
+            const errorIdx = correlated.indexOf(error);
+            before = correlated.slice(Math.max(0, errorIdx - beforeCount), errorIdx);
+            after = correlated.slice(errorIdx + 1, errorIdx + 1 + afterCount);
+        }
+        else {
+            // Time-window fallback
+            const errorIdx = entries.indexOf(error);
+            before = entries
+                .slice(Math.max(0, errorIdx - beforeCount), errorIdx)
+                .filter((e) => error.timestamp - e.timestamp <= timeWindowMs);
+            after = entries
+                .slice(errorIdx + 1, errorIdx + 1 + afterCount)
+                .filter((e) => e.timestamp - error.timestamp <= timeWindowMs);
+        }
+        const flowTrace = buildFlowTrace(before, error);
+        contexts.push({ error, before, after, correlationId, flowTrace });
+    }
+    return contexts;
+}
+/**
+ * Extract the flow execution path from context entries.
+ */
+function buildFlowTrace(before, error) {
+    const flows = [];
+    const seen = new Set();
+    for (const entry of [...before, error]) {
+        const flow = entry.flowName;
+        if (flow && !seen.has(flow)) {
+            seen.add(flow);
+            flows.push(flow);
+        }
+    }
+    return flows;
+}
+//# sourceMappingURL=error-context.js.map

package/dist/analysis/error-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-context.js","sourceRoot":"","sources":["../../src/analysis/error-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA2B,EAAE,UAA+B,EAAE;IAC7F,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;IAC5C,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;IAEnD,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAuB,EAAE,CAAC;IAExC,0CAA0C;IAC1C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACtB,IAAI,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YACtD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,KAAK,GAAG,EAAE,CAAC;gBACX,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;YACrD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACL,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QAC/B,IAAI,MAA0B,CAAC;QAC/B,IAAI,KAAyB,CAAC;QAC9B,IAAI,aAAiC,CAAC;QAEtC,IAAI,KAAK,CAAC,aAAa,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;YACnE,gEAAgE;YAChE,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;YACpC,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,aAAa,CAAE,CAAC;YACxD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC3C,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;YACzE,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;QACtE,CAAC;aAAM,CAAC;YACJ,uBAAuB;YACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACxC,MAAM,GAAG,OAAO;iBACX,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC,EAAE,QAAQ,CAAC;iBACpD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,IAAI,YAAY,CAAC,CAAC;YAClE,KAAK,GAAG,OAAO;iBACV,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,CAAC,GAAG,UAAU,CAAC;iBAC9C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,YAAY,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,MAA0B,EAAE,KAAuB;IACvE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC5B,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/analysis/error-grouper.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Log Analysis — Error Grouper
+ * Clusters similar errors by (errorType + message template).
+ */
+import type { ErrorWithContext, ErrorGroup } from './types.js';
+export interface ErrorGrouperOptions {
+    /** Maximum samples per group (default: 3) */
+    maxSamples?: number;
+    /** Maximum groups to return (default: 10) */
+    maxGroups?: number;
+}
+/**
+ * Group similar errors by error type and message pattern.
+ */
+export declare function groupErrors(contexts: ErrorWithContext[], options?: ErrorGrouperOptions): ErrorGroup[];
+//# sourceMappingURL=error-grouper.d.ts.map

package/dist/analysis/error-grouper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-grouper.d.ts","sourceRoot":"","sources":["../../src/analysis/error-grouper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG/D,MAAM,WAAW,mBAAmB;IAChC,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE,OAAO,GAAE,mBAAwB,GAAG,UAAU,EAAE,CAwCzG"}

package/dist/analysis/error-grouper.js

@@ -0,0 +1,44 @@
+/**
+ * Log Analysis — Error Grouper
+ * Clusters similar errors by (errorType + message template).
+ */
+import { templatize } from './utils.js';
+/**
+ * Group similar errors by error type and message pattern.
+ */
+export function groupErrors(contexts, options = {}) {
+    const maxSamples = options.maxSamples ?? 3;
+    const maxGroups = options.maxGroups ?? 10;
+    const groups = new Map();
+    for (const ctx of contexts) {
+        const errorType = ctx.error.errorType || 'UNKNOWN';
+        const template = templatize(ctx.error.message || '');
+        const key = `${errorType}::${template}`;
+        let group = groups.get(key);
+        if (!group) {
+            group = { contexts: [], flows: new Set() };
+            groups.set(key, group);
+        }
+        group.contexts.push(ctx);
+        if (ctx.error.flowName) {
+            group.flows.add(ctx.error.flowName);
+        }
+    }
+    const sorted = [...groups.entries()]
+        .sort((a, b) => b[1].contexts.length - a[1].contexts.length)
+        .slice(0, maxGroups);
+    return sorted.map(([key, group]) => {
+        const [errorType, template] = key.split('::', 2);
+        const timestamps = group.contexts.map((c) => c.error.timestamp).sort();
+        return {
+            errorType,
+            template,
+            count: group.contexts.length,
+            firstSeen: new Date(timestamps[0]).toISOString(),
+            lastSeen: new Date(timestamps[timestamps.length - 1]).toISOString(),
+            samples: group.contexts.slice(0, maxSamples),
+            affectedFlows: [...group.flows],
+        };
+    });
+}
+//# sourceMappingURL=error-grouper.js.map

package/dist/analysis/error-grouper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-grouper.js","sourceRoot":"","sources":["../../src/analysis/error-grouper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AASxC;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAA4B,EAAE,UAA+B,EAAE;IACvF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IAE1C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgE,CAAC;IAEvF,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,SAAS,CAAC;QACnD,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,GAAG,SAAS,KAAK,QAAQ,EAAE,CAAC;QAExC,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,KAAK,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;YAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;SAC/B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;SAC3D,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAEzB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC/B,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;QAEvE,OAAO;YACH,SAAS;YACT,QAAQ;YACR,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM;YAC5B,SAAS,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;YAChD,QAAQ,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;YACnE,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;YAC5C,aAAa,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;SAClC,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/analysis/parser.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Log Analysis — Parser
+ * Parses raw CloudHub log text into enriched entries, joining multi-line blocks.
+ * Handles: JSON Logger blocks, stack traces, HTTP dumps, continuation lines.
+ */
+import type { EnrichedLogEntry } from './types.js';
+/**
+ * Parse raw log text into enriched entries, joining multi-line blocks.
+ */
+export declare function parseRawLogs(rawText: string): EnrichedLogEntry[];
+//# sourceMappingURL=parser.d.ts.map

package/dist/analysis/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/analysis/parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AASnD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAoFhE"}

package/dist/analysis/parser.js

@@ -0,0 +1,123 @@
+/**
+ * Log Analysis — Parser
+ * Parses raw CloudHub log text into enriched entries, joining multi-line blocks.
+ * Handles: JSON Logger blocks, stack traces, HTTP dumps, continuation lines.
+ */
+/**
+ * Enhanced log line regex that captures:
+ *  - timestamp, level, instanceId, loggerName, eventId, thread, message
+ */
+const LOG_LINE_REGEX = /^(\d{4}-\d{2}-\d{2}T[\d:.]+Z)\s+(TRACE|DEBUG|INFO|WARN|ERROR|FATAL)\s+\[([^\]]*)\]\s+(\S+)\s+(?:event:(\S+)\s+)?(.+?)(?:\s+-\s+(.*))?$/;
+/**
+ * Parse raw log text into enriched entries, joining multi-line blocks.
+ */
+export function parseRawLogs(rawText) {
+    const lines = rawText.split('\n');
+    const entries = [];
+    let current = null;
+    let jsonBuffer = null;
+    let jsonBraceDepth = 0;
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        const match = line.match(LOG_LINE_REGEX);
+        if (match) {
+            // Flush any pending entry
+            if (current) {
+                if (jsonBuffer) {
+                    finalizeJsonEntry(current, jsonBuffer);
+                    jsonBuffer = null;
+                    jsonBraceDepth = 0;
+                }
+                entries.push(current);
+            }
+            const [, timestamp, level, instanceId, loggerName, eventId, threadOrMessage, messageAfterDash] = match;
+            current = {
+                timestamp: new Date(timestamp).getTime(),
+                priority: level,
+                instanceId,
+                loggerName,
+                eventId,
+                threadName: messageAfterDash !== undefined ? threadOrMessage : undefined,
+                message: messageAfterDash !== undefined ? messageAfterDash : threadOrMessage,
+            };
+            // Check if this is a JSON Logger entry starting with "{"
+            if (current.message !== undefined) {
+                const trimmedMsg = current.message.trim();
+                if (trimmedMsg === '{' || trimmedMsg.endsWith('- {')) {
+                    jsonBuffer = ['{'];
+                    jsonBraceDepth = 1;
+                    if (trimmedMsg.endsWith('- {')) {
+                        current.message = trimmedMsg.slice(0, -3).trim();
+                    }
+                    else {
+                        current.message = '';
+                    }
+                }
+            }
+        }
+        else {
+            // Continuation line — no timestamp prefix
+            if (jsonBuffer !== null) {
+                jsonBuffer.push(line);
+                for (const ch of line) {
+                    if (ch === '{')
+                        jsonBraceDepth++;
+                    else if (ch === '}')
+                        jsonBraceDepth--;
+                }
+                if (jsonBraceDepth <= 0) {
+                    if (current) {
+                        finalizeJsonEntry(current, jsonBuffer);
+                    }
+                    jsonBuffer = null;
+                    jsonBraceDepth = 0;
+                }
+            }
+            else if (current) {
+                if (current.stackTrace) {
+                    current.stackTrace += '\n' + line;
+                }
+                else if (line.match(/^\s+(at |Caused by:|\.{3}\s+\d+\s+more|Error type|Element DSL)/)) {
+                    current.stackTrace = line;
+                }
+                else {
+                    current.message = (current.message || '') + '\n' + line;
+                }
+            }
+        }
+    }
+    // Flush last entry
+    if (current) {
+        if (jsonBuffer) {
+            finalizeJsonEntry(current, jsonBuffer);
+        }
+        entries.push(current);
+    }
+    return entries;
+}
+/**
+ * Parse accumulated JSON lines and enrich the log entry with structured fields.
+ */
+function finalizeJsonEntry(entry, jsonLines) {
+    const jsonText = jsonLines.join('\n');
+    try {
+        const parsed = JSON.parse(jsonText);
+        entry.jsonPayload = parsed;
+        entry.correlationId = parsed.correlationId || entry.correlationId;
+        entry.elapsed = parsed.elapsed;
+        entry.tracePoint = parsed.tracePoint;
+        entry.flowName = parsed.content?.flowName || parsed.locationInfo?.rootContainer;
+        entry.errorType = parsed.errorType || parsed.content?.errorType || parsed.content?.errorCode;
+        if (parsed.message && (!entry.message || entry.message.trim() === '')) {
+            entry.message = parsed.message;
+        }
+        if (parsed.Stacktrace__c || parsed.content?.Stacktrace__c) {
+            entry.stackTrace = parsed.Stacktrace__c || parsed.content?.Stacktrace__c;
+        }
+    }
+    catch {
+        entry.message = (entry.message || '') + '\n' + jsonText;
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/analysis/parser.js.map

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

package/dist/analysis/pattern-detector.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Log Analysis — Pattern Detector
+ * Identifies the top N recurring log message templates.
+ */
+import type { EnrichedLogEntry, LogPattern } from './types.js';
+export interface PatternDetectorOptions {
+    /** Number of top patterns to return (default: 15) */
+    topN?: number;
+    /** Whether to exclude HTTP listener noise (default: true) */
+    excludeNoise?: boolean;
+}
+/**
+ * Identify recurring log message templates.
+ */
+export declare function detectPatterns(entries: EnrichedLogEntry[], options?: PatternDetectorOptions): LogPattern[];
+//# sourceMappingURL=pattern-detector.d.ts.map

package/dist/analysis/pattern-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-detector.d.ts","sourceRoot":"","sources":["../../src/analysis/pattern-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG/D,MAAM,WAAW,sBAAsB;IACnC,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,OAAO,GAAE,sBAA2B,GAAG,UAAU,EAAE,CAgC9G"}

package/dist/analysis/pattern-detector.js

@@ -0,0 +1,38 @@
+/**
+ * Log Analysis — Pattern Detector
+ * Identifies the top N recurring log message templates.
+ */
+import { templatize, isNoise } from './utils.js';
+/**
+ * Identify recurring log message templates.
+ */
+export function detectPatterns(entries, options = {}) {
+    const topN = options.topN ?? 15;
+    const excludeNoise = options.excludeNoise ?? true;
+    const counts = new Map();
+    for (const entry of entries) {
+        if (excludeNoise && isNoise(entry))
+            continue;
+        const template = templatize(entry.message || '');
+        const key = `${entry.priority}::${template}`;
+        const existing = counts.get(key);
+        if (existing) {
+            existing.count++;
+        }
+        else {
+            counts.set(key, { count: 1, level: entry.priority, loggerName: entry.loggerName });
+        }
+    }
+    const total = excludeNoise ? entries.filter((e) => !isNoise(e)).length : entries.length;
+    return [...counts.entries()]
+        .sort((a, b) => b[1].count - a[1].count)
+        .slice(0, topN)
+        .map(([key, val]) => ({
+        template: key.split('::', 2)[1],
+        count: val.count,
+        level: val.level,
+        percentage: total > 0 ? Math.round((val.count / total) * 10000) / 100 : 0,
+        loggerName: val.loggerName,
+    }));
+}
+//# sourceMappingURL=pattern-detector.js.map

package/dist/analysis/pattern-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-detector.js","sourceRoot":"","sources":["../../src/analysis/pattern-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AASjD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAA2B,EAAE,UAAkC,EAAE;IAC5F,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IAChC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;IAElD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiE,CAAC;IAExF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC;YAAE,SAAS;QAE7C,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAE7C,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,QAAQ,EAAE,CAAC;YACX,QAAQ,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACvF,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAExF,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;SACvB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;SACvC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;SACd,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QAClB,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACzE,UAAU,EAAE,GAAG,CAAC,UAAU;KAC7B,CAAC,CAAC,CAAC;AACZ,CAAC"}

package/dist/analysis/stats.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Log Analysis — Stats Calculator
+ * Computes level distribution, error rate, spikes, and noise percentage.
+ */
+import type { EnrichedLogEntry, ErrorGroup, LogPattern, LogStats } from './types.js';
+/**
+ * Compute comprehensive statistics for a set of enriched entries.
+ */
+export declare function calculateStats(entries: EnrichedLogEntry[], totalLines: number, errorGroups?: ErrorGroup[], patterns?: LogPattern[]): LogStats;
+//# sourceMappingURL=stats.d.ts.map

package/dist/analysis/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/analysis/stats.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAc,MAAM,YAAY,CAAC;AAGjG;;GAEG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,UAAU,EAAE,EAC1B,QAAQ,CAAC,EAAE,UAAU,EAAE,GACxB,QAAQ,CAmCV"}

package/dist/analysis/stats.js

@@ -0,0 +1,82 @@
+/**
+ * Log Analysis — Stats Calculator
+ * Computes level distribution, error rate, spikes, and noise percentage.
+ */
+import { isNoise } from './utils.js';
+/**
+ * Compute comprehensive statistics for a set of enriched entries.
+ */
+export function calculateStats(entries, totalLines, errorGroups, patterns) {
+    const byLevel = {};
+    let noiseCount = 0;
+    const correlationIds = new Set();
+    const timestamps = [];
+    for (const entry of entries) {
+        byLevel[entry.priority] = (byLevel[entry.priority] || 0) + 1;
+        if (isNoise(entry))
+            noiseCount++;
+        if (entry.correlationId)
+            correlationIds.add(entry.correlationId);
+        if (entry.timestamp)
+            timestamps.push(entry.timestamp);
+    }
+    timestamps.sort((a, b) => a - b);
+    const errorCount = byLevel['ERROR'] || 0;
+    const totalEntries = entries.length;
+    const errorRate = totalEntries > 0 ? Math.round((errorCount / totalEntries) * 10000) / 100 : 0;
+    const errorSpikes = calculateErrorSpikes(entries, 5 * 60 * 1000);
+    return {
+        totalLines,
+        totalEntries,
+        byLevel,
+        errorRate,
+        timeRange: {
+            start: timestamps.length > 0 ? new Date(timestamps[0]).toISOString() : '',
+            end: timestamps.length > 0 ? new Date(timestamps[timestamps.length - 1]).toISOString() : '',
+        },
+        errorSpikes,
+        topErrors: errorGroups || [],
+        topPatterns: patterns || [],
+        noisePercentage: totalEntries > 0 ? Math.round((noiseCount / totalEntries) * 10000) / 100 : 0,
+        uniqueCorrelationIds: correlationIds.size,
+    };
+}
+/**
+ * Find 5-minute windows with above-average error rates.
+ */
+function calculateErrorSpikes(entries, windowMs) {
+    if (entries.length === 0)
+        return [];
+    const timestamps = entries.map((e) => e.timestamp).sort((a, b) => a - b);
+    const start = timestamps[0];
+    const end = timestamps[timestamps.length - 1];
+    if (end - start < windowMs)
+        return [];
+    const windows = new Map();
+    for (const entry of entries) {
+        const windowStart = Math.floor((entry.timestamp - start) / windowMs) * windowMs + start;
+        let w = windows.get(windowStart);
+        if (!w) {
+            w = { total: 0, errors: 0 };
+            windows.set(windowStart, w);
+        }
+        w.total++;
+        if (entry.priority === 'ERROR')
+            w.errors++;
+    }
+    const totalErrors = entries.filter((e) => e.priority === 'ERROR').length;
+    const avgErrorRate = entries.length > 0 ? totalErrors / entries.length : 0;
+    const spikes = [];
+    for (const [windowStart, w] of windows) {
+        const rate = w.total > 0 ? w.errors / w.total : 0;
+        if (rate > avgErrorRate * 1.5 && w.errors > 0) {
+            spikes.push({
+                window: new Date(windowStart).toISOString(),
+                count: w.errors,
+                rate: Math.round(rate * 10000) / 100,
+            });
+        }
+    }
+    return spikes.sort((a, b) => b.count - a.count).slice(0, 10);
+}
+//# sourceMappingURL=stats.js.map

package/dist/analysis/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/analysis/stats.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;GAEG;AACH,MAAM,UAAU,cAAc,CAC1B,OAA2B,EAC3B,UAAkB,EAClB,WAA0B,EAC1B,QAAuB;IAEvB,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,OAAO,CAAC,KAAK,CAAC;YAAE,UAAU,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,aAAa;YAAE,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACjE,IAAI,KAAK,CAAC,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAEjC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IACpC,MAAM,SAAS,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,YAAY,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,MAAM,WAAW,GAAG,oBAAoB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAEjE,OAAO;QACH,UAAU;QACV,YAAY;QACZ,OAAO;QACP,SAAS;QACT,SAAS,EAAE;YACP,KAAK,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE;YACzE,GAAG,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE;SAC9F;QACD,WAAW;QACX,SAAS,EAAE,WAAW,IAAI,EAAE;QAC5B,WAAW,EAAE,QAAQ,IAAI,EAAE;QAC3B,eAAe,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,YAAY,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7F,oBAAoB,EAAE,cAAc,CAAC,IAAI;KAC5C,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,OAA2B,EAAE,QAAgB;IACvE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE9C,IAAI,GAAG,GAAG,KAAK,GAAG,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6C,CAAC;IACrE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ,GAAG,KAAK,CAAC;QACxF,IAAI,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACjC,IAAI,CAAC,CAAC,EAAE,CAAC;YACL,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAChC,CAAC;QACD,CAAC,CAAC,KAAK,EAAE,CAAC;QACV,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO;YAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IACzE,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3E,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,IAAI,IAAI,GAAG,YAAY,GAAG,GAAG,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC;gBACR,MAAM,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE;gBAC3C,KAAK,EAAE,CAAC,CAAC,MAAM;gBACf,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,GAAG;aACvC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACjE,CAAC"}