chore(beads): initialize public repo-local tracking#438
Merged
Conversation
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.
Summary
AllAgents clones can now bootstrap a fresh Beads database directly from the public project repository instead of discovering the broken legacy schema-v49 database and separate private remote. The new public identity uses database and issue prefix
allagents, with no legacy rows or identity data migrated.Only the portable config, metadata, and ignore policy are versioned. Embedded Dolt data, credentials, exports, backups, locks, sockets, and machine-specific paths remain local, and contributor guidance makes the public-data boundary explicit.
Supersedes #431.
Validation
bun run buildbun run typecheckbun run lintbun test— 1,326 passed, 5 skippedbun run test:e2e— 116 passed, 4 skippedgitleaks dir --no-banner --redact .— no leaks foundPublic-branch bootstrap was reproduced with:
git clone --branch chore/repo-local-public-beads https://github.com/EntityProcess/allagents.git allagents-beads-check cd allagents-beads-check bd bootstrap --dry-run --json bd bootstrap --yes bd config get sync.remote bd context --json bd dolt pull git status --short --branchThis selected the exact
git+https://github.com/EntityProcess/allagentsremote, recovered project82b512b7-0232-45ba-94c5-448de92d1afc, and left the checkout clean. A disposablebd worktree createcheck also resolved the same database from its parent clone.bd doctorwas run and reported its documented embedded-mode limitation;bd status,bd ready, remote inspection, bootstrap, and pull all succeeded.One-time maintainer action
After merge, a maintainer using the old primary checkout should remove or archive its ignored legacy
.beadsdirectory, then runbd bootstrap. Fresh clones only needbd bootstrap; if the local umask produces the bd permissions warning, runchmod 700 .beads.Post-Deploy Monitoring & Validation
No production runtime monitoring is required because this changes repository metadata only. During the first maintainer bootstrap after merge, verify
bd context --jsonreports the project ID above andbd dolt remote listreports the public AllAgents URL; a legacy schema gate, different project ID, or private remote is the rollback trigger. Mitigation is to remove the local ignored database and bootstrap again from the public remote. Validation owner: repository maintainer, during the first post-merge checkout.