code-mower 1.5.1__tar.gz → 1.5.2__tar.gz

{code_mower-1.5.1 → code_mower-1.5.2}/MANIFEST.in

@@ -4,8 +4,7 @@ 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 release.yml
 recursive-include docs *.md
 include requirements/*.txt
 include LICENSE

{code_mower-1.5.1 → code_mower-1.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-mower
-Version: 1.5.1
+Version: 1.5.2
 Summary: Multi-reviewer AI code audit orchestration
 License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/codemower-ai/code-mower
@@ -45,15 +45,15 @@ Code Mower is supervised-pilot, bring-your-own-agent-loop software.
 It is not a drop-in unattended merge gate. Humans still own credentials,
 repository policy, reviewer promotion, and exceptional decisions.
 
-This source defines Code Mower `v1.5.1`, with package spec
-`code-mower==1.5.1`. Confirm the release tag on GitHub Releases and the package
-version on the selected index before using an index install command; source
-version and publication state are separate facts. See the
-[v1.5.1 release notes](https://github.com/codemower-ai/code-mower/blob/main/docs/v151-release-notes.md)
-and [qualification contract](https://github.com/codemower-ai/code-mower/blob/main/docs/v151-qualification.md).
-After publication, the GitHub Release and linked release issue carry the
-observed source SHA, artifact digests, canary outcomes, publication run and
-reinstall evidence.
+<!-- code-mower:release-facts:start -->
+This source defines Code Mower `v1.5.2`, with package spec
+`code-mower==1.5.2`. Confirm the release tag on GitHub Releases and the package
+version on the selected index before using an index install command; source version
+and publication state are separate facts.
+Python 3.12 or newer is required.
+See the [release notes](https://github.com/codemower-ai/code-mower/blob/main/docs/v152-release-notes.md)
+and [qualification contract](https://github.com/codemower-ai/code-mower/blob/main/docs/v152-qualification.md).
+<!-- code-mower:release-facts:end -->
 Historical v1.4.x artifacts and qualification records remain unchanged.
 The v1.4.2 release did not claim the bounded hosted Devin canary tracked by
 [#951](https://github.com/codemower-ai/code-mower/issues/951); that result is
@@ -61,7 +61,7 @@ not claimed by its immutable qualification record.
 
 Documentation on `main` follows the source on `main`. For an installed release,
 read its immutable versioned guide, such as the
-[`v1.5.1` guide](https://github.com/codemower-ai/code-mower/blob/v1.5.1/docs/try-in-10-minutes.md),
+[`v1.5.2` guide](https://github.com/codemower-ai/code-mower/blob/v1.5.2/docs/try-in-10-minutes.md),
 and confirm the tag and package exist before using pinned install commands.
 
 ## What Code Mower Adds
@@ -84,55 +84,27 @@ promotion requirements.
 
 ## Start Here
 
-Code Mower requires Python 3.12 or newer. A laptop or workstation should use
-one stable `pipx` installation:
+Use the maintained journey for the task you are doing:
 
-```bash
-python3.12 --version
-export CODE_MOWER_PYTHON="$(command -v python3.12)"
-pipx install --python "$CODE_MOWER_PYTHON" code-mower==1.5.1
-command -v code-mower
-code-mower --version
-```
-
-`command -v code-mower` should print the path you expect and `code-mower
---version` should print `code-mower 1.5.1` before you point Code Mower at a
-repository. If you do not have pipx, install it from the
-[official pipx installation guide](https://pipx.pypa.io/stable/installation/).
+1. [Install And Bootstrap](https://github.com/codemower-ai/code-mower/blob/main/docs/install.md) with the supported pipx, uv, or
+   contributor path.
+2. [Run the first repository setup](https://github.com/codemower-ai/code-mower/blob/main/docs/quickstart.md) and keep the initial
+   Claude + Codex reviewer gate manual.
+3. For an existing integration, follow the
+   [upgrade guide](https://github.com/codemower-ai/code-mower/blob/main/docs/upgrade-existing-repo.md) before copying generated files.
+4. Operate the local Board through the
+   [service lifecycle guide](https://github.com/codemower-ai/code-mower/blob/main/docs/board-service-lifecycle.md).
+5. Use [troubleshooting](https://github.com/codemower-ai/code-mower/blob/main/docs/troubleshooting.md) when a check or provider is
+   not ready.
 
-Hosted agents and CI machines can use `uv tool install` after installing uv
-from the [official uv installation guide](https://docs.astral.sh/uv/getting-started/installation/);
-contributors should use `scripts/dev-python` and an editable virtual
-environment. The [Install And Bootstrap](https://github.com/codemower-ai/code-mower/blob/main/docs/install.md) guide gives the exact
-cold-install, upgrade, optional Coworker, and contributor commands.
+The install guide owns exact package commands. The quickstart owns the first
+repository workflow. Supporting runbooks link to those contracts instead of
+copying version-sensitive setup blocks.
 
-From the repository you want to pilot:
-
-```bash
-code-mower init --easy
-code-mower init --easy --apply --output-dir .code-mower.generated
-code-mower doctor --adoption --repo OWNER/REPO
-code-mower lanes status --repo OWNER/REPO
-```
-
-`init --easy` previews the Claude + Codex setup and changes nothing. `--apply`
-writes a reviewable generated tree; it does not copy those files into your
-repository, start a provider, enable auto-merge, or upload data. Review and
-edit the generated configuration before opening the setup PR.
-
-To inspect representative output first, use the
+To inspect representative output before installing, use the
 [synthetic calibration example](https://github.com/codemower-ai/code-mower/blob/main/examples/demo-calibration/README.md) and
 [Board demo](https://github.com/codemower-ai/code-mower/blob/main/examples/board-demo/README.md).
 
-Follow [Try Code Mower In 10 Minutes](https://github.com/codemower-ai/code-mower/blob/main/docs/try-in-10-minutes.md) to run Codex
-and Claude manually against that first PR. Automation tokens, recurring
-dispatch, branch-protection changes, and auto-merge are not prerequisites for
-the manual reviewer-gate pilot.
-
-After the first peer-review loop works, follow
-[Build Loop In 30 Minutes](https://github.com/codemower-ai/code-mower/blob/main/docs/build-loop-in-30-minutes.md) to add automated
-builder dispatch and the stricter promoted-pilot repository settings.
-
 ## Participants And Sessions
 
 Choose participants interactively or explicitly:
@@ -166,7 +138,8 @@ ID with `session lease renew --session-id SESSION_ID` or `session lease release
 --dry-run` or `--no-lease` for read-only work.
 
 Codex, Claude Code, and Cursor are qualified for the shared session, telemetry,
-lease, and Jira-authority contract in v1.5.0. Devin, Grok Bot, Antigravity,
+lease, and Jira-authority contract in the current v1.5.2 release. Devin, Grok
+Bot, Antigravity,
 Muse, and custom hosts are recognized for briefs and provenance, while their
 execution remains an explicit handoff or provider-specific transport. See
 [Participants And Sessions](https://github.com/codemower-ai/code-mower/blob/main/docs/sessions.md) and the
@@ -293,8 +266,9 @@ and the [Cloud Data Contract](https://github.com/codemower-ai/code-mower/blob/ma
 
 ## Optional Hosted Slack
 
-v1.5.0 adds a basic Slack control surface for one private workspace and one
-authorized private, unshared channel. A Code Mower team administrator opens
+v1.5.2 retains the basic Slack control surface introduced in v1.5.0 for one
+private workspace and one authorized private, unshared channel. A Code Mower
+team administrator opens
 **Setup → Manage Slack integration** in the hosted dashboard and completes OAuth
 as a Slack workspace administrator. Ordinary hosted setup does not require a
 local manifest, Slack app creation, or Slack credentials on the user's machine.
@@ -321,7 +295,7 @@ for both workflows, supported behavior, and the trust boundary.
 
 ## Current Capabilities And Limits
 
-| Area | v1.5.1 posture |
+| Area | v1.5.2 posture |
 | --- | --- |
 | Default builders and reviewers | Claude Code + Codex |
 | Session hosts | Codex, Claude Code, and Cursor qualified; other identities recognized but require explicit handoff/provider transport |
@@ -335,7 +309,7 @@ for both workflows, supported behavior, and the trust boundary.
 
 GitLab, Bitbucket, broad unattended rollout, uncalibrated merge gates, Devin
 peer-orchestrator/reviewer parity, a hosted work-order CLI, a required Graphify
-dependency, Slack telemetry/Board links, and rich Slack UX are outside v1.5.1. The current priorities
+dependency, Slack telemetry/Board links, and rich Slack UX are outside v1.5.2. The current priorities
 and boundaries are recorded in
 [Current State And Roadmap](https://github.com/codemower-ai/code-mower/blob/main/docs/current-state-and-roadmap.md).
 
@@ -343,7 +317,7 @@ and boundaries are recorded in
 
 Graphify's optional bounded provider foundation landed in v1.4.0; its complete
 qualified integration, scorecard and query behavior shipped in v1.4.1 and
-remain available in v1.5.0. It is separately installed into an operator-owned
+remain available in v1.5.2. It is separately installed into an operator-owned
 environment, explicitly activated, and outside the base dependency set: a
 default Claude + Codex install adds no Graphify dependency, no indexer, no
 background service, and no watcher.
@@ -362,9 +336,9 @@ for what a build is allowed to see and where its state lives, and
 [Bounded Queries And Context Packets](https://github.com/codemower-ai/code-mower/blob/main/docs/context-graph-queries.md) for the
 four questions and the packet contract.
 
-v1.5.0 includes #1007's bounded 16 MiB provider-manifest reader, `doc_ref`
-non-code exclusions, JavaScript/TypeScript related-test conventions and import
-relationships, plus parser/runtime/single-worker guidance. #1031 makes search
+The v1.5.x line includes #1007's bounded 16 MiB provider-manifest reader,
+`doc_ref` non-code exclusions, JavaScript/TypeScript related-test conventions
+and import relationships, plus parser/runtime/single-worker guidance. #1031 makes search
 readiness agree with the installed query reader and preserves usable bounded
 partial answers. The accepted `graphifyy==0.9.58` pin is unchanged. Upgrade does
 not repair existing graphs: explicitly refresh affected/partial generations,
@@ -375,77 +349,17 @@ does not need rebuilding. See
 
 ## Documentation
 
-### Install And First Use
-
-- [Install And Bootstrap](https://github.com/codemower-ai/code-mower/blob/main/docs/install.md)
-- [Try Code Mower In 10 Minutes](https://github.com/codemower-ai/code-mower/blob/main/docs/try-in-10-minutes.md)
-- [Upgrade An Existing Repository](https://github.com/codemower-ai/code-mower/blob/main/docs/upgrade-existing-repo.md)
-- [Quickstart Reference](https://github.com/codemower-ai/code-mower/blob/main/docs/quickstart.md)
-- [Troubleshooting](https://github.com/codemower-ai/code-mower/blob/main/docs/troubleshooting.md)
-- [First Run Transcript](https://github.com/codemower-ai/code-mower/blob/main/docs/first-run-transcript.md) (v1.4.0 illustrative shape, not the v1.5.0 source pin)
-
-### Local Board And Repository Context
-
-- [Board Data Contract](https://github.com/codemower-ai/code-mower/blob/main/docs/board-data-contract.md)
-- [Board Service Lifecycle](https://github.com/codemower-ai/code-mower/blob/main/docs/board-service-lifecycle.md)
-- [Board Demo Rehearsal](https://github.com/codemower-ai/code-mower/blob/main/examples/board-demo/README.md)
-- [Optional Graphify Setup](https://github.com/codemower-ai/code-mower/blob/main/docs/graphify-setup.md)
-- [Local Repository Graph Lifecycle](https://github.com/codemower-ai/code-mower/blob/main/docs/context-graph-lifecycle.md)
-- [Bounded Queries And Context Packets](https://github.com/codemower-ai/code-mower/blob/main/docs/context-graph-queries.md)
-- [Graphify Evaluation Record](https://github.com/codemower-ai/code-mower/blob/main/docs/graphify-evaluation.md) (historical decision, 2026-09-12)
-
-### Sessions, Builders, And Reviewers
-
-- [Participants And Sessions](https://github.com/codemower-ai/code-mower/blob/main/docs/sessions.md)
-- [Build Loop In 30 Minutes](https://github.com/codemower-ai/code-mower/blob/main/docs/build-loop-in-30-minutes.md)
-- [Build Loop Operations](https://github.com/codemower-ai/code-mower/blob/main/docs/build-loop.md)
-- [Planning And Work Orders](https://github.com/codemower-ai/code-mower/blob/main/docs/planning-work-orders.md)
-- [Builder Experiments](https://github.com/codemower-ai/code-mower/blob/main/docs/builder-experiments.md)
-- [Orchestrator Prompt Pack](https://github.com/codemower-ai/code-mower/blob/main/docs/orchestrator-prompt-pack.md)
-- [Optional Devin Setup Prompt](https://github.com/codemower-ai/code-mower/blob/main/docs/devin-setup-prompt.md)
-- [Optional Slack Setup](https://github.com/codemower-ai/code-mower/blob/main/docs/slack-setup.md) (hosted dashboard OAuth for workspace administrators; separate manifest/readiness path for operators)
-- [Slack Authenticated Ingress Contract](https://github.com/codemower-ai/code-mower/blob/main/docs/slack-ingress.md) (standalone OSS adapter seam)
-- [Provider Matrix](https://github.com/codemower-ai/code-mower/blob/main/docs/provider-matrix.md)
-- [Provider Calibration Scorecard](https://github.com/codemower-ai/code-mower/blob/main/docs/provider-calibration-scorecard.md)
-- [Devin Peer-Support Qualification](https://github.com/codemower-ai/code-mower/blob/main/docs/devin-peer-support-qualification.md)
-- [Lane Standing Instructions](https://github.com/codemower-ai/code-mower/blob/main/docs/lanes/README.md)
-- [Codex Lane](https://github.com/codemower-ai/code-mower/blob/main/docs/lanes/codex.md)
-- [Claude Lane](https://github.com/codemower-ai/code-mower/blob/main/docs/lanes/claude.md)
-- [Cursor Lane](https://github.com/codemower-ai/code-mower/blob/main/docs/lanes/cursor.md)
-- [Devin Lane](https://github.com/codemower-ai/code-mower/blob/main/docs/lanes/devin.md)
-- [Self-Hosted Mac Runner](https://github.com/codemower-ai/code-mower/blob/main/docs/self-hosted-mac-runner.md)
-- [Local Audit Runner](https://github.com/codemower-ai/code-mower/blob/main/docs/local-audit-runner.md)
-
-### Context And Trackers
-
-- [Optional Organizational Context Setup](https://github.com/codemower-ai/code-mower/blob/main/docs/context-setup.md)
-- [Coworker Connections](https://github.com/codemower-ai/code-mower/blob/main/docs/context-connections.md)
-- [Context Delivery And Private Review](https://github.com/codemower-ai/code-mower/blob/main/docs/context-delivery.md)
-- [Context Provider Contract](https://github.com/codemower-ai/code-mower/blob/main/docs/context-provider-contract.md)
-- [Context Packet Schema](https://github.com/codemower-ai/code-mower/blob/main/docs/context-packet-schema.md)
-- [Jira Cloud Setup](https://github.com/codemower-ai/code-mower/blob/main/docs/jira-cloud-setup.md)
-- [Jira Adoption Rehearsal](https://github.com/codemower-ai/code-mower/blob/main/docs/jira-adoption-rehearsal.md)
-- [Work Tracker Data Contract](https://github.com/codemower-ai/code-mower/blob/main/docs/tracker-data-contract.md)
-
-### Trust, Operations, And Project Records
-
-- [Architecture](https://github.com/codemower-ai/code-mower/blob/main/docs/architecture.md)
-- [Current State And Roadmap](https://github.com/codemower-ai/code-mower/blob/main/docs/current-state-and-roadmap.md)
-- [Lane Promotion Policy](https://github.com/codemower-ai/code-mower/blob/main/docs/lane-promotion-policy.md)
-- [Privacy And Threat Model](https://github.com/codemower-ai/code-mower/blob/main/docs/privacy-threat-model.md)
-- [Cloud Data Contract](https://github.com/codemower-ai/code-mower/blob/main/docs/cloud-data-contract.md)
-- [Release Qualification](https://github.com/codemower-ai/code-mower/blob/main/docs/release-qualification.md)
-- [Public Release Checklist](https://github.com/codemower-ai/code-mower/blob/main/docs/public-release-checklist.md)
-- [v1.5.1 Release Notes](https://github.com/codemower-ai/code-mower/blob/main/docs/v151-release-notes.md)
-- [v1.4.2 Release Notes](https://github.com/codemower-ai/code-mower/blob/main/docs/v142-release-notes.md)
-- [v1.5.1 Qualification Contract](https://github.com/codemower-ai/code-mower/blob/main/docs/v151-qualification.md)
-- [v1.4.2 Qualification Record](https://github.com/codemower-ai/code-mower/blob/main/docs/v142-qualification.md)
-- [Release History And Archived Plans](https://github.com/codemower-ai/code-mower/blob/main/docs/release-history.md)
-- [Changelog](https://github.com/codemower-ai/code-mower/blob/main/CHANGELOG.md)
-- [Contributing](https://github.com/codemower-ai/code-mower/blob/main/CONTRIBUTING.md)
-- [Support](https://github.com/codemower-ai/code-mower/blob/main/SUPPORT.md)
-- [Security Policy](https://github.com/codemower-ai/code-mower/blob/main/SECURITY.md)
-- [Code of Conduct](https://github.com/codemower-ai/code-mower/blob/main/CODE_OF_CONDUCT.md)
+The generated [documentation index](https://github.com/codemower-ai/code-mower/blob/main/docs/README.md) lists every canonical guide
+and identifies supporting and historical material. The maintained user journey
+is [install](https://github.com/codemower-ai/code-mower/blob/main/docs/install.md), [first repository setup](https://github.com/codemower-ai/code-mower/blob/main/docs/quickstart.md),
+[upgrade](https://github.com/codemower-ai/code-mower/blob/main/docs/upgrade-existing-repo.md), [Board operation](https://github.com/codemower-ai/code-mower/blob/main/docs/board-service-lifecycle.md),
+and [troubleshooting](https://github.com/codemower-ai/code-mower/blob/main/docs/troubleshooting.md).
+
+For architecture, sessions, Graphify, Slack, Jira, provider selection, release
+operations, and the roadmap, use that index rather than a second hand-maintained
+link catalog here. See [Contributing](https://github.com/codemower-ai/code-mower/blob/main/CONTRIBUTING.md), [Support](https://github.com/codemower-ai/code-mower/blob/main/SUPPORT.md),
+[Security Policy](https://github.com/codemower-ai/code-mower/blob/main/SECURITY.md), and the [Code of Conduct](https://github.com/codemower-ai/code-mower/blob/main/CODE_OF_CONDUCT.md)
+for repository participation and support boundaries.
 
 ## License
 

{code_mower-1.5.1 → code_mower-1.5.2}/README.md

@@ -9,15 +9,15 @@ Code Mower is supervised-pilot, bring-your-own-agent-loop software.
 It is not a drop-in unattended merge gate. Humans still own credentials,
 repository policy, reviewer promotion, and exceptional decisions.
 
-This source defines Code Mower `v1.5.1`, with package spec
-`code-mower==1.5.1`. Confirm the release tag on GitHub Releases and the package
-version on the selected index before using an index install command; source
-version and publication state are separate facts. See the
-[v1.5.1 release notes](https://github.com/codemower-ai/code-mower/blob/main/docs/v151-release-notes.md)
-and [qualification contract](https://github.com/codemower-ai/code-mower/blob/main/docs/v151-qualification.md).
-After publication, the GitHub Release and linked release issue carry the
-observed source SHA, artifact digests, canary outcomes, publication run and
-reinstall evidence.
+<!-- code-mower:release-facts:start -->
+This source defines Code Mower `v1.5.2`, with package spec
+`code-mower==1.5.2`. Confirm the release tag on GitHub Releases and the package
+version on the selected index before using an index install command; source version
+and publication state are separate facts.
+Python 3.12 or newer is required.
+See the [release notes](https://github.com/codemower-ai/code-mower/blob/main/docs/v152-release-notes.md)
+and [qualification contract](https://github.com/codemower-ai/code-mower/blob/main/docs/v152-qualification.md).
+<!-- code-mower:release-facts:end -->
 Historical v1.4.x artifacts and qualification records remain unchanged.
 The v1.4.2 release did not claim the bounded hosted Devin canary tracked by
 [#951](https://github.com/codemower-ai/code-mower/issues/951); that result is
@@ -25,7 +25,7 @@ not claimed by its immutable qualification record.
 
 Documentation on `main` follows the source on `main`. For an installed release,
 read its immutable versioned guide, such as the
-[`v1.5.1` guide](https://github.com/codemower-ai/code-mower/blob/v1.5.1/docs/try-in-10-minutes.md),
+[`v1.5.2` guide](https://github.com/codemower-ai/code-mower/blob/v1.5.2/docs/try-in-10-minutes.md),
 and confirm the tag and package exist before using pinned install commands.
 
 ## What Code Mower Adds
@@ -48,55 +48,27 @@ promotion requirements.
 
 ## Start Here
 
-Code Mower requires Python 3.12 or newer. A laptop or workstation should use
-one stable `pipx` installation:
+Use the maintained journey for the task you are doing:
 
-```bash
-python3.12 --version
-export CODE_MOWER_PYTHON="$(command -v python3.12)"
-pipx install --python "$CODE_MOWER_PYTHON" code-mower==1.5.1
-command -v code-mower
-code-mower --version
-```
-
-`command -v code-mower` should print the path you expect and `code-mower
---version` should print `code-mower 1.5.1` before you point Code Mower at a
-repository. If you do not have pipx, install it from the
-[official pipx installation guide](https://pipx.pypa.io/stable/installation/).
+1. [Install And Bootstrap](https://github.com/codemower-ai/code-mower/blob/main/docs/install.md) with the supported pipx, uv, or
+   contributor path.
+2. [Run the first repository setup](https://github.com/codemower-ai/code-mower/blob/main/docs/quickstart.md) and keep the initial
+   Claude + Codex reviewer gate manual.
+3. For an existing integration, follow the
+   [upgrade guide](https://github.com/codemower-ai/code-mower/blob/main/docs/upgrade-existing-repo.md) before copying generated files.
+4. Operate the local Board through the
+   [service lifecycle guide](https://github.com/codemower-ai/code-mower/blob/main/docs/board-service-lifecycle.md).
+5. Use [troubleshooting](https://github.com/codemower-ai/code-mower/blob/main/docs/troubleshooting.md) when a check or provider is
+   not ready.
 
-Hosted agents and CI machines can use `uv tool install` after installing uv
-from the [official uv installation guide](https://docs.astral.sh/uv/getting-started/installation/);
-contributors should use `scripts/dev-python` and an editable virtual
-environment. The [Install And Bootstrap](https://github.com/codemower-ai/code-mower/blob/main/docs/install.md) guide gives the exact
-cold-install, upgrade, optional Coworker, and contributor commands.
+The install guide owns exact package commands. The quickstart owns the first
+repository workflow. Supporting runbooks link to those contracts instead of
+copying version-sensitive setup blocks.
 
-From the repository you want to pilot:
-
-```bash
-code-mower init --easy
-code-mower init --easy --apply --output-dir .code-mower.generated
-code-mower doctor --adoption --repo OWNER/REPO
-code-mower lanes status --repo OWNER/REPO
-```
-
-`init --easy` previews the Claude + Codex setup and changes nothing. `--apply`
-writes a reviewable generated tree; it does not copy those files into your
-repository, start a provider, enable auto-merge, or upload data. Review and
-edit the generated configuration before opening the setup PR.
-
-To inspect representative output first, use the
+To inspect representative output before installing, use the
 [synthetic calibration example](https://github.com/codemower-ai/code-mower/blob/main/examples/demo-calibration/README.md) and
 [Board demo](https://github.com/codemower-ai/code-mower/blob/main/examples/board-demo/README.md).
 
-Follow [Try Code Mower In 10 Minutes](https://github.com/codemower-ai/code-mower/blob/main/docs/try-in-10-minutes.md) to run Codex
-and Claude manually against that first PR. Automation tokens, recurring
-dispatch, branch-protection changes, and auto-merge are not prerequisites for
-the manual reviewer-gate pilot.
-
-After the first peer-review loop works, follow
-[Build Loop In 30 Minutes](https://github.com/codemower-ai/code-mower/blob/main/docs/build-loop-in-30-minutes.md) to add automated
-builder dispatch and the stricter promoted-pilot repository settings.
-
 ## Participants And Sessions
 
 Choose participants interactively or explicitly:
@@ -130,7 +102,8 @@ ID with `session lease renew --session-id SESSION_ID` or `session lease release
 --dry-run` or `--no-lease` for read-only work.
 
 Codex, Claude Code, and Cursor are qualified for the shared session, telemetry,
-lease, and Jira-authority contract in v1.5.0. Devin, Grok Bot, Antigravity,
+lease, and Jira-authority contract in the current v1.5.2 release. Devin, Grok
+Bot, Antigravity,
 Muse, and custom hosts are recognized for briefs and provenance, while their
 execution remains an explicit handoff or provider-specific transport. See
 [Participants And Sessions](https://github.com/codemower-ai/code-mower/blob/main/docs/sessions.md) and the
@@ -257,8 +230,9 @@ and the [Cloud Data Contract](https://github.com/codemower-ai/code-mower/blob/ma
 
 ## Optional Hosted Slack
 
-v1.5.0 adds a basic Slack control surface for one private workspace and one
-authorized private, unshared channel. A Code Mower team administrator opens
+v1.5.2 retains the basic Slack control surface introduced in v1.5.0 for one
+private workspace and one authorized private, unshared channel. A Code Mower
+team administrator opens
 **Setup → Manage Slack integration** in the hosted dashboard and completes OAuth
 as a Slack workspace administrator. Ordinary hosted setup does not require a
 local manifest, Slack app creation, or Slack credentials on the user's machine.
@@ -285,7 +259,7 @@ for both workflows, supported behavior, and the trust boundary.
 
 ## Current Capabilities And Limits
 
-| Area | v1.5.1 posture |
+| Area | v1.5.2 posture |
 | --- | --- |
 | Default builders and reviewers | Claude Code + Codex |
 | Session hosts | Codex, Claude Code, and Cursor qualified; other identities recognized but require explicit handoff/provider transport |
@@ -299,7 +273,7 @@ for both workflows, supported behavior, and the trust boundary.
 
 GitLab, Bitbucket, broad unattended rollout, uncalibrated merge gates, Devin
 peer-orchestrator/reviewer parity, a hosted work-order CLI, a required Graphify
-dependency, Slack telemetry/Board links, and rich Slack UX are outside v1.5.1. The current priorities
+dependency, Slack telemetry/Board links, and rich Slack UX are outside v1.5.2. The current priorities
 and boundaries are recorded in
 [Current State And Roadmap](https://github.com/codemower-ai/code-mower/blob/main/docs/current-state-and-roadmap.md).
 
@@ -307,7 +281,7 @@ and boundaries are recorded in
 
 Graphify's optional bounded provider foundation landed in v1.4.0; its complete
 qualified integration, scorecard and query behavior shipped in v1.4.1 and
-remain available in v1.5.0. It is separately installed into an operator-owned
+remain available in v1.5.2. It is separately installed into an operator-owned
 environment, explicitly activated, and outside the base dependency set: a
 default Claude + Codex install adds no Graphify dependency, no indexer, no
 background service, and no watcher.
@@ -326,9 +300,9 @@ for what a build is allowed to see and where its state lives, and
 [Bounded Queries And Context Packets](https://github.com/codemower-ai/code-mower/blob/main/docs/context-graph-queries.md) for the
 four questions and the packet contract.
 
-v1.5.0 includes #1007's bounded 16 MiB provider-manifest reader, `doc_ref`
-non-code exclusions, JavaScript/TypeScript related-test conventions and import
-relationships, plus parser/runtime/single-worker guidance. #1031 makes search
+The v1.5.x line includes #1007's bounded 16 MiB provider-manifest reader,
+`doc_ref` non-code exclusions, JavaScript/TypeScript related-test conventions
+and import relationships, plus parser/runtime/single-worker guidance. #1031 makes search
 readiness agree with the installed query reader and preserves usable bounded
 partial answers. The accepted `graphifyy==0.9.58` pin is unchanged. Upgrade does
 not repair existing graphs: explicitly refresh affected/partial generations,
@@ -339,77 +313,17 @@ does not need rebuilding. See
 
 ## Documentation
 
-### Install And First Use
-
-- [Install And Bootstrap](https://github.com/codemower-ai/code-mower/blob/main/docs/install.md)
-- [Try Code Mower In 10 Minutes](https://github.com/codemower-ai/code-mower/blob/main/docs/try-in-10-minutes.md)
-- [Upgrade An Existing Repository](https://github.com/codemower-ai/code-mower/blob/main/docs/upgrade-existing-repo.md)
-- [Quickstart Reference](https://github.com/codemower-ai/code-mower/blob/main/docs/quickstart.md)
-- [Troubleshooting](https://github.com/codemower-ai/code-mower/blob/main/docs/troubleshooting.md)
-- [First Run Transcript](https://github.com/codemower-ai/code-mower/blob/main/docs/first-run-transcript.md) (v1.4.0 illustrative shape, not the v1.5.0 source pin)
-
-### Local Board And Repository Context
-
-- [Board Data Contract](https://github.com/codemower-ai/code-mower/blob/main/docs/board-data-contract.md)
-- [Board Service Lifecycle](https://github.com/codemower-ai/code-mower/blob/main/docs/board-service-lifecycle.md)
-- [Board Demo Rehearsal](https://github.com/codemower-ai/code-mower/blob/main/examples/board-demo/README.md)
-- [Optional Graphify Setup](https://github.com/codemower-ai/code-mower/blob/main/docs/graphify-setup.md)
-- [Local Repository Graph Lifecycle](https://github.com/codemower-ai/code-mower/blob/main/docs/context-graph-lifecycle.md)
-- [Bounded Queries And Context Packets](https://github.com/codemower-ai/code-mower/blob/main/docs/context-graph-queries.md)
-- [Graphify Evaluation Record](https://github.com/codemower-ai/code-mower/blob/main/docs/graphify-evaluation.md) (historical decision, 2026-09-12)
-
-### Sessions, Builders, And Reviewers
-
-- [Participants And Sessions](https://github.com/codemower-ai/code-mower/blob/main/docs/sessions.md)
-- [Build Loop In 30 Minutes](https://github.com/codemower-ai/code-mower/blob/main/docs/build-loop-in-30-minutes.md)
-- [Build Loop Operations](https://github.com/codemower-ai/code-mower/blob/main/docs/build-loop.md)
-- [Planning And Work Orders](https://github.com/codemower-ai/code-mower/blob/main/docs/planning-work-orders.md)
-- [Builder Experiments](https://github.com/codemower-ai/code-mower/blob/main/docs/builder-experiments.md)
-- [Orchestrator Prompt Pack](https://github.com/codemower-ai/code-mower/blob/main/docs/orchestrator-prompt-pack.md)
-- [Optional Devin Setup Prompt](https://github.com/codemower-ai/code-mower/blob/main/docs/devin-setup-prompt.md)
-- [Optional Slack Setup](https://github.com/codemower-ai/code-mower/blob/main/docs/slack-setup.md) (hosted dashboard OAuth for workspace administrators; separate manifest/readiness path for operators)
-- [Slack Authenticated Ingress Contract](https://github.com/codemower-ai/code-mower/blob/main/docs/slack-ingress.md) (standalone OSS adapter seam)
-- [Provider Matrix](https://github.com/codemower-ai/code-mower/blob/main/docs/provider-matrix.md)
-- [Provider Calibration Scorecard](https://github.com/codemower-ai/code-mower/blob/main/docs/provider-calibration-scorecard.md)
-- [Devin Peer-Support Qualification](https://github.com/codemower-ai/code-mower/blob/main/docs/devin-peer-support-qualification.md)
-- [Lane Standing Instructions](https://github.com/codemower-ai/code-mower/blob/main/docs/lanes/README.md)
-- [Codex Lane](https://github.com/codemower-ai/code-mower/blob/main/docs/lanes/codex.md)
-- [Claude Lane](https://github.com/codemower-ai/code-mower/blob/main/docs/lanes/claude.md)
-- [Cursor Lane](https://github.com/codemower-ai/code-mower/blob/main/docs/lanes/cursor.md)
-- [Devin Lane](https://github.com/codemower-ai/code-mower/blob/main/docs/lanes/devin.md)
-- [Self-Hosted Mac Runner](https://github.com/codemower-ai/code-mower/blob/main/docs/self-hosted-mac-runner.md)
-- [Local Audit Runner](https://github.com/codemower-ai/code-mower/blob/main/docs/local-audit-runner.md)
-
-### Context And Trackers
-
-- [Optional Organizational Context Setup](https://github.com/codemower-ai/code-mower/blob/main/docs/context-setup.md)
-- [Coworker Connections](https://github.com/codemower-ai/code-mower/blob/main/docs/context-connections.md)
-- [Context Delivery And Private Review](https://github.com/codemower-ai/code-mower/blob/main/docs/context-delivery.md)
-- [Context Provider Contract](https://github.com/codemower-ai/code-mower/blob/main/docs/context-provider-contract.md)
-- [Context Packet Schema](https://github.com/codemower-ai/code-mower/blob/main/docs/context-packet-schema.md)
-- [Jira Cloud Setup](https://github.com/codemower-ai/code-mower/blob/main/docs/jira-cloud-setup.md)
-- [Jira Adoption Rehearsal](https://github.com/codemower-ai/code-mower/blob/main/docs/jira-adoption-rehearsal.md)
-- [Work Tracker Data Contract](https://github.com/codemower-ai/code-mower/blob/main/docs/tracker-data-contract.md)
-
-### Trust, Operations, And Project Records
-
-- [Architecture](https://github.com/codemower-ai/code-mower/blob/main/docs/architecture.md)
-- [Current State And Roadmap](https://github.com/codemower-ai/code-mower/blob/main/docs/current-state-and-roadmap.md)
-- [Lane Promotion Policy](https://github.com/codemower-ai/code-mower/blob/main/docs/lane-promotion-policy.md)
-- [Privacy And Threat Model](https://github.com/codemower-ai/code-mower/blob/main/docs/privacy-threat-model.md)
-- [Cloud Data Contract](https://github.com/codemower-ai/code-mower/blob/main/docs/cloud-data-contract.md)
-- [Release Qualification](https://github.com/codemower-ai/code-mower/blob/main/docs/release-qualification.md)
-- [Public Release Checklist](https://github.com/codemower-ai/code-mower/blob/main/docs/public-release-checklist.md)
-- [v1.5.1 Release Notes](https://github.com/codemower-ai/code-mower/blob/main/docs/v151-release-notes.md)
-- [v1.4.2 Release Notes](https://github.com/codemower-ai/code-mower/blob/main/docs/v142-release-notes.md)
-- [v1.5.1 Qualification Contract](https://github.com/codemower-ai/code-mower/blob/main/docs/v151-qualification.md)
-- [v1.4.2 Qualification Record](https://github.com/codemower-ai/code-mower/blob/main/docs/v142-qualification.md)
-- [Release History And Archived Plans](https://github.com/codemower-ai/code-mower/blob/main/docs/release-history.md)
-- [Changelog](https://github.com/codemower-ai/code-mower/blob/main/CHANGELOG.md)
-- [Contributing](https://github.com/codemower-ai/code-mower/blob/main/CONTRIBUTING.md)
-- [Support](https://github.com/codemower-ai/code-mower/blob/main/SUPPORT.md)
-- [Security Policy](https://github.com/codemower-ai/code-mower/blob/main/SECURITY.md)
-- [Code of Conduct](https://github.com/codemower-ai/code-mower/blob/main/CODE_OF_CONDUCT.md)
+The generated [documentation index](https://github.com/codemower-ai/code-mower/blob/main/docs/README.md) lists every canonical guide
+and identifies supporting and historical material. The maintained user journey
+is [install](https://github.com/codemower-ai/code-mower/blob/main/docs/install.md), [first repository setup](https://github.com/codemower-ai/code-mower/blob/main/docs/quickstart.md),
+[upgrade](https://github.com/codemower-ai/code-mower/blob/main/docs/upgrade-existing-repo.md), [Board operation](https://github.com/codemower-ai/code-mower/blob/main/docs/board-service-lifecycle.md),
+and [troubleshooting](https://github.com/codemower-ai/code-mower/blob/main/docs/troubleshooting.md).
+
+For architecture, sessions, Graphify, Slack, Jira, provider selection, release
+operations, and the roadmap, use that index rather than a second hand-maintained
+link catalog here. See [Contributing](https://github.com/codemower-ai/code-mower/blob/main/CONTRIBUTING.md), [Support](https://github.com/codemower-ai/code-mower/blob/main/SUPPORT.md),
+[Security Policy](https://github.com/codemower-ai/code-mower/blob/main/SECURITY.md), and the [Code of Conduct](https://github.com/codemower-ai/code-mower/blob/main/CODE_OF_CONDUCT.md)
+for repository participation and support boundaries.
 
 ## License
 

code_mower-1.5.2/docs/README.md

@@ -0,0 +1,45 @@
+# Code Mower documentation
+
+<!-- Generated from docs/docs-manifest.yml. Run `python -m code_mower.docs_lifecycle --write-index` after changing canonical ownership. -->
+
+Start with the canonical guide for the task at hand. Supporting documents add
+detail without redefining these contracts. Frozen and archived documents preserve
+historical release evidence and are not current operating guidance.
+
+## Maintained user journey
+
+1. [Install And Bootstrap](install.md)
+2. [Code Mower Quickstart](quickstart.md)
+3. [Upgrade An Existing Repository](upgrade-existing-repo.md)
+4. [Board Service Lifecycle](board-service-lifecycle.md)
+5. [Troubleshooting](troubleshooting.md)
+
+## Canonical guides
+
+| Subject | Guide |
+| --- | --- |
+| Architecture | [Architecture](architecture.md) |
+| Board Operations | [Board Service Lifecycle](board-service-lifecycle.md) |
+| Cloud Sharing | [Code Mower Cloud Sharing](cloud-sharing.md) |
+| Context Providers | [Context provider contract for v1.3](context-provider-contract.md) |
+| Documentation Lifecycle | [Documentation lifecycle](documentation-lifecycle.md) |
+| Graphify | [Optional Graphify setup](graphify-setup.md) |
+| Install Rehearsal | [First-User Install Rehearsal](first-user-install-rehearsal.md) |
+| Installation | [Install And Bootstrap](install.md) |
+| Jira | [Jira Cloud Setup](jira-cloud-setup.md) |
+| Package Publication | [PyPI Release Runbook](pypi-release.md) |
+| Provider Selection | [Code Mower Provider Matrix](provider-matrix.md) |
+| Quickstart | [Code Mower Quickstart](quickstart.md) |
+| Release History | [Release History And Archived Plans](release-history.md) |
+| Release Process | [Code Mower Public Release Checklist](public-release-checklist.md) |
+| Roadmap | [Code Mower Current State And Roadmap](current-state-and-roadmap.md) |
+| Sessions | [Participants And Sessions](sessions.md) |
+| Slack | [Optional Slack setup](slack-setup.md) |
+| Troubleshooting | [Troubleshooting](troubleshooting.md) |
+| Upgrade | [Upgrade An Existing Repository](upgrade-existing-repo.md) |
+
+## Lifecycle
+
+The manifest currently classifies 62 supporting, 53 frozen, and 5 archived document(s).
+See [Documentation lifecycle](documentation-lifecycle.md) before adding, moving,
+or changing release-sensitive documentation.

{code_mower-1.5.1 → code_mower-1.5.2}/docs/architecture.md

@@ -89,7 +89,7 @@ src/code_mower/
   tracker_*.py, jira_*.py        work-item contracts and guarded Jira operations
   cloud.py, cloud_client/        export, upload, setup, and metadata operations
   package_*.py, migration_*.py   generated package and rehearsal support
-  templates/                     generated config, workflows, prompts, wrappers
+  templates/                     authored config, workflows, prompts, wrappers
 tests/                           behavior, privacy, and release-hygiene tests
 scripts/                         smoke, privacy, fresh-clone, and Python helpers
 docs/                            current guides and historical release records