@joshualiamzn/open-stack 0.0.1

package/src/cli.mjs

@@ -0,0 +1,200 @@
+import { Command } from 'commander';
+import { DEFAULTS } from './config.mjs';
+
+/**
+ * Parse CLI arguments into a config object.
+ * Returns null when no flags were given (triggers interactive mode).
+ */
+export function parseCli(argv) {
+  const program = new Command()
+    .name('open-stack')
+    .description(
+      'Create AWS resources and an OpenSearch Ingestion (OSI) pipeline\n' +
+      'for the full Observability Stack: logs, traces, metrics, service map.'
+    )
+    .version('1.0.0');
+
+  // Mode
+  program
+    .option('--simple', 'Minimal input — auto-creates all resources with defaults')
+    .option('--advanced', 'More options — create new or reuse existing resources');
+
+  // Core
+  program
+    .option('--pipeline-name <name>', 'Pipeline name and resource prefix', DEFAULTS.pipelineName)
+    .option('--region <region>', 'AWS region (e.g. us-east-1)');
+
+  // OpenSearch — reuse
+  program
+    .option('--opensearch-endpoint <url>', 'Reuse an existing OpenSearch endpoint');
+  // OpenSearch — create
+  program
+    .option('--os-domain-name <name>', 'Domain name for new OpenSearch domain')
+    .option('--os-instance-type <type>', 'Instance type', DEFAULTS.osInstanceType)
+    .option('--os-instance-count <n>', 'Number of data nodes', DEFAULTS.osInstanceCount)
+    .option('--os-volume-size <gb>', 'EBS volume size in GB', DEFAULTS.osVolumeSize)
+    .option('--os-engine-version <ver>', 'Engine version', DEFAULTS.osEngineVersion)
+    .option('--serverless', 'Target is OpenSearch Serverless (default in simple mode)')
+    .option('--managed', 'Target is OpenSearch managed domain');
+
+  // IAM
+  program
+    .option('--iam-role-arn <arn>', 'Reuse an existing IAM role')
+    .option('--iam-role-name <name>', 'Name for new IAM role');
+
+  // APS
+  program
+    .option('--prometheus-url <url>', 'Reuse an existing APS remote-write URL')
+    .option('--aps-workspace-alias <name>', 'Alias for new APS workspace');
+
+  // Pipeline tuning
+  program
+    .option('--min-ocu <n>', 'Minimum OCUs', DEFAULTS.minOcu)
+    .option('--max-ocu <n>', 'Maximum OCUs', DEFAULTS.maxOcu)
+    .option('--service-map-window <dur>', 'Service-map window duration', DEFAULTS.serviceMapWindow);
+
+  // Output
+  program
+    .option('-o, --output <file>', 'Write pipeline YAML to file instead of stdout')
+    .option('--dry-run', 'Generate config only; do not create AWS resources');
+
+  program.parse(argv);
+  const opts = program.opts();
+
+  // If no meaningful flags were provided, return null → interactive
+  const userArgs = argv.slice(2);
+  if (userArgs.length === 0) return null;
+
+  return optsToConfig(opts);
+}
+
+/**
+ * Convert commander opts to our normalized config shape.
+ */
+function optsToConfig(opts) {
+  const mode = opts.advanced ? 'advanced' : 'simple';
+
+  // Determine actions based on which flags were provided
+  let osAction = '';
+  if (opts.opensearchEndpoint) osAction = 'reuse';
+  else if (opts.osDomainName) osAction = 'create';
+
+  let iamAction = '';
+  if (opts.iamRoleArn) iamAction = 'reuse';
+  else if (opts.iamRoleName) iamAction = 'create';
+
+  let apsAction = '';
+  if (opts.prometheusUrl) apsAction = 'reuse';
+  else if (opts.apsWorkspaceAlias) apsAction = 'create';
+
+  // Auto-detect serverless from endpoint URL when not explicitly set
+  if (opts.serverless && opts.managed) {
+    throw new Error('--serverless and --managed are mutually exclusive');
+  }
+
+  let serverless;
+  if (opts.managed) {
+    serverless = false;
+  } else if (opts.serverless) {
+    serverless = true;
+  } else if (opts.opensearchEndpoint && /\.aoss\.amazonaws\.com/i.test(opts.opensearchEndpoint)) {
+    serverless = true;
+  } else if (opts.opensearchEndpoint) {
+    serverless = false;
+  } else {
+    serverless = null; // let applySimpleDefaults decide
+  }
+
+  return {
+    mode,
+    pipelineName: opts.pipelineName,
+    region: opts.region || '',
+    osAction,
+    opensearchEndpoint: opts.opensearchEndpoint || '',
+    osDomainName: opts.osDomainName || '',
+    osInstanceType: opts.osInstanceType,
+    osInstanceCount: Number(opts.osInstanceCount),
+    osVolumeSize: Number(opts.osVolumeSize),
+    osEngineVersion: opts.osEngineVersion,
+    serverless,
+    iamAction,
+    iamRoleArn: opts.iamRoleArn || '',
+    iamRoleName: opts.iamRoleName || '',
+    apsAction,
+    prometheusUrl: opts.prometheusUrl || '',
+    apsWorkspaceAlias: opts.apsWorkspaceAlias || '',
+    apsWorkspaceId: '',
+    minOcu: Number(opts.minOcu),
+    maxOcu: Number(opts.maxOcu),
+    serviceMapWindow: opts.serviceMapWindow,
+    outputFile: opts.output || '',
+    dryRun: opts.dryRun || false,
+    accountId: '',
+  };
+}
+
+/**
+ * Apply simple-mode defaults: fill in blanks so every field has a value.
+ */
+export function applySimpleDefaults(cfg) {
+  if (!cfg.osAction) cfg.osAction = 'create';
+  if (!cfg.osDomainName) cfg.osDomainName = cfg.pipelineName;
+  if (cfg.serverless === null) cfg.serverless = true;
+  if (!cfg.iamAction) cfg.iamAction = 'create';
+  if (!cfg.iamRoleName) cfg.iamRoleName = `${cfg.pipelineName}-osi-role`;
+  if (!cfg.apsAction) cfg.apsAction = 'create';
+  if (!cfg.apsWorkspaceAlias) cfg.apsWorkspaceAlias = cfg.pipelineName;
+}
+
+/**
+ * Fill in placeholder values for resources that would be created in dry-run mode.
+ */
+export function fillDryRunPlaceholders(cfg) {
+  if (cfg.osAction === 'create' && !cfg.opensearchEndpoint) {
+    cfg.opensearchEndpoint = cfg.serverless
+      ? `https://<collection-id>.${cfg.region}.aoss.amazonaws.com`
+      : `https://search-${cfg.osDomainName}.${cfg.region}.es.amazonaws.com`;
+  }
+  if (cfg.iamAction === 'create' && !cfg.iamRoleArn) {
+    cfg.iamRoleArn = `arn:aws:iam::${cfg.accountId || '123456789012'}:role/${cfg.iamRoleName}`;
+  }
+  if (cfg.apsAction === 'create' && !cfg.prometheusUrl) {
+    cfg.prometheusUrl = `https://aps-workspaces.${cfg.region}.amazonaws.com/workspaces/<workspace-id>/api/v1/remote_write`;
+  }
+}
+
+/**
+ * Validate the config. Returns an array of error strings (empty = valid).
+ */
+export function validateConfig(cfg) {
+  const errors = [];
+
+  if (!cfg.pipelineName) errors.push('--pipeline-name is required');
+  if (!cfg.region) errors.push('--region is required');
+
+  if (cfg.osAction === 'reuse' && !cfg.opensearchEndpoint) {
+    errors.push('--opensearch-endpoint required when reusing OpenSearch');
+  }
+  if (cfg.iamAction === 'reuse' && !cfg.iamRoleArn) {
+    errors.push('--iam-role-arn required when reusing IAM role');
+  }
+  if (cfg.apsAction === 'reuse' && !cfg.prometheusUrl) {
+    errors.push('--prometheus-url required when reusing APS workspace');
+  }
+
+  // Format checks
+  if (cfg.region && !/^[a-z]{2}-[a-z]+-\d+$/.test(cfg.region)) {
+    errors.push(`Region format looks wrong: ${cfg.region} (expected e.g. us-east-1)`);
+  }
+  if (cfg.osAction === 'reuse' && cfg.opensearchEndpoint && !/^https?:\/\//.test(cfg.opensearchEndpoint)) {
+    errors.push('OpenSearch endpoint must start with http:// or https://');
+  }
+  if (cfg.iamAction === 'reuse' && cfg.iamRoleArn && !cfg.iamRoleArn.startsWith('arn:aws:iam:')) {
+    errors.push('IAM role ARN must start with arn:aws:iam:');
+  }
+  if (cfg.apsAction === 'reuse' && cfg.prometheusUrl && !/^https?:\/\//.test(cfg.prometheusUrl)) {
+    errors.push('Prometheus URL must start with http:// or https://');
+  }
+
+  return errors;
+}

package/src/commands/create.mjs

@@ -0,0 +1,43 @@
+import { runCreateWizard } from '../interactive.mjs';
+import { applySimpleDefaults, validateConfig, fillDryRunPlaceholders } from '../cli.mjs';
+import { renderPipeline } from '../render.mjs';
+import { executePipeline } from '../main.mjs';
+import { printError, printSuccess, printDivider, theme } from '../ui.mjs';
+import { writeFileSync } from 'node:fs';
+
+export async function runCreate(session) {
+  console.error();
+  printDivider();
+
+  const cfg = await runCreateWizard(session);
+
+  // Apply simple-mode defaults
+  if (!cfg.mode) cfg.mode = 'simple';
+  if (cfg.mode === 'simple') applySimpleDefaults(cfg);
+
+  // Validate
+  const errors = validateConfig(cfg);
+  if (errors.length) {
+    for (const e of errors) printError(e);
+    return;
+  }
+
+  // Dry-run path
+  if (cfg.dryRun) {
+    fillDryRunPlaceholders(cfg);
+    const yaml = renderPipeline(cfg);
+
+    if (cfg.outputFile) {
+      writeFileSync(cfg.outputFile, yaml + '\n');
+      printSuccess(`Pipeline YAML written to ${cfg.outputFile}`);
+    } else {
+      console.error(`  ${theme.muted('\u2500'.repeat(43))}`);
+      process.stdout.write(yaml);
+    }
+    console.error();
+    return;
+  }
+
+  // Live path
+  await executePipeline(cfg);
+}

package/src/commands/describe.mjs

@@ -0,0 +1,72 @@
+import { select } from '@inquirer/prompts';
+import { getPipeline } from '../aws.mjs';
+import { printInfo, printPanel, printBox, createSpinner, colorStatus, formatDate, theme } from '../ui.mjs';
+import { loadPipelines } from './index.mjs';
+
+export async function runDescribe(session) {
+  console.error();
+
+  const pipelines = await loadPipelines(session.region);
+
+  if (pipelines.length === 0) {
+    printInfo('No OSI pipelines found in this region.');
+    console.error();
+    return;
+  }
+
+  // Select a pipeline
+  const choices = pipelines.map((p) => ({
+    name: `${p.name}  ${theme.muted(`(${p.status})`)}`,
+    value: p.name,
+  }));
+
+  const pipelineName = await select({
+    message: 'Select pipeline',
+    choices,
+  });
+
+  // Fetch full details
+  const detailSpinner = createSpinner(`Loading ${pipelineName}...`);
+  detailSpinner.start();
+
+  let pipeline;
+  try {
+    pipeline = await getPipeline(session.region, pipelineName);
+    detailSpinner.succeed(`Pipeline: ${pipelineName}`);
+  } catch (err) {
+    detailSpinner.fail('Failed to get pipeline details');
+    throw err;
+  }
+
+  // Display details in a panel
+  console.error();
+  const entries = [
+    ['Name', pipeline.name],
+    ['ARN', theme.muted(pipeline.arn)],
+    ['Status', colorStatus(pipeline.status)],
+  ];
+  if (pipeline.statusReason) {
+    entries.push(['Status Reason', pipeline.statusReason]);
+  }
+  entries.push(
+    ['Min OCUs', String(pipeline.minUnits)],
+    ['Max OCUs', String(pipeline.maxUnits)],
+    ['Created', formatDate(pipeline.createdAt)],
+    ['Last Updated', formatDate(pipeline.lastUpdatedAt)],
+  );
+  printPanel(pipelineName, entries);
+
+  if (pipeline.ingestEndpoints.length > 0) {
+    console.error();
+    const epLines = pipeline.ingestEndpoints.map((ep) => theme.accent(ep));
+    printBox(['', ...epLines, ''], { title: 'Ingestion Endpoints', color: 'dim', padding: 2 });
+  }
+
+  if (pipeline.pipelineConfigurationBody) {
+    console.error();
+    const configLines = pipeline.pipelineConfigurationBody.split('\n').map((l) => theme.muted(l));
+    printBox(['', ...configLines, ''], { title: 'Pipeline Configuration', color: 'dim', padding: 1 });
+  }
+
+  console.error();
+}

