@@ -205,7 +205,9 @@ Connect to various prompt sources:
205205### 📦 Bundle Management
206206
207207- ** Install/Uninstall** : Manage bundles through UI or commands
208- - ** Version Control** : Track installed versions
208+ - ** Version Tracking** : Track installed versions with semantic versioning
209+ - ** Version Consolidation** : Multiple versions of the same bundle are grouped, showing only the latest
210+ - ** Update Detection** : Automatically detect when newer versions are available
209211- ** Auto-Sync** : Automatic synchronization with GitHub Copilot
210212- ** Conflict Resolution** : Handle duplicate bundles gracefully
211213
@@ -339,8 +341,10 @@ Click filter buttons to show only:
339341```
340342Click on any bundle tile to see:
341343- Full description
344+ - Current version and available versions
342345- Content breakdown (prompts, instructions, etc.)
343346- Installation information
347+ - Update availability status
344348- Tags and metadata
345349- List of included files
346350```
@@ -350,9 +354,9 @@ Click on any bundle tile to see:
350354#### From Marketplace
351355
3523561 . ** Browse** - Find a bundle in the marketplace
353- 2 . ** Review** - Click the tile to view details
354- 3 . ** Install** - Click the ** Install** button
355- 4 . ** Verify** - Check the installed badge appears
357+ 2 . ** Review** - Click the tile to view details and version information
358+ 3 . ** Install** - Click the ** Install** button (or ** Update ** if a newer version is available)
359+ 4 . ** Verify** - Check the installed badge appears with version number
356360
357361#### From Tree View
358362
@@ -443,6 +447,35 @@ Features:
443447Right-click source in tree view → " Remove Source"
444448```
445449
450+ ### Managing Bundle Versions
451+
452+ Prompt Registry uses semantic versioning to track and manage bundle versions.
453+
454+ #### Version Consolidation
455+
456+ When multiple versions of the same bundle exist (e.g., from GitHub releases), they are automatically consolidated:
457+
458+ - ** Latest Version Shown** : The marketplace displays only the latest version of each bundle
459+ - ** Version History** : All available versions are tracked and accessible
460+ - ** Smart Grouping** : Bundles from the same repository are grouped by owner/repo identity
461+
462+ #### Update Detection
463+
464+ The extension automatically detects when updates are available:
465+
466+ ``` bash
467+ # Check for updates
468+ Right-click installed bundle → " Check for Updates"
469+
470+ # Update to latest version
471+ Click " Update" button in marketplace or tree view
472+ ```
473+
474+ ** Update Indicators:**
475+ - 🔄 ** Update Available** - Newer version detected
476+ - ✅ ** Up to Date** - Latest version installed
477+ - 📦 ** Not Installed** - Bundle not yet installed
478+
446479### Working with Profiles
447480
448481Profiles help organize bundles by project, team, or environment.
@@ -563,6 +596,7 @@ Ctrl+Shift+P → "View: Show Prompt Registry Explorer"
563596- View all installed bundles by scope (User/Workspace)
564597- Right-click for actions: View Details, Update, Uninstall, Check Updates
565598- See installation status and version information
599+ - Visual indicators for available updates
566600
567601**👥 My Profiles**
568602- Manage profile-based installations
@@ -760,6 +794,8 @@ graph TB
760794# ## Key Components
761795
762796- **Registry Manager**: Orchestrates sources, bundles, and installations
797+ - **Version Consolidator**: Groups multiple bundle versions and selects latest
798+ - **Version Manager**: Semantic versioning operations and comparisons
763799- **Bundle Installer**: Handles extraction, validation, and installation
764800- **Copilot Sync**: Syncs bundles to GitHub Copilot directories
765801- **Adapters**: Source-specific implementations (GitHub, GitLab, etc.)
@@ -955,7 +991,13 @@ prompt-registry/
955991- 🔄 Community ratings and reviews
956992- 🔄 Repository level installation support
957993- 🔄 MCP Support (experimental at the moment)
958-
994+ - ✅ Bundle versioning with semantic version support
995+ - ✅ Version consolidation (group multiple versions)
996+ - ✅ Update detection and notifications
997+ - 🔄 Automatic bundle updates
998+ - 🔄 Version rollback
999+ - 🔄 Dependency management
1000+ - 🔄 Bundle analytics
9591001
9601002### Future
9611003
0 commit comments