Initial commit

Author: franckferman

.gitattributes

@@ -0,0 +1 @@
+docs/** linguist-documentation=true

.github/PSScriptAnalyzerSettings.psd1

@@ -0,0 +1,15 @@
+@{
+    ExcludeRules = @(
+        # Interactive CLI scripts — Write-Host with -ForegroundColor is intentional
+        'PSAvoidUsingWriteHost',
+
+        # UTF-8 without BOM is intentional for cross-platform compatibility
+        'PSUseBOMForUnicodeEncodedFile',
+
+        # Network scanning code — empty catch blocks intentionally swallow connection failures
+        'PSAvoidUsingEmptyCatchBlock',
+
+        # Dead variables in original code left for forward-compatibility
+        'PSUseDeclaredVarsMoreThanAssignments'
+    )
+}

.github/workflows/ci.yml

@@ -0,0 +1,80 @@
+name: CI
+
+on:
+  push:
+    branches: [stable, dev]
+  pull_request:
+    branches: [stable]
+
+jobs:
+  lint-powershell:
+    name: PSScriptAnalyzer
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install PSScriptAnalyzer
+        shell: pwsh
+        run: Install-Module PSScriptAnalyzer -Force -Scope CurrentUser
+
+      - name: Analyze scripts
+        shell: pwsh
+        run: |
+          $settings = './.github/PSScriptAnalyzerSettings.psd1'
+          $results = Invoke-ScriptAnalyzer -Path ./scripts -Recurse -Severity Warning,Error -Settings $settings
+          if ($results) {
+            $results | Format-Table -AutoSize
+            exit 1
+          }
+          Write-Host "[+] PSScriptAnalyzer: scripts/ clean."
+
+      - name: Analyze module
+        shell: pwsh
+        run: |
+          $settings = './.github/PSScriptAnalyzerSettings.psd1'
+          $results = Invoke-ScriptAnalyzer -Path ./ADMappingToolkit.psm1 -Severity Warning,Error -Settings $settings
+          if ($results) {
+            $results | Format-Table -AutoSize
+            exit 1
+          }
+          Write-Host "[+] PSScriptAnalyzer: ADMappingToolkit.psm1 clean."
+
+  lint-python:
+    name: Python syntax
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Syntax check
+        run: |
+          python3 -m py_compile tools/Invoke-PSEncoder.py
+          echo "[+] Python syntax OK."
+
+  verify-structure:
+    name: Verify structure
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check required files
+        run: |
+          required=(
+            "ADMappingToolkit.psm1"
+            "scripts/Check-All.ps1"
+            "scripts/Check-Servers.ps1"
+            "scripts/Check-Clients.ps1"
+            "tools/Invoke-PSEncoder.py"
+            "tools/Sign-Scripts.ps1"
+            "docs/index.html"
+            "docs/doc.html"
+          )
+          fail=0
+          for f in "${required[@]}"; do
+            if [ ! -f "$f" ]; then
+              echo "[!] Missing: $f"
+              fail=1
+            else
+              echo "[+] $f"
+            fi
+          done
+          exit $fail

.github/workflows/static.yml

@@ -0,0 +1,40 @@
+name: Deploy static content to Pages
+
+on:
+  push:
+    branches: ["stable"]
+    paths:
+      - "docs/**"
+
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './docs'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,18 @@
+# Windows
+Thumbs.db
+desktop.ini
+$RECYCLE.BIN/
+
+# Editors
+.vscode/
+.idea/
+*.swp
+*~
+
+# PowerShell signing artifacts
+*.pfx
+*.cer
+*.p12
+
+# OS
+.DS_Store