@productbrain/cli 0.1.0-beta.14 → 0.1.0-beta.14010

package/dist/lib/style.test.js

@@ -0,0 +1,262 @@
+/**
+ * Tests for CLI style module — WP-302 Slice 1.
+ * Verifies color helpers respect NO_COLOR, quiet mode suppresses banners,
+ * and copy constants are non-empty strings.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+// Mock runner.js for quiet mode control
+vi.mock('./runner.js', () => ({
+    isQuietMode: vi.fn(() => false),
+    isJsonMode: vi.fn(() => false),
+}));
+import { green, red, yellow, dim, bold, supportsColor, icons, copy, banner, hint, progress, formatCheck, adminBanner, confirmProdAction, } from './style.js';
+import { isQuietMode } from './runner.js';
+const mockIsQuietMode = vi.mocked(isQuietMode);
+const mockQuiet = (val) => mockIsQuietMode.mockReturnValue(val);
+describe('color helpers', () => {
+    const originalEnv = process.env.NO_COLOR;
+    const originalIsTTY = process.stdout.isTTY;
+    afterEach(() => {
+        if (originalEnv === undefined) {
+            delete process.env.NO_COLOR;
+        }
+        else {
+            process.env.NO_COLOR = originalEnv;
+        }
+        Object.defineProperty(process.stdout, 'isTTY', { value: originalIsTTY, writable: true });
+    });
+    it('returns ANSI-wrapped string when color is supported', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, writable: true });
+        delete process.env.NO_COLOR;
+        expect(green('ok')).toContain('\x1b[32m');
+        expect(green('ok')).toContain('ok');
+        expect(red('err')).toContain('\x1b[31m');
+        expect(yellow('warn')).toContain('\x1b[33m');
+        expect(dim('faint')).toContain('\x1b[2m');
+        expect(bold('strong')).toContain('\x1b[1m');
+    });
+    it('returns plain string when NO_COLOR is set', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, writable: true });
+        process.env.NO_COLOR = '1';
+        expect(green('ok')).toBe('ok');
+        expect(red('err')).toBe('err');
+        expect(yellow('warn')).toBe('warn');
+        expect(dim('faint')).toBe('faint');
+        expect(bold('strong')).toBe('strong');
+    });
+    it('returns plain string when not a TTY', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, writable: true });
+        delete process.env.NO_COLOR;
+        expect(green('ok')).toBe('ok');
+        expect(red('err')).toBe('err');
+    });
+});
+describe('supportsColor', () => {
+    const originalEnv = process.env.NO_COLOR;
+    const originalIsTTY = process.stdout.isTTY;
+    afterEach(() => {
+        if (originalEnv === undefined) {
+            delete process.env.NO_COLOR;
+        }
+        else {
+            process.env.NO_COLOR = originalEnv;
+        }
+        Object.defineProperty(process.stdout, 'isTTY', { value: originalIsTTY, writable: true });
+    });
+    it('returns true for TTY without NO_COLOR', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, writable: true });
+        delete process.env.NO_COLOR;
+        expect(supportsColor()).toBe(true);
+    });
+    it('returns false when NO_COLOR is set', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, writable: true });
+        process.env.NO_COLOR = '1';
+        expect(supportsColor()).toBe(false);
+    });
+    it('returns false when not a TTY', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, writable: true });
+        delete process.env.NO_COLOR;
+        expect(supportsColor()).toBe(false);
+    });
+});
+describe('icons', () => {
+    it('has all expected icon keys', () => {
+        expect(icons.pass).toBeTruthy();
+        expect(icons.fail).toBeTruthy();
+        expect(icons.warn).toBeTruthy();
+        expect(icons.arrow).toBeTruthy();
+        expect(icons.dot).toBeTruthy();
+    });
+});
+describe('copy constants', () => {
+    it('all string constants are non-empty', () => {
+        expect(copy.captured.length).toBeGreaterThan(0);
+        expect(copy.linked.length).toBeGreaterThan(0);
+        expect(copy.updated.length).toBeGreaterThan(0);
+        expect(copy.noSession.length).toBeGreaterThan(0);
+        expect(copy.noSessionGuidance.length).toBeGreaterThan(0);
+        expect(copy.notFound.length).toBeGreaterThan(0);
+        expect(copy.authFailed.length).toBeGreaterThan(0);
+        expect(copy.nextOrient.length).toBeGreaterThan(0);
+        expect(copy.nextCapture.length).toBeGreaterThan(0);
+        expect(copy.sessionStarted.length).toBeGreaterThan(0);
+        expect(copy.sessionClosed.length).toBeGreaterThan(0);
+    });
+    it('function constants return non-empty strings', () => {
+        expect(copy.nextGet('BET-42').length).toBeGreaterThan(0);
+        expect(copy.nextGet('BET-42')).toContain('BET-42');
+        expect(copy.nextFields('tensions').length).toBeGreaterThan(0);
+        expect(copy.nextFields('tensions')).toContain('tensions');
+    });
+});
+describe('banner', () => {
+    let writeSpy;
+    beforeEach(() => {
+        writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        mockIsQuietMode.mockReturnValue(false);
+    });
+    afterEach(() => {
+        writeSpy.mockRestore();
+    });
+    it('writes title to stdout in normal mode', () => {
+        banner('Doctor');
+        expect(writeSpy).toHaveBeenCalled();
+        const output = writeSpy.mock.calls.map((c) => c[0]).join('');
+        expect(output).toContain('Doctor');
+    });
+    it('suppresses output in quiet mode', () => {
+        mockIsQuietMode.mockReturnValue(true);
+        banner('Doctor');
+        expect(writeSpy).not.toHaveBeenCalled();
+    });
+});
+describe('hint', () => {
+    let writeSpy;
+    beforeEach(() => {
+        writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        mockIsQuietMode.mockReturnValue(false);
+    });
+    afterEach(() => {
+        writeSpy.mockRestore();
+    });
+    it('writes hint text in normal mode', () => {
+        hint('Run `pb orient -b` to see your workspace.');
+        expect(writeSpy).toHaveBeenCalled();
+    });
+    it('suppresses output in quiet mode', () => {
+        mockIsQuietMode.mockReturnValue(true);
+        hint('Run `pb orient -b`');
+        expect(writeSpy).not.toHaveBeenCalled();
+    });
+});
+describe('progress', () => {
+    let writeSpy;
+    beforeEach(() => {
+        writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        mockIsQuietMode.mockReturnValue(false);
+    });
+    afterEach(() => {
+        writeSpy.mockRestore();
+    });
+    it('writes progress text in normal mode', () => {
+        progress('Classifying...');
+        expect(writeSpy).toHaveBeenCalled();
+        const output = writeSpy.mock.calls.map((c) => c[0]).join('');
+        expect(output).toContain('Classifying...');
+    });
+    it('suppresses output in quiet mode', () => {
+        mockIsQuietMode.mockReturnValue(true);
+        progress('Classifying...');
+        expect(writeSpy).not.toHaveBeenCalled();
+    });
+});
+describe('formatCheck', () => {
+    it('formats pass result with label and detail', () => {
+        const result = formatCheck('pass', 'Config file', '/path/to/.env');
+        expect(result).toContain('Config file');
+        expect(result).toContain('/path/to/.env');
+    });
+    it('formats fail result', () => {
+        const result = formatCheck('fail', 'API key', 'Not set');
+        expect(result).toContain('API key');
+        expect(result).toContain('Not set');
+    });
+    it('formats warn result', () => {
+        const result = formatCheck('warn', 'CLI', 'Unable to read');
+        expect(result).toContain('CLI');
+        expect(result).toContain('Unable to read');
+    });
+    it('pads label to 16 chars', () => {
+        const result = formatCheck('pass', 'Node', 'v22.0.0');
+        // "Node" (4 chars) padded to 16
+        expect(result).toContain('Node            v22.0.0');
+    });
+});
+describe('adminBanner', () => {
+    let writeSpy;
+    beforeEach(() => {
+        writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        mockIsQuietMode.mockReturnValue(false);
+    });
+    afterEach(() => {
+        writeSpy.mockRestore();
+    });
+    it('identifies localhost as dev', () => {
+        adminBanner('http://localhost:3000');
+        expect(writeSpy).toHaveBeenCalled();
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(output).toContain('[DEV]');
+    });
+    it('identifies 127.0.0.1 as dev', () => {
+        adminBanner('http://127.0.0.1:3000');
+        expect(writeSpy).toHaveBeenCalled();
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(output).toContain('[DEV]');
+    });
+    it('identifies ::1 as dev', () => {
+        adminBanner('http://[::1]:3000');
+        expect(writeSpy).toHaveBeenCalled();
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(output).toContain('[DEV]');
+    });
+    it('identifies known production hosts as PROD', () => {
+        adminBanner('https://api.productbrain.io');
+        expect(writeSpy).toHaveBeenCalled();
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(output).toContain('[PROD]');
+    });
+    it('identifies Convex dev-cloud deployment as DEV·CLOUD', () => {
+        adminBanner('https://trustworthy-kangaroo-277.convex.site');
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(output).toContain('[DEV·CLOUD]');
+    });
+    it('identifies unknown remote as CLOUD not PROD', () => {
+        adminBanner('https://other-team-abc.convex.site');
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(output).toContain('[CLOUD]');
+        expect(output).not.toContain('[PROD]');
+    });
+    it('suppresses output in quiet mode', () => {
+        mockIsQuietMode.mockReturnValue(true);
+        adminBanner('https://api.productbrain.io');
+        expect(writeSpy).not.toHaveBeenCalled();
+    });
+});
+describe('confirmProdAction', () => {
+    it('returns true immediately for dev environment', async () => {
+        const result = await confirmProdAction({ confirm: false, message: 'Are you sure?', isProduction: false });
+        expect(result).toBe(true);
+    });
+    it('returns true immediately when --confirm is passed', async () => {
+        const result = await confirmProdAction({ confirm: true, message: 'Are you sure?', isProduction: true });
+        expect(result).toBe(true);
+    });
+    it('returns false in non-TTY prod environment without --confirm', async () => {
+        const origIsTTY = process.stdin.isTTY;
+        Object.defineProperty(process.stdin, 'isTTY', { value: false, configurable: true });
+        const result = await confirmProdAction({ confirm: false, message: 'Seed all?', isProduction: true });
+        expect(result).toBe(false);
+        Object.defineProperty(process.stdin, 'isTTY', { value: origIsTTY, configurable: true });
+    });
+});
+//# sourceMappingURL=style.test.js.map

package/dist/lib/style.test.js.map

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

package/dist/lib/tokenConstants.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Token prefix constants — single source of truth for token format strings.
+ * packages/cli/src/lib/tokenConstants.ts and packages/mcp-server/src/lib/tokenConstants.ts are generated from this file
+ * (scripts/generate-mcp-embedded-copies.mjs, TASK-1158; TASK-1176).
+ * (Monorepo boundary: Convex cannot import from packages/cli and vice versa.)
+ *
+ * DEC-549
+ */
+/** Prefix for a person's permanent API key (bearer token). */
+export declare const API_KEY_PREFIX = "pb_sk_";
+/** Prefix for a seated AI agent's API key: a key bound to one role (DEC-2298, DEC-2226). The prefix tells a person which key they hold. */
+export declare const AGENT_KEY_PREFIX = "pb_agent_";
+/** The prefix a new key gets: an agent key when it is bound to a role, a person key otherwise. */
+export declare const apiKeyPrefixFor: (bound: boolean) => string;
+/** Either kind of API key, read from its prefix. Every reader that asks "is this an API key" asks here. */
+export declare const isApiKeyShaped: (token: string) => boolean;
+/** The stored display prefix (RULE-232: the hash and this prefix are stored, the raw key is shown once): the key's prefix plus six characters. */
+export declare const keyPrefixOf: (rawKey: string) => string;
+/** The one line every CLI and MCP key-format check prints (RULE-705, RULE-664). */
+export declare const API_KEY_FORMAT_LINE = "A key starts with pb_sk_ or pb_agent_. Get one from Settings, API Keys.";
+/** Prefix for short-lived connect tokens (15-min, single-use). */
+export declare const CONNECT_TOKEN_PREFIX = "pb_ct_";
+/** Prefix for preview-only admin proof-bridge tokens (≤24h, workspace-pinned; WP-459). */
+export declare const PREVIEW_ADMIN_TOKEN_PREFIX = "pb_pat_";
+/**
+ * Length of the random hex component in generated API keys.
+ * 32 hex chars = 128-bit entropy.
+ * Standardized from mixed 24/32 — new keys use 32, existing keys remain valid.
+ */
+export declare const API_KEY_HEX_LENGTH = 32;
+//# sourceMappingURL=tokenConstants.d.ts.map

