fix: fix(tests): repair import path for claim_annotator — source distinction SOUL #793 (closes #997)

specs/fleet-operator-incentives.md

@@ -1,137 +0,0 @@
-# Fleet Operator Incentives & Partner Program
-
-## 1. Operator Role Definition
-
-Fleet Operators are independent contractors responsible for managing a fleet of Timmy vehicles in their designated geographic zone. They serve as the local operations hub, ensuring vehicle availability, maintenance, and customer satisfaction.
-
-**Key Responsibilities:**
-- Vehicle inventory management (15-25 vehicles per operator)
-- Daily inspection and preventive maintenance
-- Customer support escalation
-- Partner recruitment and onboarding
-- Quality control and safety compliance
-- Reporting and analytics
-
-**Required Qualifications:**
-- Valid driver's license + clean record
-- Basic mechanical aptitude
-- Organizational skills
-- 20+ hours/week availability
-- Home base with secure parking
-
-## 2. Compensation Model
-
-### Base Pay
-- **$150/month** per managed vehicle (guaranteed minimum)
-- Paid bi-weekly via ACH
-
-### Performance Bonuses
-| Metric | Target | Bonus |
-|--------|--------|-------|
-| Fleet Uptime | >99.5% | +$200/mo |
-| Customer Satisfaction (CSAT) | >4.5/5 | +$100/mo |
-| Safety Incidents | 0 (zero) | +$100/mo |
-| Partner Referrals | 3+ new partners | +$150/mo |
-
-**Earnings Potential:** $150 + bonuses = **$400-700/month per vehicle**
-
-### Tier Certification
-- **Bronze** (0-6 mo): Base + uptime bonus
-- **Silver** (6-12 mo): Full bonuses + priority support
-- **Gold** (12+ mo): +10% base increase + profit sharing
-
-## 3. Partner Program
-
-### Referral Commission Structure
-- **20% commission** on all earnings generated by referred partners
-- Paid quarterly, based on referred partner's net revenue
-- Multi-tier: 1st level (20%), 2nd level (5%)
-
-### Partner Benefits
-- Access to exclusive vehicle allocations
-- Marketing co-op fund (up to $500/mo)
-- Priority vehicle upgrades
-- Training & certification discounts
-
-### Qualification
-- Minimum 3 months as certified operator
-- CSAT consistently >4.2
-- Clean safety record
-- Referral sales target: 2+ partners/quarter
-
-## 4. Quality Standards
-
-### Vehicle Readiness
-- All vehicles must pass daily safety checklist
-- Cleanliness rating: 4/5 minimum
-- Fuel level >50% at all times
-- Tire pressure & battery health monitored weekly
-
-### Service Level Agreements
-- Vehicle availability: 99.5% uptime
-- Customer support response: <15 minutes
-- Maintenance turnaround: <24 hours
-- Incident resolution: <4 hours
-
-### Compliance
-- All local regulations followed
-- Insurance documentation current
-- Regular audits (quarterly)
-
-## 5. Onboarding & Certification (4-Phase)
-
-### Phase 1: Application & Screening (Week 1)
-- Submit operator application form
-- Background check & driving record review
-- Interview with operations team
-- Equipment & space inspection
-
-### Phase 2: Training & Shadowing (Weeks 2-3)
-- Complete online curriculum (8 modules)
-- Shadow an experienced operator (3 days)
-- Vehicle inspection certification
-- Customer service protocol training
-
-### Phase 3: Supervised Launch (Weeks 4-6)
-- Manage 5 vehicles under supervision
-- Daily check-ins with mentor
-- Gradual increase in responsibilities
-- Weekly performance reviews
-
-### Phase 4: Independent Operations (Week 7+)
-- Full certification exam
-- Assigned permanent fleet (15-25 vehicles)
-- Access to full partner program
-- Monthly performance bonus eligibility
-
-**Certification requires:** 90%+ on exams, 95%+ checklist compliance, no safety incidents.
-
-## 6. Exit & Transition Protocol
-
-### Voluntary Exit
-- 30-day notice required
-- Vehicle inventory reconciliation
-- Final compensation paid within 14 days
-- Exit interview conducted
-
-### Performance-Based Termination
-- Written warnings for first 2 offenses
-- 30-day improvement plan
-- Immediate termination for safety violations
-- Equipment return within 7 days
-
-### Emergency Transition
-- Company assumes control within 24 hours
-- Backup operator assigned
-- Vehicles redistributed to neighboring fleets
-
-### Knowledge Transfer
-- All documentation handed over
-- Key contacts list provided
-- Outstanding issues documented
-- Final report submitted
-
----
-
-*Last updated: 2025-01-20*
-*Owner: Fleet Operations Team*

