code-mower 0.6.0b2__tar.gz → 0.6.0b3__tar.gz

{code_mower-0.6.0b2 → code_mower-0.6.0b3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-mower
-Version: 0.6.0b2
+Version: 0.6.0b3
 Summary: Multi-reviewer AI code audit orchestration
 License-Expression: Apache-2.0
 Requires-Python: >=3.11
@@ -57,15 +57,16 @@ Code Mower should feel like an engineering tool, not a demo harness:
 
 ## What It Looks Like
 
-`code-mower doctor --preflight` is the first useful command. It checks your
-runtime, GitHub setup, provider CLIs, token posture, optional cloud setup, and
-private-repo Actions cost traps. `--preflight` is the friendly first-run preset;
-`doctor --v05` remains an equivalent compatibility alias for older scripts.
+`code-mower doctor --adoption --repo OWNER/REPO` is the first useful command
+for a real repository. It checks your runtime, GitHub setup, provider CLIs,
+token posture, optional cloud setup, private-repo Actions cost traps, and
+first-run adoption gaps. `--preflight` remains the compatibility preset for
+older scripts; `--adoption` adds explicit repo targeting and setup guidance.
 
 Example, shortened:
 
 ```text
-$ code-mower doctor --preflight
+$ code-mower doctor --adoption --repo OWNER/REPO
 PASS  config.validate             config validates
 PASS  profile.select              selected profile: codex, claude_audit, gitar
 PASS  runtime.python              Python 3.12 satisfies Code Mower requirements
@@ -112,12 +113,12 @@ observable.
 
 | 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) |
+| A. Reviewer gate in 10 minutes | You want one audited PR before recurring workflows or builder dispatch. | Install, run `init --easy`, run `doctor --adoption --repo OWNER/REPO`, 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) |
 | C. Builder experiment | You want to compare authoring loops before trusting them broadly. | Use a work order or experiment spec, run `code-mower builder-experiment run` around an explicit command, then review the source-free `authoringRun` artifact and normal audit evidence. | [Builder Experiments](docs/builder-experiments.md) |
 
 The v0.6 beta announcement entry point is the tagged
-[Try Code Mower In 10 Minutes](https://github.com/codemower-ai/code-mower/blob/v0.6.0-beta.2/docs/try-in-10-minutes.md)
+[Try Code Mower In 10 Minutes](https://github.com/codemower-ai/code-mower/blob/v0.6.0-beta.3/docs/try-in-10-minutes.md)
 guide.
 
 ## What Calibration Does And Does Not Prove
@@ -147,7 +148,7 @@ Provider-contract baseline for the next release train:
 
 For release verification,
 [First-User Install Rehearsal](docs/first-user-install-rehearsal.md) records
-the package-index procedure for `v0.6.0-beta.2` / `code-mower==0.6.0b2`. The
+the package-index procedure for `v0.6.0-beta.3` / `code-mower==0.6.0b3`. The
 GitHub release records the workflow and rehearsal evidence for the exact tag.
 
 ## Optional: Plan Before Coding
@@ -309,7 +310,7 @@ engineer can:
 
 1. install Code Mower in a clean repo;
 2. understand the local/cloud trust boundary;
-3. run `init --easy` and `doctor --preflight`;
+3. run `init --easy` and `doctor --adoption --repo OWNER/REPO`;
 4. run `lanes status --repo OWNER/REPO` to see active lanes and gate state;
 5. detect and run the repo's native lint/test/build surface instead of assuming
    every project uses the same tools;
@@ -328,8 +329,8 @@ measurement work.
 
 ## Installation Status
 
-The current public beta baseline is `v0.6.0-beta.2`, with pinned package-index
-install spec `code-mower==0.6.0b2`. Release evidence is recorded on the GitHub
+The current public beta baseline is `v0.6.0-beta.3`, with pinned package-index
+install spec `code-mower==0.6.0b3`. Release evidence is recorded on the GitHub
 release and in the first-user install rehearsal. The public repository is
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), and
 GitHub releases remain the auditable source for tags, build artifacts, and
@@ -372,6 +373,7 @@ first so local work exercises the same package entrypoint users install.
 - [Try Code Mower In 10 Minutes](docs/try-in-10-minutes.md)
 - [Build Loop In 30 Minutes](docs/build-loop-in-30-minutes.md)
 - [Quickstart Reference](docs/quickstart.md)
+- [Orchestrator Prompt Pack](docs/orchestrator-prompt-pack.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)

{code_mower-0.6.0b2 → code_mower-0.6.0b3}/README.md

@@ -42,15 +42,16 @@ Code Mower should feel like an engineering tool, not a demo harness:
 
 ## What It Looks Like
 
-`code-mower doctor --preflight` is the first useful command. It checks your
-runtime, GitHub setup, provider CLIs, token posture, optional cloud setup, and
-private-repo Actions cost traps. `--preflight` is the friendly first-run preset;
-`doctor --v05` remains an equivalent compatibility alias for older scripts.
+`code-mower doctor --adoption --repo OWNER/REPO` is the first useful command
+for a real repository. It checks your runtime, GitHub setup, provider CLIs,
+token posture, optional cloud setup, private-repo Actions cost traps, and
+first-run adoption gaps. `--preflight` remains the compatibility preset for
+older scripts; `--adoption` adds explicit repo targeting and setup guidance.
 
 Example, shortened:
 
 ```text
-$ code-mower doctor --preflight
+$ code-mower doctor --adoption --repo OWNER/REPO
 PASS  config.validate             config validates
 PASS  profile.select              selected profile: codex, claude_audit, gitar
 PASS  runtime.python              Python 3.12 satisfies Code Mower requirements
@@ -97,12 +98,12 @@ observable.
 
 | 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) |