package/dist/lib/tokenConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenConstants.d.ts","sourceRoot":"","sources":["../../src/lib/tokenConstants.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,2IAA2I;AAC3I,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C,kGAAkG;AAClG,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,MAAqD,CAAC;AAEvG,2GAA2G;AAC3G,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,OAAiF,CAAC;AAEjI,kJAAkJ;AAClJ,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,KAAG,MACyD,CAAC;AAEvG,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,4EAAiG,CAAC;AAElI,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C,0FAA0F;AAC1F,eAAO,MAAM,0BAA0B,YAAY,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAC"}

package/dist/lib/tokenConstants.js

@@ -0,0 +1,34 @@
+// GENERATED by scripts/generate-mcp-embedded-copies.mjs from convex/lib/tokenConstants.ts.
+// DO NOT EDIT. Run `npm run mcp:embedded-copies` to regenerate.
+// Local runtime copy for the isolated connector build.
+/**
+ * Token prefix constants — single source of truth for token format strings.
+ * packages/cli/src/lib/tokenConstants.ts and packages/mcp-server/src/lib/tokenConstants.ts are generated from this file
+ * (scripts/generate-mcp-embedded-copies.mjs, TASK-1158; TASK-1176).
+ * (Monorepo boundary: Convex cannot import from packages/cli and vice versa.)
+ *
+ * DEC-549
+ */
+/** Prefix for a person's permanent API key (bearer token). */
+export const API_KEY_PREFIX = 'pb_sk_';
+/** Prefix for a seated AI agent's API key: a key bound to one role (DEC-2298, DEC-2226). The prefix tells a person which key they hold. */
+export const AGENT_KEY_PREFIX = 'pb_agent_';
+/** The prefix a new key gets: an agent key when it is bound to a role, a person key otherwise. */
+export const apiKeyPrefixFor = (bound) => (bound ? AGENT_KEY_PREFIX : API_KEY_PREFIX);
+/** Either kind of API key, read from its prefix. Every reader that asks "is this an API key" asks here. */
+export const isApiKeyShaped = (token) => token.startsWith(API_KEY_PREFIX) || token.startsWith(AGENT_KEY_PREFIX);
+/** The stored display prefix (RULE-232: the hash and this prefix are stored, the raw key is shown once): the key's prefix plus six characters. */
+export const keyPrefixOf = (rawKey) => rawKey.slice(0, (rawKey.startsWith(AGENT_KEY_PREFIX) ? AGENT_KEY_PREFIX : API_KEY_PREFIX).length + 6);
+/** The one line every CLI and MCP key-format check prints (RULE-705, RULE-664). */
+export const API_KEY_FORMAT_LINE = `A key starts with ${API_KEY_PREFIX} or ${AGENT_KEY_PREFIX}. Get one from Settings, API Keys.`;
+/** Prefix for short-lived connect tokens (15-min, single-use). */
+export const CONNECT_TOKEN_PREFIX = 'pb_ct_';
+/** Prefix for preview-only admin proof-bridge tokens (≤24h, workspace-pinned; WP-459). */
+export const PREVIEW_ADMIN_TOKEN_PREFIX = 'pb_pat_';
+/**
+ * Length of the random hex component in generated API keys.
+ * 32 hex chars = 128-bit entropy.
+ * Standardized from mixed 24/32 — new keys use 32, existing keys remain valid.
+ */
+export const API_KEY_HEX_LENGTH = 32;
+//# sourceMappingURL=tokenConstants.js.map