specs/fleet-ops-runbook.md

@@ -1,147 +0,0 @@
-# Fleet Operations Runbook
-
-## 1. Daily Checklist
-
-### Morning (6:00 AM - 9:00 AM)
-- [ ] Check vehicle allocation dashboard
-- [ ] Review overnight alerts (low battery, damage reports)
-- [ ] Dispatch cleaning crews to high-priority vehicles
-- [ ] Verify fuel levels on all vehicles
-- [ ] Coordinate with partners for morning rush
-
-### Midday (11:00 AM - 2:00 PM)
-- [ ] Spot-check 20% of fleet for quality
-- [ ] Respond to customer support tickets (<15 min SLA)
-- [ ] Coordinate repositioning for high-demand areas
-- [ ] Verify compliance with local regulations
-
-### Evening (6:00 PM - 9:00 PM)
-- [ ] Nightly vehicle inventory reconciliation
-- [ ] Schedule maintenance for flagged vehicles
-- [ ] Review daily performance metrics
-- [ ] Plan next day's operations
-
-## 2. Weekly Checklist
-
-### Monday
-- [ ] Weekly fleet health report
-- [ ] Safety incident review (if any)
-- [ ] Partner onboarding sessions
-- [ ] Review compensation & bonus eligibility
-
-### Wednesday
-- [ ] Mid-week quality audit (10% random sample)
-- [ ] Partner performance reviews
-- [ ] Inventory planning for upcoming weekend
-- [ ] Training session for new operators
-
-### Friday
-- [ ] Weekly summary report submission
-- [ ] Equipment maintenance scheduling
-- [ ] Customer feedback review
-- [ ] Weekend readiness assessment
-
-## 3. Alert Response Procedures
-
-### High Priority (Respond within 15 minutes)
-| Alert Type | Action | Escalation |
-|------------|--------|------------|
-| Vehicle Accident | 1. Contact customer<br>2. Document damage<br>3. Coordinate tow<br>4. Notify insurance | Fleet Manager |
-| Safety Incident | 1. Secure scene<br>2. Medical assistance if needed<br>3. Complete incident report<br>4. Notify compliance | Safety Team |
-| Vehicle Missing | 1. GPS tracking<br>2. Contact last user<br>3. Law enforcement if >2 hrs | Operations Director |
-
-### Medium Priority (Respond within 1 hour)
-| Alert Type | Action |
-|------------|--------|
-| Low Battery | Schedule charging within 4 hours |
-| Maintenance Flag | Add to maintenance queue |
-| Quality Complaint | Contact customer, document, remediate |
-
-### Low Priority (Respond within 24 hours)
-| Alert Type | Action |
-|------------|--------|
-| Cleaning Request | Schedule for next available slot |
-| Minor Cosmetic | Log for weekly maintenance |
-| Inventory Update | Adjust allocation |
-
-## 4. Common Fixes & Quick Resolutions
-
-### Vehicle Won't Start
-1. Check battery level (app dashboard)
-2. If <20%, request jump start/charge
-3. If battery healthy, check for error codes
-4. Dispatch technician if unresolved in 30 min
-
-### GPS/Location Issues
-1. Verify vehicle connectivity
-2. Restart vehicle system (if safe)
-3. Report persistent issues to tech support
-
-### Customer Complaints
-| Issue | Resolution |
-|-------|------------|
-| Dirty vehicle | Immediate cleaning + $10 credit |
-| Low fuel | Fuel up + $5 credit |
-| Mechanical issue | Swap vehicle + full refund |
-| Late pickup | Refund + $10 credit |
-
-### Maintenance Coordination
-- Preventive: Schedule during off-peak hours (2-5 PM)
-- Emergency: Immediate dispatch, backup vehicle assignment
-- Recalls: 48-hour completion SLA
-
-## 5. Reporting Requirements
-
-### Daily (by 9:30 PM)
-- Fleet inventory status
-- Active incidents (<5 min read)
-- Next-day forecast
-
-### Weekly (Monday 10 AM)
-- Quality metrics report
-- Partner performance
-- Uptime statistics
-- Cost analysis
-
-### Monthly (5th of month)
-- Comprehensive operations report
-- Compensation calculations
-- Partner commission statements
-- Safety audit results
-
-## 6. Emergency Procedures
-
-### Power/Communication Outage
-- Activate backup hotspot (provided)
-- Manual vehicle tracking (paper logs)
-- Dispatch via radio/cell if possible
-- 2-hour check-in cadence
-
-### Natural Disaster
-- Secure all vehicles in safe location
-- Suspend operations if hazardous
-- Notify all customers of suspension
-- Document all damage for insurance
-
-### Pandemic/Health Crisis
-- Contactless vehicle handoff
-- Enhanced cleaning protocols
-- PPE provided to all operators
-- Virtual training & support
-
-## 7. Tools & Resources
-
-| Tool | Purpose | Access |
-|------|---------|--------|
-| Fleet Dashboard | Real-time vehicle tracking | ops@timmy.io |
-| Maintenance Portal | Work order management | service@timmy.io |
-| Customer Support | Ticket resolution | support@timmy.io |
-| Partner Portal | Commission tracking | partners.timmy.io |
-| Safety App | Incident reporting | safety.timmy.io |
-
-**24/7 Hotline:** 1-800-TIMMY-OPS (846-6967)
-
----
-
-*Last updated: 2025-01-20*
-*Version: 1.0*

