Skip to content

fix: doc audit — relay bin, env var names, CLI flag formats - #8

Merged
YairEtzion merged 1 commit into
mainfrom
fix/doc-audit
Apr 2, 2026
Merged

fix: doc audit — relay bin, env var names, CLI flag formats#8
YairEtzion merged 1 commit into
mainfrom
fix/doc-audit

Conversation

@YairEtzion

Copy link
Copy Markdown
Contributor

Summary

Full audit of every doc claim against actual code. Fixes 6 discrepancies:

  • Relay has no bin entrybunx @authmesh/relay silently failed. Added bin.amesh-relay to package.json + shebang to start.ts. Changed all docs to npx @authmesh/relay.
  • RELAY_URL doesn't exist — CLI actually reads AMESH_RELAY_URL. Fixed in integration guide, CLI README, and landing page env vars table.
  • --ttl 3600 is invalid — CLI accepts duration format (1h, 30m), not raw seconds. Fixed in integration guide and landing page.
  • createRelay() doesn't exist — actual export is createRelayServer(). Fixed in relay README.
  • node -e relay start — simplified to npx @authmesh/relay in guide.md.
  • AUTH_MESH_PASSPHRASE missing from env vars — added to landing page integration docs table.

Test plan

  • bun run build — all packages build
  • bun run test — all tests pass
  • bun run lint — clean
  • npx @authmesh/relay — verify it starts (requires published package with bin entry)

Fixes found by auditing every doc claim against actual code:

- Add bin entry to @authmesh/relay so npx @authmesh/relay works
- Add shebang to relay start.ts for executable usage
- Fix RELAY_URL → AMESH_RELAY_URL everywhere (matches actual CLI env var)
- Fix --ttl 3600 → --ttl 1h (CLI accepts duration format, not seconds)
- Fix createRelay → createRelayServer in relay README
- Fix bunx → npx in all docs (relay has no bunx support)
- Simplify guide.md relay start to use npx
- Add AUTH_MESH_PASSPHRASE to env vars table on site
@YairEtzion
YairEtzion merged commit b0c0c37 into main Apr 2, 2026
1 check passed
@YairEtzion
YairEtzion deleted the fix/doc-audit branch April 2, 2026 17:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant