oss-signal 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -2,11 +2,27 @@
 
 ## Unreleased
 
-- Added a maintainer playbook for audit-to-issue, PR, CI gate, and SARIF workflows.
-- Added a documented release process and tag-triggered release workflow with npm dry-run verification.
+## 0.6.0
+
+- Added repository inventory mode for auditing newline-delimited lists of local paths, GitHub URLs, and `owner/repo` shorthands.
+- Added GitHub Action inventory support with step summary output and average-score Action outputs.
+- Added inventory examples, reviewer verification steps, and maintainer playbook guidance.
+
+## 0.5.1
+
+- Published the Issue-ready output release on a clean tag after release workflow hardening.
+- Guarded automatic npm publishing behind an explicit repository variable.
+
+## 0.5.0
+
+- Added `--format issue` for generating human-reviewed GitHub Issue bodies from audit findings.
+- Added an issue-output example and maintainer playbook guidance for audit-to-issue workflows.
 
 ## 0.4.0
 
+- Added a maintainer playbook for audit-to-issue, PR, CI gate, and SARIF workflows.
+- Added a documented release process and tag-triggered release workflow with npm dry-run verification.
+
 - Added SARIF output for GitHub Code Scanning and other security dashboards.
 - Added Action support for `format: sarif`.
 

package/README.md

@@ -9,10 +9,22 @@
 
 `oss-signal` is a dependency-light CLI for auditing open-source repository maintenance readiness.
 
-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, or SARIF.
+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, or a GitHub Issue-ready Markdown body.
 
 ![oss-signal example output](docs/assets/terminal-report.svg)
 
