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

2026-05-02 08:22:31 -04:00
4 changed files with 685 additions and 215 deletions
--- a/specs/fleet-operator-incentives.md
+++ b/specs/fleet-operator-incentives.md
@@ -1,128 +1,130 @@
 # Fleet Operator Incentives & Partner Program
-*Epic IV — Human Capital & Incentives (Mogul Influence roadmap steps XII, XIII, XV)*

-## 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)
+> Implements Fleet Epic IV: Human Capital & Incentives (Issue #987)
+> Closes #1003

-### 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
+## Overview

-## 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)
+This specification defines the incentive structures, certification pathways, and partner program mechanics for operating and maintaining Timmy Fleet nodes. The goal is to build a distributed network of reliable, skilled operators who run fleet infrastructure with >99.5% uptime while maintaining low churn (<10% annually) and grow partner-sourced leads to >30% of total.

-### 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 |
+## Incentive Tiers

-### 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 1: Certified Operator (Entry)
+- **Eligibility**: Complete Operator Application, pass basic screening, attend training
+- **Compensation**:
+  - Base stipend: $500/month per node
+  - Uptime bonus: +$200/month for >99.5% fleet uptime
+  - Response bonus: +$100/month for <15min average incident response
+  - Churn rebate: -$250/month for early termination (first 6 months)
+- **Expectations**:
+  - Monitor node health 24/7 via Timmy dashboard
+  - Respond to alerts within 15 minutes
+  - Perform weekly maintenance and monthly updates
+  - Submit monthly ops report
+- **Benefits**: Access to operator community, training resources, priority support

-## 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 2: Senior Operator (Experienced)
+- **Eligibility**: 6+ months as Tier 1, >99.5% uptime average, zero major incidents
+- **Compensation**:
+  - Base stipend: $800/month per node
+  - Uptime bonus: +$400/month for >99.8% uptime
+  - Mentorship stipend: +$150/month per junior operator mentored
+  - Performance bonus: Quarterly bonus up to $500 based on metrics
+- **Expectations**:
+  - Mentor 1-2 junior operators
+  - Lead incident reviews
+  - Contribute to runbook improvements
+- **Benefits**: Profit-sharing from referral bonuses, early access to new features

-### 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
+### Tier 3: Fleet Lead (Expert)
+- **Eligibility**: 12+ months, >99.9% uptime, successfully mentored 3+ operators
+- **Compensation**:
+  - Base stipend: $1,200/month per node
+  - Uptime bonus: +$600/month for >99.9% uptime
+  - Team lead bonus: +$300/month for team performance
+  - Revenue share: 2% of partner program revenue from region
+- **Expectations**:
+  - Own regional cluster of nodes
+  - Coordinate multi-node deployments
+  - Interface with Timmy core team on roadmap
+- **Benefits**: Equity eligibility, governance rights, speaking opportunities

-### 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`)
+## Partner Program

-## 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)
+### Partner Tiers

-### 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
+#### Bronze Partner (Referral)
+- Commission: 10% of first-year operator revenue from referred leads
+- Requirements:
+  - Sign partner agreement
+  - Refer 3+ qualified candidates annually
+  - Maintain active engagement in partner channel

-### 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
+#### Silver Partner (Channel)
+- Commission: 15% of first-year operator revenue + 5% ongoing
+- Requirements:
+  - Onboard and train at least 5 operators
+  - Provide monthly partner report
+  - Maintain >80% operator retention rate

-## Onboarding & Certification
-### Phase 1: Application
- Submit operator application (template: `specs/templates/operator-application.md`)
- Provide VPS specifications and location
- Sign operator agreement
+#### Gold Partner (Strategic)
+- Commission: 20% first-year + 7% ongoing + co-marketing funds
+- Requirements:
+  - Operate fleet of 10+ nodes
+  - Contribute to product roadmap
+  - Host local meetups/training sessions

-### Phase 2: Training
- Complete Hermes Agent training (5 modules)
- Pass fleet operations quiz (80% passing score)
- Shadow certified operator for 1 week
+### Partner Benefits
+- Access to exclusive operator training materials
+- Early beta program participation
+- Co-marketing and case study opportunities
+- Dedicated partner portal and revenue dashboard

-### Phase 3: Certification
- Deploy 2-node test fleet
- Successfully complete 10 dispatched tasks
- Certified operator reviews and signs off
+## Certification Pathway

-### Phase 4: Active Status
- Added to operator registry
- Granted access to fleet management tools
- Begin earning base compensation
+### Stage 1: Application & Screening
+1. Submit Operator Application (see `templates/operator-application.md`)
+2. Technical interview (30 min)
+3. Infrastructure audit (existing hardware/network)
+4. Background check (optional but preferred)
+**Timeline**: 3-5 business days

-## 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
+### Stage 2: Training & Onboarding
+1. Complete Fleet Ops 101 module (2 hours self-paced)
+2. Shadow a senior operator (2 weeks)
+3. Deploy test node (sandbox environment)
+4. Pass certification exam (90%+ score)
+**Timeline**: 2-3 weeks

-### 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
+### Stage 3: Active Operation
+- Deploy first production node
+- Maintain >99.5% uptime for first 30 days
+- Submit initial monthly ops report
+**Timeline**: 30 days probation

-Terminated operators:
- Access revoked immediately
- Final payment pro-rated to last active day
- May reapply after 6 months with improvement plan
+### Certification Renewal
+- Quarterly review of metrics
+- Annual recertification exam
+- Continuous training requirement (4 hours/month)

-### 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 Metrics (6-month targets)

-## 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
+| Metric | Target | Measurement |
+|--------|--------|-------------|
+| Active certified operators | 3-5 | Dashboard |
+| Operator churn | <10% annually | HR records |
+| Fleet uptime | >99.5% | Monitoring systems |
+| Partner channel leads | >30% of total | CRM data |

-## 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)
+## Runbook
+
+See companion document: `specs/fleet-ops-runbook.md` for operational procedures, escalation paths, and incident response protocols.
+
+## Templates
+
+- **Operator Application**: `templates/operator-application.md`
+- **Partner Report**: `templates/partner-report.md`
+
+## Revision History
+
+- 2025-05-02: Initial specification (implements #987, closes #1003)
--- a/specs/fleet-ops-runbook.md
+++ b/specs/fleet-ops-runbook.md
@@ -1,59 +1,291 @@
 # 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/`
+> Fleet Operator Incentives & Partner Program — Operational Procedures
+> Implements #987 | Closes #1003

-## 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
+## Table of Contents

-## 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`
+1. [Daily Ops Checklist](#daily-ops-checklist)
+2. [Weekly Maintenance](#weekly-maintenance)
+3. [Monthly Responsibilities](#monthly-responsibilities)
+4. [Incident Response](#incident-response)
+5. [Escalation Paths](#escalation-paths)
+6. [Communication Protocols](#communication-protocols)
+7. [Node Deployment](#node-deployment)
+8. [Compliance & Reporting](#compliance--reporting)

-### 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
+---

-## 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
+## Daily Ops Checklist
+
+### Health Monitoring
+- [ ] Review Timmy Dashboard for all owned nodes
+- [ ] Check alert feed (PagerDuty/OpsGenie) for any pending incidents
+- [ ] Verify node heartbeats (expect >99.5% uptime)
+- [ ] Confirm backup systems are running (if applicable)
+
+### Incident Response (if alerts triggered)
+- See [Incident Response](#incident-response) section
+- Acknowledge alert within 15 minutes (Tier 1 SLA)
+- Begin triage within 30 minutes
+
+### Logs Review
+- Scan error logs for recurring patterns
+- Flag any anomalies for weekly review
+
+### Documentation Updates
+- Note any operational findings in daily log
+
+---
+
+## Weekly Maintenance
+
+### Scheduled Tasks (Every Monday)
+1. **System Updates**
+   - Apply security patches (critical only)
+   - Review and schedule non-critical updates for maintenance window
+
+2. **Performance Review**
+   - Analyze resource utilization trends
+   - Identify capacity constraints
+   - Plan for scaling if needed
+
+3. **Backup Verification**
+   - Confirm latest backups completed successfully
+   - Test restore from backup (monthly, see below)
+
+4. **Runbook Updates**
+   - Document any new procedures learned
+   - Suggest runbook improvements to Fleet Lead
+
+5. **Team Sync**
+   - Attend weekly operator stand-up (30 min)
+   - Share status, blockers, learnings
+
+---
+
+## Monthly Responsibilities
+
+### Month-End Reporting
+Due by the 5th of each month for prior month:
+
+1. **Ops Report** (use `templates/partner-report.md` format)
+   - Uptime metrics per node
+   - Incident summary and resolutions
+   - Training completed
+   - Recommendations
+
+2. **Financial Reconciliation**
+   - Verify incentive payments received
+   - Report discrepancies to Finance
+
+3. **Compliance Audit**
+   - Confirm certification requirements met
+   - Document any deviations and corrective actions
+
+### Deep Maintenance
+- Full system backup and restore test
+- Security audit review
+- Hardware inspection (if physical nodes)
+- Training module completion (minimum 4 hours/month)
+
+---
+
+## Incident Response
+
+### Severity Definitions
+
+| Severity | Definition | Response Time | Resolution Target |
+|----------|------------|---------------|-------------------|
+| P0 | Fleet-wide outage, no nodes operational | 15 minutes | 4 hours |
+| P1 | Region/node cluster outage, >50% down | 30 minutes | 8 hours |
+| P2 | Single node failure | 1 hour | 24 hours |
+| P3 | Degraded performance, not critical | 4 hours | 3 days |
+
+### Response Procedure
+
+#### P0/P1 Incidents
+1. Acknowledge alert immediately
+2. Declare incident in `#fleet-incidents` Slack channel
+3. Notify Fleet Lead (direct message/call)
+4. Execute recovery procedures from relevant playbook
+5. Document timeline and actions taken
+6. Schedule post-mortem within 48 hours
+
+#### P2 Incidents
+1. Acknowledge within 1 hour
+2. Open incident ticket in tracking system
+3. Follow single-node recovery playbook
+4. Report resolution in daily ops log
+
+#### P3 Incidents
+1. Log in issue tracker
+2. Schedule during next maintenance window
+3. Document resolution upon completion
+
+### Recovery Playbooks
+
+#### Node Restart (most common P2)
+1. SSH to node (or use remote management)
+2. Check system logs (`/var/log/timmy/fleet.log`)
+3. Restart service: `sudo systemctl restart timmy-fleet`
+4. Verify node rejoins cluster
+5. Monitor for 30 minutes post-recovery
+
+#### Network Partition
+1. Verify network connectivity (ping, traceroute)
+2. Check firewall rules
+3. Contact network provider if external
+4. Switch to backup connection if available
+5. Document root cause
+
+#### Storage Full
+1. Identify large directories (`du -sh /* | sort -hr`)
+2. Rotate logs: `sudo logrotate -f /etc/logrotate.d/timmy`
+3. Clean temporary files
+4. Expand storage or add new volume
+5. Alert Fleet Lead for capacity planning
+
+---
+
+## Escalation Paths
+
+### Tiered Support Model
+
+```
+Operator (Tier 1)
+    ↓ (15 min SLA)
+Senior Operator / Fleet Lead (Tier 2)
+    ↓ (1 hour SLA)
+Timmy Core Team (Tier 3)
+    ↓ (Immediate)
+Executive Sponsor (Critical only)
 ```

-### Clear dispatch queue
+### Contact Matrix
+
+| Issue Type | Primary Contact | Secondary |
+|------------|----------------|-----------|
+| Technical incident | Fleet Lead | Timmy Core |
+| Payment/incentive | Finance Partner | Fleet Lead |
+| Training/certification | Training Coordinator | Fleet Lead |
+| Partnership inquiry | Partner Manager | Executive Sponsor |
+| Security incident | Security Team | Timmy Core (immediate) |
+
+### Emergency Contacts
+- Fleet Lead: `fleet-lead@timmy.foundation` (Slack: @fleet-lead)
+- Timmy Core On-Call: `oncall@timmy.foundation` (PagerDuty)
+- Security: `security@timmy.foundation`
+- Finance: `finance@timmy.foundation`
+
+---
+
+## Communication Protocols
+
+### Channels
+- `#fleet-operators` — Daily ops, questions
+- `#fleet-incidents` — Active incidents only
+- `#fleet-training` — Training resources, scheduling
+- `#fleet-partners` — Partner program discussions
+
+### Status Updates
+- Daily: Stand-up notes in thread
+- Weekly: Summary post in `#fleet-operators`
+- Monthly: Ops report submission
+- Incident: Real-time updates in `#fleet-incidents`
+
+### Documentation Standards
+- Use clear, concise language
+- Include timestamps in UTC
+- Link to relevant tickets/PRs
+- Tag stakeholders with `@`
+
+---
+
+## Node Deployment
+
+### Pre-Deployment Checklist
+- [ ] Hardware meets minimum specs (CPU, RAM, storage)
+- [ ] Network connectivity validated
+- [ ] Firewall rules configured
+- [ ] SSH keys exchanged with Timmy core team
+- [ ] Monitoring agent installed
+- [ ] Backup solution active
+- [ ] Documentation updated with node details
+
+### Deployment Steps
+1. Provision hardware/VM
+2. Install Timmy Fleet software
+3. Configure node ID and credentials
+4. Join cluster via `timmy-fleet join <cluster-endpoint>`
+5. Validate connectivity and heartbeat
+6. Update inventory spreadsheet
+7. Set up monitoring alerts
+8. Complete handover to operator
+
+### Decommissioning
+1. Drain node from cluster
+2. Migrate workloads
+3. Backup final state
+4. Shut down cleanly
+5. Update inventory
+6. Notify relevant teams
+
+---
+
+## Compliance & Reporting
+
+### Metrics to Track
+- Uptime (node-level and fleet-wide)
+- Incident count and severity
+- Response and resolution times
+- Training hours completed
+- Payment/compensation accuracy
+
+### Reporting Cadence
+- **Daily**: Ops dashboard (automated)
+- **Weekly**: Status summary (operator)
+- **Monthly**: Partner report (template-driven)
+- **Quarterly**: Performance review with Fleet Lead
+
+### Audits
+- Quarterly internal audit by Timmy compliance team
+- Annual external certification renewal
+- Ad-hoc security reviews as needed
+
+---
+
+## Appendix: Resources
+
+### Useful Commands
 ```bash
-rm /tmp/hermes/dispatch-queue.json
-# Watchdog will recreate on next cycle
+# Check service status
+sudo systemctl status timmy-fleet
+
+# View logs
+journalctl -u timmy-fleet -f
+
+# Restart node
+sudo systemctl restart timmy-fleet
+
+# Check node health
+timmy-fleet health
+
+# Join cluster
+timmy-fleet join <cluster-endpoint>
 ```

-### Update hermes-agent
-```bash
-cd ~/hermes-agent && git pull origin main && pip install -e ".[all]"
-```
+### Key Files
+- Config: `/etc/timmy/fleet/config.yaml`
+- Logs: `/var/log/timmy/fleet.log`
+- Health data: `/var/lib/timmy/fleet/health.json`

-## Emergency Escalation
- **Telegram**: @Rockachopa (primary)
- **Gitea Issue**: label `operator-alert` + mention @Rockachopa
- **Discord**: #fleet-ops-alerts channel
+### Support Resources
+- Internal Wiki: `https://wiki.timmy.foundation/fleet`
+- Operator Portal: `https://fleet.timmy.foundation`
+- Training Videos: `https://learn.timmy.foundation/fleet-ops`

-## Security Rules
- Never share VPS SSH keys
- Never commit credentials to git
- Rotate tokens every 90 days
- Report suspicious activity immediately
+---

-## Contact
- **Operator Handbook**: `specs/fleet-operator-incentives.md`
- **Templates**: `specs/templates/operator-*.md`
- **Foundation Forge**: https://forge.alexanderwhitestone.com/Timmy_Foundation
+**Last Updated**: 2025-05-02
+**Next Review**: 2025-06-02
--- a/specs/templates/operator-application.md
+++ b/specs/templates/operator-application.md
@@ -1,44 +1,143 @@
 # Fleet Operator Application
-*Submit completed form as a new Gitea issue with label `operator-application`*

-## Personal Information
- **Name / Handle**: 
- **Contact Email**: 
- **Telegram/Discord Handle**: 
- **Wallet Address (USDC/USDT)**: 
- **Timezone**: 
+> {{APPLICATION_DATE}}
+> Candidate: {{CANDIDATE_NAME}}

-## 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
+## Contact Information

-## Experience
- [ ] Linux system administration (2+ years)
- [ ] Git / GitHub / Gitea usage
- [ ] Docker / container orchestration
- [ ] AI agent frameworks (Hermes, OpenAI, etc.)
- [ ] Prior VPS fleet management
+**Full Name**: {{CANDIDATE_FULL_NAME}}
+**Email**: {{CANDIDATE_EMAIL}}
+**Phone**: {{CANDIDATE_PHONE}}
+**Location**: {{CANDIDATE_LOCATION}}
+**Time Zone**: {{CANDIDATE_TIMEZONE}}

-### Relevant Experience (describe)
-*Briefly describe your background with fleet ops, sysadmin, or AI agents:*
+### Availability
+- **Hours per week**: {{AVAILABILITY_HOURS}}
+- **Primary availability window (UTC)**: {{AVAILABILITY_WINDOW}}
+- **On-call flexibility**: {{ONCALL_FLEXIBILITY}}

-## 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
+## Technical Qualifications

-## References
- GitHub/Gitea username: 
- Any prior work with Timmy Foundation? (link issues/PRs)
+### Experience
+```
+Years in IT/DevOps: {{YEARS_EXPERIENCE}}
+Relevant roles:
+{{ROLE_HISTORY}}
+```

-## 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`.
+### Skills (check all that apply)
+- [ ] Linux system administration
+- [ ] Container orchestration (Kubernetes/Docker)
+- [ ] Cloud infrastructure (AWS/GCP/Azure)
+- [ ] Networking fundamentals
+- [ ] Monitoring & alerting (Prometheus/Grafana)
+- [ ] Incident response/ITIL
+- [ ] Security best practices
+- [ ] Automation (Ansible/Terraform)
+- [ ] Scripting (Python/Bash/Go)
+- [ ] Timmy platform experience

-**Signature** (type name): _________________ **Date**: _________
+**Additional skills**: {{ADDITIONAL_SKILLS}}
+
+### Certifications
+{{CERTIFICATIONS}}
+
+## Infrastructure Readiness
+
+### Proposed Node Environment
+- **Type**: ☐ Physical ☐ Cloud VM ☐ Hybrid
+- **Provider**: {{CLOUD_PROVIDER}}
+- **Region**: {{REGION}}
+- **Hardware specs**:
+  - CPU: {{CPU_SPEC}}
+  - RAM: {{RAM_SPEC}}
+  - Storage: {{STORAGE_SPEC}}
+  - Network: {{NETWORK_SPEC}}
+
+### Redundancy & HA
+- [ ] Backup power (UPS/generator)
+- [ ] Secondary internet connection
+- [ ] Off-site backup solution
+- [ ] Remote management (IPMI/iDRAC)
+
+### Connectivity
+- **Bandwidth**: {{BANDWIDTH}} Mbps
+- **Latency to Timmy core**: {{LATENCY}} ms
+- **Uptime SLA**: {{UPTIME_SLA}}

 ---
-*Send completed application to: https://forge.alexanderwhitestone.com/Timmy_Foundation/timmy-home/issues/new*
+
+## Motivation & Alignment
+
+### Why do you want to run a Timmy Fleet node?
+{{MOTIVATION}}
+
+### What attracts you to decentralized infrastructure?
+{{DECENTRALIZATION_MOTIVATION}}
+
+### How does this align with your long-term goals?
+{{LONG_TERM_GOALS}}
+
+---
+
+## Partner Program Interest (Optional)
+
+### Interested in?
+- [ ] Referral partner (refer operators, earn commission)
+- [ ] Channel partner (onboard and train operators)
+- [ ] Strategic partner (run fleet of 10+ nodes)
+
+### Existing network
+{{PARTNER_NETWORK}}
+
+### Referral pipeline
+{{REFERRAL_PIPELINE}}
+
+---
+
+## References
+
+### Professional References
+1. Name: {{REF1_NAME}}  
+   Email: {{REF1_EMAIL}}  
+   Relationship: {{REF1_RELATION}}
+
+2. Name: {{REF2_NAME}}  
+   Email: {{REF2_EMAIL}}  
+   Relationship: {{REF2_RELATION}}
+
+### Timmy Community Involvement
+{{COMMUNITY_INVOLVEMENT}}
+
+---
+
+## Agreement & Signatures
+
+### Code of Conduct
+- [ ] I have read and agree to the Timmy Fleet Operator Code of Conduct
+- [ ] I understand the uptime and response time requirements
+- [ ] I agree to the incentive structure and terms
+
+### Signature
+**Candidate signature**: ___________________________
+**Date**: {{SIGNATURE_DATE}}
+
+**Timmy representative**: ___________________________
+**Date**: {{TIMPY_SIGN_DATE}}
+
+---
+
+## Internal Use Only
+
+**Interviewer**: {{INTERVIEWER}}
+**Technical score**: {{TECH_SCORE}}/100
+**Culture fit**: {{CULTURE_FIT}}/50
+**Infrastructure audit**: ☐ Pass ☐ Fail
+**Background check**: ☐ Complete ☐ In-progress
+
+**Decision**: ☐ Approved ☐ Rejected ☐ Waitlist
+
+**Comments**: {{INTERNAL_COMMENTS}}
+
+**Certification ID**: {{CERT_ID}}
+**Onboarding start date**: {{ONBOARDING_DATE}}
--- a/specs/templates/partner-report.md
+++ b/specs/templates/partner-report.md
@@ -1,38 +1,175 @@
-# Partner Monthly Report
-*Submit by the 5th of each month for commission payments*
+# Fleet Partner Monthly Report

-## Partner Info
- **Partner Name**: 
- **Month/Year**: 
- **Wallet Address**: 
+> {{REPORT_MONTH}} {{REPORT_YEAR}}
+> Partner: {{PARTNER_NAME}} ({{PARTNER_TIER}})
+> Submitted: {{SUBMISSION_DATE}}

-## Referred Operators
-| Operator Handle | Start Date | Monthly Base | Commission (20%) | Status |
-|----------------|------------|--------------|-------------------|--------|
-| | | $150 | $30 | active / churned |
-| | | $150 | $30 | active / churned |
-| | | $150 | $30 | active / churned |
+## Executive Summary

-**Total Commission Due**: $______
+| Metric | Current Month | Target | Variance |
+|--------|---------------|--------|----------|
+| Active nodes managed | {{ACTIVE_NODES}} | {{TARGET_NODES}} | {{NODES_VARIANCE}} |
+| Fleet uptime | {{UPTIME}}% | 99.5% | {{UPTIME_VARIANCE}}% |
+| Operator churn rate | {{CHURN_RATE}}% | <10% | {{CHURN_VARIANCE}}% |
+| Partner-sourced leads | {{LEADS_COUNT}} | {{LEADS_TARGET}} | {{LEADS_VARIANCE}} |
+| Revenue share earned | {{REVENUE}} | — | — |

-## 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 ____)
+**Key highlights**:
+{{KEY_HIGHLIGHTS}}

-## Partner Performance
- Total active operators referred: 
- Average operator uptime this month: ______%
- Any operator churn? Yes / No (explain: )
-
-## Self-Assessment
- [ ] I maintained >99% personal fleet uptime
- [ ] I responded to Foundation pings within 24 hours
- [ ] I submitted this report on time
-
-## Notes
-*Any issues, concerns, or operator feedback:*
+**Top concerns**:
+{{KEY_CONCERNS}}

 ---
-*Submit as comment on your partner Gitea issue or via Telegram to @Rockachopa*
+
+## Node Performance
+
+### Node Inventory
+
+| Node ID | Location | Status | Uptime (30d) | Revenue Share | Issues |
+|---------|----------|--------|--------------|---------------|---------|
+| {{NODE_1_ID}} | {{NODE_1_LOC}} | {{NODE_1_STATUS}} | {{NODE_1_UPTIME}}% | ${{NODE_1_REV}} | {{NODE_1_ISSUES}} |
+| {{NODE_2_ID}} | {{NODE_2_LOC}} | {{NODE_2_STATUS}} | {{NODE_2_UPTIME}}% | ${{NODE_2_REV}} | {{NODE_2_ISSUES}} |
+| {{NODE_3_ID}} | {{NODE_3_LOC}} | {{NODE_3_STATUS}} | {{NODE_3_UPTIME}}% | ${{NODE_3_REV}} | {{NODE_3_ISSUES}} |
+
+*Add rows as needed*
+
+### Top Node Performers
+1. **{{TOP_NODE_1_ID}}**: {{TOP_NODE_1_UPTIME}}% uptime, zero incidents
+2. **{{TOP_NODE_2_ID}}**: {{TOP_NODE_2_UPTIME}}% uptime, quickest response times
+
+### Nodes Requiring Attention
+1. **{{ATTN_NODE_1_ID}}**: {{ATTN_NODE_1_ISSUE}}
+2. **{{ATTN_NODE_2_ID}}**: {{ATTN_NODE_2_ISSUE}}
+
+---
+
+## Incidents & Resolutions
+
+### Incident Log
+
+| Date | Severity | Node(s) | Duration | Root Cause | Resolution |
+|------|----------|---------|----------|------------|------------|
+| {{INC1_DATE}} | {{INC1_SEV}} | {{INC1_NODES}} | {{INC1_DURATION}} | {{INC1_CAUSE}} | {{INC1_RES}} |
+| {{INC2_DATE}} | {{INC2_SEV}} | {{INC2_NODES}} | {{INC2_DURATION}} | {{INC2_CAUSE}} | {{INC2_RES}} |
+| {{INC3_DATE}} | {{INC3_SEV}} | {{INC3_NODES}} | {{INC3_DURATION}} | {{INC3_CAUSE}} | {{INC3_RES}} |
+
+*Add rows as needed*
+
+### Mean Time to Recovery (MTTR)
+- **P0 incidents**: {{MTTR_P0}} hours
+- **P1 incidents**: {{MTTR_P1}} hours
+- **P2 incidents**: {{MTTR_P2}} hours
+- **P3 incidents**: {{MTTR_P3}} hours
+
+**Improvement opportunities**:
+{{MTTR_IMPROVEMENTS}}
+
+---
+
+## Operator Management
+
+### Active Operators
+
+| Operator | Tier | Nodes Managed | Status | Cert Date |
+|----------|------|---------------|--------|-----------|
+| {{OP1_NAME}} | {{OP1_TIER}} | {{OP1_NODES}} | {{OP1_STATUS}} | {{OP1_CERT}} |
+| {{OP2_NAME}} | {{OP2_TIER}} | {{OP2_NODES}} | {{OP2_STATUS}} | {{OP2_CERT}} |
+
+### Churn / Attrition
+- **Departed operators**: {{DEPARTED_COUNT}}
+- **Departure reasons**: {{DEPARTURE_REASONS}}
+- **Retention initiatives**: {{RETENTION_INITIATIVES}}
+
+### Training & Certification
+- **New certifications**: {{NEW_CERTS}}
+- **Training hours logged**: {{TRAINING_HOURS}}
+- **Upcoming recertifications**: {{UPCOMING_RECERTS}}
+
+---
+
+## Partner Program Metrics
+
+### Lead Generation
+- **Total leads received**: {{TOTAL_LEADS}}
+- **Qualified leads**: {{QUALIFIED_LEADS}}
+- **Converted to operators**: {{CONVERTED_OPERATORS}}
+- **Conversion rate**: {{CONVERSION_RATE}}%
+- **Partner contribution to total pipeline**: {{PARTNER_PIPELINE_PERCENT}}%
+
+### Referral Commission
+- **Referral fee earned**: ${{REFERRAL_FEE}}
+- **Ongoing revenue share**: ${{ONGOING_SHARE}}
+- **Total YTD earnings**: ${{YTD_EARNINGS}}
+
+### Partner Activity
+- **Marketing events hosted**: {{EVENTS_HOSTED}}
+- **Training sessions conducted**: {{TRAINING_SESSIONS}}
+- **Community engagement posts**: {{COMMUNITY_POSTS}}
+- **Collateral created**: {{COLLATERAL}}
+
+---
+
+## Financial Summary
+
+### Incentive Payouts
+| Category | Amount | Notes |
+|----------|--------|-------|
+| Operator stipends | ${{STIPENDS}} | {{STIPENDS_NOTES}} |
+| Uptime bonuses | ${{UPTIME_BONUS}} | {{UPTIME_NOTES}} |
+| Mentorship bonuses | ${{MENTOR_BONUS}} | {{MENTOR_NOTES}} |
+| Performance bonuses | ${{PERF_BONUS}} | {{PERF_NOTES}} |
+| Partner commissions | ${{PARTNER_COMM}} | {{PARTNER_NOTES}} |
+
+**Total payout this month**: ${{TOTAL_PAYOUT}}
+
+### Cost Efficiency
+- **Cost per node**: ${{COST_PER_NODE}}
+- **Cost per uptime hour**: ${{COST_PER_UPTIME_HOUR}}
+- **Efficiency rating**: {{EFFICIENCY_RATING}}/10
+
+---
+
+## Goals & Objectives
+
+### Next Month Targets
+1. **Uptime**: {{NEXT_UPTIME_TARGET}}%
+2. **Qualified leads**: {{NEXT_LEADS_TARGET}}
+3. **New operators**: {{NEXT_OPS_TARGET}}
+4. **Incident reduction**: {{NEXT_INCIDENT_TARGET}} incidents
+
+### Priority Initiatives
+- {{PRIORITY_1}}
+- {{PRIORITY_2}}
+- {{PRIORITY_3}}
+
+### Support Needed
+- {{SUPPORT_NEEDED_1}}
+- {{SUPPORT_NEEDED_2}}
+
+---
+
+## Attestation
+
+By submitting this report, I certify that the information provided is accurate and complete to the best of my knowledge.
+
+**Submitted by**: {{SUBMITTER_NAME}}
+**Title**: {{SUBMITTER_TITLE}}
+**Signature**: ___________________________
+**Date**: {{SUBMISSION_DATE}}
+
+**Approved by** (Timmy Core): {{APPROVER_NAME}}
+**Date**: {{APPROVAL_DATE}}
+
+---
+
+## Appendix
+
+### Supporting Documents
+- [ ] Ops dashboard screenshots attached
+- [ ] Incident post-mortems attached
+- [ ] Training completion records attached
+- [ ] Financial reconciliation attached
+
+### Notes
+{{APPENDIX_NOTES}}