edip 1.1.2__py3-none-any.whl

edip/__init__.py

@@ -0,0 +1,13 @@
+
+from .inspector import SchemaInspector
+from .engine import EDIPEngine
+from .watcher import AmbientWatcher
+
+
+__all__ = [
+    "SchemaInspector",
+    "EDIPEngine",
+    "AmbientWatcher"
+]
+
+__version__ = "1.0.0"

edip-1.1.2.dist-info/METADATA

@@ -0,0 +1,241 @@
+Metadata-Version: 2.4
+Name: edip
+Version: 1.1.2
+Summary: Edge Deterministic Ingestion Protocol using dynamic SQLite constraint reflection
+Author: Uditha Manohara Prasad
+License: Proprietary
+Project-URL: Homepage, https://neziora.com
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Requires-Dist: watchdog>=3.0.0
+
+# Edge Deterministic Ingestion Protocol (EDIP)
+
+> **Autonomous, air-gapped document ingestion middleware that disciplines probabilistic Small Language Models (SLMs) using relational database constraint reflection and tri-folder isolation.**
+
+---
+
+## Executive Summary
+
+Enterprise document extraction pipelines face severe reliability bottlenecks when deploying generative AI at the edge. Small Language Models (1B–3B parameters) operating locally frequently hallucinate identifiers, fail structural types, or introduce relational inconsistencies. Traditional systems either crash upon database insertion or silently corrupt financial ledgers.
+
+The **Edge Deterministic Ingestion Protocol (EDIP)** eliminates this failure mode by converting **relational database integrity constraints (Primary Keys, Foreign Keys, CHECK constraints, and NOT NULL rules)** into a real-time, closed-loop error-reflection firewall. Operating 100% offline without cloud API overhead, EDIP enforces strict **Third Normal Form (3NF)** compliance before transactions commit.
+
+---
+
+## Architectural Highlights
+
+```text
+┌──────────────────────────────┐
+│      ./Inbound_Invoices      │
+│                              │
+│  Monitored Entry Directory   │
+│     (Watchdog Service)       │
+└──────────────┬───────────────┘
+               │
+               ▼
+       ┌───────────────────┐
+       │   EDIP Engine     │
+       │       Loop        │
+       └─────────┬─────────┘
+                 │
+                 ├── Dynamic Schema Introspection
+                 │   (PRAGMA inspection)
+                 │
+                 ├── Structured Extraction
+                 │   (Local SLM via Ollama / GGUF)
+                 │
+                 ├── Transactional Validation
+                 │   (Atomic SQLite WAL Engine)
+                 │
+                 └── Error-Reflection Loop
+                     (Runtime Constraint Feedback)
+                              │
+                ┌─────────────┴─────────────┐
+                │                           │
+                ▼                           ▼
+       ┌──────────────────┐       ┌──────────────────────┐
+       │ SUCCESS / DEDUP  │       │ CONSTRAINT FAILURE / │
+       │                  │       │ RETRIES EXHAUSTED    │
+       └────────┬─────────┘       └──────────┬───────────┘
+                │                            │
+                ▼                            ▼
+       ┌──────────────────┐       ┌──────────────────────┐
+       │ ./Processed_     │       │ ./Quarantine_        │
+       │ Archive          │       │ Documents            │
+       └──────────────────┘       │                      │
+                                  │ Human Review Queue   │
+                                  └──────────┬───────────┘
+                                             │
+                                             ▼
+                                  ┌──────────────────────┐
+                                  │ Dead-Letter Queue    │
+                                  │ (DLQ)                │
+                                  │                      │
+                                  │ audit_status:        │
+                                  │ PENDING_HUMAN_AUDIT  │
+                                  └──────────────────────┘
+```
+
+### Key Capabilities
+
+- **Zero-Cloud Air-Gapped Operation**: Optimized for edge deployment on commodity CPU/NPU hardware running quantized local models (`llama3.2:1b`, `qwen2.5:1.5b`).
+
+- **Dynamic Schema Introspection**: Discovers arbitrary tables, relational hierarchies, column types, and foreign key references at runtime using native SQLite metadata commands.
+
+- **Tri-Folder Enterprise Routing**:
+  - `Inbound`: Monitored entry directory.
+  - `Processed Archive`: Automatically archives successfully ingested or deduplicated files.
+  - `Quarantine Documents`: Physically isolates invalid, injected, or unresolvable documents for manual review.
+
+- **Dead-Letter Queue (DLQ) Auditing**: Preserves offending payloads, stack traces, and raw text in a dedicated quarantine ledger for administrative sign-off.
+
+- **Atomic Concurrency (WAL Mode)**: Leverages SQLite Write-Ahead Logging (`PRAGMA journal_mode=WAL`) to maintain concurrent multi-process reads with zero database locking conflicts.
+
+---
+
+## Installation & Environment Setup
+
+### Clone the Repository
+
+```bash
+git clone [suspicious link removed]
+cd edip-engine
+```
+
+### Install Dependencies
+
+```bash
+pip install -r requirements.txt
+```
+
+### Install EDIP Client SDK
+
+```bash
+pip install -e .
+```
+
+---
+
+## Quickstart & Usage
+
+### 1. Initializing the Engine
+
+```python
+from edip import EDIPEngine, AmbientWatcher
+
+# Configure the engine targeting your database
+engine = EDIPEngine(
+    db_path="enterprise_erp.db",
+    target_tables=["Invoices"],
+    model="llama3.2:1b",
+    api_url="http://localhost:11434/api/generate",
+    max_retries=3,
+    archive_dir="./Processed_Archive",
+    quarantine_dir="./Quarantine_Documents"
+)
+```
+
+### 2. Processing Inbound Documents Headlessly
+
+```python
+# Ingest single documents directly
+success, result = engine.ingest_document("path/to/invoice.pdf")
+
+if success:
+    print(f"Ingested successfully: {result['payload']}")
+    print(f"Archived to: {result['archived_path']}")
+else:
+    print(f"Quarantined for audit: {result['quarantined_path']}")
+    print(f"DLQ Reference ID: #{result['quarantine_id']}")
+```
+
+### 3. Running Continuous Directory Monitoring
+
+```python
+def audit_callback(file_path, success, info):
+    status = "SUCCESS" if success else "QUARANTINED"
+    print(f"[{status}] File: {file_path} | Details: {info}")
+
+
+# Launch continuous ambient background monitoring
+watcher = AmbientWatcher(
+    engine=engine,
+    watch_dir="./Inbound_Invoices",
+    callback=audit_callback
+)
+
+watcher.start(blocking=True)
+```
+
+---
+
+## Adversarial Stress-Test Benchmarks
+
+The EDIP architecture has been rigorously validated across adversarial document conditions:
+
+| **Scenario** | **Adversarial Challenge** | **EDIP Behavior** | **Final State** |
+|---|---|---|---|
+| **Legacy ID Migration** | Invoice lists deprecated cloud vendor ID (`9999`) while noting legacy ID (`101`). | Relational FK violation triggers error-reflection; model self-corrects to registered ID. | **Archived** (`supplier_id: 101`) |
+| **Messy Layout / Unstructured** | Amount written in descriptive prose without tabular columns. | Schema enforcement parses clean `REAL` float format. | **Archived** (`total_amount: 5250.5`) |
+| **Prompt Injection Defense** | Embedded malicious prompt instructions (`"DROP TABLE INVOICES"`). | Parameterized execution and constraint enforcement block injection payload. | **Quarantined** (`PENDING_HUMAN_AUDIT`) |
+| **Duplicate Submission** | Re-submission of previously processed transaction. | `UNIQUE NOT NULL` constraint prevents duplicate insertion; handles idempotently. | **Archived** (No duplicate rows) |
+| **Unregistered Vendor** | Invoice from unregistered supplier not present in master table. | Foreign key constraint fails; transaction halts safely without ledger contamination. | **Quarantined** (`PENDING_HUMAN_AUDIT`) |
+
+---
+
+## Intellectual Property & Authorship
+
+The architectural design, mathematical schema constraints reflection loop, and tri-folder isolation protocols are proprietary intellectual property developed by **Uditha Manohara Prasad** and **Neziora**.
+
+### Lead Architect
+
+**Uditha Manohara Prasad**
+
+*Software Engineer (UG) | AI Systems Researcher*
+
+- **LinkedIn**: [linkedin.com/in/uditha-manohara](https://www.google.com/url?sa=E&q=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fuditha-manohara%2F)
+- **X / Twitter**: [@uditha_manohara](https://www.google.com/url?sa=E&q=https%3A%2F%2Fx.com%2Fuditha%5Fmanohara)
+- **Instagram**: [@uditha.manohara](https://www.google.com/url?sa=E&q=https%3A%2F%2Fwww.instagram.com%2Fuditha.manohara%2F)
+- **Facebook**: [facebook.com/udithamprasad](https://www.google.com/url?sa=E&q=https%3A%2F%2Fwww.facebook.com%2Fudithamprasad%2F)
+- **TikTok**: [@udithamprasad](https://www.google.com/url?sa=E&q=https%3A%2F%2Fwww.tiktok.com%2F%40udithamprasad)
+- **WhatsApp**: [+94 76 182 3815]([suspicious link removed])
+
+### Organization
+
+**Neziora**
+
+*Next-Generation AI Software & Research*
+
+- **Website**: [neziora.com](https://www.google.com/url?sa=E&q=https%3A%2F%2Fneziora.com)
+- **LinkedIn**: [linkedin.com/company/neziora](https://www.google.com/url?sa=E&q=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fneziora)
+- **X / Twitter**: [@Neziora](https://www.google.com/url?sa=E&q=https%3A%2F%2Fx.com%2FNeziora)
+- **Instagram**: [@nezioraofficial](https://www.google.com/url?sa=E&q=https%3A%2F%2Fwww.instagram.com%2Fnezioraofficial%2F)
+- **Facebook**: [facebook.com/neziora](https://www.google.com/url?sa=E&q=https%3A%2F%2Fwww.facebook.com/neziora/)
+- **TikTok**: [@neziora](https://www.google.com/url?sa=E&q=https%3A%2F%2Fwww.tiktok.com%2F%40neziora)
+- **WhatsApp**: [+94 72 654 5635]([suspicious link removed])
+
+---
+
+## Citation
+
+If you reference the EDIP methodology or architecture in technical reports, academic publications, or open science repositories, please cite:
+
+```bibtex
+@software{prasad2026edip,
+  author       = {Uditha Manohara Prasad},
+  title        = {Edge Deterministic Ingestion Protocol (EDIP): Closed-Loop Relational Constraint Reflection for Edge AI},
+  year         = {2026},
+  publisher    = {Neziora},
+  url          = {https://neziora.com}
+}
+```
+
+---
+
+## License
+
+Copyright © 2026 Neziora & Uditha Manohara Prasad. All rights reserved.
+
+Source code distribution, binary compilation, and commercial deployment are subject to proprietary licensing terms.

edip-1.1.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+edip/__init__.py,sha256=EDFrUs6WSL69J7ZuSoNPsnoJ81nVTaOac1pNi8iSo8g,221
+edip/engine.cp315-win_amd64.pyd,sha256=KOxeFNrnL35q4itk9yPsxMKOTkoelqkWeCztr_CWDIM,134144
+edip/inspector.cp315-win_amd64.pyd,sha256=8HhZ21-bEs0kY0IfsZympOvCy8AYTGbrKVWJZALnejI,90624
+edip/watcher.cp315-win_amd64.pyd,sha256=HTUnceFCgEWNCRUceE8ZOKcqBaCciWpmb6gEuIqcZzE,60928
+edip-1.1.2.dist-info/METADATA,sha256=ay8Ks2KnKbCmk7DLhgtnKkcPkbAnZf0l1NseKFmJ378,11058
+edip-1.1.2.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+edip-1.1.2.dist-info/top_level.txt,sha256=g21vaLf3JPYAh4da0CvJ7iflfpUzYU5NHlguAfjPIJ4,5
+edip-1.1.2.dist-info/RECORD,,

edip-1.1.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

edip-1.1.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+edip