@newrelic/preflight 0.0.1-pre.1 → 1.0.1

package/dist/deploy/deploy-dashboards.js

@@ -0,0 +1,282 @@
+/**
+ * Deploy AI Coding Assistant dashboards to a New Relic account.
+ *
+ * Exposed as the `preflight deploy-dashboards` subcommand so users who
+ * installed via `npm install -g` can run it without cloning the repo. The
+ * dashboard JSON definitions are bundled into `dist/data/dashboards/` at build
+ * time (see `package.json:build:server`).
+ */
+import { readFileSync, readdirSync } from 'node:fs';
+import { resolve, sep } from 'node:path';
+import { normalizeDeveloperName } from '../config.js';
+import { resolveDataDir } from './data-paths.js';
+export const CREATE_MUTATION = `
+mutation DashboardCreate($accountId: Int!, $dashboard: DashboardInput!) {
+  dashboardCreate(accountId: $accountId, dashboard: $dashboard) {
+    entityResult {
+      guid
+      name
+    }
+    errors {
+      description
+      type
+    }
+  }
+}`;
+export const UPDATE_MUTATION = `
+mutation DashboardUpdate($guid: EntityGuid!, $dashboard: DashboardInput!) {
+  dashboardUpdate(guid: $guid, dashboard: $dashboard) {
+    entityResult {
+      guid
+      name
+    }
+    errors {
+      description
+      type
+    }
+  }
+}`;
+export const DELETE_MUTATION = `
+mutation DashboardDelete($guid: EntityGuid!) {
+  dashboardDelete(guid: $guid) {
+    status
+    errors {
+      description
+      type
+    }
+  }
+}`;
+export const FIND_DASHBOARD_QUERY = `
+query FindDashboard($query: String!) {
+  actor {
+    entitySearch(query: $query) {
+      results {
+        entities {
+          guid
+          name
+        }
+      }
+    }
+  }
+}`;
+export function injectAccountId(dashboard, accountId) {
+    const copy = JSON.parse(JSON.stringify(dashboard));
+    for (const page of copy.pages) {
+        for (const widget of page.widgets) {
+            for (const nrqlQuery of widget.rawConfiguration.nrqlQueries ?? []) {
+                nrqlQuery.accountIds = [accountId];
+            }
+        }
+    }
+    for (const variable of copy.variables ?? []) {
+        if (variable.nrqlQuery) {
+            variable.nrqlQuery.accountIds = [accountId];
+        }
+    }
+    return copy;
+}
+export function injectDeveloperDefault(dashboard, developer) {
+    if (!dashboard.variables)
+        return;
+    for (const variable of dashboard.variables) {
+        if (variable.name === 'developer') {
+            variable.defaultValues = [{ value: { string: developer } }];
+            return;
+        }
+    }
+}
+async function nerdgraphRequest(apiKey, url, query, variables, fetchImpl) {
+    const response = await fetchImpl(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'API-Key': apiKey },
+        body: JSON.stringify({ query, variables }),
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`HTTP ${response.status}: ${body}`);
+    }
+    const json = (await response.json());
+    if (json.errors?.length) {
+        throw new Error(`NerdGraph errors: ${JSON.stringify(json.errors, null, 2)}`);
+    }
+    return json.data;
+}
+/** Escape a string for use in a Lucene query value (single-quoted). */
+export function escapeLuceneValue(s) {
+    return s.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+async function findDashboardGuid(apiKey, url, accountId, name, fetchImpl) {
+    const result = await nerdgraphRequest(apiKey, url, FIND_DASHBOARD_QUERY, {
+        query: `type = 'DASHBOARD' AND name = '${escapeLuceneValue(name)}' AND accountId = ${accountId}`,
+    }, fetchImpl);
+    const entities = result.actor?.entitySearch?.results?.entities ?? [];
+    return entities[0]?.guid ?? null;
+}
+function loadDashboard(dataDir, dashboardFile, accountId) {
+    const dashboardPath = resolve(dataDir, dashboardFile);
+    const prefix = dataDir.endsWith(sep) ? dataDir : dataDir + sep;
+    if (!dashboardPath.startsWith(prefix) && dashboardPath !== dataDir) {
+        throw new Error(`Dashboard file path escapes data directory: ${dashboardPath}`);
+    }
+    const raw = readFileSync(dashboardPath, 'utf-8');
+    return injectAccountId(JSON.parse(raw), accountId);
+}
+function printEntity(out, entity) {
+    out.write(`  ✓ ${entity.name}\n`);
+    out.write(`    GUID: ${entity.guid}\n`);
+    out.write(`    URL:  https://one.newrelic.com/dashboards/detail/${entity.guid}\n`);
+}
+async function deployDashboard(apiKey, url, accountId, dataDir, dashboardFile, developerOverride, fetchImpl, out) {
+    const dashboard = loadDashboard(dataDir, dashboardFile, accountId);
+    if (developerOverride) {
+        const normalised = normalizeDeveloperName(developerOverride);
+        injectDeveloperDefault(dashboard, normalised);
+        out.write(`  Developer default set to: ${normalised}\n`);
+    }
+    out.write(`Deploying dashboard "${dashboard.name}" to account ${accountId}...\n`);
+    const result = await nerdgraphRequest(apiKey, url, CREATE_MUTATION, { accountId, dashboard }, fetchImpl);
+    const createResult = result.dashboardCreate;
+    if (createResult?.errors?.length) {
+        throw new Error(`Dashboard creation errors: ${JSON.stringify(createResult.errors, null, 2)}`);
+    }
+    const entity = createResult?.entityResult;
+    if (!entity) {
+        throw new Error(`Unexpected response — no entity result returned: ${JSON.stringify(result, null, 2)}`);
+    }
+    printEntity(out, entity);
+}
+async function updateDashboard(apiKey, url, accountId, dataDir, dashboardFile, developerOverride, fetchImpl, out) {
+    const dashboard = loadDashboard(dataDir, dashboardFile, accountId);
+    if (developerOverride) {
+        const normalised = normalizeDeveloperName(developerOverride);
+        injectDeveloperDefault(dashboard, normalised);
+        out.write(`  Developer default set to: ${normalised}\n`);
+    }
+    out.write(`Looking up "${dashboard.name}" in account ${accountId}...\n`);
+    const guid = await findDashboardGuid(apiKey, url, accountId, dashboard.name, fetchImpl);
+    if (!guid) {
+        throw new Error(`No existing dashboard found with name "${dashboard.name}". Use deploy (without --update) to create it.`);
+    }
+    out.write(`  Found GUID: ${guid}\n`);
+    out.write(`  Updating...\n`);
+    const result = await nerdgraphRequest(apiKey, url, UPDATE_MUTATION, { guid, dashboard }, fetchImpl);
+    const updateResult = result.dashboardUpdate;
+    if (updateResult?.errors?.length) {
+        throw new Error(`Dashboard update errors: ${JSON.stringify(updateResult.errors, null, 2)}`);
+    }
+    const entity = updateResult?.entityResult;
+    if (!entity) {
+        throw new Error(`Unexpected response — no entity result returned: ${JSON.stringify(result, null, 2)}`);
+    }
+    printEntity(out, entity);
+}
+async function teardownDashboard(apiKey, url, accountId, dataDir, dashboardFile, fetchImpl, out) {
+    const dashboardPath = resolve(dataDir, dashboardFile);
+    const prefix = dataDir.endsWith(sep) ? dataDir : dataDir + sep;
+    if (!dashboardPath.startsWith(prefix) && dashboardPath !== dataDir) {
+        throw new Error(`Dashboard file path escapes data directory: ${dashboardPath}`);
+    }
+    const raw = readFileSync(dashboardPath, 'utf-8');
+    const dashboard = JSON.parse(raw);
+    out.write(`Looking up "${dashboard.name}" in account ${accountId}...\n`);
+    const guid = await findDashboardGuid(apiKey, url, accountId, dashboard.name, fetchImpl);
+    if (!guid) {
+        out.write(`  No dashboard named "${dashboard.name}" found. Skipping.\n`);
+        return;
+    }
+    out.write(`  Found GUID: ${guid}\n`);
+    out.write(`  Deleting...\n`);
+    const result = await nerdgraphRequest(apiKey, url, DELETE_MUTATION, { guid }, fetchImpl);
+    const deleteResult = result.dashboardDelete;
+    if (deleteResult?.errors?.length) {
+        throw new Error(`Dashboard deletion errors: ${JSON.stringify(deleteResult.errors, null, 2)}`);
+    }
+    out.write(`  ✓ Deleted "${dashboard.name}" (${deleteResult?.status ?? 'OK'})\n`);
+}
+function pickNerdgraphUrl(opts) {
+    if (opts.nerdgraphUrlOverride)
+        return opts.nerdgraphUrlOverride;
+    if (opts.eu)
+        return 'https://api.eu.newrelic.com/graphql';
+    return 'https://api.newrelic.com/graphql';
+}
+/**
+ * Run the deploy-dashboards command. Returns the exit code (0 = success,
+ * non-zero = failure). Side effects: writes progress to stdout, makes HTTP
+ * requests to NR's NerdGraph API.
+ *
+ * Reads `NEW_RELIC_API_KEY` and `NEW_RELIC_ACCOUNT_ID` from the environment
+ * (mandatory for non-print modes; print mode only requires accountId).
+ */
+export async function runDeployDashboards(opts) {
+    const out = opts.stdout ?? process.stdout;
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    if (opts.teardown && (opts.print || opts.update)) {
+        out.write('Error: --teardown is mutually exclusive with --print and --update.\n');
+        return 1;
+    }
+    if (opts.print && opts.update) {
+        out.write('Error: --print is mutually exclusive with --update.\n');
+        return 1;
+    }
+    if (opts.eu) {
+        out.write('Targeting EU API: https://api.eu.newrelic.com/graphql\n');
+    }
+    const accountIdStr = process.env.NEW_RELIC_ACCOUNT_ID;
+    if (!accountIdStr) {
+        out.write('Error: NEW_RELIC_ACCOUNT_ID environment variable is required\n');
+        return 1;
+    }
+    const accountId = parseInt(accountIdStr, 10);
+    if (Number.isNaN(accountId) || accountId <= 0 || String(accountId) !== accountIdStr.trim()) {
+        out.write(`Error: NEW_RELIC_ACCOUNT_ID must be a positive integer, got: ${accountIdStr}\n`);
+        return 1;
+    }
+    const dataDir = opts.dataDir ?? resolveDataDir('dashboards');
+    const url = pickNerdgraphUrl(opts);
+    const filesToProcess = opts.all
+        ? readdirSync(dataDir)
+            .filter((f) => f.endsWith('.json'))
+            .sort()
+        : [opts.file ?? 'ai-coding-assistant-overview.json'];
+    if (opts.print) {
+        for (const file of filesToProcess) {
+            const raw = readFileSync(resolve(dataDir, file), 'utf-8');
+            const dashboard = injectAccountId(JSON.parse(raw), accountId);
+            if (opts.developer) {
+                injectDeveloperDefault(dashboard, normalizeDeveloperName(opts.developer));
+            }
+            if (filesToProcess.length > 1) {
+                out.write(`\n// ─── ${file} ───\n`);
+            }
+            out.write(`${JSON.stringify(dashboard, null, 2)}\n`);
+        }
+        return 0;
+    }
+    const apiKey = process.env.NEW_RELIC_API_KEY;
+    if (!apiKey) {
+        out.write('Error: NEW_RELIC_API_KEY environment variable is required (User API key, not license key)\n');
+        out.write('       To print JSON for UI import instead, use --print (no API key needed)\n');
+        return 1;
+    }
+    try {
+        for (const file of filesToProcess) {
+            if (opts.teardown) {
+                await teardownDashboard(apiKey, url, accountId, dataDir, file, fetchImpl, out);
+            }
+            else if (opts.update) {
+                await updateDashboard(apiKey, url, accountId, dataDir, file, opts.developer, fetchImpl, out);
+            }
+            else {
+                await deployDashboard(apiKey, url, accountId, dataDir, file, opts.developer, fetchImpl, out);
+            }
+        }
+    }
+    catch (err) {
+        out.write(`\nFailed: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 1;
+    }
+    out.write('\nDone.\n');
+    return 0;
+}
+//# sourceMappingURL=deploy-dashboards.js.map

package/dist/deploy/deploy-dashboards.js.map

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

package/dist/digest/digest-formatter.d.ts

@@ -0,0 +1,3 @@
+import type { WeeklySummary } from '../storage/weekly-summary.js';
+export declare function formatSlackDigest(summary: WeeklySummary): Record<string, unknown>;
+//# sourceMappingURL=digest-formatter.d.ts.map

package/dist/digest/digest-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest-formatter.d.ts","sourceRoot":"","sources":["../../src/digest/digest-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuCjF"}

package/dist/digest/digest-formatter.js

@@ -0,0 +1,37 @@
+export function formatSlackDigest(summary) {
+    const totalCost = summary.totalCostUsd?.toFixed(4) ?? '—';
+    const avgEfficiency = summary.avgEfficiencyScore != null ? (summary.avgEfficiencyScore * 100).toFixed(1) : '—';
+    const topAntiPatternEntry = Object.entries(summary.antiPatternCounts ?? {}).sort(([, a], [, b]) => b - a)[0];
+    const topAntiPattern = topAntiPatternEntry ? topAntiPatternEntry[0] : 'none';
+    const safeTopAntiPattern = topAntiPattern.replace(/[\`\n]/g, '_');
+    return {
+        blocks: [
+            {
+                type: 'header',
+                text: { type: 'plain_text', text: '🤖 Weekly AI Coding Summary' },
+            },
+            {
+                type: 'section',
+                fields: [
+                    { type: 'mrkdwn', text: `*Total Cost:*\n$${totalCost}` },
+                    { type: 'mrkdwn', text: `*Avg Efficiency:*\n${avgEfficiency}/100` },
+                    { type: 'mrkdwn', text: `*Sessions:*\n${summary.sessionCount}` },
+                    { type: 'mrkdwn', text: `*Top Anti-pattern:*\n\`${safeTopAntiPattern}\`` },
+                ],
+            },
+            {
+                type: 'divider',
+            },
+            {
+                type: 'context',
+                elements: [
+                    {
+                        type: 'mrkdwn',
+                        text: '_Generated by Preflight_',
+                    },
+                ],
+            },
+        ],
+    };
+}
+//# sourceMappingURL=digest-formatter.js.map

