@ansvar/us-regulations-mcp 1.0.0

package/dist/ingest/adapters/ecfr.js

@@ -0,0 +1,355 @@
+/**
+ * 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 { XMLParser } from 'fast-xml-parser';
+/**
+ * Adapter for fetching HIPAA from eCFR API
+ */
+export class EcfrAdapter {
+    regulationId;
+    cfr_title;
+    cfr_parts;
+    constructor(regulationId, cfr_title, cfr_parts) {
+        this.regulationId = regulationId;
+        this.cfr_title = cfr_title;
+        this.cfr_parts = cfr_parts;
+    }
+    /**
+     * Fetch HIPAA metadata
+     *
+     * PLACEHOLDER: Returns hardcoded HIPAA metadata
+     * TODO: Integrate with eCFR API to fetch live metadata
+     */
+    async fetchMetadata() {
+        // Placeholder metadata for HIPAA
+        return {
+            id: this.regulationId,
+            full_name: 'Health Insurance Portability and Accountability Act',
+            citation: '45 CFR Parts 160, 162, 164',
+            effective_date: '2003-04-14',
+            last_amended: '2013-01-25',
+            source_url: 'https://www.ecfr.gov/current/title-45',
+            jurisdiction: 'federal',
+            regulation_type: 'rule',
+        };
+    }
+    /**
+     * 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
+     */
+    async *fetchSections() {
+        // Get the latest available date for this title
+        const date = await this.getLatestDate();
+        const url = `https://www.ecfr.gov/api/versioner/v1/full/${date}/title-${this.cfr_title}.xml`;
+        console.log(`Fetching eCFR Title ${this.cfr_title} from ${url}...`);
+        // Fetch XML with retry logic
+        const response = await this.fetchWithRetry(url);
+        const xmlText = await response.text();
+        // Parse XML
+        const parser = new XMLParser({
+            ignoreAttributes: false,
+            attributeNamePrefix: '@_',
+            textNodeName: '#text',
+            preserveOrder: false,
+        });
+        const xmlDoc = parser.parse(xmlText);
+        // Extract sections from relevant parts
+        const sections = [];
+        // Navigate XML structure: ECFR → DIV1 (Title) → DIV5 (Part) → DIV8 (Section)
+        // The structure is: DIV1 (title) → DIV2 (subtitle) → DIV4 (subchapter) → DIV5 (part) → DIV8 (section)
+        const title = xmlDoc.ECFR?.DIV1;
+        if (!title) {
+            console.warn(`No title found in eCFR XML for Title ${this.cfr_title}`);
+            return;
+        }
+        // Find all DIV5 (parts) recursively
+        const findParts = (node) => {
+            if (!node || typeof node !== 'object')
+                return [];
+            const parts = [];
+            if (node.DIV5) {
+                const div5s = Array.isArray(node.DIV5) ? node.DIV5 : [node.DIV5];
+                parts.push(...div5s.filter(Boolean));
+            }
+            // Recurse into child DIVs
+            for (const key of Object.keys(node)) {
+                if (key.startsWith('DIV') && key !== 'DIV5' && typeof node[key] === 'object') {
+                    const childNodes = Array.isArray(node[key]) ? node[key] : [node[key]];
+                    for (const child of childNodes) {
+                        parts.push(...findParts(child));
+                    }
+                }
+            }
+            return parts;
+        };
+        const parts = findParts(title);
+        console.log(`  Found ${parts.length} parts in Title ${this.cfr_title}`);
+        for (const part of parts) {
+            const partNum = this.extractNumber(part['@_N']);
+            // Only process our target parts
+            if (!this.cfr_parts.includes(partNum)) {
+                continue;
+            }
+            console.log(`  Processing Part ${partNum}...`);
+            // Sections are in DIV6 (subparts) → DIV8 (sections)
+            const findSections = (node) => {
+                if (!node || typeof node !== 'object')
+                    return [];
+                const secs = [];
+                // If this node has DIV8, collect them
+                if (node.DIV8) {
+                    const div8s = Array.isArray(node.DIV8) ? node.DIV8 : [node.DIV8];
+                    secs.push(...div8s.filter(Boolean));
+                }
+                // Recurse into DIV6 (subparts) and other child DIVs
+                for (const key of Object.keys(node)) {
+                    if (key.startsWith('DIV') && key !== 'DIV8' && typeof node[key] === 'object') {
+                        const childNodes = Array.isArray(node[key]) ? node[key] : [node[key]];
+                        for (const child of childNodes) {
+                            secs.push(...findSections(child));
+                        }
+                    }
+                }
+                return secs;
+            };
+            const sectionDivs = findSections(part);
+            console.log(`    Found ${sectionDivs.length} sections in Part ${partNum}`);
+            for (const sectionDiv of sectionDivs) {
+                const section = this.parseSection(sectionDiv, partNum, '');
+                if (section) {
+                    sections.push(section);
+                }
+            }
+            // Yield in batches of 50
+            if (sections.length >= 50) {
+                yield sections.splice(0, 50);
+            }
+        }
+        // Yield remaining sections
+        if (sections.length > 0) {
+            yield sections;
+        }
+    }
+    /**
+     * Parse a section from XML DIV8 element
+     */
+    parseSection(div, partNum, subpartId) {
+        const sectionNum = div['@_N'];
+        if (!sectionNum)
+            return null;
+        // Extract section text
+        const text = this.extractText(div);
+        if (!text || text.length < 10)
+            return null;
+        // Extract title (HEAD)
+        const title = div.HEAD ? this.extractText(div.HEAD) : undefined;
+        // Build section number - eCFR @_N already includes part number (e.g., "164.308")
+        // Don't prepend if section already starts with part number
+        const fullSectionNum = sectionNum.startsWith(`${partNum}.`)
+            ? sectionNum
+            : `${partNum}.${sectionNum}`;
+        // Extract cross-references (CITA tags)
+        const crossReferences = this.extractCrossReferences(div);
+        return {
+            sectionNumber: fullSectionNum,
+            title,
+            text,
+            chapter: `Part ${partNum}, Subpart ${subpartId}`,
+            parentSection: undefined, // TODO: implement parent detection for nested sections
+            crossReferences: crossReferences.length > 0 ? crossReferences : undefined,
+        };
+    }
+    /**
+     * Extract text content from XML element recursively
+     */
+    extractText(element) {
+        if (typeof element === 'string') {
+            return element.trim();
+        }
+        if (typeof element === 'object') {
+            if (element['#text']) {
+                const text = element['#text'];
+                return typeof text === 'string' ? text.trim() : String(text).trim();
+            }
+            // Recursively extract from child elements
+            const texts = [];
+            for (const key of Object.keys(element)) {
+                if (key.startsWith('@_'))
+                    continue; // Skip attributes
+                if (key === 'HEAD')
+                    continue; // Skip title
+                const child = element[key];
+                if (Array.isArray(child)) {
+                    for (const item of child) {
+                        const text = this.extractText(item);
+                        if (text)
+                            texts.push(text);
+                    }
+                }
+                else {
+                    const text = this.extractText(child);
+                    if (text)
+                        texts.push(text);
+                }
+            }
+            return texts.join(' ').trim();
+        }
+        return '';
+    }
+    /**
+     * Extract cross-references from CITA tags
+     */
+    extractCrossReferences(element) {
+        const refs = [];
+        const findCITA = (obj) => {
+            if (typeof obj !== 'object')
+                return;
+            for (const key of Object.keys(obj)) {
+                if (key === 'CITA') {
+                    const cita = obj[key];
+                    if (Array.isArray(cita)) {
+                        refs.push(...cita.map(c => this.extractText(c)).filter(Boolean));
+                    }
+                    else {
+                        const ref = this.extractText(cita);
+                        if (ref)
+                            refs.push(ref);
+                    }
+                }
+                else if (typeof obj[key] === 'object') {
+                    findCITA(obj[key]);
+                }
+            }
+        };
+        findCITA(element);
+        return refs;
+    }
+    /**
+     * Extract numeric part from section number
+     */
+    extractNumber(str) {
+        if (!str)
+            return 0;
+        const match = str.match(/\d+/);
+        return match ? parseInt(match[0]) : 0;
+    }
+    /**
+     * Get the latest available date for this title from eCFR titles API
+     */
+    async getLatestDate() {
+        try {
+            const response = await fetch('https://www.ecfr.gov/api/versioner/v1/titles');
+            const data = await response.json();
+            const titleInfo = data.titles.find((t) => t.number === this.cfr_title);
+            if (titleInfo && titleInfo.latest_issue_date) {
+                return titleInfo.latest_issue_date;
+            }
+            // Fallback to current date
+            return new Date().toISOString().split('T')[0];
+        }
+        catch (error) {
+            console.warn('Failed to fetch latest date, using current date:', error);
+            return new Date().toISOString().split('T')[0];
+        }
+    }
+    /**
+     * 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) {
+                    // Rate limited - backoff
+                    const delay = Math.min(1000 * 2 ** attempt + Math.random() * 1000, 30000);
+                    console.warn(`Rate limited, retrying in ${delay}ms...`);
+                    await new Promise(resolve => setTimeout(resolve, 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 new Promise(resolve => setTimeout(resolve, delay));
+            }
+        }
+        throw new Error('Max retries exceeded');
+    }
+    /**
+     * Check for updates since last fetch
+     *
+     * Queries eCFR API for revision dates and compares with lastFetched
+     * eCFR updates daily from Federal Register
+     */
+    async checkForUpdates(lastFetched) {
+        try {
+            // eCFR provides last-modified in HTTP headers
+            const date = new Date().toISOString().split('T')[0];
+            const url = `https://www.ecfr.gov/api/versioner/v1/full/${date}/title-${this.cfr_title}.xml`;
+            const response = await fetch(url, { method: 'HEAD' });
+            const lastModifiedHeader = response.headers.get('last-modified');
+            if (!lastModifiedHeader) {
+                console.warn('No last-modified header from eCFR');
+                return {
+                    hasChanges: false,
+                    lastModified: new Date(),
+                    changes: [],
+                };
+            }
+            const lastModified = new Date(lastModifiedHeader);
+            return {
+                hasChanges: lastModified > lastFetched,
+                lastModified,
+                changes: lastModified > lastFetched
+                    ? [`Title ${this.cfr_title} updated on ${lastModified.toISOString()}`]
+                    : [],
+            };
+        }
+        catch (error) {
+            console.error('Error checking for updates:', error);
+            return {
+                hasChanges: false,
+                lastModified: new Date(),
+                changes: [],
+            };
+        }
+    }
+    /**
+     * 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
+     */
+    async extractDefinitions() {
+        // TODO: Implement definition extraction
+        // HIPAA definitions are in:
+        // - 45 CFR 160.103 (General definitions)
+        // - 45 CFR 164.103 (Security Rule definitions)
+        // - 45 CFR 164.501 (Privacy Rule definitions)
+        //
+        // These sections have structured format: "Term means definition."
+        // Would need regex parsing or NLP to extract accurately
+        return [];
+    }
+}
+/**
+ * Factory function to create HIPAA adapter
+ */
+export function createHipaaAdapter() {
+    return new EcfrAdapter('HIPAA', 45, [160, 162, 164]);
+}
+//# sourceMappingURL=ecfr.js.map

