@ansvar/zimbabwe-law-mcp 1.0.1

package/fixtures/golden-tests.json

@@ -0,0 +1,180 @@
+{
+  "$schema": "./golden-tests.schema.json",
+  "version": "1.0",
+  "mcp_name": "Zimbabwe Law MCP",
+  "description": "Golden contract tests for the Zimbabwe Law MCP — 12 tests covering article retrieval, search, citation, cross-reference, and negative cases",
+  "tests": [
+    {
+      "id": "zw-001",
+      "category": "article_retrieval",
+      "description": "Retrieve Cyber and Data Protection Act 2021, Section 3 — objects and purpose of the Act",
+      "tool": "get_provision",
+      "input": {
+        "law_identifier": "Cyber and Data Protection Act 2021",
+        "article": "3"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "text_contains": ["data protection", "cybersecurity"],
+        "fields_present": ["text", "article_number"],
+        "text_not_empty": true
+      }
+    },
+    {
+      "id": "zw-002",
+      "category": "article_retrieval",
+      "description": "Retrieve Cyber and Data Protection Act 2021, Section 29 — principles of data processing",
+      "tool": "get_provision",
+      "input": {
+        "law_identifier": "Cyber and Data Protection Act 2021",
+        "article": "29"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "text_contains": ["personal data"],
+        "fields_present": ["text", "article_number"],
+        "text_not_empty": true
+      }
+    },
+    {
+      "id": "zw-003",
+      "category": "article_retrieval",
+      "description": "Retrieve Companies and Other Business Entities Act, Section 1 — short title",
+      "tool": "get_provision",
+      "input": {
+        "law_identifier": "Companies and Other Business Entities Act",
+        "article": "1"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "any_result_contains": ["Companies", "Business Entities"],
+        "fields_present": ["text"],
+        "text_not_empty": true
+      }
+    },
+    {
+      "id": "zw-004",
+      "category": "search",
+      "description": "Full-text search for 'personal data' returns Cyber and Data Protection Act provisions",
+      "tool": "search_legislation",
+      "input": {
+        "query": "personal data"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "min_results": 1,
+        "any_result_contains": ["Cyber and Data Protection", "personal data", "data protection"]
+      }
+    },
+    {
+      "id": "zw-005",
+      "category": "search",
+      "description": "Full-text search for 'cybercrime' returns CDPA Part XII provisions on cybercrimes",
+      "tool": "search_legislation",
+      "input": {
+        "query": "cybercrime"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "min_results": 1,
+        "any_result_contains": ["cybercrime", "Cyber and Data Protection", "offence", "computer"]
+      }
+    },
+    {
+      "id": "zw-006",
+      "category": "search",
+      "description": "Full-text search for 'electronic transaction' returns CDPA Part X provisions on e-transactions",
+      "tool": "search_legislation",
+      "input": {
+        "query": "electronic transaction"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "min_results": 1,
+        "any_result_contains": ["electronic transaction", "electronic", "Cyber and Data Protection"]
+      }
+    },
+    {
+      "id": "zw-007",
+      "category": "citation_roundtrip",
+      "description": "Citation for CDPA Section 29 includes ZimLII URL pattern or official reference",
+      "tool": "get_provision",
+      "input": {
+        "law_identifier": "Cyber and Data Protection Act 2021",
+        "article": "29"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "citation_url_pattern": "zimlii\\.org|parlzim\\.gov\\.zw",
+        "text_not_empty": true
+      }
+    },
+    {
+      "id": "zw-008",
+      "category": "citation_roundtrip",
+      "description": "Citation for AIPPA Section 1 includes official identifier",
+      "tool": "get_provision",
+      "input": {
+        "law_identifier": "Access to Information and Protection of Privacy Act",
+        "article": "1"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "fields_present": ["text"],
+        "text_not_empty": true
+      }
+    },
+    {
+      "id": "zw-009",
+      "category": "eu_cross_reference",
+      "description": "CDPA data protection provisions relationship to EU GDPR — Zimbabwe's CDPA was modeled partly on GDPR principles",
+      "tool": "get_provision_eu_basis",
+      "input": {
+        "law_identifier": "Cyber and Data Protection Act 2021"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "any_result_contains": ["GDPR", "General Data Protection Regulation", "2016/679", "data protection"]
+      }
+    },
+    {
+      "id": "zw-010",
+      "category": "eu_cross_reference",
+      "description": "CDPA cybercrime provisions relationship to the Budapest Convention on Cybercrime",
+      "tool": "get_provision_eu_basis",
+      "input": {
+        "law_identifier": "Cyber and Data Protection Act 2021 Part XII"
+      },
+      "assertions": {
+        "result_not_empty": true,
+        "any_result_contains": ["Budapest Convention", "Convention on Cybercrime", "Council of Europe", "cybercrime"]
+      }
+    },
+    {
+      "id": "zw-011",
+      "category": "negative_test",
+      "description": "Non-existent Zimbabwean Act returns graceful error or empty result",
+      "tool": "get_provision",
+      "input": {
+        "law_identifier": "Fictional Wildlife Cybersecurity Act 2099",
+        "article": "1"
+      },
+      "assertions": {
+        "handles_gracefully": true
+      }
+    },
+    {
+      "id": "zw-012",
+      "category": "negative_test",
+      "description": "Malformed section number returns graceful error or empty result",
+      "tool": "get_provision",
+      "input": {
+        "law_identifier": "Cyber and Data Protection Act 2021",
+        "article": "999ZZZ-INVALID"
+      },
+      "assertions": {
+        "handles_gracefully": true
+      }
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@ansvar/zimbabwe-law-mcp",
+  "mcpName": "eu.ansvar/zimbabwe-law-mcp",
+  "version": "1.0.1",
+  "description": "Zimbabwe law database covering data protection, cybersecurity, cybercrime, electronic transactions, and corporate law with full-text search via MCP",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "zimbabwe-law-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:contract": "vitest run __tests__/contract/",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "start": "node dist/index.js",
+    "start:stdio": "node dist/index.js --stdio",
+    "health": "curl -s http://localhost:3000/health | jq .",
+    "build:db": "tsx scripts/build-db.ts",
+    "ingest": "tsx scripts/ingest.ts",
+    "drift:detect": "tsx scripts/drift-detect.ts"
+  },
+  "dependencies": {
+    "@ansvar/mcp-sqlite": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^22.0.0",
+    "@vercel/node": "^5.0.0",
+    "better-sqlite3": "^11.0.0",
+    "eslint": "^9.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ansvar-Systems/zimbabwe-law-mcp.git"
+  },
+  "keywords": [
+    "mcp",
+    "zimbabwe",
+    "law",
+    "data-protection",
+    "cybersecurity",
+    "cybercrime",
+    "CDPA",
+    "POTRAZ",
+    "legal",
+    "compliance"
+  ],
+  "author": "Ansvar Systems <engineering@ansvar.eu>",
+  "homepage": "https://ansvar.eu",
+  "bugs": {
+    "url": "https://github.com/Ansvar-Systems/zimbabwe-law-mcp/issues"
+  },
+  "files": [
+    "dist/",
+    "data/",
+    "fixtures/",
+    "sources.yml",
+    "server.json",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/server.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "eu.ansvar/zimbabwe-law-mcp",
+  "description": "Zimbabwe legislation via MCP — full-text search across statutes and provisions",
+  "repository": {
+    "url": "https://github.com/Ansvar-Systems/zimbabwe-law-mcp",
+    "source": "github"
+  },
+  "homepage": "https://ansvar.eu",
+  "version": "1.0.1",
+  "license": "Apache-2.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@ansvar/zimbabwe-law-mcp",
+      "version": "1.0.0",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}

package/sources.yml

@@ -0,0 +1,64 @@
+# sources.yml
+schema_version: "1.0"
+mcp_name: "Zimbabwe Law MCP"
+jurisdiction: "ZW"
+
+sources:
+  - name: "Zimbabwe Legal Information Institute (ZimLII)"
+    authority: "ZimLII, hosted by AfricanLII / University of Cape Town"
+    official_portal: "https://zimlii.org"
+    canonical_identifier: "N/A (Zimbabwe uses Act title + year as canonical identifier)"
+    retrieval_method: "HTML_SCRAPE"
+    api_documentation: "N/A"
+    update_frequency: "weekly"
+    last_ingested: "2026-02-19"
+    license_or_terms:
+      type: "Free Access"
+      url: "https://zimlii.org/about"
+      summary: "ZimLII provides free, unrestricted access to Zimbabwean legal information; government legislation is public domain under Zimbabwean law"
+    coverage:
+      scope: "All Acts of Parliament including Cyber and Data Protection Act (2021), Postal and Telecommunications Act (Chapter 12:05), Access to Information and Protection of Privacy Act (AIPPA), Criminal Law (Codification and Reform) Act (Chapter 9:23), Companies and Other Business Entities Act, Interception of Communications Act, Electronic Transactions Act; Statutory Instruments; selected case law from the Supreme Court, High Court, and Constitutional Court"
+      limitations: "Historical legislation before independence (1980) may be incomplete; Statutory Instruments may lag behind Gazette publication; not all subsidiary legislation is digitised; case law coverage is selective"
+    languages:
+      - "en"
+
+  - name: "Parliament of Zimbabwe"
+    authority: "Parliament of Zimbabwe"
+    official_portal: "https://www.parlzim.gov.zw"
+    canonical_identifier: "N/A"
+    retrieval_method: "HTML_SCRAPE"
+    api_documentation: "N/A"
+    update_frequency: "on_change"
+    last_ingested: "PENDING_FIRST_INGEST"
+    license_or_terms:
+      type: "Government Public Domain"
+      url: "https://www.parlzim.gov.zw"
+      summary: "Parliamentary publications and Acts are public domain; official source for bills and enacted legislation"
+    coverage:
+      scope: "Bills before Parliament, enacted Acts, parliamentary proceedings, Hansard"
+      limitations: "Website availability can be intermittent; historical Acts may not be fully digitised; no structured data API"
+    languages:
+      - "en"
+
+  - name: "Veritas Zimbabwe (Government Gazette Mirror)"
+    authority: "Veritas Zimbabwe"
+    official_portal: "https://www.veritaszim.net"
+    canonical_identifier: "N/A"
+    retrieval_method: "HTML_SCRAPE"
+    api_documentation: "N/A"
+    update_frequency: "weekly"
+    last_ingested: "PENDING_FIRST_INGEST"
+    license_or_terms:
+      type: "Free Access (Civil Society)"
+      url: "https://www.veritaszim.net"
+      summary: "Veritas publishes Government Gazette content and legislative analysis for public benefit; gazette content is government public domain"
+    coverage:
+      scope: "Government Gazette notices, Statutory Instruments, legislative analysis and commentary, constitutional amendments"
+      limitations: "Not a primary source — mirrors and supplements official publications; coverage may have gaps for older instruments; editorial commentary is separate from legislative text"
+    languages:
+      - "en"
+
+data_freshness:
+  automated_checks: true
+  check_frequency: "weekly"
+  last_verified: "2026-02-19"