package/dist/lib/tokenConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenConstants.js","sourceRoot":"","sources":["../../src/lib/tokenConstants.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,gEAAgE;AAChE,uDAAuD;AAEvD;;;;;;;GAOG;AAEH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEvC,2IAA2I;AAC3I,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAE5C,kGAAkG;AAClG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;AAEvG,2GAA2G;AAC3G,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AAEjI,kJAAkJ;AAClJ,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAc,EAAU,EAAE,CACrD,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAEvG,mFAAmF;AACnF,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,cAAc,OAAO,gBAAgB,oCAAoC,CAAC;AAElI,kEAAkE;AAClE,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAE7C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,CAAC;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC"}

package/dist/lib/update-check.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Ambient update notification for the Product Brain CLI (WP-322 S1 / FEAT-1012).
+ *
+ * Checks npm registry for the latest version of @productbrain/cli and prints
+ * a one-line notification when a newer version is available.
+ *
+ * Rules:
+ *   - Synchronous: reads cache only, never awaits network, never delays the command
+ *   - Multi-source cache at ~/.config/productbrain/update-check.json:
+ *     server header is authoritative within 48h; npm is an isNewer-gated fallback
+ *   - Silent on any error (network down, registry unreachable, etc.)
+ *   - JSON/agent mode: notice goes to stderr (stdout stays bare JSON), throttled once per session
+ *   - Does NOT use undici/fetch directly; uses Node.js built-in https
+ */
+/**
+ * Hot-path resolution from cache only — NEVER fetches. The **newest** in-window source wins: the
+ * server header is preferred only when it is actually the highest version, so a server that lags
+ * npm (its committed `cliVersion.ts` value trails the run-numbered npm publish — see TEN-2199) can
+ * no longer mask a newer npm latest. Returns the best available value even when every source is
+ * stale ("better than nothing"), because the hot path (checkForUpdate) cannot block on a refresh.
+ */
+export declare function resolveCachedLatest(): string | null;
+/** @deprecated use resolveCachedLatest. Kept for callers migrating. */
+export declare function readCachedLatestVersion(): string | null;
+/** Clear the post-upgrade sentinel and stale update cache on next CLI startup, and say once,
+ *  on stderr, which version is now running and where its releases are listed (TEN-4860). */
+export declare function clearPendingUpgradeCache(currentVersion?: string): void;
+/** Written after a successful self-upgrade so the next CLI process drops stale cache. */
+export declare function writeUpgradePendingSentinel(installedVersion?: string): void;
+/** Test-only: reset module-level per-process guards so each test starts clean. */
+export declare function _resetProcessGuardsForTest(): void;
+/**
+ * Compare two semver strings. Returns true if `b` is strictly newer than `a`.
+ * Handles standard x.y.z and x.y.z-beta.N formats (numeric comparison per part).
+ */
+export declare function isNewer(current: string, latest: string): boolean;
+/** Record the server-supplied latest version (authoritative source). */
+export declare function recordServerLatest(latestVersion: string | null): void;
+/** Record an npm-resolved latest version — gated so it never stores <= installed. */
+export declare function recordNpmLatest(latestVersion: string | null, currentVersion: string): void;
+/** LIVE resolve — fetches npm and records it (gated). Call ONLY from doctor/upgrade, never the hot path. */
+export declare function resolveLatestVersion(currentVersion?: string): Promise<string | null>;
+/**
+ * Synchronously prints at most one update line. Reads cache only — never fetches.
+ * Reaches agents (JSON mode) on stderr; stdout stays bare JSON. Throttled once per
+ * session (agent) / once per UTC day (human TTY) via O_EXCL markers. Never throws.
+ * NOTE: a session with no authenticated server call writes no cache and fires no
+ * notice; `pb doctor` live-resolves as the backstop. DEC-2.
+ */
+export declare function checkForUpdate(currentVersion: string): void;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/lib/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../src/lib/update-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAqDH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAUnD;AAYD,uEAAuE;AACvE,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AAMD;4FAC4F;AAC5F,wBAAgB,wBAAwB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CActE;AAED,yFAAyF;AACzF,wBAAgB,2BAA2B,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAK3E;AAED,kFAAkF;AAClF,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AA2BD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAuBhE;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAKrE;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAM1F;AAED,4GAA4G;AAC5G,wBAAsB,oBAAoB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmB1F;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAgB3D"}