@topolo/cli 0.1.23 → 0.1.25

package/README.md

@@ -108,20 +108,26 @@ topolo crm contacts:get contact_abc123
 
 ### `topolo services`
 
-Lists every service id and effective URL known to the generated SDK registry.
-In staging, `environmentSafe: false` means that service still resolves to a
-production SDK default and will be refused by `topolo api` until a staging URL
-override is configured.
+Lists the services the current credential can use in its organization, with the
+effective URL and granted permissions. This command requires a credential and
+does not expose the global platform catalog. In staging, `environmentSafe:
+false` means that service still resolves to a production URL and will be
+refused by `topolo api` until a staging URL override is configured.
 
 ```bash
 topolo services --json
 topolo services --env staging --json
 ```
 
+`topolo api` accepts the IDs/slugs returned by this credential-scoped live
+catalog. New services become usable without a CLI release once Auth grants the
+organization and credential the relevant permissions.
+
 ### `topolo apps`
 
-Lists every Topolo application known to the generated SDK catalog, including
-pages-only applications that do not expose a callable API service.
+Lists launchable Topolo applications available to the current credential. This
+uses the same live Auth catalog as `topolo services`; it is not the global
+generated application list.
 
 ```bash
 topolo apps --json
@@ -152,7 +158,7 @@ Wrangler Worker/static-assets baseline, an Auth service manifest, and a
 apps. Add `--write --repo-root <topolo-checkout>` to create the files on disk;
 existing files are refused unless `--force` is passed. The generated workflow
 checks out the app under `PlatformApplications/<AppDir>`, checks out
-`Topolo-io/docs`, `Topolo-io/topolo-sdk`, and `Topolo-io/TopoloCli`, builds the
+`Topolo-io/TopoloDocs`, `Topolo-io/topolo-sdk`, and `Topolo-io/TopoloCli`, builds the
 current CLI from source, then runs the local conformance audit with
 `--fail-on needs_review`.
 
@@ -203,8 +209,8 @@ topolo api auth GET /api/me
 topolo api crm POST /api/contacts --data '{"first":"Jane"}' --confirm
 ```
 
-Use `topolo services --json` to discover valid service ids before calling a
-service that does not have a typed command yet.
+Use `topolo services --json` to discover service ids permitted for the current
+credential before calling a service that does not have a typed command yet.
 
 ## Output modes