State the Install-Tools JSON Report in the Host Contract

[ptr727]

Summary

Copilot's review of promotion PR #2254 raised a "previously missed" finding against #2259's install-tools JSON report. add-host-tool's procedure says a change to report behavior must update docs/host-setup.md as well as the platform READMEs, and #2259 updated only the READMEs.

docs/host-setup.md now has one paragraph saying:

• the flags are --report --json on Linux and -Report -Json on Windows, and the JSON flag applies to no other action;
• the output is one object with a schema number, the platform, a tools list, and a top-level notes list;
• a change to what a field means raises schema.

For the shared fields it links to the Linux README, and for its one added field and the values that differ it links to the Windows README. It doesn't restate them, so a third copy of the field list can't drift.

Verification

• local-strict-review checked each claim against both installers and both READMEs and found nothing. Its receipt is recorded.
• prose_lint --diff origin/develop, docker_lint.py (markdownlint, cspell, editorconfig), and spec/validate.py are all clean. The full unittest discover run passes.

🤖 Generated with Claude Code

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Repository: ptr727/ProjectTemplate/.coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: 93b69851-4f8c-45e7-a78b-48f7e20fd088

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Autopilot is currently an internal CodeRabbit preview.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 57.31%. Comparing base (18be0e9) to head (9888e89).

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #2267   +/-   ##
========================================
  Coverage    57.31%   57.31%           
========================================
  Files           16       16           
  Lines         7611     7611           
========================================
  Hits          4362     4362           
  Misses        3249     3249           

Flag	Coverage Δ
python-3.13	57.31% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

Copilot review overview

🟡 Changes recommended

The Windows JSON output omits a documented report-level warning, and the new prose exceeds the sentence-length limit.

Review effort: Lite
Findings: 1

Open (1)

• Include report-level notes in Windows JSON output · New

What changed in this PR

Documents the install-tools JSON report contract in the central host setup guide.

Changes:

• Defines JSON flags, schema, report structure, and notes.
• Links shared and platform-specific field details.

File	Summary
docs/​host-setup.md	Documents the shared JSON report contract and platform references.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.