chore(workflow): add changelog and lint automation (2026.6.4.0-F383)

Author: RealWhyKnot

.clang-format

@@ -0,0 +1,11 @@
+BasedOnStyle: LLVM
+IndentWidth: 4
+ColumnLimit: 100
+UseTab: Never
+SortIncludes: Never
+PointerAlignment: Right
+DerivePointerAlignment: false
+AllowShortFunctionsOnASingleLine: Empty
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLoopsOnASingleLine: false
+BreakBeforeBraces: Attach

.editorconfig

@@ -0,0 +1,25 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.ps1]
+end_of_line = crlf
+indent_size = 4
+
+[*.rs]
+indent_size = 4
+
+[*.{c,h}]
+indent_size = 4

.gitattributes

@@ -2,6 +2,8 @@
 
 .gitattributes text eol=lf
 .gitignore text eol=lf
+.clang-format text eol=lf
+.editorconfig text eol=lf
 LICENSE text eol=lf
 NOTICE text eol=lf
 CMakeLists.txt text eol=lf
@@ -21,6 +23,8 @@ CMakeLists.txt text eol=lf
 *.cmake text eol=lf
 *.lock text eol=lf
 
+.githooks/* text eol=lf
+
 *.uf2 binary
 *.exe binary
 *.zip binary

.githooks/commit-msg

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+# Reject commit subjects with more than one build-version stamp.
+
+set -euo pipefail
+
+msg_file="$1"
+[ -f "$msg_file" ] || exit 0
+
+subject="$(grep -m1 -vE '^(#|$)' "$msg_file" || true)"
+[ -n "$subject" ] || exit 0
+
+count=$( ( printf '%s\n' "$subject" |
+  grep -oE '\([0-9]{4}\.[0-9]+\.[0-9]+\.[0-9]+(-[A-Za-z0-9]{4})?\)' ||
+  true ) | grep -c . || true )
+count=${count//[^0-9]/}
+[ -n "$count" ] || count=0
+
+if [ "${count:-0}" -gt 1 ]; then
+  echo "" >&2
+  echo "commit-msg: subject contains $count build-version stamps; expected at most one." >&2
+  echo "" >&2
+  echo "  subject: $subject" >&2
+  echo "" >&2
+  echo "Drop stale (YYYY.M.D.N-XXXX) text from the subject and commit again." >&2
+  echo "" >&2
+  exit 1
+fi
+
+exit 0

.githooks/prepare-commit-msg

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+# Append the current build version to new commit subjects.
+
+set -eu
+
+msg_file="$1"
+source="${2:-}"
+
+case "$source" in
+  merge|squash) exit 0 ;;
+esac
+
+stamp_pattern='\([0-9]{4}\.[0-9]+\.[0-9]+\.[0-9]+(-[A-Za-z0-9]{4})?\)'
+
+if [ "$source" != "commit" ]; then
+  subject="$(grep -m1 -vE '^(#|$)' "$msg_file" || true)"
+  if printf '%s\n' "$subject" | grep -qE "$stamp_pattern"; then
+    echo "" >&2
+    echo "prepare-commit-msg: subject already contains a build-version stamp." >&2
+    echo "" >&2
+    echo "  subject: $subject" >&2
+    echo "" >&2
+    echo "Let this hook append the current version from version.txt instead of copying" >&2
+    echo "a stamp from an older commit subject." >&2
+    echo "" >&2
+    exit 1
+  fi
+fi
+
+repo_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"
+[ -n "$repo_root" ] || exit 0
+
+version_file="$repo_root/version.txt"
+version=""
+if [ -f "$version_file" ]; then
+  version="$(tr -d '\r' < "$version_file" | sed 's/[^[:print:]]//g' | xargs)"
+fi
+
+today="$(date +%Y.%-m.%-d)"
+if ! printf '%s\n' "$version" | grep -qE "^${today}\."; then
+  short_head="$(git rev-parse --short=4 HEAD 2>/dev/null | tr 'a-z' 'A-Z')"
+  [ -n "$short_head" ] || short_head="0000"
+  version="${today}.0-${short_head}"
+  printf '%s' "$version" > "$version_file"
+fi
+
+[ -n "$version" ] || exit 0
+
+if ! grep -qE "$stamp_pattern" "$msg_file"; then
+  sed -i "1s/\$/ ($version)/" "$msg_file"
+fi

.github/scripts/Test-UpdateChangelog.ps1

@@ -0,0 +1,78 @@
+#!/usr/bin/env pwsh
+[CmdletBinding()]
+param()
+
+$ErrorActionPreference = "Stop"
+
+$repo = Join-Path ([System.IO.Path]::GetTempPath()) ("changelog-test-" + [System.Guid]::NewGuid().ToString("N"))
+$script = Join-Path $PSScriptRoot "Update-Changelog.ps1"
+
+function Invoke-Git {
+    param([Parameter(Mandatory = $true)][string[]]$Arguments)
+    & git @Arguments | Out-Null
+    if ($LASTEXITCODE -ne 0) {
+        throw "git $($Arguments -join ' ') failed with exit code $LASTEXITCODE"
+    }
+}
+
+try {
+    New-Item -ItemType Directory -Path $repo -Force | Out-Null
+    Push-Location $repo
+
+    Invoke-Git @("init", "-q")
+    Invoke-Git @("config", "user.email", "dev@example.com")
+    Invoke-Git @("config", "user.name", "Dev")
+
+    $seedChangelog = @(
+        "# Changelog",
+        "",
+        "## Unreleased",
+        "",
+        "_No notable changes since the last release._"
+    ) -join "`n"
+    Set-Content -LiteralPath "CHANGELOG.md" -Value $seedChangelog -Encoding ASCII
+
+    Invoke-Git @("add", ".")
+    Invoke-Git @("commit", "-m", "chore: base")
+
+    Set-Content -LiteralPath "sample.txt" -Value "one" -Encoding ASCII
+    Invoke-Git @("add", ".")
+    Invoke-Git @("commit", "-m", "feat(cli): add setup menu (2026.6.4.0-ABCD)")
+    $first = (& git rev-parse HEAD).Trim()
+
+    Set-Content -LiteralPath "sample.txt" -Value "two" -Encoding ASCII
+    Invoke-Git @("add", ".")
+    Invoke-Git @("commit", "-m", "docs: update readme")
+    $second = (& git rev-parse HEAD).Trim()
+
+    & $script -Mode Append -Range "$first^..$second" -RepoRoot $repo
+    if ($LASTEXITCODE -ne 0) { throw "Append failed." }
+
+    $text = Get-Content -LiteralPath "CHANGELOG.md" -Raw
+    if ($text -notmatch "### Added" -or $text -notmatch "\*\*cli:\*\* Add setup menu") {
+        throw "Append did not add the expected feature entry."
+    }
+    if ($text -match "update readme") {
+        throw "Append included a docs-only commit."
+    }
+
+    & $script -Mode Promote -Version "v2026.6.4.0" -Repo "owner/repo" -RepoRoot $repo
+    if ($LASTEXITCODE -ne 0) { throw "Promote failed." }
+
+    $text = Get-Content -LiteralPath "CHANGELOG.md" -Raw
+    if ($text -notmatch "## \[v2026\.6\.4\.0\]") {
+        throw "Promote did not create a versioned section."
+    }
+
+    $notes = & $script -Mode Notes -ForVersion -Version "v2026.6.4.0" -RepoRoot $repo
+    if ($notes -notmatch "Add setup menu") {
+        throw "Notes did not return the promoted section."
+    }
+
+    Write-Host "Update-Changelog tests passed."
+} finally {
+    Pop-Location
+    if (Test-Path -LiteralPath $repo) {
+        Remove-Item -LiteralPath $repo -Recurse -Force
+    }
+}

.github/scripts/Test-WorkflowSyntax.ps1

@@ -0,0 +1,133 @@
+#!/usr/bin/env pwsh
+[CmdletBinding()]
+param(
+    [string]$Root = (Get-Location).Path
+)
+
+$ErrorActionPreference = "Stop"
+
+$errors = [System.Collections.Generic.List[string]]::new()
+
+function Add-ParserErrors {
+    param(
+        [Parameter(Mandatory = $true)][string]$Source,
+        [Parameter(Mandatory = $true)]$ParseErrors
+    )
+
+    foreach ($parseError in $ParseErrors) {
+        $line = $parseError.Extent.StartLineNumber
+        $col = $parseError.Extent.StartColumnNumber
+        $errors.Add("$Source (line ${line}:${col}): $($parseError.Message)") | Out-Null
+    }
+}
+
+Get-ChildItem -LiteralPath $Root -Filter "*.ps1" -Recurse |
+    Where-Object {
+        $_.FullName -notmatch "\\bridge\\target\\" -and
+        $_.FullName -notmatch "\\dist\\" -and
+        $_.FullName -notmatch "\\pico-bridge\\build"
+    } |
+    ForEach-Object {
+        $parseErrors = $null
+        [void][System.Management.Automation.Language.Parser]::ParseFile(
+            $_.FullName,
+            [ref]$null,
+            [ref]$parseErrors
+        )
+        if ($parseErrors) {
+            Add-ParserErrors -Source $_.FullName -ParseErrors $parseErrors
+        }
+    }
+
+$workflowDir = Join-Path $Root ".github\workflows"
+if (Test-Path -LiteralPath $workflowDir) {
+    $ghaPattern = [regex]"\$\{\{[^}]*\}\}"
+    Get-ChildItem -LiteralPath $workflowDir -Filter "*.yml" | ForEach-Object {
+        $path = $_.FullName
+        $lines = Get-Content -LiteralPath $path
+        $stepName = "<unnamed>"
+        $isPwsh = $false
+        $inRun = $false
+        $runIndent = -1
+        $runStart = 0
+        $block = [System.Collections.Generic.List[string]]::new()
+
+        $flush = {
+            if ($block.Count -eq 0) { return }
+            $baseline = -1
+            foreach ($line in $block) {
+                if ($line.Trim().Length -eq 0) { continue }
+                $baseline = $line.Length - $line.TrimStart(" ").Length
+                break
+            }
+            if ($baseline -lt 0) { return }
+
+            $body = ($block | ForEach-Object {
+                if ($_.Length -gt $baseline) { $_.Substring($baseline) } else { "" }
+            }) -join "`n"
+            $body = $ghaPattern.Replace($body, "__GHA_EXPR__")
+
+            $parseErrors = $null
+            [void][System.Management.Automation.Language.Parser]::ParseInput(
+                $body,
+                [ref]$null,
+                [ref]$parseErrors
+            )
+            if ($parseErrors) {
+                Add-ParserErrors -Source "$path step '$stepName' (run: line $runStart)" -ParseErrors $parseErrors
+            }
+        }
+
+        for ($i = 0; $i -lt $lines.Count; $i++) {
+            $line = $lines[$i]
+            $indent = $line.Length - $line.TrimStart(" ").Length
+            $trimmed = $line.Trim()
+
+            if ($inRun) {
+                if ($trimmed.Length -gt 0 -and $indent -le $runIndent) {
+                    & $flush
+                    $block.Clear()
+                    $inRun = $false
+                } else {
+                    $block.Add($line) | Out-Null
+                    continue
+                }
+            }
+
+            if ($trimmed -match "^- name:\s*(.+?)\s*$") {
+                if ($block.Count -gt 0) {
+                    & $flush
+                    $block.Clear()
+                    $inRun = $false
+                }
+                $stepName = $matches[1]
+                $isPwsh = $false
+                continue
+            }
+
+            if ($trimmed -match "^shell:\s*(.+?)\s*$") {
+                $isPwsh = ($matches[1] -eq "pwsh")
+                continue
+            }
+
+            if ($isPwsh -and $trimmed -match "^run:\s*\|\s*$") {
+                $inRun = $true
+                $runIndent = $indent
+                $runStart = $i + 1
+                $block.Clear()
+                continue
+            }
+        }
+        if ($inRun) { & $flush }
+    }
+}
+
+if ($errors.Count -gt 0) {
+    Write-Host "PowerShell syntax errors:"
+    foreach ($message in $errors) {
+        Write-Host "  $message"
+    }
+    throw "Found $($errors.Count) PowerShell syntax error(s)."
+}
+
+Write-Host "PowerShell scripts and inline workflow blocks parsed cleanly."