Skip to content

first-run-transcript.md

Latest commit

 

History

History
118 lines (89 loc) · 3.59 KB

first-run-transcript.md

File metadata and controls

118 lines (89 loc) · 3.59 KB
Raw

First Run Transcript

Historical: this transcript is pinned to the published v1.4.0 shape and is not updated for the current published v1.4.2 release. Use Install And Bootstrap and Try Code Mower In 10 Minutes for current guidance.

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.