Merge pull request #4 from harche/cluster-update-ui

OTA-1973: Add cluster update console plugin with Lightspeed proposal integration

Author: openshift-merge-bot[bot]

.gitignore

@@ -13,3 +13,4 @@ install-state.gz
 !.yarn/releases
 !.yarn/sdks
 !.yarn/versions
+.playwright-cli/

AGENTS.md

@@ -3,18 +3,18 @@
     "type": "console.page/route",
     "properties": {
       "exact": true,
-      "path": "/example",
-      "component": { "$codeRef": "ExamplePage" }
+      "path": "/administration/cluster-update",
+      "component": { "$codeRef": "ClusterUpdatePage" }
     }
   },
   {
     "type": "console.navigation/href",
     "properties": {
-      "id": "example",
-      "name": "%plugin__console-plugin-template~Plugin example%",
-      "href": "/example",
+      "id": "cluster-update",
+      "name": "%plugin__cluster-update-console-plugin~Cluster Update%",
+      "href": "/administration/cluster-update",
       "perspective": "admin",
-      "section": "home"
+      "section": "administration"
     }
   }
 ]

console-extensions.json

@@ -9,7 +9,7 @@ module.exports = {
   locales: ['en'],
   namespaceSeparator: '~',
   reactNamespace: false,
-  defaultNamespace: 'plugin__console-plugin-template',
+  defaultNamespace: 'plugin__cluster-update-console-plugin',
   useKeysAsDefaultValue: true,
 
   // see below for more details

i18next-parser.config.js

@@ -0,0 +1,15 @@
+import type { Config } from 'jest';
+
+const config: Config = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src'],
+  testMatch: ['**/__tests__/**/*.test.ts'],
+  moduleFileExtensions: ['ts', 'tsx', 'js'],
+  moduleNameMapper: {
+    '@openshift-console/dynamic-plugin-sdk':
+      '<rootDir>/src/__mocks__/@openshift-console/dynamic-plugin-sdk.ts',
+  },
+};
+
+export default config;

jest.config.ts

