@pathrule/cli 0.0.1

package/README.md

@@ -0,0 +1,105 @@
+# Pathrule CLI
+
+Pathrule CLI is the local runtime for headless terminals, SSH sessions, and
+Browser+CLI workflows. It owns local auth, workspace attach, MCP install,
+preflight checks, companion-file sync, and doctor diagnostics.
+
+## Distribution Policy
+
+Pathrule CLI v1 ships through three channels:
+
+- Signed standalone binary artifacts for direct download.
+- Homebrew tap formula that installs the signed binary artifact.
+- `@pathrule/cli` npm package as a thin launcher/installer for Node-first users.
+
+The CLI does not silently replace its own binary by default. Update behavior is
+controlled by `PATHRULE_UPDATE_POLICY` or `pathrule config set update.policy`:
+
+- `manual`: no update checks.
+- `notify`: check for newer versions and print a passive notice.
+- `auto`: opt-in only, reserved for managed installers such as npm or Homebrew.
+
+`CI=true` and `NO_UPDATE_CHECK=1` force manual mode.
+
+## Install
+
+### Homebrew
+
+```bash
+brew tap pathrule/tap
+brew install pathrule
+```
+
+Upgrade:
+
+```bash
+brew upgrade pathrule
+```
+
+### npm
+
+```bash
+npm i -g @pathrule/cli
+```
+
+Upgrade:
+
+```bash
+npm i -g @pathrule/cli@latest
+```
+
+### Standalone
+
+```bash
+curl -fsSL https://pathrule.io/install.sh | sh
+```
+
+The standalone installer must verify the published checksum and signature before
+placing the binary on `PATH`. The concrete signature manifest is owned by M34b
+release integrity.
+
+## First Run
+
+```bash
+pathrule login
+pathrule setup --json
+pathrule setup --workspace <workspace-id-or-name> --target all --yes
+pathrule start
+pathrule doctor
+```
+
+Run `pathrule start` to start the local Web bridge manually. Use `pathrule daemon autostart on`
+or `pathrule daemon autostart off` to toggle whether it starts when you sign in.
+
+`pathrule login` opens the hosted Pathrule Web authorization flow:
+
+```text
+One-time code: ABCD-EFGH
+A browser window should open. If not, visit https://app.pathrule.io/device?code=ABCD-EFGH.
+```
+
+## Compatibility Endpoint
+
+`pathrule update` reads:
+
+```text
+https://app.pathrule.io/cli/versions.json
+```
+
+Expected shape:
+
+```json
+{
+  "latest_version": "0.5.0",
+  "min_supported_protocol_version": "0.5.0",
+  "upgrade_command": "brew upgrade pathrule",
+  "channels": {
+    "brew": "brew upgrade pathrule",
+    "npm": "npm i -g @pathrule/cli@latest",
+    "standalone": "curl -fsSL https://pathrule.io/install.sh | sh"
+  }
+}
+```
+
+The endpoint is advisory for M31a. Production release gating, checksums,
+signature manifests, and installer integrity checks land in M34b.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }