feat(boost): scaffold AI Catalog frontend plugin and dev app

Implements Story 1 (RHIDP-15165) — Plugin Scaffold and Dev App for the
AI Catalog frontend feature.

Plugin (plugins/boost/):
- NFS-only frontend plugin with createFrontendPlugin, no legacy entry point
- PageBlueprint at /ai-catalog for the browse page
- EntityCardBlueprint stubs (summary, download, version) with isAiAsset filter
- EntityContentBlueprint stub (usage tab) with isAiAsset filter
- isAiAsset() condition filter for all 7 AI asset kind/type combinations
- useAiAssets() hook wrapping catalogApiRef with client-side filtering
- Placeholder AiCatalogPage component
- i18n scaffold with TranslationBlueprint and translation resource
- Translation module auto-discovery entry point for app.packages: all
- Unit tests for isAiAsset and AiCatalogPage

Dev app (packages/app/):
- NFS app with createApp, RHDH theme, sign-in module, nav module
- Sidebar with AI Catalog and Catalog entries, app-visualizer, user settings

Dev backend (packages/backend/):
- Minimal backend with auth (guest), catalog, techdocs, permission, search

Fixtures and config:
- Sample catalog-info.yaml for all AI asset types
- app-config.yaml with app.packages: all and route redirect

Also adds @red-hat-developer-hub/backstage-plugin-boost to pluginPackages
in all boost-family backend/common/node packages.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: rohitkrai03

workspaces/boost/.changeset/ai-catalog-frontend-scaffold.md

@@ -0,0 +1,12 @@
+---
+'@red-hat-developer-hub/backstage-plugin-boost': minor
+'@red-hat-developer-hub/backstage-plugin-boost-backend': patch
+'@red-hat-developer-hub/backstage-plugin-boost-common': patch
+'@red-hat-developer-hub/backstage-plugin-boost-node': patch
+'@red-hat-developer-hub/backstage-plugin-boost-backend-module-kagenti': patch
+'@red-hat-developer-hub/backstage-plugin-boost-backend-module-llamastack': patch
+'@red-hat-developer-hub/backstage-plugin-boost-responses-api-toolkit': patch
+'@red-hat-developer-hub/backstage-plugin-boost-toolscope': patch
+---
+
+Scaffold AI Catalog frontend plugin, dev app, and dev backend. Adds NFS-only frontend plugin with PageBlueprint, EntityCardBlueprint/EntityContentBlueprint stubs, isAiAsset filter, useAiAssets hook, i18n scaffold, and sample catalog fixtures. Adds boost frontend package to pluginPackages in all boost-family packages.

workspaces/boost/app-config.yaml

@@ -0,0 +1,59 @@
+app:
+  title: Boost Dev
+  baseUrl: http://localhost:3000
+  packages: all
+  extensions:
+    - app/routes:
+        config:
+          redirects:
+            - from: /
+              to: /ai-catalog
+
+organization:
+  name: Red Hat
+
+backend:
+  baseUrl: http://localhost:7007
+  listen:
+    port: 7007
+  cors:
+    origin: http://localhost:3000
+    methods: [GET, HEAD, PATCH, POST, PUT, DELETE]
+    credentials: true
+  database:
+    client: better-sqlite3
+    connection: ':memory:'
+  cache:
+    store: memory
+
+auth:
+  environment: development
+  providers:
+    guest: {}
+
+techdocs:
+  builder: 'local'
+  generator:
+    runIn: 'local'
+  publisher:
+    type: 'local'
+
+catalog:
+  import:
+    entityFilename: catalog-info.yaml
+    pullRequestBranchName: backstage-integration
+  rules:
+    - allow:
+        - Component
+        - System
+        - Group
+        - Resource
+        - Location
+        - Template
+        - API
+        - AiResource
+  locations:
+    - type: file
+      target: ../../fixtures/ai-catalog-fixtures.yaml
+      rules:
+        - allow: [AiResource, API, Component, Resource]

workspaces/boost/fixtures/ai-catalog-fixtures.yaml

