@rindle/cli 0.4.4 → 0.6.2

package/README.md

@@ -1,26 +1,32 @@
 # @rindle/cli — the Rindle toolchain, prebuilt for npm
 
-The Rindle **CLI** (`rindle`) and **daemon** (`rindled`), shipped as prebuilt, per-platform binaries
-you can `npm install`. This is how a JS/TS developer runs Rindle locally:
-
-- **`rindled`** — the production Rindle server: the `rindle-server` crate (the SQLite-backed
-  [`rindle-replica`](../../rindle-replica) live-query engine plus the public subscription/lease
-  plane).
-- **`rindle`** — the CLI to inspect, run, and manage a daemon: `rindle status` / `migrate` /
-  `schema`, plus the local-dev pair **`rindle init`** (scaffold) and **`rindle up`**
-  (run-and-supervise a local `rindled`, respawning it on crash or migrate-restart).
+The Rindle CLI and local fleet components ship as prebuilt, per-platform binaries you can
+`npm install`. This is how a JS/TS developer runs Rindle locally:
+
+- **`rindled`** — the Rindle **read-follower** server: the `rindle-server` crate (the
+  SQLite-backed [`rindle-replica`](../../rindle-replica) live-query engine plus the public
+  subscription/lease plane). It tails a `rindle-replicator` write-master and has no write
+  ingress of its own.
+- **`rindle`** — the CLI to inspect, run, and manage the data tier: `rindle status` / `migrate` /
+  `schema`, plus the local-dev pair **`rindle init`** (scaffold `rindle.ncl`) and **`rindle up`**
+  (render it and run-and-supervise the local write-master + follower pair, respawning on crash or
+  migrate-restart).
+- **`rindle-dev-edge`** — the development-only stable HTTP/WebSocket fleet endpoint. `rindle up`
+  supervises it automatically; applications never install or launch it directly.
 
 This is the network counterpart of [`@rindle/replica`](../replica): both run the same
 `rindle-replica` engine, but `@rindle/replica` is a napi addon that embeds it **in-process**,
-whereas `rindled` is the standalone daemon **executable** that serves many clients over the wire.
-Talk to a running daemon from JS with [`@rindle/daemon-client`](../daemon-client).
+whereas `rindled` is the daemon **executable** (a read-follower) that serves many clients over
+the wire. Talk to a running daemon from JS with [`@rindle/daemon-client`](../daemon-client).
 
 ```sh
 npm i -D @rindle/cli
-npx rindle init      # scaffold daemon.json + migrations/
+npx rindle init      # scaffold rindle.ncl (the colocated pair) + migrations/
 npx rindle up --migrate --gen shared/schema.gen.ts --watch
-# start + supervise rindled, apply migrations, regenerate the typed schema,
-# and re-run apply/gen whenever migrations/ changes
+# render rindle.ncl + supervise the write-master + follower, apply migrations to the master,
+# regenerate the typed schema from the follower, and re-run apply/gen whenever migrations/ changes
+npx rindle exec -- vite dev
+# launch the app with stable read/write/ws bindings derived from rindle.ncl
 ```
 
 Installing pulls in exactly one prebuilt-binary package for your platform via
@@ -36,14 +42,14 @@ Full docs — the command reference, flags & env vars, the local dev loop, and r
 
 ## Embedding the daemon in your own supervisor
 
-`rindled` is **not** exposed as a CLI command here — `rindle up` is the way to run a local daemon.
-The binary still ships (co-located with `rindle`), so for embedding it in your own Node supervisor
-there are programmatic helpers:
+`rindled` is **not** exposed as a CLI command here — `rindle up` is the way to run the local pair.
+The binary still ships (co-located with `rindle`), so for embedding a follower in your own Node
+supervisor there are programmatic helpers:
 
 ```ts
 import { spawnRindled, rindledBinaryPath } from "@rindle/cli";
 
-const child = spawnRindled(["--config", "./daemon.json"]); // inherits stdio
+const child = spawnRindled(["--config", "./follower.json"]); // inherits stdio
 // …or just locate the binary and manage the process yourself:
 const bin = rindledBinaryPath();
 ```
