Add fidelity-honesty analysis tool (owner-run)

[ptr727]

A read-only fleet analysis that checks the manifest's declared fidelities against reality — the declared→verified leap one level up from the verbatim engine (which verifies content). Reuses spec/audit.py's machinery. Owner-run, not wired into CI.

What it reports

• intent units byte-uniform fleet-wide → candidates to promote to verbatim (gaining free drift-detection).
• verbatim units with non-stale downstream divergence → mis-label or real drift.
• Manifest gaps — files carried by a reference adopter but absent from the manifest (the configure.sh bug class).

First-run value (findings, not fixed here)

• 3 ruleset payloads (repo-config/{develop,operational/develop,main}.json) are uniform → verbatim candidates.
• .markdownlint-cli2.jsonc and configure.sh carry real downstream drift (a re-vendor worklist).
• .editorconfig-checker.json is carried but untracked — a new manifest gap.

Follow-ups (each its own decision) are tracked separately. This PR just lands the tool.

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Adds an owner-run, read-only fleet analysis script that reuses spec/audit.py helpers to compare spec/files.json declared fidelities (intent/verbatim) against observed downstream content hashes, and to detect manifest gaps via a reference adopter.

Changes:

• Add spec/fidelity_honesty.py to compute per-unit fleet spread, promotion candidates, and potential mislabels.
• Add a manifest-gap pass that compares hub files against a reference adopter's repo tree.
• Print a human-readable report summarizing the findings.

[Copilot]

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

Comments suppressed due to low confidence (1)

spec/fidelity_honesty.py:55

• The inline comment for promote still says these intent units are "uniform fleet-wide", but the actual criteria only requires >=1 confirmed match with the current canonical and 0 "differs" (stale/unavailable are allowed). This makes the comment misleading for future readers.

    spreads = []          # (entry, spread dict) for the full table
    promote = []          # intent units that are uniform fleet-wide
    mislabel = []         # verbatim units that diverge non-stale

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (2)

spec/fidelity_honesty.py:106

• manifest_gap_pass() returns an empty gaps list when the branch/tree lookup fails (404 / missing fields). main() then prints "none - the manifest covers...", which is a false negative because the check did not actually run. Also, the git/trees API can return {"truncated": true}; in that case the gap set would be incomplete and should fail loud rather than reporting "none".

    br = audit.gh(f"repos/{slug}/branches/{ground}", ok404=True)
    if not br or "commit" not in br:
        return slug, []
    tree = audit.gh(f"repos/{slug}/git/trees/{br['commit']['commit']['tree']['sha']}?recursive=1", ok404=True)
    if not tree or "tree" not in tree:
        return slug, []

spec/fidelity_honesty.py:54

• The inline comment for promote says "uniform fleet-wide", but the logic intentionally allows stale/unavailable repos and only requires >=1 canonical match and 0 hand-modified copies. Updating the comment avoids misreading what promote represents.

    promote = []          # intent units that are uniform fleet-wide

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (1)

spec/fidelity_honesty.py:54

• The inline comment says intent units in promote are "uniform fleet-wide", but the promote condition allows stale/unavailable copies (it only requires >=1 match and 0 confirmed divergent copies). This comment is misleading and contradicts the logic below.

    promote = []          # intent units that are uniform fleet-wide

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

Comments suppressed due to low confidence (1)

spec/fidelity_honesty.py:55

• The promote list no longer implies fleet-wide uniformity (units can be unavailable in some repos), but the comment still says "uniform fleet-wide", which is misleading.

    promote = []          # intent units that are uniform fleet-wide
    mislabel = []         # verbatim units that diverge non-stale

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.