@astroanywhere/cli 0.1.0 → 0.2.0

package/LICENSE

@@ -1,21 +1,76 @@
-MIT License
-
-Copyright (c) 2025 Astro Anywhere
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Business Source License 1.1
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Parameters
+
+Licensor:             Xi Fu, Zhuoran Yang
+
+Licensed Work:        @astroanywhere/cli
+
+Additional Use Grant: None
+
+Change Date:          2030-02-25
+
+Change License:       Apache License, Version 2.0
+
+-----------------------------------------------------------------------------
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph above
+terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works of
+the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work.
+
+You must conspicuously display this License on each copy of the Licensed Work,
+and you must retain the copyright notice for the Licensed Work in this License.
+
+-----------------------------------------------------------------------------
+
+Covenants of Licensor
+
+In consideration of the right to use the Licensed Work granted to you by the
+Licensor under this License, you covenant not to institute litigation against
+the Licensor or any other licensee of the Licensed Work for patent
+infringement claims arising from the Licensed Work. This covenant shall not
+apply to claims that the Licensed Work infringes a patent that you own or
+control, or to claims of patent infringement by combinations of the Licensed
+Work with other software or hardware.
+
+-----------------------------------------------------------------------------
+
+Notice
+
+This License does not grant you any right in any trademark or logo of Licensor
+or its affiliates (provided that you may use a trademark or logo of Licensor
+as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN
+"AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License's text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor above.

package/README.md

@@ -1,6 +1,26 @@
-# @astroanywhere/cli
-
-CLI for managing [Astro](https://github.com/astro-anywhere) projects, plans, tasks, and environments.
+<h1 align="center">@astroanywhere/cli</h1>
+<p align="center">
+  <strong>Command-line interface for the Astro platform.</strong>
+  <br />
+  <br />
+  <a href="https://www.npmjs.com/package/@astroanywhere/cli"><img src="https://img.shields.io/npm/v/@astroanywhere/cli?style=flat-square&color=0a0a1a&labelColor=0a0a1a&logo=npm&logoColor=white" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@astroanywhere/cli"><img src="https://img.shields.io/npm/dm/@astroanywhere/cli?style=flat-square&color=0a0a1a&labelColor=0a0a1a&logo=npm&logoColor=white" alt="npm downloads"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18-0a0a1a?style=flat-square&labelColor=0a0a1a&logo=node.js&logoColor=white" alt="node version"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-BSL--1.1-0a0a1a?style=flat-square&labelColor=0a0a1a" alt="license"></a>
+  <br />
+  <br />
+  <a href="https://astroanywhere.com/landing/">Website</a>
+  &nbsp;&middot;&nbsp;
+  <a href="https://astroanywhere.com">Dashboard</a>
+  &nbsp;&middot;&nbsp;
+  <a href="#install">Get Started</a>
+  <br />
+  <br />
+</p>
+
+---
+
+Manage [Astro](https://astroanywhere.com/landing/) projects, plans, tasks, and environments from the terminal.
 
 ## Install
 
@@ -20,13 +40,13 @@ astro-cli login
 # List projects
 astro-cli project list
 
-# View plan
+# View plan as a tree
 astro-cli plan tree --project-id <id>
 
 # Dispatch a task
 astro-cli task dispatch <nodeId> --project-id <id>
 
-# Watch task output
+# Watch task output in real time
 astro-cli task watch <executionId>
 ```
 
@@ -34,25 +54,46 @@ astro-cli task watch <executionId>
 
 | Command | Description |
 |---------|-------------|
-| `project list\|show\|create\|delete` | Manage projects |
-| `plan tree\|create-node\|update-node` | Manage plan graphs |
-| `task list\|show\|dispatch\|cancel\|steer\|watch` | Manage tasks |
-| `env list\|show\|revoke` | Manage environments and machines |
+| `project list\|show\|create\|update\|delete\|stats` | Manage projects |
+| `plan tree\|list\|show\|create-node\|update-node\|delete-node\|stats\|export` | Manage plan graphs |
+| `task list\|show\|dispatch\|cancel\|steer\|watch\|update-status` | Manage tasks |
+| `env list\|show\|remove\|set-default\|status\|providers\|clusters` | Manage environments and machines |
 | `search <query>` | Search across projects, tasks, executions |
-| `activity` | View activity feed |
-| `trace` | View execution traces |
-| `config` | Manage CLI configuration |
+| `activity list\|watch` | View activity feed |
+| `trace show\|observations\|summary\|stats` | View execution traces |
+| `config show\|set\|get` | Manage CLI configuration |
 | `login\|logout\|whoami` | Authentication |
+| `completion` | Generate shell completions (bash, zsh, fish) |
+
+All commands support `--json` for machine-readable output.
 
 ## Configuration
 
-Config is stored at `~/.astro/config.json`.
+Config is stored at `~/.astro/config.json` (permissions 0600).
 
 | Setting | Env var | Description |
 |---------|---------|-------------|
 | `serverUrl` | `ASTRO_SERVER_URL` | Astro server URL |
 | `authToken` | — | Access token (set via `login`) |
+| `defaultMachineId` | — | Default machine for dispatch |
+
+Resolution order: CLI flag `--server-url` > env var > config file > default.
+
+## Programmatic Usage
+
+```typescript
+import { AstroClient } from '@astroanywhere/cli/client'
+
+const client = new AstroClient({ serverUrl: 'http://localhost:3001' })
+const projects = await client.listProjects()
+```
 
 ## License
 
-MIT
+[BSL-1.1](./LICENSE) — converts to Apache 2.0 on 2030-02-25.
+
+---
+
+<p align="center">
+  <a href="https://astroanywhere.com/landing/">astroanywhere.com</a>
+</p>

package/dist/{chunk-PYFBZGQG.js → chunk-7H7WD7QX.js}

@@ -1,3 +1,5 @@
+#!/usr/bin/env node
+
 // src/config.ts
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
 import { join } from "path";
@@ -19,18 +21,18 @@ function saveConfig(updates) {
   mkdirSync(CONFIG_DIR, { recursive: true });
   const current = loadConfig();
   const merged = { ...current, ...updates };
-  writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2) + "\n");
+  writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2) + "\n", { mode: 384 });
 }
 function clearAuth() {
   const current = loadConfig();
   delete current.authToken;
   delete current.refreshToken;
   mkdirSync(CONFIG_DIR, { recursive: true });
-  writeFileSync(CONFIG_FILE, JSON.stringify(current, null, 2) + "\n");
+  writeFileSync(CONFIG_FILE, JSON.stringify(current, null, 2) + "\n", { mode: 384 });
 }
 function resetConfig() {
   mkdirSync(CONFIG_DIR, { recursive: true });
-  writeFileSync(CONFIG_FILE, JSON.stringify({ serverUrl: DEFAULT_SERVER_URL }, null, 2) + "\n");
+  writeFileSync(CONFIG_FILE, JSON.stringify({ serverUrl: DEFAULT_SERVER_URL }, null, 2) + "\n", { mode: 384 });
 }
 function getServerUrl(cliOverride) {
   if (cliOverride) return cliOverride;
@@ -69,7 +71,8 @@ var AstroClient = class {
       });
       this.headers["Authorization"] = `Bearer ${data.accessToken}`;
       return true;
-    } catch {
+    } catch (err) {
+      console.error(`Token refresh failed: ${err instanceof Error ? err.message : String(err)}`);
       return false;
     }
   }

package/dist/client.js

@@ -1,8 +1,9 @@
+#!/usr/bin/env node
 import {
   AstroClient,
   getClient,
   streamDispatchToStdout
-} from "./chunk-PYFBZGQG.js";
+} from "./chunk-7H7WD7QX.js";
 export {
   AstroClient,
   getClient,

package/dist/index.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import {
   clearAuth,
   getClient,
@@ -6,7 +7,7 @@ import {
   resetConfig,
   saveConfig,
   streamDispatchToStdout
-} from "./chunk-PYFBZGQG.js";
+} from "./chunk-7H7WD7QX.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -1727,6 +1728,19 @@ function registerConfigCommands(program2) {
       process.exitCode = 1;
       return;
     }
+    if (resolved === "serverUrl") {
+      try {
+        new URL(value);
+      } catch {
+        if (json) {
+          print({ error: `Invalid URL: "${value}"` }, { json: true });
+        } else {
+          console.error(chalk9.red(`Invalid URL: "${value}"`));
+        }
+        process.exitCode = 1;
+        return;
+      }
+    }
     saveConfig({ [resolved]: value });
     if (json) {
       print({ ok: true, key: resolved, value }, { json: true });
@@ -2062,7 +2076,7 @@ function registerCompletionCommands(program2) {
 
 // src/index.ts
 var program = new Command();
-program.name("astro-cli").description("CLI for managing Astro projects, plans, tasks, and environments").version("0.1.0").option("--json", "Machine-readable JSON output").option("--quiet", "Suppress spinners and decorative output").option("--server-url <url>", "Override server URL");
+program.name("astro-cli").description("CLI for managing Astro projects, plans, tasks, and environments").version("0.2.0").option("--json", "Machine-readable JSON output").option("--quiet", "Suppress spinners and decorative output").option("--server-url <url>", "Override server URL");
 registerProjectCommands(program);
 registerPlanCommands(program);
 registerTaskCommands(program);
@@ -2073,4 +2087,8 @@ registerEnvCommands(program);
 registerConfigCommands(program);
 registerAuthCommands(program);
 registerCompletionCommands(program);
+program.command("tui").description("Launch interactive terminal UI").action(async () => {
+  const { launchTui } = await import("./tui.js");
+  await launchTui(program.opts().serverUrl);
+});
 program.parse();