@apso/cli 0.22.0 → 0.24.0

package/dist/commands/deploy.js

@@ -10,6 +10,7 @@ const git = tslib_1.__importStar(require("../lib/git"));
 const apsorc_parser_1 = require("../lib/apsorc-parser");
 const sandbox_1 = require("../lib/migrate/sandbox");
 const spinner_1 = require("../lib/utils/spinner");
+const interactive_1 = require("../lib/utils/interactive");
 class Deploy extends base_command_1.default {
     async run() {
         const { flags } = await this.parse(Deploy);
@@ -78,6 +79,9 @@ class Deploy extends base_command_1.default {
         }
         // Confirmation
         if (!flags.yes && migrationCount > 0) {
+            if (!(0, interactive_1.isInteractive)()) {
+                this.error((0, interactive_1.missingFlag)(`About to deploy ${migrationCount} migration statement(s). Pass --yes to proceed.`));
+            }
             const inquirer = await Promise.resolve().then(() => tslib_1.__importStar(require("inquirer")));
             const { confirm } = await inquirer.default.prompt([
                 {

package/dist/commands/link.d.ts

@@ -5,6 +5,7 @@ export default class Link extends BaseCommand {
     static flags: {
         workspace: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         service: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        create: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;

package/dist/commands/link.js

@@ -9,6 +9,7 @@ const base_command_1 = tslib_1.__importDefault(require("../lib/base-command"));
 const config_1 = require("../lib/config");
 const services_1 = require("../lib/api/services");
 const upgrade_1 = require("../lib/upgrade");
+const interactive_1 = require("../lib/utils/interactive");
 class Link extends base_command_1.default {
     async run() {
         const { flags } = await this.parse(Link);
@@ -24,6 +25,9 @@ class Link extends base_command_1.default {
         // Check if already linked
         if (config_1.projectLink.exists() && !flags.force) {
             const existing = config_1.projectLink.read();
+            if (!(0, interactive_1.isInteractive)()) {
+                this.error((0, interactive_1.missingFlag)(`Already linked to ${existing === null || existing === void 0 ? void 0 : existing.workspaceSlug}/${existing === null || existing === void 0 ? void 0 : existing.serviceSlug}. Pass --force to overwrite.`));
+            }
             const { confirm } = await inquirer_1.default.prompt([
                 {
                     type: "confirm",
@@ -37,16 +41,24 @@ class Link extends base_command_1.default {
                 return;
             }
         }
-        // Determine workspace
+        // Determine workspace: --workspace flag, then the active workspace, then a
+        // prompt (interactive only).
         let workspace;
+        const active = config_1.globalConfig.read();
         if (flags.workspace) {
             workspace = await services_1.workspacesApi.get(flags.workspace);
         }
+        else if (active.activeWorkspaceSlug) {
+            workspace = await services_1.workspacesApi.get(active.activeWorkspaceSlug);
+        }
         else {
             const workspaces = await services_1.workspacesApi.list();
             if (workspaces.length === 0) {
                 this.error("No workspaces found. Create a workspace at https://app.apso.cloud first.");
             }
+            if (!(0, interactive_1.isInteractive)()) {
+                this.error((0, interactive_1.missingFlag)("Pass --workspace <slug> or set one with 'apso use'."));
+            }
             const response = await inquirer_1.default.prompt([
                 {
                     type: "list",
@@ -60,11 +72,19 @@ class Link extends base_command_1.default {
             ]);
             workspace = response.workspace;
         }
-        // Determine service
+        // Determine service: --service links an existing one, --create makes a new
+        // one, otherwise prompt (interactive only).
         let service;
         if (flags.service) {
             service = await services_1.servicesApi.get(workspace.id, flags.service);
         }
+        else if (flags.create) {
+            this.log(`Creating service "${flags.create}"...`);
+            service = await (0, upgrade_1.withUpgradeRetry)(() => services_1.servicesApi.create(workspace.id, { name: flags.create }));
+        }
+        else if (!(0, interactive_1.isInteractive)()) {
+            this.error((0, interactive_1.missingFlag)("Pass --service <slug> to link an existing service, or --create <name> to make a new one."));
+        }
         else {
             const servicesResponse = await services_1.servicesApi.list(workspace.id);
             const services = servicesResponse.data;
@@ -87,7 +107,6 @@ class Link extends base_command_1.default {
                 service = selectedService;
             }
             else {
-                // Create new service
                 const { serviceName } = await inquirer_1.default.prompt([
                     {
                         type: "input",
@@ -120,16 +139,21 @@ Link.description = "Link this project to a platform service";
 Link.examples = [
     `$ apso link`,
     `$ apso link --workspace my-team --service my-api`,
+    `$ apso link --workspace my-team --create my-new-api`,
     `$ apso link --force`,
 ];
 Link.flags = {
     workspace: core_1.Flags.string({
         char: "w",
-        description: "Workspace slug",
+        description: "Workspace slug (defaults to the active workspace)",
     }),
     service: core_1.Flags.string({
         char: "s",
-        description: "Service slug",
+        description: "Existing service slug to link",
+    }),
+    create: core_1.Flags.string({
+        char: "c",
+        description: "Create a new service with this name and link it",
     }),
     force: core_1.Flags.boolean({
         char: "f",

package/dist/commands/update.d.ts

@@ -0,0 +1,14 @@
+import BaseCommand from "../lib/base-command";
+/**
+ * Update the CLI in place. Detects whether it was installed via Homebrew or npm
+ * and runs the matching upgrade command, so users don't have to remember the
+ * incantation. `--check` only reports whether an update is available.
+ */
+export default class Update extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        check: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/update.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const core_1 = require("@oclif/core");
+const child_process_1 = require("child_process");
+const base_command_1 = tslib_1.__importDefault(require("../lib/base-command"));
+/**
+ * Update the CLI in place. Detects whether it was installed via Homebrew or npm
+ * and runs the matching upgrade command, so users don't have to remember the
+ * incantation. `--check` only reports whether an update is available.
+ */
+class Update extends base_command_1.default {
+    async run() {
+        const { flags } = await this.parse(Update);
+        const current = this.config.version;
+        let latest = "";
+        try {
+            latest = (0, child_process_1.execSync)("npm view @apso/cli version", {
+                encoding: "utf-8",
+                timeout: 15000,
+            }).trim();
+        }
+        catch {
+            this.warn("Could not reach npm to check for the latest version.");
+        }
+        if (latest) {
+            this.log(`  Installed: ${current}`);
+            this.log(`  Latest:    ${latest}`);
+            this.log("");
+        }
+        if (latest && latest === current) {
+            this.log("You're on the latest version.");
+            return;
+        }
+        if (flags.check) {
+            if (latest)
+                this.log(`Update available: ${current} -> ${latest}`);
+            this.log("Run 'apso update' to upgrade.");
+            return;
+        }
+        // Pick the upgrade command based on how the CLI was installed.
+        const installRoot = `${this.config.root || ""} ${process.execPath}`;
+        const isBrew = /(?:Cellar|homebrew|\/opt\/homebrew)/i.test(installRoot);
+        const cmd = isBrew
+            ? "brew upgrade apsoai/tap/apso"
+            : "npm install -g @apso/cli@latest";
+        this.log(`Updating via: ${cmd}`);
+        this.log("");
+        try {
+            (0, child_process_1.execSync)(cmd, { stdio: "inherit" });
+        }
+        catch {
+            this.error(`Update failed. Run it manually:\n  ${cmd}` +
+                (isBrew ? "" : "\n(or 'brew upgrade apsoai/tap/apso' if you used Homebrew)"));
+        }
+        this.log("");
+        this.log(`Updated to ${latest || "the latest version"}.`);
+        this.log("Run 'apso --version' to confirm.");
+    }
+}
+Update.description = "Update the Apso CLI to the latest version";
+Update.examples = ["$ apso update", "$ apso update --check"];
+Update.flags = {
+    check: core_1.Flags.boolean({
+        description: "Only check whether a newer version is available",
+        default: false,
+    }),
+};
+exports.default = Update;

package/dist/lib/upgrade.js

@@ -14,6 +14,7 @@ const child_process_1 = require("child_process");
 const inquirer_1 = tslib_1.__importDefault(require("inquirer"));
 const client_1 = require("./api/client");
 const config_1 = require("./config");
+const interactive_1 = require("./utils/interactive");
 /**
  * Open a URL in the default browser (best-effort).
  */
@@ -75,6 +76,12 @@ async function withUpgradeRetry(action) {
     }
     catch (error) {
         if (error instanceof client_1.ApiClientError && error.isLimitError()) {
+            // Headless (agent/CI): never open a browser or prompt — surface the limit
+            // as a clear error with the upgrade URL so the caller can act on it.
+            if (!(0, interactive_1.isInteractive)()) {
+                const upgradeUrl = `${config_1.globalConfig.read().webUrl}${error.upgradeUrl || "/billing/upgrade"}`;
+                throw new Error(`${error.message || "Plan limit reached."} Upgrade at ${upgradeUrl}`);
+            }
             const retry = await promptUpgrade(error);
             if (retry) {
                 return action();

package/dist/lib/utils/interactive.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Interactive vs headless detection.
+ *
+ * Humans get prompts; agents and CI must run headless — every value comes from
+ * a flag and the CLI never blocks on a prompt. Headless is forced by
+ * APSO_NONINTERACTIVE=1, by CI=true, or auto-detected when stdin/stdout is not
+ * a TTY (e.g. an agent capturing output). Commands should check `isInteractive()`
+ * and, when false, require the equivalent flag instead of prompting.
+ */
+export declare function isInteractive(): boolean;
+/**
+ * Message for a missing required value in headless mode. Name the flag that
+ * would have supplied it so an agent can retry deterministically.
+ */
+export declare function missingFlag(details: string): string;

package/dist/lib/utils/interactive.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.missingFlag = exports.isInteractive = void 0;
+/**
+ * Interactive vs headless detection.
+ *
+ * Humans get prompts; agents and CI must run headless — every value comes from
+ * a flag and the CLI never blocks on a prompt. Headless is forced by
+ * APSO_NONINTERACTIVE=1, by CI=true, or auto-detected when stdin/stdout is not
+ * a TTY (e.g. an agent capturing output). Commands should check `isInteractive()`
+ * and, when false, require the equivalent flag instead of prompting.
+ */
+function isInteractive() {
+    if (process.env.APSO_NONINTERACTIVE === "1" ||
+        process.env.APSO_NONINTERACTIVE === "true") {
+        return false;
+    }
+    if (process.env.CI === "true" || process.env.CI === "1") {
+        return false;
+    }
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+exports.isInteractive = isInteractive;
+/**
+ * Message for a missing required value in headless mode. Name the flag that
+ * would have supplied it so an agent can retry deterministically.
+ */
+function missingFlag(details) {
+    return `Running non-interactively (no TTY / CI / APSO_NONINTERACTIVE). ${details}`;
+}
+exports.missingFlag = missingFlag;

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@apso/cli",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@apso/cli",
-      "version": "0.22.0",
+      "version": "0.24.0",
       "license": "Apache-2.0",
       "dependencies": {
         "@biomejs/biome": "^1.9.4",

package/oclif.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.22.0",
+  "version": "0.24.0",
   "commands": {
     "config": {
       "id": "config",
@@ -259,6 +259,7 @@
       "examples": [
         "$ apso link",
         "$ apso link --workspace my-team --service my-api",
+        "$ apso link --workspace my-team --create my-new-api",
         "$ apso link --force"
       ],
       "flags": {
@@ -266,14 +267,21 @@
           "name": "workspace",
           "type": "option",
           "char": "w",
-          "description": "Workspace slug",
+          "description": "Workspace slug (defaults to the active workspace)",
           "multiple": false
         },
         "service": {
           "name": "service",
           "type": "option",
           "char": "s",
-          "description": "Service slug",
+          "description": "Existing service slug to link",
+          "multiple": false
+        },
+        "create": {
+          "name": "create",
+          "type": "option",
+          "char": "c",
+          "description": "Create a new service with this name and link it",
           "multiple": false
         },
         "force": {
@@ -501,6 +509,29 @@
       },
       "args": {}
     },
+    "update": {
+      "id": "update",
+      "description": "Update the Apso CLI to the latest version",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "hiddenAliases": [],
+      "examples": [
+        "$ apso update",
+        "$ apso update --check"
+      ],
+      "flags": {
+        "check": {
+          "name": "check",
+          "type": "boolean",
+          "description": "Only check whether a newer version is available",
+          "allowNo": false
+        }
+      },
+      "args": {}
+    },
     "use": {
       "id": "use",
       "description": "Select the active workspace for CLI commands",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apso/cli",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "mcpName": "io.github.apsoai/apso",
   "description": "Apso CLI",
   "author": "Apso by Mavric - @mavric",