Skip to content

chore: harden repo to open-source best practices - #1

Merged
LondonYount merged 1 commit into
mainfrom
chore/oss-standards-hardening
Jul 23, 2026
Merged

chore: harden repo to open-source best practices#1
LondonYount merged 1 commit into
mainfrom
chore/oss-standards-hardening

Conversation

@LondonYount

Copy link
Copy Markdown
Owner

Brings the fork up to the open-source SOP's best-in-class bar: community-profile completeness, trust signals, discoverability, CI, and security. Uses the AeroFlex repo as the exemplar for structure and README visuals.

Added

  • CI (.github/workflows/ci.yml) — type-check + test + build on Node 20/22/24, fail-fast: false, read-only token, actions pinned to commit SHAs (supply-chain hardening). Green build badge is now the top README trust signal.
  • Dependabot (.github/dependabot.yml) — weekly npm + github-actions updates.
  • Community healthSECURITY.md, SUPPORT.md, CODEOWNERS.
  • CITATION.cff — drives GitHub's "Cite this repository" widget.
  • Dotfiles.editorconfig, .gitattributes (LF normalization + binary classing; matters on Windows/CRLF).
  • Issue forms — structured YAML bug-report and feature/schema-change forms with a template chooser (config.yml), replacing the legacy Markdown templates.

Changed

  • README — CI badge, mermaid architecture diagram, a live ASCII-visualizer sample ("show, don't tell"), a table of contents, image alt text, and house-style hyphens (no em-dashes/emojis).
  • CONTRIBUTING — corrected clone URL, added good-first-issue / SUPPORT / SECURITY pointers.
  • package.json — corrected repository URLs (uhdOpenUHD).
  • CHANGELOGUnreleased entry for this work.

Verification

  • npm run type-check, npm test (83 passing), and npm run build all pass locally.
  • All new YAML/CFF files parse cleanly.

Manual steps (GitHub web UI only — see the accompanying summary)

Topics, About description, social-preview image, branch ruleset, Dependabot/secret-scanning toggles, and private vulnerability reporting still need to be set in Settings.

Bring the repo up to the SOP's best-in-class bar (community profile,
trust signals, discoverability, CI, security).

Added:
- .github/workflows/ci.yml: type-check + test + build on Node 20/22/24,
  fail-fast:false, read-only token, SHA-pinned actions
- .github/dependabot.yml (npm + github-actions weekly updates)
- .github/SECURITY.md, SUPPORT.md, CODEOWNERS
- CITATION.cff (drives "Cite this repository")
- .editorconfig, .gitattributes (LF normalization, binary classing)
- YAML issue forms + config chooser (replacing legacy .md templates)

Changed:
- README: CI badge, mermaid architecture diagram, live ASCII visualizer
  sample, table of contents, alt text, house-style hyphens
- CONTRIBUTING: fixed clone URL, added good-first-issue / support /
  security pointers
- package.json: corrected repository URLs (uhd -> OpenUHD)
- CHANGELOG: Unreleased entry for the hardening work
@LondonYount
LondonYount merged commit c38b31d into main Jul 23, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant