@ansvar/zimbabwe-law-mcp 1.0.1

package/dist/tools/validate-citation.js

@@ -0,0 +1,118 @@
+/**
+ * validate_citation — Validate a Zimbabwean legal citation against the database.
+ *
+ * Supports citation formats:
+ * - "Section N, [Act Title Year]" (e.g., "Section 29, Cyber and Data Protection Act 2021")
+ * - "s N" shorthand (e.g., "s 29 CDPA")
+ * - "Chapter N:NN" (e.g., "Chapter 9:23")
+ * - "[Act Title], Section N"
+ */
+import { resolveDocumentId } from '../utils/statute-id.js';
+import { generateResponseMetadata } from '../utils/metadata.js';
+/**
+ * Parse a Zimbabwean legal citation.
+ * Supports:
+ * - "Section N, Act Title Year" / "Section N Act Title"
+ * - "s N Act Title"
+ * - "Act Title, Section N" / "Act Title Section N"
+ * - "Chapter N:NN"
+ * - Just a document reference
+ */
+function parseCitation(citation) {
+    const trimmed = citation.trim();
+    // "Section N, Act Title" or "Section N Act Title"
+    const sectionFirst = trimmed.match(/^(?:Section|s\.?)\s+(\d+[A-Za-z]*)\s*[,;]?\s+(.+)$/i);
+    if (sectionFirst) {
+        return { documentRef: sectionFirst[2].trim(), sectionRef: sectionFirst[1] };
+    }
+    // "Act Title, Section N" or "Act Title Section N"
+    const sectionLast = trimmed.match(/^(.+?)[,;]?\s+(?:Section|s\.?)\s+(\d+[A-Za-z]*)$/i);
+    if (sectionLast) {
+        return { documentRef: sectionLast[1].trim(), sectionRef: sectionLast[2] };
+    }
+    // "Chapter N:NN, Section N"
+    const chapterWithSection = trimmed.match(/^(Chapter\s+\d+:\d+)\s*[,;]?\s*(?:Section|s\.?)\s+(\d+[A-Za-z]*)$/i);
+    if (chapterWithSection) {
+        return { documentRef: chapterWithSection[1], sectionRef: chapterWithSection[2] };
+    }
+    // "Chapter N:NN" alone
+    const chapterOnly = trimmed.match(/^Chapter\s+(\d+:\d+)$/i);
+    if (chapterOnly) {
+        return { documentRef: trimmed };
+    }
+    // Just a document reference
+    return { documentRef: trimmed };
+}
+export async function validateCitationTool(db, input) {
+    const warnings = [];
+    const parsed = parseCitation(input.citation);
+    if (!parsed) {
+        return {
+            results: {
+                valid: false,
+                citation: input.citation,
+                warnings: ['Could not parse citation format'],
+            },
+            _metadata: generateResponseMetadata(db),
+        };
+    }
+    const docId = resolveDocumentId(db, parsed.documentRef);
+    if (!docId) {
+        return {
+            results: {
+                valid: false,
+                citation: input.citation,
+                warnings: [`Document not found: "${parsed.documentRef}"`],
+            },
+            _metadata: generateResponseMetadata(db),
+        };
+    }
+    const doc = db.prepare('SELECT id, title, status FROM legal_documents WHERE id = ?').get(docId);
+    if (doc.status === 'repealed') {
+        warnings.push(`WARNING: This statute has been repealed.`);
+    }
+    else if (doc.status === 'amended') {
+        warnings.push(`Note: This statute has been amended. Verify you are referencing the current version.`);
+    }
+    if (parsed.sectionRef) {
+        const provision = db.prepare("SELECT provision_ref FROM legal_provisions WHERE document_id = ? AND (provision_ref = ? OR provision_ref = ? OR section = ?)").get(docId, parsed.sectionRef, `s${parsed.sectionRef}`, parsed.sectionRef);
+        if (!provision) {
+            return {
+                results: {
+                    valid: false,
+                    citation: input.citation,
+                    document_id: docId,
+                    document_title: doc.title,
+                    warnings: [...warnings, `Provision "${parsed.sectionRef}" not found in ${doc.title}`],
+                },
+                _metadata: generateResponseMetadata(db),
+            };
+        }
+        return {
+            results: {
+                valid: true,
+                citation: input.citation,
+                normalized: `Section ${parsed.sectionRef}, ${doc.title}`,
+                document_id: docId,
+                document_title: doc.title,
+                provision_ref: provision.provision_ref,
+                status: doc.status,
+                warnings,
+            },
+            _metadata: generateResponseMetadata(db),
+        };
+    }
+    return {
+        results: {
+            valid: true,
+            citation: input.citation,
+            normalized: doc.title,
+            document_id: docId,
+            document_title: doc.title,
+            status: doc.status,
+            warnings,
+        },
+        _metadata: generateResponseMetadata(db),
+    };
+}
+//# sourceMappingURL=validate-citation.js.map

package/dist/tools/validate-citation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-citation.js","sourceRoot":"","sources":["../../src/tools/validate-citation.ts"],"names":[],"mappings":"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"}

package/dist/tools/validate-eu-compliance.d.ts

@@ -0,0 +1,20 @@
+/**
+ * validate_eu_compliance — Check international/EU alignment status for a Zimbabwean statute.
+ */
+import type Database from '@ansvar/mcp-sqlite';
+import { type ToolResponse } from '../utils/metadata.js';
+export interface ValidateEUComplianceInput {
+    document_id: string;
+    provision_ref?: string;
+    eu_document_id?: string;
+}
+export interface EUComplianceResult {
+    document_id: string;
+    document_title: string;
+    compliance_status: 'compliant' | 'partial' | 'unclear' | 'not_applicable';
+    eu_references_found: number;
+    warnings: string[];
+    recommendations: string[];
+}
+export declare function validateEUCompliance(db: InstanceType<typeof Database>, input: ValidateEUComplianceInput): Promise<ToolResponse<EUComplianceResult>>;
+//# sourceMappingURL=validate-eu-compliance.d.ts.map

package/dist/tools/validate-eu-compliance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-eu-compliance.d.ts","sourceRoot":"","sources":["../../src/tools/validate-eu-compliance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,QAAQ,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEnF,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,gBAAgB,CAAC;IAC1E,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,YAAY,CAAC,OAAO,QAAQ,CAAC,EACjC,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAuG3C"}

package/dist/tools/validate-eu-compliance.js

