@productbrain/cli 0.1.0-beta.7 → 0.1.0-beta.7003

package/dist/commands/connect-legacy-migration.test.js

@@ -0,0 +1,109 @@
+/**
+ * pb connect — legacy-install migration + malformed-profile regression tests (WP-628,
+ * Codex review P1/P2). Unlike connect.test.ts / connect-integration.test.ts, this file does
+ * NOT mock 'fs' or '../lib/profiles.js' — it drives the REAL profiles.ts against a throwaway
+ * HOME so the actual on-disk migration/occupancy behavior is exercised, not a mocked double.
+ * Only the network (fetch) and interactive/UI layers are stubbed.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from 'fs';
+import { resolve } from 'path';
+const { TEST_HOME, TEST_CONFIG_DIR, TEST_LEGACY_PATH, TEST_PROFILES_DIR } = vi.hoisted(() => {
+    const os = require('os');
+    const path = require('path');
+    const home = path.resolve(os.tmpdir(), `pb-test-connect-legacy-${process.pid}`);
+    return {
+        TEST_HOME: home,
+        TEST_CONFIG_DIR: path.resolve(home, '.config', 'productbrain'),
+        TEST_LEGACY_PATH: path.resolve(home, '.config', 'productbrain', '.env'),
+        TEST_PROFILES_DIR: path.resolve(home, '.config', 'productbrain', 'profiles'),
+    };
+});
+vi.mock('os', async (importOriginal) => {
+    const actual = await importOriginal();
+    return { ...actual, homedir: () => TEST_HOME };
+});
+const mockFetch = vi.fn();
+global.fetch = mockFetch;
+vi.mock('../lib/spinner.js', () => ({
+    withSpinner: async (_msg, fn) => fn(),
+}));
+vi.mock('@clack/prompts', () => ({
+    select: vi.fn(async () => 'start'),
+    isCancel: vi.fn(() => false),
+    text: vi.fn(async () => ''),
+}));
+vi.mock('./connect-screens.js', () => ({
+    runConnectScreens: vi.fn(async () => { }),
+    runConnectHeadless: vi.fn(async () => { }),
+}));
+vi.mock('./handshake.js', () => ({ runHandshake: vi.fn(async () => { }) }));
+import { runConnect } from './connect.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+function mockRedeemOnce(apiKey, workspaceName) {
+    mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: async () => ({ apiKey, workspaceId: 'ws1', workspaceName }),
+    });
+}
+describe('pb connect — legacy migration + malformed profile (WP-628 P1/P2)', () => {
+    const prevCwd = process.cwd();
+    let repoDir;
+    beforeEach(() => {
+        if (existsSync(TEST_CONFIG_DIR))
+            rmSync(TEST_CONFIG_DIR, { recursive: true, force: true });
+        mkdirSync(TEST_CONFIG_DIR, { recursive: true });
+        repoDir = resolve(TEST_HOME, 'repo');
+        mkdirSync(repoDir, { recursive: true });
+        process.chdir(repoDir);
+        mockFetch.mockClear();
+        delete process.env.PB_PROFILE;
+        process.env.PRODUCTBRAIN_API_KEY = undefined;
+        process.env.CONVEX_SITE_URL = undefined;
+    });
+    afterEach(() => {
+        process.chdir(prevCwd);
+        if (existsSync(TEST_HOME))
+            rmSync(TEST_HOME, { recursive: true, force: true });
+    });
+    it('P1: a legacy-only install migrates BEFORE connect creates the target profile — legacy key survives as "default", not deleted', async () => {
+        // Precondition: ONLY the legacy .env exists — no profiles dir yet.
+        writeFileSync(TEST_LEGACY_PATH, 'PRODUCTBRAIN_API_KEY=pb_sk_legacy_key\nCONVEX_SITE_URL=https://legacy.convex.site\n');
+        expect(existsSync(TEST_PROFILES_DIR)).toBe(false);
+        mockRedeemOnce('pb_sk_new_connect_key', 'New Workspace');
+        await runConnect('pb_ct_' + 'a'.repeat(40), { assumeYes: true });
+        // Before the fix: createProfile() created the profiles dir FIRST (for the new
+        // "new-workspace" profile), so the legacy .env was never migrated — and the next
+        // autoMigrate() call anywhere would silently DELETE it. Now: migrated into "default".
+        expect(existsSync(TEST_LEGACY_PATH)).toBe(false);
+        const defaultProfile = readFileSync(resolve(TEST_PROFILES_DIR, 'default.env'), 'utf8');
+        expect(defaultProfile).toContain('pb_sk_legacy_key');
+        // The newly connected profile exists independently, alongside the migrated legacy one.
+        const newProfile = readFileSync(resolve(TEST_PROFILES_DIR, 'new-workspace.env'), 'utf8');
+        expect(newProfile).toContain('pb_sk_new_connect_key');
+    });
+    it('P2: a malformed target profile (exists, no PRODUCTBRAIN_API_KEY) is treated as occupied, not absent — fails closed non-interactively with an actionable error, leaves the file untouched', async () => {
+        mkdirSync(TEST_PROFILES_DIR, { recursive: true });
+        // Malformed: exists on disk but has no parseable API key (e.g. partial write / manual edit).
+        writeFileSync(resolve(TEST_PROFILES_DIR, 'malformed-ws.env'), '# corrupt\nSOME_OTHER_VAR=x\n');
+        mockRedeemOnce('pb_sk_fresh_connect', 'Malformed WS');
+        const err = await runConnect('pb_ct_' + 'a'.repeat(40), { assumeYes: true }).catch((e) => e);
+        // Before the fix: resolveNamedProfileConfig() returned null for this file (can't parse
+        // an API key from it), misclassifying it as ABSENT — createProfile() then hit its OWN
+        // exclusive-create write, got EEXIST, and threw a plain PROFILE_ALREADY_EXISTS with none
+        // of the conflict-specific guidance. Now: profileFileExists() catches it as occupied and
+        // it flows through the same clobber gate as different-credentials, non-interactively
+        // failing closed with a distinct, actionable message.
+        expect(err).toBeInstanceOf(CLIError);
+        expect(err.code).toBe(ErrorCode.PROFILE_CREDENTIALS_CONFLICT);
+        expect(err.message).toContain('unreadable');
+        expect(err.guidance).toContain('PB_PROFILE=');
+        // Independent read — the malformed file is untouched, never silently replaced.
+        const content = readFileSync(resolve(TEST_PROFILES_DIR, 'malformed-ws.env'), 'utf8');
+        expect(content).not.toContain('pb_sk_fresh_connect');
+        expect(content).toContain('SOME_OTHER_VAR=x');
+    });
+});
+//# sourceMappingURL=connect-legacy-migration.test.js.map

package/dist/commands/connect-legacy-migration.test.js.map

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

package/dist/commands/connect-screens.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Ink screens for `pb connect` post-redemption wizard.
+ *
+ * Screen 1 — ConnectedScreen: shows workspace name + synced context file list.
+ * Screen 2 — ProfileScreen: shows profile name + multi-workspace hint.
+ *
+ * Each screen waits for "any key" via useInput before resolving.
+ * After both screens complete, the caller prints the tailored handoff message (WP-433 FEAT-1291).
+ *
+ * Chain: WP-325 S3, FEAT-1031, WP-379 S3b (seed polling)
+ */
+/**
+ * Runs the post-connect Ink wizard:
+ * 1. Prepares workspace context — waits for starter-setup seeds to be ready,
+ *    then runs a lenient handshake (see prepareConnectContext). Seeds must be
+ *    ready before the handshake fetches their bodies (WP-379 S3b, WP-439 S4).
+ * 2. Renders ConnectedScreen, waits for keypress.
+ * 3. Renders ProfileScreen, waits for keypress.
+ *
+ * After this resolves, the caller prints the tailored handoff message (WP-433 FEAT-1291).
+ */
+export declare function runConnectScreens(workspaceName: string, profileName: string): Promise<void>;
+/**
+ * Headless post-connect summary — the non-interactive counterpart to runConnectScreens,
+ * used when `pb connect --yes` runs without a TTY (e.g. CI). It prepares the SAME workspace
+ * context (seed poll + lenient handshake) so context files are written in CI too, then
+ * writes a plain-text summary instead of rendering Ink. The Ink screens wait on keypresses
+ * via useInput, which needs raw-mode stdin a non-TTY shell can't provide — rendering them
+ * there throws after the key/config were already written (TEN-2561 / WP-2). No keypress is
+ * awaited here. `workspaceName` is pre-sanitized by the caller (stripControlChars).
+ */
+export declare function runConnectHeadless(workspaceName: string, profileName: string): Promise<void>;
+//# sourceMappingURL=connect-screens.d.ts.map