@@ -0,0 +1,183 @@
+---
+# AI Catalog sample fixtures — one entity per AI asset category.
+# Used by the dev app for local development and testing.
+
+# ---------------------------------------------------------------------------
+# AiResource / skill
+# ---------------------------------------------------------------------------
+apiVersion: backstage.io/v1alpha1
+kind: AiResource
+metadata:
+  name: code-review-skill
+  title: Code Review Skill
+  description: Automated code review that checks for common issues, security vulnerabilities, and style violations.
+  tags:
+    - code-review
+    - security
+    - quality
+  annotations:
+    rhdh.io/ai-asset-category: skill
+    rhdh.io/ai-asset-version: '1.2.0'
+    rhdh.io/ai-asset-source: github
+    backstage.io/techdocs-ref: dir:.
+  links:
+    - url: https://github.com/example/code-review-skill
+      title: Source Repository
+spec:
+  type: skill
+  lifecycle: production
+  owner: team-ai-platform
+  disciplines:
+    - software-engineering
+  categories:
+    - code-quality
+  agents:
+    - component:default/developer-assistant
+
+---
+# ---------------------------------------------------------------------------
+# AiResource / rule
+# ---------------------------------------------------------------------------
+apiVersion: backstage.io/v1alpha1
+kind: AiResource
+metadata:
+  name: no-hardcoded-secrets-rule
+  title: No Hardcoded Secrets
+  description: Ensures that secrets, API keys, and credentials are never committed to source code repositories.
+  tags:
+    - security
+    - compliance
+    - secrets
+  annotations:
+    rhdh.io/ai-asset-category: rule
+    rhdh.io/ai-asset-version: '2.0.1'
+    rhdh.io/ai-asset-source: internal
+spec:
+  type: rule
+  lifecycle: production
+  owner: team-security
+  category: security
+  rationale: Hardcoded secrets in source code can be extracted by attackers, leading to credential compromise and unauthorized access to systems.
+
+---
+# ---------------------------------------------------------------------------
+# API / mcp-server
+# ---------------------------------------------------------------------------
+apiVersion: backstage.io/v1alpha1
+kind: API
+metadata:
+  name: github-mcp-server
+  title: GitHub MCP Server
+  description: Model Context Protocol server providing GitHub repository context, pull request data, and issue tracking integration.
+  tags:
+    - github
+    - mcp
+    - context
+  annotations:
+    rhdh.io/ai-asset-category: mcp-server
+    rhdh.io/ai-asset-version: '0.9.0'
+    rhdh.io/ai-asset-source: registry
+spec:
+  type: mcp-server
+  lifecycle: experimental
+  owner: team-integrations
+  definition: |
+    openapi: 3.0.0
+    info:
+      title: GitHub MCP Server
+      version: 0.9.0
+  remotes:
+    - url: https://mcp.example.com/github
+      transport: streamable-http
+
+---
+# ---------------------------------------------------------------------------
+# Component / ai-agent
+# ---------------------------------------------------------------------------
+apiVersion: backstage.io/v1alpha1
+kind: Component
+metadata:
+  name: developer-assistant
+  title: Developer Assistant Agent
+  description: An AI agent that helps developers with code generation, debugging, architecture decisions, and documentation.
+  tags:
+    - agent
+    - developer
+    - assistant
+  annotations:
+    rhdh.io/ai-asset-category: agent
+    rhdh.io/ai-asset-version: '3.1.0'
+    rhdh.io/ai-asset-source: internal
+spec:
+  type: ai-agent
+  lifecycle: production
+  owner: team-ai-platform
+
+---
+# ---------------------------------------------------------------------------
+# Resource / ai-model
+# ---------------------------------------------------------------------------
+apiVersion: backstage.io/v1alpha1
+kind: Resource
+metadata:
+  name: granite-3-code
+  title: Granite 3 Code
+  description: IBM Granite 3 code model optimized for code generation, completion, and explanation tasks.
+  tags:
+    - model
+    - code-generation
+    - ibm
+  annotations:
+    rhdh.io/ai-asset-category: model
+    rhdh.io/ai-asset-version: '3.0.0'
+    rhdh.io/ai-asset-source: model-registry
+spec:
+  type: ai-model
+  lifecycle: production
+  owner: team-ml-ops
+
+---
+# ---------------------------------------------------------------------------
+# Resource / ai-tool
+# ---------------------------------------------------------------------------
+apiVersion: backstage.io/v1alpha1
+kind: Resource
+metadata:
+  name: web-search-tool
+  title: Web Search Tool
+  description: A tool that performs web searches and returns structured results for AI agent consumption.
+  tags:
+    - tool
+    - search
+    - web
+  annotations:
+    rhdh.io/ai-asset-category: tool
+    rhdh.io/ai-asset-version: '1.0.0'
+    rhdh.io/ai-asset-source: kagenti
+spec:
+  type: ai-tool
+  lifecycle: experimental
+  owner: team-integrations
+
+---
+# ---------------------------------------------------------------------------
+# Resource / vector-store
+# ---------------------------------------------------------------------------
+apiVersion: backstage.io/v1alpha1
+kind: Resource
+metadata:
+  name: docs-vector-store
+  title: Documentation Vector Store
+  description: Vector store containing embeddings of internal documentation, runbooks, and knowledge base articles.
+  tags:
+    - vector-store
+    - documentation
+    - rag
+  annotations:
+    rhdh.io/ai-asset-category: vector-store
+    rhdh.io/ai-asset-version: '1.1.0'
+    rhdh.io/ai-asset-source: internal
+spec:
+  type: vector-store
+  lifecycle: production
+  owner: team-ai-platform

workspaces/boost/openspec/changes/ai-catalog-frontend/design.md

@@ -56,20 +56,22 @@ Permission checks for `ai-catalog.asset.read.usage-docs` default to allow when t
 
 Backstage v1.51.0 introduced `AiResource` kind and `API` with `spec.type: mcp-server` via `@backstage/plugin-catalog-backend-module-ai-model`. Boost uses upstream kinds where available:
 