+| A. Reviewer gate in 10 minutes | You want one audited PR before recurring workflows or builder dispatch. | Install, run `init --easy`, run `doctor --adoption --repo OWNER/REPO`, 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) |
 | C. Builder experiment | You want to compare authoring loops before trusting them broadly. | Use a work order or experiment spec, run `code-mower builder-experiment run` around an explicit command, then review the source-free `authoringRun` artifact and normal audit evidence. | [Builder Experiments](docs/builder-experiments.md) |
 
 The v0.6 beta announcement entry point is the tagged
-[Try Code Mower In 10 Minutes](https://github.com/codemower-ai/code-mower/blob/v0.6.0-beta.2/docs/try-in-10-minutes.md)
+[Try Code Mower In 10 Minutes](https://github.com/codemower-ai/code-mower/blob/v0.6.0-beta.3/docs/try-in-10-minutes.md)
 guide.
 
 ## What Calibration Does And Does Not Prove
@@ -132,7 +133,7 @@ Provider-contract baseline for the next release train:
 
 For release verification,
 [First-User Install Rehearsal](docs/first-user-install-rehearsal.md) records
-the package-index procedure for `v0.6.0-beta.2` / `code-mower==0.6.0b2`. The
+the package-index procedure for `v0.6.0-beta.3` / `code-mower==0.6.0b3`. The
 GitHub release records the workflow and rehearsal evidence for the exact tag.
 
 ## Optional: Plan Before Coding
@@ -294,7 +295,7 @@ engineer can:
 
 1. install Code Mower in a clean repo;
 2. understand the local/cloud trust boundary;
-3. run `init --easy` and `doctor --preflight`;
+3. run `init --easy` and `doctor --adoption --repo OWNER/REPO`;
 4. run `lanes status --repo OWNER/REPO` to see active lanes and gate state;
 5. detect and run the repo's native lint/test/build surface instead of assuming
    every project uses the same tools;
@@ -313,8 +314,8 @@ measurement work.
 
 ## Installation Status
 
-The current public beta baseline is `v0.6.0-beta.2`, with pinned package-index
-install spec `code-mower==0.6.0b2`. Release evidence is recorded on the GitHub
+The current public beta baseline is `v0.6.0-beta.3`, with pinned package-index
+install spec `code-mower==0.6.0b3`. Release evidence is recorded on the GitHub
 release and in the first-user install rehearsal. The public repository is
 [codemower-ai/code-mower](https://github.com/codemower-ai/code-mower), and
 GitHub releases remain the auditable source for tags, build artifacts, and
@@ -357,6 +358,7 @@ first so local work exercises the same package entrypoint users install.
 - [Try Code Mower In 10 Minutes](docs/try-in-10-minutes.md)
 - [Build Loop In 30 Minutes](docs/build-loop-in-30-minutes.md)
 - [Quickstart Reference](docs/quickstart.md)
+- [Orchestrator Prompt Pack](docs/orchestrator-prompt-pack.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)

{code_mower-0.6.0b2 → code_mower-0.6.0b3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code-mower"
-version = "0.6.0b2"
+version = "0.6.0b3"
 description = "Multi-reviewer AI code audit orchestration"
 requires-python = ">=3.11"
 readme = "README.md"

{code_mower-0.6.0b2 → code_mower-0.6.0b3}/src/code_mower/__init__.py

@@ -1,3 +1,3 @@
 """Code Mower package."""
 
-__version__ = "0.6.0b2"
+__version__ = "0.6.0b3"

{code_mower-0.6.0b2 → code_mower-0.6.0b3}/src/code_mower/doctor.py

@@ -47,6 +47,8 @@ resolve_doctor_provider_templates_path = _doctor_checks.resolve_doctor_provider_
 run_doctor = _doctor_checks.run_doctor
 _token_file_mentions_cloud_token = _doctor_checks.token_file_mentions_cloud_token
 _apply_first_run_defaults = _doctor_checks.apply_first_run_defaults
+detect_repo_slug = _doctor_checks.detect_repo_slug
+normalize_repo_slug = _doctor_checks.normalize_repo_slug
 
 
 _DOCTOR_COMPAT_EXPORTS = (
@@ -101,6 +103,22 @@ def main(argv: Sequence[str] | None = None) -> int:
             "--profile recommended --probe-runtime --github --cloud"
         ),
     )
+    parser.add_argument(
+        "--adoption",
+        action="store_true",
+        help=(
+            "first-run adoption preset: run preflight checks against the "
+            "explicit or inferred GitHub repository and surface setup gaps"
+        ),
+    )
+    parser.add_argument(
+        "--repo",
+        metavar="OWNER/REPO",
+        help=(
+            "GitHub repository to inspect; adoption mode infers remote.origin "
+            "when omitted"
+        ),
+    )
     parser.add_argument("--probe-runtime", action="store_true")
     parser.add_argument(
         "--github",
@@ -136,16 +154,29 @@ def main(argv: Sequence[str] | None = None) -> int:
     parser.add_argument("--json", action="store_true")
     args = parser.parse_args(argv)
 
+    if args.adoption:
+        args.preflight = True
     _apply_first_run_defaults(args)
     if args.easy and args.profile is None:
         args.profile = "recommended"
 
     try:
+        repo_slug = ""
+        repo_source = ""
+        if args.repo:
+            repo_slug = normalize_repo_slug(args.repo, option="--repo")
+            repo_source = "explicit"
+        elif args.adoption:
+            repo_slug = detect_repo_slug(Path.cwd())
+            repo_source = "git_remote" if repo_slug else ""
         provider_templates_path = resolve_doctor_provider_templates_path(args.provider_templates)
         report = run_doctor(
             config_path=resolve_doctor_config_path(args.config, easy=args.easy),
             provider_templates_path=provider_templates_path,
             profile=args.profile,
+            repo_slug=repo_slug,
+            repo_source=repo_source,
+            adoption=args.adoption,
             probe_runtime=args.probe_runtime,
             github=args.github,
             cloud=args.cloud,
@@ -154,7 +185,7 @@ def main(argv: Sequence[str] | None = None) -> int:
             actions_cost_sample=args.actions_cost_sample,
             actionlint_bin=args.actionlint_bin,
         )
-    except code_mower_config.ConfigError as exc:
+    except (code_mower_config.ConfigError, ValueError) as exc:
         print(f"error: {exc}", file=sys.stderr)
         return 1
 

{code_mower-0.6.0b2 → code_mower-0.6.0b3}/src/code_mower/doctor_checks/__init__.py

@@ -12,6 +12,13 @@ from .cloud import (
     check_cloud_token_surface,
     token_file_mentions_cloud_token,
 )
+from .adoption import (
+    check_adoption_setup,
+    config_with_repository_target,
+    detect_repo_slug,
+    normalize_repo_slug,
+    repo_slug_from_remote,
+)
 from .common import (
     ACTIONS_COST_SAMPLE_DEFAULT,
     ACTIONS_COST_SAMPLE_MAX,
@@ -98,6 +105,7 @@ __all__ = [
     "auth_probe_output_detail",
     "build_doctor_run_plan",
     "check_cloud_token_surface",
+    "check_adoption_setup",
     "check_github_auth_surface",
     "check_macos_runner_launchagent",
     "check_github_setup",
@@ -116,7 +124,9 @@ __all__ = [
     "check_pytest",
     "check_python_runtime",
     "check_ripgrep",
+    "config_with_repository_target",
     "default_check_group_ids",
+    "detect_repo_slug",
     "doctor_check_group_id",
     "doctor_output_group",
     "effective_lane",
@@ -125,11 +135,13 @@ __all__ = [
     "human_automation_token_required",
     "load_inputs",
     "local_cli_probe_remediation",
+    "normalize_repo_slug",
     "provider_template_coverage",
     "render_doctor_text",
     "resolve_doctor_config_path",
     "resolve_doctor_config_path_for_script",
     "resolve_doctor_provider_templates_path",
+    "repo_slug_from_remote",
     "run_doctor",
     "selected_lanes",
     "token_file_mentions_cloud_token",

code_mower-0.6.0b3/src/code_mower/doctor_checks/adoption.py

@@ -0,0 +1,249 @@
+"""First-run adoption checks for doctor."""
+
+from __future__ import annotations
+
+import re
+import subprocess
+from pathlib import Path
+from typing import Any, Mapping
+
+from .models import STATUS_PASS, STATUS_WARN, DoctorCheck
+
+
+OWNER_REPO_RE = re.compile(r"^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$")
+OWNER_LOGIN_PLACEHOLDER = "TODO_OWNER_LOGIN"
+
+
+def normalize_repo_slug(value: str, *, option: str = "--repo") -> str:
+    """Return a validated GitHub owner/repo slug."""
+
+    slug = value.strip().strip("/")
+    if not OWNER_REPO_RE.fullmatch(slug):
+        raise ValueError(f"{option} expects an OWNER/REPO slug")
+    return slug
+
+
+def repo_slug_from_remote(remote_url: str) -> str:
+    """Extract owner/repo from common GitHub remote URL forms."""
+
+    remote = remote_url.strip()
+    if remote.startswith("git@github.com:"):
+        remote = remote.removeprefix("git@github.com:")
+    elif remote.startswith("https://github.com/"):
+        remote = remote.removeprefix("https://github.com/")
+    elif remote.startswith("http://github.com/"):
+        remote = remote.removeprefix("http://github.com/")
+    elif remote.startswith("ssh://git@github.com/"):
+        remote = remote.removeprefix("ssh://git@github.com/")
+    else:
+        return ""
+    remote = remote.removesuffix(".git").strip("/")
+    parts = remote.split("/")
+    if len(parts) < 2:
+        return ""
+    slug = f"{parts[0]}/{parts[1]}"
+    return slug if OWNER_REPO_RE.fullmatch(slug) else ""
+
+
+def detect_repo_slug(repo_path: Path, *, git_bin: str = "git") -> str:
+    """Detect the current checkout's GitHub owner/repo slug."""
+
+    try:
+        completed = subprocess.run(
+            [git_bin, "-C", str(repo_path), "config", "--get", "remote.origin.url"],
+            text=True,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+            check=False,
+        )
+    except OSError:
+        return ""
+    if completed.returncode != 0:
+        return ""
+    return repo_slug_from_remote(completed.stdout)
+
+
+def config_with_repository_target(
+    config: Mapping[str, Any],
+    repo_slug: str,
+) -> Mapping[str, Any]:
+    """Return a config copy whose GitHub checks target repo_slug."""
+
+    repositories = [
+        repo for repo in config.get("repositories") or [] if isinstance(repo, Mapping)
+    ]
+    source_repo = next(
+        (repo for repo in repositories if str(repo.get("slug") or "") == repo_slug),
+        repositories[0] if repositories else {},
+    )
+    default_branch = str(source_repo.get("default_branch") or "main")
+    local_path_env = str(source_repo.get("local_path_env") or "")
+    target: dict[str, str] = {"slug": repo_slug, "default_branch": default_branch}
+    if local_path_env:
+        target["local_path_env"] = local_path_env
+    return {**dict(config), "repositories": [target]}
+
+
+def _configured_owner_login(config: Mapping[str, Any] | None) -> str:
+    if not isinstance(config, Mapping):
+        return ""
+    owner_surface = config.get("owner_surface")
+    if not isinstance(owner_surface, Mapping):
+        return ""
+    return str(owner_surface.get("owner_login") or "").strip()
+
+
+def _configured_repositories(config: Mapping[str, Any] | None) -> list[str]:
+    if not isinstance(config, Mapping):
+        return []
+    slugs: list[str] = []
+    for repo in config.get("repositories") or []:
+        if isinstance(repo, Mapping) and repo.get("slug"):
+            slugs.append(str(repo.get("slug")))
+    return slugs
+
+
+def check_adoption_setup(
+    *,
+    config: Mapping[str, Any] | None,
+    config_path: Path,
+    adoption: bool,
+    repo_slug: str,
+    repo_source: str,
+    using_packaged_example: bool,
+) -> tuple[DoctorCheck, ...]:
+    """Return first-run adoption posture checks."""
+
+    if not adoption and not repo_slug and not using_packaged_example:
+        return ()
+
+    checks: list[DoctorCheck] = []
+    if repo_slug:
+        checks.append(
+            DoctorCheck(
+                name="doctor.repo",
+                status=STATUS_PASS,
+                message=f"GitHub target repository: {repo_slug}",
+                detail={"repo": repo_slug, "source": repo_source or "explicit"},
+            )
+        )
+    elif not adoption:
+        pass
+    else:
+        checks.append(
+            DoctorCheck(
+                name="doctor.repo",
+                status=STATUS_WARN,
+                message="adoption checks could not infer the GitHub repository",
+                detail={"repo": "", "source": ""},
+                remediation=(
+                    "Run from a GitHub checkout or pass "
+                    "`code-mower doctor --adoption --repo OWNER/REPO`."
+                ),
+            )
+        )
+
+    repositories = _configured_repositories(config)
+    if using_packaged_example:
+        checks.append(
+            DoctorCheck(
+                name="doctor.adoption.config_source",
+                status=STATUS_WARN,
+                message="using packaged starter config for adoption checks",
+                detail={
+                    "config_path": str(config_path),
+                    "configured_repositories": repositories,
+                    "effective_repository": repo_slug,
+                },
+                remediation=(
+                    "Run `code-mower init --easy --apply`, review the generated "
+                    "setup, and commit an edited code-mower.yml before relying "
+                    "on recurring workflows."
+                ),
+            )
+        )
+    else:
+        checks.append(
+            DoctorCheck(
+                name="doctor.adoption.config_source",
+                status=STATUS_PASS,
+                message="using repository Code Mower config",
+                detail={
+                    "config_path": str(config_path),
+                    "configured_repositories": repositories,
+                    "effective_repository": repo_slug,
+                },
+            )
+        )
+
+    if (
+        repo_slug
+        and repo_source == "git_remote"
+        and repositories
+        and repo_slug not in repositories
+        and not using_packaged_example
+    ):
+        checks.append(
+            DoctorCheck(
+                name="doctor.adoption.repo_mismatch",
+                status=STATUS_WARN,
+                message="remote origin does not match code-mower.yml repositories",
+                detail={
+                    "inferred_repository": repo_slug,
+                    "configured_repositories": repositories,
+                },
+                remediation=(
+                    "Pass `--repo OWNER/REPO` to choose an explicit target, or "
+                    "update code-mower.yml or remote.origin.url so doctor and "
+                    "the committed config agree."
+                ),
+            )
+        )
+
+    if not adoption and not repo_slug:
+        return tuple(checks)
+
+    owner_login = _configured_owner_login(config)
+    if not owner_login or owner_login.lower() == OWNER_LOGIN_PLACEHOLDER.lower():
+        checks.append(
+            DoctorCheck(
+                name="doctor.adoption.owner_login",
+                status=STATUS_WARN,
+                message="owner_surface.owner_login is not configured",
+                detail={"owner_login": owner_login},
+                remediation=(
+                    "Set owner_surface.owner_login to the decision owner's "
+                    "GitHub login before trusting manual decisions or owner "
+                    "notifications."
+                ),
+            )
+        )
+    else:
+        checks.append(
+            DoctorCheck(
+                name="doctor.adoption.owner_login",
+                status=STATUS_PASS,
+                message=f"owner decision login configured: {owner_login}",
+                detail={"owner_login": owner_login},
+            )
+        )
+
+    checks.append(
+        DoctorCheck(
+            name="doctor.adoption.trusted_authors",
+            status=STATUS_WARN,
+            message="human-run audit comments must be listed as trusted lane authors",
+            detail={
+                "variables": [
+                    "CLAUDE_AUDIT_BOT_AUTHORS",
+                    "CODEX_BOT_AUTHORS",
+                ]
+            },
+            remediation=(
+                "For manual pilot audits, set repository variables such as "
+                "CLAUDE_AUDIT_BOT_AUTHORS and CODEX_BOT_AUTHORS to the "
+                "GitHub logins that may post trusted audit verdicts."
+            ),
+        )
+    )
+    return tuple(checks)

{code_mower-0.6.0b2 → code_mower-0.6.0b3}/src/code_mower/doctor_checks/github_repo.py

@@ -146,6 +146,11 @@ def check_repo_auto_merge(*, slug: str, repo_payload: Mapping[str, Any]) -> Doct
         remediation=(
             None
             if allow_auto_merge
-            else f"Enable repository auto-merge with `gh api -X PATCH repos/{slug} -f allow_auto_merge=true`."
+            else (
+                "During an informational pilot this is expected; enable "
+                "repository auto-merge only when a reviewer lane meets "
+                "docs/lane-promotion-policy.md and code-mower/gate is required. "
+                f"Promotion command: `gh api -X PATCH repos/{slug} -f allow_auto_merge=true`."
+            )
         ),
     )

{code_mower-0.6.0b2 → code_mower-0.6.0b3}/src/code_mower/doctor_checks/registry.py

@@ -27,6 +27,7 @@ class DoctorCheckStage:
 
 DEFAULT_CHECK_GROUPS = (
     DoctorCheckGroup("runtime", "Python, package, and local toolchain checks"),
+    DoctorCheckGroup("setup", "First-run adoption and repository targeting checks"),
     DoctorCheckGroup("github", "GitHub auth, workflow, and private-repo cost checks"),
     DoctorCheckGroup("providers", "Reviewer provider CLI and secret checks"),
     DoctorCheckGroup("cloud", "Optional CodeMower.com token and service checks"),
@@ -59,6 +60,12 @@ OPTIONAL_DOCTOR_STAGES = (
         "Inspect a self-hosted macOS local audit runner",
         optional=True,
     ),
+    DoctorCheckStage(
+        "adoption",
+        "setup",
+        "Inspect first-run adoption posture and selected repository target",
+        optional=True,
+    ),
 )
 
 
@@ -71,10 +78,16 @@ def build_doctor_run_plan(
     github: bool = False,
     cloud: bool = False,
     runner: bool = False,
+    adoption: bool = False,
 ) -> tuple[DoctorCheckStage, ...]:
     """Return the named stages that a doctor run will execute."""
 
     stages = list(BASE_DOCTOR_STAGES)
-    optional_flags = {"github": github, "cloud": cloud, "runner": runner}
+    optional_flags = {
+        "github": github,
+        "cloud": cloud,
+        "runner": runner,
+        "adoption": adoption,
+    }
     stages.extend(stage for stage in OPTIONAL_DOCTOR_STAGES if optional_flags.get(stage.id, False))
     return tuple(stages)

{code_mower-0.6.0b2 → code_mower-0.6.0b3}/src/code_mower/doctor_checks/runner.py

@@ -7,6 +7,7 @@ from typing import Any, Mapping
 
 from code_mower import config as code_mower_config
 
+from .adoption import check_adoption_setup, config_with_repository_target
 from .audit_limits import check_effective_audit_limits
 from .cloud import check_cloud_token_surface
 from .common import ACTIONS_COST_SAMPLE_DEFAULT, load_inputs
@@ -79,6 +80,9 @@ def run_doctor(
     config_path: Path,
     provider_templates_path: Path,
     profile: str | None,
+    repo_slug: str = "",
+    repo_source: str = "",
+    adoption: bool = False,
     probe_runtime: bool = False,
     github: bool = False,
     cloud: bool = False,
@@ -87,13 +91,31 @@ def run_doctor(
     actions_cost_sample: int = ACTIONS_COST_SAMPLE_DEFAULT,
     actionlint_bin: str = "actionlint",
 ) -> DoctorReport:
-    plan = build_doctor_run_plan(github=github, cloud=cloud, runner=runner)
+    plan = build_doctor_run_plan(
+        github=github,
+        cloud=cloud,
+        runner=runner,
+        adoption=adoption or bool(repo_slug),
+    )
     enabled_stages = {stage.id for stage in plan}
     # `doctor --easy` can inspect the packaged example before a repo has written
     # code-mower.yml. In that mode the example should teach the user about stale
     # guards without failing because product workflow files are not installed yet.
     repo_root = None if config_path.name == "code-mower.example.yml" else config_path.parent
     config, templates, checks = load_inputs(config_path, provider_templates_path)
+    using_packaged_example = config_path.name == "code-mower.example.yml"
+    checks.extend(
+        check_adoption_setup(
+            config=config,
+            config_path=config_path,
+            adoption=adoption,
+            repo_slug=repo_slug,
+            repo_source=repo_source,
+            using_packaged_example=using_packaged_example,
+        )
+    )
+    if config is not None and repo_slug:
+        config = config_with_repository_target(config, repo_slug)
     checks.append(
         _run_plan_check(
             plan,