# Eclipse Sunset

MCP deprecation radar — detects deprecated/removed tools and versions
from witnessed registry snapshots and generates a migration diff for an
agent's config.

**Scope label: LOCAL / fixture.** v0.1 ingests local registry snapshot
JSON files only. It does not crawl live registries. Live crawling is a
later phase.

**Status: v0.1.1 — CERTIFIED (local, fixture)** (Verity re-bench,
2026-10-26: probe 5 chain-attack suite 4/4 + strict extras 9/9, full
prior suite 44/44; D1 closed). Spec: `SPEC.md`.

## Novel mechanism

Sunset notices are witnessed against registry history, so a
"deprecated" claim is provable — and the migration diff is generated
from the witnessed before/after schemas, not scraped docs.

Each ingested snapshot is SHA-256 hashed over its canonical JSON and
hash-chained in ingest order (`chain_hash = sha256(prev_hash +
snapshot_hash)`). Findings cite both snapshot hashes of the witnessed
pair. A claim with no witnessed pair behind it returns `UNPROVEN`.

## Tools (exactly 5)

| Tool | What it does |
|---|---|
| `ingest_snapshot` | Validate a snapshot (`server_id`, `version`, `tools[]` with `name`/`inputSchema`/`deprecated`), hash it, chain-append it; returns snapshot id + chain position. |
| `detect_sunsets` | Between two witnessed snapshots of the same server: tools removed, tools newly deprecated, version changes, schema-breaking changes — each finding cites both snapshot hashes. |
| `migration_diff` | Given a server + an agent config listing tools used, produce the diff: which used tools are sunset in the newer witnessed snapshot and what changed in their schemas. |
| `verify_sunset_claim` | Claim "tool X deprecated/removed" → `PROVEN` only if a witnessed snapshot pair supports it, else `UNPROVEN`. |
| `chain_status` | Verify hash-chain integrity (recomputes every hash + link; tamper → `valid: false`). |

## Fixtures

`fixtures/weather-v1.json` and `fixtures/weather-v2.json`: the same
fixture server at v1.0.0 / v2.0.0 — one tool removed (`legacy_lookup`),
one deprecated (`get_alerts`), one schema-breaking change
(`get_forecast` gains required `units`), one unchanged
(`convert_units`). `fixtures/agent-config.json` is a sample agent
config for `migration_diff`.

## Pricing

FREE + funnel role — free radar feeds paid listing-hygiene and
re-bench work. No payment anything in this server.

## Run

```
python3 server.py            # MCP over stdio JSON-RPC
python3 -m unittest discover -s tests -v
```

State (the witnessed chain ledger) lives in `data/` or the directory
named by `SUNSET_DATA_DIR`.

Python 3, standard library only.

MIT License · Copyright © 2026 Cyan Eclipse Technologies LLC · cetech.ai