consiliency-contract 0.1.0__py3-none-any.whl

consiliency_contract/__init__.py

@@ -0,0 +1,64 @@
+"""Thin Python reader for the Consiliency shared contract data."""
+
+from __future__ import annotations
+
+import json
+from importlib import resources
+from pathlib import Path
+from typing import Any
+
+CONTRACT_PACKAGE = "consiliency-contract"
+CONTRACT_VERSION = "0.1.0"
+__version__ = "0.1.0"
+
+
+def _source_root() -> Path:
+    return Path(__file__).resolve().parent.parent
+
+
+def _read_text(relative_path: str) -> str:
+    source_path = _source_root() / relative_path
+    if source_path.exists():
+        return source_path.read_text(encoding="utf-8")
+    data_path = resources.files(__package__).joinpath("_data", relative_path)
+    return data_path.read_text(encoding="utf-8")
+
+
+def _read_json(relative_path: str) -> dict[str, Any]:
+    return json.loads(_read_text(relative_path))
+
+
+def load_contract() -> dict[str, Any]:
+    return _read_json("core/contract.json")
+
+
+CONTRACT = load_contract()
+
+
+def load_schema(name: str) -> dict[str, Any]:
+    relative_path = CONTRACT["schemas"].get(name)
+    if not relative_path:
+        raise ValueError(f"Unknown schema: {name}")
+    return _read_json(relative_path)
+
+
+def load_registry(name: str) -> dict[str, Any]:
+    relative_path = CONTRACT["registries"].get(name)
+    if not relative_path:
+        raise ValueError(f"Unknown registry: {name}")
+    return _read_json(relative_path)
+
+
+def list_vectors() -> list[str]:
+    source_dir = _source_root() / CONTRACT["conformance"]["vector_root"]
+    if source_dir.exists():
+        return sorted(path.name for path in source_dir.glob("*.json"))
+    data_dir = resources.files(__package__).joinpath("_data", CONTRACT["conformance"]["vector_root"])
+    return sorted(path.name for path in data_dir.iterdir() if path.name.endswith(".json"))
+
+
+def load_vector(name: str) -> dict[str, Any]:
+    filename = name if name.endswith(".json") else f"{name}.json"
+    if filename not in list_vectors():
+        raise ValueError(f"Unknown vector: {name}")
+    return _read_json(f"{CONTRACT['conformance']['vector_root']}/{filename}")

consiliency_contract/_data/conformance/vectors/canonical-html-contract-loaded.json

@@ -0,0 +1,15 @@
+{
+  "id": "canonical-html-contract-loaded",
+  "description": "The relocated canonical_html.v1 contract is present with recorded provenance.",
+  "input": {
+    "contract_path": "core/canonical-html/contract-v1.json",
+    "provenance_path": "core/canonical-html/provenance.json",
+    "expected_sha256": "3c0c11b7be8b2301409c47416269dd5579fac90f6e7a4e9ca9c3caef50bd2e28"
+  },
+  "decision": {
+    "schema": "consiliency.conformance_decision.v1",
+    "status": "accepted",
+    "maturity": "hash-checked",
+    "findings": []
+  }
+}

consiliency_contract/_data/conformance/vectors/interface-invalid-host-path.json

@@ -0,0 +1,26 @@
+{
+  "id": "interface-invalid-host-path",
+  "description": "Local sibling checkout paths are rejected from public interface data.",
+  "input": {
+    "schema": "consiliency.interface_declaration.v1",
+    "repo_id": "governed-pipeline",
+    "realized_edges": [
+      {
+        "id": "bad-path",
+        "provider_repo": "spec",
+        "consumer_repo": "governed-pipeline",
+        "interface_id": "spec-certificate",
+        "ref": {"kind": "repo-relative-path", "value": "/absolute/private/spec-certificate-canon.mjs"},
+        "maturity": "realized-edge-observed",
+        "evidence": []
+      }
+    ],
+    "promised_edges": []
+  },
+  "decision": {
+    "schema": "consiliency.conformance_decision.v1",
+    "status": "rejected",
+    "maturity": "presence-only",
+    "findings": [{"code": "interface.ref.host_path", "severity": "block", "message": "Interface refs must not contain host absolute paths."}]
+  }
+}

consiliency_contract/_data/conformance/vectors/interface-valid-realized-and-promised.json

@@ -0,0 +1,36 @@
+{
+  "id": "interface-valid-realized-and-promised",
+  "description": "Interface declarations can carry realized and promised edges with safe refs.",
+  "input": {
+    "schema": "consiliency.interface_declaration.v1",
+    "repo_id": "governed-pipeline",
+    "realized_edges": [
+      {
+        "id": "harness-pin",
+        "provider_repo": "agent-harness",
+        "consumer_repo": "governed-pipeline",
+        "interface_id": "phase-loop-cli-entrypoint",
+        "ref": {"kind": "git-ref", "value": "v0.1.12"},
+        "maturity": "realized-edge-observed",
+        "evidence": [{"ref": "tools/agent-harness.pin.json", "digest": "sha256:0000000000000000000000000000000000000000000000000000000000000000"}]
+      }
+    ],
+    "promised_edges": [
+      {
+        "id": "contract-package",
+        "provider_repo": "consiliency-contract",
+        "consumer_repo": "governed-pipeline",
+        "interface_id": "consiliency-contract-v1",
+        "ref": {"kind": "package-coordinate", "value": "@consiliency/contract@^0.1.0"},
+        "maturity": "presence-only",
+        "evidence": []
+      }
+    ]
+  },
+  "decision": {
+    "schema": "consiliency.conformance_decision.v1",
+    "status": "accepted",
+    "maturity": "realized-edge-observed",
+    "findings": []
+  }
+}

consiliency_contract/_data/conformance/vectors/loop-gate-invalid-blocking-default.json

@@ -0,0 +1,15 @@
+{
+  "id": "loop-gate-invalid-blocking-default",
+  "description": "Phase 0 contract data must not make blocking the default.",
+  "input": {
+    "schema": "consiliency.loop_gate_scenario.v1",
+    "gate": "presence",
+    "severity_default": "block"
+  },
+  "decision": {
+    "schema": "consiliency.conformance_decision.v1",
+    "status": "rejected",
+    "maturity": "presence-only",
+    "findings": [{"code": "gate.default.blocking", "severity": "block", "message": "Blocking must be opt-in during Phase 0."}]
+  }
+}

consiliency_contract/_data/conformance/vectors/loop-gate-missing-doc-warns.json

@@ -0,0 +1,16 @@
+{
+  "id": "loop-gate-missing-doc-warns",
+  "description": "Phase 0 missing document checks warn by default.",
+  "input": {
+    "schema": "consiliency.loop_gate_scenario.v1",
+    "gate": "presence",
+    "missing": ["runbook"],
+    "consumer_policy": {"blocking_opt_in": false}
+  },
+  "decision": {
+    "schema": "consiliency.conformance_decision.v1",
+    "status": "warn",
+    "maturity": "presence-only",
+    "findings": [{"code": "presence.missing_doc", "severity": "warn", "message": "Required document is missing at L0."}]
+  }
+}

consiliency_contract/_data/conformance/vectors/manifest-invalid-absolute-path.json

@@ -0,0 +1,20 @@
+{
+  "id": "manifest-invalid-absolute-path",
+  "description": "Host absolute paths are rejected from public package data.",
+  "input": {
+    "schema": "consiliency.manifest.v1",
+    "contract_version": "0.1.0",
+    "repo": {"id": "bad", "display_name": "Bad", "default_branch": "main"},
+    "declaration": {"mode": "baseline-only"},
+    "documents": [
+      {"id": "readme", "class": "index", "path": "/absolute/private/README.md", "maturity": "presence-only", "target_level": "L0", "required": true}
+    ],
+    "interfaces": ".consiliency/interfaces.json"
+  },
+  "decision": {
+    "schema": "consiliency.conformance_decision.v1",
+    "status": "rejected",
+    "maturity": "presence-only",
+    "findings": [{"code": "path.absolute", "severity": "block", "message": "Paths must be repo-relative."}]
+  }
+}

consiliency_contract/_data/conformance/vectors/manifest-invalid-certified-maturity.json

@@ -0,0 +1,20 @@
+{
+  "id": "manifest-invalid-certified-maturity",
+  "description": "Phase 0 vectors must not claim certified maturity.",
+  "input": {
+    "schema": "consiliency.manifest.v1",
+    "contract_version": "0.1.0",
+    "repo": {"id": "bad", "display_name": "Bad", "default_branch": "main"},
+    "declaration": {"mode": "baseline-only"},
+    "documents": [
+      {"id": "glossary", "class": "proj-S", "path": "docs/glossary.html", "maturity": "certified", "target_level": "L1", "required": true}
+    ],
+    "interfaces": ".consiliency/interfaces.json"
+  },
+  "decision": {
+    "schema": "consiliency.conformance_decision.v1",
+    "status": "rejected",
+    "maturity": "presence-only",
+    "findings": [{"code": "maturity.certified.phase0", "severity": "block", "message": "Certified maturity is reserved for post-XG-1 evidence."}]
+  }
+}

consiliency_contract/_data/conformance/vectors/manifest-invalid-path-and-ref.json

@@ -0,0 +1,20 @@
+{
+  "id": "manifest-invalid-path-and-ref",
+  "description": "A document declaration must use exactly one of path or ref.",
+  "input": {
+    "schema": "consiliency.manifest.v1",
+    "contract_version": "0.1.0",
+    "repo": {"id": "bad", "display_name": "Bad", "default_branch": "main"},
+    "declaration": {"mode": "baseline-only"},
+    "documents": [
+      {"id": "readme", "class": "index", "path": "README.md", "ref": {"kind": "url", "value": "https://example.invalid"}, "maturity": "presence-only", "target_level": "L0", "required": true}
+    ],
+    "interfaces": ".consiliency/interfaces.json"
+  },
+  "decision": {
+    "schema": "consiliency.conformance_decision.v1",
+    "status": "rejected",
+    "maturity": "presence-only",
+    "findings": [{"code": "document.path_ref.exclusive", "severity": "block", "message": "Document declarations must use exactly one of path or ref."}]
+  }
+}

consiliency_contract/_data/conformance/vectors/manifest-invalid-unknown-archetype.json

@@ -0,0 +1,18 @@
+{
+  "id": "manifest-invalid-unknown-archetype",
+  "description": "Unknown archetypes are rejected.",
+  "input": {
+    "schema": "consiliency.manifest.v1",
+    "contract_version": "0.1.0",
+    "repo": {"id": "bad", "display_name": "Bad", "default_branch": "main"},
+    "declaration": {"mode": "archetyped", "archetypes": ["website"], "modifiers": []},
+    "documents": [],
+    "interfaces": ".consiliency/interfaces.json"
+  },
+  "decision": {
+    "schema": "consiliency.conformance_decision.v1",
+    "status": "rejected",
+    "maturity": "presence-only",
+    "findings": [{"code": "archetype.unknown", "severity": "block", "message": "Archetype is not in the contract registry."}]
+  }
+}

consiliency_contract/_data/conformance/vectors/manifest-valid-baseline-only.json

@@ -0,0 +1,20 @@
+{
+  "id": "manifest-valid-baseline-only",
+  "description": "A baseline-only declaration is legal and carries no archetype list.",
+  "input": {
+    "schema": "consiliency.manifest.v1",
+    "contract_version": "0.1.0",
+    "repo": {"id": "notes", "display_name": "Notes", "default_branch": "main"},
+    "declaration": {"mode": "baseline-only"},
+    "documents": [
+      {"id": "readme", "class": "index", "path": "README.md", "maturity": "presence-only", "target_level": "L0", "required": true}
+    ],
+    "interfaces": ".consiliency/interfaces.json"
+  },
+  "decision": {
+    "schema": "consiliency.conformance_decision.v1",
+    "status": "accepted",
+    "maturity": "presence-only",
+    "findings": []
+  }
+}

consiliency_contract/_data/conformance/vectors/manifest-valid-product.json

@@ -0,0 +1,21 @@
+{
+  "id": "manifest-valid-product",
+  "description": "An archetyped product manifest with repo-relative documents is accepted at L0.",
+  "input": {
+    "schema": "consiliency.manifest.v1",
+    "contract_version": "0.1.0",
+    "repo": {"id": "portal", "display_name": "Consiliency Portal", "default_branch": "main"},
+    "declaration": {"mode": "archetyped", "archetypes": ["product"], "modifiers": ["user-facing"]},
+    "documents": [
+      {"id": "readme", "class": "index", "path": "README.md", "maturity": "presence-only", "target_level": "L0", "required": true},
+      {"id": "contract-version-status", "class": "index", "path": ".consiliency/status.json", "maturity": "presence-only", "target_level": "L0", "required": true}
+    ],
+    "interfaces": ".consiliency/interfaces.json"
+  },
+  "decision": {
+    "schema": "consiliency.conformance_decision.v1",
+    "status": "accepted",
+    "maturity": "presence-only",
+    "findings": []
+  }
+}

consiliency_contract/_data/conformance/vectors/version-skew-compatible.json

@@ -0,0 +1,15 @@
+{
+  "id": "version-skew-compatible",
+  "description": "Contract and package versions in the 0.1 range are compatible.",
+  "input": {
+    "schema": "consiliency.version_skew_scenario.v1",
+    "contract_version": "0.1.0",
+    "package_version": "0.1.0"
+  },
+  "decision": {
+    "schema": "consiliency.conformance_decision.v1",
+    "status": "accepted",
+    "maturity": "presence-only",
+    "findings": []
+  }
+}

consiliency_contract/_data/conformance/vectors/version-skew-incompatible-warns.json

@@ -0,0 +1,15 @@
+{
+  "id": "version-skew-incompatible-warns",
+  "description": "Version skew emits a warning by default during Phase 0.",
+  "input": {
+    "schema": "consiliency.version_skew_scenario.v1",
+    "contract_version": "0.2.0",
+    "package_version": "0.1.0"
+  },
+  "decision": {
+    "schema": "consiliency.conformance_decision.v1",
+    "status": "warn",
+    "maturity": "presence-only",
+    "findings": [{"code": "version_skew.incompatible", "severity": "warn", "message": "Contract and package versions are outside the compatible range."}]
+  }
+}