@indigoai-us/hq-cli 5.1.0

package/dist/commands/cloud-setup.js

@@ -0,0 +1,206 @@
+/**
+ * hq cloud commands — cloud session management
+ *
+ * Subcommands:
+ * - setup-token: Walk user through generating and storing a Claude OAuth token
+ * - status: Show cloud readiness (auth state + Claude token state)
+ * - upload: Initial HQ file upload to cloud storage
+ */
+import * as readline from 'readline';
+import chalk from 'chalk';
+import { readCredentials, isExpired, } from '../utils/credentials.js';
+import { apiRequest, getApiUrl } from '../utils/api-client.js';
+import { findHqRoot } from '../utils/manifest.js';
+import { runInitialUpload } from './initial-upload.js';
+/** Minimum token length for basic validation */
+const MIN_TOKEN_LENGTH = 20;
+/**
+ * Validate a Claude OAuth token string.
+ * Returns null if valid, or an error message string if invalid.
+ */
+export function validateClaudeToken(token) {
+    if (!token || token.trim().length === 0) {
+        return 'Token cannot be empty.';
+    }
+    const trimmed = token.trim();
+    if (trimmed.length < MIN_TOKEN_LENGTH) {
+        return `Token is too short (${trimmed.length} chars). Claude tokens are typically much longer. Please check you copied the full token.`;
+    }
+    // Reject tokens that look like they contain whitespace in the middle (copy-paste artifacts)
+    if (/\s/.test(trimmed)) {
+        return 'Token contains whitespace. Please ensure you copied it correctly without line breaks.';
+    }
+    return null;
+}
+/**
+ * Prompt the user for input on stdin.
+ * Returns the entered string (trimmed).
+ */
+function promptUser(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+/**
+ * Register the "hq cloud" command group with setup-token and status subcommands.
+ */
+export function registerCloudSetupCommand(program) {
+    const cloudCmd = program
+        .command('cloud')
+        .description('Cloud session management — token setup and status');
+    // --- hq cloud setup-token ---
+    cloudCmd
+        .command('setup-token')
+        .description('Set up your Claude OAuth token for cloud sessions')
+        .action(async () => {
+        try {
+            // Check auth first (AC #6)
+            const creds = readCredentials();
+            if (!creds || isExpired(creds)) {
+                console.log(chalk.red('Not logged in to HQ Cloud.'));
+                console.log('Run "hq auth login" first, then try again.');
+                process.exit(1);
+            }
+            console.log(chalk.blue('Claude Token Setup'));
+            console.log('');
+            console.log('To launch cloud sessions, HQ needs your Claude OAuth token.');
+            console.log('This token lets cloud containers run Claude on your behalf.');
+            console.log('');
+            console.log(chalk.yellow('Step 1:') + ' Open a terminal and run:');
+            console.log('');
+            console.log(chalk.cyan('  claude setup-token'));
+            console.log('');
+            console.log(chalk.yellow('Step 2:') + ' Copy the token output and paste it below.');
+            console.log('');
+            // Prompt for the token
+            const token = await promptUser('Paste your Claude token: ');
+            // Validate format (AC #2)
+            const validationError = validateClaudeToken(token);
+            if (validationError) {
+                console.log('');
+                console.log(chalk.red('Invalid token: ') + validationError);
+                process.exit(1);
+            }
+            // Send to API (AC #3)
+            console.log('');
+            console.log(chalk.dim('Storing token securely...'));
+            const resp = await apiRequest('POST', '/api/settings/claude-token', { token: token.trim() });
+            if (!resp.ok) {
+                console.log(chalk.red('Failed to store token: ') + (resp.error ?? `HTTP ${resp.status}`));
+                process.exit(1);
+            }
+            // Success (AC #4)
+            console.log('');
+            console.log(chalk.green('Claude token stored securely.'));
+            if (resp.data?.setAt) {
+                console.log(chalk.dim(`  Set at: ${resp.data.setAt}`));
+            }
+            console.log('');
+            console.log('You can now launch cloud sessions with "hq cloud" commands.');
+        }
+        catch (error) {
+            console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    // --- hq cloud status ---
+    cloudCmd
+        .command('status')
+        .description('Show cloud readiness — authentication and Claude token status')
+        .action(async () => {
+        try {
+            console.log(chalk.blue('HQ Cloud Status'));
+            console.log('');
+            // 1. Auth status
+            const creds = readCredentials();
+            if (!creds) {
+                console.log(`  Auth:          ${chalk.red('Not logged in')}`);
+                console.log(`  Claude Token:  ${chalk.dim('unknown (login first)')}`);
+                console.log('');
+                console.log('Run "hq auth login" to get started.');
+                return;
+            }
+            if (isExpired(creds)) {
+                console.log(`  Auth:          ${chalk.red('Session expired')}`);
+                console.log(`  Claude Token:  ${chalk.dim('unknown (login first)')}`);
+                console.log('');
+                console.log('Run "hq auth login" to re-authenticate.');
+                return;
+            }
+            const label = creds.email ?? creds.userId;
+            console.log(`  Auth:          ${chalk.green('Logged in')} as ${label}`);
+            console.log(`  API:           ${getApiUrl()}`);
+            // 2. Claude token status (AC #5)
+            try {
+                const resp = await apiRequest('GET', '/api/settings/claude-token');
+                if (resp.ok && resp.data) {
+                    if (resp.data.hasToken) {
+                        console.log(`  Claude Token:  ${chalk.green('Configured')}`);
+                        if (resp.data.setAt) {
+                            console.log(`  Token Set At:  ${resp.data.setAt}`);
+                        }
+                    }
+                    else {
+                        console.log(`  Claude Token:  ${chalk.yellow('Not configured')}`);
+                        console.log('');
+                        console.log('Run "hq cloud setup-token" to configure your Claude token.');
+                    }
+                }
+                else {
+                    console.log(`  Claude Token:  ${chalk.yellow('Could not check')} (API returned ${resp.status})`);
+                }
+            }
+            catch {
+                console.log(`  Claude Token:  ${chalk.dim('Could not reach API')}`);
+            }
+            console.log('');
+        }
+        catch (error) {
+            console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    // --- hq cloud upload ---
+    cloudCmd
+        .command('upload')
+        .description('Upload local HQ files to cloud storage (initial setup)')
+        .option('--hq-root <path>', 'Path to HQ root directory (auto-detected if omitted)')
+        .option('--on-conflict <action>', 'Action when remote has files: merge, replace, or skip')
+        .action(async (opts) => {
+        try {
+            // Require auth
+            const creds = readCredentials();
+            if (!creds || isExpired(creds)) {
+                console.log(chalk.red('Not logged in to HQ Cloud.'));
+                console.log('Run "hq auth login" first, then try again.');
+                process.exit(1);
+            }
+            const hqRoot = opts.hqRoot ?? findHqRoot();
+            console.log(chalk.blue('HQ Cloud — Initial Upload'));
+            console.log(chalk.dim(`  HQ root: ${hqRoot}`));
+            console.log('');
+            const onConflict = opts.onConflict;
+            const result = await runInitialUpload(hqRoot, {
+                onConflict,
+            });
+            if (result.skipped) {
+                process.exit(0);
+            }
+            if (result.failed > 0) {
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            console.error(chalk.red('Upload failed:'), error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=cloud-setup.js.map

package/dist/commands/cloud-setup.js.map

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

package/dist/commands/cloud.d.ts

@@ -0,0 +1,16 @@
+/**
+ * hq sync commands — cloud sync management via API proxy
+ *
+ * All sync operations go through the hq-cloud API (authenticated with Clerk
+ * tokens from US-002). No AWS credentials or direct S3 access needed.
+ *
+ * Commands:
+ *   hq sync push    — Upload changed local files to cloud
+ *   hq sync pull    — Download changed cloud files to local
+ *   hq sync start   — Begin background auto-sync watcher
+ *   hq sync stop    — Halt the background watcher
+ *   hq sync status  — Show sync state, last sync time, file counts
+ */
+import { Command } from 'commander';
+export declare function registerCloudCommands(program: Command): void;
+//# sourceMappingURL=cloud.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cloud.d.ts","sourceRoot":"","sources":["../../src/commands/cloud.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6CpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgP5D"}

package/dist/commands/cloud.js

@@ -0,0 +1,263 @@
+/**
+ * hq sync commands — cloud sync management via API proxy
+ *
+ * All sync operations go through the hq-cloud API (authenticated with Clerk
+ * tokens from US-002). No AWS credentials or direct S3 access needed.
+ *
+ * Commands:
+ *   hq sync push    — Upload changed local files to cloud
+ *   hq sync pull    — Download changed cloud files to local
+ *   hq sync start   — Begin background auto-sync watcher
+ *   hq sync stop    — Halt the background watcher
+ *   hq sync status  — Show sync state, last sync time, file counts
+ */
+import { fork } from 'child_process';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import chalk from 'chalk';
+import { findHqRoot } from '../utils/manifest.js';
+import { readCredentials, isExpired } from '../utils/credentials.js';
+import { pushChanges, pullChanges, computeLocalManifest, readSyncState, writeSyncState, getQuota, } from '../utils/sync.js';
+/**
+ * Verify that the user is authenticated before running sync commands.
+ * Throws if not logged in or token is expired.
+ */
+function requireAuth() {
+    const creds = readCredentials();
+    if (!creds) {
+        throw new Error('Not logged in. Run "hq auth login" first.');
+    }
+    if (isExpired(creds)) {
+        throw new Error('Session expired. Run "hq auth login" to re-authenticate.');
+    }
+}
+/**
+ * Check if a background sync process is actually running (not just recorded).
+ */
+function isProcessRunning(pid) {
+    try {
+        // Sending signal 0 checks if process exists without killing it
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function registerCloudCommands(program) {
+    // ── hq sync push ────────────────────────────────────────────────────────
+    program
+        .command('push')
+        .description('Upload changed local files to cloud via API proxy')
+        .action(async () => {
+        try {
+            requireAuth();
+            const hqRoot = findHqRoot();
+            console.log(chalk.blue('Computing local manifest...'));
+            const manifest = computeLocalManifest(hqRoot);
+            console.log(chalk.dim(`  ${manifest.length} local files scanned`));
+            console.log(chalk.blue('Checking for changes...'));
+            const result = await pushChanges(hqRoot);
+            if (result.uploaded === 0 && result.errors.length === 0) {
+                console.log(chalk.green('Already up to date. No files to push.'));
+            }
+            else {
+                console.log(chalk.green(`Pushed ${result.uploaded} file${result.uploaded !== 1 ? 's' : ''} to cloud.`));
+            }
+            if (result.errors.length > 0) {
+                console.log(chalk.yellow(`  ${result.errors.length} error${result.errors.length !== 1 ? 's' : ''}:`));
+                for (const err of result.errors.slice(0, 5)) {
+                    console.log(chalk.red(`    - ${err}`));
+                }
+                if (result.errors.length > 5) {
+                    console.log(chalk.dim(`    ... and ${result.errors.length - 5} more`));
+                }
+            }
+            // Update sync state
+            const state = readSyncState(hqRoot);
+            state.lastSync = new Date().toISOString();
+            state.fileCount = manifest.length;
+            state.errors = result.errors;
+            writeSyncState(hqRoot, state);
+        }
+        catch (error) {
+            console.error(chalk.red('Push failed:'), error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    // ── hq sync pull ────────────────────────────────────────────────────────
+    program
+        .command('pull')
+        .description('Download changed cloud files to local via API proxy')
+        .action(async () => {
+        try {
+            requireAuth();
+            const hqRoot = findHqRoot();
+            console.log(chalk.blue('Computing local manifest...'));
+            const manifest = computeLocalManifest(hqRoot);
+            console.log(chalk.dim(`  ${manifest.length} local files scanned`));
+            console.log(chalk.blue('Checking for changes...'));
+            const result = await pullChanges(hqRoot);
+            if (result.downloaded === 0 && result.errors.length === 0) {
+                console.log(chalk.green('Already up to date. No files to pull.'));
+            }
+            else {
+                console.log(chalk.green(`Pulled ${result.downloaded} file${result.downloaded !== 1 ? 's' : ''} from cloud.`));
+            }
+            if (result.errors.length > 0) {
+                console.log(chalk.yellow(`  ${result.errors.length} error${result.errors.length !== 1 ? 's' : ''}:`));
+                for (const err of result.errors.slice(0, 5)) {
+                    console.log(chalk.red(`    - ${err}`));
+                }
+                if (result.errors.length > 5) {
+                    console.log(chalk.dim(`    ... and ${result.errors.length - 5} more`));
+                }
+            }
+            // Update sync state
+            const state = readSyncState(hqRoot);
+            state.lastSync = new Date().toISOString();
+            state.fileCount = manifest.length;
+            state.errors = result.errors;
+            writeSyncState(hqRoot, state);
+        }
+        catch (error) {
+            console.error(chalk.red('Pull failed:'), error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    // ── hq sync start ──────────────────────────────────────────────────────
+    program
+        .command('start')
+        .description('Start background auto-sync watcher (polls every 30s)')
+        .option('-i, --interval <seconds>', 'Polling interval in seconds', '30')
+        .action(async (opts) => {
+        try {
+            requireAuth();
+            const hqRoot = findHqRoot();
+            const intervalSec = parseInt(opts.interval, 10);
+            if (isNaN(intervalSec) || intervalSec < 5) {
+                throw new Error('Interval must be at least 5 seconds.');
+            }
+            // Check if already running
+            const existingState = readSyncState(hqRoot);
+            if (existingState.running && existingState.pid && isProcessRunning(existingState.pid)) {
+                console.log(chalk.yellow(`Sync watcher already running (PID ${existingState.pid}).`));
+                console.log('Use "hq sync stop" to stop it first.');
+                return;
+            }
+            // Fork a background worker process
+            // The worker script path is relative to the compiled output
+            const thisFile = fileURLToPath(import.meta.url);
+            const workerScript = path.join(path.dirname(thisFile), '..', 'sync-worker.js');
+            const child = fork(workerScript, [hqRoot, String(intervalSec * 1000)], {
+                detached: true,
+                stdio: 'ignore',
+            });
+            if (!child.pid) {
+                throw new Error('Failed to start background sync process.');
+            }
+            // Allow the parent to exit without waiting for the child
+            child.unref();
+            // Record state
+            const state = {
+                running: true,
+                pid: child.pid,
+                lastSync: existingState.lastSync,
+                fileCount: existingState.fileCount,
+                errors: [],
+            };
+            writeSyncState(hqRoot, state);
+            console.log(chalk.green(`Sync watcher started (PID ${child.pid}, interval: ${intervalSec}s).`));
+            console.log('Use "hq sync status" to check, "hq sync stop" to halt.');
+        }
+        catch (error) {
+            console.error(chalk.red('Start failed:'), error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    // ── hq sync stop ───────────────────────────────────────────────────────
+    program
+        .command('stop')
+        .description('Stop the background sync watcher')
+        .action(async () => {
+        try {
+            const hqRoot = findHqRoot();
+            const state = readSyncState(hqRoot);
+            if (!state.running || !state.pid) {
+                console.log(chalk.yellow('No sync watcher is running.'));
+                return;
+            }
+            if (isProcessRunning(state.pid)) {
+                try {
+                    process.kill(state.pid, 'SIGTERM');
+                    console.log(chalk.green(`Sync watcher stopped (PID ${state.pid}).`));
+                }
+                catch {
+                    console.log(chalk.yellow(`Could not stop process ${state.pid} — it may have already exited.`));
+                }
+            }
+            else {
+                console.log(chalk.dim(`Sync watcher process ${state.pid} is no longer running. Cleaning up state.`));
+            }
+            // Update state
+            state.running = false;
+            state.pid = undefined;
+            writeSyncState(hqRoot, state);
+        }
+        catch (error) {
+            console.error(chalk.red('Stop failed:'), error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    // ── hq sync status ─────────────────────────────────────────────────────
+    program
+        .command('status')
+        .description('Show sync state, last sync time, and file counts')
+        .action(async () => {
+        try {
+            const hqRoot = findHqRoot();
+            const state = readSyncState(hqRoot);
+            // Check if the recorded PID is actually alive
+            const actuallyRunning = state.running && state.pid
+                ? isProcessRunning(state.pid)
+                : false;
+            if (state.running && !actuallyRunning) {
+                // Stale state — clean it up
+                state.running = false;
+                state.pid = undefined;
+                writeSyncState(hqRoot, state);
+            }
+            console.log(chalk.bold('HQ Cloud Sync Status'));
+            console.log();
+            console.log(`  Watcher:    ${actuallyRunning ? chalk.green('running') + ` (PID ${state.pid})` : chalk.dim('stopped')}`);
+            console.log(`  Last sync:  ${state.lastSync ? state.lastSync : chalk.dim('never')}`);
+            console.log(`  Files:      ${state.fileCount != null ? `${state.fileCount} tracked` : chalk.dim('unknown')}`);
+            console.log(`  HQ root:    ${hqRoot}`);
+            if (state.errors.length > 0) {
+                console.log(`  Errors:     ${chalk.yellow(String(state.errors.length))}`);
+                for (const err of state.errors.slice(0, 5)) {
+                    console.log(chalk.red(`    - ${err}`));
+                }
+            }
+            // Try to fetch quota info (non-fatal if it fails)
+            try {
+                requireAuth();
+                const quota = await getQuota();
+                console.log();
+                console.log(chalk.bold('  Storage Quota'));
+                const usedMB = (quota.used / (1024 * 1024)).toFixed(1);
+                const limitMB = (quota.limit / (1024 * 1024)).toFixed(1);
+                const pctColor = quota.percentage > 90 ? chalk.red : quota.percentage > 70 ? chalk.yellow : chalk.green;
+                console.log(`    Used:     ${usedMB} MB / ${limitMB} MB (${pctColor(quota.percentage + '%')})`);
+            }
+            catch {
+                // Quota info is optional — skip silently
+            }
+        }
+        catch (error) {
+            console.error(chalk.red('Status check failed:'), error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=cloud.js.map

package/dist/commands/cloud.js.map

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

package/dist/commands/initial-upload.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Initial HQ file upload for first-time cloud setup.
+ *
+ * After Clerk auth and Claude token setup, this command uploads the user's
+ * local HQ files to the cloud so the first session has access to the workspace.
+ *
+ * Respects the same ignore rules as sync (shouldIgnore from utils/sync.ts):
+ *   - .git/, node_modules/, .claude/, dist/, cdk.out/, etc.
+ *   - .log files, .env files, .DS_Store, Thumbs.db
+ *
+ * Exports `runInitialUpload` so it can be called programmatically from the
+ * create-hq installer (US-004) or other commands.
+ */
+/** Response shape from GET /api/files/list */
+export interface RemoteFileList {
+    files: string[];
+}
+/** Result returned by runInitialUpload */
+export interface InitialUploadResult {
+    /** Total local files discovered (after ignore filtering) */
+    totalFiles: number;
+    /** Number of files successfully uploaded */
+    uploaded: number;
+    /** Number of files that failed to upload */
+    failed: number;
+    /** Error messages for failed uploads */
+    errors: string[];
+    /** Whether the user chose to skip (remote had files and user declined) */
+    skipped: boolean;
+}
+/**
+ * Prompt the user with a yes/no question on stdin.
+ * Returns true for 'y'/'yes', false for 'n'/'no'.
+ * Defaults to defaultAnswer if user just presses Enter.
+ */
+export declare function promptYesNo(question: string, defaultAnswer?: boolean): Promise<boolean>;
+/**
+ * Prompt the user to choose between merge and replace.
+ * Returns 'merge' or 'replace'.
+ */
+export declare function promptMergeOrReplace(): Promise<'merge' | 'replace'>;
+/**
+ * Write a progress line that overwrites the previous line.
+ * Falls back to newline output if stdout is not a TTY (e.g., in tests or pipes).
+ */
+export declare function writeProgress(current: number, total: number): void;
+/**
+ * Run the initial HQ file upload.
+ *
+ * This is the core function that:
+ * 1. Lists remote files via GET /api/files/list
+ * 2. If remote has files, asks user to merge or replace
+ * 3. Walks local files (respecting ignore rules)
+ * 4. Uploads all files with progress indicator
+ * 5. Updates sync state
+ *
+ * @param hqRoot - Absolute path to the HQ root directory
+ * @param options - Optional overrides (for testing / programmatic use)
+ * @returns Upload result with counts and any errors
+ */
+export declare function runInitialUpload(hqRoot: string, options?: {
+    /** Override the merge/replace prompt (for non-interactive use) */
+    onConflict?: 'merge' | 'replace' | 'skip';
+    /** Suppress console output */
+    quiet?: boolean;
+}): Promise<InitialUploadResult>;
+//# sourceMappingURL=initial-upload.d.ts.map

package/dist/commands/initial-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initial-upload.d.ts","sourceRoot":"","sources":["../../src/commands/initial-upload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,0EAA0E;IAC1E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,aAAa,GAAE,OAAc,GAC5B,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAiBnE;AAYD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOlE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IACR,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAC1C,8BAA8B;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,OAAO,CAAC,mBAAmB,CAAC,CA0H9B"}