meridian-core 0.1.0

package/dist/lib/options.js

@@ -0,0 +1,44 @@
+import { InvalidArgumentError } from 'commander';
+/**
+ * Parse and validate a --network option value.
+ *
+ * @param value - Raw CLI argument
+ * @returns Validated Network
+ * @throws InvalidArgumentError if the value is not "mainnet" or "testnet"
+ */
+export function parseNetwork(value) {
+    if (value !== 'mainnet' && value !== 'testnet') {
+        throw new InvalidArgumentError('Network must be "mainnet" or "testnet".');
+    }
+    return value;
+}
+/**
+ * Parse and validate a --confidence-threshold option value.
+ *
+ * @param value - Raw CLI argument
+ * @returns Parsed float between 0 and 1
+ * @throws InvalidArgumentError if the value is not a number in range
+ */
+export function parseThreshold(value) {
+    const parsed = Number.parseFloat(value);
+    if (Number.isNaN(parsed) || parsed < 0 || parsed > 1) {
+        throw new InvalidArgumentError('Confidence threshold must be a number between 0 and 1.');
+    }
+    return parsed;
+}
+/**
+ * Attach the options shared by every layer command (network, RPC, input, output).
+ *
+ * @param command - Commander command to extend
+ * @returns The same command, for chaining
+ */
+export function withCommonOptions(command) {
+    return command
+        .argument('[tx]', 'Base64-encoded transaction XDR')
+        .option('-n, --network <network>', 'Stellar network (mainnet | testnet)', parseNetwork, 'testnet')
+        .option('--rpc-url <url>', 'Override the Soroban RPC endpoint (else read from env)')
+        .option('-f, --file <path>', 'Read the transaction XDR from a file instead of an argument')
+        .option('-e, --ecosystem <path>', 'Path to an ecosystem manifest JSON file')
+        .option('--json', 'Print raw JSON instead of a formatted report');
+}
+//# sourceMappingURL=options.js.map

package/dist/lib/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/lib/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAG1D;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/C,MAAM,IAAI,oBAAoB,CAAC,yCAAyC,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,oBAAoB,CAAC,wDAAwD,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,OAAO,OAAO;SACX,QAAQ,CAAC,MAAM,EAAE,gCAAgC,CAAC;SAClD,MAAM,CAAC,yBAAyB,EAAE,qCAAqC,EAAE,YAAY,EAAE,SAAS,CAAC;SACjG,MAAM,CAAC,iBAAiB,EAAE,wDAAwD,CAAC;SACnF,MAAM,CAAC,mBAAmB,EAAE,6DAA6D,CAAC;SAC1F,MAAM,CAAC,wBAAwB,EAAE,yCAAyC,CAAC;SAC3E,MAAM,CAAC,QAAQ,EAAE,8CAA8C,CAAC,CAAC;AACtE,CAAC"}

package/dist/lib/output.d.ts

@@ -0,0 +1,32 @@
+import type { AnalyzeResponse, FieldResult, GravityResult, TraceResult } from '@meridian/core';
+/**
+ * Print any value as pretty-printed JSON.
+ *
+ * @param value - Value to serialize
+ */
+export declare function printJson(value: unknown): void;
+/**
+ * Print a TraceResult in human-readable form.
+ *
+ * @param trace - TRACE layer result
+ */
+export declare function printTrace(trace: TraceResult): void;
+/**
+ * Print a FieldResult in human-readable form.
+ *
+ * @param result - FIELD layer result
+ */
+export declare function printField(result: FieldResult): void;
+/**
+ * Print a GravityResult in human-readable form.
+ *
+ * @param result - GRAVITY layer result
+ */
+export declare function printGravity(result: GravityResult): void;
+/**
+ * Print a full AnalyzeResponse in human-readable form.
+ *
+ * @param response - Full analysis response including brief
+ */
+export declare function printAnalysis(response: AnalyzeResponse): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/lib/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,aAAa,EACb,WAAW,EAEZ,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE9C;AAyCD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAyBnD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAoBpD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAiBxD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAkC7D"}

package/dist/lib/output.js

