@ansvar/us-regulations-mcp 1.0.0

package/dist/ingest/adapters/california-leginfo.js

@@ -0,0 +1,270 @@
+/**
+ * California Legislative Information Adapter
+ *
+ * Fetches CCPA/CPRA regulations from California LegInfo.
+ * Source: California Civil Code § 1798.100-1798.199
+ *
+ * PRODUCTION IMPLEMENTATION
+ * Uses HTML scraping with fail-fast DOM validation
+ */
+import * as cheerio from 'cheerio';
+/**
+ * Scraping error thrown when DOM structure validation fails
+ */
+class ScrapingError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ScrapingError';
+    }
+}
+/**
+ * Adapter for fetching CCPA/CPRA from California Legislative Information
+ */
+export class CaliforniaLeginfoAdapter {
+    regulationId;
+    civilCodeStart;
+    civilCodeEnd;
+    constructor(regulationId, civilCodeStart, civilCodeEnd) {
+        this.regulationId = regulationId;
+        this.civilCodeStart = civilCodeStart;
+        this.civilCodeEnd = civilCodeEnd;
+    }
+    /**
+     * Fetch CCPA metadata
+     *
+     * PLACEHOLDER: Returns hardcoded CCPA metadata
+     * TODO: Integrate with California LegInfo to fetch live metadata
+     */
+    async fetchMetadata() {
+        // Placeholder metadata for CCPA/CPRA
+        return {
+            id: this.regulationId,
+            full_name: 'California Consumer Privacy Act',
+            citation: 'Cal. Civ. Code § 1798.100-1798.199',
+            effective_date: '2020-01-01',
+            last_amended: '2023-01-01',
+            source_url: 'https://leginfo.legislature.ca.gov/faces/codes_displayText.xhtml?division=3.&part=4.&lawCode=CIV&title=1.81.5',
+            jurisdiction: 'california',
+            regulation_type: 'statute',
+        };
+    }
+    /**
+     * Fetch all CCPA sections
+     *
+     * Scrapes HTML from California LegInfo with fail-fast validation
+     * Source: https://leginfo.legislature.ca.gov/faces/codes.xhtml
+     */
+    async *fetchSections() {
+        const BASE_URL = 'https://leginfo.legislature.ca.gov/faces/codes_displayText.xhtml';
+        const sections = [];
+        // CCPA main sections (based on actual structure)
+        // Use strings to preserve trailing zeros (1798.100 not 1798.1)
+        const sectionNumbers = [
+            '1798.100', '1798.105', '1798.110', '1798.115', '1798.120', '1798.121', '1798.125',
+            '1798.130', '1798.135', '1798.140', '1798.145', '1798.150', '1798.155', '1798.160',
+            '1798.175', '1798.180', '1798.185', '1798.190', '1798.192', '1798.194', '1798.196',
+            '1798.198', '1798.199'
+        ];
+        console.log(`Fetching ${sectionNumbers.length} CCPA sections from California LegInfo...`);
+        for (const sectionNum of sectionNumbers) {
+            try {
+                // Use displaySection endpoint which has cleaner structure
+                const url = `https://leginfo.legislature.ca.gov/faces/codes_displaySection.xhtml?lawCode=CIV&sectionNum=${sectionNum}`;
+                // Fetch HTML with polite delay
+                await this.sleep(500); // 500ms between requests
+                const response = await this.fetchWithRetry(url);
+                const html = await response.text();
+                // Parse HTML
+                const $ = cheerio.load(html);
+                // Validate DOM structure
+                this.validateDOM($);
+                // Extract section content
+                const section = this.parseSection($, sectionNum.toString());
+                if (section) {
+                    sections.push(section);
+                    console.log(`  Fetched § ${sectionNum}`);
+                }
+                // Yield in batches of 10
+                if (sections.length >= 10) {
+                    yield sections.splice(0, 10);
+                }
+            }
+            catch (error) {
+                if (error instanceof ScrapingError) {
+                    console.error(`Scraping failed for § ${sectionNum}:`, error.message);
+                    throw error; // Fail fast on DOM structure issues
+                }
+                else {
+                    console.warn(`Failed to fetch § ${sectionNum}, continuing...`, error);
+                    // Continue with other sections
+                }
+            }
+        }
+        // Yield remaining sections
+        if (sections.length > 0) {
+            yield sections;
+        }
+    }
+    /**
+     * Validate DOM structure with fail-fast assertions
+     */
+    validateDOM($) {
+        // Check for expected structure - single_law_section div
+        const sectionContent = $('#single_law_section, #codeLawSectionNoHead');
+        if (sectionContent.length === 0) {
+            throw new ScrapingError('DOM structure changed: no section content found. Expected #single_law_section or #codeLawSectionNoHead');
+        }
+        // Additional validation: check if we got an error page
+        if ($('title').text().includes('Error') || $('body').text().includes('not found')) {
+            throw new ScrapingError('Section not found or error page returned');
+        }
+    }
+    /**
+     * Parse section from HTML
+     */
+    parseSection($, sectionNum) {
+        // Extract from the main content div
+        const sectionDiv = $('#single_law_section');
+        if (sectionDiv.length === 0) {
+            console.warn(`Section § ${sectionNum} not found in HTML`);
+            return null;
+        }
+        // Get text content
+        let text = sectionDiv.text().trim();
+        // Clean up extra whitespace
+        text = text.replace(/\s+/g, ' ').replace(/\n\s*\n/g, '\n');
+        // Validate text length
+        if (!text || text.length < 100) {
+            console.warn(`Section § ${sectionNum} text too short (${text.length} chars) - may be empty or truncated`);
+            return null;
+        }
+        // Extract title from h6 tag (section number and title)
+        let title;
+        const titleElement = sectionDiv.find('h6, p').first();
+        if (titleElement.length > 0) {
+            title = titleElement.text().trim();
+            // Remove section number from title if present
+            title = title.replace(/^1798\.\d+\.?\s*/, '');
+        }
+        // Extract cross-references (sections mentioned in text)
+        const crossReferences = this.extractCrossReferences(text);
+        return {
+            sectionNumber: sectionNum,
+            title,
+            text,
+            chapter: 'Title 1.81.5 - California Consumer Privacy Act',
+            parentSection: undefined,
+            crossReferences: crossReferences.length > 0 ? crossReferences : undefined,
+        };
+    }
+    /**
+     * Extract cross-references from text
+     */
+    extractCrossReferences(text) {
+        const refs = [];
+        // Pattern: "Section 1798.XXX" or "§ 1798.XXX"
+        const pattern = /(?:Section|§)\s+1798\.\d+/g;
+        const matches = text.match(pattern);
+        if (matches) {
+            for (const match of matches) {
+                const ref = match.replace(/^(?:Section|§)\s+/, '');
+                if (!refs.includes(ref)) {
+                    refs.push(ref);
+                }
+            }
+        }
+        return refs;
+    }
+    /**
+     * Fetch with retry logic and exponential backoff
+     */
+    async fetchWithRetry(url, maxRetries = 3) {
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            try {
+                const response = await fetch(url);
+                if (response.status === 429) {
+                    const delay = Math.min(1000 * 2 ** attempt + Math.random() * 1000, 30000);
+                    console.warn(`Rate limited, retrying in ${delay}ms...`);
+                    await this.sleep(delay);
+                    continue;
+                }
+                if (!response.ok) {
+                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                }
+                return response;
+            }
+            catch (error) {
+                if (attempt === maxRetries - 1)
+                    throw error;
+                const delay = 1000 * 2 ** attempt;
+                console.warn(`Fetch failed, retrying in ${delay}ms...`, error);
+                await this.sleep(delay);
+            }
+        }
+        throw new Error('Max retries exceeded');
+    }
+    /**
+     * Sleep helper
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Check for updates since last fetch
+     *
+     * Checks California LegInfo for amendments to Civil Code § 1798
+     * Note: This is best-effort since there's no official API
+     */
+    async checkForUpdates(lastFetched) {
+        try {
+            // Fetch a sample section to check for updates
+            const url = 'https://leginfo.legislature.ca.gov/faces/codes_displayText.xhtml?lawCode=CIV&division=3.&part=4.&section=1798.100';
+            const response = await fetch(url);
+            const lastModifiedHeader = response.headers.get('last-modified');
+            if (!lastModifiedHeader) {
+                console.warn('No last-modified header from California LegInfo');
+                return {
+                    hasChanges: false,
+                    lastModified: new Date(),
+                    changes: [],
+                };
+            }
+            const lastModified = new Date(lastModifiedHeader);
+            return {
+                hasChanges: lastModified > lastFetched,
+                lastModified,
+                changes: lastModified > lastFetched
+                    ? [`California Civil Code § 1798 (CCPA) may have been updated on ${lastModified.toISOString()}`]
+                    : [],
+            };
+        }
+        catch (error) {
+            console.error('Error checking for updates:', error);
+            return {
+                hasChanges: false,
+                lastModified: new Date(),
+                changes: [],
+            };
+        }
+    }
+    /**
+     * Extract definitions from CCPA sections
+     *
+     * Future enhancement: Parse definition sections (primarily § 1798.140)
+     * For now, returns empty array - definitions can be added manually if needed
+     */
+    async extractDefinitions() {
+        // TODO: Implement definition extraction
+        // CCPA definitions are primarily in § 1798.140
+        // Format: "(a) 'Term' means definition."
+        // Would need careful parsing to extract all term-definition pairs
+        return [];
+    }
+}
+/**
+ * Factory function to create CCPA adapter
+ */
+export function createCcpaAdapter() {
+    return new CaliforniaLeginfoAdapter('CCPA', 1798.100, 1798.199);
+}
+//# sourceMappingURL=california-leginfo.js.map

