redhat-developer
diff --git a/‎.dockerignore‎
Lines changed: 1 addition & 0 deletions b/‎.dockerignore‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎.github/workflows/generate-catalog-index.yaml‎
Lines changed: 578 additions & 0 deletions b/‎.github/workflows/generate-catalog-index.yaml‎
Lines changed: 578 additions & 0 deletions
diff --git a/‎.github/workflows/github-script/sync-user-guide-to-wiki.js‎
Lines changed: 35 additions & 5 deletions b/‎.github/workflows/github-script/sync-user-guide-to-wiki.js‎
Lines changed: 35 additions & 5 deletions
diff --git a/‎.github/workflows/validate-catalog-scripts.yaml‎
Lines changed: 40 additions & 0 deletions b/‎.github/workflows/validate-catalog-scripts.yaml‎
Lines changed: 40 additions & 0 deletions
diff --git a/‎CLAUDE.md‎
Lines changed: 2 additions & 1 deletion b/‎CLAUDE.md‎
Lines changed: 2 additions & 1 deletion
diff --git a/‎Dockerfile.catalog-index‎
Lines changed: 9 additions & 0 deletions b/‎Dockerfile.catalog-index‎
Lines changed: 9 additions & 0 deletions
diff --git a/‎default.packages.yaml‎
Lines changed: 71 additions & 0 deletions b/‎default.packages.yaml‎
Lines changed: 71 additions & 0 deletions
@@ -0,0 +1 @@
+**/build-report.json
@@ -26,6 +26,7 @@ const FILE_MAP = {
   'user-guide/04-metadata-synchronization.md': 'Metadata-Synchronization',
   'user-guide/05-version-updates.md': 'Version-Updates',
   'user-guide/06-patch-management.md': 'Patch-Management',
+  'user-guide/07-plugin-catalog-index.md': 'Plugin-Catalog-Index-Generation',
 };
 
 // Link transformations for wiki format
