From 6bd7618c6d87938024c5be4a9e7c79017718114d Mon Sep 17 00:00:00 2001 From: Andy Pickering Date: Thu, 18 Jun 2026 12:02:13 +0900 Subject: [PATCH 1/3] Add plugin SDK doc references to AGENTS.md --- AGENTS.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 7b7455b2..61e10a1d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -27,6 +27,15 @@ extensions used by this plugin. built-in plugin proxy at `/api/proxy/plugin/lightspeed-console-plugin/ols`. This avoids CORS issues and leverages the console's authentication. +**Plugin SDK docs:** When working with console extensions, SDK APIs, or +PatternFly compatibility, fetch the relevant docs from the `openshift/console` +repo. The URLs below use the `main` branch of `openshift/console`; to target +a specific OCP version, replace `main` in the URL with the corresponding +`openshift/console` branch (e.g. `release-4.17`): +- SDK overview: `https://raw.githubusercontent.com/openshift/console/main/frontend/packages/console-dynamic-plugin-sdk/README.md` +- Extension types: `https://raw.githubusercontent.com/openshift/console/main/frontend/packages/console-dynamic-plugin-sdk/docs/console-extensions.md` +- API reference (hooks, components, K8s utilities): `https://raw.githubusercontent.com/openshift/console/main/frontend/packages/console-dynamic-plugin-sdk/docs/api.md` + ### Data flow The user types a prompt and optionally attaches context from the Kubernetes From b4dd58bf9e0228cc4ca37c3d92d66cec40982efc Mon Sep 17 00:00:00 2001 From: Andy Pickering Date: Thu, 18 Jun 2026 12:07:19 +0900 Subject: [PATCH 2/3] Expand git workflow note in AGENTS.md --- AGENTS.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 61e10a1d..c7b961e3 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -155,7 +155,9 @@ structure, update the relevant spec files. - Use imperative mood ### Pull Requests -This repo uses a **fork-based workflow**: +This repo uses a **fork-based workflow**. Never merge or commit directly +to `main`, `release-4.19`, or `pattern-fly-5` — all changes go through +PRs. 1. **Push to your fork**, not to `origin` (openshift/lightspeed-console) 2. **Create the PR** against `origin/main` using your fork's branch: From 13816e3361f937303cf9df7d4362af2135b4ec2c Mon Sep 17 00:00:00 2001 From: Andy Pickering Date: Thu, 18 Jun 2026 12:20:05 +0900 Subject: [PATCH 3/3] Update note on release branch OCP version ranges --- AGENTS.md | 5 +++++ README.md | 3 ++- 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index c7b961e3..efe7b8b8 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -149,6 +149,11 @@ structure, update the relevant spec files. ## Git and PR Workflow +### Release branches +- `main` — supports OpenShift 4.22+ +- `release-4.19` — supports OpenShift 4.19 – 4.21 +- `pattern-fly-5` — supports OpenShift 4.16 – 4.18 + ### Commit Messages - Start with the Jira ticket reference: `OLS-XXXX description` - Keep the first line under 72 characters diff --git a/README.md b/README.md index 5c7224e0..9f2e8cef 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,8 @@ and enabled in the console operator config by a cluster administrator. Requires OpenShift 4.16 or higher. -- `main` branch supports OpenShift 4.19+ +- `main` branch supports OpenShift 4.22+ +- `release-4.19` branch supports OpenShift 4.19 – 4.21 - `pattern-fly-5` branch supports OpenShift 4.16 – 4.18 [Node.js](https://nodejs.org/en/) >= 22 and [npm](https://www.npmjs.com) are