@devries-cameron20 / composio-1 / commits / e4a05d2f4
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: group launch guides under Production readiness

Brendan O'Leary committed Sep 9, 2026 at 16:36 UTC e4a05d2f4558f475ca5e3904a29027866f362ebb
8 files changed +59 -15
docs/content/docs/authentication/meta.json
-1
@@ -4,7 +4,6 @@
4 "manually-authenticating",
5 "managing-multiple-connected-accounts",
6 "importing-existing-connections",
7 - "custom-app-vs-managed-app",
7 "programmatic-auth-configs",
8 "controlling-scopes",
9 "white-labeling-authentication"
docs/content/docs/poc-to-prod/meta.json
+7 -2
@@ -1,4 +1,9 @@
1 {
2 - "title": "POC to prod",
3 - "pages": ["stream-logs-to-a-siem"]
2 + "title": "Production readiness",
3 + "pages": [
4 + "../authentication/custom-app-vs-managed-app",
5 + "[Rate limits](/reference/rate-limits)",
6 + "../security/data-retention",
7 + "stream-logs-to-a-siem"
8 + ]
9 }
docs/content/docs/security/meta.json
+1 -2
@@ -2,7 +2,6 @@
2 "title": "Security and data",
3 "defaultOpen": false,
4 "pages": [
5 - "overview",
6 - "data-retention"
5 + "overview"
6 ]
7 }
docs/content/reference/meta.json
-1
@@ -3,7 +3,6 @@
3 "pages": [
4 "index",
5 "authenticating-to-composio",
6 - "rate-limits",
6 "errors",
7 "glossary",
8 "api-reference",
docs/lib/home-navigation.ts
+5 -1
@@ -123,6 +123,7 @@ export const DOCS_PRODUCTS = {
123 '/docs/extending-sessions',
124 '/docs/setting-up-triggers',
125 '/docs/poc-to-prod',
126 + '/docs/security/data-retention',
127 '/docs/sessions-vs-direct-execution',
128 '/docs/tools-direct',
129 '/docs/auth-configuration',
@@ -238,7 +239,10 @@ export function docsProductDestination(pathname: string, target: DocsProduct): s
239 const sourceProduct = target === 'platform' ? 'for-you' : 'platform';
240 const counterpart = PRODUCT_COUNTERPARTS.find(pair => matchesRoute(pathname, pair[sourceProduct]));
241 if (counterpart) return counterpart[target];
241 - if (SHARED_ROUTE_PREFIXES.some(prefix => matchesRoute(pathname, prefix))) return pathname;
242 + if (
243 + classifyDocsProduct(pathname) !== sourceProduct &&
244 + SHARED_ROUTE_PREFIXES.some(prefix => matchesRoute(pathname, prefix))
245 + ) return pathname;
246 return DOCS_PRODUCTS[target].landingRoute;
247 }
248
docs/tests/static/navigation.test.ts
+9
@@ -136,6 +136,15 @@ describe("Navigation - meta.json validity", () => {
136 // Handle "..." (rest) entries which are valid fumadocs syntax
137 if (entry === "...") continue;
138
139 + const link = entry.match(/^\[[^\]]+\]\((\/[^)]+)\)$/);
140 + if (link) {
141 + const target = join(CONTENT_DIR, '..', link[1].slice(1));
142 + if (!await exists(`${target}.mdx`) && !await exists(join(target, 'index.mdx'))) {
143 + errors.push(`${relDir}/meta.json → "${entry}" (link target not found)`);
144 + }
145 + continue;
146 + }
147 +
148 const asFile = join(dir, `${entry}.mdx`);
149 const asDir = join(dir, entry);
150
docs/tests/static/product-navigation.test.ts
+25 -2
@@ -11,7 +11,7 @@ import {
11 shouldAnimateDocsProductSwitch,
12 } from '../../lib/home-navigation';
13 import { buildProductPageTree, pageTreeUrls } from '../../lib/product-page-tree';
14 -import { source } from '../../lib/source';
14 +import { referenceSource, source } from '../../lib/source';
15
16 describe('Docs product navigation', () => {
17 test('defines the product labels, descriptions, landings, and themes once', () => {
@@ -39,6 +39,7 @@ describe('Docs product navigation', () => {
39 expect(classifyDocsProduct('/docs/authentication/controlling-scopes')).toBe('platform');
40 expect(classifyDocsProduct('/docs')).toBeNull();
41 expect(classifyDocsProduct('/docs/security/overview')).toBeNull();
42 + expect(classifyDocsProduct('/docs/security/data-retention')).toBe('platform');
43 });
44
45 test('uses route inference before persistence and the documented default last', () => {
@@ -77,6 +78,9 @@ describe('Docs product navigation', () => {
78 expect(docsProductDestination('/docs/security/data-retention', 'platform')).toBe(
79 '/docs/security/data-retention',
80 );
81 + expect(docsProductDestination('/docs/security/data-retention', 'for-you')).toBe(
82 + '/docs/agent-plugins',
83 + );
84 });
85
86 test('animates only when view transitions are available and motion is allowed', () => {
@@ -126,11 +130,30 @@ describe('Docs product navigation', () => {
130 expect(forYouUrls).not.toContain('/docs');
131 expect(platformUrls).not.toContain('/docs');
132
129 - for (const sharedUrl of ['/docs/security/overview', '/docs/security/data-retention']) {
133 + for (const sharedUrl of ['/docs/security/overview']) {
134 expect(forYouUrls).toContain(sharedUrl);
135 expect(platformUrls).toContain(sharedUrl);
136 }
137
138 + const readiness = platformTree.children.flatMap(node =>
139 + node.type === 'folder' ? [node, ...node.children] : [node],
140 + ).find(node => node.type === 'folder' && node.name === 'Production readiness');
141 + expect(readiness?.type).toBe('folder');
142 + if (readiness?.type !== 'folder') throw new Error('Production readiness folder missing');
143 + const readinessUrls = readiness.children.flatMap(node => node.type === 'page' ? [node.url] : []);
144 + expect(readinessUrls).toEqual([
145 + '/docs/authentication/custom-app-vs-managed-app',
146 + '/reference/rate-limits',
147 + '/docs/security/data-retention',
148 + '/docs/poc-to-prod/stream-logs-to-a-siem',
149 + ]);
150 + for (const url of readinessUrls) {
151 + expect(platformUrls.filter(candidate => candidate === url)).toHaveLength(1);
152 + expect(forYouUrls).not.toContain(url);
153 + }
154 + expect(pageTreeUrls(referenceSource.pageTree)).not.toContain('/reference/rate-limits');
155 + expect(referenceSource.getPage(['rate-limits'])?.url).toBe('/reference/rate-limits');
156 +
157 const coveredUrls = new Set([...forYouUrls, ...platformUrls]);
158 const excludedUrls = new Set(['/docs']);
159 const omittedUrls = pageTreeUrls(source.pageTree).filter(
docs/tests/static/start-routing.test.ts
+12 -6
@@ -5,8 +5,8 @@ import { HOME_INTENTS } from '../../lib/home-navigation';
5 const read = (path: string) => Bun.file(new URL(`../../${path}`, import.meta.url)).text();
6
7 /**
8 - * The 7 auth guides live in the Authentication folder; shared connections is a
9 - * session capability and lives under Extend sessions.
8 + * Auth guides retain their URLs; managed vs custom auth is listed under
9 + * Production readiness. Shared connections lives under Extend sessions.
10 */
11 const AUTH_GUIDES = [
12 'manually-authenticating',
@@ -52,17 +52,23 @@ describe('getting-started routing policy', () => {
52 });
53
54 test('keeps progressive authentication guides in the human hub and the sidebar', async () => {
55 - const [authentication, authMeta, sessionsMeta] = await Promise.all([
55 + const [authentication, authMeta, sessionsMeta, readinessMeta] = await Promise.all([
56 read('content/docs/authentication/index.mdx'),
57 read('content/docs/authentication/meta.json'),
58 read('content/docs/extending-sessions/meta.json'),
59 + read('content/docs/poc-to-prod/meta.json'),
60 ]);
61 const authPages = JSON.parse(authMeta).pages as string[];
62 const sessionPages = JSON.parse(sessionsMeta).pages as string[];
63
64 for (const guide of AUTH_GUIDES) {
65 expect(authentication).toContain(`href="/docs/authentication/${guide}"`);
65 - expect(authPages).toContain(guide);
66 + if (guide === 'custom-app-vs-managed-app') {
67 + expect(authPages).not.toContain(guide);
68 + expect(JSON.parse(readinessMeta).pages).toContain(`../authentication/${guide}`);
69 + } else {
70 + expect(authPages).toContain(guide);
71 + }
72 }
73
74 expect(authentication).toContain('href="/docs/extending-sessions/shared-connections"');
@@ -108,8 +114,8 @@ describe('getting-started routing policy', () => {
114
115 for (const guide of AUTH_GUIDES) {
116 expect(sectionOf(`/docs/authentication/${guide}`)).toEqual({
111 - section: '## Core concepts',
112 - nearest: '### Authentication',
117 + section: guide === 'custom-app-vs-managed-app' ? '## Guides' : '## Core concepts',
118 + nearest: guide === 'custom-app-vs-managed-app' ? '### Production readiness' : '### Authentication',
119 });
120 }
121