EU GRANT HUNTER

How To Use

Automated Daily Scan

Execute the scheduled scan every morning:

python3 scripts/scan_eu_databases.py --auto

Workflow:

1. Scrape or query all four EU funding sources (topic filter optional).
2. Calculate fit scores with scripts/calculate_fit_score.py.
3. Generate briefs for opportunities scoring ≥ 4.0.
4. Alert Trinity via COMMS_HUB for high-scoring opportunities.
5. Persist results to /srv/janus/01_STRATEGY/grant_pipeline/pipeline_state.json.

Manual Opportunity Search

python3 scripts/scan_eu_databases.py --topic "agricultural technology"

1. Scan sources using the provided topic keyword.
2. Rank matches by fit score (descending).
3. Display the top results directly to the requester.
4. Generate briefs for each opportunity scoring ≥ 4.0.

Deadline Reminders

python3 scripts/deadline_tracker.py

1. Load pipeline state and compute days remaining.
2. Trigger reminders at 90, 60, 30, and 7 days.
3. Send pucks to claude, gemini, codex, and captain inboxes.
4. Record reminder events to /srv/janus/logs/grant_hunter.jsonl.
5. Update reminders_sent in the pipeline state to avoid duplicates.

Integration Points

• Treasury Administrator: Provides budgeting guardrails for opportunity briefs and proposal planning.
• Grant Application Assembler: Consumes generated briefs to assemble submission packages.
• COMMS_HUB: Disseminates alerts using the Talking Drum protocol (/srv/janus/03_OPERATIONS/COMMS_HUB/).
• Oracle Bridge (Perplexity, Wolfram, Data Commons): Supplies live data for opportunity vetting and quantitative justification.
• Mission Orchestrator: Schedules daily scans and tracker runs via proposal engine missions.

Constitutional Constraints

• Recommend only opportunities aligned with Lion’s Sanctuary principles; flag defense, surveillance, or extractive programs.
• Provide verifiable citations (EU call IDs, URLs) for every recommendation.
• Maintain transparent logging to /srv/janus/logs/grant_hunter.jsonl.
• Never fabricate deadlines or budgets; if data is uncertain, mark it explicitly and request human review.
• Uphold human oversight—automation surfaces intelligence, human custodians approve action.

File Locations

• Pipeline state JSON: /srv/janus/01_STRATEGY/grant_pipeline/pipeline_state.json
• Opportunity briefs: /srv/janus/01_STRATEGY/grant_opportunities/
• Deadline calendar: /srv/janus/01_STRATEGY/grant_pipeline/deadline_calendar.md
• HTML dashboard template: assets/pipeline_dashboard_template.html
• Opportunity brief template: assets/opportunity_brief_template.md
• Operational logs: /srv/janus/logs/grant_hunter.jsonl

Operational Checklist

1. Run daily scan (scan_eu_databases.py) and confirm pipeline state updated.
2. Review high-scoring opportunities; ensure briefs were generated and alerts sent.
3. Execute deadline_tracker.py; verify reminders posted and logged.
4. Regenerate dashboard (scan_eu_databases.py --render-dashboard) for Captain BROlinni.
5. Record manual overrides or human decisions in the log for provenance.

Mission Readiness Criteria

• Zero missed deadlines for tracked opportunities.
• ≥4 high-priority opportunities surfaced each month.
• Fit scores audited weekly against human judgment for calibration.
• Pipeline dashboard accessible and refreshed within the last 24 hours.
• All communications archived with rhythm metadata in COMMS_HUB logs.