Add model maintenance automation

.github/workflows/model-catalog.yml

@@ -0,0 +1,33 @@
+name: Check model catalog
+
+on:
+  pull_request:
+    paths:
+      - "models/catalog.json"
+      - "scripts/check-model-catalog.mjs"
+      - ".github/workflows/model-catalog.yml"
+  push:
+    branches: [main]
+    paths:
+      - "models/catalog.json"
+      - "scripts/check-model-catalog.mjs"
+      - ".github/workflows/model-catalog.yml"
+  schedule:
+    - cron: "23 2 * * 1"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
+        with:
+          node-version: "22"
+      - name: Validate catalog and canonical URLs
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        run: node scripts/check-model-catalog.mjs --network

CHANGELOG.md

@@ -1,43 +1,44 @@
-# Changelog
-
-All notable public example changes are recorded here.
-
-## Unreleased
-
-### Added
-
-- Runnable focused repositories and cURL quickstarts for Seedance 2.5, MiniMax H3, FLUX 3 Video, Qwen Image 3, Kimi K3, GPT-5.6, and Claude Opus 5.
-- Exact production model IDs, current pricing snapshots, request limits, and GitHub Actions checks for both 2026 model batches.
-- Focused `seedream-5-0-pro-api` repository for structured image generation, reference-guided editing, polling, and webhook workflows.
-- Focused model repository links for Claude Sonnet 5, Nano Banana 2 Lite, Grok Imagine Image, Omni Flash, and Kling 3.0 Turbo.
-- cURL quickstarts for current high-interest models: `claude-sonnet-5`, `nano-banana-2-lite`, and `omni-flash`.
-- cURL quickstarts for recent model workflows: `grok-imagine-image`, `seedance-2-mini`, and `kling-3.0-turbo/standard`.
-- Repository maintenance docs for contributors and security reporting.
-- Issue templates for bug reports and example requests.
-- README first-screen path for backend-safe task submission, `task_id` handling, polling, and webhooks.
-- README and shared notes for failed task cost behavior in production integrations.
-
-### Changed
-
-- Seedance 2.5 is now documented as a live API integration; stale coming-soon and 4K claims were removed.
-- README and cURL indexes now prioritize the two latest model batches for Google, AI answer engines, and GitHub discovery.
-- README and cURL indexes now surface Seedream 5.0 Pro as the current image-model quickstart.
-- README, cURL index, and GitHub organization profile now surface Claude Sonnet 5, Nano Banana 2 Lite, and Omni Flash entry points.
-- README and cURL index now surface recent model quickstarts as follow-up links for new model posts.
-- README now links the maintenance, contribution, and security resources.
-- README workflow navigation now starts from developer goals instead of repository categories.
-- GitHub organization profile now points developers to `poyo-examples` first, with focused model repos as secondary entry points.
-- Focused model repository README first screens now repeat the backend-safe submit, `task_id`, polling, and webhook workflow.
-- Model-specific repositories now include Linguist metadata so PowerShell check scripts do not dominate GitHub language labels.
-- Main examples repository now includes Linguist metadata so the PowerShell check script does not dominate GitHub language labels.
-
-## v0.1.0 - 2026-05-31
-
+# Changelog
+
+All notable public example changes are recorded here.
+
+## Unreleased
+
 ### Added
 
-- First production workflow examples for PoYo AI APIs.
-- cURL quickstarts for `gpt-image-2`, `seedance-2`, `sora-2`, `generate-music`, `meshy-6-text-to-3d`, and `gpt-5.2`.
-- Node.js examples for image, video, and chat workflows.
-- Python examples for image, video, and chat workflows.
-- Express and FastAPI webhook receivers.
-- Shared production notes for task IDs, polling, webhooks, and response handling.
+- Machine-readable featured model catalog, `llms.txt`, a 45-day freshness policy, and weekly canonical-link validation.
+- Runnable focused repositories and cURL quickstarts for Seedance 2.5, MiniMax H3, FLUX 3 Video, Qwen Image 3, Kimi K3, GPT-5.6, and Claude Opus 5.
+- Exact production model IDs, current pricing snapshots, request limits, and GitHub Actions checks for both 2026 model batches.
+- Focused `seedream-5-0-pro-api` repository for structured image generation, reference-guided editing, polling, and webhook workflows.
+- Focused model repository links for Claude Sonnet 5, Nano Banana 2 Lite, Grok Imagine Image, Omni Flash, and Kling 3.0 Turbo.
+- cURL quickstarts for current high-interest models: `claude-sonnet-5`, `nano-banana-2-lite`, and `omni-flash`.
+- cURL quickstarts for recent model workflows: `grok-imagine-image`, `seedance-2-mini`, and `kling-3.0-turbo/standard`.
+- Repository maintenance docs for contributors and security reporting.
+- Issue templates for bug reports and example requests.
+- README first-screen path for backend-safe task submission, `task_id` handling, polling, and webhooks.
+- README and shared notes for failed task cost behavior in production integrations.
+
+### Changed
+
+- Seedance 2.5 is now documented as a live API integration; stale coming-soon and 4K claims were removed.
+- README and cURL indexes now prioritize the two latest model batches for Google, AI answer engines, and GitHub discovery.
+- README and cURL indexes now surface Seedream 5.0 Pro as the current image-model quickstart.
+- README, cURL index, and GitHub organization profile now surface Claude Sonnet 5, Nano Banana 2 Lite, and Omni Flash entry points.
+- README and cURL index now surface recent model quickstarts as follow-up links for new model posts.
+- README now links the maintenance, contribution, and security resources.
+- README workflow navigation now starts from developer goals instead of repository categories.
+- GitHub organization profile now points developers to `poyo-examples` first, with focused model repos as secondary entry points.
+- Focused model repository README first screens now repeat the backend-safe submit, `task_id`, polling, and webhook workflow.
+- Model-specific repositories now include Linguist metadata so PowerShell check scripts do not dominate GitHub language labels.
+- Main examples repository now includes Linguist metadata so the PowerShell check script does not dominate GitHub language labels.
+
+## v0.1.0 - 2026-05-31
+
+### Added
+
+- First production workflow examples for PoYo AI APIs.
+- cURL quickstarts for `gpt-image-2`, `seedance-2`, `sora-2`, `generate-music`, `meshy-6-text-to-3d`, and `gpt-5.2`.
+- Node.js examples for image, video, and chat workflows.
+- Python examples for image, video, and chat workflows.
+- Express and FastAPI webhook receivers.
+- Shared production notes for task IDs, polling, webhooks, and response handling.