@harmonyos-arkts/d2h 0.1.10 → 0.1.12

package/skills/d2h-utg-ai-generate/scripts/build_utg.py

@@ -1,123 +1,123 @@
-#!/usr/bin/env python3
-from __future__ import annotations
-
-import argparse
-import subprocess
-import sys
-from pathlib import Path
-
-from utg_common import (
-    UtgError,
-    atomic_write_json,
-    build_click_paths,
-    load_json,
-    normalize_facts,
-    summary,
-    validate_pair,
-)
-from build_page_json import build_page_plan, validate_page_plan
-
-
-def parse_args() -> argparse.Namespace:
-    parser = argparse.ArgumentParser(
-        description="Build normalized utg.json and deterministic click_paths.json from AI source facts."
-    )
-    parser.add_argument("--facts", required=True, type=Path)
-    parser.add_argument("--project-root", required=True, type=Path)
-    parser.add_argument("--workspace", required=True, type=Path)
-    parser.add_argument("--force", action="store_true", help="replace existing generated outputs")
-    return parser.parse_args()
-
-
-def main() -> int:
-    args = parse_args()
-    workspace = args.workspace.resolve()
-    project_root = args.project_root.resolve()
-    if not project_root.is_dir():
-        print(f"ERROR: project root is not a directory: {project_root}", file=sys.stderr)
-        return 2
-    outputs = [
-        workspace / "utg.json",
-        workspace / "click_paths.json",
-        workspace / "page.json",
-    ]
-    existing = [path for path in outputs if path.exists()]
-    if existing and not args.force:
-        print(
-            "ERROR: generated output already exists; use --force only for an authorized regeneration: "
-            + ", ".join(str(path) for path in existing),
-            file=sys.stderr,
-        )
-        return 2
-    try:
-        facts = load_json(args.facts.resolve())
-        utg, normalizations, unresolved = normalize_facts(facts, project_root)
-        click_paths = build_click_paths(utg)
-        errors = validate_pair(utg, click_paths, project_root)
-        if errors:
-            raise UtgError("generated pair failed validation:\n- " + "\n- ".join(errors))
-        page_plan = build_page_plan(
-            utg,
-            click_paths,
-            utg_path=str(outputs[0]),
-            click_paths_path=str(outputs[1]),
-        )
-        page_errors = validate_page_plan(
-            page_plan,
-            utg,
-            click_paths,
-            utg_path=str(outputs[0]),
-            click_paths_path=str(outputs[1]),
-        )
-        if page_errors:
-            raise UtgError("generated page plan failed validation:\n- " + "\n- ".join(page_errors))
-        report = {
-            "schema_version": "d2h-utg-ai-generation-report/v1",
-            "status": "valid",
-            "method": facts.get('graph', {}).get('method', 'ai-source-analysis'),
-            "facts": str(args.facts.resolve()),
-            "project_root": str(project_root),
-            "summary": summary(utg, click_paths),
-            "page_plan": page_plan["summary"],
-            "normalizations": normalizations,
-            "unresolved": unresolved,
-        }
-        if 'projection_summary' in facts.get('graph', {}):
-            report['projection'] = facts['graph']['projection_summary']
-        atomic_write_json(outputs[0], utg)
-        atomic_write_json(outputs[1], click_paths)
-        atomic_write_json(outputs[2], page_plan)
-        atomic_write_json(workspace / "generation-report.json", report)
-        # Interactive visualization — same renderer android-utg-static ships
-        # (extended for reconciliation semantics), so the output is comparable.
-        # It reads <workspace>/utg.json and writes <workspace>/utg.html. Best
-        # effort: a visualization failure must not fail the build.
-        html_script = Path(__file__).resolve().parent / "utg_html.py"
-        if html_script.exists():
-            result = subprocess.run(
-                [sys.executable, str(html_script), str(workspace)],
-                capture_output=True,
-                text=True,
-            )
-            if result.returncode != 0:
-                print(
-                    f"WARN: utg.html generation failed: {result.stderr.strip()}",
-                    file=sys.stderr,
-                )
-    except UtgError as exc:
-        print(f"ERROR: {exc}", file=sys.stderr)
-        return 2
-
-    counts = report["summary"]
-    print(
-        f"valid: nodes={counts['nodes']} edges={counts['edges']} "
-        f"reachable={counts['reachable']} unreachable={counts['unreachable']}"
-    )
-    print(outputs[0])
-    print(outputs[1])
-    print(outputs[2])
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())
+#!/usr/bin/env python3
+from __future__ import annotations
+
+import argparse
+import subprocess
+import sys
+from pathlib import Path
+
+from utg_common import (
+    UtgError,
+    atomic_write_json,
+    build_click_paths,
+    load_json,
+    normalize_facts,
+    summary,
+    validate_pair,
+)
+from build_page_json import build_page_plan, validate_page_plan
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(
+        description="Build normalized utg.json and deterministic click_paths.json from AI source facts."
+    )
+    parser.add_argument("--facts", required=True, type=Path)
+    parser.add_argument("--project-root", required=True, type=Path)
+    parser.add_argument("--workspace", required=True, type=Path)
+    parser.add_argument("--force", action="store_true", help="replace existing generated outputs")
+    return parser.parse_args()
+
+
+def main() -> int:
+    args = parse_args()
+    workspace = args.workspace.resolve()
+    project_root = args.project_root.resolve()
+    if not project_root.is_dir():
+        print(f"ERROR: project root is not a directory: {project_root}", file=sys.stderr)
+        return 2
+    outputs = [
+        workspace / "utg.json",
+        workspace / "click_paths.json",
+        workspace / "page.json",
+    ]
+    existing = [path for path in outputs if path.exists()]
+    if existing and not args.force:
+        print(
+            "ERROR: generated output already exists; use --force only for an authorized regeneration: "
+            + ", ".join(str(path) for path in existing),
+            file=sys.stderr,
+        )
+        return 2
+    try:
+        facts = load_json(args.facts.resolve())
+        utg, normalizations, unresolved = normalize_facts(facts, project_root)
+        click_paths = build_click_paths(utg)
+        errors = validate_pair(utg, click_paths, project_root)
+        if errors:
+            raise UtgError("generated pair failed validation:\n- " + "\n- ".join(errors))
+        page_plan = build_page_plan(
+            utg,
+            click_paths,
+            utg_path=str(outputs[0]),
+            click_paths_path=str(outputs[1]),
+        )
+        page_errors = validate_page_plan(
+            page_plan,
+            utg,
+            click_paths,
+            utg_path=str(outputs[0]),
+            click_paths_path=str(outputs[1]),
+        )
+        if page_errors:
+            raise UtgError("generated page plan failed validation:\n- " + "\n- ".join(page_errors))
+        report = {
+            "schema_version": "d2h-utg-ai-generation-report/v1",
+            "status": "valid",
+            "method": facts.get('graph', {}).get('method', 'ai-source-analysis'),
+            "facts": str(args.facts.resolve()),
+            "project_root": str(project_root),
+            "summary": summary(utg, click_paths),
+            "page_plan": page_plan["summary"],
+            "normalizations": normalizations,
+            "unresolved": unresolved,
+        }
+        if 'projection_summary' in facts.get('graph', {}):
+            report['projection'] = facts['graph']['projection_summary']
+        atomic_write_json(outputs[0], utg)
+        atomic_write_json(outputs[1], click_paths)
+        atomic_write_json(outputs[2], page_plan)
+        atomic_write_json(workspace / "generation-report.json", report)
+        # Interactive visualization — same renderer android-utg-static ships
+        # (extended for reconciliation semantics), so the output is comparable.
+        # It reads <workspace>/utg.json and writes <workspace>/utg.html. Best
+        # effort: a visualization failure must not fail the build.
+        html_script = Path(__file__).resolve().parent / "utg_html.py"
+        if html_script.exists():
+            result = subprocess.run(
+                [sys.executable, str(html_script), str(workspace)],
+                capture_output=True,
+                text=True,
+            )
+            if result.returncode != 0:
+                print(
+                    f"WARN: utg.html generation failed: {result.stderr.strip()}",
+                    file=sys.stderr,
+                )
+    except UtgError as exc:
+        print(f"ERROR: {exc}", file=sys.stderr)
+        return 2
+
+    counts = report["summary"]
+    print(
+        f"valid: nodes={counts['nodes']} edges={counts['edges']} "
+        f"reachable={counts['reachable']} unreachable={counts['unreachable']}"
+    )
+    print(outputs[0])
+    print(outputs[1])
+    print(outputs[2])
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())