package/dist/ingest/adapters/ecfr.js.map

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

package/dist/ingest/adapters/regulations-gov.d.ts

@@ -0,0 +1,47 @@
+/**
+ * SOX Adapter
+ *
+ * Fetches SOX regulations from eCFR (for SEC implementing rules).
+ * Source: 17 CFR Part 229 (Regulation S-K, Item 308) and Part 240 (Exchange Act Rules)
+ *
+ * PRODUCTION IMPLEMENTATION
+ * Uses eCFR API for SEC regulations implementing Sarbanes-Oxley Section 404
+ */
+import { SourceAdapter, RegulationMetadata, Section, Definition, UpdateStatus } from '../framework.js';
+/**
+ * Adapter for fetching SOX regulations from eCFR
+ *
+ * Uses eCFR API for SEC regulations implementing Sarbanes-Oxley
+ */
+export declare class SoxAdapter implements SourceAdapter {
+    private readonly regulationId;
+    private readonly ecfrAdapter;
+    constructor(regulationId: string);
+    /**
+     * Fetch SOX metadata
+     */
+    fetchMetadata(): Promise<RegulationMetadata>;
+    /**
+     * Fetch all SOX-related sections from eCFR
+     *
+     * Fetches 17 CFR Parts 229 and 240, filtering to SOX-relevant sections
+     */
+    fetchSections(): AsyncGenerator<Section[]>;
+    /**
+     * Check for updates since last fetch
+     *
+     * Delegates to eCFR adapter for update checking
+     */
+    checkForUpdates(lastFetched: Date): Promise<UpdateStatus>;
+    /**
+     * Extract definitions from SOX sections
+     *
+     * Future enhancement: Parse definitions from SEC regulations
+     */
+    extractDefinitions(): Promise<Definition[]>;
+}
+/**
+ * Factory function to create SOX adapter
+ */
+export declare function createSoxAdapter(): SoxAdapter;
+//# sourceMappingURL=regulations-gov.d.ts.map

