Initial commit

Author: Warezloder

.editorconfig

@@ -0,0 +1,35 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# All files
+[*]
+charset = utf-8
+end_of_line = crlf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+# PowerShell files
+[*.{ps1,psd1,psm1}]
+indent_style = space
+indent_size = 4
+
+# Markdown files
+[*.md]
+trim_trailing_whitespace = false
+
+# JSON files
+[*.json]
+indent_style = space
+indent_size = 2
+
+# XML files
+[*.xml]
+indent_style = space
+indent_size = 2
+
+# YAML files
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2

.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

.gitignore

@@ -0,0 +1,50 @@
+# Build outputs
+/build/
+/output/
+/TestOutput/
+/ModuleExports/
+
+# Test results
+TestResults.xml
+coverage.xml
+*.coverage
+*.trx
+
+# User-specific files
+*.user
+*.suo
+*.cache
+.vs/
+
+# PowerShell specific
+*.ps1xml
+!Types/*.ps1xml
+!Formats/*.ps1xml
+
+# IDE
+.vscode/
+.idea/
+*.code-workspace
+
+# OS files
+Thumbs.db
+.DS_Store
+desktop.ini
+
+# Temporary files
+*.tmp
+*.temp
+*.log
+*.bak
+
+# Package files
+*.nupkg
+*.zip
+*.tar.gz
+
+# Sensitive data
+*.key
+*.pfx
+*.cer
+secrets.json
+config.local.json

CHANGELOG.md

@@ -0,0 +1,43 @@
+# Changelog
+
+All notable changes to this project 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.1] - 2025-08-23
+
+### Changed
+
+- JSON output is now pretty-printed by default: removed `-Compress` from all `ConvertTo-Json` calls in both streaming and non-streaming export paths to improve readability.
+
+## [1.0.0] - 2025-08-23
+
+### Added
+
+- Initial release of Export-ModuleInfoForLLM module
+- Support for exporting PowerShell module commands to JSON, Markdown, and XML formats
+- Parallel processing capability for improved performance
+- Batch export functionality for multiple modules
+- Streaming support for large datasets
+- Comprehensive command documentation extraction including:
+  - Synopsis and descriptions
+  - Parameters with types and validation
+  - Examples with code and remarks
+  - Related links and notes
+- Module availability testing function
+- Progress tracking and verbose logging
+- Error recovery and graceful failure handling
+
+### Features
+
+- `Export-ModuleCommandsForLLM` - Main export function
+- `Start-ParallelModuleExport` - Batch module export
+- `Test-ModuleAvailability` - Module availability checking
+
+### Performance
+
+- Parallel command processing within modules
+- Concurrent module exports
+- Streaming JSON for memory efficiency
+- Automatic compression for large datasets

CONTRIBUTING.md

@@ -0,0 +1,117 @@
+# Contributing to Export-ModuleInfoForLLM
+
+Thank you for your interest in contributing to Export-ModuleInfoForLLM! This document provides guidelines and instructions for contributing.
+
+## Code of Conduct
+
+By participating in this project, you agree to maintain a respectful and inclusive environment.
+
+## Getting Started
+
+### Prerequisites
+
+- PowerShell 5.1 or PowerShell Core 7.x
+- Git
+- Pester 5.x for running tests
+- PSScriptAnalyzer for code analysis
+
+### Development Setup
+
+1. Fork the repository
+2. Clone your fork:
+   ```powershell
+   git clone https://github.com/Warezloder/Export-ModuleInfoForLLM.git
+   cd Export-ModuleInfoForLLM
+   ```
+
+3. Install development dependencies:
+   ```powershell
+   Install-Module -Name Pester -MinimumVersion 5.0 -Scope CurrentUser
+   Install-Module -Name PSScriptAnalyzer -Scope CurrentUser
+   ```
+
+4. Import the module for development:
+   ```powershell
+   Import-Module .\Export-ModuleInfoForLLM.psd1 -Force
+   ```
+
+## Development Guidelines
+
+### Code Standards
+
+- Follow the [PowerShell Practice and Style Guide](https://poshcode.gitbook.io/powershell-practice-and-style/)
+- Use approved verbs (`Get-Verb`)
+- Include comment-based help for all public functions
+- Add parameter validation
+- Implement proper error handling
+
+### Testing
+
+All contributions must include appropriate tests:
+
+```powershell
+# Run all tests
+Invoke-Pester -Path .\Tests
+
+# Run with code coverage
+Invoke-Pester -Path .\Tests -CodeCoverage .\Public\*.ps1, .\Private\*.ps1
+
+# Run specific test file
+Invoke-Pester -Path .\Tests\Unit\Export-ModuleCommandsForLLM.Tests.ps1
+```
+
+### Code Analysis
+
+Run PSScriptAnalyzer before submitting:
+
+```powershell
+Invoke-ScriptAnalyzer -Path . -Recurse -Settings PSGallery
+```
+
+## Submission Process
+
+### Pull Request Process
+
+1. Create a feature branch:
+   ```powershell
+   git checkout -b feature/your-feature-name
+   ```
+
+2. Make your changes following the code standards
+
+3. Add/update tests for your changes
+
+4. Update documentation if needed
+
+5. Run tests and ensure they pass:
+   ```powershell
+   .\build.ps1 -Task Test
+   ```
+
+6. Commit your changes:
+   ```powershell
+   git commit -m "Add: Description of your changes"
+   ```
+
+7. Push to your fork:
+   ```powershell
+   git push origin feature/your-feature-name
+   ```
+
+8. Create a Pull Request with:
+   - Clear description of changes
+   - Reference to any related issues
+   - Test results summary
+
+### Commit Message Format
+
+Use conventional commits format:
+- `Add:` New feature
+- `Fix:` Bug fix
+- `Update:` Non-breaking change
+- `Breaking:` Breaking change
+- `Docs:` Documentation only
+- `Test:` Test additions/changes
+
+## Project Structure
+

Export-ModuleInfoForLLM.psd1

@@ -0,0 +1,64 @@
+@{
+    # Script module or binary module file associated with this manifest.
+    RootModule = 'Export-ModuleInfoForLLM.psm1'
+
+    # Version number of this module.
+    ModuleVersion = '1.0.1'
+
+    # Supported PSEditions
+    CompatiblePSEditions = @('Desktop', 'Core')
+
+    # ID used to uniquely identify this module
+    GUID = 'a7c4b8f2-3d5e-4f9a-b1c2-d3e4f5a6b7c8'
+
+    # Author of this module
+    Author = 'Atticus M.'
+
+    # Company or vendor of this module
+    CompanyName = 'Boro-Geek'
+
+    # Copyright statement for this module
+    Copyright = '(c) 2024 amull. All rights reserved.'
+
+    # Description of the functionality provided by this module
+    Description = 'PowerShell module for exporting module command information in LLM-friendly formats (JSON, Markdown, XML). Supports parallel processing for improved performance.'
+
+    # Minimum version of the PowerShell engine required by this module
+    PowerShellVersion = '5.1'
+
+    # Functions to export from this module
+    FunctionsToExport = @(
+        'Export-ModuleCommandsForLLM',
+        'Start-ParallelModuleExport',
+        'Test-ModuleAvailability'
+    )
+
+    # Cmdlets to export from this module
+    CmdletsToExport = @()
+
+    # Variables to export from this module
+    VariablesToExport = @()
+
+    # Aliases to export from this module
+    AliasesToExport = @()
+
+    # Private data to pass to the module specified in RootModule/ModuleToProcess
+    PrivateData = @{
+        PSData = @{
+            # Tags applied to this module for module discovery
+            Tags = @('PowerShell', 'Module', 'Export', 'Documentation', 'LLM', 'AI', 'Automation')
+
+            # A URL to the license for this module.
+            LicenseUri = ''
+
+            # A URL to the main website for this project.
+            ProjectUri = ''
+
+            # ReleaseNotes of this module
+            ReleaseNotes = '1.0.1: JSON output is now pretty-printed by default (removed -Compress from ConvertTo-Json in all paths).'
+
+            # Flag to indicate whether the module requires explicit user acceptance
+            RequireLicenseAcceptance = $false
+        }
+    }
+}

Export-ModuleInfoForLLM.psm1

@@ -0,0 +1,40 @@
+#Requires -Version 5.1
+using namespace System.Collections.Generic
+using namespace System.Text
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+# Check if we have the modular structure, otherwise load from parent
+$publicFunctions = @(Get-ChildItem -Path "$PSScriptRoot\Public\*.ps1" -ErrorAction SilentlyContinue)
+$privateFunctions = @(Get-ChildItem -Path "$PSScriptRoot\Private\*.ps1" -ErrorAction SilentlyContinue)
+
+if ($publicFunctions.Count -gt 0 -or $privateFunctions.Count -gt 0) {
+    # Load from modular structure
+    foreach ($function in @($publicFunctions + $privateFunctions)) {
+        try {
+            Write-Verbose "Importing function: $($function.BaseName)"
+            . $function.FullName
+        }
+        catch {
+            Write-Error "Failed to import function $($function.FullName): $_"
+        }
+    }
+    # Export public functions
+    Export-ModuleMember -Function $publicFunctions.BaseName
+} else {
+    # Load from single file in parent directory (temporary backward compatibility)
+    $parentModulePath = Join-Path (Split-Path $PSScriptRoot -Parent) 'Export-ModuleInfoForLLM.psm1'
+    if (Test-Path $parentModulePath) {
+        Write-Verbose "Loading module from parent directory for backward compatibility"
+        . $parentModulePath
+
+        # Note: The Export-ModuleMember at the end of the parent module file will handle exports
+        # We don't need to re-export here as it's already done in the sourced file
+    } else {
+        Write-Error "No module functions found. Expected either:"
+        Write-Error "  - Functions in $PSScriptRoot\Public and $PSScriptRoot\Private"
+        Write-Error "  - Module file at $parentModulePath"
+        throw "Module structure not found"
+    }
+}

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Senior Cat Hurder
+
+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.