playcademy 0.26.0 → 0.26.1-beta.1

package/README.md

@@ -128,6 +128,7 @@ playcademy deploy --env staging        # Deploy to staging
 playcademy deploy --backend            # Include API routes
 playcademy deploy --no-backend         # Skip API routes
 playcademy deploy --dry-run            # Validate without deploying
+playcademy deploy --json               # Machine-readable output
 playcademy deploy --debug              # Show debug info
 ```
 
@@ -142,6 +143,7 @@ playcademy deploy --debug              # Show debug info
 - `--backend` - Deploy API routes
 - `--no-backend` - Skip API routes
 - `--dry-run` - Validate only
+- `--json` - Output a machine-readable deployment result
 - `--verbose` - Show detailed output
 - `--debug` - Show debug information
 
@@ -264,9 +266,13 @@ playcademy timeback cleanup
 
 ## Environment Variables
 
+- `CI` - Set to `1` or `true` to disable interactive prompts
+- `PLAYCADEMY_API_TOKEN` - API token for non-interactive authentication
 - `PLAYCADEMY_ENV` - Environment: `staging` or `production` (default: `production`)
 - `PLAYCADEMY_BASE_URL` - Override API endpoint (default: based on `PLAYCADEMY_ENV`)
 - `PLAYCADEMY_PROFILE` - Authentication profile to use (default: `default`)
+- `PLAYCADEMY_CONFIG_PATH` - Path to a config file
+- `DEBUG` - Set to `1` to show debug output (written to stderr, safe with `--json`)
 
 **Example:**
 
@@ -281,6 +287,67 @@ PLAYCADEMY_PROFILE=work playcademy deploy
 PLAYCADEMY_BASE_URL=http://localhost:5174 playcademy deploy
 ```
 
+## CI/CD
+
+Use `CI=1`, `PLAYCADEMY_API_TOKEN`, and an explicit environment for pipeline deploys:
+
+```bash
+CI=1 PLAYCADEMY_API_TOKEN=$PLAYCADEMY_API_TOKEN playcademy deploy --env staging --json
+```
+
+`deploy --json` implies non-interactive mode. On success, stdout is a single JSON
+object with fields including `slug`, `url`, `environment`, `buildHash`, and
+`backendDeployed`. On handled failures, stdout is a JSON error object and the
+process exits non-zero. Human progress output is suppressed while `--json` is
+active.
+
+For local scripts where setting `CI=1` would affect other tools, use global
+`--yes` / `-y` to answer confirmation prompts:
+
+```bash
+playcademy --yes deploy --env staging
+```
+
+`--yes` runs commands unattended: prompts never appear. Yes/no confirmations
+answer yes, while prompts that need a real value (environment selection, names,
+keys) resolve from an explicit flag or command-defined non-interactive fallback
+or fail fast with instructions, so `--yes` never silently answers a question
+that isn't yes/no. For example, `playcademy --yes deploy` with credentials for
+multiple environments and no `--env` fails fast asking for one rather than
+guessing. When `CI` is also set, CI's auto-defaults (like the staging
+environment fallback) take precedence, so adding `-y` to an existing pipeline
+never changes what it deploys.
+
+Prefer `--dry-run` in CI before enabling real deploys, especially when changing
+config or backend resources:
+
+```bash
+playcademy deploy --env staging --dry-run --json
+```
+
+Example GitHub Actions workflow:
+
+```yaml
+name: Deploy Playcademy
+
+on:
+    push:
+        branches: [main]
+
+jobs:
+    deploy:
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+            - uses: oven-sh/setup-bun@v2
+            - run: bun install --frozen-lockfile
+            - run: bun run build
+            - run: playcademy deploy --env production --json
+              env:
+                  CI: '1'
+                  PLAYCADEMY_API_TOKEN: ${{ secrets.PLAYCADEMY_API_TOKEN }}
+```
+
 ## Configuration Files
 
 The CLI supports multiple configuration formats:

package/dist/bucket.js

@@ -315,6 +315,15 @@ var TIMEBACK_DISCREPANCY_QUEUE_METRIC_VALUES = new Set(TIMEBACK_DISCREPANCY_QUEU
 // src/lib/core/import.ts
 import * as esbuild from "esbuild";
 
+// src/lib/core/prompts.ts
+import {
+  checkbox as inquirerCheckbox,
+  confirm as inquirerConfirm,
+  input as inquirerInput,
+  password as inquirerPassword,
+  select as inquirerSelect
+} from "@inquirer/prompts";
+
 // src/lib/core/transpile.ts
 import * as esbuild2 from "esbuild";