@@ -0,0 +1,98 @@
+/**
+ * validate_eu_compliance — Check international/EU alignment status for a Zimbabwean statute.
+ */
+import { resolveDocumentId } from '../utils/statute-id.js';
+import { generateResponseMetadata } from '../utils/metadata.js';
+export async function validateEUCompliance(db, input) {
+    const resolvedId = resolveDocumentId(db, input.document_id);
+    if (!resolvedId) {
+        return {
+            results: {
+                document_id: input.document_id,
+                document_title: 'Unknown',
+                compliance_status: 'not_applicable',
+                eu_references_found: 0,
+                warnings: [`Document not found: "${input.document_id}"`],
+                recommendations: [],
+            },
+            _metadata: generateResponseMetadata(db),
+        };
+    }
+    const doc = db.prepare('SELECT id, title, status FROM legal_documents WHERE id = ?').get(resolvedId);
+    const warnings = [];
+    const recommendations = [];
+    // Check if EU reference tables exist
+    let euRefCount = 0;
+    try {
+        let sql = 'SELECT COUNT(*) as count FROM eu_references WHERE document_id = ?';
+        const params = [resolvedId];
+        if (input.eu_document_id) {
+            sql += ' AND eu_document_id = ?';
+            params.push(input.eu_document_id);
+        }
+        const row = db.prepare(sql).get(...params);
+        euRefCount = row.count;
+    }
+    catch {
+        return {
+            results: {
+                document_id: resolvedId,
+                document_title: doc.title,
+                compliance_status: 'not_applicable',
+                eu_references_found: 0,
+                warnings: ['EU/international references not available in this database tier'],
+                recommendations: [],
+            },
+            _metadata: generateResponseMetadata(db),
+        };
+    }
+    if (euRefCount === 0) {
+        return {
+            results: {
+                document_id: resolvedId,
+                document_title: doc.title,
+                compliance_status: 'not_applicable',
+                eu_references_found: 0,
+                warnings: [],
+                recommendations: ['No international cross-references found for this statute. This may be a purely domestic law.'],
+            },
+            _metadata: generateResponseMetadata(db),
+        };
+    }
+    if (doc.status === 'repealed') {
+        warnings.push('This statute has been repealed.');
+        recommendations.push('Check for replacement legislation.');
+    }
+    // Check implementation status
+    const statuses = db.prepare('SELECT implementation_status, COUNT(*) as count FROM eu_references WHERE document_id = ? GROUP BY implementation_status').all(resolvedId);
+    const statusMap = new Map(statuses.map(s => [s.implementation_status, s.count]));
+    const completeCount = statusMap.get('complete') ?? 0;
+    const partialCount = statusMap.get('partial') ?? 0;
+    const unknownCount = statusMap.get('unknown') ?? 0;
+    let compliance_status;
+    if (completeCount > 0 && partialCount === 0 && unknownCount === 0) {
+        compliance_status = 'compliant';
+    }
+    else if (partialCount > 0) {
+        compliance_status = 'partial';
+        warnings.push(`${partialCount} international reference(s) have partial implementation status.`);
+    }
+    else {
+        compliance_status = 'unclear';
+        if (unknownCount > 0) {
+            recommendations.push(`${unknownCount} international reference(s) have unknown implementation status. Manual review recommended.`);
+        }
+    }
+    return {
+        results: {
+            document_id: resolvedId,
+            document_title: doc.title,
+            compliance_status,
+            eu_references_found: euRefCount,
+            warnings,
+            recommendations,
+        },
+        _metadata: generateResponseMetadata(db),
+    };
+}
+//# sourceMappingURL=validate-eu-compliance.js.map

package/dist/tools/validate-eu-compliance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-eu-compliance.js","sourceRoot":"","sources":["../../src/tools/validate-eu-compliance.ts"],"names":[],"mappings":"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"}

package/dist/utils/as-of-date.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Date normalization for temporal queries.
+ */
+/**
+ * Normalize an as-of date string to ISO 8601 format.
+ * Returns null if the input is not a valid date.
+ */
+export declare function normalizeAsOfDate(input?: string): string | null;
+//# sourceMappingURL=as-of-date.d.ts.map

package/dist/utils/as-of-date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"as-of-date.d.ts","sourceRoot":"","sources":["../../src/utils/as-of-date.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkB/D"}

package/dist/utils/as-of-date.js

@@ -0,0 +1,25 @@
+/**
+ * Date normalization for temporal queries.
+ */
+/**
+ * Normalize an as-of date string to ISO 8601 format.
+ * Returns null if the input is not a valid date.
+ */
+export function normalizeAsOfDate(input) {
+    if (!input || input.trim().length === 0)
+        return null;
+    const trimmed = input.trim();
+    // Already ISO 8601
+    if (/^\d{4}-\d{2}-\d{2}$/.test(trimmed)) {
+        const date = new Date(trimmed);
+        if (!isNaN(date.getTime()))
+            return trimmed;
+    }
+    // Try parsing as a general date
+    const date = new Date(trimmed);
+    if (!isNaN(date.getTime())) {
+        return date.toISOString().slice(0, 10);
+    }
+    return null;
+}
+//# sourceMappingURL=as-of-date.js.map

