feat(extension): implement collection-based plugin distribution system

.cspell.json

@@ -79,6 +79,7 @@
     "Streamlit",
     "vscodeignore",
     "\u02c8pr\u00e6ks\u026as",
-    "\u03c0\u03c1\u1fb6\u03be\u03b9\u03c2"
+    "\u03c0\u03c1\u1fb6\u03be\u03b9\u03c2",
+    "TMPVER"
   ]
-}
+}

.github/agents/ado-prd-to-wit.agent.md

@@ -1,6 +1,5 @@
 ---
 description: 'Product Manager expert for analyzing PRDs and planning Azure DevOps work item hierarchies'
-maturity: stable
 tools: ['execute/getTerminalOutput', 'execute/runInTerminal', 'read/problems', 'read/readFile', 'read/terminalSelection', 'read/terminalLastCommand', 'edit/createDirectory', 'edit/createFile', 'edit/editFiles', 'search', 'web', 'agent', 'ado/search_workitem', 'ado/wit_get_work_item', 'ado/wit_get_work_items_for_iteration', 'ado/wit_list_backlog_work_items', 'ado/wit_list_backlogs', 'ado/wit_list_work_item_comments', 'ado/work_list_team_iterations', 'microsoft-docs/*']
 ---
 

.github/agents/adr-creation.agent.md

@@ -1,6 +1,5 @@
 ---
 description: 'Interactive AI coaching for collaborative architectural decision record creation with guided discovery, research integration, and progressive documentation building - Brought to you by microsoft/edge-ai'
-maturity: stable
 ---
 
 # ADR Creation Coach

.github/agents/arch-diagram-builder.agent.md

@@ -1,6 +1,5 @@
 ---
 description: Architecture diagram builder agent that builds high quality ASCII-art diagrams - Brought to you by microsoft/hve-core
-maturity: stable
 ---
 
 # Architecture Diagram Builder Agent

.github/agents/brd-builder.agent.md

@@ -1,6 +1,5 @@
 ---
 description: "Business Requirements Document builder with guided Q&A and reference integration"
-maturity: stable
 ---
 
 # BRD Builder Instructions

.github/agents/doc-ops.agent.md

@@ -1,6 +1,5 @@
 ---
 description: 'Autonomous documentation operations agent for pattern compliance, accuracy verification, and gap detection - Brought to you by microsoft/hve-core'
-maturity: stable
 ---
 
 # Documentation Operations Agent

.github/agents/gen-data-spec.agent.md

@@ -1,6 +1,5 @@
 ---
 description: "Generate comprehensive data dictionaries, machine-readable data profiles, and objective summaries for downstream analysis (EDA notebooks, dashboards) through guided discovery"
-maturity: stable
 tools: ['runCommands', 'edit/createFile', 'edit/createDirectory', 'edit/editFiles', 'search', 'think', 'todos']
 ---
 

.github/agents/gen-jupyter-notebook.agent.md

@@ -1,6 +1,5 @@
 ---
 description: 'Create structured exploratory data analysis Jupyter notebooks from available data sources and generated data dictionaries'
-maturity: stable
 ---
 
 # Jupyter Notebook Generator

.github/agents/gen-streamlit-dashboard.agent.md

@@ -1,6 +1,5 @@
 ---
 description: 'Develop a multi-page Streamlit dashboard'
-maturity: stable
 ---
 
 # Streamlit Dashboard Generator

.github/agents/github-backlog-manager.agent.md

@@ -1,6 +1,5 @@
 ---
 description: "Orchestrator agent for GitHub backlog management workflows including triage, discovery, sprint planning, and execution - Brought to you by microsoft/hve-core"
