fix: support external paper workspace checks

Author: DeliciousBuding

scripts/README.md

@@ -14,6 +14,7 @@
 | --- | --- |
 | `DIFFAUDIT_WORKSPACE_ROOT` | 工作区根目录覆盖 |
 | `DIFFAUDIT_RESEARCH_PYTHON` | Python 解释器路径覆盖 |
+| `DIFFAUDIT_EVIDENCE_PAPER_DIR` | 私有 evidence paper 工作区路径覆盖，用于 paper/recode packet 脚本 |
 
 脚本默认从当前 `Research/scripts` 位置推导路径，可以通过环境变量覆盖。
 

scripts/e2/aggregate_false_promotion_external_review.py

@@ -11,14 +11,15 @@
 
 import argparse
 import csv
+import os
 import re
 from collections import Counter, defaultdict
 from itertools import combinations
 from pathlib import Path
 
 
 ROOT = Path(__file__).resolve().parents[2]
-PAPER = ROOT / "papers" / "diffaudit-evidence-paper"
+PAPER = Path(os.environ.get("DIFFAUDIT_EVIDENCE_PAPER_DIR", ROOT / "papers" / "diffaudit-evidence-paper")).resolve()
 DEFAULT_REVIEW_DIR = PAPER / "build" / "false_promotion_external_review_labels"
 DEFAULT_OUTPUT_DIR = PAPER / "build"
 

scripts/e2/build_claim_gate_recode_packet.py

@@ -11,11 +11,12 @@
 import csv
 import hashlib
 import io
+import os
 from pathlib import Path
 
 
 ROOT = Path(__file__).resolve().parents[2]
-PAPER = ROOT / "papers" / "diffaudit-evidence-paper"
+PAPER = Path(os.environ.get("DIFFAUDIT_EVIDENCE_PAPER_DIR", ROOT / "papers" / "diffaudit-evidence-paper")).resolve()
 CLAIM_TRACE = PAPER / "data" / "claim_trace.csv"
 OUT_TEMPLATE = PAPER / "data" / "claim_gate_recode_template.csv"
 OUT_MANIFEST = PAPER / "data" / "claim_gate_recode_packet_manifest.csv"
@@ -176,9 +177,9 @@ def write_outputs() -> None:
 def check_outputs() -> None:
     expected_template, expected_manifest = render_outputs()
     if not OUT_TEMPLATE.exists() or OUT_TEMPLATE.read_text(encoding="utf-8") != expected_template:
-        raise SystemExit(f"{OUT_TEMPLATE} is stale; run scripts/build_claim_gate_recode_packet.py")
+        raise SystemExit(f"{OUT_TEMPLATE} is stale; run scripts/e2/build_claim_gate_recode_packet.py")
     if not OUT_MANIFEST.exists() or OUT_MANIFEST.read_text(encoding="utf-8") != expected_manifest:
-        raise SystemExit(f"{OUT_MANIFEST} is stale; run scripts/build_claim_gate_recode_packet.py")
+        raise SystemExit(f"{OUT_MANIFEST} is stale; run scripts/e2/build_claim_gate_recode_packet.py")
     print("Claim-gate recode packet check passed (prepared template only; no labels).")
 
 

scripts/e2/build_e2_public_freeze_ledger.py

@@ -10,12 +10,13 @@
 
 import argparse
 import csv
+import os
 from pathlib import Path
 
 
 ROOT = Path(__file__).resolve().parents[2]
 PREFLIGHT = ROOT / "docs" / "internal" / "e2-n50-freeze-preflight-2026-06-06"
-PAPER = ROOT / "papers" / "diffaudit-evidence-paper"
+PAPER = Path(os.environ.get("DIFFAUDIT_EVIDENCE_PAPER_DIR", ROOT / "papers" / "diffaudit-evidence-paper")).resolve()
 
 REFRESH_CSV = PREFLIGHT / "e2_high_value_public_asset_delta_refresh_late_2026_06_09.csv"
 E2Q005_AGG_CSV = PREFLIGHT / "e2q005_external_style_review_aggregation_2026_06_06.csv"

