@indigoai-us/hq-cli 5.1.0

package/dist/__tests__/credentials.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for credential storage (utils/credentials.ts)
+ */
+export {};
+//# sourceMappingURL=credentials.test.d.ts.map

package/dist/__tests__/credentials.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/credentials.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/__tests__/credentials.test.js

@@ -0,0 +1,169 @@
+/**
+ * Tests for credential storage (utils/credentials.ts)
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { readCredentials, writeCredentials, clearCredentials, getCredentialsPath, isExpired, _setConfigHome, } from '../utils/credentials.js';
+let tmpDir;
+beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'hq-cli-test-'));
+    _setConfigHome(tmpDir);
+});
+afterEach(() => {
+    _setConfigHome(null);
+    try {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    }
+    catch {
+        // Ignore cleanup errors
+    }
+});
+describe('getCredentialsPath', () => {
+    it('returns a path under .hq/ in the config home', () => {
+        const p = getCredentialsPath();
+        expect(p).toContain('.hq');
+        expect(p).toContain('credentials.json');
+        expect(p.startsWith(tmpDir)).toBe(true);
+    });
+});
+describe('readCredentials', () => {
+    it('returns null when no credentials file exists', () => {
+        const creds = readCredentials();
+        expect(creds).toBeNull();
+    });
+    it('returns null when credentials file is empty', () => {
+        const hqDir = path.join(tmpDir, '.hq');
+        fs.mkdirSync(hqDir, { recursive: true });
+        fs.writeFileSync(path.join(hqDir, 'credentials.json'), '');
+        const creds = readCredentials();
+        expect(creds).toBeNull();
+    });
+    it('returns null when credentials file contains invalid JSON', () => {
+        const hqDir = path.join(tmpDir, '.hq');
+        fs.mkdirSync(hqDir, { recursive: true });
+        fs.writeFileSync(path.join(hqDir, 'credentials.json'), 'not json');
+        const creds = readCredentials();
+        expect(creds).toBeNull();
+    });
+    it('returns null when credentials are missing required fields', () => {
+        const hqDir = path.join(tmpDir, '.hq');
+        fs.mkdirSync(hqDir, { recursive: true });
+        fs.writeFileSync(path.join(hqDir, 'credentials.json'), JSON.stringify({ token: 'abc' }) // missing userId
+        );
+        const creds = readCredentials();
+        expect(creds).toBeNull();
+    });
+    it('returns valid credentials when file is well-formed', () => {
+        const hqDir = path.join(tmpDir, '.hq');
+        fs.mkdirSync(hqDir, { recursive: true });
+        const stored = {
+            token: 'test-jwt-token',
+            userId: 'user_123',
+            email: 'test@example.com',
+            storedAt: new Date().toISOString(),
+        };
+        fs.writeFileSync(path.join(hqDir, 'credentials.json'), JSON.stringify(stored));
+        const creds = readCredentials();
+        expect(creds).not.toBeNull();
+        expect(creds.token).toBe('test-jwt-token');
+        expect(creds.userId).toBe('user_123');
+        expect(creds.email).toBe('test@example.com');
+    });
+});
+describe('writeCredentials', () => {
+    it('creates .hq directory and writes credentials file', () => {
+        const creds = {
+            token: 'test-token',
+            userId: 'user_456',
+            email: 'user@test.com',
+            storedAt: new Date().toISOString(),
+        };
+        writeCredentials(creds);
+        const hqDir = path.join(tmpDir, '.hq');
+        expect(fs.existsSync(hqDir)).toBe(true);
+        expect(fs.existsSync(path.join(hqDir, 'credentials.json'))).toBe(true);
+        const raw = fs.readFileSync(path.join(hqDir, 'credentials.json'), 'utf-8');
+        const parsed = JSON.parse(raw);
+        expect(parsed.token).toBe('test-token');
+        expect(parsed.userId).toBe('user_456');
+    });
+    it('overwrites existing credentials', () => {
+        const creds1 = {
+            token: 'token-1',
+            userId: 'user_1',
+            storedAt: new Date().toISOString(),
+        };
+        writeCredentials(creds1);
+        const creds2 = {
+            token: 'token-2',
+            userId: 'user_2',
+            storedAt: new Date().toISOString(),
+        };
+        writeCredentials(creds2);
+        const read = readCredentials();
+        expect(read.token).toBe('token-2');
+        expect(read.userId).toBe('user_2');
+    });
+});
+describe('clearCredentials', () => {
+    it('returns false when no credentials exist', () => {
+        const result = clearCredentials();
+        expect(result).toBe(false);
+    });
+    it('removes credentials file and returns true', () => {
+        writeCredentials({
+            token: 'test',
+            userId: 'user',
+            storedAt: new Date().toISOString(),
+        });
+        expect(readCredentials()).not.toBeNull();
+        const result = clearCredentials();
+        expect(result).toBe(true);
+        expect(readCredentials()).toBeNull();
+    });
+});
+describe('isExpired', () => {
+    it('returns false when no expiresAt is set', () => {
+        const creds = {
+            token: 'test',
+            userId: 'user',
+            storedAt: new Date().toISOString(),
+        };
+        expect(isExpired(creds)).toBe(false);
+    });
+    it('returns true when expiresAt is in the past', () => {
+        const creds = {
+            token: 'test',
+            userId: 'user',
+            storedAt: new Date().toISOString(),
+            expiresAt: new Date(Date.now() - 60_000).toISOString(),
+        };
+        expect(isExpired(creds)).toBe(true);
+    });
+    it('returns false when expiresAt is in the future', () => {
+        const creds = {
+            token: 'test',
+            userId: 'user',
+            storedAt: new Date().toISOString(),
+            expiresAt: new Date(Date.now() + 3_600_000).toISOString(),
+        };
+        expect(isExpired(creds)).toBe(false);
+    });
+});
+describe('roundtrip', () => {
+    it('write then read returns identical data', () => {
+        const original = {
+            token: 'jwt-abc-123',
+            userId: 'user_roundtrip',
+            email: 'roundtrip@test.com',
+            storedAt: '2026-01-15T10:00:00.000Z',
+            expiresAt: '2026-01-15T11:00:00.000Z',
+        };
+        writeCredentials(original);
+        const read = readCredentials();
+        expect(read).toEqual(original);
+    });
+});
+//# sourceMappingURL=credentials.test.js.map

package/dist/__tests__/credentials.test.js.map

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

package/dist/commands/add.d.ts

@@ -0,0 +1,6 @@
+/**
+ * hq modules add command (US-003)
+ */
+import { Command } from 'commander';
+export declare function registerAddCommand(program: Command): void;
+//# sourceMappingURL=add.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiEzD"}

