diff --git a/README.md b/README.md index 2c372796..4636c224 100644 --- a/README.md +++ b/README.md @@ -90,9 +90,9 @@ rc charts show mrr | **Customers** | `show` · `list` · `grant` · `revoke` · `transfer` · `aliases` · `attributes` · `simulate-purchase` | | **Subscriptions** | `show` · `cancel` · `extend` · `refund` · `transactions` | | **Entitlements** | `list` · `show` · `create` · `update` · `attach` · `detach` | -| **Offerings** | `list` · `show` · `verify` · `preview` · `create` · `update` · `set-current` · `archive` | -| **Packages** | `list` (across all offerings) · `show` · `products` · `create` · `update` · `delete` · `attach` · `detach` | -| **Products** | `list` · `show` · `create` · `archive` · `restore` · `delete` · `store sync` | +| **Offerings** | `list` · `show` · `verify` · `preview` · `create` · `update` · `set-current` · `archive` · `restore` · `delete` | +| **Packages** | `list` (across offerings) · `show` · `products` · `create` · `update` · `delete` · `attach` · `detach` | +| **Products** | `list` · `show` · `create` · `update` · `archive` · `restore` · `delete` · `push` · `prices` / `prices set` · `store sync` | | **Paywalls** | `list` · `show` · `create` · `generate` (AI) · `edit` (AI) · `rewind` · `publish` · `unpublish` · `attach` · `detach` · `delete` | | **Rico (AI assistant)** | `rico` (streaming chat, tool approvals) · `conversations list/show/delete` · `feedback` | | **Charts & metrics** | Interactive bar/line charts · daily/weekly/monthly/quarterly/yearly | @@ -126,8 +126,9 @@ dashboard paywall. ### Product store-state plans (experimental) -Manage your App Store / Google Play catalog as a reviewable plan: describe the -desired state, review the computed diff, then apply it. +Manage your store product catalog as a reviewable plan: describe the desired +state, review the computed diff, then apply it. The server decides which +stores and fields it supports; App Store and Google Play are the most complete. ```bash rc products store sync app_abc # interactive: review, then apply diff --git a/docs/command-surface.md b/docs/command-surface.md index 348069db..752481f8 100644 --- a/docs/command-surface.md +++ b/docs/command-surface.md @@ -59,7 +59,7 @@ refund_rate, revenue, subscription_retention, subscription_status, trial_conversion_rate, trials, trials_movement, trials_new ``` -CLI surface: `rc charts ` should validate against this enum and offer +CLI surface: `rc charts show ` should validate against this enum and offer shell completion. `rc charts list` is a static command that prints these names; there's no list endpoint. @@ -70,6 +70,7 @@ names; there's no list endpoint. rc setup # one-shot agent-driven bootstrap; featured in --help/home/README, runs non-interactively for the prompt rc setup google [app-id] # experimental (hidden from --help until the Google OAuth consent screen is verified): local Google sign-in, bootstrap the Play service-account credential, grant package-scoped access, upload to RC rc setup apple [app-id] # interactive: App Store Connect sign-in + 2FA, create/upload IAP & ASC keys, vendor number (rc apps apple setup is a hidden alias) +rc capital setup [app-id] # experimental: RevenueCat Capital onboarding — the same guided Apple credential flow under the product's name rc # bare rc -> getting-started help; --all reveals experimental commands # Auth / meta @@ -79,6 +80,7 @@ rc auth logout # clears credentials fr rc auth status # show auth state plus cached account identity; auth whoami and root rc whoami are aliases rc commands # agent discovery (tree) rc schema # agent discovery (flags) +rc api # raw v2 request escape hatch for endpoints the surface doesn't cover; --body for payloads rc skills install # install the core skills globally for RC-supported agents without a picker; --agent overrides rc skills prompts # show copy-ready starter prompts; --json returns prompts for agent UIs rc open [section] [id] # open the dashboard deep-linked to the active project (uses existing browser session) @@ -111,11 +113,11 @@ rc apps apple check [app-id] # validate Apple login, rc apps apple setup [app-id] # hidden alias of rc setup apple (kept for back-compat) # Customers — busiest noun -rc customers show [id] # embeds active_entitlements +rc customers show # embeds active_entitlements rc customers list rc customers aliases rc customers attributes # GET all subscriber attributes -rc customers set-attribute # set a single subscriber attribute +rc customers set-attribute --set = # set subscriber attributes (--set is repeatable) rc customers grant [--duration ...] rc customers revoke rc customers transfer --to @@ -149,6 +151,7 @@ rc offerings delete rc offerings archive rc offerings restore rc offerings packages # nested resource +rc packages list # packages across offerings (first page per offering; large catalogs page via the API) rc packages show rc packages create rc packages update @@ -247,7 +250,8 @@ rc audit # /audit_logs with --li deferred because its component schema needs a purpose-built editing UX. - **No plugin system.** YAGNI; oclif model is a Node bet, not a Go one. - **No `--account` flag.** Account is implicit in the API key. -- **No bulk-import** until there's a concrete ask. +- **No generic bulk-import** (customers, catalog CRUD) until there's a concrete + ask — store-state plans' CSV/JSON input is the one deliberate exception. ## Build order diff --git a/docs/cookbook.md b/docs/cookbook.md index 432d28a1..b2fe3def 100644 --- a/docs/cookbook.md +++ b/docs/cookbook.md @@ -30,11 +30,11 @@ rc customers show cus_abc --json | jq '.data.subscriptions.items' Grant a one-month promotional entitlement: ```bash -rc customers grant --customer-id cus_abc --entitlement-id pro --duration monthly --yes +rc customers grant cus_abc entl_pro --duration monthly --yes ``` -Refund a Web Billing subscription (this is `--yes` by intent — confirmation -matters): +Refund a Web Billing subscription (no `--yes` on purpose — this one should +prompt): ```bash rc subscriptions refund sub_abc @@ -63,7 +63,7 @@ rc entitlements list --json | jq -r '.data.items[].lookup_key' Create an entitlement and immediately attach products: ```bash -rc entitlements create --lookup-key plus --display-name "Plus" --yes --json +rc entitlements create --lookup-key plus --display-name "Plus" --json rc entitlements attach plus prod_monthly prod_yearly ``` @@ -127,7 +127,7 @@ Separate staging and prod credentials cleanly: rc login --profile staging --api-key sk_staging_... rc login --profile prod --api-key sk_prod_... -rc --profile staging customer list --limit 5 +rc --profile staging customers list --limit 5 rc --profile prod metrics --json ```