feat: Initialize OAL Agent project structure with core components

.env.example

@@ -0,0 +1,19 @@
+# API Configuration
+API_HOST=0.0.0.0
+API_PORT=8000
+
+# Database
+DATABASE_URL=sqlite:///./oal_agent.db
+
+# Queue
+QUEUE_URL=redis://localhost:6379
+
+# LLM Configuration
+LLM_PROVIDER=openai
+LLM_API_KEY=your-api-key-here
+
+# Security
+SECRET_KEY=change-this-to-a-random-secret-key
+
+# Logging
+LOG_LEVEL=INFO

.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11"]
+
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+        pip install -r requirements-dev.txt
+
+    - name: Run tests
+      run: |
+        bash scripts/test.sh

.github/workflows/lint.yml

@@ -0,0 +1,28 @@
+name: Lint
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.11"
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements-dev.txt
+
+    - name: Run linters
+      run: |
+        bash scripts/lint.sh

.gitignore

@@ -57,10 +57,31 @@ Thumbs.db
 *.bak
 *.tmp
 
-# Project specific
-*.log
-*.db
-*.sqlite3
-*.coverage
-htmlcov/
+# Testing
 .pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# Data files (keep .gitkeep files)
+data/datasets/*.csv
+data/datasets/*.json
+data/datasets/*.parquet
+!data/datasets/.gitkeep
+!data/contracts/.gitkeep
+
+# Model files (large models, keep .gitkeep files)
+models/**/*.pt
+models/**/*.pth
+models/**/*.h5
+models/**/*.onnx
+models/**/*.pkl
+!models/**/.gitkeep
+
+# Redis
+dump.rdb
+
+# Temporary files
+tmp/
+temp/

.pre-commit-config.yaml

@@ -0,0 +1,29 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-json
+      - id: check-toml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+      - id: mixed-line-ending
+
+  - repo: https://github.com/psf/black
+    rev: 23.12.1
+    hooks:
+      - id: black
+        language_version: python3.11
+
+  - repo: https://github.com/pycqa/isort
+    rev: 5.13.2
+    hooks:
+      - id: isort
+
+  - repo: https://github.com/pycqa/flake8
+    rev: 7.0.0
+    hooks:
+      - id: flake8
+        args: ["--max-line-length=88", "--extend-ignore=E203"]

LICENSE_HEADER

@@ -0,0 +1,14 @@
+# Copyright (C) 2025 OpenAuditLabs
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.