package/dist/commands/add.js

@@ -0,0 +1,60 @@
+/**
+ * hq modules add command (US-003)
+ */
+import { findHqRoot, addModule, parseRepoName, isValidRepoUrl } from '../utils/manifest.js';
+export function registerAddCommand(program) {
+    program
+        .command('add <repo-url>')
+        .description('Add a module to the manifest')
+        .option('--as <name>', 'Module name (defaults to repo name)')
+        .option('--branch <branch>', 'Git branch to track', 'main')
+        .option('--strategy <strategy>', 'Sync strategy: link | merge | copy', 'link')
+        .option('--path <mapping>', 'Path mapping src:dest (can repeat)', (val, prev) => [...prev, val], [])
+        .action(async (repoUrl, options) => {
+        try {
+            // Validate repo URL
+            if (!isValidRepoUrl(repoUrl)) {
+                console.error('Error: Invalid repo URL. Must start with https:// or git@');
+                process.exit(1);
+            }
+            // Parse name
+            const name = options.as || parseRepoName(repoUrl);
+            // Validate strategy
+            const validStrategies = ['link', 'merge', 'copy'];
+            if (!validStrategies.includes(options.strategy)) {
+                console.error(`Error: Invalid strategy "${options.strategy}". Use: ${validStrategies.join(', ')}`);
+                process.exit(1);
+            }
+            // Parse path mappings
+            const paths = options.path.length > 0
+                ? options.path.map(p => {
+                    const [src, dest] = p.split(':');
+                    if (!src || !dest) {
+                        throw new Error(`Invalid path mapping: ${p}. Format: src:dest`);
+                    }
+                    return { src, dest };
+                })
+                : [{ src: '.', dest: `workers/${name}` }]; // Default: entire repo to workers/
+            const module = {
+                name,
+                repo: repoUrl,
+                branch: options.branch,
+                strategy: options.strategy,
+                paths,
+            };
+            const hqRoot = findHqRoot();
+            addModule(hqRoot, module);
+            console.log(`Added module "${name}"`);
+            console.log(`  Repo: ${repoUrl}`);
+            console.log(`  Branch: ${options.branch}`);
+            console.log(`  Strategy: ${options.strategy}`);
+            console.log(`  Paths: ${paths.map(p => `${p.src} -> ${p.dest}`).join(', ')}`);
+            console.log('\nRun "hq modules sync" to fetch and sync the module.');
+        }
+        catch (error) {
+            console.error('Error:', error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG5F,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,8BAA8B,CAAC;SAC3C,MAAM,CAAC,aAAa,EAAE,qCAAqC,CAAC;SAC5D,MAAM,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,CAAC;SAC1D,MAAM,CAAC,uBAAuB,EAAE,oCAAoC,EAAE,MAAM,CAAC;SAC7E,MAAM,CAAC,kBAAkB,EAAE,oCAAoC,EAAE,CAAC,GAAG,EAAE,IAAc,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;SAC7G,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,OAK/B,EAAE,EAAE;QACH,IAAI,CAAC;YACH,oBAAoB;YACpB,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;gBAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,aAAa;YACb,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;YAElD,oBAAoB;YACpB,MAAM,eAAe,GAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAClE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAwB,CAAC,EAAE,CAAC;gBAChE,OAAO,CAAC,KAAK,CAAC,4BAA4B,OAAO,CAAC,QAAQ,WAAW,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACnG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,sBAAsB;YACtB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;gBACnC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;oBACnB,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBACjC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;wBAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,oBAAoB,CAAC,CAAC;oBAClE,CAAC;oBACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;gBACvB,CAAC,CAAC;gBACJ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,mCAAmC;YAEhF,MAAM,MAAM,GAAqB;gBAC/B,IAAI;gBACJ,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,OAAO,CAAC,QAAwB;gBAC1C,KAAK;aACN,CAAC;YAEF,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;YAC5B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAE1B,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,GAAG,CAAC,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9E,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;QAEvE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/auth.d.ts

@@ -0,0 +1,17 @@
+/**
+ * hq auth commands — login, logout, status
+ *
+ * Login flow:
+ * 1. CLI generates a unique device code
+ * 2. CLI starts a temporary localhost HTTP server to receive the callback
+ * 3. CLI opens the user's browser to the hq-cloud API auth page with the device code + callback port
+ * 4. User signs in with Clerk in the browser
+ * 5. After sign-in, the API redirects to the localhost callback with the token
+ * 6. CLI captures the token, stores it, and shuts down the server
+ */
+import { Command } from 'commander';
+/**
+ * Register the "hq auth" command group with login, logout, and status subcommands.
+ */
+export declare function registerAuthCommand(program: Command): void;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0KpC;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqH1D"}

package/dist/commands/auth.js

@@ -0,0 +1,269 @@
+/**
+ * hq auth commands — login, logout, status
+ *
+ * Login flow:
+ * 1. CLI generates a unique device code
+ * 2. CLI starts a temporary localhost HTTP server to receive the callback
+ * 3. CLI opens the user's browser to the hq-cloud API auth page with the device code + callback port
+ * 4. User signs in with Clerk in the browser
+ * 5. After sign-in, the API redirects to the localhost callback with the token
+ * 6. CLI captures the token, stores it, and shuts down the server
+ */
+import * as http from 'http';
+import * as crypto from 'crypto';
+import chalk from 'chalk';
+import { readCredentials, writeCredentials, clearCredentials, getCredentialsPath, isExpired, } from '../utils/credentials.js';
+import { getApiUrl, apiRequest } from '../utils/api-client.js';
+/** Port range for the localhost callback server */
+const MIN_PORT = 19750;
+const MAX_PORT = 19850;
+/** Timeout for waiting for the browser callback (ms) */
+const LOGIN_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Open a URL in the user's default browser.
+ * Works on macOS, Linux, and Windows.
+ */
+async function openBrowser(url) {
+    const { exec } = await import('child_process');
+    const { promisify } = await import('util');
+    const execAsync = promisify(exec);
+    const platform = process.platform;
+    let command;
+    if (platform === 'darwin') {
+        command = `open "${url}"`;
+    }
+    else if (platform === 'win32') {
+        command = `start "" "${url}"`;
+    }
+    else {
+        // Linux — try xdg-open, then sensible-browser
+        command = `xdg-open "${url}" 2>/dev/null || sensible-browser "${url}" 2>/dev/null || echo "OPEN_FAILED"`;
+    }
+    try {
+        await execAsync(command);
+    }
+    catch {
+        // Browser open failed silently — user will be shown the URL to open manually
+    }
+}
+/**
+ * Find an available port in the callback port range.
+ */
+function findAvailablePort() {
+    return new Promise((resolve, reject) => {
+        const port = MIN_PORT + Math.floor(Math.random() * (MAX_PORT - MIN_PORT));
+        const server = http.createServer();
+        server.listen(port, '127.0.0.1', () => {
+            server.close(() => resolve(port));
+        });
+        server.on('error', () => {
+            // Try another port
+            const fallback = MIN_PORT + Math.floor(Math.random() * (MAX_PORT - MIN_PORT));
+            const server2 = http.createServer();
+            server2.listen(fallback, '127.0.0.1', () => {
+                server2.close(() => resolve(fallback));
+            });
+            server2.on('error', () => {
+                reject(new Error('Could not find an available port for auth callback'));
+            });
+        });
+    });
+}
+/**
+ * HTML page shown to the user after successful login.
+ */
+function successHtml() {
+    return `<!DOCTYPE html>
+<html>
+<head><title>HQ CLI — Logged In</title></head>
+<body style="font-family: system-ui, sans-serif; display: flex; align-items: center; justify-content: center; height: 100vh; margin: 0; background: #f8f9fa;">
+  <div style="text-align: center; max-width: 400px;">
+    <h1 style="color: #16a34a;">Logged In</h1>
+    <p style="color: #4b5563;">You have been authenticated. You can close this tab and return to the terminal.</p>
+  </div>
+</body>
+</html>`;
+}
+/**
+ * HTML page shown on error.
+ */
+function errorHtml(message) {
+    return `<!DOCTYPE html>
+<html>
+<head><title>HQ CLI — Auth Error</title></head>
+<body style="font-family: system-ui, sans-serif; display: flex; align-items: center; justify-content: center; height: 100vh; margin: 0; background: #f8f9fa;">
+  <div style="text-align: center; max-width: 400px;">
+    <h1 style="color: #dc2626;">Authentication Error</h1>
+    <p style="color: #4b5563;">${message}</p>
+    <p style="color: #6b7280;">Please return to the terminal and try again.</p>
+  </div>
+</body>
+</html>`;
+}
+/**
+ * Start a temporary localhost server and wait for the auth callback.
+ * Returns the received token and user info.
+ */
+function waitForCallback(port) {
+    return new Promise((resolve, reject) => {
+        const server = http.createServer((req, res) => {
+            const url = new URL(req.url ?? '/', `http://127.0.0.1:${port}`);
+            if (url.pathname === '/callback') {
+                const token = url.searchParams.get('token');
+                const userId = url.searchParams.get('user_id');
+                const email = url.searchParams.get('email') ?? undefined;
+                const expiresAt = url.searchParams.get('expires_at') ?? undefined;
+                const error = url.searchParams.get('error');
+                if (error) {
+                    res.writeHead(200, { 'Content-Type': 'text/html' });
+                    res.end(errorHtml(error));
+                    server.close();
+                    reject(new Error(error));
+                    return;
+                }
+                if (!token || !userId) {
+                    res.writeHead(200, { 'Content-Type': 'text/html' });
+                    res.end(errorHtml('Missing token or user ID in callback'));
+                    server.close();
+                    reject(new Error('Invalid callback: missing token or user_id'));
+                    return;
+                }
+                res.writeHead(200, { 'Content-Type': 'text/html' });
+                res.end(successHtml());
+                // Close the server after sending the response
+                server.close();
+                resolve({ token, userId, email, expiresAt });
+            }
+            else {
+                res.writeHead(404, { 'Content-Type': 'text/plain' });
+                res.end('Not Found');
+            }
+        });
+        server.listen(port, '127.0.0.1', () => {
+            // Server is ready
+        });
+        // Timeout
+        const timeout = setTimeout(() => {
+            server.close();
+            reject(new Error('Login timed out. Please try again.'));
+        }, LOGIN_TIMEOUT_MS);
+        server.on('close', () => {
+            clearTimeout(timeout);
+        });
+        server.on('error', (err) => {
+            clearTimeout(timeout);
+            reject(err);
+        });
+    });
+}
+/**
+ * Register the "hq auth" command group with login, logout, and status subcommands.
+ */
+export function registerAuthCommand(program) {
+    const authCmd = program
+        .command('auth')
+        .description('Authenticate with HQ Cloud');
+    // --- hq auth login ---
+    authCmd
+        .command('login')
+        .description('Log in to HQ Cloud via browser')
+        .action(async () => {
+        try {
+            // Check if already logged in
+            const existing = readCredentials();
+            if (existing && !isExpired(existing)) {
+                const label = existing.email ?? existing.userId;
+                console.log(chalk.yellow(`Already logged in as ${label}.`));
+                console.log('Run "hq auth logout" first to switch accounts.');
+                return;
+            }
+            // Generate a device code for the login session
+            const deviceCode = crypto.randomBytes(16).toString('hex');
+            // Find an available port for the callback
+            const port = await findAvailablePort();
+            const callbackUrl = `http://127.0.0.1:${port}/callback`;
+            // Build the login URL
+            const apiUrl = getApiUrl();
+            const loginUrl = `${apiUrl}/auth/cli-login?device_code=${deviceCode}&callback_url=${encodeURIComponent(callbackUrl)}`;
+            console.log(chalk.blue('Opening browser for authentication...'));
+            console.log();
+            console.log(`If the browser does not open, visit this URL:`);
+            console.log(chalk.underline(loginUrl));
+            console.log();
+            console.log(chalk.dim('Waiting for authentication (timeout: 5 minutes)...'));
+            // Open browser
+            await openBrowser(loginUrl);
+            // Wait for callback
+            const result = await waitForCallback(port);
+            // Store credentials
+            writeCredentials({
+                token: result.token,
+                userId: result.userId,
+                email: result.email,
+                storedAt: new Date().toISOString(),
+                expiresAt: result.expiresAt,
+            });
+            const label = result.email ?? result.userId;
+            console.log();
+            console.log(chalk.green(`Logged in as ${label}`));
+            console.log(chalk.dim(`Credentials saved to ${getCredentialsPath()}`));
+        }
+        catch (error) {
+            console.error(chalk.red('Login failed:'), error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+    // --- hq auth logout ---
+    authCmd
+        .command('logout')
+        .description('Log out and clear stored credentials')
+        .action(() => {
+        const removed = clearCredentials();
+        if (removed) {
+            console.log(chalk.green('Logged out. Credentials cleared.'));
+        }
+        else {
+            console.log(chalk.yellow('Not logged in.'));
+        }
+    });
+    // --- hq auth status ---
+    authCmd
+        .command('status')
+        .description('Show current authentication status')
+        .action(async () => {
+        const creds = readCredentials();
+        if (!creds) {
+            console.log(chalk.yellow('Not logged in.'));
+            console.log('Run "hq auth login" to authenticate.');
+            return;
+        }
+        if (isExpired(creds)) {
+            console.log(chalk.red('Session expired.'));
+            console.log('Run "hq auth login" to re-authenticate.');
+            return;
+        }
+        const label = creds.email ?? creds.userId;
+        console.log(chalk.green(`Logged in as ${label}`));
+        console.log(`  User ID:    ${creds.userId}`);
+        console.log(`  Stored at:  ${creds.storedAt}`);
+        if (creds.expiresAt) {
+            console.log(`  Expires at: ${creds.expiresAt}`);
+        }
+        console.log(`  API URL:    ${getApiUrl()}`);
+        console.log(`  Creds file: ${getCredentialsPath()}`);
+        // Optionally verify with the API
+        try {
+            const resp = await apiRequest('GET', '/auth/me');
+            if (resp.ok && resp.data) {
+                console.log(chalk.dim(`  Verified:   API confirms session is valid`));
+            }
+            else {
+                console.log(chalk.yellow(`  Warning:    API returned ${resp.status} — token may be invalid`));
+            }
+        }
+        catch {
+            console.log(chalk.dim(`  Note:       Could not reach API to verify token`));
+        }
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

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

package/dist/commands/cloud-setup.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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 { Command } from 'commander';
+/**
+ * Validate a Claude OAuth token string.
+ * Returns null if valid, or an error message string if invalid.
+ */
+export declare function validateClaudeToken(token: string): string | null;
+/**
+ * Register the "hq cloud" command group with setup-token and status subcommands.
+ */
+export declare function registerCloudSetupCommand(program: Command): void;
+//# sourceMappingURL=cloud-setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-setup.d.ts","sourceRoot":"","sources":["../../src/commands/cloud-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBhE;AAoBD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuLhE"}