@ansvar/rwandan-law-mcp 1.0.0

package/dist/scripts/build-db.js

@@ -0,0 +1,375 @@
+#!/usr/bin/env tsx
+/**
+ * Database builder for Rwandan Law MCP server.
+ *
+ * Builds the SQLite database from seed JSON files in data/seed/.
+ * Follows the Switzerland Law MCP reference pattern.
+ *
+ * Usage: npm run build:db
+ */
+import Database from 'better-sqlite3';
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const SEED_DIR = path.resolve(__dirname, '../data/seed');
+const DB_PATH = path.resolve(__dirname, '../data/database.db');
+// Database schema
+const SCHEMA = `
+-- Legal documents (statutes)
+CREATE TABLE legal_documents (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL CHECK(type IN ('statute', 'bill', 'case_law')),
+  title TEXT NOT NULL,
+  title_en TEXT,
+  short_name TEXT,
+  status TEXT NOT NULL DEFAULT 'in_force'
+    CHECK(status IN ('in_force', 'amended', 'repealed', 'not_yet_in_force')),
+  issued_date TEXT,
+  in_force_date TEXT,
+  url TEXT,
+  description TEXT,
+  last_updated TEXT DEFAULT (datetime('now'))
+);
+
+-- Individual provisions from statutes
+CREATE TABLE legal_provisions (
+  id INTEGER PRIMARY KEY,
+  document_id TEXT NOT NULL REFERENCES legal_documents(id),
+  provision_ref TEXT NOT NULL,
+  chapter TEXT,
+  section TEXT NOT NULL,
+  title TEXT,
+  content TEXT NOT NULL,
+  metadata TEXT,
+  UNIQUE(document_id, provision_ref)
+);
+
+CREATE INDEX idx_provisions_doc ON legal_provisions(document_id);
+CREATE INDEX idx_provisions_chapter ON legal_provisions(document_id, chapter);
+
+-- FTS5 for provision search
+CREATE VIRTUAL TABLE provisions_fts USING fts5(
+  content, title,
+  content='legal_provisions',
+  content_rowid='id',
+  tokenize='unicode61'
+);
+
+CREATE TRIGGER provisions_ai AFTER INSERT ON legal_provisions BEGIN
+  INSERT INTO provisions_fts(rowid, content, title)
+  VALUES (new.id, new.content, new.title);
+END;
+
+CREATE TRIGGER provisions_ad AFTER DELETE ON legal_provisions BEGIN
+  INSERT INTO provisions_fts(provisions_fts, rowid, content, title)
+  VALUES ('delete', old.id, old.content, old.title);
+END;
+
+CREATE TRIGGER provisions_au AFTER UPDATE ON legal_provisions BEGIN
+  INSERT INTO provisions_fts(provisions_fts, rowid, content, title)
+  VALUES ('delete', old.id, old.content, old.title);
+  INSERT INTO provisions_fts(rowid, content, title)
+  VALUES (new.id, new.content, new.title);
+END;
+
+-- Cross-references between provisions/documents
+CREATE TABLE cross_references (
+  id INTEGER PRIMARY KEY,
+  source_document_id TEXT NOT NULL REFERENCES legal_documents(id),
+  source_provision_ref TEXT,
+  target_document_id TEXT NOT NULL REFERENCES legal_documents(id),
+  target_provision_ref TEXT,
+  ref_type TEXT NOT NULL DEFAULT 'references'
+    CHECK(ref_type IN ('references', 'amended_by', 'implements', 'see_also'))
+);
+
+CREATE INDEX idx_xref_source ON cross_references(source_document_id);
+CREATE INDEX idx_xref_target ON cross_references(target_document_id);
+
+-- Legal term definitions
+CREATE TABLE definitions (
+  id INTEGER PRIMARY KEY,
+  document_id TEXT NOT NULL REFERENCES legal_documents(id),
+  term TEXT NOT NULL,
+  term_en TEXT,
+  definition TEXT NOT NULL,
+  source_provision TEXT,
+  UNIQUE(document_id, term)
+);
+
+-- FTS5 for definition search
+CREATE VIRTUAL TABLE definitions_fts USING fts5(
+  term, definition,
+  content='definitions',
+  content_rowid='id',
+  tokenize='unicode61'
+);
+
+CREATE TRIGGER definitions_ai AFTER INSERT ON definitions BEGIN
+  INSERT INTO definitions_fts(rowid, term, definition)
+  VALUES (new.id, new.term, new.definition);
+END;
+
+CREATE TRIGGER definitions_ad AFTER DELETE ON definitions BEGIN
+  INSERT INTO definitions_fts(definitions_fts, rowid, term, definition)
+  VALUES ('delete', old.id, old.term, old.definition);
+END;
+
+CREATE TRIGGER definitions_au AFTER UPDATE ON definitions BEGIN
+  INSERT INTO definitions_fts(definitions_fts, rowid, term, definition)
+  VALUES ('delete', old.id, old.term, old.definition);
+  INSERT INTO definitions_fts(rowid, term, definition)
+  VALUES (new.id, new.term, new.definition);
+END;
+
+-- EU Documents (directives and regulations)
+CREATE TABLE eu_documents (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL CHECK (type IN ('directive', 'regulation')),
+  year INTEGER NOT NULL CHECK (year >= 1957 AND year <= 2100),
+  number INTEGER NOT NULL CHECK (number > 0),
+  community TEXT CHECK (community IN ('EU', 'EC', 'EEC', 'Euratom')),
+  celex_number TEXT,
+  title TEXT,
+  title_en TEXT,
+  short_name TEXT,
+  adoption_date TEXT,
+  entry_into_force_date TEXT,
+  in_force BOOLEAN DEFAULT 1,
+  amended_by TEXT,
+  repeals TEXT,
+  url_eur_lex TEXT,
+  description TEXT,
+  last_updated TEXT DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX idx_eu_documents_type_year ON eu_documents(type, year DESC);
+
+-- EU References (links national provisions to EU documents)
+CREATE TABLE eu_references (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  source_type TEXT NOT NULL CHECK (source_type IN ('provision', 'document', 'case_law')),
+  source_id TEXT NOT NULL,
+  document_id TEXT NOT NULL REFERENCES legal_documents(id),
+  provision_id INTEGER REFERENCES legal_provisions(id),
+  eu_document_id TEXT NOT NULL REFERENCES eu_documents(id),
+  eu_article TEXT,
+  reference_type TEXT NOT NULL CHECK (reference_type IN (
+    'implements', 'supplements', 'applies', 'references', 'complies_with',
+    'derogates_from', 'amended_by', 'repealed_by', 'cites_article'
+  )),
+  reference_context TEXT,
+  full_citation TEXT,
+  is_primary_implementation BOOLEAN DEFAULT 0,
+  implementation_status TEXT CHECK (implementation_status IN ('complete', 'partial', 'pending', 'unknown')),
+  created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+  last_verified TEXT,
+  UNIQUE(source_id, eu_document_id, eu_article)
+);
+
+CREATE INDEX idx_eu_references_document ON eu_references(document_id, eu_document_id);
+CREATE INDEX idx_eu_references_eu_document ON eu_references(eu_document_id, document_id);
+CREATE INDEX idx_eu_references_provision ON eu_references(provision_id, eu_document_id);
+
+-- Build metadata
+CREATE TABLE db_metadata (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+`;
+function normalizeWhitespace(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}
+function dedupeProvisions(provisions) {
+    const byRef = new Map();
+    for (const prov of provisions) {
+        const ref = prov.provision_ref.trim();
+        const existing = byRef.get(ref);
+        if (!existing || normalizeWhitespace(prov.content).length > normalizeWhitespace(existing.content).length) {
+            byRef.set(ref, { ...prov, provision_ref: ref });
+        }
+    }
+    return Array.from(byRef.values());
+}
+function extractEuReferences(text) {
+    if (!text || text.trim().length === 0)
+        return [];
+    const refs = [];
+    const seen = new Set();
+    const patterns = [
+        /\b(Regulation|Directive)\s*\((EU|EC|EEC|Euratom)\)\s*(?:No\.?\s*)?(\d{2,4})\/(\d{1,4})\b/gi,
+        /\b(Regulation|Directive)\s*(?:No\.?\s*)?(\d{2,4})\/(\d{1,4})\/(EU|EC|EEC|Euratom)\b/gi,
+        /\b(Regulation|Directive)\s*(?:No\.?\s*)?(\d{2,4})\/(\d{1,4})\b/gi,
+    ];
+    for (const pattern of patterns) {
+        let match;
+        while ((match = pattern.exec(text)) !== null) {
+            const type = match[1].toLowerCase();
+            let rawYear, rawNumber, communityRaw;
+            if (pattern === patterns[0]) {
+                communityRaw = match[2];
+                rawYear = match[3];
+                rawNumber = match[4];
+            }
+            else if (pattern === patterns[1]) {
+                rawYear = match[2];
+                rawNumber = match[3];
+                communityRaw = match[4];
+            }
+            else {
+                rawYear = match[2];
+                rawNumber = match[3];
+                communityRaw = undefined;
+            }
+            const parsedYear = Number.parseInt(rawYear, 10);
+            const year = rawYear.length === 2 ? (parsedYear >= 50 ? 1900 + parsedYear : 2000 + parsedYear) : parsedYear;
+            const number = Number.parseInt(rawNumber, 10);
+            if (year <= 0 || Number.isNaN(number) || number <= 0)
+                continue;
+            const community = (communityRaw?.toUpperCase() ?? 'EU');
+            const euDocumentId = `${type}:${year}/${number}`;
+            const start = Math.max(0, match.index - 120);
+            const end = Math.min(text.length, match.index + match[0].length + 120);
+            const referenceContext = text.slice(start, end).replace(/\s+/g, ' ').trim();
+            const euArticle = referenceContext.match(/\bArticle\s+(\d+[A-Za-z]?(?:\(\d+\))?)/i)?.[1] ?? null;
+            const referenceType = /\b(implement|align|transpos|equivalent)\b/i.test(referenceContext) ? 'implements' : 'references';
+            const dedupeKey = `${euDocumentId}:${euArticle ?? ''}`;
+            if (seen.has(dedupeKey))
+                continue;
+            seen.add(dedupeKey);
+            refs.push({
+                type, community, year, number, euDocumentId, euArticle,
+                fullCitation: match[0], referenceContext, referenceType,
+            });
+        }
+    }
+    return refs;
+}
+function buildDatabase() {
+    console.log('Building Rwandan Law MCP database...\n');
+    if (fs.existsSync(DB_PATH)) {
+        fs.unlinkSync(DB_PATH);
+        console.log('  Deleted existing database.\n');
+    }
+    const dataDir = path.dirname(DB_PATH);
+    if (!fs.existsSync(dataDir)) {
+        fs.mkdirSync(dataDir, { recursive: true });
+    }
+    const db = new Database(DB_PATH);
+    db.pragma('foreign_keys = ON');
+    db.pragma('journal_mode = WAL');
+    db.exec(SCHEMA);
+    const insertDoc = db.prepare(`
+    INSERT INTO legal_documents (id, type, title, title_en, short_name, status, issued_date, in_force_date, url, description)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `);
+    const insertProvision = db.prepare(`
+    INSERT INTO legal_provisions (document_id, provision_ref, chapter, section, title, content, metadata)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+  `);
+    const insertDefinition = db.prepare(`
+    INSERT OR IGNORE INTO definitions (document_id, term, term_en, definition, source_provision)
+    VALUES (?, ?, ?, ?, ?)
+  `);
+    const insertEuDocument = db.prepare(`
+    INSERT OR IGNORE INTO eu_documents (id, type, year, number, community, title, short_name, url_eur_lex, description)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `);
+    const insertEuReference = db.prepare(`
+    INSERT INTO eu_references
+      (source_type, source_id, document_id, provision_id, eu_document_id, eu_article,
+       reference_type, reference_context, full_citation, is_primary_implementation,
+       implementation_status, last_verified)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `);
+    if (!fs.existsSync(SEED_DIR)) {
+        console.log(`No seed directory at ${SEED_DIR} — creating empty database.`);
+        db.close();
+        return;
+    }
+    const seedFiles = fs.readdirSync(SEED_DIR)
+        .filter(f => f.endsWith('.json') && !f.startsWith('.') && !f.startsWith('_'));
+    if (seedFiles.length === 0) {
+        console.log('No seed files found. Database created with empty schema.');
+        db.close();
+        return;
+    }
+    let totalDocs = 0;
+    let totalProvisions = 0;
+    let totalDefs = 0;
+    let totalEuDocuments = 0;
+    let totalEuReferences = 0;
+    const primaryImplementationByDocument = new Set();
+    const loadAll = db.transaction(() => {
+        for (const file of seedFiles) {
+            const filePath = path.join(SEED_DIR, file);
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const seed = JSON.parse(content);
+            insertDoc.run(seed.id, seed.type ?? 'statute', seed.title, seed.title_en ?? null, seed.short_name ?? null, seed.status ?? 'in_force', seed.issued_date ?? null, seed.in_force_date ?? null, seed.url ?? null, seed.description ?? null);
+            totalDocs++;
+            if (seed.provisions && seed.provisions.length > 0) {
+                const deduped = dedupeProvisions(seed.provisions);
+                for (const prov of deduped) {
+                    const insertResult = insertProvision.run(seed.id, prov.provision_ref, prov.chapter ?? null, prov.section, prov.title ?? null, prov.content, prov.metadata ? JSON.stringify(prov.metadata) : null);
+                    totalProvisions++;
+                    const provisionId = Number(insertResult.lastInsertRowid);
+                    const extractedRefs = extractEuReferences(prov.content);
+                    if (extractedRefs.length > 0) {
+                        const sourceId = `${seed.id}:${prov.provision_ref}`;
+                        const lastVerified = new Date().toISOString();
+                        for (const ref of extractedRefs) {
+                            const eurLexType = ref.type === 'regulation' ? 'reg' : 'dir';
+                            const eurLexUrl = `https://eur-lex.europa.eu/eli/${eurLexType}/${ref.year}/${ref.number}/oj`;
+                            const shortName = `${ref.type === 'regulation' ? 'Regulation' : 'Directive'} ${ref.year}/${ref.number}`;
+                            const euInsert = insertEuDocument.run(ref.euDocumentId, ref.type, ref.year, ref.number, ref.community, shortName, shortName, eurLexUrl, 'Auto-extracted from Rwandan statute text');
+                            if (euInsert.changes > 0)
+                                totalEuDocuments++;
+                            const primaryKey = `${seed.id}:${ref.euDocumentId}`;
+                            const isPrimary = ref.referenceType === 'implements' && !primaryImplementationByDocument.has(primaryKey) ? 1 : 0;
+                            if (isPrimary === 1)
+                                primaryImplementationByDocument.add(primaryKey);
+                            try {
+                                const refInsert = insertEuReference.run('provision', sourceId, seed.id, provisionId, ref.euDocumentId, ref.euArticle, ref.referenceType, ref.referenceContext, ref.fullCitation, isPrimary, isPrimary === 1 ? 'complete' : 'unknown', lastVerified);
+                                if (refInsert.changes > 0)
+                                    totalEuReferences++;
+                            }
+                            catch {
+                                // Ignore duplicate references
+                            }
+                        }
+                    }
+                }
+            }
+            for (const def of seed.definitions ?? []) {
+                insertDefinition.run(seed.id, def.term, null, def.definition, def.source_provision ?? null);
+                totalDefs++;
+            }
+        }
+    });
+    loadAll();
+    // Write build metadata
+    const insertMeta = db.prepare('INSERT INTO db_metadata (key, value) VALUES (?, ?)');
+    const writeMeta = db.transaction(() => {
+        insertMeta.run('tier', 'free');
+        insertMeta.run('schema_version', '2');
+        insertMeta.run('built_at', new Date().toISOString());
+        insertMeta.run('builder', 'build-db.ts');
+        insertMeta.run('jurisdiction', 'RW');
+        insertMeta.run('source', 'rwandalii-law-catalog-akn-and-pdf');
+        insertMeta.run('licence', 'See sources.yml');
+    });
+    writeMeta();
+    // Set journal_mode to DELETE for WASM compatibility
+    db.pragma('journal_mode = DELETE');
+    db.exec('ANALYZE');
+    db.exec('VACUUM');
+    db.close();
+    const size = fs.statSync(DB_PATH).size;
+    console.log(`\nBuild complete: ${totalDocs} documents, ${totalProvisions} provisions, ` +
+        `${totalDefs} definitions, ${totalEuDocuments} EU documents, ${totalEuReferences} EU references`);
+    console.log(`Output: ${DB_PATH} (${(size / 1024 / 1024).toFixed(1)} MB)`);
+}
+buildDatabase();
+//# sourceMappingURL=build-db.js.map

