@elaraai/e3-cli 0.0.1-alpha.2

package/LICENSE.md

@@ -0,0 +1,50 @@
+# Business Source License 1.1
+
+Copyright (c) 2025 Elara AI Pty Ltd
+
+## License
+
+**Licensor:** Elara AI Pty Ltd
+
+**Licensed Work:** @elaraai/e3-cli
+
+**Change Date:** Four years from the date of each release
+
+**Change License:** AGPL-3.0
+
+## Terms
+
+The Licensed Work is provided under the terms of the Business Source License 1.1 as detailed below.
+
+### Grant of Rights
+
+The Licensor grants you the right to copy, modify, create derivative works, redistribute, and make non-production use of the Licensed Work.
+
+### Production Use Limitation
+
+**"Production Use"** means any use by or on behalf of a for-profit entity, other than for evaluation, testing, or development purposes.
+
+Production Use requires a separate commercial license from the Licensor.
+
+### Change Date
+
+On the Change Date (four years after each release), the Licensed Work will be made available under the Change License (AGPL-3.0).
+
+### No Warranty
+
+THE LICENSED WORK IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. THE LICENSOR DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+
+## Commercial Licensing
+
+To obtain a commercial license for Production Use, contact:
+
+**Email:** support@elara.ai
+**Website:** https://elaraai.com
+
+## Governing Law
+
+This license is governed by the laws of New South Wales, Australia.
+
+---
+
+*Elara AI Pty Ltd*

package/README.md

