Spaces:
Running
Running
File size: 2,181 Bytes
a6a5d8e | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 | # Cross-repo handoff readiness
This runbook makes blocked sibling-repo work auditable while GitHub Enterprise
access is being configured. It is an A11oy-local queue, not a claim that the
target repositories have been updated.
The machine-readable ledger is
[`cross-repo-handoff-manifest.json`](cross-repo-handoff-manifest.json).
## Current boundary
- A11oy is writable from this environment.
- Several sibling repos have previously rejected direct pushes with `403`.
- Proxy patches and status files in `coordination/` are the safe fallback.
- Additional Enterprise seats help only after the correct account/app has org
membership, target repo write permission, SSO/PAT authorization, or GitHub
App installation scope.
## Handoff states
| State | Meaning |
| --- | --- |
| `ready-for-owner-apply` | Patch exists, local validation evidence exists, and owner/proxy can apply it to the target repo. |
| `needs-target-runner` | Patch exists, but target-native tools such as `lake build` must run in the sibling repo before completion claims. |
| `blocked-by-access` | Direct push remains blocked from this runtime. |
| `complete` | Reserved for future use only after target PR merge and green target CI evidence. |
## Operator flow after access is fixed
1. Run `npm run cross-repo:handoff:audit`.
2. Pick one handoff entry.
3. Apply the patch to the target repo feature branch.
4. Run all `targetValidationRequired` commands in that repo.
5. Open a target-repo PR.
6. Wait for target CI.
7. Only then update A11oy readiness from `roadmap` /
`lean-backed-needs-upstream-ci` to a stronger status.
## Forbidden claims
Do not say:
- “complete”
- “production-ready”
- “all green”
- “zero sorry”
- “catalog accepted”
- “endorsed”
- “deployed to target repo”
unless the target repo has the patch applied, native validation passed, CI is
green, and public release/docs evidence exists.
## Validation
```bash
npm run cross-repo:handoff:audit
```
This validation is offline: it checks patch/status paths, patch SHA-256 values,
target repos against the Enterprise access checklist, and claim-boundary
language. It does not push to sibling repos.
|