feat(augment): add augment AI assistant workspace (#2555)

* feat(augment): add augment AI assistant workspace

Introduces the augment plugin family (frontend, backend, common) under
workspaces/augment. Provides a chat interface backed by Llama Stack with
multi-agent orchestration, RAG, MCP tool calling, and configurable
safety guardrails.

Key capabilities:
- Multi-agent architecture with router, cluster-engineer, and
  product-knowledge specialist agents
- Streaming chat via SSE with conversation history
- MCP server integration for live OpenShift cluster operations
  and Red Hat knowledge platform queries
- Human-in-the-loop tool approval
- RHDH dynamic plugin support (frontend scalprum + backend)
- Configurable security modes (none, plugin-only, full)
- Response evaluation via Llama Stack Scoring API

Signed-off-by: Raghu Banda <rbanda@redhat.com>

* Apply suggestion from @nickboldt

* Apply suggestion from @nickboldt

* fix(augment): fix CI and SonarCloud issues

---------

Signed-off-by: Raghu Banda <rbanda@redhat.com>
Co-authored-by: Nick Boldt <nboldt@redhat.com>

Author: rrbanda

workspaces/augment/.changeset/augment-initial-release.md

@@ -0,0 +1,7 @@
+---
+'@red-hat-developer-hub/backstage-plugin-augment': minor
+'@red-hat-developer-hub/backstage-plugin-augment-backend': minor
+'@red-hat-developer-hub/backstage-plugin-augment-common': minor
+---
+
+Initial release of the Augment AI assistant plugin for Backstage. Provides a chat interface backed by Llama Stack with RAG, tool calling, multi-agent orchestration, and configurable safety guardrails.

workspaces/augment/.changeset/config.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "privatePackages": {
+    "tag": false,
+    "version": false
+  }
+}

workspaces/augment/.dockerignore

@@ -0,0 +1,8 @@
+.git
+.yarn/cache
+.yarn/install-state.gz
+node_modules
+packages/*/src
+packages/*/node_modules
+plugins
+*.local.yaml

workspaces/augment/.eslintignore

@@ -0,0 +1 @@
+playwright.config.ts

workspaces/augment/.eslintrc.js

@@ -0,0 +1 @@
+module.exports = require('../../.eslintrc.cjs');

workspaces/augment/.gitignore

@@ -1,3 +1,20 @@
+# macOS
+.DS_Store
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Coverage directory generated when running tests with coverage
+coverage
+
+# Dependencies
+node_modules/
+
 # Yarn files
 .pnp.*
 .yarn/*
@@ -6,3 +23,36 @@
 !.yarn/releases
 !.yarn/sdks
 !.yarn/versions
+
+# Node version directives
+.nvmrc
+
+# dotenv environment variables file
+.env
+.env.test
+
+# Build output
+dist
+dist-types
+
+# Temporary change files created by Vim
+*.swp
+
+# MkDocs build output
+site
+
+# Local configuration files
+*.local.yaml
+
+# Sensitive credentials
+*-credentials.yaml
+
+# vscode database functionality support files
+*.session.sql
+
+# E2E test reports
+e2e-test-report/
+
+# Dev/ops helper scripts (keep local, not shipped with plugin)
+plugins/augment-common/docs/scripts/
+plugins/augment-backend/scripts/

workspaces/augment/.prettierignore

@@ -0,0 +1,9 @@
+dist
+dist-types
+coverage
+.vscode
+.eslintrc.js
+
+generated
+report.api.md
+knip-report.md

workspaces/augment/README.md

@@ -1,12 +1,29 @@
-# Augment AI Assistant Workspace
+# Augment Workspace
 
-This workspace contains the Augment AI assistant plugins for Backstage:
+This workspace contains the Augment plugin family for Red Hat Developer Hub.
 
-- **@red-hat-developer-hub/backstage-plugin-augment** — Frontend chat interface with streaming responses, conversation history, and admin settings
-- **@red-hat-developer-hub/backstage-plugin-augment-backend** — Backend plugin providing Responses API integration with Llama Stack, MCP server proxy, RAG, and multi-agent orchestration
-- **@red-hat-developer-hub/backstage-plugin-augment-common** — Shared types, API refs, and permission definitions
+Augment is a configurable AI assistant with RAG, multi-agent orchestration, tool calling via MCP servers, and safety guardrails.
 
-## Maintainers
+## Plugins
 
-- @rrbanda
-- @pkliczewski
+| Plugin                                                                                | Description                  |
+| ------------------------------------------------------------------------------------- | ---------------------------- |
+| [@red-hat-developer-hub/backstage-plugin-augment](./plugins/augment/)                 | Frontend plugin              |
+| [@red-hat-developer-hub/backstage-plugin-augment-backend](./plugins/augment-backend/) | Backend plugin               |
+| [@red-hat-developer-hub/backstage-plugin-augment-common](./plugins/augment-common/)   | Shared types and permissions |
+
+## Development
+
+```bash
+# Install dependencies
+yarn install
+
+# Start the dev server
+yarn dev
+
+# Run tests
+yarn test:all
+
+# Build all plugins
+yarn build:all
+```

workspaces/augment/app-config.yaml

@@ -0,0 +1,38 @@
+app:
+  title: Augment AI Assistant
+  baseUrl: http://localhost:3000
+
+organization:
+  name: Red Hat
+
+backend:
+  baseUrl: http://localhost:7007
+  listen:
+    port: 7007
+  csp:
+    connect-src: ["'self'", 'http:', 'https:']
+  cors:
+    origin: http://localhost:3000
+    methods: [GET, HEAD, PATCH, POST, PUT, DELETE]
+    credentials: true
+  database:
+    client: better-sqlite3
+    connection: ':memory:'
+
+auth:
+  environment: development
+  providers:
+    guest: {}
+
+catalog:
+  import:
+    entityFilename: catalog-info.yaml
+    pullRequestBranchName: backstage-integration
+  rules:
+    - allow: [Component, System, API, Resource, Location]
+
+# Augment plugin configuration
+augment:
+  llamaStack:
+    baseUrl: ${AUGMENT_LLAMA_STACK_URL:-http://localhost:8321}
+    model: ${AUGMENT_MODEL:-meta-llama/Llama-3.3-70B-Instruct}

workspaces/augment/backstage.json

@@ -0,0 +1 @@
+{ "version": "1.45.0" }