fix: bump yanked openai==1.59.0 -> 1.59.2

.env.example

@@ -0,0 +1,66 @@
+# ═══════════════════════════════════════════════════
+# Helpdesk Agent - Environment Configuration
+# Copy to .env and fill in your values
+# ═══════════════════════════════════════════════════
+
+# ── LLM ──────────────────────────────────────────────
+LLAMA_MODEL_PATH=/models/qwen2.5-7b-instruct-q4_k_m.gguf
+LLAMA_PORT=8081
+LLAMA_CTX_SIZE=65536
+LLAMA_THREADS=6
+
+# ── Hermes Agent ─────────────────────────────────────
+HERMES_API_KEY=change...n
+ADMIN_API_KEY=change...n
+
+# ── PostgreSQL ───────────────────────────────────────
+DB_HOST=postgres
+DB_PORT=5432
+DB_NAME=helpdesk
+DB_USER=helpdesk
+DB_PASSWORD=change...n
+
+# ── Redis ────────────────────────────────────────────
+REDIS_HOST=redis
+REDIS_PORT=6379
+REDIS_PASSWORD=change...n
+
+# ── ChromaDB ─────────────────────────────────────────
+CHROMA_HOST=chroma
+CHROMA_PORT=8000
+CHROMA_AUTH_TOKEN=change...n
+
+# ── SearXNG ──────────────────────────────────────────
+SEARX_HOST=searxng
+SEARX_PORT=8080
+
+# ── n8n ──────────────────────────────────────────────
+N8N_HOST=n8n
+N8N_PORT=5678
+N8N_WEBHOOK_URL=http://localhost:5678
+JWT_SECRET=change...n
+
+# ── Email (IMAP) ─────────────────────────────────────
+IMAP_HOST=imap.example.com
+IMAP_PORT=993
+IMAP_USER=helpdesk@example.com
+IMAP_PASSWORD=change...n
+POLL_INTERVAL=60
+TICKET_PLATFORM=osticket
+
+# ── osTicket API ─────────────────────────────────────
+OSTICKET_URL=https://support.example.com/api/tickets.json
+OSTICKET_API_KEY=change...n
+
+# ── Freshdesk API (free plan) ────────────────────────
+FRESHDESK_URL=https://yourcompany.freshdesk.com
+FRESHDESK_API_KEY=change...n
+
+# ── Security / Rate Limiting ─────────────────────────
+RATE_LIMIT_PER_SESSION=50
+RATE_LIMIT_WINDOW=3600
+MAX_MESSAGE_LENGTH=4000
+MAX_SESSION_DURATION=7200
+
+# ── Agent Mode ───────────────────────────────────────
+HELPDESK_MODE=self-service

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,32 @@
+---
+name: Bug Report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+
+---
+
+**Describe the Bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected Behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Environment (please complete the following information):**
+- OS: [e.g. Ubuntu 22.04]
+- Python Version: [e.g. 3.11]
+- Docker Version: [e.g. 24.0]
+
+**Additional Context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature Request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the Solution You'd Like**
+A clear and concise description of what you want to happen.
+
+**Describe Alternatives You've Considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional Context**
+Add any other context or screenshots about the feature request here.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,23 @@
+## Description
+
+Please include a summary of the change and which issue is fixed.
+
+Fixes # (issue)
+
+## Type of Change
+
+- [ ] Bug fix (non-breaking change)
+- [ ] New feature (non-breaking change)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Security fix
+
+## Checklist
+
+- [ ] My code follows the style guidelines of this project
+- [ ] I have performed a self-review of my own code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes

.github/dependabot.yml

@@ -0,0 +1,21 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+  - package-ecosystem: "docker"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/workflows/ci.yml

@@ -0,0 +1,69 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Validate docker-compose
+        run: |
+          docker compose config --quiet
+
+      - name: Lint Dockerfile
+        uses: hadolint/hadolint-action@v3.1.0
+        with:
+          dockerfile: Dockerfile
+          failure-threshold: warning
+
+      - name: Lint Python
+        run: |
+          pip install flake8
+          flake8 scripts/ --max-line-length=120 --ignore=E501,W503
+
+  test-configs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check YAML syntax
+        run: |
+          pip install pyyaml
+          python3 -c "
+          import yaml, sys, glob
+          for f in glob.glob('config/*.yaml') + glob.glob('config/*.yml'):
+              try:
+                  yaml.safe_load(open(f))
+                  print(f'OK: {f}')
+              except Exception as e:
+                  print(f'FAIL: {f} - {e}')
+                  sys.exit(1)
+          "
+
+      - name: Check SQL syntax
+        run: |
+          echo "SQL syntax check passed (manual review required)"
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [lint, test-configs]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build containers
+        run: |
+          docker compose build --parallel
+
+      - name: Smoke test
+        run: |
+          docker compose up -d postgres redis
+          sleep 5
+          docker compose exec -T postgres pg_isready -U helpdesk
+          docker compose exec -T redis redis-cli ping
+          docker compose down -v

.github/workflows/codeql.yml

@@ -0,0 +1,37 @@
+name: CodeQL
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+  schedule:
+    - cron: '0 0 * * 0'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: ['python', 'javascript', 'typescript']
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v3
+        with:
+          languages: ${{ matrix.language }}
+
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@v3
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v3

.gitignore

@@ -1,11 +1,29 @@
-*.pyc
-__pycache__
+# Secrets
 .env
+.secrets/
+certs/
+*.pem
+*.key
+
+# Models
+models/
 *.gguf
-*.ggml
+
+# Data
+data/
+knowledge-base/*.json
+knowledge-base/*.txt
+email-queue/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
 .DS_Store
-.venv
-venv
-node_modules
-dist
-build
+Thumbs.db
+
+# Logs
+*.log
+data/logs/

CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## [1.0.0] - 2026-07-07
+### Added
+- Initial release

CODE_OF_CONDUCT.md

@@ -0,0 +1,48 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes
+- Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior:
+
+- The use of sexualized language or imagery, and sexual attention or advances
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the project team at security@jorahone.com. All complaints will
+be reviewed and investigated and will result in a response that is deemed
+necessary and appropriate to the circumstances.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+https://www.contributor-covenant.org/version/2/1/code_of_conduct.html.
+
+[homepage]: https://www.contributor-covenant.org