oss-signal 0.7.0 → 0.8.0

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.
Files changed (40) hide show
  1. package/CHANGELOG.md +5 -0
  2. package/README.md +36 -22
  3. package/action.yml +2 -2
  4. package/docs/adoption-evidence.md +32 -25
  5. package/docs/adoption-kit.md +15 -5
  6. package/docs/assets/code-scanning-results.svg +1 -1
  7. package/docs/assets/oss-signal-banner.svg +1 -1
  8. package/docs/brand.md +1 -1
  9. package/docs/codex-for-oss-application.md +33 -24
  10. package/docs/codex-for-oss-form-answers.md +12 -7
  11. package/docs/evidence-ledger.md +46 -0
  12. package/docs/examples/github-action-workflow.yml +2 -2
  13. package/docs/examples/github-code-scanning-workflow.yml +4 -4
  14. package/docs/examples/github-inventory-workflow.yml +2 -2
  15. package/docs/examples/github-url-report.json +4 -4
  16. package/docs/examples/github-url-report.md +1 -1
  17. package/docs/examples/maintainer-trial-workflow.yml +24 -0
  18. package/docs/examples/self-audit.sarif +2 -2
  19. package/docs/index.md +8 -4
  20. package/docs/maintainer-feedback.md +54 -0
  21. package/docs/maintainer-playbook.md +4 -4
  22. package/docs/maintainer-trial.md +111 -0
  23. package/docs/marketplace.md +6 -5
  24. package/docs/outreach/README.md +2 -2
  25. package/docs/outreach/divyesh-5981-signal-oss-issue-draft.md +9 -1
  26. package/docs/outreach/divyesh-5981-signal-oss-report.md +1 -2
  27. package/docs/outreach/noctemlabs-signal-oss-issue-draft.md +2 -0
  28. package/docs/outreach/peer-shortlist-2026-06.md +5 -4
  29. package/docs/post-submission-update.md +16 -11
  30. package/docs/release-notes/v0.8.0.md +18 -0
  31. package/docs/reviewer-evidence.md +19 -9
  32. package/docs/roadmap.md +3 -1
  33. package/docs/sarif-code-scanning.md +1 -1
  34. package/docs/security-model.md +1 -1
  35. package/docs/social-launch.md +151 -0
  36. package/docs/trust-center.md +13 -6
  37. package/package.json +2 -2
  38. package/src/action.js +7 -3
  39. package/src/cli.js +8 -3
  40. package/src/index.js +29 -1
package/CHANGELOG.md CHANGED
@@ -2,6 +2,11 @@
2
2
 
3
3
  ## Unreleased
4
4
 
5
+ ## 0.8.0
6
+
7
+ - Added `--format workflow` for generating a no-fail GitHub Actions trial workflow.
8
+ - Added maintainer feedback intake so neutral or negative third-party responses can improve the rules without being overstated as adoption.
9
+
5
10
  ## 0.7.0
6
11
 
