@mytechtoday/augment-extensions 1.3.1 → 1.5.0

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/coding-standards/c/CHANGELOG.md

@@ -0,0 +1,55 @@
+# Changelog
+
+All notable changes to the C Coding Standards extension 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-19
+
+### Added
+- Initial release of C Coding Standards extension
+- Module structure with organized directories
+- Configuration system with JSON Schema validation
+- Configuration manager with JSON/YAML support
+- Rule registry with Markdown parsing
+- Support for 7 categories: systems, embedded, kernel, drivers, realtime, networking, legacy
+- 6 universal rules: naming, memory-safety, error-handling, documentation, header-guards, const-correctness
+- Category-specific rule overrides
+- Static analysis tool integration (clang-tidy, cppcheck, valgrind)
+- Custom rules support
+- Hot-reload configuration support
+- Comprehensive examples for each category
+- AI prompt templates
+- TypeScript implementation with full type safety
+- Unit and integration tests
+- Complete documentation
+
+### Changed
+- N/A (initial release)
+
+### Deprecated
+- N/A (initial release)
+
+### Removed
+- N/A (initial release)
+
+### Fixed
+- N/A (initial release)
+
+### Security
+- N/A (initial release)
+
+## [Unreleased]
+
+### Planned
+- Additional category-specific rules
+- More code examples
+- Integration with additional static analysis tools
+- VS Code extension integration
+- Real-time rule validation
+- Rule conflict detection and resolution
+- Performance optimizations
+- Enhanced error messages
+- Migration tools for legacy code
+

package/augment-extensions/coding-standards/c/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Augment Extensions
+
+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/augment-extensions/coding-standards/c/README.md

@@ -0,0 +1,167 @@
+# C Coding Standards
+
+Comprehensive C programming language coding standards for Augment Code AI, covering systems programming, embedded systems, kernel development, device drivers, real-time systems, networking, and legacy code maintenance.
+
+## Overview
+
+This extension provides category-based coding standards for C development, with universal rules that apply across all categories and specialized rules for specific domains.
+
+## Installation
+
+### Using augx CLI
+
+```bash
+# Link the module to your project
+augx link coding-standards/c
+
+# Verify installation
+augx show c-standards
+```
+
+### Manual Installation
+
+Copy the contents of this directory to your project's `.augment/` folder.
+
+## Quick Start
+
+1. **Configure Categories**: Create `.augment/c-standards.json`:
+
+```json
+{
+  "c_standards": {
+    "version": "1.0.0",
+    "categories": ["systems"],
+    "c_standard": "c11"
+  }
+}
+```
+
+2. **Start Coding**: The extension will automatically apply rules based on your configuration.
+
+## Categories
+
+### Systems Programming
+- POSIX compliance
+- Process management
+- Inter-process communication (IPC)
+- Signal handling
+- File I/O and system calls
+
+### Embedded Systems
+- Microcontroller programming
+- Interrupt service routines (ISRs)
+- Hardware register access
+- Memory-constrained environments
+- Fixed-size buffers
+
+### Kernel Development
+- Linux kernel modules
+- Kernel subsystems
+- Device drivers (character, block, network)
+- Kernel APIs and conventions
+
+### Device Drivers
+- GPIO drivers
+- DMA transfers
+- Interrupt handling
+- Platform devices
+- Device tree integration
+
+### Real-Time Systems
+- RTOS integration
+- Task scheduling
+- Priority management
+- Deterministic execution
+- Timing constraints
+
+### Networking
+- Socket programming
+- Protocol implementation
+- Packet processing
+- Network drivers
+- TCP/IP stack integration
+
+### Legacy Code
+- Code modernization
+- Refactoring strategies
+- Migration to modern C standards
+- Compatibility maintenance
+
+## Universal Rules
+
+These rules apply to all categories:
+
+1. **Naming Conventions**: snake_case for functions/variables, UPPER_CASE for macros
+2. **Memory Safety**: Proper allocation, deallocation, and bounds checking
+3. **Error Handling**: Check all return values, use errno appropriately
+4. **Documentation**: Doxygen-style comments for all public APIs
+5. **Header Guards**: Use include guards or `#pragma once`
+6. **Const Correctness**: Use `const` for immutable data
+
+## Configuration
+
+### Configuration File
+
+Create `.augment/c-standards.json` or `.augment/c-standards.yaml`:
+
+```json
+{
+  "c_standards": {
+    "version": "1.0.0",
+    "categories": ["systems", "embedded"],
+    "c_standard": "c11",
+    "universal_rules": {
+      "naming": "enabled",
+      "memory_safety": "enabled",
+      "error_handling": "enabled",
+      "documentation": "warning",
+      "header_guards": "enabled",
+      "const_correctness": "warning"
+    },
+    "category_overrides": {
+      "embedded": {
+        "allow_dynamic_allocation": false,
+        "require_volatile_hardware": true,
+        "max_stack_depth": 5
+      }
+    },
+    "static_analysis": {
+      "clang_tidy": true,
+      "cppcheck": true,
+      "valgrind": false
+    }
+  }
+}
+```
+
+### Rule Severity Levels
+
+- `enabled`: Enforce rule (errors)
+- `warning`: Warn about violations
+- `disabled`: Ignore rule
+
+## Examples
+
+See the `examples/` directory for complete, compilable examples for each category.
+
+## Static Analysis Integration
+
+This extension integrates with:
+- **clang-tidy**: Modern C/C++ linter
+- **cppcheck**: Static analysis tool
+- **valgrind**: Memory debugging and profiling
+
+## Contributing
+
+See [CONTRIBUTING.md](../../CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file.
+
+## Links
+
+- [Documentation](https://github.com/mytech-today-now/augment-extensions/tree/main/augment-extensions/coding-standards/c)
+- [Issues](https://github.com/mytech-today-now/augment-extensions/issues)
+- [Augment Extensions](https://github.com/mytech-today-now/augment-extensions)
+

package/augment-extensions/coding-standards/c/config/defaults.json

@@ -0,0 +1,26 @@
+{
+  "c_standards": {
+    "version": "1.0.0",
+    "categories": ["systems"],
+    "c_standard": "c11",
+    "universal_rules": {
+      "naming": "enabled",
+      "memory_safety": "enabled",
+      "error_handling": "enabled",
+      "documentation": "enabled",
+      "header_guards": "enabled",
+      "const_correctness": "enabled"
+    },
+    "category_overrides": {},
+    "static_analysis": {
+      "clang_tidy": false,
+      "cppcheck": false,
+      "valgrind": false
+    },
+    "custom_rules": {
+      "enabled": false,
+      "path": ".augment/c-standards/custom-rules/"
+    }
+  }
+}
+

package/augment-extensions/coding-standards/c/config/examples/embedded.yaml

@@ -0,0 +1,25 @@
+c_standards:
+  version: "1.0.0"
+  categories:
+    - embedded
+  c_standard: c99
+  universal_rules:
+    naming: enabled
+    memory_safety: enabled
+    error_handling: enabled
+    documentation: enabled
+    header_guards: enabled
+    const_correctness: enabled
+  category_overrides:
+    embedded:
+      allow_dynamic_allocation: false
+      require_volatile_hardware: true
+      max_stack_depth: 5
+  static_analysis:
+    clang_tidy: true
+    cppcheck: true
+    valgrind: false
+  custom_rules:
+    enabled: false
+    path: ".augment/c-standards/custom-rules/"
+

package/augment-extensions/coding-standards/c/config/examples/systems.json

@@ -0,0 +1,31 @@
+{
+  "c_standards": {
+    "version": "1.0.0",
+    "categories": ["systems"],
+    "c_standard": "c11",
+    "universal_rules": {
+      "naming": "enabled",
+      "memory_safety": "enabled",
+      "error_handling": "enabled",
+      "documentation": "warning",
+      "header_guards": "enabled",
+      "const_correctness": "warning"
+    },
+    "category_overrides": {
+      "systems": {
+        "require_posix_compliance": true,
+        "check_system_call_errors": true
+      }
+    },
+    "static_analysis": {
+      "clang_tidy": true,
+      "cppcheck": true,
+      "valgrind": true
+    },
+    "custom_rules": {
+      "enabled": false,
+      "path": ".augment/c-standards/custom-rules/"
+    }
+  }
+}
+