package/dist/ingest/adapters/regulations-gov.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regulations-gov.d.ts","sourceRoot":"","sources":["../../../src/ingest/adapters/regulations-gov.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,OAAO,EACP,UAAU,EACV,YAAY,EACb,MAAM,iBAAiB,CAAC;AAIzB;;;;GAIG;AACH,qBAAa,UAAW,YAAW,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAE9B,YAAY,EAAE,MAAM;IAMhC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAalD;;;;OAIG;IACI,aAAa,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;IA+BjD;;;;OAIG;IACG,eAAe,CAAC,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC;IAI/D;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;CAGlD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAE7C"}

package/dist/ingest/adapters/regulations-gov.js

@@ -0,0 +1,91 @@
+/**
+ * SOX Adapter
+ *
+ * Fetches SOX regulations from eCFR (for SEC implementing rules).
+ * Source: 17 CFR Part 229 (Regulation S-K, Item 308) and Part 240 (Exchange Act Rules)
+ *
+ * PRODUCTION IMPLEMENTATION
+ * Uses eCFR API for SEC regulations implementing Sarbanes-Oxley Section 404
+ */
+import { EcfrAdapter } from './ecfr.js';
+/**
+ * Adapter for fetching SOX regulations from eCFR
+ *
+ * Uses eCFR API for SEC regulations implementing Sarbanes-Oxley
+ */
+export class SoxAdapter {
+    regulationId;
+    ecfrAdapter;
+    constructor(regulationId) {
+        this.regulationId = regulationId;
+        // Use eCFR adapter for Title 17 (SEC regulations)
+        this.ecfrAdapter = new EcfrAdapter('SOX-SEC', 17, [229, 240]);
+    }
+    /**
+     * Fetch SOX metadata
+     */
+    async fetchMetadata() {
+        return {
+            id: this.regulationId,
+            full_name: 'Sarbanes-Oxley Act - SEC Implementing Regulations',
+            citation: '17 CFR Parts 229, 240 (Regulation S-K Item 308, Exchange Act Rules)',
+            effective_date: '2003-06-05',
+            last_amended: new Date().toISOString().split('T')[0],
+            source_url: 'https://www.ecfr.gov/current/title-17',
+            jurisdiction: 'federal',
+            regulation_type: 'rule',
+        };
+    }
+    /**
+     * Fetch all SOX-related sections from eCFR
+     *
+     * Fetches 17 CFR Parts 229 and 240, filtering to SOX-relevant sections
+     */
+    async *fetchSections() {
+        console.log('Fetching SOX sections from eCFR (Title 17)...');
+        // Key SOX-related sections:
+        // - 17 CFR 229.308 (Item 308: Internal control over financial reporting)
+        // - 17 CFR 240.13a-15 (Controls and procedures)
+        // - 17 CFR 240.15d-15 (Controls and procedures)
+        // - 17 CFR 240.13a-14 (Certifications)
+        // - 17 CFR 240.15d-14 (Certifications)
+        const relevantSections = [
+            '229.308',
+            '240.13a-15',
+            '240.15d-15',
+            '240.13a-14',
+            '240.15d-14',
+        ];
+        // Fetch from eCFR adapter
+        for await (const sectionBatch of this.ecfrAdapter.fetchSections()) {
+            // Filter to SOX-relevant sections
+            const filtered = sectionBatch.filter(section => relevantSections.some(relevant => section.sectionNumber.includes(relevant)));
+            if (filtered.length > 0) {
+                yield filtered;
+            }
+        }
+    }
+    /**
+     * Check for updates since last fetch
+     *
+     * Delegates to eCFR adapter for update checking
+     */
+    async checkForUpdates(lastFetched) {
+        return this.ecfrAdapter.checkForUpdates(lastFetched);
+    }
+    /**
+     * Extract definitions from SOX sections
+     *
+     * Future enhancement: Parse definitions from SEC regulations
+     */
+    async extractDefinitions() {
+        return this.ecfrAdapter.extractDefinitions();
+    }
+}
+/**
+ * Factory function to create SOX adapter
+ */
+export function createSoxAdapter() {
+    return new SoxAdapter('SOX');
+}
+//# sourceMappingURL=regulations-gov.js.map

