Skip to main content
Glama

πŸ›°οΈ SHIRYAN (Ψ΄Ψ±ΩŠΨ§Ω†) β€” The Energy-Artery Sentinel

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.

Repo layout

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

Related MCP server: Botverse

Quick start

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).

Quickstart

bash scripts/quickstart.sh

Runs 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.

Status

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.

Obsidian

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.

CI

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.

Built autonomously

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP tools for video transcoding, document conversion, and multi-step pipelines β€” callable by any AI agent.
      12
      60 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to operate a US power-grid data pipeline – ingest, plan, run, and monitor datasets like CAISO, ERCOT, and EIA-930 through MCP tools that mirror the CLI.
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Exposes geospatial foundation model inference as MCP tools for LLM agents, enabling building extraction, water segmentation, object detection, change detection, zero-shot scene classification, and embeddings on CPU.
      3
      GPL 3.0