oss-signal 0.8.2 → 0.8.3
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 +4 -0
- package/README.md +13 -10
- package/docs/adoption-evidence.md +9 -9
- package/docs/adoption-kit.md +12 -6
- package/docs/assets/code-scanning-results.svg +1 -1
- package/docs/assets/oss-signal-banner.svg +1 -1
- package/docs/codex-for-oss-application.md +10 -10
- package/docs/codex-for-oss-form-answers.md +3 -3
- package/docs/evidence-ledger.md +3 -3
- package/docs/examples/github-action-workflow.yml +4 -1
- package/docs/examples/github-code-scanning-workflow.yml +5 -2
- package/docs/examples/github-inventory-workflow.yml +4 -1
- package/docs/examples/github-url-report.json +1 -1
- package/docs/examples/maintainer-trial-workflow.yml +4 -1
- package/docs/examples/self-audit.sarif +2 -2
- package/docs/index.md +2 -2
- package/docs/maintainer-playbook.md +5 -5
- package/docs/maintainer-trial.md +9 -6
- package/docs/marketplace.md +3 -3
- package/docs/post-submission-update.md +10 -9
- package/docs/release-notes/v0.8.3.md +18 -0
- package/docs/reviewer-evidence.md +5 -5
- package/docs/roadmap.md +1 -1
- package/docs/sarif-code-scanning.md +5 -2
- package/docs/security-model.md +1 -1
- package/docs/self-audit.md +1 -1
- package/docs/social-launch.md +1 -1
- package/docs/trust-center.md +3 -3
- package/package.json +1 -1
- package/src/index.js +5 -2
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
## Unreleased
|
|
4
4
|
|
|
5
|
+
## 0.8.3
|
|
6
|
+
|
|
7
|
+
- Added workflow-level Node.js 24 opt-in for generated trial workflows, dogfood workflows, and copyable examples to avoid GitHub Actions Node.js 20 deprecation warnings.
|
|
8
|
+
|
|
5
9
|
## 0.8.2
|
|
6
10
|
|
|
7
11
|
- Updated generated trial workflows, dogfood workflows, and documentation examples to `actions/upload-artifact@v5`.
|
package/README.md
CHANGED
|
@@ -26,8 +26,8 @@ It checks the files and automation that reduce maintainer load: README, license,
|
|
|
26
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.8.
|
|
30
|
-
- Published GitHub Action: [`SalmonPlays/oss-signal@v0.8.
|
|
29
|
+
- Published package: [`oss-signal@0.8.3`](https://www.npmjs.com/package/oss-signal), with `latest` pointing at `0.8.3`.
|
|
30
|
+
- Published GitHub Action: [`SalmonPlays/oss-signal@v0.8.3`](https://github.com/SalmonPlays/oss-signal/tree/v0.8.3).
|
|
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
33
|
- Evidence ledger: [docs/evidence-ledger.md](docs/evidence-ledger.md)
|
|
@@ -41,7 +41,7 @@ Public evidence for the maintainer workflow is collected in [docs/index.md](docs
|
|
|
41
41
|
- Maintainer plan output: [docs/plan-output.md](docs/plan-output.md)
|
|
42
42
|
- SARIF Code Scanning walkthrough: [docs/sarif-code-scanning.md](docs/sarif-code-scanning.md)
|
|
43
43
|
- Roadmap: [docs/roadmap.md](docs/roadmap.md)
|
|
44
|
-
- Post-submission version note: the application may reference earlier evidence; `0.8.
|
|
44
|
+
- Post-submission version note: the application may reference earlier evidence; `0.8.3` is the current maintained release and is documented in [docs/post-submission-update.md](docs/post-submission-update.md).
|
|
45
45
|
- Public checks: CI, Repository health, and CodeQL are passing on `main`.
|
|
46
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.
|
|
47
47
|
- Branch posture: `main` has branch protection to prevent force pushes and deletions while keeping direct maintainer maintenance possible.
|
|
@@ -193,7 +193,7 @@ Summary:
|
|
|
193
193
|
|
|
194
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.
|
|
195
195
|
|
|
196
|
-
The [Repository health workflow](.github/workflows/repository-health.yml) runs `SalmonPlays/oss-signal@v0.8.
|
|
196
|
+
The [Repository health workflow](.github/workflows/repository-health.yml) runs `SalmonPlays/oss-signal@v0.8.3`, 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.
|
|
197
197
|
|
|
198
198
|
## Field Audits
|
|
199
199
|
|
|
@@ -244,7 +244,7 @@ oss-signal . --fail-under 80
|
|
|
244
244
|
Add `oss-signal` directly to a GitHub Actions workflow:
|
|
245
245
|
|
|
246
246
|
```yaml
|
|
247
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
247
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
248
248
|
id: oss-signal
|
|
249
249
|
with:
|
|
250
250
|
fail-under: "80"
|
|
@@ -260,7 +260,7 @@ The Action writes a concise GitHub Actions step summary by default, so reviewers
|
|
|
260
260
|
Run an inventory from CI:
|
|
261
261
|
|
|
262
262
|
```yaml
|
|
263
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
263
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
264
264
|
env:
|
|
265
265
|
GITHUB_TOKEN: ${{ github.token }}
|
|
266
266
|
with:
|
|
@@ -272,7 +272,7 @@ Run an inventory from CI:
|
|
|
272
272
|
Generate an editable Issue body from CI:
|
|
273
273
|
|
|
274
274
|
```yaml
|
|
275
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
275
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
276
276
|
with:
|
|
277
277
|
format: issue
|
|
278
278
|
output: maintainer-follow-up.md
|
|
@@ -289,12 +289,15 @@ on:
|
|
|
289
289
|
push:
|
|
290
290
|
branches: [main]
|
|
291
291
|
|
|
292
|
+
env:
|
|
293
|
+
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
|
|
294
|
+
|
|
292
295
|
jobs:
|
|
293
296
|
oss-signal:
|
|
294
297
|
runs-on: ubuntu-latest
|
|
295
298
|
steps:
|
|
296
299
|
- uses: actions/checkout@v5
|
|
297
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
300
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
298
301
|
id: oss-signal
|
|
299
302
|
with:
|
|
300
303
|
fail-under: "80"
|
|
@@ -317,7 +320,7 @@ permissions:
|
|
|
317
320
|
|
|
318
321
|
steps:
|
|
319
322
|
- uses: actions/checkout@v5
|
|
320
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
323
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
321
324
|
with:
|
|
322
325
|
format: sarif
|
|
323
326
|
output: oss-signal.sarif
|
|
@@ -327,7 +330,7 @@ steps:
|
|
|
327
330
|
sarif_file: oss-signal.sarif
|
|
328
331
|
```
|
|
329
332
|
|
|
330
|
-
This repository dogfoods the public Action tag in [Repository health](.github/workflows/repository-health.yml), which runs `SalmonPlays/oss-signal@v0.8.
|
|
333
|
+
This repository dogfoods the public Action tag in [Repository health](.github/workflows/repository-health.yml), which runs `SalmonPlays/oss-signal@v0.8.3` against the repository, uploads the Markdown report artifact, and publishes SARIF to Code Scanning on non-PR runs.
|
|
331
334
|
|
|
332
335
|
You can also run the CLI directly in CI:
|
|
333
336
|
|
|
@@ -8,9 +8,9 @@ Last verified: 2026-06-05T09:57:04Z
|
|
|
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.8.
|
|
12
|
-
- GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.8.
|
|
13
|
-
- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.
|
|
11
|
+
- npm package: https://www.npmjs.com/package/oss-signal (`0.8.3` latest)
|
|
12
|
+
- GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.8.3
|
|
13
|
+
- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.3
|
|
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)
|
|
@@ -69,7 +69,7 @@ The [post-submission update](post-submission-update.md) records why the current
|
|
|
69
69
|
|
|
70
70
|
## Published Package Verification
|
|
71
71
|
|
|
72
|
-
The npm package is publicly available as `oss-signal@0.8.
|
|
72
|
+
The npm package is publicly available as `oss-signal@0.8.3` with `latest` pointing at `0.8.3`.
|
|
73
73
|
|
|
74
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.
|
|
75
75
|
|
|
@@ -77,7 +77,7 @@ Clean-directory execution against the public GitHub repository returned:
|
|
|
77
77
|
|
|
78
78
|
```json
|
|
79
79
|
{
|
|
80
|
-
"version": "0.8.
|
|
80
|
+
"version": "0.8.3",
|
|
81
81
|
"score": 100,
|
|
82
82
|
"grade": "A",
|
|
83
83
|
"source": "github"
|
|
@@ -93,7 +93,7 @@ Current public workflow status:
|
|
|
93
93
|
- OpenSSF Scorecard: configured on `main` pushes and a weekly schedule, with JSON artifact output and public Scorecard publishing
|
|
94
94
|
- Release: passing
|
|
95
95
|
- GitHub Pages deployment: passing, with the repository homepage set to https://salmonplays.github.io/oss-signal/
|
|
96
|
-
- GitHub Marketplace listing: published, with `v0.8.
|
|
96
|
+
- GitHub Marketplace listing: published, with `v0.8.3` available as the current Action tag
|
|
97
97
|
- GitHub issue forms: adoption report, trial feedback, and maintainer audit report forms are available for structured public evidence intake
|
|
98
98
|
- GitHub citation metadata: `CITATION.cff` is present for the repository citation UI
|
|
99
99
|
- Automation contract: JSON schema and fixture are documented for `--format json`
|
|
@@ -102,7 +102,7 @@ Current public workflow status:
|
|
|
102
102
|
- Maintainer workflow Discussion: published
|
|
103
103
|
- Separate public workflow demo: passing
|
|
104
104
|
|
|
105
|
-
The npm registry returned `0.8.
|
|
105
|
+
The npm registry returned `0.8.3` for both the package version and `latest` dist-tag on 2026-06-05T09:57:04Z. A clean install smoke test returned version `0.8.3`, score `100`, grade `A`, and source `github`. The 2026-06-05 download check returned 356 downloads for the last-week and last-month windows.
|
|
106
106
|
|
|
107
107
|
## Separate Public Workflow Evidence
|
|
108
108
|
|
|
@@ -165,10 +165,10 @@ npm run audit:github
|
|
|
165
165
|
node src/cli.js . --format sarif --output docs/examples/self-audit.sarif
|
|
166
166
|
node src/cli.js --inventory docs/examples/inventory-targets.txt --format markdown --output docs/examples/inventory-report.md
|
|
167
167
|
node src/cli.js platformatic/massimo --format json
|
|
168
|
-
npm exec --yes --package=oss-signal@0.8.
|
|
168
|
+
npm exec --yes --package=oss-signal@0.8.3 -- oss-signal SalmonPlays/oss-signal --format json
|
|
169
169
|
```
|
|
170
170
|
|
|
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.
|
|
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.3` Action tag is used by the repository health workflow for Markdown and SARIF output. The published npm `0.8.3` package has also been executed from a clean temporary directory against the public GitHub repository, returning 100/100 (A).
|
|
172
172
|
|
|
173
173
|
Public CI evidence:
|
|
174
174
|
|
package/docs/adoption-kit.md
CHANGED
|
@@ -9,7 +9,7 @@ For a first trial, use the no-fail workflow in [maintainer-trial.md](maintainer-
|
|
|
9
9
|
Run against a public repository without cloning:
|
|
10
10
|
|
|
11
11
|
```bash
|
|
12
|
-
npm exec --yes --package=oss-signal@0.8.
|
|
12
|
+
npm exec --yes --package=oss-signal@0.8.3 -- oss-signal owner/repo --format markdown --output oss-signal-report.md
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
Run against the current checkout:
|
|
@@ -45,12 +45,15 @@ on:
|
|
|
45
45
|
permissions:
|
|
46
46
|
contents: read
|
|
47
47
|
|
|
48
|
+
env:
|
|
49
|
+
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
|
|
50
|
+
|
|
48
51
|
jobs:
|
|
49
52
|
oss-signal:
|
|
50
53
|
runs-on: ubuntu-latest
|
|
51
54
|
steps:
|
|
52
|
-
- uses: actions/checkout@
|
|
53
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
55
|
+
- uses: actions/checkout@v5
|
|
56
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
54
57
|
id: oss-signal
|
|
55
58
|
with:
|
|
56
59
|
fail-under: "80"
|
|
@@ -69,9 +72,12 @@ permissions:
|
|
|
69
72
|
contents: read
|
|
70
73
|
security-events: write
|
|
71
74
|
|
|
75
|
+
env:
|
|
76
|
+
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
|
|
77
|
+
|
|
72
78
|
steps:
|
|
73
|
-
- uses: actions/checkout@
|
|
74
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
79
|
+
- uses: actions/checkout@v5
|
|
80
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
75
81
|
with:
|
|
76
82
|
format: sarif
|
|
77
83
|
output: oss-signal.sarif
|
|
@@ -87,7 +93,7 @@ Full walkthrough: [sarif-code-scanning.md](sarif-code-scanning.md)
|
|
|
87
93
|
|
|
88
94
|
Useful adoption evidence is concrete and public:
|
|
89
95
|
|
|
90
|
-
- A workflow run that uses `SalmonPlays/oss-signal@v0.8.
|
|
96
|
+
- A workflow run that uses `SalmonPlays/oss-signal@v0.8.3`.
|
|
91
97
|
- A Markdown report attached as a workflow artifact.
|
|
92
98
|
- A SARIF upload that appears in Code Scanning.
|
|
93
99
|
- A focused issue or pull request created from an audit finding.
|
|
@@ -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.8.
|
|
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.3</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.8.
|
|
37
|
+
<text x="521" y="293" fill="#1e40af">npm 0.8.3</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"/>
|
|
@@ -9,8 +9,8 @@ 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.8.
|
|
13
|
-
- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.
|
|
12
|
+
- GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.8.3
|
|
13
|
+
- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.3
|
|
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
|
|
@@ -53,18 +53,18 @@ This project is designed around repeatable maintainer workflows where Codex is u
|
|
|
53
53
|
|
|
54
54
|
The repository currently has:
|
|
55
55
|
|
|
56
|
-
- A published npm package with `0.8.
|
|
56
|
+
- A published npm package with `0.8.3` as the latest release.
|
|
57
57
|
- A post-submission update page explaining why the current npm package and Action tag may be newer than the originally submitted evidence.
|
|
58
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.
|
|
59
|
+
- A published GitHub Release for v0.8.3 with maintainer plan output, CI usage guidance, and release notes.
|
|
60
60
|
- A reusable GitHub Action with `score`, `grade`, `failed`, and `report-path` outputs.
|
|
61
61
|
- A repository inventory mode for organization-level maintainer-readiness triage, available in both CLI and GitHub Action form.
|
|
62
|
-
- A clean npm smoke test of `oss-signal@0.8.
|
|
62
|
+
- A clean npm smoke test of `oss-signal@0.8.3` returning version `0.8.3`, score `100`, grade `A`, and source `github`.
|
|
63
63
|
- SARIF output for GitHub Code Scanning integration.
|
|
64
|
-
- A v0.8.
|
|
64
|
+
- A v0.8.3 GitHub Action tag with step summary, SARIF support, inventory support, Issue-ready output, and maintainer plan output.
|
|
65
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.
|
|
67
|
-
- A public dogfood inventory workflow that runs `SalmonPlays/oss-signal@v0.8.
|
|
66
|
+
- A public dogfood workflow that runs `SalmonPlays/oss-signal@v0.8.3` 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.3` against a repository target list and uploads an inventory artifact.
|
|
68
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
69
|
- A no-fail maintainer trial workflow that external maintainers can copy before enabling CI gates.
|
|
70
70
|
- A trial feedback path for neutral or negative maintainer responses, so third-party feedback does not have to be overstated as adoption.
|
|
@@ -72,7 +72,7 @@ The repository currently has:
|
|
|
72
72
|
- A release process and tag-triggered release workflow that verify package contents and publish to npm through Trusted Publishing.
|
|
73
73
|
- CI, Repository health, CodeQL, and Release workflows passing publicly.
|
|
74
74
|
- A local self-audit score of 100/100.
|
|
75
|
-
- A clean-directory smoke test of `npm exec --yes --package=oss-signal@0.8.
|
|
75
|
+
- A clean-directory smoke test of `npm exec --yes --package=oss-signal@0.8.3 -- oss-signal SalmonPlays/oss-signal --format json`, returning 100/100 (A).
|
|
76
76
|
- Public reports, issues, and PRs created from real repository audits, including six posted field-audit issues and five follow-up PRs.
|
|
77
77
|
- One accepted external documentation PR, with a public maintainer merge comment, recorded in [evidence-ledger.md](evidence-ledger.md).
|
|
78
78
|
|
|
@@ -113,5 +113,5 @@ Prepared official form answers are in [codex-for-oss-form-answers.md](codex-for-
|
|
|
113
113
|
## Next Evidence To Collect
|
|
114
114
|
|
|
115
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.
|
|
116
|
+
- A public workflow run in an independent maintainer-owned repository using `SalmonPlays/oss-signal@v0.8.3`, ideally with SARIF or inventory upload enabled.
|
|
117
117
|
- npm download data once the registry starts reporting weekly/monthly counts.
|
|
@@ -50,7 +50,7 @@ Primary maintainer
|
|
|
50
50
|
## Why This Repository Qualifies
|
|
51
51
|
|
|
52
52
|
```text
|
|
53
|
-
oss-signal is a public OSS maintainer tool for reducing triage and review load. It ships as npm package oss-signal@0.8.
|
|
53
|
+
oss-signal is a public OSS maintainer tool for reducing triage and review load. It ships as npm package oss-signal@0.8.3 and GitHub Action SalmonPlays/oss-signal@v0.8.3, supports Markdown/JSON/SARIF/Issue/Plan/Inventory/Workflow output, passes CI/CodeQL/Release, has a 100/100 self-audit, no-fail maintainer trial and feedback paths, six public field-audit issues, five public field-audit PRs, and one merged external Codex Action documentation PR.
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
## Interest
|
|
@@ -81,13 +81,13 @@ Use Codex/API credits to run repeatable public repository audits, draft focused
|
|
|
81
81
|
## Anything Else
|
|
82
82
|
|
|
83
83
|
```text
|
|
84
|
-
The project is early, so I am not overstating adoption. Current evidence includes npm 0.8.
|
|
84
|
+
The project is early, so I am not overstating adoption. Current evidence includes npm 0.8.3 latest, 356 npm downloads reported by the registry API on 2026-06-05, a published v0.8.3 release, a reusable GitHub Action with inventory and workflow output, no-fail maintainer trial and feedback paths, a clean npm smoke test returning 100/A, public CI/Repository health/CodeQL/Release, six field-audit issues, five field-audit PRs, and a separate public workflow demo with artifacts.
|
|
85
85
|
```
|
|
86
86
|
|
|
87
87
|
## Evidence Links
|
|
88
88
|
|
|
89
89
|
- npm package: https://www.npmjs.com/package/oss-signal
|
|
90
|
-
- GitHub Release v0.8.
|
|
90
|
+
- GitHub Release v0.8.3: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.8.3
|
|
91
91
|
- Main repository health workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/repository-health.yml
|
|
92
92
|
- Separate workflow demo repository: https://github.com/SalmonPlays/oss-signal-adoption-demo
|
|
93
93
|
- Separate successful workflow run: https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26993130878
|
package/docs/evidence-ledger.md
CHANGED
|
@@ -8,13 +8,13 @@ This ledger keeps the strongest public `oss-signal` evidence in one reviewer-fri
|
|
|
8
8
|
|
|
9
9
|
| Signal | Evidence | Status | Reviewer note |
|
|
10
10
|
| --- | --- | --- | --- |
|
|
11
|
-
| Installable CLI | https://www.npmjs.com/package/oss-signal | `0.8.
|
|
11
|
+
| Installable CLI | https://www.npmjs.com/package/oss-signal | `0.8.3` is `latest` | Reviewers can run `npm exec --yes --package=oss-signal@0.8.3 -- oss-signal SalmonPlays/oss-signal --format json`. |
|
|
12
12
|
| npm download API | 356 downloads for last-week and last-month windows | Checked 2026-06-05T09:57:04Z | Supporting distribution signal only; not claimed as broad adoption. |
|
|
13
|
-
| GitHub Action release | https://github.com/SalmonPlays/oss-signal/tree/v0.8.
|
|
13
|
+
| GitHub Action release | https://github.com/SalmonPlays/oss-signal/tree/v0.8.3 | Published tag | Public Action tag used by repository workflows; the separate demo is refreshed after release publication. |
|
|
14
14
|
| GitHub Marketplace | https://github.com/marketplace/actions/oss-signal | Published listing | Free Action listing under Code quality. |
|
|
15
15
|
| Maintainer trial path | [maintainer-trial.md](maintainer-trial.md) | Published | External maintainers can try the Action without failing CI, then share a workflow run or adoption report. |
|
|
16
16
|
| Maintainer feedback path | [maintainer-feedback.md](maintainer-feedback.md) | Published | External maintainers can leave useful public feedback even when the tool is not adopted. |
|
|
17
|
-
| Main repository dogfood | https://github.com/SalmonPlays/oss-signal/actions/workflows/repository-health.yml | Passing | Runs `SalmonPlays/oss-signal@v0.8.
|
|
17
|
+
| Main repository dogfood | https://github.com/SalmonPlays/oss-signal/actions/workflows/repository-health.yml | Passing | Runs `SalmonPlays/oss-signal@v0.8.3` against this repository. |
|
|
18
18
|
| Inventory dogfood | https://github.com/SalmonPlays/oss-signal/actions/workflows/repository-inventory.yml | Passing | Exercises multi-repository inventory mode. |
|
|
19
19
|
| Separate public workflow demo | https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26993130878 | Passing | Separate public repository runs `SalmonPlays/oss-signal@v0.7.0` and uploads Markdown, SARIF, and issue-ready artifacts. |
|
|
20
20
|
| Accepted external contribution | https://github.com/icoretech/codex-action/pull/24 | Merged 2026-06-04 | External maintainer merged the focused Codex Action documentation safety fix and left a merge comment. |
|
|
@@ -5,12 +5,15 @@ on:
|
|
|
5
5
|
push:
|
|
6
6
|
branches: [main]
|
|
7
7
|
|
|
8
|
+
env:
|
|
9
|
+
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
|
|
10
|
+
|
|
8
11
|
jobs:
|
|
9
12
|
oss-signal:
|
|
10
13
|
runs-on: ubuntu-latest
|
|
11
14
|
steps:
|
|
12
15
|
- uses: actions/checkout@v5
|
|
13
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
16
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
14
17
|
id: oss-signal
|
|
15
18
|
with:
|
|
16
19
|
fail-under: "80"
|
|
@@ -10,18 +10,21 @@ permissions:
|
|
|
10
10
|
contents: read
|
|
11
11
|
security-events: write
|
|
12
12
|
|
|
13
|
+
env:
|
|
14
|
+
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
|
|
15
|
+
|
|
13
16
|
jobs:
|
|
14
17
|
oss-signal:
|
|
15
18
|
runs-on: ubuntu-latest
|
|
16
19
|
steps:
|
|
17
20
|
- uses: actions/checkout@v5
|
|
18
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
21
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
19
22
|
id: oss-signal
|
|
20
23
|
with:
|
|
21
24
|
fail-under: "80"
|
|
22
25
|
output: oss-signal-report.md
|
|
23
26
|
summary: "true"
|
|
24
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
27
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
25
28
|
with:
|
|
26
29
|
format: sarif
|
|
27
30
|
output: oss-signal.sarif
|
|
@@ -8,12 +8,15 @@ on:
|
|
|
8
8
|
permissions:
|
|
9
9
|
contents: read
|
|
10
10
|
|
|
11
|
+
env:
|
|
12
|
+
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
|
|
13
|
+
|
|
11
14
|
jobs:
|
|
12
15
|
inventory:
|
|
13
16
|
runs-on: ubuntu-latest
|
|
14
17
|
steps:
|
|
15
18
|
- uses: actions/checkout@v5
|
|
16
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
19
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
17
20
|
id: oss-signal
|
|
18
21
|
env:
|
|
19
22
|
GITHUB_TOKEN: ${{ github.token }}
|
|
@@ -7,12 +7,15 @@ on:
|
|
|
7
7
|
permissions:
|
|
8
8
|
contents: read
|
|
9
9
|
|
|
10
|
+
env:
|
|
11
|
+
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
|
|
12
|
+
|
|
10
13
|
jobs:
|
|
11
14
|
audit:
|
|
12
15
|
runs-on: ubuntu-latest
|
|
13
16
|
steps:
|
|
14
17
|
- uses: actions/checkout@v5
|
|
15
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
18
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
16
19
|
id: oss-signal
|
|
17
20
|
with:
|
|
18
21
|
output: oss-signal-report.md
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
"tool": {
|
|
7
7
|
"driver": {
|
|
8
8
|
"name": "oss-signal",
|
|
9
|
-
"semanticVersion": "0.8.
|
|
9
|
+
"semanticVersion": "0.8.3",
|
|
10
10
|
"informationUri": "https://github.com/SalmonPlays/oss-signal",
|
|
11
11
|
"rules": [
|
|
12
12
|
{
|
|
@@ -400,7 +400,7 @@
|
|
|
400
400
|
"score": 100,
|
|
401
401
|
"grade": "A",
|
|
402
402
|
"source": "local",
|
|
403
|
-
"generatedAt": "2026-06-05T15:
|
|
403
|
+
"generatedAt": "2026-06-05T15:54:19.231Z"
|
|
404
404
|
}
|
|
405
405
|
}
|
|
406
406
|
]
|
package/docs/index.md
CHANGED
|
@@ -13,7 +13,7 @@ npx oss-signal SalmonPlays/oss-signal
|
|
|
13
13
|
Run as a GitHub Action:
|
|
14
14
|
|
|
15
15
|
```yaml
|
|
16
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
16
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
17
17
|
id: oss-signal
|
|
18
18
|
with:
|
|
19
19
|
path: "."
|
|
@@ -55,6 +55,6 @@ Run as a GitHub Action:
|
|
|
55
55
|
|
|
56
56
|
- Repository: https://github.com/SalmonPlays/oss-signal
|
|
57
57
|
- npm package: https://www.npmjs.com/package/oss-signal
|
|
58
|
-
- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.
|
|
58
|
+
- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.3
|
|
59
59
|
- GitHub Marketplace listing: https://github.com/marketplace/actions/oss-signal
|
|
60
60
|
- Maintainer workflow discussion: https://github.com/SalmonPlays/oss-signal/discussions/5
|
|
@@ -83,7 +83,7 @@ See [plan-output.md](plan-output.md) and [examples/github-plan.md](examples/gith
|
|
|
83
83
|
Add the GitHub Action to keep the signal visible:
|
|
84
84
|
|
|
85
85
|
```yaml
|
|
86
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
86
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
87
87
|
id: oss-signal
|
|
88
88
|
with:
|
|
89
89
|
fail-under: "80"
|
|
@@ -96,7 +96,7 @@ The Action writes `score`, `grade`, `failed`, and `report-path` outputs, and wri
|
|
|
96
96
|
For a repository inventory, commit a newline-delimited target list and pass it through the Action:
|
|
97
97
|
|
|
98
98
|
```yaml
|
|
99
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
99
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
100
100
|
env:
|
|
101
101
|
GITHUB_TOKEN: ${{ github.token }}
|
|
102
102
|
with:
|
|
@@ -115,8 +115,8 @@ permissions:
|
|
|
115
115
|
security-events: write
|
|
116
116
|
|
|
117
117
|
steps:
|
|
118
|
-
- uses: actions/checkout@
|
|
119
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
118
|
+
- uses: actions/checkout@v5
|
|
119
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
120
120
|
with:
|
|
121
121
|
format: sarif
|
|
122
122
|
output: oss-signal.sarif
|
|
@@ -134,7 +134,7 @@ See [docs/sarif-code-scanning.md](sarif-code-scanning.md) for the permissions, e
|
|
|
134
134
|
|
|
135
135
|
Useful evidence for maintainers and reviewers:
|
|
136
136
|
|
|
137
|
-
- A public workflow run that uses `SalmonPlays/oss-signal@v0.8.
|
|
137
|
+
- A public workflow run that uses `SalmonPlays/oss-signal@v0.8.3`.
|
|
138
138
|
- A generated Markdown report attached as an artifact.
|
|
139
139
|
- A SARIF upload in Code Scanning.
|
|
140
140
|
- A small issue or PR that follows from an audit finding.
|
package/docs/maintainer-trial.md
CHANGED
|
@@ -18,12 +18,15 @@ on:
|
|
|
18
18
|
permissions:
|
|
19
19
|
contents: read
|
|
20
20
|
|
|
21
|
+
env:
|
|
22
|
+
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
|
|
23
|
+
|
|
21
24
|
jobs:
|
|
22
25
|
audit:
|
|
23
26
|
runs-on: ubuntu-latest
|
|
24
27
|
steps:
|
|
25
28
|
- uses: actions/checkout@v5
|
|
26
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
29
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
27
30
|
id: oss-signal
|
|
28
31
|
with:
|
|
29
32
|
output: oss-signal-report.md
|
|
@@ -51,32 +54,32 @@ The same workflow is available as [examples/maintainer-trial-workflow.yml](examp
|
|
|
51
54
|
Run against a public repository without cloning:
|
|
52
55
|
|
|
53
56
|
```bash
|
|
54
|
-
npm exec --yes --package=oss-signal@0.8.
|
|
57
|
+
npm exec --yes --package=oss-signal@0.8.3 -- oss-signal owner/repo --format markdown --output oss-signal-report.md
|
|
55
58
|
```
|
|
56
59
|
|
|
57
60
|
Generate an issue-ready draft for human review:
|
|
58
61
|
|
|
59
62
|
```bash
|
|
60
|
-
npm exec --yes --package=oss-signal@0.8.
|
|
63
|
+
npm exec --yes --package=oss-signal@0.8.3 -- oss-signal owner/repo --format issue --output maintainer-follow-up.md
|
|
61
64
|
```
|
|
62
65
|
|
|
63
66
|
Generate a PR-sized plan before opening a pull request:
|
|
64
67
|
|
|
65
68
|
```bash
|
|
66
|
-
npm exec --yes --package=oss-signal@0.8.
|
|
69
|
+
npm exec --yes --package=oss-signal@0.8.3 -- oss-signal owner/repo --format plan --output maintainer-plan.md
|
|
67
70
|
```
|
|
68
71
|
|
|
69
72
|
Generate the no-fail trial workflow:
|
|
70
73
|
|
|
71
74
|
```bash
|
|
72
|
-
npm exec --yes --package=oss-signal@0.8.
|
|
75
|
+
npm exec --yes --package=oss-signal@0.8.3 -- oss-signal owner/repo --format workflow --output .github/workflows/oss-signal-trial.yml
|
|
73
76
|
```
|
|
74
77
|
|
|
75
78
|
## Evidence To Share
|
|
76
79
|
|
|
77
80
|
Useful public evidence is concrete:
|
|
78
81
|
|
|
79
|
-
- a workflow run that uses `SalmonPlays/oss-signal@v0.8.
|
|
82
|
+
- a workflow run that uses `SalmonPlays/oss-signal@v0.8.3`
|
|
80
83
|
- a linked `oss-signal-report.md` artifact
|
|
81
84
|
- a maintainer reply saying the report was useful, not useful, or intentionally out of scope
|
|
82
85
|
- a merged issue-template, security-policy, CI, or documentation PR informed by the report
|
package/docs/marketplace.md
CHANGED
|
@@ -7,13 +7,13 @@ This checklist records the Marketplace publishing state for `oss-signal`.
|
|
|
7
7
|
- Repository is public.
|
|
8
8
|
- Action metadata exists at the repository root: [../action.yml](../action.yml).
|
|
9
9
|
- The Action metadata uses a unique name: `oss-signal`.
|
|
10
|
-
- The repository has a released Action tag: `v0.8.
|
|
10
|
+
- The repository has a released Action tag: `v0.8.3`.
|
|
11
11
|
- The README contains install, CLI, GitHub Action, SARIF, inventory, workflow-trial, and maintainer workflow examples.
|
|
12
12
|
- The repository has public CI, CodeQL, OpenSSF Scorecard, repository health, repository inventory, and release workflows.
|
|
13
13
|
- The repository includes an MIT [LICENSE](../LICENSE) that should be used as the Action EULA for Marketplace users.
|
|
14
14
|
- GitHub Marketplace Developer Agreement has been reviewed by the repository owner.
|
|
15
15
|
- The GitHub Marketplace listing is published: https://github.com/marketplace/actions/oss-signal
|
|
16
|
-
- The current Action tag is `v0.8.
|
|
16
|
+
- The current Action tag is `v0.8.3`: https://github.com/SalmonPlays/oss-signal/tree/v0.8.3
|
|
17
17
|
|
|
18
18
|
## Marketplace Categories
|
|
19
19
|
|
|
@@ -26,7 +26,7 @@ Secondary category: `Code quality`
|
|
|
26
26
|
Title:
|
|
27
27
|
|
|
28
28
|
```text
|
|
29
|
-
oss-signal v0.8.
|
|
29
|
+
oss-signal v0.8.3
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
Description:
|
|
@@ -25,12 +25,13 @@ The older submission evidence remains valid. The current `latest` npm version si
|
|
|
25
25
|
| `v0.8.0` | npm package, GitHub Release, Action tag | Added no-fail workflow output and trial feedback intake for external maintainers. |
|
|
26
26
|
| `v0.8.1` | npm package, GitHub Release, Action tag | Moved the GitHub Action runtime to Node.js 24 and refreshed SARIF upload examples. |
|
|
27
27
|
| `v0.8.2` | npm package, GitHub Release, Action tag | Updated generated workflows and dogfood workflows to `actions/upload-artifact@v5`. |
|
|
28
|
+
| `v0.8.3` | npm package, GitHub Release, Action tag | Added workflow-level Node.js 24 opt-in to avoid GitHub Actions Node.js 20 deprecation warnings. |
|
|
28
29
|
|
|
29
30
|
## Current Evidence
|
|
30
31
|
|
|
31
|
-
- npm package: https://www.npmjs.com/package/oss-signal (`0.8.
|
|
32
|
-
- GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.8.
|
|
33
|
-
- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.
|
|
32
|
+
- npm package: https://www.npmjs.com/package/oss-signal (`0.8.3` latest after release)
|
|
33
|
+
- GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.8.3
|
|
34
|
+
- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.3
|
|
34
35
|
- Release workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/release.yml
|
|
35
36
|
- Repository health workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/repository-health.yml
|
|
36
37
|
- GitHub repository profile: description, npm homepage, eight maintainer-focused topics, social preview image, and profile pin are live.
|
|
@@ -45,7 +46,7 @@ The older submission evidence remains valid. The current `latest` npm version si
|
|
|
45
46
|
|
|
46
47
|
## Clean Verification
|
|
47
48
|
|
|
48
|
-
The public registry should return `0.8.
|
|
49
|
+
The public registry should return `0.8.3` for both package version and `latest` dist-tag after the workflow runtime opt-in release.
|
|
49
50
|
|
|
50
51
|
```bash
|
|
51
52
|
npm view oss-signal version dist-tags --json
|
|
@@ -55,17 +56,17 @@ Expected result:
|
|
|
55
56
|
|
|
56
57
|
```json
|
|
57
58
|
{
|
|
58
|
-
"version": "0.8.
|
|
59
|
+
"version": "0.8.3",
|
|
59
60
|
"dist-tags": {
|
|
60
|
-
"latest": "0.8.
|
|
61
|
+
"latest": "0.8.3"
|
|
61
62
|
}
|
|
62
63
|
}
|
|
63
64
|
```
|
|
64
65
|
|
|
65
|
-
A clean npm execution against the public GitHub repository should return version `0.8.
|
|
66
|
+
A clean npm execution against the public GitHub repository should return version `0.8.3`, score `100`, grade `A`, and source `github`.
|
|
66
67
|
|
|
67
68
|
```bash
|
|
68
|
-
npm exec --yes --package=oss-signal@0.8.
|
|
69
|
+
npm exec --yes --package=oss-signal@0.8.3 -- oss-signal SalmonPlays/oss-signal --format json
|
|
69
70
|
```
|
|
70
71
|
|
|
71
72
|
## Review Impact
|
|
@@ -73,7 +74,7 @@ npm exec --yes --package=oss-signal@0.8.2 -- oss-signal SalmonPlays/oss-signal -
|
|
|
73
74
|
This version difference should be read as post-submission maintenance progress, not as a mismatch. It strengthens the evidence in three ways:
|
|
74
75
|
|
|
75
76
|
- The package now has a successful npm Trusted Publishing release from GitHub Actions.
|
|
76
|
-
- The GitHub Action tag, npm package, release notes, and documentation all point to `0.8.
|
|
77
|
+
- The GitHub Action tag, npm package, release notes, and documentation all point to `0.8.3`.
|
|
77
78
|
- The repository has public CI, Repository health, Repository inventory, CodeQL, OpenSSF Scorecard, Release workflow evidence, social preview branding, profile pinning, Discussions, CODEOWNERS, and issue routing.
|
|
78
79
|
- The current release includes `--format plan`, which turns audit findings into PR-sized outreach plans before external posting.
|
|
79
80
|
- The current release includes `--format workflow`, which renders a no-fail GitHub Actions trial workflow for external maintainers.
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
`oss-signal` v0.8.3 opts generated and dogfood workflows into the GitHub Actions Node.js 24 runtime.
|
|
2
|
+
|
|
3
|
+
## Changed
|
|
4
|
+
|
|
5
|
+
- Generated no-fail trial workflows now set `FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"` at workflow level.
|
|
6
|
+
- Repository CI, health, inventory, CodeQL, Scorecard, and release workflows now set the same Node.js 24 opt-in.
|
|
7
|
+
- Copyable workflow examples now include the opt-in so first-time users do not inherit GitHub Actions Node.js 20 deprecation warnings.
|
|
8
|
+
|
|
9
|
+
## Verify
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npm ci
|
|
13
|
+
npm run check
|
|
14
|
+
npm publish --dry-run
|
|
15
|
+
node src/cli.js . --format workflow --output docs/examples/maintainer-trial-workflow.yml
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
The release is compatibility-focused and keeps the v0.8 workflow output contract unchanged.
|
|
@@ -6,7 +6,7 @@ This page gives reviewers a short path to verify that `oss-signal` is a real OSS
|
|
|
6
6
|
|
|
7
7
|
## Application Version Note
|
|
8
8
|
|
|
9
|
-
The Codex for Open Source application was submitted on 2026-06-03. The npm package and Action tag continued to move after submission as normal OSS maintenance. If any submitted field references older evidence, treat `0.8.
|
|
9
|
+
The Codex for Open Source application was submitted on 2026-06-03. The npm package and Action tag continued to move after submission as normal OSS maintenance. If any submitted field references older evidence, treat `0.8.3` as the current maintained release and see [post-submission-update.md](post-submission-update.md).
|
|
10
10
|
|
|
11
11
|
## Five-Minute Verification
|
|
12
12
|
|
|
@@ -16,12 +16,12 @@ The Codex for Open Source application was submitted on 2026-06-03. The npm packa
|
|
|
16
16
|
npm view oss-signal version dist-tags --json
|
|
17
17
|
```
|
|
18
18
|
|
|
19
|
-
Expected result: `version` is `0.8.
|
|
19
|
+
Expected result: `version` is `0.8.3`, and `dist-tags.latest` is `0.8.3`.
|
|
20
20
|
|
|
21
21
|
2. Run the published package against the public repository:
|
|
22
22
|
|
|
23
23
|
```bash
|
|
24
|
-
npm exec --yes --package=oss-signal@0.8.
|
|
24
|
+
npm exec --yes --package=oss-signal@0.8.3 -- oss-signal SalmonPlays/oss-signal --format json
|
|
25
25
|
```
|
|
26
26
|
|
|
27
27
|
Expected result: score `100`, grade `A`, source `github`.
|
|
@@ -64,8 +64,8 @@ Expected result: a Markdown table with one row per repository, average score, sc
|
|
|
64
64
|
|
|
65
65
|
5. Inspect the public Action tag:
|
|
66
66
|
|
|
67
|
-
- Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.
|
|
68
|
-
- Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.8.
|
|
67
|
+
- Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.3
|
|
68
|
+
- Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.8.3
|
|
69
69
|
- Action metadata: [../action.yml](../action.yml)
|
|
70
70
|
|
|
71
71
|
6. Inspect field-audit evidence:
|
package/docs/roadmap.md
CHANGED
|
@@ -12,7 +12,7 @@ This roadmap focuses on the next maintainer workflows that would make `oss-signa
|
|
|
12
12
|
|
|
13
13
|
| Area | Goal | Evidence target |
|
|
14
14
|
| --- | --- | --- |
|
|
15
|
-
| Adoption | Help one external maintainer run `SalmonPlays/oss-signal@v0.8.
|
|
15
|
+
| Adoption | Help one external maintainer run `SalmonPlays/oss-signal@v0.8.3` in a public workflow or leave concrete trial feedback. | [Issue #8](https://github.com/SalmonPlays/oss-signal/issues/8), [maintainer-trial.md](maintainer-trial.md), [maintainer-feedback.md](maintainer-feedback.md), then linked workflow run or maintainer reply in [adoption-evidence.md](adoption-evidence.md). |
|
|
16
16
|
| Automation | Document a stable JSON schema for consumers that parse `--format json`. | Completed in [Issue #9](https://github.com/SalmonPlays/oss-signal/issues/9), [json-output.md](json-output.md), [schema](schema/json-output.schema.json), and [fixture](examples/github-url-report.json). |
|
|
17
17
|
| Code Scanning | Add a complete screenshot-backed SARIF walkthrough. | Completed in [Issue #10](https://github.com/SalmonPlays/oss-signal/issues/10), [sarif-code-scanning.md](sarif-code-scanning.md), and [output example](assets/code-scanning-results.svg). |
|
|
18
18
|
| Outreach | Convert audit findings into PR-sized maintainer plans before posting externally. | Implemented in `--format plan`, [plan-output.md](plan-output.md), and [examples/github-plan.md](examples/github-plan.md). |
|
|
@@ -18,12 +18,15 @@ permissions:
|
|
|
18
18
|
contents: read
|
|
19
19
|
security-events: write
|
|
20
20
|
|
|
21
|
+
env:
|
|
22
|
+
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
|
|
23
|
+
|
|
21
24
|
jobs:
|
|
22
25
|
oss-signal:
|
|
23
26
|
runs-on: ubuntu-latest
|
|
24
27
|
steps:
|
|
25
|
-
- uses: actions/checkout@
|
|
26
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
28
|
+
- uses: actions/checkout@v5
|
|
29
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
27
30
|
with:
|
|
28
31
|
format: sarif
|
|
29
32
|
output: oss-signal.sarif
|
package/docs/security-model.md
CHANGED
|
@@ -46,7 +46,7 @@ SARIF output reports maintainer-readiness findings at warning level. These findi
|
|
|
46
46
|
## Supply Chain
|
|
47
47
|
|
|
48
48
|
- The npm package is published publicly as `oss-signal`.
|
|
49
|
-
- The GitHub Action is pinned by release tag, for example `SalmonPlays/oss-signal@v0.8.
|
|
49
|
+
- The GitHub Action is pinned by release tag, for example `SalmonPlays/oss-signal@v0.8.3`.
|
|
50
50
|
- The release workflow checks the package version against the release tag before publishing.
|
|
51
51
|
- The repository runs CI, CodeQL, OpenSSF Scorecard, repository health, and repository inventory workflows on `main`.
|
|
52
52
|
|
package/docs/self-audit.md
CHANGED
package/docs/social-launch.md
CHANGED
|
@@ -85,7 +85,7 @@ https://github.com/SalmonPlays/oss-signal
|
|
|
85
85
|
## GitHub Discussion Announcement
|
|
86
86
|
|
|
87
87
|
```markdown
|
|
88
|
-
`oss-signal` v0.8.
|
|
88
|
+
`oss-signal` v0.8.3 is live on npm and GitHub Marketplace.
|
|
89
89
|
|
|
90
90
|
The tool is built for OSS maintainers and contributors who want a small, repeatable way to check maintainer-readiness signals before opening cleanup issues or PRs.
|
|
91
91
|
|
package/docs/trust-center.md
CHANGED
|
@@ -11,7 +11,7 @@ This page collects the strongest public signals for reviewers, maintainers, and
|
|
|
11
11
|
What it does have is a complete, public maintainer workflow:
|
|
12
12
|
|
|
13
13
|
- Public npm package: https://www.npmjs.com/package/oss-signal
|
|
14
|
-
- Public GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.
|
|
14
|
+
- Public GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.3
|
|
15
15
|
- Public GitHub Marketplace listing: https://github.com/marketplace/actions/oss-signal
|
|
16
16
|
- Public GitHub Pages landing page: https://salmonplays.github.io/oss-signal/
|
|
17
17
|
- Public no-fail maintainer trial workflow: [maintainer-trial.md](maintainer-trial.md)
|
|
@@ -27,7 +27,7 @@ What it does have is a complete, public maintainer workflow:
|
|
|
27
27
|
|
|
28
28
|
| Signal | Public evidence | Why it matters |
|
|
29
29
|
| --- | --- | --- |
|
|
30
|
-
| Installable CLI | `npm exec --yes --package=oss-signal@0.8.
|
|
30
|
+
| Installable CLI | `npm exec --yes --package=oss-signal@0.8.3 -- oss-signal SalmonPlays/oss-signal --format json` | Reviewers can run the package without cloning this repository. |
|
|
31
31
|
| Marketplace Action | https://github.com/marketplace/actions/oss-signal | Users can discover and copy the Action through GitHub Marketplace. |
|
|
32
32
|
| Maintainer trial | [maintainer-trial](maintainer-trial.md) | External maintainers can try the Action without failing CI first. |
|
|
33
33
|
| Maintainer feedback | [maintainer-feedback](maintainer-feedback.md) | Neutral or negative maintainer responses can still improve rules and count as real third-party feedback. |
|
|
@@ -48,7 +48,7 @@ What it does have is a complete, public maintainer workflow:
|
|
|
48
48
|
The GitHub Marketplace listing is a discovery page for the Action. It lets users find `oss-signal`, inspect the Action metadata and README, and copy a workflow snippet using:
|
|
49
49
|
|
|
50
50
|
```yaml
|
|
51
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
51
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
52
52
|
```
|
|
53
53
|
|
|
54
54
|
The listing is not a paid product. It is a free Action listing. Running GitHub Actions has separate GitHub Actions billing rules, but standard GitHub-hosted runners are free for public repositories.
|
package/package.json
CHANGED
package/src/index.js
CHANGED
|
@@ -2,7 +2,7 @@ import { promises as fs } from "node:fs";
|
|
|
2
2
|
import https from "node:https";
|
|
3
3
|
import path from "node:path";
|
|
4
4
|
|
|
5
|
-
export const VERSION = "0.8.
|
|
5
|
+
export const VERSION = "0.8.3";
|
|
6
6
|
|
|
7
7
|
const SARIF_RULE_LOCATIONS = {
|
|
8
8
|
readme: "README.md",
|
|
@@ -396,12 +396,15 @@ on:
|
|
|
396
396
|
permissions:
|
|
397
397
|
contents: read
|
|
398
398
|
|
|
399
|
+
env:
|
|
400
|
+
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
|
|
401
|
+
|
|
399
402
|
jobs:
|
|
400
403
|
audit:
|
|
401
404
|
runs-on: ubuntu-latest
|
|
402
405
|
steps:
|
|
403
406
|
- uses: actions/checkout@v5
|
|
404
|
-
- uses: SalmonPlays/oss-signal@v0.8.
|
|
407
|
+
- uses: SalmonPlays/oss-signal@v0.8.3
|
|
405
408
|
id: oss-signal
|
|
406
409
|
with:
|
|
407
410
|
output: oss-signal-report.md
|