package/dist/digest/digest-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest-formatter.js","sourceRoot":"","sources":["../../src/digest/digest-formatter.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,OAAsB;IACtD,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IAC1D,MAAM,aAAa,GACjB,OAAO,CAAC,kBAAkB,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3F,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,IAAI,CAC9E,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CACxB,CAAC,CAAC,CAAC,CAAC;IACL,MAAM,cAAc,GAAG,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7E,MAAM,kBAAkB,GAAG,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAElE,OAAO;QACL,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,6BAA6B,EAAE;aAClE;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE;oBACN,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,SAAS,EAAE,EAAE;oBACxD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,sBAAsB,aAAa,MAAM,EAAE;oBACnE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,OAAO,CAAC,YAAY,EAAE,EAAE;oBAChE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,0BAA0B,kBAAkB,IAAI,EAAE;iBAC3E;aACF;YACD;gBACE,IAAI,EAAE,SAAS;aAChB;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,0BAA0B;qBACjC;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/digest/digest-sender.d.ts

@@ -0,0 +1,2 @@
+export declare function sendSlackDigest(webhookUrl: string, payload: Record<string, unknown>): Promise<void>;
+//# sourceMappingURL=digest-sender.d.ts.map

package/dist/digest/digest-sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest-sender.d.ts","sourceRoot":"","sources":["../../src/digest/digest-sender.ts"],"names":[],"mappings":"AAAA,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/digest/digest-sender.js

