code-mower 0.5.0b51__tar.gz → 0.5.0b52__tar.gz

{code_mower-0.5.0b51 → code_mower-0.5.0b52}/MANIFEST.in

@@ -1,9 +1,11 @@
 recursive-include src/code_mower/templates *.yml *.yaml *.json
 recursive-include src/code_mower/templates *.md
 recursive-include src/code_mower/templates *.j2
+recursive-include src/code_mower/templates/lanes *
 recursive-include src/code_mower/templates/product-support *
 include src/code_mower/*.json
 recursive-include templates *.j2 *.json *.md *.yml *.yaml
+recursive-include templates/lanes *
 include requirements/*.txt
 include LICENSE
 include NOTICE

{code_mower-0.5.0b51 → code_mower-0.5.0b52}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-mower
-Version: 0.5.0b51
+Version: 0.5.0b52
 Summary: Multi-reviewer AI code audit orchestration
 License-Expression: Apache-2.0
 Requires-Python: >=3.11
@@ -19,6 +19,9 @@ Code Mower helps teams set up AI peer-programmer and reviewer lanes on real
 GitHub pull requests, then measure which builders and reviewers are useful on
 their actual codebase.
 
+Code Mower is beta, bring-your-own-agent-loop software for teams willing to
+calibrate reviewers. It is not a drop-in autonomous merge gate.
+
 The short version:
 
 - create safe, manual-first reviewer lanes for Codex, Claude, Gitar, and other
@@ -97,46 +100,26 @@ known-blocked control, and three reviewer lanes. It shows the decision Code
 Mower is built to support: which AI reviewers are useful, noisy, expensive,
 fast, or eligible for stronger merge policy on your actual codebase.
 
-## Try It First
-
-Code Mower currently targets Python 3.11+; Python 3.12 is recommended.
-
-```bash
-python3.12 --version
-pipx install --python python3.12 code-mower==0.5.0b51
-code-mower --version
-```
-
-`0.5.0b51` is a beta release. Until Code Mower publishes a stable `1.0`
-line, use the explicit beta version above or allow prereleases with:
+## Start Here
 
-```bash
-pipx install --python python3.12 --pip-args="--pre" code-mower
-```
+Choose one path. Each path has one guide and gets to one visible outcome.
 
-From the repository you want to pilot:
-
-```bash
-code-mower init --easy
-code-mower doctor --preflight
-code-mower checks detect --json
-```
+| Path | Use When | Route | Guide |
+| --- | --- | --- | --- |
+| A. Reviewer gate in 10 minutes | You want one audited PR before recurring workflows or builder dispatch. | Install, run `init --easy`, run `doctor --preflight`, open a small setup PR, run Codex and Claude audits, then merge manually when the audit evidence is clean. | [Try Code Mower In 10 Minutes](docs/try-in-10-minutes.md) |
+| B. Build loop in 30 minutes | You want builders plus an orchestrator pattern after the reviewer gate works. | Complete path A, then add the automation token, require `code-mower/gate` from Any source, enable repository auto-merge, prove the self-hosted Mac lane runner with `doctor --runner`, run `init --builders`, and dispatch the first issue. | [Build Loop In 30 Minutes](docs/build-loop-in-30-minutes.md) |
 
-In Git worktrees, `checks detect` also offers `code-mower.pr-size`, a local
-PR-size lint that defaults to 300 changed lines and flags large batches of
-near-identical files.
+The beta.52 announcement entry point remains the tagged
+[Try Code Mower In 10 Minutes](https://github.com/codemower-ai/code-mower/blob/v0.5.0-beta.52/docs/try-in-10-minutes.md)
+guide.
 
-When those look sane, write the generated setup to a reviewable folder and
-produce the starter local report:
+## What Calibration Does And Does Not Prove
 
-```bash
-code-mower init --easy --apply --output-dir .code-mower.generated
-code-mower calibration value-report .code-mower.generated/calibration-corpus.json \
-  --output .code-mower/reviewer-value-report.md
-```
+The generated starter corpus proves that the commands run and the report path
+works. It does not prove that a reviewer should gate merges. Promote reviewer
+lanes only after repository-specific known-clean and known-blocked evidence
+meets the [lane promotion policy](docs/lane-promotion-policy.md).
 
-The generated setup also includes the configurable owner escalation and weekly
-status digest templates. The generated starter corpus proves the command path.
 To bootstrap a draft from your repository history:
 
 ```bash
@@ -155,7 +138,7 @@ First-time command map: [docs/launch-command-surface.md](docs/launch-command-sur
 
 The current PyPI beta has been rehearsed end-to-end from a clean install:
 [First-User Install Rehearsal](docs/first-user-install-rehearsal.md) records
-the latest 10/10 public-package readiness proof for `code-mower==0.5.0b51`.
+the latest 10/10 public-package readiness proof for `code-mower==0.5.0b52`.
 
 ## Optional: Plan Before Coding
 
@@ -205,6 +188,15 @@ That lets CodeMower.com show `issue -> plan -> work order -> builder run -> PR
 transcripts, prompts, or issue body text. See
 [docs/builders-grok-cursor.md](docs/builders-grok-cursor.md).
 
+## Roles
+
+Code Mower records builder provenance for Claude Code, Codex, Cursor-style
+hosted builders, and similar authoring lanes, then runs reviewer lanes against
+the resulting pull requests. The orchestrator is a workflow convention: issue,
+optional work order, single-writer branch, reviewer lanes, and fix rounds. Code
+Mower's templates now support that loop end to end; humans still own
+credentials, branch protection, calibration, and owner decisions.
+
 ## Why Not Just Run Codex Or Claude Yourself?
 
 You should, at first. Code Mower is not a replacement for a good local agent or
@@ -301,18 +293,18 @@ engineer can:
 7. optionally upload sanitized metadata to CodeMower.com and see useful team
    dashboard signal.
 
-Future builder/orchestrator experiments extend the same loop from "who reviews
-best?" to "which AI builder plus reviewer loop ships best on this product?" See
+Build-loop templates extend the same loop from "who reviews best?" to "which AI
+builder plus reviewer loop ships best on this product?" Start with
+[docs/build-loop-in-30-minutes.md](docs/build-loop-in-30-minutes.md), then use
 [docs/builder-experiments.md](docs/builder-experiments.md) and
-[docs/authoring-intelligence.md](docs/authoring-intelligence.md). For hosted
-builder provenance, start with
-[docs/builders-grok-cursor.md](docs/builders-grok-cursor.md).
+[docs/authoring-intelligence.md](docs/authoring-intelligence.md) for deeper
+measurement work.
 
 ## Installation Status
 
-The current public beta is `v0.5.0-beta.51` from
+The current public beta is `v0.5.0-beta.52` from
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), published
-as `code-mower==0.5.0b51` on [PyPI](https://pypi.org/project/code-mower/).
+as `code-mower==0.5.0b52` on [PyPI](https://pypi.org/project/code-mower/).
 GitHub releases remain the auditable source for tags, build artifacts, and
 release notes.
 
@@ -349,7 +341,19 @@ The wrapper resolves Python 3.12+ and refuses stale or old system Python shims.
 ## Docs Map
 
 - [Try Code Mower In 10 Minutes](docs/try-in-10-minutes.md)
-- [Quickstart](docs/quickstart.md)
+- [Build Loop In 30 Minutes](docs/build-loop-in-30-minutes.md)
+- [Quickstart Reference](docs/quickstart.md)
+- [Planning And Work Orders](docs/planning-work-orders.md)
+- [Builder Providers: Grok And Cursor](docs/builders-grok-cursor.md)
+- [Build Loop Operations](docs/build-loop.md)
+- [Self-Hosted Mac Runner](docs/self-hosted-mac-runner.md)
+- [Local Audit Runner](docs/local-audit-runner.md)
+- [Lane Standing Instructions](docs/lanes/README.md)
+- [Codex Lane Standing Instructions](docs/lanes/codex.md)
+- [Claude Lane Standing Instructions](docs/lanes/claude.md)
+- [Cursor Hosted Lane Standing Instructions](docs/lanes/grok.md)
+- [Provider Matrix](docs/provider-matrix.md)
+- [GitHub Setup](docs/github-setup.md)
 - [First Run Transcript](docs/first-run-transcript.md)
 - [First-User Demo Transcript](docs/first-user-demo-transcript.md)
 - [First-User Install Rehearsal](docs/first-user-install-rehearsal.md)
@@ -358,8 +362,7 @@ The wrapper resolves Python 3.12+ and refuses stale or old system Python shims.
 - [PyPI Release Runbook](docs/pypi-release.md)
 - [Sample Doctor Output](docs/sample-doctor-output.md)
 - [Architecture](docs/architecture.md)
-- [Provider Matrix](docs/provider-matrix.md)
-- [GitHub Setup](docs/github-setup.md)
+- [Lane Promotion Policy](docs/lane-promotion-policy.md)
 - [Cloud Sharing](docs/cloud-sharing.md)
 - [Cloud Data Contract](docs/cloud-data-contract.md)
 - [Privacy And Threat Model](docs/privacy-threat-model.md)

{code_mower-0.5.0b51 → code_mower-0.5.0b52}/README.md

@@ -4,6 +4,9 @@ Code Mower helps teams set up AI peer-programmer and reviewer lanes on real
 GitHub pull requests, then measure which builders and reviewers are useful on
 their actual codebase.
 
+Code Mower is beta, bring-your-own-agent-loop software for teams willing to
+calibrate reviewers. It is not a drop-in autonomous merge gate.
+
 The short version:
 
 - create safe, manual-first reviewer lanes for Codex, Claude, Gitar, and other
@@ -82,46 +85,26 @@ known-blocked control, and three reviewer lanes. It shows the decision Code
 Mower is built to support: which AI reviewers are useful, noisy, expensive,
 fast, or eligible for stronger merge policy on your actual codebase.
 
-## Try It First
-
-Code Mower currently targets Python 3.11+; Python 3.12 is recommended.
-
-```bash
-python3.12 --version
-pipx install --python python3.12 code-mower==0.5.0b51
-code-mower --version
-```
-
-`0.5.0b51` is a beta release. Until Code Mower publishes a stable `1.0`
-line, use the explicit beta version above or allow prereleases with:
+## Start Here
 
-```bash
-pipx install --python python3.12 --pip-args="--pre" code-mower
-```
+Choose one path. Each path has one guide and gets to one visible outcome.
 
-From the repository you want to pilot:
-
-```bash
-code-mower init --easy
-code-mower doctor --preflight
-code-mower checks detect --json
-```
+| Path | Use When | Route | Guide |
+| --- | --- | --- | --- |
+| A. Reviewer gate in 10 minutes | You want one audited PR before recurring workflows or builder dispatch. | Install, run `init --easy`, run `doctor --preflight`, open a small setup PR, run Codex and Claude audits, then merge manually when the audit evidence is clean. | [Try Code Mower In 10 Minutes](docs/try-in-10-minutes.md) |
+| B. Build loop in 30 minutes | You want builders plus an orchestrator pattern after the reviewer gate works. | Complete path A, then add the automation token, require `code-mower/gate` from Any source, enable repository auto-merge, prove the self-hosted Mac lane runner with `doctor --runner`, run `init --builders`, and dispatch the first issue. | [Build Loop In 30 Minutes](docs/build-loop-in-30-minutes.md) |
 
-In Git worktrees, `checks detect` also offers `code-mower.pr-size`, a local
-PR-size lint that defaults to 300 changed lines and flags large batches of
-near-identical files.
+The beta.52 announcement entry point remains the tagged
+[Try Code Mower In 10 Minutes](https://github.com/codemower-ai/code-mower/blob/v0.5.0-beta.52/docs/try-in-10-minutes.md)
+guide.
 
-When those look sane, write the generated setup to a reviewable folder and
-produce the starter local report:
+## What Calibration Does And Does Not Prove
 
-```bash
-code-mower init --easy --apply --output-dir .code-mower.generated
-code-mower calibration value-report .code-mower.generated/calibration-corpus.json \
-  --output .code-mower/reviewer-value-report.md
-```
+The generated starter corpus proves that the commands run and the report path
+works. It does not prove that a reviewer should gate merges. Promote reviewer
+lanes only after repository-specific known-clean and known-blocked evidence
+meets the [lane promotion policy](docs/lane-promotion-policy.md).
 
-The generated setup also includes the configurable owner escalation and weekly
-status digest templates. The generated starter corpus proves the command path.
 To bootstrap a draft from your repository history:
 
 ```bash
@@ -140,7 +123,7 @@ First-time command map: [docs/launch-command-surface.md](docs/launch-command-sur
 
 The current PyPI beta has been rehearsed end-to-end from a clean install:
 [First-User Install Rehearsal](docs/first-user-install-rehearsal.md) records
-the latest 10/10 public-package readiness proof for `code-mower==0.5.0b51`.
+the latest 10/10 public-package readiness proof for `code-mower==0.5.0b52`.
 
 ## Optional: Plan Before Coding
 
@@ -190,6 +173,15 @@ That lets CodeMower.com show `issue -> plan -> work order -> builder run -> PR
 transcripts, prompts, or issue body text. See
 [docs/builders-grok-cursor.md](docs/builders-grok-cursor.md).
 
+## Roles
+
+Code Mower records builder provenance for Claude Code, Codex, Cursor-style
+hosted builders, and similar authoring lanes, then runs reviewer lanes against
+the resulting pull requests. The orchestrator is a workflow convention: issue,
+optional work order, single-writer branch, reviewer lanes, and fix rounds. Code
+Mower's templates now support that loop end to end; humans still own
+credentials, branch protection, calibration, and owner decisions.
+
 ## Why Not Just Run Codex Or Claude Yourself?
 
 You should, at first. Code Mower is not a replacement for a good local agent or
@@ -286,18 +278,18 @@ engineer can:
 7. optionally upload sanitized metadata to CodeMower.com and see useful team
    dashboard signal.
 
-Future builder/orchestrator experiments extend the same loop from "who reviews
-best?" to "which AI builder plus reviewer loop ships best on this product?" See
+Build-loop templates extend the same loop from "who reviews best?" to "which AI
+builder plus reviewer loop ships best on this product?" Start with
+[docs/build-loop-in-30-minutes.md](docs/build-loop-in-30-minutes.md), then use
 [docs/builder-experiments.md](docs/builder-experiments.md) and
-[docs/authoring-intelligence.md](docs/authoring-intelligence.md). For hosted
-builder provenance, start with
-[docs/builders-grok-cursor.md](docs/builders-grok-cursor.md).
+[docs/authoring-intelligence.md](docs/authoring-intelligence.md) for deeper
+measurement work.
 
 ## Installation Status
 
-The current public beta is `v0.5.0-beta.51` from
+The current public beta is `v0.5.0-beta.52` from
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), published
-as `code-mower==0.5.0b51` on [PyPI](https://pypi.org/project/code-mower/).
+as `code-mower==0.5.0b52` on [PyPI](https://pypi.org/project/code-mower/).
 GitHub releases remain the auditable source for tags, build artifacts, and
 release notes.
 
@@ -334,7 +326,19 @@ The wrapper resolves Python 3.12+ and refuses stale or old system Python shims.
 ## Docs Map
 
 - [Try Code Mower In 10 Minutes](docs/try-in-10-minutes.md)
-- [Quickstart](docs/quickstart.md)
+- [Build Loop In 30 Minutes](docs/build-loop-in-30-minutes.md)
+- [Quickstart Reference](docs/quickstart.md)
+- [Planning And Work Orders](docs/planning-work-orders.md)
+- [Builder Providers: Grok And Cursor](docs/builders-grok-cursor.md)
+- [Build Loop Operations](docs/build-loop.md)
+- [Self-Hosted Mac Runner](docs/self-hosted-mac-runner.md)
+- [Local Audit Runner](docs/local-audit-runner.md)
+- [Lane Standing Instructions](docs/lanes/README.md)
+- [Codex Lane Standing Instructions](docs/lanes/codex.md)
+- [Claude Lane Standing Instructions](docs/lanes/claude.md)
+- [Cursor Hosted Lane Standing Instructions](docs/lanes/grok.md)
+- [Provider Matrix](docs/provider-matrix.md)
+- [GitHub Setup](docs/github-setup.md)
 - [First Run Transcript](docs/first-run-transcript.md)
 - [First-User Demo Transcript](docs/first-user-demo-transcript.md)
 - [First-User Install Rehearsal](docs/first-user-install-rehearsal.md)
@@ -343,8 +347,7 @@ The wrapper resolves Python 3.12+ and refuses stale or old system Python shims.
 - [PyPI Release Runbook](docs/pypi-release.md)
 - [Sample Doctor Output](docs/sample-doctor-output.md)
 - [Architecture](docs/architecture.md)
-- [Provider Matrix](docs/provider-matrix.md)
-- [GitHub Setup](docs/github-setup.md)
+- [Lane Promotion Policy](docs/lane-promotion-policy.md)
 - [Cloud Sharing](docs/cloud-sharing.md)
 - [Cloud Data Contract](docs/cloud-data-contract.md)
 - [Privacy And Threat Model](docs/privacy-threat-model.md)

{code_mower-0.5.0b51 → code_mower-0.5.0b52}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code-mower"
-version = "0.5.0b51"
+version = "0.5.0b52"
 description = "Multi-reviewer AI code audit orchestration"
 requires-python = ">=3.11"
 readme = "README.md"
@@ -31,6 +31,7 @@ code_mower = [
     "templates/**/*.yml",
     "templates/**/*.yaml",
     "templates/**/*.j2",
