{"id":51240731,"url":"https://github.com/gryszzz/atlasz-intel","last_synced_at":"2026-06-29T00:01:23.674Z","repository":{"id":366055372,"uuid":"1274470529","full_name":"gryszzz/Atlasz-Intel","owner":"gryszzz","description":"Offline-first intelligence software for markets, trade, politics, and world events.","archived":false,"fork":false,"pushed_at":"2026-06-28T01:02:33.000Z","size":6734,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-28T02:09:55.587Z","etag":null,"topics":["ai","financial-data","geopolitics","intelligence-dashboard","local-first","macroeconomics","market-intelligence","osint","react","realtime","sqlite","typescript","websocket","world-news"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gryszzz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-19T14:47:13.000Z","updated_at":"2026-06-28T01:02:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gryszzz/Atlasz-Intel","commit_stats":null,"previous_names":["gryszzz/atlasz-intel"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/gryszzz/Atlasz-Intel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gryszzz%2FAtlasz-Intel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gryszzz%2FAtlasz-Intel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gryszzz%2FAtlasz-Intel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gryszzz%2FAtlasz-Intel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gryszzz","download_url":"https://codeload.github.com/gryszzz/Atlasz-Intel/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gryszzz%2FAtlasz-Intel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34907985,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","financial-data","geopolitics","intelligence-dashboard","local-first","macroeconomics","market-intelligence","osint","react","realtime","sqlite","typescript","websocket","world-news"],"created_at":"2026-06-29T00:01:22.748Z","updated_at":"2026-06-29T00:01:23.667Z","avatar_url":"https://github.com/gryszzz.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"docs/atlasz-intel-banner-transparent.png\" alt=\"Atlasz Intel\" width=\"880\" /\u003e\n\n# Atlasz Intel\n\n**A local-first, real-source intelligence terminal.**\nIt turns official and public data into source-trailed events, an evidence graph, and structural exposure context — and refuses to fake the parts it cannot prove.\n\n\u003cbr/\u003e\n\n[![Real data only](https://img.shields.io/badge/data-real--source%20only-0b7285?style=flat-square)](docs/runtime-verification-log.md)\n[![Connectors](https://img.shields.io/badge/connectors-38%20wired-1864ab?style=flat-square)](docs/connector-hardening-audit.md)\n[![Local-first](https://img.shields.io/badge/runtime-local--first%20desktop-364fc7?style=flat-square)](#run-locally)\n[![Stack](https://img.shields.io/badge/stack-Electron%20%2B%20React%2019%20%2B%20TS%20%2B%20SQLite-5f3dc4?style=flat-square)](#tech-stack)\n[![Verification](https://img.shields.io/badge/runtime%20verification-13%2F13%20passing-2b8a3e?style=flat-square)](docs/runtime-verification-log.md)\n\n\u003cbr/\u003e\n\n[Latest release](https://github.com/gryszzz/Atlasz-Intel/releases/latest)\n\u0026nbsp;·\u0026nbsp;\n[Runtime verification log](docs/runtime-verification-log.md)\n\u0026nbsp;·\u0026nbsp;\n[Connector hardening audit](docs/connector-hardening-audit.md)\n\u0026nbsp;·\u0026nbsp;\n[Source atlas](docs/intelligence-source-atlas.md)\n\u0026nbsp;·\u0026nbsp;\n[Engineering standards](docs/atlasz-runtime-engineering-standards.md)\n\n\u003c/div\u003e\n\n---\n\nAtlasz is **not** a chatbot, a news clone, a trading bot, or a placeholder dashboard. It is a desktop intelligence workspace built around one discipline: every line on screen traces to live evidence, curated structure, an explicitly-labeled inference, or an honest *unknown*. Nothing is invented to fill a gap.\n\nIt exists to answer seven questions, fast and with receipts:\n\n\u003e **What changed? · Where did it come from? · How fresh is it? · What proves it? · Which entities does it touch? · What structural exposure exists? · What is still unknown?**\n\n---\n\n## The Real-Data Contract\n\nThis is the core of the product, not a footnote. Atlasz is *allowed to be incomplete*. It is *not allowed to fabricate intelligence*.\n\n- **No simulated production data.** No fake events, alerts, macro prints, filings, patents, sanctions, prices, or weather.\n- **Fail closed, always.** Failed, stale, malformed, unavailable, or rate-limited sources surface as exactly that — never as silently-substituted data.\n- **Missing keys are honest.** Key-gated providers render `missing-key` / `DATA_UNAVAILABLE` until configured. There is no random-walk price fallback.\n- **Provenance or it didn't happen.** Source trails carry source identity, freshness, confidence, provenance, a URL when available, and payload proof when practical.\n- **Media is observation, not fact.** GDELT shows what public media *metadata* observed — it never becomes a verified event and never enters exposure ranking.\n- **Curated structure is reference, not causality.** Exposure chains describe relationships; they are labeled `curated-reference` and are never upgraded into live proof.\n- **Secrets stay secret.** Keys are read from the environment only and must never appear in source trails, logs, raw payloads, or UI endpoint lists. A redaction scan enforces it.\n\n---\n\n## What's New in v0.2.0\n\nThe terminal grew from a connector dashboard into a full reasoning surface. Highlights since the last README:\n\n### Aegis Worldwatch Profiles\nProfile-aware watchlists rank intelligence by the systems you care about: tickers,\ncompanies/CIKs, ETFs, commodities, regions, facilities, ports, grid regions,\nminerals, CVEs, connectors, and themes. Hermes delivers evidence, Aegis evaluates\ntrust/freshness/conflict, and Worldwatch only ranks relevance. Watchlists never\ncreate evidence or raise truth confidence.\n\n### Local API Activation\n`docs/local-api-setup.md` and `scripts/checkRuntimeConfig.mts` give operators a\nsafe key activation path: env-name presence only, official-host validation for\nconfigured URLs, and locked connector summaries. The UI now includes a Connector\nActivation Panel for missing-key, configured, online, failed, rate-limited, and\nstale states without rendering key values.\n\n### Intelligence Synthesis — \"What To Watch Next\"\nThe forward end of the evidence chain. Atlasz composes briefs that walk:\n`observed change → proof → resolved entities → curated systems → corroboration → conflicts → unknowns → what it does NOT prove → confirmation-seeking watch items` — **every line basis-labeled** so you always know whether you're reading evidence, structure, or inference.\n\n### Cross-Source Corroboration \u0026 Conflict Detection\n- **Corroboration** rewards independent overlap across sources — media never counts as corroboration, and stale sources are downgraded.\n- **Conflict detection** flags contradictions instead of silently merging them: ticker↔CIK, CIK↔name, facility coordinates, ETF ticker↔CUSIP, and operator-identity mismatches.\n\n### Canonical Freshness Model\nOne freshness vocabulary across the whole app: `live · fresh · cached · stale · expired · missing-key · unavailable · rate-limited`. **\"What Changed Today\"** now excludes static/annual reference data unless it was genuinely change-tracked today.\n\n### Geospatial + Energy / Trade / Materials Core\nA real geospatial layer with energy, logistics, and critical-materials connectors: EIA **power plants, refineries, LNG terminals, nuclear plants**, **NRC reactor status**, **grid regions / balancing authorities**, **ports (UN/LOCODE + World Port Index)**, **USGS minerals**, and a curated **critical-minerals crosswalk**.\n\n### Real Market Data (no fake prices)\nA key-gated equity/ETF **quote provider (Alpaca)** wired live into the ingestion worker, plus an **options chain / open-interest** provider. Seeded/default market surfaces are gated out of production — it's `PRICE_UNAVAILABLE` until a real quote arrives, never a guess.\n\n### Honesty Harness\nA self-auditing spine: Connector Dashboard, Market Coverage Dashboard, Market Data Reality audit, the [Connector Super-Hardening audit](docs/connector-hardening-audit.md), and an upgraded [runtime verification pass](docs/runtime-verification-log.md) reporting freshest/oldest record, coverage, eligibility, and corroboration/conflict counts.\n\n---\n\n## Interface\n\nRepo-owned previews of the public-facing surfaces and the evidence boundaries they enforce.\n\n| Connector Dashboard | Exposure Dashboard |\n| --- | --- |\n| ![Connector Dashboard](docs/screenshots/connector-dashboard.svg) | ![Exposure Dashboard](docs/screenshots/exposure-dashboard.svg) |\n\n| What Changed Today | Source Trail Card |\n| --- | --- |\n| ![What Changed Today](docs/screenshots/what-changed-today.svg) | ![Source Trail Card](docs/screenshots/source-trail-card.svg) |\n\n| Curated Exposure Chains |\n| --- |\n| ![Curated Exposure Chains](docs/screenshots/curated-exposure-chains.svg) |\n\n---\n\n## Architecture Loop\n\n```text\n connectors ─▶ normalize ─▶ persist ─▶ source trail ─▶ Evidence Graph ─▶ resolver\n                                                                            │\n   verification log ◀── dashboards ◀── intelligence synthesis ◀── curated exposure\n```\n\n**Runtime flow**\n\n1. **Connectors** fetch bounded records from official/public sources with retry, backoff, and fail-closed guards.\n2. **Adapters** normalize records into stable internal types carrying source identity and payload hashes.\n3. **Persistence** stores source-backed records, audit rows, source trails, and graph evidence in local SQLite (WAL) with a JSON fallback.\n4. The **Evidence Graph** links records to entities, topics, publishers, companies, countries, sectors, commodities, vulnerabilities, filings, patents, facilities, and events — only when proof fields exist.\n5. The **resolver** can surface curated structural exposure, labeled `curated-reference`, never upgraded into live causality.\n6. **Corroboration \u0026 conflict** passes cross-check sources before anything is presented as agreement.\n7. **Intelligence synthesis** composes basis-labeled \"What To Watch Next\" briefs.\n8. **Dashboards** show source health, freshness state, ranked change, source trails, entity dossiers, and unresolved gaps.\n9. `scripts/runtimeVerification.mts` drives the real registry and writes an auditable truth table.\n\n---\n\n## Connector Matrix\n\n**47 runtime-driven connectors.** *Runtime-wired* means there is an adapter/provider path, tests, source-health behavior, and UI/persistence wiring — not that every source is reachable without keys on every machine. The live, generated table lives in [`docs/runtime-verification-log.md`](docs/runtime-verification-log.md).\n\n### Live public — fetch live, no key required\nSEC Market Reference Master · ETF Holdings · FRED CSV · Treasury Fiscal Data · BLS · Federal Register · Congress.gov *(DEMO_KEY mode)* · OFAC SDN · NOAA/NWS Alerts · USGS Earthquakes · CISA KEV · CISA Advisories · NVD · GHSA · OSV · GitHub Releases · OpenAlex Works · Crossref DOI · UN/LOCODE · NRC Reactor Status · World Port Index · USGS Minerals *(MRDS legacy reference)* · arXiv/GitHub/NASA/Space public feeds · GDELT *(media observation)* · Yahoo/CoinGecko public market paths · optional public crypto websockets\n\n### Key-gated — require `.env`, fail closed to `missing-key`\nSEC EDGAR · SEC Company Facts · SEC Form 4 · SEC Form 13F *(SEC User-Agent)* · BEA · EIA *(+ power plants / nuclear / grid)* · UN Comtrade · USPTO PatentsView · Alpaca equity/ETF quotes · Alpaca options chain/open-interest\n\n### Configured official URLs — no fake facility layers\nLNG terminals · EIA refineries require pinned official URLs unless a trusted default is configured. Missing URLs render as configured-only / missing-key states, not fabricated map markers.\n\n### Domain coverage at a glance\n\n| Domain | Connectors |\n| --- | --- |\n| **Markets \u0026 identity** | Market Reference Master, Equity/ETF Quotes, ETF Holdings, Options chain/OI |\n| **Company disclosure** | SEC EDGAR, Company Facts, Form 4 (insiders), Form 13F (institutions) |\n| **Macro \u0026 fiscal** | FRED, BEA, BLS, Treasury Fiscal Data |\n| **Policy \u0026 regulatory** | Federal Register, Congress.gov, OFAC SDN |\n| **Cyber \u0026 vulnerabilities** | CISA KEV, CISA Advisories, NVD, GHSA, OSV |\n| **Energy \u0026 facilities** | EIA, EIA Power/Nuclear Plants, Refineries, LNG Terminals, NRC Reactor Status, Grid Regions |\n| **Trade, ports \u0026 materials** | UN Comtrade, UN/LOCODE, World Port Index, USGS Minerals |\n| **Physical world** | USGS Earthquakes, NOAA/NWS Alerts |\n| **Research \u0026 IP** | USPTO PatentsView, OpenAlex Works, Crossref DOI |\n| **OSS \u0026 media** | GitHub Releases, GDELT *(media observation)* |\n\n---\n\n## What It Does\n\n- **High-density local command center** — a desktop workspace, not a web tab.\n- **Connector Dashboard** — source health, trust tier, freshness state, record counts, persistence, and source-trail coverage.\n- **Connector Activation Panel** — local key/config presence and what each connector unlocks, without exposing values.\n- **Exposure Dashboard** — resolved events, unresolved gaps, media-observation boundaries, and curated-reference exposure counts.\n- **Market Coverage Dashboard + Market Data Reality panel** — honest gaps where real quotes don't exist yet.\n- **Aegis Worldwatch Profiles** — relevance profiles and watchlist chips for what matters to your systems without changing proof or confidence.\n- **What Changed Today** — ranked change across filings, macro, weather, policy, cyber, research, fiscal, patents, OSS releases, and trade layers.\n- **What To Watch Next** — forward-looking, basis-labeled intelligence briefs.\n- **Evidence Graph + Entity Dossiers** — timelines, proof rows, unknowns, source links, freshness, confidence, and curated exposure chains.\n- **World globe + event timeline** — geospatial context for physical-world and facility events.\n- **Quant terminal, Decision Journal, and research notes** — local operator context.\n- **`Ctrl/Cmd + K` command palette** — navigation and inspection from the keyboard.\n\n---\n\n## Tech Stack\n\n| Layer | Choice |\n| --- | --- |\n| Shell | **Electron 42** (desktop) with a browser-only preview mode |\n| UI | **React 19** + TypeScript, Tailwind v4, Recharts, `@xyflow/react` graph |\n| Build | **Vite 8**, `vite-plugin-electron`, `tsc` project references |\n| Persistence | **SQLite (WAL)** via `better-sqlite3`, with a JSON fallback store |\n| Ingestion | Worker-thread realtime market ingestion + browser fallback store |\n| Verification | `scripts/runtimeVerification.mts` (real registry, fail-closed, redaction scan) |\n\n---\n\n## Quickstart\n\n```bash\ngit clone https://github.com/gryszzz/Atlasz-Intel.git\ncd Atlasz-Intel\nnpm install\nnpm run dev          # desktop (Electron) dev\n```\n\nBrowser-only preview:\n\n```bash\nnpm run web:dev\n```\n\nWith no `.env`, Atlasz starts on safe defaults: public/no-auth paths may run, key-gated providers report `missing-key`, unavailable data stays unavailable, and any simulator/dev data must be explicitly enabled **and** labeled.\n\n### Configuration\n\nCopy `.env.example` to `.env` only to opt into external public feeds, keyed official APIs, or local model experiments.\n\n```bash\nATLASZ_ENABLE_PUBLIC_WORLD=1\nATLASZ_SEC_USER_AGENT=\"Atlasz Intel research (you@example.com)\"\nATLASZ_EIA_API_KEY=\"...\"\n# Optional quota upgrades, not required for baseline:\nATLASZ_FRED_API_KEY=\"...\"\nATLASZ_OPENALEX_API_KEY=\"...\"\nATLASZ_CONGRESS_API_KEY=\"...\"\nATLASZ_CROSSREF_MAILTO=\"you@example.com\"\n# Real market data (no fake prices):\nATLASZ_ALPACA_API_KEY=\"...\"\nATLASZ_ALPACA_SECRET_KEY=\"...\"\n```\n\n\u003e Never commit `.env`, generated local databases, logs, caches, or local API keys.\n\n---\n\n## Operator Verification\n\nThe verification pass is the source of truth for what was online, failed closed, or missing-key on the last run.\n\n```bash\nnpx tsx scripts/runtimeVerification.mts\n```\n\nIt drives the **real** provider registry and adapter code: public connectors are exercised live where reachable, keyed connectors without keys report `missing-key`, and keyed connectors with keys do a real fetch. It verifies fail-closed boundaries and trust labels, scans normalized output for secret leakage, prints **environment key names only — never values**, and writes [`docs/runtime-verification-log.md`](docs/runtime-verification-log.md).\n\nFull local gate:\n\n```bash\nnpm run lint\nnpm run build\nnpm test\ngit diff --check\nnpx tsx scripts/runtimeVerification.mts\n```\n\nDesktop packaging (when Electron build deps and host requirements are satisfied):\n\n```bash\nnpm run desktop:build\n```\n\n---\n\n## Boundaries\n\nAtlasz Intel is **informational research software**. It is:\n\n- **Not** financial, legal, or sanctions-screening advice.\n- **Not** a trading bot, broker, execution engine, smart order router, or price oracle.\n- **Not** true Level-2 order-book depth unless a real depth connector is added later.\n- **Not** OSINT targeting people — no scraping of private/personal data.\n- **Not** a tool for bypassing authentication, paywalls, CAPTCHAs, or rate limits, and **not** for offensive security automation.\n\nPublic unauthenticated data carries no guarantee of completeness, freshness, or verification — and Atlasz labels it as such.\n\n---\n\n## Source Atlas \u0026 Private Skills\n\nThe OSINT, security, agent, UI, data-engineering, and systems-design corpora in `docs/` are **reference material** unless promoted through the full evidence path: provider registry → adapter tests → source health → persistence → UI.\n\nPrivate Codex/Claude skills are operator-private agent instructions. They are **not** Atlasz runtime, not required for a public checkout, and not source connectors. The repo docs may describe the engineering doctrine; private skills live in the user/agent skill system.\n\n## Release Hygiene\n\nRelease assets exclude `node_modules`, `.env`, generated databases, logs, caches, local screenshots containing secrets, and untracked Electron output unless a desktop package is explicitly produced.\n\n\u003cdiv align=\"center\"\u003e\n\u003cbr/\u003e\n\u003csub\u003ePublic repo · \u003ca href=\"https://github.com/gryszzz/Atlasz-Intel\"\u003egithub.com/gryszzz/Atlasz-Intel\u003c/a\u003e · Real data only.\u003c/sub\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgryszzz%2Fatlasz-intel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgryszzz%2Fatlasz-intel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgryszzz%2Fatlasz-intel/lists"}