Add support the optional delphi-logger functionality.

Inject Write-CDHostLog snippet (v0.1.0) with BEGIN-CD-HOSTLOG /
END-CD-HOSTLOG seam markers for automated refresh from delphi-logger.

Migrate all Write-Output, Write-Information, Write-Verbose,
Write-Warning, and Write-Error calls to Write-CDHostLog. Custom
output helpers (Write-Detail, Write-Summary, Write-Section,
Write-SummarySection) now route through Write-CDHostLog internally
and use -LogOnly when display is suppressed by -OutputLevel or -Json,
so the logger captures events even when console output is quiet.

Add Complete-CDActivity at all exit points. Guard outer catch against
null exception messages.

Add tools/delphi-logger/ debug scripts for version, clean (WhatIf),
check, and showconfig commands. Add tools/update-delphilogger.bat
for snippet refresh.

For issue #30

Author: darianmiller

.gitignore

@@ -1,2 +1,3 @@
 # PowerShell test output
 tests/pwsh/results/*.xml
+tools/delphi-logger/**/debug.log

CHANGELOG.md

@@ -3,6 +3,10 @@
 All notable changes to this project will be documented in this file.
 
 ---
+## [1.1.0] - 2026-05-14
+
+- Support for `delphi-logger` added (opt-in structural logging for debug
+purposes.) [#30](https://github.com/continuous-delphi/delphi-clean/issues/30)
 
 ## [1.0.0] 2026-05-13
 

source/delphi-clean.ps1

@@ -0,0 +1,13 @@
+# Shared log dump helper for delphi-clean debug scripts.
+# Dot-source this at the end of each debug.ps1 to write captured
+# events to debug.log in the caller's folder.
+
+$callerDir = Split-Path -Parent $MyInvocation.PSCommandPath
+$debugLogFile = Join-Path $callerDir 'debug.log'
+$eventCount = (Get-CDLogEvents).Count
+
+Get-CDLogEvents | ForEach-Object {
+    '{0}  [{1}]  {2}' -f $_.timestampUtc, $_.level.ToUpperInvariant(), $_.message
+} | Set-Content -Path $debugLogFile -Encoding utf8
+
+Write-Host "Log written: $eventCount events to $debugLogFile"

tools/delphi-logger/Write-CDDebugLog.ps1

@@ -0,0 +1,5 @@
+@echo off
+pushd "%~dp0"
+pwsh -NoProfile -File "%~dp0debug.ps1"
+pause
+popd

tools/delphi-logger/check/debug.bat

@@ -0,0 +1,10 @@
+Import-Module ContinuousDelphi.Logger
+Initialize-CDLogger -Source 'delphi-clean' -OutputMode Silent -MinimumLevel Trace -CaptureOutput $true
+
+& "$PSScriptRoot\..\..\..\source\delphi-clean.ps1" `
+    -Level deep `
+    -RootPath 'C:\code\delphi-lexer' `
+    -OutputLevel detailed `
+    -Check
+
+. "$PSScriptRoot\..\Write-CDDebugLog.ps1"

tools/delphi-logger/check/debug.ps1

@@ -0,0 +1,5 @@
+@echo off
+pushd "%~dp0"
+pwsh -NoProfile -File "%~dp0debug.ps1"
+pause
+popd

tools/delphi-logger/clean/debug.bat

@@ -0,0 +1,10 @@
+Import-Module ContinuousDelphi.Logger
+Initialize-CDLogger -Source 'delphi-clean' -OutputMode Silent -MinimumLevel Trace -CaptureOutput $true
+
+& "$PSScriptRoot\..\..\..\source\delphi-clean.ps1" `
+    -Level deep `
+    -RootPath 'C:\code\delphi-lexer' `
+    -OutputLevel detailed `
+    -WhatIf
+
+. "$PSScriptRoot\..\Write-CDDebugLog.ps1"

tools/delphi-logger/clean/debug.ps1

@@ -0,0 +1,5 @@
+@echo off
+pushd "%~dp0"
+pwsh -NoProfile -File "%~dp0debug.ps1"
+pause
+popd

tools/delphi-logger/showconfig/debug.bat

@@ -0,0 +1,9 @@
+Import-Module ContinuousDelphi.Logger
+Initialize-CDLogger -Source 'delphi-clean' -OutputMode Silent -MinimumLevel Trace -CaptureOutput $true
+
+& "$PSScriptRoot\..\..\..\source\delphi-clean.ps1" `
+    -Level deep `
+    -RootPath 'C:\code\delphi-lexer' `
+    -ShowConfig
+
+. "$PSScriptRoot\..\Write-CDDebugLog.ps1"