package/dist/commands/connect-screens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-screens.d.ts","sourceRoot":"","sources":["../../src/commands/connect-screens.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiNH;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CjG;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqClG"}

package/dist/commands/connect-screens.js

@@ -0,0 +1,143 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Ink screens for `pb connect` post-redemption wizard.
+ *
+ * Screen 1 — ConnectedScreen: shows workspace name + synced context file list.
+ * Screen 2 — ProfileScreen: shows profile name + multi-workspace hint.
+ *
+ * Each screen waits for "any key" via useInput before resolving.
+ * After both screens complete, the caller prints the tailored handoff message (WP-433 FEAT-1291).
+ *
+ * Chain: WP-325 S3, FEAT-1031, WP-379 S3b (seed polling)
+ */
+import React from 'react';
+import { render, Box, Text, useInput, useApp } from 'ink';
+import { prepareConnectContext } from './connect-context.js';
+import { withSpinner } from '../lib/spinner.js';
+import { renderFilesystemPath } from '../lib/strip.js';
+// Surfaces pb projects context files to. Rendered as the "synced" list, minus
+// any surface whose file the handshake left untouched (TEN-2107) — so a file is
+// never shown as both synced and left-untouched.
+const PROJECTED_SURFACES = [
+    { file: '.cursor/rules/', arrow: '    → ', tool: 'Cursor' },
+    { file: 'CLAUDE.md', arrow: '          → ', tool: 'Claude Code' },
+    { file: '.github/', arrow: '           → ', tool: 'GitHub Copilot' },
+    { file: 'AGENTS.md', arrow: '          → ', tool: 'Codex / CI' },
+];
+function ConnectedScreen({ workspaceName, handshakeFailed, handshakeError, seedGaps, skippedFiles, leftoverFiles, leftoverFilesTruncated, onExit }) {
+    const { exit } = useApp();
+    useInput(() => {
+        onExit();
+        exit();
+    });
+    // A surface is "left untouched" when a skipped file equals it (CLAUDE.md,
+    // AGENTS.md) or sits under it (.cursor/rules/*, .github/*).
+    const isLeftUntouched = (surfaceFile) => (skippedFiles ?? []).some((f) => f === surfaceFile || f.startsWith(surfaceFile));
+    const syncedSurfaces = PROJECTED_SURFACES.filter((s) => !isLeftUntouched(s.file));
+    return (_jsxs(Box, { flexDirection: "column", paddingTop: 1, paddingBottom: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { color: "green", bold: true, children: '✓ ' }), _jsx(Text, { bold: true, children: 'Connected to ' }), _jsx(Text, { bold: true, color: "green", children: workspaceName })] }), !handshakeFailed && syncedSurfaces.length > 0 && (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { children: 'Context files synced to your AI tools:' }) }), _jsx(Box, { flexDirection: "column", marginLeft: 2, children: syncedSurfaces.map((s) => (_jsxs(Box, { children: [_jsx(Text, { dimColor: true, children: s.file }), _jsx(Text, { dimColor: true, children: s.arrow }), _jsx(Text, { children: s.tool })] }, s.file))) }), _jsxs(Box, { marginTop: 1, marginLeft: 2, children: [_jsx(Text, { dimColor: true, children: 'These update when you run ' }), _jsx(Text, { dimColor: true, bold: true, children: '`pb session start`' })] })] })), handshakeFailed && (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(Text, { dimColor: true, children: '⚠ Context sync skipped' }), handshakeError && (_jsx(Text, { dimColor: true, children: ` — ${handshakeError}` }))] }), _jsx(Box, { marginLeft: 2, children: _jsx(Text, { dimColor: true, children: 'Run `pb handshake` manually to set up context files.' }) })] })), seedGaps && seedGaps.length > 0 && (_jsx(Box, { flexDirection: "column", marginBottom: 1, marginTop: 1, children: seedGaps.map((gap, i) => (_jsxs(Box, { children: [_jsx(Text, { color: "yellow", children: '⚠ ' }), _jsx(Text, { dimColor: true, children: `${gap.message} (kind: ${gap.kind}). Wait a few seconds and re-run ` }), _jsx(Text, { dimColor: true, bold: true, children: 'pb connect' }), _jsx(Text, { dimColor: true, children: '.' })] }, i))) })), skippedFiles && skippedFiles.length > 0 && (_jsx(Box, { flexDirection: "column", marginBottom: 1, children: _jsxs(Box, { children: [_jsx(Text, { dimColor: true, children: 'Left untouched (your own files): ' }), _jsx(Text, { children: skippedFiles.join(', ') })] }) })), leftoverFiles && leftoverFiles.length > 0 && (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(Text, { color: "yellow", children: '⚠ ' }), _jsx(Text, { dimColor: true, children: 'Leftover files found — review before removing (may hold local edits):' })] }), _jsxs(Box, { flexDirection: "column", marginLeft: 2, children: [leftoverFiles.map((f) => (
+                            // Round 15 (Codex P2): reversible escaper (lib/strip.ts) — sanitizeSingleLineField
+                            // is lossy (collapses whitespace, deletes \r) for a filename the user must go find.
+                            _jsx(Text, { dimColor: true, children: `${renderFilesystemPath(f.path)} — ${renderFilesystemPath(f.reason)}` }, f.path))), leftoverFilesTruncated && (
+                            // Round 13 (Codex P2): `pb handshake` applies the same cap — never promise it shows
+                            // "the full list", which it can't. Tell the user what to do with this batch instead.
+                            _jsx(Text, { dimColor: true, children: '...more may exist beyond this batch — review/remove these, then run `pb handshake` again.' }))] })] })), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: 'Press any key to continue' }) })] }));
+}
+function ProfileScreen({ profileName, onExit }) {
+    const { exit } = useApp();
+    useInput(() => {
+        onExit();
+        exit();
+    });
+    return (_jsxs(Box, { flexDirection: "column", paddingTop: 1, paddingBottom: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { children: 'Your API key is saved as profile ' }), _jsx(Text, { bold: true, color: "cyan", children: profileName })] }), _jsxs(Box, { flexDirection: "column", marginBottom: 1, marginLeft: 2, children: [_jsx(Box, { children: _jsx(Text, { dimColor: true, children: 'To connect another workspace:' }) }), _jsx(Box, { marginLeft: 2, children: _jsx(Text, { children: 'pb connect <token>' }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: 'To switch between workspaces:' }) }), _jsx(Box, { marginLeft: 2, children: _jsx(Text, { children: 'pb use <profile>' }) })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: 'Press any key to continue' }) })] }));
+}
+// ---------------------------------------------------------------------------
+// Runner — handshake + sequential screen rendering
+// ---------------------------------------------------------------------------
+/**
+ * Runs the post-connect Ink wizard:
+ * 1. Prepares workspace context — waits for starter-setup seeds to be ready,
+ *    then runs a lenient handshake (see prepareConnectContext). Seeds must be
+ *    ready before the handshake fetches their bodies (WP-379 S3b, WP-439 S4).
+ * 2. Renders ConnectedScreen, waits for keypress.
+ * 3. Renders ProfileScreen, waits for keypress.
+ *
+ * After this resolves, the caller prints the tailored handoff message (WP-433 FEAT-1291).
+ */
+export async function runConnectScreens(workspaceName, profileName) {
+    // Prepare workspace context for the screens: wait for starter-setup seeds to
+    // be ready, then run a lenient handshake. Ordering + lenience matter on fresh
+    // workspaces — see prepareConnectContext (connect-context.ts).
+    //
+    // WP-2: one human progress line replaces the raw internal kernelCall spinners.
+    // withSpinner samples the quiet flag at start — quiet is still off here, so this line
+    // shows; prepareConnectContext flips quiet on internally so its own kernelCall spinners
+    // stay silent (and clears the line again if the work finishes before the 200ms delay).
+    const { handshakeFailed, handshakeError, seedGaps, skippedFiles, leftoverFiles, leftoverFilesTruncated } = await withSpinner('Setting up your workspace context', () => prepareConnectContext());
+    // Screen 1 — ConnectedScreen
+    await new Promise((resolve) => {
+        const { unmount, waitUntilExit } = render(React.createElement(ConnectedScreen, {
+            workspaceName,
+            handshakeFailed,
+            handshakeError,
+            seedGaps,
+            skippedFiles,
+            leftoverFiles,
+            leftoverFilesTruncated,
+            onExit: () => {
+                unmount();
+                resolve();
+            },
+        }));
+        void waitUntilExit().catch(() => resolve());
+    });
+    // Screen 2 — ProfileScreen
+    await new Promise((resolve) => {
+        const { unmount, waitUntilExit } = render(React.createElement(ProfileScreen, {
+            profileName,
+            onExit: () => {
+                unmount();
+                resolve();
+            },
+        }));
+        void waitUntilExit().catch(() => resolve());
+    });
+}
+/**
+ * Headless post-connect summary — the non-interactive counterpart to runConnectScreens,
+ * used when `pb connect --yes` runs without a TTY (e.g. CI). It prepares the SAME workspace
+ * context (seed poll + lenient handshake) so context files are written in CI too, then
+ * writes a plain-text summary instead of rendering Ink. The Ink screens wait on keypresses
+ * via useInput, which needs raw-mode stdin a non-TTY shell can't provide — rendering them
+ * there throws after the key/config were already written (TEN-2561 / WP-2). No keypress is
+ * awaited here. `workspaceName` is pre-sanitized by the caller (stripControlChars).
+ */
+export async function runConnectHeadless(workspaceName, profileName) {
+    const { handshakeFailed, handshakeError, seedGaps, skippedFiles, leftoverFiles, leftoverFilesTruncated } = await withSpinner('Setting up your workspace context', () => prepareConnectContext());
+    const out = process.stdout;
+    out.write(`✓ Connected to ${workspaceName}\n`);
+    if (handshakeFailed) {
+        out.write(`⚠ Context sync skipped${handshakeError ? ` — ${handshakeError}` : ''}. ` +
+            'Run `pb handshake` to set up context files.\n');
+    }
+    else {
+        out.write('Context files synced to your AI tools (Cursor, Claude Code, GitHub Copilot, Codex / CI).\n');
+    }
+    if (skippedFiles && skippedFiles.length > 0) {
+        out.write(`Left untouched (your own files): ${skippedFiles.join(', ')}\n`);
+    }
+    if (leftoverFiles && leftoverFiles.length > 0) {
+        // Round 12 (Codex P2): never "safe to remove" — unclassified, could hold local edits.
+        out.write('⚠ Leftover files found — review before removing (may hold local edits):\n');
+        // Round 15 (Codex P2): reversible escaper — see formatters/handshake.ts's own comment.
+        for (const f of leftoverFiles)
+            out.write(`  ${renderFilesystemPath(f.path)} — ${renderFilesystemPath(f.reason)}\n`);
+        if (leftoverFilesTruncated) {
+            out.write('  ...more may exist beyond this batch — review/remove these, then run `pb handshake` again.\n');
+        }
+    }
+    for (const gap of seedGaps ?? []) {
+        out.write(`⚠ ${gap.message} (kind: ${gap.kind}). Wait a few seconds and re-run \`pb connect\`.\n`);
+    }
+    out.write(`Your API key is saved as profile ${profileName}.\n`);
+}
+//# sourceMappingURL=connect-screens.js.map

