@devries-cameron20 / composio-1 / commits / 9a60a9187
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

fix(docs): render KB identifier URLs as code spans, not dead links (#4249)

This PR: - Closes #4205 (nightly docs external-link check failing) - demotes bare identifier URLs — Google OAuth scope URIs (`googleapis.com/auth/*`) and version-only API roots like `https://api.ahrefs.com/v3` — to inline code spans in the KB generation layer (`markdownForMdx`), so they stop publishing as links that 404 by design - regenerates the two affected guides (`toolkits-ahrefs`, `toolkits-googlemeet`); explicit markdown links keep their authored form - adds a regression test covering the exact URLs from #4205 plus link/autolink/code-span edge cases - records the rule in `docs/decisions/public-knowledge-base.md` - makes the scheduled KB workflow rebuild `docs/kb/semantic-index.json` when it is stale against the checked-in corpus, not only when the upstream `support-knowledge` commit moves ## Context The failing URLs are machine identifiers, not documents — fetching them 404s by design, so no link target could ever satisfy the nightly sweep. Upstream support prose cites them bare, the generator copied them verbatim, and GFM autolinks published them as clickable links. Sibling KB articles already used the backtick convention, confirming the intended presentation. `check:kb-semantic` is expected to fail on this PR: 4 embedded record chunks change, and the artifact rebuild needs `OPENAI_API_KEY` (CI-owned). After merge, the scheduled job (now staleness-aware) proposes the artifact refresh PR on `docs/auto-update-kb`; until it merges, that gate stays red for docs PRs. Verified locally: `bun run lint:links:external` (the failing nightly command) — 0 errors; `bun test tests/static/` — 506 pass; `lint:links`, `generate:kb --check`, `types:check`, `lint` — pass.

Alberto Schiabel committed Aug 26, 2026 at 13:15 UTC 9a60a91874736c7708ac954c572022cb642df523

No changes.