@fyresmith/hive-server 4.0.1 → 5.0.0

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/README.md CHANGED
@@ -68,11 +68,13 @@ hive setup --yes
68
68
  `hive setup` can:
69
69
 
70
70
  - initialize and validate `.env`
71
+ - generate a new vault folder from a parent location you choose
71
72
  - configure Cloudflare Tunnel
72
- - sync `DISCORD_REDIRECT_URI`
73
73
  - install Hive as a launchd/systemd service
74
74
  - run post-setup checks
75
75
 
76
+ `hive dashboard` can start in setup mode even before `VAULT_PATH` is configured, so first-time setup can be completed in the browser.
77
+
76
78
  ## Config and Env
77
79
 
78
80
  Operator config:
@@ -92,7 +94,7 @@ hive env check
92
94
  hive env print
93
95
  ```
94
96
 
95
- Managed mode requires `OWNER_DISCORD_ID` in the env file. This Discord user is the only account allowed to initialize managed state and issue invites.
97
+ Managed mode owner identity is persisted in managed state during setup. No owner ID env field is required.
96
98
 
97
99
  Managed operations:
98
100
 
@@ -102,9 +104,24 @@ hive managed invite create
102
104
  hive managed invite list
103
105
  hive managed invite revoke <code>
104
106
  hive managed member list
105
- hive managed member remove <discordId>
107
+ hive managed member remove <userId>
106
108
  ```
107
109
 
110
+ ### Invite Onboarding
111
+
112
+ Invite-first download onboarding is the default behavior:
113
+
114
+ 1. Owner creates invite via `hive managed invite create`.
115
+ 2. Recipient opens claim URL, signs in/creates an account, and claims invite.
116
+ 3. Recipient downloads a preconfigured managed-vault package zip.
117
+ 4. Recipient opens extracted folder in Obsidian; Hive performs bootstrap token exchange and initial sync.
118
+
119
+ Optional env overrides:
120
+
121
+ - `HIVE_BUNDLE_GRANT_TTL_MINUTES` (default `15`)
122
+ - `HIVE_BOOTSTRAP_TOKEN_TTL_HOURS` (default `24`)
123
+ - `HIVE_BUNDLE_DENY_PATHS` (comma-separated deny list for bundle policy)
124
+
108
125
  ## Tunnel Operations
109
126
 
110
127
  ```bash
@@ -149,17 +166,3 @@ hive update
149
166
  `hive up` / `hive down` start or stop installed Hive and cloudflared services together.
150
167
  `hive logs` streams service logs (`--component hive|tunnel|both`).
151
168
  `hive update` installs the latest npm release for the current package and then restarts the Hive OS service and cloudflared service when they are installed.
152
-
153
- ## Migration Notes
154
-
155
- On first `hive setup`, if legacy `server/.env` exists and no `~/.hive/config.json` exists, setup will offer to import legacy env values.
156
-
157
- ## Legacy Scripts (Deprecated)
158
-
159
- Legacy operational files are still present for one release cycle:
160
-
161
- - `/setup-tunnel.sh`
162
- - `/infra/cloudflare-tunnel.yml`
163
- - `/infra/collab-server.service`
164
-
165
- Use `hive` commands instead of editing legacy templates manually.