Repository navigation
Closed
Labels
documentationImprovements or additions to documentationImprovements or additions to documentation
Description
Running list of clean-ups found while cutting v1.0.888 and submitting the plugins to the ChatGPT and Anthropic directories on 2026-11-05. None of these block the release; they are batched here so the next release and the next directory versions go through without surprises. Items are added as the portal submissions progress.
Plugin manifests (one PR, skips the Build workflow)
-
packaging/openai-plugin/plugins/stackql/plugin.json: setreview.demo_recording_urlonce the demo recording exists (required before OpenAI MCP review;validate.pywarns while unset). Tracked in Package and ship the ChatGPT plugin directory ZIP for the local stdio MCP server #893. - (PR submission-hygiene #901) Documentation links:
https://stackql.io/docsnow redirects to the homepage. SwitchhomepageanddocumentationUrlinpackaging/claude-plugin/.claude-plugin/plugin.json(and any matching OpenAI field) tohttps://stackql.io/getting-startedor whichever docs landing page is preferred. - (resolved, no change) Anthropic listing:
classificationis not documented in the plugin manifest reference, so it is left to the directory's automatic fill; noted inanthropic-submission.mdby PR submission-hygiene #901. Original note: add aclassificationblock to.claude-plugin/plugin.jsonso the directory does not fill it automatically after submission (shape per the plugin manifest reference). - (PR submission-hygiene #901) Anthropic portal findings that are by design, to be documented in
packaging/mcpb/docs/anthropic-submission.mdso nobody tries to remove them: the four listing URL fields andiconare reported as unrecognized by Claude Code but read by the directory (no action); the policy hold "scripts the validator couldn't follow" onserver/bin/stackql-mcp.jsis inherent to a node launcher and goes to a reviewer every version. - (PR submission-hygiene #901) Anthropic portal "Listed on" surfaces: list on Claude Code and Cowork only (the local server does not run in Claude apps; the setup skill alone would mislead there). Record in
anthropic-submission.md. - (PR submission-hygiene #901)
anthropic-submission.mddata handling answers: record what was submitted on 2026-11-05 and why. Personal data: Reads only (queries return whatever the user's own tenancy holds, such as IAM or directory users and GitHub profiles; nothing is stored beyond the local session), skills send data elsewhere: No (binary and provider downloads are the server's and are declared in the README), retention: Not retained (StackQL Studios runs no service that receives data from Claude), under 18: No. The checklist currently says "stores no personal data", which is the wrong framing. - (PR submission-hygiene #901)
anthropic-submission.mdand release doc step 12: the webhook. After Submit for review the portal issues a payload URL (https://api.anthropic.com/directory-webhooks/github/<id>/stackql/stackql-claude-plugin) and a secret; they go into a repository webhook on the mirror (Settings > Webhooks,application/json, SSL verification on, push event only), not into Actions secrets. Ping delivery returns 200. The directory also polls the tracked branch about every 6 hours regardless. - (PR submission-hygiene #901)
anthropic-submission.md: auto-publish passing versions was switched on at submission; the first version is published by us or the reviewer. Update the "After the first version passes" item accordingly. - (PR submission-hygiene #901)
anthropic-submission.mdone-time checklist: mark done the mirror creation, first render push, portal submission (2026-11-05, held for policy review on the launcher) and webhook; keep the open items (reviewer decision, Verified organization reply from directory@anthropic.com, email sent 2026-11-05). - (PR submission-hygiene #901)
anthropic-submission.mdone-time checklist: the June 2026 Desktop Extension submission was made through the Google Form and does not appear in any portal, so there is nothing to withdraw; the directory@anthropic.com email is needed only if Submit for review is refused as already submitted.
Anthropic directory: Verified organization
- The validator notes that the directory will later accept MCP servers that run on the user's computer only from Verified organizations, and StackQL Studios is not one. Anthropic's docs describe no application ("Anthropic decides during review"). Ask directory@anthropic.com how an organization becomes Verified and get it done before the gate is enforced.
Release process doc
- (PR submission-hygiene #901) Step 10: correct the note added in release-doc-npm-trusted-publisher #898.
packaging/**is in the Build workflow'spaths-ignore, so the pin PR runsstdio-plugins, themcp-packagingvalidation, Lint and CodeQL only, not the full Build matrix. - (PR submission-hygiene #901) Step 7a: note that the Chocolatey package is trusted, so it goes live after the automated review (typically 1 to 2 hours) without human moderation.
- (step 12 done in PR submission-hygiene #901; step 11 once the OpenAI flow completes) Steps 11 and 12: fold in the portal walk-throughs once both submissions are done (first upload to read the validator, Verified organization, surfaces to tick, classification).
CI and tooling
- (PR submission-hygiene #901)
build.ymlpaths-ignore: add the release tooling (cicd/python/attach_build_artifacts.pyand its tests, orcicd/python/**minusbuild.py) so a tooling fix does not run the full Build matrix (attach-artifacts-utf8 #897 did). - (PR submission-hygiene #901)
packaging/mcpb/scripts/smoke-test.py: print the launcher's stderr when the server exits before the first response. The dotnet Windows ARM64 smoke flake in the 1.0.888mcp-packagingrun left no diagnostic (exit 0xE0434352, unhandled .NET exception). - (PR submission-hygiene #901) Docker Hub 429 on the
Docker mergejobs twice on 2026-11-05 (release run and the post-merge build for attach-artifacts-utf8 #897). Both merge variants run in parallel after the Docker Test shards on one account; consider serialising them or reviewing the Docker Hub plan for the stackql account. Rerunning failed jobs fixed both. - (PR submission-hygiene #901)
packaging/mcpb/npm/package-lock.json: its rootversionis not restamped byrender-npm-manifest.sh(still0.12.778whilepackage.jsonis1.0.888). Stamp it too, or drop the lockfile (the package has no dependencies). - Re-validate the Build test jobs on Ubuntu 26.04 and remove the three
ubuntu-24.04pins from plugin-submissions #896 (linuxtest,dockertestamd64 leg,dockertestverify), once the gpg homedir abort and the Docker Compose progress-line output are handled. -
check-published.py: the GitHub MCP Registry check walks 100-server pages of about 5 MB each; narrow the request if that API gains a name filter. The transport-error crash was fixed in pins-1.0.888 #899.
Later
- Claude plugin
userConfigfor the StackQL config directory (deferred in plugin-submissions #896; Cowork drops a server whose option has no default).
Metadata
Metadata
Assignees
Labels
documentationImprovements or additions to documentationImprovements or additions to documentation
Activity
submission-hygiene (#901)
jeffreyaven commentedon Nov 5, 2026
Closing. Everything actionable in the repository shipped in #897, #898, #899 and #901 (post-merge main green at 4c447cf). The six remaining items moved to issues with a single concern each:
review.demo_recording_url, submission and publish, the step 11 walk-through for the release doc; Anthropic reviewer decision, first publish, Verified organization).ubuntu-24.04pins.userConfigfor the StackQL config directory.Dropped: narrowing the GitHub MCP Registry request in
check-published.py. That API exposes no name filter, so there is nothing to change; the transport-error crash was fixed in #899 and the row passes.