@farthershore/cli 0.14.4 → 0.14.6

package/README.md

@@ -76,6 +76,7 @@ farthershore skills recommend --format json \
 | `--api-url <url>`     | Override platform Core API URL                           |
 | `--env <environment>` | Environment scope (use `production`/`prod`/`main`)       |
 | `--format <format>`   | `json` for machine-readable output (default for non-TTY) |
+| `--no-input`          | Never prompt; use non-interactive agent-safe paths       |
 | `--version`           | Show version                                             |
 | `--help`              | Show help                                                |
 
@@ -298,6 +299,22 @@ Read recent usage off the management API.
 farthershore usage summary weather-api --format json
 ```
 
+### `farthershore consumer`
+
+Manage live business users/consumers. These are API-controlled runtime actions,
+not repo-authored product behavior.
+
+```bash
+farthershore consumer list weather-api --format json
+farthershore consumer list weather-api --env preview --format json
+farthershore consumer block weather-api <subscriberId> --yes --format json
+farthershore consumer remove weather-api <subscriberId> --yes --format json
+```
+
+Use `consumer list` first to discover `subscriberId`. `block` suspends a user
+and revokes active API keys. `remove` is irreversible and tears down subscriber
+state across billing, edge credentials, and subscriptions.
+
 ### `farthershore backend`
 
 Create BYO backends and provision runtime tokens for upstream services. Core
@@ -365,6 +382,43 @@ farthershore webhook delete weather-api <webhookId> --yes --format json
 `webhook create` returns the signing secret once. Store it in the receiving app;
 subsequent list/delivery commands never return the secret.
 
+### `farthershore promo-code`
+
+Manage checkout promo codes. Promo codes are API-controlled operational state,
+not part of `business/business.config.ts`, so agents can manage them through the
+CLI just like the dashboard.
+
+```bash
+farthershore promo-code list weather-api --format json
+farthershore promo-code create weather-api \
+  --code LAUNCH25 \
+  --kind percent_off \
+  --percent 25 \
+  --duration-months 3 \
+  --plan <planId> \
+  --format json
+farthershore promo-code create weather-api \
+  --code SAVE500 \
+  --kind amount_off \
+  --amount-cents 500 \
+  --duration-months 1 \
+  --format json
+farthershore promo-code update weather-api <promoCodeId> \
+  --code LAUNCH30 \
+  --kind percent_off \
+  --percent 30 \
+  --duration-months 3 \
+  --all-plans \
+  --format json
+farthershore promo-code archive weather-api <promoCodeId> --format json
+farthershore promo-code reactivate weather-api <promoCodeId> --format json
+```
+
+Stripe coupon changes require a complete discount spec, so `promo-code update`
+requires `--kind`, `--duration-months`, and the required amount flag for that
+kind whenever you change code, amount, dates, plan scope, or redemption limits.
+Use `--all-plans` to clear plan scoping.
+
 ### `farthershore connect`
 
 GitHub OAuth and Stripe Connect flows are browser-only. These commands
@@ -585,6 +639,10 @@ operation registry that generates the CLI command groups. Tool names use the
   `fs_runtime_token_rotate`, `fs_runtime_token_revoke`
 - Webhooks: `fs_webhook_list`, `fs_webhook_create`, `fs_webhook_update`,
   `fs_webhook_delete`, `fs_webhook_test`, `fs_webhook_deliveries`
+- Promo codes: `fs_promo_code_list`, `fs_promo_code_create`,
+  `fs_promo_code_update`, `fs_promo_code_archive`,
+  `fs_promo_code_reactivate`
+- Consumers: `fs_consumer_list`, `fs_consumer_block`, `fs_consumer_remove`
 - Personas: `fs_persona_bootstrap`, `fs_persona_list`, `fs_persona_revoke`
 - Usage and maker tokens: `fs_usage_read`, `fs_maker_token_list`