@mytechtoday/augment-extensions 1.3.0 → 1.4.0

package/LICENSE

@@ -1,22 +1,22 @@
-MIT License
-
-Copyright (c) 2026 Augment Extensions Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
+MIT License
+
+Copyright (c) 2026 Augment Extensions Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -2,7 +2,7 @@
 
 **Reusable augmentation modules for Augment Code AI - Beyond the 49,400 character limit.**
 
-[![Version](https://img.shields.io/badge/version-1.1.0-blue.svg)](https://github.com/mytech-today-now/augment-extensions)
+[![Version](https://img.shields.io/badge/version-1.4.0-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)
 
@@ -20,8 +20,39 @@ Augment Code AI limits the `.augment/` folder to ~49,400 characters. This reposi
 - **Versioned updates** that propagate to consuming projects
 - **Project-agnostic modules** that work across different codebases
 
-## ✨ What's New in v1.1.0
+## ✨ What's New in v1.4.0
+
+### CLI Expansion - Phase 3 & 4 Complete 🎉
+
+**Phase 3 - Integration Commands:**
+- 📋 **Beads Integration** - Full Beads system management with `augx beads` commands
+  - `augx beads status` - System status and statistics
+  - `augx beads validate` - Validate task structure
+  - `augx beads export/import` - Export/import tasks
+  - `augx beads stats` - Detailed statistics
+  - `augx beads graph` - Dependency graph visualization
+  - `augx beads report` - Generate reports (Markdown, HTML, JSON, CSV)
+- ✅ **Task Management** - AI-friendly task commands with `augx task`
+  - `augx task list/show/create/update/close` - Task CRUD operations
+  - `augx task search` - Search tasks by criteria
+  - `augx task deps` - Manage dependencies
+- 📝 **OpenSpec Integration** - Spec-driven development with `augx spec`
+  - `augx spec list/show/create/validate/archive` - Spec management
+  - `augx spec status` - Spec status tracking
+- 🔄 **Change Management** - Change proposals with `augx change`
+  - `augx change list/show/create/validate/archive` - Change proposal management
+- 📦 **Collection Management** - Module collections with `augx collection`
+  - `augx collection list/show/link/unlink/validate` - Collection operations
+
+**Phase 4 - Quality & Documentation:**
+- 🧪 **Test Runner** - Comprehensive module testing
+- 🔍 **Linter** - AI context quality validation
+- 📚 **Docs Generator** - Automatic API documentation
+- 💡 **Enhanced Help** - Intelligent command suggestions
 
+### Previous Releases
+
+**v1.1.0:**
 - 📋 **Beads Completed Tracking** - Track and display completed Beads tasks with `augx show completed`
 - 🎨 **Color-Coded Status** - Visual indicators for task status (✓ closed, ⚙ in-progress, ○ open, ✖ blocked)
 - 📅 **Date Filtering** - Filter completed tasks by date range with `--since` and `--until` flags
@@ -30,8 +61,6 @@ Augment Code AI limits the `.augment/` folder to ~49,400 characters. This reposi
 - 🚀 **Auto-Initialization** - `augx init` automatically creates `scripts/completed.jsonl` when `.beads` exists
 - 📊 **JSON Export** - Export completed tasks as JSON with `--json` flag
 
-### Previous Releases
-
 **v0.4.0:**
 - 🧠 **Skills System** - Token-efficient, on-demand skill loading (500-10K tokens vs 50K+ for modules)
 - 🔧 **CLI Integration** - Wrap external tools and MCP servers as skills
@@ -792,6 +821,7 @@ augx diff typescript-standards
 
 ## 🚀 CLI Commands
 
+### Module Management
 ```bash
 # List all available modules
 augx list
@@ -821,6 +851,75 @@ augx update
 augx version
 ```
 
+### Beads Integration (Phase 3)
+```bash
+# System status and statistics
+augx beads status [--json] [--verbose]
+
+# Validate task structure
+augx beads validate [task-id] [--fix]
+
+# Export/import tasks
+augx beads export <output-file> [--format json|csv]
+augx beads import <input-file>
+
+# Generate statistics
+augx beads stats [--json] [--by-priority|--by-label|--by-owner]
+
+# Dependency graph visualization
+augx beads graph [--format ascii|mermaid|dot|svg] [--output file]
+
+# Generate reports
+augx beads report [--format markdown|html|json|csv] [--output file]
+```
+
+### Task Management (Phase 3)
+```bash
+# Task CRUD operations
+augx task list [--status open|closed] [--priority 0-3]
+augx task show <task-id>
+augx task create <title> [--priority N] [--tags tag1,tag2]
+augx task update <task-id> [--status status] [--priority N]
+augx task close <task-id> [--reason reason]
+
+# Search and filter
+augx task search <query> [--labels label1,label2]
+
+# Dependency management
+augx task deps <task-id> [--add dep-id] [--remove dep-id]
+```
+
+### OpenSpec Integration (Phase 3)
+```bash
+# Spec management
+augx spec list [--status active|draft|archived]
+augx spec show <spec-id>
+augx spec create <name> [--category cat] [--title "Title"]
+augx spec validate <spec-id>
+augx spec archive <spec-id>
+augx spec status [--json]
+```
+
+### Change Management (Phase 3)
+```bash
+# Change proposal management
+augx change list [--status active|archived]
+augx change show <change-name>
+augx change create <name> [--title "Title"] [--jira TICKET-123]
+augx change validate <change-name>
+augx change archive <change-name>
+```
+
+### Collection Management (Phase 3)
+```bash
+# Collection operations
+augx collection list
+augx collection show <collection-name>
+augx collection link <collection-name>
+augx collection unlink <collection-name>
+augx collection validate <collection-name>
+```
+
 ## 🔧 Integration with AI Agents
 
 Augment Extensions integrates seamlessly with AI coding assistants:
@@ -950,7 +1049,7 @@ MIT License - See [LICENSE](./LICENSE) for details.
 
 ---
 
-**Status**: Active Development | **Version**: 0.4.0 | **Maintainer**: @mytech-today-now
+**Status**: Active Development | **Version**: 1.4.0 | **Maintainer**: @mytech-today-now
 
-**Latest Release**: Skills System (Beta) - Token-efficient, on-demand skill loading with 97.2% token reduction. MCP Integration for wrapping external tools as skills.
+**Latest Release**: CLI Expansion Complete (Phase 3 & 4) - Full Beads, OpenSpec, and Collection integration with comprehensive task management, spec-driven development, quality tools, and enhanced documentation generation.
 

package/augment-extensions/domain-rules/software-architecture/README.md

@@ -1,143 +1,143 @@
-# Software Architecture Design Module
-
-Comprehensive software architecture design patterns, principles, and best practices for building scalable, maintainable, and secure systems.
-
-## Overview
-
-This module provides AI agents with comprehensive guidance on software architecture design, covering:
-
-- **Architecture Fundamentals** - Core elements, components, connectors, and configurations
-- **Architecture Patterns** - Monolithic, microservices, event-driven, serverless, and layered architectures
-- **Quality Attributes** - Performance, security, scalability, reliability, and maintainability
-- **Best Practices** - Tools, methodologies, modeling, and documentation
-- **Specialized Architectures** - Industry-specific patterns for IoT, AI, blockchain, and edge computing
-
-## Installation
-
-### With CLI (Future)
-
-```bash
-augx link domain-rules/software-architecture
-```
-
-### Without CLI (Current)
-
-Copy the contents of this module to your project's `.augment/` folder or reference the module files directly.
-
-## Module Structure
-
-```
-augment-extensions/domain-rules/software-architecture/
-├── module.json                          # Module metadata and configuration
-├── README.md                            # This file
-├── rules/                               # Architecture guidelines
-│   ├── fundamentals.md                  # Core architectural elements
-│   ├── principles.md                    # Design principles
-│   ├── monolithic.md                    # Monolithic architecture
-│   ├── microservices.md                 # Microservices patterns
-│   ├── event-driven.md                  # Event-driven architecture
-│   ├── serverless.md                    # Serverless patterns
-│   ├── layered.md                       # Layered architecture
-│   ├── quality-attributes.md            # Non-functional requirements
-│   ├── security.md                      # Security architecture
-│   ├── scalability.md                   # Scalability patterns
-│   ├── tools-methodologies.md           # TOGAF, DDD, CI/CD
-│   ├── modeling-documentation.md        # 4+1 views, UML, C4
-│   ├── industry-architectures.md        # IoT, AI, blockchain
-│   └── skills-development.md            # Architect skills
-└── examples/                            # Architecture examples
-    ├── ecommerce-microservices.md       # E-commerce platform
-    ├── iot-eventdriven.md               # IoT sensor network
-    ├── trading-eventdriven.md           # Stock trading system
-    └── serverless-imageprocessing.md    # Image processing pipeline
-```
-
-## Sub-Modules
-
-This module is organized into five sub-modules for selective loading:
-
-### 1. Fundamentals
-Core architectural concepts and principles.
-- `fundamentals.md` - Components, connectors, configurations (ISO/IEC 42010)
-- `principles.md` - Modularity, separation of concerns, coupling, cohesion
-
-### 2. Patterns
-Common architectural patterns and styles.
-- `monolithic.md` - Monolithic architecture patterns
-- `microservices.md` - Service discovery, API gateways, distributed systems
-- `event-driven.md` - Pub/sub, CQRS, event sourcing
-- `serverless.md` - FaaS, stateless functions, cloud-native
-- `layered.md` - MVC, pipe-and-filter, n-tier
-
-### 3. Quality
-Non-functional requirements and quality attributes.
-- `quality-attributes.md` - Performance, reliability, maintainability
-- `security.md` - Threat modeling, zero-trust, RBAC (OWASP)
-- `scalability.md` - Horizontal/vertical scaling, caching, load balancing
-
-### 4. Practices
-Tools, methodologies, and documentation.
-- `tools-methodologies.md` - TOGAF, DDD, CI/CD frameworks
-- `modeling-documentation.md` - 4+1 views, UML, C4 model, auto-generation
-
-### 5. Specialized
-Industry-specific and specialized patterns.
-- `industry-architectures.md` - IoT, AI/ML, blockchain, edge computing
-- `skills-development.md` - Technical and soft skills for architects
-
-## Usage
-
-### For AI Agents
-
-When working on architecture-related tasks:
-
-1. **Query the module**: `augx show software-architecture`
-2. **Load specific sub-module**: `augx show software-architecture/fundamentals`
-3. **Apply guidelines**: Follow the patterns and principles in the rule files
-4. **Reference examples**: Use example architectures as templates
-
-### Common Use Cases
-
-- **Designing new systems**: Start with fundamentals and principles
-- **Choosing architecture pattern**: Review patterns sub-module
-- **Security review**: Consult security.md and quality-attributes.md
-- **Scaling existing system**: Review scalability.md and microservices.md
-- **Documentation**: Use modeling-documentation.md for architecture diagrams
-
-## Key Features
-
-✅ **Comprehensive Coverage** - All major architecture patterns and styles  
-✅ **Industry Standards** - Based on ISO/IEC 42010, TOGAF, OWASP  
-✅ **Practical Examples** - Real-world architecture examples  
-✅ **Quality Focus** - Emphasis on non-functional requirements  
-✅ **Modular Design** - Sub-modules for selective loading  
-✅ **Best Practices** - Proven patterns and anti-patterns  
-
-## Character Count
-
-**Total**: 508,000 characters (25 files including rules, examples, and documentation)
-
-## Version
-
-**Current Version**: 1.0.0
-
-## Contents
-
-- **16 Rule Files** covering all aspects of software architecture
-- **4 Example Files** demonstrating real-world architectures
-- **5 Sub-Modules** for organized, selective loading
-- **Standards-Based** - ISO/IEC 42010, TOGAF, OWASP, DDD
-
-## References
-
-- ISO/IEC 42010 - Systems and software engineering — Architecture description
-- TOGAF - The Open Group Architecture Framework
-- OWASP - Open Web Application Security Project
-- Domain-Driven Design (DDD) - Eric Evans
-- C4 Model - Simon Brown
-- 4+1 Architectural View Model - Philippe Kruchten
-
-## License
-
-Part of Augment Extensions repository.
-
+# Software Architecture Design Module
+
+Comprehensive software architecture design patterns, principles, and best practices for building scalable, maintainable, and secure systems.
+
+## Overview
+
+This module provides AI agents with comprehensive guidance on software architecture design, covering:
+
+- **Architecture Fundamentals** - Core elements, components, connectors, and configurations
+- **Architecture Patterns** - Monolithic, microservices, event-driven, serverless, and layered architectures
+- **Quality Attributes** - Performance, security, scalability, reliability, and maintainability
+- **Best Practices** - Tools, methodologies, modeling, and documentation
+- **Specialized Architectures** - Industry-specific patterns for IoT, AI, blockchain, and edge computing
+
+## Installation
+
+### With CLI (Future)
+
+```bash
+augx link domain-rules/software-architecture
+```
+
+### Without CLI (Current)
+
+Copy the contents of this module to your project's `.augment/` folder or reference the module files directly.
+
+## Module Structure
+
+```
+augment-extensions/domain-rules/software-architecture/
+├── module.json                          # Module metadata and configuration
+├── README.md                            # This file
+├── rules/                               # Architecture guidelines
+│   ├── fundamentals.md                  # Core architectural elements
+│   ├── principles.md                    # Design principles
+│   ├── monolithic.md                    # Monolithic architecture
+│   ├── microservices.md                 # Microservices patterns
+│   ├── event-driven.md                  # Event-driven architecture
+│   ├── serverless.md                    # Serverless patterns
+│   ├── layered.md                       # Layered architecture
+│   ├── quality-attributes.md            # Non-functional requirements
+│   ├── security.md                      # Security architecture
+│   ├── scalability.md                   # Scalability patterns
+│   ├── tools-methodologies.md           # TOGAF, DDD, CI/CD
+│   ├── modeling-documentation.md        # 4+1 views, UML, C4
+│   ├── industry-architectures.md        # IoT, AI, blockchain
+│   └── skills-development.md            # Architect skills
+└── examples/                            # Architecture examples
+    ├── ecommerce-microservices.md       # E-commerce platform
+    ├── iot-eventdriven.md               # IoT sensor network
+    ├── trading-eventdriven.md           # Stock trading system
+    └── serverless-imageprocessing.md    # Image processing pipeline
+```
+
+## Sub-Modules
+
+This module is organized into five sub-modules for selective loading:
+
+### 1. Fundamentals
+Core architectural concepts and principles.
+- `fundamentals.md` - Components, connectors, configurations (ISO/IEC 42010)
+- `principles.md` - Modularity, separation of concerns, coupling, cohesion
+
+### 2. Patterns
+Common architectural patterns and styles.
+- `monolithic.md` - Monolithic architecture patterns
+- `microservices.md` - Service discovery, API gateways, distributed systems
+- `event-driven.md` - Pub/sub, CQRS, event sourcing
+- `serverless.md` - FaaS, stateless functions, cloud-native
+- `layered.md` - MVC, pipe-and-filter, n-tier
+
+### 3. Quality
+Non-functional requirements and quality attributes.
+- `quality-attributes.md` - Performance, reliability, maintainability
+- `security.md` - Threat modeling, zero-trust, RBAC (OWASP)
+- `scalability.md` - Horizontal/vertical scaling, caching, load balancing
+
+### 4. Practices
+Tools, methodologies, and documentation.
+- `tools-methodologies.md` - TOGAF, DDD, CI/CD frameworks
+- `modeling-documentation.md` - 4+1 views, UML, C4 model, auto-generation
+
+### 5. Specialized
+Industry-specific and specialized patterns.
+- `industry-architectures.md` - IoT, AI/ML, blockchain, edge computing
+- `skills-development.md` - Technical and soft skills for architects
+
+## Usage
+
+### For AI Agents
+
+When working on architecture-related tasks:
+
+1. **Query the module**: `augx show software-architecture`
+2. **Load specific sub-module**: `augx show software-architecture/fundamentals`
+3. **Apply guidelines**: Follow the patterns and principles in the rule files
+4. **Reference examples**: Use example architectures as templates
+
+### Common Use Cases
+
+- **Designing new systems**: Start with fundamentals and principles
+- **Choosing architecture pattern**: Review patterns sub-module
+- **Security review**: Consult security.md and quality-attributes.md
+- **Scaling existing system**: Review scalability.md and microservices.md
+- **Documentation**: Use modeling-documentation.md for architecture diagrams
+
+## Key Features
+
+✅ **Comprehensive Coverage** - All major architecture patterns and styles  
+✅ **Industry Standards** - Based on ISO/IEC 42010, TOGAF, OWASP  
+✅ **Practical Examples** - Real-world architecture examples  
+✅ **Quality Focus** - Emphasis on non-functional requirements  
+✅ **Modular Design** - Sub-modules for selective loading  
+✅ **Best Practices** - Proven patterns and anti-patterns  
+
+## Character Count
+
+**Total**: 508,000 characters (25 files including rules, examples, and documentation)
+
+## Version
+
+**Current Version**: 1.0.0
+
+## Contents
+
+- **16 Rule Files** covering all aspects of software architecture
+- **4 Example Files** demonstrating real-world architectures
+- **5 Sub-Modules** for organized, selective loading
+- **Standards-Based** - ISO/IEC 42010, TOGAF, OWASP, DDD
+
+## References
+
+- ISO/IEC 42010 - Systems and software engineering — Architecture description
+- TOGAF - The Open Group Architecture Framework
+- OWASP - Open Web Application Security Project
+- Domain-Driven Design (DDD) - Eric Evans
+- C4 Model - Simon Brown
+- 4+1 Architectural View Model - Philippe Kruchten
+
+## License
+
+Part of Augment Extensions repository.
+