@@ -0,0 +1,121 @@
+# @elaraai/e3-cli
+
+Command-line interface for e3 (East Execution Engine).
+
+## Installation
+
+```bash
+npm install -g @elaraai/e3-cli
+```
+
+## Commands
+
+### Repository
+
+```bash
+e3 init <repo>                    # Initialize a new repository
+e3 status <repo>                  # Show repository status
+e3 gc <repo> [--dry-run]          # Remove unreferenced objects
+```
+
+### Packages
+
+```bash
+e3 package import <repo> <zip>    # Import package from .zip
+e3 package export <repo> <pkg> <zip>  # Export package to .zip
+e3 package list <repo>            # List installed packages
+e3 package remove <repo> <pkg>    # Remove a package
+```
+
+### Workspaces
+
+```bash
+e3 workspace create <repo> <name>     # Create empty workspace
+e3 workspace deploy <repo> <ws> <pkg> # Deploy package to workspace
+e3 workspace export <repo> <ws> <zip> # Export workspace as package
+e3 workspace list <repo>              # List workspaces
+e3 workspace remove <repo> <ws>       # Remove workspace
+```
+
+### Data
+
+```bash
+e3 list <repo> [path]             # List workspaces or tree contents
+e3 get <repo> <path> [-f format]  # Get dataset value (east/json/beast2)
+e3 set <repo> <path> <file>       # Set dataset value from file
+```
+
+### Execution
+
+```bash
+e3 run <repo> <task> [inputs...]  # Run task ad-hoc
+e3 start <repo> <ws>              # Execute tasks in workspace
+e3 logs <repo> <path> [--follow]  # View task logs
+```
+
+### Utilities
+
+```bash
+e3 convert [input] --to <format>  # Convert between .east/.json/.beast2
+```
+
+## Example
+
+```bash
+# Initialize repository and import a package
+e3 init ./my-project
+e3 package import ./my-project ./greeting-pkg-1.0.0.zip
+
+# Create workspace and deploy package
+e3 workspace create ./my-project dev
+e3 workspace deploy ./my-project dev greeting-pkg@1.0.0
+
+# Set input and run
+e3 set ./my-project dev.inputs.name ./name.east
+e3 start ./my-project dev
+
+# Get results
+e3 get ./my-project dev.tasks.shout.output
+```
+
+## License
+
+BSL 1.1. See [LICENSE.md](./LICENSE.md).
+
+### Ecosystem
+
+- **[East Node](https://github.com/elaraai/east-node)**: Node.js platform functions for I/O, databases, and system operations. Connect East programs to filesystems, SQL/NoSQL databases, cloud storage, and network services.
+  - [@elaraai/east-node-std](https://www.npmjs.com/package/@elaraai/east-node-std): Filesystem, console, HTTP fetch, crypto, random distributions, timestamps
+  - [@elaraai/east-node-io](https://www.npmjs.com/package/@elaraai/east-node-io): SQLite, PostgreSQL, MySQL, MongoDB, S3, FTP, SFTP
+  - [@elaraai/east-node-cli](https://www.npmjs.com/package/@elaraai/east-node-cli): CLI for running East IR programs in Node.js
+
+- **[East Python](https://github.com/elaraai/east-py)**: Python runtime and platform functions for data science and machine learning. Execute East programs with access to optimization solvers, gradient boosting, neural networks, and model explainability.
+  - [@elaraai/east-py-datascience](https://www.npmjs.com/package/@elaraai/east-py-datascience): TypeScript types for optimization, gradient boosting, neural networks, explainability
+
+- **[East UI](https://github.com/elaraai/east-ui)**: East types and expressions for building dashboards and interactive layouts. Define UIs as data structures that render consistently across React, web, and other environments.
+  - [@elaraai/east-ui](https://www.npmjs.com/package/@elaraai/east-ui): 50+ typed UI components for layouts, forms, charts, tables, dialogs
+  - [@elaraai/east-ui-components](https://www.npmjs.com/package/@elaraai/east-ui-components): React renderer with Chakra UI styling
+
+- **[e3 - East Execution Engine](https://github.com/elaraai/e3)**: Durable execution engine for running East pipelines at scale. Features Git-like content-addressable storage, automatic memoization, task queuing, and real-time monitoring.
+  - [@elaraai/e3](https://www.npmjs.com/package/@elaraai/e3): SDK for authoring e3 packages with typed tasks and pipelines
+  - [@elaraai/e3-core](https://www.npmjs.com/package/@elaraai/e3-core): Git-like object store, task queue, result caching
+  - [@elaraai/e3-types](https://www.npmjs.com/package/@elaraai/e3-types): Shared type definitions for e3 packages
+  - [@elaraai/e3-cli](https://www.npmjs.com/package/@elaraai/e3-cli): `e3 init`, `e3 run`, `e3 logs` commands for managing and monitoring tasks
+  - [@elaraai/e3-api-client](https://www.npmjs.com/package/@elaraai/e3-api-client): HTTP client for remote e3 servers
+  - [@elaraai/e3-api-server](https://www.npmjs.com/package/@elaraai/e3-api-server): REST API server for e3 repositories
+
+## Links
+
+- [East Language](https://github.com/elaraai/east)
+- [East Python Runtime](https://github.com/elaraai/east-py)
+- [Elara AI](https://elaraai.com/)
+- [Issues](https://github.com/elaraai/e3/issues)
+- support@elara.ai
+
+## About Elara
+
+East is developed by [Elara AI Pty Ltd](https://elaraai.com/), an AI-powered platform that creates economic digital twins of businesses that optimize performance. Elara combines business objectives, decisions and data to help organizations make data-driven decisions across operations, purchasing, sales and customer engagement, and project and investment planning. East powers the computational layer of Elara solutions, enabling the expression of complex business logic and data in a simple, type-safe and portable language.
+
+---
+
+*Developed by [Elara AI Pty Ltd](https://elaraai.com/)*

package/dist/src/cli-test-helpers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Create a temporary directory for CLI testing
+ */
+export declare function createTestDir(): string;
+/**
+ * Remove a temporary test directory
+ */
+export declare function removeTestDir(testDir: string): void;
+/**
+ * Write a test file to the test directory
+ */
+export declare function writeTestFile(testDir: string, filename: string, content: string | Buffer): string;
+//# sourceMappingURL=cli-test-helpers.d.ts.map

package/dist/src/cli-test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-test-helpers.d.ts","sourceRoot":"","sources":["../../src/cli-test-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAMnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,MAAM,CAIR"}

package/dist/src/cli-test-helpers.js

@@ -0,0 +1,48 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Test helpers for CLI command testing
+ *
+ * Provides utilities for:
+ * - Creating temporary test directories
+ * - Writing test input files
+ * - Cleaning up after tests
+ */
+import { mkdtempSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { writeFileSync } from 'node:fs';
+/**
+ * Track parent temp directories for cleanup
+ */
+const tempDirParents = new Map();
+/**
+ * Create a temporary directory for CLI testing
+ */
+export function createTestDir() {
+    const parentDir = mkdtempSync(join(tmpdir(), 'e3-cli-test-'));
+    const testDir = join(parentDir, 'test');
+    tempDirParents.set(testDir, parentDir);
+    return testDir;
+}
+/**
+ * Remove a temporary test directory
+ */
+export function removeTestDir(testDir) {
+    const parentDir = tempDirParents.get(testDir);
+    if (parentDir) {
+        rmSync(parentDir, { recursive: true, force: true });
+        tempDirParents.delete(testDir);
+    }
+}
+/**
+ * Write a test file to the test directory
+ */
+export function writeTestFile(testDir, filename, content) {
+    const filePath = join(testDir, filename);
+    writeFileSync(filePath, content);
+    return filePath;
+}
+//# sourceMappingURL=cli-test-helpers.js.map

package/dist/src/cli-test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-test-helpers.js","sourceRoot":"","sources":["../../src/cli-test-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC;;GAEG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEjD;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACxC,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACvC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,QAAgB,EAChB,OAAwB;IAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACzC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env -S node --stack-size=8192
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli.d.ts.map

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

package/dist/src/cli.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env -S node --stack-size=8192
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * e3 CLI - East Execution Engine command-line interface
+ *
+ * All commands take a repository path as the first argument (`.` for current directory).
+ */
+import { Command } from 'commander';
+import { initCommand } from './commands/init.js';
+import { packageCommand } from './commands/package.js';
+import { workspaceCommand } from './commands/workspace.js';
+import { listCommand } from './commands/list.js';
+import { getCommand } from './commands/get.js';
+import { setCommand } from './commands/set.js';
+import { startCommand } from './commands/start.js';
+import { runCommand } from './commands/run.js';
+import { logsCommand } from './commands/logs.js';
+import { statusCommand } from './commands/status.js';
+import { gcCommand } from './commands/gc.js';
+import { convertCommand } from './commands/convert.js';
+const program = new Command();
+program
+    .name('e3')
+    .description('East Execution Engine - Execute tasks across multiple runtimes')
+    .version('0.0.1-alpha.0');
+// Repository commands
+program
+    .command('init <repo>')
+    .description('Initialize a new e3 repository')
+    .action(initCommand);
+program
+    .command('status <repo> [workspace]')
+    .description('Show repository status, or detailed workspace status if workspace provided')
+    .action(statusCommand);
+program
+    .command('gc <repo>')
+    .description('Remove unreferenced objects')
+    .option('--dry-run', 'Report what would be deleted without deleting')
+    .option('--min-age <ms>', 'Minimum file age in ms before deletion', '60000')
+    .action(gcCommand);
+// Package commands
+program
+    .command('package')
+    .description('Package operations')
+    .addCommand(new Command('import')
+    .description('Import package from .zip file')
+    .argument('<repo>', 'Repository path')
+    .argument('<zipPath>', 'Path to .zip file')
+    .action(packageCommand.import))
+    .addCommand(new Command('export')
+    .description('Export package to .zip file')
+    .argument('<repo>', 'Repository path')
+    .argument('<pkg>', 'Package name[@version]')
+    .argument('<zipPath>', 'Output .zip path')
+    .action(packageCommand.export))
+    .addCommand(new Command('list')
+    .description('List installed packages')
+    .argument('<repo>', 'Repository path')
+    .action(packageCommand.list))
+    .addCommand(new Command('remove')
+    .description('Remove a package')
+    .argument('<repo>', 'Repository path')
+    .argument('<pkg>', 'Package name[@version]')
+    .action(packageCommand.remove));
+// Workspace commands
+program
+    .command('workspace')
+    .description('Workspace operations')
+    .addCommand(new Command('create')
+    .description('Create an empty workspace')
+    .argument('<repo>', 'Repository path')
+    .argument('<name>', 'Workspace name')
+    .action(workspaceCommand.create))
+    .addCommand(new Command('deploy')
+    .description('Deploy a package to a workspace')
+    .argument('<repo>', 'Repository path')
+    .argument('<ws>', 'Workspace name')
+    .argument('<pkg>', 'Package name[@version]')
+    .action(workspaceCommand.deploy))
+    .addCommand(new Command('export')
+    .description('Export workspace as a package')
+    .argument('<repo>', 'Repository path')
+    .argument('<ws>', 'Workspace name')
+    .argument('<zipPath>', 'Output .zip path')
+    .option('--name <name>', 'Package name (default: deployed package name)')
+    .option('--version <version>', 'Package version (default: auto-generated)')
+    .action(workspaceCommand.export))
+    .addCommand(new Command('list')
+    .description('List workspaces')
+    .argument('<repo>', 'Repository path')
+    .action(workspaceCommand.list))
+    .addCommand(new Command('remove')
+    .description('Remove a workspace')
+    .argument('<repo>', 'Repository path')
+    .argument('<ws>', 'Workspace name')
+    .action(workspaceCommand.remove));
+// Dataset commands
+program
+    .command('list <repo> [path]')
+    .description('List workspaces or tree contents at path (ws.path.to.tree)')
+    .action(listCommand);
+program
+    .command('get <repo> <path>')
+    .description('Get dataset value at path (ws.path.to.dataset)')
+    .option('-f, --format <format>', 'Output format: east, json, beast2', 'east')
+    .action(getCommand);
+program
+    .command('set <repo> <path> <file>')
+    .description('Set dataset value from file (ws.path.to.dataset)')
+    .option('--type <typespec>', 'Type specification in .east format (required for .json/.csv files)')
+    .action(setCommand);
+// Execution commands
+program
+    .command('run <repo> <task> [inputs...]')
+    .description('Run task ad-hoc (task format: pkg/task or pkg@version/task)')
+    .option('-o, --output <path>', 'Output file path')
+    .option('--force', 'Force re-execution even if cached')
+    .action(runCommand);
+program
+    .command('start <repo> <ws>')
+    .description('Execute tasks in a workspace')
+    .option('--filter <pattern>', 'Only run tasks matching pattern')
+    .option('--concurrency <n>', 'Max concurrent tasks', '4')
+    .option('--force', 'Force re-execution even if cached')
+    .action(startCommand);
+program
+    .command('logs <repo> <path>')
+    .description('View task logs (path format: ws or ws.taskName)')
+    .option('--follow', 'Follow log output')
+    .action(logsCommand);
+// Utility commands
+program
+    .command('convert [input]')
+    .description('Convert between .east, .json, and .beast2 formats')
+    .option('--from <format>', 'Input format: east, json, beast2 (default: auto-detect)')
+    .option('--to <format>', 'Output format: east, json, beast2', 'east')
+    .option('-o, --output <path>', 'Output file path (default: stdout)')
+    .option('--type <typespec>', 'Type specification in .east format')
+    .action(convertCommand);
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/commands/convert.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * e3 convert command - Transform data between .east, .json, and .beast2 formats
+ *
+ * Re-exports the existing convert logic.
+ */
+export { convertFile as convertCommand } from './convert.impl.js';
+//# sourceMappingURL=convert.d.ts.map

package/dist/src/commands/convert.d.ts.map

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

package/dist/src/commands/convert.impl.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Output format type (type is output-only)
+ */
+export type ConvertFormat = 'east' | 'json' | 'beast2' | 'type';
+/**
+ * Input format type (no 'type' as input)
+ */
+export type InputFormat = 'east' | 'json' | 'beast2';
+/**
+ * Conversion result
+ */
+export interface ConvertResult {
+    success: boolean;
+    data?: string | Buffer;
+    format?: ConvertFormat;
+    error?: Error;
+}
+/**
+ * Core logic for converting between formats
+ * Supports .beast2 (self-describing), .east (with parseInferred or --type), .json (with --type), and stdin
+ */
+export declare function convertCore(inputPath: string | null, toFormat: ConvertFormat, outputPath?: string, typeSpec?: string, fromFormat?: InputFormat): Promise<ConvertResult>;
+/**
+ * CLI handler for the convert command
+ */
+export declare function convertFile(inputPath: string | undefined, toFormat?: ConvertFormat, outputPath?: string, typeSpec?: string, fromFormat?: InputFormat): Promise<void>;
+//# sourceMappingURL=convert.impl.d.ts.map

package/dist/src/commands/convert.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.impl.d.ts","sourceRoot":"","sources":["../../../src/commands/convert.impl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAcD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,aAAa,EACvB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,WAAW,GACvB,OAAO,CAAC,aAAa,CAAC,CAmJxB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,GAAE,aAAsB,EAChC,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,WAAW,GACvB,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/src/commands/convert.impl.js

@@ -0,0 +1,197 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * e3 convert command - Transform data between .east, .json, and .beast2 formats
+ */
+import * as fs from 'fs/promises';
+import { decodeBeast2, printFor, toJSONFor, parseFor, fromJSONFor, encodeBeast2For, parseInferred, printType, } from '@elaraai/east';
+/**
+ * Detect format from file extension
+ */
+function detectFormat(filePath) {
+    const ext = filePath.slice(filePath.lastIndexOf('.'));
+    if (ext === '.east')
+        return 'east';
+    if (ext === '.json')
+        return 'json';
+    if (ext === '.beast2')
+        return 'beast2';
+    throw new Error(`Cannot detect format from extension: ${ext} (expected .east, .json, or .beast2)`);
+}
+/**
+ * Core logic for converting between formats
+ * Supports .beast2 (self-describing), .east (with parseInferred or --type), .json (with --type), and stdin
+ */
+export async function convertCore(inputPath, toFormat, outputPath, typeSpec, fromFormat) {
+    try {
+        let type;
+        let value;
+        let detectedFormat;
+        // Read input data
+        let inputData;
+        if (inputPath === null) {
+            // Read from stdin
+            const chunks = [];
+            for await (const chunk of process.stdin) {
+                chunks.push(chunk);
+            }
+            inputData = Buffer.concat(chunks);
+            // Detect format if not explicitly specified
+            if (fromFormat) {
+                detectedFormat = fromFormat;
+            }
+            else {
+                // Try to detect format from content
+                if (inputData.length > 0 && inputData[0] === 0x42) {
+                    // Beast2 files typically start with 'B' (0x42) magic byte
+                    detectedFormat = 'beast2';
+                }
+                else {
+                    // Assume text format - default to .east unless explicitly JSON-like
+                    const content = inputData.toString('utf-8').trim();
+                    // Only treat as JSON if it looks like a JSON object with quotes around keys
+                    if (content.startsWith('{') && content.includes('"')) {
+                        detectedFormat = 'json';
+                    }
+                    else {
+                        // Default to .east (handles arrays, structs, primitives, etc.)
+                        detectedFormat = 'east';
+                    }
+                }
+            }
+        }
+        else {
+            // Read from file
+            inputData = await fs.readFile(inputPath);
+            // Use explicit format if provided, otherwise detect from extension
+            if (fromFormat) {
+                detectedFormat = fromFormat;
+            }
+            else {
+                detectedFormat = detectFormat(inputPath);
+            }
+        }
+        // Parse type specification if provided (in .east format)
+        let providedType;
+        if (typeSpec) {
+            const [parsedType, _] = parseInferred(typeSpec);
+            providedType = parsedType;
+        }
+        // Decode input based on format
+        if (detectedFormat === 'beast2') {
+            // Beast2 is self-describing
+            const decoded = decodeBeast2(inputData);
+            type = decoded.type;
+            value = decoded.value;
+        }
+        else if (detectedFormat === 'east') {
+            // For .east, try parseInferred first, then use providedType
+            const content = inputData.toString('utf-8');
+            if (providedType) {
+                // Use provided type
+                const parser = parseFor(providedType);
+                const result = parser(content);
+                if (!result.success) {
+                    throw new Error(`Failed to parse .east with provided type: ${result.error}`);
+                }
+                type = providedType;
+                value = result.value;
+            }
+            else {
+                // Use parseInferred
+                const [parsedType, parsedValue] = parseInferred(content);
+                type = parsedType;
+                value = parsedValue;
+            }
+        }
+        else {
+            // JSON format - requires type
+            if (!providedType) {
+                throw new Error('JSON format requires --type to be specified');
+            }
+            const content = inputData.toString('utf-8');
+            const jsonValue = JSON.parse(content);
+            const fromJSON = fromJSONFor(providedType);
+            type = providedType;
+            value = fromJSON(jsonValue);
+        }
+        // If already in target format and no output path, just return
+        // (but not if outputting type, which is always computed)
+        if (detectedFormat === toFormat && !outputPath && inputPath !== null) {
+            return {
+                success: true,
+                data: inputData,
+                format: toFormat,
+            };
+        }
+        // Encode to target format
+        let outputData;
+        if (toFormat === 'type') {
+            // Output the type instead of the value (always in .east format)
+            const typeString = printType(type);
+            outputData = typeString;
+        }
+        else if (toFormat === 'east') {
+            const printer = printFor(type);
+            outputData = printer(value);
+        }
+        else if (toFormat === 'json') {
+            const toJSON = toJSONFor(type);
+            const jsonResult = toJSON(value);
+            outputData = JSON.stringify(jsonResult, null, 2);
+        }
+        else {
+            // beast2
+            const encoder = encodeBeast2For(type);
+            outputData = Buffer.from(encoder(value));
+        }
+        // Write to output file if specified
+        if (outputPath) {
+            if (outputData instanceof Buffer) {
+                await fs.writeFile(outputPath, outputData);
+            }
+            else {
+                await fs.writeFile(outputPath, outputData, 'utf-8');
+            }
+            return {
+                success: true,
+                format: toFormat,
+            };
+        }
+        return {
+            success: true,
+            data: outputData,
+            format: toFormat,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error : new Error(String(error)),
+        };
+    }
+}
+/**
+ * CLI handler for the convert command
+ */
+export async function convertFile(inputPath, toFormat = 'east', outputPath, typeSpec, fromFormat) {
+    // If no input path, use stdin
+    const actualInputPath = inputPath === undefined || inputPath === '-' ? null : inputPath;
+    const result = await convertCore(actualInputPath, toFormat, outputPath, typeSpec, fromFormat);
+    if (!result.success) {
+        console.error(`Error: Failed to convert: ${result.error?.message}`);
+        process.exit(1);
+    }
+    // Output the data to stdout if no output file specified
+    if (!outputPath && result.data) {
+        if (result.data instanceof Buffer) {
+            process.stdout.write(result.data);
+        }
+        else {
+            console.log(result.data);
+        }
+    }
+}
+//# sourceMappingURL=convert.impl.js.map