Skip to content

fix(docs): curate LLM exports and correct authentication guidance - #1734

Merged
Dumbris merged 2 commits into
mainfrom
codex/docs-package-a
Oct 22, 2026
Merged

Dumbris merged 2 commits into
mainfrom
codex/docs-package-a

Conversation

@Dumbris

@Dumbris Dumbris commented Oct 22, 2026 •

Copy link
Copy Markdown
Member

Problem and change

The documentation LLM index advertised 71 unpublished pages that returned 404, while the full export included internal research, plans and historical investigations. Share the HTML publication allowlist/exclusions with the LLM plugin so both exports contain only published docs. The resulting index contains 129 links, all matched to Docusaurus metadata and generated HTML.

Correct the MCP authentication reference to distinguish optional local HTTP auth, compatibility admin access for anonymous callers, enforced auth, Server edition and OS-authenticated local transports. Replace the homepage's overclaiming diagram with an accessible SVG stating the limits of protection. Add descriptions to seven category pages, exclude noindexed search from the sitemap, and publish robots.txt with the sitemap location.

Validation

  • npm ci --no-audit --no-fund
  • npm run build — production build and automatic postbuild validation passed.
  • New verifier reproduced the original defect: LLM export links to unpublished page: https://docs.mcpproxy.app/docs/E2E_TESTING.
  • Fixed output: Verified 129 published LLM links, full-export regression markers, category metadata, sitemap and robots.txt.
  • Mutation checks rejected an injected unpublished URL and internal workflow marker; generated files restored and verifier passed again.
  • Browser inspection confirmed the SVG and authentication table render correctly.
  • Independent fresh-context review: VERDICT: PASS after correcting the anonymous-admin compatibility wording. No remaining actionable findings.

The postbuild gate runs through the existing PR, main deployment and release npm run build paths. Runtime behavior is unchanged. Broader navigation and per-page Markdown work remain outside this PR.

Deployed preview

Cloudflare preview verified live: all 129 exported routes load; the full export excludes the known internal-note regression markers; the auth matrix, replacement SVG, sitemap and robots declaration are present. Full export is approximately 1.43 MB, down from 3.04 MB in the audited production snapshot.

The publication arrays remain literal in docusaurus.config.js for the existing release-gate parser, while both builders reference that same object. Reproduced the three parser failures from the first CI run, fixed compatibility, and passed go test ./cmd/release-gate -count=1, a fresh production docs build, and independent follow-up review (VERDICT: PASS).

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

Deploying mcpproxy-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: a70eb17
Status: ✅  Deploy successful!
Preview URL: https://68e931e9.mcpproxy-docs.pages.dev
Branch Preview URL: https://codex-docs-package-a.mcpproxy-docs.pages.dev

View logs

@github-actions

Copy link
Copy Markdown
Contributor

📦 Build Artifacts

Workflow Run: View Run
Branch: codex/docs-package-a

Available Artifacts

  • archive-darwin-amd64 (32 MB)
  • archive-darwin-arm64 (29 MB)
  • archive-linux-amd64 (19 MB)
  • archive-linux-arm64 (17 MB)
  • archive-windows-amd64 (32 MB)
  • archive-windows-arm64 (28 MB)
  • frontend-dist-pr (0 MB)
  • installer-dmg-darwin-amd64 (28 MB)
  • installer-dmg-darwin-arm64 (25 MB)
  • smart-mcp-proxymcpproxy-go6I366R.dockerbuild (0 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 39756822140 --repo smart-mcp-proxy/mcpproxy-go

Note: Artifacts expire in 14 days.

@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!

@Dumbris
Dumbris merged commit adc707c into main Oct 22, 2026
51 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