core-runtime-engine 11.5.1__py3-none-any.whl

core_runtime/cli/sync_template.py

@@ -0,0 +1,67 @@
+"""CLI command for `core-runtime sync-template`."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from core_runtime.tooling.diagnostics import DiagnosticCollection, ExitCode
+from core_runtime.tooling.sync_template import SyncTemplateReport, TemplateSyncPlanner
+
+
+def cmd_sync_template(args: object) -> int:
+    """Execute the dry-run template synchronization planner."""
+    fmt: str = getattr(args, "format", "json")
+    output = getattr(args, "output", None)
+    domain = getattr(args, "domain", None)
+    all_domains = bool(getattr(args, "all", False))
+    template = getattr(args, "template", "generic")
+    dry_run = bool(getattr(args, "dry_run", False))
+    repo_root = Path(__file__).resolve().parents[2]
+    planner = TemplateSyncPlanner(repo_root)
+
+    if not dry_run:
+        diagnostics = DiagnosticCollection()
+        diagnostics.add_blocked(
+            code="core.sync_template.dry_run_required",
+            message="sync-template is dry-run only in this slice",
+            path=domain or "sync-template",
+            expected="--dry-run",
+            actual="missing dry-run",
+        )
+        report = SyncTemplateReport(
+            tool="core-runtime sync-template",
+            command=planner._command(domain=domain, all_domains=all_domains),
+            status="blocked",
+            summary={"mode": "missing_dry_run", "item_count": 0},
+            selection={"domain": domain, "all": all_domains, "template": template, "mode": "missing_dry_run"},
+            diagnostics=diagnostics,
+        )
+    else:
+        report = planner.build_plan(domain=domain, all_domains=all_domains, template=template)
+
+    output_path = Path(output) if output else None
+    if fmt == "json":
+        payload = report.to_dict()
+        text = json.dumps(payload, indent=2, ensure_ascii=False)
+        if output_path:
+            output_path.parent.mkdir(parents=True, exist_ok=True)
+            output_path.write_text(text + "\n", encoding="utf-8")
+        else:
+            print(text)
+    else:
+        markdown = report.to_markdown()
+        if output_path:
+            output_path.parent.mkdir(parents=True, exist_ok=True)
+            output_path.write_text(markdown, encoding="utf-8")
+        else:
+            print(markdown)
+
+    status_to_exit = {
+        "pass": ExitCode.OK.value,
+        "warning": ExitCode.OK.value,
+        "error": ExitCode.ERROR.value,
+        "blocked": ExitCode.BLOCKED.value,
+        "internal_error": ExitCode.INTERNAL_ERROR.value,
+    }
+    return status_to_exit.get(report.status, ExitCode.INTERNAL_ERROR.value)

core_runtime/cli/validate.py

@@ -0,0 +1,73 @@
+"""CLI commands for read-only structural validation."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from core_runtime.tooling.diagnostics import ExitCode
+from core_runtime.tooling.validation import RepositoryValidation
+
+
+_KIND_ALIASES = {
+    "schema": "schemas",
+    "schemas": "schemas",
+    "example": "examples",
+    "examples": "examples",
+    "manifest": "manifests",
+    "manifests": "manifests",
+    "contract": "contracts",
+    "contracts": "contracts",
+    "domain": "domain",
+    "domains": "domain",
+}
+
+
+def _normalize_kind(kind: str | None) -> str | None:
+    if kind is None:
+        return None
+    return _KIND_ALIASES.get(kind.lower())
+
+
+def _emit_report(report, fmt: str, output) -> None:
+    payload = report.to_dict()
+    if fmt == "json":
+        text = json.dumps(payload, indent=2, ensure_ascii=False)
+    else:
+        text = report.to_markdown()
+    if output:
+        output_path = Path(output)
+        output_path.parent.mkdir(parents=True, exist_ok=True)
+        output_path.write_text(text + ("\n" if fmt == "json" else ""), encoding="utf-8")
+    else:
+        print(text)
+
+
+def cmd_validate(args: object) -> int:
+    """Run read-only structural validation."""
+    raw_kind = getattr(args, "kind", None)
+    name = getattr(args, "name", None)
+    fmt: str = getattr(args, "format", "json")
+    output = getattr(args, "output", None)
+    repo_root = Path(__file__).resolve().parents[2]
+    validator = RepositoryValidation(repo_root)
+
+    kind = _normalize_kind(raw_kind)
+    if raw_kind is not None and kind is None:
+        kind = str(raw_kind)
+    if kind is None:
+        kind = "schemas"
+    if kind == "domain" and not name and raw_kind not in (None, "domain", "domains"):
+        name = str(raw_kind)
+        kind = "domain"
+
+    report = validator.build_report(kind=kind, name=name)
+    _emit_report(report, fmt, output)
+    return {
+        "pass": ExitCode.OK.value,
+        "warning": ExitCode.OK.value,
+        "error": ExitCode.ERROR.value,
+        "blocked": ExitCode.BLOCKED.value,
+        "internal_error": ExitCode.INTERNAL_ERROR.value,
+    }.get(report.status, ExitCode.INTERNAL_ERROR.value)
+

core_runtime/core/__init__.py

@@ -0,0 +1,34 @@
+"""Core helpers kept by the v11 whitelist rebuild.
+
+Only modules reached from the public surface live here. The historical
+runtime (execution graphs, domain SDK, memory, experience) was archived
+with the CPT legacy — see docs/CORE_REBUILD_FROM_ZERO.md.
+"""
+
+from core_runtime.core.contract_loader import (
+    available_contracts,
+    contract_schema_path,
+    load_contract_schema,
+)
+from core_runtime.core.contract_evaluator import (
+    bind_artifact_fingerprint,
+    evaluate_contract_file,
+    evaluate_contract_payload,
+    executable_contract_versions,
+)
+from core_runtime.core.contract_program import execute_contract_program
+from core_runtime.core.contract_program_v2 import evaluate_contract_v2
+from core_runtime.core.dsk_v3 import evaluate_dsk_v3
+
+__all__ = [
+    "available_contracts",
+    "bind_artifact_fingerprint",
+    "contract_schema_path",
+    "evaluate_contract_file",
+    "evaluate_contract_payload",
+    "evaluate_contract_v2",
+    "evaluate_dsk_v3",
+    "execute_contract_program",
+    "executable_contract_versions",
+    "load_contract_schema",
+]