@ericdisero/aurora-cli 0.2.0 → 0.4.0

package/README.md

@@ -1,37 +1,57 @@
-# @ericdisero/aurora-cli
-
-`aurora` — terminal CLI for **Aurora**, the AI audio workbench. Drive music generation, covers, sample manufacturing, 7-stem separation, and stack export from your shell, or let Claude Code shell out to it instead of loading 27 MCP tool schemas into context.
-
-## Install
-
-```bash
-npm i -g @ericdisero/aurora-cli
-aurora keys --suno-api-key <key> --mvsep-api-key <key>   # once
-aurora status
-```
-
-## Commands
-
-```bash
-aurora run --list                 # every operation + description
-aurora run <op> --key value       # run any operation (same surface as the MCP)
-aurora install-skills [--global]  # bundled agent recipes → .claude/skills/<name>/SKILL.md
-aurora mcp                        # print the MCP client config for this machine
-aurora keys                       # provider key status (masked)
-aurora status                     # userData / database / projects root / keys
-```
-
-## Examples
-
-```bash
-aurora run aurora_create_project --name "Midnight Drive"
-aurora run aurora_sounds --prompt "huge cinematic braam, dark low brass" --soundKey Cm --tempo 140
-aurora run aurora_generate --prompt "dark synthwave, driving bass" --background
-aurora run aurora_get_job_status --jobId gen-xxxx        # streamUrls while cooking
-aurora run aurora_split --assetId <id> --background      # 7 stems, progressive landing
-aurora run aurora_stack_export --projectId <id>          # aligned multi-WAV bundle
-```
-
-Server sibling: `@ericdisero/aurora-mcp-server`. Full docs: [github.com/EricDisero/aurora-mcp](https://github.com/EricDisero/aurora-mcp).
-
-MIT. Copyright Blueprint Online Learning Inc.
+# @ericdisero/aurora-cli
+
+`aurora` is the terminal interface to Aurora's audio library: Suno generation, covers and sounds, projects/tracks/assets, checked seven-stem splits and group/instrument extraction. It uses the same [`ALL_OPERATIONS`](../shared/src/operations/index.ts) registry as the MCP server. `aurora run --list` prints the current operations; their input schemas are the parameter reference.
+
+## Setup and commands
+
+```bash
+npm i -g @ericdisero/aurora-cli
+aurora keys --suno-api-key <key> --mvsep-api-key <key>
+aurora status
+aurora run --list
+aurora run <op> --key value --json
+aurora install-skills
+aurora mcp
+```
+
+Node.js 18 or newer is required. Keys are saved in `~/.aurora/config.json`; `SUNO_API_KEY` (or fallback `KIE_API_KEY`) and `MVSEP_API_KEY` override saved values. `aurora keys` shows masked status. Local reads, route discovery and checks need no keys. `install-skills` writes the bundled recipes to `.claude/skills/<name>/SKILL.md`; `--global` installs under the home directory. `mcp` prints client configuration.
+
+The command is `aurora run`, and `--help` on a run line gives generic dispatcher help. Use the registry's input schema for exact parameters. Booleans accept `--estimateOnly true`; arrays accept comma-separated values. `--json` returns `{text, data}`.
+
+## Plan and run separation
+
+```bash
+aurora run aurora_list_separation_routes --surface "extract group" --json
+aurora run aurora_split --assetId <id> --estimateOnly true --json
+aurora run aurora_extract --assetId <id> --stems brass,strings --estimateOnly true --json
+```
+
+Routes expose quality/evidence and exact output keys. Plans spend nothing. After authorizing the provider spend, start once and advance the returned job:
+
+```bash
+aurora run aurora_extract --assetId <id> --stems brass,strings --json
+aurora run aurora_get_job_status --jobId <job-id> --waitSeconds 30 --json
+aurora run aurora_check_separation_result --jobId <job-id> --json
+```
+
+Split/extract default to background and queue before submitting. **The CLI leaves no worker running:** repeat status until `completed`, `partial`, `failed` or `cancelled`. Status defaults to `advance: true` and can submit paid calls. `waitSeconds` is 0-30; 0 advances once and positive values bound waiting between units. In-flight interactions settle before stopping. Suno operations default to blocking and accept `--background true`; their initial call spends immediately.
+
+Snapshots and cancellation are local:
+
+```bash
+aurora run aurora_get_job_status --jobId <job-id> --advance false --json
+aurora run aurora_list_jobs --json
+aurora run aurora_cancel_job --jobId <job-id> --json
+```
+
+Manifests survive restarts; resume with status. Partial jobs keep successful outputs. Inspect `splitAttempts`/`callResults`, requested/delivered files and `lastError` in `data` before authorizing replacement work. Cancellation stops future units after an in-progress interaction settles. Accepted provider work may still run without a refund; saved files stay.
+
+## Checks, costs and tests
+
+Every provider separation result passes exact-key identity, audio-shape, sum and applicable family checks before being saved as a stem. Failed checks remove temporary downloads and report the reason. Local checks expose `ok`, metrics and limitations; job checks distinguish recorded provenance from a fresh replay when auxiliary files are unavailable. A pass does not certify musical purity, and brass/woodwinds/strings/keys/guitar have no family test for clean label swaps.
+
+Suno generation/cover/layering/editing/WAV conversion and MVSEP submissions spend provider credits/minutes. Plans, route discovery, checks, snapshots/cancellation and local library/audio operations are free. See the [repository README](../../README.md) for the full workflow, check inputs and free test commands (`npm run smoke`, `npm run test:contract`, `npm run test:surface`, after build/typecheck).
+
+Server sibling: `@ericdisero/aurora-mcp-server`. Live Mix/Export app control is out of scope.
+
+MIT. Copyright Blueprint Online Learning Inc.

package/dist/index.js

@@ -12,7 +12,7 @@ const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url))
 const program = new Command();
 program
     .name('aurora')
