64 lines
3.4 KiB
Python
64 lines
3.4 KiB
Python
#!/usr/bin/env python3
|
|
"""Generate deterministic P6-02 journal/checkpoint reconciliation evidence."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import argparse
|
|
import hashlib
|
|
import json
|
|
import subprocess
|
|
from pathlib import Path
|
|
from typing import Any
|
|
|
|
|
|
OUTPUTS = (Path("web/workspace/journal.mjs"), Path("web/workspace/recovery.mjs"), Path("web/worker/operation-ledger.mjs"), Path("web/worker/sim-session.mjs"), Path("web/worker/test_device_recovery.mjs"))
|
|
TESTS = (("device_recovery", ["node", "web/worker/test_device_recovery.mjs"]), ("fault_matrix", ["node", "web/worker/test_recovery_offline_faults.mjs"]), ("workspace_recovery", ["node", "web/workspace/test_recovery.mjs"]))
|
|
|
|
|
|
def canonical(value: Any) -> str:
|
|
return json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":"))
|
|
|
|
|
|
def sha256(path: Path) -> str:
|
|
return hashlib.sha256(path.read_bytes()).hexdigest()
|
|
|
|
|
|
def run(root: Path, command: list[str]) -> dict[str, Any]:
|
|
result = subprocess.run(command, cwd=root, stdout=subprocess.PIPE, stderr=subprocess.PIPE, check=False)
|
|
return {"status": "verified" if result.returncode == 0 else "blocked", "command": " ".join(command), "returncode": result.returncode, "stdout": result.stdout.decode("utf-8", errors="replace")[-2500:], "stderr": result.stderr.decode("utf-8", errors="replace")[-2000:]}
|
|
|
|
|
|
def generate(root: Path, report_path: Path) -> dict[str, Any]:
|
|
tests = {name: run(root, command) for name, command in TESTS}
|
|
report: dict[str, Any] = {
|
|
"schema": "reconciliation-report.v1",
|
|
"task_id": "P6-02",
|
|
"context_id": "linuxcnc-2.10.0-pre0-wasm-m1-py-c1",
|
|
"status": "verified" if all(item["status"] == "verified" for item in tests.values()) else "blocked",
|
|
"journal": {"schema": "workspace-journal.v1", "states": ["prepare", "commit", "abort"], "hash": "fnv1a64 content/prepare/data"},
|
|
"checkpoint": {"schema": "simulation-checkpoint.v1", "state_hash": True, "timeline_prefix": True, "context": True},
|
|
"operations": {"pending": "requires reconcile callback", "failed": "blocked", "aborted": "ABORTED result", "committed": "replayed without side effect"},
|
|
"boundaries": ["schema mismatch", "hash mismatch", "half commit", "duplicate operation", "duplicate event", "unconfirmed operation", "failed operation"],
|
|
"tests": tests,
|
|
"outputs": [{"path": path.as_posix(), "bytes": (root / path).stat().st_size, "sha256": sha256(root / path)} for path in OUTPUTS],
|
|
"known_boundaries": ["OPFS migration/offline cache is P6-03", "browser recovery UX is P7-05"],
|
|
}
|
|
report["report_sha256"] = hashlib.sha256(canonical(report).encode("utf-8")).hexdigest()
|
|
report_path.parent.mkdir(parents=True, exist_ok=True)
|
|
report_path.write_text(json.dumps(report, ensure_ascii=False, sort_keys=True, indent=2) + "\n", encoding="utf-8")
|
|
return report
|
|
|
|
|
|
def main() -> int:
|
|
parser = argparse.ArgumentParser(description=__doc__)
|
|
parser.add_argument("--repo-root", type=Path, default=Path(__file__).resolve().parents[1])
|
|
parser.add_argument("--report", type=Path, default=Path("coverage/reconciliation.report.json"))
|
|
args = parser.parse_args()
|
|
report = generate(args.repo_root.resolve(), args.repo_root.resolve() / args.report)
|
|
print(f"reconciliation={report['status']} tests={len(report['tests'])}")
|
|
return 0 if report["status"] == "verified" else 1
|
|
|
|
|
|
if __name__ == "__main__":
|
|
raise SystemExit(main())
|