@tryterra/cli 0.14.1 → 0.16.0

package/README.md

@@ -19,7 +19,7 @@ The documentation is at [docs.tryterra.co/developer-tools/terra-cli][docs].
 
 1. Install the CLI:
 
-   **Standalone (macOS and Linux):**
+   **Native Install (macOS and Linux):**
 
    ```sh
    curl -fsSL https://cli.tryterra.co/install.sh | sh
@@ -30,6 +30,16 @@ The documentation is at [docs.tryterra.co/developer-tools/terra-cli][docs].
    logging in.
    Rerun the installer to update; add `-s -- --help` after `sh` for options.
 
+   **Native Install (Windows PowerShell, x64 or ARM64):**
+
+   ```powershell
+   irm https://cli.tryterra.co/install.ps1 | iex
+   ```
+
+   Requires Windows PowerShell 5.1 or PowerShell 7. Installs into
+   `%LOCALAPPDATA%\Terra\bin` and adds it to your user and current session PATH.
+   No administrator privileges are needed.
+
    **Homebrew (macOS):**
 
    ```sh
@@ -42,6 +52,8 @@ The documentation is at [docs.tryterra.co/developer-tools/terra-cli][docs].
    npm install -g @tryterra/cli
    ```
 
+   On Windows ARM64, use ARM64 Node.js for a native npm installation.
+
 2. Log in:
 
    ```sh
@@ -87,15 +99,22 @@ The documentation is at [docs.tryterra.co/developer-tools/terra-cli][docs].
 
 ## Stay up to date
 
-Terra checks for updates once a day during terminal use. When a newer release
-is available, the notice shows the command for your installation and a link
-to the release notes.
+Terra automatically updates Native Installs, global npm, and Homebrew
+installations.
+An invocation can start a background check once every four hours. Your command
+does not wait for the check or installation, and subsequent invocations use the
+updated version. Coding agents can trigger updates; CI does not.
+
+To update explicitly, run `terra update`. On Windows, this schedules the update
+after the command exits. Run `terra version` to check the version your shell uses.
 
-For Homebrew, run `brew upgrade tryterra/tap/terra`. For a global npm install,
-run `npm install -g @tryterra/cli@latest`. Run `terra version` afterwards to
-check the version your shell uses.
+Project dependencies, npx, and pinned Homebrew installations are not changed
+automatically. Other installation methods receive manual update instructions.
+Updates never request elevated permissions.
 
-Set `TERRA_NO_UPDATE_NOTIFIER=1` to disable update checks.
+Set `TERRA_NO_AUTO_UPDATE=1` to keep update notices without installing updates.
+Set `TERRA_NO_UPDATE_NOTIFIER=1` or `DO_NOT_TRACK=1` to disable automatic update
+activity entirely. These settings do not prevent an explicit `terra update`.
 
 ## Let your agent drive it
 
@@ -143,8 +162,9 @@ unattended rather than guessing that you meant it.
 
 ## Before you change anything
 
-Every command takes `--dry-run`, which prints the request that would be sent and
-touches nothing. It needs no credential, so it is safe against production.
+Commands that support previews offer `--dry-run`. It sends an authenticated
+request to the API, which reports what would change without committing it.
+Commands without preview support reject the flag.
 
 ```sh
 terra environments update --name Acme --dry-run

package/bin/shim.js

@@ -1,10 +1,6 @@
 #!/usr/bin/env node
 'use strict';
 
-// The published wrapper depends on five platform packages as optional
-// dependencies, so npm installs only the one matching this host. This shim finds
-// that binary and hands over to it.
-
 const { spawnSync } = require('child_process');
 const path = require('path');
 
@@ -49,7 +45,11 @@ if (!process.env.npm_config_user_agent) {
 
 const result = spawnSync(binPath, process.argv.slice(2), {
   stdio: 'inherit',
-  env: { ...process.env, TERRA_INSTALL_METHOD: installMethod },
+  env: {
+    ...process.env,
+    TERRA_INSTALL_METHOD: installMethod,
+    TERRA_NPM_PACKAGE_ROOT: path.resolve(__dirname, '..'),
+  },
 });
 
 if (result.error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryterra/cli",
-  "version": "0.14.1",
+  "version": "0.16.0",
   "description": "The Terra CLI",
   "homepage": "https://docs.tryterra.co/developer-tools/terra-cli",
   "license": "SEE LICENSE IN LICENSE",
@@ -26,11 +26,12 @@
     "postinstall": "node scripts/postinstall.js"
   },
   "optionalDependencies": {
-    "@tryterra/cli-darwin-arm64": "0.14.1",
-    "@tryterra/cli-darwin-x64": "0.14.1",
-    "@tryterra/cli-linux-x64": "0.14.1",
-    "@tryterra/cli-linux-arm64": "0.14.1",
-    "@tryterra/cli-win32-x64": "0.14.1"
+    "@tryterra/cli-darwin-arm64": "0.16.0",
+    "@tryterra/cli-darwin-x64": "0.16.0",
+    "@tryterra/cli-linux-x64": "0.16.0",
+    "@tryterra/cli-linux-arm64": "0.16.0",
+    "@tryterra/cli-win32-x64": "0.16.0",
+    "@tryterra/cli-win32-arm64": "0.16.0"
   },
   "engines": {
     "node": ">=18.0.0"

package/platforms.json

@@ -28,5 +28,11 @@
     "archiveTemplate": "terra_${VERSION}_windows_x86_64.zip",
     "checksums": "terra-windows-checksums.txt",
     "bin": "terra.exe"
+  },
+  "win32-arm64": {
+    "pkg": "@tryterra/cli-win32-arm64",
+    "archiveTemplate": "terra_${VERSION}_windows_arm64.zip",
+    "checksums": "terra-windows-checksums.txt",
+    "bin": "terra.exe"
   }
 }