package/dist/commands/connect-screens.js.map

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

package/dist/commands/connect.d.ts

@@ -0,0 +1,42 @@
+/**
+ * pb connect — redeem a short-lived connect token to save an API key locally.
+ *
+ * Part of FEAT-958 Path C: Onboarding flow. Redeems a connect token, saves API
+ * key locally, runs Ink screens, then prints a tailored chat-handoff instruction
+ * (WP-433 FEAT-1291).
+ */
+/**
+ * Write project config files to pin this project to the workspace.
+ * Returns the prior repo profile pin so the caller can detect a workspace redirect.
+ *
+ * Split design:
+ * - config.json (committed): siteUrl only — workspace gateway, safe to share with teammates.
+ *   Strips any legacy `profile` field that may be present from earlier pb versions.
+ * - config.local.json (gitignored): profile pin — machine-local, never committed.
+ *   Written via the shared setLocalProfilePin() writer (used by `pb profile use --local`
+ *   and `pb connect`).
+ *
+ * Does NOT include the API key anywhere — that stays in profiles, never committed.
+ */
+export declare function saveProjectConfig(siteUrl: string, profileName: string): {
+    previousProfile: string | null;
+};
+export interface ConnectOptions {
+    /** Override redeem gateway (`pb connect --gateway`). */
+    gateway?: string;
+    /** Optional API key label for workspace settings (non-TTY: use instead of prompt). */
+    name?: string;
+    /**
+     * Skip the interactive workspace-confirm gate (`pb connect --yes`). Required to
+     * connect in a non-interactive shell (e.g. CI), where the gate otherwise fails
+     * closed. Pairs with `--name` for scripted connects.
+     */
+    assumeYes?: boolean;
+}
+/**
+ * Main entrypoint for `pb connect <token>`.
+ * Validates token format, redeems it via /auth/redeem-connect-token,
+ * saves the key, and runs the wizard (S3).
+ */
+export declare function runConnect(token: string, options?: ConnectOptions): Promise<void>;
+//# sourceMappingURL=connect.d.ts.map

package/dist/commands/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8QH;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG;IAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAoB1G;AAED,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAiFD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2F3F"}