-    .description('Aurora AI audio workbench CLI — generation, covers, sounds, 7-stem splits, stack export. ' +
+    .description('Aurora AI audio workbench CLI — generation, covers, sounds, 7-stem splits. ' +
     'Agent-first: `aurora run <op> --key value` mirrors the MCP tool surface.')
     .version(pkg.version);
 program

package/package.json

@@ -1,49 +1,49 @@
-{
-  "name": "@ericdisero/aurora-cli",
-  "version": "0.2.0",
-  "description": "Aurora CLI: drive the Aurora AI audio workbench from your terminal or let Claude Code shell out to it. Music generation, covers, sample manufacturing, 7-stem separation, stack export — plus bundled agent skills and an MCP configurator.",
-  "license": "MIT",
-  "type": "module",
-  "bin": {
-    "aurora": "dist/index.js"
-  },
-  "main": "./dist/index.js",
-  "files": ["dist", "!dist/**/*.map", "README.md"],
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/EricDisero/aurora-mcp.git",
-    "directory": "packages/cli"
-  },
-  "keywords": [
-    "aurora",
-    "cli",
-    "mcp",
-    "model-context-protocol",
-    "ai-music",
-    "music-generation",
-    "stem-separation",
-    "suno",
-    "mvsep",
-    "claude",
-    "claude-code",
-    "agent-skills"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "dependencies": {
-    "@ericdisero/aurora-shared": "0.2.0",
-    "commander": "^12.1.0",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.7.0"
-  }
-}
+{
+  "name": "@ericdisero/aurora-cli",
+  "version": "0.4.0",
+  "description": "Aurora CLI: drive the Aurora AI audio workbench from your terminal or let Claude Code shell out to it. Music generation, covers, sample manufacturing, 7-stem separation — plus bundled agent skills and an MCP configurator.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "aurora": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": ["dist", "!dist/**/*.map", "README.md"],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EricDisero/aurora-mcp.git",
+    "directory": "packages/cli"
+  },
+  "keywords": [
+    "aurora",
+    "cli",
+    "mcp",
+    "model-context-protocol",
+    "ai-music",
+    "music-generation",
+    "stem-separation",
+    "suno",
+    "mvsep",
+    "claude",
+    "claude-code",
+    "agent-skills"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@ericdisero/aurora-shared": "0.4.0",
+    "commander": "^12.1.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.7.0"
+  }
+}