skatespots/SkateSpots
1
0
Fork 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity Actions 1

docs: record zsp non-interactive publish + empty zsp.env gotchas

Browse source
This commit is contained in:
SkateSpots 2026-10-12 22:55:44 +07:00
parent bcc3eceeee
commit 0d04445bf3
1 changed files with 12 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
AGENTS.md
View file

@ -2077,6 +2077,18 @@ Rules:
⚠️ `zsp` reads the **version from the built APK** (synced from `package.json` by
`android:build`) — bump **only** `package.json`. Publish needs the **signer awake**
(open Amber in the foreground). `SIGN_WITH=browser` fails here (no NIP-07 extension).
⚠️ **`zsp publish` prompts interactively** (signer/confirm) — with no TTY it dies
with `prompt failed: … /dev/tty`. Always pass **`--quiet`** (auto-yes, no
spinners) and, for a dry run, **`--offline`** (signs, uploads nothing; events to
stdout). ⚠️ The env file **`~/.config/skatespots/zsp.env`** (600, outside the
repo) holds `SIGN_WITH` — **as of 2026-10-12 it was an empty template**
(`SIGN_WITH=` with no value), so publishing requires filling it (or exporting
SIGN_WITH in the shell). ⚠️ **Do not `source` that file blindly**: a
`bunker://<pk>?relay=…&secret=…` value contains `&`, which backgrounds the
assignment (`SIGN_WITH` ends up unset). Extract it safely instead:
`SIGN_WITH="$(sed -n 's/^SIGN_WITH=//p' ~/.config/skatespots/zsp.env)"; export SIGN_WITH`.
Complete non-interactive publish:
`SIGN_WITH="$(sed -n 's/^SIGN_WITH=//p' ~/.config/skatespots/zsp.env)"; export SIGN_WITH; zsp publish --quiet zapstore.yaml`
### Relay archive (dataset backup)
- **Transfer content between keys (`scripts/transfer-content.mjs`, 2026-10-04):**