@topolo/cli 0.1.7 → 0.1.9
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 +33 -1
- package/dist/index.js +2223 -21
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -9,7 +9,7 @@ via `stdin`/`stdout`.
|
|
|
9
9
|
- API-key authentication (long-lived, service-scoped).
|
|
10
10
|
- Access-token authentication via OAuth device flow when a CLI OAuth client id is configured.
|
|
11
11
|
- Stored access-token refresh when the config includes a refresh token and OAuth client id.
|
|
12
|
-
- Commands: `auth login/logout/status`, `whoami`, `services`, `crm contacts:list`, `crm contacts:get`, and generic `api` passthrough for SDK-registered services.
|
|
12
|
+
- Commands: `auth login/logout/status`, `whoami`, `apps`, `apps scaffold`, `services`, `crm contacts:list`, `crm contacts:get`, and generic `api` passthrough for SDK-registered services.
|
|
13
13
|
|
|
14
14
|
## Install
|
|
15
15
|
|
|
@@ -102,6 +102,38 @@ Lists every service id and effective URL known to the generated SDK registry.
|
|
|
102
102
|
topolo services --json
|
|
103
103
|
```
|
|
104
104
|
|
|
105
|
+
### `topolo apps`
|
|
106
|
+
|
|
107
|
+
Lists every Topolo application known to the generated SDK catalog, including
|
|
108
|
+
pages-only applications that do not expose a callable API service.
|
|
109
|
+
|
|
110
|
+
```bash
|
|
111
|
+
topolo apps --json
|
|
112
|
+
topolo apps get mail --json
|
|
113
|
+
topolo apps requirements mail --json
|
|
114
|
+
topolo apps audit mail --json
|
|
115
|
+
topolo apps audit mail --local --repo-root /Users/ashes/Projects/topolo --fail-on needs_review --json
|
|
116
|
+
topolo apps scaffold insights --json
|
|
117
|
+
topolo apps scaffold insights --workflow-only --no-json
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
Agents should call `topolo apps requirements <app> --json` before creating or
|
|
121
|
+
expanding a Topolo app. The output is the versioned platform contract for app
|
|
122
|
+
metadata, canonical docs, shared auth, shared shell, service registration,
|
|
123
|
+
deployment metadata, agent surfaces, observability, and verification.
|
|
124
|
+
`topolo apps audit --json` turns the same contract into per-app scores and a
|
|
125
|
+
catalog-backed migration queue. Add `--local --repo-root <topolo-checkout>` to
|
|
126
|
+
include filesystem evidence from the app repo, CloudControl metadata, and
|
|
127
|
+
TopoloDocs. Add `--fail-on needs_review` for the default new-work gate, or
|
|
128
|
+
`--fail-on partial` for strict release readiness.
|
|
129
|
+
|
|
130
|
+
`topolo apps scaffold <app>` generates the required new-application scaffold
|
|
131
|
+
manifest, including expected package/auth/shell/docs/CloudControl files and a
|
|
132
|
+
`topolo-conformance.yml` GitHub Actions workflow. The generated workflow checks
|
|
133
|
+
out the app under `PlatformApplications/<AppDir>`, checks out `Topolo-io/docs`,
|
|
134
|
+
`Topolo-io/topolo-sdk`, and `Topolo-io/TopoloCli`, builds the current CLI from
|
|
135
|
+
source, then runs the local conformance audit with `--fail-on needs_review`.
|
|
136
|
+
|
|
105
137
|
### `topolo api <service> <method> <path>`
|
|
106
138
|
|
|
107
139
|
Escape hatch for endpoints without typed modules yet.
|