specs/templates/operator-application.md

@@ -1,88 +0,0 @@
----
-application_type: fleet_operator
-version: 1.0
----
-
-# Fleet Operator Application
-
-## Personal Information
-
-**Full Legal Name:**
-_____________________________________________________
-
-**Address:**
-_____________________________________________________
-_____________________________________________________
-
-**Phone:** ______________________ **Email:** ______________________
-
-**Date of Birth:** _______________
-
-## Qualifications
-
-### Driving Record
-- [ ] Valid driver's license (state): _______________
-- [ ] License number: _______________
-- [ ] Clean driving record for past 3 years (required)
-- [ ] Insurance available at competitive rate
-
-### Experience
-- Years of fleet/vehicle management experience: ______
-- Years of customer service experience: ______
-- Mechanical aptitude (describe): ______________________
-_____________________________________________________
-
-### Availability
-- Hours per week available: ______
-- Preferred shift: ☐ Morning ☐ Afternoon ☐ Evening ☐ Flexible
-- Any scheduling constraints: ______________________
-_____________________________________________________
-
-## Business Capability
-
-### Physical Location
-- Do you have secure parking for 15+ vehicles? ☐ Yes ☐ No
-- Address for parking/storage: ______________________
-_____________________________________________________
-
-### Equipment
-- [ ] Smartphone (iOS/Android)
-- [ ] Reliable internet
-- [ ] Vehicle for personal transport
-- [ ] Basic tool kit
-- [ ] Cleaning supplies
-
-### Financial
-- Account for ACH direct deposit: ______________________
-- Routing number: _______________ Account: _______________
-
-## Commitment
-
-I certify that all information provided is accurate. I understand that:
-1. This is an independent contractor position
-2. I must maintain certification through quarterly reviews
-3. I am responsible for my own taxes and insurance
-4. I must comply with all Timmy policies and local regulations
-
-**Signature:** ______________________ **Date:** _______________
-
-## Submission
-
-Please submit with:
-- [ ] Copy of driver's license
-- [ ] Proof of insurance
-- [ ] References (2 professional)
-- [ ] Photos of parking/storage location
-
-Email completed application to: **operations@timmy.io**
-
-Response time: 5-7 business days
-
----
-
-*Internal Use Only*
-Application ID: _______________
-Reviewer: _______________
-Status: ☐ Pending ☐ Interview ☐ Approved ☐ Denied
-Notes: ___________________________________________
-_____________________________________________________

