Skip to content

fix(docs): harden GEO discovery endpoints#852

Draft
zahlekhan wants to merge 1 commit into
thesysdev:mainfrom
zahlekhan:codex/seo-geo-autoresearch
Draft

fix(docs): harden GEO discovery endpoints#852
zahlekhan wants to merge 1 commit into
thesysdev:mainfrom
zahlekhan:codex/seo-geo-autoresearch

Conversation

@zahlekhan

@zahlekhan zahlekhan commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

What

  • Upgrades /llms.txt from a generic relative-link list to a structured OpenUI index with project identity, an approved summary, grouped resources, absolute Markdown URLs, and canonical HTML sources.
  • Adds canonical source attribution to individual and aggregate LLM-readable documentation.
  • Returns explicit UTF-8 content types, an HTTP canonical Link header for Markdown copies, and noindex, follow for the aggregate /llms-full.txt document.
  • Adds deterministic GEO-output validation and runs it with docs type checking in CI.

Why

The existing LLM-facing routes were accessible, but they did not provide enough project context or protocol-level canonicalization. That made the output less useful to agents and allowed Markdown copies to look like indexable duplicates of the HTML documentation.

Scope

This PR contains only the documentation GEO fix and its direct test, dependency, lockfile, and CI support. It does not include the autoresearch control plane, DataForSEO, PostHog, Codex adapters, analytics changes, SEO platform work, or unrelated UI changes.

Validation

  • pnpm --filter @openuidev/docs test:geo — 6 tests
  • pnpm --filter @openuidev/docs types:check
  • Targeted ESLint and Prettier checks
  • pnpm install --lockfile-only --frozen-lockfile --offline --filter @openuidev/docs
  • git diff --check upstream/main...HEAD
  • Local route verification:
    • /llms.txt200, text/plain; charset=utf-8
    • /docs/openui-lang/quickstart.mdx200, text/markdown; charset=utf-8, canonical Link
    • /llms-full.txt200, X-Robots-Tag: noindex, follow

@zahlekhan
zahlekhan force-pushed the codex/seo-geo-autoresearch branch from 446cc82 to 0d15fc4 Compare July 24, 2026 10:59
@zahlekhan zahlekhan closed this Jul 24, 2026
@zahlekhan
zahlekhan deleted the codex/seo-geo-autoresearch branch July 24, 2026 11:08
@zahlekhan zahlekhan reopened this Jul 24, 2026
@zahlekhan
zahlekhan force-pushed the codex/seo-geo-autoresearch branch from facfe54 to a7fc123 Compare July 24, 2026 13:54
@zahlekhan zahlekhan changed the title feat: add SEO and GEO autoresearch control plane fix(docs): harden GEO discovery endpoints Jul 25, 2026
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.

1 participant