@@ -0,0 +1,111 @@
+{
+  "{{count}} incompatible with target_one": "{{count}} incompatible with target_one",
+  "{{count}} incompatible with target_other": "{{count}} incompatible with target_other",
+  "{{count}} manual approval_one": "{{count}} manual approval_one",
+  "{{count}} manual approval_other": "{{count}} manual approval_other",
+  "{{count}} pending upgrade_one": "{{count}} pending upgrade_one",
+  "{{count}} pending upgrade_other": "{{count}} pending upgrade_other",
+  "{{passed}}/{{total}} checks passed": "{{passed}}/{{total}} checks passed",
+  "{{passed}}/{{total}} checks passed, {{failures}} failed": "{{passed}}/{{total}} checks passed, {{failures}} failed",
+  "{{passed}}/{{total}} checks passed, {{warnings}} warnings": "{{passed}}/{{total}} checks passed, {{warnings}} warnings",
+  "{{total}} operators managed by OLM": "{{total}} operators managed by OLM",
+  "Action failed": "Action failed",
+  "Active update plans": "Active update plans",
+  "Activity summary and the current proposed plan - {{channel}} channel": "Activity summary and the current proposed plan - {{channel}} channel",
+  "Affected: {{resources}}": "Affected: {{resources}}",
+  "Age": "Age",
+  "Agent target version": "Agent target version",
+  "AI Assessment": "AI Assessment",
+  "AI is analyzing your cluster for upgrade readiness...": "AI is analyzing your cluster for upgrade readiness...",
+  "AI Update Agent": "AI Update Agent",
+  "All Clear": "All Clear",
+  "Analyzing": "Analyzing",
+  "API Deprecations": "API Deprecations",
+  "Approval": "Approval",
+  "Approve & upgrade": "Approve & upgrade",
+  "Awaiting Decision": "Awaiting Decision",
+  "Channel": "Channel",
+  "Check": "Check",
+  "Close": "Close",
+  "Cluster Metrics": "Cluster Metrics",
+  "Cluster Update": "Cluster Update",
+  "Completed": "Completed",
+  "Confirm approve & upgrade": "Confirm approve & upgrade",
+  "Confirm reject": "Confirm reject",
+  "CPU utilization": "CPU utilization",
+  "Detail": "Detail",
+  "Duration": "Duration",
+  "ends {{date}}": "ends {{date}}",
+  "Error loading cluster version": "Error loading cluster version",
+  "Estimated Duration": "Estimated Duration",
+  "Estimated Impact": "Estimated Impact",
+  "etcd fsync p99": "etcd fsync p99",
+  "Failed to create plan": "Failed to create plan",
+  "Findings": "Findings",
+  "Findings table": "Findings table",
+  "Generate plan": "Generate plan",
+  "Generated": "Generated",
+  "In the OCP 5.0 agent led experience, the update agent proposes plans and drives execution. OpenShift Lightspeed can still run a pre-check on cluster and operator readiness before you approve, so risks and prerequisites stay visible alongside automated planning.": "In the OCP 5.0 agent led experience, the update agent proposes plans and drives execution. OpenShift Lightspeed can still run a pre-check on cluster and operator readiness before you approve, so risks and prerequisites stay visible alongside automated planning.",
+  "Lightspeed proposals unavailable": "Lightspeed proposals unavailable",
+  "Loading": "Loading",
+  "Maintenance Details": "Maintenance Details",
+  "Memory utilization": "Memory utilization",
+  "Minor": "Minor",
+  "Monitor Command": "Monitor Command",
+  "Name": "Name",
+  "No active update plans": "No active update plans",
+  "No deprecated APIs in use": "No deprecated APIs in use",
+  "No issues found — all readiness checks passed.": "No issues found — all readiness checks passed.",
+  "No maintenance details available.": "No maintenance details available.",
+  "No update history available": "No update history available",
+  "Not reversible": "Not reversible",
+  "OCP Compat": "OCP Compat",
+  "OLM Operator Lifecycle": "OLM Operator Lifecycle",
+  "OLM operators table": "OLM operators table",
+  "Operator": "Operator",
+  "Pending": "Pending",
+  "Phase": "Phase",
+  "Pick a target from your channel (updates AI Assessment), then click Generate plan to build or refresh the proposed update below.": "Pick a target from your channel (updates AI Assessment), then click Generate plan to build or refresh the proposed update below.",
+  "Plan ready — approving will start the cluster upgrade. You will be redirected to the cluster settings page to monitor progress.": "Plan ready — approving will start the cluster upgrade. You will be redirected to the cluster settings page to monitor progress.",
+  "Plans Created": "Plans Created",
+  "Pre-check with AI": "Pre-check with AI",
+  "Prerequisites": "Prerequisites",
+  "Proposed Update: {{current}}": "Proposed Update: {{current}}",
+  "Readiness Checks": "Readiness Checks",
+  "Readiness data not yet available.": "Readiness data not yet available.",
+  "Ready to proceed": "Ready to proceed",
+  "Reject plan": "Reject plan",
+  "Reversibility": "Reversibility",
+  "Reversible": "Reversible",
+  "Review available versions, assess operator compatibility, and plan how this cluster version is newer OpenShift releases. Use Updates plan to prepare or start an update, Active update plans for in-flight work, and Update history for completed ones.": "Review available versions, assess operator compatibility, and plan how this cluster version is newer OpenShift releases. Use Updates plan to prepare or start an update, Active update plans for in-flight work, and Update history for completed ones.",
+  "Risk assessment not yet available.": "Risk assessment not yet available.",
+  "Risk Level": "Risk Level",
+  "Schedule for later": "Schedule for later",
+  "Select a version": "Select a version",
+  "Severity": "Severity",
+  "Started": "Started",
+  "Status": "Status",
+  "Support": "Support",
+  "Target version": "Target version",
+  "Target Version": "Target Version",
+  "Target version {{version}} not found in available updates": "Target version {{version}} not found in available updates",
+  "The Lightspeed Proposal CRD is not installed on this cluster. AI-driven update planning features are disabled.": "The Lightspeed Proposal CRD is not installed on this cluster. AI-driven update planning features are disabled.",
+  "There are no update plans currently in progress.": "There are no update plans currently in progress.",
+  "This cluster has no recorded update history.": "This cluster has no recorded update history.",
+  "unknown": "unknown",
+  "Update": "Update",
+  "Update history": "Update history",
+  "Update Type": "Update Type",
+  "Updates Executed": "Updates Executed",
+  "Updates plan": "Updates plan",
+  "Upgrade Command": "Upgrade Command",
+  "upgrade pending": "upgrade pending",
+  "upgrade to {{version}}": "upgrade to {{version}}",
+  "Verified": "Verified",
+  "Version": "Version",
+  "Version {{version}}, {{count}} available_one": "Version {{version}}, {{count}} available_one",
+  "Version {{version}}, {{count}} available_other": "Version {{version}}, {{count}} available_other",
+  "View etcd pods": "View etcd pods",
+  "View monitoring": "View monitoring",
+  "z-stream": "z-stream"
+}

locales/en/plugin__cluster-update-console-plugin.json

