.github/copilot-instructions.md

# .github/copilot-instructions.md — moltbot-hybrid-engine (HF Space B)
# SYNCED FILE — Source: courtBundleGenerator2/scripts/sync_agent_docs.sh
# DO NOT EDIT HERE — edit source and re-run sync_agent_docs.sh

## This Repo: moltbot-hybrid-engine (HF Space B)
- **Role:** Local clone of HF Space deebee7/moltbot-hybrid-engine. Ollama + Qwen 2.5 brain. Edit locally, push to deploy.
- **Entrypoint:** `app.py (FastAPI + Ollama)`
- **Output dir:** `https://deebee7-moltbot-hybrid-engine.hf.space (cloud — not local)`

## Architecture Reference
See: `memory-bank/ARCHITECTURE.md` (synced to this repo)

## Absolute Rules (All Repos)
- NO placeholders, TODOs, or incomplete logic — implement fully or stop
- NO standalone scripts — fix files in place only (no temp_fix.py, wrapper_v2.py)
- NO compliance checks that block discovery, embedding, or bundle output
- NO force push: `git push --force` is prohibited
- DRY: reuse FileResolutionBridge, UnifiedEvidenceBridge, existing processors — never duplicate logic
- NEVER use `./local_output` — always use the full absolute output path above
- Before claiming complete: run `ls -lh` on output PDFs + check `missing_evidence_summary.json`
- Every claim requires CLI proof (`ls`, `cat`, `grep`) — no assumptions, no "most likely"

## Exhibit & DB Reference (Court Format — MANDATORY FOR ALL LEGAL DOCS)
- Required format: **Exhibit [Bundle letter][Number] (DB-[N]) — [Filename]**
- Example: Exhibit G7 (DB-125) — 16_12_25_Lamberth_Email_Complaint_Response_Rent_account_UFN40981138.pdf
- Exhibit number = bundle letter + sequential (e.g. A15, G7) — set by bundler only, never overwritten
- DB reference = DB-[N] (e.g. DB-125) — set by `lib/db_registry.py` only, never used as exhibit number
- Filename MUST be included — DB number alone is not adequate for any doc receiving amendments/edits/insertions
- NEVER use bare "DB-[●]" or "Exhibit DB-[Number]" as the main identifier
- NEVER leave "DB-[●]" unresolved in final text — resolve before filing
- Resolve using: `legal_emails/Phase8/DB_Evidence_List.txt` (DB → filename) + bundle output (DB → Exhibit letter+number)
- Full instruction: `prompts/legal_exhibit_instruction.txt` (synced to this repo)
- Engine endpoint: GET https://deebee7-moltbot-hybrid-engine.hf.space/prompts/legal-exhibit-instruction

## Protected Files (Never overwrite without explicit permission in capitals)
- `enhanced_bundler_wrapper.patched.py`
- `create_proper_embedded_bundle.py`
- `generate_bundles_final_corrected.py`
- `dual_category_evidence_processor.py`
- `categorize_and_append_v2.py`

## Evidence Discovery (P2 only — but all agents must know this)
- Root: `/home/mrdbo/projects/courtBundleGenerator2/evidence/`
- Policy: FULL RECURSIVE SCAN — no whitelists, no allow-lists
- If any file under the evidence root is not found, discovery is broken — fix the whole scan, not a list

## Hybrid Engine Rules
- This is a DEPLOYMENT TARGET — do not add bundler logic here
- Deploy: `git add -A && git commit -m 'msg' && git push origin main`
- Exposes: /health, /api/generate, /v1/chat/completions, GET /prompts/legal-exhibit-instruction
- SDK: Docker; Ollama installed at runtime via start.sh; Qwen 2.5 pulled in background

## Full Rules
See: `memory-bank/CRITICAL_INSTRUCTIONS.md` (synced to this repo)
See: `AGENT_KNOWLEDGE_BASE_Core_Identity_Standards.md` (synced to this repo)