package/dist/scripts/build-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-db.js","sourceRoot":"","sources":["../../scripts/build-db.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AACzD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;AAiD/D,kBAAkB;AAClB,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkKd,CAAC;AAEF,SAAS,mBAAmB,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,gBAAgB,CAAC,UAA2B;IACnD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;YACzG,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjD,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,QAAQ,GAAa;QACzB,4FAA4F;QAC5F,uFAAuF;QACvF,kEAAkE;KACnE,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,KAA6B,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAoB,CAAC;YACtD,IAAI,OAAe,EAAE,SAAiB,EAAE,YAAgC,CAAC;YAEzE,IAAI,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5B,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACpE,CAAC;iBAAM,IAAI,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAAC,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACpE,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAAC,YAAY,GAAG,SAAS,CAAC;YACrE,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAChD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;YAC5G,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YAC9C,IAAI,IAAI,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;gBAAE,SAAS;YAE/D,MAAM,SAAS,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,IAAI,IAAI,CAAgB,CAAC;YACvE,MAAM,YAAY,GAAG,GAAG,IAAI,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;YAEjD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;YAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;YACvE,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5E,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,yCAAyC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;YACjG,MAAM,aAAa,GAAoB,4CAA4C,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;YAEzI,MAAM,SAAS,GAAG,GAAG,YAAY,IAAI,SAAS,IAAI,EAAE,EAAE,CAAC;YACvD,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,SAAS;YAClC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAEpB,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS;gBACtD,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,aAAa;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IAEtD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEhC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAAC;;;GAG5B,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,EAAE,CAAC,OAAO,CAAC;;;GAGlC,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,EAAE,CAAC,OAAO,CAAC;;;GAGnC,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,EAAE,CAAC,OAAO,CAAC;;;GAGnC,CAAC,CAAC;IAEH,MAAM,iBAAiB,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;GAMpC,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,wBAAwB,QAAQ,6BAA6B,CAAC,CAAC;QAC3E,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC;SACvC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAEhF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;QACxE,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IAED,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,MAAM,+BAA+B,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1D,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QAClC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC;YAEjD,SAAS,CAAC,GAAG,CACX,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,IAAI,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,EAClE,IAAI,CAAC,UAAU,IAAI,IAAI,EAAE,IAAI,CAAC,MAAM,IAAI,UAAU,EAClD,IAAI,CAAC,WAAW,IAAI,IAAI,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI,EACpD,IAAI,CAAC,GAAG,IAAI,IAAI,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,CAC3C,CAAC;YACF,SAAS,EAAE,CAAC;YAEZ,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAElD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;oBAC3B,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CACtC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,EACjD,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,IAAI,CAAC,OAAO,EAC9C,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CACrD,CAAC;oBACF,eAAe,EAAE,CAAC;oBAElB,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;oBACzD,MAAM,aAAa,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACxD,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC7B,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;wBACpD,MAAM,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;wBAE9C,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;4BAChC,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;4BAC7D,MAAM,SAAS,GAAG,iCAAiC,UAAU,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;4BAC7F,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;4BAExG,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CACnC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,SAAS,EAC/D,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,0CAA0C,CAC5E,CAAC;4BACF,IAAI,QAAQ,CAAC,OAAO,GAAG,CAAC;gCAAE,gBAAgB,EAAE,CAAC;4BAE7C,MAAM,UAAU,GAAG,GAAG,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;4BACpD,MAAM,SAAS,GAAG,GAAG,CAAC,aAAa,KAAK,YAAY,IAAI,CAAC,+BAA+B,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;4BACjH,IAAI,SAAS,KAAK,CAAC;gCAAE,+BAA+B,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;4BAErE,IAAI,CAAC;gCACH,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,CACrC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,SAAS,EAC5E,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,YAAY,EAAE,SAAS,EACpE,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE,YAAY,CACvD,CAAC;gCACF,IAAI,SAAS,CAAC,OAAO,GAAG,CAAC;oCAAE,iBAAiB,EAAE,CAAC;4BACjD,CAAC;4BAAC,MAAM,CAAC;gCACP,8BAA8B;4BAChC,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAED,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;gBACzC,gBAAgB,CAAC,GAAG,CAClB,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,gBAAgB,IAAI,IAAI,CACtE,CAAC;gBACF,SAAS,EAAE,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,CAAC;IAEV,uBAAuB;IACvB,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAC,oDAAoD,CAAC,CAAC;IACpF,MAAM,SAAS,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QACpC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,UAAU,CAAC,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QACtC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QACrD,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACzC,UAAU,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QACrC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,mCAAmC,CAAC,CAAC;QAC9D,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IACH,SAAS,EAAE,CAAC;IAEZ,oDAAoD;IACpD,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAEnC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnB,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClB,EAAE,CAAC,KAAK,EAAE,CAAC;IAEX,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IACvC,OAAO,CAAC,GAAG,CACT,qBAAqB,SAAS,eAAe,eAAe,eAAe;QAC3E,GAAG,SAAS,iBAAiB,gBAAgB,kBAAkB,iBAAiB,gBAAgB,CACjG,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,KAAK,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5E,CAAC;AAED,aAAa,EAAE,CAAC"}

