kadi-deploy 0.19.0

package/src/commands/down.ts

@@ -0,0 +1,679 @@
+/**
+ * Deploy Down Command — Tear down active deployments
+ *
+ * Reads the `.kadi-deploy.lock` file written after a successful deployment
+ * and tears down the running containers:
+ *
+ * - **Local**: Runs `${engine} compose -f ${composePath} down --remove-orphans`
+ * - **Akash**: Connects wallet → calls `AkashClient.closeDeployment(dseq)`
+ *
+ * Supports both interactive (QR wallet) and autonomous (vault mnemonic) modes
+ * for Akash teardown.
+ *
+ * @module commands/down
+ */
+
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+
+import {
+  AkashClient,
+  connectWallet,
+  disconnectWallet,
+  createWalletFromMnemonic,
+  type SecretsProvider,
+} from '@kadi.build/deploy-ability/akash';
+
+import { readLockFile, removeDeployment, listDeployments, getDeploymentByInstance, getDeploymentsByProfile, parseDeploymentKey, type DeploymentLock, type LockFile } from './lock.js';
+import { readSecretFromCli } from '../secrets/index.js';
+import { startSpinner, succeedSpinner, failSpinner } from '../cli/spinners.js';
+import { confirmPrompt, selectPrompt } from '../cli/prompts.js';
+import {
+  error as errorColor,
+  warning,
+  success as successColor,
+  dim,
+  bold,
+  highlight,
+  formatKeyValue,
+} from '../cli/colors.js';
+import type { IKadiContext } from '../types.js';
+
+// Polyfill localStorage for WalletConnect (same as deploy.ts)
+import { LocalStorage } from 'node-localstorage';
+import os from 'node:os';
+const kadiHome = path.join(os.homedir(), '.kadi');
+(globalThis as any).localStorage ??= new LocalStorage(kadiHome);
+
+import QRCode from 'qrcode-terminal';
+
+// ─────────────────────────────────────────────────────────
+// Types
+// ─────────────────────────────────────────────────────────
+
+export interface DownOptions {
+  project?: string;
+  profile?: string;
+  instance?: string;
+  all?: boolean;
+  engine?: string;
+  yes?: boolean;
+  verbose?: boolean;
+  autonomous?: boolean;
+  secretsVault?: string;
+  network?: string;
+}
+
+// ─────────────────────────────────────────────────────────
+// Main entry point
+// ─────────────────────────────────────────────────────────
+
+/**
+ * Execute the `kadi deploy down` command.
+ *
+ * Reads the lock file, confirms with the user, then tears down the deployment.
+ */
+export async function executeDown(
+  ctx: IKadiContext,
+  options: DownOptions
+): Promise<void> {
+  const { logger } = ctx;
+  const projectRoot = path.resolve(options.project || process.cwd());
+
+  // ----------------------------------------------------------------
+  // 1. Read lock file and resolve deployment
+  // ----------------------------------------------------------------
+  let lockFile: LockFile | null;
+
+  try {
+    lockFile = await readLockFile(projectRoot);
+  } catch (err) {
+    logger.error(
+      errorColor(`Failed to read lock file: ${(err as Error).message}`)
+    );
+    return;
+  }
+
+  if (!lockFile || Object.keys(lockFile.deployments).length === 0) {
+    logger.error(
+      errorColor('No active deployment found.')
+    );
+    logger.log(
+      dim(
+        'The .kadi-deploy.lock file was not found in ' + projectRoot + '.\n' +
+        'This file is created after a successful deployment with `kadi deploy`.'
+      )
+    );
+    return;
+  }
+
+  // Resolve which deployment to tear down
+  const entries = Object.entries(lockFile.deployments);
+  let lock: DeploymentLock;
+
+  if (options.instance) {
+    // Explicit --instance flag: direct lookup by instanceId
+    const entry = Object.values(lockFile.deployments)
+      .find((d) => d.instanceId === options.instance);
+    if (!entry) {
+      logger.error(
+        errorColor(`No active deployment found with instance ID "${options.instance}".`)
+      );
+      logger.log(
+        dim('Active instances: ' + entries.map(([k, d]) => `${d.instanceId} (${d.profile}, ${d.target})`).join(', '))
+      );
+      return;
+    }
+    lock = entry;
+  } else if (options.all) {
+    // --all flag: tear down everything (handled separately below)
+    if (!options.yes && !options.autonomous) {
+      logger.log('');
+      logger.log(bold(`About to tear down ALL ${entries.length} deployment(s):`));
+      logger.log('');
+      for (const [key, dep] of entries) {
+        const labelInfo = dep.label ? `, ${dep.label}` : '';
+        logger.log(`  ${highlight(dep.instanceId)}  ${dim(`(${dep.profile}, ${dep.target}${labelInfo}, deployed ${dep.deployedAt})`)}`);
+      }
+      logger.log('');
+
+      const proceed = await confirmPrompt(
+        `Tear down all ${entries.length} deployment(s)?`,
+        false
+      );
+
+      if (!proceed) {
+        logger.log('Cancelled.');
+        return;
+      }
+    }
+
+    // Tear down all deployments sequentially
+    for (const [key, dep] of entries) {
+      logger.log('');
+      logger.log(bold(`Tearing down: ${dep.profile}:${dep.instanceId} (${dep.target})`));
+      if (dep.target === 'local') {
+        await teardownLocal(ctx, projectRoot, dep, options);
+      } else if (dep.target === 'akash') {
+        await teardownAkash(ctx, projectRoot, dep, options);
+      }
+    }
+    return;
+  } else if (options.profile) {
+    // Explicit --profile flag: find matching instances
+    const profileInstances = entries.filter(([_, d]) => d.profile === options.profile);
+    if (profileInstances.length === 0) {
+      logger.error(
+        errorColor(`No active deployment found for profile "${options.profile}".`)
+      );
+      logger.log(
+        dim('Active deployments: ' + entries.map(([k, d]) => `${d.profile}:${d.instanceId}`).join(', '))
+      );
+      return;
+    } else if (profileInstances.length === 1) {
+      lock = profileInstances[0][1];
+    } else if (options.autonomous) {
+      logger.error(
+        errorColor(
+          `Multiple instances of profile "${options.profile}" found. In autonomous mode, specify which one with --instance.`
+        )
+      );
+      logger.log(
+        dim('Instances: ' + profileInstances.map(([_, d]) => d.instanceId).join(', '))
+      );
+      return;
+    } else {
+      // Multiple instances for same profile — prompt
+      logger.log('');
+      logger.log(bold(`Multiple instances of profile "${options.profile}" found:`));
+      logger.log('');
+      for (const [key, dep] of profileInstances) {
+        const labelInfo = dep.label ? ` — ${dep.label}` : '';
+        logger.log(`  ${highlight(dep.instanceId)}  ${dim(`(${dep.target}${labelInfo}, deployed ${dep.deployedAt})`)}`);
+      }
+      logger.log('');
+
+      const selected = await selectPrompt(
+        'Which instance do you want to tear down?',
+        profileInstances.map(([_, dep]) => {
+          const labelInfo = dep.label ? ` — ${dep.label}` : '';
+          return `${dep.instanceId} (${dep.target}${labelInfo})`;
+        })
+      );
+
+      const selectedInstanceId = selected.replace(/ \(.*\)$/, '');
+      lock = profileInstances.find(([_, d]) => d.instanceId === selectedInstanceId)![1];
+    }
+  } else if (entries.length === 1) {
+    // Only one deployment — auto-select
+    lock = entries[0][1];
+  } else if (options.autonomous) {
+    // Autonomous mode: cannot prompt — require explicit --profile or --instance
+    logger.error(
+      errorColor(
+        'Multiple active deployments found. In autonomous mode, specify which one with --profile or --instance.'
+      )
+    );
+    logger.log(
+      dim('Active deployments: ' + entries.map(([k, d]) => `${d.profile}:${d.instanceId}`).join(', '))
+    );
+    return;
+  } else {
+    // Multiple deployments — prompt user to pick one
+    logger.log('');
+    logger.log(bold('Multiple active deployments found:'));
+    logger.log('');
+    for (const [key, dep] of entries) {
+      const labelInfo = dep.label ? ` — ${dep.label}` : '';
+      logger.log(`  ${highlight(dep.instanceId)}  ${dim(`(${dep.profile}, ${dep.target}${labelInfo}, deployed ${dep.deployedAt})`)}`);
+    }
+    logger.log('');
+
+    const selected = await selectPrompt(
+      'Which deployment do you want to tear down?',
+      entries.map(([key, dep]) => {
+        const labelInfo = dep.label ? ` — ${dep.label}` : '';
+        return `${dep.instanceId} (${dep.profile}, ${dep.target}${labelInfo})`;
+      })
+    );
+
+    // Extract the instance ID from the selection (first token before space)
+    const selectedInstanceId = selected.replace(/ \(.*\)$/, '');
+    lock = entries.find(([_, d]) => d.instanceId === selectedInstanceId)![1];
+  }
+
+  // ----------------------------------------------------------------
+  // 2. Display deployment info and confirm
+  // ----------------------------------------------------------------
+  logger.log('');
+  logger.log(bold('Active Deployment'));
+  logger.log(dim('─'.repeat(50)));
+  logger.log(formatKeyValue('Instance', lock.instanceId));
+  logger.log(formatKeyValue('Target', lock.target));
+  logger.log(formatKeyValue('Profile', lock.profile));
+  if (lock.label) {
+    logger.log(formatKeyValue('Label', lock.label));
+  }
+  logger.log(formatKeyValue('Deployed At', lock.deployedAt));
+
+  if (lock.target === 'local' && lock.local) {
+    logger.log(formatKeyValue('Engine', lock.local.engine));
+    logger.log(formatKeyValue('Services', lock.local.services.join(', ')));
+    logger.log(formatKeyValue('Compose File', lock.local.composePath));
+  }
+
+  if (lock.target === 'akash' && lock.akash) {
+    logger.log(formatKeyValue('DSEQ', String(lock.akash.dseq)));
+    logger.log(formatKeyValue('Owner', lock.akash.owner));
+    logger.log(formatKeyValue('Provider', lock.akash.provider));
+    logger.log(formatKeyValue('Network', lock.akash.network));
+  }
+
+  logger.log(dim('─'.repeat(50)));
+  logger.log('');
+
+  if (!options.yes && !options.autonomous) {
+    const proceed = await confirmPrompt(
+      `Tear down this ${lock.target} deployment?`,
+      false
+    );
+
+    if (!proceed) {
+      logger.log('Cancelled.');
+      return;
+    }
+  }
+
+  // ----------------------------------------------------------------
+  // 3. Route to target-specific teardown
+  // ----------------------------------------------------------------
+  if (lock.target === 'local') {
+    await teardownLocal(ctx, projectRoot, lock, options);
+  } else if (lock.target === 'akash') {
+    await teardownAkash(ctx, projectRoot, lock, options);
+  } else {
+    logger.error(errorColor(`Unknown deployment target: ${lock.target}`));
+  }
+}
+
+// ─────────────────────────────────────────────────────────
+// Local teardown
+// ─────────────────────────────────────────────────────────
+
+/**
+ * Tear down a local Docker/Podman deployment.
+ *
+ * Runs `compose down --remove-orphans` against the compose file
+ * recorded in the lock, then deletes the lock file.
+ */
+async function teardownLocal(
+  ctx: IKadiContext,
+  projectRoot: string,
+  lock: DeploymentLock,
+  options: DownOptions
+): Promise<void> {
+  const { logger } = ctx;
+  const local = lock.local!;
+  const engine = options.engine || local.engine;
+
+  const spinner = startSpinner(
+    `Stopping ${local.services.length} service(s) with ${engine}...`
+  );
+
+  try {
+    const composeFile = local.composePath;
+    const cmd = `${engine} compose -f "${composeFile}" down --remove-orphans`;
+
+    if (options.verbose) {
+      logger.log(dim(`Running: ${cmd}`));
+    }
+
+    execSync(cmd, {
+      cwd: projectRoot,
+      timeout: 60_000,
+      stdio: options.verbose ? 'inherit' : 'pipe',
+    });
+
+    succeedSpinner(spinner, 'Containers stopped');
+
+    // Remove this deployment from the lock file
+    await removeDeployment(projectRoot, lock.profile, lock.instanceId);
+
+    logger.log('');
+    logger.log(successColor('✓ Local deployment torn down successfully'));
+    logger.log('');
+  } catch (err) {
+    failSpinner(spinner, 'Failed to stop containers');
+    logger.error(errorColor((err as Error).message));
+
+    if (options.verbose) {
+      console.error(err);
+    }
+
+    // Still try to clean up lock if the failure was because containers
+    // were already stopped (compose down returns non-zero)
+    logger.log(
+      dim('\nTip: If containers are already stopped, delete the lock file manually:')
+    );
+    logger.log(dim(`  rm ${path.join(projectRoot, '.kadi-deploy.lock')}`));
+  }
+}
+
+// ─────────────────────────────────────────────────────────
+// Akash teardown
+// ─────────────────────────────────────────────────────────
+
+/**
+ * Tear down an Akash Network deployment.
+ *
+ * Connects a wallet (interactive QR or autonomous mnemonic),
+ * creates an AkashClient, and calls `closeDeployment(dseq)`.
+ */
+async function teardownAkash(
+  ctx: IKadiContext,
+  projectRoot: string,
+  lock: DeploymentLock,
+  options: DownOptions
+): Promise<void> {
+  const { logger } = ctx;
+  const akash = lock.akash!;
+  const network = (options.network as 'mainnet' | 'testnet') || akash.network;
+
+  let walletResult: any;
+  let akashClient: AkashClient | undefined;
+  let exitCode: number | null = null;
+
+  try {
+    // ----------------------------------------------------------------
+    // 1. Connect wallet
+    // ----------------------------------------------------------------
+    if (options.autonomous) {
+      // Autonomous mode: wallet from secrets vault
+      await teardownAkashAutonomous(ctx, projectRoot, lock, options);
+      return;
+    }
+
+    // Interactive mode: WalletConnect QR code
+    let spinner = startSpinner('Initializing WalletConnect...');
+
+    const projectId = 'ef0fd1c783f5ef70fbb102f5e5dd2c43'; // Default KADI project ID
+
+    try {
+      walletResult = await connectWallet(
+        projectId,
+        network,
+        {
+          onUriGenerated: (uri: string) => {
+            succeedSpinner(spinner, 'QR Code generated');
+            logger.log('');
+            logger.log('📱 Scan this QR code with your Keplr mobile wallet:');
+            logger.log('');
+            QRCode.generate(uri, { small: true });
+            logger.log('');
+            spinner = startSpinner('Waiting for wallet approval...');
+          },
+        }
+      );
+
+      if (!walletResult.success) {
+        failSpinner(spinner, 'Wallet connection failed');
+        logger.error(errorColor(walletResult.error.message));
+        exitCode = 1;
+        return;
+      }
+
+      succeedSpinner(spinner, `Wallet connected: ${walletResult.data.address}`);
+    } catch (err) {
+      failSpinner(spinner, 'Wallet connection failed');
+      logger.error(errorColor((err as Error).message));
+      exitCode = 1;
+      return;
+    }
+
+    // ----------------------------------------------------------------
+    // 2. Create Akash client
+    // ----------------------------------------------------------------
+    spinner = startSpinner('Creating Akash client...');
+
+    try {
+      akashClient = new AkashClient({
+        network,
+        signer: walletResult.data.signer,
+      });
+
+      succeedSpinner(spinner, 'Akash client ready');
+    } catch (err) {
+      failSpinner(spinner, 'Failed to create Akash client');
+      logger.error(errorColor((err as Error).message));
+      exitCode = 1;
+      return;
+    }
+
+    // ----------------------------------------------------------------
+    // 3. Close the deployment
+    // ----------------------------------------------------------------
+    spinner = startSpinner(
+      `Closing deployment DSEQ ${akash.dseq} on ${network}...`
+    );
+
+    const closeResult = await akashClient.closeDeployment(akash.dseq);
+
+    if (!closeResult.success) {
+      failSpinner(spinner, 'Failed to close deployment');
+      logger.error(errorColor(closeResult.error.message));
+
+      if (options.verbose && closeResult.error.cause) {
+        logger.error('\nCause:', closeResult.error.cause);
+      }
+
+      exitCode = 1;
+      return;
+    }
+
+    succeedSpinner(spinner, 'Deployment closed on Akash');
+
+    // ----------------------------------------------------------------
+    // 4. Display results and clean up
+    // ----------------------------------------------------------------
+    await removeDeployment(projectRoot, lock.profile, lock.instanceId);
+
+    logger.log('');
+    logger.log(successColor('✓ Akash deployment closed successfully'));
+    logger.log('');
+    logger.log(formatKeyValue('DSEQ', closeResult.data.dseq));
+    logger.log(formatKeyValue('Transaction', closeResult.data.transactionHash));
+    logger.log(formatKeyValue('Block Height', String(closeResult.data.height)));
+    logger.log(formatKeyValue('Closed At', closeResult.data.closedAt.toLocaleString()));
+    logger.log('');
+    logger.log(dim('Remaining escrow deposit has been refunded to your wallet.'));
+    logger.log('');
+
+    exitCode = 0;
+  } catch (err) {
+    logger.error(errorColor(`Akash teardown failed: ${(err as Error).message}`));
+
+    if (options.verbose) {
+      console.error(err);
+    }
+
+    exitCode = 1;
+  } finally {
+    // Cleanup: disconnect client and wallet
+    if (akashClient) {
+      try {
+        await akashClient.disconnect();
+      } catch {
+        // Ignore cleanup errors
+      }
+    }
+
+    if (walletResult?.success) {
+      try {
+        await disconnectWallet(walletResult.data);
+      } catch {
+        // Ignore cleanup errors
+      }
+    }
+
+    if (exitCode !== null) {
+      process.exit(exitCode);
+    }
+  }
+}
+
+// ─────────────────────────────────────────────────────────
+// Akash autonomous teardown
+// ─────────────────────────────────────────────────────────
+
+/**
+ * Tear down an Akash deployment autonomously using the wallet mnemonic
+ * from the secrets vault. No human interaction required.
+ */
+async function teardownAkashAutonomous(
+  ctx: IKadiContext,
+  projectRoot: string,
+  lock: DeploymentLock,
+  options: DownOptions
+): Promise<void> {
+  const { logger } = ctx;
+  const akash = lock.akash!;
+  const network = (options.network as 'mainnet' | 'testnet') || akash.network;
+
+  let akashClient: AkashClient | undefined;
+  let exitCode: number | null = null;
+
+  logger.log('');
+  logger.log(bold('🤖 AUTONOMOUS TEARDOWN MODE'));
+  logger.log(dim('   No human interaction required — using secrets vault'));
+  logger.log('');
+
+  try {
+    // ----------------------------------------------------------------
+    // 1. Get wallet mnemonic from secrets vault
+    // ----------------------------------------------------------------
+    let spinner = startSpinner('Reading wallet from secrets vault...');
+
+    const walletVault = options.secretsVault || 'global';
+
+    const mnemonic = readSecretFromCli({
+      key: 'AKASH_WALLET',
+      vault: walletVault,
+      cwd: projectRoot,
+    });
+
+    if (!mnemonic) {
+      failSpinner(spinner, 'Wallet mnemonic not found');
+      logger.error(
+        errorColor(
+          `Wallet mnemonic not found in vault '${walletVault}' (key: AKASH_WALLET).\n\n` +
+          `Store your mnemonic with:\n` +
+          `  kadi secret set AKASH_WALLET "your 12 or 24 word mnemonic" -v ${walletVault}\n`
+        )
+      );
+      exitCode = 1;
+      return;
+    }
+
+    succeedSpinner(spinner, 'Wallet mnemonic loaded from vault');
+
+    // ----------------------------------------------------------------
+    // 2. Create wallet from mnemonic
+    // ----------------------------------------------------------------
+    spinner = startSpinner('Creating wallet from mnemonic...');
+
+    const walletResult = await createWalletFromMnemonic(mnemonic, network);
+
+    if (!walletResult.success) {
+      failSpinner(spinner, 'Failed to create wallet');
+      logger.error(errorColor(walletResult.error.message));
+      exitCode = 1;
+      return;
+    }
+
+    const wallet = walletResult.data;
+    succeedSpinner(spinner, `Wallet ready: ${wallet.address}`);
+
+    // ----------------------------------------------------------------
+    // 3. Create Akash client with signer
+    // ----------------------------------------------------------------
+    spinner = startSpinner('Connecting to Akash network...');
+
+    akashClient = new AkashClient({
+      network,
+      signer: wallet.signer,
+    });
+
+    succeedSpinner(spinner, `Connected to ${network}`);
+
+    // ----------------------------------------------------------------
+    // 4. Close the deployment
+    // ----------------------------------------------------------------
+    spinner = startSpinner(
+      `Closing deployment DSEQ ${akash.dseq} on ${network}...`
+    );
+
+    const closeResult = await akashClient.closeDeployment(akash.dseq);
+
+    if (!closeResult.success) {
+      failSpinner(spinner, 'Failed to close deployment');
+      logger.error(errorColor(closeResult.error.message));
+
+      if (options.verbose && closeResult.error.cause) {
+        logger.error('\nCause:', closeResult.error.cause);
+      }
+
+      // Provide hints for common errors
+      logger.log('');
+      logger.log(warning('Hint: Make sure:'));
+      logger.log(dim(`  1. The wallet in vault '${walletVault}' owns deployment DSEQ ${akash.dseq}`));
+      logger.log(dim(`  2. The deployment is still active (not already closed)`));
+      logger.log(dim(`  3. The network is correct (${network})`));
+
+      exitCode = 1;
+      return;
+    }
+
+    succeedSpinner(spinner, 'Deployment closed on Akash');
+
+    // ----------------------------------------------------------------
+    // 5. Display results and clean up
+    // ----------------------------------------------------------------
+    await removeDeployment(projectRoot, lock.profile, lock.instanceId);
+
+    logger.log('');
+    logger.log(successColor('✓ Akash deployment closed successfully'));
+    logger.log('');
+    logger.log(formatKeyValue('DSEQ', closeResult.data.dseq));
+    logger.log(formatKeyValue('Transaction', closeResult.data.transactionHash));
+    logger.log(formatKeyValue('Block Height', String(closeResult.data.height)));
+    logger.log(formatKeyValue('Closed At', closeResult.data.closedAt.toLocaleString()));
+    logger.log('');
+    logger.log(dim('Remaining escrow deposit has been refunded to your wallet.'));
+    logger.log('');
+
+    exitCode = 0;
+  } catch (err) {
+    logger.error(
+      errorColor(`Autonomous teardown failed: ${(err as Error).message}`)
+    );
+
+    if (options.verbose) {
+      console.error(err);
+    }
+
+    exitCode = 1;
+  } finally {
+    // Cleanup
+    if (akashClient) {
+      try {
+        await akashClient.disconnect();
+      } catch {
+        // Ignore cleanup errors
+      }
+    }
+
+    if (exitCode !== null) {
+      process.exit(exitCode);
+    }
+  }
+}

package/src/commands/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Commands Barrel Export
+ *
+ * @module commands
+ */
+
+export * from './deploy.js';
+export * from './deploy-local.js';
+export * from './down.js';
+export * from './lock.js';