Roadmap
This roadmap focuses on the next maintainer workflows that would make oss-signal more useful to public OSS projects.
Current Focus
- Keep the CLI, npm package, GitHub Action, Marketplace listing, and Pages documentation aligned.
- Collect the first independent public workflow run or maintainer acknowledgement.
- Improve examples that help maintainers move from audit output to a small issue or pull request.
Near-Term Work
| Area |
Goal |
Evidence target |
| Adoption |
Help one external maintainer run SalmonPlays/oss-signal@v0.8.4 in a public workflow or leave concrete trial feedback. |
Issue #8, maintainer-trial.md, maintainer-feedback.md, then linked workflow run or maintainer reply in adoption-evidence.md. |
| Automation |
Document a stable JSON schema for consumers that parse --format json. |
Completed in Issue #9, json-output.md, schema, and fixture. |
| Code Scanning |
Add a complete screenshot-backed SARIF walkthrough. |
Completed in Issue #10, sarif-code-scanning.md, and output example. |
| Outreach |
Convert audit findings into PR-sized maintainer plans before posting externally. |
Implemented in --format plan, plan-output.md, and examples/github-plan.md. |
| Rules |
Add optional checks for funding metadata, typed package exports, and release provenance where relevant. |
Focused issues and tests. |
| Inventory |
Add richer organization-level examples with grouped top findings. |
Inventory report fixture and Action example. |
What Will Not Be Optimized
- Artificial stars, follows, or engagement.
- Spam issues or pull requests.
- Claims of third-party adoption before a maintainer uses, merges, replies to, or endorses the workflow.
- Broad code-quality scoring. The project measures visible maintainer-readiness signals only.
Contribution Routes
- Good first issues: https://github.com/SalmonPlays/oss-signal/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22good%20first%20issue%22
- Adoption report form: https://github.com/SalmonPlays/oss-signal/issues/new?template=adoption_report.yml
- Maintainer trial: https://github.com/SalmonPlays/oss-signal/blob/main/docs/maintainer-trial.md
- Maintainer feedback: https://github.com/SalmonPlays/oss-signal/blob/main/docs/maintainer-feedback.md
- Maintainer audit report form: https://github.com/SalmonPlays/oss-signal/issues/new?template=audit_report.yml
- Discussion: https://github.com/SalmonPlays/oss-signal/discussions/5
