Skip to content

docs: establish TruthBounty V2 governance baseline - #1

Merged
dDevAhmed merged 4 commits into
mainfrom
docs/v2-governance-baseline
Aug 25, 2026
Merged

docs: establish TruthBounty V2 governance baseline#1
dDevAhmed merged 4 commits into
mainfrom
docs/v2-governance-baseline

Conversation

@dDevAhmed

Copy link
Copy Markdown
Contributor

Summary

Establishes a reviewable TruthBounty V2 governance baseline before implementation remediation begins.

Changes

  • adds the verified cross-repository V2 audit reconciliation;
  • proposes ADR-0001, selecting the modular V2 contract suite as the canonical production topology;
  • classifies TruthBountyWeighted.sol as transitional/reference and TruthBountyClaims.sol as deprecated for V2 settlement;
  • aligns the protocol README with blockchain-authoritative V2 boundaries and invariants;
  • corrects repository names, ownership boundaries, and allowed dependency direction in repos.md;
  • documents issue-status drift, the missing SC-036, absent FE-### backlog, and duplicate Stellar Wave / stellar-wave labels.

Why this comes first

The current canonical README still describes V1 backend-owned claims, lifecycle, aggregation, and frontend data authority. Implementation work cannot be reconciled safely while contributors are governed by contradictory documentation.

Review gates

  • Confirm modular V2 is the canonical production topology.
  • Confirm TruthBountyWeighted.sol remains reference/transitional.
  • Confirm TruthBountyClaims.sol is excluded from production deployment.
  • Confirm backend and frontend authority boundaries.
  • Confirm remediation waves and issue-reconciliation rules.
  • Identify owners for publishing PROTOCOL_V2_SPEC.md, the engineering blueprint, master backlog, and dependency graph.

Verification

All four branch files were fetched from GitHub after writing and compared byte-for-byte with the reviewed drafts.

Out of scope

This PR does not modify Solidity, backend, frontend, deployments, issue states, labels, or milestones. Those actions remain blocked until the ADR and reconciliation baseline are reviewed.

@dDevAhmed
dDevAhmed marked this pull request as ready for review August 25, 2026 15:39
@dDevAhmed
dDevAhmed merged commit 9509bc2 into main Aug 25, 2026
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