Skip to content

docs: reframe scanner section as CI quality gate#24

Merged
internet-dot merged 5 commits intomainfrom
feat/update-readme-to-include-scanner
Apr 1, 2026
Merged

docs: reframe scanner section as CI quality gate#24
internet-dot merged 5 commits intomainfrom
feat/update-readme-to-include-scanner

Conversation

@kantorcodes
Copy link
Copy Markdown
Member

@kantorcodes kantorcodes commented Apr 1, 2026

update readme

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the README to modernize the plugin validation workflow, replacing standard pip installation instructions with pipx run and simplifying the GitHub Action configuration. Review feedback highlights a potential execution failure in the local preflight instructions due to missing pipx prefixes and suggests capitalization improvements for consistency in the new submission preflight list.

README.md Outdated
Comment on lines +134 to +135
pipx run codex-plugin-scanner lint .
codex-plugin-scanner verify .
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The command codex-plugin-scanner verify . will fail if the user relies on pipx run from the previous line, as pipx run executes the package in a temporary environment without adding it to the system PATH. To ensure both commands work correctly without a permanent installation, both should be prefixed with pipx run.

Suggested change
pipx run codex-plugin-scanner lint .
codex-plugin-scanner verify .
pipx run codex-plugin-scanner lint .
pipx run codex-plugin-scanner verify .

README.md Outdated
Comment on lines +151 to +153
- structural lint results
- publish-readiness verification output
- SARIF/findings for CI and code scanning
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For consistency with other lists in this document, such as the 'Official Plugins' and 'Plugin Trust Scores' sections, the items in this list should start with a capital letter.

Suggested change
- structural lint results
- publish-readiness verification output
- SARIF/findings for CI and code scanning
- Structural lint results
- Publish-readiness verification output
- SARIF/findings for CI and code scanning

README.md Outdated
pip install codex-plugin-scanner
codex-plugin-scanner ./my-plugin
pipx run codex-plugin-scanner lint .
codex-plugin-scanner verify .
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SUGGESTION: Inconsistent invocation — lint uses pipx run but verify does not

The first command pipx run codex-plugin-scanner lint . implies the tool is not installed globally, yet the second command codex-plugin-scanner verify . assumes it is. Both should use the same invocation method to avoid confusing users.

Suggested change
codex-plugin-scanner verify .
pipx run codex-plugin-scanner verify .

@kilo-code-bot
Copy link
Copy Markdown

kilo-code-bot bot commented Apr 1, 2026

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Changes Since Last Review

Change Status
Added step 3 (HOL scanner GitHub Action) to Start Here workflow Improves onboarding — no issues
Unified GitHub Action reference in PR Gate section Fixes inconsistency — no issues
pipx run consistency on verify command Fixed (previously flagged)
Lowercase list items in Submission Preflight Fixed (previously flagged)
Files Reviewed (2 files)
  • README.md - Documentation restructure and scanner section rewrite. All previously flagged issues resolved. No new issues.
  • plugins.json - Routine date metadata bump (2026-03-312026-04-01). No issues.

Reviewed by mimo-v2-pro-20260318 · 117,430 tokens

README.md Outdated

```bash
pipx run codex-plugin-scanner lint .
codex-plugin-scanner verify .
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SUGGESTION: Inconsistent invocation — lint uses pipx run but verify does not

The first command uses pipx run codex-plugin-scanner lint . but the second drops the pipx run prefix. This is the same inconsistency flagged on line 151 in the "Validate Before You Ship" section. Pick one convention and apply it to both commands.

Suggested change
codex-plugin-scanner verify .
pipx run codex-plugin-scanner verify .

@internet-dot internet-dot merged commit 9f48dbe into main Apr 1, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants