@farthershore/cli 0.14.3 → 0.14.5

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                                                |
 
@@ -343,6 +344,65 @@ export async function POST(request: Request) {
 }
 ```
 
+### `farthershore webhook`
+
+Provision outbound webhook endpoints and inspect delivery health. The dashboard
+exposes the same API-managed surface. If the business declares webhooks in
+`business/business.config.ts`, Core returns `409 MANAGED_BY_CODE` for writes so
+the repo remains canonical.
+
+```bash
+farthershore webhook list weather-api --format json
+farthershore webhook create weather-api \
+  --url https://hooks.example.com/farthershore \
+  --events subscription.created,payment.failed \
+  --format json
+farthershore webhook update weather-api <webhookId> --disable --format json
+farthershore webhook test weather-api <webhookId> --format json
+farthershore webhook deliveries weather-api <webhookId> --limit 20 --format json
+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
@@ -561,6 +621,11 @@ operation registry that generates the CLI command groups. Tool names use the
 - Backends: `fs_backend_list`, `fs_backend_create`, `fs_backend_delete`
 - Runtime tokens: `fs_runtime_token_list`, `fs_runtime_token_mint`,
   `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`
 - Personas: `fs_persona_bootstrap`, `fs_persona_list`, `fs_persona_revoke`
 - Usage and maker tokens: `fs_usage_read`, `fs_maker_token_list`