docs: Add llms.txt for full list of attributes

docs/src/pages/llms-full.txt.ts

@@ -0,0 +1,98 @@
+import type { APIRoute } from 'astro';
+import { getCollection } from 'astro:content';
+
+export const GET: APIRoute = async () => {
+  const allAttributes = await getCollection('attributes');
+
+  // Build category map
+  const categoryMap = new Map<string, typeof allAttributes>();
+
+  for (const attr of allAttributes) {
+    const category = attr.id.includes('/') ? attr.id.split('/')[0] : 'general';
+
+    if (!categoryMap.has(category)) {
+      categoryMap.set(category, []);
+    }
+    categoryMap.get(category)?.push(attr);
+  }
+
+  // Sort categories alphabetically, but put 'general' first
+  const sortedCategories = Array.from(categoryMap.keys()).sort((a, b) => {
+    if (a === 'general') return -1;
+    if (b === 'general') return 1;
+    return a.localeCompare(b);
+  });
+
+  // Sort attributes within each category by key
+  for (const attrs of categoryMap.values()) {
+    attrs.sort((a, b) => a.data.key.localeCompare(b.data.key));
+  }
+
+  // Calculate stats
+  const totalAttributes = allAttributes.length;
+  const stableCount = allAttributes.filter((a) => !a.data.deprecation).length;
+  const deprecatedCount = totalAttributes - stableCount;
+
+  // Build the plain text content
+  const lines: string[] = [];
+
+  lines.push('# Sentry Semantic Convention Attributes');
+  lines.push('');
+  lines.push(`Total: ${totalAttributes} attributes | Stable: ${stableCount} | Deprecated: ${deprecatedCount}`);
+  lines.push('');
+
+  for (const category of sortedCategories) {
+    const attributes = categoryMap.get(category) || [];
+
+    lines.push('---');
+    lines.push('');
+    lines.push(`## ${category}`);
+    lines.push('');
+
+    for (const attr of attributes) {
+      const { data } = attr;
+
+      lines.push(`### ${data.key}`);
+      lines.push(`- Brief: ${data.brief}`);
+      lines.push(`- Type: ${data.type}`);
+      lines.push(`- PII: ${data.pii.key}${data.pii.reason ? ` (${data.pii.reason})` : ''}`);
+
+      if (data.example !== undefined) {
+        const exampleStr = Array.isArray(data.example) ? data.example.join(', ') : String(data.example);
+        lines.push(`- Example: ${exampleStr}`);
+      }
+
+      if (data.alias && data.alias.length > 0) {
+        lines.push(`- Aliases: ${data.alias.join(', ')}`);
+      }
+
+      if (data.has_dynamic_suffix) {
+        lines.push('- Has dynamic suffix: yes');
+      }
+
+      if (data.is_in_otel) {
+        lines.push('- OpenTelemetry: yes');
+      }
+
+      if (data.deprecation) {
+        let deprecationNote = '- Deprecated: yes';
+        if (data.deprecation.replacement) {
+          deprecationNote += ` (use ${data.deprecation.replacement})`;
+        } else if (data.deprecation.reason) {
+          deprecationNote += ` (${data.deprecation.reason})`;
+        }
+        lines.push(deprecationNote);
+      }
+
+      lines.push('');
+    }
+  }
+
+  const content = lines.join('\n');
+
+  return new Response(content, {
+    headers: {
+      'Content-Type': 'text/plain; charset=utf-8',
+    },
+  });
+};

docs/src/pages/llms.txt.ts

@@ -0,0 +1,29 @@
+import type { APIRoute } from 'astro';
+
+export const GET: APIRoute = async () => {
+  const baseUrl = import.meta.env.BASE_URL || '/';
+
+  const content = `# Sentry Semantic Conventions
+
+> Semantic conventions for Sentry span attributes, operations, and measurements.
+
+Sentry Semantic Conventions define standardized attribute keys, span operation names, and measurements for observability data across all Sentry SDKs.
+
+## Documentation
+
+- [All Attributes](${baseUrl}llms-full.txt): Complete list of all span and breadcrumb attributes in plain text
+- [Attributes Reference](${baseUrl}attributes/): Browse attributes grouped by category
+- [Span Names](${baseUrl}names/): How to construct span names using templates
+
+## Optional
+
+- [GitHub Repository](https://github.com/getsentry/sentry-conventions): Source model files and schemas
+- [API: Attributes JSON](${baseUrl}api/attributes.json): Machine-readable JSON of all attributes
+`;
+
+  return new Response(content, {
+    headers: {
+      'Content-Type': 'text/plain; charset=utf-8',
+    },
+  });
+};