@cascade-flow/cli 0.1.0

package/README.md

@@ -0,0 +1,63 @@
+# CLI
+
+Command-line interface for workflow execution.
+
+## Installation
+
+```bash
+bun install
+```
+
+## Commands
+
+### Direct Execution
+
+```bash
+cf run <workflow> [--input '{}' | --input-file path] [--output-file path] [--run-id id]
+cf list  # List workflows
+```
+
+### Queue-Based Execution
+
+```bash
+# Worker
+cf worker start [--mode unified|executor|scheduler] [--concurrency n] [--workflows-dir path]
+
+# Submit
+cf submit <workflow> [--input '{}' | --input-file path] [--priority n] [--timeout ms]
+
+# Manage
+cf status <runId>
+cf cancel <runId> [--reason text]
+```
+
+## Worker Modes
+
+- **Unified** (default) - All loops in one process
+- **Executor** - Execute steps only (requires separate scheduler)
+- **Scheduler** - Schedule steps only (requires separate executors)
+
+## Timeouts
+
+**3-tier fallback:**
+1. Step-level: `defineStep({ timeoutMs })`
+2. Submission-level: `--timeout` flag
+3. System default: 300000ms (5 min)
+
+**Stale threshold:** `--stale-threshold` (default 30s) - Detects crashed workers via missing heartbeats
+
+## Examples
+
+```bash
+# Direct execution
+cf run my-workflow --input '{"key": "value"}'
+
+# Queue-based execution
+cf worker start --concurrency 5                    # Terminal 1
+cf submit my-workflow --input '{}' --timeout 60000 # Terminal 2
+cf status <runId>                                  # Terminal 2
+
+# Scaled deployment
+cf worker start --mode scheduler                   # Terminal 1
+cf worker start --mode executor --concurrency 10   # Terminal 2-4 (multiple)
+```

package/bin/cf.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+/**
+ * Platform detection wrapper for @cascade-flow/cli
+ * Detects the current platform and executes the appropriate compiled binary
+ */
+
+import { execFileSync } from 'child_process';
+import { platform, arch } from 'process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Map platform and architecture to binary name
+const getBinaryName = () => {
+  const platformArch = `${platform}-${arch}`;
+
+  switch (platformArch) {
+    case 'darwin-arm64':
+      return 'cf-darwin-arm64';
+    case 'darwin-x64':
+      return 'cf-darwin-x64';
+    case 'linux-x64':
+      return 'cf-linux-x64';
+    case 'linux-arm64':
+      return 'cf-linux-arm64';
+    case 'win32-x64':
+      return 'cf-windows-x64.exe';
+    default:
+      console.error(`Unsupported platform: ${platform}-${arch}`);
+      console.error('Supported platforms:');
+      console.error('  - macOS ARM64 (Apple Silicon)');
+      console.error('  - macOS x64 (Intel)');
+      console.error('  - Linux x64');
+      console.error('  - Linux ARM64');
+      console.error('  - Windows x64');
+      process.exit(1);
+  }
+};
+
+// Get the binary path
+const binaryName = getBinaryName();
+const binaryPath = join(__dirname, '..', 'dist', binaryName);
+
+// Execute the binary with all passed arguments
+try {
+  execFileSync(binaryPath, process.argv.slice(2), {
+    stdio: 'inherit',
+    // Pass through environment variables
+    env: process.env
+  });
+} catch (error) {
+  // If the binary doesn't exist, provide a helpful error message
+  if (error.code === 'ENOENT') {
+    console.error(`Binary not found: ${binaryPath}`);
+    console.error('This may indicate an incomplete installation.');
+    console.error('Try reinstalling the package: npm install -g @cascade-flow/cli');
+    process.exit(1);
+  }
+
+  // For other errors, let the error propagate naturally
+  // The execFileSync will already handle exit codes from the binary
+  process.exit(error.status || 1);
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@cascade-flow/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "cf": "./bin/cf.js"
+  },
+  "scripts": {
+    "build": "./scripts/build-all-platforms.sh",
+    "build:current": "rm -rf dist && bun build src/cli.ts --compile --outfile dist/cf",
+    "prepublishOnly": "bun run build",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@cliffy/command": "npm:@jsr/cliffy__command@1.0.0-rc.8",
+    "@cascade-flow/runner": "0.1.0",
+    "@cascade-flow/backend-factory": "0.1.0",
+    "@cascade-flow/backend-filesystem": "0.1.0",
+    "@cascade-flow/worker": "0.1.0",
+    "@cascade-flow/client": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "preferGlobal": true,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cascadeflow/cascadeflow.git",
+    "directory": "packages/cli"
+  },
+  "license": "MIT",
+  "description": "Command-line interface for CascadeFlow workflow orchestrator",
+  "keywords": [
+    "workflow",
+    "orchestrator",
+    "cli",
+    "command-line",
+    "cascade-flow"
+  ]
+}