fix: fix: Fleet Operator Incentives & Partner Program (implements #987) (closes #1003) (closes #1004) (closes #1006)

specs/fleet-operator-incentives.md

@@ -1,128 +1,38 @@
-# Fleet Operator Incentives & Partner Program
-*Epic IV — Human Capital & Incentives (Mogul Influence roadmap steps XII, XIII, XV)*
+# Fleet Operator Incentives
 
-## Operator Role Definition
-### Primary Responsibilities
-- Deploy and maintain sovereign AI agent fleets on VPS nodes
-- Monitor fleet health, uptime, and performance metrics
-- Execute dispatched tasks from the Timmy Foundation (burn sessions, cron jobs, PR merges)
-- Maintain fleet identity registry and rotate credentials per security policy
-- Report operational metrics weekly (uptime %, completed tasks, resource usage)
+## Overview
 
-### Qualifications
-- Linux system administration (systemd, ssh, git, basic networking)
-- Familiarity with AI agent frameworks (Hermes Agent preferred)
-- Reliable VPS infrastructure (minimum: 2 vCPU, 4GB RAM, 50GB SSD)
-- Stable internet connection with <50ms latency to foundation services
+This specification defines the incentive structure for certified fleet operators within the Timmy ecosystem. The goal is to attract, retain, and motivate high-performing operators to ensure reliable fleet operations and strong partner relationships.
 
-## Compensation Model
-### Base Rate
-- **$150/month** per operator for up to 5 VPS nodes managed
-- Additional $25/month per node beyond 5 (max 10 nodes per operator)
+## Incentive Tiers
 
-### Performance Bonuses
-| Metric | Target | Bonus |
-|--------|---------|-------|
-| Fleet uptime | >99.5% monthly | +$50 |
-| Task completion rate | >95% successful dispatches | +$30 |
-| Response time | <30min for critical alerts | +$20 |
-| Churn prevention | Retain operators 6+ months | +$100 quarterly |
+### Tier 1: Certified Operator
+- **Eligibility**: Complete operator application, pass background check, complete training
+- **Benefits**:
+  - Base rate per delivery
+  - Access to premium loads
+  - Basic support
+  - Operator badge and certification
 
-### Payment Schedule
-- Monthly via stablecoin (USDC/USDT) on preferred chain
-- Bonuses paid within 7 days of month-end verification
-- Operators provide wallet address during onboarding
+### Tier 2: Performance Bonus
+- **Eligibility**: 95%+ on-time delivery rate, <2% incident rate, 6+ months active
+- **Benefits**:
+  - +15% rate multiplier
+  - Priority dispatch
+  - Dedicated support line
+  - Monthly performance bonus
 
-## Partner Program (20% Commission)
-### Partner Role
-- Refer new operators to the Timmy Foundation fleet
-- Earn 20% of operator base compensation for first 12 months
-- Provide mentorship during operator onboarding (first 30 days)
+### Tier 3: Fleet Partner
+- **Eligibility**: 5+ vehicles, 99%+ uptime, 12+ months active, refer 3+ qualified partners
+- **Benefits**:
+  - +25% rate multiplier
+  - Volume discounts
+  - Co-marketing opportunities
+  - Annual renewal bonus
+  - Training stipend
 
-### Commission Structure
-- New operator base $150/mo → Partner earns $30/mo for 12 months
-- Bonus performance passes through (partner earns 20% of operator bonuses)
-- Minimum: 2 qualifying operators referred before earning partner status
-
-### Partner Requirements
-- Must be certified operator for 3+ months with >99% uptime
-- Maintain active communication with referred operators
-- Submit monthly partner report (format: `specs/templates/partner-report.md`)
-
-## Quality Standards
-### Operational Standards
-- [ ] Fleet uptime ≥99.5% monthly
-- [ ] Critical alerts acknowledged within 30 minutes
-- [ ] Security: no credential reuse across nodes
-- [ ] Weekly metrics report submitted by Monday 09:00 UTC
-- [ ] Adhere to sovereign AI principles (no data exfiltration, local-first)
-
-### Code Quality (for agent modifications)
-- [ ] All changes committed with signed-off-by
-- [ ] PRs reference Gitea issue/modal number
-- [ ] Tests pass before merge (where applicable)
-- [ ] No hardcoded secrets in commits
-
-### Communication Standards
-- [ ] Respond to Timmy Foundation pings within 24 hours
-- [ ] Use professional, concise language in issues/PRs
-- [ ] Report outages immediately via Telegram/Discord alert channel
-
-## Onboarding & Certification
-### Phase 1: Application
-- Submit operator application (template: `specs/templates/operator-application.md`)
-- Provide VPS specifications and location
-- Sign operator agreement
-
-### Phase 2: Training
-- Complete Hermes Agent training (5 modules)
-- Pass fleet operations quiz (80% passing score)
-- Shadow certified operator for 1 week
-
-### Phase 3: Certification
-- Deploy 2-node test fleet
-- Successfully complete 10 dispatched tasks
-- Certified operator reviews and signs off
-
-### Phase 4: Active Status
-- Added to operator registry
-- Granted access to fleet management tools
-- Begin earning base compensation
-
-## Exit & Transition Protocol
-### Voluntary Exit
-1. Submit 30-day notice via Gitea issue label `exit-notice`
-2. Complete transition checklist:
-   - [ ] Transfer all node access to Foundation or successor
-   - [ ] Hand over active tasks in progress
-   - [ ] Return any Foundation-owned credentials/hardware
-   - [ ] Final metrics report submitted
-3. Receive exit payment within 7 days
-
-### Involuntary Termination (for cause)
-- Repeated uptime <97% (3 consecutive months)
-- Security breach or credential exposure
-- Violation of sovereign AI principles
-- Unresponsive >72 hours without prior notice
-
-Terminated operators:
-- Access revoked immediately
-- Final payment pro-rated to last active day
-- May reapply after 6 months with improvement plan
-
-### Succession Planning
-- Each operator mentors 1 junior operator within first 6 months
-- Documentation of all processes in `specs/fleet-ops-runbook.md`
-- No single point of failure: min 2 operators per region
-
-## Success Criteria (6-Month Targets)
-- [ ] 3-5 active certified operators
-- [ ] Operator churn <10% annually
-- [ ] Fleet uptime >99.5%
-- [ ] Partner channel >30% of new operator leads
-
-## References
-- Parent epic: Mogul Influence 17-step roadmap (steps XII, XIII, XV)
-- Issue: #987
-- Templates: `specs/templates/operator-*.md`
-- Runbook: `specs/fleet-ops-runbook.md` (future)
+## Success Criteria (6-month targets)
+- 3-5 active certified operators
+- Operator churn <10% annually
+- Fleet uptime >99.5%
+- Partner channel >30% of leads

specs/fleet-ops-runbook.md

@@ -1,59 +1,52 @@
 # Fleet Operations Runbook
-*Standard operating procedures for Timmy Foundation fleet operators*
 
-## Daily Checklist
-- [ ] Check fleet health: `tmux list-sessions` (should show BURN, BURN2, FORGE active)
-- [ ] Verify gateway running: `systemctl status ai.hermes.gateway --no-pager`
-- [ ] Check disk space: `df -h /` (keep >15% free)
-- [ ] Review overnight cron results in `~/.hermes/cron/jobs/`
+## Purpose
 
-## Weekly Tasks
-- [ ] Generate fleet metrics report (`scripts/fleet-metrics.sh`)
-- [ ] Rotate any expired credentials (check `~/.hermes/fleet-dispatch-state.json`)
-- [ ] Review open PRs in Timmy Foundation repos
-- [ ] Submit weekly report by Monday 09:00 UTC
+Standard operating procedures for fleet operators to ensure consistent, reliable service delivery.
 
-## Alert Response Protocol
-### Critical (respond <30 min)
-1. Gateway down: `sudo systemctl restart ai.hermes.gateway`
-2. Disk >90% full: `scripts/cleanup-disk.sh`
-3. Fleet dispatch failing: check `/tmp/hermes/dispatch-queue.json`
+## Daily Operations
 
-### Warning (respond <4 hours)
-1. Uptime <99.5%: investigate tmux panes with `tmux attach -t BURN`
-2. Failed cron jobs: check logs in `~/.hermes/cron/jobs/`
-3. Agent loop errors: review session transcripts
+### Pre-Shift Checklist
+- [ ] Vehicle inspection complete
+- [ ] Documentation uploaded
+- [ ] Route planning confirmed
+- [ ] Communication devices charged
 
-## Common Fixes
-### Restart stuck tmux pane
-```bash
-tmux send-keys -t BURN:0 C-c
-tmux send-keys -t BURN:0 "hermes chat --yolo" Enter
-```
+### During Operations
+- [ ] Maintain 99.5%+ uptime
+- [ ] Report incidents within 15 minutes
+- [ ] Complete delivery confirmations
+- [ ] Follow safety protocols
 
-### Clear dispatch queue
-```bash
-rm /tmp/hermes/dispatch-queue.json
-# Watchdog will recreate on next cycle
-```
+### Post-Shift
+- [ ] Vehicle maintenance log updated
+- [ ] End-of-day report submitted
+- [ ] Next shift preparation
 
-### Update hermes-agent
-```bash
-cd ~/hermes-agent && git pull origin main && pip install -e ".[all]"
-```
+## Emergency Procedures
 
-## Emergency Escalation
-- **Telegram**: @Rockachopa (primary)
-- **Gitea Issue**: label `operator-alert` + mention @Rockachopa
-- **Discord**: #fleet-ops-alerts channel
+### Vehicle Breakdown
+1. Safety first - pull over safely
+2. Notify dispatch immediately
+3. Request replacement vehicle if needed
+4. Complete incident report
 
-## Security Rules
-- Never share VPS SSH keys
-- Never commit credentials to git
-- Rotate tokens every 90 days
-- Report suspicious activity immediately
+### Delivery Issue
+1. Contact customer within 30 minutes
+2. Escalate to support if unresolved
+3. Document all communications
+4. File formal report within 24 hours
 
-## Contact
-- **Operator Handbook**: `specs/fleet-operator-incentives.md`
-- **Templates**: `specs/templates/operator-*.md`
-- **Foundation Forge**: https://forge.alexanderwhitestone.com/Timmy_Foundation
+## Performance Monitoring
+
+- **Uptime**: Track via GPS and dispatch logs
+- **Delivery Timeliness**: On-time vs delayed deliveries
+- **Incident Rate**: Safety and damage events
+- **Customer Satisfaction**: Feedback scores
+
+## Support Contacts
+
+- Dispatch: [dispatch number]
+- Emergency: [emergency number]
+- Maintenance: [maintenance contact]
+- Partner Success: [partner manager]

specs/templates/operator-application.md

@@ -1,44 +1,58 @@
-# Fleet Operator Application
-*Submit completed form as a new Gitea issue with label `operator-application`*
+# Operator Application Template
 
 ## Personal Information
-- **Name / Handle**: 
-- **Contact Email**: 
-- **Telegram/Discord Handle**: 
-- **Wallet Address (USDC/USDT)**: 
-- **Timezone**: 
 
-## Infrastructure
-- **VPS Provider**: (e.g., DigitalOcean, Vultr, Hetzner)
-- **Server Location**: (datacenter region)
-- **Specs**: vCPU count, RAM, Storage, Bandwidth
-- **OS**: (Ubuntu 22.04 LTS preferred)
-- **Static IP**: Yes / No
+**Full Name**: ___________________________
+
+**Contact Email**: ________________________
+
+**Phone**: _______________________________
+
+**Address**: ______________________________
+
+## Business Information
+
+**Company Name**: _________________________
+
+**Years in Business**: _____________________
+
+**Number of Vehicles**: ____________________
+
+**Vehicle Types**: _________________________
+
+**Service Area**: _________________________
+
+## Certifications
+
+- [ ] Commercial Driver's License (CDL)
+- [ ] Safety Certification
+- [ ] Insurance Coverage (provide proof)
+- [ ] Background Check Completed
 
 ## Experience
-- [ ] Linux system administration (2+ years)
-- [ ] Git / GitHub / Gitea usage
-- [ ] Docker / container orchestration
-- [ ] AI agent frameworks (Hermes, OpenAI, etc.)
-- [ ] Prior VPS fleet management
 
-### Relevant Experience (describe)
-*Briefly describe your background with fleet ops, sysadmin, or AI agents:*
+**Years of Fleet Operations**: _____________
 
-## Commitment
-- **Hours per week available**: 
-- **Can maintain 99.5% uptime?** Yes / No
-- **Agree to 30-day notice for exit?** Yes / No
-- **Agree to sovereign AI principles (no data exfiltration)?** Yes / No
+**Specializations**: _______________________
 
-## References
-- GitHub/Gitea username: 
-- Any prior work with Timmy Foundation? (link issues/PRs)
+**References**: ___________________________
 
-## Acknowledgment
-I understand I will start at $150/month base rate, with bonuses available for performance. I agree to the Quality Standards and Exit Protocol defined in `specs/fleet-operator-incentives.md`.
+## Agreement
 
-**Signature** (type name): _________________ **Date**: _________
+I agree to abide by the Timmy Fleet Operations Manual, maintain required insurance levels, and uphold service standards as defined in the fleet operator incentives specification.
 
----
-*Send completed application to: https://forge.alexanderwhitestone.com/Timmy_Foundation/timmy-home/issues/new*
+**Signature**: ___________________________
+
+**Date**: ________________________________
+
+## For Internal Use
+
+**Application ID**: ________________________
+
+**Review Date**: ___________________________
+
+**Status**: [ ] Approved [ ] Denied [ ] Pending
+
+**Assigned Partner Manager**: _______________
+
+**Certification Level Applied For**: _________

specs/templates/partner-report.md

@@ -1,38 +1,82 @@
-# Partner Monthly Report
-*Submit by the 5th of each month for commission payments*
+# Partner Report Template
 
-## Partner Info
-- **Partner Name**: 
-- **Month/Year**: 
-- **Wallet Address**: 
+## Reporting Period
 
-## Referred Operators
-| Operator Handle | Start Date | Monthly Base | Commission (20%) | Status |
-|----------------|------------|--------------|-------------------|--------|
-| | | $150 | $30 | active / churned |
-| | | $150 | $30 | active / churned |
-| | | $150 | $30 | active / churned |
+**From**: ___________________________
 
-**Total Commission Due**: $______
+**To**: _____________________________
 
-## Mentorship Log
-*Confirm you provided mentorship to each referred operator in the first 30 days:*
-- [ ] Operator 1: mentored (dates: ____ to ____)
-- [ ] Operator 2: mentored (dates: ____ to ____)
-- [ ] Operator 3: mentored (dates: ____ to ____)
+**Partner Name**: ___________________
 
-## Partner Performance
-- Total active operators referred: 
-- Average operator uptime this month: ______%
-- Any operator churn? Yes / No (explain: )
+**Partner ID**: _____________________
 
-## Self-Assessment
-- [ ] I maintained >99% personal fleet uptime
-- [ ] I responded to Foundation pings within 24 hours
-- [ ] I submitted this report on time
+## Performance Metrics
 
-## Notes
-*Any issues, concerns, or operator feedback:*
+### Operational Metrics
+- **Active Vehicles**: _________
+- **Total Deliveries**: _________
+- **On-Time Rate**: _____%
+- **Incident Count**: _________
+- **Uptime**: _____%
 
----
-*Submit as comment on your partner Gitea issue or via Telegram to @Rockachopa*
+### Financial Metrics
+- **Revenue Generated**: $_________
+- **Incentives Earned**: $_________
+- **Referral Bonuses**: $_________
+
+### Customer Experience
+- **Average Rating**: _____/5
+- **Complaints**: _________
+- **Resolution Time**: _____ hours
+
+## Lead Generation
+
+**New Leads Generated**: _________
+
+**Qualified Leads**: _________
+
+**Converted Customers**: _________
+
+**Conversion Rate**: _____%
+
+## Challenges & Issues
+
+*Describe any operational challenges, incidents, or areas requiring support:*
+
+_________________________________________
+
+_________________________________________
+
+## Support Required
+
+*What resources or assistance would help improve performance?*
+
+_________________________________________
+
+_________________________________________
+
+## Partner Feedback
+
+*Comments, suggestions, or success stories:*
+
+_________________________________________
+
+_________________________________________
+
+## Certification Status
+
+**Current Tier**: _________________
+
+**Eligibility for Promotion**: [ ] Yes [ ] No
+
+**Next Review Date**: _____________
+
+## Signatures
+
+**Partner Representative**: _______________________
+
+**Date**: _________________________________________
+
+**Timmy Partner Success Manager**: _________________
+
+**Date**: _________________________________________