@@ -0,0 +1,29 @@
+export async function sendSlackDigest(webhookUrl, payload) {
+    let parsed;
+    try {
+        parsed = new URL(webhookUrl);
+    }
+    catch {
+        throw new Error('Invalid webhook URL: must be a valid https://hooks.slack.com/ URL');
+    }
+    if (parsed.protocol !== 'https:' || parsed.hostname !== 'hooks.slack.com') {
+        throw new Error('Invalid webhook URL: must be a valid https://hooks.slack.com/ URL');
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 10_000);
+    try {
+        const resp = await fetch(webhookUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload),
+            signal: controller.signal,
+        });
+        if (!resp.ok) {
+            throw new Error(`Slack webhook returned ${resp.status}`);
+        }
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+//# sourceMappingURL=digest-sender.js.map

package/dist/digest/digest-sender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest-sender.js","sourceRoot":"","sources":["../../src/digest/digest-sender.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,OAAgC;IAEhC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,iBAAiB,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE;YACnC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/hooks/bash-classifier.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Coarse Bash command classifier.
+ *
+ * Bash is polymorphic: every shell invocation arrives as a single opaque
+ * `command` string, which makes downstream metrics blind to the difference
+ * between `git status` and `rm -rf node_modules`. This classifier turns the
+ * command into a small fixed set of categories so trackers, dashboards, and
+ * the audit trail can reason at the right granularity without trying to
+ * fully parse shell.
+ *
+ * Heuristic, not exact: pipelines, env-var prefixes, and `sudo` are stripped;
+ * the leading argv0 of the first command segment is matched against a lookup
+ * table. Anything we don't recognise falls into 'shell-other'.
+ */
+export type BashCategory = 'git' | 'package-manager' | 'test-runner' | 'build' | 'container' | 'network' | 'fs-op' | 'search' | 'custom-script' | 'shell-other';
+export interface BashClassification {
+    readonly category: BashCategory;
+    /** The resolved leading argv0 (after sudo / env stripping). Empty for blank input. */
+    readonly leading: string;
+    /** True for rm -rf, dd, mkfs, drop database, redirect to /dev/sd*, force-push, etc. */
+    readonly isDestructive: boolean;
+    /** True when the leading command is a network client (curl/wget/ssh/...). */
+    readonly isNetwork: boolean;
+}
+export declare function classifyBash(command: string): BashClassification;
+//# sourceMappingURL=bash-classifier.d.ts.map

package/dist/hooks/bash-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-classifier.d.ts","sourceRoot":"","sources":["../../src/hooks/bash-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,YAAY,GACpB,KAAK,GACL,iBAAiB,GACjB,aAAa,GACb,OAAO,GACP,WAAW,GACX,SAAS,GACT,OAAO,GACP,QAAQ,GACR,eAAe,GACf,aAAa,CAAC;AAElB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,sFAAsF;IACtF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAiXD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CA+ChE"}