@ansvar/rwandan-law-mcp 1.0.0

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

@@ -0,0 +1,107 @@
+/**
+ * validate_citation — Validate an Rwandan legal citation against the database.
+ */
+import { resolveDocumentId } from '../utils/statute-id.js';
+import { generateResponseMetadata } from '../utils/metadata.js';
+/**
+ * Parse an Rwandan legal citation.
+ * Supports:
+ * - "Section 13 Privacy Act 1988" / "Section 13, Privacy Act 1988"
+ * - "Privacy Act 1988 s 13" / "Privacy Act 1988, s 13"
+ * - "[Act Title Year] s N"
+ * - "s 13" (section only, no document)
+ * - Plain document reference (e.g., "Privacy Act 1988")
+ */
+function parseCitation(citation) {
+    const trimmed = citation.trim();
+    // "Section N <Act>" or "Section N, <Act>"
+    const sectionFirst = trimmed.match(/^Section\s+(\d+[A-Za-z]*(?:\(\d+\))?)\s*[,;]?\s+(.+)$/i);
+    if (sectionFirst) {
+        return { documentRef: sectionFirst[2].trim(), sectionRef: sectionFirst[1] };
+    }
+    // "<Act> s N" or "<Act>, s N" or "<Act> s. N"
+    const sectionLast = trimmed.match(/^(.+?)\s*[,;]?\s+s\.?\s+(\d+[A-Za-z]*(?:\(\d+\))?)$/i);
+    if (sectionLast) {
+        return { documentRef: sectionLast[1].trim(), sectionRef: sectionLast[2] };
+    }
+    // "<Act> Section N" or "<Act>, Section N"
+    const sectionWordLast = trimmed.match(/^(.+?)\s*[,;]?\s+Section\s+(\d+[A-Za-z]*(?:\(\d+\))?)$/i);
+    if (sectionWordLast) {
+        return { documentRef: sectionWordLast[1].trim(), sectionRef: sectionWordLast[2] };
+    }
+    // Just a document reference (no section)
+    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 "Section ${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/src/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/src/tools/validate-eu-compliance.d.ts

@@ -0,0 +1,20 @@
+/**
+ * validate_eu_compliance — Check EU alignment status for an Rwandan 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/src/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/src/tools/validate-eu-compliance.js

@@ -0,0 +1,98 @@
+/**
+ * validate_eu_compliance — Check EU alignment status for an Rwandan 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 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 EU cross-references found for this Rwandan statute. EU alignment checks are only applicable when the statute text explicitly references EU instruments.'],
+            },
+            _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} EU reference(s) have partial alignment status.`);
+    }
+    else {
+        compliance_status = 'unclear';
+        if (unknownCount > 0) {
+            recommendations.push(`${unknownCount} EU reference(s) have unknown alignment 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/src/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/src/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/src/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/src/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/src/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/src/utils/fts-query.d.ts

@@ -0,0 +1,19 @@
+/**
+ * FTS5 query helpers for Rwandan 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/src/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/src/utils/fts-query.js

@@ -0,0 +1,47 @@
+/**
+ * FTS5 query helpers for Rwandan 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/src/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/src/utils/metadata.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Response metadata utilities for Rwandan 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/src/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,CAmBlB"}

package/dist/src/utils/metadata.js

@@ -0,0 +1,22 @@
+/**
+ * Response metadata utilities for Rwandan 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: 'RwandaLII law catalog (AKN + PDF-backed laws) with Official Gazette publication links',
+        jurisdiction: 'RW',
+        disclaimer: 'This database is built from publicly available RwandaLII law pages, including PDF-backed laws, and links to Official Gazette publications. ' +
+            'For legal certainty, verify against the Official Gazette publication.',
+        freshness,
+    };
+}
+//# sourceMappingURL=metadata.js.map

package/dist/src/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,uFAAuF;QACpG,YAAY,EAAE,IAAI;QAClB,UAAU,EACR,6IAA6I;YAC7I,uEAAuE;QACzE,SAAS;KACV,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Statute ID resolution for Rwandan Law MCP.
+ *
+ * Resolves fuzzy document references (titles, IDs) to database document IDs.
+ * Rwandan legislation identifier resolution
+ * (e.g., "Privacy Act 1988", "Corporations Act 2001").
+ */
+import type Database from '@ansvar/mcp-sqlite';
+/**
+ * Resolve a document identifier to a database document ID.
+ * Supports:
+ * - Direct ID match (e.g., "privacy-act-1988")
+ * - Title match (e.g., "Privacy Act 1988", "Privacy Act")
+ * - Short name/abbreviation match (e.g., "SOCI Act")
+ * - Fuzzy title substring match
+ */
+export declare function resolveDocumentId(db: InstanceType<typeof Database>, input: string): string | null;
+//# sourceMappingURL=statute-id.d.ts.map

package/dist/src/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;;;;;;GAMG;AAEH,OAAO,KAAK,QAAQ,MAAM,oBAAoB,CAAC;AAE/C;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,YAAY,CAAC,OAAO,QAAQ,CAAC,EACjC,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAuBf"}

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

@@ -0,0 +1,34 @@
+/**
+ * Statute ID resolution for Rwandan Law MCP.
+ *
+ * Resolves fuzzy document references (titles, IDs) to database document IDs.
+ * Rwandan legislation identifier resolution
+ * (e.g., "Privacy Act 1988", "Corporations Act 2001").
+ */
+/**
+ * Resolve a document identifier to a database document ID.
+ * Supports:
+ * - Direct ID match (e.g., "privacy-act-1988")
+ * - Title match (e.g., "Privacy Act 1988", "Privacy Act")
+ * - Short name/abbreviation match (e.g., "SOCI Act")
+ * - Fuzzy title substring match
+ */
+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;
+    // Title/short_name exact 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/src/utils/statute-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statute-id.js","sourceRoot":"","sources":["../../../src/utils/statute-id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;GAOG;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,+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/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@ansvar/rwandan-law-mcp",
+  "version": "1.0.0",
+  "mcpName": "eu.ansvar/rwandan-law-mcp",
+  "description": "Rwandan law database covering data protection, cybersecurity, e-commerce, and criminal law provisions via Model Context Protocol",
+  "author": "Ansvar Systems <hello@ansvar.eu>",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Ansvar-Systems/Rwandan-law-mcp.git"
+  },
+  "homepage": "https://ansvar.eu",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "rwandan-law",
+    "data-protection",
+    "cybersecurity",
+    "legislation",
+    "legal",
+    "compliance",
+    "ansvar"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "rwandan-law-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "data/database.db",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:db": "node --import tsx scripts/build-db.ts",
+    "dev": "node --import tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "ingest": "node --import tsx scripts/ingest.ts",
+    "test:contract": "vitest run __tests__/contract/",
+    "drift:detect": "node --import tsx scripts/drift-detect.ts",
+    "validate": "npm run lint && npm test && npm run test:contract",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "postinstall": "test -d dist || npm run build || true"
+  },
+  "dependencies": {
+    "@ansvar/mcp-sqlite": "^1.0.3",
+    "@modelcontextprotocol/sdk": "^1.25.3"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.15.29",
+    "@vercel/node": "^5.6.4",
+    "better-sqlite3": "^12.6.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "overrides": {
+    "path-to-regexp": "^8.0.0",
+    "undici": "^7.0.0",
+    "ajv": "^8.18.0"
+  }
+}

package/server.json

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