package/dist/ingest/adapters/regulations-gov.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regulations-gov.js","sourceRoot":"","sources":["../../../src/ingest/adapters/regulations-gov.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC;;;;GAIG;AACH,MAAM,OAAO,UAAU;IACJ,YAAY,CAAS;IACrB,WAAW,CAAc;IAE1C,YAAY,YAAoB;QAC9B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,kDAAkD;QAClD,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,YAAY;YACrB,SAAS,EAAE,mDAAmD;YAC9D,QAAQ,EAAE,qEAAqE;YAC/E,cAAc,EAAE,YAAY;YAC5B,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACpD,UAAU,EAAE,uCAAuC;YACnD,YAAY,EAAE,SAAS;YACvB,eAAe,EAAE,MAAM;SACxB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,CAAC,aAAa;QAClB,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAE7D,4BAA4B;QAC5B,yEAAyE;QACzE,gDAAgD;QAChD,gDAAgD;QAChD,uCAAuC;QACvC,uCAAuC;QAEvC,MAAM,gBAAgB,GAAG;YACvB,SAAS;YACT,YAAY;YACZ,YAAY;YACZ,YAAY;YACZ,YAAY;SACb,CAAC;QAEF,0BAA0B;QAC1B,IAAI,KAAK,EAAE,MAAM,YAAY,IAAI,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,CAAC;YAClE,kCAAkC;YAClC,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAC7C,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAC5E,CAAC;YAEF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,QAAQ,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe,CAAC,WAAiB;QACrC,OAAO,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,kBAAkB;QACtB,OAAO,IAAI,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC;IAC/C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/ingest/framework.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Ingestion Framework
+ *
+ * Defines interfaces for regulation data ingestion from multiple sources.
+ * Supports automated fetching from APIs (regulations.gov, ecfr.gov, California LegInfo).
+ */
+/**
+ * Metadata about a regulation
+ */
+export interface RegulationMetadata {
+    id: string;
+    full_name: string;
+    citation: string;
+    effective_date?: string;
+    last_amended?: string;
+    source_url: string;
+    jurisdiction: string;
+    regulation_type: string;
+}
+/**
+ * A single section within a regulation
+ */
+export interface Section {
+    sectionNumber: string;
+    title?: string;
+    text: string;
+    chapter?: string;
+    parentSection?: string;
+    crossReferences?: string[];
+}
+/**
+ * A term definition from a regulation
+ */
+export interface Definition {
+    regulation: string;
+    term: string;
+    definition: string;
+    section: string;
+}
+/**
+ * Status of potential updates from source
+ */
+export interface UpdateStatus {
+    hasChanges: boolean;
+    lastModified?: Date;
+    changes?: string[];
+    sectionsAdded?: number;
+    sectionsModified?: number;
+}
+/**
+ * Source adapter interface
+ *
+ * Each regulation source (regulations.gov, ecfr.gov, etc.) implements this interface
+ * to provide normalized access to regulation data.
+ */
+export interface SourceAdapter {
+    /**
+     * Fetch regulation metadata
+     */
+    fetchMetadata(): Promise<RegulationMetadata>;
+    /**
+     * Fetch all sections with pagination support
+     * Returns an async generator for memory-efficient streaming
+     */
+    fetchSections(): AsyncGenerator<Section[]>;
+    /**
+     * Check if source has updates since last fetch
+     */
+    checkForUpdates(lastFetched: Date): Promise<UpdateStatus>;
+    /**
+     * Extract definitions from regulation text
+     */
+    extractDefinitions(): Promise<Definition[]>;
+}
+/**
+ * Regulation source configuration
+ */
+export interface RegulationSource {
+    id: string;
+    name: string;
+    sourceType: 'api' | 'html' | 'pdf';
+    adapter: SourceAdapter;
+}
+//# sourceMappingURL=framework.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"framework.d.ts","sourceRoot":"","sources":["../../src/ingest/framework.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE7C;;;OAGG;IACH,aAAa,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC;IAE3C;;OAEG;IACH,eAAe,CAAC,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE1D;;OAEG;IACH,kBAAkB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IACnC,OAAO,EAAE,aAAa,CAAC;CACxB"}

