Skip to content

docs: fix accuracy gaps vs live system (storage broker, NATS, Team, /metrics) - #18

Merged
mastermanas805 merged 1 commit into
mainfrom
fix/gap-docs-accuracy-2026-06-03
Jun 2, 2026
Merged

docs: fix accuracy gaps vs live system (storage broker, NATS, Team, /metrics)#18
mastermanas805 merged 1 commit into
mainfrom
fix/gap-docs-accuracy-2026-06-03

Conversation

@mastermanas805

Copy link
Copy Markdown
Member

Deep gap analysis 2026-06-03, verified vs live + api origin/master. Fixes agent-breaking + stale docs: /storage/new broker mode (no S3 keys), NATS legacy_open reality, Team live ($199, not coming-soon/tier_unavailable), free_tier_recycle 402, internal_url carve-out, /metrics token-gated. 🤖 Generated with Claude Code

…, /metrics)

Deep gap analysis (2026-06-03), verified against live api.instanode.dev + the
handlers on api origin/master:

- P1 /storage/new: prod returns broker mode (NO access_key_id/secret_access_key;
  presign_url instead) for ALL new tenants on DO Spaces. llms.txt + services.md
  said S3 keys are returned — corrected the response shape, the mode table
  (broker is the DO-Spaces-today default; shared-master-key is legacy-only), and
  convention #2.
- P1 NATS /queue/new: prod serves auth_mode=legacy_open (no per-tenant creds, no
  server-side cross-tenant enforcement). Docs presented isolated+server-denial as
  the default — added a prominent "current production reality" note.
- P2 Team tier: was "coming soon" / "tier_unavailable" — Team is live, self-serve
  $199/mo (api no longer returns tier_unavailable); paid checkout is gated only by
  the cross-tier Razorpay rollout.
- P2 free_tier_recycle_requires_claim 402 was undocumented in llms.txt — added.
- P2 services.md "every response has internal_url" overgeneralized — carved out
  storage/webhook.
- P3 /metrics is now token-gated (401), not public — noted.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mastermanas805
mastermanas805 enabled auto-merge (squash) June 2, 2026 19:30
@mastermanas805
mastermanas805 merged commit b39f374 into main Jun 2, 2026
2 checks passed
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