Sovereign, onboard-AI infrastructure-integrity intelligence for Saudi Arabia. "We see the excavator before the rupture." — built for SARI 2 (Saudi Space Agency).
SHIRYAN watches the Kingdom's pipeline & critical-infrastructure corridors, detects third-party intrusion / geohazards / leaks from before/after imagery, and downlinks the decision (a small alert), not the image — delivered to operators and to AI agents via an MCP server, and shown live in the SHIRYAN Watch demo.
This repository is the ground-side product, MCP server, and pitch demo. The flight satellite is built later with SSA. See DESIGN.md for the spec and scope.
shiryan/
├─ packages/
│ ├─ core/ @shiryan/core — change detection, ROW geofencing, alert synthesis (pure TS, tested)
│ ├─ data/ @shiryan/data — corridors, sample scenes, Sentinel-2 converters
│ └─ mcp-server/ @shiryan/mcp-server — SHIRYAN intelligence as MCP tools (stdio, 4 tools)
├─ apps/
│ └─ web/ SHIRYAN Watch — MapLibre live demo (builds offline)
├─ scripts/ fetch-sentinel.ts — optional live Copernicus fetch (env creds; graceful fallback)
├─ data/ sample corridors + cached Sentinel-2 tiles
├─ docs/ architecture, pitch, Obsidian links
└─ DESIGN.md README.md STATE.md PROGRESS.md AGENT.md AGENTS.md memory.md LOG.md NOTES.md DECISIONS.md
npm install # installs workspace dev deps (typescript, @types/node)
npm run verify # typecheck + tests (the gate — must be green)
npm run typecheck # types only
npm test # tests only (node --test, runs TypeScript natively)Requires Node ≥ 22 (developed on Node 24; uses native TypeScript type-stripping, no build step for tests).
bash scripts/quickstart.shRuns an end-to-end offline SHIRYAN flow (load corridor → detect change → emit alerts → persist & read back history) and prints the result. One command, no network.
| Component | State |
|---|---|
@shiryan/core |
✅ working + tested |
@shiryan/data |
✅ corridors + sample scene + geojson |
@shiryan/mcp-server |
✅ stdio MCP, 4 tools, tested over stdio |
apps/web (SHIRYAN Watch) |
✅ MapLibre demo, builds offline (npm run build -w @shiryan/web) |
| Real Sentinel-2 fetch | ⬜ planned (P4) |
| Full backlog: PROGRESS.md. |
Research, strategy, scoring, and the winning dossiers live in the Obsidian vault:
../Sarri 2 Vault/00_SARI2_Idea_Engine/ (flagship dossier: Round2/Model-1/Ideas/flagship.md).
This repo is the build; the vault is the brain. See memory.md.
One-command gate for any runner: bash scripts/verify.sh (typecheck + lint + test + build, offline). Per-package coverage: bash scripts/coverage.sh. See AGENT.md.
Developed via an overnight night-loop: fresh context each pass, filesystem-as-memory (DESIGN+README+ledger), one verified task per worker, green-gate-only commits. See AGENTS.md.