@farthershore/cli 0.24.2 → 0.24.3

package/README.md

@@ -3,7 +3,7 @@
 Create and operate [FartherShore](https://farthershore.com) software businesses
 from the terminal.
 
-**Status: `0.24.2`.** Pre-1.0 — the command surface is stable but may still
+**Status: `0.24.3`.** Pre-1.0 — the command surface is stable but may still
 change between minor versions. Pin an exact version in CI.
 
 FartherShore lets you define a software business as code, then sells, meters,
@@ -80,7 +80,7 @@ cd weather-api
 # ...edit business/business.ts with @farthershore/business...
 
 # 3. Validate the same way the PR check will, before pushing
-farthershore preflight --business weather-api
+farthershore validate --business weather-api
 
 # 4. Push — the GitHub bot compiles + applies your manifest
 git push --set-upstream origin feature/pricing
@@ -155,6 +155,23 @@ specific shape; omitting it keeps the default `frontend + api` starter. Run
 `npm install` in `business/`, then `farthershore build` from the repo root to
 confirm it compiles.
 
+### `farthershore create`
+
+Create local project components inside a managed builder repo. `create api`
+scaffolds a starter backend into `api/` by downloading the public Node template
+tarball, then patches the repo root `.gitignore`.
+
+```bash
+farthershore create api
+farthershore create api --path ../weather-api
+farthershore create api --force
+farthershore create api --node --ref v0.1.0 --format json
+```
+
+`--node` is the default language today: Node (TypeScript + Express). `--ref`
+accepts a template tag or branch name, trying tags first. More languages are
+planned.
+
 ### `farthershore build`
 
 Compile `business/business.ts` to a Manifest IR envelope locally (default
@@ -168,7 +185,7 @@ farthershore build --entry business/business.ts --out business-build.json
 farthershore build --format json
 ```
 
-### `farthershore preflight`
+### `farthershore validate`
 
 Run the same verdict the GitHub `farthershore/validate` PR check produces, before
 you push. It builds the manifest twice and compares the IR hash (the determinism
@@ -177,9 +194,9 @@ IR for a server dry-run that returns compile diagnostics, the semantic diff, and
 an economic-change verdict.
 
 ```bash
-farthershore preflight                       # local build + determinism only
-farthershore preflight --business weather-api # + full server verdict
-farthershore preflight --local-only --format json
+farthershore validate                       # local build + determinism only
+farthershore validate --business weather-api # + full server verdict
+farthershore validate --local-only --format json
 ```
 
 ### `farthershore business`
@@ -280,7 +297,9 @@ farthershore plan migrate weather-api pro --from 1 --to head --policy next_renew
 Managed Frontend Hosting operations plus a local preview. `deploy`, `status`,
 `rollback`, and `env` operate the hosted build; `preview` runs the generated
 `frontend/`'s `vite dev` with an injected `window.__FS_CONFIG__` shim so the
-portal renders locally exactly as it serves in production.
+portal renders locally exactly as it serves in production. Pass `--mock` to
+inject `{ mock: true }` instead of Core/Clerk config for local page inspection
+with placeholder data and auth bypassed.
 
 ```bash
 farthershore frontend status weather-api --format json
@@ -290,6 +309,9 @@ farthershore frontend env list weather-api --format json
 farthershore frontend env set weather-api VITE_PUBLIC_FOO bar --target BUILD --format json
 
 # Local preview (shells out to vite; needs a frontend/ project)
+farthershore frontend dev                            # hot-reloading dev server, mock mode by default
+farthershore frontend preview                        # production build served as-is, mock mode by default
+farthershore frontend dev --live                     # against the real platform
 farthershore frontend preview --core-url http://localhost:8787
 ```
 
@@ -508,7 +530,7 @@ without parsing text:
 The CLI is non-interactive whenever a token is available via `--token` or
 `FARTHERSHORE_TOKEN` — `auth login` only prompts when stdin is a TTY and no token
 was passed, so it is safe to script. `farthershore build` and `farthershore
-preflight --local-only` need no network or auth and are safe to run in CI.
+validate --local-only` need no network or auth and are safe to run in CI.
 
 ## MCP server