Skip to content
mobilintPublic

About

Mobilint GitHub default .github repository.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

GitHub clones

Mobilint shared GitHub automation

This repository provides Mobilint's shared GitHub workflow templates and centrally managed Codex pull-request review policy.

Consumer repositories use a small .github/workflows/code-review.yml caller. Review limits, trust checks, official-Codex fallback behavior, reactions, sandbox policy, and runner selection remain in the central reusable workflow, so routine policy updates do not require hand-editing every repository.

The managed caller supports:

  • automatic review for trusted pull-request authors;
  • direct @mobilint-review requests from trusted commenters in PR comments, review comments, and submitted review bodies;
  • temporary 👀 acknowledgement, removed even when a queued review is canceled, followed by a review, visible error, or 👍 for a clean result;
  • central P0/P1/P2 review findings on the self-hosted Codex reviewer.

The official workflow template is workflow-templates/code-review.yml. Its central .github/workflows/code-review.yml example is synchronized automatically. Mobilint maintainers still copy the caller into consumer repositories. The manifest and local audit tool help detect consumer drift, but no unattended cross-repository credential workflow is installed.

Maintainers should use the automation operations guide for architecture, enrollment, manual synchronization, validation, release, and rollback procedures.

The reusable workflow pins the review action to an immutable commit and forwards the mode selected by its event gate. Direct action users may omit mode to infer auto for pull requests or mention for comment/review events.

The reusable workflow always uses the read-only sandbox and disables unsafe fallback. The deprecated allow_unsafe_no_sandbox_fallback input is accepted for compatibility but ignored, regardless of its value.

Caller audits also inspect existing automation branches when the default caller is current. Synchronization rejects symlink callers and repairs untrusted automation branch changes before retaining managed PR metadata.

Codex and Claude share repository guidance through symlinks: edit AGENTS.md and .agents/skills; CLAUDE.md and .claude/skills use those same files.

Multiple review runners

The central workflow targets runner group codex and label codex-reviewer. GitHub assigns eligible queued jobs to any idle matching runner. Each online matching runner can execute one review at a time; additional eligible jobs wait for capacity. Add or remove registrations to grow or shrink the pool without changing production routing. This does not bypass the trust gate or per-PR concurrency policy. See the maintainer guide for setup and the manual pool check.

Official connector quota fallback

The central reusable workflow checks official output immediately, then every 15 seconds during the configured wait (five minutes by default). A recognized quota or review-credit error from chatgpt-codex-connector[bot] starts local fallback on the next check, including “You have reached your Codex usage limits for code reviews.” Completed reviews or 👍 end the wait immediately. Silence retains the timeout; mention reviews bypass it. Checks use the triggering PR event timestamp, require the current head for reviews, and ignore matching text from other authors or older comments. An eyes reaction does not end polling early because the connector can report quota failure afterward. Trust gates and runner scheduling still apply.

This behavior is implemented in the central workflow, not the action. Consumers pinned to older workflow SHAs need a reviewed caller-pin update after this central change merges; their behavior does not change merely by updating the action. Keep timeout, author, timestamp, and head guards covered by regression tests when editing fallback detection. Polling uses one bounded GraphQL query per check for the newest 100 reviews, comments, and reactions. Partial API errors fail visibly. Configured waits accept 0–20 minutes; invalid or larger values use the five-minute default, leaving headroom within the 30-minute gate timeout.

Managed callers pin the central review workflow to a reviewed full commit SHA. Workflow updates and rollbacks reach consumers through reviewed caller pin updates; changing the central default branch alone does not update those callers.

Review model selection

The canaried action accepts model (default gpt-6-luna) and reasoning_effort (default max). The central workflow forwards both settings. Selection is explicit on the Codex CLI and appears in the job summary; interactive user configuration is ignored for review execution. Unsupported effort values and invalid model identifiers fall back to the defaults. A valid identifier still requires a model available to the authenticated account.

These changes take effect for consumers only after the action canary, central SHA promotion, and caller-pin rollout described in the maintainer guide. Runner installation and add/remove procedures are maintained in mobilint/.github's maintainer guide.

Flexible runner capacity checks

The runner pool can grow or shrink without changing production review routing. The manual pool probe accepts a positive whole-number job count; its default of 5 is the current deployment example. It uses the validated count for both matrix size and parallelism, within GitHub's platform limit of 256 matrix jobs. Select the capacity you want to check and compare distinct runner identities; queued jobs can reuse runners when the pool is smaller or busy. The optional authenticated Luna/max smoke check remains available for every selected job.

About

Mobilint GitHub default .github repository.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages