@devries-cameron20 / composio-1 / commits / 2aa8ef6ca
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.

docs: surface Security and Compliance with a short review overview (#5372)

## Summary Security reviewers currently have to find a collapsed "Security and data" folder inside Ship and assemble guidance from docs and the KB. This smaller replacement for #5255 surfaces existing material under a top-level **Security and Compliance** section. Includes the changes from Brendan's November 17 sync with Palash: Vendor security review now opens as a doc, with permanent redirects from its former KB URLs. Follows [DEVREL-322](https://linear.app/composio/issue/DEVREL-322/compare-composios-security-documentation-with-vercels-security-docs). ## Changes - Add three sidebar groups: Compliance, Data privacy, and Security controls. Governance stays under Build. Existing retention, ZDR, audit-log, token-custody, and outbound-IP content is unchanged. - Keep the short Security overview with evaluator and builder sections, each containing a table of direct resource links. Preserve its previous heading anchors. - Move the vendor-review article to `/docs/security/vendor-security-review`, preserving its title and body. The only body edits normalize two internal docs links to site-relative paths. The sidebar label remains "Vendor security review". - Update the sidebar, overview, and KB routing guide to use the new doc. Retire the old KB manifest record so generation and upstream refreshes keep it unpublished. Search, sitemap, and LLM discovery use the docs URL. - Keep the Trust Center nav link as requested. No shared-responsibility page, new components, dependencies, or changeset. The PR also retains the narrow toolkit Markdown-route validation fix required by the earlier CI failure. Known toolkit `.md`/`.mdx` routes validate; unknown toolkits still fail. ## Old URLs and redirects All seven base paths below permanently redirect with **308** to `/docs/security/vendor-security-review`: | Old KB URL | New doc URL | | --- | --- | | `/kb/guide/platform-compliance-data-handling` | `/docs/security/vendor-security-review` | | `/kb/security-and-trust/platform-compliance-data-handling` | `/docs/security/vendor-security-review` | | `/kb/sdk-and-api/platform-compliance-data-handling` | `/docs/security/vendor-security-review` | | `/kb/guide/canonical-public-sources` | `/docs/security/vendor-security-review` | | `/kb/guide/model-training` | `/docs/security/vendor-security-review` | | `/kb/guide/third-party-providers` | `/docs/security/vendor-security-review` | | `/kb/guide/zero-data-retention-and-no-training-requirements` | `/docs/security/vendor-security-review` | Each path's `.md`, `.mdx`, and `/llms.mdx` form redirects directly to `/docs/security/vendor-security-review.md`. That covers **28 routes**. The article's original section anchors remain available. ## Type of change - [x] Documentation - [x] Internal docs validation and navigation fixes ## How Has This Been Tested? Merged the latest `next` first, without conflicts. Ran from `docs/` with Node 24.22.1 and Bun 1.4.2: - `bun install --frozen-lockfile`: passed; no dependency or lockfile changes. - `GITHUB_ACTIONS=true bun run build`: passed, including MDX, TypeScript, and all 2,661 generated pages. - `bun run lint:links`: passed; both internal and SDK link validators report zero errors. - `bun run lint`: passed with warnings in unchanged files. - `bun run test --timeout 30000`: **837 passed, 0 failed** across 80 files. Includes docs-only search/discovery and sidebar coverage for the moved page. - `TEST_BASE_URL=http://localhost:3026 bun run test:integration`: **273 passed, 1 skipped, 0 failed** across 13 files. All 28 legacy route variants return 308 and land on a 200 HTML or Markdown response. The skip requires a live `COMPOSIO_API_KEY`. - Verified the production HTML uses the Platform docs sidebar, the Vendor security review link targets the doc, Trust Center remains in Compliance, and all five original article section anchors render. - Compared the new article body with its KB source: identical except the two internal link fixes. - `bun run check:kb-semantic --allow-stale`: passed with a content-hash mismatch warning. Search uses keyword fallback until the existing **Docs - Rebuild KB Semantic Artifact** workflow refreshes the generated artifact. - `git diff --check`: passed. ## Sidebar description **Security and Compliance** is a top-level heading between **Ship** and **Reference and Migration**. It contains Security overview, then Compliance, Data privacy, and Security controls groups. **Compliance > Vendor security review** now stays in Platform docs. The external **Trust Center** link remains immediately below it. Governance remains under Build. ## NEEDS BRENDAN - Decide whether to keep or drop Trust Center in the sidebar. Today it is an external "Trust Center" link directly below "Vendor security review" in the Compliance group. ## Checklist - [x] The agent reviewed the full diff and preserved unrelated work - [x] Existing content preserved and internal links updated - [x] Build, link checks, lint, static tests, and integration tests passed - [x] No changeset needed for docs-only/internal docs validation changes - [ ] Brendan has reviewed this revision Designated reviewer: @jkomyno. Do not merge as part of this task. ## Possible follow-ups from #5255 - Explain Composio's role as a customer's subprocessor. - Publish a control matrix and approved compliance evidence with Security's input. - Add shared-responsibility guidance and a sensitive-workload setup checklist. - Consolidate other duplicate KB security guidance and consider homepage or incident-blog links to the security docs. ## In plain language Security reviewers get their own sidebar section and a short directory of useful links. Vendor-review guidance now lives in docs, and saved KB links still take readers to it. ## Earlier review screenshots These November 13 reference screenshots predate the vendor-review move. Current sidebar and link behavior is described and tested above. <img width="2866" height="1698" alt="CleanShot 2026-11-13 at 10 44 11 AM@2x" src="https://github.com/user-attachments/assets/2abaec14-f81e-42fc-844b-6ae6006b9b97" /> <img width="654" height="394" alt="CleanShot 2026-11-13 at 10 18 31 AM@2x" src="https://github.com/user-attachments/assets/0e7fd47b-ec30-43da-a17a-a7bc417966d6" />

Brendan O'Leary committed Nov 17, 2026 at 12:42 UTC 2aa8ef6caa6d2ae4eee445537f1e0c1377955d5d

No changes.