AI_TOOL_USAGE.md

# ParcelPilot AI System — AI Tool Usage

## 1. AI Coding Tools Used
- **Antigravity AI Assistant (Powered by Gemini 3.6 Flash)**: Used end-to-end for architecture design, document parsing, backend Python implementation, test suite generation, and frontend styling.

## 2. How Tools Were Applied
1. **Data Pack Extraction**: Automated parsing of PDF files (`pypdf`) and Excel workbook structures (`openpyxl`/`pandas`).
2. **Core System Implementation**: Engineered the FastAPI backend, security access control layer (`security.py`), document authority matrix (`document_indexer.py`), tool suite (`tools.py`), agent reasoning engine (`agent_engine.py`), and proactive issue detector (`proactive_detector.py`).
3. **Frontend UI Development**: Built a sleek dark-mode glassmorphism Web Application (`index.html`, `styles.css`, `app.js`) featuring interactive context switching, step-by-step tool execution traces, human-in-the-loop confirmation modals, and proactive issue dashboards.
4. **Automated Verification**: Created a 100% passing test suite (`tests/test_suite.py`) validating security isolation, contract overrides, SLA breaches, and state-changing action workflows.