package/dist/utils/as-of-date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"as-of-date.js","sourceRoot":"","sources":["../../src/utils/as-of-date.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAErD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,mBAAmB;IACnB,IAAI,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAAE,OAAO,OAAO,CAAC;IAC7C,CAAC;IAED,gCAAgC;IAChC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/fts-query.d.ts

@@ -0,0 +1,19 @@
+/**
+ * FTS5 query helpers for Zimbabwe Law MCP.
+ *
+ * Handles query sanitization and variant generation for SQLite FTS5.
+ */
+/**
+ * Sanitize user input for safe FTS5 queries.
+ * Removes characters that have special meaning in FTS5 syntax.
+ */
+export declare function sanitizeFtsInput(input: string): string;
+/**
+ * Build FTS5 query variants for a search term.
+ * Returns variants in order of specificity (most specific first):
+ * 1. Exact phrase match
+ * 2. All terms required (AND)
+ * 3. Prefix match on last term
+ */
+export declare function buildFtsQueryVariants(sanitized: string): string[];
+//# sourceMappingURL=fts-query.d.ts.map

package/dist/utils/fts-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts-query.d.ts","sourceRoot":"","sources":["../../src/utils/fts-query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CA2BjE"}

package/dist/utils/fts-query.js

@@ -0,0 +1,47 @@
+/**
+ * FTS5 query helpers for Zimbabwe Law MCP.
+ *
+ * Handles query sanitization and variant generation for SQLite FTS5.
+ */
+/**
+ * Sanitize user input for safe FTS5 queries.
+ * Removes characters that have special meaning in FTS5 syntax.
+ */
+export function sanitizeFtsInput(input) {
+    return input
+        .replace(/['"(){}[\]^~*:]/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * Build FTS5 query variants for a search term.
+ * Returns variants in order of specificity (most specific first):
+ * 1. Exact phrase match
+ * 2. All terms required (AND)
+ * 3. Prefix match on last term
+ */
+export function buildFtsQueryVariants(sanitized) {
+    if (!sanitized || sanitized.trim().length === 0) {
+        return [];
+    }
+    const terms = sanitized.split(/\s+/).filter(t => t.length > 0);
+    if (terms.length === 0)
+        return [];
+    const variants = [];
+    // Exact phrase
+    if (terms.length > 1) {
+        variants.push(`"${terms.join(' ')}"`);
+    }
+    // AND query
+    variants.push(terms.join(' AND '));
+    // Prefix match on last term (for autocomplete-like behavior)
+    if (terms.length === 1 && terms[0].length >= 3) {
+        variants.push(`${terms[0]}*`);
+    }
+    else if (terms.length > 1) {
+        const prefix = [...terms.slice(0, -1), `${terms[terms.length - 1]}*`];
+        variants.push(prefix.join(' AND '));
+    }
+    return variants;
+}
+//# sourceMappingURL=fts-query.js.map

package/dist/utils/fts-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts-query.js","sourceRoot":"","sources":["../../src/utils/fts-query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,KAAK;SACT,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC;SAChC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,eAAe;IACf,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,YAAY;IACZ,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAEnC,6DAA6D;IAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;SAAM,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACtE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/utils/metadata.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Response metadata utilities for Zimbabwe Law MCP.
+ */
+import type Database from '@ansvar/mcp-sqlite';
+export interface ResponseMetadata {
+    data_source: string;
+    jurisdiction: string;
+    disclaimer: string;
+    freshness?: string;
+}
+export interface ToolResponse<T> {
+    results: T;
+    _metadata: ResponseMetadata;
+}
+export declare function generateResponseMetadata(db: InstanceType<typeof Database>): ResponseMetadata;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/utils/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/utils/metadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,QAAQ,MAAM,oBAAoB,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,YAAY,CAAC,OAAO,QAAQ,CAAC,GAChC,gBAAgB,CAoBlB"}

package/dist/utils/metadata.js

@@ -0,0 +1,23 @@
+/**
+ * Response metadata utilities for Zimbabwe Law MCP.
+ */
+export function generateResponseMetadata(db) {
+    let freshness;
+    try {
+        const row = db.prepare("SELECT value FROM db_metadata WHERE key = 'built_at'").get();
+        if (row)
+            freshness = row.value;
+    }
+    catch {
+        // Ignore
+    }
+    return {
+        data_source: 'ZimLII (zimlii.org) — Zimbabwe Legal Information Institute, hosted by AfricanLII',
+        jurisdiction: 'ZW',
+        disclaimer: 'This data is sourced from ZimLII under free access principles. ' +
+            'Government legislation is public domain under Zimbabwean law. ' +
+            'Always verify with the official Zimbabwe Government Gazette or Parliament of Zimbabwe portal.',
+        freshness,
+    };
+}
+//# sourceMappingURL=metadata.js.map

package/dist/utils/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/utils/metadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,MAAM,UAAU,wBAAwB,CACtC,EAAiC;IAEjC,IAAI,SAA6B,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CACpB,sDAAsD,CACvD,CAAC,GAAG,EAAmC,CAAC;QACzC,IAAI,GAAG;YAAE,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IAED,OAAO;QACL,WAAW,EAAE,kFAAkF;QAC/F,YAAY,EAAE,IAAI;QAClB,UAAU,EACR,iEAAiE;YACjE,gEAAgE;YAChE,+FAA+F;QACjG,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/utils/statute-id.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Statute ID resolution for Zimbabwe Law MCP.
+ *
+ * Resolves fuzzy document references (titles, chapter numbers) to database document IDs.
+ */
+import type Database from '@ansvar/mcp-sqlite';
+/**
+ * Resolve a document identifier to a database document ID.
+ * Supports:
+ * - Direct ID match (e.g., "zw-cyber-data-protection-2021")
+ * - Chapter number match (e.g., "Chapter 9:23", "9:23")
+ * - Title substring match (e.g., "Cyber and Data Protection", "CDPA")
+ */
+export declare function resolveDocumentId(db: InstanceType<typeof Database>, input: string): string | null;
+//# sourceMappingURL=statute-id.d.ts.map

package/dist/utils/statute-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statute-id.d.ts","sourceRoot":"","sources":["../../src/utils/statute-id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,oBAAoB,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,YAAY,CAAC,OAAO,QAAQ,CAAC,EACjC,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAiCf"}

package/dist/utils/statute-id.js

@@ -0,0 +1,39 @@
+/**
+ * Statute ID resolution for Zimbabwe Law MCP.
+ *
+ * Resolves fuzzy document references (titles, chapter numbers) to database document IDs.
+ */
+/**
+ * Resolve a document identifier to a database document ID.
+ * Supports:
+ * - Direct ID match (e.g., "zw-cyber-data-protection-2021")
+ * - Chapter number match (e.g., "Chapter 9:23", "9:23")
+ * - Title substring match (e.g., "Cyber and Data Protection", "CDPA")
+ */
+export function resolveDocumentId(db, input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        return null;
+    // Direct ID match
+    const directMatch = db.prepare('SELECT id FROM legal_documents WHERE id = ?').get(trimmed);
+    if (directMatch)
+        return directMatch.id;
+    // Chapter number match (e.g., "Chapter 9:23" or just "9:23")
+    const chapterMatch = trimmed.match(/(?:Chapter\s+)?(\d+:\d+)/i);
+    if (chapterMatch) {
+        const chapterNum = chapterMatch[1];
+        const chResult = db.prepare("SELECT id FROM legal_documents WHERE short_name LIKE ? OR title LIKE ? LIMIT 1").get(`%${chapterNum}%`, `%${chapterNum}%`);
+        if (chResult)
+            return chResult.id;
+    }
+    // Title/short_name fuzzy match
+    const titleResult = db.prepare("SELECT id FROM legal_documents WHERE title LIKE ? OR short_name LIKE ? OR title_en LIKE ? LIMIT 1").get(`%${trimmed}%`, `%${trimmed}%`, `%${trimmed}%`);
+    if (titleResult)
+        return titleResult.id;
+    // Case-insensitive fallback
+    const lowerResult = db.prepare("SELECT id FROM legal_documents WHERE LOWER(title) LIKE LOWER(?) OR LOWER(short_name) LIKE LOWER(?) OR LOWER(title_en) LIKE LOWER(?) LIMIT 1").get(`%${trimmed}%`, `%${trimmed}%`, `%${trimmed}%`);
+    if (lowerResult)
+        return lowerResult.id;
+    return null;
+}
+//# sourceMappingURL=statute-id.js.map

package/dist/utils/statute-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statute-id.js","sourceRoot":"","sources":["../../src/utils/statute-id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAiC,EACjC,KAAa;IAEb,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,kBAAkB;IAClB,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAC5B,6CAA6C,CAC9C,CAAC,GAAG,CAAC,OAAO,CAA+B,CAAC;IAC7C,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC,EAAE,CAAC;IAEvC,6DAA6D;IAC7D,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAChE,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CACzB,gFAAgF,CACjF,CAAC,GAAG,CAAC,IAAI,UAAU,GAAG,EAAE,IAAI,UAAU,GAAG,CAA+B,CAAC;QAC1E,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC,EAAE,CAAC;IACnC,CAAC;IAED,+BAA+B;IAC/B,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAC5B,mGAAmG,CACpG,CAAC,GAAG,CAAC,IAAI,OAAO,GAAG,EAAE,IAAI,OAAO,GAAG,EAAE,IAAI,OAAO,GAAG,CAA+B,CAAC;IACpF,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC,EAAE,CAAC;IAEvC,4BAA4B;IAC5B,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAC5B,6IAA6I,CAC9I,CAAC,GAAG,CAAC,IAAI,OAAO,GAAG,EAAE,IAAI,OAAO,GAAG,EAAE,IAAI,OAAO,GAAG,CAA+B,CAAC;IACpF,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC,EAAE,CAAC;IAEvC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/fixtures/golden-hashes.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "./golden-hashes.schema.json",
+  "version": "1.0",
+  "mcp_name": "Zimbabwe Law MCP",
+  "jurisdiction": "ZW",
+  "provisions": [
+    {
+      "id": "zw-hash-001",
+      "description": "Constitution of Zimbabwe (2013), Section 1 — Republic of Zimbabwe (stable constitutional anchor)",
+      "upstream_url": "https://zimlii.org/zw/legislation/act/2013/amendment-no-20/eng",
+      "selector_hint": "Section 1",
+      "expected_sha256": "COMPUTE_ON_FIRST_INGEST",
+      "expected_snippet": "Republic of Zimbabwe"
+    },
+    {
+      "id": "zw-hash-002",
+      "description": "Cyber and Data Protection Act 2021, Section 2 — interpretation and definitions",
+      "upstream_url": "https://zimlii.org/zw/legislation/act/2021/5/eng",
+      "selector_hint": "Section 2",
+      "expected_sha256": "COMPUTE_ON_FIRST_INGEST",
+      "expected_snippet": "interpretation"
+    },
+    {
+      "id": "zw-hash-003",
+      "description": "Cyber and Data Protection Act 2021, Section 3 — objects of Act (data protection and cybersecurity purposes)",
+      "upstream_url": "https://zimlii.org/zw/legislation/act/2021/5/eng",
+      "selector_hint": "Section 3",
+      "expected_sha256": "COMPUTE_ON_FIRST_INGEST",
+      "expected_snippet": "objects"
+    },
+    {
+      "id": "zw-hash-004",
+      "description": "Access to Information and Protection of Privacy Act (AIPPA), Section 1 — short title",
+      "upstream_url": "https://zimlii.org/zw/legislation/act/2002/5/eng",
+      "selector_hint": "Section 1",
+      "expected_sha256": "COMPUTE_ON_FIRST_INGEST",
+      "expected_snippet": "Access to Information and Protection of Privacy"
+    },
+    {
+      "id": "zw-hash-005",
+      "description": "Criminal Law (Codification and Reform) Act (Chapter 9:23), Section 1 — short title and commencement",
+      "upstream_url": "https://zimlii.org/zw/legislation/act/2004/23/eng",
+      "selector_hint": "Section 1",
+      "expected_sha256": "COMPUTE_ON_FIRST_INGEST",
+      "expected_snippet": "Criminal Law"
+    },
+    {
+      "id": "zw-hash-006",
+      "description": "Postal and Telecommunications Act (Chapter 12:05), Section 1 — short title",
+      "upstream_url": "https://zimlii.org/zw/legislation/act/2000/4/eng",
+      "selector_hint": "Section 1",
+      "expected_sha256": "COMPUTE_ON_FIRST_INGEST",
+      "expected_snippet": "Postal and Telecommunications"
+    }
+  ]
+}