v1.5.0 release

.github/Dependabot.yml

@@ -0,0 +1,36 @@
+# Dependabot configuration for AsBuiltReport.Core
+# https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  # Monitor GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    labels:
+      - "dependencies"
+      - "github-actions"
+    commit-message:
+      prefix: "ci"
+      include: "scope"
+    open-pull-requests-limit: 5
+
+  # Monitor PowerShell modules (via manifest)
+  - package-ecosystem: "nuget"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    labels:
+      - "dependencies"
+      - "powershell"
+    commit-message:
+      prefix: "deps"
+      include: "scope"
+    open-pull-requests-limit: 5
+    ignore:
+      # PScribo updates should be reviewed manually
+      - dependency-name: "PScribo"
+        update-types: ["version-update:semver-major"]

.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+#github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+#patreon: # Replace with a single Patreon username
+#open_collective: # Replace with a single Open Collective username
+ko_fi: B0B7DDGZ7
+#tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+#community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+#liberapay: # Replace with a single Liberapay username
+#issuehunt: # Replace with a single IssueHunt username
+#lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+#polar: # Replace with a single Polar username
+#buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+#thanks_dev: # Replace with a single thanks.dev username
+#custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/PULL_REQUEST_TEMPLATE.md

@@ -31,4 +31,4 @@
 - [ ] My code follows the code style of this project.
 - [ ] My change requires a change to the documentation.
 - [ ] I have updated the documentation accordingly.
-- [ ] I have read the [**CONTRIBUTING**](https://www.asbuiltreport.com/about/contributing/) page.
+- [ ] I have read the [**CONTRIBUTING**](/CONTRIBUTING.md) page.

.github/workflows/PSScriptAnalyzer.yml

@@ -3,6 +3,9 @@ on: [push, pull_request]
 jobs:
   lint:
     name: Run PSScriptAnalyzer
+    permissions:
+      contents: read
+      pull-requests: write
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4

.github/workflows/Pester.yml

@@ -0,0 +1,84 @@
+name: Pester Tests
+
+permissions:
+  contents: read
+
+on:
+  push:
+    branches: [main, dev, master]
+  pull_request:
+    branches: [main, dev, master]
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, ubuntu-latest, macos-latest]
+        psversion: [pwsh, powershell]
+        exclude:
+          # PowerShell 5.1 (powershell) is only available on Windows
+          - os: ubuntu-latest
+            psversion: powershell
+          - os: macos-latest
+            psversion: powershell
+
+    name: Test on ${{ matrix.os }} with ${{ matrix.psversion == 'pwsh' && 'PowerShell 7.x' || 'PowerShell 5.1' }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install required modules (PowerShell 7.x)
+        if: matrix.psversion == 'pwsh'
+        shell: pwsh
+        run: |
+          Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
+          Install-Module -Name Pester -MinimumVersion 5.0.0 -Force -SkipPublisherCheck
+          Install-Module -Name PScribo -MinimumVersion 0.11.1 -Force
+
+      - name: Install required modules (PowerShell 5.1)
+        if: matrix.psversion == 'powershell'
+        shell: powershell
+        run: |
+          Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
+          Install-Module -Name Pester -MinimumVersion 5.0.0 -Force -SkipPublisherCheck
+          Install-Module -Name PScribo -MinimumVersion 0.11.1 -Force
+
+      - name: Run Pester tests (PowerShell 7.x)
+        if: matrix.psversion == 'pwsh'
+        shell: pwsh
+        run: |
+          .\Tests\Invoke-Tests.ps1 -CodeCoverage -OutputFormat NUnitXml
+
+      - name: Run Pester tests (PowerShell 5.1)
+        if: matrix.psversion == 'powershell'
+        shell: powershell
+        run: |
+          .\Tests\Invoke-Tests.ps1 -CodeCoverage -OutputFormat NUnitXml
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results-${{ matrix.os }}-${{ matrix.psversion }}
+          path: testResults.xml
+
+      - name: Upload code coverage
+        if: always() && matrix.os == 'windows-latest' && matrix.psversion == 'pwsh'
+        uses: actions/upload-artifact@v4
+        with:
+          name: code-coverage
+          path: coverage.xml
+
+      - name: Upload coverage reports to Codecov
+        if: always() && matrix.os == 'windows-latest' && matrix.psversion == 'pwsh'
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          slug: AsBuiltReport/AsBuiltReport.Core
+          files: ./coverage.xml
+          flags: unittests
+          fail_ci_if_error: false

.github/workflows/Release.yml

@@ -1,5 +1,6 @@
 name: Publish PowerShell Module
-
+permissions:
+  contents: read
 on:
   release:
     types: [published]
@@ -20,11 +21,11 @@ jobs:
       - name: Test Module Manifest
         shell: pwsh
         run: |
-          Test-ModuleManifest .\AsBuiltReport.Core.psd1
+          Test-ModuleManifest .\AsBuiltReport.Core\AsBuiltReport.Core.psd1
       - name: Publish module to PowerShell Gallery
         shell: pwsh
         run: |
-          Publish-Module -Path ./ -NuGetApiKey ${{ secrets.PSGALLERY_API_KEY }} -Verbose
+          Publish-Module -Path .\AsBuiltReport.Core\ -NuGetApiKey ${{ secrets.PSGALLERY_API_KEY }} -Verbose
   tweet:
     needs: publish-to-gallery
     runs-on: ubuntu-latest

.github/workflows/Stale.yml

@@ -0,0 +1,21 @@
+name: 'Close stale issues and PRs'
+on:
+  schedule:
+    - cron: '30 1 * * *'
+
+jobs:
+  stale:
+    permissions:
+      issues: write
+      pull-requests: write
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/stale@v9
+        with:
+          stale-issue-message: 'This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.'
+          days-before-stale: 60
+          days-before-close: 7
+          exempt-pr-labels: 'help wanted,enhancement,security,pinned'
+          stale-pr-label: 'wontfix'
+          stale-issue-label: 'wontfix'
+          exempt-issue-labels: 'help wanted,enhancement,security,pinned'

.gitignore

@@ -0,0 +1,3 @@
+.claude/
+.vscode/launch.json
+coverage.xml