@farthershore/cli 0.46.0 → 0.47.0

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/CHANGELOG.md CHANGED
@@ -4,6 +4,16 @@ All notable changes to the `farthershore` CLI are documented here. The CLI
4
4
  versions independently from the SDKs. Pre-1.0: minor versions may include
5
5
  breaking changes. Releases before 0.35.0 are recorded only in the git history.
6
6
 
7
+ ## [0.47.0] - 2026-11-21
8
+
9
+ ### Added
10
+
11
+ - `farthershore validate` checks your frontend against what your business sells before a build refuses it: a paid plan needs a way to cancel, a metered product needs a usage view, and so on. It reads `frontend/src` on your machine and sends nothing anywhere. A gap is reported as `FRONTEND_DEPENDENCY_MISSING` with the page or control to add.
12
+
13
+ ### Removed
14
+
15
+ - **Breaking:** Removed `business update --usage-unit-label` and `--clear-usage-unit-label`. A credit usage unit's customer-facing name is now declared in the business program: `fs.usageUnit.credits("tokens", { display: "Tokens" })`. Change it there and release.
16
+
7
17
  ## [0.46.0] - 2026-11-21
8
18
 
9
19
  ### Added
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
  Create and operate [FartherShore](https://farthershore.com) software businesses
4
4
  from the terminal.
5
5
 
6
- **Status: `0.46.0`.** Pre-1.0 — the command surface is stable but may still
6
+ **Status: `0.47.0`.** Pre-1.0 — the command surface is stable but may still
7
7
  change between minor versions. Pin an exact version in CI.
8
8
 
9
9
  FartherShore lets you define a software business as code, then sells, meters,
@@ -20,13 +20,13 @@ takes `--format json` for non-interactive scripting.
20
20
  ## Install
21
21
 
22
22
  ```bash
23
- npm install -g @farthershore/cli@0.46.0
23
+ npm install -g @farthershore/cli@0.47.0
24
24
  ```
25
25
 
26
26
  Or run it directly with npx:
27
27
 
28
28
  ```bash
29
- npx -p @farthershore/cli@0.46.0 farthershore --help
29
+ npx -p @farthershore/cli@0.47.0 farthershore --help
30
30
  ```
31
31
 
32
32
  ## Authentication
@@ -597,9 +597,11 @@ with placeholder data and auth bypassed.
597
597
  A build is published only when its output ships the SDK's managed sign-in.
598
598
  A refused build never replaces what is live; `frontend status` shows the
599
599
  reason, and `builds[].diagnostics[].code` is `FRONTEND_SIGN_IN_MISSING` (mount
600
- `<FartherShoreRoot>` and render `<FsSignIn />`) or `FRONTEND_SDK_TOO_OLD`
601
- (upgrade `@farthershore/farthershore-js`). `--wait` exits `BUILD_FAILED` with
602
- that code in `details.reasonCode`. Mock mode is for this local preview only: a
600
+ `<FartherShoreRoot>` and render `<FsSignIn />`), `FRONTEND_SDK_TOO_OLD`
601
+ (upgrade `@farthershore/farthershore-js`) or `FRONTEND_DEPENDENCY_MISSING`
602
+ (the frontend leaves out a piece your customers need: one entry per piece,
603
+ each with its fix; `farthershore validate` finds them before you push).
604
+ `--wait` exits `BUILD_FAILED` with that code in `details.reasonCode`. Mock mode is for this local preview only: a
603
605
  hosted portal ignores it, and always uses the platform's sign-in.
604
606
 
605
607
  ```bash
@@ -889,7 +891,7 @@ farthershore skills install
889
891
  ```
890
892
 
891
893
  If the platform-owned skills installer is unavailable, stop and ask the human to run
892
- `npm install -g @farthershore/cli@0.46.0`, then repeat the installer help check.
894
+ `npm install -g @farthershore/cli@0.47.0`, then repeat the installer help check.
893
895
  The CLI keeps itself current (see Staying up to date); do not otherwise install
894
896
  or upgrade global tooling autonomously.
895
897
 
@@ -1137,16 +1139,9 @@ methods without arguments), and `required` lists top-level required field names.
1137
1139
  `farthershore docs search "secret key"` uses docs search and falls back to
1138
1140
  literal text when unavailable. `--literal` or `--collection` forces literal search.
1139
1141
 
1140
- Rename a usage unit for display without changing reporting keys or balances:
1141
-
1142
- ```sh
1143
- farthershore business update <business> --usage-unit-label "Requests"
1144
- farthershore business update <business> --clear-usage-unit-label
1145
- ```
1146
-
1147
- The same operation is available to MCP as `fs.businesses.brand.update` with
1148
- `body.usageUnitLabel: { unitKey: "credits:tokens", label: "Requests" }`.
1149
- Use `label: null` to restore the default.
1142
+ A credit usage unit's customer-facing name is declared in the business
1143
+ program, not set here: `fs.usageUnit.credits("tokens", { display: "Requests" })`.
1144
+ Change it and release; reporting keys and balances do not change.
1150
1145
 
1151
1146
  ### Export your data
1152
1147