@farthershore/cli 0.33.5 → 0.33.6
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 +14 -8
- package/dist/index.js +79 -79
- package/dist/mcp.js +46 -45
- package/package.json +4 -4
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.33.
|
|
6
|
+
**Status: `0.33.6`.** 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,
|
|
@@ -21,19 +21,19 @@ the explicitly agent-operable subset of the CLI surface.
|
|
|
21
21
|
## Install
|
|
22
22
|
|
|
23
23
|
```bash
|
|
24
|
-
npm install -g @farthershore/cli@0.33.
|
|
24
|
+
npm install -g @farthershore/cli@0.33.6
|
|
25
25
|
```
|
|
26
26
|
|
|
27
27
|
Or run it directly with npx:
|
|
28
28
|
|
|
29
29
|
```bash
|
|
30
|
-
npx -p @farthershore/cli@0.33.
|
|
30
|
+
npx -p @farthershore/cli@0.33.6 farthershore --help
|
|
31
31
|
```
|
|
32
32
|
|
|
33
33
|
The package also ships an MCP stdio server for agents:
|
|
34
34
|
|
|
35
35
|
```bash
|
|
36
|
-
npx -p @farthershore/cli@0.33.
|
|
36
|
+
npx -p @farthershore/cli@0.33.6 farthershore-mcp
|
|
37
37
|
```
|
|
38
38
|
|
|
39
39
|
## Authentication
|
|
@@ -591,7 +591,13 @@ Bootstrap and rotation return a key once. `login` sends the 60-second,
|
|
|
591
591
|
single-use handoff only in the browser URL fragment to the platform-owned
|
|
592
592
|
`/persona-sign-in` bridge. The bridge establishes an HttpOnly browser session
|
|
593
593
|
and returns to the exact original portal path, query, and fragment. CLI output
|
|
594
|
-
contains portal metadata but never the handoff or a session bearer.
|
|
594
|
+
contains portal metadata but never the handoff or a session bearer. `login`
|
|
595
|
+
emits `opened: true` only after the system browser launcher (`open` /
|
|
596
|
+
`xdg-open`) has exited successfully, so the URL has been handed off before the
|
|
597
|
+
command returns; a launcher failure is reported as an error. The wait is capped
|
|
598
|
+
at 20 seconds: a launcher still running then (for example `xdg-open` running
|
|
599
|
+
the browser in the foreground) is detached, and `login` emits `opened: false`
|
|
600
|
+
with a stderr notice instead of hanging until the browser closes. Product
|
|
595
601
|
role keys must already exist in that subscriber's role catalog; omit `--role` to use its
|
|
596
602
|
configured default. Deletion tears down the temporary user and credential, and
|
|
597
603
|
deleting the environment also removes the remaining persona-owned workspace.
|
|
@@ -774,18 +780,18 @@ Use `--all-plans` to clear plan scoping.
|
|
|
774
780
|
Install or refresh the platform-verified skills bundle together. The platform
|
|
775
781
|
pins this immutable release, and CI plus a daily repository check compare it to
|
|
776
782
|
GitHub's latest stable release so the guidance cannot silently drift.
|
|
777
|
-
This command requires `@farthershore/cli` 0.33.
|
|
783
|
+
This command requires `@farthershore/cli` 0.33.6 or newer.
|
|
778
784
|
|
|
779
785
|
```bash
|
|
780
786
|
set -euo pipefail
|
|
781
787
|
CLI_VERSION=$(farthershore --version)
|
|
782
|
-
printf '%s' "$CLI_VERSION" | node -e 'let v=""; process.stdin.on("data", c => v += c).on("end", () => { const m = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(?:\+[0-9A-Za-z.-]+)?$/.exec(v.trim()); if (!m || !(+m[1] > 0 || +m[2] > 33 || (+m[2] === 33 && +m[3] >=
|
|
788
|
+
printf '%s' "$CLI_VERSION" | node -e 'let v=""; process.stdin.on("data", c => v += c).on("end", () => { const m = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(?:\+[0-9A-Za-z.-]+)?$/.exec(v.trim()); if (!m || !(+m[1] > 0 || +m[2] > 33 || (+m[2] === 33 && +m[3] >= 6))) { console.error("Stop: CLI 0.33.6 or newer is required; ask the human to upgrade."); process.exitCode = 1; } })'
|
|
783
789
|
farthershore skills install --help
|
|
784
790
|
farthershore skills install
|
|
785
791
|
```
|
|
786
792
|
|
|
787
793
|
If either prerequisite fails, stop and ask the human to run
|
|
788
|
-
`npm install -g @farthershore/cli@0.33.
|
|
794
|
+
`npm install -g @farthershore/cli@0.33.6`, then repeat the checks.
|
|
789
795
|
Do not install or upgrade global tooling autonomously.
|
|
790
796
|
|
|
791
797
|
The Farther Shore CLI downloads the exact installer archive and verifies this
|