docs: draft Stage 0/1 productization docs (registry wiring, invite walkthrough, LICENSE stub) - #36
Draft
Jess Sullivan (Jesssullivan) wants to merge 1 commit into
Draft
Conversation
…lkthrough, LICENSE stub) DRAFT, operator-review-pending docs closing three shelf-grab gaps found during the productization sweep: - docs/registry-wiring-bazel.md: blesses tinyland.dev's per-module single_version_override pattern over the contradicting global-registry pattern used by elders.tinyland.dev and siblings (out of scope to migrate here). Named to dodge the bazel-* gitignore rule meant for Bazel's own output symlinks. - docs/invite-onboarding-walkthrough.md: mint-invite -> accept -> admin -> login via @tummycrypt/tinyland-invitation, the fail-closed authority. Explicitly warns off this repo's own ungated InvitationService (TIN-2780, PRs #33/#34 in flight) and documents TIN-2781's current state: the single-process TOCTOU race is fixed (tinyland-invitation#10, merged), the cross-replica compare-and-set gap is not, and TIN-2781 stays open for that. Single-replica-only caveat throughout. - LICENSE: real Zlib text plus an explicit, unfilled placeholder block for the LicenseRef-Tinyland-Proprietary half of package.json's SPDX expression, which had no backing text anywhere in the repo or org. None of the three is a ratified answer; all carry DRAFT banners.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Status: DRAFT — pending operator review
None of the three files here are ratified answers. All carry an explicit
DRAFT — for operator review, not yet ratified.banner. No code changes,no license grant is in effect, no bazel pattern is declared org policy —
this is documentation only, meant to give an operator something concrete to
react to.
What's in this PR
docs/registry-wiring-bazel.md(named to dodge this repo'sbazel-*.gitignorerule, which is meant for Bazel's ownbazel-bin/bazel-outoutput symlinks and was silently eating a file literally named
docs/bazel-registry-wiring.md):tinyland.dev(github/main, spot-checkedat commit
98c619f) uses a per-modulesingle_version_overrideinMODULE.bazelagainst the Tinyland registry, with.bazelrcleft atbcr.bazel.buildonly.elders.tinyland.devand several siblings insteadadd the Tinyland registry as a global
.bazelrcsearch path ahead ofBCR, with no override.
tinyland.devpattern, since it's what the actual productionconsumer does today — but this is my read of existing code, not an
existing ADR. Explicitly out of scope: migrating the other repos.
docs/invite-onboarding-walkthrough.md:@tummycrypt/tinyland-invitation(the fail-closed authority TIN-1607adopted), cited against
tinyland.dev's actual composition(
src/lib/server/auth/invitation-service.ts).InvitationService(
src/modules/invitation) — TIN-2780 (status "In Review"): itscreateInvitation()does zero role-authorization; fix PRs fix(auth)!: remove duplicate invitation authority (TIN-2780) #33 andfix(invitation): drop ungated InvitationService from public surface (TIN-2780) #34 are open against this repo right now.
state: the single-process TOCTOU race in
acceptInvitationwas fixed bytinyland-invitation#10(merged 2026-07-11, per-token in-process mutex).The issue is deliberately kept open ("In Progress") because the fix does
not cover cross-process/cross-replica compare-and-set — that's called
out explicitly, along with a single-replica-only caveat on the whole doc.
LICENSE:package.json'slicensefield isZlib AND LicenseRef-Tinyland-Proprietary,but no
LICENSEfile existed andLicenseRef-Tinyland-Proprietaryhas notext anywhere in this repo or the org. Adds the real, unmodified Zlib
license text plus a clearly marked, empty
[PLACEHOLDER — proprietary terms not yet drafted]block for the otherhalf. No proprietary legal text invented.
Residual risks / follow-ups for the operator
walkthrough against whatever this repo's own invitation surface looks like
post-fix (removed export vs. gated export changes some of the "don't use
this" framing).
tinyland.dev's own code at onecommit, not an existing operator ADR. An actual ADR would firm this up and
should also decide whether/when the global-registry repos migrate.
LICENSE's proprietary half is a placeholder only — needs real legal textand a decision on which files/modules fall under which half of the SPDX
expression before this can be treated as a real license.