package/src/commands/help.mjs

@@ -0,0 +1,19 @@
+import { printBox, printKeyHint, theme } from '../ui.mjs';
+
+export async function runHelp() {
+  console.error();
+  const lines = [
+    '',
+    `${theme.accentBold('create')}      Create a new OSI pipeline (interactive wizard)`,
+    `${theme.accentBold('list')}        List existing OSI pipelines`,
+    `${theme.accentBold('describe')}    Show details of a specific pipeline`,
+    `${theme.accentBold('update')}      Update an existing pipeline's settings`,
+    `${theme.accentBold('help')}        Show this help message`,
+    `${theme.accentBold('quit')}        Exit the pipeline manager`,
+    '',
+  ];
+  printBox(lines, { title: 'Commands', color: 'dim', padding: 2 });
+  console.error();
+  printKeyHint([['Ctrl+C', 'cancel any operation and return to menu']]);
+  console.error();
+}

package/src/commands/index.mjs

@@ -0,0 +1,40 @@
+import { runCreate } from './create.mjs';
+import { runList } from './list.mjs';
+import { runDescribe } from './describe.mjs';
+import { runUpdate } from './update.mjs';
+import { runHelp } from './help.mjs';
+import { listPipelines } from '../aws.mjs';
+import { createSpinner, theme } from '../ui.mjs';
+
+/**
+ * Load pipelines with a spinner. Shared by describe, list, and update commands.
+ */
+export async function loadPipelines(region) {
+  const spinner = createSpinner('Loading pipelines...');
+  spinner.start();
+  try {
+    const pipelines = await listPipelines(region);
+    spinner.succeed(`${pipelines.length} pipeline${pipelines.length !== 1 ? 's' : ''} found`);
+    return pipelines;
+  } catch (err) {
+    spinner.fail('Failed to list pipelines');
+    throw err;
+  }
+}
+
+export const COMMANDS = {
+  create: runCreate,
+  list: runList,
+  describe: runDescribe,
+  update: runUpdate,
+  help: runHelp,
+};
+
+export const COMMAND_CHOICES = [
+  { name: `\u2728 Create    ${theme.muted('Create a new OSI pipeline')}`, value: 'create' },
+  { name: `\u2630  List      ${theme.muted('List existing pipelines')}`, value: 'list' },
+  { name: `\uD83D\uDD0D Describe  ${theme.muted('Show details of a pipeline')}`, value: 'describe' },
+  { name: `\u270E  Update    ${theme.muted('Update a pipeline')}`, value: 'update' },
+  { name: `\u2753 Help      ${theme.muted('Show available commands')}`, value: 'help' },
+  { name: `\uD83D\uDEAA Quit      ${theme.muted('Exit')}`, value: 'quit' },
+];

package/src/commands/list.mjs

@@ -0,0 +1,26 @@
+import { printTable, printInfo, colorStatus, formatDate } from '../ui.mjs';
+import { loadPipelines } from './index.mjs';
+
+export async function runList(session) {
+  console.error();
+
+  const pipelines = await loadPipelines(session.region);
+
+  if (pipelines.length === 0) {
+    printInfo('No OSI pipelines found in this region.');
+    console.error();
+    return;
+  }
+
+  console.error();
+  const headers = ['Name', 'Status', 'OCUs', 'Created', 'Updated'];
+  const rows = pipelines.map((p) => [
+    p.name,
+    colorStatus(p.status),
+    `${p.minUnits}\u2013${p.maxUnits}`,
+    formatDate(p.createdAt),
+    formatDate(p.lastUpdatedAt),
+  ]);
+
+  printTable(headers, rows);
+}