Skip to content

docs: separate public plugin onboarding from maintainer procedures - #4

Merged
ysinh merged 4 commits into
mainfrom
codex/public-plugin-docs
Oct 30, 2026
Merged

ysinh merged 4 commits into
mainfrom
codex/public-plugin-docs

Conversation

@ysinh

@ysinh ysinh commented Oct 30, 2026

Copy link
Copy Markdown
Contributor

What changed

  • Lead the public README with Convai Agent Authoring installation, OAuth sign-in, a bounded first read, capabilities, privacy and support.
  • Distinguish the verified published OpenAI 0.2.9 package from the repository's 0.3.0 package-ID rename without claiming the rename is published.
  • Remove non-production testing, submission troubleshooting and reviewer-provisioning procedures from the public entry point. Maintainer procedures are preserved separately; no private document links are added here.
  • Extend the existing release validator to check the README for credential patterns, non-production hosts and internal operational references. Add focused regression tests and run them in CI.

Why

Customer installation instructions should not contain internal operating procedures. Public documentation also needs to reflect the available OpenAI plugin without implying that a repository rename automatically updates an approved directory listing.

How it was tested

  • python3 -m unittest discover -s tests -v: passed, covering allowed production configuration and rejection/redaction of credential-like material, non-production hosts and internal references.
  • python3 scripts/build.py --check: passed; generated package skills unchanged.
  • python3 scripts/validate.py: passed.
  • Release validation with the current upstream operation catalog: passed.
  • claude plugin validate packages/claude --strict: passed; the existing optional icon warning remains. Privacy policy is now discoverable from the README.
  • claude plugin validate .: passed.
  • Full-diff self-review and git diff --check: passed.

No plugin manifests, skills, MCP configuration, authentication behavior or runtime services are changed. No release tag, directory publication or deployment was performed. The documentation guard is a regression check, not a complete secret-history audit.

Deviations from team standards

None.

@ysinh

ysinh commented Oct 30, 2026

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 30, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-30T00:23:36.977901Z f85c052 Manual request
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: fd9f133531

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread scripts/validate.py Resolved
@ysinh

ysinh commented Oct 30, 2026

Copy link
Copy Markdown
Contributor Author

@codex review

@ysinh

ysinh commented Oct 30, 2026

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Hooray!

Reviewed commit: c9c9c39d3d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@ysinh

ysinh commented Oct 30, 2026

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Keep it up!

Reviewed commit: f85c052e4c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@ysinh
ysinh merged commit bce6ffb into main Oct 30, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants