from __future__ import annotations import json import unittest from pathlib import Path from mais_humana.catalog import get_platform from mais_humana.cli import main from mais_humana.human_rulebook import MCP_TRANSIT_FIELDS, evaluate_rulebook from mais_humana.matrix import build_matrix, build_platform_reports from mais_humana.mcp_contract import ( CANONICAL_PROJECT_ID, MCP_CONTROL_PLANE_ID, McpContractKind, build_mcp_contract_report, contracts_for_kind, iter_contracts, mcp_contract_csv, mcp_contract_markdown, mcp_provider_payload, same_source_validation_payload, ) from mais_humana.scanner import scan_platform from tests.helpers import make_tmp class McpProviderContractTests(unittest.TestCase): def make_repo(self, root: Path, platform_id: str, text: str) -> None: platform = get_platform(platform_id) repo = root / platform.repo_name repo.mkdir(parents=True) (repo / "README.md").write_text(text, encoding="utf-8") (repo / "src").mkdir() (repo / "src" / "index.ts").write_text( "\n".join( [ "export const panel = 'admin_ui panelReady sameSource sourcePayloadHash sourceRecordsHash';", "export const trace = 'traceId auditId actor permission result timestamp';", "export const docs = 'responseReady readiness health evidence';", ] ) + "\n", encoding="utf-8", ) def make_report(self, root: Path): self.make_repo( root, "business", "business checkout billing entitlements sameSource panelReady responseReady traceId auditId", ) self.make_repo( root, "docs", "docs catalogOnly formal exception contract canonical sourcePayloadHash sourceRecordsHash", ) scans = tuple(scan_platform(root, get_platform(pid)) for pid in ("business", "docs")) cells = build_matrix(scans) reports = build_platform_reports(scans, cells) rulebook = evaluate_rulebook(reports, limit=60) return build_mcp_contract_report(rulebook) def test_generated_contract_registry_is_large_and_mcp_bound(self) -> None: contracts = iter_contracts() self.assertGreaterEqual(len(contracts), 500) self.assertTrue(any(contract.contract_id == "docs.formal-exception.docs-catalogonly" for contract in contracts)) self.assertTrue(any(contract.control_plane_id == MCP_CONTROL_PLANE_ID for contract in contracts)) self.assertTrue(all(tuple(MCP_TRANSIT_FIELDS) == contract.required_transit_fields for contract in contracts)) def test_contract_report_exports_provider_envelope(self) -> None: report = self.make_report(make_tmp()) envelope = mcp_provider_payload(report, limit=5) self.assertEqual(envelope["origin"], "tudo-para-ia-mais-humana") self.assertEqual(envelope["destination"], MCP_CONTROL_PLANE_ID) self.assertIn("traceId", envelope) self.assertIn("auditId", envelope) self.assertEqual(envelope["payload"]["canonicalProjectId"], CANONICAL_PROJECT_ID) self.assertLessEqual(len(envelope["payload"]["contracts"]), 5) def test_contract_markdown_csv_and_same_source_payload_are_stable(self) -> None: report = self.make_report(make_tmp()) markdown = mcp_contract_markdown(report) csv_text = mcp_contract_csv(report) same_source = same_source_validation_payload(report, limit=8) self.assertIn("MCP Provider Mais Humana", markdown) self.assertIn("contract_id,kind,platform_id", csv_text) self.assertTrue(same_source["allSameSource"]) self.assertGreater(same_source["validatedCount"], 0) def test_report_model_and_ui_contracts_exist(self) -> None: report_models = contracts_for_kind(McpContractKind.REPORT_MODEL) ui_screens = contracts_for_kind(McpContractKind.UI_SCREEN) self.assertGreater(len(report_models), 100) self.assertGreater(len(ui_screens), 20) self.assertTrue(all(contract.report_model_id for contract in report_models)) def test_cli_mcp_provider_returns_json(self) -> None: root = make_tmp() self.make_repo( root, "business", "business checkout billing entitlements sameSource panelReady responseReady traceId auditId", ) code = main(["mcp-provider", "--ecosystem-root", str(root), "--limit", "3"]) self.assertEqual(code, 0) def test_provider_payload_is_serializable(self) -> None: report = self.make_report(make_tmp()) payload = mcp_provider_payload(report, limit=3) text = json.dumps(payload, ensure_ascii=False) self.assertIn("sourcePayloadHash", text) if __name__ == "__main__": unittest.main()