infra: isolate module evidence and generated compatibility summaries

[swear01]

Closes #77.

Summary

This removes the remaining shared compatibility-evidence merge points:

• each audited descriptor owns only its isolated module recipe-inventory digest;
• isolated fixture runs verify that descriptor digest;
• the compatibility matrix owns the actual combined coexistence and unclaimed inventories in build/reports/terminal-scale-<types>.json;
• build/reports/compatibility-modules.md is generated from descriptors and active module docs rather than maintained as a shared source file.

Outcome A: declarative evidence isolation implemented. No runtime recipe semantics changed.

Current base and head

• base: 9fc1aae99ed2b67a4ecd7c0fdbcbced858d5bada
• head: 5d7db18a70cd9eb556fa803e759a4d327af0b67a
• PR is ready for review (not draft)

The branch was rebased onto the Productive Metalworks merge. Its newly merged fixture now verifies its isolated descriptor evidence: 312 productivemetalworks:* recipes, SHA-256 a17a7208231825e5c0c9f0c801867dfbf09e0bbfbb228018562ae01460f1fee7.

TDD and review fixes

• RED then GREEN: every isolated audited fixture must call IsolatedRecipeInventoryEvidence.
• RED then GREEN: every Compat Kit manifest must retain exact keys including tool_version.
• RED then GREEN: both compatibility-summary Gradle tasks declare active docs/*-compatibility.md inputs.
• Explicit UTF-8 is retained for generated isolated-evidence JSON.

Verification

Gate	Result
PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover scripts	554/554 passed
./gradlew build	passed
./gradlew runCompatFixtureGameTestServers	passed
./gradlew runProductivemetalworksGameTestServer	8/8 passed
./gradlew runCompatibilityMatrixGameTestServer	3/3 passed, 14,990 recipes
Compat Kit Productive Metalworks bundled verification	12/12 checks, 5/5 commands passed
./gradlew checkCompatibilitySummary	passed
./gradlew runData	passed, zero files written
git diff --check	clean

Latest matrix report evidence:

• coexistence: 14,990 recipes, SHA-256 b340161edceb2857560c3229c4731b2241081643ee2f7c788622da531140a87f;
• unclaimed: 1,354 recipes, SHA-256 c5796e5c92a7ec1e51c9fe58397e8c0e1dc0743b7a587039631f231c294c1207;
• shared retained index: 5,015,272 bytes;
• per-menu retained heap: 114,626 bytes.

Documentation

Updated active plan, roadmap, and Productive Metalworks compatibility evidence. Generated report path: build/reports/compatibility-modules.md.

Remaining risk

Cross-mod-only recipe changes intentionally change the matrix report rather than a committed global expected digest. CI/release retain the report as evidence; reintroducing a committed global digest would recreate the shared-file conflict this issue removes.

[gemini-code-assist]

Code Review

This pull request implements true module evidence isolation (GitHub #77) by verifying isolated descriptor digests via isolated fixtures and recording actual coexistence and unclaimed recipe inventories in a matrix report rather than committing global digests. It also introduces a generated compatibility summary report (compatibility-modules.md) for CI/release. Feedback on these changes includes addressing platform-default encoding issues when reading and writing isolated recipe inventories in build.gradle, and fixing a test bug in test_compatibility_matrix_manifest.py where subprocess.run is called with check=True on a conflicting git merge-tree command, which would cause the test to crash.

[swear01]

Follow-up evidence (42e029990e4adaedc7e30ce8e3301bb2e2db72b3)

Initial --continue RED sweep

./gradlew runCompatFixtureGameTestServers --continue → BUILD FAILED in 9m 24s after collecting isolated digests:

• Passed: Advanced AE 8, Ars Nouveau 11, Botania 14, CAA 4, Draconic 6, Extended Crafting 4, IF 9, MI 7
• Drift RED (expected→got): AE2, Create, EvilCraft, Farmers Delight, Iron Furnaces, Mekanism, Powah, Productive Bees, Theurgy

Final 17-fixture aggregate GREEN

./gradlew runCompatFixtureGameTestServers → all 17 fixtures passed, BUILD SUCCESSFUL in 8m 31s:
8 / 8 / 11 / 14 / 13 / 4 / 6 / 10 / 4 / 7 / 9 / 3 / 47 / 7 / 11 / 8 / 9

Coordinator correction verification

• Focused Python 29 OK; full Python 548 OK
• stageAe2CompatAuditAncestry + build SUCCESS
• git diff --check clean
• Contracts advanced_ae / ae2 / productivebees / theurgy each changed only matrix.recipeInventory.sha256 (1-line diffs)
• Shared tests no longer pin Productive Bees/Create digests or peer MI/Create descriptors

Draft remains draft; no review bot triggered.

[swear01]

Rebase evidence

• New head: e59e778e5df5c28f3f91799c273203dcad791885
• Exact base: 61aaf32f4faa263d8c3c6c6281f5ad81adc2e8b7 (Railcraft compat: add Railcraft Reborn fail-closed integration #58 on main)
• Commits: 38ecbcc isolation · ca362a0 digest follow-up · e59e778 Railcraft isolated digest after rebase

Gates

• Focused Python 31 OK; full Python 548 OK; railcraft metadata OK after digest fix
• stageAe2CompatAuditAncestry + build SUCCESS
• Aggregate runCompatFixtureGameTestServers: 18 fixtures green (incl. Railcraft 8 / Theurgy 9)
• Matrix 3/3 SUCCESS; report coexistence 0635a176… / unclaimed c5796e5c…
• runData SUCCESS, written 0; git diff --check clean

Isolation notes

• Companions remain without coexistence/unclaimed expected SHA
• Railcraft fixture asserts IsolatedRecipeInventoryEvidence; isolated digest 5fa9e922337c24f2a2d4d86da0d68ebe8205a89dcd70ece1e952f75707107060
• CAA/Railcraft docs do not pin peer Create descriptor SHA

Draft remains draft; no review bot triggered.

[swear01]

Manifest integrity follow-up

• New head: 330c22f105643884adb0f3753953427db8601905
• Base: 61aaf32f4faa263d8c3c6c6281f5ad81adc2e8b7 (unchanged)

Correction

• RED→GREEN: added test_every_compat_kit_manifest_file_hash_matches_disk (files-only; all src/compat/*/.compat-kit-manifest.json).
• Refreshed AE2 listed file hashes for neoforge.mods.toml and Ae2Compat.java to match disk (no source-byte changes).
• Restored AE2 contract_sha256 and AE2 generation/compile-fixture source_contract_digest to Compat Kit canonical digest 846f86c211aec80ed9e740d5956a013173fa8b26785501cd027c6336e0db2aad (file-byte digest was inconsistent with _contract_sha256).

Verification

• Focused modular/manifest Python: 32 OK
• Full Python (JDK 21): 551 OK
• git diff --check clean
• No GameTest / runData rerun: metadata-only; prior aggregate/matrix/runData on e59e778 remain valid for runtime bytes

Draft remains draft; no review bot triggered.

[swear01]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 700c7a5fd4

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[swear01]

@codex review

[chatgpt-codex-connector]

Codex Review: Didn't find any major issues. Keep them coming!

Reviewed commit: 5d7db18a70

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[swear01]

Final gate evidence

• head: 5d7db18a70cd9eb556fa803e759a4d327af0b67a
• base: 9fc1aae99ed2b67a4ecd7c0fdbcbced858d5bada
• GitHub CI: build-and-test success, run 30748526305
• manual GitHub bot review: Codex reviewed 5d7db18a70 and reported no major issues: infra: isolate module evidence and generated compatibility summaries #78 (comment)
• unresolved review threads: 0
• mergeability: CLEAN
• worktree: clean