Files

115 lines
4.2 KiB
Python
Executable File

#!/usr/bin/env python3
"""Independent Marqdo CLI Tool (Tool Protocol v1).
Consumes only public contracts: `$MARQDO_BIN check <doc> --emit <analysis>`
(Analysis v2) and optionally `$MARQDO_BIN run <doc> --trace-file <trace>`
(Trace v2). It links no Rust crate and reads no CLI source tree.
Usage:
marqdo inspect-ext <document.mq.md> [--trace]
Prints one deterministic JSON object:
{"schema":"ext.inspect.v1","document":...,"functions":[...],
"function_digest":"sha256:...", "trace": {...}|null}
"""
import hashlib
import json
import os
import subprocess
import sys
import tempfile
from pathlib import Path
SCHEMA = "ext.inspect.v1"
def fail(message, code=2):
print(json.dumps({"schema": SCHEMA, "error": message}, ensure_ascii=False))
return code
def main(argv):
args = [arg for arg in argv[1:] if not arg.startswith("--")]
want_trace = "--trace" in argv[1:]
if len(args) != 1:
return fail("usage: marqdo inspect-ext <document.mq.md> [--trace]")
bin_path = os.environ.get("MARQDO_BIN")
if not bin_path:
return fail("MARQDO_BIN is not set; install through `marqdo tool install`")
document = Path(args[0]).resolve()
if not document.is_file():
return fail(f"document does not exist: {document}")
with tempfile.TemporaryDirectory(prefix="ext-inspect-") as tmp:
analysis_path = Path(tmp) / "analysis.json"
check = subprocess.run(
[bin_path, "check", str(document), "--emit", str(analysis_path), "--json"],
capture_output=True,
text=True,
)
if check.returncode != 0 or not analysis_path.is_file():
return fail(
"check failed: " + (check.stderr.strip() or check.stdout.strip()),
code=1,
)
analysis = json.loads(analysis_path.read_text(encoding="utf-8"))
functions = []
for module in analysis.get("modules", []):
for function in module.get("functions", []):
functions.append(
{
"id": function["id"],
"module": module["id"],
"local_name": function.get("local_name"),
"heading_span": function.get("heading_span"),
"signature": function.get("signature", {}).get("kind"),
}
)
functions.sort(key=lambda item: item["id"])
digest = hashlib.sha256()
for function in functions:
digest.update(function["id"].encode())
digest.update(b"\0")
heading = function.get("heading_span") or {}
digest.update(f"{heading.get('start', 0)}:{heading.get('end', 0)}".encode())
digest.update(b"\0")
payload = {
"schema": SCHEMA,
"document": document.name,
"analysis_schema_version": analysis.get("schema_version"),
"analysis_digest": hashlib.sha256(
json.dumps(analysis, sort_keys=True, separators=(",", ":")).encode()
).hexdigest(),
"functions": functions,
"function_digest": "sha256:" + digest.hexdigest(),
"trace": None,
}
if want_trace:
trace_path = Path(tmp) / "trace.json"
run = subprocess.run(
[
bin_path,
"run",
str(document),
"--trace-file",
str(trace_path),
"--json",
],
capture_output=True,
text=True,
)
if trace_path.is_file():
trace = json.loads(trace_path.read_text(encoding="utf-8"))
payload["trace"] = {
"schema": trace.get("schema"),
"schema_version": trace.get("schema_version"),
"events": len(trace.get("events", [])),
}
elif run.returncode != 0:
payload["trace"] = {"error": run.stderr.strip()[:500]}
print(json.dumps(payload, ensure_ascii=False, sort_keys=True))
return 0
if __name__ == "__main__":
raise SystemExit(main(sys.argv))