Skip to content

Refresh submission docs against verified production state - #161

Merged
aterga merged 3 commits into
mainfrom
claude/icp-marketplace-compliance-vpawel-6-submission-doc-refresh
Aug 28, 2026
Merged

aterga merged 3 commits into
mainfrom
claude/icp-marketplace-compliance-vpawel-6-submission-doc-refresh

Conversation

@aterga

@aterga aterga commented Aug 27, 2026

Copy link
Copy Markdown
Collaborator

A post-#158 ship-readiness audit checked both directory docs against the code at main (0a32373) and against live production. This PR fixes what the audit found stale — all doc-only, no behavior change.

Verified against production (2026-08-27)

Doc corrections

  • Listing description: "identify what a canister is" was the unserved dashboard-lookup tool's capability; the description now leads with the served Candid fetch.
  • Checklist contradiction: the mcp-review row still gated on a reply that blocker 2's body declares moot ("resolved in code"), and wrongly said the first-party-API question was asked on 2026-07-31; the row now matches the body.
  • Stale figures/paths: longest served tool name is 23 chars (get_canister_oql_schema), not 30; the dfinity-logo.svg link and the README's connect.css / static/ mentions now point into crates/imcp2-core/ where those files live; "ships with this PR" phrasing updated now that it's merged and deployed; the stale "cycles funding is metered compute credit" justification is dropped (no funding tools exist).

Verification

  • Docs-only diff; workspace tests green, and no future version / anticipate phrasing introduced anywhere (grep-verified).

🤖 Generated with Claude Code

https://claude.ai/code/session_01LvwAVXfx5kLNc4SqKXkavk


Generated by Claude Code

A post-merge audit checked both directory docs against the code at main
(0a32373) and against live production. Fixes, all doc-only:

- Production gap restated with today's facts: /version reports bbf0844
  (v0.1.1), which predates the whole compliance chain (#153-#158) and
  still serves the old 26-tool surface — a release from current main
  must be deployed before either submission, since the attestations
  describe main.
- The privacy policy, /support, and /terms are LIVE on production
  (verified HTTP 200), so the "pending the production release" rows and
  checklist items now say what actually remains: portal entry, plus the
  next release refreshing the live text to the current draft.
- The mcp-review checklist row contradicted blocker 2's resolved-in-code
  body and wrongly claimed the first-party-API question was asked on
  2026-07-31; it now matches the body.
- The listing description claimed "identify what a canister is" — a
  capability of the unserved dashboard-lookup tool; it now leads with
  the served Candid fetch.
- Stale figures and paths: longest served tool name is 23 chars
  (get_canister_oql_schema), not 30; the dfinity-logo.svg link and the
  README's connect.css / static/ paths now point into
  crates/imcp2-core/ where the files live; "ships with this PR"
  phrasing updated now that the PR is merged and deployed; the stale
  cycles-funding justification sentence is dropped (no funding tools
  exist).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LvwAVXfx5kLNc4SqKXkavk
@aterga
aterga requested a balanced review from Copilot August 28, 2026 09:04
@aterga
aterga marked this pull request as ready for review August 28, 2026 09:06
@aterga
aterga requested a review from a team August 28, 2026 09:06

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.

Pull request overview

Refreshes submission documentation to match production state and current repository structure.

Changes:

  • Updates production readiness and deployment blockers.
  • Corrects tool counts, descriptions, and asset paths.
  • Removes stale release and financial-tool wording.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
README.md Corrects embedded asset paths.
docs/openai-directory-submission.md Refreshes production URLs and checklist.
docs/anthropic-directory-submission.md Updates production gap, listing copy, and checklist.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/anthropic-directory-submission.md Resolved
Comment thread docs/openai-directory-submission.md Resolved
Review findings on #161: the tool-name-length row now gives both values
(23 on main, the build to submit; 30 on the live pre-release build), and
the OpenAI checklist gains an explicit item requiring production to run
a release cut from current main, verified via /version immediately
before submitting — the deploy workflow also accepts older tags/SHAs
for rollbacks, so a deployed challenge token alone does not prove the
compliant build is live.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LvwAVXfx5kLNc4SqKXkavk
Copilot AI review requested due to automatic review settings August 28, 2026 09:09

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.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

Comment thread docs/anthropic-directory-submission.md Resolved
Review finding on #161: the table header claimed live verification for
every row, but the tool-surface rows (11 tools, one write, name
lengths, schemas) describe main, not the pre-release build production
currently runs. The header now says which rows were verified live
(transport/auth, 2026-07-31) and that the tool-surface rows describe
main pending the release, with a pointer to re-verify after deploying.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LvwAVXfx5kLNc4SqKXkavk
Copilot AI review requested due to automatic review settings August 28, 2026 09:13
@aterga
aterga requested a review from sea-snake August 28, 2026 09:13

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.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

Suppressed comments (1)

Previously missed (1) — in code that hasn't changed since the last review.

docs/anthropic-directory-submission.md:363

  • This updated checklist now says the page is live, but the portal field draft at lines 279–282 still instructs the submitter to enter this URL only once the page is live. Update that field draft too so the same document does not present the verified production state as still pending.
- [ ] Privacy policy entered in the portal — the page is already live at `https://mcp.internetcomputer.org/privacy-policy` (verified 2026-08-27); the next `release-*` refreshes its text to the current draft (blocker 1)

@aterga
aterga merged commit 7966c94 into main Aug 28, 2026
13 checks passed
aterga added a commit that referenced this pull request Aug 28, 2026
Per the review rule applied across #158/#161 (describe the current
version, not future work): the README's Roadmap section — three
unchecked forward-looking items plus a checked history that the feature
sections already document — is removed, along with the stale status
sentence claiming the live round-trip waits on an II deployment (the
II-side connect flow is live). The Anthropic submission doc's
parenthetical citing "an open roadmap item in the README" goes with it;
its present-tense honesty statement (no per-call confirmation
server-side today) stays.


Claude-Session: https://claude.ai/code/session_01LvwAVXfx5kLNc4SqKXkavk

Co-authored-by: Claude <noreply@anthropic.com>
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.

4 participants