-maturity: experimental
 tools:
   - github/*
   - search

.github/agents/github-issue-manager.agent.md

@@ -1,6 +1,6 @@
 ---
 description: 'Deprecated: replaced by github-backlog-manager.agent.md for GitHub issue and backlog management'
-maturity: deprecated
+tools: ['execute/getTerminalOutput', 'execute/runInTerminal', 'read', 'edit/createDirectory', 'edit/createFile', 'edit/editFiles', 'search', 'web', 'agent', 'github/*']
 ---
 
 # GitHub Issue Manager

.github/agents/hve-core-installer.agent.md

@@ -1,6 +1,5 @@
 ---
 description: 'Decision-driven installer for HVE-Core with 6 installation methods for local, devcontainer, and Codespaces environments - Brought to you by microsoft/hve-core'
-maturity: stable
 tools: ['vscode/newWorkspace', 'vscode/runCommand', 'execute/runInTerminal', 'read', 'edit/createDirectory', 'edit/createFile', 'edit/editFiles', 'search', 'web', 'agent', 'todo']
 ---
 # HVE-Core Installer Agent
@@ -1065,8 +1064,8 @@ Copying agents enables local customization and offline use.
   • github-backlog-manager (GitHub)
 
 Options:
-  [1] Install all agents (recommended)
-  [2] Install RPI Core only
+  [1] Install RPI Core only (recommended)
+  [2] Install by collection
   [3] Skip agent installation
 
 Your choice? (1/2/3)
@@ -1075,23 +1074,89 @@ Your choice? (1/2/3)
 
 User input handling:
 
-* "1", "all", "install all" → Copy all agents
-* "2", "rpi", "rpi core", "core" → Copy RPI Core bundle only
+* "1", "rpi", "rpi core", "core" → Copy RPI Core bundle only
+* "2", "collection", "by collection" → Proceed to Collection Selection sub-flow
 * "3", "skip", "none", "no" → Skip to success report
 * Unclear response → Ask for clarification
 
+### Collection Selection Sub-Flow
+
+When the user selects option 2, read collection manifests to present available collections.
+
+#### Step 1: Read collections and build collection agent counts
+
+Read `collections/*.collection.yml` from the HVE-Core source (at `$hveCoreBasePath`). Derive collection options from collection `id` and `name`. For each selected collection, count agent items where `kind` equals `agent` and effective item maturity is `stable` (item `maturity` omitted defaults to `stable`; exclude `experimental` and `deprecated`).
+
+#### Step 2: Present collection options
+
+<!-- <collection-selection-prompt> -->
+```text
+🎭 Collection Selection
+
+Choose one or more collections to install agents tailored to your role, more to come in the future.
+
+| # | Collection | Agents | Description                     |
+|---|------------|--------|---------------------------------|
+| 1 | Developer  | [N]    | Software engineers writing code |
+
+Enter collection number(s) separated by commas (e.g., "1"):
+```
+<!-- </collection-selection-prompt> -->
+
+Agent counts `[N]` include agents matching the collection with `stable` maturity.
+
+User input handling:
+
+* Single number (e.g., "1") → Select that collection
+* Multiple numbers (e.g., "1, 3") → Combine agent sets from selected collections
+* Collection name (e.g., "developer") → Match by identifier
+* Unclear response → Ask for clarification
+
+#### Step 3: Build filtered agent list
+
+For each selected collection identifier:
+
+1. Iterate through `items` in the collection manifest
+2. Include items where `kind` is `agent` AND `maturity` is `stable`
+3. Deduplicate across multiple selected collections
+
+#### Step 4: Present filtered agents for confirmation
+
+<!-- <collection-confirmation-prompt> -->
+```text
+📋 Agents for [Collection Name(s)]
+
+The following [N] agents will be copied:
+
+  • [agent-name-1] - tags: [tag-1, tag-2]
+  • [agent-name-2] - tags: [tag-1, tag-2]
+  ...
+
+Proceed with installation? (yes/no)
+```
+<!-- </collection-confirmation-prompt> -->
+
+User input handling:
+
+* "yes", "y" → Proceed with copy using filtered agent list
+* "no", "n" → Return to Checkpoint 6 for re-selection
+* Unclear response → Ask for clarification
+
+> [!NOTE]
+> Collection filtering applies to agents only. Copying of related prompts, instructions, and skills based on collection is planned for a future release.
+
 ### Agent Bundle Definitions
 
-| Bundle     | Agents                                                     |
-|------------|------------------------------------------------------------|
-| `rpi-core` | task-researcher, task-planner, task-implementor, rpi-agent |
-| `all`      | All 20 agents (see prompt for full list)                   |
+| Bundle            | Agents                                                                    |
+|-------------------|---------------------------------------------------------------------------|
+| `rpi-core`        | task-researcher, task-planner, task-implementor, task-reviewer, rpi-agent |
+| `collection:<id>` | Stable agents matching the collection                                     |
 
 ### Collision Detection
 
 Before copying, check for existing agent files with matching names. Generate a script for the user's shell that:
 
-1. Builds list of source files based on selection (`rpi-core` = 4 files, `all` = all `.agent.md` files)
+1. Builds list of source files based on selection (`rpi-core` = 5 files, `collection` = filtered `.agent.md` files)
 2. Copies files with `.agent.md` extension
 3. Checks target directory (`.github/agents/`) for each name
 4. Reports collisions or clean state
@@ -1105,8 +1170,11 @@ $targetDir = ".github/agents"
 
 # Get files to copy based on selection
 $filesToCopy = switch ($selection) {
-    "rpi-core" { @("task-researcher.agent.md", "task-planner.agent.md", "task-implementor.agent.md", "rpi-agent.agent.md") }
-    "all" { Get-ChildItem "$sourceDir/*.agent.md" | ForEach-Object { $_.Name } }
+    "rpi-core" { @("task-researcher.agent.md", "task-planner.agent.md", "task-implementor.agent.md", "task-reviewer.agent.md", "rpi-agent.agent.md") }
+    default {
+        # Collection-based: $selection contains filtered agent names from collection manifest
+        $collectionAgents
+    }
 }
 
 # Check for collisions
@@ -1125,7 +1193,7 @@ if ($collisions.Count -gt 0) {
 ```
 <!-- </collision-detection-reference> -->
 
-Bash adaptation: Use `case/esac` for selection, `find ... -name '*.agent.md' -exec basename {} \;` for `all` (portable across GNU/BSD), `test -f` for existence.
+Bash adaptation: Use `case/esac` for selection, `test -f` for existence checks.
 
 ### Collision Resolution Prompt
 
@@ -1188,6 +1256,7 @@ $manifest = @{
     source = "microsoft/hve-core"
     version = (Get-Content "$hveCoreBasePath/package.json" | ConvertFrom-Json).version
     installed = (Get-Date -Format "o")
+    collection = $collectionId  # "rpi-core" or collection id(s) e.g. "developer" or "developer,devops"
     files = @{}; skip = @()
 }
 
@@ -1264,6 +1333,7 @@ if (Test-Path $manifestPath) {
     Write-Host "INSTALLED_VERSION=$($manifest.version)"
     Write-Host "SOURCE_VERSION=$sourceVersion"
     Write-Host "VERSION_CHANGED=$($sourceVersion -ne $manifest.version)"
+    Write-Host "INSTALLED_COLLECTION=$($manifest.collection ?? 'rpi-core')"
 } else {
     Write-Host "UPGRADE_MODE=false"
 }

.github/agents/memory.agent.md

@@ -1,6 +1,5 @@
 ---
 description: "Conversation memory persistence for session continuity - Brought to you by microsoft/hve-core"
-maturity: stable
 handoffs:
   - label: "🗑️ Clear"
     agent: rpi-agent

.github/agents/pr-review.agent.md

@@ -1,6 +1,5 @@
 ---
 description: 'Comprehensive Pull Request review assistant ensuring code quality, security, and convention compliance - Brought to you by microsoft/hve-core'
-maturity: stable
 ---
 
 # PR Review Assistant

.github/agents/prd-builder.agent.md

@@ -1,6 +1,5 @@
 ---
 description: "Product Requirements Document builder with guided Q&A and reference integration"
-maturity: stable
 ---
 
 # PRD Builder Instructions

.github/agents/prompt-builder.agent.md

@@ -1,6 +1,5 @@
 ---
 description: 'Prompt engineering assistant with phase-based workflow for creating and validating prompts, agents, and instructions files - Brought to you by microsoft/hve-core'
-maturity: stable
 handoffs:
   - label: "💡 Update/Create"
     agent: prompt-builder

.github/agents/rpi-agent.agent.md

@@ -1,6 +1,5 @@
 ---
 description: 'Autonomous RPI orchestrator dispatching task-* agents through Research → Plan → Implement → Review → Discover phases - Brought to you by microsoft/hve-core'
-maturity: stable
 argument-hint: 'Autonomous RPI agent. Requires runSubagent tool.'
 handoffs:
   - label: "1️⃣"

.github/agents/security-plan-creator.agent.md

@@ -1,6 +1,5 @@
 ---
 description: "Expert security architect for creating comprehensive cloud security plans - Brought to you by microsoft/hve-core"
-maturity: stable
 ---
 
 # Security Plan Creation Expert

.github/agents/task-implementor.agent.md

@@ -1,6 +1,5 @@
 ---
 description: 'Executes implementation plans from .copilot-tracking/plans with progressive tracking and change records'
-maturity: stable
 handoffs:
   - label: "✅ Review"
     agent: task-reviewer

.github/agents/task-planner.agent.md

@@ -1,6 +1,5 @@
 ---
 description: 'Implementation planner for creating actionable implementation plans - Brought to you by microsoft/hve-core'
-maturity: stable
 handoffs:
   - label: "⚡ Implement"
     agent: task-implementor

.github/agents/task-researcher.agent.md

@@ -1,6 +1,5 @@
 ---
 description: 'Task research specialist for comprehensive project analysis - Brought to you by microsoft/hve-core'
-maturity: stable
 handoffs:
   - label: "📋 Create Plan"
     agent: task-planner

.github/agents/task-reviewer.agent.md

@@ -1,6 +1,5 @@
 ---
 description: 'Reviews completed implementation work for accuracy, completeness, and convention compliance - Brought to you by microsoft/hve-core'
-maturity: stable
 handoffs:
   - label: "🔬 Research More"
     agent: task-researcher

.github/agents/test-streamlit-dashboard.agent.md

@@ -1,6 +1,5 @@
 ---
 description: 'Automated testing for Streamlit dashboards using Playwright with issue tracking and reporting'
-maturity: stable
 ---
 
 # Streamlit Dashboard Testing

.github/copilot-instructions.md

@@ -90,6 +90,9 @@ All tracking files use markdown format with frontmatter and follow patterns from
 
 * Scripts follow instructions provided by the codebase for convention and standards.
 * Scripts used by the codebase have an `npm run` script for ease of use.
+* Files under the root `plugins/` directory are generated outputs and are not edited directly.
+* Regenerate plugin outputs using `npm run plugin:generate`; markdown files under `plugins/` can be symlinked or generated, so direct edits can cause conflicts and non-durable changes.
+* Artifacts under `.github/**/hve-core/` are repo-specific and excluded from collection manifests, plugin generation, and extension packaging. Validation enforces this rule.
 
 PowerShell scripts follow PSScriptAnalyzer rules from `PSScriptAnalyzer.psd1` and include proper comment-based help. Validation runs via `npm run lint:ps` with results output to `logs/`.
 <!-- </script-operations> -->

.github/instructions/ado-create-pull-request.instructions.md

@@ -1,7 +1,6 @@
 ---
 description: "Required protocol for creating Azure DevOps pull requests with work item discovery, reviewer identification, and automated linking."
 applyTo: '**/.copilot-tracking/pr/new/**'
-maturity: stable
 ---
 
 # Azure DevOps Pull Request Creation

.github/instructions/ado-get-build-info.instructions.md

@@ -1,7 +1,6 @@
 ---
 description: 'Required instructions for anything related to Azure Devops or ado build information including status, logs, or details from provided pullrequest (PR), build Id, or branch name.'
 applyTo: '**/.copilot-tracking/pr/*-build-*.md'
-maturity: stable
 ---
 
 # Azure DevOps Build Info Instructions

.github/instructions/ado-update-wit-items.instructions.md

@@ -1,7 +1,6 @@
 ---
 description: 'Work item creation and update protocol using MCP ADO tools with handoff tracking'
 applyTo: '**/.copilot-tracking/workitems/**/handoff-logs.md'
-maturity: stable
 ---
 
 # Azure DevOps Work Item Update Instructions

.github/instructions/ado-wit-discovery.instructions.md

@@ -1,7 +1,6 @@
 ---
 description: 'Protocol for discovering Azure DevOps work items via user assignment or artifact analysis with planning file output'
 applyTo: '**/.copilot-tracking/workitems/discovery/**'
-maturity: stable
 ---
 
 # Azure DevOps Work Item Discovery

.github/instructions/ado-wit-planning.instructions.md

@@ -2,7 +2,6 @@
 name: 'ADO Work Item Planning'
 description: 'Reference specification for Azure DevOps work item planning files, templates, field definitions, and search protocols'
 applyTo: '**/.copilot-tracking/workitems/**'
-maturity: stable
 ---
 
 # Azure DevOps Work Items Planning File Instructions

.github/instructions/bash/bash.instructions.md

@@ -1,7 +1,6 @@
 ---
 applyTo: '**/*.sh'
 description: 'Instructions for bash script implementation - Brought to you by microsoft/edge-ai'
-maturity: stable
 ---
 
 # Bash Script Instructions

.github/instructions/bicep/bicep.instructions.md

@@ -1,7 +1,6 @@
 ---
 applyTo: '**/bicep/**'
 description: 'Instructions for Bicep infrastructure as code implementation - Brought to you by microsoft/hve-core'
-maturity: stable
 ---
 # Bicep Instructions
 

.github/instructions/commit-message.instructions.md

@@ -1,6 +1,5 @@
 ---
 description: 'Required instructions for creating all commit messages - Brought to you by microsoft/hve-core'
-maturity: stable
 ---
 
 # Commit Message Guidelines

.github/instructions/community-interaction.instructions.md

@@ -1,7 +1,6 @@
 ---
 description: 'Community interaction voice, tone, and response templates for GitHub-facing agents and prompts'
 applyTo: '**/.github/instructions/github-backlog-*.instructions.md'
-maturity: experimental
 ---
 
 # Community Interaction Guidelines