governed-workflow

name	governed-workflow
description	Governed PR and release workflow for the td demo
triggers	["governed","review approve","release propose","auditor vote","governance-gate"]

Governed Workflow

This repo is expected to run against TheWorld instance td.onthe.eth.

Identifier Glossary

• IP-N = TheWorld IP proposal ID
• PR #N = GitHub pull request number
• TheWorld review proposal #N = review proposal row in TheWorld
• Release Proposal #N = TheWorld release proposal ID

PR Flow

1. Colony daemon observes finalized IP proposals.
2. Colony implements changes in the repo and opens a PR.
3. review create / review approve bridge PR review state into TheWorld.
4. GitHub Actions enforce governance-gate before merge.
5. Auto-merge merges approved PRs back to main.

Release Flow

1. Shareholder runs etherclaw release propose --ips ... --version ....
2. Timer moves the release proposal into voting.
3. Shareholder casts ranked vote.
4. Auditor votes approve on the selected release.
5. etherclaw release execute creates the GitHub release/tag.

Operational Commands

etherclaw flow --online --instance td
etherclaw review approve <PR#>
etherclaw release propose --ips N,N --version v1.x.0 --instance td.onthe.eth
etherclaw auditor vote --release N --approve --instance td.onthe.eth

Failure Handling

• If branch protection is missing, run ./scripts/setup-branch-protection.sh.
• If the daemon appears idle, inspect the tmux Colony pane before mutating state.
• Use etherclaw flow --online as the first status check.