debug: add diff output to contract artifact check

Author: senseibelbi

docs/architecture/contract_manifest.json

@@ -173,7 +173,7 @@
       "classification": "supporting",
       "relativePath": "docs/architecture/release_bundle_manifest.json",
       "role": "whole release bundle hash inventory",
-      "sha256": "6cccab8d4842f984b1672af653944df7e3eff2be4ce025817cffa334d2589c54"
+      "sha256": "e6e4094692e270173cb2392cc876050e1c2c4c9d29672119223c75da1252c51a"
     },
     {
       "classification": "supporting",
@@ -257,7 +257,7 @@
       "classification": "supporting",
       "relativePath": "scripts/generate_contract_artifacts.py",
       "role": "contract artifact generator",
-      "sha256": "c5e16e58a9c65b8e3fdb0c064dc39467f5578ca848962a998128ae65c5f2c506"
+      "sha256": "6d572e5bd4702d74513ff8017e42b1600caa2f1c9717397126cf5b3cf053d322"
     },
     {
       "classification": "supporting",

docs/architecture/release_bundle_manifest.json

@@ -1,5 +1,5 @@
 {
-  "bundleSha256": "4049a0b990999deb17edc28e64ccff0a846afa9fcabe3c1b1f98f3c3e0f0e1ed",
+  "bundleSha256": "c7ed98f8479f43e4db1bc88deeb1deab9c60ffeda7dc73ad6e356e19e9c70623",
   "contractVersion": "pbpk-mcp.v1",
   "fileCount": 612,
   "files": [
@@ -2202,8 +2202,8 @@
     {
       "group": "operations",
       "relativePath": "scripts/generate_contract_artifacts.py",
-      "sha256": "c5e16e58a9c65b8e3fdb0c064dc39467f5578ca848962a998128ae65c5f2c506",
-      "sizeBytes": 16310
+      "sha256": "6d572e5bd4702d74513ff8017e42b1600caa2f1c9717397126cf5b3cf053d322",
+      "sizeBytes": 16955
     },
     {
       "group": "operations",
@@ -3721,5 +3721,5 @@
     ],
     "mode": "staged-source-tree-equivalent"
   },
-  "totalBytes": 12048815
+  "totalBytes": 12049460
 }

scripts/generate_contract_artifacts.py

@@ -434,6 +434,16 @@ def _check_file(path: Path, expected: str) -> bool:
     current = path.read_text(encoding="utf-8")
     if current != expected:
         print(f"Generated file is out of date: {path}", file=sys.stderr)
+        print(f"  Expected length: {len(expected)}, actual length: {len(current)}", file=sys.stderr)
+        for i, (e, a) in enumerate(zip(expected, current)):
+            if e != a:
+                print(f"  First diff at byte {i}: expected {e!r}, got {a!r}", file=sys.stderr)
+                print(f"  Expected context: {expected[max(0,i-20):i+20]!r}", file=sys.stderr)
+                print(f"  Actual context:   {current[max(0,i-20):i+20]!r}", file=sys.stderr)
+                break
+        else:
+            if len(expected) != len(current):
+                print(f"  One file is a prefix of the other (length mismatch)", file=sys.stderr)
         return False
     return True
 

src/mcp_bridge/contract/artifacts.py

@@ -296,7 +296,7 @@
       "classification": "supporting",
       "relativePath": "docs/architecture/release_bundle_manifest.json",
       "role": "whole release bundle hash inventory",
-      "sha256": "6cccab8d4842f984b1672af653944df7e3eff2be4ce025817cffa334d2589c54"
+      "sha256": "e6e4094692e270173cb2392cc876050e1c2c4c9d29672119223c75da1252c51a"
     },
     {
       "classification": "supporting",
@@ -380,7 +380,7 @@
       "classification": "supporting",
       "relativePath": "scripts/generate_contract_artifacts.py",
       "role": "contract artifact generator",
-      "sha256": "c5e16e58a9c65b8e3fdb0c064dc39467f5578ca848962a998128ae65c5f2c506"
+      "sha256": "6d572e5bd4702d74513ff8017e42b1600caa2f1c9717397126cf5b3cf053d322"
     },
     {
       "classification": "supporting",
@@ -442,7 +442,7 @@
 
 _RELEASE_BUNDLE_MANIFEST_JSON = r"""
 {
-  "bundleSha256": "4049a0b990999deb17edc28e64ccff0a846afa9fcabe3c1b1f98f3c3e0f0e1ed",
+  "bundleSha256": "c7ed98f8479f43e4db1bc88deeb1deab9c60ffeda7dc73ad6e356e19e9c70623",
   "contractVersion": "pbpk-mcp.v1",
   "fileCount": 612,
   "files": [
@@ -2645,8 +2645,8 @@
     {
       "group": "operations",
       "relativePath": "scripts/generate_contract_artifacts.py",
-      "sha256": "c5e16e58a9c65b8e3fdb0c064dc39467f5578ca848962a998128ae65c5f2c506",
-      "sizeBytes": 16310
+      "sha256": "6d572e5bd4702d74513ff8017e42b1600caa2f1c9717397126cf5b3cf053d322",
+      "sizeBytes": 16955
     },
     {
       "group": "operations",
@@ -4164,7 +4164,7 @@
     ],
     "mode": "staged-source-tree-equivalent"
   },
-  "totalBytes": 12048815
+  "totalBytes": 12049460
 }
 """