@mytechtoday/augment-extensions 1.7.0 → 2.2.0

package/README.md

@@ -5,6 +5,8 @@
 [![Version](https://img.shields.io/badge/version-1.6.1-blue.svg)](https://github.com/mytech-today-now/augment-extensions)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
 [![npm](https://img.shields.io/badge/npm-%40mytechtoday%2Faugment--extensions-red.svg)](https://www.npmjs.com/package/@mytechtoday/augment-extensions)
+[![CI](https://github.com/mytech-today-now/augment-extensions/actions/workflows/ci.yml/badge.svg)](https://github.com/mytech-today-now/augment-extensions/actions/workflows/ci.yml)
+[![Tests](https://github.com/mytech-today-now/augment-extensions/actions/workflows/test.yml/badge.svg)](https://github.com/mytech-today-now/augment-extensions/actions/workflows/test.yml)
 
 Augment Extensions is a modular repository system that extends Augment Code AI's capabilities by providing domain-specific rules, coding standards, workflow integrations, and extensive examples that can be consumed across multiple projects.
 
@@ -547,15 +549,120 @@ augx link api-design-rules
 
 ### 3. Version Management
 
+**New in v2.0.0**: Comprehensive module versioning system with semantic versioning, version selection, and compatibility checking.
+
+#### Quick Start
+
 ```bash
-# Update all linked modules
-augx update
+# List modules with available versions
+augx list --versions
+
+# Use specific module version
+augx use coding-standards/typescript --version 2.0.0
+
+# Pin version for stability (saves to .augment/extensions.json)
+augx use coding-standards/typescript --version 2.0.0 --pin
+
+# Upgrade module to latest version
+augx upgrade coding-standards/typescript
+
+# Show detailed version information
+augx version-info coding-standards/typescript
+```
+
+#### Version Selection Strategies
+
+**Latest Version (Default)**:
+```bash
+# Always use latest version
+augx use coding-standards/typescript
+```
+
+**Specific Version**:
+```bash
+# Use exact version
+augx use coding-standards/typescript --version 2.0.0
+```
 
-# Update specific module
-augx update typescript-standards
+**Version Pinning** (Recommended for Production):
+```bash
+# Pin to specific version (prevents automatic updates)
+augx use coding-standards/typescript --version 2.0.0 --pin
+
+# Verify pinned versions
+cat .augment/extensions.json
+```
+
+#### Upgrade Workflow
+
+```bash
+# Check for available updates
+augx list --versions
+
+# Upgrade specific module (with compatibility checks)
+augx upgrade coding-standards/typescript
+
+# Upgrade with breaking change warnings
+augx upgrade coding-standards/typescript --dry-run
+
+# Force upgrade (skip compatibility checks)
+augx upgrade coding-standards/typescript --force
+```
+
+#### GUI Version Selection
+
+Launch the modern TUI for interactive version selection:
+
+```bash
+augx gui
+```
+
+**Features**:
+- 🌲 **Tree Navigator** - Browse modules by category with arrow keys
+- 📦 **Version Selector** - View and select available versions
+- 🔍 **Search & Filter** - Find modules by name, tag, or category
+- 📄 **Preview Pane** - View module details, metadata, and version history
+- ⌨️ **Keyboard Shortcuts**:
+  - `↑/↓` - Navigate modules
+  - `←/→` - Collapse/expand categories
+  - `Enter` - Select module/version
+  - `P` - Pin/unpin version
+  - `C` - Filter by category
+  - `T` - Filter by tag
+  - `/` - Search
+  - `?` - Show help
+  - `Q` - Quit
+
+#### Version Compatibility
+
+All modules include compatibility metadata:
+
+```bash
+# Check compatibility requirements
+augx version-info coding-standards/typescript
+
+# Example output:
+# Version: 2.0.0
+# Compatibility:
+#   - Augment: 1.0.0+
+#   - Node.js: 18.0.0+
+#   - TypeScript: 5.0.0+
+```
+
+#### Migration from v1.x
+
+See **[Migration Guide](./docs/MIGRATION_V2.md)** for detailed migration instructions.
+
+**Quick migration**:
+```bash
+# Update CLI to v2.0.0
+npm install -g augx@2.0.0
+
+# Update all modules
+augx update
 
-# Pin to specific version
-augx pin typescript-standards@1.2.0
+# Or pin to v1.x for stability
+augx use coding-standards/typescript --version 1.0.0 --pin
 ```
 
 ## 📖 Available Modules
@@ -571,8 +678,12 @@ augx pin typescript-standards@1.2.0
 - **[JavaScript Standards](./augment-extensions/coding-standards/js/)** (v1.0.0, ~101K chars)
   - ES6+ features, async patterns, DOM manipulation, error handling, tooling
 
-- **[TypeScript Standards](./augment-extensions/coding-standards/typescript/)** (v1.0.0, ~6K chars)
-  - Naming conventions, type safety, best practices
+- **[TypeScript Standards](./augment-extensions/coding-standards/typescript/)** (v2.0.0, ~25K chars) ✨ UPDATED
+  - Modern TypeScript 5.x features (const type parameters, satisfies, inferred type predicates)
+  - Advanced type patterns (discriminated unions, branded types, template literal types)
+  - Monorepo patterns (Turborepo, Nx), tooling (flat ESLint, Biome, tsup, Vitest)
+  - Architecture patterns (DDD, clean architecture, hexagonal), error handling (Neverthrow, Effect-TS)
+  - Security & performance best practices, comprehensive testing strategies
 
 - **[Python Standards](./augment-extensions/coding-standards/python/)** (v1.1.0, ~116K chars)
   - Type hints (PEP 484, 585, 604), async patterns, testing, documentation

package/augment-extensions/coding-standards/bash/CHANGELOG.md

@@ -0,0 +1,51 @@
+# Changelog
+
+All notable changes to this module will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-02-25
+
+### Added
+
+- Initial release of Bash Coding Standards module
+- Comprehensive Bash coding standards for professional, maintainable, and secure Bash scripts across automation, CI/CD, CLI tools, configuration, data processing, system administration, and cross-platform development.
+
+### Changed
+
+- N/A
+
+### Deprecated
+
+- N/A
+
+### Removed
+
+- N/A
+
+### Fixed
+
+- N/A
+
+### Security
+
+- N/A
+
+## Guidelines
+
+When updating this changelog:
+
+1. **Added** for new features
+2. **Changed** for changes in existing functionality
+3. **Deprecated** for soon-to-be removed features
+4. **Removed** for now removed features
+5. **Fixed** for any bug fixes
+6. **Security** in case of vulnerabilities
+
+Each version should:
+- Use semantic versioning (MAJOR.MINOR.PATCH)
+- Include the release date in YYYY-MM-DD format
+- List changes in the appropriate category
+- Link to relevant issues or PRs when applicable
+

package/augment-extensions/coding-standards/bash/metadata.json

@@ -0,0 +1,21 @@
+{
+  "version": "1.0.0",
+  "name": "bash-standards",
+  "displayName": "Bash Coding Standards",
+  "description": "Comprehensive Bash coding standards for professional, maintainable, and secure Bash scripts across automation, CI/CD, CLI tools, configuration, data processing, system administration, and cross-platform development.",
+  "type": "coding-standards",
+  "tags": null,
+  "compatibility": {
+    "augmentMinVersion": "1.0.0",
+    "nodeMinVersion": "18.0.0"
+  },
+  "characterCount": 0,
+  "lastUpdated": "2026-02-25",
+  "files": {
+    "rules": [
+      "naming-conventions.md",
+      "universal-standards.md"
+    ],
+    "examples": []
+  }
+}

package/augment-extensions/coding-standards/c/metadata.json

@@ -0,0 +1,50 @@
+{
+  "version": "1.0.0",
+  "name": "c-standards",
+  "displayName": "C Coding Standards",
+  "description": "Comprehensive C programming language coding standards for systems programming, embedded systems, kernel development, device drivers, real-time systems, networking, and legacy code maintenance",
+  "type": "coding-standards",
+  "language": "c",
+  "tags": [
+    "c",
+    "systems",
+    "embedded",
+    "kernel",
+    "drivers",
+    "realtime",
+    "networking",
+    "legacy"
+  ],
+  "compatibility": {
+    "augmentMinVersion": "1.0.0",
+    "nodeMinVersion": "18.0.0"
+  },
+  "characterCount": 0,
+  "lastUpdated": "2026-02-25",
+  "files": {
+    "rules": [
+      "categories/drivers.md",
+      "categories/embedded.md",
+      "categories/kernel.md",
+      "categories/legacy.md",
+      "categories/networking.md",
+      "categories/realtime.md",
+      "categories/systems.md",
+      "universal/const-correctness.md",
+      "universal/documentation.md",
+      "universal/error-handling.md",
+      "universal/header-guards.md",
+      "universal/memory-safety.md",
+      "universal/naming.md"
+    ],
+    "examples": [
+      "drivers/README.md",
+      "embedded/README.md",
+      "kernel/README.md",
+      "legacy/README.md",
+      "networking/README.md",
+      "realtime/README.md",
+      "systems/README.md"
+    ]
+  }
+}

package/augment-extensions/coding-standards/css/CHANGELOG.md

@@ -0,0 +1,51 @@
+# Changelog
+
+All notable changes to this module will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-02-25
+
+### Added
+
+- Initial release of CSS Standards module
+- Comprehensive CSS coding standards for modern web development with styling, layouts, responsiveness, and preprocessors (Sass, Less)
+
+### Changed
+
+- N/A
+
+### Deprecated
+
+- N/A
+
+### Removed
+
+- N/A
+
+### Fixed
+
+- N/A
+
+### Security
+
+- N/A
+
+## Guidelines
+
+When updating this changelog:
+
+1. **Added** for new features
+2. **Changed** for changes in existing functionality
+3. **Deprecated** for soon-to-be removed features
+4. **Removed** for now removed features
+5. **Fixed** for any bug fixes
+6. **Security** in case of vulnerabilities
+
+Each version should:
+- Use semantic versioning (MAJOR.MINOR.PATCH)
+- Include the release date in YYYY-MM-DD format
+- List changes in the appropriate category
+- Link to relevant issues or PRs when applicable
+

package/augment-extensions/coding-standards/css/metadata.json

@@ -0,0 +1,30 @@
+{
+  "version": "1.0.0",
+  "name": "css-standards",
+  "displayName": "CSS Standards",
+  "description": "Comprehensive CSS coding standards for modern web development with styling, layouts, responsiveness, and preprocessors (Sass, Less)",
+  "type": "coding-standards",
+  "language": "css",
+  "tags": [
+    "css",
+    "web",
+    "frontend",
+    "styling",
+    "responsive",
+    "sass",
+    "less"
+  ],
+  "compatibility": {
+    "augmentMinVersion": "1.0.0",
+    "nodeMinVersion": "18.0.0"
+  },
+  "characterCount": 30556,
+  "lastUpdated": "2026-02-25",
+  "files": {
+    "rules": [
+      "css-modern-features.md",
+      "css-standards.md"
+    ],
+    "examples": null
+  }
+}

package/augment-extensions/coding-standards/go/CHANGELOG.md

@@ -0,0 +1,51 @@
+# Changelog
+
+All notable changes to this module will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-02-25
+
+### Added
+
+- Initial release of Go Coding Standards module
+- Professional Go coding standards for Augment Code AI covering web services, microservices, CLI tools, cloud-native applications, distributed systems, DevOps tooling, and API development
+
+### Changed
+
+- N/A
+
+### Deprecated
+
+- N/A
+
+### Removed
+
+- N/A
+
+### Fixed
+
+- N/A
+
+### Security
+
+- N/A
+
+## Guidelines
+
+When updating this changelog:
+
+1. **Added** for new features
+2. **Changed** for changes in existing functionality
+3. **Deprecated** for soon-to-be removed features
+4. **Removed** for now removed features
+5. **Fixed** for any bug fixes
+6. **Security** in case of vulnerabilities
+
+Each version should:
+- Use semantic versioning (MAJOR.MINOR.PATCH)
+- Include the release date in YYYY-MM-DD format
+- List changes in the appropriate category
+- Link to relevant issues or PRs when applicable
+

package/augment-extensions/coding-standards/go/metadata.json

@@ -0,0 +1,57 @@
+{
+  "version": "1.0.0",
+  "name": "go-coding-standards",
+  "displayName": "Go Coding Standards",
+  "description": "Professional Go coding standards for Augment Code AI covering web services, microservices, CLI tools, cloud-native applications, distributed systems, DevOps tooling, and API development",
+  "type": "coding-standards",
+  "tags": [
+    "go1.18+",
+    "effective-go",
+    "uber-style-guide",
+    "google-style-guide",
+    "golangci-lint",
+    "staticcheck",
+    "concurrency",
+    "error-handling",
+    "testing",
+    "performance"
+  ],
+  "compatibility": {
+    "augmentMinVersion": "1.0.0",
+    "nodeMinVersion": "18.0.0"
+  },
+  "characterCount": 0,
+  "lastUpdated": "2026-02-25",
+  "files": {
+    "rules": [
+      "categories/api-development/api-versioning.md",
+      "categories/api-development/rate-limiting.md",
+      "categories/api-development/rest-api-design.md",
+      "categories/cloud-native/cloud-config.md",
+      "categories/cloud-native/health-checks.md",
+      "categories/cloud-native/kubernetes.md",
+      "categories/devops-tooling/automation.md",
+      "categories/devops-tooling/ci-cd-integration.md",
+      "categories/devops-tooling/infrastructure-as-code.md",
+      "categories/distributed-systems/caching.md",
+      "categories/distributed-systems/consensus.md",
+      "categories/distributed-systems/event-sourcing.md",
+      "cli/command-parsing.md",
+      "cli/configuration.md",
+      "cli/cross-platform.md",
+      "microservices/distributed-tracing.md",
+      "microservices/grpc.md",
+      "microservices/metrics.md",
+      "microservices/service-discovery.md",
+      "universal/code-organization.md",
+      "universal/documentation.md",
+      "universal/performance.md",
+      "universal/testing.md",
+      "web/graceful-shutdown.md",
+      "web/http-handlers.md",
+      "web/middleware.md",
+      "web/routing.md"
+    ],
+    "examples": null
+  }
+}

package/augment-extensions/coding-standards/html/CHANGELOG.md

@@ -0,0 +1,51 @@
+# Changelog
+
+All notable changes to this module will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-02-25
+
+### Added
+
+- Initial release of HTML Standards module
+- Comprehensive HTML coding standards for modern web development with semantic HTML, accessibility guidelines, and HTML5 features
+
+### Changed
+
+- N/A
+
+### Deprecated
+
+- N/A
+
+### Removed
+
+- N/A
+
+### Fixed
+
+- N/A
+
+### Security
+
+- N/A
+
+## Guidelines
+
+When updating this changelog:
+
+1. **Added** for new features
+2. **Changed** for changes in existing functionality
+3. **Deprecated** for soon-to-be removed features
+4. **Removed** for now removed features
+5. **Fixed** for any bug fixes
+6. **Security** in case of vulnerabilities
+
+Each version should:
+- Use semantic versioning (MAJOR.MINOR.PATCH)
+- Include the release date in YYYY-MM-DD format
+- List changes in the appropriate category
+- Link to relevant issues or PRs when applicable
+

package/augment-extensions/coding-standards/html/metadata.json

@@ -0,0 +1,25 @@
+{
+  "version": "1.0.0",
+  "name": "html-standards",
+  "displayName": "HTML Standards",
+  "description": "Comprehensive HTML coding standards for modern web development with semantic HTML, accessibility guidelines, and HTML5 features",
+  "type": "coding-standards",
+  "language": "html",
+  "tags": [
+    "html",
+    "web",
+    "frontend",
+    "accessibility",
+    "semantic-html"
+  ],
+  "compatibility": {
+    "augmentMinVersion": "1.0.0",
+    "nodeMinVersion": "18.0.0"
+  },
+  "characterCount": 32477,
+  "lastUpdated": "2026-02-25",
+  "files": {
+    "rules": "html-standards.md",
+    "examples": null
+  }
+}

package/augment-extensions/coding-standards/html-css-js/CHANGELOG.md

@@ -0,0 +1,51 @@
+# Changelog
+
+All notable changes to this module will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-02-25
+
+### Added
+
+- Initial release of HTML/CSS/JavaScript Standards module
+- Comprehensive HTML/CSS/JavaScript coding standards for modern web development with semantic HTML, modern CSS features, and ES6+ JavaScript
+
+### Changed
+
+- N/A
+
+### Deprecated
+
+- N/A
+
+### Removed
+
+- N/A
+
+### Fixed
+
+- N/A
+
+### Security
+
+- N/A
+
+## Guidelines
+
+When updating this changelog:
+
+1. **Added** for new features
+2. **Changed** for changes in existing functionality
+3. **Deprecated** for soon-to-be removed features
+4. **Removed** for now removed features
+5. **Fixed** for any bug fixes
+6. **Security** in case of vulnerabilities
+
+Each version should:
+- Use semantic versioning (MAJOR.MINOR.PATCH)
+- Include the release date in YYYY-MM-DD format
+- List changes in the appropriate category
+- Link to relevant issues or PRs when applicable
+

package/augment-extensions/coding-standards/html-css-js/metadata.json

@@ -0,0 +1,40 @@
+{
+  "version": "1.0.0",
+  "name": "html-css-js-standards",
+  "displayName": "HTML/CSS/JavaScript Standards",
+  "description": "Comprehensive HTML/CSS/JavaScript coding standards for modern web development with semantic HTML, modern CSS features, and ES6+ JavaScript",
+  "type": "coding-standards",
+  "language": "html-css-js",
+  "tags": [
+    "html",
+    "css",
+    "javascript",
+    "web",
+    "frontend",
+    "accessibility",
+    "performance"
+  ],
+  "compatibility": {
+    "augmentMinVersion": "1.0.0",
+    "nodeMinVersion": "18.0.0"
+  },
+  "characterCount": 165097,
+  "lastUpdated": "2026-02-25",
+  "files": {
+    "rules": [
+      "async-patterns.md",
+      "css-modern-features.md",
+      "css-standards.md",
+      "dom-manipulation.md",
+      "html-standards.md",
+      "javascript-standards.md",
+      "performance.md",
+      "tooling.md"
+    ],
+    "examples": [
+      "async-examples.js",
+      "dom-examples.js",
+      "javascript-examples.js"
+    ]
+  }
+}

package/augment-extensions/coding-standards/js/CHANGELOG.md

@@ -0,0 +1,51 @@
+# Changelog
+
+All notable changes to this module will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-02-25
+
+### Added
+
+- Initial release of JavaScript Standards module
+- Comprehensive JavaScript coding standards for modern web development with ES6+, DOM manipulation, async patterns, and framework integration
+
+### Changed
+
+- N/A
+
+### Deprecated
+
+- N/A
+
+### Removed
+
+- N/A
+
+### Fixed
+
+- N/A
+
+### Security
+
+- N/A
+
+## Guidelines
+
+When updating this changelog:
+
+1. **Added** for new features
+2. **Changed** for changes in existing functionality
+3. **Deprecated** for soon-to-be removed features
+4. **Removed** for now removed features
+5. **Fixed** for any bug fixes
+6. **Security** in case of vulnerabilities
+
+Each version should:
+- Use semantic versioning (MAJOR.MINOR.PATCH)
+- Include the release date in YYYY-MM-DD format
+- List changes in the appropriate category
+- Link to relevant issues or PRs when applicable
+