Commit 120dde0
authored
refactor!: restructure RPI collection to HVE Core naming convention (#668)
This PR promotes the RPI collection to flagship status by renaming it to
**HVE Core** and redesigning how repo-specific AI artifacts are
identified and excluded from distribution. The change touches every
layer of the system: artifact directories, collection manifests, plugin
outputs, extension packaging, validation scripts, tests, and
documentation.
Previously, all RPI workflow agents, prompts, and instructions lived
under `.github/{type}/rpi/` directories, and repo-specific artifacts
were identified by living under an `hve-core/` subdirectory. This
created a collision: the `hve-core/` name was simultaneously used for
repo-internal exclusions and as the natural identity for the flagship
collection.
The restructuring resolves this by:
- **Moving all `.github/{type}/rpi/` directories to
`.github/{type}/hve-core/`**, making the collection identity match the
project name.
- **Replacing the subdirectory-based exclusion convention with
root-level detection.** Repo-specific artifacts now live directly at the
root of `.github/agents/`, `.github/instructions/`, `.github/prompts/`,
or `.github/skills/` (no subdirectory). Collection-scoped, distributable
artifacts reside in subdirectories like `hve-core/`, `ado/`, `shared/`,
etc.
- **Updating the exclusion functions** `Test-HveCoreRepoSpecificPath`
(from `$RelativePath -like 'hve-core/*'` to `$RelativePath -notlike
'*/*'`) and `Test-HveCoreRepoRelativePath` (from `.github/.*/hve-core/`
regex to `^\.github/(agents|instructions|prompts|skills)/[^/]+$`).
- **Renaming `rpi.collection.yml` to `hve-core.collection.yml`** with
updated metadata, and creating the corresponding `plugins/hve-core/`
output directory while removing `plugins/rpi/`.
- **Reassigning the flagship extension identity from `hve-core-all` to
`hve-core`**, so the `hve-core` collection now produces
`extension/package.json` and `extension/README.md` (the default
extension artifacts), while `hve-core-all` gets explicit
`package.hve-core-all.json` and `README.hve-core-all.md` files.
- **Updating marketplace.json** to register the new `hve-core` plugin
entry and remove the `rpi` entry.
- **Updating VS Code settings** (`.vscode/settings.json`) to point at
the new `hve-core` directories instead of `rpi`.
- **Updating all internal cross-references** within agents, subagents,
documentation, the installer agent, workflow README, and contributing
guides to use `hve-core/` paths.
- **Rewriting all affected tests** across `PluginHelpers.Tests.ps1`,
`Validate-Collections.Tests.ps1`, and `Prepare-Extension.Tests.ps1` to
validate the new root-level exclusion convention and updated collection
identity.
## Related Issue(s)
<!-- Link to the issue(s) this PR addresses using "Fixes #123" or
"Closes #123" -->
## Type of Change
Select all that apply:
**Code & Documentation:**
- [ ] Bug fix (non-breaking change fixing an issue)
- [ ] New feature (non-breaking change adding functionality)
- [x] Breaking change (fix or feature causing existing functionality to
change)
- [x] Documentation update
**Infrastructure & Configuration:**
- [ ] GitHub Actions workflow
- [ ] Linting configuration (markdown, PowerShell, etc.)
- [ ] Security configuration
- [ ] DevContainer configuration
- [ ] Dependency update
**AI Artifacts:**
- [ ] Reviewed contribution with `prompt-builder` agent and addressed
all feedback
- [x] Copilot instructions (`.github/instructions/*.instructions.md`)
- [x] Copilot prompt (`.github/prompts/*.prompt.md`)
- [x] Copilot agent (`.github/agents/*.agent.md`)
- [ ] Copilot skill (`.github/skills/*/SKILL.md`)
> **Note for AI Artifact Contributors**:
>
> - **Agents**: Research, indexing/referencing other project (using
standard VS Code GitHub Copilot/MCP tools), planning, and general
implementation agents likely already exist. Review `.github/agents/`
before creating new ones.
> - **Skills**: Must include both bash and PowerShell scripts. See
[Skills](../docs/contributing/skills.md).
> - **Model Versions**: Only contributions targeting the **latest
Anthropic and OpenAI models** will be accepted. Older model versions
(e.g., GPT-3.5, Claude 3) will be rejected.
> - See [Agents Not
Accepted](../docs/contributing/custom-agents.md#agents-not-accepted) and
[Model Version
Requirements](../docs/contributing/ai-artifacts-common.md#model-version-requirements).
**Other:**
- [x] Script/automation (`.ps1`, `.sh`, `.py`)
- [ ] Other (please describe):
## Sample Prompts (for AI Artifact Contributions)
Not applicable — this PR renames and restructures existing artifacts
without changing their behavior. All agents, prompts, and instructions
retain their original functionality under new paths.
## Testing
- `PluginHelpers.Tests.ps1` — 46/46 passing, validates root-level
exclusion logic (`Test-HveCoreRepoSpecificPath`,
`Test-HveCoreRepoRelativePath`) and `Get-ArtifactFiles` filtering.
- `Validate-Collections.Tests.ps1` — 18/18 passing, validates that
root-level repo-specific paths are rejected from collection manifests
while subdirectory paths are accepted.
- `Prepare-Extension.Tests.ps1` — 131/131 passing, validates updated
flagship collection identity, extension packaging, collection
generation, and maturity filtering with `hve-core` as the default
collection.
## Checklist
### Required Checks
- [x] Documentation is updated (if applicable)
- [x] Files follow existing naming conventions
- [ ] Changes are backwards compatible (if applicable)
- [x] Tests added for new functionality (if applicable)
### AI Artifact Contributions
<!-- If contributing an agent, prompt, instruction, or skill, complete
these checks -->
- [ ] Used `/prompt-analyze` to review contribution
- [ ] Addressed all feedback from `prompt-builder` review
- [ ] Verified contribution follows common standards and type-specific
requirements
### Required Automated Checks
The following validation commands must pass before merging:
- [x] Markdown linting: `npm run lint:md`
- [x] Spell checking: `npm run spell-check`
- [x] Frontmatter validation: `npm run lint:frontmatter`
- [x] Skill structure validation: `npm run validate:skills`
- [x] Link validation: `npm run lint:md-links`
- [x] PowerShell analysis: `npm run lint:ps`
## GHCP Artifact Maturity
> [!WARNING]
> This PR includes **experimental** GHCP artifacts that may have
breaking changes.
> - `.github/agents/hve-core/doc-ops.agent.md`
> - `.github/prompts/hve-core/checkpoint.prompt.md`
| File | Type | Maturity | Notes |
|---|---|---|---|
| `.github/agents/hve-core/doc-ops.agent.md` | Agent | 1 parent 11b93cb commit 120dde0
File tree
190 files changed
+600
-555
lines changed- .github
- agents
- hve-core
- subagents
- installer
- instructions
- hve-core
- plugin
- prompts
- hve-core
- workflows
- .vscode
- collections
- docs
- architecture
- contributing
- getting-started/methods
- rpi
- extension
- plugins
- hve-core-all
- agents
- commands
- instructions
- hve-core
- .github/plugin
- agents
- commands
- docs
- instructions
- scripts
- rpi
- .github/plugin
- agents
- commands
- instructions
- scripts
- extension
- plugins
- Modules
- tests
- extension
- plugins
Some content is hidden
Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
190 files changed
+600
-555
lines changedLines changed: 7 additions & 7 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
146 | 146 | | |
147 | 147 | | |
148 | 148 | | |
149 | | - | |
| 149 | + | |
150 | 150 | | |
151 | 151 | | |
152 | 152 | | |
| |||
208 | 208 | | |
209 | 209 | | |
210 | 210 | | |
211 | | - | |
| 211 | + | |
212 | 212 | | |
213 | 213 | | |
214 | 214 | | |
| |||
256 | 256 | | |
257 | 257 | | |
258 | 258 | | |
259 | | - | |
260 | | - | |
| 259 | + | |
| 260 | + | |
261 | 261 | | |
262 | 262 | | |
263 | 263 | | |
| |||
315 | 315 | | |
316 | 316 | | |
317 | 317 | | |
318 | | - | |
319 | | - | |
| 318 | + | |
| 319 | + | |
320 | 320 | | |
321 | 321 | | |
322 | 322 | | |
| |||
409 | 409 | | |
410 | 410 | | |
411 | 411 | | |
412 | | - | |
| 412 | + | |
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
Lines changed: 2 additions & 2 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
38 | 38 | | |
39 | 39 | | |
40 | 40 | | |
41 | | - | |
42 | | - | |
| 41 | + | |
| 42 | + | |
43 | 43 | | |
44 | 44 | | |
45 | 45 | | |
| |||
File renamed without changes.
0 commit comments