Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 13:30 UTC
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