@rubytech/create-realagent 1.0.701 → 1.0.702

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rubytech/create-realagent",
3
- "version": "1.0.701",
3
+ "version": "1.0.702",
4
4
  "description": "Install Real Agent — Built for agents. By agents.",
5
5
  "bin": {
6
6
  "create-realagent": "./dist/index.js"
@@ -65,7 +65,10 @@ The logs will show which service failed to start and why. Common causes:
65
65
  - **Neo4j not started** — run `sudo systemctl start neo4j` and retry
66
66
  - **Port 19200 already in use** — check for another process: `lsof -i :19200`
67
67
  - **Claude OAuth expired** — the next admin session will prompt you to re-authenticate
68
- - **NEO4J_URI port mismatch** — the admin agent throws `port :X disagrees with brand.json neo4jPort :Y`. Edit `NEO4J_URI` in `~/{configDir}/.env` to match the brand's declared `neo4jPort`, or correct `neo4jPort` in `brand.json` and reinstall. (Task 681)
68
+ - **NEO4J_URI guard throws** — the admin agent probes device reality at boot and fails closed on three shapes (Task 682, succeeding Task 681):
69
+ - `no Neo4j listening on [ports]` — nothing is bound; start `neo4j.service` or `neo4j-<brand>.service`, or edit `NEO4J_URI` to a port a Neo4j is actually running on.
70
+ - `port :X not listening; only :Y is live` — single-brand device where `.env` names a port the local Neo4j isn't bound to; edit `NEO4J_URI` in `~/{configDir}/.env` to match the live port (shown in the `[neo4j-probe] listening=[…]` log line).
71
+ - `port :X disagrees with brand.json neo4jPort :Y` — co-tenant device (2+ Neo4js listening) where `.env` names the other brand's port; edit `NEO4J_URI` to match `brand.neo4jPort`, or correct `neo4jPort` in `brand.json` and reinstall. Preserves the Task 577 orphan-write protection on multi-brand devices.
69
72
 
70
73
  ## Systemd units on each device
71
74