@farthershore/cli 0.14.4 → 0.14.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -76,6 +76,7 @@ farthershore skills recommend --format json \
76
76
  | `--api-url <url>` | Override platform Core API URL |
77
77
  | `--env <environment>` | Environment scope (use `production`/`prod`/`main`) |
78
78
  | `--format <format>` | `json` for machine-readable output (default for non-TTY) |
79
+ | `--no-input` | Never prompt; use non-interactive agent-safe paths |
79
80
  | `--version` | Show version |
80
81
  | `--help` | Show help |
81
82
 
@@ -365,6 +366,43 @@ farthershore webhook delete weather-api <webhookId> --yes --format json
365
366
  `webhook create` returns the signing secret once. Store it in the receiving app;
366
367
  subsequent list/delivery commands never return the secret.
367
368
 
369
+ ### `farthershore promo-code`
370
+
371
+ Manage checkout promo codes. Promo codes are API-controlled operational state,
372
+ not part of `business/business.config.ts`, so agents can manage them through the
373
+ CLI just like the dashboard.
374
+
375
+ ```bash
376
+ farthershore promo-code list weather-api --format json
377
+ farthershore promo-code create weather-api \
378
+ --code LAUNCH25 \
379
+ --kind percent_off \
380
+ --percent 25 \
381
+ --duration-months 3 \
382
+ --plan <planId> \
383
+ --format json
384
+ farthershore promo-code create weather-api \
385
+ --code SAVE500 \
386
+ --kind amount_off \
387
+ --amount-cents 500 \
388
+ --duration-months 1 \
389
+ --format json
390
+ farthershore promo-code update weather-api <promoCodeId> \
391
+ --code LAUNCH30 \
392
+ --kind percent_off \
393
+ --percent 30 \
394
+ --duration-months 3 \
395
+ --all-plans \
396
+ --format json
397
+ farthershore promo-code archive weather-api <promoCodeId> --format json
398
+ farthershore promo-code reactivate weather-api <promoCodeId> --format json
399
+ ```
400
+
401
+ Stripe coupon changes require a complete discount spec, so `promo-code update`
402
+ requires `--kind`, `--duration-months`, and the required amount flag for that
403
+ kind whenever you change code, amount, dates, plan scope, or redemption limits.
404
+ Use `--all-plans` to clear plan scoping.
405
+
368
406
  ### `farthershore connect`
369
407
 
370
408
  GitHub OAuth and Stripe Connect flows are browser-only. These commands
@@ -585,6 +623,9 @@ operation registry that generates the CLI command groups. Tool names use the
585
623
  `fs_runtime_token_rotate`, `fs_runtime_token_revoke`
586
624
  - Webhooks: `fs_webhook_list`, `fs_webhook_create`, `fs_webhook_update`,
587
625
  `fs_webhook_delete`, `fs_webhook_test`, `fs_webhook_deliveries`
626
+ - Promo codes: `fs_promo_code_list`, `fs_promo_code_create`,
627
+ `fs_promo_code_update`, `fs_promo_code_archive`,
628
+ `fs_promo_code_reactivate`
588
629
  - Personas: `fs_persona_bootstrap`, `fs_persona_list`, `fs_persona_revoke`
589
630
  - Usage and maker tokens: `fs_usage_read`, `fs_maker_token_list`
590
631