Files
linuxcncWebWASM/scripts/generate_task_program_state_report.py

69 lines
3.2 KiB
Python

#!/usr/bin/env python3
"""Generate deterministic P3-04 Task/MDI/program state evidence."""
from __future__ import annotations
import argparse
import hashlib
import json
import subprocess
from pathlib import Path
from typing import Any
OUTPUTS = (
Path("web/worker/sim-session.mjs"),
Path("web/worker/sim-task.mjs"),
Path("web/worker/operation-ledger.mjs"),
Path("web/worker/program-runner.mjs"),
Path("web/worker/test_task_program_state.mjs"),
)
def canonical(value: Any) -> str:
return json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":"))
def sha256(path: Path) -> str:
digest = hashlib.sha256()
with path.open("rb") as handle:
for chunk in iter(lambda: handle.read(1024 * 1024), b""):
digest.update(chunk)
return digest.hexdigest()
def generate(root: Path, report_path: Path) -> dict[str, Any]:
result = subprocess.run(["node", "web/worker/test_task_program_state.mjs"], cwd=root, stdout=subprocess.PIPE, stderr=subprocess.PIPE, check=False)
report: dict[str, Any] = {
"schema": "task-program-state-report.v1",
"task_id": "P3-04",
"context_id": "linuxcnc-2.10.0-pre0-wasm-m1-py-c1",
"status": "verified" if result.returncode == 0 else "blocked",
"states": ["NEW", "READY", "RUNNING", "PAUSED", "ESTOP", "FAULT", "STOPPED", "DESTROYED"],
"modes": ["MANUAL", "MDI", "AUTO"],
"program_commands": ["PROGRAM_LOAD", "PROGRAM_RUN", "PROGRAM_PAUSE", "PROGRAM_RESUME", "PROGRAM_STEP", "PROGRAM_ABORT", "PROGRAM_RESTART", "PROGRAM_SEEK", "MDI_EXECUTE"],
"ledger": {"idempotency": True, "duplicate_side_effects": 0, "failed_operation_recovery": "explicitly blocked unless reconciled"},
"recovery": {"checkpoint": True, "event_replay": True, "state_hash": "fnv1a64 task/scheduler/program state", "wall_clock": False},
"outputs": [{"path": path.as_posix(), "bytes": (root / path).stat().st_size, "sha256": sha256(root / path)} for path in OUTPUTS],
"test": {"status": "verified" if result.returncode == 0 else "blocked", "command": "node web/worker/test_task_program_state.mjs", "stdout": result.stdout.decode("utf-8", errors="replace")[-4000:], "stderr": result.stderr.decode("utf-8", errors="replace")[-4000:]},
"known_boundaries": ["canonical TP/motion adapter remains P3-03 evidence", "full IO/Python command families remain P4/P5"],
}
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/task-program-state.report.json"))
args = parser.parse_args()
report = generate(args.repo_root.resolve(), args.repo_root.resolve() / args.report)
print(f"task_program_state={report['status']} test={report['test']['status']}")
return 0 if report["status"] == "verified" else 1
if __name__ == "__main__":
raise SystemExit(main())