Skip to content

docs(098): fix quickstart fixture path and sabotage recipes - #1000

Merged
Dumbris merged 1 commit into
mainfrom
docs-preflight-fixture-path
Aug 17, 2026
Merged

docs(098): fix quickstart fixture path and sabotage recipes#1000
Dumbris merged 1 commit into
mainfrom
docs-preflight-fixture-path

Conversation

@Dumbris

@Dumbris Dumbris commented Aug 17, 2026

Copy link
Copy Markdown
Member

Related #969

Reported by @neylwalecki while validating v0.58.0: specs/098-tools-preflight/quickstart.md pointed at internal/testdata/ctl-server.js, which never shipped — the real fixture is internal/server/testdata/preflight_fixture_server.js.

Beyond the path swap, the recipes now match the shipped fixture's actual knobs (it serves no default tools):

  • seed a tools.json (echo unannotated for the missing_annotation cell, wipe with destructiveHint:true for policy_filtered) and wire it via FIXTURE_TOOLS_FILE in the server env
  • rug-pull / new-tool cells: rewrite the tools file + restart the child (re-read on every tools/list)
  • server_unhealthy: FIXTURE_FAIL_FILE + kill (sticks across reconnects, no flapping)
  • server_initializing: FIXTURE_INIT_DELAY_MS

Docs-only; no code changes.

Related #969

The quickstart pointed at internal/testdata/ctl-server.js (never shipped)
with DESC_FILE knobs from the QA harness; the fixture that actually ships
is internal/server/testdata/preflight_fixture_server.js with
FIXTURE_TOOLS_FILE / FIXTURE_INIT_DELAY_MS / FIXTURE_FAIL_FILE. Recipes
rewritten to be copy-paste runnable against it (tools.json seed, env
wiring, per-cell sabotage steps). Reported by the #969 author while
validating v0.58.0.
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying mcpproxy-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 59416a3
Status: ✅  Deploy successful!
Preview URL: https://c616a8d7.mcpproxy-docs.pages.dev
Branch Preview URL: https://docs-preflight-fixture-path.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: docs-preflight-fixture-path

Available Artifacts

  • archive-darwin-amd64 (29 MB)
  • archive-darwin-arm64 (26 MB)
  • archive-linux-amd64 (17 MB)
  • archive-linux-arm64 (15 MB)
  • archive-windows-amd64 (28 MB)
  • archive-windows-arm64 (25 MB)
  • frontend-dist-pr (0 MB)
  • installer-dmg-darwin-amd64 (23 MB)
  • installer-dmg-darwin-arm64 (20 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 32006192034 --repo smart-mcp-proxy/mcpproxy-go

Note: Artifacts expire in 14 days.

@Dumbris
Dumbris enabled auto-merge (squash) August 17, 2026 07:51

@github-actions github-actions 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.

Approving docs-only fix: quickstart fixture path + runnable sabotage recipes, reported by the #969 author while validating v0.58.0. CI green.

@Dumbris
Dumbris merged commit a47773e into main Aug 17, 2026
47 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