scripts/e2/check_e2_freeze_preflight.py

@@ -7,12 +7,13 @@
 from __future__ import annotations
 
 import csv
+import os
 from pathlib import Path
 
 
 ROOT = Path(__file__).resolve().parents[2]
 PREFLIGHT = ROOT / "docs" / "internal" / "e2-n50-freeze-preflight-2026-06-06"
-PAPER = ROOT / "papers" / "diffaudit-evidence-paper"
+PAPER = Path(os.environ.get("DIFFAUDIT_EVIDENCE_PAPER_DIR", ROOT / "papers" / "diffaudit-evidence-paper")).resolve()
 
 REVIEW_DECISION_FIELDS = {
     "review_id",

scripts/e2/export_false_promotion_review_bundle.py

@@ -12,6 +12,7 @@
 import csv
 import hashlib
 import io
+import os
 import re
 import zipfile
 from dataclasses import dataclass
@@ -877,7 +878,7 @@ def parse_args() -> argparse.Namespace:
 def main() -> None:
     args = parse_args()
     repo_root = Path(__file__).resolve().parents[2]
-    paper = repo_root / "papers" / "diffaudit-evidence-paper"
+    paper = Path(os.environ.get("DIFFAUDIT_EVIDENCE_PAPER_DIR", repo_root / "papers" / "diffaudit-evidence-paper")).resolve()
     errors: list[str] = []
     items = validate_inputs(paper, errors)
     reviewer_items = [item for item in items if not is_post_label_item(item)]

scripts/paper/evaluate_report_correctness_faults.py

@@ -12,6 +12,7 @@
 import copy
 import csv
 import json
+import os
 import sys
 from dataclasses import dataclass
 from pathlib import Path
@@ -25,8 +26,9 @@
 
 
 DEFAULT_BUNDLE = REPO_ROOT / "workspaces/implementation/artifacts/admitted-evidence-bundle.json"
-DEFAULT_CSV = REPO_ROOT / "papers/diffaudit-evidence-paper/data/report_correctness_fault_injection.csv"
-DEFAULT_MD = REPO_ROOT / "papers/diffaudit-evidence-paper/versions/direction-d-report-correctness-fault-injection.md"
+PAPER = Path(os.environ.get("DIFFAUDIT_EVIDENCE_PAPER_DIR", REPO_ROOT / "papers" / "diffaudit-evidence-paper")).resolve()
+DEFAULT_CSV = PAPER / "data" / "report_correctness_fault_injection.csv"
+DEFAULT_MD = PAPER / "versions" / "direction-d-report-correctness-fault-injection.md"
 
 
 @dataclass(frozen=True)

scripts/util/run_pr_checks.py

@@ -31,26 +31,62 @@ def run_optional(cmd: list[str], cwd: Path, required_path: Path, label: str) ->
     print(f"SKIP {label}: missing private/local paper data at {required_path}")
 
 
+def run_optional_min_files(cmd: list[str], cwd: Path, files: list[Path], min_files: int, label: str) -> None:
+    if len(files) >= min_files:
+        run(cmd, cwd)
+        return
+    print(f"SKIP {label}: found {len(files)} reviewer file(s), need {min_files}")
+
+
 def main() -> None:
     repo_root = Path(__file__).resolve().parents[2]
     python_executable = sys.executable
-    paper_data = repo_root / "papers" / "diffaudit-evidence-paper" / "data"
+    paper_root = Path(os.environ.get("DIFFAUDIT_EVIDENCE_PAPER_DIR", repo_root / "papers" / "diffaudit-evidence-paper")).resolve()
+    paper_data = paper_root / "data"
     claim_trace = paper_data / "claim_trace.csv"
+    preflight_dir = repo_root / "docs" / "internal" / "e2-n50-freeze-preflight-2026-06-06"
+    e2q005_review_files = sorted(preflight_dir.glob("e2q005_external_style_review_[A-Z]_2026_06_06.csv"))
+    e2_freeze_ledger_input = preflight_dir / "e2_high_value_public_asset_delta_refresh_late_2026_06_09.csv"
+    e2_false_promotion_queue_input = preflight_dir / "e2_n50_public_surface_metadata_refresh.csv"
+    e2_freeze_preflight_input = preflight_dir / "e2_n50_freeze_review_decisions_v1.csv"
+    false_promotion_bundle_input = preflight_dir / "e2sct004_genai_confessions_public_surface_check_2026_06_06.md"
+    false_promotion_bundle_zip = paper_root / "build" / "diffaudit-false-promotion-review-bundle.zip"
 
     run([python_executable, "scripts/util/run_docs_checks.py"], repo_root)
     run([python_executable, "scripts/paper/render_admitted_risk_card.py", "--check"], repo_root)
     run_optional([python_executable, "scripts/e2/build_claim_gate_recode_packet.py", "--check"], repo_root, claim_trace, "claim-gate recode packet")
     run_optional([python_executable, "scripts/paper/evaluate_report_correctness_faults.py", "--check"], repo_root, claim_trace, "report-correctness faults")
-    run_optional([python_executable, "scripts/e2/aggregate_e2q005_external_review.py", "--min-reviewers", "3"], repo_root, claim_trace, "E2Q-005 review aggregation")
+    run_optional_min_files(
+        [python_executable, "scripts/e2/aggregate_e2q005_external_review.py", "--min-reviewers", "3"],
+        repo_root,
+        e2q005_review_files,
+        3,
+        "E2Q-005 review aggregation",
+    )
     run_optional([python_executable, "scripts/e2/aggregate_false_promotion_external_review.py", "--check"], repo_root, claim_trace, "false-promotion review aggregation")
-    run_optional([python_executable, "scripts/e2/build_e2_public_freeze_ledger.py", "--check"], repo_root, claim_trace, "E2 public freeze ledger")
-    run_optional([python_executable, "scripts/e2/build_e2_false_promotion_expansion_queue.py", "--check"], repo_root, claim_trace, "false-promotion expansion queue")
-    run_optional([python_executable, "scripts/e2/check_e2_freeze_preflight.py"], repo_root, claim_trace, "E2 freeze preflight")
-    run_optional([python_executable, "scripts/paper/check_paper_release_packet.py"], repo_root, claim_trace, "paper release packet")
+    run_optional([python_executable, "scripts/e2/build_e2_public_freeze_ledger.py", "--check"], repo_root, e2_freeze_ledger_input, "E2 public freeze ledger")
+    run_optional(
+        [python_executable, "scripts/e2/build_e2_false_promotion_expansion_queue.py", "--check"],
+        repo_root,
+        e2_false_promotion_queue_input,
+        "false-promotion expansion queue",
+    )
+    run_optional([python_executable, "scripts/e2/check_e2_freeze_preflight.py"], repo_root, e2_freeze_preflight_input, "E2 freeze preflight")
+    run_optional([python_executable, "scripts/paper/check_paper_release_packet.py", "--profile", "phase-g"], repo_root, claim_trace, "paper release packet")
     run_optional([python_executable, "scripts/paper/export_paper_supplement.py", "--check"], repo_root, claim_trace, "paper supplement export")
     run_optional([python_executable, "scripts/paper/export_paper_supplement.py", "--check-output"], repo_root, claim_trace, "paper supplement output")
-    run_optional([python_executable, "scripts/e2/export_false_promotion_review_bundle.py", "--check"], repo_root, claim_trace, "false-promotion review bundle")
-    run_optional([python_executable, "scripts/e2/export_false_promotion_review_bundle.py", "--check-output"], repo_root, claim_trace, "false-promotion review bundle output")
+    run_optional(
+        [python_executable, "scripts/e2/export_false_promotion_review_bundle.py", "--check"],
+        repo_root,
+        false_promotion_bundle_input,
+        "false-promotion review bundle",
+    )
+    run_optional(
+        [python_executable, "scripts/e2/export_false_promotion_review_bundle.py", "--check-output"],
+        repo_root,
+        false_promotion_bundle_zip,
+        "false-promotion review bundle output",
+    )
     run(
         [
             python_executable,