+## Maintainer Evidence Snapshot
+
+Public evidence for the maintainer workflow is collected in [docs/reviewer-evidence.md](docs/reviewer-evidence.md) and [docs/adoption-evidence.md](docs/adoption-evidence.md).
+
+- Published package: [`oss-signal@0.6.0`](https://www.npmjs.com/package/oss-signal), with `latest` pointing at `0.6.0`.
+- Published GitHub Action: [`SalmonPlays/oss-signal@v0.6.0`](https://github.com/SalmonPlays/oss-signal/tree/v0.6.0).
+- Public checks: CI, Repository health, and CodeQL are passing on `main`.
+- Self-audit: this repository scores **100/100 (A)** locally and through GitHub URL mode.
+- Field use: four public maintainer-readiness audits have been turned into four issues and four focused follow-up PRs.
+- Inventory mode: the CLI and Action can audit a newline-delimited list of repositories for organization-level triage.
+- 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.
+
 ## Why
 
 Open-source projects often fail quietly because the maintainer workflow is undocumented. `oss-signal` gives maintainers a repeatable checklist they can run locally, in CI, or before asking contributors to help.
@@ -75,6 +87,14 @@ Use JSON in automation:
 oss-signal . --format json --fail-under 80
 ```
 
+Audit multiple repositories from one newline-delimited inventory file:
+
+```bash
+oss-signal --inventory docs/examples/inventory-targets.txt --format markdown --output inventory-report.md
+```
+
+See [docs/examples/inventory-report.md](docs/examples/inventory-report.md) for a generated inventory report.
+
 Write SARIF for GitHub Code Scanning or other dashboards:
 
 ```bash
@@ -87,6 +107,12 @@ Generate a report that can be attached to an issue:
 oss-signal . --format markdown --output docs/maintainer-readiness.md
 ```
 
+Generate a maintainer-friendly issue body:
+
+```bash
+oss-signal platformatic/massimo --format issue --output maintainer-follow-up.md
+```
+
 ## Checks
 
 `oss-signal` currently checks:
@@ -97,7 +123,7 @@ oss-signal . --format markdown --output docs/maintainer-readiness.md
 
 See [docs/rules.md](docs/rules.md) for rule details and scoring weights.
 
-SARIF output reports failed maintainer-readiness checks as warning-level results. This lets teams upload the audit to code scanning dashboards while keeping the Markdown report available for maintainers.
+SARIF output reports failed maintainer-readiness checks as warning-level results. This lets teams upload the audit to code scanning dashboards while keeping the Markdown report available for maintainers. Issue output turns the same findings into a human-reviewed checklist that can be edited before posting.
 
 For GitHub URL audits, `oss-signal` reads the repository file tree through the GitHub API and also uses GitHub's community profile signal when available. This lets it detect organization-level files such as a shared code of conduct.
 
@@ -114,21 +140,24 @@ Summary:
 - Total checks: 15
 ```
 
-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, and [docs/examples/self-audit.sarif](docs/examples/self-audit.sarif) for SARIF output.
+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, and [docs/examples/self-audit.sarif](docs/examples/self-audit.sarif) for SARIF output.
 
-The [Repository health workflow](.github/workflows/repository-health.yml) runs `SalmonPlays/oss-signal@v0.4.0`, uploads the Markdown report as an artifact, and uploads SARIF to GitHub Code Scanning on non-PR runs.
+The [Repository health workflow](.github/workflows/repository-health.yml) runs `SalmonPlays/oss-signal@v0.6.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.
 
 ## Field Audits
 
-`oss-signal` has been run against public repositories to produce maintainer-readiness reports and respectful issue drafts:
+`oss-signal` has been run against public repositories to produce maintainer-readiness reports, respectful issue drafts, and focused follow-up PRs:
 
-- [platformatic/massimo report](docs/outreach/platformatic-massimo-report.md) and [issue #159](https://github.com/platformatic/massimo/issues/159)
-- [supermarkt/checkjebon report](docs/outreach/supermarkt-checkjebon-report.md) and [issue #22](https://github.com/supermarkt/checkjebon/issues/22)
-- [sammorrisdesign/interactive-feed report](docs/outreach/sammorrisdesign-interactive-feed-report.md) and [issue #14](https://github.com/sammorrisdesign/interactive-feed/issues/14)
+- [platformatic/massimo report](docs/outreach/platformatic-massimo-report.md), [issue #159](https://github.com/platformatic/massimo/issues/159), and [PR #160](https://github.com/platformatic/massimo/pull/160)
+- [supermarkt/checkjebon report](docs/outreach/supermarkt-checkjebon-report.md), [issue #22](https://github.com/supermarkt/checkjebon/issues/22), and [PR #23](https://github.com/supermarkt/checkjebon/pull/23)
+- [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)
+- [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)
 
 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.
 
-For a compact maintainer/adoption summary, see [docs/adoption-evidence.md](docs/adoption-evidence.md).
+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).
+
+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.
 
 ## Example Recommendation Output
 
@@ -157,7 +186,7 @@ oss-signal . --fail-under 80
 Add `oss-signal` directly to a GitHub Actions workflow:
 
 ```yaml
-- uses: SalmonPlays/oss-signal@v0.4.0
+- uses: SalmonPlays/oss-signal@v0.6.0
   id: oss-signal
   with:
     fail-under: "80"
@@ -170,6 +199,28 @@ The Action writes a concise GitHub Actions step summary by default, so reviewers
 
 ![oss-signal GitHub Actions summary](docs/assets/github-step-summary.svg)
 
+Run an inventory from CI:
+
+```yaml
+- uses: SalmonPlays/oss-signal@v0.6.0
+  env:
+    GITHUB_TOKEN: ${{ github.token }}
+  with:
+    inventory: docs/examples/inventory-targets.txt
+    output: inventory-report.md
+    summary: "true"
+```
+
+Generate an editable Issue body from CI:
+
+```yaml
+- uses: SalmonPlays/oss-signal@v0.6.0
+  with:
+    format: issue
+    output: maintainer-follow-up.md
+    summary: "true"
+```
+
 Full workflow example:
 
 ```yaml
@@ -185,7 +236,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: SalmonPlays/oss-signal@v0.4.0
+      - uses: SalmonPlays/oss-signal@v0.6.0
         id: oss-signal
         with:
           fail-under: "80"
@@ -197,7 +248,7 @@ jobs:
           path: oss-signal-report.md
 ```
 
-See [docs/examples/github-action-workflow.yml](docs/examples/github-action-workflow.yml) for a copyable workflow and [docs/examples/github-code-scanning-workflow.yml](docs/examples/github-code-scanning-workflow.yml) for a workflow that uploads SARIF to GitHub Code Scanning.
+See [docs/examples/github-action-workflow.yml](docs/examples/github-action-workflow.yml) for a copyable workflow, [docs/examples/github-inventory-workflow.yml](docs/examples/github-inventory-workflow.yml) for an inventory workflow, and [docs/examples/github-code-scanning-workflow.yml](docs/examples/github-code-scanning-workflow.yml) for a workflow that uploads SARIF to GitHub Code Scanning.
 
 Upload SARIF to GitHub Code Scanning:
 
@@ -208,7 +259,7 @@ permissions:
 
 steps:
   - uses: actions/checkout@v4
-  - uses: SalmonPlays/oss-signal@v0.4.0
+  - uses: SalmonPlays/oss-signal@v0.6.0
     with:
       format: sarif
       output: oss-signal.sarif
@@ -218,7 +269,7 @@ steps:
       sarif_file: oss-signal.sarif
 ```
 
-This repository dogfoods the public Action tag in [Repository health](.github/workflows/repository-health.yml), which runs `SalmonPlays/oss-signal@v0.4.0` against the repository, uploads the Markdown report artifact, and publishes SARIF to Code Scanning on non-PR runs.
+This repository dogfoods the public Action tag in [Repository health](.github/workflows/repository-health.yml), which runs `SalmonPlays/oss-signal@v0.6.0` against the repository, uploads the Markdown report artifact, and publishes SARIF to Code Scanning on non-PR runs.
 
 You can also run the CLI directly in CI:
 
@@ -237,7 +288,7 @@ You can also run the CLI directly in CI:
 - Ecosystem-specific profiles for Python, Rust, Go, and JavaScript packages
 - Release automation and provenance metadata checks
 - Maintainer score trends over time
-- Organization-level repository inventory reports
+- Organization-level repository inventory dashboards
 
 ## Release Process
 

package/action.yml

@@ -9,8 +9,11 @@ inputs:
     description: Local repository path, GitHub URL, or owner/repo shorthand to audit.
     required: false
     default: "."
+  inventory:
+    description: Newline-delimited file of local paths, GitHub URLs, or owner/repo shorthands to audit as an inventory.
+    required: false
   format:
-    description: Output format, either markdown, json, or sarif.
+    description: Output format, either markdown, json, sarif, or issue. Inventory mode supports markdown or json.
     required: false
     default: markdown
   output:
@@ -22,7 +25,7 @@ inputs:
     required: false
     default: "true"
   fail-under:
-    description: Fail the action when the score is below this number.
+    description: Fail the action when the score, or any inventory target score, is below this number.
     required: false
   max-files:
     description: Maximum files to inspect.
@@ -33,11 +36,11 @@ inputs:
     required: false
 outputs:
   score:
-    description: Numeric maintainer-readiness score.
+    description: Numeric maintainer-readiness score, or average score in inventory mode.
   grade:
-    description: Letter grade for the maintainer-readiness score.
+    description: Letter grade for the maintainer-readiness score, or average grade in inventory mode.
   failed:
-    description: Number of failed checks.
+    description: Number of failed checks, or total failed checks in inventory mode.
   report-path:
     description: Path to the generated report file, when output is enabled.
 runs:

package/docs/adoption-evidence.md

@@ -2,21 +2,30 @@
 
 This page collects the public evidence that `oss-signal` is built for real open-source maintainer workflows.
 
+Last verified: 2026-06-03T12:45:11Z
+
 ## Project Links
 
 - Repository: https://github.com/SalmonPlays/oss-signal
-- npm package: https://www.npmjs.com/package/oss-signal (`0.3.0` latest)
-- GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.4.0
-- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.4.0
+- npm package: https://www.npmjs.com/package/oss-signal (`0.6.0` latest)
+- GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.6.0
+- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.6.0
 - GitHub Action metadata: [action.yml](../action.yml)
 - Public dogfood workflow: [.github/workflows/repository-health.yml](../.github/workflows/repository-health.yml)
+- Public inventory workflow: [.github/workflows/repository-inventory.yml](../.github/workflows/repository-inventory.yml)
+- Separate public workflow demo: https://github.com/SalmonPlays/oss-signal-adoption-demo
+- Separate public workflow run: https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26883001038
 - Self-audit report: [docs/self-audit.md](self-audit.md)
 - SARIF self-audit output: [docs/examples/self-audit.sarif](examples/self-audit.sarif)
 - GitHub URL audit report: [docs/examples/github-url-report.md](examples/github-url-report.md)
 - GitHub Action workflow example: [docs/examples/github-action-workflow.yml](examples/github-action-workflow.yml)
+- Inventory target example: [docs/examples/inventory-targets.txt](examples/inventory-targets.txt)
+- Inventory report example: [docs/examples/inventory-report.md](examples/inventory-report.md)
 - Maintainer playbook: [docs/maintainer-playbook.md](maintainer-playbook.md)
+- Reviewer evidence quickstart: [docs/reviewer-evidence.md](reviewer-evidence.md)
 - Release process: [docs/release-process.md](release-process.md)
 - Codex for Open Source application brief: [docs/codex-for-oss-application.md](codex-for-oss-application.md)
+- Codex for Open Source form answers: [docs/codex-for-oss-form-answers.md](codex-for-oss-form-answers.md)
 - Rule reference: [docs/rules.md](rules.md)
 
 ## Maintainer Use Case
@@ -27,23 +36,64 @@ The CLI supports two practical modes:
 
 - Local repository audit for maintainers working in a clone.
 - Public GitHub repository audit for quick triage without cloning.
+- Repository inventory audit for maintainers comparing several repositories at once.
 
-It also ships as a GitHub Action, so maintainers can gate repository hygiene in CI, show the result in the GitHub Actions step summary, upload a Markdown report as a workflow artifact, and upload failed maintainer-readiness checks as SARIF for GitHub Code Scanning. This repository dogfoods the public Action tag through the Repository health workflow.
+It also ships as a GitHub Action, so maintainers can gate repository hygiene in CI, show the result in the GitHub Actions step summary, upload a Markdown report as a workflow artifact, run inventory reports, and upload failed maintainer-readiness checks as SARIF for GitHub Code Scanning. This repository dogfoods the public Action tag through the Repository health and Repository inventory workflows.
 
 The [maintainer playbook](maintainer-playbook.md) documents the end-to-end workflow from audit to issue, pull request, CI gate, and Code Scanning evidence. The [release process](release-process.md) documents pre-release verification, tag consistency, npm publish checks, and post-release smoke tests.
 
+## Published Package Verification
+
+The npm package is publicly available as `oss-signal@0.6.0` with `latest` pointing at `0.6.0`.
+
+The npm downloads API returned 356 downloads for both last-week and last-month windows on 2026-06-03. Download counts can lag publication, so this is treated as supporting evidence rather than proof of broad adoption.
+
+Clean-directory execution against the public GitHub repository returned:
+
+```json
+{
+  "version": "0.6.0",
+  "score": 100,
+  "grade": "A",
+  "source": "github"
+}
+```
+
+Current public workflow status:
+
+- CI: passing
+- Repository health: passing
+- CodeQL: passing
+- Release: passing
+- Separate public workflow demo: passing
+
+The npm registry returned `0.6.0` for both the package version and `latest` dist-tag on 2026-06-03T12:45:11Z. The same check returned 356 downloads for the last-week and last-month windows.
+
+## Separate Public Workflow Evidence
+
+The public repository https://github.com/SalmonPlays/oss-signal-adoption-demo runs `SalmonPlays/oss-signal@v0.5.1` from a separate workflow file:
+
+- Workflow file: https://github.com/SalmonPlays/oss-signal-adoption-demo/blob/main/.github/workflows/oss-signal.yml
+- Successful workflow run: https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26883001038
+- Artifact: `oss-signal-adoption-demo-report`, containing `oss-signal-report.md`, `oss-signal.sarif`, and `maintainer-follow-up.md`
+
+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.
+
 ## Public Field Audits And PRs
 
 The tool has been used to generate maintainer-readiness reports for public repositories and convert them into respectful cleanup issues:
 
-| Repository | Report | Posted issue | Follow-up PR |
-| --- | --- | --- | --- |
-| `platformatic/massimo` | [report](outreach/platformatic-massimo-report.md) | https://github.com/platformatic/massimo/issues/159 | https://github.com/platformatic/massimo/pull/160 |
-| `supermarkt/checkjebon` | [report](outreach/supermarkt-checkjebon-report.md) | https://github.com/supermarkt/checkjebon/issues/22 | https://github.com/supermarkt/checkjebon/pull/23 |
-| `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 |
+| Repository | Report | Posted issue | Follow-up PR | Status |
+| --- | --- | --- | --- | --- |
+| `platformatic/massimo` | [report](outreach/platformatic-massimo-report.md) | https://github.com/platformatic/massimo/issues/159 | https://github.com/platformatic/massimo/pull/160 | open, clean |
+| `supermarkt/checkjebon` | [report](outreach/supermarkt-checkjebon-report.md) | https://github.com/supermarkt/checkjebon/issues/22 | https://github.com/supermarkt/checkjebon/pull/23 | open, clean |
+| `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 |
+| `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 |
 
 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.
 
+All four follow-up PRs were still open when checked from GitHub on 2026-06-03T12:33:45Z. They are not claimed as accepted adoption unless a maintainer merges or otherwise endorses them.
+
 ## Verification Commands
 
 From this repository:
@@ -52,17 +102,20 @@ From this repository:
 npm run check
 npm run audit:github
 node src/cli.js . --format sarif --output docs/examples/self-audit.sarif
+node src/cli.js --inventory docs/examples/inventory-targets.txt --format markdown --output docs/examples/inventory-report.md
 node src/cli.js platformatic/massimo --format json
-npx --yes oss-signal@0.3.0 SalmonPlays/oss-signal --format json
+npm exec --yes --package=oss-signal@0.6.0 -- oss-signal SalmonPlays/oss-signal --format json
 ```
 
-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.4.0` Action tag is used by the repository health workflow for Markdown and SARIF output. The published npm `0.3.0` package has also been executed from a clean temporary directory against the public GitHub repository.
+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.6.0` Action tag is used by the repository health workflow for Markdown and SARIF output. The published npm `0.6.0` package has also been executed from a clean temporary directory against the public GitHub repository, returning 100/100 (A).
 
 Public CI evidence:
 
 - CI workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/ci.yml
 - Repository health workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/repository-health.yml
 - CodeQL workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/codeql.yml
+- Separate workflow demo run: https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26883001038
+- Reviewer verification quickstart: [reviewer-evidence.md](reviewer-evidence.md)
 
 ## Boundaries
 

package/docs/codex-for-oss-application.md

@@ -1,6 +1,6 @@
 # Codex for Open Source Application Brief
 
-Snapshot: 2026-06-03T03:06:42Z
+Snapshot: 2026-06-03T12:45:11Z
 
 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
 
@@ -8,12 +8,16 @@ This document summarizes why `oss-signal` is a fit for OpenAI's Codex for Open S
 
 - Repository: https://github.com/SalmonPlays/oss-signal
 - npm package: https://www.npmjs.com/package/oss-signal
-- GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.4.0
-- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.4.0
+- GitHub Release: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.6.0
+- GitHub Action tag: https://github.com/SalmonPlays/oss-signal/tree/v0.6.0
 - CI workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/ci.yml
 - Repository health workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/repository-health.yml
+- Repository inventory workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/repository-inventory.yml
 - CodeQL workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/codeql.yml
+- Separate public workflow demo: https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26883001038
 - Maintainer evidence: [adoption-evidence.md](adoption-evidence.md)
+- Reviewer evidence quickstart: [reviewer-evidence.md](reviewer-evidence.md)
+- Form answer pack: [codex-for-oss-form-answers.md](codex-for-oss-form-answers.md)
 - Maintainer playbook: [maintainer-playbook.md](maintainer-playbook.md)
 - Release process: [release-process.md](release-process.md)
 
@@ -25,13 +29,14 @@ This document summarizes why `oss-signal` is a fit for OpenAI's Codex for Open S
 - CI, tests, issue templates, pull request templates, Dependabot, and CodeQL-style security workflow.
 - Package metadata and lockfile hygiene.
 
-The output is a deterministic score plus actionable next steps in Markdown, JSON, or SARIF. The GitHub Action also writes a workflow step summary so maintainers and reviewers can see the result without downloading an artifact.
+The output is a deterministic score plus actionable next steps in Markdown, JSON, SARIF, or an Issue-ready Markdown body. The GitHub Action also writes a workflow step summary so maintainers and reviewers can see the result without downloading an artifact.
 
 ## Why Codex Helps
 
 This project is designed around repeatable maintainer workflows where Codex is useful:
 
 - Run audits against public repositories without cloning.
+- Compare several repositories with an inventory report.
 - Convert findings into focused cleanup issues or pull requests.
 - Keep repository hygiene visible in CI.
 - Upload failed maintainer-readiness checks to GitHub Code Scanning through SARIF.
@@ -42,26 +47,38 @@ This project is designed around repeatable maintainer workflows where Codex is u
 
 The repository currently has:
 
-- A published npm package with `0.3.0` as the latest release.
-- A published GitHub Release for v0.4.0 with SARIF release notes and CI usage guidance.
+- A published npm package with `0.6.0` as the latest release.
+- npm download API evidence showing 356 last-week and last-month downloads on 2026-06-03.
+- A published GitHub Release for v0.6.0 with repository inventory release notes and CI usage guidance.
 - A reusable GitHub Action with `score`, `grade`, `failed`, and `report-path` outputs.
+- A repository inventory mode for organization-level maintainer-readiness triage, available in both CLI and GitHub Action form.
+- A clean npm smoke test of `oss-signal@0.6.0` returning version `0.6.0`, score `100`, grade `A`, and source `github`.
 - SARIF output for GitHub Code Scanning integration.
-- A v0.4.0 GitHub Action tag with step summary and SARIF support.
-- A public dogfood workflow that runs `SalmonPlays/oss-signal@v0.4.0` against the repository, uploads the Markdown report artifact, and uploads SARIF to GitHub Code Scanning on non-PR runs.
+- A v0.6.0 GitHub Action tag with step summary, SARIF support, inventory support, and Issue-ready output.
+- A public dogfood workflow that runs `SalmonPlays/oss-signal@v0.6.0` against the repository, uploads the Markdown report artifact, and uploads SARIF to GitHub Code Scanning on non-PR runs.
+- A public dogfood inventory workflow that runs `SalmonPlays/oss-signal@v0.6.0` against a repository target list and uploads an inventory artifact.
+- 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.
 - A maintainer playbook that documents audit, triage, issue, PR, CI, and SARIF workflows.
 - A release process and tag-triggered release workflow that verify package contents and support npm provenance publishing when repository secrets are configured.
-- CI and CodeQL workflows passing on `main`.
+- CI, Repository health, CodeQL, and Release workflows passing publicly.
 - A local self-audit score of 100/100.
-- A clean-directory smoke test of `npx --yes oss-signal@0.3.0 SalmonPlays/oss-signal --format json`, returning 100/100 (A).
-- Public reports, issues, and PRs created from real repository audits.
+- A clean-directory smoke test of `npm exec --yes --package=oss-signal@0.6.0 -- oss-signal SalmonPlays/oss-signal --format json`, returning 100/100 (A).
+- Public reports, issues, and PRs created from real repository audits, including four posted field-audit issues and four follow-up PRs.
+
+## Separate Workflow Demo
+
+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.
+
+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.
 
 ## Field Audits And Follow-Up PRs
 
 | Repository | Report | Issue | PR | Status |
 | --- | --- | --- | --- | --- |
-| `platformatic/massimo` | [report](outreach/platformatic-massimo-report.md) | https://github.com/platformatic/massimo/issues/159 | https://github.com/platformatic/massimo/pull/160 | open, mergeable |
-| `supermarkt/checkjebon` | [report](outreach/supermarkt-checkjebon-report.md) | https://github.com/supermarkt/checkjebon/issues/22 | https://github.com/supermarkt/checkjebon/pull/23 | open, mergeable |
-| `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 |
+| `platformatic/massimo` | [report](outreach/platformatic-massimo-report.md) | https://github.com/platformatic/massimo/issues/159 | https://github.com/platformatic/massimo/pull/160 | open, clean |
+| `supermarkt/checkjebon` | [report](outreach/supermarkt-checkjebon-report.md) | https://github.com/supermarkt/checkjebon/issues/22 | https://github.com/supermarkt/checkjebon/pull/23 | open, clean |
+| `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 |
+| `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 |
 
 These PRs are intentionally small and maintainer-friendly. They add documentation or GitHub templates rather than changing product code.
 
@@ -69,16 +86,18 @@ These PRs are intentionally small and maintainer-friendly. They add documentatio
 
 Recommended application angle:
 
-`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, and three 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.
+`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, four 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.
+
+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.
 
 ## Current Gaps
 
 - External PRs are open but not yet merged.
 - npm download metrics are still early because the package is newly published.
-- The project needs more real maintainers using the Action in their own repositories.
+- The project needs independent maintainer-owned repositories using the Action in their own workflows.
 
 ## Next Evidence To Collect
 
 - One or more merged external PRs.
-- A public workflow run in another repository using `SalmonPlays/oss-signal@v0.4.0`, ideally with SARIF upload enabled.
+- A public workflow run in an independent maintainer-owned repository using `SalmonPlays/oss-signal@v0.6.0`, ideally with SARIF or inventory upload enabled.
 - npm download data once the registry starts reporting weekly/monthly counts.

package/docs/codex-for-oss-form-answers.md

@@ -0,0 +1,101 @@
+# Codex for Open Source Form Answers
+
+Snapshot: 2026-06-03T12:45:11Z
+
+This page prepares concise answers for the official Codex for Open Source application form: https://openai.com/form/codex-for-oss/
+
+The official form asks for personal identity fields that must be filled by the applicant:
+
+- First name
+- Last name
+- Email associated with the applicant's ChatGPT account
+- OpenAI Organization ID
+
+## First Name
+
+```text
+Fill manually.
+```
+
+## Last Name
+
+```text
+Fill manually.
+```
+
+## Email
+
+```text
+Fill manually with the email associated with the applicant's ChatGPT account.
+```
+
+## GitHub Username
+
+```text
+SalmonPlays
+```
+
+## GitHub Repository URL
+
+```text
+https://github.com/SalmonPlays/oss-signal
+```
+
+## Describe Your Role
+
+```text
+Primary maintainer
+```
+
+## Why This Repository Qualifies
+
+```text
+oss-signal is a public OSS maintainer tool for reducing triage and review load. It ships as npm package oss-signal@0.6.0 and GitHub Action SalmonPlays/oss-signal@v0.6.0, supports Markdown/JSON/SARIF/Issue/Inventory output, passes CI/CodeQL/Release, has a 100/100 self-audit, and has four public field-audit issues plus four PRs.
+```
+
+## Interest
+
+```text
+Codex Security
+API credits for my project
+```
+
+## Codex Security Use
+
+```text
+Use Codex Security to review oss-signal's CLI, GitHub Action, SARIF output, and repository-audit workflow for vulnerabilities before maintainers rely on it in CI. The project analyzes public repository metadata and writes reports, so security coverage helps catch unsafe workflow assumptions, dependency issues, and action-handling risks before field-audit PRs are shared with other OSS maintainers.
+```
+
+## OpenAI Organization ID
+
+```text
+Fill manually from https://platform.openai.com/settings/organization/general
+```
+
+## API Credit Use
+
+```text
+Use Codex/API credits to run repeatable public repository audits, draft focused maintainer PRs and issue summaries from reports, build organization-level maintainer-readiness inventories, improve release/Code Scanning automation, and keep every public follow-up behind human review before posting or opening PRs.
+```
+
+## Anything Else
+
+```text
+The project is early, so I am not overstating adoption. Current evidence includes npm 0.6.0 latest, 356 npm downloads reported by the registry API, a published v0.6.0 release, a reusable GitHub Action with inventory mode, a clean npm smoke test returning 100/A, public CI/Repository health/CodeQL/Release, four field-audit issues, four PRs, and a workflow demo with artifacts.
+```
+
+## Evidence Links
+
+- npm package: https://www.npmjs.com/package/oss-signal
+- GitHub Release v0.6.0: https://github.com/SalmonPlays/oss-signal/releases/tag/v0.6.0
+- Main repository health workflow: https://github.com/SalmonPlays/oss-signal/actions/workflows/repository-health.yml
+- Separate workflow demo repository: https://github.com/SalmonPlays/oss-signal-adoption-demo
+- Separate successful workflow run: https://github.com/SalmonPlays/oss-signal-adoption-demo/actions/runs/26883001038
+- Adoption evidence: https://github.com/SalmonPlays/oss-signal/blob/main/docs/adoption-evidence.md
+
+## Character Counts
+
+- Why this repository qualifies: 328/500
+- Codex Security use: 399/500
+- API credit use: 312/500
+- Anything else: 376/500

package/docs/examples/github-action-workflow.yml

@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: SalmonPlays/oss-signal@v0.4.0
+      - uses: SalmonPlays/oss-signal@v0.6.0
         id: oss-signal
         with:
           fail-under: "80"

package/docs/examples/github-code-scanning-workflow.yml

@@ -15,13 +15,13 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: SalmonPlays/oss-signal@v0.4.0
+      - uses: SalmonPlays/oss-signal@v0.6.0
         id: oss-signal
         with:
           fail-under: "80"
           output: oss-signal-report.md
           summary: "true"
-      - uses: SalmonPlays/oss-signal@v0.4.0
+      - uses: SalmonPlays/oss-signal@v0.6.0
         with:
           format: sarif
           output: oss-signal.sarif

package/docs/examples/github-inventory-workflow.yml

@@ -0,0 +1,27 @@
+name: Repository inventory
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "0 9 * * 1"
+
+permissions:
+  contents: read
+
+jobs:
+  inventory:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: SalmonPlays/oss-signal@v0.6.0
+        id: oss-signal
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        with:
+          inventory: docs/examples/inventory-targets.txt
+          output: inventory-report.md
+          summary: "true"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: oss-signal-inventory-report
+          path: inventory-report.md