@farthershore/cli 0.9.1 → 0.9.2

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
@@ -101,9 +101,10 @@ manifest compiles.
101
101
 
102
102
  ### `farthershore build`
103
103
 
104
- Build a product-as-code `product/product.config.ts` with the repo-local
105
- `./node_modules/.bin/farthershore-manifest-build` binary. The command
106
- emits a Manifest IR envelope to `manifest-ir.json` by default.
104
+ Build a product-as-code `product/product.config.ts` with the Product SDK
105
+ manifest builder. The CLI first uses the builder installed under `product/`,
106
+ then falls back to a root install. The command emits a Manifest IR envelope to
107
+ `manifest-ir.json` by default.
107
108
 
108
109
  ```bash
109
110
  farthershore build
@@ -113,11 +114,17 @@ farthershore build --format json
113
114
  # Optional dry-run compile against core after the local build succeeds
114
115
  farthershore build --validate weather-api --format json
115
116
  farthershore build --validate weather-api --env preview --format json
117
+
118
+ # Apply the accepted lifecycle state through core without relying on GitHub
119
+ farthershore build --apply weather-api --format json
120
+ farthershore build --apply weather-api --env preview --format json
116
121
  ```
117
122
 
118
123
  ### `farthershore product`
119
124
 
120
- Product lifecycle commands direct API, no local manifest upload flow.
125
+ Product lifecycle commands. Creation requires a connected GitHub account because
126
+ Farther Shore always provisions the editable `frontend/` starter repo for a new
127
+ product.
121
128
 
122
129
  ```bash
123
130
  farthershore product list --format json
@@ -149,11 +156,15 @@ farthershore product compile weather-api --branch env/preview --format json
149
156
  ```
150
157
 
151
158
  `product create` provisions a managed GitHub repo and returns clone-URL +
152
- agent bootstrap instructions in the response. Plan pricing lives on the
153
- plan (see `farthershore plan create` below) the product itself no
154
- longer carries a `billingStrategy`. Omitting both meter flags gives the
155
- product a `requests` meter; variable-value meters (tokens, credits, spend)
156
- are settled from upstream `x-fs-cost-{key}` response headers.
159
+ agent bootstrap instructions in the response. That repo is required for the
160
+ starter `frontend/` project and normal customization workflow. Product SDK
161
+ changes can be validated with `farthershore build --validate` and applied to the
162
+ repo-backed product with `farthershore build --apply`.
163
+
164
+ Plan pricing lives on the plan (see `farthershore plan create` below) — the
165
+ product itself no longer carries a `billingStrategy`. Omitting both meter flags
166
+ gives the product a `requests` meter; variable-value meters (tokens, credits,
167
+ spend) are settled from upstream `x-fs-cost-{key}` response headers.
157
168
 
158
169
  A new product starts as a DRAFT with a generated `frontend/` project ready for
159
170
  customization. Going live mirrors the dashboard's "Finish setting up" checklist: