Skip to content

Contributions

This section covers how matic turns worktree-bound changes into reviewable contributions on shared repositories, then pulls provider feedback back into the runtime. It matters because shared surfaces in matic are never mutated ad hoc: branch publication, review, checks, comments, and merge all need stable contracts that preserve auditability and human control. Read these pages to understand the provider-neutral model first, then the provider-specific adapters and lifecycle details.

Creation

How matic creates a contribution from a prepared branch or worktree, including the canonical request shape, metadata, and publication flow. Read more

Comment Ingestion

How provider-native comments, review notes, and discussion events are normalized back into signals matic can route, attribute, and act on. Read more

Provider Interface

The shared contract that contribution providers implement so the rest of matic can create, inspect, update, and close contributions without hard-coding GitHub or GitLab semantics. Read more

GitHub Adapter

How the provider interface maps onto GitHub pull requests, reviews, comments, check runs, and merge operations. Read more

GitLab Adapter

How the same contribution contract maps onto GitLab merge requests, discussions, pipeline state, and merge behavior. Read more

Review And Merge

The end of the contribution lifecycle: reviewer decisions, merge eligibility, human approval points, and the transition from open review to integrated change. Read more

Status Checks

How CI, validation, and other external check systems are observed and reduced into contribution status that matic can use for gating and operator visibility. Read more