@mindfiredigital/adac-cli

CLI command parser for ADAC diagram generation. Provides command-line interface utilities built on Commander.js.

Features

• 🎯 Commander.js integration
• 📝 Command parsing and validation
• 💬 Help text generation
• ⚙️ Configuration handling
• 🔍 --no-optimize flag to skip architecture optimization analysis

Installation

npm install @mindfiredigital/adac-cli
# or
pnpm add @mindfiredigital/adac-cli

Usage

import { runCLI } from '@mindfiredigital/adac-cli';

runCLI({
  version: '1.0.0',
  generateDiagram: async (
    input,
    output,
    layout,
    validate,
    costData,
    period,
    pricingModel,
    skipOptimizer
  ) => {
    // call your generation function here
  },
  parseAdac: (input) => {
    /* ... */
  },
  validateAdacConfig: (config) => ({ valid: true }),
});

Commands

diagram <file>

Generate an SVG diagram from an ADAC YAML file. The architecture optimizer runs automatically unless --no-optimize is passed.

| Flag | Default | Description | | --------------------- | ------------- | ------------------------------------------- | | -l, --layout <type> | elk | elk or dagre | | -o, --output <path> | <input>.svg | Output path | | --validate | — | Schema validation before generation | | --cost | — | Print cost breakdown | | --pricing <model> | on_demand | on_demand or reserved | | --period <period> | monthly | hourly / daily / monthly / yearly | | --no-optimize | — | Skip architecture optimization analysis |

validate <file>

Validate a YAML file against the ADAC schema.

cost <file>

Print cost breakdown for the given architecture.

terraform <file>

Generate Terraform files from the ADAC YAML.

CLIOptions interface

export type CLIOptions = {
  generateDiagram: (
    input: string,
    output: string,
    layoutOverride?: 'elk' | 'dagre',
    validate?: boolean,
    costData?: Record<string, number>,
    period?: CostPeriod,
    pricingModel?: PricingModel,
    skipOptimizer?: boolean // NEW — maps from --no-optimize flag
  ) => Promise<void>;
  calculateCostFromYaml?: (
    input: string,
    period?: CostPeriod,
    pricingModel?: PricingModel
  ) => CostBreakdown;
  generateTerraformFromYaml?: (
    input: string,
    outputDir?: string,
    validate?: boolean
  ) => Promise<void>;
  parseAdac: (input: string, options?: Record<string, unknown>) => unknown;
  validateAdacConfig: (config: unknown) => {
    valid: boolean;
    errors?: string[];
  };
  version: string;
};

See Also

• @mindfiredigital/adac-diagram — Main CLI distribution
• @mindfiredigital/adac-core — Core engine
• @mindfiredigital/adac-optimizer — Optimization rules

License

MIT