Standardize public repo, landing page, docs, and release workflow

Author: masarray

.github/workflows/ci.yml

@@ -2,9 +2,9 @@ name: CI
 
 on:
   push:
-    branches: [ master, main ]
+    branches: [ main ]
   pull_request:
-    branches: [ master, main ]
+    branches: [ main ]
   workflow_dispatch:
 
 permissions:

.github/workflows/pages.yml

@@ -2,7 +2,7 @@ name: Deploy GitHub Pages
 
 on:
   push:
-    branches: [ master, main ]
+    branches: [ main ]
     paths:
       - 'docs/**'
       - '.github/workflows/pages.yml'

README.md

@@ -171,3 +171,8 @@ Good contribution areas include decoder tests, SCL parsing examples, documentati
 Source code is licensed under **Apache-2.0**. See [`LICENSE`](LICENSE).
 
 Npcap is a runtime prerequisite and is not vendored in this repository. Microsoft .NET/WPF runtime files may be included in self-contained published artifacts generated by `dotnet publish`; review [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md) before redistributing binary packages.
+
+
+## Branching policy
+
+This repository uses `main` as the single public development branch. See [Branching policy](docs/BRANCHING.md).

docs/BRANCHING.md

@@ -0,0 +1,22 @@
+# Branching policy
+
+Process Bus Insight uses a single public development branch:
+
+- `main` — stable public source, documentation, GitHub Pages content, CI, and release automation.
+
+This keeps the repository simple for users who only want to clone, build, download, or inspect the current product state.
+
+## Why one branch?
+
+A public engineering tool should be easy to understand at first glance. A single `main` branch avoids confusion between `master`, feature-hardening branches, temporary release branches, and outdated work-in-progress branches.
+
+## Recommended maintainer workflow
+
+1. Develop changes locally.
+2. Push directly to `main` only when the change is clean and buildable.
+3. For risky work, use a private/local branch first, then squash or merge into `main` before publishing.
+4. Use GitHub Releases for downloadable Windows packages instead of long-lived release branches.
+
+## Automation expectation
+
+The CI, GitHub Pages, and Windows portable release workflows are configured to target `main` only. Tag-based release runs still work for version tags such as `v1.2.3`.

scripts/standardize-main-branch.ps1

@@ -0,0 +1,115 @@
+<#
+.SYNOPSIS
+  Standardize this repository to a single public main branch.
+
+.DESCRIPTION
+  This helper prepares a clean public GitHub repository layout:
+  - ensures a local main branch exists,
+  - pushes main to origin,
+  - sets GitHub default branch to main,
+  - optionally deletes old remote branches after you confirm they are no longer needed.
+
+  The script is intentionally conservative. By default it runs in preview mode.
+
+.EXAMPLE
+  .\scripts\standardize-main-branch.ps1 -Owner masarray -Repo DigSubAnalyzer -WhatIf
+
+.EXAMPLE
+  .\scripts\standardize-main-branch.ps1 -Owner masarray -Repo DigSubAnalyzer -Apply
+
+.EXAMPLE
+  .\scripts\standardize-main-branch.ps1 -Owner masarray -Repo DigSubAnalyzer -Apply -DeleteRemoteBranches master,public-repo-hardening
+#>
+
+[CmdletBinding()]
+param(
+  [Parameter(Mandatory = $true)]
+  [string]$Owner,
+
+  [Parameter(Mandatory = $true)]
+  [string]$Repo,
+
+  [string]$TargetBranch = "main",
+
+  [string[]]$DeleteRemoteBranches = @(),
+
+  [switch]$Apply,
+
+  [switch]$WhatIf
+)
+
+$ErrorActionPreference = "Stop"
+
+function Invoke-Step {
+  param(
+    [Parameter(Mandatory = $true)] [string]$Description,
+    [Parameter(Mandatory = $true)] [scriptblock]$Command
+  )
+
+  Write-Host "`n==> $Description" -ForegroundColor Cyan
+  if (-not $Apply -or $WhatIf) {
+    Write-Host "Preview only. Use -Apply to execute." -ForegroundColor Yellow
+    return
+  }
+
+  & $Command
+}
+
+if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
+  throw "Git CLI was not found in PATH. Install Git for Windows first."
+}
+
+if (-not (Get-Command gh -ErrorAction SilentlyContinue)) {
+  throw "GitHub CLI was not found in PATH. Install GitHub CLI first."
+}
+
+$authStatus = gh auth status 2>&1
+if ($LASTEXITCODE -ne 0) {
+  throw "GitHub CLI is not authenticated. Run: gh auth login"
+}
+
+$repoFullName = "$Owner/$Repo"
+Write-Host "Repository : $repoFullName"
+Write-Host "Target     : $TargetBranch"
+Write-Host "Apply      : $Apply"
+Write-Host "Delete     : $($DeleteRemoteBranches -join ', ')"
+
+$currentBranch = (git branch --show-current).Trim()
+if ([string]::IsNullOrWhiteSpace($currentBranch)) {
+  throw "No current Git branch detected. Run this script from a normal local checkout."
+}
+
+Invoke-Step "Fetch origin" {
+  git fetch origin --prune
+}
+
+Invoke-Step "Create or update local $TargetBranch from current branch '$currentBranch'" {
+  $existing = git branch --list $TargetBranch
+  if ($existing) {
+    git checkout $TargetBranch
+    git merge $currentBranch --ff-only
+  } else {
+    git branch -m $TargetBranch
+  }
+}
+
+Invoke-Step "Push $TargetBranch to origin" {
+  git push -u origin $TargetBranch
+}
+
+Invoke-Step "Set GitHub default branch to $TargetBranch" {
+  gh repo edit $repoFullName --default-branch $TargetBranch --delete-branch-on-merge=true
+}
+
+foreach ($branch in $DeleteRemoteBranches) {
+  if ($branch -eq $TargetBranch) {
+    Write-Host "Skipping delete for target branch '$TargetBranch'." -ForegroundColor Yellow
+    continue
+  }
+
+  Invoke-Step "Delete remote branch origin/$branch" {
+    git push origin --delete $branch
+  }
+}
+
+Write-Host "`nDone. Expected public branch layout: only '$TargetBranch' remains as the public default branch." -ForegroundColor Green