Skip to content

Commit 9d7a2de

Browse files
committed
fix: address PR review feedback
- Add rhdh-dynamic-plugin-factory to SUBMODULE_REPOS with config_key "factory" - Add factory repo documentation to rhdh-repos.md and ecosystem diagram - Add rhdh-repos to Shared References table in SKILL.md - Fix wording/formatting in SKILL.md understand_rhdh_repos principle - Fix conftest.py unconfigured_cli docstring to match actual patches
1 parent 971f0d9 commit 9d7a2de

4 files changed

Lines changed: 20 additions & 2 deletions

File tree

skills/rhdh/SKILL.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ These contain critical gotchas (jq escaping, JQL limitations, assignee format) t
4646
<principle name="understand_rhdh_repos">
4747
**Before any RHDH-related work**, consult `references/rhdh-repos.md` for a reference of all RHDH-related repositories, what each one is used for, and how they relate to each other.
4848
Use this when navigating between projects or understanding the overall RHDH ecosystem.
49-
use `$RHDH config set` to set path to the local checkout of the RHDH repositories.
49+
Use `$RHDH config set` to set the path to the local checkout of the RHDH repositories.
5050
</principle>
5151

5252
</essential_principles>
@@ -298,6 +298,7 @@ Todos must be **self-contained**—a new session should understand the task with
298298

299299
| Reference | Purpose | Path |
300300
|-----------|---------|------|
301+
| rhdh-repos | Repository map, ecosystem relationships, key paths | `references/rhdh-repos.md` |
301302
| versions | RHDH/Backstage version compatibility matrix | `references/versions.md` |
302303
| jira-structure | RHDH Jira projects, issue types, filing rules | `references/jira-structure.md` |
303304

skills/rhdh/references/rhdh-repos.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,16 @@ Reference of all RHDH-related repositories, what each one is used for, and how t
133133
- **Branching:** `main` for active development; `1.2` for release maintenance; `changesets-release/<workspace>/main` for automated version PRs.
134134
- **Key paths:** `workspaces/` (all plugin workspaces), `scripts/ci/` (CI helper scripts), `.github/CODEOWNERS` (per-workspace ownership)
135135

136+
### rhdh-dynamic-plugin-factory
137+
138+
- **Upstream:** https://github.com/redhat-developer/rhdh-dynamic-plugin-factory
139+
- **Description:** Container image and tooling for building dynamic plugins locally. Provides a pre-configured build environment with all necessary dependencies (Node.js, Yarn, Backstage CLI) so plugin authors can export and package plugins without setting up a full development environment. Used via `podman` or `docker`.
140+
- **Tech stack:** Container (Podman/Docker), Node.js, Yarn, Backstage CLI
141+
- **Key concepts:**
142+
- **Container-based builds:** Run `podman run` or `docker run` with the factory image to build plugins in an isolated environment.
143+
- **Used by overlay workflows:** `rhdh-plugin-export-overlays` can use the factory container for local plugin builds.
144+
- **Key paths:** `Containerfile` (image definition)
145+
136146
### backstage
137147

138148
- **Upstream:** https://github.com/backstage/backstage
@@ -172,6 +182,7 @@ rhdh (enterprise distribution, github.com)
172182
| +-- rhdh-chart (Helm chart)
173183
|
174184
+-- rhdh-local (local dev/test environment)
185+
+-- rhdh-dynamic-plugin-factory (container for local plugin building)
175186
```
176187

177188
## Common Workflows

skills/rhdh/rhdh/config.py

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,12 @@
9494
"config_key": "local",
9595
"description": "Local RHDH testing environment (Docker Compose)",
9696
},
97+
"rhdh-dynamic-plugin-factory": {
98+
"has_fork": False,
99+
"required": False,
100+
"config_key": "factory",
101+
"description": "Container for local dynamic plugin building",
102+
},
97103
"backstage": {
98104
"has_fork": False,
99105
"required": False,

tests/conftest.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -224,7 +224,7 @@ def unconfigured_cli(isolated_env, monkeypatch):
224224
"""Fixture providing CLI with no repos configured.
225225
226226
Use this to test the "needs setup" state without manual monkeypatching.
227-
Mocks get_repo to return None for all repos.
227+
Mocks get_overlay_repo and get_repo to return None for all repos.
228228
"""
229229
from rhdh import cli as cli_module
230230

0 commit comments

Comments
 (0)