package/dist/scripts/drift-detect.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env tsx
+/**
+ * Drift detection for Rwandan Law MCP.
+ *
+ * Checks if upstream www.riigiteataja.ee content has changed since last ingestion.
+ * Uses the golden-hashes.json fixture to verify content integrity.
+ */
+export {};
+//# sourceMappingURL=drift-detect.d.ts.map

package/dist/scripts/drift-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-detect.d.ts","sourceRoot":"","sources":["../../scripts/drift-detect.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/scripts/drift-detect.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env tsx
+/**
+ * Drift detection for Rwandan Law MCP.
+ *
+ * Checks if upstream www.riigiteataja.ee content has changed since last ingestion.
+ * Uses the golden-hashes.json fixture to verify content integrity.
+ */
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const hashesPath = join(__dirname, '../fixtures/golden-hashes.json');
+async function main() {
+    console.log('Rwandan Law MCP — Drift Detection');
+    console.log('=====================================\n');
+    const fixture = JSON.parse(readFileSync(hashesPath, 'utf-8'));
+    console.log(`Checking ${fixture.provisions.length} provisions...\n`);
+    let passed = 0;
+    let failed = 0;
+    let skipped = 0;
+    for (const hash of fixture.provisions) {
+        if (hash.expected_sha256 === 'COMPUTE_ON_FIRST_INGEST') {
+            console.log(`  SKIP ${hash.id}: Not yet ingested`);
+            skipped++;
+            continue;
+        }
+        try {
+            const response = await fetch(hash.upstream_url, {
+                headers: { 'User-Agent': 'Rwandan-Law-MCP/1.0 drift-detect' },
+            });
+            if (response.status !== 200) {
+                console.log(`  WARN ${hash.id}: HTTP ${response.status}`);
+                failed++;
+                continue;
+            }
+            const body = await response.text();
+            if (hash.expected_snippet && body.toLowerCase().includes(hash.expected_snippet.toLowerCase())) {
+                console.log(`  OK   ${hash.id}: Snippet found`);
+                passed++;
+            }
+            else {
+                console.log(`  DRIFT ${hash.id}: Expected snippet "${hash.expected_snippet}" not found`);
+                failed++;
+            }
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            console.log(`  ERROR ${hash.id}: ${msg}`);
+            failed++;
+        }
+    }
+    console.log(`\nResults: ${passed} passed, ${failed} failed, ${skipped} skipped`);
+    if (failed > 0) {
+        console.log('\nDrift detected! Data may need re-ingestion.');
+        process.exit(1);
+    }
+}
+main().catch(error => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=drift-detect.js.map

package/dist/scripts/drift-detect.js.map

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

package/dist/scripts/ingest.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env tsx
+/**
+ * Rwanda Law MCP -- full-catalog ingestion.
+ *
+ * Sources:
+ * - RwandaLII law catalog API (`/search/api/documents/`)
+ * - RwandaLII law detail pages (AKN HTML or PDF-backed)
+ */
+export {};
+//# sourceMappingURL=ingest.d.ts.map

package/dist/scripts/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../scripts/ingest.ts"],"names":[],"mappings":";AACA;;;;;;GAMG"}