Skip to content

first-run-transcript.md

Latest commit

 

History

History
113 lines (85 loc) · 3.34 KB

first-run-transcript.md

File metadata and controls

113 lines (85 loc) · 3.34 KB
Raw

First Run Transcript

This page shows the intended first-run shape before a user installs anything. It is a static transcript, not a guarantee that every machine will produce the same provider warnings.

Install

python3.12 --version
export CODE_MOWER_PYTHON="$(command -v python3.12)"
pipx install --python "$CODE_MOWER_PYTHON" code-mower==1.4.0
code-mower --version

Expected shape:

Python 3.12.x
code-mower 1.4.0

Generate Local Setup

From the repository you want to pilot:

code-mower init --easy
code-mower init --easy --apply --output-dir .code-mower.generated

Expected shape:

Code Mower easy-mode setup

Profile: recommended local/manual reviewer lanes
Writes: .code-mower.generated/
Default posture:
- local structured audits first
- hosted/SaaS lanes informational until calibrated
- no recurring reviewer schedules
- no cloud upload unless explicitly configured

Run Doctor

code-mower doctor --supervised-pilot --repo OWNER/REPO

Shortened example:

PASS  config.validate             config validates
PASS  profile.select              selected profile: codex, claude_audit
PASS  runtime.python              Python 3.12 satisfies Code Mower requirements
PASS  runtime.github_auth         GitHub CLI auth probe succeeded
PASS  runtime.local_cli codex     codex found
PASS  runtime.local_cli claude    claude auth smoke probe succeeded
OWNER-ACTION github.human_automation_token OWNER/REPO is missing the DISPATCH_TOKEN human automation token secret
PROMOTION-TODO github.branch_protection owner/repo@main requires code-mower/gate from GitHub Actions instead of Any source
PROMOTION-TODO github.repo.auto_merge owner/repo does not allow auto-merge
WARN  github.actions_cost         private repo has high-frequency metadata workflows
PASS  cloud.token                 optional Code Mower Cloud token file is configured

Summary: warn, 24 checks, 1 owner action, 2 promotion todos, 4 warnings
Next: create DISPATCH_TOKEN, keep manual merges during pilot, then finish the promotion todos before enabling unattended merge.

The warnings are useful. They show what is safe for a manual pilot and what must be fixed before promoted mode can let green audit evidence drive merge.

Generate The Starter Value Report

code-mower calibration auto-discover \
  --repo OWNER/REPO \
  --last-n 20 \
  --output .code-mower/draft-calibration-corpus.json

code-mower calibration value-report .code-mower/draft-calibration-corpus.json \
  --output .code-mower/draft-reviewer-value-report.md

code-mower calibration value-report .code-mower.generated/calibration-corpus.json \
  --output .code-mower/reviewer-value-report.md

Expected shape:

Wrote .code-mower/reviewer-value-report.md
Wrote .code-mower/draft-reviewer-value-report.md

The generated starter corpus proves the command path. The auto-discovered draft corpus uses recent PR metadata to reduce blank-page friction, but it is not an adjudicator. Confirm every disposition before using a report to promote reviewer lanes.

Optional Cloud Dry Run

code-mower cloud export \
  --report value-report=.code-mower/reviewer-value-report.md \
  --output-dir .code-mower/cloud-benchmark-bundle \
  --anonymous \
  --json

code-mower cloud upload .code-mower/cloud-benchmark-bundle --dry-run --json

Nothing uploads unless the user passes --yes.