Your personal intelligence agent. Watches the world from multiple data sources and pings you when something changes.
remove CLAUDE.md from tracking (was committed before gitignore rule)
calesthio710e52fc75e6
diff --git a/CLAUDE.md b/CLAUDE.mddeleted file mode 100644index 59c29f1..0000000--- a/CLAUDE.md+++ /dev/null@@ -1,186 +0,0 @@-# Crucix — Claude Code Project Instructions--## What This Is--Crucix is a local intelligence engine that aggregates 25 OSINT data sources in parallel and produces structured JSON. Claude's job is to synthesize that raw data into two outputs: a written intelligence briefing and a visual Jarvis-style dashboard.--## Project Layout--```-Crucix/-├── apis/-│ ├── briefing.mjs # Master orchestrator — runs all 25 sources-│ ├── BRIEFING_PROMPT.md # Intelligence synthesis protocol (READ THIS)-│ ├── BRIEFING_TEMPLATE.md # Output template for written briefings-│ └── sources/ # Individual source modules-├── dashboard/-│ ├── public/jarvis.html # Self-contained Jarvis HUD dashboard-│ └── inject.mjs # Data synthesis + injection script-├── runs/-│ └── latest.json # Most recent sweep output-└── CLAUDE.md # You are here-```--## Trigger Phrases--When the user says any of the following (or similar):-- "brief me"-- "what's going on"-- "what's the latest"-- "time for my brief"-- "what's happening in the world"-- "run a sweep"-- "update the dashboard"--Execute the **Full Briefing Flow** below.--## Full Briefing Flow--### Step 1: Run the Crucix Sweep--```bash-cd C:/Users/ishan/Documents/Crucix && node apis/briefing.mjs > runs/latest.json 2>&1-```--This runs all 25 OSINT sources in parallel (~30-60 seconds). Output goes to `runs/latest.json`. If a timestamped backup is desired:--```bash-cp runs/latest.json runs/briefing_$(date -u +%Y-%m-%dT%H-%M-%SZ).json-```--### Step 2: Gather Live Market Data--Use the Alpaca MCP tools to pull real-time context:--- **Broad indexes**: Get latest quotes/snapshots for SPY, QQQ, DIA, IWM-- **Rates proxies**: TLT, HYG, LQD-- **Commodities**: GLD, SLV, USO, UNG-- **Crypto**: BTC/USD, ETH/USD-- **VIX**: Get CBOE VIX latest--This supplements the FRED/EIA/BLS data in `latest.json` with live market prices.--### Step 3: Search for Breaking Developments--Use web search to check for breaking news in the last 6 hours:-- Geopolitical escalation or de-escalation-- Central bank actions or statements-- Major economic data releases-- Conflict developments-- Health emergencies-- Sanctions or policy shifts--### Step 4: Read the Briefing Protocol--Read `apis/BRIEFING_PROMPT.md` for the full intelligence synthesis protocol. Read `apis/BRIEFING_TEMPLATE.md` for the output structure.--Key principles:-- **Leverage first** — always lead with what the user can act on-- **Cross-correlate** — connect signals across conflict, economic, health, and market domains-- **Strong view** — form an opinion backed by evidence, not hedged filler-- **8 sections**: Leverageable Ideas → Executive Thesis → Situation Awareness → Pattern Recognition → Historical Parallels → Market Implications → Decision Board → Source Integrity--### Step 5: Write the Intelligence Briefing--Synthesize all inputs (Crucix sweep + Alpaca live data + web search) into a briefing following `BRIEFING_TEMPLATE.md`. Write it as markdown.--Save the briefing to:-```-runs/briefing_YYYY-MM-DDTHH-MM-SSZ.md-```--### Step 6: Generate the Jarvis Dashboard--After the briefing is written, update the visual dashboard:--```bash-cd C:/Users/ishan/Documents/Crucix && node dashboard/inject.mjs-```--This script:-1. Reads `runs/latest.json`-2. Fetches RSS news from BBC, NYT, Al Jazeera and geo-tags them-3. Generates signal-based Leverageable Ideas from cross-source correlation-4. Synthesizes the raw data into a compact format (~18KB)-5. Injects it into `dashboard/public/jarvis.html` replacing the data placeholder-6. Filters non-English Telegram posts (Cyrillic detection)-7. **Auto-opens the dashboard in the user's default browser**--The dashboard is a self-contained HTML file — no server needed. It opens automatically after injection.--### Step 7: Confirm to User--Tell the user:-1. Briefing is ready (share key highlights from Leverageable Ideas and Executive Thesis)-2. Dashboard has been updated and auto-opened in their browser (if they already had it open, they should refresh)-3. Note any source failures or degraded data quality--## Dashboard Architecture--The Jarvis HUD (`dashboard/public/jarvis.html`) is a single self-contained file:-- **CDN dependencies**: GSAP (animations), D3.js + topojson (world map)-- **Visual style**: Glassmorphism, cyan-on-dark, IBM Plex Mono + Space Grotesk-- **Boot sequence**: Cinematic 3-4 second reveal with spinning logo ring-- **Layout**: 3-column grid- - Left rail: Threat Mesh layers, Nuclear Watch, Risk Gauges- - Center: D3 world map with 7 marker types + region filters + lower macro grid- - Right rail: English-only OSINT stream + WHO alerts + Signal Core metrics--### Map Marker Types-- Green circles: Air traffic hotspots (OpenSky)-- Red circles: Thermal/fire detections (FIRMS)-- Cyan dots: SDR receivers in conflict zones (KiwiSDR)-- Yellow circles: Nuclear monitoring sites (Safecast)-- Purple diamonds: Maritime chokepoints-- Orange circles: OSINT events (Telegram urgent)-- Green circles (small): WHO health alerts-- Light blue broadcast icons: Geolocated world news (RSS) — click for article popup--### Region Filters-World, Americas, Europe, Middle East, Asia Pacific, Africa — with smooth D3 zoom transitions.--## Data Synthesis (inject.mjs)--The inject script maps raw `latest.json` fields to what the HTML expects:--| HTML property | Raw source | Key fields |-|---|---|---|-| `D.air` | OpenSky.hotspots | total, noCallsign, highAlt, region |-| `D.thermal` | FIRMS.hotspots | det, night, hc, fires[{lat,lon,frp}] |-| `D.chokepoints` | Maritime.chokepoints | label, note, lat, lon |-| `D.nuke` | Safecast.sites | site, anom, cpm, n |-| `D.sdr` | KiwiSDR | total, online, zones[{region,count,receivers}] |-| `D.tg` | Telegram | posts, urgent[], topPosts[] (English only) |-| `D.who` | WHO.diseaseOutbreakNews | title, date, summary |-| `D.fred` | FRED.indicators | id, value, momChange, etc. |-| `D.energy` | EIA | wti, brent, natgas, crudeStocks, wtiRecent[] |-| `D.bls` | BLS.indicators | id, value, momChange, momChangePct |-| `D.treasury` | Treasury.debt[0] | totalDebt |-| `D.gscpi` | GSCPI.latest | value, interpretation |-| `D.defense` | USAspending.recentDefenseContracts | recipient, amount, desc |-| `D.health` | All sources | name, error status |--## If Only Dashboard Update is Requested--If the user just says "update the dashboard" or "refresh the dashboard" (without wanting a full briefing):--1. Run the sweep: `node apis/briefing.mjs > runs/latest.json 2>&1`-2. Inject data: `node dashboard/inject.mjs`-3. Confirm dashboard is updated--## If Only Briefing is Requested--If the user just wants the written briefing without the dashboard:--1. Run the sweep-2. Gather Alpaca + web context-3. Read and follow BRIEFING_PROMPT.md-4. Write the briefing following BRIEFING_TEMPLATE.md-5. Share the briefing--## Source Notes--- **25 sources**: GDELT, OpenSky, FIRMS, Maritime, Safecast, ACLED, ReliefWeb, WHO, OFAC, OpenSanctions, ADS-B, FRED, Treasury, BLS, EIA, GSCPI, USAspending, Comtrade, NOAA, EPA, Patents, Bluesky, Reddit, Telegram, KiwiSDR-- Zero npm dependencies, pure ESM, Node 22+-- Some sources may return errors (ACLED rate limits, GDELT empty results) — note this in Source Integrity-- Telegram posts filtered for English (Cyrillic detection) — Russian-language posts are skipped in both briefing and dashboard