oss-signal 0.7.0 → 0.8.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +10 -0
- package/README.md +36 -22
- package/action.yml +3 -3
- package/docs/adoption-evidence.md +32 -25
- package/docs/adoption-kit.md +16 -6
- package/docs/assets/code-scanning-results.svg +1 -1
- package/docs/assets/oss-signal-banner.svg +1 -1
- package/docs/brand.md +1 -1
- package/docs/codex-for-oss-application.md +33 -24
- package/docs/codex-for-oss-form-answers.md +12 -7
- package/docs/evidence-ledger.md +46 -0
- package/docs/examples/github-action-workflow.yml +2 -2
- package/docs/examples/github-code-scanning-workflow.yml +4 -4
- package/docs/examples/github-inventory-workflow.yml +2 -2
- package/docs/examples/github-url-report.json +4 -4
- package/docs/examples/github-url-report.md +1 -1
- package/docs/examples/maintainer-trial-workflow.yml +24 -0
- package/docs/examples/self-audit.sarif +2 -2
- package/docs/index.md +8 -4
- package/docs/maintainer-feedback.md +54 -0
- package/docs/maintainer-playbook.md +5 -5
- package/docs/maintainer-trial.md +111 -0
- package/docs/marketplace.md +6 -5
- package/docs/outreach/README.md +2 -2
- package/docs/outreach/divyesh-5981-signal-oss-issue-draft.md +9 -1
- package/docs/outreach/divyesh-5981-signal-oss-report.md +1 -2
- package/docs/outreach/noctemlabs-signal-oss-issue-draft.md +2 -0
- package/docs/outreach/peer-shortlist-2026-06.md +5 -4
- package/docs/post-submission-update.md +17 -11
- package/docs/release-notes/v0.8.0.md +18 -0
- package/docs/release-notes/v0.8.1.md +19 -0
- package/docs/reviewer-evidence.md +19 -9
- package/docs/roadmap.md +3 -1
- package/docs/sarif-code-scanning.md +2 -2
- package/docs/security-model.md +1 -1
- package/docs/self-audit.md +1 -1
- package/docs/social-launch.md +151 -0
- package/docs/trust-center.md +13 -6
- package/package.json +2 -2
- package/src/action.js +7 -3
- package/src/cli.js +8 -3
- package/src/index.js +29 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
## Unreleased
|
|
4
4
|
|
|
5
|
+
## 0.8.1
|
|
6
|
+
|
|
7
|
+
- Moved the GitHub Action runtime to `node24` so new workflow runs avoid the GitHub-hosted runner Node.js 20 deprecation warning.
|
|
8
|
+
- Updated SARIF upload documentation examples to `github/codeql-action/upload-sarif@v4`.
|
|
9
|
+
|
|
10
|
+
## 0.8.0
|
|
11
|
+
|
|
12
|
+
- Added `--format workflow` for generating a no-fail GitHub Actions trial workflow.
|
|
13
|
+
- Added maintainer feedback intake so neutral or negative third-party responses can improve the rules without being overstated as adoption.
|
|
14
|
+
|
|
5
15
|
## 0.7.0
|
|
6
16
|
|
|
7
17
|
- Added `--format plan` for generating PR-sized maintainer plans with suggested files and acceptance criteria.
|
package/README.md
CHANGED
|
@@ -15,40 +15,44 @@
|
|
|
15
15
|
[](docs/reviewer-evidence.md)
|
|
16
16
|
[](LICENSE)
|
|
17
17
|
|
|
18
|
-
`oss-signal` is a dependency-light maintainer-readiness CLI and GitHub Action for OSS projects that need repeatable triage, CI evidence, SARIF, inventory reports,
|
|
18
|
+
`oss-signal` is a dependency-light maintainer-readiness CLI and GitHub Action for OSS projects that need repeatable triage, CI evidence, SARIF, inventory reports, issue-ready cleanup notes, and no-fail workflow trials.
|
|
19
19
|
|
|
20
|
-
It checks the files and automation that reduce maintainer load: README, license, contributing guide, security policy, CI, tests, issue templates, pull request templates, Dependabot, and release notes. The output is a score plus concrete next steps in Markdown, JSON, SARIF, inventory, GitHub Issue-ready Markdown,
|
|
20
|
+
It checks the files and automation that reduce maintainer load: README, license, contributing guide, security policy, CI, tests, issue templates, pull request templates, Dependabot, and release notes. The output is a score plus concrete next steps in Markdown, JSON, SARIF, inventory, GitHub Issue-ready Markdown, PR-sized maintainer plan, or no-fail workflow formats.
|
|
21
21
|
|
|
22
22
|

|
|
23
23
|
|
|
24
24
|
## Maintainer Evidence Snapshot
|
|
25
25
|
|
|
26
|
-
Public evidence for the maintainer workflow is collected in [docs/index.md](docs/index.md), [docs/trust-center.md](docs/trust-center.md), [docs/reviewer-evidence.md](docs/reviewer-evidence.md), [docs/adoption-evidence.md](docs/adoption-evidence.md), [docs/adoption-kit.md](docs/adoption-kit.md), [docs/architecture.md](docs/architecture.md), [docs/security-model.md](docs/security-model.md), [docs/json-output.md](docs/json-output.md), [docs/plan-output.md](docs/plan-output.md), [docs/sarif-code-scanning.md](docs/sarif-code-scanning.md), [docs/roadmap.md](docs/roadmap.md), [docs/post-submission-update.md](docs/post-submission-update.md), and [docs/brand.md](docs/brand.md).
|
|
26
|
+
Public evidence for the maintainer workflow is collected in [docs/index.md](docs/index.md), [docs/evidence-ledger.md](docs/evidence-ledger.md), [docs/trust-center.md](docs/trust-center.md), [docs/reviewer-evidence.md](docs/reviewer-evidence.md), [docs/adoption-evidence.md](docs/adoption-evidence.md), [docs/adoption-kit.md](docs/adoption-kit.md), [docs/maintainer-trial.md](docs/maintainer-trial.md), [docs/maintainer-feedback.md](docs/maintainer-feedback.md), [docs/social-launch.md](docs/social-launch.md), [docs/architecture.md](docs/architecture.md), [docs/security-model.md](docs/security-model.md), [docs/json-output.md](docs/json-output.md), [docs/plan-output.md](docs/plan-output.md), [docs/sarif-code-scanning.md](docs/sarif-code-scanning.md), [docs/roadmap.md](docs/roadmap.md), [docs/post-submission-update.md](docs/post-submission-update.md), and [docs/brand.md](docs/brand.md).
|
|
27
27
|
|
|
28
28
|
- Landing page: https://salmonplays.github.io/oss-signal/
|
|
29
|
-
- Published package: [`oss-signal@0.
|
|
30
|
-
- Published GitHub Action: [`SalmonPlays/oss-signal@v0.
|
|
29
|
+
- Published package: [`oss-signal@0.8.1`](https://www.npmjs.com/package/oss-signal), with `latest` pointing at `0.8.1`.
|
|
30
|
+
- Published GitHub Action: [`SalmonPlays/oss-signal@v0.8.1`](https://github.com/SalmonPlays/oss-signal/tree/v0.8.1).
|
|
31
31
|
- GitHub Marketplace listing: https://github.com/marketplace/actions/oss-signal
|
|
32
32
|
- Trust center: [docs/trust-center.md](docs/trust-center.md)
|
|
33
|
+
- Evidence ledger: [docs/evidence-ledger.md](docs/evidence-ledger.md)
|
|
33
34
|
- Adoption kit: [docs/adoption-kit.md](docs/adoption-kit.md)
|
|
35
|
+
- Maintainer trial: [docs/maintainer-trial.md](docs/maintainer-trial.md)
|
|
36
|
+
- Maintainer feedback: [docs/maintainer-feedback.md](docs/maintainer-feedback.md)
|
|
37
|
+
- Social launch kit: [docs/social-launch.md](docs/social-launch.md)
|
|
34
38
|
- Architecture: [docs/architecture.md](docs/architecture.md)
|
|
35
39
|
- Security model: [docs/security-model.md](docs/security-model.md)
|
|
36
40
|
- JSON output contract: [docs/json-output.md](docs/json-output.md)
|
|
37
41
|
- Maintainer plan output: [docs/plan-output.md](docs/plan-output.md)
|
|
38
42
|
- SARIF Code Scanning walkthrough: [docs/sarif-code-scanning.md](docs/sarif-code-scanning.md)
|
|
39
43
|
- Roadmap: [docs/roadmap.md](docs/roadmap.md)
|
|
40
|
-
- Post-submission version note: the application may reference earlier evidence; `0.
|
|
44
|
+
- Post-submission version note: the application may reference earlier evidence; `0.8.1` is the current maintained release and is documented in [docs/post-submission-update.md](docs/post-submission-update.md).
|
|
41
45
|
- Public checks: CI, Repository health, and CodeQL are passing on `main`.
|
|
42
46
|
- Security posture: OpenSSF Scorecard is scheduled, CodeQL is active, secret scanning push protection is enabled, Dependabot alerts/security updates/malware alerts are enabled, and private vulnerability reporting is enabled.
|
|
43
47
|
- Branch posture: `main` has branch protection to prevent force pushes and deletions while keeping direct maintainer maintenance possible.
|
|
44
48
|
- Governance posture: [MAINTAINERS.md](MAINTAINERS.md), [GOVERNANCE.md](GOVERNANCE.md), and [.github/CODEOWNERS](.github/CODEOWNERS) define ownership, review routing, and supported change scope.
|
|
45
49
|
- Community route: [Discussion #5](https://github.com/SalmonPlays/oss-signal/discussions/5) is the public maintainer-workflow thread for usage questions and rule feedback.
|
|
46
50
|
- Self-audit: this repository scores **100/100 (A)** locally and through GitHub URL mode.
|
|
47
|
-
- Field use:
|
|
48
|
-
-
|
|
51
|
+
- Field use: seven public maintainer-readiness audits have been turned into six issues and five focused follow-up PRs.
|
|
52
|
+
- Merged external OSS contribution: [icoretech/codex-action PR #24](https://github.com/icoretech/codex-action/pull/24) is a focused Codex Action documentation safety fix.
|
|
49
53
|
- Contributor intake: [good first issues](https://github.com/SalmonPlays/oss-signal/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22good%20first%20issue%22) are labeled for small outside PRs.
|
|
50
54
|
- Inventory mode: the CLI and Action can audit a newline-delimited list of repositories for organization-level triage.
|
|
51
|
-
- Separate workflow demo: [oss-signal-adoption-demo](https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/
|
|
55
|
+
- Separate workflow demo: [oss-signal-adoption-demo](https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26993130878) runs the public `v0.7.0` Action tag and uploads Markdown, SARIF, and Issue-ready artifacts.
|
|
52
56
|
|
|
53
57
|
## Why
|
|
54
58
|
|
|
@@ -152,6 +156,14 @@ oss-signal Grovanni/oss-signal --format plan --output maintainer-plan.md
|
|
|
152
156
|
|
|
153
157
|
See [docs/plan-output.md](docs/plan-output.md) and [docs/examples/github-plan.md](docs/examples/github-plan.md) for an example.
|
|
154
158
|
|
|
159
|
+
Generate a no-fail GitHub Actions trial workflow:
|
|
160
|
+
|
|
161
|
+
```bash
|
|
162
|
+
oss-signal owner/repo --format workflow --output .github/workflows/oss-signal-trial.yml
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
See [docs/maintainer-trial.md](docs/maintainer-trial.md) and [docs/examples/maintainer-trial-workflow.yml](docs/examples/maintainer-trial-workflow.yml) for the generated workflow.
|
|
166
|
+
|
|
155
167
|
## Checks
|
|
156
168
|
|
|
157
169
|
`oss-signal` currently checks:
|
|
@@ -179,9 +191,9 @@ Summary:
|
|
|
179
191
|
- Total checks: 15
|
|
180
192
|
```
|
|
181
193
|
|
|
182
|
-
See [docs/self-audit.md](docs/self-audit.md) for the full local self-audit report, [docs/examples/github-url-report.md](docs/examples/github-url-report.md) for the GitHub URL audit output, [docs/examples/github-issue-body.md](docs/examples/github-issue-body.md) for issue output, [docs/examples/github-plan.md](docs/examples/github-plan.md) for plan output, and [docs/examples/self-audit.sarif](docs/examples/self-audit.sarif) for SARIF output.
|
|
194
|
+
See [docs/self-audit.md](docs/self-audit.md) for the full local self-audit report, [docs/examples/github-url-report.md](docs/examples/github-url-report.md) for the GitHub URL audit output, [docs/examples/github-issue-body.md](docs/examples/github-issue-body.md) for issue output, [docs/examples/github-plan.md](docs/examples/github-plan.md) for plan output, [docs/examples/maintainer-trial-workflow.yml](docs/examples/maintainer-trial-workflow.yml) for workflow output, and [docs/examples/self-audit.sarif](docs/examples/self-audit.sarif) for SARIF output.
|
|
183
195
|
|
|
184
|
-
The [Repository health workflow](.github/workflows/repository-health.yml) runs `SalmonPlays/oss-signal@v0.
|
|
196
|
+
The [Repository health workflow](.github/workflows/repository-health.yml) runs `SalmonPlays/oss-signal@v0.8.1`, uploads the Markdown report as an artifact, and uploads SARIF to GitHub Code Scanning on non-PR runs. The [Repository inventory workflow](.github/workflows/repository-inventory.yml) runs the inventory mode from CI and uploads a multi-repository report artifact.
|
|
185
197
|
|
|
186
198
|
## Field Audits
|
|
187
199
|
|
|
@@ -192,16 +204,18 @@ The [Repository health workflow](.github/workflows/repository-health.yml) runs `
|
|
|
192
204
|
- [sammorrisdesign/interactive-feed report](docs/outreach/sammorrisdesign-interactive-feed-report.md), [issue #14](https://github.com/sammorrisdesign/interactive-feed/issues/14), and [PR #15](https://github.com/sammorrisdesign/interactive-feed/pull/15)
|
|
193
205
|
- [flox/install-flox-action report](docs/outreach/flox-install-flox-action-report.md), [issue #204](https://github.com/flox/install-flox-action/issues/204), and [PR #205](https://github.com/flox/install-flox-action/pull/205)
|
|
194
206
|
- [Grovanni/oss-signal report](docs/outreach/grovanni-oss-signal-report.md) and [issue #1](https://github.com/Grovanni/oss-signal/issues/1)
|
|
207
|
+
- [noctemlabs/signal-oss report](docs/outreach/noctemlabs-signal-oss-report.md) and [PR #12](https://github.com/noctemlabs/signal-oss/pull/12)
|
|
208
|
+
- [Divyesh-5981/signal-oss report](docs/outreach/divyesh-5981-signal-oss-report.md) and [issue #5](https://github.com/Divyesh-5981/signal-oss/issues/5)
|
|
195
209
|
|
|
196
210
|
See [docs/outreach](docs/outreach) for the reports and draft issue text. Drafts are not posted automatically; maintainers should only receive specific, useful, and respectful suggestions.
|
|
197
211
|
|
|
198
212
|
Additional prepared outreach candidates are tracked in [docs/outreach/peer-shortlist-2026-06.md](docs/outreach/peer-shortlist-2026-06.md). The shortlist explicitly separates respectful, defensible candidates from low-signal mass outreach.
|
|
199
213
|
|
|
200
|
-
Additional focused external contribution: [icoretech/codex-action PR #24](https://github.com/icoretech/codex-action/pull/24) updates Codex Action README examples to route generated output through environment variables before printing it from shell steps.
|
|
214
|
+
Additional focused external contribution: [icoretech/codex-action PR #24](https://github.com/icoretech/codex-action/pull/24) was merged and updates Codex Action README examples to route generated output through environment variables before printing it from shell steps.
|
|
201
215
|
|
|
202
216
|
For a compact maintainer/adoption summary, see [docs/adoption-evidence.md](docs/adoption-evidence.md). For a reviewer-oriented verification path, see [docs/reviewer-evidence.md](docs/reviewer-evidence.md).
|
|
203
217
|
|
|
204
|
-
Separate public workflow evidence: [SalmonPlays/oss-signal-adoption-demo](https://github.com/SalmonPlays/oss-signal-adoption-demo) runs `SalmonPlays/oss-signal@v0.
|
|
218
|
+
Separate public workflow evidence: [SalmonPlays/oss-signal-adoption-demo](https://github.com/SalmonPlays/oss-signal-adoption-demo) runs `SalmonPlays/oss-signal@v0.7.0` and produced a successful [workflow run](https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26993130878) with Markdown, SARIF, and Issue-ready report artifacts.
|
|
205
219
|
|
|
206
220
|
## Example Recommendation Output
|
|
207
221
|
|
|
@@ -230,7 +244,7 @@ oss-signal . --fail-under 80
|
|
|
230
244
|
Add `oss-signal` directly to a GitHub Actions workflow:
|
|
231
245
|
|
|
232
246
|
```yaml
|
|
233
|
-
- uses: SalmonPlays/oss-signal@v0.
|
|
247
|
+
- uses: SalmonPlays/oss-signal@v0.8.1
|
|
234
248
|
id: oss-signal
|
|
235
249
|
with:
|
|
236
250
|
fail-under: "80"
|
|
@@ -246,7 +260,7 @@ The Action writes a concise GitHub Actions step summary by default, so reviewers
|
|
|
246
260
|
Run an inventory from CI:
|
|
247
261
|
|
|
248
262
|
```yaml
|
|
249
|
-
- uses: SalmonPlays/oss-signal@v0.
|
|
263
|
+
- uses: SalmonPlays/oss-signal@v0.8.1
|
|
250
264
|
env:
|
|
251
265
|
GITHUB_TOKEN: ${{ github.token }}
|
|
252
266
|
with:
|
|
@@ -258,7 +272,7 @@ Run an inventory from CI:
|
|
|
258
272
|
Generate an editable Issue body from CI:
|
|
259
273
|
|
|
260
274
|
```yaml
|
|
261
|
-
- uses: SalmonPlays/oss-signal@v0.
|
|
275
|
+
- uses: SalmonPlays/oss-signal@v0.8.1
|
|
262
276
|
with:
|
|
263
277
|
format: issue
|
|
264
278
|
output: maintainer-follow-up.md
|
|
@@ -279,8 +293,8 @@ jobs:
|
|
|
279
293
|
oss-signal:
|
|
280
294
|
runs-on: ubuntu-latest
|
|
281
295
|
steps:
|
|
282
|
-
- uses: actions/checkout@
|
|
283
|
-
- uses: SalmonPlays/oss-signal@v0.
|
|
296
|
+
- uses: actions/checkout@v5
|
|
297
|
+
- uses: SalmonPlays/oss-signal@v0.8.1
|
|
284
298
|
id: oss-signal
|
|
285
299
|
with:
|
|
286
300
|
fail-under: "80"
|
|
@@ -302,18 +316,18 @@ permissions:
|
|
|
302
316
|
security-events: write
|
|
303
317
|
|
|
304
318
|
steps:
|
|
305
|
-
- uses: actions/checkout@
|
|
306
|
-
- uses: SalmonPlays/oss-signal@v0.
|
|
319
|
+
- uses: actions/checkout@v5
|
|
320
|
+
- uses: SalmonPlays/oss-signal@v0.8.1
|
|
307
321
|
with:
|
|
308
322
|
format: sarif
|
|
309
323
|
output: oss-signal.sarif
|
|
310
324
|
summary: "true"
|
|
311
|
-
- uses: github/codeql-action/upload-sarif@
|
|
325
|
+
- uses: github/codeql-action/upload-sarif@v4
|
|
312
326
|
with:
|
|
313
327
|
sarif_file: oss-signal.sarif
|
|
314
328
|
```
|
|
315
329
|
|
|
316
|
-
This repository dogfoods the public Action tag in [Repository health](.github/workflows/repository-health.yml), which runs `SalmonPlays/oss-signal@v0.
|
|
330
|
+
This repository dogfoods the public Action tag in [Repository health](.github/workflows/repository-health.yml), which runs `SalmonPlays/oss-signal@v0.8.1` against the repository, uploads the Markdown report artifact, and publishes SARIF to Code Scanning on non-PR runs.
|
|
317
331
|
|
|
318
332
|
You can also run the CLI directly in CI:
|
|
319
333
|
|
package/action.yml
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
name: oss-signal
|
|
2
|
-
description: Audit OSS maintainer readiness and produce CI evidence, SARIF, inventory reports,
|
|
2
|
+
description: Audit OSS maintainer readiness and produce CI evidence, SARIF, inventory reports, issue-ready cleanup notes, and workflow trials.
|
|
3
3
|
author: SalmonPlays
|
|
4
4
|
branding:
|
|
5
5
|
icon: shield
|
|
@@ -13,7 +13,7 @@ inputs:
|
|
|
13
13
|
description: Newline-delimited file of local paths, GitHub URLs, or owner/repo shorthands to audit as an inventory.
|
|
14
14
|
required: false
|
|
15
15
|
format:
|
|
16
|
-
description: Output format, either markdown, json, sarif, issue, or
|
|
16
|
+
description: Output format, either markdown, json, sarif, issue, plan, or workflow. Inventory mode supports markdown or json.
|
|
17
17
|
required: false
|
|
18
18
|
default: markdown
|
|
19
19
|
output:
|
|
@@ -44,5 +44,5 @@ outputs:
|
|
|
44
44
|
report-path:
|
|
45
45
|
description: Path to the generated report file, when output is enabled.
|
|
46
46
|
runs:
|
|
47
|
-
using:
|
|
47
|
+
using: node24
|
|
48
48
|
main: src/action.js
|
|
@@ -2,15 +2,15 @@
|
|
|
2
2
|
|
|
3
3
|
This page collects the public evidence that `oss-signal` is built for real open-source maintainer workflows.
|
|
4
4
|
|
|
5
|
-
Last verified: 2026-06-
|
|
5
|
+
Last verified: 2026-06-05T09:57:04Z
|
|
6
6
|
|
|
7
7
|
## Project Links
|
|
8
8
|
|
|
9
9
|
- Repository: https://github.com/SalmonPlays/oss-signal
|
|
10
10
|
- GitHub Pages landing page: https://salmonplays.github.io/oss-signal/
|
|
11
|
-
- npm package: https://www.npmjs.com/package/oss-signal (`0.
|
|
12
|
-
- GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.
|
|
13
|
-
- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.
|
|
11
|
+
- npm package: https://www.npmjs.com/package/oss-signal (`0.8.1` latest)
|
|
12
|
+
- GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.8.1
|
|
13
|
+
- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.1
|
|
14
14
|
- GitHub Marketplace listing: https://github.com/marketplace/actions/oss-signal
|
|
15
15
|
- GitHub Action metadata: [action.yml](../action.yml)
|
|
16
16
|
- Public dogfood workflow: [.github/workflows/repository-health.yml](../.github/workflows/repository-health.yml)
|
|
@@ -20,8 +20,10 @@ Last verified: 2026-06-04T11:14:41Z
|
|
|
20
20
|
- Governance: [GOVERNANCE.md](../GOVERNANCE.md)
|
|
21
21
|
- CODEOWNERS: [.github/CODEOWNERS](../.github/CODEOWNERS)
|
|
22
22
|
- Maintainer workflow Discussion: https://github.com/SalmonPlays/oss-signal/discussions/5
|
|
23
|
+
- Launch announcement Discussion: https://github.com/SalmonPlays/oss-signal/discussions/13
|
|
24
|
+
- Launch X post: https://x.com/paopaopaolin/status/2062710560857489698
|
|
23
25
|
- Separate public workflow demo: https://github.com/SalmonPlays/oss-signal-adoption-demo
|
|
24
|
-
- Separate public workflow run: https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/
|
|
26
|
+
- Separate public workflow run: https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26993130878
|
|
25
27
|
- Self-audit report: [docs/self-audit.md](self-audit.md)
|
|
26
28
|
- SARIF self-audit output: [docs/examples/self-audit.sarif](examples/self-audit.sarif)
|
|
27
29
|
- GitHub URL audit report: [docs/examples/github-url-report.md](examples/github-url-report.md)
|
|
@@ -31,6 +33,8 @@ Last verified: 2026-06-04T11:14:41Z
|
|
|
31
33
|
- Brand assets and GitHub settings copy: [docs/brand.md](brand.md)
|
|
32
34
|
- GitHub Pages landing page source: [docs/index.md](index.md)
|
|
33
35
|
- GitHub Marketplace publishing checklist: [docs/marketplace.md](marketplace.md)
|
|
36
|
+
- Maintainer trial: [docs/maintainer-trial.md](maintainer-trial.md)
|
|
37
|
+
- Maintainer feedback: [docs/maintainer-feedback.md](maintainer-feedback.md)
|
|
34
38
|
- Maintainer playbook: [docs/maintainer-playbook.md](maintainer-playbook.md)
|
|
35
39
|
- Trust center: [docs/trust-center.md](trust-center.md)
|
|
36
40
|
- Adoption kit: [docs/adoption-kit.md](adoption-kit.md)
|
|
@@ -40,6 +44,7 @@ Last verified: 2026-06-04T11:14:41Z
|
|
|
40
44
|
- SARIF Code Scanning walkthrough: [docs/sarif-code-scanning.md](sarif-code-scanning.md)
|
|
41
45
|
- Roadmap: [docs/roadmap.md](roadmap.md)
|
|
42
46
|
- Reviewer evidence quickstart: [docs/reviewer-evidence.md](reviewer-evidence.md)
|
|
47
|
+
- Evidence ledger: [docs/evidence-ledger.md](evidence-ledger.md)
|
|
43
48
|
- Post-submission update: [docs/post-submission-update.md](post-submission-update.md)
|
|
44
49
|
- Release process: [docs/release-process.md](release-process.md)
|
|
45
50
|
- Codex for Open Source application brief: [docs/codex-for-oss-application.md](codex-for-oss-application.md)
|
|
@@ -64,15 +69,15 @@ The [post-submission update](post-submission-update.md) records why the current
|
|
|
64
69
|
|
|
65
70
|
## Published Package Verification
|
|
66
71
|
|
|
67
|
-
The npm package is publicly available as `oss-signal@0.
|
|
72
|
+
The npm package is publicly available as `oss-signal@0.8.1` with `latest` pointing at `0.8.1`.
|
|
68
73
|
|
|
69
|
-
The npm downloads API returned 356 downloads for both last-week and last-month windows on 2026-06-
|
|
74
|
+
The npm downloads API returned 356 downloads for both last-week and last-month windows on 2026-06-05. Download counts can lag publication, so this is treated as supporting evidence rather than proof of broad adoption.
|
|
70
75
|
|
|
71
76
|
Clean-directory execution against the public GitHub repository returned:
|
|
72
77
|
|
|
73
78
|
```json
|
|
74
79
|
{
|
|
75
|
-
"version": "0.
|
|
80
|
+
"version": "0.8.1",
|
|
76
81
|
"score": 100,
|
|
77
82
|
"grade": "A",
|
|
78
83
|
"source": "github"
|
|
@@ -88,8 +93,8 @@ Current public workflow status:
|
|
|
88
93
|
- OpenSSF Scorecard: configured on `main` pushes and a weekly schedule, with JSON artifact output and public Scorecard publishing
|
|
89
94
|
- Release: passing
|
|
90
95
|
- GitHub Pages deployment: passing, with the repository homepage set to https://salmonplays.github.io/oss-signal/
|
|
91
|
-
- GitHub Marketplace listing: published
|
|
92
|
-
- GitHub issue forms: adoption report and maintainer audit report forms are available for structured public evidence intake
|
|
96
|
+
- GitHub Marketplace listing: published, with `v0.8.1` available as the current Action tag
|
|
97
|
+
- GitHub issue forms: adoption report, trial feedback, and maintainer audit report forms are available for structured public evidence intake
|
|
93
98
|
- GitHub citation metadata: `CITATION.cff` is present for the repository citation UI
|
|
94
99
|
- Automation contract: JSON schema and fixture are documented for `--format json`
|
|
95
100
|
- Code Scanning walkthrough: SARIF upload permissions, expected warnings, fixture, and output example are documented
|
|
@@ -97,17 +102,17 @@ Current public workflow status:
|
|
|
97
102
|
- Maintainer workflow Discussion: published
|
|
98
103
|
- Separate public workflow demo: passing
|
|
99
104
|
|
|
100
|
-
|
|
105
|
+
The npm registry returned `0.8.1` for both the package version and `latest` dist-tag on 2026-06-05T09:57:04Z. A clean install smoke test returned version `0.8.1`, score `100`, grade `A`, and source `github`. The 2026-06-05 download check returned 356 downloads for the last-week and last-month windows.
|
|
101
106
|
|
|
102
107
|
## Separate Public Workflow Evidence
|
|
103
108
|
|
|
104
|
-
The public repository https://github.com/SalmonPlays/oss-signal-adoption-demo runs `SalmonPlays/oss-signal@v0.
|
|
109
|
+
The public repository https://github.com/SalmonPlays/oss-signal-adoption-demo runs `SalmonPlays/oss-signal@v0.7.0` from a separate workflow file:
|
|
105
110
|
|
|
106
111
|
- Workflow file: https://github.com/SalmonPlays/oss-signal-adoption-demo/blob/main/.github/workflows/oss-signal.yml
|
|
107
|
-
- Successful workflow run: https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/
|
|
112
|
+
- Successful workflow run: https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26993130878
|
|
108
113
|
- Artifact: `oss-signal-adoption-demo-report`, containing `oss-signal-report.md`, `oss-signal.sarif`, and `maintainer-follow-up.md`
|
|
109
114
|
|
|
110
|
-
This is not claimed as independent third-party adoption because the repository is owned by `SalmonPlays`. It is evidence that
|
|
115
|
+
This is not claimed as independent third-party adoption because the repository is owned by `SalmonPlays`. It is evidence that a public Action tag works outside the main repository and can publish Markdown, SARIF, and Issue-ready maintainer-readiness reports from another public workflow. The demo workflow is refreshed after each release when the new tag is available.
|
|
111
116
|
|
|
112
117
|
## Public Field Audits And PRs
|
|
113
118
|
|
|
@@ -115,13 +120,15 @@ The tool has been used to generate maintainer-readiness reports for public repos
|
|
|
115
120
|
|
|
116
121
|
| Repository | Report | Posted issue | Follow-up PR | Status |
|
|
117
122
|
| --- | --- | --- | --- | --- |
|
|
118
|
-
| `platformatic/massimo` | [report](outreach/platformatic-massimo-report.md) | https://github.com/platformatic/massimo/issues/159 | https://github.com/platformatic/massimo/pull/160 | open,
|
|
119
|
-
| `supermarkt/checkjebon` | [report](outreach/supermarkt-checkjebon-report.md) | https://github.com/supermarkt/checkjebon/issues/22 | https://github.com/supermarkt/checkjebon/pull/23 | open,
|
|
120
|
-
| `sammorrisdesign/interactive-feed` | [report](outreach/sammorrisdesign-interactive-feed-report.md) | https://github.com/sammorrisdesign/interactive-feed/issues/14 | https://github.com/sammorrisdesign/interactive-feed/pull/15 | open |
|
|
121
|
-
| `flox/install-flox-action` | [report](outreach/flox-install-flox-action-report.md) | https://github.com/flox/install-flox-action/issues/204 | https://github.com/flox/install-flox-action/pull/205 | open,
|
|
123
|
+
| `platformatic/massimo` | [report](outreach/platformatic-massimo-report.md) | https://github.com/platformatic/massimo/issues/159 | https://github.com/platformatic/massimo/pull/160 | open, mergeable |
|
|
124
|
+
| `supermarkt/checkjebon` | [report](outreach/supermarkt-checkjebon-report.md) | https://github.com/supermarkt/checkjebon/issues/22 | https://github.com/supermarkt/checkjebon/pull/23 | open, mergeable |
|
|
125
|
+
| `sammorrisdesign/interactive-feed` | [report](outreach/sammorrisdesign-interactive-feed-report.md) | https://github.com/sammorrisdesign/interactive-feed/issues/14 | https://github.com/sammorrisdesign/interactive-feed/pull/15 | open, mergeable |
|
|
126
|
+
| `flox/install-flox-action` | [report](outreach/flox-install-flox-action-report.md) | https://github.com/flox/install-flox-action/issues/204 | https://github.com/flox/install-flox-action/pull/205 | open, mergeable |
|
|
122
127
|
| `Grovanni/oss-signal` | [report](outreach/grovanni-oss-signal-report.md) | https://github.com/Grovanni/oss-signal/issues/1 | N/A | open |
|
|
128
|
+
| `noctemlabs/signal-oss` | [report](outreach/noctemlabs-signal-oss-report.md) | N/A | https://github.com/noctemlabs/signal-oss/pull/12 | open, mergeable |
|
|
129
|
+
| `Divyesh-5981/signal-oss` | [report](outreach/divyesh-5981-signal-oss-report.md) | https://github.com/Divyesh-5981/signal-oss/issues/5 | N/A | open |
|
|
123
130
|
|
|
124
|
-
These issues and pull requests are evidence of the intended maintainer workflow: run a deterministic audit, explain the missing signals, and give maintainers a small set of actionable improvements. Each PR is intentionally limited to documentation or
|
|
131
|
+
These issues and pull requests are evidence of the intended maintainer workflow: run a deterministic audit, explain the missing signals, and give maintainers a small set of actionable improvements. Each PR is intentionally limited to documentation, GitHub templates, or a minimal CI workflow.
|
|
125
132
|
|
|
126
133
|
Prepared but not yet posted outreach candidates are tracked separately in [outreach/peer-shortlist-2026-06.md](outreach/peer-shortlist-2026-06.md) and [outreach](outreach). This prevents candidate research from being overstated as real external maintainer engagement.
|
|
127
134
|
|
|
@@ -129,9 +136,9 @@ The workflow now includes [plan-output.md](plan-output.md), which converts audit
|
|
|
129
136
|
|
|
130
137
|
Additional focused external contribution:
|
|
131
138
|
|
|
132
|
-
- `icoretech/codex-action`: https://github.com/icoretech/codex-action/pull/24 updates Codex Action README examples so generated output is routed through environment variables before shell printing.
|
|
139
|
+
- `icoretech/codex-action`: https://github.com/icoretech/codex-action/pull/24 was merged on 2026-06-04 and updates Codex Action README examples so generated output is routed through environment variables before shell printing. The maintainer merge comment is public at https://github.com/icoretech/codex-action/pull/24#issuecomment-4623923361.
|
|
133
140
|
|
|
134
|
-
|
|
141
|
+
The five field-audit follow-up PRs were still open when checked from GitHub on 2026-06-05T09:57:04Z. The Divyesh issue was posted on 2026-06-05T04:18:46Z and is not claimed as adoption unless the maintainer replies or acts. Open PRs are not claimed as accepted adoption unless a maintainer merges, replies, or otherwise endorses them.
|
|
135
142
|
|
|
136
143
|
## Contributor Intake
|
|
137
144
|
|
|
@@ -140,7 +147,7 @@ The project now has labeled good-first-issue routes for outside contributors:
|
|
|
140
147
|
- https://github.com/SalmonPlays/oss-signal/issues/6
|
|
141
148
|
- https://github.com/SalmonPlays/oss-signal/issues/7
|
|
142
149
|
|
|
143
|
-
The repository also includes a GitHub Discussions category form for structured rule feedback, Action usage questions, and maintainer workflow adoption notes. The issue templates include adoption and maintainer-audit forms so users can share workflow-run evidence or
|
|
150
|
+
The repository also includes a GitHub Discussions category form for structured rule feedback, Action usage questions, and maintainer workflow adoption notes. The issue templates include adoption, trial-feedback, and maintainer-audit forms so users can share workflow-run evidence, neutral maintainer feedback, or report discussion without inventing the format.
|
|
144
151
|
|
|
145
152
|
Current public roadmap evidence:
|
|
146
153
|
|
|
@@ -158,10 +165,10 @@ npm run audit:github
|
|
|
158
165
|
node src/cli.js . --format sarif --output docs/examples/self-audit.sarif
|
|
159
166
|
node src/cli.js --inventory docs/examples/inventory-targets.txt --format markdown --output docs/examples/inventory-report.md
|
|
160
167
|
node src/cli.js platformatic/massimo --format json
|
|
161
|
-
npm exec --yes --package=oss-signal@0.
|
|
168
|
+
npm exec --yes --package=oss-signal@0.8.1 -- oss-signal SalmonPlays/oss-signal --format json
|
|
162
169
|
```
|
|
163
170
|
|
|
164
|
-
The current repository self-audit score is 100/100, the GitHub community profile health score is 100, and CI verifies the local GitHub Action wrapper. The public `v0.
|
|
171
|
+
The current repository self-audit score is 100/100, the GitHub community profile health score is 100, and CI verifies the local GitHub Action wrapper. The public `v0.8.1` Action tag is used by the repository health workflow for Markdown and SARIF output. The published npm `0.8.1` package has also been executed from a clean temporary directory against the public GitHub repository, returning 100/100 (A).
|
|
165
172
|
|
|
166
173
|
Public CI evidence:
|
|
167
174
|
|
|
@@ -170,7 +177,7 @@ Public CI evidence:
|
|
|
170
177
|
- CodeQL workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/codeql.yml
|
|
171
178
|
- OpenSSF Scorecard workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/scorecard.yml
|
|
172
179
|
- Maintainer workflow Discussion: https://github.com/SalmonPlays/oss-signal/discussions/5
|
|
173
|
-
- Separate workflow demo run: https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/
|
|
180
|
+
- Separate workflow demo run: https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26993130878
|
|
174
181
|
- Reviewer verification quickstart: [reviewer-evidence.md](reviewer-evidence.md)
|
|
175
182
|
|
|
176
183
|
## Boundaries
|
package/docs/adoption-kit.md
CHANGED
|
@@ -2,12 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
This page gives maintainers a copy-paste path for trying `oss-signal` and leaving useful public evidence.
|
|
4
4
|
|
|
5
|
+
For a first trial, use the no-fail workflow in [maintainer-trial.md](maintainer-trial.md). It publishes a report without gating CI.
|
|
6
|
+
|
|
5
7
|
## Try The CLI
|
|
6
8
|
|
|
7
9
|
Run against a public repository without cloning:
|
|
8
10
|
|
|
9
11
|
```bash
|
|
10
|
-
npm exec --yes --package=oss-signal@0.
|
|
12
|
+
npm exec --yes --package=oss-signal@0.8.1 -- oss-signal owner/repo --format markdown --output oss-signal-report.md
|
|
11
13
|
```
|
|
12
14
|
|
|
13
15
|
Run against the current checkout:
|
|
@@ -22,8 +24,16 @@ Generate a human-reviewed issue body:
|
|
|
22
24
|
npx oss-signal owner/repo --format issue --output maintainer-follow-up.md
|
|
23
25
|
```
|
|
24
26
|
|
|
27
|
+
Generate a no-fail trial workflow:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
npx oss-signal owner/repo --format workflow --output .github/workflows/oss-signal-trial.yml
|
|
31
|
+
```
|
|
32
|
+
|
|
25
33
|
## Add The GitHub Action
|
|
26
34
|
|
|
35
|
+
This example gates CI with `fail-under`. For a first trial in another maintainer's repository, start with [examples/maintainer-trial-workflow.yml](examples/maintainer-trial-workflow.yml) instead.
|
|
36
|
+
|
|
27
37
|
```yaml
|
|
28
38
|
name: Repository health
|
|
29
39
|
|
|
@@ -40,7 +50,7 @@ jobs:
|
|
|
40
50
|
runs-on: ubuntu-latest
|
|
41
51
|
steps:
|
|
42
52
|
- uses: actions/checkout@v4
|
|
43
|
-
- uses: SalmonPlays/oss-signal@v0.
|
|
53
|
+
- uses: SalmonPlays/oss-signal@v0.8.1
|
|
44
54
|
id: oss-signal
|
|
45
55
|
with:
|
|
46
56
|
fail-under: "80"
|
|
@@ -61,12 +71,12 @@ permissions:
|
|
|
61
71
|
|
|
62
72
|
steps:
|
|
63
73
|
- uses: actions/checkout@v4
|
|
64
|
-
- uses: SalmonPlays/oss-signal@v0.
|
|
74
|
+
- uses: SalmonPlays/oss-signal@v0.8.1
|
|
65
75
|
with:
|
|
66
76
|
format: sarif
|
|
67
77
|
output: oss-signal.sarif
|
|
68
78
|
summary: "false"
|
|
69
|
-
- uses: github/codeql-action/upload-sarif@
|
|
79
|
+
- uses: github/codeql-action/upload-sarif@v4
|
|
70
80
|
with:
|
|
71
81
|
sarif_file: oss-signal.sarif
|
|
72
82
|
```
|
|
@@ -77,13 +87,13 @@ Full walkthrough: [sarif-code-scanning.md](sarif-code-scanning.md)
|
|
|
77
87
|
|
|
78
88
|
Useful adoption evidence is concrete and public:
|
|
79
89
|
|
|
80
|
-
- A workflow run that uses `SalmonPlays/oss-signal@v0.
|
|
90
|
+
- A workflow run that uses `SalmonPlays/oss-signal@v0.8.1`.
|
|
81
91
|
- A Markdown report attached as a workflow artifact.
|
|
82
92
|
- A SARIF upload that appears in Code Scanning.
|
|
83
93
|
- A focused issue or pull request created from an audit finding.
|
|
84
94
|
- A short note about what maintainer task the audit improved.
|
|
85
95
|
|
|
86
|
-
Open an [adoption report](https://github.com/SalmonPlays/oss-signal/issues/new?template=adoption_report.yml) when a public repository uses the CLI or Action. Open a [maintainer audit report](https://github.com/SalmonPlays/oss-signal/issues/new?template=audit_report.yml) when you want to discuss a generated report before posting follow-up to another repository.
|
|
96
|
+
Open an [adoption report](https://github.com/SalmonPlays/oss-signal/issues/new?template=adoption_report.yml) when a public repository uses the CLI or Action. Open [trial feedback](https://github.com/SalmonPlays/oss-signal/issues/new?template=trial_feedback.yml) when you reviewed a report but did not adopt the tool. Open a [maintainer audit report](https://github.com/SalmonPlays/oss-signal/issues/new?template=audit_report.yml) when you want to discuss a generated report before posting follow-up to another repository.
|
|
87
97
|
|
|
88
98
|
## Boundaries
|
|
89
99
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
<rect x="0" y="0" width="920" height="58" rx="18" fill="#f6f8fa"/>
|
|
7
7
|
<text x="32" y="37" fill="#24292f" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="18" font-weight="700">GitHub Code Scanning</text>
|
|
8
8
|
<text x="32" y="98" fill="#24292f" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="28" font-weight="700">oss-signal maintainer-readiness findings</text>
|
|
9
|
-
<text x="32" y="132" fill="#57606a" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="16">SARIF upload from SalmonPlays/oss-signal@v0.
|
|
9
|
+
<text x="32" y="132" fill="#57606a" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="16">SARIF upload from SalmonPlays/oss-signal@v0.8.1</text>
|
|
10
10
|
<rect x="32" y="162" width="856" height="72" rx="10" fill="#fffbdd" stroke="#d4a72c"/>
|
|
11
11
|
<circle cx="65" cy="198" r="10" fill="#bf8700"/>
|
|
12
12
|
<text x="88" y="194" fill="#24292f" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="17" font-weight="700">oss-signal/security</text>
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
<rect x="334" y="266" width="144" height="42" rx="21" fill="#dcfce7"/>
|
|
35
35
|
<text x="359" y="293" fill="#166534">100/100 A</text>
|
|
36
36
|
<rect x="494" y="266" width="142" height="42" rx="21" fill="#dbeafe"/>
|
|
37
|
-
<text x="521" y="293" fill="#1e40af">npm 0.
|
|
37
|
+
<text x="521" y="293" fill="#1e40af">npm 0.8.1</text>
|
|
38
38
|
<rect x="652" y="266" width="178" height="42" rx="21" fill="#e0f2fe"/>
|
|
39
39
|
<text x="681" y="293" fill="#075985">GitHub Action</text>
|
|
40
40
|
<rect x="846" y="266" width="168" height="42" rx="21" fill="#fef9c3"/>
|
package/docs/brand.md
CHANGED
|
@@ -19,7 +19,7 @@ The display name is intentionally more descriptive for reviewers, while `oss-sig
|
|
|
19
19
|
|
|
20
20
|
Recommended repository description:
|
|
21
21
|
|
|
22
|
-
> Maintainer-readiness CLI and GitHub Action for OSS triage, CI evidence, inventory reports, SARIF,
|
|
22
|
+
> Maintainer-readiness CLI and GitHub Action for OSS triage, CI evidence, inventory reports, SARIF, issue-ready cleanup, and workflow trials.
|
|
23
23
|
|
|
24
24
|
Recommended repository topics:
|
|
25
25
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Codex for Open Source Application Brief
|
|
2
2
|
|
|
3
|
-
Snapshot: 2026-06-
|
|
3
|
+
Snapshot: 2026-06-05T09:57:04Z
|
|
4
4
|
|
|
5
5
|
This document summarizes why `oss-signal` is a fit for OpenAI's Codex for Open Source program. The official program page says open-source maintainers can apply, with emphasis on core maintainers, widely used public projects, and projects that play an important ecosystem role: https://developers.openai.com/community/codex-for-oss
|
|
6
6
|
|
|
@@ -9,15 +9,18 @@ This document summarizes why `oss-signal` is a fit for OpenAI's Codex for Open S
|
|
|
9
9
|
- Display name: OSS Maintainer Signal
|
|
10
10
|
- Repository: https://github.com/SalmonPlays/oss-signal
|
|
11
11
|
- npm package: https://www.npmjs.com/package/oss-signal
|
|
12
|
-
- GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.
|
|
13
|
-
- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.
|
|
12
|
+
- GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.8.1
|
|
13
|
+
- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.1
|
|
14
14
|
- CI workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/ci.yml
|
|
15
15
|
- Repository health workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/repository-health.yml
|
|
16
16
|
- Repository inventory workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/repository-inventory.yml
|
|
17
17
|
- CodeQL workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/codeql.yml
|
|
18
|
-
- Separate public workflow demo: https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/
|
|
18
|
+
- Separate public workflow demo: https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26993130878
|
|
19
19
|
- Maintainer evidence: [adoption-evidence.md](adoption-evidence.md)
|
|
20
|
+
- Evidence ledger: [evidence-ledger.md](evidence-ledger.md)
|
|
20
21
|
- Reviewer evidence quickstart: [reviewer-evidence.md](reviewer-evidence.md)
|
|
22
|
+
- Maintainer trial: [maintainer-trial.md](maintainer-trial.md)
|
|
23
|
+
- Maintainer feedback: [maintainer-feedback.md](maintainer-feedback.md)
|
|
21
24
|
- Post-submission update: [post-submission-update.md](post-submission-update.md)
|
|
22
25
|
- Brand assets and GitHub settings copy: [brand.md](brand.md)
|
|
23
26
|
- Form answer pack: [codex-for-oss-form-answers.md](codex-for-oss-form-answers.md)
|
|
@@ -50,28 +53,32 @@ This project is designed around repeatable maintainer workflows where Codex is u
|
|
|
50
53
|
|
|
51
54
|
The repository currently has:
|
|
52
55
|
|
|
53
|
-
- A published npm package with `0.
|
|
56
|
+
- A published npm package with `0.8.1` as the latest release.
|
|
54
57
|
- A post-submission update page explaining why the current npm package and Action tag may be newer than the originally submitted evidence.
|
|
55
|
-
- npm download API evidence showing 356 last-week and last-month downloads on 2026-06-
|
|
56
|
-
- A published GitHub Release for v0.
|
|
58
|
+
- npm download API evidence showing 356 last-week and last-month downloads on 2026-06-05.
|
|
59
|
+
- A published GitHub Release for v0.8.1 with maintainer plan output, CI usage guidance, and release notes.
|
|
57
60
|
- A reusable GitHub Action with `score`, `grade`, `failed`, and `report-path` outputs.
|
|
58
61
|
- A repository inventory mode for organization-level maintainer-readiness triage, available in both CLI and GitHub Action form.
|
|
59
|
-
- A clean npm smoke test of `oss-signal@0.
|
|
62
|
+
- A clean npm smoke test of `oss-signal@0.8.1` returning version `0.8.1`, score `100`, grade `A`, and source `github`.
|
|
60
63
|
- SARIF output for GitHub Code Scanning integration.
|
|
61
|
-
- A v0.
|
|
62
|
-
- A
|
|
63
|
-
- A public dogfood
|
|
64
|
-
- A
|
|
64
|
+
- A v0.8.1 GitHub Action tag with step summary, SARIF support, inventory support, Issue-ready output, and maintainer plan output.
|
|
65
|
+
- A workflow output mode that renders a no-fail GitHub Actions trial workflow for external maintainers.
|
|
66
|
+
- A public dogfood workflow that runs `SalmonPlays/oss-signal@v0.8.1` against the repository, uploads the Markdown report artifact, and uploads SARIF to GitHub Code Scanning on non-PR runs.
|
|
67
|
+
- A public dogfood inventory workflow that runs `SalmonPlays/oss-signal@v0.8.1` against a repository target list and uploads an inventory artifact.
|
|
68
|
+
- A separate public workflow demo that runs `SalmonPlays/oss-signal@v0.7.0` from another repository and uploads Markdown, SARIF, and Issue-ready report artifacts.
|
|
69
|
+
- A no-fail maintainer trial workflow that external maintainers can copy before enabling CI gates.
|
|
70
|
+
- A trial feedback path for neutral or negative maintainer responses, so third-party feedback does not have to be overstated as adoption.
|
|
65
71
|
- A maintainer playbook that documents audit, triage, issue, PR, CI, and SARIF workflows.
|
|
66
72
|
- A release process and tag-triggered release workflow that verify package contents and publish to npm through Trusted Publishing.
|
|
67
73
|
- CI, Repository health, CodeQL, and Release workflows passing publicly.
|
|
68
74
|
- A local self-audit score of 100/100.
|
|
69
|
-
- A clean-directory smoke test of `npm exec --yes --package=oss-signal@0.
|
|
70
|
-
- Public reports, issues, and PRs created from real repository audits, including
|
|
75
|
+
- A clean-directory smoke test of `npm exec --yes --package=oss-signal@0.8.1 -- oss-signal SalmonPlays/oss-signal --format json`, returning 100/100 (A).
|
|
76
|
+
- Public reports, issues, and PRs created from real repository audits, including six posted field-audit issues and five follow-up PRs.
|
|
77
|
+
- One accepted external documentation PR, with a public maintainer merge comment, recorded in [evidence-ledger.md](evidence-ledger.md).
|
|
71
78
|
|
|
72
79
|
## Separate Workflow Demo
|
|
73
80
|
|
|
74
|
-
The repository https://github.com/SalmonPlays/oss-signal-adoption-demo runs the public `SalmonPlays/oss-signal@v0.
|
|
81
|
+
The repository https://github.com/SalmonPlays/oss-signal-adoption-demo runs the public `SalmonPlays/oss-signal@v0.7.0` Action tag from a separate workflow. The successful run at https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26993130878 uploaded an `oss-signal-adoption-demo-report` artifact containing Markdown, SARIF, and Issue-ready output.
|
|
75
82
|
|
|
76
83
|
This is intentionally described as a separate public workflow demo rather than third-party adoption because the repository is also owned by `SalmonPlays`. It still proves that the published Action tag is consumable outside the main repository.
|
|
77
84
|
|
|
@@ -79,30 +86,32 @@ This is intentionally described as a separate public workflow demo rather than t
|
|
|
79
86
|
|
|
80
87
|
| Repository | Report | Issue | PR | Status |
|
|
81
88
|
| --- | --- | --- | --- | --- |
|
|
82
|
-
| `platformatic/massimo` | [report](outreach/platformatic-massimo-report.md) | https://github.com/platformatic/massimo/issues/159 | https://github.com/platformatic/massimo/pull/160 | open,
|
|
83
|
-
| `supermarkt/checkjebon` | [report](outreach/supermarkt-checkjebon-report.md) | https://github.com/supermarkt/checkjebon/issues/22 | https://github.com/supermarkt/checkjebon/pull/23 | open,
|
|
84
|
-
| `sammorrisdesign/interactive-feed` | [report](outreach/sammorrisdesign-interactive-feed-report.md) | https://github.com/sammorrisdesign/interactive-feed/issues/14 | https://github.com/sammorrisdesign/interactive-feed/pull/15 | open |
|
|
85
|
-
| `flox/install-flox-action` | [report](outreach/flox-install-flox-action-report.md) | https://github.com/flox/install-flox-action/issues/204 | https://github.com/flox/install-flox-action/pull/205 | open,
|
|
89
|
+
| `platformatic/massimo` | [report](outreach/platformatic-massimo-report.md) | https://github.com/platformatic/massimo/issues/159 | https://github.com/platformatic/massimo/pull/160 | open, mergeable |
|
|
90
|
+
| `supermarkt/checkjebon` | [report](outreach/supermarkt-checkjebon-report.md) | https://github.com/supermarkt/checkjebon/issues/22 | https://github.com/supermarkt/checkjebon/pull/23 | open, mergeable |
|
|
91
|
+
| `sammorrisdesign/interactive-feed` | [report](outreach/sammorrisdesign-interactive-feed-report.md) | https://github.com/sammorrisdesign/interactive-feed/issues/14 | https://github.com/sammorrisdesign/interactive-feed/pull/15 | open, mergeable |
|
|
92
|
+
| `flox/install-flox-action` | [report](outreach/flox-install-flox-action-report.md) | https://github.com/flox/install-flox-action/issues/204 | https://github.com/flox/install-flox-action/pull/205 | open, mergeable |
|
|
86
93
|
| `Grovanni/oss-signal` | [report](outreach/grovanni-oss-signal-report.md) | https://github.com/Grovanni/oss-signal/issues/1 | N/A | open |
|
|
94
|
+
| `noctemlabs/signal-oss` | [report](outreach/noctemlabs-signal-oss-report.md) | N/A | https://github.com/noctemlabs/signal-oss/pull/12 | open, mergeable |
|
|
95
|
+
| `Divyesh-5981/signal-oss` | [report](outreach/divyesh-5981-signal-oss-report.md) | https://github.com/Divyesh-5981/signal-oss/issues/5 | N/A | open |
|
|
87
96
|
|
|
88
|
-
These PRs are intentionally small and maintainer-friendly. They add documentation
|
|
97
|
+
These PRs are intentionally small and maintainer-friendly. They add documentation, GitHub templates, or minimal CI automation rather than changing product code.
|
|
89
98
|
|
|
90
99
|
## Application Positioning
|
|
91
100
|
|
|
92
101
|
Recommended application angle:
|
|
93
102
|
|
|
94
|
-
`oss-signal` is not yet a widely adopted project, but it is a public OSS maintainer tool built specifically for repeatable Codex-assisted maintenance. The project already has a working CLI, npm distribution, GitHub Action, passing CI/CodeQL, self-audit evidence,
|
|
103
|
+
`oss-signal` is not yet a widely adopted project, but it is a public OSS maintainer tool built specifically for repeatable Codex-assisted maintenance. The project already has a working CLI, npm distribution, GitHub Action, passing CI/CodeQL, self-audit evidence, six public field-audit issues, five public field-audit PRs, and one merged external Codex Action documentation PR. Codex support would be used to continue auditing repositories, prepare focused maintainer PRs, improve Action automation, and document repeatable OSS maintenance workflows.
|
|
95
104
|
|
|
96
105
|
Prepared official form answers are in [codex-for-oss-form-answers.md](codex-for-oss-form-answers.md). The applicant still needs to fill personal identity fields and their OpenAI Organization ID directly.
|
|
97
106
|
|
|
98
107
|
## Current Gaps
|
|
99
108
|
|
|
100
|
-
-
|
|
109
|
+
- Field-audit PRs are open but not yet merged.
|
|
101
110
|
- npm download metrics are still early because the package is newly published.
|
|
102
111
|
- The project needs independent maintainer-owned repositories using the Action in their own workflows.
|
|
103
112
|
|
|
104
113
|
## Next Evidence To Collect
|
|
105
114
|
|
|
106
|
-
-
|
|
107
|
-
- A public workflow run in an independent maintainer-owned repository using `SalmonPlays/oss-signal@v0.
|
|
115
|
+
- More merged external PRs or maintainer replies on field-audit PRs.
|
|
116
|
+
- A public workflow run in an independent maintainer-owned repository using `SalmonPlays/oss-signal@v0.8.1`, ideally with SARIF or inventory upload enabled.
|
|
108
117
|
- npm download data once the registry starts reporting weekly/monthly counts.
|