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

specs/fleet-operator-incentives.md

@@ -1,128 +0,0 @@
-# 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)
-
-### 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
-
-## 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)
-
-### 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 |
-
-### 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
-
-## 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)
-
-### 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)

specs/fleet-ops-runbook.md

@@ -1,59 +0,0 @@
-# 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/`
-
-## 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
-
-## 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`
-
-### 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
-```
-
-### Clear dispatch queue
-```bash
-rm /tmp/hermes/dispatch-queue.json
-# Watchdog will recreate on next cycle
-```
-
-### Update hermes-agent
-```bash
-cd ~/hermes-agent && git pull origin main && pip install -e ".[all]"
-```
-
-## Emergency Escalation
-- **Telegram**: @Rockachopa (primary)
-- **Gitea Issue**: label `operator-alert` + mention @Rockachopa
-- **Discord**: #fleet-ops-alerts channel
-
-## 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

specs/templates/operator-application.md

@@ -1,44 +0,0 @@
-# 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**: 
-
-## 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
-
-## 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:*
-
-## 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
-
-## References
-- GitHub/Gitea username: 
-- Any prior work with Timmy Foundation? (link issues/PRs)
-
-## 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`.
-
-**Signature** (type name): _________________ **Date**: _________
-
----
-*Send completed application to: https://forge.alexanderwhitestone.com/Timmy_Foundation/timmy-home/issues/new*

specs/templates/partner-report.md

@@ -1,38 +0,0 @@
-# Partner Monthly Report
-*Submit by the 5th of each month for commission payments*
-
-## Partner Info
-- **Partner Name**: 
-- **Month/Year**: 
-- **Wallet Address**: 
-
-## Referred Operators
-| Operator Handle | Start Date | Monthly Base | Commission (20%) | Status |
-|----------------|------------|--------------|-------------------|--------|
-| | | $150 | $30 | active / churned |
-| | | $150 | $30 | active / churned |
-| | | $150 | $30 | active / churned |
-
-**Total Commission Due**: $______
-
-## 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 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:*
-
----
-*Submit as comment on your partner Gitea issue or via Telegram to @Rockachopa*

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