package/dist/ingest/adapters/california-leginfo.js.map

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

package/dist/ingest/adapters/ecfr.d.ts

@@ -0,0 +1,76 @@
+/**
+ * eCFR Adapter (Electronic Code of Federal Regulations)
+ *
+ * Fetches HIPAA regulations from ecfr.gov API.
+ * Source: 45 CFR Parts 160, 162, 164 (Privacy Rule, Security Rule, Breach Notification)
+ *
+ * PRODUCTION IMPLEMENTATION
+ * Uses the eCFR API: https://www.ecfr.gov/developers/documentation/api/v1
+ */
+import { SourceAdapter, RegulationMetadata, Section, Definition, UpdateStatus } from '../framework.js';
+/**
+ * Adapter for fetching HIPAA from eCFR API
+ */
+export declare class EcfrAdapter implements SourceAdapter {
+    private readonly regulationId;
+    private readonly cfr_title;
+    private readonly cfr_parts;
+    constructor(regulationId: string, cfr_title: number, cfr_parts: number[]);
+    /**
+     * Fetch HIPAA metadata
+     *
+     * PLACEHOLDER: Returns hardcoded HIPAA metadata
+     * TODO: Integrate with eCFR API to fetch live metadata
+     */
+    fetchMetadata(): Promise<RegulationMetadata>;
+    /**
+     * Fetch all HIPAA sections
+     *
+     * Fetches XML from eCFR API and parses sections with hierarchical structure
+     * API endpoint: https://www.ecfr.gov/api/versioner/v1/full/{date}/title-{title}.xml
+     */
+    fetchSections(): AsyncGenerator<Section[]>;
+    /**
+     * Parse a section from XML DIV8 element
+     */
+    private parseSection;
+    /**
+     * Extract text content from XML element recursively
+     */
+    private extractText;
+    /**
+     * Extract cross-references from CITA tags
+     */
+    private extractCrossReferences;
+    /**
+     * Extract numeric part from section number
+     */
+    private extractNumber;
+    /**
+     * Get the latest available date for this title from eCFR titles API
+     */
+    private getLatestDate;
+    /**
+     * Fetch with retry logic and exponential backoff
+     */
+    private fetchWithRetry;
+    /**
+     * Check for updates since last fetch
+     *
+     * Queries eCFR API for revision dates and compares with lastFetched
+     * eCFR updates daily from Federal Register
+     */
+    checkForUpdates(lastFetched: Date): Promise<UpdateStatus>;
+    /**
+     * Extract definitions from HIPAA sections
+     *
+     * Future enhancement: Parse definition sections (e.g., 45 CFR 160.103, 164.103)
+     * For now, returns empty array - definitions can be added manually if needed
+     */
+    extractDefinitions(): Promise<Definition[]>;
+}
+/**
+ * Factory function to create HIPAA adapter
+ */
+export declare function createHipaaAdapter(): EcfrAdapter;
+//# sourceMappingURL=ecfr.d.ts.map

package/dist/ingest/adapters/ecfr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecfr.d.ts","sourceRoot":"","sources":["../../../src/ingest/adapters/ecfr.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,OAAO,EACP,UAAU,EACV,YAAY,EACb,MAAM,iBAAiB,CAAC;AAGzB;;GAEG;AACH,qBAAa,WAAY,YAAW,aAAa;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;gBAEzB,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE;IAMxE;;;;;OAKG;IACG,aAAa,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAclD;;;;;OAKG;IACI,aAAa,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;IAoHjD;;OAEG;IACH,OAAO,CAAC,YAAY;IA8BpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAkCnB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAyB9B;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;YACW,aAAa;IAkB3B;;OAEG;YACW,cAAc;IA6B5B;;;;;OAKG;IACG,eAAe,CAAC,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC;IAqC/D;;;;;OAKG;IACG,kBAAkB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;CAWlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CAEhD"}