@@ -57,29 +63,29 @@ const bin = rindledBinaryPath();
   (`dist/cli.js`) resolves the matching `rindle` binary for the host and execs it, forwarding
   argv/stdio and the exit code.
 - **`@rindle/cli-<key>`** — one package per target (`darwin-arm64`, `darwin-x64`, `linux-x64-gnu`,
-  `linux-arm64-gnu`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64-msvc`), each carrying **both**
-  `rindle` and `rindled` for that platform under `bin/`,
+  `linux-arm64-gnu`, `linux-x64-musl`, `linux-arm64-musl`, `win32-x64-msvc`), each carrying
+  `rindle`, `rindled`, `rindle-replicator`, and `rindle-dev-edge` for that platform under `bin/`,
   gated by `os`/`cpu`/`libc`. They're listed as `optionalDependencies` of this package, so the
   installer fetches only the matching one. They are **generated at release time** (like the napi
   platform packages for `@rindle/replica`), never committed.
 
-Both binaries ship **co-located** on purpose: even though only `rindle` is a bin, `rindle up` runs
-`rindled` by finding it as a sibling of its own executable (rindle-cli §7.1), so the two must live in
-the same `bin/` directory.
+All four binaries ship **co-located** on purpose: even though only `rindle` is an npm bin,
+`rindle up` finds every supervised component beside its own executable.
 
 Resolution order at runtime (`src/index.ts`):
 
-1. `RINDLE_BINARY_PATH` / `RINDLED_BINARY_PATH` — explicit path to that one binary.
-2. `RINDLE_BIN_DIR` — a directory holding both (see dev usage below).
+1. The binary-specific `*_BINARY_PATH` override (`RINDLE_BINARY_PATH`, `RINDLED_BINARY_PATH`,
+   `RINDLE_REPLICATOR_BINARY_PATH`, or `RINDLE_DEV_EDGE_BINARY_PATH`).
+2. `RINDLE_BIN_DIR` — a directory holding the native toolchain (see dev usage below).
 3. the installed `@rindle/cli-<key>` optional dependency.
 
 ## Local development (in this monorepo)
 
 No platform packages are installed in the workspace, so build the binaries and point the launcher at
-the build directory — one env var lights up both (and keeps them co-located for `rindle up`):
+the build directory — one env var lights up the whole fleet:
 
 ```sh
-cargo build -p rindle-cli -p rindle-server --bin rindle --bin rindled --release
+cargo build -p rindle-cli -p rindle-server -p rindle-replicator -p rindle-dev-edge --bins --release
 RINDLE_BIN_DIR="$PWD/target/release" npx rindle up      # finds rindled in the same dir
 RINDLE_BIN_DIR="$PWD/target/release" npx rindle status
 ```
@@ -89,9 +95,8 @@ RINDLE_BIN_DIR="$PWD/target/release" npx rindle status
 
 ## Releasing
 
-The native binaries already come from dist (cargo-dist): `rindle-cli` and `rindle-server` are both
-`[package.metadata.dist] dist = true`, so dist builds `rindle` and `rindled` for all four targets
-and uploads the archives + `dist-manifest.json` to a GitHub release.
+The native binaries come from dist (cargo-dist): all four binary crates opt into dist, which uploads
+their archives plus `dist-manifest.json` to a GitHub release.
 `scripts/build-npm-packages.mjs` is the bridge from those artifacts to npm:
 
 ```sh

package/dist/index.d.ts

@@ -3,13 +3,12 @@ import { type Binary } from "./platform.ts";
 export { binaryName, platformKey, platformPackageName, UnsupportedPlatformError, } from "./platform.ts";
 export type { Binary, Libc } from "./platform.ts";
 /**
- * Absolute path to a Rindle binary (`"rindle"` or `"rindled"`) for the current platform.
+ * Absolute path to a native Rindle toolchain binary for the current platform.
  *
- * Resolution order (the first three are dev overrides for working in this monorepo):
- *  1. `RINDLE_BINARY_PATH` / `RINDLED_BINARY_PATH` — an explicit path to that one binary.
- *  2. `RINDLE_BIN_DIR` — a directory holding both binaries. Point it at `target/release` after
- *     `cargo build -p rindle-cli -p rindle-server --release` and a single env var lights up both
- *     (and keeps them co-located, so `rindle up` still finds `rindled` as a sibling).
+ * Resolution order:
+ *  1. The binary's explicit `*_BINARY_PATH` override.
+ *  2. `RINDLE_BIN_DIR` — a directory holding the co-located toolchain. Point it at
+ *     `target/release` after building the four binary crates and one env var lights up the fleet.
  *  3. The matching `@rindle/cli-<key>` optional dependency that npm/pnpm installed.
  *
  * Throws `UnsupportedPlatformError` for an un-targeted host, or a descriptive Error if the

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAS,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKjF,OAAO,EAKL,KAAK,MAAM,EACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAIlD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA8B9C;AAED,iGAAiG;AACjG,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,qGAAqG;AACrG,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,YAAY,CAEtG;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,IAAI,GAAE,MAAM,EAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,YAAY,CAEzF;AAED,8GAA8G;AAC9G,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAM,EAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,YAAY,CAE1F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAS,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKjF,OAAO,EAKL,KAAK,MAAM,EACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAIlD;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoC9C;AAED,iGAAiG;AACjG,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,qGAAqG;AACrG,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,YAAY,CAEtG;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,IAAI,GAAE,MAAM,EAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,YAAY,CAEzF;AAED,8GAA8G;AAC9G,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAM,EAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,YAAY,CAE1F"}

package/dist/index.js

@@ -1,14 +1,15 @@
-// @rindle/cli — the Rindle toolchain (`rindle` CLI + `rindled` daemon) as prebuilt npm binaries.
+// @rindle/cli — the Rindle CLI and supervised local-fleet components as prebuilt npm binaries.
 //
 // `rindled` is the *network front* of the engine: the `rindle-server` crate — the SQLite-backed
 // `rindle-replica` live-query engine plus the public subscription/lease plane. `rindle` is the CLI
 // that inspects and manages a deployed daemon (`rindle status`/`migrate`/…) and, for local dev,
 // scaffolds and supervises one (`rindle init` / `rindle up`). Where `@rindle/replica` is a napi
 // addon that embeds the engine *in-process*, this package ships the standalone executables,
-// prebuilt per platform by dist (cargo-dist), **co-located** so `rindle up` finds `rindled` beside
-// it. This module resolves the right binary for the host; the `rindle` bin (dist/cli.js) execs the
-// CLI, and the daemon runs via `rindle up` or `spawnRindled()` (it is not exposed as its own bin —
-// this package is a dev convenience). Pair with `@rindle/daemon-client` to talk to a running daemon.
+// prebuilt per platform by dist (cargo-dist), **co-located** so `rindle up` finds every component
+// beside it. This module resolves the right binary for the host; the `rindle` bin (dist/cli.js)
+// execs the CLI, and the daemon runs via `rindle up` or `spawnRindled()` (it is not exposed as its
+// own bin — this package is a dev convenience). Pair with `@rindle/daemon-client` to talk to a
+// running daemon.
 import { spawn } from "node:child_process";
 import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
@@ -17,13 +18,12 @@ import { binaryName, platformKey, platformPackageName, UnsupportedPlatformError,
 export { binaryName, platformKey, platformPackageName, UnsupportedPlatformError, } from "./platform.js";
 const require = createRequire(import.meta.url);
 /**
- * Absolute path to a Rindle binary (`"rindle"` or `"rindled"`) for the current platform.
+ * Absolute path to a native Rindle toolchain binary for the current platform.
  *
- * Resolution order (the first three are dev overrides for working in this monorepo):
- *  1. `RINDLE_BINARY_PATH` / `RINDLED_BINARY_PATH` — an explicit path to that one binary.
- *  2. `RINDLE_BIN_DIR` — a directory holding both binaries. Point it at `target/release` after
- *     `cargo build -p rindle-cli -p rindle-server --release` and a single env var lights up both
- *     (and keeps them co-located, so `rindle up` still finds `rindled` as a sibling).
+ * Resolution order:
+ *  1. The binary's explicit `*_BINARY_PATH` override.
+ *  2. `RINDLE_BIN_DIR` — a directory holding the co-located toolchain. Point it at
+ *     `target/release` after building the four binary crates and one env var lights up the fleet.
  *  3. The matching `@rindle/cli-<key>` optional dependency that npm/pnpm installed.
  *
  * Throws `UnsupportedPlatformError` for an un-targeted host, or a descriptive Error if the
@@ -31,10 +31,16 @@ const require = createRequire(import.meta.url);
  * publish didn't target) and no override is set.
  */
 export function binaryPath(bin) {
-    const explicit = process.env[`${bin.toUpperCase()}_BINARY_PATH`];
+    const explicitName = {
+        rindle: "RINDLE_BINARY_PATH",
+        rindled: "RINDLED_BINARY_PATH",
+        "rindle-replicator": "RINDLE_REPLICATOR_BINARY_PATH",
+        "rindle-dev-edge": "RINDLE_DEV_EDGE_BINARY_PATH",
+    };
+    const explicit = process.env[explicitName[bin]];
     if (explicit) {
         if (!existsSync(explicit)) {
-            throw new Error(`${bin.toUpperCase()}_BINARY_PATH points at a missing file: ${explicit}`);
+            throw new Error(`${explicitName[bin]} points at a missing file: ${explicit}`);
         }
         return explicit;
     }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/platform.d.ts

@@ -1,6 +1,6 @@
 export type Libc = "gnu" | "musl";
-/** A Rindle binary shipped by this toolchain: the CLI (`rindle`) or the daemon (`rindled`). */
-export type Binary = "rindle" | "rindled";
+/** A native binary shipped by the Rindle development toolchain. */
+export type Binary = "rindle" | "rindled" | "rindle-replicator" | "rindle-dev-edge";
 /**
  * The package-name suffix identifying a build target for the current (or given) host:
  * `darwin-{arm64,x64}`, `linux-{x64,arm64}-{gnu,musl}`, `win32-x64-msvc`. Throws

package/dist/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;AAElC,+FAA+F;AAC/F,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1C;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,IAAI,GAAE,MAAqB,EAC3B,IAAI,GAAE,IAA2B,GAChC,MAAM,CAWR;AAED,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAEvE;AAED,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,MAAM,CAE5F;AAED,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAI3C"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;AAElC,mEAAmE;AACnE,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAEpF;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,IAAI,GAAE,MAAqB,EAC3B,IAAI,GAAE,IAA2B,GAChC,MAAM,CAcR;AAED,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAEvE;AAED,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,MAAM,CAE5F;AAED,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAY3C"}

package/dist/platform.js

@@ -1,11 +1,13 @@
 // Single source of truth for mapping the *running* Node platform to the per-platform package that
-// carries the prebuilt Rindle binaries (`rindle` + `rindled`) for it. Those packages
-// (`@rindle/cli-<key>`) are generated at release time by `scripts/build-npm-packages.mjs` from
-// dist's (cargo-dist) release archives, and declared as optionalDependencies of this umbrella
-// package — so npm/pnpm install only the one whose `os`/`cpu` match the host. Both binaries ship
+// carries the prebuilt Rindle binaries (`rindle`, `rindled`, `rindle-replicator`, and the local
+// `rindle-dev-edge`) for it. Those
+// packages (`@rindle/cli-<key>`) are generated at release time by `scripts/build-npm-packages.mjs`
+// from dist's (cargo-dist) release archives, and declared as optionalDependencies of this umbrella
+// package — so npm/pnpm install only the one whose `os`/`cpu` match the host. All binaries ship
 // **co-located** in that one package's `bin/`, which is required: the `rindle` CLI's `rindle up`
-// finds `rindled` as a sibling of its own executable (rindle-cli §7.1). This module and the
-// generator MUST agree on the `<key>` scheme; it is defined here and mirrored in the generator.
+// finds every component as a sibling of its own executable (rindle-cli §7.1) so it can supervise
+// the local topology. This module and the generator MUST agree on the `<key>`
+// scheme; it is defined here and mirrored in the generator.
 /**
  * The package-name suffix identifying a build target for the current (or given) host:
  * `darwin-{arm64,x64}`, `linux-{x64,arm64}-{gnu,musl}`, `win32-x64-msvc`. Throws
@@ -17,8 +19,11 @@ export function platformKey(platform = process.platform, arch = process.arch, li
             return `darwin-${arch}`;
         case "linux":
             return `linux-${arch}-${libc}`;
-        case "win32":
-            return `win32-${arch}-msvc`;
+        // `win32` is deliberately absent, and must stay in step with `"rindle".targets` in
+        // package.json: we publish no Windows binaries, so returning a key here would only trade this
+        // actionable error for a MODULE_NOT_FOUND on a package that was never published. Restoring
+        // Windows means re-adding the target there AND a `case "win32"` here — see
+        // follow-ups/windows-hctree.md.
         default:
             throw new UnsupportedPlatformError(platform, arch);
     }
@@ -33,7 +38,13 @@ export function binaryName(bin, platform = process.platform) {
 }
 export class UnsupportedPlatformError extends Error {
     constructor(platform, arch) {
-        super(`@rindle/cli ships no prebuilt Rindle binaries for ${platform}-${arch}`);
+        super(`@rindle/cli ships no prebuilt Rindle binaries for ${platform}-${arch}` +
+            (platform === "win32"
+                ? ". Rindle's storage engine is Linux-only, so there is no native Windows build. Run the " +
+                    "toolchain under WSL2 and keep the database on the WSL filesystem (~/), NOT under " +
+                    "/mnt/c — the Windows drive mount cannot back a memory-mapped database. Your app and " +
+                    "browser can stay on Windows: WSL2 forwards localhost."
+                : ""));
         this.name = "UnsupportedPlatformError";
     }
 }

package/dist/platform.js.map

@@ -1 +1 @@
-{"version":3,"file":"platform.js","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,qFAAqF;AACrF,+FAA+F;AAC/F,8FAA8F;AAC9F,iGAAiG;AACjG,iGAAiG;AACjG,4FAA4F;AAC5F,gGAAgG;AAOhG;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,WAA4B,OAAO,CAAC,QAAQ,EAC5C,OAAe,OAAO,CAAC,IAAI,EAC3B,OAAa,UAAU,CAAC,QAAQ,CAAC;IAEjC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,UAAU,IAAI,EAAE,CAAC;QAC1B,KAAK,OAAO;YACV,OAAO,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC;QACjC,KAAK,OAAO;YACV,OAAO,SAAS,IAAI,OAAO,CAAC;QAC9B;YACE,MAAM,IAAI,wBAAwB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,mBAAmB,CAAC,MAAc,WAAW,EAAE;IAC7D,OAAO,eAAe,GAAG,EAAE,CAAC;AAC9B,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,WAA4B,OAAO,CAAC,QAAQ;IAClF,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;AACnD,CAAC;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,QAAgB,EAAE,IAAY;QACxC,KAAK,CAAC,qDAAqD,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;QAC/E,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,gGAAgG;AAChG,gGAAgG;AAChG,6FAA6F;AAC7F,SAAS,UAAU,CAAC,QAAyB;IAC3C,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,EAE3B,CAAC;QACd,OAAO,MAAM,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,gGAAgG;AAChG,mCAAmC;AACnC,mGAAmG;AACnG,mGAAmG;AACnG,gGAAgG;AAChG,iGAAiG;AACjG,iGAAiG;AACjG,8EAA8E;AAC9E,4DAA4D;AAO5D;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,WAA4B,OAAO,CAAC,QAAQ,EAC5C,OAAe,OAAO,CAAC,IAAI,EAC3B,OAAa,UAAU,CAAC,QAAQ,CAAC;IAEjC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,UAAU,IAAI,EAAE,CAAC;QAC1B,KAAK,OAAO;YACV,OAAO,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC;QACjC,mFAAmF;QACnF,8FAA8F;QAC9F,2FAA2F;QAC3F,2EAA2E;QAC3E,gCAAgC;QAChC;YACE,MAAM,IAAI,wBAAwB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,mBAAmB,CAAC,MAAc,WAAW,EAAE;IAC7D,OAAO,eAAe,GAAG,EAAE,CAAC;AAC9B,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,WAA4B,OAAO,CAAC,QAAQ;IAClF,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;AACnD,CAAC;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,QAAgB,EAAE,IAAY;QACxC,KAAK,CACH,qDAAqD,QAAQ,IAAI,IAAI,EAAE;YACrE,CAAC,QAAQ,KAAK,OAAO;gBACnB,CAAC,CAAC,wFAAwF;oBACxF,mFAAmF;oBACnF,sFAAsF;oBACtF,uDAAuD;gBACzD,CAAC,CAAC,EAAE,CAAC,CACV,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,gGAAgG;AAChG,gGAAgG;AAChG,6FAA6F;AAC7F,SAAS,UAAU,CAAC,QAAyB;IAC3C,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,EAE3B,CAAC;QACd,OAAO,MAAM,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindle/cli",
-  "version": "0.4.4",
+  "version": "0.6.2",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -8,7 +8,7 @@
     "directory": "packages/cli"
   },
   "type": "module",
-  "description": "The Rindle toolchain for JS devs: the `rindle` CLI and the `rindled` daemon as prebuilt, per-platform binaries you can `npm install`. `rindle up` scaffolds and supervises a local daemon.",
+  "description": "The Rindle toolchain for JS devs: prebuilt CLI, write-master, follower, and local fleet-edge binaries. `rindle up` supervises the fleet and `rindle exec` injects topology-derived app bindings.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "sideEffects": false,
@@ -39,7 +39,9 @@
   "rindle": {
     "binaries": [
       "rindle",
-      "rindled"
+      "rindled",
+      "rindle-replicator",
+      "rindle-dev-edge"
     ],
     "repository": "rindle-sh/rindle",
     "targets": [
@@ -76,11 +78,6 @@
         "os": "linux",
         "cpu": "arm64",
         "libc": "musl"
-      },
-      {
-        "rust": "x86_64-pc-windows-msvc",
-        "os": "win32",
-        "cpu": "x64"
       }
     ]
   },
@@ -89,12 +86,11 @@
     "typescript": "^5.7.0"
   },
   "optionalDependencies": {
-    "@rindle/cli-darwin-arm64": "0.4.4",
-    "@rindle/cli-darwin-x64": "0.4.4",
-    "@rindle/cli-linux-arm64-gnu": "0.4.4",
-    "@rindle/cli-linux-arm64-musl": "0.4.4",
-    "@rindle/cli-linux-x64-gnu": "0.4.4",
-    "@rindle/cli-linux-x64-musl": "0.4.4",
-    "@rindle/cli-win32-x64-msvc": "0.4.4"
+    "@rindle/cli-darwin-arm64": "0.6.2",
+    "@rindle/cli-darwin-x64": "0.6.2",
+    "@rindle/cli-linux-arm64-gnu": "0.6.2",
+    "@rindle/cli-linux-arm64-musl": "0.6.2",
+    "@rindle/cli-linux-x64-gnu": "0.6.2",
+    "@rindle/cli-linux-x64-musl": "0.6.2"
   }
 }

package/src/index.ts

@@ -1,14 +1,15 @@
-// @rindle/cli — the Rindle toolchain (`rindle` CLI + `rindled` daemon) as prebuilt npm binaries.
+// @rindle/cli — the Rindle CLI and supervised local-fleet components as prebuilt npm binaries.
 //
 // `rindled` is the *network front* of the engine: the `rindle-server` crate — the SQLite-backed
 // `rindle-replica` live-query engine plus the public subscription/lease plane. `rindle` is the CLI
 // that inspects and manages a deployed daemon (`rindle status`/`migrate`/…) and, for local dev,
 // scaffolds and supervises one (`rindle init` / `rindle up`). Where `@rindle/replica` is a napi
 // addon that embeds the engine *in-process*, this package ships the standalone executables,
-// prebuilt per platform by dist (cargo-dist), **co-located** so `rindle up` finds `rindled` beside
-// it. This module resolves the right binary for the host; the `rindle` bin (dist/cli.js) execs the
-// CLI, and the daemon runs via `rindle up` or `spawnRindled()` (it is not exposed as its own bin —
-// this package is a dev convenience). Pair with `@rindle/daemon-client` to talk to a running daemon.
+// prebuilt per platform by dist (cargo-dist), **co-located** so `rindle up` finds every component
+// beside it. This module resolves the right binary for the host; the `rindle` bin (dist/cli.js)
+// execs the CLI, and the daemon runs via `rindle up` or `spawnRindled()` (it is not exposed as its
+// own bin — this package is a dev convenience). Pair with `@rindle/daemon-client` to talk to a
+// running daemon.
 import { spawn, type ChildProcess, type SpawnOptions } from "node:child_process";
 import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
@@ -33,13 +34,12 @@ export type { Binary, Libc } from "./platform.ts";
 const require = createRequire(import.meta.url);
 
 /**
- * Absolute path to a Rindle binary (`"rindle"` or `"rindled"`) for the current platform.
+ * Absolute path to a native Rindle toolchain binary for the current platform.
  *
- * Resolution order (the first three are dev overrides for working in this monorepo):
- *  1. `RINDLE_BINARY_PATH` / `RINDLED_BINARY_PATH` — an explicit path to that one binary.
- *  2. `RINDLE_BIN_DIR` — a directory holding both binaries. Point it at `target/release` after
- *     `cargo build -p rindle-cli -p rindle-server --release` and a single env var lights up both
- *     (and keeps them co-located, so `rindle up` still finds `rindled` as a sibling).
+ * Resolution order:
+ *  1. The binary's explicit `*_BINARY_PATH` override.
+ *  2. `RINDLE_BIN_DIR` — a directory holding the co-located toolchain. Point it at
+ *     `target/release` after building the four binary crates and one env var lights up the fleet.
  *  3. The matching `@rindle/cli-<key>` optional dependency that npm/pnpm installed.
  *
  * Throws `UnsupportedPlatformError` for an un-targeted host, or a descriptive Error if the
@@ -47,10 +47,16 @@ const require = createRequire(import.meta.url);
  * publish didn't target) and no override is set.
  */
 export function binaryPath(bin: Binary): string {
-  const explicit = process.env[`${bin.toUpperCase()}_BINARY_PATH`];
+  const explicitName: Record<Binary, string> = {
+    rindle: "RINDLE_BINARY_PATH",
+    rindled: "RINDLED_BINARY_PATH",
+    "rindle-replicator": "RINDLE_REPLICATOR_BINARY_PATH",
+    "rindle-dev-edge": "RINDLE_DEV_EDGE_BINARY_PATH",
+  };
+  const explicit = process.env[explicitName[bin]];
   if (explicit) {
     if (!existsSync(explicit)) {
-      throw new Error(`${bin.toUpperCase()}_BINARY_PATH points at a missing file: ${explicit}`);
+      throw new Error(`${explicitName[bin]} points at a missing file: ${explicit}`);
     }
     return explicit;
   }

package/src/platform.ts

@@ -1,16 +1,18 @@
 // Single source of truth for mapping the *running* Node platform to the per-platform package that
-// carries the prebuilt Rindle binaries (`rindle` + `rindled`) for it. Those packages
-// (`@rindle/cli-<key>`) are generated at release time by `scripts/build-npm-packages.mjs` from
-// dist's (cargo-dist) release archives, and declared as optionalDependencies of this umbrella
-// package — so npm/pnpm install only the one whose `os`/`cpu` match the host. Both binaries ship
+// carries the prebuilt Rindle binaries (`rindle`, `rindled`, `rindle-replicator`, and the local
+// `rindle-dev-edge`) for it. Those
+// packages (`@rindle/cli-<key>`) are generated at release time by `scripts/build-npm-packages.mjs`
+// from dist's (cargo-dist) release archives, and declared as optionalDependencies of this umbrella
+// package — so npm/pnpm install only the one whose `os`/`cpu` match the host. All binaries ship
 // **co-located** in that one package's `bin/`, which is required: the `rindle` CLI's `rindle up`
-// finds `rindled` as a sibling of its own executable (rindle-cli §7.1). This module and the
-// generator MUST agree on the `<key>` scheme; it is defined here and mirrored in the generator.
+// finds every component as a sibling of its own executable (rindle-cli §7.1) so it can supervise
+// the local topology. This module and the generator MUST agree on the `<key>`
+// scheme; it is defined here and mirrored in the generator.
 
 export type Libc = "gnu" | "musl";
 
-/** A Rindle binary shipped by this toolchain: the CLI (`rindle`) or the daemon (`rindled`). */
-export type Binary = "rindle" | "rindled";
+/** A native binary shipped by the Rindle development toolchain. */
+export type Binary = "rindle" | "rindled" | "rindle-replicator" | "rindle-dev-edge";
 
 /**
  * The package-name suffix identifying a build target for the current (or given) host:
@@ -27,8 +29,11 @@ export function platformKey(
       return `darwin-${arch}`;
     case "linux":
       return `linux-${arch}-${libc}`;
-    case "win32":
-      return `win32-${arch}-msvc`;
+    // `win32` is deliberately absent, and must stay in step with `"rindle".targets` in
+    // package.json: we publish no Windows binaries, so returning a key here would only trade this
+    // actionable error for a MODULE_NOT_FOUND on a package that was never published. Restoring
+    // Windows means re-adding the target there AND a `case "win32"` here — see
+    // follow-ups/windows-hctree.md.
     default:
       throw new UnsupportedPlatformError(platform, arch);
   }
@@ -46,7 +51,15 @@ export function binaryName(bin: Binary, platform: NodeJS.Platform = process.plat
 
 export class UnsupportedPlatformError extends Error {
   constructor(platform: string, arch: string) {
-    super(`@rindle/cli ships no prebuilt Rindle binaries for ${platform}-${arch}`);
+    super(
+      `@rindle/cli ships no prebuilt Rindle binaries for ${platform}-${arch}` +
+        (platform === "win32"
+          ? ". Rindle's storage engine is Linux-only, so there is no native Windows build. Run the " +
+            "toolchain under WSL2 and keep the database on the WSL filesystem (~/), NOT under " +
+            "/mnt/c — the Windows drive mount cannot back a memory-mapped database. Your app and " +
+            "browser can stay on Windows: WSL2 forwards localhost."
+          : ""),
+    );
     this.name = "UnsupportedPlatformError";
   }
 }