index.md

OSS Maintainer Signal

oss-signal is a maintainer-readiness CLI and GitHub Action for open-source projects that need repeatable repository health checks, CI evidence, inventory reports, SARIF output, issue-ready cleanup notes, PR-sized maintainer plans, adoption packs, a transparent rule catalog, and no-fail workflow trials.

Quick Start

Add a report-only workflow to the current checkout:

npx oss-signal --init

Run against a public GitHub repository without cloning it:

npx oss-signal SalmonPlays/oss-signal

Run as a GitHub Action:

- uses: SalmonPlays/oss-signal@1bb4418e14be225b5f5b628986ea464241caf7f1 # v0.10.0
  id: oss-signal
  with:
    path: "."
    format: markdown
    output: oss-signal-report.md

What It Checks

• README, license, contributing, security, support, and changelog files
• CI, tests, CodeQL, Dependabot, issue templates, and PR templates
• GitHub repository URL audits without cloning
• Inventory reports across multiple repositories
• Markdown, summary, JSON, env, SARIF, issue-ready, maintainer-plan, and workflow output formats
• Rule catalog output with scoring weights for pre-review transparency

Reviewer Evidence

• Root reviewer packet: ../REVIEWER_PACKET.md

• Latest committed evidence verification: PASS 16, SKIP 0, FAIL 0, generated 2026-06-19T07:09:25.597Z. The Evidence verification workflow runs with GITHUB_TOKEN on main.

• Latest manual evidence refresh: evidence-refresh-2026-06-18.md, with all public workflows successful for the checked bed0978 baseline on 2026-06-18.

• Current post-submission update: selection-update-2026-06-21.md, with current package, workflow, field-audit, and external PR evidence.

• Adoption gap closure plan: adoption-gap-closure.md, with the current weak signals and the exact evidence that would close them.

• Independent run request: independent-workflow-run-request.md, with a copyable no-fail workflow for maintainer-owned public repositories.

• Latest reviewer packet: reviewer-packet-2026-06-08.md, with public workflow run links and current package evidence.

• Evidence workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/evidence-verify.yml

• Quickstart

• Reviewer evidence quickstart

• Reviewer packet, 2026-06-08

• Evidence verification snapshot

• Evidence refresh, 2026-06-18

• Evidence ledger

• Community engagement

• Acknowledgements

• Trust center

• Adoption evidence

• Codex for OSS fit/gap review

• Adoption gap closure plan

• Selection update, 2026-06-19

• Independent workflow run request

• Selection update, 2026-06-08

• Adoption kit

• Maintainer trial

• Maintainer feedback

• Social launch kit

• Organic discovery playbook

• Configuration

• Summary output

• Maintainer playbook

• Architecture

• Security model

• JSON output contract

• Single-repository JSON schema

• Inventory JSON schema

• Trend JSON schema

• Trend JSON fixture

• Trend workflow example

• Rule catalog JSON schema

• Rule catalog JSON fixture

• Adoption pack example

• Maintainer plan output

• SARIF Code Scanning walkthrough

• Roadmap

• Rules and scoring weights

• Post-submission update

• Release process

• Marketplace publishing checklist

Public Links

• Repository: https://github.com/SalmonPlays/oss-signal
• npm package: https://www.npmjs.com/package/oss-signal
• GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.10.0
• GitHub Marketplace listing: https://github.com/marketplace/actions/oss-signal
• Maintainer workflow discussion: #5