@waiaas/cli 2.0.0-rc.1

package/dist/commands/quickstart.js

@@ -0,0 +1,192 @@
+/**
+ * `waiaas quickstart` -- Create Solana + EVM wallets for quick setup.
+ *
+ * One-command multi-chain environment setup:
+ *   1. Check daemon is running (GET /health)
+ *   2. Resolve master password
+ *   3. Create Solana + EVM wallets with environment mode
+ *   4. Fetch available networks for each wallet
+ *   5. Create MCP sessions + write token files
+ *   6. Output wallet info + MCP config snippet
+ */
+import { writeFile, rename, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { resolvePassword } from '../utils/password.js';
+import { toSlug } from '../utils/slug.js';
+/** Create session for a wallet and write token file atomically. */
+async function createSessionAndWriteToken(opts) {
+    const sessionRes = await fetch(`${opts.baseUrl}/v1/sessions`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'X-Master-Password': opts.password,
+        },
+        body: JSON.stringify({
+            walletId: opts.walletId,
+            expiresIn: opts.expiresIn,
+        }),
+    });
+    if (!sessionRes.ok) {
+        const body = await sessionRes.json().catch(() => null);
+        const msg = body?.['message'] ?? sessionRes.statusText;
+        console.error(`Error: Failed to create session for wallet ${opts.walletId} (${sessionRes.status}): ${msg}`);
+        process.exit(1);
+    }
+    const sessionData = await sessionRes.json();
+    // Write token to mcp-tokens/<walletId> (atomic: write tmp then rename)
+    const tokenPath = join(opts.dataDir, 'mcp-tokens', opts.walletId);
+    const tmpPath = `${tokenPath}.tmp`;
+    await mkdir(dirname(tokenPath), { recursive: true });
+    await writeFile(tmpPath, sessionData.token, 'utf-8');
+    await rename(tmpPath, tokenPath);
+    return { token: sessionData.token, expiresAt: sessionData.expiresAt };
+}
+/** Build a single mcpServers config entry for a wallet. */
+function buildConfigEntry(opts) {
+    const env = {
+        WAIAAS_DATA_DIR: opts.dataDir,
+        WAIAAS_BASE_URL: opts.baseUrl,
+        WAIAAS_WALLET_ID: opts.walletId,
+    };
+    if (opts.walletName) {
+        env['WAIAAS_WALLET_NAME'] = opts.walletName;
+    }
+    return {
+        command: 'npx',
+        args: ['@waiaas/mcp'],
+        env,
+    };
+}
+/** Print platform-specific Claude Desktop config.json path. */
+function printConfigPath() {
+    const platform = process.platform;
+    if (platform === 'darwin') {
+        console.log('\nConfig location: ~/Library/Application Support/Claude/claude_desktop_config.json');
+    }
+    else if (platform === 'win32') {
+        console.log('\nConfig location: %APPDATA%\\Claude\\claude_desktop_config.json');
+    }
+    else {
+        console.log('\nConfig location: ~/.config/Claude/claude_desktop_config.json');
+    }
+}
+export async function quickstartCommand(opts) {
+    const baseUrl = (opts.baseUrl ?? 'http://127.0.0.1:3100').replace(/\/+$/, '');
+    const mode = opts.mode ?? 'testnet';
+    const expiresIn = opts.expiresIn ?? 86400;
+    // Validate mode
+    if (mode !== 'testnet' && mode !== 'mainnet') {
+        console.error("Error: --mode must be 'testnet' or 'mainnet'");
+        process.exit(1);
+    }
+    // Step 1: Check daemon is running
+    try {
+        const healthRes = await fetch(`${baseUrl}/health`, {
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!healthRes.ok) {
+            console.error(`Warning: daemon returned ${healthRes.status} on health check`);
+        }
+    }
+    catch {
+        console.error('Error: Cannot reach WAIaaS daemon.');
+        console.error(`  Tried: ${baseUrl}/health`);
+        console.error('  Make sure the daemon is running: waiaas start');
+        process.exit(1);
+    }
+    // Step 2: Resolve master password
+    const password = opts.masterPassword ?? await resolvePassword();
+    // Step 3: Create Solana + EVM wallets
+    const chains = [
+        { chain: 'solana', name: `solana-${mode}` },
+        { chain: 'ethereum', name: `evm-${mode}` },
+    ];
+    const createdWallets = [];
+    for (const { chain, name } of chains) {
+        const walletRes = await fetch(`${baseUrl}/v1/wallets`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-Master-Password': password,
+            },
+            body: JSON.stringify({ name, chain, environment: mode }),
+        });
+        if (!walletRes.ok) {
+            const body = await walletRes.json().catch(() => null);
+            const msg = body?.['message'] ?? walletRes.statusText;
+            console.error(`Error: Failed to create ${chain} wallet (HTTP ${walletRes.status}): ${msg}`);
+            process.exit(1);
+        }
+        const walletData = await walletRes.json();
+        // Fetch available networks (graceful degradation on failure)
+        let availableNetworks = [];
+        try {
+            const networksRes = await fetch(`${baseUrl}/v1/wallets/${walletData.id}/networks`, {
+                headers: {
+                    'Accept': 'application/json',
+                    'X-Master-Password': password,
+                },
+            });
+            if (networksRes.ok) {
+                const networksData = await networksRes.json();
+                availableNetworks = (networksData.networks ?? []).map((n) => n.network);
+            }
+        }
+        catch {
+            // Graceful degradation: continue with empty networks
+        }
+        createdWallets.push({
+            id: walletData.id,
+            name: walletData.name,
+            chain: walletData.chain,
+            environment: walletData.environment,
+            publicKey: walletData.publicKey,
+            defaultNetwork: walletData.defaultNetwork,
+            availableNetworks,
+        });
+    }
+    // Step 4: Create MCP sessions for each wallet
+    const mcpServers = {};
+    for (const wallet of createdWallets) {
+        await createSessionAndWriteToken({
+            baseUrl,
+            dataDir: opts.dataDir,
+            password,
+            walletId: wallet.id,
+            expiresIn,
+        });
+        const slug = toSlug(wallet.name);
+        mcpServers[`waiaas-${slug}`] = buildConfigEntry({
+            dataDir: opts.dataDir,
+            baseUrl,
+            walletId: wallet.id,
+            walletName: wallet.name,
+        });
+    }
+    // Step 5: Output results
+    console.log('WAIaaS Quickstart Complete!');
+    console.log('');
+    console.log(`Mode: ${mode}`);
+    for (const wallet of createdWallets) {
+        const chainLabel = wallet.chain === 'solana' ? 'Solana' : 'EVM';
+        console.log('');
+        console.log(`${chainLabel} Wallet:`);
+        console.log(`  Name: ${wallet.name}`);
+        console.log(`  Address: ${wallet.publicKey}`);
+        console.log(`  Environment: ${wallet.environment}`);
+        if (wallet.defaultNetwork) {
+            console.log(`  Default Network: ${wallet.defaultNetwork}`);
+        }
+        if (wallet.availableNetworks.length > 0) {
+            console.log(`  Available Networks: ${wallet.availableNetworks.join(', ')}`);
+        }
+    }
+    // Step 6: MCP config snippet
+    console.log('');
+    console.log('MCP Configuration:');
+    console.log('(claude_desktop_config.json에 추가하세요)');
+    const configSnippet = { mcpServers };
+    console.log(JSON.stringify(configSnippet, null, 2));
+    printConfigPath();
+}
+//# sourceMappingURL=quickstart.js.map

package/dist/commands/quickstart.js.map

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

package/dist/commands/start.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `waiaas start` -- Start the WAIaaS daemon.
+ *
+ * 1. Check if already running (PID file + process alive check)
+ * 2. Resolve master password
+ * 3. Call startDaemon() (in-process)
+ * 4. Process stays alive via signal handlers
+ */
+export declare function startCommand(dataDir: string): Promise<void>;
+//# sourceMappingURL=start.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CjE"}

package/dist/commands/start.js

@@ -0,0 +1,54 @@
+/**
+ * `waiaas start` -- Start the WAIaaS daemon.
+ *
+ * 1. Check if already running (PID file + process alive check)
+ * 2. Resolve master password
+ * 3. Call startDaemon() (in-process)
+ * 4. Process stays alive via signal handlers
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolvePassword } from '../utils/password.js';
+export async function startCommand(dataDir) {
+    const pidPath = join(dataDir, 'daemon.pid');
+    // Check if already running
+    if (existsSync(pidPath)) {
+        try {
+            const pid = parseInt(readFileSync(pidPath, 'utf-8').trim(), 10);
+            process.kill(pid, 0); // check if process is alive
+            console.error(`Daemon already running (PID: ${pid})`);
+            process.exit(1);
+            return; // Ensure no further execution after exit
+        }
+        catch (err) {
+            // ESRCH = process not found, stale PID file -- continue
+            if (err.code !== 'ESRCH') {
+                console.error(`Daemon already running (PID file exists: ${pidPath})`);
+                process.exit(1);
+                return; // Ensure no further execution after exit
+            }
+            // Stale PID file, continue with startup
+        }
+    }
+    // Resolve master password
+    let password;
+    try {
+        password = await resolvePassword();
+    }
+    catch (err) {
+        console.error(`Failed to resolve master password: ${err.message}`);
+        process.exit(1);
+        return; // Ensure no further execution after exit
+    }
+    // Start daemon (in-process)
+    try {
+        const { startDaemon } = await import('@waiaas/daemon');
+        await startDaemon(dataDir, password);
+        console.log(`WAIaaS daemon started on 127.0.0.1:3100 (PID: ${process.pid})`);
+    }
+    catch (err) {
+        console.error(`Failed to start daemon: ${err.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAE5C,2BAA2B;IAC3B,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAChE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,4BAA4B;YAClD,OAAO,CAAC,KAAK,CAAC,gCAAgC,GAAG,GAAG,CAAC,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO,CAAC,yCAAyC;QACnD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,wDAAwD;YACxD,IAAK,GAA6B,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACpD,OAAO,CAAC,KAAK,CAAC,4CAA4C,OAAO,GAAG,CAAC,CAAC;gBACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,OAAO,CAAC,yCAAyC;YACnD,CAAC;YACD,wCAAwC;QAC1C,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,eAAe,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,sCAAuC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO,CAAC,yCAAyC;IACnD,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC;QACH,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACvD,MAAM,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CACT,iDAAiD,OAAO,CAAC,GAAG,GAAG,CAChE,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,2BAA4B,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `waiaas status` -- Check the WAIaaS daemon status.
+ *
+ * Reports:
+ *   - running (PID + port) -- PID alive + health check OK
+ *   - starting (PID) -- PID alive but health check fails
+ *   - stopped -- no PID file or process not alive
+ */
+export declare function statusCommand(dataDir: string): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoClE"}

package/dist/commands/status.js

@@ -0,0 +1,80 @@
+/**
+ * `waiaas status` -- Check the WAIaaS daemon status.
+ *
+ * Reports:
+ *   - running (PID + port) -- PID alive + health check OK
+ *   - starting (PID) -- PID alive but health check fails
+ *   - stopped -- no PID file or process not alive
+ */
+import { existsSync, readFileSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+/** Default daemon port if config is unavailable. */
+const DEFAULT_PORT = 3100;
+export async function statusCommand(dataDir) {
+    const pidPath = join(dataDir, 'daemon.pid');
+    // No PID file
+    if (!existsSync(pidPath)) {
+        console.log('Status: stopped');
+        return;
+    }
+    const pid = parseInt(readFileSync(pidPath, 'utf-8').trim(), 10);
+    // Check if process alive
+    if (!isProcessAlive(pid)) {
+        console.log('Status: stopped (stale PID file)');
+        try {
+            unlinkSync(pidPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        return;
+    }
+    // Resolve port from config
+    const port = resolvePort(dataDir);
+    // Health check
+    try {
+        const res = await fetch(`http://127.0.0.1:${port}/health`);
+        if (res.ok) {
+            console.log(`Status: running (PID: ${pid}, Port: ${port})`);
+        }
+        else {
+            console.log(`Status: starting (PID: ${pid})`);
+        }
+    }
+    catch {
+        console.log(`Status: starting (PID: ${pid})`);
+    }
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Try to read the port from config.toml. Falls back to DEFAULT_PORT.
+ * We do a simple TOML parse to avoid importing the full config loader
+ * (which pulls in many daemon dependencies).
+ */
+function resolvePort(dataDir) {
+    try {
+        const configPath = join(dataDir, 'config.toml');
+        if (!existsSync(configPath))
+            return DEFAULT_PORT;
+        const content = readFileSync(configPath, 'utf-8');
+        const match = /^\s*port\s*=\s*(\d+)/m.exec(content);
+        if (match?.[1]) {
+            const port = parseInt(match[1], 10);
+            if (port > 0 && port <= 65535)
+                return port;
+        }
+    }
+    catch {
+        // Ignore config read errors
+    }
+    return DEFAULT_PORT;
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,oDAAoD;AACpD,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAE5C,cAAc;IACd,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAEhE,yBAAyB;IACzB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,UAAU,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;QACD,OAAO;IACT,CAAC;IAED,2BAA2B;IAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAElC,eAAe;IACf,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,SAAS,CAAC,CAAC;QAC3D,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,WAAW,IAAI,GAAG,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,GAAG,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,GAAG,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,OAAe;IAClC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,YAAY,CAAC;QAEjD,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,KAAK;gBAAE,OAAO,IAAI,CAAC;QAC7C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,4BAA4B;IAC9B,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/commands/stop.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `waiaas stop` -- Stop the WAIaaS daemon.
+ *
+ * 1. Read PID file
+ * 2. Check if process alive
+ * 3. Send SIGTERM
+ * 4. Poll until process exits (or SIGKILL after timeout)
+ */
+export declare function stopCommand(dataDir: string): Promise<void>;
+//# sourceMappingURL=stop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4ChE"}

package/dist/commands/stop.js

@@ -0,0 +1,68 @@
+/**
+ * `waiaas stop` -- Stop the WAIaaS daemon.
+ *
+ * 1. Read PID file
+ * 2. Check if process alive
+ * 3. Send SIGTERM
+ * 4. Poll until process exits (or SIGKILL after timeout)
+ */
+import { existsSync, readFileSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+/** Maximum time to wait for graceful shutdown (ms). */
+const STOP_TIMEOUT = 10_000;
+/** Interval between alive checks (ms). */
+const POLL_INTERVAL = 500;
+export async function stopCommand(dataDir) {
+    const pidPath = join(dataDir, 'daemon.pid');
+    // Check PID file
+    if (!existsSync(pidPath)) {
+        console.log('Daemon is not running');
+        return;
+    }
+    const pid = parseInt(readFileSync(pidPath, 'utf-8').trim(), 10);
+    // Check if process is alive
+    if (!isProcessAlive(pid)) {
+        console.log('Daemon is not running (stale PID file)');
+        try {
+            unlinkSync(pidPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        return;
+    }
+    // Send SIGTERM
+    console.log(`Stopping daemon (PID: ${pid})...`);
+    process.kill(pid, 'SIGTERM');
+    // Poll for process exit
+    const started = Date.now();
+    while (Date.now() - started < STOP_TIMEOUT) {
+        await sleep(POLL_INTERVAL);
+        if (!isProcessAlive(pid)) {
+            console.log('Daemon stopped');
+            return;
+        }
+    }
+    // Timeout -- send SIGKILL
+    console.log('Daemon did not stop within 10s, sending SIGKILL');
+    try {
+        process.kill(pid, 'SIGKILL');
+    }
+    catch {
+        // Process may have exited between check and kill
+    }
+    console.log('Daemon killed');
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=stop.js.map

package/dist/commands/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,uDAAuD;AACvD,MAAM,YAAY,GAAG,MAAM,CAAC;AAC5B,0CAA0C;AAC1C,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAe;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAE5C,iBAAiB;IACjB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAEhE,4BAA4B;IAC5B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,UAAU,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;QACD,OAAO;IACT,CAAC;IAED,eAAe;IACf,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,MAAM,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAE7B,wBAAwB;IACxB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,YAAY,EAAE,CAAC;QAC3C,MAAM,KAAK,CAAC,aAAa,CAAC,CAAC;QAC3B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAC9B,OAAO;QACT,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;IAC/D,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `waiaas upgrade` -- Upgrade WAIaaS to the latest version.
+ *
+ * Supports four modes:
+ *   --check     Check for available updates without upgrading
+ *   --rollback  Restore from the latest pre-upgrade backup
+ *   --to <ver>  Upgrade to a specific version
+ *   (default)   7-step upgrade sequence:
+ *     1. Version check
+ *     2. Stop daemon
+ *     3. Create backup
+ *     4. Update package
+ *     5. Database migrations (deferred to daemon start)
+ *     6. Verify installation
+ *     7. Restart daemon
+ */
+export interface UpgradeOptions {
+    dataDir: string;
+    check?: boolean;
+    to?: string;
+    rollback?: boolean;
+    noStart?: boolean;
+}
+/**
+ * Execute the upgrade command based on the provided options.
+ */
+export declare function upgradeCommand(opts: UpgradeOptions): Promise<void>;
+//# sourceMappingURL=upgrade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAeH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAUxE"}