meridian-core 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+import { Command } from 'commander';
+/**
+ * Build the root `meridian` commander program with all subcommands attached.
+ *
+ * @returns Configured commander Command ready to parse argv
+ */
+export declare function buildProgram(): Command;
+/**
+ * Parse argv and run the MERIDIAN CLI.
+ *
+ * @param argv - Process argv (defaults to process.argv)
+ */
+export declare function runCli(argv?: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CA8BtC;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzE"}

package/dist/cli.js

@@ -0,0 +1,46 @@
+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() {
+    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 = process.argv) {
+    const program = buildProgram();
+    await program.parseAsync(argv);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;SACpC,WAAW,CACV,iEAAiE;QAC/D,mCAAmC,CACtC;SACA,OAAO,CAAC,gBAAgB,EAAE,eAAe,EAAE,4BAA4B,CAAC;SACxE,WAAW,CACV,OAAO,EACP;;;;;;;;;;;CAWL,CACI,CAAC;IAEJ,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;IACrC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;IAErC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAiB,OAAO,CAAC,IAAI;IACxD,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAC/B,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/commands/analyze.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+/**
+ * Build the `meridian analyze` subcommand (default command).
+ *
+ * @returns Configured commander Command
+ */
+export declare function analyzeCommand(): Command;
+//# sourceMappingURL=analyze.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBpC;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CA0ExC"}

package/dist/commands/analyze.js

@@ -0,0 +1,78 @@
+import { Command } from 'commander';
+import { analyze } 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';
+/**
+ * Build the `meridian analyze` subcommand (default command).
+ *
+ * @returns Configured commander Command
+ */
+export function analyzeCommand() {
+    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, options) => {
+        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 = { ...result, brief, warnings };
+            if (options.json) {
+                printJson(response);
+                return;
+            }
+            printAnalysis(response);
+        }
+        catch (err) {
+            failWithError(err);
+        }
+    });
+    return command;
+}
+//# sourceMappingURL=analyze.js.map

package/dist/commands/analyze.js.map

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

package/dist/commands/field.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+/**
+ * Build the `meridian field` subcommand.
+ *
+ * @returns Configured commander Command
+ */
+export declare function fieldCommand(): Command;
+//# sourceMappingURL=field.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/commands/field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CA2CtC"}

package/dist/commands/field.js