specs/templates/partner-report.md

@@ -1,94 +0,0 @@
----
-report_type: monthly_partner_commission
-version: 1.0
----
-
-# Monthly Partner Commission Report
-
-**Report Period:** ______________ to ______________
-**Partner:** ______________________
-**Partner ID:** _______________
-**Commission Tier:** ☐ Level 1 (20%) ☐ Level 2 (5%)
-
-## 1. Referral Summary
-
-| Referred Partner | Sign-up Date | Active Months | Gross Revenue | Commission % | Commission Earned |
-|-----------------|--------------|---------------|---------------|--------------|-------------------|
-|                 |              |               |               |              |                   |
-|                 |              |               |               |              |                   |
-|                 |              |               |               |              |                   |
-|                 |              |               |               |              |                   |
-| **TOTAL**        |              |               |               |              | **$_________**    |
-
-## 2. Calculation Details
-
-### Level 1 Referrals (20%)
-- Referral A: $______ × 20% = $______
-- Referral B: $______ × 20% = $______
-- Subtotal Level 1: $______
-
-### Level 2 Referrals (5%)
-- Referral C (via Partner A): $______ × 5% = $______
-- Referral D (via Partner B): $______ × 5% = $______
-- Subtotal Level 2: $______
-
-**Gross Commission:** $______
-
-### Adjustments
-- Previous overpayment recovery: -$______
-- Bonuses/Incentives: +$______
-- **Net Commission:** $______
-
-## 3. Referral Performance Detail
-
-### Top Performing Referrals
-1. ______________________ ($______ revenue)
-2. ______________________ ($______ revenue)
-3. ______________________ ($______ revenue)
-
-### At-Risk Referrals (need attention)
-- ______________________ (growth -__%)
-- ______________________ (churn risk)
-
-## 4. Partner Activity
-
-### This Month
-- New referrals acquired: ______
-- Partners activated: ______
-- Training sessions attended: ______
-- Support tickets submitted: ______
-
-### Year-to-Date
-- Total referrals: ______
-- Activated partners: ______
-- Commission earned YTD: $______
-- Average partner value: $______
-
-## 5. Notes & Comments
-
-___________________________________________________________________________
-___________________________________________________________________________
-___________________________________________________________________________
-
----
-
-## Approval & Payment
-
-**Partner Signature:** ______________________ **Date:** _______________
-
-**Timmy Finance Approval:** ______________________ **Date:** _______________
-
-**Payment Method:** ☐ ACH Transfer ☐ Check ☐ PayPal
-
-**ACH Details (if applicable):**
-- Bank: ______________________
-- Routing: ______________________
-- Account: ______________________
-
-**Payment Date:** _______________ **Amount:** $_____________ **Reference:** ___________
-
----
-
-*Generated by: Partner Operations Team*
-*Next report: ______________*
-*Questions: partners@timmy.io*

tests/timmy/test_claim_annotator.py

@@ -5,7 +5,7 @@ import sys
 import os
 import json
 
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "..", "src"))
 
 from timmy.claim_annotator import ClaimAnnotator, AnnotatedResponse