package/dist/ingest/framework.js

@@ -0,0 +1,8 @@
+/**
+ * Ingestion Framework
+ *
+ * Defines interfaces for regulation data ingestion from multiple sources.
+ * Supports automated fetching from APIs (regulations.gov, ecfr.gov, California LegInfo).
+ */
+export {};
+//# sourceMappingURL=framework.js.map

package/dist/ingest/framework.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework.js","sourceRoot":"","sources":["../../src/ingest/framework.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/tools/action-items.d.ts

@@ -0,0 +1,23 @@
+import type { Database } from 'better-sqlite3';
+export interface ActionItemsInput {
+    regulation: string;
+    sections: string[];
+}
+export interface ActionItem {
+    section: string;
+    title: string;
+    required_state: string;
+    priority: 'high' | 'medium' | 'low';
+    evidence_needed: string[];
+}
+export interface ActionItemsResult {
+    regulation: string;
+    action_items: ActionItem[];
+    total_items: number;
+}
+/**
+ * Generate compliance action items from regulation sections.
+ * Extracts priority and evidence requirements from section text.
+ */
+export declare function getComplianceActionItems(db: Database, input: ActionItemsInput): Promise<ActionItemsResult>;
+//# sourceMappingURL=action-items.d.ts.map

package/dist/tools/action-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-items.d.ts","sourceRoot":"","sources":["../../src/tools/action-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAgED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAkD5B"}