@mytechtoday/augment-extensions 1.4.0 → 1.5.0

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/"
+    }
+  }
+}
+

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

@@ -0,0 +1,244 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://augment-extensions.dev/schemas/c-standards-config.json",
+  "title": "C Coding Standards Configuration",
+  "description": "Configuration schema for C coding standards extension",
+  "type": "object",
+  "required": ["c_standards"],
+  "properties": {
+    "c_standards": {
+      "type": "object",
+      "required": ["version", "categories"],
+      "properties": {
+        "version": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Configuration schema version (semantic versioning)"
+        },
+        "categories": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "enum": ["systems", "embedded", "kernel", "drivers", "realtime", "networking", "legacy"]
+          },
+          "description": "Active C project categories"
+        },
+        "c_standard": {
+          "type": "string",
+          "enum": ["c89", "c90", "c99", "c11", "c17", "c23"],
+          "default": "c11",
+          "description": "Target C language standard"
+        },
+        "universal_rules": {
+          "type": "object",
+          "properties": {
+            "naming": {
+              "type": "string",
+              "enum": ["enabled", "disabled", "warning"],
+              "default": "enabled"
+            },
+            "memory_safety": {
+              "type": "string",
+              "enum": ["enabled", "disabled", "warning"],
+              "default": "enabled"
+            },
+            "error_handling": {
+              "type": "string",
+              "enum": ["enabled", "disabled", "warning"],
+              "default": "enabled"
+            },
+            "documentation": {
+              "type": "string",
+              "enum": ["enabled", "disabled", "warning"],
+              "default": "enabled"
+            },
+            "header_guards": {
+              "type": "string",
+              "enum": ["enabled", "disabled", "warning"],
+              "default": "enabled"
+            },
+            "const_correctness": {
+              "type": "string",
+              "enum": ["enabled", "disabled", "warning"],
+              "default": "enabled"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Universal rules configuration"
+        },
+        "category_overrides": {
+          "type": "object",
+          "properties": {
+            "systems": {
+              "$ref": "#/definitions/systemsOverrides"
+            },
+            "embedded": {
+              "$ref": "#/definitions/embeddedOverrides"
+            },
+            "kernel": {
+              "$ref": "#/definitions/kernelOverrides"
+            },
+            "drivers": {
+              "$ref": "#/definitions/driversOverrides"
+            },
+            "realtime": {
+              "$ref": "#/definitions/realtimeOverrides"
+            },
+            "networking": {
+              "$ref": "#/definitions/networkingOverrides"
+            },
+            "legacy": {
+              "$ref": "#/definitions/legacyOverrides"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Category-specific configuration overrides"
+        },
+        "static_analysis": {
+          "type": "object",
+          "properties": {
+            "clang_tidy": {
+              "type": "boolean",
+              "default": false,
+              "description": "Enable clang-tidy integration"
+            },
+            "cppcheck": {
+              "type": "boolean",
+              "default": false,
+              "description": "Enable cppcheck integration"
+            },
+            "valgrind": {
+              "type": "boolean",
+              "default": false,
+              "description": "Enable valgrind integration"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Static analysis tool integration"
+        },
+        "custom_rules": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false,
+              "description": "Enable custom user-defined rules"
+            },
+            "path": {
+              "type": "string",
+              "default": ".augment/c-standards/custom-rules/",
+              "description": "Path to custom rules directory"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Custom rules configuration"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "systemsOverrides": {
+      "type": "object",
+      "properties": {
+        "require_posix_compliance": {
+          "type": "boolean",
+          "default": true
+        },
+        "check_system_call_errors": {
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "embeddedOverrides": {
+      "type": "object",
+      "properties": {
+        "allow_dynamic_allocation": {
+          "type": "boolean",
+          "default": false
+        },
+        "require_volatile_hardware": {
+          "type": "boolean",
+          "default": true
+        },
+        "max_stack_depth": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 20,
+          "default": 5
+        }
+      }
+    },
+    "kernelOverrides": {
+      "type": "object",
+      "properties": {
+        "require_kernel_style": {
+          "type": "boolean",
+          "default": true
+        },
+        "check_module_license": {
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "driversOverrides": {
+      "type": "object",
+      "properties": {
+        "require_device_tree": {
+          "type": "boolean",
+          "default": false
+        },
+        "check_interrupt_safety": {
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "realtimeOverrides": {
+      "type": "object",
+      "properties": {
+        "enforce_determinism": {
+          "type": "boolean",
+          "default": true
+        },
+        "max_execution_time_us": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 1000
+        }
+      }
+    },
+    "networkingOverrides": {
+      "type": "object",
+      "properties": {
+        "require_endian_handling": {
+          "type": "boolean",
+          "default": true
+        },
+        "check_buffer_overflow": {
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "legacyOverrides": {
+      "type": "object",
+      "properties": {
+        "allow_deprecated_functions": {
+          "type": "boolean",
+          "default": true
+        },
+        "suggest_modernization": {
+          "type": "boolean",
+          "default": true
+        }
+      }
+    }
+  }
+}
+