New asset (policy gap mapper)

Author: aliottoman

ai/generative-ai-service/policy-gap-mapper/LICENSE

@@ -0,0 +1,35 @@
+Copyright (c) 2025 Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ai/generative-ai-service/policy-gap-mapper/README.md

@@ -0,0 +1,99 @@
+# 📚 Policy Gap Mapper
+
+A Streamlit-based compliance application that uses **Oracle Document Understanding (DU)** and **Generative AI** to analyze regulatory documents and internal policies, then highlight **coverage gaps**.
+
+Upload regulation PDFs/images and your internal policy documents, and the app will:
+- Extract text via **OCI Document Understanding**
+- Use an **LLM** to break regulations into atomic obligations
+- Extract control statements from your policies
+- Map obligations to controls and score coverage
+- Generate an interactive **gap report** and downloadable **CSV**
+
+**Author:** Ali Ottoman  
+**Reviewed date:** 05.12.2025  
+
+---
+
+## 🔧 Features
+
+### End-to-End DU + LLM Pipeline
+- Upload multiple **regulation** documents and **internal policy** documents (PDF, JPG, PNG).
+- Text is extracted using **OCI Document Understanding** (general text extraction).
+- All downstream reasoning is performed with an **LLM** hosted on OCI Generative AI.
+
+### Obligation Extraction from Regulations
+- Splits regulatory text into manageable chunks.
+- LLM extracts **atomic, testable obligations**, each enriched with:
+  - `obligation_text`
+  - `article_reference`
+  - `category`
+  - `criticality`
+  - `keywords`
+
+### Control Extraction from Internal Policies
+- LLM identifies **control statements**, each with:
+  - `control_text`
+  - `control_type`
+  - `owner_department`
+  - `keywords`
+
+---
+
+## 🗂️ Files & Structure
+
+```
+.
+├── files
+   ├── policy_gap_mapper.py      # Main Streamlit app
+   ├── config.py                 # OCI config & model IDs
+├── requirements.txt    # Dependencies
+└── README.md           # This file
+```
+
+---
+
+## ⚙️ Setup & Installation
+
+```bash
+git clone https://github.com/your-username/your-repo.git
+cd your-repo
+pip install -r requirements.txt
+```
+
+Configure `~/.oci/config` and edit:
+
+```python
+COMPARTMENT_ID = "<your-compartment-ocid>"
+MODEL_ID = ["meta.llama-4-maverick-17b-128e-instruct-fp8"]
+```
+
+---
+
+## 🚀 Run the App
+
+```bash
+streamlit run policy_gap_mapper.py
+```
+
+---
+
+## 📝 How to Use
+
+1. Upload regulation & policy documents.
+2. Click **Analyze**.
+3. Review extracted obligations & controls.
+4. Inspect mapping results.
+5. Download the CSV gap report.
+
+---
+
+## 🔧 OCI Services Used
+
+- **OCI Document Understanding**: [Link](https://docs.oracle.com/en-us/iaas/Content/document-understanding/using/home.htm)
+- **OCI Generative AI — ChatOCIGenAI**: [Link](https://www.oracle.com/ae/artificial-intelligence/generative-ai/generative-ai-service/)
+
+---
+
+## 📄 License
+
+MIT License — see `LICENSE` for details.

ai/generative-ai-service/policy-gap-mapper/files/config.py

@@ -0,0 +1,10 @@
+"""
+config file
+
+- Add the OCID of your compartment
+"""
+
+COMPARTMENT_ID = ""
+
+# You can select other models here as well
+MODEL_ID = "cohere.command-a-03-2025"