@@ -1,7 +1,7 @@
 {
-  "name": "console-plugin-template",
+  "name": "cluster-update-console-plugin",
   "version": "0.0.1",
-  "description": "Template project for OpenShift Console plugins",
+  "description": "AI-driven cluster update experience for OpenShift",
   "private": true,
   "license": "Apache-2.0",
   "repository": {
@@ -15,6 +15,7 @@
     "start": "yarn webpack serve --progress",
     "start-console": "./start-console.sh",
     "i18n": "./i18n-scripts/build-i18n.sh && node ./i18n-scripts/set-english-defaults.js",
+    "test": "jest",
     "lint": "yarn eslint src integration-tests --fix && stylelint 'src/**/*.css' --allow-empty-input --fix",
     "test-cypress": "cd integration-tests && cypress open",
     "test-cypress-headless": "cd integration-tests && node --max-old-space-size=4096 ../node_modules/.bin/cypress run --browser ${BRIDGE_E2E_BROWSER_NAME:-electron}",
@@ -32,6 +33,7 @@
     "@patternfly/react-core": "^6.2.2",
     "@patternfly/react-icons": "^6.2.2",
     "@patternfly/react-table": "^6.2.2",
+    "@types/jest": "^30.0.0",
     "@types/node": "^22.0.0",
     "@types/react": "^17.0.37",
     "@types/react-router-dom": "^5.3.3",
@@ -49,6 +51,7 @@
     "globals": "^17.4.0",
     "i18next": "^23.11.5",
     "i18next-parser": "^9.4.0",
+    "jest": "^30.3.0",
     "mocha": "^11.7.5",
     "mocha-junit-reporter": "^2.2.1",
     "mochawesome": "^7.1.4",
@@ -65,6 +68,7 @@
     "style-loader": "^4.0.0",
     "stylelint": "^17.4.0",
     "stylelint-config-standard": "^40.0.0",
+    "ts-jest": "^29.4.9",
     "ts-loader": "^9.5.4",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
@@ -74,12 +78,12 @@
     "webpack-dev-server": "^5.2.3"
   },
   "consolePlugin": {
-    "name": "console-plugin-template",
+    "name": "cluster-update-console-plugin",
     "version": "0.0.1",
-    "displayName": "OpenShift Console Plugin Template",
-    "description": "Template project for OpenShift Console plugins. Edit package.json to change this message and the plugin name.",
+    "displayName": "Cluster Update Console Plugin",
+    "description": "AI-driven cluster update experience for OpenShift",
     "exposedModules": {
-      "ExamplePage": "./components/ExamplePage"
+      "ClusterUpdatePage": "./components/ClusterUpdatePage"
     },
     "dependencies": {
       "@console/pluginAPI": "^4.21.0"

locales/en/plugin__console-plugin-template.json

@@ -0,0 +1,47 @@
+export const getGroupVersionKindForModel = (model: {
+  apiGroup?: string;
+  apiVersion: string;
+  kind: string;
+}) => ({
+  group: model.apiGroup || '',
+  version: model.apiVersion,
+  kind: model.kind,
+});
+
+export const getAPIVersionForModel = (model: { apiGroup?: string; apiVersion: string }) =>
+  model.apiGroup ? `${model.apiGroup}/${model.apiVersion}` : model.apiVersion;
+
+export const k8sCreate = jest.fn();
+export const k8sPatch = jest.fn();
+
+export type K8sModel = {
+  apiGroup?: string;
+  apiVersion: string;
+  kind: string;
+  plural: string;
+  abbr: string;
+  namespaced: boolean;
+  label: string;
+  labelPlural: string;
+};
+
+export type K8sResourceCommon = {
+  apiVersion?: string;
+  kind?: string;
+  metadata?: {
+    name?: string;
+    namespace?: string;
+    labels?: Record<string, string>;
+    annotations?: Record<string, string>;
+    uid?: string;
+    creationTimestamp?: string;
+  };
+};
+
+export type K8sResourceCondition = {
+  type: string;
+  status: string;
+  lastTransitionTime?: string;
+  reason?: string;
+  message?: string;
+};

package.json

@@ -0,0 +1,23 @@
+import { isTerminalPhase, TERMINAL_PHASES } from '../utils/constants';
+
+describe('isTerminalPhase', () => {
+  it('returns true for terminal phases', () => {
+    for (const phase of TERMINAL_PHASES) {
+      expect(isTerminalPhase(phase)).toBe(true);
+    }
+  });
+
+  it('returns false for non-terminal phases', () => {
+    expect(isTerminalPhase('Pending')).toBe(false);
+    expect(isTerminalPhase('Analyzing')).toBe(false);
+    expect(isTerminalPhase('Executing')).toBe(false);
+  });
+
+  it('returns true for undefined (no active phase)', () => {
+    expect(isTerminalPhase(undefined)).toBe(true);
+  });
+
+  it('returns true for empty string', () => {
+    expect(isTerminalPhase('')).toBe(true);
+  });
+});