@@ -37,6 +38,7 @@ const LINK_TRANSFORMS = [
   { from: /\[([^\]]+)\]\(\.\/04-metadata-synchronization\.md(#[^\)]+)?\)/g, to: '[$1](Metadata-Synchronization$2)' },
   { from: /\[([^\]]+)\]\(\.\/05-version-updates\.md(#[^\)]+)?\)/g, to: '[$1](Version-Updates$2)' },
   { from: /\[([^\]]+)\]\(\.\/06-patch-management\.md(#[^\)]+)?\)/g, to: '[$1](Patch-Management$2)' },
+  { from: /\[([^\]]+)\]\(\.\/07-plugin-catalog-index\.md(#[^\)]+)?\)/g, to: '[$1](Plugin-Catalog-Index-Generation$2)' },
 ];
 
 // Source repository metadata
@@ -213,10 +215,13 @@ function transformForWiki(content, dynamicContent) {
 /**
  * Generate the wiki sidebar navigation
  */
-function generateSidebar(workspaceStats, reportPages) {
+function generateSidebar(workspaceStats, reportPages, catalogStatusPages) {
   const reportLinks = reportPages.length > 0
     ? reportPages.map(({ branchName, pageName }) => `  * [${branchName}](${pageName})`).join('\n')
     : '  * [main](main)';
+  const catalogLinks = catalogStatusPages.length > 0
+    ? '\n' + catalogStatusPages.map(({ branchName, pageName }) => `  * [${branchName}](${pageName})`).join('\n')
+    : '';
 
   return `### 📚 User Guide
 * [Home](Home)
@@ -228,11 +233,13 @@ function generateSidebar(workspaceStats, reportPages) {
 * [Metadata Synchronization](Metadata-Synchronization)
 * [Version Updates](Version-Updates)
 * [Patch Management](Patch-Management)
+* [Plugin Catalog Index](Plugin-Catalog-Index-Generation)
 
 ### 📊 Generated Reports
 * [Backstage Compatibility Report](Backstage-Compatibility-Report)
 * [Workspace Status Reports](Workspace-Status-Reports)
 ${reportLinks}
+* [Plugin Catalog Index Status](Plugin-Catalog-Index-Status)${catalogLinks}
 
 ### 📈 Stats
 * **${workspaceStats.total}** workspaces
@@ -269,6 +276,27 @@ async function detectWorkspaceStatusReportPages(wikiDir) {
   return pages;
 }
 
+/**
+ * Detect branch-specific catalog status pages in the wiki.
+ * Expected page names are `Plugin-Catalog-Status-*`.
+ */
+async function detectCatalogStatusPages(wikiDir) {
+  const prefix = 'Plugin-Catalog-Status-';
+  const files = await fs.readdir(wikiDir, { withFileTypes: true });
+  return files
+    .filter(file => file.isFile() && file.name.startsWith(prefix) && file.name.endsWith('.md'))
+    .map(file => {
+      const pageName = file.name.replace(/\.md$/, '');
+      const branchName = pageName.slice(prefix.length);
+      return { pageName, branchName };
+    })
+    .sort((a, b) => {
+      if (a.branchName === 'main') return -1;
+      if (b.branchName === 'main') return 1;
+      return b.branchName.localeCompare(a.branchName, undefined, { numeric: true });
+    });
+}
+
 /**
  * Generate a discoverability page for branch-specific workspace status reports.
  */
@@ -444,6 +472,8 @@ async function syncUserGuideToWiki({ github, context, core }) {
     // Detect existing workspace status report pages before writing new content
     const reportPages = await detectWorkspaceStatusReportPages(wikiDir);
     core.info(`Detected ${reportPages.length} workspace status report pages`);
+    const catalogStatusPages = await detectCatalogStatusPages(wikiDir);
+    core.info(`Detected ${catalogStatusPages.length} catalog status pages`);
 
     // Process each user guide file
     core.info('\nProcessing user guide files...');
@@ -470,7 +500,7 @@ async function syncUserGuideToWiki({ github, context, core }) {
 
     // Generate sidebar with stats
     core.info('Generating _Sidebar.md...');
-    await fs.writeFile(join(wikiDir, '_Sidebar.md'), generateSidebar(workspaceStats, reportPages), 'utf-8');
+    await fs.writeFile(join(wikiDir, '_Sidebar.md'), generateSidebar(workspaceStats, reportPages, catalogStatusPages), 'utf-8');
 
     // Generate workspace status reports index page
     core.info('Generating Workspace-Status-Reports.md...');
@@ -495,7 +525,9 @@ async function syncUserGuideToWiki({ github, context, core }) {
     }
 
     // Push changes
-    if (!dryRun) {
+    if (dryRun) {
+      core.info('\n🔍 Dry run complete - no changes pushed');
+    } else {
       const commitMessage = `docs: sync user guide from main repository
 
 Synced from commit: ${context.sha?.substring(0, 7) || 'unknown'}
@@ -509,8 +541,6 @@ Triggered by: ${context.eventName}`;
         core.info('\n✅ Wiki updated successfully');
         core.info(`View at: https://github.com/${owner}/${repo}/wiki`);
       }
-    } else {
-      core.info('\n🔍 Dry run complete - no changes pushed');
     }
 
     return { success: true, filesProcessed, versions, workspaceStats };
 
@@ -0,0 +1,40 @@
+name: Validate catalog index scripts
+
+on:
+  pull_request:
+    branches:
+      - main
+      - 'release-*'
+    paths:
+      - 'scripts/*.py'
+      - 'scripts/tests/**'
+      - 'scripts/requirements-dev.txt'
+      - '.github/workflows/validate-catalog-scripts.yaml'
+  workflow_dispatch:
+
+concurrency:
+  group: validate-catalog-scripts-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Python unit tests
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Setup Python
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: '3.12'
+
+      - name: Install dependencies
+        run: pip install -r scripts/requirements-dev.txt
+
+      - name: Run tests
+        working-directory: scripts
+        run: python -m pytest tests/ -v
@@ -413,7 +413,8 @@ Trigger nightly manually: comment `/test e2e-ocp-helm-nightly` on a PR.
 ## Documentation
 
 - `README.md` — Repo overview, PR workflow, testing procedures
-- `user-guide/` — 6-part contributor guide (getting started, export tools, ownership, metadata sync, versions, patches)
+- `user-guide/` — 6-part contributor guide (getting started, export tools, ownership, metadata sync, versions, patches) plus catalog index pipeline docs
+- `user-guide/troubleshooting-catalog-index.md` — Troubleshooting content embedded by `renderCatalogStatus.py` into each generated status page. Anchor slugs must stay in sync with `REASON_ANCHORS` in the renderer
 - `catalog-entities/extensions/README.md` — Extensions catalog metadata format
 - GitHub Wiki — Auto-synced from `user-guide/` with dynamic content injection (`{{AUTO:*}}` placeholders replaced from `versions.json`)
 - **E2E test utils docs** — https://github.com/redhat-developer/rhdh-e2e-test-utils/tree/main/docs — latest API docs, changelogs, tutorials, and configuration reference for `@red-hat-developer-hub/e2e-test-utils`
@@ -0,0 +1,9 @@
+FROM scratch
+ARG TIER=supported
+COPY catalog-index/${TIER}/ /
+USER 65534
+
+LABEL summary="Red Hat Developer Hub plugin catalog index" \
+      description="Red Hat Developer Hub plugin catalog index" \
+      maintainer="RHDH Team <rhdh-bot@redhat.com>" \
+      vendor="Red Hat, Inc."
@@ -0,0 +1,71 @@
+# MANUALLY maintained list of "core plugins"
+#
+# Do not add packages to this list without prior agreement from PM
+#
+# New packages should only be "tech-preview" or "generally-available"
+#    16 are tech-preview, and should be promoted via a PM-sponsored Feature to generally-available at some point
+#    06 are community, and should be removed over time
+packages:
+  enabled: # should onyly include GA (or TP with a path to GA) content here
+  - package: '@backstage-community/plugin-analytics-provider-segment' # generally-available
+  - package: '@backstage-community/plugin-scaffolder-backend-module-regex' # generally-available
+  - package: '@backstage/plugin-techdocs' # generally-available
+  - package: '@backstage/plugin-techdocs-backend' # generally-available
+  - package: '@backstage/plugin-techdocs-module-addons-contrib' # generally-available
+  - package: '@red-hat-developer-hub/backstage-plugin-adoption-insights' # generally-available
+  - package: '@red-hat-developer-hub/backstage-plugin-adoption-insights-backend' # generally-available
+  - package: '@red-hat-developer-hub/backstage-plugin-analytics-module-adoption-insights' # generally-available
+  - package: '@red-hat-developer-hub/backstage-plugin-catalog-backend-module-extensions' # tech-preview
+  - package: '@red-hat-developer-hub/backstage-plugin-dynamic-home-page' # generally-available
+  - package: '@red-hat-developer-hub/backstage-plugin-global-floating-action-button' # generally-available
+  - package: '@red-hat-developer-hub/backstage-plugin-global-header' # generally-available
+  - package: '@red-hat-developer-hub/backstage-plugin-extensions' # tech-preview
+  - package: '@red-hat-developer-hub/backstage-plugin-extensions-backend' # tech-preview
+  - package: '@red-hat-developer-hub/backstage-plugin-quickstart' # generally-available
+
+  disabled: # should ideally contain no community content; TODO: remove some community or TP stuff in 2.1?
+  - package: '@backstage-community/plugin-acr' # tech-preview
+  - package: '@backstage-community/plugin-catalog-backend-module-keycloak' # generally-available
+  - package: '@backstage-community/plugin-catalog-backend-module-pingidentity' # tech-preview
+  - package: '@backstage-community/plugin-catalog-backend-module-scaffolder-relation-processor' # tech-preview
+  - package: '@backstage-community/plugin-rbac' # generally-available
+  - package: '@backstage-community/plugin-scaffolder-backend-module-kubernetes' # generally-available
+  - package: '@backstage-community/plugin-tech-radar' # generally-available
+  - package: '@backstage-community/plugin-tech-radar-backend' # generally-available
+  - package: '@backstage-community/plugin-topology' # generally-available
+  - package: '@backstage/plugin-catalog-backend-module-github' # generally-available
+  - package: '@backstage/plugin-catalog-backend-module-github-org' # generally-available
+  - package: '@backstage/plugin-catalog-backend-module-gitlab' # production
+  - package: '@backstage/plugin-catalog-backend-module-gitlab-org' # production
+  - package: '@backstage/plugin-catalog-backend-module-ldap' # generally-available
+  - package: '@backstage/plugin-catalog-backend-module-msgraph' # generally-available
+  - package: '@backstage/plugin-events-backend-module-github' # tech-preview
+  - package: '@backstage/plugin-kubernetes' # tech-preview
+  - package: '@backstage/plugin-kubernetes-backend' # generally-available
+  - package: '@backstage/plugin-notifications' # tech-preview
+  - package: '@backstage/plugin-notifications-backend' # tech-preview
+  - package: '@backstage/plugin-notifications-backend-module-email' # tech-preview
+  - package: '@backstage/plugin-scaffolder-backend-module-github' # generally-available
+  - package: '@backstage/plugin-scaffolder-backend-module-gitlab' # tech-preview
+  - package: '@backstage/plugin-signals' # tech-preview
+  - package: '@backstage/plugin-signals-backend' # generally-available
+  - package: '@red-hat-developer-hub/backstage-plugin-bulk-import' # tech-preview
+  - package: '@red-hat-developer-hub/backstage-plugin-bulk-import-backend' # tech-preview
+  - package: '@red-hat-developer-hub/backstage-plugin-homepage-backend' # tech-preview
+  # Lightspeed plugins are enabled by default in the install methods (Helm chart, Operator)
+  - package: '@red-hat-developer-hub/backstage-plugin-lightspeed' # generally-available
+  - package: '@red-hat-developer-hub/backstage-plugin-lightspeed-backend' # generally-available
+  - package: '@red-hat-developer-hub/backstage-plugin-orchestrator' # generally-available
+  - package: '@red-hat-developer-hub/backstage-plugin-orchestrator-backend' # generally-available
+  - package: '@red-hat-developer-hub/backstage-plugin-orchestrator-backend-module-loki' # tech-preview
+  - package: '@red-hat-developer-hub/backstage-plugin-orchestrator-form-widgets' # generally-available
+  - package: '@red-hat-developer-hub/backstage-plugin-scaffolder-backend-module-orchestrator' # generally-available
+  - package: '@roadiehq/scaffolder-backend-module-http-request' # generally-available
+
+  # these community supported plugins do not have a downstream analogue in overlays repo's rhdh-supported-packages.txt
+  - package: '@backstage-community/plugin-quay' # community
+  - package: '@backstage-community/plugin-quay-backend' # community
+  - package: '@backstage-community/plugin-scaffolder-backend-module-quay' # community
+  - package: '@backstage-community/plugin-tekton' # community
+  - package: '@roadiehq/backstage-plugin-argo-cd-backend' # community - TODO: replace with RH Argo CD plugin when it's ready
+  - package: '@roadiehq/scaffolder-backend-argocd' # community - TODO: replace with RH Argo CD plugin when it's ready