From b7958360a4ef1fa87d546ef9cab3d8faef03afdb Mon Sep 17 00:00:00 2001 From: TMHSDigital Date: Wed, 17 Jun 2026 16:16:11 -0400 Subject: [PATCH] fix(catalog): generate search index, footer version, and standards grid from source [skip version] Three hand-maintained regions of docs/index.html had silently drifted and were not covered by sync-check: - The inline search-index block was frozen at 9 of 14 tools, so the five newest tools (developer-tools-mcp, cfx-mcp, blender, local-ai, screencast) were unsearchable on the live site (D1). - The footer version was hardcoded v1.9.5 against a real latest tag of v1.17.0 (D2). - The standards grid was missing born-green-contract and its count read 18 for 19 standards (F2). - docs/search-index.json was generated by aggregate_search.py but never fetched by the page; the page read only the inline block (F3). sync_from_registry.py now owns all four: it reconciles docs/search-index.json from the registry (preserving the scanned skill/rule/MCP-tool name arrays), mirrors it into the inline fallback block, sets the footer from VERSION, and generates the standards grid and count from the standards/*.md listing. Each new region is best-effort so a minimal catalog without a VERSION file or standards directory is left untouched. All four are covered by --check. setupSearch now fetches search-index.json at runtime with the inline block as the offline/file:// fallback, so the file and the embedded copy agree (P1n). aggregate_search.py merges with the existing index so refreshing without a full fleet checkout no longer discards previously scanned names. Co-Authored-By: Claude Opus 4.8 Signed-off-by: TMHSDigital --- docs/index.html | 41 +++--- docs/search-index.json | 2 +- scripts/sync_from_registry.py | 231 +++++++++++++++++++++++++++++- site-template/aggregate_search.py | 34 ++++- tests/test_scaffold_born_green.py | 4 +- 5 files changed, 281 insertions(+), 31 deletions(-) diff --git a/docs/index.html b/docs/index.html index 244dd8b..1594cd3 100644 --- a/docs/index.html +++ b/docs/index.html @@ -257,7 +257,7 @@

Developer Tools Directory

Standards

- 18 + 19
@@ -282,6 +282,7 @@

Standards

Security

Vulnerability disclosure, secrets handling, and workflow supply chain

Licensing

DCO + inbound license grant model

Scope

What belongs in the directory and what does not

 +

Born-Green Contract

Acceptance criterion that any generator must produce a release-ready repo

Lifecycle

Tool status transitions from experimental to archived

Writing Style

Prose conventions across all repos
@@ -318,7 +319,7 @@

Scaffold Generator

- v1.9.5 + v1.17.0 · CC-BY-NC-ND-4.0 · @@ -341,8 +342,8 @@

Scaffold Generator

+[{"name":"CFX Developer Tools","slug":"cfx-developer-tools","description":"AI-powered Cursor IDE plugin for FiveM and RedM resource development","type":"cursor-plugin","topics":["fivem","redm","cfx","lua","game-development"],"npm":"","url":"https://github.com/TMHSDigital/CFX-Developer-Tools","homepage":"https://tmhsdigital.github.io/CFX-Developer-Tools/","skills":["Client-Server Patterns","Database Integration","Framework Detection","fxmanifest.lua Expert","Native Function Lookup","NUI Development","Performance Optimization","Resource Scaffolding","State Bags"],"rules":["Cfx Csharp Conventions","Cfx Javascript Conventions","Cfx Lua Conventions","Fxmanifest Standards","Performance Rules","Security Best Practices"],"mcpTools":[]},{"name":"Unity Developer Tools","slug":"unity-developer-tools","description":"Cursor IDE plugin for Unity game development with URP, HDRP, and Built-in render pipeline support","type":"cursor-plugin","topics":["unity","game-development","csharp","urp","hdrp"],"npm":"","url":"https://github.com/TMHSDigital/Unity-Developer-Tools","homepage":"https://tmhsdigital.github.io/Unity-Developer-Tools/","skills":["Addressables and Asset Management","Animation Systems","Audio Systems","ECS and DOTS","Editor Scripting","Input Systems","MonoBehaviour Patterns","Multiplayer Networking","Performance Optimization","Physics Systems (2D and 3D)","Platform Targeting","Unity Project Setup","Render Pipeline Detection","ScriptableObject Architecture","Shader Development","Unity Testing","UI Development","Visual Scripting"],"rules":["Csharp Unity Conventions","Monobehaviour Lifecycle","Naming Conventions","Performance Rules","Security And Builds","Serialization Rules","Shader Conventions","Visual Scripting Conventions"],"mcpTools":[]},{"name":"Docker Developer Tools","slug":"docker-developer-tools","description":"Cursor IDE plugin for Docker workflows with container management, Compose, and Dockerfile support","type":"cursor-plugin","topics":["docker","containers","devops","docker-compose","dockerfile"],"npm":"@tmhs/docker-mcp","url":"https://github.com/TMHSDigital/Docker-Developer-Tools","homepage":"https://tmhsdigital.github.io/Docker-Developer-Tools/","skills":["Container Debugging","Docker Advanced Workflows","Docker CI/CD","Docker Compose Helper","Docker Context Management","Docker Development Environment","Docker Content Trust and Image Signing","Docker Multi-Platform Builds","Docker Networking","Docker Registry","Docker Resource Management","Docker Security","Docker Swarm Orchestration","Docker Troubleshooting","Docker Volumes","Dockerfile Best Practices","Image Optimization"],"rules":["Buildx Best Practices","Compose Scaling","Compose Validation","Docker Image Pinning","Docker Logging","Docker Port Conflicts","Docker Resource Limits","Docker Secrets","Dockerfile Lint","Swarm Security"],"mcpTools":["docker_commit","docker_containerLogs","docker_containerPrune","docker_cp","docker_create","docker_diff","docker_events","docker_exec","docker_export","docker_inspectContainer","docker_kill","docker_listContainers","docker_pause","docker_port","docker_rename","docker_restart","docker_rm","docker_run","docker_start","docker_stats","docker_stop","docker_top","docker_unpause","docker_update","docker_wait","docker_build","docker_imageHistory","docker_imagePrune","docker_import","docker_inspectImage","docker_listImages","docker_load","docker_pull","docker_push","docker_rmi","docker_save","docker_tag","docker_login","docker_logout","docker_searchHub","docker_composeBuild","docker_composeConfig","docker_composeCp","docker_composeCreate","docker_composeDown","docker_composeEvents","docker_composeExec","docker_composeImages","docker_composeKill","docker_composeLogs","docker_composeLs","docker_composePause","docker_composePort","docker_composePs","docker_composePull","docker_composeRestart","docker_composeRm","docker_composeRun","docker_composeScale","docker_composeStart","docker_composeStop","docker_composeTop","docker_composeUnpause","docker_composeUp","docker_composeVersion","docker_composeWatch","docker_listVolumes","docker_volumeCreate","docker_volumeInspect","docker_volumePrune","docker_volumeRm","docker_listNetworks","docker_networkConnect","docker_networkCreate","docker_networkDisconnect","docker_networkInspect","docker_networkPrune","docker_networkRm","docker_diskUsage","docker_systemInfo","docker_systemPrune","docker_version","docker_builderPrune","docker_buildxBuild","docker_buildxCreate","docker_buildxImagetools","docker_buildxInspect","docker_buildxLs","docker_buildxRm","docker_buildxUse","docker_manifestAnnotate","docker_manifestCreate","docker_manifestInspect","docker_manifestPush","docker_manifestRm","docker_contextCreate","docker_contextInspect","docker_contextLs","docker_contextRm","docker_contextShow","docker_contextUse","docker_swarmCa","docker_swarmInit","docker_swarmJoin","docker_swarmJoinToken","docker_swarmLeave","docker_swarmUnlock","docker_swarmUnlockKey","docker_swarmUpdate","docker_serviceCreate","docker_serviceInspect","docker_serviceLogs","docker_serviceLs","docker_servicePs","docker_serviceRm","docker_serviceRollback","docker_serviceScale","docker_serviceUpdate","docker_nodeDemote","docker_nodeInspect","docker_nodeLs","docker_nodePromote","docker_nodePs","docker_nodeRm","docker_nodeUpdate","docker_stackConfig","docker_stackDeploy","docker_stackLs","docker_stackPs","docker_stackRm","docker_stackServices","docker_configCreate","docker_configInspect","docker_configLs","docker_configRm","docker_secretCreate","docker_secretInspect","docker_secretLs","docker_secretRm","docker_trustInspect","docker_trustKey","docker_trustRevoke","docker_trustSign","docker_scoutCves","docker_scoutQuickview","docker_scoutRecommendations","docker_pluginEnable","docker_pluginInstall","docker_pluginLs","docker_pluginRm"]},{"name":"Home Lab Developer Tools","slug":"home-lab-developer-tools","description":"Home lab and Raspberry Pi workflows for Cursor with Docker Compose, monitoring, DNS, networking, and security","type":"cursor-plugin","topics":["homelab","raspberry-pi","infrastructure","docker-compose","monitoring"],"npm":"@tmhs/homelab-mcp","url":"https://github.com/TMHSDigital/Home-Lab-Developer-Tools","homepage":"https://tmhsdigital.github.io/Home-Lab-Developer-Tools/","skills":["Alerting Rules","Ansible Workflows","Backup and Recovery","Certificate Management","Disaster Recovery","DNS Management","Docker Compose Stacks","Grafana Dashboards","Log Analysis","Multi-Node Management","Network Configuration","Notification Workflows","OS Update Management","Performance Tuning","Pi System Management","Reverse Proxy Management","Secrets Management","Security Hardening","Service Monitoring","SSH Management","Storage Management","Troubleshooting"],"rules":["Ansible Best Practices","Backup Coverage","Compose Arm64","Exposed Ports","Homelab Secrets","Inventory Consistency","Privileged Containers","Resource Limits","Ssh Safety","Weak Credentials","Yaml Conventions"],"mcpTools":["homelab_inventorySync","homelab_nodeList","homelab_nodeStatus","homelab_nodeExec","homelab_sshTest","homelab_healthCheck","homelab_diagnostics","homelab_piStatus","homelab_piReboot","homelab_diskUsage","homelab_kernelInfo","homelab_systemdServices","homelab_aptUpdate","homelab_aptUpgradable","homelab_aptHistory","homelab_networkInfo","homelab_openPorts","homelab_ufwStatus","homelab_fail2banStatus","homelab_composeUp","homelab_composeDown","homelab_composePull","homelab_composePs","homelab_serviceHealth","homelab_serviceLogs","homelab_serviceRestart","homelab_containerScan","homelab_logSearch","homelab_journalLogs","homelab_backupStatus","homelab_backupRun","homelab_backupList","homelab_backupRestore","homelab_backupDiff","homelab_volumeBackup","homelab_certCheck","homelab_certRenew","homelab_certList","homelab_npmCerts","homelab_npmProxyHosts","homelab_prometheusQuery","homelab_grafanaSnapshot","homelab_uptimeKumaStatus","homelab_alertList","homelab_speedtestResults","homelab_adguardStats","homelab_adguardFilters","homelab_adguardQueryLog","homelab_ntfySend","homelab_ntfyTopics"]},{"name":"Mobile App Developer Tools","slug":"mobile-app-developer-tools","description":"Cursor plugin for mobile app development with React Native, Expo, and Flutter support","type":"cursor-plugin","topics":["react-native","expo","flutter","mobile-development","typescript"],"npm":"@tmhs/mobile-mcp","url":"https://github.com/TMHSDigital/Mobile-App-Developer-Tools","homepage":"https://tmhsdigital.github.io/Mobile-App-Developer-Tools/","skills":["Mobile Accessibility Testing","Mobile AI Features","Mobile Analytics","Google Play Store Submission","Mobile Animations","Mobile API Integration","Mobile App Monitoring","App Store Prep","Mobile Auth Setup","Mobile Background Tasks","Mobile Camera Integration","Mobile CI/CD","Mobile Component Patterns","Mobile Config Plugins","Mobile Debugging","Mobile Deep Links","Mobile Dev Environment","Mobile E2E Testing","Mobile Feature Flags","Flutter Navigation","Flutter Project Setup","Flutter Run on Device","Flutter State Management","Mobile Forms and Validation","Mobile Internationalization","iOS App Store Submission","Mobile Local Storage","Mobile Maps and Location","Mobile Monetization","Mobile Native Modules","Mobile Navigation Setup","Mobile Offline Sync","Mobile OTA Updates","Mobile Permissions","Mobile Project Setup","Mobile Push Notifications","Mobile Real-Time","Mobile Run on Device","Mobile SDK Upgrade","Mobile Security","Mobile State Management","Mobile Testing","Mobile Theming & Dark Mode"],"rules":["Mobile Accessibility","Mobile Bundle Size","Mobile Color Contrast","Mobile Env Safety","Mobile I18N Strings","Mobile Image Assets","Mobile Native Compat","Mobile Performance","Mobile Platform Check","Mobile Secrets","Mobile Security Audit","Mobile Test Coverage"],"mcpTools":[]},{"name":"Plaid Developer Tools","slug":"plaid-developer-tools","description":"Cursor plugin and MCP companion for building on the Plaid API","type":"cursor-plugin","topics":["plaid","fintech","banking","open-banking","plaid-api"],"npm":"","url":"https://github.com/TMHSDigital/Plaid-Developer-Tools","homepage":"https://tmhsdigital.github.io/Plaid-Developer-Tools/","skills":["Plaid Account Verification","Plaid API Reference","Plaid Category Mapping","Plaid Error Handling","Plaid Identity Verification","Plaid Institution Search","Plaid Investment Tracking","Plaid Link Setup","Plaid Migration Guide","Plaid Next.js Integration","Plaid Production Readiness","Plaid React Integration","Plaid Recurring Detection","Plaid Sandbox Testing","Plaid Security Best Practices","Plaid Transaction Sync","Plaid Webhook Handling"],"rules":["Plaid Env Safety","Plaid Error Handling","Plaid Link Best Practices","Plaid Secrets","Plaid Sync Cursor","Plaid Token Storage","Plaid Webhook Security"],"mcpTools":[]},{"name":"Monday Cursor Plugin","slug":"monday-cursor-plugin","description":"Cursor IDE plugin for Monday.com with boards, items, sprints, docs, dashboards, and GraphQL","type":"cursor-plugin","topics":["monday","project-management","graphql","productivity","work-management"],"npm":"","url":"https://github.com/TMHSDigital/Monday-Cursor-Plugin","homepage":"https://tmhsdigital.github.io/Monday-Cursor-Plugin/","skills":["Monday API Reference","Monday Board Insights","Monday Board Management","Monday Chart Visualization","Monday Column Types Guide","Monday Dashboard Builder","Monday Docs Management","Monday Form Builder","Monday Item Operations","Monday Notetaker Meetings","Monday Notifications","Monday Project Tracking","Monday Resource Management","Monday Sprint Planning","Monday Sprint Review","Monday Tags and Assets","Monday Updates and Communication","Monday User and Team Management","Monday Webhook Management","Monday Workflow Automation","Monday Workspace Organizer"],"rules":["Monday Api Token Safety","Monday Board Structure","Monday Column Value Format","Monday Error Handling","Monday Graphql Best Practices","Monday Mcp Tool Preference","Monday Rate Limit Awareness","Monday Webhook Validation"],"mcpTools":["get_user_context","search","list_users_and_teams","get_board_info","get_board_items_page","board_insights","create_board","create_group","create_column","create_item","change_item_column_values","get_updates","create_update","get_board_activity","list_workspaces","workspace_info","create_workspace","update_workspace","create_folder","update_folder","move_object","read_docs","create_doc","add_content_to_doc","create_dashboard","create_widget","all_widgets_schema","create_form","get_form","update_form","form_questions_editor","get_monday_dev_sprints_boards","get_sprints_metadata","get_sprint_summary","get_notetaker_meetings","get_graphql_schema","get_type_details","get_column_type_info","all_monday_api","show-chart","show-battery","show-table","show-assign","create_notification"]},{"name":"Steam Cursor Plugin","slug":"steam-cursor-plugin","description":"Steam and Steamworks integration for Cursor IDE for game developers, modders, and power users","type":"cursor-plugin","topics":["steam","steamworks","game-development","modding","steam-workshop"],"npm":"","url":"https://github.com/TMHSDigital/Steam-Cursor-Plugin","homepage":"https://tmhsdigital.github.io/Steam-Cursor-Plugin/","skills":["Steam Achievement Designer","Steam Anti-Cheat Integration","Steam API Reference","Steam Bug Report Template","Steam Build Automation","Steam Cloud Saves","Steam Community Management","Steam DLC & Expansion Planning","Steam Friends & Social","Steam Game Comparison","Steam Input / Controller Support","Steam Inventory & Economy","Steam Leaderboards","Steam Market Research","Steam Migration Guide","Steam Multiplayer Networking","Steam Player Stats","Steam Playtest Setup","Steam Price History","Steam Pricing Strategy","Steam Profile Lookup","Steam Release Checklist","Steam Review Analysis","Steam SteamCMD Helper","Steam Store Lookup","Steam Store Page Optimizer","Steam Testing Sandbox","Steam Wishlist Estimates","Steam Workshop Helper","Steamworks App Config"],"rules":["Steam Api Error Handling","Steam Api Key Usage","Steam Appid Validation","Steam Build Config Validation","Steam Deck Compat","Steam Launch Options Check","Steam Network Security","Steam Save Compat","Steamworks Secrets"],"mcpTools":["steam_getAppDetails","steam_searchApps","steam_getPlayerCount","steam_getAchievementStats","steam_getWorkshopItem","steam_getReviews","steam_getPriceOverview","steam_getAppReviewSummary","steam_getRegionalPricing","steam_getNewsForApp","steam_getPlayerSummary","steam_getOwnedGames","steam_queryWorkshop","steam_getLeaderboardEntries","steam_resolveVanityURL","steam_getSchemaForGame","steam_getPlayerAchievements","steam_getLeaderboardsForGame","steam_createLobby","steam_uploadWorkshopItem","steam_updateWorkshopItem","steam_setAchievement","steam_clearAchievement","steam_uploadLeaderboardScore","steam_grantInventoryItem"]},{"name":"Steam MCP Server","slug":"steam-mcp","description":"MCP server for Steam and Steamworks APIs with store data, player stats, reviews, achievements, and workshop tools","type":"mcp-server","topics":["steam","mcp-server","steamworks","game-development","npm"],"npm":"@tmhs/steam-mcp","url":"https://github.com/TMHSDigital/steam-mcp","homepage":"https://www.npmjs.com/package/@tmhs/steam-mcp","skills":[],"rules":[],"mcpTools":[]},{"name":"Developer Tools MCP","slug":"developer-tools-mcp","description":"MCP server providing agent-callable read and write access to the TMHSDigital developer-tools ecosystem: registry, fleet status, drift checking, and standards management","type":"mcp-server","topics":["mcp-server","developer-tools","ecosystem","registry","typescript"],"npm":"","url":"https://github.com/TMHSDigital/Developer-Tools-MCP","homepage":"https://tmhsdigital.github.io/Developer-Tools-MCP/","skills":[],"rules":[],"mcpTools":[]},{"name":"CFX MCP","slug":"cfx-mcp","description":"MCP server providing agent-callable tools for CFX/FiveM resource development, server management, and community platform integration.","type":"mcp-server","topics":[],"npm":"","url":"https://github.com/TMHSDigital/cfx-mcp","homepage":"","skills":[],"rules":[],"mcpTools":[]},{"name":"Blender Developer Tools","slug":"blender-developer-tools","description":"Cursor and Claude Code skills, rules, snippets, and templates for Blender Python add-on and scripting development","type":"cursor-plugin","topics":["blender","python","bpy","3d","addon-development"],"npm":"","url":"https://github.com/TMHSDigital/Blender-Developer-Tools","homepage":"","skills":[],"rules":[],"mcpTools":[]},{"name":"Local AI MCP","slug":"local-ai-mcp","description":"Unified MCP server for managing local model runtimes (Ollama, LM Studio, and more): provider-agnostic discovery, lifecycle, hardware-fit, and delegated inference.","type":"mcp-server","topics":["mcp","model-context-protocol","ollama","lm-studio","local-llm"],"npm":"@tmhs/local-ai-mcp","url":"https://github.com/TMHSDigital/local-ai-mcp","homepage":"https://tmhsdigital.github.io/local-ai-mcp/","skills":[],"rules":[],"mcpTools":[]},{"name":"Screencast MCP","slug":"screencast-mcp","description":"MCP server for Windows screen recording, frame sampling, and minimal ffmpeg edits (capture, watch, trim/concat/convert).","type":"mcp-server","topics":["mcp-server","developer-tools","screen-recording","ffmpeg","windows"],"npm":"","url":"https://github.com/TMHSDigital/screencast-mcp","homepage":"https://tmhsdigital.github.io/screencast-mcp/","skills":[],"rules":[],"mcpTools":[]}] + )', + r'()', re.DOTALL, ) if not pattern.search(text): raise SystemExit( - "Could not find