Skip to content

docs(spec): amend Spec 049 — legalize server_quarantined status (six-value taxonomy)#779

Merged
Dumbris merged 1 commit into
mainfrom
spec049-amend-on-main
Jun 28, 2026
Merged

docs(spec): amend Spec 049 — legalize server_quarantined status (six-value taxonomy)#779
Dumbris merged 1 commit into
mainfrom
spec049-amend-on-main

Conversation

@Dumbris

@Dumbris Dumbris commented Jun 28, 2026

Copy link
Copy Markdown
Member

Aligns Spec 049 with PR #778 (community contribution by @electrolobzik), which surfaces quarantined tools in retrieve_tools(include_disabled=true) as name-only locked entries and introduces a sixth disabled-tool status, server_quarantined.

Spec 049 FR-004 pinned the status taxonomy to exactly five values and its Assumptions stated all locked tools live in the search index. #778's behavior is correct — quarantined tools are deliberately excluded from the index (TPA defense) and surfaced via a dedicated discovery pass — but was undocumented. This amendment makes the spec consistent so #778 can land.

Changes

  • FR-004: five → six values; server_quarantined documented as assigned by the quarantined-tool discovery pass (not the classifier), name-only, description/schema withheld; config-denied tools skipped; pending_approval reused for tool-level pending/changed on trusted servers.
  • FR-003: name-only exception for quarantined entries.
  • Assumptions: quarantine exception — excluded from the index, enumerated from authoritative quarantine state.
  • Key Entities: five-value set → six.
  • contracts/mcp-deltas.md: add server_quarantined to the status enum + example response + remediation.
  • design doc §4.3 taxonomy: five → six.

Docs/spec only — no code change. Pairs with #778.

Related #778

…value taxonomy)

Aligns Spec 049 with PR #778, which adds a sixth disabled-tool status,
server_quarantined, surfaced by a dedicated quarantined-tool discovery pass
(quarantined tools are deliberately excluded from the search index as a TPA
defense). Spec 049 pinned the taxonomy to exactly five values and assumed all
locked tools live in the index, so #778's behavior was correct but undocumented.

- FR-004: five -> six values; server_quarantined assigned by the discovery pass
  (not the classifier), name-only, description/schema withheld; config-denied
  tools skipped by the pass.
- FR-003: note the name-only exception for quarantined entries.
- Assumptions: quarantined tools are excluded from the index and enumerated from
  authoritative quarantine state.
- contracts/mcp-deltas.md: add server_quarantined to the status enum + example
  response shape and remediation.
- design doc taxonomy: five -> six, with the server_quarantined explanation.

Related #778
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying mcpproxy-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: de67b67
Status: ✅  Deploy successful!
Preview URL: https://55038597.mcpproxy-docs.pages.dev
Branch Preview URL: https://spec049-amend-on-main.mcpproxy-docs.pages.dev

View logs

@codecov-commenter

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@github-actions

Copy link
Copy Markdown

📦 Build Artifacts

Workflow Run: View Run
Branch: spec049-amend-on-main

Available Artifacts

  • archive-darwin-amd64 (28 MB)
  • archive-darwin-arm64 (25 MB)
  • archive-linux-amd64 (16 MB)
  • archive-linux-arm64 (14 MB)
  • archive-windows-amd64 (28 MB)
  • archive-windows-arm64 (25 MB)
  • frontend-dist-pr (0 MB)
  • installer-dmg-darwin-amd64 (21 MB)
  • installer-dmg-darwin-arm64 (19 MB)

How to Download

Option 1: GitHub Web UI (easiest)

  1. Go to the workflow run page linked above
  2. Scroll to the bottom "Artifacts" section
  3. Click on the artifact you want to download

Option 2: GitHub CLI

gh run download 28313018759 --repo smart-mcp-proxy/mcpproxy-go

Note: Artifacts expire in 14 days.

@mcpproxy-gatekeeper mcpproxy-gatekeeper 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.

Gatekeeper approval — Codex review verdict: ACCEPT.

This approval is posted automatically by the MCPProxy Gatekeeper App on behalf of the Codex reviewer (verdict of record lives in the Paperclip review thread). Author≠approver satisfied; QA + CI gates enforced separately.

Auto-approved per Model B (MCP-1249).

@Dumbris Dumbris merged commit b3a965b into main Jun 28, 2026
47 checks passed
@Dumbris Dumbris deleted the spec049-amend-on-main branch June 28, 2026 06:53
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