Approve structured issue candidates in /app before they sync to GitLab: no silent auto-publish.
Who this is forEngineering leads and reviewers accountable for production issue quality.
Prerequisites- Completed audit with reviewable issue candidates.
- GitLab publish credentials and label permissions.
Review findings
- Audits → Findings: filter by severity, inspect trace and evidence, and drill into graph-backed lineage.
- Actions: Confirm, Dismiss, edit synthesis, or proceed to publish flow.
- Merged/split findings stay traceable in lineage view.
Edit synthesis
- Update title, description, why-it-matters, and recommendation before publish.
- Persist edits via the audit issue edit API: versions tracked for auditability.
- Validation gates reject malformed candidates before they reach publish.
Publish to GitLab
- Approve + Publish creates a GitLab issue with configured labels (work item attributes).
- Published URL stored on the issue candidate; syncStatus tracked for reconciliation.
- Dry-run locally with PREMORTEM_PUBLISH_DRY_RUN=1 when testing.
Reconcile drift
- Dashboard reconciliation events show matched, drifted, or failed sync states.
- POST /api/issues/reconcile compares local snapshot vs remote GitLab issue.
- Investigate driftFields when title, labels, or state diverge.
Expected result
Published GitLab issues with Premortem metadata, labels, and reconciliation tracking.
Was this article helpful?
