OverviewFilesCommitsIssuesDocsReleasesPeers

pgh commits / fa008f4

docs: fix install.sh next-steps + explain HTTPS-vs-punch bootstrap (v0.1.122)
- install.sh fresh-install message claimed `pgh init` starts pgh-sidecar; it doesn't. Split into two steps: `pgh init` then `pgh app boot`, with a note that init does not start the sidecar. - README source-install clone note: replace the casual "punch:// works too" aside with the actual reason HTTPS is primary here — punch:// needs git-remote-punch, itself a pgh app, so it's unavailable until pgh is up. This is the bootstrap case; punch:// is the native transport for everything afterward. Bump 0.1.121 -> 0.1.122 (install.sh is a shipped file: artifact; the version-bump-guard requires a bump when its bytes change). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
fa008f43abaf271e88596693dba1b05a92869ef3
by plankatron <fleeky@gmail.com> · 2026-07-20T03:22:39.000Z

Changed files (3) +13 -8

README.md +8 -4
……@@ -106,8 +106,8 @@ The `file:` edges that make this exact set mandatory:
106106- **hyper-svc** → hyper-rooms
107107- **pgh-runtime** → hyper-overlay
108108
109Clone all eight over the forge (HTTPS anonymous read; substitute your own
110mirror for `7rnx.net` if you have one):
109Clone all eight from the forge over **HTTPS** (anonymous read; substitute your
110own mirror for `7rnx.net`):
111111
112112```bash
113113mkdir -p pgh-src/repos && cd pgh-src
……@@ -119,8 +119,12 @@ done
119119git clone https://7rnx.net/git/hyperident.git repos/hyperident
120120```
121121
122(Already running a forge? `git clone punch://<serverKey>/<repo>` works too,
123once `git-remote-punch` is installed.)
122**Why HTTPS and not the native `punch://` transport?** This is a bootstrap:
123`git clone punch://<serverKey>/<repo>` needs `git-remote-punch`, which is
124itself a pgh app (`pgh app install git-remote-punch`) — so it isn't available
125until pgh is up. Plain HTTPS is the only way in before you have the stack. Once
126pgh is running, `punch://` is the preferred P2P transport for cloning anything
127else.
124128
125129### 3. Install dependencies (leaf packages first)
126130
package.json +1 -1
……@@ -1,6 +1,6 @@
11{
22 "name": "pgh",
3 "version": "0.1.121",
3 "version": "0.1.122",
44 "description": "pgh — P2P content-addressed package manager and app launcher",
55 "type": "module",
66 "main": "index.js",
scripts/install.sh +4 -3
……@@ -293,11 +293,12 @@ if [ "$MANAGED" -eq 1 ]; then
293293 echo
294294 echo "Verify: ${BIN_NAME} app status"
295295else
296 echo "pgh installed. Next step:"
296 echo "pgh installed. Next steps:"
297297 echo
298 echo " ${BIN_NAME} init"
298 echo " ${BIN_NAME} init # identity + tree store + local registries"
299 echo " ${BIN_NAME} app boot # start pgh-sidecar (and any autostart apps)"
299300 echo
300 echo "which sets up your identity + tree store and starts pgh-sidecar."
301 echo "init sets things up but does NOT start the sidecar — 'app boot' does."
301302fi
302303echo
303304