@@ -0,0 +1,46 @@
+import { Command } from 'commander';
+import { buildFieldGraph, trace } 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';
+/**
+ * Build the `meridian field` subcommand.
+ *
+ * @returns Configured commander Command
+ */
+export function fieldCommand() {
+    const command = new Command('field').description('Run TRACE + FIELD — map the dependency graph touched by a transaction');
+    withCommonOptions(command).action(async (tx, options) => {
+        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;
+}
+//# sourceMappingURL=field.js.map

package/dist/commands/field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.js","sourceRoot":"","sources":["../../src/commands/field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAUtD;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAC9C,uEAAuE,CACxE,CAAC;IAEF,iBAAiB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,EAAsB,EAAE,OAA4B,EAAE,EAAE;QAC/F,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACrD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAEvD,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7F,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;gBACjC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBACjB,SAAS,CAAC,WAAW,CAAC,CAAC;oBACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;gBACD,qBAAqB,CAAC,WAAW,CAAC,CAAC;YACrC,CAAC;YAED,MAAM,WAAW,GAAG,eAAe,CACjC,WAAW,EACX;gBACE,cAAc,EAAE,CAAC;gBACjB,YAAY,EAAE,CAAC;gBACf,kBAAkB,EAAE,EAAE;gBACtB,QAAQ,EAAE,EAAE;gBACZ,SAAS,EAAE,EAAE;aACd,EACD,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,CACvC,CAAC;YAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,SAAS,CAAC,WAAW,CAAC,CAAC;gBACvB,OAAO;YACT,CAAC;YAED,UAAU,CAAC,WAAW,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,aAAa,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/commands/gravity.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+/**
+ * Build the `meridian gravity` subcommand.
+ *
+ * @returns Configured commander Command
+ */
+export declare function gravityCommand(): Command;
+//# sourceMappingURL=gravity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gravity.d.ts","sourceRoot":"","sources":["../../src/commands/gravity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CA+CxC"}

package/dist/commands/gravity.js

@@ -0,0 +1,47 @@
+import { Command } from 'commander';
+import { buildFieldGraph, scoreGravity, trace } 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';
+/**
+ * Build the `meridian gravity` subcommand.
+ *
+ * @returns Configured commander Command
+ */
+export function gravityCommand() {
+    const command = new Command('gravity').description('Run TRACE + FIELD + GRAVITY — score the blast radius of a transaction');
+    withCommonOptions(command).action(async (tx, options) => {
+        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;
+}
+//# sourceMappingURL=gravity.js.map

package/dist/commands/gravity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gravity.js","sourceRoot":"","sources":["../../src/commands/gravity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAUtD;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAChD,uEAAuE,CACxE,CAAC;IAEF,iBAAiB,CAAC,OAAO,CAAC,CAAC,MAAM,CAC/B,KAAK,EAAE,EAAsB,EAAE,OAA8B,EAAE,EAAE;QAC/D,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACrD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAEvD,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7F,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;gBACjC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBACjB,SAAS,CAAC,WAAW,CAAC,CAAC;oBACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;gBACD,qBAAqB,CAAC,WAAW,CAAC,CAAC;YACrC,CAAC;YAED,MAAM,WAAW,GAAG,eAAe,CACjC,WAAW,EACX;gBACE,cAAc,EAAE,CAAC;gBACjB,YAAY,EAAE,CAAC;gBACf,kBAAkB,EAAE,EAAE;gBACtB,QAAQ,EAAE,EAAE;gBACZ,SAAS,EAAE,EAAE;aACd,EACD,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,CACvC,CAAC;YAEF,MAAM,aAAa,GAAG,YAAY,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YAE3E,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,SAAS,CAAC,aAAa,CAAC,CAAC;gBACzB,OAAO;YACT,CAAC;YAED,YAAY,CAAC,aAAa,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,aAAa,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/commands/trace.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+/**
+ * Build the `meridian trace` subcommand.
+ *
+ * @returns Configured commander Command
+ */
+export declare function traceCommand(): Command;
+//# sourceMappingURL=trace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CA8BtC"}

package/dist/commands/trace.js

@@ -0,0 +1,37 @@
+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';
+/**
+ * Build the `meridian trace` subcommand.
+ *
+ * @returns Configured commander Command
+ */
+export function traceCommand() {
+    const command = new Command('trace').description('Run the TRACE engine only — simulate a transaction and report the execution path');
+    withCommonOptions(command).action(async (tx, options) => {
+        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;
+}
+//# sourceMappingURL=trace.js.map

package/dist/commands/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAUtD;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAC9C,kFAAkF,CACnF,CAAC;IAEF,iBAAiB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,EAAsB,EAAE,OAA4B,EAAE,EAAE;QAC/F,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAExF,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBACjB,SAAS,CAAC,MAAM,CAAC,CAAC;oBAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;gBACD,qBAAqB,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,SAAS,CAAC,MAAM,CAAC,CAAC;gBAClB,OAAO;YACT,CAAC;YAED,UAAU,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,aAAa,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/commands/version.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+/**
+ * Build the `meridian version` subcommand.
+ *
+ * @returns Configured commander Command
+ */
+export declare function versionCommand(): Command;
+//# sourceMappingURL=version.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAWxC"}

package/dist/commands/version.js

@@ -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() {
+    return new Command('version')
+        .description('Print MERIDIAN product and core engine version')
+        .option('--json', 'Print raw JSON instead of a formatted report')
+        .action((options) => {
+        if (options.json) {
+            printJson({ product: 'MERIDIAN', version: MERIDIAN_VERSION });
+            return;
+        }
+        console.log(`MERIDIAN v${MERIDIAN_VERSION}`);
+    });
+}
+//# sourceMappingURL=version.js.map

package/dist/commands/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC;SAC1B,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,QAAQ,EAAE,8CAA8C,CAAC;SAChE,MAAM,CAAC,CAAC,OAA2B,EAAE,EAAE;QACtC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,SAAS,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,aAAa,gBAAgB,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -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);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,21 @@
+import type { MeridianError } from '@meridian/core';
+/**
+ * Check if a value is a structured MeridianError.
+ *
+ * @param value - Value to check
+ * @returns True if the value matches the MeridianError shape
+ */
+export declare function isMeridianError(value: unknown): value is MeridianError;
+/**
+ * Print a MeridianError to stderr and exit the process with code 1.
+ *
+ * @param error - Structured MeridianError to report
+ */
+export declare function failWithMeridianError(error: MeridianError): never;
+/**
+ * Print a generic error to stderr and exit the process with code 1.
+ *
+ * @param err - Error or unknown thrown value
+ */
+export declare function failWithError(err: unknown): never;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAQtE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,CAKjE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAKjD"}

package/dist/lib/errors.js

@@ -0,0 +1,37 @@
+import pc from 'picocolors';
+/**
+ * Check if a value is a structured MeridianError.
+ *
+ * @param value - Value to check
+ * @returns True if the value matches the MeridianError shape
+ */
+export function isMeridianError(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'layer' in value &&
+        'code' in value &&
+        'hint' in value);
+}
+/**
+ * Print a MeridianError to stderr and exit the process with code 1.
+ *
+ * @param error - Structured MeridianError to report
+ */
+export function failWithMeridianError(error) {
+    console.error(pc.red(pc.bold(`✖ [${error.layer}] ${error.code}`)));
+    console.error(pc.red(error.error));
+    console.error(pc.dim(`hint: ${error.hint}`));
+    process.exit(1);
+}
+/**
+ * Print a generic error to stderr and exit the process with code 1.
+ *
+ * @param err - Error or unknown thrown value
+ */
+export function failWithError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(pc.red(pc.bold('✖ Error')));
+    console.error(pc.red(message));
+    process.exit(1);
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5B;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAO,IAAI,KAAK;QAChB,MAAM,IAAI,KAAK;QACf,MAAM,IAAI,KAAK,CAChB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAoB;IACxD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/lib/input.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Resolve the transaction XDR from a positional argument, a file path, or stdin.
+ * Precedence: --file > positional arg > stdin.
+ *
+ * @param txArg - Positional tx argument, if provided
+ * @param filePath - Path to a file containing the base64 XDR, if provided
+ * @returns Trimmed base64-encoded transaction XDR
+ * @throws If no XDR could be resolved from any source
+ */
+export declare function resolveTxInput(txArg?: string, filePath?: string): Promise<string>;
+//# sourceMappingURL=input.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/lib/input.ts"],"names":[],"mappings":"AAeA;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBvF"}

package/dist/lib/input.js

@@ -0,0 +1,38 @@
+import { readFile } from 'node:fs/promises';
+/**
+ * Read all data from stdin as a UTF-8 string.
+ *
+ * @returns Trimmed stdin contents
+ */
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString('utf-8').trim();
+}
+/**
+ * Resolve the transaction XDR from a positional argument, a file path, or stdin.
+ * Precedence: --file > positional arg > stdin.
+ *
+ * @param txArg - Positional tx argument, if provided
+ * @param filePath - Path to a file containing the base64 XDR, if provided
+ * @returns Trimmed base64-encoded transaction XDR
+ * @throws If no XDR could be resolved from any source
+ */
+export async function resolveTxInput(txArg, filePath) {
+    if (filePath) {
+        const contents = await readFile(filePath, 'utf-8');
+        return contents.trim();
+    }
+    if (txArg && txArg.trim().length > 0) {
+        return txArg.trim();
+    }
+    if (!process.stdin.isTTY) {
+        const fromStdin = await readStdin();
+        if (fromStdin.length > 0)
+            return fromStdin;
+    }
+    throw new Error('No transaction XDR provided. Pass it as an argument, via --file <path>, or pipe it over stdin.');
+}
+//# sourceMappingURL=input.js.map

package/dist/lib/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/lib/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;;;GAIG;AACH,KAAK,UAAU,SAAS;IACtB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AACxD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAc,EAAE,QAAiB;IACpE,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,MAAM,SAAS,EAAE,CAAC;QACpC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;IAC7C,CAAC;IAED,MAAM,IAAI,KAAK,CACb,gGAAgG,CACjG,CAAC;AACJ,CAAC"}

package/dist/lib/manifest.d.ts

@@ -0,0 +1,10 @@
+import type { EcosystemManifest } from '@meridian/core';
+/**
+ * Load and parse an ecosystem manifest JSON file.
+ *
+ * @param filePath - Path to the manifest JSON file
+ * @returns Parsed EcosystemManifest, or undefined if no path was given
+ * @throws If the file cannot be read or does not contain valid JSON
+ */
+export declare function loadManifest(filePath?: string): Promise<EcosystemManifest | undefined>;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/lib/manifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CA8B5F"}

package/dist/lib/manifest.js

@@ -0,0 +1,35 @@
+import { readFile } from 'node:fs/promises';
+/**
+ * Load and parse an ecosystem manifest JSON file.
+ *
+ * @param filePath - Path to the manifest JSON file
+ * @returns Parsed EcosystemManifest, or undefined if no path was given
+ * @throws If the file cannot be read or does not contain valid JSON
+ */
+export async function loadManifest(filePath) {
+    if (!filePath)
+        return undefined;
+    let raw;
+    try {
+        raw = await readFile(filePath, 'utf-8');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to read ecosystem manifest at ${filePath}: ${message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Ecosystem manifest at ${filePath} is not valid JSON: ${message}`);
+    }
+    if (typeof parsed !== 'object' ||
+        parsed === null ||
+        !Array.isArray(parsed.contracts)) {
+        throw new Error(`Ecosystem manifest at ${filePath} must be an object with a "contracts" array.`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/lib/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/lib/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAiB;IAClD,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,wCAAwC,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,uBAAuB,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,CAAC,KAAK,CAAC,OAAO,CAAE,MAAkC,CAAC,SAAS,CAAC,EAC7D,CAAC;QACD,MAAM,IAAI,KAAK,CACb,yBAAyB,QAAQ,8CAA8C,CAChF,CAAC;IACJ,CAAC;IAED,OAAO,MAA2B,CAAC;AACrC,CAAC"}

package/dist/lib/options.d.ts

@@ -0,0 +1,26 @@
+import { Command } from 'commander';
+import type { Network } from '@meridian/core';
+/**
+ * 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 declare function parseNetwork(value: string): Network;
+/**
+ * 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 declare function parseThreshold(value: string): number;
+/**
+ * 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 declare function withCommonOptions(command: Command): Command;
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/lib/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAwB,MAAM,WAAW,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKnD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAQ3D"}