@@ -0,0 +1,156 @@
+import pc from 'picocolors';
+/**
+ * Print any value as pretty-printed JSON.
+ *
+ * @param value - Value to serialize
+ */
+export function printJson(value) {
+    console.log(JSON.stringify(value, null, 2));
+}
+/**
+ * Colorize a verdict badge.
+ *
+ * @param verdict - MERIDIAN verdict
+ * @returns Colorized verdict string
+ */
+function verdictBadge(verdict) {
+    switch (verdict) {
+        case 'CLEAR':
+            return pc.bgGreen(pc.black(' CLEAR '));
+        case 'WARN':
+            return pc.bgYellow(pc.black(' WARN '));
+        case 'ABORT':
+            return pc.bgRed(pc.white(pc.bold(' ABORT ')));
+        default:
+            return verdict;
+    }
+}
+/**
+ * Print a section header.
+ *
+ * @param title - Section title
+ */
+function section(title) {
+    console.log('');
+    console.log(pc.bold(pc.cyan(`── ${title} `.padEnd(48, '─'))));
+}
+/**
+ * Print a labeled key/value line.
+ *
+ * @param label - Field label
+ * @param value - Field value
+ */
+function field(label, value) {
+    console.log(`  ${pc.dim(label + ':')} ${value}`);
+}
+/**
+ * Print a TraceResult in human-readable form.
+ *
+ * @param trace - TRACE layer result
+ */
+export function printTrace(trace) {
+    section('TRACE');
+    field('success', trace.success ? pc.green('true') : pc.red('false'));
+    if (trace.staleness_warning) {
+        field('staleness_warning', pc.yellow('true'));
+    }
+    if (trace.failure_point) {
+        const fp = trace.failure_point;
+        console.log(`  ${pc.red('failure_point')}:`);
+        field('  step_index', fp.step_index);
+        if (fp.contract_id)
+            field('  contract_id', fp.contract_id);
+        if (fp.function_name)
+            field('  function_name', fp.function_name);
+        field('  error_code', fp.error_code);
+        field('  root_cause', fp.root_cause);
+    }
+    field('execution_path', `${trace.execution_path.length} step(s)`);
+    field('auth_entries', `${trace.auth_entries.length} entrie(s)`);
+    field('fee_estimate', `total=${trace.fee_estimate.total_fee} base=${trace.fee_estimate.classic_base_fee} min_resource=${trace.fee_estimate.min_resource_fee}`);
+    field('resource_usage', `cpu=${trace.resource_usage.cpu_instructions} mem=${trace.resource_usage.memory_bytes}b read=${trace.resource_usage.read_bytes}b write=${trace.resource_usage.write_bytes}b`);
+}
+/**
+ * Print a FieldResult in human-readable form.
+ *
+ * @param result - FIELD layer result
+ */
+export function printField(result) {
+    section('FIELD');
+    field('contracts_mapped', result.contracts_mapped);
+    field('manifest_coverage', `${Math.round(result.manifest_coverage * 100)}%`);
+    if (result.ttl_warnings.length > 0) {
+        console.log(`  ${pc.yellow('ttl_warnings')}:`);
+        for (const warning of result.ttl_warnings) {
+            console.log(`    - ${warning.contract_id} (${warning.ledger_key}) ttl_remaining=${warning.ttl_remaining} [${warning.severity}]`);
+        }
+    }
+    if (result.dependency_graph.length > 0) {
+        console.log(`  ${pc.dim('dependency_graph')}:`);
+        for (const node of result.dependency_graph) {
+            const label = node.name ? `${node.name} (${node.address})` : node.address;
+            const deps = node.dependencies.length > 0 ? ` → ${node.dependencies.join(', ')}` : '';
+            console.log(`    - ${label}${deps}`);
+        }
+    }
+}
+/**
+ * Print a GravityResult in human-readable form.
+ *
+ * @param result - GRAVITY layer result
+ */
+export function printGravity(result) {
+    section('GRAVITY');
+    field('blast_radius', result.blast_radius);
+    field('total_affected_users', result.total_affected_users);
+    field('recovery', result.recovery);
+    if (result.critical.length > 0)
+        field('critical', pc.red(result.critical.join(', ')));
+    if (result.warning.length > 0)
+        field('warning', pc.yellow(result.warning.join(', ')));
+    if (result.monitor.length > 0)
+        field('monitor', pc.blue(result.monitor.join(', ')));
+    if (result.safe.length > 0)
+        field('safe', pc.green(result.safe.join(', ')));
+    if (result.affected_contracts.length > 0) {
+        console.log(`  ${pc.dim('affected_contracts')}:`);
+        for (const contract of result.affected_contracts) {
+            const label = contract.name ? `${contract.name} (${contract.address})` : contract.address;
+            console.log(`    - [${contract.impact}] ${label} — ${contract.reason}`);
+        }
+    }
+}
+/**
+ * Print a full AnalyzeResponse in human-readable form.
+ *
+ * @param response - Full analysis response including brief
+ */
+export function printAnalysis(response) {
+    console.log('');
+    console.log(`${pc.bold('MERIDIAN')} v${response.version}  ${verdictBadge(response.verdict)}  confidence=${response.confidence}`);
+    printTrace(response.trace);
+    printField(response.field);
+    printGravity(response.gravity);
+    if (response.fix_sequence && response.fix_sequence.length > 0) {
+        section('FIX SEQUENCE');
+        for (const step of response.fix_sequence) {
+            console.log(`  ${pc.bold(String(step.order) + '.')} ${step.operation} — ${step.description} ${pc.dim(`(~${step.estimated_cost_stroops} stroops, ~${step.estimated_time_minutes}min)`)}`);
+        }
+    }
+    if (response.warnings && response.warnings.length > 0) {
+        section('WARNINGS');
+        for (const warning of response.warnings) {
+            console.log(`  ${pc.yellow('⚠')} ${warning}`);
+        }
+    }
+    section('BRIEF');
+    console.log(response.brief);
+    section('META');
+    field('analyzed_at', response.meta.analyzed_at);
+    field('network', response.meta.network);
+    field('ledger_sequence', response.meta.ledger_sequence);
+    field('simulation_stale', response.meta.simulation_stale);
+    field('processing_ms', response.meta.processing_ms);
+    console.log('');
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/output.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "meridian-core",
+  "version": "0.1.0",
+  "description": "MERIDIAN command-line interface — pre-execution intelligence from your terminal",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "meridian": "dist/index.js",
+    "meridian-core": "dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@meridian/ai": "0.1.0",
+    "@meridian/core": "0.1.0",
+    "commander": "^13.0.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.9"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,54 @@
+import { Command } from 'commander';
+import { MERIDIAN_VERSION } from '@meridian/core';
+import { analyzeCommand } from './commands/analyze.js';
+import { traceCommand } from './commands/trace.js';
+import { fieldCommand } from './commands/field.js';
+import { gravityCommand } from './commands/gravity.js';
+import { versionCommand } from './commands/version.js';
+
+/**
+ * Build the root `meridian` commander program with all subcommands attached.
+ *
+ * @returns Configured commander Command ready to parse argv
+ */
+export function buildProgram(): Command {
+  const program = new Command('meridian')
+    .description(
+      'MERIDIAN — pre-execution intelligence for Stellar developers.\n' +
+        'Know what crosses before it does.',
+    )
+    .version(MERIDIAN_VERSION, '-v, --version', 'Print the MERIDIAN version')
+    .addHelpText(
+      'after',
+      `
+Examples:
+  $ meridian analyze <base64-xdr> --network testnet
+  $ cat tx.xdr | meridian analyze --network mainnet --json
+  $ meridian trace --file tx.xdr --network testnet
+  $ meridian gravity <base64-xdr> --ecosystem manifest.json
+
+Environment:
+  STELLAR_RPC_TESTNET   Soroban RPC endpoint for testnet (or use --rpc-url)
+  STELLAR_RPC_MAINNET   Soroban RPC endpoint for mainnet (or use --rpc-url)
+  ANTHROPIC_API_KEY     Claude API key for BRIEF synthesis (optional, falls back to a deterministic brief)
+`,
+    );
+
+  program.addCommand(analyzeCommand(), { isDefault: true });
+  program.addCommand(traceCommand());
+  program.addCommand(fieldCommand());
+  program.addCommand(gravityCommand());
+  program.addCommand(versionCommand());
+
+  return program;
+}
+
+/**
+ * Parse argv and run the MERIDIAN CLI.
+ *
+ * @param argv - Process argv (defaults to process.argv)
+ */
+export async function runCli(argv: string[] = process.argv): Promise<void> {
+  const program = buildProgram();
+  await program.parseAsync(argv);
+}

package/src/commands/analyze.ts

@@ -0,0 +1,103 @@
+import { Command } from 'commander';
+import { analyze } from '@meridian/core';
+import type { AnalyzeResponse, Network } from '@meridian/core';
+import { synthesizeBrief, generateFallbackBrief } from '@meridian/ai';
+import { resolveTxInput } from '../lib/input.js';
+import { loadManifest } from '../lib/manifest.js';
+import { failWithError, failWithMeridianError, isMeridianError } from '../lib/errors.js';
+import { printAnalysis, printJson } from '../lib/output.js';
+import { parseThreshold, withCommonOptions } from '../lib/options.js';
+
+interface AnalyzeCommandOptions {
+  network: Network;
+  rpcUrl?: string;
+  file?: string;
+  ecosystem?: string;
+  json?: boolean;
+  skipField?: boolean;
+  skipGravity?: boolean;
+  confidenceThreshold?: number;
+  brief: boolean;
+  apiKey?: string;
+}
+
+/**
+ * Build the `meridian analyze` subcommand (default command).
+ *
+ * @returns Configured commander Command
+ */
+export function analyzeCommand(): Command {
+  const command = new Command('analyze').description(
+    'Run the full MERIDIAN pipeline (TRACE + FIELD + GRAVITY + BRIEF) on a transaction',
+  );
+
+  withCommonOptions(command)
+    .option('--skip-field', 'Skip the FIELD dependency-mapping layer')
+    .option('--skip-gravity', 'Skip the GRAVITY blast-radius layer')
+    .option('--confidence-threshold <n>', 'Minimum confidence required for a CLEAR verdict', parseThreshold)
+    .option('--no-brief', 'Skip GenAI BRIEF synthesis (structured layers only)')
+    .option('--api-key <key>', 'Anthropic API key for BRIEF synthesis (else read from env)')
+    .action(async (tx: string | undefined, options: AnalyzeCommandOptions) => {
+      try {
+        const txXdr = await resolveTxInput(tx, options.file);
+        const ecosystem = await loadManifest(options.ecosystem);
+
+        const result = await analyze({
+          tx: txXdr,
+          network: options.network,
+          ecosystem,
+          options: {
+            skip_field: options.skipField,
+            skip_gravity: options.skipGravity,
+            confidence_threshold: options.confidenceThreshold,
+            rpc_url: options.rpcUrl,
+          },
+        });
+
+        if (isMeridianError(result)) {
+          if (options.json) {
+            printJson(result);
+            process.exit(1);
+          }
+          failWithMeridianError(result);
+        }
+
+        let brief = 'BRIEF synthesis skipped (--no-brief).';
+        let warnings = result.warnings;
+
+        if (options.brief) {
+          const briefInput = {
+            verdict: result.verdict,
+            confidence: result.confidence,
+            trace: result.trace,
+            field: result.field,
+            gravity: result.gravity,
+            fix_sequence: result.fix_sequence,
+            warnings: result.warnings,
+          };
+
+          const briefResult = await synthesizeBrief(briefInput, { apiKey: options.apiKey });
+
+          if (isMeridianError(briefResult)) {
+            brief = generateFallbackBrief(briefInput);
+            warnings = [...(result.warnings ?? []), briefResult.error];
+          } else {
+            brief = briefResult;
+          }
+        }
+
+        const response: AnalyzeResponse = { ...result, brief, warnings };
+
+        if (options.json) {
+          printJson(response);
+          return;
+        }
+
+        printAnalysis(response);
+      } catch (err) {
+        failWithError(err);
+      }
+    });
+
+  return command;
+}

package/src/commands/field.ts

@@ -0,0 +1,66 @@
+import { Command } from 'commander';
+import { buildFieldGraph, trace } from '@meridian/core';
+import type { Network } from '@meridian/core';
+import { resolveTxInput } from '../lib/input.js';
+import { loadManifest } from '../lib/manifest.js';
+import { failWithError, failWithMeridianError, isMeridianError } from '../lib/errors.js';
+import { printField, printJson } from '../lib/output.js';
+import { withCommonOptions } from '../lib/options.js';
+
+interface FieldCommandOptions {
+  network: Network;
+  rpcUrl?: string;
+  file?: string;
+  ecosystem?: string;
+  json?: boolean;
+}
+
+/**
+ * Build the `meridian field` subcommand.
+ *
+ * @returns Configured commander Command
+ */
+export function fieldCommand(): Command {
+  const command = new Command('field').description(
+    'Run TRACE + FIELD — map the dependency graph touched by a transaction',
+  );
+
+  withCommonOptions(command).action(async (tx: string | undefined, options: FieldCommandOptions) => {
+    try {
+      const txXdr = await resolveTxInput(tx, options.file);
+      const manifest = await loadManifest(options.ecosystem);
+
+      const traceResult = await trace(txXdr, { network: options.network, rpcUrl: options.rpcUrl });
+      if (isMeridianError(traceResult)) {
+        if (options.json) {
+          printJson(traceResult);
+          process.exit(1);
+        }
+        failWithMeridianError(traceResult);
+      }
+
+      const fieldResult = buildFieldGraph(
+        traceResult,
+        {
+          ledgerSequence: 0,
+          latestLedger: 0,
+          footprintContracts: [],
+          readOnly: [],
+          readWrite: [],
+        },
+        { network: options.network, manifest },
+      );
+
+      if (options.json) {
+        printJson(fieldResult);
+        return;
+      }
+
+      printField(fieldResult);
+    } catch (err) {
+      failWithError(err);
+    }
+  });
+
+  return command;
+}

package/src/commands/gravity.ts

@@ -0,0 +1,70 @@
+import { Command } from 'commander';
+import { buildFieldGraph, scoreGravity, trace } from '@meridian/core';
+import type { Network } from '@meridian/core';
+import { resolveTxInput } from '../lib/input.js';
+import { loadManifest } from '../lib/manifest.js';
+import { failWithError, failWithMeridianError, isMeridianError } from '../lib/errors.js';
+import { printGravity, printJson } from '../lib/output.js';
+import { withCommonOptions } from '../lib/options.js';
+
+interface GravityCommandOptions {
+  network: Network;
+  rpcUrl?: string;
+  file?: string;
+  ecosystem?: string;
+  json?: boolean;
+}
+
+/**
+ * Build the `meridian gravity` subcommand.
+ *
+ * @returns Configured commander Command
+ */
+export function gravityCommand(): Command {
+  const command = new Command('gravity').description(
+    'Run TRACE + FIELD + GRAVITY — score the blast radius of a transaction',
+  );
+
+  withCommonOptions(command).action(
+    async (tx: string | undefined, options: GravityCommandOptions) => {
+      try {
+        const txXdr = await resolveTxInput(tx, options.file);
+        const manifest = await loadManifest(options.ecosystem);
+
+        const traceResult = await trace(txXdr, { network: options.network, rpcUrl: options.rpcUrl });
+        if (isMeridianError(traceResult)) {
+          if (options.json) {
+            printJson(traceResult);
+            process.exit(1);
+          }
+          failWithMeridianError(traceResult);
+        }
+
+        const fieldResult = buildFieldGraph(
+          traceResult,
+          {
+            ledgerSequence: 0,
+            latestLedger: 0,
+            footprintContracts: [],
+            readOnly: [],
+            readWrite: [],
+          },
+          { network: options.network, manifest },
+        );
+
+        const gravityResult = scoreGravity(traceResult, fieldResult, { manifest });
+
+        if (options.json) {
+          printJson(gravityResult);
+          return;
+        }
+
+        printGravity(gravityResult);
+      } catch (err) {
+        failWithError(err);
+      }
+    },
+  );
+
+  return command;
+}

package/src/commands/trace.ts

@@ -0,0 +1,51 @@
+import { Command } from 'commander';
+import { trace } from '@meridian/core';
+import { resolveTxInput } from '../lib/input.js';
+import { failWithError, failWithMeridianError, isMeridianError } from '../lib/errors.js';
+import { printJson, printTrace } from '../lib/output.js';
+import { withCommonOptions } from '../lib/options.js';
+import type { Network } from '@meridian/core';
+
+interface TraceCommandOptions {
+  network: Network;
+  rpcUrl?: string;
+  file?: string;
+  json?: boolean;
+}
+
+/**
+ * Build the `meridian trace` subcommand.
+ *
+ * @returns Configured commander Command
+ */
+export function traceCommand(): Command {
+  const command = new Command('trace').description(
+    'Run the TRACE engine only — simulate a transaction and report the execution path',
+  );
+
+  withCommonOptions(command).action(async (tx: string | undefined, options: TraceCommandOptions) => {
+    try {
+      const txXdr = await resolveTxInput(tx, options.file);
+      const result = await trace(txXdr, { network: options.network, rpcUrl: options.rpcUrl });
+
+      if (isMeridianError(result)) {
+        if (options.json) {
+          printJson(result);
+          process.exit(1);
+        }
+        failWithMeridianError(result);
+      }
+
+      if (options.json) {
+        printJson(result);
+        return;
+      }
+
+      printTrace(result);
+    } catch (err) {
+      failWithError(err);
+    }
+  });
+
+  return command;
+}

package/src/commands/version.ts

@@ -0,0 +1,21 @@
+import { Command } from 'commander';
+import { MERIDIAN_VERSION } from '@meridian/core';
+import { printJson } from '../lib/output.js';
+
+/**
+ * Build the `meridian version` subcommand.
+ *
+ * @returns Configured commander Command
+ */
+export function versionCommand(): Command {
+  return new Command('version')
+    .description('Print MERIDIAN product and core engine version')
+    .option('--json', 'Print raw JSON instead of a formatted report')
+    .action((options: { json?: boolean }) => {
+      if (options.json) {
+        printJson({ product: 'MERIDIAN', version: MERIDIAN_VERSION });
+        return;
+      }
+      console.log(`MERIDIAN v${MERIDIAN_VERSION}`);
+    });
+}

package/src/index.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runCli } from './cli.js';
+
+runCli().catch((err) => {
+  console.error(err instanceof Error ? err.message : err);
+  process.exit(1);
+});