palmagent 0.1.0-alpha.2 → 0.1.0-alpha.4

package/README.md

@@ -13,22 +13,25 @@ mobile-first PWA over SSE (read) + REST (control).
 
 ## Quickstart
 
-```sh
-npm i -g palmagent@next
-palmagent install --domain your.domain.example   # systemd units, nginx, TLS, first passkey
-palmagent doctor                                  # diagnose a running instance
-```
+Use the Palmagent operator plugin in Claude Code or Codex to install and manage the service.
+The plugin handles CLI installation and commands internally; users do not run this CLI directly.
+Ask the plugin to install Palmagent, show settings, choose Preview, or update the service.
 
-Run the CLI as the unprivileged account that should own the agent processes; do not
-prefix the whole command with sudo. If you install with `--data-dir`, pass that same
-option to later setup, doctor, update, passkey, and uninstall commands.
+Stable is the default for new users. Preview is an explicit choice available to everyone.
+Both plugins share ~/.palmagent/config.json; settings survive updates and service reinstalls.
+Changing the saved channel does not deploy a release. Updates refuse downgrades and
+prereleases on Stable; a missing Stable release does not fall back to Preview.
+Ask the plugin to enable automatic updates for idle periods within the current compatibility line.
+Automatic updates are off by default; a required plugin change or failed installation needs attention.
 
-## Commands
+## Internal commands
 
+- `palmagent config`     Shared user settings: get, init, set --channel stable|preview
+- `palmagent auto-update` Background timer: enable, disable, status
 - `palmagent install`    First-run setup: systemd units, nginx, TLS (certbot), first passkey
 - `palmagent setup`      Reconfigure an existing install + re-render units/nginx
 - `palmagent doctor`     Diagnose a running instance + suggest fixes
-- `palmagent update`     Apply config; `--pull` updates an npm install on its release channel
+- `palmagent update`     `--plan` resolves package/plugin actions; `--pull` applies with installed plugin manifests
 - `palmagent uninstall`  Remove the units + nginx vhost (data preserved unless `--purge`)
 - `palmagent passkey`    Mint a fresh device-enroll link
 

package/build-info.json

@@ -1,5 +1,17 @@
 {
-  "version": "0.1.0-alpha.2",
-  "sourceCommit": "58552655e2abb9f5ce36b548e4b79a2f5729f1d4",
+  "version": "0.1.0-alpha.4",
+  "agentCliCompatibility": {
+    "claude": {
+      "range": ">=2.1.268 <2.2.0",
+      "minimum": "2.1.268",
+      "exclusiveMaximum": "2.2.0"
+    },
+    "codex": {
+      "range": ">=0.154.0 <0.155.0",
+      "minimum": "0.154.0",
+      "exclusiveMaximum": "0.155.0"
+    }
+  },
+  "sourceCommit": "ec8a38fc33856882a8cafe810445e73110607b06",
   "dirty": false
 }