@ansvar/zimbabwe-law-mcp 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0] - 2026-XX-XX
+### Added
+- Initial release of Zimbabwe Law MCP
+- `search_legislation` tool for full-text search across all Zimbabwean statutes
+- `get_provision` tool for retrieving specific articles/sections
+- `get_provision_eu_basis` tool for international framework cross-references
+- `validate_citation` tool for legal citation validation
+- `check_statute_currency` tool for checking statute amendment status
+- `list_laws` tool for browsing available legislation
+- Contract tests with 12 golden test cases
+- Drift detection with 6 stable provision anchors
+- Health and version endpoints
+- Vercel deployment (single tier bundled)
+- npm package with stdio transport
+- MCP Registry publishing
+
+[Unreleased]: https://github.com/Ansvar-Systems/zimbabwe-law-mcp/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/Ansvar-Systems/zimbabwe-law-mcp/releases/tag/v1.0.0

package/LICENSE

@@ -0,0 +1,110 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work.
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner.
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work; and
+
+      (d) If the Work includes a "NOTICE" text file, You must include
+          a readable copy of the attribution notices contained
+          within such NOTICE file.
+
+   5. Submission of Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor.
+
+   7. Disclaimer of Warranty.
+
+   8. Limitation of Liability.
+
+   9. Accepting Warranty or Additional Liability.
+
+   Copyright 2024 Ansvar Systems AB
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,151 @@
+# Zimbabwe Law MCP
+
+[![CI](https://github.com/Ansvar-Systems/zimbabwe-law-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Ansvar-Systems/zimbabwe-law-mcp/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/@ansvar/zimbabwe-law-mcp)](https://www.npmjs.com/package/@ansvar/zimbabwe-law-mcp)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![OpenSSF Scorecard](https://img.shields.io/ossf-scorecard/github.com/Ansvar-Systems/zimbabwe-law-mcp)](https://securityscorecards.dev/viewer/?uri=github.com/Ansvar-Systems/zimbabwe-law-mcp)
+[![MCP Registry](https://img.shields.io/badge/MCP_Registry-eu.ansvar%2Fzimbabwe--law--mcp-green)](https://registry.modelcontextprotocol.io/)
+
+A Model Context Protocol (MCP) server providing full-text search and structured access to Zimbabwean legislation, including the Cyber and Data Protection Act (2021), Postal and Telecommunications Act, AIPPA, Criminal Law Act, Companies Act, and more.
+
+> **Note:** Zimbabwe's Cyber and Data Protection Act (2021) is one of Africa's most comprehensive pieces of legislation in this domain, covering data protection, cybersecurity, e-commerce, and cybercrime in a single act. It established the Postal and Telecommunications Regulatory Authority of Zimbabwe (POTRAZ) as the data protection authority.
+
+## Deployment Tier
+
+**SMALL** -- single tier, bundled database.
+
+Zimbabwe has a relatively small legal corpus compared to larger common-law jurisdictions. All legislation and selected case law fit within a single bundled SQLite database.
+
+| Tier | DB Size | Includes | Transport |
+|------|---------|----------|-----------|
+| **Bundled (single tier)** | ~60-100 MB | All Acts of Parliament, Statutory Instruments, selected case law | stdio (npm) |
+
+## Data Sources
+
+| Source | Authority | Method | Update Frequency | License | Coverage |
+|--------|-----------|--------|-----------------|---------|----------|
+| [ZimLII](https://zimlii.org) | ZimLII / AfricanLII | HTML Scrape | Weekly | Free Access | All Acts of Parliament, Statutory Instruments, selected case law |
+| [Parliament of Zimbabwe](https://www.parlzim.gov.zw) | Parliament of Zimbabwe | HTML Scrape | On change | Government Public Domain | Bills, enacted Acts, Hansard |
+| [Veritas Zimbabwe](https://www.veritaszim.net) | Veritas Zimbabwe | HTML Scrape | Weekly | Free Access (Civil Society) | Government Gazette mirrors, legislative analysis |
+
+> Full provenance metadata: [`sources.yml`](./sources.yml)
+
+## Key Legislation Covered
+
+| Act | Identifier | Domain |
+|-----|-----------|--------|
+| **Cyber and Data Protection Act** | Act 5 of 2021 | Data protection, cybersecurity, cybercrime, e-commerce |
+| **Postal and Telecommunications Act** | Chapter 12:05 | Telecommunications regulation, POTRAZ authority |
+| **Access to Information and Protection of Privacy Act (AIPPA)** | Act 5 of 2002 | Access to information, privacy |
+| **Criminal Law (Codification and Reform) Act** | Chapter 9:23 | Criminal offences including computer-related crimes |
+| **Companies and Other Business Entities Act** | Chapter 24:31 | Corporate governance, company formation |
+| **Interception of Communications Act** | Act 6 of 2007 | Lawful interception, communications surveillance |
+| **Electronic Transactions Act** | Act 16 of 2004 | Electronic signatures, electronic contracts |
+
+## Quick Start
+
+### Install from npm
+
+```bash
+npm install -g @ansvar/zimbabwe-law-mcp
+```
+
+### Run via npx (no install)
+
+```bash
+npx @ansvar/zimbabwe-law-mcp
+```
+
+### Configure in Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "zimbabwe-law": {
+      "command": "npx",
+      "args": ["-y", "@ansvar/zimbabwe-law-mcp"]
+    }
+  }
+}
+```
+
+### Build from Source
+
+```bash
+git clone https://github.com/Ansvar-Systems/zimbabwe-law-mcp.git
+cd zimbabwe-law-mcp
+npm install
+npm run build
+npm run build:db      # Build the full database
+npm start             # Start the server
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_provision` | Retrieve a specific section/article from a Zimbabwean Act by law identifier and article number |
+| `search_legislation` | Full-text search across all Zimbabwean legislation |
+| `list_acts` | List all available Acts of Parliament in the database |
+| `get_act_structure` | Get the table of contents / structure of a specific Act |
+| `get_provision_eu_basis` | Cross-reference a Zimbabwean provision with related EU/international instruments (GDPR, Budapest Convention) |
+
+## Contract Tests
+
+This MCP includes 12 golden contract tests covering:
+
+- **Article retrieval** (3 tests): CDPA Section 3, CDPA Section 29, Companies Act Section 1
+- **Search** (3 tests): personal data, cybercrime, electronic transaction
+- **Citation roundtrip** (2 tests): CDPA citation URL, AIPPA citation
+- **Cross-reference** (2 tests): GDPR relationship, Budapest Convention relationship
+- **Negative cases** (2 tests): non-existent Act, malformed section number
+
+Run contract tests:
+
+```bash
+npm run test:contract
+```
+
+## Drift Detection
+
+Golden hashes track 6 stable upstream provisions to detect silent content changes:
+
+- Constitution of Zimbabwe (2013), Section 1
+- Cyber and Data Protection Act 2021, Section 2 (definitions)
+- Cyber and Data Protection Act 2021, Section 3 (objects)
+- AIPPA Section 1
+- Criminal Law Act Section 1
+- Postal and Telecommunications Act Section 1
+
+Run drift detection:
+
+```bash
+npm run drift:detect
+```
+
+## Development
+
+```bash
+npm install          # Install dependencies
+npm run build        # Compile TypeScript
+npm test             # Run all tests
+npm run test:contract  # Run contract tests only
+npm run lint         # Lint source code
+npm run drift:detect # Check for upstream changes
+```
+
+## Security
+
+See [SECURITY.md](.github/SECURITY.md) for vulnerability disclosure policy.
+
+Report data errors: [Open an issue](https://github.com/Ansvar-Systems/zimbabwe-law-mcp/issues/new?template=data-error.md)
+
+## License
+
+Apache-2.0 -- see [LICENSE](LICENSE).
+
+---
+
+Built by [Ansvar Systems](https://ansvar.eu) -- Cybersecurity compliance through AI-powered legal intelligence.