SurfSense/plugins/registry/published/README.md
Anish Sarkar a0c715633b feat(plugins): the third-party plugin registry, its check, signing and container
plugins/registry/ holds the list publishers add to by pull request, starting
with DeepWiki, and its icons. registry_check checks every entry and icon rule;
on dev, CI signs the list with Ed25519 into published/, which the release pull
request carries to main, so nothing pushes to main and the source list is
never rewritten. A small Caddy container serves the signed list, its icons and
SurfSense's OAuth client document and callback page on plugins.surfsense.com,
apart from the plugin host so a listing never restarts the scrapers. CI does
not contact listed servers: most need a sign-in, so a maintainer connects each
listing on dev. plugins/README.md is the guide for publishers.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 15:59:55 +05:30

446 B

published/

Written by CI only. Do not edit.

On every merge to dev that changes ../plugins.json or ../icons/, the sign job in plugins-registry.yml writes plugins.json here, stamped with generated_at and each icon's icon_sha256, and plugins.json.sig, its Ed25519 signature. The registry container serves these two files. A pull request that edits this folder fails its checks.