7
12
  - 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
  [![Maintainer evidence](https://img.shields.io/badge/maintainer_evidence-public-blue.svg)](docs/reviewer-evidence.md)
16
16
  [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](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, and issue-ready cleanup notes.
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, or PR-sized maintainer plan formats.
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
  ![oss-signal example output](docs/assets/terminal-report.svg)
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.7.0`](https://www.npmjs.com/package/oss-signal), with `latest` pointing at `0.7.0`.
30
- - Published GitHub Action: [`SalmonPlays/oss-signal@v0.7.0`](https://github.com/SalmonPlays/oss-signal/tree/v0.7.0).
29
+ - Published package: [`oss-signal@0.8.0`](https://www.npmjs.com/package/oss-signal), with `latest` pointing at `0.8.0`.
30
+ - Published GitHub Action: [`SalmonPlays/oss-signal@v0.8.0`](https://github.com/SalmonPlays/oss-signal/tree/v0.8.0).
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.7.0` is the current maintained release and is documented in [docs/post-submission-update.md](docs/post-submission-update.md).
44
+ - Post-submission version note: the application may reference earlier evidence; `0.8.0` 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: five public maintainer-readiness audits have been turned into five issues and four focused follow-up PRs.
48
- - External OSS contribution: [icoretech/codex-action PR #24](https://github.com/icoretech/codex-action/pull/24) is a focused Codex Action documentation safety fix.
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/26883001038) runs the public Action tag and uploads Markdown, SARIF, and Issue-ready artifacts.
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.7.0`, 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.
196
+ The [Repository health workflow](.github/workflows/repository-health.yml) runs `SalmonPlays/oss-signal@v0.8.0`, 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.5.1` and produced a successful [workflow run](https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26883001038) with Markdown, SARIF, and Issue-ready report artifacts.
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.7.0
247
+ - uses: SalmonPlays/oss-signal@v0.8.0
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.7.0
263
+ - uses: SalmonPlays/oss-signal@v0.8.0
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.7.0
275
+ - uses: SalmonPlays/oss-signal@v0.8.0
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@v4
283
- - uses: SalmonPlays/oss-signal@v0.7.0
296
+ - uses: actions/checkout@v5
297
+ - uses: SalmonPlays/oss-signal@v0.8.0
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@v4
306
- - uses: SalmonPlays/oss-signal@v0.7.0
319
+ - uses: actions/checkout@v5
320
+ - uses: SalmonPlays/oss-signal@v0.8.0
307
321
  with:
308
322
  format: sarif
309
323
  output: oss-signal.sarif
310
324
  summary: "true"
311
- - uses: github/codeql-action/upload-sarif@v3
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.7.0` against the repository, uploads the Markdown report artifact, and publishes SARIF to Code Scanning on non-PR runs.
330
+ This repository dogfoods the public Action tag in [Repository health](.github/workflows/repository-health.yml), which runs `SalmonPlays/oss-signal@v0.8.0` 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, and issue-ready cleanup notes.
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 plan. Inventory mode supports markdown or json.
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:
@@ -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-04T11:14:41Z
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.7.0` latest)
12
- - GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.7.0
13
- - GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.7.0
11
+ - npm package: https://www.npmjs.com/package/oss-signal (`0.8.0` latest)
12
+ - GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.8.0
13
+ - GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.0
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/26883001038
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.7.0` with `latest` pointing at `0.7.0`.
72
+ The npm package is publicly available as `oss-signal@0.8.0` with `latest` pointing at `0.8.0`.
68
73
 
69
- The npm downloads API returned 356 downloads for both last-week and last-month windows on 2026-06-04. Download counts can lag publication, so this is treated as supporting evidence rather than proof of broad adoption.
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.7.0",
80
+ "version": "0.8.0",
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 for the `v0.7.0` Action release
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.0` 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
- After the v0.7.0 release, the npm registry should return `0.7.0` for both the package version and `latest` dist-tag. The earlier 2026-06-04 download check returned 356 downloads for the last-week and last-month windows.
105
+ The npm registry returned `0.8.0` for both the package version and `latest` dist-tag on 2026-06-05T09:57:04Z. A clean install smoke test returned version `0.8.0`, 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.5.1` from a separate workflow file:
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/26883001038
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 the public `v0.5.1` Action tag works outside the main repository and can publish Markdown, SARIF, and Issue-ready maintainer-readiness reports from another public workflow.
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, clean |
119
- | `supermarkt/checkjebon` | [report](outreach/supermarkt-checkjebon-report.md) | https://github.com/supermarkt/checkjebon/issues/22 | https://github.com/supermarkt/checkjebon/pull/23 | open, clean |
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, checks pending |
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 GitHub templates.
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
- All field-audit follow-up PRs were still open when checked from GitHub on 2026-06-04T10:38:39Z. They are not claimed as accepted adoption unless a maintainer merges or otherwise endorses them.
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 discuss reports without inventing the format.
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.7.0 -- oss-signal SalmonPlays/oss-signal --format json
168
+ npm exec --yes --package=oss-signal@0.8.0 -- 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.7.0` Action tag is used by the repository health workflow for Markdown and SARIF output. The published npm `0.7.0` package has also been executed from a clean temporary directory against the public GitHub repository, returning 100/100 (A).
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.0` Action tag is used by the repository health workflow for Markdown and SARIF output. The published npm `0.8.0` 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/26883001038
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
@@ -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.7.0 -- oss-signal owner/repo --format markdown --output oss-signal-report.md
12
+ npm exec --yes --package=oss-signal@0.8.0 -- 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.7.0
53
+ - uses: SalmonPlays/oss-signal@v0.8.0
44
54
  id: oss-signal
45
55
  with:
46
56
  fail-under: "80"
@@ -61,7 +71,7 @@ permissions:
61
71
 
62
72
  steps:
63
73
  - uses: actions/checkout@v4
64
- - uses: SalmonPlays/oss-signal@v0.7.0
74
+ - uses: SalmonPlays/oss-signal@v0.8.0
65
75
  with:
66
76
  format: sarif
67
77
  output: oss-signal.sarif
@@ -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.7.0`.
90
+ - A workflow run that uses `SalmonPlays/oss-signal@v0.8.0`.
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.7.0</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.0</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.7.0</text>
37
+ <text x="521" y="293" fill="#1e40af">npm 0.8.0</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, and issue-ready cleanup.
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-04T23:25:29Z
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.7.0
13
- - GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.7.0
12
+ - GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.8.0
13
+ - GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.8.0
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/26883001038
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.7.0` as the latest release.
56
+ - A published npm package with `0.8.0` 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-04.
56
- - A published GitHub Release for v0.7.0 with maintainer plan output, CI usage guidance, and release notes.
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.0 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.7.0` returning version `0.7.0`, score `100`, grade `A`, and source `github`.
62
+ - A clean npm smoke test of `oss-signal@0.8.0` returning version `0.8.0`, score `100`, grade `A`, and source `github`.
60
63
  - SARIF output for GitHub Code Scanning integration.
61
- - A v0.7.0 GitHub Action tag with step summary, SARIF support, inventory support, Issue-ready output, and maintainer plan output.
62
- - A public dogfood workflow that runs `SalmonPlays/oss-signal@v0.7.0` against the repository, uploads the Markdown report artifact, and uploads SARIF to GitHub Code Scanning on non-PR runs.
63
- - A public dogfood inventory workflow that runs `SalmonPlays/oss-signal@v0.7.0` against a repository target list and uploads an inventory artifact.
64
- - A separate public workflow demo that runs `SalmonPlays/oss-signal@v0.5.1` from another repository and uploads Markdown, SARIF, and Issue-ready report artifacts.
64
+ - A v0.8.0 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.0` 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.0` 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.7.0 -- oss-signal SalmonPlays/oss-signal --format json`, returning 100/100 (A).
70
- - Public reports, issues, and PRs created from real repository audits, including five posted field-audit issues and four follow-up PRs.
75
+ - A clean-directory smoke test of `npm exec --yes --package=oss-signal@0.8.0 -- 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.5.1` Action tag from a separate workflow. The successful run at https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26883001038 uploaded an `oss-signal-adoption-demo-report` artifact containing Markdown, SARIF, and Issue-ready output.
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, clean |
83
- | `supermarkt/checkjebon` | [report](outreach/supermarkt-checkjebon-report.md) | https://github.com/supermarkt/checkjebon/issues/22 | https://github.com/supermarkt/checkjebon/pull/23 | open, clean |
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, checks pending |
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 or GitHub templates rather than changing product code.
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, five public field-audit issues, and four public field-audit PRs. Codex support would be used to continue auditing repositories, prepare focused maintainer PRs, improve Action automation, and document repeatable OSS maintenance workflows.
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
- - External PRs are open but not yet merged.
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
- - One or more merged external PRs.
107
- - A public workflow run in an independent maintainer-owned repository using `SalmonPlays/oss-signal@v0.7.0`, ideally with SARIF or inventory upload enabled.
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.0`, ideally with SARIF or inventory upload enabled.
108
117
  - npm download data once the registry starts reporting weekly/monthly counts.