diff --git a/README.md b/README.md index b34dbc7..8a7c82b 100644 --- a/README.md +++ b/README.md @@ -54,6 +54,7 @@ docs/ app-channel-spec.md governance-install-spec.md repo-boundary-blueprint.md + repo-split-publish-runbook.md review-notes.md platform-spec-alignment-review.md contracts/ diff --git a/docs/repo-split-publish-runbook.md b/docs/repo-split-publish-runbook.md new file mode 100644 index 0000000..fa360ff --- /dev/null +++ b/docs/repo-split-publish-runbook.md @@ -0,0 +1,52 @@ +# Repo Split Publish Runbook + +Use this runbook after valid Gitea API credentials (username + PAT) are available. + +## Local Seed Repos (already initialized) + +1. `launcher` at `/Users/vsg/Documents/VSG Codex/launcher` (commit `cd831f4`) +2. `governance` at `/Users/vsg/Documents/VSG Codex/governance` (commit `ecb73e9`) +3. `contracts` at `/Users/vsg/Documents/VSG Codex/contracts` (commit `699c1a3`) + +## Create Remote Repos + +1. Create `edut/launcher` (private) +2. Create `edut/governance` (private) +3. Create `edut/contracts` (private or public per policy) + +Example (replace ``): + +```bash +curl -fsSL -H "Authorization: token " -H "Content-Type: application/json" \ + -X POST "https://git.workvsg.com/api/v1/orgs/edut/repos" \ + -d '{"name":"launcher","private":true,"description":"EDUT free launcher shell and wallet onboarding app"}' +``` + +Repeat for `governance` and `contracts`. + +## Push Local Seed Repos + +```bash +cd "/Users/vsg/Documents/VSG Codex/launcher" +git remote add origin https://git.workvsg.com/edut/launcher.git +git push -u origin main + +cd "/Users/vsg/Documents/VSG Codex/governance" +git remote add origin https://git.workvsg.com/edut/governance.git +git push -u origin main + +cd "/Users/vsg/Documents/VSG Codex/contracts" +git remote add origin https://git.workvsg.com/edut/contracts.git +git push -u origin main +``` + +## Post-Publish Validation + +1. Verify each repo has expected initial commit. +2. Verify repo visibility policy (public/private) matches boundary blueprint. +3. Add cross-repo links in each README. +4. Lock branch protections and required-review settings. + +## Current Blocker + +Gitea API creation attempts with current credential material return `401 invalid username/password/token`. diff --git a/docs/roadmap-status.md b/docs/roadmap-status.md index 1a59ebb..b6fe615 100644 --- a/docs/roadmap-status.md +++ b/docs/roadmap-status.md @@ -47,6 +47,7 @@ Implemented now: 20. Store UI now supports distinct payer wallet overrides with ownership-proof signing before quote requests. 21. Public web store preview is noindex and disabled by default unless explicit internal preview mode is enabled. 22. Catalog distribution and public-surface deployment guardrails are documented for launcher-only commerce. +23. Local split repos (`launcher`, `governance`, `contracts`) are initialized with seed commits and a publish runbook. Remaining in this repo: