Skip to content

chore(plugin): Add the OpenAI review metadata and release notes to plugin.json - #113

Merged
johnxie merged 1 commit into
mainfrom
chore/openai-review-metadata
Oct 23, 2026
Merged

johnxie merged 1 commit into
mainfrom
chore/openai-review-metadata

Conversation

@johnxie

@johnxie johnxie commented Oct 23, 2026

Copy link
Copy Markdown
Member

Summary

This PR makes the root plugin.json match the package that we uploaded to the OpenAI plugin portal. It adds the review metadata and the release notes under extensions["com.openai"]. It also removes one plan sentence from the OpenAI listing text, because the portal flags it.

Why

  • The portal reads the review information from the ZIP. The OpenAI submission guide puts review and publication directly under extensions.com.openai, next to interface ("Configure onboarding, review, and publication", https://developers.openai.com/plugins/deploy/submission#automatically-provide-submission-and-review-information).
  • Initial MCP review needs exactly five positive and three negative test cases. Imported test cases are read-only in the dashboard, so the package is the only place to change them.
  • The repo is the source of the listing. Without this PR, the next ZIP from main drops the test cases and the release notes.
  • The portal gave this non-blocking metadata finding: "Remove pricing, subscription offers, and temporary promotions from the description." The cause is the sentence "Needs a paid Taskade plan." in the OpenAI longDescription.

What changes

File Change
plugin.json Adds extensions["com.openai"].review.commerce (false), review.test_cases.positive (5 cases with description, prompt, tools_triggered, expected_behavior), review.test_cases.negative (3 cases with description and prompt) and publication.release_notes. The values are the same as the uploaded file.
plugin.json Removes "Needs a paid Taskade plan." from extensions["com.openai"].interface.longDescription only. The root description, .claude-plugin/plugin.json, .cursor-plugin/plugin.json and the README keep the plan rule.

Every tool name in tools_triggered is a hosted User MCP tool on taskade/taskcade master: list_spaces, list_projects, create_task, set_task_date, read_project, list_agents, prompt_agent, list_automations, run_flow, get_flow_runs.

No package code, no server.json and no mcp.json change, so this PR has no changeset.

Checks

Check Result
python3 -m json.tool plugin.json parses
plugin.json and mcp.json against the agent-plugins.org 1.0.0 schemas (ajv, draft 2020-12, the check from #105) schema ok plugin.json, schema ok mcp.json
claude plugin validate . ✔ Validation passed (marketplace)
claude plugin validate .claude-plugin/plugin.json ✔ Validation passed
Dash scan rg -n "[\x{2014}\x{2013}]" plugin.json no hit
ZIP from this branch (git archive of plugin.json, mcp.json, skills/, assets/, README.md, LICENSE) against the uploaded ZIP 26 of 27 files are byte-identical. In plugin.json, the parsed JSON differs only in the removed sentence. The uploaded file used expanded arrays, and this branch keeps the compact layout of main.
yarn lint not run: it lints .js,.jsx,.ts,.tsx only, so it does not read JSON

Owner decision

The guide marks review.demo_recording_url as "Optional in ZIP; required for MCP review". The uploaded file has no demo URL, and this PR does not add one. Give the URL in the dashboard, or send it and a follow-up PR adds it to plugin.json.

Rollback

Revert this PR. No host reads review or publication at install time, so a revert changes only the next ZIP that we upload.

QA steps

Step Action Expected
1 Make a ZIP of plugin.json, mcp.json, skills/, assets/, README.md and LICENSE from this branch. The ZIP has 27 entries.
2 In the OpenAI portal, open Plugins > Taskade and select "Upload new version". Upload the ZIP. The upload completes with no validation error.
3 Open the Findings panel. The finding "Remove pricing, subscription offers, and temporary promotions from the description." is gone.
4 Open "Add review information". The 5 positive and 3 negative test cases show, read-only, and "Commerce" shows as no.
5 In the repo root, run claude plugin validate .. ✔ Validation passed

Refs taskade/taskcade#32572

…ugin.json

Add review.test_cases, review.commerce and publication.release_notes under extensions["com.openai"], as uploaded to the OpenAI plugin portal. Remove the plan sentence from the OpenAI longDescription only, because the portal flags pricing text in the description.
Copilot AI balanced review requested due to automatic review settings October 23, 2026 00:03
@changeset-bot

changeset-bot Bot commented Oct 23, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: c361ec4

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@johnxie

johnxie commented Oct 23, 2026

Copy link
Copy Markdown
Member Author

@deanzaka

Impact: the OpenAI plugin portal reads the review test cases, the commerce flag and the release notes from the ZIP, and it does not let us edit imported test cases in the dashboard. Before this PR, those fields lived only in the uploaded ZIP, so the next ZIP from main dropped them. This PR puts them in the repo and removes "Needs a paid Taskade plan." from the OpenAI listing text, which clears the portal finding about pricing in the description. Every other host keeps the plan sentence.

Before:

repo main plugin.json                     uploaded ZIP plugin.json
+-------------------------------+         +-------------------------------+
| com.openai.interface          |         | com.openai.interface          |
|   longDescription:            |         |   longDescription:            |
|   "... Needs a paid Taskade   |         |   "... Needs a paid Taskade   |
|    plan. ..."                 |         |    plan. ..."  <- FINDING     |
| (no review)                   |   !=    | review.commerce: false        |
| (no publication)              |         | review.test_cases: 5 + 3      |
|                               |         | publication.release_notes     |
+-------------------------------+         +-------------------------------+
next ZIP from main -> test cases and release notes lost

After:

repo plugin.json  ==  taskade-plugin-v2.zip plugin.json
+-------------------------------------------------------+
| com.openai.interface.longDescription:                 |
|   "... Sign in with your Taskade account. The plugin  |
|    cannot create or edit an automation ..."           |
| review.commerce: false                                |
| review.test_cases: 5 positive + 3 negative            |
| publication.release_notes                             |
+-------------------------------------------------------+
root description, .claude-plugin, .cursor-plugin, README:
  "Needs a paid Taskade plan." unchanged
Step Action Expected Where
1 Make a ZIP of plugin.json, mcp.json, skills/, assets/, README.md and LICENSE from this branch. The ZIP has 27 entries. Terminal
2 Open Plugins > Taskade, select "Upload new version", and upload the ZIP. The upload completes with no validation error. OpenAI plugin portal
3 Open the Findings panel. The pricing finding is gone. OpenAI plugin portal
4 Open "Add review information". 5 positive and 3 negative test cases show, read-only. Commerce shows as no. OpenAI plugin portal
5 Run claude plugin validate . in the repo root. ✔ Validation passed Terminal
6 Read the root description in plugin.json. It still ends with "Needs a paid Taskade plan." GitHub, Files changed

Copilot AI 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.

🟢 Approval recommended

The metadata-only changes match the stated scope, with no identified blocking issues.

No open issues 🎉

What changed in this PR

Aligns the root plugin manifest with the OpenAI portal submission so future packages retain review metadata and release notes.

Changes:

  • Adds the commerce flag, five positive test cases, and three negative test cases.
  • Adds publication release notes.
  • Removes the paid-plan sentence only from the OpenAI listing description.
File Description
plugin.json Adds OpenAI review and publication metadata and adjusts the listing text.

Review effort: Balanced

@johnxie
johnxie merged commit 33167ab into main Oct 23, 2026
6 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.

3 participants