@growthub/cli 0.3.46 → 0.3.48

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.
Files changed (3) hide show
  1. package/README.md +25 -3
  2. package/dist/index.js +1511 -466
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,10 +1,11 @@
1
1
  # @growthub/cli
2
2
 
3
- `@growthub/cli` is the published CLI for Growthub Local. It covers three shipped workflows:
3
+ `@growthub/cli` is the published CLI for Growthub Local. It covers four shipped workflows:
4
4
 
5
5
  - full local app discovery and onboarding
6
6
  - worker kit discovery, export, inspection, and validation
7
7
  - shared template discovery and extraction
8
+ - hosted Growthub auth + machine profile bridge
8
9
 
9
10
  ## Install
10
11
 
@@ -27,7 +28,7 @@ npx create-growthub-local --profile dx
27
28
 
28
29
  ## CLI Editions
29
30
 
30
- The current CLI exposes three user-facing editions through `growthub discover` and direct subcommands.
31
+ The current CLI exposes four user-facing editions through `growthub discover` and direct subcommands.
31
32
 
32
33
  ### 1. Full Local App
33
34
 
@@ -133,6 +134,26 @@ User flow:
133
134
  2. Preview the selected artifact.
134
135
  3. Print it, copy it to a local workspace, or use the slug in another workflow.
135
136
 
137
+ ### 4. Hosted Auth Bridge
138
+
139
+ Use this when you want the hosted Growthub account to remain the top-level identity while syncing safe local-machine metadata into the CLI runtime.
140
+
141
+ ```bash
142
+ growthub auth login
143
+ growthub auth whoami
144
+ growthub auth logout
145
+ growthub profile status
146
+ growthub profile pull
147
+ growthub profile push
148
+ ```
149
+
150
+ Contract:
151
+
152
+ 1. Hosted Growthub auth remains the source of truth for the user identity.
153
+ 2. Local workspace config stays local-first and is not overwritten by hosted state.
154
+ 3. Hosted machine linkage is stored separately from `instances/<id>/config.json`.
155
+ 4. `growthub` and `paperclipai` remain intentional side-by-side surfaces rather than auto-loading one another.
156
+
136
157
  ## Contribution Model
137
158
 
138
159
  The CLI has two extension surfaces for content:
@@ -146,7 +167,7 @@ For the agent-facing extension workflow, see [docs/CLI_TEMPLATE_CONTRIBUTION_EXT
146
167
 
147
168
  ## Development Notes
148
169
 
149
- - `@growthub/cli` version: `0.3.46`
170
+ - `@growthub/cli` version: `0.3.48`
150
171
  - Node.js: `>=20`
151
172
  - Source of truth repo: [Growthub Local](https://github.com/Growthub-ai/growthub-local)
152
173
 
@@ -154,5 +175,6 @@ For the agent-facing extension workflow, see [docs/CLI_TEMPLATE_CONTRIBUTION_EXT
154
175
 
155
176
  - [GitHub README](https://github.com/Growthub-ai/growthub-local#readme)
156
177
  - [Contributing](https://github.com/Growthub-ai/growthub-local/blob/main/CONTRIBUTING.md)
178
+ - [Growthub Authentication Bridge](https://github.com/Growthub-ai/growthub-local/blob/main/docs/GROWTHUB_AUTH_BRIDGE.md)
157
179
  - [Worker Kits](https://github.com/Growthub-ai/growthub-local/blob/main/docs/WORKER_KITS.md)
158
180
  - [CLI Template Contribution Extension Workflows](https://github.com/Growthub-ai/growthub-local/blob/main/docs/CLI_TEMPLATE_CONTRIBUTION_EXTENSION_WORKFLOWS.md)