feat(release-tracking): add release-tracking system with MangaUpdates and Nyaa sources

.github/workflows/build.yml

@@ -152,6 +152,8 @@ jobs:
           - metadata-openlibrary
           - recommendations-anilist
           - sync-anilist
+          - release-mangaupdates
+          - release-nyaa
     steps:
       - uses: actions/checkout@v4
       - name: Setup Node.js
@@ -562,6 +564,8 @@ jobs:
           - metadata-openlibrary
           - recommendations-anilist
           - sync-anilist
+          - release-mangaupdates
+          - release-nyaa
     steps:
       - uses: actions/checkout@v4
         with:

.github/workflows/ci.yml

@@ -134,6 +134,8 @@ jobs:
           - metadata-openlibrary
           - recommendations-anilist
           - sync-anilist
+          - release-mangaupdates
+          - release-nyaa
     steps:
       - uses: actions/checkout@v4
       - name: Setup Node.js

Makefile

@@ -271,7 +271,12 @@ plugins-outdated: ## Check for outdated plugin dependencies
 
 plugins-build: ## Build all plugins
 	@echo "$(BLUE)Building plugins...$(NC)"
-	@for dir in $(PLUGIN_DIRS); do \
+	@# sdk-typescript must build first: every other plugin imports from
+	@# its compiled dist, and esbuild fails fast on missing exports if
+	@# the SDK dist is stale.
+	@echo "$(YELLOW)Building sdk-typescript...$(NC)"
+	@(cd plugins/sdk-typescript && npm run build)
+	@for dir in $(PLUGIN_ONLY_DIRS); do \
 		echo "$(YELLOW)Building $$dir...$(NC)"; \
 		(cd plugins/$$dir && npm run build); \
 	done

config/seed-config.sample.yaml

@@ -88,28 +88,72 @@ plugins:
     credential_delivery: env
 
   # AniList Recommendations - Personalized manga recommendations
+  # Recommendation plugins are gated by manifest capability + per-user enable;
+  # they don't write metadata, so no `permissions` or `scopes` are needed.
   - name: recommendations-anilist
     display_name: AniList Recommendations
     description: Personalized manga recommendations from AniList based on reading history
     plugin_type: user
     command: node
     args: ["/opt/codex/plugins/recommendations-anilist/dist/index.js"]
-    permissions:
-      - "metadata:read"
+    permissions: []
     scopes: []
     credential_delivery: env
 
   # AniList Sync - Reading progress sync
+  # Sync plugins are gated by manifest capability + per-user enable; they don't
+  # write series/book metadata, so no `permissions` or `scopes` are needed.
   - name: sync-anilist
     display_name: AniList Sync
     description: Sync manga reading progress between Codex and AniList
     plugin_type: user
     command: node
     args: ["/opt/codex/plugins/sync-anilist/dist/index.js"]
-    permissions:
-      - "metadata:read"
+    permissions: []
+    scopes: []
+    credential_delivery: env
+
+  # MangaUpdates Releases - Translation/scanlation release feed (no credentials needed)
+  # Release-source plugins are gated by manifest capability at reverse-RPC
+  # dispatch; they don't write metadata, so no `permissions` or `scopes` are needed.
+  #
+  # On first start the plugin auto-registers a single source row visible at
+  # Settings → Release tracking. Optional `config.blockedGroups` (CSV) filters
+  # noisy scanlators server-wide.
+  - name: release-mangaupdates
+    display_name: MangaUpdates Releases
+    description: Announces new chapter releases for tracked series via MangaUpdates per-series RSS feeds
+    command: node
+    args: ["/opt/codex/plugins/release-mangaupdates/dist/index.js"]
+    permissions: []
+    scopes: []
+    credential_delivery: env
+    # config:
+    #   blockedGroups: "LowQualityScans,MTL Group"
+
+  # Nyaa Releases - Acquisition-pointer source for trusted uploaders (no credentials needed)
+  #
+  # The `uploaders` config below drives one source row per entry at
+  # Settings → Release tracking. Each entry is one of:
+  #   `username`        -> Nyaa user feed (https://nyaa.si/?page=rss&u=<username>)
+  #   `q:<text>`        -> plain site-wide search
+  #   `q:?<key=value>`  -> URL-style search with allowlisted keys (q, c, f, u),
+  #                        e.g. `q:?c=3_1&q=Berserk` for English-translated
+  #                        Literature category. See plugin docs for details.
+  #
+  # Removing an entry and re-saving prunes its source row (and its
+  # release_ledger history). Per-source poll interval / enable / "Poll now"
+  # live in the Release tracking UI.
+  - name: release-nyaa
+    display_name: Nyaa Releases
+    description: Announces new chapter / volume torrents for tracked series via Nyaa.si uploader RSS feeds
+    command: node
+    args: ["/opt/codex/plugins/release-nyaa/dist/index.js"]
+    permissions: []
     scopes: []
     credential_delivery: env
