ma-open-mr

MA open PR/MR

Create or bind every approved project's PR/MR, then persist evidence that Phase 6 can recheck. Never treat a URL or human-formatted CLI output as proof — use provider JSON (gh ... --json, glab ... -F json / API) for every metadata claim. Deterministic contract scripts are not included in v1; perform each stated validation yourself before proceeding.

Invocation

/ma-open-mr ISSUE-KEY [--project PROJECT] [--draft] [--auto]

Without --project, process all projects in canonical approval. A partial run may save valid project evidence, but Phase 6 stays incomplete until the approved and recorded project sets match exactly.

References index

File	When to read
references/diagrams.md	Step 2 — only when a diagram materially helps the body
references/gitlab-uploads.md	Step 2 — GitLab UI uploads, only with real UI evidence

Canonical inputs

Read {stateRoot}/ISSUE-KEY/state.json and the workspace config.

• Require gates.implementationApproval.status == "approved" and use only gates.implementationApproval.projects[project].{base,target}.
• Require the exact same project set in state.worktrees; each entry supplies path, base, and target.
• Require workspace platform to be github or gitlab, the path to be a real Git worktree root on target, and origin to match the eventual PR/MR URL.
• Expand only a leading ~/. Reject shell syntax, control characters, missing paths, branch drift, extra projects, and duplicate paths. Never use eval.

Ownership policy

Resolve policy from approval.projects[project].mrPolicy, then the workspace config project mrPolicy, then the top-level mrPolicy. Approval has precedence.

{"mrPolicy":{"assignee":"alice","reviewers":["bob"],"reviewRequired":true}}

• Assignee may default to the authenticated author (gh api user / glab api user).
• Review is required by default. Resolve reviewers from explicit state/config; when none is configured, the reviewer defaults to the MR author (single-operator self-review model). Each reviewer must be a stable username; self-review by the author is permitted.
• Only an explicitly approved reviewRequired:false permits no reviewer.
• In --auto, halt when a reviewer is rejected by the provider or absent from the MR after creation. Never fabricate a reviewer other than the author default.
• Re-query the provider right after creation to confirm assignee/reviewers are non-empty — the omission is silent otherwise.