-| Category | Entity Kind | spec.type | Notes |
-|---|---|---|---|
-| Skills | AiResource | skill | Upstream. disciplines, categories, agents, dependsOn |
-| Rules | AiResource | rule | Upstream. category (required), rationale (required) |
-| MCP Servers | API | mcp-server | Upstream. spec.remotes list |
-| Agents | Component | ai-agent | Boost-defined |
-| Models | Resource | ai-model | Boost-defined. RFC #33060 pending |
-| Tools | Resource | ai-tool | Boost-defined (Kagenti) |
-| Vector Stores | Resource | vector-store | Boost-defined |
+| Category      | Entity Kind | spec.type    | Notes                                                |
+| ------------- | ----------- | ------------ | ---------------------------------------------------- |
+| Skills        | AiResource  | skill        | Upstream. disciplines, categories, agents, dependsOn |
+| Rules         | AiResource  | rule         | Upstream. category (required), rationale (required)  |
+| MCP Servers   | API         | mcp-server   | Upstream. spec.remotes list                          |
+| Agents        | Component   | ai-agent     | Boost-defined                                        |
+| Models        | Resource    | ai-model     | Boost-defined. RFC #33060 pending                    |
+| Tools         | Resource    | ai-tool      | Boost-defined (Kagenti)                              |
+| Vector Stores | Resource    | vector-store | Boost-defined                                        |
 
 ## Components
 
 ### AiCatalogPage
+
 Browse page with card grid, search, and filters. PluginHeader provided by the framework.
+
 - Card grid grouped by category with responsive layout
 - Debounced keyword search (300ms)
 - Filter controls: category, lifecycle, tags, owner, source connector (AND logic)
@@ -78,28 +80,38 @@ Browse page with card grid, search, and filters. PluginHeader provided by the fr
 - Loading skeletons, empty state with clear-filters, error state with retry
 
 ### AiAssetCard
+
 Card displaying key metadata for one AI asset. Used in the browse grid.
+
 - Name, truncated description, category icon/badge, lifecycle badge
 - Tags, owner, version, source connector indicator
 - Click navigates to catalog entity detail page
 
 ### AiAssetSummaryCard
+
 EntityCardBlueprint on entity overview. Shows AI-specific metadata.
+
 - Category badge, current/recommended version, source attribution, lifecycle
 
 ### DownloadAdoptCard
+
 EntityCardBlueprint on entity overview. Conditional on spec.location.type.
+
 - git: Download button triggers ZIP download via backend proxy
 - oci: docker/podman toggle with copyable pull command
 - Absent: card not rendered
 
 ### VersionListCard
+
 EntityCardBlueprint on entity overview. Shows all versions of the asset.
+
 - Current/recommended highlighted
 - Click navigates to that version's entity page
 
 ### UsageTab
+
 EntityContentBlueprint tab. RBAC-gated usage documentation.
+
 - With usage-docs permission: TechDocs content or external links
 - Without permission: "Contact owner for access" affordance
 
@@ -110,6 +122,7 @@ UX prototype: https://agentic-524bde.pages.redhat.com/skill-marketplace/overview
 ## Acceptance Criteria
 
 ### AiCatalogPage
+
 - Developer sees card grid grouped by category at /ai-catalog
 - Search filters cards within 300ms
 - Multiple filters narrow results with AND logic
@@ -118,23 +131,28 @@ UX prototype: https://agentic-524bde.pages.redhat.com/skill-marketplace/overview
 - Keyboard navigable through all interactive elements
 
 ### AiAssetCard
+
 - Card displays all metadata fields from entity
 - Click navigates to catalog entity detail page
 
 ### AiAssetSummaryCard
+
 - Renders on AI asset entity pages only
 - Shows category, version, source, lifecycle
 
 ### DownloadAdoptCard
+
 - Download button on git assets triggers ZIP download
 - Docker/podman toggle on OCI assets with copyable pull command
 - Not rendered when spec.location.type absent
 
 ### VersionListCard
+
 - Shows all versions; current highlighted
 - Click navigates to version's entity page
 
 ### UsageTab
+
 - Renders TechDocs when annotation present; external links as fallback
 - Shows "Contact owner" when user lacks usage-docs permission
 - Tab only appears on AI asset entities

workspaces/boost/package.json

@@ -40,6 +40,7 @@
   },
   "devDependencies": {
     "@backstage/cli": "^0.36.3",
+    "@backstage/cli-defaults": "^0.1.0",
     "@backstage/e2e-test-utils": "^0.1.2",
     "@backstage/repo-tools": "^0.17.3",
     "@changesets/cli": "^2.27.1",

workspaces/boost/packages/app/.eslintrc.js

@@ -0,0 +1,4 @@
+module.exports = {
+  ...require('@backstage/cli/config/eslint-factory')(__dirname),
+  root: true,
+};