+    # config:
+    #   uploaders: "tsuna69,TankobonBlur,q:?c=3_1&q=Berserk"
 
 # =============================================================================
 # Libraries

docker-compose.yml

@@ -94,6 +94,8 @@ services:
       - ./plugins/metadata-openlibrary/dist:/opt/codex/plugins/metadata-openlibrary/dist:ro
       - ./plugins/recommendations-anilist/dist:/opt/codex/plugins/recommendations-anilist/dist:ro
       - ./plugins/sync-anilist/dist:/opt/codex/plugins/sync-anilist/dist:ro
+      - ./plugins/release-mangaupdates/dist:/opt/codex/plugins/release-mangaupdates/dist:ro
+      - ./plugins/release-nyaa/dist:/opt/codex/plugins/release-nyaa/dist:ro
     environment:
       RUST_BACKTRACE: 1
       # Email configuration for Mailhog
@@ -156,6 +158,8 @@ services:
       - ./plugins/metadata-openlibrary/dist:/opt/codex/plugins/metadata-openlibrary/dist:ro
       - ./plugins/recommendations-anilist/dist:/opt/codex/plugins/recommendations-anilist/dist:ro
       - ./plugins/sync-anilist/dist:/opt/codex/plugins/sync-anilist/dist:ro
+      - ./plugins/release-mangaupdates/dist:/opt/codex/plugins/release-mangaupdates/dist:ro
+      - ./plugins/release-nyaa/dist:/opt/codex/plugins/release-nyaa/dist:ro
     command:
       [
         "cargo",
@@ -217,6 +221,8 @@ services:
       - /plugins/metadata-openlibrary/node_modules
       - /plugins/recommendations-anilist/node_modules
       - /plugins/sync-anilist/node_modules
+      - /plugins/release-mangaupdates/node_modules
+      - /plugins/release-nyaa/node_modules
     command:
       - sh
       - -c
@@ -228,15 +234,19 @@ services:
         cd /plugins/metadata-openlibrary && npm install && npm run build &&
         cd /plugins/recommendations-anilist && npm install && npm run build &&
         cd /plugins/sync-anilist && npm install && npm run build &&
+        cd /plugins/release-mangaupdates && npm install && npm run build &&
+        cd /plugins/release-nyaa && npm install && npm run build &&
         echo 'Initial build complete. Watching for changes...' &&
         npm install -g concurrently &&
-        concurrently --names 'sdk,echo,mangabaka,openlibrary,rec-anilist,sync-anilist' --prefix-colors 'blue,green,yellow,magenta,cyan,red' \
+        concurrently --names 'sdk,echo,mangabaka,openlibrary,rec-anilist,sync-anilist,rel-mu,rel-nyaa' --prefix-colors 'blue,green,yellow,magenta,cyan,red,gray,white' \
           "cd /plugins/sdk-typescript && npm run dev" \
           "cd /plugins/metadata-echo && npm run dev" \
           "cd /plugins/metadata-mangabaka && npm run dev" \
           "cd /plugins/metadata-openlibrary && npm run dev" \
           "cd /plugins/recommendations-anilist && npm run dev" \
-          "cd /plugins/sync-anilist && npm run dev"
+          "cd /plugins/sync-anilist && npm run dev" \
+          "cd /plugins/release-mangaupdates && npm run dev" \
+          "cd /plugins/release-nyaa && npm run dev"
     networks:
       - codex-network
     profiles:
@@ -375,6 +385,8 @@ services:
       start_period: 30s
     networks:
       - codex-network
+    ports:
+      - "8081:8080"
     profiles:
       - screenshots