+    "templates/lanes/*",
     "templates/product-support/*",
 ]
 

{code_mower-0.5.0b51 → code_mower-0.5.0b52}/src/code_mower/__init__.py

@@ -1,3 +1,3 @@
 """Code Mower package."""
 
-__version__ = "0.5.0b51"
+__version__ = "0.5.0b52"

{code_mower-0.5.0b51 → code_mower-0.5.0b52}/src/code_mower/audit_labeler_lib.py

@@ -22,6 +22,14 @@ from typing import Any, Callable, Dict, Mapping, Optional, Pattern, Sequence
 from urllib.parse import quote
 import re
 
+if __package__:
+    try:
+        from . import decisions as code_mower_decisions
+    except ImportError:  # pragma: no cover - copied tools fallback
+        import decisions as code_mower_decisions  # type: ignore
+else:  # pragma: no cover - direct helper execution
+    import decisions as code_mower_decisions  # type: ignore
+
 MIN_ABBREVIATED_SHA_LENGTH = 7
 AUTHOR_EXCLUSION_ENV = "CODE_MOWER_AUTHOR_EXCLUSION_JSON"
 ACTIONS_RUN_MARKER_RE = re.compile(
@@ -58,6 +66,35 @@ class ActionsRunMarker:
     body_sha256: str
 
 
+@dataclass(frozen=True)
+class AuditVerdict:
+    verdict: str
+    updated_at: str
+    created_at: str
+    comment_id: int
+    comment_index: int
+    run_id: str
+
+    def sort_key(self) -> tuple[str, str, int, int]:
+        return (self.updated_at, self.created_at, self.comment_id, self.comment_index)
+
+
+@dataclass(frozen=True)
+class AuditRunInFlight:
+    run_id: str
+    job_name: str
+    queued_since: str
+    run_status: str
+    job_status: str
+    job_conclusion: str
+
+    def description(self) -> str:
+        run_id = self.run_id or "unknown"
+        job_name = self.job_name or "unknown"
+        queued_since = self.queued_since or "unknown"
+        return f"run {run_id} job {job_name!r} queued since {queued_since}"
+
+
 @dataclass(frozen=True)
 class LaneConfig:
     name: str
@@ -71,6 +108,7 @@ class LaneConfig:
     pass_patterns: tuple[Pattern[str], ...]
     blocked_patterns: tuple[Pattern[str], ...]
     label_state_fallbacks: bool = False
+    decision_coverage: bool = False
     token_env_vars: tuple[str, ...] = ("GITHUB_TOKEN",)
 
     @functools.lru_cache(maxsize=1)
@@ -364,7 +402,12 @@ def audit_comment_head_sha(body: str) -> str:
     return match.group(1) if match else ""
 
 
-def terminal_audit_trailer_verdict(lane: Mapping[str, Any], body: str) -> str:
+def terminal_audit_trailer_verdict(
+    lane: Mapping[str, Any],
+    body: str,
+    *,
+    decisions: Sequence[code_mower_decisions.DecisionRecord] = (),
+) -> str:
     candidates: list[tuple[int, str]] = []
     for label_key, verdict in (("done", "done"), ("blocked", "blocked")):
         label = str(lane.get(label_key) or "")
@@ -375,7 +418,18 @@ def terminal_audit_trailer_verdict(lane: Mapping[str, Any], body: str) -> str:
             candidates.append((index, verdict))
     if not candidates:
         return ""
-    return max(candidates, key=lambda item: item[0])[1]
+    verdict = max(candidates, key=lambda item: item[0])[1]
+    if (
+        verdict == "blocked"
+        and lane.get("decision_coverage") is True
+        and code_mower_decisions.audit_blockers_are_decision_covered(
+            body,
+            decisions,
+            lane=str(lane.get("author_lane") or lane.get("id") or ""),
+        )
+    ):
+        return "done"
+    return verdict
 
 
 def current_audit_trailer_verdict(
@@ -383,10 +437,11 @@ def current_audit_trailer_verdict(
     body: str,
     *,
     head_sha: str,
+    decisions: Sequence[code_mower_decisions.DecisionRecord] = (),
 ) -> str:
     if "Head SHA: `" + head_sha + "`" not in body:
         return ""
-    return terminal_audit_trailer_verdict(lane, body)
+    return terminal_audit_trailer_verdict(lane, body, decisions=decisions)
 
 
 def latest_current_audit_verdict(
@@ -398,14 +453,45 @@ def latest_current_audit_verdict(
         [Mapping[str, Any], str, str, object, str | None],
         bool,
     ],
+    decision_authorities: Sequence[str] = (),
 ) -> str:
-    verdicts: list[tuple[tuple[str, str, int, int], str]] = []
+    verdict = latest_current_audit_verdict_detail(
+        lane,
+        comments,
+        head_sha=head_sha,
+        trusted_comment_author=trusted_comment_author,
+        decision_authorities=decision_authorities,
+    )
+    return verdict.verdict if verdict else ""
+
+
+def latest_current_audit_verdict_detail(
+    lane: Mapping[str, Any],
+    comments: Sequence[Mapping[str, Any]],
+    *,
+    head_sha: str,
+    trusted_comment_author: Callable[
+        [Mapping[str, Any], str, str, object, str | None],
+        bool,
+    ],
+    decision_authorities: Sequence[str] = (),
+) -> AuditVerdict | None:
+    verdicts: list[AuditVerdict] = []
+    decisions = code_mower_decisions.collect_decision_records_from_comments(
+        comments,
+        authorities=decision_authorities,
+    )
     for index, comment in enumerate(comments):
         author = str(((comment.get("user") or {}).get("login")) or "")
         body = str(comment.get("body") or "")
         if not trusted_comment_author(lane, author, body, comment.get("id"), None):
             continue
-        verdict = current_audit_trailer_verdict(lane, body, head_sha=head_sha)
+        verdict = current_audit_trailer_verdict(
+            lane,
+            body,
+            head_sha=head_sha,
+            decisions=decisions,
+        )
         if verdict:
             try:
                 comment_id = int(comment.get("id") or 0)
@@ -419,10 +505,46 @@ def latest_current_audit_verdict(
                 or ""
             )
             created = str(comment.get("created_at") or comment.get("createdAt") or "")
-            verdicts.append(((updated, created, comment_id, index), verdict))
+            verdicts.append(
+                AuditVerdict(
+                    verdict=verdict,
+                    updated_at=updated,
+                    created_at=created,
+                    comment_id=comment_id,
+                    comment_index=index,
+                    run_id=parse_audit_run_id(body),
+                )
+            )
     if verdicts:
-        return max(verdicts, key=lambda item: item[0])[1]
-    return ""
+        return max(verdicts, key=lambda item: item.sort_key())
+    return None
+
+
+def audit_verdict_newer_than_in_flight(
+    verdict: AuditVerdict | None,
+    detail: AuditRunInFlight,
+) -> bool:
+    if (
+        verdict is None
+        or verdict.verdict != "done"
+        or not verdict.updated_at
+        or not detail.queued_since
+    ):
+        return False
+    try:
+        verdict_run_id = int(verdict.run_id)
+        detail_run_id = int(detail.run_id)
+    except (TypeError, ValueError):
+        verdict_run_id = None
+        detail_run_id = None
+    if verdict_run_id is not None and detail_run_id is not None:
+        if verdict_run_id != detail_run_id:
+            return verdict_run_id > detail_run_id
+    if verdict.updated_at > detail.queued_since:
+        return True
+    if verdict.updated_at != detail.queued_since:
+        return False
+    return False
 
 
 def attested_non_current_audit_heads(
@@ -502,23 +624,69 @@ def audit_job_matches_lane(job: Mapping[str, Any], lane: Mapping[str, Any]) -> b
     return any(token in name for token in _audit_lane_match_tokens(lane))
 
 
-def audit_run_in_flight_for_lane(
+def _audit_mapping_timestamp(item: Mapping[str, Any], keys: Sequence[str]) -> str:
+    for key in keys:
+        value = str(item.get(key) or "")
+        if value:
+            return value
+    return ""
+
+
+def audit_run_queued_since(
+    run: Mapping[str, Any],
+    job: Mapping[str, Any] | None = None,
+) -> str:
+    if job is not None:
+        job_time = _audit_mapping_timestamp(
+            job,
+            (
+                "queued_at",
+                "queuedAt",
+                "started_at",
+                "startedAt",
+                "created_at",
+                "createdAt",
+                "completed_at",
+                "completedAt",
+            ),
+        )
+        if job_time:
+            return job_time
+    return _audit_mapping_timestamp(
+        run,
+        (
+            "created_at",
+            "createdAt",
+            "queued_at",
+            "queuedAt",
+            "run_started_at",
+            "runStartedAt",
+            "started_at",
+            "startedAt",
+            "updated_at",
+            "updatedAt",
+        ),
+    )
+
+
+def audit_run_in_flight_detail_for_lane(
     entry: Mapping[str, Any],
     lane: Mapping[str, Any],
     *,
     head_sha: str,
     pr_number: int | str,
-) -> bool:
+) -> AuditRunInFlight | None:
     run = entry.get("run") if isinstance(entry.get("run"), Mapping) else entry
     if not isinstance(run, Mapping):
-        return False
-    if str(run.get("status") or "") not in AUDIT_RUN_NON_TERMINAL_STATUSES:
-        return False
+        return None
+    run_status = str(run.get("status") or "")
+    if run_status not in AUDIT_RUN_NON_TERMINAL_STATUSES:
+        return None
     workflows = parse_csv_set(str(lane.get("github_actions_workflows") or ""))
     if not workflow_path_matches(audit_run_workflow_path(run), workflows):
-        return False
+        return None
     if not audit_run_matches_pr_head(run, head_sha=head_sha, pr_number=pr_number):
-        return False
+        return None
     jobs = entry.get("jobs") if isinstance(entry.get("jobs"), list) else []
     non_terminal_jobs = [
         job
@@ -530,8 +698,45 @@ def audit_run_in_flight_for_lane(
         )
     ]
     if non_terminal_jobs:
-        return any(audit_job_matches_lane(job, lane) for job in non_terminal_jobs)
-    return bool(entry.get("jobs_fetch_failed") or not jobs)
+        for job in non_terminal_jobs:
+            if audit_job_matches_lane(job, lane):
+                return AuditRunInFlight(
+                    run_id=str(run.get("id") or ""),
+                    job_name=str(job.get("name") or ""),
+                    queued_since=audit_run_queued_since(run, job),
+                    run_status=run_status,
+                    job_status=str(job.get("status") or ""),
+                    job_conclusion=str(job.get("conclusion") or ""),
+                )
+        return None
+    if entry.get("jobs_fetch_failed") or not jobs:
+        return AuditRunInFlight(
+            run_id=str(run.get("id") or ""),
+            job_name="jobs unavailable",
+            queued_since=audit_run_queued_since(run),
+            run_status=run_status,
+            job_status="unknown",
+            job_conclusion="",
+        )
+    return None
+
+
+def audit_run_in_flight_for_lane(
+    entry: Mapping[str, Any],
+    lane: Mapping[str, Any],
+    *,
+    head_sha: str,
+    pr_number: int | str,
+) -> bool:
+    return (
+        audit_run_in_flight_detail_for_lane(
+            entry,
+            lane,
+            head_sha=head_sha,
+            pr_number=pr_number,
+        )
+        is not None
+    )
 
 
 def _pr_item_matches_head(