Skip to content

docs: B0 tranche — OVH-02/26/03/04 (ledger, receipt gate, truth-pass) - #28

Draft
aliasfoxkde wants to merge 5 commits into
mainfrom
agent/py7zip-overhaul-20261019
Draft

aliasfoxkde wants to merge 5 commits into
mainfrom
agent/py7zip-overhaul-20261019

Conversation

@aliasfoxkde

Copy link
Copy Markdown
Owner

Execution tranche of docs/handoffs/2026-10-11-py7zip-overhaul.md (rev 4), based on origin/main a06615f. Draft: opens CI on the branch; merge order follows the task ledger.

  • OVH-02 — bin/PROVENANCE.md ledger: one row per non-empty binary (size, sha256, static format/banner, version, provenance state; linux x64 Anchored, six UNPROVEN), six placeholders marked empty/not distributed; bin/INFO.md reconciled to the on-disk inventory.
  • OVH-26 (gate, audit D4) — docs/planning/DECISION_WINDOWS_RECEIPTS_2026-10-20.md: no Windows x64/WSL receipt found in repo or issue history → mandated outcome "uncheck claims". D-OVH-2 stays open. Recorded by the implementation agent applying the gate's pre-stated outcome rule; maintainer may revise.
  • OVH-03 — docs truth-pass: USAGE.md import line + safe-runtime sequence; FEATURES.md family stubs labeled no-op per the snapshot-family handoff Phase A rule; SETUP.md publish flow rewritten to the actual publish.yml (trusted publishing). New tests/test_docs_truthfulness.py (4 offline guards).
  • OVH-04 — README: [x] Windows x64 unchecked per OVH-26; install note corrected to actual wheel behavior (F13); grep -n "\[x\]" README.md now returns nothing.
  • Dated receipt: docs/planning/PROGRESS_RECEIPT_2026-10-20.md.

Validation: offline suite 133 passed (129 baseline + 4 new; CPython 3.14.8, network namespace); clean wheel build py7zip-0.7.3-py3-none-any.whl sha256 0b9b5b9a…99ff, 11 entries, no bin/; Phase A guard zero findings. No runtime code changed; no tags/releases touched; all decision gates (D3 publication, OVH-29, OVH-06/07/08) remain recorded-not-bypassed.

🤖 Generated with Claude Code

aliasfoxkde and others added 5 commits October 20, 2026 00:10
Add bin/PROVENANCE.md with one row per non-empty binary: size, sha256,
static format, static banner, upstream version, provenance state, and
the introducing commit (1fabd26, 2024-02-24). linux x64 is Anchored
(byte-identical to official 24.00 7zz per V19, digest re-verified
2026-10-20); the other six rows are UNPROVEN, with the darwin row
bound to gate OVH-29 and the win rows to gate OVH-07 (D-OVH-2).
Placeholder slots are listed as empty and not distributed.

Reconcile bin/INFO.md to the on-disk inventory: add the architecture
level and .exe-or-empty extension to the layout pattern, fix the Linux
example (lin/arm/x32), drop nonexistent win/arm *.exe and
mac/arm/x32 paths, add the unlisted mac/pc placeholders, and name
PROVENANCE.md the inventory of record.

New static banner evidence (no binary executed): lin/pc/x86 24.00
(x86), lin/arm/x64 24.00 (arm64), lin/arm/x32 24.00 (armt), win/pc
7-Zip (a) 24.01 x64/x86. A Wayback availability re-check for the
remaining 24.00 assets returned HTTP 429 and is recorded as such.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Record audit decision D4 as a gate decision in docs/planning/:
searches of the repo, git history, and GitHub issue/PR tracking found
no Windows x64 or WSL qualification receipt (AGENTS.md promotion-rule
format), so the plan's mandated outcome applies — uncheck claims.

The README [x] Windows x64 row is marked to-uncheck (executed by
OVH-04); the 0.7.3 WSL and 0.6.2 Windows-x64 changelog sentences are
dispositioned as unreceipted historical claims, left unrewritten and
barred from future release notes. D-OVH-2 (Windows acquisition
source) explicitly remains open; the governed fallback continues.

Recorded by the implementation agent under the 2026-10-20 execution
directive, applying the gate's pre-stated outcome rule; the
maintainer may revise or supersede it.

Co-Authored-By: Claude Code <noreply@anthropic.com>
USAGE.md: import line corrected to from py7zip.py7zip import Py7zip
(the root package exports nothing, pinned by test_import_hygiene);
example now shows the safe-runtime sequence — construct, explicit
optional download_binary(), compress/decompress returning
ArchiveResult — with individual-argument options (string options
raise TypeError on the default runtime).

FEATURES.md: the two false backup-family claims removed; full,
incremental, differential, and snapshot each labeled no-op per the
snapshot-family handoff Phase A per-occurrence rule (no removal
version claimed, v0.8.0/v0.9.0 artifacts not described); cross-
platform and "no CLI executing" claims replaced with the catalog /
typed-refusal / receipts-required statement.

SETUP.md: push.bat / setup.py / PYPI_API_KEY flow replaced with the
actual publish.yml flow (release-triggered, tag/version gate,
trusted publishing; workflow_dispatch is rehearsal only) plus locally
executable test/build commands.

Add tests/test_docs_truthfulness.py (4 offline tests): the Phase A
per-occurrence qualifier guard, the USAGE import + construction run
in a clean socket-denied interpreter, the submodule import pin, and a
bar on setup.py/push.bat/PYPI_API_KEY in user-facing docs.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Per the OVH-26 gate record (no Windows x64 / WSL qualification
receipt found), uncheck the README's [x] Windows x64 row and note
that rows may be checked only with an AGENTS.md promotion-rule
receipt. Correct the install note to actual wheel behavior: the
wheel ships no binaries; the default runtime acquires the artifact
into ~/.cache/py7zip with sha256 verification, explicitly.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Dated receipt for this tranche (OVH-02, OVH-26, OVH-03, OVH-04):
environment and device confirmation, baseline origin/main CI status,
GitForge absence evidence, per-task acceptance commands and results,
133-test offline suite, clean wheel build with digest, open decision
gates, and the exact next step (publication decision D3 inside
OVH-21, owner-blocked; OVH-24 next unblocked implementation task).

Co-Authored-By: Claude Code <noreply@anthropic.com>
@bolt-new-by-stackblitz

Copy link
Copy Markdown

Review PR in StackBlitz Codeflow Run & review this pull request in StackBlitz Codeflow.

@coderabbitai

coderabbitai Bot commented Oct 20, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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

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

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant